run_decay
Runs a memory decay cycle to lower old memories' scores, archive low-score or expired entries, and optionally permanently forget retained archives; MUST items skip score decay but still expire.
Instructions
Run a memory decay cycle: reduces decay_score for old memories and archives memories that fall below the threshold or whose expires_at valid-time bound has passed. MUST memories are exempt from score-based decay, but NOT from expiry — a MUST whose window has closed is a binding instruction that is no longer true. This is not purely reversible: if MEMVAULT_FORGET_AUTO_ENABLED=1, the same run also permanently forgets archived memories older than MEMVAULT_FORGET_RETENTION_DAYS (default 90); otherwise auto-forget is off. Requires agent auth when the agent has a registered key. Returns updated/archived/expired_archived/contradicted/harmful_flagged/auto_forgotten counts.
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": "run_decay"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | API key for agent authentication (required if agent has a registered key) | |
| agent_id | No | ID of the requesting agent | unknown |