free-coding-models 0.3.60 → 0.3.63

package/CHANGELOG.md

@@ -1,10 +1,20 @@
-## [0.3.58] - 2026-05-04
+## [0.3.63] - 2026-05-05
+
+### Fixed
+
+- **Router daemon auth error false positives** — Fixed `health.every([])` returning `true` for empty arrays, which caused all models to be incorrectly marked as AUTH_ERROR when the daemon had no health data yet. Added explicit `health.length > 0` guards before `.every()` checks.
+- **Daemon API key priority** — `getApiKeyForProvider` no longer falls back to shell env vars when a config key exists. The daemon now exclusively uses keys from `~/.free-coding-models.json`, preventing test/fake keys in shell env from overriding real configured keys.
 
 ### Changed
 
-- **E key filter ("Working only") now also hides `noauth` and `auth_error` models** — Previously E only filtered by missing API key. Now it also filters out models whose provider returned a 401/403 auth rejection, while still keeping `timeout` and `429` (rate-limited) models visible.
-- **Google AI Studio renamed to Google AI** — Shortened to avoid column overflow in the provider column.
+- **Shift+R now launches OpenCode** — Pressing Shift+R opens the Router Dashboard AND launches OpenCode with the currently selected model from the main table. If dashboard is already open, just resets scroll. Previously Shift+R only opened the dashboard without launching anything.
+- **Favorites sync to router on launch** — When a model is launched from the TUI, it and the user's full favorites chain are synced to the daemon as the active set via `/sets/fast-coding`.
+- **Router Dashboard install flow** — The "Install Router Endpoint to CLI Tool" button now opens the Install Endpoints overlay directly with `fcm_router` pre-selected, skipping the provider selection phase.
 
-### Fixed
+### Added
+
+- **README_ROUTER.md** — New comprehensive documentation for the FCM Router daemon, covering setup, endpoints, routing behavior, and tool configuration.
+
+### Changed (general)
 
-- **NVIDIA NIM column label** — The provider column in the TUI table now shows `NVIDIA NIM` instead of `NIM` to match the official provider branding.
+- **CTX column gradient improved** — Context window colorization now goes from red (32k) → orange (64k) → yellow (128k) → green (256k) → cyan/teal fluo (400k) → bold cyan+underline (1M+) so the biggest context windows stand out visually.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.60",
+  "version": "0.3.63",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/src/app.js

@@ -111,7 +111,7 @@ import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getP
 import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
 import { PROVIDER_METADATA, ENV_VAR_NAMES, isWindows, isMac } from '../src/provider-metadata.js'
 import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelemetryConfig, getTelemetryDistinctId, getTelemetrySystem, getTelemetryTerminal, isTelemetryEnabled, sendUsageTelemetry } from '../src/telemetry.js'
-import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite } from '../src/favorites.js'
+import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite, pruneOrphanedFavorites } from '../src/favorites.js'
 import { checkForUpdateDetailed, checkForUpdate, runUpdate, promptUpdateNotification, fetchLastReleaseDate } from './updater.js'
 import { promptApiKey } from '../src/setup.js'
 import { syncShellEnv, ensureShellRcSource, promptShellEnvMigration, removeShellEnv } from '../src/shell-env.js'
@@ -372,6 +372,9 @@ export async function runApp(cliArgs, config) {
       hidden: false,  // 📖 Simple flag to hide/show models
     }))
   syncFavoriteFlags(results, config)
+  // 📖 Garbage-collect favorites that reference models no longer in sources.js,
+  // 📖 so the router dashboard only shows real, launchable models.
+  pruneOrphanedFavorites(results, config)
 
   // 📖 Load usage data from token-stats.json and attach usagePercent to each result row.
   // 📖 usagePercent is the quota percent remaining (0–100). undefined = no data available.
@@ -544,6 +547,7 @@ export async function runApp(cliArgs, config) {
     routerDashboardNoticeTimer: null,
     routerOnboardingScrollOffset: 0,
     routerDashboardEverOpened: false, // 📖 Set to true the first time dashboard opens (used for upgrade-path telemetry)
+    routerDashboardCursorIndex: 0,    // 📖 Cursor index for navigating the favorites list in router dashboard
     // 📖 Custom text filter (Ctrl+P palette → type text → Enter). Ephemeral — not saved to config.
     customTextFilter: null,       // 📖 Active free-text filter string (null = off). Matches model name, ctx, provider key/name.
   }
@@ -578,7 +582,8 @@ export async function runApp(cliArgs, config) {
   const scheduleNextPing = () => {
     clearTimeout(state.pingIntervalObj)
     const elapsed = Date.now() - state.lastPingTime
-    const delay = Math.max(0, state.pingInterval - elapsed)
+    const interval = state.routerDashboardOpen ? 1000 : state.pingInterval
+    const delay = Math.max(0, interval - elapsed)
     state.pingIntervalObj = setTimeout(runPingCycle, delay)
   }
 
@@ -1223,6 +1228,13 @@ if (unconfiguredHide) {
     }
 
     state.results.forEach(r => {
+      // 📖 When router dashboard is open, ONLY ping favorites every second
+      // 📖 to prevent massive rate limiting across the entire 90+ model catalog.
+      if (state.routerDashboardOpen) {
+        const favKey = `${r.providerKey}/${r.modelId}`
+        if (!state.config.favorites.includes(favKey)) return
+      }
+
       pingModel(r).catch(() => {
         // Individual ping failures don't crash the loop
       })

package/src/endpoint-installer.js

@@ -136,10 +136,12 @@ function getManagedProviderId(providerKey) {
 }
 
 function getProviderLabel(providerKey) {
+  if (providerKey === 'fcm_router') return 'Smart Router Daemon'
   return PROVIDER_METADATA[providerKey]?.label || sources[providerKey]?.name || providerKey
 }
 
 function getManagedProviderLabel(providerKey) {
+  if (providerKey === 'fcm_router') return 'FCM Smart Router'
   return `FCM ${getProviderLabel(providerKey)}`
 }
 
@@ -157,6 +159,10 @@ function getDefaultMaxTokens(contextWindow) {
 }
 
 function resolveProviderBaseUrl(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return `http://localhost:${process.env.FCM_ROUTER_PORT || '19280'}/v1`
+  }
+
   const providerUrl = sources[providerKey]?.url
   if (!providerUrl) return null
 
@@ -173,6 +179,9 @@ function resolveProviderBaseUrl(providerKey) {
 }
 
 function resolveGooseBaseUrl(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return `http://localhost:${process.env.FCM_ROUTER_PORT || '19280'}/v1`
+  }
   const providerUrl = sources[providerKey]?.url
   if (!providerUrl) return null
   if (providerKey === 'cloudflare') {
@@ -184,6 +193,7 @@ function resolveGooseBaseUrl(providerKey) {
 }
 
 function getDirectInstallSupport(providerKey) {
+  if (providerKey === 'fcm_router') return { supported: true, reason: null }
   if (!sources[providerKey]) {
     return { supported: false, reason: 'Unknown provider' }
   }
@@ -220,6 +230,12 @@ function buildCatalogModel(modelId, label, tier, sweScore, ctx) {
 }
 
 export function getProviderCatalogModels(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return [
+      buildCatalogModel('fcm', 'FCM Smart Router', 'S+', 100, '200k')
+    ]
+  }
+
   const seen = new Set()
   return MODELS
     .filter((entry) => entry[5] === providerKey)
@@ -252,6 +268,7 @@ export function getInstallTargetModes() {
 }
 
 function requireConfiguredProviderKey(config, providerKey) {
+  if (providerKey === 'fcm_router') return 'fcm-local'
   const apiKey = getApiKey(config, providerKey)
   if (!apiKey) {
     throw new Error(`No configured API key found for ${getProviderLabel(providerKey)}`)

package/src/favorites.js

@@ -21,9 +21,10 @@
  *   → toFavoriteKey(providerKey, modelId)        — Build the canonical "providerKey/modelId" string
  *   → syncFavoriteFlags(results, config)         — Attach isFavorite/favoriteRank to result rows
  *   → toggleFavoriteModel(config, providerKey, modelId) — Add/remove favorite and persist
+ *   → pruneOrphanedFavorites(results, config)    — Remove favorites referencing models no longer in sources
  *
  * @exports
- *   ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel
+ *   ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, pruneOrphanedFavorites
  *
  * @see src/config.js  — load/save helpers keep favorite persistence atomic and merge-safe
  * @see bin/free-coding-models.js — calls syncFavoriteFlags on startup and toggleFavoriteModel on F key
@@ -125,3 +126,23 @@ export function reorderFavorite(config, providerKey, modelId, direction) {
   if (saveResult.success) replaceConfigContents(config, latestConfig)
   return true
 }
+
+/**
+ * 📖 Remove favorites that reference models no longer present in the active sources.
+ * 📖 Called once at startup so the router dashboard does not show stale/removed models.
+ * 📖 Persists immediately if any orphaned entries are found.
+ * @param {Array<Record<string, unknown>>} results — the full result rows from sources
+ * @param {Record<string, unknown>} config
+ * @returns {number} count of removed orphaned entries
+ */
+export function pruneOrphanedFavorites(results, config) {
+  ensureFavoritesConfig(config)
+  const validKeys = new Set(results.map(r => toFavoriteKey(r.providerKey, r.modelId)))
+  const before = config.favorites.length
+  config.favorites = config.favorites.filter(key => validKeys.has(key))
+  const removed = before - config.favorites.length
+  if (removed > 0) {
+    saveConfig(config, { replaceFavorites: true })
+  }
+  return removed
+}

package/src/key-handler.js

@@ -269,6 +269,7 @@ export function createKeyHandler(ctx) {
     installProviderEndpoints,
     syncFavoriteFlags,
     toggleFavoriteModel,
+    reorderFavorite,
     sortResultsWithPinnedFavorites,
     adjustScrollOffset,
     applyTierFilter,
@@ -1434,22 +1435,108 @@ export function createKeyHandler(ctx) {
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
-    // 📖 Router Dashboard captures local dashboard controls while open so keys
-    // 📖 like S/I/R/C do not leak through to sort/filter actions in the table.
+    // 📖 Router Dashboard: ↑↓ navigate favorites list, Ctrl+↑↓ reorder,
+    // 📖 I cycles health check speed, C clears log, Esc goes back.
     if (state.routerDashboardOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
+      const favorites = Array.isArray(state.config?.favorites) ? state.config.favorites : []
+      // 📖 maxCursor accounts for the favorites list + 2 buttons (Start/Stop Daemon and Install Endpoint)
+      const maxCursor = Math.max(0, favorites.length + 1)
       const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
 
       if (key.name === 'escape') {
         closeRouterDashboardOverlay(state)
         return
       }
+
+      // 📖 Shift+↑: move the selected favorite UP in fallback priority
+      if (key.shift && key.name === 'up') {
+        const cursorIdx = state.routerDashboardCursorIndex ?? 0
+        if (favorites.length > 0 && cursorIdx < favorites.length) {
+          const favKey = favorites[cursorIdx]
+          if (favKey) {
+            const slashIdx = favKey.indexOf('/')
+            const providerKey = slashIdx >= 0 ? favKey.slice(0, slashIdx) : favKey
+            const modelId = slashIdx >= 0 ? favKey.slice(slashIdx + 1) : favKey
+            const moved = reorderFavorite(state.config, providerKey, modelId, 'up')
+            if (moved) {
+              state.routerDashboardCursorIndex = Math.max(0, cursorIdx - 1)
+              syncFavoriteFlags(state.results, state.config)
+            }
+          }
+        }
+        return
+      }
+
+      // 📖 Shift+↓: move the selected favorite DOWN in fallback priority
+      if (key.shift && key.name === 'down') {
+        const cursorIdx = state.routerDashboardCursorIndex ?? 0
+        if (favorites.length > 0 && cursorIdx < favorites.length) {
+          const favKey = favorites[cursorIdx]
+          if (favKey) {
+            const slashIdx = favKey.indexOf('/')
+            const providerKey = slashIdx >= 0 ? favKey.slice(0, slashIdx) : favKey
+            const modelId = slashIdx >= 0 ? favKey.slice(slashIdx + 1) : favKey
+            const moved = reorderFavorite(state.config, providerKey, modelId, 'down')
+            if (moved) {
+              state.routerDashboardCursorIndex = Math.min(favorites.length - 1, cursorIdx + 1)
+              syncFavoriteFlags(state.results, state.config)
+            }
+          }
+        }
+        return
+      }
+
+      // 📖 S: Toggle daemon start/stop
+      if (key.name === 's') {
+        const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
+        const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+        const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
+        
+        state.routerDashboardStatus = 'loading'
+        const child = spawn('node', [binPath, ...args], {
+          detached: true,
+          stdio: 'ignore',
+        })
+        child.unref()
+        return
+      }
+
+      // 📖 Enter/Return: Toggle daemon or open Install Endpoints if cursor is on a button
+      if (key.name === 'return' || key.name === 'enter') {
+        const btnCursor = favorites.length
+        const installBtnCursor = favorites.length + 1
+
+        if ((state.routerDashboardCursorIndex ?? 0) === btnCursor) {
+          const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
+          const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+          const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
+          
+          state.routerDashboardStatus = 'loading'
+          const child = spawn('node', [binPath, ...args], {
+            detached: true,
+            stdio: 'ignore',
+          })
+          child.unref()
+        } else if ((state.routerDashboardCursorIndex ?? 0) === installBtnCursor) {
+          state.routerDashboardOpen = false
+          state.installEndpointsOpen = true
+          state.installEndpointsPhase = 'tools' // skip the provider selection phase
+          state.installEndpointsCursor = 0
+          state.installEndpointsProviderKey = 'fcm_router' // special provider key handled by endpoint-installer
+          state.installEndpointsScrollOffset = 0
+          state.installEndpointsErrorMsg = null
+        }
+        return
+      }
+
+      // 📖 ↑/↓: navigate the favorites list cursor
       if (key.name === 'up' || key.name === 'k') {
-        state.routerDashboardScrollOffset = Math.max(0, (state.routerDashboardScrollOffset || 0) - 1)
+        state.routerDashboardCursorIndex = Math.max(0, (state.routerDashboardCursorIndex ?? 0) - 1)
         return
       }
       if (key.name === 'down' || key.name === 'j') {
-        state.routerDashboardScrollOffset = (state.routerDashboardScrollOffset || 0) + 1
+        state.routerDashboardCursorIndex = Math.min(maxCursor, (state.routerDashboardCursorIndex ?? 0) + 1)
         return
       }
       if (key.name === 'pageup') {
@@ -1461,29 +1548,18 @@ export function createKeyHandler(ctx) {
         return
       }
       if (key.name === 'home') {
+        state.routerDashboardCursorIndex = 0
         state.routerDashboardScrollOffset = 0
         return
       }
-      if (key.name === 's') {
-        try { await cycleRouterDashboardActiveSet(state) } catch {}
-        return
-      }
       if (key.name === 'i') {
         try { await cycleRouterDashboardProbeMode(state) } catch {}
         return
       }
-      if (key.name === 'r') {
-        restartRouterDashboardDaemon(state)
-        return
-      }
       if (key.name === 'c') {
         clearRouterDashboardRequestLog(state)
         return
       }
-      if (key.name === 'p') {
-        toggleRouterDashboardProbePause(state)
-        return
-      }
       return
     }
 
@@ -1492,7 +1568,7 @@ export function createKeyHandler(ctx) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
 
       const providerChoices = getConfiguredInstallableProviders(state.config)
-      const toolChoices = getInstallTargetModes()
+      const toolChoices = getInstallTargetModes().filter(t => !(state.installEndpointsProviderKey === 'fcm_router' && t === 'fcm_router'))
       const modelChoices = state.installEndpointsProviderKey
         ? getProviderCatalogModels(state.installEndpointsProviderKey)
         : []
@@ -1534,10 +1610,19 @@ export function createKeyHandler(ctx) {
       if (key.name === 'escape') {
         state.installEndpointsErrorMsg = null
         if (state.installEndpointsPhase === 'providers' || state.installEndpointsPhase === 'result') {
+          const wasFcmRouter = state.installEndpointsProviderKey === 'fcm_router'
           resetInstallEndpointsOverlay()
+          if (wasFcmRouter) {
+            state.routerDashboardOpen = true
+          }
           return
         }
         if (state.installEndpointsPhase === 'tools') {
+          if (state.installEndpointsProviderKey === 'fcm_router') {
+             resetInstallEndpointsOverlay()
+             state.routerDashboardOpen = true
+             return
+          }
           state.installEndpointsPhase = 'providers'
           state.installEndpointsCursor = 0
           state.installEndpointsScrollOffset = 0
@@ -1582,10 +1667,25 @@ export function createKeyHandler(ctx) {
           if (!selectedToolMode) return
           state.installEndpointsToolMode = selectedToolMode
           state.installEndpointsConnectionMode = 'direct'
-          state.installEndpointsPhase = 'scope'
-          state.installEndpointsCursor = 0
-          state.installEndpointsScrollOffset = 0
-          state.installEndpointsErrorMsg = null
+          
+          if (state.installEndpointsProviderKey === 'fcm_router') {
+            state.installEndpointsScope = 'all'
+            try {
+              await runInstallEndpointsFlow()
+            } catch (error) {
+              state.installEndpointsResult = {
+                type: 'error',
+                title: 'Install failed',
+                lines: [error instanceof Error ? error.message : String(error)],
+              }
+              state.installEndpointsPhase = 'result'
+            }
+          } else {
+            state.installEndpointsPhase = 'scope'
+            state.installEndpointsCursor = 0
+            state.installEndpointsScrollOffset = 0
+            state.installEndpointsErrorMsg = null
+          }
         }
         return
       }
@@ -1660,7 +1760,11 @@ export function createKeyHandler(ctx) {
 
       if (state.installEndpointsPhase === 'result') {
         if (key.name === 'return' || key.name === 'y') {
+          const wasFcmRouter = state.installEndpointsProviderKey === 'fcm_router'
           resetInstallEndpointsOverlay()
+          if (wasFcmRouter) {
+            state.routerDashboardOpen = true
+          }
         }
         return
       }
@@ -2558,10 +2662,26 @@ export function createKeyHandler(ctx) {
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
-    // 📖 Shift+R intentionally stays unadvertised in the main UI, but remains
-    // 📖 available as a tester entry point for the Router Dashboard.
+    // 📖 Shift+R: Open Router Dashboard AND launch OpenCode with the selected model.
+    // 📖 If the dashboard is already open, just bring it to front.
     if (key.name === 'r' && key.shift && !key.ctrl && !key.meta) {
+      if (state.routerDashboardOpen) {
+        state.routerDashboardScrollOffset = 0
+        return
+      }
       openRouterDashboardOverlay(state)
+      // 📖 If a model is selected in the main table, launch OpenCode with it after opening dashboard
+      const selected = state.visibleSorted?.[state.cursor]
+      if (selected && selected.providerKey && selected.modelId) {
+        const launchModel = {
+          modelId: selected.modelId,
+          label: selected.label,
+          tier: selected.tier,
+          providerKey: selected.providerKey,
+        }
+        // 📖 Launch asynchronously — don't await, dashboard renders while OpenCode starts
+        void startOpenCode(launchModel, state.config)
+      }
       return
     }
 

package/src/overlays.js

@@ -343,7 +343,7 @@ export function createOverlayRenderers(state, deps) {
     const lines = []
     const cursorLineByRow = {}
     const providerChoices = getConfiguredInstallableProviders(state.config)
-    const toolChoices = getInstallTargetModes()
+    const toolChoices = getInstallTargetModes().filter(t => !(state.installEndpointsProviderKey === 'fcm_router' && t === 'fcm_router'))
     const totalSteps = 4
     const scopeChoices = [
       {
@@ -357,9 +357,11 @@ export function createOverlayRenderers(state, deps) {
         hint: 'Choose a smaller curated subset for a cleaner model picker.',
       },
     ]
-    const selectedProviderLabel = state.installEndpointsProviderKey
-      ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
-      : '—'
+    const selectedProviderLabel = state.installEndpointsProviderKey === 'fcm_router' 
+      ? 'Smart Router Daemon' 
+      : state.installEndpointsProviderKey
+        ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
+        : '—'
 
     // 📖 Resolve tool label from metadata instead of hard-coded switch
     const selectedToolLabel = state.installEndpointsToolMode

package/src/render-table.js

@@ -503,9 +503,11 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
           ? themeColors.metricWarn(ctxRaw.padEnd(W_CTX))
           : numK <= 128
           ? chalk.rgb(200, 180, 50).bold(ctxRaw.padEnd(W_CTX))
-          : numK <= 200
+          : numK <= 256
           ? chalk.rgb(100, 200, 80).bold(ctxRaw.padEnd(W_CTX))
-          : themeColors.metricGood(ctxRaw.padEnd(W_CTX))
+          : numK <= 400
+          ? chalk.rgb(0, 255, 200).bold(ctxRaw.padEnd(W_CTX))
+          : chalk.rgb(0, 255, 255).bold.underline(ctxRaw.padEnd(W_CTX))
       } else {
         ctxCell = themeColors.dim(ctxRaw.padEnd(W_CTX))
       }
@@ -823,7 +825,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const starLink = '⭐ ' + themeColors.link('\x1b]8;;https://github.com/vava-nessa/free-coding-models\x1b\\GitHub\x1b]8;;\x1b\\')
   lines.push(
     '  ' + paletteLabel + themeColors.dim(`  •  `) + starLink + themeColors.dim(`  •  `) +
-    chalk.rgb(255, 168, 209).bold('\x1b]8;;https://x.com/vavanessadev\x1b\\Support me by following me on X ! @vavanessadev\x1b]8;;\x1b\\')
+    chalk.rgb(255, 168, 209).bold('\x1b]8;;https://x.com/vavanessadev\x1b\\Follow @vavanessadev on X for updates and support\x1b]8;;\x1b\\')
   )
 
   if (versionStatus.isOutdated) {

package/src/router-daemon.js

@@ -637,7 +637,8 @@ class RouterRuntime {
   reloadConfigFromDisk() {
     try {
       const nextConfig = loadConfig()
-      if (!nextConfig.router) nextConfig.router = this.routerConfig()
+      // 📖 Always rebuild the router set from favorites so UI toggles apply dynamically
+      ensureRouterConfigForDaemon(nextConfig, true)
       this.config = nextConfig
       this.refreshRouteState()
       this.scheduleProbeLoop()
@@ -649,12 +650,10 @@ class RouterRuntime {
   }
 
   getApiKeyForProvider(providerKey) {
-    // 📖 Router background startup should work without inherited shell env, so
-    // 📖 config keys are primary. Env is only a fallback for headless sessions.
     const configured = this.config?.apiKeys?.[providerKey]
     if (Array.isArray(configured)) return configured.find(Boolean) || null
     if (typeof configured === 'string' && configured.trim()) return configured.trim()
-    return getApiKey({ apiKeys: {}, providers: {} }, providerKey)
+    return null
   }
 
   getSet(setName = null) {
@@ -1052,15 +1051,18 @@ class RouterRuntime {
       let errorCode = 'all_models_unavailable'
       let errorType = 'service_unavailable'
       if (health.length > 0) {
-        if (health.every((h) => h.state === 'AUTH_ERROR')) {
+        const allAuthError = health.length > 0 && health.every((h) => h.state === 'AUTH_ERROR')
+        const allAuthOrQuota = health.length > 0 && health.every((h) => h.state === 'AUTH_ERROR' || quotaExhausted.includes(h.key))
+        const allStaleOrUnsupported = health.every((h) => h.state === 'STALE' || h.state === 'UNSUPPORTED')
+        if (allAuthError) {
           statusCode = 401
           errorCode = 'invalid_api_key'
           errorType = 'invalid_request_error'
-        } else if (health.every((h) => h.state === 'AUTH_ERROR' || quotaExhausted.includes(h.key))) {
+        } else if (allAuthOrQuota) {
           statusCode = 429
           errorCode = 'insufficient_quota'
           errorType = 'insufficient_quota'
-        } else if (health.every((h) => h.state === 'STALE' || h.state === 'UNSUPPORTED')) {
+        } else if (allStaleOrUnsupported) {
           statusCode = 400
           errorCode = 'invalid_model'
           errorType = 'invalid_request_error'
@@ -1808,7 +1810,7 @@ export function createRouterRuntimeForTest({ config, port = 0, logger = null, to
   })
 }
 
-function ensureRouterConfigForDaemon(config) {
+function ensureRouterConfigForDaemon(config, skipSave = false) {
   // 📖 Always rebuild from favorites or defaults — no more manual set management
   const favSet = buildRouterSetFromFavorites(config)
   const activeSet = favSet || buildDefaultRouterSet(config)
@@ -1819,7 +1821,7 @@ function ensureRouterConfigForDaemon(config) {
     activeSet: activeSet.name,
     sets: { [activeSet.name]: activeSet },
   })
-  saveConfig(config)
+  if (!skipSave) saveConfig(config)
   return config.router
 }