roque-nights.netlify.app

clear_plan

Use this to delete the whole committed plan. DESTRUCTIVE: requires confirm:true. Without confirm nothing is deleted; instead the app shows the person a confirmation banner and this returns confirmation_required. On success returns an undo_token valid for 5 minutes; call clear_plan again with { undo_token } to restore the plan. confirm:true and undo_token in the same call are opposite intentions and come back as invalid_input. Stays registered when the plan is empty so the undo is always reachable.

Input schema

{
  "type": "object",
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "Must be true to actually delete the plan. Ask the person first; without it nothing is deleted."
    },
    "undo_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Token returned by a previous clear_plan; restores that plan within 5 minutes."
    }
  },
  "additionalProperties": false
}