zidane-ui 9.0.4 → 9.1.3

package/dist/session/headless/home-layout.d.ts

@@ -0,0 +1,137 @@
+import { PanelHomeLayout, PanelIcon, PanelSurface, PanelView } from "zidane/chat/pure";
+//#region src/session/headless/home-layout.d.ts
+/** What the home needs of a panel summary. */
+interface HomeBlockSource {
+  /** The panel id. */
+  id: string;
+  /** The panel's name. */
+  label: string;
+  /** The extension that registered it. */
+  owner: string;
+  /** Its icon. */
+  icon?: PanelIcon;
+  /** Where it may show; only panels that list `'home'` become blocks. */
+  surfaces?: readonly PanelSurface[];
+  /** Its default place on the home (order, width). */
+  home?: PanelHomeLayout;
+}
+/** A block of the home. */
+interface HomeBlock {
+  /** Its panel id. */
+  id: string;
+  /** Its name (menus, the hidden list). */
+  label: string;
+  /** The extension that registered it. */
+  owner: string;
+  /** Its icon. */
+  icon?: PanelIcon;
+  /** Shares a row with another half block. */
+  width: 'full' | 'half';
+}
+/** How the user arranged one project's home. */
+interface HomePrefs {
+  /** Block ids in the order the user put them. */
+  order: readonly string[];
+  /** Block ids the user hid. */
+  hidden: readonly string[];
+  /** Block ids the user added (not shown by default). */
+  added: readonly string[];
+  /** The width the user picked, by block id; a block without one keeps its panel's default. */
+  widths: Readonly<Record<string, HomeBlock['width']>>;
+  /** Each block's view, by block id. */
+  views: Readonly<Record<string, PanelView>>;
+}
+/** Nothing arranged yet. */
+declare const EMPTY_HOME_PREFS: HomePrefs;
+/** A row of the home: one full block, or two half blocks. */
+type HomeRow = {
+  kind: 'full';
+  block: HomeBlock;
+} | {
+  kind: 'pair';
+  blocks: readonly [HomeBlock, HomeBlock];
+};
+/**
+ * The panels that are blocks, in default order (`home.order`, then catalog order).
+ *
+ * @param panels - The folder's panel summaries.
+ */
+declare function homeBlocksOf(panels: readonly HomeBlockSource[]): HomeBlock[];
+/**
+ * The blocks shown, in the user's order and at the widths they picked, and the ones they hid.
+ *
+ * @param blocks - The blocks in default order ({@link homeBlocksOf}).
+ * @param prefs - The user's arrangement.
+ * @param defaults - The blocks shown before the user adds any. Absent: every block.
+ */
+declare function arrangeHomeBlocks(blocks: readonly HomeBlock[], prefs: HomePrefs, defaults?: readonly string[]): {
+  shown: HomeBlock[];
+  hidden: HomeBlock[];
+};
+/**
+ * The rows the shown blocks make.
+ *
+ * @param shown - The shown blocks, in order.
+ */
+declare function homeRows(shown: readonly HomeBlock[]): HomeRow[];
+/**
+ * `prefs` with block `id` moved `delta` places among the shown blocks.
+ *
+ * @param prefs - The arrangement.
+ * @param shown - The shown blocks, in order (what the user sees).
+ * @param id - The block.
+ * @param delta - -1 up, +1 down.
+ */
+declare function moveHomeBlock(prefs: HomePrefs, shown: readonly HomeBlock[], id: string, delta: number): HomePrefs;
+/**
+ * `prefs` with block `id` moved to the place of block `target` among the shown
+ * blocks (a drop on that card): before it when coming from below, after it
+ * when coming from above.
+ *
+ * @param prefs - The arrangement.
+ * @param shown - The shown blocks, in order (what the user sees).
+ * @param id - The block moved.
+ * @param target - The block it was dropped on.
+ */
+declare function placeHomeBlock(prefs: HomePrefs, shown: readonly HomeBlock[], id: string, target: string): HomePrefs;
+/**
+ * `prefs` with block `id` at `width`.
+ *
+ * @param prefs - The arrangement.
+ * @param id - The block.
+ * @param width - Full row, or half (shares a row with a half neighbour).
+ */
+declare function setHomeBlockWidth(prefs: HomePrefs, id: string, width: HomeBlock['width']): HomePrefs;
+/**
+ * `prefs` with block `id` hidden.
+ *
+ * @param prefs - The arrangement.
+ * @param id - The block.
+ */
+declare function hideHomeBlock(prefs: HomePrefs, id: string): HomePrefs;
+/**
+ * `prefs` with block `id` shown (added, or hidden and shown again), after every shown block.
+ *
+ * @param prefs - The arrangement.
+ * @param blocks - The blocks in default order ({@link homeBlocksOf}).
+ * @param id - The block.
+ * @param defaults - The blocks shown before the user adds any ({@link arrangeHomeBlocks}).
+ */
+declare function showHomeBlock(prefs: HomePrefs, blocks: readonly HomeBlock[], id: string, defaults?: readonly string[]): HomePrefs;
+/**
+ * `prefs` with one control of block `id` set.
+ *
+ * @param prefs - The arrangement.
+ * @param id - The block.
+ * @param control - The control id.
+ * @param value - The picked option.
+ */
+declare function setHomeBlockView(prefs: HomePrefs, id: string, control: string, value: string): HomePrefs;
+/**
+ * Every project's arrangement from its stored form; `undefined` for anything unrecognised.
+ *
+ * @param raw - The stored JSON.
+ */
+declare function parseHomePrefs(raw: string): Record<string, HomePrefs> | undefined;
+//#endregion
+export { EMPTY_HOME_PREFS, HomeBlock, HomeBlockSource, HomePrefs, HomeRow, arrangeHomeBlocks, hideHomeBlock, homeBlocksOf, homeRows, moveHomeBlock, parseHomePrefs, placeHomeBlock, setHomeBlockView, setHomeBlockWidth, showHomeBlock };

package/dist/session/headless/home-layout.js

@@ -0,0 +1,235 @@
+//#region src/session/headless/home-layout.ts
+/** Nothing arranged yet. */
+const EMPTY_HOME_PREFS = {
+	order: [],
+	hidden: [],
+	added: [],
+	widths: {},
+	views: {}
+};
+const DEFAULT_ORDER = 100;
+/**
+* The panels that are blocks, in default order (`home.order`, then catalog order).
+*
+* @param panels - The folder's panel summaries.
+*/
+function homeBlocksOf(panels) {
+	return panels.map((p, index) => ({
+		p,
+		index
+	})).filter(({ p }) => p.surfaces?.includes("home")).sort((a, b) => (a.p.home?.order ?? DEFAULT_ORDER) - (b.p.home?.order ?? DEFAULT_ORDER) || a.index - b.index).map(({ p }) => ({
+		id: p.id,
+		label: p.label,
+		owner: p.owner,
+		...p.icon ? { icon: p.icon } : {},
+		width: p.home?.width === "half" ? "half" : "full"
+	}));
+}
+/**
+* The blocks shown, in the user's order and at the widths they picked, and the ones they hid.
+*
+* @param blocks - The blocks in default order ({@link homeBlocksOf}).
+* @param prefs - The user's arrangement.
+* @param defaults - The blocks shown before the user adds any. Absent: every block.
+*/
+function arrangeHomeBlocks(blocks, prefs, defaults) {
+	const placed = new Map(prefs.order.map((id, i) => [id, i]));
+	const rank = (b, i) => placed.get(b.id) ?? prefs.order.length + i;
+	const sorted = blocks.map((b, i) => ({
+		b,
+		r: rank(b, i)
+	})).sort((x, y) => x.r - y.r).map(({ b }) => {
+		const width = prefs.widths[b.id];
+		return width && width !== b.width ? {
+			...b,
+			width
+		} : b;
+	});
+	const hidden = new Set(prefs.hidden);
+	const isShown = (id) => !hidden.has(id) && (defaults === void 0 || defaults.includes(id) || prefs.added.includes(id));
+	return {
+		shown: sorted.filter((b) => isShown(b.id)),
+		hidden: sorted.filter((b) => !isShown(b.id))
+	};
+}
+/**
+* The rows the shown blocks make.
+*
+* @param shown - The shown blocks, in order.
+*/
+function homeRows(shown) {
+	const rows = [];
+	for (let i = 0; i < shown.length; i++) {
+		const block = shown[i];
+		const next = shown[i + 1];
+		if (block.width === "half" && next?.width === "half") {
+			rows.push({
+				kind: "pair",
+				blocks: [block, next]
+			});
+			i++;
+		} else rows.push({
+			kind: "full",
+			block
+		});
+	}
+	return rows;
+}
+/**
+* `prefs` with block `id` moved `delta` places among the shown blocks.
+*
+* @param prefs - The arrangement.
+* @param shown - The shown blocks, in order (what the user sees).
+* @param id - The block.
+* @param delta - -1 up, +1 down.
+*/
+function moveHomeBlock(prefs, shown, id, delta) {
+	const ids = shown.map((b) => b.id);
+	const from = ids.indexOf(id);
+	const to = from + delta;
+	if (from < 0 || to < 0 || to >= ids.length) return prefs;
+	ids.splice(from, 1);
+	ids.splice(to, 0, id);
+	return {
+		...prefs,
+		order: [...ids, ...prefs.order.filter((x) => !ids.includes(x))]
+	};
+}
+/**
+* `prefs` with block `id` moved to the place of block `target` among the shown
+* blocks (a drop on that card): before it when coming from below, after it
+* when coming from above.
+*
+* @param prefs - The arrangement.
+* @param shown - The shown blocks, in order (what the user sees).
+* @param id - The block moved.
+* @param target - The block it was dropped on.
+*/
+function placeHomeBlock(prefs, shown, id, target) {
+	const ids = shown.map((b) => b.id);
+	const from = ids.indexOf(id);
+	const to = ids.indexOf(target);
+	if (from < 0 || to < 0 || from === to) return prefs;
+	return moveHomeBlock(prefs, shown, id, to - from);
+}
+/**
+* `prefs` with block `id` at `width`.
+*
+* @param prefs - The arrangement.
+* @param id - The block.
+* @param width - Full row, or half (shares a row with a half neighbour).
+*/
+function setHomeBlockWidth(prefs, id, width) {
+	if (prefs.widths[id] === width) return prefs;
+	return {
+		...prefs,
+		widths: {
+			...prefs.widths,
+			[id]: width
+		}
+	};
+}
+/**
+* `prefs` with block `id` hidden.
+*
+* @param prefs - The arrangement.
+* @param id - The block.
+*/
+function hideHomeBlock(prefs, id) {
+	if (prefs.hidden.includes(id)) return prefs;
+	return {
+		...prefs,
+		hidden: [...prefs.hidden, id],
+		added: prefs.added.filter((x) => x !== id)
+	};
+}
+/**
+* `prefs` with block `id` shown (added, or hidden and shown again), after every shown block.
+*
+* @param prefs - The arrangement.
+* @param blocks - The blocks in default order ({@link homeBlocksOf}).
+* @param id - The block.
+* @param defaults - The blocks shown before the user adds any ({@link arrangeHomeBlocks}).
+*/
+function showHomeBlock(prefs, blocks, id, defaults) {
+	const { shown } = arrangeHomeBlocks(blocks, prefs, defaults);
+	const ids = shown.map((b) => b.id);
+	if (ids.includes(id)) return prefs;
+	const isDefault = defaults === void 0 || defaults.includes(id);
+	return {
+		...prefs,
+		hidden: prefs.hidden.filter((x) => x !== id),
+		added: isDefault || prefs.added.includes(id) ? prefs.added : [...prefs.added, id],
+		order: [
+			...ids,
+			id,
+			...prefs.order.filter((x) => x !== id && !ids.includes(x))
+		]
+	};
+}
+/**
+* `prefs` with one control of block `id` set.
+*
+* @param prefs - The arrangement.
+* @param id - The block.
+* @param control - The control id.
+* @param value - The picked option.
+*/
+function setHomeBlockView(prefs, id, control, value) {
+	if (prefs.views[id]?.[control] === value) return prefs;
+	return {
+		...prefs,
+		views: {
+			...prefs.views,
+			[id]: {
+				...prefs.views[id],
+				[control]: value
+			}
+		}
+	};
+}
+const strings = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x.length > 0 && x.length <= 512) : [];
+function parseView(v) {
+	if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
+	const out = {};
+	for (const [k, value] of Object.entries(v)) if (typeof value === "string") out[k] = value;
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+/**
+* Every project's arrangement from its stored form; `undefined` for anything unrecognised.
+*
+* @param raw - The stored JSON.
+*/
+function parseHomePrefs(raw) {
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (!data || typeof data !== "object" || Array.isArray(data)) return void 0;
+	const out = {};
+	for (const [project, value] of Object.entries(data)) {
+		if (!value || typeof value !== "object") continue;
+		const v = value;
+		const views = {};
+		if (v.views && typeof v.views === "object") for (const [id, view] of Object.entries(v.views)) {
+			const parsed = parseView(view);
+			if (parsed) views[id] = parsed;
+		}
+		const widths = {};
+		if (v.widths && typeof v.widths === "object" && !Array.isArray(v.widths)) {
+			for (const [id, width] of Object.entries(v.widths)) if (width === "full" || width === "half") widths[id] = width;
+		}
+		out[project] = {
+			order: strings(v.order),
+			hidden: strings(v.hidden),
+			added: strings(v.added),
+			widths,
+			views
+		};
+	}
+	return out;
+}
+//#endregion
+export { EMPTY_HOME_PREFS, arrangeHomeBlocks, hideHomeBlock, homeBlocksOf, homeRows, moveHomeBlock, parseHomePrefs, placeHomeBlock, setHomeBlockView, setHomeBlockWidth, showHomeBlock };

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

@@ -1,5 +1,5 @@
 import { Readable } from "../../chat/headless/store.js";
-import { ProviderUsageSnapshot as ProviderUsageSnapshot$1, UsageRange, UsageSummary } from "./usage.js";
+import { ProviderResetOutcome, ProviderResetTarget, ProviderUsageSnapshot as ProviderUsageSnapshot$1, UsageRange, UsageSummary } from "./usage.js";
 import { ExtensionArtifactRowFact, ExtensionBadgeIcon, ExtensionBadgeTone } from "zidane/chat/pure";
 import { PromptAttachment, QueuedAttachment, TodoItem, TodosSnapshot } from "zidane/chat";
 import { IpcResult, RunningWorkItem } from "zidane/ipc";
@@ -186,6 +186,8 @@ interface SessionUsage {
   github?(options?: {
     probe?: boolean;
   }): Promise<readonly ProviderUsageSnapshot$1[]>;
+  /** Spends one banked reset on a snapshot's account (Codex). Absent: no reset button. */
+  redeemReset?(target: ProviderResetTarget): Promise<ProviderResetOutcome>;
 }
 /** A session row as the side chat needs it: its id; the app's pickers read the rest. */
 interface SideChatSession {

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

@@ -1,4 +1,4 @@
-import { ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, createProviderUsageState, createUsageSummaryState, isUsageSummary, pickUsageSummary } from "./usage.js";
+import { ProviderResetCredit, ProviderResetOutcome, ProviderResetTarget, ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, createProviderUsageState, createUsageSummaryState, isUsageSummary, pickUsageSummary } from "./usage.js";
 import { PromptAttachment, QueueAddDelivery, QueueAddOptions, QueuePushDelivery, QueuedAttachment, QueuedMessage, RunningWorkItem, SessionArtifact, SessionArtifactGroup, SessionArtifactRow, SessionArtifactRowView, SessionArtifacts, SessionCacheReport, SessionDetailsActions, SessionExportFormat, SessionHost, SessionQueue, SessionRunningWork, SessionSideChats, SessionTodos, SessionTurn, SessionTurns, SessionUsage, SideChatLookup, SideChatSession, TodoItem, TodosSnapshot } from "./host.js";
 import { SessionDiffEntry, SessionEditEvent, collectSessionDiffs, fileDiffCounts, groupByPath } from "./session-diffs.js";
 import { DiffListFile, DiffTreeDir, DiffTreeFile, DiffTreeNode, buildDiffTree, fileOrder, relativeTo, visibleRows } from "./diff-tree.js";
@@ -7,9 +7,10 @@ import { RunningWorkState, createRunningWorkState, sameRunningWork } from "./run
 import { DEFAULT_SESSION_LABELS, SessionLabels } from "./labels.js";
 import { SideRefusal, SideRequests, createSideRequests, parseSideCommand } from "./side.js";
 import { ArtifactsState, countArtifacts, createArtifactsState, groupArtifactRows, plainArtifactRow } from "./artifacts.js";
+import { EMPTY_HOME_PREFS, HomeBlock, HomeBlockSource, HomePrefs, HomeRow, arrangeHomeBlocks, hideHomeBlock, homeBlocksOf, homeRows, moveHomeBlock, parseHomePrefs, placeHomeBlock, setHomeBlockView, setHomeBlockWidth, showHomeBlock } from "./home-layout.js";
 import { KeyedState, createKeyedState } from "./keyed.js";
 import { TodosState, createTodosState } from "./todos.js";
 import { QueueBackend, QueueState, createQueueState, toQueuedMessages } from "./queue.js";
-import { HeatmapCell, HeatmapGrid, StackedDay, buildHeatmapGrid, buildStackedSeries, formatCost, formatHour, formatTokens, localDayString, shortDayLabel, tokenComparison } from "./usage-format.js";
+import { formatTokens, localDayString } from "./usage-format.js";
 import { SessionActionName, SessionActionTarget, SessionActions, SessionActionsDeps, SessionConfirmOptions, createSessionActions, sessionKeyCommands } from "./session-actions.js";
-export { ArtifactsState, DEFAULT_SESSION_LABELS, DiffListFile, DiffTreeDir, DiffTreeFile, DiffTreeNode, HeatmapCell, HeatmapGrid, KeyedState, type PromptAttachment, type ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, QueueAddDelivery, QueueAddOptions, QueueBackend, QueuePushDelivery, QueueState, type QueuedAttachment, QueuedMessage, type RunningWorkItem, RunningWorkState, SessionActionName, SessionActionTarget, SessionActions, SessionActionsDeps, type SessionArtifact, SessionArtifactGroup, SessionArtifactRow, SessionArtifactRowView, SessionArtifacts, SessionCacheReport, SessionConfirmOptions, SessionDetailsActions, SessionDiffEntry, SessionEditEvent, SessionExportFormat, SessionHost, SessionLabels, SessionQueue, SessionRunningWork, SessionSideChats, SessionTodos, type SessionTurn, SessionTurns, SessionUsage, SideChatLookup, SideChatSession, SideRefusal, SideRequests, StackedDay, StagedAttachment, type TodoItem, type TodosSnapshot, TodosState, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, attachmentsKey, buildDiffTree, buildHeatmapGrid, buildStackedSeries, collectSessionDiffs, countArtifacts, createArtifactsState, createKeyedState, createProviderUsageState, createQueueState, createRunningWorkState, createSessionActions, createSideRequests, createTodosState, createUsageSummaryState, fileDiffCounts, fileOrder, formatCost, formatHour, formatTokens, groupArtifactRows, groupByPath, isUsageSummary, localDayString, parseSideCommand, pickUsageSummary, plainArtifactRow, relativeTo, sameRunningWork, sessionKeyCommands, shortDayLabel, stagedToWire, toQueuedMessages, tokenComparison, visibleRows, wireToStaged };
+export { ArtifactsState, DEFAULT_SESSION_LABELS, DiffListFile, DiffTreeDir, DiffTreeFile, DiffTreeNode, EMPTY_HOME_PREFS, HomeBlock, HomeBlockSource, HomePrefs, HomeRow, KeyedState, type PromptAttachment, type ProviderResetCredit, type ProviderResetOutcome, ProviderResetTarget, type ProviderUsageSnapshot, ProviderUsageSource, ProviderUsageState, ProviderUsageView, QueueAddDelivery, QueueAddOptions, QueueBackend, QueuePushDelivery, QueueState, type QueuedAttachment, QueuedMessage, type RunningWorkItem, RunningWorkState, SessionActionName, SessionActionTarget, SessionActions, SessionActionsDeps, type SessionArtifact, SessionArtifactGroup, SessionArtifactRow, SessionArtifactRowView, SessionArtifacts, SessionCacheReport, SessionConfirmOptions, SessionDetailsActions, SessionDiffEntry, SessionEditEvent, SessionExportFormat, SessionHost, SessionLabels, SessionQueue, SessionRunningWork, SessionSideChats, SessionTodos, type SessionTurn, SessionTurns, SessionUsage, SideChatLookup, SideChatSession, SideRefusal, SideRequests, StagedAttachment, type TodoItem, type TodosSnapshot, TodosState, USAGE_RANGES, USAGE_SNAPSHOT_KEY, UsageHeatmapDay, UsageModelDayPoint, UsageModelRow, UsageProviderRow, UsageRange, UsageSummaries, UsageSummary, UsageSummaryState, UsageSummaryStateOptions, arrangeHomeBlocks, attachmentsKey, buildDiffTree, collectSessionDiffs, countArtifacts, createArtifactsState, createKeyedState, createProviderUsageState, createQueueState, createRunningWorkState, createSessionActions, createSideRequests, createTodosState, createUsageSummaryState, fileDiffCounts, fileOrder, formatTokens, groupArtifactRows, groupByPath, hideHomeBlock, homeBlocksOf, homeRows, isUsageSummary, localDayString, moveHomeBlock, parseHomePrefs, parseSideCommand, pickUsageSummary, placeHomeBlock, plainArtifactRow, relativeTo, sameRunningWork, sessionKeyCommands, setHomeBlockView, setHomeBlockWidth, showHomeBlock, stagedToWire, toQueuedMessages, visibleRows, wireToStaged };

package/dist/session/headless/index.js

@@ -1,14 +1,15 @@
+import { DEFAULT_SESSION_LABELS } from "./labels.js";
 import { createKeyedState } from "./keyed.js";
 import { countArtifacts, createArtifactsState, groupArtifactRows, plainArtifactRow } from "./artifacts.js";
 import { createQueueState, toQueuedMessages } from "./queue.js";
 import { createRunningWorkState, sameRunningWork } from "./running-work.js";
 import { createTodosState } from "./todos.js";
 import { createSideRequests, parseSideCommand } from "./side.js";
-import { buildHeatmapGrid, buildStackedSeries, formatCost, formatHour, formatTokens, localDayString, shortDayLabel, tokenComparison } from "./usage-format.js";
-import { DEFAULT_SESSION_LABELS } from "./labels.js";
 import { buildDiffTree, fileOrder, relativeTo, visibleRows } from "./diff-tree.js";
 import { collectSessionDiffs, fileDiffCounts, groupByPath } from "./session-diffs.js";
+import { EMPTY_HOME_PREFS, arrangeHomeBlocks, hideHomeBlock, homeBlocksOf, homeRows, moveHomeBlock, parseHomePrefs, placeHomeBlock, setHomeBlockView, setHomeBlockWidth, showHomeBlock } from "./home-layout.js";
 import { USAGE_RANGES, USAGE_SNAPSHOT_KEY, createProviderUsageState, createUsageSummaryState, isUsageSummary, pickUsageSummary } from "./usage.js";
 import { attachmentsKey, stagedToWire, wireToStaged } from "./queue-attachments.js";
+import { formatTokens, localDayString } from "./usage-format.js";
 import { createSessionActions, sessionKeyCommands } from "./session-actions.js";
-export { DEFAULT_SESSION_LABELS, USAGE_RANGES, USAGE_SNAPSHOT_KEY, attachmentsKey, buildDiffTree, buildHeatmapGrid, buildStackedSeries, collectSessionDiffs, countArtifacts, createArtifactsState, createKeyedState, createProviderUsageState, createQueueState, createRunningWorkState, createSessionActions, createSideRequests, createTodosState, createUsageSummaryState, fileDiffCounts, fileOrder, formatCost, formatHour, formatTokens, groupArtifactRows, groupByPath, isUsageSummary, localDayString, parseSideCommand, pickUsageSummary, plainArtifactRow, relativeTo, sameRunningWork, sessionKeyCommands, shortDayLabel, stagedToWire, toQueuedMessages, tokenComparison, visibleRows, wireToStaged };
+export { DEFAULT_SESSION_LABELS, EMPTY_HOME_PREFS, USAGE_RANGES, USAGE_SNAPSHOT_KEY, arrangeHomeBlocks, attachmentsKey, buildDiffTree, collectSessionDiffs, countArtifacts, createArtifactsState, createKeyedState, createProviderUsageState, createQueueState, createRunningWorkState, createSessionActions, createSideRequests, createTodosState, createUsageSummaryState, fileDiffCounts, fileOrder, formatTokens, groupArtifactRows, groupByPath, hideHomeBlock, homeBlocksOf, homeRows, isUsageSummary, localDayString, moveHomeBlock, parseHomePrefs, parseSideCommand, pickUsageSummary, placeHomeBlock, plainArtifactRow, relativeTo, sameRunningWork, sessionKeyCommands, setHomeBlockView, setHomeBlockWidth, showHomeBlock, stagedToWire, toQueuedMessages, visibleRows, wireToStaged };

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

@@ -1,4 +1,4 @@
-import { UsageRange } from "./usage.js";
+import { ProviderResetOutcome } from "./usage.js";
 import { RunningWorkItem } from "./running-work.js";
 import { TodoStatus } from "zidane/chat";
 //#region src/session/headless/labels.d.ts
@@ -28,6 +28,8 @@ declare const DEFAULT_SESSION_LABELS: {
   artifactOpen: (path: string) => string;
   artifactOnRemote: (machine: string) => string;
   artifactPathUnavailable: string;
+  artifactShowDetails: string;
+  artifactHideDetails: string;
   diffFiles: (files: number) => string;
   queueEmpty: string;
   queueEmptyHint: string;
@@ -95,44 +97,39 @@ declare const DEFAULT_SESSION_LABELS: {
   usageCredits: string;
   usageUnavailable: (unauthorized: boolean, error?: string | null) => string;
   usageWindowUsed: (window: string, percent: string) => string;
+  usageResets: string;
+  usageResetsLeft: (count: number) => string;
+  usageResetUse: string;
+  usageResetUseShort: string;
+  usageResetUseOne: (title: string) => string;
+  usageResetUntitled: string;
+  usageResetDates: (grantedAt: number | null, expiresAt: number | null) => string;
+  usageResetUsing: string;
+  usageResetConfirmTitle: (provider: string) => string;
+  usageResetConfirmMessage: (count: number, title?: string | null) => string;
+  usageResetConfirm: string;
+  usageResetOutcome: (code: ProviderResetOutcome["code"], error?: string | null) => string;
   welcomeGreeting: (hour: number, name: string | null) => string;
   welcomeDate: (date: Date) => string;
-  welcomeNoUsage: string;
   welcomeUsageLabel: string;
-  welcomeViewLabel: string;
-  welcomeRangeLabel: string;
-  welcomeOverview: string;
-  welcomeModels: string;
-  welcomeRange: Record<UsageRange, string>;
-  welcomeSessions: string;
-  welcomeMessages: string;
-  welcomeTotalTokens: string;
-  welcomeTokensExact: (tokens: number) => string;
-  welcomeActiveDays: string;
-  welcomeCurrentStreak: string;
-  welcomeLongestStreak: string;
-  welcomeDays: (days: number) => string;
-  welcomePeakHour: string;
-  welcomeFavoriteModel: string;
-  welcomeNoneYet: string;
-  welcomeTokenComparison: (totalTokens: number, seed: number) => string | null;
-  welcomeComparisonSample: string;
-  welcomeActivity: string;
-  welcomeLess: string;
-  welcomeMore: string;
-  welcomeHeatmapLabel: string;
-  welcomeDay: (day: string) => string;
-  welcomeTokens: (tokens: string) => string;
-  welcomeMessageCount: (count: number) => string;
-  welcomeTokensIn: (tokens: string) => string;
-  welcomeTokensOut: (tokens: string) => string;
-  welcomeOtherModels: (count: number) => string;
-  welcomeSpend: string;
-  welcomeSpendTotal: (cost: string) => string;
-  welcomeSpendCaption: string;
-  welcomeNoModelActivity: string;
-  welcomeChartLabel: string;
-  welcomeBarTitle: (day: string, tokens: string) => string;
+  projectHomeLabel: (project: string | null) => string;
+  projectHomeBlockMenu: (block: string) => string;
+  projectHomeMoveUp: string;
+  projectHomeMoveDown: string;
+  projectHomeHide: string;
+  projectHomeRefresh: string;
+  projectHomeCustomize: string;
+  projectHomeSwitch: string;
+  projectHomeDone: string;
+  projectHomeAddBlock: string;
+  projectHomeFullWidth: string;
+  projectHomeHalfWidth: string;
+  projectHomeDrag: (block: string) => string;
+  projectHomeOpenFiles: (path: string) => string;
+  projectHomeOpenRepo: (repo: string, web: boolean) => string;
+  projectHomeReveal: string;
+  projectHomeOpenEditor: string;
+  projectHomeRemote: string;
   headerChat: string;
   headerMainFolder: string;
   headerChatRunning: string;

package/dist/session/headless/labels.js

@@ -1,4 +1,3 @@
-import { tokenComparison } from "./usage-format.js";
 //#region src/session/headless/labels.ts
 const plural = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
 /** A kind label in the plural, lower case (`pull request` → `pull requests`, `branch` → `branches`). */
@@ -7,6 +6,16 @@ function pluralKind(label, count) {
 	if (count === 1) return lower;
 	return /(?:s|x|ch|sh)$/.test(lower) ? `${lower}es` : `${lower}s`;
 }
+/** `Jul 17`, with the year when it isn't this one. */
+const shortDate = (ms) => {
+	const date = new Date(ms);
+	const year = date.getFullYear() !== (/* @__PURE__ */ new Date()).getFullYear();
+	return date.toLocaleDateString("en-US", {
+		month: "short",
+		day: "numeric",
+		...year ? { year: "numeric" } : {}
+	});
+};
 const GREETING = (hour) => hour < 5 ? "Up late" : hour < 12 ? "Good morning" : hour < 18 ? "Good afternoon" : "Good evening";
 /** The artifacts, queue, running work, turn details, usage, welcome, header and details strings. */
 const SESSION_SURFACE_LABELS = {
@@ -25,6 +34,8 @@ const SESSION_SURFACE_LABELS = {
 	artifactOpen: (path) => `Open ${path}`,
 	artifactOnRemote: (machine) => `On ${machine}, not this computer.`,
 	artifactPathUnavailable: "Path unavailable.",
+	artifactShowDetails: "Show details",
+	artifactHideDetails: "Hide details",
 	diffFiles: (files) => files === 1 ? "1 file" : `${files} files`,
 	queueEmpty: "Nothing queued",
 	queueEmptyHint: "A message you send while the agent works waits here, then goes out when the run ends.",
@@ -92,59 +103,49 @@ const SESSION_SURFACE_LABELS = {
 	usageCredits: "Credits",
 	usageUnavailable: (unauthorized, error) => `${unauthorized ? "Not signed in" : "Unavailable"}${error ? `: ${error}` : ""}`,
 	usageWindowUsed: (window, percent) => `${window} ${percent}% used`,
+	usageResets: "Resets",
+	usageResetsLeft: (count) => `${count} left`,
+	usageResetUse: "Use a reset",
+	usageResetUseShort: "Use",
+	usageResetUseOne: (title) => `Use ${title}`,
+	usageResetUntitled: "Reset",
+	usageResetDates: (grantedAt, expiresAt) => [grantedAt !== null ? `granted ${shortDate(grantedAt)}` : null, expiresAt !== null ? `expires ${shortDate(expiresAt)}` : "no expiry"].filter(Boolean).join(" · "),
+	usageResetUsing: "Resetting…",
+	usageResetConfirmTitle: (provider) => `Use a reset on ${provider}?`,
+	usageResetConfirmMessage: (count, title) => `${title ? `Spends “${title}”. ` : ""}Every usage limit on this account goes back to 0% now. ${count === 1 ? "This is your last reset." : `You have ${plural(count, "reset")}.`}`,
+	usageResetConfirm: "Use reset",
+	usageResetOutcome: (code, error) => ({
+		reset: "Usage limits reset.",
+		nothing_to_reset: "Nothing to reset: no limit has usage. The reset was not spent.",
+		no_credit: "No reset left.",
+		already_redeemed: "This reset was already used.",
+		failed: `Reset failed${error ? `: ${error}` : ""}. Refresh to check whether it applied.`
+	})[code],
 	welcomeGreeting: (hour, name) => `${GREETING(hour)}${name ? `, ${name}` : ""}`,
 	welcomeDate: (date) => date.toLocaleDateString("en-US", {
 		weekday: "long",
 		month: "long",
 		day: "numeric"
 	}),
-	welcomeNoUsage: "No usage yet. Start a chat to see your stats here.",
 	welcomeUsageLabel: "Usage",
-	welcomeViewLabel: "Usage view",
-	welcomeRangeLabel: "Time range",
-	welcomeOverview: "Overview",
-	welcomeModels: "Models",
-	welcomeRange: {
-		all: "All",
-		"30d": "30d",
-		"7d": "7d"
-	},
-	welcomeSessions: "Sessions",
-	welcomeMessages: "Messages",
-	welcomeTotalTokens: "Total tokens",
-	welcomeTokensExact: (tokens) => `${tokens.toLocaleString("en-US")} tokens`,
-	welcomeActiveDays: "Active days",
-	welcomeCurrentStreak: "Current streak",
-	welcomeLongestStreak: "Longest streak",
-	welcomeDays: (days) => `${days} ${days === 1 ? "day" : "days"}`,
-	welcomePeakHour: "Peak hour",
-	welcomeFavoriteModel: "Favorite model",
-	welcomeNoneYet: "None yet",
-	welcomeTokenComparison: (totalTokens, seed) => tokenComparison(totalTokens, seed),
-	welcomeComparisonSample: "You've processed the tokens of a few long books.",
-	welcomeActivity: "Activity, last 26 weeks",
-	welcomeLess: "Less",
-	welcomeMore: "More",
-	welcomeHeatmapLabel: "Daily activity heatmap",
-	welcomeDay: (day) => {
-		const [y, m, d] = day.split("-").map(Number);
-		return new Date(y, m - 1, d).toLocaleDateString("en-US", {
-			month: "short",
-			day: "numeric",
-			year: "numeric"
-		});
-	},
-	welcomeTokens: (tokens) => `${tokens} tokens`,
-	welcomeMessageCount: (count) => `${count} ${count === 1 ? "message" : "messages"}`,
-	welcomeTokensIn: (tokens) => `${tokens} in`,
-	welcomeTokensOut: (tokens) => `${tokens} out`,
-	welcomeOtherModels: (count) => `${count} other ${count === 1 ? "model" : "models"}`,
-	welcomeSpend: "Spend by provider",
-	welcomeSpendTotal: (cost) => `${cost} total`,
-	welcomeSpendCaption: "Estimated at API list prices. Your bill may differ.",
-	welcomeNoModelActivity: "No model activity in this range.",
-	welcomeChartLabel: "Daily token usage by model",
-	welcomeBarTitle: (day, tokens) => `${day}: ${tokens} tokens`,
+	projectHomeLabel: (project) => project ? `${project} home` : "Home",
+	projectHomeBlockMenu: (block) => `${block} options`,
+	projectHomeMoveUp: "Move up",
+	projectHomeMoveDown: "Move down",
+	projectHomeHide: "Hide block",
+	projectHomeRefresh: "Refresh",
+	projectHomeCustomize: "Customize",
+	projectHomeSwitch: "Switch project",
+	projectHomeDone: "Done",
+	projectHomeAddBlock: "Add block",
+	projectHomeFullWidth: "Full width",
+	projectHomeHalfWidth: "Half width",
+	projectHomeDrag: (block) => `Drag to move ${block}`,
+	projectHomeOpenFiles: (path) => `${path}. Click to open in Files, right-click for more`,
+	projectHomeOpenRepo: (repo, web) => web ? `Open ${repo} on the web` : `${repo}: show the working tree`,
+	projectHomeReveal: "Open in Finder",
+	projectHomeOpenEditor: "Open in editor",
+	projectHomeRemote: "Blocks show for projects on this computer. Projects on a server get them later.",
 	headerChat: "Chat",
 	headerMainFolder: "Main has no folder. It works through the sessions in each project.",
 	headerChatRunning: "Chat. Stop the run to attach a folder",