Skip to content

cayu.providers definitions

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

from cayu import RetryDecision

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
retry StrictBool required
disposition RetryDisposition RetryDisposition.CLASSIFICATION_UNAVAILABLE
suppression RetrySuppression | None None
provider_retryable StrictBool | None None
reason RetryReason | None None
status_code StrictInt | None Field(default=None, ge=100, le=599)
delay_seconds StrictFloat Field(default=0.0, ge=0.0)
attempt StrictInt Field(ge=1)
next_attempt StrictInt | None Field(default=None, ge=2)
max_attempts StrictInt Field(ge=1)
effective_max_attempts StrictInt Field(ge=1)

Release source · Runtime guarantees · Capability guides

from cayu import RetryDisposition

Bases: StrEnum.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
RETRY_SCHEDULED class attribute 'retry_scheduled'
PERMANENT_PROVIDER_ERROR class attribute 'permanent_provider_error'
EXPLICIT_NONRETRYABLE class attribute 'explicit_nonretryable'
UNKNOWN_PROVIDER_ATTEMPT_CAP class attribute 'unknown_provider_attempt_cap'
CONFIGURED_ATTEMPT_EXHAUSTION class attribute 'configured_attempt_exhaustion'
POLICY_DISALLOWED class attribute 'policy_disallowed'
CLASSIFICATION_UNAVAILABLE class attribute 'classification_unavailable'
SUPPRESSED class attribute 'suppressed'

Release source · Runtime guarantees · Capability guides

from cayu import RetryReason

Bases: StrEnum.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
OUTPUT class attribute 'output'
HTTP_STATUS class attribute 'http_status'
TIMEOUT class attribute 'timeout'
CONNECTION class attribute 'connection'
RATE_LIMIT class attribute 'rate_limit'
UNKNOWN_PROVIDER class attribute 'unknown_provider'

Release source · Runtime guarantees · Capability guides

from cayu import RetrySuppression

Bases: StrEnum.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
COMPLETION_OBSERVED class attribute 'completion_observed'
PROVIDER_OPERATION class attribute 'provider_operation'
PROVIDER_EFFECT_OBSERVED class attribute 'provider_effect_observed'
CANCELLATION class attribute 'cancellation'
DEADLINE class attribute 'deadline'
AUTOMATIC_RETRY_DISABLED class attribute 'automatic_retry_disabled'

Release source · Runtime guarantees · Capability guides