Ask user

Lets the agent ask you questions in the terminal: single or multiple choice with descriptions, free text through Other answer, and a summary to review before sending. No extra model call, no external service.

pi install npm:@clement_chsn/pi-ask-user

To try it, ask the agent: "Use ask_user to ask me for a scope as a single choice, then several features, with a description for each option."

Answering

The questionnaire replaces the input area below the conversation, one question at a time.

Free text replaces a single choice or complements checked options. Nothing is sent before you confirm the final Summary, even for a single question. Cancelling sends no partial answer: the agent receives cancelled.

Tool contract

{
  "questions": [
    {
      "id": "scope",
      "prompt": "Which scope do you want?",
      "options": [
        { "value": "minimal", "label": "Minimal version", "description": "Ships fast" },
        { "value": "complete", "label": "Complete version", "description": "More features" }
      ]
    },
    {
      "id": "features",
      "prompt": "Which features should be included?",
      "multiple": true,
      "options": [
        { "value": "search", "label": "Search" },
        { "value": "export", "label": "Export" }
      ]
    }
  ]
}

Question IDs are unique, as are option values within a question; multiple defaults to false. The result has a status (answered, cancelled or unavailable) and answers, each with id, prompt, selected (values and labels) and custom (free text or null).

The questionnaire needs Pi's interactive terminal. In RPC, JSON or print mode, or in a subagent, the tool returns unavailable at once, without asking or inventing an answer.