search_memory
Retrieve relevant past memories by semantic similarity search to inform current tasks, with optional temporal, category, and relationship filtering.
Instructions
Search indexed memories by semantic similarity and return ranked results with optional temporal filtering. 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. |