cayu.coding_products

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.

`admit_coding_product_request`

from cayu import admit_coding_product_request

Observe exact source authority and construct one immutable product request.

async admit_coding_product_request(*, product_run_id: str, session_id: str, agent_name: str, task_id: str, messages: Sequence[Message], source_workspace: Workspace, source_origin_id: str, source_destination_id: str, source_git_baseline: CodingGitBaselineAuthority, runtime: CodingRuntimeAuthority, settlement: CodingSettlementPolicy | None=None, observation_limits: WorkspaceRevisionObservationLimits | None=None, parent_session_id: str | None=None, causal_budget_id: str | None=None) -> CodingProductRequest

Release source · Runtime guarantees · Capability guides

`admit_or_recover_coding_product_request`

from cayu import admit_or_recover_coding_product_request

Recover immutable admission authority or create and retain it exactly once.

async admit_or_recover_coding_product_request(*, repository: CodingProductArtifactRepository, product_run_id: str, session_id: str, agent_name: str, task_id: str, messages: Sequence[Message], source_workspace: Workspace, source_origin_id: str, source_destination_id: str, source_git_baseline: CodingGitBaselineAuthority, runtime: CodingRuntimeAuthority, settlement: CodingSettlementPolicy | None=None, observation_limits: WorkspaceRevisionObservationLimits | None=None, parent_session_id: str | None=None, causal_budget_id: str | None=None) -> CodingProductRequest

Release source · Runtime guarantees · Capability guides

`coding_product_completion_decision`

from cayu import coding_product_completion_decision

Evaluate exact candidate evidence without granting application authority.

coding_product_completion_decision(request: CodingProductRequest, candidate: CodingProductCandidate, *, evidence: WorkEvidenceReference, public_authority_alias_codec: PublicAuthorityAliasCodec | None=None) -> CompletionVerifierDecision

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_EVIDENCE_KIND`

from cayu import CODING_PRODUCT_EVIDENCE_KIND

CODING_PRODUCT_EVIDENCE_KIND = 'coding_product_evidence'

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_EVENT_BYTES`

from cayu import CODING_PRODUCT_MAX_EVENT_BYTES

CODING_PRODUCT_MAX_EVENT_BYTES = 16 * 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_EVENTS`

from cayu import CODING_PRODUCT_MAX_EVENTS

CODING_PRODUCT_MAX_EVENTS = 20000

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_GIT_DIFF_BYTES`

from cayu import CODING_PRODUCT_MAX_GIT_DIFF_BYTES

CODING_PRODUCT_MAX_GIT_DIFF_BYTES = 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_LIFECYCLE_RECEIPTS`

from cayu import CODING_PRODUCT_MAX_LIFECYCLE_RECEIPTS

CODING_PRODUCT_MAX_LIFECYCLE_RECEIPTS = 64

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_MUTATION_ARTIFACT_BYTES`

from cayu import CODING_PRODUCT_MAX_MUTATION_ARTIFACT_BYTES

CODING_PRODUCT_MAX_MUTATION_ARTIFACT_BYTES = 3 * 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_RESULT_BYTES`

from cayu import CODING_PRODUCT_MAX_RESULT_BYTES

CODING_PRODUCT_MAX_RESULT_BYTES = 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_SOURCE_ARTIFACT_BYTES`

from cayu import CODING_PRODUCT_MAX_SOURCE_ARTIFACT_BYTES

CODING_PRODUCT_MAX_SOURCE_ARTIFACT_BYTES = 16 * 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_MAX_TOOL_OUTPUT_ARTIFACT_BYTES`

from cayu import CODING_PRODUCT_MAX_TOOL_OUTPUT_ARTIFACT_BYTES

CODING_PRODUCT_MAX_TOOL_OUTPUT_ARTIFACT_BYTES = 1024 * 1024

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_RESULT_KIND`

from cayu import CODING_PRODUCT_RESULT_KIND

CODING_PRODUCT_RESULT_KIND = 'coding_product_result'

Release source · Runtime guarantees · Capability guides

`CODING_PRODUCT_SCHEMA_VERSION`

from cayu import CODING_PRODUCT_SCHEMA_VERSION

CODING_PRODUCT_SCHEMA_VERSION = 'cayu.coding_product.v1'

Release source · Runtime guarantees · Capability guides

`coding_product_work_contract`

from cayu import coding_product_work_contract

Build the exact WorkContract used by the product verifier and resolver.

coding_product_work_contract(request: CodingProductRequest, repository: CodingProductArtifactRepository) -> WorkContract

Release source · Runtime guarantees · Capability guides

`CodingArtifactReference`

from cayu import CodingArtifactReference

Bases: _FrozenCodingModel.

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
`artifact_id`	`str`	`required`
`sha256`	`str`	`required`
`size_bytes`	`StrictInt`	`Field(ge=0)`
`content_type`	`str`	`'application/json'`

validate_identity (method)

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

validate_sha256 (method)

CodingArtifactReference.validate_sha256(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CodingCheckEvidence`

from cayu import CodingCheckEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`check`	`str`	`required`
`event_id`	`str`	`required`
`profile_fingerprint`	`str`	`required`
`status`	`str`	`required`
`exit_code`	`StrictInt \| None`	`None`
`output_sha256`	`str \| None`	`None`
`output_artifact`	`CodingArtifactReference \| None`	`None`
`duration_ms`	`StrictInt \| None`	`Field(default=None, ge=0)`
`stdout_truncated`	`StrictBool`	`False`
`stderr_truncated`	`StrictBool`	`False`
`stdout_runner_truncated`	`StrictBool`	`False`
`stderr_runner_truncated`	`StrictBool`	`False`
`stdout_projection_truncated`	`StrictBool`	`False`
`stderr_projection_truncated`	`StrictBool`	`False`
`output_artifact_status`	`str \| None`	`None`
`timed_out`	`StrictBool`	`False`
`cancelled`	`StrictBool`	`False`
`workspace_mutation_settlement`	`str \| None`	`None`
`workspace_revision`	`str \| None`	`None`

validate_optional_identity (method)

CodingCheckEvidence.validate_optional_identity(value: str | None, info) -> str | None

validate_optional_fingerprint (method)

CodingCheckEvidence.validate_optional_fingerprint(value: str | None, info) -> str | None

settled_pass (property)

CodingCheckEvidence.settled_pass() -> bool

Release source · Runtime guarantees · Capability guides

`CodingCommandEvidence`

from cayu import CodingCommandEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`selector`	`str`	`required`
`event_id`	`str`	`required`
`selector_fingerprint`	`str`	`required`
`argv_sha256`	`str \| None`	`None`
`status`	`str`	`required`
`exit_code`	`StrictInt \| None`	`None`
`duration_ms`	`StrictInt \| None`	`Field(default=None, ge=0)`
`output_sha256`	`str \| None`	`None`
`output_artifact`	`CodingArtifactReference \| None`	`None`
`output_truncated`	`StrictBool`	`False`
`output_runner_truncated`	`StrictBool`	`False`
`output_projection_truncated`	`StrictBool`	`False`
`output_artifact_status`	`str \| None`	`None`
`exit_code_admitted`	`StrictBool`	`False`
`output_collection_complete`	`StrictBool`	`False`
`output_publication_complete`	`StrictBool`	`False`
`timed_out`	`StrictBool`	`False`
`cancelled`	`StrictBool`	`False`
`workspace_mutation_settlement`	`str \| None`	`None`

validate_optional_identity (method)

CodingCommandEvidence.validate_optional_identity(value: str | None, info) -> str | None

validate_optional_fingerprint (method)

CodingCommandEvidence.validate_optional_fingerprint(value: str | None, info) -> str | None

settled (property)

CodingCommandEvidence.settled() -> bool

Release source · Runtime guarantees · Capability guides

`CodingGitBaselineAuthority`

from cayu import CodingGitBaselineAuthority

Application-observed clean Git state for the admitted source tree.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`head_revision`	`str`	`required`
`staged_entries_sha256`	`str`	`required`
`tracked_flags_sha256`	`str`	`required`
`status_sha256`	`str`	`required`
`diff_sha256`	`str`	`required`
`clean`	`Literal[True]`	`True`

validate_head_revision (method)

CodingGitBaselineAuthority.validate_head_revision(value: str) -> str

validate_git_digest (method)

CodingGitBaselineAuthority.validate_git_digest(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

`CodingGitEntry`

from cayu import CodingGitEntry

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`path`	`str`	`required`
`index`	`str`	`required`
`worktree`	`str`	`required`
`renamed_from`	`str \| None`	`None`

validate_entry_text (method)

CodingGitEntry.validate_entry_text(value: str | None, info) -> str | None

validate_status_code (method)

CodingGitEntry.validate_status_code(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

`CodingGitEvidence`

from cayu import CodingGitEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`event_id`	`str`	`required`
`mode`	`Literal['diff']`	`'diff'`
`scope`	`str`	`required`
`artifact`	`CodingArtifactReference`	`required`
`entries`	`tuple[CodingGitEntry, ...]`	`()`
`entry_count`	`StrictInt`	`Field(ge=0)`
`truncated`	`StrictBool`	`False`
`binary_omitted`	`StrictBool`	`False`

validate_identity (method)

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

validate_entry_count (method)

CodingGitEvidence.validate_entry_count() -> CodingGitEvidence

Release source · Runtime guarantees · Capability guides

`CodingGitStatusEvidence`

from cayu import CodingGitStatusEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`event_id`	`str`	`required`
`mode`	`Literal['status']`	`'status'`
`scope`	`str`	`required`
`entries`	`tuple[CodingGitEntry, ...]`	`()`
`truncated`	`StrictBool`	`False`

validate_identity (method)

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

Release source · Runtime guarantees · Capability guides

`CodingGitSummaryEntry`

from cayu import CodingGitSummaryEntry

Bases: CodingGitEntry.

Fields and attributes

Name	Type	Default
`path`	`str`	`required`
`index`	`str`	`required`
`worktree`	`str`	`required`
`renamed_from`	`str \| None`	`None`
`additions`	`StrictInt \| None`	`Field(default=None, ge=0)`
`deletions`	`StrictInt \| None`	`Field(default=None, ge=0)`
`count_kind`	`Literal['text', 'binary', 'untracked', 'unknown']`	`required`

validate_entry_text (method)

CodingGitSummaryEntry.validate_entry_text(value: str | None, info) -> str | None

validate_status_code (method)

CodingGitSummaryEntry.validate_status_code(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

`CodingGitSummaryEvidence`

from cayu import CodingGitSummaryEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`event_id`	`str`	`required`
`mode`	`Literal['summary']`	`'summary'`
`scope`	`str`	`required`
`entries`	`tuple[CodingGitSummaryEntry, ...]`	`()`
`truncated`	`StrictBool`	`False`

validate_identity (method)

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

Release source · Runtime guarantees · Capability guides

`CodingLifecycleReceipt`

from cayu import CodingLifecycleReceipt

One append-only, idempotently addressable product-state transition.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal['cayu.coding_product_lifecycle.v1']`	`'cayu.coding_product_lifecycle.v1'`
`product_run_id`	`str`	`required`
`session_id`	`str`	`required`
`request_fingerprint`	`str`	`required`
`ordinal`	`StrictInt`	`Field(ge=1, le=CODING_PRODUCT_MAX_LIFECYCLE_RECEIPTS)`
`prior_state`	`CodingProductState \| None`	`None`
`state`	`CodingProductState`	`required`
`evidence_sha256`	`str \| None`	`None`
`reason_code`	`str \| None`	`None`

validate_optional_identity (method)

CodingLifecycleReceipt.validate_optional_identity(value: str | None, info) -> str | None

validate_request_fingerprint (method)

CodingLifecycleReceipt.validate_request_fingerprint(value: str) -> str

validate_evidence_sha256 (method)

CodingLifecycleReceipt.validate_evidence_sha256(value: str | None) -> str | None

validate_transition (method)

CodingLifecycleReceipt.validate_transition() -> CodingLifecycleReceipt

Release source · Runtime guarantees · Capability guides

`CodingMutationEvidence`

from cayu import CodingMutationEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`tool_name`	`str`	`required`
`event_id`	`str`	`required`
`outcome`	`str`	`required`
`operation_identity`	`str \| None`	`None`
`artifact`	`CodingArtifactReference \| None`	`None`
`evidence_sha256`	`str`	`required`
`requires_fresh_read`	`StrictBool`	`False`

validate_optional_identity (method)

CodingMutationEvidence.validate_optional_identity(value: str | None, info) -> str | None

validate_evidence_sha256 (method)

CodingMutationEvidence.validate_evidence_sha256(value: str) -> str

settled (property)

CodingMutationEvidence.settled() -> bool

Release source · Runtime guarantees · Capability guides

`CodingProductAdmissionError`

from cayu import CodingProductAdmissionError

The application-supplied product authority cannot be admitted.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`CodingProductArtifactRepository`

from cayu import CodingProductArtifactRepository

Durable append-only lifecycle and result storage over an ArtifactStore.

init (method)

CodingProductArtifactRepository.__init__(store: ArtifactStore) -> None

configuration_fingerprint (property)

CodingProductArtifactRepository.configuration_fingerprint() -> str

lifecycle_artifact_id (method)

CodingProductArtifactRepository.lifecycle_artifact_id(product_run_id: str, ordinal: int) -> str

request_artifact_id (method)

CodingProductArtifactRepository.request_artifact_id(product_run_id: str) -> str

execution_claim_artifact_id (method)

CodingProductArtifactRepository.execution_claim_artifact_id(product_run_id: str) -> str

acquire_execution_claim (method)

async CodingProductArtifactRepository.acquire_execution_claim(request: CodingProductRequest, *, claim_id: str) -> CodingArtifactReference

Atomically fence one stable product identity before session dispatch.

validate_candidate_artifacts (method)

async CodingProductArtifactRepository.validate_candidate_artifacts(candidate: CodingProductCandidate) -> None

Reconstruct every artifact capable of supporting a successful candidate.

load_request (method)

async CodingProductArtifactRepository.load_request(product_run_id: str, *, session_id: str) -> CodingProductRequest

Load the exact admitted request used to recover a stable product run.

ensure_request (method)

async CodingProductArtifactRepository.ensure_request(request: CodingProductRequest) -> CodingArtifactReference

Publish once or verify the already-admitted immutable request authority.

append_lifecycle (method)

async CodingProductArtifactRepository.append_lifecycle(receipt: CodingLifecycleReceipt) -> CodingArtifactReference

load_lifecycle (method)

async CodingProductArtifactRepository.load_lifecycle(product_run_id: str, *, session_id: str, request_fingerprint: str) -> tuple[tuple[CodingLifecycleReceipt, ...], tuple[str, ...]]

load_initial_source_observation (method)

async CodingProductArtifactRepository.load_initial_source_observation(request: CodingProductRequest) -> WorkspaceRevisionObservation

Read the exact retained baseline; this does not authorize execution.

publish_source_observation (method)

async CodingProductArtifactRepository.publish_source_observation(*, session_id: str, agent_name: str, environment_name: str, phase: Literal['initial', 'final'], observation: WorkspaceRevisionObservation) -> CodingSourceObservationEvidence

Retain one bounded complete source manifest by immutable content identity.

publish_candidate (method)

async CodingProductArtifactRepository.publish_candidate(candidate: CodingProductCandidate) -> CodingProductPublication

read_candidate (method)

async CodingProductArtifactRepository.read_candidate(reference: CompletionResultReference) -> CodingProductCandidate

load_publication (method)

async CodingProductArtifactRepository.load_publication(*, request_fingerprint: str, digest: str) -> CodingProductPublication

Reconstruct one content-addressed result after acknowledgement loss.

publish_git_diff (method)

async CodingProductArtifactRepository.publish_git_diff(*, session_id: str, agent_name: str, environment_name: str, event_id: str, content: str) -> CodingArtifactReference

Release source · Runtime guarantees · Capability guides

`CodingProductCandidate`

from cayu import CodingProductCandidate

Bounded candidate evidence evaluated before patch-ready success.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal['cayu.coding_product_result.v1']`	`'cayu.coding_product_result.v1'`
`product_run_id`	`str`	`required`
`request_fingerprint`	`str`	`required`
`session_id`	`str`	`required`
`agent_name`	`str`	`required`
`interaction_id`	`str \| None`	`None`
`task_id`	`str`	`required`
`state`	`CodingProductState`	`required`
`source_origin_id`	`str`	`required`
`source_workspace_id`	`str`	`required`
`source_destination_id`	`str`	`required`
`initial_revision`	`str`	`required`
`initial_git`	`CodingGitBaselineAuthority`	`required`
`final_revision`	`str \| None`	`None`
`initial_source`	`CodingSourceObservationEvidence`	`required`
`final_source`	`CodingSourceObservationEvidence`	`required`
`runtime`	`CodingRuntimeAuthority`	`required`
`checks`	`tuple[CodingCheckEvidence, ...]`	`()`
`commands`	`tuple[CodingCommandEvidence, ...]`	`()`
`mutations`	`tuple[CodingMutationEvidence, ...]`	`()`
`git_status`	`CodingGitStatusEvidence \| None`	`None`
`git_summary`	`CodingGitSummaryEvidence \| None`	`None`
`git`	`CodingGitEvidence \| None`	`None`
`review`	`CodingReviewSettlement`	`required`
`publication`	`CodingPublicationEvidence`	`required`
`lifecycle_receipt_ids`	`tuple[str, ...]`	`()`
`external_delivery_performed`	`StrictBool`	`False`
`remaining_delivery_action`	`Literal['commit_push_or_provider_delivery']`	`'commit_push_or_provider_delivery'`
`warnings`	`tuple[str, ...]`	`(_TRUSTED_DOCKER_WARNING,)`

validate_identity (method)

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

validate_optional_interaction_id (method)

CodingProductCandidate.validate_optional_interaction_id(value: str | None) -> str | None

validate_optional_fingerprint (method)

CodingProductCandidate.validate_optional_fingerprint(value: str | None, info) -> str | None

validate_check_order (method)

CodingProductCandidate.validate_check_order(value: tuple[CodingCheckEvidence, ...])

validate_lifecycle_ids (method)

CodingProductCandidate.validate_lifecycle_ids(value: tuple[str, ...]) -> tuple[str, ...]

validate_patch_ready_claim (method)

CodingProductCandidate.validate_patch_ready_claim() -> CodingProductCandidate

digest (property)

CodingProductCandidate.digest() -> str

Release source · Runtime guarantees · Capability guides

`CodingProductCompletionVerifier`

from cayu import CodingProductCompletionVerifier

Deterministically verify one exact candidate artifact.

Bases: DeterministicCompletionVerifier.

execution_profile_identity (property)

CodingProductCompletionVerifier.execution_profile_identity() -> ExecutionProfileBehaviorIdentity

execution_profile_components (property)

CodingProductCompletionVerifier.execution_profile_components() -> tuple[CompletionVerifierProfileComponentDeclaration, ...]

Return stable identities for other decision-bearing dependencies.

verify (method)

async CodingProductCompletionVerifier.verify(request: CompletionVerifierRequest) -> CompletionVerifierDecision

init (method)

CodingProductCompletionVerifier.__init__(request: CodingProductRequest, repository: CodingProductArtifactRepository, *, public_authority_alias_codec: PublicAuthorityAliasCodec | None=None) -> None

Release source · Runtime guarantees · Capability guides

`CodingProductEvidenceError`

from cayu import CodingProductEvidenceError

Runtime evidence cannot support an authoritative product result.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`CodingProductExecutionInspection`

from cayu import CodingProductExecutionInspection

Read-only exact-release projection, not caller-supplied cleanup authority.

Decorators: @dataclass(frozen=True).

Fields and attributes

Name	Type	Default
`request_fingerprint`	`str`	`required`
`release_fingerprint`	`str`	`required`
`events`	`tuple[Event, ...]`	`required`
`tool_call_ordinals`	`tuple[int \| None, ...]`	`required`

Release source · Runtime guarantees · Capability guides

`CodingProductPublication`

from cayu import CodingProductPublication

Decorators: @dataclass(frozen=True).

Fields and attributes

Name	Type	Default
`candidate`	`CodingProductCandidate`	`required`
`result_reference`	`CompletionResultReference`	`required`
`evidence_reference`	`WorkEvidenceReference`	`required`
`artifact`	`CodingArtifactReference`	`required`

Release source · Runtime guarantees · Capability guides

`CodingProductReconstructionRequiredError`

from cayu import CodingProductReconstructionRequiredError

Durable evidence must be reconciled before execution can continue.

Bases: RuntimeError.

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

Release source · Runtime guarantees · Capability guides

`CodingProductRequest`

from cayu import CodingProductRequest

Complete immutable application authority for one coding-product run.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal['cayu.coding_product.v1']`	`CODING_PRODUCT_SCHEMA_VERSION`
`product_run_id`	`str`	`required`
`session_id`	`str`	`required`
`agent_name`	`str`	`required`
`source`	`CodingSourceAuthority`	`required`
`task`	`CodingTaskAuthority`	`required`
`runtime`	`CodingRuntimeAuthority`	`required`
`settlement`	`CodingSettlementPolicy`	`Field(default_factory=CodingSettlementPolicy)`
`parent_session_id`	`str \| None`	`None`
`causal_budget_id`	`str \| None`	`None`

validate_optional_lineage (method)

CodingProductRequest.validate_optional_lineage(value: str | None, info) -> str | None

validate_identity (method)

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

validate_distinct_authority (method)

CodingProductRequest.validate_distinct_authority() -> CodingProductRequest

fingerprint (property)

CodingProductRequest.fingerprint() -> str

Release source · Runtime guarantees · Capability guides

`CodingProductResultResolver`

from cayu import CodingProductResultResolver

Resolve only the accepted immutable coding-product result artifact.

Bases: CompletionResultResolver.

resolve (method)

async CodingProductResultResolver.resolve(request: CompletionResultResolverRequest) -> dict[str, object]

init (method)

CodingProductResultResolver.__init__(request: CodingProductRequest, repository: CodingProductArtifactRepository) -> None

Release source · Runtime guarantees · Capability guides

`CodingProductRunner`

from cayu import CodingProductRunner

Run one ordinary Cayu session and retain authoritative product evidence.

init (method)

CodingProductRunner.__init__(app: CayuApp, *, source_workspace: Workspace, repository: CodingProductArtifactRepository, source_git_authority_validator: Callable[[CodingGitBaselineAuthority], Awaitable[None]], observation_limits: WorkspaceRevisionObservationLimits | None=None) -> None

run (method)

async CodingProductRunner.run(request: CodingProductRequest, run_request: RunRequest, *, review_settlement: CodingReviewSettlement | None=None) -> CodingProductPublication

Execute, compile, and durably publish one bounded coding-product result.

recover_settled_execution (method)

async CodingProductRunner.recover_settled_execution(request: CodingProductRequest, *, review_settlement: CodingReviewSettlement | None=None) -> CodingProductPublication

Publish an exact settled original invocation without executing it again.

Unfinished or resumed invocations require registered Runtime recovery; this entrance does not grant continuation or clear the execution claim.

inspect_settled_execution (method)

async CodingProductRunner.inspect_settled_execution(request: CodingProductRequest) -> CodingProductExecutionInspection

Read an exact original invocation with durable Runtime release evidence.

This does not publish a product, resume execution, or establish that an enclosing application worker has stopped. Consumers must separately reconcile that owner and any ambiguous external effects. An interrupted invocation is not evidence of a successful coding result.

Release source · Runtime guarantees · Capability guides

`CodingProductState`

from cayu import CodingProductState

Durable product states, including every non-success settlement class.

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`ADMITTED`	`class attribute`	`'admitted'`
`PREPARING_WORKSPACE`	`class attribute`	`'preparing_workspace'`
`ACTIVE`	`class attribute`	`'active'`
`CHECKS_NOT_RUN`	`class attribute`	`'checks_not_run'`
`CHECKS_FAILED`	`class attribute`	`'checks_failed'`
`SOURCE_CONFLICT`	`class attribute`	`'source_conflict'`
`TOOLCHAIN_REBUILD_REQUIRED`	`class attribute`	`'toolchain_rebuild_required'`
`REVIEW_REQUIRED`	`class attribute`	`'review_required'`
`HUMAN_INPUT_REQUIRED`	`class attribute`	`'human_input_required'`
`READY_TO_PUBLISH`	`class attribute`	`'ready_to_publish'`
`PUBLISHING`	`class attribute`	`'publishing'`
`PATCH_READY_FOR_DELIVERY`	`class attribute`	`'patch_ready_for_delivery'`
`BLOCKED`	`class attribute`	`'blocked'`
`DENIED`	`class attribute`	`'denied'`
`CANCELLED`	`class attribute`	`'cancelled'`
`FAILED`	`class attribute`	`'failed'`
`PARTIAL`	`class attribute`	`'partial'`
`AMBIGUOUS`	`class attribute`	`'ambiguous'`
`RECONSTRUCTION_REQUIRED`	`class attribute`	`'reconstruction_required'`

Release source · Runtime guarantees · Capability guides

`CodingPublicationEvidence`

from cayu import CodingPublicationEvidence

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`event_id`	`str`	`required`
`destination_id`	`str`	`required`
`outcome`	`Literal['copied', 'unchanged', 'conflicted', 'partial', 'failed', 'cancelled', 'ambiguous']`	`required`
`baseline_revision`	`str`	`required`
`final_revision`	`str \| None`	`None`
`snapshot_id`	`str \| None`	`None`
`snapshot_sha256`	`str \| None`	`None`
`receipt_sha256`	`str \| None`	`None`
`destination_workspace_id`	`str \| None`	`None`
`workload_workspace_id`	`str \| None`	`None`
`source_conflict_policy`	`Literal['require_revision'] \| None`	`None`
`sync_back`	`Literal['always'] \| None`	`None`
`delete_missing`	`StrictBool \| None`	`None`
`copied_files`	`StrictInt \| None`	`Field(default=None, ge=0)`
`copied_bytes`	`StrictInt \| None`	`Field(default=None, ge=0)`
`deleted_files`	`StrictInt \| None`	`Field(default=None, ge=0)`
`detail_code`	`str \| None`	`None`

validate_optional_identity (method)

CodingPublicationEvidence.validate_optional_identity(value: str | None, info) -> str | None

validate_optional_revision (method)

CodingPublicationEvidence.validate_optional_revision(value: str | None, info) -> str | None

settled (property)

CodingPublicationEvidence.settled() -> bool

validate_settled_receipt_integrity (method)

CodingPublicationEvidence.validate_settled_receipt_integrity() -> CodingPublicationEvidence

Release source · Runtime guarantees · Capability guides

`CodingReviewSettlement`

from cayu import CodingReviewSettlement

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`reviewer`	`Literal['not_required', 'passed', 'required', 'failed', 'ambiguous']`	`required`
`human`	`Literal['not_required', 'approved', 'required', 'denied', 'ambiguous']`	`required`
`reviewer_event_id`	`str \| None`	`None`
`human_event_id`	`str \| None`	`None`

validate_optional_identity (method)

CodingReviewSettlement.validate_optional_identity(value: str | None, info) -> str | None

Release source · Runtime guarantees · Capability guides

`CodingRuntimeAuthority`

from cayu import CodingRuntimeAuthority

Exact admitted Docker, tool, policy, approval, and redaction identity.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`execution_kind`	`Literal['trusted_repository_docker']`	`'trusted_repository_docker'`
`environment_name`	`str`	`'coding'`
`network`	`Literal['none']`	`'none'`
`credential_visibility`	`Literal['non_possession']`	`'non_possession'`
`toolchain_profile_id`	`str`	`required`
`toolchain_profile_revision`	`str`	`required`
`toolchain_profile_fingerprint`	`str`	`required`
`image_fingerprint`	`str`	`required`
`dependency_identity`	`str`	`required`
`execution_profile_fingerprint`	`str`	`required`
`tool_manifest_fingerprint`	`str`	`required`
`tool_policy_fingerprint`	`str`	`required`
`approval_policy_fingerprint`	`str`	`required`
`redaction_profile_fingerprint`	`str`	`required`

validate_identity (method)

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

validate_fingerprint (method)

CodingRuntimeAuthority.validate_fingerprint(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

`CodingSettlementPolicy`

from cayu import CodingSettlementPolicy

Finite application-owned completion gates.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`required_checks`	`tuple[str, ...]`	`('format', 'lint', 'test')`
`reviewer_required`	`StrictBool`	`True`
`human_approval_required`	`StrictBool`	`False`
`max_events`	`StrictInt`	`Field(default=CODING_PRODUCT_MAX_EVENTS, ge=1, le=100000)`
`max_event_bytes`	`StrictInt`	`Field(default=CODING_PRODUCT_MAX_EVENT_BYTES, ge=1024, le=128 * 1024 * 1024)`
`max_result_bytes`	`StrictInt`	`Field(default=CODING_PRODUCT_MAX_RESULT_BYTES, ge=4096, le=CODING_PRODUCT_MAX_RESULT_BYTES)`

validate_required_checks (method)

CodingSettlementPolicy.validate_required_checks(value: tuple[str, ...]) -> tuple[str, ...]

Release source · Runtime guarantees · Capability guides

`CodingSourceAuthority`

from cayu import CodingSourceAuthority

Application-owned source origin, immutable baseline, and destination.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`origin_id`	`str`	`required`
`workspace_id`	`str`	`required`
`baseline_revision`	`str`	`required`
`destination_id`	`str`	`required`
`path_scope`	`Literal['complete']`	`'complete'`
`git_baseline`	`CodingGitBaselineAuthority`	`required`
`observation_limits`	`WorkspaceRevisionObservationLimits`	`required`

validate_identity (method)

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

validate_baseline (method)

CodingSourceAuthority.validate_baseline(value: str) -> str

Release source · Runtime guarantees · Capability guides

`CodingSourceObservationEvidence`

from cayu import CodingSourceObservationEvidence

Bounded source-manifest evidence retained outside the product result.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`observer`	`str`	`required`
`workspace_id`	`str`	`required`
`status`	`WorkspaceRevisionObservationStatus`	`required`
`path_scope`	`Literal['complete', 'changed']`	`required`
`revision`	`str \| None`	`None`
`total_paths`	`StrictInt`	`Field(ge=0)`
`artifact`	`CodingArtifactReference`	`required`

validate_identity (method)

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

validate_revision (method)

CodingSourceObservationEvidence.validate_revision(value: str | None) -> str | None

validate_supported_observation (method)

CodingSourceObservationEvidence.validate_supported_observation() -> CodingSourceObservationEvidence

Release source · Runtime guarantees · Capability guides

`CodingTaskAuthority`

from cayu import CodingTaskAuthority

Immutable application task identity without copying task prose into evidence.

Bases: _FrozenCodingModel.

Fields and attributes

Name	Type	Default
`task_id`	`str`	`required`
`instruction_sha256`	`str`	`required`

validate_task_id (method)

CodingTaskAuthority.validate_task_id(value: str) -> str

validate_instruction_sha256 (method)

CodingTaskAuthority.validate_instruction_sha256(value: str) -> str

Release source · Runtime guarantees · Capability guides

`collect_coding_product_events`

from cayu import collect_coding_product_events

Collect an already bounded event stream for application-level composition tests.

async collect_coding_product_events(events: AsyncIterator[Event]) -> tuple[Event, ...]

Release source · Runtime guarantees · Capability guides

`compile_coding_product_candidate`

from cayu import compile_coding_product_candidate

Compile bounded public runtime events into verifier-ready product evidence.

async compile_coding_product_candidate(request: CodingProductRequest, events: Sequence[Event], *, initial_observation: WorkspaceRevisionObservation, final_observation: WorkspaceRevisionObservation, repository: CodingProductArtifactRepository, lifecycle_receipt_ids: tuple[str, ...]=(), review_settlement: CodingReviewSettlement | None=None, public_authority_alias_codec: PublicAuthorityAliasCodec | None=None) -> CodingProductCandidate

Release source · Runtime guarantees · Capability guides

`register_coding_product_contract`

from cayu import register_coding_product_contract

Publish and reconstruct the exact verifier/resolver during app startup.

async register_coding_product_contract(app: CayuApp, request: CodingProductRequest, repository: CodingProductArtifactRepository) -> WorkContract

Release source · Runtime guarantees · Capability guides