cayu.snapshots.AgentSnapshotTrialBinding

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

from cayu.snapshots import AgentSnapshotTrialBinding

Bases: _SnapshotModel.

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.agent-snapshot-trial']	'cayu.agent-snapshot-trial'
schema_version	Literal[1]	1
fingerprint	StrictStr	required
snapshot_fingerprint	StrictStr	required
materialization_fingerprint	StrictStr	required
candidate_id	StrictStr	Field(max_length=256)
case_id	StrictStr	Field(max_length=256)
trial_id	StrictStr	Field(max_length=256)
evaluator_fingerprint	StrictStr	required
memory_overlay_fingerprint	StrictStr | None	None
workspace_overlay_fingerprint	StrictStr | None	None
created_at	datetime	required

validate_fingerprints (method)

AgentSnapshotTrialBinding.validate_fingerprints(value: str | None, info) -> str | None

validate_identity (method)

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

validate_created_at (method)

AgentSnapshotTrialBinding.validate_created_at(value: datetime) -> datetime

validate_fingerprint_matches (method)

AgentSnapshotTrialBinding.validate_fingerprint_matches() -> AgentSnapshotTrialBinding

identity_material (method)

AgentSnapshotTrialBinding.identity_material() -> dict[str, object]

create (method)

AgentSnapshotTrialBinding.create(*, materialization: AgentSnapshotMaterialization, case_id: str, trial_id: str, evaluator_fingerprint: str, created_at: datetime) -> AgentSnapshotTrialBinding

session_metadata (method)

AgentSnapshotTrialBinding.session_metadata() -> dict[str, object]

Return bounded machine-readable lineage for an ordinary Cayu run.

Release source · Runtime guarantees · Capability guides