@xgjktech/xg_cwork_im 1.19.28 → 1.19.30

package/dist/src/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/action-run-event.test.js.map

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

package/dist/src/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/action-store-access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-store-access.js","sourceRoot":"","sources":["../../src/action-store-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAsBjE,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAElD,IAAI,QAA4B,CAAC;AACjC,IAAI,EAA4B,CAAC;AACjC,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAAC,GAAW;IACzC,QAAQ,GAAG,GAAG,CAAC;IACf,EAAE,EAAE,KAAK,EAAE,CAAC;IACZ,EAAE,GAAG,SAAS,CAAC;IACf,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB;IAC9B,EAAE,EAAE,KAAK,EAAE,CAAC;IACZ,EAAE,GAAG,SAAS,CAAC;IACf,QAAQ,GAAG,SAAS,CAAC;IACrB,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,SAAS,KAAK;IACV,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,6BAA6B,CAAC,CAAC;YACzD,gBAAgB,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,CAAC;QACD,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACrC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,yBAAyB,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;WAChE,KAAK,CAAC,KAAK,KAAK,iBAAiB;WACjC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;WAC9D,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;WAC9D,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;WACxF,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAgB,CAAC;WAC9E,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;WACpE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;WAC/C,OAAQ,OAAmC,CAAC,IAAI,KAAK,QAAQ;WAC5D,OAAmC,CAAC,IAAI,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAkC,CAAC;QACvH,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC1D,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,2BAA2B,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,yBAAyB,OAAO,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,EAAE,EAAE,KAAK,EAAE,CAAC;QACZ,EAAE,GAAG,SAAS,CAAC;QACf,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC"}

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

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

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

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

package/dist/src/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-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/action-store-lifecycle.test.js.map

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

package/dist/src/active-cron-context-store.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_ACTIVE_CRON_TTL_MS: number;
+export type ActiveCronContext = {
+    agentId: string;
+    sessionKey: string;
+    jobId: string;
+    expiresAt: number;
+};
+export declare function setActiveCronContext(input: {
+    agentId: string;
+    sessionKey: string;
+    jobId: string;
+    ttlMs?: number;
+    now?: number;
+}): ActiveCronContext | undefined;
+export declare function getActiveCronContexts(agentId: string, sessionKey: string, now?: number): ActiveCronContext[];
+/** Remove a finished Job from every exact Session mapping. */
+export declare function removeActiveCronContext(jobId: string, agentId?: string): void;
+export declare function disposeActiveCronContextStore(): void;
+export declare function __resetActiveCronContextStoreForTests(): void;
+//# sourceMappingURL=active-cron-context-store.d.ts.map

package/dist/src/active-cron-context-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-cron-context-store.d.ts","sourceRoot":"","sources":["../../src/active-cron-context-store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAEzD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AA8BF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,GAAG,SAAS,CAkBhC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,iBAAiB,EAAE,CAKhH;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D"}

package/dist/src/active-cron-context-store.js

@@ -0,0 +1,73 @@
+/** Process-shared active Cron context for sessionTarget=session:agent:... jobs. */
+import { getOrCreateShared } from "./process-shared-store.js";
+export const DEFAULT_ACTIVE_CRON_TTL_MS = 30 * 60 * 1000;
+function getStore() {
+    return getOrCreateShared("active-cron-context", () => ({
+        bySession: new Map(),
+    }));
+}
+function sessionMapKey(agentId, sessionKey) {
+    return `${agentId.trim().toLowerCase()}\u0000${sessionKey}`;
+}
+function isUsableIdentity(value) {
+    return typeof value === "string" && value.trim().length > 0 && !/[\0\r\n]/.test(value);
+}
+function pruneExpired(now = Date.now()) {
+    const store = getStore();
+    for (const [mapKey, jobs] of store.bySession) {
+        for (const [jobId, context] of jobs) {
+            if (context.expiresAt <= now)
+                jobs.delete(jobId);
+        }
+        if (jobs.size === 0)
+            store.bySession.delete(mapKey);
+    }
+}
+export function setActiveCronContext(input) {
+    if (!isUsableIdentity(input.agentId) || !isUsableIdentity(input.sessionKey) || !isUsableIdentity(input.jobId))
+        return undefined;
+    const now = input.now ?? Date.now();
+    pruneExpired(now);
+    const requestedTtl = typeof input.ttlMs === "number" && Number.isFinite(input.ttlMs) && input.ttlMs > 0
+        ? input.ttlMs
+        : DEFAULT_ACTIVE_CRON_TTL_MS;
+    const context = {
+        agentId: input.agentId.trim(),
+        sessionKey: input.sessionKey,
+        jobId: input.jobId.trim(),
+        expiresAt: now + requestedTtl,
+    };
+    const mapKey = sessionMapKey(context.agentId, context.sessionKey);
+    const jobs = getStore().bySession.get(mapKey) ?? new Map();
+    jobs.set(context.jobId, context);
+    getStore().bySession.set(mapKey, jobs);
+    return { ...context };
+}
+export function getActiveCronContexts(agentId, sessionKey, now = Date.now()) {
+    if (!isUsableIdentity(agentId) || !isUsableIdentity(sessionKey))
+        return [];
+    pruneExpired(now);
+    const jobs = getStore().bySession.get(sessionMapKey(agentId, sessionKey));
+    return jobs ? [...jobs.values()].map((context) => ({ ...context })) : [];
+}
+/** Remove a finished Job from every exact Session mapping. */
+export function removeActiveCronContext(jobId, agentId) {
+    if (!isUsableIdentity(jobId))
+        return;
+    const normalizedAgentId = agentId?.trim().toLowerCase();
+    const store = getStore();
+    for (const [mapKey, jobs] of store.bySession) {
+        if (normalizedAgentId && !mapKey.startsWith(`${normalizedAgentId}\u0000`))
+            continue;
+        jobs.delete(jobId.trim());
+        if (jobs.size === 0)
+            store.bySession.delete(mapKey);
+    }
+}
+export function disposeActiveCronContextStore() {
+    getStore().bySession.clear();
+}
+export function __resetActiveCronContextStoreForTests() {
+    disposeActiveCronContextStore();
+}
+//# sourceMappingURL=active-cron-context-store.js.map

package/dist/src/active-cron-context-store.js.map

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

package/dist/src/active-round-registry.d.ts

@@ -0,0 +1,35 @@
+import type { ImStreamClient } from "./connection.js";
+export interface ActiveRound {
+    roundKey: string;
+    accountId: string;
+    groupId: string;
+    agentId: string;
+    sessionKey: string;
+    replyToMsgId: string;
+    generation: number;
+    streamClient: ImStreamClient;
+    startedAt: number;
+    expiresAt: number;
+    interrupted: boolean;
+}
+export declare const buildRoundKey: (accountId: string, groupId: string) => string;
+export declare function registerActiveRound(params: {
+    accountId: string;
+    groupId: string;
+    agentId: string;
+    sessionKey: string;
+    replyToMsgId: string;
+    streamClient: ImStreamClient;
+    now?: number;
+}): ActiveRound;
+export declare function findActiveRoundForSubagent(groupId: string, now?: number): ActiveRound | undefined;
+/** 按整轮父会话 sessionKey 定位活跃轮次（lifecycle/thinking 等事件路由用）。 */
+export declare function findActiveRoundForSession(sessionKey: string, now?: number): ActiveRound | undefined;
+export declare function getActiveRound(roundKey: string, generation: number): ActiveRound | undefined;
+export declare function roundExists(roundKey: string, generation: number): boolean;
+export declare function prepareActiveRoundInterrupt(accountId: string, groupId: string, now?: number): ActiveRound | undefined;
+export declare function completeActiveRound(roundKey: string, generation: number): boolean;
+export declare function __resetActiveRoundRegistryForTests(): void;
+/** 插件卸载/重载时清空活跃轮次登记。 */
+export declare function disposeActiveRoundRegistry(): void;
+//# sourceMappingURL=active-round-registry.d.ts.map

package/dist/src/active-round-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-round-registry.d.ts","sourceRoot":"","sources":["../../src/active-round-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACxB;AAKD,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,SAAS,MAAM,KAAG,MACI,CAAC;AAQxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,cAAc,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,WAAW,CAqBd;AAED,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,MAAM,EACf,GAAG,SAAa,GACjB,WAAW,GAAG,SAAS,CAWzB;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,WAAW,GAAG,SAAS,CAYvG;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAI5F;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,SAAa,GACjB,WAAW,GAAG,SAAS,CAMzB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKjF;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAED,wBAAwB;AACxB,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}