aeat.application.operator_surface._errors module

Errors for the backend-owned operator-surface contract.

OperatorSurfaceContractError is the registered AeatError raised by require_accepted_root() and resolve_source_kind_alias() when a caller asks for a root, source-kind token, or command-surface shape outside the accepted OperatorSurfaceContract. The application error registry binds it to REFUSED_OPERATOR_SURFACE_CONTRACT so boundary adapters can render the refusal through the shared error contract.

exception OperatorSurfaceContractError(surface, *, reason, suggestion=None)[source]

Bases: AeatError

Registered application error for rejected operator-surface requests.

The message is localized with a stable, non-secret surface / reason context payload, and optional suggestion text gives callers the accepted follow-up command. Raw operator input is stored only in structured context for the central error renderer to handle consistently.

Parameters:

  • surface (str)

  • reason (str)

  • suggestion (str | None)

Return type:

None

code: ClassVar[ErrorCode]