@mcp-ts/sdk 1.0.0 → 1.1.0

package/dist/shared/index.d.mts

@@ -1,6 +1,6 @@
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-BP6WyRNh.mjs';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-BgeztGYZ.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';
-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, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-SbDlA2VX.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, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CLccx9wW.mjs';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**

package/dist/shared/index.d.ts

@@ -1,6 +1,6 @@
-export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-BP6WyRNh.js';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-BgeztGYZ.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';
-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, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-SbDlA2VX.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, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from '../types-CLccx9wW.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"],"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    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 * 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 } 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;\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}\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\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"]}
+{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/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    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}\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"]}

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"],"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    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 * 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 } 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;\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}\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\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"]}
+{"version":3,"sources":["../../src/shared/events.ts","../../src/shared/constants.ts","../../src/shared/errors.ts","../../src/shared/types.ts","../../src/shared/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    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}\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"]}

package/dist/{types-SbDlA2VX.d.mts → types-CLccx9wW.d.mts}

@@ -71,7 +71,7 @@ interface McpRpcResponse<T = unknown> {
     };
 }
 interface ConnectParams {
-    serverId: string;
+    serverId?: string;
     serverName: string;
     serverUrl: string;
     callbackUrl: string;

package/dist/{types-SbDlA2VX.d.ts → types-CLccx9wW.d.ts}

@@ -71,7 +71,7 @@ interface McpRpcResponse<T = unknown> {
     };
 }
 interface ConnectParams {
-    serverId: string;
+    serverId?: string;
     serverName: string;
     serverUrl: string;
     callbackUrl: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-ts/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -107,6 +107,7 @@
     "@ag-ui/client": ">=0.0.40",
     "@langchain/core": "^0.3.0",
     "ai": "^6.0.0",
+    "better-sqlite3": "^12.0.0",
     "ioredis": "^5.0.0",
     "react": ">=18.0.0",
     "rxjs": ">=7.0.0",
@@ -133,9 +134,13 @@
     },
     "rxjs": {
       "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
     }
   },
   "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.25.3",
     "json-schema": "^0.4.0",
     "json-schema-to-zod": "^2.7.0",
@@ -145,10 +150,12 @@
     "@ag-ui/client": "^0.0.42",
     "@langchain/core": "^0.3.33",
     "@playwright/test": "^1.58.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.0.10",
     "@types/react": "^18.3.18",
     "ai": "^6.0.49",
+    "better-sqlite3": "^12.6.2",
     "ioredis": "^5.9.2",
     "ioredis-mock": "^8.13.1",
     "playwright": "^1.58.0",

package/src/adapters/agui-adapter.ts

@@ -8,7 +8,7 @@
  * @example
  * ```typescript
  * import { MultiSessionClient } from '@mcp-ts/sdk/server';
- * import { AguiAdapter } from '@mcp-ts/sdk/adapters/mcp-adapter';
+ * import { AguiAdapter } from '@mcp-ts/sdk/adapters/agui-adapter';
  * import { createMcpMiddleware } from '@mcp-ts/sdk/adapters/agui-middleware';
  * import { HttpAgent } from '@ag-ui/client';
  *
@@ -22,13 +22,71 @@
  *
  * // Use with AG-UI middleware
  * const agent = new HttpAgent({ url: 'http://localhost:8000/agent' });
- * agent.use(createMcpMiddleware(mcpClient, { tools }));
+ * agent.use(createMcpMiddleware({ tools }));
  * ```
  */
 
 import { MCPClient } from '../server/mcp/oauth-client.js';
 import { MultiSessionClient } from '../server/mcp/multi-session-client.js';
 
+/**
+ * Extended JSON Schema properties that Pydantic's strict validation rejects.
+ * These are valid JSON Schema extensions but not part of the core spec.
+ */
+const PYDANTIC_FORBIDDEN_PROPS = [
+    // JSON Schema meta-properties
+    '$schema', '$id', '$comment', '$defs', 'definitions',
+    // Extended properties used by some MCP servers (e.g., Apify)
+    'prefill', 'examples', 'enumTitles', 'enumDescriptions',
+    // Other common extensions
+    'deprecated', 'readOnly', 'writeOnly', 'contentMediaType', 'contentEncoding',
+];
+
+/**
+ * Cleans a JSON Schema by removing meta-properties that cause issues with
+ * strict Pydantic validation (e.g., Google ADK, LangGraph).
+ *
+ * @param schema - The JSON Schema to clean
+ * @returns Cleaned schema without forbidden properties
+ */
+export function cleanSchema(schema: Record<string, any> | undefined): Record<string, any> {
+    if (!schema) {
+        return { type: 'object', properties: {} };
+    }
+
+    const cleaned = { ...schema };
+
+    // Remove all forbidden properties
+    for (const prop of PYDANTIC_FORBIDDEN_PROPS) {
+        delete cleaned[prop];
+    }
+
+    // Recursively clean nested properties
+    if (cleaned.properties && typeof cleaned.properties === 'object') {
+        const cleanedProps: Record<string, any> = {};
+        for (const [key, value] of Object.entries(cleaned.properties)) {
+            if (typeof value === 'object' && value !== null) {
+                cleanedProps[key] = cleanSchema(value as Record<string, any>);
+            } else {
+                cleanedProps[key] = value;
+            }
+        }
+        cleaned.properties = cleanedProps;
+    }
+
+    // Clean items if it's an array schema
+    if (cleaned.items && typeof cleaned.items === 'object') {
+        cleaned.items = cleanSchema(cleaned.items);
+    }
+
+    // Clean additionalProperties if it's an object schema
+    if (cleaned.additionalProperties && typeof cleaned.additionalProperties === 'object') {
+        cleaned.additionalProperties = cleanSchema(cleaned.additionalProperties);
+    }
+
+    return cleaned;
+}
+
 /**
  * Configuration options for AguiAdapter
  */
@@ -42,43 +100,27 @@ export interface AguiAdapterOptions {
 
 /**
  * AG-UI Tool with handler for server-side execution.
- *
- * Tools contain:
- * - `name`: Unique identifier (prefixed with server ID)
- * - `description`: Human-readable description for the LLM
- * - `parameters`: JSON Schema defining the input format
- * - `handler`: Function that executes the tool via MCP client
  */
 export interface AguiTool {
-    /** Unique tool name (e.g., "server-abc_get_weather") */
     name: string;
-    /** Human-readable description for the LLM */
     description: string;
-    /** JSON Schema format parameters */
     parameters?: Record<string, any>;
-    /** Handler function that executes the MCP tool */
+    _meta?: Record<string, any>; // Add _meta to AguiTool
     handler?: (args: any) => any | Promise<any>;
 }
 
 /**
  * Tool definition format for passing to remote agents (without handler).
- * Compatible with OpenAI's function calling API.
  */
 export interface AguiToolDefinition {
-    /** Tool name (e.g., "server-abc_get_weather") */
     name: string;
-    /** Human-readable description */
     description: string;
-    /** JSON Schema format parameters */
     parameters: Record<string, any>;
+    _meta?: Record<string, any>; // Add _meta to AguiToolDefinition
 }
 
 /**
  * Adapter that transforms MCP tools into AG-UI compatible formats.
- *
- * This adapter provides two main outputs:
- * - `getTools()`: Returns tools with handlers for server-side execution
- * - `getToolDefinitions()`: Returns tool definitions in JSON Schema format for remote agents
  */
 export class AguiAdapter {
     constructor(
@@ -88,123 +130,95 @@ export class AguiAdapter {
 
     /**
      * Get tools with handlers for MCP tool execution.
-     *
-     * Each tool includes a handler function that:
-     * 1. Calls the MCP tool via the client
-     * 2. Extracts text content from the result
-     * 3. Returns the result as a string or JSON
-     *
-     * @returns Array of AguiTool objects
      */
     async getTools(): Promise<AguiTool[]> {
-        const isMultiSession = typeof (this.client as any).getClients === 'function';
-
-        if (isMultiSession) {
+        if (this.isMultiSession()) {
             const clients = (this.client as MultiSessionClient).getClients();
             const allTools: AguiTool[] = [];
-
             for (const client of clients) {
-                const tools = await this.transformTools(client);
-                allTools.push(...tools);
+                allTools.push(...await this.transformTools(client));
             }
-
             return allTools;
         }
-
         return this.transformTools(this.client as MCPClient);
     }
 
-    private async transformTools(client: MCPClient): Promise<AguiTool[]> {
-        if (!client.isConnected()) {
-            return [];
-        }
-
-        const result = await client.listTools();
-        const prefix = this.options.prefix ?? client.getServerId() ?? 'mcp';
-        const tools: AguiTool[] = [];
-
-        for (const tool of result.tools) {
-            const toolName = `${prefix}_${tool.name}`;
-
-            tools.push({
-                name: toolName,
-                description: tool.description || `Execute ${tool.name}`,
-                parameters: tool.inputSchema || { type: 'object', properties: {} },
-                handler: async (args: any) => {
-                    console.log(`[AguiAdapter] Executing MCP tool: ${tool.name}`, args);
-                    const result = await client.callTool(tool.name, args);
-
-                    // Extract text content from result
-                    if (result.content && Array.isArray(result.content)) {
-                        const textContent = result.content
-                            .filter((c: any) => c.type === 'text')
-                            .map((c: any) => c.text)
-                            .join('\n');
-                        return textContent || result;
-                    }
-
-                    return result;
-                }
-            });
+    /**
+     * Get tool definitions in JSON Schema format for passing to remote agents.
+     */
+    async getToolDefinitions(): Promise<AguiToolDefinition[]> {
+        if (this.isMultiSession()) {
+            const clients = (this.client as MultiSessionClient).getClients();
+            const allTools: AguiToolDefinition[] = [];
+            for (const client of clients) {
+                allTools.push(...await this.transformToolDefinitions(client));
+            }
+            return allTools;
         }
-
-        return tools;
+        return this.transformToolDefinitions(this.client as MCPClient);
     }
 
     /**
      * Get tools as a function (for dynamic loading).
-     *
-     * @returns Function that returns a Promise of tools
      */
     getToolsFunction(): () => Promise<AguiTool[]> {
-        return async () => this.getTools();
+        return () => this.getTools();
     }
 
-    /**
-     * Get tool definitions in JSON Schema format for passing to remote agents.
-     *
-     * This format is compatible with:
-     * - OpenAI's function calling API
-     * - AG-UI input.tools format
-     * - Most LLM tool/function calling implementations
-     *
-     * @returns Array of AguiToolDefinition objects
-     */
-    async getToolDefinitions(): Promise<AguiToolDefinition[]> {
-        const isMultiSession = typeof (this.client as any).getClients === 'function';
+    private isMultiSession(): boolean {
+        return typeof (this.client as any).getClients === 'function';
+    }
 
-        if (isMultiSession) {
-            const clients = (this.client as MultiSessionClient).getClients();
-            const allTools: AguiToolDefinition[] = [];
+    private async transformTools(client: MCPClient): Promise<AguiTool[]> {
+        if (!client.isConnected()) return [];
 
-            for (const client of clients) {
-                const tools = await this.transformToolDefinitions(client);
-                allTools.push(...tools);
-            }
+        const result = await client.listTools();
+        const serverId = (typeof (client as any).getServerId === 'function'
+            ? (client as any).getServerId()
+            : undefined) as string | undefined;
+        const normalizedPrefix = (this.options.prefix ?? serverId ?? 'mcp').replace(/-/g, '');
+        const prefix = `tool_${normalizedPrefix}`;
+
+        return result.tools.map(tool => {
+            // Type assertion to access _meta if it exists on the tool object (it comes from MCP SDK)
+            const mcpTool = tool as any;
+            const mcpToolName = tool.name;
+            return {
+                name: `${prefix}_${tool.name}`,
+                description: tool.description || `Execute ${tool.name}`,
+                parameters: cleanSchema(tool.inputSchema),
+                _meta: { ...mcpTool._meta, sessionId: (client as any).getSessionId?.() },
+                handler: async (args: any) => {
+                    console.log(`[AguiAdapter] Executing MCP tool: ${mcpToolName}`, args);
 
-            return allTools;
-        }
+                    // IMPORTANT: call the actual MCP tool. (Previously this mistakenly returned the listTools() result.)
+                    const callResult = await (client as any).callTool(mcpToolName, args ?? {});
 
-        return this.transformToolDefinitions(this.client as MCPClient);
+                    // Return the raw result object so middleware can inspect `_meta` (e.g. for UI triggers).
+                    return callResult;
+                }
+            }
+        });
     }
 
     private async transformToolDefinitions(client: MCPClient): Promise<AguiToolDefinition[]> {
-        if (!client.isConnected()) {
-            return [];
-        }
+        if (!client.isConnected()) return [];
 
         const result = await client.listTools();
-        const prefix = this.options.prefix ?? client.getServerId() ?? 'mcp';
-        const tools: AguiToolDefinition[] = [];
-
-        for (const tool of result.tools) {
-            tools.push({
+        const serverId = (typeof (client as any).getServerId === 'function'
+            ? (client as any).getServerId()
+            : undefined) as string | undefined;
+        const normalizedPrefix = (this.options.prefix ?? serverId ?? 'mcp').replace(/-/g, '');
+        const prefix = `tool_${normalizedPrefix}`;
+
+        return result.tools.map(tool => {
+            const mcpTool = tool as any;
+            return {
                 name: `${prefix}_${tool.name}`,
                 description: tool.description || `Execute ${tool.name}`,
-                parameters: tool.inputSchema || { type: 'object', properties: {} },
-            });
-        }
-
-        return tools;
+                parameters: cleanSchema(tool.inputSchema),
+                _meta: { ...mcpTool._meta, sessionId: (client as any).getSessionId?.() },
+            };
+        });
     }
 }