Create multiple new entities in the knowledge graph. Supports v1.6 freshness (ttl/confidence), v1.8 project scoping, and η.4.4 bitemporal validity (validFrom/validUntil/observationMeta).

Delete multiple entities from the knowledge graph

Read the entire knowledge graph

Open specific nodes by their names

List all distinct project IDs in the knowledge graph. Returns sorted array of projectId values, excluding global/unscoped entities.

Get the latest version of an entity. If the entity has been superseded by newer versions (via contradiction detection), returns the most recent one.

Get all versions of an entity in its version chain. Returns versions sorted by version number ascending. Works from any entity in the chain (resolves to root automatically).

Create multiple new relations between entities in the knowledge graph. Relations should be in active voice

Delete multiple relations from the knowledge graph

Mark a relation as no longer valid. Sets the validUntil timestamp on the matching active relation. Use for temporal facts that have ended (e.g., "Kai no longer works on Orion").

Query relations valid at a specific point in time. Returns only relations where validFrom <= date AND (validUntil is undefined OR validUntil >= date). Time-travel query for temporal knowledge graphs.

Get chronological relation history for an entity. Returns ALL relations (current and expired) sorted by validFrom ascending. Shows the full story of an entity over time.

Add new observations to existing entities in the knowledge graph

Delete specific observations from entities

Normalize entity observations by resolving pronouns and anchoring relative dates. Improves search matching quality.

Search for nodes in the knowledge graph based on query string, with optional tag and importance filtering

Search entities within a date range, with optional filtering by entity type and tags. At least one of startDate or endDate should be provided.

Perform TF-IDF ranked search

Perform boolean search with AND, OR, NOT operators

Perform fuzzy search with typo tolerance

Get search suggestions for a query

Automatically select and execute the best search method based on query characteristics and graph size. Returns results along with the selected method and reasoning.

Forget (delete) observations matching the given content. Tries exact match first; falls back to semantic search at 0.85 similarity threshold if available. Supports dryRun to preview what would be deleted.

Search using combined semantic, lexical, and metadata signals. Provides better recall than single-signal search by fusing multiple relevance signals. v3 additive options: graphWeight adds a graph-connectivity (PageRank) channel, expandNeighbors appends one-hop neighbors of top results, explain annotates results with evidence paths from query anchors, lookFor ranks expansion neighbors by a free-text connection description.

Analyze a search query to extract entities, temporal references, question type, and complexity. Useful for understanding query structure before searching.

Intelligent search with automatic query planning and reflection-based refinement. Iteratively improves results until adequate.

Save a search query for later reuse

Execute a previously saved search by name

List all saved searches

Delete a saved search

Update a saved search

Add tags to an entity

Remove tags from an entity

Set the importance score of an entity (0-10)

Add the same tags to multiple entities at once

Replace a tag with a new tag across all entities

Merge two tags into a target tag across all entities

Add a tag alias (synonym mapping)

List all tag aliases

Remove a tag alias

Get all aliases for a canonical tag

Resolve a tag to its canonical form

Set the parent of an entity for hierarchical organization

Get all child entities of an entity

Get the parent entity of an entity

Get all ancestor entities of an entity

Get all descendant entities of an entity

Get entity and all its descendants as a subgraph

Get all root entities (entities without parents)

Get the depth of an entity in the hierarchy

Move an entity to a new parent

Get statistics about the knowledge graph

Validate the knowledge graph for integrity issues

Find potential duplicate entities based on similarity

Merge multiple entities into one

Compress the graph by merging similar entities

Archive old or low-importance entities

Find the shortest path between two entities in the knowledge graph

Find all paths between two entities up to a maximum depth

Find all connected components in the knowledge graph

Calculate centrality metrics for entities in the graph

Import knowledge graph from various formats

Export knowledge graph in various formats with optional brotli compression and streaming for large graphs. Supports W3C Linked Data formats (turtle, rdf-xml, json-ld) added in η.5.4.

Ingest pre-normalized conversation data into the knowledge graph. Chunks messages by exchange pairs (user+assistant), creates entities with verbatim observations. Format-agnostic: normalize chat exports before calling.

Search for entities using semantic similarity. Requires embedding provider to be configured via MEMORY_EMBEDDING_PROVIDER.

Find entities similar to a given entity using semantic similarity. Requires embedding provider.

Index all entities for semantic search. Call this after adding entities to enable semantic search. Requires embedding provider.

Register a stable alias (ref) pointing to an entity name in the RefIndex for O(1) lookups

Resolve a stable alias (ref) to its entity name via the RefIndex

Remove a stable alias (ref) from the RefIndex

List all registered refs in the RefIndex, optionally filtered by entity name

Create an artifact entity (tool output, code snippet, API response, etc.) with a stable auto-generated ref

Retrieve an artifact entity by its stable ref or entity name

List all artifact entities, with optional filtering by tool name, type, or date

Search entities using a natural language time expression (e.g. "last week", "yesterday", "in January")

Configure the distillation pipeline policy (default, noop, or none) that filters memories before context formatting

Calculate the freshness score (0–1) for a specific entity based on its TTL and confidence

Return all entities whose freshness score is below a threshold

Return all entities that have passed their TTL expiry

Reset freshness for an entity by updating its creation timestamp to now and resetting confidence to 1.0

Generate a freshness report across all entities showing fresh, stale, and expired counts

Decompose a natural language query into a structured search plan and return matching entities

Set the active governance policy controlling which write operations (create, update, delete) are permitted for future requests

Query the audit log for operations matching filter criteria (operation type, agent ID, entity name, date range)

Get the full audit history for a specific entity in chronological order

Reverse a specific committed operation using its audit entry ID (restores entity to before-snapshot)

Apply a built-in role profile (researcher, planner, executor, reviewer, coordinator) to adjust salience weights and context budgets

List all built-in role profiles with their salience weight and context budget configurations

Enable or disable the Shannon entropy gate that drops low-information memories during consolidation

Compute the Shannon entropy of a text string (in bits per character)

Start the background consolidation scheduler that periodically deduplicates and merges memories

Stop the background consolidation scheduler

Run a consolidation cycle on demand, independently of the scheduled interval

Format memories for LLM prompt consumption with proportional token allocation based on salience scores

Synthesize context by traversing the graph neighbourhood from a seed entity and merging high-salience neighbors across agents

Distill lessons from a failed session by tracing the causal chain and extracting actionable insights

End a session and trigger failure distillation if the session outcome was a failure

Get the user profile. Returns static facts (long-lived preferences) and dynamic facts (recent session context). Profiles are scoped by projectId.

Add a fact to the user profile. Static facts are long-lived (preferences, role, tools). Dynamic facts are recent (current project, active work).

Write a timestamped diary entry for a specialist agent. Each agent gets its own persistent diary (entity: diary-{agentId}). Use for code review findings, architecture decisions, ops incidents, etc.