@xgjktech/xg_cwork_im 1.19.21 → 1.19.23

package/dist/src/delivery/send-service.js

@@ -0,0 +1,324 @@
+/**
+ * XG-IM 消息发送模块
+ *
+ * 调用 IM 接口将 AI 回复发送到指定群聊，并 @ 原始发送者。
+ * 支持 RICH_TEXT 与带资源 fileId 的 FILE 类型（attachments）。
+ */
+import { randomUUID } from "node:crypto";
+import axios from "axios";
+import { downloadMediaBuffer, formatFromFilename, parseWorkspaceRelativeMediaRef, resolveMaxAttachmentBytes, resolveResourceUploadUrl, uploadWholeResourceFile, } from "../workspace/resource-file.js";
+import { stripMediaDirectiveLines, stripModelUsageFooter } from "./deliver-text.js";
+import { formatUserFacingMediaDeliverError } from "./user-facing-errors.js";
+function formatDeliverError(err) {
+    if (axios.isAxiosError(err)) {
+        const parts = [err.message];
+        if (err.code)
+            parts.push(`axiosCode=${err.code}`);
+        if (err.response?.status != null)
+            parts.push(`httpStatus=${err.response.status}`);
+        return parts.join(" ");
+    }
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+/** 文件下载/上传失败时：正文 + 原始媒体链接 + 失败说明（链接可供用户或后续轮次使用）。 */
+function buildFileDeliverFallbackText(textToSend, mediaUrls, err) {
+    const errNote = `（${formatUserFacingMediaDeliverError(err, mediaUrls)}）`;
+    const urlBlock = mediaUrls.length > 0
+        ? `\n\n**附件链接（未能上传 IM）**\n${mediaUrls.map((u) => `- \`${u.trim()}\``).join("\n")}`
+        : "";
+    if (textToSend.length > 0) {
+        return `${textToSend}${urlBlock}\n\n${errNote}`;
+    }
+    if (urlBlock.trim()) {
+        return `${urlBlock.trim()}\n\n${errNote}`;
+    }
+    return errNote;
+}
+/**
+ * 生成一次投递的客户端幂等键。
+ *
+ * 服务端按 `clientMsgId + groupId + 最近 10 分钟` 去重：同一逻辑消息在其内部 6 次重试间
+ * 复用同一 `clientMsgId`，超时/断连重发会命中服务端已有消息，不产生重复气泡。
+ * 每个独立投递块生成一次（不同块必须不同）。
+ */
+export function generateClientMsgId() {
+    return `ocw_${Date.now()}_${randomUUID()}`;
+}
+/** 从发送接口响应中解析服务端消息 id（`data.id`）与回显 `clientMsgId`，用于对账日志。 */
+export function extractSentMessageInfo(resData) {
+    if (!resData || typeof resData !== "object")
+        return {};
+    const data = resData.data;
+    if (!data || typeof data !== "object")
+        return {};
+    const d = data;
+    const serverMsgId = typeof d.id === "string" ? d.id : d.id != null ? String(d.id) : undefined;
+    const clientMsgId = typeof d.clientMsgId === "string" ? d.clientMsgId : undefined;
+    return { serverMsgId, clientMsgId };
+}
+/**
+ * 发消息接口的重试参数。
+ *
+ * 总尝试次数 = 1（首次） + IM_SEND_MAX_RETRIES（重试） = 6。
+ * 重试间隔指数退避：1s → 2s → 4s → 8s → 16s（上限 IM_SEND_RETRY_DELAY_CAP_MS）。
+ * 仅对网络层瞬时错误（无响应 / 5xx / 408 / 429）重试；4xx 与业务 resultCode 错误视为永久失败，立即抛出。
+ */
+const IM_SEND_MAX_RETRIES = 5;
+const IM_SEND_RETRY_DELAY_BASE_MS = 1_000;
+const IM_SEND_RETRY_DELAY_CAP_MS = 30_000;
+function calcSendRetryDelayMs(attempt) {
+    const exp = IM_SEND_RETRY_DELAY_BASE_MS * 2 ** Math.max(0, attempt - 1);
+    return Math.min(exp, IM_SEND_RETRY_DELAY_CAP_MS);
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 判断错误是否值得重试。
+ *
+ * - axios 网络错误 / 超时 / 5xx / 408 / 429 → 重试
+ * - 4xx（其它）/ 业务 resultCode 错误（普通 Error）→ 永久失败，不重试
+ */
+function isRetryableSendError(err) {
+    if (axios.isAxiosError(err)) {
+        const status = err.response?.status;
+        if (status === undefined)
+            return true;
+        if (status >= 500)
+            return true;
+        if (status === 408 || status === 429)
+            return true;
+        return false;
+    }
+    return false;
+}
+/** POST /im/message/send 相关日志：`log` 未传入或网关未绑定时仍输出到 console，避免「消息已发出却看不到接口日志」 */
+function sendLogInfo(log, msg) {
+    if (typeof log?.info === "function") {
+        log.info(msg);
+        return;
+    }
+    const alt = log;
+    if (typeof alt?.log === "function") {
+        alt.log(msg);
+        return;
+    }
+    console.log(`[xg_cwork_im] ${msg}`);
+}
+function sendLogWarn(log, msg) {
+    if (typeof log?.warn === "function") {
+        log.warn(msg);
+        return;
+    }
+    sendLogInfo(log, msg);
+}
+function sendLogError(log, msg) {
+    if (typeof log?.error === "function") {
+        log.error(msg);
+        return;
+    }
+    console.error(`[xg_cwork_im] ${msg}`);
+}
+function sendLogDebug(log, config, msg) {
+    if (!config.debug)
+        return;
+    if (typeof log?.debug === "function") {
+        log.debug(msg);
+        return;
+    }
+    console.log(`[xg_cwork_im] ${msg}`);
+}
+async function postImMessage(config, token, groupId, body, atUserIds = [], log) {
+    const url = `${config.baseUrl}/im/message/send`;
+    const full = {
+        ...body,
+        groupId,
+        ...(atUserIds.length > 0 ? { atUserIds } : {}),
+    };
+    const bodyClientMsgId = typeof full.clientMsgId === "string" ? full.clientMsgId : undefined;
+    sendLogInfo(log, `[cwork_im:send] POST ${url} groupId=${groupId} type=${full.type} ` +
+        `clientMsgId=${bodyClientMsgId ?? "none"} ` +
+        `atUsers=${JSON.stringify(atUserIds)}`);
+    sendLogDebug(log, config, `[cwork_im:send] Request body: ${JSON.stringify(full)}`);
+    const totalAttempts = 1 + IM_SEND_MAX_RETRIES;
+    let lastErr = undefined;
+    for (let attempt = 1; attempt <= totalAttempts; attempt++) {
+        try {
+            const res = await axios.post(url, full, {
+                headers: {
+                    "Content-Type": "application/json",
+                    "access-token": token,
+                },
+                timeout: 10_000,
+            });
+            sendLogInfo(log, `[cwork_im:send] Response status=${res.status} (attempt=${attempt}/${totalAttempts})`);
+            sendLogDebug(log, config, `[cwork_im:send] Response body: ${JSON.stringify(res.data)}`);
+            // Detect business-level errors that arrive with HTTP 200.
+            // IM API unified response: { data, resultCode: 1, resultMsg: "" } — resultCode=1 means success.
+            const d = res.data;
+            if (d && typeof d === "object") {
+                const resultCode = d.resultCode;
+                const resultMsg = d.resultMsg;
+                if (resultCode !== undefined && resultCode !== 1) {
+                    throw new Error(`IM API error resultCode=${resultCode}${resultMsg ? ` resultMsg=${resultMsg}` : ""}`);
+                }
+            }
+            // 对账日志：服务端消息 id（data.id）+ 回显 clientMsgId；重试命中去重时会返回既有消息。
+            const sent = extractSentMessageInfo(d);
+            sendLogInfo(log, `[cwork_im:send] Delivered groupId=${groupId} ` +
+                `serverMsgId=${sent.serverMsgId ?? "unknown"} ` +
+                `clientMsgId=${sent.clientMsgId ?? bodyClientMsgId ?? "none"} ` +
+                `(attempt=${attempt}/${totalAttempts})`);
+            return { serverMsgId: sent.serverMsgId, clientMsgId: sent.clientMsgId ?? bodyClientMsgId };
+        }
+        catch (err) {
+            lastErr = err;
+            const msg = formatDeliverError(err);
+            const retryable = isRetryableSendError(err);
+            const isLast = attempt >= totalAttempts;
+            if (!retryable || isLast) {
+                sendLogError(log, `[cwork_im:send] Failed to send message to groupId=${groupId} ` +
+                    `(attempt=${attempt}/${totalAttempts}, retryable=${retryable}): ${msg}`);
+                throw err;
+            }
+            const retryDelayMs = calcSendRetryDelayMs(attempt);
+            sendLogWarn(log, `[cwork_im:send] Send failed (attempt=${attempt}/${totalAttempts}), ` +
+                `retrying in ${retryDelayMs}ms: ${msg}`);
+            await delay(retryDelayMs);
+        }
+    }
+    // 理论上不可达：上面循环里要么 return 要么 throw。这里只是给 TS 一个安全兜底。
+    throw lastErr ?? new Error("[cwork_im:send] Send failed after retries");
+}
+/**
+ * 将 deliver 块发到 IM：若有媒体则先 POST baseUrl/file/upDownload/uploadWholeFile 再发 FILE；否则发 RICH_TEXT。
+ *
+ * @param agentWorkspaceDir  可选。Agent 在宿主机的 workspace 绝对路径（由 resolveAgentWorkspaceDir 得到）。
+ *                           用于在多沙箱 agent 场景下正确解析 /workspace/ 前缀路径。
+ *                           未传时回退到 process.cwd()，单 agent 部署下行为不变。
+ */
+export async function sendReplyDeliverBlock(config, token, groupId, payload, atUserIds = [], log, _deprecatedMsgId, reply, agentWorkspaceDir) {
+    // 一个投递块一个 clientMsgId：内部 6 次重试复用同值 → 命中服务端去重，不重复投递。
+    const clientMsgId = generateClientMsgId();
+    const textToSend = stripModelUsageFooter(stripMediaDirectiveLines((payload.markdown || payload.text || "").trim()));
+    const mediaList = [
+        ...(payload.mediaUrl ? [payload.mediaUrl] : []),
+        ...((payload.mediaUrls ?? []).filter((u) => typeof u === "string" && u.trim())),
+    ];
+    const uniqueUrls = [...new Set(mediaList)];
+    const maxBytes = resolveMaxAttachmentBytes(config);
+    const formField = config.fileUploadFormField?.trim() || "file";
+    const wantFile = uniqueUrls.length > 0 && !payload.isThinking;
+    sendLogInfo(log, `[cwork_im:send] sendReplyDeliverBlock plan kind=${wantFile ? "FILE" : textToSend.length > 0 ? "RICH_TEXT" : "none"} ` +
+        `clientMsgId=${clientMsgId} ` +
+        `isThinking=${payload.isThinking ?? false}`);
+    if (wantFile) {
+        const fileUploadUrl = resolveResourceUploadUrl(config.baseUrl);
+        if (!agentWorkspaceDir?.trim() && uniqueUrls.some((u) => {
+            const t = u.trim();
+            return t.startsWith("/workspace") || parseWorkspaceRelativeMediaRef(t) != null;
+        })) {
+            sendLogWarn(log, `[cwork_im:send] agentWorkspaceDir missing for workspace media; ` +
+                `falling back to cwd and /workspace candidates (text-only unaffected) refs=${uniqueUrls.length}`);
+        }
+        try {
+            const attachments = [];
+            for (const u of uniqueUrls) {
+                const { buffer, filename } = await downloadMediaBuffer(u, maxBytes, log, agentWorkspaceDir);
+                const { fileId } = await uploadWholeResourceFile({
+                    fileUploadUrl,
+                    token,
+                    buffer,
+                    filename,
+                    formField,
+                    log,
+                });
+                attachments.push({
+                    fileId,
+                    fileType: "FILE",
+                    format: formatFromFilename(filename),
+                    name: filename,
+                    size: buffer.length,
+                    source: "resource",
+                });
+            }
+            const caption = textToSend.length > 0 ? textToSend : " ";
+            await postImMessage(config, token, groupId, {
+                type: "FILE",
+                text: caption,
+                attachments,
+                clientMsgId,
+                ...(reply ? { reply } : {}),
+            }, atUserIds, log);
+            return;
+        }
+        catch (err) {
+            sendLogError(log, `[cwork_im:send] FILE deliver failed, fallback to text if any: ${formatDeliverError(err)}`);
+            const fallbackText = buildFileDeliverFallbackText(textToSend, uniqueUrls, err);
+            // 下载/上传失败不阻塞：仍发 RICH_TEXT，并附带原始媒体链接
+            await postImMessage(config, token, groupId, {
+                type: "RICH_TEXT",
+                text: fallbackText,
+                clientMsgId,
+                ...(reply ? { reply } : {}),
+            }, atUserIds, log);
+            return;
+        }
+    }
+    if (textToSend.length > 0) {
+        await postImMessage(config, token, groupId, {
+            type: "RICH_TEXT",
+            text: textToSend,
+            clientMsgId,
+            ...(reply ? { reply } : {}),
+        }, atUserIds, log);
+    }
+}
+/**
+ * 发送一条已上传资源的 FILE 消息到指定 IM 群聊。
+ *
+ * 与 {@link sendReplyDeliverBlock} 不同：本函数**不做** URL 下载 / 上传失败降级为文本的逻辑，
+ * 仅负责把已经拿到 fileId 的附件组装成 FILE 消息发出。失败直接抛出，由调用方（工具）返回明确错误，
+ * 不会产生「降级成文本却报成功」的假成功。上传步骤请在调用前用
+ * {@link uploadWholeResourceFileWithRetry} 完成。
+ *
+ * 复用 {@link postImMessage} 的 6 次网络重试与服务端 clientMsgId 去重。
+ */
+export async function sendUploadedFileMessage(args) {
+    const caption = args.caption && args.caption.trim().length > 0 ? args.caption : " ";
+    const clientMsgId = args.clientMsgId ?? generateClientMsgId();
+    const sent = await postImMessage(args.config, args.token, args.groupId, {
+        type: "FILE",
+        text: caption,
+        attachments: [args.attachment],
+        clientMsgId,
+        ...(args.reply ? { reply: args.reply } : {}),
+    }, args.atUserIds ?? [], args.log);
+    return { clientMsgId, serverMsgId: sent.serverMsgId };
+}
+/**
+ * 发送文本消息到指定 IM 群聊。
+ *
+ * @param config     插件配置
+ * @param token      鉴权 token
+ * @param groupId    目标群聊 ID（gid / groupId）
+ * @param content    消息内容文本
+ * @param atUserIds  需要 @ 的用户 ID 列表（可为空）
+ * @param log        日志接口
+ * @param _deprecatedMsgId  已废弃的占位消息 ID 参数，不再使用（保留以兼容旧调用签名）
+ * @param reply      可选的被回复消息信息（用于在 IM 中建立“回复某条消息”的关联）
+ */
+export async function sendTextMessage(config, token, groupId, content, atUserIds = [], log, _deprecatedMsgId, reply) {
+    const text = stripModelUsageFooter(stripMediaDirectiveLines(content.trim()));
+    if (!text)
+        return;
+    await postImMessage(config, token, groupId, {
+        type: "RICH_TEXT",
+        text,
+        clientMsgId: generateClientMsgId(),
+        ...(reply ? { reply } : {}),
+    }, atUserIds, log);
+}
+//# sourceMappingURL=send-service.js.map

package/dist/src/delivery/send-service.js.map

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

package/dist/src/delivery/send-service.test.d.ts

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

package/dist/src/delivery/send-service.test.d.ts.map

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

package/dist/src/delivery/send-service.test.js

@@ -0,0 +1,40 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { extractSentMessageInfo, generateClientMsgId } from "./send-service.js";
+describe("generateClientMsgId", () => {
+    it("is unique per call (distinct logical messages)", () => {
+        const a = generateClientMsgId();
+        const b = generateClientMsgId();
+        assert.notEqual(a, b);
+        assert.match(a, /^ocw_\d+_/);
+    });
+});
+describe("extractSentMessageInfo", () => {
+    it("reads server id and echoed clientMsgId from real send response", () => {
+        const res = {
+            resultCode: 1,
+            resultMsg: null,
+            data: {
+                id: "2077657906769403905",
+                groupId: "2072518674467676162",
+                type: "TEXT",
+                text: "1",
+                clientMsgId: "temp_1784187222818_oe8fjl",
+            },
+        };
+        const info = extractSentMessageInfo(res);
+        assert.equal(info.serverMsgId, "2077657906769403905");
+        assert.equal(info.clientMsgId, "temp_1784187222818_oe8fjl");
+    });
+    it("coerces numeric id to string", () => {
+        const info = extractSentMessageInfo({ data: { id: 12345 } });
+        assert.equal(info.serverMsgId, "12345");
+    });
+    it("returns empty when data missing or malformed", () => {
+        assert.deepEqual(extractSentMessageInfo(null), {});
+        assert.deepEqual(extractSentMessageInfo({}), {});
+        assert.deepEqual(extractSentMessageInfo({ data: null }), {});
+        assert.deepEqual(extractSentMessageInfo({ data: "nope" }), {});
+    });
+});
+//# sourceMappingURL=send-service.test.js.map

package/dist/src/delivery/send-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-service.test.js","sourceRoot":"","sources":["../../../src/delivery/send-service.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,mBAAmB,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,mBAAmB,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACtE,MAAM,GAAG,GAAG;YACR,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,IAAI;YACf,IAAI,EAAE;gBACF,EAAE,EAAE,qBAAqB;gBACzB,OAAO,EAAE,qBAAqB;gBAC9B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,GAAG;gBACT,WAAW,EAAE,2BAA2B;aAC3C;SACJ,CAAC;QACF,MAAM,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,2BAA2B,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACpC,MAAM,IAAI,GAAG,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,SAAS,CAAC,sBAAsB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/src/delivery/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/delivery/thinking-ws-progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.js","sourceRoot":"","sources":["../../../src/delivery/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/delivery/thinking-ws-progress.test.d.ts

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

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

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

package/dist/src/delivery/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/delivery/thinking-ws-progress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-ws-progress.test.js","sourceRoot":"","sources":["../../../src/delivery/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/delivery/turn-deliver-buffer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 一轮 dispatch 内的 assistant 正文段缓冲：
+ * - 同段修稿（新文延展/包住旧文）→ 覆盖
+ * - 流式分块新段 → 追加合并
+ * 在 tool 边界或轮次结束冲刷 HTTP。
+ */
+import type { ReplyDeliverPayload } from "./send-service.js";
+export type DeliverFlushKind = "interim" | "final";
+export type BufferedDeliverEntry = {
+    payload: ReplyDeliverPayload;
+    textPart: string;
+    rawTextPart: string;
+    hasMedia: boolean;
+};
+export type TurnDeliverBufferStats = {
+    writeCount: number;
+    /** write 时判定为修稿并覆盖 */
+    revisionOverwriteCount: number;
+    /** write 时判定为新段并追加 */
+    segmentAppendCount: number;
+    flushInterimCount: number;
+    flushFinalCount: number;
+    skippedDuplicateFlushCount: number;
+};
+export type TakeForFlushResult = {
+    status: "empty";
+} | {
+    status: "skipped_duplicate";
+    entry: BufferedDeliverEntry;
+} | {
+    status: "ready";
+    entry: BufferedDeliverEntry;
+};
+/** deliver 正文/附件是否值得写入 buffer 或立即 HTTP。 */
+export declare function isDeliverPayloadSendable(args: {
+    textPart: string;
+    hasMedia: boolean;
+    isThinking?: boolean;
+}): boolean;
+/**
+ * 新文是否像对旧文的「修稿/延展」（可安全覆盖），而非另一完整分块。
+ * 无权威 OpenClaw 标记，偏保守：宁可追加重复，不可覆盖丢段。
+ */
+export declare function isDeliverTextRevision(oldText: string, newText: string): boolean;
+/**
+ * 段边界 / 轮末 flush 时，判断是否可用 `onPartialReply` 全量快照覆盖 deliver 拼接文本。
+ * 仅当快照（归一化后）与缓冲文本相等或为其超集时才覆盖，避免流式竞态下快照落后导致截断丢内容。
+ */
+export declare function snapshotSupersedesBufferText(snapshot: string, bufferText: string): boolean;
+export declare class TurnDeliverBuffer {
+    private buffer;
+    private lastFlushedComparable;
+    private readonly stats;
+    hasContent(): boolean;
+    getStats(): TurnDeliverBufferStats;
+    write(entry: BufferedDeliverEntry): void;
+    takeForFlush(kind: DeliverFlushKind): TakeForFlushResult;
+    clear(): void;
+}
+//# sourceMappingURL=turn-deliver-buffer.d.ts.map

package/dist/src/delivery/turn-deliver-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-deliver-buffer.d.ts","sourceRoot":"","sources":["../../../src/delivery/turn-deliver-buffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B,EAAE,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEvD,2CAA2C;AAC3C,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAEV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS/E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM1F;AA0BD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,qBAAqB,CAAM;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAOpB;IAEF,UAAU,IAAI,OAAO;IAIrB,QAAQ,IAAI,sBAAsB;IAIlC,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAiBxC,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB;IAiCxD,KAAK,IAAI,IAAI;CAGhB"}