@swarmclawai/swarmclaw 1.7.1 → 1.7.2

package/src/components/layout/update-banner.tsx

@@ -1,22 +1,49 @@
 'use client'
 
 import { useEffect, useState } from 'react'
+import { safeStorageGet, safeStorageSet } from '@/lib/app/safe-storage'
 
 const CHECK_INTERVAL = 5 * 60_000 // 5 minutes
+const DISMISSED_UPDATE_KEY = 'sc_update_banner_dismissed_target'
 
 type VersionInfo = {
-  localSha: string
-  remoteSha: string
+  source: 'git' | 'package'
+  version: string
+  localSha: string | null
+  localTag: string | null
+  remoteSha: string | null
+  remoteTag: string | null
+  channel: 'stable' | 'main'
   updateAvailable: boolean
   behindBy: number
 }
 
+type UpdateResponse = {
+  success: boolean
+  newSha?: string
+  targetTag?: string | null
+  channel?: 'stable' | 'main'
+  needsRestart?: boolean
+  error?: string
+}
+
 type UpdateState = 'idle' | 'updating' | 'done' | 'error'
 
+function updateTargetKey(version: VersionInfo): string {
+  return version.remoteTag || version.remoteSha || `${version.channel}:${version.behindBy}`
+}
+
+function updateTargetLabel(version: VersionInfo): string {
+  if (version.remoteTag) return version.remoteTag
+  if (version.remoteSha) return `${version.channel === 'stable' ? 'stable release' : 'main'} ${version.remoteSha}`
+  return 'latest release'
+}
+
 export function UpdateBanner() {
   const [version, setVersion] = useState<VersionInfo | null>(null)
   const [updateState, setUpdateState] = useState<UpdateState>('idle')
-  const [dismissed, setDismissed] = useState<string | null>(null)
+  const [dismissed, setDismissed] = useState<string | null>(() => safeStorageGet(DISMISSED_UPDATE_KEY))
+  const [appliedTarget, setAppliedTarget] = useState<string | null>(null)
   const [errorMsg, setErrorMsg] = useState('')
 
   useEffect(() => {
@@ -36,8 +63,9 @@ export function UpdateBanner() {
     setErrorMsg('')
     try {
       const res = await fetch('/api/version/update', { method: 'POST' })
-      const data = await res.json()
+      const data = await res.json() as UpdateResponse
       if (data.success) {
+        setAppliedTarget(data.targetTag || data.newSha || (version ? updateTargetLabel(version) : null))
         setUpdateState('done')
       } else {
         setUpdateState('error')
@@ -50,12 +78,17 @@ export function UpdateBanner() {
   }
 
   const handleDismiss = () => {
-    if (version) setDismissed(version.remoteSha)
+    if (!version) return
+    const target = updateTargetKey(version)
+    setDismissed(target)
+    safeStorageSet(DISMISSED_UPDATE_KEY, target)
   }
 
   // Don't show if no update, or user dismissed this specific remote SHA
   if (!version?.updateAvailable) return null
-  if (dismissed === version.remoteSha && updateState === 'idle') return null
+  if (dismissed === updateTargetKey(version) && updateState === 'idle') return null
+
+  const targetLabel = updateTargetLabel(version)
 
   return (
     <div className="px-4 py-1.5 border-b border-white/[0.04] text-[10px] flex items-center gap-2 shrink-0 bg-accent-bright/[0.04]">
@@ -65,7 +98,8 @@ export function UpdateBanner() {
             <path d="M12 19V5M5 12l7-7 7 7" />
           </svg>
           <span className="text-text-3 flex-1 min-w-0 truncate">
-            <span className="text-accent-bright font-600">{version.behindBy}</span> update{version.behindBy !== 1 ? 's' : ''} available
+            <span className="text-accent-bright font-600">{targetLabel}</span> available
+            {version.behindBy > 0 ? ` - ${version.behindBy} commit${version.behindBy === 1 ? '' : 's'} ahead` : ''}
           </span>
           <button
             onClick={handleUpdate}
@@ -90,7 +124,7 @@ export function UpdateBanner() {
         <>
           <span className="w-3 h-3 border-[1.5px] border-accent-bright/30 border-t-accent-bright rounded-full shrink-0"
             style={{ animation: 'spin 0.8s linear infinite' }} />
-          <span className="text-text-3">Updating...</span>
+          <span className="text-text-3">Updating to {targetLabel}...</span>
         </>
       )}
 
@@ -99,7 +133,7 @@ export function UpdateBanner() {
           <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" className="text-success shrink-0">
             <polyline points="20 6 9 17 4 12" />
           </svg>
-          <span className="text-text-3 flex-1">Updated! Restart to apply.</span>
+          <span className="text-text-3 flex-1">Updated{appliedTarget ? ` to ${appliedTarget}` : ''}. Restart SwarmClaw to apply.</span>
         </>
       )}
 

package/src/lib/provider-sets.test.ts

@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { GENERIC_CLI_PROVIDER_METADATA } from './providers/cli-provider-metadata'
+import {
+  NATIVE_CAPABILITY_PROVIDER_IDS,
+  NON_LANGGRAPH_PROVIDER_IDS,
+  WORKER_ONLY_PROVIDER_IDS,
+} from './provider-sets'
+
+describe('provider sets', () => {
+  it('routes generic CLI providers through direct provider runtime', () => {
+    for (const provider of GENERIC_CLI_PROVIDER_METADATA) {
+      assert.equal(NON_LANGGRAPH_PROVIDER_IDS.has(provider.id), true, `${provider.id} should bypass LangGraph`)
+      assert.equal(NATIVE_CAPABILITY_PROVIDER_IDS.has(provider.id), true, `${provider.id} should be native-capability`)
+      assert.equal(WORKER_ONLY_PROVIDER_IDS.has(provider.id), true, `${provider.id} should be worker-only`)
+    }
+  })
+})

package/src/lib/provider-sets.ts

@@ -1,14 +1,19 @@
+import { CLI_PROVIDER_METADATA } from '@/lib/providers/cli-provider-metadata'
+
+const CLI_PROVIDER_IDS = CLI_PROVIDER_METADATA.map((provider) => provider.id)
+const DIRECT_CLI_PROVIDER_IDS = CLI_PROVIDER_IDS.filter((providerId) => providerId !== 'goose')
+
 /** CLI providers that use their own tool execution outside the shared tool-runtime path. */
-export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'opencode-web', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli'])
+export const NON_LANGGRAPH_PROVIDER_IDS = new Set([...DIRECT_CLI_PROVIDER_IDS, 'opencode-web'])
 
 /** Providers that manage their own runtime/tool loop even when reached over an API endpoint. */
 export const RUNTIME_MANAGED_PROVIDER_IDS = new Set(['hermes', 'goose'])
 
 /** Providers with native tool/capability support (CLI providers + OpenClaw + Hermes). */
-export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set([...CLI_PROVIDER_IDS, 'openclaw', 'hermes'])
 
 /** Providers that can only act as workers — no coordinator role, no heartbeat, no advanced settings. */
-export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const WORKER_ONLY_PROVIDER_IDS = new Set([...CLI_PROVIDER_IDS, 'openclaw', 'hermes'])
 
 /** CLI providers that support MCP server and skill injection at runtime (via provider-specific config mechanisms). */
 export const MCP_INJECTION_PROVIDER_IDS = new Set(['copilot-cli', 'codex-cli'])

package/src/lib/providers/cli-provider-metadata.test.ts

@@ -0,0 +1,38 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import {
+  BESPOKE_CLI_PROVIDER_METADATA,
+  CLI_PROVIDER_METADATA,
+  CLI_PROVIDER_METADATA_BY_ID,
+  GENERIC_CLI_PROVIDER_METADATA,
+  isCliProviderId,
+} from './cli-provider-metadata'
+import { GENERIC_CLI_BINARIES } from './generic-cli'
+import { CLI_PROVIDER_CAPABILITIES } from './cli-utils'
+
+describe('CLI provider metadata', () => {
+  it('has one unique entry per CLI provider', () => {
+    const ids = CLI_PROVIDER_METADATA.map((provider) => provider.id)
+    assert.equal(new Set(ids).size, ids.length)
+    assert.ok(BESPOKE_CLI_PROVIDER_METADATA.length > 0)
+    assert.equal(GENERIC_CLI_PROVIDER_METADATA.length, 31)
+  })
+
+  it('drives binary and capability maps for every provider', () => {
+    for (const provider of CLI_PROVIDER_METADATA) {
+      assert.equal(CLI_PROVIDER_METADATA_BY_ID[provider.id]?.displayName, provider.displayName)
+      assert.equal(isCliProviderId(provider.id), true)
+      assert.equal(CLI_PROVIDER_CAPABILITIES[provider.id], provider.capability)
+      assert.ok(provider.binaryName.length > 0)
+      assert.ok(provider.defaultModel.length > 0)
+    }
+  })
+
+  it('keeps generic CLI binary mappings sourced from metadata', () => {
+    assert.deepEqual(
+      Object.fromEntries(GENERIC_CLI_PROVIDER_METADATA.map((provider) => [provider.id, provider.binaryName])),
+      GENERIC_CLI_BINARIES,
+    )
+  })
+})

package/src/lib/providers/cli-provider-metadata.ts

@@ -0,0 +1,208 @@
+import type { ProviderType } from '../../types/provider.ts'
+
+export type CliAuthBackend =
+  | 'claude'
+  | 'codex'
+  | 'opencode'
+  | 'gemini'
+  | 'copilot'
+  | 'droid'
+  | 'cursor'
+  | 'qwen'
+  | 'goose'
+
+export interface CliProviderMetadata {
+  id: ProviderType
+  displayName: string
+  binaryName: string
+  capability: string
+  description: string
+  defaultModel: string
+  icon: string
+  setupBadge: string
+  generic: boolean
+  optionalApiKey?: boolean
+  authBackend?: CliAuthBackend
+  keyUrl?: string
+  keyLabel?: string
+  keyPlaceholder?: string
+  modelLibraryUrl?: string
+}
+
+export const BESPOKE_CLI_PROVIDER_METADATA = [
+  {
+    id: 'claude-cli',
+    displayName: 'Claude Code CLI',
+    binaryName: 'claude',
+    capability: 'multi-file code editing, refactoring, debugging, code review',
+    description: "Anthropic's coding agent with native tools, strong edits, and first-class CLI workflows.",
+    defaultModel: 'claude-sonnet-4-6',
+    icon: 'C',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'claude',
+    modelLibraryUrl: 'https://docs.anthropic.com/en/docs/about-claude/models',
+  },
+  {
+    id: 'codex-cli',
+    displayName: 'OpenAI Codex CLI',
+    binaryName: 'codex',
+    capability: 'code generation, file creation, automated coding tasks',
+    description: "OpenAI's terminal coding agent with resume support and structured headless output.",
+    defaultModel: 'gpt-5.4-codex',
+    icon: 'O',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'codex',
+    modelLibraryUrl: 'https://platform.openai.com/docs/models',
+  },
+  {
+    id: 'opencode-cli',
+    displayName: 'OpenCode CLI',
+    binaryName: 'opencode',
+    capability: 'code analysis, generation across multiple LLM backends',
+    description: 'A flexible coding CLI that can route across multiple model backends.',
+    defaultModel: 'claude-sonnet-4-6',
+    icon: 'O',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'opencode',
+  },
+  {
+    id: 'gemini-cli',
+    displayName: 'Gemini CLI',
+    binaryName: 'gemini',
+    capability: 'code generation, analysis with Gemini models',
+    description: "Google's terminal coding agent with project-aware headless mode and resume support.",
+    defaultModel: 'gemini-3.1-pro',
+    icon: 'G',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'gemini',
+    modelLibraryUrl: 'https://ai.google.dev/gemini-api/docs/models',
+  },
+  {
+    id: 'copilot-cli',
+    displayName: 'GitHub Copilot CLI',
+    binaryName: 'copilot',
+    capability: 'code generation, analysis, multi-model support via GitHub Copilot',
+    description: "GitHub's multi-model terminal agent for coding and automation.",
+    defaultModel: 'claude-sonnet-4-6',
+    icon: 'P',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'copilot',
+  },
+  {
+    id: 'droid-cli',
+    displayName: 'Factory Droid CLI',
+    binaryName: 'droid',
+    capability: 'code generation, refactoring, and automation via Factory Droid with configurable autonomy',
+    description: "Factory.ai's terminal coding agent with headless exec mode, session resume, and autonomy controls.",
+    defaultModel: 'default',
+    icon: 'F',
+    setupBadge: 'CLI',
+    generic: false,
+    optionalApiKey: true,
+    authBackend: 'droid',
+    keyUrl: 'https://app.factory.ai/settings/api-keys',
+    keyLabel: 'app.factory.ai',
+    keyPlaceholder: 'FACTORY_API_KEY (optional if signed in via `droid`)',
+  },
+  {
+    id: 'cursor-cli',
+    displayName: 'Cursor Agent CLI',
+    binaryName: 'cursor-agent',
+    capability: 'full-agent coding workflows, multi-file edits, project-aware code changes',
+    description: "Cursor's terminal agent with resume support, JSON output, and Cursor-native coding workflows.",
+    defaultModel: 'auto',
+    icon: 'U',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'cursor',
+  },
+  {
+    id: 'qwen-code-cli',
+    displayName: 'Qwen Code CLI',
+    binaryName: 'qwen',
+    capability: 'terminal-native coding workflows, code generation, review, and automation',
+    description: "Qwen's terminal coding agent with structured headless mode and multi-provider model config.",
+    defaultModel: 'default',
+    icon: 'Q',
+    setupBadge: 'CLI',
+    generic: false,
+    authBackend: 'qwen',
+  },
+  {
+    id: 'goose',
+    displayName: 'Goose',
+    binaryName: 'goose',
+    capability: 'agentic coding workflows with extensions, tools, and runtime-managed execution',
+    description: 'A runtime-managed terminal agent with extensions, session history, and ACP support.',
+    defaultModel: 'default',
+    icon: 'G',
+    setupBadge: 'Runtime',
+    generic: false,
+    optionalApiKey: true,
+    authBackend: 'goose',
+  },
+] as const satisfies readonly CliProviderMetadata[]
+
+export const GENERIC_CLI_PROVIDER_METADATA = [
+  ['aider-cli', 'Aider CLI', 'aider', 'paired-programming-style multi-file edits and git-aware code changes'],
+  ['amp-cli', 'Amp CLI', 'amp', 'agentic coding via Sourcegraph Amp'],
+  ['augment-cli', 'Augment CLI', 'augment', 'codebase-aware agentic edits via Augment'],
+  ['adal-cli', 'AdaL CLI', 'adal', 'AdaL coding agent for terminal-driven workflows'],
+  ['bob-cli', 'IBM Bob CLI', 'bob', 'IBM watsonx Code Assistant terminal coding workflows'],
+  ['cline-cli', 'Cline CLI', 'cline', 'autonomous file-level edits and terminal automation via Cline'],
+  ['codebuddy-cli', 'CodeBuddy CLI', 'codebuddy', 'CodeBuddy agentic coding workflows'],
+  ['command-code-cli', 'Command Code CLI', 'commandcode', 'Command Code terminal-native coding agent'],
+  ['continue-cli', 'Continue CLI', 'continue', 'agentic coding via the Continue CLI'],
+  ['cortex-cli', 'Cortex Code CLI', 'cortex', 'Snowflake Cortex Code agentic workflows'],
+  ['crush-cli', 'Crush CLI', 'crush', 'Crush terminal coding agent'],
+  ['deepagents-cli', 'Deep Agents CLI', 'deepagents', 'long-horizon planning and multi-step coding via Deep Agents'],
+  ['firebender-cli', 'Firebender CLI', 'firebender', 'Firebender JetBrains-aligned coding agent'],
+  ['iflow-cli', 'iFlow CLI', 'iflow', 'iFlow CLI agentic coding workflows'],
+  ['junie-cli', 'Junie CLI', 'junie', 'JetBrains Junie coding agent for terminal use'],
+  ['kilo-code-cli', 'Kilo Code CLI', 'kilocode', 'Kilo Code agentic coding workflows'],
+  ['kimi-cli', 'Kimi CLI', 'kimi', 'Kimi Code CLI coding agent'],
+  ['kode-cli', 'Kode CLI', 'kode', 'Kode terminal coding agent'],
+  ['mcpjam-cli', 'MCPJam CLI', 'mcpjam', 'MCPJam-tooled agentic coding workflows'],
+  ['mistral-vibe-cli', 'Mistral Vibe CLI', 'vibe', 'Mistral Vibe coding agent'],
+  ['mux-cli', 'Mux CLI', 'mux', 'Mux multi-tool coding agent'],
+  ['neovate-cli', 'Neovate CLI', 'neovate', 'Neovate coding agent for terminal workflows'],
+  ['openhands-cli', 'OpenHands CLI', 'openhands', 'OpenHands agentic coding via terminal'],
+  ['pochi-cli', 'Pochi CLI', 'pochi', 'Pochi coding agent'],
+  ['qoder-cli', 'Qoder CLI', 'qoder', 'Qoder agentic coding workflows'],
+  ['replit-cli', 'Replit Agent CLI', 'replit', 'Replit Agent terminal coding workflows'],
+  ['roo-code-cli', 'Roo Code CLI', 'roo', 'Roo Code agentic coding workflows'],
+  ['trae-cn-cli', 'TRAE CN CLI', 'trae-cn', 'TRAE CN coding agent'],
+  ['warp-cli', 'Warp Agent CLI', 'warp', 'Warp Agent terminal-native coding workflows'],
+  ['windsurf-cli', 'Windsurf CLI', 'windsurf', 'Windsurf agentic coding workflows'],
+  ['zencoder-cli', 'Zencoder CLI', 'zencoder', 'Zencoder agentic coding workflows'],
+].map(([id, displayName, binaryName, capability]) => ({
+  id: id as ProviderType,
+  displayName,
+  binaryName,
+  capability,
+  description: `${displayName}: ${capability}.`,
+  defaultModel: 'default',
+  icon: displayName.charAt(0),
+  setupBadge: 'CLI',
+  generic: true,
+  optionalApiKey: true,
+})) satisfies readonly CliProviderMetadata[]
+
+export const CLI_PROVIDER_METADATA = [
+  ...BESPOKE_CLI_PROVIDER_METADATA,
+  ...GENERIC_CLI_PROVIDER_METADATA,
+] as const satisfies readonly CliProviderMetadata[]
+
+export type CliProviderId = (typeof CLI_PROVIDER_METADATA)[number]['id']
+
+export const CLI_PROVIDER_METADATA_BY_ID: Record<string, CliProviderMetadata> =
+  Object.fromEntries(CLI_PROVIDER_METADATA.map((provider) => [provider.id, provider]))
+
+export function isCliProviderId(providerId: string): providerId is CliProviderId {
+  return providerId in CLI_PROVIDER_METADATA_BY_ID
+}

package/src/lib/providers/cli-utils.ts

@@ -12,6 +12,7 @@ import path from 'path'
 import { spawnSync, type ChildProcess } from 'child_process'
 import { realpathSync } from 'fs'
 import { log } from '../server/logger'
+import { CLI_PROVIDER_METADATA, CLI_PROVIDER_METADATA_BY_ID } from './cli-provider-metadata'
 
 // ---------------------------------------------------------------------------
 // Binary Discovery
@@ -468,50 +469,10 @@ export function symlinkConfigFiles(
 // ---------------------------------------------------------------------------
 
 /** Human-readable descriptions of what each CLI provider excels at. */
-export const CLI_PROVIDER_CAPABILITIES: Record<string, string> = {
-  'claude-cli': 'multi-file code editing, refactoring, debugging, code review',
-  'codex-cli': 'code generation, file creation, automated coding tasks',
-  'opencode-cli': 'code analysis, generation across multiple LLM backends',
-  'gemini-cli': 'code generation, analysis with Gemini models',
-  'copilot-cli': 'code generation, analysis, multi-model support via GitHub Copilot',
-  'droid-cli': 'code generation, refactoring, and automation via Factory Droid with configurable autonomy',
-  'cursor-cli': 'full-agent coding workflows, multi-file edits, project-aware code changes',
-  'qwen-code-cli': 'terminal-native coding workflows, code generation, review, and automation',
-  goose: 'agentic coding workflows with extensions, tools, and runtime-managed execution',
-  'aider-cli': 'paired-programming-style multi-file edits and git-aware code changes',
-  'amp-cli': 'agentic coding via Sourcegraph Amp',
-  'augment-cli': 'codebase-aware agentic edits via Augment',
-  'adal-cli': 'AdaL coding agent for terminal-driven workflows',
-  'bob-cli': 'IBM watsonx Code Assistant (Bob) terminal coding workflows',
-  'cline-cli': 'autonomous file-level edits and terminal automation via Cline',
-  'codebuddy-cli': 'CodeBuddy agentic coding workflows',
-  'command-code-cli': 'Command Code terminal-native coding agent',
-  'continue-cli': 'agentic coding via the Continue CLI',
-  'cortex-cli': 'Snowflake Cortex Code agentic workflows',
-  'crush-cli': 'Crush terminal coding agent',
-  'deepagents-cli': 'long-horizon planning and multi-step coding via Deep Agents',
-  'firebender-cli': 'Firebender JetBrains-aligned coding agent',
-  'iflow-cli': 'iFlow CLI agentic coding workflows',
-  'junie-cli': 'JetBrains Junie coding agent for terminal use',
-  'kilo-code-cli': 'Kilo Code agentic coding workflows',
-  'kimi-cli': 'Kimi Code CLI coding agent',
-  'kode-cli': 'Kode terminal coding agent',
-  'mcpjam-cli': 'MCPJam-tooled agentic coding workflows',
-  'mistral-vibe-cli': 'Mistral Vibe coding agent',
-  'mux-cli': 'Mux multi-tool coding agent',
-  'neovate-cli': 'Neovate coding agent for terminal workflows',
-  'openhands-cli': 'OpenHands agentic coding via terminal',
-  'pochi-cli': 'Pochi coding agent',
-  'qoder-cli': 'Qoder agentic coding workflows',
-  'replit-cli': 'Replit Agent terminal coding workflows',
-  'roo-code-cli': 'Roo Code agentic coding workflows',
-  'trae-cn-cli': 'TRAE CN coding agent',
-  'warp-cli': 'Warp Agent terminal-native coding workflows',
-  'windsurf-cli': 'Windsurf agentic coding workflows',
-  'zencoder-cli': 'Zencoder agentic coding workflows',
-}
+export const CLI_PROVIDER_CAPABILITIES: Record<string, string> =
+  Object.fromEntries(CLI_PROVIDER_METADATA.map((provider) => [provider.id, provider.capability]))
 
 /** Check if a provider ID is a CLI-based provider. */
 export function isCliProvider(providerId: string): boolean {
-  return providerId in CLI_PROVIDER_CAPABILITIES
+  return providerId in CLI_PROVIDER_METADATA_BY_ID
 }

package/src/lib/providers/generic-cli.ts

@@ -2,6 +2,7 @@ import { spawn } from 'child_process'
 import type { StreamChatOptions } from './index'
 import { log } from '../server/logger'
 import { loadRuntimeSettings } from '@/lib/server/runtime/runtime-settings'
+import { GENERIC_CLI_PROVIDER_METADATA } from './cli-provider-metadata'
 import { resolveCliBinary, buildCliEnv, attachAbortHandler, isStderrNoise } from './cli-utils'
 
 /**
@@ -9,37 +10,7 @@ import { resolveCliBinary, buildCliEnv, attachAbortHandler, isStderrNoise } from
  * Used by the generic CLI streamer for tools without a bespoke handler.
  */
 export const GENERIC_CLI_BINARIES: Record<string, string> = {
-  'aider-cli': 'aider',
-  'amp-cli': 'amp',
-  'augment-cli': 'augment',
-  'adal-cli': 'adal',
-  'bob-cli': 'bob',
-  'cline-cli': 'cline',
-  'codebuddy-cli': 'codebuddy',
-  'command-code-cli': 'commandcode',
-  'continue-cli': 'continue',
-  'cortex-cli': 'cortex',
-  'crush-cli': 'crush',
-  'deepagents-cli': 'deepagents',
-  'firebender-cli': 'firebender',
-  'iflow-cli': 'iflow',
-  'junie-cli': 'junie',
-  'kilo-code-cli': 'kilocode',
-  'kimi-cli': 'kimi',
-  'kode-cli': 'kode',
-  'mcpjam-cli': 'mcpjam',
-  'mistral-vibe-cli': 'vibe',
-  'mux-cli': 'mux',
-  'neovate-cli': 'neovate',
-  'openhands-cli': 'openhands',
-  'pochi-cli': 'pochi',
-  'qoder-cli': 'qoder',
-  'replit-cli': 'replit',
-  'roo-code-cli': 'roo',
-  'trae-cn-cli': 'trae-cn',
-  'warp-cli': 'warp',
-  'windsurf-cli': 'windsurf',
-  'zencoder-cli': 'zencoder',
+  ...Object.fromEntries(GENERIC_CLI_PROVIDER_METADATA.map((provider) => [provider.id, provider.binaryName])),
 }
 
 interface GenericCliOptions extends StreamChatOptions {

package/src/lib/providers/index.ts

@@ -8,7 +8,8 @@ import { streamDroidCliChat } from './droid-cli'
 import { streamCursorCliChat } from './cursor-cli'
 import { streamQwenCodeCliChat } from './qwen-code-cli'
 import { streamGooseChat } from './goose'
-import { streamGenericCliChat, GENERIC_CLI_BINARIES } from './generic-cli'
+import { streamGenericCliChat } from './generic-cli'
+import { GENERIC_CLI_PROVIDER_METADATA, isCliProviderId } from './cli-provider-metadata'
 import { streamOpenAiChat } from './openai'
 import { streamOllamaChat } from './ollama'
 import { streamAnthropicChat } from './anthropic'
@@ -52,53 +53,22 @@ interface BuiltinProviderConfig extends ProviderInfo {
   handler: ProviderHandler
 }
 
-const GENERIC_CLI_DISPLAY_NAMES: Record<string, string> = {
-  'aider-cli': 'Aider CLI',
-  'amp-cli': 'Amp CLI',
-  'augment-cli': 'Augment CLI',
-  'adal-cli': 'AdaL CLI',
-  'bob-cli': 'IBM Bob CLI',
-  'cline-cli': 'Cline CLI',
-  'codebuddy-cli': 'CodeBuddy CLI',
-  'command-code-cli': 'Command Code CLI',
-  'continue-cli': 'Continue CLI',
-  'cortex-cli': 'Cortex Code CLI',
-  'crush-cli': 'Crush CLI',
-  'deepagents-cli': 'Deep Agents CLI',
-  'firebender-cli': 'Firebender CLI',
-  'iflow-cli': 'iFlow CLI',
-  'junie-cli': 'Junie CLI',
-  'kilo-code-cli': 'Kilo Code CLI',
-  'kimi-cli': 'Kimi Code CLI',
-  'kode-cli': 'Kode CLI',
-  'mcpjam-cli': 'MCPJam CLI',
-  'mistral-vibe-cli': 'Mistral Vibe CLI',
-  'mux-cli': 'Mux CLI',
-  'neovate-cli': 'Neovate CLI',
-  'openhands-cli': 'OpenHands CLI',
-  'pochi-cli': 'Pochi CLI',
-  'qoder-cli': 'Qoder CLI',
-  'replit-cli': 'Replit Agent CLI',
-  'roo-code-cli': 'Roo Code CLI',
-  'trae-cn-cli': 'TRAE CN CLI',
-  'warp-cli': 'Warp Agent CLI',
-  'windsurf-cli': 'Windsurf CLI',
-  'zencoder-cli': 'Zencoder CLI',
-}
-
 function buildGenericCliEntries(): Record<string, BuiltinProviderConfig> {
   const entries: Record<string, BuiltinProviderConfig> = {}
-  for (const [providerId, binaryName] of Object.entries(GENERIC_CLI_BINARIES)) {
-    const displayName = GENERIC_CLI_DISPLAY_NAMES[providerId] ?? providerId
-    entries[providerId] = {
-      id: providerId,
-      name: displayName,
-      models: ['default'],
+  for (const provider of GENERIC_CLI_PROVIDER_METADATA) {
+    entries[provider.id] = {
+      id: provider.id,
+      name: provider.displayName,
+      models: [provider.defaultModel],
       requiresApiKey: false,
-      optionalApiKey: true,
+      optionalApiKey: provider.optionalApiKey,
       requiresEndpoint: false,
       handler: {
-        streamChat: (opts) => streamGenericCliChat({ ...opts, binaryName, displayName }),
+        streamChat: (opts) => streamGenericCliChat({
+          ...opts,
+          binaryName: provider.binaryName,
+          displayName: provider.displayName,
+        }),
       },
     }
   }
@@ -530,7 +500,7 @@ export function getProviderList(): ProviderInfo[] {
         ...info,
         models: overrides[info.id] || info.models,
         defaultModels: info.models,
-        supportsModelDiscovery: !['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'fireworks', ...Object.keys(GENERIC_CLI_BINARIES)].includes(info.id),
+        supportsModelDiscovery: !isCliProviderId(info.id) && info.id !== 'fireworks',
       }
     })
   

package/src/lib/server/cli-provider-readiness.test.ts

@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { checkCliProviderReady } from './cli-provider-readiness'
+
+describe('checkCliProviderReady', () => {
+  it('accepts a generic CLI provider when its binary is present', () => {
+    const result = checkCliProviderReady('aider-cli', {
+      resolveBinary: (name) => name === 'aider' ? '/usr/local/bin/aider' : null,
+    })
+
+    assert.equal(result.ok, true)
+    assert.equal(result.displayName, 'Aider CLI')
+    assert.equal(result.binaryName, 'aider')
+    assert.equal(result.generic, true)
+    assert.match(result.message, /binary is available/)
+  })
+
+  it('reports a missing generic CLI binary with install guidance', () => {
+    const result = checkCliProviderReady('windsurf-cli', {
+      resolveBinary: () => null,
+    })
+
+    assert.equal(result.ok, false)
+    assert.equal(result.displayName, 'Windsurf CLI')
+    assert.equal(result.binaryName, 'windsurf')
+    assert.match(result.message, /Install `windsurf`/)
+  })
+
+  it('keeps auth-aware checks for bespoke CLI providers', () => {
+    const result = checkCliProviderReady('claude-cli', {
+      resolveBinary: () => '/usr/local/bin/claude',
+      env: { ...process.env },
+      probeAuth: () => ({
+        authenticated: false,
+        errorMessage: 'Claude CLI is not authenticated.',
+      }),
+    })
+
+    assert.equal(result.ok, false)
+    assert.equal(result.displayName, 'Claude Code CLI')
+    assert.equal(result.generic, false)
+    assert.equal(result.message, 'Claude CLI is not authenticated.')
+  })
+})