cayu.snapshots.AgentSnapshotStore
Part of cayu.snapshots.base. Read the Python API overview and install the required extra.
from cayu.snapshots import AgentSnapshotStoreBases: ABC.
durable_state_paths (method)
Section titled “durable_state_paths (method)”AgentSnapshotStore.durable_state_paths() -> tuple[Path, ...]Return local files that own this store’s durable state.
put_snapshot (method)
Section titled “put_snapshot (method)”async AgentSnapshotStore.put_snapshot(snapshot: AgentSnapshot, binding: AgentSnapshotIdentityBinding) -> AgentSnapshotPutReceiptAtomically store one root closure and one authorized logical binding.
put_snapshot_and_pin (method)
Section titled “put_snapshot_and_pin (method)”async AgentSnapshotStore.put_snapshot_and_pin(snapshot: AgentSnapshot, binding: AgentSnapshotIdentityBinding, pin: AgentSnapshotPinRequest) -> tuple[AgentSnapshotPutReceipt, AgentSnapshotPinReceipt]Atomically publish and pin a newly imported root.
Stores that do not implement one-transaction publication must fail closed; bundle import cannot expose an unprotected root between calls.
load_identity_binding (method)
Section titled “load_identity_binding (method)”async AgentSnapshotStore.load_identity_binding(binding_id: str) -> AgentSnapshotIdentityBinding | Noneget_snapshot (method)
Section titled “get_snapshot (method)”async AgentSnapshotStore.get_snapshot(access: AgentSnapshotAccess) -> AgentSnapshotLoad a snapshot only after validating its logical binding and scope.
enumerate_snapshot_closure (method)
Section titled “enumerate_snapshot_closure (method)”async AgentSnapshotStore.enumerate_snapshot_closure(access: AgentSnapshotAccess) -> tuple[AgentSnapshotNode, ...]inspect_snapshot (method)
Section titled “inspect_snapshot (method)”async AgentSnapshotStore.inspect_snapshot(access: AgentSnapshotAccess) -> AgentSnapshotClosureInspectionpin_snapshot (method)
Section titled “pin_snapshot (method)”async AgentSnapshotStore.pin_snapshot(request: AgentSnapshotPinRequest) -> AgentSnapshotPinReceiptrelease_snapshot_pin (method)
Section titled “release_snapshot_pin (method)”async AgentSnapshotStore.release_snapshot_pin(request: AgentSnapshotReleaseRequest) -> AgentSnapshotReleaseReceiptprotect_snapshot (method)
Section titled “protect_snapshot (method)”async AgentSnapshotStore.protect_snapshot(protection: AgentSnapshotProtection) -> AgentSnapshotProtectionrelease_snapshot_protection (method)
Section titled “release_snapshot_protection (method)”async AgentSnapshotStore.release_snapshot_protection(*, operation_id: str, access: AgentSnapshotAccess, protection_id: str) -> AgentSnapshotProtectionplan_snapshot_gc (method)
Section titled “plan_snapshot_gc (method)”async AgentSnapshotStore.plan_snapshot_gc(request: AgentSnapshotGCRequest) -> AgentSnapshotGCPlanexecute_snapshot_gc (method)
Section titled “execute_snapshot_gc (method)”async AgentSnapshotStore.execute_snapshot_gc(plan: AgentSnapshotGCPlan) -> AgentSnapshotGCReceiptsave_snapshot (method)
Section titled “save_snapshot (method)”async AgentSnapshotStore.save_snapshot(snapshot: AgentSnapshot) -> AgentSnapshotload_snapshot (method)
Section titled “load_snapshot (method)”async AgentSnapshotStore.load_snapshot(snapshot_root: str) -> AgentSnapshot | Nonesave_materialization (method)
Section titled “save_materialization (method)”async AgentSnapshotStore.save_materialization(materialization: AgentSnapshotMaterialization) -> AgentSnapshotMaterializationload_materialization (method)
Section titled “load_materialization (method)”async AgentSnapshotStore.load_materialization(fingerprint: str) -> AgentSnapshotMaterialization | Noneload_materialization_for_scope (method)
Section titled “load_materialization_for_scope (method)”async AgentSnapshotStore.load_materialization_for_scope(request: AgentSnapshotMaterializationRequest) -> AgentSnapshotMaterialization | Nonebegin_materialization (method)
Section titled “begin_materialization (method)”async AgentSnapshotStore.begin_materialization(progress: AgentSnapshotMaterializationProgress) -> AgentSnapshotMaterializationProgressAtomically bind a scope to its immutable component operation plan.
load_materialization_progress_for_scope (method)
Section titled “load_materialization_progress_for_scope (method)”async AgentSnapshotStore.load_materialization_progress_for_scope(request: AgentSnapshotMaterializationRequest) -> AgentSnapshotMaterializationProgress | Noneclaim_materialization_operation (method)
Section titled “claim_materialization_operation (method)”async AgentSnapshotStore.claim_materialization_operation(progress: AgentSnapshotMaterializationProgress, operation_id: str) -> AgentSnapshotMaterializationProgressCAS an unstarted operation to active before provider effects.
complete_materialization_operation (method)
Section titled “complete_materialization_operation (method)”async AgentSnapshotStore.complete_materialization_operation(progress: AgentSnapshotMaterializationProgress, operation_id: str, component: AgentSnapshotMaterializedComponent) -> AgentSnapshotMaterializationProgressCAS one exact provider result into durable progress.
finalize_materialization (method)
Section titled “finalize_materialization (method)”async AgentSnapshotStore.finalize_materialization(progress: AgentSnapshotMaterializationProgress, materialization: AgentSnapshotMaterialization) -> AgentSnapshotMaterializationAtomically publish a completed materialization for its scope.
save_trial (method)
Section titled “save_trial (method)”async AgentSnapshotStore.save_trial(trial: AgentSnapshotTrialBinding) -> AgentSnapshotTrialBindingload_trial (method)
Section titled “load_trial (method)”async AgentSnapshotStore.load_trial(fingerprint: str) -> AgentSnapshotTrialBinding | Nonesave_result (method)
Section titled “save_result (method)”async AgentSnapshotStore.save_result(result: AgentSnapshotResultBinding) -> AgentSnapshotResultBindingload_result (method)
Section titled “load_result (method)”async AgentSnapshotStore.load_result(fingerprint: str) -> AgentSnapshotResultBinding | None