@xgjktech/xg_cwork_im 1.19.26 → 1.19.27

package/dist/src/inbound-terminal-state.test.js

@@ -0,0 +1,224 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { classifyRuntimeErrorMessage, hasGlobalTerminalSent, markGlobalTerminalSent, resetGlobalTerminalSentForTests, resolveNoReplyCause, resolveTerminalState, shouldSendTerminalHttpForState, } from "./inbound-terminal-state.js";
+import { InboundTerminalController, prefixProactiveOutboundText } from "./inbound-terminal-delivery.js";
+describe("classifyRuntimeErrorMessage", () => {
+    it("detects precheck overflow", () => {
+        const hint = classifyRuntimeErrorMessage("Context overflow: prompt too large for the model (precheck)");
+        assert.equal(hint.errorType, "precheck_error");
+    });
+    it("detects context-overflow-precheck style", () => {
+        const hint = classifyRuntimeErrorMessage("[context-overflow-precheck] overflowTokens=72970");
+        assert.equal(hint.errorType, "precheck_error");
+    });
+    it("detects timeout", () => {
+        const hint = classifyRuntimeErrorMessage("Request timed out.");
+        assert.equal(hint.errorType, "timeout");
+    });
+    it("detects no_reply", () => {
+        const hint = classifyRuntimeErrorMessage("NO_REPLY");
+        assert.equal(hint.errorType, "no_reply");
+    });
+});
+describe("resolveTerminalState", () => {
+    it("returns success when business reply sent", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: true,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 1,
+        }), "success");
+    });
+    it("returns precheck_error from runtime hint", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 0,
+            runtimeErrorHint: {
+                errorType: "precheck_error",
+                errorMessage: "Context overflow: prompt too large for the model (precheck)",
+            },
+        }), "precheck_error");
+    });
+    it("returns compaction_failed when compaction shown without reply", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: true,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        }), "compaction_failed");
+    });
+    it("returns no_reply when deliver invoked but all plugin-skipped", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 3,
+            deliverCallCount: 0,
+        }), "no_reply");
+    });
+    it("returns no_reply for silent turn without deliver", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        }), "no_reply");
+    });
+    it("returns timeout when watchdog fired", () => {
+        assert.equal(resolveTerminalState({
+            hasBusinessReply: false,
+            timeoutFired: true,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        }), "timeout");
+    });
+});
+describe("shouldSendTerminalHttpForState", () => {
+    it("never sends HTTP for no_reply or timeout", () => {
+        assert.equal(shouldSendTerminalHttpForState("no_reply", { normalizerSilentSkip: false }), false);
+        assert.equal(shouldSendTerminalHttpForState("no_reply", { normalizerSilentSkip: true }), false);
+        assert.equal(shouldSendTerminalHttpForState("timeout", {}), false);
+        assert.equal(shouldSendTerminalHttpForState("compaction_failed", {}), false);
+    });
+    it("allows delivery_failed and confirmed error states", () => {
+        assert.equal(shouldSendTerminalHttpForState("delivery_failed", {}), true);
+        assert.equal(shouldSendTerminalHttpForState("precheck_error", {}), true);
+        assert.equal(shouldSendTerminalHttpForState("runtime_error", {}), true);
+    });
+});
+describe("resolveNoReplyCause", () => {
+    it("classifies intentional silent", () => {
+        assert.equal(resolveNoReplyCause({
+            hasBusinessReply: false,
+            timeoutFired: false,
+            dispatchThrew: false,
+            compactionShown: false,
+            compactionIncomplete: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+            normalizerSilentSkip: true,
+        }), "intentional_silent");
+    });
+});
+describe("InboundTerminalController idempotency", () => {
+    const noopLog = {
+        info: () => { },
+        warn: () => { },
+        error: () => { },
+    };
+    beforeEach(() => {
+        resetGlobalTerminalSentForTests();
+    });
+    it("sends terminal only once per message_id", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-1001",
+            groupId: "g1",
+            sessionKey: "sk1",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        let sendCount = 0;
+        const sendFn = async () => {
+            sendCount++;
+        };
+        const first = await controller.trySendTerminal("precheck_error", sendFn, {
+            errorMessage: "Context overflow: prompt too large for the model (precheck)",
+        });
+        const second = await controller.trySendTerminal("precheck_error", sendFn, {
+            errorMessage: "Context overflow: prompt too large for the model (precheck)",
+        });
+        assert.equal(first, true);
+        assert.equal(second, false);
+        assert.equal(sendCount, 1);
+        assert.equal(hasGlobalTerminalSent("msg-1001"), true);
+    });
+    it("finalize delivers precheck when error payload was noted", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-2002",
+            groupId: "g2",
+            sessionKey: "sk2",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        controller.noteRuntimeErrorFromPayload("Context overflow: prompt too large for the model (precheck)");
+        let sent = "";
+        const state = await controller.finalizeAndDeliver({
+            sendFn: async (text) => {
+                sent = text;
+            },
+            dispatchThrew: false,
+            deliverInvokeCount: 1,
+            deliverCallCount: 0,
+        });
+        assert.equal(state, "precheck_error");
+        assert.ok(sent.includes("上下文过大"));
+        markGlobalTerminalSent("msg-2002", "precheck_error");
+    });
+    it("does not send HTTP for zero_deliver no_reply", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-4004",
+            groupId: "g4",
+            sessionKey: "sk4",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        let sendCount = 0;
+        const state = await controller.finalizeAndDeliver({
+            sendFn: async () => {
+                sendCount++;
+            },
+            dispatchThrew: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        });
+        assert.equal(state, "no_reply");
+        assert.equal(sendCount, 0);
+    });
+    it("does not send HTTP for intentional NO_REPLY silent skip", async () => {
+        const controller = new InboundTerminalController({
+            messageId: "msg-3003",
+            groupId: "g3",
+            sessionKey: "sk3",
+            log: noopLog,
+            logPrefix: "[test]",
+        });
+        controller.noteNormalizerSkip("silent");
+        let sendCount = 0;
+        const state = await controller.finalizeAndDeliver({
+            sendFn: async () => {
+                sendCount++;
+            },
+            dispatchThrew: false,
+            deliverInvokeCount: 0,
+            deliverCallCount: 0,
+        });
+        assert.equal(state, "no_reply");
+        assert.equal(sendCount, 0);
+    });
+});
+describe("prefixProactiveOutboundText", () => {
+    it("prefixes cron messages once", () => {
+        assert.equal(prefixProactiveOutboundText("今日无新增"), "[定时任务] 今日无新增");
+        assert.equal(prefixProactiveOutboundText("[定时任务] 已有"), "[定时任务] 已有");
+    });
+});
+//# sourceMappingURL=inbound-terminal-state.test.js.map

package/dist/src/inbound-terminal-state.test.js.map

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

package/dist/src/interrupt-round.d.ts

@@ -0,0 +1,9 @@
+import { type ActiveRound } from "./active-round-registry.js";
+import { type InterruptedSubagent } from "./subagent-monitor.js";
+export interface PreparedRoundInterrupt {
+    round: ActiveRound;
+    subagents: InterruptedSubagent[];
+}
+export declare function prepareRoundInterrupt(accountId: string, groupId: string): PreparedRoundInterrupt | undefined;
+export declare function finalizeRoundInterrupt(prepared: PreparedRoundInterrupt): Promise<void>;
+//# sourceMappingURL=interrupt-round.d.ts.map

package/dist/src/interrupt-round.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-round.d.ts","sourceRoot":"","sources":["../../src/interrupt-round.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,WAAW,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAChB,sBAAsB,GAAG,SAAS,CAQpC;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5F"}

package/dist/src/interrupt-round.js

@@ -0,0 +1,44 @@
+import { completeActiveRound, prepareActiveRoundInterrupt, } from "./active-round-registry.js";
+import { prepareSubagentInterrupt } from "./subagent-monitor.js";
+import { clearSessionImContext } from "./session-im-context.js";
+export function prepareRoundInterrupt(accountId, groupId) {
+    const round = prepareActiveRoundInterrupt(accountId, groupId);
+    if (!round)
+        return undefined;
+    clearSessionImContext(round.sessionKey, round.replyToMsgId);
+    return {
+        round,
+        subagents: prepareSubagentInterrupt(round.roundKey, round.generation),
+    };
+}
+export async function finalizeRoundInterrupt(prepared) {
+    const { round, subagents } = prepared;
+    try {
+        if (subagents.length > 0) {
+            try {
+                await round.streamClient.sendEvent({
+                    groupId: round.groupId,
+                    replyToMsgId: round.replyToMsgId,
+                    event: "SUBAGENT_STAT",
+                    data: { subagentList: subagents },
+                });
+            }
+            catch (err) {
+                console.error(`[xg_cwork_im] [stop] suspended SUBAGENT_STAT failed: ${String(err)}`);
+            }
+        }
+        try {
+            await round.streamClient.end("aborted", {
+                groupId: round.groupId,
+                replyToMsgId: round.replyToMsgId,
+            });
+        }
+        catch (err) {
+            console.error(`[xg_cwork_im] [stop] FINISHED(aborted) failed: ${String(err)}`);
+        }
+    }
+    finally {
+        completeActiveRound(round.roundKey, round.generation);
+    }
+}
+//# sourceMappingURL=interrupt-round.js.map

package/dist/src/interrupt-round.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt-round.js","sourceRoot":"","sources":["../../src/interrupt-round.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,2BAA2B,GAE9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAA4B,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAOhE,MAAM,UAAU,qBAAqB,CACjC,SAAiB,EACjB,OAAe;IAEf,MAAM,KAAK,GAAG,2BAA2B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,qBAAqB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACH,KAAK;QACL,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;KACxE,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgC;IACzE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IACtC,IAAI,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC;oBAC/B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,KAAK,EAAE,eAAe;oBACtB,IAAI,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE;iBACpC,CAAC,CAAC;YACP,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,wDAAwD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzF,CAAC;QACL,CAAC;QACD,IAAI,CAAC;YACD,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE;gBACpC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;aACnC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,kDAAkD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;IACL,CAAC;YAAS,CAAC;QACP,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;AACL,CAAC"}

package/dist/src/interrupt-round.test.d.ts

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

package/dist/src/interrupt-round.test.d.ts.map

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

package/dist/src/interrupt-round.test.js

@@ -0,0 +1,133 @@
+import assert from "node:assert/strict";
+import { afterEach, describe, it } from "node:test";
+import { __resetActiveRoundRegistryForTests, prepareActiveRoundInterrupt, registerActiveRound, } from "./active-round-registry.js";
+import { finalizeRoundInterrupt, prepareRoundInterrupt } from "./interrupt-round.js";
+import { __resetSubagentMonitorForTests, markSubagentCompleted, startMonitor, } from "./subagent-monitor.js";
+import { getSessionImContext, setSessionImContext } from "./session-im-context.js";
+afterEach(() => {
+    __resetSubagentMonitorForTests();
+    __resetActiveRoundRegistryForTests();
+});
+function createClient(events, failSuspended = false) {
+    return {
+        start: async () => undefined,
+        streamProgress: async () => undefined,
+        streamUsage: async () => undefined,
+        sendEvent: async (event) => {
+            events.push(`${event.event}:${String(event.data.subagentList[0]?.status)}`);
+            if (failSuspended)
+                throw new Error("send failed");
+        },
+        end: async (reason) => {
+            events.push(`FINISHED:${reason}`);
+        },
+    };
+}
+describe("round interrupt", () => {
+    it("先发送 suspended，再发送 FINISHED(aborted)，并阻止旧 monitor 复活", async () => {
+        const events = [];
+        const round = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: createClient(events),
+        });
+        assert.equal(startMonitor({
+            roundKey: round.roundKey,
+            generation: round.generation,
+            groupId: round.groupId,
+            agentId: round.agentId,
+            streamClient: round.streamClient,
+            replyToMsgId: round.replyToMsgId,
+            spawn: { childSessionKey: "child-1", runId: "run-1", label: "子任务" },
+        }), true);
+        events.length = 0;
+        setSessionImContext(round.sessionKey, {
+            groupId: round.groupId,
+            replyToMsgId: round.replyToMsgId,
+            agentId: round.agentId,
+        });
+        const prepared = prepareRoundInterrupt("account-a", "group-1");
+        assert.ok(prepared);
+        assert.equal(getSessionImContext(round.sessionKey), undefined);
+        assert.equal(prepared.subagents[0]?.status, "suspended");
+        assert.equal(startMonitor({
+            roundKey: round.roundKey,
+            generation: round.generation,
+            groupId: round.groupId,
+            agentId: round.agentId,
+            streamClient: round.streamClient,
+            replyToMsgId: round.replyToMsgId,
+            spawn: { childSessionKey: "child-late", runId: "run-late" },
+        }), false);
+        markSubagentCompleted("child-1", "run-1");
+        await finalizeRoundInterrupt(prepared);
+        assert.deepEqual(events, ["SUBAGENT_STAT:suspended", "FINISHED:aborted"]);
+        assert.equal(prepareActiveRoundInterrupt("account-a", "group-1"), undefined);
+    });
+    it("suspended 发送失败时仍尝试 aborted 并清理活动轮次", async () => {
+        const events = [];
+        const round = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: createClient(events, true),
+        });
+        startMonitor({
+            roundKey: round.roundKey,
+            generation: round.generation,
+            groupId: round.groupId,
+            agentId: round.agentId,
+            streamClient: round.streamClient,
+            replyToMsgId: round.replyToMsgId,
+            spawn: { childSessionKey: "child-1", runId: "run-1" },
+        });
+        events.length = 0;
+        const prepared = prepareRoundInterrupt("account-a", "group-1");
+        assert.ok(prepared);
+        await finalizeRoundInterrupt(prepared);
+        assert.deepEqual(events, ["SUBAGENT_STAT:suspended", "FINISHED:aborted"]);
+        assert.equal(prepareActiveRoundInterrupt("account-a", "group-1"), undefined);
+    });
+    it("停止混合子 Agent 时保留 completed，并只把 running 改为 suspended", async () => {
+        const events = [];
+        const client = createClient(events);
+        const round = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-1",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        const common = {
+            roundKey: round.roundKey,
+            generation: round.generation,
+            groupId: round.groupId,
+            agentId: round.agentId,
+            streamClient: client,
+            replyToMsgId: round.replyToMsgId,
+        };
+        startMonitor({
+            ...common,
+            spawn: { childSessionKey: "child-complete", runId: "run-complete" },
+        });
+        startMonitor({
+            ...common,
+            spawn: { childSessionKey: "child-running", runId: "run-running" },
+        });
+        markSubagentCompleted("child-complete", "run-complete");
+        await new Promise((resolve) => setImmediate(resolve));
+        const prepared = prepareRoundInterrupt("account-a", "group-1");
+        assert.ok(prepared);
+        assert.deepEqual(prepared.subagents.map(({ runId, status }) => ({ runId, status })), [
+            { runId: "run-complete", status: "completed" },
+            { runId: "run-running", status: "suspended" },
+        ]);
+    });
+});
+//# sourceMappingURL=interrupt-round.test.js.map

package/dist/src/interrupt-round.test.js.map

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

package/dist/src/item-event-guard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `onItemEvent` 条目过滤：已由专用回调覆盖的条目（工具、Reasoning）不再进入
+ * RUN_EVENT 兜底，避免把内部诊断标识 `unmapped:*` 展示给最终用户。
+ */
+export interface ItemEventPayload {
+    toolCallId?: string;
+    kind?: string;
+    title?: string;
+    name?: string;
+    phase?: string;
+    status?: string;
+}
+export type ItemEventGuardResult = {
+    suppress: true;
+    reason: "tool" | "reasoning";
+} | {
+    suppress: false;
+    kind: string;
+    title: string;
+};
+/**
+ * 判断 `onItemEvent` 条目是否应被抑制：
+ * - 工具类（`toolCallId` 或 `kind=tool`）已由 onToolStart/onToolResult 覆盖；
+ * - Reasoning 条目（`kind=analysis` 且 `title=reasoning`）已由
+ *   onReasoningStream/onReasoningEnd 覆盖，同一条目 start/end 各触发一次，禁止重复投递。
+ */
+export declare function resolveItemEventGuard(p: ItemEventPayload): ItemEventGuardResult;
+//# sourceMappingURL=item-event-guard.d.ts.map

package/dist/src/item-event-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-event-guard.d.ts","sourceRoot":"","sources":["../../src/item-event-guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,oBAAoB,GAC1B;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GAChD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,CAU/E"}

package/dist/src/item-event-guard.js

@@ -0,0 +1,22 @@
+/**
+ * `onItemEvent` 条目过滤：已由专用回调覆盖的条目（工具、Reasoning）不再进入
+ * RUN_EVENT 兜底，避免把内部诊断标识 `unmapped:*` 展示给最终用户。
+ */
+/**
+ * 判断 `onItemEvent` 条目是否应被抑制：
+ * - 工具类（`toolCallId` 或 `kind=tool`）已由 onToolStart/onToolResult 覆盖；
+ * - Reasoning 条目（`kind=analysis` 且 `title=reasoning`）已由
+ *   onReasoningStream/onReasoningEnd 覆盖，同一条目 start/end 各触发一次，禁止重复投递。
+ */
+export function resolveItemEventGuard(p) {
+    if (p.toolCallId || p.kind === "tool") {
+        return { suppress: true, reason: "tool" };
+    }
+    const kind = String(p.kind ?? "").trim().toLowerCase();
+    const title = String(p.title ?? "").trim().toLowerCase();
+    if (kind === "analysis" && title === "reasoning") {
+        return { suppress: true, reason: "reasoning" };
+    }
+    return { suppress: false, kind, title };
+}
+//# sourceMappingURL=item-event-guard.js.map

package/dist/src/item-event-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-event-guard.js","sourceRoot":"","sources":["../../src/item-event-guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAmB;IACrD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC"}

package/dist/src/item-event-guard.test.d.ts

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

package/dist/src/item-event-guard.test.d.ts.map

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

package/dist/src/item-event-guard.test.js

@@ -0,0 +1,55 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { resolveItemEventGuard } from "./item-event-guard.js";
+describe("item-event-guard", () => {
+    it("suppresses reasoning item start (phase=start)", () => {
+        const r = resolveItemEventGuard({
+            kind: "analysis",
+            title: "Reasoning",
+            phase: "start",
+            status: "running",
+        });
+        assert.equal(r.suppress, true);
+        assert.equal(r.reason, "reasoning");
+    });
+    it("suppresses reasoning item end (phase=end)", () => {
+        const r = resolveItemEventGuard({
+            kind: "analysis",
+            title: "Reasoning",
+            phase: "end",
+            status: "completed",
+        });
+        assert.equal(r.suppress, true);
+        assert.equal(r.reason, "reasoning");
+    });
+    it("suppresses tool-call items even when title is reasoning", () => {
+        const r = resolveItemEventGuard({
+            toolCallId: "call_123",
+            kind: "analysis",
+            title: "Reasoning",
+        });
+        assert.equal(r.suppress, true);
+        assert.equal(r.reason, "tool");
+    });
+    it("suppresses kind=tool items", () => {
+        const r = resolveItemEventGuard({ kind: "tool", title: "Web search" });
+        assert.equal(r.suppress, true);
+        assert.equal(r.reason, "tool");
+    });
+    it("matches reasoning case-insensitively with surrounding whitespace", () => {
+        const r = resolveItemEventGuard({ kind: " ANALYSIS ", title: " reasoning " });
+        assert.equal(r.suppress, true);
+    });
+    it("keeps supported user-facing progress events (not suppressed)", () => {
+        const r = resolveItemEventGuard({
+            kind: "search",
+            title: "Web search",
+            phase: "start",
+            status: "running",
+        });
+        assert.equal(r.suppress, false);
+        assert.equal(r.kind, "search");
+        assert.equal(r.title, "web search");
+    });
+});
+//# sourceMappingURL=item-event-guard.test.js.map

package/dist/src/item-event-guard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-event-guard.test.js","sourceRoot":"","sources":["../../src/item-event-guard.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC5B,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC5B,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,WAAW;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC5B,UAAU,EAAE,UAAU;YACtB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,WAAW;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,GAAG,qBAAqB,CAAC;YAC5B,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/nas-site.d.ts

@@ -0,0 +1,16 @@
+import type { XgImConfig } from "./types.js";
+/**
+ * 当前没有显式配置 NAS 站点时使用的站点编码。
+ *
+ * 站点编码是给 IM 客户端和后续下载路由使用的稳定业务标识，不是主机名、IP、URL，
+ * 也不能用于推导或暴露 NAS 的宿主机真实挂载路径。
+ */
+export declare const DEFAULT_NAS_SITE_CODE = "SZ_PRIMARY";
+/**
+ * 读取当前 OpenClaw 服务所挂载 NAS 的站点编码。
+ *
+ * 配置路径：channels.xg_cwork_im.nasSiteCode
+ * 未配置时：SZ_PRIMARY
+ */
+export declare function resolveNasSiteCode(config: Pick<XgImConfig, "nasSiteCode">): string;
+//# sourceMappingURL=nas-site.d.ts.map

package/dist/src/nas-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nas-site.d.ts","sourceRoot":"","sources":["../../src/nas-site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,MAAM,CAElF"}

package/dist/src/nas-site.js

@@ -0,0 +1,17 @@
+/**
+ * 当前没有显式配置 NAS 站点时使用的站点编码。
+ *
+ * 站点编码是给 IM 客户端和后续下载路由使用的稳定业务标识，不是主机名、IP、URL，
+ * 也不能用于推导或暴露 NAS 的宿主机真实挂载路径。
+ */
+export const DEFAULT_NAS_SITE_CODE = "SZ_PRIMARY";
+/**
+ * 读取当前 OpenClaw 服务所挂载 NAS 的站点编码。
+ *
+ * 配置路径：channels.xg_cwork_im.nasSiteCode
+ * 未配置时：SZ_PRIMARY
+ */
+export function resolveNasSiteCode(config) {
+    return config.nasSiteCode?.trim() || DEFAULT_NAS_SITE_CODE;
+}
+//# sourceMappingURL=nas-site.js.map

package/dist/src/nas-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nas-site.js","sourceRoot":"","sources":["../../src/nas-site.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAuC;IACtE,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,qBAAqB,CAAC;AAC/D,CAAC"}