| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960 |
- """Per-attempt recovery bookkeeping (``TurnRetryState``) for the conversation turn loop.
- Dependency-free so it imports without a cycle."""
- from __future__ import annotations
- from dataclasses import dataclass
- @dataclass
- class TurnRetryState:
- """One-shot recovery guards + restart signals for a single API-call attempt.
- A fresh instance is created per ``api_call_count`` iteration; each guard fires at
- most once, and ``restart_with_*`` signals tell the loop to rebuild and retry.
- Loop-control (``retry_count``, ``max_retries``) stays as plain loop locals."""
- # Per-provider OAuth / credential refresh guards
- codex_auth_retry_attempted: bool = False
- anthropic_auth_retry_attempted: bool = False
- nous_auth_retry_attempted: bool = False
- nous_paid_entitlement_refresh_attempted: bool = False
- # Nous free tier: one model move onto the tier's own model after a ``model_not_free``
- # refusal, and one route re-read after a wrong-host refusal (``anon_on_paid_host``).
- welcome_model_switch_attempted: bool = False
- welcome_route_heal_attempted: bool = False
- # Provider-profile runtime refresh (``refresh_runtime_credentials``): one 401 refresh, and a
- # separate one for a non-auth error the profile reads as a stale credential.
- provider_auth_refresh_attempted: bool = False
- provider_stale_refresh_attempted: bool = False
- vertex_auth_retry_attempted: bool = False
- # Format / payload recovery guards
- thinking_sig_retry_attempted: bool = False
- invalid_encrypted_content_retry_attempted: bool = False
- native_compaction_reject_retry_attempted: bool = False
- image_shrink_retry_attempted: bool = False
- multimodal_tool_content_retry_attempted: bool = False
- reasoning_mandatory_retry_attempted: bool = False
- oauth_1m_beta_retry_attempted: bool = False
- llama_cpp_grammar_retry_attempted: bool = False
- # Transport / rate-limit recovery
- primary_recovery_attempted: bool = False
- has_retried_429: bool = False
- # Credit-limited 402 ("can only afford N tokens") already retried with a lowered output cap.
- affordable_402_clamp_attempted: bool = False
- # Persistent 401/403 already escalated to the fallback chain once this attempt.
- auth_failover_attempted: bool = False
- # Post-exhaustion auto-recovery cycles spent on this API call (agent.auto_recovery_cycles caps it).
- auto_recovery_cycles_used: int = 0
- # Restart signals (read by the outer loop after the attempt)
- restart_with_compressed_messages: bool = False
- restart_with_length_continuation: bool = False
- # A fallback activation (incl. content-filter stream stalls) rolled partial content
- # off ``messages``; re-issue the call against the new provider.
- restart_with_rebuilt_messages: bool = False
- # A user correction cancelled the in-flight request: append a role-safe checkpoint +
- # user message, rebuild the payload, and retry the same logical iteration.
- restart_with_redirected_messages: bool = False
|