Memory

Memory in the agent platform is the per-actor persistent record of facts and plans. The store is a SQLite database (one per Host home, under .matrix/data/agents/store.db) with tables for memories, embeddings, plans, and an audit trail.

This section breaks memory into the operational concepts a caller needs:

Pages

• Short-term context — the in-loop, in-session context the model sees on each turn.
• Artifact memory — memories pinned to a specific artifact / target.
• Project memory — broader-scope memories: realm, subtree, profile.
• Retrieval — search tiers, ranking, embedding fallback.
• Governance — audit trail, scope enforcement, tenant isolation.

See also

• Memory overview
• Reference: agent actor ops

Source: projects/matrix-3/packages/agents/src/MemoryActor.ts, projects/matrix-3/packages/agents/schema.sql.