@wecom/wecom-openclaw-plugin 2026.7.2 → 2026.8.17

package/dist/src/mcp/schema.js

@@ -1,99 +0,0 @@
-/**
- * MCP Schema 清洗模块
- *
- * 负责内联 $ref/$defs 引用并移除 Gemini 不支持的 JSON Schema 关键词，
- * 防止 Gemini 模型解析 function response 时报 400 错误。
- */
-/** Gemini 不支持的 JSON Schema 关键词 */
-const GEMINI_UNSUPPORTED_KEYWORDS = new Set([
-    "patternProperties", "additionalProperties", "$schema", "$id", "$ref", "$defs",
-    "definitions", "examples", "minLength", "maxLength", "minimum", "maximum",
-    "multipleOf", "pattern", "format", "minItems", "maxItems", "uniqueItems",
-    "minProperties", "maxProperties",
-]);
-/**
- * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，
- * 防止 Gemini 模型解析 function response 时报 400 错误。
- */
-export function cleanSchemaForGemini(schema) {
-    if (!schema || typeof schema !== "object")
-        return schema;
-    if (Array.isArray(schema))
-        return schema.map(cleanSchemaForGemini);
-    const obj = schema;
-    // 收集 $defs/definitions 用于后续 $ref 内联解析
-    const defs = {
-        ...(obj.$defs && typeof obj.$defs === "object" ? obj.$defs : {}),
-        ...(obj.definitions && typeof obj.definitions === "object" ? obj.definitions : {}),
-    };
-    return cleanWithDefs(obj, defs, new Set());
-}
-function cleanWithDefs(schema, defs, refStack) {
-    if (!schema || typeof schema !== "object")
-        return schema;
-    if (Array.isArray(schema))
-        return schema.map((item) => cleanWithDefs(item, defs, refStack));
-    const obj = schema;
-    // 合并当前层级的 $defs/definitions 到 defs 中
-    if (obj.$defs && typeof obj.$defs === "object") {
-        Object.assign(defs, obj.$defs);
-    }
-    if (obj.definitions && typeof obj.definitions === "object") {
-        Object.assign(defs, obj.definitions);
-    }
-    // 处理 $ref 引用：尝试内联解析
-    if (typeof obj.$ref === "string") {
-        const ref = obj.$ref;
-        if (refStack.has(ref))
-            return {}; // 防止循环引用
-        const match = ref.match(/^#\/(?:\$defs|definitions)\/(.+)$/);
-        if (match && match[1] && defs[match[1]]) {
-            const nextStack = new Set(refStack);
-            nextStack.add(ref);
-            return cleanWithDefs(defs[match[1]], defs, nextStack);
-        }
-        return {}; // 无法解析的 $ref，返回空对象
-    }
-    const cleaned = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (GEMINI_UNSUPPORTED_KEYWORDS.has(key))
-            continue;
-        if (key === "const") {
-            cleaned.enum = [value];
-            continue;
-        }
-        if (key === "properties" && value && typeof value === "object" && !Array.isArray(value)) {
-            cleaned[key] = Object.fromEntries(Object.entries(value).map(([k, v]) => [
-                k, cleanWithDefs(v, defs, refStack),
-            ]));
-        }
-        else if (key === "items" && value) {
-            cleaned[key] = Array.isArray(value)
-                ? value.map((item) => cleanWithDefs(item, defs, refStack))
-                : cleanWithDefs(value, defs, refStack);
-        }
-        else if ((key === "anyOf" || key === "oneOf" || key === "allOf") && Array.isArray(value)) {
-            // 过滤掉 null 类型的变体
-            const nonNull = value.filter((v) => {
-                if (!v || typeof v !== "object")
-                    return true;
-                const r = v;
-                return r.type !== "null";
-            });
-            if (nonNull.length === 1) {
-                // 只剩一个变体时直接内联
-                const single = cleanWithDefs(nonNull[0], defs, refStack);
-                if (single && typeof single === "object" && !Array.isArray(single)) {
-                    Object.assign(cleaned, single);
-                }
-            }
-            else {
-                cleaned[key] = nonNull.map((v) => cleanWithDefs(v, defs, refStack));
-            }
-        }
-        else {
-            cleaned[key] = value;
-        }
-    }
-    return cleaned;
-}

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

@@ -1,63 +0,0 @@
-/**
- * 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 '{}'
- */
-interface CreateWeComMcpToolOptions {
-    /** 当前会话可信的企业微信 userid */
-    requesterUserId?: string;
-    /** 当前会话对应的账户 ID（来自 ctx.agentAccountId） */
-    accountId?: string;
-    /** 当前会话的 chatId（群组 ID 或用户 ID），用于 aibot_send_biz_msg 等命令 */
-    chatId?: string;
-    /** 当前会话的聊天类型：single（单聊）或 group（群聊） */
-    chatType?: "single" | "group";
-}
-/**
- * 创建 wecom_mcp Agent Tool 定义
- */
-export declare function createWeComMcpTool(options?: CreateWeComMcpToolOptions): {
-    name: string;
-    label: string;
-    description: string;
-    parameters: {
-        type: "object";
-        properties: {
-            action: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            category: {
-                type: string;
-                description: string;
-            };
-            method: {
-                type: string;
-                description: string;
-            };
-            args: {
-                type: string[];
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    execute(_toolCallId: string, params: unknown): Promise<{
-        content: {
-            type: "text";
-            text: string;
-        }[];
-        details: unknown;
-    }>;
-};
-export {};

package/dist/src/mcp/tool.js

@@ -1,224 +0,0 @@
-/**
- * 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 '{}'
- */
-import { sendJsonRpc } from "./transport.js";
-import { cleanSchemaForGemini } from "./schema.js";
-import { resolveBeforeCall, runAfterCall } from "./interceptors/index.js";
-// ============================================================================
-// 响应构造辅助
-// ============================================================================
-/** 构造统一的文本响应结构 */
-const textResult = (data) => ({
-    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-    details: data,
-});
-const normalizeOptionalString = (value) => {
-    const trimmed = value?.trim();
-    return trimmed ? trimmed : undefined;
-};
-/** 构造错误响应 */
-const errorResult = (err) => {
-    // 适配企业微信 API 返回的 { errcode, errmsg } 结构
-    if (err && typeof err === "object" && "errcode" in err) {
-        const { errcode, errmsg } = err;
-        return textResult({ error: errmsg ?? `错误码: ${errcode}`, errcode });
-    }
-    const message = err instanceof Error ? err.message : String(err);
-    return textResult({ error: message });
-};
-// ============================================================================
-// list 操作：列出某品类的所有 MCP 工具
-// ============================================================================
-const handleList = async (ctx) => {
-    const result = await sendJsonRpc(ctx.category, "tools/list", undefined, {
-        requesterUserId: ctx.requesterUserId,
-        accountId: ctx.accountId,
-    });
-    const tools = result?.tools ?? [];
-    if (tools.length === 0) {
-        return { message: `品类 "${ctx.category}" 下暂无可用工具`, tools: [] };
-    }
-    return {
-        category: ctx.category,
-        count: tools.length,
-        tools: tools.map((t) => ({
-            name: t.name,
-            description: t.description ?? "",
-            // 清洗 inputSchema，内联 $ref/$defs 引用并移除 Gemini 不支持的关键词，
-            // 避免 Gemini 模型解析 function response 时报 400 错误
-            inputSchema: t.inputSchema ? cleanSchemaForGemini(t.inputSchema) : undefined,
-        })),
-    };
-};
-// ============================================================================
-// call 操作：调用某品类的某个 MCP 工具
-// ============================================================================
-const handleCall = async (ctx) => {
-    const { category, method, args, requesterUserId, accountId } = ctx;
-    const callStart = performance.now();
-    console.log(`[mcp] handleCall ${category}/${method} 入参: ${JSON.stringify(args)}`);
-    // 1. 收集拦截器的 beforeCall 配置（如超时时间、替换 args）
-    const { options, args: resolvedArgs } = await resolveBeforeCall(ctx);
-    const finalArgs = resolvedArgs ?? args;
-    const requestOptions = { ...options, ...(requesterUserId ? { requesterUserId } : {}), ...(accountId ? { accountId } : {}) };
-    if (resolvedArgs) {
-        console.log(`[mcp] handleCall ${category}/${method} 拦截器替换 args: ${JSON.stringify(resolvedArgs).slice(0, 500)}` +
-            (JSON.stringify(resolvedArgs).length > 500 ? "...(truncated)" : ""));
-    }
-    if (options) {
-        console.log(`[mcp] handleCall ${category}/${method} 拦截器选项: ${JSON.stringify(options)}`);
-    }
-    // 2. 执行 MCP 调用
-    const result = await sendJsonRpc(category, "tools/call", {
-        name: method,
-        arguments: finalArgs,
-    }, requestOptions);
-    const rpcDone = performance.now();
-    const rpcMs = (rpcDone - callStart).toFixed(1);
-    const resultStr = JSON.stringify(result);
-    console.log(`[mcp] handleCall ${category}/${method} MCP 响应 (${rpcMs}ms): ${resultStr.slice(0, 800)}` +
-        (resultStr.length > 800 ? "...(truncated)" : ""));
-    // 3. 管道式执行 afterCall 拦截器（业务错误码检查、响应变换等）
-    const finalResult = await runAfterCall(ctx, result);
-    const totalMs = (performance.now() - callStart).toFixed(1);
-    const interceptMs = (performance.now() - rpcDone).toFixed(1);
-    // 有拦截器处理时打印详细耗时，否则只打印 RPC 耗时
-    if (finalResult !== result) {
-        const finalStr = JSON.stringify(finalResult);
-        console.log(`[mcp] handleCall ${category}/${method} afterCall 变换后 (${interceptMs}ms): ${finalStr.slice(0, 500)}` +
-            (finalStr.length > 500 ? "...(truncated)" : ""));
-        console.log(`[mcp] handleCall ${category}/${method} 总耗时: ${totalMs}ms` +
-            ` (MCP请求: ${rpcMs}ms, 拦截处理: ${interceptMs}ms)`);
-    }
-    else {
-        console.log(`[mcp] handleCall ${category}/${method} 耗时: ${rpcMs}ms`);
-    }
-    return finalResult;
-};
-// ============================================================================
-// 参数解析
-// ============================================================================
-/**
- * 解析 args 参数：支持 JSON 字符串或直接的对象
- */
-const parseArgs = (args) => {
-    if (!args)
-        return {};
-    if (typeof args === "object")
-        return args;
-    try {
-        return JSON.parse(args);
-    }
-    catch (err) {
-        const detail = err instanceof SyntaxError ? err.message : String(err);
-        throw new Error(`args 参数不是合法的 JSON: ${args} (${detail})`);
-    }
-};
-// ============================================================================
-// 工具定义 & 导出
-// ============================================================================
-/**
- * 创建 wecom_mcp Agent Tool 定义
- */
-export function createWeComMcpTool(options = {}) {
-    const requesterUserId = normalizeOptionalString(options.requesterUserId);
-    const accountId = normalizeOptionalString(options.accountId);
-    const chatId = normalizeOptionalString(options.chatId);
-    const 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"],
-        },
-        async execute(_toolCallId, params) {
-            const 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)}` : ""));
-            try {
-                let result;
-                const ctx = {
-                    category: p.category,
-                    method: p.method ?? "",
-                    args: {},
-                    requesterUserId,
-                    accountId,
-                    chatId,
-                    chatType,
-                };
-                switch (p.action) {
-                    case "list":
-                        result = textResult(await handleList(ctx));
-                        break;
-                    case "call": {
-                        if (!p.method) {
-                            result = textResult({ error: "action 为 call 时必须提供 method 参数" });
-                            break;
-                        }
-                        ctx.args = parseArgs(p.args);
-                        result = textResult(await handleCall(ctx));
-                        break;
-                    }
-                    default:
-                        result = textResult({ error: `未知操作类型: ${String(p.action)}，支持 list 和 call` });
-                }
-                console.log(`[mcp] execute: action=${p.action}, category=${p.category}` +
-                    (p.method ? `, method=${p.method}` : "") +
-                    ` → 响应长度=${result.content[0].text.length} chars`);
-                return result;
-            }
-            catch (err) {
-                console.error(`[mcp] execute: action=${p.action}, category=${p.category}` +
-                    (p.method ? `, method=${p.method}` : "") +
-                    ` → 异常: ${err instanceof Error ? err.message : JSON.stringify(err)}`);
-                return errorResult(err);
-            }
-        },
-    };
-}

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

@@ -1,94 +0,0 @@
-/**
- * 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 | undefined;
-    constructor(code: number, message: string, data?: unknown | undefined);
-}
-/**
- * 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>;