@xgjktech/xg_cwork_im 1.11.3 → 1.11.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg_cwork_im",
-  "version": "1.11.3",
+  "version": "1.11.5",
   "description": "XG CWork IM channel plugin for OpenClaw",
   "keywords": [
     "bot",
@@ -11,18 +11,19 @@
   ],
   "license": "MIT",
   "type": "module",
-  "main": "index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
     ".npmrc",
-    "index.ts",
-    "src/*.ts",
+    "dist/**/*",
     "openclaw.plugin.json"
   ],
   "scripts": {
+    "build": "tsc -p tsconfig.json",
     "type-check": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit",
     "install:prod": "npm install --omit=dev",
-    "prepublishOnly": "npm run type-check"
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@sinclair/typebox": "^0.32.0",
@@ -40,7 +41,7 @@
   },
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ],
     "channels": [
       "xg_cwork_im"

package/src/recommended-system-prompt.ts

@@ -1,3 +0,0 @@
-/** 建议复制到 `channels.xg_cwork_im.systemPrompt`。 */
-export const XG_IM_RECOMMENDED_CHANNEL_SYSTEM_PROMPT =
-    "发文件给用户时，在回复正文里单独写一行 `MEDIA:<路径>`，例如：MEDIA:/workspace/report.pdf。路径支持 /workspace/…、file://…、http(s)://…。OpenClaw 会自动读取该路径并让通道上传，用户可直接在 IM 中下载。不要把路径当作已发送；也不要上传到外部网站。";

package/src/send-service.ts

@@ -1,283 +0,0 @@
-/**
- * XG-IM 消息发送模块
- *
- * 调用 IM 接口将 AI 回复发送到指定群聊，并 @ 原始发送者。
- * 支持 RICH_TEXT 与带资源 fileId 的 FILE 类型（attachments）。
- */
-
-import axios from "axios";
-import type { Log } from "./auth.js";
-import {
-    downloadMediaBuffer,
-    formatFromFilename,
-    resolveMaxAttachmentBytes,
-    resolveResourceUploadUrl,
-    uploadWholeResourceFile,
-} from "./resource-file.js";
-import type { SendMessageBody, SendMessageFileAttachment, SendMessageReply, XgImConfig } from "./types.js";
-
-function formatDeliverError(err: unknown): string {
-    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);
-}
-
-/**
- * 发消息接口的重试参数。
- *
- * 总尝试次数 = 1（首次） + IM_SEND_MAX_RETRIES（重试） = 6，间隔约 1 秒。
- * 仅对网络层瞬时错误（无响应 / 5xx / 408 / 429）重试；4xx 与业务 resultCode 错误视为永久失败，立即抛出。
- */
-const IM_SEND_MAX_RETRIES = 5;
-const IM_SEND_RETRY_DELAY_MS = 1_000;
-
-function delay(ms: number): Promise<void> {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-/**
- * 判断错误是否值得重试。
- *
- * - axios 网络错误 / 超时 / 5xx / 408 / 429 → 重试
- * - 4xx（其它）/ 业务 resultCode 错误（普通 Error）→ 永久失败，不重试
- */
-function isRetryableSendError(err: unknown): boolean {
-    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;
-}
-
-async function postImMessage(
-    config: XgImConfig,
-    token: string,
-    groupId: string,
-    body: SendMessageBody,
-    atUserIds: string[] = [],
-    log?: Log,
-): Promise<void> {
-    const url = `${config.baseUrl}/im/message/send`;
-    const full: SendMessageBody = {
-        ...body,
-        groupId,
-        ...(atUserIds.length > 0 ? { atUserIds } : {}),
-    } as SendMessageBody;
-
-    log?.info(`[cwork_im:send] POST ${url} groupId=${groupId} type=${full.type} atUsers=${JSON.stringify(atUserIds)}`);
-    if (config.debug) {
-        log?.debug?.(`[cwork_im:send] Request body: ${JSON.stringify(full)}`);
-    }
-
-    const totalAttempts = 1 + IM_SEND_MAX_RETRIES;
-    let lastErr: unknown = 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,
-            });
-
-            log?.info(`[cwork_im:send] Response status=${res.status} (attempt=${attempt}/${totalAttempts})`);
-            if (config.debug) {
-                log?.debug?.(`[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 as Record<string, unknown>).resultCode;
-                const resultMsg = (d as Record<string, unknown>).resultMsg;
-                if (resultCode !== undefined && resultCode !== 1) {
-                    throw new Error(
-                        `IM API error resultCode=${resultCode}${resultMsg ? ` resultMsg=${resultMsg}` : ""}`,
-                    );
-                }
-            }
-            return;
-        } catch (err: unknown) {
-            lastErr = err;
-            const msg = formatDeliverError(err);
-            const retryable = isRetryableSendError(err);
-            const isLast = attempt >= totalAttempts;
-
-            if (!retryable || isLast) {
-                log?.error(
-                    `[cwork_im:send] Failed to send message to groupId=${groupId} ` +
-                        `(attempt=${attempt}/${totalAttempts}, retryable=${retryable}): ${msg}`,
-                );
-                throw err;
-            }
-
-            const warn = log?.warn ?? log?.info;
-            warn?.(
-                `[cwork_im:send] Send failed (attempt=${attempt}/${totalAttempts}), ` +
-                    `retrying in ${IM_SEND_RETRY_DELAY_MS}ms: ${msg}`,
-            );
-            await delay(IM_SEND_RETRY_DELAY_MS);
-        }
-    }
-
-    // 理论上不可达：上面循环里要么 return 要么 throw。这里只是给 TS 一个安全兜底。
-    throw lastErr ?? new Error("[cwork_im:send] Send failed after retries");
-}
-
-/** OpenClaw dispatch deliver 单块载荷：文本 + 可选媒体 URL（与 plugin-sdk 约定对齐）。 */
-export type ReplyDeliverPayload = {
-    markdown?: string;
-    text?: string;
-    isThinking?: boolean;
-    mediaUrl?: string;
-    mediaUrls?: string[];
-};
-
-/**
- * 将 deliver 块发到 IM：若有媒体则先 POST baseUrl/file/upDownload/uploadWholeFile 再发 FILE；否则发 RICH_TEXT。
- */
-export async function sendReplyDeliverBlock(
-    config: XgImConfig,
-    token: string,
-    groupId: string,
-    payload: ReplyDeliverPayload,
-    atUserIds: string[] = [],
-    log?: Log,
-    msgId?: string,
-    reply?: SendMessageReply,
-): Promise<void> {
-    const textToSend = (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;
-
-    if (wantFile) {
-        const fileUploadUrl = resolveResourceUploadUrl(config.baseUrl);
-        try {
-            const attachments: SendMessageFileAttachment[] = [];
-            for (const u of uniqueUrls) {
-                const { buffer, filename } = await downloadMediaBuffer(u, maxBytes, log);
-                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,
-                    ...(msgId ? { msgId } : {}),
-                    ...(reply ? { reply } : {}),
-                },
-                atUserIds,
-                log,
-            );
-            return;
-        } catch (err: unknown) {
-            log?.error(`[cwork_im:send] FILE deliver failed, fallback to text if any: ${formatDeliverError(err)}`);
-            const errNote = `（文件发送失败：${formatDeliverError(err)}）`;
-            const fallbackText = textToSend.length > 0 ? `${textToSend}\n\n${errNote}` : errNote;
-            await postImMessage(
-                config,
-                token,
-                groupId,
-                {
-                    type: "RICH_TEXT",
-                    text: fallbackText,
-                    ...(msgId ? { msgId } : {}),
-                    ...(reply ? { reply } : {}),
-                },
-                atUserIds,
-                log,
-            );
-            return;
-        }
-    }
-
-    if (textToSend.length > 0) {
-        await postImMessage(
-            config,
-            token,
-            groupId,
-            {
-                type: "RICH_TEXT",
-                text: textToSend,
-                ...(msgId ? { msgId } : {}),
-                ...(reply ? { reply } : {}),
-            },
-            atUserIds,
-            log,
-        );
-    }
-}
-
-/**
- * 发送文本消息到指定 IM 群聊。
- *
- * @param config     插件配置
- * @param token      鉴权 token
- * @param groupId    目标群聊 ID（gid / groupId）
- * @param content    消息内容文本
- * @param atUserIds  需要 @ 的用户 ID 列表（可为空）
- * @param log        日志接口
- * @param msgId      可选的业务消息 ID（用于覆盖/更新已有消息）
- * @param reply      可选的被回复消息信息（用于在 IM 中建立“回复某条消息”的关联）
- */
-export async function sendTextMessage(
-    config: XgImConfig,
-    token: string,
-    groupId: string,
-    content: string,
-    atUserIds: string[] = [],
-    log?: Log,
-    msgId?: string,
-    reply?: SendMessageReply,
-): Promise<void> {
-    await postImMessage(
-        config,
-        token,
-        groupId,
-        {
-            type: "RICH_TEXT",
-            text: content,
-            ...(msgId ? { msgId } : {}),
-            ...(reply ? { reply } : {}),
-        },
-        atUserIds,
-        log,
-    );
-}