@mcp-ts/sdk 1.5.0 → 1.5.2

package/dist/adapters/langchain-adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/langchain-adapter.ts"],"names":["namespace"],"mappings":"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","file":"langchain-adapter.js","sourcesContent":["/**\n * Meta-tools — Injectable tool definitions that let the LLM discover and\n * load MCP tools on-demand, following Anthropic's Tool Search pattern.\n *\n * Instead of injecting 50+ full tool schemas into the context window, you\n * inject just these 4 meta-tools. The LLM calls them to find and load\n * only the tools it actually needs.\n *\n * Meta-tools:\n *   • `mcp_search_tool_bm25`  — BM25 natural language search\n *   • `mcp_search_tool_regex` — Regex pattern search\n *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool\n *   • `mcp_execute_tool`      — Execute a discovered tool\n *\n * @packageDocumentation\n */\n\nimport type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolRouter } from './tool-router.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tool_bm25` tool definition.\n *\n * This tool lets the LLM search the full catalog of available MCP tools\n * using a BM25 natural-language query. Returns tool names and descriptions\n * without the full inputSchema to save context space.\n */\nexport function createSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_bm25',\n    description:\n      'Search the catalog of available tools using BM25 natural language ranking. ' +\n      'Returns tool names, descriptions, and server info. ' +\n      'Use this FIRST to find relevant tools before calling them. ' +\n      'Example queries: \"database query\", \"send email\", \"github pull request\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Natural language description of the capability you need.',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_search_tool_regex` tool definition.\n * \n * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).\n */\nexport function createRegexSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_regex',\n    description:\n      'Search the catalog of available tools using a Python-style regex pattern. ' +\n      'Matches against tool names, descriptions, and parameter descriptions. ' +\n      'Example patterns: \"^github_\", \"weather\", \"(?i)slack\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Regex pattern to search for (e.g., \"^get_.*_data\", \"database\").',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_get_tool_schema` tool definition.\n *\n * After discovering tools via `mcp_search_tool_bm25` or\n * `mcp_search_tool_regex`, the LLM calls this to load the full\n * inputSchema for a specific tool so it can construct the correct\n * arguments.\n */\nexport function createGetSchemaToolDefinition(): Tool {\n  return {\n    name: 'mcp_get_tool_schema',\n    description:\n      'Get the full input schema (parameters) for a specific tool. ' +\n      'Call this after mcp_search_tool_bm25 to get the parameter details ' +\n      'needed to call a tool correctly.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tool_bm25.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional: The server name provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_execute_tool` tool definition.\n *\n * This is the execution meta-tool — the LLM calls this to execute any\n * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.\n * The LLM should first call `mcp_get_tool_schema` to know the correct\n * arguments.\n *\n * Instead of registering every real tool with the framework, we proxy\n * all execution through a single meta-tool.\n */\nexport function createExecuteToolDefinition(): Tool {\n  return {\n    name: 'mcp_execute_tool',\n    description:\n      'Execute a tool that was discovered via mcp_search_tool_bm25. ' +\n      'You MUST call mcp_get_tool_schema first to know the correct parameters. ' +\n      'Pass the exact tool name and its arguments.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name from mcp_search_tool_bm25 results.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional: The server name provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n        args: {\n          type: 'object',\n          description:\n            \"Arguments matching the tool's inputSchema. Omit or pass {} if the tool takes no parameters.\",\n          additionalProperties: true,\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Meta-tool Executors\n// ---------------------------------------------------------------------------\n\n/**\n * Callback for executing a real MCP tool via the correct client.\n * Provided by adapters that wire up client routing.\n */\nexport type CallToolFn = (\n  toolName: string,\n  args: Record<string, unknown>,\n  namespace?: string\n) => Promise<any>;\n\n/**\n * Execute a meta-tool call and return the result in MCP CallToolResult format.\n *\n * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)\n * @param args - The arguments from the LLM's tool call\n * @param router - The ToolRouter to query\n * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)\n * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool\n */\nexport async function executeMetaTool(\n  toolName: string,\n  args: Record<string, unknown>,\n  router: ToolRouter,\n  callToolFn?: CallToolFn\n): Promise<CallToolResult | null> {\n  const resolveToolSchema = (name: string, namespace?: string): { tool?: Tool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace) };\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      return {\n        error: {\n          content: [{ type: 'text', text: errorMessage }],\n          isError: true,\n        },\n      };\n    }\n  };\n\n  switch (toolName) {\n    case 'mcp_search_tool_bm25': {\n      const query = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchTools(query, limit);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Try different keywords.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_search_tool_regex': {\n      const pattern = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchToolsRegex(pattern, limit);\n\n      const text = results.length === 0\n        ? 'No tools matched your regex pattern. Try a broader pattern.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_get_tool_schema': {\n      const name = String(args.toolName ?? '');\n      const namespace = String(args.serverName ?? '') || undefined;\n      const { tool, error } = resolveToolSchema(name, namespace);\n\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${name}\" not found. Use mcp_search_tool_bm25 to find available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      const schema = {\n        name: tool.name,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      };\n\n      return {\n        content: [{ type: 'text', text: JSON.stringify(schema, null, 2) }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_execute_tool': {\n      const targetToolName = String(args.toolName ?? '');\n      const namespace = String(args.serverName ?? '') || undefined;\n      const toolArgs = (args.args as Record<string, unknown>) ?? {};\n\n      if (!targetToolName) {\n        return {\n          content: [{ type: 'text', text: 'Missing required parameter \"toolName\". Specify which tool to execute.' }],\n          isError: true,\n        };\n      }\n\n      // Verify the tool exists in our index\n      const { tool, error } = resolveToolSchema(targetToolName, namespace);\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${targetToolName}\" not found. Use mcp_search_tool_bm25 to discover available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      if (!callToolFn) {\n        return {\n          content: [{ type: 'text', text: 'Tool execution is not available. No callToolFn was configured.' }],\n          isError: true,\n        };\n      }\n\n      try {\n        const result = await callToolFn(targetToolName, toolArgs, namespace);\n\n        // Normalize result to text\n        if (result && typeof result === 'object' && 'content' in result) {\n          // Already MCP CallToolResult format\n          return result as CallToolResult;\n        }\n\n        const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);\n        return {\n          content: [{ type: 'text', text }],\n          isError: false,\n        };\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Tool execution failed: ${errorMessage}` }],\n          isError: true,\n        };\n      }\n    }\n\n    default:\n      return null;\n  }\n}\n\n/** Check if a tool name is one of the meta-tools. */\nexport function isMetaTool(toolName: string): boolean {\n  return (\n    toolName === 'mcp_search_tool_bm25' ||\n    toolName === 'mcp_search_tool_regex' ||\n    toolName === 'mcp_get_tool_schema' ||\n    toolName === 'mcp_execute_tool'\n  );\n}\n\n/**\n * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.\n * Also automatically strips routing prefixes like tool_{serverId}_.\n * \n * Useful for frontend components that need to determine the actual tool being executed by an AI agent.\n */\nexport function resolveMetaToolProxy(\n  toolName: string,\n  args: Record<string, unknown> | null | undefined\n): { toolName: string; args: Record<string, unknown> } {\n  // Unwrap mcp_execute_tool proxy arguments\n  if (toolName === 'mcp_execute_tool') {\n    const innerName = args?.toolName;\n    const innerArgs = args?.args;\n    return {\n      toolName: typeof innerName === 'string' && innerName ? innerName : toolName,\n      args: innerArgs && typeof innerArgs === 'object' && !Array.isArray(innerArgs)\n        ? (innerArgs as Record<string, unknown>)\n        : {},\n    };\n  }\n\n  // Strip tool_<serverId>_ prefix used by AIAdapter\n  const match = toolName.match(/(?:tool_[^_]+_)?(.+)$/);\n  const resolvedName = match?.[1] ?? toolName;\n\n  return { toolName: resolvedName, args: args ?? {} };\n}\n\n","import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface LangChainAdapterOptions {\n    /** \n     * Prefix for tool names to avoid collision with other tools.\n     * Defaults to the client's serverId.\n     */\n    prefix?: string;\n\n    /**\n     * Whether to simplify error messages returned to the LLM.\n     * If true, returns \"Error: <message>\" string instead of throwing.\n     * @default false\n     */\n    simplifyErrors?: boolean;\n\n    /**\n     * Optional ToolRouter for intelligent tool selection.\n     * See AIAdapterOptions.toolRouter for details.\n     */\n    toolRouter?: ToolRouter;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n    private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n    private z: typeof z | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: LangChainAdapterOptions = {}\n    ) { }\n\n    /**\n     * Lazy-loads LangChain and Zod dependencies\n     */\n    private async ensureDependencies() {\n        if (!this.DynamicStructuredTool) {\n            try {\n                const langchain = await import('@langchain/core/tools');\n                this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n                const zod = await import('zod');\n                this.z = zod.z;\n            } catch (error) {\n                throw new Error(\n                    'LangChain dependencies not installed. Install with:\\n' +\n                    '  npm install @langchain/core zod'\n                );\n            }\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n        if (!client.isConnected()) {\n            return [];\n        }\n\n        await this.ensureDependencies();\n\n        const result = await client.listTools();\n        const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n        return result.tools.map((tool) => {\n            // In a real implementation, you would use a library like 'json-schema-to-zod'\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: `${prefix}_${tool.name}`,\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        return await client.callTool(tool.name, args);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private jsonSchemaToZod(schema: any): z.ZodType<any> {\n        try {\n            const { parseSchema } = require('json-schema-to-zod');\n            const zodSchemaString = parseSchema(schema);\n            // eslint-disable-next-line\n            return new Function('z', 'return ' + zodSchemaString)(this.z);\n        } catch (error) {\n            // Fallback: Accept any object if conversion fails\n            console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n            return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n        }\n    }\n\n    /**\n     * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n     */\n    async getTools(): Promise<StructuredTool[]> {\n        // If a ToolRouter is provided, use its filtered output\n        if (this.options.toolRouter) {\n            return this.getToolsViaRouter(this.options.toolRouter);\n        }\n\n        // Use duck typing instead of instanceof to handle module bundling issues\n        const isMultiSession = typeof (this.client as any).getClients === 'function';\n        const clients = isMultiSession\n            ? (this.client as MultiSessionClient).getClients()\n            : [this.client as MCPClient];\n\n        const results = await Promise.all(\n            clients.map(async (client) => {\n                try {\n                    return await this.transformTools(client);\n                } catch (error) {\n                    console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n                    return [];\n                }\n            })\n        );\n        return results.flat();\n    }\n\n    /**\n     * Build StructuredTools from a ToolRouter's filtered output.\n     *\n     * In `search` strategy, only meta-tools are registered with the framework.\n     * Real tool execution is proxied through `mcp_execute_tool` which uses\n     * `router.callTool()` to route to the correct MCP client.\n     */\n    private async getToolsViaRouter(router: ToolRouter): Promise<StructuredTool[]> {\n        await this.ensureDependencies();\n\n        const filteredTools = await router.getFilteredTools();\n\n        return filteredTools.map((tool) => {\n            const routedTool = tool as typeof tool & { sessionId?: string; serverName?: string };\n            const namespace = routedTool.serverName ?? routedTool.sessionId;\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverName),\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        // Handle meta-tool calls via the router\n                        if (isMetaTool(tool.name)) {\n                            const result = await executeMetaTool(\n                                tool.name,\n                                args,\n                                router,\n                                (name, toolArgs, namespace) => router.callTool(name, toolArgs, namespace)\n                            );\n                            if (result) {\n                                return result.content.map((c: any) => c.text ?? '').join('\\n');\n                            }\n                        }\n\n                        // For non-meta tools in 'all' or 'groups' strategy,\n                        // route directly to the correct MCP client\n                        return await router.callTool(tool.name, args, namespace);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private getRouterToolKey(toolName: string, sessionId?: string, serverName?: string): string {\n        const namespace = sessionId ?? serverName ?? 'mcp';\n        const normalized = namespace\n            .toLowerCase()\n            .replace(/[^a-z0-9]+/g, '_')\n            .replace(/^_+|_+$/g, '') || 'mcp';\n        return `tool_${normalized}_${toolName}`;\n    }\n\n    /**\n     * Convenience static method to fetch tools in a single line.\n     */\n    static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n        return new LangChainAdapter(client, options).getTools();\n    }\n}\n"]}
+{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/langchain-adapter.ts"],"names":["text","namespace"],"mappings":"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","file":"langchain-adapter.js","sourcesContent":["/**\n * Meta-tools — Injectable tool definitions that let the LLM discover and\n * load MCP tools on-demand, following Anthropic's Tool Search pattern.\n *\n * Instead of injecting 50+ full tool schemas into the context window, you\n * inject just these 4 meta-tools. The LLM calls them to find and load\n * only the tools it actually needs.\n *\n * Meta-tools:\n *   • `mcp_search_tool_bm25`  — BM25 natural language search\n *   • `mcp_search_tool_regex` — Regex pattern search\n *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool\n *   • `mcp_execute_tool`      — Execute a discovered tool\n *\n * @packageDocumentation\n */\n\nimport type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolRouter } from './tool-router.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tool_bm25` tool definition.\n *\n * This tool lets the LLM search the full catalog of available MCP tools\n * using a BM25 natural-language query. Returns tool names and descriptions\n * without the full inputSchema to save context space.\n */\nexport function createSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_bm25',\n    description:\n      'Search the catalog of available tools. Returns tool names, descriptions, and server info. ' +\n      'Use this FIRST to find relevant tools before calling them.\\n\\n' +\n      'Query forms:\\n' +\n      '- \"select:Read,Edit,Grep\" — fetch these exact tools by name\\n' +\n      '- \"notebook jupyter\" — keyword search, up to limit best matches\\n' +\n      '- \"+slack send\" — require \"slack\" in the name, rank by remaining terms',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Query to find tools. Use \"select:<tool_name>\" for direct selection, or keywords to search. Prefix keywords with + to require them.',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_search_tool_regex` tool definition.\n * \n * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).\n */\nexport function createRegexSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_regex',\n    description:\n      'Search the catalog of available tools using a Python-style regex pattern. ' +\n      'Matches against tool names, descriptions, and parameter descriptions. ' +\n      'Example patterns: \"^github_\", \"weather\", \"(?i)slack\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Regex pattern to search for (e.g., \"^get_.*_data\", \"database\").',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_get_tool_schema` tool definition.\n *\n * After discovering tools via `mcp_search_tool_bm25` or\n * `mcp_search_tool_regex`, the LLM calls this to load the full\n * inputSchema for a specific tool so it can construct the correct\n * arguments.\n */\nexport function createGetSchemaToolDefinition(): Tool {\n  return {\n    name: 'mcp_get_tool_schema',\n    description:\n      'Get the full input schema (parameters) for a specific tool. ' +\n      'Call this after mcp_search_tool_bm25 to get the parameter details ' +\n      'needed to call a tool correctly.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tool_bm25.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_execute_tool` tool definition.\n *\n * This is the execution meta-tool — the LLM calls this to execute any\n * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.\n * The LLM should first call `mcp_get_tool_schema` to know the correct\n * arguments.\n *\n * Instead of registering every real tool with the framework, we proxy\n * all execution through a single meta-tool.\n */\nexport function createExecuteToolDefinition(): Tool {\n  return {\n    name: 'mcp_execute_tool',\n    description:\n      'Execute a tool that was discovered via mcp_search_tool_bm25. ' +\n      'You MUST call mcp_get_tool_schema first to know the correct parameters. ' +\n      'Pass the exact tool name and its arguments.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name from mcp_search_tool_bm25 results.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n        args: {\n          type: 'object',\n          description:\n            \"Arguments matching the tool's inputSchema. Omit or pass {} if the tool takes no parameters.\",\n          additionalProperties: true,\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Meta-tool Executors\n// ---------------------------------------------------------------------------\n\n/**\n * Callback for executing a real MCP tool via the correct client.\n * Provided by adapters that wire up client routing.\n */\nexport type CallToolFn = (\n  toolName: string,\n  args: Record<string, unknown>,\n  namespace?: string\n) => Promise<any>;\n\n/**\n * Execute a meta-tool call and return the result in MCP CallToolResult format.\n *\n * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)\n * @param args - The arguments from the LLM's tool call\n * @param router - The ToolRouter to query\n * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)\n * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool\n */\nexport async function executeMetaTool(\n  toolName: string,\n  args: Record<string, unknown>,\n  router: ToolRouter,\n  callToolFn?: CallToolFn\n): Promise<CallToolResult | null> {\n  const resolveToolSchema = (name: string, namespace?: string): { tool?: Tool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace) };\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      return {\n        error: {\n          content: [{ type: 'text', text: errorMessage }],\n          isError: true,\n        },\n      };\n    }\n  };\n\n  switch (toolName) {\n    case 'mcp_search_tool_bm25': {\n      const query = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      // Fast path: Check for select: prefix\n      const selectMatch = query.match(/^select:(.+)$/i);\n      if (selectMatch) {\n        const requested = selectMatch[1]!\n          .split(',')\n          .map((s) => s.trim())\n          .filter(Boolean);\n\n        const found: any[] = [];\n        const errors: string[] = [];\n        \n        for (const requestedToolName of requested) {\n          const { tool, error } = resolveToolSchema(requestedToolName);\n          if (error) {\n            const errorMsg = error.content[0]?.type === 'text' ? error.content[0].text : 'Unknown error';\n            errors.push(`- **${requestedToolName}**: ${errorMsg}`);\n          } else if (tool) {\n            found.push(tool);\n          } else {\n            errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);\n          }\n        }\n\n        const lines: string[] = [];\n\n        if (found.length > 0) {\n          lines.push(...found.map((t, i) =>\n            `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n   ${t.description}`\n          ));\n        }\n        \n        if (errors.length > 0) {\n          if (lines.length > 0) lines.push(\"\"); // Add empty line spacing\n          lines.push(\"Errors resolving some tools:\");\n          lines.push(...errors);\n        }\n\n        const text = lines.length > 0 \n          ? lines.join('\\n') \n          : `No tools found matching select query: ${requested.join(', ')}`;\n\n        return {\n          content: [{ type: 'text', text }],\n          isError: found.length === 0,\n        };\n      }\n\n      const results = await router.searchTools(query, limit);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Try different keywords.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_search_tool_regex': {\n      const pattern = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchToolsRegex(pattern, limit);\n\n      const text = results.length === 0\n        ? 'No tools matched your regex pattern. Try a broader pattern.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_get_tool_schema': {\n      const name = String(args.toolName ?? '');\n      const namespace = String(args.serverId ?? '') || undefined;\n      const { tool, error } = resolveToolSchema(name, namespace);\n\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${name}\" not found. Use mcp_search_tool_bm25 to find available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      const schema = {\n        name: tool.name,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      };\n\n      return {\n        content: [{ type: 'text', text: JSON.stringify(schema, null, 2) }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_execute_tool': {\n      const targetToolName = String(args.toolName ?? '');\n      const namespace = String(args.serverId ?? '') || undefined;\n      const toolArgs = (args.args as Record<string, unknown>) ?? {};\n\n      if (!targetToolName) {\n        return {\n          content: [{ type: 'text', text: 'Missing required parameter \"toolName\". Specify which tool to execute.' }],\n          isError: true,\n        };\n      }\n\n      // Verify the tool exists in our index\n      const { tool, error } = resolveToolSchema(targetToolName, namespace);\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${targetToolName}\" not found. Use mcp_search_tool_bm25 to discover available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      if (!callToolFn) {\n        return {\n          content: [{ type: 'text', text: 'Tool execution is not available. No callToolFn was configured.' }],\n          isError: true,\n        };\n      }\n\n      try {\n        const result = await callToolFn(targetToolName, toolArgs, namespace);\n\n        // Normalize result to text\n        if (result && typeof result === 'object' && 'content' in result) {\n          // Already MCP CallToolResult format\n          return result as CallToolResult;\n        }\n\n        const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);\n        return {\n          content: [{ type: 'text', text }],\n          isError: false,\n        };\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Tool execution failed: ${errorMessage}` }],\n          isError: true,\n        };\n      }\n    }\n\n    default:\n      return null;\n  }\n}\n\n/** Check if a tool name is one of the meta-tools. */\nexport function isMetaTool(toolName: string): boolean {\n  return (\n    toolName === 'mcp_search_tool_bm25' ||\n    toolName === 'mcp_search_tool_regex' ||\n    toolName === 'mcp_get_tool_schema' ||\n    toolName === 'mcp_execute_tool'\n  );\n}\n\n/**\n * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.\n * Also automatically strips routing prefixes like tool_{serverId}_.\n * \n * Useful for frontend components that need to determine the actual tool being executed by an AI agent.\n */\nexport function resolveMetaToolProxy(\n  toolName: string,\n  args: Record<string, unknown> | null | undefined\n): { toolName: string; args: Record<string, unknown> } {\n  // Unwrap mcp_execute_tool proxy arguments\n  if (toolName === 'mcp_execute_tool') {\n    const innerName = args?.toolName;\n    const innerArgs = args?.args;\n    return {\n      toolName: typeof innerName === 'string' && innerName ? innerName : toolName,\n      args: innerArgs && typeof innerArgs === 'object' && !Array.isArray(innerArgs)\n        ? (innerArgs as Record<string, unknown>)\n        : {},\n    };\n  }\n\n  // Strip tool_<serverId>_ prefix used by AIAdapter\n  const match = toolName.match(/(?:tool_[^_]+_)?(.+)$/);\n  const resolvedName = match?.[1] ?? toolName;\n\n  return { toolName: resolvedName, args: args ?? {} };\n}\n\n","import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface LangChainAdapterOptions {\n    /** \n     * Prefix for tool names to avoid collision with other tools.\n     * Defaults to the client's serverId.\n     */\n    prefix?: string;\n\n    /**\n     * Whether to simplify error messages returned to the LLM.\n     * If true, returns \"Error: <message>\" string instead of throwing.\n     * @default false\n     */\n    simplifyErrors?: boolean;\n\n    /**\n     * Optional ToolRouter for intelligent tool selection.\n     * See AIAdapterOptions.toolRouter for details.\n     */\n    toolRouter?: ToolRouter;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n    private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n    private z: typeof z | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: LangChainAdapterOptions = {}\n    ) { }\n\n    /**\n     * Lazy-loads LangChain and Zod dependencies\n     */\n    private async ensureDependencies() {\n        if (!this.DynamicStructuredTool) {\n            try {\n                const langchain = await import('@langchain/core/tools');\n                this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n                const zod = await import('zod');\n                this.z = zod.z;\n            } catch (error) {\n                throw new Error(\n                    'LangChain dependencies not installed. Install with:\\n' +\n                    '  npm install @langchain/core zod'\n                );\n            }\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n        if (!client.isConnected()) {\n            return [];\n        }\n\n        await this.ensureDependencies();\n\n        const result = await client.listTools();\n        const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n        return result.tools.map((tool) => {\n            // In a real implementation, you would use a library like 'json-schema-to-zod'\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: `${prefix}_${tool.name}`,\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        return await client.callTool(tool.name, args);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private jsonSchemaToZod(schema: any): z.ZodType<any> {\n        try {\n            const { parseSchema } = require('json-schema-to-zod');\n            const zodSchemaString = parseSchema(schema);\n            // eslint-disable-next-line\n            return new Function('z', 'return ' + zodSchemaString)(this.z);\n        } catch (error) {\n            // Fallback: Accept any object if conversion fails\n            console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n            return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n        }\n    }\n\n    /**\n     * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n     */\n    async getTools(): Promise<StructuredTool[]> {\n        // If a ToolRouter is provided, use its filtered output\n        if (this.options.toolRouter) {\n            return this.getToolsViaRouter(this.options.toolRouter);\n        }\n\n        // Use duck typing instead of instanceof to handle module bundling issues\n        const isMultiSession = typeof (this.client as any).getClients === 'function';\n        const clients = isMultiSession\n            ? (this.client as MultiSessionClient).getClients()\n            : [this.client as MCPClient];\n\n        const results = await Promise.all(\n            clients.map(async (client) => {\n                try {\n                    return await this.transformTools(client);\n                } catch (error) {\n                    console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n                    return [];\n                }\n            })\n        );\n        return results.flat();\n    }\n\n    /**\n     * Build StructuredTools from a ToolRouter's filtered output.\n     *\n     * In `search` strategy, only meta-tools are registered with the framework.\n     * Real tool execution is proxied through `mcp_execute_tool` which uses\n     * `router.callTool()` to route to the correct MCP client.\n     */\n    private async getToolsViaRouter(router: ToolRouter): Promise<StructuredTool[]> {\n        await this.ensureDependencies();\n\n        const filteredTools = await router.getFilteredTools();\n\n        return filteredTools.map((tool) => {\n            const routedTool = tool as typeof tool & { sessionId?: string; serverId?: string; serverName?: string };\n            const namespace = routedTool.serverId ?? routedTool.sessionId;\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverId),\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        // Handle meta-tool calls via the router\n                        if (isMetaTool(tool.name)) {\n                            const result = await executeMetaTool(\n                                tool.name,\n                                args,\n                                router,\n                                (name, toolArgs, namespace) => router.callTool(name, toolArgs, namespace)\n                            );\n                            if (result) {\n                                return result.content.map((c: any) => c.text ?? '').join('\\n');\n                            }\n                        }\n\n                        // For non-meta tools in 'all' or 'groups' strategy,\n                        // route directly to the correct MCP client\n                        return await router.callTool(tool.name, args, namespace);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private getRouterToolKey(toolName: string, sessionId?: string, serverId?: string): string {\n        const namespace = sessionId ?? serverId ?? 'mcp';\n        const normalized = namespace\n            .toLowerCase()\n            .replace(/[^a-z0-9]+/g, '_')\n            .replace(/^_+|_+$/g, '') || 'mcp';\n        return `tool_${normalized}_${toolName}`;\n    }\n\n    /**\n     * Convenience static method to fetch tools in a single line.\n     */\n    static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n        return new LangChainAdapter(client, options).getTools();\n    }\n}\n"]}

package/dist/adapters/langchain-adapter.mjs

@@ -27,9 +27,43 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
     case "mcp_search_tool_bm25": {
       const query = String(args.query ?? "");
       const limit = Math.min(Number(args.limit) || 5, 20);
+      const selectMatch = query.match(/^select:(.+)$/i);
+      if (selectMatch) {
+        const requested = selectMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
+        const found = [];
+        const errors = [];
+        for (const requestedToolName of requested) {
+          const { tool, error } = resolveToolSchema(requestedToolName);
+          if (error) {
+            const errorMsg = error.content[0]?.type === "text" ? error.content[0].text : "Unknown error";
+            errors.push(`- **${requestedToolName}**: ${errorMsg}`);
+          } else if (tool) {
+            found.push(tool);
+          } else {
+            errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);
+          }
+        }
+        const lines = [];
+        if (found.length > 0) {
+          lines.push(...found.map(
+            (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
+   ${t.description}`
+          ));
+        }
+        if (errors.length > 0) {
+          if (lines.length > 0) lines.push("");
+          lines.push("Errors resolving some tools:");
+          lines.push(...errors);
+        }
+        const text2 = lines.length > 0 ? lines.join("\n") : `No tools found matching select query: ${requested.join(", ")}`;
+        return {
+          content: [{ type: "text", text: text2 }],
+          isError: found.length === 0
+        };
+      }
       const results = await router.searchTools(query, limit);
       const text = results.length === 0 ? "No tools found matching your query. Try different keywords." : results.map(
-        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName})
+        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
    ${t.description}
    Estimated tokens: ${t.estimatedTokens}`
       ).join("\n");
@@ -43,7 +77,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
       const limit = Math.min(Number(args.limit) || 5, 20);
       const results = await router.searchToolsRegex(pattern, limit);
       const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : results.map(
-        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName})
+        (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
    ${t.description}
    Estimated tokens: ${t.estimatedTokens}`
       ).join("\n");
@@ -54,7 +88,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
     }
     case "mcp_get_tool_schema": {
       const name = String(args.toolName ?? "");
-      const namespace = String(args.serverName ?? "") || void 0;
+      const namespace = String(args.serverId ?? "") || void 0;
       const { tool, error } = resolveToolSchema(name, namespace);
       if (error) {
         return error;
@@ -82,7 +116,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
     }
     case "mcp_execute_tool": {
       const targetToolName = String(args.toolName ?? "");
-      const namespace = String(args.serverName ?? "") || void 0;
+      const namespace = String(args.serverId ?? "") || void 0;
       const toolArgs = args.args ?? {};
       if (!targetToolName) {
         return {
@@ -231,10 +265,10 @@ var LangChainAdapter = class _LangChainAdapter {
     const filteredTools = await router.getFilteredTools();
     return filteredTools.map((tool) => {
       const routedTool = tool;
-      const namespace = routedTool.serverName ?? routedTool.sessionId;
+      const namespace = routedTool.serverId ?? routedTool.sessionId;
       const schema = this.jsonSchemaToZod(tool.inputSchema);
       return new this.DynamicStructuredTool({
-        name: isMetaTool(tool.name) ? tool.name : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverName),
+        name: isMetaTool(tool.name) ? tool.name : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverId),
         description: tool.description || `Tool ${tool.name}`,
         schema,
         func: async (args) => {
@@ -261,8 +295,8 @@ var LangChainAdapter = class _LangChainAdapter {
       });
     });
   }
-  getRouterToolKey(toolName, sessionId, serverName) {
-    const namespace = sessionId ?? serverName ?? "mcp";
+  getRouterToolKey(toolName, sessionId, serverId) {
+    const namespace = sessionId ?? serverId ?? "mcp";
     const normalized = namespace.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "mcp";
     return `tool_${normalized}_${toolName}`;
   }

package/dist/adapters/langchain-adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/langchain-adapter.ts"],"names":["namespace"],"mappings":"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","file":"langchain-adapter.mjs","sourcesContent":["/**\n * Meta-tools — Injectable tool definitions that let the LLM discover and\n * load MCP tools on-demand, following Anthropic's Tool Search pattern.\n *\n * Instead of injecting 50+ full tool schemas into the context window, you\n * inject just these 4 meta-tools. The LLM calls them to find and load\n * only the tools it actually needs.\n *\n * Meta-tools:\n *   • `mcp_search_tool_bm25`  — BM25 natural language search\n *   • `mcp_search_tool_regex` — Regex pattern search\n *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool\n *   • `mcp_execute_tool`      — Execute a discovered tool\n *\n * @packageDocumentation\n */\n\nimport type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolRouter } from './tool-router.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tool_bm25` tool definition.\n *\n * This tool lets the LLM search the full catalog of available MCP tools\n * using a BM25 natural-language query. Returns tool names and descriptions\n * without the full inputSchema to save context space.\n */\nexport function createSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_bm25',\n    description:\n      'Search the catalog of available tools using BM25 natural language ranking. ' +\n      'Returns tool names, descriptions, and server info. ' +\n      'Use this FIRST to find relevant tools before calling them. ' +\n      'Example queries: \"database query\", \"send email\", \"github pull request\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Natural language description of the capability you need.',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_search_tool_regex` tool definition.\n * \n * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).\n */\nexport function createRegexSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_regex',\n    description:\n      'Search the catalog of available tools using a Python-style regex pattern. ' +\n      'Matches against tool names, descriptions, and parameter descriptions. ' +\n      'Example patterns: \"^github_\", \"weather\", \"(?i)slack\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Regex pattern to search for (e.g., \"^get_.*_data\", \"database\").',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_get_tool_schema` tool definition.\n *\n * After discovering tools via `mcp_search_tool_bm25` or\n * `mcp_search_tool_regex`, the LLM calls this to load the full\n * inputSchema for a specific tool so it can construct the correct\n * arguments.\n */\nexport function createGetSchemaToolDefinition(): Tool {\n  return {\n    name: 'mcp_get_tool_schema',\n    description:\n      'Get the full input schema (parameters) for a specific tool. ' +\n      'Call this after mcp_search_tool_bm25 to get the parameter details ' +\n      'needed to call a tool correctly.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tool_bm25.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional: The server name provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_execute_tool` tool definition.\n *\n * This is the execution meta-tool — the LLM calls this to execute any\n * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.\n * The LLM should first call `mcp_get_tool_schema` to know the correct\n * arguments.\n *\n * Instead of registering every real tool with the framework, we proxy\n * all execution through a single meta-tool.\n */\nexport function createExecuteToolDefinition(): Tool {\n  return {\n    name: 'mcp_execute_tool',\n    description:\n      'Execute a tool that was discovered via mcp_search_tool_bm25. ' +\n      'You MUST call mcp_get_tool_schema first to know the correct parameters. ' +\n      'Pass the exact tool name and its arguments.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name from mcp_search_tool_bm25 results.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional: The server name provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n        args: {\n          type: 'object',\n          description:\n            \"Arguments matching the tool's inputSchema. Omit or pass {} if the tool takes no parameters.\",\n          additionalProperties: true,\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Meta-tool Executors\n// ---------------------------------------------------------------------------\n\n/**\n * Callback for executing a real MCP tool via the correct client.\n * Provided by adapters that wire up client routing.\n */\nexport type CallToolFn = (\n  toolName: string,\n  args: Record<string, unknown>,\n  namespace?: string\n) => Promise<any>;\n\n/**\n * Execute a meta-tool call and return the result in MCP CallToolResult format.\n *\n * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)\n * @param args - The arguments from the LLM's tool call\n * @param router - The ToolRouter to query\n * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)\n * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool\n */\nexport async function executeMetaTool(\n  toolName: string,\n  args: Record<string, unknown>,\n  router: ToolRouter,\n  callToolFn?: CallToolFn\n): Promise<CallToolResult | null> {\n  const resolveToolSchema = (name: string, namespace?: string): { tool?: Tool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace) };\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      return {\n        error: {\n          content: [{ type: 'text', text: errorMessage }],\n          isError: true,\n        },\n      };\n    }\n  };\n\n  switch (toolName) {\n    case 'mcp_search_tool_bm25': {\n      const query = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchTools(query, limit);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Try different keywords.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_search_tool_regex': {\n      const pattern = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchToolsRegex(pattern, limit);\n\n      const text = results.length === 0\n        ? 'No tools matched your regex pattern. Try a broader pattern.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_get_tool_schema': {\n      const name = String(args.toolName ?? '');\n      const namespace = String(args.serverName ?? '') || undefined;\n      const { tool, error } = resolveToolSchema(name, namespace);\n\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${name}\" not found. Use mcp_search_tool_bm25 to find available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      const schema = {\n        name: tool.name,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      };\n\n      return {\n        content: [{ type: 'text', text: JSON.stringify(schema, null, 2) }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_execute_tool': {\n      const targetToolName = String(args.toolName ?? '');\n      const namespace = String(args.serverName ?? '') || undefined;\n      const toolArgs = (args.args as Record<string, unknown>) ?? {};\n\n      if (!targetToolName) {\n        return {\n          content: [{ type: 'text', text: 'Missing required parameter \"toolName\". Specify which tool to execute.' }],\n          isError: true,\n        };\n      }\n\n      // Verify the tool exists in our index\n      const { tool, error } = resolveToolSchema(targetToolName, namespace);\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${targetToolName}\" not found. Use mcp_search_tool_bm25 to discover available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      if (!callToolFn) {\n        return {\n          content: [{ type: 'text', text: 'Tool execution is not available. No callToolFn was configured.' }],\n          isError: true,\n        };\n      }\n\n      try {\n        const result = await callToolFn(targetToolName, toolArgs, namespace);\n\n        // Normalize result to text\n        if (result && typeof result === 'object' && 'content' in result) {\n          // Already MCP CallToolResult format\n          return result as CallToolResult;\n        }\n\n        const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);\n        return {\n          content: [{ type: 'text', text }],\n          isError: false,\n        };\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Tool execution failed: ${errorMessage}` }],\n          isError: true,\n        };\n      }\n    }\n\n    default:\n      return null;\n  }\n}\n\n/** Check if a tool name is one of the meta-tools. */\nexport function isMetaTool(toolName: string): boolean {\n  return (\n    toolName === 'mcp_search_tool_bm25' ||\n    toolName === 'mcp_search_tool_regex' ||\n    toolName === 'mcp_get_tool_schema' ||\n    toolName === 'mcp_execute_tool'\n  );\n}\n\n/**\n * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.\n * Also automatically strips routing prefixes like tool_{serverId}_.\n * \n * Useful for frontend components that need to determine the actual tool being executed by an AI agent.\n */\nexport function resolveMetaToolProxy(\n  toolName: string,\n  args: Record<string, unknown> | null | undefined\n): { toolName: string; args: Record<string, unknown> } {\n  // Unwrap mcp_execute_tool proxy arguments\n  if (toolName === 'mcp_execute_tool') {\n    const innerName = args?.toolName;\n    const innerArgs = args?.args;\n    return {\n      toolName: typeof innerName === 'string' && innerName ? innerName : toolName,\n      args: innerArgs && typeof innerArgs === 'object' && !Array.isArray(innerArgs)\n        ? (innerArgs as Record<string, unknown>)\n        : {},\n    };\n  }\n\n  // Strip tool_<serverId>_ prefix used by AIAdapter\n  const match = toolName.match(/(?:tool_[^_]+_)?(.+)$/);\n  const resolvedName = match?.[1] ?? toolName;\n\n  return { toolName: resolvedName, args: args ?? {} };\n}\n\n","import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface LangChainAdapterOptions {\n    /** \n     * Prefix for tool names to avoid collision with other tools.\n     * Defaults to the client's serverId.\n     */\n    prefix?: string;\n\n    /**\n     * Whether to simplify error messages returned to the LLM.\n     * If true, returns \"Error: <message>\" string instead of throwing.\n     * @default false\n     */\n    simplifyErrors?: boolean;\n\n    /**\n     * Optional ToolRouter for intelligent tool selection.\n     * See AIAdapterOptions.toolRouter for details.\n     */\n    toolRouter?: ToolRouter;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n    private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n    private z: typeof z | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: LangChainAdapterOptions = {}\n    ) { }\n\n    /**\n     * Lazy-loads LangChain and Zod dependencies\n     */\n    private async ensureDependencies() {\n        if (!this.DynamicStructuredTool) {\n            try {\n                const langchain = await import('@langchain/core/tools');\n                this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n                const zod = await import('zod');\n                this.z = zod.z;\n            } catch (error) {\n                throw new Error(\n                    'LangChain dependencies not installed. Install with:\\n' +\n                    '  npm install @langchain/core zod'\n                );\n            }\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n        if (!client.isConnected()) {\n            return [];\n        }\n\n        await this.ensureDependencies();\n\n        const result = await client.listTools();\n        const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n        return result.tools.map((tool) => {\n            // In a real implementation, you would use a library like 'json-schema-to-zod'\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: `${prefix}_${tool.name}`,\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        return await client.callTool(tool.name, args);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private jsonSchemaToZod(schema: any): z.ZodType<any> {\n        try {\n            const { parseSchema } = require('json-schema-to-zod');\n            const zodSchemaString = parseSchema(schema);\n            // eslint-disable-next-line\n            return new Function('z', 'return ' + zodSchemaString)(this.z);\n        } catch (error) {\n            // Fallback: Accept any object if conversion fails\n            console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n            return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n        }\n    }\n\n    /**\n     * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n     */\n    async getTools(): Promise<StructuredTool[]> {\n        // If a ToolRouter is provided, use its filtered output\n        if (this.options.toolRouter) {\n            return this.getToolsViaRouter(this.options.toolRouter);\n        }\n\n        // Use duck typing instead of instanceof to handle module bundling issues\n        const isMultiSession = typeof (this.client as any).getClients === 'function';\n        const clients = isMultiSession\n            ? (this.client as MultiSessionClient).getClients()\n            : [this.client as MCPClient];\n\n        const results = await Promise.all(\n            clients.map(async (client) => {\n                try {\n                    return await this.transformTools(client);\n                } catch (error) {\n                    console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n                    return [];\n                }\n            })\n        );\n        return results.flat();\n    }\n\n    /**\n     * Build StructuredTools from a ToolRouter's filtered output.\n     *\n     * In `search` strategy, only meta-tools are registered with the framework.\n     * Real tool execution is proxied through `mcp_execute_tool` which uses\n     * `router.callTool()` to route to the correct MCP client.\n     */\n    private async getToolsViaRouter(router: ToolRouter): Promise<StructuredTool[]> {\n        await this.ensureDependencies();\n\n        const filteredTools = await router.getFilteredTools();\n\n        return filteredTools.map((tool) => {\n            const routedTool = tool as typeof tool & { sessionId?: string; serverName?: string };\n            const namespace = routedTool.serverName ?? routedTool.sessionId;\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverName),\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        // Handle meta-tool calls via the router\n                        if (isMetaTool(tool.name)) {\n                            const result = await executeMetaTool(\n                                tool.name,\n                                args,\n                                router,\n                                (name, toolArgs, namespace) => router.callTool(name, toolArgs, namespace)\n                            );\n                            if (result) {\n                                return result.content.map((c: any) => c.text ?? '').join('\\n');\n                            }\n                        }\n\n                        // For non-meta tools in 'all' or 'groups' strategy,\n                        // route directly to the correct MCP client\n                        return await router.callTool(tool.name, args, namespace);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private getRouterToolKey(toolName: string, sessionId?: string, serverName?: string): string {\n        const namespace = sessionId ?? serverName ?? 'mcp';\n        const normalized = namespace\n            .toLowerCase()\n            .replace(/[^a-z0-9]+/g, '_')\n            .replace(/^_+|_+$/g, '') || 'mcp';\n        return `tool_${normalized}_${toolName}`;\n    }\n\n    /**\n     * Convenience static method to fetch tools in a single line.\n     */\n    static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n        return new LangChainAdapter(client, options).getTools();\n    }\n}\n"]}
+{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/langchain-adapter.ts"],"names":["text","namespace"],"mappings":"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","file":"langchain-adapter.mjs","sourcesContent":["/**\n * Meta-tools — Injectable tool definitions that let the LLM discover and\n * load MCP tools on-demand, following Anthropic's Tool Search pattern.\n *\n * Instead of injecting 50+ full tool schemas into the context window, you\n * inject just these 4 meta-tools. The LLM calls them to find and load\n * only the tools it actually needs.\n *\n * Meta-tools:\n *   • `mcp_search_tool_bm25`  — BM25 natural language search\n *   • `mcp_search_tool_regex` — Regex pattern search\n *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool\n *   • `mcp_execute_tool`      — Execute a discovered tool\n *\n * @packageDocumentation\n */\n\nimport type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolRouter } from './tool-router.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tool_bm25` tool definition.\n *\n * This tool lets the LLM search the full catalog of available MCP tools\n * using a BM25 natural-language query. Returns tool names and descriptions\n * without the full inputSchema to save context space.\n */\nexport function createSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_bm25',\n    description:\n      'Search the catalog of available tools. Returns tool names, descriptions, and server info. ' +\n      'Use this FIRST to find relevant tools before calling them.\\n\\n' +\n      'Query forms:\\n' +\n      '- \"select:Read,Edit,Grep\" — fetch these exact tools by name\\n' +\n      '- \"notebook jupyter\" — keyword search, up to limit best matches\\n' +\n      '- \"+slack send\" — require \"slack\" in the name, rank by remaining terms',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Query to find tools. Use \"select:<tool_name>\" for direct selection, or keywords to search. Prefix keywords with + to require them.',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_search_tool_regex` tool definition.\n * \n * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).\n */\nexport function createRegexSearchToolDefinition(): Tool {\n  return {\n    name: 'mcp_search_tool_regex',\n    description:\n      'Search the catalog of available tools using a Python-style regex pattern. ' +\n      'Matches against tool names, descriptions, and parameter descriptions. ' +\n      'Example patterns: \"^github_\", \"weather\", \"(?i)slack\".',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description: 'Regex pattern to search for (e.g., \"^get_.*_data\", \"database\").',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5, max: 20).',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_get_tool_schema` tool definition.\n *\n * After discovering tools via `mcp_search_tool_bm25` or\n * `mcp_search_tool_regex`, the LLM calls this to load the full\n * inputSchema for a specific tool so it can construct the correct\n * arguments.\n */\nexport function createGetSchemaToolDefinition(): Tool {\n  return {\n    name: 'mcp_get_tool_schema',\n    description:\n      'Get the full input schema (parameters) for a specific tool. ' +\n      'Call this after mcp_search_tool_bm25 to get the parameter details ' +\n      'needed to call a tool correctly.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tool_bm25.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_execute_tool` tool definition.\n *\n * This is the execution meta-tool — the LLM calls this to execute any\n * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.\n * The LLM should first call `mcp_get_tool_schema` to know the correct\n * arguments.\n *\n * Instead of registering every real tool with the framework, we proxy\n * all execution through a single meta-tool.\n */\nexport function createExecuteToolDefinition(): Tool {\n  return {\n    name: 'mcp_execute_tool',\n    description:\n      'Execute a tool that was discovered via mcp_search_tool_bm25. ' +\n      'You MUST call mcp_get_tool_schema first to know the correct parameters. ' +\n      'Pass the exact tool name and its arguments.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name from mcp_search_tool_bm25 results.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tool_bm25. Required if multiple tools have the same name.',\n        },\n        args: {\n          type: 'object',\n          description:\n            \"Arguments matching the tool's inputSchema. Omit or pass {} if the tool takes no parameters.\",\n          additionalProperties: true,\n        },\n      },\n      required: ['toolName'],\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Meta-tool Executors\n// ---------------------------------------------------------------------------\n\n/**\n * Callback for executing a real MCP tool via the correct client.\n * Provided by adapters that wire up client routing.\n */\nexport type CallToolFn = (\n  toolName: string,\n  args: Record<string, unknown>,\n  namespace?: string\n) => Promise<any>;\n\n/**\n * Execute a meta-tool call and return the result in MCP CallToolResult format.\n *\n * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)\n * @param args - The arguments from the LLM's tool call\n * @param router - The ToolRouter to query\n * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)\n * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool\n */\nexport async function executeMetaTool(\n  toolName: string,\n  args: Record<string, unknown>,\n  router: ToolRouter,\n  callToolFn?: CallToolFn\n): Promise<CallToolResult | null> {\n  const resolveToolSchema = (name: string, namespace?: string): { tool?: Tool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace) };\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      return {\n        error: {\n          content: [{ type: 'text', text: errorMessage }],\n          isError: true,\n        },\n      };\n    }\n  };\n\n  switch (toolName) {\n    case 'mcp_search_tool_bm25': {\n      const query = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      // Fast path: Check for select: prefix\n      const selectMatch = query.match(/^select:(.+)$/i);\n      if (selectMatch) {\n        const requested = selectMatch[1]!\n          .split(',')\n          .map((s) => s.trim())\n          .filter(Boolean);\n\n        const found: any[] = [];\n        const errors: string[] = [];\n        \n        for (const requestedToolName of requested) {\n          const { tool, error } = resolveToolSchema(requestedToolName);\n          if (error) {\n            const errorMsg = error.content[0]?.type === 'text' ? error.content[0].text : 'Unknown error';\n            errors.push(`- **${requestedToolName}**: ${errorMsg}`);\n          } else if (tool) {\n            found.push(tool);\n          } else {\n            errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);\n          }\n        }\n\n        const lines: string[] = [];\n\n        if (found.length > 0) {\n          lines.push(...found.map((t, i) =>\n            `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n   ${t.description}`\n          ));\n        }\n        \n        if (errors.length > 0) {\n          if (lines.length > 0) lines.push(\"\"); // Add empty line spacing\n          lines.push(\"Errors resolving some tools:\");\n          lines.push(...errors);\n        }\n\n        const text = lines.length > 0 \n          ? lines.join('\\n') \n          : `No tools found matching select query: ${requested.join(', ')}`;\n\n        return {\n          content: [{ type: 'text', text }],\n          isError: found.length === 0,\n        };\n      }\n\n      const results = await router.searchTools(query, limit);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Try different keywords.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_search_tool_regex': {\n      const pattern = String(args.query ?? '');\n      const limit = Math.min(Number(args.limit) || 5, 20);\n\n      const results = await router.searchToolsRegex(pattern, limit);\n\n      const text = results.length === 0\n        ? 'No tools matched your regex pattern. Try a broader pattern.'\n        : results\n            .map(\n              (t, i) =>\n                `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})\\n` +\n                `   ${t.description}\\n` +\n                `   Estimated tokens: ${t.estimatedTokens}`\n            )\n            .join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_get_tool_schema': {\n      const name = String(args.toolName ?? '');\n      const namespace = String(args.serverId ?? '') || undefined;\n      const { tool, error } = resolveToolSchema(name, namespace);\n\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${name}\" not found. Use mcp_search_tool_bm25 to find available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      const schema = {\n        name: tool.name,\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n      };\n\n      return {\n        content: [{ type: 'text', text: JSON.stringify(schema, null, 2) }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_execute_tool': {\n      const targetToolName = String(args.toolName ?? '');\n      const namespace = String(args.serverId ?? '') || undefined;\n      const toolArgs = (args.args as Record<string, unknown>) ?? {};\n\n      if (!targetToolName) {\n        return {\n          content: [{ type: 'text', text: 'Missing required parameter \"toolName\". Specify which tool to execute.' }],\n          isError: true,\n        };\n      }\n\n      // Verify the tool exists in our index\n      const { tool, error } = resolveToolSchema(targetToolName, namespace);\n      if (error) {\n        return error;\n      }\n\n      if (!tool) {\n        return {\n          content: [\n            {\n              type: 'text',\n              text: `Tool \"${targetToolName}\" not found. Use mcp_search_tool_bm25 to discover available tools first.`,\n            },\n          ],\n          isError: true,\n        };\n      }\n\n      if (!callToolFn) {\n        return {\n          content: [{ type: 'text', text: 'Tool execution is not available. No callToolFn was configured.' }],\n          isError: true,\n        };\n      }\n\n      try {\n        const result = await callToolFn(targetToolName, toolArgs, namespace);\n\n        // Normalize result to text\n        if (result && typeof result === 'object' && 'content' in result) {\n          // Already MCP CallToolResult format\n          return result as CallToolResult;\n        }\n\n        const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);\n        return {\n          content: [{ type: 'text', text }],\n          isError: false,\n        };\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Tool execution failed: ${errorMessage}` }],\n          isError: true,\n        };\n      }\n    }\n\n    default:\n      return null;\n  }\n}\n\n/** Check if a tool name is one of the meta-tools. */\nexport function isMetaTool(toolName: string): boolean {\n  return (\n    toolName === 'mcp_search_tool_bm25' ||\n    toolName === 'mcp_search_tool_regex' ||\n    toolName === 'mcp_get_tool_schema' ||\n    toolName === 'mcp_execute_tool'\n  );\n}\n\n/**\n * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.\n * Also automatically strips routing prefixes like tool_{serverId}_.\n * \n * Useful for frontend components that need to determine the actual tool being executed by an AI agent.\n */\nexport function resolveMetaToolProxy(\n  toolName: string,\n  args: Record<string, unknown> | null | undefined\n): { toolName: string; args: Record<string, unknown> } {\n  // Unwrap mcp_execute_tool proxy arguments\n  if (toolName === 'mcp_execute_tool') {\n    const innerName = args?.toolName;\n    const innerArgs = args?.args;\n    return {\n      toolName: typeof innerName === 'string' && innerName ? innerName : toolName,\n      args: innerArgs && typeof innerArgs === 'object' && !Array.isArray(innerArgs)\n        ? (innerArgs as Record<string, unknown>)\n        : {},\n    };\n  }\n\n  // Strip tool_<serverId>_ prefix used by AIAdapter\n  const match = toolName.match(/(?:tool_[^_]+_)?(.+)$/);\n  const resolvedName = match?.[1] ?? toolName;\n\n  return { toolName: resolvedName, args: args ?? {} };\n}\n\n","import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface LangChainAdapterOptions {\n    /** \n     * Prefix for tool names to avoid collision with other tools.\n     * Defaults to the client's serverId.\n     */\n    prefix?: string;\n\n    /**\n     * Whether to simplify error messages returned to the LLM.\n     * If true, returns \"Error: <message>\" string instead of throwing.\n     * @default false\n     */\n    simplifyErrors?: boolean;\n\n    /**\n     * Optional ToolRouter for intelligent tool selection.\n     * See AIAdapterOptions.toolRouter for details.\n     */\n    toolRouter?: ToolRouter;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n    private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n    private z: typeof z | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: LangChainAdapterOptions = {}\n    ) { }\n\n    /**\n     * Lazy-loads LangChain and Zod dependencies\n     */\n    private async ensureDependencies() {\n        if (!this.DynamicStructuredTool) {\n            try {\n                const langchain = await import('@langchain/core/tools');\n                this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n                const zod = await import('zod');\n                this.z = zod.z;\n            } catch (error) {\n                throw new Error(\n                    'LangChain dependencies not installed. Install with:\\n' +\n                    '  npm install @langchain/core zod'\n                );\n            }\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n        if (!client.isConnected()) {\n            return [];\n        }\n\n        await this.ensureDependencies();\n\n        const result = await client.listTools();\n        const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n        return result.tools.map((tool) => {\n            // In a real implementation, you would use a library like 'json-schema-to-zod'\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: `${prefix}_${tool.name}`,\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        return await client.callTool(tool.name, args);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private jsonSchemaToZod(schema: any): z.ZodType<any> {\n        try {\n            const { parseSchema } = require('json-schema-to-zod');\n            const zodSchemaString = parseSchema(schema);\n            // eslint-disable-next-line\n            return new Function('z', 'return ' + zodSchemaString)(this.z);\n        } catch (error) {\n            // Fallback: Accept any object if conversion fails\n            console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n            return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n        }\n    }\n\n    /**\n     * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n     */\n    async getTools(): Promise<StructuredTool[]> {\n        // If a ToolRouter is provided, use its filtered output\n        if (this.options.toolRouter) {\n            return this.getToolsViaRouter(this.options.toolRouter);\n        }\n\n        // Use duck typing instead of instanceof to handle module bundling issues\n        const isMultiSession = typeof (this.client as any).getClients === 'function';\n        const clients = isMultiSession\n            ? (this.client as MultiSessionClient).getClients()\n            : [this.client as MCPClient];\n\n        const results = await Promise.all(\n            clients.map(async (client) => {\n                try {\n                    return await this.transformTools(client);\n                } catch (error) {\n                    console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n                    return [];\n                }\n            })\n        );\n        return results.flat();\n    }\n\n    /**\n     * Build StructuredTools from a ToolRouter's filtered output.\n     *\n     * In `search` strategy, only meta-tools are registered with the framework.\n     * Real tool execution is proxied through `mcp_execute_tool` which uses\n     * `router.callTool()` to route to the correct MCP client.\n     */\n    private async getToolsViaRouter(router: ToolRouter): Promise<StructuredTool[]> {\n        await this.ensureDependencies();\n\n        const filteredTools = await router.getFilteredTools();\n\n        return filteredTools.map((tool) => {\n            const routedTool = tool as typeof tool & { sessionId?: string; serverId?: string; serverName?: string };\n            const namespace = routedTool.serverId ?? routedTool.sessionId;\n            const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n            return new this.DynamicStructuredTool!({\n                name: isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverId),\n                description: tool.description || `Tool ${tool.name}`,\n                schema: schema,\n                func: async (args: any) => {\n                    try {\n                        // Handle meta-tool calls via the router\n                        if (isMetaTool(tool.name)) {\n                            const result = await executeMetaTool(\n                                tool.name,\n                                args,\n                                router,\n                                (name, toolArgs, namespace) => router.callTool(name, toolArgs, namespace)\n                            );\n                            if (result) {\n                                return result.content.map((c: any) => c.text ?? '').join('\\n');\n                            }\n                        }\n\n                        // For non-meta tools in 'all' or 'groups' strategy,\n                        // route directly to the correct MCP client\n                        return await router.callTool(tool.name, args, namespace);\n                    } catch (error: any) {\n                        if (this.options.simplifyErrors) {\n                            return `Error: ${error.message}`;\n                        }\n                        throw error;\n                    }\n                },\n            });\n        });\n    }\n\n    private getRouterToolKey(toolName: string, sessionId?: string, serverId?: string): string {\n        const namespace = sessionId ?? serverId ?? 'mcp';\n        const normalized = namespace\n            .toLowerCase()\n            .replace(/[^a-z0-9]+/g, '_')\n            .replace(/^_+|_+$/g, '') || 'mcp';\n        return `tool_${normalized}_${toolName}`;\n    }\n\n    /**\n     * Convenience static method to fetch tools in a single line.\n     */\n    static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n        return new LangChainAdapter(client, options).getTools();\n    }\n}\n"]}

package/dist/client/react.d.mts

@@ -4,7 +4,7 @@ import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
 import { v as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CfCoIsWI.mjs';
 export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CfCoIsWI.mjs';
-import React$1 from 'react';
+import React$1, { ReactNode, CSSProperties } from 'react';
 import '@modelcontextprotocol/ext-apps/app-bridge';
 import '@modelcontextprotocol/sdk/types.js';
 
@@ -100,6 +100,16 @@ interface McpClient$1 {
      * Disconnect from an MCP server
      */
     disconnect: (sessionId: string) => Promise<void>;
+    /**
+     * Reconnect to an MCP server (disconnects existing session first)
+     */
+    reconnect: (params: {
+        serverId: string;
+        serverName: string;
+        serverUrl: string;
+        callbackUrl: string;
+        transportType?: 'sse' | 'streamable_http';
+    }) => Promise<string>;
     /**
      * Get connection by session ID
      */
@@ -170,6 +180,85 @@ interface McpClient$1 {
  */
 declare function useMcp(options: UseMcpOptions): McpClient$1;
 
+interface OAuthPopupConnectionLike {
+    sessionId: string;
+    state: string;
+    error?: string;
+}
+/**
+ * Optional helpers for popup-based OAuth UX.
+ *
+ * These utilities sit on top of the core MCP auth primitives:
+ * - `useMcp({ onRedirect })` to decide how auth navigation happens
+ * - `finishAuth(sessionId, code)` to complete code exchange
+ *
+ * Consumers are free to:
+ * - use these helpers as-is for a turnkey popup flow
+ * - build their own popup UI/message bridge
+ * - skip popups entirely and handle auth in a normal callback page
+ */
+interface OAuthPopupRedirectOptions {
+    width?: number;
+    height?: number;
+    windowName?: string;
+    features?: string[];
+    onBlocked?: (url: string) => void;
+}
+interface McpOAuthCallbackContentProps {
+    code?: string | null;
+    sessionId?: string | null;
+    title?: ReactNode;
+    initialStatus?: string;
+    loadingFallback?: ReactNode;
+    rootStyle?: CSSProperties;
+    cardStyle?: CSSProperties;
+    titleStyle?: CSSProperties;
+    messageStyle?: CSSProperties;
+    renderContainer?: (content: ReactNode) => ReactNode;
+    debugPhase?: 'loading' | 'success' | 'error';
+}
+/**
+ * Opens a centered popup window for OAuth.
+ *
+ * Convenience only: callers can replace this entirely with their own popup,
+ * modal, redirect, or router-based navigation strategy.
+ */
+declare function openCenteredPopup(url: string, options?: OAuthPopupRedirectOptions): Window | null;
+/**
+ * Creates an `onRedirect` handler suitable for `useMcp({ onRedirect })`.
+ *
+ * This is the simplest popup entry point, but it is intentionally optional.
+ * Applications can provide any redirect handler they want, including full-page
+ * navigation or a completely custom popup implementation.
+ */
+declare function createOAuthPopupRedirectHandler(options?: OAuthPopupRedirectOptions): (url: string) => void;
+/**
+ * Handles opener-side popup coordination for OAuth code exchange.
+ *
+ * Use this when you want popup auth but do not want to reimplement the
+ * postMessage wiring between the main app window and the popup callback page.
+ *
+ * If you are not using a popup flow, you do not need this hook.
+ */
+declare function useMcpOAuthPopup<TConnection extends OAuthPopupConnectionLike>(connections: TConnection[], finishAuth: (sessionId: string, code: string) => Promise<unknown>): void;
+/**
+ * Default popup callback UI for popup-based OAuth flows.
+ *
+ * This component reads the OAuth `code` and `state/sessionId`, notifies the
+ * opener window, waits for success/failure, and closes the popup on success.
+ *
+ * It is intentionally optional: apps can replace it with their own callback
+ * page UI or skip popup auth entirely and call `finishAuth(sessionId, code)`
+ * from any callback route they control.
+ */
+declare function McpOAuthCallbackContent({ code, sessionId, title, initialStatus, loadingFallback, rootStyle, cardStyle, titleStyle, messageStyle, renderContainer, debugPhase, }: McpOAuthCallbackContentProps): JSX.Element;
+/**
+ * Tiny fallback component for Suspense-wrapped callback pages.
+ */
+declare function McpOAuthCallbackFallback({ children, }: {
+    children?: ReactNode;
+}): JSX.Element;
+
 /**
  * Hook to host an MCP App in a React component
  *
@@ -256,4 +345,4 @@ declare function useMcpApps(mcpClient: McpClient | null): {
 };
 declare function getMcpAppMetadata(mcpClient: McpClient | null, toolName: string, input?: Record<string, unknown> | null): McpAppMetadata | undefined;
 
-export { AppHost, type McpAppMetadata, McpAppRenderer, type McpAppRendererHandle, type McpAppRendererProps, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, SSEClient, ToolInfo, type UseMcpOptions, getMcpAppMetadata, useAppHost, useMcp, useMcpApps };
+export { AppHost, type McpAppMetadata, McpAppRenderer, type McpAppRendererHandle, type McpAppRendererProps, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, McpOAuthCallbackContent, type McpOAuthCallbackContentProps, McpOAuthCallbackFallback, type OAuthPopupConnectionLike, type OAuthPopupRedirectOptions, SSEClient, ToolInfo, type UseMcpOptions, createOAuthPopupRedirectHandler, getMcpAppMetadata, openCenteredPopup, useAppHost, useMcp, useMcpApps, useMcpOAuthPopup };