Reference

Error taxonomy

Programmer, projection, payload, model, limit, and journal errors.

Every exported error

from agentsparty.kernel import errors

names = sorted(
    n for n in dir(errors) if n.endswith('Error') or n.endswith('Refused')
)
print('\n'.join(names))

Families

FamilyExamplesWhen
Projection / conformanceProjectionError, ConformanceError, CompositionErrorBefore or at bind of illegal types
PayloadPayloadError, SelectionErrorCodec / label mismatch
ModelModelError, ModelRefusedError, ModelUnavailableErrorProvider boundary
LimitsStepLimitError, RecursionLimitError, TokenLimitError, AllowanceExceededError, DeadlineExceededErrorBudgets and time
JournalJournalErrorDecision log integrity

Assertions versus errors

Programmer contract breaks raise assertions in debug paths; expected external failures use the typed errors above.

The most common one to meet is ProjectionError; see knowledge of alt for the concept. Runtime bounds are covered in composition and termination and agentsparty.kernel.errors.ProjectionError.

Stable