Search Facts
search_factsRead-onlyIdempotent
Search your persistent memory for stored facts.
For session bootstrap, prefer load_context() or wake_status() — they pull your identity, conventions, and latest self-note deterministically. Use search_facts when you need semantic discovery across the fact corpus.
Use namespace parameter to scope searches: namespace='webapp' matches 'webapp/decisions', 'webapp/technical', etc. (prefix matching).
Search tips: use the words the fact was stored with. If you stored 'Postgres database', search for 'database' or 'Postgres', not 'data storage solution'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer | No | Context persistence layer: 0=identity, 1=architecture, 2=state, 3=session. Pass 0-3 as integer or string. | |
| query | Yes | What to search for | |
| top_k | No | Number of results | |
| category | No | Filter by category | |
| namespace | No | Filter results to a specific namespace. | |
| recollect | No | When true (default), appends a RECOLLECTIONS section: facts cross-referenced from the top hits via related_facts and [[wiki]] links, ranked by association strength times outcome-weighted usefulness (reward/salience). Set false for plain semantic results only. | |
| boost_recent | No | When true (default), appends the 5 most recent facts for recency signal. Set false to get pure semantic results without recent-fact injection. |