Home/Docs/Circuit States

Circuit Breaker States

AgentSentry implements the circuit breaker pattern to protect treasuries from cascading failures and runaway agents.

CLOSED

Normal operation. All transactions are validated against policies and allowed to proceed if compliant.

Triggers: Default state. Returns to CLOSED after successful HALF_OPEN test.

OPEN

Circuit tripped. ALL transactions are blocked regardless of policy compliance. Emergency state.

Triggers: Triggered when failure count exceeds threshold, or manually via kill switch.

HALF_OPEN

Testing state. Allows limited transactions to determine if the underlying issue is resolved.

Triggers: Automatic after reset timeout expires. Limited requests permitted.

State Transitions

CLOSED ──[failures > threshold]──> OPEN
   ^                                  │
   │                                  │
   └──[test success]── HALF_OPEN <────┘
                          │            [timeout]
                          └──[test fail]──> OPEN

Was this page helpful? /