zidane-ui 9.0.4 → 9.1.3

package/dist/session/headless/usage-format.d.ts

@@ -1,4 +1,4 @@
-import { UsageHeatmapDay, UsageModelDayPoint } from "./usage.js";
+import { formatTokens } from "zidane/chat/pure";
 //#region src/session/headless/usage-format.d.ts
 /**
  * Local `YYYY-MM-DD` for a Date. Matches SQLite's `date(…, 'localtime')`
@@ -7,95 +7,5 @@ import { UsageHeatmapDay, UsageModelDayPoint } from "./usage.js";
  * @param d - The date.
  */
 declare function localDayString(d: Date): string;
-/**
- * 12.3k / 4.6M / 1.2B — one decimal below 100 of a unit, whole above (core `formatCount`).
- *
- * @param n - A token count.
- */
-declare function formatTokens(n: number): string;
-/**
- * USD: core `formatCostLabel` below $10 (`$0.004`, never `$0.00`), whole dollars below $10k, then $12.3k.
- *
- * @param usd - An amount in US dollars.
- */
-declare function formatCost(usd: number): string;
-/**
- * 0-23 → "9 am" / "2 pm" / "12 pm".
- *
- * @param hour - A local hour, 0-23.
- */
-declare function formatHour(hour: number): string;
-/**
- * `seed` selects the comparison deterministically (day-of-year keeps it
- * stable within a day but rotating across days). Returns `null` when
- * the total is too small for the multiple to land (< 2× the work).
- *
- * @param totalTokens - The tokens processed.
- * @param seed - Picks the comparison (the day of the year).
- */
-declare function tokenComparison(totalTokens: number, seed: number): string | null;
-/** One day of the activity heatmap. */
-interface HeatmapCell {
-  /** Local `YYYY-MM-DD`. */
-  day: string;
-  /** Tokens that day. */
-  tokens: number;
-  /** User messages that day. */
-  messages: number;
-  /** 0 = no activity … 4 = top quartile of active days. */
-  level: 0 | 1 | 2 | 3 | 4;
-  /** Grid column (week index, 0 = oldest). */
-  week: number;
-  /** Grid row (0 = Sunday … 6 = Saturday). */
-  weekday: number;
-}
-/** The activity heatmap: a week × weekday grid. */
-interface HeatmapGrid {
-  /** Every day of the span, oldest first. */
-  cells: HeatmapCell[];
-  /** Columns. */
-  weeks: number;
-  /** Sparse month labels: `[weekIndex, "Jun"]` at each month boundary. */
-  monthLabels: Array<[number, string]>;
-}
-/**
- * Build a GitHub-style week × weekday grid covering `spanDays` ending at
- * `today`, snapped back so column 0 starts on a Sunday. Intensity levels
- * are quartiles of the NON-ZERO token distribution — a linear scale
- * would flatline every normal day next to one 500M-token outlier.
- *
- * @param days - The days with activity.
- * @param today - The last day.
- * @param spanDays - How many days the grid covers.
- */
-declare function buildHeatmapGrid(days: readonly UsageHeatmapDay[], today: Date, spanDays?: number): HeatmapGrid;
-/** One day of the models chart. */
-interface StackedDay {
-  /** Local `YYYY-MM-DD`. */
-  day: string;
-  /** Same order as the `models` argument; missing models are 0. */
-  values: number[];
-  /** The day's tokens across models. */
-  total: number;
-}
-/**
- * Contiguous per-day stacked values for `models` (top-N ids in legend
- * order; anything else folds into the last slot when `otherSlot`).
- * Contiguity matters: gaps must render as empty days, not be skipped,
- * or the bar chart lies about cadence.
- *
- * @param points - Tokens per model per day.
- * @param models - The charted model ids, in legend order.
- * @param today - The last day.
- * @param spanDays - How many days the chart covers.
- * @param otherSlot - Fold the other models into one last slot.
- */
-declare function buildStackedSeries(points: readonly UsageModelDayPoint[], models: readonly string[], today: Date, spanDays: number, otherSlot: boolean): StackedDay[];
-/**
- * "Jun 12" axis label for a `YYYY-MM-DD` day.
- *
- * @param day - A local `YYYY-MM-DD`.
- */
-declare function shortDayLabel(day: string): string;
 //#endregion
-export { HeatmapCell, HeatmapGrid, StackedDay, buildHeatmapGrid, buildStackedSeries, formatCost, formatHour, formatTokens, localDayString, shortDayLabel, tokenComparison };
+export { formatTokens, localDayString };

package/dist/session/headless/usage-format.js

@@ -1,12 +1,6 @@
-import { formatCostLabel, formatCount } from "zidane/chat/pure";
+import { formatTokens } from "zidane/chat/pure";
 //#region src/session/headless/usage-format.ts
 /**
-* Pure formatting + layout helpers for the welcome screen's usage
-* dashboard. React/Electron-free so vitest can exercise the heatmap
-* grid, the stacked-series builder, and the number formatting without
-* mounting anything.
-*/
-/**
 * Local `YYYY-MM-DD` for a Date. Matches SQLite's `date(…, 'localtime')`
 * buckets the backend aggregates by, or streak math drifts at midnight.
 *
@@ -15,178 +9,5 @@ import { formatCostLabel, formatCount } from "zidane/chat/pure";
 function localDayString(d) {
 	return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
 }
-/**
-* 12.3k / 4.6M / 1.2B — one decimal below 100 of a unit, whole above (core `formatCount`).
-*
-* @param n - A token count.
-*/
-function formatTokens(n) {
-	if (!Number.isFinite(n) || n <= 0) return "0";
-	return formatCount(n);
-}
-/**
-* USD: core `formatCostLabel` below $10 (`$0.004`, never `$0.00`), whole dollars below $10k, then $12.3k.
-*
-* @param usd - An amount in US dollars.
-*/
-function formatCost(usd) {
-	if (!Number.isFinite(usd) || usd <= 0) return "$0";
-	if (usd < 10) return formatCostLabel(usd);
-	if (usd < 1e4) return `$${Math.round(usd).toLocaleString("en-US")}`;
-	return `$${(usd / 1e3).toFixed(1)}k`;
-}
-/**
-* 0-23 → "9 am" / "2 pm" / "12 pm".
-*
-* @param hour - A local hour, 0-23.
-*/
-function formatHour(hour) {
-	return `${hour % 12 === 0 ? 12 : hour % 12} ${hour < 12 ? "am" : "pm"}`;
-}
-/**
-* Rotating playful comparison for the Overview footer. Token counts for
-* the reference works are rough published word counts × ~1.33
-* tokens/word — precision is not the point of the joke.
-*/
-const COMPARISONS = [
-	{
-		label: "The Little Prince",
-		tokens: 22e3
-	},
-	{
-		label: "The Lord of the Rings",
-		tokens: 64e4
-	},
-	{
-		label: "the complete works of Shakespeare",
-		tokens: 118e4
-	}
-];
-/**
-* `seed` selects the comparison deterministically (day-of-year keeps it
-* stable within a day but rotating across days). Returns `null` when
-* the total is too small for the multiple to land (< 2× the work).
-*
-* @param totalTokens - The tokens processed.
-* @param seed - Picks the comparison (the day of the year).
-*/
-function tokenComparison(totalTokens, seed) {
-	const pick = COMPARISONS[Math.abs(seed) % COMPARISONS.length];
-	const times = totalTokens / pick.tokens;
-	if (times < 2) return null;
-	return `You've processed ~${times >= 1e3 ? `${Math.round(times / 100) * 100}`.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : String(Math.round(times))}× the tokens of ${pick.label}.`;
-}
-const MONTHS = [
-	"Jan",
-	"Feb",
-	"Mar",
-	"Apr",
-	"May",
-	"Jun",
-	"Jul",
-	"Aug",
-	"Sep",
-	"Oct",
-	"Nov",
-	"Dec"
-];
-/**
-* Build a GitHub-style week × weekday grid covering `spanDays` ending at
-* `today`, snapped back so column 0 starts on a Sunday. Intensity levels
-* are quartiles of the NON-ZERO token distribution — a linear scale
-* would flatline every normal day next to one 500M-token outlier.
-*
-* @param days - The days with activity.
-* @param today - The last day.
-* @param spanDays - How many days the grid covers.
-*/
-function buildHeatmapGrid(days, today, spanDays = 182) {
-	const byDay = new Map(days.map((d) => [d.day, d]));
-	const end = new Date(today.getFullYear(), today.getMonth(), today.getDate());
-	const start = new Date(end.getFullYear(), end.getMonth(), end.getDate() - (spanDays - 1));
-	start.setDate(start.getDate() - start.getDay());
-	const nonZero = days.map((d) => d.tokens).filter((t) => t > 0).sort((a, b) => a - b);
-	const quartile = (q) => nonZero[Math.max(0, Math.ceil(q * nonZero.length) - 1)] ?? 0;
-	const q1 = quartile(.25);
-	const q2 = quartile(.5);
-	const q3 = quartile(.75);
-	const cells = [];
-	const monthLabels = [];
-	let lastMonth = -1;
-	for (let t = new Date(start), week = 0; t <= end; t.setDate(t.getDate() + 1)) {
-		const weekday = t.getDay();
-		if (weekday === 0 && cells.length > 0) week += 1;
-		if (t.getDate() <= 7 && t.getMonth() !== lastMonth) {
-			lastMonth = t.getMonth();
-			monthLabels.push([week, MONTHS[lastMonth]]);
-		}
-		const day = localDayString(t);
-		const info = byDay.get(day);
-		const tokens = info?.tokens ?? 0;
-		const messages = info?.messages ?? 0;
-		const level = tokens <= 0 && messages <= 0 ? 0 : tokens <= q1 ? 1 : tokens <= q2 ? 2 : tokens <= q3 ? 3 : 4;
-		cells.push({
-			day,
-			tokens,
-			messages,
-			level,
-			week,
-			weekday
-		});
-	}
-	return {
-		cells,
-		weeks: cells.length > 0 ? cells[cells.length - 1].week + 1 : 0,
-		monthLabels: monthLabels.filter(([w], i) => !(i === 0 && w === 0 && monthLabels.length > 1 && monthLabels[1][0] <= 3))
-	};
-}
-/**
-* Contiguous per-day stacked values for `models` (top-N ids in legend
-* order; anything else folds into the last slot when `otherSlot`).
-* Contiguity matters: gaps must render as empty days, not be skipped,
-* or the bar chart lies about cadence.
-*
-* @param points - Tokens per model per day.
-* @param models - The charted model ids, in legend order.
-* @param today - The last day.
-* @param spanDays - How many days the chart covers.
-* @param otherSlot - Fold the other models into one last slot.
-*/
-function buildStackedSeries(points, models, today, spanDays, otherSlot) {
-	const index = new Map(models.map((m, i) => [m, i]));
-	const slots = models.length + (otherSlot ? 1 : 0);
-	const end = new Date(today.getFullYear(), today.getMonth(), today.getDate());
-	const start = new Date(end.getFullYear(), end.getMonth(), end.getDate() - (spanDays - 1));
-	const byDay = /* @__PURE__ */ new Map();
-	for (const p of points) {
-		let values = byDay.get(p.day);
-		if (!values) {
-			values = new Array(slots).fill(0);
-			byDay.set(p.day, values);
-		}
-		const slot = index.get(p.modelId) ?? (otherSlot ? slots - 1 : -1);
-		if (slot >= 0) values[slot] += p.tokens;
-	}
-	const out = [];
-	for (const t = new Date(start); t <= end; t.setDate(t.getDate() + 1)) {
-		const day = localDayString(t);
-		const values = byDay.get(day) ?? new Array(slots).fill(0);
-		out.push({
-			day,
-			values,
-			total: values.reduce((a, b) => a + b, 0)
-		});
-	}
-	return out;
-}
-/**
-* "Jun 12" axis label for a `YYYY-MM-DD` day.
-*
-* @param day - A local `YYYY-MM-DD`.
-*/
-function shortDayLabel(day) {
-	const [, m, d] = day.split("-").map(Number);
-	return `${MONTHS[(m ?? 1) - 1]} ${d}`;
-}
 //#endregion
-export { buildHeatmapGrid, buildStackedSeries, formatCost, formatHour, formatTokens, localDayString, shortDayLabel, tokenComparison };
+export { formatTokens, localDayString };

package/dist/session/headless/usage.d.ts

@@ -1,6 +1,15 @@
 import { Readable } from "../../chat/headless/store.js";
-import { ProviderUsageSnapshot } from "zidane/chat/pure";
+import { ProviderResetCredit, ProviderResetOutcome, ProviderUsageSnapshot } from "zidane/chat/pure";
 //#region src/session/headless/usage.d.ts
+/** Which account a banked reset is spent on: a snapshot's provider and credential. */
+interface ProviderResetTarget {
+  /** The snapshot's `providerKey`. */
+  providerKey: string;
+  /** The snapshot's `credentialKey`. */
+  credentialKey: string;
+  /** Which reset to spend (`ProviderResetCredit.id`). Absent: the provider picks. */
+  creditId?: string;
+}
 /** The time window of a usage summary. */
 type UsageRange = 'all' | '30d' | '7d';
 /** The ranges, in the order a range switcher shows them. */
@@ -150,6 +159,8 @@ interface ProviderUsageState {
   loadGithub(probe: boolean): Promise<void>;
   /** When the last provider fetch landed (ms), `0` before any. */
   lastLoad(): number;
+  /** Spends one banked reset, then refreshes. `null` when the source can't redeem. */
+  redeemReset: ((target: ProviderResetTarget) => Promise<ProviderResetOutcome>) | null;
 }
 /** The backend calls a {@link ProviderUsageState} makes. */
 interface ProviderUsageSource {
@@ -161,6 +172,8 @@ interface ProviderUsageSource {
   github?(options?: {
     probe?: boolean;
   }): Promise<readonly ProviderUsageSnapshot[]>;
+  /** Spends one banked reset. Absent: no reset button. */
+  redeemReset?(target: ProviderResetTarget): Promise<ProviderResetOutcome>;
 }
 /**
  * Creates a {@link ProviderUsageState}. The cadence (when to auto-load) is the reader's: `useProviderUsage`.
@@ -170,4 +183,4 @@ interface ProviderUsageSource {
  */
 declare function createProviderUsageState(source: ProviderUsageSource, now?: () => number): ProviderUsageState;
 //#endregion
-export { type ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, createProviderUsageState, createUsageSummaryState, isUsageSummary, pickUsageSummary };
+export { type ProviderResetCredit, type ProviderResetOutcome, ProviderResetTarget, type ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, createProviderUsageState, createUsageSummaryState, isUsageSummary, pickUsageSummary };

package/dist/session/headless/usage.js

@@ -189,7 +189,21 @@ function createProviderUsageState(source, now = Date.now) {
 		},
 		load,
 		loadGithub,
-		lastLoad: () => last
+		lastLoad: () => last,
+		redeemReset: source.redeemReset ? async (target) => {
+			let outcome;
+			try {
+				outcome = await source.redeemReset(target);
+			} catch (err) {
+				outcome = {
+					code: "failed",
+					windowsReset: 0,
+					error: err instanceof Error ? err.message : null
+				};
+			}
+			await load(true);
+			return outcome;
+		} : null
 	};
 }
 //#endregion

package/dist/session/index.d.ts

@@ -2,6 +2,7 @@ import { ArtifactRowChips, ArtifactRowChipsFields, ArtifactRowChipsProps, BADGE_
 import { ArtifactOpenEvent, ArtifactsPanel, ArtifactsPanelFocus, ArtifactsPanelProps } from "./ArtifactsPanel.js";
 import { DiffFileTree, DiffFileTreeProps, FindingCounts } from "./DiffFileTree.js";
 import { AttentionActions, InboxAttention, InboxAttentionProps, PanelAttentionProps, QueueAttention, TodosAttention } from "./PanelAttention.js";
+import { ProjectHome, ProjectHomeProject, ProjectHomeProps, ProjectHomeRepo, ProjectHomeSwitcher } from "./ProjectHome.js";
 import { ProviderUsage, ProviderUsageProvider, ProviderUsageProviderProps, useProviderUsage } from "./ProviderUsageProvider.js";
 import { QueueAttachmentRowProps, QueueAttachmentsSlot, QueueTab, QueueTabProps } from "./QueueTab.js";
 import { RenderSessionShell, SessionShell, SessionShellProps } from "./SessionShell.js";
@@ -17,5 +18,6 @@ import { TurnDetailsDialog, TurnDetailsDialogProps } from "./TurnDetailsDialog.j
 import { UsagePanel, UsagePanelProps } from "./UsagePanel.js";
 import { WelcomeScreen, WelcomeScreenProps } from "./WelcomeScreen.js";
 import { useSessionLabels } from "./useSessionLabels.js";
+import { renderSessionModalShell, renderWideSessionModalShell } from "./modal-shell.js";
 import { UsageSummaryView, useUsageSummary } from "./useUsageSummary.js";
-export { ArtifactOpenEvent, ArtifactRowChips, ArtifactRowChipsFields, ArtifactRowChipsProps, ArtifactsPanel, ArtifactsPanelFocus, ArtifactsPanelProps, AttentionActions, BADGE_ICONS, DiffFacts, DiffFactsProps, DiffFileTree, DiffFileTreeProps, FindingCounts, InboxAttention, InboxAttentionProps, PanelAttentionProps, ProviderUsage, ProviderUsageProvider, ProviderUsageProviderProps, QueueAttachmentRowProps, QueueAttachmentsSlot, QueueAttention, QueueTab, QueueTabProps, type RenderSessionShell, RunningWorkDialog, RunningWorkDialogProps, SessionCacheFacts, SessionCacheFactsProps, SessionDetailsDialog, SessionDetailsDialogProps, SessionDetailsFacts, SessionDetailsSpace, SessionDetailsStatus, SessionFolderLocation, SessionHeader, SessionHeaderProps, SessionHeaderServer, SessionProvider, SessionProviderProps, SessionShell, type SessionShellProps, SideChat, SideChatProps, TODO_ROW_CLASS, TodoListItem, TodoListView, TodoListViewProps, TodoTally, TodoTallyProps, TodosAttention, TodosPanel, TodosPanelProps, TurnDetailsDialog, TurnDetailsDialogProps, UsagePanel, UsagePanelProps, UsageSummaryView, WelcomeScreen, WelcomeScreenProps, badgeColorStyle, badgeToneClass, hasArtifactRowChips, isDoneTodo, todoGlyphTone, useProviderUsage, useSessionArtifacts, useSessionCacheReport, useSessionHost, useSessionLabels, useSessionQueue, useSessionRunningWork, useSessionTodos, useUsageSummary };
+export { ArtifactOpenEvent, ArtifactRowChips, ArtifactRowChipsFields, ArtifactRowChipsProps, ArtifactsPanel, ArtifactsPanelFocus, ArtifactsPanelProps, AttentionActions, BADGE_ICONS, DiffFacts, DiffFactsProps, DiffFileTree, DiffFileTreeProps, FindingCounts, InboxAttention, InboxAttentionProps, PanelAttentionProps, ProjectHome, ProjectHomeProject, ProjectHomeProps, ProjectHomeRepo, ProjectHomeSwitcher, ProviderUsage, ProviderUsageProvider, ProviderUsageProviderProps, QueueAttachmentRowProps, QueueAttachmentsSlot, QueueAttention, QueueTab, QueueTabProps, type RenderSessionShell, RunningWorkDialog, RunningWorkDialogProps, SessionCacheFacts, SessionCacheFactsProps, SessionDetailsDialog, SessionDetailsDialogProps, SessionDetailsFacts, SessionDetailsSpace, SessionDetailsStatus, SessionFolderLocation, SessionHeader, SessionHeaderProps, SessionHeaderServer, SessionProvider, SessionProviderProps, SessionShell, type SessionShellProps, SideChat, SideChatProps, TODO_ROW_CLASS, TodoListItem, TodoListView, TodoListViewProps, TodoTally, TodoTallyProps, TodosAttention, TodosPanel, TodosPanelProps, TurnDetailsDialog, TurnDetailsDialogProps, UsagePanel, UsagePanelProps, UsageSummaryView, WelcomeScreen, WelcomeScreenProps, badgeColorStyle, badgeToneClass, hasArtifactRowChips, isDoneTodo, renderSessionModalShell, renderWideSessionModalShell, todoGlyphTone, useProviderUsage, useSessionArtifacts, useSessionCacheReport, useSessionHost, useSessionLabels, useSessionQueue, useSessionRunningWork, useSessionTodos, useUsageSummary };

package/dist/session/index.js

@@ -5,6 +5,8 @@ import { TODO_ROW_CLASS, TodoListView, TodoTally, isDoneTodo, todoGlyphTone } fr
 import { DiffFileTree } from "./DiffFileTree.js";
 import { ArtifactsPanel } from "./ArtifactsPanel.js";
 import { InboxAttention, QueueAttention, TodosAttention } from "./PanelAttention.js";
+import { useUsageSummary } from "./useUsageSummary.js";
+import { ProjectHome } from "./ProjectHome.js";
 import { ProviderUsageProvider, useProviderUsage } from "./ProviderUsageProvider.js";
 import { QueueTab } from "./QueueTab.js";
 import { SessionShell } from "./SessionShell.js";
@@ -16,6 +18,6 @@ import { SideChat } from "./SideChat.js";
 import { TodosPanel } from "./TodosPanel.js";
 import { TurnDetailsDialog } from "./TurnDetailsDialog.js";
 import { UsagePanel } from "./UsagePanel.js";
-import { useUsageSummary } from "./useUsageSummary.js";
 import { WelcomeScreen } from "./WelcomeScreen.js";
-export { ArtifactRowChips, ArtifactsPanel, BADGE_ICONS, DiffFacts, DiffFileTree, InboxAttention, ProviderUsageProvider, QueueAttention, QueueTab, RunningWorkDialog, SessionCacheFacts, SessionDetailsDialog, SessionHeader, SessionProvider, SessionShell, SideChat, TODO_ROW_CLASS, TodoListView, TodoTally, TodosAttention, TodosPanel, TurnDetailsDialog, UsagePanel, WelcomeScreen, badgeColorStyle, badgeToneClass, hasArtifactRowChips, isDoneTodo, todoGlyphTone, useProviderUsage, useSessionArtifacts, useSessionCacheReport, useSessionHost, useSessionLabels, useSessionQueue, useSessionRunningWork, useSessionTodos, useUsageSummary };
+import { renderSessionModalShell, renderWideSessionModalShell } from "./modal-shell.js";
+export { ArtifactRowChips, ArtifactsPanel, BADGE_ICONS, DiffFacts, DiffFileTree, InboxAttention, ProjectHome, ProviderUsageProvider, QueueAttention, QueueTab, RunningWorkDialog, SessionCacheFacts, SessionDetailsDialog, SessionHeader, SessionProvider, SessionShell, SideChat, TODO_ROW_CLASS, TodoListView, TodoTally, TodosAttention, TodosPanel, TurnDetailsDialog, UsagePanel, WelcomeScreen, badgeColorStyle, badgeToneClass, hasArtifactRowChips, isDoneTodo, renderSessionModalShell, renderWideSessionModalShell, todoGlyphTone, useProviderUsage, useSessionArtifacts, useSessionCacheReport, useSessionHost, useSessionLabels, useSessionQueue, useSessionRunningWork, useSessionTodos, useUsageSummary };

package/dist/session/modal-shell.d.ts

@@ -0,0 +1,8 @@
+import { RenderSessionShell } from "./SessionShell.js";
+//#region src/session/modal-shell.d.ts
+/** A session dialog in the app's `ModalShell`, medium width. */
+declare const renderSessionModalShell: RenderSessionShell;
+/** For the session details: a facts grid and the cache table need the room. */
+declare const renderWideSessionModalShell: RenderSessionShell;
+//#endregion
+export { renderSessionModalShell, renderWideSessionModalShell };

package/dist/session/modal-shell.js

@@ -0,0 +1,18 @@
+import { ModalShell } from "../app/ModalProvider.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/session/modal-shell.tsx
+const noop = () => void 0;
+const shellOfSize = (size) => ({ title, description, onClose, footer, children }) => /* @__PURE__ */ jsx(ModalShell, {
+	title,
+	description,
+	onClose: onClose ?? noop,
+	footer,
+	size,
+	children
+});
+/** A session dialog in the app's `ModalShell`, medium width. */
+const renderSessionModalShell = shellOfSize("medium");
+/** For the session details: a facts grid and the cache table need the room. */
+const renderWideSessionModalShell = shellOfSize("large");
+//#endregion
+export { renderSessionModalShell, renderWideSessionModalShell };

package/dist/session/testing/contract.d.ts

@@ -1,7 +1,7 @@
 import { PromptAttachment, RunningWorkItem, SessionArtifact, SessionHost, SessionTurn, TodoItem } from "../headless/host.js";
 //#region src/session/testing/contract.d.ts
 /** An optional `SessionHost` member, by its path. */
-type SessionHostCapability = 'todos' | 'todos.set' | 'todos.retry' | 'queue' | 'queue.add' | 'queue.remove' | 'queue.update' | 'queue.attachments' | 'queue.pushNow' | 'artifacts' | 'artifacts.remove' | 'artifacts.refreshRow' | 'runningWork' | 'runningWork.cancel' | 'turns' | 'turns.fork' | 'turns.editText' | 'turns.delete' | 'turns.rewind' | 'details' | 'details.titleStatus' | 'details.generateTitle' | 'details.export' | 'details.compact' | 'details.setFolder' | 'details.cacheReport' | 'usage' | 'usage.summary' | 'usage.providers' | 'usage.github' | 'side' | 'side.subscribe';
+type SessionHostCapability = 'todos' | 'todos.set' | 'todos.retry' | 'queue' | 'queue.add' | 'queue.remove' | 'queue.update' | 'queue.attachments' | 'queue.pushNow' | 'artifacts' | 'artifacts.remove' | 'artifacts.refreshRow' | 'runningWork' | 'runningWork.cancel' | 'turns' | 'turns.fork' | 'turns.editText' | 'turns.delete' | 'turns.rewind' | 'details' | 'details.titleStatus' | 'details.generateTitle' | 'details.export' | 'details.compact' | 'details.setFolder' | 'details.cacheReport' | 'usage' | 'usage.summary' | 'usage.providers' | 'usage.github' | 'usage.redeemReset' | 'side' | 'side.subscribe';
 /** A queued message the backend holds, with its attachments' bytes. */
 interface SessionHostContractEntry {
   /** The entry's id. */

package/dist/session/testing/contract.js

@@ -56,6 +56,7 @@ const CAPABILITIES = [
 	"usage.summary",
 	"usage.providers",
 	"usage.github",
+	"usage.redeemReset",
 	"side",
 	"side.subscribe"
 ];
@@ -488,6 +489,21 @@ function describeSessionHostContract(name, makeHarness, capabilities) {
 				const { host } = await setup();
 				expect(Array.isArray(await host.usage.github({ probe: false }))).toBe(true);
 			});
+			it.skipIf(!has("usage.redeemReset"))("redeemReset answers an outcome, never a rejection", async () => {
+				const { host } = await setup();
+				const outcome = await host.usage.redeemReset({
+					providerKey: "openai",
+					credentialKey: "missing"
+				});
+				expect([
+					"reset",
+					"nothing_to_reset",
+					"no_credit",
+					"already_redeemed",
+					"failed"
+				]).toContain(outcome.code);
+				expect(typeof outcome.windowsReset).toBe("number");
+			});
 		});
 		describe.skipIf(!has("side"))("side chats", () => {
 			it("finds a session's side chat, creates one where there is none, and removes it", async () => {

package/dist/session/testing/demo.js

@@ -148,13 +148,37 @@ const DEMO_PROVIDER_USAGE = [{
 }, {
 	providerKey: "openai",
 	label: "OpenAI",
-	credentialKey: "openai",
+	credentialKey: "openai-codex",
 	account: null,
 	activeCredential: true,
-	status: "unauthorized",
-	plan: null,
-	windows: [],
+	status: "ok",
+	plan: "pro",
+	windows: [{
+		id: "primary",
+		label: "5h",
+		usedPercent: 18,
+		resetsAt: NOW + 108e5
+	}, {
+		id: "secondary",
+		label: "weekly",
+		usedPercent: 93,
+		resetsAt: NOW + 3456e5
+	}],
 	credits: null,
+	resets: {
+		available: 2,
+		credits: [{
+			id: "reset-1",
+			title: "Full reset (Weekly + 5 hr)",
+			grantedAt: NOW - 10368e5,
+			expiresAt: NOW + 1728e5
+		}, {
+			id: "reset-2",
+			title: "Full reset (Weekly + 5 hr)",
+			grantedAt: NOW - 2592e5,
+			expiresAt: null
+		}]
+	},
 	fetchedAt: NOW,
 	error: null
 }];

package/dist/settings/SettingsNav.d.ts

@@ -4,7 +4,7 @@ import { CSSProperties } from "react";
 /** Props for {@link SettingsNav}. */
 interface SettingsNavProps {
   /** The sections the shell offers. */
-  sections: readonly Pick<SettingsSection, 'id' | 'title' | 'icon' | 'group'>[];
+  sections: readonly Pick<SettingsSection, 'id' | 'title' | 'icon' | 'monogram' | 'mark' | 'group'>[];
   /** The open section's id. */
   active: string;
   /** How many settings (or listed things) each section holds; absent or 0: no count. */
@@ -17,7 +17,8 @@ interface SettingsNavProps {
   style?: CSSProperties;
 }
 /**
- * The nav's rows in order: each top-level section, then the sections grouped under it.
+ * The nav's rows in order: each top-level section, then the sections grouped under it, each followed
+ * by the ones grouped under it in turn.
  *
  * @param sections - The sections, in the app's order.
  * @returns The rows as the nav lists them.