@dexto/core 1.1.4 → 1.1.6

package/dist/mcp/manager.d.cts

@@ -0,0 +1,163 @@
+import { ValidatedServerConfigs, ValidatedMcpServerConfig } from './schemas.cjs';
+import { IMCPClient } from './types.cjs';
+import { ToolSet } from '../tools/types.cjs';
+import { GetPromptResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import 'zod';
+import '@modelcontextprotocol/sdk/client/index.js';
+import 'json-schema';
+
+/**
+ * Centralized manager for Multiple Model Context Protocol (MCP) servers.
+ *
+ * The MCPManager serves as a focused interface for managing connections to MCP servers
+ * and providing access to their capabilities (tools, prompts, resources).
+ *
+ * Key responsibilities:
+ * - **Client Management**: Register, connect, disconnect, and remove MCP clients
+ * - **Resource Discovery**: Cache and provide access to tools, prompts, and resources from connected clients
+ * - **MCP Tool Execution**: Execute MCP tools with built-in confirmation mechanisms
+ * - **Connection Handling**: Support both strict and lenient connection modes with error tracking
+ * - **Caching**: Maintain efficient lookup maps for fast access to client capabilities
+ *
+ * The manager supports dynamic client connections, allowing servers to be added or removed at runtime.
+ * It includes robust error handling and maintains connection state for debugging purposes.
+ *
+ * Note: This class focuses only on MCP server management. For unified tool management
+ * across multiple sources (MCP + custom tools), use the ToolManager class.
+ *
+ * @example
+ * ```typescript
+ * const manager = new MCPManager();
+ * await manager.initializeFromConfig(serverConfigs);
+ *
+ * // Execute an MCP tool
+ * const result = await manager.executeTool('my_tool', { param: 'value' });
+ *
+ * // Get all available MCP tools
+ * const tools = await manager.getAllTools();
+ * ```
+ */
+declare class MCPManager {
+    private clients;
+    private connectionErrors;
+    private toolToClientMap;
+    private serverToolsMap;
+    private toolConflicts;
+    private promptToClientMap;
+    private resourceToClientMap;
+    private sanitizedNameToServerMap;
+    private static readonly SERVER_DELIMITER;
+    constructor();
+    /**
+     * Register a client that provides tools (and potentially more)
+     * @param name Unique name for the client
+     * @param client The client instance, expected to be IMCPClient
+     */
+    registerClient(name: string, client: IMCPClient): void;
+    private clearClientCache;
+    private rebuildToolConflicts;
+    /**
+     * Sanitize server name for use in tool prefixing.
+     * Ensures the name is safe for LLM provider tool naming constraints.
+     */
+    private sanitizeServerName;
+    private updateClientCache;
+    /**
+     * Get all available MCP tools from all connected clients, updating the cache.
+     * Conflicted tools are prefixed with server name using distinctive delimiter.
+     * @returns Promise resolving to a ToolSet mapping tool names to Tool definitions
+     */
+    getAllTools(): Promise<ToolSet>;
+    /**
+     * Parse a qualified tool name to extract server name and actual tool name.
+     * Uses distinctive delimiter to avoid ambiguity and splits on last occurrence.
+     */
+    private parseQualifiedToolName;
+    /**
+     * Get client that provides a specific tool from the cache.
+     * Handles both simple tool names and server-prefixed tool names.
+     * @param toolName Name of the tool (may include server prefix)
+     * @returns The client that provides the tool, or undefined if not found
+     */
+    getToolClient(toolName: string): IMCPClient | undefined;
+    /**
+     * Execute a specific MCP tool with the given arguments.
+     * @param toolName Name of the MCP tool to execute (may include server prefix)
+     * @param args Arguments to pass to the tool
+     * @param sessionId Optional session ID
+     * @returns Promise resolving to the tool execution result
+     */
+    executeTool(toolName: string, args: any, _sessionId?: string): Promise<any>;
+    /**
+     * Get all available prompt names from all connected clients, updating the cache.
+     * @returns Promise resolving to an array of unique prompt names.
+     */
+    listAllPrompts(): Promise<string[]>;
+    /**
+     * Get the client that provides a specific prompt from the cache.
+     * @param promptName Name of the prompt.
+     * @returns The client instance or undefined.
+     */
+    getPromptClient(promptName: string): IMCPClient | undefined;
+    /**
+     * Get a specific prompt definition by name.
+     * @param name Name of the prompt.
+     * @param args Arguments for the prompt (optional).
+     * @returns Promise resolving to the prompt definition.
+     */
+    getPrompt(name: string, args?: any): Promise<GetPromptResult>;
+    /**
+     * Get all available resource URIs from all connected clients, updating the cache.
+     * @returns Promise resolving to an array of unique resource URIs.
+     */
+    listAllResources(): Promise<string[]>;
+    /**
+     * Get the client that provides a specific resource from the cache.
+     * @param resourceUri URI of the resource.
+     * @returns The client instance or undefined.
+     */
+    getResourceClient(resourceUri: string): IMCPClient | undefined;
+    /**
+     * Read a specific resource by URI.
+     * @param uri URI of the resource.
+     * @returns Promise resolving to the resource content.
+     */
+    readResource(uri: string): Promise<ReadResourceResult>;
+    /**
+     * Initialize clients from server configurations
+     * @param serverConfigs Server configurations with individual connection modes
+     * @returns Promise resolving when initialization is complete
+     */
+    initializeFromConfig(serverConfigs: ValidatedServerConfigs): Promise<void>;
+    /**
+     * Dynamically connect to a new MCP server.
+     * @param name The unique name for the new server connection.
+     * @param config The configuration for the server.
+     * @returns Promise resolving when the connection attempt is complete.
+     * @throws Error if the connection fails.
+     */
+    connectServer(name: string, config: ValidatedMcpServerConfig): Promise<void>;
+    /**
+     * Get all registered clients
+     * @returns Map of client names to client instances
+     */
+    getClients(): Map<string, IMCPClient>;
+    /**
+     * Get the errors from failed connections
+     * @returns Map of server names to error messages
+     */
+    getFailedConnections(): {
+        [key: string]: string;
+    };
+    /**
+     * Disconnect and remove a specific client by name.
+     * @param name The name of the client to remove.
+     */
+    removeClient(name: string): Promise<void>;
+    /**
+     * Disconnect all clients and clear caches
+     */
+    disconnectAll(): Promise<void>;
+}
+
+export { MCPManager };

package/dist/mcp/manager.d.ts

@@ -0,0 +1,163 @@
+import { ValidatedServerConfigs, ValidatedMcpServerConfig } from './schemas.js';
+import { IMCPClient } from './types.js';
+import { ToolSet } from '../tools/types.js';
+import { GetPromptResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+import 'zod';
+import '@modelcontextprotocol/sdk/client/index.js';
+import 'json-schema';
+
+/**
+ * Centralized manager for Multiple Model Context Protocol (MCP) servers.
+ *
+ * The MCPManager serves as a focused interface for managing connections to MCP servers
+ * and providing access to their capabilities (tools, prompts, resources).
+ *
+ * Key responsibilities:
+ * - **Client Management**: Register, connect, disconnect, and remove MCP clients
+ * - **Resource Discovery**: Cache and provide access to tools, prompts, and resources from connected clients
+ * - **MCP Tool Execution**: Execute MCP tools with built-in confirmation mechanisms
+ * - **Connection Handling**: Support both strict and lenient connection modes with error tracking
+ * - **Caching**: Maintain efficient lookup maps for fast access to client capabilities
+ *
+ * The manager supports dynamic client connections, allowing servers to be added or removed at runtime.
+ * It includes robust error handling and maintains connection state for debugging purposes.
+ *
+ * Note: This class focuses only on MCP server management. For unified tool management
+ * across multiple sources (MCP + custom tools), use the ToolManager class.
+ *
+ * @example
+ * ```typescript
+ * const manager = new MCPManager();
+ * await manager.initializeFromConfig(serverConfigs);
+ *
+ * // Execute an MCP tool
+ * const result = await manager.executeTool('my_tool', { param: 'value' });
+ *
+ * // Get all available MCP tools
+ * const tools = await manager.getAllTools();
+ * ```
+ */
+declare class MCPManager {
+    private clients;
+    private connectionErrors;
+    private toolToClientMap;
+    private serverToolsMap;
+    private toolConflicts;
+    private promptToClientMap;
+    private resourceToClientMap;
+    private sanitizedNameToServerMap;
+    private static readonly SERVER_DELIMITER;
+    constructor();
+    /**
+     * Register a client that provides tools (and potentially more)
+     * @param name Unique name for the client
+     * @param client The client instance, expected to be IMCPClient
+     */
+    registerClient(name: string, client: IMCPClient): void;
+    private clearClientCache;
+    private rebuildToolConflicts;
+    /**
+     * Sanitize server name for use in tool prefixing.
+     * Ensures the name is safe for LLM provider tool naming constraints.
+     */
+    private sanitizeServerName;
+    private updateClientCache;
+    /**
+     * Get all available MCP tools from all connected clients, updating the cache.
+     * Conflicted tools are prefixed with server name using distinctive delimiter.
+     * @returns Promise resolving to a ToolSet mapping tool names to Tool definitions
+     */
+    getAllTools(): Promise<ToolSet>;
+    /**
+     * Parse a qualified tool name to extract server name and actual tool name.
+     * Uses distinctive delimiter to avoid ambiguity and splits on last occurrence.
+     */
+    private parseQualifiedToolName;
+    /**
+     * Get client that provides a specific tool from the cache.
+     * Handles both simple tool names and server-prefixed tool names.
+     * @param toolName Name of the tool (may include server prefix)
+     * @returns The client that provides the tool, or undefined if not found
+     */
+    getToolClient(toolName: string): IMCPClient | undefined;
+    /**
+     * Execute a specific MCP tool with the given arguments.
+     * @param toolName Name of the MCP tool to execute (may include server prefix)
+     * @param args Arguments to pass to the tool
+     * @param sessionId Optional session ID
+     * @returns Promise resolving to the tool execution result
+     */
+    executeTool(toolName: string, args: any, _sessionId?: string): Promise<any>;
+    /**
+     * Get all available prompt names from all connected clients, updating the cache.
+     * @returns Promise resolving to an array of unique prompt names.
+     */
+    listAllPrompts(): Promise<string[]>;
+    /**
+     * Get the client that provides a specific prompt from the cache.
+     * @param promptName Name of the prompt.
+     * @returns The client instance or undefined.
+     */
+    getPromptClient(promptName: string): IMCPClient | undefined;
+    /**
+     * Get a specific prompt definition by name.
+     * @param name Name of the prompt.
+     * @param args Arguments for the prompt (optional).
+     * @returns Promise resolving to the prompt definition.
+     */
+    getPrompt(name: string, args?: any): Promise<GetPromptResult>;
+    /**
+     * Get all available resource URIs from all connected clients, updating the cache.
+     * @returns Promise resolving to an array of unique resource URIs.
+     */
+    listAllResources(): Promise<string[]>;
+    /**
+     * Get the client that provides a specific resource from the cache.
+     * @param resourceUri URI of the resource.
+     * @returns The client instance or undefined.
+     */
+    getResourceClient(resourceUri: string): IMCPClient | undefined;
+    /**
+     * Read a specific resource by URI.
+     * @param uri URI of the resource.
+     * @returns Promise resolving to the resource content.
+     */
+    readResource(uri: string): Promise<ReadResourceResult>;
+    /**
+     * Initialize clients from server configurations
+     * @param serverConfigs Server configurations with individual connection modes
+     * @returns Promise resolving when initialization is complete
+     */
+    initializeFromConfig(serverConfigs: ValidatedServerConfigs): Promise<void>;
+    /**
+     * Dynamically connect to a new MCP server.
+     * @param name The unique name for the new server connection.
+     * @param config The configuration for the server.
+     * @returns Promise resolving when the connection attempt is complete.
+     * @throws Error if the connection fails.
+     */
+    connectServer(name: string, config: ValidatedMcpServerConfig): Promise<void>;
+    /**
+     * Get all registered clients
+     * @returns Map of client names to client instances
+     */
+    getClients(): Map<string, IMCPClient>;
+    /**
+     * Get the errors from failed connections
+     * @returns Map of server names to error messages
+     */
+    getFailedConnections(): {
+        [key: string]: string;
+    };
+    /**
+     * Disconnect and remove a specific client by name.
+     * @param name The name of the client to remove.
+     */
+    removeClient(name: string): Promise<void>;
+    /**
+     * Disconnect all clients and clear caches
+     */
+    disconnectAll(): Promise<void>;
+}
+
+export { MCPManager };