@mcp-ts/sdk 2.4.1 → 2.4.3

package/dist/shared/index.d.mts

@@ -1,9 +1,8 @@
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-C4m7tK1U.mjs';
+import { B as ToolInfo } from '../types-CjczQwNX.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, k as Disposable, l as DisposableStore, E as Emitter, m as Event, F as FinishAuthParams, n as FinishAuthResult, G as GetPromptParams, o as GetSessionResult, L as ListPromptsResult, p as ListResourcesResult, q as ListToolsResponse, r as ListToolsRpcResult, M as McpConnectionEvent, s as McpConnectionState, t as McpObservabilityEvent, u as McpRpcMethod, v as McpRpcParams, w as McpRpcRequest, x as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, y as SessionListResult, z as SessionParams, T as ToolClient, A as ToolClientProvider, H as TransportType, I as isCallToolSuccess, J as isConnectAuthRequired, K as isConnectError, N as isConnectSuccess, O as isListToolsSuccess } from '../types-CjczQwNX.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';
-import { v as ToolInfo } from '../types-DCk_IF4L.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, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-DCk_IF4L.mjs';
-import { d as ToolRouter } from '../tool-router-CuApsDiV.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, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-CuApsDiV.mjs';
+import { d as ToolRouter } from '../tool-router-CbG4Tum6.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, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-CbG4Tum6.mjs';
 import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/shared/index.d.ts

@@ -1,9 +1,8 @@
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-C4m7tK1U.js';
+import { B as ToolInfo } from '../types-CjczQwNX.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, k as Disposable, l as DisposableStore, E as Emitter, m as Event, F as FinishAuthParams, n as FinishAuthResult, G as GetPromptParams, o as GetSessionResult, L as ListPromptsResult, p as ListResourcesResult, q as ListToolsResponse, r as ListToolsRpcResult, M as McpConnectionEvent, s as McpConnectionState, t as McpObservabilityEvent, u as McpRpcMethod, v as McpRpcParams, w as McpRpcRequest, x as McpRpcResponse, R as ReadResourceParams, S as SessionInfo, y as SessionListResult, z as SessionParams, T as ToolClient, A as ToolClientProvider, H as TransportType, I as isCallToolSuccess, J as isConnectAuthRequired, K as isConnectError, N as isConnectSuccess, O as isListToolsSuccess } from '../types-CjczQwNX.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';
-import { v as ToolInfo } from '../types-DCk_IF4L.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, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from '../types-DCk_IF4L.js';
-import { d as ToolRouter } from '../tool-router-CZMrOG8J.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, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-CZMrOG8J.js';
+import { d as ToolRouter } from '../tool-router-ChIhPwgP.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, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSearchOptions, i as ToolServerSummary, j as ToolSummary } from '../tool-router-ChIhPwgP.js';
 import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/{tool-router-CuApsDiV.d.mts → tool-router-CbG4Tum6.d.mts}

@@ -1,5 +1,5 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import { u as ToolClientProvider, T as ToolClient } from './types-DCk_IF4L.mjs';
+import { A as ToolClientProvider, T as ToolClient } from './types-CjczQwNX.mjs';
 
 /**
  * ToolIndex — Lightweight in-memory search index for MCP tool discovery.

package/dist/{tool-router-CZMrOG8J.d.ts → tool-router-ChIhPwgP.d.ts}

@@ -1,5 +1,5 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import { u as ToolClientProvider, T as ToolClient } from './types-DCk_IF4L.js';
+import { A as ToolClientProvider, T as ToolClient } from './types-CjczQwNX.js';
 
 /**
  * ToolIndex — Lightweight in-memory search index for MCP tool discovery.

package/dist/{types-DCk_IF4L.d.mts → types-CjczQwNX.d.mts}

@@ -1,5 +1,126 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
+/**
+ * Simple event emitter pattern for MCP connection events
+ * Inspired by Cloudflare's agents pattern but adapted for serverless
+ */
+type Disposable = {
+    dispose(): void;
+};
+type Event<T> = (listener: (event: T) => void) => Disposable;
+/**
+ * Event emitter class for type-safe event handling
+ * Similar to Cloudflare's Emitter but simplified for our use case
+ */
+declare class Emitter<T> {
+    private listeners;
+    /**
+     * Subscribe to events
+     * @param listener - Callback function to handle events
+     * @returns Disposable to unsubscribe
+     */
+    get event(): Event<T>;
+    /**
+     * Fire an event to all listeners
+     * @param event - Event data to emit
+     */
+    fire(event: T): void;
+    /**
+     * Clear all listeners
+     */
+    dispose(): void;
+    /**
+     * Get number of active listeners
+     */
+    get listenerCount(): number;
+}
+/**
+ * Connection state types matching your existing ConnectionStatus
+ * Extended with more granular states for better observability
+ */
+type McpConnectionState = 'DISCONNECTED' | 'CONNECTING' | 'AUTHENTICATING' | 'AUTHENTICATED' | 'DISCOVERING' | 'CONNECTED' | 'READY' | 'VALIDATING' | 'RECONNECTING' | 'INITIALIZING' | 'FAILED';
+/**
+ * MCP Connection Event Types
+ * Discriminated union for type-safe event handling
+ */
+type McpConnectionEvent = {
+    type: 'state_changed';
+    sessionId: string;
+    serverId: string;
+    serverName: string;
+    serverUrl: string;
+    createdAt?: number;
+    state: McpConnectionState;
+    previousState: McpConnectionState;
+    timestamp: number;
+} | {
+    type: 'tools_discovered';
+    sessionId: string;
+    serverId: string;
+    toolCount: number;
+    tools: any[];
+    timestamp: number;
+} | {
+    type: 'auth_required';
+    sessionId: string;
+    serverId: string;
+    authUrl: string;
+    timestamp: number;
+} | {
+    type: 'error';
+    sessionId: string;
+    serverId: string;
+    error: string;
+    errorType: 'connection' | 'auth' | 'validation' | 'unknown';
+    timestamp: number;
+} | {
+    type: 'disconnected';
+    sessionId: string;
+    serverId: string;
+    timestamp: number;
+} | {
+    type: 'progress';
+    sessionId: string;
+    serverId: string;
+    message: string;
+    timestamp: number;
+};
+/**
+ * Event fired when a tool execution returns a UI resource URI
+ */
+interface McpAppsUIEvent {
+    type: 'mcp-apps-ui';
+    sessionId: string;
+    resourceUri: string;
+    toolName: string;
+    result: unknown;
+    timestamp: number;
+}
+/**
+ * Observability event for debugging and monitoring
+ */
+interface McpObservabilityEvent {
+    type?: string;
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    message?: string;
+    displayMessage?: string;
+    sessionId?: string;
+    serverId?: string;
+    payload?: Record<string, any>;
+    metadata?: Record<string, any>;
+    timestamp: number;
+    id?: string;
+}
+/**
+ * DisposableStore for managing multiple disposables
+ * Useful for cleanup in React hooks
+ */
+declare class DisposableStore {
+    private disposables;
+    add(disposable: Disposable): void;
+    dispose(): void;
+}
+
 /**
  * Type definitions for MCP operations
  */
@@ -186,4 +307,4 @@ interface ListResourcesResult {
     }>;
 }
 
-export { isConnectSuccess as A, isListToolsSuccess as B, type CallToolParams as C, type DisconnectParams as D, type FinishAuthParams as F, type GetPromptParams as G, type ListPromptsResult as L, type McpRpcMethod as M, type ReadResourceParams as R, type SessionInfo as S, type ToolClient as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type FinishAuthResult as k, type GetSessionResult as l, type ListResourcesResult as m, type ListToolsResponse as n, type ListToolsRpcResult as o, type McpRpcParams as p, type McpRpcRequest as q, type McpRpcResponse as r, type SessionListResult as s, type SessionParams as t, type ToolClientProvider as u, type ToolInfo as v, type TransportType as w, isCallToolSuccess as x, isConnectAuthRequired as y, isConnectError as z };
+export { type ToolClientProvider as A, type ToolInfo as B, type CallToolParams as C, type DisconnectParams as D, Emitter as E, type FinishAuthParams as F, type GetPromptParams as G, type TransportType as H, isCallToolSuccess as I, isConnectAuthRequired as J, isConnectError as K, type ListPromptsResult as L, type McpConnectionEvent as M, isConnectSuccess as N, isListToolsSuccess as O, type McpAppsUIEvent as P, type ReadResourceParams as R, type SessionInfo as S, type ToolClient as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type Disposable as k, DisposableStore as l, type Event as m, type FinishAuthResult as n, type GetSessionResult as o, type ListResourcesResult as p, type ListToolsResponse as q, type ListToolsRpcResult as r, type McpConnectionState as s, type McpObservabilityEvent as t, type McpRpcMethod as u, type McpRpcParams as v, type McpRpcRequest as w, type McpRpcResponse as x, type SessionListResult as y, type SessionParams as z };

package/dist/{types-DCk_IF4L.d.ts → types-CjczQwNX.d.ts}

@@ -1,5 +1,126 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
+/**
+ * Simple event emitter pattern for MCP connection events
+ * Inspired by Cloudflare's agents pattern but adapted for serverless
+ */
+type Disposable = {
+    dispose(): void;
+};
+type Event<T> = (listener: (event: T) => void) => Disposable;
+/**
+ * Event emitter class for type-safe event handling
+ * Similar to Cloudflare's Emitter but simplified for our use case
+ */
+declare class Emitter<T> {
+    private listeners;
+    /**
+     * Subscribe to events
+     * @param listener - Callback function to handle events
+     * @returns Disposable to unsubscribe
+     */
+    get event(): Event<T>;
+    /**
+     * Fire an event to all listeners
+     * @param event - Event data to emit
+     */
+    fire(event: T): void;
+    /**
+     * Clear all listeners
+     */
+    dispose(): void;
+    /**
+     * Get number of active listeners
+     */
+    get listenerCount(): number;
+}
+/**
+ * Connection state types matching your existing ConnectionStatus
+ * Extended with more granular states for better observability
+ */
+type McpConnectionState = 'DISCONNECTED' | 'CONNECTING' | 'AUTHENTICATING' | 'AUTHENTICATED' | 'DISCOVERING' | 'CONNECTED' | 'READY' | 'VALIDATING' | 'RECONNECTING' | 'INITIALIZING' | 'FAILED';
+/**
+ * MCP Connection Event Types
+ * Discriminated union for type-safe event handling
+ */
+type McpConnectionEvent = {
+    type: 'state_changed';
+    sessionId: string;
+    serverId: string;
+    serverName: string;
+    serverUrl: string;
+    createdAt?: number;
+    state: McpConnectionState;
+    previousState: McpConnectionState;
+    timestamp: number;
+} | {
+    type: 'tools_discovered';
+    sessionId: string;
+    serverId: string;
+    toolCount: number;
+    tools: any[];
+    timestamp: number;
+} | {
+    type: 'auth_required';
+    sessionId: string;
+    serverId: string;
+    authUrl: string;
+    timestamp: number;
+} | {
+    type: 'error';
+    sessionId: string;
+    serverId: string;
+    error: string;
+    errorType: 'connection' | 'auth' | 'validation' | 'unknown';
+    timestamp: number;
+} | {
+    type: 'disconnected';
+    sessionId: string;
+    serverId: string;
+    timestamp: number;
+} | {
+    type: 'progress';
+    sessionId: string;
+    serverId: string;
+    message: string;
+    timestamp: number;
+};
+/**
+ * Event fired when a tool execution returns a UI resource URI
+ */
+interface McpAppsUIEvent {
+    type: 'mcp-apps-ui';
+    sessionId: string;
+    resourceUri: string;
+    toolName: string;
+    result: unknown;
+    timestamp: number;
+}
+/**
+ * Observability event for debugging and monitoring
+ */
+interface McpObservabilityEvent {
+    type?: string;
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    message?: string;
+    displayMessage?: string;
+    sessionId?: string;
+    serverId?: string;
+    payload?: Record<string, any>;
+    metadata?: Record<string, any>;
+    timestamp: number;
+    id?: string;
+}
+/**
+ * DisposableStore for managing multiple disposables
+ * Useful for cleanup in React hooks
+ */
+declare class DisposableStore {
+    private disposables;
+    add(disposable: Disposable): void;
+    dispose(): void;
+}
+
 /**
  * Type definitions for MCP operations
  */
@@ -186,4 +307,4 @@ interface ListResourcesResult {
     }>;
 }
 
-export { isConnectSuccess as A, isListToolsSuccess as B, type CallToolParams as C, type DisconnectParams as D, type FinishAuthParams as F, type GetPromptParams as G, type ListPromptsResult as L, type McpRpcMethod as M, type ReadResourceParams as R, type SessionInfo as S, type ToolClient as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type FinishAuthResult as k, type GetSessionResult as l, type ListResourcesResult as m, type ListToolsResponse as n, type ListToolsRpcResult as o, type McpRpcParams as p, type McpRpcRequest as q, type McpRpcResponse as r, type SessionListResult as s, type SessionParams as t, type ToolClientProvider as u, type ToolInfo as v, type TransportType as w, isCallToolSuccess as x, isConnectAuthRequired as y, isConnectError as z };
+export { type ToolClientProvider as A, type ToolInfo as B, type CallToolParams as C, type DisconnectParams as D, Emitter as E, type FinishAuthParams as F, type GetPromptParams as G, type TransportType as H, isCallToolSuccess as I, isConnectAuthRequired as J, isConnectError as K, type ListPromptsResult as L, type McpConnectionEvent as M, isConnectSuccess as N, isListToolsSuccess as O, type McpAppsUIEvent as P, type ReadResourceParams as R, type SessionInfo as S, type ToolClient as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type Disposable as k, DisposableStore as l, type Event as m, type FinishAuthResult as n, type GetSessionResult as o, type ListResourcesResult as p, type ListToolsResponse as q, type ListToolsRpcResult as r, type McpConnectionState as s, type McpObservabilityEvent as t, type McpRpcMethod as u, type McpRpcParams as v, type McpRpcRequest as w, type McpRpcResponse as x, type SessionListResult as y, type SessionParams as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-ts/sdk",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "publishConfig": {
     "access": "public"
   },

package/src/bin/mcp-ts.ts

@@ -82,13 +82,13 @@ async function initSupabase() {
             console.log('   npx supabase db push');
             console.log('\n3. Add your Supabase credentials to .env:');
             console.log('   SUPABASE_URL=https://<your-project-id>.supabase.co');
-            console.log('   SUPABASE_SERVICE_ROLE_KEY=<your-service-role-key>');
-            console.log('\n⚠️  Important: Use the service_role key (not the anon key) for server-side storage.');
-            console.log('   The service_role key bypasses RLS policies and is required for mcp-ts to work correctly.');
-            console.log('   Find it in: Supabase Dashboard -> Project Settings -> API -> service_role');
+            console.log('   SUPABASE_SECRET_KEY=<your-secret-key>');
+            console.log('\n⚠️  Important: Use the secret key (not the anon key) for server-side storage.');
+            console.log('   The secret key bypasses RLS policies and is required for mcp-ts to work correctly.');
+            console.log('   Find it in: Supabase Dashboard -> Project Settings -> API -> Secret key');
         } else if (files.length > 0) {
             console.log('\n👍 All migration files are already present in your project.');
-            console.log('   Ensure SUPABASE_SERVICE_ROLE_KEY (not SUPABASE_ANON_KEY) is set in your .env');
+            console.log('   Ensure SUPABASE_SECRET_KEY (not SUPABASE_ANON_KEY) is set in your .env');
         } else {
             console.log('⚠️  No migration files found to copy.');
         }