{
  "description": "Ask the user one or more questions when you need a decision, clarification, or feedback before proceeding. Pass every question in `questions` (1-5 entries) — a single question is a one-entry array, and several INDEPENDENT questions belong in ONE call (one form beats a chain of clarify calls; if one answer would change another question, ask separately). Per question: single-select (up to 4 choices — put your recommended option FIRST, the UI marks it '(Recommended)' and auto-appends an 'Other' free-text row), multi-select (multi_select=true), or open-ended (omit choices). Options go ONLY in `choices`, never enumerated inside the question text (choices render as pickable rows; options written into the question are dead prose the user can't click). Result: {responses: [...], outcome} in question order. Each response has status answered, skipped or unanswered (user_response is null unless answered); outcome is submitted, cancelled, timed_out or undelivered, with a notice saying why when the wait ended without a submit. Prefer deciding low-stakes questions yourself; don't use this for dangerous-command confirmation (the terminal tool handles that).",
  "name": "clarify",
  "parameters": {
    "properties": {
      "questions": {
        "description": "The question(s). Each: question text (options excluded), optional choices (recommended first; omit for free-text), optional multi_select. Responses come back in question order with the question text echoed.",
        "items": {
          "properties": {
            "choices": {
              "items": {
                "type": "string"
              },
              "maxItems": 4,
              "type": "array"
            },
            "multi_select": {
              "type": "boolean"
            },
            "question": {
              "type": "string"
            }
          },
          "required": [
            "question"
          ],
          "type": "object"
        },
        "maxItems": 5,
        "minItems": 1,
        "type": "array"
      }
    },
    "required": [
      "questions"
    ],
    "type": "object"
  }
}