mongo.do 0.1.0

package/dist/mcp/adapters/base-adapter.js

@@ -0,0 +1,277 @@
+/**
+ * Base SDK Adapter for MCP
+ *
+ * Provides common functionality for SDK adapters:
+ * - Retry logic with exponential backoff
+ * - Timeout handling with AbortController
+ * - Request/response logging
+ * - Error normalization
+ *
+ * SDK adapters (Anthropic, Vercel) extend this base class.
+ */
+import { McpError, McpErrorCode, TimeoutError, isRetryableError, getRetryDelay, createErrorResponse, } from './errors';
+// =============================================================================
+// Default Configuration
+// =============================================================================
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    jitter: true,
+};
+const DEFAULT_TIMEOUT_CONFIG = {
+    requestTimeoutMs: 30000,
+    connectTimeoutMs: 10000,
+    idleTimeoutMs: 60000,
+};
+const DEFAULT_LOG_CONFIG = {
+    debug: false,
+    logRequests: false,
+    logResponses: false,
+};
+// =============================================================================
+// Base Adapter Class
+// =============================================================================
+/**
+ * Abstract base class for SDK adapters
+ *
+ * Provides common infrastructure for adapting MCP servers to different SDKs.
+ * Subclasses implement SDK-specific tool formatting and request handling.
+ *
+ * @example
+ * ```typescript
+ * class MyAdapter extends BaseAdapter {
+ *   constructor(config: BaseAdapterConfig) {
+ *     super(config)
+ *   }
+ *
+ *   async formatTool(definition: McpToolDefinition): Promise<SDKTool> {
+ *     // Convert MCP tool to SDK format
+ *   }
+ * }
+ * ```
+ */
+export class BaseAdapter {
+    server;
+    retryConfig;
+    timeoutConfig;
+    logConfig;
+    constructor(config) {
+        this.server = config.server;
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config.retry };
+        this.timeoutConfig = { ...DEFAULT_TIMEOUT_CONFIG, ...config.timeout };
+        this.logConfig = { ...DEFAULT_LOG_CONFIG, ...config.log };
+    }
+    // ===========================================================================
+    // Logging
+    // ===========================================================================
+    /**
+     * Log a message at the specified level
+     */
+    log(level, message, data) {
+        // Skip debug messages when debug mode is disabled
+        if (level === 'debug' && !this.logConfig.debug) {
+            return;
+        }
+        if (this.logConfig.logger) {
+            this.logConfig.logger(level, message, data);
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [MCP:${level.toUpperCase()}]`;
+        switch (level) {
+            case 'debug':
+                console.debug(prefix, message, data ?? '');
+                break;
+            case 'info':
+                console.info(prefix, message, data ?? '');
+                break;
+            case 'warn':
+                console.warn(prefix, message, data ?? '');
+                break;
+            case 'error':
+                console.error(prefix, message, data ?? '');
+                break;
+        }
+    }
+    // ===========================================================================
+    // Retry Logic
+    // ===========================================================================
+    /**
+     * Calculate delay for retry attempt with exponential backoff
+     */
+    calculateRetryDelay(attempt, baseDelay) {
+        const base = baseDelay ?? this.retryConfig.initialDelayMs;
+        let delay = base * Math.pow(this.retryConfig.backoffMultiplier, attempt);
+        delay = Math.min(delay, this.retryConfig.maxDelayMs);
+        if (this.retryConfig.jitter) {
+            // Add 0-25% jitter
+            delay = delay * (1 + Math.random() * 0.25);
+        }
+        return Math.floor(delay);
+    }
+    /**
+     * Execute an operation with retry logic
+     *
+     * @param operation - Async operation to execute
+     * @param context - Context for logging
+     * @returns Result of the operation
+     * @throws McpError if all retries fail
+     */
+    async withRetry(operation, context) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                if (attempt > 0) {
+                    this.log('debug', `${context}: retry attempt ${attempt}/${this.retryConfig.maxRetries}`);
+                }
+                return await operation(attempt);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Check if we should retry
+                if (attempt >= this.retryConfig.maxRetries || !isRetryableError(lastError)) {
+                    this.log('error', `${context}: failed after ${attempt + 1} attempts`, {
+                        error: lastError.message,
+                    });
+                    throw McpError.fromError(lastError);
+                }
+                // Calculate delay
+                const delay = getRetryDelay(lastError, this.calculateRetryDelay(attempt));
+                this.log('warn', `${context}: retrying in ${delay}ms`, {
+                    error: lastError.message,
+                    attempt,
+                });
+                await this.sleep(delay);
+            }
+        }
+        // Should not reach here, but TypeScript needs it
+        throw lastError ?? new McpError(McpErrorCode.InternalError, 'Retry logic error');
+    }
+    /**
+     * Sleep for a specified duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    // ===========================================================================
+    // Timeout Handling
+    // ===========================================================================
+    /**
+     * Execute an operation with timeout
+     *
+     * @param operation - Async operation to execute
+     * @param timeoutMs - Timeout in milliseconds
+     * @param context - Context for error messages
+     * @returns Result of the operation
+     * @throws TimeoutError if operation times out
+     */
+    async withTimeout(operation, timeoutMs, context) {
+        const controller = new AbortController();
+        const { signal } = controller;
+        // Create a promise that rejects on timeout
+        const timeoutPromise = new Promise((_, reject) => {
+            const timeoutId = setTimeout(() => {
+                controller.abort();
+                reject(new TimeoutError(`${context}: operation timed out after ${timeoutMs}ms`, timeoutMs));
+            }, timeoutMs);
+            // Clean up timeout if signal aborted externally
+            signal.addEventListener('abort', () => clearTimeout(timeoutId), { once: true });
+        });
+        try {
+            // Race between operation and timeout
+            return await Promise.race([operation(signal), timeoutPromise]);
+        }
+        catch (error) {
+            if (error instanceof TimeoutError) {
+                throw error;
+            }
+            if (signal.aborted) {
+                throw new TimeoutError(`${context}: operation timed out after ${timeoutMs}ms`, timeoutMs);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Execute an operation with both retry and timeout
+     */
+    async withRetryAndTimeout(operation, context, timeoutMs) {
+        const timeout = timeoutMs ?? this.timeoutConfig.requestTimeoutMs;
+        return this.withRetry(async () => this.withTimeout(operation, timeout, context), context);
+    }
+    // ===========================================================================
+    // Request Handling
+    // ===========================================================================
+    /**
+     * Handle an MCP request with error handling and logging
+     */
+    async handleRequest(request) {
+        const startTime = Date.now();
+        if (this.logConfig.logRequests) {
+            this.log('debug', 'MCP request', { method: request.method, id: request.id });
+        }
+        try {
+            const response = await this.withRetryAndTimeout(async () => this.server.handleRequest(request), `handleRequest:${request.method}`);
+            if (this.logConfig.logResponses) {
+                this.log('debug', 'MCP response', {
+                    method: request.method,
+                    id: request.id,
+                    duration: Date.now() - startTime,
+                    hasError: !!response.error,
+                });
+            }
+            return response;
+        }
+        catch (error) {
+            const mcpError = McpError.fromError(error instanceof Error ? error : new Error(String(error)));
+            this.log('error', 'Request failed', {
+                method: request.method,
+                id: request.id,
+                error: mcpError.message,
+                code: mcpError.code,
+            });
+            return {
+                jsonrpc: '2.0',
+                id: request.id,
+                error: mcpError.toResponse(),
+            };
+        }
+    }
+    /**
+     * Call a tool with error handling
+     */
+    async callTool(name, args) {
+        if (this.logConfig.logRequests) {
+            this.log('debug', `Calling tool: ${name}`, this.logConfig.debug ? args : undefined);
+        }
+        const startTime = Date.now();
+        try {
+            const result = await this.withRetryAndTimeout(async () => this.server.callTool(name, args), `callTool:${name}`);
+            if (this.logConfig.logResponses) {
+                this.log('debug', `Tool completed: ${name}`, {
+                    duration: Date.now() - startTime,
+                    isError: result.isError,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            const mcpError = McpError.fromError(error instanceof Error ? error : new Error(String(error)));
+            this.log('error', `Tool failed: ${name}`, {
+                error: mcpError.message,
+                code: mcpError.code,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(createErrorResponse(mcpError)),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/dist/mcp/adapters/base-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../../src/mcp/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAA;AA8DjB,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,MAAM,oBAAoB,GAAgB;IACxC,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,CAAC;IACpB,MAAM,EAAE,IAAI;CACb,CAAA;AAED,MAAM,sBAAsB,GAAkB;IAC5C,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;CACrB,CAAA;AAED,MAAM,kBAAkB,GAAc;IACpC,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;CACpB,CAAA;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,WAAW;IACZ,MAAM,CAAW;IACjB,WAAW,CAAa;IACxB,aAAa,CAAe;IAC5B,SAAS,CAAW;IAEvC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC3B,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;QAC/D,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,sBAAsB,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAA;QACrE,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,kBAAkB,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAA;IAC3D,CAAC;IAED,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;OAEG;IACO,GAAG,CACX,KAA0C,EAC1C,OAAe,EACf,IAAc;QAEd,kDAAkD;QAClD,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAM;QACR,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YAC3C,OAAM;QACR,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,UAAU,KAAK,CAAC,WAAW,EAAE,GAAG,CAAA;QAE5D,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;gBAC1C,MAAK;YACP,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;gBACzC,MAAK;YACP,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;gBACzC,MAAK;YACP,KAAK,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;gBAC1C,MAAK;QACT,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,cAAc;IACd,8EAA8E;IAE9E;;OAEG;IACO,mBAAmB,CAAC,OAAe,EAAE,SAAkB;QAC/D,MAAM,IAAI,GAAG,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,cAAc,CAAA;QACzD,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;QACxE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;QAEpD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YAC5B,mBAAmB;YACnB,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,SAAS,CACvB,SAA0C,EAC1C,OAAe;QAEf,IAAI,SAAS,GAAiB,IAAI,CAAA;QAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACxE,IAAI,CAAC;gBACH,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,mBAAmB,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAA;gBAC1F,CAAC;gBAED,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBAErE,2BAA2B;gBAC3B,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3E,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,kBAAkB,OAAO,GAAG,CAAC,WAAW,EAAE;wBACpE,KAAK,EAAE,SAAS,CAAC,OAAO;qBACzB,CAAC,CAAA;oBACF,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;gBACrC,CAAC;gBAED,kBAAkB;gBAClB,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAA;gBACzE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,iBAAiB,KAAK,IAAI,EAAE;oBACrD,KAAK,EAAE,SAAS,CAAC,OAAO;oBACxB,OAAO;iBACR,CAAC,CAAA;gBAEF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,MAAM,SAAS,IAAI,IAAI,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAA;IAClF,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,EAAU;QACxB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;;;;;;;OAQG;IACO,KAAK,CAAC,WAAW,CACzB,SAA8C,EAC9C,SAAiB,EACjB,OAAe;QAEf,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;QAE7B,2CAA2C;QAC3C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACtD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,UAAU,CAAC,KAAK,EAAE,CAAA;gBAClB,MAAM,CAAC,IAAI,YAAY,CACrB,GAAG,OAAO,+BAA+B,SAAS,IAAI,EACtD,SAAS,CACV,CAAC,CAAA;YACJ,CAAC,EAAE,SAAS,CAAC,CAAA;YAEb,gDAAgD;YAChD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACjF,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC;YACH,qCAAqC;YACrC,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAA;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAA;YACb,CAAC;YACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,YAAY,CACpB,GAAG,OAAO,+BAA+B,SAAS,IAAI,EACtD,SAAS,CACV,CAAA;YACH,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,mBAAmB,CACjC,SAA8C,EAC9C,OAAe,EACf,SAAkB;QAElB,MAAM,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAA;QAEhE,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EACzD,OAAO,CACR,CAAA;IACH,CAAC;IAED,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E;;OAEG;IACO,KAAK,CAAC,aAAa,CAAC,OAAmB;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAC7C,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAC9C,iBAAiB,OAAO,CAAC,MAAM,EAAE,CAClC,CAAA;YAED,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE;oBAChC,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK;iBAC3B,CAAC,CAAA;YACJ,CAAC;YAED,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAE9F,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE;gBAClC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC,CAAA;YAEF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE;aAC7B,CAAA;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,QAAQ,CACtB,IAAY,EACZ,IAA6B;QAE7B,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACrF,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAC3C,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAC5C,YAAY,IAAI,EAAE,CACnB,CAAA;YAED,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,IAAI,EAAE,EAAE;oBAC3C,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAChC,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAA;YACJ,CAAC;YAED,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAE9F,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,IAAI,EAAE,EAAE;gBACxC,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC,CAAA;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;qBACpD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;IACH,CAAC;CAoBF"}

package/dist/mcp/adapters/errors.d.ts

@@ -0,0 +1,173 @@
+/**
+ * MCP SDK Adapter Error Types and Utilities
+ *
+ * Provides standardized error handling for SDK adapters following MCP protocol.
+ * Includes:
+ * - MCP-specific error codes (JSON-RPC 2.0 compliant)
+ * - Typed error classes for different failure modes
+ * - Error categorization for retry logic
+ * - Utility functions for error handling
+ */
+/**
+ * Standard JSON-RPC 2.0 error codes used by MCP
+ */
+export declare const McpErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly ServerError: -32000;
+    readonly ServerBusy: -32001;
+    readonly ServerShutdown: -32002;
+    readonly ToolNotFound: -32800;
+    readonly ToolExecutionError: -32801;
+    readonly ResourceNotFound: -32802;
+    readonly ResourceAccessDenied: -32803;
+    readonly PromptNotFound: -32804;
+    readonly InvalidToolResponse: -32805;
+    readonly ConnectionError: -32900;
+    readonly ConnectionTimeout: -32901;
+    readonly ConnectionClosed: -32902;
+    readonly RateLimited: -32903;
+    readonly AuthenticationFailed: -32904;
+};
+export type McpErrorCodeType = (typeof McpErrorCode)[keyof typeof McpErrorCode];
+/**
+ * Additional data included in MCP error responses
+ */
+export interface McpErrorData {
+    /** Original error message if wrapping another error */
+    originalError?: string;
+    /** Stack trace for debugging (only in development) */
+    stack?: string;
+    /** Request ID that caused the error */
+    requestId?: string | number;
+    /** Timestamp when error occurred */
+    timestamp?: string;
+    /** Retry-after hint in milliseconds */
+    retryAfter?: number;
+    /** Whether the error is transient and can be retried */
+    retryable?: boolean;
+    /** Additional context-specific data */
+    [key: string]: unknown;
+}
+/**
+ * JSON-RPC error response structure
+ */
+export interface McpErrorResponse {
+    code: McpErrorCodeType;
+    message: string;
+    data?: McpErrorData;
+}
+/**
+ * Base error class for all MCP-related errors
+ *
+ * Provides:
+ * - MCP error code mapping
+ * - Retryability information
+ * - Serialization to JSON-RPC format
+ *
+ * @example
+ * ```typescript
+ * throw new McpError(
+ *   McpErrorCode.ToolExecutionError,
+ *   'Failed to execute search tool',
+ *   { originalError: 'Database connection failed', retryable: true }
+ * )
+ * ```
+ */
+export declare class McpError extends Error {
+    readonly code: McpErrorCodeType;
+    readonly data?: McpErrorData;
+    readonly retryable: boolean;
+    readonly timestamp: Date;
+    constructor(code: McpErrorCodeType, message: string, data?: McpErrorData);
+    /**
+     * Convert to JSON-RPC error response format
+     */
+    toResponse(): McpErrorResponse;
+    /**
+     * Create from a standard Error
+     */
+    static fromError(error: Error, code?: McpErrorCodeType): McpError;
+}
+/**
+ * Connection error - network or transport layer failures
+ */
+export declare class ConnectionError extends McpError {
+    constructor(message: string, data?: McpErrorData);
+}
+/**
+ * Timeout error - operation exceeded time limit
+ */
+export declare class TimeoutError extends McpError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, data?: McpErrorData);
+}
+/**
+ * Rate limit error - too many requests
+ */
+export declare class RateLimitError extends McpError {
+    readonly retryAfterMs: number;
+    constructor(message: string, retryAfterMs: number, data?: McpErrorData);
+}
+/**
+ * Authentication error - invalid or expired credentials
+ */
+export declare class AuthenticationError extends McpError {
+    constructor(message: string, data?: McpErrorData);
+}
+/**
+ * Tool not found error - requested tool doesn't exist
+ */
+export declare class ToolNotFoundError extends McpError {
+    readonly toolName: string;
+    constructor(toolName: string, data?: McpErrorData);
+}
+/**
+ * Tool execution error - tool failed during execution
+ */
+export declare class ToolExecutionError extends McpError {
+    readonly toolName: string;
+    constructor(toolName: string, message: string, data?: McpErrorData);
+}
+/**
+ * Invalid params error - request parameters are malformed
+ */
+export declare class InvalidParamsError extends McpError {
+    constructor(message: string, data?: McpErrorData);
+}
+/**
+ * Check if an error code represents a transient failure that can be retried
+ */
+export declare function isTransientErrorCode(code: McpErrorCodeType): boolean;
+/**
+ * Classify a standard Error into an MCP error code
+ */
+export declare function classifyError(error: Error): McpErrorCodeType;
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryableError(error: Error): boolean;
+/**
+ * Get retry delay from error (if rate limited) or use default
+ */
+export declare function getRetryDelay(error: Error, defaultDelayMs?: number): number;
+/**
+ * Wrap an async function with MCP error handling
+ *
+ * @example
+ * ```typescript
+ * const safeFetch = wrapWithMcpError(async () => {
+ *   const response = await fetch(url)
+ *   return response.json()
+ * })
+ * ```
+ */
+export declare function wrapWithMcpError<T>(fn: () => Promise<T>, defaultCode?: McpErrorCodeType): Promise<T>;
+/**
+ * Create a JSON-RPC error response from an Error
+ */
+export declare function createErrorResponse(error: Error, requestId?: string | number): McpErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/mcp/adapters/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/adapters/errors.ts"],"names":[],"mappings":"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"}