@mcp-ts/sdk 1.3.7 → 1.3.9

package/src/shared/events.ts

@@ -1,180 +1,180 @@
-/**
- * Simple event emitter pattern for MCP connection events
- * Inspired by Cloudflare's agents pattern but adapted for serverless
- */
-
-export type Disposable = {
-  dispose(): void;
-};
-
-export 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
- */
-export class Emitter<T> {
-  private listeners: Set<(event: T) => void> = new Set();
-
-  /**
-   * Subscribe to events
-   * @param listener - Callback function to handle events
-   * @returns Disposable to unsubscribe
-   */
-  get event(): Event<T> {
-    return (listener: (event: T) => void) => {
-      this.listeners.add(listener);
-      return {
-        dispose: () => {
-          this.listeners.delete(listener);
-        },
-      };
-    };
-  }
-
-  /**
-   * Fire an event to all listeners
-   * @param event - Event data to emit
-   */
-  fire(event: T): void {
-    for (const listener of this.listeners) {
-      try {
-        listener(event);
-      } catch (error) {
-        console.error('[Emitter] Error in event listener:', error);
-      }
-    }
-  }
-
-  /**
-   * Clear all listeners
-   */
-  dispose(): void {
-    this.listeners.clear();
-  }
-
-  /**
-   * Get number of active listeners
-   */
-  get listenerCount(): number {
-    return this.listeners.size;
-  }
-}
-
-/**
- * Connection state types matching your existing ConnectionStatus
- * Extended with more granular states for better observability
- */
-export type McpConnectionState =
-  | 'DISCONNECTED'      // Not connected
-  | 'CONNECTING'        // Establishing transport connection to MCP server
-  | 'AUTHENTICATING'    // OAuth flow in progress
-  | 'AUTHENTICATED'     // OAuth complete, pre-connect
-  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)
-  | 'CONNECTED'         // Transport connection established
-  | 'READY'             // Fully connected and ready to use
-  | 'VALIDATING'        // Validating existing session
-  | 'RECONNECTING'      // Attempting to reconnect
-  | 'INITIALIZING'      // Initializing session or connection
-  | 'FAILED';           // Connection error at some point
-
-/**
- * MCP Connection Event Types
- * Discriminated union for type-safe event handling
- */
-export 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;
-    reason?: string;
-    timestamp: number;
-  }
-  | {
-    type: 'progress';
-    sessionId: string;
-    serverId: string;
-    message: string;
-    timestamp: number;
-  };
-
-/**
- * Event fired when a tool execution returns a UI resource URI
- */
-export interface McpAppsUIEvent {
-  type: 'mcp-apps-ui';
-  sessionId: string;
-  resourceUri: string;
-  toolName: string;
-  result: unknown;
-  timestamp: number;
-}
-
-/**
- * Observability event for debugging and monitoring
- */
-export 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>; // Kept for backward compatibility
-  timestamp: number;
-  id?: string;
-}
-
-/**
- * DisposableStore for managing multiple disposables
- * Useful for cleanup in React hooks
- */
-export class DisposableStore {
-  private disposables: Set<Disposable> = new Set();
-
-  add(disposable: Disposable): void {
-    this.disposables.add(disposable);
-  }
-
-  dispose(): void {
-    for (const disposable of this.disposables) {
-      disposable.dispose();
-    }
-    this.disposables.clear();
-  }
-}
+/**
+ * Simple event emitter pattern for MCP connection events
+ * Inspired by Cloudflare's agents pattern but adapted for serverless
+ */
+
+export type Disposable = {
+  dispose(): void;
+};
+
+export 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
+ */
+export class Emitter<T> {
+  private listeners: Set<(event: T) => void> = new Set();
+
+  /**
+   * Subscribe to events
+   * @param listener - Callback function to handle events
+   * @returns Disposable to unsubscribe
+   */
+  get event(): Event<T> {
+    return (listener: (event: T) => void) => {
+      this.listeners.add(listener);
+      return {
+        dispose: () => {
+          this.listeners.delete(listener);
+        },
+      };
+    };
+  }
+
+  /**
+   * Fire an event to all listeners
+   * @param event - Event data to emit
+   */
+  fire(event: T): void {
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch (error) {
+        console.error('[Emitter] Error in event listener:', error);
+      }
+    }
+  }
+
+  /**
+   * Clear all listeners
+   */
+  dispose(): void {
+    this.listeners.clear();
+  }
+
+  /**
+   * Get number of active listeners
+   */
+  get listenerCount(): number {
+    return this.listeners.size;
+  }
+}
+
+/**
+ * Connection state types matching your existing ConnectionStatus
+ * Extended with more granular states for better observability
+ */
+export type McpConnectionState =
+  | 'DISCONNECTED'      // Not connected
+  | 'CONNECTING'        // Establishing transport connection to MCP server
+  | 'AUTHENTICATING'    // OAuth flow in progress
+  | 'AUTHENTICATED'     // OAuth complete, pre-connect
+  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)
+  | 'CONNECTED'         // Transport connection established
+  | 'READY'             // Fully connected and ready to use
+  | 'VALIDATING'        // Validating existing session
+  | 'RECONNECTING'      // Attempting to reconnect
+  | 'INITIALIZING'      // Initializing session or connection
+  | 'FAILED';           // Connection error at some point
+
+/**
+ * MCP Connection Event Types
+ * Discriminated union for type-safe event handling
+ */
+export 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;
+    reason?: string;
+    timestamp: number;
+  }
+  | {
+    type: 'progress';
+    sessionId: string;
+    serverId: string;
+    message: string;
+    timestamp: number;
+  };
+
+/**
+ * Event fired when a tool execution returns a UI resource URI
+ */
+export interface McpAppsUIEvent {
+  type: 'mcp-apps-ui';
+  sessionId: string;
+  resourceUri: string;
+  toolName: string;
+  result: unknown;
+  timestamp: number;
+}
+
+/**
+ * Observability event for debugging and monitoring
+ */
+export 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>; // Kept for backward compatibility
+  timestamp: number;
+  id?: string;
+}
+
+/**
+ * DisposableStore for managing multiple disposables
+ * Useful for cleanup in React hooks
+ */
+export class DisposableStore {
+  private disposables: Set<Disposable> = new Set();
+
+  add(disposable: Disposable): void {
+    this.disposables.add(disposable);
+  }
+
+  dispose(): void {
+    for (const disposable of this.disposables) {
+      disposable.dispose();
+    }
+    this.disposables.clear();
+  }
+}

package/src/shared/index.ts

@@ -1,75 +1,75 @@
-/**
- * MCP Redis Shared Package
- * Shared types and utilities for both server and client
- */
-
-// Events
-export {
-  Emitter,
-  DisposableStore,
-  type Disposable,
-  type Event,
-  type McpConnectionState,
-  type McpConnectionEvent,
-  type McpObservabilityEvent,
-} from './events';
-
-// Constants
-export * from './constants';
-
-// Errors
-export * from './errors';
-
-// Types
-export type {
-  ToolInfo,
-  McpRpcRequest,
-  McpRpcResponse,
-  McpRpcMethod,
-  McpRpcParams,
-  TransportType,
-  // API types
-  ConnectRequest,
-  ConnectResponse,
-  ConnectSuccessResponse,
-  ConnectAuthRequiredResponse,
-  ConnectErrorResponse,
-  ListToolsResponse,
-  CallToolRequest,
-  CallToolResponse,
-  // RPC param types
-  ConnectParams,
-  DisconnectParams,
-  SessionParams,
-  CallToolParams,
-  GetPromptParams,
-  ReadResourceParams,
-  FinishAuthParams,
-  // RPC result types
-  SessionInfo,
-  SessionListResult,
-  ConnectResult,
-  DisconnectResult,
-  RestoreSessionResult,
-  FinishAuthResult,
-  ListToolsRpcResult,
-  ListPromptsResult,
-  ListResourcesResult,
-} from './types';
-
-export {
-  isConnectSuccess,
-  isConnectAuthRequired,
-  isConnectError,
-  isListToolsSuccess,
-  isCallToolSuccess,
-} from './types';
-
-// Utilities
-export { sanitizeServerLabel } from './utils.js';
-export {
-  getToolUiResourceUri,
-  findToolByName,
-  type ToolUiConfig,
-} from './tool-utils.js';
-
+/**
+ * MCP Redis Shared Package
+ * Shared types and utilities for both server and client
+ */
+
+// Events
+export {
+  Emitter,
+  DisposableStore,
+  type Disposable,
+  type Event,
+  type McpConnectionState,
+  type McpConnectionEvent,
+  type McpObservabilityEvent,
+} from './events';
+
+// Constants
+export * from './constants';
+
+// Errors
+export * from './errors';
+
+// Types
+export type {
+  ToolInfo,
+  McpRpcRequest,
+  McpRpcResponse,
+  McpRpcMethod,
+  McpRpcParams,
+  TransportType,
+  // API types
+  ConnectRequest,
+  ConnectResponse,
+  ConnectSuccessResponse,
+  ConnectAuthRequiredResponse,
+  ConnectErrorResponse,
+  ListToolsResponse,
+  CallToolRequest,
+  CallToolResponse,
+  // RPC param types
+  ConnectParams,
+  DisconnectParams,
+  SessionParams,
+  CallToolParams,
+  GetPromptParams,
+  ReadResourceParams,
+  FinishAuthParams,
+  // RPC result types
+  SessionInfo,
+  SessionListResult,
+  ConnectResult,
+  DisconnectResult,
+  RestoreSessionResult,
+  FinishAuthResult,
+  ListToolsRpcResult,
+  ListPromptsResult,
+  ListResourcesResult,
+} from './types';
+
+export {
+  isConnectSuccess,
+  isConnectAuthRequired,
+  isConnectError,
+  isListToolsSuccess,
+  isCallToolSuccess,
+} from './types';
+
+// Utilities
+export { sanitizeServerLabel } from './utils.js';
+export {
+  getToolUiResourceUri,
+  findToolByName,
+  type ToolUiConfig,
+} from './tool-utils.js';
+

package/src/shared/tool-utils.ts

@@ -1,61 +1,61 @@
-/**
- * Utility functions for working with MCP tool metadata
- */
-
-import type { ToolInfo } from './types.js';
-
-export interface ToolUiConfig {
-  resourceUri: string;
-  sessionId: string;
-}
-
-/**
- * Extract UI resource URI from tool metadata
- *
- * @param tool - The tool to extract UI config from
- * @returns The resource URI if available, undefined otherwise
- *
- * @example
- * const uri = getToolUiResourceUri(tool);
- * if (uri) {
- *   // Tool has UI configuration
- * }
- */
-export function getToolUiResourceUri(tool: ToolInfo): string | undefined {
-  const meta = (tool as any)._meta;
-  if (!meta?.ui) return undefined;
-
-  const ui = meta.ui;
-  if (typeof ui !== "object" || !ui) return undefined;
-
-  // Check visibility filter - skip if explicitly hidden from app
-  if (ui.visibility && !ui.visibility.includes("app")) return undefined;
-
-  // Support both 'uri' and 'resourceUri' field names for flexibility
-  return typeof ui.resourceUri === "string"
-    ? ui.resourceUri
-    : typeof ui.uri === "string"
-      ? ui.uri
-      : undefined;
-}
-
-/**
- * Find a tool by name within connections
- *
- * @param connections - Array of MCP connections
- * @param toolName - Name of the tool to find
- * @returns The tool if found, undefined otherwise
- *
- * @example
- * const tool = findToolByName(connections, "get_weather");
- */
-export function findToolByName(
-  connections: Array<{ tools: ToolInfo[] }>,
-  toolName: string
-): ToolInfo | undefined {
-  for (const conn of connections) {
-    const tool = conn.tools.find((t) => t.name === toolName);
-    if (tool) return tool;
-  }
-  return undefined;
-}
+/**
+ * Utility functions for working with MCP tool metadata
+ */
+
+import type { ToolInfo } from './types.js';
+
+export interface ToolUiConfig {
+  resourceUri: string;
+  sessionId: string;
+}
+
+/**
+ * Extract UI resource URI from tool metadata
+ *
+ * @param tool - The tool to extract UI config from
+ * @returns The resource URI if available, undefined otherwise
+ *
+ * @example
+ * const uri = getToolUiResourceUri(tool);
+ * if (uri) {
+ *   // Tool has UI configuration
+ * }
+ */
+export function getToolUiResourceUri(tool: ToolInfo): string | undefined {
+  const meta = (tool as any)._meta;
+  if (!meta?.ui) return undefined;
+
+  const ui = meta.ui;
+  if (typeof ui !== "object" || !ui) return undefined;
+
+  // Check visibility filter - skip if explicitly hidden from app
+  if (ui.visibility && !ui.visibility.includes("app")) return undefined;
+
+  // Support both 'uri' and 'resourceUri' field names for flexibility
+  return typeof ui.resourceUri === "string"
+    ? ui.resourceUri
+    : typeof ui.uri === "string"
+      ? ui.uri
+      : undefined;
+}
+
+/**
+ * Find a tool by name within connections
+ *
+ * @param connections - Array of MCP connections
+ * @param toolName - Name of the tool to find
+ * @returns The tool if found, undefined otherwise
+ *
+ * @example
+ * const tool = findToolByName(connections, "get_weather");
+ */
+export function findToolByName(
+  connections: Array<{ tools: ToolInfo[] }>,
+  toolName: string
+): ToolInfo | undefined {
+  for (const conn of connections) {
+    const tool = conn.tools.find((t) => t.name === toolName);
+    if (tool) return tool;
+  }
+  return undefined;
+}