@flanksource/clicky-ui 0.3.27 → 0.3.28

package/dist/data/runtime/runtime-mode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-mode.cjs","sources":["../../../src/data/runtime/runtime-mode.ts"],"sourcesContent":["import type { StaticIconComponent } from \"../Icon\";\nimport { UiCloud, UiColumns, UiRobotAi, UiTerminal } from \"../../icons\";\nimport type { ChatModel, RuntimeAvailability } from \"../chat/types\";\nimport {\n  availabilityText,\n  isSelectableModel,\n  isUnavailable,\n  unsupportedAvailability,\n} from \"./availability\";\n\n// A backend runtime is factored into two UI axes — a provider\n// **family** (Claude, OpenAI, …) and a **mode** within it (Agent, CLI, cmux,\n// API) — that together resolve to a single `spec.backend` string. This is the\n// only place that mapping lives; both the inline PromptRunEditor and the modal\n// SpecRuntimeEditor drive their Mode pickers from it.\n\nexport type SpecRuntimeModeOption = {\n  /** UI mode id within a family (e.g. \"agent\", \"cli\", \"cmux\", \"api\"). */\n  id: string;\n  label: string;\n  /** The concrete `spec.backend` this (family, mode) resolves to. */\n  backend: string;\n  icon?: StaticIconComponent | undefined;\n  title?: string | undefined;\n  provider?: string | undefined;\n  availability?: RuntimeAvailability | undefined;\n};\n\nexport type SpecRuntimeFamily = {\n  id: string;\n  label: string;\n  /** The model-catalog provider (`ChatModel.provider`) whose models this family runs. */\n  provider: string;\n  modes: SpecRuntimeModeOption[];\n};\n\n// Default catalog covering the captain/gavel backend set. Hosts may pass their\n// own via the `families` prop when their catalog differs.\nexport const SPEC_RUNTIME_FAMILIES: SpecRuntimeFamily[] = [\n  {\n    id: \"claude\",\n    label: \"Claude\",\n    provider: \"claude-agent\",\n    modes: [\n      {\n        id: \"agent\",\n        label: \"Agent\",\n        backend: \"claude-agent\",\n        icon: UiRobotAi,\n        title: \"Claude Agent SDK\",\n      },\n      {\n        id: \"cli\",\n        label: \"CLI\",\n        backend: \"claude-cli\",\n        icon: UiTerminal,\n        title: \"Claude Code CLI\",\n      },\n      {\n        id: \"cmux\",\n        label: \"cmux\",\n        backend: \"claude-cmux\",\n        icon: UiColumns,\n        title: \"Claude multiplexer\",\n      },\n    ],\n  },\n  {\n    id: \"codex\",\n    label: \"Codex\",\n    provider: \"codex-cli\",\n    modes: [\n      {\n        id: \"agent\",\n        label: \"Agent\",\n        backend: \"codex-agent\",\n        icon: UiRobotAi,\n        title: \"Codex agent\",\n      },\n      {\n        id: \"cli\",\n        label: \"CLI\",\n        backend: \"codex-cli\",\n        icon: UiTerminal,\n        title: \"Codex CLI\",\n      },\n      {\n        id: \"cmux\",\n        label: \"cmux\",\n        backend: \"codex-cmux\",\n        icon: UiColumns,\n        title: \"Codex multiplexer\",\n      },\n    ],\n  },\n  {\n    id: \"openai\",\n    label: \"OpenAI\",\n    provider: \"openai\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        backend: \"openai\",\n        icon: UiCloud,\n        title: \"OpenAI API\",\n      },\n    ],\n  },\n  {\n    id: \"anthropic\",\n    label: \"Anthropic\",\n    provider: \"anthropic\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        backend: \"anthropic\",\n        icon: UiCloud,\n        title: \"Anthropic API\",\n      },\n    ],\n  },\n  {\n    id: \"gemini\",\n    label: \"Gemini\",\n    provider: \"googleai\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        backend: \"gemini\",\n        icon: UiCloud,\n        title: \"Gemini API\",\n      },\n      {\n        id: \"cli\",\n        label: \"CLI\",\n        backend: \"gemini-cli\",\n        icon: UiTerminal,\n        title: \"Gemini CLI\",\n      },\n    ],\n  },\n  {\n    id: \"deepseek\",\n    label: \"DeepSeek\",\n    provider: \"deepseek\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        backend: \"deepseek\",\n        icon: UiCloud,\n        title: \"DeepSeek API\",\n      },\n    ],\n  },\n];\n\n// One provider×mode cell as captain serves it (`/whoami`.runtimes and the prompt\n// schema document's `runtimes`), projected from its model registry. It carries\n// ids, not display text: `claude`/`api` are enough to render both, and a served\n// label would be a second place for presentation to drift.\nexport type RuntimeCatalogMode = {\n  /** api | agent | cli | cmux */\n  mode: string;\n  /** The concrete `spec.backend`, e.g. \"claude-cmux\". */\n  backend: string;\n  /** \"api\" (remote, in-process) or \"cli\" (supervised local binary). */\n  kind?: string | undefined;\n  /** Rides the local CLI's own login; never consults an API key. */\n  keyless?: boolean | undefined;\n  /** The model id a picker should seed this mode with. */\n  defaultModel?: string | undefined;\n  /** The user switched this off in `~/.captain.yaml`. */\n  disabled?: boolean | undefined;\n  disabledReason?: string | undefined;\n  /** Model-catalog provider used by this exact mode. */\n  catalogProvider?: string | undefined;\n  availability?: RuntimeAvailability | undefined;\n};\n\nexport type RuntimeCatalogFamily = {\n  /** The coding-agent name: claude | codex | gemini | deepseek. */\n  family: string;\n  /** The canonical provider key: anthropic | openai | google | deepseek. */\n  provider: string;\n  /** The namespace this provider's model ids carry (`ChatModel.provider`). */\n  catalogPrefix: string;\n  modes: RuntimeCatalogMode[];\n};\n\nconst MODE_ICONS: Record<string, StaticIconComponent> = {\n  api: UiCloud,\n  agent: UiRobotAi,\n  cli: UiTerminal,\n  cmux: UiColumns,\n};\n\n// Mode ids are lowercase tokens; only the acronyms and the lowercase brand\n// \"cmux\" need spelling out. `agent` falls through to plain title case.\nconst MODE_LABELS: Record<string, string> = {\n  api: \"API\",\n  cli: \"CLI\",\n  cmux: \"cmux\",\n};\n\n// Tooltip text, so \"Claude cmux\" reads as \"Claude multiplexer\".\nconst MODE_TITLES: Record<string, string> = {\n  api: \"API\",\n  agent: \"Agent SDK\",\n  cli: \"CLI\",\n  cmux: \"multiplexer\",\n};\n\n// The one brand whose title case is not just an initial capital.\nconst FAMILY_LABELS: Record<string, string> = { deepseek: \"DeepSeek\" };\n\nfunction titleCase(token: string): string {\n  return token ? token.charAt(0).toUpperCase() + token.slice(1) : token;\n}\n\n// Turns the served catalog into the shared family list. Unavailable entries\n// stay present for Provider Status while runtime controls filter them out.\n//\n// The registry has one provider per family, so Claude's API mode sits beside its\n// Agent/CLI/cmux modes here rather than in a separate \"Anthropic\" family the way\n// SPEC_RUNTIME_FAMILIES splits them.\nexport function familiesFromRuntimeCatalog(\n  catalog: RuntimeCatalogFamily[] | undefined\n): SpecRuntimeFamily[] {\n  if (!catalog?.length) return SPEC_RUNTIME_FAMILIES;\n  const families: SpecRuntimeFamily[] = [];\n  for (const entry of catalog) {\n    const label = FAMILY_LABELS[entry.family] ?? titleCase(entry.family);\n    const modes = entry.modes.map((mode) => ({\n      id: mode.mode,\n      label: MODE_LABELS[mode.mode] ?? titleCase(mode.mode),\n      backend: mode.backend,\n      icon: MODE_ICONS[mode.mode],\n      title: `${label} ${MODE_TITLES[mode.mode] ?? titleCase(mode.mode)}`,\n      provider: mode.catalogProvider ?? entry.catalogPrefix,\n      ...(mode.availability\n        ? { availability: mode.availability }\n        : mode.disabled\n        ? {\n            availability: {\n              state: \"disabled\" as const,\n              reason: `Disabled by ${\n                mode.disabledReason ?? mode.backend\n              } in Captain configuration.`,\n              remediation: `Enable ${\n                mode.disabledReason ?? mode.backend\n              } on the Whoami page, then refresh.`,\n            },\n          }\n        : {}),\n    }));\n    families.push({\n      id: entry.family,\n      label,\n      provider: entry.catalogPrefix,\n      modes,\n    });\n  }\n  return families.length ? families : SPEC_RUNTIME_FAMILIES;\n}\n\nexport function familyById(\n  families: SpecRuntimeFamily[],\n  id: string\n): SpecRuntimeFamily {\n  const match = families.find((family) => family.id === id);\n  if (match) return match;\n  const first = families[0];\n  if (!first) throw new Error(\"SpecRuntimeFamily catalog must not be empty\");\n  return first;\n}\n\nexport function firstMode(family: SpecRuntimeFamily): SpecRuntimeModeOption {\n  const mode =\n    family.modes.find((candidate) => !isUnavailable(candidate.availability)) ??\n    family.modes[0];\n  if (!mode) {\n    throw new Error(\n      `SpecRuntimeFamily \"${family.id}\" must have at least one mode`\n    );\n  }\n  return mode;\n}\n\n// Every mode id in the catalog, first-seen order. The returned `backend` belongs\n// to the family that declared the mode first — resolve the real one with\n// `backendForFamilyMode`.\nexport function runtimeModeOptions(\n  families: SpecRuntimeFamily[]\n): SpecRuntimeModeOption[] {\n  const modes = new Map<string, SpecRuntimeModeOption>();\n  for (const family of families) {\n    for (const mode of family.modes) {\n      if (!modes.has(mode.id)) modes.set(mode.id, mode);\n    }\n  }\n  return [...modes.values()];\n}\n\n// One phrasing for \"this family does not offer that mode\", shared by every\n// runtime presentation so the same state never reads two ways.\nexport function unsupportedModeTitle(family: SpecRuntimeFamily): string {\n  return availabilityText(\n    unsupportedAvailability(\n      family.label,\n      \"this\",\n      family.modes\n        .filter((mode) => !isUnavailable(mode.availability))\n        .map((mode) => mode.label)\n    )\n  )!;\n}\n\nexport function unsupportedModeAvailability(\n  family: SpecRuntimeFamily,\n  mode: SpecRuntimeModeOption\n): RuntimeAvailability {\n  return unsupportedAvailability(\n    family.label,\n    mode.label,\n    family.modes\n      .filter((candidate) => !isUnavailable(candidate.availability))\n      .map((candidate) => candidate.label)\n  );\n}\n\nexport function backendForFamilyMode(\n  families: SpecRuntimeFamily[],\n  familyId: string,\n  modeId: string\n): string {\n  const family = familyById(families, familyId);\n  const requested = family.modes.find((candidate) => candidate.id === modeId);\n  const mode =\n    requested && !isUnavailable(requested.availability)\n      ? requested\n      : firstMode(family);\n  if (isUnavailable(mode.availability)) {\n    throw new Error(\n      `SpecRuntimeFamily \"${family.id}\" has no available runtime modes`\n    );\n  }\n  return mode.backend;\n}\n\nexport function selectionForBackend(\n  families: SpecRuntimeFamily[],\n  backend: string | undefined\n): { family: string; mode: string } {\n  const target = (backend ?? \"\").toLowerCase();\n  for (const family of families) {\n    for (const mode of family.modes) {\n      if (mode.backend.toLowerCase() === target) {\n        return { family: family.id, mode: mode.id };\n      }\n    }\n  }\n  const first = familyById(families, \"\");\n  return { family: first.id, mode: firstMode(first).id };\n}\n\nexport function familyForBackend(\n  families: SpecRuntimeFamily[],\n  backend: string | undefined\n): SpecRuntimeFamily | undefined {\n  const target = (backend ?? \"\").toLowerCase();\n  return families.find((family) =>\n    family.modes.some((mode) => mode.backend.toLowerCase() === target)\n  );\n}\n\n// The mode a backend id names, or undefined when the catalog does not declare\n// it. Unlike `selectionForBackend` this does not fall back to the first family,\n// so a summary can stay silent about a runtime it cannot identify.\nexport function modeForBackend(\n  families: SpecRuntimeFamily[],\n  backend: string | undefined\n): SpecRuntimeModeOption | undefined {\n  const target = (backend ?? \"\").toLowerCase();\n  if (!target) return undefined;\n  for (const family of families) {\n    const mode = family.modes.find(\n      (entry) => entry.backend.toLowerCase() === target\n    );\n    if (mode) return mode;\n  }\n  return undefined;\n}\n\n// \"claude-agent\" -> \"Claude Agent\"; unknown/empty -> \"Prompt default\".\nexport function labelForBackend(\n  backend: string | undefined,\n  families: SpecRuntimeFamily[] = SPEC_RUNTIME_FAMILIES\n): string {\n  const target = (backend ?? \"\").toLowerCase();\n  for (const family of families) {\n    for (const mode of family.modes) {\n      if (mode.backend.toLowerCase() === target) {\n        return `${family.label} ${mode.label}`;\n      }\n    }\n  }\n  return \"Prompt default\";\n}\n\n/** Lists selectable models by provider and declared backend support. */\nexport function modelsForFamily(\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  backend?: string | undefined\n): ChatModel[] {\n  if (!family) return models.filter(isSelectableModel);\n  const provider =\n    family.modes.find((mode) => mode.backend === backend)?.provider ??\n    family.provider;\n  return models.filter(\n    (model) =>\n      isSelectableModel(model) &&\n      model.provider === provider &&\n      modelMatchesBackend(model, backend)\n  );\n}\n\n/** Reports whether the first matching catalog identity belongs to the target family. */\nexport function modelBelongsToFamily(\n  modelId: string | undefined,\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  backend?: string | undefined\n): boolean {\n  if (!modelId) return true;\n  const selected = models.find(\n    (model) =>\n      isSelectableModel(model) &&\n      (model.id === modelId ||\n        model.runtime?.model === modelId ||\n        model.runtime?.id === modelId)\n  );\n  if (!selected) return false;\n  const provider =\n    family?.modes.find((mode) => mode.backend === backend)?.provider ??\n    family?.provider;\n  const providerMatches = !provider || selected.provider === provider;\n  return providerMatches && modelMatchesBackend(selected, backend);\n}\n\n/** Resolves a target backend row, using a sole shared row as fallback. */\nexport function modelForFamily(\n  modelId: string | undefined,\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  backend?: string | undefined\n): ChatModel | undefined {\n  if (!modelId) return undefined;\n  const matches = modelsForFamily(models, family, backend).filter(\n    (model) =>\n      model.id === modelId ||\n      model.runtime?.model === modelId ||\n      model.runtime?.id === modelId\n  );\n  return (\n    matches.find(\n      (model) =>\n        !backend ||\n        !model.runtime?.backend ||\n        model.runtime.backend === backend\n    ) ?? (matches.length === 1 ? matches[0] : undefined)\n  );\n}\n\n/** Checks a model row's declared runtime backends when the catalog scopes it. */\nexport function modelMatchesBackend(\n  model: ChatModel,\n  backend: string | undefined\n): boolean {\n  if (!backend) return true;\n  const backends = model.backends?.filter(Boolean);\n  if (!backends || backends.length === 0) return true;\n  return backends.includes(backend);\n}\n"],"names":["UiRobotAi","UiTerminal","UiColumns","UiCloud","isUnavailable","isSelectableModel","_a"],"mappings":"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"}
+{"version":3,"file":"runtime-mode.cjs","sources":["../../../src/data/runtime/runtime-mode.ts"],"sourcesContent":["import type { StaticIconComponent } from \"../Icon\";\nimport { UiCloud, UiColumns, UiRobotAi, UiTerminal } from \"../../icons\";\nimport type { JsonSchemaProperty } from \"../../components/json-schema-form-types\";\nimport type { ChatModel, RuntimeAvailability } from \"../chat/types\";\nimport {\n  availabilityText,\n  isSelectableModel,\n  isUnavailable,\n  unsupportedAvailability,\n} from \"./availability\";\n\n// A runtime has two independent axes: the model selects a provider family and\n// `spec.mode` selects api | agent | cli | cmux. The mode never contains a\n// provider name. This file used to call that axis `backend`, which is also what\n// captain called the composite adapter id it once served — so a value read from\n// one and posted back as the other type-checked and ran the wrong runtime.\n\nexport const SPEC_RUNTIME_MODES = [\"api\", \"agent\", \"cli\", \"cmux\"] as const;\nexport type SpecRuntimeMode = (typeof SPEC_RUNTIME_MODES)[number];\n\nexport function isSpecRuntimeMode(\n  value: string | undefined,\n): value is SpecRuntimeMode {\n  return SPEC_RUNTIME_MODES.some((mode) => mode === value);\n}\n\nexport function runtimeModeFromModel(\n  model: string | undefined,\n): SpecRuntimeMode | undefined {\n  const [prefix] = (model ?? \"\").trim().toLowerCase().split(\":\");\n  return isSpecRuntimeMode(prefix) ? prefix : undefined;\n}\n\nexport function runtimeModelError(\n  model: string | undefined,\n): string | undefined {\n  for (const raw of (model ?? \"\").split(\",\")) {\n    const compact = raw.trim();\n    if (!compact || !compact.includes(\":\")) continue;\n    const parts = compact.split(\":\").map((part) => part.trim());\n    const [mode, name, effort] = parts;\n    if (!isSpecRuntimeMode(mode)) {\n      return `Invalid model configuration: mode ${JSON.stringify(mode)} in model ${JSON.stringify(compact)}. Expected api, agent, cli, or cmux.`;\n    }\n    if (!name || parts.length > 3) {\n      return `Invalid model configuration: model ${JSON.stringify(compact)}. Expected mode:model[:effort].`;\n    }\n    if (\n      effort !== undefined &&\n      ![\"low\", \"medium\", \"high\", \"xhigh\", \"max\", \"ultra\"].includes(effort)\n    ) {\n      return `Invalid model configuration: effort ${JSON.stringify(effort)} in model ${JSON.stringify(compact)}.`;\n    }\n  }\n  return undefined;\n}\n\nexport function runtimeModeError(\n  families: SpecRuntimeFamily[],\n  mode: string | undefined,\n  familyId?: string | undefined,\n): string | undefined {\n  if (!mode) return undefined;\n  if (!isSpecRuntimeMode(mode)) {\n    return `Invalid model configuration: mode ${JSON.stringify(mode)}. Expected api, agent, cli, or cmux.`;\n  }\n  const family = familyId\n    ? families.find((entry) => entry.id === familyId)\n    : undefined;\n  if (family && !family.modes.some((entry) => entry.id === mode)) {\n    return `Invalid model configuration: mode ${JSON.stringify(mode)} is not available for ${family.label}.`;\n  }\n  if (!families.some((entry) => entry.modes.some((m) => m.id === mode))) {\n    return `Invalid model configuration: mode ${JSON.stringify(mode)} is missing from the runtime catalog.`;\n  }\n  return undefined;\n}\n\nexport type SpecRuntimeModeOption = {\n  /** The canonical `spec.mode`: api | agent | cli | cmux. */\n  id: string;\n  label: string;\n  icon?: StaticIconComponent | undefined;\n  title?: string | undefined;\n  provider?: string | undefined;\n  defaultModel?: string | undefined;\n  availability?: RuntimeAvailability | undefined;\n  permissions?: RuntimePermissionCapabilities | undefined;\n  schema?: RuntimeSpecSchema | undefined;\n};\n\nexport type RuntimeArgumentImplementation = \"mapped\" | \"managed\";\n\nexport type RuntimeArgumentMapping = {\n  name: string;\n  implementation: RuntimeArgumentImplementation;\n  description?: string | undefined;\n};\n\nexport type RuntimeSpecSchema = JsonSchemaProperty & {\n  \"x-clicky-arguments\"?: RuntimeArgumentMapping[] | undefined;\n  \"x-clicky-managed-arguments\"?: RuntimeArgumentMapping[] | undefined;\n};\n\nexport type RuntimePermissionSupportKind =\n  | \"native\"\n  | \"approximated\"\n  | \"requires-broker\"\n  | \"unsupported\";\n\nexport type RuntimePermissionSupport = {\n  kind: RuntimePermissionSupportKind;\n  effects?:\n    | {\n        flag?: string | undefined;\n        sandbox?: string | undefined;\n        approval?: string | undefined;\n        note?: string | undefined;\n      }\n    | undefined;\n};\n\nexport type RuntimePermissionCapabilities = {\n  modes: Record<string, RuntimePermissionSupport>;\n  toolPolicies: Record<string, Record<string, RuntimePermissionSupport>>;\n  resources: Record<string, Record<string, RuntimePermissionSupport>>;\n  tools?: string[] | undefined;\n};\n\nexport type SpecRuntimeFamily = {\n  id: string;\n  label: string;\n  /** The model-catalog provider (`ChatModel.provider`) whose models this family runs. */\n  provider: string;\n  modes: SpecRuntimeModeOption[];\n};\n\n// Offline catalog for stories and tests. Live hosts should pass Captain's\n// registry projection; both use the same provider + mode structure.\nexport const SPEC_RUNTIME_FAMILIES: SpecRuntimeFamily[] = [\n  {\n    id: \"claude\",\n    label: \"Claude\",\n    provider: \"anthropic\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        icon: UiCloud,\n        title: \"Anthropic API\",\n        provider: \"anthropic\",\n      },\n      {\n        id: \"agent\",\n        label: \"Agent\",\n        icon: UiRobotAi,\n        title: \"Claude Agent SDK\",\n        provider: \"anthropic\",\n      },\n      {\n        id: \"cli\",\n        label: \"CLI\",\n        icon: UiTerminal,\n        title: \"Claude Code CLI\",\n        provider: \"anthropic\",\n      },\n      {\n        id: \"cmux\",\n        label: \"cmux\",\n        icon: UiColumns,\n        title: \"Claude multiplexer\",\n        provider: \"anthropic\",\n      },\n    ],\n  },\n  {\n    id: \"codex\",\n    label: \"Codex\",\n    provider: \"openai\",\n    modes: [\n      {\n        id: \"api\",\n        label: \"API\",\n        icon: UiCloud,\n        title: \"OpenAI API\",\n        provider: \"openai\",\n      },\n      {\n        id: \"agent\",\n        label: \"Agent\",\n        icon: UiRobotAi,\n        title: \"Codex agent\",\n        provider: \"openai\",\n      },\n      {\n        id: \"cli\",\n        label: \"CLI\",\n        icon: UiTerminal,\n        title: \"Codex CLI\",\n        provider: \"openai\",\n      },\n      {\n        id: \"cmux\",\n        label: \"cmux\",\n        icon: UiColumns,\n        title: \"Codex multiplexer\",\n        provider: \"openai\",\n      },\n    ],\n  },\n  {\n    id: \"gemini\",\n    label: \"Gemini\",\n    provider: \"googleai\",\n    modes: [\n      { id: \"api\", label: \"API\", icon: UiCloud, title: \"Gemini API\" },\n      { id: \"cli\", label: \"CLI\", icon: UiTerminal, title: \"Gemini CLI\" },\n    ],\n  },\n  {\n    id: \"deepseek\",\n    label: \"DeepSeek\",\n    provider: \"deepseek\",\n    modes: [{ id: \"api\", label: \"API\", icon: UiCloud, title: \"DeepSeek API\" }],\n  },\n];\n\n// One provider×mode cell as captain serves it (`/whoami`.runtimes and the prompt\n// schema document's `runtimes`), projected from its model registry. It carries\n// ids, not display text: `claude`/`api` are enough to render both, and a served\n// label would be a second place for presentation to drift.\nexport type RuntimeCatalogMode = {\n  /** The canonical `spec.mode`: api | agent | cli | cmux. */\n  mode: SpecRuntimeMode;\n  /** \"api\" (remote, in-process) or \"cli\" (supervised local binary). */\n  kind?: string | undefined;\n  /** Rides the local CLI's own login; never consults an API key. */\n  keyless?: boolean | undefined;\n  /** The model id a picker should seed this mode with. */\n  defaultModel?: string | undefined;\n  /** The user switched this off in `~/.captain.yaml`. */\n  disabled?: boolean | undefined;\n  disabledReason?: string | undefined;\n  /** Model-catalog provider used by this exact mode. */\n  catalogProvider?: string | undefined;\n  availability?: RuntimeAvailability | undefined;\n  permissions?: RuntimePermissionCapabilities | undefined;\n  /** Supported Spec fields, annotated with native CLI and protocol bindings. */\n  schema: RuntimeSpecSchema;\n};\n\nexport type RuntimeCatalogFamily = {\n  /** The coding-agent name: claude | codex | gemini | deepseek. */\n  family: string;\n  /** The canonical provider key: anthropic | openai | google | deepseek. */\n  provider: string;\n  /** The namespace this provider's model ids carry (`ChatModel.provider`). */\n  catalogPrefix: string;\n  modes: RuntimeCatalogMode[];\n};\n\nconst MODE_ICONS: Record<string, StaticIconComponent> = {\n  api: UiCloud,\n  agent: UiRobotAi,\n  cli: UiTerminal,\n  cmux: UiColumns,\n};\n\n// Mode ids are lowercase tokens; only the acronyms and the lowercase brand\n// \"cmux\" need spelling out. `agent` falls through to plain title case.\nconst MODE_LABELS: Record<string, string> = {\n  api: \"API\",\n  cli: \"CLI\",\n  cmux: \"cmux\",\n};\n\n// Tooltip text, so \"Claude cmux\" reads as \"Claude multiplexer\".\nconst MODE_TITLES: Record<string, string> = {\n  api: \"API\",\n  agent: \"Agent SDK\",\n  cli: \"CLI\",\n  cmux: \"multiplexer\",\n};\n\n// The one brand whose title case is not just an initial capital.\nconst FAMILY_LABELS: Record<string, string> = { deepseek: \"DeepSeek\" };\n\nfunction titleCase(token: string): string {\n  return token ? token.charAt(0).toUpperCase() + token.slice(1) : token;\n}\n\n// Turns the served catalog into the shared family list. Unavailable entries\n// stay present for Provider Status while runtime controls filter them out.\n//\n// The registry has one provider per family, so Claude's API mode sits beside its\n// Agent/CLI/cmux modes here rather than in a separate \"Anthropic\" family the way\n// SPEC_RUNTIME_FAMILIES splits them.\nexport function familiesFromRuntimeCatalog(\n  catalog: RuntimeCatalogFamily[] | undefined,\n): SpecRuntimeFamily[] {\n  if (!catalog?.length) return SPEC_RUNTIME_FAMILIES;\n  const families: SpecRuntimeFamily[] = [];\n  for (const entry of catalog) {\n    const label = FAMILY_LABELS[entry.family] ?? titleCase(entry.family);\n    const modes = entry.modes.map((mode) => ({\n      id: mode.mode,\n      label: MODE_LABELS[mode.mode] ?? titleCase(mode.mode),\n      icon: MODE_ICONS[mode.mode],\n      title: `${label} ${MODE_TITLES[mode.mode] ?? titleCase(mode.mode)}`,\n      provider: mode.catalogProvider ?? entry.catalogPrefix,\n      ...(mode.defaultModel ? { defaultModel: mode.defaultModel } : {}),\n      ...(mode.permissions ? { permissions: mode.permissions } : {}),\n      ...(mode.schema ? { schema: mode.schema } : {}),\n      ...(mode.availability\n        ? { availability: mode.availability }\n        : mode.disabled\n          ? {\n              availability: {\n                state: \"disabled\" as const,\n                reason: `Disabled by ${\n                  mode.disabledReason ?? mode.mode\n                } in Captain configuration.`,\n                remediation: `Enable ${\n                  mode.disabledReason ?? mode.mode\n                } on the Whoami page, then refresh.`,\n              },\n            }\n          : {}),\n    }));\n    families.push({\n      id: entry.family,\n      label,\n      provider: entry.catalogPrefix,\n      modes,\n    });\n  }\n  return families.length ? families : SPEC_RUNTIME_FAMILIES;\n}\n\nexport function familyById(\n  families: SpecRuntimeFamily[],\n  id: string,\n): SpecRuntimeFamily {\n  const match = families.find((family) => family.id === id);\n  if (match) return match;\n  const first = families[0];\n  if (!first) throw new Error(\"SpecRuntimeFamily catalog must not be empty\");\n  return first;\n}\n\nexport function firstMode(family: SpecRuntimeFamily): SpecRuntimeModeOption {\n  const mode =\n    family.modes.find((candidate) => !isUnavailable(candidate.availability)) ??\n    family.modes[0];\n  if (!mode) {\n    throw new Error(\n      `SpecRuntimeFamily \"${family.id}\" must have at least one mode`,\n    );\n  }\n  return mode;\n}\n\n// Every mode id in the catalog, first-seen order. The entry returned for an id\n// belongs to the family that declared it first, so its presentation fields may\n// differ from another family's — the id itself is family-independent.\nexport function runtimeModeOptions(\n  families: SpecRuntimeFamily[],\n): SpecRuntimeModeOption[] {\n  const modes = new Map<string, SpecRuntimeModeOption>();\n  for (const family of families) {\n    for (const mode of family.modes) {\n      if (!modes.has(mode.id)) modes.set(mode.id, mode);\n    }\n  }\n  return [...modes.values()];\n}\n\n// One phrasing for \"this family does not offer that mode\", shared by every\n// runtime presentation so the same state never reads two ways.\nexport function unsupportedModeTitle(family: SpecRuntimeFamily): string {\n  return availabilityText(\n    unsupportedAvailability(\n      family.label,\n      \"this\",\n      family.modes\n        .filter((mode) => !isUnavailable(mode.availability))\n        .map((mode) => mode.label),\n    ),\n  )!;\n}\n\nexport function unsupportedModeAvailability(\n  family: SpecRuntimeFamily,\n  mode: SpecRuntimeModeOption,\n): RuntimeAvailability {\n  return unsupportedAvailability(\n    family.label,\n    mode.label,\n    family.modes\n      .filter((candidate) => !isUnavailable(candidate.availability))\n      .map((candidate) => candidate.label),\n  );\n}\n\n// The mode a family will actually run for a requested id, falling back to its\n// first available one. The answer is a `spec.mode` value.\nexport function modeForFamily(\n  families: SpecRuntimeFamily[],\n  familyId: string,\n  modeId: string,\n): string {\n  const family = familyById(families, familyId);\n  const requested = family.modes.find((candidate) => candidate.id === modeId);\n  const mode =\n    requested && !isUnavailable(requested.availability)\n      ? requested\n      : firstMode(family);\n  if (isUnavailable(mode.availability)) {\n    throw new Error(\n      `SpecRuntimeFamily \"${family.id}\" has no available runtime modes`,\n    );\n  }\n  return mode.id;\n}\n\nexport function selectionForMode(\n  families: SpecRuntimeFamily[],\n  mode: string | undefined,\n  preferredFamily?: string | undefined,\n): { family: string; mode: string } {\n  const target = (mode ?? \"\").toLowerCase();\n  const preferred = families.find((family) => family.id === preferredFamily);\n  const preferredMode = preferred?.modes.find(\n    (entry) => entry.id.toLowerCase() === target,\n  );\n  if (preferred && preferredMode) {\n    return { family: preferred.id, mode: preferredMode.id };\n  }\n  for (const family of families) {\n    for (const entry of family.modes) {\n      if (entry.id.toLowerCase() === target) {\n        return { family: family.id, mode: entry.id };\n      }\n    }\n  }\n  const first = familyById(families, \"\");\n  return { family: first.id, mode: firstMode(first).id };\n}\n\nexport function familyForModel(\n  families: SpecRuntimeFamily[],\n  models: ChatModel[],\n  modelId: string | undefined,\n): SpecRuntimeFamily | undefined {\n  if (!modelId) return undefined;\n  const selected = models.find(\n    (model) =>\n      model.id === modelId ||\n      model.runtime?.model === modelId ||\n      model.runtime?.id === modelId,\n  );\n  if (!selected) return undefined;\n  return families.find(\n    (family) =>\n      family.provider === selected.provider ||\n      family.modes.some((mode) => mode.provider === selected.provider),\n  );\n}\n\nexport function selectionForRuntime(\n  families: SpecRuntimeFamily[],\n  mode: string | undefined,\n  modelId: string | undefined,\n  models: ChatModel[],\n  preferredFamily?: string | undefined,\n): { family: string; mode: string } {\n  return selectionForMode(\n    families,\n    mode,\n    familyForModel(families, models, modelId)?.id ?? preferredFamily,\n  );\n}\n\nexport function familyForMode(\n  families: SpecRuntimeFamily[],\n  mode: string | undefined,\n  preferredFamily?: string | undefined,\n): SpecRuntimeFamily | undefined {\n  if (preferredFamily) {\n    const family = families.find((entry) => entry.id === preferredFamily);\n    if (family?.modes.some((entry) => entry.id === mode)) return family;\n  }\n  const target = (mode ?? \"\").toLowerCase();\n  return families.find((family) =>\n    family.modes.some((entry) => entry.id.toLowerCase() === target),\n  );\n}\n\n// The mode option a `spec.mode` names, or undefined when the catalog does not\n// declare it. Unlike `selectionForMode` this does not fall back to the first\n// family, so a summary can stay silent about a runtime it cannot identify.\nexport function modeOptionFor(\n  families: SpecRuntimeFamily[],\n  mode: string | undefined,\n  preferredFamily?: string | undefined,\n): SpecRuntimeModeOption | undefined {\n  const target = (mode ?? \"\").toLowerCase();\n  if (!target) return undefined;\n  const ordered = preferredFamily\n    ? [\n        ...families.filter((family) => family.id === preferredFamily),\n        ...families.filter((family) => family.id !== preferredFamily),\n      ]\n    : families;\n  for (const family of ordered) {\n    const entry = family.modes.find(\n      (candidate) => candidate.id.toLowerCase() === target,\n    );\n    if (entry) return entry;\n  }\n  return undefined;\n}\n\n// `mode` is provider-independent, so a family is needed for a full label.\nexport function labelForMode(\n  mode: string | undefined,\n  families: SpecRuntimeFamily[] = SPEC_RUNTIME_FAMILIES,\n): string {\n  const target = (mode ?? \"\").toLowerCase();\n  for (const family of families) {\n    for (const entry of family.modes) {\n      if (entry.id.toLowerCase() === target) {\n        return `${family.label} ${entry.label}`;\n      }\n    }\n  }\n  return \"Prompt default\";\n}\n\n/** Lists selectable models for one provider family. */\nexport function modelsForFamily(\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  mode?: string | undefined,\n): ChatModel[] {\n  if (!family) return models.filter(isSelectableModel);\n  const provider =\n    family.modes.find((entry) => entry.id === mode)?.provider ??\n    family.provider;\n  return models.filter(\n    (model) => isSelectableModel(model) && model.provider === provider,\n  );\n}\n\n/** Reports whether the first matching catalog identity belongs to the target family. */\nexport function modelBelongsToFamily(\n  modelId: string | undefined,\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  mode?: string | undefined,\n): boolean {\n  if (!modelId) return true;\n  const selected = models.find(\n    (model) =>\n      isSelectableModel(model) &&\n      (model.id === modelId ||\n        model.runtime?.model === modelId ||\n        model.runtime?.id === modelId),\n  );\n  if (!selected) return false;\n  const provider =\n    family?.modes.find((entry) => entry.id === mode)?.provider ??\n    family?.provider;\n  return (\n    (!provider || selected.provider === provider) &&\n    (!selected.runtime?.mode || selected.runtime.mode === mode)\n  );\n}\n\n/** Resolves a target mode row, using a sole shared row as fallback. */\nexport function modelForFamily(\n  modelId: string | undefined,\n  models: ChatModel[],\n  family: SpecRuntimeFamily | undefined,\n  mode?: string | undefined,\n): ChatModel | undefined {\n  if (!modelId) return undefined;\n  const matches = modelsForFamily(models, family, mode).filter(\n    (model) =>\n      model.id === modelId ||\n      model.runtime?.model === modelId ||\n      model.runtime?.id === modelId,\n  );\n  return (\n    matches.find(\n      (model) => !mode || !model.runtime?.mode || model.runtime.mode === mode,\n    ) ?? (matches.length === 1 ? matches[0] : undefined)\n  );\n}\n"],"names":["UiCloud","UiRobotAi","UiTerminal","UiColumns","isUnavailable","isSelectableModel","_a","_b"],"mappings":"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"}

package/dist/data/runtime/runtime-mode.d.ts

@@ -1,15 +1,49 @@
 import { StaticIconComponent } from '../Icon';
+import { JsonSchemaProperty } from '../../components/json-schema-form-types';
 import { ChatModel, RuntimeAvailability } from '../chat/types';
+export declare const SPEC_RUNTIME_MODES: readonly ["api", "agent", "cli", "cmux"];
+export type SpecRuntimeMode = (typeof SPEC_RUNTIME_MODES)[number];
+export declare function isSpecRuntimeMode(value: string | undefined): value is SpecRuntimeMode;
+export declare function runtimeModeFromModel(model: string | undefined): SpecRuntimeMode | undefined;
+export declare function runtimeModelError(model: string | undefined): string | undefined;
+export declare function runtimeModeError(families: SpecRuntimeFamily[], mode: string | undefined, familyId?: string | undefined): string | undefined;
 export type SpecRuntimeModeOption = {
-    /** UI mode id within a family (e.g. "agent", "cli", "cmux", "api"). */
+    /** The canonical `spec.mode`: api | agent | cli | cmux. */
     id: string;
     label: string;
-    /** The concrete `spec.backend` this (family, mode) resolves to. */
-    backend: string;
     icon?: StaticIconComponent | undefined;
     title?: string | undefined;
     provider?: string | undefined;
+    defaultModel?: string | undefined;
     availability?: RuntimeAvailability | undefined;
+    permissions?: RuntimePermissionCapabilities | undefined;
+    schema?: RuntimeSpecSchema | undefined;
+};
+export type RuntimeArgumentImplementation = "mapped" | "managed";
+export type RuntimeArgumentMapping = {
+    name: string;
+    implementation: RuntimeArgumentImplementation;
+    description?: string | undefined;
+};
+export type RuntimeSpecSchema = JsonSchemaProperty & {
+    "x-clicky-arguments"?: RuntimeArgumentMapping[] | undefined;
+    "x-clicky-managed-arguments"?: RuntimeArgumentMapping[] | undefined;
+};
+export type RuntimePermissionSupportKind = "native" | "approximated" | "requires-broker" | "unsupported";
+export type RuntimePermissionSupport = {
+    kind: RuntimePermissionSupportKind;
+    effects?: {
+        flag?: string | undefined;
+        sandbox?: string | undefined;
+        approval?: string | undefined;
+        note?: string | undefined;
+    } | undefined;
+};
+export type RuntimePermissionCapabilities = {
+    modes: Record<string, RuntimePermissionSupport>;
+    toolPolicies: Record<string, Record<string, RuntimePermissionSupport>>;
+    resources: Record<string, Record<string, RuntimePermissionSupport>>;
+    tools?: string[] | undefined;
 };
 export type SpecRuntimeFamily = {
     id: string;
@@ -20,10 +54,8 @@ export type SpecRuntimeFamily = {
 };
 export declare const SPEC_RUNTIME_FAMILIES: SpecRuntimeFamily[];
 export type RuntimeCatalogMode = {
-    /** api | agent | cli | cmux */
-    mode: string;
-    /** The concrete `spec.backend`, e.g. "claude-cmux". */
-    backend: string;
+    /** The canonical `spec.mode`: api | agent | cli | cmux. */
+    mode: SpecRuntimeMode;
     /** "api" (remote, in-process) or "cli" (supervised local binary). */
     kind?: string | undefined;
     /** Rides the local CLI's own login; never consults an API key. */
@@ -36,6 +68,9 @@ export type RuntimeCatalogMode = {
     /** Model-catalog provider used by this exact mode. */
     catalogProvider?: string | undefined;
     availability?: RuntimeAvailability | undefined;
+    permissions?: RuntimePermissionCapabilities | undefined;
+    /** Supported Spec fields, annotated with native CLI and protocol bindings. */
+    schema: RuntimeSpecSchema;
 };
 export type RuntimeCatalogFamily = {
     /** The coding-agent name: claude | codex | gemini | deepseek. */
@@ -52,20 +87,23 @@ export declare function firstMode(family: SpecRuntimeFamily): SpecRuntimeModeOpt
 export declare function runtimeModeOptions(families: SpecRuntimeFamily[]): SpecRuntimeModeOption[];
 export declare function unsupportedModeTitle(family: SpecRuntimeFamily): string;
 export declare function unsupportedModeAvailability(family: SpecRuntimeFamily, mode: SpecRuntimeModeOption): RuntimeAvailability;
-export declare function backendForFamilyMode(families: SpecRuntimeFamily[], familyId: string, modeId: string): string;
-export declare function selectionForBackend(families: SpecRuntimeFamily[], backend: string | undefined): {
+export declare function modeForFamily(families: SpecRuntimeFamily[], familyId: string, modeId: string): string;
+export declare function selectionForMode(families: SpecRuntimeFamily[], mode: string | undefined, preferredFamily?: string | undefined): {
+    family: string;
+    mode: string;
+};
+export declare function familyForModel(families: SpecRuntimeFamily[], models: ChatModel[], modelId: string | undefined): SpecRuntimeFamily | undefined;
+export declare function selectionForRuntime(families: SpecRuntimeFamily[], mode: string | undefined, modelId: string | undefined, models: ChatModel[], preferredFamily?: string | undefined): {
     family: string;
     mode: string;
 };
-export declare function familyForBackend(families: SpecRuntimeFamily[], backend: string | undefined): SpecRuntimeFamily | undefined;
-export declare function modeForBackend(families: SpecRuntimeFamily[], backend: string | undefined): SpecRuntimeModeOption | undefined;
-export declare function labelForBackend(backend: string | undefined, families?: SpecRuntimeFamily[]): string;
-/** Lists selectable models by provider and declared backend support. */
-export declare function modelsForFamily(models: ChatModel[], family: SpecRuntimeFamily | undefined, backend?: string | undefined): ChatModel[];
+export declare function familyForMode(families: SpecRuntimeFamily[], mode: string | undefined, preferredFamily?: string | undefined): SpecRuntimeFamily | undefined;
+export declare function modeOptionFor(families: SpecRuntimeFamily[], mode: string | undefined, preferredFamily?: string | undefined): SpecRuntimeModeOption | undefined;
+export declare function labelForMode(mode: string | undefined, families?: SpecRuntimeFamily[]): string;
+/** Lists selectable models for one provider family. */
+export declare function modelsForFamily(models: ChatModel[], family: SpecRuntimeFamily | undefined, mode?: string | undefined): ChatModel[];
 /** Reports whether the first matching catalog identity belongs to the target family. */
-export declare function modelBelongsToFamily(modelId: string | undefined, models: ChatModel[], family: SpecRuntimeFamily | undefined, backend?: string | undefined): boolean;
-/** Resolves a target backend row, using a sole shared row as fallback. */
-export declare function modelForFamily(modelId: string | undefined, models: ChatModel[], family: SpecRuntimeFamily | undefined, backend?: string | undefined): ChatModel | undefined;
-/** Checks a model row's declared runtime backends when the catalog scopes it. */
-export declare function modelMatchesBackend(model: ChatModel, backend: string | undefined): boolean;
+export declare function modelBelongsToFamily(modelId: string | undefined, models: ChatModel[], family: SpecRuntimeFamily | undefined, mode?: string | undefined): boolean;
+/** Resolves a target mode row, using a sole shared row as fallback. */
+export declare function modelForFamily(modelId: string | undefined, models: ChatModel[], family: SpecRuntimeFamily | undefined, mode?: string | undefined): ChatModel | undefined;
 //# sourceMappingURL=runtime-mode.d.ts.map

package/dist/data/runtime/runtime-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-mode.d.ts","sourceRoot":"","sources":["../../../src/data/runtime/runtime-mode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-mode.d.ts","sourceRoot":"","sources":["../../../src/data/runtime/runtime-mode.ts"],"names":[],"mappings":"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"}