cayu.tasks.TaskRetrySettlementRequest

Part of cayu.tasks.base. Read the Python API overview and install the required extra.

from cayu.tasks import TaskRetrySettlementRequest

One typed, claim-fenced retry-attempt outcome.

Bases: _TaskRetryAttemptOutcome.

Fields and attributes

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
idempotency_key	str	required
disposition	TaskRetryAttemptDisposition	required
result	dict[str, Any] | None	None
error	dict[str, Any] | None	None
token_count	StrictInt	Field(default=0, ge=0, le=_TASK_RETRY_MAX_ATTEMPT_TOKEN_REPORT)
estimated_cost	Decimal	Field(default=Decimal(0), ge=0)
retry_after_seconds	StrictFloat | None	Field(default=None, ge=0, le=86400)
task_id	str	required
worker_id	str	required
lease_expires_at	datetime | None	None
causal_budget_id	str	required

validate_idempotency_key (method)

TaskRetrySettlementRequest.validate_idempotency_key(value: str) -> str

copy_payload (method)

TaskRetrySettlementRequest.copy_payload(value: dict[str, Any] | None, info) -> dict[str, Any] | None

validate_estimated_cost (method)

TaskRetrySettlementRequest.validate_estimated_cost(value: Decimal) -> Decimal

validate_disposition_payload (method)

TaskRetrySettlementRequest.validate_disposition_payload() -> _TaskRetryAttemptOutcome

validate_identity (method)

TaskRetrySettlementRequest.validate_identity(value: str, info) -> str

normalize_lease_expires_at (method)

TaskRetrySettlementRequest.normalize_lease_expires_at(value: datetime | None) -> datetime | None

Release source · Runtime guarantees · Capability guides