@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

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

@@ -0,0 +1,180 @@
+/**
+ * IM 入站消息终态：分类、用户可见文案、结构化日志字段。
+ */
+const PRECHECK_MARKERS = [
+    "context overflow",
+    "context-overflow",
+    "overflowtokens",
+    "overflow tokens",
+    "prompt too large",
+    "precheck",
+    "too large for the model",
+    "too large for this model",
+    "promptbudget",
+];
+const TIMEOUT_MARKERS = ["request timed out", "timed out", "idle timeout", "llm idle timeout"];
+const NO_REPLY_MARKERS = ["no_reply", "no reply"];
+export function classifyRuntimeErrorMessage(message) {
+    const raw = message.trim();
+    const lower = raw.toLowerCase();
+    if (lower.includes("blocked attachment") ||
+        lower.includes("outside allowed roots") ||
+        lower.includes("not under an allowed directory")) {
+        return { errorType: "runtime_error", errorMessage: raw };
+    }
+    if (PRECHECK_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "precheck_error", errorMessage: raw };
+    }
+    if (lower.includes("context-overflow-precheck") || (lower.includes("precheck") && lower.includes("overflow"))) {
+        return { errorType: "precheck_error", errorMessage: raw };
+    }
+    if (TIMEOUT_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "timeout", errorMessage: raw };
+    }
+    if (NO_REPLY_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "no_reply", errorMessage: raw };
+    }
+    if (lower.includes("compaction") && (lower.includes("incomplete") || lower.includes("failed"))) {
+        return { errorType: "compaction_failed", errorMessage: raw };
+    }
+    return { errorType: "runtime_error", errorMessage: raw };
+}
+export function classifyRuntimeError(err) {
+    if (err instanceof Error) {
+        return classifyRuntimeErrorMessage(err.message);
+    }
+    return classifyRuntimeErrorMessage(String(err));
+}
+export { buildTerminalUserMessage } from "./user-facing-errors.js";
+export function formatTerminalLogLine(fields) {
+    const parts = [
+        `[terminal] message_id=${fields.message_id}`,
+        `group_id=${fields.group_id}`,
+        `session_key=${fields.session_key}`,
+        fields.run_id ? `run_id=${fields.run_id}` : undefined,
+        `trigger=${fields.trigger}`,
+        `terminal_state=${fields.terminal_state}`,
+        `sent_to_im=${fields.sent_to_im}`,
+        fields.error_type ? `error_type=${fields.error_type}` : undefined,
+        fields.error_message ? `error_message=${JSON.stringify(fields.error_message)}` : undefined,
+        fields.no_reply_cause ? `no_reply_cause=${fields.no_reply_cause}` : undefined,
+        fields.deliver_invoke_count != null ? `deliver_invoke_count=${fields.deliver_invoke_count}` : undefined,
+        fields.deliver_call_count != null ? `deliver_call_count=${fields.deliver_call_count}` : undefined,
+        fields.normalizer_silent_skip != null
+            ? `normalizer_silent_skip=${fields.normalizer_silent_skip}`
+            : undefined,
+        fields.normalizer_heartbeat_skip != null
+            ? `normalizer_heartbeat_skip=${fields.normalizer_heartbeat_skip}`
+            : undefined,
+        fields.http_suppressed_reason ? `http_suppressed_reason=${fields.http_suppressed_reason}` : undefined,
+    ].filter(Boolean);
+    return parts.join(" ");
+}
+export function resolveHttpSuppressedReason(state, input) {
+    if (state !== "no_reply") {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    return undefined;
+}
+/**
+ * 是否允许对 IM 发终态 HTTP。
+ * 不发：no_reply / timeout / compaction_failed（避免自造话或通道计时器误导）。
+ * 可发：投递失败、取消/覆盖、以及带上游原文的确认错误（文案为空时 trySend 仍会跳过）。
+ */
+export function shouldSendTerminalHttpForState(state, _input) {
+    switch (state) {
+        case "success":
+        case "no_reply":
+        case "timeout":
+        case "compaction_failed":
+            return false;
+        case "delivery_failed":
+        case "cancelled":
+        case "superseded":
+        case "precheck_error":
+        case "runtime_error":
+            return true;
+        default:
+            return false;
+    }
+}
+export function resolveNoReplyCause(input) {
+    if (input.hasBusinessReply) {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    if (input.deliverInvokeCount === 0) {
+        return "zero_deliver";
+    }
+    if (input.deliverInvokeCount > 0 && input.deliverCallCount === 0) {
+        return "all_deliver_skipped";
+    }
+    return "unknown";
+}
+/** 在 finally 阶段根据观测信号推断终态（success 由 hasBusinessReply 在外层短路）。 */
+export function resolveTerminalState(input) {
+    if (input.hasBusinessReply) {
+        return "success";
+    }
+    if (input.timeoutFired) {
+        return "timeout";
+    }
+    if (input.lastDeliverError !== undefined) {
+        return "delivery_failed";
+    }
+    if (input.runtimeErrorHint) {
+        return input.runtimeErrorHint.errorType;
+    }
+    if (input.dispatchError !== undefined) {
+        return classifyRuntimeError(input.dispatchError).errorType;
+    }
+    if (input.beforeAgentRunBlocked) {
+        return "precheck_error";
+    }
+    if (input.compactionIncomplete || (input.compactionShown && input.deliverCallCount === 0)) {
+        return "compaction_failed";
+    }
+    if (input.deliverInvokeCount > 0 &&
+        input.deliverCallCount === 0 &&
+        input.runtimeErrorHint === undefined &&
+        input.dispatchError === undefined &&
+        input.lastDeliverError === undefined) {
+        return "no_reply";
+    }
+    if (input.deliverInvokeCount === 0 && !input.dispatchThrew) {
+        return "no_reply";
+    }
+    return "runtime_error";
+}
+/** 进程级幂等：同一 message_id 终态 HTTP 最多发一次。 */
+const globalTerminalSent = new Map();
+export function hasGlobalTerminalSent(messageId) {
+    return globalTerminalSent.has(messageId.trim());
+}
+export function markGlobalTerminalSent(messageId, state) {
+    const id = messageId.trim();
+    if (!id)
+        return;
+    if (!globalTerminalSent.has(id)) {
+        globalTerminalSent.set(id, state);
+    }
+}
+export function peekGlobalTerminalSent(messageId) {
+    return globalTerminalSent.get(messageId.trim());
+}
+/** 测试用：清空进程级幂等表。 */
+export function resetGlobalTerminalSentForTests() {
+    globalTerminalSent.clear();
+}
+//# sourceMappingURL=inbound-terminal-state.js.map

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

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

package/dist/src/inbound-terminal-state.test.d.ts

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

package/dist/src/inbound-terminal-state.test.d.ts.map

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

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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"}