@xiaozhi-client/endpoint 1.9.7-beta.9 → 1.9.8-beta.0

package/README.md

@@ -370,11 +370,11 @@ interface SSEMCPServerConfig {
 }
 ```
 
-#### Streamable HTTP MCP 服务器
+#### HTTP MCP 服务器
 
 ```typescript
-interface StreamableHTTPMCPServerConfig {
-  type?: "streamable-http";
+interface HTTPMCPServerConfig {
+  type?: "http";
   url: string;
   headers?: Record<string, string>;
 }

package/dist/index.d.ts

@@ -99,6 +99,10 @@ interface IMCPServiceManager {
     getAllTools(): EnhancedToolInfo[];
     /** 调用工具 */
     callTool(toolName: string, arguments_: Record<string, unknown>): Promise<ToolCallResult>;
+    /** 初始化 */
+    initialize(): Promise<void>;
+    /** 清理资源 */
+    cleanup(): Promise<void>;
 }
 /**
  * 连接状态枚举
@@ -186,9 +190,11 @@ interface ReconnectResult {
  * 支持三种配置方式：
  * 1. 本地命令 (stdio): { command: string; args: string[]; env?: Record<string, string> }
  * 2. SSE: { type: "sse"; url: string; headers?: Record<string, string> }
- * 3. Streamable HTTP: { type?: "streamable-http"; url: string; headers?: Record<string, string> }
+ * 3. HTTP: { type?: "http"; url: string; headers?: Record<string, string> }
+ *
+ * 向后兼容：自动将 streamable-http/streamable_http/streamableHttp 转换为 http
  */
-type MCPServerConfig = LocalMCPServerConfig | SSEMCPServerConfig | StreamableHTTPMCPServerConfig;
+type MCPServerConfig = LocalMCPServerConfig | SSEMCPServerConfig | HTTPMCPServerConfig;
 /**
  * 本地 MCP 服务器配置
  */
@@ -206,16 +212,20 @@ interface SSEMCPServerConfig {
     headers?: Record<string, string>;
 }
 /**
- * Streamable HTTP MCP 服务器配置
+ * HTTP MCP 服务器配置
+ * 使用 type: "http"
+ * 向后兼容 streamable-http 写法
  */
-interface StreamableHTTPMCPServerConfig {
-    type?: "streamable-http";
+interface HTTPMCPServerConfig {
+    type?: "http" | "streamable-http";
     url: string;
     headers?: Record<string, string>;
 }
+/** @deprecated 使用 HTTPMCPServerConfig 代替 */
+type StreamableHTTPMCPServerConfig = HTTPMCPServerConfig;
 /**
  * Endpoint 配置接口
- * 用于新 API：直接在构造函数中传入 MCP 服务器配置
+ * @deprecated 不再使用，Endpoint 构造函数改为接收 IMCPServiceManager
  */
 interface EndpointConfig {
     /** MCP 服务器配置（声明式） */
@@ -226,21 +236,67 @@ interface EndpointConfig {
     modelscopeApiKey?: string;
 }
 /**
- * EndpointManager 配置接口（新 API 简化版）
+ * EndpointManager 配置接口
  */
 interface EndpointManagerConfig {
     /** 可选：默认重连延迟（毫秒） */
     defaultReconnectDelay?: number;
 }
+/**
+ * 小智平台 JWT Token Payload 接口
+ *
+ * @example
+ * ```typescript
+ * // 从 endpoint URL 解码得到的 payload
+ * const payload: XiaozhiTokenPayload = {
+ *   userId: 302720,
+ *   agentId: 1324149,
+ *   endpointId: "agent_1324149",
+ *   purpose: "mcp-endpoint",
+ *   iat: 1768480930,
+ *   exp: 1800038530
+ * };
+ * ```
+ */
+interface XiaozhiTokenPayload {
+    /** 用户 ID */
+    userId: number;
+    /** 代理 ID */
+    agentId: number;
+    /** 接入点 ID，格式为 "agent_{agentId}" */
+    endpointId: string;
+    /** Token 用途 */
+    purpose: string;
+    /** 签发时间（Unix 时间戳） */
+    iat: number;
+    /** 过期时间（Unix 时间戳） */
+    exp: number;
+}
+/**
+ * 解析后的 Endpoint URL 信息
+ */
+interface ParsedEndpointInfo {
+    /** 完整的 endpoint URL */
+    url: string;
+    /** 提取的 JWT Token */
+    token: string;
+    /** 解码后的 Token Payload */
+    payload: XiaozhiTokenPayload;
+    /** WebSocket 服务器地址（不含 token 参数） */
+    wsUrl: string;
+}
 
 /**
- * Endpoint 类（新 API）
+ * Endpoint 类
  * 管理单个小智接入点的 WebSocket 连接
  * 实现 MCP (Model Context Protocol) 协议通信
  *
- * 与 EndpointConnection 的区别：
- * - 构造函数直接传入 mcpServers 配置，不需要单独调用 setServiceManager()
- * - 配置更简洁直观
+ * 使用方式：
+ * ```typescript
+ * const mcpManager = new SharedMCPAdapter(globalMCPManager);
+ * const endpoint = new Endpoint("ws://...", mcpManager);
+ * await endpoint.connect();
+ * ```
  */
 
 /**
@@ -263,9 +319,10 @@ declare class Endpoint {
      * 构造函数
      *
      * @param endpointUrl - 小智接入点 URL
-     * @param config - Endpoint 配置（包含 mcpServers）
+     * @param mcpManager - MCP 服务管理器（依赖注入）
+     * @param reconnectDelay - 可选的重连延迟（毫秒）
      */
-    constructor(endpointUrl: string, config: EndpointConfig);
+    constructor(endpointUrl: string, mcpManager: IMCPServiceManager, reconnectDelay?: number);
     /**
      * 获取 Endpoint URL
      */
@@ -341,23 +398,39 @@ declare class Endpoint {
 }
 
 /**
- * EndpointManager（新 API）
- * 管理多个小智接入点的连接，每个小智接入点独立运行
+ * EndpointManager
+ * 管理多个小智接入点的连接，共享外部传入的 MCPManager
+ *
+ * 使用方式：
+ * ```typescript
+ * // 1. 先创建并配置 MCPManager
+ * const mcpManager = new MCPManager();
+ * mcpManager.addServer("calculator", { command: "npx", args: ["-y", "calculator-mcp"] });
+ * await mcpManager.connect();
  *
- * 与旧 EndpointManager 的区别：
- * - 使用 addEndpoint(endpoint) 添加 Endpoint 实例
- * - 不需要 initialize() 和 setServiceManager()
- * - 配置更简洁直观
+ * // 2. 创建 EndpointManager 并设置 MCPManager
+ * const manager = new EndpointManager();
+ * manager.setMcpManager(mcpManager);
+ *
+ * // 3. 添加接入点
+ * manager.addEndpoint("ws://endpoint1");
+ * await manager.connect();
+ * ```
  */
 
 /**
- * 小智接入点管理器（新 API）
- * 负责管理多个小智接入点的连接
+ * 小智接入点管理器
+ * 负责管理多个小智接入点的连接，共享 MCP 服务
+ *
+ * 注意：MCPManager 必须通过 setMcpManager() 方法设置，且由外部管理其生命周期
  */
 declare class EndpointManager extends EventEmitter {
     private config?;
     private endpoints;
     private connectionStates;
+    private mcpManager;
+    private sharedMCPAdapter;
+    private mcpEventListeners;
     /**
      * 构造函数
      *
@@ -365,11 +438,23 @@ declare class EndpointManager extends EventEmitter {
      */
     constructor(config?: EndpointManagerConfig | undefined);
     /**
-     * 添加 Endpoint 实例
+     * 设置 MCPManager 实例
      *
-     * @param endpoint - Endpoint 实例
+     * 注意：MCPManager 的生命周期由外部管理，EndpointManager 不负责连接和断开
+     *
+     * @param mcpManager - 外部创建并已连接的 MCPManager 实例
+     */
+    setMcpManager(mcpManager: IMCPServiceManager): void;
+    /**
+     * 添加 Endpoint（支持 URL 字符串或 Endpoint 实例）
+     *
+     * @param endpoint - Endpoint URL 字符串或 Endpoint 实例
+     */
+    addEndpoint(endpoint: string | Endpoint): void;
+    /**
+     * 内部添加 Endpoint 方法
      */
-    addEndpoint(endpoint: Endpoint): void;
+    private addEndpointInternal;
     /**
      * 移除 Endpoint 实例
      *
@@ -377,13 +462,21 @@ declare class EndpointManager extends EventEmitter {
      */
     removeEndpoint(endpoint: Endpoint): void;
     /**
-     * 连接所有 Endpoint
+     * 连接 Endpoint
+     *
+     * 注意：此方法不负责连接 MCPManager，MCPManager 必须在调用此方法前已连接
+     *
+     * @param endpoint - 可选，指定要连接的端点 URL。如果不传入，则连接所有端点
      */
-    connect(): Promise<void>;
+    connect(endpoint?: string): Promise<void>;
     /**
-     * 断开所有连接
+     * 断开连接
+     *
+     * 注意：此方法不断开 MCPManager，MCPManager 的生命周期由外部管理
+     *
+     * @param endpoint - 可选，指定要断开的端点 URL。如果不传入，则断开所有端点
      */
-    disconnect(): Promise<void>;
+    disconnect(endpoint?: string): Promise<void>;
     /**
      * 获取所有 Endpoint URL
      */
@@ -414,6 +507,14 @@ declare class EndpointManager extends EventEmitter {
      * @param url - 端点 URL
      */
     getEndpointStatus(url: string): SimpleConnectionStatus | undefined;
+    /**
+     * 重连
+     *
+     * @param endpoint - 可选，指定要重连的端点 URL。如果不传入，则重连所有端点
+     * @param delay - 可选，disconnect 和 connect 之间的等待时间（毫秒），默认为 1000ms。
+     *               注意：此参数只控制断开和重新连接之间的等待时间，不影响底层 Endpoint 实例的重连延迟
+     */
+    reconnect(endpoint?: string, delay?: number): Promise<void>;
     /**
      * 重连所有端点
      */
@@ -426,10 +527,14 @@ declare class EndpointManager extends EventEmitter {
     reconnectEndpoint(url: string): Promise<void>;
     /**
      * 清除所有端点
+     *
+     * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理
      */
     clearEndpoints(): Promise<void>;
     /**
      * 清理资源
+     *
+     * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理
      */
     cleanup(): Promise<void>;
     /**
@@ -442,6 +547,64 @@ declare class EndpointManager extends EventEmitter {
     private reconnectSingleEndpoint;
 }
 
+/**
+ * 共享 MCP 管理器适配器
+ *
+ * 接收全局 MCPManager 实例的引用，不创建独立连接
+ * 用于多个 Endpoint 共享同一个 MCPManager 实例
+ *
+ * @example
+ * ```typescript
+ * const globalMCPManager = new MCPManager();
+ * await globalMCPManager.connect();
+ *
+ * const adapter = new SharedMCPAdapter(globalMCPManager);
+ * const endpoint = new Endpoint("ws://...", adapter);
+ * ```
+ */
+
+/**
+ * 共享 MCP 管理器适配器
+ * 实现 IMCPServiceManager 接口，将操作委托给全局 MCPManager
+ */
+declare class SharedMCPAdapter implements IMCPServiceManager {
+    private globalMCPManager;
+    private isInitialized;
+    /**
+     * 构造函数
+     *
+     * @param globalMCPManager - 全局 MCPManager 实例
+     */
+    constructor(globalMCPManager: IMCPServiceManager);
+    /**
+     * 初始化适配器
+     *
+     * 注意：此方法不执行任何连接操作，仅标记初始化状态，因为全局 MCPManager 的生命周期由外部管理
+     */
+    initialize(): Promise<void>;
+    /**
+     * 获取所有工具列表
+     *
+     * 从全局 MCPManager 获取工具列表，并转换为增强格式
+     */
+    getAllTools(): EnhancedToolInfo[];
+    /**
+     * 调用工具
+     *
+     * 将工具调用委托给全局 MCPManager
+     *
+     * @param toolName - 工具名称（格式：serviceName__toolName）
+     * @param arguments_ - 工具调用参数
+     */
+    callTool(toolName: string, arguments_: Record<string, unknown>): Promise<ToolCallResult>;
+    /**
+     * 清理资源
+     *
+     * 注意：此方法不会断开全局 MCPManager，由创建者负责管理
+     */
+    cleanup(): Promise<void>;
+}
+
 /**
  * 工具函数模块
  *
@@ -515,6 +678,53 @@ declare function sleep(ms: number): Promise<void>;
  * @returns 格式化后的错误消息
  */
 declare function formatErrorMessage(error: unknown): string;
+/**
+ * 解码 JWT Token（仅解析 payload，不验证签名）
+ *
+ * @param token - JWT Token 字符串
+ * @returns 解码后的 Token Payload，解码失败返回 null
+ *
+ * @example
+ * ```typescript
+ * const payload = decodeJWTToken("eyJ...token...");
+ * if (payload) {
+ *   console.log(payload.endpointId); // "agent_1324149"
+ * }
+ * ```
+ */
+declare function decodeJWTToken(token: string): XiaozhiTokenPayload | null;
+/**
+ * 从 endpoint URL 中提取 token 参数
+ *
+ * @param url - 完整的 endpoint URL
+ * @returns 提取的 token 字符串，未找到返回 null
+ *
+ * @example
+ * ```typescript
+ * const token = extractTokenFromUrl(
+ *   "wss://api.xiaozhi.me/mcp/?token=eyJ..."
+ * );
+ * ```
+ */
+declare function extractTokenFromUrl(url: string): string | null;
+/**
+ * 解析 endpoint URL 获取完整信息
+ *
+ * @param url - 完整的 endpoint URL
+ * @returns 解析后的 endpoint 信息，解析失败返回 null
+ *
+ * @example
+ * ```typescript
+ * const info = parseEndpointUrl(
+ *   "wss://api.xiaozhi.me/mcp/?token=eyJ..."
+ * );
+ * if (info) {
+ *   console.log(info.payload.endpointId); // "agent_1324149"
+ *   console.log(info.wsUrl); // "wss://api.xiaozhi.me/mcp/"
+ * }
+ * ```
+ */
+declare function parseEndpointUrl(url: string): ParsedEndpointInfo | null;
 
 /**
  * MCP 消息类型定义
@@ -548,4 +758,4 @@ interface ExtendedMCPMessage {
     };
 }
 
-export { type ConfigChangeEvent, type ConnectionOptions, ConnectionState, type ConnectionStatus, Endpoint, type EndpointConfig, type EndpointConnectionStatus, EndpointManager, type EndpointManagerConfig, type ExtendedMCPMessage, type IMCPServiceManager, type JSONSchema, type LocalMCPServerConfig, type MCPMessage, type MCPServerConfig, type ReconnectResult, type SSEMCPServerConfig, type SimpleConnectionStatus, type StreamableHTTPMCPServerConfig, ToolCallError, ToolCallErrorCode, type ToolCallParams, type ToolCallResult, type ValidatedToolCallParams, deepMerge, ensureToolJSONSchema, formatErrorMessage, isValidEndpointUrl, sleep, sliceEndpoint, validateToolCallParams };
+export { type ConfigChangeEvent, type ConnectionOptions, ConnectionState, type ConnectionStatus, Endpoint, type EndpointConfig, type EndpointConnectionStatus, EndpointManager, type EndpointManagerConfig, type ExtendedMCPMessage, type IMCPServiceManager, type JSONSchema, type LocalMCPServerConfig, type MCPMessage, type MCPServerConfig, type ParsedEndpointInfo, type ReconnectResult, type SSEMCPServerConfig, SharedMCPAdapter, type SimpleConnectionStatus, type StreamableHTTPMCPServerConfig, ToolCallError, ToolCallErrorCode, type ToolCallParams, type ToolCallResult, type ValidatedToolCallParams, type XiaozhiTokenPayload, decodeJWTToken, deepMerge, ensureToolJSONSchema, extractTokenFromUrl, formatErrorMessage, isValidEndpointUrl, parseEndpointUrl, sleep, sliceEndpoint, validateToolCallParams };

package/dist/index.js

@@ -133,105 +133,73 @@ function formatErrorMessage(error) {
   return String(error);
 }
 __name(formatErrorMessage, "formatErrorMessage");
-
-// src/internal-mcp-manager.ts
-import { MCPManager } from "@xiaozhi-client/mcp-core";
-import { convertLegacyToNew } from "@xiaozhi-client/config";
-var InternalMCPManagerAdapter = class {
-  constructor(config) {
-    this.config = config;
-    this.mcpManager = new MCPManager();
-    for (const [serviceName, serverConfig] of Object.entries(
-      config.mcpServers
-    )) {
-      const mcpConfig = this.convertToMCPServiceConfig(serviceName, serverConfig);
-      this.mcpManager.addServer(serviceName, mcpConfig);
-    }
-    this.mcpManager.on("connected", (data) => {
-    });
-    this.mcpManager.on("error", (data) => {
-    });
+function base64UrlDecode(input) {
+  let base64 = input.replace(/-/g, "+").replace(/_/g, "/");
+  while (base64.length % 4) {
+    base64 += "=";
   }
-  static {
-    __name(this, "InternalMCPManagerAdapter");
+  return Buffer.from(base64, "base64").toString("utf-8");
+}
+__name(base64UrlDecode, "base64UrlDecode");
+function decodeJWTToken(token) {
+  if (!token || typeof token !== "string") {
+    return null;
   }
-  mcpManager;
-  tools = /* @__PURE__ */ new Map();
-  isInitialized = false;
-  /**
-   * 初始化并启动所有 MCP 服务
-   */
-  async initialize() {
-    if (this.isInitialized) {
-      return;
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3) {
+      return null;
     }
-    await this.mcpManager.connect();
-    await this.refreshTools();
-    this.isInitialized = true;
+    const payloadStr = base64UrlDecode(parts[1]);
+    const payload = JSON.parse(payloadStr);
+    if (typeof payload !== "object" || payload === null || !("userId" in payload) || !("agentId" in payload) || !("endpointId" in payload) || !("purpose" in payload) || !("iat" in payload) || !("exp" in payload)) {
+      return null;
+    }
+    return payload;
+  } catch {
+    return null;
   }
-  /**
-   * 获取所有工具列表
-   */
-  getAllTools() {
-    return Array.from(this.tools.values());
+}
+__name(decodeJWTToken, "decodeJWTToken");
+function extractTokenFromUrl(url) {
+  if (!url || typeof url !== "string") {
+    return null;
   }
-  /**
-   * 调用工具（真实实现）
-   */
-  async callTool(toolName, arguments_) {
-    const [serviceName, actualToolName] = this.parseToolName(toolName);
-    return this.mcpManager.callTool(serviceName, actualToolName, arguments_);
+  try {
+    const urlObj = new URL(url);
+    return urlObj.searchParams.get("token");
+  } catch {
+    return null;
   }
-  /**
-   * 清理资源
-   */
-  async cleanup() {
-    await this.mcpManager.disconnect();
-    this.tools.clear();
-    this.isInitialized = false;
+}
+__name(extractTokenFromUrl, "extractTokenFromUrl");
+function parseEndpointUrl(url) {
+  if (!url || typeof url !== "string") {
+    return null;
   }
-  /**
-   * 刷新工具列表
-   */
-  async refreshTools() {
-    this.tools.clear();
-    const mcpTools = this.mcpManager.listTools();
-    for (const mcpTool of mcpTools) {
-      const enhancedTool = {
-        name: `${mcpTool.serverName}__${mcpTool.name}`,
-        description: mcpTool.description,
-        inputSchema: mcpTool.inputSchema,
-        serviceName: mcpTool.serverName,
-        originalName: mcpTool.name,
-        enabled: true,
-        usageCount: 0,
-        lastUsedTime: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      this.tools.set(enhancedTool.name, enhancedTool);
+  try {
+    const token = extractTokenFromUrl(url);
+    if (!token) {
+      return null;
     }
-  }
-  /**
-   * 解析工具名称
-   */
-  parseToolName(toolName) {
-    const parts = toolName.split("__");
-    if (parts.length < 2) {
-      throw new Error(`\u65E0\u6548\u7684\u5DE5\u5177\u540D\u79F0\u683C\u5F0F: ${toolName}`);
+    const payload = decodeJWTToken(token);
+    if (!payload) {
+      return null;
     }
-    const serviceName = parts[0];
-    const actualToolName = parts.slice(1).join("__");
-    return [serviceName, actualToolName];
-  }
-  /**
-   * 将 MCPServerConfig 转换为 MCPServiceConfig
-   * 使用统一的配置适配器，确保路径解析逻辑一致
-   */
-  convertToMCPServiceConfig(serviceName, config) {
-    const converted = convertLegacyToNew(serviceName, config);
-    const { name, ...rest } = converted;
-    return rest;
+    const urlObj = new URL(url);
+    urlObj.searchParams.delete("token");
+    const wsUrl = urlObj.toString();
+    return {
+      url,
+      token,
+      payload,
+      wsUrl
+    };
+  } catch {
+    return null;
   }
-};
+}
+__name(parseEndpointUrl, "parseEndpointUrl");
 
 // src/endpoint.ts
 var Endpoint = class {
@@ -257,12 +225,13 @@ var Endpoint = class {
    * 构造函数
    *
    * @param endpointUrl - 小智接入点 URL
-   * @param config - Endpoint 配置（包含 mcpServers）
+   * @param mcpManager - MCP 服务管理器（依赖注入）
+   * @param reconnectDelay - 可选的重连延迟（毫秒）
    */
-  constructor(endpointUrl, config) {
+  constructor(endpointUrl, mcpManager, reconnectDelay) {
     this.endpointUrl = endpointUrl;
-    this.reconnectDelay = config.reconnectDelay ?? 2e3;
-    this.mcpAdapter = new InternalMCPManagerAdapter(config);
+    this.reconnectDelay = reconnectDelay ?? 2e3;
+    this.mcpAdapter = mcpManager;
   }
   /**
    * 获取 Endpoint URL
@@ -577,6 +546,65 @@ var Endpoint = class {
 
 // src/manager.ts
 import { EventEmitter } from "events";
+
+// src/shared-mcp-adapter.ts
+var SharedMCPAdapter = class {
+  /**
+   * 构造函数
+   *
+   * @param globalMCPManager - 全局 MCPManager 实例
+   */
+  constructor(globalMCPManager) {
+    this.globalMCPManager = globalMCPManager;
+    if (!globalMCPManager) {
+      throw new Error("\u5168\u5C40 MCPManager \u4E0D\u80FD\u4E3A\u7A7A");
+    }
+  }
+  static {
+    __name(this, "SharedMCPAdapter");
+  }
+  isInitialized = false;
+  /**
+   * 初始化适配器
+   *
+   * 注意：此方法不执行任何连接操作，仅标记初始化状态，因为全局 MCPManager 的生命周期由外部管理
+   */
+  async initialize() {
+    if (this.isInitialized) {
+      return;
+    }
+    this.isInitialized = true;
+  }
+  /**
+   * 获取所有工具列表
+   *
+   * 从全局 MCPManager 获取工具列表，并转换为增强格式
+   */
+  getAllTools() {
+    return this.globalMCPManager.getAllTools();
+  }
+  /**
+   * 调用工具
+   *
+   * 将工具调用委托给全局 MCPManager
+   *
+   * @param toolName - 工具名称（格式：serviceName__toolName）
+   * @param arguments_ - 工具调用参数
+   */
+  async callTool(toolName, arguments_) {
+    return this.globalMCPManager.callTool(toolName, arguments_);
+  }
+  /**
+   * 清理资源
+   *
+   * 注意：此方法不会断开全局 MCPManager，由创建者负责管理
+   */
+  async cleanup() {
+    this.isInitialized = false;
+  }
+};
+
+// src/manager.ts
 var EndpointManager = class extends EventEmitter {
   /**
    * 构造函数
@@ -592,12 +620,65 @@ var EndpointManager = class extends EventEmitter {
   }
   endpoints = /* @__PURE__ */ new Map();
   connectionStates = /* @__PURE__ */ new Map();
+  mcpManager = null;
+  sharedMCPAdapter = null;
+  mcpEventListeners = [];
   /**
-   * 添加 Endpoint 实例
+   * 设置 MCPManager 实例
    *
-   * @param endpoint - Endpoint 实例
+   * 注意：MCPManager 的生命周期由外部管理，EndpointManager 不负责连接和断开
+   *
+   * @param mcpManager - 外部创建并已连接的 MCPManager 实例
+   */
+  setMcpManager(mcpManager) {
+    if (this.sharedMCPAdapter) {
+      throw new Error("MCPManager \u5DF2\u7ECF\u8BBE\u7F6E\uFF0C\u4E0D\u80FD\u91CD\u590D\u8BBE\u7F6E");
+    }
+    this.mcpManager = mcpManager;
+    this.sharedMCPAdapter = new SharedMCPAdapter(mcpManager);
+    if ("on" in mcpManager && typeof mcpManager.on === "function") {
+      const connectedHandler = /* @__PURE__ */ __name((...args) => {
+        const data = args[0];
+      }, "connectedHandler");
+      const errorHandler = /* @__PURE__ */ __name((...args) => {
+        const data = args[0];
+      }, "errorHandler");
+      mcpManager.on("connected", connectedHandler);
+      mcpManager.on("error", errorHandler);
+      this.mcpEventListeners.push(connectedHandler, errorHandler);
+    }
+  }
+  /**
+   * 添加 Endpoint（支持 URL 字符串或 Endpoint 实例）
+   *
+   * @param endpoint - Endpoint URL 字符串或 Endpoint 实例
    */
   addEndpoint(endpoint) {
+    if (typeof endpoint === "string") {
+      if (!this.sharedMCPAdapter) {
+        throw new Error(
+          "MCPManager \u672A\u8BBE\u7F6E\uFF0C\u8BF7\u5148\u8C03\u7528 setMcpManager() \u65B9\u6CD5\u8BBE\u7F6E MCPManager"
+        );
+      }
+      const endpointInstance = new Endpoint(
+        endpoint,
+        this.sharedMCPAdapter,
+        this.config?.defaultReconnectDelay
+      );
+      this.addEndpointInternal(endpointInstance);
+      return;
+    }
+    if (this.sharedMCPAdapter) {
+      throw new Error(
+        "[EndpointManager] \u5F53\u4F7F\u7528\u5171\u4EAB MCPManager \u65F6\uFF0C\u4E0D\u652F\u6301\u4F20\u5165\u81EA\u5B9A\u4E49 Endpoint \u5B9E\u4F8B\uFF0C\u8BF7\u4F20\u5165 Endpoint URL \u5B57\u7B26\u4E32\u4EE5\u4FBF\u7531 EndpointManager \u521B\u5EFA\u5B9E\u4F8B"
+      );
+    }
+    this.addEndpointInternal(endpoint);
+  }
+  /**
+   * 内部添加 Endpoint 方法
+   */
+  addEndpointInternal(endpoint) {
     const url = endpoint.getUrl();
     if (this.endpoints.has(url)) {
       return;
@@ -626,18 +707,38 @@ var EndpointManager = class extends EventEmitter {
     this.emit("endpointRemoved", { endpoint: url });
   }
   /**
-   * 连接所有 Endpoint
+   * 连接 Endpoint
+   *
+   * 注意：此方法不负责连接 MCPManager，MCPManager 必须在调用此方法前已连接
+   *
+   * @param endpoint - 可选，指定要连接的端点 URL。如果不传入，则连接所有端点
    */
-  async connect() {
+  async connect(endpoint) {
+    if (endpoint) {
+      const endpointInstance = this.endpoints.get(endpoint);
+      if (!endpointInstance) {
+        throw new Error(`\u63A5\u5165\u70B9\u4E0D\u5B58\u5728: ${sliceEndpoint(endpoint)}`);
+      }
+      const status = this.connectionStates.get(endpoint);
+      if (status?.connected) {
+        return;
+      }
+      await this.connectSingleEndpoint(endpoint, endpointInstance);
+      return;
+    }
     const promises = [];
-    for (const [url, endpoint] of this.endpoints) {
+    for (const [url, endpoint2] of this.endpoints) {
+      const status = this.connectionStates.get(url);
+      if (status?.connected) {
+        continue;
+      }
       promises.push(
-        this.connectSingleEndpoint(url, endpoint).catch((error) => {
-          const status = this.connectionStates.get(url);
-          if (status) {
-            status.connected = false;
-            status.initialized = false;
-            status.lastError = error instanceof Error ? error.message : String(error);
+        this.connectSingleEndpoint(url, endpoint2).catch((error) => {
+          const status2 = this.connectionStates.get(url);
+          if (status2) {
+            status2.connected = false;
+            status2.initialized = false;
+            status2.lastError = error instanceof Error ? error.message : String(error);
           }
         })
       );
@@ -648,14 +749,31 @@ var EndpointManager = class extends EventEmitter {
     ).length;
   }
   /**
-   * 断开所有连接
+   * 断开连接
+   *
+   * 注意：此方法不断开 MCPManager，MCPManager 的生命周期由外部管理
+   *
+   * @param endpoint - 可选，指定要断开的端点 URL。如果不传入，则断开所有端点
    */
-  async disconnect() {
+  async disconnect(endpoint) {
+    if (endpoint) {
+      const endpointInstance = this.endpoints.get(endpoint);
+      if (!endpointInstance) {
+        throw new Error(`\u63A5\u5165\u70B9\u4E0D\u5B58\u5728: ${sliceEndpoint(endpoint)}`);
+      }
+      endpointInstance.disconnect();
+      const status = this.connectionStates.get(endpoint);
+      if (status) {
+        status.connected = false;
+        status.initialized = false;
+      }
+      return;
+    }
     const promises = [];
-    for (const endpoint of this.endpoints.values()) {
+    for (const endpoint2 of this.endpoints.values()) {
       promises.push(
         Promise.resolve().then(() => {
-          endpoint.disconnect();
+          endpoint2.disconnect();
         })
       );
     }
@@ -713,6 +831,18 @@ var EndpointManager = class extends EventEmitter {
   getEndpointStatus(url) {
     return this.connectionStates.get(url);
   }
+  /**
+   * 重连
+   *
+   * @param endpoint - 可选，指定要重连的端点 URL。如果不传入，则重连所有端点
+   * @param delay - 可选，disconnect 和 connect 之间的等待时间（毫秒），默认为 1000ms。
+   *               注意：此参数只控制断开和重新连接之间的等待时间，不影响底层 Endpoint 实例的重连延迟
+   */
+  async reconnect(endpoint, delay = 1e3) {
+    await this.disconnect(endpoint);
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    await this.connect(endpoint);
+  }
   /**
    * 重连所有端点
    */
@@ -740,6 +870,8 @@ var EndpointManager = class extends EventEmitter {
   }
   /**
    * 清除所有端点
+   *
+   * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理
    */
   async clearEndpoints() {
     await this.disconnect();
@@ -748,8 +880,17 @@ var EndpointManager = class extends EventEmitter {
   }
   /**
    * 清理资源
+   *
+   * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理
    */
   async cleanup() {
+    if (this.mcpManager && "removeListener" in this.mcpManager && typeof this.mcpManager.removeListener === "function") {
+      for (const listener of this.mcpEventListeners) {
+        this.mcpManager.removeListener("connected", listener);
+        this.mcpManager.removeListener("error", listener);
+      }
+    }
+    this.mcpEventListeners = [];
     await this.clearEndpoints();
   }
   // ==================== 私有方法 ====================
@@ -788,12 +929,16 @@ export {
   ConnectionState,
   Endpoint,
   EndpointManager,
+  SharedMCPAdapter,
   ToolCallError,
   ToolCallErrorCode,
+  decodeJWTToken,
   deepMerge,
   ensureToolJSONSchema,
+  extractTokenFromUrl,
   formatErrorMessage,
   isValidEndpointUrl,
+  parseEndpointUrl,
   sleep,
   sliceEndpoint,
   validateToolCallParams

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/endpoint.ts","../src/types.ts","../src/utils.ts","../src/internal-mcp-manager.ts","../src/manager.ts"],"sourcesContent":["/**\n * Endpoint 类（新 API）\n * 管理单个小智接入点的 WebSocket 连接\n * 实现 MCP (Model Context Protocol) 协议通信\n *\n * 与 EndpointConnection 的区别：\n * - 构造函数直接传入 mcpServers 配置，不需要单独调用 setServiceManager()\n * - 配置更简洁直观\n */\n\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport WebSocket from \"ws\";\nimport type { ExtendedMCPMessage, MCPMessage } from \"./mcp.js\";\nimport type {\n  EndpointConfig,\n  EndpointConnectionStatus,\n  ToolCallResult,\n} from \"./types.js\";\nimport {\n  ConnectionState,\n  ToolCallError as ToolCallErrorClass,\n  ToolCallErrorCode as ToolCallErrorCodeEnum,\n  ensureToolJSONSchema as ensureToolJSONSchemaFn,\n} from \"./types.js\";\nimport { validateToolCallParams } from \"./utils.js\";\nimport { sliceEndpoint } from \"./utils.js\";\nimport { InternalMCPManagerAdapter } from \"./internal-mcp-manager.js\";\n\n// 导出错误类型供外部使用\nexport {\n  ToolCallErrorCodeEnum as ToolCallErrorCode,\n  ToolCallErrorClass as ToolCallError,\n};\n\n/**\n * Endpoint 类\n * 负责管理单个小智接入点的 WebSocket 连接\n * 使用新的配置方式：直接在构造函数中传入 mcpServers 配置\n */\nexport class Endpoint {\n  private endpointUrl: string;\n  private ws: WebSocket | null = null;\n  private connectionStatus = false;\n  private serverInitialized = false;\n  private mcpAdapter: InternalMCPManagerAdapter;\n\n  // 连接状态管理\n  private connectionState: ConnectionState = ConnectionState.DISCONNECTED;\n\n  // 最后一次错误信息\n  private lastError: string | null = null;\n\n  // 连接超时定时器\n  private connectionTimeout: NodeJS.Timeout | null = null;\n\n  // 工具调用超时配置\n  private toolCallTimeout = 30000;\n  private reconnectDelay: number; // 重连延迟（毫秒）\n\n  /**\n   * 构造函数\n   *\n   * @param endpointUrl - 小智接入点 URL\n   * @param config - Endpoint 配置（包含 mcpServers）\n   */\n  constructor(endpointUrl: string, config: EndpointConfig) {\n    this.endpointUrl = endpointUrl;\n    this.reconnectDelay = config.reconnectDelay ?? 2000;\n\n    // 创建内部 MCP 适配器\n    this.mcpAdapter = new InternalMCPManagerAdapter(config);\n  }\n\n  /**\n   * 获取 Endpoint URL\n   */\n  getUrl(): string {\n    return this.endpointUrl;\n  }\n\n  /**\n   * 获取当前所有工具列表\n   */\n  getTools(): Tool[] {\n    try {\n      const allTools = this.mcpAdapter.getAllTools();\n\n      return allTools.map((toolInfo) => ({\n        name: toolInfo.name,\n        description: toolInfo.description,\n        inputSchema: ensureToolJSONSchemaFn(toolInfo.inputSchema),\n      }));\n    } catch (error) {\n      console.error(\n        `获取工具列表失败: ${error instanceof Error ? error.message : String(error)}`\n      );\n      return [];\n    }\n  }\n\n  /**\n   * 连接小智接入点\n   */\n  public async connect(): Promise<void> {\n    // 初始化 MCP 适配器\n    await this.mcpAdapter.initialize();\n\n    // 如果正在连接中，等待当前连接完成\n    if (this.connectionState === ConnectionState.CONNECTING) {\n      throw new Error(\"连接正在进行中，请等待连接完成\");\n    }\n\n    // 清理之前的连接\n    this.cleanupConnection();\n\n    return this.attemptConnection();\n  }\n\n  /**\n   * 尝试建立连接\n   */\n  private async attemptConnection(): Promise<void> {\n    this.connectionState = ConnectionState.CONNECTING;\n    console.debug(`正在连接小智接入点: ${sliceEndpoint(this.endpointUrl)}`);\n\n    return new Promise((resolve, reject) => {\n      // 设置连接超时\n      this.connectionTimeout = setTimeout(() => {\n        const error = new Error(\"连接超时 (10000ms)\");\n        this.handleConnectionError(error);\n        reject(error);\n      }, 10000);\n\n      this.ws = new WebSocket(this.endpointUrl);\n\n      this.ws.on(\"open\", () => {\n        this.handleConnectionSuccess();\n        resolve();\n      });\n\n      this.ws.on(\"message\", (data) => {\n        try {\n          const message: MCPMessage = JSON.parse(data.toString());\n          this.handleMessage(message);\n        } catch (error) {\n          console.error(\"MCP 消息解析错误:\", error);\n        }\n      });\n\n      this.ws.on(\"close\", (code, reason) => {\n        this.handleConnectionClose(code, reason.toString());\n      });\n\n      this.ws.on(\"error\", (error) => {\n        this.handleConnectionError(error);\n        reject(error);\n      });\n    });\n  }\n\n  /**\n   * 处理连接成功\n   */\n  private handleConnectionSuccess(): void {\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    this.connectionStatus = true;\n    this.connectionState = ConnectionState.CONNECTED;\n\n    console.debug(\"MCP WebSocket 连接已建立\");\n  }\n\n  /**\n   * 处理连接错误\n   */\n  private handleConnectionError(error: Error): void {\n    // 记录最后一次错误信息\n    this.lastError = error.message;\n\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    console.error(\"MCP WebSocket 错误:\", error.message);\n\n    // 清理当前连接\n    this.cleanupConnection();\n  }\n\n  /**\n   * 处理连接关闭\n   */\n  private handleConnectionClose(code: number, reason: string): void {\n    this.connectionStatus = false;\n    this.serverInitialized = false;\n    this.connectionState = ConnectionState.DISCONNECTED;\n    console.info(`小智连接已关闭 (代码: ${code}, 原因: ${reason})`);\n  }\n\n  /**\n   * 清理连接资源\n   */\n  private cleanupConnection(): void {\n    // 清理 WebSocket\n    if (this.ws) {\n      this.ws.removeAllListeners();\n\n      try {\n        if (this.ws.readyState === WebSocket.OPEN) {\n          this.ws.close(1000, \"Cleaning up connection\");\n        } else if (this.ws.readyState === WebSocket.CONNECTING) {\n          this.ws.terminate();\n        }\n      } catch (error) {\n        console.debug(\"WebSocket 关闭时出现错误（已忽略）:\", error);\n      }\n\n      this.ws = null;\n    }\n\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    // 重置连接状态\n    this.connectionStatus = false;\n    this.serverInitialized = false;\n\n    // 重置连接状态为已断开\n    this.connectionState = ConnectionState.DISCONNECTED;\n  }\n\n  /**\n   * 处理 MCP 消息\n   */\n  private handleMessage(message: MCPMessage): void {\n    console.debug(\"收到 MCP 消息:\", JSON.stringify(message, null, 2));\n\n    if (!message.method) {\n      console.debug(\"收到没有 method 字段的消息，忽略\");\n      return;\n    }\n\n    switch (message.method) {\n      case \"initialize\":\n      case \"notifications/initialized\":\n        this.sendResponse(message.id, {\n          protocolVersion: \"2024-11-05\",\n          capabilities: {\n            tools: { listChanged: true },\n            logging: {},\n          },\n          serverInfo: {\n            name: \"xiaozhi-mcp-server\",\n            version: \"1.0.0\",\n          },\n        });\n        this.serverInitialized = true;\n        console.debug(\"MCP 服务器初始化完成\");\n        break;\n\n      case \"tools/list\": {\n        const toolsList = this.getTools();\n        this.sendResponse(message.id, { tools: toolsList });\n        console.debug(`MCP 工具列表已发送 (${toolsList.length}个工具)`);\n        break;\n      }\n\n      case \"tools/call\": {\n        this.handleToolCall(message).catch((error) => {\n          console.error(\"处理工具调用时发生未捕获错误:\", error);\n        });\n        break;\n      }\n\n      case \"ping\":\n        this.sendResponse(message.id, {});\n        console.debug(\"回应 MCP ping 消息\");\n        break;\n\n      default:\n        console.warn(`未知的 MCP 请求: ${message.method}`);\n    }\n  }\n\n  /**\n   * 发送响应消息\n   */\n  private sendResponse(id: number | string, result: unknown): void {\n    console.debug(\n      `尝试发送响应: id=${id}, isConnected=${this.connectionStatus}, wsReadyState=${this.ws?.readyState}`\n    );\n\n    if (this.connectionStatus && this.ws?.readyState === WebSocket.OPEN) {\n      const response: ExtendedMCPMessage = {\n        jsonrpc: \"2.0\",\n        id,\n        result,\n      };\n\n      try {\n        this.ws.send(JSON.stringify(response));\n        console.debug(\"响应已发送\", {\n          id,\n          responseSize: JSON.stringify(response).length,\n        });\n      } catch (error) {\n        console.error(\"发送响应失败\", {\n          id,\n          error,\n        });\n      }\n    } else {\n      console.error(\"无法发送响应\", {\n        id,\n        isConnected: this.connectionStatus,\n        wsReadyState: this.ws?.readyState,\n      });\n    }\n  }\n\n  /**\n   * 获取服务器状态\n   */\n  public getStatus(): EndpointConnectionStatus {\n    const availableTools = this.mcpAdapter.getAllTools().length;\n\n    return {\n      connected: this.connectionStatus,\n      initialized: this.serverInitialized,\n      url: this.endpointUrl,\n      availableTools,\n      connectionState: this.connectionState,\n      lastError: this.lastError,\n    };\n  }\n\n  /**\n   * 检查连接状态\n   */\n  public isConnected(): boolean {\n    return this.connectionStatus;\n  }\n\n  /**\n   * 主动断开小智连接\n   */\n  public async disconnect(): Promise<void> {\n    console.info(\"主动断开小智连接\");\n\n    // 清理 MCP 适配器\n    await this.mcpAdapter.cleanup();\n\n    // 清理 WebSocket 连接\n    this.cleanupConnection();\n  }\n\n  /**\n   * 重连小智接入点\n   */\n  public async reconnect(): Promise<void> {\n    console.info(`重连小智接入点: ${sliceEndpoint(this.endpointUrl)}`);\n\n    // 先断开连接\n    this.disconnect();\n\n    // 等待可配置的时间确保连接完全断开\n    await new Promise((resolve) => setTimeout(resolve, this.reconnectDelay));\n\n    // 重新连接\n    await this.connect();\n  }\n\n  /**\n   * 处理工具调用请求\n   */\n  private async handleToolCall(request: MCPMessage): Promise<void> {\n    if (request.id === undefined || request.id === null) {\n      throw new ToolCallErrorClass(\n        ToolCallErrorCodeEnum.INVALID_PARAMS,\n        \"请求 ID 不能为空\"\n      );\n    }\n\n    const requestId = request.id;\n    const startTime = Date.now();\n\n    try {\n      const params = validateToolCallParams(request.params);\n\n      console.info(\"开始处理工具调用\", {\n        requestId,\n        toolName: params.name,\n        hasArguments: !!params.arguments,\n      });\n\n      const result = await this.executeToolWithTimeout(\n        params.name,\n        params.arguments || {},\n        this.toolCallTimeout\n      );\n\n      this.sendResponse(requestId, {\n        content: result.content || [\n          { type: \"text\", text: JSON.stringify(result) },\n        ],\n        isError: result.isError || false,\n      });\n\n      console.info(\"工具调用成功\", {\n        requestId,\n        toolName: params.name,\n        duration: `${Date.now() - startTime}ms`,\n      });\n    } catch (error) {\n      this.handleToolCallError(error, requestId, Date.now() - startTime);\n    }\n  }\n\n  /**\n   * 带超时控制的工具执行\n   */\n  private async executeToolWithTimeout(\n    toolName: string,\n    arguments_: Record<string, unknown>,\n    timeoutMs = 30000\n  ): Promise<ToolCallResult> {\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        reject(\n          new ToolCallErrorClass(\n            ToolCallErrorCodeEnum.TIMEOUT,\n            `工具调用超时 (${timeoutMs}ms): ${toolName}`\n          )\n        );\n      }, timeoutMs);\n\n      this.mcpAdapter\n        .callTool(toolName, arguments_)\n        .then((result: ToolCallResult) => {\n          clearTimeout(timeoutId);\n          resolve(result);\n        })\n        .catch((error: unknown) => {\n          clearTimeout(timeoutId);\n\n          const errorMessage =\n            error instanceof Error ? error.message : String(error);\n\n          if (errorMessage.includes(\"未找到工具\")) {\n            reject(\n              new ToolCallErrorClass(\n                ToolCallErrorCodeEnum.TOOL_NOT_FOUND,\n                `工具不存在: ${toolName}`\n              )\n            );\n          } else {\n            reject(\n              new ToolCallErrorClass(\n                ToolCallErrorCodeEnum.TOOL_EXECUTION_ERROR,\n                `工具执行失败: ${errorMessage}`\n              )\n            );\n          }\n        });\n    });\n  }\n\n  /**\n   * 处理工具调用错误\n   */\n  private handleToolCallError(\n    error: unknown,\n    requestId: string | number | undefined,\n    duration: number\n  ): void {\n    let errorResponse: {\n      code: number;\n      message: string;\n      data?: unknown;\n    };\n\n    if (error instanceof ToolCallErrorClass) {\n      errorResponse = {\n        code: error.code,\n        message: error.message,\n        data: error.data,\n      };\n    } else {\n      const errorMessage = error instanceof Error ? error.message : \"未知错误\";\n      errorResponse = {\n        code: ToolCallErrorCodeEnum.TOOL_EXECUTION_ERROR,\n        message: errorMessage,\n        data: { originalError: String(error) || \"null\" },\n      };\n    }\n\n    this.sendErrorResponse(requestId, errorResponse);\n\n    console.error(\"工具调用失败\", {\n      requestId,\n      duration: `${duration}ms`,\n      error: errorResponse,\n    });\n  }\n\n  /**\n   * 发送错误响应\n   */\n  private sendErrorResponse(\n    id: string | number | undefined,\n    error: { code: number; message: string; data?: unknown }\n  ): void {\n    if (this.connectionStatus && this.ws?.readyState === WebSocket.OPEN) {\n      const response = {\n        jsonrpc: \"2.0\",\n        id,\n        error,\n      };\n      this.ws.send(JSON.stringify(response));\n      console.debug(\"已发送错误响应:\", response);\n    }\n  }\n}\n","// =========================\n// 1. 工具调用相关类型\n// =========================\n\n/**\n * 工具调用结果接口\n */\nexport interface ToolCallResult {\n  content: Array<{\n    type: string;\n    text: string;\n  }>;\n  isError?: boolean;\n}\n\n/**\n * 工具调用参数接口\n */\nexport interface ToolCallParams {\n  name: string;\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * 验证后的工具调用参数\n */\nexport interface ValidatedToolCallParams {\n  name: string;\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * 工具调用错误码枚举\n */\nexport enum ToolCallErrorCode {\n  /** 无效参数 */\n  INVALID_PARAMS = -32602,\n  /** 工具不存在 */\n  TOOL_NOT_FOUND = -32601,\n  /** 服务不可用 */\n  SERVICE_UNAVAILABLE = -32001,\n  /** 调用超时 */\n  TIMEOUT = -32002,\n  /** 工具执行错误 */\n  TOOL_EXECUTION_ERROR = -32000,\n}\n\n/**\n * 工具调用错误类\n */\nexport class ToolCallError extends Error {\n  constructor(\n    public code: ToolCallErrorCode,\n    message: string,\n    public data?: unknown\n  ) {\n    super(message);\n    this.name = \"ToolCallError\";\n  }\n}\n\n// =========================\n// 2. JSON Schema 类型\n// =========================\n\n/**\n * JSON Schema 类型定义\n * 兼容 MCP SDK 的 JSON Schema 格式\n */\nexport type JSONSchema =\n  | (Record<string, unknown> & {\n      type: \"object\";\n      properties?: Record<string, unknown>;\n      required?: string[];\n      additionalProperties?: boolean;\n    })\n  | Record<string, unknown>;\n\n/**\n * 确保对象符合 MCP Tool JSON Schema 格式\n * 返回类型兼容 MCP SDK 的 Tool 类型\n */\nexport function ensureToolJSONSchema(schema: JSONSchema): {\n  type: \"object\";\n  properties?: Record<string, object>;\n  required?: string[];\n  additionalProperties?: boolean;\n} {\n  if (\n    typeof schema === \"object\" &&\n    schema !== null &&\n    \"type\" in schema &&\n    schema.type === \"object\"\n  ) {\n    return schema as {\n      type: \"object\";\n      properties?: Record<string, object>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n  }\n\n  // 如果不符合标准格式，返回默认的空对象 schema\n  return {\n    type: \"object\",\n    properties: {},\n    required: [],\n    additionalProperties: true,\n  };\n}\n\n// =========================\n// 3. 工具信息类型\n// =========================\n\n/**\n * 增强的工具信息接口\n * 包含工具的启用状态和使用统计信息\n */\nexport interface EnhancedToolInfo {\n  /** 工具唯一标识符，格式为 \"{serviceName}__{originalName}\" */\n  name: string;\n\n  /** 工具描述信息 */\n  description: string;\n\n  /** 工具输入参数的 JSON Schema 定义 */\n  inputSchema: JSONSchema;\n\n  /** 工具所属的 MCP 服务名称 */\n  serviceName: string;\n\n  /** 工具在 MCP 服务中的原始名称 */\n  originalName: string;\n\n  /** 工具是否启用 */\n  enabled: boolean;\n\n  /** 工具使用次数统计 */\n  usageCount: number;\n\n  /** 工具最后使用时间 (ISO 8601 格式字符串) */\n  lastUsedTime: string;\n}\n\n/**\n * MCP 服务管理器接口\n * 用于工具调用，避免循环依赖\n */\nexport interface IMCPServiceManager {\n  /** 获取所有工具列表 */\n  getAllTools(): EnhancedToolInfo[];\n\n  /** 调用工具 */\n  callTool(\n    toolName: string,\n    arguments_: Record<string, unknown>\n  ): Promise<ToolCallResult>;\n}\n\n// =========================\n// 4. 连接状态类型\n// =========================\n\n/**\n * 连接状态枚举\n */\nexport enum ConnectionState {\n  DISCONNECTED = \"disconnected\",\n  CONNECTING = \"connecting\",\n  CONNECTED = \"connected\",\n  FAILED = \"failed\",\n}\n\n/**\n * 连接选项接口\n */\nexport interface ConnectionOptions {\n  /** 连接超时时间（毫秒），默认 10000 */\n  connectionTimeout?: number;\n  /** 重连延迟时间（毫秒），默认 2000 */\n  reconnectDelay?: number;\n}\n\n// =========================\n// 5. EndpointConnection 状态类型\n// =========================\n\n/**\n * EndpointConnection 状态接口\n */\nexport interface EndpointConnectionStatus {\n  /** 是否已连接 */\n  connected: boolean;\n  /** 是否已初始化 */\n  initialized: boolean;\n  /** 接入点 URL */\n  url: string;\n  /** 可用工具数量 */\n  availableTools: number;\n  /** 连接状态 */\n  connectionState: ConnectionState;\n  /** 最后一次错误信息 */\n  lastError: string | null;\n}\n\n// =========================\n// 6. EndpointManager 状态类型\n// =========================\n\n/**\n * 简单连接状态接口\n */\nexport interface SimpleConnectionStatus {\n  /** 接入点地址 */\n  endpoint: string;\n  /** 是否已连接 */\n  connected: boolean;\n  /** 是否已初始化 */\n  initialized: boolean;\n  /** 最后连接时间 */\n  lastConnected?: Date;\n  /** 最后错误信息 */\n  lastError?: string;\n}\n\n/**\n * 完整连接状态接口（扩展 SimpleConnectionStatus）\n */\nexport interface ConnectionStatus extends SimpleConnectionStatus {\n  // 扩展字段可以在这里添加\n}\n\n/**\n * 配置变更事件类型\n */\nexport interface ConfigChangeEvent {\n  type:\n    | \"endpoints_added\"\n    | \"endpoints_removed\"\n    | \"endpoints_updated\"\n    | \"options_updated\";\n  data: {\n    added?: string[];\n    removed?: string[];\n    updated?: string[];\n    oldOptions?: Partial<ConnectionOptions>;\n    newOptions?: Partial<ConnectionOptions>;\n  };\n  timestamp: Date;\n}\n\n/**\n * 重连结果接口\n */\nexport interface ReconnectResult {\n  successCount: number;\n  failureCount: number;\n  results: Array<{\n    endpoint: string;\n    success: boolean;\n    error?: string;\n  }>;\n}\n\n// =========================\n// 7. 新 API 配置类型\n// =========================\n\n/**\n * MCP 服务器配置类型\n * 支持三种配置方式：\n * 1. 本地命令 (stdio): { command: string; args: string[]; env?: Record<string, string> }\n * 2. SSE: { type: \"sse\"; url: string; headers?: Record<string, string> }\n * 3. Streamable HTTP: { type?: \"streamable-http\"; url: string; headers?: Record<string, string> }\n */\nexport type MCPServerConfig =\n  | LocalMCPServerConfig\n  | SSEMCPServerConfig\n  | StreamableHTTPMCPServerConfig;\n\n/**\n * 本地 MCP 服务器配置\n */\nexport interface LocalMCPServerConfig {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\n/**\n * SSE MCP 服务器配置\n */\nexport interface SSEMCPServerConfig {\n  type: \"sse\";\n  url: string;\n  headers?: Record<string, string>;\n}\n\n/**\n * Streamable HTTP MCP 服务器配置\n */\nexport interface StreamableHTTPMCPServerConfig {\n  type?: \"streamable-http\"; // 可选，默认就是 streamable-http\n  url: string;\n  headers?: Record<string, string>;\n}\n\n/**\n * Endpoint 配置接口\n * 用于新 API：直接在构造函数中传入 MCP 服务器配置\n */\nexport interface EndpointConfig {\n  /** MCP 服务器配置（声明式） */\n  mcpServers: Record<string, MCPServerConfig>;\n  /** 可选：重连延迟（毫秒），默认 2000 */\n  reconnectDelay?: number;\n  /** 可选：ModelScope API Key（全局） */\n  modelscopeApiKey?: string;\n}\n\n/**\n * EndpointManager 配置接口（新 API 简化版）\n */\nexport interface EndpointManagerConfig {\n  /** 可选：默认重连延迟（毫秒） */\n  defaultReconnectDelay?: number;\n}\n","/**\n * 工具函数模块\n *\n * 内联的必要工具函数，确保包的独立性\n */\n\nimport type { ValidatedToolCallParams } from \"./types.js\";\n\n/**\n * 截断端点 URL 用于日志显示\n *\n * @param endpoint - 完整的端点 URL\n * @returns 截断后的 URL\n *\n * @example\n * ```typescript\n * sliceEndpoint(\"ws://very-long-endpoint-url-here.example.com/endpoint\")\n * // 返回: \"ws://very-long-endpoint-u...e.com/endpoint\"\n * ```\n */\nexport function sliceEndpoint(endpoint: string): string {\n  return `${endpoint.slice(0, 30)}...${endpoint.slice(-10)}`;\n}\n\n/**\n * 验证工具调用参数\n *\n * @param params - 待验证的参数\n * @returns 验证后的参数\n * @throws {Error} 如果参数无效\n *\n * @example\n * ```typescript\n * const params = validateToolCallParams({\n *   name: \"test_tool\",\n *   arguments: { foo: \"bar\" }\n * });\n * ```\n */\nexport function validateToolCallParams(\n  params: unknown\n): ValidatedToolCallParams {\n  // 基础类型检查\n  if (!params || typeof params !== \"object\") {\n    throw new Error(\"工具调用参数必须是对象\");\n  }\n\n  const p = params as Record<string, unknown>;\n\n  // 验证工具名称\n  if (!p.name || typeof p.name !== \"string\") {\n    throw new Error(\"工具名称必须是字符串\");\n  }\n\n  // 构建验证后的参数\n  const validated: ValidatedToolCallParams = {\n    name: p.name,\n  };\n\n  // 验证参数（可选）\n  if (p.arguments !== undefined) {\n    if (typeof p.arguments !== \"object\" || p.arguments === null) {\n      throw new Error(\"工具参数必须是对象\");\n    }\n    validated.arguments = p.arguments as Record<string, unknown>;\n  }\n\n  return validated;\n}\n\n/**\n * 验证端点 URL 格式\n *\n * @param endpoint - 待验证的端点 URL\n * @returns 是否为有效的 WebSocket URL\n */\nexport function isValidEndpointUrl(endpoint: string): boolean {\n  if (!endpoint || typeof endpoint !== \"string\") {\n    return false;\n  }\n\n  if (!endpoint.startsWith(\"ws://\") && !endpoint.startsWith(\"wss://\")) {\n    return false;\n  }\n\n  try {\n    new URL(endpoint);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * 检查属性名是否安全，防止原型污染攻击\n *\n * @param key - 待检查的属性名\n * @returns 是否为安全的属性名\n *\n * @example\n * ```typescript\n * isSafeKey(\"name\") // true\n * isSafeKey(\"__proto__\") // false\n * isSafeKey(\"constructor\") // false\n * ```\n */\nfunction isSafeKey(key: string): boolean {\n  // 拒绝已知的危险属性名\n  const dangerousKeys = [\"__proto__\", \"constructor\", \"prototype\"];\n  if (dangerousKeys.includes(key)) {\n    return false;\n  }\n\n  // 确保属性名是普通的字符串（不是 Symbol 等）\n  return typeof key === \"string\" && key.length > 0;\n}\n\n/**\n * 深度合并对象\n *\n * @param target - 目标对象\n * @param sources - 源对象\n * @returns 合并后的对象\n *\n * @example\n * ```typescript\n * const result = deepMerge(\n *   { a: 1, b: { x: 1 } },\n *   { b: { y: 2 }, c: 3 }\n * );\n * // 返回: { a: 1, b: { x: 1, y: 2 }, c: 3 }\n * ```\n */\nexport function deepMerge<T>(\n  target: Partial<T>,\n  ...sources: Array<Partial<T>>\n): T {\n  if (sources.length === 0) {\n    return target as T;\n  }\n\n  const source = sources.shift();\n\n  if (source === undefined) {\n    return target as T;\n  }\n\n  // 使用 Object.keys() 替代 for...in，只遍历对象自身的可枚举属性\n  const keys = Object.keys(source as Record<string, unknown>);\n\n  for (const key of keys) {\n    // 跳过不安全的 key，防止原型污染攻击\n    if (!isSafeKey(key)) {\n      continue;\n    }\n\n    const sourceValue = (source as Record<string, unknown>)[key];\n    const targetValue = (target as Record<string, unknown>)[key];\n\n    if (\n      typeof sourceValue === \"object\" &&\n      sourceValue !== null &&\n      !Array.isArray(sourceValue) &&\n      typeof targetValue === \"object\" &&\n      targetValue !== null &&\n      !Array.isArray(targetValue)\n    ) {\n      (target as Record<string, unknown>)[key] = deepMerge(\n        targetValue as Record<string, unknown>,\n        sourceValue as Record<string, unknown>\n      );\n    } else {\n      (target as Record<string, unknown>)[key] = sourceValue;\n    }\n  }\n\n  return deepMerge(target, ...sources);\n}\n\n/**\n * 延迟执行\n *\n * @param ms - 延迟时间（毫秒）\n * @returns Promise\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * 格式化错误消息\n *\n * @param error - 错误对象\n * @returns 格式化后的错误消息\n */\nexport function formatErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  return String(error);\n}\n","/**\n * 内部 MCP 服务管理器适配器\n * 将 mcpServers 配置转换为 IMCPServiceManager 接口\n * 使用 @xiaozhi-client/mcp-core 的 MCPManager 实现真实的 MCP 功能\n */\n\nimport { MCPManager } from \"@xiaozhi-client/mcp-core\";\nimport type { MCPServiceConfig } from \"@xiaozhi-client/mcp-core\";\nimport type { EnhancedToolInfo, ToolCallResult } from \"./types.js\";\nimport type { IMCPServiceManager } from \"./types.js\";\nimport type { EndpointConfig, MCPServerConfig } from \"./types.js\";\nimport { convertLegacyToNew } from \"@xiaozhi-client/config\";\n\n/**\n * 内部 MCP 服务管理器适配器\n * 实现 IMCPServiceManager 接口，使用真正的 MCPManager\n */\nexport class InternalMCPManagerAdapter implements IMCPServiceManager {\n  private mcpManager: MCPManager;\n  private tools: Map<string, EnhancedToolInfo> = new Map();\n  private isInitialized = false;\n\n  constructor(private config: EndpointConfig) {\n    this.mcpManager = new MCPManager();\n\n    // 转换配置并添加到 MCPManager\n    for (const [serviceName, serverConfig] of Object.entries(\n      config.mcpServers\n    )) {\n      const mcpConfig = this.convertToMCPServiceConfig(serviceName, serverConfig);\n      this.mcpManager.addServer(serviceName, mcpConfig);\n    }\n\n    // 设置事件监听\n    this.mcpManager.on(\"connected\", (data) => {\n      console.info(\n        `MCP 服务 ${data.serverName} 已连接，工具数: ${data.tools.length}`\n      );\n    });\n\n    this.mcpManager.on(\"error\", (data) => {\n      console.error(`MCP 服务 ${data.serverName} 出错:`, data.error);\n    });\n  }\n\n  /**\n   * 初始化并启动所有 MCP 服务\n   */\n  async initialize(): Promise<void> {\n    if (this.isInitialized) {\n      return;\n    }\n\n    // 连接所有 MCP 服务\n    await this.mcpManager.connect();\n\n    // 刷新工具列表\n    await this.refreshTools();\n\n    this.isInitialized = true;\n  }\n\n  /**\n   * 获取所有工具列表\n   */\n  getAllTools(): EnhancedToolInfo[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * 调用工具（真实实现）\n   */\n  async callTool(\n    toolName: string,\n    arguments_: Record<string, unknown>\n  ): Promise<ToolCallResult> {\n    // 解析工具名称：serviceName__toolName\n    const [serviceName, actualToolName] = this.parseToolName(toolName);\n\n    // 调用真实的 MCP 工具\n    return this.mcpManager.callTool(serviceName, actualToolName, arguments_);\n  }\n\n  /**\n   * 清理资源\n   */\n  async cleanup(): Promise<void> {\n    await this.mcpManager.disconnect();\n    this.tools.clear();\n    this.isInitialized = false;\n  }\n\n  /**\n   * 刷新工具列表\n   */\n  private async refreshTools(): Promise<void> {\n    this.tools.clear();\n\n    const mcpTools = this.mcpManager.listTools();\n\n    for (const mcpTool of mcpTools) {\n      const enhancedTool: EnhancedToolInfo = {\n        name: `${mcpTool.serverName}__${mcpTool.name}`,\n        description: mcpTool.description,\n        inputSchema: mcpTool.inputSchema as any,\n        serviceName: mcpTool.serverName,\n        originalName: mcpTool.name,\n        enabled: true,\n        usageCount: 0,\n        lastUsedTime: new Date().toISOString(),\n      };\n      this.tools.set(enhancedTool.name, enhancedTool);\n    }\n  }\n\n  /**\n   * 解析工具名称\n   */\n  private parseToolName(toolName: string): [string, string] {\n    const parts = toolName.split(\"__\");\n    if (parts.length < 2) {\n      throw new Error(`无效的工具名称格式: ${toolName}`);\n    }\n    const serviceName = parts[0];\n    const actualToolName = parts.slice(1).join(\"__\"); // 支持工具名中包含 __\n    return [serviceName, actualToolName];\n  }\n\n  /**\n   * 将 MCPServerConfig 转换为 MCPServiceConfig\n   * 使用统一的配置适配器，确保路径解析逻辑一致\n   */\n  private convertToMCPServiceConfig(\n    serviceName: string,\n    config: MCPServerConfig\n  ): Omit<MCPServiceConfig, \"name\"> {\n    // 使用统一的转换函数，自动处理相对路径解析\n    // convertLegacyToNew 会：\n    // 1. 解析 command 中的相对路径（相对于配置文件目录）\n    // 2. 解析 args 中的相对路径\n    // 3. 返回带有 name 字段的完整配置\n    const converted = convertLegacyToNew(serviceName, config);\n\n    // 移除 name 字段（因为 InternalMCPManagerAdapter 不需要）\n    const { name, ...rest } = converted;\n\n    return rest;\n  }\n}\n","/**\n * EndpointManager（新 API）\n * 管理多个小智接入点的连接，每个小智接入点独立运行\n *\n * 与旧 EndpointManager 的区别：\n * - 使用 addEndpoint(endpoint) 添加 Endpoint 实例\n * - 不需要 initialize() 和 setServiceManager()\n * - 配置更简洁直观\n */\n\nimport { EventEmitter } from \"node:events\";\nimport type { Endpoint } from \"./endpoint.js\";\nimport type { EndpointManagerConfig, SimpleConnectionStatus } from \"./types.js\";\nimport { sliceEndpoint } from \"./utils.js\";\n\n/**\n * 小智接入点管理器（新 API）\n * 负责管理多个小智接入点的连接\n */\nexport class EndpointManager extends EventEmitter {\n  private endpoints: Map<string, Endpoint> = new Map();\n  private connectionStates: Map<string, SimpleConnectionStatus> = new Map();\n\n  /**\n   * 构造函数\n   *\n   * @param config - 可选的配置\n   */\n  constructor(private config?: EndpointManagerConfig) {\n    super();\n    console.debug(\"[EndpointManager] 实例已创建（新 API）\");\n  }\n\n  /**\n   * 添加 Endpoint 实例\n   *\n   * @param endpoint - Endpoint 实例\n   */\n  addEndpoint(endpoint: Endpoint): void {\n    const url = endpoint.getUrl();\n\n    if (this.endpoints.has(url)) {\n      console.debug(\n        `[EndpointManager] 接入点 ${sliceEndpoint(url)} 已存在，跳过添加`\n      );\n      return;\n    }\n\n    console.debug(`[EndpointManager] 添加接入点: ${sliceEndpoint(url)}`);\n\n    this.endpoints.set(url, endpoint);\n    this.connectionStates.set(url, {\n      endpoint: url,\n      connected: false,\n      initialized: false,\n    });\n\n    // 发射事件\n    this.emit(\"endpointAdded\", { endpoint: url });\n  }\n\n  /**\n   * 移除 Endpoint 实例\n   *\n   * @param endpoint - Endpoint 实例\n   */\n  removeEndpoint(endpoint: Endpoint): void {\n    const url = endpoint.getUrl();\n\n    if (!this.endpoints.has(url)) {\n      console.debug(\n        `[EndpointManager] 接入点 ${sliceEndpoint(url)} 不存在，跳过移除`\n      );\n      return;\n    }\n\n    console.debug(`[EndpointManager] 移除接入点: ${sliceEndpoint(url)}`);\n\n    // 断开连接\n    endpoint.disconnect();\n\n    // 清理状态\n    this.endpoints.delete(url);\n    this.connectionStates.delete(url);\n\n    // 发射事件\n    this.emit(\"endpointRemoved\", { endpoint: url });\n  }\n\n  /**\n   * 连接所有 Endpoint\n   */\n  async connect(): Promise<void> {\n    console.debug(`[EndpointManager] 开始连接所有接入点，总数: ${this.endpoints.size}`);\n\n    const promises: Promise<void>[] = [];\n\n    for (const [url, endpoint] of this.endpoints) {\n      promises.push(\n        this.connectSingleEndpoint(url, endpoint).catch((error) => {\n          console.error(`[EndpointManager] 连接失败: ${sliceEndpoint(url)}`, error);\n          // 更新失败状态\n          const status = this.connectionStates.get(url);\n          if (status) {\n            status.connected = false;\n            status.initialized = false;\n            status.lastError = error instanceof Error ? error.message : String(error);\n          }\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n\n    // 统计连接结果\n    const connectedCount = Array.from(this.connectionStates.values()).filter(\n      (s) => s.connected\n    ).length;\n\n    console.info(`[EndpointManager] 连接完成: 成功 ${connectedCount}/${this.endpoints.size}`);\n  }\n\n  /**\n   * 断开所有连接\n   */\n  async disconnect(): Promise<void> {\n    console.debug(\"[EndpointManager] 开始断开所有连接\");\n\n    const promises: Promise<void>[] = [];\n\n    for (const endpoint of this.endpoints.values()) {\n      promises.push(\n        Promise.resolve().then(() => {\n          endpoint.disconnect();\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n\n    // 重置所有状态\n    for (const status of this.connectionStates.values()) {\n      status.connected = false;\n      status.initialized = false;\n    }\n\n    console.debug(\"[EndpointManager] 所有接入点已断开连接\");\n  }\n\n  /**\n   * 获取所有 Endpoint URL\n   */\n  getEndpoints(): string[] {\n    return Array.from(this.endpoints.keys());\n  }\n\n  /**\n   * 获取指定 Endpoint 实例\n   *\n   * @param url - Endpoint URL\n   */\n  getEndpoint(url: string): Endpoint | undefined {\n    return this.endpoints.get(url);\n  }\n\n  /**\n   * 获取所有连接状态\n   */\n  getConnectionStatus(): SimpleConnectionStatus[] {\n    return Array.from(this.connectionStates.values());\n  }\n\n  /**\n   * 检查是否有任何连接处于连接状态\n   */\n  isAnyConnected(): boolean {\n    for (const status of this.connectionStates.values()) {\n      if (status.connected) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * 检查指定端点是否已连接\n   *\n   * @param url - 端点 URL\n   */\n  isEndpointConnected(url: string): boolean {\n    const status = this.connectionStates.get(url);\n    return status?.connected ?? false;\n  }\n\n  /**\n   * 获取指定端点的状态\n   *\n   * @param url - 端点 URL\n   */\n  getEndpointStatus(url: string): SimpleConnectionStatus | undefined {\n    return this.connectionStates.get(url);\n  }\n\n  /**\n   * 重连所有端点\n   */\n  async reconnectAll(): Promise<void> {\n    console.info(\"[EndpointManager] 开始重连所有接入点\");\n\n    const promises: Promise<void>[] = [];\n\n    for (const [url, endpoint] of this.endpoints) {\n      promises.push(\n        this.reconnectSingleEndpoint(url, endpoint).catch((error) => {\n          console.error(`[EndpointManager] 重连失败: ${sliceEndpoint(url)}`, error);\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * 重连指定的端点\n   *\n   * @param url - 要重连的端点 URL\n   */\n  async reconnectEndpoint(url: string): Promise<void> {\n    const endpoint = this.endpoints.get(url);\n    if (!endpoint) {\n      throw new Error(`接入点不存在: ${sliceEndpoint(url)}`);\n    }\n\n    await this.reconnectSingleEndpoint(url, endpoint);\n  }\n\n  /**\n   * 清除所有端点\n   */\n  async clearEndpoints(): Promise<void> {\n    console.debug(\"[EndpointManager] 清除所有接入点\");\n\n    await this.disconnect();\n\n    this.endpoints.clear();\n    this.connectionStates.clear();\n\n    console.info(\"[EndpointManager] 所有接入点已清除\");\n  }\n\n  /**\n   * 清理资源\n   */\n  async cleanup(): Promise<void> {\n    console.debug(\"[EndpointManager] 开始清理资源\");\n\n    await this.clearEndpoints();\n\n    console.debug(\"[EndpointManager] 资源清理完成\");\n  }\n\n  // ==================== 私有方法 ====================\n\n  /**\n   * 连接单个端点\n   */\n  private async connectSingleEndpoint(\n    url: string,\n    endpoint: Endpoint\n  ): Promise<void> {\n    const status = this.connectionStates.get(url);\n    if (!status) {\n      throw new Error(`端点状态不存在: ${sliceEndpoint(url)}`);\n    }\n\n    console.debug(`[EndpointManager] 连接端点: ${sliceEndpoint(url)}`);\n\n    // 更新状态为连接中\n    status.connected = false;\n    status.initialized = false;\n\n    // 执行连接\n    await endpoint.connect();\n\n    // 更新连接成功状态\n    status.connected = true;\n    status.initialized = true;\n    status.lastConnected = new Date();\n    status.lastError = undefined;\n\n    console.info(`[EndpointManager] 端点连接成功: ${sliceEndpoint(url)}`);\n  }\n\n  /**\n   * 重连单个端点\n   */\n  private async reconnectSingleEndpoint(\n    url: string,\n    endpoint: Endpoint\n  ): Promise<void> {\n    const status = this.connectionStates.get(url);\n    if (!status) {\n      throw new Error(`端点状态不存在: ${sliceEndpoint(url)}`);\n    }\n\n    console.debug(`[EndpointManager] 重连端点: ${sliceEndpoint(url)}`);\n\n    // 执行重连\n    await endpoint.reconnect();\n\n    // 更新连接成功状态\n    status.connected = true;\n    status.initialized = true;\n    status.lastConnected = new Date();\n    status.lastError = undefined;\n\n    console.info(`[EndpointManager] 端点重连成功: ${sliceEndpoint(url)}`);\n  }\n}\n"],"mappings":"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","names":["ToolCallErrorCode","ConnectionState"]}
+{"version":3,"sources":["../src/endpoint.ts","../src/types.ts","../src/utils.ts","../src/manager.ts","../src/shared-mcp-adapter.ts"],"sourcesContent":["/**\n * Endpoint 类\n * 管理单个小智接入点的 WebSocket 连接\n * 实现 MCP (Model Context Protocol) 协议通信\n *\n * 使用方式：\n * ```typescript\n * const mcpManager = new SharedMCPAdapter(globalMCPManager);\n * const endpoint = new Endpoint(\"ws://...\", mcpManager);\n * await endpoint.connect();\n * ```\n */\n\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport WebSocket from \"ws\";\nimport type { ExtendedMCPMessage, MCPMessage } from \"./mcp.js\";\nimport type {\n  IMCPServiceManager,\n  EndpointConnectionStatus,\n  ToolCallResult,\n} from \"./types.js\";\nimport {\n  ConnectionState,\n  ToolCallError as ToolCallErrorClass,\n  ToolCallErrorCode as ToolCallErrorCodeEnum,\n  ensureToolJSONSchema as ensureToolJSONSchemaFn,\n} from \"./types.js\";\nimport { validateToolCallParams } from \"./utils.js\";\nimport { sliceEndpoint } from \"./utils.js\";\n\n// 导出错误类型供外部使用\nexport {\n  ToolCallErrorCodeEnum as ToolCallErrorCode,\n  ToolCallErrorClass as ToolCallError,\n};\n\n/**\n * Endpoint 类\n * 负责管理单个小智接入点的 WebSocket 连接\n * 使用新的配置方式：直接在构造函数中传入 mcpServers 配置\n */\nexport class Endpoint {\n  private endpointUrl: string;\n  private ws: WebSocket | null = null;\n  private connectionStatus = false;\n  private serverInitialized = false;\n  private mcpAdapter: IMCPServiceManager;\n\n  // 连接状态管理\n  private connectionState: ConnectionState = ConnectionState.DISCONNECTED;\n\n  // 最后一次错误信息\n  private lastError: string | null = null;\n\n  // 连接超时定时器\n  private connectionTimeout: NodeJS.Timeout | null = null;\n\n  // 工具调用超时配置\n  private toolCallTimeout = 30000;\n  private reconnectDelay: number; // 重连延迟（毫秒）\n\n  /**\n   * 构造函数\n   *\n   * @param endpointUrl - 小智接入点 URL\n   * @param mcpManager - MCP 服务管理器（依赖注入）\n   * @param reconnectDelay - 可选的重连延迟（毫秒）\n   */\n  constructor(\n    endpointUrl: string,\n    mcpManager: IMCPServiceManager,\n    reconnectDelay?: number\n  ) {\n    this.endpointUrl = endpointUrl;\n    this.reconnectDelay = reconnectDelay ?? 2000;\n\n    // 使用注入的 MCP 管理器\n    this.mcpAdapter = mcpManager;\n  }\n\n  /**\n   * 获取 Endpoint URL\n   */\n  getUrl(): string {\n    return this.endpointUrl;\n  }\n\n  /**\n   * 获取当前所有工具列表\n   */\n  getTools(): Tool[] {\n    try {\n      const allTools = this.mcpAdapter.getAllTools();\n\n      return allTools.map((toolInfo) => ({\n        name: toolInfo.name,\n        description: toolInfo.description,\n        inputSchema: ensureToolJSONSchemaFn(toolInfo.inputSchema),\n      }));\n    } catch (error) {\n      console.error(\n        `获取工具列表失败: ${error instanceof Error ? error.message : String(error)}`\n      );\n      return [];\n    }\n  }\n\n  /**\n   * 连接小智接入点\n   */\n  public async connect(): Promise<void> {\n    // 初始化 MCP 适配器\n    await this.mcpAdapter.initialize();\n\n    // 如果正在连接中，等待当前连接完成\n    if (this.connectionState === ConnectionState.CONNECTING) {\n      throw new Error(\"连接正在进行中，请等待连接完成\");\n    }\n\n    // 清理之前的连接\n    this.cleanupConnection();\n\n    return this.attemptConnection();\n  }\n\n  /**\n   * 尝试建立连接\n   */\n  private async attemptConnection(): Promise<void> {\n    this.connectionState = ConnectionState.CONNECTING;\n    console.debug(`正在连接小智接入点: ${sliceEndpoint(this.endpointUrl)}`);\n\n    return new Promise((resolve, reject) => {\n      // 设置连接超时\n      this.connectionTimeout = setTimeout(() => {\n        const error = new Error(\"连接超时 (10000ms)\");\n        this.handleConnectionError(error);\n        reject(error);\n      }, 10000);\n\n      this.ws = new WebSocket(this.endpointUrl);\n\n      this.ws.on(\"open\", () => {\n        this.handleConnectionSuccess();\n        resolve();\n      });\n\n      this.ws.on(\"message\", (data) => {\n        try {\n          const message: MCPMessage = JSON.parse(data.toString());\n          this.handleMessage(message);\n        } catch (error) {\n          console.error(\"MCP 消息解析错误:\", error);\n        }\n      });\n\n      this.ws.on(\"close\", (code, reason) => {\n        this.handleConnectionClose(code, reason.toString());\n      });\n\n      this.ws.on(\"error\", (error) => {\n        this.handleConnectionError(error);\n        reject(error);\n      });\n    });\n  }\n\n  /**\n   * 处理连接成功\n   */\n  private handleConnectionSuccess(): void {\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    this.connectionStatus = true;\n    this.connectionState = ConnectionState.CONNECTED;\n\n    console.debug(\"MCP WebSocket 连接已建立\");\n  }\n\n  /**\n   * 处理连接错误\n   */\n  private handleConnectionError(error: Error): void {\n    // 记录最后一次错误信息\n    this.lastError = error.message;\n\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    console.error(\"MCP WebSocket 错误:\", error.message);\n\n    // 清理当前连接\n    this.cleanupConnection();\n  }\n\n  /**\n   * 处理连接关闭\n   */\n  private handleConnectionClose(code: number, reason: string): void {\n    this.connectionStatus = false;\n    this.serverInitialized = false;\n    this.connectionState = ConnectionState.DISCONNECTED;\n    console.info(`小智连接已关闭 (代码: ${code}, 原因: ${reason})`);\n  }\n\n  /**\n   * 清理连接资源\n   */\n  private cleanupConnection(): void {\n    // 清理 WebSocket\n    if (this.ws) {\n      this.ws.removeAllListeners();\n\n      try {\n        if (this.ws.readyState === WebSocket.OPEN) {\n          this.ws.close(1000, \"Cleaning up connection\");\n        } else if (this.ws.readyState === WebSocket.CONNECTING) {\n          this.ws.terminate();\n        }\n      } catch (error) {\n        console.debug(\"WebSocket 关闭时出现错误（已忽略）:\", error);\n      }\n\n      this.ws = null;\n    }\n\n    // 清理连接超时定时器\n    if (this.connectionTimeout) {\n      clearTimeout(this.connectionTimeout);\n      this.connectionTimeout = null;\n    }\n\n    // 重置连接状态\n    this.connectionStatus = false;\n    this.serverInitialized = false;\n\n    // 重置连接状态为已断开\n    this.connectionState = ConnectionState.DISCONNECTED;\n  }\n\n  /**\n   * 处理 MCP 消息\n   */\n  private handleMessage(message: MCPMessage): void {\n    console.debug(\"收到 MCP 消息:\", JSON.stringify(message, null, 2));\n\n    if (!message.method) {\n      console.debug(\"收到没有 method 字段的消息，忽略\");\n      return;\n    }\n\n    switch (message.method) {\n      case \"initialize\":\n      case \"notifications/initialized\":\n        this.sendResponse(message.id, {\n          protocolVersion: \"2024-11-05\",\n          capabilities: {\n            tools: { listChanged: true },\n            logging: {},\n          },\n          serverInfo: {\n            name: \"xiaozhi-mcp-server\",\n            version: \"1.0.0\",\n          },\n        });\n        this.serverInitialized = true;\n        console.debug(\"MCP 服务器初始化完成\");\n        break;\n\n      case \"tools/list\": {\n        const toolsList = this.getTools();\n        this.sendResponse(message.id, { tools: toolsList });\n        console.debug(`MCP 工具列表已发送 (${toolsList.length}个工具)`);\n        break;\n      }\n\n      case \"tools/call\": {\n        this.handleToolCall(message).catch((error) => {\n          console.error(\"处理工具调用时发生未捕获错误:\", error);\n        });\n        break;\n      }\n\n      case \"ping\":\n        this.sendResponse(message.id, {});\n        console.debug(\"回应 MCP ping 消息\");\n        break;\n\n      default:\n        console.warn(`未知的 MCP 请求: ${message.method}`);\n    }\n  }\n\n  /**\n   * 发送响应消息\n   */\n  private sendResponse(id: number | string, result: unknown): void {\n    console.debug(\n      `尝试发送响应: id=${id}, isConnected=${this.connectionStatus}, wsReadyState=${this.ws?.readyState}`\n    );\n\n    if (this.connectionStatus && this.ws?.readyState === WebSocket.OPEN) {\n      const response: ExtendedMCPMessage = {\n        jsonrpc: \"2.0\",\n        id,\n        result,\n      };\n\n      try {\n        this.ws.send(JSON.stringify(response));\n        console.debug(\"响应已发送\", {\n          id,\n          responseSize: JSON.stringify(response).length,\n        });\n      } catch (error) {\n        console.error(\"发送响应失败\", {\n          id,\n          error,\n        });\n      }\n    } else {\n      console.error(\"无法发送响应\", {\n        id,\n        isConnected: this.connectionStatus,\n        wsReadyState: this.ws?.readyState,\n      });\n    }\n  }\n\n  /**\n   * 获取服务器状态\n   */\n  public getStatus(): EndpointConnectionStatus {\n    const availableTools = this.mcpAdapter.getAllTools().length;\n\n    return {\n      connected: this.connectionStatus,\n      initialized: this.serverInitialized,\n      url: this.endpointUrl,\n      availableTools,\n      connectionState: this.connectionState,\n      lastError: this.lastError,\n    };\n  }\n\n  /**\n   * 检查连接状态\n   */\n  public isConnected(): boolean {\n    return this.connectionStatus;\n  }\n\n  /**\n   * 主动断开小智连接\n   */\n  public async disconnect(): Promise<void> {\n    console.info(\"主动断开小智连接\");\n\n    // 清理 MCP 适配器\n    await this.mcpAdapter.cleanup();\n\n    // 清理 WebSocket 连接\n    this.cleanupConnection();\n  }\n\n  /**\n   * 重连小智接入点\n   */\n  public async reconnect(): Promise<void> {\n    console.info(`重连小智接入点: ${sliceEndpoint(this.endpointUrl)}`);\n\n    // 先断开连接\n    this.disconnect();\n\n    // 等待可配置的时间确保连接完全断开\n    await new Promise((resolve) => setTimeout(resolve, this.reconnectDelay));\n\n    // 重新连接\n    await this.connect();\n  }\n\n  /**\n   * 处理工具调用请求\n   */\n  private async handleToolCall(request: MCPMessage): Promise<void> {\n    if (request.id === undefined || request.id === null) {\n      throw new ToolCallErrorClass(\n        ToolCallErrorCodeEnum.INVALID_PARAMS,\n        \"请求 ID 不能为空\"\n      );\n    }\n\n    const requestId = request.id;\n    const startTime = Date.now();\n\n    try {\n      const params = validateToolCallParams(request.params);\n\n      console.info(\"开始处理工具调用\", {\n        requestId,\n        toolName: params.name,\n        hasArguments: !!params.arguments,\n      });\n\n      const result = await this.executeToolWithTimeout(\n        params.name,\n        params.arguments || {},\n        this.toolCallTimeout\n      );\n\n      this.sendResponse(requestId, {\n        content: result.content || [\n          { type: \"text\", text: JSON.stringify(result) },\n        ],\n        isError: result.isError || false,\n      });\n\n      console.info(\"工具调用成功\", {\n        requestId,\n        toolName: params.name,\n        duration: `${Date.now() - startTime}ms`,\n      });\n    } catch (error) {\n      this.handleToolCallError(error, requestId, Date.now() - startTime);\n    }\n  }\n\n  /**\n   * 带超时控制的工具执行\n   */\n  private async executeToolWithTimeout(\n    toolName: string,\n    arguments_: Record<string, unknown>,\n    timeoutMs = 30000\n  ): Promise<ToolCallResult> {\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        reject(\n          new ToolCallErrorClass(\n            ToolCallErrorCodeEnum.TIMEOUT,\n            `工具调用超时 (${timeoutMs}ms): ${toolName}`\n          )\n        );\n      }, timeoutMs);\n\n      this.mcpAdapter\n        .callTool(toolName, arguments_)\n        .then((result: ToolCallResult) => {\n          clearTimeout(timeoutId);\n          resolve(result);\n        })\n        .catch((error: unknown) => {\n          clearTimeout(timeoutId);\n\n          const errorMessage =\n            error instanceof Error ? error.message : String(error);\n\n          if (errorMessage.includes(\"未找到工具\")) {\n            reject(\n              new ToolCallErrorClass(\n                ToolCallErrorCodeEnum.TOOL_NOT_FOUND,\n                `工具不存在: ${toolName}`\n              )\n            );\n          } else {\n            reject(\n              new ToolCallErrorClass(\n                ToolCallErrorCodeEnum.TOOL_EXECUTION_ERROR,\n                `工具执行失败: ${errorMessage}`\n              )\n            );\n          }\n        });\n    });\n  }\n\n  /**\n   * 处理工具调用错误\n   */\n  private handleToolCallError(\n    error: unknown,\n    requestId: string | number | undefined,\n    duration: number\n  ): void {\n    let errorResponse: {\n      code: number;\n      message: string;\n      data?: unknown;\n    };\n\n    if (error instanceof ToolCallErrorClass) {\n      errorResponse = {\n        code: error.code,\n        message: error.message,\n        data: error.data,\n      };\n    } else {\n      const errorMessage = error instanceof Error ? error.message : \"未知错误\";\n      errorResponse = {\n        code: ToolCallErrorCodeEnum.TOOL_EXECUTION_ERROR,\n        message: errorMessage,\n        data: { originalError: String(error) || \"null\" },\n      };\n    }\n\n    this.sendErrorResponse(requestId, errorResponse);\n\n    console.error(\"工具调用失败\", {\n      requestId,\n      duration: `${duration}ms`,\n      error: errorResponse,\n    });\n  }\n\n  /**\n   * 发送错误响应\n   */\n  private sendErrorResponse(\n    id: string | number | undefined,\n    error: { code: number; message: string; data?: unknown }\n  ): void {\n    if (this.connectionStatus && this.ws?.readyState === WebSocket.OPEN) {\n      const response = {\n        jsonrpc: \"2.0\",\n        id,\n        error,\n      };\n      this.ws.send(JSON.stringify(response));\n      console.debug(\"已发送错误响应:\", response);\n    }\n  }\n}\n","// =========================\n// 1. 工具调用相关类型\n// =========================\n\n/**\n * 工具调用结果接口\n */\nexport interface ToolCallResult {\n  content: Array<{\n    type: string;\n    text: string;\n  }>;\n  isError?: boolean;\n}\n\n/**\n * 工具调用参数接口\n */\nexport interface ToolCallParams {\n  name: string;\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * 验证后的工具调用参数\n */\nexport interface ValidatedToolCallParams {\n  name: string;\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * 工具调用错误码枚举\n */\nexport enum ToolCallErrorCode {\n  /** 无效参数 */\n  INVALID_PARAMS = -32602,\n  /** 工具不存在 */\n  TOOL_NOT_FOUND = -32601,\n  /** 服务不可用 */\n  SERVICE_UNAVAILABLE = -32001,\n  /** 调用超时 */\n  TIMEOUT = -32002,\n  /** 工具执行错误 */\n  TOOL_EXECUTION_ERROR = -32000,\n}\n\n/**\n * 工具调用错误类\n */\nexport class ToolCallError extends Error {\n  constructor(\n    public code: ToolCallErrorCode,\n    message: string,\n    public data?: unknown\n  ) {\n    super(message);\n    this.name = \"ToolCallError\";\n  }\n}\n\n// =========================\n// 2. JSON Schema 类型\n// =========================\n\n/**\n * JSON Schema 类型定义\n * 兼容 MCP SDK 的 JSON Schema 格式\n */\nexport type JSONSchema =\n  | (Record<string, unknown> & {\n      type: \"object\";\n      properties?: Record<string, unknown>;\n      required?: string[];\n      additionalProperties?: boolean;\n    })\n  | Record<string, unknown>;\n\n/**\n * 确保对象符合 MCP Tool JSON Schema 格式\n * 返回类型兼容 MCP SDK 的 Tool 类型\n */\nexport function ensureToolJSONSchema(schema: JSONSchema): {\n  type: \"object\";\n  properties?: Record<string, object>;\n  required?: string[];\n  additionalProperties?: boolean;\n} {\n  if (\n    typeof schema === \"object\" &&\n    schema !== null &&\n    \"type\" in schema &&\n    schema.type === \"object\"\n  ) {\n    return schema as {\n      type: \"object\";\n      properties?: Record<string, object>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n  }\n\n  // 如果不符合标准格式，返回默认的空对象 schema\n  return {\n    type: \"object\",\n    properties: {},\n    required: [],\n    additionalProperties: true,\n  };\n}\n\n// =========================\n// 3. 工具信息类型\n// =========================\n\n/**\n * 增强的工具信息接口\n * 包含工具的启用状态和使用统计信息\n */\nexport interface EnhancedToolInfo {\n  /** 工具唯一标识符，格式为 \"{serviceName}__{originalName}\" */\n  name: string;\n\n  /** 工具描述信息 */\n  description: string;\n\n  /** 工具输入参数的 JSON Schema 定义 */\n  inputSchema: JSONSchema;\n\n  /** 工具所属的 MCP 服务名称 */\n  serviceName: string;\n\n  /** 工具在 MCP 服务中的原始名称 */\n  originalName: string;\n\n  /** 工具是否启用 */\n  enabled: boolean;\n\n  /** 工具使用次数统计 */\n  usageCount: number;\n\n  /** 工具最后使用时间 (ISO 8601 格式字符串) */\n  lastUsedTime: string;\n}\n\n/**\n * MCP 服务管理器接口\n * 用于工具调用，避免循环依赖\n */\nexport interface IMCPServiceManager {\n  /** 获取所有工具列表 */\n  getAllTools(): EnhancedToolInfo[];\n\n  /** 调用工具 */\n  callTool(\n    toolName: string,\n    arguments_: Record<string, unknown>\n  ): Promise<ToolCallResult>;\n\n  /** 初始化 */\n  initialize(): Promise<void>;\n\n  /** 清理资源 */\n  cleanup(): Promise<void>;\n}\n\n// =========================\n// 4. 连接状态类型\n// =========================\n\n/**\n * 连接状态枚举\n */\nexport enum ConnectionState {\n  DISCONNECTED = \"disconnected\",\n  CONNECTING = \"connecting\",\n  CONNECTED = \"connected\",\n  FAILED = \"failed\",\n}\n\n/**\n * 连接选项接口\n */\nexport interface ConnectionOptions {\n  /** 连接超时时间（毫秒），默认 10000 */\n  connectionTimeout?: number;\n  /** 重连延迟时间（毫秒），默认 2000 */\n  reconnectDelay?: number;\n}\n\n// =========================\n// 5. EndpointConnection 状态类型\n// =========================\n\n/**\n * EndpointConnection 状态接口\n */\nexport interface EndpointConnectionStatus {\n  /** 是否已连接 */\n  connected: boolean;\n  /** 是否已初始化 */\n  initialized: boolean;\n  /** 接入点 URL */\n  url: string;\n  /** 可用工具数量 */\n  availableTools: number;\n  /** 连接状态 */\n  connectionState: ConnectionState;\n  /** 最后一次错误信息 */\n  lastError: string | null;\n}\n\n// =========================\n// 6. EndpointManager 状态类型\n// =========================\n\n/**\n * 简单连接状态接口\n */\nexport interface SimpleConnectionStatus {\n  /** 接入点地址 */\n  endpoint: string;\n  /** 是否已连接 */\n  connected: boolean;\n  /** 是否已初始化 */\n  initialized: boolean;\n  /** 最后连接时间 */\n  lastConnected?: Date;\n  /** 最后错误信息 */\n  lastError?: string;\n}\n\n/**\n * 完整连接状态接口（扩展 SimpleConnectionStatus）\n */\nexport interface ConnectionStatus extends SimpleConnectionStatus {\n  // 扩展字段可以在这里添加\n}\n\n/**\n * 配置变更事件类型\n */\nexport interface ConfigChangeEvent {\n  type:\n    | \"endpoints_added\"\n    | \"endpoints_removed\"\n    | \"endpoints_updated\"\n    | \"options_updated\";\n  data: {\n    added?: string[];\n    removed?: string[];\n    updated?: string[];\n    oldOptions?: Partial<ConnectionOptions>;\n    newOptions?: Partial<ConnectionOptions>;\n  };\n  timestamp: Date;\n}\n\n/**\n * 重连结果接口\n */\nexport interface ReconnectResult {\n  successCount: number;\n  failureCount: number;\n  results: Array<{\n    endpoint: string;\n    success: boolean;\n    error?: string;\n  }>;\n}\n\n// =========================\n// 7. 新 API 配置类型\n// =========================\n\n/**\n * MCP 服务器配置类型\n * 支持三种配置方式：\n * 1. 本地命令 (stdio): { command: string; args: string[]; env?: Record<string, string> }\n * 2. SSE: { type: \"sse\"; url: string; headers?: Record<string, string> }\n * 3. HTTP: { type?: \"http\"; url: string; headers?: Record<string, string> }\n *\n * 向后兼容：自动将 streamable-http/streamable_http/streamableHttp 转换为 http\n */\nexport type MCPServerConfig =\n  | LocalMCPServerConfig\n  | SSEMCPServerConfig\n  | HTTPMCPServerConfig;\n\n/**\n * 本地 MCP 服务器配置\n */\nexport interface LocalMCPServerConfig {\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n}\n\n/**\n * SSE MCP 服务器配置\n */\nexport interface SSEMCPServerConfig {\n  type: \"sse\";\n  url: string;\n  headers?: Record<string, string>;\n}\n\n/**\n * HTTP MCP 服务器配置\n * 使用 type: \"http\"\n * 向后兼容 streamable-http 写法\n */\nexport interface HTTPMCPServerConfig {\n  type?: \"http\" | \"streamable-http\"; // 可选，默认就是 http\n  url: string;\n  headers?: Record<string, string>;\n}\n\n// 向后兼容的别名\n/** @deprecated 使用 HTTPMCPServerConfig 代替 */\nexport type StreamableHTTPMCPServerConfig = HTTPMCPServerConfig;\n\n/**\n * Endpoint 配置接口\n * @deprecated 不再使用，Endpoint 构造函数改为接收 IMCPServiceManager\n */\nexport interface EndpointConfig {\n  /** MCP 服务器配置（声明式） */\n  mcpServers: Record<string, MCPServerConfig>;\n  /** 可选：重连延迟（毫秒），默认 2000 */\n  reconnectDelay?: number;\n  /** 可选：ModelScope API Key（全局） */\n  modelscopeApiKey?: string;\n}\n\n/**\n * EndpointManager 配置接口\n */\nexport interface EndpointManagerConfig {\n  /** 可选：默认重连延迟（毫秒） */\n  defaultReconnectDelay?: number;\n}\n\n// =========================\n// 8. JWT Token 类型\n// =========================\n\n/**\n * 小智平台 JWT Token Payload 接口\n *\n * @example\n * ```typescript\n * // 从 endpoint URL 解码得到的 payload\n * const payload: XiaozhiTokenPayload = {\n *   userId: 302720,\n *   agentId: 1324149,\n *   endpointId: \"agent_1324149\",\n *   purpose: \"mcp-endpoint\",\n *   iat: 1768480930,\n *   exp: 1800038530\n * };\n * ```\n */\nexport interface XiaozhiTokenPayload {\n  /** 用户 ID */\n  userId: number;\n  /** 代理 ID */\n  agentId: number;\n  /** 接入点 ID，格式为 \"agent_{agentId}\" */\n  endpointId: string;\n  /** Token 用途 */\n  purpose: string;\n  /** 签发时间（Unix 时间戳） */\n  iat: number;\n  /** 过期时间（Unix 时间戳） */\n  exp: number;\n}\n\n/**\n * 解析后的 Endpoint URL 信息\n */\nexport interface ParsedEndpointInfo {\n  /** 完整的 endpoint URL */\n  url: string;\n  /** 提取的 JWT Token */\n  token: string;\n  /** 解码后的 Token Payload */\n  payload: XiaozhiTokenPayload;\n  /** WebSocket 服务器地址（不含 token 参数） */\n  wsUrl: string;\n}\n","/**\n * 工具函数模块\n *\n * 内联的必要工具函数，确保包的独立性\n */\n\nimport type {\n  ParsedEndpointInfo,\n  ValidatedToolCallParams,\n  XiaozhiTokenPayload,\n} from \"./types.js\";\n\n/**\n * 截断端点 URL 用于日志显示\n *\n * @param endpoint - 完整的端点 URL\n * @returns 截断后的 URL\n *\n * @example\n * ```typescript\n * sliceEndpoint(\"ws://very-long-endpoint-url-here.example.com/endpoint\")\n * // 返回: \"ws://very-long-endpoint-u...e.com/endpoint\"\n * ```\n */\nexport function sliceEndpoint(endpoint: string): string {\n  return `${endpoint.slice(0, 30)}...${endpoint.slice(-10)}`;\n}\n\n/**\n * 验证工具调用参数\n *\n * @param params - 待验证的参数\n * @returns 验证后的参数\n * @throws {Error} 如果参数无效\n *\n * @example\n * ```typescript\n * const params = validateToolCallParams({\n *   name: \"test_tool\",\n *   arguments: { foo: \"bar\" }\n * });\n * ```\n */\nexport function validateToolCallParams(\n  params: unknown\n): ValidatedToolCallParams {\n  // 基础类型检查\n  if (!params || typeof params !== \"object\") {\n    throw new Error(\"工具调用参数必须是对象\");\n  }\n\n  const p = params as Record<string, unknown>;\n\n  // 验证工具名称\n  if (!p.name || typeof p.name !== \"string\") {\n    throw new Error(\"工具名称必须是字符串\");\n  }\n\n  // 构建验证后的参数\n  const validated: ValidatedToolCallParams = {\n    name: p.name,\n  };\n\n  // 验证参数（可选）\n  if (p.arguments !== undefined) {\n    if (typeof p.arguments !== \"object\" || p.arguments === null) {\n      throw new Error(\"工具参数必须是对象\");\n    }\n    validated.arguments = p.arguments as Record<string, unknown>;\n  }\n\n  return validated;\n}\n\n/**\n * 验证端点 URL 格式\n *\n * @param endpoint - 待验证的端点 URL\n * @returns 是否为有效的 WebSocket URL\n */\nexport function isValidEndpointUrl(endpoint: string): boolean {\n  if (!endpoint || typeof endpoint !== \"string\") {\n    return false;\n  }\n\n  if (!endpoint.startsWith(\"ws://\") && !endpoint.startsWith(\"wss://\")) {\n    return false;\n  }\n\n  try {\n    new URL(endpoint);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * 检查属性名是否安全，防止原型污染攻击\n *\n * @param key - 待检查的属性名\n * @returns 是否为安全的属性名\n *\n * @example\n * ```typescript\n * isSafeKey(\"name\") // true\n * isSafeKey(\"__proto__\") // false\n * isSafeKey(\"constructor\") // false\n * ```\n */\nfunction isSafeKey(key: string): boolean {\n  // 拒绝已知的危险属性名\n  const dangerousKeys = [\"__proto__\", \"constructor\", \"prototype\"];\n  if (dangerousKeys.includes(key)) {\n    return false;\n  }\n\n  // 确保属性名是普通的字符串（不是 Symbol 等）\n  return typeof key === \"string\" && key.length > 0;\n}\n\n/**\n * 深度合并对象\n *\n * @param target - 目标对象\n * @param sources - 源对象\n * @returns 合并后的对象\n *\n * @example\n * ```typescript\n * const result = deepMerge(\n *   { a: 1, b: { x: 1 } },\n *   { b: { y: 2 }, c: 3 }\n * );\n * // 返回: { a: 1, b: { x: 1, y: 2 }, c: 3 }\n * ```\n */\nexport function deepMerge<T>(\n  target: Partial<T>,\n  ...sources: Array<Partial<T>>\n): T {\n  if (sources.length === 0) {\n    return target as T;\n  }\n\n  const source = sources.shift();\n\n  if (source === undefined) {\n    return target as T;\n  }\n\n  // 使用 Object.keys() 替代 for...in，只遍历对象自身的可枚举属性\n  const keys = Object.keys(source as Record<string, unknown>);\n\n  for (const key of keys) {\n    // 跳过不安全的 key，防止原型污染攻击\n    if (!isSafeKey(key)) {\n      continue;\n    }\n\n    const sourceValue = (source as Record<string, unknown>)[key];\n    const targetValue = (target as Record<string, unknown>)[key];\n\n    if (\n      typeof sourceValue === \"object\" &&\n      sourceValue !== null &&\n      !Array.isArray(sourceValue) &&\n      typeof targetValue === \"object\" &&\n      targetValue !== null &&\n      !Array.isArray(targetValue)\n    ) {\n      (target as Record<string, unknown>)[key] = deepMerge(\n        targetValue as Record<string, unknown>,\n        sourceValue as Record<string, unknown>\n      );\n    } else {\n      (target as Record<string, unknown>)[key] = sourceValue;\n    }\n  }\n\n  return deepMerge(target, ...sources);\n}\n\n/**\n * 延迟执行\n *\n * @param ms - 延迟时间（毫秒）\n * @returns Promise\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * 格式化错误消息\n *\n * @param error - 错误对象\n * @returns 格式化后的错误消息\n */\nexport function formatErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  return String(error);\n}\n\n// =========================\n// JWT Token 解码相关函数\n// =========================\n\n/**\n * Base64URL 解码\n *\n * @param input - Base64URL 编码的字符串\n * @returns 解码后的字符串\n *\n * @example\n * ```typescript\n * base64UrlDecode(\"SGVsbG8gV29ybGQ\") // 返回: \"Hello World\"\n * ```\n */\nfunction base64UrlDecode(input: string): string {\n  // 将 Base64URL 格式转换为标准 Base64 格式\n  let base64 = input.replace(/-/g, \"+\").replace(/_/g, \"/\");\n\n  // 补全 padding\n  while (base64.length % 4) {\n    base64 += \"=\";\n  }\n\n  // 使用 Node.js Buffer 进行解码\n  return Buffer.from(base64, \"base64\").toString(\"utf-8\");\n}\n\n/**\n * 解码 JWT Token（仅解析 payload，不验证签名）\n *\n * @param token - JWT Token 字符串\n * @returns 解码后的 Token Payload，解码失败返回 null\n *\n * @example\n * ```typescript\n * const payload = decodeJWTToken(\"eyJ...token...\");\n * if (payload) {\n *   console.log(payload.endpointId); // \"agent_1324149\"\n * }\n * ```\n */\nexport function decodeJWTToken(token: string): XiaozhiTokenPayload | null {\n  if (!token || typeof token !== \"string\") {\n    return null;\n  }\n\n  try {\n    // JWT 格式: header.payload.signature\n    const parts = token.split(\".\");\n    if (parts.length !== 3) {\n      return null;\n    }\n\n    // 解码 payload 部分（第二部分）\n    const payloadStr = base64UrlDecode(parts[1]);\n    const payload = JSON.parse(payloadStr) as unknown;\n\n    // 验证 payload 结构\n    if (\n      typeof payload !== \"object\" ||\n      payload === null ||\n      !(\"userId\" in payload) ||\n      !(\"agentId\" in payload) ||\n      !(\"endpointId\" in payload) ||\n      !(\"purpose\" in payload) ||\n      !(\"iat\" in payload) ||\n      !(\"exp\" in payload)\n    ) {\n      return null;\n    }\n\n    return payload as XiaozhiTokenPayload;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 从 endpoint URL 中提取 token 参数\n *\n * @param url - 完整的 endpoint URL\n * @returns 提取的 token 字符串，未找到返回 null\n *\n * @example\n * ```typescript\n * const token = extractTokenFromUrl(\n *   \"wss://api.xiaozhi.me/mcp/?token=eyJ...\"\n * );\n * ```\n */\nexport function extractTokenFromUrl(url: string): string | null {\n  if (!url || typeof url !== \"string\") {\n    return null;\n  }\n\n  try {\n    const urlObj = new URL(url);\n    return urlObj.searchParams.get(\"token\");\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 解析 endpoint URL 获取完整信息\n *\n * @param url - 完整的 endpoint URL\n * @returns 解析后的 endpoint 信息，解析失败返回 null\n *\n * @example\n * ```typescript\n * const info = parseEndpointUrl(\n *   \"wss://api.xiaozhi.me/mcp/?token=eyJ...\"\n * );\n * if (info) {\n *   console.log(info.payload.endpointId); // \"agent_1324149\"\n *   console.log(info.wsUrl); // \"wss://api.xiaozhi.me/mcp/\"\n * }\n * ```\n */\nexport function parseEndpointUrl(url: string): ParsedEndpointInfo | null {\n  if (!url || typeof url !== \"string\") {\n    return null;\n  }\n\n  try {\n    // 提取 token\n    const token = extractTokenFromUrl(url);\n    if (!token) {\n      return null;\n    }\n\n    // 解码 token\n    const payload = decodeJWTToken(token);\n    if (!payload) {\n      return null;\n    }\n\n    // 移除 token 参数得到纯净的 WebSocket URL\n    const urlObj = new URL(url);\n    urlObj.searchParams.delete(\"token\");\n    const wsUrl = urlObj.toString();\n\n    return {\n      url,\n      token,\n      payload,\n      wsUrl,\n    };\n  } catch {\n    return null;\n  }\n}\n","/**\n * EndpointManager\n * 管理多个小智接入点的连接，共享外部传入的 MCPManager\n *\n * 使用方式：\n * ```typescript\n * // 1. 先创建并配置 MCPManager\n * const mcpManager = new MCPManager();\n * mcpManager.addServer(\"calculator\", { command: \"npx\", args: [\"-y\", \"calculator-mcp\"] });\n * await mcpManager.connect();\n *\n * // 2. 创建 EndpointManager 并设置 MCPManager\n * const manager = new EndpointManager();\n * manager.setMcpManager(mcpManager);\n *\n * // 3. 添加接入点\n * manager.addEndpoint(\"ws://endpoint1\");\n * await manager.connect();\n * ```\n */\n\nimport { EventEmitter } from \"node:events\";\nimport type { Endpoint } from \"./endpoint.js\";\nimport { Endpoint as EndpointClass } from \"./endpoint.js\";\nimport { SharedMCPAdapter } from \"./shared-mcp-adapter.js\";\nimport type {\n  EndpointManagerConfig,\n  IMCPServiceManager,\n  SimpleConnectionStatus,\n} from \"./types.js\";\nimport { sliceEndpoint } from \"./utils.js\";\n\n/**\n * MCP 服务连接事件数据\n */\ninterface MCPConnectedEvent {\n  serverName: string;\n  tools?: Array<unknown>;\n}\n\n/**\n * MCP 服务错误事件数据\n */\ninterface MCPErrorEvent {\n  serverName: string;\n  error: Error | unknown;\n}\n\n/**\n * 小智接入点管理器\n * 负责管理多个小智接入点的连接，共享 MCP 服务\n *\n * 注意：MCPManager 必须通过 setMcpManager() 方法设置，且由外部管理其生命周期\n */\nexport class EndpointManager extends EventEmitter {\n  private endpoints: Map<string, Endpoint> = new Map();\n  private connectionStates: Map<string, SimpleConnectionStatus> = new Map();\n  private mcpManager: IMCPServiceManager | null = null;\n  private sharedMCPAdapter: SharedMCPAdapter | null = null;\n  private mcpEventListeners: Array<(...args: unknown[]) => void> = [];\n\n  /**\n   * 构造函数\n   *\n   * @param config - 可选的配置\n   */\n  constructor(private config?: EndpointManagerConfig) {\n    super();\n    console.debug(\"[EndpointManager] 实例已创建\");\n  }\n\n  /**\n   * 设置 MCPManager 实例\n   *\n   * 注意：MCPManager 的生命周期由外部管理，EndpointManager 不负责连接和断开\n   *\n   * @param mcpManager - 外部创建并已连接的 MCPManager 实例\n   */\n  setMcpManager(mcpManager: IMCPServiceManager): void {\n    if (this.sharedMCPAdapter) {\n      throw new Error(\"MCPManager 已经设置，不能重复设置\");\n    }\n\n    this.mcpManager = mcpManager;\n    this.sharedMCPAdapter = new SharedMCPAdapter(mcpManager);\n\n    // 监听 MCP 服务连接事件（如果支持 EventEmitter）\n    if (\"on\" in mcpManager && typeof mcpManager.on === \"function\") {\n      const connectedHandler = (...args: unknown[]) => {\n        const data = args[0] as MCPConnectedEvent;\n        console.info(\n          `[EndpointManager] MCP 服务已连接: ${data.serverName}, 工具数: ${data.tools?.length || 0}`\n        );\n      };\n      const errorHandler = (...args: unknown[]) => {\n        const data = args[0] as MCPErrorEvent;\n        console.error(\n          `[EndpointManager] MCP 服务连接失败: ${data.serverName}`,\n          data.error\n        );\n      };\n\n      mcpManager.on(\"connected\", connectedHandler);\n      mcpManager.on(\"error\", errorHandler);\n\n      // 保存监听器引用以便后续清理\n      this.mcpEventListeners.push(connectedHandler, errorHandler);\n    }\n\n    console.info(\"[EndpointManager] MCPManager 已设置\");\n  }\n\n  /**\n   * 添加 Endpoint（支持 URL 字符串或 Endpoint 实例）\n   *\n   * @param endpoint - Endpoint URL 字符串或 Endpoint 实例\n   */\n  addEndpoint(endpoint: string | Endpoint): void {\n    // 如果是字符串，创建新的 Endpoint 实例\n    if (typeof endpoint === \"string\") {\n      if (!this.sharedMCPAdapter) {\n        throw new Error(\n          \"MCPManager 未设置，请先调用 setMcpManager() 方法设置 MCPManager\"\n        );\n      }\n\n      const endpointInstance = new EndpointClass(\n        endpoint,\n        this.sharedMCPAdapter,\n        this.config?.defaultReconnectDelay\n      );\n\n      this.addEndpointInternal(endpointInstance);\n      return;\n    }\n\n    // 原有的 Endpoint 实例处理逻辑\n    // 当 EndpointManager 已配置共享 MCPManager 时，不允许再传入外部构造的 Endpoint 实例，\n    // 以避免不同 Endpoint 使用不同的 MCP 管理器，破坏共享 MCPManager 的设计。\n    if (this.sharedMCPAdapter) {\n      throw new Error(\n        \"[EndpointManager] 当使用共享 MCPManager 时，不支持传入自定义 Endpoint 实例，请传入 Endpoint URL 字符串以便由 EndpointManager 创建实例\"\n      );\n    }\n\n    this.addEndpointInternal(endpoint);\n  }\n\n  /**\n   * 内部添加 Endpoint 方法\n   */\n  private addEndpointInternal(endpoint: Endpoint): void {\n    const url = endpoint.getUrl();\n\n    if (this.endpoints.has(url)) {\n      console.debug(\n        `[EndpointManager] 接入点 ${sliceEndpoint(url)} 已存在，跳过添加`\n      );\n      return;\n    }\n\n    console.debug(`[EndpointManager] 添加接入点: ${sliceEndpoint(url)}`);\n\n    this.endpoints.set(url, endpoint);\n    this.connectionStates.set(url, {\n      endpoint: url,\n      connected: false,\n      initialized: false,\n    });\n\n    // 发射事件\n    this.emit(\"endpointAdded\", { endpoint: url });\n  }\n\n  /**\n   * 移除 Endpoint 实例\n   *\n   * @param endpoint - Endpoint 实例\n   */\n  removeEndpoint(endpoint: Endpoint): void {\n    const url = endpoint.getUrl();\n\n    if (!this.endpoints.has(url)) {\n      console.debug(\n        `[EndpointManager] 接入点 ${sliceEndpoint(url)} 不存在，跳过移除`\n      );\n      return;\n    }\n\n    console.debug(`[EndpointManager] 移除接入点: ${sliceEndpoint(url)}`);\n\n    // 断开连接\n    endpoint.disconnect();\n\n    // 清理状态\n    this.endpoints.delete(url);\n    this.connectionStates.delete(url);\n\n    // 发射事件\n    this.emit(\"endpointRemoved\", { endpoint: url });\n  }\n\n  /**\n   * 连接 Endpoint\n   *\n   * 注意：此方法不负责连接 MCPManager，MCPManager 必须在调用此方法前已连接\n   *\n   * @param endpoint - 可选，指定要连接的端点 URL。如果不传入，则连接所有端点\n   */\n  async connect(endpoint?: string): Promise<void> {\n    // 如果指定了端点，只连接该端点\n    if (endpoint) {\n      const endpointInstance = this.endpoints.get(endpoint);\n      if (!endpointInstance) {\n        throw new Error(`接入点不存在: ${sliceEndpoint(endpoint)}`);\n      }\n\n      const status = this.connectionStates.get(endpoint);\n      if (status?.connected) {\n        console.debug(\n          `[EndpointManager] 接入点已连接，跳过: ${sliceEndpoint(endpoint)}`\n        );\n        return;\n      }\n\n      await this.connectSingleEndpoint(endpoint, endpointInstance);\n      return;\n    }\n\n    // 连接所有未连接的 Endpoint\n    console.debug(\n      `[EndpointManager] 开始连接接入点，总数: ${this.endpoints.size}`\n    );\n\n    const promises: Promise<void>[] = [];\n\n    for (const [url, endpoint] of this.endpoints) {\n      const status = this.connectionStates.get(url);\n\n      // 跳过已连接的端点\n      if (status?.connected) {\n        console.debug(\n          `[EndpointManager] 接入点已连接，跳过: ${sliceEndpoint(url)}`\n        );\n        continue;\n      }\n\n      promises.push(\n        this.connectSingleEndpoint(url, endpoint).catch((error) => {\n          console.error(\n            `[EndpointManager] 连接失败: ${sliceEndpoint(url)}`,\n            error\n          );\n          // 更新失败状态\n          const status = this.connectionStates.get(url);\n          if (status) {\n            status.connected = false;\n            status.initialized = false;\n            status.lastError =\n              error instanceof Error ? error.message : String(error);\n          }\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n\n    // 统计连接结果\n    const connectedCount = Array.from(this.connectionStates.values()).filter(\n      (s) => s.connected\n    ).length;\n\n    console.info(\n      `[EndpointManager] 连接完成: 成功 ${connectedCount}/${this.endpoints.size}`\n    );\n  }\n\n  /**\n   * 断开连接\n   *\n   * 注意：此方法不断开 MCPManager，MCPManager 的生命周期由外部管理\n   *\n   * @param endpoint - 可选，指定要断开的端点 URL。如果不传入，则断开所有端点\n   */\n  async disconnect(endpoint?: string): Promise<void> {\n    // 如果指定了端点，只断开该端点\n    if (endpoint) {\n      const endpointInstance = this.endpoints.get(endpoint);\n      if (!endpointInstance) {\n        throw new Error(`接入点不存在: ${sliceEndpoint(endpoint)}`);\n      }\n\n      endpointInstance.disconnect();\n\n      const status = this.connectionStates.get(endpoint);\n      if (status) {\n        status.connected = false;\n        status.initialized = false;\n      }\n\n      console.debug(\n        `[EndpointManager] 接入点已断开: ${sliceEndpoint(endpoint)}`\n      );\n      return;\n    }\n\n    // 断开所有连接\n    console.debug(\"[EndpointManager] 开始断开所有连接\");\n\n    const promises: Promise<void>[] = [];\n\n    for (const endpoint of this.endpoints.values()) {\n      promises.push(\n        Promise.resolve().then(() => {\n          endpoint.disconnect();\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n\n    // 重置所有状态\n    for (const status of this.connectionStates.values()) {\n      status.connected = false;\n      status.initialized = false;\n    }\n\n    console.debug(\"[EndpointManager] 所有接入点已断开连接\");\n  }\n\n  /**\n   * 获取所有 Endpoint URL\n   */\n  getEndpoints(): string[] {\n    return Array.from(this.endpoints.keys());\n  }\n\n  /**\n   * 获取指定 Endpoint 实例\n   *\n   * @param url - Endpoint URL\n   */\n  getEndpoint(url: string): Endpoint | undefined {\n    return this.endpoints.get(url);\n  }\n\n  /**\n   * 获取所有连接状态\n   */\n  getConnectionStatus(): SimpleConnectionStatus[] {\n    return Array.from(this.connectionStates.values());\n  }\n\n  /**\n   * 检查是否有任何连接处于连接状态\n   */\n  isAnyConnected(): boolean {\n    for (const status of this.connectionStates.values()) {\n      if (status.connected) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * 检查指定端点是否已连接\n   *\n   * @param url - 端点 URL\n   */\n  isEndpointConnected(url: string): boolean {\n    const status = this.connectionStates.get(url);\n    return status?.connected ?? false;\n  }\n\n  /**\n   * 获取指定端点的状态\n   *\n   * @param url - 端点 URL\n   */\n  getEndpointStatus(url: string): SimpleConnectionStatus | undefined {\n    return this.connectionStates.get(url);\n  }\n\n  /**\n   * 重连\n   *\n   * @param endpoint - 可选，指定要重连的端点 URL。如果不传入，则重连所有端点\n   * @param delay - 可选，disconnect 和 connect 之间的等待时间（毫秒），默认为 1000ms。\n   *               注意：此参数只控制断开和重新连接之间的等待时间，不影响底层 Endpoint 实例的重连延迟\n   */\n  async reconnect(endpoint?: string, delay = 1000): Promise<void> {\n    console.info(\"[EndpointManager] 开始重连\");\n\n    // 先断开连接\n    await this.disconnect(endpoint);\n\n    // 等待一段时间\n    console.debug(`[EndpointManager] 等待 ${delay}ms 后重连`);\n    await new Promise((resolve) => setTimeout(resolve, delay));\n\n    // 再重新连接\n    await this.connect(endpoint);\n\n    console.info(\"[EndpointManager] 重连完成\");\n  }\n\n  /**\n   * 重连所有端点\n   */\n  async reconnectAll(): Promise<void> {\n    console.info(\"[EndpointManager] 开始重连所有接入点\");\n\n    const promises: Promise<void>[] = [];\n\n    for (const [url, endpoint] of this.endpoints) {\n      promises.push(\n        this.reconnectSingleEndpoint(url, endpoint).catch((error) => {\n          console.error(\n            `[EndpointManager] 重连失败: ${sliceEndpoint(url)}`,\n            error\n          );\n        })\n      );\n    }\n\n    await Promise.allSettled(promises);\n  }\n\n  /**\n   * 重连指定的端点\n   *\n   * @param url - 要重连的端点 URL\n   */\n  async reconnectEndpoint(url: string): Promise<void> {\n    const endpoint = this.endpoints.get(url);\n    if (!endpoint) {\n      throw new Error(`接入点不存在: ${sliceEndpoint(url)}`);\n    }\n\n    await this.reconnectSingleEndpoint(url, endpoint);\n  }\n\n  /**\n   * 清除所有端点\n   *\n   * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理\n   */\n  async clearEndpoints(): Promise<void> {\n    console.debug(\"[EndpointManager] 清除所有接入点\");\n\n    await this.disconnect();\n\n    this.endpoints.clear();\n    this.connectionStates.clear();\n\n    // 注意：不清理 MCPManager，由外部管理\n    // this.mcpManager = null;\n    // this.sharedMCPAdapter = null;\n\n    console.info(\"[EndpointManager] 所有接入点已清除\");\n  }\n\n  /**\n   * 清理资源\n   *\n   * 注意：此方法不会清理 MCPManager，MCPManager 的生命周期由外部管理\n   */\n  async cleanup(): Promise<void> {\n    console.debug(\"[EndpointManager] 开始清理资源\");\n\n    // 移除 MCP 服务事件监听器\n    if (\n      this.mcpManager &&\n      \"removeListener\" in this.mcpManager &&\n      typeof this.mcpManager.removeListener === \"function\"\n    ) {\n      for (const listener of this.mcpEventListeners) {\n        this.mcpManager.removeListener(\"connected\", listener);\n        this.mcpManager.removeListener(\"error\", listener);\n      }\n    }\n    this.mcpEventListeners = [];\n\n    await this.clearEndpoints();\n\n    console.debug(\"[EndpointManager] 资源清理完成\");\n  }\n\n  // ==================== 私有方法 ====================\n\n  /**\n   * 连接单个端点\n   */\n  private async connectSingleEndpoint(\n    url: string,\n    endpoint: Endpoint\n  ): Promise<void> {\n    const status = this.connectionStates.get(url);\n    if (!status) {\n      throw new Error(`端点状态不存在: ${sliceEndpoint(url)}`);\n    }\n\n    console.debug(`[EndpointManager] 连接端点: ${sliceEndpoint(url)}`);\n\n    // 更新状态为连接中\n    status.connected = false;\n    status.initialized = false;\n\n    // 执行连接\n    await endpoint.connect();\n\n    // 更新连接成功状态\n    status.connected = true;\n    status.initialized = true;\n    status.lastConnected = new Date();\n    status.lastError = undefined;\n\n    console.info(`[EndpointManager] 端点连接成功: ${sliceEndpoint(url)}`);\n  }\n\n  /**\n   * 重连单个端点\n   */\n  private async reconnectSingleEndpoint(\n    url: string,\n    endpoint: Endpoint\n  ): Promise<void> {\n    const status = this.connectionStates.get(url);\n    if (!status) {\n      throw new Error(`端点状态不存在: ${sliceEndpoint(url)}`);\n    }\n\n    console.debug(`[EndpointManager] 重连端点: ${sliceEndpoint(url)}`);\n\n    // 执行重连\n    await endpoint.reconnect();\n\n    // 更新连接成功状态\n    status.connected = true;\n    status.initialized = true;\n    status.lastConnected = new Date();\n    status.lastError = undefined;\n\n    console.info(`[EndpointManager] 端点重连成功: ${sliceEndpoint(url)}`);\n  }\n}\n","/**\n * 共享 MCP 管理器适配器\n *\n * 接收全局 MCPManager 实例的引用，不创建独立连接\n * 用于多个 Endpoint 共享同一个 MCPManager 实例\n *\n * @example\n * ```typescript\n * const globalMCPManager = new MCPManager();\n * await globalMCPManager.connect();\n *\n * const adapter = new SharedMCPAdapter(globalMCPManager);\n * const endpoint = new Endpoint(\"ws://...\", adapter);\n * ```\n */\n\nimport type {\n  IMCPServiceManager,\n  EnhancedToolInfo,\n  ToolCallResult,\n} from \"./types.js\";\n\n/**\n * 共享 MCP 管理器适配器\n * 实现 IMCPServiceManager 接口，将操作委托给全局 MCPManager\n */\nexport class SharedMCPAdapter implements IMCPServiceManager {\n  private isInitialized = false;\n\n  /**\n   * 构造函数\n   *\n   * @param globalMCPManager - 全局 MCPManager 实例\n   */\n  constructor(private globalMCPManager: IMCPServiceManager) {\n    if (!globalMCPManager) {\n      throw new Error(\"全局 MCPManager 不能为空\");\n    }\n  }\n\n  /**\n   * 初始化适配器\n   *\n   * 注意：此方法不执行任何连接操作，仅标记初始化状态，因为全局 MCPManager 的生命周期由外部管理\n   */\n  async initialize(): Promise<void> {\n    if (this.isInitialized) {\n      return;\n    }\n\n    // 全局实例已经在外部连接，这里只标记状态\n    this.isInitialized = true;\n  }\n\n  /**\n   * 获取所有工具列表\n   *\n   * 从全局 MCPManager 获取工具列表，并转换为增强格式\n   */\n  getAllTools(): EnhancedToolInfo[] {\n    // 直接使用 IMCPServiceManager 接口的 getAllTools() 方法\n    return this.globalMCPManager.getAllTools();\n  }\n\n  /**\n   * 调用工具\n   *\n   * 将工具调用委托给全局 MCPManager\n   *\n   * @param toolName - 工具名称（格式：serviceName__toolName）\n   * @param arguments_ - 工具调用参数\n   */\n  async callTool(\n    toolName: string,\n    arguments_: Record<string, unknown>\n  ): Promise<ToolCallResult> {\n    // 直接使用 IMCPServiceManager 接口的 callTool() 方法\n    // toolName 已经是完整格式（serviceName__toolName）\n    return this.globalMCPManager.callTool(toolName, arguments_);\n  }\n\n  /**\n   * 清理资源\n   *\n   * 注意：此方法不会断开全局 MCPManager，由创建者负责管理\n   */\n  async cleanup(): Promise<void> {\n    this.isInitialized = false;\n    // 不断开全局 MCPManager\n  }\n}\n"],"mappings":"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","names":["ToolCallErrorCode","ConnectionState","endpoint","status"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhi-client/endpoint",
-  "version": "1.9.7-beta.9",
+  "version": "1.9.8-beta.0",
   "description": "小智接入点 WebSocket 连接管理库",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,7 +8,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/shenjingnan/xiaozhi-client.git",
-    "directory": "packages/shared-types"
+    "directory": "packages/endpoint"
   },
   "exports": {
     ".": {
@@ -21,8 +21,8 @@
   ],
   "dependencies": {
     "ws": "^8.14.2",
-    "@xiaozhi-client/mcp-core": "1.9.7-beta.9",
-    "@xiaozhi-client/config": "1.9.7-beta.9"
+    "@xiaozhi-client/config": "1.9.8-beta.0",
+    "@xiaozhi-client/mcp-core": "1.9.8-beta.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.24.0"
@@ -31,6 +31,7 @@
     "@types/node": "^24.3.0",
     "@types/ws": "^8.5.0",
     "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
     "typescript": "^5.9.2",
     "vitest": "^3.0.5"
   },
@@ -50,6 +51,11 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "start": "tsx examples/single-endpoint.ts",
+    "start:agg": "tsx examples/mcp-aggregation.ts",
+    "start:iso": "tsx examples/endpoint-isolation.ts",
+    "start:manage": "tsx examples/manage-endpoints.ts",
+    "start:shared": "tsx examples/shared-mcp-to-multi-endpoints.ts"
   }
 }