@pi-unipi/unipi 2.20.2 → 2.20.4

package/CHANGELOG.md

@@ -6,6 +6,22 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.20.4] — 2026-09-19
+
+### Changed
+
+- `fusion`: **the `/unipi:model` picker name column now grows with the terminal.** `NAME_COL` was a fixed 24 columns, so every name past 23 characters was ellipsized even on a wide terminal and the thinking-effort control sat close to the name. `packages/fusion/src/picker.ts` now computes the column per render from the widest row label (`NAME_COL_MIN = 24`, capped to the available width) and keeps the effort bar right-anchored, so full names fit before the effort control.
+
+### Fixed
+
+- `fusion`: **model rows that look like a `provider/id` key are no longer ambiguous.** Rows label with `model.name || model.id` and never showed the provider, so an OpenRouter model named `deepseek/deepseek-v4.1-flash` was indistinguishable from a model actually served by provider `deepseek`. A dim `provider · ` prefix is now added only when the display name contains `/` or the same name is offered by more than one provider; the prefix is never truncated (the friendly name truncates instead). The highlighted row's price panel now spells out the exact registry key (`Model key  openrouter/deepseek/deepseek-v4.1-flash`, both lead and sidekick keys on the Fusion row).
+
+## [2.20.3] — 2026-09-17
+
+### Fixed
+
+- `background-tasks`: **distinguish persistent dev servers from finite jobs in `bg_run` prompt guidelines.** The prompt guidance previously grouped dev servers and test suites under the same "do not set `triggerOnCompletion:false`" rule. For persistent servers and watchers (e.g. `npm run dev`, `vite`), `triggerOnCompletion: true` caused the UI to show an indefinite "waiting on 1 bg task" spinner and caused `SidekickRuntime` in Fusion to hang waiting for `openBgTasks` to reach zero. `BgRunParams` and `promptGuidelines` in `packages/background-tasks/src/tools.ts` now explicitly instruct agents to set `triggerOnCompletion: false` for long-running servers/daemons so neither the harness nor sidekicks wait indefinitely for exit.
+
 ## [2.20.2] — 2026-09-17
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -84,29 +84,29 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.20.2",
-    "@pi-unipi/background-tasks": "2.20.2",
-    "@pi-unipi/btw": "2.20.2",
-    "@pi-unipi/command-enchantment": "2.20.2",
-    "@pi-unipi/compactor": "2.20.2",
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/footer": "2.20.2",
-    "@pi-unipi/image": "2.20.2",
-    "@pi-unipi/fusion": "2.20.2",
-    "@pi-unipi/info-screen": "2.20.2",
-    "@pi-unipi/input-shortcuts": "2.20.2",
-    "@pi-unipi/kanboard": "2.20.2",
-    "@pi-unipi/mcp": "2.20.2",
-    "@pi-unipi/memory": "2.20.2",
-    "@pi-unipi/milestone": "2.20.2",
-    "@pi-unipi/notify": "2.20.2",
-    "@pi-unipi/ralph": "2.20.2",
-    "@pi-unipi/subagents": "2.20.2",
-    "@pi-unipi/trajectory": "2.20.2",
-    "@pi-unipi/updater": "2.20.2",
-    "@pi-unipi/utility": "2.20.2",
-    "@pi-unipi/web-api": "2.20.2",
-    "@pi-unipi/workflow": "2.20.2"
+    "@pi-unipi/ask-user": "2.20.4",
+    "@pi-unipi/background-tasks": "2.20.4",
+    "@pi-unipi/btw": "2.20.4",
+    "@pi-unipi/command-enchantment": "2.20.4",
+    "@pi-unipi/compactor": "2.20.4",
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/footer": "2.20.4",
+    "@pi-unipi/image": "2.20.4",
+    "@pi-unipi/fusion": "2.20.4",
+    "@pi-unipi/info-screen": "2.20.4",
+    "@pi-unipi/input-shortcuts": "2.20.4",
+    "@pi-unipi/kanboard": "2.20.4",
+    "@pi-unipi/mcp": "2.20.4",
+    "@pi-unipi/memory": "2.20.4",
+    "@pi-unipi/milestone": "2.20.4",
+    "@pi-unipi/notify": "2.20.4",
+    "@pi-unipi/ralph": "2.20.4",
+    "@pi-unipi/subagents": "2.20.4",
+    "@pi-unipi/trajectory": "2.20.4",
+    "@pi-unipi/updater": "2.20.4",
+    "@pi-unipi/utility": "2.20.4",
+    "@pi-unipi/web-api": "2.20.4",
+    "@pi-unipi/workflow": "2.20.4"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/background-tasks/src/tools.ts

@@ -52,13 +52,13 @@ export const BgRunParams = Type.Object({
   notifyOnCompletion: Type.Optional(
     Type.Boolean({
       description:
-        "Deliver a durable terminal notification when the task finishes. Default true. Do not disable unless opting out of completion handling.",
+        "Deliver a durable terminal notification when the task finishes. Default true for finite tasks. Set false or pair with triggerOnCompletion:false for persistent servers/daemons/watchers.",
     }),
   ),
   triggerOnCompletion: Type.Optional(
     Type.Boolean({
       description:
-        "Start a follow-up agent turn on terminal notification. Default true for bg_run. Requires notifyOnCompletion.",
+        "Start a follow-up agent turn on terminal notification. Default true for finite tasks (tests, builds, exports). MUST set false for persistent background services/servers (e.g. dev servers, watchers) so the harness and subagents do not wait indefinitely for the server to finish. Requires notifyOnCompletion.",
     }),
   ),
 });
@@ -185,14 +185,14 @@ export function registerToolsAndCommands(options: RegisterSurfaceOptions): void
     promptSnippet:
       "Start a named long-running shell command; default terminal notification wakes a follow-up turn, so yield instead of polling",
     promptGuidelines: [
-      "Use bg_run instead of bash for commands expected to run for a long time, such as test suites, dev servers, watchers, or builds.",
+      "Use bg_run instead of bash for commands expected to run in the background (test suites, builds, dev servers, watchers).",
+      "For FINITE tasks (tests, builds, exports, scripts): leave triggerOnCompletion:true and notifyOnCompletion:true (defaults) to automatically wake the agent when finished.",
+      "For PERSISTENT servers/daemons/watchers (e.g. 'npm run dev', vite, live dev servers, background listeners): MUST set triggerOnCompletion:false (and optionally notifyOnCompletion:false) so the agent and sidekick do not wait for the server to exit.",
       "Set isAgent:true only when the background task launches an LLM/agent process; false for scripts, tests, dev servers, sleeps.",
       "Always set name to a concise 2-6 word human-readable label; do not use the raw command as the name.",
-      "bg_run returns immediately. With notifyOnCompletion:true and triggerOnCompletion:true (both defaults), completed, failed, or killed terminal state is delivered as <background-task-notification> and automatically starts a follow-up agent turn.",
-      "After a default bg_run launch, continue only independent useful work that does not merely wait for the task; otherwise briefly acknowledge it if useful, then end the current turn. Do not call sleep, bg_status, or bg_logs merely to wait; the terminal notification will wake you.",
+      "bg_run returns immediately. For finite tasks with default wake-up, continue only independent useful work that does not merely wait for the task; otherwise end the current turn. Do not call sleep, bg_status, or bg_logs merely to wait; the terminal notification will wake you.",
       "A running result is not an instruction to poll again.",
       "Treat <background-task-notification> as durable terminal truth. Do not call bg_status to reconfirm it.",
-      "Do not set notifyOnCompletion:false or triggerOnCompletion:false unless intentionally opting out.",
     ],
     parameters: BgRunParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.84.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/info-screen": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/info-screen": "2.20.4",
     "@earendil-works/pi-agent-core": "^0.84.0"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/background-tasks": "2.20.2"
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/background-tasks": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/fusion/README.md

@@ -10,10 +10,9 @@ pi's extension and RPC APIs natively.
 ╭ Model ───────────────────────────────────────────────────────────────╮
 │/ Type to search                                                       │
 │───────────────────────────────────────────────────────────────────────│
-│❭ Fusion                  ← ▰▰▰▱▱ → Medium     Lead Claude Fable… ▾    │
-│· GLM-5.3 Flash ✱        ▰▰▰▰▰   Max                              │
-│· Claude Fable 5.1       ▰▰▰▱▱   Medium                           │
-│· DeepSeek V4.1 Flash ✱  ▰▱▱▱▱   High                             │
+│❭ Fusion                              ← ▰▰▰▱▱ → Medium  Lead Fable… ▾ │
+│· GLM-5.3 Flash ✱                        ▰▰▰▰▰   Max                │
+│· openrouter · deepseek/deepseek-v4.1-flash ▰▰▱▱▱   High              │
 │  ↓ more below                                                        │
 │                                                                       │
 │  ━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━               │
@@ -21,6 +20,7 @@ pi's extension and RPC APIs natively.
 │  $10 / 1M   $0.25 / 1M     $50 / 1M   $0.2 / 1M                     │
 │  Sidekick cached input   Sidekick output                             │
 │  $0.02 / 1M              $1.2 / 1M                                   │
+│  Model key  openrouter/deepseek/deepseek-v4.1-flash                  │
 │                                                                       │
 │  ✱ New  ✱ Promotion  ✱ Beta · Pairs frontier intelligence with cost-efficient execution │
 │↑↓ select · tab lead · ←→ effort · ↵ confirm · esc cancel              │
@@ -44,7 +44,16 @@ pi's extension and RPC APIs natively.
 - **Price panel**: the highlighted model's blended price is marked on a
   logarithmic red→orange→yellow→green→cyan→blue→violet slider. Fusion shows
   `Input`, `Cached input`, `Output`, `Sidekick input`, `Sidekick cached input`,
-  and `Sidekick output`.
+  and `Sidekick output`, and the exact registry key of the highlighted row is
+  spelled out (`Model key  openrouter/deepseek/deepseek-v4.1-flash`; both the
+  lead and sidekick keys on the Fusion row).
+- **Name column & provider**: the name column sizes itself to the widest row
+  label (minimum 24 columns) up to the terminal width, and the effort control
+  stays right-anchored — so wide terminals show full names. A row only gets a
+  dim `provider · ` prefix when its display name is ambiguous: it contains a
+  `/` (`deepseek/deepseek-v4.1-flash` reads like a key) or the same friendly
+  name is offered by more than one provider. Unique names stay clean, and the
+  prefix is never truncated.
 - **Confirm** applies: `pi.setModel`, `pi.setThinkingLevel(effort)`, updates
   MRU + persisted active selection, and shows `Fusion · Lead ◆ Sidekick` in
   the footer. Switching the model through pi's own `/model`/Ctrl+P drops

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/subagents": "2.20.2"
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/subagents": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/fusion/src/picker.ts

@@ -109,9 +109,39 @@ type Row = { kind: "fusion" } | { kind: "model"; key: ModelKey };
 type FusionFocus = "effort" | "lead" | "sidekick";
 
 const DEFAULT_VISIBLE_ROWS = 10;
-const NAME_COL = 24;
+/** Minimum width of the name column (the pre-autosize default). */
+const NAME_COL_MIN = 24;
 const MARKER_COL = 2;
 const BAR_SEGMENTS = 5;
+/** Visible columns outside the name: pointer + marker prefix (4) + effort block (19). */
+const FIXED_COLS = 23;
+
+/**
+ * A model needs a provider prefix when its display name alone is ambiguous:
+ * it contains a "/" (so it reads like a `provider/id` key), or the same name
+ * is offered by more than one provider.
+ */
+function ambiguousNamesOf(models: readonly PickerModel[]): Set<string> {
+  const providersByName = new Map<string, Set<string>>();
+  for (const m of models) {
+    const set = providersByName.get(m.name) ?? new Set<string>();
+    set.add(m.provider);
+    providersByName.set(m.name, set);
+  }
+  const out = new Set<string>();
+  for (const [name, set] of providersByName) {
+    if (set.size > 1) out.add(name);
+  }
+  return out;
+}
+
+function needsProvider(m: PickerModel, ambiguous: ReadonlySet<string>): boolean {
+  return m.name.includes("/") || ambiguous.has(m.name);
+}
+
+function labelOf(m: PickerModel, ambiguous: ReadonlySet<string>): string {
+  return needsProvider(m, ambiguous) ? `${m.provider} \u00b7 ${m.name}` : m.name;
+}
 
 function printable(data: string): string | undefined {
   if (data.length !== 1) return undefined;
@@ -146,6 +176,9 @@ export class ModelPicker {
   private readonly modelsByKey: Map<ModelKey, PickerModel>;
   private readonly state: PickerState;
   private readonly priceRange: { min: number; max: number };
+  private readonly ambiguousNames: Set<string>;
+  /** Name column sized to the widest row label; capped to the available width at render time. */
+  private readonly naturalNameCol: number;
 
   private effort: Record<ModelKey, EffortLevel>;
   /** Fusion-row efforts — deliberately NOT stored in the per-model map. */
@@ -166,6 +199,12 @@ export class ModelPicker {
     this.onRenderRequest = options.onRenderRequest;
     this.visibleRows = options.visibleRows ?? DEFAULT_VISIBLE_ROWS;
     this.modelsByKey = new Map(options.state.models.map((m) => [m.key, m]));
+    this.ambiguousNames = ambiguousNamesOf(options.state.models);
+    const widestLabel = options.state.models.reduce(
+      (max, m) => Math.max(max, visibleWidth(labelOf(m, this.ambiguousNames))),
+      0,
+    );
+    this.naturalNameCol = Math.max(NAME_COL_MIN, widestLabel + 2);
     const prices = options.state.models.map((m) => (hasPricing(m.cost) ? blendedPrice(m.cost) : undefined)).filter((p): p is number => p !== undefined && p > 0);
     this.priceRange = { min: prices.length > 0 ? Math.min(...prices) : 0, max: prices.length > 0 ? Math.max(...prices) : 0 };
     this.effort = { ...options.state.effort };
@@ -416,7 +455,11 @@ export class ModelPicker {
     return shortName(m?.name ?? key, max);
   }
 
-  private renderRow(row: Row, highlighted: boolean, width: number): string {
+  private isAmbiguous(model: PickerModel): boolean {
+    return needsProvider(model, this.ambiguousNames);
+  }
+
+  private renderRow(row: Row, highlighted: boolean, width: number, nameCol: number): string {
     const t = this.theme;
     const pointer = highlighted ? t.fg("accent", "❭") : t.fg("dim", "·");
     const disabledFusion = row.kind === "fusion" && !this.fusionAvailable();
@@ -429,8 +472,14 @@ export class ModelPicker {
           : " "
         : this.markerFor(row.key);
     const working = row.kind === "model" && row.key === this.state.currentModelKey;
-    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, NAME_COL - 1);
-    const name =
+    const model = row.kind === "model" ? this.modelsByKey.get(row.key) : undefined;
+    // Only ambiguous rows (slash-y names, or names shared across providers) pay
+    // the width cost of a dim provider prefix. The name is truncated, never the
+    // prefix, so `openrouter · …` always survives.
+    const providerPrefix = model !== undefined && this.isAmbiguous(model) ? t.fg("dim", `${model.provider} · `) : "";
+    const nameBudget = Math.max(1, nameCol - visibleWidth(providerPrefix) - 1);
+    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, nameBudget);
+    const styled =
       row.kind === "fusion"
         ? disabledFusion
           ? highlighted
@@ -444,7 +493,7 @@ export class ModelPicker {
           : highlighted
             ? t.fg("accent", nameRaw)
             : t.fg("text", nameRaw);
-    const model = row.kind === "model" ? this.modelsByKey.get(row.key) : undefined;
+    const name = `${providerPrefix}${styled}`;
     const badge = model?.badge;
     const badgeGlyph = badge === undefined ? "" : ` ${t.fg(badge === "new" ? "success" : badge === "promotion" ? "accent" : "warning", "✱")}`;
 
@@ -458,7 +507,7 @@ export class ModelPicker {
         ? t.fg("accent", effortLabel(level))
         : t.fg("muted", effortLabel(level));
 
-    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, NAME_COL)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
+    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, nameCol)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
 
     if (row.kind === "fusion") {
       if (disabledFusion) {
@@ -480,10 +529,10 @@ export class ModelPicker {
     return truncateToWidth(line, Math.max(1, width - 1));
   }
 
-  private renderDropdown(width: number): string[] {
+  private renderDropdown(width: number, nameCol: number): string[] {
     const t = this.theme;
     const items = this.dropdownItems();
-    const indent = " ".repeat(MARKER_COL + NAME_COL + 5);
+    const indent = " ".repeat(MARKER_COL + nameCol + 5);
     if (items.length === 0) {
       return [`${indent}${t.fg("warning", `no ${this.focus} models in preset — run /unipi:fusion-preset`)}`];
     }
@@ -547,7 +596,23 @@ export class ModelPicker {
       : !hasPricing(primaryCost);
     const pricing = !disabledFusion && noPricing ? t.fg("dim", " · no pricing data from provider") : "";
     const description = `${badges}${badges.length > 0 ? " " : ""}${desc}${pricing}`;
-    return [truncateToWidth(`  ${head}`, width - 1), truncateToWidth(`  ${vals}`, width - 1), truncateToWidth(`  ${description}`, width - 1)];
+    // The row label may be a friendly name; spell out the exact registry key so
+    // the highlighted model is unambiguous (`openrouter/deepseek/...`).
+    const keys = row.kind === "fusion"
+      ? [this.lead, this.sidekick].filter((k): k is ModelKey => k !== undefined)
+      : primaryKey === undefined
+        ? []
+        : [primaryKey];
+    const out = [
+      truncateToWidth(`  ${head}`, width - 1),
+      truncateToWidth(`  ${vals}`, width - 1),
+    ];
+    if (keys.length > 0) {
+      const keyText = keys.map((k) => t.fg("text", k)).join(t.fg("dim", " · "));
+      out.push(truncateToWidth(`  ${t.fg("dim", "Model key")}  ${keyText}`, width - 1));
+    }
+    out.push(truncateToWidth(`  ${description}`, width - 1));
+    return out;
   }
 
   private hintLine(row: Row | undefined): string {
@@ -572,6 +637,10 @@ export class ModelPicker {
   private renderBody(width: number): string[] {
     const t = this.theme;
     const rows = this.rows();
+    // Give the name column every spare column (the effort control stays
+    // right-anchored) but never less than the historical 24.
+    const maxNameCol = Math.max(NAME_COL_MIN, width - FIXED_COLS - 1);
+    const nameCol = Math.min(this.naturalNameCol, maxNameCol);
     if (this.selected >= rows.length) this.selected = Math.max(0, rows.length - 1);
     const row = rows[this.selected];
     const lines: string[] = [];
@@ -591,9 +660,9 @@ export class ModelPicker {
         const r = rows[i];
         if (r === undefined) continue;
         const highlighted = i === this.selected;
-        lines.push(this.renderRow(r, highlighted, width));
+        lines.push(this.renderRow(r, highlighted, width, nameCol));
         if (highlighted && r.kind === "fusion" && this.focus !== "effort") {
-          lines.push(...this.renderDropdown(width));
+          lines.push(...this.renderDropdown(width, nameCol));
         }
       }
       if (end < rows.length) lines.push(t.fg("dim", `  ↓ more below (${String(rows.length - end)})`));

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Image generation and image recognition tools for the Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -39,8 +39,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/info-screen": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/info-screen": "2.20.4",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Lifecycle layer for project-level goals — MILESTONES.md tracking, session hooks, auto-sync",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -31,8 +31,8 @@
     "test": "npx tsx --test reminder.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
-    "@pi-unipi/info-screen": "2.20.2"
+    "@pi-unipi/core": "2.20.4",
+    "@pi-unipi/info-screen": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
   "type": "module",
   "main": "src/index.ts",
@@ -9,7 +9,7 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
     "@earendil-works/pi-agent-core": "^0.84.0",
     "acorn": "8.18.0"
   },

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/trajectory",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",

package/packages/unipi/bundled.js

@@ -22204,12 +22204,12 @@ var BgRunParams = Type4.Object({
   ),
   notifyOnCompletion: Type4.Optional(
     Type4.Boolean({
-      description: "Deliver a durable terminal notification when the task finishes. Default true. Do not disable unless opting out of completion handling."
+      description: "Deliver a durable terminal notification when the task finishes. Default true for finite tasks. Set false or pair with triggerOnCompletion:false for persistent servers/daemons/watchers."
     })
   ),
   triggerOnCompletion: Type4.Optional(
     Type4.Boolean({
-      description: "Start a follow-up agent turn on terminal notification. Default true for bg_run. Requires notifyOnCompletion."
+      description: "Start a follow-up agent turn on terminal notification. Default true for finite tasks (tests, builds, exports). MUST set false for persistent background services/servers (e.g. dev servers, watchers) so the harness and subagents do not wait indefinitely for the server to finish. Requires notifyOnCompletion."
     })
   )
 });
@@ -22299,14 +22299,14 @@ Command: ${task.command}`,
     description: `Start a named long-running shell command in the background and return immediately with a task ID and output path. By default, terminal state is delivered automatically as <background-task-notification> and starts a follow-up agent turn; do not sleep or poll merely to wait. Output is written under the OS temp root and model-visible logs are bounded.`,
     promptSnippet: "Start a named long-running shell command; default terminal notification wakes a follow-up turn, so yield instead of polling",
     promptGuidelines: [
-      "Use bg_run instead of bash for commands expected to run for a long time, such as test suites, dev servers, watchers, or builds.",
+      "Use bg_run instead of bash for commands expected to run in the background (test suites, builds, dev servers, watchers).",
+      "For FINITE tasks (tests, builds, exports, scripts): leave triggerOnCompletion:true and notifyOnCompletion:true (defaults) to automatically wake the agent when finished.",
+      "For PERSISTENT servers/daemons/watchers (e.g. 'npm run dev', vite, live dev servers, background listeners): MUST set triggerOnCompletion:false (and optionally notifyOnCompletion:false) so the agent and sidekick do not wait for the server to exit.",
       "Set isAgent:true only when the background task launches an LLM/agent process; false for scripts, tests, dev servers, sleeps.",
       "Always set name to a concise 2-6 word human-readable label; do not use the raw command as the name.",
-      "bg_run returns immediately. With notifyOnCompletion:true and triggerOnCompletion:true (both defaults), completed, failed, or killed terminal state is delivered as <background-task-notification> and automatically starts a follow-up agent turn.",
-      "After a default bg_run launch, continue only independent useful work that does not merely wait for the task; otherwise briefly acknowledge it if useful, then end the current turn. Do not call sleep, bg_status, or bg_logs merely to wait; the terminal notification will wake you.",
+      "bg_run returns immediately. For finite tasks with default wake-up, continue only independent useful work that does not merely wait for the task; otherwise end the current turn. Do not call sleep, bg_status, or bg_logs merely to wait; the terminal notification will wake you.",
       "A running result is not an instruction to poll again.",
-      "Treat <background-task-notification> as durable terminal truth. Do not call bg_status to reconfirm it.",
-      "Do not set notifyOnCompletion:false or triggerOnCompletion:false unless intentionally opting out."
+      "Treat <background-task-notification> as durable terminal truth. Do not call bg_status to reconfirm it."
     ],
     parameters: BgRunParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -50836,9 +50836,29 @@ function renderSlider(cells, markerIndex) {
 
 // packages/fusion/src/picker.ts
 var DEFAULT_VISIBLE_ROWS = 10;
-var NAME_COL = 24;
+var NAME_COL_MIN = 24;
 var MARKER_COL = 2;
 var BAR_SEGMENTS = 5;
+var FIXED_COLS = 23;
+function ambiguousNamesOf(models) {
+  const providersByName = /* @__PURE__ */ new Map();
+  for (const m of models) {
+    const set = providersByName.get(m.name) ?? /* @__PURE__ */ new Set();
+    set.add(m.provider);
+    providersByName.set(m.name, set);
+  }
+  const out = /* @__PURE__ */ new Set();
+  for (const [name, set] of providersByName) {
+    if (set.size > 1) out.add(name);
+  }
+  return out;
+}
+function needsProvider(m, ambiguous) {
+  return m.name.includes("/") || ambiguous.has(m.name);
+}
+function labelOf(m, ambiguous) {
+  return needsProvider(m, ambiguous) ? `${m.provider} \xB7 ${m.name}` : m.name;
+}
 function printable(data) {
   if (data.length !== 1) return void 0;
   const code = data.charCodeAt(0);
@@ -50867,6 +50887,9 @@ var ModelPicker = class {
   modelsByKey;
   state;
   priceRange;
+  ambiguousNames;
+  /** Name column sized to the widest row label; capped to the available width at render time. */
+  naturalNameCol;
   effort;
   /** Fusion-row efforts — deliberately NOT stored in the per-model map. */
   fusionLeadEffort;
@@ -50885,6 +50908,12 @@ var ModelPicker = class {
     this.onRenderRequest = options.onRenderRequest;
     this.visibleRows = options.visibleRows ?? DEFAULT_VISIBLE_ROWS;
     this.modelsByKey = new Map(options.state.models.map((m) => [m.key, m]));
+    this.ambiguousNames = ambiguousNamesOf(options.state.models);
+    const widestLabel = options.state.models.reduce(
+      (max, m) => Math.max(max, visibleWidth23(labelOf(m, this.ambiguousNames))),
+      0
+    );
+    this.naturalNameCol = Math.max(NAME_COL_MIN, widestLabel + 2);
     const prices = options.state.models.map((m) => hasPricing(m.cost) ? blendedPrice(m.cost) : void 0).filter((p) => p !== void 0 && p > 0);
     this.priceRange = { min: prices.length > 0 ? Math.min(...prices) : 0, max: prices.length > 0 ? Math.max(...prices) : 0 };
     this.effort = { ...options.state.effort };
@@ -51086,15 +51115,21 @@ var ModelPicker = class {
     const m = this.modelsByKey.get(key);
     return shortName(m?.name ?? key, max);
   }
-  renderRow(row, highlighted, width) {
+  isAmbiguous(model) {
+    return needsProvider(model, this.ambiguousNames);
+  }
+  renderRow(row, highlighted, width, nameCol) {
     const t = this.theme;
     const pointer = highlighted ? t.fg("accent", "\u276D") : t.fg("dim", "\xB7");
     const disabledFusion = row.kind === "fusion" && !this.fusionAvailable();
     const marker = row.kind === "fusion" ? !disabledFusion && this.state.active?.kind === "fusion" ? t.fg("success", "\u2713") : " " : this.markerFor(row.key);
     const working = row.kind === "model" && row.key === this.state.currentModelKey;
-    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, NAME_COL - 1);
-    const name = row.kind === "fusion" ? disabledFusion ? highlighted ? t.fg("muted", t.bold(nameRaw)) : t.fg("dim", nameRaw) : highlighted ? t.fg("accent", t.bold(nameRaw)) : t.fg("text", nameRaw) : working ? t.fg("accent", t.bold(nameRaw)) : highlighted ? t.fg("accent", nameRaw) : t.fg("text", nameRaw);
     const model = row.kind === "model" ? this.modelsByKey.get(row.key) : void 0;
+    const providerPrefix = model !== void 0 && this.isAmbiguous(model) ? t.fg("dim", `${model.provider} \xB7 `) : "";
+    const nameBudget = Math.max(1, nameCol - visibleWidth23(providerPrefix) - 1);
+    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, nameBudget);
+    const styled = row.kind === "fusion" ? disabledFusion ? highlighted ? t.fg("muted", t.bold(nameRaw)) : t.fg("dim", nameRaw) : highlighted ? t.fg("accent", t.bold(nameRaw)) : t.fg("text", nameRaw) : working ? t.fg("accent", t.bold(nameRaw)) : highlighted ? t.fg("accent", nameRaw) : t.fg("text", nameRaw);
+    const name = `${providerPrefix}${styled}`;
     const badge = model?.badge;
     const badgeGlyph = badge === void 0 ? "" : ` ${t.fg(badge === "new" ? "success" : badge === "promotion" ? "accent" : "warning", "\u2731")}`;
     const level = row.kind === "fusion" ? this.fusionLeadEffort : this.effortFor(row.key);
@@ -51102,7 +51137,7 @@ var ModelPicker = class {
     const left = arrowsOn ? t.fg("accent", "\u2190") : " ";
     const right = arrowsOn ? t.fg("accent", "\u2192") : " ";
     const label = disabledFusion ? t.fg("dim", effortLabel(level)) : highlighted ? t.fg("accent", effortLabel(level)) : t.fg("muted", effortLabel(level));
-    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, NAME_COL)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
+    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, nameCol)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
     if (row.kind === "fusion") {
       if (disabledFusion) {
         line += `   ${t.fg("dim", "not configured \u2014 run /unipi:fusion-preset")}`;
@@ -51118,10 +51153,10 @@ var ModelPicker = class {
     }
     return truncateToWidth26(line, Math.max(1, width - 1));
   }
-  renderDropdown(width) {
+  renderDropdown(width, nameCol) {
     const t = this.theme;
     const items = this.dropdownItems();
-    const indent = " ".repeat(MARKER_COL + NAME_COL + 5);
+    const indent = " ".repeat(MARKER_COL + nameCol + 5);
     if (items.length === 0) {
       return [`${indent}${t.fg("warning", `no ${this.focus} models in preset \u2014 run /unipi:fusion-preset`)}`];
     }
@@ -51173,7 +51208,17 @@ var ModelPicker = class {
     const noPricing = row.kind === "fusion" ? !hasPricing(primaryCost) || !hasPricing(sideCost) : !hasPricing(primaryCost);
     const pricing = !disabledFusion && noPricing ? t.fg("dim", " \xB7 no pricing data from provider") : "";
     const description = `${badges}${badges.length > 0 ? " " : ""}${desc}${pricing}`;
-    return [truncateToWidth26(`  ${head}`, width - 1), truncateToWidth26(`  ${vals}`, width - 1), truncateToWidth26(`  ${description}`, width - 1)];
+    const keys = row.kind === "fusion" ? [this.lead, this.sidekick].filter((k) => k !== void 0) : primaryKey === void 0 ? [] : [primaryKey];
+    const out = [
+      truncateToWidth26(`  ${head}`, width - 1),
+      truncateToWidth26(`  ${vals}`, width - 1)
+    ];
+    if (keys.length > 0) {
+      const keyText = keys.map((k) => t.fg("text", k)).join(t.fg("dim", " \xB7 "));
+      out.push(truncateToWidth26(`  ${t.fg("dim", "Model key")}  ${keyText}`, width - 1));
+    }
+    out.push(truncateToWidth26(`  ${description}`, width - 1));
+    return out;
   }
   hintLine(row) {
     const t = this.theme;
@@ -51195,6 +51240,8 @@ var ModelPicker = class {
   renderBody(width) {
     const t = this.theme;
     const rows = this.rows();
+    const maxNameCol = Math.max(NAME_COL_MIN, width - FIXED_COLS - 1);
+    const nameCol = Math.min(this.naturalNameCol, maxNameCol);
     if (this.selected >= rows.length) this.selected = Math.max(0, rows.length - 1);
     const row = rows[this.selected];
     const lines = [];
@@ -51212,9 +51259,9 @@ var ModelPicker = class {
         const r = rows[i];
         if (r === void 0) continue;
         const highlighted = i === this.selected;
-        lines.push(this.renderRow(r, highlighted, width));
+        lines.push(this.renderRow(r, highlighted, width, nameCol));
         if (highlighted && r.kind === "fusion" && this.focus !== "effort") {
-          lines.push(...this.renderDropdown(width));
+          lines.push(...this.renderDropdown(width, nameCol));
         }
       }
       if (end < rows.length) lines.push(t.fg("dim", `  \u2193 more below (${String(rows.length - end)})`));

package/packages/updater/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/utility/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/utility",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
   "type": "module",
   "main": "src/index.ts",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "devDependencies": {},
   "peerDependencies": {

package/packages/web-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/web-api",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Web search, read, and summarize tools with provider-based backend selection for Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.20.2",
+    "@pi-unipi/core": "2.20.4",
     "defuddle": "^0.18.1",
     "linkedom": "^0.18.12",
     "wreq-js": "^2.3.0"

package/packages/workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/workflow",
-  "version": "2.20.2",
+  "version": "2.20.4",
   "description": "Structured development workflow commands for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -30,7 +30,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.2"
+    "@pi-unipi/core": "2.20.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",