claude-flow 2.7.0-alpha.13 → 2.7.0-alpha.14

package/dist/coordination/circuit-breaker.js

@@ -0,0 +1,301 @@
+/**
+ * Circuit breaker pattern for fault tolerance
+ */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half-open";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Circuit breaker for protecting against cascading failures
+ */
+export class CircuitBreaker {
+    name;
+    config;
+    logger;
+    eventBus;
+    state = CircuitState.CLOSED;
+    failures = 0;
+    successes = 0;
+    lastFailureTime;
+    lastSuccessTime;
+    nextAttempt;
+    halfOpenRequests = 0;
+    totalRequests = 0;
+    rejectedRequests = 0;
+    constructor(name, config, logger, eventBus) {
+        this.name = name;
+        this.config = config;
+        this.logger = logger;
+        this.eventBus = eventBus;
+    }
+    /**
+     * Execute a function with circuit breaker protection
+     */
+    async execute(fn) {
+        this.totalRequests++;
+        // Check if we should execute
+        if (!this.canExecute()) {
+            this.rejectedRequests++;
+            const error = new Error(`Circuit breaker '${this.name}' is OPEN`);
+            this.logStateChange('Request rejected');
+            throw error;
+        }
+        try {
+            // Execute the function
+            const result = await fn();
+            // Record success
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            // Record failure
+            this.onFailure();
+            throw error;
+        }
+    }
+    /**
+     * Check if execution is allowed
+     */
+    canExecute() {
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                return true;
+            case CircuitState.OPEN:
+                // Check if we should transition to half-open
+                if (this.nextAttempt && new Date() >= this.nextAttempt) {
+                    this.transitionTo(CircuitState.HALF_OPEN);
+                    return true;
+                }
+                return false;
+            case CircuitState.HALF_OPEN:
+                // Allow limited requests in half-open state
+                return this.halfOpenRequests < this.config.halfOpenLimit;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Handle successful execution
+     */
+    onSuccess() {
+        this.lastSuccessTime = new Date();
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                this.failures = 0; // Reset failure count
+                break;
+            case CircuitState.HALF_OPEN:
+                this.successes++;
+                this.halfOpenRequests++;
+                // Check if we should close the circuit
+                if (this.successes >= this.config.successThreshold) {
+                    this.transitionTo(CircuitState.CLOSED);
+                }
+                break;
+            case CircuitState.OPEN:
+                // Shouldn't happen, but handle gracefully
+                this.transitionTo(CircuitState.HALF_OPEN);
+                break;
+        }
+    }
+    /**
+     * Handle failed execution
+     */
+    onFailure() {
+        this.lastFailureTime = new Date();
+        switch (this.state) {
+            case CircuitState.CLOSED:
+                this.failures++;
+                // Check if we should open the circuit
+                if (this.failures >= this.config.failureThreshold) {
+                    this.transitionTo(CircuitState.OPEN);
+                }
+                break;
+            case CircuitState.HALF_OPEN:
+                // Single failure in half-open state reopens the circuit
+                this.transitionTo(CircuitState.OPEN);
+                break;
+            case CircuitState.OPEN:
+                // Already open, update next attempt time
+                this.nextAttempt = new Date(Date.now() + this.config.timeout);
+                break;
+        }
+    }
+    /**
+     * Transition to a new state
+     */
+    transitionTo(newState) {
+        const oldState = this.state;
+        this.state = newState;
+        this.logger.info(`Circuit breaker '${this.name}' state change`, {
+            from: oldState,
+            to: newState,
+            failures: this.failures,
+            successes: this.successes,
+        });
+        // Reset counters based on new state
+        switch (newState) {
+            case CircuitState.CLOSED:
+                this.failures = 0;
+                this.successes = 0;
+                this.halfOpenRequests = 0;
+                delete this.nextAttempt;
+                break;
+            case CircuitState.OPEN:
+                this.successes = 0;
+                this.halfOpenRequests = 0;
+                this.nextAttempt = new Date(Date.now() + this.config.timeout);
+                break;
+            case CircuitState.HALF_OPEN:
+                this.successes = 0;
+                this.failures = 0;
+                this.halfOpenRequests = 0;
+                break;
+        }
+        // Emit state change event
+        if (this.eventBus) {
+            this.eventBus.emit('circuitbreaker:state-change', {
+                name: this.name,
+                from: oldState,
+                to: newState,
+                metrics: this.getMetrics(),
+            });
+        }
+    }
+    /**
+     * Force the circuit to a specific state
+     */
+    forceState(state) {
+        this.logger.warn(`Forcing circuit breaker '${this.name}' to state`, { state });
+        this.transitionTo(state);
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get circuit breaker metrics
+     */
+    getMetrics() {
+        const metrics = {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            totalRequests: this.totalRequests,
+            rejectedRequests: this.rejectedRequests,
+            halfOpenRequests: this.halfOpenRequests,
+        };
+        if (this.lastFailureTime !== undefined) {
+            metrics.lastFailureTime = this.lastFailureTime;
+        }
+        if (this.lastSuccessTime !== undefined) {
+            metrics.lastSuccessTime = this.lastSuccessTime;
+        }
+        return metrics;
+    }
+    /**
+     * Reset the circuit breaker
+     */
+    reset() {
+        this.logger.info(`Resetting circuit breaker '${this.name}'`);
+        this.state = CircuitState.CLOSED;
+        this.failures = 0;
+        this.successes = 0;
+        delete this.lastFailureTime;
+        delete this.lastSuccessTime;
+        delete this.nextAttempt;
+        this.halfOpenRequests = 0;
+        this.totalRequests = 0;
+        this.rejectedRequests = 0;
+    }
+    /**
+     * Log state change with consistent format
+     */
+    logStateChange(message) {
+        this.logger.debug(`Circuit breaker '${this.name}': ${message}`, {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            nextAttempt: this.nextAttempt,
+        });
+    }
+}
+/**
+ * Manager for multiple circuit breakers
+ */
+export class CircuitBreakerManager {
+    defaultConfig;
+    logger;
+    eventBus;
+    breakers = new Map();
+    constructor(defaultConfig, logger, eventBus) {
+        this.defaultConfig = defaultConfig;
+        this.logger = logger;
+        this.eventBus = eventBus;
+    }
+    /**
+     * Get or create a circuit breaker
+     */
+    getBreaker(name, config) {
+        let breaker = this.breakers.get(name);
+        if (!breaker) {
+            const finalConfig = { ...this.defaultConfig, ...config };
+            breaker = new CircuitBreaker(name, finalConfig, this.logger, this.eventBus);
+            this.breakers.set(name, breaker);
+        }
+        return breaker;
+    }
+    /**
+     * Execute with circuit breaker
+     */
+    async execute(name, fn, config) {
+        const breaker = this.getBreaker(name, config);
+        return breaker.execute(fn);
+    }
+    /**
+     * Get all circuit breakers
+     */
+    getAllBreakers() {
+        return new Map(this.breakers);
+    }
+    /**
+     * Get metrics for all breakers
+     */
+    getAllMetrics() {
+        const metrics = {};
+        for (const [name, breaker] of this.breakers) {
+            metrics[name] = breaker.getMetrics();
+        }
+        return metrics;
+    }
+    /**
+     * Reset a specific breaker
+     */
+    resetBreaker(name) {
+        const breaker = this.breakers.get(name);
+        if (breaker) {
+            breaker.reset();
+        }
+    }
+    /**
+     * Reset all breakers
+     */
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+    /**
+     * Force a breaker to a specific state
+     */
+    forceState(name, state) {
+        const breaker = this.breakers.get(name);
+        if (breaker) {
+            breaker.forceState(state);
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/coordination/circuit-breaker.js.map

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

package/dist/coordination/conflict-resolution.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Conflict resolution mechanisms for multi-agent coordination
+ */
+import type { ILogger } from '../core/logger.js';
+import type { IEventBus } from '../core/event-bus.js';
+export interface ResourceConflict {
+    id: string;
+    resourceId: string;
+    agents: string[];
+    timestamp: Date;
+    resolved: boolean;
+    resolution?: ConflictResolution;
+}
+export interface TaskConflict {
+    id: string;
+    taskId: string;
+    agents: string[];
+    type: 'assignment' | 'dependency' | 'output';
+    timestamp: Date;
+    resolved: boolean;
+    resolution?: ConflictResolution;
+}
+export interface ConflictResolution {
+    type: 'priority' | 'timestamp' | 'vote' | 'manual' | 'retry';
+    winner?: string;
+    losers?: string[];
+    reason: string;
+    timestamp: Date;
+}
+export interface ConflictResolutionStrategy {
+    name: string;
+    resolve(conflict: ResourceConflict | TaskConflict, context: any): Promise<ConflictResolution>;
+}
+/**
+ * Priority-based resolution strategy
+ */
+export declare class PriorityResolutionStrategy implements ConflictResolutionStrategy {
+    name: string;
+    resolve(conflict: ResourceConflict | TaskConflict, context: {
+        agentPriorities: Map<string, number>;
+    }): Promise<ConflictResolution>;
+}
+/**
+ * First-come-first-served resolution strategy
+ */
+export declare class TimestampResolutionStrategy implements ConflictResolutionStrategy {
+    name: string;
+    resolve(conflict: ResourceConflict | TaskConflict, context: {
+        requestTimestamps: Map<string, Date>;
+    }): Promise<ConflictResolution>;
+}
+/**
+ * Voting-based resolution strategy (for multi-agent consensus)
+ */
+export declare class VotingResolutionStrategy implements ConflictResolutionStrategy {
+    name: string;
+    resolve(conflict: ResourceConflict | TaskConflict, context: {
+        votes: Map<string, string[]>;
+    }): Promise<ConflictResolution>;
+}
+/**
+ * Conflict resolution manager
+ */
+export declare class ConflictResolver {
+    private logger;
+    private eventBus;
+    private strategies;
+    private conflicts;
+    private resolutionHistory;
+    constructor(logger: ILogger, eventBus: IEventBus);
+    /**
+     * Register a conflict resolution strategy
+     */
+    registerStrategy(strategy: ConflictResolutionStrategy): void;
+    /**
+     * Report a resource conflict
+     */
+    reportResourceConflict(resourceId: string, agents: string[]): Promise<ResourceConflict>;
+    /**
+     * Report a task conflict
+     */
+    reportTaskConflict(taskId: string, agents: string[], type: TaskConflict['type']): Promise<TaskConflict>;
+    /**
+     * Resolve a conflict using a specific strategy
+     */
+    resolveConflict(conflictId: string, strategyName: string, context: any): Promise<ConflictResolution>;
+    /**
+     * Auto-resolve conflicts based on configuration
+     */
+    autoResolve(conflictId: string, preferredStrategy?: string): Promise<ConflictResolution>;
+    /**
+     * Get active conflicts
+     */
+    getActiveConflicts(): Array<ResourceConflict | TaskConflict>;
+    /**
+     * Get conflict history
+     */
+    getConflictHistory(limit?: number): ConflictResolution[];
+    /**
+     * Clear resolved conflicts older than a certain age
+     */
+    cleanupOldConflicts(maxAgeMs: number): number;
+    /**
+     * Get conflict statistics
+     */
+    getStats(): Record<string, unknown>;
+}
+/**
+ * Optimistic concurrency control for resource updates
+ */
+export declare class OptimisticLockManager {
+    private logger;
+    private versions;
+    private locks;
+    constructor(logger: ILogger);
+    /**
+     * Acquire an optimistic lock
+     */
+    acquireLock(resourceId: string, agentId: string): number;
+    /**
+     * Validate and update with optimistic lock
+     */
+    validateAndUpdate(resourceId: string, agentId: string, expectedVersion: number): boolean;
+    /**
+     * Release a lock without updating
+     */
+    releaseLock(resourceId: string, agentId: string): void;
+    /**
+     * Clean up stale locks
+     */
+    cleanupStaleLocks(maxAgeMs: number): number;
+}
+//# sourceMappingURL=conflict-resolution.d.ts.map

package/dist/coordination/conflict-resolution.d.ts.map

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