*/

/** Accepted string literals for boolean parsing beyond actual booleans. */

export type BooleanParseOptions = {

type BooleanParseOptions = {

/** Lowercase string values that should parse as true. */

truthy?: string[];

/** Lowercase string values that should parse as false. */

import type { ChannelRouteRef, ChannelRouteTargetInput } from "../plugin-sdk/channel-route.js";

/** Deferred outbound delivery intent attached to a session or task. */

export type DeliveryIntentRef = {

type DeliveryIntentRef = {

/** Stable queue/work item id. */

id: string;

/** Intent family; currently scoped to outbound queue delivery. */

// Message channel constants define internal channel ids shared across routing.

export const INTERNAL_MESSAGE_CHANNEL = "webchat" as const;

export type InternalMessageChannel = typeof INTERNAL_MESSAGE_CHANNEL;

// Internal, non-delivery sources that may surface as a `channel` hint when an

// agent run is triggered by something other than a chat message — heartbeat

"voice",

"sessions_send",

] as const;

export type InternalNonDeliveryChannel = (typeof INTERNAL_NON_DELIVERY_CHANNELS)[number];

export function isInternalNonDeliveryChannel(value: string): value is InternalNonDeliveryChannel {

export function isInternalNonDeliveryChannel(

value: string,

): value is (typeof INTERNAL_NON_DELIVERY_CHANNELS)[number] {

return (INTERNAL_NON_DELIVERY_CHANNELS as readonly string[]).includes(value);

}

import { uniqueStrings } from "@openclaw/normalization-core/string-normalization";

import { CHANNEL_IDS } from "../channels/ids.js";

import { listRegisteredChannelPluginIds } from "../channels/registry.js";

import {

INTERNAL_MESSAGE_CHANNEL,

type InternalMessageChannel,

} from "./message-channel-constants.js";

import { INTERNAL_MESSAGE_CHANNEL } from "./message-channel-constants.js";

import { normalizeMessageChannel as normalizeMessageChannelCore } from "./message-channel-core.js";

type ChannelId = string & { readonly __openclawChannelIdBrand?: never };

): string | undefined {

return normalizeMessageChannel(primary) ?? normalizeMessageChannel(fallback);

}

export type { InternalMessageChannel };

INTERNAL_MESSAGE_CHANNEL,

INTERNAL_NON_DELIVERY_CHANNELS,

isInternalNonDeliveryChannel,

type InternalMessageChannel,

} from "./message-channel-constants.js";

import {

INTERNAL_MESSAGE_CHANNEL,

type InternalMessageChannel,

} from "./message-channel-constants.js";

import { INTERNAL_MESSAGE_CHANNEL } from "./message-channel-constants.js";

import { normalizeMessageChannel } from "./message-channel-normalize.js";

/**

*/

export { GATEWAY_CLIENT_NAMES, GATEWAY_CLIENT_MODES };

export type { GatewayClientName, GatewayClientMode };

export { normalizeGatewayClientName, normalizeGatewayClientMode };

type GatewayClientInfoLike = {

mode?: string | null;

}

/** Return whether a raw channel id resolves to OpenClaw's internal channel. */

export function isInternalMessageChannel(raw?: string | null): raw is InternalMessageChannel {

export function isInternalMessageChannel(

raw?: string | null,

): raw is typeof INTERNAL_MESSAGE_CHANNEL {

return normalizeMessageChannel(raw) === INTERNAL_MESSAGE_CHANNEL;

}