memory_regulation_preview
Preview which memories would be compacted using success-evidence floors and category filters, with no mutation. Evaluate candidate budgets and retention outcomes before applying real compaction.
Instructions
Preview bounded, success-evidence-aware compaction without mutation.
This MCP surface is deliberately dry-run only. Actual compaction requires a
caller-owned idempotency authority through the SDK or governed operating loop.
categories_json may be a JSON array; an empty array selects no categories.
A nonzero empirical_success_floor_ppm measures retained Memory references
from exact-scope successful skill executions. It is a conservative evidence
floor, not a held-out task-success claim. held_out_task_evaluation_json
may instead provide the promotion-grade policy and candidate budgets. This
compact MCP surface will return their exact bindings but will not transport
authenticated receipts or mutate Memory.
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": "memory_regulation_preview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| budget | No | ||
| project_id | No | ||
| categories_json | No | ||
| empirical_success_floor_ppm | No | ||
| empirical_success_min_samples | No | ||
| held_out_task_evaluation_json | No | ||
| empirical_success_lookback_days | No | ||
| optimize_for_least_active_memory | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |