@pi-unipi/unipi 2.19.2 → 2.20.0

package/packages/fusion/src/tools.ts

@@ -2,7 +2,7 @@ import { Text, type Component } from "@earendil-works/pi-tui";
 import { type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import type { SidekickRuntime, HandoffProgress, HandoffReport } from "./sidekick-runtime.js";
-import { duration, markdownText, renderSidekickTranscript, sidekickWorkingHeader } from "./transcript.js";
+import { duration, frameSidekick, markdownText, renderSidekickTranscript, sidekickWorkingHeader } from "./transcript.js";
 
 const SidekickParams = Type.Object({
   message: Type.String({ description: "A concrete implementation or verification brief for the sidekick" }),
@@ -22,6 +22,46 @@ export interface FusionToolDeps {
   onDetach?: (ctx: ExtensionContext) => void;
 }
 
+/**
+ * Exactly-once completion delivery for handoffs nobody is waiting on.
+ *
+ * `attach`/`detach` bracket every waiting period. The completion is sent only
+ * if the report lands (or has already landed) while no waiter is attached, and
+ * only once per handoff id.
+ */
+export function createCompletionDelivery(send: (report: HandoffReport) => void): {
+  attach(id: string): void;
+  detach(id: string, done: Promise<HandoffReport>): void;
+  consume(id: string): void;
+} {
+  const waiting = new Set<string>();
+  const armed = new Set<string>();
+  const delivered = new Set<string>();
+
+  return {
+    attach(id) {
+      waiting.add(id);
+    },
+    detach(id, done) {
+      waiting.delete(id);
+      // One continuation per handoff, however many times a waiter gives up.
+      if (armed.has(id)) return;
+      armed.add(id);
+      void done
+        .then((report) => {
+          if (waiting.has(id) || delivered.has(id)) return;
+          delivered.add(id);
+          send(report);
+        })
+        .catch(() => undefined);
+    },
+    consume(id) {
+      waiting.delete(id);
+      delivered.add(id);
+    },
+  };
+}
+
 function firstLine(value: string): string {
   return value.split("\n", 1)[0] ?? "";
 }
@@ -101,6 +141,21 @@ type ThemeLike = {
   bold: (text: string) => string;
 };
 
+type FramedTheme = ThemeLike & { bg: (color: string, text: string) => string };
+
+function transcriptStatus(partial: boolean, report: HandoffReport | undefined): "working" | "completed" | "error" {
+  if (partial) return "working";
+  return report?.status === "completed" ? "completed" : "error";
+}
+
+/**
+ * Sidekick output on the main surface: the same markdown/tool format the lead
+ * uses, marked as sidekick-origin by the existing `▍` rail.
+ */
+function frameTranscript(theme: ThemeLike, status: "working" | "completed" | "error", content: Component): Component {
+  return frameSidekick(theme as FramedTheme, status, content);
+}
+
 // Model-facing result text carries handoff ids and protocol instructions the
 // lead needs; none of it may reach the terminal. Anything rendered as plain
 // content goes through this first.
@@ -147,7 +202,7 @@ function renderToolTranscript(result: { content?: unknown; details?: unknown; is
   const partial = progress !== undefined;
   if (!events) return new Text(displayText(contentText(result.content)), 0, 0);
   const header = partial ? sidekickWorkingHeader(theme, progress, label) : reportHeader(theme, label, report);
-  return renderSidekickTranscript(theme, {
+  return frameTranscript(theme, transcriptStatus(partial, report), renderSidekickTranscript(theme, {
     events,
     droppedEvents: progress?.droppedEvents,
     header,
@@ -155,30 +210,34 @@ function renderToolTranscript(result: { content?: unknown; details?: unknown; is
     isPartial: partial,
     report,
     renderText: markdownText,
-  });
+  }));
 }
 
 function renderCompletionCard(theme: ThemeLike, report: HandoffReport | undefined): Component {
   if (!report) return new Text(`${theme.fg("accent", "◆")} ${theme.fg("accent", theme.bold("sidekick done"))}`, 0, 0);
-  return renderSidekickTranscript(theme, {
+  return frameTranscript(theme, transcriptStatus(false, report), renderSidekickTranscript(theme, {
     events: report.events ?? [],
     header: reportHeader(theme, "sidekick", report),
     expanded: false,
     isPartial: false,
     report,
     renderText: markdownText,
-  });
+  }));
 }
 
 export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): void {
   pi.registerMessageRenderer("sidekick-completion", (message: { details?: HandoffReport }, _options, theme) => renderCompletionCard(theme as unknown as ThemeLike, message.details));
 
+  // One delivery mechanism for every handoff nobody is waiting on.
+  const completion = createCompletionDelivery((report) => {
+    pi.sendMessage(completionMessage(report) as never, { deliverAs: "followUp", triggerTurn: true } as never);
+  });
+
   pi.registerTool({
     name: "sidekick",
     label: "Sidekick",
     description: "Hand off work to your persistent sidekick subagent (one per session; context and shells persist across handoffs; runs on the same machine). block:true (default) waits and returns the report. block:false returns immediately and the report arrives later as a <subagent_completion_notification>. Calling again while a handoff is running injects the message as an interrupt rather than starting a second sidekick.",
     parameters: SidekickParams,
-    renderShell: "self",
     renderCall: (args, theme) => new Text(`${theme.fg("toolTitle", theme.bold("◆ sidekick"))} ${theme.fg("dim", firstLine(String(args.message)).slice(0, 100))}`, 0, 0),
     renderResult: (result, options, theme) => renderToolTranscript(result, options, theme as unknown as ThemeLike, "sidekick"),
     async execute(_toolCallId, params, signal, onUpdate, ctx) {
@@ -188,19 +247,20 @@ export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): voi
       const handoff = runtime.handoff(params.message);
       if (!wasBusy) deps.onHandoffStart?.(ctx);
       if (params.block === false) {
-        void handoff.done.then((report) => {
-          deps.onReport?.(ctx, report);
-          pi.sendMessage(completionMessage(report) as never, { deliverAs: "followUp", triggerTurn: true } as never);
-        }).catch(() => undefined);
+        void handoff.done.then((report) => deps.onReport?.(ctx, report)).catch(() => undefined);
+        completion.detach(handoff.id, handoff.done);
         deps.onDetach?.(ctx);
         return result(`Handoff ${handoff.id} started in the background. You will receive a <subagent_completion_notification agent_id="${handoff.id}"> when it finishes; use read_subagent to wait.`, { background: true, id: handoff.id });
       }
       deps.onAttach?.(ctx);
+      completion.attach(handoff.id);
       const waited = await waitForReport(runtime, handoff.id, handoff.done, signal, ctx, onUpdate ? (update) => onUpdate(update as never) : undefined);
       if (waited.report) {
+        completion.consume(handoff.id);
         deps.onReport?.(ctx, waited.report);
         return result(reportText(waited.report), waited.report, waited.report.status !== "completed");
       }
+      completion.detach(handoff.id, handoff.done);
       deps.onDetach?.(ctx);
       if (waited.error) return result(`Handoff ${handoff.id} failed: ${waited.error}`, undefined, true);
       if (waited.aborted) return result(`${progressText(runtime, handoff.id)}\nHandoff ${handoff.id} aborted.`, undefined, true);
@@ -214,7 +274,6 @@ export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): voi
     label: "Read Sidekick",
     description: "Read a sidekick handoff report by agent_id (omit for the latest). block:true waits for completion (default timeout 2700s when omitted); block:false returns the current progress snapshot immediately.",
     parameters: ReadSubagentParams,
-    renderShell: "self",
     renderCall: (args, theme) => new Text(`${theme.fg("toolTitle", theme.bold("◆ read_subagent"))} ${theme.fg("dim", args.block === false ? "· snapshot" : "· waiting")}`, 0, 0),
     renderResult: (result, options, theme) => renderToolTranscript(result, options, theme as unknown as ThemeLike, "read_subagent"),
     async execute(_toolCallId, params, signal, onUpdate, ctx) {
@@ -224,16 +283,22 @@ export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): voi
       if (!latest) return result("No sidekick handoff has run yet.", undefined, true);
       const id = params.agent_id ?? latest.id;
       const selected = runtime.reports.get(id);
-      if (selected) return result(reportText(selected), selected, selected.status !== "completed");
+      if (selected) {
+        completion.consume(id);
+        return result(reportText(selected), selected, selected.status !== "completed");
+      }
       if (id !== latest.id) return result(`No sidekick handoff found for ${id}.`, undefined, true);
       if (params.block !== true) return result(`Handoff ${id} is still running.\n${progressText(runtime, id)}`, { progress: runtime.progress(id), id });
       deps.onAttach?.(ctx);
+      completion.attach(id);
       const timeoutMs = (params.timeout ?? 2700) * 1000;
       const waited = await waitForReport(runtime, id, latest.done, signal, ctx, onUpdate ? (update) => onUpdate(update as never) : undefined, timeoutMs);
       if (waited.report) {
+        completion.consume(id);
         deps.onReport?.(ctx, waited.report);
         return result(reportText(waited.report), waited.report, waited.report.status !== "completed");
       }
+      completion.detach(id, latest.done);
       deps.onDetach?.(ctx);
       if (waited.error) return result(`Handoff ${id} failed: ${waited.error}`, undefined, true);
       if (waited.aborted) return result(`Handoff ${id} aborted.`, undefined, true);

package/packages/fusion/src/transcript.ts

@@ -53,6 +53,13 @@ export interface TranscriptOptions {
   renderText: (markdown: string) => Component;
 }
 
+/**
+ * Non-expanded transcripts show this many most recent events. Windowing is the
+ * only cap: a completed handoff renders its events, it is never collapsed into
+ * a "N steps" stub.
+ */
+export const TRANSCRIPT_WINDOW = 8;
+
 function firstLine(value: string): string {
   return value.split("\n", 1)[0] ?? "";
 }
@@ -91,14 +98,8 @@ export function renderSidekickTranscript(theme: ThemeLike, opts: TranscriptOptio
   const box = new Container();
   box.addChild(new Text(opts.header, 0, 0));
 
-  if (!opts.isPartial && !opts.expanded) {
-    if (opts.report?.text) box.addChild(opts.renderText(opts.report.text));
-    box.addChild(new Text(theme.fg("dim", `${String(opts.events.length)} steps · expand to see the transcript`), 0, 0));
-    return box;
-  }
-
   const dropped = opts.droppedEvents ?? 0;
-  const start = opts.expanded ? 0 : Math.max(0, opts.events.length - 8);
+  const start = opts.expanded ? 0 : Math.max(0, opts.events.length - TRANSCRIPT_WINDOW);
   if (opts.expanded && dropped > 0) {
     box.addChild(new Text(theme.fg("dim", `… ${String(dropped)} earliest steps dropped`), 0, 0));
   } else if (start > 0) {
@@ -110,12 +111,13 @@ export function renderSidekickTranscript(theme: ThemeLike, opts: TranscriptOptio
     else if (event.text.trim()) box.addChild(opts.renderText(event.text.trim()));
   }
 
-  if (!opts.isPartial && opts.expanded && opts.report?.text) {
+  if (!opts.isPartial && opts.report?.text) {
     // The final assistant message usually IS the report; don't print it twice.
     const last = opts.events.at(-1);
-    if (last?.kind === "text" && last.text.trim() === opts.report.text.trim()) return box;
-    box.addChild(new Text(theme.fg("dim", "── report ──"), 0, 0));
-    box.addChild(opts.renderText(opts.report.text));
+    if (!(last?.kind === "text" && last.text.trim() === opts.report.text.trim())) {
+      box.addChild(new Text(theme.fg("dim", "── report ──"), 0, 0));
+      box.addChild(opts.renderText(opts.report.text));
+    }
   }
   return box;
 }

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "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.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "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.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2",
-    "@pi-unipi/info-screen": "2.19.2",
+    "@pi-unipi/core": "2.20.0",
+    "@pi-unipi/info-screen": "2.20.0",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2"
+    "@pi-unipi/core": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2",
+    "@pi-unipi/core": "2.20.0",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2",
-    "@pi-unipi/info-screen": "2.19.2"
+    "@pi-unipi/core": "2.20.0",
+    "@pi-unipi/info-screen": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "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.19.2",
+    "@pi-unipi/core": "2.20.0",
     "@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.19.2",
+  "version": "2.20.0",
   "description": "Live UniPi trajectory inspector for Pi sessions",
   "type": "module",
   "main": "index.ts",