@iowarp/clio-coder 0.5.0 → 0.5.1

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

@@ -23,7 +23,6 @@ import { formatUserTaskHandoff } from "../domains/user-tasks/handoff.js";
 import type { UserTasksStore } from "../domains/user-tasks/store.js";
 import type { TUI } from "../engine/tui.js";
 import { type OpenContextOverlayOptions, openContextOverlay } from "./context-overlay.js";
-import { openCostOverlay } from "./cost-overlay.js";
 import {
 	type createDispatchBoardView,
 	isDispatchBoardRowCancellable,
@@ -43,6 +42,7 @@ import { openFleetRunApprovalOverlay } from "./overlays/fleet-run-approval.js";
 import { openSideQuestionOverlay } from "./overlays/side-question.js";
 import type { ContextClearCommandOptions } from "./slash-commands.js";
 import { openTasksOverlay } from "./tasks-overlay.js";
+import { openUsageOverlay } from "./usage-overlay.js";
 import { type ArtifactProviderDeps, createDefaultArtifactProviders } from "./view/artifacts.js";
 import { openViewOverlay } from "./view/view-overlay.js";
 
@@ -51,6 +51,8 @@ export interface OverlayGeneralOpenersDeps {
 	tui: TUI;
 	transitions: OverlayTransitions;
 	observability: ObservabilityContract;
+	getQuotaSnapshots?: () => ReadonlyArray<import("../domains/quota/types.js").UsageSnapshot>;
+	getDispatchRows?: () => ReadonlyArray<import("./dispatch-board.js").DispatchBoardRow>;
 	getSessionId?: () => string | null;
 	getContextLedger: () => ContextLedger;
 	contextChat: NonNullable<OpenContextOverlayOptions["chat"]>;
@@ -80,7 +82,7 @@ export interface OverlayGeneralOpenersDeps {
 	startDispatchBoardTicker: () => void;
 	closeOverlay: () => void;
 	showOverlayFrame?: typeof showClioOverlayFrame;
-	openCostOverlay?: typeof openCostOverlay;
+	openUsageOverlay?: typeof openUsageOverlay;
 	openContextOverlay?: typeof openContextOverlay;
 	openContextResetOverlay?: typeof openContextResetOverlay;
 	openTasksOverlay?: typeof openTasksOverlay;
@@ -121,7 +123,7 @@ export interface OverlayGeneralOpenersDeps {
 }
 
 export interface OverlayGeneralOpeners {
-	openCost(): void;
+	openUsage(): void;
 	openContextView(): void;
 	openContextReset(): void;
 	toggleFooter(): void;
@@ -136,7 +138,7 @@ export interface OverlayGeneralOpeners {
 }
 
 export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): OverlayGeneralOpeners {
-	const openCostOverlayFactory = deps.openCostOverlay ?? openCostOverlay;
+	const openUsageOverlayFactory = deps.openUsageOverlay ?? openUsageOverlay;
 	const openContextOverlayFactory = deps.openContextOverlay ?? openContextOverlay;
 	const openContextResetOverlayFactory = deps.openContextResetOverlay ?? openContextResetOverlay;
 	const openTasksOverlayFactory = deps.openTasksOverlay ?? openTasksOverlay;
@@ -146,11 +148,13 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 	const showOverlayFrameFactory = deps.showOverlayFrame ?? showClioOverlayFrame;
 	const openSideQuestionOverlayFactory = deps.openSideQuestionOverlay ?? openSideQuestionOverlay;
 
-	const openCost = (): void => {
+	const openUsage = (): void => {
 		if (deps.transitions.state !== "closed") return;
-		deps.transitions.state = "cost";
-		deps.transitions.handle = openCostOverlayFactory(deps.tui, deps.observability, {
+		deps.transitions.state = "usage";
+		deps.transitions.handle = openUsageOverlayFactory(deps.tui, deps.observability, {
 			sessionId: deps.getSessionId?.() ?? null,
+			...(deps.getQuotaSnapshots ? { getQuotaSnapshots: deps.getQuotaSnapshots } : {}),
+			...(deps.getDispatchRows ? { getDispatchRows: deps.getDispatchRows } : {}),
 			...(deps.readSessionEntries
 				? {
 						getSessionEntries: () => deps.readSessionEntries?.() ?? [],
@@ -525,7 +529,7 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 	};
 
 	return {
-		openCost,
+		openUsage,
 		openContextView,
 		openContextReset,
 		toggleFooter,

package/src/interactive/overlay-key-routing.ts

@@ -7,7 +7,7 @@ export type OverlayState =
 	| "permission-confirm"
 	| "dispatch-board"
 	| "auth"
-	| "cost"
+	| "usage"
 	| "context-view"
 	| "context-reset"
 	| "tasks"
@@ -213,8 +213,8 @@ function routeAuthOverlayKey(data: string, deps: CloseOverlayKeyDeps): boolean {
 	return false;
 }
 
-/** Pure overlay key router for the /cost overlay. Esc closes; everything else is swallowed. */
-function routeCostOverlayKey(data: string, deps: CloseOverlayKeyDeps): boolean {
+/** Esc closes an inspection overlay; callers decide how to route its remaining keys. */
+function routeReadOnlyOverlayKey(data: string, deps: CloseOverlayKeyDeps): boolean {
 	if (isEscapeKey(data)) {
 		deps.closeOverlay();
 		return true;
@@ -262,19 +262,16 @@ export function routeOverlayKey(
 		return true;
 	}
 	if (overlayState === "auth") return routeAuthOverlayKey(data, deps);
-	if (overlayState === "cost") {
-		routeCostOverlayKey(data, deps);
-		return true;
-	}
+	if (overlayState === "usage") return routeReadOnlyOverlayKey(data, deps);
 	if (overlayState === "context-view") {
-		routeCostOverlayKey(data, deps);
+		routeReadOnlyOverlayKey(data, deps);
 		return true;
 	}
 	// Esc is the only key the side-question overlay answers: it aborts a round
 	// that is still streaming and closes one that has settled. Everything else is
 	// swallowed so a keystroke cannot reach the composer behind it.
 	if (overlayState === "side-question") {
-		routeCostOverlayKey(data, deps);
+		routeReadOnlyOverlayKey(data, deps);
 		return true;
 	}
 	// The handoff review overlay owns Enter, `e`, the arrows, and Esc itself, so

package/src/interactive/overlay-lifecycle.ts

@@ -75,6 +75,8 @@ function interopProposalsFor(
 
 export interface OverlayLifecycleRuntimeDeps {
 	app: OverlayLifecycleApplicationDeps;
+	getQuotaSnapshots?: () => ReadonlyArray<import("../domains/quota/types.js").UsageSnapshot>;
+	getDispatchRows?: () => ReadonlyArray<import("./dispatch-board.js").DispatchBoardRow>;
 	tui: import("../engine/tui.js").TUI;
 	footer: import("./footer/dashboard.js").FooterDashboardPanel;
 	interactiveTickers: import("./interactive-tickers.js").InteractiveTickers;
@@ -117,7 +119,7 @@ export interface OverlayLifecycleRuntimeDeps {
 	openTreeOverlay?: typeof import("./overlays/tree-selector.js").openTreeOverlay;
 	openMessagePickerOverlay?: typeof import("./overlays/message-picker.js").openMessagePickerOverlay;
 	openCwdFallbackOverlay?: typeof import("./overlays/cwd-fallback.js").openCwdFallbackOverlay;
-	openCostOverlay?: typeof import("./cost-overlay.js").openCostOverlay;
+	openUsageOverlay?: typeof import("./usage-overlay.js").openUsageOverlay;
 	openContextOverlay?: typeof import("./context-overlay.js").openContextOverlay;
 	openContextResetOverlay?: typeof import("./overlays/context-reset.js").openContextResetOverlay;
 	openTasksOverlay?: typeof import("./tasks-overlay.js").openTasksOverlay;
@@ -140,7 +142,7 @@ export interface OverlayLifecycleController {
 	isAskUserWaiting(): boolean;
 	resetAskUserCancellation(): void;
 	refreshSettingsOverlay(): void;
-	openCostOverlayState(): void;
+	openUsageOverlayState(): void;
 	openContextViewOverlayState(): void;
 	openContextResetOverlayState(): void;
 	toggleFooterDashboardState(): void;
@@ -207,7 +209,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 		openTreeOverlay: openTreeOverlayFactory,
 		openMessagePickerOverlay: openMessagePickerOverlayFactory,
 		openCwdFallbackOverlay: openCwdFallbackOverlayFactory,
-		openCostOverlay: openCostOverlayFactory,
+		openUsageOverlay: openUsageOverlayFactory,
 		openContextOverlay: openContextOverlayFactory,
 		openContextResetOverlay: openContextResetOverlayFactory,
 		openTasksOverlay: openTasksOverlayFactory,
@@ -417,6 +419,8 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 		tui,
 		transitions: overlayTransitions,
 		observability: deps.app.observability,
+		...(deps.getQuotaSnapshots ? { getQuotaSnapshots: deps.getQuotaSnapshots } : {}),
+		...(deps.getDispatchRows ? { getDispatchRows: deps.getDispatchRows } : {}),
 		...(deps.app.getSessionId ? { getSessionId: deps.app.getSessionId } : {}),
 		getContextLedger: () => deps.app.chat.contextLedger(),
 		contextChat: deps.app.chat,
@@ -445,7 +449,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 		startDispatchBoardTicker: () => interactiveTickers.startDispatchBoardTicker(),
 		closeOverlay,
 		showOverlayFrame,
-		...(openCostOverlayFactory ? { openCostOverlay: openCostOverlayFactory } : {}),
+		...(openUsageOverlayFactory ? { openUsageOverlay: openUsageOverlayFactory } : {}),
 		...(openContextOverlayFactory ? { openContextOverlay: openContextOverlayFactory } : {}),
 		...(openContextResetOverlayFactory ? { openContextResetOverlay: openContextResetOverlayFactory } : {}),
 		...(openTasksOverlayFactory ? { openTasksOverlay: openTasksOverlayFactory } : {}),
@@ -462,7 +466,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 	const openResumeOverlayState = overlaySessions.openResume;
 	const openTreeOverlayState = overlaySessions.openTree;
 	const openMessagePickerOverlayState = overlaySessions.openMessagePicker;
-	const openCostOverlayState = overlayGeneralOpeners.openCost;
+	const openUsageOverlayState = overlayGeneralOpeners.openUsage;
 	const openContextViewOverlayState = overlayGeneralOpeners.openContextView;
 	const openContextResetOverlayState = overlayGeneralOpeners.openContextReset;
 	const toggleFooterDashboardState = overlayGeneralOpeners.toggleFooter;
@@ -484,7 +488,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 		isAskUserWaiting: overlayAskUser.isWaiting,
 		resetAskUserCancellation: overlayAskUser.resetCancellation,
 		refreshSettingsOverlay: overlayModelSelectors.refreshSettingsOverlay,
-		openCostOverlayState,
+		openUsageOverlayState,
 		openContextViewOverlayState,
 		openContextResetOverlayState,
 		toggleFooterDashboardState,

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

@@ -92,7 +92,7 @@ export interface OverlaySessionLifecycle {
 
 /**
  * The target and model a session started under, so reseeded calls land in the
- * same `/cost` bucket the live path writes to. Without it a single target read
+ * same `/usage` bucket the live path writes to. Without it a single target read
  * as two providers, one under the target id and one under the runtime name.
  */
 function sessionUsageDefaults(session: SessionContract): { target?: string | null; model?: string | null } {
@@ -120,7 +120,7 @@ function restorePriorSessionOrReopen(
 
 export function createOverlaySessionLifecycle(deps: OverlaySessionLifecycleDeps): OverlaySessionLifecycle {
 	/**
-	 * Point every running number the footer and `/cost` show at one branch. The
+	 * Point every running number the footer and `/usage` show at one branch. The
 	 * session total and the last-turn line are read off the same lineage in the
 	 * same call, so a switch cannot move one and leave the other behind.
 	 */
@@ -244,7 +244,7 @@ export function createOverlaySessionLifecycle(deps: OverlaySessionLifecycleDeps)
 					const replayMessages = buildModelReplayAgentMessagesFromTurns(turns, { uptoTurnId: turnId });
 					deps.chat.resetForSession(turnId, replayMessages);
 					// The same branch the transcript above was just scoped to. Without the
-					// leaf, /cost, the footer Σ, and the last-turn line kept reporting the
+					// leaf, /usage, the footer Σ, and the last-turn line kept reporting the
 					// abandoned turns.
 					rescopeToBranch(session, turns, turnId);
 				} catch (error) {

package/src/interactive/quota-view.ts

@@ -0,0 +1,229 @@
+import { costAggregateForAmount, formatCostAggregate } from "../domains/observability/index.js";
+import {
+	foldDuplicateAccounts,
+	formatPct,
+	primaryWindow,
+	type QuotaSeverity,
+	severityForPct,
+	windowSeverity,
+} from "../domains/quota/presentation.js";
+import type { UsageSnapshot } from "../domains/quota/types.js";
+import { sanitizeCallTargetText } from "../domains/safety/call-target.js";
+import { redactSecretString } from "../domains/safety/redaction.js";
+import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../engine/tui.js";
+import type { DispatchBoardRow } from "./dispatch-board.js";
+import { formatFooterTokens } from "./footer-panel.js";
+import { type ClioToken, clioTheme, formatCompactMs } from "./theme/index.js";
+
+const clean = (text: string) => sanitizeCallTargetText(redactSecretString(text));
+const tone = (severity: QuotaSeverity): ClioToken =>
+	severity === "critical" ? "error" : severity === "normal" ? "accent" : "warning";
+
+/** Filled cells always mean consumed usage, on every surface. */
+export function quotaMeter(usedPct: number, cells: number, severity: QuotaSeverity = severityForPct(usedPct)): string {
+	const count = Math.max(1, Math.floor(cells));
+	const used = Math.max(0, Math.min(100, Number.isFinite(usedPct) ? usedPct : 0));
+	const filled = Math.round((used / 100) * count);
+	const theme = clioTheme();
+	return theme.fg(tone(severity), "━".repeat(filled)) + theme.fg("frame", "─".repeat(count - filled));
+}
+
+export function quotaResetLabel(
+	reset: string | null,
+	now = Date.now(),
+	timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone,
+): string {
+	const timestamp = reset === null ? NaN : Date.parse(reset);
+	if (!Number.isFinite(timestamp)) return "Reset time not reported";
+	const absolute = new Intl.DateTimeFormat("en-US", {
+		month: "short",
+		day: "numeric",
+		hour: "numeric",
+		minute: "2-digit",
+		timeZone,
+	}).format(timestamp);
+	const minutes = Math.max(0, Math.ceil((timestamp - now) / 60_000));
+	const duration =
+		minutes >= 1440
+			? `${Math.floor(minutes / 1440)}d ${Math.floor((minutes % 1440) / 60)}h`
+			: minutes >= 60
+				? `${Math.floor(minutes / 60)}h ${minutes % 60}m`
+				: `${minutes}m`;
+	return minutes === 0
+		? `Reset time passed · awaiting provider update (${absolute} · ${timeZone})`
+		: `Resets in ${duration} · ${absolute} (${timeZone})`;
+}
+
+/** Account-wide facts only: never infer a worker's share from changing percentages. */
+export function renderQuotaAccounts(
+	snapshots: ReadonlyArray<UsageSnapshot>,
+	width: number,
+	options: { compact?: boolean; now?: number; timeZone?: string } = {},
+): string[] {
+	const theme = clioTheme();
+	const now = options.now ?? Date.now();
+	const accounts = foldDuplicateAccounts(snapshots).filter((account) => account.status !== "no_credentials");
+	if (!accounts.length) return [theme.fg("dim", "Subscriptions · loading")];
+	const out: string[] = [];
+	for (const account of accounts) {
+		const title = clean(`${account.displayName}${account.plan ? ` (${account.plan})` : ""}`);
+		const age =
+			account.fetchedAt === null ? null : Math.max(0, Math.floor((now - Date.parse(account.fetchedAt)) / 60_000));
+		const freshness = account.stale
+			? "STALE · last good reading"
+			: age === null || !Number.isFinite(age)
+				? ""
+				: age === 0
+					? "updated just now"
+					: `updated ${age}m ago`;
+		if (options.compact) {
+			const window = primaryWindow(account);
+			const ordered =
+				window && ["warning", "critical"].includes(windowSeverity(window))
+					? [window, ...account.windows.filter((item) => item !== window)]
+					: account.windows;
+			const windows = ordered
+				.map(
+					(item) =>
+						`${item.scope && item.scope !== item.label ? `${item.scope} ` : ""}${item.label} ${formatPct(item.usedPct)} used`,
+				)
+				.join(" · ");
+			const detail =
+				account.status !== "ok"
+					? (account.message ?? account.status)
+					: account.providerId === "local"
+						? "$0.00 · no subscription window consumed"
+						: windows || account.credits?.display || "no windows reported";
+			const meter = window && width >= 65 ? `${quotaMeter(window.usedPct, 8, windowSeverity(window))} ` : "";
+			out.push(
+				truncateToWidth(
+					`${meter}${theme.fg(account.status !== "ok" || account.stale ? "warning" : "muted", `${account.stale ? "STALE · " : ""}${title}`)}  ${clean(detail)}`,
+					width,
+					"…",
+					true,
+				),
+			);
+			continue;
+		}
+		if (out.length) out.push("");
+		out.push(theme.style("accent", title, { bold: true }));
+		if (freshness) out.push(theme.fg(account.stale ? "warning" : "dim", freshness));
+		if (account.status !== "ok")
+			out.push(theme.fg("warning", clean(`${account.status} · ${account.message ?? "usage unavailable"}`)));
+		let scope: string | undefined;
+		for (const window of account.windows) {
+			if (window.scope && scope !== window.scope) {
+				scope = window.scope;
+				out.push(theme.style("muted", clean(scope), { bold: true }));
+			}
+			const label = `${window.key.startsWith("weekly_scoped.") ? "Weekly" : window.label} · ${formatPct(window.usedPct)} used · ${formatPct(Math.max(0, 100 - window.usedPct))} remaining${window.active ? " · active limit" : ""}`;
+			out.push(clean(label));
+			out.push(quotaMeter(window.usedPct, Math.max(1, Math.min(48, width)), windowSeverity(window)));
+			out.push(theme.fg("dim", quotaResetLabel(window.resetsAt, now, options.timeZone)));
+		}
+		if (account.credits) {
+			out.push(
+				clean(
+					`${account.providerId === "local" ? "Local inference" : "Usage credits"} · ${account.credits.display}${account.credits.usedPct === null ? "" : ` · ${formatPct(account.credits.usedPct)} used`}`,
+				),
+			);
+			if (account.credits.usedPct !== null) out.push(quotaMeter(account.credits.usedPct, Math.min(48, width)));
+		}
+		if (account.status === "ok" && account.message)
+			out.push(theme.fg(account.stale ? "warning" : "dim", clean(account.message)));
+		if (account.status === "ok" && !account.windows.length && !account.credits && !account.message)
+			out.push(theme.fg("dim", "Connected · no usage windows reported"));
+		if (account.retryAfterSeconds != null) out.push(theme.fg("warning", `Retry after ${account.retryAfterSeconds}s`));
+	}
+	return out.flatMap((line) => (visibleWidth(line) > width ? wrapTextWithAnsi(line, Math.max(1, width)) : [line]));
+}
+
+/** The route must share the credential owner read by the quota adapter. */
+function routeAccount(
+	route: Pick<DispatchBoardRow, "runtimeId" | "node">,
+	snapshots: ReadonlyArray<UsageSnapshot>,
+): UsageSnapshot | undefined {
+	if (route.node && route.node !== "local") return undefined;
+	const provider = (
+		{
+			"claude-code": "claude-code",
+			"claude-sdk": "claude-code",
+			"anthropic-max": "anthropic-max",
+			"antigravity-code": "antigravity",
+		} as Record<string, string>
+	)[route.runtimeId];
+	// Clio's openai-codex OAuth storage is independent of Codex CLI auth.json.
+	return snapshots.find((item) => item.providerId === provider);
+}
+
+/** A weekly badge only when both the account and model group are known. */
+export function routeWeeklyQuota(
+	route: Pick<DispatchBoardRow, "runtimeId" | "wireModelId" | "node">,
+	snapshots: ReadonlyArray<UsageSnapshot>,
+): { label: string; account: string; severity: QuotaSeverity } | null {
+	const account = routeAccount(route, snapshots);
+	if (account?.status !== "ok") return null;
+	const weekly = account.windows.filter((window) => window.key === "weekly" || window.key.endsWith(".weekly"));
+	const model = route.wireModelId.toLowerCase();
+	const matches =
+		account.providerId === "antigravity"
+			? weekly.filter((window) => {
+					const scope = window.scope?.toLowerCase() ?? "";
+					if (model.includes("gemini")) return scope.includes("gemini");
+					if (/claude|opus|sonnet|haiku/.test(model)) return scope.includes("claude");
+					if (model.includes("gpt")) return scope.includes("gpt");
+					return false;
+				})
+			: weekly.filter((window) => !window.scope);
+	if (matches.length !== 1) return null;
+	const window = matches[0];
+	if (!window) return null;
+	return {
+		label: `${account.stale ? "STALE · " : ""}weekly ${formatPct(Math.max(0, Math.min(100, 100 - window.usedPct)))} left`,
+		account: account.displayName,
+		severity: windowSeverity(window),
+	};
+}
+
+export function workerQuotaLabel(
+	row: Pick<DispatchBoardRow, "runtimeId" | "node">,
+	snapshots: ReadonlyArray<UsageSnapshot>,
+): string {
+	// Remote workers and generic transports may use different credentials. Only
+	// known local credential owners can be associated with this process's reads.
+	if (row.node && row.node !== "local") return "Account quota unavailable for remote credentials";
+	const account = routeAccount(row, snapshots);
+	if (!account) return "Account quota not linked to this runtime";
+	if (account.status !== "ok") return `${account.displayName} · ${account.message ?? account.status}`;
+	return `Shared ${account.displayName}${account.stale ? " · STALE" : ""} · ${account.windows.map((window) => `${window.scope && window.scope !== window.label ? `${window.scope} ` : ""}${window.label} ${formatPct(Math.max(0, 100 - window.usedPct))} left`).join(" · ") || "no windows reported"}`;
+}
+
+export function renderWorkerUsage(
+	rows: ReadonlyArray<DispatchBoardRow>,
+	snapshots: ReadonlyArray<UsageSnapshot>,
+	width: number,
+): string[] {
+	const theme = clioTheme();
+	const out = [theme.fg("dim", "Active and recent workers · recorded tokens and cost · account limits are shared.")];
+	if (!rows.length) out.push("", "No worker invocations recorded.");
+	for (const row of rows) {
+		const cost = formatCostAggregate(costAggregateForAmount(row.costUsd, row.costProvenance)) ?? "cost not reported";
+		out.push(
+			"",
+			theme.style("agent", clean(`${row.agentId} · ${row.status} · ${formatCompactMs(row.elapsedMs)}`), { bold: true }),
+		);
+		out.push(clean(`${row.targetId} / ${row.wireModelId}${row.node ? ` · ${row.node}` : ""}`));
+		out.push(
+			row.tokenCount > 0 || row.inputTokens > 0 || row.outputTokens > 0 || row.progress?.inputTokens !== undefined
+				? `${formatFooterTokens(row.tokenCount)} recorded tokens · input ${formatFooterTokens(row.inputTokens)} · output ${formatFooterTokens(row.outputTokens)} · ${cost}`
+				: `Token usage not reported · ${cost}`,
+		);
+		if (row.lastContextTokens !== undefined)
+			out.push(
+				`Context ${formatFooterTokens(row.lastContextTokens)}${row.contextWindow ? ` / ${formatFooterTokens(row.contextWindow)}` : ""}`,
+			);
+		out.push(theme.fg("muted", clean(workerQuotaLabel(row, snapshots))));
+		out.push(theme.fg("dim", clean(`/view dispatch:${row.runId}`)));
+	}
+	return out.flatMap((line) => wrapTextWithAnsi(line, Math.max(1, width)));
+}

package/src/interactive/session-last-turn.ts

@@ -4,7 +4,7 @@
  * The line is a live accumulator: it describes whatever turn this process last
  * ran. current.jsonl is append-only, so after a `/tree` switch that turn can sit
  * on a branch the reader just left, and the line kept describing it while the Σ
- * total and `/cost` beside it had already been rescoped by the usage reseed. One
+ * total and `/usage` beside it had already been rescoped by the usage reseed. One
  * footer, two branches, no way to tell which line belonged to which.
  *
  * The fold reads the same lineage the reseed does, through

package/src/interactive/session-usage-reseed.ts

@@ -1,7 +1,7 @@
 /**
  * Rebuild the running usage totals from a session's own ledger.
  *
- * The `/cost` overlay and the footer both render one process-lifetime
+ * The `/usage` overlay and the footer both render one process-lifetime
  * accumulator, and only `startNewSession` ever reset it. Resuming did not, so a
  * resumed session showed the *previous* session's numbers under the resumed
  * session's id: one process, two sessions, byte-identical totals relabelled.
@@ -56,7 +56,7 @@ export interface SessionUsageSink {
  * `activeLeafTurnId` scopes the fold to one branch, through the same
  * `filterEntriesToActivePath` the transcript replays through. current.jsonl is
  * append-only, so after a `/tree` switch the abandoned sibling turns are still
- * in the file: the transcript stopped showing them and `/cost` and the footer Σ
+ * in the file: the transcript stopped showing them and `/usage` and the footer Σ
  * kept counting them, which put a session total on screen for turns the reader
  * had just been told were not on this branch. Omitted, the fold follows the
  * newest message's ancestry, the same fallback an offline read of the transcript

package/src/interactive/side-question.ts

@@ -100,7 +100,7 @@ function positive(value: unknown): number {
 }
 
 /**
- * Normalize one provider usage object into the shape `/cost` and the
+ * Normalize one provider usage object into the shape `/usage` and the
  * out-of-turn usage store take. Shared with the session pre-warm, which is
  * another call billed beside the session rather than inside it.
  */
@@ -144,7 +144,7 @@ function textFromMessage(message: unknown): string {
 
 /**
  * Run the side-question round. Resolves with the answer, the provider usage
- * (which is still real money and is reported to `/cost`), and whether the
+ * (which is still real money and is reported to `/usage`), and whether the
  * operator aborted it. Provider failures reject; the caller renders the reason
  * in the overlay.
  */

package/src/interactive/slash-commands.ts

@@ -183,7 +183,7 @@ type SlashCommandVariant =
 	| { kind: "fleet-run-usage"; reason?: string }
 	| { kind: "fleet" }
 	| { kind: "agents"; connect?: boolean }
-	| { kind: "cost" }
+	| { kind: "usage" }
 	| { kind: "context-view" }
 	| { kind: "tasks" }
 	| { kind: "decisions" }
@@ -706,7 +706,7 @@ export interface SlashCommandContext {
 	}>;
 	exportShareArchive?: (outPath: string) => { fileCount: number; path: string };
 	importShareArchive?: (path: string, options: { dryRun?: boolean; force?: boolean }) => ShareImportPlan;
-	openCost: () => void;
+	openUsage: () => void;
 	/**
 	 * `/doctor [deep]`: the CLI doctor's findings, rendered as one notice.
 	 * `deep` adds the live tool probe on the session's targets and the
@@ -1686,14 +1686,14 @@ export const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [
 		},
 	},
 	{
-		name: "cost",
-		description: "Show session token and cost totals",
+		name: "usage",
+		description: "Show subscription quota, credits, and session token and cost totals",
 		group: "Inspect",
-		kinds: ["cost"],
+		kinds: ["usage"],
 		args: {},
-		fromArgs: fromArgsOrUsage("cost", { kind: "cost" }),
+		fromArgs: fromArgsOrUsage("usage", { kind: "usage" }),
 		handle(_command, ctx) {
-			ctx.openCost();
+			ctx.openUsage();
 		},
 	},
 	{
@@ -2648,7 +2648,7 @@ const COMMAND_ORDER = [
 	"memory",
 	"view",
 	"panes",
-	"cost",
+	"usage",
 	"doctor",
 	"decisions",
 	"library",

package/src/interactive/turn-context.ts

@@ -1083,7 +1083,7 @@ export function createTurnContext(deps: TurnContextDeps): TurnContext {
 
 		// The checkpoint identifies the selected summary route; older results
 		// fall back to the active chat route. The ledger carries usage for reseed; this is the
-		// live sink, so `/cost` and the footer move the moment /context compact
+		// live sink, so `/usage` and the footer move the moment /context compact
 		// returns instead of staying byte-identical to before it ran.
 		recordCompactionUsage(agentRuntime, result);
 

package/src/interactive/turn-prewarm.ts

@@ -72,7 +72,7 @@ export interface TurnPrewarmDeps {
 	) => Promise<{ ok: true; runtime: AgentRuntime; apiKey: string | undefined } | { ok: false; reason: string }>;
 	/** Freeze the session tool surface onto the agent, exactly as a submit does. */
 	applySessionTools: (runtime: AgentRuntime) => void;
-	/** Report the round's provider usage under its own `/cost` label. */
+	/** Report the round's provider usage under its own `/usage` label. */
 	recordUsage: (runtime: AgentRuntime, usage: Usage | null) => void;
 	/**
 	 * Claim one in-flight request on the runtime's endpoint for the duration of