@xgjktech/xg_cwork_im 1.19.28 → 1.19.29

package/dist/src/send-group-message-tool.js

@@ -0,0 +1,82 @@
+/**
+ * XG-IM「主动推消息」工具（供 OpenClaw 在非对话场景下调用）
+ *
+ * 用途：定时任务、Cron、后台任务等需要 **经本 channel 主动把结果推送到 IM 群** 时，发一条纯文本。
+ * **不用于**用户正通过 IM 与助手聊天时的回合内回复——那种情况走正常助手回复流，用不上本工具。
+ *
+ * 通过 api.registerTool() 注入，工具内部自动获取机器人 token。
+ */
+import { Type } from "@sinclair/typebox";
+import { prefixProactiveOutboundText } from "./inbound-terminal-delivery.js";
+import { toolJsonResult } from "./tool-json-result.js";
+import { getToken } from "./auth.js";
+import { sendTextMessage } from "./send-service.js";
+import { resolveAccountConfig } from "./group-history-tool.js";
+// ─── 工具参数 Schema ─────────────────────────────────────────────────────────
+const SendGroupMessageParams = Type.Object({
+    groupId: Type.String({
+        description: "目标群聊 ID（IM 系统的群组唯一标识符，即 groupId / gid）",
+    }),
+    accountId: Type.Optional(Type.String({
+        description: "（可选）要使用的 xg_cwork_im 账户 ID（即 accounts 的 key）；若省略则使用当前 IM 通道绑定的账户（由网关注入）。",
+    })),
+    text: Type.String({
+        description: "要发送的消息内容（仅纯文本，不支持附件/文件）",
+    }),
+    atUserIds: Type.Optional(Type.Array(Type.String(), {
+        description: "需要 @ 的用户 ID 列表，可为空数组",
+    })),
+});
+// ─── 工具构建函数 ─────────────────────────────────────────────────────────────
+/**
+ * 构建「主动推送群消息」工具（纯文本）。
+ * 建议使用工厂 `(ctx) => buildSendGroupMessageTool(cfg, hints)` 注册以带上通道账户上下文。
+ */
+export function buildSendGroupMessageTool(config, hints) {
+    return {
+        name: "xg_cwork_im_send_group_message",
+        label: "【xg_cwork_im】主动推送群消息（纯文本）",
+        description: [
+            "【用途】仅用于 OpenClaw **主动推消息**：例如定时任务 / Cron / 后台任务完成后，经 xg_cwork_im 向群里发一条**纯文字**结果或通知。",
+            "【不要用错】用户正在 IM 里和助手**对话**时，**不要**用本工具回话——对话回复由 OpenClaw 正常走 channel，**用不上**本工具。",
+            "【发文件】本工具**只能发纯文本，不能发附件**。用户要「发报告/发文件」时，必须改用 `xg_cwork_im_send_file` 工具（传 workspace 相对路径）；禁止用 MEDIA 或上传到外站。",
+            "【参数】groupId 为 IM 群唯一 ID；主动推送时若需告知某人，可填 atUserIds。",
+        ].join("\n"),
+        parameters: SendGroupMessageParams,
+        async execute(_toolCallId, params) {
+            const { groupId, text, atUserIds = [] } = params;
+            const accountId = params.accountId ?? hints?.channelAccountId;
+            console.log(`[cwork_im][tool] xg_cwork_im_send_group_message called: groupId=${groupId} atUsers=${JSON.stringify(atUserIds)}`);
+            let identity;
+            try {
+                const accountConfig = resolveAccountConfig(config, accountId);
+                identity = await getToken(accountConfig);
+                console.log(`[cwork_im][tool] xg_cwork_im_send_group_message token acquired for userId=${identity.userId} using accountId=${accountId ?? "0"}`);
+            }
+            catch (err) {
+                return toolJsonResult({
+                    ok: false,
+                    error: `Failed to obtain access token: ${String(err)}`,
+                });
+            }
+            try {
+                const accountConfig = resolveAccountConfig(config, accountId);
+                const outboundText = prefixProactiveOutboundText(text, "cron");
+                await sendTextMessage(accountConfig, identity.token, groupId, outboundText, atUserIds);
+                console.log(`[cwork_im][tool] xg_cwork_im_send_group_message success: groupId=${groupId} trigger=cron using accountId=${accountId ?? "0"}`);
+            }
+            catch (err) {
+                return toolJsonResult({
+                    ok: false,
+                    error: `Failed to send message to group ${groupId}: ${String(err)}`,
+                });
+            }
+            return toolJsonResult({
+                ok: true,
+                groupId,
+                sentBy: identity.userId,
+            });
+        },
+    };
+}
+//# sourceMappingURL=send-group-message-tool.js.map

package/dist/src/send-group-message-tool.js.map

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

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

@@ -0,0 +1,83 @@
+/**
+ * XG-IM 消息发送模块
+ *
+ * 调用 IM 接口将 AI 回复发送到指定群聊，并 @ 原始发送者。
+ * 支持 RICH_TEXT 与带资源 fileId 的 FILE 类型（attachments）。
+ */
+import type { Log } from "./auth.js";
+import type { SendMessageFileAttachment, SendMessageReply, XgImConfig } from "./types.js";
+/**
+ * 生成一次投递的客户端幂等键。
+ *
+ * 服务端按 `clientMsgId + groupId + 最近 10 分钟` 去重：同一逻辑消息在其内部 6 次重试间
+ * 复用同一 `clientMsgId`，超时/断连重发会命中服务端已有消息，不产生重复气泡。
+ * 每个独立投递块生成一次（不同块必须不同）。
+ */
+export declare function generateClientMsgId(): string;
+/** 从发送接口响应中解析服务端消息 id（`data.id`）与回显 `clientMsgId`，用于对账日志。 */
+export declare function extractSentMessageInfo(resData: unknown): {
+    serverMsgId?: string;
+    clientMsgId?: string;
+};
+/** OpenClaw dispatch deliver 单块载荷：文本 + 可选媒体 URL（与 plugin-sdk 约定对齐）。 */
+export type ReplyDeliverPayload = {
+    markdown?: string;
+    text?: string;
+    isThinking?: boolean;
+    mediaUrl?: string;
+    mediaUrls?: string[];
+    /** OpenClaw 运营通知：模型 failover 状态变化（非助手正文） */
+    isFallbackNotice?: boolean;
+    isCompactionNotice?: boolean;
+    isError?: boolean;
+    /** OpenClaw assistant thinking/reasoning 块（对应 transcript type: thinking） */
+    isReasoning?: boolean;
+};
+/**
+ * 将 deliver 块发到 IM：若有媒体则先 POST baseUrl/file/upDownload/uploadWholeFile 再发 FILE；否则发 RICH_TEXT。
+ *
+ * @param agentWorkspaceDir  可选。Agent 在宿主机的 workspace 绝对路径（由 resolveAgentWorkspaceDir 得到）。
+ *                           用于在多沙箱 agent 场景下正确解析 /workspace/ 前缀路径。
+ *                           未传时回退到 process.cwd()，单 agent 部署下行为不变。
+ */
+export declare function sendReplyDeliverBlock(config: XgImConfig, token: string, groupId: string, payload: ReplyDeliverPayload, atUserIds?: string[], log?: Log, _deprecatedMsgId?: string, reply?: SendMessageReply, agentWorkspaceDir?: string): Promise<void>;
+/**
+ * 发送一条已上传资源的 FILE 消息到指定 IM 群聊。
+ *
+ * 与 {@link sendReplyDeliverBlock} 不同：本函数**不做** URL 下载 / 上传失败降级为文本的逻辑，
+ * 仅负责把已经拿到 fileId 的附件组装成 FILE 消息发出。失败直接抛出，由调用方（工具）返回明确错误，
+ * 不会产生「降级成文本却报成功」的假成功。上传步骤请在调用前用
+ * {@link uploadWholeResourceFileWithRetry} 完成。
+ *
+ * 复用 {@link postImMessage} 的 6 次网络重试与服务端 clientMsgId 去重。
+ */
+export declare function sendUploadedFileMessage(args: {
+    config: XgImConfig;
+    token: string;
+    groupId: string;
+    /** 附件说明；为空时用单空格占位，避免部分 IM 接口拒收空文本 */
+    caption?: string;
+    attachment: SendMessageFileAttachment;
+    atUserIds?: string[];
+    /** 幂等键；省略时自动生成 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+    log?: Log;
+}): Promise<{
+    clientMsgId: string;
+    serverMsgId?: string;
+}>;
+/**
+ * 发送文本消息到指定 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 declare function sendTextMessage(config: XgImConfig, token: string, groupId: string, content: string, atUserIds?: string[], log?: Log, _deprecatedMsgId?: string, reply?: SendMessageReply): Promise<void>;
+//# sourceMappingURL=send-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send-service.d.ts","sourceRoot":"","sources":["../../src/send-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAWrC,OAAO,KAAK,EAAmB,yBAAyB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA6B3G;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAQvG;AA0KD,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,gBAAgB,EACxB,iBAAiB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Gf;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/src/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 "./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/send-service.js.map

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

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

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

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

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

package/dist/src/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/send-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-service.test.js","sourceRoot":"","sources":["../../src/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/session-env-store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 会话级环境变量存储：按 sessionKey 保存每个会话的 exec 环境变量，
+ * 供 before_tool_call 向 exec 子进程注入（多用户并发安全，不碰 process.env）。
+ *
+ * 语义：同一群内消息按当前会话写入；subagent 的权威父链由 OpenClaw
+ * Session 元数据提供，linkChildSession 仅保留作运行时兼容/性能回退。
+ *
+ * 持久化：仅持久化会话级 env（当前为 XG_OPENAPI_APP_KEY）。写入后防抖落盘到
+ * stateDir/xgjktech/session-env.json，openclaw 重启后恢复；subagent 父子链是
+ * 运行时关系，不持久化。baseUrl 等配置值不在此存储（hook 侧直接读配置）。
+ */
+export declare const XG_OPENAPI_APP_KEY = "XG_OPENAPI_APP_KEY";
+/** 过滤非法/危险 env 键值对（key 命名、长度、null 字节）。 */
+export declare function sanitizeSessionEnv(env: Record<string, string>): Record<string, string>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * 初始化持久化（register(api) 时调用一次，传入 api.runtime.state.resolveStateDir()）。
+ * 读盘加载到内存；失败降级为纯内存模式，绝不抛。
+ * 进程级共享：整个进程只从磁盘加载一次，避免插件重载后新模块实例重新 init 覆盖共享内存态。
+ */
+export declare function initSessionEnvPersistence(stateDir: string): void;
+/** 立即落盘（测试 / 进程退出钩子使用）。 */
+export declare function flushSessionEnvPersistence(): void;
+/** 合并写入某个会话的 env（覆盖同 key；空/非法值会被过滤）。 */
+export declare function setSessionEnv(sessionKey: string, env: Record<string, string>): void;
+/** 设置/删除某个会话的单个 env 键；value 为 undefined 时删除。 */
+export declare function setSessionEnvEntry(sessionKey: string, key: string, value: string | undefined): void;
+/** 读取某个会话的 env 快照（浅拷贝）。 */
+export declare function getSessionEnv(sessionKey: string): Record<string, string> | undefined;
+/** 清空某个会话的 env 与父子关联。 */
+export declare function clearSessionEnv(sessionKey: string): void;
+/** 删除某个会话的单个 env 键。 */
+export declare function removeSessionEnvKey(sessionKey: string, key: string): void;
+/** 登记 subagent 子会话到父会话的关联，供 exec env 父子链反查。 */
+export declare function linkChildSession(childSessionKey: string, parentSessionKey: string): void;
+/** 读取运行时登记的 child -> parent 关系；仅作为宿主父链不可用时的兼容回退。 */
+export declare function getLinkedParentSessionKey(sessionKey: string | undefined): string | undefined;
+/** Record the last IM sender for optional Cron binding audit metadata. */
+export declare function setSessionUserContext(sessionKey: string, userId?: string, userName?: string): void;
+export declare function getSessionUserContext(sessionKey: string | undefined): {
+    userId?: string;
+    userName?: string;
+} | undefined;
+/**
+ * 解析某个会话应注入 exec 的 env：先查本会话；查不到则沿 subagent 父子链
+ * 反查父会话（限深，防环）。subagent 内 exec 触发 hook 时 sessionKey 是子会话 key。
+ */
+export declare function resolveEnvForSession(sessionKey: string | undefined): Record<string, string>;
+export declare function __resetSessionEnvStoreForTests(): void;
+/**
+ * 插件真卸载/网关停止时：先把待写数据落盘，再清空共享内存与定时器并复位持久化机器
+ * （下次进程/重载可重新从磁盘加载）。注意：热重载接管场景不应调用本函数（见 plugin-dispose）。
+ */
+export declare function disposeSessionEnvStore(): void;
+//# sourceMappingURL=session-env-store.d.ts.map

package/dist/src/session-env-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-env-store.d.ts","sourceRoot":"","sources":["../../src/session-env-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAsDvD,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQtF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AA+GD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQhE;AAED,2BAA2B;AAC3B,wBAAgB,0BAA0B,IAAI,IAAI,CASjD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CASnF;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAqBN;AAED,2BAA2B;AAC3B,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAMpF;AAED,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED,uBAAuB;AACvB,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAIxF;AAED,oDAAoD;AACpD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAGlG;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAExH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAc3F;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAkB7C"}