Store new information in agent memory.

Automatically extracts entities and keywords, generates a semantic embedding, and indexes for later retrieval.

Smart Deduplication (inspired by Mem0): If the new content is highly similar to existing memories (cosine > 0.85), the system will decide whether to ADD (new info), UPDATE (enrich existing), or NOOP (skip).

Args: bank_id: Memory bank identifier (e.g. 'antigravity', 'user-prefs'). content: The information to remember. context: Optional context about the source (e.g. 'project meeting'). timestamp: Optional ISO 8601 timestamp. Defaults to now.

Evaluate content importance before retaining. Uses LLM to score the content from 1-10 and only retains if score >= threshold.

Use this for bulk/automatic ingestion where you want the system to decide what's worth remembering.

Args: bank_id: Memory bank identifier. content: The information to potentially remember. context: Optional context about the source. timestamp: Optional ISO 8601 timestamp. threshold: Minimum importance score to retain (1-10, default 5).

Search and retrieve relevant memories using semantic similarity and keyword matching, merged with Reciprocal Rank Fusion.

Args: bank_id: Memory bank to search. query: Natural language search query. limit: Maximum number of results (default 10, max 50). time_min: Optional ISO 8601 lower bound for timestamp filtering. time_max: Optional ISO 8601 upper bound for timestamp filtering. verbose: If True, also show relevance scores (RRF/Sim) per item. Default False keeps the output compact (content + ID only) to save context tokens.

Reflect on accumulated memories to generate new insights.

Retrieves relevant memories, analyzes them with an LLM, and saves the resulting insight as a 'mental model' for future reference.

Args: bank_id: Memory bank to reflect on. query: What to reflect on (question, topic, or open-ended prompt). limit: Max memories to consider (default 20, max 100). auto_refresh: Whether to refresh this model after future consolidations. source_query: Optional query to use for future refreshes. Defaults to query.

Manually trigger observation consolidation for a bank.

Processes unconsolidated memories and synthesizes them into observations — patterns, preferences, and durable knowledge.

Args: bank_id: Memory bank to consolidate.

Configure a memory bank's retain and observations missions.

The retain_mission guides what entities/keywords to extract (and what to ignore). The observations_mission guides what patterns to consolidate into observations.

Args: bank_id: Memory bank to configure. retain_mission: Plain-language description of what this bank should focus on. observations_mission: Plain-language description of what observations to synthesize.

Get the current configuration for a memory bank.

Args: bank_id: Memory bank to query.

List all available memory banks with their memory counts.

Get statistics for a specific memory bank.

Args: bank_id: Memory bank identifier.

Delete a specific memory by its ID. This is destructive and cannot be undone.

Args: memory_id: ID of the memory to delete.

List memories in a bank with pagination, ordered by most recent.

Args: bank_id: Memory bank to browse. limit: Maximum number of memories to return (default 20, max 100). offset: Number of memories to skip for pagination (default 0).

Get full details of a specific memory by its ID.

Args: memory_id: The memory ID to look up.

Update an existing memory's content. Re-extracts entities/keywords and regenerates the embedding if content changes.

Args: memory_id: ID of the memory to update. content: New content text (leave empty to keep current). context: New context string (leave empty to keep current).

Delete ALL memories and observations in a bank, keeping the bank itself. Mental models are preserved. This is destructive and cannot be undone.

Without confirm=true this makes NO changes and returns a preview of what would be deleted. Only pass confirm=true after the user has explicitly approved deleting this specific bank's contents.

Args: bank_id: Bank to clear. confirm: Must be true to actually delete. Defaults to false (preview).

Permanently delete a bank and ALL its memories, observations, models, and config. This is destructive and cannot be undone.

Without confirm=true this makes NO changes and returns a preview of what would be deleted. Only pass confirm=true after the user has explicitly approved deleting this specific bank.

Args: bank_id: Bank to delete entirely. confirm: Must be true to actually delete. Defaults to false (preview).

List mental models (insights generated by Reflect) for a bank.

Args: bank_id: Memory bank to list mental models from. limit: Maximum number of models to return (default 10).

Get full details of a specific mental model.

Args: model_id: The mental model ID to look up.

Delete a specific mental model. This is destructive and cannot be undone.

Args: model_id: ID of the mental model to delete.

Refresh an existing mental model by re-analyzing current memories. Updates the insight based on the latest data in the bank.

Args: model_id: ID of the mental model to refresh. limit: Max memories to consider (default 20, max 100).