@pi-unipi/unipi 3.0.0-alpha.5 → 3.0.0-alpha.7

package/CHANGELOG.md

@@ -6,6 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.7] — 2026-09-28
+
+### Changed
+
+- `ask-user`: `ask_user` is **off by default** (Settings → Ask User). When off, the agent is told to ask in its reply instead.
+
+## [3.0.0-alpha.6] — 2026-09-28
+
+### Changed
+
+- `ask-user`: **rebuilt after Devin's question UI**. One `ask_user` call carries 1–4 questions (`questions: [{ header, question, options, multi_select }]`) with an automatic "Other" choice. Header chips show progress; digits pick; typing on "Other" needs no Enter and the text stays editable; ←→ switch questions; Enter moves on and submits on the last; unanswered questions are sent as skipped; `?` tells the agent you want to clarify first; Esc stops the turn. Pasted/dropped paths and Ctrl+V images in "Other" become `[Image #N]` / `[File #N]` and images reach the model. The transcript shows a short answer tree. The older single-question form is still accepted (`timeout` is ignored). Settings (/unipi:settings → Ask User): questions per call, what Esc does (stop the turn or send what's answered), whether number keys move on, "Other" agent-decided / always / never, and the "not ready" line — the old "allowed formats" switches are gone. Esc and `end_turn` options stop the turn cleanly instead of aborting it.
+
+### Fixed
+
+- `ask-user`: several `ask_user` calls in one message opened their dialogs at the same time, so only the last was answerable and the turn hung forever; the tool now runs one call at a time.
+- `compactor`: answers from multi-question `ask_user` results are kept as "question → answer" decisions.
+
 ## [3.0.0-alpha.5] — 2026-09-28
 
 ### Breaking Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.5",
+  "version": "3.0.0-alpha.7",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -83,26 +83,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.5",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.5",
-    "@pi-unipi/btw": "3.0.0-alpha.5",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.5",
-    "@pi-unipi/compactor": "3.0.0-alpha.5",
-    "@pi-unipi/core": "3.0.0-alpha.5",
-    "@pi-unipi/footer": "3.0.0-alpha.5",
-    "@pi-unipi/fusion": "3.0.0-alpha.5",
-    "@pi-unipi/info-screen": "3.0.0-alpha.5",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.5",
-    "@pi-unipi/kanboard": "3.0.0-alpha.5",
-    "@pi-unipi/mcp": "3.0.0-alpha.5",
-    "@pi-unipi/memory": "3.0.0-alpha.5",
-    "@pi-unipi/notify": "3.0.0-alpha.5",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.5",
-    "@pi-unipi/subagents": "3.0.0-alpha.5",
-    "@pi-unipi/updater": "3.0.0-alpha.5",
-    "@pi-unipi/utility": "3.0.0-alpha.5",
-    "@pi-unipi/web-api": "3.0.0-alpha.5",
-    "@pi-unipi/workflow": "3.0.0-alpha.5"
+    "@pi-unipi/ask-user": "3.0.0-alpha.7",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.7",
+    "@pi-unipi/btw": "3.0.0-alpha.7",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.7",
+    "@pi-unipi/compactor": "3.0.0-alpha.7",
+    "@pi-unipi/core": "3.0.0-alpha.7",
+    "@pi-unipi/footer": "3.0.0-alpha.7",
+    "@pi-unipi/fusion": "3.0.0-alpha.7",
+    "@pi-unipi/info-screen": "3.0.0-alpha.7",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.7",
+    "@pi-unipi/kanboard": "3.0.0-alpha.7",
+    "@pi-unipi/mcp": "3.0.0-alpha.7",
+    "@pi-unipi/memory": "3.0.0-alpha.7",
+    "@pi-unipi/notify": "3.0.0-alpha.7",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.7",
+    "@pi-unipi/subagents": "3.0.0-alpha.7",
+    "@pi-unipi/updater": "3.0.0-alpha.7",
+    "@pi-unipi/utility": "3.0.0-alpha.7",
+    "@pi-unipi/web-api": "3.0.0-alpha.7",
+    "@pi-unipi/workflow": "3.0.0-alpha.7"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/README.md

@@ -1,124 +1,72 @@
 # @pi-unipi/ask-user
 
-Structured user input for decision gates. When the agent needs you to pick between options — which database, which approach, which files to change — it calls `ask_user` instead of guessing.
+The `ask_user` tool (off by default — enable it in `/unipi:settings` → Ask User): when the agent needs a decision from you, it asks 1–4 multiple-choice questions in one dialog and waits. Modelled on Devin's question UI.
 
-Three input modes: single-select (pick one), multi-select (toggle several), freeform (type your own). The agent presents the question, you answer, it continues.
-
-## Commands
-
-Ask-user has no user commands. It's an agent tool package — the agent calls it when it needs input.
-
-## Special Triggers
-
-All workflow skills detect ask-user and use it for decision gates. Instead of the agent deciding on its own, it presents options and waits for your input. This happens naturally during brainstorm, plan, work, and other skills when the agent faces ambiguity.
-
-For workflow handoffs, options can use `action: "new_session"` with a `prefill`. Selecting one opens a launcher where **Compact & run** queues the prefill after compaction (or a short fallback) and **Run directly** queues it immediately. If automatic queuing fails, the prefill is placed in the editor for you to submit manually.
-
-The bundled skill guides the agent to use `ask_user` for high-stakes decisions — architecture choices, database selection, naming decisions, anything with lasting impact.
-
-## Agent Tool
-
-| Tool | Description |
-|------|-------------|
-| `ask_user` | Structured user input with options |
-
-### Parameters
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `question` | string | required | The question to ask |
-| `context` | string? | — | Additional context shown before question |
-| `options` | array? | [] | Multiple-choice options |
-| `allowMultiple` | boolean? | false | Enable multi-select mode |
-| `allowFreeform` | boolean? | true | Allow freeform text input |
-| `timeout` | number? | — | Auto-dismiss after N ms |
-
-### Example
-
-```typescript
-ask_user({
-  question: "Which database should we use?",
-  options: [
-    { label: "PostgreSQL", description: "Reliable, feature-rich" },
-    { label: "SQLite", description: "Simple, serverless" },
-  ],
-})
 ```
-
-### `new_session` Handoffs
-
-```typescript
-ask_user({
-  question: "Continue with implementation?",
-  options: [
-    {
-      label: "Proceed to work",
-      value: "work",
-      action: "new_session",
-      prefill: "the implementation step specs:2026-05-06-feature-plan.md",
-    },
-    { label: "Done for now", value: "done", action: "end_turn" },
-  ],
-  allowFreeform: false,
-})
+── Planet ✓ · Foods 2 · Last book ─────────────────────────────────────
+  What was the last book you read?
+    Can't remember
+    Don't read books
+  ❭ Other (type your own)
+    └ Dune, cover: [Image #1]
+      [Image #1] red-cube.png · 570 KB
+───────────────────────────────────────────────────────────────────────
+↑↓ navigate · ↵ select · ctrl+v image · ←→ switch question · esc cancel
+? Not ready to answer, help me out!
 ```
 
-When the user chooses a `new_session` option:
-
-| Launcher choice | Behavior |
-|-----------------|----------|
-| 🧹 Compact & run | Starts context compaction, returns immediately, then queues/submits the prefill as a follow-up message from the compaction callback or a short fallback timer |
-| ▶ Run directly | Queues/submits the prefill immediately as a follow-up message |
-| ✕ Cancel | Cancels the handoff; no message is queued |
-
-The tool result is rendered as `queued compact → ...` or `queued direct → ...`. If automatic delivery fails, ask-user falls back to editor prefill and warns you to press Enter.
-
-### History Expansion
+## Answering
 
-Completed `ask_user` calls stay readable in chat history. The collapsed result shows the selected answer; press Ctrl+O on the tool result to expand the original question, context, and options that were presented.
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Move between options |
+| `1`–`9` | Pick that option (single choice: picks and moves on; multi-select: toggles) |
+| `space` | Toggle (multi-select) |
+| `enter` | Select and go to the next question; on the last one, send everything |
+| `←` `→`, `tab` | Switch question (in a non-empty "Other" they move the text cursor) |
+| type | On "Other", just type — no Enter needed. The option numbers hide so digits are text |
+| paste / drop / `ctrl+v` | In "Other": a pasted or dropped image/file path, or a clipboard image (Ctrl+V), becomes `[Image #N]` / `[File #N]`; images are sent to the model with your answer |
+| `?` | Not ready to answer: the agent is told you want to clarify first |
+| `esc` | Cancel and stop the agent's turn (or send what's answered — see Settings) |
 
-### Keyboard Controls
+Questions you leave unanswered are sent as **skipped** — skipping never blocks. The header chips show progress: `✓` answered, a number for multi-select picks.
 
-| Mode | Keys |
-|------|------|
-| Single-select | Up/Down navigate, Enter select, Esc cancel |
-| Multi-select | Up/Down navigate, Space toggle, Enter submit, Esc cancel |
-| Freeform | Type text, Enter submit, Esc back |
+In the transcript the answers stay as a short tree (`● Asked user 3 questions` / `│ Planet: Mars` / `└ Last book: Dune`).
 
-### TUI Display
+## For the agent
 
-**Single-select:**
-```
-─────────────────────────────
- Which approach should we use?
-─────────────────────────────
- > Option A
-   Option B
-   Option C
-   Type something...
-
- Up/Down navigate, Enter select, Esc cancel
-─────────────────────────────
-```
-
-**Multi-select:**
+```ts
+ask_user({
+  questions: [{
+    header: "Database",                       // ≤16 chars, shown as a chip
+    question: "Which database should the service use?",
+    options: [                                // 2–4; "Other" is added automatically
+      { label: "Postgres", description: "JSON columns, full-text search" },
+      { label: "SQLite", description: "Zero setup; single writer" },
+    ],
+    multi_select: false,                      // optional
+    other: true,                              // optional; false removes "Other"
+  }],
+})
 ```
-─────────────────────────────
- Which features to enable?
-─────────────────────────────
- > [x] Logging
-   [ ] Metrics
-   [x] Tracing
-   [ ] Type something...
 
- Up/Down navigate, Space toggle, Enter submit, Esc cancel
-─────────────────────────────
-```
+The result is `User answered your questions:` followed by a JSON object keyed by question: `{ "selected": [...], "custom_text": "...", "skipped": false }`. Attached images follow as image content.
 
-## Configurables
+- Tool calls from one message run one at a time, so several `ask_user` calls can never hide each other (they used to: only the last dialog was answerable and the turn hung).
+- Options can carry `action: "end_turn"` or `action: "new_session"` with a `prefill` — the workflow skills use these for handoffs; a launcher offers **Compact & run** or **Run directly**.
+- The older single-question form (`question`, `context`, `options`, `allowMultiple`, `allowFreeform`) is still accepted; `timeout` is ignored — you answer in your own time.
+- Inside a subagent the tool fails with instructions to report the question to the lead instead.
 
-Ask-user has no configuration. Input mode is determined by the `allowMultiple` and `allowFreeform` parameters the agent passes.
+## Settings
 
-## License
+`/unipi:settings` → Ask User (changes apply to the next question, no restart):
 
-MIT
+| Setting | Default | What it does |
+|---------|---------|--------------|
+| Enable ask_user | **off** | Give the agent the tool; when off, the agent is told to ask in its reply instead |
+| Notify when asked | on | Send a notification while the agent waits for you |
+| Questions per call | 4 | How many questions one dialog may hold (1–4; the tool description updates in new sessions) |
+| Esc | stop the agent's turn | Or: send what's answered, the rest as skipped |
+| Number keys move on | on | In a single-choice question, 1–9 also goes to the next question |
+| "Other" choice | agent decides | Or: always / never offer "Other (type your own)", whatever the agent asked for |
+| "Not ready" line | on | Show "? Not ready to answer, help me out!" (the `?` key works either way) |