📦 MCP Tools - Batched Only

Only on batched (picked server-side by MEMORY_ENGINE=batched).

memory_flush - force pending memories onto storage

No args. Uploads all locally buffered memories as one batch blob (records only - the local JSON file remains the index).

{ "flushedMemories": 3, "cid": "baf…", "gatewayUrl": "https://gateway…/ipfs/baf…" }

{ "flushedMemories": 0 } when nothing was pending. Use before ending a session or whenever durability matters right now. On Walrus every blob costs ~63 MB of quota after erasure coding, so flushing packs many memories into one blob.

memory_rebuild_index - re-read every batch blob

No args. Restores the local index from the network by re-reading every mem-batch.<namespace>.* blob.

{ "restored": 42, "source": "blobs" }

Use on a new machine or after losing local state. Needs only storage credentials - but it lists and fetches every blob, so snapshots (memory_snapshot_index → memory_restore_local) are the fast path as history grows.