@swarmclawai/swarmclaw 1.7.1 → 1.7.3

package/README.md

@@ -399,6 +399,24 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.7.3 Highlights
+
+Desktop packaging fix for Linux AppImage and deb builds.
+
+- **Linux desktop native modules match Electron.** Packaged Linux builds now copy Electron-rebuilt native addons into the embedded Next standalone server, fixing the `better-sqlite3` Node ABI mismatch reported in [#65](https://github.com/swarmclawai/swarmclaw/issues/65).
+- **Desktop packaging regression coverage.** The Electron `afterPack` hook now has a Linux standalone native-module sync test wired into `npm run test:cli`.
+- **macOS desktop note.** macOS builds remain ad-hoc signed and not notarized in this release, so the existing Gatekeeper/quarantine workaround still applies until Developer ID signing is available.
+
+### v1.7.2 Highlights
+
+CLI provider usability follow-up for v1.7.0/v1.7.1. The expanded coding-agent roster is now easier to find, configure, and validate from onboarding and setup diagnostics.
+
+- **Shared CLI provider registry.** Bespoke and generic CLI providers now share one metadata source for display names, binary names, capabilities, setup defaults, and provider-set behavior, reducing drift across onboarding, runtime routing, setup doctor, and capability prompts.
+- **Onboarding exposes the full CLI roster.** The setup wizard groups providers by CLI agents, gateways/local runtimes, API providers, and custom endpoints, with search so the 31 extended CLI providers added in v1.7 are usable without digging through settings.
+- **Connection checks for every CLI provider.** Bespoke CLIs keep auth-aware checks, while generic CLIs verify that the expected binary is on PATH and return actionable install guidance when missing.
+- **Update banner polish.** Source installs now show the target stable tag/version, remember dismissal per release target, and make the required restart after update explicit.
+- **macOS desktop note.** macOS builds remain ad-hoc signed and not notarized in this release, so the existing Gatekeeper/quarantine workaround still applies until Developer ID signing is available.
+
 ### v1.7.1 Highlights
 
 Republish of v1.7.0 from the correct commit. The v1.7.0 tarball on npm was inadvertently published from a pre-rebase tree that did not include the v1.6.1 codex continuity fixes (PR #62) or the v1.6.2 plan doc. v1.7.1 ships the same coding-agent-roster expansion on top of the correct v1.6.1+ history.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -84,10 +84,10 @@
     "lint:baseline": "node ./scripts/lint-baseline.mjs check",
     "lint:baseline:update": "node ./scripts/lint-baseline.mjs update",
     "cli": "node ./bin/swarmclaw.js",
-    "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
+    "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/scripts/run-next-build.mjs

@@ -11,7 +11,7 @@ import { ensureBuildBootstrapPaths } from './build-bootstrap-env.mjs'
 
 const require = createRequire(import.meta.url)
 
-export const DEFAULT_MAX_OLD_SPACE_SIZE_MB = '8192'
+export const DEFAULT_MAX_OLD_SPACE_SIZE_MB = '12288'
 export const MIN_MAX_OLD_SPACE_SIZE_MB = 1024
 export const FALLBACK_MIN_MAX_OLD_SPACE_SIZE_MB = 512
 export const RESERVED_BUILD_MEMORY_MB = 768

package/src/app/api/setup/check-provider/route.ts

@@ -2,39 +2,12 @@ import { NextResponse } from 'next/server'
 import { loadCredentials, decryptKey, loadProviderConfigs } from '@/lib/server/storage'
 import { listCredentialIdsByProvider } from '@/lib/server/credentials/credential-service'
 import { getDeviceId, wsConnect, rpcOnConnectedGateway } from '@/lib/providers/openclaw'
-import { buildCliEnv, probeCliAuth, resolveCliBinary } from '@/lib/providers/cli-utils'
+import { isCliProviderId } from '@/lib/providers/cli-provider-metadata'
+import { checkCliProviderReady } from '@/lib/server/cli-provider-readiness'
 import { OPENAI_COMPATIBLE_DEFAULTS } from '@/lib/server/provider-health'
 import { resolveOllamaRuntimeConfig } from '@/lib/server/ollama-runtime'
 import { normalizeOllamaSetupEndpoint, normalizeOpenClawUrl, parseErrorMessage } from './helpers'
 
-type SetupProvider =
-  | 'claude-cli'
-  | 'codex-cli'
-  | 'opencode-cli'
-  | 'gemini-cli'
-  | 'copilot-cli'
-  | 'droid-cli'
-  | 'cursor-cli'
-  | 'qwen-code-cli'
-  | 'goose'
-  | 'openai'
-  | 'openrouter'
-  | 'anthropic'
-  | 'google'
-  | 'deepseek'
-  | 'groq'
-  | 'together'
-  | 'mistral'
-  | 'xai'
-  | 'fireworks'
-  | 'nebius'
-  | 'deepinfra'
-  | 'ollama'
-  | 'openclaw'
-  | 'hermes'
-
-type CliSetupProvider = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'droid-cli' | 'cursor-cli' | 'qwen-code-cli' | 'goose'
-
 interface SetupCheckBody {
   provider?: string
   apiKey?: string
@@ -280,43 +253,13 @@ async function checkOpenClaw(apiKey: string, endpointRaw: string): Promise<{ ok:
   return { ok: true, message: 'Connected to OpenClaw gateway.', normalizedEndpoint, deviceId, recommendedModel }
 }
 
-function checkCliProvider(provider: CliSetupProvider): { ok: boolean; message: string } {
-  const env = buildCliEnv()
-  const config = {
-    'claude-cli': { binary: 'claude', backend: 'claude' as const, label: 'Claude Code CLI' },
-    'codex-cli': { binary: 'codex', backend: 'codex' as const, label: 'OpenAI Codex CLI' },
-    'opencode-cli': { binary: 'opencode', backend: 'opencode' as const, label: 'OpenCode CLI' },
-    'gemini-cli': { binary: 'gemini', backend: 'gemini' as const, label: 'Gemini CLI' },
-    'copilot-cli': { binary: 'copilot', backend: 'copilot' as const, label: 'GitHub Copilot CLI' },
-    'droid-cli': { binary: 'droid', backend: 'droid' as const, label: 'Factory Droid CLI' },
-    'cursor-cli': { binary: 'cursor-agent', backend: 'cursor' as const, label: 'Cursor Agent CLI' },
-    'qwen-code-cli': { binary: 'qwen', backend: 'qwen' as const, label: 'Qwen Code CLI' },
-    goose: { binary: 'goose', backend: 'goose' as const, label: 'Goose CLI' },
-  }[provider]
-
-  if (!config) return { ok: false, message: 'Unknown CLI provider.' }
-  const binary = resolveCliBinary(config.binary)
-  if (!binary) {
-    return {
-      ok: false,
-      message: `${config.label} is not installed. Install \`${config.binary}\` and ensure it is on your PATH.`,
-    }
-  }
-  const auth = probeCliAuth(binary, config.backend, env, process.cwd())
-  if (!auth.authenticated) {
-    return { ok: false, message: auth.errorMessage || `${config.label} is not configured.` }
-  }
-  return { ok: true, message: `${config.label} is installed and ready.` }
-}
-
 export async function POST(req: Request) {
   const body = parseBody(await req.json().catch(() => ({})))
-  const provider = clean(body.provider) as SetupProvider
+  const provider = clean(body.provider)
   let apiKey = clean(body.apiKey)
   const credentialId = clean(body.credentialId)
   let endpoint = clean(body.endpoint)
   const model = clean(body.model)
-  const CLI_PROVIDERS = new Set<CliSetupProvider>(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose'])
 
   // Resolve credentialId to an API key if no raw key was provided
   if (!apiKey && credentialId) {
@@ -355,8 +298,8 @@ export async function POST(req: Request) {
     } catch { /* best effort */ }
   }
 
-  if (CLI_PROVIDERS.has(provider as CliSetupProvider)) {
-    const result = checkCliProvider(provider as CliSetupProvider)
+  if (isCliProviderId(provider)) {
+    const result = checkCliProviderReady(provider)
     return NextResponse.json(result)
   }
 

package/src/app/api/setup/doctor/route.ts

@@ -6,6 +6,7 @@ import { DATA_DIR } from '@/lib/server/data-dir'
 import { loadAgents, loadCredentials, loadSettings, loadCollection } from '@/lib/server/storage'
 import { dedup, errorMessage } from '@/lib/shared-utils'
 import { detectDocker } from '@/lib/server/sandbox/docker-detect'
+import { BESPOKE_CLI_PROVIDER_METADATA, GENERIC_CLI_PROVIDER_METADATA } from '@/lib/providers/cli-provider-metadata'
 
 type CheckStatus = 'pass' | 'warn' | 'fail'
 
@@ -198,15 +199,11 @@ export async function GET(req: Request) {
   } catch { /* best-effort */ }
 
   const optionalBinaries: Array<{ id: string; label: string; command: string }> = [
-    { id: 'claude-cli', label: 'Claude Code CLI', command: 'claude' },
-    { id: 'codex-cli', label: 'OpenAI Codex CLI', command: 'codex' },
-    { id: 'opencode-cli', label: 'OpenCode CLI', command: 'opencode' },
-    { id: 'gemini-cli', label: 'Gemini CLI', command: 'gemini' },
-    { id: 'copilot-cli', label: 'GitHub Copilot CLI', command: 'copilot' },
-    { id: 'droid-cli', label: 'Factory Droid CLI', command: 'droid' },
-    { id: 'cursor-cli', label: 'Cursor Agent CLI', command: 'cursor-agent' },
-    { id: 'qwen-code-cli', label: 'Qwen Code CLI', command: 'qwen' },
-    { id: 'goose', label: 'Goose CLI', command: 'goose' },
+    ...BESPOKE_CLI_PROVIDER_METADATA.map((provider) => ({
+      id: provider.id,
+      label: provider.displayName,
+      command: provider.binaryName,
+    })),
     { id: 'google-workspace-cli', label: 'Google Workspace CLI', command: 'gws' },
   ]
 
@@ -223,6 +220,19 @@ export async function GET(req: Request) {
     )
   }
 
+  const genericCliInstalled = GENERIC_CLI_PROVIDER_METADATA
+    .filter((provider) => commandExists(provider.binaryName))
+    .map((provider) => provider.displayName)
+  pushCheck(
+    checks,
+    'extended-cli-providers',
+    'Extended CLI provider roster',
+    genericCliInstalled.length > 0 ? 'pass' : 'warn',
+    genericCliInstalled.length > 0
+      ? `${genericCliInstalled.length} extended CLI provider(s) detected: ${genericCliInstalled.slice(0, 8).join(', ')}${genericCliInstalled.length > 8 ? ', ...' : ''}.`
+      : `${GENERIC_CLI_PROVIDER_METADATA.length} optional extended CLI provider(s) are available in SwarmClaw; install any matching CLI when you want to use it.`,
+  )
+
   const extensionSettings = (settings?.extensionSettings && typeof settings.extensionSettings === 'object')
     ? settings.extensionSettings as Record<string, Record<string, unknown>>
     : {}

package/src/components/auth/setup-wizard/step-providers.tsx

@@ -18,6 +18,7 @@ export function StepProviders({
   onContinue,
   onSkip,
 }: StepProvidersProps) {
+  const [providerSearch, setProviderSearch] = useState('')
   const [doctorState, setDoctorState] = useState<'idle' | 'checking' | 'done' | 'error'>('idle')
   const [doctorError, setDoctorError] = useState('')
   const [doctorReport, setDoctorReport] = useState<SetupDoctorResponse | null>(null)
@@ -36,6 +37,23 @@ export function StepProviders({
     }
   }
 
+  const normalizedSearch = providerSearch.trim().toLowerCase()
+  const visibleProviders = SETUP_PROVIDERS.filter((candidate) => {
+    if (!normalizedSearch) return true
+    return [
+      candidate.name,
+      candidate.description,
+      candidate.badge || '',
+      candidate.id,
+    ].some((part) => part.toLowerCase().includes(normalizedSearch))
+  })
+  const providerGroups = [
+    { id: 'cli', label: 'CLI Agents', items: visibleProviders.filter((candidate) => candidate.category === 'cli') },
+    { id: 'gateway', label: 'Gateways and Local Runtimes', items: visibleProviders.filter((candidate) => candidate.category === 'gateway' || candidate.category === 'local') },
+    { id: 'api', label: 'API Providers', items: visibleProviders.filter((candidate) => !candidate.category || candidate.category === 'api') },
+    { id: 'custom', label: 'Custom', items: visibleProviders.filter((candidate) => candidate.category === 'custom') },
+  ].filter((group) => group.items.length > 0)
+
   return (
     <StepShell>
       <h1 className="font-display text-[36px] font-800 leading-[1.05] tracking-[-0.04em] mb-3">
@@ -50,51 +68,72 @@ export function StepProviders({
 
       <ConfiguredProviderChips providers={configuredProviders} onRemove={onRemoveProvider} />
 
+      <input
+        type="search"
+        value={providerSearch}
+        onChange={(e) => setProviderSearch(e.target.value)}
+        placeholder="Search providers, CLIs, or runtimes..."
+        className="w-full px-4 py-3 rounded-[12px] border border-white/[0.08] bg-surface text-text text-[13px]
+          outline-none transition-all duration-200 placeholder:text-text-3/50 focus:border-accent-bright/30 mb-4"
+      />
+
       <div className="flex flex-col gap-3 max-h-[42vh] overflow-y-auto pr-1">
-        {SETUP_PROVIDERS.map((candidate) => {
-          const isConfigured = configuredProviderIds.has(candidate.id)
-          return (
-            <button
-              key={candidate.id}
-              onClick={() => onSelectProvider(candidate.id)}
-              className={`w-full px-5 py-4 rounded-[14px] border bg-surface text-left
-                transition-all duration-200 flex items-start gap-4 cursor-pointer
-                ${isConfigured
-                  ? 'border-emerald-500/25 hover:border-emerald-500/40 hover:bg-surface-hover'
-                  : 'border-white/[0.08] hover:border-accent-bright/30 hover:bg-surface-hover'
-                }`}
-            >
-              <div className={`w-10 h-10 rounded-[10px] border flex items-center justify-center shrink-0 mt-0.5 ${
-                isConfigured ? 'bg-emerald-500/10 border-emerald-500/20' : 'bg-white/[0.04] border-white/[0.06]'
-              }`}>
-                <span className={`text-[16px] font-display font-700 ${isConfigured ? 'text-emerald-400' : 'text-accent-bright'}`}>
-                  {candidate.icon}
-                </span>
-              </div>
-              <div className="flex-1">
-                <div className="text-[15px] font-display font-600 text-text mb-1">
-                  {candidate.name}
-                  {isConfigured ? (
-                    <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-300 text-[10px] uppercase tracking-[0.08em] font-600">
-                      Connected · Edit
-                    </span>
-                  ) : candidate.badge ? (
-                    <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-accent-bright/15 text-accent-bright text-[10px] uppercase tracking-[0.08em] font-600">
-                      {candidate.badge}
+        {providerGroups.map((group) => (
+          <div key={group.id} className="space-y-2">
+            <div className="px-1 text-[10px] font-700 uppercase tracking-[0.1em] text-text-3/70">
+              {group.label}
+            </div>
+            {group.items.map((candidate) => {
+              const isConfigured = configuredProviderIds.has(candidate.id)
+              return (
+                <button
+                  key={candidate.id}
+                  onClick={() => onSelectProvider(candidate.id)}
+                  className={`w-full px-5 py-4 rounded-[14px] border bg-surface text-left
+                    transition-all duration-200 flex items-start gap-4 cursor-pointer
+                    ${isConfigured
+                      ? 'border-emerald-500/25 hover:border-emerald-500/40 hover:bg-surface-hover'
+                      : 'border-white/[0.08] hover:border-accent-bright/30 hover:bg-surface-hover'
+                    }`}
+                >
+                  <div className={`w-10 h-10 rounded-[10px] border flex items-center justify-center shrink-0 mt-0.5 ${
+                    isConfigured ? 'bg-emerald-500/10 border-emerald-500/20' : 'bg-white/[0.04] border-white/[0.06]'
+                  }`}>
+                    <span className={`text-[16px] font-display font-700 ${isConfigured ? 'text-emerald-400' : 'text-accent-bright'}`}>
+                      {candidate.icon}
                     </span>
-                  ) : null}
-                </div>
-                <div className="text-[13px] text-text-3 leading-relaxed">{candidate.description}</div>
-                {!candidate.requiresKey && !isConfigured && (
-                  <div className="mt-1.5 inline-flex items-center gap-1.5 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-400 text-[11px] font-500">
-                    <span className="w-1.5 h-1.5 rounded-full bg-emerald-400" />
-                    No API key required
                   </div>
-                )}
-              </div>
-            </button>
-          )
-        })}
+                  <div className="flex-1">
+                    <div className="text-[15px] font-display font-600 text-text mb-1">
+                      {candidate.name}
+                      {isConfigured ? (
+                        <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-300 text-[10px] uppercase tracking-[0.08em] font-600">
+                          Connected · Edit
+                        </span>
+                      ) : candidate.badge ? (
+                        <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-accent-bright/15 text-accent-bright text-[10px] uppercase tracking-[0.08em] font-600">
+                          {candidate.badge}
+                        </span>
+                      ) : null}
+                    </div>
+                    <div className="text-[13px] text-text-3 leading-relaxed">{candidate.description}</div>
+                    {!candidate.requiresKey && !isConfigured && (
+                      <div className="mt-1.5 inline-flex items-center gap-1.5 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-400 text-[11px] font-500">
+                        <span className="w-1.5 h-1.5 rounded-full bg-emerald-400" />
+                        No API key required
+                      </div>
+                    )}
+                  </div>
+                </button>
+              )
+            })}
+          </div>
+        ))}
+        {providerGroups.length === 0 && (
+          <div className="px-5 py-6 rounded-[14px] border border-white/[0.08] bg-surface text-center text-[13px] text-text-3">
+            No providers match that search.
+          </div>
+        )}
       </div>
 
       <div className="mt-4 text-left">

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,
+    )
+  })
+})