@mcp-ts/sdk 2.0.0 → 2.2.0

package/dist/shared/index.mjs

@@ -762,7 +762,7 @@ function createRegexSearchToolDefinition() {
 function createGetSchemaToolDefinition() {
   return {
     name: "mcp_get_tool_schema",
-    description: "Get the full input schema (parameters) for a specific tool. Call this after mcp_search_tools to get the parameter details needed to call a tool correctly. Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.",
+    description: "Get the full input schema (parameters) and output schema (result shape) for a specific tool. Call this after mcp_search_tools to get the parameter details needed to call a tool correctly and understand what it returns. Do NOT call the discovered tool directly; after reading the schema, call mcp_execute_tool.",
     inputSchema: {
       type: "object",
       properties: {
@@ -947,6 +947,7 @@ async function executeMetaTool(toolName, args, router, callToolFn) {
         name: tool.name,
         description: tool.description,
         inputSchema: tool.inputSchema,
+        outputSchema: tool.outputSchema,
         executionInstructions: {
           nextTool: "mcp_execute_tool",
           toolName: tool.name,
@@ -1042,18 +1043,29 @@ var ToolRouter = class {
     this.options = options;
     __publicField(this, "index");
     __publicField(this, "allTools", []);
+    __publicField(this, "pinnedTools", []);
+    __publicField(this, "deferredTools", []);
+    __publicField(this, "discoverableTools", []);
     __publicField(this, "groupsMap", /* @__PURE__ */ new Map());
     __publicField(this, "strategy");
     __publicField(this, "maxTools");
     __publicField(this, "compactSchemas");
     __publicField(this, "activeGroups");
     __publicField(this, "customGroups");
+    __publicField(this, "pinnedToolNames");
+    __publicField(this, "deferredToolNames");
+    __publicField(this, "excludeToolMatchers");
     __publicField(this, "initialized", false);
     this.strategy = options.strategy ?? "all";
     this.maxTools = options.maxTools ?? 40;
     this.compactSchemas = options.compactSchemas ?? false;
     this.activeGroups = new Set(options.activeGroups ?? []);
     this.customGroups = options.groups;
+    this.pinnedToolNames = new Set(options.pinnedTools ?? []);
+    this.deferredToolNames = new Set(options.deferredTools ?? []);
+    this.excludeToolMatchers = (options.excludeTools ?? []).map(
+      (pattern) => globToRegExp(pattern)
+    );
     this.index = new ToolIndex({
       embedFn: options.embedFn,
       keywordWeight: options.keywordWeight
@@ -1074,13 +1086,14 @@ var ToolRouter = class {
     await this.ensureInitialized();
     switch (this.strategy) {
       case "search":
-        return this.getMetaToolDefinitions();
+        return [...this.getMetaToolDefinitions(), ...this.pinnedTools];
       case "groups":
         return this.getGroupFilteredTools();
       case "all":
       default:
+        const directlyVisibleTools = this.getDirectlyVisibleTools();
         if (this.compactSchemas) {
-          return this.allTools.map((t) => {
+          return directlyVisibleTools.map((t) => {
             const compact = SchemaCompressor.toCompact(t);
             return {
               name: compact.name,
@@ -1089,7 +1102,7 @@ var ToolRouter = class {
             };
           });
         }
-        return [...this.allTools];
+        return [...directlyVisibleTools];
     }
   }
   /**
@@ -1201,8 +1214,14 @@ var ToolRouter = class {
   /** Lazy initialization — fetches tools from all connected clients. */
   async ensureInitialized() {
     if (this.initialized) return;
-    this.allTools = await this.fetchAllTools();
-    await this.index.buildIndex(this.allTools);
+    const fetchedTools = await this.fetchAllTools();
+    this.allTools = fetchedTools.filter((tool) => !this.matchesExcludedTool(tool.name));
+    this.pinnedTools = this.allTools.filter((tool) => this.matchesPinnedTool(tool.name));
+    this.deferredTools = this.allTools.filter(
+      (tool) => !this.matchesPinnedTool(tool.name) && this.matchesDeferredTool(tool)
+    );
+    this.discoverableTools = this.allTools.filter((tool) => !this.matchesPinnedTool(tool.name));
+    await this.index.buildIndex(this.discoverableTools);
     this.buildGroups();
     this.initialized = true;
   }
@@ -1278,7 +1297,7 @@ var ToolRouter = class {
         }
       }
     }
-    const filtered = this.allTools.filter((t) => activeToolNames.has(t.name));
+    const filtered = this.getDirectlyVisibleTools().filter((t) => activeToolNames.has(t.name));
     if (this.compactSchemas) {
       return filtered.slice(0, this.maxTools).map((t) => {
         const compact = SchemaCompressor.toCompact(t);
@@ -1301,7 +1320,28 @@ var ToolRouter = class {
       createExecuteToolDefinition()
     ];
   }
+  matchesPinnedTool(toolName) {
+    return this.pinnedToolNames.has(toolName);
+  }
+  matchesDeferredTool(tool) {
+    if (this.deferredToolNames.has(tool.name)) {
+      return true;
+    }
+    const meta = tool._meta;
+    return meta?.toolRouter?.deferred === true;
+  }
+  matchesExcludedTool(toolName) {
+    return this.excludeToolMatchers.some((matcher) => matcher.test(toolName));
+  }
+  getDirectlyVisibleTools() {
+    return this.allTools.filter((tool) => !this.matchesDeferredTool(tool) || this.matchesPinnedTool(tool.name));
+  }
 };
+function globToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+  const regexPattern = `^${escaped.replace(/\*/g, ".*")}$`;
+  return new RegExp(regexPattern);
+}
 
 export { AuthenticationError, ConfigurationError, ConnectionError, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, DisposableStore, Emitter, InvalidStateError, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, McpError, NotConnectedError, REDIS_KEY_PREFIX, RpcErrorCodes, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, SchemaCompressor, SessionNotFoundError, SessionValidationError, TOKEN_EXPIRY_BUFFER_MS, ToolExecutionError, ToolIndex, ToolRouter, UnauthorizedError, createExecuteToolDefinition, createGetSchemaToolDefinition, createListServersToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isCallToolSuccess, isConnectAuthRequired, isConnectError, isConnectSuccess, isListToolsSuccess, isMetaTool, resolveMetaToolProxy, sanitizeServerLabel };
 //# sourceMappingURL=index.mjs.map