@wecom/wecom-openclaw-plugin 2026.3.31-beta.0 → 2026.4.1-beta.1

package/dist/cjs/src/mcp/tool.js

@@ -0,0 +1,208 @@
+'use strict';
+
+var transport = require('./transport.js');
+var schema = require('./schema.js');
+var index = require('./interceptors/index.js');
+
+/**
+ * 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 '{}'
+ */
+// ============================================================================
+// 响应构造辅助
+// ============================================================================
+/** 构造统一的文本响应结构 */
+const textResult = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+/** 构造错误响应 */
+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 (category) => {
+    const result = await transport.sendJsonRpc(category, "tools/list");
+    const tools = result?.tools ?? [];
+    if (tools.length === 0) {
+        return { message: `品类 "${category}" 下暂无可用工具`, tools: [] };
+    }
+    return {
+        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 ? schema.cleanSchemaForGemini(t.inputSchema) : undefined,
+        })),
+    };
+};
+// ============================================================================
+// call 操作：调用某品类的某个 MCP 工具
+// ============================================================================
+const handleCall = async (category, method, args) => {
+    const ctx = { category, method, args };
+    const callStart = performance.now();
+    console.log(`[mcp] handleCall ${category}/${method} 入参: ${JSON.stringify(args)}`);
+    // 1. 收集拦截器的 beforeCall 配置（如超时时间、替换 args）
+    const { options, args: resolvedArgs } = await index.resolveBeforeCall(ctx);
+    const finalArgs = resolvedArgs ?? args;
+    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 transport.sendJsonRpc(category, "tools/call", {
+        name: method,
+        arguments: finalArgs,
+    }, options);
+    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 index.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 定义
+ */
+function createWeComMcpTool() {
+    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;
+                switch (p.action) {
+                    case "list":
+                        result = textResult(await handleList(p.category));
+                        break;
+                    case "call": {
+                        if (!p.method) {
+                            result = textResult({ error: "action 为 call 时必须提供 method 参数" });
+                            break;
+                        }
+                        const args = parseArgs(p.args);
+                        result = textResult(await handleCall(p.category, p.method, args));
+                        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 : String(err)}`);
+                return errorResult(err);
+            }
+        },
+    };
+}
+
+exports.createWeComMcpTool = createWeComMcpTool;
+//# sourceMappingURL=tool.js.map

package/dist/cjs/src/mcp/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sources":["../../../../../../src/mcp/tool.ts"],"sourcesContent":["/**\n * wecom_mcp — 模拟 MCP 调用的 Agent Tool\n *\n * 通过 MCP Streamable HTTP 传输协议调用企业微信 MCP Server，\n * 提供 list（列出所有工具）和 call（调用工具）两个操作。\n *\n * 在 skills 中的使用方式：\n *   wecom_mcp list <category>\n *   wecom_mcp call <category> <method> '<jsonArgs>'\n *\n * 示例：\n *   wecom_mcp list contact\n *   wecom_mcp call contact getContact '{}'\n */\n\nimport { sendJsonRpc, type McpToolInfo } from \"./transport.js\";\nimport { cleanSchemaForGemini } from \"./schema.js\";\nimport { resolveBeforeCall, runAfterCall } from \"./interceptors/index.js\";\n\n// ============================================================================\n// 类型定义\n// ============================================================================\n\n/** wecom_mcp 的入参 */\ninterface WeComToolsParams {\n  /** 操作类型：list | call */\n  action: \"list\" | \"call\";\n  /** MCP 品类，对应 mcpConfig 中的 key，如 doc、contact */\n  category: string;\n  /** 调用的 MCP 方法名（action=call 时必填） */\n  method?: string;\n  /** 调用 MCP 方法的 JSON 参数（action=call 时使用） */\n  args?: string | Record<string, unknown>;\n}\n\n// ============================================================================\n// 响应构造辅助\n// ============================================================================\n\n/** 构造统一的文本响应结构 */\nconst textResult = (data: unknown) => ({\n  content: [{ type: \"text\" as const, text: JSON.stringify(data, null, 2) }],\n});\n\n/** 构造错误响应 */\nconst errorResult = (err: unknown) => {\n  // 适配企业微信 API 返回的 { errcode, errmsg } 结构\n  if (err && typeof err === \"object\" && \"errcode\" in err) {\n    const { errcode, errmsg } = err as { errcode: number; errmsg?: string };\n    return textResult({ error: errmsg ?? `错误码: ${errcode}`, errcode });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  return textResult({ error: message });\n};\n\n// ============================================================================\n// list 操作：列出某品类的所有 MCP 工具\n// ============================================================================\n\nconst handleList = async (category: string): Promise<unknown> => {\n  const result = await sendJsonRpc(category, \"tools/list\") as { tools?: McpToolInfo[] } | undefined;\n\n  const tools = result?.tools ?? [];\n  if (tools.length === 0) {\n    return { message: `品类 \"${category}\" 下暂无可用工具`, tools: [] };\n  }\n\n  return {\n    category,\n    count: tools.length,\n    tools: tools.map((t) => ({\n      name: t.name,\n      description: t.description ?? \"\",\n      // 清洗 inputSchema，内联 $ref/$defs 引用并移除 Gemini 不支持的关键词，\n      // 避免 Gemini 模型解析 function response 时报 400 错误\n      inputSchema: t.inputSchema ? cleanSchemaForGemini(t.inputSchema) : undefined,\n    })),\n  };\n};\n\n// ============================================================================\n// call 操作：调用某品类的某个 MCP 工具\n// ============================================================================\n\nconst handleCall = async (\n  category: string,\n  method: string,\n  args: Record<string, unknown>,\n): Promise<unknown> => {\n  const ctx = { category, method, args };\n  const callStart = performance.now();\n\n  console.log(`[mcp] handleCall ${category}/${method} 入参: ${JSON.stringify(args)}`);\n\n  // 1. 收集拦截器的 beforeCall 配置（如超时时间、替换 args）\n  const { options, args: resolvedArgs } = await resolveBeforeCall(ctx);\n  const finalArgs = resolvedArgs ?? args;\n\n  if (resolvedArgs) {\n    console.log(\n      `[mcp] handleCall ${category}/${method} 拦截器替换 args: ${JSON.stringify(resolvedArgs).slice(0, 500)}` +\n      (JSON.stringify(resolvedArgs).length > 500 ? \"...(truncated)\" : \"\"),\n    );\n  }\n  if (options) {\n    console.log(`[mcp] handleCall ${category}/${method} 拦截器选项: ${JSON.stringify(options)}`);\n  }\n\n  // 2. 执行 MCP 调用\n  const result = await sendJsonRpc(category, \"tools/call\", {\n    name: method,\n    arguments: finalArgs,\n  }, options);\n\n  const rpcDone = performance.now();\n  const rpcMs = (rpcDone - callStart).toFixed(1);\n\n  const resultStr = JSON.stringify(result);\n  console.log(\n    `[mcp] handleCall ${category}/${method} MCP 响应 (${rpcMs}ms): ${resultStr.slice(0, 800)}` +\n    (resultStr.length > 800 ? \"...(truncated)\" : \"\"),\n  );\n\n  // 3. 管道式执行 afterCall 拦截器（业务错误码检查、响应变换等）\n  const finalResult = await runAfterCall(ctx, result);\n\n  const totalMs = (performance.now() - callStart).toFixed(1);\n  const interceptMs = (performance.now() - rpcDone).toFixed(1);\n\n  // 有拦截器处理时打印详细耗时，否则只打印 RPC 耗时\n  if (finalResult !== result) {\n    const finalStr = JSON.stringify(finalResult);\n    console.log(\n      `[mcp] handleCall ${category}/${method} afterCall 变换后 (${interceptMs}ms): ${finalStr.slice(0, 500)}` +\n      (finalStr.length > 500 ? \"...(truncated)\" : \"\"),\n    );\n    console.log(\n      `[mcp] handleCall ${category}/${method} 总耗时: ${totalMs}ms` +\n      ` (MCP请求: ${rpcMs}ms, 拦截处理: ${interceptMs}ms)`,\n    );\n  } else {\n    console.log(`[mcp] handleCall ${category}/${method} 耗时: ${rpcMs}ms`);\n  }\n\n  return finalResult;\n};\n\n// ============================================================================\n// 参数解析\n// ============================================================================\n\n/**\n * 解析 args 参数：支持 JSON 字符串或直接的对象\n */\nconst parseArgs = (args: string | Record<string, unknown> | undefined): Record<string, unknown> => {\n  if (!args) return {};\n  if (typeof args === \"object\") return args;\n  try {\n    return JSON.parse(args) as Record<string, unknown>;\n  } catch (err) {\n    const detail = err instanceof SyntaxError ? err.message : String(err);\n    throw new Error(`args 参数不是合法的 JSON: ${args} (${detail})`);\n  }\n};\n\n// ============================================================================\n// 工具定义 & 导出\n// ============================================================================\n\n/**\n * 创建 wecom_mcp Agent Tool 定义\n */\nexport function createWeComMcpTool() {\n  return {\n    name: \"wecom_mcp\",\n    label: \"企业微信 MCP 工具\",\n    description: [\n      \"通过 HTTP 直接调用企业微信 MCP Server。\",\n      \"支持两种操作：\",\n      \"  - list: 列出指定品类的所有 MCP 工具\",\n      \"  - call: 调用指定品类的某个 MCP 工具\",\n      \"\",\n      \"使用方式：\",\n      \"  wecom_mcp list <category>\",\n      \"  wecom_mcp call <category> <method> '<jsonArgs>'\",\n      \"\",\n      \"示例：\",\n      \"  列出 contact 品类所有工具：wecom_mcp list contact\",\n      \"  调用 contact 的 getContact：wecom_mcp call contact getContact '{}'\",\n    ].join(\"\\n\"),\n    parameters: {\n      type: \"object\" as const,\n      properties: {\n        action: {\n          type: \"string\",\n          enum: [\"list\", \"call\"],\n          description: \"操作类型：list（列出工具）或 call（调用工具）\",\n        },\n        category: {\n          type: \"string\",\n          description: \"MCP 品类名称，如 doc、contact 等，对应 mcpConfig 中的 key\",\n        },\n        method: {\n          type: \"string\",\n          description: \"要调用的 MCP 方法名（action=call 时必填）\",\n        },\n        args: {\n          type: [\"string\", \"object\"],\n          description: \"调用 MCP 方法的参数，可以是 JSON 字符串或对象（action=call 时使用，默认 {}）\",\n        },\n      },\n      required: [\"action\", \"category\"],\n    },\n    async execute(_toolCallId: string, params: unknown) {\n      const p = params as WeComToolsParams;\n      console.log(\n        `[mcp] execute: action=${p.action}, category=${p.category}` +\n        (p.method ? `, method=${p.method}` : \"\") +\n        (p.args ? `, args=${typeof p.args === \"string\" ? p.args : JSON.stringify(p.args)}` : \"\"),\n      );\n      try {\n        let result: ReturnType<typeof textResult>;\n        switch (p.action) {\n          case \"list\":\n            result = textResult(await handleList(p.category));\n            break;\n          case \"call\": {\n            if (!p.method) {\n              result = textResult({ error: \"action 为 call 时必须提供 method 参数\" });\n              break;\n            }\n            const args = parseArgs(p.args);\n            result = textResult(await handleCall(p.category, p.method, args));\n            break;\n          }\n          default:\n            result = textResult({ error: `未知操作类型: ${String(p.action)}，支持 list 和 call` });\n        }\n        console.log(\n          `[mcp] execute: action=${p.action}, category=${p.category}` +\n          (p.method ? `, method=${p.method}` : \"\") +\n          ` → 响应长度=${result.content[0].text.length} chars`,\n        );\n        return result;\n      } catch (err) {\n        console.error(\n          `[mcp] execute: action=${p.action}, category=${p.category}` +\n          (p.method ? `, method=${p.method}` : \"\") +\n          ` → 异常: ${err instanceof Error ? err.message : String(err)}`,\n        );\n        return errorResult(err);\n      }\n    },\n  };\n}\n"],"names":["sendJsonRpc","cleanSchemaForGemini","resolveBeforeCall","runAfterCall"],"mappings":"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"}

package/dist/cjs/src/mcp/transport.js

@@ -0,0 +1,417 @@
+'use strict';
+
+var aibotNodeSdk = require('@wecom/aibot-node-sdk');
+var openclawCompat = require('../openclaw-compat.js');
+var stateManager = require('../state-manager.js');
+var _const = require('../const.js');
+var timeout = require('../timeout.js');
+var version = require('../version.js');
+
+/**
+ * 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 并缓存在内存中）
+ */
+// ============================================================================
+// 内部状态
+// ============================================================================
+/** HTTP 请求超时时间（毫秒） */
+const HTTP_REQUEST_TIMEOUT_MS = 30000;
+/** 媒体下载请求超时时间（毫秒），base64 编码的媒体文件最大可达 ~27MB */
+const MEDIA_DOWNLOAD_TIMEOUT_MS = 120000;
+/** 日志前缀 */
+const LOG_TAG = "[mcp]";
+/**
+ * MCP JSON-RPC 错误
+ *
+ * 携带服务端返回的 JSON-RPC error.code，
+ * 用于上层按错误码进行差异化处理（如特定错误码触发缓存清理）。
+ */
+class McpRpcError extends Error {
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = "McpRpcError";
+    }
+}
+/**
+ * MCP HTTP 错误
+ *
+ * 携带 HTTP 状态码，用于精确判断 session 失效（404）等场景，
+ * 避免通过字符串匹配 "404" 导致的误判。
+ */
+class McpHttpError extends Error {
+    constructor(statusCode, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "McpHttpError";
+    }
+}
+/**
+ * 需要清理缓存的 JSON-RPC 错误码集合
+ *
+ * 当 MCP Server 返回以下错误码时，说明服务端状态已发生变化（如配置变更、
+ * 服务重启等），需要清理对应 category 的全部缓存，确保下次请求重新
+ * 拉取配置并重建会话。
+ *
+ * - -32001: 服务不可用（Server Unavailable）
+ * - -32002: 配置已变更（Config Changed）
+ * - -32003: 认证失败（Auth Failed）
+ */
+const CACHE_CLEAR_ERROR_CODES = new Set([-32001, -32002, -32003]);
+/** MCP 配置缓存：category → response.body（完整配置） */
+const mcpConfigCache = new Map();
+/** Streamable HTTP 会话缓存：category → session */
+const mcpSessionCache = new Map();
+/** 已确认为无状态的 MCP Server 品类集合（跳过后续握手） */
+const statelessCategories = new Set();
+/** 正在进行中的 initialize 请求（防止并发重复初始化），key 为 category */
+const inflightInitRequests = new Map();
+// ============================================================================
+// MCP 配置拉取与缓存
+// ============================================================================
+/**
+ * 通过 WSClient 拉取指定 category 的 MCP 完整配置
+ *
+ * @param category - MCP 品类名称，如 doc、contact
+ * @returns 完整的 response.body 配置对象（至少包含 url 字段）
+ */
+async function fetchMcpConfig(category) {
+    const wsClient = stateManager.getWeComWebSocket(openclawCompat.DEFAULT_ACCOUNT_ID);
+    if (!wsClient) {
+        throw new Error("WSClient 未连接，无法拉取 MCP 配置");
+    }
+    const reqId = aibotNodeSdk.generateReqId("mcp_config");
+    const response = await timeout.withTimeout(wsClient.reply({ headers: { req_id: reqId } }, { biz_type: category, plugin_version: version.PLUGIN_VERSION }, _const.MCP_GET_CONFIG_CMD), _const.MCP_CONFIG_FETCH_TIMEOUT_MS, `MCP config fetch for "${category}" timed out after ${_const.MCP_CONFIG_FETCH_TIMEOUT_MS}ms`);
+    if (response.errcode !== undefined && response.errcode !== 0) {
+        const errMsg = `MCP 配置请求失败: errcode=${response.errcode}, errmsg=${response.errmsg ?? "unknown"}`;
+        console.error(`${LOG_TAG} ${errMsg}`);
+        throw new Error(errMsg);
+    }
+    const body = response.body;
+    if (!body?.url) {
+        throw new Error(`MCP 配置响应缺少 url 字段 (category="${category}")`);
+    }
+    console.log(`${LOG_TAG} 配置拉取成功 (category="${category}")`);
+    return body;
+}
+/**
+ * 获取指定品类的 MCP Server URL
+ *
+ * 优先从内存缓存中读取，未命中时通过 WSClient 拉取并缓存。
+ *
+ * @param category - MCP 品类名称
+ * @returns MCP Server URL
+ */
+async function getMcpUrl(category) {
+    // 查内存缓存
+    const cached = mcpConfigCache.get(category);
+    if (cached)
+        return cached.url;
+    // 缓存未命中，通过 WSClient 拉取
+    const body = await fetchMcpConfig(category);
+    // 写入缓存
+    mcpConfigCache.set(category, body);
+    console.log(`${LOG_TAG} getMcpUrl ${category}: ${body.url}`);
+    return body.url;
+}
+// ============================================================================
+// HTTP 底层通信
+// ============================================================================
+/**
+ * 发送原始 HTTP 请求到 MCP Server（底层方法）
+ *
+ * 自动携带 Mcp-Session-Id 请求头（如果有），
+ * 并从响应头中更新 sessionId。
+ */
+async function sendRawJsonRpc(url, session, body, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    const headers = {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+    };
+    // Streamable HTTP：携带会话 ID
+    if (session.sessionId) {
+        headers["Mcp-Session-Id"] = session.sessionId;
+    }
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === "AbortError") {
+            throw new Error(`MCP 请求超时 (${timeoutMs}ms)`);
+        }
+        throw new Error(`MCP 网络请求失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    // 从响应头提取新的 sessionId（不直接修改入参，由调用方决定如何更新）
+    const newSessionId = response.headers.get("mcp-session-id");
+    if (!response.ok) {
+        throw new McpHttpError(response.status, `MCP HTTP 请求失败: ${response.status} ${response.statusText}`);
+    }
+    // Streamable HTTP：notification 响应可能无响应体（204 或 content-length: 0）
+    const contentLength = response.headers.get("content-length");
+    if (response.status === 204 || contentLength === "0") {
+        return { response, rpcResult: undefined, newSessionId };
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    // 处理 SSE 流式响应
+    if (contentType.includes("text/event-stream")) {
+        return { response, rpcResult: await parseSseResponse(response), newSessionId };
+    }
+    // 普通 JSON 响应 — 先读取文本，防止空内容导致 JSON.parse 报错
+    const text = await response.text();
+    if (!text.trim()) {
+        return { response, rpcResult: undefined, newSessionId };
+    }
+    const rpc = JSON.parse(text);
+    if (rpc.error) {
+        throw new McpRpcError(rpc.error.code, `MCP 调用错误 [${rpc.error.code}]: ${rpc.error.message}`, rpc.error.data);
+    }
+    return { response, rpcResult: rpc.result, newSessionId };
+}
+// ============================================================================
+// Session 管理
+// ============================================================================
+/**
+ * 对指定 URL 执行 Streamable HTTP 的 initialize 握手
+ *
+ * 发送 initialize → 接收 serverInfo → 发送 initialized 通知。
+ * 如果服务端未返回 Mcp-Session-Id，则标记为无状态模式，后续请求跳过 session 管理。
+ */
+async function initializeSession(url, category) {
+    const session = { sessionId: null, initialized: false, stateless: false };
+    console.log(`${LOG_TAG} 开始 initialize 握手 (category="${category}")`);
+    // 1. 发送 initialize 请求
+    const initBody = {
+        jsonrpc: "2.0",
+        id: aibotNodeSdk.generateReqId("mcp_init"),
+        method: "initialize",
+        params: {
+            protocolVersion: "2025-03-26",
+            capabilities: {},
+            clientInfo: { name: "wecom_mcp", version: "1.0.0" },
+        },
+    };
+    const { newSessionId: initSessionId } = await sendRawJsonRpc(url, session, initBody);
+    // 用返回的 newSessionId 更新 session（不再依赖副作用修改）
+    if (initSessionId) {
+        session.sessionId = initSessionId;
+    }
+    // 检查服务端是否返回了 Mcp-Session-Id
+    // 如果没有返回，说明该 Server 是无状态实现，无需维护 session
+    if (!session.sessionId) {
+        session.stateless = true;
+        session.initialized = true;
+        statelessCategories.add(category);
+        mcpSessionCache.set(category, session);
+        console.log(`${LOG_TAG} 无状态 Server 确认 (category="${category}")`);
+        return session;
+    }
+    // 2. 发送 initialized 通知（JSON-RPC notification 不带 id 字段）
+    const notifyBody = {
+        jsonrpc: "2.0",
+        method: "notifications/initialized",
+    };
+    // initialized 通知不需要等待响应，但 Streamable HTTP 要求通过 POST 发送
+    const { newSessionId: notifySessionId } = await sendRawJsonRpc(url, session, notifyBody);
+    // 如果 initialized 通知的响应也携带了 sessionId，以最新的为准
+    if (notifySessionId) {
+        session.sessionId = notifySessionId;
+    }
+    session.initialized = true;
+    mcpSessionCache.set(category, session);
+    console.log(`${LOG_TAG} 有状态 Session 建立成功 (category="${category}", sessionId="${session.sessionId}")`);
+    return session;
+}
+/**
+ * 获取或创建指定 URL 的 MCP 会话
+ *
+ * - 已确认无状态的 category：直接返回空 session，跳过握手
+ * - 已有可用有状态会话：直接返回缓存
+ * - 其他情况：执行 initialize 握手，并发请求会被合并
+ */
+async function getOrCreateSession(url, category) {
+    // 已确认为无状态的 Server，直接返回空 session 跳过握手
+    if (statelessCategories.has(category)) {
+        const cached = mcpSessionCache.get(category);
+        if (cached)
+            return cached;
+        // 首次发现被清除（理论上不会走到这里），重新走握手探测
+    }
+    const cached = mcpSessionCache.get(category);
+    if (cached?.initialized)
+        return cached;
+    // 防止并发重复初始化
+    const inflight = inflightInitRequests.get(category);
+    if (inflight)
+        return inflight;
+    const promise = initializeSession(url, category).finally(() => {
+        inflightInitRequests.delete(category);
+    });
+    inflightInitRequests.set(category, promise);
+    return promise;
+}
+// ============================================================================
+// SSE 解析
+// ============================================================================
+/**
+ * 解析 SSE 流式响应，提取最终的 JSON-RPC result
+ *
+ * 按照 SSE 规范，同一事件中的多个 `data:` 行会用换行符拼接。
+ * 空行分隔不同事件，取最后一个完整事件的数据。
+ */
+async function parseSseResponse(response) {
+    const text = await response.text();
+    const lines = text.split("\n");
+    // 按 SSE 规范解析：空行分隔事件，同一事件内的 data 行用换行拼接
+    let currentDataParts = [];
+    let lastEventData = "";
+    for (const line of lines) {
+        if (line.startsWith("data: ")) {
+            currentDataParts.push(line.slice(6));
+        }
+        else if (line.startsWith("data:")) {
+            // data: 后无空格时，值为空字符串
+            currentDataParts.push(line.slice(5));
+        }
+        else if (line.trim() === "" && currentDataParts.length > 0) {
+            // 空行表示事件结束，拼接所有 data 行
+            lastEventData = currentDataParts.join("\n").trim();
+            currentDataParts = [];
+        }
+    }
+    // 处理最后一个未以空行结尾的事件
+    if (currentDataParts.length > 0) {
+        lastEventData = currentDataParts.join("\n").trim();
+    }
+    if (!lastEventData) {
+        throw new Error("SSE 响应中未包含有效数据");
+    }
+    try {
+        const rpc = JSON.parse(lastEventData);
+        if (rpc.error) {
+            throw new McpRpcError(rpc.error.code, `MCP 调用错误 [${rpc.error.code}]: ${rpc.error.message}`, rpc.error.data);
+        }
+        return rpc.result;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error(`SSE 响应解析失败: ${lastEventData.slice(0, 200)}`);
+        }
+        throw err;
+    }
+}
+// ============================================================================
+// 公共 API
+// ============================================================================
+/**
+ * 清理指定品类的所有 MCP 缓存（配置、会话、无状态标记）
+ *
+ * 当 MCP Server 返回特定错误码时调用，确保下次请求重新拉取配置并重建会话。
+ *
+ * @param category - MCP 品类名称
+ */
+function clearCategoryCache(category) {
+    console.log(`${LOG_TAG} 清理缓存 (category="${category}")`);
+    mcpConfigCache.delete(category);
+    mcpSessionCache.delete(category);
+    statelessCategories.delete(category);
+    inflightInitRequests.delete(category);
+}
+/**
+ * 发送 JSON-RPC 请求到 MCP Server（Streamable HTTP 协议）
+ *
+ * 自动管理 session 生命周期：
+ * - 无状态 Server：跳过 session 管理，直接发送请求
+ * - 有状态 Server：首次调用先执行 initialize 握手，session 失效（404）时自动重建并重试
+ *
+ * @param category - MCP 品类名称
+ * @param method - JSON-RPC 方法名
+ * @param params - JSON-RPC 参数
+ * @param options - 可选配置（如自定义超时）
+ * @returns JSON-RPC result
+ */
+async function sendJsonRpc(category, method, params, options) {
+    const url = await getMcpUrl(category);
+    const timeoutMs = options?.timeoutMs;
+    const body = {
+        jsonrpc: "2.0",
+        id: aibotNodeSdk.generateReqId("mcp_rpc"),
+        method,
+        ...(params !== undefined ? { params } : {}),
+    };
+    let session = await getOrCreateSession(url, category);
+    try {
+        const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body, timeoutMs);
+        // 用最新的 sessionId 更新 session
+        if (newSessionId) {
+            session.sessionId = newSessionId;
+        }
+        return rpcResult;
+    }
+    catch (err) {
+        // 特定 JSON-RPC 错误码触发缓存清理（统一在传输层处理，上层无需关心）
+        if (err instanceof McpRpcError && CACHE_CLEAR_ERROR_CODES.has(err.code)) {
+            clearCategoryCache(category);
+        }
+        // 无状态 Server 不存在 session 失效问题，直接抛出错误
+        if (session.stateless)
+            throw err;
+        // 有状态 Server：session 失效时服务端返回 404，需要重新初始化并重试一次
+        // 使用 McpHttpError.statusCode 精确匹配，避免字符串匹配 "404" 导致误判
+        if (err instanceof McpHttpError && err.statusCode === 404) {
+            console.log(`${LOG_TAG} Session 失效 (category="${category}")，开始重建...`);
+            mcpSessionCache.delete(category);
+            // 使用 rebuildSession 合并并发的 session 重建请求，避免竞态条件
+            session = await rebuildSession(url, category);
+            const { rpcResult, newSessionId } = await sendRawJsonRpc(url, session, body, timeoutMs);
+            if (newSessionId) {
+                session.sessionId = newSessionId;
+            }
+            return rpcResult;
+        }
+        // 其他错误记录日志后抛出
+        console.error(`${LOG_TAG} RPC 请求失败 (category="${category}", method="${method}"): ${err instanceof Error ? err.message : String(err)}`);
+        throw err;
+    }
+}
+/**
+ * 合并并发的 session 重建请求
+ *
+ * 与 getOrCreateSession 类似，使用 inflightInitRequests 防止
+ * 多个并发请求同时遇到 404 时重复执行 initialize 握手。
+ */
+async function rebuildSession(url, category) {
+    const inflight = inflightInitRequests.get(category);
+    if (inflight)
+        return inflight;
+    const promise = initializeSession(url, category).finally(() => {
+        inflightInitRequests.delete(category);
+    });
+    inflightInitRequests.set(category, promise);
+    return promise;
+}
+
+exports.MEDIA_DOWNLOAD_TIMEOUT_MS = MEDIA_DOWNLOAD_TIMEOUT_MS;
+exports.McpHttpError = McpHttpError;
+exports.McpRpcError = McpRpcError;
+exports.clearCategoryCache = clearCategoryCache;
+exports.sendJsonRpc = sendJsonRpc;
+//# sourceMappingURL=transport.js.map