@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/turn/subagent-monitor.test.js

@@ -0,0 +1,335 @@
+import assert from "node:assert/strict";
+import { afterEach, describe, it } from "node:test";
+import { __resetActiveRoundRegistryForTests, registerActiveRound } from "./active-round-registry.js";
+import { __resetSubagentMonitorForTests, __tickForTests, hasActiveSubagents, markSubagentCompleted, prepareSubagentInterrupt, setPluginApi, startMonitor, } from "./subagent-monitor.js";
+afterEach(() => {
+    __resetSubagentMonitorForTests();
+    __resetActiveRoundRegistryForTests();
+});
+function createClient(events) {
+    return {
+        start: async () => undefined,
+        streamProgress: async () => undefined,
+        streamUsage: async () => undefined,
+        sendEvent: async (event) => {
+            const list = event.data.subagentList ?? [];
+            events.push(`SUBAGENT_STAT:${list.map((s) => `${s.runId}:${s.status}`).join(",") || "(empty)"}`);
+        },
+        end: async (reason) => {
+            events.push(`FINISHED:${reason}`);
+        },
+    };
+}
+function createPluginApi(overrides) {
+    return {
+        runtime: {
+            subagent: {
+                waitForRun: overrides.waitForRun ?? (async () => ({ status: "timeout" })),
+                getSessionMessages: overrides.getSessionMessages ?? (async () => ({ messages: [] })),
+            },
+        },
+    };
+}
+function setupRound(events) {
+    const client = createClient(events);
+    const round = registerActiveRound({
+        accountId: "account-a",
+        groupId: "group-1",
+        agentId: "main",
+        sessionKey: "session-1",
+        replyToMsgId: "reply-1",
+        streamClient: client,
+    });
+    return { round, client };
+}
+function spawnParams(round, client, childSessionKey, runId) {
+    return {
+        roundKey: round.roundKey,
+        generation: round.generation,
+        groupId: round.groupId,
+        agentId: round.agentId,
+        streamClient: client,
+        replyToMsgId: round.replyToMsgId,
+        spawn: { childSessionKey, runId },
+    };
+}
+const settle = () => new Promise((resolve) => setImmediate(resolve));
+describe("subagent-monitor completion matching", () => {
+    it("subagent_ended runId 与 spawn 不一致时仍按 childSessionKey 完成", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-2");
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-1:completed"]);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("subagent_ended 缺失 runId 时按 childSessionKey 完成", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        markSubagentCompleted("child-1", undefined);
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-1:completed"]);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("中断后同 childSessionKey 重新 spawn（新 runId）的结束事件不被 tombstone 误挡", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        prepareSubagentInterrupt(round.roundKey, round.generation);
+        events.length = 0;
+        const round2 = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-2",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        assert.equal(startMonitor(spawnParams(round2, client, "child-1", "run-2")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-2");
+        await settle();
+        assert.deepEqual(events, ["SUBAGENT_STAT:run-2:completed"]);
+        assert.equal(hasActiveSubagents(round2.roundKey, round2.generation), false);
+    });
+    it("中断后被中断旧 run 的迟到结束事件不会完成新 record", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        assert.equal(startMonitor(spawnParams(round, client, "child-1", "run-1")), true);
+        prepareSubagentInterrupt(round.roundKey, round.generation);
+        const round2 = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-2",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        assert.equal(startMonitor(spawnParams(round2, client, "child-1", "run-2")), true);
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-1");
+        await settle();
+        assert.equal(events.some((e) => e.includes(":completed")), false);
+        assert.equal(hasActiveSubagents(round2.roundKey, round2.generation), true);
+    });
+});
+describe("subagent-monitor tick reconciliation", () => {
+    it("waitForRun 返回 ok → 标记完成并收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "ok" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("waitForRun 返回 timeout → 保持 running 且不收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "timeout" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:running"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+    it("getSessionMessages 抛错 → tick 不被拖垮，仍发 stat 且保持 running", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            getSessionMessages: async () => {
+                throw new Error("Plugin runtime subagent methods are only available during a gateway request.");
+            },
+            waitForRun: async () => ({ status: "timeout" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:running"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+    it("waitForRun 返回 error → 标记完成并收口", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "error", error: "boom" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("waitForRun 抛异常 → 保持 running，由事件路径兜底", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => {
+                throw new Error("run not found");
+            },
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+        markSubagentCompleted("child-1", "run-1");
+        await settle();
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("多 subagent 的 waitForRun 探测并发执行（互不阻塞累加）", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        let inFlight = 0;
+        let maxInFlight = 0;
+        setPluginApi(createPluginApi({
+            waitForRun: async () => {
+                inFlight += 1;
+                maxInFlight = Math.max(maxInFlight, inFlight);
+                await new Promise((resolve) => setTimeout(resolve, 20));
+                inFlight -= 1;
+                return { status: "timeout" };
+            },
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        startMonitor(spawnParams(round, client, "child-2", "run-2"));
+        events.length = 0;
+        // startMonitor 会触发一次立即 tick（fire-and-forget），先等它跑完再单独测量。
+        await new Promise((resolve) => setTimeout(resolve, 30));
+        inFlight = 0;
+        maxInFlight = 0;
+        await __tickForTests();
+        assert.equal(maxInFlight, 2);
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+    });
+});
+function requestScopedError() {
+    const err = new Error("Plugin runtime subagent methods are only available during a gateway request.");
+    err.name = "RequestScopedSubagentRuntimeError";
+    return err;
+}
+describe("subagent-monitor pluginApi guard（方案B：坏 runtime 不劫持监控）", () => {
+    it("好 runtime 确认可用后，坏 runtime 的 register 不会覆盖（监控继续用好的）", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        // 好 runtime：probe 探测用 runId="probe" 返回 timeout（可用），真实 run 返回 ok（完成）。
+        const good = createPluginApi({
+            waitForRun: async ({ runId }) => runId === "probe" ? { status: "timeout" } : { status: "ok" },
+        });
+        setPluginApi(good);
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        // 首次 tick 探测确认 good，run-1 被完成
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+        // 坏 runtime 注册：waitForRun 直接抛 RequestScoped
+        const bad = createPluginApi({
+            waitForRun: async () => {
+                throw requestScopedError();
+            },
+        });
+        setPluginApi(bad);
+        // 新会话的 run-2：tick 仍应通过 good runtime 完成，坏 runtime 未劫持
+        const round2 = registerActiveRound({
+            accountId: "account-a",
+            groupId: "group-2",
+            agentId: "main",
+            sessionKey: "session-1",
+            replyToMsgId: "reply-1",
+            streamClient: client,
+        });
+        startMonitor(spawnParams(round2, client, "child-2", "run-2"));
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-2:completed"));
+        assert.equal(hasActiveSubagents(round2.roundKey, round2.generation), false);
+    });
+    it("首个 runtime 不可用 → 探测后切回候选中的可用 runtime", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        const bad = createPluginApi({
+            waitForRun: async () => {
+                throw requestScopedError();
+            },
+        });
+        setPluginApi(bad);
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        events.length = 0;
+        await __tickForTests();
+        // 只有坏 runtime：探测失败，run 保持 running
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), true);
+        // 好 runtime 随后注册（当前已确认 bad → adopt=switch）
+        const good = createPluginApi({ waitForRun: async () => ({ status: "ok" }) });
+        setPluginApi(good);
+        events.length = 0;
+        await __tickForTests();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"));
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("探测结果缓存：确认 good 后不再重复探测", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        let probeCalls = 0;
+        setPluginApi(createPluginApi({
+            waitForRun: async ({ runId }) => {
+                if (runId === "probe")
+                    probeCalls += 1;
+                return { status: "timeout" };
+            },
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        // 等 startMonitor 触发的 fire-and-forget tick 完成：它应探测一次并确认 good。
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        assert.equal(probeCalls, 1);
+        await __tickForTests();
+        await __tickForTests();
+        assert.equal(probeCalls, 1);
+    });
+});
+describe("subagent-monitor 同一轮多波次（finalStatSent 锁存已去除）", () => {
+    it("第一波完成后同轮第二波子任务完成仍能推送 completed SUBAGENT_STAT", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        await settle();
+        events.length = 0;
+        markSubagentCompleted("child-1", "run-1");
+        await settle();
+        assert.ok(events.some((e) => e === "SUBAGENT_STAT:run-1:completed"), "第一波 final 缺失");
+        // 同 round、同 generation 再派第二波
+        startMonitor(spawnParams(round, client, "child-2", "run-2"));
+        await settle();
+        events.length = 0;
+        markSubagentCompleted("child-2", "run-2");
+        await settle();
+        assert.ok(events.some((e) => e.startsWith("SUBAGENT_STAT:") && e.includes("run-2:completed")), "第二波被一轮一次锁存吞掉（应能推送 completed）");
+        assert.equal(hasActiveSubagents(round.roundKey, round.generation), false);
+    });
+    it("全部完成后的空窗：无变化的 tick 不重复推 final 快照", async () => {
+        const events = [];
+        const { round, client } = setupRound(events);
+        setPluginApi(createPluginApi({
+            waitForRun: async () => ({ status: "ok" }),
+        }));
+        startMonitor(spawnParams(round, client, "child-1", "run-1"));
+        await settle();
+        // 首个 tick：探测 ok → 完成并 settle
+        await __tickForTests();
+        await __tickForTests();
+        events.length = 0;
+        // 空窗期反复 tick：状态无变化，不应再推（去重）
+        await __tickForTests();
+        await __tickForTests();
+        assert.equal(events.length, 0, "无变化 tick 不应重复推送 SUBAGENT_STAT");
+    });
+});
+//# sourceMappingURL=subagent-monitor.test.js.map

package/dist/src/turn/subagent-monitor.test.js.map

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

package/dist/src/turn/turn-agent-event-subscription.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 订阅 OpenClaw agent-event 流（lifecycle / thinking / compaction / plan）并把整轮级信号喂给
+ * turn-end-controller，同时为「非 wrapper 覆盖的 resume 段」补发 thinking/compaction 进度，
+ * 并统一承载计划更新（PLAN_STAT / PLAN_UPDATE）。
+ *
+ * 背景：OpenClaw 7.1+ / 8.x（lifecycle 语义一致；245 实测 2026.7.1-2）中，父会话每次
+ * sessions_spawn 都会挂起并结束当前段 run（lifecycle `yielded:true`），子任务返回后父会话被
+ * 自动 resume 成新段。dispatch wrapper 只覆盖首段，之后的 resume 段只有 agent-event 流能看到。
+ * 因此：
+ * - lifecycle 终态（sessionKey 必带）→ 判定「整轮是否真正结束」（P0）；
+ * - thinking / compaction（仅带 runId）→ 以 lifecycle start 建立的 runId→session 索引定位到轮次，
+ *   仅对非 wrapper 首段的 runId 转发，避免与 wrapper 回调重复展示（P1）；
+ * - plan → 同样以 runId→session 索引定位轮次，但**所有段**都走这里（dispatch 不再绑
+ *   replyOptions.onPlanUpdate）：progress_card 的更新在首段与 resume/settle 段同一条路径，
+ *   整轮最终计划状态不会因 resume 段绕开 wrapper 而丢失。
+ *
+ * handle 内绝不容忍抛错（事件订阅统一纪律）。
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+/**
+ * 记录 wrapper 首段 runId（dispatch wrapper 的 onAgentRunStart）。
+ * 该 run 的 thinking/compaction 已由 wrapper 回调展示，订阅侧跳过，避免重复。
+ */
+export declare function noteWrappedRunId(sessionKey: string, runId: string): void;
+export declare function createTurnAgentEventHandler(): Parameters<OpenClawPluginApi["agent"]["events"]["registerAgentEventSubscription"]>[0]["handle"];
+/** 插件卸载时清理全部事件索引。 */
+export declare function disposeTurnAgentEvents(): void;
+export declare function registerTurnAgentEventSubscription(api: OpenClawPluginApi): void;
+//# sourceMappingURL=turn-agent-event-subscription.d.ts.map

package/dist/src/turn/turn-agent-event-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-agent-event-subscription.d.ts","sourceRoot":"","sources":["../../../src/turn/turn-agent-event-subscription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAqGnF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,2BAA2B,IAAI,UAAU,CACrD,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,gCAAgC,CAAC,CACzE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAqPb;AAED,qBAAqB;AACrB,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAQ/E"}