@iowarp/clio-coder 0.4.5 → 0.4.6

package/src/interactive/interactive-event-projection.ts

@@ -11,7 +11,6 @@ import {
 import type { ClioSettings } from "../core/config.js";
 import type { SafeEventBus } from "../core/event-bus.js";
 import { routingChangeNotices } from "../core/session-routing.js";
-import { visibleWidth } from "../engine/tui.js";
 import {
 	budgetAlertNotice,
 	middlewareHookFailedSessionNotice,
@@ -26,27 +25,11 @@ import {
 	toolBudgetAuditReason,
 	toolBudgetStopReason,
 } from "./loop-guard-interrupt.js";
-import {
-	type AgentStatus,
-	INLINE_STATUS_INDENT_COLS,
-	type ReasoningUsageView,
-	reasoningFromTally,
-	resolveInlineVerb,
-	type StatusPhase,
-	spinnerFrame,
-	type TurnSummary,
-	type VerbRender,
-} from "./status/index.js";
+import type { AgentStatus, TurnSummary } from "./status/index.js";
 
 export type InteractiveProjectionNoticeLevel = "info" | "success" | "warning" | "error";
 export type InteractiveTranscriptNoticeLevel = "info" | "success" | "warn" | "error";
 
-export interface InteractiveStatusLine {
-	phase: StatusPhase;
-	verb: string;
-	toneHint: VerbRender["toneHint"];
-}
-
 export interface InteractiveEventProjectionDeps {
 	bus: SafeEventBus;
 	chat: {
@@ -69,12 +52,10 @@ export interface InteractiveEventProjectionDeps {
 	resetAskUserCancellation: () => void;
 	recordToolStart: (toolName: string, toolCallId: string) => void;
 	recordToolEnd: (toolName: string, toolCallId: string, isError: boolean, truncated: boolean) => void;
-	setStatusLine: (line: InteractiveStatusLine | null) => void;
 	/**
 	 * Publish the live turn's reasoning projection to the transcript. Optional so
 	 * a host without a chat panel still gets every other projection.
 	 */
-	setLiveReasoning?: (view: ReasoningUsageView | null) => void;
 	setLastTurnSummary: (summary: TurnSummary) => void;
 	startTerminalProgress: () => void;
 	stopTerminalProgress: () => void;
@@ -126,8 +107,6 @@ function askUserInterviewClosedByToolResult(event: {
  * subscriptions.
  */
 export function createInteractiveEventProjection(deps: InteractiveEventProjectionDeps): InteractiveEventProjection {
-	const now = deps.now ?? Date.now;
-
 	for (const notice of deps.initialNotices ?? []) {
 		const text = notice.trim();
 		if (text.length === 0) continue;
@@ -187,30 +166,9 @@ export function createInteractiveEventProjection(deps: InteractiveEventProjectio
 		}),
 	);
 
-	let statusInlineFrame = 0;
 	primaryUnsubscribers.push(
 		deps.status.subscribe((status) => {
-			// One projection of the run tally reaches the transcript, so the live
-			// line, the turn receipt, and the footer state the same number.
-			deps.setLiveReasoning?.(
-				status.phase === "idle" || status.phase === "ended" ? null : reasoningFromTally(status.runTally),
-			);
-			if (status.phase === "idle") {
-				deps.setStatusLine(null);
-			} else if (status.phase === "ended") {
-				deps.setStatusLine(null);
-				if (status.summary) deps.setLastTurnSummary(status.summary);
-			} else {
-				const cols = deps.getTerminalColumns();
-				const frame = cols < 30 ? "" : `${spinnerFrame(statusInlineFrame)} `;
-				const verb = resolveInlineVerb(status, now(), cols, INLINE_STATUS_INDENT_COLS + visibleWidth(frame));
-				if (verb) {
-					deps.setStatusLine({ phase: status.phase, verb: `${frame}${verb.text}`, toneHint: verb.toneHint });
-					statusInlineFrame = (statusInlineFrame + 1) % 10;
-				} else {
-					deps.setStatusLine(null);
-				}
-			}
+			if (status.phase === "ended" && status.summary) deps.setLastTurnSummary(status.summary);
 			deps.refreshFooter();
 			deps.requestRender();
 		}),

package/src/interactive/interactive-input-runtime.ts

@@ -30,11 +30,7 @@ export interface InteractiveInputKeyActionDeps {
 	cycleScopedModelForward: () => void;
 	cycleScopedModelBackward: () => void;
 	dismissNotifications: () => void;
-	toggleToolExpansion: () => void;
-	toggleAllToolExpansion: () => void;
-	toggleLiveToolOutput: () => void;
-	toggleThinkingExpansion: () => void;
-	toggleAllThinkingExpansion: () => void;
+	cycleOutputStyle: () => void;
 	openExternalEditor: () => void;
 	queueFollowUp: () => void;
 	interruptWithMessage: () => void;
@@ -49,6 +45,7 @@ export interface InteractiveInputRuntimeDeps {
 	dispatchAction: (id: ClioKeybinding, deps: InteractiveInputKeyActionDeps) => boolean;
 	actions: {
 		canExit(): boolean;
+		cycleOutputStyle(): void;
 		availableThinkingLevels(): ReadonlyArray<string>;
 		onCycleThinking(): void;
 		cycleScopedModelForward(): void;
@@ -105,13 +102,6 @@ export interface InteractiveInputRuntimeDeps {
 		dismiss(id: string): void;
 		dismissAll(): void;
 	};
-	chatPanel: {
-		toggleLastToolExpanded(): boolean;
-		toggleAllToolsExpanded(): boolean;
-		toggleLiveToolOutput(): void;
-		toggleLastThinking(): boolean;
-		toggleAllThinking(): boolean;
-	};
 	shutdown: {
 		stopTickers(): void;
 		disposeInteractiveTickers(): void;
@@ -171,18 +161,7 @@ export function createInteractiveInputRuntime(deps: InteractiveInputRuntimeDeps)
 			deps.requestRender();
 		},
 		dismissNotifications: () => controller.dismissNotifications(),
-		toggleToolExpansion: () => controller.toggleToolExpansion(),
-		toggleAllToolExpansion: () => {
-			if (deps.chatPanel.toggleAllToolsExpanded()) deps.requestRender();
-		},
-		toggleLiveToolOutput: () => {
-			deps.chatPanel.toggleLiveToolOutput();
-			deps.requestRender();
-		},
-		toggleThinkingExpansion: () => controller.toggleThinkingExpansion(),
-		toggleAllThinkingExpansion: () => {
-			if (deps.chatPanel.toggleAllThinking()) deps.requestRender();
-		},
+		cycleOutputStyle: deps.actions.cycleOutputStyle,
 		openExternalEditor: deps.editorSubmit.openExternalEditorForInput,
 		queueFollowUp: deps.editorSubmit.queueFollowUpFromEditor,
 		interruptWithMessage: deps.editorSubmit.interruptFromEditor,
@@ -277,10 +256,6 @@ export function createInteractiveInputRuntime(deps: InteractiveInputRuntimeDeps)
 		listNotifications: () => deps.notifications.list(),
 		dismissNotification: (id) => deps.notifications.dismiss(id),
 		dismissAllNotifications: () => deps.notifications.dismissAll(),
-		toggleLastToolExpanded: () => deps.chatPanel.toggleLastToolExpanded(),
-		toggleAllToolsExpanded: () => deps.chatPanel.toggleAllToolsExpanded(),
-		toggleLastThinking: () => deps.chatPanel.toggleLastThinking(),
-		toggleAllThinking: () => deps.chatPanel.toggleAllThinking(),
 		shutdownDisposers: [
 			() => deps.shutdown.stopTickers(),
 			() => leaderKeys.dispose(),

package/src/interactive/interactive-presentation.ts

@@ -17,7 +17,7 @@ import type { ResourcesContract } from "../domains/resources/index.js";
 import { ceilChars, contentChars } from "../domains/session/context-accounting.js";
 import type { SessionContract, TaskBoardSnapshot } from "../domains/session/index.js";
 import type { UserTasksStore } from "../domains/user-tasks/store.js";
-import type { Component, TUI } from "../engine/tui.js";
+import type { Component, ScrollView, TUI } from "../engine/tui.js";
 import type { ChatLoop, ChatLoopEvent } from "./chat-loop.js";
 import { type ChatPanel, createChatPanel } from "./chat-panel.js";
 import { type CoalescingChatRenderer, createCoalescingChatRenderer } from "./chat-renderer.js";
@@ -33,7 +33,7 @@ import { createNotificationCenter, type NotificationCenter } from "./footer/noti
 import { getActiveRenderTrace } from "./interactive-shell.js";
 import type { InteractiveNoticeLevel } from "./interactive-subscriptions.js";
 import { type ClioKeybindingManager, createKeybindingManager } from "./keybinding-manager.js";
-import { buildLayout } from "./layout.js";
+import { buildLayout, preserveTranscriptScroll } from "./layout.js";
 import type { SessionTranscript } from "./session-transcript.js";
 import { createSlashCommandAutocompleteProvider } from "./slash-autocomplete.js";
 import { parseSlashCommand, type RunIo } from "./slash-commands.js";
@@ -146,6 +146,8 @@ export interface InteractivePresentation {
 	chatRenderer: CoalescingChatRenderer;
 	io: RunIo;
 	root: Component;
+	changeOutputStyle(mutation: () => void): void;
+	setLocalBashRunning(running: boolean): void;
 	getObservabilitySnapshot(): ObservabilitySnapshot;
 	/** Fold one raw chat event into the ephemeral throughput shown only while this turn is active. */
 	recordChatEvent(event: ChatLoopEvent): void;
@@ -233,11 +235,8 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	});
 	const renderTrace = getActiveRenderTrace();
 	const chatPanel = factories.createChatPanel({
-		getToolExpandKey: () => {
-			const first = keybindings.getKeys("clio-coder.tool.expand")[0];
-			return typeof first === "string" && first.length > 0 ? first : undefined;
-		},
-		getOutputVerbosity: () => deps.getSettings?.().interface.outputDetail ?? "default",
+		getOutputStyle: () => deps.getSettings?.().interface.outputDetail ?? "standard",
+		getTerminalRows: () => process.stdout.rows ?? 40,
 		...(renderTrace ? { onRenderMetrics: (metrics) => renderTrace.recordPanelRender(metrics) } : {}),
 	});
 	const followUpQueuePanel = factories.createFollowUpQueuePanel({
@@ -359,10 +358,21 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		);
 	};
 
+	let localBashStartedAt: number | null = null;
 	const footerDeps: FooterDashboardDeps = {
 		providers: deps.providers,
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
-		getAgentStatus: () => statusController.current(),
+		getAgentStatus: () => {
+			const status = statusController.current();
+			if (localBashStartedAt === null || (status.phase !== "idle" && status.phase !== "ended")) return status;
+			return {
+				...status,
+				phase: "tool_running",
+				since: localBashStartedAt,
+				toolStartedAt: localBashStartedAt,
+				tool: { toolName: "bash", toolPreview: "local shell" },
+			};
+		},
 		getTerminalColumns: () => deps.terminal.columns,
 		getSessionTokens: () => observabilitySnapshot.session.tokens,
 		getTokenThroughput: () =>
@@ -533,6 +543,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 				},
 			}
 		: followUpQueuePanel;
+	let transcriptView: ScrollView | undefined;
 	const root = factories.buildLayout(
 		{
 			banner,
@@ -544,6 +555,9 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		{
 			mode: settings.interface?.mode ?? "regular",
 			fullscreenScrollbar: settings.interface?.fullscreenScrollbar ?? "auto",
+			onTranscript: (view) => {
+				transcriptView = view;
+			},
 		},
 	);
 	deps.mount?.(root, editor);
@@ -553,7 +567,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		deps.clearScheduledInterval ??
 		((handle: PresentationTickerHandle): void => clearInterval(handle as ReturnType<typeof setInterval>));
 	const footerTicker = scheduleInterval(() => {
-		const statusActive = statusController.current().phase !== "idle";
+		const statusActive = statusController.current().phase !== "idle" || localBashStartedAt !== null;
 		if (!deps.chat.isStreaming() && !statusActive && !footer.isExpanded()) return;
 		footer.refresh();
 		requestRender();
@@ -618,6 +632,13 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		chatRenderer,
 		io,
 		root,
+		setLocalBashRunning(running) {
+			localBashStartedAt = running ? Date.now() : null;
+			footer.refresh();
+			requestRender();
+		},
+		changeOutputStyle: (mutation) =>
+			chatRenderer.mutate(() => preserveTranscriptScroll(transcriptView, deps.terminal.columns, mutation), "output-style"),
 		getObservabilitySnapshot: () => observabilitySnapshot,
 		recordChatEvent,
 		recordToolStart: (toolCallId, toolName) => {

package/src/interactive/interactive-slash-runtime.ts

@@ -64,7 +64,7 @@ export interface InteractiveSlashSubmitExpansion {
 }
 
 type SlashChat = Pick<ChatLoop, "clearSkillSurface" | "getSessionId" | "isStreaming" | "submit">;
-type SlashChatPanel = Pick<ChatPanel, "appendReplayBlock" | "appendUser" | "clearFoldOverrides">;
+type SlashChatPanel = Pick<ChatPanel, "appendReplayBlock" | "appendUser">;
 type UserTurnStatus = import("./chat-panel.js").UserTurnStatus;
 type SlashResources = Pick<ResourcesContract, "prompts" | "expandPromptTemplate" | "reload">;
 type SlashExtensions = Pick<ExtensionsContract, "list">;
@@ -178,7 +178,6 @@ export interface InteractiveSlashRuntime {
 }
 
 /** Owns slash-command context construction and its asynchronous command state. */
-const OUTPUT_VERBOSITIES: ReadonlyArray<ClioSettings["interface"]["outputDetail"]> = ["minimal", "default", "verbose"];
 
 /** Thinking capability of the active orchestrator target and model, or null when unresolved. */
 export function resolveThinkingCapability(
@@ -466,7 +465,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 			if (!match) {
 				return { status: "unsupported", level, supported: supported.map(labelFor) };
 			}
-			// Session scope, like /output: onSetThinkingLevel writes the level
+			// Session scope, like Alt+O: onSetThinkingLevel writes the level
 			// through to settings.yaml as the new default, which a slash command
 			// has no mandate to do.
 			if (deps.commitSetting) {
@@ -508,42 +507,6 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 					if (selected) dispatchSlashCommand({ kind: "thinking-set", level: selected.value }, context);
 				});
 		},
-		setOutputVerbosity: (verbosity) => {
-			if (!deps.getSettings || !(deps.commitSetting || deps.writeSettings)) return { status: "unavailable" };
-			const requested = verbosity.trim().toLowerCase();
-			const match = OUTPUT_VERBOSITIES.find((candidate) => candidate === requested);
-			if (!match) return { status: "unsupported", verbosity, supported: OUTPUT_VERBOSITIES };
-			const next = structuredClone(deps.getSettings()) as ClioSettings;
-			next.interface.outputDetail = match;
-			// Session scope: /output changes this session and leaves settings.yaml
-			// alone. Saving it as the default is what Settings → Terminal is for.
-			if (deps.commitSetting) deps.commitSetting("interface.outputDetail", next, "session");
-			else deps.writeSettings?.(next);
-			// `/output` is also the explicit reset action for transcript folds. Do
-			// this even when the requested level already matches the current one;
-			// the render-time change detector cannot observe a same-value command.
-			deps.chatPanel.clearFoldOverrides();
-			deps.refreshFooter();
-			return { status: "applied", verbosity: match };
-		},
-		openOutputPicker: () => {
-			void deps
-				.openAskUser([
-					{
-						question: "Choose transcript detail for this session.",
-						header: "Output",
-						options: OUTPUT_VERBOSITIES.map((value) => ({
-							label: `${value[0]?.toUpperCase()}${value.slice(1)}`,
-						})),
-					},
-				])
-				.then((result) => {
-					if (result.cancelled) return;
-					const answer = result.answers[0]?.answer.toLowerCase();
-					const selected = OUTPUT_VERBOSITIES.find((value) => value === answer);
-					if (selected) dispatchSlashCommand({ kind: "output-set", verbosity: selected }, context);
-				});
-		},
 		openModel: deps.openModel,
 		providers: deps.providers,
 		applyModelRef: (ref) => {
@@ -595,7 +558,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 				// operator overrides, and rendered at a stable width. HTML converts
 				// the resulting ANSI presentation to inline styles; Markdown keeps the
 				// prior plain-text fenced transcript.
-				const exportPanel = createChatPanel({ unboundedToolBodies: true, getOutputVerbosity: () => "verbose" });
+				const exportPanel = createChatPanel({ unboundedToolBodies: true, getOutputStyle: () => "detailed" });
 				// Scoped to the leaf the session is on, the same way /resume replays
 				// (issue #107): with a /tree pin persisted and not yet extended, the
 				// file still holds the abandoned branch after the pin, and an unscoped

package/src/interactive/layout.ts

@@ -13,6 +13,7 @@ export interface LayoutParts {
 export interface LayoutOptions {
 	mode?: TuiMode;
 	fullscreenScrollbar?: ScrollViewScrollbar;
+	onTranscript?: (view: ScrollView) => void;
 }
 
 export interface FullscreenLayout {
@@ -20,10 +21,7 @@ export interface FullscreenLayout {
 	transcript: ScrollView;
 }
 
-function buildFullscreenLayout(
-	parts: LayoutParts,
-	options: Pick<LayoutOptions, "fullscreenScrollbar"> = {},
-): FullscreenLayout {
+function buildFullscreenLayout(parts: LayoutParts, options: LayoutOptions = {}): FullscreenLayout {
 	const document = new Container();
 	document.addChild(parts.banner);
 	document.addChild(parts.chat);
@@ -36,6 +34,7 @@ function buildFullscreenLayout(
 		scrollbarTrackStyle: (text) => theme.fg("frame", text),
 		scrollbarThumbStyle: () => theme.fg("frameStrong", GLYPH.barFull),
 	});
+	options.onTranscript?.(transcript);
 	const dock = new VStack();
 	if (parts.pending) dock.addChild(parts.pending, { shrink: 1, minSize: 0 });
 	dock.addChild(parts.editor, { shrink: 1, minSize: 3 });
@@ -56,3 +55,29 @@ export function buildLayout(parts: LayoutParts, options: LayoutOptions = {}): Co
 	root.addChild(parts.footer);
 	return root;
 }
+
+/** Keep the nearest surviving text at the viewport when a preset changes row counts. */
+export function preserveTranscriptScroll(view: ScrollView | undefined, width: number, mutation: () => void): void {
+	if (!view || view.isFollowingEnd) {
+		mutation();
+		return;
+	}
+	const top = view.scrollTop;
+	const before = view.render(width);
+	mutation();
+	const after = view.render(width);
+	for (let row = top; row < Math.min(before.length, top + view.viewportHeight); row++) {
+		const anchor = before[row];
+		if (!anchor?.trim()) continue;
+		let match = -1;
+		for (let index = 0; index < after.length; index++) {
+			if (after[index] === anchor && (match < 0 || Math.abs(index - row) < Math.abs(match - row))) match = index;
+		}
+		if (match >= 0) {
+			view.updateLayout(after.length, view.viewportHeight, () => {});
+			view.scrollTo(Math.max(0, match - (row - top)), { disableFollow: true });
+			return;
+		}
+	}
+	view.scrollTo(top, { disableFollow: true });
+}

package/src/interactive/overlay-general-openers.ts

@@ -47,6 +47,7 @@ import { type ArtifactProviderDeps, createDefaultArtifactProviders } from "./vie
 import { openViewOverlay } from "./view/view-overlay.js";
 
 export interface OverlayGeneralOpenersDeps {
+	readTranscript?: ArtifactProviderDeps["readTranscript"];
 	tui: TUI;
 	transitions: OverlayTransitions;
 	observability: ObservabilityContract;
@@ -319,6 +320,7 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 				dispatch: deps.dispatch,
 				sessionMeta: deps.getSessionMeta(),
 				readSessionEntries: deps.readSessionEntries,
+				readTranscript: deps.readTranscript,
 			}),
 			...(initialFilter ? { initialFilter } : {}),
 			notice: deps.notify,

package/src/interactive/overlay-lifecycle.ts

@@ -399,6 +399,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 
 	const scheduling = deps.app.scheduling;
 	const overlayGeneralOpeners = createOverlayGeneralOpeners({
+		readTranscript: () => chatPanel.inspectionArtifacts(),
 		tui,
 		transitions: overlayTransitions,
 		observability: deps.app.observability,

package/src/interactive/overlay-session-lifecycle.ts

@@ -1,3 +1,4 @@
+import { editTextExternally, resolveExternalEditor } from "../core/external-editor.js";
 import { resolveSessionCwd } from "../domains/session/cwd-fallback.js";
 import type { DecisionLedgerEntry } from "../domains/session/entries.js";
 import {
@@ -18,7 +19,6 @@ import type { ChatLoop } from "./chat-loop.js";
 import type { ChatPanel } from "./chat-panel.js";
 import { rehydrateChatPanelFromTurns } from "./chat-renderer.js";
 import { emitCommandNotice } from "./command-fallbacks.js";
-import { editTextExternally, resolveExternalEditor } from "./external-editor.js";
 import type { InteractiveNoticeLevel } from "./interactive-subscriptions.js";
 import { buildModelReplayAgentMessagesFromTurns } from "./model-session-replay.js";
 import type { OverlayTransitions } from "./overlay-transitions.js";

package/src/interactive/overlays/settings.ts

@@ -229,7 +229,7 @@ export const SETTINGS_LABELS_BY_ID = {
 	"retry.maxDelayMs": "Max delay (ms)",
 	"retry.streamStallMs": "Stream stall timeout (ms)",
 	"terminal.showTerminalProgress": "Terminal progress badges",
-	"terminal.outputVerbosity": "Output detail",
+	"terminal.outputVerbosity": "Output style",
 	"terminal.tuiMode": "TUI mode",
 	"terminal.fullscreenScrollbar": "Fullscreen scrollbar",
 	"terminal.smoothStreaming": "Smooth streaming",
@@ -514,7 +514,8 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 		"Written by the confirm flow, not by hand, because confirming a remote here would be the record confirming itself. Sync refuses with library_remote_unconfirmed until this equals library.remote. Default: blank.",
 	"library.sync":
 		"Off means `clio-coder library sync` and `push` refuse before touching the network, whatever the remote says. Legal values: true, false · default: false.",
-	"budget.concurrency": "auto sizes to your machine. A fixed number caps how many workers run at once.",
+	"budget.concurrency":
+		"auto allows four local workers. A fixed number caps how many workers run at once; the default is one.",
 	"skills.trustProjectCompatRoots":
 		"Project roots like .claude/skills and .codex/skills are untrusted by default; enabling exposes them to the model.",
 	"attribution.gitCommits":
@@ -550,7 +551,7 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 	"watchdog.cadenceToolCalls":
 		"Mid-turn firing is how scope drift becomes visible before the turn ends. Leave blank and the watchdog fires at turn end only.",
 	keybindings:
-		"Renderer controls: Alt+O newest tool or worker details, Ctrl+Alt+O or Alt+Shift+O all of them, Alt+P live tool output, Alt+R latest reasoning, Ctrl+Alt+R or Alt+Shift+R all reasoning. Override these in settings.yaml or use /help.",
+		"Alt+O cycles Output style: Compact, Standard, Detailed. Use /view for full reasoning and action details. Shift+Tab changes model thinking effort.",
 };
 
 /** Per-value meaning, surfaced for the current value of an enum knob. */
@@ -623,9 +624,9 @@ const SETTINGS_VALUE_HELP_BY_ID: Partial<Record<EditableSettingId, Record<string
 		false: "no terminal progress badges",
 	},
 	"terminal.outputVerbosity": {
-		minimal: "quiet transcript; tools stay to one-line outcomes and reasoning stays folded",
-		default: "balanced transcript; unfold the latest tool, worker, or reasoning block on demand",
-		verbose: "transparent transcript; reasoning, arguments, and live tool output stay visible",
+		compact: "quiet action summaries, answers, and visible failures",
+		standard: "short reasoning and change previews, clear action outcomes",
+		detailed: "larger bounded previews; full content is available in /view",
 	},
 	"terminal.tuiMode": {
 		regular: "preserve terminal scrollback and render the composer below the transcript",
@@ -1923,7 +1924,7 @@ function buildSettingItems(settings: Readonly<ClioSettings>, options?: BuildSett
 			values: ["false", "true"],
 		}),
 		settingItem("terminal.outputVerbosity", terminal.outputDetail, {
-			values: ["minimal", "default", "verbose"],
+			values: ["compact", "standard", "detailed"],
 		}),
 		settingItem("terminal.tuiMode", terminal.mode, {
 			values: ["regular", "fullscreen"],
@@ -2555,7 +2556,7 @@ function applySettingChange(settings: ClioSettings, id: string, value: string):
 			if (value === "true" || value === "false") settings.interface.terminalProgress = value === "true";
 			return;
 		case "terminal.outputVerbosity":
-			if (value === "minimal" || value === "default" || value === "verbose") settings.interface.outputDetail = value;
+			if (value === "compact" || value === "standard" || value === "detailed") settings.interface.outputDetail = value;
 			return;
 		case "terminal.tuiMode":
 			if (value === "regular" || value === "fullscreen") settings.interface.mode = value;

package/src/interactive/renderers/preview.ts

@@ -0,0 +1,16 @@
+import { truncateToWidth } from "../../engine/tui.js";
+import { clioTheme } from "../theme/index.js";
+
+/** Count terminal rows after wrapping, including the inspection hint. */
+export function previewRows(rows: readonly string[], limit: number, width: number, tail = false): string[] {
+	if (rows.length <= limit) return [...rows];
+	if (limit <= 0) return [];
+	const count = Math.max(0, limit - 1);
+	const hint = clioTheme().fg("dim", truncateToWidth(`… ${rows.length - count} rows · /view`, Math.max(1, width)));
+	return tail ? [hint, ...rows.slice(rows.length - count)] : [...rows.slice(0, count), hint];
+}
+
+/** Leave room for the composer and action identity in a short terminal. */
+export function previewBudget(limit: number, terminalRows = 40): number {
+	return Math.min(limit, Math.max(2, Math.floor((terminalRows - 8) / 2)));
+}