Skip to content

cayu.snapshots.AgentSnapshotMaterializationProgress

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

from cayu.snapshots import AgentSnapshotMaterializationProgress

Durable scope plan and compare-and-set component progress.

Bases: _SnapshotModel.

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.agent-snapshot-materialization-progress'] 'cayu.agent-snapshot-materialization-progress'
schema_version Literal[1] 1
progress_id StrictStr required
snapshot_fingerprint StrictStr required
candidate_id StrictStr Field(max_length=256)
state_scope_id StrictStr Field(max_length=256)
state_mode AgentSnapshotTrialStateMode required
state_partition_fingerprint StrictStr | None Field(default=None, exclude_if=lambda value: value is None)
created_at datetime required
operations tuple[AgentSnapshotMaterializationOperation, ...] required
revision StrictInt Field(ge=0)
active_operation_id StrictStr | None None
components tuple[AgentSnapshotMaterializedComponent, ...] ()
materialization_fingerprint StrictStr | None None
AgentSnapshotMaterializationProgress.validate_fingerprints(value: str | None, info) -> str | None
AgentSnapshotMaterializationProgress.validate_identity(value: str, info) -> str
AgentSnapshotMaterializationProgress.validate_created_at(value: datetime) -> datetime
AgentSnapshotMaterializationProgress.validate_progress() -> AgentSnapshotMaterializationProgress
AgentSnapshotMaterializationProgress.identity_material() -> dict[str, object]
AgentSnapshotMaterializationProgress.create(*, request: AgentSnapshotMaterializationRequest, created_at: datetime, components: Iterable[AgentSnapshotComponentRef]) -> AgentSnapshotMaterializationProgress

Release source · Runtime guarantees · Capability guides