@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/plan/plan-core-snapshot.test.js

@@ -0,0 +1,157 @@
+import assert from "node:assert/strict";
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { after, afterEach, describe, it } from "node:test";
+import { buildCorePlanId } from "./plan-core-adapter.js";
+import { setCoreAgentStateBase } from "./plan-core-db.js";
+import { registerCorePlanSnapshotClient } from "./plan-core-snapshot.js";
+import { resetPlanWsRegistryForTest } from "./plan-ws-registry.js";
+const NOW = Date.parse("2026-09-08T12:00:00.000Z");
+const HOUR = 60 * 60_000;
+const tempDirs = [];
+function makeTempBase() {
+    const dir = mkdtempSync(join(tmpdir(), "xg-plan-core-snapshot-"));
+    tempDirs.push(dir);
+    return dir;
+}
+function seedCard(baseDir, agentId, sessionKey, opts) {
+    const agentDir = join(baseDir, "agents", agentId, "agent");
+    mkdirSync(agentDir, { recursive: true });
+    const db = new DatabaseSync(join(agentDir, "openclaw-agent.sqlite"));
+    try {
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS session_progress_cards (
+              session_key TEXT NOT NULL PRIMARY KEY,
+              markdown TEXT,
+              steps_json TEXT,
+              revision INTEGER NOT NULL,
+              created_at INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL
+            ) STRICT;
+        `);
+        db.prepare("INSERT INTO session_progress_cards (session_key, markdown, steps_json, revision, created_at, updated_at) VALUES (?, ?, ?, 1, ?, ?);").run(sessionKey, opts.markdown ?? null, opts.stepsJson, opts.createdAtMs ?? NOW - HOUR, opts.updatedAtMs ?? NOW - 5 * 60_000);
+    }
+    finally {
+        db.close();
+    }
+}
+function makeRecordingClient() {
+    const calls = [];
+    const client = {
+        start: async () => { },
+        streamProgress: async () => { },
+        streamUsage: async () => { },
+        sendEvent: async (opts) => {
+            calls.push(opts);
+        },
+        end: async () => { },
+    };
+    return { client, calls };
+}
+after(() => {
+    for (const dir of tempDirs.splice(0)) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Windows 偶发句柄未释放导致删除失败，忽略
+        }
+    }
+});
+afterEach(() => {
+    resetPlanWsRegistryForTest();
+    setCoreAgentStateBase("");
+});
+describe("registerCorePlanSnapshotClient", () => {
+    it("登记 client 并推送一份 source=snapshot 的未完成新鲜计划", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([
+                { step: "备份", status: "completed" },
+                { step: "校验", status: "in_progress" },
+            ]),
+            markdown: "迁移配置到新版本",
+            createdAtMs: NOW - HOUR,
+            updatedAtMs: NOW - 5 * 60_000,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 1);
+        const sent = calls[0];
+        assert.equal(sent.event, "PLAN_STAT");
+        assert.equal(sent.data.source, "snapshot");
+        const plan = sent.data.plan;
+        assert.equal(plan.planId, buildCorePlanId(sessionKey));
+        assert.equal(plan.createdAt, new Date(NOW - HOUR).toISOString());
+        assert.equal(plan.updatedAt, new Date(NOW - 5 * 60_000).toISOString());
+        assert.equal(plan.markdown, "迁移配置到新版本");
+        assert.deepEqual(plan.tasks, [
+            { title: "备份", status: "completed" },
+            { title: "校验", status: "in_progress" },
+        ]);
+    });
+    it("超过 1 小时未更新 → 不发（陈旧）", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([{ step: "A", status: "in_progress" }]),
+            updatedAtMs: NOW - 2 * HOUR,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 0);
+    });
+    it("全部 completed → 不发", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const sessionKey = "agent:main:s-1";
+        seedCard(base, "main", sessionKey, {
+            stepsJson: JSON.stringify([{ step: "A", status: "completed" }]),
+            updatedAtMs: NOW - 5 * 60_000,
+        });
+        const { client, calls } = makeRecordingClient();
+        registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey,
+            nowMs: NOW,
+        });
+        assert.equal(calls.length, 0);
+    });
+    it("core 无卡 / 库不存在 → 登记成功但不发，不外抛", () => {
+        const base = makeTempBase();
+        setCoreAgentStateBase(base);
+        const { client, calls } = makeRecordingClient();
+        assert.doesNotThrow(() => registerCorePlanSnapshotClient({
+            groupId: "g-1",
+            client,
+            replyToMsgId: "msg-1",
+            agentId: "main",
+            sessionKey: "agent:main:nope",
+            nowMs: NOW,
+        }));
+        assert.equal(calls.length, 0);
+    });
+});
+//# sourceMappingURL=plan-core-snapshot.test.js.map

package/dist/src/plan/plan-core-snapshot.test.js.map

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

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

@@ -0,0 +1,17 @@
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+/**
+ * 组装发往前端的 plan：剥离 origin（内部路由信息，含 sessionKey，前端不需要也不该看到）。
+ * 返回浅拷贝，不 mutate 入参（middleware 拿到的 plan 引用可能别处还要用）。
+ */
+export declare function toWirePlan(plan: Plan): Plan;
+/**
+ * 发送一条 PLAN_STAT。绝不抛、绝不 await 调用方（内部自己 catch）。
+ *
+ * 计划状态来自 core progress_card（工具事件 or DB 回放），内部 origin 的
+ * channel/to 用于路由到对应群的 WS client。
+ */
+export declare function sendPlanStat(params: {
+    plan: Plan;
+    source: "tool" | "snapshot";
+}): void;
+//# sourceMappingURL=plan-stat-event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-stat-event.d.ts","sourceRoot":"","sources":["../../../src/plan/plan-stat-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAKzD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAAG,IAAI,CA4BtF"}

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

@@ -0,0 +1,41 @@
+import { getPlanWsClient } from "./plan-ws-registry.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）。
+ *
+ * 计划状态来自 core progress_card（工具事件 or DB 回放），内部 origin 的
+ * channel/to 用于路由到对应群的 WS client。
+ */
+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)}`);
+    });
+}
+//# sourceMappingURL=plan-stat-event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-stat-event.js","sourceRoot":"","sources":["../../../src/plan/plan-stat-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,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;;;;;GAKG;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"}

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

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

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

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

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

@@ -0,0 +1,131 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+import { 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 并保留 status/cancelledAt", () => {
+        const origin = { channel: "xg_cwork_im", to: "g-1" };
+        const plan = makePlan({
+            origin,
+            status: "cancelled",
+            cancelledAt: "2026-07-31T01:02:03.000Z",
+        });
+        const wire = toWirePlan(plan);
+        assert.deepEqual(plan.origin, origin, "入参 plan 不受影响");
+        assert.equal(wire.origin, undefined, "返回值不含 origin");
+        assert.equal(wire.planId, plan.planId);
+        assert.equal(wire.status, "cancelled");
+        assert.equal(wire.cancelledAt, "2026-07-31T01:02:03.000Z");
+    });
+});
+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);
+    });
+});
+//# sourceMappingURL=plan-stat-event.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-stat-event.test.js","sourceRoot":"","sources":["../../../src/plan/plan-stat-event.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEhE,SAAS,QAAQ,CAAC,YAA2B,EAAE;IAC3C,OAAO;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC3C,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAED,SAAS,mBAAmB;IACxB,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAmB;QAC3B,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QACtB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QAC5B,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,GAAG,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;KACvB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACZ,0BAA0B,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;QAChD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAa,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;QAChD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,CAAC;YAClB,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE;SAC3E,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC;QACzC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAsB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAsB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC;YAClB,MAAM;YACN,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,0BAA0B;SAC1C,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;QAChD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,CAAC;QAChD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACxF,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAmB;YAC3B,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YACtB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YAC5B,SAAS,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YACpC,CAAC;YACD,GAAG,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;SACvB,CAAC;QACF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAmB;YAC3B,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YACtB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;YAC5B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,CAAO,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7C,GAAG,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;SACvB,CAAC;QACF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,yDAAyD;QACzD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/plan/plan-tool-middleware.d.ts

@@ -0,0 +1,19 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+import type { ActionDispatchEvent } from "./action-store-access.js";
+export type AgentToolResultMiddleware = Parameters<OpenClawPluginApi["registerAgentToolResultMiddleware"]>[0];
+export interface PlanMiddlewareDeps {
+    /** 按 eventId 反查 action 的权威状态。 */
+    getActionById: (eventId: string) => ActionDispatchEvent | undefined;
+    /** 推送 Action Dispatch 事件（内部 fire-and-forget）。 */
+    sendActionRunEvent: (action: ActionDispatchEvent) => void;
+}
+/**
+ * 创建 xg_action_dispatch 工具结果的 middleware handler。
+ *
+ * 三条硬约束（沿用 RULING-1 红线）：
+ * 1. 绝不抛异常：全身 try/catch，捕获后记 warn 并正常返回。
+ * 2. 绝不修改结果：恒返回 void，不 mutate event.result。
+ * 3. 不在 handler 内 await 网络 IO。
+ */
+export declare function createPlanToolResultMiddleware(deps: PlanMiddlewareDeps): AgentToolResultMiddleware;
+//# sourceMappingURL=plan-tool-middleware.d.ts.map

package/dist/src/plan/plan-tool-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tool-middleware.d.ts","sourceRoot":"","sources":["../../../src/plan/plan-tool-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAC9C,iBAAiB,CAAC,mCAAmC,CAAC,CACzD,CAAC,CAAC,CAAC,CAAC;AAML,MAAM,WAAW,kBAAkB;IAC/B,iCAAiC;IACjC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,CAAC;IACpE,iDAAiD;IACjD,kBAAkB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC7D;AA+BD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,kBAAkB,GAAG,yBAAyB,CAuBlG"}

package/dist/src/plan/plan-tool-middleware.js

@@ -0,0 +1,63 @@
+const ACTION_TOOL_NAME = "xg_action_dispatch";
+const LOG_PREFIX = "[xg_cwork_im] [action-tool-middleware]";
+function extractActionEventId(event) {
+    const values = [event.result.details, safeJsonParse(firstTextContent(event.result) ?? "")];
+    for (const value of values) {
+        if (typeof value === "object" && value !== null) {
+            const result = value;
+            if (result.ok === true && typeof result.eventId === "string" && result.eventId.trim() !== "") {
+                return result.eventId;
+            }
+        }
+    }
+    return undefined;
+}
+function firstTextContent(result) {
+    const first = result.content[0];
+    if (!first || first.type !== "text" || typeof first.text !== "string") {
+        return undefined;
+    }
+    return first.text;
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 创建 xg_action_dispatch 工具结果的 middleware handler。
+ *
+ * 三条硬约束（沿用 RULING-1 红线）：
+ * 1. 绝不抛异常：全身 try/catch，捕获后记 warn 并正常返回。
+ * 2. 绝不修改结果：恒返回 void，不 mutate event.result。
+ * 3. 不在 handler 内 await 网络 IO。
+ */
+export function createPlanToolResultMiddleware(deps) {
+    return (event, _ctx) => {
+        try {
+            if (event.toolName !== ACTION_TOOL_NAME) {
+                return;
+            }
+            const eventId = extractActionEventId(event);
+            if (!eventId) {
+                console.warn(`${LOG_PREFIX} 无法从 action 工具返回中解析 eventId toolCallId=${event.toolCallId}`);
+                return;
+            }
+            const action = deps.getActionById(eventId);
+            if (!action) {
+                console.warn(`${LOG_PREFIX} 反查不到 action，跳过 toolCallId=${event.toolCallId} eventId=${eventId}`);
+                return;
+            }
+            deps.sendActionRunEvent(action);
+            return;
+        }
+        catch (err) {
+            console.warn(`${LOG_PREFIX} handler 内部异常，已吞: ${String(err)}`);
+            return;
+        }
+    };
+}
+//# sourceMappingURL=plan-tool-middleware.js.map

package/dist/src/plan/plan-tool-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tool-middleware.js","sourceRoot":"","sources":["../../../src/plan/plan-tool-middleware.ts"],"names":[],"mappings":"AAOA,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAE9C,MAAM,UAAU,GAAG,wCAAwC,CAAC;AAS5D,SAAS,oBAAoB,CAAC,KAAwF;IAClH,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC3F,OAAO,MAAM,CAAC,OAAO,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA2D;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAwB;IACnE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnB,IAAI,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;gBACtC,OAAO;YACX,CAAC;YACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,0CAA0C,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACxF,OAAO;YACX,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,8BAA8B,KAAK,CAAC,UAAU,YAAY,OAAO,EAAE,CAAC,CAAC;gBAC/F,OAAO;YACX,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO;QACX,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,qBAAqB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9D,OAAO;QACX,CAAC;IACL,CAAC,CAAC;AACN,CAAC"}

package/dist/src/plan/plan-tool-middleware.test.d.ts

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

package/dist/src/plan/plan-tool-middleware.test.d.ts.map

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

package/dist/src/plan/plan-tool-middleware.test.js

@@ -0,0 +1,103 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createPlanToolResultMiddleware, } from "./plan-tool-middleware.js";
+function makeAction(eventId, overrides = {}) {
+    return {
+        eventId,
+        event: "action_dispatch",
+        action: "form_fill",
+        target: "page://order-detail",
+        version: 1,
+        status: "completed",
+        scopeControl: { activeSessionOnly: true },
+        payload: { data: { id: eventId } },
+        timestamp: "2026-09-07T17:00:00.000+08:00",
+        origin: { channel: "xg_cwork_im", to: "g-1" },
+        ...overrides,
+    };
+}
+function makeToolEvent(toolName, overrides = {}) {
+    return {
+        toolCallId: "call-1",
+        toolName,
+        args: {},
+        result: { details: undefined, content: [] },
+        ...overrides,
+    };
+}
+class Probe {
+    sent = [];
+    actionById = new Map();
+    deps;
+    handler;
+    constructor() {
+        this.deps = {
+            getActionById: (eventId) => this.actionById.get(eventId),
+            sendActionRunEvent: (action) => {
+                this.sent.push(action);
+            },
+        };
+        this.handler = createPlanToolResultMiddleware(this.deps);
+    }
+}
+describe("createPlanToolResultMiddleware: 仅 xg_action_dispatch 分支（plan 已移除）", () => {
+    it("非 action 工具直接放行：不反查、不发", () => {
+        const probe = new Probe();
+        const event = makeToolEvent("xg_plan_write", {
+            result: { details: { ok: true, planId: "p-1" }, content: [] },
+        });
+        assert.equal(probe.handler(event, undefined), undefined);
+        assert.equal(probe.actionById.size, 0);
+        assert.deepEqual(probe.sent, []);
+    });
+    it("details 命中 eventId → 反查并发送", () => {
+        const probe = new Probe();
+        const action = makeAction("e-1");
+        probe.actionById.set("e-1", action);
+        probe.handler(makeToolEvent("xg_action_dispatch", {
+            result: { details: { ok: true, eventId: "e-1" }, content: [] },
+        }), undefined);
+        assert.deepEqual(probe.sent, [action]);
+    });
+    it("回退解析 content[0].text JSON 里的 eventId", () => {
+        const probe = new Probe();
+        const action = makeAction("e-2");
+        probe.actionById.set("e-2", action);
+        probe.handler(makeToolEvent("xg_action_dispatch", {
+            result: { details: undefined, content: [{ type: "text", text: '{"ok":true,"eventId":"e-2"}' }] },
+        }), undefined);
+        assert.deepEqual(probe.sent, [action]);
+    });
+    it("解析不到 eventId → 跳过，不抛", () => {
+        const probe = new Probe();
+        assert.equal(probe.handler(makeToolEvent("xg_action_dispatch", { result: { details: { ok: false }, content: [] } }), undefined), undefined);
+        assert.deepEqual(probe.sent, []);
+    });
+    it("反查不到 action → 跳过，不抛", () => {
+        const probe = new Probe();
+        assert.equal(probe.handler(makeToolEvent("xg_action_dispatch", {
+            result: { details: { ok: true, eventId: "missing" }, content: [] },
+        }), undefined), undefined);
+        assert.deepEqual(probe.sent, []);
+    });
+    it("getActionById 抛异常 → handler 不外抛", () => {
+        const probe = new Probe();
+        probe.deps.getActionById = () => {
+            throw new Error("boom");
+        };
+        assert.equal(probe.handler(makeToolEvent("xg_action_dispatch", {
+            result: { details: { ok: true, eventId: "e-1" }, content: [] },
+        }), undefined), undefined);
+    });
+    it("sendActionRunEvent 抛异常 → handler 不外抛", () => {
+        const probe = new Probe();
+        probe.actionById.set("e-1", makeAction("e-1"));
+        probe.deps.sendActionRunEvent = () => {
+            throw new Error("boom");
+        };
+        assert.equal(probe.handler(makeToolEvent("xg_action_dispatch", {
+            result: { details: { ok: true, eventId: "e-1" }, content: [] },
+        }), undefined), undefined);
+    });
+});
+//# sourceMappingURL=plan-tool-middleware.test.js.map

package/dist/src/plan/plan-tool-middleware.test.js.map

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

package/dist/src/plan/plan-ws-registry.d.ts

@@ -0,0 +1,15 @@
+import type { ImStreamClient } from "../connection/connection.js";
+export interface PlanWsTarget {
+    client: ImStreamClient;
+    replyToMsgId: string;
+}
+/** 按 groupId 覆盖登记（新一轮会话的 client 取代旧的）。 */
+export declare function setPlanWsClient(groupId: string, client: ImStreamClient, replyToMsgId: string): void;
+export declare function getPlanWsClient(groupId: string): PlanWsTarget | undefined;
+/** 账号真正停止时，移除指向该物理 client 的全部群组路由；其他账号路由不受影响。 */
+export declare function removePlanWsClientsByClient(client: ImStreamClient): void;
+/** 测试用：重置模块级缓存 */
+export declare function resetPlanWsRegistryForTest(): void;
+/** 插件卸载/重载时清空计划 WS 登记表。 */
+export declare function disposePlanWsRegistry(): void;
+//# sourceMappingURL=plan-ws-registry.d.ts.map

package/dist/src/plan/plan-ws-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-ws-registry.d.ts","sourceRoot":"","sources":["../../../src/plan/plan-ws-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB;AAiBD,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAKnG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED,iDAAiD;AACjD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAMxE;AAED,kBAAkB;AAClB,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}