The remember_batch tool (OwnSona Manual)

Next: The recall tool, Previous: The remember tool, Up: MCP Tools [Contents][Index]

5.3 The `remember_batch` tool ¶

Stores up to MAX_BATCH_SIZE (default 200) memories in a single call. The embedding provider is invoked once for the whole batch, making this dramatically faster than calling remember 200 times.

Inputs
Output
Errors

5.3.1 Inputs ¶

items: Required array. Each item has the same shape as a remember argument: text required, plus optional tags, source_provider, importance, capture_mode, session_id, dedup_policy, expires_at, last_confirmed_at.
source_provider: String. Optional default applied to items that don’t specify their own.
dedup_policy: String. Optional default policy applied to items that don’t specify their own. Default "ask".

5.3.2 Output ¶

{
  "ok": true,
  "results": [
    { "ok": true,  "memory_id": 200, "message": "Ok" },
    { "ok": true,  "memory_id": 201, "message": "Ok" },
    { "ok": false, "error": { "code": "SECRET_REJECTED", ... } }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}

Per-item failures do not fail the batch. Each item’s outcome lands in its own slot in results.

5.3.3 Errors ¶

Batch-level: INVALID_INPUT (e.g. items not an array, or exceeds MAX_BATCH_SIZE), EMBEDDING_ERROR. Per-item errors appear inside results.