Skip to content

cayu.verification.completion_result_resolvers

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.

COMPLETION_RESULT_RESOLUTION_MAX_SECONDS

Section titled “COMPLETION_RESULT_RESOLUTION_MAX_SECONDS”
from cayu.verification import COMPLETION_RESULT_RESOLUTION_MAX_SECONDS
COMPLETION_RESULT_RESOLUTION_MAX_SECONDS = 300.0

Release source · Runtime guarantees · Capability guides

CompletionResultResolutionRequest

Section titled “CompletionResultResolutionRequest”
from cayu.verification import CompletionResultResolutionRequest

Serializable authority for one bounded accepted-result resolution.

Bases: FrozenWorkContractModel.

Fields and attributes

Section titled “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
task_id str required
decision_id str required
idempotency_key str required
execution_timeout_seconds StrictFloat Field(default=30.0, gt=0, le=COMPLETION_RESULT_RESOLUTION_MAX_SECONDS)

validate_task_id (method)

Section titled “validate_task_id (method)”
CompletionResultResolutionRequest.validate_task_id(value: str) -> str

validate_decision_id (method)

Section titled “validate_decision_id (method)”
CompletionResultResolutionRequest.validate_decision_id(value: str) -> str

validate_idempotency_key (method)

Section titled “validate_idempotency_key (method)”
CompletionResultResolutionRequest.validate_idempotency_key(value: str) -> str

Release source · Runtime guarantees · Capability guides

CompletionResultResolver

Section titled “CompletionResultResolver”
from cayu.verification import CompletionResultResolver

Application-owned resolver selected by an exact durable contract identity.

Implementations may read external result storage. Cayu may repeat resolve after process loss before application acknowledgement, so adapters must bind reads to the supplied immutable reference and avoid unrelated side effects.

Bases: ABC.

resolve (method)

Section titled “resolve (method)”
async CompletionResultResolver.resolve(request: CompletionResultResolverRequest) -> dict[str, object]

Return the complete result whose digest matches result_reference.

Release source · Runtime guarantees · Capability guides

CompletionResultResolverExecutionError

Section titled “CompletionResultResolverExecutionError”
from cayu.verification import CompletionResultResolverExecutionError

A result resolver failed before producing validated result content.

Bases: RuntimeError.

This type’s implementation and inherited behavior are available in the linked release source.

Release source · Runtime guarantees · Capability guides

CompletionResultResolverRequest

Section titled “CompletionResultResolverRequest”
from cayu.verification import CompletionResultResolverRequest

Detached immutable authority presented to one exact result resolver.

Bases: FrozenWorkContractModel.

Fields and attributes

Section titled “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
contract WorkContract required
attempt WorkAttempt required
proposal CompletionProposal required
decision CompletionDecision required
result_reference CompletionResultReference required

copy_contract (method)

Section titled “copy_contract (method)”
CompletionResultResolverRequest.copy_contract(value: object) -> object

copy_attempt (method)

Section titled “copy_attempt (method)”
CompletionResultResolverRequest.copy_attempt(value: object) -> object

copy_proposal (method)

Section titled “copy_proposal (method)”
CompletionResultResolverRequest.copy_proposal(value: object) -> object

copy_decision (method)

Section titled “copy_decision (method)”
CompletionResultResolverRequest.copy_decision(value: object) -> object

copy_result_reference (method)

Section titled “copy_result_reference (method)”
CompletionResultResolverRequest.copy_result_reference(value: object) -> object

validate_authority_chain (method)

Section titled “validate_authority_chain (method)”
CompletionResultResolverRequest.validate_authority_chain() -> CompletionResultResolverRequest

Release source · Runtime guarantees · Capability guides

CompletionResultResolverUnavailable

Section titled “CompletionResultResolverUnavailable”
from cayu.verification import CompletionResultResolverUnavailable

The exact result resolver required by a work contract is unavailable.

Bases: RuntimeError.

This type’s implementation and inherited behavior are available in the linked release source.

Release source · Runtime guarantees · Capability guides

CompletionResultUnavailable

Section titled “CompletionResultUnavailable”
from cayu.verification import CompletionResultUnavailable

The accepted result can no longer be reconstructed by its resolver.

Bases: RuntimeError.

This type’s implementation and inherited behavior are available in the linked release source.

Release source · Runtime guarantees · Capability guides