Struct DefaultCircuitBreaker 

pub struct DefaultCircuitBreaker { /* private fields */ }

Unstable (feature: circuit-breaker) — may change or be removed

SDK reference implementation: threshold-based with half-open state machine.

The thresholds (failure_threshold, reset_timeout) are SDK-illustrative, not consumer policy. A consumer whose traffic profile differs (e.g. A2A with 12 failures/min and a 30s recovery window) implements CircuitBreaker for its own struct rather than reusing this.

Implementations

impl DefaultCircuitBreaker

pub fn new( failure_threshold: u32, reset_timeout: Duration, ) -> DefaultCircuitBreaker

Construct a new breaker. failure_threshold is the number of consecutive failures that trip the breaker; reset_timeout is how long the breaker stays open before allowing a trial call (half-open).

pub fn state(&self) -> BreakerState

Current state (testing/observability).

pub fn failure_count(&self) -> u32

Failure count since the last successful call (observability).

Trait Implementations

impl CircuitBreaker for DefaultCircuitBreaker

fn check(&self) -> Result<(), BreakerError>

Returns Err(BreakerError::Open) if the circuit is open (calls should fail-fast). The check is cheap (atomic load) so callers may invoke it before every retry.

fn record_success(&self)

Record a successful call. Resets the failure count and, if the breaker was in HalfOpen, returns it to Closed.

fn record_failure(&self)

Record a failed call. Increments the failure count; if the count reaches the configured threshold the breaker trips to Open.