@iowarp/clio-coder 0.4.9 → 0.5.0

package/src/interactive/permission-hint.ts

@@ -57,7 +57,7 @@ export function permissionHintEntries(
 	return [
 		composerHasDraft
 			? { key: "Backspace", verb: "clear the draft to allow", short: "clear draft", critical: true }
-			: { key: "Enter", verb: "allow once", short: "allow", critical: true },
+			: { key: "Enter", verb: "allow", short: "allow", critical: true },
 		// The terms key is the card's own and the most droppable entry: the folded
 		// card already states what the keys do in one row. It sits before the
 		// inspect key so the narrowing drops it first.
@@ -69,9 +69,9 @@ export function permissionHintEntries(
 			: inspection === "open"
 				? [
 						{ key: "↑↓", verb: "scroll", critical: false },
-						{ key: MUTATION_PREVIEW_KEY, verb: "hide mutation", short: "hide", critical: false },
+						{ key: MUTATION_PREVIEW_KEY, verb: "hide details", short: "hide", critical: false },
 					]
-				: [{ key: MUTATION_PREVIEW_KEY, verb: "inspect mutation", short: "inspect", critical: false }]),
+				: [{ key: MUTATION_PREVIEW_KEY, verb: "inspect details", short: "inspect", critical: false }]),
 		{ key: "s", verb: "stop turn", short: "stop", critical: true },
 		// With a draft, deny and stop are the only immediate answers, so Esc
 		// outranks the narrowing that would otherwise drop it first.

package/src/interactive/permission-overlay.ts

@@ -5,7 +5,7 @@ import {
 	type DecisionPresentation,
 	decisionFactsForPermission,
 } from "../domains/safety/decision-presentation.js";
-import type { Component, OverlayOptions, TUI } from "../engine/tui.js";
+import { type Component, type OverlayOptions, type TUI, visibleWidth, wrapTextWithAnsi } from "../engine/tui.js";
 import {
 	MUTATION_PREVIEW_VISIBLE_ROWS,
 	type MutationFacts,
@@ -22,7 +22,9 @@ import {
 	type PermissionTermsHint,
 	permissionHintEntries,
 } from "./permission-hint.js";
+import { renderToolArguments } from "./renderers/tool-execution.js";
 import type { ClioToken } from "./theme/index.js";
+import { clioTheme } from "./theme/index.js";
 
 export { type AskAxis, askAxis } from "../domains/safety/approval-axis.js";
 export { describeCallTarget, sanitizeCallTargetText } from "../domains/safety/call-target.js";
@@ -128,22 +130,28 @@ class PermissionOverlayBody implements PermissionOverlayBodyHandle {
 	private scroll = 0;
 	private lastLineCount = 0;
 	private terms = false;
+	private argumentsOpen = false;
 
 	constructor(
 		private readonly view: ApprovalRequestView,
 		private readonly inspect?: MutationInspector,
+		private readonly invocation?: () => unknown,
 	) {}
 
 	canInspect(): boolean {
-		return this.inspect !== undefined;
+		return this.inspect !== undefined || this.invocation !== undefined;
 	}
 
 	isInspecting(): boolean {
-		return this.preview !== null;
+		return this.preview !== null || this.argumentsOpen;
 	}
 
 	toggleInspect(): void {
-		if (this.inspect === undefined) return;
+		if (this.inspect === undefined) {
+			if (this.invocation !== undefined) this.argumentsOpen = !this.argumentsOpen;
+			this.scroll = 0;
+			return;
+		}
 		if (this.preview !== null) {
 			this.preview = null;
 			this.scroll = 0;
@@ -154,7 +162,7 @@ class PermissionOverlayBody implements PermissionOverlayBodyHandle {
 	}
 
 	scrollInspect(delta: number): void {
-		if (this.preview === null) return;
+		if (!this.isInspecting()) return;
 		const maxScroll = Math.max(0, this.lastLineCount - MUTATION_PREVIEW_VISIBLE_ROWS);
 		this.scroll = Math.max(0, Math.min(this.scroll + delta, maxScroll));
 	}
@@ -168,7 +176,29 @@ class PermissionOverlayBody implements PermissionOverlayBodyHandle {
 	}
 
 	render(width: number): string[] {
-		if (this.preview === null) return permissionOverlayLines(this.view, width, this.terms);
+		if (this.argumentsOpen && this.invocation) {
+			const rows = renderToolArguments(this.invocation(), width);
+			this.lastLineCount = rows.length;
+			this.scroll = Math.min(this.scroll, Math.max(0, rows.length - MUTATION_PREVIEW_VISIBLE_ROWS));
+			return [
+				...wrapTextWithAnsi(clioTheme().fg("accent", `Exact invocation · ${this.view.tool}`), width),
+				...rows.slice(this.scroll, this.scroll + MUTATION_PREVIEW_VISIBLE_ROWS),
+				...wrapTextWithAnsi(
+					clioTheme().fg(
+						"dim",
+						`${this.scroll + 1}–${Math.min(rows.length, this.scroll + MUTATION_PREVIEW_VISIBLE_ROWS)} of ${rows.length} rows · ↑↓ scroll · v back`,
+					),
+					width,
+				),
+			];
+		}
+		if (this.preview === null)
+			return [
+				...permissionOverlayLines(this.view, width, this.terms),
+				...(this.invocation && !this.inspect
+					? wrapTextWithAnsi(clioTheme().fg("dim", "v · inspect the complete invocation before deciding"), width)
+					: []),
+			];
 		const rendered = permissionInspectionLines(this.view, this.preview, width, this.scroll);
 		this.lastLineCount = rendered.wrappedLineCount;
 		return rendered.lines;
@@ -186,9 +216,9 @@ class PermissionOverlayBody implements PermissionOverlayBodyHandle {
  * continuation row hangs under the value's first column.
  */
 function field(label: string, value: string, width: number): string[] {
-	const indent = " ".repeat(label.length);
-	const rows = wrapSentence(value, Math.max(1, width - label.length));
-	return rows.map((row, index) => `${index === 0 ? label : indent}${row}`);
+	const indent = " ".repeat(visibleWidth(label));
+	const rows = wrapSentence(value, Math.max(1, width - visibleWidth(label)));
+	return rows.map((row, index) => `${index === 0 ? clioTheme().fg("dim", label) : indent}${row}`);
 }
 
 /**
@@ -198,23 +228,7 @@ function field(label: string, value: string, width: number): string[] {
  * decision about a tool call.
  */
 function wrapSentence(value: string, max: number): string[] {
-	if (max <= 0) return [value];
-	const lines: string[] = [];
-	let current = "";
-	for (const word of value.split(" ")) {
-		if (current.length === 0) current = word;
-		else if (current.length + 1 + word.length <= max) current = `${current} ${word}`;
-		else {
-			lines.push(current);
-			current = word;
-		}
-		while (current.length > max) {
-			lines.push(current.slice(0, max));
-			current = current.slice(max);
-		}
-	}
-	if (current.length > 0) lines.push(current);
-	return lines;
+	return wrapTextWithAnsi(value, Math.max(1, max));
 }
 
 function wrapArtifactLine(value: string, max: number): string[] {
@@ -336,6 +350,9 @@ function permissionInspectionLines(
 function termsSummary(presentation: DecisionPresentation, actionClass: string): string {
 	const stop = presentation.requiredActions.find((action) => action.id === "stop");
 	const stopWords = stop?.consequence.includes("main-agent turn") ? "ends the main-agent turn" : "ends the turn";
+	if (presentation.tier === "worker") {
+		return `Allow or Deny applies to this call and identical calls under the same permission conditions for this worker run. The autonomy level stays unchanged. Stop ${stopWords}. Press ${PERMISSION_TERMS_KEY} for the full terms.`;
+	}
 	return `Allow runs this one ${actionClass} call and leaves the autonomy level alone. Deny skips it. Stop ${stopWords}. Press ${PERMISSION_TERMS_KEY} for the full terms.`;
 }
 
@@ -414,6 +431,7 @@ function permissionOverlayLines(view: ApprovalRequestView, width: number, terms
 export function createPermissionOverlayBody(
 	view: ApprovalRequestView,
 	inspect?: MutationInspector,
+	invocation?: () => unknown,
 ): PermissionOverlayBodyHandle {
-	return new PermissionOverlayBody(view, inspect);
+	return new PermissionOverlayBody(view, inspect, invocation);
 }

package/src/interactive/renderers/doctor-report.ts

@@ -0,0 +1,43 @@
+import type { DoctorFinding } from "../../domains/lifecycle/doctor.js";
+import { wrapTextWithAnsi } from "../../engine/tui.js";
+import { type ClioToken, clioTheme } from "../theme/index.js";
+
+/** Operator-only diagnostics: keep every detail, with attention items first. */
+export function renderDoctorReport(findings: ReadonlyArray<DoctorFinding>, width: number): string[] {
+	const theme = clioTheme();
+	const safeWidth = Math.max(8, width);
+	const errors = findings.filter((finding) => !finding.ok);
+	const warnings = findings.filter((finding) => finding.ok && finding.level === "warn");
+	const information = findings.filter((finding) => finding.ok && finding.level === "info");
+	const passed = findings.filter((finding) => finding.ok && finding.level !== "warn" && finding.level !== "info");
+	const lines = wrapTextWithAnsi(theme.style("title", "Doctor · installation health", { bold: true }), safeWidth);
+	lines.push(
+		...wrapTextWithAnsi(
+			`${findings.length} checks · ${errors.length} errors · ${warnings.length} warnings · ${passed.length} passed · ${information.length} informational`,
+			safeWidth,
+		),
+	);
+	const groups: Array<{ title: string; token: ClioToken; label: string; rows: ReadonlyArray<DoctorFinding> }> = [
+		{ title: "Errors", token: "error", label: "FAIL", rows: errors },
+		{ title: "Warnings", token: "warning", label: "WARN", rows: warnings },
+		{ title: "Information", token: "info", label: "INFO", rows: information },
+		{ title: "Passed checks", token: "dim", label: "OK", rows: passed },
+	];
+	for (const group of groups) {
+		if (!group.rows.length) continue;
+		lines.push("", ...wrapTextWithAnsi(theme.fg(group.token, `${group.title} · ${group.rows.length}`), safeWidth));
+		for (const finding of group.rows) {
+			lines.push(
+				...wrapTextWithAnsi(
+					`${theme.fg(group.token, group.label)}  ${theme.paint(finding.name, { bold: true })}`,
+					safeWidth,
+				),
+			);
+			for (const detail of finding.detail.split(/\r?\n/)) {
+				lines.push(...wrapTextWithAnsi(detail.replace(/\t/g, "    "), safeWidth - 2).map((line) => `  ${line}`));
+			}
+		}
+	}
+	lines.push("");
+	return lines;
+}

package/src/interactive/renderers/tool-execution.ts

@@ -52,7 +52,6 @@ const ARG_PREVIEW_LIMIT = 60;
 const WEB_FETCH_ARG_PREVIEW_LIMIT = 140;
 const FULL_RESULT_PREVIEW_LIMIT = 60_000;
 const FULL_RESULT_ROW_LIMIT = 120;
-const ARGS_BODY_LINE_LIMIT = 24;
 const STATUS_OK_GLYPH = GLYPH.ok;
 const STATUS_ERROR_GLYPH = GLYPH.error;
 
@@ -588,24 +587,26 @@ function statusGlyph(status: HeaderStatus, meta: StatusMeta = {}): string {
 }
 
 function headerLine(toolName: string, args: unknown, status: HeaderStatus, meta: StatusMeta = {}): string {
-	const body = styleSublineBody(buildSublineBody(toolName, args, status, undefined, meta.outcome));
+	const body = styleSublineBody(buildSublineBody(toolName, args, status, undefined, meta.outcome), toolName);
 	const head = `${dim(HEADER_PREFIX_PLAIN)}${body}`;
 	return `${head}${statusGlyph(status, meta)}`;
 }
 
 function sublineLead(token: string, rest: string): string {
-	return `${cyanBold(token)}${rest}`;
+	return `${theme.style("tool", token, { bold: true })}${rest}`;
 }
 
-function styleSublineBody(body: string): string {
+function styleSublineBody(body: string, toolName?: string): string {
 	const match = /^(?<lead>[^ (]+)(?<rest>.*)$/u.exec(body);
 	if (match?.groups?.lead === undefined || match.groups.rest === undefined) return body;
-	return sublineLead(match.groups.lead, match.groups.rest);
+	return toolName === "dispatch"
+		? `${theme.style("agent", match.groups.lead, { bold: true })}${match.groups.rest}`
+		: sublineLead(match.groups.lead, match.groups.rest);
 }
 
 function buildGenericToolBody(toolName: string, args: unknown): string {
 	const summary = summarizeArgs(toolName, args);
-	return summary.length > 0 ? `tool action ${summary}` : "tool action";
+	return summary.length > 0 ? `${sanitizeCallTargetText(toolName)} ${summary}` : sanitizeCallTargetText(toolName);
 }
 
 function buildFieldSublineBody(
@@ -644,7 +645,13 @@ function dispatchSublineBody(args: unknown): string | null {
 			}
 		}
 	}
-	const tasks = Array.isArray(rawTasks) ? rawTasks : rawTasks === undefined ? [] : [rawTasks];
+	const tasks = Array.isArray(rawTasks)
+		? rawTasks
+		: rawTasks === undefined
+			? typeof args.task === "string"
+				? [args]
+				: []
+			: [rawTasks];
 	if (tasks.length === 0) return null;
 	const first = tasks[0];
 	const record = isPlainObject(first) ? first : null;
@@ -663,7 +670,7 @@ const SUBLINE_BODY_BUILDERS: Readonly<Record<string, (args: unknown) => string |
 	read: (args) => buildFieldSublineBody(args, "path", "reading "),
 	edit: (args) => buildFieldSublineBody(args, "path", "editing "),
 	write: (args) => buildFieldSublineBody(args, "path", "writing "),
-	ls: (args) => buildFieldSublineBody(args, "path", "listing "),
+	ls: (args) => buildFieldSublineBody(args, "path", "listing ") ?? "listing workspace",
 	bash: (args) => buildFieldSublineBody(args, "command", "running ", { wrapInBackticks: true }),
 	grep: (args) => buildFieldSublineBody(args, "pattern", "searching for ", { wrapInBackticks: true }),
 	find: (args) => buildFieldSublineBody(args, "pattern", "finding ", { wrapInBackticks: true }),
@@ -706,8 +713,8 @@ const SUBLINE_BODY_BUILDERS: Readonly<Record<string, (args: unknown) => string |
 		const query = readStringField(args, "query")?.trim() ?? "";
 		const name = readStringField(args, "name")?.trim() ?? "";
 		if (scope === "docs" && query.length > 0) return `context docs \`${truncate(query, ARG_PREVIEW_LIMIT)}\``;
-		if (scope === "skills" && name.length > 0) return `context skills ${truncate(name, ARG_PREVIEW_LIMIT)}`;
-		return `context ${scope}`;
+		if (scope === "skills" && name.length > 0) return `loading skill ${truncate(name, ARG_PREVIEW_LIMIT)}`;
+		return scope === "skills" ? "discovering skills" : `context ${scope}`;
 	},
 	artifact: (args) => buildFieldSublineBody(args, "kind", "writing "),
 	monitor: (args) => buildFieldSublineBody(args, "run_id", "monitoring "),
@@ -806,7 +813,10 @@ function sublineParts(
 	meta: StatusMeta,
 ): SublineParts {
 	const finished = "result" in call ? call : null;
-	const body = styleSublineBody(buildSublineBody(call.toolName, call.args, status, finished?.result, finished?.outcome));
+	const body = styleSublineBody(
+		buildSublineBody(call.toolName, call.args, status, finished?.result, finished?.outcome),
+		call.toolName,
+	);
 	const resourceLabel = classifyResourceRead(call.toolName, call.args);
 	const resource = resourceLabel !== null ? dim(` · ${resourceLabel}`) : "";
 	if (finished !== null) {
@@ -862,58 +872,40 @@ function indentAndWrap(line: string, width: number, isError: boolean): string[]
 	return out;
 }
 
-function scalarArgValue(value: unknown): string | null {
-	if (typeof value === "string") {
-		const lines = value.split("\n").length;
-		const bytes = Buffer.byteLength(value, "utf8");
-		if (lines > 1 || value.length > 160) return dim(`<${lines} lines · ${formatSize(bytes)} text>`);
-		return green(JSON.stringify(value));
-	}
-	if (typeof value === "number") return cyan(String(value));
-	if (typeof value === "boolean") return yellow(String(value));
-	if (value === null) return dim("null");
-	return null;
-}
-
-/**
- * Render secondary arguments as a compact typed field list. The primary path,
- * command, pattern, or query already lives in the call signature; keeping the
- * rest means `cwd`, timeout, range, glob, and flags no longer disappear merely
- * because one field was important enough for the header. Nested values retain
- * the structured JSON renderer, while large strings become byte/line facts
- * instead of flooding the transcript.
- */
-function renderArgsBody(toolName: string, args: unknown, width: number, isError: boolean): string[] {
+/** Full redacted arguments are retained for inspection; transcript callers budget rows. */
+export function renderToolArguments(
+	args: unknown,
+	width: number,
+	isError = false,
+	maxRows = Number.POSITIVE_INFINITY,
+): string[] {
 	if (isEmptyArgs(args)) return [];
 	const safeArgs = redactToolArgs(args);
-	if (!isPlainObject(safeArgs)) {
-		const bodyWidth = Math.max(1, width - BODY_INDENT_VISIBLE_WIDTH);
-		const lines = tryRenderJson(safeArgs, bodyWidth, { lineLimit: ARGS_BODY_LINE_LIMIT });
-		return lines?.flatMap((line) => indentAndWrap(line, width, isError)) ?? [];
-	}
-	const primary = PRIMARY_ARG_FIELD[toolName];
-	const entries = Object.entries(safeArgs).filter(([key]) => key !== primary);
-	if (entries.length === 0) return [];
 	const out: string[] = [];
-	const bodyWidth = Math.max(1, width - BODY_INDENT_VISIBLE_WIDTH);
-	out.push(...indentAndWrap(`${cyanBold("args")}${dim(` · ${entries.length}`)}`, width, isError));
-	const keyWidth = Math.min(18, Math.max(...entries.map(([key]) => visibleWidth(key))));
+	const entries = isPlainObject(safeArgs) ? Object.entries(safeArgs) : [["input", safeArgs] as const];
 	for (const [key, value] of entries) {
-		const label = `${cyan(key.padEnd(keyWidth))}  `;
-		const scalar = scalarArgValue(value);
-		if (scalar !== null) {
-			out.push(...indentAndWrap(`${label}${scalar}`, width, isError));
-			continue;
+		const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+		const full = String(text ?? value);
+		const chars = Number.isFinite(maxRows) ? Math.max(1, maxRows * Math.max(1, width) * 4) : full.length;
+		const lines = full.slice(0, chars).split("\n");
+		out.push(
+			...indentAndWrap(
+				`${cyan(sanitizeCallTargetText(key))} ${dim("›")} ${sanitizeMultilineDisplayText(lines[0] ?? "").text}`,
+				width,
+				isError,
+			),
+		);
+		for (const line of lines.slice(1)) {
+			if (out.length > maxRows) break;
+			out.push(...indentAndWrap(`  ${sanitizeMultilineDisplayText(line).text}`, width, isError));
 		}
-		out.push(...indentAndWrap(cyan(key), width, isError));
-		const lines = tryRenderJson(value, Math.max(1, bodyWidth - 2), { lineLimit: ARGS_BODY_LINE_LIMIT });
-		for (const line of lines ?? [jsonStringifySafe(value)]) {
-			out.push(...indentAndWrap(`  ${line}`, width, isError));
-			if (out.length >= ARGS_BODY_LINE_LIMIT) break;
+		if (out.length > maxRows || full.length > chars) {
+			return [
+				...out.slice(0, Math.max(0, maxRows - 1)),
+				...indentAndWrap(dim("… more arguments · /view"), width, isError),
+			];
 		}
-		if (out.length >= ARGS_BODY_LINE_LIMIT) break;
 	}
-	if (out.length >= ARGS_BODY_LINE_LIMIT) out.push(...indentAndWrap(dim("… more arguments hidden"), width, isError));
 	return out;
 }
 
@@ -1227,6 +1219,7 @@ export function renderToolExecution(
 	if ((finished.toolName === "edit" || finished.toolName === "write") && finished.isError === false) {
 		const diff = resultDiff(finished.result);
 		if (diff !== null) {
+			out.push(...renderToolArguments(finished.args, width, false));
 			out.push(...renderOutputMeta(finished, width, false, "change"));
 			out.push(...renderMutationDiffBlock(diff, width, opts.diffStyle !== "plain"));
 			out.push(...renderOutputFooter(finished, width, false));
@@ -1241,7 +1234,7 @@ export function renderToolExecution(
 	if (finished.toolName === "bash") {
 		const bashArgs = asBashArgs(redactToolArgs(finished.args));
 		if (bashArgs !== null) {
-			out.push(...renderArgsBody(finished.toolName, finished.args, width, finished.isError));
+			out.push(...renderToolArguments(finished.args, width, finished.isError));
 			out.push(
 				...renderOutputMeta(
 					finished,
@@ -1256,10 +1249,8 @@ export function renderToolExecution(
 		}
 	}
 
-	// The primary argument already lives in the signature. Keep the secondary
-	// fields below it so flags, ranges, working directories, and timeouts remain
-	// inspectable without repeating the primary value.
-	out.push(...renderArgsBody(finished.toolName, finished.args, width, finished.isError));
+	// The heading is a preview; inspection retains every redacted argument.
+	out.push(...renderToolArguments(finished.args, width, finished.isError));
 	out.push(
 		...renderOutputMeta(
 			finished,
@@ -1374,7 +1365,33 @@ export function renderBashTranscriptExecution(
 		: renderToolPreview(finished, width, bodyOptions.detail ?? transcriptDetail(), { ...bodyOptions, operator: true });
 }
 
-/** One action identity plus a bounded result; arguments and full output belong in /view. */
+function previewArguments(call: ToolExecutionStart | ToolExecutionFinished): unknown {
+	if (!isPlainObject(call.args)) return call.args;
+	const safe = redactToolArgs(call.args);
+	if (!isPlainObject(safe)) return safe;
+	if (call.toolName === "context" && safe.scope === "skills") {
+		const { scope: _scope, ...rest } = safe;
+		if (
+			typeof rest.name === "string" &&
+			rest.name.length > 0 &&
+			rest.name.length <= ARG_PREVIEW_LIMIT &&
+			!/[\r\n\t]/.test(rest.name)
+		)
+			delete rest.name;
+		return rest;
+	}
+	const primary = PRIMARY_ARG_FIELD[call.toolName];
+	if (!primary || typeof safe[primary] !== "string") return safe;
+	const value = safe[primary] as string;
+	// Commands retain their separate, readable command block even when short.
+	if (call.toolName === "bash" || /[\r\n\t]/.test(value) || value.length > ARG_PREVIEW_LIMIT) return safe;
+	const heading = buildSublineBody(call.toolName, safe, undefined, undefined, undefined);
+	if (!value || !heading.includes(value)) return safe;
+	const { [primary]: _shown, ...rest } = safe;
+	return rest;
+}
+
+/** Invocation intent stays visible in every style; /view retains the complete arguments and output. */
 export function renderToolPreview(
 	call: ToolExecutionStart | ToolExecutionFinished,
 	width: number,
@@ -1394,6 +1411,14 @@ export function renderToolPreview(
 		options.terminalRows,
 	);
 	const rows = renderToolSubline(call, width);
+	rows.push(
+		...renderToolArguments(
+			previewArguments(call),
+			width,
+			failure,
+			previewBudget(detail.invocationRows, options.terminalRows),
+		),
+	);
 	const result = finished?.result ?? options.partialResult;
 	const diff = finished && !failure ? resultDiff(result) : null;
 	if (diff !== null && detail.diffRows > 0) {

package/src/interactive/renderers/worker-entry.ts

@@ -1,3 +1,4 @@
+import { sanitizeCallTargetText } from "../../domains/safety/call-target.js";
 import { redactSecretString } from "../../domains/safety/redaction.js";
 import type { TranscriptDetailPolicy } from "../transcript-detail.js";
 import { transcriptDetail } from "../transcript-detail.js";
@@ -31,6 +32,7 @@ const SEPARATOR = " · ";
 const BODY_LINE_LIMIT = 80;
 
 export interface WorkerEntryRenderOptions {
+	nowMs?: number;
 	detail?: TranscriptDetailPolicy;
 	terminalRows?: number;
 	/** Render the full body without the line cap; `/export` sets this. */
@@ -52,7 +54,14 @@ function identityUnits(entry: WorkerEntryState): string[] {
 	const route =
 		targetId !== undefined && wireModelId !== undefined ? `${targetId}/${wireModelId}` : (targetId ?? wireModelId);
 	return [
-		theme.fg("muted", kind === "acp" ? `${entry.agentId} (acp)` : entry.agentId),
+		theme.fg(
+			"muted",
+			entry.helper
+				? `Clio-Coder → ${entry.agentId.replace(/(^|[-_ ])([a-z])/g, (_, gap: string, letter: string) => `${gap ? " " : ""}${letter.toUpperCase()}`)} · internal agent`
+				: kind === "acp"
+					? `${entry.agentId} (acp)`
+					: entry.agentId,
+		),
 		...(kind !== "acp" && route !== undefined ? [dim(route)] : []),
 		dim(`run ${entry.runId}`),
 	];
@@ -132,7 +141,8 @@ function footerUnits(entry: WorkerEntryState, receipt: WorkerReceiptSummary): st
 	}
 	if (receipt.tokenCount !== undefined && receipt.tokenCount > 0) {
 		units.push(dim(`${formatFooterTokens(receipt.tokenCount)} tok`));
-	} else if (receipt.toolCalls !== undefined && receipt.toolCalls > 0) {
+	}
+	if (receipt.toolCalls !== undefined && receipt.toolCalls > 0) {
 		units.push(dim(`${receipt.toolCalls} tool call${receipt.toolCalls === 1 ? "" : "s"}`));
 	}
 	if (receipt.durationMs !== undefined) units.push(dim(formatCompactMs(receipt.durationMs)));
@@ -293,12 +303,71 @@ function actionLine(entry: WorkerEntryState, width: number): string {
 	return truncateToWidth(header, width, GLYPH.ellipsis, false);
 }
 
+function workerMetrics(entry: WorkerEntryState): string[] {
+	const metrics: string[] = [];
+	const tokens = entry.receipt?.tokenCount ?? entry.progress?.processedTokens;
+	const calls = entry.receipt?.toolCalls ?? entry.progress?.toolCalls;
+	if (tokens !== undefined) metrics.push(`${formatFooterTokens(tokens)} tokens processed`);
+	if (entry.progress?.contextTokens !== undefined)
+		metrics.push(`context ${formatFooterTokens(entry.progress.contextTokens)}`);
+	if (calls !== undefined) metrics.push(`${calls} tool calls`);
+	return metrics;
+}
+
+/** A helper is an agent invocation, but its report belongs to the coordinator. */
+function helperCard(
+	entry: WorkerEntryState,
+	width: number,
+	detail: TranscriptDetailPolicy,
+	terminalRows?: number,
+	nowMs = Date.now(),
+): string[] {
+	const pending = isPending(entry);
+	const failed = !pending && (entry.receipt?.outcome !== "succeeded" || entry.receipt?.contract === "fail");
+	const status = pending
+		? "working"
+		: entry.receipt?.outcome === "canceled"
+			? "canceled"
+			: failed
+				? "failed"
+				: "completed";
+	const action = entry.progress?.currentAction;
+	const activity = pending
+		? action
+			? `${action.descriptor?.verb ?? action.tool} ${action.descriptor?.object ?? ""}`
+			: "Gathering findings for Clio-Coder"
+		: failed
+			? (entry.receipt?.failureMessage ?? entry.receipt?.outcomeCode ?? "Open details for the failure")
+			: "Findings returned to Clio-Coder";
+	const clean = (text: string) => sanitizeCallTargetText(redactSecretString(text));
+	const elapsedMs =
+		pending && entry.startedAtMs !== undefined ? Math.max(0, nowMs - entry.startedAtMs) : entry.receipt?.durationMs;
+	const elapsed = elapsedMs === undefined ? "" : ` · ${formatCompactMs(elapsedMs)}`;
+	const header = `${theme.fg("agent", `↳ Clio-Coder → ${clean(entry.agentId).replace(/(^|[-_ ])([a-z])/g, (_, gap: string, letter: string) => `${gap ? " " : ""}${letter.toUpperCase()}`)}`)}${dim(" · internal agent · ")}${theme.fg(failed ? "warning" : pending ? "accent" : "success", status)}${dim(elapsed)}`;
+	const body = railLines(clean(entry.task ?? "Assisting the main agent"), "muted", width);
+	const metrics = workerMetrics(entry);
+	return [
+		...wrapTextWithAnsi(header, width),
+		...previewRows(body, previewBudget(detail.invocationRows, terminalRows), width),
+		...railLines(clean(activity), pending ? "accent" : "muted", width),
+		...(metrics.length ? railLines(metrics.join(" · "), "dim", width) : []),
+		...wrapTextWithAnsi(`${dim(FOOTER)}${dim(`/view dispatch:${entry.runId}`)}`, width),
+		...previewRows(failureLines(entry, width), previewBudget(detail.errorRows, terminalRows), width),
+		...previewRows(attemptLines(entry, width), previewBudget(detail.errorRows, terminalRows), width),
+		...(entry.receipt?.receiptUnavailable ? railLines("receipt unavailable", "warning", width) : []),
+		...(entry.receipt?.abandonedDetail ? railLines(entry.receipt.abandonedDetail, "warning", width) : []),
+	].map(redactSecretString);
+}
+
 export function renderWorkerEntryLines(
 	entry: WorkerEntryState,
 	width: number,
 	options: WorkerEntryRenderOptions,
 ): string[] {
 	const safeWidth = Math.max(1, Math.floor(width));
+	const detail = options.detail ?? transcriptDetail();
+	if (entry.helper && !options.unbounded && detail.style !== "detailed" && !workerNeedsInput(entry))
+		return helperCard(entry, safeWidth, detail, options.terminalRows, options.nowMs);
 	const integrity = entry.receipt?.trust;
 	const provenance =
 		isPending(entry) || integrity?.artifactIntegrity.state === "verified"
@@ -315,11 +384,11 @@ export function renderWorkerEntryLines(
 				"muted",
 				safeWidth,
 			);
-	const detail = options.detail ?? transcriptDetail();
 	if (options.unbounded) {
 		const tools = toolLine(entry, safeWidth);
 		return [
 			headerLine(entry, safeWidth),
+			...(entry.helper && entry.task ? railLines(entry.task, "muted", safeWidth) : []),
 			...bodyLines(entry, safeWidth, true),
 			...attemptLines(entry, safeWidth),
 			...(tools ? [tools] : []),
@@ -356,6 +425,10 @@ export function renderWorkerEntryLines(
 	const presented = presentedContractAnswer(entry)?.footer;
 	return [
 		actionLine(entry, safeWidth),
+		...(workerMetrics(entry).length ? railLines(workerMetrics(entry).join(" · "), "dim", safeWidth) : []),
+		...(entry.helper && entry.task
+			? previewRows(railLines(entry.task, "muted", safeWidth), budget(detail.invocationRows), safeWidth)
+			: []),
 		...(detail.workerRows > 0 || needsInput ? previewRows(summary, summaryRows, safeWidth, entry.pending) : []),
 		...previewRows(attemptLines(entry, safeWidth), budget(detail.errorRows), safeWidth, true),
 		...(tools ? [tools] : []),

package/src/interactive/side-question.ts

@@ -196,7 +196,9 @@ async function runRound(input: OutOfTurnRoundInput, binding: SchemaBinding | nul
 	const context = {
 		systemPrompt: input.systemPrompt,
 		messages: [
-			...input.messages,
+			// Pi 0.86 stores prompt/tool declarations in history. This tool-free
+			// round has its own prompt and must not inherit those declarations.
+			...input.messages.filter((message) => message.role !== "system"),
 			{ role: "user", content: [{ type: "text", text: input.userText }], timestamp: Date.now() },
 		],
 	};