Look something up in memory
retrieveRetrieve canonical, keyholder-approved memory matching your query, returning scored, budgeted snippet pointers. Respects partition scope and logs payload size.
Instructions
Retrieve canonical (keyholder-approved) memory relevant to a query. Returns a scored, BUDGETED payload: mn:// pointers plus snippet renditions, never raw dumps. Scope is partition-walled; payload size is logged to the Foresight counters. Cite the returned rid when the action resolves.
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": "retrieve"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | ||
| query | Yes | what you need to remember | |
| scope | No | partition to search (must be inside this agent's MAGNEMO_SCOPE) | |
| budget | No | max payload bytes; results are truncated/downgraded to fit and the truncation is logged |