pi-squire 0.9.3 → 0.9.4

package/CHANGELOG.md

@@ -6,6 +6,16 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.9.4] - 2026-10-23
+
+### Changed
+
+- The `delegate` tool's row is drawn in the same style as the result message:
+  a call line naming the agent and label, then a ◐ header with the delegate's
+  name and model, a task preview and any skipped fallback models; expanded,
+  the whole task and the delegation id, window, thinking and auto-exit. The
+  text the model reads is unchanged.
+
 ## [0.9.3] - 2026-10-23
 
 ### Changed
@@ -354,7 +364,8 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.9.3...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.9.4...HEAD
+[0.9.4]: https://github.com/gvanderclay/pi-squire/compare/v0.9.3...v0.9.4
 [0.9.3]: https://github.com/gvanderclay/pi-squire/compare/v0.9.2...v0.9.3
 [0.9.2]: https://github.com/gvanderclay/pi-squire/compare/v0.9.1...v0.9.2
 [0.9.1]: https://github.com/gvanderclay/pi-squire/compare/v0.9.0...v0.9.1

package/README.md

@@ -453,7 +453,12 @@ Delegate session: <session file or id>
   delegate's name and the model, then the first 3 non-blank lines of the
   result with heading marks, backticks and bold stripped; expanded (Ctrl+O),
   the quoted task, the result as Markdown, then the ids and files, with the
-  home directory shown as `~`. The closed-without-a-result message gets the same header with ⊘.
+  home directory shown as `~`.
+- The `delegate` tool's own row is drawn the same way, so a launch and its
+  result match: a call line naming the agent and label, then a header with
+  a ◐ started icon, the delegate's name and the model it started on, a preview of the task and any skipped fallback models;
+  expanded, the whole task, then the delegation id, window, thinking and
+  auto-exit. A refused call keeps its plain error text. The closed-without-a-result message gets the same header with ⊘.
 - Stopping a delegate's run (Esc) sends no result: the provider holds the
   task, so the delegation stays running while the user steers it. The next
   run that completes sends the result, `done`, and its body opens with a note

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.9.3",
+	"version": "0.9.4",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",

package/src/index.ts

@@ -49,6 +49,7 @@ import { Type } from "typebox";
 import { type Agent, isThinking, type Roster, readRoster, THINKING_LEVELS } from "./agents.ts";
 import { AGENT_ENV, AUTO_EXIT_ENV, FALLBACK_ENV, registerChild } from "./child.ts";
 import { activeMark, clearMarks, isFree, readMarks } from "./limits.ts";
+import { renderDelegateCall, renderDelegateResult } from "./render.ts";
 import { createResults, delegateName } from "./results.ts";
 import { createTmuxClient, type TmuxClient } from "./tmux.ts";
 import { createTracking, toolResult } from "./tracking.ts";
@@ -596,6 +597,8 @@ export default function delegate(
 			),
 		}),
 		outputSchema: DelegateSchema,
+		renderCall: renderDelegateCall,
+		renderResult: renderDelegateResult,
 		// Opens a new window each call and removes nothing. Open world: the delegate calls a remote model and runs its agent's tools unattended.
 		annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
 		async execute(

package/src/render.ts

@@ -1,6 +1,7 @@
-// How a delegate message looks in the parent: drawn from the structured
-// details `results.ts` attaches, while the message's text stays what the
-// parent model reads.
+// How delegations look in the parent: the `delegate` tool's row and the
+// result or gone message that arrives later share one header and preview
+// style. Both are drawn from structured details, while their text stays what
+// the parent model reads.
 import { homedir } from "node:os";
 
 import {
@@ -11,7 +12,9 @@ import {
 	type Theme,
 } from "@earendil-works/pi-coding-agent";
 import { Box, type Component, Markdown, Spacer, Text, TruncatedText } from "@earendil-works/pi-tui";
+import type { Static } from "typebox";
 
+import type { DelegateSchema } from "./index.ts";
 import type { MessageDetails } from "./results.ts";
 
 /** The launch model, or `launch → finished` when the delegate finished on another one. */
@@ -23,7 +26,8 @@ export function modelLabel(model: string, finished: string | undefined): string
 const PREVIEW_LINES = 3;
 
 /** The icon and theme color for each status; an unknown status gets a neutral icon. */
-const STATUS_STYLE: Record<string, { icon: string; color: "success" | "error" | "warning" | "muted" }> = {
+const STATUS_STYLE: Record<string, { icon: string; color: "accent" | "success" | "error" | "warning" | "muted" }> = {
+	started: { icon: "◐", color: "accent" },
 	done: { icon: "✓", color: "success" },
 	failed: { icon: "✗", color: "error" },
 	stopped: { icon: "■", color: "warning" },
@@ -38,12 +42,25 @@ function header(details: MessageDetails, theme: Theme): string {
 	let trailer = "";
 	if (details.kind === "gone") trailer = " closed without a result";
 	else if (!known) trailer = ` ${details.status}`;
-	const model = theme.fg("muted", modelLabel(details.model, details.finishedModel));
-	return `${theme.fg(style.color, style.icon)} ${theme.fg("accent", details.name)} ${model}${
+	return headerLine(theme, style, details.name, modelLabel(details.model, details.finishedModel), trailer);
+}
+
+function headerLine(
+	theme: Theme,
+	style: { icon: string; color: "accent" | "success" | "error" | "warning" | "muted" },
+	name: string,
+	model: string,
+	trailer: string,
+): string {
+	return `${theme.fg(style.color, style.icon)} ${theme.fg("accent", name)} ${theme.fg("muted", model)}${
 		trailer === "" ? "" : theme.fg(style.color, trailer)
 	}`;
 }
 
+function expandHint(theme: Theme): Text {
+	return new Text(`${theme.fg("dim", keyText("app.tools.expand"))}${theme.fg("muted", " to expand")}`, 0, 0);
+}
+
 /** `path` with the home directory shown as `~`. */
 function tilde(path: string): string {
 	const home = homedir();
@@ -97,7 +114,7 @@ export function renderMessage(
 		if (details.kind === "result") {
 			for (const line of preview(details.body)) box.addChild(new TruncatedText(theme.fg("muted", line)));
 		}
-		box.addChild(new Text(`${theme.fg("dim", keyText("app.tools.expand"))}${theme.fg("muted", " to expand")}`, 0, 0));
+		box.addChild(expandHint(theme));
 		return box;
 	}
 	box.addChild(new Text(header(details, theme), 0, 0));
@@ -125,3 +142,56 @@ export function renderMessage(
 	box.addChild(metadataText);
 	return box;
 }
+
+/** The `delegate` tool's call line: the tool, the agent and any label. Arguments may still be streaming. */
+export function renderDelegateCall(args: { agent?: unknown; label?: unknown }, theme: Theme): Component {
+	let line = theme.bold("delegate");
+	if (typeof args.agent === "string") line += ` ${theme.fg("accent", args.agent)}`;
+	if (typeof args.label === "string" && args.label !== "" && args.label !== "null")
+		line += ` ${theme.fg("muted", `· ${args.label}`)}`;
+	return new Text(line, 0, 0);
+}
+
+/**
+ * The `delegate` tool's result, in the result message's style: a started
+ * header, then a task preview and the hint, or, expanded, the whole task and
+ * the ids. A refused or blocked call has no details and keeps its plain text.
+ */
+export function renderDelegateResult(
+	result: { content: { type: string; text?: string }[]; details?: unknown },
+	{ expanded }: { expanded: boolean },
+	theme: Theme,
+	context: { args: { task?: unknown }; isError: boolean },
+): Component {
+	const details = result.details as Partial<Static<typeof DelegateSchema>> | undefined;
+	if (context.isError || details?.outcome !== "started") {
+		const text = result.content.map((part) => part.text ?? "").join("\n");
+		return new Text(context.isError ? theme.fg("error", text) : text, 0, 0);
+	}
+	const started = details as Static<typeof DelegateSchema>;
+	const task = typeof context.args.task === "string" ? context.args.task : "";
+	const box = new Box(0, 0);
+	box.addChild(new TruncatedText(headerLine(theme, STATUS_STYLE.started, started.windowName, started.model, "")));
+	const skipped = started.skipped.map(({ model, reason }) => theme.fg("warning", `skipped ${model}: ${reason}`));
+	if (!expanded) {
+		for (const line of preview(task)) box.addChild(new TruncatedText(theme.fg("muted", line)));
+		for (const line of skipped) box.addChild(new TruncatedText(line));
+		box.addChild(expandHint(theme));
+		return box;
+	}
+	const quote = task
+		.split("\n")
+		.map((line) => theme.fg("muted", `> ${line}`))
+		.join("\n");
+	box.addChild(new Text(quote, 0, 0));
+	if (skipped.length + started.notices.length > 0)
+		box.addChild(new Text([...skipped, ...started.notices.map((line) => theme.fg("dim", line))].join("\n"), 0, 0));
+	box.addChild(new Spacer(1));
+	const ids = [
+		`delegation ${started.id}`,
+		`window ${started.windowName} (${started.windowId})`,
+		`thinking ${started.thinking}, auto-exit ${started.autoExit ? "on" : "off"}`,
+	];
+	box.addChild(new Text(ids.map((line) => theme.fg("dim", line)).join("\n"), 0, 0));
+	return box;
+}