@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/plan/action-dispatch-event-compat.test.js

@@ -0,0 +1,81 @@
+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 { afterEach, beforeEach, describe, it } from "node:test";
+import { resolvePlanDbPath } from "@xgjktech/xg-openclaw-shared";
+import { __resetActiveRoundRegistryForTests, registerActiveRound } from "../turn/active-round-registry.js";
+import { createTurnAgentEventHandler, disposeTurnAgentEvents } from "../turn/turn-agent-event-subscription.js";
+import { disposeActionStore, getActionById, setActionStateDir } from "./action-store-access.js";
+import { sendActionRunEvent } from "./action-run-event.js";
+import { createPlanToolResultMiddleware } from "./plan-tool-middleware.js";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "./plan-ws-registry.js";
+const GROUP = "action-compat-group";
+const SESSION = `agent:test:xg_cwork_im:group:${GROUP}`;
+const EVENT_ID = "evt-action-compat";
+let stateDir;
+let calls;
+let client;
+beforeEach(() => {
+    disposeTurnAgentEvents();
+    resetPlanWsRegistryForTest();
+    __resetActiveRoundRegistryForTests();
+    stateDir = mkdtempSync(join(tmpdir(), "xg-action-compat-"));
+    setActionStateDir(stateDir);
+    const db = new DatabaseSync(resolvePlanDbPath(stateDir));
+    db.exec("CREATE TABLE actions (event_id TEXT PRIMARY KEY, doc TEXT NOT NULL)");
+    db.prepare("INSERT INTO actions VALUES (?, ?)").run(EVENT_ID, JSON.stringify({
+        eventId: EVENT_ID, event: "action_dispatch", action: "ui_refresh", target: "BP",
+        version: 1, status: "completed", timestamp: new Date().toISOString(),
+        origin: { channel: "xg_cwork_im", to: GROUP }, payload: { data: { text: "x".repeat(600) } },
+    }));
+    db.close();
+    calls = [];
+    client = {
+        start: async () => { }, streamProgress: async () => { }, streamUsage: async () => { },
+        sendEvent: async (opts) => { calls.push(opts); }, end: async () => { },
+    };
+    setPlanWsClient(GROUP, client, "anchor");
+});
+afterEach(() => {
+    disposeActionStore();
+    disposeTurnAgentEvents();
+    resetPlanWsRegistryForTest();
+    __resetActiveRoundRegistryForTests();
+    rmSync(stateDir, { recursive: true, force: true });
+});
+function toolResult() {
+    const business = { ok: true, eventId: EVENT_ID, event: getActionById(EVENT_ID) };
+    return { details: business, content: [{ type: "text", text: JSON.stringify(business) }] };
+}
+function emitResult(result = toolResult(), toolCallId = "tool_call:parent:xg_action_dispatch:1") {
+    const handler = createTurnAgentEventHandler();
+    handler({
+        seq: 1, ts: Date.now(), runId: "run-compat", stream: "tool", sessionKey: SESSION,
+        data: { name: "xg_action_dispatch", phase: "result", toolCallId, result },
+    }, {});
+}
+describe("Action Dispatch: OpenClaw Default 嵌套工具兼容", () => {
+    it("真实 SQLite + tool_call 内层 result：ACTION_DISPATCH 完整发送，TOOL_EVENT 仍为 300 字符预览", () => {
+        registerActiveRound({ accountId: "test", groupId: GROUP, agentId: "test", sessionKey: SESSION, replyToMsgId: "anchor", streamClient: client });
+        emitResult();
+        assert.deepEqual(calls.map((call) => call.event), ["ACTION_DISPATCH", "TOOL_EVENT"]);
+        assert.equal(calls[0].data.target, "BP");
+        assert.equal((calls[0].data.payload.data.text).length, 600);
+        assert.equal(calls[1].data.result.length, 300);
+    });
+    it("直调只走原中间件，tool 流不重复派发", () => {
+        const middleware = createPlanToolResultMiddleware({ getActionById, sendActionRunEvent });
+        middleware({ toolName: "xg_action_dispatch", toolCallId: "direct", args: {}, result: toolResult() }, { runtime: "openclaw" });
+        emitResult(toolResult(), "direct");
+        assert.equal(calls.length, 1);
+    });
+    it("content-only 结果复用原解析器，缺库记录不派发", () => {
+        emitResult({ details: { ok: true, eventId: "missing" }, content: [] });
+        assert.equal(calls.length, 0);
+        emitResult({ details: undefined, content: toolResult().content });
+        assert.equal(calls.length, 1);
+    });
+});
+//# sourceMappingURL=action-dispatch-event-compat.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-dispatch-event-compat.test.js","sourceRoot":"","sources":["../../../src/plan/action-dispatch-event-compat.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,kCAAkC,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC3G,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAC/G,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,KAAK,GAAG,qBAAqB,CAAC;AACpC,MAAM,OAAO,GAAG,gCAAgC,KAAK,EAAE,CAAC;AACxD,MAAM,QAAQ,GAAG,mBAAmB,CAAC;AACrC,IAAI,QAAgB,CAAC;AACrB,IAAI,KAA8B,CAAC;AACnC,IAAI,MAAsB,CAAC;AAE3B,UAAU,CAAC,GAAG,EAAE;IACZ,sBAAsB,EAAE,CAAC;IACzB,0BAA0B,EAAE,CAAC;IAC7B,kCAAkC,EAAE,CAAC;IACrC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC5D,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,EAAE,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAC/E,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC;QACzE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI;QAC/E,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE;KAC9F,CAAC,CAAC,CAAC;IACJ,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,KAAK,GAAG,EAAE,CAAC;IACX,MAAM,GAAG;QACL,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAClF,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACxE,CAAC;IACF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACX,kBAAkB,EAAE,CAAC;IACrB,sBAAsB,EAAE,CAAC;IACzB,0BAA0B,EAAE,CAAC;IAC7B,kCAAkC,EAAE,CAAC;IACrC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,SAAS,UAAU;IACf,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACjF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,SAAS,UAAU,CAAC,SAAkB,UAAU,EAAE,EAAE,UAAU,GAAG,uCAAuC;IACpG,MAAM,OAAO,GAAG,2BAA2B,EAAE,CAAC;IAC9C,OAAO,CAAC;QACJ,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO;QAChF,IAAI,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE;KAC3C,EAAE,EAAmC,CAAC,CAAC;AAC7E,CAAC;AAED,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACnF,mBAAmB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/I,UAAU,EAAE,CAAC;QACb,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;QACrF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC5B,MAAM,UAAU,GAAG,8BAA8B,CAAC,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACzF,UAAU,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9H,UAAU,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -38,11 +38,11 @@ function makeAction(eventId, overrides = {}) {
 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.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));
     }

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

@@ -18,15 +18,15 @@ function seedAgentDb(baseDir, agentId, rows) {
     const dbPath = join(agentDir, "openclaw-agent.sqlite");
     const db = new DatabaseSync(dbPath);
     try {
-        db.exec(`
-            CREATE TABLE session_progress_cards (
-              session_key TEXT NOT NULL PRIMARY KEY,
-              markdown TEXT,
-              steps_json TEXT,
-              revision INTEGER NOT NULL,
-              created_at INTEGER NOT NULL,
-              updated_at INTEGER NOT NULL
-            ) STRICT;
+        db.exec(`
+            CREATE TABLE session_progress_cards (
+              session_key TEXT NOT NULL PRIMARY KEY,
+              markdown TEXT,
+              steps_json TEXT,
+              revision INTEGER NOT NULL,
+              created_at INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL
+            ) STRICT;
         `);
         const insert = db.prepare("INSERT INTO session_progress_cards (session_key, markdown, steps_json, revision, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?);");
         for (const row of rows) {

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

@@ -21,15 +21,15 @@ function seedCard(baseDir, agentId, sessionKey, opts) {
     mkdirSync(agentDir, { recursive: true });
     const db = new DatabaseSync(join(agentDir, "openclaw-agent.sqlite"));
     try {
-        db.exec(`
-            CREATE TABLE IF NOT EXISTS session_progress_cards (
-              session_key TEXT NOT NULL PRIMARY KEY,
-              markdown TEXT,
-              steps_json TEXT,
-              revision INTEGER NOT NULL,
-              created_at INTEGER NOT NULL,
-              updated_at INTEGER NOT NULL
-            ) STRICT;
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS session_progress_cards (
+              session_key TEXT NOT NULL PRIMARY KEY,
+              markdown TEXT,
+              steps_json TEXT,
+              revision INTEGER NOT NULL,
+              created_at INTEGER NOT NULL,
+              updated_at INTEGER NOT NULL
+            ) STRICT;
         `);
         db.prepare("INSERT INTO session_progress_cards (session_key, markdown, steps_json, revision, created_at, updated_at) VALUES (?, ?, ?, 1, ?, ?);").run(sessionKey, opts.markdown ?? null, opts.stepsJson, opts.createdAtMs ?? NOW - HOUR, opts.updatedAtMs ?? NOW - 5 * 60_000);
     }

package/dist/src/plan-blocked-notice.d.ts

@@ -0,0 +1,14 @@
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+export interface BlockedTaskNotice {
+    taskIndex: number;
+    taskTitle: string;
+    note: string;
+}
+/** 扫描 plan 中全部 blocked task，产出通知（顺序与 tasks 下标一致） */
+export declare function collectBlockedNotices(plan: Plan): BlockedTaskNotice[];
+/**
+ * 组装 [plan-telemetry] 结构化日志行（单行 JSON，可 grep + 可解析）。
+ * 会话标识取自 plan.origin；缺失时对应键整体省略，不落 null/""。
+ */
+export declare function buildBlockedTelemetryLine(plan: Plan, notice: BlockedTaskNotice, toolName: string): string;
+//# sourceMappingURL=plan-blocked-notice.d.ts.map

package/dist/src/plan-blocked-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-blocked-notice.d.ts","sourceRoot":"","sources":["../../src/plan-blocked-notice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,EAAE,CAmBrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,GACjB,MAAM,CAcR"}

package/dist/src/plan-blocked-notice.js

@@ -0,0 +1,41 @@
+/** 扫描 plan 中全部 blocked task，产出通知（顺序与 tasks 下标一致） */
+export function collectBlockedNotices(plan) {
+    const notices = [];
+    plan.tasks.forEach((task, taskIndex) => {
+        if (task.status !== "blocked") {
+            return;
+        }
+        const note = task.note?.trim() ?? "";
+        if (note === "") {
+            return;
+        }
+        notices.push({
+            taskIndex,
+            taskTitle: task.title,
+            note,
+        });
+    });
+    return notices;
+}
+/**
+ * 组装 [plan-telemetry] 结构化日志行（单行 JSON，可 grep + 可解析）。
+ * 会话标识取自 plan.origin；缺失时对应键整体省略，不落 null/""。
+ */
+export function buildBlockedTelemetryLine(plan, notice, toolName) {
+    const payload = {
+        planId: plan.planId,
+        taskIndex: notice.taskIndex,
+        taskTitle: notice.taskTitle,
+        note: notice.note,
+        goal: plan.goal,
+    };
+    if (plan.origin?.channel !== undefined)
+        payload.channel = plan.origin.channel;
+    if (plan.origin?.to !== undefined)
+        payload.to = plan.origin.to;
+    if (plan.origin?.sessionKey !== undefined)
+        payload.sessionKey = plan.origin.sessionKey;
+    payload.toolName = toolName;
+    return `[xg_cwork_im] [plan-telemetry] blocked ${JSON.stringify(payload)}`;
+}
+//# sourceMappingURL=plan-blocked-notice.js.map

package/dist/src/plan-blocked-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-blocked-notice.js","sourceRoot":"","sources":["../../src/plan-blocked-notice.ts"],"names":[],"mappings":"AAQA,oDAAoD;AACpD,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC5C,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACd,OAAO;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACT,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,IAAI;SACP,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACrC,IAAU,EACV,MAAyB,EACzB,QAAgB;IAEhB,MAAM,OAAO,GAA4B;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;KAClB,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC9E,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,SAAS;QAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/D,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IACvF,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE5B,OAAO,0CAA0C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/src/plan-blocked-notice.test.d.ts

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

package/dist/src/plan-blocked-notice.test.d.ts.map

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

package/dist/src/plan-blocked-notice.test.js

@@ -0,0 +1,96 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildBlockedTelemetryLine, collectBlockedNotices } from "./plan-blocked-notice.js";
+function makePlan(overrides = {}) {
+    return {
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [],
+        ...overrides,
+    };
+}
+describe("collectBlockedNotices", () => {
+    it("returns an empty array when there is no blocked task", () => {
+        const plan = makePlan({
+            tasks: [{ title: "t1", status: "pending" }, { title: "t2", status: "completed" }],
+        });
+        assert.deepEqual(collectBlockedNotices(plan), []);
+    });
+    it("collects multiple co-existing blocked tasks in task order", () => {
+        const plan = makePlan({
+            tasks: [
+                { title: "备份旧配置", status: "blocked", note: "缺少权限" },
+                { title: "校验数据", status: "pending" },
+                { title: "切换流量", status: "blocked", note: "依赖未就绪" },
+            ],
+        });
+        const notices = collectBlockedNotices(plan);
+        assert.equal(notices.length, 2);
+        assert.equal(notices[0].taskIndex, 0);
+        assert.equal(notices[1].taskIndex, 2);
+    });
+    it("skips a blocked task whose note is missing or blank", () => {
+        const plan = makePlan({
+            tasks: [
+                { title: "无 note", status: "blocked" },
+                { title: "空白 note", status: "blocked", note: "   " },
+            ],
+        });
+        assert.deepEqual(collectBlockedNotices(plan), []);
+    });
+    it("produces the same notices for a repeated identical blocked snapshot (no dedup at this layer)", () => {
+        const plan = makePlan({
+            tasks: [{ title: "备份旧配置", status: "blocked", note: "缺少权限" }],
+        });
+        const first = collectBlockedNotices(plan);
+        const second = collectBlockedNotices(plan);
+        assert.deepEqual(first, second);
+    });
+});
+describe("buildBlockedTelemetryLine", () => {
+    it("包含 planId/taskIndex/taskTitle/note/goal/toolName", () => {
+        const plan = makePlan({
+            planId: "plan-telemetry-1",
+            goal: "迁移配置到新版本",
+            tasks: [{ title: "备份旧配置", status: "blocked", note: "缺少权限" }],
+        });
+        const [notice] = collectBlockedNotices(plan);
+        const line = buildBlockedTelemetryLine(plan, notice, "xg_plan_execute");
+        assert.ok(line.startsWith("[xg_cwork_im] [plan-telemetry] blocked "));
+        const jsonPart = line.slice(line.indexOf("{"));
+        const parsed = JSON.parse(jsonPart);
+        assert.equal(parsed.planId, "plan-telemetry-1");
+        assert.equal(parsed.taskIndex, 0);
+        assert.equal(parsed.taskTitle, "备份旧配置");
+        assert.equal(parsed.note, "缺少权限");
+        assert.equal(parsed.goal, "迁移配置到新版本");
+        assert.equal(parsed.toolName, "xg_plan_execute");
+    });
+    it("plan 带 origin 时日志行含 channel/to/sessionKey", () => {
+        const plan = makePlan({
+            tasks: [{ title: "t1", status: "blocked", note: "n" }],
+            origin: { channel: "xg_cwork_im", to: "g-123", sessionKey: "sess-1" },
+        });
+        const [notice] = collectBlockedNotices(plan);
+        const line = buildBlockedTelemetryLine(plan, notice, "xg_plan_write");
+        const parsed = JSON.parse(line.slice(line.indexOf("{")));
+        assert.equal(parsed.channel, "xg_cwork_im");
+        assert.equal(parsed.to, "g-123");
+        assert.equal(parsed.sessionKey, "sess-1");
+    });
+    it("plan 无 origin 时日志行不含 channel/to/sessionKey 键，且照常产出", () => {
+        const plan = makePlan({
+            tasks: [{ title: "t1", status: "blocked", note: "n" }],
+        });
+        const [notice] = collectBlockedNotices(plan);
+        const line = buildBlockedTelemetryLine(plan, notice, "xg_plan_write");
+        const parsed = JSON.parse(line.slice(line.indexOf("{")));
+        assert.equal("channel" in parsed, false);
+        assert.equal("to" in parsed, false);
+        assert.equal("sessionKey" in parsed, false);
+        assert.equal(parsed.planId, plan.planId);
+    });
+});
+//# sourceMappingURL=plan-blocked-notice.test.js.map

package/dist/src/plan-blocked-notice.test.js.map

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

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

@@ -0,0 +1,36 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+export interface PlanEventSubscriptionDeps {
+    /** 按 planId 反查权威 plan（注入 getPlanById） */
+    getPlanById: (planId: string) => Plan | undefined;
+    /** 发送 PLAN_STAT 增量事件（与 middleware 共用同一实现） */
+    sendPlanStat: (params: {
+        plan: Plan;
+        source: "tool" | "snapshot";
+    }) => void;
+}
+type SubscriptionHandle = Parameters<OpenClawPluginApi["agent"]["events"]["registerAgentEventSubscription"]>[0]["handle"];
+/**
+ * 构造事件订阅的 `handle` 回调，可独立单测（不依赖真实 api/网络）。
+ *
+ * 降级纪律同 middleware：handle 内全身 try/catch，绝不外抛（与 middleware 同进程）。
+ *
+ * 保留理由（D6 二选一，已裁定保留 + 瘦身）：① 它是唯一非 middleware 的触发面，
+ * middleware 注册受 trust 门控被拒时（docs/plan-integration-notes.md §4.1 的已知部署故障）
+ * 它不受影响，仍是一条独立兜底；② 瘦身后主体只剩"守卫 → 反查 → sendPlanStat"三行，
+ * 维护成本接近零；③ 删掉等于丢弃第一轮已投入的契约面，而 runId 限制解除是可预期的上游演进。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此 handle 不会被触发，保留以便未来该限制解除后零改动生效。
+ * 不得将其作为任何正确性判断依据——权威状态来自 SQLite 只读反查。
+ */
+export declare function createPlanEventHandler(deps: PlanEventSubscriptionDeps): SubscriptionHandle;
+/**
+ * 注册计划事件订阅（前瞻性预留）。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此订阅不会被触发，保留以便未来该限制解除后零改动生效。
+ */
+export declare function registerPlanEventSubscription(api: OpenClawPluginApi, deps: PlanEventSubscriptionDeps): void;
+export {};
+//# sourceMappingURL=plan-event-subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-event-subscription.d.ts","sourceRoot":"","sources":["../../src/plan-event-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AASzD,MAAM,WAAW,yBAAyB;IACtC,yCAAyC;IACzC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;IAClD,6CAA6C;IAC7C,YAAY,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/E;AAED,KAAK,kBAAkB,GAAG,UAAU,CAChC,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,gCAAgC,CAAC,CACzE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEf;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,GAAG,kBAAkB,CAmB1F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAY3G"}

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

@@ -0,0 +1,57 @@
+import { isPlanEventPayload, planEventStream } from "@xgjktech/xg-openclaw-shared";
+/**
+ * xg-harness-tools 的 plugin id：streams 过滤需要与其 openclaw.plugin.json 的 id 一致。
+ */
+const HARNESS_PLUGIN_ID = "xg-harness-tools";
+const LOG_PREFIX = "[xg_cwork_im] [plan-event-subscription]";
+/**
+ * 构造事件订阅的 `handle` 回调，可独立单测（不依赖真实 api/网络）。
+ *
+ * 降级纪律同 middleware：handle 内全身 try/catch，绝不外抛（与 middleware 同进程）。
+ *
+ * 保留理由（D6 二选一，已裁定保留 + 瘦身）：① 它是唯一非 middleware 的触发面，
+ * middleware 注册受 trust 门控被拒时（docs/plan-integration-notes.md §4.1 的已知部署故障）
+ * 它不受影响，仍是一条独立兜底；② 瘦身后主体只剩"守卫 → 反查 → sendPlanStat"三行，
+ * 维护成本接近零；③ 删掉等于丢弃第一轮已投入的契约面，而 runId 限制解除是可预期的上游演进。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此 handle 不会被触发，保留以便未来该限制解除后零改动生效。
+ * 不得将其作为任何正确性判断依据——权威状态来自 SQLite 只读反查。
+ */
+export function createPlanEventHandler(deps) {
+    return (event, _ctx) => {
+        try {
+            if (!isPlanEventPayload(event.data)) {
+                return;
+            }
+            const payload = event.data;
+            const plan = deps.getPlanById(payload.planId);
+            if (!plan) {
+                console.warn(`${LOG_PREFIX} 反查不到 plan，跳过 planId=${payload.planId}`);
+                return;
+            }
+            deps.sendPlanStat({ plan, source: "tool" });
+        }
+        catch (err) {
+            console.warn(`${LOG_PREFIX} handle 内部异常，已吞: ${String(err)}`);
+        }
+    };
+}
+/**
+ * 注册计划事件订阅（前瞻性预留）。
+ *
+ * ⚠️ 当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，
+ * 此订阅不会被触发，保留以便未来该限制解除后零改动生效。
+ */
+export function registerPlanEventSubscription(api, deps) {
+    const handle = createPlanEventHandler(deps);
+    api.agent.events.registerAgentEventSubscription({
+        id: "xg-cwork-im-plan-progress",
+        description: "订阅 xg-harness-tools 计划进度事件，反查权威 plan 后发送 PLAN_STAT。前瞻性预留：" +
+            "当前 OpenClaw 版本下 xg-harness-tools 恒因缺少 runId 而不发送此事件，" +
+            "此订阅暂不会被触发，保留以便未来该限制解除后零改动生效。",
+        streams: [planEventStream(HARNESS_PLUGIN_ID)],
+        handle,
+    });
+}
+//# sourceMappingURL=plan-event-subscription.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-event-subscription.js","sourceRoot":"","sources":["../../src/plan-event-subscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGnF;;GAEG;AACH,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C,MAAM,UAAU,GAAG,yCAAyC,CAAC;AAa7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IAClE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnB,IAAI,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO;YACX,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;YAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,wBAAwB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpE,OAAO;YACX,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAsB,EAAE,IAA+B;IACjG,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE5C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8BAA8B,CAAC;QAC5C,EAAE,EAAE,2BAA2B;QAC/B,WAAW,EACP,2DAA2D;YAC3D,sDAAsD;YACtD,8BAA8B;QAClC,OAAO,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC7C,MAAM;KACT,CAAC,CAAC;AACP,CAAC"}

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

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

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

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

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

@@ -0,0 +1,167 @@
+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 makePlan(overrides = {}) {
+    return {
+        planId: "plan-1",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [],
+        ...overrides,
+    };
+}
+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 RecordingDeps {
+    planById = new Map();
+    planStatCalls = [];
+    getPlanById = (planId) => this.planById.get(planId);
+    sendPlanStat = (params) => {
+        this.planStatCalls.push(params);
+    };
+}
+describe("createPlanEventHandler: isPlanEventPayload 守卫", () => {
+    it("rejects malformed data without pushing or throwing", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        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(deps.planStatCalls.length, 0);
+    });
+    it("rejects when data is not an object at all", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        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(deps.planStatCalls.length, 0);
+    });
+    it("rejects a payload that violates kind only — everything else is valid (pins the guard)", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ kind: "some_other_plugin_event" }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("rejects a payload with a malformed summary — everything else is valid", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ summary: {} }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+});
+describe("createPlanEventHandler: 反查到 plan → 发 PLAN_STAT", () => {
+    it("反查到全量 plan → 调用 sendPlanStat，source === \"tool\"", async () => {
+        const deps = new RecordingDeps();
+        const plan = makePlan({
+            tasks: [{ title: "备份旧配置", status: "blocked", note: "缺少权限" }],
+        });
+        deps.planById.set("plan-1", plan);
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        await handle(event, FAKE_CTX);
+        assert.equal(deps.planStatCalls.length, 1);
+        assert.equal(deps.planStatCalls[0].source, "tool");
+        assert.equal(deps.planStatCalls[0].plan.planId, "plan-1");
+    });
+});
+describe("createPlanEventHandler: 反查不到 → 不发不抛", () => {
+    it("getPlanById 返回 undefined → 不调用 sendPlanStat，不抛", async () => {
+        const deps = new RecordingDeps();
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload({ planId: "plan-does-not-exist" }),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+});
+describe("createPlanEventHandler: handle 内部出错不外抛", () => {
+    it("resolves normally even when getPlanById throws", async () => {
+        const deps = new RecordingDeps();
+        deps.getPlanById = () => {
+            throw new Error("boom");
+        };
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        await assert.doesNotReject(() => Promise.resolve(handle(event, FAKE_CTX)));
+        assert.equal(deps.planStatCalls.length, 0);
+    });
+    it("resolves normally even when sendPlanStat throws", async () => {
+        const deps = new RecordingDeps();
+        const plan = makePlan({ tasks: [{ title: "t1", status: "blocked", note: "n" }] });
+        deps.planById.set("plan-1", plan);
+        deps.sendPlanStat = () => {
+            throw new Error("boom");
+        };
+        const handle = createPlanEventHandler(deps);
+        const event = {
+            runId: "run-1",
+            seq: 1,
+            stream: "xg-harness-tools.plan",
+            ts: Date.now(),
+            data: makeBlockedPayload(),
+        };
+        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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"}