ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/monitor.js

@@ -0,0 +1,1846 @@
+"use strict";
+/**
+ * 企业微信 WebSocket 监控器主模块
+ *
+ * 负责：
+ * - 建立和管理 WebSocket 连接
+ * - 协调消息处理流程（解析→策略检查→下载图片→路由回复）
+ * - 资源生命周期管理
+ *
+ * 子模块：
+ * - message-parser.ts  : 消息内容解析
+ * - message-sender.ts  : 消息发送（带超时保护）
+ * - media-handler.ts   : 图片下载和保存（带超时保护）
+ * - group-policy.ts    : 群组访问控制
+ * - dm-policy.ts       : 私聊访问控制
+ * - state-manager.ts   : 全局状态管理（带 TTL 清理）
+ * - timeout.ts         : 超时工具
+ */
+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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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 };
+    }
+};
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+exports.__esModule = true;
+exports.__monitorTestables = exports.monitorWeComProvider = void 0;
+var os = __importStar(require("os"));
+var path = __importStar(require("path"));
+var aibot_node_sdk_1 = require("@wecom/aibot-node-sdk");
+var const_js_1 = require("./const.js");
+var dm_policy_js_1 = require("./dm-policy.js");
+var dynamic_routing_js_1 = require("./dynamic-routing.js");
+var group_policy_js_1 = require("./group-policy.js");
+var media_handler_js_1 = require("./media-handler.js");
+var media_uploader_js_1 = require("./media-uploader.js");
+var message_parser_js_1 = require("./message-parser.js");
+var message_sender_js_1 = require("./message-sender.js");
+var openclaw_compat_js_1 = require("./openclaw-compat.js");
+var runtime_js_1 = require("./runtime.js");
+var state_manager_js_1 = require("./state-manager.js");
+var template_card_manager_js_1 = require("./template-card-manager.js");
+var template_card_parser_js_1 = require("./template-card-parser.js");
+var utils_js_1 = require("./utils.js");
+var version_js_1 = require("./version.js");
+var endpoint_event_adapter_js_1 = require("./endpoint-event-adapter.js");
+var endpoint_dispatch_js_1 = require("./endpoint-dispatch.js");
+var im_runtime_telemetry_js_1 = require("./im-runtime-telemetry.js");
+var proactive_markdown_send_js_1 = require("./proactive-markdown-send.js");
+// ============================================================================
+// 附件超限提示文案
+// ============================================================================
+/**
+ * 构造「附件超过 OpenClaw 大小限制」的中文提示文案。
+ */
+function buildMediaOversizeHintText(err) {
+    var maxMb = err.maxBytes / 1024 / 1024;
+    return "\u5F53\u524DOpenClaw\u9650\u5236\u6587\u4EF6\u4E0D\u8D85\u8FC7" + maxMb + "MB\uFF0C\u8BF7\u4FEE\u6539OpenClaw\u914D\u7F6E\u3002";
+}
+// ============================================================================
+// 媒体本地路径白名单扩展
+// ============================================================================
+/**
+ * 在 getDefaultMediaLocalRoots() 基础上，将 stateDir 本身也加入白名单，
+ * 并合并用户在 WeComConfig 中配置的自定义 mediaLocalRoots。
+ *
+ * getDefaultMediaLocalRoots() 仅包含 stateDir 下的子目录（media/agents/workspace/sandboxes），
+ * 但 agent 生成的文件可能直接放在 stateDir 根目录下（如 ~/.openclaw-dev/1.png），
+ * 因此需要将 stateDir 本身也加入白名单以避免 LocalMediaAccessError。
+ *
+ * 用户可在 openclaw.json 中配置：
+ * {
+ *   "channels": {
+ *     "wecom": {
+ *       "mediaLocalRoots": ["~/Downloads", "~/Documents"]
+ *     }
+ *   }
+ * }
+ */
+function getExtendedMediaLocalRoots(config) {
+    return __awaiter(this, void 0, void 0, function () {
+        var defaults, roots, stateDir, _i, _a, r, resolved;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, openclaw_compat_js_1.getDefaultMediaLocalRoots()];
+                case 1:
+                    defaults = _b.sent();
+                    roots = __spreadArrays(defaults);
+                    stateDir = path.resolve(openclaw_compat_js_1.resolveStateDir());
+                    if (!roots.includes(stateDir)) {
+                        roots.push(stateDir);
+                    }
+                    // 合并用户在 WeComConfig 中配置的自定义路径
+                    if (config === null || config === void 0 ? void 0 : config.mediaLocalRoots) {
+                        for (_i = 0, _a = config.mediaLocalRoots; _i < _a.length; _i++) {
+                            r = _a[_i];
+                            resolved = path.resolve(r.replace(/^~(?=\/|$)/, os.homedir()));
+                            if (!roots.includes(resolved)) {
+                                roots.push(resolved);
+                            }
+                        }
+                    }
+                    return [2 /*return*/, roots];
+            }
+        });
+    });
+}
+// ============================================================================
+// 媒体发送错误提示
+// ============================================================================
+/**
+ * 根据媒体发送结果生成纯文本错误摘要（用于替换 thinking 流式消息展示给用户）。
+ *
+ * 使用纯文本而非 markdown 格式，因为 replyStream 只支持纯文本。
+ */
+function buildMediaErrorSummary(mediaUrl, result) {
+    var _a;
+    if ((_a = result.error) === null || _a === void 0 ? void 0 : _a.includes("LocalMediaAccessError")) {
+        return "\u26A0\uFE0F \u6587\u4EF6\u53D1\u9001\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u8DEF\u5F84 " + mediaUrl + "\n\u8BF7\u5728 openclaw.json \u7684 mediaLocalRoots \u4E2D\u6DFB\u52A0\u8BE5\u8DEF\u5F84\u7684\u7236\u76EE\u5F55\u540E\u91CD\u542F\u751F\u6548\u3002";
+    }
+    if (result.rejectReason) {
+        return "\u26A0\uFE0F \u6587\u4EF6\u53D1\u9001\u5931\u8D25\uFF1A" + result.rejectReason;
+    }
+    return "\u26A0\uFE0F \u6587\u4EF6\u53D1\u9001\u5931\u8D25\uFF1A\u65E0\u6CD5\u5904\u7406\u6587\u4EF6 " + mediaUrl + "\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5\u3002";
+}
+function extractUserFacingErrorMessage(raw) {
+    var text = String(raw || "").trim();
+    if (!text)
+        return "";
+    var codeErrorPrefix = "endpoint code error:";
+    if (text.toLowerCase().startsWith(codeErrorPrefix)) {
+        return text.slice(codeErrorPrefix.length).trim();
+    }
+    var endpointErrorPrefix = "endpoint error ";
+    if (text.toLowerCase().startsWith(endpointErrorPrefix)) {
+        return text;
+    }
+    return text;
+}
+var const_js_2 = require("./const.js");
+__createBinding(exports, const_js_2, "WeComCommand");
+var state_manager_js_2 = require("./state-manager.js");
+__createBinding(exports, state_manager_js_2, "getWeComWebSocket");
+__createBinding(exports, state_manager_js_2, "setReqIdForChat");
+__createBinding(exports, state_manager_js_2, "getReqIdForChatAsync");
+__createBinding(exports, state_manager_js_2, "getReqIdForChat");
+__createBinding(exports, state_manager_js_2, "deleteReqIdForChat");
+__createBinding(exports, state_manager_js_2, "warmupReqIdStore");
+__createBinding(exports, state_manager_js_2, "flushReqIdStore");
+var message_sender_js_2 = require("./message-sender.js");
+__createBinding(exports, message_sender_js_2, "sendWeComReply");
+// ============================================================================
+// 消息上下文构建
+// ============================================================================
+function pickSenderDisplayNameAndFields(body) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    var raw = body;
+    var from = ((_a = body.from) !== null && _a !== void 0 ? _a : {});
+    var fields = {
+        from_name: (_b = from.name) !== null && _b !== void 0 ? _b : null,
+        from_userid: (_c = from.userid) !== null && _c !== void 0 ? _c : null,
+        sender_name: (_d = raw.sender_name) !== null && _d !== void 0 ? _d : null,
+        sender_nickname: (_e = raw.sender_nickname) !== null && _e !== void 0 ? _e : null,
+        sender_nick: (_f = raw.sender_nick) !== null && _f !== void 0 ? _f : null,
+        display_name: (_g = raw.display_name) !== null && _g !== void 0 ? _g : null,
+        user_name: (_h = raw.user_name) !== null && _h !== void 0 ? _h : null,
+        nickname: (_j = raw.nickname) !== null && _j !== void 0 ? _j : null,
+        name: (_k = raw.name) !== null && _k !== void 0 ? _k : null
+    };
+    var candidates = [
+        fields.from_name,
+        fields.sender_name,
+        fields.sender_nickname,
+        fields.sender_nick,
+        fields.display_name,
+        fields.user_name,
+        fields.nickname,
+        fields.name,
+        fields.from_userid,
+    ];
+    for (var _i = 0, candidates_1 = candidates; _i < candidates_1.length; _i++) {
+        var item = candidates_1[_i];
+        var text = String(item !== null && item !== void 0 ? item : "").trim();
+        if (text) {
+            return { selected: text, fields: fields };
+        }
+    }
+    return { selected: "", fields: fields };
+}
+/**
+ * 构建消息上下文
+ * @returns 消息上下文对象
+ */
+function buildMessageContext(frame, account, config, text, mediaList, quoteContent, runtime) {
+    var _a, _b, _c, _d;
+    var core = runtime_js_1.getWeComRuntime();
+    var body = frame.body;
+    var chatId = body.chatid || body.from.userid;
+    var chatType = body.chattype === "group" ? "group" : "direct";
+    var senderId = String(body.from.userid || "").trim();
+    var sessionPeerId = utils_js_1.resolveWecomSessionPeerId({
+        chatType: chatType,
+        chatId: chatId,
+        senderId: senderId,
+        separateSessionByConversation: account.config.separateSessionByConversation,
+        groupSessionScope: account.config.groupSessionScope
+    });
+    var senderInfo = pickSenderDisplayNameAndFields(body);
+    var selectedSenderName = senderInfo.selected || String(body.from.userid || "").trim();
+    (_a = runtime === null || runtime === void 0 ? void 0 : runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][inbound][sender-name] account=" + account.accountId + " from=" + String(body.from.userid || "").trim() + " selected=\"" + selectedSenderName + "\" fields=" + JSON.stringify(senderInfo.fields));
+    // 解析路由信息
+    var route = core.channel.routing.resolveAgentRoute({
+        cfg: config,
+        channel: const_js_1.CHANNEL_ID,
+        accountId: account.accountId,
+        peer: {
+            kind: chatType,
+            id: sessionPeerId
+        }
+    });
+    // ===== 动态 Agent 路由注入 =====
+    var routingResult = dynamic_routing_js_1.processDynamicRouting({
+        route: route,
+        config: config,
+        core: core,
+        accountId: account.accountId,
+        chatType: chatType === "group" ? "group" : "dm",
+        chatId: chatId,
+        senderId: body.from.userid,
+        log: (runtime === null || runtime === void 0 ? void 0 : runtime.log) ? function () {
+            var _a;
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+        } : undefined,
+        error: (runtime === null || runtime === void 0 ? void 0 : runtime.error) ? function () {
+            var _a;
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            return (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+        } : undefined
+    });
+    // 应用动态路由结果
+    if (routingResult.routeModified) {
+        route.agentId = routingResult.finalAgentId;
+        route.sessionKey = routingResult.finalSessionKey;
+    }
+    // ===== 动态 Agent 路由注入结束 =====
+    // 构建会话标签
+    var fromLabel = chatType === "group" ? "group:" + chatId : "user:" + body.from.userid;
+    // 当只有媒体没有文本时，使用占位符标识媒体类型
+    var hasImages = mediaList.some(function (m) { var _a; return (_a = m.contentType) === null || _a === void 0 ? void 0 : _a.startsWith("image/"); });
+    var messageBody = text ||
+        (mediaList.length > 0
+            ? hasImages
+                ? const_js_1.MEDIA_IMAGE_PLACEHOLDER
+                : const_js_1.MEDIA_DOCUMENT_PLACEHOLDER
+            : "");
+    // 构建多媒体数组
+    var mediaPaths = mediaList.length > 0 ? mediaList.map(function (m) { return m.path; }) : undefined;
+    var mediaTypes = mediaList.length > 0
+        ? mediaList.map(function (m) { return m.contentType; }).filter(Boolean)
+        : undefined;
+    // 使用 route.agentId 解析 storePath（多 agent 场景下 session 路径隔离）
+    var storePath = core.channel.session.resolveStorePath((_b = config.session) === null || _b === void 0 ? void 0 : _b.store, {
+        agentId: route.agentId
+    });
+    // 构建标准消息上下文
+    var ctxPayload = core.channel.reply.finalizeInboundContext({
+        Body: messageBody,
+        RawBody: messageBody,
+        CommandBody: messageBody,
+        MessageSid: body.msgid,
+        From: chatType === "group" ? const_js_1.CHANNEL_ID + ":group:" + chatId : const_js_1.CHANNEL_ID + ":" + body.from.userid,
+        To: const_js_1.CHANNEL_ID + ":" + chatId,
+        SenderId: body.from.userid,
+        SenderName: selectedSenderName,
+        SessionKey: route.sessionKey,
+        AccountId: route.accountId,
+        ChatType: chatType,
+        ConversationLabel: fromLabel,
+        Timestamp: Date.now(),
+        Provider: const_js_1.CHANNEL_ID,
+        Surface: const_js_1.CHANNEL_ID,
+        OriginatingChannel: const_js_1.CHANNEL_ID,
+        OriginatingTo: const_js_1.CHANNEL_ID + ":" + chatId,
+        CommandAuthorized: true,
+        ResponseUrl: body.response_url,
+        ReqId: frame.headers.req_id,
+        WeComFrame: frame,
+        MediaPath: (_c = mediaList[0]) === null || _c === void 0 ? void 0 : _c.path,
+        MediaType: (_d = mediaList[0]) === null || _d === void 0 ? void 0 : _d.contentType,
+        MediaPaths: mediaPaths,
+        MediaTypes: mediaTypes,
+        MediaUrls: mediaPaths,
+        ReplyToBody: quoteContent
+    });
+    return { ctxPayload: ctxPayload, route: route, storePath: storePath, chatId: chatId, chatType: chatType };
+}
+/**
+ * 发送"思考中"消息
+ */
+function sendThinkingReply(params) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, frame, streamId, runtime, state, accountId, err_1;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    wsClient = params.wsClient, frame = params.frame, streamId = params.streamId, runtime = params.runtime, state = params.state, accountId = params.accountId;
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, message_sender_js_1.sendWeComReply({
+                            wsClient: wsClient,
+                            frame: frame,
+                            text: const_js_1.THINKING_MESSAGE,
+                            runtime: runtime,
+                            finish: false,
+                            streamId: streamId,
+                            accountId: accountId
+                        })];
+                case 2:
+                    _c.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    err_1 = _c.sent();
+                    if (err_1 instanceof message_sender_js_1.StreamExpiredError && state) {
+                        state.streamExpired = true;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] Stream expired during thinking reply, will fallback to proactive send");
+                    }
+                    else {
+                        (_b = runtime.error) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom] Failed to send thinking message: " + String(err_1));
+                    }
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function isStreamReplyLocallyExpired(state, now) {
+    if (now === void 0) { now = Date.now(); }
+    if (!state.streamId || !state.streamStartedAt)
+        return false;
+    return now - state.streamStartedAt >= const_js_1.STREAM_REPLY_LOCAL_TTL_MS;
+}
+function markStreamReplyLocallyExpired(state, runtime, reason) {
+    var _a, _b, _c;
+    if (state.streamExpired)
+        return true;
+    if (!isStreamReplyLocallyExpired(state))
+        return false;
+    state.streamExpired = true;
+    var ageMs = Date.now() - ((_a = state.streamStartedAt) !== null && _a !== void 0 ? _a : Date.now());
+    (_b = runtime.log) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom] Stream local TTL reached, switch to proactive send: reason=" + reason + ", ageMs=" + ageMs + ", ttlMs=" + const_js_1.STREAM_REPLY_LOCAL_TTL_MS + ", streamId=" + ((_c = state.streamId) !== null && _c !== void 0 ? _c : ""));
+    return true;
+}
+function sendStreamExpiryNotice(ctx, reason) {
+    var _a, _b, _c;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, frame, state, account, runtime, body, chatId, noticeText, err_2;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    wsClient = ctx.wsClient, frame = ctx.frame, state = ctx.state, account = ctx.account, runtime = ctx.runtime;
+                    if (state.streamExpiryNoticeSent)
+                        return [2 /*return*/];
+                    state.streamExpiryNoticeSent = true;
+                    body = frame.body;
+                    chatId = body.chatid || body.from.userid;
+                    noticeText = "本次回复处理时间较长，企业微信流式消息已到达时间限制，后续内容将改为普通消息继续发送。";
+                    _d.label = 1;
+                case 1:
+                    _d.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, proactive_markdown_send_js_1.sendWeComMarkdownMessageChunks({
+                            wsClient: wsClient,
+                            chatId: chatId,
+                            text: noticeText,
+                            runtime: runtime,
+                            accountId: account.accountId,
+                            label: "stream-expiry-notice"
+                        })];
+                case 2:
+                    _d.sent();
+                    (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] Stream expiry notice sent: reason=" + reason + ", streamId=" + ((_b = state.streamId) !== null && _b !== void 0 ? _b : ""));
+                    return [3 /*break*/, 4];
+                case 3:
+                    err_2 = _d.sent();
+                    (_c = runtime.error) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom] Failed to send stream expiry notice: " + String(err_2));
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 上传并发送一批媒体文件（统一走主动发送通道）
+ *
+ * replyMedia（被动回复）无法覆盖 replyStream 发出的 thinking 流式消息，
+ * 因此所有媒体统一走 aibot_send_msg 主动发送。
+ */
+function deriveMediaDisplayFileName(mediaUrl) {
+    var raw = String(mediaUrl || "").trim();
+    if (!raw)
+        return "resource";
+    try {
+        var u = new URL(raw);
+        var name = decodeURIComponent(u.pathname.split("/").pop() || "");
+        if (name)
+            return name;
+    }
+    catch (_a) {
+        var parts = raw.split("/");
+        var name = parts[parts.length - 1] || "";
+        if (name)
+            return name;
+    }
+    return "resource";
+}
+function formatMediaSendResultList(items) {
+    if (!items.length)
+        return "";
+    var lines = ["附件发送结果："];
+    for (var _i = 0, items_1 = items; _i < items_1.length; _i++) {
+        var item = items_1[_i];
+        if (item.ok) {
+            lines.push("- \u6210\u529F: " + item.fileName);
+        }
+        else {
+            lines.push("- \u5931\u8D25: " + item.fileName + "\uFF08\u539F\u56E0: " + (item.reason || "未知错误") + "\uFF09");
+        }
+    }
+    return lines.join("\n");
+}
+function sendMediaBatch(ctx, mediaUrls) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, frame, state, account, runtime, body, chatId, mediaLocalRoots, items, _i, mediaUrls_1, mediaUrl, result, summary;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    wsClient = ctx.wsClient, frame = ctx.frame, state = ctx.state, account = ctx.account, runtime = ctx.runtime;
+                    body = frame.body;
+                    chatId = body.chatid || body.from.userid;
+                    return [4 /*yield*/, getExtendedMediaLocalRoots(account.config)];
+                case 1:
+                    mediaLocalRoots = _c.sent();
+                    items = [];
+                    (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][debug] mediaLocalRoots=" + JSON.stringify(mediaLocalRoots) + ", mediaUrls=" + JSON.stringify(mediaUrls));
+                    _i = 0, mediaUrls_1 = mediaUrls;
+                    _c.label = 2;
+                case 2:
+                    if (!(_i < mediaUrls_1.length)) return [3 /*break*/, 5];
+                    mediaUrl = mediaUrls_1[_i];
+                    return [4 /*yield*/, media_uploader_js_1.uploadAndSendMedia({
+                            wsClient: wsClient,
+                            mediaUrl: mediaUrl,
+                            chatId: chatId,
+                            mediaLocalRoots: mediaLocalRoots,
+                            gatewayToken: account.config.gatewayToken,
+                            gatewayBaseUrl: account.config.gatewayBaseUrl,
+                            log: function () {
+                                var _a;
+                                var args = [];
+                                for (var _i = 0; _i < arguments.length; _i++) {
+                                    args[_i] = arguments[_i];
+                                }
+                                return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                            },
+                            errorLog: function () {
+                                var _a;
+                                var args = [];
+                                for (var _i = 0; _i < arguments.length; _i++) {
+                                    args[_i] = arguments[_i];
+                                }
+                                return (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                            }
+                        })];
+                case 3:
+                    result = _c.sent();
+                    if (result.ok) {
+                        im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", account.accountId, "outbound");
+                        state.hasMedia = true;
+                        items.push({
+                            url: mediaUrl,
+                            fileName: result.fileName || deriveMediaDisplayFileName(mediaUrl),
+                            ok: true
+                        });
+                    }
+                    else {
+                        state.hasMediaFailed = true;
+                        (_b = runtime.error) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom] Media send failed: url=" + mediaUrl + ", reason=" + (result.rejectReason || result.error));
+                        summary = buildMediaErrorSummary(mediaUrl, result);
+                        state.mediaErrorSummary = state.mediaErrorSummary
+                            ? state.mediaErrorSummary + "\n\n" + summary
+                            : summary;
+                        items.push({
+                            url: mediaUrl,
+                            fileName: result.fileName || deriveMediaDisplayFileName(mediaUrl),
+                            ok: false,
+                            reason: result.rejectReason || result.error || "发送失败"
+                        });
+                    }
+                    _c.label = 4;
+                case 4:
+                    _i++;
+                    return [3 /*break*/, 2];
+                case 5: return [2 /*return*/, items];
+            }
+        });
+    });
+}
+/**
+ * 关闭 thinking 流（发送 finish=true 的流式消息）
+ *
+ * thinking 是通过 replyStream 用 streamId 发的流式消息，
+ * 只有同一 streamId 的 replyStream(finish=true) 才能关闭它。
+ *
+ * ⚠️ 注意：企微会忽略空格等不可见内容，必须用有可见字符的文案才能真正
+ *    替换掉 thinking 动画，否则 thinking 会一直残留。
+ *
+ * 关闭策略（按优先级）：
+ * 1. 有可见文本 → 用完整文本关闭
+ * 2. 有模板卡片发送成功 → "📋 卡片消息已发送。"
+ * 3. 有媒体成功发送（通过 deliver 回调） → 用友好提示"文件已发送"
+ * 4. 媒体发送失败 → 直接用错误摘要替换 thinking
+ *
+ * 降级策略：
+ * - 当 streamExpired=true（errcode 846608 或本地 TTL 保护触发）时，流式通道不可用，
+ *   改用 wsClient.sendMessage 主动发送完整文本。
+ *
+ * 注意：模板卡片的检测和发送已在 finishThinkingStream 之前由
+ *       processTemplateCardsIfNeeded 完成，此处只关心最后的消息发送。
+ */
+function finishThinkingStream(ctx) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function () {
+        var wsClient, frame, state, account, runtime, body, chatId, visibleText, finishText, outboundText, expired, err_3;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    wsClient = ctx.wsClient, frame = ctx.frame, state = ctx.state, account = ctx.account, runtime = ctx.runtime;
+                    body = frame.body;
+                    chatId = body.chatid || body.from.userid;
+                    visibleText = state.accumulatedText;
+                    finishText = state.accumulatedText;
+                    if (visibleText) {
+                        finishText = state.accumulatedText;
+                    }
+                    else if (state.hasTemplateCard) {
+                        finishText = "📋 卡片消息已发送。";
+                    }
+                    else if (state.hasMedia) {
+                        if (state.hasMediaFailed && state.mediaErrorSummary) {
+                            finishText = finishText
+                                ? finishText + "\n\n" + state.mediaErrorSummary
+                                : state.mediaErrorSummary;
+                        }
+                        else if (!finishText) {
+                            finishText = "📎 文件已发送，请查收。";
+                        }
+                    }
+                    outboundText = finishText || "当前没有可展示的回复内容";
+                    if (!outboundText) return [3 /*break*/, 7];
+                    expired = state.streamExpired || markStreamReplyLocallyExpired(state, runtime, "finish");
+                    if (!!expired) return [3 /*break*/, 4];
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, message_sender_js_1.sendWeComReply({
+                            wsClient: wsClient,
+                            frame: frame,
+                            text: outboundText,
+                            runtime: runtime,
+                            finish: true,
+                            streamId: state.streamId,
+                            accountId: account.accountId
+                        })];
+                case 2:
+                    _b.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    err_3 = _b.sent();
+                    if (err_3 instanceof message_sender_js_1.StreamExpiredError) {
+                        expired = true;
+                    }
+                    else {
+                        throw err_3;
+                    }
+                    return [3 /*break*/, 4];
+                case 4:
+                    if (!expired) return [3 /*break*/, 7];
+                    (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] Stream expired, sending final text via sendMessage (proactive)");
+                    return [4 /*yield*/, sendStreamExpiryNotice(ctx, "finish")];
+                case 5:
+                    _b.sent();
+                    return [4 /*yield*/, proactive_markdown_send_js_1.sendWeComMarkdownMessageChunks({
+                            wsClient: wsClient,
+                            chatId: chatId,
+                            text: outboundText,
+                            runtime: runtime,
+                            accountId: account.accountId,
+                            label: "stream-expired-final"
+                        })];
+                case 6:
+                    _b.sent();
+                    _b.label = 7;
+                case 7: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 路由消息到核心处理流程并处理回复
+ */
+function routeAndDispatchMessage(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    return __awaiter(this, void 0, void 0, function () {
+        var ctxPayload, route, storePath, chatId, chatType, config, account, wsClient, frame, state, runtime, onCleanup, core, ctx, handledConfirmationKeys, subAgentRunIds, announcedSubAgentRunIds, errorPrefixSent, cleanedUp, safeCleanup, isShowThink, bindingScope, endpoint, body, senderId, senderName, chatName, platformId, dispatchResult, mediaSendItems, mediaResultText, mediaErr_1, errMsg, summary, cardResult_1, cardResult, err_4, userFacingError, cardResult, finishErr_1;
+        var _this = this;
+        return __generator(this, function (_k) {
+            switch (_k.label) {
+                case 0:
+                    ctxPayload = params.ctxPayload, route = params.route, storePath = params.storePath, chatId = params.chatId, chatType = params.chatType, config = params.config, account = params.account, wsClient = params.wsClient, frame = params.frame, state = params.state, runtime = params.runtime, onCleanup = params.onCleanup;
+                    core = runtime_js_1.getWeComRuntime();
+                    ctx = { wsClient: wsClient, frame: frame, state: state, account: account, runtime: runtime };
+                    handledConfirmationKeys = new Set();
+                    subAgentRunIds = new Set();
+                    announcedSubAgentRunIds = new Set();
+                    errorPrefixSent = false;
+                    cleanedUp = false;
+                    safeCleanup = function () {
+                        if (!cleanedUp) {
+                            cleanedUp = true;
+                            onCleanup();
+                        }
+                    };
+                    isShowThink = !((_a = account.sendThinkingMessage) !== null && _a !== void 0 ? _a : true);
+                    _k.label = 1;
+                case 1:
+                    _k.trys.push([1, 16, , 22]);
+                    // 记录 inbound session 元数据（session 追踪）
+                    return [4 /*yield*/, core.channel.session.recordInboundSession({
+                            storePath: storePath,
+                            sessionKey: (_b = ctxPayload.SessionKey) !== null && _b !== void 0 ? _b : route.sessionKey,
+                            ctx: ctxPayload,
+                            updateLastRoute: chatType !== "group"
+                                ? {
+                                    sessionKey: route.mainSessionKey,
+                                    channel: const_js_1.CHANNEL_ID,
+                                    to: const_js_1.CHANNEL_ID + ":" + chatId,
+                                    accountId: route.accountId
+                                }
+                                : undefined,
+                            onRecordError: function (err) {
+                                var _a;
+                                (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] failed updating session meta: " + String(err));
+                            }
+                        })];
+                case 2:
+                    // 记录 inbound session 元数据（session 追踪）
+                    _k.sent();
+                    bindingScope = endpoint_dispatch_js_1.resolveWecomScopeByBindings({
+                        cfg: config,
+                        accountId: account.accountId
+                    });
+                    endpoint = endpoint_dispatch_js_1.resolveWecomEndpointConfig(account.config, bindingScope);
+                    if (!endpoint) return [3 /*break*/, 12];
+                    (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom][endpoint] scope source account.workspaceId=" + String(account.config.workspaceId || account.config.workspace_id || account.config.projectId || account.config.project_id || "") + " binding.workspaceId=" + String((bindingScope === null || bindingScope === void 0 ? void 0 : bindingScope.workspaceId) || "") + " effective.workspaceId=" + endpoint.workspaceId);
+                    if (!(!isShowThink && state.streamId && !state.accumulatedText)) return [3 /*break*/, 4];
+                    return [4 /*yield*/, sendThinkingReply({
+                            wsClient: wsClient,
+                            frame: frame,
+                            streamId: state.streamId,
+                            runtime: runtime,
+                            state: state,
+                            accountId: account.accountId
+                        })];
+                case 3:
+                    _k.sent();
+                    isShowThink = true;
+                    _k.label = 4;
+                case 4:
+                    body = frame.body;
+                    senderId = String(((_d = body.from) === null || _d === void 0 ? void 0 : _d.userid) || "").trim();
+                    senderName = String(((_e = ctxPayload) === null || _e === void 0 ? void 0 : _e.SenderName) || "").trim();
+                    chatName = String(((_f = body) === null || _f === void 0 ? void 0 : _f.chatname) || "").trim();
+                    platformId = String(account.botId || route.accountId || "").trim();
+                    return [4 /*yield*/, endpoint_dispatch_js_1.dispatchWecomViaEndpoint({
+                            endpointConfig: endpoint,
+                            routeAgentId: route.agentId,
+                            accountId: account.accountId,
+                            platformId: platformId,
+                            chatId: chatId,
+                            chatType: chatType === "group" ? "group" : "direct",
+                            senderId: senderId,
+                            senderName: senderName,
+                            chatName: chatName,
+                            userContent: String(ctxPayload.Body || "").trim(),
+                            mediaPath: String(ctxPayload.MediaPath || "").trim() || undefined,
+                            mediaType: String(ctxPayload.MediaType || "").trim() || undefined,
+                            onConfirmationAction: function (confirmationText) { return __awaiter(_this, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, proactive_markdown_send_js_1.sendWeComMarkdownMessageChunks({
+                                                wsClient: wsClient,
+                                                chatId: chatId,
+                                                text: confirmationText,
+                                                runtime: runtime,
+                                                accountId: account.accountId,
+                                                label: "endpoint-confirmation"
+                                            })];
+                                        case 1:
+                                            _a.sent();
+                                            return [2 /*return*/];
+                                    }
+                                });
+                            }); },
+                            onChunk: function (_chunk, accumulated) { return __awaiter(_this, void 0, void 0, function () {
+                                var displayText, err_5;
+                                var _a;
+                                return __generator(this, function (_b) {
+                                    switch (_b.label) {
+                                        case 0:
+                                            state.accumulatedText = accumulated;
+                                            if (!state.streamId || state.streamExpired)
+                                                return [2 /*return*/];
+                                            if (!markStreamReplyLocallyExpired(state, runtime, "endpoint_partial")) return [3 /*break*/, 2];
+                                            return [4 /*yield*/, sendStreamExpiryNotice(ctx, "endpoint_partial_local_ttl")];
+                                        case 1:
+                                            _b.sent();
+                                            return [2 /*return*/];
+                                        case 2:
+                                            _b.trys.push([2, 4, , 8]);
+                                            displayText = template_card_parser_js_1.maskTemplateCardBlocks(state.accumulatedText, function () {
+                                                var _a;
+                                                var args = [];
+                                                for (var _i = 0; _i < arguments.length; _i++) {
+                                                    args[_i] = arguments[_i];
+                                                }
+                                                return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                                            });
+                                            return [4 /*yield*/, message_sender_js_1.sendWeComReply({
+                                                    wsClient: wsClient,
+                                                    frame: frame,
+                                                    text: displayText,
+                                                    runtime: runtime,
+                                                    finish: false,
+                                                    streamId: state.streamId,
+                                                    accountId: account.accountId
+                                                })];
+                                        case 3:
+                                            _b.sent();
+                                            return [3 /*break*/, 8];
+                                        case 4:
+                                            err_5 = _b.sent();
+                                            if (!(err_5 instanceof message_sender_js_1.StreamExpiredError)) return [3 /*break*/, 6];
+                                            state.streamExpired = true;
+                                            return [4 /*yield*/, sendStreamExpiryNotice(ctx, "endpoint_partial_846608")];
+                                        case 5:
+                                            _b.sent();
+                                            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] Stream expired during endpoint partial reply, will fallback to proactive send");
+                                            return [3 /*break*/, 7];
+                                        case 6: throw err_5;
+                                        case 7: return [3 /*break*/, 8];
+                                        case 8: return [2 /*return*/];
+                                    }
+                                });
+                            }); },
+                            runtimeLog: function () {
+                                var _a;
+                                var args = [];
+                                for (var _i = 0; _i < arguments.length; _i++) {
+                                    args[_i] = arguments[_i];
+                                }
+                                return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                            },
+                            runtimeError: function () {
+                                var _a;
+                                var args = [];
+                                for (var _i = 0; _i < arguments.length; _i++) {
+                                    args[_i] = arguments[_i];
+                                }
+                                return (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                            }
+                        })];
+                case 5:
+                    dispatchResult = _k.sent();
+                    state.accumulatedText = dispatchResult.outboundText;
+                    if (!(dispatchResult.mediaUrls.length > 0)) return [3 /*break*/, 9];
+                    _k.label = 6;
+                case 6:
+                    _k.trys.push([6, 8, , 9]);
+                    return [4 /*yield*/, sendMediaBatch(ctx, dispatchResult.mediaUrls)];
+                case 7:
+                    mediaSendItems = _k.sent();
+                    mediaResultText = formatMediaSendResultList(mediaSendItems);
+                    if (mediaResultText) {
+                        state.accumulatedText = [
+                            String(state.accumulatedText || "").trim(),
+                            mediaResultText.trim(),
+                        ]
+                            .filter(Boolean)
+                            .join("\n\n")
+                            .trim();
+                    }
+                    return [3 /*break*/, 9];
+                case 8:
+                    mediaErr_1 = _k.sent();
+                    state.hasMediaFailed = true;
+                    errMsg = String(mediaErr_1);
+                    summary = "\u26A0\uFE0F \u6587\u4EF6\u53D1\u9001\u5931\u8D25\uFF1A\u5185\u90E8\u5904\u7406\u5F02\u5E38\uFF0C\u8BF7\u5347\u7EA7 openclaw \u5230\u6700\u65B0\u7248\u672C\u540E\u91CD\u8BD5\u3002\n\u9519\u8BEF\u8BE6\u60C5\uFF1A" + errMsg;
+                    state.mediaErrorSummary = state.mediaErrorSummary
+                        ? state.mediaErrorSummary + "\n\n" + summary
+                        : summary;
+                    (_g = runtime.error) === null || _g === void 0 ? void 0 : _g.call(runtime, "[wecom] endpoint sendMediaBatch threw: " + errMsg);
+                    return [3 /*break*/, 9];
+                case 9: return [4 /*yield*/, template_card_manager_js_1.processTemplateCardsIfNeeded({
+                        wsClient: wsClient,
+                        frame: frame,
+                        state: state,
+                        account: account,
+                        runtime: runtime
+                    })];
+                case 10:
+                    cardResult_1 = _k.sent();
+                    if (cardResult_1) {
+                        state.accumulatedText = cardResult_1.remainingText;
+                    }
+                    return [4 /*yield*/, finishThinkingStream(ctx)];
+                case 11:
+                    _k.sent();
+                    safeCleanup();
+                    return [2 /*return*/];
+                case 12: return [4 /*yield*/, core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                        ctx: ctxPayload,
+                        cfg: config,
+                        replyOptions: {
+                        // 打印 LLM 返回的原始分片内容（在 openclaw 核心对 MEDIA: 指令解析之前），
+                        // 用于排查流式分片导致 MEDIA 指令被切断、识别丢失等问题
+                        // onPartialReply: (payload: unknown) => {
+                        // runtime.log?.(`[openclaw -> plugin][partial] payload=${JSON.stringify(payload)}`);
+                        // },
+                        },
+                        dispatcherOptions: {
+                            onReplyStart: function () { return __awaiter(_this, void 0, void 0, function () {
+                                var e_1;
+                                var _a;
+                                return __generator(this, function (_b) {
+                                    switch (_b.label) {
+                                        case 0:
+                                            if (!(!isShowThink && state.streamId && !state.accumulatedText)) return [3 /*break*/, 5];
+                                            _b.label = 1;
+                                        case 1:
+                                            _b.trys.push([1, 3, , 4]);
+                                            return [4 /*yield*/, sendThinkingReply({
+                                                    wsClient: wsClient,
+                                                    frame: frame,
+                                                    streamId: state.streamId,
+                                                    runtime: runtime,
+                                                    state: state,
+                                                    accountId: account.accountId
+                                                })];
+                                        case 2:
+                                            _b.sent();
+                                            return [3 /*break*/, 4];
+                                        case 3:
+                                            e_1 = _b.sent();
+                                            (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] sendThinkingReply threw err: " + String(e_1));
+                                            return [3 /*break*/, 4];
+                                        case 4:
+                                            isShowThink = true;
+                                            _b.label = 5;
+                                        case 5: return [2 /*return*/];
+                                    }
+                                });
+                            }); },
+                            deliver: function (payload, info) { return __awaiter(_this, void 0, void 0, function () {
+                                var adapted, announceKey, outputText, mediaUrls, mediaErr_2, errMsg, summary, displayText, err_6;
+                                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                                return __generator(this, function (_k) {
+                                    switch (_k.label) {
+                                        case 0:
+                                            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[openclaw -> plugin] kind=" + info.kind + ", payload=" + JSON.stringify(payload) + ", info=" + JSON.stringify(info));
+                                            adapted = endpoint_event_adapter_js_1.adaptEndpointEvent({
+                                                rawText: (_b = payload.text) !== null && _b !== void 0 ? _b : "",
+                                                currentEventType: info.kind
+                                            });
+                                            if (adapted.subAgentStartLine) {
+                                                // call_sub_agent 是子代理边界起点；后续同 run_id 的事件按子代理内部过程过滤。
+                                                if (adapted.subAgentRunId)
+                                                    subAgentRunIds.add(adapted.subAgentRunId);
+                                                announceKey = adapted.subAgentRunId || adapted.subAgentStartLine;
+                                                // final-only 模式严格只展示最终结论/error/主流程 confirm，因此不展示 sub agent 调用提示。
+                                                // 但上面的 run_id 仍必须记录，用来继续过滤该 sub agent 后续内部事件。
+                                                if (account.config.showFinalAnswerOnly !== true && !announcedSubAgentRunIds.has(announceKey)) {
+                                                    announcedSubAgentRunIds.add(announceKey);
+                                                    state.accumulatedText += adapted.subAgentStartLine;
+                                                }
+                                                return [2 /*return*/];
+                                            }
+                                            if (adapted.subAgentRunId &&
+                                                subAgentRunIds.has(adapted.subAgentRunId) &&
+                                                adapted.eventType !== "error") {
+                                                // 子代理内部 content/action/confirm 不进入聊天；error 不能在这里过滤，后面会正常输出。
+                                                // sub agent 理论上不应该发起 confirm；这里把 confirm 一并挡住只是防御性兜底，避免内部确认意外打断主会话。
+                                                (_c = runtime.log) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom] ignore sub-agent event: agent_run_id=" + adapted.subAgentRunId + " event=" + (adapted.eventType || info.kind));
+                                                return [2 /*return*/];
+                                            }
+                                            if (!adapted.confirmationText) return [3 /*break*/, 2];
+                                            // confirm 必须先于 final-only 过滤处理：主流程确认如果不主动兜底发送，agent 后续流程可能卡住。
+                                            // 子代理 confirm 已经在上面的 sub-agent 过滤分支被挡住，不会触发这里的兜底发送。
+                                            if (adapted.confirmationDedupKey && handledConfirmationKeys.has(adapted.confirmationDedupKey)) {
+                                                (_d = runtime.log) === null || _d === void 0 ? void 0 : _d.call(runtime, "[wecom] confirmation duplicate skipped: " + adapted.confirmationDedupKey);
+                                                return [2 /*return*/];
+                                            }
+                                            if (adapted.confirmationDedupKey)
+                                                handledConfirmationKeys.add(adapted.confirmationDedupKey);
+                                            return [4 /*yield*/, proactive_markdown_send_js_1.sendWeComMarkdownMessageChunks({
+                                                    wsClient: wsClient,
+                                                    chatId: chatId,
+                                                    text: adapted.confirmationText,
+                                                    runtime: runtime,
+                                                    accountId: account.accountId,
+                                                    label: "dispatcher-confirmation"
+                                                })];
+                                        case 1:
+                                            _k.sent();
+                                            return [2 /*return*/];
+                                        case 2:
+                                            if (adapted.errorText) {
+                                                outputText = errorPrefixSent ? adapted.errorText : "\u9519\u8BEF\uFF1A" + adapted.errorText;
+                                                errorPrefixSent = true;
+                                                state.accumulatedText += outputText;
+                                            }
+                                            else if (account.config.showFinalAnswerOnly === true) {
+                                                // final-only 模式只允许 final_answer 进入聊天；其他结构化过程事件只记日志或直接丢弃。
+                                                if (adapted.finalAnswerText) {
+                                                    state.accumulatedText += adapted.finalAnswerText;
+                                                }
+                                                else if (adapted.eventType !== "message") {
+                                                    (_e = runtime.log) === null || _e === void 0 ? void 0 : _e.call(runtime, "[wecom] final-answer-only ignored event: " + (adapted.eventType || info.kind));
+                                                    return [2 /*return*/];
+                                                }
+                                                else if (adapted.parsed) {
+                                                    return [2 /*return*/];
+                                                }
+                                            }
+                                            else if (adapted.finalAnswerText && adapted.eventType === "content") {
+                                                // 默认模式下 final_answer 本质上仍是 content，按正常文本累积。
+                                                state.accumulatedText += adapted.finalAnswerText;
+                                            }
+                                            if (adapted.ignoreAsNoise) {
+                                                // upsert_record 等只用于补取语义信息，不能继续当普通文本透传到聊天。
+                                                (_f = runtime.log) === null || _f === void 0 ? void 0 : _f.call(runtime, "[wecom] passthrough event ignored for outbound: " + (adapted.eventType || info.kind));
+                                                return [2 /*return*/];
+                                            }
+                                            // 累积文本
+                                            if (!adapted.errorText &&
+                                                !adapted.finalAnswerText &&
+                                                !(account.config.showFinalAnswerOnly === true && adapted.parsed) &&
+                                                payload.text) {
+                                                // 已被 adapter 语义化处理过的 final/error 不能再追加 raw payload，
+                                                // 否则聊天里会出现原始 JSON 或重复文本。
+                                                state.accumulatedText += "" + (payload.text || "");
+                                            }
+                                            mediaUrls = ((_g = payload.mediaUrls) === null || _g === void 0 ? void 0 : _g.length) ? payload.mediaUrls
+                                                : payload.mediaUrl
+                                                    ? [payload.mediaUrl]
+                                                    : [];
+                                            if (!(mediaUrls.length > 0)) return [3 /*break*/, 6];
+                                            _k.label = 3;
+                                        case 3:
+                                            _k.trys.push([3, 5, , 6]);
+                                            return [4 /*yield*/, sendMediaBatch(ctx, mediaUrls)];
+                                        case 4:
+                                            _k.sent();
+                                            return [3 /*break*/, 6];
+                                        case 5:
+                                            mediaErr_2 = _k.sent();
+                                            // sendMediaBatch 内部异常（如 getDefaultMediaLocalRoots 不可用等）
+                                            // 必须标记 state，否则 finishThinkingStream 会显示"处理完成"误导用户
+                                            state.hasMediaFailed = true;
+                                            errMsg = String(mediaErr_2);
+                                            summary = "\u26A0\uFE0F \u6587\u4EF6\u53D1\u9001\u5931\u8D25\uFF1A\u5185\u90E8\u5904\u7406\u5F02\u5E38\uFF0C\u8BF7\u5347\u7EA7 openclaw \u5230\u6700\u65B0\u7248\u672C\u540E\u91CD\u8BD5\u3002\n\u9519\u8BEF\u8BE6\u60C5\uFF1A" + errMsg;
+                                            state.mediaErrorSummary = state.mediaErrorSummary
+                                                ? state.mediaErrorSummary + "\n\n" + summary
+                                                : summary;
+                                            (_h = runtime.error) === null || _h === void 0 ? void 0 : _h.call(runtime, "[wecom] sendMediaBatch threw: " + errMsg);
+                                            return [3 /*break*/, 6];
+                                        case 6:
+                                            if (!(state.accumulatedText && !state.streamExpired)) return [3 /*break*/, 14];
+                                            if (!markStreamReplyLocallyExpired(state, runtime, "dispatcher_intermediate")) return [3 /*break*/, 8];
+                                            return [4 /*yield*/, sendStreamExpiryNotice(ctx, "dispatcher_intermediate_local_ttl")];
+                                        case 7:
+                                            _k.sent();
+                                            return [2 /*return*/];
+                                        case 8:
+                                            _k.trys.push([8, 10, , 14]);
+                                            displayText = template_card_parser_js_1.maskTemplateCardBlocks(state.accumulatedText, function () {
+                                                var _a;
+                                                var args = [];
+                                                for (var _i = 0; _i < arguments.length; _i++) {
+                                                    args[_i] = arguments[_i];
+                                                }
+                                                return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                                            });
+                                            // if (displayText !== state.accumulatedText) {
+                                            //   runtime.log?.(`[wecom][template-card] Mid-frame masked: original=${state.accumulatedText.length}chars, masked=${displayText.length}chars`);
+                                            // }
+                                            return [4 /*yield*/, message_sender_js_1.sendWeComReply({
+                                                    wsClient: wsClient,
+                                                    frame: frame,
+                                                    text: displayText,
+                                                    runtime: runtime,
+                                                    finish: false,
+                                                    streamId: state.streamId,
+                                                    accountId: account.accountId
+                                                })];
+                                        case 9:
+                                            // if (displayText !== state.accumulatedText) {
+                                            //   runtime.log?.(`[wecom][template-card] Mid-frame masked: original=${state.accumulatedText.length}chars, masked=${displayText.length}chars`);
+                                            // }
+                                            _k.sent();
+                                            return [3 /*break*/, 14];
+                                        case 10:
+                                            err_6 = _k.sent();
+                                            if (!(err_6 instanceof message_sender_js_1.StreamExpiredError)) return [3 /*break*/, 12];
+                                            state.streamExpired = true;
+                                            return [4 /*yield*/, sendStreamExpiryNotice(ctx, "dispatcher_intermediate_846608")];
+                                        case 11:
+                                            _k.sent();
+                                            (_j = runtime.log) === null || _j === void 0 ? void 0 : _j.call(runtime, "[wecom] Stream expired during intermediate reply, will fallback to proactive send");
+                                            return [3 /*break*/, 13];
+                                        case 12: throw err_6;
+                                        case 13: return [3 /*break*/, 14];
+                                        case 14: return [2 /*return*/];
+                                    }
+                                });
+                            }); },
+                            onError: function (err, info) {
+                                var _a;
+                                (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom] " + info.kind + " reply failed: " + String(err));
+                            }
+                        }
+                    })];
+                case 13:
+                    _k.sent();
+                    return [4 /*yield*/, template_card_manager_js_1.processTemplateCardsIfNeeded({
+                            wsClient: wsClient,
+                            frame: frame,
+                            state: state,
+                            account: account,
+                            runtime: runtime
+                        })];
+                case 14:
+                    cardResult = _k.sent();
+                    if (cardResult) {
+                        // 卡片已发送，用剩余文本替换累积文本
+                        state.accumulatedText = cardResult.remainingText;
+                    }
+                    // 关闭 thinking 流
+                    return [4 /*yield*/, finishThinkingStream(ctx)];
+                case 15:
+                    // 关闭 thinking 流
+                    _k.sent();
+                    safeCleanup();
+                    return [3 /*break*/, 22];
+                case 16:
+                    err_4 = _k.sent();
+                    (_h = runtime.error) === null || _h === void 0 ? void 0 : _h.call(runtime, "[wecom][plugin] Failed to process message: " + String(err_4));
+                    userFacingError = extractUserFacingErrorMessage(err_4 instanceof Error ? err_4.message : String(err_4));
+                    if (userFacingError) {
+                        state.accumulatedText = userFacingError;
+                    }
+                    _k.label = 17;
+                case 17:
+                    _k.trys.push([17, 20, , 21]);
+                    return [4 /*yield*/, template_card_manager_js_1.processTemplateCardsIfNeeded({
+                            wsClient: wsClient,
+                            frame: frame,
+                            state: state,
+                            account: account,
+                            runtime: runtime
+                        })];
+                case 18:
+                    cardResult = _k.sent();
+                    if (cardResult) {
+                        state.accumulatedText = cardResult.remainingText;
+                    }
+                    return [4 /*yield*/, finishThinkingStream(ctx)];
+                case 19:
+                    _k.sent();
+                    return [3 /*break*/, 21];
+                case 20:
+                    finishErr_1 = _k.sent();
+                    (_j = runtime.error) === null || _j === void 0 ? void 0 : _j.call(runtime, "[wecom] Failed to finish thinking stream after dispatch error: " + String(finishErr_1));
+                    return [3 /*break*/, 21];
+                case 21:
+                    safeCleanup();
+                    return [3 /*break*/, 22];
+                case 22: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 解析并校验企业微信消息（防抖前阶段：Step 1-4）
+ *
+ * 执行消息解析、策略检查、媒体下载等前置操作，
+ * 返回一个可用于防抖缓冲的 entry，或 null（消息被过滤/跳过时）。
+ */
+function prepareWeComMessage(params) {
+    var _a, _b, _c, _d, _e;
+    return __awaiter(this, void 0, void 0, function () {
+        var frame, account, config, runtime, wsClient, body, chatId, chatType, messageId, reqId, _f, textParts, imageUrls, imageAesKeys, fileUrls, fileAesKeys, quoteContent, text, groupPolicyResult, dmPolicyResult, imageMediaList, fileMediaList, err_7, hintText, replyErr_1, mediaList;
+        var _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0:
+                    frame = params.frame, account = params.account, config = params.config, runtime = params.runtime, wsClient = params.wsClient;
+                    body = frame.body;
+                    chatId = body.chatid || body.from.userid;
+                    chatType = body.chattype === "group" ? "group" : "direct";
+                    messageId = body.msgid;
+                    reqId = frame.headers.req_id;
+                    _f = message_parser_js_1.parseMessageContent(body), textParts = _f.textParts, imageUrls = _f.imageUrls, imageAesKeys = _f.imageAesKeys, fileUrls = _f.fileUrls, fileAesKeys = _f.fileAesKeys, quoteContent = _f.quoteContent;
+                    text = textParts.join("\n").trim();
+                    // // 群聊中移除 @机器人 的提及标记
+                    // if (body.chattype === "group") {
+                    //   text = text.replace(/@\S+/g, "").trim();
+                    // }
+                    // 如果文本为空但存在引用消息，使用引用消息内容
+                    if (!text && quoteContent) {
+                        text = quoteContent;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][plugin] Using quote content as message body (user only mentioned bot)");
+                    }
+                    // 如果既没有文本也没有图片也没有文件也没有引用内容，则跳过
+                    if (!text && imageUrls.length === 0 && fileUrls.length === 0) {
+                        (_b = runtime.log) === null || _b === void 0 ? void 0 : _b.call(runtime, "[wecom][plugin] Skipping empty message (no text, image, file or quote)");
+                        return [2 /*return*/, null];
+                    }
+                    // Step 2: 群组策略检查（仅群聊）
+                    if (chatType === "group") {
+                        groupPolicyResult = group_policy_js_1.checkGroupPolicy({
+                            chatId: chatId,
+                            senderId: body.from.userid,
+                            account: account,
+                            config: config,
+                            runtime: runtime
+                        });
+                        if (!groupPolicyResult.allowed) {
+                            return [2 /*return*/, null];
+                        }
+                    }
+                    return [4 /*yield*/, dm_policy_js_1.checkDmPolicy({
+                            senderId: body.from.userid,
+                            isGroup: chatType === "group",
+                            account: account,
+                            wsClient: wsClient,
+                            frame: frame,
+                            runtime: runtime
+                        })];
+                case 1:
+                    dmPolicyResult = _h.sent();
+                    if (!dmPolicyResult.allowed) {
+                        return [2 /*return*/, null];
+                    }
+                    _h.label = 2;
+                case 2:
+                    _h.trys.push([2, 4, , 10]);
+                    return [4 /*yield*/, Promise.all([
+                            media_handler_js_1.downloadAndSaveImages({
+                                imageUrls: imageUrls,
+                                imageAesKeys: imageAesKeys,
+                                account: account,
+                                config: config,
+                                runtime: runtime,
+                                wsClient: wsClient
+                            }),
+                            media_handler_js_1.downloadAndSaveFiles({
+                                fileUrls: fileUrls,
+                                fileAesKeys: fileAesKeys,
+                                account: account,
+                                config: config,
+                                runtime: runtime,
+                                wsClient: wsClient
+                            }),
+                        ])];
+                case 3:
+                    _g = _h.sent(), imageMediaList = _g[0], fileMediaList = _g[1];
+                    return [3 /*break*/, 10];
+                case 4:
+                    err_7 = _h.sent();
+                    if (!(err_7 instanceof media_handler_js_1.MediaOversizeError)) return [3 /*break*/, 9];
+                    hintText = buildMediaOversizeHintText(err_7);
+                    (_c = runtime.error) === null || _c === void 0 ? void 0 : _c.call(runtime, "[wecom] Media oversize: kind=" + err_7.kind + ", size=" + err_7.sizeBytes + ", max=" + err_7.maxBytes + ", filename=" + ((_d = err_7.filename) !== null && _d !== void 0 ? _d : "(none)"));
+                    _h.label = 5;
+                case 5:
+                    _h.trys.push([5, 7, , 8]);
+                    return [4 /*yield*/, message_sender_js_1.sendWeComReply({ wsClient: wsClient, frame: frame, text: hintText, runtime: runtime, finish: true, accountId: account.accountId })];
+                case 6:
+                    _h.sent();
+                    return [3 /*break*/, 8];
+                case 7:
+                    replyErr_1 = _h.sent();
+                    (_e = runtime.error) === null || _e === void 0 ? void 0 : _e.call(runtime, "[wecom] Failed to send oversize hint: " + String(replyErr_1));
+                    return [3 /*break*/, 8];
+                case 8: return [2 /*return*/, null];
+                case 9: throw err_7;
+                case 10:
+                    mediaList = __spreadArrays(imageMediaList, fileMediaList);
+                    return [2 /*return*/, {
+                            frame: frame,
+                            account: account,
+                            config: config,
+                            runtime: runtime,
+                            wsClient: wsClient,
+                            text: text,
+                            mediaList: mediaList,
+                            quoteContent: quoteContent,
+                            messageId: messageId,
+                            chatId: chatId,
+                            reqId: reqId
+                        }];
+            }
+        });
+    });
+}
+/**
+ * 处理企业微信消息（Step 5-7）
+ *
+ * 接收解析后的消息数据，执行初始化状态、发送 thinking、路由到核心。
+ * 同一会话中的消息通过串行队列保证按序执行。
+ */
+function processWeComMessageNow(entry) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function () {
+        var frame, account, config, runtime, wsClient, text, mediaList, quoteContent, messageId, chatId, reqId, streamId, state, cleanupState, _b, ctxPayload, route, storePath, resolvedChatId, chatType, err_8;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    frame = entry.frame, account = entry.account, config = entry.config, runtime = entry.runtime, wsClient = entry.wsClient, text = entry.text, mediaList = entry.mediaList, quoteContent = entry.quoteContent, messageId = entry.messageId, chatId = entry.chatId, reqId = entry.reqId;
+                    // Step 5: 初始化消息状态
+                    state_manager_js_1.setReqIdForChat(chatId, reqId, account.accountId);
+                    streamId = aibot_node_sdk_1.generateReqId("stream");
+                    state = { accumulatedText: "", streamId: streamId, streamStartedAt: Date.now() };
+                    state_manager_js_1.setMessageState(messageId, state);
+                    cleanupState = function () {
+                        state_manager_js_1.deleteMessageState(messageId);
+                    };
+                    _b = buildMessageContext(frame, account, config, text, mediaList, quoteContent, runtime), ctxPayload = _b.ctxPayload, route = _b.route, storePath = _b.storePath, resolvedChatId = _b.chatId, chatType = _b.chatType;
+                    // 以 sessionKey 为键记录「原始大小写」的 chatId 与 chatType，
+                    // 供 MCP 工具工厂（index.ts:registerTool）在构造工具闭包时取回，
+                    // 进而传递给需要原始 chatId 的拦截器（如 doc-auth-error 发送 biz_msg）。
+                    //
+                    // 注意：不要使用 parseSessionKeyChat 反解 sessionKey —— OpenClaw core
+                    //       构建 sessionKey 时会将 peer.id 强制小写化，会导致企业微信
+                    //       aibot_send_biz_msg 报 errcode=93006 invalid chatid。
+                    state_manager_js_1.setSessionChatInfo(route.sessionKey, {
+                        chatId: resolvedChatId,
+                        chatType: chatType === "group" ? "group" : "single"
+                    });
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, routeAndDispatchMessage({
+                            ctxPayload: ctxPayload,
+                            route: route,
+                            storePath: storePath,
+                            chatId: resolvedChatId,
+                            chatType: chatType,
+                            config: config,
+                            account: account,
+                            wsClient: wsClient,
+                            frame: frame,
+                            state: state,
+                            runtime: runtime,
+                            onCleanup: cleanupState
+                        })];
+                case 2:
+                    _c.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    err_8 = _c.sent();
+                    (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[wecom][plugin] Message processing failed: " + String(err_8));
+                    cleanupState();
+                    return [3 /*break*/, 4];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+// ============================================================================
+// 创建 SDK Logger 适配器
+// ============================================================================
+/**
+ * 创建适配 RuntimeEnv 的 Logger
+ */
+function createSdkLogger(runtime, accountId) {
+    return {
+        debug: function (message) {
+            var _a;
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime, "[" + accountId + "] " + message], args));
+        },
+        info: function (message) {
+            var _a;
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime, "[" + accountId + "] " + message], args));
+        },
+        warn: function (message) {
+            var _a;
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime, "[" + accountId + "] WARN: " + message], args));
+        },
+        error: function (message) {
+            var _a;
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime, "[" + accountId + "] " + message], args));
+        }
+    };
+}
+// ============================================================================
+// 主函数
+// ============================================================================
+/**
+ * 监听企业微信 WebSocket 连接
+ * 使用 aibot-node-sdk 简化连接管理
+ */
+function monitorWeComProvider(options) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function () {
+        var account, config, runtime, abortSignal, setStatus;
+        var _this = this;
+        return __generator(this, function (_b) {
+            account = options.account, config = options.config, runtime = options.runtime, abortSignal = options.abortSignal, setStatus = options.setStatus;
+            (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] [" + version_js_1.PLUGIN_VERSION + "] Initializing WSClient with SDK...");
+            // 启动消息状态定期清理
+            state_manager_js_1.startMessageStateCleanup();
+            return [2 /*return*/, new Promise(function (resolve, reject) {
+                    var _a;
+                    var logger = createSdkLogger(runtime, account.accountId);
+                    var wsClient = new aibot_node_sdk_1.WSClient({
+                        botId: account.botId,
+                        secret: account.secret,
+                        wsUrl: account.websocketUrl,
+                        logger: logger,
+                        heartbeatInterval: const_js_1.WS_HEARTBEAT_INTERVAL_MS,
+                        maxReconnectAttempts: const_js_1.WS_MAX_RECONNECT_ATTEMPTS,
+                        maxAuthFailureAttempts: const_js_1.WS_MAX_AUTH_FAILURE_ATTEMPTS,
+                        scene: const_js_1.SCENE_WECOM_OPENCLAW,
+                        plug_version: version_js_1.PLUGIN_VERSION
+                    });
+                    var updateLifecycleStatus = function (patch) {
+                        var now = typeof patch.lastEventAt === "number" ? patch.lastEventAt : Date.now();
+                        var connected = typeof patch.connected === "boolean" ? patch.connected : undefined;
+                        var authenticated = typeof patch.authenticated === "boolean" ? patch.authenticated : undefined;
+                        var running = typeof patch.running === "boolean" ? patch.running : undefined;
+                        var restartPending = typeof patch.restartPending === "boolean" ? patch.restartPending : undefined;
+                        var lastEvent = String(patch.lastEvent || "").trim() || null;
+                        var lastError = patch.lastError === null ? null : patch.lastError != null ? String(patch.lastError) : undefined;
+                        var reconnectAttempts = typeof patch.reconnectAttempts === "number" ? patch.reconnectAttempts : undefined;
+                        state_manager_js_1.updateWeComConnectionSnapshot(account.accountId, __assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (connected !== undefined ? { connected: connected } : {})), (authenticated !== undefined ? { authenticated: authenticated } : {})), (running !== undefined ? { running: running } : {})), (restartPending !== undefined ? { restartPending: restartPending } : {})), (lastEvent ? { lastEvent: lastEvent } : {})), { lastEventAt: now }), (lastError !== undefined ? { lastError: lastError } : {})), (typeof patch.lastStartAt === "number" ? { lastStartAt: patch.lastStartAt } : {})), (typeof patch.lastStopAt === "number" ? { lastStopAt: patch.lastStopAt } : {})), (reconnectAttempts !== undefined ? { reconnectAttempts: reconnectAttempts } : {})));
+                        im_runtime_telemetry_js_1.imRuntimeSetChannelStatus({
+                            platform: "wecom",
+                            botAccountId: account.accountId,
+                            linkStatus: connected === true ? "connected" : connected === false ? "disconnected" : undefined,
+                            lastError: lastError,
+                            lastEvent: lastEvent,
+                            lastEventAt: now,
+                            running: running,
+                            connected: connected,
+                            restartPending: restartPending,
+                            reconnectCount: reconnectAttempts
+                        });
+                        setStatus === null || setStatus === void 0 ? void 0 : setStatus(__assign({ accountId: account.accountId }, patch));
+                    };
+                    // 防止 cleanup 被多次调用（abort handler、error handler、disconnected_event 可能竞态触发）
+                    var cleanedUp = false;
+                    // 清理函数：确保所有资源被释放（幂等）
+                    var cleanup = function () { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    if (cleanedUp)
+                                        return [2 /*return*/];
+                                    cleanedUp = true;
+                                    state_manager_js_1.stopMessageStateCleanup();
+                                    return [4 /*yield*/, state_manager_js_1.cleanupAccount(account.accountId)];
+                                case 1:
+                                    _a.sent();
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); };
+                    // 处理中止信号（框架 stopChannel 会触发 abort）
+                    // resolve() 让 Promise settle → 框架清理 store.tasks/store.aborts
+                    if (abortSignal) {
+                        abortSignal.addEventListener("abort", function () { return __awaiter(_this, void 0, void 0, function () {
+                            var _a;
+                            return __generator(this, function (_b) {
+                                switch (_b.label) {
+                                    case 0:
+                                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Connection aborted");
+                                        updateLifecycleStatus({
+                                            connected: false,
+                                            authenticated: false,
+                                            running: false,
+                                            restartPending: false,
+                                            lastEvent: "control_abort",
+                                            lastError: "connection_aborted_by_control_plane",
+                                            lastStopAt: Date.now(),
+                                            lastEventAt: Date.now()
+                                        });
+                                        wsClient.disconnect();
+                                        return [4 /*yield*/, cleanup()];
+                                    case 1:
+                                        _b.sent();
+                                        resolve();
+                                        return [2 /*return*/];
+                                }
+                            });
+                        }); });
+                    }
+                    // 监听连接事件
+                    wsClient.on("connected", function () {
+                        var _a;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] WebSocket connected");
+                        updateLifecycleStatus({
+                            connected: true,
+                            authenticated: false,
+                            running: true,
+                            restartPending: false,
+                            lastEvent: "websocket_connected",
+                            lastError: null,
+                            lastStartAt: Date.now(),
+                            lastEventAt: Date.now()
+                        });
+                    });
+                    // 监听认证成功事件
+                    wsClient.on("authenticated", function () {
+                        var _a;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Authentication successful");
+                        state_manager_js_1.setWeComWebSocket(account.accountId, wsClient);
+                        updateLifecycleStatus({
+                            connected: true,
+                            authenticated: true,
+                            running: true,
+                            restartPending: false,
+                            lastEvent: "websocket_authenticated",
+                            lastError: null,
+                            lastStartAt: Date.now(),
+                            lastEventAt: Date.now()
+                        });
+                    });
+                    // 监听断开事件
+                    wsClient.on("disconnected", function (reason) {
+                        var _a;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] WebSocket disconnected: " + reason);
+                        updateLifecycleStatus({
+                            connected: false,
+                            authenticated: false,
+                            // disconnected 可能是短时网络抖动，优先让 SDK 自重连，保留 running=true。
+                            running: true,
+                            restartPending: true,
+                            lastEvent: "websocket_disconnected",
+                            lastError: String(reason || "websocket_disconnected"),
+                            lastEventAt: Date.now()
+                        });
+                    });
+                    // 监听被踢下线事件（服务端因新连接建立而主动断开旧连接）
+                    //
+                    // SDK 内部已设置 isManualClose=true 阻止 SDK 层自动重连，连接不会自行恢复。
+                    // **不 reject/resolve Promise**——保持 pending 以阻止框架层 auto-restart。
+                    //
+                    // 为什么不能 reject/resolve：
+                    //   - reject → 框架 auto-restart 介入 → 新连接建立 → 又被踢 → 两个实例互踢无限循环
+                    //   - resolve → 同上，框架 .then() 中的 auto-restart 也会触发
+                    //
+                    // Promise pending 的安全性：
+                    //   - store.tasks.has(id) = true → 阻止 Health Monitor 直接 startChannel（startChannel 检查 tasks.has）
+                    //   - 框架 stopChannel → abort() → abort handler 中 resolve() → tasks 正常清理
+                    //   - 用户修改配置 → config reload → stopChannel + startChannel → 正常恢复
+                    //
+                    // 显式调用 wsClient.disconnect() 确保 SDK 内部资源（定时器、队列等）完全释放。
+                    wsClient.on("event.disconnected_event", function () { return __awaiter(_this, void 0, void 0, function () {
+                        var errorMsg;
+                        var _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    errorMsg = "Kicked by server: a new connection was established elsewhere. Auto-restart is suppressed to avoid mutual kicking. Please check for duplicate instances.";
+                                    (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] " + errorMsg);
+                                    updateLifecycleStatus({
+                                        connected: false,
+                                        authenticated: false,
+                                        running: false,
+                                        restartPending: false,
+                                        lastEvent: "transport_logged_out",
+                                        lastError: errorMsg,
+                                        lastStopAt: Date.now(),
+                                        lastEventAt: Date.now()
+                                    });
+                                    im_runtime_telemetry_js_1.imRuntimeRecordTransportDisconnect({
+                                        platform: "wecom",
+                                        botAccountId: account.accountId,
+                                        atMs: Date.now(),
+                                        error: errorMsg,
+                                        loggedOut: true
+                                    });
+                                    wsClient.disconnect();
+                                    return [4 /*yield*/, cleanup()];
+                                case 1:
+                                    _b.sent();
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); });
+                    // 监听重连事件
+                    wsClient.on("reconnecting", function (attempt) {
+                        var _a;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Reconnecting attempt " + attempt + "...");
+                        updateLifecycleStatus({
+                            connected: false,
+                            authenticated: false,
+                            running: true,
+                            restartPending: true,
+                            lastEvent: "websocket_reconnecting",
+                            reconnectAttempts: attempt,
+                            lastEventAt: Date.now()
+                        });
+                    });
+                    // 监听错误事件
+                    wsClient.on("error", function (error) { return __awaiter(_this, void 0, void 0, function () {
+                        var errorMsg;
+                        var _a, _b;
+                        return __generator(this, function (_c) {
+                            switch (_c.label) {
+                                case 0:
+                                    (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] WebSocket error: " + error.message);
+                                    if (!(error instanceof aibot_node_sdk_1.WSAuthFailureError)) return [3 /*break*/, 2];
+                                    errorMsg = "Auth failure attempts exhausted (" + const_js_1.WS_MAX_AUTH_FAILURE_ATTEMPTS + " attempts). Please check botId/secret configuration.";
+                                    (_b = runtime.error) === null || _b === void 0 ? void 0 : _b.call(runtime, "[" + account.accountId + "] " + errorMsg);
+                                    updateLifecycleStatus({
+                                        connected: false,
+                                        authenticated: false,
+                                        running: false,
+                                        restartPending: false,
+                                        lastEvent: "auth_failure",
+                                        lastError: errorMsg,
+                                        lastStopAt: Date.now(),
+                                        lastEventAt: Date.now()
+                                    });
+                                    im_runtime_telemetry_js_1.imRuntimeRecordTransportDisconnect({
+                                        platform: "wecom",
+                                        botAccountId: account.accountId,
+                                        atMs: Date.now(),
+                                        error: errorMsg,
+                                        loggedOut: false
+                                    });
+                                    wsClient.disconnect();
+                                    return [4 /*yield*/, cleanup()];
+                                case 1:
+                                    _c.sent();
+                                    return [2 /*return*/];
+                                case 2:
+                                    if (error instanceof aibot_node_sdk_1.WSReconnectExhaustedError) {
+                                        // 网络断线重连次数用尽（SDK 层已重试 WS_MAX_RECONNECT_ATTEMPTS 次）。
+                                        // 通常是网络/服务端问题，框架 auto-restart 可能恢复。
+                                        //
+                                        // reject Promise → 框架 auto-restart 介入（最多 MAX_RESTART_ATTEMPTS=10 次）
+                                        // 总连接尝试次数 = (1 首次 + WS_MAX_RECONNECT_ATTEMPTS 重连) × (1 首轮 + 10 auto-restart)
+                                        //                = 11 × 11 = 121 次
+                                        //
+                                        // 如果 Health Monitor 介入（每 5 分钟检查），会 resetRestartAttempts 重新计数，
+                                        // 受限于 DEFAULT_MAX_RESTARTS_PER_HOUR=10，每小时最多额外 10 × 121 = 1210 次。
+                                        // 但因网络断线通常是暂时性的，auto-restart + Health Monitor 的兜底机制是合理的。
+                                        //
+                                        // 显式调用 wsClient.disconnect() 确保 SDK 内部资源完全释放，
+                                        // 避免旧实例的定时器/队列残留。
+                                        im_runtime_telemetry_js_1.imRuntimeRecordTransportDisconnect({
+                                            platform: "wecom",
+                                            botAccountId: account.accountId,
+                                            atMs: Date.now(),
+                                            error: error.message,
+                                            loggedOut: false
+                                        });
+                                        wsClient.disconnect();
+                                        cleanup()["finally"](function () { return reject(error); });
+                                        return [2 /*return*/];
+                                    }
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); });
+                    // 监听版本检查事件：收到 enter_check_update 时回复当前插件版本
+                    wsClient.on(const_js_1.EVENT_ENTER_CHECK_UPDATE, function (frame) { return __awaiter(_this, void 0, void 0, function () {
+                        var err_9;
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    _a.trys.push([0, 2, , 3]);
+                                    // runtime.log?.(`[${account.accountId}] Received enter_check_update, replying with version=${PLUGIN_VERSION}`);
+                                    return [4 /*yield*/, wsClient.reply(frame, { version: version_js_1.PLUGIN_VERSION }, const_js_1.CMD_ENTER_EVENT_REPLY)];
+                                case 1:
+                                    // runtime.log?.(`[${account.accountId}] Received enter_check_update, replying with version=${PLUGIN_VERSION}`);
+                                    _a.sent();
+                                    return [3 /*break*/, 3];
+                                case 2:
+                                    err_9 = _a.sent();
+                                    return [3 /*break*/, 3];
+                                case 3: return [2 /*return*/];
+                            }
+                        });
+                    }); });
+                    // 监听普通消息
+                    wsClient.on("message", function (frame) { return __awaiter(_this, void 0, void 0, function () {
+                        var entry, err_10;
+                        var _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    _b.trys.push([0, 3, , 4]);
+                                    return [4 /*yield*/, prepareWeComMessage({
+                                            frame: frame,
+                                            account: account,
+                                            config: config,
+                                            runtime: runtime,
+                                            wsClient: wsClient
+                                        })];
+                                case 1:
+                                    entry = _b.sent();
+                                    if (!entry)
+                                        return [2 /*return*/];
+                                    im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", entry.account.accountId, "inbound");
+                                    // 排队逻辑暂时关闭，直接处理消息
+                                    // const { status } = enqueueWeComChatTask({
+                                    //   accountId: entry.account.accountId,
+                                    //   chatId: entry.chatId,
+                                    //   task: () => processWeComMessageNow(entry),
+                                    // });
+                                    //
+                                    // if (status === "queued") {
+                                    //   runtime.log?.(`[wecom] Chat task queued for chat=${entry.chatId} (previous task still running)`);
+                                    // }
+                                    return [4 /*yield*/, processWeComMessageNow(entry)];
+                                case 2:
+                                    // 排队逻辑暂时关闭，直接处理消息
+                                    // const { status } = enqueueWeComChatTask({
+                                    //   accountId: entry.account.accountId,
+                                    //   chatId: entry.chatId,
+                                    //   task: () => processWeComMessageNow(entry),
+                                    // });
+                                    //
+                                    // if (status === "queued") {
+                                    //   runtime.log?.(`[wecom] Chat task queued for chat=${entry.chatId} (previous task still running)`);
+                                    // }
+                                    _b.sent();
+                                    return [3 /*break*/, 4];
+                                case 3:
+                                    err_10 = _b.sent();
+                                    (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Failed to process message: " + String(err_10));
+                                    return [3 /*break*/, 4];
+                                case 4: return [2 /*return*/];
+                            }
+                        });
+                    }); });
+                    // 监听所有事件回调（aibot_event_callback）。
+                    // 这里使用通用 event 监听，再按 eventtype 分发，兼容不同 SDK 版本在细分事件名上的差异。
+                    wsClient.on("event", function (frame) { return __awaiter(_this, void 0, void 0, function () {
+                        var eventBody, eventType, templateCardEvent, updateErr_1, authChangeEvent, entry, err_11;
+                        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+                        return __generator(this, function (_s) {
+                            switch (_s.label) {
+                                case 0:
+                                    _s.trys.push([0, 10, , 11]);
+                                    eventBody = frame.body;
+                                    eventType = (_a = eventBody.event) === null || _a === void 0 ? void 0 : _a.eventtype;
+                                    (_b = runtime.log) === null || _b === void 0 ? void 0 : _b.call(runtime, "[" + account.accountId + "] Received event callback: eventtype=" + (eventType !== null && eventType !== void 0 ? eventType : "") + ", msgid=" + ((_c = eventBody.msgid) !== null && _c !== void 0 ? _c : ""));
+                                    if (!(eventType === "template_card_event")) return [3 /*break*/, 5];
+                                    templateCardEvent = (_d = eventBody.event) === null || _d === void 0 ? void 0 : _d.template_card_event;
+                                    (_e = runtime.log) === null || _e === void 0 ? void 0 : _e.call(runtime, "[" + account.accountId + "] Received template_card_event: event_key=" + ((_f = templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.event_key) !== null && _f !== void 0 ? _f : "") + ", task_id=" + ((_g = templateCardEvent === null || templateCardEvent === void 0 ? void 0 : templateCardEvent.task_id) !== null && _g !== void 0 ? _g : ""));
+                                    _s.label = 1;
+                                case 1:
+                                    _s.trys.push([1, 3, , 4]);
+                                    return [4 /*yield*/, template_card_manager_js_1.updateTemplateCardOnEvent({
+                                            frame: frame,
+                                            accountId: account.accountId,
+                                            runtime: runtime,
+                                            wsClient: wsClient
+                                        })];
+                                case 2:
+                                    _s.sent();
+                                    return [3 /*break*/, 4];
+                                case 3:
+                                    updateErr_1 = _s.sent();
+                                    (_h = runtime.error) === null || _h === void 0 ? void 0 : _h.call(runtime, "[" + account.accountId + "] [template-card-update] Failed to update template card: " + String(updateErr_1));
+                                    return [3 /*break*/, 4];
+                                case 4: return [3 /*break*/, 6];
+                                case 5:
+                                    if (eventType === "auth_change_event") {
+                                        authChangeEvent = (_j = eventBody.event) === null || _j === void 0 ? void 0 : _j.auth_change_event;
+                                        (_k = runtime.log) === null || _k === void 0 ? void 0 : _k.call(runtime, "[" + account.accountId + "] Received auth_change_event: auth_list=[" + ((_m = (_l = authChangeEvent === null || authChangeEvent === void 0 ? void 0 : authChangeEvent.auth_list) === null || _l === void 0 ? void 0 : _l.join(", ")) !== null && _m !== void 0 ? _m : "") + "]");
+                                    }
+                                    else {
+                                        // 其他未识别的事件类型，跳过
+                                        return [2 /*return*/];
+                                    }
+                                    _s.label = 6;
+                                case 6: return [4 /*yield*/, prepareWeComMessage({
+                                        frame: frame,
+                                        account: account,
+                                        config: config,
+                                        runtime: runtime,
+                                        wsClient: wsClient
+                                    })];
+                                case 7:
+                                    entry = _s.sent();
+                                    if (!entry) return [3 /*break*/, 9];
+                                    im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", entry.account.accountId, "inbound");
+                                    return [4 /*yield*/, processWeComMessageNow(entry)];
+                                case 8:
+                                    _s.sent();
+                                    _s.label = 9;
+                                case 9: return [3 /*break*/, 11];
+                                case 10:
+                                    err_11 = _s.sent();
+                                    (_o = runtime.error) === null || _o === void 0 ? void 0 : _o.call(runtime, "[" + account.accountId + "] Failed to process event callback (" + ((_r = (_q = (_p = frame.body) === null || _p === void 0 ? void 0 : _p.event) === null || _q === void 0 ? void 0 : _q.eventtype) !== null && _r !== void 0 ? _r : "unknown") + "): " + String(err_11));
+                                    return [3 /*break*/, 11];
+                                case 11: return [2 /*return*/];
+                            }
+                        });
+                    }); });
+                    (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Event listeners attached: message + event(template_card_event, auth_change_event)");
+                    // 启动前预热 reqId 缓存，确保完成后再建立连接，避免 getSync 在预热完成前返回 undefined
+                    state_manager_js_1.warmupReqIdStore(account.accountId, function () {
+                        var _a;
+                        var args = [];
+                        for (var _i = 0; _i < arguments.length; _i++) {
+                            args[_i] = arguments[_i];
+                        }
+                        return (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call.apply(_a, __spreadArrays([runtime], args));
+                    })
+                        .then(function (count) {
+                        var _a;
+                        (_a = runtime.log) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Warmed up " + count + " reqId entries from disk");
+                    })["catch"](function (err) {
+                        var _a;
+                        (_a = runtime.error) === null || _a === void 0 ? void 0 : _a.call(runtime, "[" + account.accountId + "] Failed to warmup reqId store: " + String(err));
+                    })["finally"](function () {
+                        // 无论预热成功或失败，都建立连接
+                        wsClient.connect();
+                    });
+                })];
+        });
+    });
+}
+exports.monitorWeComProvider = monitorWeComProvider;
+exports.__monitorTestables = {
+    finishThinkingStream: finishThinkingStream,
+    isStreamReplyLocallyExpired: isStreamReplyLocallyExpired,
+    markStreamReplyLocallyExpired: markStreamReplyLocallyExpired
+};