Struct CircuitBreakerConfig 

pub struct CircuitBreakerConfig {
    pub failure_threshold: u32,
    pub open_duration: Duration,
    pub half_open_successes: u32,
}

Fault-recovery primitives for resilient agent execution. Configuration parameters for a provider circuit breaker.

All parameters can be tuned based on the provider’s reliability and the acceptable impact of failures on your application.

Fields

failure_threshold: u32

Number of consecutive failures required to open the circuit.

Default: 5

A lower value makes the circuit more sensitive to failures, while a higher value requires more failures before opening.

open_duration: Duration

Duration to keep the circuit open before transitioning to half-open.

Default: 30 seconds

This should be long enough for the provider to recover from whatever caused the failures (e.g., rate limits, temporary outages).

half_open_successes: u32

Number of successful requests required in half-open state to close the circuit.

Default: 1

Setting this higher makes recovery testing more conservative, requiring multiple successful requests before fully trusting the provider.

Implementations

impl CircuitBreakerConfig

pub fn new( failure_threshold: u32, open_duration: Duration, half_open_successes: u32, ) -> CircuitBreakerConfig

Creates a new configuration with all values explicitly set.

Arguments

• failure_threshold - Consecutive failures to trigger circuit opening
• open_duration - Time to wait before testing recovery
• half_open_successes - Successes needed in half-open to close circuit

Panics

Panics if failure_threshold or half_open_successes are zero, as this would create an immediately opening circuit.

pub fn with_failure_threshold(self, threshold: u32) -> CircuitBreakerConfig

Sets the failure threshold.

Returns a new configuration with the updated value.

pub fn with_open_duration(self, duration: Duration) -> CircuitBreakerConfig

Sets the open duration.

Returns a new configuration with the updated value.

pub fn with_half_open_successes(self, successes: u32) -> CircuitBreakerConfig

Sets the half-open successes required.

Returns a new configuration with the updated value.

Trait Implementations

impl Clone for CircuitBreakerConfig

fn clone(&self) -> CircuitBreakerConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CircuitBreakerConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for CircuitBreakerConfig

fn default() -> CircuitBreakerConfig

Creates a default circuit breaker configuration.

The defaults are tuned for general-purpose use:

• 5 failures before opening (reasonable for most APIs)
• 30 second cooldown (enough for temporary issues to resolve)
• 1 success to close (fast recovery testing)

impl PartialEq for CircuitBreakerConfig

fn eq(&self, other: &CircuitBreakerConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CircuitBreakerConfig

impl StructuralPartialEq for CircuitBreakerConfig