@daniel.stefan/metalink 1.3.1

package/packages/core/dist/server/circuit-breaker.js

@@ -0,0 +1,330 @@
+/**
+ * Circuit Breaker Implementation for MetaLink
+ *
+ * Prevents cascade failures by monitoring server health and temporarily
+ * blocking requests to failing servers. Implements the Circuit Breaker pattern
+ * with three states: CLOSED, OPEN, and HALF_OPEN.
+ *
+ * @see https://martinfowler.com/bliki/CircuitBreaker.html
+ */
+/**
+ * Circuit breaker states
+ *
+ * - CLOSED: Normal operation, requests flow through
+ * - OPEN: Server is failing, requests blocked immediately
+ * - HALF_OPEN: Testing if server has recovered, limited requests allowed
+ */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Circuit Breaker implementation
+ *
+ * Monitors server health and prevents cascade failures by temporarily blocking
+ * requests to failing servers. Automatically recovers when server becomes healthy.
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker('memory-server', {
+ *   failureThreshold: 3,
+ *   resetTimeout: 30000,
+ *   halfOpenSuccessThreshold: 1,
+ * });
+ *
+ * // Before making request
+ * if (!breaker.canExecute()) {
+ *   throw new Error('Circuit breaker is OPEN');
+ * }
+ *
+ * try {
+ *   const result = await makeRequest();
+ *   breaker.recordSuccess();
+ *   return result;
+ * } catch (error) {
+ *   breaker.recordFailure();
+ *   throw error;
+ * }
+ * ```
+ */
+export class CircuitBreaker {
+    /**
+     * Create a new circuit breaker for a server
+     *
+     * @param serverName - Name of the server being protected
+     * @param config - Circuit breaker configuration options
+     */
+    constructor(serverName, config = {}) {
+        this.state = CircuitState.CLOSED;
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = null;
+        this.lastSuccessTime = null;
+        this.stateChangedAt = Date.now();
+        this.resetTimer = null;
+        // Metrics tracking
+        this.totalRequests = 0;
+        this.rejectedRequests = 0;
+        this.serverName = serverName;
+        this.config = {
+            failureThreshold: config.failureThreshold ?? 3,
+            resetTimeout: config.resetTimeout ?? 30000,
+            halfOpenSuccessThreshold: config.halfOpenSuccessThreshold ?? 1,
+            onStateChange: config.onStateChange ?? (() => { }),
+        };
+    }
+    /**
+     * Check if a request can be executed
+     *
+     * @returns true if request should proceed, false if circuit is OPEN
+     */
+    canExecute() {
+        this.totalRequests++;
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                return true;
+            case CircuitState.OPEN:
+                // Check if reset timeout has elapsed
+                if (this.shouldAttemptReset()) {
+                    this.transitionTo(CircuitState.HALF_OPEN);
+                    return true;
+                }
+                this.rejectedRequests++;
+                return false;
+            case CircuitState.HALF_OPEN:
+                // Allow limited requests in HALF_OPEN state
+                return true;
+            default:
+                // Should never reach here
+                return false;
+        }
+    }
+    /**
+     * Record a successful operation
+     *
+     * Resets failure count and may transition circuit to CLOSED state
+     */
+    recordSuccess() {
+        this.lastSuccessTime = Date.now();
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                // Reset failure count on success
+                this.failureCount = 0;
+                break;
+            case CircuitState.HALF_OPEN:
+                this.successCount++;
+                if (this.successCount >= this.config.halfOpenSuccessThreshold) {
+                    this.transitionTo(CircuitState.CLOSED);
+                    this.failureCount = 0;
+                    this.successCount = 0;
+                }
+                break;
+            case CircuitState.OPEN:
+                // Should not receive success in OPEN state, but handle gracefully
+                console.warn(`[CircuitBreaker] Unexpected success in OPEN state for ${this.serverName}`);
+                break;
+        }
+    }
+    /**
+     * Record a failed operation
+     *
+     * Increments failure count and may transition circuit to OPEN state
+     */
+    recordFailure() {
+        this.lastFailureTime = Date.now();
+        this.failureCount++;
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                if (this.failureCount >= this.config.failureThreshold) {
+                    this.transitionTo(CircuitState.OPEN);
+                }
+                break;
+            case CircuitState.HALF_OPEN:
+                // Immediate transition to OPEN on failure during recovery test
+                this.transitionTo(CircuitState.OPEN);
+                this.successCount = 0;
+                break;
+            case CircuitState.OPEN:
+                // Already open, just update timestamp
+                break;
+        }
+    }
+    /**
+     * Get current circuit breaker state
+     *
+     * @returns Current state (CLOSED, OPEN, or HALF_OPEN)
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get circuit breaker metrics
+     *
+     * @returns Current metrics including state, failure count, etc.
+     */
+    getMetrics() {
+        return {
+            state: this.state,
+            failures: this.failureCount,
+            successes: this.successCount,
+            lastFailureTime: this.lastFailureTime,
+            lastSuccessTime: this.lastSuccessTime,
+            stateChangedAt: this.stateChangedAt,
+            totalRequests: this.totalRequests,
+            rejectedRequests: this.rejectedRequests,
+        };
+    }
+    /**
+     * Manually reset the circuit breaker to CLOSED state
+     *
+     * Use with caution - typically only for testing or administrative override
+     */
+    reset() {
+        this.transitionTo(CircuitState.CLOSED);
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.lastFailureTime = null;
+        this.lastSuccessTime = null;
+    }
+    /**
+     * Check if enough time has passed to attempt reset
+     *
+     * @returns true if reset timeout has elapsed
+     */
+    shouldAttemptReset() {
+        if (this.lastFailureTime === null) {
+            return false;
+        }
+        const timeSinceLastFailure = Date.now() - this.lastFailureTime;
+        return timeSinceLastFailure >= this.config.resetTimeout;
+    }
+    /**
+     * Transition to a new circuit state
+     *
+     * @param newState - Target state
+     */
+    transitionTo(newState) {
+        const oldState = this.state;
+        if (oldState === newState) {
+            return;
+        }
+        this.state = newState;
+        this.stateChangedAt = Date.now();
+        // Clear any existing reset timer
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
+        // Schedule reset timer for OPEN state
+        if (newState === CircuitState.OPEN) {
+            this.resetTimer = setTimeout(() => {
+                if (this.state === CircuitState.OPEN) {
+                    this.transitionTo(CircuitState.HALF_OPEN);
+                }
+            }, this.config.resetTimeout);
+        }
+        // Log state transition
+        console.log(`[CircuitBreaker] ${this.serverName}: ${oldState} → ${newState} ` +
+            `(failures: ${this.failureCount}, threshold: ${this.config.failureThreshold})`);
+        // Invoke callback
+        this.config.onStateChange(oldState, newState, this.serverName);
+    }
+    /**
+     * Clean up resources
+     *
+     * Call this when circuit breaker is no longer needed
+     */
+    destroy() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
+    }
+}
+/**
+ * Circuit Breaker Manager
+ *
+ * Manages multiple circuit breakers for different servers.
+ * Provides centralized monitoring and control.
+ */
+export class CircuitBreakerManager {
+    /**
+     * Create a new circuit breaker manager
+     *
+     * @param defaultConfig - Default configuration for all circuit breakers
+     */
+    constructor(defaultConfig = {}) {
+        this.breakers = new Map();
+        this.defaultConfig = defaultConfig;
+    }
+    /**
+     * Get or create a circuit breaker for a server
+     *
+     * @param serverName - Name of the server
+     * @param config - Optional server-specific configuration
+     * @returns Circuit breaker instance
+     */
+    getBreaker(serverName, config) {
+        let breaker = this.breakers.get(serverName);
+        if (!breaker) {
+            const finalConfig = { ...this.defaultConfig, ...config };
+            breaker = new CircuitBreaker(serverName, finalConfig);
+            this.breakers.set(serverName, breaker);
+        }
+        return breaker;
+    }
+    /**
+     * Get all circuit breakers
+     *
+     * @returns Map of server names to circuit breakers
+     */
+    getAllBreakers() {
+        return new Map(this.breakers);
+    }
+    /**
+     * Get aggregated metrics for all circuit breakers
+     *
+     * @returns Array of metrics for all servers
+     */
+    getAllMetrics() {
+        const results = [];
+        for (const [serverName, breaker] of this.breakers) {
+            results.push({
+                serverName,
+                metrics: breaker.getMetrics(),
+            });
+        }
+        return results;
+    }
+    /**
+     * Reset a specific circuit breaker
+     *
+     * @param serverName - Name of the server
+     */
+    reset(serverName) {
+        const breaker = this.breakers.get(serverName);
+        if (breaker) {
+            breaker.reset();
+        }
+    }
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+    /**
+     * Clean up all circuit breakers
+     */
+    destroy() {
+        for (const breaker of this.breakers.values()) {
+            breaker.destroy();
+        }
+        this.breakers.clear();
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/packages/core/dist/server/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/server/circuit-breaker.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/server/client-detection.d.ts

@@ -0,0 +1,40 @@
+/**
+ * v1.1.8: Client Detection Module
+ * Detects client type and capabilities from request headers
+ * Supports: Claude Code, Raycast, Grok, Gemini, GPT, Cursor, Continue, MCP Remote
+ */
+export type ClientType = 'claude-code' | 'raycast' | 'grok' | 'gemini' | 'openai' | 'cursor' | 'continue' | 'mcp-remote' | 'unknown';
+export interface ClientCapabilities {
+    type: ClientType;
+    name: string;
+    version?: string;
+    userAgent?: string;
+    detectedFrom: 'clientInfo' | 'x-mcp-client' | 'user-agent' | 'fallback';
+    features: {
+        batchRequests: boolean;
+        streaming: boolean;
+        schemaFormat: 'standard' | 'raycast' | 'minimal';
+        toolsListChanged: boolean;
+        maxToolsPerResponse: number;
+        nestedArguments: boolean;
+    };
+}
+/**
+ * Detect client from headers (with priority order)
+ * Priority: clientInfo > X-MCP-Client > User-Agent > fallback
+ */
+export declare function detectClientCapabilities(headers: {
+    'x-mcp-client'?: string;
+    'user-agent'?: string;
+    clientinfo?: string;
+    [key: string]: string | undefined;
+}): ClientCapabilities;
+/**
+ * Format client type for human-readable logging
+ */
+export declare function formatClientForLogging(clientType: ClientType): string;
+/**
+ * Test helper: Create mock headers for testing
+ */
+export declare function createMockHeaders(clientType: ClientType, version?: string): Record<string, string>;
+//# sourceMappingURL=client-detection.d.ts.map

package/packages/core/dist/server/client-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-detection.d.ts","sourceRoot":"","sources":["../../src/server/client-detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAErI,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;IACxE,QAAQ,EAAE;QACR,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;QACjD,gBAAgB,EAAE,OAAO,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AA2LD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,GAAG,kBAAkB,CA6CrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAcrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKlG"}

package/packages/core/dist/server/client-detection.js

@@ -0,0 +1,242 @@
+/**
+ * v1.1.8: Client Detection Module
+ * Detects client type and capabilities from request headers
+ * Supports: Claude Code, Raycast, Grok, Gemini, GPT, Cursor, Continue, MCP Remote
+ */
+/**
+ * Detect client type from User-Agent string
+ */
+function parseUserAgent(userAgent) {
+    if (!userAgent)
+        return null;
+    const ua = userAgent.toLowerCase();
+    // Claude Code detection
+    if (ua.includes('claude-code') || ua.includes('claude-ai') || ua.includes('anthropic')) {
+        return 'claude-code';
+    }
+    // Raycast detection
+    if (ua.includes('raycast')) {
+        return 'raycast';
+    }
+    // Grok detection
+    if (ua.includes('grok') || ua.includes('x-grok')) {
+        return 'grok';
+    }
+    // Gemini detection
+    if (ua.includes('gemini') || ua.includes('google-gemini')) {
+        return 'gemini';
+    }
+    // OpenAI/GPT detection
+    if (ua.includes('chatgpt') || ua.includes('openai') || ua.includes('gpt')) {
+        return 'openai';
+    }
+    // Cursor detection
+    if (ua.includes('cursor') || ua.includes('cursor-ai')) {
+        return 'cursor';
+    }
+    // Continue detection
+    if (ua.includes('continue') || ua.includes('continue-dev')) {
+        return 'continue';
+    }
+    // MCP Remote detection
+    if (ua.includes('mcp-remote') || ua.includes('mcp-client')) {
+        return 'mcp-remote';
+    }
+    return null;
+}
+/**
+ * Normalize client type string
+ */
+function normalizeClientType(clientType) {
+    const normalized = clientType.toLowerCase().trim();
+    switch (normalized) {
+        case 'claude-code':
+        case 'claude':
+        case 'claude-ai':
+            return 'claude-code';
+        case 'raycast':
+            return 'raycast';
+        case 'grok':
+        case 'x-grok':
+            return 'grok';
+        case 'gemini':
+        case 'google-gemini':
+            return 'gemini';
+        case 'openai':
+        case 'gpt':
+        case 'chatgpt':
+            return 'openai';
+        case 'cursor':
+        case 'cursor-ai':
+            return 'cursor';
+        case 'continue':
+        case 'continue-dev':
+            return 'continue';
+        case 'mcp-remote':
+        case 'mcp-client':
+            return 'mcp-remote';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Get client capabilities based on detected type
+ */
+function getClientCapabilities(clientType) {
+    switch (clientType) {
+        case 'claude-code':
+            return {
+                batchRequests: true,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 500,
+                nestedArguments: true
+            };
+        case 'raycast':
+            return {
+                batchRequests: false,
+                streaming: false,
+                schemaFormat: 'raycast',
+                toolsListChanged: false,
+                maxToolsPerResponse: 50,
+                nestedArguments: false
+            };
+        case 'grok':
+            return {
+                batchRequests: true,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 300,
+                nestedArguments: true
+            };
+        case 'gemini':
+            return {
+                batchRequests: false,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 200,
+                nestedArguments: true
+            };
+        case 'openai':
+            return {
+                batchRequests: true,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 400,
+                nestedArguments: true
+            };
+        case 'cursor':
+            return {
+                batchRequests: true,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 300,
+                nestedArguments: true
+            };
+        case 'continue':
+            return {
+                batchRequests: false,
+                streaming: true,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 150,
+                nestedArguments: true
+            };
+        case 'mcp-remote':
+            return {
+                batchRequests: true,
+                streaming: false,
+                schemaFormat: 'standard',
+                toolsListChanged: true,
+                maxToolsPerResponse: 500,
+                nestedArguments: true
+            };
+        default:
+            return {
+                batchRequests: false,
+                streaming: false,
+                schemaFormat: 'standard',
+                toolsListChanged: false,
+                maxToolsPerResponse: 100,
+                nestedArguments: false
+            };
+    }
+}
+/**
+ * Detect client from headers (with priority order)
+ * Priority: clientInfo > X-MCP-Client > User-Agent > fallback
+ */
+export function detectClientCapabilities(headers) {
+    let clientType = 'unknown';
+    let detectedFrom = 'fallback';
+    let version;
+    let userAgent = headers['user-agent'];
+    // Priority 1: clientInfo (Claude Code specific)
+    if (headers.clientinfo) {
+        try {
+            const clientInfo = JSON.parse(headers.clientinfo);
+            if (clientInfo.type) {
+                clientType = normalizeClientType(clientInfo.type);
+                detectedFrom = 'clientInfo';
+                version = clientInfo.version;
+            }
+        }
+        catch (e) {
+            // Fallback to next detection method
+        }
+    }
+    // Priority 2: X-MCP-Client header
+    if (detectedFrom === 'fallback' && headers['x-mcp-client']) {
+        clientType = normalizeClientType(headers['x-mcp-client']);
+        detectedFrom = 'x-mcp-client';
+    }
+    // Priority 3: User-Agent header
+    if (detectedFrom === 'fallback' && userAgent) {
+        const detected = parseUserAgent(userAgent);
+        if (detected) {
+            clientType = detected;
+            detectedFrom = 'user-agent';
+        }
+    }
+    const features = getClientCapabilities(clientType);
+    return {
+        type: clientType,
+        name: formatClientForLogging(clientType),
+        version,
+        userAgent,
+        detectedFrom,
+        features
+    };
+}
+/**
+ * Format client type for human-readable logging
+ */
+export function formatClientForLogging(clientType) {
+    const names = {
+        'claude-code': 'Claude Code',
+        'raycast': 'Raycast',
+        'grok': 'Grok',
+        'gemini': 'Gemini',
+        'openai': 'OpenAI/GPT',
+        'cursor': 'Cursor',
+        'continue': 'Continue',
+        'mcp-remote': 'MCP Remote',
+        'unknown': 'Unknown Client'
+    };
+    return names[clientType];
+}
+/**
+ * Test helper: Create mock headers for testing
+ */
+export function createMockHeaders(clientType, version) {
+    return {
+        'x-mcp-client': clientType,
+        'user-agent': `MockClient/${version || '1.0'} ${clientType}/1.0`
+    };
+}
+//# sourceMappingURL=client-detection.js.map

package/packages/core/dist/server/client-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/server/client-detection.ts"],"names":[],"mappings":"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"}