cayu.tasks.contracts

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_gap_fingerprint`

from cayu.tasks import completion_gap_fingerprint

completion_gap_fingerprint(value: CompletionDecisionCreate) -> str

Release source · Runtime guarantees · Capability guides

`completion_result_sha256`

from cayu.tasks import completion_result_sha256

completion_result_sha256(value: dict[str, object]) -> str

Release source · Runtime guarantees · Capability guides

`CompletionConstraintOutcome`

from cayu.tasks import CompletionConstraintOutcome

Bases: _CompletionOutcome.

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
`status`	`CriterionOutcomeStatus`	`required`
`reason_code`	`str`	`required`
`satisfaction_basis`	`CompletionSatisfactionBasis \| None`	`None`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_COMPLETION_OUTCOME_MAX_EVIDENCE_REFERENCES)`
`summary`	`str \| None`	`None`
`constraint_id`	`str`	`required`

validate_reason_code (method)

CompletionConstraintOutcome.validate_reason_code(value: str) -> str

validate_summary (method)

CompletionConstraintOutcome.validate_summary(value: str | None) -> str | None

copy_evidence_references (method)

CompletionConstraintOutcome.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionConstraintOutcome.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_satisfaction_basis (method)

CompletionConstraintOutcome.validate_satisfaction_basis() -> _CompletionOutcome

validate_constraint_id (method)

CompletionConstraintOutcome.validate_constraint_id(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CompletionContinuationPolicy`

from cayu.tasks import CompletionContinuationPolicy

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`rejection_action`	`CompletionRejectionAction`	`CompletionRejectionAction.INTERRUPT`
`max_attempts`	`StrictInt`	`Field(default=3, ge=1, le=100)`
`max_repeated_gap_count`	`StrictInt`	`Field(default=2, ge=1, le=100)`

Release source · Runtime guarantees · Capability guides

`CompletionCriterionOutcome`

from cayu.tasks import CompletionCriterionOutcome

Bases: _CompletionOutcome.

Fields and attributes

Name	Type	Default
`status`	`CriterionOutcomeStatus`	`required`
`reason_code`	`str`	`required`
`satisfaction_basis`	`CompletionSatisfactionBasis \| None`	`None`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_COMPLETION_OUTCOME_MAX_EVIDENCE_REFERENCES)`
`summary`	`str \| None`	`None`
`criterion_id`	`str`	`required`

validate_reason_code (method)

CompletionCriterionOutcome.validate_reason_code(value: str) -> str

validate_summary (method)

CompletionCriterionOutcome.validate_summary(value: str | None) -> str | None

copy_evidence_references (method)

CompletionCriterionOutcome.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionCriterionOutcome.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_satisfaction_basis (method)

CompletionCriterionOutcome.validate_satisfaction_basis() -> _CompletionOutcome

validate_criterion_id (method)

CompletionCriterionOutcome.validate_criterion_id(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CompletionDecision`

from cayu.tasks import CompletionDecision

Bases: CompletionDecisionCreate.

Fields and attributes

Name	Type	Default
`decision_id`	`str`	`required`
`proposal_id`	`str`	`required`
`claim_id`	`str`	`required`
`worker_id`	`str`	`required`
`verifier`	`CompletionVerifierRef`	`required`
`verifier_profile_fingerprint`	`str`	`required`
`decision_version`	`Literal[1]`	`1`
`verdict`	`CompletionVerdict`	`required`
`criterion_outcomes`	`tuple[CompletionCriterionOutcome, ...]`	`Field(min_length=1, max_length=WORK_CONTRACT_MAX_CRITERIA)`
`constraint_outcomes`	`tuple[CompletionConstraintOutcome, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CONSTRAINTS)`
`gaps`	`tuple[CompletionGap, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CRITERIA + WORK_CONTRACT_MAX_CONSTRAINTS)`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REFERENCES)`
`task_id`	`str`	`required`
`attempt_id`	`str`	`required`
`contract`	`WorkContractRef`	`required`
`claim_authority_sha256`	`str`	`required`
`request_sha256`	`str`	`required`
`gap_fingerprint`	`str`	`required`
`decided_at`	`datetime`	`required`

validate_identity (method)

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

validate_decision_version_type (method)

CompletionDecision.validate_decision_version_type(value: object) -> object

copy_verifier (method)

CompletionDecision.copy_verifier(value: object) -> object

validate_verifier_profile_fingerprint (method)

CompletionDecision.validate_verifier_profile_fingerprint(value: str) -> str

copy_criterion_outcomes (method)

CompletionDecision.copy_criterion_outcomes(value: object) -> object

copy_constraint_outcomes (method)

CompletionDecision.copy_constraint_outcomes(value: object) -> object

copy_gaps (method)

CompletionDecision.copy_gaps(value: object) -> object

copy_evidence_references (method)

CompletionDecision.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionDecision.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_verdict_shape (method)

CompletionDecision.validate_verdict_shape() -> CompletionDecisionCreate

validate_parent_identity (method)

CompletionDecision.validate_parent_identity(value: str, info) -> str

validate_task_id (method)

CompletionDecision.validate_task_id(value: str) -> str

copy_contract (method)

CompletionDecision.copy_contract(value: object) -> object

validate_digest (method)

CompletionDecision.validate_digest(value: str, info) -> str

normalize_decided_at (method)

CompletionDecision.normalize_decided_at(value: datetime) -> datetime

Release source · Runtime guarantees · Capability guides

`CompletionDecisionApplicationRequest`

from cayu.tasks import CompletionDecisionApplicationRequest

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`task_id`	`str`	`required`
`decision_id`	`str`	`required`
`idempotency_key`	`str`	`required`
`result`	`dict[str, object] \| None`	`None`
`result_reference`	`CompletionResultReference \| None`	`None`

validate_identity (method)

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

validate_task_id (method)

CompletionDecisionApplicationRequest.validate_task_id(value: str) -> str

validate_idempotency_key (method)

CompletionDecisionApplicationRequest.validate_idempotency_key(value: str) -> str

copy_result (method)

CompletionDecisionApplicationRequest.copy_result(value: object) -> object

copy_result_reference (method)

CompletionDecisionApplicationRequest.copy_result_reference(value: object) -> object

validate_result_binding (method)

CompletionDecisionApplicationRequest.validate_result_binding() -> CompletionDecisionApplicationRequest

Release source · Runtime guarantees · Capability guides

`CompletionDecisionCreate`

from cayu.tasks import CompletionDecisionCreate

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`decision_id`	`str`	`required`
`proposal_id`	`str`	`required`
`claim_id`	`str`	`required`
`worker_id`	`str`	`required`
`verifier`	`CompletionVerifierRef`	`required`
`verifier_profile_fingerprint`	`str`	`required`
`decision_version`	`Literal[1]`	`1`
`verdict`	`CompletionVerdict`	`required`
`criterion_outcomes`	`tuple[CompletionCriterionOutcome, ...]`	`Field(min_length=1, max_length=WORK_CONTRACT_MAX_CRITERIA)`
`constraint_outcomes`	`tuple[CompletionConstraintOutcome, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CONSTRAINTS)`
`gaps`	`tuple[CompletionGap, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CRITERIA + WORK_CONTRACT_MAX_CONSTRAINTS)`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REFERENCES)`

validate_identity (method)

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

validate_decision_version_type (method)

CompletionDecisionCreate.validate_decision_version_type(value: object) -> object

copy_verifier (method)

CompletionDecisionCreate.copy_verifier(value: object) -> object

validate_verifier_profile_fingerprint (method)

CompletionDecisionCreate.validate_verifier_profile_fingerprint(value: str) -> str

copy_criterion_outcomes (method)

CompletionDecisionCreate.copy_criterion_outcomes(value: object) -> object

copy_constraint_outcomes (method)

CompletionDecisionCreate.copy_constraint_outcomes(value: object) -> object

copy_gaps (method)

CompletionDecisionCreate.copy_gaps(value: object) -> object

copy_evidence_references (method)

CompletionDecisionCreate.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionDecisionCreate.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_verdict_shape (method)

CompletionDecisionCreate.validate_verdict_shape() -> CompletionDecisionCreate

Release source · Runtime guarantees · Capability guides

`CompletionGap`

from cayu.tasks import CompletionGap

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`criterion_id`	`str \| None`	`None`
`constraint_id`	`str \| None`	`None`
`code`	`str`	`required`
`evidence_requirement_ids`	`tuple[str, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REQUIREMENTS)`
`summary`	`str \| None`	`None`

validate_subject_id (method)

CompletionGap.validate_subject_id(value: str | None, info) -> str | None

validate_code (method)

CompletionGap.validate_code(value: str) -> str

validate_evidence_requirement_ids (method)

CompletionGap.validate_evidence_requirement_ids(value: tuple[str, ...]) -> tuple[str, ...]

validate_summary (method)

CompletionGap.validate_summary(value: str | None) -> str | None

validate_exact_subject (method)

CompletionGap.validate_exact_subject() -> CompletionGap

subject_key (method)

CompletionGap.subject_key() -> tuple[str, str]

Release source · Runtime guarantees · Capability guides

`CompletionProposal`

from cayu.tasks import CompletionProposal

Bases: CompletionProposalCreate.

Fields and attributes

Name	Type	Default
`proposal_id`	`str`	`required`
`attempt_id`	`str`	`required`
`result`	`CompletionResultReference`	`required`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REFERENCES)`
`task_id`	`str`	`required`
`contract`	`WorkContractRef`	`required`
`request_sha256`	`str`	`required`
`proposed_at`	`datetime`	`required`

validate_identity (method)

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

copy_result (method)

CompletionProposal.copy_result(value: object) -> object

copy_evidence_references (method)

CompletionProposal.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionProposal.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_proposal_size (method)

CompletionProposal.validate_proposal_size() -> CompletionProposalCreate

validate_task_id (method)

CompletionProposal.validate_task_id(value: str) -> str

copy_contract (method)

CompletionProposal.copy_contract(value: object) -> object

validate_request_sha256 (method)

CompletionProposal.validate_request_sha256(value: str) -> str

normalize_proposed_at (method)

CompletionProposal.normalize_proposed_at(value: datetime) -> datetime

Release source · Runtime guarantees · Capability guides

`CompletionProposalCreate`

from cayu.tasks import CompletionProposalCreate

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`proposal_id`	`str`	`required`
`attempt_id`	`str`	`required`
`result`	`CompletionResultReference`	`required`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REFERENCES)`

validate_identity (method)

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

copy_result (method)

CompletionProposalCreate.copy_result(value: object) -> object

copy_evidence_references (method)

CompletionProposalCreate.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionProposalCreate.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_proposal_size (method)

CompletionProposalCreate.validate_proposal_size() -> CompletionProposalCreate

Release source · Runtime guarantees · Capability guides

`CompletionRejectionAction`

from cayu.tasks import CompletionRejectionAction

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`CONTINUE`	`class attribute`	`'continue'`
`INTERRUPT`	`class attribute`	`'interrupt'`

Release source · Runtime guarantees · Capability guides

`CompletionResultReference`

from cayu.tasks import CompletionResultReference

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`kind`	`str`	`required`
`reference_id`	`str`	`required`
`digest`	`str`	`required`

validate_kind (method)

CompletionResultReference.validate_kind(value: str) -> str

validate_reference_id (method)

CompletionResultReference.validate_reference_id(value: str) -> str

validate_digest (method)

CompletionResultReference.validate_digest(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CompletionResultResolverRef`

from cayu.tasks import CompletionResultResolverRef

Exact application-owned authority for reconstructing an accepted result.

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`resolver_id`	`str`	`required`
`version`	`str`	`required`
`configuration_fingerprint`	`str`	`required`

validate_identity (method)

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

validate_configuration_fingerprint (method)

CompletionResultResolverRef.validate_configuration_fingerprint(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CompletionSatisfactionBasis`

from cayu.tasks import CompletionSatisfactionBasis

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`EVIDENCE`	`class attribute`	`'evidence'`
`VERIFIER_ASSERTION`	`class attribute`	`'verifier_assertion'`

Release source · Runtime guarantees · Capability guides

`CompletionVerdict`

from cayu.tasks import CompletionVerdict

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`ACCEPTED`	`class attribute`	`'accepted'`
`REJECTED`	`class attribute`	`'rejected'`
`BLOCKED`	`class attribute`	`'blocked'`
`NEEDS_REVIEW`	`class attribute`	`'needs_review'`

Release source · Runtime guarantees · Capability guides

`CompletionVerificationClaim`

from cayu.tasks import CompletionVerificationClaim

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`claim_id`	`str`	`required`
`proposal_id`	`str`	`required`
`worker_id`	`str`	`required`
`lease_seconds`	`StrictInt`	`Field(ge=1, le=WORK_VERIFICATION_LEASE_MAX_SECONDS)`
`execution_owner_id`	`str \| None`	`None`
`execution_timeout_seconds`	`StrictFloat \| None`	`Field(default=None, gt=0, le=WORK_VERIFICATION_LEASE_MAX_SECONDS)`
`verifier`	`CompletionVerifierRef`	`required`
`verifier_profile_fingerprint`	`str`	`required`
`attempt_number`	`StrictInt`	`Field(ge=1)`
`request_sha256`	`str`	`required`
`claimed_at`	`datetime`	`required`
`lease_expires_at`	`datetime`	`required`

validate_identity (method)

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

validate_execution_owner_id (method)

CompletionVerificationClaim.validate_execution_owner_id(value: str | None) -> str | None

copy_verifier (method)

CompletionVerificationClaim.copy_verifier(value: object) -> object

validate_verifier_profile_fingerprint (method)

CompletionVerificationClaim.validate_verifier_profile_fingerprint(value: str) -> str

validate_request_sha256 (method)

CompletionVerificationClaim.validate_request_sha256(value: str) -> str

normalize_timestamps (method)

CompletionVerificationClaim.normalize_timestamps(value: datetime, info) -> datetime

validate_lease_window (method)

CompletionVerificationClaim.validate_lease_window() -> CompletionVerificationClaim

Release source · Runtime guarantees · Capability guides

`CompletionVerificationClaimLost`

from cayu.tasks import CompletionVerificationClaimLost

A verifier no longer owns the live claim for a completion proposal.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`CompletionVerificationClaimRequest`

from cayu.tasks import CompletionVerificationClaimRequest

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`claim_id`	`str`	`required`
`proposal_id`	`str`	`required`
`worker_id`	`str`	`required`
`execution_owner_id`	`str \| None`	`None`
`verifier`	`CompletionVerifierRef`	`required`
`verifier_profile_fingerprint`	`str`	`required`
`lease_seconds`	`StrictInt`	`Field(default=300, ge=1, le=WORK_VERIFICATION_LEASE_MAX_SECONDS)`
`execution_timeout_seconds`	`StrictFloat \| None`	`Field(default=None, gt=0, le=WORK_VERIFICATION_LEASE_MAX_SECONDS)`

validate_identity (method)

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

validate_execution_owner_id (method)

CompletionVerificationClaimRequest.validate_execution_owner_id(value: str | None) -> str | None

copy_verifier (method)

CompletionVerificationClaimRequest.copy_verifier(value: object) -> object

validate_verifier_profile_fingerprint (method)

CompletionVerificationClaimRequest.validate_verifier_profile_fingerprint(value: str) -> str

validate_execution_timeout_within_lease (method)

CompletionVerificationClaimRequest.validate_execution_timeout_within_lease() -> CompletionVerificationClaimRequest

Release source · Runtime guarantees · Capability guides

`CompletionVerifierDecision`

from cayu.tasks import CompletionVerifierDecision

Verifier-owned outcome before Cayu binds durable decision authority.

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`verdict`	`CompletionVerdict`	`required`
`criterion_outcomes`	`tuple[CompletionCriterionOutcome, ...]`	`Field(min_length=1, max_length=WORK_CONTRACT_MAX_CRITERIA)`
`constraint_outcomes`	`tuple[CompletionConstraintOutcome, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CONSTRAINTS)`
`gaps`	`tuple[CompletionGap, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CRITERIA + WORK_CONTRACT_MAX_CONSTRAINTS)`
`evidence_references`	`tuple[WorkEvidenceReference, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REFERENCES)`

copy_criterion_outcomes (method)

CompletionVerifierDecision.copy_criterion_outcomes(value: object) -> object

copy_constraint_outcomes (method)

CompletionVerifierDecision.copy_constraint_outcomes(value: object) -> object

copy_gaps (method)

CompletionVerifierDecision.copy_gaps(value: object) -> object

copy_evidence_references (method)

CompletionVerifierDecision.copy_evidence_references(value: object) -> object

validate_evidence_references (method)

CompletionVerifierDecision.validate_evidence_references(value: tuple[WorkEvidenceReference, ...]) -> tuple[WorkEvidenceReference, ...]

validate_verdict_shape (method)

CompletionVerifierDecision.validate_verdict_shape() -> CompletionVerifierDecision

Release source · Runtime guarantees · Capability guides

`CompletionVerifierKind`

from cayu.tasks import CompletionVerifierKind

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`DETERMINISTIC`	`class attribute`	`'deterministic'`
`PROVIDER`	`class attribute`	`'provider'`

Release source · Runtime guarantees · Capability guides

`CompletionVerifierRef`

from cayu.tasks import CompletionVerifierRef

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`verifier_id`	`str`	`required`
`version`	`str`	`required`
`kind`	`CompletionVerifierKind`	`CompletionVerifierKind.DETERMINISTIC`
`configuration_fingerprint`	`str`	`required`

validate_identity (method)

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

validate_configuration_fingerprint (method)

CompletionVerifierRef.validate_configuration_fingerprint(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CriterionOutcomeStatus`

from cayu.tasks import CriterionOutcomeStatus

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`SATISFIED`	`class attribute`	`'satisfied'`
`UNSATISFIED`	`class attribute`	`'unsatisfied'`
`UNVERIFIABLE`	`class attribute`	`'unverifiable'`

Release source · Runtime guarantees · Capability guides

`TaskCompletionDecisionRequired`

from cayu.tasks import TaskCompletionDecisionRequired

A contracted task cannot complete without an accepted durable decision.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`work_contract_fingerprint`

from cayu.tasks import work_contract_fingerprint

work_contract_fingerprint(contract: WorkContractDraft) -> str

Release source · Runtime guarantees · Capability guides

`work_contract_from_draft`

from cayu.tasks import work_contract_from_draft

work_contract_from_draft(draft: WorkContractDraft) -> WorkContract

Release source · Runtime guarantees · Capability guides

`WorkAttempt`

from cayu.tasks import WorkAttempt

Bases: WorkAttemptCreate.

Fields and attributes

Name	Type	Default
`attempt_id`	`str`	`required`
`task_id`	`str`	`required`
`session_id`	`str`	`required`
`contract`	`WorkContractRef`	`required`
`execution_profile_fingerprint`	`str`	`required`
`worker_id`	`str \| None`	`None`
`ordinal`	`StrictInt`	`Field(ge=1)`
`request_sha256`	`str`	`required`
`started_at`	`datetime`	`required`

validate_identity (method)

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

validate_inherited_identity (method)

WorkAttempt.validate_inherited_identity(value: str, info) -> str

validate_worker_id (method)

WorkAttempt.validate_worker_id(value: str | None) -> str | None

validate_execution_profile_fingerprint (method)

WorkAttempt.validate_execution_profile_fingerprint(value: str) -> str

copy_contract (method)

WorkAttempt.copy_contract(value: object) -> object

validate_request_sha256 (method)

WorkAttempt.validate_request_sha256(value: str) -> str

normalize_started_at (method)

WorkAttempt.normalize_started_at(value: datetime) -> datetime

Release source · Runtime guarantees · Capability guides

`WorkAttemptCreate`

from cayu.tasks import WorkAttemptCreate

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`attempt_id`	`str`	`required`
`task_id`	`str`	`required`
`session_id`	`str`	`required`
`contract`	`WorkContractRef`	`required`
`execution_profile_fingerprint`	`str`	`required`
`worker_id`	`str \| None`	`None`

validate_identity (method)

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

validate_inherited_identity (method)

WorkAttemptCreate.validate_inherited_identity(value: str, info) -> str

validate_worker_id (method)

WorkAttemptCreate.validate_worker_id(value: str | None) -> str | None

validate_execution_profile_fingerprint (method)

WorkAttemptCreate.validate_execution_profile_fingerprint(value: str) -> str

copy_contract (method)

WorkAttemptCreate.copy_contract(value: object) -> object

Release source · Runtime guarantees · Capability guides

`WorkCompletionConflict`

from cayu.tasks import WorkCompletionConflict

A stable work-completion identity is already bound to another operation.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`WorkConstraint`

from cayu.tasks import WorkConstraint

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`constraint_id`	`str`	`required`
`description`	`str`	`required`
`evidence_requirement_ids`	`tuple[str, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REQUIREMENTS)`

validate_constraint_id (method)

WorkConstraint.validate_constraint_id(value: str) -> str

validate_description (method)

WorkConstraint.validate_description(value: str) -> str

validate_evidence_requirement_ids (method)

WorkConstraint.validate_evidence_requirement_ids(value: tuple[str, ...]) -> tuple[str, ...]

Release source · Runtime guarantees · Capability guides

`WorkContract`

from cayu.tasks import WorkContract

Bases: WorkContractDraft.

Fields and attributes

Name	Type	Default
`contract_id`	`str`	`required`
`version`	`StrictInt`	`Field(ge=1)`
`supersedes`	`WorkContractRef \| None`	`None`
`objective`	`str`	`required`
`criteria`	`tuple[WorkCriterion, ...]`	`Field(min_length=1, max_length=WORK_CONTRACT_MAX_CRITERIA)`
`constraints`	`tuple[WorkConstraint, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CONSTRAINTS)`
`evidence_requirements`	`tuple[WorkEvidenceRequirement, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REQUIREMENTS)`
`verifier`	`CompletionVerifierRef`	`required`
`result_resolver`	`CompletionResultResolverRef`	`required`
`continuation_policy`	`CompletionContinuationPolicy`	`Field(default_factory=CompletionContinuationPolicy)`
`fingerprint`	`str`	`required`

validate_contract_id (method)

WorkContract.validate_contract_id(value: str) -> str

validate_objective (method)

WorkContract.validate_objective(value: str) -> str

copy_nested_model (method)

WorkContract.copy_nested_model(value: object) -> object

copy_criteria (method)

WorkContract.copy_criteria(value: object) -> object

copy_constraints (method)

WorkContract.copy_constraints(value: object) -> object

copy_evidence_requirements (method)

WorkContract.copy_evidence_requirements(value: object) -> object

validate_contract_definition (method)

WorkContract.validate_contract_definition() -> WorkContractDraft

validate_fingerprint_format (method)

WorkContract.validate_fingerprint_format(value: str) -> str

validate_fingerprint_matches_definition (method)

WorkContract.validate_fingerprint_matches_definition() -> WorkContract

reference (method)

WorkContract.reference() -> WorkContractRef

Release source · Runtime guarantees · Capability guides

`WorkContractConflict`

from cayu.tasks import WorkContractConflict

A stable work-contract identity is already bound to different content.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`WorkContractDraft`

from cayu.tasks import WorkContractDraft

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`contract_id`	`str`	`required`
`version`	`StrictInt`	`Field(ge=1)`
`supersedes`	`WorkContractRef \| None`	`None`
`objective`	`str`	`required`
`criteria`	`tuple[WorkCriterion, ...]`	`Field(min_length=1, max_length=WORK_CONTRACT_MAX_CRITERIA)`
`constraints`	`tuple[WorkConstraint, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_CONSTRAINTS)`
`evidence_requirements`	`tuple[WorkEvidenceRequirement, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REQUIREMENTS)`
`verifier`	`CompletionVerifierRef`	`required`
`result_resolver`	`CompletionResultResolverRef`	`required`
`continuation_policy`	`CompletionContinuationPolicy`	`Field(default_factory=CompletionContinuationPolicy)`

validate_contract_id (method)

WorkContractDraft.validate_contract_id(value: str) -> str

validate_objective (method)

WorkContractDraft.validate_objective(value: str) -> str

copy_nested_model (method)

WorkContractDraft.copy_nested_model(value: object) -> object

copy_criteria (method)

WorkContractDraft.copy_criteria(value: object) -> object

copy_constraints (method)

WorkContractDraft.copy_constraints(value: object) -> object

copy_evidence_requirements (method)

WorkContractDraft.copy_evidence_requirements(value: object) -> object

validate_contract_definition (method)

WorkContractDraft.validate_contract_definition() -> WorkContractDraft

Release source · Runtime guarantees · Capability guides

`WorkContractRef`

from cayu.tasks import WorkContractRef

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`contract_id`	`str`	`required`
`version`	`StrictInt`	`Field(ge=1)`
`fingerprint`	`str`	`required`

validate_contract_id (method)

WorkContractRef.validate_contract_id(value: str) -> str

validate_fingerprint (method)

WorkContractRef.validate_fingerprint(value: str) -> str

Release source · Runtime guarantees · Capability guides

`WorkCriterion`

from cayu.tasks import WorkCriterion

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`criterion_id`	`str`	`required`
`ordinal`	`StrictInt`	`Field(ge=1, le=WORK_CONTRACT_MAX_CRITERIA)`
`description`	`str`	`required`
`evidence_requirement_ids`	`tuple[str, ...]`	`Field(default=(), max_length=WORK_CONTRACT_MAX_EVIDENCE_REQUIREMENTS)`

validate_criterion_id (method)

WorkCriterion.validate_criterion_id(value: str) -> str

validate_description (method)

WorkCriterion.validate_description(value: str) -> str

validate_evidence_requirement_ids (method)

WorkCriterion.validate_evidence_requirement_ids(value: tuple[str, ...]) -> tuple[str, ...]

Release source · Runtime guarantees · Capability guides

`WorkEvidenceReference`

from cayu.tasks import WorkEvidenceReference

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`kind`	`str`	`required`
`reference_id`	`str`	`required`
`requirement_id`	`str \| None`	`None`
`version`	`str \| None`	`None`
`digest`	`str \| None`	`None`
`available`	`StrictBool`	`True`
`unavailable_reason`	`str \| None`	`None`

validate_kind (method)

WorkEvidenceReference.validate_kind(value: str) -> str

validate_reference_id (method)

WorkEvidenceReference.validate_reference_id(value: str) -> str

validate_requirement_id (method)

WorkEvidenceReference.validate_requirement_id(value: str | None) -> str | None

validate_version (method)

WorkEvidenceReference.validate_version(value: str | None) -> str | None

validate_digest (method)

WorkEvidenceReference.validate_digest(value: str | None) -> str | None

validate_unavailable_reason (method)

WorkEvidenceReference.validate_unavailable_reason(value: str | None) -> str | None

validate_availability (method)

WorkEvidenceReference.validate_availability() -> WorkEvidenceReference

Release source · Runtime guarantees · Capability guides

`WorkEvidenceRequirement`

from cayu.tasks import WorkEvidenceRequirement

Bases: FrozenWorkContractModel.

Fields and attributes

Name	Type	Default
`requirement_id`	`str`	`required`
`kind`	`str`	`required`
`description`	`str`	`required`

validate_requirement_id (method)

WorkEvidenceRequirement.validate_requirement_id(value: str) -> str

validate_kind (method)

WorkEvidenceRequirement.validate_kind(value: str) -> str

validate_description (method)

WorkEvidenceRequirement.validate_description(value: str) -> str

Release source · Runtime guarantees · Capability guides