@oh-my-pi/pi-tui 18.2.10 → 18.3.0

package/src/tools/proc-render.ts

@@ -0,0 +1,294 @@
+import type { Component } from "../tui";
+import { createCachedComponent, Ellipsis, renderStatusLine, renderTreeList, truncateToWidth } from "../render";
+import {
+	cappedHeadLines,
+	formatBadge,
+	formatDuration,
+	formatErrorDetail,
+	formatStatusIcon,
+	PREVIEW_LIMITS,
+	TRUNCATE_LENGTHS,
+	replaceTabs,
+	type ToolUIColor,
+} from "../render/render-utils";
+import type { Theme } from "../theme/theme";
+import type { RenderResultOptions } from "./renderer";
+import type { AgentActivitySnapshot, CoordinationDetails, JobSnapshot } from "./wait";
+import type { IrcDeliveryReceipt } from "./irc";
+import type { DaemonSnapshot } from "./daemon";
+import { styleTerminalRow } from "./terminal-output";
+
+export interface ProcReadDetails {
+	jobs?: JobSnapshot[];
+	agents?: AgentActivitySnapshot[];
+	daemons?: DaemonSnapshot[];
+	job?: JobSnapshot;
+	daemon?: DaemonSnapshot;
+	log?: string;
+	terminalRows?: string[];
+}
+
+export type ProcWriteDetails =
+	| CoordinationDetails
+	| { action: "stop" | "stdin" | "mode"; daemon: DaemonSnapshot; input?: string; mode?: string };
+
+/** Process operation selected by a write URL, independent of its content. */
+export type ProcWriteAction = "stdin" | "mode" | "kill";
+
+interface ToolResult {
+	content: Array<{ type: string; text?: string }>;
+	isError?: boolean;
+}
+
+function firstText(result: ToolResult): string {
+	return result.content.find(item => item.type === "text")?.text ?? "";
+}
+
+function safe(value: string): string {
+	return replaceTabs(value).replace(/\r/g, "");
+}
+
+function card(lines: (width: number, expanded: boolean) => string[], options: RenderResultOptions): Component {
+	return createCachedComponent(
+		() => Boolean(options.expanded),
+		(width, expanded) =>
+			lines(width, expanded)
+				.flatMap(line => line.split("\n"))
+				.map(line => truncateToWidth(safe(line), width, Ellipsis.Unicode)),
+		{ paddingX: 1 },
+	);
+}
+
+function preview(body: string, expanded: boolean, theme: Theme, tone: "dim" | "toolOutput" = "dim"): string[] {
+	if (!body.trim()) return [];
+	const limit = expanded ? PREVIEW_LIMITS.EXPANDED_LINES : PREVIEW_LIMITS.COLLAPSED_LINES;
+	const shown = cappedHeadLines(
+		body.split("\n").filter(line => line.trim()),
+		limit,
+	);
+	const quote = theme.fg("dim", theme.md.quoteBorder);
+	const lines = shown.lines.map(
+		line =>
+			`  ${quote} ${theme.fg(tone, truncateToWidth(safe(line.trim()), TRUNCATE_LENGTHS.LINE, Ellipsis.Unicode))}`,
+	);
+	if (shown.hidden) lines.push(`  ${quote} ${theme.fg("dim", `… +${shown.hidden} more lines`)}`);
+	return lines;
+}
+
+function receiptColor(outcome: IrcDeliveryReceipt["outcome"]): ToolUIColor {
+	return outcome === "failed" ? "error" : outcome === "revived" ? "warning" : "success";
+}
+
+export function renderAgentWrite(
+	to: string,
+	body: string,
+	result: ToolResult | undefined,
+	details: CoordinationDetails | undefined,
+	options: RenderResultOptions,
+	theme: Theme,
+): Component {
+	return card((width, expanded) => {
+		const recipient = safe(details?.to || to || "…");
+		const title = `IRC ${theme.nav.selected} ${recipient}`;
+		const receipts = details?.receipts ?? [];
+		const delivered = receipts.filter(receipt => receipt.outcome !== "failed").length;
+		const failed = receipts.length - delivered;
+		const error = result?.isError || (failed > 0 && delivered === 0);
+		const meta: string[] = [];
+		if (recipient === "all") meta.push("broadcast");
+		if (receipts.length === 1) meta.push(theme.fg(receiptColor(receipts[0]!.outcome), receipts[0]!.outcome));
+		else if (receipts.length > 1) {
+			if (delivered) meta.push(theme.fg("success", `${delivered} delivered`));
+			if (failed) meta.push(theme.fg("error", `${failed} failed`));
+		}
+		const header = renderStatusLine(
+			result === undefined
+				? { icon: "pending", title, meta }
+				: error
+					? { icon: "error", title, meta }
+					: { iconOverride: theme.styledSymbol("tool.irc", "accent"), title, meta },
+			theme,
+		);
+		if (result?.isError && receipts.length === 0)
+			return [header, formatErrorDetail(firstText(result) || "Message delivery failed.", theme)];
+		const lines = [header, ...preview(body, expanded, theme)];
+		if (result && receipts.length === 0)
+			lines.push(theme.fg("muted", firstText(result) || "No live peers to broadcast to."));
+		if (receipts.length > 1 || failed > 0) {
+			lines.push(
+				...renderTreeList(
+					{
+						items: receipts,
+						expanded,
+						maxCollapsed: PREVIEW_LIMITS.COLLAPSED_ITEMS,
+						itemType: "recipient",
+						renderItem: receipt =>
+							`${theme.fg("toolOutput", safe(receipt.to))} ${formatBadge(receipt.outcome, receiptColor(receipt.outcome), theme)}${receipt.error ? ` ${theme.fg("error", `${theme.format.dash} ${safe(receipt.error)}`)}` : ""}`,
+					},
+					theme,
+				),
+			);
+		}
+		return lines.map(line => truncateToWidth(line, width, Ellipsis.Unicode));
+	}, options);
+}
+
+function daemonMeta(daemon: DaemonSnapshot, theme: Theme): string[] {
+	const stateColor =
+		daemon.state === "ready" || daemon.state === "running"
+			? "success"
+			: daemon.state === "failed"
+				? "error"
+				: "warning";
+	const meta = [theme.fg(stateColor, daemon.state)];
+	if (daemon.pid !== undefined) meta.push(`pid ${daemon.pid}`);
+	meta.push(
+		`${daemon.exitedAt === undefined ? "up" : "ran"} ${formatDuration(Math.max(0, (daemon.exitedAt ?? Date.now()) - daemon.startedAt))}`,
+	);
+	if (daemon.detached) meta.push("detached");
+	else if (daemon.persist) meta.push("persistent");
+	return meta;
+}
+
+function jobRow(job: JobSnapshot, theme: Theme): string {
+	const icon = formatStatusIcon(
+		job.status === "cancelled"
+			? "aborted"
+			: job.status === "failed"
+				? "error"
+				: job.status === "running"
+					? "running"
+					: "done",
+		theme,
+	);
+	return `${icon} ${formatBadge(job.type, job.status === "failed" ? "error" : job.status === "cancelled" ? "warning" : "accent", theme)} ${theme.fg("toolOutput", safe(job.id))} ${theme.fg("dim", safe(job.label))} ${theme.fg("dim", formatDuration(job.durationMs))}`;
+}
+
+/** Render live and completed process writes with the URL-selected operation. */
+export function renderProcWrite(
+	id: string,
+	action: ProcWriteAction,
+	content: string | undefined,
+	result: ToolResult | undefined,
+	details: ProcWriteDetails | undefined,
+	options: RenderResultOptions,
+	theme: Theme,
+): Component {
+	return card((_width, expanded) => {
+		const title = `Proc ${action} ${safe(id || "…")}`;
+		const daemon = details && "daemon" in details ? details.daemon : undefined;
+		const header = renderStatusLine(
+			{
+				icon:
+					result === undefined ? "pending" : result.isError ? "error" : action === "kill" ? "aborted" : "success",
+				title,
+				meta: daemon ? daemonMeta(daemon, theme) : action === "mode" && content ? [safe(content)] : [],
+			},
+			theme,
+		);
+		if (result?.isError) return [header, formatErrorDetail(firstText(result) || "Process operation failed.", theme)];
+		const lines = [header];
+		if (content && action === "stdin") lines.push(...preview(content, expanded, theme));
+		if (details && "op" in details && details.op === "cancel") {
+			const jobs = details.jobs ?? [];
+			const outcomes = details.cancelled ?? [];
+			lines.push(
+				...renderTreeList(
+					{
+						items: outcomes,
+						expanded,
+						maxCollapsed: PREVIEW_LIMITS.COLLAPSED_ITEMS,
+						itemType: "job",
+						renderItem: outcome => {
+							const job = jobs.find(item => item.id === outcome.id);
+							return `${job ? `${jobRow(job, theme)} ` : `${theme.fg("toolOutput", safe(outcome.id))} `}${formatBadge(outcome.status, outcome.status === "cancelled" ? "warning" : "error", theme)}`;
+						},
+					},
+					theme,
+				),
+			);
+		}
+		return lines;
+	}, options);
+}
+
+export function renderProcRead(
+	id: string,
+	result: ToolResult | undefined,
+	details: ProcReadDetails | undefined,
+	options: RenderResultOptions,
+	theme: Theme,
+): Component {
+	return card((_width, expanded) => {
+		const title = id ? `Proc ${safe(id)}` : "Proc jobs & services";
+		const daemon = details?.daemon;
+		const header = renderStatusLine(
+			{
+				icon: result === undefined ? "pending" : result.isError ? "error" : "info",
+				title,
+				meta: daemon ? daemonMeta(daemon, theme) : [],
+			},
+			theme,
+		);
+		if (result?.isError) return [header, formatErrorDetail(firstText(result) || "Process read failed.", theme)];
+		if (!result) return [header];
+		if (details?.job)
+			return [
+				header,
+				jobRow(details.job, theme),
+				...preview(
+					details.log ?? details.job.errorText ?? details.job.resultText ?? "",
+					expanded,
+					theme,
+					"toolOutput",
+				),
+			];
+		if (daemon) {
+			const output = details.terminalRows ?? (details.log ?? "").split("\n").filter(Boolean);
+			const limit = expanded ? PREVIEW_LIMITS.EXPANDED_LINES : PREVIEW_LIMITS.COLLAPSED_LINES;
+			const visible = output
+				.slice(-limit)
+				.map(
+					line =>
+						`  ${styleTerminalRow(truncateToWidth(safe(line), TRUNCATE_LENGTHS.LINE, Ellipsis.Unicode), theme.fg("toolOutput", ""))}`,
+				);
+			if (output.length > limit) visible.unshift(theme.fg("dim", `  … ${output.length - limit} earlier lines`));
+			return [header, ...visible];
+		}
+		if (id && !details?.jobs && !details?.daemons && !details?.agents) {
+			return [header, ...preview(firstText(result), expanded, theme, "toolOutput")];
+		}
+		const jobs = details?.jobs ?? [];
+		const services = details?.daemons ?? [];
+		const agents = details?.agents ?? [];
+		const meta = [
+			`${jobs.length} jobs`,
+			`${services.length} services`,
+			...(agents.length ? [`${agents.length} agents`] : []),
+		];
+		const listHeader = renderStatusLine({ icon: "info", title, meta }, theme);
+		const items = [
+			...jobs.map(job => ({ label: jobRow(job, theme) })),
+			...services.map(service => ({
+				label: `${formatBadge("service", "accent", theme)} ${theme.fg("toolOutput", safe(service.name))} ${formatBadge(service.state, service.state === "failed" ? "error" : service.state === "ready" || service.state === "running" ? "success" : "warning", theme)} ${daemonMeta(service, theme).slice(1).join(theme.sep.dot)}`,
+			})),
+			...agents.map(agent => ({
+				label: `${formatBadge("agent", agent.live ? "accent" : "warning", theme)} ${theme.fg("toolOutput", safe(agent.id))} ${theme.fg("dim", formatDuration(agent.ageMs))}`,
+			})),
+		];
+		return [
+			listHeader,
+			...renderTreeList(
+				{
+					items,
+					expanded,
+					maxCollapsed: PREVIEW_LIMITS.COLLAPSED_ITEMS,
+					itemType: "process",
+					renderItem: item => item.label,
+				},
+				theme,
+			),
+			...(items.length ? [] : [theme.fg("dim", "No background jobs or services.")]),
+		];
+	}, options);
+}

package/src/tools/read.ts

@@ -4,7 +4,7 @@ import { LINE_RANGE_CHUNK_SOURCE, parseLineRanges } from "./line-ranges";
 import * as path from "node:path";
 import type { Component } from "../tui";
 import { Text } from "../components/text";
-import type { RenderResultOptions, ToolRenderer } from "./renderer";
+import type { RenderResultOptions, ToolActivityContext, ToolActivitySummary, ToolRenderer } from "./renderer";
 import { getLanguageFromPath } from "../lang-from-path";
 import type { Theme } from "../theme/theme";
 import { fileHyperlink, renderCodeCell, renderMarkdownCell, renderStatusLine } from "../render";
@@ -16,6 +16,7 @@ import { formatBytes, sanitizeDisplayLines, shortenPath, wrapBrackets } from "..
 
 import type { OutputMeta } from "./output-meta";
 import type { TruncationResult } from "./streaming-output";
+import { renderProcRead, type ProcReadDetails } from "./proc-render";
 
 /** Read result metadata retains truncation statistics, not a second copy of the body. */
 export type ReadTruncationStats = Omit<TruncationResult, "content">;
@@ -23,6 +24,7 @@ export type ReadTruncationStats = Omit<TruncationResult, "content">;
 /** Display metadata for file and URL reads. */
 export interface ReadToolDetails {
 	kind?: "file" | "url";
+	proc?: ProcReadDetails;
 	/** Filesystem hyperlink target resolved by the executing tool. */
 	displayTarget?: string;
 	truncation?: ReadTruncationStats;
@@ -91,6 +93,7 @@ const INTERNAL_SCHEMES_WITH_SELECTORS: Record<string, true> = {
 	memory: true,
 	omp: true,
 	pr: true,
+	proc: true,
 	rule: true,
 	security: true,
 	skill: true,
@@ -266,9 +269,19 @@ function formatReadPathLink(
 
 /** Render file, image, and URL reads in the transcript. */
 export const readToolRenderer = {
+	activitySummary(args: unknown, _context: ToolActivityContext): ToolActivitySummary {
+		const input = args as ReadRenderArgs | undefined;
+		const rawPath =
+			typeof input?.file_path === "string" ? input.file_path : typeof input?.path === "string" ? input.path : "";
+		if (/^proc:\/\//i.test(rawPath))
+			return { label: "Process", detail: rawPath.slice("proc://".length) || "jobs & services" };
+		return { label: "Read", detail: shortenPath(rawPath) };
+	},
 	renderCall(args: ReadRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component {
 		const rawPath =
 			typeof args.file_path === "string" ? args.file_path : typeof args.path === "string" ? args.path : "";
+		if (/^proc:\/\//i.test(rawPath))
+			return renderProcRead(rawPath.slice("proc://".length), undefined, undefined, _options, uiTheme);
 		if (isReadableUrlPath(rawPath)) {
 			return renderReadUrlCall({ path: rawPath, raw: args.raw }, _options, uiTheme);
 		}
@@ -296,6 +309,14 @@ export const readToolRenderer = {
 		const urlDetails = result.details as ReadUrlToolDetails | undefined;
 		const baseRawPathForKind =
 			typeof args?.file_path === "string" ? args.file_path : typeof args?.path === "string" ? args.path : "";
+		if (/^proc:\/\//i.test(baseRawPathForKind))
+			return renderProcRead(
+				baseRawPathForKind.slice("proc://".length),
+				result,
+				result.details?.proc,
+				options,
+				uiTheme,
+			);
 		if (urlDetails?.kind === "url" || isReadableUrlPath(baseRawPathForKind)) {
 			return renderReadUrlResult(
 				result as {

package/src/tools/task.ts

@@ -636,6 +636,18 @@ function renderDescriptionLines(description: string, prefix: string, width: numb
 	return wrapTextWithAnsi(description, contentWidth).map(line => `${boundedPrefix}${theme.fg("dim", line)}`);
 }
 
+/** `routed:` note from a `before_subagent_spawn` model replacement; empty when unrouted. */
+function renderRouteLine(route: string | undefined, continuePrefix: string, maxWidth: number, theme: Theme): string[] {
+	if (!route) return [];
+	return [
+		truncateTaskRow(
+			`${continuePrefix}${theme.fg("dim", `routed: ${replaceTabs(sanitizeText(route))}`)}`,
+			maxWidth,
+			"",
+		),
+	];
+}
+
 /**
  * Render streaming progress for a single agent.
  */
@@ -688,6 +700,7 @@ function renderAgentProgress(
 	if (fullDescription && !row.descriptionShown) {
 		lines.push(...renderDescriptionLines(fullDescription, continuePrefix, maxWidth, theme));
 	}
+	lines.push(...renderRouteLine(progress.resolvedModelRoute, continuePrefix, maxWidth, theme));
 
 	lines.push(...renderTaskSection(progress.assignment ?? progress.task, continuePrefix, expanded, theme));
 
@@ -1029,6 +1042,7 @@ function renderAgentResult(
 	if (fullDescription && !description) {
 		lines.push(...renderDescriptionLines(fullDescription, continuePrefix, maxWidth, theme));
 	}
+	lines.push(...renderRouteLine(result.resolvedModelRoute, continuePrefix, maxWidth, theme));
 
 	lines.push(...renderTaskSection(result.assignment ?? result.task, continuePrefix, expanded, theme));
 
@@ -1858,6 +1872,8 @@ export interface AgentProgress {
 	resolvedThinkingLevel?: ConfiguredThinkingLevel;
 	/** True when {@link resolvedModel} is the target of an active retry fallback (not the originally configured model). Lets observer-only UIs (collab guests, Agent Hub rows with no live session) flag the fallback and keep the provider. */
 	resolvedModelIsFallback?: boolean;
+	/** Extension routing note (e.g. model-pools) explaining why {@link resolvedModel} was chosen. */
+	resolvedModelRoute?: string;
 	/** True when a live advisor was attached to this run's session, not merely enabled in settings. */
 	advisor?: boolean;
 	/** Data extracted by registered subprocess tool handlers (keyed by tool name) */
@@ -1935,6 +1951,8 @@ export interface SingleResult {
 	resolvedThinkingLevel?: ConfiguredThinkingLevel;
 	/** True when {@link resolvedModel} is the target of an active retry fallback. Mirrors {@link AgentProgress.resolvedModelIsFallback} onto the settled result. */
 	resolvedModelIsFallback?: boolean;
+	/** Mirrors {@link AgentProgress.resolvedModelRoute} onto the settled result. */
+	resolvedModelRoute?: string;
 	/** Retains {@link AgentProgress.advisor} after the advised session is disposed. */
 	advisor?: boolean;
 	error?: string;