@iowarp/clio-coder 0.5.0 → 0.5.1

package/src/domains/quota/types.ts

@@ -0,0 +1,84 @@
+/**
+ * Read-only data model for provider subscription quota.
+ *
+ * The shapes mirror QuotaBubble's `providers/base.py` (`ProviderStatus`,
+ * `UsageWindow`, `UsageSnapshot`) so that adapters written against either
+ * project describe the same usage facts. Timestamps are ISO 8601 strings
+ * rather than `Date` objects so a snapshot stays structurally cloneable
+ * across the worker and transport boundaries.
+ */
+
+/** Outcome of one usage read, including the reasons a read produced no data. */
+export type QuotaStatus = "ok" | "no_credentials" | "expired" | "error" | "loading";
+
+/** One rate-limit window reported by a provider. */
+export interface UsageWindow {
+	/** Stable identity for ordering and lookup, for example "session" or "weekly". */
+	key: string;
+	/** Human label such as "5h" or "Weekly". */
+	label: string;
+	/** Canonical percentage consumed, 0 to 100. Adapters convert remaining fractions here. */
+	usedPct: number;
+	/** ISO 8601 instant the window resets, or null when the provider omitted it. */
+	resetsAt: string | null;
+	/** Compact label for a narrow surface such as a footer indicator. */
+	short?: string;
+	/** Model or product scope when the window covers less than the whole plan. */
+	scope?: string;
+	/** Provider-supplied severity word; Clio does not invent one. */
+	severity?: string;
+	/** True when the provider marks this window as the currently binding limit. */
+	active?: boolean;
+}
+
+/** Prepaid credit balance for providers that bill credits instead of windows. */
+export interface UsageCredits {
+	display: string;
+	usedPct: number | null;
+}
+
+/** Everything one provider reported about quota at a single point in time. */
+export interface UsageSnapshot {
+	providerId: string;
+	displayName: string;
+	status: QuotaStatus;
+	windows: UsageWindow[];
+	credits?: UsageCredits | null;
+	plan?: string | null;
+	message?: string | null;
+	/** Seconds to wait, captured from a 429 `Retry-After` header. */
+	retryAfterSeconds?: number | null;
+	/** True when the snapshot is a cached last-good value rather than a fresh read. */
+	stale?: boolean;
+	/** ISO 8601 instant of the read that produced this snapshot. */
+	fetchedAt: string | null;
+}
+
+/**
+ * One runtime's quota adapter. Implementations stay pure data plumbing:
+ * no UI, no dispatch admission, no credential writes.
+ */
+export interface QuotaProvider {
+	id: string;
+	displayName: string;
+	/** True when usable credentials are present, without spending a network call. */
+	detect(): Promise<boolean>;
+	/** Read current usage, reporting failure as a snapshot status rather than throwing. */
+	fetch(): Promise<UsageSnapshot>;
+}
+
+/** Parse a numeric `Retry-After` value into non-negative seconds. */
+export function parseRetryAfterSeconds(value: string | null | undefined): number | null {
+	if (!value) return null;
+	const seconds = Number.parseFloat(value.trim());
+	if (!Number.isFinite(seconds)) return null;
+	return Math.max(0, seconds);
+}
+
+/** Turn a raw plan identifier such as "max_5x" into a display plan such as "Max 5X". */
+export function formatPlan(value: string | null | undefined): string | null {
+	if (!value) return null;
+	const words = value.replace(/_/g, " ").trim();
+	if (!words) return null;
+	return words.replace(/\S+/g, (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());
+}

package/src/domains/session/usage.ts

@@ -5,7 +5,7 @@
  * for each call.
  *
  * This lives in the session domain because the ledger is the only durable
- * record of what a session spent, and three surfaces read it: the `/cost`
+ * record of what a session spent, and three surfaces read it: the `/usage`
  * overlay and footer reseed from it on every session change, and `clio-coder usage
  * report` folds it across sessions. It was written for the overlay first and
  * sat under src/interactive; a headless report reaching into the TUI surface's
@@ -94,7 +94,7 @@ export function ledgerUsageCalls(
 		// A compaction summarizes history through a real model call, billed like
 		// any other. Its usage rides on the compactionSummary entry rather than on
 		// an assistant message, because the summary is context machinery and never
-		// enters the conversation; folding it here is what puts it on `/cost` and
+		// enters the conversation; folding it here is what puts it on `/usage` and
 		// in `clio-coder usage report`.
 		if (entry?.kind === "compactionSummary") {
 			const usage = entry.usage;

package/src/engine/acp/commands.ts

@@ -590,7 +590,7 @@ function headlessContext(
 		listAgents: () => unreachable("listAgents"),
 		listDelegationAgents: () => unreachable("listDelegationAgents"),
 		shutdown: () => unreachable("shutdown"),
-		openCost: () => unreachable("openCost"),
+		openUsage: () => unreachable("openUsage"),
 		openSideQuestion: () => unreachable("openSideQuestion"),
 		startHandoff: () => unreachable("startHandoff"),
 		openContextView: () => unreachable("openContextView"),

package/src/entry/orchestrator.ts

@@ -925,7 +925,7 @@ async function runCompactionFlow(
 		isSplitTurn: result.isSplitTurn,
 		tokensAfter: estimateTokensAfterCompaction(entries, result),
 		// The summarization call is a real model call. Persisting its provider
-		// usage on the entry is what puts it in front of `/cost` and `clio-coder usage
+		// usage on the entry is what puts it in front of `/usage` and `clio-coder usage
 		// report`, which folded the ledger and so counted every call but this one.
 		...(result.usage !== undefined ? { usage: result.usage } : {}),
 	};
@@ -1495,7 +1495,7 @@ export async function bootOrchestrator(options: BootOptions = {}): Promise<BootR
 	// check and the cost row read the same resolution the step itself used.
 	/**
 	 * Account for one background memory step exactly as a `/btw` side question is
-	 * accounted for: the in-process cost tracker under its own label so `/cost`
+	 * accounted for: the in-process cost tracker under its own label so `/usage`
 	 * shows it while the session lives, and one durable out-of-turn row so
 	 * `clio-coder usage report` can still see it afterwards.
 	 *

package/src/interactive/chat-loop-messages.ts

@@ -379,7 +379,7 @@ export interface RunUsageSummary {
  * messages. Earlier versions of this function walked the list from the tail
  * and returned the first match, which silently dropped every intermediate
  * API call from the cost tally. Summing instead matches what the provider
- * actually billed and keeps the `/cost` overlay and footer counters
+ * actually billed and keeps the `/usage` overlay and footer counters
  * aligned across tool-heavy runs.
  */
 export function sumRunUsage(messages: ReadonlyArray<AgentMessage>): RunUsageSummary {
@@ -539,7 +539,7 @@ export function assistantSessionPayload(
  *
  * `estimated: true` is the provenance marker: no surface may report these as
  * provider-reported numbers. The usage fold and the context estimator both skip
- * aborted turns already, so this never reaches `/cost` or the window math; it is
+ * aborted turns already, so this never reaches `/usage` or the window math; it is
  * the record's own honesty about what the cancelled call cost.
  *
  * Returns null when the provider did report usage (there is nothing to fill in)

package/src/interactive/chat-loop.ts

@@ -362,7 +362,7 @@ export interface ChatLoop {
 	 *
 	 * Nothing this produces reaches the session ledger, the transcript, the
 	 * context ledger, or the footer token counters; the message history is read,
-	 * never mutated. The round's provider usage is still reported to `/cost`,
+	 * never mutated. The round's provider usage is still reported to `/usage`,
 	 * labeled as a side question, because money was spent. Refused outright
 	 * while a turn is in flight rather than queued.
 	 */
@@ -967,12 +967,12 @@ export function createChatLoop(deps: CreateChatLoopDeps): ChatLoop {
 		deps.recordOutOfTurnUsageRow ?? ((row: OutOfTurnUsageRow): void => appendOutOfTurnUsageRow(clioStateDir(), row));
 
 	/**
-	 * Report an out-of-turn round's provider usage. Money was spent, so `/cost`
+	 * Report an out-of-turn round's provider usage. Money was spent, so `/usage`
 	 * says so under its own label; turn persistence, the working-set ledger,
 	 * compaction inputs, and the footer counters never see it.
 	 *
 	 * The same call is also appended to the out-of-turn usage store under the
-	 * state dir. That store exists because `/cost` only knows what this process
+	 * state dir. That store exists because `/usage` only knows what this process
 	 * spent: the round appends nothing to the session JSONL by design, so an
 	 * archive reader such as `clio-coder usage report` had no record of the
 	 * spend at all once the process exited. The session ledger stays untouched.

package/src/interactive/dispatch-board.ts

@@ -23,12 +23,14 @@ import {
 } from "../domains/observability/index.js";
 import type { WorkerAction, WorkerProgressSnapshot } from "../domains/observability/worker-progress.js";
 import { type CostProvenance, foregroundStreamUsage } from "../domains/providers/index.js";
+import type { UsageSnapshot } from "../domains/quota/types.js";
 import { sanitizeCallTargetText } from "../domains/safety/call-target.js";
 import { type Component, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../engine/tui.js";
 import { formatWorkerContextMeter } from "./context-meter.js";
 import { COUNCIL_SYNTHESIS_LABEL } from "./council.js";
 import { type CouncilGroupView, type CouncilMemberView, councilGroupBody, councilIslandLines } from "./council-grid.js";
 import { formatFooterTokens } from "./footer-panel.js";
+import { routeWeeklyQuota } from "./quota-view.js";
 import { presentWorkerContractAnswer, safeWorkerAnswerText } from "./renderers/worker-answer.js";
 import {
 	type ClioTheme,
@@ -780,8 +782,9 @@ function renderDispatchCard(
 	return frame(theme, cardTitle, bodyLines, width, { rightMeta: elapsed });
 }
 
-function renderTaskIslandRow(row: DispatchBoardRow, width: number): string[] {
+function renderTaskIslandRow(row: DispatchBoardRow, width: number, quota: ReadonlyArray<UsageSnapshot>): string[] {
 	const theme = clioTheme();
+	const weekly = routeWeeklyQuota(row, quota);
 	const agentLabel = agentDisplayLabel(row);
 	const elapsed = formatCompactMs(row.elapsedMs);
 	const cost = formatCostAggregate(costAggregateForAmount(row.costUsd, row.costProvenance)) ?? COST_NOT_MEASURED;
@@ -854,6 +857,17 @@ function renderTaskIslandRow(row: DispatchBoardRow, width: number): string[] {
 		...quality.map((line) => padAnsi(theme.fg("muted", line), width)),
 		...task.map((line) => padAnsi(line, width)),
 		padAnsi(telemetry, width),
+		...(weekly
+			? [
+					padAnsi(
+						theme.fg(
+							weekly.severity === "critical" ? "error" : weekly.severity === "normal" ? "dim" : "warning",
+							`  Shared account · ${weekly.label}`,
+						),
+						width,
+					),
+				]
+			: []),
 		...wrapTextWithAnsi(theme.fg("dim", `  /view dispatch:${row.runId}`), width),
 	];
 }
@@ -1110,7 +1124,11 @@ export function createDispatchBoardView(
 	};
 }
 
-export function formatTaskIslandLines(rows: ReadonlyArray<DispatchBoardRow>, maxRows = 4): string[] {
+export function formatTaskIslandLines(
+	rows: ReadonlyArray<DispatchBoardRow>,
+	maxRows = 4,
+	quota: ReadonlyArray<UsageSnapshot> = [],
+): string[] {
 	// Councils are folded before the row cap, so a five-member council costs the
 	// island one card and never crowds out the runs beside it.
 	const items = dispatchBoardItems(rows.filter((row) => !isHelperRun(row)));
@@ -1131,7 +1149,7 @@ export function formatTaskIslandLines(rows: ReadonlyArray<DispatchBoardRow>, max
 			body.push(
 				...(item.kind === "council"
 					? councilIslandLines(clioTheme(), item.group, TASK_ISLAND_WIDTH)
-					: renderTaskIslandRow(item.row, TASK_ISLAND_WIDTH)),
+					: renderTaskIslandRow(item.row, TASK_ISLAND_WIDTH, quota)),
 			);
 		}
 		const hidden = items.length - visibleItems.length;

package/src/interactive/footer/dashboard.ts

@@ -14,6 +14,7 @@ import {
 	resolveModelCapabilities,
 	resolveModelRuntimeCapabilitiesForProviders,
 } from "../../domains/providers/index.js";
+import type { UsageSnapshot } from "../../domains/quota/types.js";
 import type { LocalCapacity } from "../../domains/scheduling/local-capacity.js";
 import type { ContextUsageSnapshot } from "../../domains/session/context-accounting.js";
 import type { ContextLedger } from "../../domains/session/context-ledger.js";
@@ -88,6 +89,7 @@ export type { ToolTallySnapshot } from "./widgets.js";
 export type FooterDashboardMode = "compact" | "expanded";
 
 export interface FooterDashboardDeps {
+	getQuotaSnapshots?: () => ReadonlyArray<UsageSnapshot>;
 	getConnections?: () => { mcp: string[]; plugins: string[] };
 	getExtensionStatus?: () => ReadonlyArray<string>;
 	providers: ProvidersContract;
@@ -127,6 +129,8 @@ export interface FooterDashboardDeps {
 }
 
 export interface FooterDashboardRenderState {
+	quota?: ReadonlyArray<UsageSnapshot>;
+	quotaRoute?: Pick<DispatchBoardRow, "runtimeId" | "wireModelId" | "node">;
 	demoHint?: string | null;
 	resources?: LocalMachineMetrics | null;
 	connections?: { mcp: string[]; plugins: string[] };
@@ -413,6 +417,15 @@ export function buildFooterDashboard(deps: FooterDashboardDeps): FooterDashboard
 
 		return {
 			resources: machine.snapshot(),
+			quota: deps.getQuotaSnapshots?.() ?? [],
+			...(current?.runtime && wireModelId
+				? {
+						quotaRoute: {
+							runtimeId: current.runtime.id,
+							wireModelId,
+						},
+					}
+				: {}),
 			...(deps.getConnections ? { connections: deps.getConnections() } : {}),
 			...(settings ? { costCeilingUsd: settings.safety.limits.sessionCostUsd } : {}),
 

package/src/interactive/footer/key-hints.ts

@@ -14,8 +14,8 @@ export function footerKeyHint(now: number, narrow = false): string | null {
 		}),
 	];
 	const count = narrow ? 1 : 2;
-	const page = Math.floor(now / 12_000) % (Math.ceil(entries.length / count) + 1);
-	if (page === Math.ceil(entries.length / count)) return null;
+	if (!entries.length) return null;
+	const page = Math.floor(now / 12_000) % Math.ceil(entries.length / count);
 	const start = page * count;
 	return entries.slice(start, start + count).join(" · ");
 }

package/src/interactive/footer/pages.ts

@@ -1,4 +1,5 @@
 import { costAggregateForAmount, formatCostAggregate } from "../../domains/observability/index.js";
+import type { UsageSnapshot } from "../../domains/quota/types.js";
 /** Expanded footer pages: dense inspection, separate from transcript output style. */
 import { sanitizeCallTargetText } from "../../domains/safety/call-target.js";
 import { redactSecretString } from "../../domains/safety/redaction.js";
@@ -6,6 +7,7 @@ import { getKeybindings, truncateToWidth, visibleWidth, wrapTextWithAnsi } from
 import { contextCategorySwatch, renderContextMeterBar, renderContextMeterGrid } from "../context-meter.js";
 import { type DispatchBoardRow, dispatchStatusPresentation, renderDispatchActivity } from "../dispatch-board.js";
 import { formatFooterTokens } from "../footer-panel.js";
+import { renderQuotaAccounts, routeWeeklyQuota } from "../quota-view.js";
 import { previewRows } from "../renderers/preview.js";
 import { clioTheme, formatCompactMs, rule } from "../theme/index.js";
 import { fitIdentityLabel } from "../theme/labels.js";
@@ -18,7 +20,12 @@ export type DashboardPage = (typeof DASHBOARD_PAGES)[number];
 const ACTIVE_AGENT_STATUSES = new Set(["running", "enqueued", "cancelling", "retrying", "stale"]);
 const clean = (value: string) => sanitizeCallTargetText(redactSecretString(value));
 
-function agentCard(row: DispatchBoardRow, width: number, compact = false): string[] {
+function agentCard(
+	row: DispatchBoardRow,
+	width: number,
+	compact = false,
+	quota: ReadonlyArray<UsageSnapshot> = [],
+): string[] {
 	const theme = clioTheme();
 	const presentation = dispatchStatusPresentation(row.status, { compact: false });
 	const name = clean(row.agentId).replace(
@@ -34,6 +41,9 @@ function agentCard(row: DispatchBoardRow, width: number, compact = false): strin
 	const field = (label: string, value: string) =>
 		wrapTextWithAnsi(`${theme.fg("dim", `${label}  `)}${clean(value)}`, width);
 	lines.push(...previewRows(field("Route", `${row.targetId}/${row.wireModelId}`), 2, width));
+	const weekly = routeWeeklyQuota(row, quota);
+	if (weekly)
+		lines.push(...previewRows(field("Account", `Shared ${weekly.account} · ${weekly.label}`), compact ? 1 : 2, width));
 	if (row.taskSummary)
 		lines.push(...(compact ? previewRows(field("Task", row.taskSummary), 2, width) : field("Task", row.taskSummary)));
 	const activity = renderDispatchActivity(row, width);
@@ -107,8 +117,8 @@ function activityPage(state: FooterDashboardRenderState, width: number, budget:
 		if (first && second) {
 			cards.push(
 				...zipColumns(
-					agentCard(first, col, true),
-					agentCard(second, width - col - 5, true),
+					agentCard(first, col, true, state.quota),
+					agentCard(second, width - col - 5, true, state.quota),
 					col,
 					width - col - 5,
 					`  ${theme.fg("frame", "│")}  `,
@@ -119,7 +129,7 @@ function activityPage(state: FooterDashboardRenderState, width: number, budget:
 		}
 	} else
 		for (const row of active) {
-			const card = agentCard(row, width, active.length > 1 || cardBudget < 18);
+			const card = agentCard(row, width, active.length > 1 || cardBudget < 18, state.quota);
 			if (cards.length + card.length + 2 > cardBudget && shown > 0) break;
 			cards.push(...card, "");
 			shown++;
@@ -183,6 +193,7 @@ function contextPage(state: FooterDashboardRenderState, width: number): string[]
 			width,
 		),
 	];
+	out.push(theme.fg("dim", "Context occupancy is per request; subscription limits are account-wide · /usage"));
 	const gridWidth = Math.max(12, Math.min(64, width >= 76 ? Math.floor(width * 0.38) : width));
 	const gridHeight = width >= 76 ? 8 : 3;
 	const grid = renderContextMeterGrid(ledger, gridWidth, gridHeight, theme);
@@ -248,7 +259,7 @@ function contextPage(state: FooterDashboardRenderState, width: number): string[]
 	return out;
 }
 
-/** Two-line ambient strip. Notices borrow workspace space until dismissed/expired. */
+/** Model and context above; persistent workspace and a rotating hint area below. */
 export function renderCompactDashboard(state: FooterDashboardRenderState, width: number): string[] {
 	const theme = clioTheme();
 	const w = Math.max(1, width);
@@ -262,8 +273,21 @@ export function renderCompactDashboard(state: FooterDashboardRenderState, width:
 	const usage = `${formatFooterTokens(ledger?.usedTokens ?? state.context.used ?? 0)} / ${(ledger?.contextWindow ?? state.context.contextWindow) ? formatFooterTokens(ledger?.contextWindow ?? state.context.contextWindow ?? 0) : "?"}`;
 	const context = `${ledger ? renderContextMeterBar(ledger, w >= 100 ? 14 : 8, theme) : ""} ${usage}`;
 	const rightWidth = Math.min(Math.floor(w * 0.48), visibleWidth(context));
-	const identityRoom = Math.max(8, w - rightWidth - visibleWidth(thinking) - visibleWidth(activity) - 10);
-	const left = `${activity}  ·  ${theme.fg("muted", fitIdentityLabel(identity, identityRoom))} · ${thinking}`;
+
+	const weekly = state.quotaRoute ? routeWeeklyQuota(state.quotaRoute, state.quota ?? []) : null;
+	const leftRoom = Math.max(1, w - rightWidth - 3);
+	const activityLabel = fit(activity, Math.min(visibleWidth(activity), Math.max(5, Math.floor(leftRoom / 3))));
+	const badge =
+		weekly && leftRoom - visibleWidth(activityLabel) - visibleWidth(weekly.label) >= 16
+			? theme.fg(
+					weekly.severity === "critical" ? "error" : weekly.severity === "normal" ? "muted" : "warning",
+					weekly.label,
+				)
+			: "";
+	const baseRoom = leftRoom - visibleWidth(activityLabel) - (badge ? visibleWidth(badge) + 3 : 0) - 5;
+	const showThinking = baseRoom - visibleWidth(thinking) - 3 >= 12;
+	const identityRoom = Math.max(1, baseRoom - (showThinking ? visibleWidth(thinking) + 3 : 0));
+	const left = `${activityLabel}  ·  ${theme.fg("muted", fitIdentityLabel(identity, identityRoom))}${badge ? ` · ${badge}` : ""}${showThinking ? ` · ${thinking}` : ""}`;
 	const pair = (l: string, r: string, rw: number) => `${fit(l, w - rw - 3)}   ${fit(r, rw)}`;
 	const notice = [...state.notices]
 		.filter((n) => n.expiresAt === null || n.expiresAt > state.now)
@@ -283,21 +307,31 @@ export function renderCompactDashboard(state: FooterDashboardRenderState, width:
 				)
 			: state.demoHint
 				? `${theme.fg("accent", "Tip")} ${theme.fg("muted", clean(state.demoHint))}`
-				: theme.fg(
-						"dim",
-						footerKeyHint(state.now, w < 80) ??
-							`${clean(state.workspace.cwd)} · ${clean(state.workspace.branch ?? "no Git branch")}${state.workspace.dirty ? " *" : ""}`,
-					);
-	const hint = theme.fg("muted", `${state.session.throughput ? `${state.session.throughput}  ·  ` : ""}${key}`);
-	return [
-		fit(pair(left, context, rightWidth)),
-		fit(pair(foot, hint, Math.min(Math.floor(w * 0.4), visibleWidth(hint)))),
-	];
+				: theme.fg("dim", footerKeyHint(state.now, w < 120) ?? `${key} Dashboard`);
+	const hintWidth = Math.min(Math.floor(w * 0.48), visibleWidth(foot));
+	const workspaceWidth = Math.max(1, w - hintWidth - 3);
+	const git = `${clean(state.workspace.branch ?? "no Git branch")}${state.workspace.dirty ? " *" : ""}`;
+	const gitWidth = Math.min(visibleWidth(git), Math.max(4, Math.floor(workspaceWidth * 0.45)));
+	const cwdWidth = Math.max(1, workspaceWidth - gitWidth - 3);
+	const workspace = theme.fg(
+		"dim",
+		`${fitIdentityLabel(clean(state.workspace.cwd), cwdWidth)} · ${fitIdentityLabel(git, gitWidth)}`,
+	);
+	return [fit(pair(left, context, rightWidth)), fit(pair(workspace, foot, hintWidth))];
 }
 
 function statusPage(state: FooterDashboardRenderState, width: number): string[] {
 	const theme = clioTheme();
 
+	const quotaRows = [
+		theme.style(
+			"accent",
+			`SESSION · ${formatFooterTokens(state.sessionTokens?.totalTokens ?? 0)} recorded tokens · ${formatCostAggregate(state.sessionCost) ?? "cost not yet priced"}`,
+			{ bold: true },
+		),
+		...renderQuotaAccounts(state.quota ?? [], width, { compact: true, now: state.now }),
+	];
+
 	const active = state.dispatchRows.filter((row) => ACTIVE_AGENT_STATUSES.has(row.status));
 	const completed = state.dispatchRows.filter((row) => row.status === "completed").length;
 	const failed = state.dispatchRows.filter((row) => ["failed", "dead", "aborted"].includes(row.status)).length;
@@ -334,7 +368,6 @@ function statusPage(state: FooterDashboardRenderState, width: number): string[]
 		["Target", state.session.target ?? "not selected"],
 		["Tracked cost", formatCostAggregate(state.sessionCost) ?? "not yet priced"],
 		["Clio ceiling", state.costCeilingUsd === undefined ? "unknown" : `$${state.costCeilingUsd} · tracked pricing only`],
-		["Provider quota", "not reported by provider"],
 		["MCP connected", names(state.connections?.mcp)],
 		["Plugins active", names(state.connections?.plugins)],
 		[
@@ -404,6 +437,7 @@ function statusPage(state: FooterDashboardRenderState, width: number): string[]
 	];
 	if (width < 76)
 		return [
+			...quotaRows,
 			...section("COST & CONNECTIONS", left, width),
 			...section("LOCAL MACHINE", right, width),
 			theme.fg("accent", "CONTEXT ENGINE"),
@@ -414,6 +448,7 @@ function statusPage(state: FooterDashboardRenderState, width: number): string[]
 		];
 	const col = Math.floor((width - 5) / 2);
 	return [
+		...quotaRows,
 		...zipColumns(
 			section("COST & CONNECTIONS", left, col),
 			section("LOCAL MACHINE", right, width - col - 5),
@@ -457,7 +492,7 @@ export function renderDashboardPage(
 	const hint = truncateToWidth(
 		theme.fg(
 			"muted",
-			`${cycleKey || "Dashboard"} → ${next}   ·   ${page === "Status" ? "/cost · /mcp · /library" : "composer stays active"}`,
+			`${cycleKey || "Dashboard"} → ${next}   ·   ${page === "Status" ? "/usage · /mcp · /library" : "composer stays active"}`,
 		),
 		safeWidth,
 		"…",
@@ -475,7 +510,7 @@ export function renderDashboardPage(
 				? `${getKeybindings().getKeys("clio-coder.dispatchBoard.toggle").join("/") || "Fleet Runs"} · /view`
 				: page === "Context"
 					? "/context"
-					: "/cost · /context";
+					: "/usage · /context";
 		content = [
 			...content.slice(0, available - 1),
 			truncateToWidth(theme.fg("dim", `More detail: ${detail}`), safeWidth, "…", true),

package/src/interactive/footer-panel.ts

@@ -30,7 +30,7 @@ export function formatFooterTokens(n: number): string {
  * Build the token-counter footer segment. Returns `null` when no usage has
  * landed yet so the footer stays uncluttered at session start. Cache-read
  * tokens are omitted here to keep the line scannable; reasoning tokens are
- * shown only when the provider exposes them. The `/cost` overlay exposes the
+ * shown only when the provider exposes them. The `/usage` overlay exposes the
  * full breakdown.
  */
 export function tokensSegment(usage: UsageBreakdown | null | undefined): string | null {

package/src/interactive/interactive-application.ts

@@ -840,7 +840,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		expandSubmit: (text) => expandInteractiveSubmitAsync(text, deps.resources),
 		openAskUser: (questions, options) => openAskUserOverlayState(questions, options),
 		openSkillsHub: (request) => openSkillsHubState(request),
-		openCost: () => openCostOverlayState(),
+		openUsage: () => openUsageOverlayState(),
 		openSideQuestion: (question) => openSideQuestionOverlayState(question),
 		startHandoff: (goal) => startHandoffState(goal),
 		startFleetRun: (name, vars) => startFleetRunState(name, vars),
@@ -901,6 +901,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 	editor.onSubmit = editorSubmit.submitEditorText;
 
 	const interactiveTickers = createInteractiveTickers({
+		getQuotaSnapshots: presentation.getQuotaSnapshots,
 		tui,
 		dispatchBoardStore,
 		contextActivityStore,
@@ -937,6 +938,8 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		resetTranscript();
 	};
 	overlayLifecycle = createOverlayLifecycle({
+		getQuotaSnapshots: presentation.getQuotaSnapshots,
+		getDispatchRows: () => dispatchBoardStore.rows(),
 		app: deps,
 		tui,
 		footer,
@@ -972,7 +975,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 	const {
 		closeOverlay,
 		openAskUserOverlayState,
-		openCostOverlayState,
+		openUsageOverlayState,
 		openSideQuestionOverlayState,
 		startHandoffState,
 		startFleetRunState,

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

@@ -326,7 +326,7 @@ export function createInteractiveInputRuntime(deps: InteractiveInputRuntimeDeps)
 		},
 		cancelFocusedOwner: () => {
 			const state = deps.overlay.getState();
-			if (["permission-confirm", "cost", "context-view", "side-question", "dispatch-board", "auth"].includes(state))
+			if (["permission-confirm", "usage", "context-view", "side-question", "dispatch-board", "auth"].includes(state))
 				deps.overlay.closeOverlay();
 			else if (focused()?.handleInput) {
 				focused()?.handleInput?.("\x1b");
@@ -531,7 +531,7 @@ function overlayScopeLabel(state: OverlayState): string {
 		"permission-confirm": "Permission",
 		"dispatch-board": "Workers",
 		auth: "Authentication",
-		cost: "Usage",
+		usage: "Usage",
 		"context-view": "Context",
 		"context-reset": "Context reset",
 		tasks: "Tasks",

package/src/interactive/interactive-presentation.ts

@@ -13,6 +13,8 @@ import type {
 	TokenThroughputSnapshot,
 } from "../domains/observability/index.js";
 import { type ProvidersContract, resolveModelRuntimeCapabilitiesForProviders } from "../domains/providers/index.js";
+import { createQuotaSummaryFeed } from "../domains/quota/summary-feed.js";
+import type { UsageSnapshot } from "../domains/quota/types.js";
 import type { ResourcesContract } from "../domains/resources/index.js";
 import type { LocalCapacity } from "../domains/scheduling/local-capacity.js";
 import { ceilChars, contentChars } from "../domains/session/context-accounting.js";
@@ -160,6 +162,7 @@ export interface InteractivePresentation {
 	changeOutputStyle(mutation: () => void): void;
 	setLocalBashRunning(running: boolean): void;
 	getObservabilitySnapshot(): ObservabilitySnapshot;
+	getQuotaSnapshots(): ReadonlyArray<UsageSnapshot>;
 	/** Fold one raw chat event into the ephemeral throughput shown only while this turn is active. */
 	recordChatEvent(event: ChatLoopEvent): void;
 	recordToolStart(toolCallId: string, toolName: string): void;
@@ -234,6 +237,12 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		return key === undefined || key.length === 0 ? null : formatKeyLabel(key, "");
 	};
 
+	const quotaSummary = createQuotaSummaryFeed({
+		onUpdate: () => {
+			footer?.refresh();
+			requestRender();
+		},
+	});
 	const banner = factories.createBanner({
 		providers: deps.providers,
 		...(deps.agents ? { getAgentCount: () => deps.agents?.listSpecs().filter(isUserVisibleAgent).length ?? 0 } : {}),
@@ -248,6 +257,9 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 			return key ? formatKeyLabel(key, "") : null;
 		},
 		onFactsRefreshed: requestRender,
+		// Subscription usage is read lazily off the render path and cached, so the
+		// banner reads a string and never awaits a provider.
+		getQuotaSummary: () => quotaSummary.peek(),
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
 	});
 	// A boot-time `--continue`/`--session` resume opens onto an existing
@@ -391,6 +403,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		getTokenThroughput: () =>
 			liveThroughput === null ? observabilitySnapshot.session.latestThroughput : currentLiveThroughput(),
 		getSessionCost: () => observabilitySnapshot.session.cost,
+		getQuotaSnapshots: () => quotaSummary.peekSnapshots(),
 		getContextUsage: () => deps.chat.contextUsage(),
 		getContextLedger: () => deps.chat.contextLedger(),
 		getDispatchRows: () => dispatchBoardStore.rows(),
@@ -622,6 +635,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		beforeStatusDisposed = true;
 		// Before the subscriptions go: a project-context refresh already in flight
 		// must not land afterwards and ask a torn-down presentation for a frame.
+		quotaSummary.dispose();
 		banner.dispose();
 		footer.dispose();
 		unsubscribeObservability();
@@ -664,6 +678,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		changeOutputStyle: (mutation) =>
 			chatRenderer.mutate(() => preserveTranscriptScroll(transcriptView, deps.terminal.columns, mutation), "output-style"),
 		getObservabilitySnapshot: () => observabilitySnapshot,
+		getQuotaSnapshots: () => quotaSummary.peekSnapshots(),
 		recordChatEvent,
 		recordToolStart: (toolCallId, toolName) => {
 			footerActiveTools.add(toolCallId);

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

@@ -127,7 +127,7 @@ export interface InteractiveSlashRuntimeDeps {
 	expandSubmit: (text: string) => Promise<InteractiveSlashSubmitExpansion>;
 	openAskUser: AskUserHandler;
 	openSkillsHub: (request?: LibraryBrowseRequest) => void;
-	openCost: () => void;
+	openUsage: () => void;
 	/** Run one `/btw` side question in its own overlay. */
 	openSideQuestion: (question: string) => void;
 	/** Run one `/handoff <goal>`: extract, review, and seed a successor session. */
@@ -461,7 +461,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 				? deps.share.planImport(resolve(archivePath), importOptions)
 				: deps.share.importArchive(resolve(archivePath), importOptions);
 		},
-		openCost: deps.openCost,
+		openUsage: deps.openUsage,
 		openSideQuestion: deps.openSideQuestion,
 		// `/oracle` is refused, never queued, while a turn streams: the digest it
 		// packs describes the record as it stands.

package/src/interactive/interactive-tickers.ts

@@ -1,3 +1,4 @@
+import type { UsageSnapshot } from "../domains/quota/types.js";
 import { type TaskBoardSnapshot, type TaskBoardStore, taskBoardCounts } from "../domains/session/task-board.js";
 import { Text, type TUI, visibleWidth, wrapTextWithAnsi } from "../engine/tui.js";
 import {
@@ -28,6 +29,7 @@ export interface InteractiveTickersDeps {
 	dispatchBoardStore: InteractiveDispatchStore;
 	contextActivityStore: InteractiveContextActivityStore;
 	getOverlayState: () => string;
+	getQuotaSnapshots?: () => ReadonlyArray<UsageSnapshot>;
 	isFooterExpanded: () => boolean;
 	/** Bound to TaskBoardStore.cachedSnapshot; repaint must never fold the session ledger. */
 	getTaskBoard?: TaskBoardStore["cachedSnapshot"];
@@ -126,7 +128,11 @@ export function createInteractiveTickers(deps: InteractiveTickersDeps): Interact
 		taskIslandHidden = hidden;
 		if (rows.length > 0)
 			taskIsland.setText(
-				formatTaskIslandLines(rows, Math.max(1, Math.min(4, Math.floor((taskIslandHeight - 8) / 9)))).join("\n"),
+				formatTaskIslandLines(
+					rows,
+					Math.max(1, Math.min(4, Math.floor((taskIslandHeight - 8) / 10))),
+					deps.getQuotaSnapshots?.() ?? [],
+				).join("\n"),
 			);
 		else if (board) taskIsland.setText(formatTaskBoardIslandLines(board).join("\n"));
 		taskIsland.invalidate();