[FEATURE] Configurable pageSize for AskUserQuestion tool

[wentworth-miller]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• This is a single feature request (not multiple features)

Problem Statement

The built-in AskUserQuestion tool limits options to a maximum of 4 per question (maxItems: 4 in the tool schema). This is too restrictive for many real-world scenarios, such as:

• Selecting from a list of files, branches, or config items
• Multi-select scenarios where there are many valid choices
• Displaying a larger set of options for the user to pick from without needing multiple round-trips

Proposed Solution

Allow the caller (or skill) to specify a pageSize (or similar) parameter to control how many options are displayed per page, instead of hardcoding the limit to 4.

For example:

{
  "questions": [{
    "question": "Which file do you want to modify?",
    "options": [... up to N options ...],
    "pageSize": 10
  }]
}

Describe alternatives you've considered

• Splitting into multiple AskUserQuestion calls — works but adds friction and loses context
• Using plain text output with numbered options — works but loses the structured selection UX

Additional context

The current maxItems: 4 constraint is defined in the tool schema and cannot be overridden by skills or configuration. Increasing or making it configurable would significantly improve the tool's usability for selection-heavy workflows.

Alternative Solutions

No response

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

No response

Additional Context

No response