ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/webhook/gateway.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * Webhook Gateway 生命周期管理
+ *
+ * 从 @mocrane/wecom gateway-monitor.ts 部分迁移（仅 Webhook 部分）。
+ * 负责：初始化状态、注册 Target、启停管理。
+ *
+ * 关键设计：
+ * - MonitorState 是全局单例（monitorState），所有账号共享同一个 StreamStore 和 ActiveReplyStore
+ * - Target 注册/注销不影响 monitorState 生命周期，只控制 pruneTimer 的启停
+ * - 每个账号注册多条路径（兼容历史路径 + 推荐路径 + 多账号路径）
+ * - 按 accountId 管理各自的 unregister，stop 时只注销该账号的 Target
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+exports.__esModule = true;
+exports.stopWebhookGateway = exports.startWebhookGateway = exports.getMonitorState = void 0;
+var types_js_1 = require("./types.js");
+var state_js_1 = require("./state.js");
+var target_js_1 = require("./target.js");
+var monitor_js_1 = require("./monitor.js");
+var accounts_js_1 = require("../accounts.js");
+var openclaw_compat_js_1 = require("../openclaw-compat.js");
+var runtime_js_1 = require("../runtime.js");
+// ============================================================================
+// 全局状态
+// ============================================================================
+/** 按 accountId 管理各账号的 Target 注销函数 */
+var accountUnregisters = new Map();
+/** FlushHandler 是否已设置（只需设置一次，因为 monitorState 是单例） */
+var flushHandlerInstalled = false;
+// ============================================================================
+// 路径解析
+// ============================================================================
+/**
+ * 去除重复路径
+ */
+function uniquePaths(paths) {
+    return Array.from(new Set(paths.map(function (p) { return p.trim(); }).filter(Boolean)));
+}
+/**
+ * 解析 Bot Target 注册路径
+ *
+ * 多账号场景（matrixMode）下：注册带 accountId 后缀的路径 + 兼容老路径
+ * 单账号场景下：只注册基础路径
+ *
+ * 参考 lh 版 resolveBotRegistrationPaths
+ */
+function resolveBotRegistrationPaths(params) {
+    if (params.matrixMode) {
+        return uniquePaths([
+            types_js_1.WEBHOOK_PATHS.BOT_PLUGIN + "/" + params.accountId,
+            types_js_1.WEBHOOK_PATHS.BOT_ALT + "/" + params.accountId,
+            // 兼容老路径：不带 accountId 后缀，签名验证会自动匹配到正确账号
+            types_js_1.WEBHOOK_PATHS.BOT_PLUGIN,
+            types_js_1.WEBHOOK_PATHS.BOT,
+            types_js_1.WEBHOOK_PATHS.BOT_ALT,
+        ]);
+    }
+    // 单账号模式：同时注册 /default 路径以支持显式指定
+    return uniquePaths([
+        types_js_1.WEBHOOK_PATHS.BOT_PLUGIN,
+        types_js_1.WEBHOOK_PATHS.BOT,
+        types_js_1.WEBHOOK_PATHS.BOT_ALT,
+        types_js_1.WEBHOOK_PATHS.BOT_PLUGIN + "/" + openclaw_compat_js_1.DEFAULT_ACCOUNT_ID,
+        types_js_1.WEBHOOK_PATHS.BOT_ALT + "/" + openclaw_compat_js_1.DEFAULT_ACCOUNT_ID,
+    ]);
+}
+// ============================================================================
+// 公共 API
+// ============================================================================
+/**
+ * 获取当前的 MonitorState 实例（全局单例）
+ *
+ * 供 monitor.ts 等内部模块调用以访问 StreamStore 和 ActiveReplyStore。
+ */
+function getMonitorState() {
+    return state_js_1.monitorState;
+}
+exports.getMonitorState = getMonitorState;
+/**
+ * 启动 Webhook Gateway
+ *
+ * 1. 验证 Webhook 配置
+ * 2. 确保 pruneTimer 启动
+ * 3. 设置 FlushHandler（仅首次）
+ * 4. 解析并注册多条 Webhook 路径
+ */
+function startWebhookGateway(ctx) {
+    var _a, _b, _c, _d;
+    var account = ctx.account, config = ctx.config, runtime = ctx.runtime;
+    var log = (_a = ctx.log) !== null && _a !== void 0 ? _a : {
+        info: function (msg) { return runtime.log(msg); },
+        error: function (msg) { return runtime.error(msg); }
+    };
+    // 1. 验证必要配置（receiveId 非必填，可为空）
+    if (!account.token || !account.encodingAESKey) {
+        var missing = [];
+        if (!account.token)
+            missing.push("token");
+        if (!account.encodingAESKey)
+            missing.push("encodingAESKey");
+        var errorMsg = "[webhook] Webhook \u914D\u7F6E\u4E0D\u5B8C\u6574\uFF0C\u7F3A\u5C11: " + missing.join(", ");
+        log.error(errorMsg);
+        (_b = ctx.setStatus) === null || _b === void 0 ? void 0 : _b.call(ctx, {
+            accountId: ctx.accountId,
+            running: false,
+            configured: false,
+            lastError: errorMsg
+        });
+        return;
+    }
+    log.info("[webhook] \u542F\u52A8 Webhook Gateway (accountId=" + ctx.accountId + ")");
+    // 2. 确保 pruneTimer 启动（幂等：如果已在运行，不会重复启动）
+    state_js_1.monitorState.startPruning(types_js_1.PRUNE_INTERVAL_MS);
+    // 3. 设置 FlushHandler（仅首次，因为 monitorState 是全局单例）
+    if (!flushHandlerInstalled) {
+        state_js_1.monitorState.streamStore.setFlushHandler(function (pending) { return void flushPending(pending); });
+        flushHandlerInstalled = true;
+    }
+    // 4. 构造 Target 上下文
+    var runtimeEnv = {
+        log: function (msg) { return runtime.log(msg); },
+        error: function (msg) { return runtime.error(msg); }
+    };
+    // 判断是否为多账号模式
+    var matrixMode = accounts_js_1.hasMultiAccounts(ctx.config);
+    var target = {
+        account: account,
+        config: config,
+        runtime: runtimeEnv,
+        core: ((_c = ctx.channelRuntime) !== null && _c !== void 0 ? _c : runtime),
+        path: types_js_1.WEBHOOK_PATHS.BOT_PLUGIN + "/" + ctx.accountId,
+        statusSink: ctx.setStatus
+            ? function (patch) { var _a; return (_a = ctx.setStatus) === null || _a === void 0 ? void 0 : _a.call(ctx, __assign({ accountId: ctx.accountId }, patch)); }
+            : undefined
+    };
+    // 5. 解析注册路径
+    var paths = resolveBotRegistrationPaths({
+        accountId: ctx.accountId,
+        matrixMode: matrixMode
+    });
+    // 6. 注册 Target（返回注销函数）
+    // 如果该账号之前已注册（例如 reload），先注销
+    var existingUnregister = accountUnregisters.get(ctx.accountId);
+    if (existingUnregister) {
+        existingUnregister();
+    }
+    var unregister = target_js_1.registerWecomWebhookTarget(target, paths);
+    accountUnregisters.set(ctx.accountId, unregister);
+    log.info("[webhook] Webhook Target \u5DF2\u6CE8\u518C (accountId=" + ctx.accountId + ", paths=[" + paths.join(", ") + "])");
+    // 7. 更新状态
+    (_d = ctx.setStatus) === null || _d === void 0 ? void 0 : _d.call(ctx, {
+        accountId: ctx.accountId,
+        running: true,
+        configured: true,
+        webhookPath: paths[0],
+        lastStartAt: Date.now()
+    });
+}
+exports.startWebhookGateway = startWebhookGateway;
+/**
+ * 停止 Webhook Gateway
+ *
+ * 1. 注销该账号的 Target（不影响其他账号）
+ * 2. 如果没有任何活跃 Target，停止清理定时器
+ */
+function stopWebhookGateway(ctx) {
+    var _a, _b;
+    var log = (_a = ctx.log) !== null && _a !== void 0 ? _a : {
+        info: function (msg) { return ctx.runtime.log(msg); },
+        error: function (msg) { return ctx.runtime.error(msg); }
+    };
+    log.info("[webhook] \u505C\u6B62 Webhook Gateway (accountId=" + ctx.accountId + ")");
+    // 1. 注销该账号的 Target
+    var unregister = accountUnregisters.get(ctx.accountId);
+    if (unregister) {
+        unregister();
+        accountUnregisters["delete"](ctx.accountId);
+    }
+    // 2. 如果没有任何活跃 Target，停止 pruneTimer
+    if (!target_js_1.hasActiveTargets()) {
+        state_js_1.monitorState.stopPruning();
+    }
+    // 3. 更新状态
+    (_b = ctx.setStatus) === null || _b === void 0 ? void 0 : _b.call(ctx, {
+        accountId: ctx.accountId,
+        running: false,
+        lastStopAt: Date.now()
+    });
+}
+exports.stopWebhookGateway = stopWebhookGateway;
+// ============================================================================
+// flushPending 中间层（对齐原版 monitor.ts:1151-1192）
+// ============================================================================
+/**
+ * **flushPending (刷新待处理消息 / 核心 Agent 触发点)**
+ *
+ * 当防抖计时器结束时被调用。
+ * 核心逻辑：
+ * 1. 聚合所有 pending 的消息内容（用于上下文）。
+ * 2. 获取 PluginRuntime。
+ * 3. 标记 Stream 为 Started。
+ * 4. 调用 `startAgentForStream` 启动 Agent 流程。
+ * 5. 处理异常并更新 Stream 状态为 Error。
+ */
+function flushPending(pending) {
+    var _a, _b, _c, _d, _e, _f;
+    return __awaiter(this, void 0, void 0, function () {
+        var streamId, target, msg, contents, msgids, conversationKey, batchKey, streamStore, mergedContents, core, enrichedTarget;
+        return __generator(this, function (_g) {
+            streamId = pending.streamId, target = pending.target, msg = pending.msg, contents = pending.contents, msgids = pending.msgids, conversationKey = pending.conversationKey, batchKey = pending.batchKey;
+            streamStore = state_js_1.monitorState.streamStore;
+            mergedContents = contents.filter(function (c) { return c.trim(); }).join("\n").trim();
+            core = null;
+            try {
+                core = runtime_js_1.getWeComRuntime();
+            }
+            catch (err) {
+                (_b = (_a = target.runtime).log) === null || _b === void 0 ? void 0 : _b.call(_a, "[webhook] flush pending: runtime not ready: " + String(err));
+                streamStore.markFinished(streamId);
+                (_d = (_c = target.runtime).log) === null || _d === void 0 ? void 0 : _d.call(_c, "[webhook] queue: runtime not ready\uFF0C\u7ED3\u675F\u6279\u6B21\u5E76\u63A8\u8FDB streamId=" + streamId);
+                streamStore.onStreamFinished(streamId);
+                return [2 /*return*/];
+            }
+            if (core) {
+                streamStore.markStarted(streamId);
+                enrichedTarget = __assign(__assign({}, target), { core: core });
+                (_f = (_e = target.runtime).log) === null || _f === void 0 ? void 0 : _f.call(_e, "[webhook] flush pending: start batch streamId=" + streamId + " batchKey=" + batchKey + " conversationKey=" + conversationKey + " mergedCount=" + contents.length);
+                // Pass the first msg (with its media structure), and mergedContents for multi-message context
+                monitor_js_1.startAgentForStream({
+                    target: enrichedTarget,
+                    accountId: target.account.accountId,
+                    msg: msg,
+                    streamId: streamId,
+                    mergedContents: contents.length > 1 ? mergedContents : undefined,
+                    mergedMsgids: msgids.length > 1 ? msgids : undefined
+                })["catch"](function (err) {
+                    var _a, _b;
+                    streamStore.updateStream(streamId, function (state) {
+                        state.error = err instanceof Error ? err.message : String(err);
+                        state.content = state.content || "Error: " + state.error;
+                        state.finished = true;
+                    });
+                    (_b = (_a = target.runtime).error) === null || _b === void 0 ? void 0 : _b.call(_a, "[webhook] Agent \u5904\u7406\u5931\u8D25 (streamId=" + streamId + "): " + String(err));
+                    streamStore.onStreamFinished(streamId);
+                });
+            }
+            return [2 /*return*/];
+        });
+    });
+}

package/dist/src/webhook/handler.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Webhook HTTP 请求处理
+ *
+ * 从 @mocrane/wecom monitor.ts handleWecomWebhookRequest 部分迁移 + 重构。
+ * 负责：
+ * 1. GET/POST 请求分流
+ * 2. 签名验证（调用 crypto 模块）
+ * 3. 消息解密
+ * 4. 按消息类型分发到 monitor 层
+ */
+/// <reference types="node" />
+import type { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * Webhook HTTP 请求总入口
+ *
+ * 处理企微 Bot Webhook 的 GET（URL 验证）和 POST（消息回调）请求。
+ * 返回 true 表示已处理，false 表示不匹配（交给其他 handler）。
+ */
+export declare function handleWecomWebhookRequest(req: IncomingMessage, res: ServerResponse): Promise<boolean>;