Skip to content

cayu.snapshots.AgentSnapshotMaterialization

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

from cayu.snapshots import AgentSnapshotMaterialization

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'] 'cayu.agent-snapshot-materialization'
schema_version Literal[2] 2
fingerprint StrictStr required
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
components tuple[AgentSnapshotMaterializedComponent, ...] required
AgentSnapshotMaterialization.validate_fingerprint(value: str | None, info) -> str | None
AgentSnapshotMaterialization.validate_identity(value: str, info) -> str
AgentSnapshotMaterialization.validate_created_at(value: datetime) -> datetime
AgentSnapshotMaterialization.validate_materialization() -> AgentSnapshotMaterialization
AgentSnapshotMaterialization.identity_material() -> dict[str, object]
AgentSnapshotMaterialization.create(*, progress_id: str, request: AgentSnapshotMaterializationRequest, created_at: datetime, components: Iterable[AgentSnapshotMaterializedComponent]) -> AgentSnapshotMaterialization

Release source · Runtime guarantees · Capability guides