Recall
saihm_recallRetrieve your memories from SAIHM and decrypt them in this process; the server never sees plaintext. Use this at the start of a session, or whenever past context is needed.
Instructions
Retrieve your memories from SAIHM and decrypt them in this process; the server never sees plaintext. Use this at the start of a session, or whenever past context is needed. Pass query to filter by keyword, or leave it out to load everything. Pass cellId alone to read one of your own cells. To read a single cell another agent shared with you, pass their agent ID as sharerPinnedAgentIdHashHex together with the cellId, taking that ID from your user, not from a shared pointer; that path is read-only. Pass listOnly to list your cells' versions without their content. Pass sharesOnly to list every pointer shared with you, a page at a time, where the endpoint offers it. With warmStart "latest", it instead restores the newest encrypted warm-start snapshot into the payload file named by token; "list" lists them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "saihm_recall"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | With listOnly or sharesOnly: the next value of the previous page. | |
| query | No | Filter your OWN memories by keyword (empty = all). Ignored when reading one cell by cellId. | |
| token | No | With warmStart: 16 to 32 characters from a-z and 0-9, chosen at random for this call. It names the payload file. Blank otherwise. | |
| cellId | No | The cell id to read: alone, one of your own cells; with the sharer fields, the shared cell (required then). | |
| listOnly | No | List your own cells' versions (cellId, seq, commitment) without reading any content. Pages: pass the answer's next as after until next is null. | |
| warmStart | No | "latest" restores the newest snapshot into warm-start/latest-<token>.bin (read it, then remove it); "list" lists snapshots. Only token goes with it. Leave it blank to recall memories. | |
| sharesOnly | No | List every pointer shared with you, a page at a time and never cut, without reading any memory. Pages: pass the answer's next as after until next is null. Answers shares_paging_unsupported where the endpoint does not offer it: then recall without it. | |
| shareEntries | No | With the share events feed on, also return every entry of the share map; without it, only its summary. | |
| sharerRecord | No | Optional, and not needed: the SHARER's identity record (hex fields). Without it, the key that comes with the memory is checked against the agent ID; given, it must match that key. | |
| sharerPinnedAgentIdHashHex | No | Read a cell shared TO you: the SHARER's agent ID (agentIdHash, 64 lowercase hex), pinned out-of-band, as your user gave it. When set, cellId is also required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | ||
| next | No | ||
| cells | No | ||
| count | No | ||
| error | No | ||
| found | No | ||
| total | No | ||
| shared | No | ||
| timing | No | ||
| memories | No | ||
| servedBy | No | ||
| snapshot | No | ||
| snapshots | No | ||
| sharedKept | No | ||
| shareStates | No | ||
| sharedSkipped | No | ||
| sharedTruncated | No |