@pi-unipi/unipi 3.0.0-alpha.4 → 3.0.0-alpha.6

package/CHANGELOG.md

@@ -6,6 +6,48 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [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
+
+- **BREAKING: `@pi-unipi/image` removed.** Image generation, editing and recognition now live in `@pi-unipi/utility` (same `image` settings namespace, so existing configs keep working). **Migration path:** nothing to do with the umbrella package; if you installed `@pi-unipi/image` on its own, remove it and use `@pi-unipi/utility`.
+- **BREAKING: utility slimmed.** Removed `/unipi:reload` (use pi's `/reload`), `/unipi:status`, `/unipi:env`, `/unipi:prefix-cache`, the agent tools `ctx_env` and `set_session_name`, the top name-badge bar, the analytics collector and the process-lifecycle signal handlers. **Migration path:** `/unipi:doctor` covers the health checks; sessions are named automatically (below) or with pi's `/name`. Old `badge.*` settings carry over to `rename.*`.
+- **BREAKING: skill exposure moved** from `utility.skills` to the new `skills` namespace (`@pi-unipi/skill-registry`). Migrated automatically on first read.
+
+### Added
+
+- `utility`: `/unipi:retry`, an alias of `/unipi:continue`.
+- `utility`: **automatic session naming.** After each round, jev checks whether the round (your message plus what the agent did) established a subject and, for a named session, whether it moved to a different task; a throwaway session with a single `rename_session` tool writes the name. Greetings never rename; names set with `/name` are never overwritten; Herdr pane/tab sync kept.
+- `utility`: **`/unipi:answer`** — answer the last reply without scrolling: `reply` (default: the reply scrolls above a fixed input box, like `/unipi:btw`), `questions` (one answer per question, Q/A template) or `web` (local form; over SSH it prints the `ssh -L` forward). A hint above the editor says when a reply asks questions.
+- `utility`: **pasted images and files** become `[Image #N]` / `[File #N]` attachments with a chip row above the editor and inline previews in Kitty, Ghostty, iTerm2 and WezTerm; images are sent to the model as images.
+- `utility`: **image tools** `image_generate`, `image_edit` (new) and `image_recognize`, with OpenRouter, fal and custom-endpoint routes, a key per provider, and model pickers filtered by input/output modality. Default model FLUX.2 [klein] 4B.
+- `utility`: **response formatting** — Settings → Utility → Response formatting: `simple` (one line per tool), `regular` (pi's own) or `advanced` (highlighted commands incl. embedded heredoc/`-c` code, tinted syntax-highlighted diffs, test summaries, exit lines).
+- `utility`: `/unipi:settings <search>` opens the hub filtered; typing `/settings` lists `/unipi:settings` first.
+- `skill-registry`: now a real extension. **Skill settings…** grid (`/unipi:skills` → Skill settings…): per skill Enabled / Discoverable / Must show, per global or project scope, plus a skill vault at `~/.unipi/skill-vault` whose skills stay off until a scope turns them on (skill proxy, off by default).
+- `core`: the shared model cache (`~/.unipi/config/models-cache.json`) records input/output modalities; the settings hub pickers and kanboard read it.
+
+### Changed
+
+- `skill-registry`: skill judging keeps skills named in the request, lists hidden skills by name in the system prompt, waits for the first real request instead of freezing on a greeting, and caps generic workflow skills.
+- `fusion`: `/unipi:model` lists only your preset lead/sidekick models; typing searches the whole catalogue (also inside the lead/sidekick dropdowns).
+- `utility`: `/unipi:cleanup` only removes files on an explicit list, previews them and asks first; v2 memory backups can never be removed. `/unipi:doctor` checks the model cache, the Decision Model key and skill exposure.
+
+### Fixed
+
+- `image`: generation failed for most users (only a pi-ai OpenRouter route with a key pi often couldn't see) and failures were reported to the agent as successes.
+- `core`: capability-filtered model pickers hide entries with no declared input again.
+
 ## [3.0.0-alpha.4] — 2026-09-28
 
 ### Breaking Changes

package/README.md

@@ -33,7 +33,6 @@ pi install npm:@pi-unipi/unipi
 
 **[Web API](./packages/web-api/README.md)** — Web search, page reading, content summarization. Defaults to [wigolo](https://github.com/KnockOutEZ/wigolo), a local-first engine with multi-engine search and on-device reranking — $0/query, no API key. Plus a smart-fetch engine with browser-grade TLS fingerprinting. Paid providers as fallbacks, and auto-selection falls through when a provider is unavailable.
 
-**[Image](./packages/image/README.md)** — Generate images from a text prompt and analyze existing ones. 34 image models, plus vision analysis on any model that accepts image input, with a customizable system prompt.
 
 **[MCP](./packages/mcp/README.md)** — Browse 7,800+ MCP servers, add them interactively. Tools from servers register automatically as Pi tools.
 
@@ -116,14 +115,12 @@ Coexists triggers enhance behavior when packages are installed together. Workflo
 | `spawn_helper` / `get_helper_result` | subagents | Parallel agents |
 | `memory_store` / `memory_search` / `memory_delete` | memory | Memory CRUD |
 | `web_search` / `multi_web_content_read` / `web_llm_summarize` | web-api | Web research |
-| `image_generate` / `image_recognize` | image | Image generation and vision (recognize auto-hides while the session model has vision) |
+| `image_generate` / `image_edit` / `image_recognize` | utility | Image generation, editing and vision (recognize hides while the session model has vision) |
 | `notify_user` | notify | Push notifications |
 | `sidekick` / `read_subagent` | fusion | Delegate to the persistent sidekick and collect its report |
 | `bg_run` / `bg_status` / `bg_logs` / `bg_kill` / `bg_delegate` / `bg_result` | background-tasks | Long-running commands and background delegate agents |
 | `ask_user` | ask-user | User input |
 | `session_recall` / `context_budget` | compactor | Context management |
-| `ctx_env` | utility | Environment info |
-| `set_session_name` | utility | Session name for badge |
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.6",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -70,7 +70,6 @@
       "packages/notify/skills",
       "packages/kanboard/skills",
       "packages/updater/skills",
-      "packages/image/skills",
       "packages/subagents/skills"
     ],
     "prompts": [
@@ -84,27 +83,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.4",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.4",
-    "@pi-unipi/btw": "3.0.0-alpha.4",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.4",
-    "@pi-unipi/compactor": "3.0.0-alpha.4",
-    "@pi-unipi/core": "3.0.0-alpha.4",
-    "@pi-unipi/footer": "3.0.0-alpha.4",
-    "@pi-unipi/image": "3.0.0-alpha.4",
-    "@pi-unipi/fusion": "3.0.0-alpha.4",
-    "@pi-unipi/info-screen": "3.0.0-alpha.4",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.4",
-    "@pi-unipi/kanboard": "3.0.0-alpha.4",
-    "@pi-unipi/mcp": "3.0.0-alpha.4",
-    "@pi-unipi/memory": "3.0.0-alpha.4",
-    "@pi-unipi/notify": "3.0.0-alpha.4",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.4",
-    "@pi-unipi/subagents": "3.0.0-alpha.4",
-    "@pi-unipi/updater": "3.0.0-alpha.4",
-    "@pi-unipi/utility": "3.0.0-alpha.4",
-    "@pi-unipi/web-api": "3.0.0-alpha.4",
-    "@pi-unipi/workflow": "3.0.0-alpha.4"
+    "@pi-unipi/ask-user": "3.0.0-alpha.6",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.6",
+    "@pi-unipi/btw": "3.0.0-alpha.6",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.6",
+    "@pi-unipi/compactor": "3.0.0-alpha.6",
+    "@pi-unipi/core": "3.0.0-alpha.6",
+    "@pi-unipi/footer": "3.0.0-alpha.6",
+    "@pi-unipi/fusion": "3.0.0-alpha.6",
+    "@pi-unipi/info-screen": "3.0.0-alpha.6",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.6",
+    "@pi-unipi/kanboard": "3.0.0-alpha.6",
+    "@pi-unipi/mcp": "3.0.0-alpha.6",
+    "@pi-unipi/memory": "3.0.0-alpha.6",
+    "@pi-unipi/notify": "3.0.0-alpha.6",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.6",
+    "@pi-unipi/subagents": "3.0.0-alpha.6",
+    "@pi-unipi/updater": "3.0.0-alpha.6",
+    "@pi-unipi/utility": "3.0.0-alpha.6",
+    "@pi-unipi/web-api": "3.0.0-alpha.6",
+    "@pi-unipi/workflow": "3.0.0-alpha.6"
   },
   "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: 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 | on | Give the agent the tool |
+| 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) |