free-coding-models 0.3.55 → 0.3.57

package/src/key-handler.js

@@ -8,7 +8,7 @@
  *   tool launch actions. It also keeps the live key bindings aligned with the
  *   highlighted letters shown in the table headers.
  *
- *   📖 Key I opens the unified "Feedback, bugs & requests" overlay.
+ *   📖 Key I opens the changelog overlay.
  *
  *   It also owns the "test key" model selection used by the Settings overlay.
  *   Anonymous telemetry hooks for model launches and a few high-signal settings
@@ -33,7 +33,10 @@
 
 import { loadChangelog } from './changelog-loader.js'
 import { getToolMeta, isModelCompatibleWithTool, getCompatibleTools, findSimilarCompatibleModels } from './tool-metadata.js'
-import { loadConfig, replaceConfigContents } from './config.js'
+import { loadConfig, saveConfig, replaceConfigContents } from './config.js'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawn } from 'node:child_process'
 import { cleanupLegacyProxyArtifacts } from './legacy-proxy-cleanup.js'
 import { getLastLayout, COLUMN_SORT_MAP } from './render-table.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
@@ -42,12 +45,23 @@ import { buildCommandPaletteTree, flattenCommandTree, filterCommandPaletteEntrie
 import { WIDTH_WARNING_MIN_COLS, VERDICT_CYCLE, HEALTH_CYCLE } from './constants.js'
 import { scanAllToolConfigs, softDeleteModel } from './installed-models-manager.js'
 import { startExternalTool } from './tool-launchers.js'
+import {
+  clearRouterDashboardRequestLog,
+  closeRouterDashboardOverlay,
+  cycleRouterDashboardActiveSet,
+  cycleRouterDashboardProbeMode,
+  openRouterDashboardOverlay,
+  restartRouterDashboardDaemon,
+  toggleRouterDashboardProbePause,
+} from './router-dashboard.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.
 const PROVIDER_TEST_MODEL_OVERRIDES = {
-  sambanova: ['DeepSeek-V3-0324'],
-  nvidia: ['deepseek-ai/deepseek-v3.1-terminus', 'openai/gpt-oss-120b'],
+  sambanova: ['MiniMax-M2.5', 'DeepSeek-V3.1', 'DeepSeek-V3.2'],
+  nvidia: ['deepseek-ai/deepseek-v4-flash', 'openai/gpt-oss-120b'],
+  'github-models': ['openai/gpt-4.1-mini'],
+  mistral: ['mistral-small-latest', 'devstral-small-latest'],
 }
 
 // 📖 Settings key tests retry retryable failures across several models so a
@@ -67,6 +81,7 @@ const PROVIDER_AUTH_ENDPOINTS = {
   cerebras:     { url: 'https://api.cerebras.ai/v1/models',          method: 'GET' },
   sambanova:    { url: 'https://api.sambanova.ai/v1/models',         method: 'GET' },
   openrouter:   { url: 'https://openrouter.ai/api/v1/models',        method: 'GET' },
+  mistral:      { url: 'https://api.mistral.ai/v1/models',           method: 'GET' },
   huggingface:  { url: 'https://router.huggingface.co/v1/models',    method: 'GET' },
   deepinfra:    { url: 'https://api.deepinfra.com/v1/models',        method: 'GET' },
   fireworks:   { url: 'https://api.fireworks.ai/v1/models',         method: 'GET' },
@@ -79,6 +94,7 @@ const PROVIDER_AUTH_ENDPOINTS = {
   ovhcloud:     { url: 'https://oai.endpoints.kepler.ai.cloud.ovh.net/v1/models', method: 'GET' },
   qwen:         { url: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/models', method: 'GET' },
   iflow:        { url: 'https://apis.iflow.cn/v1/models',            method: 'GET' },
+  'github-models': null, // 📖 GitHub Models catalog is public; use chat ping to validate the token.
   replicate:    null, // 📖 Replicate has no /models endpoint; use chat completions ping
   cloudflare:   null, // 📖 Workers AI has no auth-check endpoint; use ping only
   zai:          null, // 📖 ZAI undocumented; use ping only
@@ -275,7 +291,6 @@ export function createKeyHandler(ctx) {
     sendUsageTelemetry,
     startRecommendAnalysis,
     stopRecommendAnalysis,
-    sendBugReport,
     stopUi,
     ping,
     getPingModel,
@@ -363,6 +378,40 @@ export function createKeyHandler(ctx) {
     })
   }
 
+  async function syncFavoritesToRouter(selected) {
+    if (state.config?.router?.enabled !== true) return
+    const favorites = state.config.favorites || []
+    const selKey = toFavoriteKey(selected.providerKey, selected.modelId)
+    const chain = [selKey, ...favorites.filter((f) => f !== selKey)]
+    const models = chain.map((f, i) => {
+      const slashIdx = f.indexOf('/')
+      const provider = slashIdx >= 0 ? f.slice(0, slashIdx) : '?'
+      const model = slashIdx >= 0 ? f.slice(slashIdx + 1) : f
+      return { provider, model, priority: i + 1 }
+    })
+    try {
+      const port = await readDaemonPort()
+      if (!port) return
+      const baseUrl = `http://127.0.0.1:${port}`
+      const setPayload = { name: 'fast-coding', models, created: new Date().toISOString() }
+      await globalThis.fetch(`${baseUrl}/sets/fast-coding`, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(setPayload),
+      })
+      await globalThis.fetch(`${baseUrl}/sets/fast-coding/activate`, { method: 'POST' })
+    } catch {}
+  }
+
+  async function readDaemonPort() {
+    try {
+      const { readFileSync } = await import('node:fs')
+      const raw = readFileSync(`${process.env.HOME}/.free-coding-models-daemon.port`, 'utf8').trim()
+      if (/^\d+$/.test(raw)) return Number(raw)
+    } catch {}
+    return null
+  }
+
   async function launchSelectedModel(selected, options = {}) {
     const { uiAlreadyStopped = false } = options
     userSelected = { modelId: selected.modelId, label: selected.label, tier: selected.tier, providerKey: selected.providerKey }
@@ -373,7 +422,9 @@ export function createKeyHandler(ctx) {
       stopUi()
     }
 
-    // 📖 Show selection status before handing control to the target tool.
+    // 📖 If router is enabled, push [selected, ...favorites] to daemon as the active set
+    await syncFavoritesToRouter(selected)
+
     if (selected.status === 'timeout') {
       console.log(chalk.yellow(`  ⚠ Selected: ${selected.label} (currently timing out)`))
     } else if (selected.status === 'down') {
@@ -898,12 +949,7 @@ export function createKeyHandler(ctx) {
     state.installEndpointsResult = null
   }
 
-  function openFeedbackOverlay() {
-    state.feedbackOpen = true
-    state.bugReportBuffer = ''
-    state.bugReportStatus = 'idle'
-    state.bugReportError = null
-  }
+
 
   function openChangelogOverlay() {
     state.changelogOpen = true
@@ -928,6 +974,51 @@ export function createKeyHandler(ctx) {
     }
   }
 
+
+  // 📖 Token Usage screen — Shift+T from main table. Fetches daily token history
+  // 📖 from the daemon and renders a 7-day chart plus today/all-time breakdowns.
+  async function openTokenUsageOverlay() {
+    state.tokenUsageOpen = true
+    state.tokenUsageScrollOffset = 0
+    state.tokenUsageError = null
+    state.tokenUsageData = null
+    // 📖 Discover daemon port
+    let port = 19280
+    try {
+      const { readFileSync: rfs } = await import('node:fs')
+      const portPath = `${process.env.HOME}/.free-coding-models-daemon.port`
+      const savedPort = rfs(portPath, 'utf8').trim()
+      if (/^\d+$/.test(savedPort)) port = Number(savedPort)
+    } catch {}
+    state.tokenUsageLastFetchAt = Date.now()
+    try {
+      const controller = new AbortController()
+      const timer = setTimeout(() => controller.abort(), 2000)
+      const res = await globalThis.fetch(`http://127.0.0.1:${port}/stats/tokens`, { signal: controller.signal })
+      clearTimeout(timer)
+      if (!res.ok) {
+        state.tokenUsageError = `Daemon returned HTTP ${res.status} — is the router running?`
+        return
+      }
+      // 📖 Guard: res.json() can throw on malformed response body
+      const text = await res.text()
+      try {
+        state.tokenUsageData = JSON.parse(text)
+      } catch {
+        state.tokenUsageError = 'Daemon returned invalid JSON — try restarting the daemon'
+      }
+    } catch (err) {
+      state.tokenUsageError = err?.name === 'AbortError' ? 'Request timed out — is the router daemon running?' : (err?.message || 'Failed to fetch token stats')
+    }
+  }
+
+  function closeTokenUsageOverlay() {
+    state.tokenUsageOpen = false
+    state.tokenUsageScrollOffset = 0
+    state.tokenUsageError = null
+  }
+
+
   function cycleToolMode() {
     const modeOrder = getToolModeOrder()
     const currentIndex = modeOrder.indexOf(state.mode)
@@ -1016,8 +1107,9 @@ export function createKeyHandler(ctx) {
       || state.installEndpointsOpen
       || state.toolInstallPromptOpen
       || state.installedModelsOpen
+      || state.routerDashboardOpen
       || state.recommendOpen
-      || state.feedbackOpen
+
       || state.helpVisible
       || state.changelogOpen
   }
@@ -1205,8 +1297,10 @@ export function createKeyHandler(ctx) {
         state.helpScrollOffset = 0
         return
       case 'open-changelog': return openChangelogOverlay()
-      case 'open-feedback': return openFeedbackOverlay()
+
       case 'open-recommend': return openRecommendOverlay()
+      case 'open-router-dashboard': return openRouterDashboardOverlay(state)
+      case 'open-token-usage': return openTokenUsageOverlay()
       case 'open-install-endpoints': return openInstallEndpointsOverlay()
       case 'open-installed-models': return openInstalledModelsOverlay()
       case 'action-cycle-theme': return cycleGlobalTheme()
@@ -1333,13 +1427,66 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    if (!state.feedbackOpen && !state.settingsEditMode && !state.settingsAddKeyMode && key.name === 'g' && !key.ctrl && !key.meta) {
+    if (!state.settingsEditMode && !state.settingsAddKeyMode && key.name === 'g' && !key.ctrl && !key.meta) {
       cycleGlobalTheme()
       return
     }
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
+    // 📖 Router Dashboard captures local dashboard controls while open so keys
+    // 📖 like S/I/R/C do not leak through to sort/filter actions in the table.
+    if (state.routerDashboardOpen) {
+      if (key.ctrl && key.name === 'c') { exit(0); return }
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
+
+      if (key.name === 'escape') {
+        closeRouterDashboardOverlay(state)
+        return
+      }
+      if (key.name === 'up' || key.name === 'k') {
+        state.routerDashboardScrollOffset = Math.max(0, (state.routerDashboardScrollOffset || 0) - 1)
+        return
+      }
+      if (key.name === 'down' || key.name === 'j') {
+        state.routerDashboardScrollOffset = (state.routerDashboardScrollOffset || 0) + 1
+        return
+      }
+      if (key.name === 'pageup') {
+        state.routerDashboardScrollOffset = Math.max(0, (state.routerDashboardScrollOffset || 0) - pageStep)
+        return
+      }
+      if (key.name === 'pagedown') {
+        state.routerDashboardScrollOffset = (state.routerDashboardScrollOffset || 0) + pageStep
+        return
+      }
+      if (key.name === 'home') {
+        state.routerDashboardScrollOffset = 0
+        return
+      }
+      if (key.name === 's') {
+        try { await cycleRouterDashboardActiveSet(state) } catch {}
+        return
+      }
+      if (key.name === 'i') {
+        try { await cycleRouterDashboardProbeMode(state) } catch {}
+        return
+      }
+      if (key.name === 'r') {
+        restartRouterDashboardDaemon(state)
+        return
+      }
+      if (key.name === 'c') {
+        clearRouterDashboardRequestLog(state)
+        return
+      }
+      if (key.name === 'p') {
+        toggleRouterDashboardProbePause(state)
+        return
+      }
+      return
+    }
+
     // 📖 Install Endpoints overlay: provider → tool → connection → scope → optional model subset.
     if (state.installEndpointsOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
@@ -1736,87 +1883,132 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Feedback overlay: intercept ALL keys while overlay is active.
-    // 📖 Enter → send to Discord, Esc → cancel, Backspace → delete char, printable → append to buffer.
-    if (state.feedbackOpen) {
+
+
+    // 📖 Help overlay: full keyboard navigation + key swallowing while overlay is open.
+    if (state.helpVisible) {
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
+      if (key.name === 'escape' || (key.ctrl && key.name === 'h')) {
+        state.helpVisible = false
+        return
+      }
+      if (key.name === 'up' || key.name === 'k') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - 1); return }
+      if (key.name === 'down' || key.name === 'j') { state.helpScrollOffset += 1; return }
+      if (key.name === 'pageup') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - pageStep); return }
+      if (key.name === 'pagedown') { state.helpScrollOffset += pageStep; return }
+      if (key.name === 'home') { state.helpScrollOffset = 0; return }
+      if (key.name === 'end') { state.helpScrollOffset = Number.MAX_SAFE_INTEGER; return }
       if (key.ctrl && key.name === 'c') { exit(0); return }
+      return
+    }
 
+    // 📖 Token Usage overlay: Shift+T shows token history chart and today/all-time breakdowns.
+    if (state.tokenUsageOpen) {
+      if (key.ctrl && key.name === 'c') { exit(0); return }
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
       if (key.name === 'escape') {
-        // 📖 Cancel feedback — close overlay
-        state.feedbackOpen = false
-        state.bugReportBuffer = ''
-        state.bugReportStatus = 'idle'
-        state.bugReportError = null
+        closeTokenUsageOverlay()
+        return
+      }
+      if (key.name === 'up' || key.name === 'k') {
+        state.tokenUsageScrollOffset = Math.max(0, state.tokenUsageScrollOffset - 1)
+        return
+      }
+      if (key.name === 'down' || key.name === 'j') {
+        state.tokenUsageScrollOffset += 1
+        return
+      }
+      if (key.name === 'pageup') {
+        state.tokenUsageScrollOffset = Math.max(0, state.tokenUsageScrollOffset - pageStep)
+        return
+      }
+      if (key.name === 'pagedown') {
+        state.tokenUsageScrollOffset += pageStep
         return
       }
+      if (key.name === 'home') {
+        state.tokenUsageScrollOffset = 0
+        return
+      }
+      if (key.name === 'end') {
+        state.tokenUsageScrollOffset = Number.MAX_SAFE_INTEGER
+        return
+      }
+      return
+    }
 
-      if (key.name === 'return') {
-        // 📖 Send feedback to Discord webhook
-        const message = state.bugReportBuffer.trim()
-        if (message.length > 0 && state.bugReportStatus !== 'sending') {
-          state.bugReportStatus = 'sending'
-          const result = await sendBugReport(message)
-          if (result.success) {
-            // 📖 Success — show confirmation briefly, then close overlay after 3 seconds
-            state.bugReportStatus = 'success'
-            setTimeout(() => {
-              state.feedbackOpen = false
-              state.bugReportBuffer = ''
-              state.bugReportStatus = 'idle'
-              state.bugReportError = null
-            }, 3000)
-          } else {
-            // 📖 Error — show error message, keep overlay open
-            state.bugReportStatus = 'error'
-            state.bugReportError = result.error || 'Unknown error'
+    // 📖 Router Onboarding overlay: shown on first launch. Y=yes enable, N=not now, Esc=cancel.
+    if (state.routerOnboardingOpen) {
+      if (key.ctrl && key.name === 'c') { exit(0); return }
+      if (state.routerOnboardingPhase === 'loading' || state.routerOnboardingPhase === 'success' || state.routerOnboardingPhase === 'error') {
+        if (key.name === 'escape' || key.name === 'return') {
+          state.routerOnboardingOpen = false
+          // 📖 Mark onboarding as seen (don't show again)
+          if (state.config?.router) {
+            state.config.router.onboardingSeen = true
           }
+          return
         }
         return
       }
-
-      if (key.name === 'backspace') {
-        // 📖 Don't allow editing while sending or after success
-        if (state.bugReportStatus === 'sending' || state.bugReportStatus === 'success') return
-        state.bugReportBuffer = state.bugReportBuffer.slice(0, -1)
-        // 📖 Clear error status when user starts editing again
-        if (state.bugReportStatus === 'error') {
-          state.bugReportStatus = 'idle'
-          state.bugReportError = null
+      if (key.name === 'escape' || key.name === 'n') {
+        state.routerOnboardingOpen = false
+        // 📖 Mark as seen and disabled
+        if (state.config?.router) {
+          state.config.router.onboardingSeen = true
+          state.config.router.enabled = false
         }
         return
       }
-
-      // 📖 Append printable characters (str is the raw character typed)
-      // 📖 Limit to 500 characters (Discord embed description limit)
-      if (str && str.length === 1 && !key.ctrl && !key.meta) {
-        // 📖 Don't allow editing while sending or after success
-        if (state.bugReportStatus === 'sending' || state.bugReportStatus === 'success') return
-        if (state.bugReportBuffer.length < 500) {
-          state.bugReportBuffer += str
-          // 📖 Clear error status when user starts editing again
-          if (state.bugReportStatus === 'error') {
-            state.bugReportStatus = 'idle'
-            state.bugReportError = null
+      if (key.name === 'up' || key.name === 'k') {
+        state.routerOnboardingCursor = 0
+        return
+      }
+      if (key.name === 'down' || key.name === 'j') {
+        state.routerOnboardingCursor = 1
+        return
+      }
+      if (key.name === 'return' || key.name === 'y') {
+        const shouldEnable = key.name === 'return' ? true : (state.routerOnboardingCursor === 0)
+        if (!shouldEnable) {
+          state.routerOnboardingOpen = false
+          if (state.config?.router) {
+            state.config.router.onboardingSeen = true
+            state.config.router.enabled = false
           }
+          return
         }
-      }
-      return
-    }
-
-    // 📖 Help overlay: full keyboard navigation + key swallowing while overlay is open.
-    if (state.helpVisible) {
-      const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
-      if (key.name === 'escape' || (key.ctrl && key.name === 'h')) {
-        state.helpVisible = false
+        // 📖 Enable router: start daemon in background and mark onboarding seen
+        state.routerOnboardingPhase = 'loading'
+        state.routerOnboardingError = null
+        void (async () => {
+          try {
+            const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+            const child = spawn('node', [binPath, '--daemon-bg'], {
+              detached: true,
+              stdio: 'ignore',
+            })
+            child.unref()
+            await new Promise((r) => setTimeout(r, 2000))
+            if (state.routerOnboardingPhase === 'loading') {
+              state.routerOnboardingPhase = 'success'
+              if (state.config?.router) {
+                state.config.router.enabled = true
+                state.config.router.onboardingSeen = true
+                saveConfig(state.config)
+              }
+              trackTelemetryEvent('app_router_install', { router_version: '0.4.0' })
+              await new Promise((r) => setTimeout(r, 1500))
+              state.routerOnboardingOpen = false
+              openRouterDashboardOverlay(state)
+            }
+          } catch (err) {
+            state.routerOnboardingPhase = 'error'
+            state.routerOnboardingError = err?.message || 'Failed to start router'
+          }
+        })()
         return
       }
-      if (key.name === 'up' || key.name === 'k') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - 1); return }
-      if (key.name === 'down' || key.name === 'j') { state.helpScrollOffset += 1; return }
-      if (key.name === 'pageup') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - pageStep); return }
-      if (key.name === 'pagedown') { state.helpScrollOffset += pageStep; return }
-      if (key.name === 'home') { state.helpScrollOffset = 0; return }
-      if (key.name === 'end') { state.helpScrollOffset = Number.MAX_SAFE_INTEGER; return }
-      if (key.ctrl && key.name === 'c') { exit(0); return }
       return
     }
 
@@ -2366,9 +2558,16 @@ export function createKeyHandler(ctx) {
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
-    // 📖 Shift+R: reset all UI view settings to defaults (tier, sort, provider) and clear persisted config
-    if (key.name === 'r' && key.shift) {
-      resetViewSettings()
+    // 📖 Shift+R intentionally stays unadvertised in the main UI, but remains
+    // 📖 available as a tester entry point for the Router Dashboard.
+    if (key.name === 'r' && key.shift && !key.ctrl && !key.meta) {
+      openRouterDashboardOverlay(state)
+      return
+    }
+
+    // 📖 Shift+T: open the Token Usage screen.
+    if (key.name === 't' && key.shift && !key.ctrl && !key.meta) {
+      openTokenUsageOverlay()
       return
     }
 
@@ -2383,7 +2582,7 @@ export function createKeyHandler(ctx) {
     // 📖 T is reserved for tier filter cycling. Y toggles favorites display mode.
     // 📖 X clears the active custom text filter.
     // 📖 D is now reserved for provider filter cycling
-    // 📖 Shift+R is reserved for reset view settings
+    // 📖 Shift+R is reserved for the Router Dashboard; reset view remains in Ctrl+P.
     const sortKeys = {
       'r': 'rank', 'o': 'origin', 'm': 'model',
       'l': 'ping', 'a': 'avg', 's': 'swe', 'c': 'ctx', 'h': 'condition', 'v': 'verdict', 'b': 'stability', 'u': 'uptime'
@@ -2401,11 +2600,7 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 I key: open Feedback overlay (anonymous Discord feedback)
-    if (key.name === 'i') {
-      openFeedbackOverlay()
-      return
-    }
+
 
     // 📖 W cycles the supported ping modes:
     // 📖 speed (2s) → normal (10s) → slow (30s) → forced (4s) → speed.
@@ -2417,16 +2612,6 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Ctrl+O: toggle footer visibility (collapse to single hint when hidden)
-    if (key.ctrl && key.name === 'o' && !key.meta) {
-      state.footerHidden = !state.footerHidden
-      if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
-      state.config.settings.footerHidden = state.footerHidden
-      saveConfig(state.config)
-      state.frame++ // 📖 Force immediate re-render
-      return
-    }
-
     // 📖 E toggles hiding models whose provider has no configured API key.
     // 📖 The preference is saved globally.
     if (key.name === 'e') {
@@ -2477,8 +2662,8 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Help overlay key: Ctrl+H = toggle help overlay
-    if (key.ctrl && key.name === 'h') {
+    // 📖 Help overlay key: I = toggle help overlay
+    if (key.name === 'i') {
       state.helpVisible = !state.helpVisible
       if (state.helpVisible) state.helpScrollOffset = 0
       return
@@ -2502,6 +2687,28 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    if (key.shift && key.name === 'up') {
+      const selected = state.visibleSorted?.[state.cursor]
+      if (selected?.isFavorite) {
+        reorderFavorite(state.config, selected.providerKey, selected.modelId, 'up')
+        syncFavoriteFlags(state.results, state.config)
+        applyTierFilter()
+        refreshVisibleSorted({ resetCursor: false })
+      }
+      return
+    }
+
+    if (key.shift && key.name === 'down') {
+      const selected = state.visibleSorted?.[state.cursor]
+      if (selected?.isFavorite) {
+        reorderFavorite(state.config, selected.providerKey, selected.modelId, 'down')
+        syncFavoriteFlags(state.results, state.config)
+        applyTierFilter()
+        refreshVisibleSorted({ resetCursor: false })
+      }
+      return
+    }
+
     if (key.name === 'up' || key.name === 'k') {
       // 📖 Main list wrap navigation: top -> bottom on Up / K (vim-style).
       const count = state.visibleSorted.length
@@ -2527,12 +2734,9 @@ export function createKeyHandler(ctx) {
     }
 
     if (key.name === 'return') { // Enter
-      // 📖 Use the cached visible+sorted array — guaranteed to match what's on screen
       const selected = state.visibleSorted[state.cursor]
-      if (!selected) return // 📖 Guard: empty visible list (all filtered out)
+      if (!selected) return
 
-      // 📖 Incompatibility intercept — if the model can't run on the active tool,
-      // 📖 show the fallback overlay instead of launching. Lets user switch tool or pick similar model.
       if (!isModelCompatibleWithTool(selected.providerKey, state.mode)) {
         const compatTools = getCompatibleTools(selected.providerKey)
         const similarModels = findSimilarCompatibleModels(
@@ -2714,10 +2918,7 @@ export function createMouseEventHandler(ctx) {
         }
         return
       }
-      if (state.feedbackOpen) {
-        // 📖 Feedback overlay doesn't scroll — ignore
-        return
-      }
+
       if (state.commandPaletteOpen) {
         // 📖 Command palette: scroll the results list
         const count = state.commandPaletteResults?.length || 0
@@ -2763,6 +2964,11 @@ export function createMouseEventHandler(ctx) {
         }
         return
       }
+      if (state.routerDashboardOpen) {
+        const step = evt.type === 'scroll-up' ? -3 : 3
+        state.routerDashboardScrollOffset = Math.max(0, (state.routerDashboardScrollOffset || 0) + step)
+        return
+      }
 
       // 📖 Main table scroll: move cursor up/down with wrap-around
       const count = state.visibleSorted.length
@@ -2843,18 +3049,18 @@ export function createMouseEventHandler(ctx) {
       return
     }
 
+    if (state.routerDashboardOpen) {
+      closeRouterDashboardOverlay(state)
+      return
+    }
+
     if (state.incompatibleFallbackOpen) {
       // 📖 Incompatible fallback: click closes
       state.incompatibleFallbackOpen = false
       return
     }
 
-    if (state.feedbackOpen) {
-      // 📖 Feedback overlay: click anywhere closes (no scroll, no cursor)
-      state.feedbackOpen = false
-      state.feedbackInput = ''
-      return
-    }
+
 
     if (state.helpVisible) {
       // 📖 Help overlay: click anywhere closes (same as K or Escape)
@@ -3004,6 +3210,8 @@ export function createMouseEventHandler(ctx) {
         // 📖 Most are single-character keys; special cases like ctrl+p need special handling.
         if (zone.key === 'ctrl+p') {
           process.stdin.emit('keypress', '\x10', { name: 'p', ctrl: true, meta: false, shift: false })
+        } else if (zone.key === 'shift+r') {
+          process.stdin.emit('keypress', 'R', { name: 'r', ctrl: false, meta: false, shift: true })
         } else {
           process.stdin.emit('keypress', zone.key, { name: zone.key, ctrl: false, meta: false, shift: false })
         }