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

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

@@ -1,462 +0,0 @@
-import { Box, Text } from "@earendil-works/pi-tui";
-import type { PendingPrompt, StageSnapshot } from "../shared/store-types.js";
-import { renderRoundedBoxLines } from "./chat-surface.js";
-import { hexToAnsi, RESET } from "./color-utils.js";
-import {
-	type PromptCardLayout,
-	renderPromptCardLayout,
-	renderPromptIdentityBanner,
-	renderPromptRunIdBanner,
-} from "./prompt-card-render.js";
-import { bannerLines, embedOrchestratorReturnHintInWidget } from "./stage-chat-view-footer-status.js";
-import {
-	blankLine,
-	paint,
-	renderHintsForPrompt,
-	setEditorBorderColor,
-	setEditorFocused,
-} from "./stage-chat-view-render-helpers.js";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-
-function postMortemUnavailableMessage(reason: StageChatViewContext["postMortemUnavailableReason"]): string | undefined {
-	switch (reason) {
-		case "no_adapter":
-			return "Post-mortem chat is unavailable because no agent session adapter is configured.";
-		case "not_terminal":
-			return "Post-mortem chat is available only after the stage completes.";
-		case "no_session":
-			return "No retained agent session is available for this stage.";
-		case "invalid_session":
-			return "The retained session is missing, unreadable, or invalid. Check that the session file still exists and is readable.";
-		case undefined:
-			return undefined;
-	}
-}
-
-/**
- * `renderTranscript` paints the archived chat rows into the budget it is given.
- * `StageChatView` passes the search-aware painter so an open find box searches
- * and highlights a read-only archive exactly as it does a live chat; the
- * default keeps this function usable on its own.
- */
-export function renderReadOnlyArchiveBody(
-	ctx: StageChatViewContext,
-	width: number,
-	budget: number,
-	stage: StageSnapshot | undefined,
-	indicatorLines: readonly string[] = [],
-	renderIndicator: () => readonly string[] = () => indicatorLines,
-	renderTranscript: (rows: number) => string[] = (rows) => ctx.chatHost.renderBody(width, rows),
-): string[] {
-	if (stage?.promptFootprint) {
-		return renderReadOnlyPromptArchiveBody(ctx, width, budget, stage);
-	}
-
-	const t = ctx.theme;
-	const unavailableMessage = postMortemUnavailableMessage(ctx.postMortemUnavailableReason);
-	const callout: string[] = [];
-	callout.push(blankLine(width));
-	callout.push(
-		...bannerLines(
-			ctx,
-			width,
-			unavailableMessage === undefined ? "info" : "warning",
-			unavailableMessage === undefined ? "◌" : "!",
-			unavailableMessage === undefined ? "READ-ONLY SESSION" : "SESSION UNAVAILABLE",
-			unavailableMessage === undefined
-				? stage?.sessionFile
-					? "archived transcript"
-					: "no live chat session"
-				: "post-mortem chat cannot be reopened",
-		),
-	);
-	callout.push(
-		...new Text(
-			paint(unavailableMessage ?? "This node is no longer attached to a live chat session.", t.textMuted),
-			2,
-			0,
-		).render(width),
-	);
-	const transcriptBudget = Math.max(0, budget - callout.length);
-	const reservedIndicatorRows =
-		indicatorLines.length > 0 && transcriptBudget > indicatorLines.length ? indicatorLines.length : 0;
-	const transcriptRows = transcriptBudget - reservedIndicatorRows;
-	const lines = transcriptRows > 0 ? renderTranscript(transcriptRows) : [];
-	const visibleIndicatorLines =
-		reservedIndicatorRows > 0 ? [...renderIndicator().slice(0, reservedIndicatorRows)] : [];
-	while (visibleIndicatorLines.length < reservedIndicatorRows) visibleIndicatorLines.push(blankLine(width));
-	lines.push(...visibleIndicatorLines, ...callout);
-	while (lines.length < budget) lines.push(blankLine(width));
-	if (lines.length > budget) lines.length = budget;
-	return lines;
-}
-
-function renderReadOnlyPromptArchiveBody(
-	ctx: StageChatViewContext,
-	width: number,
-	budget: number,
-	stage: StageSnapshot,
-): string[] {
-	const t = ctx.theme;
-	const prompt = stage.promptFootprint;
-	if (!prompt) return fitBodyLines(width, budget, []);
-
-	const innerWidth = Math.max(2, width - 2);
-	const bodyLines: string[] = [];
-	const messageBox = new Box(2, 1);
-	messageBox.addChild(new Text(paint(prompt.message, t.text), 0, 0));
-	bodyLines.push(...messageBox.render(innerWidth));
-	bodyLines.push(
-		...new Text(paint("prompt type", t.textMuted, { bold: true }) + paint(`  ${prompt.kind}`, t.text), 2, 0).render(
-			innerWidth,
-		),
-	);
-
-	if (prompt.kind === "select" && prompt.choices && prompt.choices.length > 0) {
-		bodyLines.push(...new Text(paint("choices", t.textMuted, { bold: true }), 2, 0).render(innerWidth));
-		for (const choice of prompt.choices) {
-			bodyLines.push(...new Text(paint("• ", t.dim) + paint(choice, t.text), 4, 0).render(innerWidth));
-		}
-	} else if (prompt.kind === "confirm") {
-		bodyLines.push(
-			...new Text(paint("choices", t.textMuted, { bold: true }) + paint("  yes / no", t.text), 2, 0).render(
-				innerWidth,
-			),
-		);
-	}
-
-	if ((prompt.kind === "input" || prompt.kind === "editor") && prompt.initial && prompt.initial.length > 0) {
-		bodyLines.push(...new Text(paint("initial value shown", t.textMuted, { bold: true }), 2, 0).render(innerWidth));
-		bodyLines.push(...new Text(paint(prompt.initial, t.dim), 4, 0).render(innerWidth));
-	}
-
-	const answer = readOnlyPromptAnswer(ctx, stage, prompt);
-	bodyLines.push("");
-	bodyLines.push(...new Text(paint("your response", t.textMuted, { bold: true }), 2, 0).render(innerWidth));
-	bodyLines.push(...new Text(paint(answer, answer.startsWith("(") ? t.dim : t.text), 4, 0).render(innerWidth));
-	bodyLines.push("");
-
-	const title = stage.status === "skipped" ? "QUESTION SKIPPED" : "QUESTION ASKED";
-	const cardLines = renderRoundedBoxLines({
-		title,
-		bodyLines,
-		width,
-		theme: t,
-		accent: t.border,
-	});
-	return fitPromptBodyLines(ctx, cardLines, width, budget);
-}
-
-function readOnlyPromptAnswer(ctx: StageChatViewContext, stage: StageSnapshot, prompt: PendingPrompt): string {
-	const answer = ctx.store.getStagePromptAnswer(ctx.runId, stage.id);
-	if (answer && answer.promptId === prompt.id) {
-		return formatReadOnlyPromptAnswer(answer.value, prompt.kind);
-	}
-	switch (stage.promptAnswerState) {
-		case "ambiguous":
-			return "(response replay is ambiguous)";
-		case "unavailable":
-			return "(response unavailable)";
-		case "available":
-			return "(response no longer in live memory)";
-		default:
-			return "(no response saved)";
-	}
-}
-
-function formatReadOnlyPromptAnswer(value: unknown, kind: PendingPrompt["kind"]): string {
-	if (kind === "confirm") return value === true ? "yes" : "no";
-	if (typeof value === "string") return value.length > 0 ? value : "(empty response)";
-	if (typeof value === "number" || typeof value === "boolean" || value === null) {
-		return String(value);
-	}
-	try {
-		const encoded = JSON.stringify(value);
-		return encoded ?? String(value);
-	} catch {
-		return String(value);
-	}
-}
-
-/** `renderTranscript` as in `renderReadOnlyArchiveBody`: a paused chat is searchable too. */
-export function renderPausedBody(
-	ctx: StageChatViewContext,
-	width: number,
-	budget: number,
-	indicatorLines: readonly string[] = [],
-	renderIndicator: () => readonly string[] = () => indicatorLines,
-	renderTranscript: (rows: number) => string[] = (rows) => ctx.chatHost.renderBody(width, rows),
-): string[] {
-	const t = ctx.theme;
-	const callout: string[] = [];
-	callout.push(blankLine(width));
-	callout.push(...bannerLines(ctx, width, "warning", "❚❚", "PAUSED", "enter resumes · ctrl+x return to graph"));
-	callout.push(
-		...new Text(
-			paint("This workflow stage is paused. Type a message below and press Enter to resume.", t.textMuted),
-			2,
-			0,
-		).render(width),
-	);
-	const calloutRows = Math.min(callout.length, Math.max(0, budget));
-	const transcriptBudget = Math.max(0, budget - calloutRows);
-	const reservedIndicatorRows =
-		indicatorLines.length > 0 && transcriptBudget > indicatorLines.length ? indicatorLines.length : 0;
-	const transcriptRows = transcriptBudget - reservedIndicatorRows;
-	const lines = transcriptRows > 0 ? renderTranscript(transcriptRows) : [];
-	const visibleIndicatorLines =
-		reservedIndicatorRows > 0 ? [...renderIndicator().slice(0, reservedIndicatorRows)] : [];
-	while (visibleIndicatorLines.length < reservedIndicatorRows) visibleIndicatorLines.push(blankLine(width));
-	lines.push(...visibleIndicatorLines, ...callout.slice(0, calloutRows));
-	while (lines.length < budget) lines.push(blankLine(width));
-	if (lines.length > budget) lines.length = budget;
-	return lines;
-}
-
-export function renderBlockedBody(
-	ctx: StageChatViewContext,
-	width: number,
-	budget: number,
-	stage: StageSnapshot | undefined,
-): string[] {
-	const t = ctx.theme;
-	const upstream = stage?.blockedByStageId ?? "upstream stage";
-	const lines: string[] = [];
-	lines.push(...bannerLines(ctx, width, "warning", "↑", "BLOCKED", `waiting on ${upstream}`));
-	lines.push(blankLine(width));
-	lines.push(
-		...new Text(paint("This stage is waiting for the upstream stage to resume.", t.textMuted), 2, 0).render(width),
-	);
-	lines.push(
-		...new Text(paint("ctrl+x", t.accent, { bold: true }) + paint(" return to graph", t.textMuted), 2, 0).render(
-			width,
-		),
-	);
-	while (lines.length < budget) lines.push(blankLine(width));
-	if (lines.length > budget) lines.length = budget;
-	return lines;
-}
-
-export function renderPromptBody(ctx: StageChatViewContext, width: number, budget: number): string[] {
-	const primitiveLayout = renderPrimitivePromptBody(ctx, width, budget);
-	if (primitiveLayout) {
-		return fitPromptBodyLines(
-			ctx,
-			embedPromptReturnHint(ctx, primitiveLayout.lines, width),
-			width,
-			budget,
-			Math.max(0, primitiveLayout.totalQuestionRows - primitiveLayout.visibleQuestionRows),
-			true,
-			primitiveLayout.visibleQuestionRows,
-		);
-	}
-
-	const state = ctx.promptState;
-	if (!state) return fitPromptBodyLines(ctx, [], width, budget);
-	const layout = renderPromptCardLayout({
-		state,
-		theme: ctx.theme,
-		width,
-		cursorOn: ctx.focused,
-		identity: { runId: ctx.runId, name: ctx.workflowName },
-		maxRows: budget,
-		messageOffset: ctx.promptScrollOffset,
-	});
-	return fitPromptBodyLines(
-		ctx,
-		embedPromptReturnHint(ctx, layout.lines, width),
-		width,
-		budget,
-		Math.max(0, layout.totalQuestionRows - layout.visibleQuestionRows),
-		true,
-		layout.visibleQuestionRows,
-	);
-}
-
-function embedPromptReturnHint(ctx: StageChatViewContext, lines: readonly string[], width: number): string[] {
-	return lines.length < 3 ? [...lines] : embedOrchestratorReturnHintInWidget(ctx, lines, width);
-}
-
-function renderPrimitivePromptBody(ctx: StageChatViewContext, width: number, budget: number): PromptCardLayout | null {
-	const state = ctx.promptState;
-	const editor = ctx.promptEditor;
-	if (!state || !editor) return null;
-	setEditorFocused(editor, ctx.focused);
-	setEditorBorderColor(editor, (text) => hexToAnsi(ctx.theme.accent) + text + RESET);
-
-	const innerWidth = Math.max(2, width - 2);
-	const messageLines = new Text(paint(state.prompt.message, ctx.theme.text), 2, 0).render(innerWidth);
-	const responseLines = new Text(paint("response", ctx.theme.textMuted, { bold: true }), 2, 0).render(innerWidth);
-	const editorLines = editor.render(Math.max(20, innerWidth - 4)).map((line) => `  ${line}`);
-	const hintLines = new Text(renderHintsForPrompt(state.prompt.kind, ctx.theme), 2, 0).render(innerWidth);
-	const identity = { runId: ctx.runId, name: ctx.workflowName };
-	const unattributed = renderPrimitivePromptBlockLayout(
-		ctx,
-		width,
-		budget,
-		"AWAITING INPUT",
-		messageLines,
-		responseLines,
-		editorLines,
-		hintLines,
-	);
-	const minimumPromptRows = 2 + editorLines.length + hintLines.length + (messageLines.length > 0 ? 1 : 0);
-	// Same degradation ladder as the standard prompt surface: two identity rows,
-	// then the run id alone, then no banner. The middle rung matters most here,
-	// because the editor and hint rows leave the least room for attribution.
-	const banners = [
-		renderPromptIdentityBanner(identity, ctx.theme, width),
-		renderPromptRunIdBanner(identity, ctx.theme, width),
-	];
-	for (const banner of banners) {
-		const promptBudget = Math.max(0, budget - banner.length);
-		const attributed = renderPrimitivePromptBlockLayout(
-			ctx,
-			width,
-			promptBudget,
-			"",
-			messageLines,
-			responseLines,
-			editorLines,
-			hintLines,
-		);
-		if (
-			banner.length + minimumPromptRows > budget ||
-			attributed.visibleQuestionRows === 0 ||
-			attributed.visibleQuestionRows < unattributed.visibleQuestionRows
-		) {
-			continue;
-		}
-		return {
-			lines: [...banner, ...attributed.lines],
-			totalQuestionRows: attributed.totalQuestionRows,
-			visibleQuestionRows: attributed.visibleQuestionRows,
-		};
-	}
-	return unattributed;
-}
-
-function renderPrimitivePromptBlockLayout(
-	ctx: StageChatViewContext,
-	width: number,
-	maxRows: number,
-	title: string,
-	messageLines: readonly string[],
-	responseLines: readonly string[],
-	editorLines: readonly string[],
-	hintLines: readonly string[],
-): PromptCardLayout {
-	const totalQuestionRows = messageLines.length;
-	if (maxRows === 0) return { lines: [], totalQuestionRows, visibleQuestionRows: 0 };
-	const fixedRows = 2 + editorLines.length + hintLines.length;
-	if (maxRows < fixedRows + (totalQuestionRows > 0 ? 1 : 0)) {
-		return renderReducedPrimitivePrompt(ctx, width, maxRows, messageLines, title);
-	}
-
-	let remaining = maxRows - fixedRows;
-	let messageCount = totalQuestionRows > 0 ? 1 : 0;
-	remaining -= messageCount;
-	const includeResponse = remaining >= responseLines.length;
-	if (includeResponse) remaining -= responseLines.length;
-	const extraMessageRows = Math.min(remaining, Math.max(0, totalQuestionRows - messageCount));
-	messageCount += extraMessageRows;
-	remaining -= extraMessageRows;
-	const includeBlank = remaining > 0;
-	const safeOffset = Math.min(ctx.promptScrollOffset, Math.max(0, totalQuestionRows - messageCount));
-	const bodyLines = [
-		...messageLines.slice(safeOffset, safeOffset + messageCount),
-		...(includeResponse ? responseLines : []),
-		...editorLines,
-		...(includeBlank ? [""] : []),
-		...hintLines,
-	];
-	return {
-		lines: renderPrimitivePromptBlock(ctx, width, title, bodyLines),
-		totalQuestionRows,
-		visibleQuestionRows: messageCount,
-	};
-}
-
-function renderReducedPrimitivePrompt(
-	ctx: StageChatViewContext,
-	width: number,
-	maxRows: number,
-	messageLines: readonly string[],
-	title: string,
-): PromptCardLayout {
-	const totalQuestionRows = messageLines.length;
-	const compactTitle = "AWAITING INPUT";
-	if (maxRows === 1) {
-		return {
-			lines: [paint(`${compactTitle} · enter Submit`, ctx.theme.textMuted, { bold: true })],
-			totalQuestionRows,
-			visibleQuestionRows: 0,
-		};
-	}
-	if (maxRows === 2) {
-		const closed = renderPrimitivePromptBlock(ctx, width, compactTitle, []);
-		return {
-			lines: [closed[0]!, closed.at(-1)!],
-			totalQuestionRows,
-			visibleQuestionRows: 0,
-		};
-	}
-
-	const availableBodyRows = maxRows - 2;
-	const supportingRows = availableBodyRows >= 3 ? 2 : Math.max(0, availableBodyRows - 1);
-	const messageCount = Math.min(totalQuestionRows, Math.max(1, availableBodyRows - supportingRows));
-	const safeOffset = Math.min(ctx.promptScrollOffset, Math.max(0, totalQuestionRows - messageCount));
-	const responseLine = paint(
-		availableBodyRows >= 3 ? "  response" : "  response · enter Submit",
-		ctx.theme.textMuted,
-		{ bold: true },
-	);
-	const hintLine = renderHintsForPrompt(ctx.promptState?.prompt.kind ?? "input", ctx.theme);
-	return {
-		lines: renderPrimitivePromptBlock(ctx, width, maxRows < 5 ? compactTitle : title || "AWAITING INPUT", [
-			...messageLines.slice(safeOffset, safeOffset + messageCount),
-			...(availableBodyRows >= 2 ? [responseLine] : []),
-			...(availableBodyRows >= 3 ? [hintLine] : []),
-		]),
-		totalQuestionRows,
-		visibleQuestionRows: messageCount,
-	};
-}
-function renderPrimitivePromptBlock(
-	ctx: StageChatViewContext,
-	width: number,
-	title: string,
-	bodyLines: readonly string[],
-): string[] {
-	return renderRoundedBoxLines({
-		title,
-		bodyLines,
-		width,
-		theme: ctx.theme,
-		accent: ctx.theme.border,
-	});
-}
-
-export function fitPromptBodyLines(
-	ctx: StageChatViewContext,
-	lines: readonly string[],
-	width: number,
-	budget: number,
-	maxScroll = Math.max(0, lines.length - budget),
-	scrollApplied = false,
-	visibleRows = Math.min(lines.length, budget),
-): string[] {
-	ctx.promptMaxScroll = Math.max(0, maxScroll);
-	ctx.promptVisibleRows = Math.max(0, visibleRows);
-	ctx.promptScrollOffset = Math.max(0, Math.min(ctx.promptScrollOffset, ctx.promptMaxScroll));
-	const start = scrollApplied ? 0 : ctx.promptScrollOffset;
-	const framed = lines.slice(start, start + budget);
-	while (framed.length < budget) framed.push(blankLine(width));
-	return framed;
-}
-
-function fitBodyLines(width: number, budget: number, lines: readonly string[]): string[] {
-	const framed = lines.slice(0, budget);
-	while (framed.length < budget) framed.push(blankLine(width));
-	return framed;
-}

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

@@ -1,115 +0,0 @@
-import { mountStageCustomUi, type StageCustomUiRequest } from "../shared/stage-ui-broker.js";
-import { embedOrchestratorReturnHintInWidget } from "./stage-chat-view-footer-status.js";
-import { setComponentFocused } from "./stage-chat-view-render-helpers.js";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-
-export async function showCustomUi(ctx: StageChatViewContext, request: StageCustomUiRequest): Promise<void> {
-	ctx.mountedCustomUi?.component.dispose?.();
-	ctx.mountedCustomUi = null;
-	// Track the request currently being mounted. `mountStageCustomUi` is async,
-	// so the broker can resolve/reject/abort the request (clearing it via
-	// `hideMountedCustomUi`) before we finish awaiting. Without this guard the
-	// post-await assignment below would strand a settled gate as a permanent
-	// `mountedCustomUi`, hiding the transcript and crashing on the next
-	// keystroke routed into the dead component (readiness gate #1099).
-	ctx.mountingRequestId = request.id;
-	if (!ctx.piTui || ctx.piTheme === undefined || ctx.piKeybindings === undefined) {
-		ctx.mountingRequestId = null;
-		ctx.stageUiBroker.reject(
-			request,
-			new Error("atomic-workflows: stage custom UI cannot mount without attached TUI host"),
-		);
-		return;
-	}
-	// `overlay: true` (and its `overlayOptions` / `reserveTranscriptRows`
-	// companions) is a placement hint for the main-chat host, not a capability
-	// request. The stage-chat custom-UI slot already gives the widget what an
-	// overlay buys it there — focus, and a transcript that stays visible and
-	// scrollable behind it — so an overlay request mounts on this same path
-	// rather than failing the prompt. `ask_user_question` always asks for an
-	// overlay, so rejecting it made every in-stage questionnaire fail.
-	try {
-		const mounted = await mountStageCustomUi(
-			request,
-			ctx.piTui,
-			ctx.piTheme,
-			ctx.piKeybindings,
-			ctx.stageUiBroker,
-			() => {
-				if (ctx.mountedCustomUi?.request.id !== request.id) return;
-				ctx.mountedCustomUi.component.dispose?.();
-				ctx.mountedCustomUi = null;
-				ctx.chatHost.focused = ctx.focused;
-				ctx.chatHost.scrollToBottom();
-				ctx.requestRender?.();
-			},
-			() => canSubmitPrompt(ctx, request.id),
-		);
-		// Settled or superseded while mounting: drop the freshly-built component
-		// instead of showing a gate the broker has already torn down.
-		if (ctx.mountingRequestId !== request.id) {
-			mounted.component.dispose?.();
-			return;
-		}
-		ctx.mountingRequestId = null;
-		ctx.mountedCustomUi = mounted;
-		// A freshly-shown custom UI (ask_user_question / readiness gate) must own
-		// keyboard focus to be answerable — including a question mounted mid-turn
-		// while the agent is "streaming" (it is blocked on this very question, and
-		// host focus may have drifted off the overlay during the turn, e.g. after a
-		// stay-loop composer submit). requestFocus is idempotent (a no-op when the
-		// overlay already owns focus), so this never re-runs a redundant focus
-		// transition that would stall the stream (#1120).
-		ctx.requestFocus?.();
-		ctx.requestRender?.();
-	} catch (error) {
-		if (ctx.mountingRequestId === request.id) ctx.mountingRequestId = null;
-		ctx.stageUiBroker.reject(request, error);
-	}
-}
-
-export function renderCustomUi(ctx: StageChatViewContext, width: number): string[] {
-	const component = ctx.mountedCustomUi?.component;
-	if (!component) return [];
-	setComponentFocused(component, ctx.focused);
-	return embedOrchestratorReturnHintInWidget(ctx, component.render(width), width);
-}
-
-export function hideMountedCustomUi(ctx: StageChatViewContext, request: StageCustomUiRequest): void {
-	// Signal any in-flight `showCustomUi` mount for this request to drop its
-	// component when it finishes — the broker is already tearing it down.
-	if (ctx.mountingRequestId === request.id) ctx.mountingRequestId = null;
-	const mounted = ctx.mountedCustomUi;
-	if (!mounted || mounted.request.id !== request.id) return;
-	ctx.mountedCustomUi = null;
-	mounted.component.dispose?.();
-	ctx.chatHost.focused = ctx.focused;
-	ctx.chatHost.scrollToBottom();
-	// Returning to the composer after a custom UI resolves (e.g. the readiness
-	// gate -> "stay") must re-assert overlay focus so the composer accepts
-	// input. Guarded for streaming so an answered mid-turn ask_user_question
-	// does not refocus during the agent's continuation (would stall it).
-	if (!ctx.chatHost.isStreaming()) ctx.requestFocus?.();
-	ctx.requestRender?.();
-}
-
-/**
- * Stop displaying the mounted stage custom UI locally, WITHOUT settling its
- * broker request. Detaching / closing / disposing the attached chat stops
- * viewing the stage; it never cancels a pending human-input request. The
- * request stays pending (the stage remains awaiting_input) so re-attaching
- * re-displays it. The request is settled only by the user answering (broker
- * resolve) or the run aborting (its AbortSignal -> broker reject) — those are
- * the single chokepoints for ending a human-input request.
- */
-export function releaseMountedCustomUi(ctx: StageChatViewContext): void {
-	ctx.mountingRequestId = null;
-	const mounted = ctx.mountedCustomUi;
-	if (!mounted) return;
-	ctx.mountedCustomUi = null;
-	mounted.component.dispose?.();
-}
-
-function canSubmitPrompt(ctx: StageChatViewContext, promptId: string): boolean {
-	return ctx.canSubmitPrompt?.(ctx.runId, ctx.stageId, promptId) ?? true;
-}

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

@@ -1,113 +0,0 @@
-/**
- * Maps workflow-owned stage delivery lifecycle facts onto the attached chat's
- * existing Working lifecycle.
- *
- * A workflow definition that auto-sends to its own retained stage starts a real
- * backend turn well before the public `agent_start` reaches this view. Without
- * this bridge the pane sits with `sdkBusy=false` and no requested render while
- * the model is already running, so it looks idle.
- *
- * Starting the host's ordinary lifecycle here — rather than synthesising an SDK
- * event — keeps `agent_start`, `turn_start`, `turn_end`, `agent_end`, retry,
- * fallback, compaction, and terminal cleanup in charge of everything after
- * startup, and lets a settled delivery that never produced a turn clean up.
- *
- * cross-ref: src/runs/foreground/stage-delivery-activity.ts
- */
-import type { StageDeliveryActivityEvent } from "../runs/foreground/stage-delivery-activity.js";
-import { isTerminalStageChatState } from "./stage-chat-view-status.js";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-
-export function subscribeStageChatDeliveryActivity(ctx: StageChatViewContext): (() => void) | null {
-	const handle = ctx.handle;
-	if (!handle?.subscribeDeliveryActivity) return null;
-	return handle.subscribeDeliveryActivity((event) => {
-		applyStageChatDeliveryActivityEvent(ctx, event);
-	});
-}
-
-export function applyStageChatDeliveryActivityEvent(
-	ctx: StageChatViewContext,
-	event: StageDeliveryActivityEvent,
-): void {
-	if (event.type === "delivery_start") {
-		// Replaces any lifecycle this same delivery id already owned; the map keeps
-		// one live token per delivery so settlement stays correlated. A start that
-		// arrives after terminal cleanup is fresh authorization for a retained
-		// post-mortem turn, so it also lifts the stale-start fence.
-		ctx.terminalLifecycleFenced = false;
-		ctx.deliveryLifecycles.set(event.deliveryId, ctx.chatHost.beginExternalPromptLifecycle());
-		return;
-	}
-	if (!ctx.deliveryLifecycles.has(event.deliveryId)) return;
-	const generation = ctx.deliveryLifecycles.get(event.deliveryId);
-	ctx.deliveryLifecycles.delete(event.deliveryId);
-	// A pre-turn compaction reasserts one lifecycle and hands the same token to
-	// every lease still open, so several deliveries can alias one generation.
-	// Only the last owner may settle it; otherwise the first lease to finish
-	// would stop Working while another accepted delivery is still running.
-	// Distinct generations — including stale ones — keep reaching the host's own
-	// generation fence exactly as before.
-	if (!ownsStageChatLifecycleGeneration(ctx, generation)) {
-		ctx.chatHost.settleExternalPromptLifecycle(generation);
-	}
-	// The map is the reference count: overlapping leases keep authorization open,
-	// and the last one to settle on a finished stage restores stale-start
-	// suppression. Otherwise the fence stayed open forever after the first
-	// post-terminal delivery and a late start could repaint a settled chat.
-	if (!hasActiveStageChatDelivery(ctx) && isStageChatContextTerminal(ctx)) {
-		ctx.terminalLifecycleFenced = true;
-	}
-}
-
-/** True while another still-active delivery references this exact lifecycle token. */
-function ownsStageChatLifecycleGeneration(ctx: StageChatViewContext, generation: number | undefined): boolean {
-	for (const active of ctx.deliveryLifecycles.values()) {
-		if (active === generation) return true;
-	}
-	return false;
-}
-
-/** True while at least one admitted delivery still owns this chat's Working period. */
-export function hasActiveStageChatDelivery(ctx: StageChatViewContext): boolean {
-	return ctx.deliveryLifecycles.size > 0;
-}
-
-/** True when the last observed run or stage status is terminal. */
-export function isStageChatContextTerminal(ctx: StageChatViewContext): boolean {
-	return isTerminalStageChatState(ctx.lastObservedRunStatus) || isTerminalStageChatState(ctx.lastObservedStageStatus);
-}
-
-/**
- * Restore delivery-owned Working after a temporary overlay ended.
- *
- * A pre-turn `compaction_end` clears busy state and the Working lifecycle even
- * though the accepted delivery has not started its turn yet, so the pane would
- * sit idle until the public `agent_start`. Reassertion preserves factual status
- * text, so a compaction error still outranks ordinary Working.
- */
-export function reconcileStageChatDeliveryLifecycle(ctx: StageChatViewContext): void {
-	if (!hasActiveStageChatDelivery(ctx)) return;
-	if (ctx.chatHost.isStreaming() && ctx.chatHost.hasAnimationTick()) return;
-	const generation = ctx.chatHost.reassertExternalPromptLifecycle();
-	for (const deliveryId of [...ctx.deliveryLifecycles.keys()]) {
-		ctx.deliveryLifecycles.set(deliveryId, generation);
-	}
-}
-
-/**
- * Drop every delivery lease admitted before a workflow terminal transition and
- * arm the stale-start fence.
- *
- * Those turns can no longer authorize activity on this chat, and keeping them
- * would let a queued late `agent_start` restart Working on a finished stage. A
- * settlement for a dropped id is then an ordinary unknown settlement.
- *
- * The fence is armed only by an observed transition. A chat that mounts onto an
- * already-terminal stage never cleaned up in-flight work, so a later
- * `agent_start` there is genuine retained-session work and stays visible.
- */
-export function invalidateStageChatDeliveryLifecycles(ctx: StageChatViewContext): void {
-	ctx.deliveryLifecycles.clear();
-	ctx.terminalLifecycleFenced = true;
-}