@xgjktech/xg_cwork_im 1.17.2 → 1.17.4

package/dist/src/plan-event-subscription.d.ts

@@ -0,0 +1,36 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+export interface PlanEventSubscriptionDeps {
+    /** 按 planId 反查权威 plan（注入 getPlanById） */
+    getPlanById: (planId: string) => Plan | undefined;
+    /** 发送 PLAN_STAT 增量事件（与 middleware 共用同一实现） */
+    sendPlanStat: (params: {
+        plan: Plan;
+        source: "tool" | "snapshot";
+    }) => void;
+}
+type SubscriptionHandle = Parameters<OpenClawPluginApi["agent"]["events"]["registerAgentEventSubscription"]>[0]["handle"];
+/**
+ * 构造事件订阅的 `handle` 回调，可独立单测（不依赖真实 api/网络）。
+ *
+ * 降级纪律同 middleware：handle 内全身 try/catch，绝不外抛（与 middleware 同进程）。
+ *
+ * 保留理由（D6 二选一，已裁定保留 + 瘦身）：① 它是唯一非 middleware 的触发面，
+ * middleware 注册受 trust 门控被拒时（docs/plan-integration-notes.md §4.1 的已知部署故障）
+ * 它不受影响，仍是一条独立兜底；② 瘦身后主体只剩"守卫 → 反查 → sendPlanStat"三行，
+ * 维护成本接近零；③ 删掉等于丢弃第一轮已投入的契约面，而 runId 限制解除是可预期的上游演进。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此 handle 不会被触发，保留以便未来该限制解除后零改动生效。
+ * 不得将其作为任何正确性判断依据——权威状态来自 SQLite 只读反查。
+ */
+export declare function createPlanEventHandler(deps: PlanEventSubscriptionDeps): SubscriptionHandle;
+/**
+ * 注册计划事件订阅（前瞻性预留）。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此订阅不会被触发，保留以便未来该限制解除后零改动生效。
+ */
+export declare function registerPlanEventSubscription(api: OpenClawPluginApi, deps: PlanEventSubscriptionDeps): void;
+export {};
+//# sourceMappingURL=plan-event-subscription.d.ts.map

package/dist/src/plan-event-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-event-subscription.d.ts","sourceRoot":"","sources":["../../src/plan-event-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AASzD,MAAM,WAAW,yBAAyB;IACtC,yCAAyC;IACzC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;IAClD,6CAA6C;IAC7C,YAAY,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/E;AAED,KAAK,kBAAkB,GAAG,UAAU,CAChC,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,gCAAgC,CAAC,CACzE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEf;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,GAAG,kBAAkB,CAmB1F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAY3G"}

package/dist/src/plan-event-subscription.js

@@ -0,0 +1,57 @@
+import { isPlanEventPayload, planEventStream } from "@xgjktech/xg-openclaw-shared";
+/**
+ * xg-harness-tools 的 plugin id：streams 过滤需要与其 openclaw.plugin.json 的 id 一致。
+ */
+const HARNESS_PLUGIN_ID = "xg-harness-tools";
+const LOG_PREFIX = "[xg_cwork_im] [plan-event-subscription]";
+/**
+ * 构造事件订阅的 `handle` 回调，可独立单测（不依赖真实 api/网络）。
+ *
+ * 降级纪律同 middleware：handle 内全身 try/catch，绝不外抛（与 middleware 同进程）。
+ *
+ * 保留理由（D6 二选一，已裁定保留 + 瘦身）：① 它是唯一非 middleware 的触发面，
+ * middleware 注册受 trust 门控被拒时（docs/plan-integration-notes.md §4.1 的已知部署故障）
+ * 它不受影响，仍是一条独立兜底；② 瘦身后主体只剩"守卫 → 反查 → sendPlanStat"三行，
+ * 维护成本接近零；③ 删掉等于丢弃第一轮已投入的契约面，而 runId 限制解除是可预期的上游演进。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此 handle 不会被触发，保留以便未来该限制解除后零改动生效。
+ * 不得将其作为任何正确性判断依据——权威状态来自 SQLite 只读反查。
+ */
+export function createPlanEventHandler(deps) {
+    return (event, _ctx) => {
+        try {
+            if (!isPlanEventPayload(event.data)) {
+                return;
+            }
+            const payload = event.data;
+            const plan = deps.getPlanById(payload.planId);
+            if (!plan) {
+                console.warn(`${LOG_PREFIX} 反查不到 plan，跳过 planId=${payload.planId}`);
+                return;
+            }
+            deps.sendPlanStat({ plan, source: "tool" });
+        }
+        catch (err) {
+            console.warn(`${LOG_PREFIX} handle 内部异常，已吞: ${String(err)}`);
+        }
+    };
+}
+/**
+ * 注册计划事件订阅（前瞻性预留）。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此订阅不会被触发，保留以便未来该限制解除后零改动生效。
+ */
+export function registerPlanEventSubscription(api, deps) {
+    const handle = createPlanEventHandler(deps);
+    api.agent.events.registerAgentEventSubscription({
+        id: "xg-cwork-im-plan-progress",
+        description: "订阅 xg-harness-tools 计划进度事件，反查权威 plan 后发送 PLAN_STAT。前瞻性预留：" +
+            "当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，" +
+            "此订阅暂不会被触发，保留以便未来该限制解除后零改动生效。",
+        streams: [planEventStream(HARNESS_PLUGIN_ID)],
+        handle,
+    });
+}
+//# sourceMappingURL=plan-event-subscription.js.map

package/dist/src/plan-event-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-event-subscription.js","sourceRoot":"","sources":["../../src/plan-event-subscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGnF;;GAEG;AACH,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAa7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IAClE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnB,IAAI,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO;YACX,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;YAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,wBAAwB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpE,OAAO;YACX,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAsB,EAAE,IAA+B;IACjG,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE5C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8BAA8B,CAAC;QAC5C,EAAE,EAAE,2BAA2B;QAC/B,WAAW,EACP,2DAA2D;YAC3D,sDAAsD;YACtD,8BAA8B;QAClC,OAAO,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC7C,MAAM;KACT,CAAC,CAAC;AACP,CAAC"}

package/dist/src/plan-event-subscription.test.d.ts

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

package/dist/src/plan-event-subscription.test.d.ts.map

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

package/dist/src/plan-event-subscription.test.js

@@ -0,0 +1,167 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createPlanEventHandler } from "./plan-event-subscription.js";
+const FAKE_CTX = {
+    getRunContext: () => undefined,
+    setRunContext: () => { },
+    clearRunContext: () => { },
+};
+function makePlan(overrides = {}) {
+    return {
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [],
+        ...overrides,
+    };
+}
+function makeBlockedPayload(overrides = {}) {
+    return {
+        kind: "plan_update",
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        action: "advance",
+        taskIndex: 0,
+        taskTitle: "备份旧配置",
+        taskStatus: "blocked",
+        blockedNote: "缺少权限",
+        summary: { total: 3, completed: 1, blocked: 1, inProgress: 0 },
+        runId: "run-1",
+        ...overrides,
+    };
+}
+class RecordingDeps {
+    planById = new Map();
+    planStatCalls = [];
+    getPlanById = (planId) => this.planById.get(planId);
+    sendPlanStat = (params) => {
+        this.planStatCalls.push(params);
+    };
+}
+describe("createPlanEventHandler: isPlanEventPayload 守卫", () => {
+    it("rejects malformed data without pushing or throwing", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: { kind: "not_plan_update" },
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("rejects when data is not an object at all", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: null,
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("rejects a payload that violates kind only — everything else is valid (pins the guard)", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ kind: "some_other_plugin_event" }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("rejects a payload with a malformed summary — everything else is valid", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ summary: {} }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+});
+describe("createPlanEventHandler: 反查到 plan → 发 PLAN_STAT", () => {
+    it("反查到全量 plan → 调用 sendPlanStat，source === \"tool\"", async () => {
+        const deps = new RecordingDeps();
+        const plan = makePlan({
+            tasks: [{ title: "备份旧配置", status: "blocked", note: "缺少权限" }],
+        });
+        deps.planById.set("plan-1", plan);
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(deps.planStatCalls.length, 1);
+        assert.equal(deps.planStatCalls[0].source, "tool");
+        assert.equal(deps.planStatCalls[0].plan.planId, "plan-1");
+    });
+});
+describe("createPlanEventHandler: 反查不到 → 不发不抛", () => {
+    it("getPlanById 返回 undefined → 不调用 sendPlanStat，不抛", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ planId: "plan-does-not-exist" }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+});
+describe("createPlanEventHandler: handle 内部出错不外抛", () => {
+    it("resolves normally even when getPlanById throws", async () => {
+        const deps = new RecordingDeps();
+        deps.getPlanById = () => {
+            throw new Error("boom");
+        };
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("resolves normally even when sendPlanStat throws", async () => {
+        const deps = new RecordingDeps();
+        const plan = makePlan({ tasks: [{ title: "t1", status: "blocked", note: "n" }] });
+        deps.planById.set("plan-1", plan);
+        deps.sendPlanStat = () => {
+            throw new Error("boom");
+        };
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+    });
+});
+//# sourceMappingURL=plan-event-subscription.test.js.map

package/dist/src/plan-event-subscription.test.js.map

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

package/dist/src/plan-stat-event.d.ts

@@ -0,0 +1,28 @@
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+import type { ImStreamClient } from "./connection.js";
+/**
+ * 组装发往前端的 plan：剥离 origin（内部路由信息，含 sessionKey，前端不需要也不该看到）。
+ * 返回浅拷贝，不 mutate 入参（middleware 拿到的 plan 引用可能别处还要用）。
+ */
+export declare function toWirePlan(plan: Plan): Plan;
+/**
+ * 发送一条 PLAN_STAT。绝不抛、绝不 await 调用方（内部自己 catch）。
+ */
+export declare function sendPlanStat(params: {
+    plan: Plan;
+    source: "tool" | "snapshot";
+}): void;
+/**
+ * 登记 WS client（供后续 PLAN_STAT 增量路由），登记完立刻 fire-and-forget 触发一次快照：
+ * 反查该群未完成的计划，逐个发 PLAN_STAT（source: "snapshot"）。
+ *
+ * dispatch 是热路径：整个快照过程包 try/catch、绝不 await、绝不抛——快照失败不能连累
+ * WS 绑定本身（登记必须先于快照执行、且不受快照结果影响）。
+ *
+ * `deps.listPlansByOrigin` 默认注入 plan-store-access 的实现；测试可传入假实现
+ * 模拟反查异常（红线防御性场景——即便被注入的反查实现意外抛出，本函数也绝不外抛）。
+ */
+export declare function registerPlanWsClientAndSnapshot(groupId: string, client: ImStreamClient, replyToMsgId: string, deps?: {
+    listPlansByOrigin: (channel: string, to: string) => Plan[];
+}): void;
+//# sourceMappingURL=plan-stat-event.d.ts.map

package/dist/src/plan-stat-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-stat-event.d.ts","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAAG,IAAI,CA4BtF;AAOD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,CAAA;CAA0B,GAC7F,IAAI,CAcN"}

package/dist/src/plan-stat-event.js

@@ -0,0 +1,68 @@
+import { getPlanWsClient, setPlanWsClient } from "./plan-ws-registry.js";
+import { listPlansByOrigin } from "./plan-store-access.js";
+const LOG_PREFIX = "[xg_cwork_im] [plan-stat-event]";
+/**
+ * 组装发往前端的 plan：剥离 origin（内部路由信息，含 sessionKey，前端不需要也不该看到）。
+ * 返回浅拷贝，不 mutate 入参（middleware 拿到的 plan 引用可能别处还要用）。
+ */
+export function toWirePlan(plan) {
+    const { origin: _origin, ...wirePlan } = plan;
+    return wirePlan;
+}
+/**
+ * 发送一条 PLAN_STAT。绝不抛、绝不 await 调用方（内部自己 catch）。
+ */
+export function sendPlanStat(params) {
+    const { plan, source } = params;
+    const channel = plan.origin?.channel;
+    const to = plan.origin?.to;
+    if (channel !== "xg_cwork_im" || !to) {
+        console.warn(`${LOG_PREFIX} plan.origin 缺失或非本通道，跳过 PLAN_STAT planId=${plan.planId} channel=${channel ?? "(none)"}`);
+        return;
+    }
+    const target = getPlanWsClient(to);
+    if (!target) {
+        console.warn(`${LOG_PREFIX} 未登记 WS client，跳过 PLAN_STAT planId=${plan.planId} groupId=${to}`);
+        return;
+    }
+    void target.client
+        .sendEvent({
+        groupId: to,
+        replyToMsgId: target.replyToMsgId,
+        event: "PLAN_STAT",
+        data: { source, plan: toWirePlan(plan) },
+    })
+        .catch((err) => {
+        console.warn(`${LOG_PREFIX} 发送失败 planId=${plan.planId} groupId=${to}: ${String(err)}`);
+    });
+}
+/** 「未完成」判定：plan 中存在 status !== "completed" 的 task。 */
+function isUnfinished(plan) {
+    return plan.tasks.some((task) => task.status !== "completed");
+}
+/**
+ * 登记 WS client（供后续 PLAN_STAT 增量路由），登记完立刻 fire-and-forget 触发一次快照：
+ * 反查该群未完成的计划，逐个发 PLAN_STAT（source: "snapshot"）。
+ *
+ * dispatch 是热路径：整个快照过程包 try/catch、绝不 await、绝不抛——快照失败不能连累
+ * WS 绑定本身（登记必须先于快照执行、且不受快照结果影响）。
+ *
+ * `deps.listPlansByOrigin` 默认注入 plan-store-access 的实现；测试可传入假实现
+ * 模拟反查异常（红线防御性场景——即便被注入的反查实现意外抛出，本函数也绝不外抛）。
+ */
+export function registerPlanWsClientAndSnapshot(groupId, client, replyToMsgId, deps = { listPlansByOrigin }) {
+    setPlanWsClient(groupId, client, replyToMsgId);
+    try {
+        const plans = deps.listPlansByOrigin("xg_cwork_im", groupId);
+        for (const plan of plans) {
+            if (!isUnfinished(plan)) {
+                continue;
+            }
+            sendPlanStat({ plan, source: "snapshot" });
+        }
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} 会话快照失败，已吞 groupId=${groupId}: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=plan-stat-event.js.map

package/dist/src/plan-stat-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-stat-event.js","sourceRoot":"","sources":["../../src/plan-stat-event.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACjC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC9C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmD;IAC5E,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,aAAa,IAAI,CAAC,EAAE,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CACR,GAAG,UAAU,4CAA4C,IAAI,CAAC,MAAM,YAAY,OAAO,IAAI,QAAQ,EAAE,CACxG,CAAC;QACF,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sCAAsC,IAAI,CAAC,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7F,OAAO;IACX,CAAC;IAED,KAAK,MAAM,CAAC,MAAM;SACb,SAAS,CAAC;QACP,OAAO,EAAE,EAAE;QACX,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;KAC3C,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,IAAI,CAAC,MAAM,YAAY,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACX,CAAC;AAED,sDAAsD;AACtD,SAAS,YAAY,CAAC,IAAU;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B,CAC3C,OAAe,EACf,MAAsB,EACtB,YAAoB,EACpB,OAAuE,EAAE,iBAAiB,EAAE;IAE5F,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAE/C,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,SAAS;YACb,CAAC;YACD,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sBAAsB,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;AACL,CAAC"}

package/dist/src/plan-stat-event.test.d.ts

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

package/dist/src/plan-stat-event.test.d.ts.map

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

package/dist/src/plan-stat-event.test.js

@@ -0,0 +1,167 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+import { registerPlanWsClientAndSnapshot, sendPlanStat, toWirePlan } from "./plan-stat-event.js";
+function makePlan(overrides = {}) {
+    return {
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [{ title: "t1", status: "pending" }],
+        ...overrides,
+    };
+}
+function makeRecordingClient() {
+    const calls = [];
+    const client = {
+        start: async () => { },
+        streamProgress: async () => { },
+        streamUsage: async () => { },
+        sendEvent: async (opts) => {
+            calls.push(opts);
+        },
+        end: async () => { },
+    };
+    return { client, calls };
+}
+beforeEach(() => {
+    resetPlanWsRegistryForTest();
+});
+describe("sendPlanStat: 正常路径", () => {
+    it("plan 带 origin + WS 已登记 → sendEvent 被调用一次，event/source/planId 正确", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        sendPlanStat({ plan, source: "tool" });
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].event, "PLAN_STAT");
+        assert.equal(calls[0].groupId, "g-1");
+        assert.equal(calls[0].replyToMsgId, "msg-1");
+        assert.equal(calls[0].data.source, "tool");
+        assert.equal(calls[0].data.plan.planId, plan.planId);
+    });
+});
+describe("sendPlanStat: 🔴 payload 不含 origin（防泄漏）", () => {
+    it("data.plan.origin 应为 undefined", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan({
+            origin: { channel: "xg_cwork_im", to: "g-1", sessionKey: "sess-secret" },
+        });
+        sendPlanStat({ plan, source: "tool" });
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].data.plan.origin, undefined);
+    });
+});
+describe("sendPlanStat: 🔴 不 mutate 入参", () => {
+    it("调用后原 plan 对象仍然带着 origin", () => {
+        const { client } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const origin = { channel: "xg_cwork_im", to: "g-1" };
+        const plan = makePlan({ origin });
+        sendPlanStat({ plan, source: "tool" });
+        assert.deepEqual(plan.origin, origin);
+    });
+    it("toWirePlan 本身不 mutate 入参，返回值不含 origin", () => {
+        const origin = { channel: "xg_cwork_im", to: "g-1" };
+        const plan = makePlan({ origin });
+        const wire = toWirePlan(plan);
+        assert.deepEqual(plan.origin, origin, "入参 plan 不受影响");
+        assert.equal(wire.origin, undefined, "返回值不含 origin");
+        assert.equal(wire.planId, plan.planId);
+    });
+});
+describe("sendPlanStat: 降级路径", () => {
+    it("plan 无 origin（旧数据）→ 不发、不抛", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan();
+        assert.doesNotThrow(() => sendPlanStat({ plan, source: "tool" }));
+        assert.equal(calls.length, 0);
+    });
+    it("plan.origin.channel 不是 xg_cwork_im → 不发、不抛", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan({ origin: { channel: "some_other_channel", to: "g-1" } });
+        assert.doesNotThrow(() => sendPlanStat({ plan, source: "tool" }));
+        assert.equal(calls.length, 0);
+    });
+    it("WS 未登记该 groupId → 不发、不抛", () => {
+        const plan = makePlan({ origin: { channel: "xg_cwork_im", to: "g-never-registered" } });
+        assert.doesNotThrow(() => sendPlanStat({ plan, source: "tool" }));
+    });
+});
+describe("sendPlanStat: 🔴 fire-and-forget 红线", () => {
+    it("sendEvent 返回 rejected Promise → 不抛出到调用方，函数同步返回", () => {
+        const client = {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: async () => {
+                throw new Error("network down");
+            },
+            end: async () => { },
+        };
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        assert.doesNotThrow(() => sendPlanStat({ plan, source: "tool" }));
+    });
+    it("sendEvent 返回永不 resolve 的 Promise → 函数仍立即返回", () => {
+        const client = {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: () => new Promise(() => { }),
+            end: async () => { },
+        };
+        setPlanWsClient("g-1", client, "msg-1");
+        const plan = makePlan({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        // 若 sendPlanStat 内部 await 了 sendEvent，这行会挂起整个测试进程（超时失败）。
+        const result = sendPlanStat({ plan, source: "tool" });
+        assert.equal(result, undefined);
+    });
+});
+describe("registerPlanWsClientAndSnapshot: 快照路径", () => {
+    it("🔴 登记时存在 2 个未完成计划 + 1 个全完成计划 → 恰好发 2 条 source === \"snapshot\"", () => {
+        const { client, calls } = makeRecordingClient();
+        const unfinished1 = makePlan({
+            planId: "plan-a",
+            origin: { channel: "xg_cwork_im", to: "g-1" },
+            tasks: [{ title: "t1", status: "in_progress" }],
+        });
+        const unfinished2 = makePlan({
+            planId: "plan-b",
+            origin: { channel: "xg_cwork_im", to: "g-1" },
+            tasks: [{ title: "t1", status: "blocked", note: "n" }],
+        });
+        const finished = makePlan({
+            planId: "plan-c",
+            origin: { channel: "xg_cwork_im", to: "g-1" },
+            tasks: [{ title: "t1", status: "completed" }],
+        });
+        registerPlanWsClientAndSnapshot("g-1", client, "msg-1", {
+            listPlansByOrigin: () => [unfinished1, unfinished2, finished],
+        });
+        assert.equal(calls.length, 2);
+        assert.ok(calls.every((c) => c.data.source === "snapshot"));
+        const planIds = calls.map((c) => c.data.plan.planId).sort();
+        assert.deepEqual(planIds, ["plan-a", "plan-b"]);
+    });
+    it("🔴 反查抛异常 → registerPlanWsClientAndSnapshot 不抛，且登记本身仍然成功", () => {
+        const { client, calls } = makeRecordingClient();
+        assert.doesNotThrow(() => {
+            registerPlanWsClientAndSnapshot("g-1", client, "msg-1", {
+                listPlansByOrigin: () => {
+                    throw new Error("db locked");
+                },
+            });
+        });
+        assert.equal(calls.length, 0, "反查失败不应发出任何 PLAN_STAT");
+        // 登记仍然成功：紧接着用同一 client 发一条正常的 PLAN_STAT 应该能路由到
+        const plan = makePlan({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        sendPlanStat({ plan, source: "tool" });
+        assert.equal(calls.length, 1, "快照失败不能连累 WS 绑定，后续增量应仍能发出");
+    });
+});
+//# sourceMappingURL=plan-stat-event.test.js.map

package/dist/src/plan-stat-event.test.js.map

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

package/dist/src/plan-store-access.d.ts

@@ -0,0 +1,23 @@
+import type { Plan, PlanSummary } from "@xgjktech/xg-openclaw-shared";
+/** 注入 stateDir（来自 api.runtime.state.resolveStateDir()）。register(api) 时调用一次。 */
+export declare function setPlanStateDir(dir: string): void;
+/** 测试用：重置模块级缓存与 stateDir */
+export declare function resetPlanStoreAccessForTest(): void;
+/**
+ * 按 planId 反查完整计划。
+ * 库不存在 / 打开失败 / 读取异常 → 返回 undefined 并记 warn 日志，绝不抛。
+ */
+export declare function getPlanById(planId: string): Plan | undefined;
+/**
+ * 列出全部计划摘要（重启恢复用）。
+ * 异常同上 → 返回空数组，绝不抛。
+ */
+export declare function listPlanSummaries(): PlanSummary[];
+/**
+ * 按来源会话（channel + to）反查全量 plan（WS 快照用）。
+ * shared 侧只读实现已内置"旧库缺 origin 列 → 返回 []"的探测降级；
+ * 这里叠加本文件既有的句柄级降级纪律：拿不到句柄 / 查询异常 → 记 warn、返回 []、绝不抛、
+ * 失败时清空句柄缓存（与 getPlanById 同款，供后续调用重试恢复）。
+ */
+export declare function listPlansByOrigin(channel: string, to: string): Plan[];
+//# sourceMappingURL=plan-store-access.d.ts.map

package/dist/src/plan-store-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-store-access.d.ts","sourceRoot":"","sources":["../../src/plan-store-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAWtE,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,4BAA4B;AAC5B,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD;AAyBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAY5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,EAAE,CAYjD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,CAYrE"}