ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/http.js

@@ -0,0 +1,168 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+exports.__esModule = true;
+exports.readResponseBodyAsBuffer = exports.wecomFetch = void 0;
+var undici_1 = require("undici");
+var proxyDispatchers = new Map();
+/**
+ * **getProxyDispatcher (获取代理 Dispatcher)**
+ *
+ * 缓存并复用 ProxyAgent，避免重复创建连接池。
+ */
+function getProxyDispatcher(proxyUrl) {
+    var existing = proxyDispatchers.get(proxyUrl);
+    if (existing)
+        return existing;
+    var created = new undici_1.ProxyAgent(proxyUrl);
+    proxyDispatchers.set(proxyUrl, created);
+    return created;
+}
+function mergeAbortSignal(params) {
+    var signals = [];
+    if (params.signal)
+        signals.push(params.signal);
+    if (params.timeoutMs && Number.isFinite(params.timeoutMs) && params.timeoutMs > 0) {
+        signals.push(AbortSignal.timeout(params.timeoutMs));
+    }
+    if (!signals.length)
+        return undefined;
+    if (signals.length === 1)
+        return signals[0];
+    return AbortSignal.any(signals);
+}
+/**
+ * **wecomFetch (统一 HTTP 请求)**
+ *
+ * 基于 `undici` 的 fetch 封装，自动处理 ProxyAgent 和 Timeout。
+ * 所有对企业微信 API 的调用都应经过此函数。
+ */
+function wecomFetch(input, init, opts) {
+    var _a, _b, _c, _d, _e;
+    return __awaiter(this, void 0, void 0, function () {
+        var proxyUrl, dispatcher, initSignal, signal, headers, nextInit, err_1, cause;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    proxyUrl = (_b = (_a = opts === null || opts === void 0 ? void 0 : opts.proxyUrl) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "";
+                    dispatcher = proxyUrl ? getProxyDispatcher(proxyUrl) : undefined;
+                    initSignal = (_c = init === null || init === void 0 ? void 0 : init.signal) !== null && _c !== void 0 ? _c : undefined;
+                    signal = mergeAbortSignal({ signal: (_d = opts === null || opts === void 0 ? void 0 : opts.signal) !== null && _d !== void 0 ? _d : initSignal, timeoutMs: opts === null || opts === void 0 ? void 0 : opts.timeoutMs });
+                    headers = new Headers((_e = init === null || init === void 0 ? void 0 : init.headers) !== null && _e !== void 0 ? _e : {});
+                    if (!headers.has("User-Agent")) {
+                        headers.set("User-Agent", "OpenClaw/2.0 (WeCom-Agent)");
+                    }
+                    nextInit = __assign(__assign(__assign(__assign({}, (init !== null && init !== void 0 ? init : {})), (signal ? { signal: signal } : {})), (dispatcher ? { dispatcher: dispatcher } : {})), { headers: headers });
+                    _f.label = 1;
+                case 1:
+                    _f.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, undici_1.fetch(input, nextInit)];
+                case 2: return [2 /*return*/, _f.sent()];
+                case 3:
+                    err_1 = _f.sent();
+                    if (err_1 instanceof Error && err_1.name === "TypeError" && err_1.message === "fetch failed") {
+                        cause = err_1.cause;
+                        console.error("[wecom-http] fetch failed: " + input + " (proxy: " + (proxyUrl || "none") + ")" + (cause ? " - cause: " + String(cause) : ""));
+                    }
+                    throw err_1;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.wecomFetch = wecomFetch;
+/**
+ * **readResponseBodyAsBuffer (读取响应 Body)**
+ *
+ * 将 Response Body 读取为 Buffer，支持最大字节限制以防止内存溢出。
+ * 适用于下载媒体文件等场景。
+ */
+function readResponseBodyAsBuffer(res, maxBytes) {
+    return __awaiter(this, void 0, void 0, function () {
+        var limit, chunks, total, reader, _a, done, value, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    if (!res.body)
+                        return [2 /*return*/, Buffer.alloc(0)];
+                    limit = maxBytes && Number.isFinite(maxBytes) && maxBytes > 0 ? maxBytes : undefined;
+                    chunks = [];
+                    total = 0;
+                    reader = res.body.getReader();
+                    _c.label = 1;
+                case 1:
+                    if (!true) return [3 /*break*/, 8];
+                    return [4 /*yield*/, reader.read()];
+                case 2:
+                    _a = _c.sent(), done = _a.done, value = _a.value;
+                    if (done)
+                        return [3 /*break*/, 8];
+                    if (!value)
+                        return [3 /*break*/, 1];
+                    total += value.byteLength;
+                    if (!(limit && total > limit)) return [3 /*break*/, 7];
+                    _c.label = 3;
+                case 3:
+                    _c.trys.push([3, 5, , 6]);
+                    return [4 /*yield*/, reader.cancel("body too large")];
+                case 4:
+                    _c.sent();
+                    return [3 /*break*/, 6];
+                case 5:
+                    _b = _c.sent();
+                    return [3 /*break*/, 6];
+                case 6: throw new Error("response body too large (>" + limit + " bytes)");
+                case 7:
+                    chunks.push(value);
+                    return [3 /*break*/, 1];
+                case 8: return [2 /*return*/, Buffer.concat(chunks.map(function (c) { return Buffer.from(c); }))];
+            }
+        });
+    });
+}
+exports.readResponseBodyAsBuffer = readResponseBodyAsBuffer;

package/dist/src/im-runtime-telemetry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * im-agent-hub 进程内运行态打点（与 bridges/main registerImRuntimeTelemetryGlobals 对齐）。
+ */
+declare type ImRuntimePlatform = "wecom";
+export declare function imRuntimeRecordChannelActivity(platform: ImRuntimePlatform, botAccountId: string, direction: "inbound" | "outbound", atMs?: number): void;
+export declare function imRuntimeSetChannelStatus(params: {
+    platform: ImRuntimePlatform;
+    botAccountId: string;
+    linkStatus?: "connecting" | "connected" | "degraded" | "disconnected" | "error";
+    lastError?: string | null;
+    lastEvent?: string | null;
+    lastEventAt?: number;
+    running?: boolean;
+    connected?: boolean;
+    restartPending?: boolean;
+    reconnectCount?: number;
+}): void;
+export declare function imRuntimeRecordTransportDisconnect(params: {
+    platform: ImRuntimePlatform;
+    botAccountId: string;
+    atMs?: number;
+    error?: string | null;
+    loggedOut?: boolean;
+}): void;
+export {};

package/dist/src/im-runtime-telemetry.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * im-agent-hub 进程内运行态打点（与 bridges/main registerImRuntimeTelemetryGlobals 对齐）。
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+exports.__esModule = true;
+exports.imRuntimeRecordTransportDisconnect = exports.imRuntimeSetChannelStatus = exports.imRuntimeRecordChannelActivity = void 0;
+function callGlobal(name, payload) {
+    try {
+        var fn = globalThis[name];
+        if (typeof fn === "function") {
+            fn(payload);
+        }
+    }
+    catch (_a) {
+        // ignore telemetry failures
+    }
+}
+function imRuntimeRecordChannelActivity(platform, botAccountId, direction, atMs) {
+    var id = String(botAccountId || "").trim();
+    if (!id)
+        return;
+    callGlobal("__IM_RUNTIME_RECORD_CHANNEL_ACTIVITY__", __assign({ platform: platform, bot_account_id: id, direction: direction }, (atMs != null && Number.isFinite(atMs) ? { at_ms: atMs } : {})));
+}
+exports.imRuntimeRecordChannelActivity = imRuntimeRecordChannelActivity;
+function imRuntimeSetChannelStatus(params) {
+    var id = String(params.botAccountId || "").trim();
+    if (!id)
+        return;
+    callGlobal("__IM_RUNTIME_SET_CHANNEL_STATUS__", __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({ platform: params.platform, bot_account_id: id }, (params.linkStatus ? { link_status: params.linkStatus } : {})), (params.lastError !== undefined ? { last_error: params.lastError } : {})), (params.lastEvent ? { last_event: params.lastEvent } : {})), (params.lastEventAt != null && Number.isFinite(params.lastEventAt)
+        ? { last_event_at: params.lastEventAt, last_heartbeat_at: params.lastEventAt }
+        : {})), (typeof params.running === "boolean" ? { running: params.running } : {})), (typeof params.connected === "boolean" ? { connected: params.connected } : {})), (typeof params.restartPending === "boolean"
+        ? { restart_pending: params.restartPending }
+        : {})), (typeof params.reconnectCount === "number"
+        ? { reconnect_count: params.reconnectCount }
+        : {})), { status_source: "event" }));
+}
+exports.imRuntimeSetChannelStatus = imRuntimeSetChannelStatus;
+function imRuntimeRecordTransportDisconnect(params) {
+    var _a;
+    var id = String(params.botAccountId || "").trim();
+    if (!id)
+        return;
+    imRuntimeSetChannelStatus({
+        platform: params.platform,
+        botAccountId: id,
+        linkStatus: "disconnected",
+        lastError: (_a = params.error) !== null && _a !== void 0 ? _a : null,
+        lastEvent: params.loggedOut ? "transport_logged_out" : "transport_disconnect",
+        lastEventAt: params.atMs,
+        running: false,
+        connected: false
+    });
+    callGlobal("__IM_RUNTIME_RECORD_TRANSPORT_DISCONNECT__", __assign(__assign(__assign({ platform: params.platform, bot_account_id: id }, (params.atMs != null && Number.isFinite(params.atMs)
+        ? { at_ms: params.atMs }
+        : {})), (params.error != null ? { error: params.error } : {})), (params.loggedOut === true ? { logged_out: true } : {})));
+}
+exports.imRuntimeRecordTransportDisconnect = imRuntimeRecordTransportDisconnect;

package/dist/src/interface.d.ts

@@ -0,0 +1,192 @@
+/**
+ * 企业微信渠道类型定义
+ */
+/// <reference types="node" />
+import type { OpenClawConfig } from "ylib-openclaw/plugin-sdk";
+import type { RuntimeEnv } from "ylib-openclaw/plugin-sdk";
+import type { ResolvedWeComAccount } from "./utils.js";
+import { WeComCommand } from "./const.js";
+/**
+ * Monitor 配置选项
+ */
+export declare type WeComMonitorOptions = {
+    account: ResolvedWeComAccount;
+    config: OpenClawConfig;
+    runtime: RuntimeEnv;
+    abortSignal?: AbortSignal;
+    /** 框架层提供的状态更新回调，用于在致命错误场景中标记 channel 已停止 */
+    setStatus?: (next: Record<string, unknown>) => void;
+};
+/**
+ * 消息状态
+ */
+export interface MessageState {
+    accumulatedText: string;
+    /** 流式回复的 streamId，用于保持同一个流式回复使用相同的 streamId */
+    streamId?: string;
+    /** 是否已成功发送过媒体文件 */
+    hasMedia?: boolean;
+    /** 是否有媒体发送失败（权限不足、文件过大等） */
+    hasMediaFailed?: boolean;
+    /** 媒体发送失败时的纯文本错误摘要（用于替换 thinking 流展示给用户） */
+    mediaErrorSummary?: string;
+    /** 流式回复是否已过期（errcode 846608，>6分钟），需降级为主动发送 */
+    streamExpired?: boolean;
+    /** 当前流式回复创建时间，用于本地提前降级，避免企微服务端 846608。 */
+    streamStartedAt?: number;
+    /** 流式超时降级提示是否已经主动发送，避免重复提醒。 */
+    streamExpiryNoticeSent?: boolean;
+    /** 是否已成功发送过模板卡片 */
+    hasTemplateCard?: boolean;
+}
+/** 从文本中提取的模板卡片 */
+export interface ExtractedTemplateCard {
+    /** 原始 JSON 对象（已验证 card_type 合法） */
+    cardJson: Record<string, unknown>;
+    /** card_type 值 */
+    cardType: string;
+}
+/** extractTemplateCards 返回值 */
+export interface TemplateCardExtractionResult {
+    /** 提取到的合法模板卡片列表 */
+    cards: ExtractedTemplateCard[];
+    /** 移除卡片代码块后的剩余文本 */
+    remainingText: string;
+}
+/**
+ * WebSocket 请求消息基础格式
+ */
+export interface WeComRequest {
+    cmd: string;
+    headers: {
+        req_id: string;
+    };
+    body: any;
+}
+/**
+ * WebSocket 响应消息格式
+ */
+export interface WeComResponse {
+    headers: {
+        req_id: string;
+    };
+    errcode: number;
+    errmsg: string;
+}
+/**
+ * 企业微信认证请求
+ */
+export interface WeComSubscribeRequest extends WeComRequest {
+    cmd: WeComCommand.SUBSCRIBE;
+    body: {
+        secret: string;
+        bot_id: string;
+    };
+}
+/**
+ * 企业微信推送消息格式
+ */
+export interface WeComCallbackMessage {
+    cmd: WeComCommand.AIBOT_CALLBACK | "aibot_event_callback";
+    headers: {
+        req_id: string;
+    };
+    body: {
+        msgid: string;
+        aibotid: string;
+        chatid?: string;
+        chattype: "single" | "group";
+        from: {
+            userid: string;
+        };
+        response_url: string;
+        msgtype: "text" | "image" | "voice" | "video" | "file" | "stream" | "mixed" | "event";
+        text?: {
+            content: string;
+        };
+        image?: {
+            /** 图片 URL（通过 URL 方式接收图片时） */
+            url?: string;
+            /** 图片 base64 数据（直接传输时） */
+            base64?: string;
+            md5?: string;
+        };
+        /** 图文混排消息 */
+        mixed?: {
+            msg_item: Array<{
+                msgtype: "text" | "image";
+                text?: {
+                    content: string;
+                };
+                image?: {
+                    url?: string;
+                    base64?: string;
+                    md5?: string;
+                };
+            }>;
+        };
+        quote?: {
+            msgtype: string;
+            text?: {
+                content: string;
+            };
+            image?: {
+                url?: string;
+                aeskey?: string;
+            };
+            file?: {
+                url?: string;
+                aeskey?: string;
+            };
+        };
+        stream?: {
+            id: string;
+        };
+        event?: {
+            eventtype: string;
+            template_card_event?: {
+                card_type?: string;
+                event_key?: string;
+                task_id?: string;
+                selected_items?: {
+                    selected_item?: Array<{
+                        question_key?: string;
+                        option_ids?: {
+                            option_id?: string[];
+                        };
+                    }>;
+                };
+            };
+        };
+    };
+}
+/**
+ * 企业微信响应消息格式
+ */
+export interface WeComResponseMessage extends WeComRequest {
+    cmd: WeComCommand.AIBOT_RESPONSE;
+    body: {
+        msgtype: "stream" | "text" | "markdown";
+        stream?: {
+            id: string;
+            finish: boolean;
+            content: string;
+            msg_item?: Array<{
+                msgtype: "image" | "file";
+                image?: {
+                    base64: string;
+                    md5: string;
+                };
+            }>;
+            feedback?: {
+                id: string;
+            };
+        };
+        text?: {
+            content: string;
+        };
+        markdown?: {
+            content: string;
+        };
+    };
+}

package/dist/src/interface.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * 企业微信渠道类型定义
+ */
+exports.__esModule = true;

package/dist/src/markdown-chunk.d.ts

@@ -0,0 +1 @@
+export declare function splitMarkdownIntoSafeChunks(text: string, hardLimitBytes: number): string[];