Consolidate memories (checkout)
consolidate_memoriesUse this when the user asks to consolidate, reflect on, or organize their memories, or when memory_status or a search result reports that consolidation is available. Checks out a batch of unconsolidated memories from the connected vault under a 15 minute lease and returns their texts plus server instructions for writing reflection entries. Follow the returned instructions to write the entries, then call commit_reflections with the batch_id. Nothing is modified until commit.
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": "consolidate_memories"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | 1 consolidates raw memories into reflections; 2 consolidates reflections into high-level reflections. | |
| max_tokens | No | Token budget for the checked-out batch. Defaults to 50000. No connector-side cap. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | Yes | ||
| count | Yes | ||
| covers | No | ||
| message | No | ||
| batch_id | Yes | ||
| memories | No | ||
| est_tokens | No | ||
| lease_expires_at | No | ||
| reflection_contract | No |