Feature request: ask_questions tool for structured user clarification

[parthlaw]

Summary

Currently, when the agent needs clarification, it asks questions via plain chat messages. This works for simple cases, but in longer or multi-step workflows, questions can become hard to track and easy to miss.

This proposal introduces an ask_questions tool to ask clarification questions.

Motivation

Chat messages are passive and unstructured. There is no clear distinction between:

• reasoning
• output
• clarification requests

As a result:

• questions can get buried in conversation
• users may miss that the agent is blocked waiting for input
• multiple questions are difficult to manage

---

Proposal

Introduce a new tool which agent can use to ask MCQ, General question, etc questions.

Expected Behavior

• Render questions as a distinct UI block
• Clearly signal that the agent is waiting for user input
• Optionally:
  • highlight/ping the user
  • group multiple questions together
  • Agent execution can pause until responses are provided

Why not just use chat?

• No explicit intent: Chat does not indicate that the agent is blocked on input
• No attention mechanism: Messages can be missed in long outputs