free-coding-models 0.3.55 → 0.3.56

package/src/overlays.js

@@ -4,7 +4,7 @@
  *
  * @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, Feedback, Changelog, Router Dashboard
  *   - Settings diagnostics for provider key tests, including wrapped retry/error details
  *   - Recommend analysis timer orchestration and progress updates
  *
@@ -15,6 +15,7 @@
  *
  *   → 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 +23,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) {
@@ -882,7 +884,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 (①②③ = 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,15 +925,17 @@ 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('(①②③ = router fallback order)')}`)
+    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('Shift+R')}  Router Dashboard  ${hint('(🔀 daemon health, circuit breakers, tokens, request log)')}`)
     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('Ctrl+C')}  Exit`)
@@ -1394,6 +1398,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 +1498,195 @@ 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  •  Shift+R Router Dashboard'))
+
+    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('  Shift+R to reopen the dashboard anytime'))
+    } 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'))
+    }
+
+    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')
+  }
+
+  // ─── Router upgrade banner (inline in main table, not an overlay) ─────────────
+  // 📖 renderRouterUpgradeBanner: non-blocking notification at top of the table
+  // 📖 shown once to existing users who haven't seen router yet. Auto-dismisses after 10s.
+  function renderRouterUpgradeBanner() {
+    const EL = '\x1b[K'
+    const now = Date.now()
+    const BANNER_TTL_MS = 10_000
+    // Dismissed or already seen in this session?
+    if (state.routerUpgradeBannerDismissedAt > 0) return ''
+    if (state.routerUpgradeBannerShownAt === 0) state.routerUpgradeBannerShownAt = now
+    if (now - state.routerUpgradeBannerShownAt > BANNER_TTL_MS) {
+      state.routerUpgradeBannerDismissedAt = now
+      return ''
+    }
+    const remaining = Math.ceil((BANNER_TTL_MS - (now - state.routerUpgradeBannerShownAt)) / 1000)
+    const msg = `  ${themeColors.accentBold('🆕')}  ${themeColors.textBold('Smart Router is now available!')}  ${themeColors.dim('Press')}  ${themeColors.hotkey('Shift+R')}  ${themeColors.dim('to set it up.')}  ${themeColors.dim(`(dismisses in ${remaining}s)`)}`
+    const pad = state.terminalCols > displayWidth(msg) ? ' '.repeat(Math.max(0, state.terminalCols - displayWidth(msg))) : ''
+    return themeColors.warningBold(msg + pad)
+  }
+
   return {
     renderSettings,
     renderInstallEndpoints,
@@ -1500,9 +1697,13 @@ export function createOverlayRenderers(state, deps) {
     renderFeedback,
     renderChangelog,
     renderInstalledModels,
+    renderRouterDashboard,
     renderIncompatibleFallback,
+    renderTokenUsage,
+    renderRouterOnboarding,
+    renderRouterUpgradeBanner,
     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 La Plateforme',
+    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 */

package/src/render-table.js

@@ -54,6 +54,7 @@ import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displ
 import { getToolMeta, TOOL_METADATA, TOOL_MODE_ORDER, isModelCompatibleWithTool } from './tool-metadata.js'
 import { getColumnSpacing } from './ui-config.js'
 import { detectPackageManager, getManualInstallCmd } from './updater.js'
+import { formatTokenTotalCompact } from './token-usage-reader.js'
 
 const require = createRequire(import.meta.url)
 const { version: LOCAL_VERSION } = require('../package.json')
@@ -109,7 +110,7 @@ export const PROVIDER_COLOR = new Proxy({}, {
 })
 
 // ─── 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, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null, footerHidden = false, verdictFilterMode = 0, healthFilterMode = 0) {
+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, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null, footerHidden = false, verdictFilterMode = 0, healthFilterMode = 0, routerFooterRunning = false, routerFooterActiveSet = null, routerFooterTodayTokens = 0, routerFooterAllTimeTokens = 0, routerFooterRequests = 0) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -537,9 +538,15 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       ? providerName.slice(0, 4) + '…'
       : providerName
     const source = themeColors.provider(r.providerKey, providerDisplay.padEnd(wSource))
-    // 📖 Favorites: always reserve 2 display columns at the start of Model column.
-    // 📖 🎯 (2 cols) for recommended, ⭐ (2 cols) for favorites, '  ' (2 spaces) for non-favorites — keeps alignment stable.
-    const favoritePrefix = r.isRecommended ? '🎯' : r.isFavorite ? '⭐' : '  '
+    const CIRCLED = ['①','②','③','④','⑤','⑥','⑦','⑧','⑨','⑩','⑪','⑫','⑬','⑭','⑮','⑯','⑰','⑱','⑲','⑳']
+    let favoritePrefix = '  '
+    if (r.isRecommended) {
+      favoritePrefix = '🎯'
+    } else if (r.isFavorite && r.favoriteRank < CIRCLED.length) {
+      favoritePrefix = CIRCLED[r.favoriteRank]
+    } else if (r.isFavorite) {
+      favoritePrefix = '⭐'
+    }
     const prefixDisplayWidth = 2
     const nameWidth = Math.max(0, W_MODEL - prefixDisplayWidth)
     const name = favoritePrefix + r.label.slice(0, nameWidth).padEnd(nameWidth)
@@ -865,6 +872,8 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
         { text: '  •  ', key: null },
         { text: 'Q Smart Recommend', key: 'q' },
         { text: '  •  ', key: null },
+        { text: 'Shift+R Router', key: 'shift+r' },
+        { text: '  •  ', key: null },
         { text: 'G Theme', key: 'g' },
         { text: '  •  ', key: null },
         { text: 'I Feedback, bugs & requests', key: 'i' },
@@ -884,6 +893,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     lines.push(
       '  ' + paletteLabel + themeColors.dim(`  •  `) +
       hotkey('Q', ' Smart Recommend') + themeColors.dim(`  •  `) +
+      hotkey('Shift+R', ' Router') + themeColors.dim(`  •  `) +
       hotkey('G', ' Theme') + themeColors.dim(`  •  `) +
       hotkey('I', ' Feedback, bugs & requests')
     )
@@ -968,6 +978,27 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       (releaseLabel ? themeColors.dim('  •  ') + releaseLabel : '')
     )
 
+    // 📖 Router token stats + daemon status in the footer (shown when router is enabled)
+    if (routerFooterRunning) {
+      const todayStr = formatTokenTotalCompact(routerFooterTodayTokens)
+      const allTimeStr = formatTokenTotalCompact(routerFooterAllTimeTokens)
+      const reqStr = String(routerFooterRequests)
+      const setLabel = routerFooterActiveSet ? themeColors.info(routerFooterActiveSet) : themeColors.dim('?')
+      lines.push(
+        '  ' + themeColors.success('●') + ' ' +
+        themeColors.dim('Router:') + ' ' + setLabel +
+        themeColors.dim('  •  Today:') + ' ' + themeColors.textBold(todayStr + ' tok') +
+        themeColors.dim('  •  All-time:') + ' ' + themeColors.textBold(allTimeStr + ' tok') +
+        themeColors.dim('  •  ' + reqStr + ' req')
+      )
+    } else {
+      lines.push(
+        '  ' + themeColors.error('○') + ' ' +
+        themeColors.dim('Router:') + ' ' + themeColors.dim('daemon not running') +
+        themeColors.dim('  •  Shift+R Dashboard')
+      )
+    }
+
     // 📖 Discord link at the very bottom of the TUI
     lines.push(
       '  💬 ' +
@@ -979,6 +1010,8 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     // 📖 Collapsed footer: single line with toggle hint
     lines.push(
       '  ' + themeColors.hotkey('Ctrl+O') + themeColors.dim(' Toggle Footer') +
+      themeColors.dim('  •  ') +
+      themeColors.hotkey('Shift+R') + themeColors.dim(' Router') +
       themeColors.dim('  •  Ctrl+C Exit')
     )
   }