pi-subagents 0.69.0 → 0.70.0

package/src/intercom/result-intercom.ts

@@ -1,423 +0,0 @@
-import { randomUUID } from "node:crypto";
-import * as fs from "node:fs";
-import { isUnexplainedProcessSignal } from "../runs/shared/process-signal.ts";
-import {
-	type Details,
-	type IntercomEventBus,
-	type NestedRunSummary,
-	type PublicNestedRunSummary,
-	type ParallelHandoffReference,
-	type SingleResult,
-	type SubagentResultIntercomChild,
-	type SubagentResultIntercomPayload,
-	type SubagentResultStatus,
-	type SubagentOutputState,
-	type SubagentRunMode,
-	SUBAGENT_RESULT_INTERCOM_DELIVERY_EVENT,
-	SUBAGENT_RESULT_INTERCOM_EVENT,
-} from "../shared/types.ts";
-
-export function resolveSubagentResultStatus(input: {
-	exitCode?: number;
-	success?: boolean;
-	state?: string;
-	interrupted?: boolean;
-	detached?: boolean;
-	processSignal?: string | null;
-	timedOut?: boolean;
-	stopped?: boolean;
-	turnBudgetExceeded?: boolean;
-}): SubagentResultStatus {
-	if (input.detached) return "detached";
-	if (input.stopped || input.state === "stopped") return "stopped";
-	if (input.interrupted || input.state === "paused") return "paused";
-	if (input.success === true) return "completed";
-	if (isUnexplainedProcessSignal(input) && input.exitCode !== 0) return "stopped";
-	if (input.success === false) return "failed";
-	if (input.state === "complete") return "completed";
-	if (input.state === "failed") return "failed";
-	if (typeof input.exitCode === "number") return input.exitCode === 0 ? "completed" : "failed";
-	return "failed";
-}
-
-function countStatuses(children: SubagentResultIntercomChild[]): Record<SubagentResultStatus, number> {
-	const counts: Record<SubagentResultStatus, number> = {
-		completed: 0,
-		failed: 0,
-		paused: 0,
-		stopped: 0,
-		detached: 0,
-	};
-	for (const child of children) {
-		counts[child.status] += 1;
-	}
-	return counts;
-}
-
-function formatStatusCounts(counts: Record<SubagentResultStatus, number>): string {
-	const parts = [
-		counts.completed ? `${counts.completed} completed` : undefined,
-		counts.failed ? `${counts.failed} failed` : undefined,
-		counts.stopped ? `${counts.stopped} stopped` : undefined,
-		counts.paused ? `${counts.paused} paused` : undefined,
-		counts.detached ? `${counts.detached} detached` : undefined,
-	].filter((part): part is string => Boolean(part));
-	return parts.length ? parts.join(", ") : "0 results";
-}
-
-function countOutputStates(children: SubagentResultIntercomChild[]): Record<SubagentOutputState, number> {
-	const counts: Record<SubagentOutputState, number> = { present: 0, absent: 0, unknown: 0 };
-	for (const child of children) counts[child.outputState ?? "unknown"] += 1;
-	return counts;
-}
-
-function formatOutputCounts(counts: Record<SubagentOutputState, number>): string {
-	const parts = [
-		counts.present ? `${counts.present} present` : undefined,
-		counts.absent ? `${counts.absent} absent` : undefined,
-		counts.unknown ? `${counts.unknown} unknown` : undefined,
-	].filter((part): part is string => Boolean(part));
-	return parts.length ? parts.join(", ") : "0 outputs";
-}
-
-function resolveGroupedStatus(children: SubagentResultIntercomChild[]): SubagentResultStatus {
-	const counts = countStatuses(children);
-	if (counts.failed > 0) return "failed";
-	if (counts.stopped > 0) return "stopped";
-	if (counts.paused > 0) return "paused";
-	if (counts.completed > 0) return "completed";
-	if (counts.detached > 0) return "detached";
-	return "failed";
-}
-
-function compactNestedRun(run: NestedRunSummary | PublicNestedRunSummary, depth = 0): PublicNestedRunSummary {
-	return {
-		id: run.id,
-		parentRunId: run.parentRunId,
-		...(run.parentStepIndex !== undefined ? { parentStepIndex: run.parentStepIndex } : {}),
-		...(run.parentAgent ? { parentAgent: run.parentAgent } : {}),
-		depth: run.depth,
-		path: run.path.slice(0, 4).map((part) => ({
-			runId: part.runId,
-			...(part.stepIndex !== undefined ? { stepIndex: part.stepIndex } : {}),
-			...(part.agent ? { agent: part.agent } : {}),
-		})),
-		...(run.asyncDir ? { asyncDir: run.asyncDir } : {}),
-		...(run.sessionId ? { sessionId: run.sessionId } : {}),
-		...(run.sessionName ? { sessionName: run.sessionName } : {}),
-		...(run.sessionFile ? { sessionFile: run.sessionFile } : {}),
-		...(run.intercomTarget ? { intercomTarget: run.intercomTarget } : {}),
-		...(run.ownerIntercomTarget ? { ownerIntercomTarget: run.ownerIntercomTarget } : {}),
-		...(run.leafIntercomTarget ? { leafIntercomTarget: run.leafIntercomTarget } : {}),
-		...(run.ownerState ? { ownerState: run.ownerState } : {}),
-		...(run.mode ? { mode: run.mode } : {}),
-		state: run.state,
-		...(run.agent ? { agent: run.agent } : {}),
-		...(run.agents?.length ? { agents: run.agents.slice(0, 12) } : {}),
-		...(run.model ? { model: run.model } : {}),
-		...(run.thinking ? { thinking: run.thinking } : {}),
-		...(run.currentStep !== undefined ? { currentStep: run.currentStep } : {}),
-		...(run.chainStepCount !== undefined ? { chainStepCount: run.chainStepCount } : {}),
-		...(run.parallelGroups?.length ? { parallelGroups: run.parallelGroups.slice(0, 8) } : {}),
-		...(run.activityState ? { activityState: run.activityState } : {}),
-		...(run.lastActivityAt !== undefined ? { lastActivityAt: run.lastActivityAt } : {}),
-		...(run.currentTool ? { currentTool: run.currentTool } : {}),
-		...(run.currentToolStartedAt !== undefined ? { currentToolStartedAt: run.currentToolStartedAt } : {}),
-		...(run.currentPath ? { currentPath: run.currentPath } : {}),
-		...(run.turnCount !== undefined ? { turnCount: run.turnCount } : {}),
-		...(run.toolCount !== undefined ? { toolCount: run.toolCount } : {}),
-		...(run.totalTokens ? { totalTokens: run.totalTokens } : {}),
-		...(run.startedAt !== undefined ? { startedAt: run.startedAt } : {}),
-		...(run.endedAt !== undefined ? { endedAt: run.endedAt } : {}),
-		...(run.lastUpdate !== undefined ? { lastUpdate: run.lastUpdate } : {}),
-		...(run.error ? { error: run.error } : {}),
-		...(run.steps?.length ? { steps: run.steps.slice(0, 12).map((step) => ({
-			agent: step.agent,
-			...(step.sessionName ? { sessionName: step.sessionName } : {}),
-			status: step.status,
-			...(step.model ? { model: step.model } : {}),
-			...(step.thinking ? { thinking: step.thinking } : {}),
-			...(step.sessionFile ? { sessionFile: step.sessionFile } : {}),
-			...(step.activityState ? { activityState: step.activityState } : {}),
-			...(step.lastActivityAt !== undefined ? { lastActivityAt: step.lastActivityAt } : {}),
-			...(step.currentTool ? { currentTool: step.currentTool } : {}),
-			...(step.currentToolStartedAt !== undefined ? { currentToolStartedAt: step.currentToolStartedAt } : {}),
-			...(step.currentPath ? { currentPath: step.currentPath } : {}),
-			...(step.turnCount !== undefined ? { turnCount: step.turnCount } : {}),
-			...(step.toolCount !== undefined ? { toolCount: step.toolCount } : {}),
-			...(step.startedAt !== undefined ? { startedAt: step.startedAt } : {}),
-			...(step.endedAt !== undefined ? { endedAt: step.endedAt } : {}),
-			...(step.error ? { error: step.error } : {}),
-			...(depth < 2 && step.children?.length ? { children: step.children.slice(0, 8).map((child) => compactNestedRun(child, depth + 1)) } : {}),
-		})) } : {}),
-		...(depth < 2 && run.children?.length ? { children: run.children.slice(0, 8).map((child) => compactNestedRun(child, depth + 1)) } : {}),
-	};
-}
-
-export function compactNestedResultChildren(children: Array<NestedRunSummary | PublicNestedRunSummary> | undefined): PublicNestedRunSummary[] | undefined {
-	if (!children?.length) return undefined;
-	return children.slice(0, 16).map((child) => compactNestedRun(child));
-}
-
-export function attachNestedChildrenToResultChildren(
-	runId: string,
-	children: SubagentResultIntercomChild[],
-	nestedChildren: NestedRunSummary[] | undefined,
-): SubagentResultIntercomChild[] {
-	const compact = compactNestedResultChildren(nestedChildren);
-	if (!compact?.length) return children.map((child) => ({ ...child, children: compactNestedResultChildren(child.children) }));
-	return children.map((child, index) => {
-		const childIndex = child.index ?? index;
-		const alreadyAttachedIds = new Set(child.children?.map((nested) => nested.id) ?? []);
-		const attached = compact.filter((nested) => nested.parentRunId === runId && nested.parentStepIndex === childIndex && !alreadyAttachedIds.has(nested.id));
-		const fallbackAttached = children.length === 1
-			? compact.filter((nested) => nested.parentRunId === runId && nested.parentStepIndex === undefined && !alreadyAttachedIds.has(nested.id))
-			: [];
-		const merged = compactNestedResultChildren([...(child.children ?? []), ...attached, ...fallbackAttached]);
-		return merged?.length ? { ...child, children: merged } : { ...child, children: undefined };
-	});
-}
-
-function formatNestedResultLines(children: PublicNestedRunSummary[] | undefined): string[] {
-	if (!children?.length) return [];
-	const lines = ["Nested subagents:"];
-	let remaining = 10;
-	const append = (runs: PublicNestedRunSummary[] | undefined, indent: string): void => {
-		for (const run of runs ?? []) {
-			if (remaining <= 0) {
-				lines.push(`${indent}↳ +more nested runs; inspect status for full tree`);
-				return;
-			}
-			remaining--;
-			const label = run.agent ?? run.agents?.join("+") ?? run.id;
-			lines.push(`${indent}↳ ${label} — ${run.state} [${run.id}]`);
-			if (run.sessionFile) lines.push(`${indent}  Session: ${run.sessionFile}`);
-			append(run.children, `${indent}  `);
-			for (const step of run.steps ?? []) append(step.children, `${indent}    `);
-		}
-	};
-	append(children, "");
-	return lines;
-}
-
-interface GroupedResultIntercomMessageInput {
-	to: string;
-	runId: string;
-	mode: SubagentRunMode;
-	source: "foreground" | "async";
-	children: SubagentResultIntercomChild[];
-	asyncId?: string;
-	asyncDir?: string;
-	chainSteps?: number;
-	parallelHandoff?: ParallelHandoffReference;
-}
-
-function asyncResumeGuidance(input: {
-	source: "foreground" | "async";
-	children: SubagentResultIntercomChild[];
-	asyncId?: string;
-}): string | undefined {
-	if (input.source !== "async" || !input.asyncId) return undefined;
-	const resumable = input.children.filter((child) => typeof child.sessionPath === "string" && fs.existsSync(child.sessionPath));
-	if (input.children.length === 1 && resumable.length === 1) {
-		return `Revive: subagent({ action: "resume", id: "${input.asyncId}", message: "..." })`;
-	}
-	if (resumable.length > 0) {
-		const firstIndex = resumable[0]?.index ?? input.children.indexOf(resumable[0]!);
-		return `Revive child: subagent({ action: "resume", id: "${input.asyncId}", index: ${firstIndex}, message: "..." })`;
-	}
-	return "Resume: unavailable; no child session file was persisted.";
-}
-
-function formatSubagentResultIntercomMessage(input: {
-	runId: string;
-	mode: SubagentRunMode;
-	status: SubagentResultStatus;
-	source: "foreground" | "async";
-	children: SubagentResultIntercomChild[];
-	asyncId?: string;
-	asyncDir?: string;
-	chainSteps?: number;
-	parallelHandoff?: ParallelHandoffReference;
-}): string {
-	const counts = countStatuses(input.children);
-	const outputCounts = countOutputStates(input.children);
-	const lines: string[] = [
-		"subagent results",
-		"",
-		`Run: ${input.runId}`,
-		`Mode: ${input.mode}`,
-		`Process status: ${input.status}`,
-		`Children: ${formatStatusCounts(counts)}`,
-		`Outputs: ${formatOutputCounts(outputCounts)} (semantic adequacy unassessed)`,
-	];
-	if (input.children.some((child) => child.status === "failed" && child.outputState === "present")) {
-		lines.push("Recovery: At least one failed process produced output. Inspect that output before retrying; output presence does not establish task completion.");
-	}
-	if (input.mode === "chain" && typeof input.chainSteps === "number") {
-		lines.push(`Chain steps: ${input.chainSteps}`);
-	}
-	if (input.asyncId) lines.push(`Async id: ${input.asyncId}`);
-	if (input.asyncDir) lines.push(`Async dir: ${input.asyncDir}`);
-	if (input.parallelHandoff) lines.push(`Parallel handoff: ${input.parallelHandoff.path}`);
-	const resumeGuidance = asyncResumeGuidance(input);
-	if (resumeGuidance) lines.push(resumeGuidance);
-	if (input.children.some((child) => child.intercomTarget)) {
-		lines.push("");
-		lines.push(input.source === "async"
-			? "Previous intercom targets below identify child sessions used while they were running. Inspect artifacts or session logs if resume is unavailable."
-			: "Intercom targets below identify child sessions used while they were running; completed child sessions may no longer be reachable. Inspect artifacts or session logs for follow-up.");
-	}
-
-	for (let index = 0; index < input.children.length; index++) {
-		const child = input.children[index]!;
-		lines.push("");
-		lines.push(`${index + 1}. ${child.agent} — process ${child.status} · output ${child.outputState ?? "unknown"}`);
-		if (child.intercomTarget) lines.push(`${input.source === "async" ? "Previous intercom target" : "Run intercom target"}: ${child.intercomTarget}`);
-		if (child.artifactPath) lines.push(`Output artifact: ${child.artifactPath}`);
-		if (child.sessionPath) lines.push(`Session: ${child.sessionPath}`);
-		lines.push(...formatNestedResultLines(child.children));
-		lines.push("Summary:");
-		lines.push(child.summary);
-	}
-
-	return lines.join("\n");
-}
-
-export function buildSubagentResultIntercomPayload(input: GroupedResultIntercomMessageInput): SubagentResultIntercomPayload {
-	const children = input.children.map((child) => ({
-		...child,
-		outputState: child.outputState ?? "unknown",
-		summary: child.summary.trim() || "(no output)",
-		children: compactNestedResultChildren(child.children),
-	}));
-	const status = resolveGroupedStatus(children);
-	const summary = formatStatusCounts(countStatuses(children));
-	const firstChild = children[0];
-	const payload: SubagentResultIntercomPayload = {
-		to: input.to,
-		runId: input.runId,
-		mode: input.mode,
-		status,
-		summary,
-		source: input.source,
-		children,
-		...(input.asyncId ? { asyncId: input.asyncId } : {}),
-		...(input.asyncDir ? { asyncDir: input.asyncDir } : {}),
-		...(typeof input.chainSteps === "number" ? { chainSteps: input.chainSteps } : {}),
-		...(input.parallelHandoff ? { parallelHandoff: input.parallelHandoff } : {}),
-		...(firstChild?.agent ? { agent: firstChild.agent } : {}),
-		...(firstChild?.index !== undefined ? { index: firstChild.index } : {}),
-		...(firstChild?.artifactPath ? { artifactPath: firstChild.artifactPath } : {}),
-		...(firstChild?.sessionPath ? { sessionPath: firstChild.sessionPath } : {}),
-		message: "",
-	};
-	payload.message = formatSubagentResultIntercomMessage(payload);
-	return payload;
-}
-
-export async function deliverSubagentResultIntercomEvent(
-	events: IntercomEventBus,
-	payload: SubagentResultIntercomPayload,
-	timeoutMs = 500,
-): Promise<boolean> {
-	return deliverSubagentIntercomMessageEvent(events, payload.to, payload.message, timeoutMs, payload as unknown as Record<string, unknown>);
-}
-
-export async function deliverSubagentIntercomMessageEvent(
-	events: IntercomEventBus,
-	to: string,
-	message: string,
-	timeoutMs = 500,
-	extra: Record<string, unknown> = {},
-): Promise<boolean> {
-	if (typeof events.on !== "function" || typeof events.emit !== "function") return false;
-	const requestId = typeof extra.requestId === "string" ? extra.requestId : randomUUID();
-	return new Promise((resolve) => {
-		let settled = false;
-		let unsubscribe: (() => void) | undefined;
-		let timer: ReturnType<typeof setTimeout> | undefined;
-		const finish = (delivered: boolean) => {
-			if (settled) return;
-			settled = true;
-			if (timer) clearTimeout(timer);
-			unsubscribe?.();
-			resolve(delivered);
-		};
-		unsubscribe = events.on(SUBAGENT_RESULT_INTERCOM_DELIVERY_EVENT, (data) => {
-			if (!data || typeof data !== "object") return;
-			const delivery = data as { requestId?: unknown; delivered?: unknown };
-			if (delivery.requestId !== requestId) return;
-			finish(delivery.delivered === true);
-		});
-		timer = setTimeout(() => finish(false), timeoutMs);
-		try {
-			events.emit(SUBAGENT_RESULT_INTERCOM_EVENT, { ...extra, to, message, requestId });
-		} catch {
-			finish(false);
-		}
-	});
-}
-
-function stripSingleResultOutputs(result: SingleResult): SingleResult {
-	return {
-		...result,
-		messages: undefined,
-		finalOutput: undefined,
-		truncation: undefined,
-	};
-}
-
-export function stripDetailsOutputsForIntercomReceipt(details: Details): Details {
-	return {
-		...details,
-		results: details.results.map(stripSingleResultOutputs),
-	};
-}
-
-export function formatSubagentResultReceipt(input: {
-	mode: SubagentRunMode;
-	runId: string;
-	payload: SubagentResultIntercomPayload;
-}): string {
-	const counts = countStatuses(input.payload.children);
-	const modeLabel = input.mode === "single"
-		? "single subagent result"
-		: input.mode === "parallel"
-			? "parallel subagent results"
-			: "chain subagent results";
-	const lines = [
-		`Delivered ${modeLabel} via intercom.`,
-		`Run: ${input.runId}`,
-		`Children: ${formatStatusCounts(counts)}`,
-	];
-
-	if (input.payload.parallelHandoff) lines.push(`Parallel handoff: ${input.payload.parallelHandoff.path}`);
-
-	const artifacts = input.payload.children.filter((child) => typeof child.artifactPath === "string");
-	if (artifacts.length > 0) {
-		lines.push("Artifacts:");
-		for (const child of artifacts) {
-			lines.push(`- ${child.agent} [${child.status}]: ${child.artifactPath}`);
-		}
-	}
-
-	const intercomTargets = input.payload.children.filter((child) => typeof child.intercomTarget === "string");
-	if (intercomTargets.length > 0) {
-		lines.push("Run intercom targets (may be inactive after completion):");
-		for (const child of intercomTargets) {
-			lines.push(`- ${child.agent} [${child.status}]: ${child.intercomTarget}`);
-		}
-	}
-
-	const sessions = input.payload.children.filter((child) => typeof child.sessionPath === "string");
-	if (sessions.length > 0) {
-		lines.push("Sessions:");
-		for (const child of sessions) {
-			lines.push(`- ${child.agent} [${child.status}]: ${child.sessionPath}`);
-		}
-	}
-
-	lines.push("Full grouped output was sent over intercom.");
-	return lines.join("\n");
-}

package/src/intercom/supervisor-ui.ts

@@ -1,244 +0,0 @@
-import type { EntryRenderOptions, MessageRenderOptions, Theme } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component } from "@earendil-works/pi-tui";
-import { safeTerminalText } from "../shared/display-text.ts";
-
-export const SUPERVISOR_REQUEST_MESSAGE_TYPE = "subagent_supervisor_request";
-export const SUPERVISOR_REPLY_ENTRY_TYPE = "subagent_supervisor_reply";
-
-export type SupervisorReason = "need_decision" | "interview_request" | "progress_update";
-
-export interface SupervisorRequestMessageDetails {
-	id?: string;
-	requestId?: string;
-	reason?: SupervisorReason;
-	expectsReply?: boolean;
-	runId?: string;
-	agent?: string;
-	childIndex?: number;
-	childTarget?: string;
-	interview?: unknown;
-	requestBody?: string;
-	replyHint?: string;
-}
-
-export interface SupervisorReplyEntryData {
-	requestId: string;
-	reason?: SupervisorReason;
-	runId: string;
-	agent: string;
-	childIndex: number;
-	childTarget?: string;
-	message: string;
-	createdAt: number;
-}
-
-interface SupervisorMessageLike {
-	content: unknown;
-	details?: unknown;
-}
-
-interface SupervisorEntryLike {
-	data?: unknown;
-}
-
-const MAX_FIELD_CHARS = 512;
-const MAX_BODY_CHARS = 8_000;
-const MAX_INTERVIEW_CHARS = 4_000;
-const MAX_RENDER_LINES = 36;
-const TRUNCATION_MARKER = "[truncated]";
-
-export function supervisorReplyHint(requestId: string): string {
-	return `subagent_supervisor({ action: "reply", replyTo: "${requestId}", message: "..." })`;
-}
-
-function boundedText(value: string, maxChars: number): string {
-	const safe = safeTerminalText(value);
-	if (safe.length <= maxChars) return safe;
-	const prefixLength = Math.max(0, maxChars - TRUNCATION_MARKER.length - 1);
-	let prefix = "";
-	for (const character of safe) {
-		if (prefix.length + character.length > prefixLength) break;
-		prefix += character;
-	}
-	return `${prefix} ${TRUNCATION_MARKER}`;
-}
-
-function displayText(value: string, maxChars: number, expanded: boolean): string {
-	return expanded ? safeTerminalText(value) : boundedText(value, maxChars);
-}
-
-function boundedField(value: unknown, fallback = "unknown"): string {
-	return boundedText(typeof value === "string" ? value : value === undefined ? fallback : String(value), MAX_FIELD_CHARS);
-}
-
-function contentText(content: unknown): string {
-	if (typeof content === "string") return content;
-	if (!Array.isArray(content)) return "";
-	return content
-		.map((part) => {
-			if (!part || typeof part !== "object") return "";
-			const text = (part as { text?: unknown }).text;
-			return typeof text === "string" ? text : "";
-		})
-		.filter(Boolean)
-		.join("\n");
-}
-
-function interviewText(interview: unknown, expanded: boolean): string {
-	let serialized: string;
-	try {
-		serialized = JSON.stringify(interview, null, 2) ?? String(interview);
-	} catch {
-		serialized = "[unavailable]";
-	}
-	return displayText(serialized, MAX_INTERVIEW_CHARS, expanded);
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-function isSupervisorReason(value: unknown): value is SupervisorReason {
-	return value === "need_decision" || value === "interview_request" || value === "progress_update";
-}
-
-function optionalString(value: unknown): boolean {
-	return value === undefined || typeof value === "string";
-}
-
-function requestDetails(value: unknown): SupervisorRequestMessageDetails | undefined {
-	if (!isRecord(value)) return undefined;
-	if (!optionalString(value.id) || !optionalString(value.requestId) || !optionalString(value.replyHint) || !optionalString(value.requestBody) || !optionalString(value.runId) || !optionalString(value.agent) || !optionalString(value.childTarget)) return undefined;
-	if (value.reason !== undefined && !isSupervisorReason(value.reason)) return undefined;
-	if (value.expectsReply !== undefined && typeof value.expectsReply !== "boolean") return undefined;
-	if (value.childIndex !== undefined && (typeof value.childIndex !== "number" || !Number.isFinite(value.childIndex))) return undefined;
-	return value;
-}
-
-function replyData(value: unknown): SupervisorReplyEntryData | undefined {
-	if (!isRecord(value)) return undefined;
-	if (typeof value.requestId !== "string" || typeof value.runId !== "string" || typeof value.agent !== "string" || typeof value.message !== "string") return undefined;
-	if (value.reason !== undefined && !isSupervisorReason(value.reason)) return undefined;
-	if (value.childTarget !== undefined && typeof value.childTarget !== "string") return undefined;
-	if (typeof value.childIndex !== "number" || !Number.isFinite(value.childIndex) || typeof value.createdAt !== "number" || !Number.isFinite(value.createdAt)) return undefined;
-	return {
-		requestId: value.requestId,
-		...(value.reason === undefined ? {} : { reason: value.reason }),
-		runId: value.runId,
-		agent: value.agent,
-		childIndex: value.childIndex,
-		...(value.childTarget === undefined ? {} : { childTarget: value.childTarget }),
-		message: value.message,
-		createdAt: value.createdAt,
-	};
-}
-
-function withRequestId(details: SupervisorRequestMessageDetails): string {
-	return boundedField(details.requestId ?? details.id);
-}
-
-function requestHeading(reason: SupervisorReason | undefined): string {
-	if (reason === "interview_request") return "⚠ Supervisor interview request";
-	if (reason === "progress_update") return "ℹ Supervisor progress update";
-	return "⚠ Supervisor decision request";
-}
-
-function requestLines(message: SupervisorMessageLike, details: SupervisorRequestMessageDetails, expanded: boolean): string[] {
-	const requestId = withRequestId(details);
-	const lines = [
-		`Reason: ${boundedField(details.reason)}`,
-		`Run: ${boundedField(details.runId)}`,
-		`Agent: ${boundedField(details.agent)}`,
-		`Child index: ${boundedField(details.childIndex)}`,
-	];
-	if (details.childTarget) lines.push(`Child target: ${boundedField(details.childTarget)}`);
-	lines.push(`Request ID: ${requestId}`);
-	if (details.expectsReply) lines.push(`Reply with: ${displayText(details.replyHint ?? supervisorReplyHint(requestId), MAX_BODY_CHARS, expanded)}`);
-	lines.push("", "Request:", displayText((details.requestBody ?? contentText(message.content)) || "(no request body)", MAX_BODY_CHARS, expanded));
-	if (details.interview !== undefined) lines.push("", "Interview shape:", interviewText(details.interview, expanded));
-	return lines;
-}
-
-function replyLines(data: SupervisorReplyEntryData, expanded: boolean): string[] {
-	const requestId = boundedField(data.requestId);
-	const lines = [
-		...(data.reason ? [`Reason: ${boundedField(data.reason)}`] : []),
-		`Run: ${boundedField(data.runId)}`,
-		`Agent: ${boundedField(data.agent)}`,
-		`Child index: ${boundedField(data.childIndex)}`,
-	];
-	if (data.childTarget) lines.push(`Child target: ${boundedField(data.childTarget)}`);
-	lines.push(`Reply to: ${requestId}`, "", "Reply:", displayText(data.message || "(empty reply)", MAX_BODY_CHARS, expanded));
-	return lines;
-}
-
-function renderCard(lines: string[], heading: string, theme: Theme, width: number, expanded: boolean): string[] {
-	const safeWidth = Math.max(0, Math.floor(width));
-	if (safeWidth < 3) return [truncateToWidth(heading, safeWidth, "")];
-	const bodyWidth = safeWidth - 2;
-	const headerText = truncateToWidth(` ${heading} `, bodyWidth, "");
-	const headerPadding = Math.max(0, bodyWidth - visibleWidth(headerText));
-	const border = (text: string) => theme.fg("accent", text);
-	const rendered = [border(`╭${headerText}${"─".repeat(headerPadding)}╮`)];
-	let hidden = false;
-	let interiorLines = 0;
-	for (const line of lines) {
-		const wrapped = wrapTextWithAnsi(line, Math.max(1, bodyWidth));
-		for (const wrappedLine of wrapped.length > 0 ? wrapped : [""]) {
-			if (!expanded && interiorLines >= MAX_RENDER_LINES) {
-				hidden = true;
-				break;
-			}
-			const text = truncateToWidth(wrappedLine, bodyWidth, "");
-			rendered.push(border(`│${text}${" ".repeat(Math.max(0, bodyWidth - visibleWidth(text)))}│`));
-			interiorLines++;
-		}
-		if (hidden) break;
-	}
-	if (hidden) {
-		const text = truncateToWidth(TRUNCATION_MARKER, bodyWidth, "");
-		rendered.push(border(`│${text}${" ".repeat(Math.max(0, bodyWidth - visibleWidth(text)))}│`));
-	}
-	rendered.push(border(`╰${"─".repeat(bodyWidth)}╯`));
-	return rendered;
-}
-
-class SupervisorCardComponent implements Component {
-	private readonly expanded: boolean;
-	private readonly heading: string;
-	private readonly lines: string[];
-	private readonly theme: Theme;
-
-	constructor(heading: string, lines: string[], theme: Theme, expanded: boolean) {
-		this.expanded = expanded;
-		this.heading = heading;
-		this.lines = lines;
-		this.theme = theme;
-	}
-
-	invalidate(): void {}
-
-	render(width: number): string[] {
-		return renderCard(this.lines, this.heading, this.theme, width, this.expanded);
-	}
-}
-
-export function renderSupervisorRequest(
-	message: SupervisorMessageLike,
-	options: MessageRenderOptions,
-	theme: Theme,
-): Component | undefined {
-	const details = requestDetails(message.details);
-	if (!details) return undefined;
-	return new SupervisorCardComponent(requestHeading(details.reason), requestLines(message, details, options.expanded), theme, options.expanded);
-}
-
-export function renderSupervisorReply(
-	entry: SupervisorEntryLike,
-	options: EntryRenderOptions,
-	theme: Theme,
-): Component | undefined {
-	const data = replyData(entry.data);
-	if (!data) return undefined;
-	return new SupervisorCardComponent("↩ Supervisor reply to child", replyLines(data, options.expanded), theme, options.expanded);
-}