@xgjktech/xg_cwork_im 1.16.44 → 1.17.0

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

@@ -0,0 +1,257 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createPlanEventHandler } from "./plan-event-subscription.js";
+const FAKE_CTX = {
+    getRunContext: () => undefined,
+    setRunContext: () => { },
+    clearRunContext: () => { },
+};
+function makeBlockedPayload(overrides = {}) {
+    return {
+        kind: "plan_update",
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        action: "advance",
+        taskIndex: 0,
+        taskTitle: "备份旧配置",
+        taskStatus: "blocked",
+        blockedNote: "缺少权限",
+        summary: { total: 3, completed: 1, blocked: 1, inProgress: 0 },
+        runId: "run-1",
+        ...overrides,
+    };
+}
+class RecordingSendText {
+    calls = [];
+    impl = async (groupId, content) => {
+        this.calls.push({ groupId, content });
+    };
+    sendText = (groupId, content) => this.impl(groupId, content);
+}
+describe("createPlanEventHandler: isPlanEventPayload 守卫", () => {
+    it("rejects malformed data without pushing or throwing", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: { kind: "not_plan_update" },
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("rejects when data is not an object at all", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: null,
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("rejects a payload that violates kind only — everything else (routing + copy fields) is valid (pins the guard)", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                kind: "some_other_plugin_event", // 唯一的不合法项
+                deliveryContext: { to: "group-1" },
+            }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("rejects a payload with a malformed summary — everything else is valid", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                summary: {},
+                deliveryContext: { to: "group-1" },
+            }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(recorder.calls.length, 0);
+    });
+});
+describe("createPlanEventHandler: 路由字段取自 event.data 而非顶层", () => {
+    it("uses deliveryContext.to from event.data, ignoring a same-shaped decoy on the top-level event", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            sessionKey: "decoy-top-level-session-key",
+            // 顶层伪造一个同名但不存在于真实 AgentEventPayload 上的字段，确认代码不会误取
+            deliveryContext: { to: "decoy-top-level-group" },
+            data: makeBlockedPayload({ deliveryContext: { to: "real-group-from-data" } }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 1);
+        assert.equal(recorder.calls[0].groupId, "real-group-from-data");
+    });
+});
+describe("createPlanEventHandler: blocked payload 推送", () => {
+    it("assembles the spec §1.3 copy and calls sendText", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: "group-1" },
+                goal: "迁移配置到新版本",
+                taskTitle: "备份旧配置",
+                blockedNote: "缺少权限",
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 1);
+        assert.equal(recorder.calls[0].groupId, "group-1");
+        assert.equal(recorder.calls[0].content, "计划「迁移配置到新版本」卡在任务「备份旧配置」：缺少权限\n需要人工介入才能继续。");
+    });
+    it("does not push for non-blocked task status", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: "group-1" },
+                taskStatus: "completed",
+                blockedNote: undefined,
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when no delivery target can be resolved", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(), // 无 deliveryContext/agentAccountId/messageChannel/sessionKey
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when taskStatus is not blocked, even if blockedNote still carries a stale value (pins the taskStatus check)", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: "group-1" },
+                taskStatus: "completed",
+                blockedNote: "缺少权限", // 上游残留的旧阻塞原因，taskStatus 已不再是 blocked
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when deliveryContext.to is an empty string, everything else valid (pins the empty-string check)", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: "" },
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when deliveryContext.to is not a string", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: 123 },
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when deliveryContext itself is not an object", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: "not-an-object",
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+    it("does not push when blockedNote is whitespace-only, everything else valid (pins the trim/blank check)", async () => {
+        const recorder = new RecordingSendText();
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({
+                deliveryContext: { to: "group-1" },
+                blockedNote: "   ",
+            }),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(recorder.calls.length, 0);
+    });
+});
+describe("createPlanEventHandler: handle 内部出错不外泄", () => {
+    it("resolves normally even when sendText rejects", async () => {
+        const recorder = new RecordingSendText();
+        recorder.impl = async () => {
+            throw new Error("boom");
+        };
+        const handle = createPlanEventHandler({ sendText: recorder.sendText });
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ deliveryContext: { to: "group-1" } }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+    });
+});
+//# sourceMappingURL=plan-event-subscription.test.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { BlockedTaskNotice } from "./plan-blocked-notice.js";
+export interface ToolCallTarget {
+    groupId: string;
+    token: string;
+    sessionKey?: string;
+}
+/** 测试用：替换时间源，避免测 TTL 时 sleep。 */
+export declare function setNowFnForTest(fn: () => number): void;
+export declare function registerToolCallTarget(toolCallId: string, target: ToolCallTarget): void;
+/** 取出并删除（一次性消费）。未命中返回 undefined。 */
+export declare function takeToolCallTarget(toolCallId: string): ToolCallTarget | undefined;
+/**
+ * 传入本次扫描出的全部 notice，返回其中「需要推送的新增项」，并同步更新集合。
+ *
+ * 语义（按 DESIGN.md D2）：
+ * - 新增 = 本次 keys − 已推送 keys → 返回它们
+ * - 清理 = 已推送集中「本次已不在」的 key → 移除（让 blocked→修复→再 blocked 能重新推）
+ * - 已推送集 = 已推送 ∪ 新增
+ * - 按 planId 分桶
+ */
+export declare function diffAndMarkBlockedNotices(planId: string, notices: readonly BlockedTaskNotice[]): BlockedTaskNotice[];
+/** 测试用：重置模块级缓存与 stateDir */
+export declare function resetPlanSessionRegistryForTest(): void;
+//# sourceMappingURL=plan-session-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-session-registry.d.ts","sourceRoot":"","sources":["../../src/plan-session-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,MAAM,GAAG,IAAI,CAEtD;AA0BD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAMvF;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAUjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACtC,iBAAiB,EAAE,CAsBrB;AAED,4BAA4B;AAC5B,wBAAgB,+BAA+B,IAAI,IAAI,CAItD"}

package/dist/src/plan-session-registry.js

@@ -0,0 +1,84 @@
+/** toolCallId → 投递目标表的 TTL：超过这个时长未被消费的登记视为过期。 */
+const TOOL_CALL_TARGET_TTL_MS = 10 * 60 * 1000;
+/** toolCallId → 投递目标表的容量上限：超出时逐出最旧的条目（插入序）。 */
+const TOOL_CALL_TARGET_CAPACITY = 500;
+let nowFn = () => Date.now();
+/** 测试用：替换时间源，避免测 TTL 时 sleep。 */
+export function setNowFnForTest(fn) {
+    nowFn = fn;
+}
+const toolCallTargets = new Map();
+/** planId → 已推送 blocked notice key 集合 */
+const blockedNotifiedKeys = new Map();
+function evictExpiredToolCallTargets() {
+    const now = nowFn();
+    for (const [toolCallId, entry] of toolCallTargets) {
+        if (now - entry.registeredAt > TOOL_CALL_TARGET_TTL_MS) {
+            toolCallTargets.delete(toolCallId);
+        }
+    }
+}
+function evictOldestToolCallTargetsOverCapacity() {
+    while (toolCallTargets.size > TOOL_CALL_TARGET_CAPACITY) {
+        const oldestKey = toolCallTargets.keys().next().value;
+        if (oldestKey === undefined) {
+            break;
+        }
+        toolCallTargets.delete(oldestKey);
+    }
+}
+export function registerToolCallTarget(toolCallId, target) {
+    evictExpiredToolCallTargets();
+    // 重新登记同一 id 应刷新插入序（视为新条目），先删再插
+    toolCallTargets.delete(toolCallId);
+    toolCallTargets.set(toolCallId, { target, registeredAt: nowFn() });
+    evictOldestToolCallTargetsOverCapacity();
+}
+/** 取出并删除（一次性消费）。未命中返回 undefined。 */
+export function takeToolCallTarget(toolCallId) {
+    const entry = toolCallTargets.get(toolCallId);
+    if (!entry) {
+        return undefined;
+    }
+    toolCallTargets.delete(toolCallId);
+    if (nowFn() - entry.registeredAt > TOOL_CALL_TARGET_TTL_MS) {
+        return undefined;
+    }
+    return entry.target;
+}
+/**
+ * 传入本次扫描出的全部 notice，返回其中「需要推送的新增项」，并同步更新集合。
+ *
+ * 语义（按 DESIGN.md D2）：
+ * - 新增 = 本次 keys − 已推送 keys → 返回它们
+ * - 清理 = 已推送集中「本次已不在」的 key → 移除（让 blocked→修复→再 blocked 能重新推）
+ * - 已推送集 = 已推送 ∪ 新增
+ * - 按 planId 分桶
+ */
+export function diffAndMarkBlockedNotices(planId, notices) {
+    const notified = blockedNotifiedKeys.get(planId) ?? new Set();
+    const currentKeys = new Set(notices.map((n) => n.key));
+    const fresh = notices.filter((n) => !notified.has(n.key));
+    for (const key of notified) {
+        if (!currentKeys.has(key)) {
+            notified.delete(key);
+        }
+    }
+    for (const notice of fresh) {
+        notified.add(notice.key);
+    }
+    if (notified.size > 0) {
+        blockedNotifiedKeys.set(planId, notified);
+    }
+    else {
+        blockedNotifiedKeys.delete(planId);
+    }
+    return fresh;
+}
+/** 测试用：重置模块级缓存与 stateDir */
+export function resetPlanSessionRegistryForTest() {
+    toolCallTargets.clear();
+    blockedNotifiedKeys.clear();
+    nowFn = () => Date.now();
+}
+//# sourceMappingURL=plan-session-registry.js.map

package/dist/src/plan-session-registry.js.map

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

package/dist/src/plan-session-registry.test.d.ts

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

package/dist/src/plan-session-registry.test.d.ts.map

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

package/dist/src/plan-session-registry.test.js

@@ -0,0 +1,109 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { diffAndMarkBlockedNotices, registerToolCallTarget, resetPlanSessionRegistryForTest, setNowFnForTest, takeToolCallTarget, } from "./plan-session-registry.js";
+function makeTarget(overrides = {}) {
+    return {
+        groupId: "group-1",
+        token: "token-1",
+        ...overrides,
+    };
+}
+function makeNotice(overrides = {}) {
+    return {
+        key: "plan-1::0::缺少权限",
+        taskIndex: 0,
+        taskTitle: "备份旧配置",
+        note: "缺少权限",
+        content: "计划「X」卡在任务「备份旧配置」：缺少权限\n需要人工介入才能继续。",
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    resetPlanSessionRegistryForTest();
+});
+describe("registerToolCallTarget / takeToolCallTarget", () => {
+    it("hits with the registered target and deletes it on consume (take twice → second undefined)", () => {
+        registerToolCallTarget("call-1", makeTarget());
+        const first = takeToolCallTarget("call-1");
+        assert.deepEqual(first, makeTarget());
+        const second = takeToolCallTarget("call-1");
+        assert.equal(second, undefined);
+    });
+    it("misses for an unregistered id", () => {
+        assert.equal(takeToolCallTarget("does-not-exist"), undefined);
+    });
+    it("expires entries past TTL (injected now, no sleep)", () => {
+        let t = 0;
+        setNowFnForTest(() => t);
+        registerToolCallTarget("call-ttl", makeTarget());
+        t = 10 * 60 * 1000 + 1; // TTL + 1ms
+        assert.equal(takeToolCallTarget("call-ttl"), undefined);
+    });
+    it("does not expire an entry read exactly at TTL boundary", () => {
+        let t = 0;
+        setNowFnForTest(() => t);
+        registerToolCallTarget("call-boundary", makeTarget());
+        t = 10 * 60 * 1000; // exactly TTL, not yet exceeded
+        assert.ok(takeToolCallTarget("call-boundary"));
+    });
+    it("evicts the oldest entry when capacity is exceeded", () => {
+        let t = 0;
+        setNowFnForTest(() => t);
+        for (let i = 0; i < 500; i++) {
+            t += 1;
+            registerToolCallTarget(`call-${i}`, makeTarget({ groupId: `g${i}` }));
+        }
+        // 表已满 500 条，call-0 是最旧的
+        t += 1;
+        registerToolCallTarget("call-500", makeTarget({ groupId: "g500" }));
+        assert.equal(takeToolCallTarget("call-0"), undefined, "oldest entry should have been evicted");
+        const kept = takeToolCallTarget("call-500");
+        assert.ok(kept);
+        assert.equal(kept.groupId, "g500");
+    });
+});
+describe("diffAndMarkBlockedNotices", () => {
+    it("returns all notices on first call", () => {
+        const notices = [makeNotice()];
+        const fresh = diffAndMarkBlockedNotices("plan-1", notices);
+        assert.deepEqual(fresh, notices);
+    });
+    it("returns empty on repeated identical call", () => {
+        const notices = [makeNotice()];
+        diffAndMarkBlockedNotices("plan-1", notices);
+        const second = diffAndMarkBlockedNotices("plan-1", notices);
+        assert.deepEqual(second, []);
+    });
+    it("treats a note change as a new notification (different key)", () => {
+        const first = [makeNotice({ key: "plan-1::0::缺少权限" })];
+        diffAndMarkBlockedNotices("plan-1", first);
+        const changed = [makeNotice({ key: "plan-1::0::权限问题已升级", note: "权限问题已升级" })];
+        const fresh = diffAndMarkBlockedNotices("plan-1", changed);
+        assert.deepEqual(fresh, changed);
+    });
+    it("clears a key once the task is no longer blocked, allowing re-notification later", () => {
+        const notice = makeNotice({ key: "plan-1::0::缺少权限" });
+        diffAndMarkBlockedNotices("plan-1", [notice]);
+        // task 修复：本次扫描不再含该 key
+        const clearedFresh = diffAndMarkBlockedNotices("plan-1", []);
+        assert.deepEqual(clearedFresh, []);
+        // 再次 blocked，同 key 应视为新增重新推送
+        const reblocked = diffAndMarkBlockedNotices("plan-1", [notice]);
+        assert.deepEqual(reblocked, [notice]);
+    });
+    it("keeps separate planIds independent", () => {
+        const noticeA = makeNotice({ key: "plan-a::0::原因A" });
+        const noticeB = makeNotice({ key: "plan-b::0::原因B" });
+        const freshA = diffAndMarkBlockedNotices("plan-a", [noticeA]);
+        const freshB = diffAndMarkBlockedNotices("plan-b", [noticeB]);
+        assert.deepEqual(freshA, [noticeA]);
+        assert.deepEqual(freshB, [noticeB]);
+        // plan-a 重复调用不应受 plan-b 影响，反之亦然
+        assert.deepEqual(diffAndMarkBlockedNotices("plan-a", [noticeA]), []);
+        assert.deepEqual(diffAndMarkBlockedNotices("plan-b", [noticeB]), []);
+    });
+    it("returns an empty array and does not throw when there are no notices", () => {
+        assert.deepEqual(diffAndMarkBlockedNotices("plan-empty", []), []);
+    });
+});
+//# sourceMappingURL=plan-session-registry.test.js.map

package/dist/src/plan-session-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-session-registry.test.js","sourceRoot":"","sources":["../../src/plan-session-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EACH,yBAAyB,EACzB,sBAAsB,EACtB,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,SAAS,UAAU,CAAC,YAA8E,EAAE;IAChG,OAAO;QACH,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,YAAwC,EAAE;IAC1D,OAAO;QACH,GAAG,EAAE,iBAAiB;QACtB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,oCAAoC;QAC7C,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACZ,+BAA+B,EAAE,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,2FAA2F,EAAE,GAAG,EAAE;QACjG,sBAAsB,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzB,sBAAsB,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QACjD,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY;QACpC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzB,sBAAsB,CAAC,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,gCAAgC;QACpD,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,CAAC,IAAI,CAAC,CAAC;YACP,sBAAsB,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,wBAAwB;QACxB,CAAC,IAAI,CAAC,CAAC;QACP,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAEpE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,uCAAuC,CAAC,CAAC;QAC/F,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/B,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QAClE,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QACvD,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACvF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACtD,yBAAyB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAE9C,uBAAuB;QACvB,MAAM,YAAY,GAAG,yBAAyB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAEnC,6BAA6B;QAC7B,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAEpC,gCAAgC;QAChC,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,SAAS,CAAC,yBAAyB,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { Plan, PlanSummary } from "@xgjktech/xg-openclaw-shared";
+/** 注入 stateDir（来自 api.runtime.state.resolveStateDir()）。register(api) 时调用一次。 */
+export declare function setPlanStateDir(dir: string): void;
+/** 测试用：重置模块级缓存与 stateDir */
+export declare function resetPlanStoreAccessForTest(): void;
+/**
+ * 按 planId 反查完整计划。
+ * 库不存在 / 打开失败 / 读取异常 → 返回 undefined 并记 warn 日志，绝不抛。
+ */
+export declare function getPlanById(planId: string): Plan | undefined;
+/**
+ * 列出全部计划摘要（重启恢复用）。
+ * 异常同上 → 返回空数组，绝不抛。
+ */
+export declare function listPlanSummaries(): PlanSummary[];
+//# sourceMappingURL=plan-store-access.d.ts.map

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

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

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

@@ -0,0 +1,76 @@
+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() {
+    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 [];
+    }
+}
+//# 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":"AACA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAIxF,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEhD,IAAI,QAA4B,CAAC;AACjC,IAAI,MAA2C,CAAC;AAChD,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,GAAW;IACvC,QAAQ,GAAG,GAAG,CAAC;IACf,MAAM,GAAG,SAAS,CAAC;IACnB,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,2BAA2B;IACvC,QAAQ,GAAG,SAAS,CAAC;IACrB,MAAM,GAAG,SAAS,CAAC;IACnB,gBAAgB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS;IACd,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,uBAAuB,CAAC,CAAC;YACnD,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,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,mBAAmB,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3E,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACtC,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sBAAsB,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,GAAG,SAAS,CAAC;QACnB,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC7B,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,SAAS,CAAC;QACnB,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

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":""}