Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
"""Protocol-neutral execution failure semantics."""
from dataclasses import FrozenInstanceError, dataclass
from enum import StrEnum
from .stream_recovery import StreamFailureContext
class FailureKind(StrEnum):
"""Stable failure categories shared across execution and wire adapters."""
INVALID_REQUEST = "invalid_request"
CONTEXT_WINDOW_EXCEEDED = "context_window_exceeded"
AUTHENTICATION = "authentication"
PERMISSION = "permission"
RATE_LIMIT = "rate_limit"
OVERLOADED = "overloaded"
TIMEOUT = "timeout"
UPSTREAM = "upstream"
UNAVAILABLE = "unavailable"
@dataclass(slots=True, eq=False)
class ExecutionFailure(Exception):
"""A finalized provider-execution failure independent of any wire protocol."""
kind: FailureKind
status_code: int
message: str
retryable: bool
stream_context: StreamFailureContext | None = None
def __post_init__(self) -> None:
Exception.__init__(self, self.message)
def __setattr__(self, name: str, value: object) -> None:
# Exception machinery must be able to update __traceback__, __cause__,
# and __context__ while semantic failure fields remain immutable.
if name in self.__slots__ and hasattr(self, name):
raise FrozenInstanceError(f"cannot assign to field {name!r}")
super().__setattr__(name, value)
def find_execution_failure(exc: BaseException) -> ExecutionFailure | None:
"""Return the first canonical failure in an exception or nested group."""
pending = [exc]
while pending:
current = pending.pop()
if isinstance(current, ExecutionFailure):
return current
if isinstance(current, BaseExceptionGroup):
pending.extend(reversed(current.exceptions))
return None