Atomic point-in-time agent memory snapshots.
Captures a verifiable bundle of:
- Git-backed memory dir (
memdir/) as agit bundle - SQLite tables produced by the memory crate:
long_term,vector,concepts,compactions - Extractor cursor + last
dream_runregistry row
The bundle is a tar.zst archive sealed with a SHA-256 manifest. An
optional age encryption layer is available behind the
snapshot-encryption Cargo feature; the manifest itself stays
plaintext so integrity can be verified without the identity.
The crate ships:
- [
MemorySnapshotter] — trait every backend implements. - [
SnapshotRequest] / [RestoreRequest] — call inputs. - [
SnapshotMeta] / [RestoreReport] / [SnapshotDiff] / [VerifyReport] — public output shapes (also wire-shape for NATS lifecycle events and CLI JSON). - [
Manifest] — on-disk bundle header. - [
SnapshotError] — typed error class with stable variants.
See docs/src/ops/memory-snapshot.md for the operator surface.