Cordelia Proxy

Read L1 hot context for a user. Returns dense structured memory including identity, active state, preferences, and delegation rules. Load this at session start.

Write to L1 hot context for a user. Use patch for partial updates, replace for full replacement. Supports optimistic concurrency via expected_updated_at.

Get memory system status and available users.

Analyze text for novelty signals. Returns detected signals, confidence scores, and suggested persistence targets. Use this to determine what from a conversation should be persisted to memory.

Search L2 warm index by keyword, type, and/or tags. Returns matching entries with relevance scores. Use this to find entities, sessions, or learnings from memory.

Read a specific L2 warm item by ID. Returns the full item content (entity, session, or learning).

Create or update an L2 warm item. Use for storing entities (people, orgs, projects, concepts), session summaries, or learnings (patterns, insights, principles).

Delete a specific L2 warm item by ID. Removes the item from storage and the index.

Create a backup of the memory database. Returns backup manifest with SHA-256 verification. SQLite provider only.

Restore memory database from a backup. Verifies SHA-256, runs integrity checks, migrates schema if needed. SQLite provider only.

Share a private memory to a group. Creates an immutable copy; the original is never modified.

Create a new group. The calling entity becomes owner.

List groups, optionally filtered by entity membership.

Read group details including members.

Add a member to a group. Requires admin/owner role.

Remove a member from a group. Requires admin/owner role.

Bind a working directory to a group. Writes from that directory will be scoped to the group, and searches will prioritize group memories. Stored in L1 active.context_bindings.

Remove a context binding for a working directory. Restores default behavior (private memory).

Rebuild FTS and vec indexes from L2 items. Rebuilds FTS keyword index (includes details field) and vec embeddings. Uses cached embeddings where available, generates new ones via Ollama.

Reconcile search index with node storage. Indexes replicated items that arrived via P2P but are missing from local FTS5/vec search. Runs automatically on startup and every 60s, but can be triggered manually.

Prefetch top L2 items for faster session start. Returns most recently accessed items from user groups and private memory. Context-aware: prioritizes bound group if context binding exists.