@mcp-ts/sdk 2.4.2 → 2.4.3

package/dist/{multi-session-client-CWs-AE78.d.mts → multi-session-client-B6hsYO8V.d.mts}

@@ -264,6 +264,17 @@ declare class MCPClient {
      * @throws {Error} When client is not connected
      */
     readResource(uri: string): Promise<ReadResourceResult>;
+    /**
+     * Wraps an MCP request with automatic transport-session recovery.
+     *
+     * When the downstream MCP server rejects the request with a 404 indicating
+     * the transport session has expired, this method tears down the stale SDK
+     * client and transport, calls {@link reconnect} to negotiate a fresh session,
+     * and retries the request once.
+     *
+     * Non-transient errors (network failures, auth errors, etc.) propagate as-is.
+     */
+    private withRetry;
     /**
      * Reconnects to MCP server using existing OAuth provider from Redis
      * Used for session restoration in serverless environments
@@ -534,6 +545,12 @@ declare class MultiSessionClient implements ToolClientProvider {
      * or to route a tool call to the right client by `serverId`.
      */
     getClients(): MCPClient[];
+    /**
+     * Removes and disconnects a single session by ID.
+     *
+     * @returns `true` if the session was found and removed, `false` if not found.
+     */
+    removeSession(sessionId: string): Promise<boolean>;
     /**
      * Gracefully disconnects all active MCP clients and clears the internal list.
      *

package/dist/{multi-session-client-BluyCPo9.d.ts → multi-session-client-DOBvtaQV.d.ts}

@@ -264,6 +264,17 @@ declare class MCPClient {
      * @throws {Error} When client is not connected
      */
     readResource(uri: string): Promise<ReadResourceResult>;
+    /**
+     * Wraps an MCP request with automatic transport-session recovery.
+     *
+     * When the downstream MCP server rejects the request with a 404 indicating
+     * the transport session has expired, this method tears down the stale SDK
+     * client and transport, calls {@link reconnect} to negotiate a fresh session,
+     * and retries the request once.
+     *
+     * Non-transient errors (network failures, auth errors, etc.) propagate as-is.
+     */
+    private withRetry;
     /**
      * Reconnects to MCP server using existing OAuth provider from Redis
      * Used for session restoration in serverless environments
@@ -534,6 +545,12 @@ declare class MultiSessionClient implements ToolClientProvider {
      * or to route a tool call to the right client by `serverId`.
      */
     getClients(): MCPClient[];
+    /**
+     * Removes and disconnects a single session by ID.
+     *
+     * @returns `true` if the session was found and removed, `false` if not found.
+     */
+    removeSession(sessionId: string): Promise<boolean>;
     /**
      * Gracefully disconnects all active MCP clients and clears the internal list.
      *

package/dist/server/index.d.mts

@@ -1,5 +1,5 @@
-import { c as SessionMutationListener, e as SessionStore } from '../multi-session-client-CWs-AE78.mjs';
-export { M as MCPClient, a as MultiSessionClient, S as Session, b as SessionMutationEvent, d as SessionMutationType, f as StorageOAuthClientProvider } from '../multi-session-client-CWs-AE78.mjs';
+import { c as SessionMutationListener, e as SessionStore } from '../multi-session-client-B6hsYO8V.mjs';
+export { M as MCPClient, a as MultiSessionClient, S as Session, b as SessionMutationEvent, d as SessionMutationType, f as StorageOAuthClientProvider } from '../multi-session-client-B6hsYO8V.mjs';
 export { U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-DELRKQPU.mjs';
 import { M as McpConnectionEvent, t as McpObservabilityEvent, x as McpRpcResponse, w as McpRpcRequest } from '../types-CjczQwNX.mjs';
 export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, k as Disposable, E as Emitter, m as Event, q as ListToolsResponse, s as McpConnectionState, T as ToolClient, A as ToolClientProvider, B as ToolInfo } from '../types-CjczQwNX.mjs';

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { c as SessionMutationListener, e as SessionStore } from '../multi-session-client-BluyCPo9.js';
-export { M as MCPClient, a as MultiSessionClient, S as Session, b as SessionMutationEvent, d as SessionMutationType, f as StorageOAuthClientProvider } from '../multi-session-client-BluyCPo9.js';
+import { c as SessionMutationListener, e as SessionStore } from '../multi-session-client-DOBvtaQV.js';
+export { M as MCPClient, a as MultiSessionClient, S as Session, b as SessionMutationEvent, d as SessionMutationType, f as StorageOAuthClientProvider } from '../multi-session-client-DOBvtaQV.js';
 export { U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-DELRKQPU.js';
 import { M as McpConnectionEvent, t as McpObservabilityEvent, x as McpRpcResponse, w as McpRpcRequest } from '../types-CjczQwNX.js';
 export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, k as Disposable, E as Emitter, m as Event, q as ListToolsResponse, s as McpConnectionState, T as ToolClient, A as ToolClientProvider, B as ToolInfo } from '../types-CjczQwNX.js';

package/dist/server/index.js

@@ -1734,12 +1734,12 @@ async function createStorage() {
   }
   if (type === "supabase") {
     const url = process.env.SUPABASE_URL;
-    const key = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
+    const key = process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_ANON_KEY;
     if (!url || !key) {
-      console.warn('[mcp-ts][Storage] Explicit selection "supabase" requires SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY.');
+      console.warn('[mcp-ts][Storage] Explicit selection "supabase" requires SUPABASE_URL and SUPABASE_SECRET_KEY.');
     } else {
-      if (!process.env.SUPABASE_SERVICE_ROLE_KEY) {
-        console.warn('[mcp-ts][Storage] \u26A0\uFE0F  Warning: Using "SUPABASE_ANON_KEY" for server-side storage. You may encounter RLS policy violations. "SUPABASE_SERVICE_ROLE_KEY" is recommended.');
+      if (!process.env.SUPABASE_SECRET_KEY) {
+        console.warn('[mcp-ts][Storage] \u26A0\uFE0F  Warning: Using "SUPABASE_ANON_KEY" for server-side storage. You may encounter RLS policy violations. "SUPABASE_SECRET_KEY" is recommended.');
       }
       try {
         const { createClient } = await import('@supabase/supabase-js');
@@ -1794,13 +1794,13 @@ async function createStorage() {
     console.log(`[mcp-ts][Storage] Auto-detection: "sqlite" (${process.env.MCP_TS_STORAGE_SQLITE_PATH})`);
     return await initializeStorage(new SqliteStorage({ path: process.env.MCP_TS_STORAGE_SQLITE_PATH }));
   }
-  if (process.env.SUPABASE_URL && (process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY)) {
+  if (process.env.SUPABASE_URL && (process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_ANON_KEY)) {
     try {
       const { createClient } = await import('@supabase/supabase-js');
       const url = process.env.SUPABASE_URL;
-      const key = process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_ANON_KEY;
-      if (!process.env.SUPABASE_SERVICE_ROLE_KEY) {
-        console.warn('[mcp-ts][Storage] \u26A0\uFE0F Warning: Using "SUPABASE_ANON_KEY" for server-side storage. You may encounter RLS policy violations. "SUPABASE_SERVICE_ROLE_KEY" is recommended.');
+      const key = process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_ANON_KEY;
+      if (!process.env.SUPABASE_SECRET_KEY) {
+        console.warn('[mcp-ts][Storage] \u26A0\uFE0F Warning: Using "SUPABASE_ANON_KEY" for server-side storage. You may encounter RLS policy violations. "SUPABASE_SECRET_KEY" is recommended.');
       }
       const client = createClient(url, key);
       console.log('[mcp-ts][Storage] Auto-detection: "supabase" (via SUPABASE_URL)');
@@ -2300,7 +2300,6 @@ var MCPClient = class {
           const response = await fetch(url, { ...init, signal });
           const hasSessionHeader = init?.headers && new Headers(init.headers).has("mcp-session-id");
           if (response.status === 404 && hasSessionHeader) {
-            this.client = null;
             throw new Error("MCP_SESSION_EXPIRED: Downstream session was not found on the server.");
           }
           return response;
@@ -2681,7 +2680,9 @@ var MCPClient = class {
         method: "tools/list",
         params: {}
       };
-      const result = await this.client.request(request, types_js.ListToolsResultSchema);
+      const result = await this.withRetry(
+        () => this.client.request(request, types_js.ListToolsResultSchema)
+      );
       if (this.serverId) {
         this._onConnectionEvent.fire({
           type: "tools_discovered",
@@ -2721,7 +2722,9 @@ var MCPClient = class {
       }
     };
     try {
-      const result = await this.client.request(request, types_js.CallToolResultSchema);
+      const result = await this.withRetry(
+        () => this.client.request(request, types_js.CallToolResultSchema)
+      );
       this._onObservabilityEvent.fire({
         type: "mcp:client:tool_call",
         level: "info",
@@ -2773,7 +2776,9 @@ var MCPClient = class {
         method: "prompts/list",
         params: {}
       };
-      const result = await this.client.request(request, types_js.ListPromptsResultSchema);
+      const result = await this.withRetry(
+        () => this.client.request(request, types_js.ListPromptsResultSchema)
+      );
       this.emitStateChange("READY");
       this.emitProgress(`Discovered ${result.prompts.length} prompts`);
       return result;
@@ -2802,7 +2807,9 @@ var MCPClient = class {
         arguments: args
       }
     };
-    return await this.client.request(request, types_js.GetPromptResultSchema);
+    return await this.withRetry(
+      () => this.client.request(request, types_js.GetPromptResultSchema)
+    );
   }
   /**
    * Lists all available resources from the connected MCP server
@@ -2819,7 +2826,9 @@ var MCPClient = class {
         method: "resources/list",
         params: {}
       };
-      const result = await this.client.request(request, types_js.ListResourcesResultSchema);
+      const result = await this.withRetry(
+        () => this.client.request(request, types_js.ListResourcesResultSchema)
+      );
       this.emitStateChange("READY");
       this.emitProgress(`Discovered ${result.resources.length} resources`);
       return result;
@@ -2846,7 +2855,36 @@ var MCPClient = class {
         uri
       }
     };
-    return await this.client.request(request, types_js.ReadResourceResultSchema);
+    return await this.withRetry(
+      () => this.client.request(request, types_js.ReadResourceResultSchema)
+    );
+  }
+  /**
+   * Wraps an MCP request with automatic transport-session recovery.
+   *
+   * When the downstream MCP server rejects the request with a 404 indicating
+   * the transport session has expired, this method tears down the stale SDK
+   * client and transport, calls {@link reconnect} to negotiate a fresh session,
+   * and retries the request once.
+   *
+   * Non-transient errors (network failures, auth errors, etc.) propagate as-is.
+   */
+  async withRetry(fn) {
+    try {
+      return await fn();
+    } catch (error) {
+      if (!(error instanceof Error && error.message.includes("MCP_SESSION_EXPIRED"))) throw error;
+      if (this.client) {
+        try {
+          await this.client.close();
+        } catch {
+        }
+        this.transport = null;
+        this.client = null;
+      }
+      await this.reconnect();
+      return await fn();
+    }
   }
   /**
    * Reconnects to MCP server using existing OAuth provider from Redis
@@ -2859,6 +2897,12 @@ var MCPClient = class {
     if (!this.oauthProvider) {
       throw new Error("OAuth provider not initialized");
     }
+    if (this.client) {
+      try {
+        await this.client.close();
+      } catch {
+      }
+    }
     this.client = new index_js.Client(
       {
         name: MCP_CLIENT_NAME,
@@ -3055,6 +3099,18 @@ var MultiSessionClient = class {
   getClients() {
     return this.clients;
   }
+  /**
+   * Removes and disconnects a single session by ID.
+   *
+   * @returns `true` if the session was found and removed, `false` if not found.
+   */
+  async removeSession(sessionId) {
+    const idx = this.clients.findIndex((c) => c.getSessionId() === sessionId);
+    if (idx === -1) return false;
+    const [client] = this.clients.splice(idx, 1);
+    await client.disconnect();
+    return true;
+  }
   /**
    * Gracefully disconnects all active MCP clients and clears the internal list.
    *