@zeyiy/openclaw-channel 0.3.4

package/dist/media.js

@@ -0,0 +1,206 @@
+import { File } from "node:buffer";
+import { randomUUID } from "node:crypto";
+import { appendFileSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { getRecvAndGroupID } from "./targets";
+/** 写入 /tmp/openim-debug.log，用于排查消息发送问题 */
+function debugLog(msg) {
+    const ts = new Date().toISOString();
+    try {
+        appendFileSync("/tmp/openim-debug.log", `${ts} ${msg}\n`);
+    }
+    catch { }
+}
+function isUrl(input) {
+    return /^https?:\/\//i.test(input.trim());
+}
+function toLocalPath(input) {
+    const raw = input.trim();
+    if (raw.startsWith("file://"))
+        return decodeURIComponent(raw.slice("file://".length));
+    return raw;
+}
+function guessMime(pathOrName, fallback = "application/octet-stream") {
+    const ext = extname(pathOrName).toLowerCase();
+    const table = {
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".png": "image/png",
+        ".gif": "image/gif",
+        ".bmp": "image/bmp",
+        ".webp": "image/webp",
+        ".mp4": "video/mp4",
+        ".mov": "video/quicktime",
+        ".mkv": "video/x-matroska",
+        ".avi": "video/x-msvideo",
+        ".pdf": "application/pdf",
+        ".txt": "text/plain",
+        ".json": "application/json",
+        ".zip": "application/zip",
+        ".doc": "application/msword",
+        ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        ".xls": "application/vnd.ms-excel",
+        ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    };
+    return table[ext] || fallback;
+}
+function inferNameFromUrl(url, fallback) {
+    try {
+        const u = new URL(url);
+        const name = basename(u.pathname || "");
+        return name || fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+async function readLocalAsFile(pathInput, forcedName) {
+    const filePath = toLocalPath(pathInput);
+    const st = await stat(filePath);
+    const data = await readFile(filePath);
+    const fileName = forcedName?.trim() || basename(filePath) || `file-${Date.now()}`;
+    const mime = guessMime(fileName);
+    const file = new File([data], fileName, { type: mime });
+    return { file, filePath, fileName, size: st.size, mime };
+}
+/**
+ * 发送文本消息到指定目标（用户或群组）。
+ *
+ * 群聊场景下，会自动识别文本中的 @提及（支持 <@ID> 和 @ID 两种格式），
+ * 将其转换为 OpenIM 的 at-text 消息（contentType=106），使接收方能正确
+ * 识别 @提及并触发 requireMention 回复机制。
+ */
+export async function sendTextToTarget(client, target, text) {
+    const recvID = target.kind === "user" ? target.id : "";
+    const groupID = target.kind === "group" ? target.id : "";
+    let message;
+    if (target.kind === "group") {
+        // 统一 <@ID> 和 @ID 两种格式，收集去重后的被 @ 用户 ID
+        const atIDs = new Set();
+        const normalizedText = text.replace(/<@(\d{6,})>/g, (_m, id) => { atIDs.add(id); return `@${id}`; });
+        for (const m of normalizedText.matchAll(/@(\d{6,})/g))
+            atIDs.add(m[1]);
+        if (atIDs.size > 0) {
+            const atUserIDList = [...atIDs];
+            // 查询被 @ 用户的群昵称，用于客户端高亮显示
+            let atUsersInfo = atUserIDList.map((id) => ({ atUserID: id, groupNickname: id }));
+            try {
+                const membersRes = await client.sdk.getSpecifiedGroupMembersInfo({ groupID: target.id, userIDList: atUserIDList });
+                if (membersRes?.data) {
+                    const nickMap = new Map(membersRes.data.map((m) => [m.userID, m.nickname || m.groupNickname || m.userID]));
+                    atUsersInfo = atUserIDList.map((id) => ({ atUserID: id, groupNickname: nickMap.get(id) || id }));
+                }
+            }
+            catch (e) {
+                debugLog(`[send] 查询群成员昵称失败: ${e}`);
+            }
+            // 创建 at-text 消息（contentType=106）
+            try {
+                const created = await client.sdk.createTextAtMessage({ text: normalizedText, atUserIDList, atUsersInfo });
+                message = created?.data;
+                debugLog(`[send] at消息 group=${target.id} atUsers=${JSON.stringify(atUsersInfo)}`);
+            }
+            catch (e) {
+                debugLog(`[send] createTextAtMessage 失败，回退为普通文本: ${e}`);
+            }
+        }
+    }
+    // 非 at 场景或 at 消息创建失败时，回退为普通文本消息
+    if (!message) {
+        const created = await client.sdk.createTextMessage(text);
+        message = created?.data;
+        if (!message)
+            throw new Error("createTextMessage failed");
+    }
+    await client.sdk.sendMessage({ recvID, groupID, message });
+}
+export async function sendImageToTarget(client, target, image) {
+    const input = image.trim();
+    if (!input)
+        throw new Error("image is empty");
+    let message;
+    if (isUrl(input)) {
+        const name = inferNameFromUrl(input, "image.jpg");
+        const pic = {
+            uuid: randomUUID(),
+            type: guessMime(name, "image/jpeg"),
+            size: 0,
+            width: 0,
+            height: 0,
+            url: input,
+        };
+        const created = await client.sdk.createImageMessageByURL({
+            sourcePicture: pic,
+            bigPicture: { ...pic },
+            snapshotPicture: { ...pic },
+            sourcePath: name,
+        });
+        message = created?.data;
+    }
+    else {
+        const local = await readLocalAsFile(input);
+        const pic = {
+            uuid: randomUUID(),
+            type: local.mime,
+            size: local.size,
+            width: 0,
+            height: 0,
+            url: "",
+        };
+        const created = await client.sdk.createImageMessageByFile({
+            sourcePicture: pic,
+            bigPicture: { ...pic },
+            snapshotPicture: { ...pic },
+            sourcePath: local.filePath,
+            file: local.file,
+        });
+        message = created?.data;
+    }
+    if (!message)
+        throw new Error("createImageMessage failed");
+    const { recvID, groupID } = getRecvAndGroupID(target);
+    await client.sdk.sendMessage({ recvID, groupID, message });
+}
+export async function sendVideoToTarget(client, target, video, name) {
+    const input = video.trim();
+    if (!input)
+        throw new Error("video is empty");
+    // Product policy: do not send OpenIM video messages; send videos as file messages.
+    await sendFileToTarget(client, target, input, name);
+}
+export async function sendFileToTarget(client, target, filePathOrUrl, name) {
+    const input = filePathOrUrl.trim();
+    if (!input)
+        throw new Error("file is empty");
+    let message;
+    if (isUrl(input)) {
+        const fileName = name?.trim() || inferNameFromUrl(input, "file.bin");
+        const created = await client.sdk.createFileMessageByURL({
+            filePath: fileName,
+            fileName,
+            uuid: randomUUID(),
+            sourceUrl: input,
+            fileSize: 0,
+            fileType: guessMime(fileName),
+        });
+        message = created?.data;
+    }
+    else {
+        const local = await readLocalAsFile(input, name);
+        const created = await client.sdk.createFileMessageByFile({
+            filePath: local.filePath,
+            fileName: local.fileName,
+            uuid: randomUUID(),
+            sourceUrl: "",
+            fileSize: local.size,
+            fileType: local.mime,
+            file: local.file,
+        });
+        message = created?.data;
+    }
+    if (!message)
+        throw new Error("createFileMessage failed");
+    const { recvID, groupID } = getRecvAndGroupID(target);
+    await client.sdk.sendMessage({ recvID, groupID, message });
+}

package/dist/polyfills.d.ts

@@ -0,0 +1,9 @@
+declare class NodeFileReaderPolyfill {
+    result: ArrayBuffer | null;
+    error: Error | null;
+    onload: ((ev: {
+        target: NodeFileReaderPolyfill;
+    }) => void) | null;
+    onerror: ((err: unknown) => void) | null;
+    readAsArrayBuffer(blob: Blob): void;
+}

package/dist/polyfills.js

@@ -0,0 +1,22 @@
+"use strict";
+class NodeFileReaderPolyfill {
+    result = null;
+    error = null;
+    onload = null;
+    onerror = null;
+    readAsArrayBuffer(blob) {
+        void blob
+            .arrayBuffer()
+            .then((buffer) => {
+            this.result = buffer;
+            this.onload?.({ target: this });
+        })
+            .catch((err) => {
+            this.error = err instanceof Error ? err : new Error(String(err));
+            this.onerror?.(err);
+        });
+    }
+}
+if (typeof globalThis.FileReader === "undefined") {
+    globalThis.FileReader = NodeFileReaderPolyfill;
+}

package/dist/portal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Portal Bridge — WebSocket client that connects to agent-portal cloud service.
+ *
+ * Establishes a persistent WS connection to agent-portal using botId as the unique identifier.
+ * Handles requests from portal to manage local openclaw agents, files, and models.
+ * Lifecycle is tied to the OpenIM account: starts/stops alongside the account.
+ */
+import type { OpenIMAccountConfig } from "./types";
+export declare function startPortalBridge(api: any, config: OpenIMAccountConfig): void;
+export declare function stopPortalBridge(api: any, accountId: string): void;
+export declare function stopAllPortalBridges(api: any): void;