ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/webhook/helpers.js

@@ -0,0 +1,936 @@
+"use strict";
+/**
+ * Webhook 辅助函数
+ *
+ * 从 @mocrane/wecom monitor.ts 迁移的辅助工具函数集合。
+ * 包含：文本截断、兜底提示构建、本机路径提取、MIME 推断等。
+ */
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+exports.buildStreamResponse = exports.buildStreamTextPlaceholderReply = exports.buildStreamPlaceholderReply = exports.hasMedia = exports.formatQuote = exports.buildInboundBody = exports.resolveWecomSenderUserId = exports.buildCfgForDispatch = exports.processInboundMessage = exports.resolveWecomMediaMaxBytes = exports.computeMd5 = exports.buildStreamReplyFromState = exports.guessContentTypeFromPath = exports.isAgentConfigured = exports.computeTaskKey = exports.looksLikeSendLocalFileIntent = exports.extractLocalImagePathsFromText = exports.extractLocalFilePathsFromText = exports.buildFallbackPrompt = exports.appendDmContent = exports.truncateUtf8Bytes = exports.MIME_BY_EXT = exports.STREAM_MAX_DM_BYTES = void 0;
+var node_crypto_1 = __importDefault(require("node:crypto"));
+// ============================================================================
+// 常量
+// ============================================================================
+/** DM 文本最大字节数上限 */
+exports.STREAM_MAX_DM_BYTES = 200000;
+/** MIME 扩展名映射表 */
+exports.MIME_BY_EXT = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    bmp: "image/bmp",
+    pdf: "application/pdf",
+    txt: "text/plain",
+    csv: "text/csv",
+    tsv: "text/tab-separated-values",
+    md: "text/markdown",
+    json: "application/json",
+    xml: "application/xml",
+    yaml: "application/yaml",
+    yml: "application/yaml",
+    zip: "application/zip",
+    rar: "application/vnd.rar",
+    "7z": "application/x-7z-compressed",
+    tar: "application/x-tar",
+    gz: "application/gzip",
+    tgz: "application/gzip",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ppt: "application/vnd.ms-powerpoint",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    rtf: "application/rtf",
+    odt: "application/vnd.oasis.opendocument.text",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    amr: "voice/amr",
+    m4a: "audio/mp4",
+    mp4: "video/mp4",
+    mov: "video/quicktime"
+};
+// ============================================================================
+// 文本处理
+// ============================================================================
+/**
+ * UTF-8 字节截断（保留尾部，截断头部）
+ *
+ * 对齐原版 truncateUtf8Bytes：保留最后 maxBytes 字节。
+ */
+function truncateUtf8Bytes(text, maxBytes) {
+    var buf = Buffer.from(text, "utf8");
+    if (buf.length <= maxBytes)
+        return text;
+    var slice = buf.subarray(buf.length - maxBytes);
+    return slice.toString("utf8");
+}
+exports.truncateUtf8Bytes = truncateUtf8Bytes;
+/**
+ * 追加 DM 兜底内容（对齐原版 appendDmContent）
+ *
+ * 每次 deliver 时都追加到 dmContent（不受 STREAM_MAX_BYTES 限制，有 DM 上限保护）
+ */
+function appendDmContent(state, text) {
+    var next = state.dmContent ? (state.dmContent + "\n\n" + text).trim() : text.trim();
+    state.dmContent = truncateUtf8Bytes(next, exports.STREAM_MAX_DM_BYTES);
+}
+exports.appendDmContent = appendDmContent;
+// ============================================================================
+// 兜底提示
+// ============================================================================
+/**
+ * 构建兜底提示文本（对齐原版 buildFallbackPrompt）
+ */
+function buildFallbackPrompt(params) {
+    var who = params.userId ? "\uFF08" + params.userId + "\uFF09" : "";
+    var scope = params.chatType === "group" ? "群聊" : params.chatType === "direct" ? "私聊" : "会话";
+    if (!params.agentConfigured) {
+        return (scope + "\u4E2D\u9700\u8981\u901A\u8FC7\u5E94\u7528\u79C1\u4FE1\u53D1\u9001" + (params.filename ? "\uFF08" + params.filename + "\uFF09" : "") + "\uFF0C\u4F46\u7BA1\u7406\u5458\u5C1A\u672A\u914D\u7F6E\u4F01\u4E1A\u5FAE\u4FE1\u81EA\u5EFA\u5E94\u7528\uFF08Agent\uFF09\u901A\u9053\u3002\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u914D\u7F6E\u540E\u518D\u8BD5\u3002" + who).trim();
+    }
+    if (!params.userId) {
+        return (scope + "\u4E2D\u9700\u8981\u901A\u8FC7\u5E94\u7528\u79C1\u4FE1\u515C\u5E95\u53D1\u9001" + (params.filename ? "\uFF08" + params.filename + "\uFF09" : "") + "\uFF0C\u4F46\u672C\u6B21\u56DE\u8C03\u672A\u80FD\u8BC6\u522B\u89E6\u53D1\u8005 userid\uFF08\u8BF7\u68C0\u67E5\u4F01\u5FAE\u56DE\u8C03\u5B57\u6BB5 from.userid / fromuserid\uFF09\u3002\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u6392\u67E5\u914D\u7F6E\u3002").trim();
+    }
+    if (params.kind === "media") {
+        return ("\u5DF2\u751F\u6210\u6587\u4EF6" + (params.filename ? "\uFF08" + params.filename + "\uFF09" : "") + "\uFF0C\u5C06\u901A\u8FC7\u5E94\u7528\u79C1\u4FE1\u53D1\u9001\u7ED9\u4F60\u3002" + who).trim();
+    }
+    if (params.kind === "timeout") {
+        return ("\u5185\u5BB9\u8F83\u957F\uFF0C\u4E3A\u907F\u514D\u8D85\u65F6\uFF0C\u540E\u7EED\u5185\u5BB9\u5C06\u901A\u8FC7\u5E94\u7528\u79C1\u4FE1\u53D1\u9001\u7ED9\u4F60\u3002" + who).trim();
+    }
+    return ("\u4EA4\u4ED8\u51FA\u73B0\u5F02\u5E38\uFF0C\u5DF2\u5C1D\u8BD5\u901A\u8FC7\u5E94\u7528\u79C1\u4FE1\u53D1\u9001\u7ED9\u4F60\u3002" + who).trim();
+}
+exports.buildFallbackPrompt = buildFallbackPrompt;
+// ============================================================================
+// 本机路径提取
+// ============================================================================
+/**
+ * 从文本中提取本机文件路径（对齐原版 extractLocalFilePathsFromText）
+ */
+function extractLocalFilePathsFromText(text) {
+    if (!text.trim())
+        return [];
+    var re = new RegExp(String.raw(templateObject_1 || (templateObject_1 = __makeTemplateObject(["(/(?:Users|tmp|root|home)/[^s\"'<>\u3000-\u303F\uFF00-\uFFEF\u4E00-\u9FFF\u3400-\u4DBF]+)"], ["(\\/(?:Users|tmp|root|home)\\/[^\\s\"'<>\\u3000-\\u303F\\uFF00-\\uFFEF\\u4E00-\\u9FFF\\u3400-\\u4DBF]+)"]))), "g");
+    var found = new Set();
+    var m;
+    while ((m = re.exec(text))) {
+        var p = m[1];
+        if (p)
+            found.add(p);
+    }
+    return Array.from(found);
+}
+exports.extractLocalFilePathsFromText = extractLocalFilePathsFromText;
+/**
+ * 从文本中提取本机图片路径（对齐原版 extractLocalImagePathsFromText）
+ *
+ * 仅提取 text 中存在且也出现在 mustAlsoAppearIn 中的路径（安全：防止泄漏）
+ */
+function extractLocalImagePathsFromText(params) {
+    var text = params.text, mustAlsoAppearIn = params.mustAlsoAppearIn;
+    if (!text.trim())
+        return [];
+    var exts = "(png|jpg|jpeg|gif|webp|bmp)";
+    var re = new RegExp(String.raw(templateObject_2 || (templateObject_2 = __makeTemplateObject(["(/(?:Users|tmp|root|home)/[^s\"'<>]+?.", ")"], ["(\\/(?:Users|tmp|root|home)\\/[^\\s\"'<>]+?\\.", ")"])), exts), "gi");
+    var found = new Set();
+    var m;
+    while ((m = re.exec(text))) {
+        var p = m[1];
+        if (!p)
+            continue;
+        if (!mustAlsoAppearIn.includes(p))
+            continue;
+        found.add(p);
+    }
+    return Array.from(found);
+}
+exports.extractLocalImagePathsFromText = extractLocalImagePathsFromText;
+/**
+ * 判断文本是否包含"发送本机文件"的意图（对齐原版 looksLikeSendLocalFileIntent）
+ */
+function looksLikeSendLocalFileIntent(rawBody) {
+    var t = rawBody.trim();
+    if (!t)
+        return false;
+    return /(发送|发给|发到|转发|把.*发|把.*发送|帮我发|给我发)/.test(t);
+}
+exports.looksLikeSendLocalFileIntent = looksLikeSendLocalFileIntent;
+// ============================================================================
+// taskKey 与 Agent 配置
+// ============================================================================
+/**
+ * 计算 taskKey（对齐原版 computeTaskKey）
+ */
+function computeTaskKey(target, msg) {
+    var _a;
+    var msgid = msg.msgid ? String(msg.msgid) : "";
+    if (!msgid)
+        return undefined;
+    var aibotid = String((_a = msg.aibotid) !== null && _a !== void 0 ? _a : "unknown").trim() || "unknown";
+    return "bot:" + target.account.accountId + ":" + aibotid + ":" + msgid;
+}
+exports.computeTaskKey = computeTaskKey;
+/**
+ * 检查 Agent 凭证是否已配置（对齐原版 resolveAgentAccountOrUndefined 的简化版）
+ *
+ * 在 webhook 模式下，Agent 凭证直接来自 target.account，不需要复杂的解析
+ */
+function isAgentConfigured(target) {
+    var _a;
+    return Boolean((_a = target.account.agent) === null || _a === void 0 ? void 0 : _a.configured);
+}
+exports.isAgentConfigured = isAgentConfigured;
+/**
+ * 从路径猜测 content-type
+ */
+function guessContentTypeFromPath(filePath) {
+    var _a;
+    var ext = (_a = filePath.split(".").pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+    if (!ext)
+        return undefined;
+    return exports.MIME_BY_EXT[ext];
+}
+exports.guessContentTypeFromPath = guessContentTypeFromPath;
+// ============================================================================
+// Stream Reply 构建
+// ============================================================================
+/**
+ * 从 StreamState 构建最终流式回复（对齐原版 buildStreamReplyFromState）
+ *
+ * 包含 images/msg_item，对 content 做 truncateUtf8Bytes。
+ */
+function buildStreamReplyFromState(state, maxBytes) {
+    var _a;
+    var content = truncateUtf8Bytes(state.content, maxBytes);
+    var result = {
+        msgtype: "stream",
+        stream: __assign({ id: state.streamId, finish: state.finished, content: content }, (state.finished && ((_a = state.images) === null || _a === void 0 ? void 0 : _a.length) ? {
+            msg_item: state.images.map(function (img) { return ({
+                msgtype: "image",
+                image: { base64: img.base64, md5: img.md5 }
+            }); })
+        } : {}))
+    };
+    return result;
+}
+exports.buildStreamReplyFromState = buildStreamReplyFromState;
+/**
+ * 计算 MD5
+ */
+function computeMd5(data) {
+    return node_crypto_1["default"].createHash("md5").update(data).digest("hex");
+}
+exports.computeMd5 = computeMd5;
+// ============================================================================
+// 配置解析
+// ============================================================================
+/**
+ * 解析媒体最大字节数（对齐原版 resolveWecomMediaMaxBytes）
+ */
+function resolveWecomMediaMaxBytes(cfg) {
+    var _a, _b, _c;
+    var val = (_c = (_b = (_a = cfg.channels) === null || _a === void 0 ? void 0 : _a.wecom) === null || _b === void 0 ? void 0 : _b.media) === null || _c === void 0 ? void 0 : _c.maxBytes;
+    if (typeof val === "number" && Number.isFinite(val) && val > 0)
+        return val;
+    return 20 * 1024 * 1024; // 默认 20MB
+}
+exports.resolveWecomMediaMaxBytes = resolveWecomMediaMaxBytes;
+/**
+ * 处理接收消息（对齐原版 processInboundMessage）
+ *
+ * 解析企业微信传入的消息体：
+ * 1. 识别媒体消息（Image/File/Video/Mixed）
+ * 2. 如果存在媒体文件，调用 media.ts 进行解密和下载
+ * 3. 通过 inferInboundMediaMeta 精确推断 MIME 和文件名
+ * 4. 构造统一的 InboundResult 供后续 Agent 处理
+ *
+ * @param target Webhook 目标配置
+ * @param msg 企业微信原始消息对象
+ */
+function processInboundMessage(target, msg) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
+    return __awaiter(this, void 0, void 0, function () {
+        var decryptWecomMediaWithMeta, resolveWecomEgressProxyUrl, msgtype, globalAesKey, maxBytes, proxyUrl, url, aesKey, decrypted, inferred, err_1, errorMessage, url, aesKey, decrypted, inferred, err_2, errorMessage, url, aesKey, decrypted, inferred, err_3, errorMessage, items, foundMedia, bodyParts, _i, items_1, item, t, content, itemAesKey, url, decrypted, inferred, err_4, errorMessage;
+        return __generator(this, function (_3) {
+            switch (_3.label) {
+                case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("./media.js")); })];
+                case 1:
+                    decryptWecomMediaWithMeta = (_3.sent()).decryptWecomMediaWithMeta;
+                    return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("../utils.js")); })];
+                case 2:
+                    resolveWecomEgressProxyUrl = (_3.sent()).resolveWecomEgressProxyUrl;
+                    msgtype = String((_a = msg.msgtype) !== null && _a !== void 0 ? _a : "").toLowerCase();
+                    globalAesKey = target.account.encodingAESKey;
+                    maxBytes = resolveWecomMediaMaxBytes(target.config);
+                    proxyUrl = resolveWecomEgressProxyUrl(target.config);
+                    if (!(msgtype === "image")) return [3 /*break*/, 6];
+                    url = String((_c = (_b = msg.image) === null || _b === void 0 ? void 0 : _b.url) !== null && _c !== void 0 ? _c : "").trim();
+                    aesKey = globalAesKey || ((_d = msg.image) === null || _d === void 0 ? void 0 : _d.aeskey) || "";
+                    if (!(url && aesKey)) return [3 /*break*/, 6];
+                    _3.label = 3;
+                case 3:
+                    _3.trys.push([3, 5, , 6]);
+                    return [4 /*yield*/, decryptWecomMediaWithMeta(url, aesKey, { maxBytes: maxBytes, http: { proxyUrl: proxyUrl } })];
+                case 4:
+                    decrypted = _3.sent();
+                    inferred = inferInboundMediaMeta({
+                        kind: "image",
+                        buffer: decrypted.buffer,
+                        sourceUrl: decrypted.sourceUrl || url,
+                        sourceContentType: decrypted.sourceContentType,
+                        sourceFilename: decrypted.sourceFilename,
+                        explicitFilename: pickBotFileName(msg)
+                    });
+                    return [2 /*return*/, {
+                            body: "[image]",
+                            media: {
+                                buffer: decrypted.buffer,
+                                contentType: inferred.contentType,
+                                filename: inferred.filename
+                            }
+                        }];
+                case 5:
+                    err_1 = _3.sent();
+                    (_f = (_e = target.runtime).error) === null || _f === void 0 ? void 0 : _f.call(_e, "Failed to decrypt inbound image: " + String(err_1));
+                    (_h = (_g = target.runtime).error) === null || _h === void 0 ? void 0 : _h.call(_g, "\u56FE\u7247\u89E3\u5BC6\u5931\u8D25: " + String(err_1) + "; \u53EF\u8C03\u5927 channels.wecom.media.maxBytes\uFF08\u5F53\u524D=" + maxBytes + "\uFF09\u4F8B\u5982\uFF1Aopenclaw config set channels.wecom.media.maxBytes " + 50 * 1024 * 1024);
+                    errorMessage = formatDecryptError(err_1);
+                    return [2 /*return*/, { body: "[image] (decryption failed: " + errorMessage + ")" }];
+                case 6:
+                    if (!(msgtype === "file")) return [3 /*break*/, 10];
+                    url = String((_k = (_j = msg.file) === null || _j === void 0 ? void 0 : _j.url) !== null && _k !== void 0 ? _k : "").trim();
+                    aesKey = globalAesKey || ((_l = msg.file) === null || _l === void 0 ? void 0 : _l.aeskey) || "";
+                    if (!(url && aesKey)) return [3 /*break*/, 10];
+                    _3.label = 7;
+                case 7:
+                    _3.trys.push([7, 9, , 10]);
+                    return [4 /*yield*/, decryptWecomMediaWithMeta(url, aesKey, { maxBytes: maxBytes, http: { proxyUrl: proxyUrl } })];
+                case 8:
+                    decrypted = _3.sent();
+                    inferred = inferInboundMediaMeta({
+                        kind: "file",
+                        buffer: decrypted.buffer,
+                        sourceUrl: decrypted.sourceUrl || url,
+                        sourceContentType: decrypted.sourceContentType,
+                        sourceFilename: decrypted.sourceFilename,
+                        explicitFilename: pickBotFileName(msg)
+                    });
+                    return [2 /*return*/, {
+                            body: "[file]",
+                            media: {
+                                buffer: decrypted.buffer,
+                                contentType: inferred.contentType,
+                                filename: inferred.filename
+                            }
+                        }];
+                case 9:
+                    err_2 = _3.sent();
+                    (_o = (_m = target.runtime).error) === null || _o === void 0 ? void 0 : _o.call(_m, "Failed to decrypt inbound file: " + String(err_2) + "; \u53EF\u8C03\u5927 channels.wecom.media.maxBytes\uFF08\u5F53\u524D=" + maxBytes + "\uFF09\u4F8B\u5982\uFF1Aopenclaw config set channels.wecom.media.maxBytes " + 50 * 1024 * 1024);
+                    errorMessage = formatDecryptError(err_2);
+                    return [2 /*return*/, { body: "[file] (decryption failed: " + errorMessage + ")" }];
+                case 10:
+                    if (!(msgtype === "video")) return [3 /*break*/, 14];
+                    url = String((_q = (_p = msg.video) === null || _p === void 0 ? void 0 : _p.url) !== null && _q !== void 0 ? _q : "").trim();
+                    aesKey = globalAesKey || ((_r = msg.video) === null || _r === void 0 ? void 0 : _r.aeskey) || "";
+                    if (!(url && aesKey)) return [3 /*break*/, 14];
+                    _3.label = 11;
+                case 11:
+                    _3.trys.push([11, 13, , 14]);
+                    return [4 /*yield*/, decryptWecomMediaWithMeta(url, aesKey, { maxBytes: maxBytes, http: { proxyUrl: proxyUrl } })];
+                case 12:
+                    decrypted = _3.sent();
+                    inferred = inferInboundMediaMeta({
+                        kind: "file",
+                        buffer: decrypted.buffer,
+                        sourceUrl: decrypted.sourceUrl || url,
+                        sourceContentType: decrypted.sourceContentType,
+                        sourceFilename: decrypted.sourceFilename,
+                        explicitFilename: pickBotFileName(msg)
+                    });
+                    return [2 /*return*/, {
+                            body: "[video] \u89C6\u9891\u6587\u4EF6\u5DF2\u4FDD\u5B58\uFF0C\u6587\u4EF6\u540D: " + inferred.filename,
+                            media: {
+                                buffer: decrypted.buffer,
+                                contentType: inferred.contentType,
+                                filename: inferred.filename
+                            }
+                        }];
+                case 13:
+                    err_3 = _3.sent();
+                    (_t = (_s = target.runtime).error) === null || _t === void 0 ? void 0 : _t.call(_s, "Failed to decrypt inbound video: " + String(err_3) + "; \u53EF\u8C03\u5927 channels.wecom.media.maxBytes\uFF08\u5F53\u524D=" + maxBytes + "\uFF09\u4F8B\u5982\uFF1Aopenclaw config set channels.wecom.media.maxBytes " + 50 * 1024 * 1024);
+                    errorMessage = formatDecryptError(err_3);
+                    return [2 /*return*/, { body: "[video] (decryption failed: " + errorMessage + ")" }];
+                case 14:
+                    if (!(msgtype === "mixed")) return [3 /*break*/, 27];
+                    items = (_u = msg.mixed) === null || _u === void 0 ? void 0 : _u.msg_item;
+                    if (!Array.isArray(items)) return [3 /*break*/, 27];
+                    foundMedia = undefined;
+                    bodyParts = [];
+                    _i = 0, items_1 = items;
+                    _3.label = 15;
+                case 15:
+                    if (!(_i < items_1.length)) return [3 /*break*/, 26];
+                    item = items_1[_i];
+                    t = String((_v = item.msgtype) !== null && _v !== void 0 ? _v : "").toLowerCase();
+                    if (!(t === "text")) return [3 /*break*/, 16];
+                    content = String((_x = (_w = item.text) === null || _w === void 0 ? void 0 : _w.content) !== null && _x !== void 0 ? _x : "").trim();
+                    if (content)
+                        bodyParts.push(content);
+                    return [3 /*break*/, 25];
+                case 16:
+                    if (!((t === "image" || t === "file") && !foundMedia)) return [3 /*break*/, 24];
+                    itemAesKey = globalAesKey || ((_y = item[t]) === null || _y === void 0 ? void 0 : _y.aeskey) || "";
+                    url = String((_0 = (_z = item[t]) === null || _z === void 0 ? void 0 : _z.url) !== null && _0 !== void 0 ? _0 : "").trim();
+                    if (!!itemAesKey) return [3 /*break*/, 17];
+                    bodyParts.push("[" + t + "]");
+                    return [3 /*break*/, 23];
+                case 17:
+                    if (!url) return [3 /*break*/, 22];
+                    _3.label = 18;
+                case 18:
+                    _3.trys.push([18, 20, , 21]);
+                    return [4 /*yield*/, decryptWecomMediaWithMeta(url, itemAesKey, { maxBytes: maxBytes, http: { proxyUrl: proxyUrl } })];
+                case 19:
+                    decrypted = _3.sent();
+                    inferred = inferInboundMediaMeta({
+                        kind: t,
+                        buffer: decrypted.buffer,
+                        sourceUrl: decrypted.sourceUrl || url,
+                        sourceContentType: decrypted.sourceContentType,
+                        sourceFilename: decrypted.sourceFilename,
+                        explicitFilename: pickBotFileName(msg, item === null || item === void 0 ? void 0 : item[t])
+                    });
+                    foundMedia = {
+                        buffer: decrypted.buffer,
+                        contentType: inferred.contentType,
+                        filename: inferred.filename
+                    };
+                    bodyParts.push("[" + t + "]");
+                    return [3 /*break*/, 21];
+                case 20:
+                    err_4 = _3.sent();
+                    (_2 = (_1 = target.runtime).error) === null || _2 === void 0 ? void 0 : _2.call(_1, "Failed to decrypt mixed " + t + ": " + String(err_4) + "; \u53EF\u8C03\u5927 channels.wecom.media.maxBytes\uFF08\u5F53\u524D=" + maxBytes + "\uFF09\u4F8B\u5982\uFF1Aopenclaw config set channels.wecom.media.maxBytes " + 50 * 1024 * 1024);
+                    errorMessage = formatDecryptError(err_4);
+                    bodyParts.push("[" + t + "] (decryption failed: " + errorMessage + ")");
+                    return [3 /*break*/, 21];
+                case 21: return [3 /*break*/, 23];
+                case 22:
+                    bodyParts.push("[" + t + "]");
+                    _3.label = 23;
+                case 23: return [3 /*break*/, 25];
+                case 24:
+                    bodyParts.push("[" + t + "]");
+                    _3.label = 25;
+                case 25:
+                    _i++;
+                    return [3 /*break*/, 15];
+                case 26: return [2 /*return*/, {
+                        body: bodyParts.join("\n"),
+                        media: foundMedia
+                    }];
+                case 27: 
+                // 其他消息类型：使用 buildInboundBody 构建文本表示
+                return [2 /*return*/, { body: buildInboundBody(msg) }];
+            }
+        });
+    });
+}
+exports.processInboundMessage = processInboundMessage;
+// ============================================================================
+// processInboundMessage 依赖的辅助函数
+// ============================================================================
+/** 格式化解密错误信息（对齐原版格式：message + cause） */
+function formatDecryptError(err) {
+    var _a;
+    if (typeof err === "object" && err) {
+        var msg = (_a = err.message) !== null && _a !== void 0 ? _a : String(err);
+        var cause = err.cause;
+        return cause ? msg + " (cause: " + String(cause) + ")" : String(msg);
+    }
+    return String(err);
+}
+/** 从消息中提取显式文件名（对齐原版 pickBotFileName） */
+function pickBotFileName(msg, item) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+    var fromItem = item
+        ? resolveInlineFileName((_d = (_c = (_b = (_a = item === null || item === void 0 ? void 0 : item.filename) !== null && _a !== void 0 ? _a : item === null || item === void 0 ? void 0 : item.file_name) !== null && _b !== void 0 ? _b : item === null || item === void 0 ? void 0 : item.fileName) !== null && _c !== void 0 ? _c : item === null || item === void 0 ? void 0 : item.name) !== null && _d !== void 0 ? _d : item === null || item === void 0 ? void 0 : item.title)
+        : undefined;
+    if (fromItem)
+        return fromItem;
+    var fromFile = resolveInlineFileName((_y = (_w = (_u = (_r = (_o = (_k = (_g = (_f = (_e = msg) === null || _e === void 0 ? void 0 : _e.file) === null || _f === void 0 ? void 0 : _f.filename) !== null && _g !== void 0 ? _g : (_j = (_h = msg) === null || _h === void 0 ? void 0 : _h.file) === null || _j === void 0 ? void 0 : _j.file_name) !== null && _k !== void 0 ? _k : (_m = (_l = msg) === null || _l === void 0 ? void 0 : _l.file) === null || _m === void 0 ? void 0 : _m.fileName) !== null && _o !== void 0 ? _o : (_q = (_p = msg) === null || _p === void 0 ? void 0 : _p.file) === null || _q === void 0 ? void 0 : _q.name) !== null && _r !== void 0 ? _r : (_t = (_s = msg) === null || _s === void 0 ? void 0 : _s.file) === null || _t === void 0 ? void 0 : _t.title) !== null && _u !== void 0 ? _u : (_v = msg) === null || _v === void 0 ? void 0 : _v.filename) !== null && _w !== void 0 ? _w : (_x = msg) === null || _x === void 0 ? void 0 : _x.fileName) !== null && _y !== void 0 ? _y : (_z = msg) === null || _z === void 0 ? void 0 : _z.FileName);
+    return fromFile;
+}
+function resolveInlineFileName(input) {
+    var raw = String(input !== null && input !== void 0 ? input : "").trim();
+    return sanitizeInboundFilename(raw);
+}
+/** 清理文件名（移除非法字符） */
+function sanitizeInboundFilename(raw) {
+    var _a, _b;
+    var s = String(raw !== null && raw !== void 0 ? raw : "").trim();
+    if (!s)
+        return undefined;
+    var base = (_b = (_a = s.split(/[\\/]/).pop()) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "";
+    if (!base)
+        return undefined;
+    var sanitized = base.replace(/[\u0000-\u001f<>:"|?*]/g, "_").trim();
+    return sanitized || undefined;
+}
+/** 从 URL 中提取文件名 */
+function extractFileNameFromUrl(rawUrl) {
+    var _a;
+    var s = String(rawUrl !== null && rawUrl !== void 0 ? rawUrl : "").trim();
+    if (!s)
+        return undefined;
+    try {
+        var u = new URL(s);
+        var name = decodeURIComponent((_a = u.pathname.split("/").pop()) !== null && _a !== void 0 ? _a : "").trim();
+        return name || undefined;
+    }
+    catch (_b) {
+        return undefined;
+    }
+}
+/** 检查文件名是否有常见扩展名 */
+function hasLikelyExtension(name) {
+    if (!name)
+        return false;
+    return /\.[a-z0-9]{1,16}$/i.test(name);
+}
+/** 归一化 Content-Type */
+function normalizeContentType(raw) {
+    var _a;
+    var normalized = (_a = String(raw !== null && raw !== void 0 ? raw : "").trim().split(";")[0]) === null || _a === void 0 ? void 0 : _a.trim().toLowerCase();
+    return normalized || undefined;
+}
+var GENERIC_CONTENT_TYPES = new Set([
+    "application/octet-stream",
+    "binary/octet-stream",
+    "application/download",
+]);
+function isGenericContentType(raw) {
+    var normalized = normalizeContentType(raw);
+    if (!normalized)
+        return true;
+    return GENERIC_CONTENT_TYPES.has(normalized);
+}
+var EXT_BY_MIME = __assign(__assign({}, Object.fromEntries(Object.entries(exports.MIME_BY_EXT).map(function (_a) {
+    var ext = _a[0], mime = _a[1];
+    return [mime, ext];
+}))), { "application/octet-stream": "bin" });
+/** 从 Content-Type 反推扩展名 */
+function guessExtensionFromContentType(contentType) {
+    var normalized = normalizeContentType(contentType);
+    if (!normalized)
+        return undefined;
+    if (normalized === "image/jpeg")
+        return "jpg";
+    return EXT_BY_MIME[normalized];
+}
+/**
+ * 从 Buffer magic bytes 检测 MIME（对齐原版 detectMimeFromBuffer）
+ *
+ * 注意：这是同步版本，用于 inferInboundMediaMeta 中的快速检测。
+ * 与 media.ts 中的 async detectMimeFromBuffer 不同，不使用 file-type 库。
+ */
+function detectMimeFromBufferSync(buffer) {
+    var _a;
+    if (!buffer || buffer.length < 4)
+        return undefined;
+    // PNG
+    if (buffer.length >= 8 &&
+        buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47 &&
+        buffer[4] === 0x0d && buffer[5] === 0x0a && buffer[6] === 0x1a && buffer[7] === 0x0a)
+        return "image/png";
+    // JPEG
+    if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff)
+        return "image/jpeg";
+    // GIF
+    if (buffer.subarray(0, 6).toString("ascii") === "GIF87a" || buffer.subarray(0, 6).toString("ascii") === "GIF89a")
+        return "image/gif";
+    // WEBP
+    if (buffer.length >= 12 && buffer.subarray(0, 4).toString("ascii") === "RIFF" && buffer.subarray(8, 12).toString("ascii") === "WEBP")
+        return "image/webp";
+    // BMP
+    if (buffer[0] === 0x42 && buffer[1] === 0x4d)
+        return "image/bmp";
+    // PDF
+    if (buffer.subarray(0, 5).toString("ascii") === "%PDF-")
+        return "application/pdf";
+    // OGG
+    if (buffer.subarray(0, 4).toString("ascii") === "OggS")
+        return "audio/ogg";
+    // WAV
+    if (buffer.length >= 12 && buffer.subarray(0, 4).toString("ascii") === "RIFF" && buffer.subarray(8, 12).toString("ascii") === "WAVE")
+        return "audio/wav";
+    // MP3
+    if (buffer.subarray(0, 3).toString("ascii") === "ID3" || (buffer[0] === 0xff && (((_a = buffer[1]) !== null && _a !== void 0 ? _a : 0) & 0xe0) === 0xe0))
+        return "audio/mpeg";
+    // MP4/MOV family
+    if (buffer.length >= 12 && buffer.subarray(4, 8).toString("ascii") === "ftyp")
+        return "video/mp4";
+    // Legacy Office (OLE Compound File)
+    if (buffer.length >= 8 &&
+        buffer[0] === 0xd0 && buffer[1] === 0xcf && buffer[2] === 0x11 && buffer[3] === 0xe0 &&
+        buffer[4] === 0xa1 && buffer[5] === 0xb1 && buffer[6] === 0x1a && buffer[7] === 0xe1)
+        return "application/msword";
+    // ZIP / OOXML
+    var zipMagic = (buffer[0] === 0x50 && buffer[1] === 0x4b && buffer[2] === 0x03 && buffer[3] === 0x04) ||
+        (buffer[0] === 0x50 && buffer[1] === 0x4b && buffer[2] === 0x05 && buffer[3] === 0x06) ||
+        (buffer[0] === 0x50 && buffer[1] === 0x4b && buffer[2] === 0x07 && buffer[3] === 0x08);
+    if (zipMagic) {
+        var probe = buffer.subarray(0, Math.min(buffer.length, 512 * 1024));
+        if (probe.includes(Buffer.from("word/")))
+            return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+        if (probe.includes(Buffer.from("xl/")))
+            return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+        if (probe.includes(Buffer.from("ppt/")))
+            return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+        return "application/zip";
+    }
+    // Plain text heuristic
+    var sample = buffer.subarray(0, Math.min(buffer.length, 4096));
+    var printable = 0;
+    for (var _i = 0, sample_1 = sample; _i < sample_1.length; _i++) {
+        var b = sample_1[_i];
+        if (b === 0x00)
+            return undefined;
+        if (b === 0x09 || b === 0x0a || b === 0x0d || (b >= 0x20 && b <= 0x7e)) {
+            printable += 1;
+        }
+    }
+    if (sample.length > 0 && printable / sample.length > 0.95)
+        return "text/plain";
+    return undefined;
+}
+/**
+ * 推断入站媒体的 MIME 和文件名（对齐原版 inferInboundMediaMeta）
+ *
+ * 优先级链：magic bytes > HTTP header > URL 路径 > 文件名扩展 > 默认值
+ */
+function inferInboundMediaMeta(params) {
+    var headerType = normalizeContentType(params.sourceContentType);
+    var magicType = detectMimeFromBufferSync(params.buffer);
+    var rawUrlName = sanitizeInboundFilename(extractFileNameFromUrl(params.sourceUrl));
+    var guessedByUrl = hasLikelyExtension(rawUrlName) ? rawUrlName : undefined;
+    var explicitName = sanitizeInboundFilename(params.explicitFilename);
+    var sourceName = sanitizeInboundFilename(params.sourceFilename);
+    var chosenName = explicitName || sourceName || guessedByUrl;
+    var typeByName = chosenName ? guessContentTypeFromPath(chosenName) : undefined;
+    var contentType;
+    if (params.kind === "image") {
+        if (magicType === null || magicType === void 0 ? void 0 : magicType.startsWith("image/"))
+            contentType = magicType;
+        else if (headerType === null || headerType === void 0 ? void 0 : headerType.startsWith("image/"))
+            contentType = headerType;
+        else if (typeByName === null || typeByName === void 0 ? void 0 : typeByName.startsWith("image/"))
+            contentType = typeByName;
+        else
+            contentType = "image/jpeg";
+    }
+    else {
+        contentType =
+            magicType ||
+                (!isGenericContentType(headerType) ? headerType : undefined) ||
+                typeByName ||
+                "application/octet-stream";
+    }
+    var hasExt = Boolean(chosenName && /\.[a-z0-9]{1,16}$/i.test(chosenName));
+    var ext = guessExtensionFromContentType(contentType) || (params.kind === "image" ? "jpg" : "bin");
+    var filename = chosenName
+        ? (hasExt ? chosenName : chosenName + "." + ext)
+        : params.kind + "." + ext;
+    return { contentType: contentType, filename: filename };
+}
+// ============================================================================
+// 配置解析
+// ============================================================================
+/**
+ * 构建 Agent 调度所需的 config（对齐原版 cfgForDispatch 逻辑）
+ *
+ * 关键修改：
+ * - tools.deny += "message"（防止 Agent 绕过 Bot 交付）
+ * - blockStreamingChunk / blockStreamingCoalesce 使用更小的阈值
+ */
+function buildCfgForDispatch(config) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+    var baseAgents = (_b = (_a = config) === null || _a === void 0 ? void 0 : _a.agents) !== null && _b !== void 0 ? _b : {};
+    var baseAgentDefaults = (_d = (_c = baseAgents) === null || _c === void 0 ? void 0 : _c.defaults) !== null && _d !== void 0 ? _d : {};
+    var baseBlockChunk = (_f = (_e = baseAgentDefaults) === null || _e === void 0 ? void 0 : _e.blockStreamingChunk) !== null && _f !== void 0 ? _f : {};
+    var baseBlockCoalesce = (_h = (_g = baseAgentDefaults) === null || _g === void 0 ? void 0 : _g.blockStreamingCoalesce) !== null && _h !== void 0 ? _h : {};
+    var baseTools = (_k = (_j = config) === null || _j === void 0 ? void 0 : _j.tools) !== null && _k !== void 0 ? _k : {};
+    var baseSandbox = (_m = (_l = baseTools) === null || _l === void 0 ? void 0 : _l.sandbox) !== null && _m !== void 0 ? _m : {};
+    var baseSandboxTools = (_p = (_o = baseSandbox) === null || _o === void 0 ? void 0 : _o.tools) !== null && _p !== void 0 ? _p : {};
+    var existingTopLevelDeny = Array.isArray(baseTools.deny) ? baseTools.deny : [];
+    var existingSandboxDeny = Array.isArray(baseSandboxTools.deny) ? baseSandboxTools.deny : [];
+    var topLevelDeny = Array.from(new Set(__spreadArrays(existingTopLevelDeny, ["message"])));
+    var sandboxDeny = Array.from(new Set(__spreadArrays(existingSandboxDeny, ["message"])));
+    return __assign(__assign({}, config), { agents: __assign(__assign({}, baseAgents), { defaults: __assign(__assign({}, baseAgentDefaults), { blockStreamingChunk: __assign(__assign({}, baseBlockChunk), { minChars: (_q = baseBlockChunk.minChars) !== null && _q !== void 0 ? _q : 120, maxChars: (_r = baseBlockChunk.maxChars) !== null && _r !== void 0 ? _r : 360, breakPreference: (_s = baseBlockChunk.breakPreference) !== null && _s !== void 0 ? _s : "sentence" }), blockStreamingCoalesce: __assign(__assign({}, baseBlockCoalesce), { minChars: (_t = baseBlockCoalesce.minChars) !== null && _t !== void 0 ? _t : 120, maxChars: (_u = baseBlockCoalesce.maxChars) !== null && _u !== void 0 ? _u : 360, idleMs: (_v = baseBlockCoalesce.idleMs) !== null && _v !== void 0 ? _v : 250 }) }) }), tools: __assign(__assign({}, baseTools), { deny: topLevelDeny, sandbox: __assign(__assign({}, baseSandbox), { tools: __assign(__assign({}, baseSandboxTools), { deny: sandboxDeny }) }) }) });
+}
+exports.buildCfgForDispatch = buildCfgForDispatch;
+/**
+ * 解析企微 Bot 回调中的发送者 userid（对齐原版 resolveWecomSenderUserId）
+ *
+ * 优先级：from.userid → fromuserid → from_userid → fromUserId
+ */
+function resolveWecomSenderUserId(msg) {
+    var _a, _b, _c, _d, _e;
+    var direct = (_b = (_a = msg.from) === null || _a === void 0 ? void 0 : _a.userid) === null || _b === void 0 ? void 0 : _b.trim();
+    if (direct)
+        return direct;
+    var rawMsg = msg;
+    var legacy = String((_e = (_d = (_c = rawMsg.fromuserid) !== null && _c !== void 0 ? _c : rawMsg.from_userid) !== null && _d !== void 0 ? _d : rawMsg.fromUserId) !== null && _e !== void 0 ? _e : "").trim();
+    return legacy || undefined;
+}
+exports.resolveWecomSenderUserId = resolveWecomSenderUserId;
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 构造入站消息文本内容（对齐原版 buildInboundBody）
+ *
+ * 根据消息类型提取文本表示：
+ * - text → text.content
+ * - voice → voice.content 或 "[voice]"
+ * - image → "[image] {url}"
+ * - file → "[file] {url}"
+ * - video → "[video] {url}"
+ * - mixed → 逐项提取拼接
+ * - event → "[event] {eventtype}"
+ * - stream → "[stream_refresh] {id}"
+ *
+ * 如果消息包含 quote（引用），追加引用内容。
+ */
+function buildInboundBody(msg) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var body = "";
+    var msgtype = String((_a = msg.msgtype) !== null && _a !== void 0 ? _a : "").toLowerCase();
+    if (msgtype === "text") {
+        body = ((_b = msg.text) === null || _b === void 0 ? void 0 : _b.content) || "";
+    }
+    else if (msgtype === "voice") {
+        body = ((_c = msg.voice) === null || _c === void 0 ? void 0 : _c.content) || "[voice]";
+    }
+    else if (msgtype === "mixed") {
+        var items = (_d = msg.mixed) === null || _d === void 0 ? void 0 : _d.msg_item;
+        if (Array.isArray(items)) {
+            body = items.map(function (item) {
+                var _a, _b, _c;
+                var t = String((_a = item === null || item === void 0 ? void 0 : item.msgtype) !== null && _a !== void 0 ? _a : "").toLowerCase();
+                if (t === "text")
+                    return ((_b = item === null || item === void 0 ? void 0 : item.text) === null || _b === void 0 ? void 0 : _b.content) || "";
+                if (t === "image")
+                    return "[image] " + (((_c = item === null || item === void 0 ? void 0 : item.image) === null || _c === void 0 ? void 0 : _c.url) || "");
+                return "[" + (t || "item") + "]";
+            }).filter(Boolean).join("\n");
+        }
+        else {
+            body = "[mixed]";
+        }
+    }
+    else if (msgtype === "image") {
+        body = "[image] " + (((_e = msg.image) === null || _e === void 0 ? void 0 : _e.url) || "");
+    }
+    else if (msgtype === "file") {
+        body = "[file] " + (((_f = msg.file) === null || _f === void 0 ? void 0 : _f.url) || "");
+    }
+    else if (msgtype === "video") {
+        body = "[video] " + (((_g = msg.video) === null || _g === void 0 ? void 0 : _g.url) || "");
+    }
+    else if (msgtype === "event") {
+        body = "[event] " + (((_h = msg.event) === null || _h === void 0 ? void 0 : _h.eventtype) || "");
+    }
+    else if (msgtype === "stream") {
+        body = "[stream_refresh] " + (((_j = msg.stream) === null || _j === void 0 ? void 0 : _j.id) || "");
+    }
+    else {
+        body = msgtype ? "[" + msgtype + "]" : "";
+    }
+    // 引用消息处理
+    var quote = msg.quote;
+    if (quote) {
+        var quoteText = formatQuote(quote).trim();
+        if (quoteText)
+            body += "\n\n> " + quoteText;
+    }
+    return body;
+}
+exports.buildInboundBody = buildInboundBody;
+/**
+ * 格式化引用消息文本（对齐原版 formatQuote）
+ */
+function formatQuote(quote) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    var type = (_a = quote.msgtype) !== null && _a !== void 0 ? _a : "";
+    if (type === "text")
+        return ((_b = quote.text) === null || _b === void 0 ? void 0 : _b.content) || "";
+    if (type === "image")
+        return "[\u5F15\u7528: \u56FE\u7247] " + (((_c = quote.image) === null || _c === void 0 ? void 0 : _c.url) || "");
+    if (type === "mixed" && ((_d = quote.mixed) === null || _d === void 0 ? void 0 : _d.msg_item)) {
+        var items = quote.mixed.msg_item.map(function (item) {
+            var _a, _b;
+            if (item.msgtype === "text")
+                return (_a = item.text) === null || _a === void 0 ? void 0 : _a.content;
+            if (item.msgtype === "image")
+                return "[\u56FE\u7247] " + (((_b = item.image) === null || _b === void 0 ? void 0 : _b.url) || "");
+            return "";
+        }).filter(Boolean).join(" ");
+        return "[\u5F15\u7528: \u56FE\u6587] " + items;
+    }
+    if (type === "voice")
+        return "[\u5F15\u7528: \u8BED\u97F3] " + (((_e = quote.voice) === null || _e === void 0 ? void 0 : _e.content) || "");
+    if (type === "file")
+        return "[\u5F15\u7528: \u6587\u4EF6] " + (((_f = quote.file) === null || _f === void 0 ? void 0 : _f.url) || "");
+    if (type === "video")
+        return "[\u5F15\u7528: \u89C6\u9891] " + (((_g = quote.video) === null || _g === void 0 ? void 0 : _g.url) || "");
+    return "";
+}
+exports.formatQuote = formatQuote;
+/** 检查消息是否有媒体内容 */
+function hasMedia(message) {
+    var _a, _b;
+    var type = message.msgtype;
+    return ["image", "file", "voice", "video"].includes(type) ||
+        (type === "mixed" && ((_b = (_a = message.mixed) === null || _a === void 0 ? void 0 : _a.msg_item) === null || _b === void 0 ? void 0 : _b.some(function (item) { return item.msgtype !== "text"; })) === true);
+}
+exports.hasMedia = hasMedia;
+/**
+ * 构造占位符响应（对齐原版 buildStreamPlaceholderReply）
+ *
+ * 用于 active_new / queued_new 场景：finish=false，显示占位符文本。
+ * 原版规范：第一次回复内容为 "1" 作为最小占位符。
+ */
+function buildStreamPlaceholderReply(streamId, placeholderContent) {
+    var content = (placeholderContent === null || placeholderContent === void 0 ? void 0 : placeholderContent.trim()) || "1";
+    return {
+        msgtype: "stream",
+        stream: {
+            id: streamId,
+            finish: false,
+            content: content
+        }
+    };
+}
+exports.buildStreamPlaceholderReply = buildStreamPlaceholderReply;
+/**
+ * 构造文本占位符响应（对齐原版 buildStreamTextPlaceholderReply）
+ *
+ * 用于 merged 场景：finish=false，显示自定义提示（如"已合并排队处理中..."）。
+ */
+function buildStreamTextPlaceholderReply(streamId, content) {
+    return {
+        msgtype: "stream",
+        stream: {
+            id: streamId,
+            finish: false,
+            content: content.trim() || "1"
+        }
+    };
+}
+exports.buildStreamTextPlaceholderReply = buildStreamTextPlaceholderReply;
+/**
+ * 构造流式响应（从 StreamState 构建）
+ *
+ * 用于 stream_refresh 和 msgid 去重场景：返回当前累积内容 + finish 标记。
+ */
+function buildStreamResponse(stream) {
+    var response = {
+        msgtype: "stream",
+        stream: {
+            id: stream.streamId,
+            finish: stream.finished,
+            content: stream.content
+        }
+    };
+    // 添加图片附件
+    if (stream.images && stream.images.length > 0) {
+        var streamObj = response.stream;
+        streamObj.msg_item = stream.images.map(function (img) { return ({
+            msgtype: "image",
+            image: { base64: img.base64, md5: img.md5 }
+        }); });
+    }
+    return response;
+}
+exports.buildStreamResponse = buildStreamResponse;
+var templateObject_1, templateObject_2;