search_memory
Find relevant past memories using hybrid vector and keyword search. Filter by date, category, or topic to retrieve context when debugging, writing, or referencing previous work.
Instructions
Search indexed memories by hybrid relevance (vector + BM25 + reranking) and return ranked results with optional temporal filtering. The shown score is a fused ranking score (0-100%), NOT pure cosine similarity — read it as relative ranking within this result set, not as match confidence. Read-only, but may fire stored reminders as a side effect. Use proactively at the start of tasks, when debugging, writing, or when the user references past work.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query — natural language or keywords | |
| limit | No | Max results to return | |
| scope | No | Optional explicit scope | |
| sessionId | No | Optional session identifier to infer session:<id> scope | |
| allScopes | No | When true, explicitly allow cross-scope search | |
| category | No | Filter by memory category: profile (identity/background), preferences (habits/style), entities (projects/tools/people), events (past happenings), cases (problem-solution pairs), patterns (reusable workflows) | |
| profile | No | Retrieval profile | |
| render | No | Result rendering mode: verbatim (default, original order) or highlight (reorder by contextual relevance to query) | verbatim |
| after | No | Filter memories stored after this date (ISO format YYYY-MM-DD, or relative like '最近30天', 'last 7 days') | |
| before | No | Filter memories stored before this date (ISO format YYYY-MM-DD, or relative) | |
| graph | No | Enable KG graph traversal (PPR) for relationship-aware search. Use when query involves entity relationships (e.g. 'what tools does Alice use', 'Bob的朋友'). | |
| includeArchived | No | When true, also return archived/superseded/consolidated memories (default: only active) | |
| detail_level | No | Result detail level: brief (ID+score+one-liner), normal (default, current behavior), full (include metadata) | normal |
| topicTag | No | Filter by topic tag (e.g. 'auth', 'deploy', 'testing'). Only returns memories tagged with this topic. | |
| reconstruct | No | Return LLM-synthesized reconstruction alongside raw results. Requires RECALLNEST_CONSTRUCTIVE_RETRIEVAL=true. | |
| validAt | No | Query memories valid at a specific point in time (ISO date, e.g. '2025-06-15'). Returns only memories whose validity window covers this date. | |
| includeExpired | No | When true, include expired memories in results (demoted 80%). Default: only active/non-expired. |