feat(beta): add CircuitBreakerMiddleware for LLM failure isolation#2532
Open
amabito wants to merge 2 commits intoag2ai:mainfrom
Open
feat(beta): add CircuitBreakerMiddleware for LLM failure isolation#2532amabito wants to merge 2 commits intoag2ai:mainfrom
amabito wants to merge 2 commits intoag2ai:mainfrom
Conversation
Single-responsibility middleware implementing the circuit breaker pattern for LLM calls. Blocks calls after consecutive failures and allows recovery probes after a configurable timeout. - CircuitBreakerConfig: failure_threshold, recovery_timeout_s - Three states: CLOSED, OPEN, HALF_OPEN with atomic probe claiming - CancelledError releases probe without recording failure - Thread-safe state machine with mutex
This was referenced Mar 31, 2026
Codecov Report❌ Patch coverage is
... and 13 files with indirect coverage changes 🚀 New features to boost your workflow:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why are these changes needed?
Extracts the circuit breaker from GovernanceMiddleware (#2501, closed) into
a standalone middleware. Three states (CLOSED, OPEN, HALF_OPEN), atomic probe
claiming for the recovery path, and proper CancelledError handling that
releases the probe without recording a failure.
Same motivation as the BudgetMiddleware split (#2531): one middleware per
concern, composable via the middleware chain. Prior art in #2430 (circuit
breaker docs, merged).
Related issue number
Replaces the circuit breaker portion of #2501 (closed).
Related: #2430 (docs, merged), #2531 (BudgetMiddleware).
Checks