@mcp-ts/sdk 1.5.3 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/dist/adapters/agui-adapter.d.mts +2 -2
  2. package/dist/adapters/agui-adapter.d.ts +2 -2
  3. package/dist/adapters/agui-adapter.js +69 -18
  4. package/dist/adapters/agui-adapter.js.map +1 -1
  5. package/dist/adapters/agui-adapter.mjs +69 -18
  6. package/dist/adapters/agui-adapter.mjs.map +1 -1
  7. package/dist/adapters/agui-middleware.d.mts +2 -2
  8. package/dist/adapters/agui-middleware.d.ts +2 -2
  9. package/dist/adapters/ai-adapter.d.mts +2 -2
  10. package/dist/adapters/ai-adapter.d.ts +2 -2
  11. package/dist/adapters/ai-adapter.js +69 -18
  12. package/dist/adapters/ai-adapter.js.map +1 -1
  13. package/dist/adapters/ai-adapter.mjs +69 -18
  14. package/dist/adapters/ai-adapter.mjs.map +1 -1
  15. package/dist/adapters/langchain-adapter.d.mts +2 -2
  16. package/dist/adapters/langchain-adapter.d.ts +2 -2
  17. package/dist/adapters/langchain-adapter.js +69 -18
  18. package/dist/adapters/langchain-adapter.js.map +1 -1
  19. package/dist/adapters/langchain-adapter.mjs +69 -18
  20. package/dist/adapters/langchain-adapter.mjs.map +1 -1
  21. package/dist/client/index.d.mts +2 -2
  22. package/dist/client/index.d.ts +2 -2
  23. package/dist/client/react.d.mts +4 -4
  24. package/dist/client/react.d.ts +4 -4
  25. package/dist/client/react.js.map +1 -1
  26. package/dist/client/react.mjs.map +1 -1
  27. package/dist/client/vue.d.mts +4 -4
  28. package/dist/client/vue.d.ts +4 -4
  29. package/dist/{index-GfC_eNEv.d.ts → index-DhA-OEAe.d.ts} +1 -1
  30. package/dist/{index-DcYfpY3H.d.mts → index-bFL4ZF2N.d.mts} +1 -1
  31. package/dist/index.d.mts +4 -4
  32. package/dist/index.d.ts +4 -4
  33. package/dist/index.js +212 -44
  34. package/dist/index.js.map +1 -1
  35. package/dist/index.mjs +212 -45
  36. package/dist/index.mjs.map +1 -1
  37. package/dist/server/index.d.mts +2 -2
  38. package/dist/server/index.d.ts +2 -2
  39. package/dist/server/index.js +13 -5
  40. package/dist/server/index.js.map +1 -1
  41. package/dist/server/index.mjs +13 -5
  42. package/dist/server/index.mjs.map +1 -1
  43. package/dist/shared/index.d.mts +17 -10
  44. package/dist/shared/index.d.ts +17 -10
  45. package/dist/shared/index.js +199 -39
  46. package/dist/shared/index.js.map +1 -1
  47. package/dist/shared/index.mjs +199 -40
  48. package/dist/shared/index.mjs.map +1 -1
  49. package/dist/{tool-router-DsKhRmJm.d.ts → tool-router-BVaV1udm.d.mts} +57 -8
  50. package/dist/{tool-router-DK0RJblO.d.mts → tool-router-Dh2804tM.d.ts} +57 -8
  51. package/dist/{types-CfCoIsWI.d.mts → types-rIuN1CQi.d.mts} +1 -0
  52. package/dist/{types-CfCoIsWI.d.ts → types-rIuN1CQi.d.ts} +1 -0
  53. package/package.json +3 -1
  54. package/src/server/handlers/sse-handler.ts +12 -0
  55. package/src/server/mcp/oauth-client.ts +10 -6
  56. package/src/shared/index.ts +4 -0
  57. package/src/shared/meta-tools.ts +163 -37
  58. package/src/shared/tool-index.ts +123 -7
  59. package/src/shared/tool-router.ts +40 -7
  60. package/src/shared/types.ts +1 -0
@@ -4,9 +4,9 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
4
4
 
5
5
  // src/shared/meta-tools.ts
6
6
  async function executeMetaTool(toolName, args, router, callToolFn) {
7
- const resolveToolSchema = (name, namespace) => {
7
+ const resolveToolSchema = (name, namespace, options) => {
8
8
  try {
9
- return { tool: router.getToolSchema(name, namespace) };
9
+ return { tool: router.getToolSchema(name, namespace, options) };
10
10
  } catch (err) {
11
11
  const errorMessage = err instanceof Error ? err.message : String(err);
12
12
  return {
@@ -18,23 +18,61 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
18
18
  }
19
19
  };
20
20
  switch (toolName) {
21
- case "mcp_search_tool_bm25": {
21
+ case "mcp_search_tools": {
22
22
  const query = String(args.query ?? "");
23
+ const operation = String(args.operation ?? "search");
24
+ const serverId = String(args.serverId ?? "") || void 0;
25
+ const serverName = String(args.serverName ?? "") || void 0;
26
+ if (operation === "list") {
27
+ const limit2 = Math.min(Number(args.limit) || 20, 100);
28
+ const cursor = String(args.cursor ?? "") || void 0;
29
+ const result = await router.listTools({
30
+ serverId,
31
+ serverName: serverName ?? (!serverId && query ? query : void 0),
32
+ limit: limit2,
33
+ cursor
34
+ });
35
+ const serverText = result.servers.length > 0 ? result.servers.map((server) => `${server.serverName} (serverId: ${server.serverId}, tools: ${server.toolCount})`).join(", ") : "none";
36
+ const lines = [
37
+ "operation: list",
38
+ `servers: ${serverText}`,
39
+ `totalCount: ${result.totalCount}`,
40
+ `returnedCount: ${result.returnedCount}`,
41
+ `nextCursor: ${result.nextCursor ?? "null"}`,
42
+ ""
43
+ ];
44
+ if (result.tools.length > 0) {
45
+ lines.push(...formatToolSummaries(result.tools));
46
+ } else {
47
+ lines.push(
48
+ serverId || serverName ? "No tools found for the requested server scope." : 'No tools found. Try operation "search" or provide serverId/serverName.'
49
+ );
50
+ }
51
+ return {
52
+ content: [{ type: "text", text: lines.join("\n") }],
53
+ isError: false
54
+ };
55
+ }
23
56
  const limit = Math.min(Number(args.limit) || 5, 20);
57
+ const searchOptions = { serverId, serverName };
24
58
  const selectMatch = query.match(/^select:(.+)$/i);
25
59
  if (selectMatch) {
60
+ await router.listTools({ serverId, serverName, limit: 1 });
26
61
  const requested = selectMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
27
62
  const found = [];
28
63
  const errors = [];
64
+ const namespace = serverId ?? serverName;
29
65
  for (const requestedToolName of requested) {
30
- const { tool, error } = resolveToolSchema(requestedToolName);
66
+ const { tool, error } = resolveToolSchema(requestedToolName, namespace, {
67
+ allowServerNameFragment: Boolean(serverName && !serverId)
68
+ });
31
69
  if (error) {
32
70
  const errorMsg = error.content[0]?.type === "text" ? error.content[0].text : "Unknown error";
33
71
  errors.push(`- **${requestedToolName}**: ${errorMsg}`);
34
72
  } else if (tool) {
35
73
  found.push(tool);
36
74
  } else {
37
- errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);
75
+ errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tools.`);
38
76
  }
39
77
  }
40
78
  const lines = [];
@@ -55,11 +93,21 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
55
93
  isError: found.length === 0
56
94
  };
57
95
  }
58
- const results = await router.searchTools(query, limit);
59
- const text = results.length === 0 ? "No tools found matching your query. Try different keywords." : results.map(
60
- (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
61
- ${t.description}
62
- Estimated tokens: ${t.estimatedTokens}`
96
+ const results = await router.searchTools(query, limit, searchOptions);
97
+ const text = results.length === 0 ? "No tools found matching your query. Call mcp_list_servers to inspect connected servers, then retry mcp_search_tools with serverId or serverName." : formatToolSummaries(results).join("\n");
98
+ return {
99
+ content: [{ type: "text", text }],
100
+ isError: false
101
+ };
102
+ }
103
+ case "mcp_list_servers": {
104
+ const query = String(args.query ?? "").trim();
105
+ const servers = await router.listServers({
106
+ serverName: query || void 0
107
+ });
108
+ const text = servers.length === 0 ? "No connected servers found." : servers.map(
109
+ (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})
110
+ Tool count: ${server.toolCount}`
63
111
  ).join("\n");
64
112
  return {
65
113
  content: [{ type: "text", text }],
@@ -70,11 +118,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
70
118
  const pattern = String(args.query ?? "");
71
119
  const limit = Math.min(Number(args.limit) || 5, 20);
72
120
  const results = await router.searchToolsRegex(pattern, limit);
73
- const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : results.map(
74
- (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
75
- ${t.description}
76
- Estimated tokens: ${t.estimatedTokens}`
77
- ).join("\n");
121
+ const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : formatToolSummaries(results).join("\n");
78
122
  return {
79
123
  content: [{ type: "text", text }],
80
124
  isError: false
@@ -92,7 +136,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
92
136
  content: [
93
137
  {
94
138
  type: "text",
95
- text: `Tool "${name}" not found. Use mcp_search_tool_bm25 to find available tools first.`
139
+ text: `Tool "${name}" not found. Use mcp_search_tools to find available tools first.`
96
140
  }
97
141
  ],
98
142
  isError: true
@@ -133,7 +177,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
133
177
  content: [
134
178
  {
135
179
  type: "text",
136
- text: `Tool "${targetToolName}" not found. Use mcp_search_tool_bm25 to discover available tools first.`
180
+ text: `Tool "${targetToolName}" not found. Use mcp_search_tools to discover available tools first.`
137
181
  }
138
182
  ],
139
183
  isError: true
@@ -167,8 +211,15 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
167
211
  return null;
168
212
  }
169
213
  }
214
+ function formatToolSummaries(tools) {
215
+ return tools.map(
216
+ (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
217
+ ${t.description}
218
+ Estimated tokens: ${t.estimatedTokens}`
219
+ );
220
+ }
170
221
  function isMetaTool(toolName) {
171
- return toolName === "mcp_search_tool_bm25" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
222
+ return toolName === "mcp_search_tools" || toolName === "mcp_list_servers" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
172
223
  }
173
224
 
174
225
  // src/adapters/ai-adapter.ts
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/shared/meta-tools.ts","../../src/adapters/ai-adapter.ts"],"names":["text"],"mappings":"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","file":"ai-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';\nimport type { IndexedTool } from './tool-index.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 '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_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?: IndexedTool; 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 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_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 { 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"]}
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.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_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"]}
@@ -1,11 +1,11 @@
1
1
  import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CQsRbxYI.mjs';
2
2
  import { StructuredTool } from '@langchain/core/tools';
3
- import { d as ToolRouter } from '../tool-router-DK0RJblO.mjs';
3
+ import { e as ToolRouter } from '../tool-router-BVaV1udm.mjs';
4
4
  import '../events-CK3N--3g.mjs';
5
5
  import '@modelcontextprotocol/sdk/types.js';
6
6
  import '@modelcontextprotocol/sdk/client/auth.js';
7
7
  import '@modelcontextprotocol/sdk/shared/auth.js';
8
- import '../types-CfCoIsWI.mjs';
8
+ import '../types-rIuN1CQi.mjs';
9
9
 
10
10
  interface LangChainAdapterOptions {
11
11
  /**
@@ -1,11 +1,11 @@
1
1
  import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-CHE8QpVE.js';
2
2
  import { StructuredTool } from '@langchain/core/tools';
3
- import { d as ToolRouter } from '../tool-router-DsKhRmJm.js';
3
+ import { e as ToolRouter } from '../tool-router-Dh2804tM.js';
4
4
  import '../events-CK3N--3g.js';
5
5
  import '@modelcontextprotocol/sdk/types.js';
6
6
  import '@modelcontextprotocol/sdk/client/auth.js';
7
7
  import '@modelcontextprotocol/sdk/shared/auth.js';
8
- import '../types-CfCoIsWI.js';
8
+ import '../types-rIuN1CQi.js';
9
9
 
10
10
  interface LangChainAdapterOptions {
11
11
  /**
@@ -12,9 +12,9 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
12
12
 
13
13
  // src/shared/meta-tools.ts
14
14
  async function executeMetaTool(toolName, args, router, callToolFn) {
15
- const resolveToolSchema = (name, namespace) => {
15
+ const resolveToolSchema = (name, namespace, options) => {
16
16
  try {
17
- return { tool: router.getToolSchema(name, namespace) };
17
+ return { tool: router.getToolSchema(name, namespace, options) };
18
18
  } catch (err) {
19
19
  const errorMessage = err instanceof Error ? err.message : String(err);
20
20
  return {
@@ -26,23 +26,61 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
26
26
  }
27
27
  };
28
28
  switch (toolName) {
29
- case "mcp_search_tool_bm25": {
29
+ case "mcp_search_tools": {
30
30
  const query = String(args.query ?? "");
31
+ const operation = String(args.operation ?? "search");
32
+ const serverId = String(args.serverId ?? "") || void 0;
33
+ const serverName = String(args.serverName ?? "") || void 0;
34
+ if (operation === "list") {
35
+ const limit2 = Math.min(Number(args.limit) || 20, 100);
36
+ const cursor = String(args.cursor ?? "") || void 0;
37
+ const result = await router.listTools({
38
+ serverId,
39
+ serverName: serverName ?? (!serverId && query ? query : void 0),
40
+ limit: limit2,
41
+ cursor
42
+ });
43
+ const serverText = result.servers.length > 0 ? result.servers.map((server) => `${server.serverName} (serverId: ${server.serverId}, tools: ${server.toolCount})`).join(", ") : "none";
44
+ const lines = [
45
+ "operation: list",
46
+ `servers: ${serverText}`,
47
+ `totalCount: ${result.totalCount}`,
48
+ `returnedCount: ${result.returnedCount}`,
49
+ `nextCursor: ${result.nextCursor ?? "null"}`,
50
+ ""
51
+ ];
52
+ if (result.tools.length > 0) {
53
+ lines.push(...formatToolSummaries(result.tools));
54
+ } else {
55
+ lines.push(
56
+ serverId || serverName ? "No tools found for the requested server scope." : 'No tools found. Try operation "search" or provide serverId/serverName.'
57
+ );
58
+ }
59
+ return {
60
+ content: [{ type: "text", text: lines.join("\n") }],
61
+ isError: false
62
+ };
63
+ }
31
64
  const limit = Math.min(Number(args.limit) || 5, 20);
65
+ const searchOptions = { serverId, serverName };
32
66
  const selectMatch = query.match(/^select:(.+)$/i);
33
67
  if (selectMatch) {
68
+ await router.listTools({ serverId, serverName, limit: 1 });
34
69
  const requested = selectMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
35
70
  const found = [];
36
71
  const errors = [];
72
+ const namespace = serverId ?? serverName;
37
73
  for (const requestedToolName of requested) {
38
- const { tool, error } = resolveToolSchema(requestedToolName);
74
+ const { tool, error } = resolveToolSchema(requestedToolName, namespace, {
75
+ allowServerNameFragment: Boolean(serverName && !serverId)
76
+ });
39
77
  if (error) {
40
78
  const errorMsg = error.content[0]?.type === "text" ? error.content[0].text : "Unknown error";
41
79
  errors.push(`- **${requestedToolName}**: ${errorMsg}`);
42
80
  } else if (tool) {
43
81
  found.push(tool);
44
82
  } else {
45
- errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tool_bm25.`);
83
+ errors.push(`- **${requestedToolName}**: Tool not found. Try searching with mcp_search_tools.`);
46
84
  }
47
85
  }
48
86
  const lines = [];
@@ -63,11 +101,21 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
63
101
  isError: found.length === 0
64
102
  };
65
103
  }
66
- const results = await router.searchTools(query, limit);
67
- const text = results.length === 0 ? "No tools found matching your query. Try different keywords." : results.map(
68
- (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
69
- ${t.description}
70
- Estimated tokens: ${t.estimatedTokens}`
104
+ const results = await router.searchTools(query, limit, searchOptions);
105
+ const text = results.length === 0 ? "No tools found matching your query. Call mcp_list_servers to inspect connected servers, then retry mcp_search_tools with serverId or serverName." : formatToolSummaries(results).join("\n");
106
+ return {
107
+ content: [{ type: "text", text }],
108
+ isError: false
109
+ };
110
+ }
111
+ case "mcp_list_servers": {
112
+ const query = String(args.query ?? "").trim();
113
+ const servers = await router.listServers({
114
+ serverName: query || void 0
115
+ });
116
+ const text = servers.length === 0 ? "No connected servers found." : servers.map(
117
+ (server, i) => `${i + 1}. **${server.serverName}** (serverId: ${server.serverId}, sessionId: ${server.sessionId})
118
+ Tool count: ${server.toolCount}`
71
119
  ).join("\n");
72
120
  return {
73
121
  content: [{ type: "text", text }],
@@ -78,11 +126,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
78
126
  const pattern = String(args.query ?? "");
79
127
  const limit = Math.min(Number(args.limit) || 5, 20);
80
128
  const results = await router.searchToolsRegex(pattern, limit);
81
- const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : results.map(
82
- (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
83
- ${t.description}
84
- Estimated tokens: ${t.estimatedTokens}`
85
- ).join("\n");
129
+ const text = results.length === 0 ? "No tools matched your regex pattern. Try a broader pattern." : formatToolSummaries(results).join("\n");
86
130
  return {
87
131
  content: [{ type: "text", text }],
88
132
  isError: false
@@ -100,7 +144,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
100
144
  content: [
101
145
  {
102
146
  type: "text",
103
- text: `Tool "${name}" not found. Use mcp_search_tool_bm25 to find available tools first.`
147
+ text: `Tool "${name}" not found. Use mcp_search_tools to find available tools first.`
104
148
  }
105
149
  ],
106
150
  isError: true
@@ -141,7 +185,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
141
185
  content: [
142
186
  {
143
187
  type: "text",
144
- text: `Tool "${targetToolName}" not found. Use mcp_search_tool_bm25 to discover available tools first.`
188
+ text: `Tool "${targetToolName}" not found. Use mcp_search_tools to discover available tools first.`
145
189
  }
146
190
  ],
147
191
  isError: true
@@ -175,8 +219,15 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
175
219
  return null;
176
220
  }
177
221
  }
222
+ function formatToolSummaries(tools) {
223
+ return tools.map(
224
+ (t, i) => `${i + 1}. **${t.name}** (server: ${t.serverName}, serverId: ${t.serverId})
225
+ ${t.description}
226
+ Estimated tokens: ${t.estimatedTokens}`
227
+ );
228
+ }
178
229
  function isMetaTool(toolName) {
179
- return toolName === "mcp_search_tool_bm25" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
230
+ return toolName === "mcp_search_tools" || toolName === "mcp_list_servers" || toolName === "mcp_search_tool_regex" || toolName === "mcp_get_tool_schema" || toolName === "mcp_execute_tool";
180
231
  }
181
232
 
182
233
  // src/adapters/langchain-adapter.ts