Host layer over the memory stack. The substance of the memory subsystem was
extracted into tinymemory-core: the
SQLite/vector store, the markdown summary tree, the provider sync pipelines,
ingestion, recall/query/search, the ingest queue, conversations, people,
goals and the tool-memory rules. That crate names no OpenHuman type — see
its README for the extracted
side of this split.
Links to the extracted crate point at GitHub rather than into
vendor/tinymemory/: CI checks out this repository without submodule
contents, so a relative link into that directory resolves to nothing on the
runner and fails the link check.
What stays here, per that split:
- RPC surface —
schemas/+schema/, the memory_* controller registrations, andread_rpc/for reads. - Agent tools —
tools/,agent/(the memory agent- prompt), and the consolidated
memory_queryagent tool inquery/(it came back from the extracted crate because the engine crate cannot name theTooltrait).
- prompt), and the consolidated
- Guard —
guard/, the taint/scope/budget policy gate over every provider call. - Driver binding —
driver/, which provider backs a workspace. - Ops —
ops/, RPC handlers that delegate into the core. - Seam impls —
host.rs/host_impls.rs—install_memory_event_sinkandMemoryHostConfig for Config.
Everything else in this module is a re-export of the extracted crate
(pub use tinymemory_core::{chat, global, ingest_pipeline, ingestion, preferences, remember, rpc_models, store, sync_events, traits, util, …} in
mod.rs), so the ~550 crate::openhuman::memory::… paths
elsewhere in this crate keep resolving unchanged. Prefer
tinymemory_core::… in new code.
Mostly extracted, but each is a thin wrapper (pub use tinymemory_core::<domain>::*; plus the handler/schema modules that name
RpcOutcome and ControllerSchema):
| Module | Role |
|---|---|
conversations/ |
Conversation-scoped memory RPC. |
diff/ |
Git-backed diff RPC (gated by the memory-git feature). |
goals/ |
Goal tracking RPC. |
people/ |
People/contacts RPC. |
sources/ |
Source-registration RPC. |
sync/ |
Composio + workspace + MCP sync pipeline RPC. |
tool_memory/ |
Tool-scoped rules + agent read/write tools. |
tree/ |
Tree walk/retrieval RPC. |
See vendor/tinymemory/crates/tinymemory-core/src/ for
the storage primitives (store/), ingestion queue (ingestion/), sync
lifecycle types (sync_events.rs), remember classification (remember.rs),
ingest orchestration (ingest_pipeline.rs), the Memory/MemoryEntry/etc.
traits (traits.rs), preferences (preferences.rs), and shared RPC shapes
(rpc_models.rs). Source → canonical markdown (chat / email / document)
lives in tinycortex::memory::ingest::canonicalize,
owned by TinyCortex and used at ingest time.
- No storage in this module. All persistence goes through
tinymemory_core::store::*. If you're tempted to open a SQLite connection here, the connection helper belongs one layer down, in the extracted crate. - RPC + tools + seam wiring live here. Domain logic belongs in
tinymemory-core; this module surfaces it over/rpcand to agents. - Surface high-level tool calls that route to the right submodule; don't expose internals at the call site.