Cross-session memory for Astrid OS agents.
In the OS model, this capsule is the persistent swap file. It carries context across session boundaries so the agent remembers what happened last time.
Hooks into prompt_builder.v1.hook.before_build. On each prompt assembly cycle:
- Reads
.astrid/memory.mdfrom the workspace via the VFS - Wraps the content in a
# Memorysection - Publishes an
appendSystemContexthook response on the per-request response topic
If the file is missing or empty, the capsule is a no-op.
Agent-written content can grow without limit (unlike human-authored AGENTS.md), so a 32KB hard cap prevents unbounded context window consumption. Content beyond the limit is truncated at a UTF-8 character boundary with a [Memory truncated] marker.
This capsule handles the read/inject side only. The agent writes to .astrid/memory.md using existing filesystem tools (write_file, replace_in_file) from astrid-capsule-fs. No new tools needed.
cargo build --target wasm32-unknown-unknown --releaseDual-licensed under MIT and Apache 2.0.
Copyright (c) 2025-2026 Joshua J. Bouw and Unicity Labs.