@xgjktech/xg_cwork_im 1.19.41 → 1.19.43

package/dist/src/plan-tool-result.d.ts

@@ -0,0 +1,18 @@
+import type { Plan } from "@xgjktech/xg-openclaw-shared";
+export interface ParsedPlanToolResult {
+    planId: string;
+    plan?: Plan;
+}
+/**
+ * 从已解析的值（如 JSON.parse 结果、middleware 的 `event.result.details`）中
+ * 结构校验并提取计划工具的成功返回。不是计划工具返回、ok:false 一律返回 undefined。
+ * 供 `parsePlanToolResult`（字符串输入）与 middleware（对象输入）共用同一份判定，
+ * 避免两份校验漂移。
+ */
+export declare function parsePlanToolResultFromValue(value: unknown): ParsedPlanToolResult | undefined;
+/**
+ * 从工具返回 JSON 文本中解析计划工具的成功返回。
+ * 不是计划工具返回、解析失败、ok:false 一律返回 undefined（绝不抛异常）。
+ */
+export declare function parsePlanToolResult(rawBody: string): ParsedPlanToolResult | undefined;
+//# sourceMappingURL=plan-tool-result.d.ts.map

package/dist/src/plan-tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tool-result.d.ts","sourceRoot":"","sources":["../../src/plan-tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,CAAC;CACf;AA4CD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAkB7F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CASrF"}

package/dist/src/plan-tool-result.js

@@ -0,0 +1,77 @@
+const TASK_STATUSES = [
+    "pending",
+    "in_progress",
+    "completed",
+    "blocked",
+];
+function isTaskStatus(value) {
+    return typeof value === "string" && TASK_STATUSES.includes(value);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isValidPlan(value) {
+    if (!isPlainObject(value)) {
+        return false;
+    }
+    if (typeof value.planId !== "string" || value.planId === "") {
+        return false;
+    }
+    if (typeof value.goal !== "string") {
+        return false;
+    }
+    if (!Array.isArray(value.tasks)) {
+        return false;
+    }
+    for (const task of value.tasks) {
+        if (!isPlainObject(task)) {
+            return false;
+        }
+        if (typeof task.title !== "string") {
+            return false;
+        }
+        if (!isTaskStatus(task.status)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 从已解析的值（如 JSON.parse 结果、middleware 的 `event.result.details`）中
+ * 结构校验并提取计划工具的成功返回。不是计划工具返回、ok:false 一律返回 undefined。
+ * 供 `parsePlanToolResult`（字符串输入）与 middleware（对象输入）共用同一份判定，
+ * 避免两份校验漂移。
+ */
+export function parsePlanToolResultFromValue(value) {
+    if (!isPlainObject(value)) {
+        return undefined;
+    }
+    if (value.ok !== true) {
+        return undefined;
+    }
+    if (typeof value.planId !== "string" || value.planId.trim() === "") {
+        return undefined;
+    }
+    if ("plan" in value && !isValidPlan(value.plan)) {
+        return undefined;
+    }
+    return {
+        planId: value.planId,
+        ...(value.plan !== undefined ? { plan: value.plan } : {}),
+    };
+}
+/**
+ * 从工具返回 JSON 文本中解析计划工具的成功返回。
+ * 不是计划工具返回、解析失败、ok:false 一律返回 undefined（绝不抛异常）。
+ */
+export function parsePlanToolResult(rawBody) {
+    let parsed;
+    try {
+        parsed = JSON.parse(rawBody);
+    }
+    catch {
+        return undefined;
+    }
+    return parsePlanToolResultFromValue(parsed);
+}
+//# sourceMappingURL=plan-tool-result.js.map

package/dist/src/plan-tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tool-result.js","sourceRoot":"","sources":["../../src/plan-tool-result.ts"],"names":[],"mappings":"AAOA,MAAM,aAAa,GAA0B;IACzC,SAAS;IACT,aAAa;IACb,WAAW;IACX,SAAS;CACZ,CAAC;AAEF,SAAS,YAAY,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACvD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,MAAM,IAAI,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO;QACH,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/plan-tool-result.test.d.ts

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

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

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

package/dist/src/plan-tool-result.test.js

@@ -0,0 +1,129 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { parsePlanToolResult } from "./plan-tool-result.js";
+const PLAN_WRITE_SUCCESS = JSON.stringify({
+    ok: true,
+    planId: "db3b57e4-aaaa-bbbb-cccc-000000000001",
+    plan: {
+        planId: "db3b57e4-aaaa-bbbb-cccc-000000000001",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:00:00.000Z",
+        tasks: [
+            {
+                title: "备份旧配置",
+                status: "blocked",
+                note: "阻塞原因",
+                steps: [{ text: "导出 json", status: "pending" }],
+            },
+        ],
+    },
+}, null, 2);
+const PLAN_EXECUTE_SUCCESS = JSON.stringify({
+    ok: true,
+    planId: "db3b57e4-aaaa-bbbb-cccc-000000000002",
+    plan: {
+        planId: "db3b57e4-aaaa-bbbb-cccc-000000000002",
+        goal: "迁移配置到新版本",
+        createdAt: "2026-07-27T00:00:00.000Z",
+        updatedAt: "2026-07-27T00:01:00.000Z",
+        tasks: [
+            {
+                title: "备份旧配置",
+                status: "completed",
+                steps: [{ text: "导出 json", status: "completed" }],
+            },
+        ],
+    },
+    event: { emitted: false, reason: "no runId" },
+}, null, 2);
+const PLAN_WRITE_030_SUCCESS = JSON.stringify({
+    ok: true,
+    planId: "db3b57e4-aaaa-bbbb-cccc-000000000003",
+    view: "goal: 迁移配置到新版本\nT0 [>] 备份旧配置",
+});
+describe("parsePlanToolResult", () => {
+    it("parses a real plan_write success body", () => {
+        const result = parsePlanToolResult(PLAN_WRITE_SUCCESS);
+        assert.ok(result);
+        assert.equal(result.planId, "db3b57e4-aaaa-bbbb-cccc-000000000001");
+        assert.ok(result.plan);
+        assert.equal(result.plan.goal, "迁移配置到新版本");
+    });
+    it("continues to parse a legacy plan_execute success body with plan/event fields", () => {
+        const result = parsePlanToolResult(PLAN_EXECUTE_SUCCESS);
+        assert.ok(result);
+        assert.equal(result.planId, "db3b57e4-aaaa-bbbb-cccc-000000000002");
+        assert.ok(result.plan);
+        assert.equal(result.plan.tasks[0]?.status, "completed");
+    });
+    it("parses the 0.3.0 plan_write success body without a plan field", () => {
+        const result = parsePlanToolResult(PLAN_WRITE_030_SUCCESS);
+        assert.deepEqual(result, {
+            planId: "db3b57e4-aaaa-bbbb-cccc-000000000003",
+        });
+    });
+    for (const code of [
+        "PLAN_NOT_FOUND",
+        "INDEX_OUT_OF_RANGE",
+        "NOTE_REQUIRED",
+        "STEP_INDEX_REQUIRED",
+        "INVARIANT_VIOLATION",
+        "STORE_ERROR",
+    ]) {
+        it(`returns undefined for ok:false with code ${code}`, () => {
+            const body = JSON.stringify({ ok: false, error: { code, detail: "可选" } }, null, 2);
+            assert.equal(parsePlanToolResult(body), undefined);
+        });
+    }
+    it("returns undefined for empty string / non-json / non-object json", () => {
+        assert.equal(parsePlanToolResult(""), undefined);
+        assert.equal(parsePlanToolResult("not json"), undefined);
+        assert.equal(parsePlanToolResult("[]"), undefined);
+        assert.equal(parsePlanToolResult("123"), undefined);
+        assert.equal(parsePlanToolResult("null"), undefined);
+    });
+    it("does not misfire on an unrelated tool's ok:true body", () => {
+        const body = JSON.stringify({ ok: true, data: 123 }, null, 2);
+        assert.equal(parsePlanToolResult(body), undefined);
+    });
+    it("returns undefined when plan.tasks contains an invalid status", () => {
+        const body = JSON.stringify({
+            ok: true,
+            planId: "p1",
+            plan: {
+                planId: "p1",
+                goal: "g",
+                createdAt: "t",
+                updatedAt: "t",
+                tasks: [{ title: "x", status: "unknown_status" }],
+            },
+        }, null, 2);
+        assert.equal(parsePlanToolResult(body), undefined);
+    });
+    it("returns undefined when an optional plan field is present but malformed", () => {
+        const body = JSON.stringify({
+            ok: true,
+            planId: "p1",
+            view: "goal: g",
+            plan: { planId: "p1", goal: "g", tasks: "not-an-array" },
+        });
+        assert.equal(parsePlanToolResult(body), undefined);
+    });
+    it("returns undefined when planId is missing or empty", () => {
+        const body = JSON.stringify({
+            ok: true,
+            planId: "",
+            plan: {
+                planId: "p1",
+                goal: "g",
+                createdAt: "t",
+                updatedAt: "t",
+                tasks: [],
+            },
+        }, null, 2);
+        assert.equal(parsePlanToolResult(body), undefined);
+        assert.equal(parsePlanToolResult(JSON.stringify({ ok: true, planId: "   " })), undefined);
+    });
+});
+//# sourceMappingURL=plan-tool-result.test.js.map

package/dist/src/plan-tool-result.test.js.map

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

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

@@ -0,0 +1,11 @@
+import type { ImStreamClient } from "./connection.js";
+export interface PlanWsTarget {
+    client: ImStreamClient;
+    replyToMsgId: string;
+}
+/** 按 groupId 覆盖登记（新一轮会话的 client 取代旧的）。 */
+export declare function setPlanWsClient(groupId: string, client: ImStreamClient, replyToMsgId: string): void;
+export declare function getPlanWsClient(groupId: string): PlanWsTarget | undefined;
+/** 测试用：重置模块级缓存 */
+export declare function resetPlanWsRegistryForTest(): void;
+//# sourceMappingURL=plan-ws-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-ws-registry.d.ts","sourceRoot":"","sources":["../../src/plan-ws-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB;AAiBD,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAKnG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED,kBAAkB;AAClB,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

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

@@ -0,0 +1,27 @@
+/** groupId → WS client 登记表容量上限：超出时逐出最旧（插入序）。 */
+const PLAN_WS_REGISTRY_CAPACITY = 200;
+const planWsClients = new Map();
+function evictOldestOverCapacity() {
+    while (planWsClients.size > PLAN_WS_REGISTRY_CAPACITY) {
+        const oldestKey = planWsClients.keys().next().value;
+        if (oldestKey === undefined) {
+            break;
+        }
+        planWsClients.delete(oldestKey);
+    }
+}
+/** 按 groupId 覆盖登记（新一轮会话的 client 取代旧的）。 */
+export function setPlanWsClient(groupId, client, replyToMsgId) {
+    // 重新登记同一 id 应刷新插入序（视为新条目），先删再插
+    planWsClients.delete(groupId);
+    planWsClients.set(groupId, { client, replyToMsgId });
+    evictOldestOverCapacity();
+}
+export function getPlanWsClient(groupId) {
+    return planWsClients.get(groupId);
+}
+/** 测试用：重置模块级缓存 */
+export function resetPlanWsRegistryForTest() {
+    planWsClients.clear();
+}
+//# sourceMappingURL=plan-ws-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-ws-registry.js","sourceRoot":"","sources":["../../src/plan-ws-registry.ts"],"names":[],"mappings":"AAOA,gDAAgD;AAChD,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAEtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEtD,SAAS,uBAAuB;IAC5B,OAAO,aAAa,CAAC,IAAI,GAAG,yBAAyB,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACpD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM;QACV,CAAC;QACD,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAsB,EAAE,YAAoB;IACzF,+BAA+B;IAC/B,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACrD,uBAAuB,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC3C,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,0BAA0B;IACtC,aAAa,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,43 @@
+import assert from "node:assert/strict";
+import { describe, it, beforeEach } from "node:test";
+import { getPlanWsClient, resetPlanWsRegistryForTest, setPlanWsClient, } from "./plan-ws-registry.js";
+function makeClient() {
+    return {
+        start: async () => { },
+        streamProgress: async () => { },
+        streamUsage: async () => { },
+        sendEvent: async () => { },
+        end: async () => { },
+    };
+}
+beforeEach(() => {
+    resetPlanWsRegistryForTest();
+});
+describe("plan-ws-registry", () => {
+    it("登记后能取回；同 groupId 重复登记后者覆盖", () => {
+        const clientA = makeClient();
+        const clientB = makeClient();
+        setPlanWsClient("g-1", clientA, "msg-1");
+        assert.equal(getPlanWsClient("g-1")?.client, clientA);
+        assert.equal(getPlanWsClient("g-1")?.replyToMsgId, "msg-1");
+        setPlanWsClient("g-1", clientB, "msg-2");
+        assert.equal(getPlanWsClient("g-1")?.client, clientB);
+        assert.equal(getPlanWsClient("g-1")?.replyToMsgId, "msg-2");
+    });
+    it("超容量 → 逐出最旧（插入序），新条目仍在", () => {
+        const CAPACITY = 200;
+        for (let i = 0; i < CAPACITY; i += 1) {
+            setPlanWsClient(`g-${i}`, makeClient(), `msg-${i}`);
+        }
+        assert.ok(getPlanWsClient("g-0") !== undefined, "容量恰好占满时最旧条目应仍在");
+        // 再插入一条，触发超容量逐出
+        setPlanWsClient("g-overflow", makeClient(), "msg-overflow");
+        assert.equal(getPlanWsClient("g-0"), undefined, "最旧条目（插入序）应被逐出");
+        assert.ok(getPlanWsClient("g-overflow") !== undefined, "新条目应仍在");
+        assert.ok(getPlanWsClient(`g-${CAPACITY - 1}`) !== undefined, "次旧条目应仍在");
+    });
+    it("未登记的 groupId → undefined", () => {
+        assert.equal(getPlanWsClient("g-never-registered"), undefined);
+    });
+});
+//# sourceMappingURL=plan-ws-registry.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-ws-registry.test.js","sourceRoot":"","sources":["../../src/plan-ws-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EACH,eAAe,EACf,0BAA0B,EAC1B,eAAe,GAClB,MAAM,uBAAuB,CAAC;AAE/B,SAAS,UAAU;IACf,OAAO;QACH,KAAK,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QACtB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QAC/B,WAAW,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QAC5B,SAAS,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;QAC1B,GAAG,EAAE,KAAK,IAAI,EAAE,GAAG,CAAC;KACvB,CAAC;AACN,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACZ,0BAA0B,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAE7B,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAE5D,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAElE,gBAAgB;QAChB,eAAe,CAAC,YAAY,EAAE,UAAU,EAAE,EAAE,cAAc,CAAC,CAAC;QAE5D,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QACjE,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,KAAK,QAAQ,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/progress-display.d.ts

@@ -0,0 +1,77 @@
+/** 用户可见的任务进度展示：把 OpenClaw 原始 hook 事件翻译成产品化文案。 */
+export type ProgressEventName = "TOOL_PHASE" | "PLAN_UPDATE" | "RUN_EVENT";
+export type UserProgressMessage = {
+    event: ProgressEventName;
+    displayText: string;
+    summary?: string;
+};
+export type ToolStartPayload = {
+    name?: string;
+    phase?: string;
+    args?: Record<string, unknown>;
+    detailMode?: "explain" | "raw";
+};
+export type ToolResultPayload = {
+    text?: string;
+    isError?: boolean;
+    markdown?: string;
+};
+export type PlanUpdatePayload = {
+    phase?: string;
+    title?: string;
+    explanation?: string;
+    steps?: string[];
+    source?: string;
+};
+export type ApprovalEventPayload = {
+    phase?: string;
+    kind?: string;
+    status?: string;
+    title?: string;
+    itemId?: string;
+    toolCallId?: string;
+    approvalId?: string;
+    approvalSlug?: string;
+    command?: string;
+    host?: string;
+    reason?: string;
+    scope?: "turn" | "session";
+    message?: string;
+};
+export type CommandOutputPayload = {
+    itemId?: string;
+    phase?: string;
+    title?: string;
+    toolCallId?: string;
+    name?: string;
+    output?: string;
+    status?: string;
+    exitCode?: number | null;
+    durationMs?: number;
+    cwd?: string;
+};
+export type PatchSummaryProgressPayload = {
+    itemId?: string;
+    phase?: string;
+    title?: string;
+    toolCallId?: string;
+    name?: string;
+    added?: string[];
+    modified?: string[];
+    deleted?: string[];
+    summary?: string;
+};
+export declare function createProgressDisplayController(options: {
+    simplify: boolean;
+    stream: (msg: UserProgressMessage) => Promise<void>;
+}): {
+    onToolStart: (payload: ToolStartPayload) => Promise<void>;
+    onToolResult: (payload: ToolResultPayload) => Promise<void>;
+    onPlanUpdate: (payload: PlanUpdatePayload) => Promise<void>;
+    onCompactionStart: () => Promise<void>;
+    onCompactionEnd: () => Promise<void>;
+    onApprovalEvent: (payload: ApprovalEventPayload) => Promise<void>;
+    onCommandOutput: (payload: CommandOutputPayload) => Promise<void>;
+    onPatchSummary: (payload: PatchSummaryProgressPayload) => Promise<void>;
+};
+//# sourceMappingURL=progress-display.d.ts.map

package/dist/src/progress-display.d.ts.map

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