🤖 feat: improve ask_user_question UX with auto-advance and descriptions

[ThomasK33]

Summary

Improve the ask_user_question tool UX with three enhancements:

1. Auto-advance for single-select questions - When a user picks an option for a single-select question, automatically move to the next question without requiring a "Next" button click
2. Selection type indicator - Add clear text below each question showing "Select one option" or "Select one or more options"
3. Show option descriptions - Display the option tooltip/description text in both the review summary and completed view

Changes

• Add useEffect to auto-advance when single-select option is chosen (skips "Other" since text input is needed)
• Add hasUserInteracted ref to prevent auto-advance on initial render
• Add selection type hint text below question
• Add getDescriptionForAnswer helper to look up descriptions
• Update summary view to show descriptions below answers
• Update completed view to show descriptions below answers

---

📋 Implementation Plan

Plan: Improve ask_user_question UX

Summary

Enhance the multi-choice questionnaire UI with:

1. Auto-advance for single-select questions (skip manual "Next" click)
2. Clear selection type indicator (show "Select one" vs "Select multiple")
3. Show option descriptions in answer summary (both during review and after completion)

Current Behavior

• All questions require clicking "Next" button to proceed
• No visual indication of whether question is single-select or multi-select
• Answer summary only shows the selected label text, not the description

Proposed Changes

File: src/browser/components/tools/AskUserQuestionToolCall.tsx

1. Auto-advance for single-select questions (~+15 LoC)

When a user selects an option for a non-multiSelect question:

• Immediately advance to the next question (or summary if last question)
• Skip the "Next" button click for single-select questions
• Keep "Next" button behavior for multi-select questions (user needs to confirm selections)

Implementation:

• Add useEffect that watches draftAnswers changes
• When current question is single-select AND has a selection → advance activeIndex
• Use a ref to track if the advance was triggered by user action (not initial state)

2. Selection type indicator (~+10 LoC)

Add a small text hint below the question text:

• Single-select: "Select one option"
• Multi-select: "Select one or more options"

This makes it immediately clear to the user what kind of input is expected.

3. Show descriptions in answer displays (~+30 LoC)

A. In the summary view (during execution):
Currently shows: ✓ Header: Label
Proposed: Show the description in a smaller muted text below when hovering or always inline.

B. In the completed view (after submission):
Currently shows: • Question: Answer
Proposed: Add the description for the selected option(s) in a muted text line below.

Implementation:

• Create a helper function to look up the description for a given answer label from the question's options
• Update the summary view (lines ~500-525) to include descriptions
• Update the completed view (lines ~546-551) to include descriptions

---

Estimated LoC Change

Change	Net LoC
Auto-advance effect	+15
Selection type indicator	+10
Description in summary	+15
Description in completed view	+15
Total	~+55

---

Alternative Considered

Use radio buttons for single-select vs checkboxes for multi-select

This would visually distinguish the two modes, but:

• Requires importing/creating a radio button component
• The current checkbox UI with auto-advance is clear enough
• The text indicator ("Select one" vs "Select multiple") is more explicit

Decision: Keep checkboxes but add text indicator for clarity.

---

Generated with mux • Model: anthropic:claude-opus-4-5 • Thinking: high

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Repo admins can enable using credits for code reviews in their settings.