@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/delivery/assistant-item-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-item-sink.d.ts","sourceRoot":"","sources":["../../../src/delivery/assistant-item-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIvF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAGtF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEtF;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAMzF;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/src/delivery/assistant-item-sink.js

@@ -0,0 +1,34 @@
+/**
+ * assistant item 投递回调注册表。
+ *
+ * `assistant` 流订阅按「每条 assistant 消息(item)」汇总正文；每条的 HTTP 投递由正在处理该
+ * 会话的 dispatch 负责（它持有 config/token/reply 元数据/终态控制器/去重状态）。订阅侧只做
+ * 「识别 item 边界 + 把完整正文交给 sink」，避免订阅模块自己重复持有鉴权与发送逻辑。
+ *
+ * sink 在 dispatch 开始时按 sessionKey 注册、结束时清除。
+ */
+import { getSharedMap } from "../plugin/process-shared-store.js";
+const sinks = getSharedMap("assistant-item-sinks");
+export function setAssistantItemSink(sessionKey, sink) {
+    if (!sessionKey)
+        return;
+    sinks.set(sessionKey, sink);
+}
+export function getAssistantItemSink(sessionKey) {
+    return sessionKey ? sinks.get(sessionKey) : undefined;
+}
+/** 清除 sink；传入 sink 时仅在仍是同引用时清除，避免误清新 dispatch 的注册。 */
+export function clearAssistantItemSink(sessionKey, sink) {
+    if (!sessionKey)
+        return;
+    const current = sinks.get(sessionKey);
+    if (!current)
+        return;
+    if (sink && current !== sink)
+        return;
+    sinks.delete(sessionKey);
+}
+export function disposeAssistantItemSinks() {
+    sinks.clear();
+}
+//# sourceMappingURL=assistant-item-sink.js.map

package/dist/src/delivery/assistant-item-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-item-sink.js","sourceRoot":"","sources":["../../../src/delivery/assistant-item-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAKjE,MAAM,KAAK,GAAG,YAAY,CAA4B,sBAAsB,CAAC,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,IAAuB;IAC5E,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACnD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,IAAwB;IAC/E,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,IAAI,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IACrC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACrC,KAAK,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/src/delivery/block-streaming-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-streaming-config.test.d.ts.map

package/dist/src/delivery/block-streaming-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-streaming-config.test.d.ts","sourceRoot":"","sources":["../../../src/delivery/block-streaming-config.test.ts"],"names":[],"mappings":""}

package/dist/src/delivery/block-streaming-config.test.js

@@ -0,0 +1,91 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { IM_BLOCK_STREAMING_COALESCE_DEFAULT, getXgImConfig, isDeliverAssistantItemsEnabled, isDeliverPartialSnapshotEnabled, isDeliverSegmentBufferEnabled, isInboundBlockStreamingEnabled, resolveBlockStreamingReplyOptions, resolveDispatchOpenClawCfg, XgImConfigSchema, } from "../plugin/channel-config.js";
+function cfg(overrides = {}) {
+    return { baseUrl: "https://example.com", ...overrides };
+}
+const baseOpenClawCfg = {
+    agents: {
+        defaults: {
+            blockStreamingCoalesce: { minChars: 2400, maxChars: 12000, idleMs: 3000 },
+        },
+    },
+    channels: { xg_cwork_im: { baseUrl: "https://example.com" } },
+};
+describe("block streaming config", () => {
+    it("enabled by default when blockStreaming unset", () => {
+        assert.equal(isInboundBlockStreamingEnabled(cfg()), true);
+        assert.deepEqual(resolveBlockStreamingReplyOptions(cfg()), { disableBlockStreaming: false });
+    });
+    it("disabled when blockStreaming is false", () => {
+        assert.equal(isInboundBlockStreamingEnabled(cfg({ blockStreaming: false })), false);
+        assert.deepEqual(resolveBlockStreamingReplyOptions(cfg({ blockStreaming: false })), {
+            disableBlockStreaming: true,
+        });
+    });
+    it("explicit true forces enable", () => {
+        assert.equal(isInboundBlockStreamingEnabled(cfg({ blockStreaming: true })), true);
+    });
+    it("resolveDispatchOpenClawCfg injects IM coalesce when channel omits it", () => {
+        const patched = resolveDispatchOpenClawCfg(baseOpenClawCfg, cfg());
+        const xg = patched
+            .channels?.xg_cwork_im;
+        assert.deepEqual(xg?.blockStreamingCoalesce, { ...IM_BLOCK_STREAMING_COALESCE_DEFAULT });
+    });
+    it("resolveDispatchOpenClawCfg leaves cfg when channel coalesce set", () => {
+        const custom = { minChars: 100, idleMs: 50 };
+        const patched = resolveDispatchOpenClawCfg(baseOpenClawCfg, cfg({ blockStreamingCoalesce: custom }));
+        assert.equal(patched, baseOpenClawCfg);
+    });
+    it("deliverSegmentBuffer enabled by default when unset", () => {
+        assert.equal(isDeliverSegmentBufferEnabled(cfg()), true);
+    });
+    it("deliverSegmentBuffer disabled when false", () => {
+        assert.equal(isDeliverSegmentBufferEnabled(cfg({ deliverSegmentBuffer: false })), false);
+    });
+    it("deliverPartialSnapshot enabled by default when unset", () => {
+        assert.equal(isDeliverPartialSnapshotEnabled(cfg()), true);
+    });
+    it("deliverPartialSnapshot disabled when false", () => {
+        assert.equal(isDeliverPartialSnapshotEnabled(cfg({ deliverPartialSnapshot: false })), false);
+    });
+    it("deliverAssistantItems enabled by default when unset", () => {
+        assert.equal(isDeliverAssistantItemsEnabled(cfg()), true);
+    });
+    it("deliverAssistantItems disabled when false", () => {
+        assert.equal(isDeliverAssistantItemsEnabled(cfg({ deliverAssistantItems: false })), false);
+    });
+});
+describe("account enabled config", () => {
+    const configWithAccounts = (enabled, accountEnabled) => ({
+        channels: {
+            xg_cwork_im: {
+                baseUrl: "https://example.com",
+                ...(enabled === undefined ? {} : { enabled }),
+                accounts: {
+                    assistant: {
+                        robotKey: "robot-key",
+                        ...(accountEnabled === undefined ? {} : { enabled: accountEnabled }),
+                    },
+                },
+            },
+        },
+    });
+    it("preserves an account-level disabled switch", () => {
+        assert.equal(getXgImConfig(configWithAccounts(true, false), "assistant").enabled, false);
+    });
+    it("keeps account-level enabled when the schema parses the configuration", () => {
+        const parsed = XgImConfigSchema.parse({
+            baseUrl: "https://example.com",
+            accounts: { assistant: { robotKey: "robot-key", enabled: false } },
+        });
+        assert.equal(parsed.accounts?.assistant?.enabled, false);
+    });
+    it("inherits an enabled top-level switch when the account omits it", () => {
+        assert.equal(getXgImConfig(configWithAccounts(true, undefined), "assistant").enabled, true);
+    });
+    it("keeps the top-level disabled switch authoritative", () => {
+        assert.equal(getXgImConfig(configWithAccounts(false, true), "assistant").enabled, false);
+    });
+});
+//# sourceMappingURL=block-streaming-config.test.js.map

package/dist/src/delivery/block-streaming-config.test.js.map

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

package/dist/src/delivery/deliver-text.d.ts

@@ -0,0 +1,30 @@
+/**
+ * deliver 正文预处理：剥离 OpenClaw MEDIA 指令行、用量 footer、同轮重复纯文本抑制。
+ */
+/** 从用户可见正文中移除 `MEDIA:<path>` 独立行（OpenClaw 媒体指令不应出现在 IM 正文里）。 */
+export declare function stripMediaDirectiveLines(text: string): string;
+/** 移除模型用量 footer / Usage 行（仅用于同轮去重比较，不用于改写发给 IM 的正文）。 */
+export declare function stripModelUsageFooter(text: string): string;
+/**
+ * 用于同轮去重的正文归一化：剥 MEDIA / footer，折叠空白与空行差异。
+ * footer 在发给用户时保留；去重时忽略 footer 差异。
+ */
+export declare function normalizeDeliverComparableText(text: string): string;
+/** 同轮内：若本条与上一条已发正文相同且本条无媒体，则视为重复 deliver，应跳过。 */
+export declare function shouldSuppressDuplicateTextDeliver(args: {
+    textPart: string;
+    hasMedia: boolean;
+    lastDeliveredText: string;
+    lastDeliveredHadMedia: boolean;
+}): boolean;
+/**
+ * 带附件 deliver：若 caption 与同轮已发纯文归一化后相同，则只发文件、省略重复 caption。
+ * 典型：先 HTTP 纯文 (#3)，再文+附件 (#4) → 用户只应看到「说明 + 文件」，而非说明两次。
+ */
+export declare function shouldOmitDuplicateFileCaption(args: {
+    textPart: string;
+    hasMedia: boolean;
+    lastDeliveredText: string;
+    lastDeliveredHadMedia: boolean;
+}): boolean;
+//# sourceMappingURL=deliver-text.d.ts.map

package/dist/src/delivery/deliver-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-text.d.ts","sourceRoot":"","sources":["../../../src/delivery/deliver-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6BH,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7D;AASD,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,iDAAiD;AACjD,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAQV;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAQV"}

package/dist/src/delivery/deliver-text.js

@@ -0,0 +1,88 @@
+/**
+ * deliver 正文预处理：剥离 OpenClaw MEDIA 指令行、用量 footer、同轮重复纯文本抑制。
+ */
+const MEDIA_LINE_RE = /^\s*MEDIA:\s*.+/i;
+/**
+ * 通用用量 footer 行（emoji 中文 and/or 英文格式）。
+ *
+ * 匹配模式：
+ *   `🟢 ↑111k ↓164 · 63%ctx · openai/gpt-5.5`
+ *   `_🟢 输入1.2k 输出226 · 上下文23% · openai/gpt-5.6-sol_`
+ *   `Usage: 111k in / 164 out · est $0.01`
+ */
+const USAGE_FOOTER_LINE_RE = /^\s*_?\s*[🟢🟡🔴]?\s*(?:↑|输入)\s*[\d.]+[kmKM]?\s*(?:↓|输出)\s*[\d.]+[kmKM]?\s*·\s*(?:上下文[\d.]+%|ctx[\d.]+%|[\d.]+%)?.+$/u;
+/** `tokens` 模式：`Usage: 111k in / 164 out · est $0.01` */
+const USAGE_LINE_RE = /^\s*Usage:\s*.+\bin\s*\/\s*.+\bout\b/iu;
+/** OpenClaw 2026.6.9+ `/usage full` 内置 bar（含 `↕️ 1.2k/89`） */
+const USAGE_BAR_LINE_RE = /↕️\s*[\d.?]+[kmKM]?/u;
+function isUsageFooterLine(line) {
+    return (USAGE_FOOTER_LINE_RE.test(line) ||
+        USAGE_LINE_RE.test(line) ||
+        USAGE_BAR_LINE_RE.test(line));
+}
+/** 从用户可见正文中移除 `MEDIA:<path>` 独立行（OpenClaw 媒体指令不应出现在 IM 正文里）。 */
+export function stripMediaDirectiveLines(text) {
+    const lines = text.split(/\r?\n/);
+    const kept = lines.filter((line) => !MEDIA_LINE_RE.test(line));
+    return kept
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+/**
+ * 内联用量 footer（同一行内被其他内容包围时匹配，如 markdown 表格行）。
+ * `_🟢 输入1.2k 输出226 · 上下文23% · openai/gpt-5.6-sol_`
+ */
+const USAGE_FOOTER_INLINE_RE = /_?[🟢🟡🔴]?\s*(?:↑|输入)\s*[\d.]+[kmKM]?\s*(?:↓|输出)\s*[\d.]+[kmKM]?\s*·\s*(?:上下文[\d.]+%|ctx[\d.]+%|[\d.]+%)?\s*·\s*.+?_?\s*/gu;
+/** 移除模型用量 footer / Usage 行（仅用于同轮去重比较，不用于改写发给 IM 的正文）。 */
+export function stripModelUsageFooter(text) {
+    const lines = text.split(/\r?\n/);
+    const kept = lines.filter((line) => !isUsageFooterLine(line));
+    return kept.join("\n").replace(USAGE_FOOTER_INLINE_RE, "").trim();
+}
+/**
+ * 用于同轮去重的正文归一化：剥 MEDIA / footer，折叠空白与空行差异。
+ * footer 在发给用户时保留；去重时忽略 footer 差异。
+ */
+export function normalizeDeliverComparableText(text) {
+    let t = stripModelUsageFooter(stripMediaDirectiveLines(text));
+    t = t.replace(/\r\n/g, "\n");
+    t = t
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+/g, " ").trim())
+        .filter((line) => line.length > 0 && !/^-{3,}$/.test(line))
+        .join("\n");
+    return t.trim();
+}
+/** 同轮内：若本条与上一条已发正文相同且本条无媒体，则视为重复 deliver，应跳过。 */
+export function shouldSuppressDuplicateTextDeliver(args) {
+    if (args.hasMedia)
+        return false;
+    const text = normalizeDeliverComparableText(args.textPart);
+    if (!text)
+        return false;
+    if (!args.lastDeliveredText)
+        return false;
+    const last = normalizeDeliverComparableText(args.lastDeliveredText);
+    if (text !== last)
+        return false;
+    return args.lastDeliveredHadMedia || text.length > 0;
+}
+/**
+ * 带附件 deliver：若 caption 与同轮已发纯文归一化后相同，则只发文件、省略重复 caption。
+ * 典型：先 HTTP 纯文 (#3)，再文+附件 (#4) → 用户只应看到「说明 + 文件」，而非说明两次。
+ */
+export function shouldOmitDuplicateFileCaption(args) {
+    if (!args.hasMedia)
+        return false;
+    const caption = normalizeDeliverComparableText(args.textPart);
+    if (caption.length < 16)
+        return false;
+    if (!args.lastDeliveredText)
+        return false;
+    const last = normalizeDeliverComparableText(args.lastDeliveredText);
+    if (!last)
+        return false;
+    return caption === last;
+}
+//# sourceMappingURL=deliver-text.js.map

package/dist/src/delivery/deliver-text.js.map

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

package/dist/src/delivery/deliver-text.test.d.ts

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

package/dist/src/delivery/deliver-text.test.d.ts.map

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

package/dist/src/delivery/deliver-text.test.js

@@ -0,0 +1,117 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { normalizeDeliverComparableText, shouldOmitDuplicateFileCaption, shouldSuppressDuplicateTextDeliver, stripMediaDirectiveLines, stripModelUsageFooter, } from "./deliver-text.js";
+// 生产 incident 回归：侯桐 2026-07-10 终态三连发（空行/footer 微差）
+const HOUTONG_BODY_LOOSE = `确实是这个问题：昨天那版虽然用了内嵌 SVG，但你现在的文档预览器没有把 SVG 正常渲染出来，所以流程看不到。
+
+我已经重新生成了一版**纯 Markdown 可读版**：
+
+- 不用 SVG
+- 不用 Mermaid
+- 不用图片
+- 全部用 Markdown 表格 + 文本流程图 + 状态表表达
+
+这样在 IM 文件预览里也能直接看懂完整流程。
+
+新文件：
+
+-----`;
+const HOUTONG_BODY_TIGHT = `确实是这个问题：昨天那版虽然用了内嵌 SVG，但你现在的文档预览器没有把 SVG 正常渲染出来，所以流程看不到。
+我已经重新生成了一版**纯 Markdown 可读版**：
+- 不用 SVG
+- 不用 Mermaid
+- 不用图片
+- 全部用 Markdown 表格 + 文本流程图 + 状态表表达
+这样在 IM 文件预览里也能直接看懂完整流程。
+新文件：`;
+const HOUTONG_BODY_WITH_FOOTER = `${HOUTONG_BODY_TIGHT}
+
+_🟡 ↑111k ↓164 · 63%ctx · openai/gpt-5.5_`;
+describe("stripMediaDirectiveLines", () => {
+    it("removes MEDIA directive lines", () => {
+        const input = "文件在这里\nMEDIA:./xg-cwork-im/report.md\n";
+        assert.equal(stripMediaDirectiveLines(input), "文件在这里");
+    });
+    it("keeps usage footer in user-visible text (footer only stripped for dedup)", () => {
+        const withFooter = "正文\n\n_🟡 ↑111k ↓164 · 63%ctx · openai/gpt-5.5_";
+        assert.equal(stripMediaDirectiveLines(withFooter), withFooter);
+    });
+});
+describe("stripModelUsageFooter", () => {
+    it("removes emoji usage footer line", () => {
+        assert.equal(stripModelUsageFooter("正文\n\n_🟡 ↑111k ↓164 · 63%ctx · openai/gpt-5.5_"), "正文");
+    });
+    it("removes OpenClaw Usage: in/out line for comparable text", () => {
+        assert.equal(stripModelUsageFooter("正文\nUsage: 1.2k in / 89 out · est $0.01"), "正文");
+    });
+    it("removes OpenClaw 2026.6.9 full usage bar for comparable text", () => {
+        assert.equal(stripModelUsageFooter("正文\nopenai🤖 gpt5.5 | 📚 [⣿⣿⣿]272k ↕️ 1.2k/89 💰0.01"), "正文");
+    });
+});
+describe("normalizeDeliverComparableText", () => {
+    it("treats loose vs tight newlines as same (Houtong case)", () => {
+        assert.equal(normalizeDeliverComparableText(HOUTONG_BODY_LOOSE), normalizeDeliverComparableText(HOUTONG_BODY_TIGHT));
+    });
+    it("ignores emoji usage footer when comparing", () => {
+        assert.equal(normalizeDeliverComparableText(HOUTONG_BODY_TIGHT), normalizeDeliverComparableText(HOUTONG_BODY_WITH_FOOTER));
+    });
+    it("ignores Usage: line when comparing", () => {
+        assert.equal(normalizeDeliverComparableText("最终答复"), normalizeDeliverComparableText("最终答复\nUsage: 111k in / 164 out"));
+    });
+    it("ignores full usage bar when comparing", () => {
+        assert.equal(normalizeDeliverComparableText("最终答复"), normalizeDeliverComparableText("最终答复\nopenai🤖 gpt5.5 ↕️ 111k/164"));
+    });
+});
+describe("shouldSuppressDuplicateTextDeliver", () => {
+    it("suppresses duplicate text after file caption", () => {
+        assert.equal(shouldSuppressDuplicateTextDeliver({
+            textPart: "文件在这里",
+            hasMedia: false,
+            lastDeliveredText: "文件在这里",
+            lastDeliveredHadMedia: true,
+        }), true);
+    });
+    it("does not suppress when media present", () => {
+        assert.equal(shouldSuppressDuplicateTextDeliver({
+            textPart: "文件在这里",
+            hasMedia: true,
+            lastDeliveredText: "文件在这里",
+            lastDeliveredHadMedia: true,
+        }), false);
+    });
+    it("suppresses third pure-text burst after text+file (Houtong #5)", () => {
+        assert.equal(shouldSuppressDuplicateTextDeliver({
+            textPart: HOUTONG_BODY_TIGHT,
+            hasMedia: false,
+            lastDeliveredText: HOUTONG_BODY_WITH_FOOTER,
+            lastDeliveredHadMedia: true,
+        }), true);
+    });
+    it("does not suppress distinct tool-before progress", () => {
+        assert.equal(shouldSuppressDuplicateTextDeliver({
+            textPart: "我先读一下原文档",
+            hasMedia: false,
+            lastDeliveredText: HOUTONG_BODY_TIGHT,
+            lastDeliveredHadMedia: false,
+        }), false);
+    });
+});
+describe("shouldOmitDuplicateFileCaption", () => {
+    it("omits caption when same text was just sent as RICH_TEXT (#4 after #3)", () => {
+        assert.equal(shouldOmitDuplicateFileCaption({
+            textPart: HOUTONG_BODY_WITH_FOOTER,
+            hasMedia: true,
+            lastDeliveredText: HOUTONG_BODY_LOOSE,
+            lastDeliveredHadMedia: false,
+        }), true);
+    });
+    it("keeps caption when preceding text differed", () => {
+        assert.equal(shouldOmitDuplicateFileCaption({
+            textPart: HOUTONG_BODY_TIGHT,
+            hasMedia: true,
+            lastDeliveredText: "现在生成一个纯 Markdown 版本",
+            lastDeliveredHadMedia: false,
+        }), false);
+    });
+});
+//# sourceMappingURL=deliver-text.test.js.map

package/dist/src/delivery/deliver-text.test.js.map

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

package/dist/src/delivery/im-tool-progress.d.ts

@@ -0,0 +1,4 @@
+export declare function friendlyToolLabel(raw: string): string;
+export declare function extractToolResultText(result: unknown): string | undefined;
+export declare function buildToolStartSummary(toolRaw: string, args?: Record<string, unknown>): string | undefined;
+//# sourceMappingURL=im-tool-progress.d.ts.map

package/dist/src/delivery/im-tool-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-tool-progress.d.ts","sourceRoot":"","sources":["../../../src/delivery/im-tool-progress.ts"],"names":[],"mappings":"AAaA,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrD;AAiBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAazE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAiCzG"}

package/dist/src/delivery/im-tool-progress.js

@@ -0,0 +1,87 @@
+const TOOL_LABEL_ZH = {
+    exec: "命令执行",
+    read: "读取文件",
+    read_file: "读取文件",
+    write: "写入文件",
+    grep: "内容搜索",
+    glob_file_search: "文件搜索",
+    memory_search: "记忆检索",
+    sessions_list: "会话列表",
+    sessions_history: "会话历史",
+    xg_cwork_im_get_group_chat_history: "群聊历史",
+};
+export function friendlyToolLabel(raw) {
+    const k = raw.trim();
+    if (!k)
+        return "工具";
+    return TOOL_LABEL_ZH[k] ?? k;
+}
+function clipWsProgressSummary(text, max = 200) {
+    const t = text.trim().replace(/\r\n/g, "\n").replace(/\n+/g, " ");
+    if (!t)
+        return "";
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, Math.max(0, max - 1))}…`;
+}
+function firstStringField(args, keys) {
+    for (const k of keys) {
+        const v = args[k];
+        if (typeof v === "string" && v.trim().length > 0)
+            return v.trim();
+    }
+    return undefined;
+}
+export function extractToolResultText(result) {
+    if (!result || typeof result !== "object")
+        return undefined;
+    const r = result;
+    const content = r.content;
+    if (!Array.isArray(content))
+        return undefined;
+    const texts = [];
+    for (const item of content) {
+        if (typeof item === "object" && item !== null && item.type === "text") {
+            const text = item.text;
+            if (typeof text === "string" && text.trim())
+                texts.push(text.trim());
+        }
+    }
+    return texts.length > 0 ? texts.join("\n") : undefined;
+}
+export function buildToolStartSummary(toolRaw, args) {
+    if (!args || typeof args !== "object")
+        return undefined;
+    if (toolRaw === "exec") {
+        const cmd = typeof args.command === "string" ? args.command.replace(/\s+/g, " ").trim() : "";
+        const wdRaw = typeof args.workdir === "string" ? args.workdir.trim() : "";
+        const wd = wdRaw ? wdRaw.replace(/\\/g, "/") : "";
+        if (!cmd && !wd)
+            return undefined;
+        const head = cmd ? `run ${cmd}` : "run";
+        const line = wd ? `${head} (in ${wd})` : head;
+        return clipWsProgressSummary(line);
+    }
+    if (toolRaw === "read" || toolRaw === "read_file") {
+        const path = firstStringField(args, ["target_file", "path", "file_path"]);
+        if (path)
+            return clipWsProgressSummary(path.replace(/\\/g, "/"));
+    }
+    if (toolRaw.includes("get_group_chat_history")) {
+        const gid = firstStringField(args, ["groupId", "group_id"]);
+        const lim = typeof args.limit === "number" ? args.limit : undefined;
+        const bits = [];
+        if (gid)
+            bits.push(`group=${gid}`);
+        if (lim != null)
+            bits.push(`limit=${lim}`);
+        if (bits.length > 0)
+            return clipWsProgressSummary(bits.join(", "));
+    }
+    const hint = firstStringField(args, ["query", "prompt", "url", "command"]) ??
+        (typeof args.tool === "string" ? args.tool : undefined);
+    if (hint && toolRaw !== "exec")
+        return clipWsProgressSummary(hint.replace(/\\/g, "/"));
+    return undefined;
+}
+//# sourceMappingURL=im-tool-progress.js.map

package/dist/src/delivery/im-tool-progress.js.map

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

package/dist/src/delivery/inbound-terminal-delivery.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 入站 IM 消息终态投递：幂等、结构化日志、HTTP 兜底发送。
+ */
+import type { Logger } from "../plugin/channel-log.js";
+import { type InboundTrigger, type NoReplyCause, type TerminalState } from "./inbound-terminal-state.js";
+import type { FirstReplyTimeoutCause } from "./user-facing-errors.js";
+import type { SendMessageReply } from "../plugin/types.js";
+export type TerminalSendFn = (text: string) => Promise<void>;
+export declare class InboundTerminalController {
+    private readonly messageId;
+    private readonly groupId;
+    private readonly sessionKey;
+    private readonly trigger;
+    private readonly log;
+    private readonly logPrefix;
+    private runId;
+    private hasBusinessReply;
+    private timeoutFired;
+    private compactionShown;
+    private compactionIncomplete;
+    private runtimeErrorHint;
+    private normalizerSilentSkip;
+    private normalizerHeartbeatSkip;
+    private normalizerSkipReasons;
+    private localTerminalSent;
+    private lastResolvedState;
+    constructor(args: {
+        messageId: string;
+        groupId: string;
+        sessionKey: string;
+        trigger?: InboundTrigger;
+        log: Logger;
+        logPrefix: string;
+    });
+    setRunId(runId: string): void;
+    markBusinessReplySent(): void;
+    markTimeoutFired(): void;
+    /** OpenClaw reply normalizer 跳过 payload 时记录（onSkip reason）。 */
+    noteNormalizerSkip(reason: string): void;
+    noteCompactionNotice(text: string): void;
+    noteCompactionWsEvent(phase: "start" | "end"): void;
+    noteRuntimeErrorFromPayload(text: string): void;
+    noteRuntimeError(err: unknown): void;
+    /**
+     * 尝试发送终态 HTTP。返回是否已向 IM 发送（含此前已发送的幂等命中）。
+     * no_reply / timeout 等由 shouldSendTerminalHttpForState 拦截；文案为空亦不发。
+     */
+    trySendTerminal(state: TerminalState, sendFn: TerminalSendFn, extra?: {
+        errorMessage?: string;
+        noReplyCause?: NoReplyCause;
+        deliverInvokeCount?: number;
+        deliverCallCount?: number;
+        timeoutCause?: FirstReplyTimeoutCause;
+    }): Promise<boolean>;
+    finalizeAndDeliver(args: {
+        sendFn: TerminalSendFn;
+        dispatchThrew: boolean;
+        dispatchError?: unknown;
+        lastDeliverError?: unknown;
+        beforeAgentRunBlocked?: boolean;
+        deliverInvokeCount: number;
+        deliverCallCount: number;
+    }): Promise<TerminalState>;
+    getLastResolvedState(): TerminalState | undefined;
+    getRunId(): string | undefined;
+    didTimeoutFire(): boolean;
+    wasTerminalDelivered(): boolean;
+    private logTerminal;
+}
+export declare function buildTerminalSendFn(args: {
+    sendText: (text: string, replyMeta?: SendMessageReply) => Promise<void>;
+    replyMeta?: SendMessageReply;
+    isSingleChat: boolean;
+}): TerminalSendFn;
+/** cron / 工具主动推送前缀，避免与用户消息回复混淆。 */
+export declare function prefixProactiveOutboundText(text: string, trigger?: "cron" | "tool"): string;
+//# sourceMappingURL=inbound-terminal-delivery.d.ts.map

package/dist/src/delivery/inbound-terminal-delivery.d.ts.map

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