memory_recall
Retrieve relevant facts from persistent memory using natural-language queries combined with structured filters like category, entity, and date range. Results are ranked by recency, importance, and relevance.
Instructions
Semantic + filtered search over memory. Returns facts ranked by relevance (vector similarity blended with recency, importance, and reinforcement). Three main uses:
Session-start briefing — broad query like 'session briefing: user preferences, active projects, recent decisions'.
Per-prompt contextual recall — focused query derived from what the user just asked.
Conflict/replacement check — recall similar facts when you suspect new information may supersede an older fact. Deduplication during memory_store is automatic. Combine the natural-language query with structured filters (category, domain, entity, date range, metadata) for tighter results. If you have a known entity name and want everything about it, prefer memory_entity. For 'what does X own/use?' style questions, prefer memory_relations. When multiple Qdrant destinations are configured, use search_scope to choose 'routed' (routing/default behavior), 'all', a destination name, a configured scope name, a comma-separated destination list, or an array of destination names. Call memory_search_scopes to inspect available scopes and descriptions. By default output is human-readable text. Use output_format=json for machine-parseable results with separate results and related arrays. Default limit is 10; maximum effective limit is 50.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Filter by kind: fact, summary, distilled, relation. Optional. Telemetry is excluded by default. | |
| repo | No | Filter by repository or project surface. | |
| limit | No | Max primary results to return (default 10, maximum 50). Values above the maximum are clamped. | |
| query | Yes | Natural-language description of what you're looking for. Embedded and matched semantically — full sentences work better than keyword lists. | |
| since | No | Only facts created on or after this ISO 8601 date or datetime. | |
| until | No | Only facts created on or before this ISO 8601 date or datetime. | |
| branch | No | Filter by branch or working surface. | |
| domain | No | Filter by domain activity profile (same vocabulary as memory_store.domain). Optional. | |
| entity | No | Restrict to facts mentioning this entity (case-insensitive). For full entity context prefer memory_entity. | |
| category | No | Filter by category (same vocabulary as memory_store.category). Optional. | |
| task_key | No | Filter by task or issue key. | |
| episode_id | No | Filter by coherent episode ID. | |
| destination | No | Optional legacy single-destination override. Do not combine with search_scope. Prefer search_scope for routed/all/list search. | |
| graph_depth | No | Entity-graph traversal depth. 0 = vector search only (fast, default). 1 = also surface up to ceil(limit / 2) extra 1-hop entity-related facts (slower; use when the user asks 'what's connected to X?'). In JSON output these are returned separately as related. | |
| search_scope | No | Optional read/search scope. Accepts 'routed', 'all', a destination name, a configured scope name, a comma-separated destination list, or an array of destination names. Omit to use config.default_search_scope. | |
| workspace_id | No | [Removed in v0.4.0] No-op. | |
| output_format | No | Response format. text = backward-compatible human-readable lines (default). json = parseable object with query, limit metadata, results, related, counts, and optional nudge. | text |
| review_status | No | Filter by review lifecycle status (candidate / reviewed / approved / rejected). | |
| memory_subtype | No | Filter by memory subtype (must be valid for the chosen kind). Optional. | |
| origin_user_id | No | Filter to facts whose creation origin.user.id matches this value. Optional. | |
| workstream_key | No | Filter by durable workstream key. | |
| metadata_filter | No | Exact-match filter on the metadata map stored with each fact. All key/value pairs must match (AND logic). | |
| origin_agent_id | No | Filter to facts whose creation origin.agent.id matches this value. Optional. | |
| origin_interface | No | Filter to facts created through this origin interface. Optional. | |
| include_legacy_workspace | No | [Removed in v0.4.0] No-op. |