@mcp-ts/sdk 1.3.2 → 1.3.4

package/dist/shared/index.d.mts

@@ -1,7 +1,7 @@
 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 { 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-0qmYrqoa.mjs';
-import { T as ToolInfo } from '../types-PjM1W07s.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-PjM1W07s.mjs';
+import { T as ToolInfo } from '../types-CW6lghof.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CW6lghof.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/shared/index.d.ts

@@ -1,7 +1,7 @@
 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 { 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-0qmYrqoa.js';
-import { T as ToolInfo } from '../types-PjM1W07s.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-PjM1W07s.js';
+import { T as ToolInfo } from '../types-CW6lghof.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 ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CW6lghof.js';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/utils.ts","../../src/shared/tool-utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Simple event emitter pattern for MCP connection events\r\n * Inspired by Cloudflare's agents pattern but adapted for serverless\r\n */\r\n\r\nexport type Disposable = {\r\n  dispose(): void;\r\n};\r\n\r\nexport type Event<T> = (listener: (event: T) => void) => Disposable;\r\n\r\n/**\r\n * Event emitter class for type-safe event handling\r\n * Similar to Cloudflare's Emitter but simplified for our use case\r\n */\r\nexport class Emitter<T> {\r\n  private listeners: Set<(event: T) => void> = new Set();\r\n\r\n  /**\r\n   * Subscribe to events\r\n   * @param listener - Callback function to handle events\r\n   * @returns Disposable to unsubscribe\r\n   */\r\n  get event(): Event<T> {\r\n    return (listener: (event: T) => void) => {\r\n      this.listeners.add(listener);\r\n      return {\r\n        dispose: () => {\r\n          this.listeners.delete(listener);\r\n        },\r\n      };\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Fire an event to all listeners\r\n   * @param event - Event data to emit\r\n   */\r\n  fire(event: T): void {\r\n    for (const listener of this.listeners) {\r\n      try {\r\n        listener(event);\r\n      } catch (error) {\r\n        console.error('[Emitter] Error in event listener:', error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clear all listeners\r\n   */\r\n  dispose(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Get number of active listeners\r\n   */\r\n  get listenerCount(): number {\r\n    return this.listeners.size;\r\n  }\r\n}\r\n\r\n/**\r\n * Connection state types matching your existing ConnectionStatus\r\n * Extended with more granular states for better observability\r\n */\r\nexport type McpConnectionState =\r\n  | 'DISCONNECTED'      // Not connected\r\n  | 'CONNECTING'        // Establishing transport connection to MCP server\r\n  | 'AUTHENTICATING'    // OAuth flow in progress\r\n  | 'AUTHENTICATED'     // OAuth complete, pre-connect\r\n  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)\r\n  | 'CONNECTED'         // Transport connection established\r\n  | 'READY'             // Fully connected and ready to use\r\n  | 'VALIDATING'        // Validating existing session\r\n  | 'RECONNECTING'      // Attempting to reconnect\r\n  | 'INITIALIZING'      // Initializing session or connection\r\n  | 'FAILED';           // Connection error at some point\r\n\r\n/**\r\n * MCP Connection Event Types\r\n * Discriminated union for type-safe event handling\r\n */\r\nexport type McpConnectionEvent =\r\n  | {\r\n    type: 'state_changed';\r\n    sessionId: string;\r\n    serverId: string;\r\n    serverName: string;\r\n    serverUrl: string;\r\n    createdAt?: number;\r\n    state: McpConnectionState;\r\n    previousState: McpConnectionState;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'tools_discovered';\r\n    sessionId: string;\r\n    serverId: string;\r\n    toolCount: number;\r\n    tools: any[];\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'auth_required';\r\n    sessionId: string;\r\n    serverId: string;\r\n    authUrl: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'error';\r\n    sessionId: string;\r\n    serverId: string;\r\n    error: string;\r\n    errorType: 'connection' | 'auth' | 'validation' | 'unknown';\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'disconnected';\r\n    sessionId: string;\r\n    serverId: string;\r\n    reason?: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'progress';\r\n    sessionId: string;\r\n    serverId: string;\r\n    message: string;\r\n    timestamp: number;\r\n  };\r\n\r\n/**\r\n * Event fired when a tool execution returns a UI resource URI\r\n */\r\nexport interface McpAppsUIEvent {\r\n  type: 'mcp-apps-ui';\r\n  sessionId: string;\r\n  resourceUri: string;\r\n  toolName: string;\r\n  result: unknown;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * Observability event for debugging and monitoring\r\n */\r\nexport interface McpObservabilityEvent {\r\n  type?: string;\r\n  level?: 'debug' | 'info' | 'warn' | 'error';\r\n  message?: string;\r\n  displayMessage?: string;\r\n  sessionId?: string;\r\n  serverId?: string;\r\n  payload?: Record<string, any>;\r\n  metadata?: Record<string, any>; // Kept for backward compatibility\r\n  timestamp: number;\r\n  id?: string;\r\n}\r\n\r\n/**\r\n * DisposableStore for managing multiple disposables\r\n * Useful for cleanup in React hooks\r\n */\r\nexport class DisposableStore {\r\n  private disposables: Set<Disposable> = new Set();\r\n\r\n  add(disposable: Disposable): void {\r\n    this.disposables.add(disposable);\r\n  }\r\n\r\n  dispose(): void {\r\n    for (const disposable of this.disposables) {\r\n      disposable.dispose();\r\n    }\r\n    this.disposables.clear();\r\n  }\r\n}\r\n","/**\r\n * Centralized constants for MCP Redis library\r\n * Eliminates magic numbers and enables consistent configuration\r\n */\r\n\r\n// Redis TTL and Session Management\r\nexport const SESSION_TTL_SECONDS = 43200; // 12 hours\r\nexport const STATE_EXPIRATION_MS = 10 * 60 * 1000; // 10 minutes for OAuth state\r\n\r\n// Heartbeat and Connection\r\nexport const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds\r\n\r\n// Redis Key Prefixes\r\nexport const REDIS_KEY_PREFIX = 'mcp:session:';\r\n\r\n// Token Management\r\nexport const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000; // 5 minute buffer before expiry\r\n\r\n// Client Information\r\nexport const DEFAULT_CLIENT_NAME = 'MCP Assistant';\r\nexport const DEFAULT_CLIENT_URI = 'https://mcp-assistant.in';\r\nexport const DEFAULT_LOGO_URI = 'https://mcp-assistant.in/logo.png';\r\nexport const DEFAULT_POLICY_URI = 'https://mcp-assistant.in/privacy';\r\nexport const SOFTWARE_ID = '@mcp-ts';\r\nexport const SOFTWARE_VERSION = '1.0.0-beta.5';\r\n\r\n// MCP Client Configuration\r\nexport const MCP_CLIENT_NAME = 'mcp-ts-oauth-client';\r\nexport const MCP_CLIENT_VERSION = '2.0';\r\n","/**\r\n * Standardized error classes for MCP Redis library\r\n * Provides consistent error handling across the codebase\r\n */\r\n\r\n/**\r\n * Base error class for all MCP-related errors\r\n */\r\nexport class McpError extends Error {\r\n    constructor(\r\n        public readonly code: string,\r\n        message: string,\r\n        public readonly cause?: Error\r\n    ) {\r\n        super(message);\r\n        this.name = 'McpError';\r\n        // Maintain proper prototype chain for instanceof checks\r\n        Object.setPrototypeOf(this, new.target.prototype);\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            ...(this.cause ? { cause: this.cause.message } : {}),\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth authorization is required\r\n */\r\nexport class UnauthorizedError extends McpError {\r\n    constructor(message: string = 'OAuth authorization required', cause?: Error) {\r\n        super('UNAUTHORIZED', message, cause);\r\n        this.name = 'UnauthorizedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when connection to MCP server fails\r\n */\r\nexport class ConnectionError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONNECTION_ERROR', message, cause);\r\n        this.name = 'ConnectionError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session is not found or expired\r\n */\r\nexport class SessionNotFoundError extends McpError {\r\n    constructor(sessionId: string, cause?: Error) {\r\n        super('SESSION_NOT_FOUND', `Session not found: ${sessionId}`, cause);\r\n        this.name = 'SessionNotFoundError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session validation fails\r\n */\r\nexport class SessionValidationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('SESSION_VALIDATION_ERROR', message, cause);\r\n        this.name = 'SessionValidationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when authentication fails\r\n */\r\nexport class AuthenticationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('AUTH_ERROR', message, cause);\r\n        this.name = 'AuthenticationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth state validation fails\r\n */\r\nexport class InvalidStateError extends McpError {\r\n    constructor(message: string = 'Invalid OAuth state', cause?: Error) {\r\n        super('INVALID_STATE', message, cause);\r\n        this.name = 'InvalidStateError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when client is not connected\r\n */\r\nexport class NotConnectedError extends McpError {\r\n    constructor(message: string = 'Not connected to server', cause?: Error) {\r\n        super('NOT_CONNECTED', message, cause);\r\n        this.name = 'NotConnectedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when required configuration is missing\r\n */\r\nexport class ConfigurationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONFIGURATION_ERROR', message, cause);\r\n        this.name = 'ConfigurationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when tool execution fails\r\n */\r\nexport class ToolExecutionError extends McpError {\r\n    constructor(toolName: string, message: string, cause?: Error) {\r\n        super('TOOL_EXECUTION_ERROR', `Tool '${toolName}' failed: ${message}`, cause);\r\n        this.name = 'ToolExecutionError';\r\n    }\r\n}\r\n\r\n/**\r\n * RPC error codes for SSE communication\r\n */\r\nexport const RpcErrorCodes = {\r\n    EXECUTION_ERROR: 'EXECUTION_ERROR',\r\n    MISSING_IDENTITY: 'MISSING_IDENTITY',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    NO_CONNECTION: 'NO_CONNECTION',\r\n    UNKNOWN_METHOD: 'UNKNOWN_METHOD',\r\n    INVALID_PARAMS: 'INVALID_PARAMS',\r\n} as const;\r\n\r\nexport type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];\r\n","/**\r\n * Type definitions for MCP operations\r\n */\r\n\r\nimport { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\r\n\r\n// Connect API types\r\nexport interface ConnectRequest {\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n}\r\n\r\nexport interface ConnectSuccessResponse {\r\n  success: true;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectAuthRequiredResponse {\r\n  requiresAuth: true;\r\n  authUrl: string;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ConnectResponse =\r\n  | ConnectSuccessResponse\r\n  | ConnectAuthRequiredResponse\r\n  | ConnectErrorResponse;\r\n\r\n// Callback API types\r\nexport interface CallbackSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface CallbackErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallbackResponse = CallbackSuccessResponse | CallbackErrorResponse;\r\n\r\n// Disconnect API types\r\nexport interface DisconnectRequest {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface DisconnectSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface DisconnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type DisconnectResponse =\r\n  | DisconnectSuccessResponse\r\n  | DisconnectErrorResponse;\r\n\r\n// List Tools API types\r\nexport interface ListToolsSuccessResponse {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListToolsErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ListToolsResponse =\r\n  | ListToolsSuccessResponse\r\n  | ListToolsErrorResponse;\r\n\r\n// Call Tool API types\r\nexport interface CallToolRequest {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface CallToolSuccessResponse {\r\n  content: Array<{\r\n    type: string;\r\n    text?: string;\r\n    [key: string]: unknown;\r\n  }>;\r\n  isError: boolean;\r\n}\r\n\r\nexport interface CallToolErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallToolResponse =\r\n  | CallToolSuccessResponse\r\n  | CallToolErrorResponse;\r\n\r\n// Helper type guards\r\nexport function isConnectSuccess(\r\n  response: ConnectResponse\r\n): response is ConnectSuccessResponse {\r\n  return 'success' in response && response.success === true;\r\n}\r\n\r\nexport function isConnectAuthRequired(\r\n  response: ConnectResponse\r\n): response is ConnectAuthRequiredResponse {\r\n  return 'requiresAuth' in response && response.requiresAuth === true;\r\n}\r\n\r\nexport function isConnectError(\r\n  response: ConnectResponse\r\n): response is ConnectErrorResponse {\r\n  return 'error' in response;\r\n}\r\n\r\nexport function isListToolsSuccess(\r\n  response: ListToolsResponse\r\n): response is ListToolsSuccessResponse {\r\n  return 'tools' in response;\r\n}\r\n\r\nexport function isCallToolSuccess(\r\n  response: CallToolResponse\r\n): response is CallToolSuccessResponse {\r\n  return 'content' in response;\r\n}\r\n\r\n// Generic tool info type\r\nexport type ToolInfo = {\r\n  name: string;\r\n  description?: string;\r\n  inputSchema?: unknown;\r\n};\r\n\r\n// Transport type\r\nexport type TransportType = 'sse' | 'streamable_http';\r\n\r\n// SSE/RPC types\r\nexport type McpRpcMethod =\r\n  | 'connect'\r\n  | 'disconnect'\r\n  | 'listTools'\r\n  | 'callTool'\r\n  | 'getSessions'\r\n  | 'restoreSession'\r\n  | 'finishAuth'\r\n  | 'listPrompts'\r\n  | 'getPrompt'\r\n  | 'listResources'\r\n  | 'readResource';\r\n\r\nexport interface McpRpcRequest {\r\n  id: string;\r\n  method: McpRpcMethod;\r\n  params?: McpRpcParams;\r\n}\r\n\r\nexport interface McpRpcResponse<T = unknown> {\r\n  id: string;\r\n  result?: T;\r\n  error?: {\r\n    code: string;\r\n    message: string;\r\n  };\r\n}\r\n\r\n// RPC Parameter Types\r\nexport interface ConnectParams {\r\n  serverId?: string; // Optional - generated server-side if not provided\r\n  serverName: string;\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n  transportType?: TransportType;\r\n}\r\n\r\nexport interface DisconnectParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface SessionParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface CallToolParams {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface GetPromptParams {\r\n  sessionId: string;\r\n  name: string;\r\n  args?: Record<string, string>;\r\n}\r\n\r\nexport interface ReadResourceParams {\r\n  sessionId: string;\r\n  uri: string;\r\n}\r\n\r\nexport interface FinishAuthParams {\r\n  sessionId: string;\r\n  code: string;\r\n}\r\n\r\nexport type McpRpcParams =\r\n  | ConnectParams\r\n  | DisconnectParams\r\n  | SessionParams\r\n  | CallToolParams\r\n  | GetPromptParams\r\n  | ReadResourceParams\r\n  | FinishAuthParams\r\n  | undefined;\r\n\r\n// RPC Result Types\r\nexport interface SessionInfo {\r\n  sessionId: string;\r\n  serverId?: string;\r\n  serverName?: string;\r\n  serverUrl: string;\r\n  transport: TransportType;\r\n  createdAt: number;\r\n}\r\n\r\nexport interface SessionListResult {\r\n  sessions: SessionInfo[];\r\n}\r\n\r\nexport interface ConnectResult {\r\n  sessionId: string;\r\n  success: boolean;\r\n}\r\n\r\nexport interface DisconnectResult {\r\n  success: boolean;\r\n}\r\n\r\nexport interface RestoreSessionResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface FinishAuthResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface ListToolsRpcResult {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListPromptsResult {\r\n  prompts: Array<{\r\n    name: string;\r\n    description?: string;\r\n    arguments?: Array<{\r\n      name: string;\r\n      description?: string;\r\n      required?: boolean;\r\n    }>;\r\n  }>;\r\n}\r\n\r\nexport interface ListResourcesResult {\r\n  resources: Array<{\r\n    uri: string;\r\n    name: string;\r\n    description?: string;\r\n    mimeType?: string;\r\n  }>;\r\n}\r\n\r\nexport type { CallToolResult };\r\n","/**\r\n * Sanitize server name to create a valid server label\r\n * Must start with a letter and contain only letters, digits, '-' and '_'\r\n */\r\nexport function sanitizeServerLabel(name: string): string {\r\n  let sanitized = name\r\n    .replace(/[^a-zA-Z0-9-_]/g, '_')\r\n    .replace(/_{2,}/g, '_')\r\n    .toLowerCase();\r\n\r\n  if (!/^[a-zA-Z]/.test(sanitized)) {\r\n    sanitized = 's_' + sanitized;\r\n  }\r\n\r\n  return sanitized;\r\n}\r\n","/**\r\n * Utility functions for working with MCP tool metadata\r\n */\r\n\r\nimport type { ToolInfo } from './types.js';\r\n\r\nexport interface ToolUiConfig {\r\n  resourceUri: string;\r\n  sessionId: string;\r\n}\r\n\r\n/**\r\n * Extract UI resource URI from tool metadata\r\n *\r\n * @param tool - The tool to extract UI config from\r\n * @returns The resource URI if available, undefined otherwise\r\n *\r\n * @example\r\n * const uri = getToolUiResourceUri(tool);\r\n * if (uri) {\r\n *   // Tool has UI configuration\r\n * }\r\n */\r\nexport function getToolUiResourceUri(tool: ToolInfo): string | undefined {\r\n  const meta = (tool as any)._meta;\r\n  if (!meta?.ui) return undefined;\r\n\r\n  const ui = meta.ui;\r\n  if (typeof ui !== \"object\" || !ui) return undefined;\r\n\r\n  // Check visibility filter - skip if explicitly hidden from app\r\n  if (ui.visibility && !ui.visibility.includes(\"app\")) return undefined;\r\n\r\n  // Support both 'uri' and 'resourceUri' field names for flexibility\r\n  return typeof ui.resourceUri === \"string\"\r\n    ? ui.resourceUri\r\n    : typeof ui.uri === \"string\"\r\n      ? ui.uri\r\n      : undefined;\r\n}\r\n\r\n/**\r\n * Find a tool by name within connections\r\n *\r\n * @param connections - Array of MCP connections\r\n * @param toolName - Name of the tool to find\r\n * @returns The tool if found, undefined otherwise\r\n *\r\n * @example\r\n * const tool = findToolByName(connections, \"get_weather\");\r\n */\r\nexport function findToolByName(\r\n  connections: Array<{ tools: ToolInfo[] }>,\r\n  toolName: string\r\n): ToolInfo | undefined {\r\n  for (const conn of connections) {\r\n    const tool = conn.tools.find((t) => t.name === toolName);\r\n    if (tool) return tool;\r\n  }\r\n  return undefined;\r\n}\r\n"]}
+{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/utils.ts","../../src/shared/tool-utils.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Simple event emitter pattern for MCP connection events\r\n * Inspired by Cloudflare's agents pattern but adapted for serverless\r\n */\r\n\r\nexport type Disposable = {\r\n  dispose(): void;\r\n};\r\n\r\nexport type Event<T> = (listener: (event: T) => void) => Disposable;\r\n\r\n/**\r\n * Event emitter class for type-safe event handling\r\n * Similar to Cloudflare's Emitter but simplified for our use case\r\n */\r\nexport class Emitter<T> {\r\n  private listeners: Set<(event: T) => void> = new Set();\r\n\r\n  /**\r\n   * Subscribe to events\r\n   * @param listener - Callback function to handle events\r\n   * @returns Disposable to unsubscribe\r\n   */\r\n  get event(): Event<T> {\r\n    return (listener: (event: T) => void) => {\r\n      this.listeners.add(listener);\r\n      return {\r\n        dispose: () => {\r\n          this.listeners.delete(listener);\r\n        },\r\n      };\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Fire an event to all listeners\r\n   * @param event - Event data to emit\r\n   */\r\n  fire(event: T): void {\r\n    for (const listener of this.listeners) {\r\n      try {\r\n        listener(event);\r\n      } catch (error) {\r\n        console.error('[Emitter] Error in event listener:', error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clear all listeners\r\n   */\r\n  dispose(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Get number of active listeners\r\n   */\r\n  get listenerCount(): number {\r\n    return this.listeners.size;\r\n  }\r\n}\r\n\r\n/**\r\n * Connection state types matching your existing ConnectionStatus\r\n * Extended with more granular states for better observability\r\n */\r\nexport type McpConnectionState =\r\n  | 'DISCONNECTED'      // Not connected\r\n  | 'CONNECTING'        // Establishing transport connection to MCP server\r\n  | 'AUTHENTICATING'    // OAuth flow in progress\r\n  | 'AUTHENTICATED'     // OAuth complete, pre-connect\r\n  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)\r\n  | 'CONNECTED'         // Transport connection established\r\n  | 'READY'             // Fully connected and ready to use\r\n  | 'VALIDATING'        // Validating existing session\r\n  | 'RECONNECTING'      // Attempting to reconnect\r\n  | 'INITIALIZING'      // Initializing session or connection\r\n  | 'FAILED';           // Connection error at some point\r\n\r\n/**\r\n * MCP Connection Event Types\r\n * Discriminated union for type-safe event handling\r\n */\r\nexport type McpConnectionEvent =\r\n  | {\r\n    type: 'state_changed';\r\n    sessionId: string;\r\n    serverId: string;\r\n    serverName: string;\r\n    serverUrl: string;\r\n    createdAt?: number;\r\n    state: McpConnectionState;\r\n    previousState: McpConnectionState;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'tools_discovered';\r\n    sessionId: string;\r\n    serverId: string;\r\n    toolCount: number;\r\n    tools: any[];\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'auth_required';\r\n    sessionId: string;\r\n    serverId: string;\r\n    authUrl: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'error';\r\n    sessionId: string;\r\n    serverId: string;\r\n    error: string;\r\n    errorType: 'connection' | 'auth' | 'validation' | 'unknown';\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'disconnected';\r\n    sessionId: string;\r\n    serverId: string;\r\n    reason?: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'progress';\r\n    sessionId: string;\r\n    serverId: string;\r\n    message: string;\r\n    timestamp: number;\r\n  };\r\n\r\n/**\r\n * Event fired when a tool execution returns a UI resource URI\r\n */\r\nexport interface McpAppsUIEvent {\r\n  type: 'mcp-apps-ui';\r\n  sessionId: string;\r\n  resourceUri: string;\r\n  toolName: string;\r\n  result: unknown;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * Observability event for debugging and monitoring\r\n */\r\nexport interface McpObservabilityEvent {\r\n  type?: string;\r\n  level?: 'debug' | 'info' | 'warn' | 'error';\r\n  message?: string;\r\n  displayMessage?: string;\r\n  sessionId?: string;\r\n  serverId?: string;\r\n  payload?: Record<string, any>;\r\n  metadata?: Record<string, any>; // Kept for backward compatibility\r\n  timestamp: number;\r\n  id?: string;\r\n}\r\n\r\n/**\r\n * DisposableStore for managing multiple disposables\r\n * Useful for cleanup in React hooks\r\n */\r\nexport class DisposableStore {\r\n  private disposables: Set<Disposable> = new Set();\r\n\r\n  add(disposable: Disposable): void {\r\n    this.disposables.add(disposable);\r\n  }\r\n\r\n  dispose(): void {\r\n    for (const disposable of this.disposables) {\r\n      disposable.dispose();\r\n    }\r\n    this.disposables.clear();\r\n  }\r\n}\r\n","/**\r\n * Centralized constants for MCP Redis library\r\n * Eliminates magic numbers and enables consistent configuration\r\n */\r\n\r\n// Redis TTL and Session Management\r\nexport const SESSION_TTL_SECONDS = 43200; // 12 hours\r\nexport const STATE_EXPIRATION_MS = 10 * 60 * 1000; // 10 minutes for OAuth state\r\n\r\n// Heartbeat and Connection\r\nexport const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds\r\n\r\n// Redis Key Prefixes\r\nexport const REDIS_KEY_PREFIX = 'mcp:session:';\r\n\r\n// Token Management\r\nexport const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000; // 5 minute buffer before expiry\r\n\r\n// Client Information\r\nexport const DEFAULT_CLIENT_NAME = 'MCP Assistant';\r\nexport const DEFAULT_CLIENT_URI = 'https://mcp-assistant.in';\r\nexport const DEFAULT_LOGO_URI = 'https://mcp-assistant.in/logo.png';\r\nexport const DEFAULT_POLICY_URI = 'https://mcp-assistant.in/privacy';\r\nexport const SOFTWARE_ID = '@mcp-ts';\r\nexport const SOFTWARE_VERSION = '1.0.0-beta.5';\r\n\r\n// MCP Client Configuration\r\nexport const MCP_CLIENT_NAME = 'mcp-ts-oauth-client';\r\nexport const MCP_CLIENT_VERSION = '2.0';\r\n","/**\r\n * Standardized error classes for MCP Redis library\r\n * Provides consistent error handling across the codebase\r\n */\r\n\r\n/**\r\n * Base error class for all MCP-related errors\r\n */\r\nexport class McpError extends Error {\r\n    constructor(\r\n        public readonly code: string,\r\n        message: string,\r\n        public readonly cause?: Error\r\n    ) {\r\n        super(message);\r\n        this.name = 'McpError';\r\n        // Maintain proper prototype chain for instanceof checks\r\n        Object.setPrototypeOf(this, new.target.prototype);\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            ...(this.cause ? { cause: this.cause.message } : {}),\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth authorization is required\r\n */\r\nexport class UnauthorizedError extends McpError {\r\n    constructor(message: string = 'OAuth authorization required', cause?: Error) {\r\n        super('UNAUTHORIZED', message, cause);\r\n        this.name = 'UnauthorizedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when connection to MCP server fails\r\n */\r\nexport class ConnectionError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONNECTION_ERROR', message, cause);\r\n        this.name = 'ConnectionError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session is not found or expired\r\n */\r\nexport class SessionNotFoundError extends McpError {\r\n    constructor(sessionId: string, cause?: Error) {\r\n        super('SESSION_NOT_FOUND', `Session not found: ${sessionId}`, cause);\r\n        this.name = 'SessionNotFoundError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session validation fails\r\n */\r\nexport class SessionValidationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('SESSION_VALIDATION_ERROR', message, cause);\r\n        this.name = 'SessionValidationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when authentication fails\r\n */\r\nexport class AuthenticationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('AUTH_ERROR', message, cause);\r\n        this.name = 'AuthenticationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth state validation fails\r\n */\r\nexport class InvalidStateError extends McpError {\r\n    constructor(message: string = 'Invalid OAuth state', cause?: Error) {\r\n        super('INVALID_STATE', message, cause);\r\n        this.name = 'InvalidStateError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when client is not connected\r\n */\r\nexport class NotConnectedError extends McpError {\r\n    constructor(message: string = 'Not connected to server', cause?: Error) {\r\n        super('NOT_CONNECTED', message, cause);\r\n        this.name = 'NotConnectedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when required configuration is missing\r\n */\r\nexport class ConfigurationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONFIGURATION_ERROR', message, cause);\r\n        this.name = 'ConfigurationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when tool execution fails\r\n */\r\nexport class ToolExecutionError extends McpError {\r\n    constructor(toolName: string, message: string, cause?: Error) {\r\n        super('TOOL_EXECUTION_ERROR', `Tool '${toolName}' failed: ${message}`, cause);\r\n        this.name = 'ToolExecutionError';\r\n    }\r\n}\r\n\r\n/**\r\n * RPC error codes for SSE communication\r\n */\r\nexport const RpcErrorCodes = {\r\n    EXECUTION_ERROR: 'EXECUTION_ERROR',\r\n    MISSING_IDENTITY: 'MISSING_IDENTITY',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    NO_CONNECTION: 'NO_CONNECTION',\r\n    UNKNOWN_METHOD: 'UNKNOWN_METHOD',\r\n    INVALID_PARAMS: 'INVALID_PARAMS',\r\n} as const;\r\n\r\nexport type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];\r\n","/**\r\n * Type definitions for MCP operations\r\n */\r\n\r\nimport { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\r\n\r\n// Connect API types\r\nexport interface ConnectRequest {\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n}\r\n\r\nexport interface ConnectSuccessResponse {\r\n  success: true;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectAuthRequiredResponse {\r\n  requiresAuth: true;\r\n  authUrl: string;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ConnectResponse =\r\n  | ConnectSuccessResponse\r\n  | ConnectAuthRequiredResponse\r\n  | ConnectErrorResponse;\r\n\r\n// Callback API types\r\nexport interface CallbackSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface CallbackErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallbackResponse = CallbackSuccessResponse | CallbackErrorResponse;\r\n\r\n// Disconnect API types\r\nexport interface DisconnectRequest {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface DisconnectSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface DisconnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type DisconnectResponse =\r\n  | DisconnectSuccessResponse\r\n  | DisconnectErrorResponse;\r\n\r\n// List Tools API types\r\nexport interface ListToolsSuccessResponse {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListToolsErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ListToolsResponse =\r\n  | ListToolsSuccessResponse\r\n  | ListToolsErrorResponse;\r\n\r\n// Call Tool API types\r\nexport interface CallToolRequest {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface CallToolSuccessResponse {\r\n  content: Array<{\r\n    type: string;\r\n    text?: string;\r\n    [key: string]: unknown;\r\n  }>;\r\n  isError: boolean;\r\n}\r\n\r\nexport interface CallToolErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallToolResponse =\r\n  | CallToolSuccessResponse\r\n  | CallToolErrorResponse;\r\n\r\n// Helper type guards\r\nexport function isConnectSuccess(\r\n  response: ConnectResponse\r\n): response is ConnectSuccessResponse {\r\n  return 'success' in response && response.success === true;\r\n}\r\n\r\nexport function isConnectAuthRequired(\r\n  response: ConnectResponse\r\n): response is ConnectAuthRequiredResponse {\r\n  return 'requiresAuth' in response && response.requiresAuth === true;\r\n}\r\n\r\nexport function isConnectError(\r\n  response: ConnectResponse\r\n): response is ConnectErrorResponse {\r\n  return 'error' in response;\r\n}\r\n\r\nexport function isListToolsSuccess(\r\n  response: ListToolsResponse\r\n): response is ListToolsSuccessResponse {\r\n  return 'tools' in response;\r\n}\r\n\r\nexport function isCallToolSuccess(\r\n  response: CallToolResponse\r\n): response is CallToolSuccessResponse {\r\n  return 'content' in response;\r\n}\r\n\r\n// Generic tool info type\r\nexport type ToolInfo = {\r\n  name: string;\r\n  description?: string;\r\n  inputSchema?: unknown;\r\n};\r\n\r\n// Transport type\r\nexport type TransportType = 'sse' | 'streamable_http';\r\n\r\n// SSE/RPC types\r\nexport type McpRpcMethod =\r\n  | 'connect'\r\n  | 'disconnect'\r\n  | 'listTools'\r\n  | 'callTool'\r\n  | 'getSessions'\r\n  | 'restoreSession'\r\n  | 'finishAuth'\r\n  | 'listPrompts'\r\n  | 'getPrompt'\r\n  | 'listResources'\r\n  | 'readResource';\r\n\r\nexport interface McpRpcRequest {\r\n  id: string;\r\n  method: McpRpcMethod;\r\n  params?: McpRpcParams;\r\n}\r\n\r\nexport interface McpRpcResponse<T = unknown> {\r\n  id: string;\r\n  result?: T;\r\n  error?: {\r\n    code: string;\r\n    message: string;\r\n  };\r\n}\r\n\r\n// RPC Parameter Types\r\nexport interface ConnectParams {\r\n  serverId?: string; // Optional - generated server-side if not provided\r\n  serverName: string;\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n  transportType?: TransportType;\r\n}\r\n\r\nexport interface DisconnectParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface SessionParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface CallToolParams {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface GetPromptParams {\r\n  sessionId: string;\r\n  name: string;\r\n  args?: Record<string, string>;\r\n}\r\n\r\nexport interface ReadResourceParams {\r\n  sessionId: string;\r\n  uri: string;\r\n}\r\n\r\nexport interface FinishAuthParams {\r\n  sessionId: string;\r\n  code: string;\r\n}\r\n\r\nexport type McpRpcParams =\r\n  | ConnectParams\r\n  | DisconnectParams\r\n  | SessionParams\r\n  | CallToolParams\r\n  | GetPromptParams\r\n  | ReadResourceParams\r\n  | FinishAuthParams\r\n  | undefined;\r\n\r\n// RPC Result Types\r\nexport interface SessionInfo {\r\n  sessionId: string;\r\n  serverId?: string;\r\n  serverName?: string;\r\n  serverUrl: string;\r\n  transport: TransportType;\r\n  createdAt: number;\r\n  /**\r\n   * Session readiness for auto-restore.\r\n   * false means auth is pending and should be resumed explicitly by user action.\r\n   */\r\n  active?: boolean;\r\n}\r\n\r\nexport interface SessionListResult {\r\n  sessions: SessionInfo[];\r\n}\r\n\r\nexport interface ConnectResult {\r\n  sessionId: string;\r\n  success: boolean;\r\n}\r\n\r\nexport interface DisconnectResult {\r\n  success: boolean;\r\n}\r\n\r\nexport interface RestoreSessionResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface FinishAuthResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface ListToolsRpcResult {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListPromptsResult {\r\n  prompts: Array<{\r\n    name: string;\r\n    description?: string;\r\n    arguments?: Array<{\r\n      name: string;\r\n      description?: string;\r\n      required?: boolean;\r\n    }>;\r\n  }>;\r\n}\r\n\r\nexport interface ListResourcesResult {\r\n  resources: Array<{\r\n    uri: string;\r\n    name: string;\r\n    description?: string;\r\n    mimeType?: string;\r\n  }>;\r\n}\r\n\r\nexport type { CallToolResult };\r\n","/**\r\n * Sanitize server name to create a valid server label\r\n * Must start with a letter and contain only letters, digits, '-' and '_'\r\n */\r\nexport function sanitizeServerLabel(name: string): string {\r\n  let sanitized = name\r\n    .replace(/[^a-zA-Z0-9-_]/g, '_')\r\n    .replace(/_{2,}/g, '_')\r\n    .toLowerCase();\r\n\r\n  if (!/^[a-zA-Z]/.test(sanitized)) {\r\n    sanitized = 's_' + sanitized;\r\n  }\r\n\r\n  return sanitized;\r\n}\r\n","/**\r\n * Utility functions for working with MCP tool metadata\r\n */\r\n\r\nimport type { ToolInfo } from './types.js';\r\n\r\nexport interface ToolUiConfig {\r\n  resourceUri: string;\r\n  sessionId: string;\r\n}\r\n\r\n/**\r\n * Extract UI resource URI from tool metadata\r\n *\r\n * @param tool - The tool to extract UI config from\r\n * @returns The resource URI if available, undefined otherwise\r\n *\r\n * @example\r\n * const uri = getToolUiResourceUri(tool);\r\n * if (uri) {\r\n *   // Tool has UI configuration\r\n * }\r\n */\r\nexport function getToolUiResourceUri(tool: ToolInfo): string | undefined {\r\n  const meta = (tool as any)._meta;\r\n  if (!meta?.ui) return undefined;\r\n\r\n  const ui = meta.ui;\r\n  if (typeof ui !== \"object\" || !ui) return undefined;\r\n\r\n  // Check visibility filter - skip if explicitly hidden from app\r\n  if (ui.visibility && !ui.visibility.includes(\"app\")) return undefined;\r\n\r\n  // Support both 'uri' and 'resourceUri' field names for flexibility\r\n  return typeof ui.resourceUri === \"string\"\r\n    ? ui.resourceUri\r\n    : typeof ui.uri === \"string\"\r\n      ? ui.uri\r\n      : undefined;\r\n}\r\n\r\n/**\r\n * Find a tool by name within connections\r\n *\r\n * @param connections - Array of MCP connections\r\n * @param toolName - Name of the tool to find\r\n * @returns The tool if found, undefined otherwise\r\n *\r\n * @example\r\n * const tool = findToolByName(connections, \"get_weather\");\r\n */\r\nexport function findToolByName(\r\n  connections: Array<{ tools: ToolInfo[] }>,\r\n  toolName: string\r\n): ToolInfo | undefined {\r\n  for (const conn of connections) {\r\n    const tool = conn.tools.find((t) => t.name === toolName);\r\n    if (tool) return tool;\r\n  }\r\n  return undefined;\r\n}\r\n"]}

package/dist/shared/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/utils.ts","../../src/shared/tool-utils.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * Simple event emitter pattern for MCP connection events\r\n * Inspired by Cloudflare's agents pattern but adapted for serverless\r\n */\r\n\r\nexport type Disposable = {\r\n  dispose(): void;\r\n};\r\n\r\nexport type Event<T> = (listener: (event: T) => void) => Disposable;\r\n\r\n/**\r\n * Event emitter class for type-safe event handling\r\n * Similar to Cloudflare's Emitter but simplified for our use case\r\n */\r\nexport class Emitter<T> {\r\n  private listeners: Set<(event: T) => void> = new Set();\r\n\r\n  /**\r\n   * Subscribe to events\r\n   * @param listener - Callback function to handle events\r\n   * @returns Disposable to unsubscribe\r\n   */\r\n  get event(): Event<T> {\r\n    return (listener: (event: T) => void) => {\r\n      this.listeners.add(listener);\r\n      return {\r\n        dispose: () => {\r\n          this.listeners.delete(listener);\r\n        },\r\n      };\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Fire an event to all listeners\r\n   * @param event - Event data to emit\r\n   */\r\n  fire(event: T): void {\r\n    for (const listener of this.listeners) {\r\n      try {\r\n        listener(event);\r\n      } catch (error) {\r\n        console.error('[Emitter] Error in event listener:', error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clear all listeners\r\n   */\r\n  dispose(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Get number of active listeners\r\n   */\r\n  get listenerCount(): number {\r\n    return this.listeners.size;\r\n  }\r\n}\r\n\r\n/**\r\n * Connection state types matching your existing ConnectionStatus\r\n * Extended with more granular states for better observability\r\n */\r\nexport type McpConnectionState =\r\n  | 'DISCONNECTED'      // Not connected\r\n  | 'CONNECTING'        // Establishing transport connection to MCP server\r\n  | 'AUTHENTICATING'    // OAuth flow in progress\r\n  | 'AUTHENTICATED'     // OAuth complete, pre-connect\r\n  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)\r\n  | 'CONNECTED'         // Transport connection established\r\n  | 'READY'             // Fully connected and ready to use\r\n  | 'VALIDATING'        // Validating existing session\r\n  | 'RECONNECTING'      // Attempting to reconnect\r\n  | 'INITIALIZING'      // Initializing session or connection\r\n  | 'FAILED';           // Connection error at some point\r\n\r\n/**\r\n * MCP Connection Event Types\r\n * Discriminated union for type-safe event handling\r\n */\r\nexport type McpConnectionEvent =\r\n  | {\r\n    type: 'state_changed';\r\n    sessionId: string;\r\n    serverId: string;\r\n    serverName: string;\r\n    serverUrl: string;\r\n    createdAt?: number;\r\n    state: McpConnectionState;\r\n    previousState: McpConnectionState;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'tools_discovered';\r\n    sessionId: string;\r\n    serverId: string;\r\n    toolCount: number;\r\n    tools: any[];\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'auth_required';\r\n    sessionId: string;\r\n    serverId: string;\r\n    authUrl: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'error';\r\n    sessionId: string;\r\n    serverId: string;\r\n    error: string;\r\n    errorType: 'connection' | 'auth' | 'validation' | 'unknown';\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'disconnected';\r\n    sessionId: string;\r\n    serverId: string;\r\n    reason?: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'progress';\r\n    sessionId: string;\r\n    serverId: string;\r\n    message: string;\r\n    timestamp: number;\r\n  };\r\n\r\n/**\r\n * Event fired when a tool execution returns a UI resource URI\r\n */\r\nexport interface McpAppsUIEvent {\r\n  type: 'mcp-apps-ui';\r\n  sessionId: string;\r\n  resourceUri: string;\r\n  toolName: string;\r\n  result: unknown;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * Observability event for debugging and monitoring\r\n */\r\nexport interface McpObservabilityEvent {\r\n  type?: string;\r\n  level?: 'debug' | 'info' | 'warn' | 'error';\r\n  message?: string;\r\n  displayMessage?: string;\r\n  sessionId?: string;\r\n  serverId?: string;\r\n  payload?: Record<string, any>;\r\n  metadata?: Record<string, any>; // Kept for backward compatibility\r\n  timestamp: number;\r\n  id?: string;\r\n}\r\n\r\n/**\r\n * DisposableStore for managing multiple disposables\r\n * Useful for cleanup in React hooks\r\n */\r\nexport class DisposableStore {\r\n  private disposables: Set<Disposable> = new Set();\r\n\r\n  add(disposable: Disposable): void {\r\n    this.disposables.add(disposable);\r\n  }\r\n\r\n  dispose(): void {\r\n    for (const disposable of this.disposables) {\r\n      disposable.dispose();\r\n    }\r\n    this.disposables.clear();\r\n  }\r\n}\r\n","/**\r\n * Centralized constants for MCP Redis library\r\n * Eliminates magic numbers and enables consistent configuration\r\n */\r\n\r\n// Redis TTL and Session Management\r\nexport const SESSION_TTL_SECONDS = 43200; // 12 hours\r\nexport const STATE_EXPIRATION_MS = 10 * 60 * 1000; // 10 minutes for OAuth state\r\n\r\n// Heartbeat and Connection\r\nexport const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds\r\n\r\n// Redis Key Prefixes\r\nexport const REDIS_KEY_PREFIX = 'mcp:session:';\r\n\r\n// Token Management\r\nexport const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000; // 5 minute buffer before expiry\r\n\r\n// Client Information\r\nexport const DEFAULT_CLIENT_NAME = 'MCP Assistant';\r\nexport const DEFAULT_CLIENT_URI = 'https://mcp-assistant.in';\r\nexport const DEFAULT_LOGO_URI = 'https://mcp-assistant.in/logo.png';\r\nexport const DEFAULT_POLICY_URI = 'https://mcp-assistant.in/privacy';\r\nexport const SOFTWARE_ID = '@mcp-ts';\r\nexport const SOFTWARE_VERSION = '1.0.0-beta.5';\r\n\r\n// MCP Client Configuration\r\nexport const MCP_CLIENT_NAME = 'mcp-ts-oauth-client';\r\nexport const MCP_CLIENT_VERSION = '2.0';\r\n","/**\r\n * Standardized error classes for MCP Redis library\r\n * Provides consistent error handling across the codebase\r\n */\r\n\r\n/**\r\n * Base error class for all MCP-related errors\r\n */\r\nexport class McpError extends Error {\r\n    constructor(\r\n        public readonly code: string,\r\n        message: string,\r\n        public readonly cause?: Error\r\n    ) {\r\n        super(message);\r\n        this.name = 'McpError';\r\n        // Maintain proper prototype chain for instanceof checks\r\n        Object.setPrototypeOf(this, new.target.prototype);\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            ...(this.cause ? { cause: this.cause.message } : {}),\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth authorization is required\r\n */\r\nexport class UnauthorizedError extends McpError {\r\n    constructor(message: string = 'OAuth authorization required', cause?: Error) {\r\n        super('UNAUTHORIZED', message, cause);\r\n        this.name = 'UnauthorizedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when connection to MCP server fails\r\n */\r\nexport class ConnectionError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONNECTION_ERROR', message, cause);\r\n        this.name = 'ConnectionError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session is not found or expired\r\n */\r\nexport class SessionNotFoundError extends McpError {\r\n    constructor(sessionId: string, cause?: Error) {\r\n        super('SESSION_NOT_FOUND', `Session not found: ${sessionId}`, cause);\r\n        this.name = 'SessionNotFoundError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session validation fails\r\n */\r\nexport class SessionValidationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('SESSION_VALIDATION_ERROR', message, cause);\r\n        this.name = 'SessionValidationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when authentication fails\r\n */\r\nexport class AuthenticationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('AUTH_ERROR', message, cause);\r\n        this.name = 'AuthenticationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth state validation fails\r\n */\r\nexport class InvalidStateError extends McpError {\r\n    constructor(message: string = 'Invalid OAuth state', cause?: Error) {\r\n        super('INVALID_STATE', message, cause);\r\n        this.name = 'InvalidStateError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when client is not connected\r\n */\r\nexport class NotConnectedError extends McpError {\r\n    constructor(message: string = 'Not connected to server', cause?: Error) {\r\n        super('NOT_CONNECTED', message, cause);\r\n        this.name = 'NotConnectedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when required configuration is missing\r\n */\r\nexport class ConfigurationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONFIGURATION_ERROR', message, cause);\r\n        this.name = 'ConfigurationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when tool execution fails\r\n */\r\nexport class ToolExecutionError extends McpError {\r\n    constructor(toolName: string, message: string, cause?: Error) {\r\n        super('TOOL_EXECUTION_ERROR', `Tool '${toolName}' failed: ${message}`, cause);\r\n        this.name = 'ToolExecutionError';\r\n    }\r\n}\r\n\r\n/**\r\n * RPC error codes for SSE communication\r\n */\r\nexport const RpcErrorCodes = {\r\n    EXECUTION_ERROR: 'EXECUTION_ERROR',\r\n    MISSING_IDENTITY: 'MISSING_IDENTITY',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    NO_CONNECTION: 'NO_CONNECTION',\r\n    UNKNOWN_METHOD: 'UNKNOWN_METHOD',\r\n    INVALID_PARAMS: 'INVALID_PARAMS',\r\n} as const;\r\n\r\nexport type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];\r\n","/**\r\n * Type definitions for MCP operations\r\n */\r\n\r\nimport { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\r\n\r\n// Connect API types\r\nexport interface ConnectRequest {\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n}\r\n\r\nexport interface ConnectSuccessResponse {\r\n  success: true;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectAuthRequiredResponse {\r\n  requiresAuth: true;\r\n  authUrl: string;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ConnectResponse =\r\n  | ConnectSuccessResponse\r\n  | ConnectAuthRequiredResponse\r\n  | ConnectErrorResponse;\r\n\r\n// Callback API types\r\nexport interface CallbackSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface CallbackErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallbackResponse = CallbackSuccessResponse | CallbackErrorResponse;\r\n\r\n// Disconnect API types\r\nexport interface DisconnectRequest {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface DisconnectSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface DisconnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type DisconnectResponse =\r\n  | DisconnectSuccessResponse\r\n  | DisconnectErrorResponse;\r\n\r\n// List Tools API types\r\nexport interface ListToolsSuccessResponse {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListToolsErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ListToolsResponse =\r\n  | ListToolsSuccessResponse\r\n  | ListToolsErrorResponse;\r\n\r\n// Call Tool API types\r\nexport interface CallToolRequest {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface CallToolSuccessResponse {\r\n  content: Array<{\r\n    type: string;\r\n    text?: string;\r\n    [key: string]: unknown;\r\n  }>;\r\n  isError: boolean;\r\n}\r\n\r\nexport interface CallToolErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallToolResponse =\r\n  | CallToolSuccessResponse\r\n  | CallToolErrorResponse;\r\n\r\n// Helper type guards\r\nexport function isConnectSuccess(\r\n  response: ConnectResponse\r\n): response is ConnectSuccessResponse {\r\n  return 'success' in response && response.success === true;\r\n}\r\n\r\nexport function isConnectAuthRequired(\r\n  response: ConnectResponse\r\n): response is ConnectAuthRequiredResponse {\r\n  return 'requiresAuth' in response && response.requiresAuth === true;\r\n}\r\n\r\nexport function isConnectError(\r\n  response: ConnectResponse\r\n): response is ConnectErrorResponse {\r\n  return 'error' in response;\r\n}\r\n\r\nexport function isListToolsSuccess(\r\n  response: ListToolsResponse\r\n): response is ListToolsSuccessResponse {\r\n  return 'tools' in response;\r\n}\r\n\r\nexport function isCallToolSuccess(\r\n  response: CallToolResponse\r\n): response is CallToolSuccessResponse {\r\n  return 'content' in response;\r\n}\r\n\r\n// Generic tool info type\r\nexport type ToolInfo = {\r\n  name: string;\r\n  description?: string;\r\n  inputSchema?: unknown;\r\n};\r\n\r\n// Transport type\r\nexport type TransportType = 'sse' | 'streamable_http';\r\n\r\n// SSE/RPC types\r\nexport type McpRpcMethod =\r\n  | 'connect'\r\n  | 'disconnect'\r\n  | 'listTools'\r\n  | 'callTool'\r\n  | 'getSessions'\r\n  | 'restoreSession'\r\n  | 'finishAuth'\r\n  | 'listPrompts'\r\n  | 'getPrompt'\r\n  | 'listResources'\r\n  | 'readResource';\r\n\r\nexport interface McpRpcRequest {\r\n  id: string;\r\n  method: McpRpcMethod;\r\n  params?: McpRpcParams;\r\n}\r\n\r\nexport interface McpRpcResponse<T = unknown> {\r\n  id: string;\r\n  result?: T;\r\n  error?: {\r\n    code: string;\r\n    message: string;\r\n  };\r\n}\r\n\r\n// RPC Parameter Types\r\nexport interface ConnectParams {\r\n  serverId?: string; // Optional - generated server-side if not provided\r\n  serverName: string;\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n  transportType?: TransportType;\r\n}\r\n\r\nexport interface DisconnectParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface SessionParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface CallToolParams {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface GetPromptParams {\r\n  sessionId: string;\r\n  name: string;\r\n  args?: Record<string, string>;\r\n}\r\n\r\nexport interface ReadResourceParams {\r\n  sessionId: string;\r\n  uri: string;\r\n}\r\n\r\nexport interface FinishAuthParams {\r\n  sessionId: string;\r\n  code: string;\r\n}\r\n\r\nexport type McpRpcParams =\r\n  | ConnectParams\r\n  | DisconnectParams\r\n  | SessionParams\r\n  | CallToolParams\r\n  | GetPromptParams\r\n  | ReadResourceParams\r\n  | FinishAuthParams\r\n  | undefined;\r\n\r\n// RPC Result Types\r\nexport interface SessionInfo {\r\n  sessionId: string;\r\n  serverId?: string;\r\n  serverName?: string;\r\n  serverUrl: string;\r\n  transport: TransportType;\r\n  createdAt: number;\r\n}\r\n\r\nexport interface SessionListResult {\r\n  sessions: SessionInfo[];\r\n}\r\n\r\nexport interface ConnectResult {\r\n  sessionId: string;\r\n  success: boolean;\r\n}\r\n\r\nexport interface DisconnectResult {\r\n  success: boolean;\r\n}\r\n\r\nexport interface RestoreSessionResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface FinishAuthResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface ListToolsRpcResult {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListPromptsResult {\r\n  prompts: Array<{\r\n    name: string;\r\n    description?: string;\r\n    arguments?: Array<{\r\n      name: string;\r\n      description?: string;\r\n      required?: boolean;\r\n    }>;\r\n  }>;\r\n}\r\n\r\nexport interface ListResourcesResult {\r\n  resources: Array<{\r\n    uri: string;\r\n    name: string;\r\n    description?: string;\r\n    mimeType?: string;\r\n  }>;\r\n}\r\n\r\nexport type { CallToolResult };\r\n","/**\r\n * Sanitize server name to create a valid server label\r\n * Must start with a letter and contain only letters, digits, '-' and '_'\r\n */\r\nexport function sanitizeServerLabel(name: string): string {\r\n  let sanitized = name\r\n    .replace(/[^a-zA-Z0-9-_]/g, '_')\r\n    .replace(/_{2,}/g, '_')\r\n    .toLowerCase();\r\n\r\n  if (!/^[a-zA-Z]/.test(sanitized)) {\r\n    sanitized = 's_' + sanitized;\r\n  }\r\n\r\n  return sanitized;\r\n}\r\n","/**\r\n * Utility functions for working with MCP tool metadata\r\n */\r\n\r\nimport type { ToolInfo } from './types.js';\r\n\r\nexport interface ToolUiConfig {\r\n  resourceUri: string;\r\n  sessionId: string;\r\n}\r\n\r\n/**\r\n * Extract UI resource URI from tool metadata\r\n *\r\n * @param tool - The tool to extract UI config from\r\n * @returns The resource URI if available, undefined otherwise\r\n *\r\n * @example\r\n * const uri = getToolUiResourceUri(tool);\r\n * if (uri) {\r\n *   // Tool has UI configuration\r\n * }\r\n */\r\nexport function getToolUiResourceUri(tool: ToolInfo): string | undefined {\r\n  const meta = (tool as any)._meta;\r\n  if (!meta?.ui) return undefined;\r\n\r\n  const ui = meta.ui;\r\n  if (typeof ui !== \"object\" || !ui) return undefined;\r\n\r\n  // Check visibility filter - skip if explicitly hidden from app\r\n  if (ui.visibility && !ui.visibility.includes(\"app\")) return undefined;\r\n\r\n  // Support both 'uri' and 'resourceUri' field names for flexibility\r\n  return typeof ui.resourceUri === \"string\"\r\n    ? ui.resourceUri\r\n    : typeof ui.uri === \"string\"\r\n      ? ui.uri\r\n      : undefined;\r\n}\r\n\r\n/**\r\n * Find a tool by name within connections\r\n *\r\n * @param connections - Array of MCP connections\r\n * @param toolName - Name of the tool to find\r\n * @returns The tool if found, undefined otherwise\r\n *\r\n * @example\r\n * const tool = findToolByName(connections, \"get_weather\");\r\n */\r\nexport function findToolByName(\r\n  connections: Array<{ tools: ToolInfo[] }>,\r\n  toolName: string\r\n): ToolInfo | undefined {\r\n  for (const conn of connections) {\r\n    const tool = conn.tools.find((t) => t.name === toolName);\r\n    if (tool) return tool;\r\n  }\r\n  return undefined;\r\n}\r\n"]}
+{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/utils.ts","../../src/shared/tool-utils.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\r\n * Simple event emitter pattern for MCP connection events\r\n * Inspired by Cloudflare's agents pattern but adapted for serverless\r\n */\r\n\r\nexport type Disposable = {\r\n  dispose(): void;\r\n};\r\n\r\nexport type Event<T> = (listener: (event: T) => void) => Disposable;\r\n\r\n/**\r\n * Event emitter class for type-safe event handling\r\n * Similar to Cloudflare's Emitter but simplified for our use case\r\n */\r\nexport class Emitter<T> {\r\n  private listeners: Set<(event: T) => void> = new Set();\r\n\r\n  /**\r\n   * Subscribe to events\r\n   * @param listener - Callback function to handle events\r\n   * @returns Disposable to unsubscribe\r\n   */\r\n  get event(): Event<T> {\r\n    return (listener: (event: T) => void) => {\r\n      this.listeners.add(listener);\r\n      return {\r\n        dispose: () => {\r\n          this.listeners.delete(listener);\r\n        },\r\n      };\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Fire an event to all listeners\r\n   * @param event - Event data to emit\r\n   */\r\n  fire(event: T): void {\r\n    for (const listener of this.listeners) {\r\n      try {\r\n        listener(event);\r\n      } catch (error) {\r\n        console.error('[Emitter] Error in event listener:', error);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Clear all listeners\r\n   */\r\n  dispose(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Get number of active listeners\r\n   */\r\n  get listenerCount(): number {\r\n    return this.listeners.size;\r\n  }\r\n}\r\n\r\n/**\r\n * Connection state types matching your existing ConnectionStatus\r\n * Extended with more granular states for better observability\r\n */\r\nexport type McpConnectionState =\r\n  | 'DISCONNECTED'      // Not connected\r\n  | 'CONNECTING'        // Establishing transport connection to MCP server\r\n  | 'AUTHENTICATING'    // OAuth flow in progress\r\n  | 'AUTHENTICATED'     // OAuth complete, pre-connect\r\n  | 'DISCOVERING'       // Discovering server capabilities (tools, resources, prompts)\r\n  | 'CONNECTED'         // Transport connection established\r\n  | 'READY'             // Fully connected and ready to use\r\n  | 'VALIDATING'        // Validating existing session\r\n  | 'RECONNECTING'      // Attempting to reconnect\r\n  | 'INITIALIZING'      // Initializing session or connection\r\n  | 'FAILED';           // Connection error at some point\r\n\r\n/**\r\n * MCP Connection Event Types\r\n * Discriminated union for type-safe event handling\r\n */\r\nexport type McpConnectionEvent =\r\n  | {\r\n    type: 'state_changed';\r\n    sessionId: string;\r\n    serverId: string;\r\n    serverName: string;\r\n    serverUrl: string;\r\n    createdAt?: number;\r\n    state: McpConnectionState;\r\n    previousState: McpConnectionState;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'tools_discovered';\r\n    sessionId: string;\r\n    serverId: string;\r\n    toolCount: number;\r\n    tools: any[];\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'auth_required';\r\n    sessionId: string;\r\n    serverId: string;\r\n    authUrl: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'error';\r\n    sessionId: string;\r\n    serverId: string;\r\n    error: string;\r\n    errorType: 'connection' | 'auth' | 'validation' | 'unknown';\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'disconnected';\r\n    sessionId: string;\r\n    serverId: string;\r\n    reason?: string;\r\n    timestamp: number;\r\n  }\r\n  | {\r\n    type: 'progress';\r\n    sessionId: string;\r\n    serverId: string;\r\n    message: string;\r\n    timestamp: number;\r\n  };\r\n\r\n/**\r\n * Event fired when a tool execution returns a UI resource URI\r\n */\r\nexport interface McpAppsUIEvent {\r\n  type: 'mcp-apps-ui';\r\n  sessionId: string;\r\n  resourceUri: string;\r\n  toolName: string;\r\n  result: unknown;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * Observability event for debugging and monitoring\r\n */\r\nexport interface McpObservabilityEvent {\r\n  type?: string;\r\n  level?: 'debug' | 'info' | 'warn' | 'error';\r\n  message?: string;\r\n  displayMessage?: string;\r\n  sessionId?: string;\r\n  serverId?: string;\r\n  payload?: Record<string, any>;\r\n  metadata?: Record<string, any>; // Kept for backward compatibility\r\n  timestamp: number;\r\n  id?: string;\r\n}\r\n\r\n/**\r\n * DisposableStore for managing multiple disposables\r\n * Useful for cleanup in React hooks\r\n */\r\nexport class DisposableStore {\r\n  private disposables: Set<Disposable> = new Set();\r\n\r\n  add(disposable: Disposable): void {\r\n    this.disposables.add(disposable);\r\n  }\r\n\r\n  dispose(): void {\r\n    for (const disposable of this.disposables) {\r\n      disposable.dispose();\r\n    }\r\n    this.disposables.clear();\r\n  }\r\n}\r\n","/**\r\n * Centralized constants for MCP Redis library\r\n * Eliminates magic numbers and enables consistent configuration\r\n */\r\n\r\n// Redis TTL and Session Management\r\nexport const SESSION_TTL_SECONDS = 43200; // 12 hours\r\nexport const STATE_EXPIRATION_MS = 10 * 60 * 1000; // 10 minutes for OAuth state\r\n\r\n// Heartbeat and Connection\r\nexport const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000; // 30 seconds\r\n\r\n// Redis Key Prefixes\r\nexport const REDIS_KEY_PREFIX = 'mcp:session:';\r\n\r\n// Token Management\r\nexport const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000; // 5 minute buffer before expiry\r\n\r\n// Client Information\r\nexport const DEFAULT_CLIENT_NAME = 'MCP Assistant';\r\nexport const DEFAULT_CLIENT_URI = 'https://mcp-assistant.in';\r\nexport const DEFAULT_LOGO_URI = 'https://mcp-assistant.in/logo.png';\r\nexport const DEFAULT_POLICY_URI = 'https://mcp-assistant.in/privacy';\r\nexport const SOFTWARE_ID = '@mcp-ts';\r\nexport const SOFTWARE_VERSION = '1.0.0-beta.5';\r\n\r\n// MCP Client Configuration\r\nexport const MCP_CLIENT_NAME = 'mcp-ts-oauth-client';\r\nexport const MCP_CLIENT_VERSION = '2.0';\r\n","/**\r\n * Standardized error classes for MCP Redis library\r\n * Provides consistent error handling across the codebase\r\n */\r\n\r\n/**\r\n * Base error class for all MCP-related errors\r\n */\r\nexport class McpError extends Error {\r\n    constructor(\r\n        public readonly code: string,\r\n        message: string,\r\n        public readonly cause?: Error\r\n    ) {\r\n        super(message);\r\n        this.name = 'McpError';\r\n        // Maintain proper prototype chain for instanceof checks\r\n        Object.setPrototypeOf(this, new.target.prototype);\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            ...(this.cause ? { cause: this.cause.message } : {}),\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth authorization is required\r\n */\r\nexport class UnauthorizedError extends McpError {\r\n    constructor(message: string = 'OAuth authorization required', cause?: Error) {\r\n        super('UNAUTHORIZED', message, cause);\r\n        this.name = 'UnauthorizedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when connection to MCP server fails\r\n */\r\nexport class ConnectionError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONNECTION_ERROR', message, cause);\r\n        this.name = 'ConnectionError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session is not found or expired\r\n */\r\nexport class SessionNotFoundError extends McpError {\r\n    constructor(sessionId: string, cause?: Error) {\r\n        super('SESSION_NOT_FOUND', `Session not found: ${sessionId}`, cause);\r\n        this.name = 'SessionNotFoundError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when session validation fails\r\n */\r\nexport class SessionValidationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('SESSION_VALIDATION_ERROR', message, cause);\r\n        this.name = 'SessionValidationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when authentication fails\r\n */\r\nexport class AuthenticationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('AUTH_ERROR', message, cause);\r\n        this.name = 'AuthenticationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when OAuth state validation fails\r\n */\r\nexport class InvalidStateError extends McpError {\r\n    constructor(message: string = 'Invalid OAuth state', cause?: Error) {\r\n        super('INVALID_STATE', message, cause);\r\n        this.name = 'InvalidStateError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when client is not connected\r\n */\r\nexport class NotConnectedError extends McpError {\r\n    constructor(message: string = 'Not connected to server', cause?: Error) {\r\n        super('NOT_CONNECTED', message, cause);\r\n        this.name = 'NotConnectedError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when required configuration is missing\r\n */\r\nexport class ConfigurationError extends McpError {\r\n    constructor(message: string, cause?: Error) {\r\n        super('CONFIGURATION_ERROR', message, cause);\r\n        this.name = 'ConfigurationError';\r\n    }\r\n}\r\n\r\n/**\r\n * Thrown when tool execution fails\r\n */\r\nexport class ToolExecutionError extends McpError {\r\n    constructor(toolName: string, message: string, cause?: Error) {\r\n        super('TOOL_EXECUTION_ERROR', `Tool '${toolName}' failed: ${message}`, cause);\r\n        this.name = 'ToolExecutionError';\r\n    }\r\n}\r\n\r\n/**\r\n * RPC error codes for SSE communication\r\n */\r\nexport const RpcErrorCodes = {\r\n    EXECUTION_ERROR: 'EXECUTION_ERROR',\r\n    MISSING_IDENTITY: 'MISSING_IDENTITY',\r\n    UNAUTHORIZED: 'UNAUTHORIZED',\r\n    NO_CONNECTION: 'NO_CONNECTION',\r\n    UNKNOWN_METHOD: 'UNKNOWN_METHOD',\r\n    INVALID_PARAMS: 'INVALID_PARAMS',\r\n} as const;\r\n\r\nexport type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];\r\n","/**\r\n * Type definitions for MCP operations\r\n */\r\n\r\nimport { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';\r\n\r\n// Connect API types\r\nexport interface ConnectRequest {\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n}\r\n\r\nexport interface ConnectSuccessResponse {\r\n  success: true;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectAuthRequiredResponse {\r\n  requiresAuth: true;\r\n  authUrl: string;\r\n  sessionId: string;\r\n}\r\n\r\nexport interface ConnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ConnectResponse =\r\n  | ConnectSuccessResponse\r\n  | ConnectAuthRequiredResponse\r\n  | ConnectErrorResponse;\r\n\r\n// Callback API types\r\nexport interface CallbackSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface CallbackErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallbackResponse = CallbackSuccessResponse | CallbackErrorResponse;\r\n\r\n// Disconnect API types\r\nexport interface DisconnectRequest {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface DisconnectSuccessResponse {\r\n  success: true;\r\n  message: string;\r\n}\r\n\r\nexport interface DisconnectErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type DisconnectResponse =\r\n  | DisconnectSuccessResponse\r\n  | DisconnectErrorResponse;\r\n\r\n// List Tools API types\r\nexport interface ListToolsSuccessResponse {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListToolsErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type ListToolsResponse =\r\n  | ListToolsSuccessResponse\r\n  | ListToolsErrorResponse;\r\n\r\n// Call Tool API types\r\nexport interface CallToolRequest {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface CallToolSuccessResponse {\r\n  content: Array<{\r\n    type: string;\r\n    text?: string;\r\n    [key: string]: unknown;\r\n  }>;\r\n  isError: boolean;\r\n}\r\n\r\nexport interface CallToolErrorResponse {\r\n  error: string;\r\n}\r\n\r\nexport type CallToolResponse =\r\n  | CallToolSuccessResponse\r\n  | CallToolErrorResponse;\r\n\r\n// Helper type guards\r\nexport function isConnectSuccess(\r\n  response: ConnectResponse\r\n): response is ConnectSuccessResponse {\r\n  return 'success' in response && response.success === true;\r\n}\r\n\r\nexport function isConnectAuthRequired(\r\n  response: ConnectResponse\r\n): response is ConnectAuthRequiredResponse {\r\n  return 'requiresAuth' in response && response.requiresAuth === true;\r\n}\r\n\r\nexport function isConnectError(\r\n  response: ConnectResponse\r\n): response is ConnectErrorResponse {\r\n  return 'error' in response;\r\n}\r\n\r\nexport function isListToolsSuccess(\r\n  response: ListToolsResponse\r\n): response is ListToolsSuccessResponse {\r\n  return 'tools' in response;\r\n}\r\n\r\nexport function isCallToolSuccess(\r\n  response: CallToolResponse\r\n): response is CallToolSuccessResponse {\r\n  return 'content' in response;\r\n}\r\n\r\n// Generic tool info type\r\nexport type ToolInfo = {\r\n  name: string;\r\n  description?: string;\r\n  inputSchema?: unknown;\r\n};\r\n\r\n// Transport type\r\nexport type TransportType = 'sse' | 'streamable_http';\r\n\r\n// SSE/RPC types\r\nexport type McpRpcMethod =\r\n  | 'connect'\r\n  | 'disconnect'\r\n  | 'listTools'\r\n  | 'callTool'\r\n  | 'getSessions'\r\n  | 'restoreSession'\r\n  | 'finishAuth'\r\n  | 'listPrompts'\r\n  | 'getPrompt'\r\n  | 'listResources'\r\n  | 'readResource';\r\n\r\nexport interface McpRpcRequest {\r\n  id: string;\r\n  method: McpRpcMethod;\r\n  params?: McpRpcParams;\r\n}\r\n\r\nexport interface McpRpcResponse<T = unknown> {\r\n  id: string;\r\n  result?: T;\r\n  error?: {\r\n    code: string;\r\n    message: string;\r\n  };\r\n}\r\n\r\n// RPC Parameter Types\r\nexport interface ConnectParams {\r\n  serverId?: string; // Optional - generated server-side if not provided\r\n  serverName: string;\r\n  serverUrl: string;\r\n  callbackUrl: string;\r\n  transportType?: TransportType;\r\n}\r\n\r\nexport interface DisconnectParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface SessionParams {\r\n  sessionId: string;\r\n}\r\n\r\nexport interface CallToolParams {\r\n  sessionId: string;\r\n  toolName: string;\r\n  toolArgs: Record<string, unknown>;\r\n}\r\n\r\nexport interface GetPromptParams {\r\n  sessionId: string;\r\n  name: string;\r\n  args?: Record<string, string>;\r\n}\r\n\r\nexport interface ReadResourceParams {\r\n  sessionId: string;\r\n  uri: string;\r\n}\r\n\r\nexport interface FinishAuthParams {\r\n  sessionId: string;\r\n  code: string;\r\n}\r\n\r\nexport type McpRpcParams =\r\n  | ConnectParams\r\n  | DisconnectParams\r\n  | SessionParams\r\n  | CallToolParams\r\n  | GetPromptParams\r\n  | ReadResourceParams\r\n  | FinishAuthParams\r\n  | undefined;\r\n\r\n// RPC Result Types\r\nexport interface SessionInfo {\r\n  sessionId: string;\r\n  serverId?: string;\r\n  serverName?: string;\r\n  serverUrl: string;\r\n  transport: TransportType;\r\n  createdAt: number;\r\n  /**\r\n   * Session readiness for auto-restore.\r\n   * false means auth is pending and should be resumed explicitly by user action.\r\n   */\r\n  active?: boolean;\r\n}\r\n\r\nexport interface SessionListResult {\r\n  sessions: SessionInfo[];\r\n}\r\n\r\nexport interface ConnectResult {\r\n  sessionId: string;\r\n  success: boolean;\r\n}\r\n\r\nexport interface DisconnectResult {\r\n  success: boolean;\r\n}\r\n\r\nexport interface RestoreSessionResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface FinishAuthResult {\r\n  success: boolean;\r\n  toolCount: number;\r\n}\r\n\r\nexport interface ListToolsRpcResult {\r\n  tools: Tool[];\r\n}\r\n\r\nexport interface ListPromptsResult {\r\n  prompts: Array<{\r\n    name: string;\r\n    description?: string;\r\n    arguments?: Array<{\r\n      name: string;\r\n      description?: string;\r\n      required?: boolean;\r\n    }>;\r\n  }>;\r\n}\r\n\r\nexport interface ListResourcesResult {\r\n  resources: Array<{\r\n    uri: string;\r\n    name: string;\r\n    description?: string;\r\n    mimeType?: string;\r\n  }>;\r\n}\r\n\r\nexport type { CallToolResult };\r\n","/**\r\n * Sanitize server name to create a valid server label\r\n * Must start with a letter and contain only letters, digits, '-' and '_'\r\n */\r\nexport function sanitizeServerLabel(name: string): string {\r\n  let sanitized = name\r\n    .replace(/[^a-zA-Z0-9-_]/g, '_')\r\n    .replace(/_{2,}/g, '_')\r\n    .toLowerCase();\r\n\r\n  if (!/^[a-zA-Z]/.test(sanitized)) {\r\n    sanitized = 's_' + sanitized;\r\n  }\r\n\r\n  return sanitized;\r\n}\r\n","/**\r\n * Utility functions for working with MCP tool metadata\r\n */\r\n\r\nimport type { ToolInfo } from './types.js';\r\n\r\nexport interface ToolUiConfig {\r\n  resourceUri: string;\r\n  sessionId: string;\r\n}\r\n\r\n/**\r\n * Extract UI resource URI from tool metadata\r\n *\r\n * @param tool - The tool to extract UI config from\r\n * @returns The resource URI if available, undefined otherwise\r\n *\r\n * @example\r\n * const uri = getToolUiResourceUri(tool);\r\n * if (uri) {\r\n *   // Tool has UI configuration\r\n * }\r\n */\r\nexport function getToolUiResourceUri(tool: ToolInfo): string | undefined {\r\n  const meta = (tool as any)._meta;\r\n  if (!meta?.ui) return undefined;\r\n\r\n  const ui = meta.ui;\r\n  if (typeof ui !== \"object\" || !ui) return undefined;\r\n\r\n  // Check visibility filter - skip if explicitly hidden from app\r\n  if (ui.visibility && !ui.visibility.includes(\"app\")) return undefined;\r\n\r\n  // Support both 'uri' and 'resourceUri' field names for flexibility\r\n  return typeof ui.resourceUri === \"string\"\r\n    ? ui.resourceUri\r\n    : typeof ui.uri === \"string\"\r\n      ? ui.uri\r\n      : undefined;\r\n}\r\n\r\n/**\r\n * Find a tool by name within connections\r\n *\r\n * @param connections - Array of MCP connections\r\n * @param toolName - Name of the tool to find\r\n * @returns The tool if found, undefined otherwise\r\n *\r\n * @example\r\n * const tool = findToolByName(connections, \"get_weather\");\r\n */\r\nexport function findToolByName(\r\n  connections: Array<{ tools: ToolInfo[] }>,\r\n  toolName: string\r\n): ToolInfo | undefined {\r\n  for (const conn of connections) {\r\n    const tool = conn.tools.find((t) => t.name === toolName);\r\n    if (tool) return tool;\r\n  }\r\n  return undefined;\r\n}\r\n"]}

package/dist/{types-PjM1W07s.d.mts → types-CW6lghof.d.mts}

@@ -109,6 +109,11 @@ interface SessionInfo {
     serverUrl: string;
     transport: TransportType;
     createdAt: number;
+    /**
+     * Session readiness for auto-restore.
+     * false means auth is pending and should be resumed explicitly by user action.
+     */
+    active?: boolean;
 }
 interface SessionListResult {
     sessions: SessionInfo[];

package/dist/{types-PjM1W07s.d.ts → types-CW6lghof.d.ts}

@@ -109,6 +109,11 @@ interface SessionInfo {
     serverUrl: string;
     transport: TransportType;
     createdAt: number;
+    /**
+     * Session readiness for auto-restore.
+     * false means auth is pending and should be resumed explicitly by user action.
+     */
+    active?: boolean;
 }
 interface SessionListResult {
     sessions: SessionInfo[];

package/package.json

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