@bastani/atomic 0.9.16-alpha.2 → 0.9.16-alpha.3

package/dist/builtin/workflows/src/tui/stage-chat-view-transcript.ts

@@ -1,226 +0,0 @@
-import type { ChatMessageEntry } from "@bastani/atomic";
-import type { Component } from "@earendil-works/pi-tui";
-import type { StageNotice } from "../shared/store-types.js";
-import type { GraphTheme } from "./graph-theme.js";
-import type { NoticeEntry, TranscriptDebugEntry, TranscriptEntry } from "./stage-chat-view-types.js";
-import { renderWorkflowNoticeCard, type WorkflowNoticeTone } from "./workflow-notice-card.js";
-
-export function noticeSummary(n: StageNotice): string {
-	const base = `~ ${n.kind} → ${n.to}`;
-	return n.from ? `${base} (was ${n.from})` : base;
-}
-
-export function noticeRow(entry: NoticeEntry, theme: GraphTheme): Component {
-	return {
-		render(width: number): string[] {
-			return renderWorkflowNoticeCard({
-				...stageNoticeCard(entry),
-				fallbackText: entry.text,
-				width,
-				theme,
-			});
-		},
-		invalidate() {
-			/* notice entries are immutable */
-		},
-	};
-}
-
-export function transcriptDebugEntries(entry: TranscriptEntry): TranscriptDebugEntry[] {
-	if (isChatMessageEntry(entry) && entry.kind === "assistant") {
-		const entries: TranscriptDebugEntry[] = [];
-		const thinking = extractThinkingText(entry.message.content);
-		const text = extractMessageText(entry.message.content);
-		if (thinking) {
-			entries.push({
-				role: "thinking",
-				text: thinking,
-				toolCallId: "",
-				state: "",
-				output: "",
-			});
-		}
-		if (text || entries.length === 0) {
-			entries.push({ ...entry, text, toolCallId: "", state: "", output: "" });
-		}
-		return entries;
-	}
-	return [
-		{
-			...entry,
-			role: entry.role,
-			text: transcriptDebugText(entry),
-			toolCallId: transcriptDebugToolCallId(entry),
-			state: transcriptDebugToolState(entry),
-			output: transcriptDebugToolOutput(entry),
-		},
-	];
-}
-
-function transcriptDebugText(entry: TranscriptEntry): string {
-	if ("text" in entry && typeof entry.text === "string") return entry.text;
-	if (isChatMessageEntry(entry)) {
-		switch (entry.kind) {
-			case "assistant":
-				return extractMessageText(entry.message.content);
-			case "tool":
-				return entry.result
-					? extractToolResultText(entry.result)
-					: `${entry.toolName} ${typeof entry.args === "string" ? entry.args : JSON.stringify(entry.args ?? {})}`;
-			case "bashExecution":
-				return entry.message.output || entry.message.command;
-			case "user":
-			case "system":
-				return entry.text;
-			case "custom":
-				return extractMessageText(entry.message.content);
-			case "branchSummary":
-				return entry.message.summary;
-		}
-	}
-	return "";
-}
-
-function transcriptDebugToolCallId(entry: TranscriptEntry): string {
-	if (isChatMessageEntry(entry) && entry.kind === "tool") return entry.toolCallId;
-	if ("toolCallId" in entry && typeof entry.toolCallId === "string") {
-		return entry.toolCallId;
-	}
-	return "";
-}
-
-function transcriptDebugToolState(entry: TranscriptEntry): string {
-	if (isChatMessageEntry(entry) && entry.kind === "tool") {
-		if (entry.result?.isError) return "error";
-		return entry.isPartial === false ? "success" : "pending";
-	}
-	if ("state" in entry && typeof entry.state === "string") return entry.state;
-	return "";
-}
-
-function transcriptDebugToolOutput(entry: TranscriptEntry): string {
-	if (isChatMessageEntry(entry) && entry.kind === "tool") {
-		return entry.result ? extractToolResultText(entry.result) : "";
-	}
-	if ("output" in entry && typeof entry.output === "string") return entry.output;
-	return "";
-}
-
-function isChatMessageEntry(entry: TranscriptEntry): entry is ChatMessageEntry {
-	return "kind" in entry && entry.role !== "notice";
-}
-
-function extractThinkingText(content: unknown): string {
-	if (!Array.isArray(content)) return "";
-	const parts: string[] = [];
-	for (const item of content) {
-		if (item == null || typeof item !== "object") continue;
-		const thinking = (item as { type?: unknown; thinking?: unknown }).thinking;
-		if ((item as { type?: unknown }).type === "thinking" && typeof thinking === "string") {
-			parts.push(thinking);
-		}
-	}
-	return parts.join("\n\n");
-}
-
-function extractMessageText(content: unknown): string {
-	if (typeof content === "string") return content;
-	if (!Array.isArray(content)) return "";
-	const parts: string[] = [];
-	for (const item of content) {
-		if (item == null) continue;
-		if (typeof item === "string") {
-			parts.push(item);
-			continue;
-		}
-		const obj = item as { type?: unknown; text?: unknown };
-		if (typeof obj.text === "string") parts.push(obj.text);
-	}
-	return parts.join("");
-}
-
-function extractToolResultText(result: unknown): string {
-	if (typeof result === "string") return result;
-	if (result == null || typeof result !== "object") return "";
-	const content = (result as { content?: unknown }).content;
-	return extractMessageText(content);
-}
-
-function stageNoticeCard(entry: NoticeEntry): {
-	title: string;
-	glyph: string;
-	headline: string;
-	tone: WorkflowNoticeTone;
-	fields: Array<{
-		label: string;
-		value: string | undefined;
-		tone?: WorkflowNoticeTone | "text" | "muted";
-	}>;
-} {
-	switch (entry.kind) {
-		case "abort":
-			return {
-				title: "STAGE ABORTED",
-				glyph: "✗",
-				headline: "Stage received an abort notice",
-				tone: "error",
-				fields: stageNoticeFields(entry, "error"),
-			};
-		case "compaction":
-			return {
-				title: "STAGE COMPACTION",
-				glyph: "✓",
-				headline: "Stage context was compacted",
-				tone: "success",
-				fields: stageNoticeFields(entry, "muted"),
-			};
-		case "model":
-			return {
-				title: "STAGE MODEL",
-				glyph: "→",
-				headline: "Stage model changed",
-				tone: "info",
-				fields: stageNoticeFields(entry),
-			};
-		case "thinking":
-			return {
-				title: "STAGE THINKING",
-				glyph: "→",
-				headline: "Stage thinking level changed",
-				tone: "mauve",
-				fields: stageNoticeFields(entry),
-			};
-		case "tree":
-			return {
-				title: "STAGE TREE",
-				glyph: "◆",
-				headline: "Stage branch tree changed",
-				tone: "info",
-				fields: stageNoticeFields(entry, "muted"),
-			};
-		default:
-			return {
-				title: "STAGE NOTICE",
-				glyph: "◆",
-				headline: "Workflow stage notice",
-				tone: "info",
-				fields: stageNoticeFields(entry, "muted"),
-			};
-	}
-}
-
-function stageNoticeFields(
-	entry: NoticeEntry,
-	valueTone: WorkflowNoticeTone | "text" | "muted" = "text",
-): Array<{
-	label: string;
-	value: string | undefined;
-	tone?: WorkflowNoticeTone | "text" | "muted";
-}> {
-	return [
-		{ label: "kind", value: entry.kind, tone: "muted" },
-		{ label: "value", value: entry.value, tone: valueTone },
-		{ label: "from", value: entry.from, tone: "muted" },
-		{ label: "meta", value: entry.meta, tone: "muted" },
-	];
-}

package/dist/builtin/workflows/src/tui/stage-chat-view-types.ts

@@ -1,156 +0,0 @@
-import type {
-	ChatMessageEntry,
-	ChatMessageRenderOptions,
-	ChatSessionHost,
-	ReadonlyFooterDataProvider,
-} from "@bastani/atomic";
-import type { EditorComponent, EditorTheme, TUI } from "@earendil-works/pi-tui";
-import type { PostMortemUnavailableReason } from "../runs/foreground/postmortem-stage-chat.js";
-import type { StageControlHandle } from "../runs/foreground/stage-control-registry.js";
-import type { MountedStageCustomUi, StageUiBroker } from "../shared/stage-ui-broker.js";
-import type { Store } from "../shared/store.js";
-import type { RunStatus, StageNotice, StageStatus } from "../shared/store-types.js";
-import type { GraphTheme } from "./graph-theme.js";
-import type { PromptCardState } from "./prompt-card.js";
-
-/** Unhosted fallback frame height used when no host terminal supplies rows. */
-export const VIEW_LINE_COUNT = 32;
-export const PROMPT_SCROLL_STEP_ROWS = 4;
-/** Header rows reserved by prompt paging for the normal UUID continuation shape. */
-export const HEADER_ROWS = 2;
-export const SEP_ROWS = 1;
-
-export function isReadOnlyArchiveStatus(status: StageStatus): boolean {
-	return status === "completed" || status === "failed" || status === "skipped";
-}
-
-export interface StageChatViewOpts {
-	store: Store;
-	graphTheme: GraphTheme;
-	runId: string;
-	stageId: string;
-	/** The workflow display name, used in the title chrome `<workflow> / <stage>`. */
-	workflowName: string;
-	/** Unsent composer draft restored when reattaching to this stage. */
-	initialComposerDraft?: string;
-	/**
-	 * Live stage-control handle when available. When absent the chat is
-	 * inspect-only (settled stage with no live handle).
-	 */
-	handle?: StageControlHandle;
-	/** Why a retained terminal stage could not be reopened for follow-up chat. */
-	postMortemUnavailableReason?: PostMortemUnavailableReason;
-	/** Called when the user presses Ctrl+X (back to graph). */
-	onDetach: (reason?: StageChatDetachReason, metadata?: StageChatDetachMetadata) => void;
-	/** Called when the user presses Escape (close the whole popup). */
-	onClose: () => void;
-	/** Request a host TUI repaint after SDK events mutate local chat state. */
-	requestRender?: () => void;
-	/**
-	 * Re-assert overlay keyboard focus. Showing a stage custom UI (e.g. the
-	 * readiness gate) must make the overlay the focused pi-tui component again,
-	 * otherwise key events keep going elsewhere and the UI looks frozen (#1120).
-	 */
-	requestFocus?: () => void;
-	/** Live pi-tui host objects. When present, stage input uses pi's editor UI. */
-	piTui?: TUI;
-	piTheme?: unknown;
-	piKeybindings?: unknown;
-	/** Currently installed host editor factory, inherited from extension `ctx.ui.setEditorComponent()`. */
-	piEditorFactory?: (tui: TUI, theme: EditorTheme, keybindings: unknown) => EditorComponent;
-	/** Parent chat rendering settings and extension renderers inherited from the host UI. */
-	getChatRenderSettings?: () => Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">> | undefined;
-	/** Parent host expansion state for tool-output/live-detail widgets. */
-	getToolsExpanded?: () => boolean;
-	/** Toggle parent host expansion state for tool-output/live-detail widgets. */
-	setToolsExpanded?: (expanded: boolean) => void;
-	/** Parent footer data provider inherited from the host UI for core footer/usage rendering. */
-	footerData?: ReadonlyFooterDataProvider;
-	/** Broker that routes stage-local custom UI, such as ask_user_question, into this node. */
-	stageUiBroker?: StageUiBroker;
-	/**
-	 * Ownership guard for prompt submission. The attach shell uses this to ensure
-	 * stale/hidden/non-active stage-chat instances cannot settle a prompt unless
-	 * the user is currently attached to this exact workflow node.
-	 */
-	canSubmitPrompt?: (runId: string, stageId: string, promptId: string) => boolean;
-}
-
-export type StageChatDetachReason = "user" | "prompt-resolved";
-
-export interface StageChatDetachMetadata {
-	readonly suppressNextGraphSubmit?: boolean;
-}
-
-export interface NoticeEntry {
-	readonly role: "notice";
-	readonly text: string;
-	readonly noticeId: string;
-	readonly kind: StageNotice["kind"];
-	readonly value: string;
-	readonly from?: string;
-	readonly meta?: string;
-}
-
-export type TranscriptEntry = NoticeEntry | ChatMessageEntry;
-
-export interface TranscriptDebugEntry {
-	readonly role: string;
-	readonly text: string;
-	readonly toolCallId: string;
-	readonly state: string;
-	readonly output: string;
-}
-
-export interface PaintOpts {
-	bold?: boolean;
-	italic?: boolean;
-	bg?: string;
-}
-
-export interface StageChatViewContext {
-	focused: boolean;
-	store: Store;
-	theme: GraphTheme;
-	runId: string;
-	stageId: string;
-	workflowName: string;
-	handle: StageControlHandle | undefined;
-	postMortemUnavailableReason: PostMortemUnavailableReason | undefined;
-	onDetach: (reason?: StageChatDetachReason, metadata?: StageChatDetachMetadata) => void;
-	onClose: () => void;
-	requestRender: (() => void) | undefined;
-	requestFocus: (() => void) | undefined;
-	focusHoldTimer: ReturnType<typeof setInterval> | undefined;
-	piTui: TUI | undefined;
-	piTheme: unknown;
-	piKeybindings: unknown;
-	piEditorFactory: StageChatViewOpts["piEditorFactory"] | undefined;
-	getToolsExpanded: (() => boolean) | undefined;
-	setToolsExpanded: ((expanded: boolean) => void) | undefined;
-	footerData: ReadonlyFooterDataProvider | undefined;
-	chatHost: ChatSessionHost<NoticeEntry>;
-	stageUiBroker: StageUiBroker;
-	canSubmitPrompt: ((runId: string, stageId: string, promptId: string) => boolean) | undefined;
-	mountedCustomUi: MountedStageCustomUi | null;
-	mountingRequestId: string | null;
-	promptState: PromptCardState | null;
-	promptEditor: EditorComponent | null;
-	promptEditorPromptId: string | null;
-	promptEditorSubmitFromEnter: boolean;
-	promptScrollOffset: number;
-	promptMaxScroll: number;
-	promptVisibleRows: number;
-	localPaused: boolean;
-	lastObservedStageStatus: StageStatus | undefined;
-	lastObservedRunStatus: RunStatus | undefined;
-	seenNoticeIds: Set<string>;
-	deliveryLifecycles: Map<number, number | undefined>;
-	/** True once this chat observed a terminal transition and cleaned up in-flight work. */
-	terminalLifecycleFenced: boolean;
-	_unsubscribeStore: (() => void) | null;
-	_unsubscribeHandle: (() => void) | null;
-	_unsubscribeDeliveryActivity: (() => void) | null;
-	_unsubscribeFooterData: (() => void) | null;
-	_unregisterStageUiHost: (() => void) | null;
-}

package/dist/builtin/workflows/src/tui/stage-chat-view.ts

@@ -1,309 +0,0 @@
-/**
- * StageChatView — attached workflow-stage chat surface.
- *
- * This file is the compatibility facade for the historical
- * `src/tui/stage-chat-view.js` import path. The implementation is split by
- * responsibility into sibling `stage-chat-view-*` modules so each authored
- * source file stays focused while preserving the
- * same public class, options, detach metadata, and test seams.
- *
- * Behaviour:
- *  - Idle stage (empty transcript, not streaming, not settled): Enter prompts.
- *  - Running live stages: Enter steers, Ctrl+F queues a follow-up, Escape uses
- *    the host chat interrupt path.
- *  - Paused stages: Enter resumes with composer text; Ctrl+X returns to graph.
- *  - Blocked and read-only archive stages absorb mutation keystrokes.
- *  - Workflow notices and prompt/custom UI panels keep workflow-specific chrome.
- *
- * cross-ref:
- *  - ui/stage-chat-mockup.html (canonical visual)
- *  - DESIGN.md §5 (Components — pill / box / banner vocabulary)
- *  - src/runs/foreground/stage-control-registry.ts (StageControlHandle)
- *  - src/shared/store-types.ts (StageSnapshot.notices, StageNotice)
- *  - https://pi.dev/docs/latest/tui (canonical Pi-tui component contract)
- */
-
-import { keyText, TranscriptFollowIndicator } from "@bastani/atomic";
-import type { Component, Focusable } from "@earendil-works/pi-tui";
-import { fitStageChatFrame, planStageChatFrame } from "./stage-chat-layout.js";
-import {
-	renderBlockedBody,
-	renderPausedBody,
-	renderPromptBody,
-	renderReadOnlyArchiveBody,
-} from "./stage-chat-view-archive-history.js";
-import { renderCustomUi } from "./stage-chat-view-custom-ui.js";
-import {
-	renderFooterWithOrchestratorReturnHint,
-	renderHeader,
-	renderReadOnlyArchiveFooter,
-	sepRule,
-} from "./stage-chat-view-footer-status.js";
-import { handleStageChatInput } from "./stage-chat-view-input.js";
-import { blankLine, takeRows } from "./stage-chat-view-render-helpers.js";
-import {
-	currentStage,
-	disposeStageChatView,
-	initializeStageChatView,
-	invalidateStageChatView,
-	isBlocked,
-	isPaused,
-	isReadOnlyArchive,
-	syncPromptState,
-	viewLineCount,
-} from "./stage-chat-view-state.js";
-import { transcriptDebugEntries } from "./stage-chat-view-transcript.js";
-import {
-	SEP_ROWS,
-	type StageChatViewContext,
-	type StageChatViewOpts,
-	type TranscriptDebugEntry,
-} from "./stage-chat-view-types.js";
-
-export type {
-	StageChatDetachMetadata,
-	StageChatDetachReason,
-	StageChatViewOpts,
-} from "./stage-chat-view-types.js";
-
-export class StageChatView implements Component, Focusable {
-	focused = true;
-	private store!: StageChatViewContext["store"];
-	private theme!: StageChatViewContext["theme"];
-	private runId!: StageChatViewContext["runId"];
-	private stageId!: StageChatViewContext["stageId"];
-	private workflowName!: StageChatViewContext["workflowName"];
-	private handle!: StageChatViewContext["handle"];
-	private postMortemUnavailableReason!: StageChatViewContext["postMortemUnavailableReason"];
-	private onDetach!: StageChatViewContext["onDetach"];
-	private onClose!: StageChatViewContext["onClose"];
-	private requestRender!: StageChatViewContext["requestRender"];
-	private requestFocus!: StageChatViewContext["requestFocus"];
-	private focusHoldTimer!: StageChatViewContext["focusHoldTimer"];
-	private piTui!: StageChatViewContext["piTui"];
-	private piTheme!: StageChatViewContext["piTheme"];
-	private piKeybindings!: StageChatViewContext["piKeybindings"];
-	private piEditorFactory!: StageChatViewContext["piEditorFactory"];
-	private getToolsExpanded!: StageChatViewContext["getToolsExpanded"];
-	private setToolsExpanded!: StageChatViewContext["setToolsExpanded"];
-	private footerData!: StageChatViewContext["footerData"];
-	private chatHost!: StageChatViewContext["chatHost"];
-	private stageUiBroker!: StageChatViewContext["stageUiBroker"];
-	private canSubmitPrompt!: StageChatViewContext["canSubmitPrompt"];
-	private mountedCustomUi!: StageChatViewContext["mountedCustomUi"];
-	private mountingRequestId!: StageChatViewContext["mountingRequestId"];
-	private promptState!: StageChatViewContext["promptState"];
-	private promptEditor!: StageChatViewContext["promptEditor"];
-	private promptEditorPromptId!: StageChatViewContext["promptEditorPromptId"];
-	private promptEditorSubmitFromEnter!: StageChatViewContext["promptEditorSubmitFromEnter"];
-	private promptScrollOffset!: StageChatViewContext["promptScrollOffset"];
-	private promptMaxScroll!: StageChatViewContext["promptMaxScroll"];
-	private promptVisibleRows!: StageChatViewContext["promptVisibleRows"];
-	private localPaused!: StageChatViewContext["localPaused"];
-	private seenNoticeIds!: StageChatViewContext["seenNoticeIds"];
-	private _unsubscribeStore!: StageChatViewContext["_unsubscribeStore"];
-	private _unsubscribeHandle!: StageChatViewContext["_unsubscribeHandle"];
-	private _unsubscribeFooterData!: StageChatViewContext["_unsubscribeFooterData"];
-	private _unregisterStageUiHost!: StageChatViewContext["_unregisterStageUiHost"];
-
-	constructor(opts: StageChatViewOpts) {
-		initializeStageChatView(this._ctx(), opts);
-	}
-
-	render(width: number): string[] {
-		const ctx = this._ctx();
-		const w = Math.max(40, width);
-		const stage = currentStage(ctx);
-		const blocked = isBlocked(ctx);
-
-		const customUiActive = this.mountedCustomUi !== null;
-		syncPromptState(ctx, stage?.pendingPrompt);
-		const promptActive = !customUiActive && this.promptState !== null;
-		const readOnlyArchive = isReadOnlyArchive(ctx, stage);
-		const chatChromeHidden = customUiActive || promptActive || readOnlyArchive || blocked;
-		this.chatHost.focused = this.focused;
-		const headerLines = renderHeader(ctx, w, stage);
-		const sepLines = [sepRule(ctx, w)];
-
-		const customUiLines = customUiActive ? renderCustomUi(ctx, w) : [];
-		const pendingLines = chatChromeHidden ? [] : this.chatHost.renderPendingMessages(w);
-		const workingLines = chatChromeHidden ? [] : this.chatHost.renderWorkingStatus(w);
-		const usageLines = chatChromeHidden ? [] : this.chatHost.renderUsage(w);
-		const editorLines = chatChromeHidden ? [] : this.chatHost.renderEditor(w);
-		const footerLines =
-			customUiActive || promptActive
-				? []
-				: readOnlyArchive
-					? renderReadOnlyArchiveFooter(ctx, w)
-					: renderFooterWithOrchestratorReturnHint(ctx, w, this.chatHost.renderFooter(w));
-
-		const totalRows = viewLineCount(ctx);
-		const plan = planStageChatFrame({
-			viewportRows: totalRows,
-			headerRows: headerLines.length,
-			separatorRows: SEP_ROWS,
-			pendingRows: pendingLines.length,
-			workingRows: workingLines.length,
-			usageRows: usageLines.length,
-			editorRows: customUiActive ? customUiLines.length : editorLines.length,
-			footerRows: footerLines.length,
-		});
-		const visiblePendingLines = takeRows(pendingLines, plan.pendingRows);
-		const visibleWorkingLines = workingLines.slice(Math.max(0, workingLines.length - plan.workingRows));
-		const visibleUsageLines = takeRows(usageLines, plan.usageRows);
-		const editorSlotLines = customUiActive ? customUiLines : editorLines;
-		const visibleEditorLines = takeRows(editorSlotLines, plan.editorRows);
-		const visibleFooterLines = takeRows(footerLines, plan.footerRows);
-		const bodyBudget = plan.bodyRows;
-		if (blocked) this.chatHost.scrollToBottom();
-
-		let bodyLines: string[];
-		let transcriptBodyActive = false;
-		let reservedIndicatorLines: readonly string[] = [];
-		const indicator = new TranscriptFollowIndicator({
-			isFollowing: () => this.chatHost.bodyScrollFromBottom() === 0,
-			keyLabel: () => keyText("tui.altScreen.bottom"),
-		});
-		const renderTranscript = (rows: number): string[] => this.chatHost.renderBody(w, rows);
-		if (bodyBudget <= 0) {
-			bodyLines = [];
-		} else if (promptActive) {
-			bodyLines = renderPromptBody(ctx, w, bodyBudget);
-		} else if (blocked) {
-			bodyLines = renderBlockedBody(ctx, w, bodyBudget, stage);
-		} else if (!readOnlyArchive && isPaused(ctx, stage)) {
-			reservedIndicatorLines = bodyBudget > 1 ? indicator.render(w) : [];
-			bodyLines = renderPausedBody(
-				ctx,
-				w,
-				bodyBudget,
-				reservedIndicatorLines,
-				() => indicator.render(w),
-				renderTranscript,
-			);
-		} else if (readOnlyArchive) {
-			reservedIndicatorLines = bodyBudget > 1 ? indicator.render(w) : [];
-			bodyLines = renderReadOnlyArchiveBody(
-				ctx,
-				w,
-				bodyBudget,
-				stage,
-				reservedIndicatorLines,
-				() => indicator.render(w),
-				renderTranscript,
-			);
-		} else {
-			transcriptBodyActive = true;
-			bodyLines = renderTranscript(bodyBudget);
-		}
-		const indicatorLines = transcriptBodyActive && bodyBudget > 1 ? indicator.render(w) : [];
-		const indicatorVisible = indicatorLines.length > 0;
-		const dropBodyRow = transcriptBodyActive && indicatorVisible && bodyLines.length >= bodyBudget;
-		// The indicator's row comes out of the body, and the end it comes from
-		// decides which rows the reader can reach at all. Taken off the top, the
-		// first transcript row is unpaintable: the reader is already parked as
-		// high as the viewport goes and the row is still clipped. A body already
-		// parked at row zero therefore gives up its last row instead. Either way
-		// the body is rendered at the full budget, which is what keeps the
-		// viewport size — and the page arithmetic that reads it — stable while
-		// the indicator is visible.
-		const parkedAtTop = this.chatHost.bodyMaxScroll() - this.chatHost.bodyScrollFromBottom() <= 0;
-		const visibleBodyLines = dropBodyRow
-			? parkedAtTop
-				? bodyLines.slice(0, bodyBudget - 1)
-				: bodyLines.slice(1, bodyBudget)
-			: bodyLines.slice(0, bodyBudget);
-		const lines = [
-			...headerLines,
-			...sepLines,
-			...visibleBodyLines,
-			...indicatorLines,
-			...visiblePendingLines,
-			...visibleWorkingLines,
-			...visibleUsageLines,
-			...visibleEditorLines,
-			...visibleFooterLines,
-		];
-		return fitStageChatFrame(lines, totalRows, blankLine(w));
-	}
-
-	handleInput(data: string): boolean {
-		return handleStageChatInput(this._ctx(), data);
-	}
-
-	invalidate(): void {
-		invalidateStageChatView(this._ctx());
-	}
-
-	dispose(): void {
-		disposeStageChatView(this._ctx());
-	}
-
-	private _ctx(): StageChatViewContext {
-		// Helper modules operate on the same runtime object; these reads keep the
-		// private fields visible to noUnusedLocals while preserving the historical
-		// non-public TypeScript surface of StageChatView.
-		void this.store;
-		void this.theme;
-		void this.runId;
-		void this.stageId;
-		void this.workflowName;
-		void this.handle;
-		void this.postMortemUnavailableReason;
-		void this.onDetach;
-		void this.onClose;
-		void this.requestRender;
-		void this.requestFocus;
-		void this.focusHoldTimer;
-		void this.piTui;
-		void this.piTheme;
-		void this.piKeybindings;
-		void this.piEditorFactory;
-		void this.getToolsExpanded;
-		void this.setToolsExpanded;
-		void this.footerData;
-		void this.stageUiBroker;
-		void this.canSubmitPrompt;
-		void this.mountingRequestId;
-		void this.promptEditor;
-		void this.promptEditorPromptId;
-		void this.promptEditorSubmitFromEnter;
-		void this.promptScrollOffset;
-		void this.promptMaxScroll;
-		void this.promptVisibleRows;
-		void this.seenNoticeIds;
-		void this._unsubscribeStore;
-		void this._unsubscribeHandle;
-		void this._unsubscribeFooterData;
-		void this._unregisterStageUiHost;
-		return this as unknown as StageChatViewContext;
-	}
-
-	get _inputBuffer(): string {
-		return this.chatHost.inputText();
-	}
-
-	get _transcript(): ReadonlyArray<TranscriptDebugEntry> {
-		return this.chatHost.entries().flatMap((entry) => transcriptDebugEntries(entry));
-	}
-
-	get _statusMessage(): string {
-		return this.chatHost.statusText();
-	}
-
-	get _isLocalPaused(): boolean {
-		return this.localPaused;
-	}
-
-	get _hasAnimationTick(): boolean {
-		return this.chatHost.hasAnimationTick();
-	}
-
-	get _bodyScrollFromBottom(): number {
-		return this.chatHost.bodyScrollFromBottom();
-	}
-
-	get _lastBodyMaxScroll(): number {
-		return this.chatHost.bodyMaxScroll();
-	}
-}