CPersona

Store a message in agent memory for future recall.

Recall relevant memories using multi-strategy search (vector + FTS5 + keyword).

Get the current profile for an agent.

Save a pre-computed agent profile to the database.

Archive a conversation episode with pre-computed summary, keywords, and resolved status. All LLM processing is performed by the caller.

List recent memories for an agent (for dashboard display).

List archived episodes for an agent (for dashboard display).

Delete ALL data (memories, profiles, episodes) for a specific agent. Used by kernel during agent deletion.

Auto-calibrate vector search threshold using null distribution z-score. Samples random memory pairs, computes cosine distribution, sets threshold at mean + z*std. No labels used, purely statistical. Adapts to both embedding model and corpus characteristics.

Delete a single memory by ID. Ownership is enforced when agent_id is provided.

Delete a single episode by ID. Ownership is enforced when agent_id is provided.

Get the status of the background task queue (pending tasks, retry config).

Export memories, episodes, and profiles to a JSONL file for backup or portability.

Import memories, episodes, and profiles from a JSONL file. Idempotent via msg_id deduplication.

Merge memories, episodes, and profiles from one agent into another. Atomic one-shot equivalent of export→import without intermediate files. Strategy 'skip' deduplicates by msg_id (memories) and summary (episodes).

Check memory database health (15 checks). Detects contamination, duplicates, oversized content, embedding issues, FTS desync, invalid JSON/timestamps, stale tasks, missing profiles. Returns storage stats. Set fix=true to auto-repair.