What the engine does
The same taxonomy the homepage summarises, in full — rendered from
src/data/capabilities.json, which the homepage atlas reads too. There is one
source and no generated copy, so this page cannot go stale while the summary
moves.
Each capability lists the surfaces it is verified on. A category badge on the homepage is the union of its items; it does not mean every operation in that category exists on every transport. Where a claim has a boundary, the boundary is stated with it.
Recall & ranking
Retrieval that returns why it returned something, not just what.
| Operation | What it gives you | Available on |
|---|---|---|
recall recall / recall_text | Rank by relevance and return a final score with retrieval reasons. Richer engine/Python surfaces expose the signal breakdown; leaner transports return the score and reasons. | Engine / PythonMCPServer HTTPBrowser (wasm) |
Point-in-time recall recall_as_of | Ask what the store believed at a past moment, not just what it holds now. | Engine / PythonMCPServer HTTP |
Refine a recall recall_refine | Narrow an existing result set instead of re-querying from scratch. | Engine / PythonMCP |
Recall with links recall_with_links | Pull a memory together with the records it is linked to. | Engine / PythonMCP |
Relevance feedback recall_feedback | Mark a result useful or wrong and let ranking learn from it. | Engine / PythonMCP |
Entity expansion recall(expand_entities=True) | Optionally widen a query along known entity edges; off by default so graph expansion is used deliberately. Opt-in per call. Enabling it by default measured worse on the cited set, so it is a deliberate choice rather than a mode. | Engine / PythonMCP |
Isolation & lifecycle
Memory that is scoped, and that ages instead of only growing.
| Operation | What it gives you | Available on |
|---|---|---|
Namespace isolation namespace= | Records, recall, sessions, tasks, procedures and statistics can be scoped by namespace. The network layer adds token-scoped tenant databases; namespace is a second scope inside an authenticated database where supported. The browser build uses a fixed default namespace. | Engine / PythonMCPServer HTTP |
Temporal decay half_life / decay | A half-life lowers a memory's ranking weight over time, so stale material stops dominating recall. Affects ranking weight — it does not destructively rewrite the stored importance. | Engine / PythonMCP |
Correct a memory correct / history | Correct in place while appending an auditable revision-history entry; entity links stay attached to the same record. | Engine / PythonMCPServer HTTP |
Forget forget | Tombstone a record so it stops surfacing. | Engine / PythonMCPServer HTTPBrowser (wasm) |
Archive and hydrate archive / hydrate | Move cold memories out of the hot path and bring them back on demand. | Engine / PythonMCP |
Temporal queries stale / upcoming / range (or recall since/until) | Find what has gone stale, what is coming up, and retrieve records from a bounded time window. | Engine / PythonMCPServer HTTP |
Maintenance cycle run_maintenance_cycle / maintenance_debt | Run upkeep explicitly and see what work is outstanding. | Engine / Python |
Entities & graph
Structure between memories, not just similarity between vectors.
| Operation | What it gives you | Available on |
|---|---|---|
Relate relate / unlink | Typed, weighted edges between entities. | Engine / PythonMCPServer HTTPBrowser (wasm) |
Auto-relate auto_relate | Preview or persist co-occurrence-derived entity edges. | Engine / PythonMCP |
Search entities search_entities(pattern, entity_type, limit) | Find entities by pattern and type. | Engine / PythonMCPBrowser (wasm) |
Entity profile entity_profile | Everything the store knows about one entity, assembled. | Engine / PythonMCP |
Read edges get_edges | Traverse what an entity is connected to. | Engine / PythonMCPBrowser (wasm) |
Relationship depth relationship_depth | How far apart two entities sit in the graph. | Engine / PythonMCP |
Cognition
The pass that notices contradictions instead of storing both quietly.
| Operation | What it gives you | Available on |
|---|---|---|
think() think(config) | A bounded, incremental pass: consolidation and conflict scanning over what changed. Pattern mining is opt-in and off by default. | Engine / PythonMCPServer HTTPBrowser (wasm) |
Conflict detection scan_conflicts / get_conflicts | Two claims that cannot both hold are flagged rather than silently coexisting. Covers recognised structured single-valued relations — not general natural-language inference over arbitrary sentences. | Engine / PythonMCPServer HTTP |
Resolution resolve_conflict / reclassify_conflict | An operator confirms which claim stands, with a note attached to the decision. Operator-driven by design; the database does not guess. | Engine / PythonMCPServer HTTP |
Disputed results disputed_with | Both sides of an open conflict keep coming back marked, so an agent can hedge. | Engine / PythonMCPServer HTTPBrowser (wasm) |
Knowledge gaps knowledge_gaps | Questions asked often and answered badly, surfaced as gaps. | Engine / PythonMCP |
Substitution categories substitution_categories | Distinguish a real conflict from a redundant restatement. | Engine / PythonMCP |
Agent primitives
The things an agent needs beyond storing text.
| Operation | What it gives you | Available on |
|---|---|---|
Sessions session_start / session_end / session_digest | Start, end and digest a working session; read its history. | Engine / PythonMCPServer HTTP |
Triggers get_pending_triggers / deliver_trigger / acknowledge_trigger | Proactive follow-ups the store raises, delivered and acknowledged. | Engine / PythonMCPServer HTTP |
Tasks task_add / task_list / task_update | Track work items alongside the memory they belong to. | Engine / PythonMCPServer HTTP |
Procedural memory record_procedural / surface_procedural / reinforce_procedural | Learn, surface and reinforce reusable strategies. | Engine / PythonMCP |
Skills & outcomes skill (MCP) · /v1/skills/* | A schema-validated skill catalog with semantic search and an append-only record of how each skill actually performed. Skill writes over MCP are operator-gated and off by default; reads and search are not. | MCPServer HTTP |
Conversation ring record_turn / recent_turns | Recent turns kept as a rolling window for context. | Engine / PythonMCP |
Deployment & security
What changes when memory stops living in one process.
| Operation | What it gives you | Available on |
|---|---|---|
Encryption at rest is_encrypted | AES-256-GCM over the store. Explicitly enabled, not automatic — engine, Python and host configuration. Encrypted mode can limit text extraction and search behaviour. | Engine / PythonServer HTTP |
Knowledge Packs seal_pack / sign_pack / mount_pack / install_pack | Portable memory that can be sealed, signed, published and mounted into another store. Publisher trust, signature verification and embedder compatibility are part of the claim. Pack writes and trust changes over MCP are operator-gated. | Engine / PythonMCP |
Tenancy database / token | Token-scoped databases on the network layer, separate from in-database namespaces. | Server HTTP |
Replication cluster / health / metrics | Multi-node deployment with leader election and failover via YRP native replication. | Server HTTP |
Persistence provenance audit audit_leak_candidates | Find recent memory rows that lack both an originating oplog record and replication provenance. | Engine / PythonMCP |
Provenance gating provenance gate | Control what the store will accept based on where it came from. | Engine / Python |
Going deeper
Section titled “Going deeper”- Engine Deep Dives — retrieval, the write path, encryption at rest and Knowledge Packs in long form
- Components, versions and architecture
- Benchmarks