cayu.tasks.completion_verifier_profiles

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.

CompletionVerifierExecutionProfile

from cayu import CompletionVerifierExecutionProfile

Immutable verifier-specific profile, distinct from a session profile.

Bases: FrozenWorkContractModel.

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
schema_version	Literal[1]	COMPLETION_VERIFIER_PROFILE_SCHEMA_VERSION
verifier	CompletionVerifierRef	required
components	tuple[CompletionVerifierProfileComponentIdentity, ...]	Field(min_length=1, max_length=COMPLETION_VERIFIER_PROFILE_COMPONENT_MAX_ITEMS + 1)
fingerprint	str	required

validate_schema_version_type (method)

CompletionVerifierExecutionProfile.validate_schema_version_type(value: object) -> object

copy_verifier (method)

CompletionVerifierExecutionProfile.copy_verifier(value: object) -> object

copy_components (method)

CompletionVerifierExecutionProfile.copy_components(value: object) -> object

validate_fingerprint (method)

CompletionVerifierExecutionProfile.validate_fingerprint(value: str) -> str

validate_canonical_profile (method)

CompletionVerifierExecutionProfile.validate_canonical_profile() -> CompletionVerifierExecutionProfile

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfileAdoptionDecision

from cayu import CompletionVerifierProfileAdoptionDecision

Durable authorization for one changed verifier profile.

Bases: FrozenWorkContractModel.

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
expected_profile_fingerprint	str	required
candidate_profile_fingerprint	str	required
changed_component_ids	tuple[str, ...]	Field(min_length=1, max_length=COMPLETION_VERIFIER_PROFILE_CHANGED_COMPONENT_MAX_ITEMS)
policy_identity	str	Field(max_length=COMPLETION_VERIFIER_PROFILE_TEXT_MAX_CHARS)
authority_decision	Literal[ExecutionProfileAuthorityDecision.AUTHORIZED]	required
idempotency_key	str	required
requested_by	ResolutionActor	required
reason	str	Field(max_length=EXECUTION_PROFILE_ADOPTION_TEXT_MAX_CHARS)
policy_reason	str	Field(max_length=EXECUTION_PROFILE_ADOPTION_TEXT_MAX_CHARS)
request_sha256	str	required

validate_digest (method)

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

validate_changed_component_ids (method)

CompletionVerifierProfileAdoptionDecision.validate_changed_component_ids(value: tuple[str, ...]) -> tuple[str, ...]

validate_identity_text (method)

CompletionVerifierProfileAdoptionDecision.validate_identity_text(value: str, info) -> str

validate_reason_text (method)

CompletionVerifierProfileAdoptionDecision.validate_reason_text(value: str, info) -> str

validate_idempotency_key (method)

CompletionVerifierProfileAdoptionDecision.validate_idempotency_key(value: str) -> str

copy_requested_by (method)

CompletionVerifierProfileAdoptionDecision.copy_requested_by(value: object) -> ResolutionActor

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfileComponentDeclaration

from cayu import CompletionVerifierProfileComponentDeclaration

Application-declared identity input for one verifier dependency.

Bases: FrozenWorkContractModel.

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
component_id	str	Field(max_length=COMPLETION_VERIFIER_PROFILE_TEXT_MAX_CHARS)
identity	ExecutionProfileBehaviorIdentity	required

validate_component_id (method)

CompletionVerifierProfileComponentDeclaration.validate_component_id(value: str) -> str

copy_identity (method)

CompletionVerifierProfileComponentDeclaration.copy_identity(value: object) -> ExecutionProfileBehaviorIdentity

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfileComponentIdentity

from cayu import CompletionVerifierProfileComponentIdentity

Bounded fingerprint-only authority for one verifier component.

Bases: FrozenWorkContractModel.

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
component_id	str	Field(max_length=COMPLETION_VERIFIER_PROFILE_TEXT_MAX_CHARS)
strength	Literal[ExecutionProfileIdentityStrength.APPLICATION_VERSIONED]	ExecutionProfileIdentityStrength.APPLICATION_VERSIONED
fingerprint	str	required

validate_component_id (method)

CompletionVerifierProfileComponentIdentity.validate_component_id(value: str) -> str

validate_fingerprint (method)

CompletionVerifierProfileComponentIdentity.validate_fingerprint(value: str) -> str

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfilePolicy

from cayu import CompletionVerifierProfilePolicy

Application-owned authorization for verifier-profile transitions.

Bases: ABC.

identity (property)

CompletionVerifierProfilePolicy.identity() -> str

Return a stable, versioned, nonsecret policy identity.

decide (method)

async CompletionVerifierProfilePolicy.decide(request: CompletionVerifierProfilePolicyRequest) -> ExecutionProfilePolicyResult

Authorize or reject one changed verifier profile.

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfilePolicyRequest

from cayu import CompletionVerifierProfilePolicyRequest

Application-policy input for one non-equal verifier profile.

Bases: FrozenWorkContractModel.

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
proposal_id	str	required
attempt_id	str	required
expected_profile	CompletionVerifierExecutionProfile	required
candidate_profile	CompletionVerifierExecutionProfile	required
changed_component_ids	tuple[str, ...]	required
intent	ExecutionProfileAdoptionIntent	required

validate_identity (method)

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

copy_profile (method)

CompletionVerifierProfilePolicyRequest.copy_profile(value: object) -> object

copy_intent (method)

CompletionVerifierProfilePolicyRequest.copy_intent(value: object) -> ExecutionProfileAdoptionIntent

validate_changed_components (method)

CompletionVerifierProfilePolicyRequest.validate_changed_components() -> CompletionVerifierProfilePolicyRequest

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfilePreparationRequest

from cayu import CompletionVerifierProfilePreparationRequest

Exact insert-only request for one proposal’s verifier profile.

Bases: FrozenWorkContractModel.

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
proposal_id	str	required
task_id	str	required
attempt_id	str	required
attempt_request_sha256	str	required
source_execution_profile_fingerprint	str	required
proposal_request_sha256	str	required
contract	WorkContractRef	required
profile	CompletionVerifierExecutionProfile	required
expected_prior_proposal_id	str | None	None
expected_prior_profile_fingerprint	str | None	None
adoption	CompletionVerifierProfileAdoptionDecision | None	None

validate_identity (method)

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

validate_digest (method)

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

validate_optional_digest (method)

CompletionVerifierProfilePreparationRequest.validate_optional_digest(value: str | None) -> str | None

validate_optional_prior_proposal_id (method)

CompletionVerifierProfilePreparationRequest.validate_optional_prior_proposal_id(value: str | None) -> str | None

copy_contract (method)

CompletionVerifierProfilePreparationRequest.copy_contract(value: object) -> object

copy_profile (method)

CompletionVerifierProfilePreparationRequest.copy_profile(value: object) -> object

copy_adoption (method)

CompletionVerifierProfilePreparationRequest.copy_adoption(value: object) -> object

validate_adoption_shape (method)

CompletionVerifierProfilePreparationRequest.validate_adoption_shape() -> CompletionVerifierProfilePreparationRequest

Release source · Runtime guarantees · Capability guides

CompletionVerifierProfileRecord

from cayu import CompletionVerifierProfileRecord

Immutable durable profile authority prepared before verifier dispatch.

Bases: CompletionVerifierProfilePreparationRequest.

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
proposal_id	str	required
task_id	str	required
attempt_id	str	required
attempt_request_sha256	str	required
source_execution_profile_fingerprint	str	required
proposal_request_sha256	str	required
contract	WorkContractRef	required
profile	CompletionVerifierExecutionProfile	required
expected_prior_proposal_id	str | None	None
expected_prior_profile_fingerprint	str | None	None
adoption	CompletionVerifierProfileAdoptionDecision | None	None
request_sha256	str	required
prepared_at	datetime	required

validate_identity (method)

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

validate_digest (method)

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

validate_optional_digest (method)

CompletionVerifierProfileRecord.validate_optional_digest(value: str | None) -> str | None

validate_optional_prior_proposal_id (method)

CompletionVerifierProfileRecord.validate_optional_prior_proposal_id(value: str | None) -> str | None

copy_contract (method)

CompletionVerifierProfileRecord.copy_contract(value: object) -> object

copy_profile (method)

CompletionVerifierProfileRecord.copy_profile(value: object) -> object

copy_adoption (method)

CompletionVerifierProfileRecord.copy_adoption(value: object) -> object

validate_adoption_shape (method)

CompletionVerifierProfileRecord.validate_adoption_shape() -> CompletionVerifierProfilePreparationRequest

validate_request_sha256 (method)

CompletionVerifierProfileRecord.validate_request_sha256(value: str) -> str

normalize_prepared_at (method)

CompletionVerifierProfileRecord.normalize_prepared_at(value: datetime) -> datetime

Release source · Runtime guarantees · Capability guides