zidane-ui 9.0.4 → 9.1.3

package/src/session/headless/host.ts

@@ -1,255 +0,0 @@
-/**
- * The session panels' host: a session's todo list, its type-ahead message
- * queue, the artifacts it produced, its running work, its turns, its
- * details actions, and usage. An app implements it once (over IPC,
- * over zidane-server, in memory) and hands it to `SessionProvider` (or
- * `AppHost.session`).
- *
- * Every member is optional: a host that leaves one out hides what needs it
- * (no `todos.set`: the Todos panel is read-only; no `queue`: nothing shows
- * a queue). Data comes as per-session readable stores, actions as async
- * methods.
- */
-import type { SessionArtifact } from 'zidane';
-import type { ExtensionArtifactRowFact, ExtensionBadgeIcon, ExtensionBadgeTone } from 'zidane/chat/pure';
-import type { PromptAttachment, QueuedAttachment, TodoItem, TodosSnapshot } from 'zidane/chat';
-import type { IpcResult, RunningWorkItem } from 'zidane/ipc';
-import type { SessionTurn } from 'zidane/types';
-
-import type { Readable } from '../../chat/headless/store';
-import type { ProviderUsageSnapshot, UsageRange, UsageSummary } from './usage';
-
-export type {
-  PromptAttachment,
-  QueuedAttachment,
-  RunningWorkItem,
-  SessionArtifact,
-  SessionTurn,
-  TodoItem,
-  TodosSnapshot,
-};
-
-/** One message waiting in a session's queue, as the queue panel shows it. */
-export interface QueuedMessage {
-  /** The entry's id, assigned by the backend. */
-  id: string;
-  /** The message text. */
-  text: string;
-  /** The session the entry belongs to, so a row can act on the queue without its parent's help. */
-  sessionId: string;
-  /** What rides with the text, without the bytes (`queue.attachments` fetches them). */
-  attachments?: readonly QueuedAttachment[];
-}
-
-/** How the backend delivered a message added to the queue. */
-export type QueueAddDelivery = 'queued' | 'sent' | 'steer';
-
-/** How the backend delivered a queued message pushed into the run now (`missing`: the entry was gone). */
-export type QueuePushDelivery = 'steer' | 'send' | 'queued' | 'missing';
-
-/** What goes with a message added to the queue. */
-export interface QueueAddOptions {
-  /** Skills activated with the message. */
-  activatedSkills?: string[];
-  /** Attachments with their bytes. */
-  attachments?: PromptAttachment[];
-}
-
-/** An artifact's row, rendered by the backend (the kind registry lives there). */
-export interface SessionArtifactRowView {
-  /** Row title. */
-  title: string;
-  /** Secondary line under the title (older rows; `lead` / `diff` / `facts` replace it). */
-  subtitle?: string;
-  /** Where "open" goes: a URL or an absolute path. */
-  href?: string;
-  /** Short state tag (`open`, `merged`…). */
-  status?: string;
-  /** Small facts after the title (older rows). */
-  badges?: readonly { text: string; tone?: 'neutral' | 'diff' | 'success' | 'warn'; title?: string }[];
-  /** The state icon. */
-  icon?: ExtensionBadgeIcon;
-  /** Tints the icon and the status word. */
-  tone?: ExtensionBadgeTone;
-  /** Exact color for the icon and status word, over `tone`. */
-  color?: string;
-  /** A short id (a commit hash, `owner/repo#12`); `mono` for hashes. */
-  lead?: { text: string; href?: string; mono?: boolean };
-  /** A change size, painted in the diff colors. */
-  diff?: { added: number; removed: number; files?: number; href?: string };
-  /** Quiet facts after the diff. */
-  facts?: readonly ExtensionArtifactRowFact[];
-}
-
-/** One artifact and its rendered row. */
-export interface SessionArtifactRow {
-  /** The stored artifact. */
-  artifact: SessionArtifact;
-  /** How it shows. */
-  row: SessionArtifactRowView;
-}
-
-/** A session's artifacts of one kind. */
-export interface SessionArtifactGroup {
-  /** The artifact kind id (`pull_request`, `commit`…). */
-  kind: string;
-  /** The kind's label (`Pull request`), the raw kind when unregistered. */
-  label: string;
-  /** The artifacts of this kind, newest first. */
-  rows: SessionArtifactRow[];
-}
-
-/** A session's live todo list. */
-export interface SessionTodos {
-  /** The session's snapshot: `null` until read, or when no run owns a list yet. One store per session id. */
-  snapshot(sessionId: string): Readable<TodosSnapshot | null>;
-  /** Reads the session's list (also the first read). Never rejects: the next push catches up. */
-  refresh(sessionId: string): Promise<void>;
-  /** Replaces the whole list (already transformed by `zidane/chat/pure`'s todo edits). Resolves `false` when nothing applied it. Absent: read-only. */
-  set?(sessionId: string, items: readonly TodoItem[]): Promise<boolean>;
-  /** Sends a message into the session's run (it steers a live run, starts one when idle): the retry of a todo. */
-  retry?(sessionId: string, message: string): Promise<void>;
-}
-
-/** A session's type-ahead queue: messages sent while the agent works, delivered when the run ends. */
-export interface SessionQueue {
-  /** The session's entries, in delivery order (empty when none). One store per session id. */
-  items(sessionId: string): Readable<readonly QueuedMessage[]>;
-  /** Reads the session's queue (on activation). Best effort. */
-  refresh(sessionId: string): void;
-  /** Queues a message (the backend sends it right away when the session is idle). */
-  add?(sessionId: string, text: string, options?: QueueAddOptions): Promise<QueueAddDelivery>;
-  /** Drops an entry. The store drops it at once; the backend converges. */
-  remove?(sessionId: string, id: string): void;
-  /** Replaces an entry's text, and its attachments when given (`[]` removes them). Resolves once the backend has it. */
-  update?(sessionId: string, id: string, text: string, attachments?: PromptAttachment[]): Promise<void>;
-  /** An entry's attachments with their bytes; `null` when the entry is gone. */
-  attachments?(sessionId: string, id: string): Promise<PromptAttachment[] | null>;
-  /** Pushes an entry into the live run now. */
-  pushNow?(sessionId: string, id: string): Promise<QueuePushDelivery>;
-}
-
-/** What a session produced: pull requests, branches, commits, files, extension kinds. */
-export interface SessionArtifacts {
-  /** The session's artifacts by kind: `null` until first read. One store per session id. */
-  groups(sessionId: string): Readable<readonly SessionArtifactGroup[] | null>;
-  /** Reads the session's artifacts (also the first read). Rejects when the read fails. */
-  refresh(sessionId: string): Promise<void>;
-  /**
-   * Removes one artifact. Resolves `false` when the backend has no artifact support. `owner` is the session the
-   * artifact was recorded in, when the list shows another session's (a child's).
-   */
-  remove?(sessionId: string, artifactId: string, owner?: string): Promise<boolean>;
-  /**
-   * Re-resolves one artifact (is the pull request merged? its diff size?); a change re-reads the groups through the
-   * usual wake-up. `force` bypasses the backend's freshness cache. Never rejects.
-   */
-  refreshRow?(sessionId: string, artifact: SessionArtifact, options?: { force?: boolean }): Promise<void>;
-}
-
-/** A session's cancellable work: parent-level tool calls and background tasks. */
-export interface SessionRunningWork {
-  /** The session's work, live (empty for none). One store per session id. */
-  items(sessionId: string): Readable<readonly RunningWorkItem[]>;
-  /** Reads the session's work now (a dialog opening, Refresh). Rejects when the read fails. */
-  refresh(sessionId: string): Promise<void>;
-  /** Reads the session once, the first time something shows it. Never rejects. */
-  ensure(sessionId: string): void;
-  /** Cancels one item, or `'all'`. Resolves `false` when nothing was cancelled. */
-  cancel?(sessionId: string, id: string, reason?: string): Promise<boolean>;
-}
-
-/** A session's stored turns: what the turn details dialog reads and does. */
-export interface SessionTurns {
-  /** One turn as stored; `null` when it is gone. */
-  get(sessionId: string, turnId: string): Promise<SessionTurn | null>;
-  /** A new session with the history up to this turn. Resolves the new session's id. */
-  fork?(sessionId: string, turnId: string): Promise<string>;
-  /** Replaces the turn's text blocks. Refused while a run is in progress. */
-  editText?(sessionId: string, turnId: string, text: string): Promise<void>;
-  /** Deletes the turn and its tool calls. Refused while a run is in progress. */
-  delete?(sessionId: string, turnId: string): Promise<void>;
-  /** Cuts the history after the turn (`inclusive`: the turn stays) or just before it. Refused while a run is in progress. */
-  rewind?(sessionId: string, turnId: string, options: { inclusive: boolean }): Promise<void>;
-}
-
-/** A session's recent requests and their prompt-cache numbers (zidane's `CacheReport`). */
-export type SessionCacheReport = NonNullable<IpcResult<'sessions.cacheReport'>>;
-
-/** The export formats of a transcript. */
-export type SessionExportFormat = 'markdown' | 'json';
-
-/** The session details dialog's actions on one session. */
-export interface SessionDetailsActions {
-  /** How the title came about (`['auto', 'from 3 turns']`); `null` when unknown. */
-  titleStatus?(sessionId: string): Promise<readonly string[] | null>;
-  /** Writes a title generated from the conversation. Resolves it. */
-  generateTitle?(sessionId: string): Promise<string>;
-  /** Writes the transcript to a file. Resolves its absolute path. */
-  export?(sessionId: string, format: SessionExportFormat): Promise<string>;
-  /** Summarizes older turns to free context. */
-  compact?(sessionId: string): Promise<void>;
-  /** Attaches a folder (`null` detaches it: a plain chat). Refused mid-run. */
-  setFolder?(sessionId: string, folder: string | null): Promise<void>;
-  /** What the prompt cache did for the last requests (the numbers `/cache` prints); `null` when there is none. */
-  cacheReport?(sessionId: string): Promise<SessionCacheReport | null>;
-}
-
-/** Usage: spend summaries and the providers' subscription windows. */
-export interface SessionUsage {
-  /** Token spend over a range (the welcome screen). Absent: no usage card. */
-  summary?(range: UsageRange): Promise<UsageSummary>;
-  /** The model providers' subscription windows. `refresh` bypasses the backend's cache. Absent: no usage panel. */
-  providers?(options?: { refresh?: boolean }): Promise<readonly ProviderUsageSnapshot[]>;
-  /** GitHub's API limits. `probe` asks GitHub; otherwise what was observed. Absent: no GitHub section. */
-  github?(options?: { probe?: boolean }): Promise<readonly ProviderUsageSnapshot[]>;
-}
-
-/** A session row as the side chat needs it: its id; the app's pickers read the rest. */
-export interface SideChatSession {
-  /** The session's id. */
-  id: string;
-}
-
-/** A session's side chat (`null` until the first send creates it) and the session's own row. */
-export interface SideChatLookup {
-  /** The side chat's session, or `null`. */
-  side: SideChatSession | null;
-  /** The session the side chat is about, or `null` when unknown. */
-  parent: SideChatSession | null;
-}
-
-/**
- * `/side` chats: a hidden session about another one (never listed, deleted with it), running read-only tools that
- * read the parent, while the parent's own run streams.
- */
-export interface SessionSideChats {
-  /** The side chat of `parentId`, and `parentId`'s row. */
-  lookup(parentId: string): Promise<SideChatLookup>;
-  /** Creates `parentId`'s side chat in `cwd`, starting on `from`'s model and effort (the parent's row). */
-  create(parentId: string, cwd: string, from: SideChatSession | null): Promise<SideChatSession>;
-  /** Deletes a side chat, stopping its answer first when one runs. Rejects with what went wrong. */
-  remove(sideId: string): Promise<void>;
-  /** Calls `onChange` with a session's id when its row changes (a model pick). Returns the unsubscribe. */
-  subscribe?(onChange: (sessionId: string) => void): () => void;
-}
-
-/** The session panels' host. Every member is optional: what a host leaves out is not shown. */
-export interface SessionHost {
-  /** The live todo lists. Absent: no Todos panel. */
-  todos?: SessionTodos;
-  /** The type-ahead queues. Absent: no queue. */
-  queue?: SessionQueue;
-  /** The recorded artifacts. Absent: no Artifacts panel. */
-  artifacts?: SessionArtifacts;
-  /** The cancellable work. Absent: no running work dialog. */
-  runningWork?: SessionRunningWork;
-  /** The stored turns. Absent: no turn details dialog. */
-  turns?: SessionTurns;
-  /** The details dialog's actions. Absent: the dialog shows facts only. */
-  details?: SessionDetailsActions;
-  /** Usage. Absent: no usage card, no usage panel. */
-  usage?: SessionUsage;
-  /** `/side` chats about a session. Absent: no side chat. */
-  side?: SessionSideChats;
-}

package/src/session/headless/index.ts

@@ -1,22 +0,0 @@
-/**
- * `zidane-ui/session/headless`: the session panels' React-free half. The
- * `SessionHost` an app implements (todos, queue, artifacts, running work,
- * turns, details actions, usage), the stores hosts build it on, the usage
- * models and formatting, the Diffs panel's models (session edits, the changed-files
- * tree), the session actions (`createSessionActions`, `sessionKeyCommands`) and
- * the labels.
- */
-export * from './host';
-export * from './keyed';
-export * from './todos';
-export * from './queue';
-export * from './artifacts';
-export * from './running-work';
-export * from './queue-attachments';
-export * from './usage';
-export * from './usage-format';
-export * from './session-diffs';
-export * from './diff-tree';
-export * from './labels';
-export * from './side';
-export * from './session-actions';

package/src/session/headless/keyed.ts

@@ -1,72 +0,0 @@
-/**
- * A per-key value store with one `Readable` per key: a write to one session
- * notifies only that session's readers, so a host mirroring many sessions
- * re-renders the components of the session that changed, not every one.
- */
-import type { Readable } from '../../chat/headless/store';
-
-/** A map of values whose keys each have a readable store. */
-export interface KeyedState<V, Fallback = null> {
-  /** The value under `key`, `undefined` when unset. */
-  get(key: string): V | undefined;
-  /** Sets the value under `key`; its readers hear it when it changed by identity. */
-  set(key: string, value: V): void;
-  /** Forgets `key` (a deleted session): its readers see the fallback. */
-  delete(key: string): void;
-  /** Forgets every key. */
-  clear(): void;
-  /** The store of one key, the same object for the same key. Reads `fallback` while unset. */
-  readable(key: string): Readable<V | Fallback>;
-}
-
-/**
- * Creates a {@link KeyedState}.
- *
- * @param fallback - What a key's store reads while it holds no value.
- */
-export function createKeyedState<V, Fallback = null>(fallback: Fallback): KeyedState<V, Fallback> {
-  const values = new Map<string, V>();
-  const listeners = new Map<string, Set<() => void>>();
-  const stores = new Map<string, Readable<V | Fallback>>();
-  const notify = (key: string) => {
-    for (const l of [...(listeners.get(key) ?? [])]) l();
-  };
-  return {
-    get: (key) => values.get(key),
-    set(key, value) {
-      if (values.has(key) && Object.is(values.get(key), value)) return;
-      values.set(key, value);
-      notify(key);
-    },
-    delete(key) {
-      if (!values.delete(key)) return;
-      notify(key);
-    },
-    clear() {
-      const keys = [...values.keys()];
-      values.clear();
-      for (const key of keys) notify(key);
-    },
-    readable(key) {
-      let store = stores.get(key);
-      if (!store) {
-        store = {
-          get: () => (values.has(key) ? values.get(key)! : fallback),
-          subscribe(onChange) {
-            let set = listeners.get(key);
-            if (!set) listeners.set(key, (set = new Set()));
-            set.add(onChange);
-            const own = set;
-            return () => {
-              own.delete(onChange);
-              // A late unsubscribe of an emptied set must not drop the newer set under the same key.
-              if (own.size === 0 && listeners.get(key) === own) listeners.delete(key);
-            };
-          },
-        };
-        stores.set(key, store);
-      }
-      return store;
-    },
-  };
-}

package/src/session/headless/labels.ts

@@ -1,321 +0,0 @@
-/**
- * The session panels' strings (the desktop app's wording). One flat
- * dictionary an app overrides with `<LabelsProvider>` or the `labels` prop
- * of `SessionProvider`. Keys you leave out keep the default English label.
- */
-import type { TodoStatus } from 'zidane/chat';
-
-import type { RunningWorkItem } from './running-work';
-import type { UsageRange } from './usage';
-import { tokenComparison } from './usage-format';
-
-const plural = (n: number, noun: string) => `${n} ${noun}${n === 1 ? '' : 's'}`;
-
-/** A kind label in the plural, lower case (`pull request` → `pull requests`, `branch` → `branches`). */
-function pluralKind(label: string, count: number): string {
-  const lower = label.toLowerCase();
-  if (count === 1) return lower;
-  return /(?:s|x|ch|sh)$/.test(lower) ? `${lower}es` : `${lower}s`;
-}
-
-/** Where a session's folder is, as the details dialog words it. */
-type FolderLocation = { kind: 'server-gone' } | { kind: 'machine'; name: string } | { kind: 'sandbox' };
-
-const GREETING = (hour: number) =>
-  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 = {
-  // Dialog shells
-  shellClose: 'Close',
-  // The Artifacts panel
-  artifactsLabel: 'Artifacts',
-  artifactsEmpty: 'Nothing yet',
-  artifactsEmptyHint:
-    'Pull requests, branches and commits show up here as the agent makes them. Files show only when recorded.',
-  artifactsUnsupported: 'This session store does not support artifacts.',
-  artifactsGroup: (label: string, count: number) => (count === 1 ? label : `${label}s`),
-  artifactsCount: (label: string, count: number) => `${count} ${pluralKind(label, count)}`,
-  artifactCopySha: 'Copy SHA',
-  artifactCopyLink: 'Copy link',
-  artifactCopyPath: 'Copy path',
-  artifactReveal: 'Reveal in Finder',
-  artifactRemove: 'Remove from session',
-  artifactOpen: (path: string) => `Open ${path}`,
-  artifactOnRemote: (machine: string) => `On ${machine}, not this computer.`,
-  artifactPathUnavailable: 'Path unavailable.',
-  diffFiles: (files: number) => (files === 1 ? '1 file' : `${files} files`),
-  // The Queue panel
-  queueEmpty: 'Nothing queued',
-  queueEmptyHint: 'A message you send while the agent works waits here, then goes out when the run ends.',
-  queueCount: (count: number) => `${count} queued`,
-  queueOrder: 'Sent in order when the run ends',
-  queueListLabel: 'Queued messages',
-  queueEditHint: 'Edit before sending',
-  queueEdit: 'Edit',
-  queueSaveAndPush: 'Save and send now',
-  queuePush: 'Send now (between tool calls)',
-  queueRemove: 'Remove from queue',
-  queueAttachmentName: (attachment: { name?: string; mediaType: string }) =>
-    attachment.name ?? (attachment.mediaType.startsWith('image/') ? 'image' : attachment.mediaType),
-  queueViewAttachments: (count: number, first: string) => (count === 1 ? `View ${first}` : `View ${count} attachments`),
-  queueEditLabel: 'Edit queued message',
-  queueHintSave: 'Save',
-  queueHintNewline: 'Newline',
-  queueHintPush: 'Send now',
-  queueHintCancel: 'Cancel',
-  queueAttach: 'Attach files',
-  queueCancel: 'Cancel',
-  queueSave: 'Save',
-  // Running work
-  runningWorkTitle: 'Running work',
-  runningWorkDescription: 'Tool calls and background tasks you can stop.',
-  runningWorkRefresh: 'Refresh',
-  runningWorkCancelAll: 'Cancel all',
-  runningWorkCancel: 'Cancel',
-  runningWorkCancelling: 'Cancelling…',
-  runningWorkEmpty: 'Nothing is running',
-  runningWorkKind: { tool: 'Tool call', task: 'Background task' } as Record<RunningWorkItem['kind'], string>,
-  runningWorkShowTerminal: 'Show terminal',
-  // Turn details
-  turnTitle: 'Turn details',
-  turnLoading: 'Loading…',
-  turnRole: (role: string | null) => `${role ?? '…'} turn`,
-  turnBefore: (count: number) => `${count} before`,
-  turnAfter: (count: number) => `${count} after`,
-  turnCopy: 'Copy',
-  turnCopied: 'Copied',
-  turnCopyHint: 'To clipboard',
-  turnCopyFailed: (message: string) => `Copy failed: ${message}`,
-  turnFork: 'Fork',
-  turnForkHint: 'New session from here',
-  turnEdit: 'Edit',
-  turnEditHint: 'Change its text',
-  turnNoText: 'No text to edit',
-  turnStopFirst: 'Stop the run first',
-  turnDelete: 'Delete',
-  turnDeleteHint: 'Remove it and its tool calls',
-  turnCancel: 'Cancel',
-  turnSave: 'Save',
-  turnSaving: 'Saving…',
-  turnTextLabel: 'Turn text',
-  // The usage panel
-  usageTitle: 'Usage',
-  usageChecking: 'Checking signed-in providers…',
-  usageNone: 'No signed-in provider reports usage.',
-  usageOff: 'Usage checks are off. Press Refresh to check once.',
-  usageDescription: 'Rate-limit windows and credits for signed-in providers and GitHub.',
-  usageRefresh: 'Refresh',
-  usageRefreshing: 'Refreshing…',
-  usageModelProviders: 'Model providers',
-  usageGithub: 'GitHub',
-  usageInUse: 'In use',
-  usageCredits: 'Credits',
-  usageUnavailable: (unauthorized: boolean, error?: string | null) =>
-    `${unauthorized ? 'Not signed in' : 'Unavailable'}${error ? `: ${error}` : ''}`,
-  usageWindowUsed: (window: string, percent: string) => `${window} ${percent}% used`,
-  // The welcome screen
-  welcomeGreeting: (hour: number, name: string | null) => `${GREETING(hour)}${name ? `, ${name}` : ''}`,
-  welcomeDate: (date: 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' } as Record<UsageRange, string>,
-  welcomeSessions: 'Sessions',
-  welcomeMessages: 'Messages',
-  welcomeTotalTokens: 'Total tokens',
-  welcomeTokensExact: (tokens: number) => `${tokens.toLocaleString('en-US')} tokens`,
-  welcomeActiveDays: 'Active days',
-  welcomeCurrentStreak: 'Current streak',
-  welcomeLongestStreak: 'Longest streak',
-  welcomeDays: (days: number) => `${days} ${days === 1 ? 'day' : 'days'}`,
-  welcomePeakHour: 'Peak hour',
-  welcomeFavoriteModel: 'Favorite model',
-  welcomeNoneYet: 'None yet',
-  welcomeTokenComparison: (totalTokens: number, seed: number): string | null => 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: string) => {
-    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: string) => `${tokens} tokens`,
-  welcomeMessageCount: (count: number) => `${count} ${count === 1 ? 'message' : 'messages'}`,
-  welcomeTokensIn: (tokens: string) => `${tokens} in`,
-  welcomeTokensOut: (tokens: string) => `${tokens} out`,
-  welcomeOtherModels: (count: number) => `${count} other ${count === 1 ? 'model' : 'models'}`,
-  welcomeSpend: 'Spend by provider',
-  welcomeSpendTotal: (cost: string) => `${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: string, tokens: string) => `${day}: ${tokens} tokens`,
-  // The session header
-  headerChat: 'Chat',
-  headerMainFolder: 'Main has no folder. It works through the sessions in each project.',
-  headerChatRunning: 'Chat. Stop the run to attach a folder',
-  headerFolderOnServer: (cwd: string, server: string | null) => `${cwd || 'No folder'} on ${server ?? 'a server'}`,
-  headerChatAttach: 'Chat. Click to attach a folder',
-  headerChangeFolder: (cwd: string) => `${cwd}. Click to change folder`,
-  headerServerGone: 'This server is no longer saved',
-  headerOnServer: (server: string | null) => `on ${server ?? 'a removed server'}`,
-  headerRename: 'Rename session',
-  headerDetails: 'Session details',
-  // Session details
-  detailsTitle: 'Session details',
-  detailsMainDescription: 'Main runs your other sessions',
-  detailsMainTitle: 'Main',
-  detailsMainKeepsName: 'The Main session keeps its name',
-  detailsTitleLabel: 'Session title',
-  detailsSave: 'Save',
-  detailsGenerate: 'Generate',
-  detailsGenerating: 'Generating…',
-  detailsGenerateHint: 'Generate a title from the conversation',
-  detailsDelete: 'Delete session',
-  detailsDeleting: 'Deleting…',
-  detailsStatus: 'Status',
-  // Session details: the prompt cache
-  cacheScopeLast: (shown: number, total: number) => `last ${shown} of ${total} requests`,
-  cacheScopeAll: (total: number) => `${total} request${total === 1 ? '' : 's'}`,
-  cacheUncached: (pct: number) => `${pct}% not from the cache`,
-  cacheBreaks: (count: number) => `${count} break${count === 1 ? '' : 's'}`,
-  cacheExpiresIn: (until: string) => `expires in about ${until}`,
-  cacheExpired: 'likely expired',
-  cacheShowRequests: 'Show requests',
-  cacheHideRequests: 'Hide requests',
-  cacheExpiryHint: 'An estimate: the provider can drop it earlier',
-  cacheColumns: {
-    turn: 'Turn',
-    prompt: 'Prompt',
-    cached: 'From cache',
-    reread: 'Re-read',
-    ttft: 'First token',
-    energy: 'Energy',
-    dropped: 'Reasoning dropped',
-  } as Record<'turn' | 'prompt' | 'cached' | 'reread' | 'ttft' | 'energy' | 'dropped', string>,
-  detailsStatusLabel: { idle: 'Idle', running: 'Running', completed: 'Completed', error: 'Error' } as Record<
-    'idle' | 'running' | 'completed' | 'error',
-    string
-  >,
-  detailsActivity: 'Activity',
-  detailsTurns: (count: number) => plural(count, 'turn'),
-  detailsMessages: (count: number) => plural(count, 'message'),
-  detailsRuns: (count: number) => plural(count, 'run'),
-  detailsModel: 'Model',
-  detailsProviderHint: 'Provider',
-  detailsDefaultModel: 'Default',
-  detailsEffortHint: 'Reasoning effort',
-  detailsAccountHint: 'Account it runs on',
-  detailsAccountSignedOut: 'account signed out',
-  detailsAgent: 'Agent',
-  detailsTitleFact: 'Title',
-  detailsSpace: 'Space',
-  detailsSpaceLabel: 'Session space',
-  detailsSpaceHint: 'Move this session to another space',
-  detailsMainEverySpace: 'Main shows in every space',
-  detailsCreated: 'Created',
-  detailsUpdated: 'Updated',
-  detailsUnknown: 'unknown',
-  detailsId: 'ID',
-  detailsCopyId: 'Copy session id',
-  detailsCopyIdHint: 'Copy id',
-  detailsCopied: 'Copied',
-  detailsFolder: 'Folder',
-  detailsMainNoFolder: 'None. Main has no folder.',
-  detailsNoFolder: 'No folder. Tools have no working directory.',
-  detailsReveal: 'Open in Finder',
-  detailsRevealHint: (cwd: string) => `Show ${cwd} in Finder`,
-  detailsFolderGone: (cwd: string) => `Couldn't open ${cwd}. The folder is gone.`,
-  detailsFolderLocation: (where: FolderLocation) =>
-    where.kind === 'server-gone'
-      ? 'on a server that is no longer saved'
-      : where.kind === 'machine'
-        ? `on ${where.name}`
-        : 'in its sandbox',
-  detailsFolderElsewhere: (where: string) => `The folder is ${where}: this computer's picker can't choose it`,
-  detailsMainHasNoFolder: 'Main has no folder',
-  detailsStopToChange: 'Stop the run to change the folder',
-  detailsPickOther: 'Pick a different folder',
-  detailsAttachHint: 'Attach a folder for tools to work in',
-  detailsChange: 'Change…',
-  detailsSetFolder: 'Set folder…',
-  detailsStopToDetach: 'Stop the run to detach the folder',
-  detailsDetachHint: 'Detach the folder and keep chatting',
-  detailsDetach: 'Detach',
-  detailsCache: 'Cache',
-  detailsCompact: 'Compact context',
-  detailsCompactHint: 'Summarize older turns to free up context.',
-  detailsCompactNow: 'Compact now',
-  detailsCompacting: 'Compacting…',
-  detailsExport: 'Export transcript',
-  detailsExportHint: 'Write the conversation to a file next to the project.',
-  detailsSavedTo: 'Saved to',
-  detailsExporting: 'Exporting…',
-  detailsMarkdown: 'Markdown',
-  detailsJson: 'JSON',
-};
-
-const STATUS: Record<TodoStatus, string> = {
-  pending: 'pending',
-  in_progress: 'in progress',
-  completed: 'completed',
-  cancelled: 'cancelled',
-};
-
-/** The default English strings of the session panels. Override any of them through `SessionProvider`. */
-export const DEFAULT_SESSION_LABELS = {
-  // The Diffs file list
-  diffChangedFiles: 'Changed files',
-  diffFindings: (errors: number, warnings: number) =>
-    `${errors} error${errors === 1 ? '' : 's'}, ${warnings} warning${warnings === 1 ? '' : 's'} from project tools`,
-  // The todo tally chips
-  todoTally: { in_progress: 'in progress', completed: 'done', pending: 'pending', cancelled: 'cancelled' } as Record<
-    TodoStatus,
-    string
-  >,
-  // The Todos panel
-  todosEmpty: 'No todos yet',
-  todosEmptyHint: 'Add one below. The agent adds its own when it plans a task.',
-  todosLastList: 'Last list',
-  todosProgress: (done: number, total: number) => `${done}/${total} done`,
-  todoStatus: (status: TodoStatus) => STATUS[status],
-  todoChangeStatus: (status: TodoStatus) => `Change status, ${STATUS[status]}`,
-  todoChangeStatusHint: (status: TodoStatus) => `${STATUS[status]} (click to change)`,
-  todoEdit: 'Edit',
-  todoRetry: 'Retry',
-  todoRetryHint: 'Ask the agent to retry it',
-  todoRemove: 'Remove todo',
-  todoRemoveHint: 'Remove',
-  todosSaveFailed: "Couldn't save the todo list.",
-  todoAddPlaceholder: 'Add a todo…',
-  todoAddLabel: 'Add a todo',
-  todoAdd: 'Add',
-  todosClearConfirm: (count: number) => `Delete all ${count} todos?`,
-  todosClearYes: 'Yes',
-  todosClearCancel: 'Cancel',
-  todosClearHint: 'Remove all todos',
-  todosClear: 'Clear all',
-  // The side chat
-  sideEmptyTitle: 'Ask about this conversation',
-  sideEmptyHint: "The side chat sees the agent's work and never interrupts it.",
-  sidePlaceholder: 'Ask on the side…',
-  sideComposerLabel: 'Side chat message',
-  sideResetDescription: 'Clear this side chat and start over',
-  sideResetFailed: (reason: string) => `Couldn't reset this side chat: ${reason}`,
-  sideRefusal: (reason: 'no-conversation' | 'unavailable' | 'no-panel') =>
-    reason === 'no-conversation'
-      ? 'Send a message first. A side chat follows a conversation.'
-      : reason === 'unavailable'
-        ? "Side chats work only on this computer's conversations"
-        : 'This window has no side panel for side chats',
-  ...SESSION_SURFACE_LABELS,
-};
-
-/** The shape of the session label dictionary. Some values are functions that build a string. */
-export type SessionLabels = typeof DEFAULT_SESSION_LABELS;