aeat.adapters.outbound.llm._errors module

Error hierarchy for the LLM subpackage.

All public LLM exceptions inherit from LLMError, which extends AeatError. Provider adapters surface LLMProviderError and LLMRateLimitError, cache and usage storage surface LLMCacheError, and strict model validators surface LLMValidationError.

exception LLMError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: AeatError

Base exception for public LLM package failures.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LLMProviderError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LLMError

Raised when a provider adapter cannot return a completion.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LLMPdfRasterisationError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LLMError

Raised when rasterise_pdf_pages_to_base64_png() fails.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LLMCacheError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LLMError

Raised when LLMCache storage fails.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LLMRateLimitError(message, retry_after_seconds=None)[source]

Bases: LLMProviderError

Raised when a provider rejects a request because of rate limits.

Inherits from LLMProviderError so callers can catch all provider-boundary failures together.

Parameters:

  • message (str) – Human-readable error message.

  • retry_after_seconds (float | None) – Optional server-provided retry delay in seconds.

Return type:

None

code: ClassVar[ErrorCode]
exception LLMConfigError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LLMError

Raised when LLMClient configuration is invalid.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception LLMValidationError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: LLMError, ValueError

Raised when an LLM-related object fails validation.

Inherits from both LLMError and ValueError to remain compatible with Pydantic’s validator-failure contract while allowing catch-all LLMError handlers to detect integrity failures.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]