zidane-ui 9.0.4 → 9.1.3

package/src/settings/headless/mcp.ts

@@ -1,319 +0,0 @@
-/**
- * The `SettingsHost` member group of Settings › MCP servers (the servers of
- * a folder, their sign-ins, tests, tools and running processes), and the pure
- * rules the section applies to the settings document: which servers and tools
- * are on, which share one process, the badge a server shows, what an add or a
- * removal writes. React-free.
- */
-import type { Settings } from 'zidane/chat';
-import { enabledMcpsWith, type McpFormResult } from 'zidane/chat/pure';
-import type { HostCatalogMcp } from 'zidane/ipc';
-
-import type { SignInFlow } from '../../onboarding/headless/host';
-import type { SettingsResource } from './sections-host';
-
-/** A tool an MCP server lists. */
-export interface SettingsMcpTool {
-  /** Its name. */
-  name: string;
-  /** What it does. */
-  description?: string;
-}
-
-/**
- * How a server answered its last test: `ok` connected and listed its tools;
- * `needs-auth` refused with no key of its own (a sign-in fixes it);
- * `token-rejected` refused the key it sends; `error` anything else.
- */
-export interface SettingsMcpTest {
-  /** How it answered. */
-  kind: 'ok' | 'needs-auth' | 'token-rejected' | 'error';
-  /** When, epoch ms. */
-  at: number;
-  /** How many tools it listed (`ok`). */
-  tools?: number;
-  /** What to tell the user (not `ok`). */
-  message?: string;
-}
-
-/** Where an MCP server's sign-in is. */
-export type SettingsMcpAuthState = 'idle' | 'needs-auth' | 'authorizing' | 'authed' | 'error';
-
-/** An MCP server a folder's agents can use. Secret values never come back. */
-export interface SettingsMcpServer {
-  /** Its name (the `enabledMcps` key). */
-  name: string;
-  /** How it is reached. */
-  transport: 'stdio' | 'http';
-  /** The command line of a `stdio` server. */
-  command?: string;
-  /** The address of an `http` server. */
-  url?: string;
-  /** Its sign-in state. */
-  authState: SettingsMcpAuthState;
-  /** Why its last sign-in or connection failed. */
-  lastError?: string;
-  /** The tools it listed. */
-  tools?: readonly SettingsMcpTool[];
-  /** When the tools were listed, epoch ms. */
-  toolsUpdatedAt?: number;
-  /** Why listing its tools failed. */
-  toolError?: string;
-  /** The last test, when one ran. */
-  test?: SettingsMcpTest;
-  /** The config file that declares it. */
-  path?: string;
-  /** `remove` may edit that file. */
-  removable?: boolean;
-  /** Its config's `shared` (absent: `true`). The `mcpSharing` setting wins over it. */
-  shared?: boolean;
-  /**
-   * Where a `stdio` server runs: `host` (shareable), or `context`, started in each session's execution
-   * context and never shared. Absent: the host doesn't say, so no Shared switch.
-   */
-  scope?: 'host' | 'context';
-}
-
-/**
- * A server of a host's catalog (a zidane-server's `catalog.mcps`) as MCP servers lists it: its sign-in
- * state, tools and last test from `status` (an older host sends none: idle, untested). Removable when it
- * is the host user's (`mcp.remove` edits that file only).
- *
- * @param entry - The catalog entry.
- */
-export function settingsMcpServerOf(entry: HostCatalogMcp): SettingsMcpServer {
-  return {
-    name: entry.name,
-    transport: entry.transport === 'stdio' ? 'stdio' : 'http',
-    ...(entry.command ? { command: [entry.command, ...(entry.args ?? [])].join(' ') } : {}),
-    ...(entry.url ? { url: entry.url } : {}),
-    authState: 'idle',
-    ...entry.status,
-    path: entry.path,
-    removable: entry.source === 'user',
-    ...(entry.shared !== undefined ? { shared: entry.shared } : {}),
-    ...(entry.scope ? { scope: entry.scope } : {}),
-  };
-}
-
-/** A running process of a `stdio` server, as the host's pool holds it. */
-export interface SettingsMcpInstance {
-  /** The server's name. */
-  name: string;
-  /** Its folder (`''`: the host's own). */
-  cwd: string;
-  /** One process for every session (`true`), or one session's. */
-  shared: boolean;
-  /** How many sessions hold it now (0 while it idles before closing). */
-  sessions: number;
-  /** Its process id, while it runs. */
-  pid?: number;
-  /** Its config, switch or sign-in changed: it closes once its last session lets go. */
-  retired: boolean;
-}
-
-/**
- * The MCP servers of a folder (Settings › MCP servers). `cwd` is the folder
- * (`''`: the user's servers only). Turning a server or one of its tools on
- * and off is the settings document's (`enabledMcps`, `disabledMcpTools`).
- */
-export interface SettingsMcpHost {
-  /** The servers. */
-  servers(cwd: string): SettingsResource<readonly SettingsMcpServer[]>;
-  /** `add` can write a project's config when a folder is set. Absent: the user's config only. */
-  projectScope?: boolean;
-  /** Connects, lists the tools and records how it went in `servers`. Absent: no Test. */
-  test?(cwd: string, name: string): Promise<void>;
-  /** Starts an `http` server's browser sign-in. Absent: no Sign in. */
-  signIn?(cwd: string, name: string): SignInFlow;
-  /** Forgets a server's sign-in. Absent: no Sign out. */
-  signOut?(cwd: string, name: string): Promise<void>;
-  /** Adds or replaces a server (`validateMcpForm`'s result). Read `servers` again to see it. Absent: no Add server. */
-  add?(cwd: string, server: McpFormResult): Promise<void>;
-  /** Removes a server from the file that declares it. Read `servers` again to see it. Absent: no Remove. */
-  remove?(cwd: string, name: string): Promise<void>;
-  /** The running processes of the folder's servers (`''`: every folder's). Absent: no process badge, no Restart. */
-  instances?(cwd: string): SettingsResource<readonly SettingsMcpInstance[]>;
-  /** Ends a server's processes now; its next call starts a fresh one. Read `instances` again to see it. Absent: no Restart. */
-  restart?(cwd: string, name: string): Promise<void>;
-}
-
-/**
- * A server whose process the host may share between sessions: a `stdio`
- * server the host says runs on it (`scope: 'host'`). Remote and `context`
- * servers run per session.
- *
- * @param server - The server.
- */
-export function mcpShareable(server: Pick<SettingsMcpServer, 'transport' | 'scope'>): boolean {
-  return server.transport === 'stdio' && server.scope === 'host';
-}
-
-/**
- * Whether a server shares one process: the `mcpSharing` setting, else its config, else yes.
- *
- * @param server - The server.
- * @param sharing - The stored `mcpSharing`.
- */
-export function mcpSharedNow(
-  server: Pick<SettingsMcpServer, 'name' | 'shared'>,
-  sharing: Settings['mcpSharing'],
-): boolean {
-  return sharing?.[server.name] ?? server.shared ?? true;
-}
-
-/**
- * `mcpSharing` with one server's choice set.
- *
- * @param sharing - The stored `mcpSharing`.
- * @param name - The server.
- * @param shared - Share one process.
- */
-export function mcpSharingWith(
-  sharing: Settings['mcpSharing'],
-  name: string,
-  shared: boolean,
-): Record<string, boolean> {
-  return { ...(sharing ?? {}), [name]: shared };
-}
-
-/** What a server's process badge says: one shared process and how many sessions hold it, or one per session. */
-export interface SettingsMcpRunning {
-  /** One process for every session. */
-  shared: boolean;
-  /** Sessions holding the shared process. */
-  sessions: number;
-}
-
-/**
- * How a server runs now, from the host's instances: `null` when none runs.
- * Retired processes count only while no fresh one runs (they close soon).
- *
- * @param name - The server.
- * @param instances - The host's instances.
- */
-export function mcpRunning(name: string, instances: readonly SettingsMcpInstance[]): SettingsMcpRunning | null {
-  const mine = instances.filter((instance) => instance.name === name);
-  if (mine.length === 0) return null;
-  const live = mine.filter((instance) => !instance.retired);
-  const current = live.length > 0 ? live : mine;
-  const shared = current.filter((instance) => instance.shared);
-  if (shared.length === 0) return { shared: false, sessions: 0 };
-  return { shared: true, sessions: shared.reduce((total, instance) => total + instance.sessions, 0) };
-}
-
-/** What a server's badge says: its sign-in state, or how its last test failed. `idle`: no badge. */
-export type SettingsMcpBadge = SettingsMcpAuthState | 'key-refused' | 'bootstrap-error';
-
-/**
- * The badge of a server. A refused key or a failed connection comes from the
- * last test; a sign-in in progress (`live`) or a sign-in problem wins.
- *
- * @param auth - Its sign-in state.
- * @param test - Its last test.
- * @param live - A sign-in of this server runs here.
- */
-export function mcpBadge(
-  auth: SettingsMcpAuthState,
-  test: SettingsMcpTest | undefined,
-  live: boolean,
-): SettingsMcpBadge {
-  if (live || auth === 'authorizing' || auth === 'error' || auth === 'needs-auth') return auth;
-  if (test?.kind === 'token-rejected') return 'key-refused';
-  if (test?.kind === 'error') return 'bootstrap-error';
-  return auth;
-}
-
-/**
- * The tools of a server that are on (`disabledMcpTools` is a deny list).
- *
- * @param server - The server's name.
- * @param tools - Its tools.
- * @param disabled - The stored `disabledMcpTools`.
- */
-export function enabledMcpTools(
-  server: string,
-  tools: readonly SettingsMcpTool[],
-  disabled: Settings['disabledMcpTools'],
-): ReadonlySet<string> {
-  const names = tools.map((tool) => tool.name);
-  const off = disabled?.[server];
-  if (!off || off.length === 0) return new Set(names);
-  const deny = new Set(off);
-  return new Set(names.filter((name) => !deny.has(name)));
-}
-
-/**
- * `disabledMcpTools` after turning one tool on or off. Names the server no
- * longer lists drop out; an empty list drops the server, an empty map is
- * `undefined`.
- *
- * @param server - The server's name.
- * @param tools - Its tools.
- * @param disabled - The stored `disabledMcpTools`.
- * @param tool - The tool toggled.
- */
-export function toggleMcpTool(
-  server: string,
-  tools: readonly SettingsMcpTool[],
-  disabled: Settings['disabledMcpTools'],
-  tool: string,
-): Settings['disabledMcpTools'] {
-  const catalog = new Set(tools.map((t) => t.name));
-  const current = new Set(disabled?.[server] ?? []);
-  if (current.has(tool)) current.delete(tool);
-  else current.add(tool);
-  const forServer = [...current].filter((name) => catalog.has(name)).sort();
-  const next: Record<string, readonly string[]> = { ...(disabled ?? {}) };
-  if (forServer.length === 0) delete next[server];
-  else next[server] = forServer;
-  return Object.keys(next).length === 0 ? undefined : next;
-}
-
-/**
- * After adding a server: the allowlist with it turned on, or `undefined` to
- * leave the settings alone. Only a server that wasn't listed before is
- * turned on (an edit keeps its toggle), and only when the list is known.
- * Same rule as the TUI and a server's `mcp.upsert`.
- *
- * @param enabled - The stored `enabledMcps`.
- * @param listed - The servers listed before the add (`null`: not read yet).
- * @param name - The server added.
- */
-export function enabledMcpsAfterAdd(
-  enabled: readonly string[] | undefined,
-  listed: readonly { name: string }[] | null | undefined,
-  name: string,
-): string[] | undefined {
-  if (!listed || listed.some((s) => s.name === name)) return undefined;
-  return enabledMcpsWith(enabled, name);
-}
-
-/**
- * What a removal writes: the server out of `enabledMcps`,
- * `disabledMcpTools` and `mcpSharing`, so a later server of the same name
- * starts from the defaults. Empty when none names it.
- *
- * @param values - The settings.
- * @param name - The server removed.
- */
-export function mcpSettingsAfterRemove(
-  values: Pick<Settings, 'enabledMcps' | 'disabledMcpTools' | 'mcpSharing'>,
-  name: string,
-): Partial<Settings> {
-  const patch: Partial<Settings> = {};
-  if (values.enabledMcps?.includes(name)) {
-    patch.enabledMcps = values.enabledMcps.filter((n) => n !== name) as Settings['enabledMcps'];
-  }
-  const deny = values.disabledMcpTools;
-  if (deny && name in deny) {
-    const { [name]: _dropped, ...rest } = deny;
-    patch.disabledMcpTools = Object.keys(rest).length === 0 ? undefined : rest;
-  }
-  const sharing = values.mcpSharing;
-  if (sharing && name in sharing) {
-    const { [name]: _dropped, ...rest } = sharing;
-    patch.mcpSharing = Object.keys(rest).length === 0 ? undefined : rest;
-  }
-  return patch;
-}

package/src/settings/headless/models.ts

@@ -1,51 +0,0 @@
-/**
- * The `SettingsHost.models` group: what the model rows of Settings › Agent
- * need beyond the composer's catalog (`ComposerHost.models`): the models
- * that answer decisions, a one-prompt test of a model, and the model new
- * sessions start on when no default is set. React-free.
- */
-import type { ModelPickRef } from '../../chat/headless/composer/models';
-
-import type { SettingsResource } from './sections-host';
-
-/** How a model test went: one tiny request with the host's credentials. */
-export interface SettingsModelTest {
-  /** The model answered. */
-  ok: boolean;
-  /** The provider that answered (its key). */
-  provider?: string;
-  /** The model that answered (its id). */
-  model?: string;
-  /** How long it took. */
-  durationMs: number;
-  /** Why it failed (`unavailable`, `auth`, `timeout`, …). */
-  reason?: string;
-  /** What the provider said. */
-  message?: string;
-}
-
-/** A model a provider's decisions endpoint serves, with whether the host's credentials can use it. */
-export interface SettingsDecisionModel {
-  /** The provider's key. */
-  providerKey: string;
-  /** The provider's name. */
-  providerLabel: string;
-  /** The model's id. */
-  modelId: string;
-  /** The credentials can send it decisions. */
-  available: boolean;
-  /** Why not, when not. */
-  reason?: string;
-}
-
-/** The model rows' host calls. Each one left out hides what needs it. */
-export interface SettingsModelsHost {
-  /** The decision models for a folder (`''`: none). Absent: no decision model row, Model decision stays offered. */
-  decisionModels?(cwd: string): SettingsResource<readonly SettingsDecisionModel[]>;
-  /** Sends a chat model (`"providerKey[@account]/modelId"`) one tiny prompt. Absent: no Test buttons. */
-  test?(cwd: string, model: string): Promise<SettingsModelTest>;
-  /** Sends one tiny decision (`model` absent: the one agents would get). Absent: the decision row has no Test. */
-  testDecision?(cwd: string, model?: string): Promise<SettingsModelTest>;
-  /** The model new sessions start on with no default set (the last one picked), `null` when none. */
-  lastUsed?(): Promise<ModelPickRef | null>;
-}

package/src/settings/headless/page-counts.ts

@@ -1,40 +0,0 @@
-/**
- * The settings nav's counts: how many settings each page of rows holds
- * (`settingsCount`), and how many things each list page lists, from the
- * lengths the app read. Instructions and Logs set nothing, so no count.
- */
-import { settingsCount, type SettingsPage, type SettingsTabId } from './layout';
-
-/** Pages with nothing to set. */
-const UNCOUNTED: ReadonlySet<SettingsTabId> = new Set(['instructions', 'logs', 'performance']);
-
-/**
- * A list's length; `undefined` for an answer that isn't a list (a server too old, a failed read).
- *
- * @param list - What a read answered.
- */
-export function listLength(list: unknown): number | undefined {
-  return Array.isArray(list) ? list.length : undefined;
-}
-
-/**
- * Each page's count: a list page's length from `lists`, a page of rows its settings. Zero and unknown
- * counts are left out.
- *
- * @param pages - The pages the nav shows.
- * @param lists - The list pages' lengths (`undefined`: unknown).
- * @param server - The settings are a server's (its local-only rows are not counted).
- */
-export function settingsPageCounts(
-  pages: readonly SettingsPage[],
-  lists: Partial<Record<SettingsTabId, number | undefined>>,
-  server: boolean,
-): Partial<Record<SettingsTabId, number>> {
-  const counts: Partial<Record<SettingsTabId, number>> = {};
-  for (const page of pages) {
-    if (UNCOUNTED.has(page.id)) continue;
-    const count = page.id in lists ? lists[page.id] : settingsCount(page, server);
-    if (count) counts[page.id] = count;
-  }
-  return counts;
-}