forget
Retire a memory by ID to stop it from surfacing in recall, with options for routine cleanup or factual correction that records provenance and contradiction links.
Instructions
Retire one specific memory by id. Mutating: tombstones the memory (a soft delete that preserves audit history), so it stops surfacing in recall; it is not a hard delete. Set mode='correct' when retiring a memory because it is WRONG (e.g. a surfaced/recalled fact the user contradicted), as opposed to routine cleanup: this records a distinct correct event with the memory's provenance, and if you pass corrected_by (the id of the memory holding the right answer) it also records a contradicts link. Use mode='correct' for factual corrections so the signal is captured explicitly rather than inferred later.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | tombstone (default) for routine cleanup; correct when the memory was factually wrong (records a correction signal). | |
| reason | No | Why the memory is being retired (recorded in the audit trail). | |
| dry_run | No | If true, validate without retiring. Default false. | |
| memory_id | Yes | Id of the memory to retire. Required. | |
| corrected_by | No | With mode='correct', the id of the memory holding the right answer (records a contradicts link). |