Search Facts
search_factsSearch 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'.
Each search embeds the query on a shared embedder: at most 4 searches (search_facts, search_context) per account run at once; past that a call waits up to 2 s, then answers {"code": "busy", "retry_after_s": 2}. Fan out with 2-4 readers, not 16.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_facts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer | No | Context persistence layer: 0=identity, 1=architecture, 2=state, 3=session. | |
| 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. | |
| include_granted | No | When true (default), hits from workspaces shared with this account (active grants, under their granted prefixes) follow the own results, each tagged |from:<grantor>'s workspace: <prefix>. Set false to search this account only. A blind session (bind_agent blind=true) defaults to false; pass true to include granted hits there. Ignored inside a workspace session. |