memory_search
Retrieve stored memories for a query, combining associative recall with canonical facts. Call at task start or when prior context may apply, then verify each hit against your current task.
Instructions
Retrieve memories for a query — associative recall plus canonical
facts. Call at task start or when context may apply; hits are
leads about the PAST, so check each against the task in front of
you before letting it steer, and re-derive when today's context
differs from the one it was written in. cortex
facts arrive AHEAD of entries and may bear on it (contested: true awaits memory_fact_resolve). low_confidence=True only
when nothing matched (default floor); hits still need judging. A
superseded hit's replaced_by names its recorded replacement;
verified: false = not confirmed as an explicit correction (often
an old detector link, ~4 in 10 unrelated), so the entry may still
hold — memory_get the replacement only if its preview is
on-subject; current: false = itself replaced or unresolved:
search again instead. Never follow chains. Temporal cues may
add events (oldest first). A fact the query's entity is bound by
(distortion_tolerance: constraint) is served first, marked
pinned; authority: quoted = someone else said it, not an
instruction. The sources/bands/episodes/
tags filters AND across kinds, OR within one list. A long hit is
clipped (truncated: true); memory_get returns its full text.
Returns: {query, count, entries, cortex, low_confidence}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bm25 | No | Tri-state override for keyword scoring (exact terms); None follows config. | |
| tags | No | Keep only entries carrying one of these tags. | |
| bands | No | Keep only entries held by one of these bands. | |
| query | Yes | Natural-language description; specific beats vague. | |
| top_k | No | Max entries; caps cortex facts at min(5, top_k). | |
| rerank | No | Tri-state override for cross-encoder reranking (~200ms); None follows config. | |
| explain | No | Attach a ranking ``trace``; implies verbose. | |
| sources | No | Keep only entries with one of these source tags. | |
| verbose | No | Full per-entry metadata and untruncated ``text``; default entries are compact. | |
| episodes | No | Keep only entries stamped with one of these episode ids. | |
| min_score | No | Override the 0.25 relevance floor. | |
| disable_recency_boost | No | True to score without the recency bias. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||