cayu.sessions.ModelCompletionStageSettlement

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

from cayu.sessions import ModelCompletionStageSettlement

Append-only proof that one exact prepared model effect is no longer active.

Bases: BaseModel.

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
record_type	Literal['cayu.model-completion-stage.settled']	'cayu.model-completion-stage.settled'
schema_version	Literal[1]	1
session_id	str	required
stage_id	str	required
logical_step_id	str	required
model_attempt_id	str	required
interaction_id	str	required
request_fingerprint	str	required
provider_effect_id	str	required
execution_profile_fingerprint	str | None	None
preparation_digest	str	required
settlement_run_epoch	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
settled_reservation_ids	tuple[str, ...]	required
disposition	ModelCompletionStageDisposition	required
reason_code	str	required
superseding_stage_id	str | None	None
source_status	SessionStatus	required
source_run_epoch	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
source_transcript_cursor	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
settled_at	datetime	required
record_digest	str	required

validate_session_id (method)

ModelCompletionStageSettlement.validate_session_id(value: str) -> str

normalize_settled_at (method)

ModelCompletionStageSettlement.normalize_settled_at(value: datetime) -> datetime

validate_record_digest (method)

ModelCompletionStageSettlement.validate_record_digest(value: str) -> str

validate_request_shape (method)

ModelCompletionStageSettlement.validate_request_shape() -> ModelCompletionStageSettlement

Release source · Runtime guarantees · Capability guides