@ferris1225/pi-subagents 0.22.0 → 0.24.0

package/README.md

@@ -459,25 +459,17 @@ The package has no runtime dependencies beyond pi peer dependencies.
 ## Acknowledgments
 
 - The official [pi subagent example](https://github.com/earendil-works/pi)
-  (`examples/extensions/subagent`) — this extension's child-process dispatch and
-  event-stream handling are adapted from it.
-- [nicobailon/pi-subagents](https://github.com/nicobailon/pi-subagents) — the most
-  widely used pi sub-agent extension; its async delegation model and result
-  truncation/artifact handling directly informed this project.
-- [tintinweb/pi-subagents](https://github.com/tintinweb/pi-subagents) — Claude Code-
-  style sub-agents for pi with parallel execution and a live widget; this project's
-  widget and parallel fan-out follow the same ideas.
-- [amosblomqvist/pi-subagents](https://github.com/amosblomqvist/pi-subagents) — a
-  clean, minimal reference for markdown-defined agents in pi.
-- [edxeth/pi-subagents](https://github.com/edxeth/pi-subagents) — multi-agent
-  coordination patterns (background agents, child-to-parent messaging) that are
-  worth borrowing from.
+  (`examples/extensions/subagent`) — the child-process dispatch and
+  event-stream handling build on it.
+- [tintinweb/pi-subagents](https://github.com/tintinweb/pi-subagents) — the
+  live widget (two lines per run: header + quiet gray activity row) and
+  parallel fan-out follow its design.
 - The sub-agent pattern itself, popularized by
   [Claude Code](https://github.com/anthropics/claude-code): role-specialized
   agents that receive self-contained briefs.
 
-The agent prompts and extension code are written independently for this project;
-the projects above served as design references.
+The agent prompts and extension code are written independently for this
+project; the projects above served as design references.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferris1225/pi-subagents",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Focused sub-agent delegation for pi: explore / worker / reviewer agents in isolated context, with proactive dispatch injection and per-agent model selection.",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -13,7 +13,7 @@
  */
 
 import { getAgentDir, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Text } from "@earendil-works/pi-tui";
+import { Text, truncateToWidth } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import { discoverAgents, type AgentConfig } from "./agents.ts";
 import { BackgroundTaskQueue } from "./background.ts";
@@ -52,7 +52,6 @@ import {
 	formatToolActivity,
 	formatUsageCompact,
 	monitor,
-	rightAlign,
 	statusIcon,
 	statusLabel,
 	type RunChainMeta,
@@ -776,54 +775,74 @@ export default function (pi: ExtensionAPI): void {
 					}
 				}, 1000);
 				return {
-					render(width: number): string[] {
-						const runs = monitor.getRuns();
-						if (runs.length === 0) return [];
-						const now = Date.now();
-						const lines: string[] = [];
-						for (const r of runs) {
-							const icon = statusIcon(r.status, theme);
-							// Chain-internal runs (auto-fix worker/reviewer) indent under their parent
-							// reviewer. For those, the relationLabel ("fix round 1") is more
-							// distinguishing than the repeated worker/reviewer name.
-							const head = r.groupId ? theme.fg("dim", "  ↳ ") : " ";
-							const name = r.groupId ? (r.relationLabel ?? r.agent) : r.agent;
-							// Header row stays short: icon, run id, agent name — the task summary
-							// (keys-only fragments: paths, symbols, quoted phrases) gets its own
-							// line below with a full width budget, so parallel runs of the SAME
-							// agent are still distinguishable at a glance.
-							const title = formatTaskSummary(r.task, Math.max(16, Math.floor(width * 0.65)), true);
-							const left = `${head}${icon} ${theme.fg("dim", `#${r.id}`)} ${theme.bold(name)}`;
-
-							// Right side: full model ref (provider/model), token usage (in/out +
-							// cache read/write), tool count, elapsed, and the soft activity-state
-							// annotation (idle / long-running). Trailing the header with a single
-							// " · " chain keeps the row compact (no center gap); compactLine
-							// clips on overflow, never the right side on its own.
-							const model = r.model ?? "?";
-							const usage = formatUsageCompact(r.usage);
-							const tools = r.toolCount ? `${r.toolCount} tool${r.toolCount === 1 ? "" : "s"}` : "";
-							const elapsed = formatElapsed(r, now);
-							const metaParts = [model, usage, tools, elapsed].filter(Boolean);
-							// Running is conveyed by the icon + elapsed; spell out the label only for
-							// the other states (ready / done / stopped) so they are unambiguous.
-							if (r.status !== "running") metaParts.push(statusLabel(r.status));
-							const state = deriveActivityState(r, now);
-							if (state) metaParts.push(activityStateLabel(state));
-							if (r.annotation) metaParts.push(r.annotation);
-							const right = metaParts.length ? theme.fg("dim", ` · ${metaParts.join(" · ")}`) : "";
-							lines.push(compactLine(left, right, width));
-
-							// Task summary sits one indent below the header, on its own line.
-							lines.push(rightAlign(`${head}  ${theme.fg("accent", title)}`, "", width));
-
-							// Current activity sits one indent below, only while the run is active.
-							if (r.activity && (r.status === "running" || r.status === "queued")) {
-								lines.push(rightAlign(`${head}  ${theme.fg("dim", r.activity)}`, "", width));
+						render(width: number): string[] {
+							const runs = monitor.getRuns();
+							if (runs.length === 0) return [];
+							const now = Date.now();
+							const lines: string[] = [];
+							// Tree layout: each top-level agent is a root whose title/activity hang
+							// off it as branches; auto-fix chain runs (groupId) become child nodes
+							// under their parent root, with a "│" continuation while more siblings
+							// follow. Blank lines separate agent blocks so parallel runs don't blur
+							// into one wall of text.
+							const dim = (t: string): string => theme.fg("dim", t);
+							for (let idx = 0; idx < runs.length; idx++) {
+								const r = runs[idx];
+								const isChain = Boolean(r.groupId);
+								const chainContinues = isChain && runs[idx + 1]?.groupId === r.groupId;
+								const activity =
+									r.activity && (r.status === "running" || r.status === "queued") ? r.activity : undefined;
+								const hasActivity = activity !== undefined;
+								const icon = statusIcon(r.status, theme);
+								// Chain-internal runs (auto-fix worker/reviewer) are child nodes under
+								// their parent reviewer. Their relationLabel ("fix round 1") is more
+								// distinguishing than the repeated worker/reviewer name.
+								const name = isChain ? (r.relationLabel ?? r.agent) : r.agent;
+								// Two lines per run: the header row (icon, run id, agent name) and the
+								// live activity branch below. The task summary is deliberately not
+								// shown — the task lives in the tool result, and the agent name plus
+								// what it is doing right now is enough to tell runs apart. The header
+								// stays exactly as it was (accent name, dim stats), matching the
+								// referenced sub-agent widgets (tintinweb): the running indicator
+								// uses the accent color, everything else is quiet.
+								if (!isChain && lines.length > 0) lines.push("");
+								const nodeBranch = isChain ? (chainContinues ? "├─ " : "└─ ") : "";
+								const left = `${dim(nodeBranch)}${icon} ${dim(`#${r.id}`)} ${isChain ? name : theme.fg("accent", theme.bold(name))}`;
+
+								// Right side: full model ref (provider/model), token usage (in/out +
+								// cache read/write), tool count, elapsed, and the soft activity-state
+								// annotation (idle / long-running). Trailing the header with a single
+								// " · " chain keeps the row compact (no center gap); compactLine
+								// clips on overflow, never the right side on its own.
+								const model = r.model ?? "?";
+								const usage = formatUsageCompact(r.usage);
+								const tools = r.toolCount ? `${r.toolCount} tool${r.toolCount === 1 ? "" : "s"}` : "";
+								const elapsed = formatElapsed(r, now);
+								const metaParts = [model, usage, tools, elapsed].filter(Boolean);
+								// Running is conveyed by the icon + elapsed; spell out the label only for
+								// the other states (ready / done / stopped) so they are unambiguous.
+								if (r.status !== "running") metaParts.push(statusLabel(r.status));
+								const state = deriveActivityState(r, now);
+								if (state) metaParts.push(activityStateLabel(state));
+								if (r.annotation) metaParts.push(r.annotation);
+								// Metadata trails the header in dim — quiet, never competing with the
+								// accent agent name (the same restraint the referenced widgets use).
+								// Trailing with a single " · " chain keeps the row compact (no center
+								// gap); compactLine clips on overflow, never the right side on its own.
+								const right = metaParts.length ? dim(` · ${metaParts.join(" · ")}`) : "";
+								lines.push(compactLine(left, right, width));
+
+								// Current activity ("read src/index.ts", "bash npm test") is the only
+								// branch: gray, so it never competes with the agent name or pi's own
+								// UI. Chain nodes that still have siblings carry a "│" continuation
+								// down to the last one.
+								if (hasActivity) {
+									const continuation = isChain ? (chainContinues ? "│  " : "   ") : "";
+									lines.push(truncateToWidth(`${continuation}${dim("└─ ")}${dim(activity)}`, width));
+								}
 							}
-						}
-						return lines;
-					},
+							return lines;
+						},
 					invalidate() {},
 					dispose() {
 						unsub();