zidane-ui 9.0.4 → 9.1.3

package/src/chat/headless/host.ts

@@ -1,259 +0,0 @@
-/**
- * The seam between the chat components and whatever runs the agent.
- *
- * A host is data (readable stores) plus actions. Everything optional is a
- * capability: when a host leaves a method out, the components hide the
- * control that would call it (no rename item without `sessions.rename`, no
- * stop button without `interrupt`). The desktop app, a server connection,
- * an agent running in the page and a recorded fixture all implement this.
- */
-import type { InteractionRequest, InteractionResponse, StreamEvent } from 'zidane/chat';
-import type { PromptSegmentRef } from 'zidane/chat/pure';
-
-import type { SessionRemoval } from './sidebar/directory';
-import type { SessionArchiveFilter, SidebarListSession } from './sidebar/types';
-import type { SidebarViewsHost } from './sidebar/view';
-import type { Readable } from './store';
-import type {
-  ChatBadgeActions,
-  ChatChipDetails,
-  ChatPaths,
-  ChatReferences,
-  ChatSearchSync,
-  ChatSiteIcons,
-} from './transcript-host';
-
-/** An attachment on a prompt, as the components can show it. */
-export interface ChatAttachment {
-  /** File name shown on the attachment chip. */
-  name: string;
-  /** MIME type, for example `image/png`. */
-  mediaType: string;
-  /** Size in bytes. */
-  size: number;
-  /** Where a preview loads the bytes from (images and PDFs): a `data:` URL, an object URL, or any URL the page can load. */
-  dataUrl?: string;
-}
-
-/**
- * zidane's canonical transcript event, plus what a live client knows and a
- * replay does not: attachment previews, arrival times, clipped outputs and
- * thinking durations. Every extra is optional; a replayed `StreamEvent`
- * list is a valid `ChatEvent` list.
- */
-export type ChatEvent = Omit<StreamEvent, 'attachments'> & {
-  attachments?: readonly ChatAttachment[];
-  /**
-   * Epoch ms the client received a `tool` / `tool-result` live. Times a call
-   * only when its host sent none (`startedAt` / `durationMs`, an older host).
-   */
-  receivedAt?: number;
-  /** The `tool-result` text was cut for transport; `host.toolOutput` fetches the whole of it. */
-  clipped?: true;
-  /** Epoch ms a live thinking segment opened (on its first event). */
-  thinkingStartedAt?: number;
-  /** A closed live thinking segment's duration, replacing `thinkingStartedAt`. */
-  thinkingMs?: number;
-};
-
-/** Run state of a session: `idle`, `running`, `completed`, or `error`. */
-export type ChatSessionStatus = 'idle' | 'running' | 'completed' | 'error';
-
-/** A session as the list shows it. */
-export interface ChatSession {
-  /** Stable session id. Passed to every host method that takes a `sessionId`. */
-  id: string;
-  /** Name shown in the list and used by the title search. */
-  title: string;
-  /** Run state, shown as the row's status dot. */
-  status: ChatSessionStatus;
-  /** Epoch milliseconds. */
-  createdAt: number;
-  /** Epoch milliseconds of the last activity. Drives recency sorting and relative times. */
-  updatedAt: number;
-  /** The session is archived. The list row shows an archive glyph. */
-  archived?: boolean;
-  /** Listed first, in the favorites section. */
-  favorite?: boolean;
-  /** Sessions sharing a group are listed together (a project, a folder, a host). */
-  group?: string;
-  /** Shown as the group's heading; defaults to `group`. */
-  groupLabel?: string;
-  /** Kept at the top of the list (the orchestrating main session). */
-  pinned?: boolean;
-  /** Id of the model the session uses, as listed in `host.models`. */
-  modelId?: string;
-}
-
-/** The state a {@link Transcript} store holds for one session. */
-export interface TranscriptState {
-  /** The events loaded so far, oldest first. */
-  events: readonly ChatEvent[];
-  /** A run is in flight: the last reply may still be streaming. */
-  running: boolean;
-  /** History has arrived (until then the transcript shows its loading state). */
-  hydrated: boolean;
-  /** Older events exist before `events[0]` (`loadEarlier` fetches them). */
-  hasEarlier?: boolean;
-  /** An earlier page of events is being fetched. */
-  loadingEarlier?: boolean;
-}
-
-/** A readable store of one session's {@link TranscriptState}. */
-export interface Transcript extends Readable<TranscriptState> {
-  /** Fetches older events and prepends them to `events`. Absent: the Earlier messages control is hidden. */
-  loadEarlier?(): void;
-}
-
-/** A request from the agent that waits for the user: a question, a plan, or an approval. */
-export interface ChatInteraction {
-  /** Id of the request. Pass it to `interactions.answer` or `interactions.cancel`. */
-  requestId: string;
-  /** Id of the session the request belongs to. */
-  sessionId: string;
-  /** The request itself: its kind and the content to show. */
-  request: InteractionRequest;
-  /** `false`: rehydrated from an earlier run, not raised by a run waiting right now (an inbox only badges it). Absent: live. */
-  live?: boolean;
-}
-
-/** A model a session can run. */
-export interface ChatModel {
-  /** Model id within its provider. Combined with the provider key as `provider/model` in {@link SendInput}. */
-  id: string;
-  /** Display name for pickers. */
-  label?: string;
-  /** Context window size in tokens. Drives the context meter. */
-  contextWindow?: number;
-  /** Supports extended thinking / reasoning effort. */
-  thinking?: boolean;
-  /** Feature toggles the model declares (fast mode), as the model options menu lists them. */
-  options?: readonly { id: string; label: string; description?: string }[];
-  /** Short facts the picker shows beside the name, before the window (a download size, `Cached`). */
-  details?: readonly string[];
-}
-
-/** A provider and the models it offers, as the model picker groups them. */
-export interface ChatModelProvider {
-  /** Provider id, the `provider` part of a `provider/model` reference. */
-  key: string;
-  /** Provider name shown as the group heading. */
-  label: string;
-  /** Models the provider offers. */
-  models: readonly ChatModel[];
-}
-
-/** What the composer sends to {@link ChatHost.send}. */
-export interface SendInput {
-  /** Id of the session to send to. */
-  sessionId: string;
-  /** The prompt text. */
-  prompt: string;
-  /** Files attached to the prompt. */
-  attachments?: readonly ChatAttachment[];
-  /** `provider/model` or a bare model id, as the host understands it. */
-  model?: string;
-  /** Reasoning effort for this prompt. `off` turns extended thinking off. */
-  thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
-  /** Skills picked through `/` completion, activated before the run. */
-  activatedSkills?: readonly string[];
-  /** The completions the prompt used (skills, files, chats), for its echo's chips. */
-  refs?: readonly PromptSegmentRef[];
-  /** `false`: a `/` command that shows its own header, so the prompt is not echoed. Default: echoed. */
-  echo?: boolean;
-  /** Sent from outside the composer (a retry, a palette prompt): the shared draft stays. */
-  keepDraft?: boolean;
-}
-
-/** A conversation whose content matched a search. */
-export interface SessionSearchHit {
-  /** The session that matched. */
-  sessionId: string;
-  /** Its title. */
-  title: string;
-  /** The matching text around the first hit. */
-  excerpt: string;
-  /** How many turns matched. */
-  matchCount: number;
-  /** The session's last activity, epoch ms. */
-  updatedAt: number;
-}
-
-/** The seam between the chat components and whatever runs the agent: readable stores plus optional actions. A component hides the control for any capability the host leaves out. */
-export interface ChatHost {
-  /** Session list and management. Each method left out hides its control (rename, archive, favorite, delete). */
-  sessions?: {
-    /** The sessions the list shows. */
-    list: Readable<readonly ChatSession[]>;
-    /** Creates a session, with an optional title, and resolves with it. */
-    create?(input?: { title?: string }): Promise<ChatSession>;
-    /** Sets a session's title. */
-    rename?(sessionId: string, title: string): Promise<void>;
-    /** Archives or restores a session. */
-    setArchived?(sessionId: string, archived: boolean): Promise<void>;
-    /** Marks or unmarks a session as a favorite. */
-    setFavorite?(sessionId: string, favorite: boolean): Promise<void>;
-    /** Deletes a session; resolves to `{ kept: true }` when its environment stayed on disk. */
-    remove?(sessionId: string): Promise<void | SessionRemoval>;
-    /**
-     * One host's sessions under an archive filter, with where each runs
-     * (folder, host, space): what the sidebar's session directory lists.
-     * `hostId` absent = this machine.
-     */
-    query?(filter: { archive: SessionArchiveFilter; hostId?: string }): Promise<readonly SidebarListSession[]>;
-    /** Moves a session to a space. */
-    setSpace?(sessionId: string, spaceId: string): Promise<void>;
-    /** Searches conversation content; hits for sessions the filter lists, best first. */
-    search?(query: string, filter?: { archive?: SessionArchiveFilter }): Promise<readonly SessionSearchHit[]>;
-    /** Fires (possibly in bursts) with a session whose row changed: created, renamed, moved, archived, deleted. */
-    onChanged?(listener: (sessionId: string) => void): () => void;
-    /** The sidebar's views, kept by the host so every window and device shares them. */
-    views?: SidebarViewsHost;
-    /** The orchestration Main session's id, created when missing; `null` while orchestration is off. */
-    main?(): Promise<string | null>;
-  };
-  /** Returns the transcript store for a session. */
-  transcript(sessionId: string): Transcript;
-  /** Sends a prompt to a session. Absent: the composer cannot send. */
-  send?(input: SendInput): Promise<void>;
-  /** Stops the run in flight in a session. Absent: no stop button. */
-  interrupt?(sessionId: string): void;
-  /**
-   * Runs a `!` shell command in the session's folder, outside any agent run; its run streams into the
-   * transcript. Absent: a `!` prompt goes to the model as text.
-   */
-  shell?(sessionId: string, command: string): Promise<void>;
-  /** Whether a model provider can answer a prompt sent from `cwd`. Absent: a send is never refused for want of one. */
-  providerReady?(cwd?: string): Promise<boolean>;
-  /** Add guidance to the run in flight. Resolves false when nothing was running. */
-  steer?(sessionId: string, message: string): Promise<boolean>;
-  /** Queue a prompt for when the run in flight ends. Resolves false when nothing was running. */
-  followUp?(sessionId: string, message: string): Promise<boolean>;
-  /** Pending questions, plans, and approvals, and the way to answer or dismiss them. */
-  interactions?: {
-    pending(sessionId: string): Readable<readonly ChatInteraction[]>;
-    /** Every session's pending requests, in arrival order (badges per session, the palette). Absent: only per session. */
-    all?(): Readable<readonly ChatInteraction[]>;
-    answer(requestId: string, response: InteractionResponse): Promise<void>;
-    /** Withdraw a request unanswered: the agent moves on without it. Absent: no Dismiss control. */
-    cancel?(requestId: string, reason?: string): Promise<void>;
-  };
-  /** Providers and models for the model picker. Absent: no picker. */
-  models?: Readable<readonly ChatModelProvider[]>;
-  /** A tool call's full output, when the event carries a preview only. */
-  toolOutput?(sessionId: string, callId: string): Promise<string | null>;
-  /** Stop a running tool call (a shell command). */
-  cancelTool?(sessionId: string, callId: string): void;
-  /** The transcript search a session's other windows share. Absent: the search stays in this window. */
-  searchSync?: ChatSearchSync;
-  /** Extension text references (ticket ids, issue links) in prose. Absent: they stay plain text. */
-  references?: ChatReferences;
-  /** What prose chips name on disk. Absent: a chip opens the path as written. */
-  paths?: ChatPaths;
-  /** What chip hover cards show (a commit, a `#chat`, a skill, a command). Absent: chips have no hover card. */
-  chips?: ChatChipDetails;
-  /** The badge menu's extension actions. Absent: the built-in actions only. */
-  badges?: ChatBadgeActions;
-  /** Site icons for link badges. Absent: links show the globe. */
-  siteIcons?: ChatSiteIcons;
-}

package/src/chat/headless/hosts.ts

@@ -1,53 +0,0 @@
-/**
- * The hosts a window runs sessions on: This computer and the servers saved
- * in the desktop app's Settings › Hosts, as its sidebar, session header and
- * new-chat picker read them. React-free.
- */
-import { DEFAULT_CHAT_LABELS, type ChatLabels } from './labels';
-
-/**
- * A host's connection. `local`: This computer, always reachable. The rest
- * mirror the TUI's statuses (`identity`: a different server answers at the
- * saved URL; `version-mismatch`: it speaks another protocol version).
- */
-export type HostStatus =
-  'local' | 'connecting' | 'connected' | 'reconnecting' | 'offline' | 'auth-refused' | 'identity' | 'version-mismatch';
-
-/** One host, as the kit's host parts show it. */
-export interface HostView {
-  /** `'local'` for This computer, else the server's host id. */
-  id: string;
-  /** This computer, or a saved server. */
-  kind: 'local' | 'server';
-  /** The name the sidebar and picker show. */
-  name: string;
-  /** The connection right now. */
-  status: HostStatus;
-  /** The server's URL. */
-  url?: string;
-  /** Why the last connect failed. */
-  error?: string;
-}
-
-/**
- * Whether sessions on a host can be driven: This computer always, a server
- * only while connected. A host no longer saved (`undefined`) is not.
- *
- * @param host - The host, or `undefined` when it is not saved anymore.
- */
-export function hostReachable(host: HostView | undefined): boolean {
-  return host !== undefined && (host.kind === 'local' || host.status === 'connected');
-}
-
-/**
- * One word for a host's status, for dots and labels, as the TUI words it.
- *
- * @param host - The host.
- * @param labels - The label dictionary (default: the kit's English one).
- */
-export function hostStatusLabel(
-  host: HostView,
-  labels: Pick<ChatLabels, 'hostStatuses'> = DEFAULT_CHAT_LABELS,
-): string {
-  return labels.hostStatuses[host.status] ?? labels.hostStatuses.offline;
-}

package/src/chat/headless/index.ts

@@ -1,31 +0,0 @@
-/**
- * `zidane-ui/chat/headless`: the React-free chat model. The `ChatHost` seam
- * and its stores, the session-list model, the transcript pipeline, labels, the
- * session stream store (`createSessionStreams`), and the fixtures
- * (`createFixtureHost`, `DEMO_TRANSCRIPT`) the docs and demos run on.
- */
-export * from './host';
-export * from './transcript-host';
-export * from './composer-modes';
-export * from './chip-settle';
-export * from './badge-refs';
-export * from './file-chip';
-export * from './reference-store';
-export * from './path-resolver';
-export * from './chip-views';
-export * from './site-icons';
-export * from './store';
-export * from './labels';
-export * from './session-list';
-export * from './markdown-chunks';
-export * from './smooth-stream';
-export * from './hosts';
-export * from './transcript';
-export * from './streams';
-export * from './send-flow';
-export * from './draft-target';
-export * from './draft-scope';
-export * from './turn-prompt';
-export type { PromptOrigin } from './prompt-origin';
-export * from './sidebar';
-export * from './composer';

package/src/chat/headless/labels.ts

@@ -1,331 +0,0 @@
-/**
- * The chat layer's strings, on top of the design system's (`labels.tsx`).
- * One flat dictionary so an app overrides any of them with one
- * `<LabelsProvider>`; the headless helpers take it as an argument.
- */
-import { RUN_WAITING_LABEL, runRetryingLabel } from 'zidane/chat/pure';
-
-import { DEFAULT_LABELS } from '../../labels';
-import { TRANSCRIPT_LABELS } from './transcript-labels';
-
-/** The default English strings of the chat layer, merged over the design system's labels. Override any of them through {@link ChatProvider}. */
-export const DEFAULT_CHAT_LABELS = {
-  ...DEFAULT_LABELS,
-  ...TRANSCRIPT_LABELS,
-  // Throbber: the ellipsis cell's title
-  throbberEllipsis: "reserves 3 char widths so the ellipsis cycle doesn't shift adjacent layout",
-  // Session list
-  today: 'Today',
-  yesterday: 'Yesterday',
-  months: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'] as readonly string[],
-  justNow: 'now',
-  chats: 'Chats',
-  favorites: 'Favorites',
-  addFavorite: 'Add to favorites',
-  removeFavorite: 'Remove from favorites',
-  stateRunning: 'Running',
-  stateCompleted: 'Completed',
-  stateError: 'Error',
-  stateIdle: 'Idle',
-  archived: 'Archived',
-  sessionActions: 'Open chat actions',
-  moreActions: 'More actions',
-  archive: 'Archive',
-  unarchive: 'Unarchive',
-  delete: 'Delete',
-  showMore: 'Show more',
-  expandGroup: (label: string) => `Expand ${label}`,
-  collapseGroup: (label: string) => `Collapse ${label}`,
-  newSessionIn: (label: string) => `New session in ${label}`,
-  newSession: 'New session',
-  searchSessions: 'Search sessions',
-  noSessions: 'No sessions yet',
-  noMatches: (query: string) => `No sessions match "${query}"`,
-  sessions: 'Sessions',
-  // Status dot
-  dotIdle: 'Idle',
-  dotRunning: 'Running',
-  dotPending: 'Pending approval',
-  dotCompleted: 'Completed',
-  dotError: 'Errored',
-  dotAttention: 'Awaiting input',
-  dotAttached: 'Attached',
-  // Transcript
-  agent: 'Agent',
-  stepRunning: 'running',
-  stepFailed: 'failed',
-  stepDone: 'done',
-  // Reasoning rows
-  thinkingLive: 'Thinking…',
-  thoughtFor: (seconds: number) => `Thought for ${seconds}s`,
-  thoughts: 'Thoughts',
-  thoughtTimes: (count: number) => `Thought ${count} times`,
-  // Run status, in the live work row's header (the TUI's words: `zidane/chat/pure`)
-  runWaiting: RUN_WAITING_LABEL,
-  runRetrying: (attempt: number, max: number, source?: string) => runRetryingLabel({ attempt, max, source }),
-  // Run receipt
-  runReceipt: 'Run receipt',
-  receiptAgent: 'Agent that ran this turn',
-  receiptAgentSwitched: 'Agent that ran this turn, switched from the previous run',
-  receiptModel: 'Model that ran this turn',
-  receiptModelOthers: (others: number) =>
-    `Model that wrote the last reply. ${others} other model${others === 1 ? '' : 's'} ran earlier turns.`,
-  receiptDuration: 'Run time, tools included',
-  receiptTurns: (turns: number) => `${turns} model call${turns === 1 ? '' : 's'} in this run`,
-  receiptCost: 'Run cost',
-  receiptTokens: (sent: string, received: string) => `${sent} tokens sent, ${received} received`,
-  receiptSpeed: 'Output speed while streaming',
-  // Run failures
-  stopped: 'Stopped',
-  stoppedByYou: 'Stopped by you',
-  retry: 'Retry',
-  retryHint: 'Send your message again',
-  continueRun: 'Continue',
-  continueHint: 'Ask the model to continue',
-  resetsAt: (time: string) => `Resets at ${time}`,
-  // Session events
-  sessionEventLabel: (title: string, verb: string, needsAttention: boolean) =>
-    `${title} ${verb}${needsAttention ? '. Click to answer' : ''}`,
-  clickToAnswer: 'Answer',
-  openSession: 'open →',
-  // Command, spawn and compaction rows
-  commandDetail: 'detail',
-  spawnTask: 'Task',
-  spawnResumes: (childId: string) => `resumes ${childId}`,
-  turnsCompacted: 'turns compacted',
-  // Tool rows
-  stepWaiting: 'waiting',
-  /** A running call of a batch a durable run resumed after a process death (`StreamEvent.resuming`). */
-  stepResuming: 'resuming',
-  waitingForSlot: (max: number) => `Starts when one of the ${max} running agents finishes`,
-  autoDenied: 'auto-denied',
-  modelVerdictTitle: (approved: boolean, model: string, confidence: string | null) =>
-    `${approved ? 'Approved' : 'Blocked'} by the decision model ${model}${confidence ? ` (confidence ${confidence})` : ''}`,
-  loadFullOutput: 'Load full output',
-  loadingFullOutput: 'Loading full output…',
-  showOutput: 'Show output',
-  inputCaption: 'Input',
-  outputCaption: 'Output',
-  openNamedSession: (title: string) => `Open ${title}`,
-  // `!` shell rows
-  stopCommand: 'Stop command',
-  shellCancelled: 'cancelled',
-  shellKilled: 'killed',
-  shellExit: (code: number) => `exit ${code}`,
-  earlierLines: (count: number) => `… (+${count} earlier lines)`,
-  // Folds
-  working: 'Working',
-  foldSteps: (count: number) => `${count} steps`,
-  foldOutcomes: (ok: number, failed: number) => (failed > 0 ? `${ok} succeeded, ${failed} failed` : `${ok} succeeded`),
-  workerModel: 'Model',
-  workerType: 'Type',
-  workerContinues: 'Continues',
-  workerSystemPrompt: 'System prompt',
-  workerSystemReplaced: 'replaced for this worker',
-  showSystemPrompt: 'Show system prompt',
-  earlierMessages: (count: number) => `${count} earlier message${count === 1 ? '' : 's'}`,
-  // The fold's attachments strip
-  toolAttachments: 'Tool attachments',
-  moreAttachments: (count: number) => `+${count}`,
-  showMoreAttachments: (count: number) => `Show ${count} more attachment${count === 1 ? '' : 's'}`,
-  // Prompt echo
-  viewAttachment: (name: string) => `View ${name}`,
-  // Image generation (`generate_image` rows)
-  generatingImage: (model: string | null) => (model ? `Generating with ${model}…` : 'Generating image…'),
-  generatingImages: (count: number, model: string | null) =>
-    model ? `Generating ${count} images with ${model}…` : `Generating ${count} images…`,
-  generatedImage: 'Generated image',
-  openImageFile: (path: string) => `Open ${path}`,
-  // Host transcript
-  transcriptLoading: 'Loading conversation…',
-  earlierHistory: 'Earlier messages',
-  loadingEarlierMessages: 'Loading earlier messages',
-  loadEarlierHistory: 'Load earlier history',
-  loadingEarlierHistory: 'Loading earlier history…',
-  // Composer
-  composerLabel: 'Message',
-  composerPlaceholder: 'Message the agent…',
-  sendMessage: 'Send message',
-  sendHint: 'Send (Enter)',
-  stopRun: 'Stop',
-  stopHint: 'Stop the run (Esc)',
-  steerMessage: 'Steer the run',
-  steerHint: 'Add to the running turn (Enter)',
-  queueMessage: 'Queue message',
-  queueHint: 'Send when the run ends (Enter)',
-  attachFile: 'Attach file',
-  removeAttachment: (name: string) => `Remove ${name}`,
-  attachments: 'Attachments',
-  previewTooLarge: (name: string, size: string) => `${name} (${size}) is too large to preview.`,
-  previewFailed: (name: string) => `Couldn't load ${name}.`,
-  attachmentEmpty: (name: string) => `${name} is empty.`,
-  attachmentTooLarge: (name: string, size: string, limit: string) =>
-    `${name} is too large (${size}). The limit is ${limit}.`,
-  attachmentExportPdf: (name: string) => `${name} can't be attached. Export it as PDF first.`,
-  attachmentUnreadableImage: (name: string) => `${name} can't be read here. Export it as PNG or JPEG.`,
-  attachmentUnsupported: (name: string) => `${name} can't be attached. Only images, PDFs and text files can.`,
-  attachmentReadFailed: (name: string) => `${name} could not be read.`,
-  attachmentTitle: (name: string, detail: string) => `${name} (${detail})`,
-  attachmentNotices: 'Files not attached',
-  mentionSuggestions: 'Mentions',
-  commandSuggestions: 'Commands',
-  noSuggestions: 'No matches',
-  composerBadges: 'Composer badges',
-  // Agent, model and model options pickers (the desktop app's wording)
-  switchAgent: 'Switch agent',
-  defaultAgent: 'Default agent',
-  agentProfiles: 'Agent profiles',
-  switchingAgent: 'switching…',
-  agentDraftNote: 'Applies to your next chat.',
-  switchModel: 'Switch model',
-  chooseModel: 'Choose model',
-  // The model pill's tooltip: the chain, then how to change it
-  modelChain: 'Model chain',
-  modelForNextChat: 'For your next chat',
-  modelServing: (picked: string, serving: string) =>
-    `${picked} failed this run, so ${serving} took over. The next run tries ${picked} again.`,
-  modelServingFallback: 'The picked model',
-  modelChainNoModel: 'No model picked yet',
-  searchModels: 'Search models',
-  searchModelsPlaceholder: 'Search models…',
-  modelsShowLegacy: 'Show legacy models',
-  modelsShowLegacyHint: 'Show legacy models (⌥L)',
-  modelsLegacy: 'Legacy',
-  modelsJumpToProvider: 'Jump to provider',
-  modelsJumpHint: (provider: string, digit: number | null) => (digit ? `${provider} (⌘${digit})` : provider),
-  modelsLoading: 'Loading…',
-  modelsLoadFailed: (error: string) => `Failed to load models: ${error}`,
-  modelsNoProviders: 'No provider is signed in. Sign in under Settings → Authentication.',
-  modelsNoMatch: (query: string) => `No model matches "${query}".`,
-  modelsTypeAnId: 'Type any model id to use it. Put a provider first to pick one, for example "xai grok-9".',
-  modelsInUse: 'In use',
-  modelsChatTab: 'Chat',
-  modelsImageTab: 'Image',
-  modelKinds: 'Model kind',
-  imageModelsPill: 'Image model',
-  imageModelsNone:
-    'No connected provider generates images. Connect OpenRouter, Google Gemini, xAI, or OpenAI with a platform API key.',
-  imageModelReferences: 'reference images',
-  imageModelReferencesHint: 'Edits or matches reference images',
-  imageModelTransparency: 'transparency',
-  imageModelTransparencyHint: 'Can make a transparent background',
-  modelsCustomId: 'Custom id',
-  modelsShownOf: (shown: number, total: number) => `${shown} of ${total}`,
-  modelsLegacyHidden: (count: number) => `${count} legacy hidden`,
-  modelsSelected: (count: number) => `${count} selected`,
-  pickModel: 'pick',
-  modelPrimary: 'primary',
-  modelFallback: 'fallback',
-  modelFallbackHint: 'Tab or shift+click adds or removes a fallback',
-  modelChainOrderHint: 'Fallbacks run in this order. ctrl+shift+↑↓ moves the highlighted row.',
-  modelPrimaryHint: 'Primary model',
-  modelFallbackPosition: (n: number) => `Fallback #${n}`,
-  modelRemovePrimary: 'Remove primary model',
-  modelRemoveFallback: (n: number) => `Remove fallback #${n}`,
-  modelRemoveFromChain: 'Remove from chain',
-  modelAccountBlocked: (provider: string) =>
-    `Another ${provider} account is in use. Picking this one switches the chain to it.`,
-  modelLegacy: 'legacy',
-  modelLegacyHint: 'Newer models exist in this family',
-  modelUnavailable: 'unavailable',
-  modelNotInCatalog: 'not in catalog',
-  modelNotInCatalogHint: 'Used as typed. No details are known for this id.',
-  modelVia: 'via',
-  modelViaHint: (modelId: string, provider: string) => `${modelId} via ${provider}`,
-  modelInUse: 'in use',
-  modelReasoning: 'reasoning',
-  modelReasoningHint: 'Can think before answering',
-  contextWindow: 'Context window',
-  modelOptions: 'Model options',
-  setModelOptions: 'Set model options',
-  modelOptionsHint: 'Reasoning effort and model options',
-  modelOptionsEmpty: 'Options',
-  modelFeatures: 'Features',
-  reasoningEffort: 'Reasoning effort',
-  effortLevel: (level: string) => level,
-  // Interactions (exact desktop wording: the inbox cards render through these)
-  interactionPlan: 'Plan',
-  interactionQuestion: 'Question',
-  questionCount: (count: number) => `${count} questions`,
-  interactionsLabel: 'Requests from the agent',
-  inboxEmpty: 'Nothing waiting on you',
-  inboxPreviousSession: 'previous session',
-  unsupportedInteraction: (tool: string) => `The agent is waiting on ${tool}, which this view cannot answer.`,
-  planRejectNote: 'Rejecting stops the run. Add a note so the agent knows why.',
-  planReviseNote: 'Say what should change. The agent sends back a revised plan.',
-  planRejectPlaceholder: 'Why you reject this plan (optional)',
-  planRevisePlaceholder: 'What should change (optional)',
-  back: 'Back',
-  planRejectAndStop: 'Reject and stop',
-  planSendRevision: 'Send revision',
-  planReject: 'Reject…',
-  planRevise: 'Revise…',
-  planApprove: 'Approve',
-  additionalInstructions: 'Additional instructions',
-  additionalInstructionsHint: 'optional, refines or overrides the answers',
-  additionalInstructionsPlaceholder: 'e.g. keep the old endpoint alive until the migration lands',
-  dismiss: 'Dismiss',
-  dismissHint: 'Continue without answering',
-  sendAnswers: (count: number) => `Send answer${count === 1 ? '' : 's'}`,
-  requiredHint: 'Required',
-  requiredMark: 'required',
-  pickOneOrMore: 'Pick one or more.',
-  noAnswer: 'No answer',
-  confirmYes: 'yes',
-  confirmNo: 'no',
-  // Session filter menu (the desktop app's sidebar faders menu)
-  filterSessions: 'Filter sessions',
-  filterView: 'View',
-  filterStatus: 'Status',
-  filterProject: 'Project',
-  filterActivity: 'Last activity',
-  filterSort: 'Sort by',
-  filterViews: { project: 'Per directory', host: 'Per host', none: 'All projects', date: 'By date', state: 'By state' },
-  filterStatuses: { active: 'Active', archived: 'Archived', all: 'All' },
-  filterActivities: { '1d': '1d', '3d': '3d', '7d': '7d', '30d': '30d', all: 'All' },
-  filterSorts: { recency: 'Recency', createdTime: 'Created time', alphabetical: 'Alphabetically' },
-  filterAllProjects: 'All',
-  filterAllProjectsOption: 'All projects',
-  filterNoProjects: 'No projects yet',
-  // Hosts: the sidebar's host headers, status dots and the new-chat host picker (the desktop app's wording)
-  hostStatuses: {
-    local: 'connected',
-    connected: 'connected',
-    connecting: 'connecting',
-    reconnecting: 'reconnecting',
-    offline: 'offline',
-    'auth-refused': 'token refused',
-    identity: 'different server',
-    'version-mismatch': 'version mismatch',
-  },
-  hostStatusError: (status: string, error: string) => `${status}: ${error}`,
-  hostBadgeTitle: (host: string, status: string) => `${host}: ${status}`,
-  hostOpenSettings: (host: string) => `Open ${host}'s settings`,
-  hostExpand: (name: string) => `Expand ${name}`,
-  hostCollapse: (name: string) => `Collapse ${name}`,
-  hostPicker: 'Choose the host for this chat',
-  hostRunsOn: (name: string) => `Runs on: ${name}`,
-  hostRunsOnSection: 'Runs on',
-  hostThisMachine: 'This machine',
-  // Context orb and breakdown (the desktop app's composer)
-  contextSummary: (used: string, window: string, pct: number) => `Context: ${used} / ${window} (${pct}%)`,
-  contextSummaryCost: (summary: string, cost: string) => `${summary}, ${cost} this session`,
-  contextDetail: 'Context window detail',
-  contextAutoCompact: (pct: number) => `Auto-compact at ${pct}%`,
-  contextSessionCost: 'Session cost',
-  contextRunCount: (runs: number) => `${runs} run${runs === 1 ? '' : 's'}`,
-  contextNoBreakdown: 'The breakdown shows after the first run.',
-  contextDeferred: 'Deferred',
-  contextActiveSkills: 'Active skills',
-  contextLastTurn: 'Last turn',
-  contextCacheRead: 'Cached (read)',
-  contextCacheWrite: 'Cache write',
-  contextFreshInput: 'Fresh input',
-  contextOutput: 'Output',
-  contextEstimated: '~ Estimated. This provider does not report exact counts.',
-  contextClickToCopy: (hasDescription: boolean) => `click to copy ${hasDescription ? 'description' : 'name'}`,
-  contextCopied: 'Copied',
-};
-
-/** The shape of the chat label dictionary: every key of {@link DEFAULT_CHAT_LABELS}. Some values are functions that build a string. */
-export type ChatLabels = typeof DEFAULT_CHAT_LABELS;