search_memory
Search stored memories using hybrid vector and keyword retrieval. Supports time range filtering and session-based boosting for relevant context.
Instructions
Hybrid (vector + BM25) search over stored memories. Call this at the start of every user turn. NOTE: Lite memories expire 7d after they were saved.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query (natural language or keywords). | |
| limit | No | Max results (default: config search_result_limit). | |
| session_id | No | Optional project/task grouping key. Rows whose stored session_id matches this value are boosted in ranking (b_session_match=1.0); non-matching rows are dampened (b_session_mismatch=0.6). Pass the same session_id used at save time to surface that project's memories above unrelated rows. Leave blank to use the server default (N3MC_SESSION_ID env var, or per-process UUIDv4). | |
| since | No | §4.3.1 — ISO 8601 date or datetime (e.g. '2026-05-01' or '2026-05-01T09:00:00Z'). Only entries saved ON OR AFTER this timestamp are returned. Date-only values are treated as 00:00:00 UTC. | |
| until | No | §4.3.1 — ISO 8601 date or datetime. Only entries saved ON OR BEFORE this timestamp are returned. Date-only values are treated as 23:59:59 UTC. |