@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

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

@@ -0,0 +1,650 @@
+/**
+ * channels.xg_cwork_im：Zod schema、账户合并、群 systemPrompt、命令门控（allowFrom / resolveControlCommandGate）。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import { z } from "zod";
+import type { OpenClawChatType } from "./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>;
+    nasVolumeRootMappings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        logicalRoot: z.ZodString;
+        hostRoot: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        logicalRoot: string;
+        hostRoot: string;
+    }, {
+        logicalRoot: string;
+        hostRoot: string;
+    }>, "many">>;
+    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>;
+    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"]>>>;
+        /** 允许启用自动路由的 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"> | 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"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    }>>;
+    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<{
+            logicalRoot: z.ZodString;
+            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>;
+        /** 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"]>>>;
+            /** 允许启用自动路由的 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"> | 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"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        }>>;
+    }, "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;
+        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"> | undefined;
+        } | 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;
+        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"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | 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;
+    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;
+        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"> | undefined;
+        } | 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;
+    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"> | undefined;
+    } | 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;
+        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"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | 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;
+    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;
+    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"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    } | undefined;
+}>, {
+    agentId: string;
+    baseUrl: string;
+    enabled: boolean;
+    groupPolicy: "open" | "mention";
+    allowFrom: string[];
+    debug: boolean;
+    maxConnectionAttempts: number;
+    initialReconnectDelay: number;
+    maxReconnectDelay: number;
+    reconnectJitter: 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;
+        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"> | undefined;
+        } | 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;
+    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"> | undefined;
+    } | 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;
+        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"> | undefined;
+            agentAllowlist?: string[] | undefined;
+        } | 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;
+    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;
+    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"> | undefined;
+        agentAllowlist?: string[] | undefined;
+    } | 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;
+/**
+ * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config.d.ts","sourceRoot":"","sources":["../../src/channel-config.ts"],"names":[],"mappings":"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"}