@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/plugin/channel-config.d.ts

@@ -0,0 +1,716 @@
+/**
+ * channels.xg_cwork_im：Zod schema、账户合并、群 systemPrompt、命令门控（allowFrom / resolveControlCommandGate）。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import { z } from "zod";
+import type { OpenClawChatType } from "../inbound/inbound-chat-type.js";
+import type { XgImConfig, AutoModelRoutingConfig } from "./types.js";
+export declare const XgImConfigSchema: z.ZodEffects<z.ZodObject<{
+    robotKey: z.ZodOptional<z.ZodString>;
+    appKey: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    baseUrl: z.ZodString;
+    wsBaseUrl: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    name: z.ZodOptional<z.ZodString>;
+    groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "mention"]>>>;
+    allowFrom: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    debug: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxConnectionAttempts: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    initialReconnectDelay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxReconnectDelay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    reconnectJitter: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    fileUploadFormField: z.ZodOptional<z.ZodString>;
+    maxAttachmentBytes: z.ZodOptional<z.ZodNumber>;
+    inboundMediaWorkspaceSubdir: z.ZodOptional<z.ZodString>;
+    inboundMediaOpenClawPath: z.ZodOptional<z.ZodEnum<["workspaceRelative", "absoluteFileUrl"]>>;
+    inboundMediaSandboxRootPrefix: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    syncServiceBaseUrl: z.ZodOptional<z.ZodString>;
+    projectPromptMaxChars: z.ZodOptional<z.ZodNumber>;
+    /** 当前 OpenClaw 服务所挂载 NAS 的站点编码；机器级配置，不允许账户级覆盖。 */
+    nasSiteCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    nasVolumeRootMappings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** IM 下发的、跨机器一致的 NAS 逻辑根，例如 /data/touqian。 */
+        logicalRoot: z.ZodString;
+        /** 当前 OpenClaw 宿主机的真实挂载根；只在插件内部使用，严禁下发客户端。 */
+        hostRoot: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        logicalRoot: string;
+        hostRoot: string;
+    }, {
+        logicalRoot: string;
+        hostRoot: string;
+    }>, "many">>;
+    /** 以下工作区限流参数均为进程级配置，不允许账户级覆盖。 */
+    workspaceEventMaxConcurrency: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    workspaceEventMaxFileConcurrency: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    workspaceEventPerAgentConcurrency: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    workspaceEventQueueLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    blockStreaming: z.ZodOptional<z.ZodBoolean>;
+    blockStreamingCoalesce: z.ZodOptional<z.ZodObject<{
+        minChars: z.ZodOptional<z.ZodNumber>;
+        maxChars: z.ZodOptional<z.ZodNumber>;
+        idleMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    }, {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    }>>;
+    deliverModelFallbackNotice: z.ZodOptional<z.ZodBoolean>;
+    deliverSegmentBuffer: z.ZodOptional<z.ZodBoolean>;
+    deliverPartialSnapshot: z.ZodOptional<z.ZodBoolean>;
+    deliverAssistantItems: z.ZodOptional<z.ZodBoolean>;
+    autoModelRouting: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        simpleModel: z.ZodOptional<z.ZodString>;
+        standardModel: z.ZodOptional<z.ZodString>;
+        complexModel: z.ZodOptional<z.ZodString>;
+        criticalModel: z.ZodOptional<z.ZodString>;
+        /** 指定模型模式的模型默认推理等级映射（key 为完整 model ref）。 */
+        thinkingDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["off", "minimal", "low", "medium", "high", "xhigh", "adaptive", "max", "ultra"]>>>;
+        /** 允许启用自动路由的 Agent ID 白名单；缺省/空表示不启用任何 Agent。 */
+        agentAllowlist: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        version: string;
+        agentAllowlist: string[];
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        version?: string | undefined;
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    }>>;
+    dispatchDriver: z.ZodOptional<z.ZodEnum<["auto", "official", "legacy"]>>;
+    accounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        robotKey: z.ZodOptional<z.ZodString>;
+        appKey: z.ZodOptional<z.ZodString>;
+        /** 账户级开关；未设置时继承通道顶层 enabled。 */
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        agentId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        name: z.ZodOptional<z.ZodString>;
+        groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "mention"]>>>;
+        fileUploadFormField: z.ZodOptional<z.ZodString>;
+        maxAttachmentBytes: z.ZodOptional<z.ZodNumber>;
+        inboundMediaWorkspaceSubdir: z.ZodOptional<z.ZodString>;
+        inboundMediaOpenClawPath: z.ZodOptional<z.ZodEnum<["workspaceRelative", "absoluteFileUrl"]>>;
+        inboundMediaSandboxRootPrefix: z.ZodOptional<z.ZodString>;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        syncServiceBaseUrl: z.ZodOptional<z.ZodString>;
+        projectPromptMaxChars: z.ZodOptional<z.ZodNumber>;
+        nasVolumeRootMappings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** IM 下发的、跨机器一致的 NAS 逻辑根，例如 /data/touqian。 */
+            logicalRoot: z.ZodString;
+            /** 当前 OpenClaw 宿主机的真实挂载根；只在插件内部使用，严禁下发客户端。 */
+            hostRoot: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            logicalRoot: string;
+            hostRoot: string;
+        }, {
+            logicalRoot: string;
+            hostRoot: string;
+        }>, "many">>;
+        /**
+         * 为 false 时关闭：assistant 在 tool 前的 text 块不再提前 HTTP deliver（整轮结束才发）。
+         * 未配置时默认开启。
+         */
+        blockStreaming: z.ZodOptional<z.ZodBoolean>;
+        /** 可选：合并同一 text 块内 token 级碎片；IM 默认不配（每个 text_end 立即 HTTP）。 */
+        blockStreamingCoalesce: z.ZodOptional<z.ZodObject<{
+            minChars: z.ZodOptional<z.ZodNumber>;
+            maxChars: z.ZodOptional<z.ZodNumber>;
+            idleMs: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        }, {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        }>>;
+        /**
+         * 为 true 时向 IM 用户发送 OpenClaw 模型降级运营通知（↪️ Model Fallback: …）。
+         * 未配置时默认不发送（仅 gateway 日志）。
+         */
+        deliverModelFallbackNotice: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * 为 false 时关闭段缓冲：blockStreaming 下每次 deliver 仍立即 HTTP（配合 C7 去重）。
+         * 未配置且 blockStreaming 开启时默认开启。
+         */
+        deliverSegmentBuffer: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * 是否改为订阅 OpenClaw `assistant` 流、按「每条 assistant 消息」逐条 HTTP 投递。
+         * 未配置时默认开启：用 assistant item 的完整 text，避免 block reply 分块拼接丢换行；
+         * 设为 false 回退到 block reply 段缓冲聚合。
+         */
+        deliverAssistantItems: z.ZodOptional<z.ZodBoolean>;
+        /** Auto Model Routing（模型 + 推理等级自动路由）；默认关闭。 */
+        autoModelRouting: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            simpleModel: z.ZodOptional<z.ZodString>;
+            standardModel: z.ZodOptional<z.ZodString>;
+            complexModel: z.ZodOptional<z.ZodString>;
+            criticalModel: z.ZodOptional<z.ZodString>;
+            /** 指定模型模式的模型默认推理等级映射（key 为完整 model ref）。 */
+            thinkingDefaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<["off", "minimal", "low", "medium", "high", "xhigh", "adaptive", "max", "ultra"]>>>;
+            /** 允许启用自动路由的 Agent ID 白名单；缺省/空表示不启用任何 Agent。 */
+            agentAllowlist: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            version: string;
+            agentAllowlist: string[];
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        }, {
+            enabled?: boolean | undefined;
+            version?: string | undefined;
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        }>>;
+        /** dispatch 内核驱动：auto / official / legacy（默认 auto）。 */
+        dispatchDriver: z.ZodOptional<z.ZodEnum<["auto", "official", "legacy"]>>;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string;
+        groupPolicy: "open" | "mention";
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled: boolean;
+            version: string;
+            agentAllowlist: string[];
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }, {
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        agentId?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        groupPolicy?: "open" | "mention" | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled?: boolean | undefined;
+            version?: string | undefined;
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    baseUrl: string;
+    enabled: boolean;
+    groupPolicy: "open" | "mention";
+    allowFrom: string[];
+    debug: boolean;
+    maxConnectionAttempts: number;
+    initialReconnectDelay: number;
+    maxReconnectDelay: number;
+    reconnectJitter: number;
+    nasSiteCode: string;
+    workspaceEventMaxConcurrency: number;
+    workspaceEventMaxFileConcurrency: number;
+    workspaceEventPerAgentConcurrency: number;
+    workspaceEventQueueLimit: number;
+    accounts?: Record<string, {
+        agentId: string;
+        groupPolicy: "open" | "mention";
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled: boolean;
+            version: string;
+            agentAllowlist: string[];
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }> | undefined;
+    robotKey?: string | undefined;
+    appKey?: string | undefined;
+    wsBaseUrl?: string | undefined;
+    name?: string | undefined;
+    fileUploadFormField?: string | undefined;
+    maxAttachmentBytes?: number | undefined;
+    inboundMediaWorkspaceSubdir?: string | undefined;
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+    inboundMediaSandboxRootPrefix?: string | undefined;
+    systemPrompt?: string | undefined;
+    syncServiceBaseUrl?: string | undefined;
+    projectPromptMaxChars?: number | undefined;
+    nasVolumeRootMappings?: {
+        logicalRoot: string;
+        hostRoot: string;
+    }[] | undefined;
+    blockStreaming?: boolean | undefined;
+    blockStreamingCoalesce?: {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    } | undefined;
+    deliverModelFallbackNotice?: boolean | undefined;
+    deliverSegmentBuffer?: boolean | undefined;
+    deliverPartialSnapshot?: boolean | undefined;
+    deliverAssistantItems?: boolean | undefined;
+    autoModelRouting?: {
+        enabled: boolean;
+        version: string;
+        agentAllowlist: string[];
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+    } | undefined;
+    dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+}, {
+    baseUrl: string;
+    accounts?: Record<string, {
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        agentId?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        groupPolicy?: "open" | "mention" | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled?: boolean | undefined;
+            version?: string | undefined;
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }> | undefined;
+    robotKey?: string | undefined;
+    appKey?: string | undefined;
+    agentId?: string | undefined;
+    wsBaseUrl?: string | undefined;
+    enabled?: boolean | undefined;
+    name?: string | undefined;
+    groupPolicy?: "open" | "mention" | undefined;
+    allowFrom?: string[] | undefined;
+    debug?: boolean | undefined;
+    maxConnectionAttempts?: number | undefined;
+    initialReconnectDelay?: number | undefined;
+    maxReconnectDelay?: number | undefined;
+    reconnectJitter?: number | undefined;
+    fileUploadFormField?: string | undefined;
+    maxAttachmentBytes?: number | undefined;
+    inboundMediaWorkspaceSubdir?: string | undefined;
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+    inboundMediaSandboxRootPrefix?: string | undefined;
+    systemPrompt?: string | undefined;
+    syncServiceBaseUrl?: string | undefined;
+    projectPromptMaxChars?: number | undefined;
+    nasSiteCode?: string | undefined;
+    nasVolumeRootMappings?: {
+        logicalRoot: string;
+        hostRoot: string;
+    }[] | undefined;
+    workspaceEventMaxConcurrency?: number | undefined;
+    workspaceEventMaxFileConcurrency?: number | undefined;
+    workspaceEventPerAgentConcurrency?: number | undefined;
+    workspaceEventQueueLimit?: number | undefined;
+    blockStreaming?: boolean | undefined;
+    blockStreamingCoalesce?: {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    } | undefined;
+    deliverModelFallbackNotice?: boolean | undefined;
+    deliverSegmentBuffer?: boolean | undefined;
+    deliverPartialSnapshot?: boolean | undefined;
+    deliverAssistantItems?: boolean | undefined;
+    autoModelRouting?: {
+        enabled?: boolean | undefined;
+        version?: string | undefined;
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    } | undefined;
+    dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+}>, {
+    agentId: string;
+    baseUrl: string;
+    enabled: boolean;
+    groupPolicy: "open" | "mention";
+    allowFrom: string[];
+    debug: boolean;
+    maxConnectionAttempts: number;
+    initialReconnectDelay: number;
+    maxReconnectDelay: number;
+    reconnectJitter: number;
+    nasSiteCode: string;
+    workspaceEventMaxConcurrency: number;
+    workspaceEventMaxFileConcurrency: number;
+    workspaceEventPerAgentConcurrency: number;
+    workspaceEventQueueLimit: number;
+    accounts?: Record<string, {
+        agentId: string;
+        groupPolicy: "open" | "mention";
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled: boolean;
+            version: string;
+            agentAllowlist: string[];
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }> | undefined;
+    robotKey?: string | undefined;
+    appKey?: string | undefined;
+    wsBaseUrl?: string | undefined;
+    name?: string | undefined;
+    fileUploadFormField?: string | undefined;
+    maxAttachmentBytes?: number | undefined;
+    inboundMediaWorkspaceSubdir?: string | undefined;
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+    inboundMediaSandboxRootPrefix?: string | undefined;
+    systemPrompt?: string | undefined;
+    syncServiceBaseUrl?: string | undefined;
+    projectPromptMaxChars?: number | undefined;
+    nasVolumeRootMappings?: {
+        logicalRoot: string;
+        hostRoot: string;
+    }[] | undefined;
+    blockStreaming?: boolean | undefined;
+    blockStreamingCoalesce?: {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    } | undefined;
+    deliverModelFallbackNotice?: boolean | undefined;
+    deliverSegmentBuffer?: boolean | undefined;
+    deliverPartialSnapshot?: boolean | undefined;
+    deliverAssistantItems?: boolean | undefined;
+    autoModelRouting?: {
+        enabled: boolean;
+        version: string;
+        agentAllowlist: string[];
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+    } | undefined;
+    dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+}, {
+    baseUrl: string;
+    accounts?: Record<string, {
+        robotKey?: string | undefined;
+        appKey?: string | undefined;
+        agentId?: string | undefined;
+        enabled?: boolean | undefined;
+        name?: string | undefined;
+        groupPolicy?: "open" | "mention" | undefined;
+        fileUploadFormField?: string | undefined;
+        maxAttachmentBytes?: number | undefined;
+        inboundMediaWorkspaceSubdir?: string | undefined;
+        inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+        inboundMediaSandboxRootPrefix?: string | undefined;
+        systemPrompt?: string | undefined;
+        syncServiceBaseUrl?: string | undefined;
+        projectPromptMaxChars?: number | undefined;
+        nasVolumeRootMappings?: {
+            logicalRoot: string;
+            hostRoot: string;
+        }[] | undefined;
+        blockStreaming?: boolean | undefined;
+        blockStreamingCoalesce?: {
+            minChars?: number | undefined;
+            maxChars?: number | undefined;
+            idleMs?: number | undefined;
+        } | undefined;
+        deliverModelFallbackNotice?: boolean | undefined;
+        deliverSegmentBuffer?: boolean | undefined;
+        deliverAssistantItems?: boolean | undefined;
+        autoModelRouting?: {
+            enabled?: boolean | undefined;
+            version?: string | undefined;
+            simpleModel?: string | undefined;
+            standardModel?: string | undefined;
+            complexModel?: string | undefined;
+            criticalModel?: string | undefined;
+            thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | undefined;
+        dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+    }> | undefined;
+    robotKey?: string | undefined;
+    appKey?: string | undefined;
+    agentId?: string | undefined;
+    wsBaseUrl?: string | undefined;
+    enabled?: boolean | undefined;
+    name?: string | undefined;
+    groupPolicy?: "open" | "mention" | undefined;
+    allowFrom?: string[] | undefined;
+    debug?: boolean | undefined;
+    maxConnectionAttempts?: number | undefined;
+    initialReconnectDelay?: number | undefined;
+    maxReconnectDelay?: number | undefined;
+    reconnectJitter?: number | undefined;
+    fileUploadFormField?: string | undefined;
+    maxAttachmentBytes?: number | undefined;
+    inboundMediaWorkspaceSubdir?: string | undefined;
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl" | undefined;
+    inboundMediaSandboxRootPrefix?: string | undefined;
+    systemPrompt?: string | undefined;
+    syncServiceBaseUrl?: string | undefined;
+    projectPromptMaxChars?: number | undefined;
+    nasSiteCode?: string | undefined;
+    nasVolumeRootMappings?: {
+        logicalRoot: string;
+        hostRoot: string;
+    }[] | undefined;
+    workspaceEventMaxConcurrency?: number | undefined;
+    workspaceEventMaxFileConcurrency?: number | undefined;
+    workspaceEventPerAgentConcurrency?: number | undefined;
+    workspaceEventQueueLimit?: number | undefined;
+    blockStreaming?: boolean | undefined;
+    blockStreamingCoalesce?: {
+        minChars?: number | undefined;
+        maxChars?: number | undefined;
+        idleMs?: number | undefined;
+    } | undefined;
+    deliverModelFallbackNotice?: boolean | undefined;
+    deliverSegmentBuffer?: boolean | undefined;
+    deliverPartialSnapshot?: boolean | undefined;
+    deliverAssistantItems?: boolean | undefined;
+    autoModelRouting?: {
+        enabled?: boolean | undefined;
+        version?: string | undefined;
+        simpleModel?: string | undefined;
+        standardModel?: string | undefined;
+        complexModel?: string | undefined;
+        criticalModel?: string | undefined;
+        thinkingDefaults?: Record<string, "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "adaptive" | "max" | "ultra"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    } | undefined;
+    dispatchDriver?: "auto" | "official" | "legacy" | undefined;
+}>;
+/** 将 `robotKey`（推荐）或旧字段 `appKey` 归一为鉴权可用的密钥（两字段同步为同一非空值）。 */
+export declare function normalizeRobotKey<T extends {
+    robotKey?: string;
+    appKey?: string;
+}>(config: T): T;
+/** 从顶层 cfg 中取出 XgImConfig，支持多账户（README：channels.xg_cwork_im） */
+export declare function getXgImConfig(cfg: OpenClawConfig, accountId?: string | null): XgImConfig;
+/** 入站 block streaming 是否开启（未显式 false 时默认开启）。 */
+export declare function isInboundBlockStreamingEnabled(config: XgImConfig): boolean;
+/** 是否向 IM 投递 OpenClaw 模型降级运营通知（仅显式 true 时发送）。 */
+export declare function shouldDeliverModelFallbackNoticeToIm(config: XgImConfig): boolean;
+/** blockStreaming 开启时是否启用段缓冲（未显式 false 时默认开启）。 */
+export declare function isDeliverSegmentBufferEnabled(config: XgImConfig): boolean;
+/** 段缓冲开启时是否用 onPartialReply 全量快照作为正文权威来源（未显式 false 时默认开启）。 */
+export declare function isDeliverPartialSnapshotEnabled(config: XgImConfig): boolean;
+/**
+ * 是否改为订阅 `assistant` 流、按「每条 assistant 消息(item)」逐条 HTTP 投递（未显式 false 时默认开启）。
+ * 开启时 block reply 的正文文本不再发送，只保留媒体/错误/通知；正文由 assistant item 完整 text 投递。
+ */
+export declare function isDeliverAssistantItemsEnabled(config: XgImConfig): boolean;
+/**
+ * IM 通道未配置 coalesce 时注入，覆盖 agents.defaults 偏大值（如 2400/3000），
+ * 并避免旧默认 minChars:1/idleMs:0 切块过碎。
+ * 约半段中文 + ~0.5s 静默，属中间档；可按环境再调。
+ */
+export declare const IM_BLOCK_STREAMING_COALESCE_DEFAULT: {
+    readonly minChars: 500;
+    readonly maxChars: 12000;
+    readonly idleMs: 500;
+};
+/** 传给 OpenClaw replyOptions，强制开启/关闭 text_end 中间块 deliver。 */
+export declare function resolveBlockStreamingReplyOptions(config: XgImConfig): {
+    disableBlockStreaming: boolean;
+};
+/**
+ * 入站 dispatch 用 cfg：在 block streaming 开启且通道未配 coalesce 时，
+ * 为 `channels.xg_cwork_im` 注入 IM 友好 coalesce，避免 agents.defaults 的大 minChars/idleMs 推迟 tool 前 HTTP。
+ */
+export declare function resolveDispatchOpenClawCfg(cfg: OpenClawConfig, config: XgImConfig): OpenClawConfig;
+/**
+ * 合并 `channels.xg_cwork_im` 顶层、`accounts.default`、以及 `accounts.<accountId>` 后的 `systemPrompt`，
+ * 写入 OpenClaw 入站 `GroupSystemPrompt`。
+ */
+export declare function resolveXgImGroupSystemPrompt(cfg: OpenClawConfig, accountId: string): string | undefined;
+export declare function isConfigured(cfg: OpenClawConfig): boolean;
+/** Auto Model Routing 运行时配置（归一默认值）。 */
+export declare function resolveAutoModelRoutingConfig(config: XgImConfig): AutoModelRoutingConfig;
+/**
+ * Auto 路由是否对本 Agent 生效：enabled=true 且 Agent 在白名单。
+ * allowlist 缺省/为空时不启用任何 Agent（安全默认，避免未经灰度就自动路由）。
+ */
+export declare function isAutoModelRoutingEnabled(cfg: AutoModelRoutingConfig, agentId: string): boolean;
+/**
+ * 解析 Auto Router 的四模型槽位；任一槽位缺失即视为未就绪（返回 undefined，
+ * 由调用方回退 Agent 默认配置，绝不把半套配置用于路由）。
+ */
+export declare function resolveAutoModelRoutingSlots(cfg: AutoModelRoutingConfig): {
+    simpleModel: string;
+    standardModel: string;
+    complexModel: string;
+    criticalModel: string;
+} | undefined;
+export declare function resolveInboundCommandAuthorized(rt: unknown, cfg: OpenClawConfig, p: {
+    accountId: string;
+    senderId: string | undefined;
+    config: XgImConfig;
+    /** OpenClaw 入站 ChatType（单聊 direct / 群聊 group），供命令门控区分 DM 与群规则 */
+    chatType: OpenClawChatType;
+}): boolean;
+//# sourceMappingURL=channel-config.d.ts.map