Store a memory with optional context metadata.

Args: content: The information to remember. project: Cortical region — project name for scoped retrieval. language: Programming language context. scope: Engram cluster — domain scope (e.g. "auth", "database"). memory_type: Memory system (episodic/semantic/procedural/prospective). tags: Comma-separated tags for categorization. source: Which tool stored this ("copilot", "cursor", etc.). overwrite: If True and content is a near-duplicate of an existing memory, replace the old memory instead of rejecting. The response will include "replaced": <old_parent_id> and "status": "updated". agent_id: Namespace identifier for the storing agent or bot. Memories tagged with an agent_id are only returned when the same agent_id is supplied at recall time. relations: JSON-encoded list of [subject, predicate, object] triples to assert as relationship edges immediately, e.g. '[["AuthService","depends_on","JWTHelper"]]'. Malformed input is silently ignored so it never blocks the store.

Returns: JSON with memory ID on success, or rejection reason.

Recall memories relevant to a query.

Args: query: What to search for (semantic similarity). n_results: Maximum number of results to return. project: Filter to a specific cortical region (project). language: Filter to a specific language. scope: Filter to a specific engram cluster (domain scope). memory_type: Filter by memory system (episodic/semantic/procedural/prospective). reference_date: ISO-8601 date for temporal context (e.g. "2026-04-12"). Defaults to now. agent_id: Namespace identifier — only returns memories stored with the same agent_id. Omit or leave empty to query the global shared namespace.

Returns: JSON array of matching memories with scores.

Remove a specific memory by ID.

Args: memory_id: The ID of the memory to remove.

Returns: JSON confirmation or error.

Pin a memory so it is always included in recall results.

Pinned memories model the thalamic relay — sustained activation that keeps critical facts always available to the cortex.

Args: memory_id: The ID of the memory to pin. priority: 0 = identity/system context, 1 = critical facts. label: Optional human-readable label for this pin.

Returns: JSON confirmation.

Remove a pinned memory from the thalamic buffer.

Args: memory_id: The ID of the memory to unpin.

Returns: JSON confirmation or not_found.

Prune stale memories that haven't been accessed recently.

Removes memories exceeding the idle threshold with low access counts.

Returns: JSON summary of pruned memories.

Show memory system status.

Returns: JSON with memory count and configuration.

KPI dashboard for the memory database.

Returns counts by memory type, project, scope, knowledge domain, access health (hot/warm/cold), age distribution, Hebbian link statistics, and a count of decay candidates. Optionally filter to a specific project or agent namespace.

Args: project: Restrict results to this project name (empty = all projects). agent_id: Restrict results to this agent namespace (empty = all agents).

Returns: JSON with total, entity_count, relationship_count, pinned_count, hebbian stats, by_type, by_project, by_scope, by_region, access, age, decay_candidates, and filter.

Replay episodic memories into the semantic network (offline consolidation).

Extracts entities from stored memories and builds co-occurrence relationships in the neocortex — like hippocampal replay during sleep.

Returns: JSON summary of memories replayed, entities found, and relationships created.

Bulk-load memories from a file or directory.

Supported formats:

• .txt / .md: file body stored as one memory. Optional YAML frontmatter (between --- delimiters) sets project, scope, language, memory_type, tags, and source for that file.

• .json: array of objects with a "content" key (same shape as myelin export output).

• directory: recurse and ingest every supported file found.

Args: path: Absolute or relative path to a file or directory. project: Default project tag (overridden by per-file frontmatter). scope: Default scope tag (overridden by per-file frontmatter). source: Source label for all ingested memories. recursive: Descend into subdirectories (default: true).

Returns: JSON summary with stored, skipped, and errors counts.

Lightweight health check — returns ok without initializing stores.

Returns: JSON with status and version.