@xgjktech/xg_cwork_im 1.19.28 → 1.19.29

package/dist/src/turn-end-controller.js.map

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

package/dist/src/turn-end-controller.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turn-end-controller.test.d.ts.map

package/dist/src/turn-end-controller.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-end-controller.test.d.ts","sourceRoot":"","sources":["../../src/turn-end-controller.test.ts"],"names":[],"mappings":""}

package/dist/src/turn-end-controller.test.js

@@ -0,0 +1,97 @@
+import { test, describe, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import { turnEnsureRound, turnOnDispatchReturned, turnOnSubagentSpawn, turnOnSubagentEnded, turnOnSegmentStart, turnOnSegmentEnd, turnOnActivity, turnIsEligible, turnIsSawSubagent, turnForget, __resetTurnEndControllerForTests, __configureTurnEndForTests, } from "./turn-end-controller.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+describe("turn-end-controller（OpenClaw 7.1+/8.x 子任务整轮收尾）", () => {
+    beforeEach(() => {
+        __resetTurnEndControllerForTests();
+        __configureTurnEndForTests({
+            nonYieldDebounceMs: 20,
+            noLifecycleFallbackMs: 40,
+        });
+    });
+    test("顺序多子任务：仅首个/各段子任务完成不触发收尾，父会话非 yield 终态后才 eligible", async () => {
+        const rk = "acc:g1";
+        const gen = 1;
+        turnEnsureRound(rk, gen);
+        turnOnDispatchReturned(rk, gen);
+        // 第 1 段：start → spawn(child1) → yield end
+        turnOnSegmentStart(rk, gen);
+        turnOnSubagentSpawn(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: true, stopReason: "end_turn" });
+        assert.equal(turnIsEligible(rk, gen), false, "段以 yield 结束 → 不收尾");
+        // child1 完成
+        turnOnSubagentEnded(rk, gen);
+        assert.equal(turnIsEligible(rk, gen), false, "子任务完成但父会话可能 resume → 不立即收尾");
+        // 父会话 resume（新段）→ 派发 child2 → yield end
+        turnOnSegmentStart(rk, gen);
+        turnOnSubagentSpawn(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: true, stopReason: "end_turn" });
+        turnOnSubagentEnded(rk, gen);
+        assert.equal(turnIsEligible(rk, gen), false);
+        // 父会话最后一次 resume，产出最终答复后以非 yield 终态结束
+        turnOnSegmentStart(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: false, stopReason: "end_turn" });
+        await sleep(60);
+        assert.equal(turnIsEligible(rk, gen), true, "非 yield 终态 → 防抖后收尾");
+    });
+    test("子任务完成但父会话 resume 迟于旧兜底假设到达（慢 announce）→ 不提前收尾", async () => {
+        const rk = "acc:g2";
+        const gen = 1;
+        turnEnsureRound(rk, gen);
+        turnOnDispatchReturned(rk, gen);
+        turnOnSegmentStart(rk, gen);
+        turnOnSubagentSpawn(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: true });
+        turnOnSubagentEnded(rk, gen);
+        assert.equal(turnIsEligible(rk, gen), false);
+        // 父会话 resume 的 announce 投递时延不受控（与子任务时长无关），即便超过旧的
+        // “20s 兜底”假设也不得提前收尾——提前会拆 round，使后续同轮子任务丢 SUBAGENT_STAT。
+        await sleep(80);
+        assert.equal(turnIsEligible(rk, gen), false, "慢 announce 期间不能提前收尾");
+        // resume 终于到达：父会话新段产出最终答复并以非 yield 终态结束
+        turnOnSegmentStart(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: false });
+        await sleep(60);
+        assert.equal(turnIsEligible(rk, gen), true);
+    });
+    test("组内活动心跳可延续等待（父会话还在工作时不误收尾）", async () => {
+        const rk = "acc:g3";
+        const gen = 1;
+        turnEnsureRound(rk, gen);
+        turnOnDispatchReturned(rk, gen);
+        turnOnSegmentStart(rk, gen);
+        turnOnSubagentSpawn(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: true });
+        turnOnSubagentEnded(rk, gen);
+        // 兜底窗口内出现组内工具活动 → 取消收尾计时
+        turnOnActivity(rk, gen);
+        await sleep(80);
+        assert.equal(turnIsEligible(rk, gen), false, "心跳延续等待，不能提前收尾");
+        turnOnSegmentStart(rk, gen);
+        turnOnSegmentEnd(rk, gen, { phase: "end", yielded: false });
+        await sleep(60);
+        assert.equal(turnIsEligible(rk, gen), true);
+    });
+    test("lifecycle 完全不可见（订阅不可用）→ 兜底收尾且不悬挂", async () => {
+        const rk = "acc:g4";
+        const gen = 1;
+        turnEnsureRound(rk, gen);
+        turnOnDispatchReturned(rk, gen);
+        turnOnSubagentSpawn(rk, gen);
+        turnOnSubagentEnded(rk, gen);
+        await sleep(80);
+        assert.equal(turnIsEligible(rk, gen), true);
+    });
+    test("sawSubagent 标记来自 spawn 事件；turnForget 清理状态", () => {
+        const rk = "acc:g5";
+        const gen = 1;
+        turnEnsureRound(rk, gen);
+        assert.equal(turnIsSawSubagent(rk, gen), false);
+        turnOnSubagentSpawn(rk, gen);
+        assert.equal(turnIsSawSubagent(rk, gen), true);
+        turnForget(rk, gen);
+        assert.equal(turnIsSawSubagent(rk, gen), false);
+    });
+});
+//# sourceMappingURL=turn-end-controller.test.js.map

package/dist/src/turn-end-controller.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-end-controller.test.js","sourceRoot":"","sources":["../../src/turn-end-controller.test.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,433 @@
+/**
+ * XG-IM Channel Plugin — 类型定义
+ */
+import type { OpenClawConfig, ChannelPlugin as SDKChannelPlugin, PluginRuntime } from "openclaw/plugin-sdk/core";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+import type { ChannelAccountSnapshot as SDKChannelAccountSnapshot } from "openclaw/plugin-sdk/status-helpers";
+import type { ChannelGatewayContext as SDKChannelGatewayContext } from "openclaw/plugin-sdk/channel-contract";
+import type { RobotMentionAgentContext } from "./agent-context-types.js";
+export interface XgImPluginModule {
+    id: string;
+    name: string;
+    description?: string;
+    configSchema?: unknown;
+    register?: (api: OpenClawPluginApi) => void | Promise<void>;
+}
+/** 与 openclaw.plugin.json 中 id: xg_cwork_im 对应 */
+export type XgCworkImPluginModule = XgImPluginModule;
+/**
+ * Auto Model Routing（模型 + 推理等级自动路由）配置。
+ * - enabled=false 或 Agent 不在 allowlist 时，前端 `ai_model: "auto"` 按未指定模型处理。
+ * - 四个模型槽位是 Auto Router 可输出的全部模型。
+ * - thinkingDefaults：指定模型模式下各 model ref 的默认推理等级。
+ */
+export interface AutoModelRoutingConfig {
+    enabled?: boolean;
+    version?: string;
+    simpleModel?: string;
+    standardModel?: string;
+    complexModel?: string;
+    criticalModel?: string;
+    thinkingDefaults?: Record<string, string>;
+    agentAllowlist?: string[];
+}
+/** IM 逻辑 NAS 根到当前 OpenClaw 宿主机真实根目录的映射。 */
+export interface NasVolumeRootMapping {
+    /** 跨机器一致的绝对逻辑根，例如 /data/touqian。 */
+    logicalRoot: string;
+    /** 当前机器的真实 NAS 挂载根；仅插件内部可见，不得发送给 IM 客户端。 */
+    hostRoot: string;
+}
+/** 单个机器人账户配置 */
+export interface XgImAccountConfig {
+    /** 机器人 Key（新字段，优先于 appKey） */
+    robotKey?: string;
+    /** 机器人 appKey，从 IM 后台注册获取（已改名为 robotKey，此字段保留兼容旧配置） */
+    appKey?: string;
+    /** 是否启用当前账户；未设置时继承 channels.xg_cwork_im.enabled。 */
+    enabled?: boolean;
+    /** 对应 OpenClaw 的 Agent ID，默认为 'main' */
+    agentId?: string;
+    /** 账户显示名称 */
+    name?: string;
+    /** 群聊策略：open = 不需要 @，mention = 必须 @ 机器人才触发 */
+    groupPolicy?: "open" | "mention";
+    /** multipart 整文件上传字段名，默认 file（与 `/file/upDownload/uploadWholeFile` 约定一致时可不改） */
+    fileUploadFormField?: string;
+    maxAttachmentBytes?: number;
+    /** 覆盖顶层的入站附件 workspace 子目录（相对 Agent workspace） */
+    inboundMediaWorkspaceSubdir?: string;
+    /**
+     * 覆盖顶层：入站落盘后交给 OpenClaw 的 `MediaPath` 形式。
+     * - `workspaceRelative`（默认）：`./子目录/...`，或配合 `inboundMediaSandboxRootPrefix` 为 `/workspace/子目录/...`。
+     * - `absoluteFileUrl`：宿主机 `file://...`，仅适合无沙箱、同进程读盘场景。
+     */
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl";
+    /**
+     * 沙箱内 Agent workspace 挂载根路径（如 `/workspace`）。
+     * 与 `inboundMediaOpenClawPath: workspaceRelative` 联用时，入站 `MediaPath` 为
+     * `{inboundMediaSandboxRootPrefix}/xg_im_inbound/...`，避免 `./` 被工具按 cwd 解析而报「不可访问」。
+     */
+    inboundMediaSandboxRootPrefix?: string;
+    /**
+     * 可选：本账户在群聊中追加给 Agent 的补充说明（映射为 OpenClaw 入站 `GroupSystemPrompt`）。
+     * 与顶层 `systemPrompt` 的合并规则见 `getXgImConfig`（`accounts.default` 与具体账户覆盖）。
+     */
+    systemPrompt?: string;
+    /** 见 {@link XgImConfig.syncServiceBaseUrl} */
+    syncServiceBaseUrl?: string;
+    /** 见 {@link XgImConfig.projectPromptMaxChars} */
+    projectPromptMaxChars?: number;
+    /** 见 {@link XgImConfig.nasVolumeRootMappings} */
+    nasVolumeRootMappings?: NasVolumeRootMapping[];
+    /** 见 {@link XgImConfig.blockStreaming} */
+    blockStreaming?: boolean;
+    /** 见 {@link XgImConfig.blockStreamingCoalesce} */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** 见 {@link XgImConfig.deliverModelFallbackNotice} */
+    deliverModelFallbackNotice?: boolean;
+    /** 见 {@link XgImConfig.deliverSegmentBuffer} */
+    deliverSegmentBuffer?: boolean;
+    /** 见 {@link XgImConfig.deliverPartialSnapshot} */
+    deliverPartialSnapshot?: boolean;
+    /** 见 {@link XgImConfig.deliverAssistantItems} */
+    deliverAssistantItems?: boolean;
+    /** Auto Model Routing（模型 + 推理等级自动路由）；默认关闭。 */
+    autoModelRouting?: AutoModelRoutingConfig;
+    /** 见 {@link XgImConfig.dispatchDriver} */
+    dispatchDriver?: "auto" | "official" | "legacy";
+}
+/** OpenClaw block reply 合并阈值（可选；IM 默认不配） */
+export interface BlockStreamingCoalesceConfig {
+    minChars?: number;
+    maxChars?: number;
+    idleMs?: number;
+}
+export interface XgImConfig extends OpenClawConfig {
+    /** 多账户列表 */
+    accounts?: Record<string, XgImAccountConfig>;
+    /** 机器人 Key（新字段，优先于 appKey，单账户模式） */
+    robotKey?: string;
+    /** 机器人 appKey（单账户模式，已改名为 robotKey，此字段保留兼容旧配置） */
+    appKey?: string;
+    /** 对应 OpenClaw 的 Agent ID（单账户模式） */
+    agentId?: string;
+    /** IM 服务域名，如 https://test.xgjktech.com.cn */
+    baseUrl: string;
+    /** WebSocket 服务域名，如 wss://test.xgjktech.com.cn */
+    wsBaseUrl?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 账户显示名称（单账户模式使用） */
+    name?: string;
+    /** 群聊策略：open = 不需要 @，mention = 必须 @ 机器人才触发 */
+    groupPolicy?: "open" | "mention";
+    /** 允许的发送者 userId 白名单（空表示全部允许） */
+    allowFrom?: string[];
+    /** 是否开启调试日志 */
+    debug?: boolean;
+    /** 最大重连次数（默认 10） */
+    maxConnectionAttempts?: number;
+    /** 初始重连延迟 ms（默认 1000） */
+    initialReconnectDelay?: number;
+    /** 最大重连延迟 ms（默认 60000） */
+    maxReconnectDelay?: number;
+    /** 重连延迟抖动因子 0-1（默认 0.3） */
+    reconnectJitter?: number;
+    /**
+     * 首次 AI 回复超时时间（毫秒）。
+     *
+     * - 未配置时默认 30 分钟（1800_000ms）。
+     * - 仅用于保护「思考中」占位消息，避免长时间不被更新。
+     */
+    firstReplyTimeoutMs?: number;
+    /**
+     * 附件上传地址固定为 `{baseUrl}/file/upDownload/uploadWholeFile`，请求头 `access-token` 与发 IM 相同。
+     * multipart 字段名默认 `file`，可通过 fileUploadFormField 覆盖。
+     */
+    fileUploadFormField?: string;
+    /** 单个附件下载/上传允许的最大字节数，默认 50MB */
+    maxAttachmentBytes?: number;
+    /**
+     * 若配置为非空相对路径（相对于当前 Agent workspace 根目录）：入站附件会先下载到
+     * `{workspace}/{本字段}/{userId}/{YYYY-MM-DD}/{name}_{HHmmssmmm}.ext`，再向 OpenClaw 传入 **workspace 相对路径**（默认 `./子目录/...`，便于沙箱挂载 `/workspace`）或 `file://`（见 `inboundMediaOpenClawPath`）。
+     * 未配置或为空则仍使用 IM 返回的远程 URL。
+     */
+    inboundMediaWorkspaceSubdir?: string;
+    /**
+     * 入站落盘后写入 `MediaPath` 的引用形式；默认与 `workspaceRelative` 等价（未填时）。
+     * Agent 在沙箱中运行时应用 `workspaceRelative`，避免宿主机绝对 `file://` 在沙箱内不可读。
+     */
+    inboundMediaOpenClawPath?: "workspaceRelative" | "absoluteFileUrl";
+    /** 见 {@link XgImAccountConfig.inboundMediaSandboxRootPrefix} */
+    inboundMediaSandboxRootPrefix?: string;
+    /**
+     * 可选：本通道在群聊中追加给 Agent 的补充说明（映射为 OpenClaw 入站 `GroupSystemPrompt`）。
+     * 多账户时可与 `accounts.<id>.systemPrompt` 及 `accounts.default.systemPrompt` 组合覆盖，见插件内 `getXgImConfig`。
+     */
+    systemPrompt?: string;
+    /**
+     * openclaw-xgkb-sync 管理 API 根地址（如 `http://127.0.0.1:9090`）。
+     * 配置后插件可处理 IM 下发的 `openclawApplySyncMapping` 并登记目录映射。
+     */
+    syncServiceBaseUrl?: string;
+    /** `agentContext.background` 与 `userInfo.background` 单段最大字符数（默认 15000） */
+    projectPromptMaxChars?: number;
+    /**
+     * 当前 OpenClaw 服务所挂载 NAS 的站点编码。
+     * 配置路径为 channels.xg_cwork_im.nasSiteCode，默认 SZ_PRIMARY；该值会随 NAS 工作区结果回传客户端。
+     */
+    nasSiteCode?: string;
+    /** 将 IM 的逻辑 realDir 根映射为当前 OpenClaw 宿主机上的真实根目录。 */
+    nasVolumeRootMappings?: NasVolumeRootMapping[];
+    /** 单个插件进程中所有 Agent 共享的工作区活动请求上限，默认 32。 */
+    workspaceEventMaxConcurrency?: number;
+    /** 工作区活动请求中 FILE_REQUEST 的上限，默认 8。 */
+    workspaceEventMaxFileConcurrency?: number;
+    /** 同一个 agentId 同时执行的工作区请求上限，默认 2。 */
+    workspaceEventPerAgentConcurrency?: number;
+    /** 达到活动请求上限后允许等待的全局请求数，默认 64；设为 0 表示不排队。 */
+    workspaceEventQueueLimit?: number;
+    /**
+     * 是否在 assistant 每个 text 块结束（tool 调用前）通过 HTTP 发送中间正文。
+     * 默认开启；设为 `false` 恢复「整轮结束才 deliver 一次」。
+     */
+    blockStreaming?: boolean;
+    /**
+     * 可选：合并同一 text 块内的流式 token 碎片后再向通道 deliver。
+     * 通道未配时插件注入默认 `minChars:500 idleMs:500`（盖住 agents.defaults 偏大值，也避免旧 1/0 过碎）。
+     */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /**
+     * 是否向 IM 用户发送 OpenClaw 模型降级运营通知（`↪️ Model Fallback: …`）。
+     * 默认 `false`（不发送）；设为 `true` 时与旧版行为一致。
+     */
+    deliverModelFallbackNotice?: boolean;
+    /**
+     * 是否在 `blockStreaming` 开启时，将同一段 assistant 正文缓冲后在 tool 边界 / 轮次结束再 HTTP。
+     * 默认 `true`：修稿覆盖、流式分块追加合并；设为 `false` 恢复「每次 deliver 即 HTTP + C7 去重」。
+     */
+    deliverSegmentBuffer?: boolean;
+    /**
+     * 是否用 `onPartialReply` 的全量快照作为段内正文的权威来源（在 tool 边界 / 轮末 flush 时覆盖 deliver 拼接文本）。
+     * 默认 `true`：消除段缓冲对「覆盖 vs 追加」的启发式猜测（CO2）；设为 `false` 回退到纯 deliver 段缓冲。
+     * 仅在快照包含缓冲文本时才覆盖，避免流式竞态下截断。
+     */
+    deliverPartialSnapshot?: boolean;
+    /**
+     * 是否改为订阅 OpenClaw `assistant` 流、按「每条 assistant 消息(item)」逐条 HTTP 投递。
+     * 默认 `true`：用 assistant item 的完整 text，避免 block reply 分块拼接丢换行，且不含 commentary；
+     * 设为 `false` 回退到 block reply 段缓冲聚合。
+     */
+    deliverAssistantItems?: boolean;
+    /** Auto Model Routing（模型 + 推理等级自动路由）；默认关闭。 */
+    autoModelRouting?: AutoModelRoutingConfig;
+    /**
+     * dispatch 内核驱动：`auto`（默认）= 宿主支持时用官方 assembled turn
+     * （runtime.channel.inbound.dispatchReply），否则回退 legacy；
+     * `official` 强制官方；`legacy` 强制旧路径（回退开关）。
+     * 也可用环境变量 `XG_CWORK_IM_DISPATCH_DRIVER=official|legacy` 覆盖。
+     */
+    dispatchDriver?: "auto" | "official" | "legacy";
+}
+/** GET /user/login/appkey 的响应 */
+export interface GetTokenResponse {
+    data?: {
+        xgToken: string;
+        empId: string;
+        userName?: string;
+        avatar?: string;
+        corpId?: string;
+        deptList?: unknown[];
+        appCode?: string;
+        telephone?: string;
+        personId?: string;
+    };
+    resultCode?: number;
+    resultMsg?: string | null;
+}
+/** 机器人身份信息（认证成功后缓存） */
+export interface BotIdentity {
+    token: string;
+    userId: string;
+    name: string;
+}
+/** WebSocket 消息通知（cmd = robotMention） */
+export interface WsMessage {
+    cmd: string;
+    params: WsMessageParams;
+    ts: number;
+}
+/**
+ * 与 IM 服务 `MsgFileVO` 对齐的附件项（WebSocket `msgContent.files[]`）。
+ */
+export interface MsgFileVO {
+    /** 远程下载链接，或入站落盘后的 `file://` / workspace 相对引用（如 `./xg_im_inbound/...`） */
+    url: string;
+    /** 文件格式，小写：pdf、png、docx、doc、ppt、txt、md 等 */
+    format?: string;
+    /**
+     * 附件来源（IM 侧人类可读文案，原样展示给 OpenClaw），如「知识库文档」「工作汇报」。
+     * 新增来源类型由 IM 维护，插件不做枚举映射。
+     */
+    source?: string;
+    /** 业务引用 ID（在 source 域内唯一）；七牛等无业务 id 时可为空 */
+    fileId?: string;
+    /** 文件大小（字节） */
+    size?: number;
+    /** 文件名称，如 xxx.pdf */
+    name?: string;
+    /**
+     * IM 侧已解析的正文（如图片 OCR/说明、文档抽取的文本等）。
+     * 非空时插件会拼入入站 `Body`/`RawBody`，一并交给 OpenClaw。
+     */
+    content?: string;
+    /**
+     * 是否将 url 当作文件下载链接落盘到 workspace input。
+     * - `true`：一定下载
+     * - `false`：不下载，url 原样写入 MediaPath（可读内容页/API 链接等）
+     * - 未传或空：有 content 则不下载，否则下载
+     */
+    download?: boolean | string | number;
+}
+/** @deprecated 使用 {@link MsgFileVO} */
+export type WsInboundFileItem = MsgFileVO;
+/** 常见 IM format → MIME，供 OpenClaw 媒体理解；未知格式返回 undefined */
+export declare function imFormatToMimeType(format: string | undefined): string | undefined;
+/**
+ * 入站消息内容体（与 IM WebSocket `params.msgContent` 对齐）。
+ *
+ * - **type=`text`**：纯文本；**text** 建议非空。
+ * - **type=`file`**：带 1..N 个文件，**files** 建议至少 1 项；**text** 可为配文（同时上传多文件 + 一句话）。**files[].content** 可由 IM 填已解析文本（如图/文档），插件会拼入入站正文。
+ * - 语音在 IM 侧已转写为文字时，应以 **type=`text`** 推送转写结果，不再使用 voice。
+ */
+export interface WsMessageContent {
+    /** 文本正文；纯文本消息为主内容；file 消息上为可选配文 */
+    text?: string;
+    /** `text` | `file`（可扩展其它枚举，插件对未知类型按文本兜底） */
+    type: string;
+    /** 多附件；type 为 file 时由 IM 填至少一项 */
+    files?: MsgFileVO[];
+    /**
+     * 透传给 AI 的扩展参数。已知键：
+     * - `ai_model`：单轮模型（`default`/`auto`/具体 model ref）；
+     * - `ai_thinking`：单轮推理强度（`off|minimal|low|medium|high|xhigh|adaptive|max|ultra`）。
+     * 两者均不进入 prompt（由 inbound-display 从 untrusted context 剔除）。
+     */
+    ext?: Record<string, any>;
+}
+/** IM 在 robotMention 上下发的项目上下文（见 docs/im服务接口说明.md） */
+export type { AgentContextKnowledgeBase, NasVolume, RobotMentionAgentContext } from "./agent-context-types.js";
+/** robotMention 消息的 params */
+export interface WsMessageParams {
+    msgId: string;
+    groupId: string;
+    /** 项目级上下文：localRoot / NAS 目录 + 可选知识库绑定 + 可选背景，插件合并进 GroupSystemPrompt */
+    agentContext?: RobotMentionAgentContext;
+    /** 发送人信息 */
+    userInfo: {
+        /** 发送人 ID */
+        id: string;
+        /** 发送人显示名 */
+        name: string;
+        /**
+         * 用户背景（IM 服务端拼接：姓名、职位、部门、业务 OpenAPI appKey 等）。
+         * 非空时写入 GroupSystemPrompt 的 `## 当前用户` 段。
+         */
+        background?: string;
+        /**
+         * 当前用户的原始业务 OpenAPI AppKey。
+         * 插件按「最后触发者」覆盖写入该会话的 exec 环境变量 `XG_OPENAPI_APP_KEY`，
+         * 供 skill / 命令以子进程方式调用业务 OpenAPI 时使用（不进入 LLM prompt）。
+         */
+        appKey?: string;
+    };
+    msgContent: WsMessageContent;
+    /** 服务端可能返回 msgSendTime 或 timestamp */
+    msgSendTime?: number;
+    timestamp?: number;
+    /** 被 @ 的人员 ID 列表 */
+    mentions?: string[] | null;
+    /**
+     * 会话类型：`SINGLE` 单聊 | `GROUP` 群聊。
+     * 单聊时插件无需 @ 即触发 AI，且出站 `/im/message/send` 省略 `reply` 字段。
+     * 未传时按群聊逻辑处理（依赖 mentions 或正文 @）。
+     */
+    chatType?: ImChatTypeParam;
+}
+/** IM 下发的 chatType 字符串（大小写不敏感，插件归一化为大写） */
+export type ImChatTypeParam = "SINGLE" | "GROUP" | "single" | "group";
+/** POST /im/message/send 请求体 */
+export interface SendMessageReply {
+    /** 被回复消息ID */
+    targetMsgId: string;
+    /** 被回复消息发送者ID */
+    targetUserId: string;
+    /** 被回复消息发送者显示名 */
+    targetUserName: string;
+    /** 被回复消息摘要 */
+    previewText: string;
+}
+/** IM 发送 FILE 类型消息时的附件项（与发消息接口约定一致） */
+export interface SendMessageFileAttachment {
+    fileId: string;
+    /** 固定为 FILE */
+    fileType: "FILE";
+    /** 小写扩展名，如 md、pdf */
+    format: string;
+    name: string;
+    size: number;
+    /** 固定为 resource */
+    source: "resource";
+}
+export type SendMessageBody = {
+    type: "TEXT" | "RICH_TEXT" | "VOICE";
+    groupId?: string;
+    toUserId?: string;
+    text: string;
+    atUserIds?: string[];
+    /** @deprecated 占位消息合并字段，已废弃，不再发送。 */
+    msgId?: string;
+    /** 客户端消息幂等键：服务端按 clientMsgId + groupId + 最近 10 分钟去重（重试复用同值 → 命中已有消息，不重复投递）。 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+} | {
+    type: "FILE";
+    groupId?: string;
+    toUserId?: string;
+    text: string;
+    attachments: SendMessageFileAttachment[];
+    atUserIds?: string[];
+    /** @deprecated 占位消息合并字段，已废弃，不再发送。 */
+    msgId?: string;
+    /** 客户端消息幂等键：服务端按 clientMsgId + groupId + 最近 10 分钟去重（重试复用同值 → 命中已有消息，不重复投递）。 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+};
+/** GET /im/message/getLatestMsgListForAI 响应 */
+export interface GetLatestMsgListResponse {
+    data?: WsMessageParams[];
+    resultCode?: number;
+    message?: string;
+}
+export type ChannelLogSink = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+};
+export type ChannelAccountSnapshot = SDKChannelAccountSnapshot;
+export interface ResolvedAccount {
+    accountId: string;
+    config: XgImConfig;
+    enabled: boolean;
+    configured: boolean;
+    name?: string | null;
+}
+export type GatewayStartContext = SDKChannelGatewayContext<ResolvedAccount>;
+export type XgImChannelPlugin = SDKChannelPlugin<ResolvedAccount & {
+    configured: boolean;
+}>;
+/** PluginRuntime 的类型（内部 API 丰富，用 any 表示） */
+export type { PluginRuntime };
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,32 @@
+/**
+ * XG-IM Channel Plugin — 类型定义
+ */
+/** 常见 IM format → MIME，供 OpenClaw 媒体理解；未知格式返回 undefined */
+export function imFormatToMimeType(format) {
+    const f = format?.trim().toLowerCase();
+    if (!f)
+        return undefined;
+    const map = {
+        pdf: "application/pdf",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        webp: "image/webp",
+        doc: "application/msword",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        ppt: "application/vnd.ms-powerpoint",
+        pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        xls: "application/vnd.ms-excel",
+        xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        txt: "text/plain",
+        md: "text/markdown",
+        csv: "text/csv",
+        zip: "application/zip",
+        mp3: "audio/mpeg",
+        wav: "audio/wav",
+        mp4: "video/mp4",
+    };
+    return map[f];
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiUH,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IACzD,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,GAAG,GAA2B;QAChC,GAAG,EAAE,iBAAiB;QACtB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,yEAAyE;QAC/E,GAAG,EAAE,+BAA+B;QACpC,IAAI,EAAE,2EAA2E;QACjF,GAAG,EAAE,0BAA0B;QAC/B,IAAI,EAAE,mEAAmE;QACzE,GAAG,EAAE,YAAY;QACjB,EAAE,EAAE,eAAe;QACnB,GAAG,EAAE,UAAU;QACf,GAAG,EAAE,iBAAiB;QACtB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,WAAW;KACnB,CAAC;IACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/user-facing-errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 面向 IM 的确认错误文案：仅白名单翻译或透传上游原文；不编造「没有生成回复」等结论。
+ */
+import type { NoReplyCause, TerminalState } from "./inbound-terminal-state.js";
+export type TerminalMessageContext = {
+    /** 原始错误信息（分类前），用于确认映射或透传 */
+    errorMessage?: string;
+    noReplyCause?: NoReplyCause;
+    /**
+     * @deprecated 首包超时不对用户发文案；仅日志可能仍带此字段。
+     */
+    timeoutCause?: FirstReplyTimeoutCause;
+};
+/** 首条回复超时日志粗分（不对 IM 发终态话术） */
+export type FirstReplyTimeoutCause = "never_started" | "in_progress" | "ended_without_http_reply";
+export declare function isAttachmentBlockedErrorMessage(message: string): boolean;
+export declare function isWebSocketNotReadyErrorMessage(message: string): boolean;
+export declare function isContextOverflowErrorMessage(message: string): boolean;
+export declare function isNasVolumeErrorMessage(message: string): boolean;
+/**
+ * 上游错误 → IM 正文：确认白名单译人话，否则透传截断原文；无内容则空串。
+ */
+export declare function formatConfirmedUpstreamErrorForIm(raw: string): string;
+/**
+ * 终态 HTTP 文案：仅 delivery_failed / 确认错误等；no_reply / timeout / compaction 返回空（不发）。
+ */
+export declare function buildTerminalUserMessage(state: TerminalState, context?: TerminalMessageContext): string;
+/**
+ * 出站发文件失败时，将技术错误转为用户可读说明（不含实现细节与操作建议）。
+ */
+export declare function formatUserFacingMediaDeliverError(err: unknown, mediaRefs?: string[]): string;
+//# sourceMappingURL=user-facing-errors.d.ts.map