free-coding-models 0.3.55 → 0.3.57

package/src/kilo.js

@@ -9,6 +9,7 @@ import { loadKiloConfig, saveKiloConfig, getKiloConfigPath } from './kilo-config
 import { getApiKey } from './config.js'
 import { ENV_VAR_NAMES, OPENCODE_MODEL_MAP } from './provider-metadata.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
+import { sources } from '../sources.js'
 
 // 📖 Map source model IDs to Kilo built-in IDs (same as OpenCode).
 function getKiloModelId(providerKey, modelId) {
@@ -17,6 +18,21 @@ function getKiloModelId(providerKey, modelId) {
   return OPENCODE_MODEL_MAP[providerKey]?.[modelId] || modelId
 }
 
+function buildOpenAiCompatibleProviderConfig(providerKey) {
+  const source = sources[providerKey]
+  const envVarName = ENV_VAR_NAMES[providerKey]
+  if (!source?.url || !envVarName) return null
+  const baseURL = source.url
+    .replace(/\/chat\/completions$/i, '')
+    .replace(/\/responses$/i, '')
+  return {
+    npm: '@ai-sdk/openai-compatible',
+    name: source.name || providerKey,
+    options: { baseURL, apiKey: `{env:${envVarName}}` },
+    models: {},
+  }
+}
+
 // 📖 spawnKilo: Resolve API keys + spawn kilo CLI with correct env.
 async function spawnKilo(args, providerKey, fcmConfig) {
   const envVarName = ENV_VAR_NAMES[providerKey]
@@ -120,7 +136,7 @@ export async function startKilo(model, fcmConfig) {
       config.provider.codestral = {
         npm: '@ai-sdk/openai-compatible',
         name: 'Mistral Codestral',
-        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:CODESTRAL_API_KEY}' },
+        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:MISTRAL_API_KEY}' },
         models: {}
       }
     } else if (providerKey === 'hyperbolic') {
@@ -179,6 +195,9 @@ export async function startKilo(model, fcmConfig) {
         options: { baseURL: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1', apiKey: '{env:OVH_AI_ENDPOINTS_ACCESS_TOKEN}' },
         models: {}
       }
+    } else {
+      const providerConfig = buildOpenAiCompatibleProviderConfig(providerKey)
+      if (providerConfig) config.provider[providerKey] = providerConfig
     }
   }
 

package/src/opencode.js

@@ -98,6 +98,21 @@ function getOpenCodeModelId(providerKey, modelId) {
   return OPENCODE_MODEL_MAP[providerKey]?.[modelId] || modelId
 }
 
+function buildOpenAiCompatibleProviderConfig(providerKey) {
+  const source = sources[providerKey]
+  const envVarName = ENV_VAR_NAMES[providerKey]
+  if (!source?.url || !envVarName) return null
+  const baseURL = source.url
+    .replace(/\/chat\/completions$/i, '')
+    .replace(/\/responses$/i, '')
+  return {
+    npm: '@ai-sdk/openai-compatible',
+    name: source.name || providerKey,
+    options: { baseURL, apiKey: `{env:${envVarName}}` },
+    models: {},
+  }
+}
+
 // ─── ZAI proxy bridge ─────────────────────────────────────────────────────────
 
 // 📖 createZaiProxy: Localhost reverse proxy bridging ZAI's non-standard API paths
@@ -434,7 +449,7 @@ export async function startOpenCode(model, fcmConfig) {
       config.provider.codestral = {
         npm: '@ai-sdk/openai-compatible',
         name: 'Mistral Codestral',
-        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:CODESTRAL_API_KEY}' },
+        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:MISTRAL_API_KEY}' },
         models: {}
       }
     } else if (providerKey === 'hyperbolic') {
@@ -514,6 +529,9 @@ export async function startOpenCode(model, fcmConfig) {
         options: { baseURL: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1', apiKey: '{env:OVH_AI_ENDPOINTS_ACCESS_TOKEN}' },
         models: {}
       }
+    } else {
+      const providerConfig = buildOpenAiCompatibleProviderConfig(providerKey)
+      if (providerConfig) config.provider[providerKey] = providerConfig
     }
   }
 
@@ -799,7 +817,7 @@ export async function startOpenCodeDesktop(model, fcmConfig) {
       config.provider.codestral = {
         npm: '@ai-sdk/openai-compatible',
         name: 'Mistral Codestral',
-        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:CODESTRAL_API_KEY}' },
+        options: { baseURL: 'https://api.mistral.ai/v1', apiKey: '{env:MISTRAL_API_KEY}' },
         models: {}
       }
     } else if (providerKey === 'hyperbolic') {
@@ -879,6 +897,9 @@ export async function startOpenCodeDesktop(model, fcmConfig) {
         options: { baseURL: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1', apiKey: '{env:OVH_AI_ENDPOINTS_ACCESS_TOKEN}' },
         models: {}
       }
+    } else {
+      const providerConfig = buildOpenAiCompatibleProviderConfig(providerKey)
+      if (providerConfig) config.provider[providerKey] = providerConfig
     }
   }
 

package/src/overlays.js

@@ -4,17 +4,16 @@
  *
  * @details
  *   This module centralizes all overlay rendering in one place:
- *   - Settings, Install Endpoints, Command Palette, Help, Smart Recommend, Feedback, Changelog
+ *   - Settings, Install Endpoints, Command Palette, Help, Smart Recommend, Changelog, Router Dashboard
  *   - 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
  *   allowing the main CLI to control shared state and dependencies.
  *
- *   📖 Feedback overlay (I key) combines feature requests + bug reports in one left-aligned input
- *
  *   → Functions:
  *   - `createOverlayRenderers` — returns renderer + analysis helpers + overlayLayout
+ *   - `renderRouterDashboard` — mounts the Smart Model Router dashboard renderer
  *
  * @exports { createOverlayRenderers }
  * @see ./key-handler.js — handles keypresses for all overlay interactions
@@ -22,6 +21,7 @@
 
 import { loadChangelog } from './changelog-loader.js'
 import { buildCliHelpLines } from './cli-help.js'
+import { renderRouterDashboard as renderRouterDashboardOverlay } from './router-dashboard.js'
 import { themeColors, getThemeStatusLabel, getProviderRgb } from './theme.js'
 
 export function createOverlayRenderers(state, deps) {
@@ -297,12 +297,16 @@ export function createOverlayRenderers(state, deps) {
     }
     lines.push('')
 
-    // 📖 Footer with credits
+    // 📖 Footer with credits + community links — Discord and Buy me a coffee
+    // 📖 live here (and in the onboarding) instead of the main TUI footer to
+    // 📖 keep the table chrome lean.
     lines.push('')
     lines.push(
       themeColors.dim('  ') +
       themeColors.footerLove('Made with 💖 & ☕ by ') +
       themeColors.link('\x1b]8;;https://github.com/vava-nessa\x1b\\vava-nessa\x1b]8;;\x1b\\') +
+      themeColors.dim('  •  💬 ') +
+      themeColors.footerDiscord('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Join the Discord\x1b]8;;\x1b\\') +
       themeColors.dim('  •  ☕ ') +
       themeColors.footerCoffee('\x1b]8;;https://buymeacoffee.com/vavanessadev\x1b\\Buy me a coffee\x1b]8;;\x1b\\') +
       themeColors.dim('  •  ') +
@@ -866,8 +870,9 @@ export function createOverlayRenderers(state, deps) {
     // 📖 Branding header
     lines.push(`  ${themeColors.accent('🚀')} ${themeColors.accentBold('free-coding-models')} ${themeColors.dim(`v${LOCAL_VERSION}`)}`)
     lines.push(`  ${heading('❓ Help & Keyboard Shortcuts')}`)
+    lines.push(`  ${themeColors.successBold('🔑 Yellow = active key')}`)
     lines.push('')
-    lines.push(`  ${hint('— ↑↓ / PgUp / PgDn / Home / End scroll • K or Esc close')}`)
+    lines.push(`  ${hint('— ↑↓ / PgUp / PgDn / Home / End scroll • K or ')}${themeColors.successBold('Esc close')}`)
     lines.push(`  ${heading('Columns')}`)
     lines.push('')
     lines.push(`  ${label('Rank')}        SWE-bench rank (1 = best coding score)  ${hint('Sort:')} ${key('R')}`)
@@ -882,7 +887,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${label('CTX')}         Context window size (128k, 200k, 256k, 1m, etc.)  ${hint('Sort:')} ${key('C')}`)
     lines.push(`              ${hint('Bigger context = the model can read more of your codebase at once without forgetting.')}`)
     lines.push('')
-    lines.push(`  ${label('Model')}       Model name (⭐ = favorited)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
+    lines.push(`  ${label('Model')}       Model name (1️⃣2️⃣3️⃣ = favorite order)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
     lines.push(`              ${hint('Star the ones you like. Press Y to switch between pinned mode and normal filter/sort mode.')}`)
     lines.push('')
     lines.push(`  ${label('Provider')}    Provider source (NIM, Groq, Cerebras, etc.)  ${hint('Sort:')} ${key('O')}  ${hint('Cycle:')} ${key('D')}`)
@@ -923,17 +928,18 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
     lines.push(`  ${key('E')}  Toggle configured models only  ${hint('(enabled by default)')}`)
     lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(📦 OpenCode → π Pi → 🪼 jcode → 📦 Desktop → 🦞 OpenClaw → 💘 Crush → 🪿 Goose → 🛠 Aider → 🐉 Qwen → 🤲 OpenHands → ⚡ Amp → 🦘 Rovo → ♊ Gemini)')}`)
-    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(⭐ persisted across sessions)')}`)
+    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(1️⃣2️⃣3️⃣ = router fallback order, capped at 🔟)')}`)
+    lines.push(`  ${key('⇧↑/⇧↓')}  Reorder selected favorite up/down  ${hint('(changes router priority)')}`)
     lines.push(`  ${key('Y')}  Toggle favorites mode  ${hint('(Pinned + always visible ↔ Normal filter/sort behavior)')}`)
     lines.push(`  ${key('X')}  Clear active text filter  ${hint('(remove custom query applied from ⚡️ Command Palette)')}`)
     lines.push(`  ${key('Q')}  Smart Recommend  ${hint('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${key('G')}  Cycle theme  ${hint('(auto → dark → light)')}`)
-    lines.push(`  ${themeColors.errorBold('I')}  Feedback, bugs & requests  ${hint('(📝 send anonymous feedback, bug reports, or feature requests)')}`)
+
     lines.push(`  ${key('P')}  Open settings  ${hint('(manage API keys, provider toggles, updates, legacy cleanup)')}`)
       // 📖 Profile system removed - API keys now persist permanently across all sessions
-    lines.push(`  ${key('Shift+R')}  Reset view settings  ${hint('(tier filter, sort, provider filter → defaults)')}`)
+    lines.push(`  ${key('Ctrl+P')}  Reset view settings  ${hint('(search "Reset view" in the command palette)')}`)
     lines.push(`  ${key('N')}  Changelog  ${hint('(📋 browse all versions, Enter to view details)')}`)
-    lines.push(`  ${key('Ctrl+H')} / ${key('Esc')}  Show/hide this help`)
+    lines.push(`  ${key('I')} / ${key('Esc')}  Show/hide this help`)
     lines.push(`  ${key('Ctrl+C')}  Exit`)
     lines.push('')
     lines.push(`  ${heading('Settings (P)')}`)
@@ -1166,92 +1172,6 @@ export function createOverlayRenderers(state, deps) {
     }, PING_RATE)
   }
 
-  // ─── Feedback overlay renderer ────────────────────────────────────────────
-  // 📖 renderFeedback: Draw the overlay for anonymous Discord feedback.
-  // 📖 Shows an input field where users can type feedback, bug reports, or any comments.
-  function renderFeedback() {
-    const EL = '\x1b[K'
-    const lines = []
-
-    // 📖 Calculate available space for multi-line input (dynamic based on terminal width)
-    const maxInputWidth = state.terminalCols - 8 // 8 = padding (4 spaces each side)
-    const maxInputLines = 10 // Show up to 10 lines of input
-    
-    // 📖 Split buffer into lines for display (with wrapping)
-    const wrapText = (text, width) => {
-      const words = text.split(' ')
-      const lines = []
-      let currentLine = ''
-      
-      for (const word of words) {
-        const testLine = currentLine ? currentLine + ' ' + word : word
-        if (testLine.length <= width) {
-          currentLine = testLine
-        } else {
-          if (currentLine) lines.push(currentLine)
-          currentLine = word
-        }
-      }
-      if (currentLine) lines.push(currentLine)
-      return lines
-    }
-
-    const inputLines = wrapText(state.bugReportBuffer, maxInputWidth)
-    const displayLines = inputLines.slice(0, maxInputLines)
-
-    // 📖 Branding header
-    lines.push('')
-    lines.push(`  ${themeColors.accent('🚀')} ${themeColors.accentBold('free-coding-models')} ${themeColors.dim(`v${LOCAL_VERSION}`)}`)
-    lines.push(`  ${themeColors.successBold('📝 Feedback, bugs & requests')}`)
-    lines.push('')
-    lines.push(themeColors.dim("  — don't hesitate to send us feedback, bug reports, or just your feeling about the app"))
-    lines.push('')
-    
-    // 📖 Status messages (if any)
-    if (state.bugReportStatus === 'sending') {
-      lines.push(`  ${themeColors.warning('⏳ Sending...')}`)
-      lines.push('')
-    } else if (state.bugReportStatus === 'success') {
-      lines.push(`  ${themeColors.successBold('✅ Successfully sent!')} ${themeColors.dim('Closing overlay in 3 seconds...')}`)
-      lines.push('')
-      lines.push(`  ${themeColors.dim('Thank you for your feedback! It has been sent to the project team.')}`)
-      lines.push('')
-    } else if (state.bugReportStatus === 'error') {
-      lines.push(`  ${themeColors.error('❌ Error:')} ${themeColors.warning(state.bugReportError || 'Failed to send')}`)
-      lines.push(`  ${themeColors.dim('Press Backspace to edit, or Esc to close')}`)
-      lines.push('')
-    } else {
-      lines.push(`  ${themeColors.dim('Type your feedback below. Press Enter to send, Esc to cancel.')}`)
-      lines.push(`  ${themeColors.dim('Your message will be sent anonymously to the project team.')}`)
-      lines.push('')
-    }
-
-    // 📖 Simple input area – left-aligned, framed by horizontal lines
-    lines.push(`  ${themeColors.info('Message')} (${state.bugReportBuffer.length}/500 chars)`)
-    lines.push(`  ${themeColors.dim('─'.repeat(maxInputWidth))}`)
-    // 📖 Input lines — left-aligned, or placeholder when empty
-    if (displayLines.length > 0) {
-      for (const line of displayLines) {
-        lines.push(`    ${line}`)
-      }
-      // 📖 Show cursor on last line
-      if (state.bugReportStatus === 'idle' || state.bugReportStatus === 'error') {
-        lines[lines.length - 1] += themeColors.accentBold('▏')
-      }
-    } else {
-      const placeholderBR = state.bugReportStatus === 'idle' ? chalk.italic.rgb(...getProviderRgb('googleai'))('Type your message here...') : ''
-      lines.push(`    ${placeholderBR}${themeColors.accentBold('▏')}`)
-    }
-    lines.push(`  ${themeColors.dim('─'.repeat(maxInputWidth))}`)
-    lines.push('')
-    lines.push(themeColors.dim('  Enter Send  •  Esc Cancel  •  Backspace Delete'))
-
-    // 📖 Apply overlay tint and return
-    const tintedLines = tintOverlayLines(lines, themeColors.overlayBgFeedback, state.terminalCols)
-    const cleared = tintedLines.map(l => l + EL)
-    return cleared.join('\n')
-  }
-
   // ─── Changelog overlay renderer ───────────────────────────────────────────
   // 📖 renderChangelog: Two-phase overlay — index of all versions or details of one version
   function renderChangelog() {
@@ -1394,6 +1314,10 @@ export function createOverlayRenderers(state, deps) {
     if (state.recommendPingTimer) { clearInterval(state.recommendPingTimer); state.recommendPingTimer = null }
   }
 
+  function renderRouterDashboard() {
+    return renderRouterDashboardOverlay(state, { LOCAL_VERSION })
+  }
+
   // ─── Incompatible fallback overlay ─────────────────────────────────────────
   // 📖 renderIncompatibleFallback shows when user presses Enter on a model that
   // 📖 is NOT compatible with the active tool. Two sections:
@@ -1490,6 +1414,181 @@ export function createOverlayRenderers(state, deps) {
     return cleared.join('\n')
   }
 
+
+  // ─── Token Usage screen renderer ───────────────────────────────────────────
+  // 📖 renderTokenUsage: shows today/all-time breakdowns, by-model breakdown,
+  // 📖 and a 7-day bar chart. Triggered by Shift+T from the main table.
+  // 📖 Data fetched from GET /stats/tokens on the daemon.
+  function renderTokenUsage() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+
+    lines.push('')
+    lines.push(`  ${themeColors.accent('🚀')} ${themeColors.accentBold('free-coding-models')} ${themeColors.dim(`v${LOCAL_VERSION}`)}`)
+    lines.push(`  ${themeColors.textBold('📊 Token Usage')}  ${themeColors.dim('Shift+T from main table')}`)
+    lines.push('')
+
+    const data = state.tokenUsageData
+
+    if (state.tokenUsageError) {
+      lines.push(`  ${themeColors.warning(state.tokenUsageError)}`)
+      lines.push('')
+      lines.push(themeColors.dim('  Press Shift+S to start the router daemon first, then reopen this screen.'))
+      lines.push(themeColors.dim('  Esc to return to the main table'))
+      const { visible, offset } = sliceOverlayLines(lines, state.tokenUsageScrollOffset, state.terminalRows)
+      state.tokenUsageScrollOffset = offset
+      const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+      return tintedLines.map((l) => l + EL).join('\n')
+    }
+
+    if (!data) {
+      lines.push(themeColors.dim('  Loading token stats...'))
+      const { visible, offset } = sliceOverlayLines(lines, state.tokenUsageScrollOffset, state.terminalRows)
+      state.tokenUsageScrollOffset = offset
+      const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+      return tintedLines.map((l) => l + EL).join('\n')
+    }
+
+    const today = data.today || {}
+    const allTime = data.all_time || {}
+    const dailyData = data.daily || {}
+
+    const todayTotal = today.total_tokens || 0
+    const todayPrompt = today.prompt_tokens || 0
+    const todayCompletion = today.completion_tokens || 0
+    const todayReq = today.requests || 0
+    const allTimeTotal = allTime.total_tokens || 0
+    const allTimeReq = allTime.requests || 0
+    const firstTracked = allTime.first_tracked || null
+
+    lines.push(`  ${themeColors.textBold('TODAY')}  ${themeColors.dim(new Date().toISOString().slice(0, 10))}  ${themeColors.dim('|')}  ${themeColors.textBold('ALL TIME')}`)
+    lines.push(`  ${themeColors.dim('─'.repeat(40))}  ${themeColors.dim('─'.repeat(30))}`)
+    lines.push(`  ${themeColors.textBold('Total:')}     ${themeColors.info(formatTokenTotalCompact(todayTotal))} tok  ${themeColors.dim('│')}  ${themeColors.textBold('Total:')}  ${themeColors.info(formatTokenTotalCompact(allTimeTotal))} tok`)
+    lines.push(`  ${themeColors.textBold('Prompt:')}   ${themeColors.dim(formatTokenTotalCompact(todayPrompt))} tok  ${themeColors.dim('│')}  ${themeColors.textBold('Requests:')} ${themeColors.dim(String(allTimeReq))}`)
+    lines.push(`  ${themeColors.textBold('Completion:')} ${themeColors.dim(formatTokenTotalCompact(todayCompletion))} tok  ${themeColors.dim('│')}  ${themeColors.textBold('Since:')} ${themeColors.dim(firstTracked ? new Date(firstTracked).toLocaleDateString() : '—')}`)
+    lines.push(`  ${themeColors.textBold('Requests:')} ${themeColors.dim(String(todayReq))}  ${themeColors.dim('│')}`)
+
+    const byModel = today.by_model || {}
+    const sortedModels = Object.entries(byModel)
+      .map(([key, val]) => {
+        // 📖 val can be a number (legacy) or { total, prompt, completion } object
+        const total = (val && typeof val === 'object' && !Array.isArray(val)) ? (val.total || 0) : Number(val) || 0
+        return { key, total }
+      })
+      .filter((m) => m.total > 0)
+      .sort((a, b) => b.total - a.total)
+      .slice(0, 8)
+
+    lines.push('')
+    lines.push(`  ${themeColors.textBold('TOP MODELS TODAY')}`)
+    if (sortedModels.length === 0) {
+      lines.push(themeColors.dim('  No usage tracked yet today.'))
+    } else {
+      const maxTotal = sortedModels[0]?.total || 1
+      for (const m of sortedModels) {
+        const barLen = Math.max(2, Math.round((m.total / maxTotal) * 28))
+        const bar = themeColors.success('█'.repeat(barLen)) + themeColors.dim('░'.repeat(28 - barLen))
+        const pct = todayTotal > 0 ? Math.round((m.total / todayTotal) * 100) : 0
+        lines.push(`  ${bar}  ${themeColors.textBold(formatTokenTotalCompact(m.total))} tok  ${themeColors.dim(`${pct}%  ${m.key}`)}`)
+      }
+    }
+
+    lines.push('')
+    lines.push(`  ${themeColors.textBold('LAST 7 DAYS')}`)
+    const dayLabels = []
+    const dayTotals = []
+    for (let i = 6; i >= 0; i--) {
+      const d = new Date()
+      d.setDate(d.getDate() - i)
+      const key = d.toISOString().slice(0, 10)
+      const dayData = dailyData[key]
+      const total = dayData?.total_tokens || 0
+      dayLabels.push(d.toLocaleDateString('en-US', { weekday: 'short' }))
+      dayTotals.push(total)
+    }
+    const maxDay = Math.max(...dayTotals, 1)
+    lines.push(`  ${dayLabels.map((l, i) => themeColors.dim(padEndDisplay(l, 6))).join(' ')}`)
+    const barHeights = [14, 10, 7, 4]
+    for (const bh of barHeights) {
+      const row = dayTotals.map((t) => {
+        const filled = Math.round((t / maxDay) * bh)
+        const bar = themeColors.info('█'.repeat(filled)) + themeColors.dim('░'.repeat(bh - filled))
+        return padEndDisplay(bar, 6)
+      })
+      lines.push(`  ${row.join(' ')}`)
+    }
+    const totalRow = dayTotals.map((t) => padEndDisplay(themeColors.textBold(formatTokenTotalCompact(t)), 6))
+    lines.push(`  ${totalRow.join(' ')}`)
+
+    lines.push('')
+    lines.push(themeColors.dim('  Esc Back to main table'))
+
+    const { visible, offset } = sliceOverlayLines(lines, state.tokenUsageScrollOffset, state.terminalRows)
+    state.tokenUsageScrollOffset = offset
+    const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+    return tintedLines.map((l) => l + EL).join('\n')
+  }
+
+  // ─── Router Onboarding overlay renderer ─────────────────────────────────────
+  // 📖 renderRouterOnboarding: shown on first launch (no config.router) or
+  // 📖 first launch after upgrade (existing config but router.onboardingSeen !== true).
+  // 📖 Two options: Enable (Y) or Not now (N). Phase 6 — Smart Model Router.
+  function renderRouterOnboarding() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+
+    lines.push('')
+    lines.push(`  ${themeColors.accent('🚀')} ${themeColors.accentBold('free-coding-models')} ${themeColors.dim(`v${LOCAL_VERSION}`)}`)
+    lines.push(`  ${themeColors.textBold('🔀 Smart Router Available!')}`)
+    lines.push('')
+    lines.push(themeColors.dim('  FCM can run a background daemon that automatically'))
+    lines.push(themeColors.dim('  routes your requests to the fastest healthy model —'))
+    lines.push(themeColors.dim('  with zero manual intervention after initial setup.'))
+    lines.push('')
+
+    const options = [
+      { label: 'Yes, enable the router', hint: 'Recommended — creates default set and starts daemon', key: 'Y' },
+      { label: 'Not now', hint: 'You can enable it later from the TUI', key: 'N' },
+    ]
+
+    if (state.routerOnboardingPhase === 'loading') {
+      lines.push(themeColors.info('  Enabling router, please wait...'))
+    } else if (state.routerOnboardingPhase === 'success') {
+      lines.push(themeColors.success('  ✅ Router enabled! Dashboard opening...'))
+      lines.push(themeColors.dim('  Setup complete. Return to the main table to continue.'))
+    } else if (state.routerOnboardingPhase === 'error') {
+      lines.push(themeColors.error(`  ❌ ${state.routerOnboardingError || 'Failed to enable router'}`))
+      lines.push(themeColors.dim('  Press Esc or Enter to continue to the main table'))
+    } else {
+      for (let i = 0; i < options.length; i++) {
+        const opt = options[i]
+        const isCursor = i === state.routerOnboardingCursor
+        const keyLabel = themeColors.hotkey(`  ${opt.key}]`)
+        const row = `${bullet(isCursor)}${keyLabel} ${isCursor ? themeColors.textBold(opt.label) : themeColors.text(opt.label)}`
+        cursorLineByRow[i] = lines.length
+        lines.push(isCursor ? themeColors.bgCursorSettingsList(row) : row)
+        lines.push(themeColors.dim(`      ${opt.hint}`))
+        lines.push('')
+      }
+      lines.push(themeColors.dim('  ↑↓ Navigate  •  Enter Select  •  Esc Skip for now'))
+      lines.push('')
+      lines.push(
+        themeColors.dim('  💬 ') +
+        themeColors.footerDiscord('\x1b]8;;https://discord.gg/ZTNFHvvCkU\x1b\\Join the Discord community\x1b]8;;\x1b\\') +
+        themeColors.dim('  •  Get help, share feedback, follow updates')
+      )
+    }
+
+    const targetLine = cursorLineByRow[state.routerOnboardingCursor] ?? 0
+    state.routerOnboardingScrollOffset = keepOverlayTargetVisible(state.routerOnboardingScrollOffset, targetLine, lines.length, state.terminalRows)
+    const { visible, offset } = sliceOverlayLines(lines, state.routerOnboardingScrollOffset, state.terminalRows)
+    state.routerOnboardingScrollOffset = offset
+    const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+    return tintedLines.map((l) => l + EL).join('\n')
+  }
+
   return {
     renderSettings,
     renderInstallEndpoints,
@@ -1497,12 +1596,14 @@ export function createOverlayRenderers(state, deps) {
     renderCommandPalette,
     renderHelp,
     renderRecommend,
-    renderFeedback,
     renderChangelog,
     renderInstalledModels,
+    renderRouterDashboard,
     renderIncompatibleFallback,
+    renderTokenUsage,
+    renderRouterOnboarding,
     startRecommendAnalysis,
     stopRecommendAnalysis,
-    overlayLayout,  // 📖 Mouse support: exposes cursor-to-line maps for click handling
+    overlayLayout,
   }
 }

package/src/provider-metadata.js

@@ -45,22 +45,17 @@ export const ENV_VAR_NAMES = {
   cerebras:   'CEREBRAS_API_KEY',
   sambanova:  'SAMBANOVA_API_KEY',
   openrouter: 'OPENROUTER_API_KEY',
-  huggingface:'HUGGINGFACE_API_KEY',
-  replicate:  'REPLICATE_API_TOKEN',
-  deepinfra:  'DEEPINFRA_API_KEY',
-  fireworks:  'FIREWORKS_API_KEY',
-  codestral:  'CODESTRAL_API_KEY',
-  hyperbolic: 'HYPERBOLIC_API_KEY',
+  'github-models': 'GITHUB_TOKEN',
+  mistral:    'MISTRAL_API_KEY',
+  codestral:  'MISTRAL_API_KEY',
   scaleway:   'SCALEWAY_API_KEY',
   googleai:   'GOOGLE_API_KEY',
-  siliconflow:'SILICONFLOW_API_KEY',
-  together:   'TOGETHER_API_KEY',
   cloudflare: 'CLOUDFLARE_API_TOKEN',
-  perplexity: 'PERPLEXITY_API_KEY',
   zai:        'ZAI_API_KEY',
   gemini:     'GEMINI_API_KEY',
-  chutes:     'CHUTES_API_KEY',
   ovhcloud:   'OVH_AI_ENDPOINTS_ACCESS_TOKEN',
+  qwen:       'DASHSCOPE_API_KEY',
+  'opencode-zen': 'OPENCODE_ZEN_API_KEY',
 }
 
 // 📖 OPENCODE_MODEL_MAP: sparse table of model IDs that differ between sources.js and OpenCode's
@@ -103,7 +98,7 @@ export const PROVIDER_METADATA = {
     color: chalk.rgb(255, 224, 178),
     signupUrl: 'https://cloud.sambanova.ai/apis',
     signupHint: 'SambaCloud portal → Create API key',
-    rateLimits: 'Dev tier generous quota',
+    rateLimits: 'Small developer quota; useful for light coding and smoke tests',
   },
   openrouter: {
     label: 'OpenRouter',
@@ -113,6 +108,20 @@ export const PROVIDER_METADATA = {
     rateLimits: 'Free on :free: 50/day <$10, 1000/day ≥$10 (20 req/min)',
     detailedLimits: 'No credits (or <$10) → 50 requests/day (20 req/min)\n≥ $10 in credits → 1000 requests/day (20 req/min)\n• Free models (:free) never consume credits\n• Failed requests count toward quota\n• Quota resets daily at midnight UTC\n• Free-tier models may be rate-limited during peak hours',
   },
+  'github-models': {
+    label: 'GitHub Models',
+    color: chalk.rgb(183, 201, 255),
+    signupUrl: 'https://models.github.ai',
+    signupHint: 'Use a GitHub token with Models access (GITHUB_TOKEN works in GitHub contexts)',
+    rateLimits: 'Quota depends on GitHub/Copilot tier; no separate provider billing',
+  },
+  mistral: {
+    label: 'Mistral LP',
+    color: chalk.rgb(255, 196, 120),
+    signupUrl: 'https://console.mistral.ai/api-keys',
+    signupHint: 'La Plateforme → API keys (MISTRAL_API_KEY)',
+    rateLimits: 'Experiment plan: free evaluation tier with limited RPS/TPM/monthly tokens',
+  },
   huggingface: {
     label: 'Hugging Face Inference',
     color: chalk.rgb(255, 245, 157),
@@ -146,9 +155,9 @@ export const PROVIDER_METADATA = {
   codestral: {
     label: 'Mistral Codestral',
     color: chalk.rgb(248, 187, 208),
-    signupUrl: 'https://codestral.mistral.ai',
-    signupHint: 'API Keys → Create',
-    rateLimits: '30 req/min, 2000/day',
+    signupUrl: 'https://console.mistral.ai/api-keys',
+    signupHint: 'La Plateforme → API keys (MISTRAL_API_KEY; CODESTRAL_API_KEY also works)',
+    rateLimits: 'Codestral free access: 30 req/min, 2000/day',
   },
   hyperbolic: {
     label: 'Hyperbolic',
@@ -169,7 +178,7 @@ export const PROVIDER_METADATA = {
     color: chalk.rgb(187, 222, 251),
     signupUrl: 'https://aistudio.google.com/apikey',
     signupHint: 'Get API key',
-    rateLimits: '14.4K req/day, 30/min',
+    rateLimits: 'Gemini free quotas vary by model and region',
   },
   siliconflow: {
     label: 'SiliconFlow',
@@ -211,7 +220,7 @@ export const PROVIDER_METADATA = {
     color: chalk.rgb(174, 213, 255),
     signupUrl: 'https://z.ai',
     signupHint: 'Sign up and generate an API key',
-    rateLimits: 'Free tier (generous quota)',
+    rateLimits: 'Free tier: Flash models only in this catalog',
   },
   iflow: {
     label: 'iFlow',
@@ -240,7 +249,7 @@ export const PROVIDER_METADATA = {
     color: chalk.rgb(66, 165, 245), // blue
     signupUrl: 'https://github.com/google-gemini/gemini-cli',
     signupHint: 'Install: npm install -g @google/gemini-cli',
-    rateLimits: 'Free tier: 1,000 req/day (personal Google account, no credit card)',
+    rateLimits: 'Free tier: 1,000 req/day with personal Google account',
     cliOnly: true,
   },
   'opencode-zen': {

package/src/quota-capabilities.js

@@ -29,7 +29,7 @@
  * @property {'header'|'endpoint'|'unknown'} telemetryType
  * @property {boolean} [supportsEndpoint]
  * @property {'percent'|'ok'} usageDisplay
- * @property {'rolling'|'daily'|'unknown'|'none'} resetCadence
+ * @property {'rolling'|'daily'|'monthly'|'unknown'|'none'} resetCadence
  */
 
 /** @type {Record<string, ProviderCapability>} */
@@ -39,26 +39,22 @@ export const PROVIDER_CAPABILITIES = {
   groq: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'daily' },
   cerebras: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
   sambanova: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
-  deepinfra: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
-  fireworks: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
-  together: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
-  hyperbolic: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
+  'github-models': { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
+  mistral: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'monthly' },
   scaleway: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
   googleai: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'daily' },
   codestral: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'daily' },
-  perplexity: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
   qwen: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
+  ovhcloud: { telemetryType: 'header', supportsEndpoint: false, usageDisplay: 'percent', resetCadence: 'unknown' },
 
   // Providers that have a dedicated usage/credits endpoint
   openrouter: { telemetryType: 'endpoint', supportsEndpoint: true, usageDisplay: 'percent', resetCadence: 'unknown' },
-  siliconflow: { telemetryType: 'endpoint', supportsEndpoint: true, usageDisplay: 'ok',      resetCadence: 'unknown' },
 
   // Providers with no reliable quota signal
-  huggingface: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'none' },
-  replicate: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'none' },
   cloudflare: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'daily' },
   zai: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'none' },
-  iflow: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'none' },
+  gemini: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'daily' },
+  'opencode-zen': { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'unknown' },
 }
 
 /** Fallback for unrecognized providers */