memory_update
Update an existing memory in place, preserving its ID and creation time. Correct stored facts without removing the record, with staleness detection if another agent modifies it first.
Instructions
Body edits clear last_verified_at; scope-only edits preserve it. Bundling a scope rename with a body edit clears verification.
Refine an existing memory in place. Preferred over memory_remove + memory_write when correcting a stored fact — preserves id, created, and source; bumps updated.
Parameters (pass at least one):
id: required.content: new body. Replacing the body clearslast_verified_at, the verified-* attestations, andclaims(the prior verification was for prose that no longer exists; call memory_verify again after, re-declaring claims). A body that reads as a claim ABOUT THE USER returnsuser_claim_warningunless the record is alreadyuser-inference; passacknowledge_user_claim=Trueif the subject is someone else. An edit that SHRINKS the body and leaves it ending mid-sentence returnstruncation_warning; passacknowledge_truncation=Truewhen the cut is deliberate.scopes/links: REPLACE semantics — pass the full new list, or[]to clear.confidence: low / medium / high.category: acceptsfactandambient.user-inferenceis REJECTED here — that category exists to gate WRITES through the pending-confirm flow; updates have no equivalent gate.
Returns status="stale" when another agent updated the memory first; the hint says to re-fetch and retry. Each links entry is {type, target_id (a ULID), note?}. The types: supersedes (prefer this over the target), contradicts (both cannot be true), extends (adds nuance to it), depends_on (only makes sense in its context). docs/api.md carries the rest.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| links | No | ||
| scopes | No | ||
| content | No | ||
| category | No | ||
| confidence | No | ||
| acknowledge_credential | No | ||
| acknowledge_truncation | No | ||
| acknowledge_user_claim | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||