@mcp-ts/sdk 1.4.0 → 1.5.1

package/dist/shared/index.d.mts

@@ -1,8 +1,10 @@
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-0qmYrqoa.mjs';
-import { T as ToolInfo } from '../types-CW6lghof.mjs';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CW6lghof.mjs';
-import '@modelcontextprotocol/sdk/types.js';
+import { v as ToolInfo } from '../types-CfCoIsWI.mjs';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-CfCoIsWI.mjs';
+import { d as ToolRouter } from '../tool-router-XnWVxPzv.mjs';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from '../tool-router-XnWVxPzv.mjs';
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * Centralized constants for MCP Redis library
@@ -57,4 +59,84 @@ declare function findToolByName(connections: Array<{
     tools: ToolInfo[];
 }>, toolName: string): ToolInfo | undefined;
 
-export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolInfo, type ToolUiConfig, findToolByName, getToolUiResourceUri };
+/**
+ * Meta-tools — Injectable tool definitions that let the LLM discover and
+ * load MCP tools on-demand, following Anthropic's Tool Search pattern.
+ *
+ * Instead of injecting 50+ full tool schemas into the context window, you
+ * inject just these 4 meta-tools. The LLM calls them to find and load
+ * only the tools it actually needs.
+ *
+ * Meta-tools:
+ *   • `mcp_search_tool_bm25`  — BM25 natural language search
+ *   • `mcp_search_tool_regex` — Regex pattern search
+ *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool
+ *   • `mcp_execute_tool`      — Execute a discovered tool
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Creates the `mcp_search_tool_bm25` tool definition.
+ *
+ * This tool lets the LLM search the full catalog of available MCP tools
+ * using a BM25 natural-language query. Returns tool names and descriptions
+ * without the full inputSchema to save context space.
+ */
+declare function createSearchToolDefinition(): Tool;
+/**
+ * Creates the `mcp_search_tool_regex` tool definition.
+ *
+ * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).
+ */
+declare function createRegexSearchToolDefinition(): Tool;
+/**
+ * Creates the `mcp_get_tool_schema` tool definition.
+ *
+ * After discovering tools via `mcp_search_tool_bm25` or
+ * `mcp_search_tool_regex`, the LLM calls this to load the full
+ * inputSchema for a specific tool so it can construct the correct
+ * arguments.
+ */
+declare function createGetSchemaToolDefinition(): Tool;
+/**
+ * Creates the `mcp_execute_tool` tool definition.
+ *
+ * This is the execution meta-tool — the LLM calls this to execute any
+ * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.
+ * The LLM should first call `mcp_get_tool_schema` to know the correct
+ * arguments.
+ *
+ * Instead of registering every real tool with the framework, we proxy
+ * all execution through a single meta-tool.
+ */
+declare function createExecuteToolDefinition(): Tool;
+/**
+ * Callback for executing a real MCP tool via the correct client.
+ * Provided by adapters that wire up client routing.
+ */
+type CallToolFn = (toolName: string, args: Record<string, unknown>, namespace?: string) => Promise<any>;
+/**
+ * Execute a meta-tool call and return the result in MCP CallToolResult format.
+ *
+ * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)
+ * @param args - The arguments from the LLM's tool call
+ * @param router - The ToolRouter to query
+ * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)
+ * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool
+ */
+declare function executeMetaTool(toolName: string, args: Record<string, unknown>, router: ToolRouter, callToolFn?: CallToolFn): Promise<CallToolResult | null>;
+/** Check if a tool name is one of the meta-tools. */
+declare function isMetaTool(toolName: string): boolean;
+/**
+ * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.
+ * Also automatically strips routing prefixes like tool_{serverId}_.
+ *
+ * Useful for frontend components that need to determine the actual tool being executed by an AI agent.
+ */
+declare function resolveMetaToolProxy(toolName: string, args: Record<string, unknown> | null | undefined): {
+    toolName: string;
+    args: Record<string, unknown>;
+};
+
+export { type CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolInfo, ToolRouter, type ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy };

package/dist/shared/index.d.ts

@@ -1,8 +1,10 @@
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-0qmYrqoa.js';
-import { T as ToolInfo } from '../types-CW6lghof.js';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CW6lghof.js';
-import '@modelcontextprotocol/sdk/types.js';
+import { v as ToolInfo } from '../types-CfCoIsWI.js';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-CfCoIsWI.js';
+import { d as ToolRouter } from '../tool-router-Bo8qZbsD.js';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from '../tool-router-Bo8qZbsD.js';
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * Centralized constants for MCP Redis library
@@ -57,4 +59,84 @@ declare function findToolByName(connections: Array<{
     tools: ToolInfo[];
 }>, toolName: string): ToolInfo | undefined;
 
-export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolInfo, type ToolUiConfig, findToolByName, getToolUiResourceUri };
+/**
+ * Meta-tools — Injectable tool definitions that let the LLM discover and
+ * load MCP tools on-demand, following Anthropic's Tool Search pattern.
+ *
+ * Instead of injecting 50+ full tool schemas into the context window, you
+ * inject just these 4 meta-tools. The LLM calls them to find and load
+ * only the tools it actually needs.
+ *
+ * Meta-tools:
+ *   • `mcp_search_tool_bm25`  — BM25 natural language search
+ *   • `mcp_search_tool_regex` — Regex pattern search
+ *   • `mcp_get_tool_schema`   — Get full inputSchema for a discovered tool
+ *   • `mcp_execute_tool`      — Execute a discovered tool
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Creates the `mcp_search_tool_bm25` tool definition.
+ *
+ * This tool lets the LLM search the full catalog of available MCP tools
+ * using a BM25 natural-language query. Returns tool names and descriptions
+ * without the full inputSchema to save context space.
+ */
+declare function createSearchToolDefinition(): Tool;
+/**
+ * Creates the `mcp_search_tool_regex` tool definition.
+ *
+ * Matches Anthropic's tool_search_tool_regex exactly (takes a 'query' regex pattern).
+ */
+declare function createRegexSearchToolDefinition(): Tool;
+/**
+ * Creates the `mcp_get_tool_schema` tool definition.
+ *
+ * After discovering tools via `mcp_search_tool_bm25` or
+ * `mcp_search_tool_regex`, the LLM calls this to load the full
+ * inputSchema for a specific tool so it can construct the correct
+ * arguments.
+ */
+declare function createGetSchemaToolDefinition(): Tool;
+/**
+ * Creates the `mcp_execute_tool` tool definition.
+ *
+ * This is the execution meta-tool — the LLM calls this to execute any
+ * tool discovered via `mcp_search_tool_bm25` or `mcp_search_tool_regex`.
+ * The LLM should first call `mcp_get_tool_schema` to know the correct
+ * arguments.
+ *
+ * Instead of registering every real tool with the framework, we proxy
+ * all execution through a single meta-tool.
+ */
+declare function createExecuteToolDefinition(): Tool;
+/**
+ * Callback for executing a real MCP tool via the correct client.
+ * Provided by adapters that wire up client routing.
+ */
+type CallToolFn = (toolName: string, args: Record<string, unknown>, namespace?: string) => Promise<any>;
+/**
+ * Execute a meta-tool call and return the result in MCP CallToolResult format.
+ *
+ * @param toolName - One of the meta-tool names (mcp_search_tool_bm25, mcp_search_tool_regex, etc.)
+ * @param args - The arguments from the LLM's tool call
+ * @param router - The ToolRouter to query
+ * @param callToolFn - Optional callback for executing real tools (required for mcp_execute_tool)
+ * @returns MCP-compatible CallToolResult, or null if this isn't a meta-tool
+ */
+declare function executeMetaTool(toolName: string, args: Record<string, unknown>, router: ToolRouter, callToolFn?: CallToolFn): Promise<CallToolResult | null>;
+/** Check if a tool name is one of the meta-tools. */
+declare function isMetaTool(toolName: string): boolean;
+/**
+ * Unwraps a meta-tool proxy call (like mcp_execute_tool) to find the real target tool name and arguments.
+ * Also automatically strips routing prefixes like tool_{serverId}_.
+ *
+ * Useful for frontend components that need to determine the actual tool being executed by an AI agent.
+ */
+declare function resolveMetaToolProxy(toolName: string, args: Record<string, unknown> | null | undefined): {
+    toolName: string;
+    args: Record<string, unknown>;
+};
+
+export { type CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolInfo, ToolRouter, type ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy };