dheraingoud's picture
sync: upstream 9194f15 + custom addons (KeyRotator, RotatingChatTransport, sol/terra/luna, ScannerTrap, health, Py3.12 compat)
e99df76
Raw History Blame Contribute Delete
1.83 kB
from __future__ import annotations
"""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}")
object.__setattr__(self, 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