agentic-qe 1.9.4 → 2.1.0

package/dist/core/recovery/CircuitBreaker.js

@@ -0,0 +1,382 @@
+"use strict";
+/**
+ * Circuit Breaker Implementation
+ * Prevents cascading failures by breaking the circuit when error threshold is exceeded
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit is broken, requests fail immediately
+ * - HALF_OPEN: Testing if service has recovered
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerManager = exports.CircuitBreaker = exports.CircuitBreakerOpenError = exports.CircuitState = void 0;
+exports.getCircuitBreakerManager = getCircuitBreakerManager;
+exports.resetCircuitBreakerManager = resetCircuitBreakerManager;
+const events_1 = require("events");
+/**
+ * Circuit breaker states
+ */
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+/**
+ * Circuit Breaker Error
+ */
+class CircuitBreakerOpenError extends Error {
+    constructor(circuitName, state) {
+        super(`Circuit breaker '${circuitName}' is ${state}`);
+        this.circuitName = circuitName;
+        this.state = state;
+        this.name = 'CircuitBreakerOpenError';
+    }
+}
+exports.CircuitBreakerOpenError = CircuitBreakerOpenError;
+/**
+ * Circuit Breaker Implementation
+ */
+class CircuitBreaker extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.state = CircuitState.CLOSED;
+        this.failures = [];
+        this.consecutiveSuccesses = 0;
+        this.resetTimer = null;
+        this.config = {
+            failureThreshold: 5,
+            successThreshold: 3,
+            resetTimeout: 30000, // 30 seconds
+            failureWindow: 60000, // 1 minute
+            ...config,
+        };
+        this.metrics = {
+            state: CircuitState.CLOSED,
+            failures: 0,
+            successes: 0,
+            consecutiveFailures: 0,
+            consecutiveSuccesses: 0,
+            totalRequests: 0,
+            totalFailures: 0,
+            totalSuccesses: 0,
+            lastFailureTime: null,
+            lastSuccessTime: null,
+            lastStateChange: new Date(),
+            openedCount: 0,
+        };
+    }
+    /**
+     * Execute an operation through the circuit breaker
+     */
+    async execute(operation) {
+        // Check if circuit allows request
+        if (!this.canExecute()) {
+            throw new CircuitBreakerOpenError(this.config.name, this.state);
+        }
+        this.metrics.totalRequests++;
+        try {
+            // Execute with optional timeout
+            const result = this.config.operationTimeout
+                ? await this.executeWithTimeout(operation, this.config.operationTimeout)
+                : await operation();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure(error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Check if circuit allows execution
+     */
+    canExecute() {
+        this.pruneOldFailures();
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                return true;
+            case CircuitState.OPEN:
+                return false;
+            case CircuitState.HALF_OPEN:
+                return true; // Allow test requests
+            default:
+                return false;
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get current metrics
+     */
+    getMetrics() {
+        this.pruneOldFailures();
+        return {
+            ...this.metrics,
+            state: this.state,
+            failures: this.failures.length,
+            consecutiveSuccesses: this.consecutiveSuccesses,
+        };
+    }
+    /**
+     * Manually reset circuit to CLOSED
+     */
+    reset() {
+        this.transitionTo(CircuitState.CLOSED);
+        this.failures = [];
+        this.consecutiveSuccesses = 0;
+        this.metrics.consecutiveFailures = 0;
+        this.clearResetTimer();
+        this.emit('reset', { name: this.config.name });
+    }
+    /**
+     * Manually open circuit
+     */
+    forceOpen() {
+        this.transitionTo(CircuitState.OPEN);
+        this.startResetTimer();
+        this.emit('force-open', { name: this.config.name });
+    }
+    /**
+     * Handle successful operation
+     */
+    onSuccess() {
+        this.metrics.totalSuccesses++;
+        this.metrics.successes++;
+        this.metrics.lastSuccessTime = new Date();
+        this.metrics.consecutiveFailures = 0;
+        this.consecutiveSuccesses++;
+        if (this.state === CircuitState.HALF_OPEN) {
+            if (this.consecutiveSuccesses >= this.config.successThreshold) {
+                this.transitionTo(CircuitState.CLOSED);
+                this.failures = [];
+                this.emit('close', {
+                    name: this.config.name,
+                    reason: 'Success threshold reached in HALF_OPEN',
+                });
+            }
+        }
+        this.emit('success', { name: this.config.name, state: this.state });
+    }
+    /**
+     * Handle failed operation
+     */
+    onFailure(error) {
+        this.metrics.totalFailures++;
+        this.metrics.lastFailureTime = new Date();
+        this.metrics.consecutiveFailures++;
+        this.consecutiveSuccesses = 0;
+        this.failures.push({
+            timestamp: Date.now(),
+            error,
+        });
+        this.emit('failure', {
+            name: this.config.name,
+            state: this.state,
+            error: error.message,
+        });
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Any failure in HALF_OPEN reopens circuit
+            this.transitionTo(CircuitState.OPEN);
+            this.startResetTimer();
+            this.emit('open', {
+                name: this.config.name,
+                reason: 'Failure in HALF_OPEN state',
+            });
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            this.pruneOldFailures();
+            if (this.failures.length >= this.config.failureThreshold) {
+                this.transitionTo(CircuitState.OPEN);
+                this.startResetTimer();
+                this.metrics.openedCount++;
+                this.emit('open', {
+                    name: this.config.name,
+                    reason: `Failure threshold (${this.config.failureThreshold}) exceeded`,
+                    failures: this.failures.length,
+                });
+            }
+        }
+    }
+    /**
+     * Transition to new state
+     */
+    transitionTo(newState) {
+        const oldState = this.state;
+        this.state = newState;
+        this.metrics.state = newState;
+        this.metrics.lastStateChange = new Date();
+        if (newState === CircuitState.HALF_OPEN) {
+            this.consecutiveSuccesses = 0;
+        }
+        this.emit('state-change', {
+            name: this.config.name,
+            from: oldState,
+            to: newState,
+        });
+    }
+    /**
+     * Start reset timer for OPEN -> HALF_OPEN transition
+     */
+    startResetTimer() {
+        this.clearResetTimer();
+        this.resetTimer = setTimeout(() => {
+            if (this.state === CircuitState.OPEN) {
+                this.transitionTo(CircuitState.HALF_OPEN);
+                this.emit('half-open', {
+                    name: this.config.name,
+                    reason: 'Reset timeout elapsed',
+                });
+            }
+        }, this.config.resetTimeout);
+    }
+    /**
+     * Clear reset timer
+     */
+    clearResetTimer() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
+    }
+    /**
+     * Remove failures outside the window
+     */
+    pruneOldFailures() {
+        const cutoff = Date.now() - this.config.failureWindow;
+        this.failures = this.failures.filter(f => f.timestamp > cutoff);
+    }
+    /**
+     * Execute operation with timeout
+     */
+    async executeWithTimeout(operation, timeout) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Operation timed out after ${timeout}ms`));
+            }, timeout);
+            operation()
+                .then(result => {
+                clearTimeout(timer);
+                resolve(result);
+            })
+                .catch(error => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.clearResetTimer();
+        this.removeAllListeners();
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+/**
+ * Circuit Breaker Manager for managing multiple circuit breakers
+ */
+class CircuitBreakerManager {
+    constructor(defaultConfig = {}) {
+        this.breakers = new Map();
+        this.defaultConfig = defaultConfig;
+    }
+    /**
+     * Get or create a circuit breaker
+     */
+    getBreaker(name, config) {
+        let breaker = this.breakers.get(name);
+        if (!breaker) {
+            breaker = new CircuitBreaker({
+                ...this.defaultConfig,
+                ...config,
+                name,
+            });
+            this.breakers.set(name, breaker);
+        }
+        return breaker;
+    }
+    /**
+     * Execute operation through named circuit breaker
+     */
+    async execute(name, operation) {
+        const breaker = this.getBreaker(name);
+        return breaker.execute(operation);
+    }
+    /**
+     * Get all circuit breaker metrics
+     */
+    getAllMetrics() {
+        const metrics = new Map();
+        for (const [name, breaker] of this.breakers) {
+            metrics.set(name, breaker.getMetrics());
+        }
+        return metrics;
+    }
+    /**
+     * Get summary of all circuit states
+     */
+    getSummary() {
+        let closed = 0, open = 0, halfOpen = 0;
+        for (const breaker of this.breakers.values()) {
+            switch (breaker.getState()) {
+                case CircuitState.CLOSED:
+                    closed++;
+                    break;
+                case CircuitState.OPEN:
+                    open++;
+                    break;
+                case CircuitState.HALF_OPEN:
+                    halfOpen++;
+                    break;
+            }
+        }
+        return { total: this.breakers.size, closed, open, halfOpen };
+    }
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+    /**
+     * Cleanup all circuit breakers
+     */
+    destroy() {
+        for (const breaker of this.breakers.values()) {
+            breaker.destroy();
+        }
+        this.breakers.clear();
+    }
+}
+exports.CircuitBreakerManager = CircuitBreakerManager;
+/**
+ * Default circuit breaker manager instance
+ */
+let defaultManager = null;
+/**
+ * Get default circuit breaker manager
+ */
+function getCircuitBreakerManager(config) {
+    if (!defaultManager) {
+        defaultManager = new CircuitBreakerManager(config);
+    }
+    return defaultManager;
+}
+/**
+ * Reset default manager (for testing)
+ */
+function resetCircuitBreakerManager() {
+    if (defaultManager) {
+        defaultManager.destroy();
+        defaultManager = null;
+    }
+}
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/core/recovery/CircuitBreaker.js.map

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

package/dist/core/recovery/RecoveryOrchestrator.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Recovery Orchestrator
+ * Coordinates error recovery across transport, memory, and orchestration systems
+ */
+import { EventEmitter } from 'events';
+import { CircuitState } from './CircuitBreaker.js';
+import { RetryConfig } from './RetryStrategy.js';
+/**
+ * Recovery strategy types
+ */
+export type RecoveryStrategyType = 'retry' | 'fallback' | 'circuit-break' | 'rollback' | 'graceful-degradation' | 'escalate';
+/**
+ * Component types that can be recovered
+ */
+export type RecoverableComponent = 'transport' | 'memory' | 'orchestration' | 'agent' | 'workflow' | 'database';
+/**
+ * Health status
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+/**
+ * Recovery action result
+ */
+export interface RecoveryActionResult {
+    success: boolean;
+    strategy: RecoveryStrategyType;
+    component: RecoverableComponent;
+    action: string;
+    duration: number;
+    error?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Component health info
+ */
+export interface ComponentHealth {
+    component: RecoverableComponent;
+    status: HealthStatus;
+    lastCheck: Date;
+    errorRate: number;
+    latencyP95: number;
+    circuitState?: CircuitState;
+    details?: Record<string, any>;
+}
+/**
+ * Recovery policy configuration
+ */
+export interface RecoveryPolicy {
+    /** Maximum recovery attempts per minute */
+    maxRecoveryRate: number;
+    /** Time to wait between recovery attempts */
+    cooldownPeriod: number;
+    /** When to escalate to manual intervention */
+    escalationThreshold: number;
+    /** Strategies in order of preference */
+    strategyOrder: RecoveryStrategyType[];
+    /** Component-specific overrides */
+    componentOverrides?: Partial<Record<RecoverableComponent, Partial<RecoveryPolicy>>>;
+}
+/**
+ * Recovery event
+ */
+export interface RecoveryEvent {
+    timestamp: Date;
+    component: RecoverableComponent;
+    strategy: RecoveryStrategyType;
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+/**
+ * Fallback handler type
+ */
+export type FallbackHandler<T> = () => Promise<T>;
+/**
+ * Health check function type
+ */
+export type HealthChecker = (component: RecoverableComponent) => Promise<ComponentHealth>;
+/**
+ * Recovery Orchestrator Implementation
+ */
+export declare class RecoveryOrchestrator extends EventEmitter {
+    private circuitBreakerManager;
+    private retryStrategies;
+    private fallbackHandlers;
+    private healthCheckers;
+    private recoveryHistory;
+    private componentHealth;
+    private policy;
+    private recoveryInProgress;
+    private lastRecoveryAttempts;
+    constructor(policy?: Partial<RecoveryPolicy>);
+    /**
+     * Execute operation with full recovery support
+     */
+    executeWithRecovery<T>(component: RecoverableComponent, operationId: string, operation: () => Promise<T>, options?: {
+        fallback?: FallbackHandler<T>;
+        retryConfig?: Partial<RetryConfig>;
+        bypassCircuitBreaker?: boolean;
+    }): Promise<T>;
+    /**
+     * Attempt automatic recovery for a component
+     */
+    attemptRecovery(component: RecoverableComponent, error: Error): Promise<RecoveryActionResult>;
+    /**
+     * Register fallback handler
+     */
+    registerFallback<T>(component: RecoverableComponent, operationId: string, handler: FallbackHandler<T>): void;
+    /**
+     * Register health checker
+     */
+    registerHealthChecker(component: RecoverableComponent, checker: HealthChecker): void;
+    /**
+     * Check health of all components
+     */
+    checkHealth(): Promise<Map<RecoverableComponent, ComponentHealth>>;
+    /**
+     * Get component health
+     */
+    getComponentHealth(component: RecoverableComponent): ComponentHealth | undefined;
+    /**
+     * Get recovery history
+     */
+    getRecoveryHistory(limit?: number): RecoveryEvent[];
+    /**
+     * Get recovery statistics
+     */
+    getStats(): {
+        totalRecoveries: number;
+        successfulRecoveries: number;
+        failedRecoveries: number;
+        successRate: number;
+        byComponent: Record<string, {
+            total: number;
+            successful: number;
+        }>;
+        byStrategy: Record<string, {
+            total: number;
+            successful: number;
+        }>;
+    };
+    /**
+     * Reset circuit breakers for a component
+     */
+    resetCircuitBreakers(component?: RecoverableComponent): void;
+    /**
+     * Initialize default retry strategies per component
+     */
+    private initializeDefaultStrategies;
+    /**
+     * Get retry strategy for component
+     */
+    private getRetryStrategy;
+    /**
+     * Get policy for component
+     */
+    private getComponentPolicy;
+    /**
+     * Execute a specific recovery strategy
+     */
+    private executeRecoveryStrategy;
+    /**
+     * Check if recovery can be attempted (rate limiting)
+     */
+    private canAttemptRecovery;
+    /**
+     * Record recovery attempt for rate limiting
+     */
+    private recordRecoveryAttempt;
+    /**
+     * Record recovery event
+     */
+    private recordRecoveryEvent;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Get default recovery orchestrator
+ */
+export declare function getRecoveryOrchestrator(policy?: Partial<RecoveryPolicy>): RecoveryOrchestrator;
+/**
+ * Reset default orchestrator (for testing)
+ */
+export declare function resetRecoveryOrchestrator(): void;
+//# sourceMappingURL=RecoveryOrchestrator.d.ts.map

package/dist/core/recovery/RecoveryOrchestrator.d.ts.map

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