Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 06 Jun 13:26
· 36 commits to master since this release

Citadel v1.0.0

Encrypted-first embedded database and agent-memory engine. Outperforms unencrypted SQLite.

New features

  • Vector search - new VECTOR(N) SQL type with distance operators <-> (L2), <#> (inner product), <=> (cosine), and a PRISM-backed filtered approximate-nearest-neighbor index via CREATE INDEX ... USING ann (col). The index reads through Citadel's encrypted page storage, so it is encrypted at rest like every other page. ORDER BY col <-> ? LIMIT k plans as an ANN top-k scan with filter pushdown.
  • Agent memory engine (citadeldb-mem) - encrypted-first memory store: regions of typed atoms connected by typed edges, a hybrid recall pipeline (vector ANN + BM25 keyword + cross-encoder reranker), and operations to remember, recall, link, evolve, summarize, and evict.
  • Cryptographic forgetting - memory is forgotten by destroying keys, not by logical delete. Crypto erasure at whole-store, per-region, and per-atom granularity; a forgotten atom's plaintext is unrecoverable even from a raw image of the file.
  • Autonomous agent runtime (citadeldb-ai) - a ReAct + Reflexion agent loop over the memory engine, with a tool registry, hard budget caps (steps / tokens / wall-time / cost), memory-backed plan caching, and pluggable LLMClient backends (Claude, OpenAI, Ollama, a mock for tests, or your own).
  • WASM vector cells - @citadeldb/wasm returns VECTOR(N) cells as a JS Float32Array.
  • New crates on crates.io: citadeldb-vector, citadeldb-mem, citadeldb-ai.
  • Schema version bump 12 → 14 (VECTOR type + ANN index kind). Forward-only; v0.16.x databases upgrade on first open.

Downloads

Platform CLI FFI
Linux x86_64 citadel-v1.0.0-x86_64-unknown-linux-musl.tar.gz citadel-ffi-v1.0.0-x86_64-unknown-linux-gnu.tar.gz
Linux aarch64 citadel-v1.0.0-aarch64-unknown-linux-gnu.tar.gz citadel-ffi-v1.0.0-aarch64-unknown-linux-gnu.tar.gz
macOS x86_64 citadel-v1.0.0-x86_64-apple-darwin.tar.gz citadel-ffi-v1.0.0-x86_64-apple-darwin.tar.gz
macOS aarch64 citadel-v1.0.0-aarch64-apple-darwin.tar.gz citadel-ffi-v1.0.0-aarch64-apple-darwin.tar.gz
Windows x86_64 citadel-v1.0.0-x86_64-pc-windows-msvc.zip citadel-ffi-v1.0.0-x86_64-pc-windows-msvc.zip

FIPS variants are prefixed with citadel-fips- / citadel-ffi-fips-.

All archives include SHA256 checksums.

Install

cargo install citadeldb-cli
npm install @citadeldb/wasm