@mcp-ts/sdk 1.0.0

package/dist/shared/index.js

@@ -0,0 +1,223 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/shared/events.ts
+var Emitter = class {
+  constructor() {
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+  }
+  /**
+   * Subscribe to events
+   * @param listener - Callback function to handle events
+   * @returns Disposable to unsubscribe
+   */
+  get event() {
+    return (listener) => {
+      this.listeners.add(listener);
+      return {
+        dispose: () => {
+          this.listeners.delete(listener);
+        }
+      };
+    };
+  }
+  /**
+   * Fire an event to all listeners
+   * @param event - Event data to emit
+   */
+  fire(event) {
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch (error) {
+        console.error("[Emitter] Error in event listener:", error);
+      }
+    }
+  }
+  /**
+   * Clear all listeners
+   */
+  dispose() {
+    this.listeners.clear();
+  }
+  /**
+   * Get number of active listeners
+   */
+  get listenerCount() {
+    return this.listeners.size;
+  }
+};
+var DisposableStore = class {
+  constructor() {
+    __publicField(this, "disposables", /* @__PURE__ */ new Set());
+  }
+  add(disposable) {
+    this.disposables.add(disposable);
+  }
+  dispose() {
+    for (const disposable of this.disposables) {
+      disposable.dispose();
+    }
+    this.disposables.clear();
+  }
+};
+
+// src/shared/constants.ts
+var SESSION_TTL_SECONDS = 43200;
+var STATE_EXPIRATION_MS = 10 * 60 * 1e3;
+var DEFAULT_HEARTBEAT_INTERVAL_MS = 3e4;
+var REDIS_KEY_PREFIX = "mcp:session:";
+var TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1e3;
+var DEFAULT_CLIENT_NAME = "MCP Assistant";
+var DEFAULT_CLIENT_URI = "https://mcp-assistant.in";
+var DEFAULT_LOGO_URI = "https://mcp-assistant.in/logo.png";
+var DEFAULT_POLICY_URI = "https://mcp-assistant.in/privacy";
+var SOFTWARE_ID = "@mcp-ts";
+var SOFTWARE_VERSION = "1.0.0-beta.5";
+var MCP_CLIENT_NAME = "mcp-ts-oauth-client";
+var MCP_CLIENT_VERSION = "2.0";
+
+// src/shared/errors.ts
+var McpError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "McpError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      ...this.cause ? { cause: this.cause.message } : {}
+    };
+  }
+};
+var UnauthorizedError = class extends McpError {
+  constructor(message = "OAuth authorization required", cause) {
+    super("UNAUTHORIZED", message, cause);
+    this.name = "UnauthorizedError";
+  }
+};
+var ConnectionError = class extends McpError {
+  constructor(message, cause) {
+    super("CONNECTION_ERROR", message, cause);
+    this.name = "ConnectionError";
+  }
+};
+var SessionNotFoundError = class extends McpError {
+  constructor(sessionId, cause) {
+    super("SESSION_NOT_FOUND", `Session not found: ${sessionId}`, cause);
+    this.name = "SessionNotFoundError";
+  }
+};
+var SessionValidationError = class extends McpError {
+  constructor(message, cause) {
+    super("SESSION_VALIDATION_ERROR", message, cause);
+    this.name = "SessionValidationError";
+  }
+};
+var AuthenticationError = class extends McpError {
+  constructor(message, cause) {
+    super("AUTH_ERROR", message, cause);
+    this.name = "AuthenticationError";
+  }
+};
+var InvalidStateError = class extends McpError {
+  constructor(message = "Invalid OAuth state", cause) {
+    super("INVALID_STATE", message, cause);
+    this.name = "InvalidStateError";
+  }
+};
+var NotConnectedError = class extends McpError {
+  constructor(message = "Not connected to server", cause) {
+    super("NOT_CONNECTED", message, cause);
+    this.name = "NotConnectedError";
+  }
+};
+var ConfigurationError = class extends McpError {
+  constructor(message, cause) {
+    super("CONFIGURATION_ERROR", message, cause);
+    this.name = "ConfigurationError";
+  }
+};
+var ToolExecutionError = class extends McpError {
+  constructor(toolName, message, cause) {
+    super("TOOL_EXECUTION_ERROR", `Tool '${toolName}' failed: ${message}`, cause);
+    this.name = "ToolExecutionError";
+  }
+};
+var RpcErrorCodes = {
+  EXECUTION_ERROR: "EXECUTION_ERROR",
+  MISSING_IDENTITY: "MISSING_IDENTITY",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  NO_CONNECTION: "NO_CONNECTION",
+  UNKNOWN_METHOD: "UNKNOWN_METHOD",
+  INVALID_PARAMS: "INVALID_PARAMS"
+};
+
+// src/shared/types.ts
+function isConnectSuccess(response) {
+  return "success" in response && response.success === true;
+}
+function isConnectAuthRequired(response) {
+  return "requiresAuth" in response && response.requiresAuth === true;
+}
+function isConnectError(response) {
+  return "error" in response;
+}
+function isListToolsSuccess(response) {
+  return "tools" in response;
+}
+function isCallToolSuccess(response) {
+  return "content" in response;
+}
+
+// src/shared/utils.ts
+function sanitizeServerLabel(name) {
+  let sanitized = name.replace(/[^a-zA-Z0-9-_]/g, "_").replace(/_{2,}/g, "_").toLowerCase();
+  if (!/^[a-zA-Z]/.test(sanitized)) {
+    sanitized = "s_" + sanitized;
+  }
+  return sanitized;
+}
+
+exports.AuthenticationError = AuthenticationError;
+exports.ConfigurationError = ConfigurationError;
+exports.ConnectionError = ConnectionError;
+exports.DEFAULT_CLIENT_NAME = DEFAULT_CLIENT_NAME;
+exports.DEFAULT_CLIENT_URI = DEFAULT_CLIENT_URI;
+exports.DEFAULT_HEARTBEAT_INTERVAL_MS = DEFAULT_HEARTBEAT_INTERVAL_MS;
+exports.DEFAULT_LOGO_URI = DEFAULT_LOGO_URI;
+exports.DEFAULT_POLICY_URI = DEFAULT_POLICY_URI;
+exports.DisposableStore = DisposableStore;
+exports.Emitter = Emitter;
+exports.InvalidStateError = InvalidStateError;
+exports.MCP_CLIENT_NAME = MCP_CLIENT_NAME;
+exports.MCP_CLIENT_VERSION = MCP_CLIENT_VERSION;
+exports.McpError = McpError;
+exports.NotConnectedError = NotConnectedError;
+exports.REDIS_KEY_PREFIX = REDIS_KEY_PREFIX;
+exports.RpcErrorCodes = RpcErrorCodes;
+exports.SESSION_TTL_SECONDS = SESSION_TTL_SECONDS;
+exports.SOFTWARE_ID = SOFTWARE_ID;
+exports.SOFTWARE_VERSION = SOFTWARE_VERSION;
+exports.STATE_EXPIRATION_MS = STATE_EXPIRATION_MS;
+exports.SessionNotFoundError = SessionNotFoundError;
+exports.SessionValidationError = SessionValidationError;
+exports.TOKEN_EXPIRY_BUFFER_MS = TOKEN_EXPIRY_BUFFER_MS;
+exports.ToolExecutionError = ToolExecutionError;
+exports.UnauthorizedError = UnauthorizedError;
+exports.isCallToolSuccess = isCallToolSuccess;
+exports.isConnectAuthRequired = isConnectAuthRequired;
+exports.isConnectError = isConnectError;
+exports.isConnectSuccess = isConnectSuccess;
+exports.isListToolsSuccess = isListToolsSuccess;
+exports.sanitizeServerLabel = sanitizeServerLabel;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +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"]}

package/dist/shared/index.mjs

@@ -0,0 +1,190 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/shared/events.ts
+var Emitter = class {
+  constructor() {
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+  }
+  /**
+   * Subscribe to events
+   * @param listener - Callback function to handle events
+   * @returns Disposable to unsubscribe
+   */
+  get event() {
+    return (listener) => {
+      this.listeners.add(listener);
+      return {
+        dispose: () => {
+          this.listeners.delete(listener);
+        }
+      };
+    };
+  }
+  /**
+   * Fire an event to all listeners
+   * @param event - Event data to emit
+   */
+  fire(event) {
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch (error) {
+        console.error("[Emitter] Error in event listener:", error);
+      }
+    }
+  }
+  /**
+   * Clear all listeners
+   */
+  dispose() {
+    this.listeners.clear();
+  }
+  /**
+   * Get number of active listeners
+   */
+  get listenerCount() {
+    return this.listeners.size;
+  }
+};
+var DisposableStore = class {
+  constructor() {
+    __publicField(this, "disposables", /* @__PURE__ */ new Set());
+  }
+  add(disposable) {
+    this.disposables.add(disposable);
+  }
+  dispose() {
+    for (const disposable of this.disposables) {
+      disposable.dispose();
+    }
+    this.disposables.clear();
+  }
+};
+
+// src/shared/constants.ts
+var SESSION_TTL_SECONDS = 43200;
+var STATE_EXPIRATION_MS = 10 * 60 * 1e3;
+var DEFAULT_HEARTBEAT_INTERVAL_MS = 3e4;
+var REDIS_KEY_PREFIX = "mcp:session:";
+var TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1e3;
+var DEFAULT_CLIENT_NAME = "MCP Assistant";
+var DEFAULT_CLIENT_URI = "https://mcp-assistant.in";
+var DEFAULT_LOGO_URI = "https://mcp-assistant.in/logo.png";
+var DEFAULT_POLICY_URI = "https://mcp-assistant.in/privacy";
+var SOFTWARE_ID = "@mcp-ts";
+var SOFTWARE_VERSION = "1.0.0-beta.5";
+var MCP_CLIENT_NAME = "mcp-ts-oauth-client";
+var MCP_CLIENT_VERSION = "2.0";
+
+// src/shared/errors.ts
+var McpError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "McpError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      ...this.cause ? { cause: this.cause.message } : {}
+    };
+  }
+};
+var UnauthorizedError = class extends McpError {
+  constructor(message = "OAuth authorization required", cause) {
+    super("UNAUTHORIZED", message, cause);
+    this.name = "UnauthorizedError";
+  }
+};
+var ConnectionError = class extends McpError {
+  constructor(message, cause) {
+    super("CONNECTION_ERROR", message, cause);
+    this.name = "ConnectionError";
+  }
+};
+var SessionNotFoundError = class extends McpError {
+  constructor(sessionId, cause) {
+    super("SESSION_NOT_FOUND", `Session not found: ${sessionId}`, cause);
+    this.name = "SessionNotFoundError";
+  }
+};
+var SessionValidationError = class extends McpError {
+  constructor(message, cause) {
+    super("SESSION_VALIDATION_ERROR", message, cause);
+    this.name = "SessionValidationError";
+  }
+};
+var AuthenticationError = class extends McpError {
+  constructor(message, cause) {
+    super("AUTH_ERROR", message, cause);
+    this.name = "AuthenticationError";
+  }
+};
+var InvalidStateError = class extends McpError {
+  constructor(message = "Invalid OAuth state", cause) {
+    super("INVALID_STATE", message, cause);
+    this.name = "InvalidStateError";
+  }
+};
+var NotConnectedError = class extends McpError {
+  constructor(message = "Not connected to server", cause) {
+    super("NOT_CONNECTED", message, cause);
+    this.name = "NotConnectedError";
+  }
+};
+var ConfigurationError = class extends McpError {
+  constructor(message, cause) {
+    super("CONFIGURATION_ERROR", message, cause);
+    this.name = "ConfigurationError";
+  }
+};
+var ToolExecutionError = class extends McpError {
+  constructor(toolName, message, cause) {
+    super("TOOL_EXECUTION_ERROR", `Tool '${toolName}' failed: ${message}`, cause);
+    this.name = "ToolExecutionError";
+  }
+};
+var RpcErrorCodes = {
+  EXECUTION_ERROR: "EXECUTION_ERROR",
+  MISSING_IDENTITY: "MISSING_IDENTITY",
+  UNAUTHORIZED: "UNAUTHORIZED",
+  NO_CONNECTION: "NO_CONNECTION",
+  UNKNOWN_METHOD: "UNKNOWN_METHOD",
+  INVALID_PARAMS: "INVALID_PARAMS"
+};
+
+// src/shared/types.ts
+function isConnectSuccess(response) {
+  return "success" in response && response.success === true;
+}
+function isConnectAuthRequired(response) {
+  return "requiresAuth" in response && response.requiresAuth === true;
+}
+function isConnectError(response) {
+  return "error" in response;
+}
+function isListToolsSuccess(response) {
+  return "tools" in response;
+}
+function isCallToolSuccess(response) {
+  return "content" in response;
+}
+
+// src/shared/utils.ts
+function sanitizeServerLabel(name) {
+  let sanitized = name.replace(/[^a-zA-Z0-9-_]/g, "_").replace(/_{2,}/g, "_").toLowerCase();
+  if (!/^[a-zA-Z]/.test(sanitized)) {
+    sanitized = "s_" + sanitized;
+  }
+  return sanitized;
+}
+
+export { AuthenticationError, ConfigurationError, ConnectionError, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, DisposableStore, Emitter, InvalidStateError, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, McpError, NotConnectedError, REDIS_KEY_PREFIX, RpcErrorCodes, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, SessionNotFoundError, SessionValidationError, TOKEN_EXPIRY_BUFFER_MS, ToolExecutionError, UnauthorizedError, isCallToolSuccess, isConnectAuthRequired, isConnectError, isConnectSuccess, isListToolsSuccess, sanitizeServerLabel };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/shared/index.mjs.map

@@ -0,0 +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"]}

package/dist/types-SbDlA2VX.d.mts

@@ -0,0 +1,153 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * Type definitions for MCP operations
+ */
+
+interface ConnectRequest {
+    serverUrl: string;
+    callbackUrl: string;
+}
+interface ConnectSuccessResponse {
+    success: true;
+    sessionId: string;
+}
+interface ConnectAuthRequiredResponse {
+    requiresAuth: true;
+    authUrl: string;
+    sessionId: string;
+}
+interface ConnectErrorResponse {
+    error: string;
+}
+type ConnectResponse = ConnectSuccessResponse | ConnectAuthRequiredResponse | ConnectErrorResponse;
+interface ListToolsSuccessResponse {
+    tools: Tool[];
+}
+interface ListToolsErrorResponse {
+    error: string;
+}
+type ListToolsResponse = ListToolsSuccessResponse | ListToolsErrorResponse;
+interface CallToolRequest {
+    sessionId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+interface CallToolSuccessResponse {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError: boolean;
+}
+interface CallToolErrorResponse {
+    error: string;
+}
+type CallToolResponse = CallToolSuccessResponse | CallToolErrorResponse;
+declare function isConnectSuccess(response: ConnectResponse): response is ConnectSuccessResponse;
+declare function isConnectAuthRequired(response: ConnectResponse): response is ConnectAuthRequiredResponse;
+declare function isConnectError(response: ConnectResponse): response is ConnectErrorResponse;
+declare function isListToolsSuccess(response: ListToolsResponse): response is ListToolsSuccessResponse;
+declare function isCallToolSuccess(response: CallToolResponse): response is CallToolSuccessResponse;
+type ToolInfo = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+type TransportType = 'sse' | 'streamable_http';
+type McpRpcMethod = 'connect' | 'disconnect' | 'listTools' | 'callTool' | 'getSessions' | 'restoreSession' | 'finishAuth' | 'listPrompts' | 'getPrompt' | 'listResources' | 'readResource';
+interface McpRpcRequest {
+    id: string;
+    method: McpRpcMethod;
+    params?: McpRpcParams;
+}
+interface McpRpcResponse<T = unknown> {
+    id: string;
+    result?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface ConnectParams {
+    serverId: string;
+    serverName: string;
+    serverUrl: string;
+    callbackUrl: string;
+    transportType?: TransportType;
+}
+interface DisconnectParams {
+    sessionId: string;
+}
+interface SessionParams {
+    sessionId: string;
+}
+interface CallToolParams {
+    sessionId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+interface GetPromptParams {
+    sessionId: string;
+    name: string;
+    args?: Record<string, string>;
+}
+interface ReadResourceParams {
+    sessionId: string;
+    uri: string;
+}
+interface FinishAuthParams {
+    sessionId: string;
+    code: string;
+}
+type McpRpcParams = ConnectParams | DisconnectParams | SessionParams | CallToolParams | GetPromptParams | ReadResourceParams | FinishAuthParams | undefined;
+interface SessionInfo {
+    sessionId: string;
+    serverId?: string;
+    serverName?: string;
+    serverUrl: string;
+    transport: TransportType;
+}
+interface SessionListResult {
+    sessions: SessionInfo[];
+}
+interface ConnectResult {
+    sessionId: string;
+    success: boolean;
+}
+interface DisconnectResult {
+    success: boolean;
+}
+interface RestoreSessionResult {
+    success: boolean;
+    toolCount: number;
+}
+interface FinishAuthResult {
+    success: boolean;
+    toolCount: number;
+}
+interface ListToolsRpcResult {
+    tools: Tool[];
+}
+interface ListPromptsResult {
+    prompts: Array<{
+        name: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+}
+interface ListResourcesResult {
+    resources: Array<{
+        uri: string;
+        name: string;
+        description?: string;
+        mimeType?: string;
+    }>;
+}
+
+export { type CallToolParams as C, type DisconnectParams as D, type FinishAuthParams as F, type GetPromptParams as G, type ListPromptsResult as L, type McpRpcMethod as M, type ReadResourceParams as R, type SessionInfo as S, type ToolInfo as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type FinishAuthResult as k, type ListResourcesResult as l, type ListToolsResponse as m, type ListToolsRpcResult as n, type McpRpcParams as o, type McpRpcRequest as p, type McpRpcResponse as q, type RestoreSessionResult as r, type SessionListResult as s, type SessionParams as t, type TransportType as u, isCallToolSuccess as v, isConnectAuthRequired as w, isConnectError as x, isConnectSuccess as y, isListToolsSuccess as z };