@xgjktech/xg_cwork_im 1.19.22 → 1.19.23

package/dist/src/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-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,25 @@
+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;
+/** 插件卸载/重载时释放计划库只读句柄与 stateDir（shared 句柄无 close，释放引用即可）。 */
+export declare function disposePlanStore(): 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,CAElD;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;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"}

package/dist/src/plan-store-access.js

@@ -0,0 +1,100 @@
+import { openPlanStoreReadonly, resolvePlanDbPath } from "@xgjktech/xg-openclaw-shared";
+const LOG_PREFIX = "[xg_cwork_im] [plan-store]";
+let stateDir;
+let handle;
+let warnedNoStateDir = false;
+/** 注入 stateDir（来自 api.runtime.state.resolveStateDir()）。register(api) 时调用一次。 */
+export function setPlanStateDir(dir) {
+    stateDir = dir;
+    handle = undefined;
+    warnedNoStateDir = false;
+}
+/** 测试用：重置模块级缓存与 stateDir */
+export function resetPlanStoreAccessForTest() {
+    disposePlanStore();
+}
+/** 插件卸载/重载时释放计划库只读句柄与 stateDir（shared 句柄无 close，释放引用即可）。 */
+export function disposePlanStore() {
+    stateDir = undefined;
+    handle = undefined;
+    warnedNoStateDir = false;
+}
+function getHandle() {
+    if (handle) {
+        return handle;
+    }
+    if (!stateDir) {
+        if (!warnedNoStateDir) {
+            console.warn(`${LOG_PREFIX} stateDir 未设置，无法打开计划库`);
+            warnedNoStateDir = true;
+        }
+        return undefined;
+    }
+    let dbPath = "<unresolved>";
+    try {
+        dbPath = resolvePlanDbPath(stateDir);
+        handle = openPlanStoreReadonly(dbPath);
+        return handle;
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 打开计划库失败 dbPath=${dbPath} 原因=${String(cause)}`);
+        return undefined;
+    }
+}
+/**
+ * 按 planId 反查完整计划。
+ * 库不存在 / 打开失败 / 读取异常 → 返回 undefined 并记 warn 日志，绝不抛。
+ */
+export function getPlanById(planId) {
+    const h = getHandle();
+    if (!h) {
+        return undefined;
+    }
+    try {
+        return h.get(planId);
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 读取 plan 失败 planId=${planId} 原因=${String(cause)}`);
+        handle = undefined;
+        return undefined;
+    }
+}
+/**
+ * 列出全部计划摘要（重启恢复用）。
+ * 异常同上 → 返回空数组，绝不抛。
+ */
+export function listPlanSummaries() {
+    const h = getHandle();
+    if (!h) {
+        return [];
+    }
+    try {
+        return h.list();
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 列出 plan 列表失败 原因=${String(cause)}`);
+        handle = undefined;
+        return [];
+    }
+}
+/**
+ * 按来源会话（channel + to）反查全量 plan（WS 快照用）。
+ * shared 侧只读实现已内置"旧库缺 origin 列 → 返回 []"的探测降级；
+ * 这里叠加本文件既有的句柄级降级纪律：拿不到句柄 / 查询异常 → 记 warn、返回 []、绝不抛、
+ * 失败时清空句柄缓存（与 getPlanById 同款，供后续调用重试恢复）。
+ */
+export function listPlansByOrigin(channel, to) {
+    const h = getHandle();
+    if (!h) {
+        return [];
+    }
+    try {
+        return h.listPlansByOrigin({ channel, to });
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 按 origin 列出 plan 失败 channel=${channel} to=${to} 原因=${String(cause)}`);
+        handle = undefined;
+        return [];
+    }
+}
+//# sourceMappingURL=plan-store-access.js.map

package/dist/src/plan-store-access.js.map

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

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

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

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

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

package/dist/src/plan-store-access.test.js

@@ -0,0 +1,207 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { after, afterEach, beforeEach, describe, it } from "node:test";
+import { resolvePlanDbPath, SqlitePlanStore } from "@xgjktech/xg-openclaw-shared";
+import { getPlanById, listPlanSummaries, listPlansByOrigin, resetPlanStoreAccessForTest, setPlanStateDir, } from "./plan-store-access.js";
+const tempDirs = [];
+function makeTempStateDir() {
+    const dir = mkdtempSync(join(tmpdir(), "xg-plan-store-access-test-"));
+    tempDirs.push(dir);
+    return dir;
+}
+function makePlan(overrides = {}) {
+    return {
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [],
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    resetPlanStoreAccessForTest();
+});
+afterEach(() => {
+    resetPlanStoreAccessForTest();
+});
+after(() => {
+    for (const dir of tempDirs) {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+describe("getPlanById / listPlanSummaries: 缺库降级 (F4)", () => {
+    it("returns undefined / [] without throwing when plans.sqlite does not exist", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        assert.equal(getPlanById("x"), undefined);
+        assert.deepEqual(listPlanSummaries(), []);
+    });
+});
+describe("getPlanById: 后建库恢复 (F5)", () => {
+    it("recovers once the harness plugin later creates and writes the db, without resetting module state", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        // T1: 库不存在时先调用一次，期望降级为 undefined 且不缓存失败
+        assert.equal(getPlanById("plan-1"), undefined);
+        // T2: harness 侧后建库并写入
+        const dbPath = resolvePlanDbPath(stateDir);
+        const writer = new SqlitePlanStore(dbPath);
+        writer.set(makePlan({ planId: "plan-1", goal: "后建库恢复" }));
+        writer.close();
+        // T3: 不重置模块状态，再次调用应能读到（验证未缓存"打开失败"）
+        const plan = getPlanById("plan-1");
+        assert.ok(plan);
+        assert.equal(plan.planId, "plan-1");
+        assert.equal(plan.goal, "后建库恢复");
+    });
+});
+describe("getPlanById: 正常反查", () => {
+    it("round-trips a plan with blocked task (note) and steps", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        const dbPath = resolvePlanDbPath(stateDir);
+        const writer = new SqlitePlanStore(dbPath);
+        writer.set(makePlan({
+            planId: "plan-2",
+            goal: "带阻塞任务的计划",
+            tasks: [
+                {
+                    title: "备份旧配置",
+                    status: "blocked",
+                    note: "缺少权限",
+                    steps: [{ text: "导出 json", status: "completed" }],
+                },
+                { title: "校验数据", status: "pending" },
+            ],
+        }));
+        writer.close();
+        const plan = getPlanById("plan-2");
+        assert.ok(plan);
+        assert.equal(plan.goal, "带阻塞任务的计划");
+        assert.equal(plan.tasks.length, 2);
+        assert.equal(plan.tasks[0].status, "blocked");
+        assert.equal(plan.tasks[0].note, "缺少权限");
+        assert.deepEqual(plan.tasks[0].steps, [{ text: "导出 json", status: "completed" }]);
+        assert.equal(plan.tasks[1].status, "pending");
+    });
+    it("returns undefined for an unknown planId (normal case, not an error)", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        const dbPath = resolvePlanDbPath(stateDir);
+        const writer = new SqlitePlanStore(dbPath);
+        writer.set(makePlan({ planId: "plan-exists" }));
+        writer.close();
+        assert.equal(getPlanById("plan-does-not-exist"), undefined);
+    });
+});
+describe("listPlanSummaries", () => {
+    it("lists all plans with correct taskCounts", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        const dbPath = resolvePlanDbPath(stateDir);
+        const writer = new SqlitePlanStore(dbPath);
+        writer.set(makePlan({
+            planId: "plan-a",
+            goal: "计划 A",
+            tasks: [
+                { title: "t1", status: "completed" },
+                { title: "t2", status: "blocked", note: "n" },
+                { title: "t3", status: "in_progress" },
+                { title: "t4", status: "pending" },
+            ],
+        }));
+        writer.set(makePlan({
+            planId: "plan-b",
+            goal: "计划 B",
+            tasks: [{ title: "t1", status: "completed" }],
+        }));
+        writer.close();
+        const summaries = listPlanSummaries();
+        assert.equal(summaries.length, 2);
+        const byId = new Map(summaries.map((s) => [s.planId, s]));
+        const a = byId.get("plan-a");
+        assert.ok(a);
+        assert.deepEqual(a.taskCounts, { total: 4, completed: 1, blocked: 1, inProgress: 1 });
+        const b = byId.get("plan-b");
+        assert.ok(b);
+        assert.deepEqual(b.taskCounts, { total: 1, completed: 1, blocked: 0, inProgress: 0 });
+    });
+});
+describe("未设置 stateDir", () => {
+    it("getPlanById returns undefined without throwing", () => {
+        assert.equal(getPlanById("x"), undefined);
+        assert.deepEqual(listPlanSummaries(), []);
+    });
+});
+/** 手工建一个 v1（无 origin 列）的 plans 表，模拟旧库升级前的真实状态（同 shared TASK-2x-1 手法）。 */
+function createV1Schema(dbPath) {
+    const db = new DatabaseSync(dbPath);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS plans (
+            plan_id     TEXT PRIMARY KEY,
+            goal        TEXT NOT NULL,
+            created_at  TEXT NOT NULL,
+            updated_at  TEXT NOT NULL,
+            doc         TEXT NOT NULL
+        ) STRICT;
+    `);
+    db.exec("CREATE INDEX IF NOT EXISTS idx_plans_updated_at ON plans(updated_at);");
+    db.exec("PRAGMA user_version = 1;");
+    db.close();
+}
+function insertV1Row(dbPath, plan) {
+    const db = new DatabaseSync(dbPath);
+    db.prepare(`INSERT INTO plans (plan_id, goal, created_at, updated_at, doc)
+         VALUES (@planId, @goal, @createdAt, @updatedAt, @doc)`).run({
+        planId: plan.planId,
+        goal: plan.goal,
+        createdAt: plan.createdAt,
+        updatedAt: plan.updatedAt,
+        doc: JSON.stringify(plan),
+    });
+    db.close();
+}
+describe("listPlansByOrigin", () => {
+    it("真实临时库 + 多条 plan → 只返回匹配的", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        const dbPath = resolvePlanDbPath(stateDir);
+        const writer = new SqlitePlanStore(dbPath);
+        writer.set(makePlan({
+            planId: "plan-g1",
+            origin: { channel: "xg_cwork_im", to: "g-1" },
+        }));
+        writer.set(makePlan({
+            planId: "plan-g2",
+            origin: { channel: "xg_cwork_im", to: "g-2" },
+        }));
+        writer.set(makePlan({ planId: "plan-no-origin" }));
+        writer.close();
+        const results = listPlansByOrigin("xg_cwork_im", "g-1");
+        assert.equal(results.length, 1);
+        assert.equal(results[0].planId, "plan-g1");
+    });
+    it("🔴 旧版库（无 origin 列，手工建 v1 表）→ 返回 [] 不抛", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        const dbPath = resolvePlanDbPath(stateDir);
+        createV1Schema(dbPath);
+        insertV1Row(dbPath, makePlan({ planId: "plan-old" }));
+        assert.doesNotThrow(() => {
+            const results = listPlansByOrigin("xg_cwork_im", "g-1");
+            assert.deepEqual(results, []);
+        });
+    });
+    it("缺库 → 返回 [] 不抛", () => {
+        const stateDir = makeTempStateDir();
+        setPlanStateDir(stateDir);
+        assert.doesNotThrow(() => {
+            assert.deepEqual(listPlansByOrigin("xg_cwork_im", "g-1"), []);
+        });
+    });
+});
+//# sourceMappingURL=plan-store-access.test.js.map

package/dist/src/plan-store-access.test.js.map

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

package/dist/src/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-tool-middleware.d.ts.map

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

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

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

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

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