engram-core 0.19.0

AI Memory Infrastructure - Persistent memory for AI agents with semantic search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Engram Snapshots (.egm) — portable knowledge packages
//!
//! Create, load, and inspect .egm snapshot files for distributing
//! curated AI knowledge bases between agents and deployments.
//!
//! # Overview
//!
//! A `.egm` file is a ZIP archive containing:
//! - `manifest.json` — metadata, integrity hash, version info
//! - `memories.json` — all memory records
//! - `entities.json` — extracted named entities
//! - `graph_edges.json` — typed relationships between memories
//! - `README.md` — human-readable description
//!
//! Optionally:
//! - `payload.enc` — AES-256-GCM encrypted payload (instead of plain files)
//! - `manifest.sig` — Ed25519 signature of the manifest
//!
//! # Usage
//!
//! ```rust,ignore
//! use engram::snapshot::{SnapshotBuilder, SnapshotLoader, LoadStrategy};
//! use engram::storage::Storage;
//! use std::path::Path;
//!
//! // Create a snapshot
//! let storage = Storage::open_in_memory().unwrap();
//! let manifest = SnapshotBuilder::new(storage.clone())
//!     .workspace("my-project")
//!     .description("My knowledge base")
//!     .build(Path::new("knowledge.egm"))
//!     .unwrap();
//!
//! // Inspect without loading
//! let info = SnapshotLoader::inspect(Path::new("knowledge.egm")).unwrap();
//! println!("{} memories", info.manifest.memory_count);
//!
//! // Load into another instance
//! let result = SnapshotLoader::load(
//!     &storage,
//!     Path::new("knowledge.egm"),
//!     LoadStrategy::Merge,
//!     Some("imported"),
//!     None,
//! ).unwrap();
//! println!("{} memories loaded", result.memories_loaded);
//! ```

pub mod builder;
pub mod crypto;
pub mod loader;
pub mod types;

pub use builder::SnapshotBuilder;
pub use crypto::{decrypt_aes256, encrypt_aes256, sign_ed25519, verify_ed25519};
pub use loader::SnapshotLoader;
pub use types::{LoadResult, LoadStrategy, SnapshotInfo, SnapshotManifest};