@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/plan/action-run-event.test.js

@@ -0,0 +1,83 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+import { sendActionRunEvent, toWireAction } from "./action-run-event.js";
+function makeAction(overrides = {}) {
+    return {
+        eventId: "evt-1", event: "action_dispatch", action: "ui_refresh", target: "order_detail",
+        version: 1, status: "completed", payload: { data: { id: "ORD-1" } }, timestamp: "2026-08-13T00:00:00.000Z",
+        ...overrides,
+    };
+}
+function makeRecordingClient() {
+    const calls = [];
+    return {
+        calls,
+        client: {
+            start: async () => { }, streamProgress: async () => { }, streamUsage: async () => { },
+            sendEvent: async (opts) => { calls.push(opts); }, end: async () => { },
+        },
+    };
+}
+beforeEach(() => resetPlanWsRegistryForTest());
+describe("sendActionRunEvent", () => {
+    it("按 origin 路由为 ACTION_DISPATCH，透传精简 action 字段且剥离 origin", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        const action = makeAction({
+            origin: { channel: "xg_cwork_im", to: "g-1", sessionKey: "secret" },
+            payload: {
+                data: {
+                    data: {
+                        target_kind: "ops",
+                        trigger: "user_request",
+                        source: "xg_cwork_im",
+                    },
+                },
+            },
+        });
+        sendActionRunEvent(action);
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].event, "ACTION_DISPATCH");
+        assert.equal(calls[0].groupId, "g-1");
+        assert.equal(calls[0].replyToMsgId, "msg-1");
+        assert.deepEqual(calls[0].data, {
+            eventId: "evt-1",
+            action: "ui_refresh",
+            target: "order_detail",
+            status: "completed",
+            payload: {
+                data: {
+                    target_kind: "ops",
+                    trigger: "user_request",
+                    source: "xg_cwork_im",
+                },
+            },
+            timestamp: "2026-08-13T00:00:00.000Z",
+        });
+        assert.equal(action.origin?.sessionKey, "secret", "不 mutate 入参");
+    });
+    it("缺少当前通道 origin 时不发送", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        assert.doesNotThrow(() => sendActionRunEvent(makeAction()));
+        assert.equal(calls.length, 0);
+    });
+    it("toWireAction 不 mutate 入参", () => {
+        const action = makeAction({ origin: { channel: "xg_cwork_im", to: "g-1" } });
+        const wire = toWireAction(action);
+        assert.equal("origin" in wire, false);
+        assert.equal("event" in wire, false);
+        assert.equal("version" in wire, false);
+        assert.deepEqual(action.origin, { channel: "xg_cwork_im", to: "g-1" });
+    });
+    it("payload.data 含其他字段时不解包，避免丢失上游元数据", () => {
+        const wire = toWireAction(makeAction({
+            payload: { data: { data: { id: "ORD-1" }, source: "upstream" } },
+        }));
+        assert.deepEqual(wire.payload, {
+            data: { data: { id: "ORD-1" }, source: "upstream" },
+        });
+    });
+});
+//# sourceMappingURL=action-run-event.test.js.map

package/dist/src/plan/action-run-event.test.js.map

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

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

@@ -0,0 +1,29 @@
+import type { PlanOrigin } from "@xgjktech/xg-openclaw-shared";
+/** 与 xg-harness-tools 的 ActionDispatchEvent 保持兼容。
+ *
+ * shared 包 0.2.2 尚未导出 action store；因此这里仅实现 IM 所需的只读 get，
+ * 直接读取同一个 SQLite 文件的 actions.doc JSON，绝不创建表或写库。
+ */
+export interface ActionDispatchEvent {
+    eventId: string;
+    event: "action_dispatch";
+    action: string;
+    topic?: string;
+    target: string;
+    version: number;
+    status: "completed" | "running" | "pending" | "failed";
+    scopeControl?: {
+        activeSessionOnly?: boolean;
+    };
+    payload: {
+        data: Record<string, unknown>;
+    };
+    timestamp: string;
+    origin?: PlanOrigin;
+}
+export declare function setActionStateDir(dir: string): void;
+/** 插件卸载/重载时关闭 action SQLite 句柄并清空状态，避免旧模块句柄泄漏。 */
+export declare function disposeActionStore(): void;
+/** 按 eventId 反查权威 action。缺库、旧库、畸形数据和读取异常均降级为 undefined。 */
+export declare function getActionById(eventId: string): ActionDispatchEvent | undefined;
+//# sourceMappingURL=action-store-access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-store-access.d.ts","sourceRoot":"","sources":["../../../src/plan/action-store-access.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,YAAY,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACvB;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC;AAwCD,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAkB9E"}

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

@@ -0,0 +1,81 @@
+import { DatabaseSync } from "node:sqlite";
+import { resolvePlanDbPath } from "@xgjktech/xg-openclaw-shared";
+const LOG_PREFIX = "[xg_cwork_im] [action-store]";
+let stateDir;
+let db;
+let warnedNoStateDir = false;
+export function setActionStateDir(dir) {
+    stateDir = dir;
+    db?.close();
+    db = undefined;
+    warnedNoStateDir = false;
+}
+/** 插件卸载/重载时关闭 action SQLite 句柄并清空状态，避免旧模块句柄泄漏。 */
+export function disposeActionStore() {
+    db?.close();
+    db = undefined;
+    stateDir = undefined;
+    warnedNoStateDir = false;
+}
+function getDb() {
+    if (db)
+        return db;
+    if (!stateDir) {
+        if (!warnedNoStateDir) {
+            console.warn(`${LOG_PREFIX} stateDir 未设置，无法打开 action 库`);
+            warnedNoStateDir = true;
+        }
+        return undefined;
+    }
+    let dbPath = "<unresolved>";
+    try {
+        dbPath = resolvePlanDbPath(stateDir);
+        db = new DatabaseSync(dbPath, { readOnly: true });
+        db.exec("PRAGMA busy_timeout = 5000;");
+        return db;
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 打开 action 库失败 dbPath=${dbPath} 原因=${String(cause)}`);
+        return undefined;
+    }
+}
+function isActionDispatchEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const event = value;
+    const payload = event.payload;
+    return typeof event.eventId === "string" && event.eventId.trim() !== ""
+        && event.event === "action_dispatch"
+        && typeof event.action === "string" && event.action.trim() !== ""
+        && typeof event.target === "string" && event.target.trim() !== ""
+        && typeof event.version === "number" && Number.isFinite(event.version) && event.version > 0
+        && ["completed", "running", "pending", "failed"].includes(event.status)
+        && typeof event.timestamp === "string" && event.timestamp.trim() !== ""
+        && typeof payload === "object" && payload !== null
+        && typeof payload.data === "object"
+        && payload.data !== null;
+}
+/** 按 eventId 反查权威 action。缺库、旧库、畸形数据和读取异常均降级为 undefined。 */
+export function getActionById(eventId) {
+    const handle = getDb();
+    if (!handle)
+        return undefined;
+    try {
+        const row = handle.prepare("SELECT doc FROM actions WHERE event_id = ?").get(eventId);
+        if (!row || typeof row.doc !== "string")
+            return undefined;
+        const action = JSON.parse(row.doc);
+        if (!isActionDispatchEvent(action)) {
+            console.warn(`${LOG_PREFIX} action 文档不符合契约 eventId=${eventId}`);
+            return undefined;
+        }
+        return action;
+    }
+    catch (cause) {
+        console.warn(`${LOG_PREFIX} 读取 action 失败 eventId=${eventId} 原因=${String(cause)}`);
+        db?.close();
+        db = undefined;
+        return undefined;
+    }
+}
+//# sourceMappingURL=action-store-access.js.map

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

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

package/dist/src/plan/action-store-lifecycle.test.d.ts

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

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

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

package/dist/src/plan/action-store-lifecycle.test.js

@@ -0,0 +1,195 @@
+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, describe, it } from "node:test";
+import { resolvePlanDbPath } from "@xgjktech/xg-openclaw-shared";
+import { disposeActionStore, getActionById, setActionStateDir } from "./action-store-access.js";
+import { disposePluginModule } from "../plugin/plugin-dispose.js";
+import { createPlanToolResultMiddleware } from "./plan-tool-middleware.js";
+/**
+ * 动作读库生命周期集成测试（RT-186 根因回归）：
+ * 覆盖「真实 SQLite + 原始读函数(getActionById) + 中间件 + disposePluginModule cleanup」的组合，
+ * 钉住热重载 cleanup 必须保留动作读库配置/句柄，只有 gateway_stop 完整清理才清空。
+ */
+const tempDirs = [];
+function makeTempStateDir() {
+    const dir = mkdtempSync(join(tmpdir(), "xg-action-store-lifecycle-"));
+    tempDirs.push(dir);
+    return dir;
+}
+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-2096919016395612162" },
+        ...overrides,
+    };
+}
+/** 模拟 harness-tools 的 SqliteActionStore.set：独立连接写同一份 plans.sqlite 的 actions 表。 */
+function writeAction(stateDir, action) {
+    const db = new DatabaseSync(resolvePlanDbPath(stateDir));
+    try {
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS actions (
+                event_id TEXT PRIMARY KEY,
+                doc      TEXT NOT NULL
+            ) STRICT;
+        `);
+        db.prepare("INSERT INTO actions (event_id, doc) VALUES (?, ?)").run(action.eventId, JSON.stringify(action));
+    }
+    finally {
+        db.close();
+    }
+}
+/** 与 plan-tool-middleware.test.ts 相同的 event 形状，仅取 xg_action_dispatch 分支所需字段。 */
+function makeActionToolEvent(toolCallId, eventId) {
+    return {
+        toolCallId,
+        toolName: "xg_action_dispatch",
+        args: {},
+        result: { details: { ok: true, eventId }, content: [] },
+    };
+}
+/** 注入真实 getActionById 的中间件探针，记录实际发送的动作。 */
+class DispatchProbe {
+    sent = [];
+    handler;
+    deps;
+    constructor() {
+        this.deps = {
+            getActionById: (eventId) => getActionById(eventId),
+            sendActionRunEvent: (action) => {
+                this.sent.push(action);
+            },
+        };
+        this.handler = createPlanToolResultMiddleware(this.deps);
+    }
+}
+/** 静音 disposePluginModule 的过程日志，并收集 warn 便于断言 stateDir 缺失告警。 */
+async function runDisposeQuietly(options = {}) {
+    const originalLog = console.log;
+    const originalWarn = console.warn;
+    const warns = [];
+    console.log = () => { };
+    console.warn = (...args) => {
+        warns.push(args.map(String).join(" "));
+    };
+    try {
+        await disposePluginModule(options);
+    }
+    finally {
+        console.log = originalLog;
+        console.warn = originalWarn;
+    }
+    return warns;
+}
+function captureWarnLines(fn) {
+    const originalWarn = console.warn;
+    const warns = [];
+    console.warn = (...args) => {
+        warns.push(args.map(String).join(" "));
+    };
+    try {
+        fn();
+    }
+    finally {
+        console.warn = originalWarn;
+    }
+    return warns;
+}
+afterEach(() => {
+    disposeActionStore();
+});
+after(() => {
+    for (const dir of tempDirs) {
+        rmSync(dir, { recursive: true, force: true });
+    }
+});
+describe("动作读库生命周期: 基线（回归 1/5）", () => {
+    it("真实 SQLite 写入 action 后，中间件能按 eventId 反查并恰好发送一次", () => {
+        const stateDir = makeTempStateDir();
+        setActionStateDir(stateDir);
+        const action = makeAction("evt-baseline-1");
+        writeAction(stateDir, action);
+        const probe = new DispatchProbe();
+        probe.handler(makeActionToolEvent("call-baseline-1", action.eventId), { runtime: "openclaw" });
+        assert.equal(probe.sent.length, 1);
+        assert.deepEqual(probe.sent[0], action);
+    });
+    it("写库前 stateDir 未设置 → getActionById 返回 undefined 并告警，不抛", () => {
+        const warns = captureWarnLines(() => {
+            assert.equal(getActionById("evt-missing-config"), undefined);
+        });
+        assert.equal(warns.length, 1);
+        assert.ok(warns[0].includes("stateDir 未设置"));
+    });
+});
+describe("动作读库生命周期: registry cleanup 保留动作读库（回归 2/3/4/5）", () => {
+    it("skipConnections=true + skipPlanResources=true 的 cleanup 后，新写入 action 仍可反查并发送", async () => {
+        const stateDir = makeTempStateDir();
+        setActionStateDir(stateDir);
+        writeAction(stateDir, makeAction("evt-before-cleanup"));
+        assert.ok(getActionById("evt-before-cleanup"), "cleanup 前基线读取应成功");
+        const warns = await runDisposeQuietly({ skipConnections: true, skipPlanResources: true });
+        writeAction(stateDir, makeAction("evt-after-cleanup"));
+        const postAction = getActionById("evt-after-cleanup");
+        assert.ok(postAction, "cleanup 后动作读库必须保留，反查应成功");
+        assert.equal(postAction.eventId, "evt-after-cleanup");
+        assert.equal(warns.filter((line) => line.includes("stateDir 未设置")).length, 0, "热重载 cleanup 后不应出现 stateDir 未设置告警");
+        const probe = new DispatchProbe();
+        probe.handler(makeActionToolEvent("call-after-cleanup", "evt-after-cleanup"), { runtime: "openclaw" });
+        assert.equal(probe.sent.length, 1, "cleanup 后中间件应仍能反查并恰好发送一次");
+        assert.equal(probe.sent[0].eventId, "evt-after-cleanup");
+        probe.handler(makeActionToolEvent("call-before-cleanup", "evt-before-cleanup"), { runtime: "openclaw" });
+        assert.equal(probe.sent.length, 2, "cleanup 前写入的旧 action 也应仍可反查并发送");
+    });
+    it("连续多次 registry cleanup 后仍正常，不出现 stateDir 未设置", async () => {
+        const stateDir = makeTempStateDir();
+        setActionStateDir(stateDir);
+        for (let i = 0; i < 3; i += 1) {
+            writeAction(stateDir, makeAction(`evt-round-${i}`));
+            const warns = await runDisposeQuietly({ skipConnections: true, skipPlanResources: true });
+            const action = getActionById(`evt-round-${i}`);
+            assert.ok(action, `第 ${i + 1} 次 cleanup 后反查应成功`);
+            assert.equal(warns.filter((line) => line.includes("stateDir 未设置")).length, 0, `第 ${i + 1} 次 cleanup 后不应出现 stateDir 未设置告警`);
+        }
+    });
+});
+describe("动作读库生命周期: gateway_stop 完整清理仍清空（回归 6）", () => {
+    it("disposePluginModule() 默认完整清理后，动作读库被关闭且 stateDir 清空", async () => {
+        const stateDir = makeTempStateDir();
+        setActionStateDir(stateDir);
+        const action = makeAction("evt-full-teardown");
+        writeAction(stateDir, action);
+        assert.ok(getActionById(action.eventId), "完整清理前反查应成功");
+        await runDisposeQuietly();
+        const warns = captureWarnLines(() => {
+            assert.equal(getActionById(action.eventId), undefined, "完整清理后读库配置已清空，反查应失败");
+        });
+        assert.equal(warns.length, 1);
+        assert.ok(warns[0].includes("stateDir 未设置"), "完整清理后应重新告警 stateDir 未设置");
+    });
+});
+describe("动作读库生命周期: 更换 stateDir 读取新库并释放旧句柄（回归 7）", () => {
+    it("setActionStateDir 切到新目录后读新库，旧库记录不可再读", () => {
+        const dirA = makeTempStateDir();
+        setActionStateDir(dirA);
+        writeAction(dirA, makeAction("evt-dir-a"));
+        assert.ok(getActionById("evt-dir-a"), "旧目录记录应可读");
+        const dirB = makeTempStateDir();
+        setActionStateDir(dirB);
+        writeAction(dirB, makeAction("evt-dir-b"));
+        assert.ok(getActionById("evt-dir-b"), "切到新目录后应读取新库");
+        assert.equal(getActionById("evt-dir-a"), undefined, "旧目录记录不在新库中，反查应为 undefined");
+    });
+});
+//# sourceMappingURL=action-store-lifecycle.test.js.map

package/dist/src/plan/action-store-lifecycle.test.js.map

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

package/dist/src/plan/plan-core-adapter.d.ts

@@ -0,0 +1,54 @@
+import type { Plan, TaskStatus } from "@xgjktech/xg-openclaw-shared";
+/** 每条 core 计划步骤的入参形态（progress_card 事件 steps 可能为旧版 string[]）。 */
+export type CorePlanStepInput = string | {
+    step?: string;
+    status?: string;
+};
+export type CorePlanUpdatePayload = {
+    phase?: string;
+    title?: string;
+    explanation?: string;
+    steps?: readonly CorePlanStepInput[];
+    source?: string;
+};
+/** 归一化后的 core 步骤。 */
+export type CorePlanStep = {
+    step: string;
+    status: TaskStatus;
+};
+/** 发往前端的 plan：在共享 Plan 基础上带 core progress_card 的 markdown 原文。 */
+export type WirePlan = Plan & {
+    markdown?: string;
+};
+/** 按 sessionKey 派生稳定的 planId（前端按 planId 覆盖/去重依赖稳定 id）。 */
+export declare function buildCorePlanId(sessionKey: string): string;
+export declare function normalizeCorePlanSteps(steps: readonly CorePlanStepInput[] | undefined): CorePlanStep[];
+/** 取或记录首次观察到该会话计划的时间（进程内记忆，跨重启由 DB 快照补 createdAt）。 */
+export declare function resolveCorePlanCreatedAt(sessionKey: string, nowMs: number, createdAtIso?: string): string;
+/** 仅测试用：清空进程内 firstSeen 记忆。 */
+export declare function resetCorePlanFirstSeenForTest(): void;
+/** 组装带内部 origin 的 Plan；core steps 为空时不产计划（纯 markdown 或清空，交由快照/后续事件决定）。 */
+export declare function buildPlanFromCoreUpdate(params: {
+    sessionKey: string;
+    groupId: string;
+    payload: CorePlanUpdatePayload;
+    accountId?: string;
+    nowMs?: number;
+    /** DB 回放时用落库的创建时间，进程内 firstSeen 不再生效。 */
+    createdAtIso?: string;
+    /** core progress_card 的 markdown 原文（原样透传，不 strip/截断/摘要）。 */
+    markdown?: string;
+}): WirePlan | undefined;
+/**
+ * progress_card 事件 → PLAN_STAT 增量（source:"tool"）。
+ * 绝不抛（sendPlanStat 本身 fire-and-forget，内部已 catch）。
+ */
+export declare function handleCorePlanUpdate(params: {
+    sessionKey: string;
+    groupId: string;
+    payload: CorePlanUpdatePayload;
+    accountId?: string;
+    /** core progress_card 的 markdown 原文。 */
+    markdown?: string;
+}): void;
+//# sourceMappingURL=plan-core-adapter.d.ts.map

package/dist/src/plan/plan-core-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-core-adapter.d.ts","sourceRoot":"","sources":["../../../src/plan/plan-core-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAoB,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAYvF,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,qBAAqB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAqB;AACrB,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEhE,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,GAChD,YAAY,EAAE,CAuBhB;AAID,sDAAsD;AACtD,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACtB,MAAM,CAUR;AAED,+BAA+B;AAC/B,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,QAAQ,GAAG,SAAS,CA+BvB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAUP"}

package/dist/src/plan/plan-core-adapter.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import { sendPlanStat } from "./plan-stat-event.js";
+const LOG_PREFIX = "[xg_cwork_im] [plan-core-adapter]";
+const CORE_PLAN_STATUSES = new Set(["pending", "in_progress", "completed"]);
+const FALLBACK_PLAN_GOAL = "任务执行计划";
+/** progress_card 的 explanation 形如 "2/5 complete"，不是 goal，需回退。 */
+const COMPLETION_ONLY_EXPLANATION_RE = /^\d+\/\d+\s+complete$/i;
+/** 按 sessionKey 派生稳定的 planId（前端按 planId 覆盖/去重依赖稳定 id）。 */
+export function buildCorePlanId(sessionKey) {
+    const digest = createHash("sha256").update(`core-plan:${sessionKey}`).digest("hex");
+    return `core-${digest.slice(0, 16)}`;
+}
+export function normalizeCorePlanSteps(steps) {
+    if (!Array.isArray(steps)) {
+        return [];
+    }
+    const out = [];
+    for (const entry of steps) {
+        if (typeof entry === "string") {
+            const step = entry.trim();
+            if (step)
+                out.push({ step, status: "pending" });
+            continue;
+        }
+        if (!entry || typeof entry !== "object") {
+            continue;
+        }
+        const step = typeof entry.step === "string" ? entry.step.trim() : "";
+        const rawStatus = typeof entry.status === "string" ? entry.status : "";
+        if (!step)
+            continue;
+        const status = CORE_PLAN_STATUSES.has(rawStatus)
+            ? rawStatus
+            : "pending";
+        out.push({ step, status });
+    }
+    return out;
+}
+const firstSeenBySession = new Map();
+/** 取或记录首次观察到该会话计划的时间（进程内记忆，跨重启由 DB 快照补 createdAt）。 */
+export function resolveCorePlanCreatedAt(sessionKey, nowMs, createdAtIso) {
+    if (createdAtIso) {
+        return createdAtIso;
+    }
+    const existing = firstSeenBySession.get(sessionKey);
+    if (existing !== undefined) {
+        return new Date(existing).toISOString();
+    }
+    firstSeenBySession.set(sessionKey, nowMs);
+    return new Date(nowMs).toISOString();
+}
+/** 仅测试用：清空进程内 firstSeen 记忆。 */
+export function resetCorePlanFirstSeenForTest() {
+    firstSeenBySession.clear();
+}
+/** 组装带内部 origin 的 Plan；core steps 为空时不产计划（纯 markdown 或清空，交由快照/后续事件决定）。 */
+export function buildPlanFromCoreUpdate(params) {
+    const { sessionKey, groupId, payload, accountId, createdAtIso, markdown } = params;
+    const nowMs = params.nowMs ?? Date.now();
+    const steps = normalizeCorePlanSteps(payload.steps);
+    if (steps.length === 0) {
+        return undefined;
+    }
+    const tasks = steps.map((step) => ({
+        title: step.step,
+        status: step.status,
+    }));
+    const explanation = typeof payload.explanation === "string" ? payload.explanation.trim() : "";
+    const goal = explanation && !COMPLETION_ONLY_EXPLANATION_RE.test(explanation)
+        ? explanation
+        : FALLBACK_PLAN_GOAL;
+    const origin = {
+        channel: "xg_cwork_im",
+        to: groupId,
+        sessionKey,
+        ...(accountId ? { accountId } : {}),
+    };
+    return {
+        planId: buildCorePlanId(sessionKey),
+        goal,
+        createdAt: resolveCorePlanCreatedAt(sessionKey, nowMs, createdAtIso),
+        updatedAt: new Date(nowMs).toISOString(),
+        tasks,
+        origin,
+        ...(markdown && markdown.trim() ? { markdown } : {}),
+    };
+}
+/**
+ * progress_card 事件 → PLAN_STAT 增量（source:"tool"）。
+ * 绝不抛（sendPlanStat 本身 fire-and-forget，内部已 catch）。
+ */
+export function handleCorePlanUpdate(params) {
+    try {
+        const plan = buildPlanFromCoreUpdate(params);
+        if (!plan) {
+            return;
+        }
+        sendPlanStat({ plan, source: "tool" });
+    }
+    catch (err) {
+        console.warn(`${LOG_PREFIX} adapter 内部异常已吞: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=plan-core-adapter.js.map

package/dist/src/plan/plan-core-adapter.js.map

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

package/dist/src/plan/plan-core-adapter.test.d.ts

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

package/dist/src/plan/plan-core-adapter.test.d.ts.map

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