@sudocode-ai/local-server 0.1.0 → 0.1.2

package/dist/execution/resilience/circuit-breaker.js

@@ -0,0 +1,291 @@
+/**
+ * Circuit Breaker Implementation
+ *
+ * Implements the circuit breaker pattern for preventing cascading failures.
+ * Tracks failures and successes, automatically opening when thresholds are
+ * exceeded and recovering through half-open state.
+ *
+ * @module execution/resilience/circuit-breaker
+ */
+/**
+ * CircuitBreakerManager - Manages multiple circuit breakers
+ *
+ * Maintains a collection of circuit breakers, typically one per task type
+ * or service. Provides methods for checking state, recording outcomes,
+ * and managing circuit lifecycle.
+ *
+ * @example
+ * ```typescript
+ * const manager = new CircuitBreakerManager();
+ * const breaker = manager.getOrCreate('issue-executor', {
+ *   failureThreshold: 5,
+ *   successThreshold: 2,
+ *   timeout: 60000,
+ * });
+ *
+ * if (manager.canExecute('issue-executor')) {
+ *   // Execute task
+ *   const success = await executeTask();
+ *   if (success) {
+ *     manager.recordSuccess('issue-executor');
+ *   } else {
+ *     manager.recordFailure('issue-executor', new Error('Task failed'));
+ *   }
+ * }
+ * ```
+ */
+export class CircuitBreakerManager {
+    breakers = new Map();
+    /**
+     * Get an existing circuit breaker by name
+     *
+     * @param name - Circuit breaker name
+     * @returns Circuit breaker or null if not found
+     */
+    get(name) {
+        return this.breakers.get(name) || null;
+    }
+    /**
+     * Get or create a circuit breaker
+     *
+     * If a circuit breaker with the given name exists, returns it.
+     * Otherwise creates a new one with the provided configuration.
+     *
+     * @param name - Circuit breaker name (typically task type)
+     * @param config - Configuration for new circuit breaker
+     * @returns Circuit breaker instance
+     */
+    getOrCreate(name, config = {
+        failureThreshold: 5,
+        successThreshold: 2,
+        timeout: 60000,
+    }) {
+        let breaker = this.breakers.get(name);
+        if (!breaker) {
+            breaker = {
+                name,
+                state: 'closed',
+                config,
+                metrics: {
+                    totalRequests: 0,
+                    failedRequests: 0,
+                    successfulRequests: 0,
+                },
+            };
+            this.breakers.set(name, breaker);
+        }
+        return breaker;
+    }
+    /**
+     * Check if a circuit breaker allows execution
+     *
+     * Returns false if circuit is open and timeout hasn't elapsed yet.
+     * Returns true for closed and half-open states.
+     *
+     * @param name - Circuit breaker name
+     * @returns True if execution is allowed
+     */
+    canExecute(name) {
+        const breaker = this.breakers.get(name);
+        if (!breaker) {
+            return true; // No breaker means no restriction
+        }
+        if (breaker.state === 'open') {
+            // Check if timeout has elapsed to transition to half-open
+            if (this.shouldTransitionToHalfOpen(breaker)) {
+                breaker.state = 'half-open';
+                return true;
+            }
+            return false;
+        }
+        return true; // closed or half-open allows execution
+    }
+    /**
+     * Record a successful execution
+     *
+     * Updates metrics and may transition circuit from half-open to closed
+     * if success threshold is met.
+     *
+     * @param name - Circuit breaker name
+     */
+    recordSuccess(name) {
+        const breaker = this.breakers.get(name);
+        if (!breaker) {
+            return;
+        }
+        breaker.metrics.totalRequests++;
+        breaker.metrics.successfulRequests++;
+        breaker.metrics.lastSuccessTime = new Date();
+        // If in half-open state, check if we should close
+        if (breaker.state === 'half-open') {
+            // Count recent successes (simplified: use total for now)
+            // In production, you'd track a sliding window of recent attempts
+            const recentSuccesses = this.getConsecutiveSuccesses(breaker);
+            if (recentSuccesses >= breaker.config.successThreshold) {
+                breaker.state = 'closed';
+                breaker.metrics.failedRequests = 0; // Reset failure count
+            }
+        }
+    }
+    /**
+     * Record a failed execution
+     *
+     * Updates metrics and may transition circuit from closed/half-open to open
+     * if failure threshold is met.
+     *
+     * @param name - Circuit breaker name
+     * @param error - Error that occurred
+     */
+    recordFailure(name, error) {
+        const breaker = this.breakers.get(name);
+        if (!breaker) {
+            return;
+        }
+        void error; // Error logged but not used in current implementation
+        breaker.metrics.totalRequests++;
+        breaker.metrics.failedRequests++;
+        breaker.metrics.lastFailureTime = new Date();
+        // Check if we should open the circuit
+        if (breaker.state === 'closed') {
+            if (breaker.metrics.failedRequests >= breaker.config.failureThreshold) {
+                breaker.state = 'open';
+            }
+        }
+        else if (breaker.state === 'half-open') {
+            // Any failure in half-open state reopens the circuit
+            breaker.state = 'open';
+        }
+    }
+    /**
+     * Reset a circuit breaker to closed state
+     *
+     * Clears all failure counts and returns circuit to closed state.
+     * Useful for manual recovery or after fixing underlying issues.
+     *
+     * @param name - Circuit breaker name
+     */
+    reset(name) {
+        const breaker = this.breakers.get(name);
+        if (!breaker) {
+            return;
+        }
+        breaker.state = 'closed';
+        breaker.metrics.failedRequests = 0;
+        breaker.metrics.successfulRequests = 0;
+    }
+    /**
+     * Get all circuit breakers
+     *
+     * @returns Map of circuit breaker name to breaker instance
+     */
+    getAll() {
+        return new Map(this.breakers);
+    }
+    /**
+     * Check if enough time has passed to transition from open to half-open
+     *
+     * @param breaker - Circuit breaker to check
+     * @returns True if timeout has elapsed
+     * @private
+     */
+    shouldTransitionToHalfOpen(breaker) {
+        if (!breaker.metrics.lastFailureTime) {
+            return true;
+        }
+        const timeSinceFailure = Date.now() - breaker.metrics.lastFailureTime.getTime();
+        return timeSinceFailure >= breaker.config.timeout;
+    }
+    /**
+     * Get count of consecutive successes
+     *
+     * In a production implementation, this would track a sliding window
+     * of recent attempts. For simplicity, we use total successful requests.
+     *
+     * @param breaker - Circuit breaker to check
+     * @returns Number of consecutive successes
+     * @private
+     */
+    getConsecutiveSuccesses(breaker) {
+        // Simplified: In production, track recent attempts in a circular buffer
+        // For now, use successful requests as a proxy
+        return breaker.metrics.successfulRequests;
+    }
+}
+/**
+ * Create a new circuit breaker instance
+ *
+ * Helper function to create a properly configured circuit breaker.
+ *
+ * @param name - Circuit breaker name
+ * @param config - Circuit breaker configuration
+ * @returns New circuit breaker instance
+ *
+ * @example
+ * ```typescript
+ * const breaker = createCircuitBreaker('api-calls', {
+ *   failureThreshold: 10,
+ *   successThreshold: 3,
+ *   timeout: 30000,
+ * });
+ * ```
+ */
+export function createCircuitBreaker(name, config = {
+    failureThreshold: 5,
+    successThreshold: 2,
+    timeout: 60000,
+}) {
+    return {
+        name,
+        state: 'closed',
+        config,
+        metrics: {
+            totalRequests: 0,
+            failedRequests: 0,
+            successfulRequests: 0,
+        },
+    };
+}
+/**
+ * Check if a circuit breaker is in a specific state
+ *
+ * @param breaker - Circuit breaker to check
+ * @param state - State to check for
+ * @returns True if breaker is in the specified state
+ */
+export function isInState(breaker, state) {
+    return breaker.state === state;
+}
+/**
+ * Get the current state of a circuit breaker
+ *
+ * @param breaker - Circuit breaker to check
+ * @returns Current state
+ */
+export function getState(breaker) {
+    return breaker.state;
+}
+/**
+ * Calculate failure rate for a circuit breaker
+ *
+ * @param breaker - Circuit breaker to analyze
+ * @returns Failure rate (0-1) or 0 if no requests
+ */
+export function getFailureRate(breaker) {
+    if (breaker.metrics.totalRequests === 0) {
+        return 0;
+    }
+    return breaker.metrics.failedRequests / breaker.metrics.totalRequests;
+}
+/**
+ * Calculate success rate for a circuit breaker
+ *
+ * @param breaker - Circuit breaker to analyze
+ * @returns Success rate (0-1) or 0 if no requests
+ */
+export function getSuccessRate(breaker) {
+    if (breaker.metrics.totalRequests === 0) {
+        return 0;
+    }
+    return breaker.metrics.successfulRequests / breaker.metrics.totalRequests;
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/execution/resilience/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../src/execution/resilience/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,qBAAqB;IACxB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAErD;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CACT,IAAY,EACZ,SAAmC;QACjC,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK;KACf;QAED,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG;gBACR,IAAI;gBACJ,KAAK,EAAE,QAAQ;gBACf,MAAM;gBACN,OAAO,EAAE;oBACP,aAAa,EAAE,CAAC;oBAChB,cAAc,EAAE,CAAC;oBACjB,kBAAkB,EAAE,CAAC;iBACtB;aACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,CAAC,kCAAkC;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC7B,0DAA0D;YAC1D,IAAI,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,CAAC,uCAAuC;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7C,kDAAkD;QAClD,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAClC,yDAAyD;YACzD,iEAAiE;YACjE,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YAE9D,IAAI,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACvD,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACzB,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,sBAAsB;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,IAAY,EAAE,KAAY;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,KAAK,KAAK,CAAC,CAAC,sDAAsD;QAElE,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7C,sCAAsC;QACtC,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACtE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;YACzB,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACzC,qDAAqD;YACrD,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAY;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;QACzB,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,kBAAkB,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACK,0BAA0B,CAAC,OAAuB;QACxD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,gBAAgB,GACpB,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAEzD,OAAO,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IACpD,CAAC;IAED;;;;;;;;;OASG;IACK,uBAAuB,CAAC,OAAuB;QACrD,wEAAwE;QACxE,8CAA8C;QAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC5C,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,SAAmC;IACjC,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,CAAC;IACnB,OAAO,EAAE,KAAK;CACf;IAED,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,QAAQ;QACf,MAAM;QACN,OAAO,EAAE;YACP,aAAa,EAAE,CAAC;YAChB,cAAc,EAAE,CAAC;YACjB,kBAAkB,EAAE,CAAC;SACtB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,OAAuB,EACvB,KAAmB;IAEnB,OAAO,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAuB;IAC9C,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;AAC5E,CAAC"}

package/dist/execution/resilience/executor.js

@@ -0,0 +1,10 @@
+/**
+ * Resilient Executor Interface
+ *
+ * Core abstraction for resilient task execution. Provides methods for
+ * executing tasks with retry logic, circuit breakers, and fault tolerance.
+ *
+ * @module execution/resilience/executor
+ */
+export {};
+//# sourceMappingURL=executor.js.map

package/dist/execution/resilience/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/execution/resilience/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/execution/resilience/index.js

@@ -0,0 +1,15 @@
+/**
+ * Resilience Layer Exports
+ *
+ * Layer 3: Task Execution Layer - Resilience & Retry
+ *
+ * @module execution/resilience
+ */
+export { DEFAULT_RETRY_POLICY } from './types.js';
+// Implementation
+export { ResilientExecutor } from './resilient-executor.js';
+// Retry utilities
+export { calculateBackoff, isRetryableError, isRetryableExitCode, isRetryableResult, sleep, createAttempt, calculateTotalRetryDelay, } from './retry.js';
+// Circuit breaker
+export { CircuitBreakerManager, createCircuitBreaker, isInState, getState, getFailureRate, getSuccessRate, } from './circuit-breaker.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/execution/resilience/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKlD,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,EACL,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/execution/resilience/resilient-executor.js

@@ -0,0 +1,261 @@
+/**
+ * Resilient Executor Implementation
+ *
+ * Implements resilient task execution with retry logic and circuit breakers.
+ * Wraps the Engine Layer with fault tolerance mechanisms.
+ *
+ * @module execution/resilience/resilient-executor
+ */
+import { CircuitBreakerManager } from "./circuit-breaker.js";
+import { calculateBackoff, isRetryableResult, sleep, createAttempt, } from "./retry.js";
+import { DEFAULT_RETRY_POLICY } from "./types.js";
+/**
+ * ResilientExecutor - Main implementation of resilient task execution
+ *
+ * Provides retry logic and circuit breaker protection for task execution.
+ * Wraps an IExecutionEngine with fault tolerance mechanisms.
+ *
+ * @example
+ * ```typescript
+ * const engine = new SimpleExecutionEngine(processManager);
+ * const executor = new ResilientExecutor(engine);
+ *
+ * const task: ExecutionTask = {
+ *   id: 'task-1',
+ *   type: 'issue',
+ *   prompt: 'Fix the bug in authentication',
+ *   workDir: '/path/to/project',
+ *   priority: 0,
+ *   dependencies: [],
+ *   createdAt: new Date(),
+ *   config: {},
+ * };
+ *
+ * const result = await executor.executeTask(task);
+ * console.log(`Completed after ${result.totalAttempts} attempts`);
+ * ```
+ */
+export class ResilientExecutor {
+    _engine;
+    _circuitManager;
+    _defaultPolicy;
+    _metrics;
+    // Event handlers
+    _retryHandlers = [];
+    _circuitOpenHandlers = [];
+    constructor(engine, defaultPolicy = DEFAULT_RETRY_POLICY) {
+        this._engine = engine;
+        this._circuitManager = new CircuitBreakerManager();
+        this._defaultPolicy = defaultPolicy;
+        this._metrics = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            averageAttemptsToSuccess: 0,
+            circuitBreakers: new Map(),
+        };
+    }
+    /**
+     * Execute a single task with retry and circuit breaker protection
+     */
+    async executeTask(task, policy) {
+        const retryPolicy = policy || this._defaultPolicy;
+        const circuitBreakerName = task.type; // Use task type as circuit breaker name
+        const attempts = [];
+        // Get or create circuit breaker for this task type
+        const breaker = this._circuitManager.getOrCreate(circuitBreakerName, {
+            failureThreshold: 5,
+            successThreshold: 2,
+            timeout: 60000,
+        });
+        // Attempt execution with retries
+        for (let attemptNumber = 1; attemptNumber <= retryPolicy.maxAttempts; attemptNumber++) {
+            // Check circuit breaker before execution
+            if (!this._circuitManager.canExecute(circuitBreakerName)) {
+                // Call circuit open handlers
+                this._circuitOpenHandlers.forEach((handler) => {
+                    handler(circuitBreakerName, breaker);
+                });
+                // Return result indicating circuit breaker triggered
+                const circuitOpenResult = {
+                    taskId: task.id,
+                    executionId: "circuit-breaker-open",
+                    success: false,
+                    exitCode: -1,
+                    output: "",
+                    error: `Circuit breaker is open for ${circuitBreakerName}`,
+                    startedAt: new Date(),
+                    completedAt: new Date(),
+                    duration: 0,
+                    attempts: [],
+                    totalAttempts: 0,
+                    finalAttempt: createAttempt(0, false, {
+                        error: new Error(`Circuit breaker is open for ${circuitBreakerName}`),
+                    }),
+                    circuitBreakerTriggered: true,
+                };
+                return circuitOpenResult;
+            }
+            const attemptStart = new Date();
+            try {
+                // Submit task to engine and wait for result
+                const taskId = await this._engine.submitTask(task);
+                const result = await this._engine.waitForTask(taskId);
+                const attemptDuration = Date.now() - attemptStart.getTime();
+                // Check if execution was successful
+                if (result.success) {
+                    // Success! Record in circuit breaker and return
+                    this._circuitManager.recordSuccess(circuitBreakerName);
+                    const successAttempt = createAttempt(attemptNumber, true, {
+                        exitCode: result.exitCode,
+                        duration: attemptDuration,
+                    });
+                    attempts.push(successAttempt);
+                    // Update metrics for successful retry
+                    if (attemptNumber > 1) {
+                        this._metrics.successfulRetries++;
+                        this._updateAverageAttempts(attemptNumber);
+                    }
+                    return this._createResilientResult(result, attempts);
+                }
+                // Execution completed but failed - check if retryable
+                const isRetryable = isRetryableResult(result, retryPolicy);
+                const willRetry = isRetryable && attemptNumber < retryPolicy.maxAttempts;
+                const failureAttempt = createAttempt(attemptNumber, false, {
+                    error: new Error(result.error || "Task failed"),
+                    exitCode: result.exitCode,
+                    duration: attemptDuration,
+                    willRetry,
+                });
+                if (willRetry) {
+                    const backoffDelay = calculateBackoff(attemptNumber + 1, retryPolicy.backoff);
+                    failureAttempt.nextRetryAt = new Date(Date.now() + backoffDelay);
+                    // Call retry attempt handlers
+                    this._retryHandlers.forEach((handler) => {
+                        handler(task.id, failureAttempt);
+                    });
+                    this._metrics.totalRetries++;
+                    attempts.push(failureAttempt);
+                    // Wait before retry
+                    await sleep(backoffDelay);
+                    continue;
+                }
+                // Not retryable or max attempts reached - record failure
+                attempts.push(failureAttempt);
+                this._circuitManager.recordFailure(circuitBreakerName, new Error(result.error || "Task failed"));
+                // Update metrics for failed retries
+                // Count all retry attempts in this failed task
+                if (attemptNumber > 1) {
+                    this._metrics.failedRetries += attemptNumber - 1;
+                }
+                return this._createResilientResult(result, attempts);
+            }
+            catch (error) {
+                // Engine execution error (not a task failure)
+                const attemptDuration = Date.now() - attemptStart.getTime();
+                const err = error instanceof Error ? error : new Error(String(error));
+                const isRetryable = retryPolicy.retryableErrors.some((pattern) => err.message.includes(pattern));
+                const willRetry = isRetryable && attemptNumber < retryPolicy.maxAttempts;
+                const errorAttempt = createAttempt(attemptNumber, false, {
+                    error: err,
+                    duration: attemptDuration,
+                    willRetry,
+                });
+                if (willRetry) {
+                    const backoffDelay = calculateBackoff(attemptNumber + 1, retryPolicy.backoff);
+                    errorAttempt.nextRetryAt = new Date(Date.now() + backoffDelay);
+                    // Call retry attempt handlers
+                    this._retryHandlers.forEach((handler) => {
+                        handler(task.id, errorAttempt);
+                    });
+                    this._metrics.totalRetries++;
+                    attempts.push(errorAttempt);
+                    // Wait before retry
+                    await sleep(backoffDelay);
+                    continue;
+                }
+                // Not retryable or max attempts reached
+                attempts.push(errorAttempt);
+                this._circuitManager.recordFailure(circuitBreakerName, err);
+                // Update metrics for failed retries
+                // Count all retry attempts in this failed task
+                if (attemptNumber > 1) {
+                    this._metrics.failedRetries += attemptNumber - 1;
+                }
+                throw err;
+            }
+        }
+        // Should never reach here, but TypeScript needs it
+        throw new Error("Unexpected state: exceeded max attempts without return");
+    }
+    /**
+     * Execute multiple tasks with retry and circuit breaker protection
+     */
+    async executeTasks(tasks, policy) {
+        // Execute all tasks in parallel
+        const promises = tasks.map((task) => this.executeTask(task, policy));
+        return Promise.all(promises);
+    }
+    /**
+     * Get circuit breaker by name
+     */
+    getCircuitBreaker(name) {
+        return this._circuitManager.get(name);
+    }
+    /**
+     * Reset a circuit breaker to closed state
+     */
+    resetCircuitBreaker(name) {
+        this._circuitManager.reset(name);
+    }
+    /**
+     * Get aggregate retry metrics
+     */
+    getRetryMetrics() {
+        // Update circuit breakers in metrics
+        this._metrics.circuitBreakers = this._circuitManager.getAll();
+        // Return defensive copy
+        return {
+            ...this._metrics,
+            circuitBreakers: new Map(this._metrics.circuitBreakers),
+        };
+    }
+    /**
+     * Register handler for retry attempt events
+     */
+    onRetryAttempt(handler) {
+        this._retryHandlers.push(handler);
+    }
+    /**
+     * Register handler for circuit breaker open events
+     */
+    onCircuitOpen(handler) {
+        this._circuitOpenHandlers.push(handler);
+    }
+    /**
+     * Helper to create ResilientExecutionResult from engine result
+     * @private
+     */
+    _createResilientResult(result, attempts) {
+        const finalAttempt = attempts[attempts.length - 1];
+        return {
+            ...result,
+            attempts,
+            totalAttempts: attempts.length,
+            finalAttempt,
+            failureReason: result.success ? undefined : result.error,
+        };
+    }
+    /**
+     * Helper to update average attempts to success metric
+     * @private
+     */
+    _updateAverageAttempts(attemptCount) {
+        const totalSuccessful = this._metrics.successfulRetries;
+        const previousAverage = this._metrics.averageAttemptsToSuccess;
+        const previousTotal = previousAverage * (totalSuccessful - 1);
+        this._metrics.averageAttemptsToSuccess =
+            (previousTotal + attemptCount) / totalSuccessful;
+    }
+}
+//# sourceMappingURL=resilient-executor.js.map

package/dist/execution/resilience/resilient-executor.js.map

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