free-coding-models 0.2.0 → 0.2.2

package/src/overlays.js

@@ -4,7 +4,8 @@
  *
  * @details
  *   This module centralizes all overlay rendering in one place:
- *   - Settings, Help, Log, Smart Recommend, Feature Request, Bug Report
+ *   - Settings, Install Endpoints, Help, Log, Smart Recommend, Feature Request, Bug Report
+ *   - Settings diagnostics for provider key tests, including wrapped retry/error details
  *   - Recommend analysis timer orchestration and progress updates
  *
  *   The factory pattern keeps stateful UI logic isolated while still
@@ -48,8 +49,32 @@ export function createOverlayRenderers(state, deps) {
     getTopRecommendations,
     adjustScrollOffset,
     getPingModel,
+    getConfiguredInstallableProviders,
+    getInstallTargetModes,
+    getProviderCatalogModels,
   } = deps
 
+  // 📖 Wrap plain diagnostic text so long Settings messages stay readable inside
+  // 📖 the overlay instead of turning into one truncated red line.
+  const wrapPlainText = (text, width = 104) => {
+    const normalized = typeof text === 'string' ? text.trim() : ''
+    if (!normalized) return []
+    const words = normalized.split(/\s+/)
+    const lines = []
+    let current = ''
+    for (const word of words) {
+      const next = current ? `${current} ${word}` : word
+      if (next.length > width && current) {
+        lines.push(current)
+        current = word
+      } else {
+        current = next
+      }
+    }
+    if (current) lines.push(current)
+    return lines
+  }
+
   // 📖 Keep log token formatting aligned with the main table so the same totals
   // 📖 read the same everywhere in the TUI.
   const formatLogTokens = (totalTokens) => {
@@ -118,9 +143,13 @@ export function createOverlayRenderers(state, deps) {
 
       // 📖 Test result badge
       const testResult = state.settingsTestResults[pk]
-      let testBadge = chalk.dim('[Test —]')
+      // 📖 Default badge reflects configuration first: a saved key should look
+      // 📖 ready to test even before the user has run the probe once.
+      let testBadge = keyCount > 0 ? chalk.cyan('[Test]') : chalk.dim('[Missing Key 🔑]')
       if (testResult === 'pending') testBadge = chalk.yellow('[Testing…]')
       else if (testResult === 'ok')   testBadge = chalk.greenBright('[Test ✅]')
+      else if (testResult === 'missing_key') testBadge = chalk.dim('[Missing Key 🔑]')
+      else if (testResult === 'auth_error') testBadge = chalk.red('[Auth ❌]')
       else if (testResult === 'rate_limited') testBadge = chalk.yellow('[Rate limit ⏳]')
       else if (testResult === 'no_callable_model') testBadge = chalk.magenta('[No model ⚠]')
       else if (testResult === 'fail') testBadge = chalk.red('[Test ❌]')
@@ -151,6 +180,14 @@ export function createOverlayRenderers(state, deps) {
         const accountIdStatus = hasAccountId ? chalk.green('CLOUDFLARE_ACCOUNT_ID detected ✅') : chalk.yellow('Set CLOUDFLARE_ACCOUNT_ID ⚠')
         lines.push(chalk.dim(`  4) Export ${chalk.yellow('CLOUDFLARE_ACCOUNT_ID')} in your shell. Status: ${accountIdStatus}`))
       }
+      const testDetail = state.settingsTestDetails?.[selectedProviderKey]
+      if (testDetail) {
+        lines.push('')
+        lines.push(chalk.red.bold('  Test Diagnostics'))
+        for (const detailLine of wrapPlainText(testDetail)) {
+          lines.push(chalk.red(`  ${detailLine}`))
+        }
+      }
       lines.push('')
     }
 
@@ -266,6 +303,168 @@ export function createOverlayRenderers(state, deps) {
     return cleared.join('\n')
   }
 
+  // ─── Install Endpoints overlay renderer ───────────────────────────────────
+  // 📖 renderInstallEndpoints drives the provider → tool → scope → model flow
+  // 📖 behind the `Y` hotkey. It deliberately reuses the same overlay viewport
+  // 📖 helpers as Settings so long provider/model lists stay navigable.
+  function renderInstallEndpoints() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+    const providerChoices = getConfiguredInstallableProviders(state.config)
+    const toolChoices = getInstallTargetModes()
+    const scopeChoices = [
+      {
+        key: 'all',
+        label: 'Install all models',
+        hint: 'Recommended — FCM will refresh this provider catalog automatically later.',
+      },
+      {
+        key: 'selected',
+        label: 'Install selected models only',
+        hint: 'Choose a smaller curated subset for a cleaner model picker.',
+      },
+    ]
+    const selectedProviderLabel = state.installEndpointsProviderKey
+      ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
+      : '—'
+    const selectedToolLabel = state.installEndpointsToolMode
+      ? (state.installEndpointsToolMode === 'opencode-desktop'
+          ? 'OpenCode Desktop (shared opencode.json)'
+          : (state.installEndpointsToolMode === 'opencode'
+              ? 'OpenCode CLI (shared opencode.json)'
+              : state.installEndpointsToolMode === 'openclaw'
+                ? 'OpenClaw'
+                : state.installEndpointsToolMode === 'crush'
+                  ? 'Crush'
+                  : 'Goose'))
+      : '—'
+
+    lines.push('')
+    lines.push(`  ${chalk.bold('🔌 Install Endpoints')}  ${chalk.dim('— install provider catalogs into supported coding tools')}`)
+    if (state.installEndpointsErrorMsg) {
+      lines.push(`  ${chalk.yellow(state.installEndpointsErrorMsg)}`)
+    }
+    lines.push('')
+
+    if (state.installEndpointsPhase === 'providers') {
+      lines.push(`  ${chalk.bold('Step 1/4')}  ${chalk.cyan('Choose a configured provider')}`)
+      lines.push('')
+
+      if (providerChoices.length === 0) {
+        lines.push(chalk.dim('  No configured providers can be installed directly right now.'))
+        lines.push(chalk.dim('  Add an API key in Settings (`P`) first, then reopen this screen.'))
+      } else {
+        providerChoices.forEach((provider, idx) => {
+          const isCursor = idx === state.installEndpointsCursor
+          const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+          const row = `${bullet}${chalk.bold(provider.label.padEnd(24))} ${chalk.dim(`${provider.modelCount} models`)}` 
+          cursorLineByRow[idx] = lines.length
+          lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+        })
+      }
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose provider  •  Esc Close'))
+    } else if (state.installEndpointsPhase === 'tools') {
+      lines.push(`  ${chalk.bold('Step 2/4')}  ${chalk.cyan('Choose the target tool')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}`))
+      lines.push('')
+
+      toolChoices.forEach((toolMode, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const label = toolMode === 'opencode-desktop'
+          ? 'OpenCode Desktop'
+          : toolMode === 'opencode'
+            ? 'OpenCode CLI'
+            : toolMode === 'openclaw'
+              ? 'OpenClaw'
+              : toolMode === 'crush'
+                ? 'Crush'
+                : 'Goose'
+        const note = toolMode.startsWith('opencode')
+          ? chalk.dim('shared config file')
+          : chalk.dim('managed provider install')
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const row = `${bullet}${chalk.bold(label.padEnd(22))} ${note}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+      })
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose tool  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'scope') {
+      lines.push(`  ${chalk.bold('Step 3/4')}  ${chalk.cyan('Choose the install scope')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
+      lines.push('')
+
+      scopeChoices.forEach((scope, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const row = `${bullet}${chalk.bold(scope.label)}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+        lines.push(chalk.dim(`      ${scope.hint}`))
+        lines.push('')
+      })
+
+      lines.push(chalk.dim('  Enter Continue  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'models') {
+      const models = getProviderCatalogModels(state.installEndpointsProviderKey)
+      const selectedCount = state.installEndpointsSelectedModelIds.size
+
+      lines.push(`  ${chalk.bold('Step 4/4')}  ${chalk.cyan('Choose which models to install')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
+      lines.push(chalk.dim(`  Selected: ${selectedCount}/${models.length}`))
+      lines.push('')
+
+      models.forEach((model, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const selected = state.installEndpointsSelectedModelIds.has(model.modelId)
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const checkbox = selected ? chalk.greenBright('[✓]') : chalk.dim('[ ]')
+        const tier = chalk.cyan(model.tier.padEnd(2))
+        const row = `${bullet}${checkbox} ${chalk.bold(model.label.padEnd(26))} ${tier} ${chalk.dim(model.ctx.padEnd(6))} ${chalk.dim(model.modelId)}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+      })
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Space Toggle model  •  A All/None  •  Enter Install  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'result') {
+      const result = state.installEndpointsResult
+      const accent = result?.type === 'success' ? chalk.greenBright : chalk.redBright
+      lines.push(`  ${chalk.bold('Result')}  ${accent(result?.title || 'Install result unavailable')}`)
+      lines.push('')
+
+      for (const detail of result?.lines || []) {
+        lines.push(`  ${detail}`)
+      }
+
+      if (result?.type === 'success') {
+        lines.push('')
+        lines.push(chalk.dim('  Future FCM launches will refresh this catalog automatically when the provider list evolves.'))
+      }
+
+      lines.push('')
+      lines.push(chalk.dim('  Enter or Esc Close'))
+    }
+
+    const targetLine = cursorLineByRow[state.installEndpointsCursor] ?? 0
+    state.installEndpointsScrollOffset = keepOverlayTargetVisible(
+      state.installEndpointsScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.installEndpointsScrollOffset, state.terminalRows)
+    state.installEndpointsScrollOffset = offset
+
+    const tintedLines = tintOverlayLines(visible, SETTINGS_OVERLAY_BG)
+    const cleared = tintedLines.map((line) => line + EL)
+    return cleared.join('\n')
+  }
+
   // ─── Help overlay renderer ────────────────────────────────────────────────
   // 📖 renderHelp: Draw the help overlay listing all key bindings.
   // 📖 Toggled with K key. Gives users a quick reference without leaving the TUI.
@@ -280,7 +479,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.cyan('Rank')}        SWE-bench rank (1 = best coding score)  ${chalk.dim('Sort:')} ${chalk.yellow('R')}`)
     lines.push(`              ${chalk.dim('Quick glance at which model is objectively the best coder right now.')}`)
     lines.push('')
-    lines.push(`  ${chalk.cyan('Tier')}        S+ / S / A+ / A / A- / B+ / B / C based on SWE-bench score  ${chalk.dim('Sort:')} ${chalk.yellow('Y')}  ${chalk.dim('Cycle:')} ${chalk.yellow('T')}`)
+    lines.push(`  ${chalk.cyan('Tier')}        S+ / S / A+ / A / A- / B+ / B / C based on SWE-bench score  ${chalk.dim('Cycle:')} ${chalk.yellow('T')}`)
     lines.push(`              ${chalk.dim('Skip the noise — S/S+ models solve real GitHub issues, C models are for light tasks.')}`)
     lines.push('')
     lines.push(`  ${chalk.cyan('SWE%')}        SWE-bench score — coding ability benchmark (color-coded)  ${chalk.dim('Sort:')} ${chalk.yellow('S')}`)
@@ -331,6 +530,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('X')}  Toggle token log page  ${chalk.dim('(shows recent request usage from request-log.jsonl)')}`)
     lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode → Desktop → OpenClaw → Crush → Goose)')}`)
     lines.push(`  ${chalk.yellow('F')}  Toggle favorite on selected row  ${chalk.dim('(⭐ pinned at top, persisted)')}`)
+    lines.push(`  ${chalk.yellow('Y')}  Install endpoints  ${chalk.dim('(provider catalog → OpenCode/OpenClaw/Crush/Goose, no proxy)')}`)
     lines.push(`  ${chalk.yellow('Q')}  Smart Recommend  ${chalk.dim('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${chalk.rgb(57, 255, 20).bold('J')}  Request Feature  ${chalk.dim('(📝 send anonymous feedback to the project team)')}`)
     lines.push(`  ${chalk.rgb(255, 87, 51).bold('I')}  Report Bug  ${chalk.dim('(🐛 send anonymous bug report to the project team)')}`)
@@ -413,7 +613,8 @@ export function createOverlayRenderers(state, deps) {
       // 📖 Column widths for the log table
       const W_TIME    = 19
       const W_PROV    = 14
-      const W_MODEL   = 36
+      const W_MODEL   = 44
+      const W_ROUTE   = 18
       const W_STATUS  = 8
       const W_TOKENS  = 12
       const W_LAT     = 10
@@ -422,11 +623,12 @@ export function createOverlayRenderers(state, deps) {
       const hTime   = chalk.dim('Time'.padEnd(W_TIME))
       const hProv   = chalk.dim('Provider'.padEnd(W_PROV))
       const hModel  = chalk.dim('Model'.padEnd(W_MODEL))
+      const hRoute  = chalk.dim('Route'.padEnd(W_ROUTE))
       const hStatus = chalk.dim('Status'.padEnd(W_STATUS))
       const hTok    = chalk.dim('Tokens Used'.padEnd(W_TOKENS))
       const hLat    = chalk.dim('Latency'.padEnd(W_LAT))
-      lines.push(`  ${hTime}  ${hProv}  ${hModel}  ${hStatus}  ${hTok}  ${hLat}`)
-      lines.push(chalk.dim('  ' + '─'.repeat(W_TIME + W_PROV + W_MODEL + W_STATUS + W_TOKENS + W_LAT + 10)))
+      lines.push(`  ${hTime}  ${hProv}  ${hModel}  ${hRoute}  ${hStatus}  ${hTok}  ${hLat}`)
+      lines.push(chalk.dim('  ' + '─'.repeat(W_TIME + W_PROV + W_MODEL + W_ROUTE + W_STATUS + W_TOKENS + W_LAT + 12)))
 
       for (const row of logRows) {
         // 📖 Format time as HH:MM:SS (strip the date part for compactness)
@@ -438,6 +640,11 @@ export function createOverlayRenderers(state, deps) {
           }
         } catch { /* keep raw */ }
 
+        const requestedModelLabel = row.requestedModel || ''
+        const displayModel = row.switched && requestedModelLabel && requestedModelLabel !== row.model
+          ? `${requestedModelLabel} → ${row.model}`
+          : row.model
+
         // 📖 Color-code status
         let statusCell
         const sc = String(row.status)
@@ -453,14 +660,22 @@ export function createOverlayRenderers(state, deps) {
 
         const tokStr = formatLogTokens(row.tokens)
         const latStr = row.latency > 0 ? `${row.latency}ms` : '--'
+        const routeLabel = row.switched
+          ? `SWITCHED ↻ ${row.switchReason || 'fallback'}`
+          : 'direct'
 
         const timeCell  = chalk.dim(timeStr.slice(0, W_TIME).padEnd(W_TIME))
         const provCell  = chalk.cyan(row.provider.slice(0, W_PROV).padEnd(W_PROV))
-        const modelCell = chalk.white(row.model.slice(0, W_MODEL).padEnd(W_MODEL))
+        const modelCell = row.switched
+          ? chalk.bold.rgb(255, 210, 90)(displayModel.slice(0, W_MODEL).padEnd(W_MODEL))
+          : chalk.white(displayModel.slice(0, W_MODEL).padEnd(W_MODEL))
+        const routeCell = row.switched
+          ? chalk.bgRgb(120, 25, 25).yellow.bold(` ${routeLabel.slice(0, W_ROUTE - 2).padEnd(W_ROUTE - 2)} `)
+          : chalk.dim(routeLabel.padEnd(W_ROUTE))
         const tokCell   = chalk.dim(tokStr.padEnd(W_TOKENS))
         const latCell   = chalk.dim(latStr.padEnd(W_LAT))
 
-        lines.push(`  ${timeCell}  ${provCell}  ${modelCell}  ${statusCell}  ${tokCell}  ${latCell}`)
+        lines.push(`  ${timeCell}  ${provCell}  ${modelCell}  ${routeCell}  ${statusCell}  ${tokCell}  ${latCell}`)
       }
     }
 
@@ -892,6 +1107,7 @@ export function createOverlayRenderers(state, deps) {
 
   return {
     renderSettings,
+    renderInstallEndpoints,
     renderHelp,
     renderLog,
     renderRecommend,

package/src/provider-metadata.js

@@ -114,7 +114,9 @@ export const PROVIDER_METADATA = {
     label: 'Hugging Face Inference',
     color: chalk.rgb(255, 245, 157),
     signupUrl: 'https://huggingface.co/settings/tokens',
-    signupHint: 'Settings → Access Tokens',
+    // 📖 Hugging Face serverless inference now expects a fine-grained token with
+    // 📖 the dedicated Inference Providers permission, not a generic read token.
+    signupHint: 'Settings → Access Tokens → Fine-grained → enable "Make calls to Inference Providers"',
     rateLimits: 'Free monthly credits (~$0.10)',
   },
   replicate: {

package/src/proxy-server.js

@@ -254,7 +254,28 @@ export class ProxyServer {
       })
     }
 
+    const formatSwitchReason = (classified) => {
+      switch (classified?.type) {
+        case 'QUOTA_EXHAUSTED':
+          return 'quota'
+        case 'RATE_LIMITED':
+          return '429'
+        case 'MODEL_NOT_FOUND':
+          return '404'
+        case 'MODEL_CAPACITY':
+          return 'capacity'
+        case 'SERVER_ERROR':
+          return '5xx'
+        case 'NETWORK_ERROR':
+          return 'network'
+        default:
+          return 'retry'
+      }
+    }
+
     // 5. Retry loop
+    let pendingSwitchReason = null
+    let previousAccount = null
     for (let attempt = 0; attempt < this._retries; attempt++) {
       // First attempt: respect sticky session.
       // Subsequent retries: fresh P2C (don't hammer the same failed account).
@@ -264,7 +285,13 @@ export class ProxyServer {
       const account = this._accountManager.selectAccount(selectOpts)
       if (!account) break // No available accounts → fall through to 503
 
-      const result = await this._forwardRequest(account, body, clientRes)
+      const result = await this._forwardRequest(account, body, clientRes, {
+        requestedModel,
+        switched: attempt > 0,
+        switchReason: pendingSwitchReason,
+        switchedFromProviderKey: previousAccount?.providerKey,
+        switchedFromModelId: previousAccount?.modelId,
+      })
 
       // Response fully sent (success JSON or SSE pipe established)
       if (result.done) return
@@ -292,6 +319,8 @@ export class ProxyServer {
         )
       }
       // shouldRetry === true → next attempt
+      pendingSwitchReason = formatSwitchReason(classified)
+      previousAccount = account
     }
 
     // All retries consumed, or no accounts available from the start
@@ -314,9 +343,10 @@ export class ProxyServer {
    * @param {{ id: string, apiKey: string, modelId: string, url: string }} account
    * @param {object} body
    * @param {http.ServerResponse} clientRes
+   * @param {{ requestedModel?: string, switched?: boolean, switchReason?: string|null, switchedFromProviderKey?: string, switchedFromModelId?: string }} [logContext]
    * @returns {Promise<{ done: boolean }>}
    */
-  _forwardRequest(account, body, clientRes) {
+  _forwardRequest(account, body, clientRes, logContext = {}) {
     return new Promise(resolve => {
       // Replace client-supplied model name with the account's model ID
       const newBody = { ...body, model: account.modelId }
@@ -392,6 +422,11 @@ export class ProxyServer {
                 completionTokens,
                 latencyMs: Date.now() - startTime,
                 success: true,
+                requestedModelId: logContext.requestedModel,
+                switched: logContext.switched === true,
+                switchReason: logContext.switchReason,
+                switchedFromProviderKey: logContext.switchedFromProviderKey,
+                switchedFromModelId: logContext.switchedFromModelId,
               })
               this._accountManager.recordSuccess(account.id, Date.now() - startTime)
               const quotaUpdated = this._accountManager.updateQuota(account.id, headers)
@@ -445,6 +480,11 @@ export class ProxyServer {
                 completionTokens,
                 latencyMs,
                 success: true,
+                requestedModelId: logContext.requestedModel,
+                switched: logContext.switched === true,
+                switchReason: logContext.switchReason,
+                switchedFromProviderKey: logContext.switchedFromProviderKey,
+                switchedFromModelId: logContext.switchedFromModelId,
               })
 
               // Forward stripped response to client
@@ -474,6 +514,11 @@ export class ProxyServer {
               completionTokens: 0,
               latencyMs,
               success: false,
+              requestedModelId: logContext.requestedModel,
+              switched: logContext.switched === true,
+              switchReason: logContext.switchReason,
+              switchedFromProviderKey: logContext.switchedFromProviderKey,
+              switchedFromModelId: logContext.switchedFromModelId,
             })
             resolve({
               done: false,
@@ -499,6 +544,11 @@ export class ProxyServer {
           completionTokens: 0,
           latencyMs,
           success: false,
+          requestedModelId: logContext.requestedModel,
+          switched: logContext.switched === true,
+          switchReason: logContext.switchReason,
+          switchedFromProviderKey: logContext.switchedFromProviderKey,
+          switchedFromModelId: logContext.switchedFromModelId,
         })
         // TCP / DNS / timeout errors
         resolve({

package/src/render-helpers.js

@@ -190,21 +190,27 @@ export function sortResultsWithPinnedFavorites(results, sortColumn, sortDirectio
 // 📖 renderProxyStatusLine: Maps proxyStartupStatus + active proxy into a chalk-coloured footer line.
 // 📖 Always returns a non-empty string (no hidden states) so the footer row is always present.
 // 📖 Delegates state classification to the pure getProxyStatusInfo helper (testable in utils.js).
-export function renderProxyStatusLine(proxyStartupStatus, proxyInstance) {
-  const info = getProxyStatusInfo(proxyStartupStatus, !!proxyInstance)
+export function renderProxyStatusLine(proxyStartupStatus, proxyInstance, proxyEnabled = false) {
+  const activeStatus = typeof proxyInstance?.getStatus === 'function' ? proxyInstance.getStatus() : null
+  const hasLiveProxy = Boolean(proxyInstance) && activeStatus?.running !== false
+  const info = getProxyStatusInfo(proxyStartupStatus, hasLiveProxy, proxyEnabled)
+  const neonGreen = chalk.rgb(57, 255, 20)
   switch (info.state) {
     case 'starting':
       return chalk.dim('  ') + chalk.yellow('⟳ Proxy') + chalk.dim(' starting…')
     case 'running': {
-      const portPart  = info.port        ? chalk.dim(` :${info.port}`) : ''
-      const acctPart  = info.accountCount != null ? chalk.dim(` · ${info.accountCount} account${info.accountCount === 1 ? '' : 's'}`) : ''
-      return chalk.dim('  ') + chalk.rgb(57, 255, 20)('🔀 Proxy') + chalk.rgb(57, 255, 20)(' running') + portPart + acctPart
+      const resolvedPort = info.port ?? activeStatus?.port ?? activeStatus?.listeningPort ?? null
+      const resolvedAccountCount = info.accountCount ?? activeStatus?.accountCount ?? proxyInstance?._accounts?.length ?? null
+      const portPart  = resolvedPort ? chalk.dim(` :${resolvedPort}`) : ''
+      const acctPart  = resolvedAccountCount != null ? chalk.dim(` · ${resolvedAccountCount} account${resolvedAccountCount === 1 ? '' : 's'}`) : ''
+      return chalk.dim('  ') + neonGreen('🔀 Proxy running') + portPart + acctPart
     }
     case 'failed':
-      return chalk.dim('  ') + chalk.red('✗ Proxy failed') + chalk.dim(` — ${info.reason}`)
+      return chalk.dim('  ') + chalk.red('🔀 Proxy Stopped') + chalk.dim(` — ${info.reason}`)
+    case 'configured':
+      return chalk.dim('  ') + chalk.cyan('🔀 Proxy configured') + chalk.dim(' — OpenCode rotation')
     default:
-      // stopped / not configured — dim but always present
-      return chalk.dim('  🔀 Proxy not configured')
+      return chalk.dim('  ') + chalk.red('🔀 Proxy Stopped')
   }
 }
 

package/src/render-table.js

@@ -14,6 +14,8 @@
  *   - Viewport clipping with above/below indicators
  *   - Smart badges (mode, tier filter, origin filter, profile)
  *   - Proxy status line integrated in footer
+ *   - Install-endpoints shortcut surfaced directly in the footer hints
+ *   - Distinct auth-failure vs missing-key health labels so configured providers stay honest
  *
  *   → Functions:
  *   - `setActiveProxy` — Provide the active proxy instance for footer status rendering
@@ -35,7 +37,7 @@ import { createRequire } from 'module'
 import { sources } from '../sources.js'
 import { PING_INTERVAL, FRAMES } from './constants.js'
 import { TIER_COLOR } from './tier-colors.js'
-import { getAvg, getVerdict, getUptime, getStabilityScore } from './utils.js'
+import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from './utils.js'
 import { usagePlaceholderForProvider } from './ping.js'
 import { formatTokenTotalCompact } from './token-usage-reader.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, renderProxyStatusLine, padEndDisplay } from './render-helpers.js'
@@ -89,7 +91,7 @@ export function setActiveProxy(proxyInstance) {
 }
 
 // ─── renderTable: mode param controls footer hint text (opencode vs openclaw) ─────────
-export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false) {
+export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, proxyEnabled = false) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -137,6 +139,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     : chalk.bold.rgb(0, 200, 255)
   const modeBadge = toolBadgeColor(' [ ') + chalk.yellow.bold('Z') + toolBadgeColor(` Tool : ${toolMeta.label} ]`)
   const activeHeaderBadge = (text, bg = [57, 255, 20], fg = [0, 0, 0]) => chalk.bgRgb(...bg).rgb(...fg).bold(` ${text} `)
+  const versionStatus = getVersionStatusInfo(settingsUpdateState, settingsUpdateLatestVersion)
 
   // 📖 Tier filter badge shown when filtering is active (shows exact tier name)
   const TIER_CYCLE_NAMES = [null, 'S+', 'S', 'A+', 'A', 'A-', 'B+', 'B', 'C']
@@ -433,6 +436,11 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       // 📖 Server responded but needs an API key — shown dimly since it IS reachable
       statusText = `🔑 NO KEY`
       statusColor = (s) => chalk.dim(s)
+    } else if (r.status === 'auth_error') {
+      // 📖 A key is configured but the provider rejected it — keep this distinct
+      // 📖 from "no key" so configured-only mode does not look misleading.
+      statusText = `🔐 AUTH FAIL`
+      statusColor = (s) => chalk.redBright(s)
     } else if (r.status === 'pending') {
       statusText = `${FRAMES[frame % FRAMES.length]} wait`
       statusColor = (s) => chalk.dim.yellow(s)
@@ -634,10 +642,15 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     chalk.dim(`  •  `) +
     hotkey('K', ' Help')
   )
-  // 📖 Line 2: profiles, recommend, feature request, bug report, and extended hints — gives visibility to less-obvious features
-  lines.push(chalk.dim(`  `) + hotkey('⇧P', ' Cycle profile') + chalk.dim(`  •  `) + hotkey('⇧S', ' Save profile') + chalk.dim(`  •  `) + hotkey('Q', ' Smart Recommend') + chalk.dim(`  •  `) + hotkey('J', ' Request feature') + chalk.dim(`  •  `) + hotkey('I', ' Report bug'))
+  // 📖 Line 2: profiles, install flow, recommend, feature request, bug report, and extended hints.
+  lines.push(chalk.dim(`  `) + hotkey('⇧P', ' Cycle profile') + chalk.dim(`  •  `) + hotkey('⇧S', ' Save profile') + chalk.dim(`  •  `) + hotkey('Y', ' Install endpoints') + chalk.dim(`  •  `) + hotkey('Q', ' Smart Recommend') + chalk.dim(`  •  `) + hotkey('J', ' Request feature') + chalk.dim(`  •  `) + hotkey('I', ' Report bug'))
   // 📖 Proxy status line — always rendered with explicit state (starting/running/failed/stopped)
-  lines.push(renderProxyStatusLine(proxyStartupStatus, activeProxyRef))
+  lines.push(renderProxyStatusLine(proxyStartupStatus, activeProxyRef, proxyEnabled))
+  if (versionStatus.isOutdated) {
+    const outdatedBadge = chalk.bgRed.bold.yellow(' This version is outdated . ')
+    const latestLabel = chalk.redBright(` local v${LOCAL_VERSION} · latest v${versionStatus.latestVersion}`)
+    lines.push(`  ${outdatedBadge}${latestLabel}`)
+  }
   lines.push(
     chalk.rgb(255, 150, 200)('  Made with 💖 & ☕ by \x1b]8;;https://github.com/vava-nessa\x1b\\vava-nessa\x1b]8;;\x1b\\') +
     chalk.dim('  •  ') +

package/src/token-stats.js

@@ -100,7 +100,7 @@ export class TokenStats {
   /**
    * Record a single request's token usage.
    *
-   * @param {{ accountId: string, modelId: string, providerKey?: string, statusCode?: number|string, requestType?: string, promptTokens?: number, completionTokens?: number, latencyMs?: number, success?: boolean }} entry
+   * @param {{ accountId: string, modelId: string, providerKey?: string, statusCode?: number|string, requestType?: string, promptTokens?: number, completionTokens?: number, latencyMs?: number, success?: boolean, requestedModelId?: string, switched?: boolean, switchReason?: string, switchedFromProviderKey?: string, switchedFromModelId?: string }} entry
    */
   record(entry) {
     const {
@@ -113,6 +113,11 @@ export class TokenStats {
       completionTokens = 0,
       latencyMs = 0,
       success = true,
+      requestedModelId,
+      switched = false,
+      switchReason,
+      switchedFromProviderKey,
+      switchedFromModelId,
     } = entry
     const totalTokens = promptTokens + completionTokens
     const now = new Date()
@@ -157,6 +162,11 @@ export class TokenStats {
         completionTokens,
         latencyMs,
         success,
+        ...(typeof requestedModelId === 'string' && requestedModelId.length > 0 && { requestedModelId }),
+        ...(switched === true && { switched: true }),
+        ...(typeof switchReason === 'string' && switchReason.length > 0 && { switchReason }),
+        ...(typeof switchedFromProviderKey === 'string' && switchedFromProviderKey.length > 0 && { switchedFromProviderKey }),
+        ...(typeof switchedFromModelId === 'string' && switchedFromModelId.length > 0 && { switchedFromModelId }),
       }
       appendFileSync(this._logFile, JSON.stringify(logEntry) + '\n')
     } catch { /* ignore */ }