Store a memory entry for a session. Embeddings and graph extraction happen automatically.

Retrieve relevant memories via semantic search (falls back to keyword). Searches working + long_term tiers. Pass userId to blend in cross-session user facts.

Get recent conversation history for a session in chronological order.

Delete session memories. Delete all, one by ID, or entries before a date.

Memory statistics for a session — total, by role, by tier (working/long_term/archived), graph counts.

Consolidate old working memories into dense long-term summaries via LLM. Archives originals.

Query the knowledge graph for an entity — returns relationships and source memories. Requires ENGRAM_GRAPH=1.

Store a user-scoped memory that persists across all sessions. Use for preferences, identity, long-term facts.

Recall user-scoped memories — works from any session context.

Delete user-scoped memories.

Consolidate user-scoped working memories into long-term summaries.

Memory statistics for a user — total, by role, by tier.

Query memories using natural language time expressions like "yesterday", "last week", "this morning", "before 3pm".

Get the N most recent memories for a session — no query needed.

Returns a summary of memories for a given date (YYYY-MM-DD), or today if omitted.

Returns temporal statistics about when memories were created — frequency over time, most active periods.

Export all session memories as markdown or JSON.