@pi-unipi/unipi 2.17.2 → 2.18.0

package/packages/fusion/src/tools.ts

@@ -1,7 +1,8 @@
-import { Box, Text } from "@earendil-works/pi-tui";
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Markdown, Text, type Component } from "@earendil-works/pi-tui";
+import { getMarkdownTheme, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
-import type { SidekickRuntime, HandoffReport } from "./sidekick-runtime.js";
+import type { SidekickRuntime, HandoffProgress, HandoffReport } from "./sidekick-runtime.js";
+import { frameSidekick, renderSidekickTranscript, type ThemeLike as TranscriptTheme } from "./transcript.js";
 
 const SidekickParams = Type.Object({
   message: Type.String({ description: "A concrete implementation or verification brief for the sidekick" }),
@@ -16,12 +17,17 @@ const ReadSubagentParams = Type.Object({
 export interface FusionToolDeps {
   getRuntime: (ctx: ExtensionContext) => SidekickRuntime | undefined;
   onReport?: (ctx: ExtensionContext, report: HandoffReport) => void;
+  onHandoffStart?: (ctx: ExtensionContext) => void;
 }
 
 function duration(ms: number): string {
   return `${(ms / 1000).toFixed(1)}s`;
 }
 
+function firstLine(value: string): string {
+  return value.split("\n", 1)[0] ?? "";
+}
+
 function progressText(runtime: SidekickRuntime, id: string): string {
   const progress = runtime.progress(id);
   if (!progress) return "No active handoff progress.";
@@ -33,7 +39,9 @@ function progressText(runtime: SidekickRuntime, id: string): string {
 
 function progressKey(runtime: SidekickRuntime, id: string): string {
   const progress = runtime.progress(id);
-  return progress === undefined ? "" : `${String(progress.toolCalls)}|${progress.recentTools.join("|")}|${progress.textTail}`;
+  if (!progress) return "";
+  const last = progress.events.at(-1);
+  return `${String(progress.toolCalls)}|${progress.recentTools.join("|")}|${progress.textTail}|${String(progress.events.length)}|${last?.kind === "tool" ? `${String(last.output.length)}|${String(last.done)}` : last?.kind === "text" ? `${String(last.text.length)}|${String(last.open)}` : ""}`;
 }
 
 function reportText(report: HandoffReport): string {
@@ -70,7 +78,7 @@ async function waitForReport(
     const key = progressKey(runtime, id);
     if (key !== lastProgressKey) {
       lastProgressKey = key;
-      onUpdate?.({ content: [{ type: "text", text: progress }] });
+      onUpdate?.({ content: [{ type: "text", text: progress }], details: { progress: runtime.progress(id) } });
     }
   }
 }
@@ -90,15 +98,52 @@ type ThemeLike = {
   bold: (text: string) => string;
 };
 
-function renderCompletionCard(theme: ThemeLike, report: HandoffReport | undefined): Box {
-  const tone = report?.status === "completed" ? "toolSuccessBg" : "toolErrorBg";
-  const head = report
-    ? `${theme.fg(report.status === "completed" ? "success" : "error", "◆")} ${theme.fg("accent", theme.bold(`sidekick done · ${report.id}`))} ${theme.fg("dim", `· ${String(report.toolCalls)} tool calls · ${duration(report.durationMs)}`)}`
-    : `${theme.fg("accent", "◆")} ${theme.fg("accent", theme.bold("sidekick done"))}`;
-  const lines = [head, ...(report?.text.split("\n").slice(0, 6).map((line) => theme.fg("dim", line)) ?? [])];
-  const box = new Box(1, 0, (text) => theme.bg(tone, text));
-  box.addChild(new Text(lines.join("\n"), 0, 0));
-  return box;
+function transcriptTheme(theme: ThemeLike): TranscriptTheme {
+  return { fg: (color, text) => theme.fg(color, text), bold: (text) => theme.bold(text) };
+}
+
+function markdownText(markdown: string): Markdown {
+  return new Markdown(markdown, 0, 0, getMarkdownTheme());
+}
+
+function contentText(content: unknown): string {
+  if (!Array.isArray(content)) return String(content ?? "");
+  return content.map((part) => typeof part === "object" && part !== null && typeof (part as { text?: unknown }).text === "string" ? (part as { text: string }).text : "").filter(Boolean).join("\n");
+}
+
+function renderToolTranscript(result: { content?: unknown; details?: unknown; isError?: boolean }, options: { expanded?: boolean }, theme: ThemeLike, label: "sidekick" | "read_subagent"): Component {
+  const details = result.details as (HandoffReport & { progress?: HandoffProgress }) | { progress?: HandoffProgress } | undefined;
+  const progress = details?.progress;
+  const report = progress ? undefined : details as HandoffReport | undefined;
+  const events = progress?.events ?? report?.events;
+  const partial = progress !== undefined;
+  const status = partial ? "working" : report?.status === "completed" && !result.isError ? "completed" : "error";
+  if (!events) return frameSidekick(theme, status, new Text(contentText(result.content), 0, 0));
+  const header = partial
+    ? `${theme.fg("accent", theme.bold(`◆ ${label} working`))} ${theme.fg("dim", `· ${String(progress.toolCalls)} tool calls · ${duration(Date.now() - progress.startedAt)}`)}`
+    : `${theme.fg(report?.status === "completed" ? "success" : "error", "◆")} ${theme.fg("accent", theme.bold(`${label} ${report?.status ?? "done"}`))} ${theme.fg("dim", report ? `· ${report.id} · ${String(report.toolCalls)} tool calls · ${duration(report.durationMs)} · in ${String(report.usage.input)} / out ${String(report.usage.output)} tokens` : "")}`;
+  return frameSidekick(theme, status, renderSidekickTranscript(transcriptTheme(theme), {
+    events,
+    droppedEvents: progress?.droppedEvents,
+    header,
+    expanded: options.expanded === true,
+    isPartial: partial,
+    report,
+    renderText: markdownText,
+  }));
+}
+
+function renderCompletionCard(theme: ThemeLike, report: HandoffReport | undefined): Component {
+  const status = report?.status === "completed" ? "completed" : "error";
+  if (!report) return frameSidekick(theme, "error", new Text(`${theme.fg("accent", "◆")} ${theme.fg("accent", theme.bold("sidekick done"))}`, 0, 0));
+  return frameSidekick(theme, status, renderSidekickTranscript(transcriptTheme(theme), {
+    events: report.events ?? [],
+    header: `${theme.fg(report.status === "completed" ? "success" : "error", "◆")} ${theme.fg("accent", theme.bold(`sidekick ${report.status}`))} ${theme.fg("dim", `· ${report.id} · ${String(report.toolCalls)} tool calls · ${duration(report.durationMs)}`)}`,
+    expanded: false,
+    isPartial: false,
+    report,
+    renderText: markdownText,
+  }));
 }
 
 export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): void {
@@ -109,10 +154,15 @@ export function registerFusionTools(pi: ExtensionAPI, deps: FusionToolDeps): voi
     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) => frameSidekick(theme as unknown as ThemeLike, "working", 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) {
       const runtime = deps.getRuntime(ctx);
       if (!runtime) return result("Fusion is not active — pick a Fusion pair with /unipi:model.", undefined, true);
+      const wasBusy = runtime.isBusy();
       const handoff = runtime.handoff(params.message);
+      if (!wasBusy) deps.onHandoffStart?.(ctx);
       if (params.block === false) {
         void handoff.done.then((report) => {
           deps.onReport?.(ctx, report);
@@ -136,6 +186,9 @@ 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) => frameSidekick(theme as unknown as ThemeLike, "working", new Text(`${theme.fg("toolTitle", theme.bold("◆ read_subagent"))} ${theme.fg("dim", args.agent_id ?? "latest")}`, 0, 0)),
+    renderResult: (result, options, theme) => renderToolTranscript(result, options, theme as unknown as ThemeLike, "read_subagent"),
     async execute(_toolCallId, params, signal, onUpdate, ctx) {
       const runtime = deps.getRuntime(ctx);
       if (!runtime) return result("Fusion is not active — pick a Fusion pair with /unipi:model.", undefined, true);

package/packages/fusion/src/transcript.ts

@@ -0,0 +1,108 @@
+import { Box, Container, Text, type Component } from "@earendil-works/pi-tui";
+import type { SidekickEvent } from "./sidekick-runtime.js";
+
+export interface ThemeLike {
+  fg: (color: string, text: string) => string;
+  bold: (text: string) => string;
+}
+
+export class RailComponent implements Component {
+  constructor(private readonly inner: Component, private readonly rail: string) {}
+
+  render(width: number): string[] {
+    return this.inner.render(Math.max(1, width - 2)).map((line) => `${this.rail} ${line}`);
+  }
+
+  invalidate(): void {
+    this.inner.invalidate?.();
+  }
+
+  handleInput(data: string): void {
+    this.inner.handleInput?.(data);
+  }
+}
+
+export function frameSidekick(theme: ThemeLike & { bg: (color: string, text: string) => string }, status: "working" | "completed" | "error", content: Component): Component {
+  const railColor = status === "working" ? "accent" : status === "completed" ? "success" : "error";
+  const rail = theme.fg(railColor, "▍");
+  const boxed = new Box(1, 0, (text) => theme.bg("customMessageBg", text));
+  boxed.addChild(new RailComponent(content, rail));
+  return boxed;
+}
+
+export interface TranscriptOptions {
+  events: readonly SidekickEvent[];
+  droppedEvents?: number;
+  header: string;
+  expanded: boolean;
+  isPartial: boolean;
+  report?: { text: string };
+  renderText: (markdown: string) => Component;
+}
+
+function firstLine(value: string): string {
+  return value.split("\n", 1)[0] ?? "";
+}
+
+function truncate(value: string, max: number): string {
+  return value.length > max ? `${value.slice(0, Math.max(0, max - 1))}…` : value;
+}
+
+export function primaryArg(name: string, args: Record<string, unknown> | undefined): string {
+  if (!args) return "";
+  const value = name === "bash"
+    ? args.command
+    : name === "read" || name === "edit" || name === "write"
+      ? args.path ?? args.file_path ?? args.filePath
+      : name === "sidekick"
+        ? args.message
+        : Object.values(args).find((entry) => typeof entry === "string");
+  return typeof value === "string" ? truncate(firstLine(value), 100) : "";
+}
+
+function toolComponent(theme: ThemeLike, event: Extract<SidekickEvent, { kind: "tool" }>, expanded: boolean): Text {
+  const title = `${event.isError ? theme.fg("error", "✗ ") : ""}${theme.fg("toolTitle", theme.bold(event.name))}`;
+  const argument = primaryArg(event.name, event.args);
+  const lines = [`${title}${argument.length > 0 ? ` ${theme.fg("accent", argument)}` : ""}`];
+  if (!event.done) {
+    lines[0] += theme.fg("warning", " ⋯ running");
+  } else if (event.output.length > 0) {
+    const output = event.output.split("\n");
+    const visible = expanded ? output.slice(-40) : output.slice(-3);
+    lines.push(...visible.map((line) => theme.fg("toolOutput", truncate(line, 160))));
+  }
+  return new Text(lines.join("\n"), 0, 0);
+}
+
+export function renderSidekickTranscript(theme: ThemeLike, opts: TranscriptOptions): Component {
+  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);
+  if (opts.expanded && dropped > 0) {
+    box.addChild(new Text(theme.fg("dim", `… ${String(dropped)} earliest steps dropped`), 0, 0));
+  } else if (start > 0) {
+    box.addChild(new Text(theme.fg("dim", `… ${String(start + dropped)} earlier steps`), 0, 0));
+  }
+
+  for (const event of opts.events.slice(start)) {
+    if (event.kind === "tool") box.addChild(toolComponent(theme, event, opts.expanded));
+    else if (event.text.trim()) box.addChild(opts.renderText(event.text.trim()));
+  }
+
+  if (!opts.isPartial && opts.expanded && 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));
+  }
+  return box;
+}

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0",
-    "@pi-unipi/info-screen": "2.17.0",
+    "@pi-unipi/core": "2.18.0",
+    "@pi-unipi/info-screen": "2.18.0",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.17.0",
+  "version": "2.18.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.17.0"
+    "@pi-unipi/core": "2.18.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.17.0",
+  "version": "2.18.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.17.0",
+    "@pi-unipi/core": "2.18.0",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/ralph/package.json

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

package/packages/subagents/package.json

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