zidane-ui 9.0.4 → 9.1.3

package/src/settings/SettingsTutorial.tsx

@@ -1,55 +0,0 @@
-/**
- * The tutorial at the top of a settings page: the onboarding area's
- * `Tutorial` (a scene that plays how that part of zidane works, beside its
- * three steps). A page passes its own buttons; Hosts adds the command that
- * starts zidane-server, with a copy button. On a server's settings
- * (`SettingsProvider hostName`) its steps name that server.
- */
-import type { ReactNode } from 'react';
-import type { TutorialTopic } from 'zidane/chat/pure';
-
-import { CopyButton } from '../components/CopyButton';
-import { Tutorial } from '../onboarding/tutorials';
-import { useSettingsHostName, useSettingsLabels } from './SettingsProvider';
-
-/** Props for {@link SettingsTutorial}. */
-export interface SettingsTutorialProps {
-  /** What the page is about. */
-  topic: TutorialTopic;
-  /** Buttons that need the page's state. They come after the page's own action. */
-  actions?: ReactNode;
-  /** Extra classes on the block. */
-  className?: string;
-}
-
-/**
- * Renders the tutorial of a settings page.
- *
- * @param props - Component props.
- */
-export function SettingsTutorial({ topic, actions, className = '' }: SettingsTutorialProps) {
-  const l = useSettingsLabels();
-  const host = useSettingsHostName();
-  const own =
-    topic === 'hosts' ? (
-      <span className="zg-well inline-flex items-center gap-1 h-7 pl-2.5 pr-1 rounded-zg-md">
-        <code className="font-mono text-zg-label text-[var(--zg-text)]">{l.settingsServerStart}</code>
-        <CopyButton text={l.settingsServerStart} label={l.settingsCopyCommand} />
-      </span>
-    ) : null;
-  return (
-    <Tutorial
-      topic={topic}
-      {...(host !== undefined ? { host } : {})}
-      actions={
-        own || actions ? (
-          <>
-            {own}
-            {actions}
-          </>
-        ) : undefined
-      }
-      className={className}
-    />
-  );
-}

package/src/settings/headless/catalog.ts

@@ -1,553 +0,0 @@
-/**
- * The settings catalog the settings rows draw: every toggle and choice with
- * its copy, in display order (the TUI's `SettingsModal` order), gated
- * (`requires`, `killSwitchEnv`) as the canonical `SETTINGS_TOGGLES` says.
- * The defaults are the canonical object from `zidane/chat/pure`.
- */
-import type { Settings, ToolCallDisplay, TranscriptDensity } from 'zidane/chat';
-
-import { APPROVAL_MODE_OPTIONS, DURABILITY_OPTIONS, SETTINGS_TOGGLES as CANONICAL_TOGGLES } from 'zidane/chat/pure';
-
-export { DEFAULT_SETTINGS } from 'zidane/chat/pure';
-
-/** The settings whose value is a boolean: what a toggle row may name. */
-export type BooleanSettingKey = {
-  [K in keyof Settings]-?: Settings[K] extends boolean ? K : never;
-}[keyof Settings];
-
-/** A toggle row of the catalog. */
-export interface SettingsToggle {
-  /** The setting it flips. */
-  key: BooleanSettingKey;
-  /** The row's label. */
-  label: string;
-  /** The row's description. */
-  description: string;
-  /** The description on a server's settings, where `description` would name this computer. `{host}`: the server's name. */
-  serverDescription?: string;
-  /** Another boolean setting this one needs; the row is greyed while it is off. From canonical, plus {@link GUI_GREYED_BY}. */
-  requires?: BooleanSettingKey;
-  /** The feature gate's kill-switch env var; the row is inert while it is engaged. From canonical. */
-  killSwitchEnv?: string;
-}
-
-/**
- * GUI-only `requires`: these rows only grey out while the browser is off.
- * Canonical leaves them out on purpose, since a canonical `requires` makes
- * `enforceSettingsInvariants` force the setting off for good.
- */
-const GUI_GREYED_BY: Partial<Record<BooleanSettingKey, BooleanSettingKey>> = {
-  browserAgent: 'browser',
-  browserAutoShow: 'browser',
-};
-
-/** The GUI's copy and order, gated (`requires`, `killSwitchEnv`) exactly as canonical `SETTINGS_TOGGLES` says. */
-function withCanonicalGates(rows: readonly Omit<SettingsToggle, 'requires' | 'killSwitchEnv'>[]): SettingsToggle[] {
-  const canonical = new Map(CANONICAL_TOGGLES.map((row) => [row.key, row]));
-  return rows.map((row) => {
-    const requires = GUI_GREYED_BY[row.key] ?? canonical.get(row.key)?.requires;
-    const killSwitchEnv = canonical.get(row.key)?.killSwitchEnv;
-    return { ...row, ...(requires ? { requires } : {}), ...(killSwitchEnv ? { killSwitchEnv } : {}) };
-  });
-}
-
-/** The catalog's toggles, in display order. */
-export const SETTINGS_TOGGLES: readonly SettingsToggle[] = withCanonicalGates([
-  {
-    key: 'checkForUpdates',
-    label: 'Check for updates',
-    description: 'Look for new releases and show them in the footer.',
-  },
-  {
-    key: 'autoInstallUpdates',
-    label: 'Install updates automatically',
-    description: 'Install new releases in the background. Restart when you are ready.',
-  },
-  {
-    key: 'useDaemon',
-    label: 'Shared daemon runtime',
-    description: 'Runs keep going when windows close and show in every window.',
-  },
-  {
-    key: 'remoteHosts',
-    label: 'Remote hosts',
-    description: 'Run sessions on other machines through zidane-server.',
-  },
-  {
-    key: 'orchestration',
-    label: 'Main session',
-    description: 'Pin a session that starts, steers and reads your other sessions.',
-  },
-  {
-    key: 'loadProjectExtensions',
-    label: 'Load project extensions',
-    /*
-     * The "any code on your computer" clause is NOT optional copy: this is a
-     * consent toggle, and a label that asks for the consent without stating
-     * what is being consented to is not acceptable. Keep it in step
-     * with canonical `settings-catalog.ts`; `parity.test.ts` enforces that the
-     * warning survives future rewording.
-     */
-    description: 'Run the extensions of this project. They can run any code on your computer.',
-    serverDescription: 'Run the extensions of this project. They can run any code on {host}.',
-  },
-  {
-    key: 'resumeLastSession',
-    label: 'Start from last session',
-    description: 'Open the last session on launch instead of the sessions list.',
-  },
-  {
-    key: 'hideSubagentOutput',
-    label: 'Collapse subagents',
-    description: 'Start subagent blocks collapsed.',
-  },
-  {
-    key: 'persistToolResults',
-    label: 'Persist large tool results',
-    description: 'Save tool outputs over 8 KB to disk and keep a preview in the chat.',
-  },
-  {
-    key: 'stableToolList',
-    label: 'Stable tool list (call_tool)',
-    description:
-      'Use found MCP tools through call_tool so the prompt cache stays valid. Off adds them to the tool list instead.',
-  },
-  {
-    key: 'freezeSessionPrompt',
-    label: 'Freeze session prompt',
-    description:
-      "Keep each session's system prompt as its first run saw it and tell the model about later changes. /refresh re-reads it.",
-  },
-  {
-    key: 'compactBeforeCacheExpiry',
-    label: 'Compact before the cache expires',
-    description:
-      'Experimental. When a long session sits idle, compact it a minute before its prompt cache runs out, so your next message reads a short summary instead of re-reading the whole conversation.',
-  },
-  {
-    key: 'compactToolCatalog',
-    label: 'Short MCP tool list',
-    description:
-      'Experimental. List MCP tools by name only in the prompt; the model looks up a tool before using it. Saves tokens when many tools are connected.',
-  },
-  {
-    key: 'codemode',
-    label: 'Codemode',
-    description: 'The model batches tool calls in one short script that runs in a sandbox.',
-  },
-  {
-    key: 'codemodeShowCalls',
-    label: 'Show codemode tool calls',
-    description: 'List the calls each script makes under its row. Calls that start a subagent always show.',
-  },
-  {
-    key: 'decisions',
-    label: 'Decisions',
-    description:
-      'Hooks and extensions ask a decision model for quick yes/no, choice and score answers. Your provider bills each call.',
-  },
-  {
-    key: 'autoTitle',
-    label: 'Auto-update session titles',
-    description: 'Title sessions after their first run and rename them when the topic changes. Keeps titles you typed.',
-  },
-  {
-    key: 'subagentModels',
-    label: 'Allow subagents to use different models',
-    description: 'Let the agent hand work to cheaper models.',
-  },
-  {
-    key: 'imageGeneration',
-    label: 'Image generation',
-    description:
-      "Let the agent generate images with your providers' image models. Pick the model in the model picker's Image tab. Each image is billed by the provider.",
-  },
-  {
-    key: 'webSearch',
-    label: 'Web search',
-    description: 'Let the agent search the web for docs, errors and recent changes.',
-  },
-  {
-    key: 'sandbox',
-    label: 'Sandbox shell commands',
-    description: "Keep the agent's commands and edits inside the project and hide credentials.",
-  },
-  {
-    key: 'autoCompact',
-    label: 'Auto-compact',
-    description: 'Summarize the conversation when the context passes the threshold below.',
-  },
-  { key: 'showRowIcons', label: 'Row icons', description: 'Show an icon next to each message and step.' },
-  { key: 'showThinking', label: 'Thinking blocks', description: "Show the agent's reasoning in the chat." },
-  {
-    key: 'thinkingAutoExpand',
-    label: 'Expand thinking while it streams',
-    description: 'Keep a thinking block open while the agent reasons.',
-  },
-  { key: 'showToolResults', label: 'Tool outputs', description: 'Show the output under each tool call.' },
-  {
-    key: 'groupToolCalls',
-    label: 'Group tool calls',
-    description: "Fold each exchange's tool calls into one row.",
-  },
-  { key: 'showEditDiffs', label: 'Edit diffs', description: 'Show file edits as diffs.' },
-  {
-    key: 'showToolAttachments',
-    label: 'Tool attachments',
-    description: 'Gather the images tool calls return under the Working block.',
-  },
-  { key: 'smoothStreaming', label: 'Smooth streaming', description: 'Reveal replies at a steady pace as they stream.' },
-  {
-    key: 'showFullShellOutput',
-    label: 'Full shell output',
-    description: 'Show every line of ! command output, not only the last 10.',
-  },
-  {
-    key: 'showRunReceipt',
-    label: 'Run receipt',
-    description: 'Show agent, model, time, cost and tokens after each run.',
-  },
-  {
-    key: 'showCacheNotices',
-    label: 'Cache notices',
-    description:
-      'Add a row to the chat when the prompt cache expires or resets, or the provider drops earlier reasoning.',
-  },
-  {
-    key: 'queueMessages',
-    label: 'Queue messages',
-    description: 'Hold messages sent during a run until it ends. When off, they go into the running turn.',
-  },
-  {
-    key: 'attachmentsEnabled',
-    label: 'Paste attachments',
-    description: 'Turn dropped images and long pastes into attachments.',
-  },
-  {
-    key: 'inlineAutocomplete',
-    label: 'Inline autocomplete',
-    description: 'Suggest the rest of a path as you type. Tab accepts.',
-  },
-  {
-    key: 'promptSuggestions',
-    label: 'Suggest the next prompt',
-    description: 'After a run, suggest a next message in the empty composer. Uses the text model.',
-  },
-  {
-    key: 'resumeOnMaxTokens',
-    label: 'Auto-resume on output limit',
-    description: "Keep going when an answer hits the model's output limit.",
-  },
-  {
-    key: 'importForeignConfigs',
-    label: 'Import configurations from other agents',
-    description:
-      "Use other agents' servers, skills, commands and subagents. Imported servers run commands from files zidane does not own.",
-  },
-  {
-    key: 'importRulerConfigs',
-    label: 'Support Ruler configuration (.ruler)',
-    description: 'Read .ruler folders. Their servers need "Import configurations from other agents".',
-  },
-  { key: 'showThrobber', label: 'Throbber', description: 'Animate an indicator while the agent works.' },
-  {
-    key: 'artifacts',
-    label: 'Artifacts',
-    description: "Track each session's pull requests, branches, commits and files.",
-  },
-  {
-    key: 'preserveScroll',
-    label: 'Keep scroll position',
-    description: 'Reopen each conversation where you left it.',
-  },
-  {
-    key: 'browser',
-    label: 'Browser tab',
-    description: 'Show a browser in the side panel to preview your app.',
-  },
-  {
-    key: 'browserAgent',
-    label: 'Agent can use the browser',
-    description: 'Let the agent open, read, click and type in pages to check its work.',
-  },
-  {
-    key: 'browserAutoShow',
-    label: 'Show the browser when the agent uses it',
-    description: 'Open the Browser tab when the agent starts using it.',
-  },
-  {
-    key: 'terminal',
-    label: 'Terminals',
-    description: 'Show terminals next to the chat. They run where the session runs.',
-  },
-  {
-    key: 'terminalAgent',
-    label: 'Agent can use your terminals',
-    description: 'Let the agent read your terminals and type in them after you approve.',
-  },
-  {
-    key: 'terminalAgentTasks',
-    label: "Agent's background tasks in terminals",
-    description: 'Give each background command the agent starts its own terminal tab.',
-  },
-  {
-    key: 'closeTerminalOnCleanExit',
-    label: 'Close terminals that exit cleanly',
-    description: 'Close a terminal once its shell exits cleanly. Failed ones stay open.',
-  },
-  {
-    key: 'confirmGitSync',
-    label: 'Ask before syncing',
-    description: 'Confirm before the git bar pulls, pushes or publishes your branch.',
-  },
-  {
-    key: 'sidebarRunDetails',
-    label: 'Run details in the sidebar',
-    description: "Show each run's activity, time, commits and pull requests in the sidebar.",
-  },
-  {
-    key: 'notifications',
-    label: 'Notifications',
-    description: 'If no Zidane window is focused, notify you when a run ends or needs you.',
-  },
-  {
-    key: 'notificationSound',
-    label: 'Notification sound',
-    description: 'Play the system sound with each notification.',
-  },
-  {
-    key: 'showTodoIndicator',
-    label: 'Todos badge',
-    description: "Show the agent's todo progress as a badge in the composer.",
-  },
-  {
-    key: 'subscriptionUsage',
-    label: 'Check usage',
-    description: 'Fetch plan limits and credits from signed-in providers and GitHub.',
-  },
-  {
-    key: 'showUsageIndicator',
-    label: 'Usage indicator',
-    description: 'Show the plan usage gauge in the footer.',
-  },
-]);
-
-/** A choice row of the catalog: a setting with a few values, cycled. */
-export interface SettingsChoice<K extends keyof Settings = keyof Settings> {
-  /** The setting it sets. */
-  key: K;
-  /** The row's label. */
-  label: string;
-  /** The row's description. */
-  description: string;
-  /** The values in cycle order, each with its label. */
-  options: readonly { value: Settings[K]; label: string }[];
-}
-
-/**
- * The option after `current` in a choice's cycle (the first one after the last, or for an unknown value).
- *
- * @param row - The choice.
- * @param current - The setting's value now.
- * @returns The next value.
- */
-export function nextOption(row: SettingsChoice, current: unknown): Settings[typeof row.key] {
-  const idx = row.options.findIndex((opt) => opt.value === current);
-  return row.options[(idx + 1) % row.options.length]!.value;
-}
-
-/** The catalog's choices, in display order. */
-export const SETTINGS_CHOICES: readonly SettingsChoice[] = [
-  {
-    key: 'approvalMode',
-    label: 'Tool approvals',
-    description: 'Who approves tool calls: you, the decision model, or nobody. Commands you safelisted always run.',
-    options: APPROVAL_MODE_OPTIONS,
-  },
-  {
-    key: 'interactionMode',
-    label: 'Interaction mode',
-    description: 'How the agent handles questions: ask you, answer from the repository, or turn questions off.',
-    options: [
-      { value: 'ask', label: 'Ask normally' },
-      { value: 'skip', label: 'Skip interactions' },
-      { value: 'disabled', label: 'Disable tools' },
-    ],
-  },
-  {
-    key: 'durability',
-    label: 'Crash recovery',
-    description:
-      'Keep a checkpoint of each run so it can continue after a crash. Applies to new runs. Unavailable on stores other than SQLite.',
-    options: DURABILITY_OPTIONS,
-  },
-  {
-    key: 'sandboxNetwork',
-    label: 'Sandbox network',
-    description: 'Allow keeps installs and git working. Deny blocks every connection.',
-    options: [
-      { value: 'allow', label: 'Allow' },
-      { value: 'deny', label: 'Deny' },
-    ],
-  },
-  {
-    key: 'transcriptDensity',
-    label: 'Transcript density',
-    description: "Full shows every step. Compact folds each exchange's work into one row.",
-    options: [
-      { value: 'full' as TranscriptDensity, label: 'Full' },
-      { value: 'compact' as TranscriptDensity, label: 'Compact' },
-    ],
-  },
-  {
-    key: 'toolCallDisplay',
-    label: 'Tool calls display',
-    description: 'Show tool calls as a summary, their full input, or not at all.',
-    options: [
-      { value: 'formatted' as ToolCallDisplay, label: 'Formatted' },
-      { value: 'full' as ToolCallDisplay, label: 'Full' },
-      { value: 'hidden' as ToolCallDisplay, label: 'Hidden' },
-    ],
-  },
-  {
-    key: 'autoCompactThreshold',
-    label: 'Auto-compact threshold',
-    description: 'How full the context gets before zidane summarizes it.',
-    options: [
-      { value: 0.6, label: '60%' },
-      { value: 0.7, label: '70%' },
-      { value: 0.8, label: '80%' },
-      { value: 0.9, label: '90%' },
-    ],
-  },
-  {
-    key: 'userInstructionsScope',
-    label: 'User instructions',
-    description: 'Which AGENTS.md and CLAUDE.md files the agent reads.',
-    options: [
-      { value: 'both', label: 'Both' },
-      { value: 'user', label: 'User only' },
-      { value: 'project', label: 'Project only' },
-      { value: 'none', label: 'None' },
-    ],
-  },
-  {
-    key: 'maxOutputTokens',
-    label: 'Max output tokens',
-    description: 'The most the model may write per turn.',
-    options: [
-      { value: 0, label: 'Model max' },
-      { value: 8192, label: '8K' },
-      { value: 16384, label: '16K' },
-      { value: 32000, label: '32K' },
-      { value: 64000, label: '64K' },
-    ],
-  },
-  {
-    key: 'retryMaxAttempts',
-    label: 'Provider retry attempts',
-    description: 'How many times to retry a failed or stalled provider call.',
-    options: [
-      { value: 0, label: 'Default (3)' },
-      { value: 1, label: '1 (no retry)' },
-      { value: 2, label: '2' },
-      { value: 3, label: '3' },
-      { value: 5, label: '5' },
-      { value: 8, label: '8' },
-    ],
-  },
-  {
-    key: 'maxTurns',
-    label: 'Max turns per run',
-    description: 'Stop a run after this many turns.',
-    options: [
-      { value: 0, label: 'Unlimited' },
-      { value: 25, label: '25' },
-      { value: 50, label: '50' },
-      { value: 100, label: '100' },
-      { value: 200, label: '200' },
-    ],
-  },
-  {
-    key: 'maxCostUsd',
-    label: 'Max cost per run',
-    description: 'Stop a run once its estimated cost passes this amount.',
-    options: [
-      { value: 0, label: 'Unlimited' },
-      { value: 1, label: '$1' },
-      { value: 5, label: '$5' },
-      { value: 10, label: '$10' },
-      { value: 25, label: '$25' },
-    ],
-  },
-  {
-    key: 'maxTotalTokens',
-    label: 'Max tokens per run',
-    description: 'Stop a run once it has used this many tokens.',
-    options: [
-      { value: 0, label: 'Unlimited' },
-      { value: 500_000, label: '500K' },
-      { value: 1_000_000, label: '1M' },
-      { value: 2_000_000, label: '2M' },
-      { value: 5_000_000, label: '5M' },
-    ],
-  },
-  {
-    key: 'maxWallMinutes',
-    label: 'Max run time',
-    description: 'Stop a run after this much time.',
-    options: [
-      { value: 0, label: 'Unlimited' },
-      { value: 5, label: '5 min' },
-      { value: 15, label: '15 min' },
-      { value: 30, label: '30 min' },
-      { value: 60, label: '60 min' },
-    ],
-  },
-  {
-    key: 'maxParallelSubagents',
-    label: 'Max parallel subagents',
-    description: 'How many subagents a session runs at once. More wait for a free slot.',
-    options: [
-      { value: 1, label: '1' },
-      { value: 2, label: '2' },
-      { value: 3, label: '3' },
-      { value: 5, label: '5' },
-      { value: 10, label: '10' },
-      { value: 0, label: 'Unlimited' },
-    ],
-  },
-  {
-    key: 'thinkingBinding',
-    label: 'Preserved thinking (Anthropic only)',
-    description: 'What to do with reasoning that no longer matches the conversation.',
-    options: [
-      { value: 'drop_block', label: 'Drop silently' },
-      { value: 'error', label: 'Fail the run' },
-      { value: 'off', label: 'Account default' },
-    ],
-  },
-  {
-    key: 'openIn',
-    label: 'Open files and diffs in',
-    description: 'Where clicked files and diffs open: your editor or the side panels.',
-    options: [
-      { value: 'editor', label: '$EDITOR' },
-      { value: 'panel', label: 'Panels' },
-    ],
-  },
-  {
-    key: 'theme',
-    label: 'Theme',
-    description: 'Colors for the interface, markdown and code.',
-    options: [
-      { value: 'default', label: 'Default' },
-      { value: 'catppuccin-mocha', label: 'Catppuccin Mocha' },
-      { value: 'catppuccin-macchiato', label: 'Catppuccin Macchiato' },
-      { value: 'catppuccin-frappe', label: 'Catppuccin Frappé' },
-      { value: 'catppuccin-latte', label: 'Catppuccin Latte' },
-      { value: 'crush', label: 'Crush' },
-      { value: 'vaporwave', label: 'Vaporwave' },
-    ],
-  },
-];

package/src/settings/headless/claude-import.ts

@@ -1,61 +0,0 @@
-/**
- * The `SettingsHost.claudeImport` group: importing a Claude Code setup
- * (`~/.claude` on the host's machine: conversations, MCP servers, skills,
- * commands and subagents) into zidane's own places. React-free.
- */
-
-/** What the host found in `~/.claude`. */
-export interface SettingsClaudeImportDetect {
-  /** There is a Claude Code setup to import. */
-  available: boolean;
-  /** The transcripts found: for the folder, and in every project. */
-  counts: { project: number; all: number };
-}
-
-/** What to import. */
-export interface SettingsClaudeImportSelection {
-  /** Conversations. */
-  sessions: boolean;
-  /** MCP servers. */
-  mcps: boolean;
-  /** Skills. */
-  skills: boolean;
-  /** Commands and subagents. */
-  commands: boolean;
-  /** Conversations of every project, not just the folder's. */
-  allProjects: boolean;
-}
-
-/** What a copy did: by name. */
-export interface SettingsClaudeImportCopy {
-  /** Copied. */
-  copied: string[];
-  /** Skipped: zidane already has one with the same name. */
-  skipped: string[];
-  /** Failed, with why. */
-  failed: { name: string; error: string }[];
-}
-
-/** What an import did. */
-export interface SettingsClaudeImportSummary {
-  /** The conversations. */
-  sessions?: { imported: number; skipped: number; empty: number; failed: { path: string; error: string }[] };
-  /** The MCP servers. */
-  mcps?: SettingsClaudeImportCopy;
-  /** The skills. */
-  skills?: SettingsClaudeImportCopy;
-  /** The commands. */
-  commands?: SettingsClaudeImportCopy;
-  /** The subagents. */
-  agents?: SettingsClaudeImportCopy;
-  /** What is deliberately not imported, and why. */
-  notes: string[];
-}
-
-/** Importing a Claude Code setup on the host. */
-export interface SettingsClaudeImportHost {
-  /** What `~/.claude` holds, counted for `cwd` (`''`: no folder). */
-  detect(cwd: string): Promise<SettingsClaudeImportDetect>;
-  /** Imports the selection. Idempotent: what a previous run brought over is skipped. */
-  run(cwd: string, selection: SettingsClaudeImportSelection): Promise<SettingsClaudeImportSummary>;
-}