free-coding-models 0.1.84 → 0.1.86

package/README.md

@@ -2,7 +2,7 @@
   <img src="https://img.shields.io/npm/v/free-coding-models?color=76b900&label=npm&logo=npm" alt="npm version">
   <img src="https://img.shields.io/node/v/free-coding-models?color=76b900&logo=node.js" alt="node version">
   <img src="https://img.shields.io/npm/l/free-coding-models?color=76b900" alt="license">
-  <img src="https://img.shields.io/badge/models-158-76b900?logo=nvidia" alt="models count">
+  <img src="https://img.shields.io/badge/models-159-76b900?logo=nvidia" alt="models count">
   <img src="https://img.shields.io/badge/providers-20-blue" alt="providers count">
 </p>
 
@@ -72,7 +72,7 @@
 - **🚀 Parallel pings** — All models tested simultaneously via native `fetch`
 - **📊 Real-time animation** — Watch latency appear live in alternate screen buffer
 - **🏆 Smart ranking** — Top 3 fastest models highlighted with medals 🥇🥈🥉
-- **⏱ Continuous monitoring** — Pings all models every 3 seconds forever, never stops
+- **⏱ Adaptive monitoring** — Starts in a fast 2s cadence for 60s, settles to 10s, slows to 30s after 5 minutes idle, and supports a forced 4s mode
 - **📈 Rolling averages** — Avg calculated from ALL successful pings since start
 - **📊 Uptime tracking** — Percentage of successful pings shown in real-time
 - **📐 Stability score** — Composite 0–100 score measuring consistency (p95, jitter, spikes, uptime)
@@ -90,7 +90,9 @@
  - **📶 Status indicators** — UP ✅ · No Key 🔑 · Timeout ⏳ · Overloaded 🔥 · Not Found 🚫
  - **🔍 Keyless latency** — Models are pinged even without an API key
  - **🏷 Tier filtering** — Filter models by tier letter (S, A, B, C)
- - **⭐ Persistent favorites** — Press `F` on a selected row to pin/unpin it
+- **⭐ Persistent favorites** — Press `F` on a selected row to pin/unpin it
+- **🙈 Configured-only by default** — Press `E` to toggle showing only providers with configured API keys; the choice persists across sessions and profiles
+- **🪟 Width guardrail** — If your terminal is too narrow, the TUI shows a centered warning instead of rendering a broken table
 
 ---
 
@@ -200,7 +202,7 @@ Use `↑↓` arrows to select, `Enter` to confirm. Then the TUI launches with yo
 
 **How it works:**
  1. **Ping phase** — All enabled models are pinged in parallel (up to 150 across 20 providers)
- 2. **Continuous monitoring** — Models are re-pinged every 3 seconds forever
+ 2. **Continuous monitoring** — Models start at 2s re-pings for 60s, then fall back to 10s automatically
 3. **Real-time updates** — Watch "Latest", "Avg", and "Up%" columns update live
 4. **Select anytime** — Use ↑↓ arrows to navigate, press Enter on a model to act
 5. **Smart detection** — Automatically detects if NVIDIA NIM is configured in OpenCode or OpenClaw
@@ -235,7 +237,7 @@ Use `↑↓` arrows to select, `Enter` to confirm. Then the TUI launches with yo
   You can add or change keys anytime with the P key in the TUI.
 ```
 
-You don't need all seventeen — skip any provider by pressing Enter. At least one key is required.
+You don't need all twenty providers — skip any provider by pressing Enter. At least one key is required.
 
 ### Adding or changing keys later
 
@@ -269,6 +271,7 @@ Press **`P`** to open the Settings screen at any time:
 
  Manual update is in the same Settings screen (`P`) under **Maintenance** (Enter to check, Enter again to install when an update is available).
  Favorites are also persisted in the same config file and survive restarts.
+ The main table now starts in `Configured Only` mode, so if nothing is set up yet you can press `P` and add your first API key immediately.
 
 ### Environment variable overrides
 
@@ -376,7 +379,7 @@ TOGETHER_API_KEY=together_xxx free-coding-models
 
 ## 🤖 Coding Models
 
-**158 coding models** across 20 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
+**159 coding models** across 20 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
 
 ### Alibaba Cloud (DashScope) (8 models)
 
@@ -725,7 +728,7 @@ This script:
 │  1. Enter alternate screen buffer (like vim/htop/less)           │
 │  2. Ping ALL models in parallel                                  │
 │  3. Display real-time table with Latest/Avg/Stability/Up%        │
-│  4. Re-ping ALL models every 3 seconds (forever)               │
+│  4. Re-ping ALL models at 2s on startup, then 10s steady-state │
 │  5. Update rolling averages + stability scores per model        │
 │  6. User can navigate with ↑↓ and select with Enter            │
 │  7. On Enter (OpenCode): set model, launch OpenCode             │
@@ -733,7 +736,7 @@ This script:
 └──────────────────────────────────────────────────────────────────┘
 ```
 
-**Result:** Continuous monitoring interface that stays open until you select a model or press Ctrl+C. Rolling averages give you accurate long-term latency data, the stability score reveals which models are truly consistent vs. deceptively spikey, and you can configure your tool of choice with one keystroke.
+**Result:** Continuous monitoring interface that stays open until you select a model or press Ctrl+C. Rolling averages give you accurate long-term latency data, the stability score reveals which models are truly consistent vs. deceptively spikey, and you can configure your tool of choice with one keystroke. If the terminal is too narrow, the app shows a centered warning instead of a truncated table.
 
 ---
 
@@ -795,6 +798,9 @@ This script:
     "perplexity": { "enabled": true },
     "zai":      { "enabled": true }
    },
+   "settings": {
+     "hideUnconfiguredModels": true
+   },
    "favorites": [
      "nvidia/deepseek-ai/deepseek-v3.2"
    ]
@@ -803,7 +809,7 @@ This script:
 
 **Configuration:**
 - **Ping timeout**: 15 seconds per attempt (slow models get more time)
-- **Ping interval**: 3 seconds between complete re-pings of all models (adjustable with W/X keys)
+- **Ping cadence**: startup burst at 2 seconds for 60s, then 10 seconds normally, 30 seconds when idle for 5 minutes, or forced 4 seconds via `W`
 - **Monitor mode**: Interface stays open forever, press Ctrl+C to exit
 
 **Flags:**
@@ -830,13 +836,14 @@ This script:
 - **F** — Toggle favorite on selected model (⭐ in Model column, pinned at top)
 - **T** — Cycle tier filter (All → S+ → S → A+ → A → A- → B+ → B → C → All)
 - **D** — Cycle provider filter (All → NIM → Groq → ...)
+- **E** — Toggle configured-only mode (on by default, persisted across sessions and profiles)
 - **Z** — Cycle mode (OpenCode CLI → OpenCode Desktop → OpenClaw)
-- **X** — **Toggle Log Viewer** (view recent activity and error logs)
+- **X** — **Toggle Token Logs** (view recent request/token usage logs)
 - **P** — Open Settings (manage API keys, toggles, updates, profiles)
 - **Shift+P** — Cycle through saved profiles (switches live TUI settings)
 - **Shift+S** — Save current TUI settings as a named profile (inline prompt)
 - **Q** — Open Smart Recommend overlay (find the best model for your task)
-- **W / =** — Decrease / Increase ping interval
+- **W** — Cycle ping mode (`FAST` 2s → `NORMAL` 10s → `SLOW` 30s → `FORCED` 4s)
 - **J / I** — Request feature / Report bug
 - **K / Esc** — Show help overlay / Close overlay
 - **Ctrl+C** — Exit
@@ -862,7 +869,7 @@ Profiles let you save and restore different TUI configurations — useful if you
 - Favorites (starred models)
 - Sort column and direction
 - Tier filter
-- Ping interval
+- Ping mode
 - API keys
 
 **Saving a profile:**

package/bin/free-coding-models.js

@@ -177,9 +177,10 @@ async function main() {
   ensureFavoritesConfig(config)
 
   // 📖 If --profile <name> was passed, load that profile into the live config
+  let startupProfileSettings = null
   if (cliArgs.profileName) {
-    const profileSettings = loadProfile(config, cliArgs.profileName)
-    if (!profileSettings) {
+    startupProfileSettings = loadProfile(config, cliArgs.profileName)
+    if (!startupProfileSettings) {
       console.error(chalk.red(`  Unknown profile "${cliArgs.profileName}". Available: ${listProfiles(config).join(', ') || '(none)'}`))
       process.exit(1)
     }
@@ -288,6 +289,7 @@ async function main() {
       status: 'pending',
       pings: [],  // 📖 All ping results (ms or 'TIMEOUT')
       httpCode: null,
+      isPinging: false, // 📖 Per-row live flag so Latest Ping can keep last value and show a spinner during refresh.
       hidden: false,  // 📖 Simple flag to hide/show models
     }))
   syncFavoriteFlags(results, config)
@@ -305,23 +307,52 @@ async function main() {
   // 📖 Add interactive selection state - cursor index and user's choice
   // 📖 sortColumn: 'rank'|'tier'|'origin'|'model'|'ping'|'avg'|'status'|'verdict'|'uptime'
   // 📖 sortDirection: 'asc' (default) or 'desc'
-    // 📖 pingInterval: current interval in ms (default 2000, adjustable with W/= keys)
-    // 📖 tierFilter: current tier filter letter (null = all, 'S' = S+/S, 'A' = A+/A/A-, etc.)
+  // 📖 ping cadence is now mode-driven:
+  // 📖 speed  = 2s for 1 minute bursts
+  // 📖 normal = 10s steady state
+  // 📖 slow   = 30s after 5 minutes of inactivity
+  // 📖 forced = 4s and ignores inactivity / auto slowdowns
+  const PING_MODE_INTERVALS = {
+    speed: 2_000,
+    normal: 10_000,
+    slow: 30_000,
+    forced: 4_000,
+  }
+  const PING_MODE_CYCLE = ['speed', 'normal', 'slow', 'forced']
+  const SPEED_MODE_DURATION_MS = 60_000
+  const IDLE_SLOW_AFTER_MS = 5 * 60_000
+  const now = Date.now()
+
+  const intervalToPingMode = (intervalMs) => {
+    if (intervalMs <= 3000) return 'speed'
+    if (intervalMs <= 5000) return 'forced'
+    if (intervalMs >= 30000) return 'slow'
+    return 'normal'
+  }
+
+  // 📖 tierFilter: current tier filter letter (null = all, 'S' = S+/S, 'A' = A+/A/A-, etc.)
   const state = {
     results,
     pendingPings: 0,
     frame: 0,
     cursor: 0,
     selectedModel: null,
-    sortColumn: 'avg',
-    sortDirection: 'asc',
-    pingInterval: PING_INTERVAL,  // 📖 Track current interval for W/= keys
-    lastPingTime: Date.now(),     // 📖 Track when last ping cycle started
+    sortColumn: startupProfileSettings?.sortColumn || 'avg',
+    sortDirection: startupProfileSettings?.sortAsc === false ? 'desc' : 'asc',
+    pingInterval: PING_MODE_INTERVALS.speed, // 📖 Effective live interval derived from the active ping mode.
+    pingMode: 'speed',            // 📖 Current ping mode: speed | normal | slow | forced.
+    pingModeSource: 'startup',    // 📖 Why this mode is active: startup | manual | auto | idle | activity.
+    speedModeUntil: now + SPEED_MODE_DURATION_MS, // 📖 Speed bursts auto-fall back to normal after 60 seconds.
+    lastPingTime: now,            // 📖 Track when last ping cycle started
+    lastUserActivityAt: now,      // 📖 Any keypress refreshes this timer; inactivity can force slow mode.
+    resumeSpeedOnActivity: false, // 📖 Set after idle slowdown so the next activity restarts a 60s speed burst.
     mode,                         // 📖 'opencode' or 'openclaw' — controls Enter action
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
+    hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true || config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
     scrollOffset: 0,              // 📖 First visible model index in viewport
     terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
+    terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
     // 📖 Settings screen state (P key opens it)
     settingsOpen: false,          // 📖 Whether settings overlay is active
     settingsCursor: 0,            // 📖 Which provider row is selected in settings
@@ -380,9 +411,57 @@ async function main() {
   // 📖 Re-clamp viewport on terminal resize
   process.stdout.on('resize', () => {
     state.terminalRows = process.stdout.rows || 24
+    state.terminalCols = process.stdout.columns || 80
     adjustScrollOffset(state)
   })
 
+  let ticker = null
+  let onKeyPress = null
+  let pingModel = null
+
+  const scheduleNextPing = () => {
+    clearTimeout(state.pingIntervalObj)
+    const elapsed = Date.now() - state.lastPingTime
+    const delay = Math.max(0, state.pingInterval - elapsed)
+    state.pingIntervalObj = setTimeout(runPingCycle, delay)
+  }
+
+  const setPingMode = (nextMode, source = 'manual') => {
+    const modeInterval = PING_MODE_INTERVALS[nextMode] ?? PING_MODE_INTERVALS.normal
+    state.pingMode = nextMode
+    state.pingModeSource = source
+    state.pingInterval = modeInterval
+    state.speedModeUntil = nextMode === 'speed' ? Date.now() + SPEED_MODE_DURATION_MS : null
+    state.resumeSpeedOnActivity = source === 'idle'
+    if (state.pingIntervalObj) scheduleNextPing()
+  }
+
+  const noteUserActivity = () => {
+    state.lastUserActivityAt = Date.now()
+    if (state.pingMode === 'forced') return
+    if (state.resumeSpeedOnActivity) {
+      setPingMode('speed', 'activity')
+    }
+  }
+
+  const refreshAutoPingMode = () => {
+    const currentTime = Date.now()
+    if (state.pingMode === 'forced') return
+
+    if (state.speedModeUntil && currentTime >= state.speedModeUntil) {
+      setPingMode('normal', 'auto')
+      return
+    }
+
+    if (currentTime - state.lastUserActivityAt >= IDLE_SLOW_AFTER_MS) {
+      if (state.pingMode !== 'slow' || state.pingModeSource !== 'idle') {
+        setPingMode('slow', 'idle')
+      } else {
+        state.resumeSpeedOnActivity = true
+      }
+    }
+  }
+
   // 📖 Auto-start proxy on launch if OpenCode config already has an fcm-proxy provider.
   // 📖 Fire-and-forget: does not block UI startup. state.proxyStartupStatus is updated async.
   if (mode === 'opencode' || mode === 'opencode-desktop') {
@@ -404,13 +483,18 @@ async function main() {
 
   // 📖 originFilterMode: index into ORIGIN_CYCLE, 0=All, then each provider key in order
   const ORIGIN_CYCLE = [null, ...Object.keys(sources)]
-  state.tierFilterMode = 0
+  state.tierFilterMode = startupProfileSettings?.tierFilter ? Math.max(0, TIER_CYCLE.indexOf(startupProfileSettings.tierFilter)) : 0
   state.originFilterMode = 0
 
   function applyTierFilter() {
     const activeTier = TIER_CYCLE[state.tierFilterMode]
     const activeOrigin = ORIGIN_CYCLE[state.originFilterMode]
     state.results.forEach(r => {
+      const unconfiguredHide = state.hideUnconfiguredModels && !getApiKey(state.config, r.providerKey)
+      if (unconfiguredHide) {
+        r.hidden = true
+        return
+      }
       // 📖 Favorites stay visible regardless of tier/origin filters.
       if (r.isFavorite) {
         r.hidden = false
@@ -425,9 +509,6 @@ async function main() {
   }
 
   // ─── Overlay renderers + key handler ─────────────────────────────────────
-  let pingModel = null
-  let ticker = null
-  let onKeyPress = null
   const stopUi = ({ resetRawMode = false } = {}) => {
     if (ticker) clearInterval(ticker)
     clearTimeout(state.pingIntervalObj)
@@ -518,6 +599,10 @@ async function main() {
     mergedModels,
     apiKey,
     chalk,
+    setPingMode,
+    noteUserActivity,
+    intervalToPingMode,
+    PING_MODE_CYCLE,
     setResults: (next) => { results = next },
     readline,
   })
@@ -544,9 +629,11 @@ async function main() {
   }
 
   process.stdin.on('keypress', onKeyPress)
+  process.on('SIGCONT', noteUserActivity)
 
   // 📖 Animation loop: render settings overlay, recommend overlay, help overlay, feature request overlay, bug report overlay, OR main table
   ticker = setInterval(() => {
+    refreshAutoPingMode()
     state.frame++
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
     if (!state.settingsOpen && !state.recommendOpen && !state.featureRequestOpen && !state.bugReportOpen) {
@@ -561,11 +648,11 @@ async function main() {
           ? overlays.renderFeatureRequest()
           : state.bugReportOpen
             ? overlays.renderBugReport()
-            : state.helpVisible
-              ? overlays.renderHelp()
+              : state.helpVisible
+                ? overlays.renderHelp()
               : state.logVisible
                 ? overlays.renderLog()
-                : renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus)
+                : renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels)
     process.stdout.write(ALT_HOME + content)
   }, Math.round(1000 / FPS))
 
@@ -573,7 +660,7 @@ async function main() {
   const initialVisible = state.results.filter(r => !r.hidden)
   state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection)
 
-  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus))
+  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels))
 
   // 📖 If --recommend was passed, auto-open the Smart Recommend overlay on start
   if (cliArgs.recommendMode) {
@@ -593,82 +680,89 @@ async function main() {
   // 📖 Uses per-provider API key and URL from sources.js
   // 📖 If no API key is configured, pings without auth — a 401 still tells us latency + server is up
   pingModel = async (r) => {
-    const providerApiKey = getApiKey(state.config, r.providerKey) ?? null
-    const providerUrl = sources[r.providerKey]?.url ?? sources.nvidia.url
-    let { code, ms, quotaPercent } = await ping(providerApiKey, r.modelId, r.providerKey, providerUrl)
-
-    if ((quotaPercent === null || quotaPercent === undefined) && providerApiKey) {
-      const providerQuota = await getProviderQuotaPercentCached(r.providerKey, providerApiKey)
-      if (typeof providerQuota === 'number' && Number.isFinite(providerQuota)) {
-        quotaPercent = providerQuota
+    state.pendingPings += 1
+    r.isPinging = true
+
+    try {
+      const providerApiKey = getApiKey(state.config, r.providerKey) ?? null
+      const providerUrl = sources[r.providerKey]?.url ?? sources.nvidia.url
+      let { code, ms, quotaPercent } = await ping(providerApiKey, r.modelId, r.providerKey, providerUrl)
+
+      if ((quotaPercent === null || quotaPercent === undefined) && providerApiKey) {
+        const providerQuota = await getProviderQuotaPercentCached(r.providerKey, providerApiKey)
+        if (typeof providerQuota === 'number' && Number.isFinite(providerQuota)) {
+          quotaPercent = providerQuota
+        }
       }
-    }
 
-    // 📖 Store ping result as object with ms and code
-    // 📖 ms = actual response time (even for errors like 429)
-    // 📖 code = HTTP status code ('200', '429', '500', '000' for timeout)
-    r.pings.push({ ms, code })
-
-    // 📖 Update status based on latest ping
-    if (code === '200') {
-      r.status = 'up'
-    } else if (code === '000') {
-      r.status = 'timeout'
-    } else if (code === '401') {
-      // 📖 401 = server is reachable but no API key set (or wrong key)
-      // 📖 Treated as 'noauth' — server is UP, latency is real, just needs a key
-      r.status = 'noauth'
-      r.httpCode = code
-    } else {
-      r.status = 'down'
-      r.httpCode = code
-    }
+      // 📖 Store ping result as object with ms and code
+      // 📖 ms = actual response time (even for errors like 429)
+      // 📖 code = HTTP status code ('200', '429', '500', '000' for timeout)
+      r.pings.push({ ms, code })
+
+      // 📖 Update status based on latest ping
+      if (code === '200') {
+        r.status = 'up'
+      } else if (code === '000') {
+        r.status = 'timeout'
+      } else if (code === '401') {
+        // 📖 401 = server is reachable but no API key set (or wrong key)
+        // 📖 Treated as 'noauth' — server is UP, latency is real, just needs a key
+        r.status = 'noauth'
+        r.httpCode = code
+      } else {
+        r.status = 'down'
+        r.httpCode = code
+      }
 
-    if (typeof quotaPercent === 'number' && Number.isFinite(quotaPercent)) {
-      r.usagePercent = quotaPercent
-      // Provider-level fallback: apply latest known quota to sibling rows on same provider.
-      for (const sibling of state.results) {
-        if (sibling.providerKey === r.providerKey && (sibling.usagePercent === undefined || sibling.usagePercent === null)) {
-          sibling.usagePercent = quotaPercent
+      if (typeof quotaPercent === 'number' && Number.isFinite(quotaPercent)) {
+        r.usagePercent = quotaPercent
+        // Provider-level fallback: apply latest known quota to sibling rows on same provider.
+        for (const sibling of state.results) {
+          if (sibling.providerKey === r.providerKey && (sibling.usagePercent === undefined || sibling.usagePercent === null)) {
+            sibling.usagePercent = quotaPercent
+          }
         }
       }
+    } finally {
+      r.isPinging = false
+      state.pendingPings = Math.max(0, state.pendingPings - 1)
     }
   }
 
   // 📖 Initial ping of all models
   const initialPing = Promise.all(state.results.map(r => pingModel(r)))
 
-  // 📖 Continuous ping loop with dynamic interval (adjustable with W/= keys)
-  const schedulePing = () => {
-    state.pingIntervalObj = setTimeout(async () => {
-      state.lastPingTime = Date.now()
-
-      // 📖 Refresh persisted usage snapshots each cycle so proxy writes appear live in table.
-      // 📖 Freshness-aware: stale snapshots (>30m) are excluded and row reverts to undefined.
-      for (const r of state.results) {
-        const pct = _usageForRow(r.providerKey, r.modelId)
-        if (typeof pct === 'number' && Number.isFinite(pct)) {
-          r.usagePercent = pct
-        } else {
-          // If snapshot is now stale or gone, clear the cached value so UI shows N/A.
-          r.usagePercent = undefined
-        }
+  // 📖 Continuous ping loop with mode-driven cadence.
+  const runPingCycle = async () => {
+    refreshAutoPingMode()
+    state.lastPingTime = Date.now()
+
+    // 📖 Refresh persisted usage snapshots each cycle so proxy writes appear live in table.
+    // 📖 Freshness-aware: stale snapshots (>30m) are excluded and row reverts to undefined.
+    for (const r of state.results) {
+      const pct = _usageForRow(r.providerKey, r.modelId)
+      if (typeof pct === 'number' && Number.isFinite(pct)) {
+        r.usagePercent = pct
+      } else {
+        // If snapshot is now stale or gone, clear the cached value so UI shows N/A.
+        r.usagePercent = undefined
       }
+    }
 
-      state.results.forEach(r => {
-        pingModel(r).catch(() => {
-          // Individual ping failures don't crash the loop
-        })
+    state.results.forEach(r => {
+      pingModel(r).catch(() => {
+        // Individual ping failures don't crash the loop
       })
+    })
 
-      // 📖 Schedule next ping with current interval
-      schedulePing()
-    }, state.pingInterval)
+    refreshAutoPingMode()
+    scheduleNextPing()
   }
 
   // 📖 Start the ping loop
   state.pingIntervalObj = null
-  schedulePing()
+  scheduleNextPing()
 
   await initialPing
 

package/package.json

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

package/sources.js

@@ -12,6 +12,8 @@
  *   - ctx: Context window size in tokens (e.g., "128k", "32k")
  *
  *   Add new sources here to support additional providers beyond NIM.
+ *   Public provider catalogs drift often, so these IDs are periodically
+ *   refreshed against official docs and live model endpoints when available.
  *
  *   🎯 Tier scale (based on SWE-bench Verified):
  *   - S+: 70%+ (elite frontier coders)
@@ -114,9 +116,9 @@ export const cerebras = [
   ['llama-4-scout-17b-16e-instruct',       'Llama 4 Scout',      'A',  '44.0%', '10M'],
   ['qwen-3-32b',                           'Qwen3 32B',          'A+', '50.0%', '128k'],
   ['gpt-oss-120b',                         'GPT OSS 120B',       'S',  '60.0%', '128k'],
-  ['qwen-3-235b-a22b',                     'Qwen3 235B',         'S+', '70.0%', '128k'],
+  ['qwen-3-235b-a22b-instruct-2507',       'Qwen3 235B',         'S+', '70.0%', '128k'],
   ['llama3.1-8b',                          'Llama 3.1 8B',       'B',  '28.8%', '128k'],
-  ['glm-4.6',                              'GLM 4.6',            'A-', '38.0%', '128k'],
+  ['zai-glm-4.7',                          'GLM 4.7',            'S+', '73.8%', '200k'],
 ]
 
 // 📖 SambaNova source - https://cloud.sambanova.ai
@@ -124,14 +126,15 @@ export const cerebras = [
 // 📖 OpenAI-compatible API, supports all major coding models including DeepSeek V3/R1, Qwen3, Llama 4
 export const sambanova = [
   // ── S+ tier ──
-  ['Qwen3-235B-A22B-Instruct-2507',        'Qwen3 235B',         'S+', '70.0%', '128k'],
+  ['MiniMax-M2.5',                         'MiniMax M2.5',       'S+', '74.0%', '160k'],
   // ── S tier ──
   ['DeepSeek-R1-0528',                     'DeepSeek R1 0528',   'S',  '61.0%', '128k'],
   ['DeepSeek-V3.1',                        'DeepSeek V3.1',      'S',  '62.0%', '128k'],
   ['DeepSeek-V3-0324',                     'DeepSeek V3 0324',   'S',  '62.0%', '128k'],
+  ['DeepSeek-V3.2',                        'DeepSeek V3.2',      'S+', '73.1%', '8k'],
   ['Llama-4-Maverick-17B-128E-Instruct',   'Llama 4 Maverick',   'S',  '62.0%', '1M'],
   ['gpt-oss-120b',                         'GPT OSS 120B',       'S',  '60.0%', '128k'],
-  ['deepseek-ai/DeepSeek-V3.1-Terminus',   'DeepSeek V3.1 Term', 'S',  '68.4%', '128k'],
+  ['DeepSeek-V3.1-Terminus',               'DeepSeek V3.1 Term', 'S',  '68.4%', '128k'],
   // ── A+ tier ──
   ['Qwen3-32B',                            'Qwen3 32B',          'A+', '50.0%', '128k'],
   // ── A tier ──
@@ -140,24 +143,23 @@ export const sambanova = [
   ['Meta-Llama-3.3-70B-Instruct',          'Llama 3.3 70B',      'A-', '39.5%', '128k'],
   // ── B tier ──
   ['Meta-Llama-3.1-8B-Instruct',           'Llama 3.1 8B',       'B',  '28.8%', '128k'],
-  // ── A tier — requested Llama3-Groq coding tuned family ──
-  ['Llama-3-Groq-70B-Tool-Use',            'Llama3-Groq 70B',    'A',  '43.0%', '128k'],
 ]
 
 // 📖 OpenRouter source - https://openrouter.ai
 // 📖 Free :free models with shared quota — 50 free req/day
 // 📖 API keys at https://openrouter.ai/keys
 export const openrouter = [
-  ['qwen/qwen3-coder:480b-free',               'Qwen3 Coder 480B',   'S+', '70.6%', '256k'],
-  ['mistralai/devstral-2-free',                'Devstral 2',         'S+', '72.2%', '256k'],
-  ['mimo-v2-flash-free',                       'Mimo V2 Flash',      'A',  '45.0%', '128k'],
+  ['qwen/qwen3-coder:free',                    'Qwen3 Coder 480B',   'S+', '70.6%', '262k'],
+  ['z-ai/glm-4.5-air:free',                    'GLM 4.5 Air',        'S+', '72.0%', '128k'],
+  ['google/gemma-3-27b-it:free',               'Gemma 3 27B',        'B',  '22.0%', '128k'],
   ['stepfun/step-3.5-flash:free',              'Step 3.5 Flash',     'S+', '74.4%', '256k'],
-  ['deepseek/deepseek-r1-0528:free',           'DeepSeek R1 0528',   'S',  '61.0%', '128k'],
   ['qwen/qwen3-next-80b-a3b-instruct:free',    'Qwen3 80B Instruct', 'S',  '65.0%', '128k'],
   ['openai/gpt-oss-120b:free',                 'GPT OSS 120B',       'S',  '60.0%', '128k'],
   ['openai/gpt-oss-20b:free',                  'GPT OSS 20B',        'A',  '42.0%', '128k'],
   ['nvidia/nemotron-3-nano-30b-a3b:free',      'Nemotron Nano 30B',  'A',  '43.0%', '128k'],
   ['meta-llama/llama-3.3-70b-instruct:free',   'Llama 3.3 70B',      'A-', '39.5%', '128k'],
+  ['mistralai/mistral-small-3.1-24b-instruct:free', 'Mistral Small 3.1', 'B+', '30.0%', '128k'],
+  ['google/gemma-3-12b-it:free',               'Gemma 3 12B',        'C',  '15.0%', '128k'],
 ]
 
 // 📖 Hugging Face Inference source - https://huggingface.co

package/src/config.js

@@ -71,7 +71,7 @@
  *   - apiKeys: API keys per provider (can differ between work/personal setups)
  *   - providers: enabled/disabled state per provider
  *   - favorites: list of pinned favorite models
- *   - settings: extra TUI preferences (tierFilter, sortColumn, sortAsc, pingInterval)
+ *   - settings: extra TUI preferences (tierFilter, sortColumn, sortAsc, pingInterval, hideUnconfiguredModels)
  *
  * 📖 When a profile is loaded via --profile <name> or Shift+P, the main config's
  *    apiKeys/providers/favorites are replaced with the profile's values. The profile
@@ -164,6 +164,8 @@ export function loadConfig() {
       // 📖 Ensure the shape is always complete — fill missing sections with defaults
       if (!parsed.apiKeys) parsed.apiKeys = {}
       if (!parsed.providers) parsed.providers = {}
+      if (!parsed.settings || typeof parsed.settings !== 'object') parsed.settings = {}
+      if (typeof parsed.settings.hideUnconfiguredModels !== 'boolean') parsed.settings.hideUnconfiguredModels = true
       // 📖 Favorites: list of "providerKey/modelId" pinned rows.
       if (!Array.isArray(parsed.favorites)) parsed.favorites = []
       parsed.favorites = parsed.favorites.filter((fav) => typeof fav === 'string' && fav.trim().length > 0)
@@ -173,6 +175,10 @@ export function loadConfig() {
       if (typeof parsed.telemetry.anonymousId !== 'string' || !parsed.telemetry.anonymousId.trim()) parsed.telemetry.anonymousId = null
       // 📖 Ensure profiles section exists (added in profile system)
       if (!parsed.profiles || typeof parsed.profiles !== 'object') parsed.profiles = {}
+      for (const profile of Object.values(parsed.profiles)) {
+        if (!profile || typeof profile !== 'object') continue
+        profile.settings = profile.settings ? { ..._emptyProfileSettings(), ...profile.settings } : _emptyProfileSettings()
+      }
       if (parsed.activeProfile && typeof parsed.activeProfile !== 'string') parsed.activeProfile = null
       return parsed
     } catch {
@@ -385,14 +391,15 @@ export function isProviderEnabled(config, providerKey) {
  * 📖 These settings are saved/restored when switching profiles so each profile
  *    can have different sort, filter, and ping preferences.
  *
- * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number }}
+ * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean }}
  */
 export function _emptyProfileSettings() {
   return {
     tierFilter: null,     // 📖 null = show all tiers, or 'S'|'A'|'B'|'C'|'D'
     sortColumn: 'avg',    // 📖 default sort column
     sortAsc: true,        // 📖 true = ascending (fastest first for latency)
-    pingInterval: 8000,   // 📖 default ms between pings
+    pingInterval: 10000,  // 📖 default ms between pings in the steady "normal" mode
+    hideUnconfiguredModels: true, // 📖 true = default to providers that are actually configured
   }
 }
 
@@ -505,6 +512,10 @@ function _emptyConfig() {
   return {
     apiKeys: {},
     providers: {},
+    // 📖 Global TUI preferences that should persist even without a named profile.
+    settings: {
+      hideUnconfiguredModels: true,
+    },
     // 📖 Pinned favorites rendered at top of the table ("providerKey/modelId").
     favorites: [],
     // 📖 Telemetry consent is explicit. null = not decided yet.

package/src/constants.js

@@ -51,7 +51,9 @@ export const ALT_HOME  = '\x1b[H'
 
 // 📖 Timing constants — control how fast the health-check loop runs.
 export const PING_TIMEOUT  = 15_000  // 📖 15s per attempt before abort
-export const PING_INTERVAL = 3_000   // 📖 3s between pings for fast model selection feedback
+// 📖 PING_INTERVAL is the baseline "normal" cadence. Startup can still temporarily
+// 📖 boost to faster modes, but steady-state uses 10s unless the user picks another mode.
+export const PING_INTERVAL = 10_000
 
 // 📖 Animation and column-width constants.
 export const FPS       = 12