🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUv9d11dadc739b
diff --git a/v3/@claude-flow/cli/src/production/circuit-breaker.ts b/v3/@claude-flow/cli/src/production/circuit-breaker.tsnew file mode 100644index 0000000000..ce7bf6ae09--- /dev/null+++ b/v3/@claude-flow/cli/src/production/circuit-breaker.ts@@ -0,0 +1,322 @@+/**+ * Production Circuit Breaker+ *+ * Implements the circuit breaker pattern to prevent cascading failures:+ * - Closed: Normal operation+ * - Open: Failing fast, not calling service+ * - Half-Open: Testing if service recovered+ *+ * @module @claude-flow/cli/production/circuit-breaker+ */++// ============================================================================+// Types+// ============================================================================++export type CircuitState = 'closed' | 'open' | 'half-open';++export interface CircuitBreakerConfig {+ // Number of failures before opening circuit+ failureThreshold: number;+ // Time to wait before transitioning to half-open (ms)+ resetTimeoutMs: number;+ // Number of successes needed in half-open to close+ successThreshold: number;+ // Time window for counting failures (ms)+ failureWindowMs: number;+ // Percentage of requests to let through in half-open+ halfOpenRequestPercentage: number;+ // Called when state changes+ onStateChange?: (from: CircuitState, to: CircuitState) => void;+ // Called when circuit opens+ onOpen?: (failures: number) => void;+ // Called when circuit closes+ onClose?: () => void;+}++export interface CircuitStats {+ state: CircuitState;+ failures: number;+ successes: number;+ lastFailure: Date | null;+ lastSuccess: Date | null;+ stateChangedAt: Date;+ totalRequests: number;+ totalFailures: number;+ totalSuccesses: number;+}++// ============================================================================+// Default Configuration+// ============================================================================++const DEFAULT_CONFIG: CircuitBreakerConfig = {+ failureThreshold: 5,+ resetTimeoutMs: 30000,+ successThreshold: 3,+ failureWindowMs: 60000,+ halfOpenRequestPercentage: 0.1,+};++// ============================================================================+// Circuit Breaker Implementation+// ============================================================================++export class CircuitBreaker {+ private config: CircuitBreakerConfig;+ private state: CircuitState = 'closed';+ private failures: number[] = [];+ private successCount = 0;+ private stateChangedAt = Date.now();+ private totalRequests = 0;+ private totalFailures = 0;+ private totalSuccesses = 0;+ private lastFailure: Date | null = null;+ private lastSuccess: Date | null = null;++ constructor(config: Partial<CircuitBreakerConfig> = {}) {+ this.config = { ...DEFAULT_CONFIG, ...config };+ }++ /**+ * Get current circuit state+ */+ getState(): CircuitState {+ this.checkStateTransition();+ return this.state;+ }++ /**+ * Check if request is allowed+ */+ isAllowed(): boolean {+ this.checkStateTransition();++ switch (this.state) {+ case 'closed':+ return true;++ case 'open':+ return false;++ case 'half-open':+ // Allow a percentage of requests through+ return Math.random() < this.config.halfOpenRequestPercentage;++ default:+ return true;+ }+ }++ /**+ * Execute a function through the circuit breaker+ */+ async execute<T>(fn: () => Promise<T>): Promise<T> {+ if (!this.isAllowed()) {+ throw new Error('Circuit breaker is open. Service temporarily unavailable.');+ }++ this.totalRequests++;++ try {+ const result = await fn();+ this.recordSuccess();+ return result;+ } catch (error) {+ this.recordFailure();+ throw error;+ }+ }++ /**+ * Record a successful operation+ */+ recordSuccess(): void {+ this.totalSuccesses++;+ this.lastSuccess = new Date();++ if (this.state === 'half-open') {+ this.successCount++;++ if (this.successCount >= this.config.successThreshold) {+ this.transitionTo('closed');+ }+ }++ // Reset failure count on success in closed state+ if (this.state === 'closed') {+ this.failures = [];+ }+ }++ /**+ * Record a failed operation+ */+ recordFailure(): void {+ const now = Date.now();+ this.totalFailures++;+ this.lastFailure = new Date();++ // Add failure timestamp+ this.failures.push(now);++ // Clean old failures outside window+ this.failures = this.failures.filter(+ t => t > now - this.config.failureWindowMs+ );++ // Check if we should open the circuit+ if (this.state === 'closed' && this.failures.length >= this.config.failureThreshold) {+ this.transitionTo('open');+ if (this.config.onOpen) {+ this.config.onOpen(this.failures.length);+ }+ }++ // If half-open and we fail, go back to open+ if (this.state === 'half-open') {+ this.transitionTo('open');+ }+ }++ /**+ * Manually open the circuit+ */+ open(): void {+ if (this.state !== 'open') {+ this.transitionTo('open');+ }+ }++ /**+ * Manually close the circuit+ */+ close(): void {+ if (this.state !== 'closed') {+ this.transitionTo('closed');+ }+ }++ /**+ * Reset the circuit breaker+ */+ reset(): void {+ this.state = 'closed';+ this.failures = [];+ this.successCount = 0;+ this.stateChangedAt = Date.now();+ this.totalRequests = 0;+ this.totalFailures = 0;+ this.totalSuccesses = 0;+ this.lastFailure = null;+ this.lastSuccess = null;+ }++ /**+ * Get circuit statistics+ */+ getStats(): CircuitStats {+ return {+ state: this.state,+ failures: this.failures.length,+ successes: this.successCount,+ lastFailure: this.lastFailure,+ lastSuccess: this.lastSuccess,+ stateChangedAt: new Date(this.stateChangedAt),+ totalRequests: this.totalRequests,+ totalFailures: this.totalFailures,+ totalSuccesses: this.totalSuccesses,+ };+ }++ /**+ * Get failure rate+ */+ getFailureRate(): number {+ if (this.totalRequests === 0) return 0;+ return this.totalFailures / this.totalRequests;+ }++ // ============================================================================+ // Private Methods+ // ============================================================================++ private checkStateTransition(): void {+ const now = Date.now();++ if (this.state === 'open') {+ // Check if we should transition to half-open+ if (now - this.stateChangedAt >= this.config.resetTimeoutMs) {+ this.transitionTo('half-open');+ }+ }+ }++ private transitionTo(newState: CircuitState): void {+ const oldState = this.state;++ if (oldState === newState) return;++ this.state = newState;+ this.stateChangedAt = Date.now();++ // Reset counters on state change+ if (newState === 'half-open') {+ this.successCount = 0;+ }++ if (newState === 'closed') {+ this.failures = [];+ this.successCount = 0;+ if (this.config.onClose) {+ this.config.onClose();+ }+ }++ // Notify state change+ if (this.config.onStateChange) {+ this.config.onStateChange(oldState, newState);+ }+ }+}++// ============================================================================+// Circuit Breaker Registry+// ============================================================================++const circuitBreakers = new Map<string, CircuitBreaker>();++/**+ * Get or create a circuit breaker by name+ */+export function getCircuitBreaker(+ name: string,+ config?: Partial<CircuitBreakerConfig>+): CircuitBreaker {+ if (!circuitBreakers.has(name)) {+ circuitBreakers.set(name, new CircuitBreaker(config));+ }+ return circuitBreakers.get(name)!;+}++/**+ * Get all circuit breaker stats+ */+export function getAllCircuitStats(): Record<string, CircuitStats> {+ const stats: Record<string, CircuitStats> = {};+ for (const [name, breaker] of circuitBreakers) {+ stats[name] = breaker.getStats();+ }+ return stats;+}++/**+ * Reset all circuit breakers+ */+export function resetAllCircuits(): void {+ for (const breaker of circuitBreakers.values()) {+ breaker.reset();+ }+}++export default CircuitBreaker;