ask-user-question

User input collection via modal dialog captures explicit user responses before task execution. Use the AskUserQuestion tool to present a focused UI modal with your question, options, and optional text input, then receive structured results like selectedOptions or customText to pass downstream.

Yes, the modal supports both single and multi-select question formats. Configure multiSelect as false for single-choice or true for multiple selections, define your options with labels, and the modal returns the user's chosen options in structured format.

Modal-based confirmation handles safety checks, preference gathering, and requirement clarification. Present confirmation questions with optional headers and choice options, optionally include text input fields, and receive explicit user guidance as structured data before proceeding with sensitive actions.

The modal schema supports optional text input alongside standard choice options. Include both options array for selections and enable custom text capture in your question configuration; the modal returns both selectedOptions and customText in the structured result.

Modal prompts provide a reliable, focused UI interface that keeps user input collection separate from backend processing. This ensures agents gather explicit guidance without exposing CLI outputs, maintains clean separation of concerns, and creates a better user experience for clarification workflows.

Yes, the modal schema accepts an optional header field alongside your question text. Headers provide context and visual organization, helping users understand the purpose of the prompt before selecting from available options.