@mcp-ts/sdk 1.6.1 → 2.0.0

package/dist/adapters/agui-middleware.d.mts

@@ -2,13 +2,13 @@ import { Observable } from 'rxjs';
 import { Middleware, RunAgentInput, AbstractAgent, BaseEvent } from '@ag-ui/client';
 export { AbstractAgent, BaseEvent, EventType, Middleware, RunAgentInput, Tool, ToolCallEndEvent } from '@ag-ui/client';
 import { AguiTool } from './agui-adapter.mjs';
-import '../multi-session-client-CQsRbxYI.mjs';
+import '../multi-session-client-DYNe6az3.mjs';
 import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/sdk/shared/auth.js';
-import '../tool-router-BVaV1udm.mjs';
-import '../types-rIuN1CQi.mjs';
+import '../tool-router-Dnd6IOKC.mjs';
+import '../types-BCAG20P6.mjs';
 
 /**
  * AG-UI Middleware for MCP Tool Execution

package/dist/adapters/agui-middleware.d.ts

@@ -2,13 +2,13 @@ import { Observable } from 'rxjs';
 import { Middleware, RunAgentInput, AbstractAgent, BaseEvent } from '@ag-ui/client';
 export { AbstractAgent, BaseEvent, EventType, Middleware, RunAgentInput, Tool, ToolCallEndEvent } from '@ag-ui/client';
 import { AguiTool } from './agui-adapter.js';
-import '../multi-session-client-CHE8QpVE.js';
+import '../multi-session-client-BYtguGJm.js';
 import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/sdk/shared/auth.js';
-import '../tool-router-Dh2804tM.js';
-import '../types-rIuN1CQi.js';
+import '../tool-router-Ddtybmr0.js';
+import '../types-BCAG20P6.js';
 
 /**
  * AG-UI Middleware for MCP Tool Execution

package/dist/adapters/ai-adapter.d.mts

@@ -1,11 +1,11 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CQsRbxYI.mjs';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DYNe6az3.mjs';
 import { ToolSet } from 'ai';
-import { e as ToolRouter } from '../tool-router-BVaV1udm.mjs';
+import { d as ToolRouter } from '../tool-router-Dnd6IOKC.mjs';
 import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/sdk/shared/auth.js';
-import '../types-rIuN1CQi.mjs';
+import '../types-BCAG20P6.mjs';
 
 interface AIAdapterOptions {
     /**
@@ -23,6 +23,12 @@ interface AIAdapterOptions {
      * When not provided, all tools are returned as before (backward-compatible).
      */
     toolRouter?: ToolRouter;
+    /**
+     * Optional custom callback to determine if a tool requires user approval.
+     * Can return a boolean or a Promise<boolean>.
+     * If not provided, defaults to checking the tool's `destructiveHint` annotation.
+     */
+    needsApproval?: (tool: any, args: any) => boolean | Promise<boolean>;
 }
 /**
  * Adapter to use MCP tools with the Vercel AI SDK.

package/dist/adapters/ai-adapter.d.ts

@@ -1,11 +1,11 @@
-import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CHE8QpVE.js';
+import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-BYtguGJm.js';
 import { ToolSet } from 'ai';
-import { e as ToolRouter } from '../tool-router-Dh2804tM.js';
+import { d as ToolRouter } from '../tool-router-Ddtybmr0.js';
 import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/sdk/shared/auth.js';
-import '../types-rIuN1CQi.js';
+import '../types-BCAG20P6.js';
 
 interface AIAdapterOptions {
     /**
@@ -23,6 +23,12 @@ interface AIAdapterOptions {
      * When not provided, all tools are returned as before (backward-compatible).
      */
     toolRouter?: ToolRouter;
+    /**
+     * Optional custom callback to determine if a tool requires user approval.
+     * Can return a boolean or a Promise<boolean>.
+     * If not provided, defaults to checking the tool's `destructiveHint` annotation.
+     */
+    needsApproval?: (tool: any, args: any) => boolean | Promise<boolean>;
 }
 /**
  * Adapter to use MCP tools with the Vercel AI SDK.

package/dist/adapters/ai-adapter.js

@@ -80,7 +80,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         const lines = [];
         if (found.length > 0) {
           lines.push(...found.map(
-            (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
+            (t, i) => `${i + 1}. **${t.name}** (serverName: ${t.serverName}, serverId: ${t.serverId})
    ${t.description}`
           ));
         }
@@ -108,7 +108,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         serverName: query || void 0
       });
       const text = servers.length === 0 ? "No connected servers found." : servers.map(
-        (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})
+        (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId})
    Tool count: ${server.toolCount}`
       ).join("\n");
       return {
@@ -215,9 +215,8 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
 }
 function formatToolSummaries(tools) {
   return tools.map(
-    (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
-   ${t.description}
-   Estimated tokens: ${t.estimatedTokens}`
+    (t, i) => `${i + 1}. **${t.name}** (serverName: ${t.serverName}, serverId: ${t.serverId})
+   ${t.description}`
   );
 }
 function isMetaTool(toolName) {
@@ -263,7 +262,8 @@ var AIAdapter = class _AIAdapter {
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 throw new Error(`Tool execution failed: ${errorMessage}`);
               }
-            }
+            },
+            needsApproval: this.options.needsApproval ? (args) => this.options.needsApproval(tool, args) : tool.annotations?.destructiveHint === true ? () => true : void 0
           }
         ];
       })
@@ -324,6 +324,20 @@ var AIAdapter = class _AIAdapter {
                 }
               }
               return await router.callTool(tool.name, args, namespace);
+            },
+            needsApproval: this.options.needsApproval ? (args) => this.options.needsApproval(tool, args) : (args) => {
+              if (tool.name === "mcp_execute_tool") {
+                const targetToolName = String(args?.toolName ?? "");
+                const targetNamespace = String(args?.serverId ?? "") || void 0;
+                if (!targetToolName) return false;
+                try {
+                  const targetTool = router.getToolSchema(targetToolName, targetNamespace);
+                  return targetTool?.annotations?.destructiveHint === true;
+                } catch {
+                  return false;
+                }
+              }
+              return tool.annotations?.destructiveHint === true;
             }
           }
         ];

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/ai-adapter.ts"],"names":["limit","text"],"mappings":"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","file":"ai-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_tools`      — Search/list available tools\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';\nimport type { IndexedTool, ToolLookupOptions } from './tool-index.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tools` 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_tools',\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        operation: {\n          type: 'string',\n          enum: ['search', 'list'],\n          description:\n            'Operation to perform. Use \"search\" to find relevant tools by capability. Use \"list\" with serverId or serverName when the user asks for every tool from a connected MCP server.',\n        },\n        serverId: {\n          type: 'string',\n          description: 'Optional server ID to restrict search/list results to one MCP server.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional server name fragment to restrict search/list results to matching MCP servers, e.g. \"supabase\".',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5 for search, 20 for list; max: 20 for search, 100 for list).',\n        },\n        cursor: {\n          type: 'string',\n          description: 'Optional pagination cursor returned by operation \"list\".',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_list_servers` tool definition.\n *\n * This tool lets the LLM inspect connected MCP servers before doing\n * server-scoped tool discovery.\n */\nexport function createListServersToolDefinition(): Tool {\n  return {\n    name: 'mcp_list_servers',\n    description:\n      'List connected MCP servers and their tool counts. ' +\n      'Use this when mcp_search_tools returns no matches, then retry mcp_search_tools with serverId or serverName.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description:\n            'Optional server filter text. Matches server name or serverId, e.g. \"web\" or \"supabase\".',\n        },\n      },\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_tools` 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_tools to get the parameter details ' +\n      'needed to call a tool correctly. ' +\n      'Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tools.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tools. 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_tools` 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_tools. ' +\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_tools results.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tools. 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_tools, mcp_list_servers, 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 = (\n    name: string,\n    namespace?: string,\n    options?: ToolLookupOptions\n  ): { tool?: IndexedTool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace, options) };\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_tools': {\n      const query = String(args.query ?? '');\n      const operation = String(args.operation ?? 'search');\n      const serverId = String(args.serverId ?? '') || undefined;\n      const serverName = String(args.serverName ?? '') || undefined;\n\n      if (operation === 'list') {\n        const limit = Math.min(Number(args.limit) || 20, 100);\n        const cursor = String(args.cursor ?? '') || undefined;\n        const result = await router.listTools({\n          serverId,\n          serverName: serverName ?? (!serverId && query ? query : undefined),\n          limit,\n          cursor,\n        });\n\n        const serverText = result.servers.length > 0\n          ? result.servers\n              .map((server) => `${server.serverName} (serverId: ${server.serverId}, tools: ${server.toolCount})`)\n              .join(', ')\n          : 'none';\n\n        const lines: string[] = [\n          'operation: list',\n          `servers: ${serverText}`,\n          `totalCount: ${result.totalCount}`,\n          `returnedCount: ${result.returnedCount}`,\n          `nextCursor: ${result.nextCursor ?? 'null'}`,\n          '',\n        ];\n\n        if (result.tools.length > 0) {\n          lines.push(...formatToolSummaries(result.tools));\n        } else {\n          lines.push(\n            serverId || serverName\n              ? 'No tools found for the requested server scope.'\n              : 'No tools found. Try operation \"search\" or provide serverId/serverName.'\n          );\n        }\n\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          isError: false,\n        };\n      }\n\n      const limit = Math.min(Number(args.limit) || 5, 20);\n      const searchOptions = { serverId, serverName };\n\n      // Fast path: Check for select: prefix\n      const selectMatch = query.match(/^select:(.+)$/i);\n      if (selectMatch) {\n        await router.listTools({ serverId, serverName, limit: 1 });\n\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        const namespace = serverId ?? serverName;\n\n        for (const requestedToolName of requested) {\n          const { tool, error } = resolveToolSchema(requestedToolName, namespace, {\n            allowServerNameFragment: Boolean(serverName && !serverId),\n          });\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_tools.`);\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, searchOptions);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Call mcp_list_servers to inspect connected servers, then retry mcp_search_tools with serverId or serverName.'\n        : formatToolSummaries(results).join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_list_servers': {\n      const query = String(args.query ?? '').trim();\n      const servers = await router.listServers({\n        serverName: query || undefined,\n      });\n\n      const text = servers.length === 0\n        ? 'No connected servers found.'\n        : servers\n            .map(\n              (server, i) =>\n                `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})\\n` +\n                `   Tool count: ${server.toolCount}`\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        : formatToolSummaries(results).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_tools 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        executionInstructions: {\n          nextTool: 'mcp_execute_tool',\n          toolName: tool.name,\n          serverId: tool.serverId,\n          note:\n            'Do not call this discovered tool directly unless it was explicitly registered as a runtime tool. Execute it via mcp_execute_tool and pass these parameters inside args.',\n        },\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_tools 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\nfunction formatToolSummaries(\n  tools: Array<{\n    name: string;\n    description: string;\n    serverName: string;\n    serverId: string;\n    estimatedTokens: number;\n  }>\n): string[] {\n  return tools.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}\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_tools' ||\n    toolName === 'mcp_list_servers' ||\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 { JSONSchema7 } from 'json-schema';\nimport type { ToolSet } from 'ai';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface AIAdapterOptions {\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     * Optional ToolRouter for intelligent tool selection.\n     *\n     * When provided with `strategy: 'search'`, the adapter exposes only\n     * meta-tools (search_tools, get_tool_schema) instead of all tool schemas,\n     * reducing context window usage by 80–95%.\n     *\n     * When not provided, all tools are returned as before (backward-compatible).\n     */\n    toolRouter?: ToolRouter;\n}\n\n/**\n * Adapter to use MCP tools with the Vercel AI SDK.\n */\nexport class AIAdapter {\n    private jsonSchema: typeof import('ai').jsonSchema | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: AIAdapterOptions = {}\n    ) { }\n\n\n\n    /**\n     * Lazy-loads the jsonSchema function from the AI SDK.\n     */\n    private async ensureJsonSchema() {\n        if (!this.jsonSchema) {\n            const { jsonSchema } = await import('ai');\n            this.jsonSchema = jsonSchema;\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<ToolSet> {\n        // Safe check for isConnected method (duck typing for bundler compatibility)\n        const isConnected = typeof client.isConnected === 'function'\n            ? client.isConnected()\n            : false;\n\n        if (!isConnected) {\n            return {};\n        }\n\n        const result = await client.listTools();\n\n        // @ts-ignore: ToolSet type inference can be tricky with dynamic imports\n        return Object.fromEntries(\n            result.tools.map((tool) => {\n                // Safe access to getServerId\n                const serverId = typeof client.getServerId === 'function'\n                    ? client.getServerId()\n                    : undefined;\n                const prefix = this.options.prefix ?? serverId?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n                return [\n                    `tool_${prefix}_${tool.name}`,\n                    {\n                        description: tool.description,\n                        inputSchema: this.jsonSchema!(tool.inputSchema as JSONSchema7),\n                        execute: async (args: any) => {\n                            try {\n                                const response = await client.callTool(tool.name, args);\n                                return response;\n                            } catch (error) {\n                                const errorMessage = error instanceof Error ? error.message : String(error);\n                                throw new Error(`Tool execution failed: ${errorMessage}`);\n                            }\n                        }\n                    }\n                ];\n            })\n        );\n    }\n\n    /**\n     * Fetches tools from the client(s) and converts them to AI SDK tools.\n     */\n    async getTools(): Promise<ToolSet> {\n        await this.ensureJsonSchema();\n\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        // MultiSessionClient has getClients(), MCPClient does not\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                    // For multi-client, we log and continue.\n                    // This is safer than throwing.\n                    const serverId = typeof client.getServerId === 'function'\n                        ? client.getServerId() ?? 'unknown'\n                        : 'unknown';\n                    console.error(`[AIAdapter] Failed to fetch tools from ${serverId}:`, error);\n                    return {};\n                }\n            })\n        );\n\n        return results.reduce((acc, tools) => ({ ...acc, ...tools }), {});\n    }\n\n    /**\n     * Build a ToolSet 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<ToolSet> {\n        const filteredTools = await router.getFilteredTools();\n\n        // @ts-ignore: ToolSet type inference can be tricky with dynamic imports\n        return Object.fromEntries(\n            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 toolKey = isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverId);\n\n                return [\n                    toolKey,\n                    {\n                        description: tool.description,\n                        inputSchema: this.jsonSchema!(tool.inputSchema as JSONSchema7),\n                        execute: async (args: any) => {\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, targetNamespace) => router.callTool(name, toolArgs, targetNamespace)\n                                );\n                                if (result) {\n                                  return result;\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                        },\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: AIAdapterOptions = {}): Promise<ToolSet> {\n        return new AIAdapter(client, options).getTools();\n    }\n}\n"]}
+{"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/ai-adapter.ts"],"names":["limit","text"],"mappings":"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","file":"ai-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_tools`      — Search/list available tools\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';\nimport type { IndexedTool, ToolLookupOptions } from './tool-index.js';\n\n// ---------------------------------------------------------------------------\n// Tool Definitions\n// ---------------------------------------------------------------------------\n\n/**\n * Creates the `mcp_search_tools` 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_tools',\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        operation: {\n          type: 'string',\n          enum: ['search', 'list'],\n          description:\n            'Operation to perform. Use \"search\" to find relevant tools by capability. Use \"list\" with serverId or serverName when the user asks for every tool from a connected MCP server.',\n        },\n        serverId: {\n          type: 'string',\n          description: 'Optional server ID to restrict search/list results to one MCP server.',\n        },\n        serverName: {\n          type: 'string',\n          description:\n            'Optional server name fragment to restrict search/list results to matching MCP servers, e.g. \"supabase\".',\n        },\n        limit: {\n          type: 'number',\n          description: 'Maximum number of results to return (default: 5 for search, 20 for list; max: 20 for search, 100 for list).',\n        },\n        cursor: {\n          type: 'string',\n          description: 'Optional pagination cursor returned by operation \"list\".',\n        },\n      },\n      required: ['query'],\n    },\n  };\n}\n\n/**\n * Creates the `mcp_list_servers` tool definition.\n *\n * This tool lets the LLM inspect connected MCP servers before doing\n * server-scoped tool discovery.\n */\nexport function createListServersToolDefinition(): Tool {\n  return {\n    name: 'mcp_list_servers',\n    description:\n      'List connected MCP servers and their tool counts. ' +\n      'Use this when mcp_search_tools returns no matches, then retry mcp_search_tools with serverId or serverName.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: {\n          type: 'string',\n          description:\n            'Optional server filter text. Matches server name or serverId, e.g. \"web\" or \"supabase\".',\n        },\n      },\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_tools` 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_tools to get the parameter details ' +\n      'needed to call a tool correctly. ' +\n      'Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        toolName: {\n          type: 'string',\n          description: 'The exact tool name returned by mcp_search_tools.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tools. 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_tools` 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_tools. ' +\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_tools results.',\n        },\n        serverId: {\n          type: 'string',\n          description:\n            'Optional: The server ID provided in mcp_search_tools. 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_tools, mcp_list_servers, 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 = (\n    name: string,\n    namespace?: string,\n    options?: ToolLookupOptions\n  ): { tool?: IndexedTool; error?: CallToolResult } => {\n    try {\n      return { tool: router.getToolSchema(name, namespace, options) };\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_tools': {\n      const query = String(args.query ?? '');\n      const operation = String(args.operation ?? 'search');\n      const serverId = String(args.serverId ?? '') || undefined;\n      const serverName = String(args.serverName ?? '') || undefined;\n\n      if (operation === 'list') {\n        const limit = Math.min(Number(args.limit) || 20, 100);\n        const cursor = String(args.cursor ?? '') || undefined;\n        const result = await router.listTools({\n          serverId,\n          serverName: serverName ?? (!serverId && query ? query : undefined),\n          limit,\n          cursor,\n        });\n\n        const serverText = result.servers.length > 0\n          ? result.servers\n              .map((server) => `${server.serverName} (serverId: ${server.serverId}, tools: ${server.toolCount})`)\n              .join(', ')\n          : 'none';\n\n        const lines: string[] = [\n          'operation: list',\n          `servers: ${serverText}`,\n          `totalCount: ${result.totalCount}`,\n          `returnedCount: ${result.returnedCount}`,\n          `nextCursor: ${result.nextCursor ?? 'null'}`,\n          '',\n        ];\n\n        if (result.tools.length > 0) {\n          lines.push(...formatToolSummaries(result.tools));\n        } else {\n          lines.push(\n            serverId || serverName\n              ? 'No tools found for the requested server scope.'\n              : 'No tools found. Try operation \"search\" or provide serverId/serverName.'\n          );\n        }\n\n        return {\n          content: [{ type: 'text', text: lines.join('\\n') }],\n          isError: false,\n        };\n      }\n\n      const limit = Math.min(Number(args.limit) || 5, 20);\n      const searchOptions = { serverId, serverName };\n\n      // Fast path: Check for select: prefix\n      const selectMatch = query.match(/^select:(.+)$/i);\n      if (selectMatch) {\n        await router.listTools({ serverId, serverName, limit: 1 });\n\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        const namespace = serverId ?? serverName;\n\n        for (const requestedToolName of requested) {\n          const { tool, error } = resolveToolSchema(requestedToolName, namespace, {\n            allowServerNameFragment: Boolean(serverName && !serverId),\n          });\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_tools.`);\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}** (serverName: ${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, searchOptions);\n\n      const text = results.length === 0\n        ? 'No tools found matching your query. Call mcp_list_servers to inspect connected servers, then retry mcp_search_tools with serverId or serverName.'\n        : formatToolSummaries(results).join('\\n');\n\n      return {\n        content: [{ type: 'text', text }],\n        isError: false,\n      };\n    }\n\n    case 'mcp_list_servers': {\n      const query = String(args.query ?? '').trim();\n      const servers = await router.listServers({\n        serverName: query || undefined,\n      });\n\n      const text = servers.length === 0\n        ? 'No connected servers found.'\n        : servers\n            .map(\n              (server, i) =>\n                `${i + 1}. **${server.serverName}** (serverId: ${server.serverId})\\n` +\n                `   Tool count: ${server.toolCount}`\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        : formatToolSummaries(results).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_tools 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        executionInstructions: {\n          nextTool: 'mcp_execute_tool',\n          toolName: tool.name,\n          serverId: tool.serverId,\n          note:\n            'Do not call this discovered tool directly unless it was explicitly registered as a runtime tool. Execute it via mcp_execute_tool and pass these parameters inside args.',\n        },\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_tools 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\nfunction formatToolSummaries(\n  tools: Array<{\n    name: string;\n    description: string;\n    serverName: string;\n    serverId: string;\n  }>\n): string[] {\n  return tools.map(\n    (t, i) =>\n      `${i + 1}. **${t.name}** (serverName: ${t.serverName}, serverId: ${t.serverId})\\n` +\n      `   ${t.description}`\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_tools' ||\n    toolName === 'mcp_list_servers' ||\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 { JSONSchema7 } from 'json-schema';\nimport type { ToolSet } from 'ai';\nimport { ToolRouter } from '../shared/tool-router.js';\nimport { executeMetaTool, isMetaTool } from '../shared/meta-tools.js';\n\nexport interface AIAdapterOptions {\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     * Optional ToolRouter for intelligent tool selection.\n     *\n     * When provided with `strategy: 'search'`, the adapter exposes only\n     * meta-tools (search_tools, get_tool_schema) instead of all tool schemas,\n     * reducing context window usage by 80–95%.\n     *\n     * When not provided, all tools are returned as before (backward-compatible).\n     */\n    toolRouter?: ToolRouter;\n\n    /**\n     * Optional custom callback to determine if a tool requires user approval.\n     * Can return a boolean or a Promise<boolean>.\n     * If not provided, defaults to checking the tool's `destructiveHint` annotation.\n     */\n    needsApproval?: (tool: any, args: any) => boolean | Promise<boolean>;\n}\n\n/**\n * Adapter to use MCP tools with the Vercel AI SDK.\n */\nexport class AIAdapter {\n    private jsonSchema: typeof import('ai').jsonSchema | undefined;\n\n    constructor(\n        private client: MCPClient | MultiSessionClient,\n        private options: AIAdapterOptions = {}\n    ) { }\n\n\n\n    /**\n     * Lazy-loads the jsonSchema function from the AI SDK.\n     */\n    private async ensureJsonSchema() {\n        if (!this.jsonSchema) {\n            const { jsonSchema } = await import('ai');\n            this.jsonSchema = jsonSchema;\n        }\n    }\n\n    private async transformTools(client: MCPClient): Promise<ToolSet> {\n        // Safe check for isConnected method (duck typing for bundler compatibility)\n        const isConnected = typeof client.isConnected === 'function'\n            ? client.isConnected()\n            : false;\n\n        if (!isConnected) {\n            return {};\n        }\n\n        const result = await client.listTools();\n\n        // @ts-ignore: ToolSet type inference can be tricky with dynamic imports\n        return Object.fromEntries(\n            result.tools.map((tool) => {\n                // Safe access to getServerId\n                const serverId = typeof client.getServerId === 'function'\n                    ? client.getServerId()\n                    : undefined;\n                const prefix = this.options.prefix ?? serverId?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n                return [\n                    `tool_${prefix}_${tool.name}`,\n                    {\n                        description: tool.description,\n                        inputSchema: this.jsonSchema!(tool.inputSchema as JSONSchema7),\n                        execute: async (args: any) => {\n                            try {\n                                const response = await client.callTool(tool.name, args);\n                                return response;\n                            } catch (error) {\n                                const errorMessage = error instanceof Error ? error.message : String(error);\n                                throw new Error(`Tool execution failed: ${errorMessage}`);\n                            }\n                        },\n                        needsApproval: this.options.needsApproval\n                            ? (args: any) => this.options.needsApproval!(tool, args)\n                            : (tool.annotations as any)?.destructiveHint === true\n                                ? () => true\n                                : undefined\n                    }\n                ];\n            })\n        );\n    }\n\n    /**\n     * Fetches tools from the client(s) and converts them to AI SDK tools.\n     */\n    async getTools(): Promise<ToolSet> {\n        await this.ensureJsonSchema();\n\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        // MultiSessionClient has getClients(), MCPClient does not\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                    // For multi-client, we log and continue.\n                    // This is safer than throwing.\n                    const serverId = typeof client.getServerId === 'function'\n                        ? client.getServerId() ?? 'unknown'\n                        : 'unknown';\n                    console.error(`[AIAdapter] Failed to fetch tools from ${serverId}:`, error);\n                    return {};\n                }\n            })\n        );\n\n        return results.reduce((acc, tools) => ({ ...acc, ...tools }), {});\n    }\n\n    /**\n     * Build a ToolSet 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<ToolSet> {\n        const filteredTools = await router.getFilteredTools();\n\n        // @ts-ignore: ToolSet type inference can be tricky with dynamic imports\n        return Object.fromEntries(\n            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 toolKey = isMetaTool(tool.name)\n                    ? tool.name\n                    : this.getRouterToolKey(tool.name, routedTool.sessionId, routedTool.serverId);\n\n                return [\n                    toolKey,\n                    {\n                        description: tool.description,\n                        inputSchema: this.jsonSchema!(tool.inputSchema as JSONSchema7),\n                        execute: async (args: any) => {\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, targetNamespace) => router.callTool(name, toolArgs, targetNamespace)\n                                );\n                                if (result) {\n                                  return result;\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                        },\n                        needsApproval: this.options.needsApproval\n                            ? (args: any) => this.options.needsApproval!(tool, args)\n                            : (args: any) => {\n                                // Default HITL logic using annotations\n                                if (tool.name === 'mcp_execute_tool') {\n                                    const targetToolName = String(args?.toolName ?? \"\");\n                                    const targetNamespace = String(args?.serverId ?? \"\") || undefined;\n                                    if (!targetToolName) return false;\n                                    try {\n                                        const targetTool = router.getToolSchema(targetToolName, targetNamespace);\n                                        return (targetTool as any)?.annotations?.destructiveHint === true;\n                                    } catch {\n                                        return false;\n                                    }\n                                }\n                                return (tool.annotations as any)?.destructiveHint === true;\n                            }\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: AIAdapterOptions = {}): Promise<ToolSet> {\n        return new AIAdapter(client, options).getTools();\n    }\n}\n"]}

package/dist/adapters/ai-adapter.mjs

@@ -78,7 +78,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         const lines = [];
         if (found.length > 0) {
           lines.push(...found.map(
-            (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
+            (t, i) => `${i + 1}. **${t.name}** (serverName: ${t.serverName}, serverId: ${t.serverId})
    ${t.description}`
           ));
         }
@@ -106,7 +106,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         serverName: query || void 0
       });
       const text = servers.length === 0 ? "No connected servers found." : servers.map(
-        (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})
+        (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId})
    Tool count: ${server.toolCount}`
       ).join("\n");
       return {
@@ -213,9 +213,8 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
 }
 function formatToolSummaries(tools) {
   return tools.map(
-    (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
-   ${t.description}
-   Estimated tokens: ${t.estimatedTokens}`
+    (t, i) => `${i + 1}. **${t.name}** (serverName: ${t.serverName}, serverId: ${t.serverId})
+   ${t.description}`
   );
 }
 function isMetaTool(toolName) {
@@ -261,7 +260,8 @@ var AIAdapter = class _AIAdapter {
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 throw new Error(`Tool execution failed: ${errorMessage}`);
               }
-            }
+            },
+            needsApproval: this.options.needsApproval ? (args) => this.options.needsApproval(tool, args) : tool.annotations?.destructiveHint === true ? () => true : void 0
           }
         ];
       })
@@ -322,6 +322,20 @@ var AIAdapter = class _AIAdapter {
                 }
               }
               return await router.callTool(tool.name, args, namespace);
+            },
+            needsApproval: this.options.needsApproval ? (args) => this.options.needsApproval(tool, args) : (args) => {
+              if (tool.name === "mcp_execute_tool") {
+                const targetToolName = String(args?.toolName ?? "");
+                const targetNamespace = String(args?.serverId ?? "") || void 0;
+                if (!targetToolName) return false;
+                try {
+                  const targetTool = router.getToolSchema(targetToolName, targetNamespace);
+                  return targetTool?.annotations?.destructiveHint === true;
+                } catch {
+                  return false;
+                }
+              }
+              return tool.annotations?.destructiveHint === true;
             }
           }
         ];