orchestrata_ultimate.llm.exceptions

Reference › orchestrata_ultimate › llm › exceptions

exceptions defines two errors for the LLM client. LLMClientError is the base, raised by client when a call fails after all retries (specification 028, requirements 054 and 056). LLMProviderUnavailableError subclasses it for the case where no provider is available for the requested volk (specification 028 requirement 055 and specification 017 requirements 012 and 013). The configuration-time sibling LLMConfigError lives in config. The package __init__ re-exports both.

At a glance


Source	`src/orchestrata_ultimate/llm/exceptions.py`
Lines of code	23
Classes	2
Functions	0
Imports (internal)	`orchestrata_ultimate.core.traceability`
Imported by	`orchestrata_ultimate.llm`, `orchestrata_ultimate.llm.client`
Tests that import it	`tests/llm/test_cassette.py`, `tests/llm/test_client.py`, `tests/llm/test_client_extended.py`, `tests/llm/test_exceptions.py`, `tests/test_llm.py`

Class diagram

Dependency diagram

API

Classes

`LLMClientError`

Bases: Exception · Decorators: traces(spec='028', reqs=['REQ-028-054', 'REQ-028-056']) · Line 8

Base error for LLM client operations.

`LLMProviderUnavailableError`

Bases: LLMClientError · Decorators: traces(spec='017', reqs=['REQ-017-013', 'REQ-017-012']), traces(spec='028', reqs=['REQ-028-055']) · Line 17

Raised when no LLM provider is available for the requested volk.

Source

Permalink: https://gitlab.com/MSamy/orchestrata-ultimate-architecture/-/blob/a4cbc2bdf/src/orchestrata_ultimate/llm/exceptions.py

# mypy: ignore-errors
"""LLM client exceptions."""

from orchestrata_ultimate.core.traceability import traces


@traces(spec="028", reqs=["REQ-028-054", "REQ-028-056"])
class LLMClientError(Exception):
    """Base error for LLM client operations.

    Raised when a call to the LLM provider fails after all retries.
    """


@traces(spec="017", reqs=["REQ-017-013", "REQ-017-012"])
@traces(spec="028", reqs=["REQ-028-055"])
class LLMProviderUnavailableError(LLMClientError):
    """Raised when no LLM provider is available for the requested volk.

    This occurs when the configured provider is not registered in
    the ProviderManager or all providers in the fallback chain have
    failed.
    """