agentic-qe 1.9.4 → 2.1.0

package/dist/core/recovery/RetryStrategy.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * Retry Strategy with Multiple Backoff Algorithms
+ * Provides configurable retry logic for transient failures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryStrategies = exports.RetryStrategy = void 0;
+exports.withRetry = withRetry;
+exports.createRetryable = createRetryable;
+/**
+ * Default retryable error patterns (transient failures)
+ */
+const DEFAULT_RETRYABLE_PATTERNS = [
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ETIMEDOUT',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+    'timeout',
+    'rate limit',
+    'too many requests',
+    '429',
+    '502',
+    '503',
+    '504',
+];
+/**
+ * Default non-retryable error patterns (permanent failures)
+ */
+const DEFAULT_NON_RETRYABLE_PATTERNS = [
+    '400',
+    '401',
+    '403',
+    '404',
+    '405',
+    '422',
+    'validation',
+    'invalid',
+    'unauthorized',
+    'forbidden',
+    'not found',
+];
+/**
+ * Retry Strategy Implementation
+ */
+class RetryStrategy {
+    constructor(config = {}) {
+        this.fibonacciCache = [1, 1];
+        this.config = {
+            maxAttempts: 3,
+            initialDelay: 1000,
+            maxDelay: 30000,
+            backoffType: 'exponential',
+            multiplier: 2,
+            jitter: true,
+            jitterFactor: 0.25,
+            retryableErrors: DEFAULT_RETRYABLE_PATTERNS,
+            nonRetryableErrors: DEFAULT_NON_RETRYABLE_PATTERNS,
+            ...config,
+        };
+    }
+    /**
+     * Execute operation with retry logic
+     */
+    async execute(operation) {
+        const context = {
+            attempt: 0,
+            totalAttempts: this.config.maxAttempts,
+            lastDelay: 0,
+            totalDelay: 0,
+            startTime: Date.now(),
+            errors: [],
+        };
+        const retryHistory = [];
+        while (context.attempt < this.config.maxAttempts) {
+            context.attempt++;
+            try {
+                const result = await operation();
+                return {
+                    success: true,
+                    result,
+                    attempts: context.attempt,
+                    totalDelay: context.totalDelay,
+                    retryHistory,
+                };
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                context.errors.push(err);
+                // Check if we should retry
+                if (!this.shouldRetry(err, context)) {
+                    return {
+                        success: false,
+                        error: err,
+                        attempts: context.attempt,
+                        totalDelay: context.totalDelay,
+                        retryHistory,
+                    };
+                }
+                // Check if we've exhausted attempts
+                if (context.attempt >= this.config.maxAttempts) {
+                    return {
+                        success: false,
+                        error: err,
+                        attempts: context.attempt,
+                        totalDelay: context.totalDelay,
+                        retryHistory,
+                    };
+                }
+                // Calculate delay
+                const delay = this.calculateDelay(context);
+                context.lastDelay = delay;
+                context.totalDelay += delay;
+                retryHistory.push({
+                    attempt: context.attempt,
+                    delay,
+                    error: err.message,
+                });
+                // Notify callback
+                if (this.config.onRetry) {
+                    this.config.onRetry(context.attempt, err, delay);
+                }
+                // Wait before retry
+                await this.sleep(delay);
+            }
+        }
+        // Should not reach here, but just in case
+        return {
+            success: false,
+            error: context.errors[context.errors.length - 1],
+            attempts: context.attempt,
+            totalDelay: context.totalDelay,
+            retryHistory,
+        };
+    }
+    /**
+     * Determine if error is retryable
+     */
+    shouldRetry(error, context) {
+        // Check custom function first
+        if (this.config.isRetryable) {
+            return this.config.isRetryable(error);
+        }
+        const errorStr = error.message.toLowerCase();
+        // Check non-retryable patterns (takes precedence)
+        if (this.config.nonRetryableErrors) {
+            for (const pattern of this.config.nonRetryableErrors) {
+                if (errorStr.includes(pattern.toLowerCase())) {
+                    return false;
+                }
+            }
+        }
+        // Check retryable patterns
+        if (this.config.retryableErrors) {
+            for (const pattern of this.config.retryableErrors) {
+                if (errorStr.includes(pattern.toLowerCase())) {
+                    return true;
+                }
+            }
+        }
+        // Default to retrying for unknown errors (safer for transient issues)
+        return true;
+    }
+    /**
+     * Calculate delay for next retry attempt
+     */
+    calculateDelay(context) {
+        let delay;
+        switch (this.config.backoffType) {
+            case 'constant':
+                delay = this.config.initialDelay;
+                break;
+            case 'linear':
+                delay = this.config.initialDelay * context.attempt;
+                break;
+            case 'exponential':
+                delay = this.config.initialDelay * Math.pow(this.config.multiplier, context.attempt - 1);
+                break;
+            case 'fibonacci':
+                delay = this.config.initialDelay * this.getFibonacci(context.attempt);
+                break;
+            case 'decorrelated-jitter':
+                // AWS-style decorrelated jitter
+                const prevDelay = context.lastDelay || this.config.initialDelay;
+                delay = Math.min(this.config.maxDelay, this.randomBetween(this.config.initialDelay, prevDelay * 3));
+                break;
+            default:
+                delay = this.config.initialDelay;
+        }
+        // Apply max delay cap
+        delay = Math.min(delay, this.config.maxDelay);
+        // Apply jitter if enabled (except for decorrelated-jitter which has built-in randomization)
+        if (this.config.jitter && this.config.backoffType !== 'decorrelated-jitter') {
+            delay = this.applyJitter(delay);
+        }
+        return Math.round(delay);
+    }
+    /**
+     * Apply jitter to delay
+     */
+    applyJitter(delay) {
+        const jitterRange = delay * this.config.jitterFactor;
+        const jitter = this.randomBetween(-jitterRange, jitterRange);
+        return Math.max(0, delay + jitter);
+    }
+    /**
+     * Get fibonacci number (cached for performance)
+     */
+    getFibonacci(n) {
+        while (this.fibonacciCache.length <= n) {
+            const len = this.fibonacciCache.length;
+            this.fibonacciCache.push(this.fibonacciCache[len - 1] + this.fibonacciCache[len - 2]);
+        }
+        return this.fibonacciCache[n - 1];
+    }
+    /**
+     * Random number between min and max
+     */
+    randomBetween(min, max) {
+        return min + Math.random() * (max - min);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.RetryStrategy = RetryStrategy;
+/**
+ * Retry decorator for async functions
+ */
+function withRetry(operation, config) {
+    const strategy = new RetryStrategy(config);
+    return strategy.execute(operation).then(result => {
+        if (result.success) {
+            return result.result;
+        }
+        throw result.error;
+    });
+}
+/**
+ * Create a retryable wrapper for a function
+ */
+function createRetryable(fn, config) {
+    const strategy = new RetryStrategy(config);
+    return (...args) => strategy.execute(() => fn(...args));
+}
+/**
+ * Predefined retry strategies for common use cases
+ */
+exports.RetryStrategies = {
+    /** Fast retry for quick transient failures */
+    fast: new RetryStrategy({
+        maxAttempts: 3,
+        initialDelay: 100,
+        maxDelay: 1000,
+        backoffType: 'exponential',
+        multiplier: 2,
+    }),
+    /** Standard retry for most operations */
+    standard: new RetryStrategy({
+        maxAttempts: 5,
+        initialDelay: 1000,
+        maxDelay: 30000,
+        backoffType: 'exponential',
+        multiplier: 2,
+        jitter: true,
+    }),
+    /** Aggressive retry for critical operations */
+    aggressive: new RetryStrategy({
+        maxAttempts: 10,
+        initialDelay: 500,
+        maxDelay: 60000,
+        backoffType: 'decorrelated-jitter',
+        jitter: true,
+    }),
+    /** Gentle retry for rate-limited APIs */
+    rateLimited: new RetryStrategy({
+        maxAttempts: 5,
+        initialDelay: 5000,
+        maxDelay: 120000,
+        backoffType: 'fibonacci',
+        jitter: true,
+    }),
+    /** Database retry for connection issues */
+    database: new RetryStrategy({
+        maxAttempts: 3,
+        initialDelay: 500,
+        maxDelay: 5000,
+        backoffType: 'exponential',
+        multiplier: 1.5,
+        jitter: true,
+        retryableErrors: ['SQLITE_BUSY', 'SQLITE_LOCKED', 'connection', 'timeout'],
+    }),
+    /** Network retry for HTTP calls */
+    network: new RetryStrategy({
+        maxAttempts: 4,
+        initialDelay: 1000,
+        maxDelay: 15000,
+        backoffType: 'exponential',
+        multiplier: 2,
+        jitter: true,
+    }),
+};
+//# sourceMappingURL=RetryStrategy.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Recovery Module - Error Recovery and Resilience
+ * Provides circuit breakers, retry strategies, and coordinated recovery
+ */
+export { CircuitBreaker, CircuitBreakerManager, CircuitState, CircuitBreakerConfig, CircuitBreakerMetrics, CircuitBreakerOpenError, getCircuitBreakerManager, resetCircuitBreakerManager, } from './CircuitBreaker.js';
+export { RetryStrategy, RetryConfig, RetryResult, RetryContext, BackoffType, withRetry, createRetryable, RetryStrategies, } from './RetryStrategy.js';
+export { RecoveryOrchestrator, RecoveryStrategyType, RecoverableComponent, HealthStatus, RecoveryActionResult, ComponentHealth, RecoveryPolicy, RecoveryEvent, getRecoveryOrchestrator, resetRecoveryOrchestrator, } from './RecoveryOrchestrator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/recovery/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC"}

package/dist/core/recovery/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Recovery Module - Error Recovery and Resilience
+ * Provides circuit breakers, retry strategies, and coordinated recovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetRecoveryOrchestrator = exports.getRecoveryOrchestrator = exports.RecoveryOrchestrator = exports.RetryStrategies = exports.createRetryable = exports.withRetry = exports.RetryStrategy = exports.resetCircuitBreakerManager = exports.getCircuitBreakerManager = exports.CircuitBreakerOpenError = exports.CircuitState = exports.CircuitBreakerManager = exports.CircuitBreaker = void 0;
+// Circuit Breaker
+var CircuitBreaker_js_1 = require("./CircuitBreaker.js");
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return CircuitBreaker_js_1.CircuitBreaker; } });
+Object.defineProperty(exports, "CircuitBreakerManager", { enumerable: true, get: function () { return CircuitBreaker_js_1.CircuitBreakerManager; } });
+Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return CircuitBreaker_js_1.CircuitState; } });
+Object.defineProperty(exports, "CircuitBreakerOpenError", { enumerable: true, get: function () { return CircuitBreaker_js_1.CircuitBreakerOpenError; } });
+Object.defineProperty(exports, "getCircuitBreakerManager", { enumerable: true, get: function () { return CircuitBreaker_js_1.getCircuitBreakerManager; } });
+Object.defineProperty(exports, "resetCircuitBreakerManager", { enumerable: true, get: function () { return CircuitBreaker_js_1.resetCircuitBreakerManager; } });
+// Retry Strategy
+var RetryStrategy_js_1 = require("./RetryStrategy.js");
+Object.defineProperty(exports, "RetryStrategy", { enumerable: true, get: function () { return RetryStrategy_js_1.RetryStrategy; } });
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return RetryStrategy_js_1.withRetry; } });
+Object.defineProperty(exports, "createRetryable", { enumerable: true, get: function () { return RetryStrategy_js_1.createRetryable; } });
+Object.defineProperty(exports, "RetryStrategies", { enumerable: true, get: function () { return RetryStrategy_js_1.RetryStrategies; } });
+// Recovery Orchestrator
+var RecoveryOrchestrator_js_1 = require("./RecoveryOrchestrator.js");
+Object.defineProperty(exports, "RecoveryOrchestrator", { enumerable: true, get: function () { return RecoveryOrchestrator_js_1.RecoveryOrchestrator; } });
+Object.defineProperty(exports, "getRecoveryOrchestrator", { enumerable: true, get: function () { return RecoveryOrchestrator_js_1.getRecoveryOrchestrator; } });
+Object.defineProperty(exports, "resetRecoveryOrchestrator", { enumerable: true, get: function () { return RecoveryOrchestrator_js_1.resetRecoveryOrchestrator; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/recovery/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,kBAAkB;AAClB,yDAS6B;AAR3B,mHAAA,cAAc,OAAA;AACd,0HAAA,qBAAqB,OAAA;AACrB,iHAAA,YAAY,OAAA;AAGZ,4HAAA,uBAAuB,OAAA;AACvB,6HAAA,wBAAwB,OAAA;AACxB,+HAAA,0BAA0B,OAAA;AAG5B,iBAAiB;AACjB,uDAS4B;AAR1B,iHAAA,aAAa,OAAA;AAKb,6GAAA,SAAS,OAAA;AACT,mHAAA,eAAe,OAAA;AACf,mHAAA,eAAe,OAAA;AAGjB,wBAAwB;AACxB,qEAWmC;AAVjC,+HAAA,oBAAoB,OAAA;AAQpB,kIAAA,uBAAuB,OAAA;AACvB,oIAAA,yBAAyB,OAAA"}

package/dist/core/skills/DependencyResolver.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Dependency Resolver for Skill Loading
+ * Handles skill dependency graphs with cycle detection and optimal load ordering
+ */
+import { SkillManifest } from './types.js';
+/**
+ * Dependency resolution result
+ */
+export interface DependencyResolution {
+    /** Skills in optimal load order (dependencies first) */
+    loadOrder: string[];
+    /** Dependency tree for visualization */
+    tree: DependencyNode;
+    /** Any circular dependencies detected */
+    cycles: string[][];
+    /** Skills that couldn't be resolved (missing dependencies) */
+    unresolved: {
+        skillId: string;
+        missing: string[];
+    }[];
+}
+/**
+ * Dependency tree node
+ */
+export interface DependencyNode {
+    id: string;
+    depth: number;
+    dependencies: DependencyNode[];
+}
+/**
+ * Resolution options
+ */
+export interface ResolverOptions {
+    /** Maximum dependency depth to prevent infinite recursion */
+    maxDepth: number;
+    /** Include optional dependencies */
+    includeOptional: boolean;
+    /** Strategy for handling cycles */
+    cycleStrategy: 'error' | 'warn' | 'break';
+}
+/**
+ * Skill Dependency Resolver
+ * Resolves skill dependencies with cycle detection and optimal ordering
+ */
+export declare class DependencyResolver {
+    private manifest;
+    private skillMap;
+    private options;
+    constructor(manifest: SkillManifest, options?: Partial<ResolverOptions>);
+    /**
+     * Resolve dependencies for a single skill
+     */
+    resolve(skillId: string): DependencyResolution;
+    /**
+     * Resolve dependencies for multiple skills
+     */
+    resolveMultiple(skillIds: string[]): DependencyResolution;
+    /**
+     * Get all skills that depend on a given skill (reverse dependencies)
+     */
+    getDependents(skillId: string): string[];
+    /**
+     * Get direct dependencies of a skill
+     */
+    getDirectDependencies(skillId: string): string[];
+    /**
+     * Get all transitive dependencies (full dependency closure)
+     */
+    getTransitiveDependencies(skillId: string): string[];
+    /**
+     * Check if adding a dependency would create a cycle
+     */
+    wouldCreateCycle(fromSkillId: string, toSkillId: string): boolean;
+    /**
+     * Build dependency tree recursively
+     */
+    private buildDependencyTree;
+    /**
+     * Topological sort for optimal load order (dependencies first)
+     */
+    private topologicalSort;
+    /**
+     * Deduplicate cycle arrays (same cycle may be detected from different starting points)
+     */
+    private deduplicateCycles;
+    /**
+     * Normalize cycle to start from smallest element for deduplication
+     */
+    private normalizeCycle;
+}
+/**
+ * Create a dependency resolver from manifest
+ */
+export declare function createDependencyResolver(manifest: SkillManifest, options?: Partial<ResolverOptions>): DependencyResolver;
+/**
+ * Visualize dependency tree as ASCII art
+ */
+export declare function visualizeDependencyTree(node: DependencyNode, prefix?: string): string;
+//# sourceMappingURL=DependencyResolver.d.ts.map

package/dist/core/skills/DependencyResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyResolver.d.ts","sourceRoot":"","sources":["../../../src/core/skills/DependencyResolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,IAAI,EAAE,cAAc,CAAC;IACrB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,8DAA8D;IAC9D,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,cAAc,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAAkB;gBAErB,QAAQ,EAAE,aAAa,EAAE,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM;IAW3E;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;IAI9C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,oBAAoB;IAmCzD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAYxC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKhD;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKpD;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAMjE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8E3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAmBvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,kBAAkB,CAEpB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAuBzF"}