undo
undoDestructiveIdempotent
Undo a write the user saved in Compass OS (a tracked or moved role, a profile edit, a win, a draft, a resume or cover letter, interview prep): put back what it changed. Give the save's undo handle, or leave it empty for the user's latest save. Use it when the user wants a change taken back; to make a different change, use that change's own tool, such as move_job or edit_win. It asks the user first in a card, like every write, and runs once: an undo already used, more than 24 hours old, or past the last 20 saves is refused, and so is one whose record changed since the save, so a newer edit is never overwritten. Returns what was put back.
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": "undo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| undo | No | The save's undo handle, from its result; leave it empty for the user's latest save |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The answer, or what was done, in plain words for the user: the same text as content | |
| undo | No | On a saved write: its undo handle, for undo within 24 hours | |
| widget | No | The card the host draws with it, e.g. "pipeline"; "confirm" means a write waits for the user's Yes and nothing is saved yet |