@pi-unipi/unipi 3.0.0-alpha.18 → 3.0.0-alpha.19

package/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.19] — 2026-10-01
+
+### Added
+- `subagents`: completed subagent steps stream into the lead transcript as delegated panels — a live `subagent-step` entry per step (foreground and background runs) renders in the shared UNI-2 rail style alongside the existing status card, grouped per subagent.
+
+### Changed
+- render: the delegated-work panel (bright cyan `▏` rail on a single dark-cyan fill) moved into a shared `utility` helper used by both fusion sidekick steps and subagent steps; sidekick panels are grouped per handoff so a resumed handoff renders as its own panel instead of merging into the previous run.
+
+### Fixed
+- render: panel continuity survives pi's `CustomEntryComponent` host wrapper — group metadata is resolved through the wrapper and re-resolved every render, and nested card backgrounds are stripped instead of stacking inside the cyan fill.
+- render: fixed the alpha.18 OOM in the simple style — the final result baked the `· Ns` runtime suffix into the tool meta, re-arming the invalidate loop on every re-render (unbounded heap growth and eventual SIGABRT); the duration is pinned once and appended at paint.
+
 ## [3.0.0-alpha.18] — 2026-10-01
 
 ### Added

package/package.json

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

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.18",
+    "@pi-unipi/core": "3.0.0-alpha.19",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18",
-    "@pi-unipi/info-screen": "3.0.0-alpha.18",
+    "@pi-unipi/core": "3.0.0-alpha.19",
+    "@pi-unipi/info-screen": "3.0.0-alpha.19",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/fusion/package.json

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

package/packages/fusion/src/index.ts

@@ -320,7 +320,11 @@ export default function fusionExtension(pi: ExtensionAPI): void {
         onProgress: () => publishStatusLater(),
         onStep: (step) => {
           try {
-            pi.appendEntry("sidekick-step", step as unknown as Record<string, unknown>);
+            // Group per handoff so resumed handoffs render as separate panels
+            // even with no lead turn between them; old entries without a
+            // group fall back to the shared "sidekick" run.
+            const handoffId = runtime?.latest()?.id;
+            pi.appendEntry("sidekick-step", { ...step, group: `sidekick:${handoffId ?? "default"}`, label: "Sidekick" });
           } catch {
             /* entry rendering never affects the handoff */
           }
@@ -350,8 +354,13 @@ export default function fusionExtension(pi: ExtensionAPI): void {
     return `Sidekick tokens: in ${String(runtime.usage.input)} · out ${String(runtime.usage.output)} · cached ${String(runtime.usage.cacheRead)} · cache write ${String(runtime.usage.cacheWrite)}\nSidekick cost: $${savings.sidekickUsd.toFixed(2)} · at lead prices: $${savings.atLeadUsd.toFixed(2)} · saved: $${savings.savedUsd.toFixed(2)}\nHandoffs: ${String(runtime.reports.size)} · runtime alive: ${String(runtime.isAlive())} · busy: ${String(runtime.isBusy())}${pricing}`;
   }
 
-  pi.registerEntryRenderer("sidekick-step", (entry: { data?: unknown }, options: { expanded?: boolean }, theme) =>
-    renderSidekickStep(entry.data as never, options.expanded === true, theme as never));
+  pi.registerEntryRenderer("sidekick-step", (entry: { data?: { group?: string; label?: string } }, options: { expanded?: boolean }, theme) =>
+    renderSidekickStep(
+      entry.data as never,
+      options.expanded === true,
+      theme as never,
+      { group: entry.data?.group ?? "sidekick", label: entry.data?.label },
+    ));
 
   registerFusionTools(pi, {
     getRuntime,

package/packages/fusion/src/transcript.ts

@@ -1,20 +1,15 @@
 import { Markdown, type Component } from "@earendil-works/pi-tui";
 import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
-import {
-  nativeToolComponent,
-  renderStyle,
-  styledComponent,
-  styledTextLines,
-  styledToolCallLines,
-} from "@pi-unipi/utility/src/render/styled.js";
-import { paintLine, replyBg, trimEdgeBlankLines } from "@pi-unipi/utility/src/render/reply-bg.js";
-import type { SpacingGroupPosition } from "@pi-unipi/utility/src/render/spacing.js";
+import { renderDelegatedStep, type DelegatedStep } from "@pi-unipi/utility/src/render/delegated.js";
 import type { SidekickStep } from "./sidekick-runtime.js";
 
 export interface ThemeLike {
   fg: (color: string, text: string) => string;
   bold: (text: string) => string;
   getBgAnsi?: (key: string) => string;
+  /** Colour mode when the caller knows it — the delegated panel uses it for
+   *  its truecolor/256 rail+fill+fg fallbacks. */
+  getColorMode?: () => "truecolor" | "256color";
 }
 
 export function duration(ms: number): string {
@@ -47,85 +42,24 @@ export function primaryArg(name: string, args: Record<string, unknown> | undefin
 
 // ─── sidekick-step entry renderer (Devin-style merged steps) ────────────────
 
-/** The sidekick rail: muted left border on the custom-message background —
- *  the tinted panel Devin draws around delegated work. */
-const RAIL = "▏ ";
-
-function railBg(theme: ThemeLike): string {
-  try {
-    return theme.getBgAnsi?.("customMessageBg") || replyBg();
-  } catch {
-    return replyBg();
-  }
+export interface StepIdentity {
+  /** spacingGroup run — unique per handoff so resumed handoffs don't merge. */
+  group?: string;
+  /** Panel header drawn once on the group's first position (e.g. "Sidekick"). */
+  label?: string;
 }
 
 /**
- * One sidekick step in the lead chat, drawn in the active render style
- * (simple mcode row / advanced header+gutter / regular pi card) behind a
- * `▏` border on the custom-message background — every line of the step sits
- * on the rail so a sidekick block reads as one tinted unit.
- *
- * Steps carry `spacingGroup: "sidekick"`: adjacent steps in the transcript
- * join into one rail block with no blank separator, and the spacing patch
- * reports each member's position so a consecutive run of tool steps draws
- * the same `├…├…└` tree the lead's tools get (last member or a step
- * followed by prose gets `└`).
+ * One sidekick step in the lead chat, drawn by the shared delegated-panel
+ * helper: the active render style behind the approved cyan `▏` rail on a
+ * single dark-cyan fill. Steps carry `spacingGroup` so adjacent steps of the
+ * same handoff join into one continuous panel (`├…└` tree, no blank
+ * separators); the optional identity comes from the persisted entry (older
+ * entries without one fall back to the shared "sidekick" group).
  */
-export function renderSidekickStep(step: SidekickStep, expanded: boolean, theme: ThemeLike): Component {
-  const t = theme;
-  let pos: SpacingGroupPosition | undefined;
-  let native: (Component & { setExpanded?: (b: boolean) => void }) | null | undefined;
-  const comp = styledComponent((width: number) => {
-    const inner = Math.max(8, width - 2);
-    const style = renderStyle();
-    let lines: string[];
-    if (step.kind === "text") {
-      lines = styledTextLines(style, step.text, { thinking: expanded ? step.thinking : undefined }, t, inner);
-    } else if (style === "regular") {
-      if (native === undefined) {
-        native = nativeToolComponent({
-          name: step.name,
-          args: step.args,
-          output: step.output,
-          isError: step.isError,
-          expanded,
-        }) ?? null;
-      }
-      if (native !== null) {
-        native.setExpanded?.(expanded);
-        lines = trimEdgeBlankLines(native.render(inner));
-      } else {
-        lines = styledToolCallLines("regular", {
-          name: step.name,
-          arg: step.arg,
-          output: step.output,
-          isError: step.isError,
-          expanded,
-          durationMs: step.durationMs,
-        }, t, inner);
-      }
-    } else {
-      lines = styledToolCallLines(style, {
-        name: step.name,
-        arg: step.arg,
-        output: step.output,
-        isError: step.isError,
-        expanded,
-        durationMs: step.durationMs,
-        connector: pos !== undefined && pos.nextKind === "tool" ? "├" : "└",
-      }, t, inner);
-    }
-    const bg = railBg(t);
-    return lines.map((l) => paintLine(`${t.fg("borderMuted", RAIL)}${l}`, width, bg));
-  }) as Component & {
-    spacingGroup: string;
-    spacingKind: string;
-    setGroupPosition: (p: SpacingGroupPosition) => void;
-  };
-  comp.spacingGroup = "sidekick";
-  comp.spacingKind = step.kind === "tool" ? "tool" : "text";
-  comp.setGroupPosition = (p) => {
-    pos = p;
-  };
-  return comp;
+export function renderSidekickStep(step: SidekickStep, expanded: boolean, theme: ThemeLike, identity?: StepIdentity): Component {
+  return renderDelegatedStep(step as DelegatedStep, expanded, theme as never, {
+    group: identity?.group ?? "sidekick",
+    label: identity?.label,
+  });
 }

package/packages/info-screen/package.json

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

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.18",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.18",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.18",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.18",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.18"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.19"
   }
 }

package/packages/long-horizon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/long-horizon",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Long-horizon execution for Pi — mode-gated /goal /ralph /swarm /graph orchestration with a TypeSafe prompt judge",
   "type": "module",
   "main": "index.ts",
@@ -37,7 +37,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "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": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Persistent cross-session memory on MemPalace (auto-installed): daemon-routed writes, shared palace with other agents, for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -42,8 +42,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18",
-    "@pi-unipi/info-screen": "3.0.0-alpha.18",
+    "@pi-unipi/core": "3.0.0-alpha.19",
+    "@pi-unipi/info-screen": "3.0.0-alpha.19",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/notify/package.json

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

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/skill-registry",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Skill registry for pi — per-project skill on/off, a skill vault, and jev-judged skill exposure",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
   },
   "main": "index.ts",
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "description": "Subagents for UniPi — Devin-model independent child agents",
   "type": "module",
   "main": "src/index.ts",
@@ -9,7 +9,8 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.18",
+    "@pi-unipi/core": "3.0.0-alpha.19",
+    "@pi-unipi/utility": "3.0.0-alpha.19",
     "@earendil-works/pi-agent-core": "^0.87.1",
     "acorn": "8.18.0"
   },

package/packages/subagents/src/index.ts

@@ -16,12 +16,13 @@
 import { type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { Key, matchesKey, truncateToWidth, type TUI } from "@earendil-works/pi-tui";
+import { renderDelegatedStep, type DelegatedStep } from "@pi-unipi/utility/src/render/delegated.js";
 import {
   UNIPI_EVENTS, emitEvent, getSettings, isChildProcess, registerSettings, registerWaitSource, getSharedFusionStatus, SPINNER_MS,
 } from "@pi-unipi/core";
 import {
   ensureReadSubagentTool, registerSubagentReader, setReadSubagentDemand,
-  createCompletionDelivery, type HandoffReport,
+  createCompletionDelivery, type HandoffReport, type SidekickStep,
 } from "@pi-unipi/core/child-agent.js";
 import {
   SubagentManager, backgroundRunningReason, canSpawn, getSharedSubagents, subscribeSubagents, recordStatusFor,
@@ -146,8 +147,33 @@ export function resolveSubagentThinking(
 
 export { cardOutcome };
 
-export default function subagents(pi: ExtensionAPI): void {
-  const manager = new SubagentManager();
+/**
+ * UI-only completed-step entry: payload + guarded append, identical for
+ * foreground and background runs. The final report is intentionally never
+ * streamed here — the lead reports it itself. Exported for tests.
+ */
+export function appendSubagentStep(
+  appendEntry: (type: string, data: Record<string, unknown>) => void,
+  record: Pick<SubagentRecord, "id" | "title" | "profile" | "startedAt">,
+  step: SidekickStep,
+): void {
+  try {
+    appendEntry("subagent-step", {
+      ...step,
+      agentId: record.id,
+      id: record.id,
+      title: record.title,
+      profile: record.profile,
+      group: `subagent:${record.id}:${record.startedAt}`,
+      label: `${profileLabel(record.profile)} subagent · ${record.title}`,
+    });
+  } catch {
+    /* entry rendering never affects the run */
+  }
+}
+
+export default function subagents(pi: ExtensionAPI, deps?: { manager?: SubagentManager }): void {
+  const manager = deps?.manager ?? new SubagentManager();
   const delivery = createCompletionDelivery<HandoffReport>((report) => deliverCompletion(report));
 
   // Turn-arbiter wait source (lead only): a background subagent is still
@@ -462,7 +488,6 @@ export default function subagents(pi: ExtensionAPI): void {
       syncUi();
     }
   }
-
   async function runSubagent(
     _toolCallId: string,
     params: { title: string; task: string; profile: string; is_background?: boolean; resume?: string },
@@ -489,6 +514,7 @@ export default function subagents(pi: ExtensionAPI): void {
       background: resumeId === undefined && params.is_background === true,
       resume: resumeId,
       maxConcurrent: config.maxConcurrent,
+      onStep: (record, step) => appendSubagentStep((type, data) => pi.appendEntry(type, data), record, step),
     });
     if ("error" in start) return textResult(start.error, { owner: "subagents", status: "failed", title: params.title, error: start.error }, true);
     const { run } = start;
@@ -578,6 +604,16 @@ export default function subagents(pi: ExtensionAPI): void {
   pi.registerMessageRenderer("subagent-completion", (message: { details?: CardDetails & { report?: string } }, opts: { expanded?: boolean }, theme) =>
     renderCompletion(message.details, opts.expanded === true, theme));
 
+  // Completed subagent steps as a delegated panel (shared UNI-2 renderer;
+  // historical entries keep their cards, new ones stream below them).
+  pi.registerEntryRenderer("subagent-step", (entry: { data?: DelegatedStep & { group?: string; label?: string } }, opts: { expanded?: boolean }, theme) =>
+    renderDelegatedStep(
+      entry.data as DelegatedStep,
+      opts.expanded === true,
+      theme as never,
+      { group: entry.data?.group ?? "subagent", label: entry.data?.label },
+    ));
+
   // ── Prompt section (only while enabled) ───────────────────────────────────
   pi.on("before_agent_start", (event, ctx) => {
     refresh(ctx.cwd ?? process.cwd(), ctx);