@mcp-ts/sdk 2.1.0 → 2.3.0

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

@@ -1,5 +1,5 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DYNe6az3.mjs';
-import { d as ToolRouter } from '../tool-router-BkQnso27.mjs';
+import { d as ToolRouter } from '../tool-router-C8hIA-tg.mjs';
 import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

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

@@ -1,5 +1,5 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-BYtguGJm.js';
-import { d as ToolRouter } from '../tool-router-BP8TT9mI.js';
+import { d as ToolRouter } from '../tool-router-CdX8e9bk.js';
 import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

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

@@ -7,7 +7,7 @@ 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-BkQnso27.mjs';
+import '../tool-router-C8hIA-tg.mjs';
 import '../types-CxFaaZrM.mjs';
 
 /**

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

@@ -7,7 +7,7 @@ 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-BP8TT9mI.js';
+import '../tool-router-CdX8e9bk.js';
 import '../types-CxFaaZrM.js';
 
 /**

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

@@ -1,6 +1,6 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DYNe6az3.mjs';
 import { ToolSet } from 'ai';
-import { d as ToolRouter } from '../tool-router-BkQnso27.mjs';
+import { d as ToolRouter } from '../tool-router-C8hIA-tg.mjs';
 import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

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

@@ -1,6 +1,6 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-BYtguGJm.js';
 import { ToolSet } from 'ai';
-import { d as ToolRouter } from '../tool-router-BP8TT9mI.js';
+import { d as ToolRouter } from '../tool-router-CdX8e9bk.js';
 import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

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

@@ -1,6 +1,6 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-DYNe6az3.mjs';
 import { StructuredTool } from '@langchain/core/tools';
-import { d as ToolRouter } from '../tool-router-BkQnso27.mjs';
+import { d as ToolRouter } from '../tool-router-C8hIA-tg.mjs';
 import '../events-CK3N--3g.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

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

@@ -1,6 +1,6 @@
 import { M as MCPClient, a as MultiSessionClient } from '../multi-session-client-BYtguGJm.js';
 import { StructuredTool } from '@langchain/core/tools';
-import { d as ToolRouter } from '../tool-router-BP8TT9mI.js';
+import { d as ToolRouter } from '../tool-router-CdX8e9bk.js';
 import '../events-CK3N--3g.js';
 import '@modelcontextprotocol/sdk/types.js';
 import '@modelcontextprotocol/sdk/client/auth.js';

package/dist/index.d.mts

@@ -1,12 +1,12 @@
 export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvider } from './multi-session-client-DYNe6az3.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-DELRKQPU.mjs';
-export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, SessionStore, createNextMcpHandler, createSSEHandler, sessions } from './server/index.mjs';
+export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, Session, SessionMutationEvent, SessionMutationListener, SessionMutationType, SessionStore, createNextMcpHandler, createSSEHandler, onSessionMutation, sessions } from './server/index.mjs';
 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 { 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 GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CxFaaZrM.mjs';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
 export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-Cfjsme-a.mjs';
 export { 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, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createListServersToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.mjs';
-export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from './tool-router-BkQnso27.mjs';
+export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from './tool-router-C8hIA-tg.mjs';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/ext-apps/app-bridge';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvider } from './multi-session-client-BYtguGJm.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-DELRKQPU.js';
-export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, SessionStore, createNextMcpHandler, createSSEHandler, sessions } from './server/index.js';
+export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, Session, SessionMutationEvent, SessionMutationListener, SessionMutationType, SessionStore, createNextMcpHandler, createSSEHandler, onSessionMutation, sessions } from './server/index.js';
 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 { 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 GetSessionResult, L as ListPromptsResult, m as ListResourcesResult, n as ListToolsResponse, o as ListToolsRpcResult, M as McpRpcMethod, p as McpRpcParams, q as McpRpcRequest, r as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CxFaaZrM.js';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
 export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-CmjMd2ac.js';
 export { 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, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createListServersToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.js';
-export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from './tool-router-BP8TT9mI.js';
+export { C as CompactTool, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, a as ToolIndex, b as ToolIndexOptions, c as ToolListResult, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from './tool-router-CdX8e9bk.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
 import '@modelcontextprotocol/ext-apps/app-bridge';

package/dist/index.js

@@ -1242,6 +1242,59 @@ function warnIfNeonConnectionStringIsInsecure(connectionString) {
 }
 var storageInstance = null;
 var storagePromise = null;
+var sessionMutationListeners = /* @__PURE__ */ new Set();
+function emitSessionMutation(event) {
+  for (const listener of sessionMutationListeners) {
+    try {
+      const result = listener(event);
+      if (result && typeof result.catch === "function") {
+        void result.catch((error) => {
+          console.error("[mcp-ts][Storage] Session mutation listener failed:", error);
+        });
+      }
+    } catch (error) {
+      console.error("[mcp-ts][Storage] Session mutation listener failed:", error);
+    }
+  }
+}
+function createSessionMutationEvent(prop, args) {
+  const timestamp = Date.now();
+  if (prop === "create") {
+    const [session, ttl] = args;
+    if (!session?.userId || !session?.sessionId) return null;
+    return {
+      type: "create",
+      userId: session.userId,
+      sessionId: session.sessionId,
+      session,
+      ttl,
+      timestamp
+    };
+  }
+  if (prop === "update") {
+    const [userId, sessionId, patch, ttl] = args;
+    if (!userId || !sessionId) return null;
+    return {
+      type: "update",
+      userId,
+      sessionId,
+      patch,
+      ttl,
+      timestamp
+    };
+  }
+  if (prop === "delete") {
+    const [userId, sessionId] = args;
+    if (!userId || !sessionId) return null;
+    return {
+      type: "delete",
+      userId,
+      sessionId,
+      timestamp
+    };
+  }
+  return null;
+}
 async function initializeStorage(store) {
   if (typeof store.init === "function") {
     await store.init();
@@ -1379,13 +1432,24 @@ async function getStorage() {
   storageInstance = await storagePromise;
   return storageInstance;
 }
+function onSessionMutation(listener) {
+  sessionMutationListeners.add(listener);
+  return () => {
+    sessionMutationListeners.delete(listener);
+  };
+}
 var sessions = new Proxy({}, {
   get(_target, prop) {
     return async (...args) => {
       const instance = await getStorage();
       const value = instance[prop];
       if (typeof value === "function") {
-        return value.apply(instance, args);
+        const result = await value.apply(instance, args);
+        const event = createSessionMutationEvent(prop, args);
+        if (event) {
+          emitSessionMutation(event);
+        }
+        return result;
       }
       return value;
     };
@@ -5029,6 +5093,7 @@ var ToolRouter = class {
     __publicField(this, "index");
     __publicField(this, "allTools", []);
     __publicField(this, "pinnedTools", []);
+    __publicField(this, "deferredTools", []);
     __publicField(this, "discoverableTools", []);
     __publicField(this, "groupsMap", /* @__PURE__ */ new Map());
     __publicField(this, "strategy");
@@ -5037,6 +5102,7 @@ var ToolRouter = class {
     __publicField(this, "activeGroups");
     __publicField(this, "customGroups");
     __publicField(this, "pinnedToolNames");
+    __publicField(this, "deferredToolNames");
     __publicField(this, "excludeToolMatchers");
     __publicField(this, "initialized", false);
     this.strategy = options.strategy ?? "all";
@@ -5045,6 +5111,7 @@ var ToolRouter = class {
     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)
     );
@@ -5073,8 +5140,9 @@ var ToolRouter = class {
         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,
@@ -5083,7 +5151,7 @@ var ToolRouter = class {
             };
           });
         }
-        return [...this.allTools];
+        return [...directlyVisibleTools];
     }
   }
   /**
@@ -5198,6 +5266,9 @@ var ToolRouter = class {
     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();
@@ -5275,7 +5346,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);
@@ -5301,9 +5372,19 @@ var ToolRouter = class {
   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, "\\$&");
@@ -5366,6 +5447,7 @@ exports.isConnectError = isConnectError;
 exports.isConnectSuccess = isConnectSuccess;
 exports.isListToolsSuccess = isListToolsSuccess;
 exports.isMetaTool = isMetaTool;
+exports.onSessionMutation = onSessionMutation;
 exports.resolveMetaToolProxy = resolveMetaToolProxy;
 exports.sanitizeServerLabel = sanitizeServerLabel;
 exports.sessions = sessions;