propose_memory_edit
Propose a human-reviewed text edit to an existing memory without altering it. The current version stays live until a person approves or rejects the change.
Instructions
Propose a text edit to an existing memory, for human review. Creates a PENDING memory carrying the edit; the target is left completely untouched and keeps injecting until a human approves. Approving it (review_memory action='approve') supersedes the target with the edited version; rejecting discards the proposal. old_text must occur exactly once — an ambiguous or absent anchor is an error, never a guess. field='content' (default) edits the body, field='instruction' edits the directive that injection renders. Use this instead of delete+save when you are correcting a memory you did not author: it keeps the current truth live until a person decides, and it cannot be used to silently rewrite a binding MUST.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"memory_id": "<memory_id>",
"old_text": "<old_text>",
"new_text": "<new_text>"
},
"name": "propose_memory_edit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| field | No | Which field to edit: `content` (default) or `instruction`. The instruction is what injection renders as the directive (§6.2), so the two are never conflated and there is no fallback from one to the other. | content |
| api_key | No | API key for agent authentication (required if agent has a registered key) | |
| agent_id | No | ID of the proposing agent — recorded as provenance on the pending memory | unknown |
| new_text | Yes | Replacement text | |
| old_text | Yes | Exact text to replace. Must occur exactly once in the target field — an ambiguous anchor is refused rather than guessed, because silently picking one would apply an edit nobody asked for. Case-sensitive. | |
| memory_id | Yes | ID of the memory to edit |