pi-claude-code-ui 1.0.71 → 1.0.72

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 > [!IMPORTANT]
 > **1.0.69 — package rename (permanent).** Canonical npm name is now [`pi-claude-code-ui`](https://www.npmjs.com/package/pi-claude-code-ui). `pi-claude-style-tools` is legacy and will not receive further releases. Install with `pi install npm:pi-claude-code-ui` or `npm i pi-claude-code-ui`.
 
+## 1.0.72 — 2026-07-18
+
+### Changed
+
+- **Agent tools breathe** — `Agent` / subagent tools use a size cycle while pending (`⬤ → ● → • → (invisible) → • → ●`) instead of the ordinary on/off `●` blink, so agent work reads as a different kind of tool.
+
 ## 1.0.71 — 2026-07-18
 
 ### Fixed

package/extensions/index.ts

@@ -434,10 +434,16 @@ function isToolExecutionLike(value: unknown): value is { toolName: string; toolC
 	return typeof candidate.toolName === "string" && typeof candidate.toolCallId === "string";
 }
 
+const AGENT_FAMILY_TOOL_NAMES = new Set(["Agent", "Agents", "get_subagent_result", "steer_subagent"]);
+
+function isAgentFamilyToolName(name: unknown): boolean {
+	return typeof name === "string" && AGENT_FAMILY_TOOL_NAMES.has(name);
+}
+
 function shouldIndentToolExecution(value: unknown): boolean {
 	if (!value || typeof value !== "object") return false;
 	const toolName = (value as Record<string, unknown>).toolName;
-	return typeof toolName === "string" && ["Agent", "Agents", "get_subagent_result", "steer_subagent"].includes(toolName);
+	return isAgentFamilyToolName(toolName);
 }
 
 function isTerminalImageLine(line: string): boolean {
@@ -541,9 +547,11 @@ function getToolGroupOverallStatus(tools: any[]): ToolStatus {
 
 // Claude Code: solid filled circle that is either fully present or fully gone
 // while pending — never a hollow outlined ○. Classic ● + bold is the sweet
-// spot (⬤ was too large in most mono fonts).
+// spot for ordinary tools. Agent-family tools use a breathing size cycle.
 const STATUS_DOT_FILLED = "●";
 const STATUS_DOT_BOLD = "\x1b[1m";
+// big → medium → small → invisible → small → medium (then back to big)
+const AGENT_BREATHE_GLYPHS = ["⬤", "●", "•", " ", "•", "●"] as const;
 
 function paintStatusDot(colorAnsi: string): string {
 	return `${colorAnsi}${STATUS_DOT_BOLD}${STATUS_DOT_FILLED}${TRANSPARENT_RESET}`;
@@ -554,6 +562,12 @@ function themeStatusDot(theme: Theme, colorKey: "success" | "error" | "dim" | "m
 	return theme.fg(colorKey, `${STATUS_DOT_BOLD}${STATUS_DOT_FILLED}`);
 }
 
+function agentBreatheDot(theme: Theme): string {
+	const glyph = AGENT_BREATHE_GLYPHS[_globalBlinkPhaseIndex % AGENT_BREATHE_GLYPHS.length];
+	if (glyph === " ") return " ";
+	return theme.fg("success", `${STATUS_DOT_BOLD}${glyph}`);
+}
+
 function groupStatusLight(status: ToolStatus): string {
 	const color = status === "success" ? TOOL_STATUS_SUCCESS : status === "error" ? TOOL_STATUS_ERROR : TOOL_STATUS_PENDING;
 	if (status === "pending") {
@@ -2606,6 +2620,9 @@ type BlinkEntry = { key: any; order: number; invalidate: () => void };
 const _blinkContexts = new Map<any, BlinkEntry>();
 let _globalBlinkTimer: ReturnType<typeof setTimeout> | null = null;
 let _blinkOrder = 0;
+// Shared phase for all blinkers. Ordinary tools use even/odd (on/off ●).
+// Agent-family tools map the index onto a 6-step size breath cycle.
+let _globalBlinkPhaseIndex = 0;
 let _globalBlinkPhase = true;
 
 function getBlinkIntervalMs(): number {
@@ -2664,7 +2681,8 @@ function _scheduleGlobalBlinkTimer(): void {
 			_clearAllBlinkContexts();
 			return;
 		}
-		_globalBlinkPhase = !_globalBlinkPhase;
+		_globalBlinkPhaseIndex = (_globalBlinkPhaseIndex + 1) % AGENT_BREATHE_GLYPHS.length;
+		_globalBlinkPhase = _globalBlinkPhaseIndex % 2 === 0;
 		for (const entry of getBlinkingEntries()) {
 			try { entry.invalidate(); } catch { /* noop */ }
 		}
@@ -2726,9 +2744,13 @@ function blinkDot(ctx: any, theme: Theme): string {
 	}
 	setupBlinkTimer(ctx);
 	const key = getBlinkKey(ctx);
+	if (key?._blinkActive !== true) return " ";
+	// Agent-family tools breathe through sizes; ordinary tools still on/off ●.
+	if (ctx?.state?._agentBreathe === true) {
+		return agentBreatheDot(theme);
+	}
 	// Claude Code: solid filled circle that either shows or fully disappears —
 	// never a hollow outlined ○ in the off phase.
-	if (key?._blinkActive !== true) return " ";
 	return _globalBlinkPhase ? themeStatusDot(theme, "success") : " ";
 }
 
@@ -4922,6 +4944,8 @@ function genericToolLabel(name: string): string {
 function renderGenericToolCall(name: string, args: any, theme: Theme, ctx: any): Text {
 	syncToolCallStatus(ctx);
 	ctx.state._openAiPatchFiles = [];
+	// Agent / subagent tools get a size-breathing pending marker, not on/off ●.
+	if (isAgentFamilyToolName(name)) ctx.state._agentBreathe = true;
 	const sp = (path: string) => shortPath(ctx.cwd ?? process.cwd(), path);
 	const summary = stableCallSummary(ctx, "_callSummary", () => summarizeGenericToolCall(name, args, theme, sp));
 	return makeText(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-claude-code-ui",
-  "version": "1.0.71",
+  "version": "1.0.72",
   "description": "Claude Code-style grouped tool rows for pi with Ctrl+O/Ctrl+Shift+O previews, math rendering, and consistent built-in, MCP, and custom tool rendering",
   "keywords": [
     "pi-package",