ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/mcp/tool.js

@@ -0,0 +1,318 @@
+"use strict";
+/**
+ * wecom_mcp — 模拟 MCP 调用的 Agent Tool
+ *
+ * 通过 MCP Streamable HTTP 传输协议调用企业微信 MCP Server，
+ * 提供 list（列出所有工具）和 call（调用工具）两个操作。
+ *
+ * 在 skills 中的使用方式：
+ *   wecom_mcp list <category>
+ *   wecom_mcp call <category> <method> '<jsonArgs>'
+ *
+ * 示例：
+ *   wecom_mcp list contact
+ *   wecom_mcp call contact getContact '{}'
+ */
+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.createWeComMcpTool = void 0;
+var transport_js_1 = require("./transport.js");
+var schema_js_1 = require("./schema.js");
+var index_js_1 = require("./interceptors/index.js");
+// ============================================================================
+// 响应构造辅助
+// ============================================================================
+/** 构造统一的文本响应结构 */
+var textResult = function (data) { return ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    details: data
+}); };
+var normalizeOptionalString = function (value) {
+    var trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    return trimmed ? trimmed : undefined;
+};
+/** 构造错误响应 */
+var errorResult = function (err) {
+    // 适配企业微信 API 返回的 { errcode, errmsg } 结构
+    if (err && typeof err === "object" && "errcode" in err) {
+        var _a = err, errcode = _a.errcode, errmsg = _a.errmsg;
+        return textResult({ error: errmsg !== null && errmsg !== void 0 ? errmsg : "\u9519\u8BEF\u7801: " + errcode, errcode: errcode });
+    }
+    var message = err instanceof Error ? err.message : String(err);
+    return textResult({ error: message });
+};
+// ============================================================================
+// list 操作：列出某品类的所有 MCP 工具
+// ============================================================================
+var handleList = function (ctx) { return __awaiter(void 0, void 0, void 0, function () {
+    var result, tools;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0: return [4 /*yield*/, transport_js_1.sendJsonRpc(ctx.category, "tools/list", undefined, {
+                    requesterUserId: ctx.requesterUserId,
+                    accountId: ctx.accountId
+                })];
+            case 1:
+                result = _b.sent();
+                tools = (_a = result === null || result === void 0 ? void 0 : result.tools) !== null && _a !== void 0 ? _a : [];
+                if (tools.length === 0) {
+                    return [2 /*return*/, { message: "\u54C1\u7C7B \"" + ctx.category + "\" \u4E0B\u6682\u65E0\u53EF\u7528\u5DE5\u5177", tools: [] }];
+                }
+                return [2 /*return*/, {
+                        category: ctx.category,
+                        count: tools.length,
+                        tools: tools.map(function (t) {
+                            var _a;
+                            return ({
+                                name: t.name,
+                                description: (_a = t.description) !== null && _a !== void 0 ? _a : "",
+                                // 清洗 inputSchema，内联 $ref/$defs 引用并移除 Gemini 不支持的关键词，
+                                // 避免 Gemini 模型解析 function response 时报 400 错误
+                                inputSchema: t.inputSchema ? schema_js_1.cleanSchemaForGemini(t.inputSchema) : undefined
+                            });
+                        })
+                    }];
+        }
+    });
+}); };
+// ============================================================================
+// call 操作：调用某品类的某个 MCP 工具
+// ============================================================================
+var handleCall = function (ctx) { return __awaiter(void 0, void 0, void 0, function () {
+    var category, method, args, requesterUserId, accountId, callStart, _a, options, resolvedArgs, finalArgs, requestOptions, result, rpcDone, rpcMs, resultStr, finalResult, totalMs, interceptMs, finalStr;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                category = ctx.category, method = ctx.method, args = ctx.args, requesterUserId = ctx.requesterUserId, accountId = ctx.accountId;
+                callStart = performance.now();
+                console.log("[mcp] handleCall " + category + "/" + method + " \u5165\u53C2: " + JSON.stringify(args));
+                return [4 /*yield*/, index_js_1.resolveBeforeCall(ctx)];
+            case 1:
+                _a = _b.sent(), options = _a.options, resolvedArgs = _a.args;
+                finalArgs = resolvedArgs !== null && resolvedArgs !== void 0 ? resolvedArgs : args;
+                requestOptions = __assign(__assign(__assign({}, options), (requesterUserId ? { requesterUserId: requesterUserId } : {})), (accountId ? { accountId: accountId } : {}));
+                if (resolvedArgs) {
+                    console.log("[mcp] handleCall " + category + "/" + method + " \u62E6\u622A\u5668\u66FF\u6362 args: " + JSON.stringify(resolvedArgs).slice(0, 500) +
+                        (JSON.stringify(resolvedArgs).length > 500 ? "...(truncated)" : ""));
+                }
+                if (options) {
+                    console.log("[mcp] handleCall " + category + "/" + method + " \u62E6\u622A\u5668\u9009\u9879: " + JSON.stringify(options));
+                }
+                return [4 /*yield*/, transport_js_1.sendJsonRpc(category, "tools/call", {
+                        name: method,
+                        arguments: finalArgs
+                    }, requestOptions)];
+            case 2:
+                result = _b.sent();
+                rpcDone = performance.now();
+                rpcMs = (rpcDone - callStart).toFixed(1);
+                resultStr = JSON.stringify(result);
+                console.log("[mcp] handleCall " + category + "/" + method + " MCP \u54CD\u5E94 (" + rpcMs + "ms): " + resultStr.slice(0, 800) +
+                    (resultStr.length > 800 ? "...(truncated)" : ""));
+                return [4 /*yield*/, index_js_1.runAfterCall(ctx, result)];
+            case 3:
+                finalResult = _b.sent();
+                totalMs = (performance.now() - callStart).toFixed(1);
+                interceptMs = (performance.now() - rpcDone).toFixed(1);
+                // 有拦截器处理时打印详细耗时，否则只打印 RPC 耗时
+                if (finalResult !== result) {
+                    finalStr = JSON.stringify(finalResult);
+                    console.log("[mcp] handleCall " + category + "/" + method + " afterCall \u53D8\u6362\u540E (" + interceptMs + "ms): " + finalStr.slice(0, 500) +
+                        (finalStr.length > 500 ? "...(truncated)" : ""));
+                    console.log("[mcp] handleCall " + category + "/" + method + " \u603B\u8017\u65F6: " + totalMs + "ms" +
+                        (" (MCP\u8BF7\u6C42: " + rpcMs + "ms, \u62E6\u622A\u5904\u7406: " + interceptMs + "ms)"));
+                }
+                else {
+                    console.log("[mcp] handleCall " + category + "/" + method + " \u8017\u65F6: " + rpcMs + "ms");
+                }
+                return [2 /*return*/, finalResult];
+        }
+    });
+}); };
+// ============================================================================
+// 参数解析
+// ============================================================================
+/**
+ * 解析 args 参数：支持 JSON 字符串或直接的对象
+ */
+var parseArgs = function (args) {
+    if (!args)
+        return {};
+    if (typeof args === "object")
+        return args;
+    try {
+        return JSON.parse(args);
+    }
+    catch (err) {
+        var detail = err instanceof SyntaxError ? err.message : String(err);
+        throw new Error("args \u53C2\u6570\u4E0D\u662F\u5408\u6CD5\u7684 JSON: " + args + " (" + detail + ")");
+    }
+};
+// ============================================================================
+// 工具定义 & 导出
+// ============================================================================
+/**
+ * 创建 wecom_mcp Agent Tool 定义
+ */
+function createWeComMcpTool(options) {
+    if (options === void 0) { options = {}; }
+    var requesterUserId = normalizeOptionalString(options.requesterUserId);
+    var accountId = normalizeOptionalString(options.accountId);
+    var chatId = normalizeOptionalString(options.chatId);
+    var chatType = options.chatType;
+    return {
+        name: "wecom_mcp",
+        label: "企业微信 MCP 工具",
+        description: [
+            "通过 HTTP 直接调用企业微信 MCP Server。",
+            "支持两种操作：",
+            "  - list: 列出指定品类的所有 MCP 工具",
+            "  - call: 调用指定品类的某个 MCP 工具",
+            "",
+            "使用方式：",
+            "  wecom_mcp list <category>",
+            "  wecom_mcp call <category> <method> '<jsonArgs>'",
+            "",
+            "示例：",
+            "  列出 contact 品类所有工具：wecom_mcp list contact",
+            "  调用 contact 的 getContact：wecom_mcp call contact getContact '{}'",
+        ].join("\n"),
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    "enum": ["list", "call"],
+                    description: "操作类型：list（列出工具）或 call（调用工具）"
+                },
+                category: {
+                    type: "string",
+                    description: "MCP 品类名称，如 doc、contact 等，对应 mcpConfig 中的 key"
+                },
+                method: {
+                    type: "string",
+                    description: "要调用的 MCP 方法名（action=call 时必填）"
+                },
+                args: {
+                    type: ["string", "object"],
+                    description: "调用 MCP 方法的参数，可以是 JSON 字符串或对象（action=call 时使用，默认 {}）"
+                }
+            },
+            required: ["action", "category"]
+        },
+        execute: function (_toolCallId, params) {
+            var _a;
+            return __awaiter(this, void 0, void 0, function () {
+                var p, result, ctx, _b, _c, _d, err_1;
+                return __generator(this, function (_e) {
+                    switch (_e.label) {
+                        case 0:
+                            p = params;
+                            console.log("[mcp] execute: action=" + p.action + ", category=" + p.category +
+                                (p.method ? ", method=" + p.method : "") +
+                                (p.args ? ", args=" + (typeof p.args === "string" ? p.args : JSON.stringify(p.args)) : ""));
+                            _e.label = 1;
+                        case 1:
+                            _e.trys.push([1, 8, , 9]);
+                            result = void 0;
+                            ctx = {
+                                category: p.category,
+                                method: (_a = p.method) !== null && _a !== void 0 ? _a : "",
+                                args: {},
+                                requesterUserId: requesterUserId,
+                                accountId: accountId,
+                                chatId: chatId,
+                                chatType: chatType
+                            };
+                            _b = p.action;
+                            switch (_b) {
+                                case "list": return [3 /*break*/, 2];
+                                case "call": return [3 /*break*/, 4];
+                            }
+                            return [3 /*break*/, 6];
+                        case 2:
+                            _c = textResult;
+                            return [4 /*yield*/, handleList(ctx)];
+                        case 3:
+                            result = _c.apply(void 0, [_e.sent()]);
+                            return [3 /*break*/, 7];
+                        case 4:
+                            if (!p.method) {
+                                result = textResult({ error: "action 为 call 时必须提供 method 参数" });
+                                return [3 /*break*/, 7];
+                            }
+                            ctx.args = parseArgs(p.args);
+                            _d = textResult;
+                            return [4 /*yield*/, handleCall(ctx)];
+                        case 5:
+                            result = _d.apply(void 0, [_e.sent()]);
+                            return [3 /*break*/, 7];
+                        case 6:
+                            result = textResult({ error: "\u672A\u77E5\u64CD\u4F5C\u7C7B\u578B: " + String(p.action) + "\uFF0C\u652F\u6301 list \u548C call" });
+                            _e.label = 7;
+                        case 7:
+                            console.log("[mcp] execute: action=" + p.action + ", category=" + p.category +
+                                (p.method ? ", method=" + p.method : "") +
+                                (" \u2192 \u54CD\u5E94\u957F\u5EA6=" + result.content[0].text.length + " chars"));
+                            return [2 /*return*/, result];
+                        case 8:
+                            err_1 = _e.sent();
+                            console.error("[mcp] execute: action=" + p.action + ", category=" + p.category +
+                                (p.method ? ", method=" + p.method : "") +
+                                (" \u2192 \u5F02\u5E38: " + (err_1 instanceof Error ? err_1.message : JSON.stringify(err_1))));
+                            return [2 /*return*/, errorResult(err_1)];
+                        case 9: return [2 /*return*/];
+                    }
+                });
+            });
+        }
+    };
+}
+exports.createWeComMcpTool = createWeComMcpTool;

package/dist/src/mcp/transport.d.ts

@@ -0,0 +1,94 @@
+/**
+ * MCP Streamable HTTP 传输层模块
+ *
+ * 负责:
+ * - MCP JSON-RPC over HTTP 通信（发送请求、解析响应）
+ * - Streamable HTTP session 生命周期管理（initialize 握手 → Mcp-Session-Id 维护 → 失效重建）
+ * - 自动检测无状态 Server：如果 initialize 响应未返回 Mcp-Session-Id，
+ *   则标记为无状态模式，后续请求跳过握手和 session 管理
+ * - SSE 流式响应解析
+ * - MCP 配置运行时缓存（通过 WSClient 拉取 URL 并缓存在内存中）
+ */
+/** 媒体下载请求超时时间（毫秒），base64 编码的媒体文件最大可达 ~27MB */
+export declare const MEDIA_DOWNLOAD_TIMEOUT_MS = 120000;
+/** 请求 MCP Server 时透传可信企业微信 userid 的 header 名 */
+export declare const WECOM_USERID_HEADER = "x-openclaw-wecom-userid";
+/**
+ * MCP JSON-RPC 错误
+ *
+ * 携带服务端返回的 JSON-RPC error.code，
+ * 用于上层按错误码进行差异化处理（如特定错误码触发缓存清理）。
+ */
+export declare class McpRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/**
+ * MCP HTTP 错误
+ *
+ * 携带 HTTP 状态码，用于精确判断 session 失效（404）等场景，
+ * 避免通过字符串匹配 "404" 导致的误判。
+ */
+export declare class McpHttpError extends Error {
+    readonly statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+/**
+ * 根据配置解析当前用于 MCP 的账户 ID
+ *
+ * 通过 PluginRuntime 读取全局配置，按以下优先级选择账户：
+ * 1. 默认账户（如果配置了 botId + secret）
+ * 2. 第一个配置了 botId + secret 的长连接账户
+ * 3. 无可用长连接账户时回退到默认账户（会导致后续 WSClient 获取失败）
+ */
+export declare function resolveCurrentAccountId(): string;
+/**
+ * 清理指定账户+品类的所有 MCP 缓存（配置、会话、无状态标记）
+ *
+ * 当 MCP Server 返回特定错误码时调用，确保下次请求重新拉取配置并重建会话。
+ *
+ * @param accountId - 账户 ID
+ * @param category - MCP 品类名称
+ */
+export declare function clearCategoryCache(accountId: string, category: string): void;
+/**
+ * 清理指定账户下所有品类的 MCP 缓存
+ *
+ * 适用于账户掉线、凭据变更等需要整体清理的场景。
+ *
+ * @param accountId - 账户 ID
+ */
+export declare function clearAccountCache(accountId: string): void;
+/** tools/list 返回的工具描述 */
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/** sendJsonRpc 的可选配置 */
+export interface SendJsonRpcOptions {
+    /** 自定义 HTTP 请求超时时间（毫秒），默认使用 HTTP_REQUEST_TIMEOUT_MS */
+    timeoutMs?: number;
+    /** 当前会话可信的企业微信 userid，有值时会注入自定义 header */
+    requesterUserId?: string;
+    /** 指定使用的账户 ID，有值时优先使用，否则 fallback 到 resolveCurrentAccountId() */
+    accountId?: string;
+}
+/**
+ * 发送 JSON-RPC 请求到 MCP Server（Streamable HTTP 协议）
+ *
+ * 自动管理 session 生命周期：
+ * - 无状态 Server：跳过 session 管理，直接发送请求
+ * - 有状态 Server：首次调用先执行 initialize 握手，session 失效（404）时自动重建并重试
+ *
+ * accountId 优先使用 options.accountId（由工具工厂从 ctx.agentAccountId 传入），
+ * 未提供时 fallback 到 resolveCurrentAccountId()。解析结果贯穿整条调用链，避免跨账号污染。
+ *
+ * @param category - MCP 品类名称
+ * @param method - JSON-RPC 方法名
+ * @param params - JSON-RPC 参数
+ * @param options - 可选配置（如自定义超时、指定账户）
+ * @returns JSON-RPC result
+ */
+export declare function sendJsonRpc(category: string, method: string, params?: Record<string, unknown>, options?: SendJsonRpcOptions): Promise<unknown>;