@xgjktech/xg_cwork_im 1.19.28 → 1.19.30

package/dist/src/sync-service-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * openclaw-xgkb-sync 管理 API 客户端（见 github-openclaw-xgkb-sync/docs/MANAGEMENT_API.md）
+ */
+import type { Log } from "./auth.js";
+import type { SyncDirection } from "./sync-mapping-types.js";
+export interface SyncMappingUpsertBody {
+    mappingId: string;
+    localRoot: string;
+    enabled?: boolean;
+    appKey: string;
+    projectId?: string;
+    /** 知识库远端根目录 fileId（IM 信令 remoteRootFolderId 映射而来） */
+    remoteRootFileId?: string;
+    remoteRootFolderPath?: string;
+    filePatterns?: string[];
+    excludePatterns?: string[];
+    syncDirection?: SyncDirection;
+}
+/** PUT /mappings/:id 成功响应（见 MANAGEMENT_API.md §5） */
+export interface SyncMappingUpsertResult {
+    created: boolean;
+    changed?: string[];
+}
+/**
+ * PUT /mappings/{mappingId} — 同步服务官方 upsert：不存在则创建（201），存在则部分合并更新（200）。
+ */
+export declare function upsertSyncMapping(baseUrl: string, mappingId: string, body: SyncMappingUpsertBody, log?: Log): Promise<SyncMappingUpsertResult>;
+export declare function deleteSyncMapping(baseUrl: string, mappingId: string, log?: Log): Promise<void>;
+//# sourceMappingURL=sync-service-client.d.ts.map

package/dist/src/sync-service-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-service-client.d.ts","sourceRoot":"","sources":["../../src/sync-service-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAuBD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,CAAC,EAAE,GAAG,GACV,OAAO,CAAC,uBAAuB,CAAC,CAyClC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}

package/dist/src/sync-service-client.js

@@ -0,0 +1,72 @@
+/**
+ * openclaw-xgkb-sync 管理 API 客户端（见 github-openclaw-xgkb-sync/docs/MANAGEMENT_API.md）
+ */
+function trimBaseUrl(baseUrl) {
+    return baseUrl.trim().replace(/\/+$/, "");
+}
+async function readJson(res) {
+    const text = await res.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { raw: text };
+    }
+}
+function errorMessage(body, status) {
+    if (body && typeof body === "object" && "error" in body && typeof body.error === "string") {
+        return body.error;
+    }
+    return `HTTP ${status}`;
+}
+/**
+ * PUT /mappings/{mappingId} — 同步服务官方 upsert：不存在则创建（201），存在则部分合并更新（200）。
+ */
+export async function upsertSyncMapping(baseUrl, mappingId, body, log) {
+    const base = trimBaseUrl(baseUrl);
+    const encodedId = encodeURIComponent(mappingId);
+    const url = `${base}/mappings/${encodedId}`;
+    const payload = { ...body, mappingId };
+    const res = await fetch(url, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        body: JSON.stringify(payload),
+    });
+    const json = await readJson(res);
+    // 成功：201 新建、200 更新（含「无字段变化、跳过重载」）
+    if (res.status !== 200 && res.status !== 201) {
+        const msg = errorMessage(json, res.status);
+        log?.error?.(`[sync] PUT ${url} failed (${res.status}): ${msg}`);
+        throw new Error(`同步映射 upsert 失败: ${msg}`);
+    }
+    const created = json &&
+        typeof json === "object" &&
+        "created" in json &&
+        typeof json.created === "boolean"
+        ? json.created
+        : res.status === 201;
+    const changed = json &&
+        typeof json === "object" &&
+        Array.isArray(json.changed)
+        ? (json.changed ?? [])
+        : undefined;
+    log?.info?.(`[sync] mapping upsert ok mappingId=${mappingId} created=${created} localRoot=${body.localRoot}` +
+        (changed && changed.length > 0 ? ` changed=[${changed.join(",")}]` : ""));
+    return { created, changed };
+}
+export async function deleteSyncMapping(baseUrl, mappingId, log) {
+    const base = trimBaseUrl(baseUrl);
+    const encodedId = encodeURIComponent(mappingId);
+    const url = `${base}/mappings/${encodedId}`;
+    const res = await fetch(url, { method: "DELETE" });
+    const json = await readJson(res);
+    if (!res.ok) {
+        const msg = errorMessage(json, res.status);
+        log?.error?.(`[sync] DELETE ${url} failed: ${msg}`);
+        throw new Error(`同步映射删除失败: ${msg}`);
+    }
+    log?.info?.(`[sync] mapping deleted mappingId=${mappingId}`);
+}
+//# sourceMappingURL=sync-service-client.js.map

package/dist/src/sync-service-client.js.map

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

package/dist/src/thinking-ws-progress.d.ts

@@ -0,0 +1,24 @@
+/** WS `displayText` 对 thinking 的上限（trim + 长度封顶，不做语义改写） */
+export declare const WS_THINKING_DISPLAY_MAX = 2000;
+/** `RUN_EVENT.data.summary`：IM 用其识别「同一条用户指令的输出位」内的 thinking 片段（非新聊天气泡） */
+export declare const THINKING_WS_SUMMARY_HINT = "thinking";
+/**
+ * 将 OpenClaw thinking 文本转为 WS displayText（trim + 长度封顶，不做语义改写）。
+ */
+export declare function clipThinkingForWsDisplay(text: string, max?: number): string;
+/** 仅在裁剪后的 displayText 变化时发送，避免重复 WS。 */
+export declare function resolveThinkingWsDisplayUpdate(lastDisplayed: string, thinkingText: string, max?: number): {
+    displayText: string;
+    changed: boolean;
+};
+/**
+ * 单段 thinking：`onReasoningStream` 只累积，块结束再发 **一条** WS。
+ * （不做 token 级流式拆分，避免 IM 侧出现多条「输出」。）
+ */
+export declare class ThinkingWsBuffer {
+    private buffer;
+    noteStream(text: string): void;
+    /** 取出当前缓冲并清空；无内容时返回 undefined。 */
+    take(): string | undefined;
+}
+//# sourceMappingURL=thinking-ws-progress.d.ts.map

package/dist/src/thinking-ws-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.d.ts","sourceRoot":"","sources":["../../src/thinking-ws-progress.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,0EAA0E;AAC1E,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAA0B,GAAG,MAAM,CAK5F;AAED,wCAAwC;AACxC,wBAAgB,8BAA8B,CAC1C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,GAAG,SAA0B,GAC9B;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAK3C;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAM;IAEpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B,kCAAkC;IAClC,IAAI,IAAI,MAAM,GAAG,SAAS;CAM7B"}

package/dist/src/thinking-ws-progress.js

@@ -0,0 +1,45 @@
+/** WS `displayText` 对 thinking 的上限（trim + 长度封顶，不做语义改写） */
+export const WS_THINKING_DISPLAY_MAX = 2000;
+/** `RUN_EVENT.data.summary`：IM 用其识别「同一条用户指令的输出位」内的 thinking 片段（非新聊天气泡） */
+export const THINKING_WS_SUMMARY_HINT = "thinking";
+/**
+ * 将 OpenClaw thinking 文本转为 WS displayText（trim + 长度封顶，不做语义改写）。
+ */
+export function clipThinkingForWsDisplay(text, max = WS_THINKING_DISPLAY_MAX) {
+    const t = text.trim();
+    if (!t)
+        return "";
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, Math.max(0, max - 1))}…`;
+}
+/** 仅在裁剪后的 displayText 变化时发送，避免重复 WS。 */
+export function resolveThinkingWsDisplayUpdate(lastDisplayed, thinkingText, max = WS_THINKING_DISPLAY_MAX) {
+    const displayText = clipThinkingForWsDisplay(thinkingText, max);
+    if (!displayText)
+        return { displayText: "", changed: false };
+    if (displayText === lastDisplayed)
+        return { displayText, changed: false };
+    return { displayText, changed: true };
+}
+/**
+ * 单段 thinking：`onReasoningStream` 只累积，块结束再发 **一条** WS。
+ * （不做 token 级流式拆分，避免 IM 侧出现多条「输出」。）
+ */
+export class ThinkingWsBuffer {
+    buffer = "";
+    noteStream(text) {
+        const t = text.trim();
+        if (t)
+            this.buffer = t;
+    }
+    /** 取出当前缓冲并清空；无内容时返回 undefined。 */
+    take() {
+        const t = this.buffer.trim();
+        this.buffer = "";
+        if (!t)
+            return undefined;
+        return t;
+    }
+}
+//# sourceMappingURL=thinking-ws-progress.js.map

package/dist/src/thinking-ws-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.js","sourceRoot":"","sources":["../../src/thinking-ws-progress.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,GAAG,GAAG,uBAAuB;IAChF,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,8BAA8B,CAC1C,aAAqB,EACrB,YAAoB,EACpB,GAAG,GAAG,uBAAuB;IAE7B,MAAM,WAAW,GAAG,wBAAwB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC7D,IAAI,WAAW,KAAK,aAAa;QAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1E,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACjB,MAAM,GAAG,EAAE,CAAC;IAEpB,UAAU,CAAC,IAAY;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,IAAI;QACA,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,OAAO,CAAC,CAAC;IACb,CAAC;CACJ"}

package/dist/src/thinking-ws-progress.test.d.ts

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

package/dist/src/thinking-ws-progress.test.d.ts.map

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

package/dist/src/thinking-ws-progress.test.js

@@ -0,0 +1,38 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { clipThinkingForWsDisplay, resolveThinkingWsDisplayUpdate, ThinkingWsBuffer, } from "./thinking-ws-progress.js";
+describe("thinking ws progress", () => {
+    it("clipThinkingForWsDisplay trims without rewriting", () => {
+        assert.equal(clipThinkingForWsDisplay("  hello  "), "hello");
+    });
+    it("clipThinkingForWsDisplay caps length", () => {
+        const long = "a".repeat(100);
+        assert.equal(clipThinkingForWsDisplay(long, 10), `${"a".repeat(9)}…`);
+    });
+    it("resolveThinkingWsDisplayUpdate dedupes unchanged clipped text", () => {
+        const first = resolveThinkingWsDisplayUpdate("", "same text");
+        assert.equal(first.changed, true);
+        const second = resolveThinkingWsDisplayUpdate(first.displayText, "same text");
+        assert.equal(second.changed, false);
+    });
+    it("resolveThinkingWsDisplayUpdate emits when thinking grows", () => {
+        const first = resolveThinkingWsDisplayUpdate("", "step one");
+        const second = resolveThinkingWsDisplayUpdate(first.displayText, "step one and two");
+        assert.equal(second.changed, true);
+        assert.equal(second.displayText, "step one and two");
+    });
+    it("ThinkingWsBuffer keeps latest stream chunk until take", () => {
+        const buf = new ThinkingWsBuffer();
+        buf.noteStream("short");
+        buf.noteStream("short longer");
+        buf.noteStream("short longer final");
+        assert.equal(buf.take(), "short longer final");
+        assert.equal(buf.take(), undefined);
+    });
+    it("ThinkingWsBuffer ignores empty stream chunks", () => {
+        const buf = new ThinkingWsBuffer();
+        buf.noteStream("   ");
+        assert.equal(buf.take(), undefined);
+    });
+});
+//# sourceMappingURL=thinking-ws-progress.test.js.map

package/dist/src/thinking-ws-progress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.test.js","sourceRoot":"","sources":["../../src/thinking-ws-progress.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACH,wBAAwB,EACxB,8BAA8B,EAC9B,gBAAgB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,KAAK,GAAG,8BAA8B,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAChE,MAAM,KAAK,GAAG,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACrF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxB,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC/B,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/tool-event-adapter.d.ts

@@ -0,0 +1,31 @@
+export type ToolEventArgsPreview = Record<string, string>;
+export type ToolEventData = {
+    callId: string;
+    name: string;
+    phase: "start" | "result";
+    seq: number;
+    args?: ToolEventArgsPreview;
+    result?: string;
+    isError?: boolean;
+    exitCode?: number;
+    diffStat?: string;
+};
+/**
+ * agent `tool` 流事件 → 结构化 TOOL_EVENT 负载（groupId/replyToMsgId 由调用方注入）。
+ * 仅接受 start/result 相位；缺 name/toolCallId 或相位不转发时返回 undefined。
+ * 参数与结果都做预览截断，绝不含完整结果。
+ */
+export declare function buildToolEventData(input: {
+    name?: unknown;
+    toolCallId?: unknown;
+    phase?: unknown;
+    args?: unknown;
+    result?: unknown;
+    isError?: unknown;
+    errorText?: unknown;
+    exitCode?: unknown;
+    diffStat?: unknown;
+    seq: number;
+}): ToolEventData | undefined;
+export declare const TOOL_EVENT_LOG_PREFIX = "[xg_cwork_im] [tool-event]";
+//# sourceMappingURL=tool-event-adapter.d.ts.map

package/dist/src/tool-event-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-event-adapter.d.ts","sourceRoot":"","sources":["../../src/tool-event-adapter.ts"],"names":[],"mappings":"AA4BA,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA6BF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,GAAG,SAAS,CA6B5B;AAED,eAAO,MAAM,qBAAqB,+BAAa,CAAC"}

package/dist/src/tool-event-adapter.js

@@ -0,0 +1,83 @@
+import { extractToolResultText } from "./im-tool-progress.js";
+const LOG_PREFIX = "[xg_cwork_im] [tool-event]";
+/** 只转发这两个相位，避免 update/input_delta 造成 WS 压力。 */
+const FORWARD_PHASES = new Set(["start", "result"]);
+/** 参数白名单（与 openclaw tool-display detailKeys / tool-call-view 所需字段对齐）。 */
+const ARG_KEYS = [
+    "command",
+    "title",
+    "path",
+    "file_path",
+    "target_file",
+    "query",
+    "url",
+    "sessionId",
+    "groupId",
+    "limit",
+    "pattern",
+    "glob",
+    "tool",
+    "name",
+];
+const ARG_VALUE_MAX = 120;
+const RESULT_PREVIEW_MAX = 300;
+function truncate(text, max) {
+    const t = text.replace(/\r\n/g, "\n").replace(/\s+/g, " ").trim();
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, Math.max(0, max - 1))}…`;
+}
+function buildArgsPreview(args) {
+    if (!args || typeof args !== "object" || Array.isArray(args)) {
+        return undefined;
+    }
+    const record = args;
+    const preview = {};
+    for (const key of ARG_KEYS) {
+        const value = record[key];
+        if (typeof value === "string" && value.trim()) {
+            preview[key] = truncate(value, ARG_VALUE_MAX);
+        }
+        else if (typeof value === "number" && Number.isFinite(value)) {
+            preview[key] = String(value);
+        }
+    }
+    return Object.keys(preview).length > 0 ? preview : undefined;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * agent `tool` 流事件 → 结构化 TOOL_EVENT 负载（groupId/replyToMsgId 由调用方注入）。
+ * 仅接受 start/result 相位；缺 name/toolCallId 或相位不转发时返回 undefined。
+ * 参数与结果都做预览截断，绝不含完整结果。
+ */
+export function buildToolEventData(input) {
+    const name = typeof input.name === "string" ? input.name.trim() : "";
+    const callId = typeof input.toolCallId === "string" ? input.toolCallId.trim() : "";
+    const phase = typeof input.phase === "string" ? input.phase.trim() : "";
+    if (!name || !callId || !FORWARD_PHASES.has(phase)) {
+        return undefined;
+    }
+    const args = buildArgsPreview(input.args);
+    const resultText = extractToolResultText(input.result) ??
+        (typeof input.result === "string" && input.result.trim() ? input.result : undefined) ??
+        (typeof input.errorText === "string" && input.errorText.trim() ? input.errorText : undefined);
+    const result = resultText ? truncate(resultText, RESULT_PREVIEW_MAX) : undefined;
+    const isError = input.isError === true ? true : undefined;
+    const exitCode = readNumber(input.exitCode);
+    const diffStat = typeof input.diffStat === "string" && input.diffStat.trim() ? input.diffStat.trim() : undefined;
+    return {
+        callId,
+        name,
+        phase: phase,
+        seq: input.seq,
+        ...(args ? { args } : {}),
+        ...(result ? { result } : {}),
+        ...(isError ? { isError } : {}),
+        ...(exitCode !== undefined ? { exitCode } : {}),
+        ...(diffStat ? { diffStat } : {}),
+    };
+}
+export const TOOL_EVENT_LOG_PREFIX = LOG_PREFIX;
+//# sourceMappingURL=tool-event-adapter.js.map

package/dist/src/tool-event-adapter.js.map

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

package/dist/src/tool-event-adapter.test.d.ts

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

package/dist/src/tool-event-adapter.test.d.ts.map

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

package/dist/src/tool-event-adapter.test.js

@@ -0,0 +1,93 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildToolEventData } from "./tool-event-adapter.js";
+describe("buildToolEventData", () => {
+    it("start：带白名单参数预览（含 title 用途）", () => {
+        const data = buildToolEventData({
+            name: "exec",
+            toolCallId: "call-1",
+            phase: "start",
+            args: { command: "npm test", title: "检查成果报告字段校验规则", workdir: "/tmp", secret: "x" },
+            seq: 1,
+        });
+        assert.ok(data);
+        assert.equal(data.callId, "call-1");
+        assert.equal(data.name, "exec");
+        assert.equal(data.phase, "start");
+        assert.equal(data.seq, 1);
+        assert.deepEqual(data.args, {
+            command: "npm test",
+            title: "检查成果报告字段校验规则",
+        });
+        assert.equal(data.result, undefined);
+    });
+    it("result：抽取文本预览 + isError/exitCode/diffStat", () => {
+        const data = buildToolEventData({
+            name: "exec",
+            toolCallId: "call-2",
+            phase: "result",
+            result: { content: [{ type: "text", text: "all tests passed" }] },
+            isError: false,
+            exitCode: 0,
+            diffStat: "+2 −1",
+            seq: 2,
+        });
+        assert.ok(data);
+        assert.equal(data.phase, "result");
+        assert.equal(data.result, "all tests passed");
+        assert.equal(data.isError, undefined);
+        assert.equal(data.exitCode, 0);
+        assert.equal(data.diffStat, "+2 −1");
+    });
+    it("result：isError=true 透传；无 result 时用 errorText 兜底", () => {
+        const data = buildToolEventData({
+            name: "read",
+            toolCallId: "call-3",
+            phase: "result",
+            isError: true,
+            errorText: "ENOENT: no such file",
+            seq: 3,
+        });
+        assert.ok(data);
+        assert.equal(data.isError, true);
+        assert.equal(data.result, "ENOENT: no such file");
+    });
+    it("只转发 start/result；update/input_delta/review 丢弃", () => {
+        for (const phase of ["update", "input_delta", "review", ""]) {
+            assert.equal(buildToolEventData({ name: "exec", toolCallId: "c", phase, seq: 1 }), undefined, `phase=${phase}`);
+        }
+    });
+    it("缺 name / toolCallId → undefined", () => {
+        assert.equal(buildToolEventData({ toolCallId: "c", phase: "start", seq: 1 }), undefined);
+        assert.equal(buildToolEventData({ name: "exec", phase: "start", seq: 1 }), undefined);
+    });
+    it("参数值超长截断到 120 字（…结尾），非法参数忽略", () => {
+        const long = "x".repeat(200);
+        const data = buildToolEventData({
+            name: "read",
+            toolCallId: "c",
+            phase: "start",
+            args: { path: long, limit: 5, obj: { a: 1 }, empty: "  " },
+            seq: 1,
+        });
+        assert.ok(data?.args);
+        assert.equal(data.args.path.length, 120);
+        assert.ok(data.args.path.endsWith("…"));
+        assert.equal(data.args.limit, "5");
+        assert.equal(data.args.obj, undefined);
+        assert.equal(data.args.empty, undefined);
+    });
+    it("结果超长截断到 300 字", () => {
+        const data = buildToolEventData({
+            name: "exec",
+            toolCallId: "c",
+            phase: "result",
+            result: "y".repeat(1000),
+            seq: 1,
+        });
+        assert.ok(data?.result);
+        assert.equal(data.result.length, 300);
+        assert.ok(data.result.endsWith("…"));
+    });
+});
+//# sourceMappingURL=tool-event-adapter.test.js.map

package/dist/src/tool-event-adapter.test.js.map

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

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

@@ -0,0 +1,14 @@
+import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime";
+type ToolExecuteReturn = Awaited<ReturnType<NonNullable<AnyAgentTool["execute"]>>>;
+/**
+ * 与 `openclaw/plugin-sdk` 的 `jsonResult` 返回结构一致（AgentToolResult），
+ * 供工具 `execute` 使用。
+ *
+ * 部分环境下网关打包插件后，`import { jsonResult } from "openclaw/plugin-sdk"` 会变成
+ * `_pluginSdk.jsonResult` 且值为 `undefined`，调用时报
+ * `(0 , _pluginSdk.jsonResult) is not a function`。
+ * 使用本函数可避免依赖该命名导出在打包产物中是否保留。
+ */
+export declare function toolJsonResult(payload: unknown): ToolExecuteReturn;
+export {};
+//# sourceMappingURL=tool-json-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-json-result.d.ts","sourceRoot":"","sources":["../../src/tool-json-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,KAAK,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAUlE"}

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

@@ -0,0 +1,20 @@
+/**
+ * 与 `openclaw/plugin-sdk` 的 `jsonResult` 返回结构一致（AgentToolResult），
+ * 供工具 `execute` 使用。
+ *
+ * 部分环境下网关打包插件后，`import { jsonResult } from "openclaw/plugin-sdk"` 会变成
+ * `_pluginSdk.jsonResult` 且值为 `undefined`，调用时报
+ * `(0 , _pluginSdk.jsonResult) is not a function`。
+ * 使用本函数可避免依赖该命名导出在打包产物中是否保留。
+ */
+export function toolJsonResult(payload) {
+    if (payload === undefined) {
+        return { content: [{ type: "text", text: "" }] };
+    }
+    const text = typeof payload === "string" ? JSON.stringify(payload) : JSON.stringify(payload, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        details: payload,
+    };
+}
+//# sourceMappingURL=tool-json-result.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-json-result.js","sourceRoot":"","sources":["../../src/tool-json-result.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAuB,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,GACN,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,OAAO;QACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO;KACE,CAAC;AAC3B,CAAC"}

package/dist/src/turn-agent-event-subscription.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 订阅 OpenClaw agent-event 流（lifecycle / thinking / compaction / plan）并把整轮级信号喂给
+ * turn-end-controller，同时为「非 wrapper 覆盖的 resume 段」补发 thinking/compaction 进度，
+ * 并统一承载计划更新（PLAN_STAT / PLAN_UPDATE）。
+ *
+ * 背景：OpenClaw 7.1+ / 8.x（lifecycle 语义一致；245 实测 2026.7.1-2）中，父会话每次
+ * sessions_spawn 都会挂起并结束当前段 run（lifecycle `yielded:true`），子任务返回后父会话被
+ * 自动 resume 成新段。dispatch wrapper 只覆盖首段，之后的 resume 段只有 agent-event 流能看到。
+ * 因此：
+ * - lifecycle 终态（sessionKey 必带）→ 判定「整轮是否真正结束」（P0）；
+ * - thinking / compaction（仅带 runId）→ 以 lifecycle start 建立的 runId→session 索引定位到轮次，
+ *   仅对非 wrapper 首段的 runId 转发，避免与 wrapper 回调重复展示（P1）；
+ * - plan → 同样以 runId→session 索引定位轮次，但**所有段**都走这里（dispatch 不再绑
+ *   replyOptions.onPlanUpdate）：progress_card 的更新在首段与 resume/settle 段同一条路径，
+ *   整轮最终计划状态不会因 resume 段绕开 wrapper 而丢失。
+ *
+ * handle 内绝不容忍抛错（事件订阅统一纪律）。
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk/channel-plugin-common";
+/**
+ * 记录 wrapper 首段 runId（dispatch wrapper 的 onAgentRunStart）。
+ * 该 run 的 thinking/compaction 已由 wrapper 回调展示，订阅侧跳过，避免重复。
+ */
+export declare function noteWrappedRunId(sessionKey: string, runId: string): void;
+export declare function createTurnAgentEventHandler(): Parameters<OpenClawPluginApi["agent"]["events"]["registerAgentEventSubscription"]>[0]["handle"];
+/** 插件卸载时清理全部事件索引。 */
+export declare function disposeTurnAgentEvents(): void;
+export declare function registerTurnAgentEventSubscription(api: OpenClawPluginApi): void;
+//# sourceMappingURL=turn-agent-event-subscription.d.ts.map

package/dist/src/turn-agent-event-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-agent-event-subscription.d.ts","sourceRoot":"","sources":["../../src/turn-agent-event-subscription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AA4FnF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED,wBAAgB,2BAA2B,IAAI,UAAU,CACrD,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,gCAAgC,CAAC,CACzE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAyLb;AAED,qBAAqB;AACrB,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAQ/E"}