cayu.snapshots.AgentSnapshot

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

from cayu.snapshots import AgentSnapshot

Strict portable manifest for one bounded logical agent state.

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']	AGENT_SNAPSHOT_RECORD_TYPE
schema_version	Literal[3]	AGENT_SNAPSHOT_SCHEMA_VERSION
snapshot_root	StrictStr	required
capture_request_id	StrictStr	Field(max_length=256)
captured_at	datetime	required
subject	AgentSnapshotSubject	required
authority_scope_fingerprint	StrictStr	required
execution_profile	AgentSnapshotExecutionProfileRef	required
memory_state	MemoryStateRef | None	None
components	tuple[AgentSnapshotComponentRef, ...]	Field(max_length=AGENT_SNAPSHOT_MAX_COMPONENTS)
consistency	AgentSnapshotConsistency	required
evaluator	AgentSnapshotAuthorityRef | None	None
promotion_authority	AgentSnapshotAuthorityRef | None	None
parent_snapshot_fingerprint	StrictStr | None	None
lineage	tuple[StrictStr, ...]	()
exclusions	tuple[StrictStr, ...]	('credentials', 'hidden_evaluator_truth', 'promotion_activation', 'provider_continuation_state', 'unrelated_records')
limitations	tuple[StrictStr, ...]	()

validate_digests (method)

AgentSnapshot.validate_digests(value: str | None, info) -> str | None

validate_request_id (method)

AgentSnapshot.validate_request_id(value: str, info) -> str

validate_captured_at (method)

AgentSnapshot.validate_captured_at(value: datetime) -> datetime

validate_component_sequence (method)

AgentSnapshot.validate_component_sequence(value: object) -> object

validate_lineage (method)

AgentSnapshot.validate_lineage(value: tuple[str, ...]) -> tuple[str, ...]

validate_sorted_codes (method)

AgentSnapshot.validate_sorted_codes(value: object, info) -> tuple[str, ...]

validate_manifest (method)

AgentSnapshot.validate_manifest() -> AgentSnapshot

component (method)

AgentSnapshot.component(kind: AgentSnapshotComponentKind) -> AgentSnapshotComponentRef

fingerprint (property)

AgentSnapshot.fingerprint() -> str

Deprecated read-only spelling retained for v2 source compatibility.

ref (property)

AgentSnapshot.ref() -> AgentSnapshotRef

identity_binding (property)

AgentSnapshot.identity_binding() -> AgentSnapshotIdentityBinding

component_node (method)

AgentSnapshot.component_node(component: AgentSnapshotComponentRef) -> AgentSnapshotNode

component_nodes (method)

AgentSnapshot.component_nodes() -> tuple[AgentSnapshotNode, ...]

root_node (method)

AgentSnapshot.root_node() -> AgentSnapshotNode

merkle_nodes (method)

AgentSnapshot.merkle_nodes() -> tuple[AgentSnapshotNode, ...]

identity_material (method)

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

Return content-only root payload.

Logical registration, authority scope, capture metadata, evaluator and promotion authority, and provenance deliberately live outside the root.

create (method)

AgentSnapshot.create(*, capture_request_id: str, captured_at: datetime, subject: AgentSnapshotSubject, authority_scope_fingerprint: str, execution_profile: AgentSnapshotExecutionProfileRef, components: Iterable[AgentSnapshotComponentRef], memory_state: MemoryStateRef | None=None, evaluator: AgentSnapshotAuthorityRef | None=None, promotion_authority: AgentSnapshotAuthorityRef | None=None, parent_snapshot_fingerprint: str | None=None, lineage: tuple[str, ...]=(), exclusions: tuple[str, ...]=('credentials', 'hidden_evaluator_truth', 'promotion_activation', 'provider_continuation_state', 'unrelated_records'), limitations: tuple[str, ...]=()) -> AgentSnapshot

Release source · Runtime guarantees · Capability guides