Skip to content

cayu.snapshots.MemoryStateRef

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

from cayu.snapshots import MemoryStateRef

Typed identity of Cayu knowledge and memory at one bounded frontier.

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
schema_version Literal[1] 1
fingerprint StrictStr required
knowledge AgentSnapshotLogicalRef | None None
transcript_evidence AgentSnapshotLogicalRef | None None
artifact_evidence AgentSnapshotLogicalRef | None None
work_context AgentSnapshotLogicalRef | None None
recall_policy AgentSnapshotLogicalRef | None None
admission_policy AgentSnapshotLogicalRef | None None
context_projection_policy AgentSnapshotLogicalRef | None None
interaction_focus AgentSnapshotLogicalRef | None None
recall_receipts AgentSnapshotLogicalRef | None None
context_exposures AgentSnapshotLogicalRef | None None
index_readiness AgentSnapshotLogicalRef | None None
learning_disposition AgentSnapshotLearningDisposition required
limitations tuple[StrictStr, ...] ()
MemoryStateRef.validate_fingerprint(value: str, info) -> str
MemoryStateRef.validate_limitations(value: object) -> tuple[str, ...]
MemoryStateRef.validate_fingerprint_matches() -> MemoryStateRef
MemoryStateRef.merkle_material() -> dict[str, object]

Return the typed memory/knowledge content without authorization scope.

MemoryStateRef.create(*, knowledge: AgentSnapshotLogicalRef | None=None, transcript_evidence: AgentSnapshotLogicalRef | None=None, artifact_evidence: AgentSnapshotLogicalRef | None=None, work_context: AgentSnapshotLogicalRef | None=None, recall_policy: AgentSnapshotLogicalRef | None=None, admission_policy: AgentSnapshotLogicalRef | None=None, context_projection_policy: AgentSnapshotLogicalRef | None=None, interaction_focus: AgentSnapshotLogicalRef | None=None, recall_receipts: AgentSnapshotLogicalRef | None=None, context_exposures: AgentSnapshotLogicalRef | None=None, index_readiness: AgentSnapshotLogicalRef | None=None, learning_disposition: AgentSnapshotLearningDisposition, limitations: tuple[str, ...]=()) -> MemoryStateRef

Release source · Runtime guarantees · Capability guides