@linxiraos/pi-tui 1.2.0 → 1.3.0

package/src/overlays/model-browser.ts

@@ -10,7 +10,7 @@
 import { ThinkingLevel } from "@linxiraos/pi-agent-core";
 import type { Model } from "@linxiraos/pi-ai";
 import { buildModel } from "@linxiraos/pi-catalog/build";
-import { getModelPricingStatus, modelsAreEqual } from "@linxiraos/pi-catalog/models";
+import { getEffectiveTokenCost, getModelPricingStatus, modelsAreEqual } from "@linxiraos/pi-catalog/models";
 import { modelKind, type ModelKind, type ModelPricingStatus } from "@linxiraos/pi-catalog/types";
 import type { Component } from "../tui";
 import { FuzzyCorpus, fuzzyRank } from "../fuzzy";
@@ -37,7 +37,14 @@ import {
 } from "../keybinding-matchers";
 import { MenuSelection } from "../components/menu-selection";
 import { clampScrollOffset, scrollOffsetForRow } from "../components/scroll-viewport";
-import type { TspPickerColumn, TspPickerGroup, TspPickerItem, TspSpan, TspText } from "@linxiraos/pi-wire";
+import type {
+	TspPickerColumn,
+	TspPickerGroup,
+	TspPickerItem,
+	TspPickerMark,
+	TspSpan,
+	TspText,
+} from "@linxiraos/pi-wire";
 import { col, md, node, row, span, text } from "../native/describe";
 import { pickerFuzzyHits } from "../native/picker";
 import type { NativeChild, NativeNode, NativeUiEvent } from "../native/node";
@@ -735,7 +742,7 @@ function declaredPricingStatus(model: Model): Exclude<ModelPricingStatus, "fixed
 function isFreeModel(model: Model): boolean {
 	const declared = declaredPricingStatus(model);
 	if (declared !== undefined) return declared === "free";
-	const cost = model.cost;
+	const cost = model.cost ? getEffectiveTokenCost(model.cost) : undefined;
 	const credits = model.factoryDroidCredits;
 	return (!cost || (cost.input === 0 && cost.output === 0)) && (credits === undefined || credits === 0);
 }
@@ -759,7 +766,8 @@ function withCreditBadge(model: Model, price: string): string {
 	const credits = model.factoryDroidCredits;
 	if (credits === undefined) return price;
 	const badge = `${formatCostLeg(credits)}×`;
-	return model.cost.input !== 0 || model.cost.output !== 0 ? `${price} ${badge}` : badge;
+	const cost = getEffectiveTokenCost(model.cost);
+	return cost.input !== 0 || cost.output !== 0 ? `${price} ${badge}` : badge;
 }
 
 const PRICING_STATUS_LABELS: Record<Exclude<ModelPricingStatus, "fixed">, { short: string; detail: string }> = {
@@ -774,7 +782,8 @@ function formatCostPair(model: Model): string {
 	const declared = declaredPricingStatus(model);
 	if (declared !== undefined) return PRICING_STATUS_LABELS[declared].short;
 	if (isFreeModel(model)) return "free";
-	return withCreditBadge(model, `$${formatCostLeg(model.cost.input)}/${formatCostLeg(model.cost.output)}`);
+	const cost = getEffectiveTokenCost(model.cost);
+	return withCreditBadge(model, `$${formatCostLeg(cost.input)}/${formatCostLeg(cost.output)}`);
 }
 
 /** Detail-pane price fact: `$3/15 per M`, or the declared pricing state in words. */
@@ -796,19 +805,34 @@ function pickerPrice(model: Model): string {
 	const declared = declaredPricingStatus(model);
 	if (declared !== undefined) return PRICING_STATUS_LABELS[declared].short;
 	if (isFreeModel(model)) return "free";
-	return withCreditBadge(model, `$${formatCostLeg(model.cost.input)}·${formatCostLeg(model.cost.output)}`);
+	const cost = getEffectiveTokenCost(model.cost);
+	return withCreditBadge(model, `$${formatCostLeg(cost.input)}·${formatCostLeg(cost.output)}`);
 }
 
 /** `$2 in · $10 out · $0.2 cache` for a model preview. */
 function previewPrice(model: Model): string {
 	const declared = declaredPricingStatus(model);
 	if (declared !== undefined) return PRICING_STATUS_LABELS[declared].detail;
-	const cost = model.cost;
+	const cost = getEffectiveTokenCost(model.cost);
 	const parts = [`$${formatCostLeg(cost.input)} in`, `$${formatCostLeg(cost.output)} out`];
 	if (cost.cacheRead > 0) parts.push(`$${formatCostLeg(cost.cacheRead)} cache`);
 	return withCreditBadge(model, parts.join(" · "));
 }
 
+/**
+ * A provider's picker mark: the terminal's logo for it, else its initials
+ * (`amazon-bedrock` → `AB`, `anthropic` → `An`) on its own gradient.
+ */
+export function providerMark(providerId: string): TspPickerMark {
+	const words = providerId.split(/[-_\s.]+/).filter(word => word.length > 0);
+	const word = words[0] ?? providerId;
+	const text =
+		words.length >= 2
+			? `${words[0]!.charAt(0)}${words[1]!.charAt(0)}`.toUpperCase()
+			: `${word.charAt(0).toUpperCase()}${word.charAt(1)}`;
+	return { text, seed: providerId, icon: `provider:${providerId}` };
+}
+
 /** The omp theme token of a thinking level's dot (`thinkingHigh`); none for inherit and auto. */
 export function thinkingDotToken(level: ConfiguredThinkingLevel): string | undefined {
 	if (level === ThinkingLevel.Inherit || level === AUTO_THINKING) return undefined;
@@ -1999,6 +2023,7 @@ export class ModelBrowser implements Component {
 		const value: TspPickerItem = {
 			id: item.selector,
 			label: quickRole ? item.id : item.selector,
+			mark: providerMark(item.model.provider),
 			mono: true,
 			...(quickRole ? { detail: `${item.model.provider}/${item.model.id}` } : {}),
 			facts,

package/src/overlays/model-hub.ts

@@ -56,6 +56,7 @@ import {
 	ModelBrowser,
 	type ModelBrowserItem,
 	modelSearchText,
+	providerMark,
 	thinkingDotToken,
 	type RoleAssignments,
 	resolveRoleAssignments,
@@ -314,14 +315,6 @@ const MODEL_KIND_LABELS: Record<"all" | ModelKind, string> = {
 	video: "Video",
 };
 
-/** A provider mark's initials: `amazon-bedrock` → `AB`, `anthropic` → `An`. */
-function providerInitials(providerId: string): string {
-	const words = providerId.split(/[-_\s.]+/).filter(word => word.length > 0);
-	if (words.length >= 2) return `${words[0]!.charAt(0)}${words[1]!.charAt(0)}`.toUpperCase();
-	const word = words[0] ?? providerId;
-	return `${word.charAt(0).toUpperCase()}${word.charAt(1)}`;
-}
-
 const PROVIDER_REFRESH_DEBOUNCE_MS = 120;
 const RECENT_LIMIT = 15;
 /** Accepted compaction limit input, shown beside the field: a scaled base, a fixed trigger, or a percentage. */
@@ -549,7 +542,7 @@ export class ModelHubComponent implements Component {
 		}
 
 		// Reconcile catalogs in the background. This is online discovery only —
-		// it must not re-run `!command` credential helpers (F5 / `zeta-c models
+		// it must not re-run `!command` credential helpers (F5 / `zetacode models
 		// refresh` pass refreshCommandCredentials for that). A --models scope is
 		// registry-independent, so the reload would only repeat the hydration
 		// above.
@@ -1335,6 +1328,7 @@ export class ModelHubComponent implements Component {
 	 */
 	#thinkingOptionsFor(model: Model): ConfiguredThinkingLevel[] {
 		if (!model.reasoning) return [];
+		if (model.thinking?.unverified) return [ThinkingLevel.Inherit, ThinkingLevel.Off, ...getSupportedEfforts(model)];
 		return [ThinkingLevel.Inherit, ThinkingLevel.Off, AUTO_THINKING, ...getSupportedEfforts(model)];
 	}
 
@@ -3458,7 +3452,7 @@ export class ModelHubComponent implements Component {
 					break;
 				case "provider": {
 					const providerId = entry.providerId ?? entry.label;
-					const mark = { text: providerInitials(providerId), seed: providerId };
+					const mark = providerMark(providerId);
 					if (entry.locked) {
 						const envVars = providerEntry(providerId)?.envVars ?? [];
 						scopes.push({

package/src/overlays/model-picker.ts

@@ -76,6 +76,8 @@ export interface ModelPickerOptions {
 	taskModeKeys?: readonly KeyId[];
 	/** `provider/id` highlighted and preselected in task mode (current Task subagent model). */
 	taskSelector?: string;
+	/** Present selection-only chrome; consumers handle the chosen selector without mutating a session. */
+	selectOnly?: boolean;
 }
 
 /** Fixed chrome rows: top border, status row, footer, bottom border. */
@@ -90,9 +92,10 @@ const HEIGHT_FRACTION = 0.4;
 const STATUS_HINT = "Session-only switch — role models stay unchanged";
 const QUICK_ROLE_STATUS_HINT = "Quick role switch — applies its model and thinking for this session";
 const TASK_STATUS_HINT = "Task subagent switch — spawned task agents use this model (session-only)";
+const SELECT_ONLY_STATUS_HINT = "Selection only — does not change the session model";
 
 /** Footer hint for the active mode; keys resolve at render time so theme/keybinding changes apply. */
-function footerHint(mode: "session" | "role" | "task"): string {
+function footerHint(mode: "session" | "role" | "task" | "selection"): string {
 	const upDown = editorKeys("tui.select.up", "tui.select.down");
 	const enter = formatKeyHint("enter");
 	const close = `${editorKey("tui.select.cancel")} close`;
@@ -101,6 +104,8 @@ function footerHint(mode: "session" | "role" | "task"): string {
 			return `${upDown} roles · ${enter} apply role model · type to search · ${close}`;
 		case "task":
 			return `${upDown} models · ${enter} use for Task subagents · type to search · ${close}`;
+		case "selection":
+			return `${upDown} models · ${enter} select model · type to search · ${close}`;
 		default:
 			return `${upDown} models · ${enter} use for this session · type to search · @ quick roles · ${close}`;
 	}
@@ -128,6 +133,7 @@ export class ModelPickerComponent implements Component {
 	#taskMatchKeys = new Set<string>();
 	#taskModeKey: KeyId | undefined;
 	#taskSelector: string | undefined;
+	#selectOnly: boolean;
 	#nativeRoot: { memo: string; node: NativeNode } | undefined;
 	#pickerRoot:
 		| {
@@ -151,10 +157,11 @@ export class ModelPickerComponent implements Component {
 		this.#settings = settings;
 		this.#registry = registry;
 		this.#scopedModels = scopedModels;
+		this.#selectOnly = options.selectOnly ?? false;
 		this.#currentSelector = options.currentSelector;
 		this.#currentQuickRoleSelector = options.currentQuickRole ? `@${options.currentQuickRole}` : undefined;
 		this.#taskSelector = options.taskSelector;
-		if (callbacks.onPickTask) {
+		if (!this.#selectOnly && callbacks.onPickTask) {
 			this.#taskModeKey = options.taskModeKeys?.[0];
 			for (const key of options.taskModeKeys ?? []) addKeyAliases(this.#taskMatchKeys, key);
 		}
@@ -165,7 +172,7 @@ export class ModelPickerComponent implements Component {
 
 		this.#browser = new ModelBrowser(settings, {
 			currentContextTokens: options.currentContextTokens,
-			markOverContext: true,
+			markOverContext: !this.#selectOnly,
 			emptyText: () =>
 				this.#roleMode
 					? `  No quick roles in the ${editorKey("app.model.cycleForward") || formatKeyHint("ctrl+p")} cycle`
@@ -250,13 +257,13 @@ export class ModelPickerComponent implements Component {
 
 	/** Switch browser content only when a leading `@` changes the search mode. */
 	#syncItemsForQuery(query: string, refresh = false): void {
-		const roleMode = query.startsWith("@") && !this.#taskMode;
+		const roleMode = !this.#selectOnly && query.startsWith("@") && !this.#taskMode;
 		const modeChanged = roleMode !== this.#roleMode;
 		if (!modeChanged && !refresh) return;
 
 		this.#roleMode = roleMode;
 		this.#browser.setShowProvider(!roleMode);
-		this.#browser.setMarkOverContext(!roleMode && !this.#taskMode);
+		this.#browser.setMarkOverContext(!this.#selectOnly && !roleMode && !this.#taskMode);
 		this.#browser.setPreserveQueryOrder(roleMode);
 		const currentSelector = roleMode
 			? this.#currentQuickRoleSelector
@@ -299,20 +306,32 @@ export class ModelPickerComponent implements Component {
 		this.#browser.setMaxVisible(Math.max(MIN_VISIBLE, listBudget));
 
 		const inner = Math.max(1, width - 4);
+		const selectionOnly = this.#selectOnly;
 		const status = this.#configError
 			? theme.fg("error", ` ${this.#configError}`)
 			: this.#taskMode
 				? theme.fg("error", ` ${TASK_STATUS_HINT}`)
-				: theme.fg("muted", ` ${this.#roleMode ? QUICK_ROLE_STATUS_HINT : STATUS_HINT}`);
+				: theme.fg(
+						"muted",
+						` ${selectionOnly ? SELECT_ONLY_STATUS_HINT : this.#roleMode ? QUICK_ROLE_STATUS_HINT : STATUS_HINT}`,
+					);
 
 		const borderColor: ThemeColor | undefined = this.#taskMode ? "error" : undefined;
-		let footer = footerHint(this.#taskMode ? "task" : this.#roleMode ? "role" : "session");
+		let footer = footerHint(
+			this.#taskMode ? "task" : this.#roleMode ? "role" : selectionOnly ? "selection" : "session",
+		);
 		if (this.#taskModeKey !== undefined && !this.#roleMode) {
 			footer += ` · ${formatKeyHint(this.#taskModeKey)} ${this.#taskMode ? "session model" : "task model"}`;
 		}
 
 		const out: string[] = [];
-		out.push(topBorder(width, this.#taskMode ? "Switch Task Model" : "Switch Model", borderColor));
+		out.push(
+			topBorder(
+				width,
+				this.#taskMode ? "Switch Task Model" : selectionOnly ? "Select Model" : "Switch Model",
+				borderColor,
+			),
+		);
 		out.push(row(status, width, borderColor));
 		for (const line of this.#browser.render(inner)) {
 			out.push(row(line, width, borderColor));
@@ -359,7 +378,7 @@ export class ModelPickerComponent implements Component {
 	}
 
 	#describePicker(): NativeNode {
-		const mode = this.#taskMode ? "task" : this.#roleMode ? "role" : "session";
+		const mode = this.#selectOnly ? "selection" : this.#taskMode ? "task" : this.#roleMode ? "role" : "session";
 		const query = this.#browser.query;
 		const view = this.#browser.pickerOrder({
 			providers: false,
@@ -390,13 +409,15 @@ export class ModelPickerComponent implements Component {
 			? [span(this.#configError, "error")]
 			: mode === "task"
 				? [span(TASK_STATUS_HINT, "warning")]
-				: mode === "role"
-					? QUICK_ROLE_STATUS_HINT
-					: STATUS_HINT;
+				: mode === "selection"
+					? SELECT_ONLY_STATUS_HINT
+					: mode === "role"
+						? QUICK_ROLE_STATUS_HINT
+						: STATUS_HINT;
 		const cycleKey = editorKey("app.model.cycleForward") || formatKeyHint("ctrl+p");
 		const node = picker(
 			{
-				title: mode === "task" ? "Switch task model" : "Switch model",
+				title: mode === "task" ? "Switch task model" : mode === "selection" ? "Select model" : "Switch model",
 				subtitle,
 				icon: "cpu",
 				noun: mode === "role" ? "roles" : "models",
@@ -405,7 +426,8 @@ export class ModelPickerComponent implements Component {
 				preview: "below",
 				query,
 				cursor,
-				placeholder: mode === "task" ? "Search models…" : "Search models, @ for quick roles…",
+				placeholder:
+					mode === "task" || mode === "selection" ? "Search models…" : "Search models, @ for quick roles…",
 				columns: MODEL_PICKER_COLUMNS,
 				...catalogue,
 				order: view.order,
@@ -417,11 +439,17 @@ export class ModelPickerComponent implements Component {
 				actions: compact([
 					pickerAction(
 						"use",
-						mode === "role" ? "Apply role" : mode === "task" ? "Use for Task subagents" : "Use for session",
+						mode === "role"
+							? "Apply role"
+							: mode === "task"
+								? "Use for Task subagents"
+								: mode === "selection"
+									? "Select model"
+									: "Use for session",
 						"enter",
 						{ primary: true },
 					),
-					this.#taskModeKey !== undefined && mode !== "role"
+					this.#taskModeKey !== undefined && mode !== "role" && mode !== "selection"
 						? pickerAction("task", "Task model", this.#taskModeKey, { on: mode === "task" })
 						: undefined,
 					query.length > 0 ? { ...CLOSE_ACTION, label: "Clear search" } : CLOSE_ACTION,
@@ -435,7 +463,7 @@ export class ModelPickerComponent implements Component {
 
 	/** Root card over the status line, the embedded browser, and the mode's key hints. */
 	#describeCard(): NativeNode {
-		const mode = this.#taskMode ? "task" : this.#roleMode ? "role" : "session";
+		const mode = this.#selectOnly ? "selection" : this.#taskMode ? "task" : this.#roleMode ? "role" : "session";
 		const memo = `${mode}\0${this.#configError ?? ""}\0${this.#taskModeKey ?? ""}`;
 		if (this.#nativeRoot?.memo === memo) return this.#nativeRoot.node;
 
@@ -443,7 +471,14 @@ export class ModelPickerComponent implements Component {
 			? span(this.#configError, "error")
 			: this.#taskMode
 				? span(TASK_STATUS_HINT, "error")
-				: span(this.#roleMode ? QUICK_ROLE_STATUS_HINT : STATUS_HINT, "muted");
+				: span(
+						mode === "selection"
+							? SELECT_ONLY_STATUS_HINT
+							: this.#roleMode
+								? QUICK_ROLE_STATUS_HINT
+								: STATUS_HINT,
+						"muted",
+					);
 		const hints: (NativeHint | undefined)[] = [
 			actionHint(["tui.select.up", "tui.select.down"], mode === "role" ? "roles" : "models"),
 			{
@@ -453,20 +488,22 @@ export class ModelPickerComponent implements Component {
 						? "apply role model"
 						: mode === "task"
 							? "use for Task subagents"
-							: "use for this session",
+							: mode === "selection"
+								? "select model"
+								: "use for this session",
 			},
 			{ keys: [], label: "type to search" },
 		];
 		if (mode === "session") hints.push({ keys: ["@"], label: "quick roles" });
 		hints.push(actionHint("tui.select.cancel", "close"));
-		if (this.#taskModeKey !== undefined && !this.#roleMode) {
+		if (this.#taskModeKey !== undefined && !this.#roleMode && mode !== "selection") {
 			hints.push({ keys: [this.#taskModeKey], label: this.#taskMode ? "session model" : "task model" });
 		}
 		// `card` directly: the task-mode tone is a common prop `overlayCard` doesn't take.
 		const node = card(
 			{
 				role: "zeta.overlay.model-picker",
-				head: this.#taskMode ? "Switch Task Model" : "Switch Model",
+				head: mode === "task" ? "Switch Task Model" : mode === "selection" ? "Select Model" : "Switch Model",
 				tone: this.#taskMode ? "error" : undefined,
 			},
 			[text([status], { wrap: "word" }), this.#browser, hintsRow(hints)],

package/src/overlays/pause-screen.ts

@@ -20,7 +20,7 @@ import { matchesAppInterrupt } from "../keybinding-matchers";
 import { formatKeyHint, formatTooltipKey } from "../app-keybindings";
 import { boundKeys, interruptKey } from "../chrome/keybinding-hints";
 import type { NativeNode, NativeUiEvent } from "../native/node";
-import { col, node, row, span, text } from "../native/describe";
+import { col, keyed, node, row, span, text } from "../native/describe";
 import { actionBar, actionButton } from "../native/overlay";
 import { isNativeRendering } from "../native/state";
 
@@ -57,6 +57,14 @@ const BODY_LINES = [
 	"In-flight calls finish; nothing new starts until you resume.",
 ] as const;
 
+/** What the hold means, one fact per row of the native sheet: icon, what, detail. */
+const HOLD_FACTS = [
+	["users", "Every agent holds", "Main agent, subagents and advisor stop at their next step."],
+	["activity", "Running calls finish", "A reply or tool already under way completes; nothing new starts."],
+	["message", "Queued messages wait", "Steering and follow-ups already queued send after you resume."],
+	["pen", "The repo is yours", "Edit files freely, then tell the agent what changed."],
+] as const;
+
 /** Live hold clock, seconds-precise: `0:07`, `12:34`, `1:02:03`. */
 function formatClock(ms: number): string {
 	const totalSeconds = Math.max(0, Math.floor(ms / 1000));
@@ -176,33 +184,83 @@ export class PauseScreenComponent implements Component, OverlayFocusOwner {
 	/** A glass sheet titled "Paused" (not the whole pane: the transcript stays visible, frozen). */
 	readonly nativeOverlay = { role: "zeta.overlay.pause", size: "md", anchor: "center", head: "Paused" } as const;
 
+	/**
+	 * The sheet: a hero (the pause glyph beside the live hold clock and the
+	 * session it holds), what the hold means as four facts, and a footer that
+	 * reassures and resumes. The resume keys live in the button's tooltip.
+	 */
 	describe(): NativeNode {
 		if (this.#native) return this.#native;
-		const children: NativeNode[] = [];
-		if (this.host.sessionName) children.push(text([span(this.host.sessionName, "strong")]));
 		const resumeKey = boundKeys("app.interrupt", ["escape"])[0] ?? "escape";
-		children.push(
-			text(
-				BODY_LINES.map((line, index) => span(index === 0 ? line : `\n${line}`, "muted")),
-				{ wrap: "word" },
-			),
-			row(
-				[
-					text([span("Paused for", "dim")]),
-					node("elapsed", { age: Date.now() - this.#startedAt, format: "clock" }),
-				],
-				{ gap: "xs", align: "baseline" },
+		const hero = row(
+			[
+				node("icon", { name: "pause", role: "zeta.pause.glyph" }, undefined, "glyph"),
+				col(
+					[
+						node(
+							"elapsed",
+							{
+								age: Date.now() - this.#startedAt,
+								format: "clock",
+								role: "zeta.pause.clock",
+								title: "Paused for",
+							},
+							undefined,
+							"clock",
+						),
+						keyed(
+							text([span(this.host.sessionName ?? "Every agent in this session", "muted")], {
+								role: "zeta.pause.session",
+								wrap: "none",
+								truncate: "end",
+							}),
+							"session",
+						),
+					],
+					{ gap: "none", grow: 1, shrink: 1 },
+				),
+			],
+			{ role: "zeta.pause.hero", gap: "md", align: "center" },
+		);
+		const facts = col(
+			HOLD_FACTS.map(([icon, what, detail], index) =>
+				keyed(
+					row(
+						[
+							node("icon", { name: icon }),
+							col([text([span(what, "strong")]), text([span(detail, "muted")], { wrap: "word" })], {
+								gap: "none",
+								grow: 1,
+								shrink: 1,
+							}),
+						],
+						{ role: "zeta.pause.fact", gap: "md", align: "start" },
+					),
+					`fact-${index}`,
+				),
 			),
-			actionBar([
-				null,
-				actionButton("Resume", "resume", {
-					keys: resumeKey,
-					tone: "accent",
-					title: `Resume  ${formatTooltipKey(resumeKey)} · enter · space`,
-				}),
-			]),
+			{ role: "zeta.pause.facts", gap: "md" },
+		);
+		this.#native = col(
+			[
+				keyed(hero, "hero"),
+				keyed(facts, "facts"),
+				actionBar([
+					keyed(
+						text([span("Each agent continues where it stopped.", "muted")], { role: "zeta.pause.note" }),
+						"note",
+					),
+					null,
+					actionButton("Resume", "resume", {
+						keys: resumeKey,
+						tone: "accent",
+						// Each ` · ` clause ending in two spaces and a key is a keycap: `Resume [esc] · [⏎] · [space]`.
+						title: `Resume  ${formatTooltipKey(resumeKey)} ·   ${formatTooltipKey("enter")} ·   ${formatTooltipKey("space")}`,
+					}),
+				]),
+			],
+			{ gap: "md" },
 		);
-		this.#native = col(children, { gap: "md" });
 		return this.#native;
 	}
 

package/src/overlays/plan-review-overlay.ts

@@ -606,6 +606,22 @@ export class PlanReviewOverlay implements Component {
 		slider.onChange?.(next);
 	}
 
+	/** Synchronize an external tier pick with the displayed slider before committing. */
+	setSliderIndex(index: number): void {
+		if (this.#committed || !this.#slider) return;
+		this.#moveSlider(index - this.#sliderIndex);
+	}
+
+	/** Commit an external answer through the same input-locking path as Enter; false when nothing was committed. */
+	selectOption(label: string): boolean {
+		if (this.#committed) return false;
+		const index = this.#options.indexOf(label);
+		if (index < 0 || this.#disabled.has(index)) return false;
+		this.#selectedIndex = index;
+		this.#confirmSelection();
+		return this.#committed;
+	}
+
 	#confirmSelection(): void {
 		const index = this.#selectedIndex;
 		if (index >= 0 && index < this.#options.length && !this.#disabled.has(index)) {

package/src/overlays/plugin-selector.ts

@@ -11,6 +11,7 @@ import { routeSelectListMouseWithTopBorder } from "../chrome/select-list-mouse-r
 import { tuiText } from "../i18n";
 import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node";
 import { SelectListSheet } from "../native/picker";
+import type { TspPickerItem } from "@linxiraos/pi-wire";
 
 export interface PluginSelectorCallbacks {
 	onSelect: (pluginName: string, marketplace: string, scope?: "user" | "project") => void;
@@ -36,6 +37,8 @@ export class PluginSelectorComponent extends OverlayPanel {
 	) {
 		super(tuiText("ssTabPlugins", "Plugins"), "zeta.overlay.plugins");
 
+		// The sheet draws version, install state and scope as badges instead of bracketed label text.
+		const badgesByValue = new Map<string, NonNullable<TspPickerItem["badges"]>>();
 		const items: SelectItem[] = plugins.map(({ plugin, marketplace, scope }) => {
 			// Encode scope into the value so onSelect can recover it without a parallel Map.
 			// Format: "name@marketplace" or "name@marketplace#scope"
@@ -46,6 +49,11 @@ export class PluginSelectorComponent extends OverlayPanel {
 			const scopeTag = scope
 				? ` [${scope === "user" ? tuiText("mcpScopeWordUser", "user") : tuiText("mcpScopeWordProject", "project")}]`
 				: "";
+			badgesByValue.set(id, [
+				...(plugin.version ? [{ text: plugin.version }] : []),
+				...(installed ? [{ text: "installed", tone: "success" as const }] : []),
+				...(scope ? [{ text: scope, tone: "accent" as const }] : []),
+			]);
 
 			return {
 				value: id,
@@ -86,7 +94,15 @@ export class PluginSelectorComponent extends OverlayPanel {
 			icon: "plus",
 			noun: "plugins",
 			confirm: "Install",
-			decorate: item => (item.hint ? { facts: { marketplace: item.hint } } : undefined),
+			decorate: item => {
+				const [name] = splitPluginId(item.value);
+				if (!name) return undefined;
+				return {
+					label: name,
+					badges: badgesByValue.get(item.value) ?? [],
+					...(item.hint ? { facts: { marketplace: item.hint } } : {}),
+				};
+			},
 			columns: [{ id: "marketplace", format: "dim" }],
 		});
 	}

package/src/overlays/plugin-settings.ts

@@ -307,9 +307,15 @@ export class PluginListComponent extends OverlayPanel {
 		if (entries.length === 0) {
 			this.addChild(new Text(theme.fg("muted", "No plugins installed"), 0, 0));
 			this.addChild(new Spacer(1));
-			this.addChild(new Text(theme.fg("dim", "Install npm plugins:        zeta-c plugin install <package>"), 0, 0));
 			this.addChild(
-				new Text(theme.fg("dim", "Install marketplace plugins: zeta-c plugin install <name>@<marketplace>"), 0, 0),
+				new Text(theme.fg("dim", "Install npm plugins:        zetacode plugin install <package>"), 0, 0),
+			);
+			this.addChild(
+				new Text(
+					theme.fg("dim", "Install marketplace plugins: zetacode plugin install <name>@<marketplace>"),
+					0,
+					0,
+				),
 			);
 			this.addChild(new Spacer(1));
 

package/src/overlays/queue-mode-selector.ts

@@ -53,9 +53,19 @@ export class QueueModeSelectorComponent extends OverlayPanel {
 		this.addChild(this.#selectList);
 		this.#sheet = new SelectListSheet(this.#selectList, {
 			title: "Queue mode",
+			subtitle: "How messages you send while omp works are delivered",
 			icon: "list",
 			noun: "modes",
 			current: [currentMode],
+			// The terminal list shows the setting's values; the sheet names them for people.
+			decorate: item =>
+				item.value === "one-at-a-time"
+					? {
+							label: "One at a time",
+							detail: "Each queued message gets its own turn",
+							badges: [{ text: "recommended" }],
+						}
+					: { label: "All at once", detail: "Queued messages are sent together in one turn" },
 		});
 	}
 

package/src/overlays/report-panel.ts

@@ -129,11 +129,15 @@ export class ReportPanel extends OverlayPanel {
 		return this.#body.render(Math.max(1, width - 4)).length + TEXT_CHROME_ROWS;
 	}
 
-	/** The sheet body (the overlay is the frame, and its body the scroller): the report, then Close (Esc). */
+	/**
+	 * The sheet body (the overlay is the frame, and its body the scroller): the
+	 * report as `zeta.report.body`, which the terminal sets on the reading
+	 * measure, then Close (Esc) as the sheet's footer.
+	 */
 	override describe(): NativeNode {
 		const scroll = this.#scroll;
 		if (this.#native && this.#native.scroll === scroll) return this.#native.node;
-		const body: NativeNode = { ...col([this.#body]), key: "body", scroll };
+		const body: NativeNode = { ...col([this.#body], { role: "zeta.report.body" }), key: "body", scroll };
 		const node = col([body, actionBar([null, actionButton("Close", "close", { keys: "escape" })])], { gap: "md" });
 		this.#native = { scroll, node };
 		return node;