circuit-breaker-agents · packages

A meta-package that re-exports all public APIs from `@reaatech/circuit-breaker-core` and `@reaatech/circuit-breaker-persistence` as a single dependency, providing classes (`CircuitBreaker`, `StateMachine`), persistence adapters (`InMemoryAdapter`, `FirestoreAdapter`, `DynamoDBAdapter`, `RedisAdapter`), leader election, strategies, metrics collectors, error classes, and TypeScript types.

A circuit breaker state machine for agent-to-tool and agent-to-agent communication, providing a `CircuitBreaker` class with lazy auto-transition state evaluation, configurable trip strategies (error threshold, confidence threshold, cost threshold), recovery strategies (gradual exponential ramp-up or single all-or-nothing), and pluggable metrics collection — depends only on `zod` at runtime.

Persistence adapters for circuit breaker state that survive restarts and share state across instances. Exports a `PersistenceAdapter` interface with four implementations: `InMemoryAdapter` (zero dependencies), `FirestoreAdapter` (peer: `@google-cloud/firestore`), `DynamoDBAdapter` (peer: `@aws-sdk/client-dynamodb`), and `RedisAdapter` (peer: `ioredis`), each providing `connect`, `disconnect`, `saveState`, `loadState`, `deleteState`, `saveBatch`, `loadAll`, `tryAcquireLeadership`, `releaseLeadership`, and `healthCheck` methods.