free-coding-models 0.5.28 → 0.5.29

package/src/core/shared-helpers.js

@@ -0,0 +1,117 @@
+/**
+ * @file shared-helpers.js
+ * @description Shared utility functions used across multiple modules.
+ *
+ * @details
+ *   📖 DRY helpers extracted from router-daemon.js, tool-launchers.js,
+ *   📖 endpoint-installer.js, and legacy-proxy-cleanup.js to eliminate
+ *   duplicate implementations of the same patterns.
+ *
+ * @functions
+ *   → sleep — Promise-based setTimeout
+ *   → ensureDir — Create parent directory if missing
+ *   → readJson — Read and parse JSON file with fallback
+ *   → writeJson — Write JSON file with directory creation
+ *   → atomicWriteJson — Atomic write via temp file + rename
+ *   → safeJsonParse — JSON.parse with fallback
+ *   → maskApiKey — Mask API key for display (show last 4 chars)
+ *
+ * @exports sleep, ensureDir, readJson, writeJson, atomicWriteJson, safeJsonParse, maskApiKey
+ */
+
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
+import { dirname } from 'node:path'
+
+/**
+ * 📖 Promise-based sleep. Used by daemon probe staggering, TUI animations, etc.
+ * @param {number} ms
+ * @returns {Promise<void>}
+ */
+export function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+/**
+ * 📖 Create parent directory of `filePath` if it doesn't exist.
+ * @param {string} filePath
+ */
+export function ensureDir(filePath) {
+  const dir = dirname(filePath)
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+}
+
+/**
+ * 📖 Read and parse a JSON file. Returns `fallback` on any error.
+ * @param {string} filePath
+ * @param {*} [fallback=null]
+ * @returns {*}
+ */
+export function readJson(filePath, fallback = null) {
+  if (!existsSync(filePath)) return fallback
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf8'))
+  } catch {
+    return fallback
+  }
+}
+
+/**
+ * 📖 Write JSON to file, creating parent directories as needed.
+ * @param {string} filePath
+ * @param {*} value
+ * @param {object} [options]
+ * @param {boolean} [options.backup=false] — Not implemented here; callers handle it
+ */
+export function writeJson(filePath, value) {
+  ensureDir(filePath)
+  writeFileSync(filePath, JSON.stringify(value, null, 2))
+}
+
+/**
+ * 📖 Atomic JSON write: writes to a temp file, then renames over the target.
+ * Prevents partial writes from corrupting the file on crash.
+ * @param {string} path
+ * @param {*} data
+ * @param {number} [mode=0o600]
+ */
+export function atomicWriteJson(path, data, mode = 0o600) {
+  const tempPath = `${path}.tmp-${process.pid}-${Date.now()}`
+  writeFileSync(tempPath, JSON.stringify(data, null, 2), { mode })
+  renameSync(tempPath, path)
+}
+
+/**
+ * 📖 JSON.parse with fallback. Returns `fallback` on parse failure.
+ * @param {string} raw
+ * @param {*} [fallback=null]
+ * @returns {*}
+ */
+export function safeJsonParse(raw, fallback = null) {
+  try {
+    return JSON.parse(raw)
+  } catch {
+    return fallback
+  }
+}
+
+/**
+ * 📖 Mask an API key for display. Shows last 4 chars, rest as bullets.
+ * @param {string} key
+ * @returns {string}
+ */
+/**
+ * 📖 Check if a provider supports routing (has chat/completions URL, not CLI-only).
+ * @param {string} providerKey
+ * @param {Record<string, {url?: string, cliOnly?: boolean}>} sources — provider catalog
+ * @returns {boolean}
+ */
+export function isRouteableProvider(providerKey, sources) {
+  const source = sources[providerKey]
+  return Boolean(source?.url && !source.cliOnly && source.url.includes('/chat/completions'))
+}
+
+export function maskApiKey(key) {
+  if (!key || typeof key !== 'string') return ''
+  if (key.length <= 8) return '••••••••'
+  return '••••••••' + key.slice(-4)
+}

package/src/core/sync-set.js

@@ -39,9 +39,8 @@ import {
 import { resolveCloudflareUrl } from './ping.js'
 import { ROUTER_PID_PATH } from './router-daemon.js'
 import { existsSync, readFileSync } from 'node:fs'
-
-// 📖 Tier ordering — best tiers first, used for scoring candidates.
-const TIER_ORDER = ['S+', 'S', 'A+', 'A', 'A-', 'B+', 'B', 'C']
+import { TIER_ORDER, parseSweToNum } from './utils.js'
+import { isRouteableProvider } from './shared-helpers.js'
 
 // 📖 Numeric value per tier for composite scoring.
 const TIER_SCORES = {
@@ -69,14 +68,7 @@ const OPENROUTER_FREE_MODEL_IDS = new Set([
   'openrouter/owl-alpha',
 ])
 
-/**
- * Check whether a provider's catalog entry supports routing (has a
- * chat/completions URL and is not CLI-only).
- */
-function isRouteableProvider(providerKey) {
-  const source = sources[providerKey]
-  return Boolean(source?.url && !source.cliOnly && source.url.includes('/chat/completions'))
-}
+// 📖 isRouteableProvider imported from shared-helpers.js (needs `sources` param)
 
 /**
  * Resolve the upstream URL for a provider, handling Cloudflare template substitution.
@@ -98,14 +90,7 @@ function isOpenRouterFreeModelId(modelId) {
   return String(modelId).endsWith(':free') || OPENROUTER_FREE_MODEL_IDS.has(String(modelId))
 }
 
-/**
- * Parse a SWE-bench percentage string like "49.2%" to a number.
- */
-function parseSwePercent(value) {
-  if (typeof value !== 'string') return 0
-  const numeric = parseFloat(value.replace('%', '').trim())
-  return Number.isFinite(numeric) ? numeric : 0
-}
+// 📖 parseSwePercent replaced by shared parseSweToNum (same logic)
 
 /**
  * Score a candidate model for ranking. Higher is better.
@@ -156,12 +141,12 @@ export function buildSyncCandidates(apiKeys, options = {}) {
 
   for (const [providerKey, sourceData] of Object.entries(sources)) {
     if (!apiKeys[providerKey]) continue
-    if (!isRouteableProvider(providerKey)) continue
+    if (!isRouteableProvider(providerKey, sources)) continue
 
     for (const tuple of sourceData.models || []) {
       const [modelId, label = '', tier = '', swe = '0%'] = tuple
       if (typeof modelId !== 'string' || !modelId.trim()) continue
-      const swePercent = parseSwePercent(swe)
+      const swePercent = parseSweToNum(swe)
       if (shouldSkipModel(providerKey, modelId, tier, swePercent, options)) continue
       const score = scoreCandidate(providerKey, modelId, label, tier, swePercent)
       candidates.push({

package/src/core/tool-launchers.js

@@ -39,7 +39,7 @@
 import chalk from 'chalk'
 import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs'
 import { homedir } from 'os'
-import { dirname, join } from 'path'
+import { join } from 'path'
 import { spawn, spawnSync } from 'child_process'
 import { sources } from '../../sources.js'
 import { PROVIDER_COLOR } from '../tui/render-table.js'
@@ -48,6 +48,7 @@ import { ENV_VAR_NAMES, isWindows } from './provider-metadata.js'
 import { getToolMeta, TOOL_METADATA } from './tool-metadata.js'
 import { PROVIDER_METADATA } from './provider-metadata.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
+import { ensureDir, readJson, writeJson } from './shared-helpers.js'
 
 const OPENAI_COMPAT_ENV_KEYS = [
   'OPENAI_API_KEY',
@@ -60,11 +61,6 @@ const OPENAI_COMPAT_ENV_KEYS = [
 ]
 const SANITIZED_TOOL_ENV_KEYS = [...OPENAI_COMPAT_ENV_KEYS]
 
-function ensureDir(filePath) {
-  const dir = dirname(filePath)
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
-}
-
 // 📖 Parse a context window string (e.g. "128k", "1M", "32k") to token count number.
 function parseCtxToTokens(ctx) {
   if (!ctx || typeof ctx !== 'string') return null
@@ -104,19 +100,7 @@ function backupIfExists(filePath) {
   return backupPath
 }
 
-function readJson(filePath, fallback) {
-  if (!existsSync(filePath)) return fallback
-  try {
-    return JSON.parse(readFileSync(filePath, 'utf8'))
-  } catch {
-    return fallback
-  }
-}
-
-function writeJson(filePath, value) {
-  ensureDir(filePath)
-  writeFileSync(filePath, JSON.stringify(value, null, 2))
-}
+// 📖 readJson/writeJson imported from shared-helpers.js
 
 function getProviderBaseUrl(providerKey) {
   const url = sources[providerKey]?.url
@@ -966,55 +950,8 @@ export async function startExternalTool(mode, model, config) {
   console.log(chalk.cyan(`  ▶ Launching ${meta.label} with ${chalk.bold(model.label)}...`))
   printConfigArtifacts(meta.label, launchPlan.configArtifacts)
 
-  if (mode === 'aider') {
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'crush') {
-    console.log(chalk.dim('  📖 Crush will use the provider directly for this launch.'))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'goose') {
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'qwen') {
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'openhands') {
-    console.log(chalk.dim(`  📖 OpenHands launched with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'amp') {
-    console.log(chalk.dim(`  📖 Amp config updated with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'pi') {
-    // 📖 Pi supports --provider and --model flags for guaranteed auto-selection
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'hermes') {
-    // 📖 Restart the Hermes gateway so the new model config takes effect immediately
-    restartHermesGateway()
-    console.log(chalk.dim(`  📖 Hermes Agent configured with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'continue') {
-    console.log(chalk.dim(`  📖 Continue CLI configured with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'cline') {
-    console.log(chalk.dim(`  📖 Cline configured with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
+  // 📖 Pre-launch hooks for tools that need special treatment
+  if (mode === 'hermes') restartHermesGateway()
   if (mode === 'xcode') {
     const xcodeUrl = launchPlan.baseUrl ? launchPlan.baseUrl.replace(/\/v1$/, '').replace(/\/v1\/chat\/completions$/, '') : ''
     console.log(chalk.bold.cyan('\n  🛠️  Xcode Intelligence Setup Instructions:'))
@@ -1027,29 +964,24 @@ export async function startExternalTool(mode, model, config) {
     console.log(chalk.dim('     Description: ') + chalk.green(`FCM - ${sources[model.providerKey]?.name || model.providerKey}`))
     console.log(chalk.white(`  4. Click Add, then select `) + chalk.bold(model.modelId) + chalk.white(` from the list.\n`))
     console.log(chalk.dim(`  📖 Attempting to launch Xcode...`))
-    return spawnCommand(launchPlan.command, launchPlan.args, launchPlan.env)
   }
-
-  if (mode === 'caveman') {
-    console.log(chalk.dim(`  📖 Launching Caveman Code...`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'jcode') {
-    console.log(chalk.dim(`  📖 Launching jcode...`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'copilot') {
-    console.log(chalk.dim(`  📖 Copilot CLI configured with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  if (mode === 'forgecode') {
-    console.log(chalk.dim(`  📖 ForgeCode configured with model: ${model.modelId}`))
-    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
-  }
-
-  console.log(chalk.red(`  X Unsupported external tool mode: ${mode}`))
-  return 1
+  if (mode === 'crush') console.log(chalk.dim('  📖 Crush will use the provider directly for this launch.'))
+
+  // 📖 Tool-specific info messages (only for modes that have no prepare-step message)
+  const infoMessages = {
+    openhands: `  📖 OpenHands launched with model: ${model.modelId}`,
+    amp:       `  📖 Amp config updated with model: ${model.modelId}`,
+    hermes:    `  📖 Hermes Agent configured with model: ${model.modelId}`,
+    continue:  `  📖 Continue CLI configured with model: ${model.modelId}`,
+    cline:     `  📖 Cline configured with model: ${model.modelId}`,
+    caveman:   '  📖 Launching Caveman Code...',
+    jcode:     '  📖 Launching jcode...',
+    copilot:   `  📖 Copilot CLI configured with model: ${model.modelId}`,
+    forgecode: `  📖 ForgeCode configured with model: ${model.modelId}`,
+  }
+  if (infoMessages[mode]) console.log(chalk.dim(infoMessages[mode]))
+
+  // 📖 xcode uses raw command ("open"), everything else resolves via tool-bootstrap
+  const command = mode === 'xcode' ? launchPlan.command : resolveLaunchCommand(mode, launchPlan.command)
+  return spawnCommand(command, launchPlan.args, launchPlan.env)
 }

package/src/core/utils.js

@@ -41,6 +41,7 @@
  * @exports sortResults, filterByTier, findBestModel, parseArgs
  * @exports scoreModelForTask, getTopRecommendations
  * @exports TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS
+ * @exports parseCtxToK, parseSweToNum, formatCtxWindow, labelFromId, NEW_MODELS, getVersionStatusInfo, formatResultsAsJSON
  *
  * @see bin/free-coding-models.js — main CLI that imports these utils
  * @see sources.js — model definitions consumed by these functions
@@ -115,80 +116,27 @@ export const getAvg = (r) => {
 //
 // 📖 The "wasUpBefore" check is key — it distinguishes between a model that's
 //    temporarily flaky vs one that was never reachable in the first place.
+// 📖 NEW_MODEL_DURATION_MS — how long a model shows the 🆕 badge after being added.
+// 📖 5 days in milliseconds.
+export const NEW_MODEL_DURATION_MS = 5 * 24 * 60 * 60 * 1000
+
+/**
+ * 📖 Check if a model should display the 🆕 badge.
+ * 📖 A model is "new" if its addedDate is within the last 5 days.
+ * 📖 `addedDate` comes from sources.js as the optional 6th element of model tuples.
+ * @param {string|null|undefined} addedDate — ISO date string (e.g. '2026-06-10')
+ * @returns {boolean}
+ */
+export function isNewModel(addedDate) {
+  if (!addedDate || typeof addedDate !== 'string') return false
+  const added = Date.parse(addedDate)
+  if (!Number.isFinite(added)) return false
+  return (Date.now() - added) < NEW_MODEL_DURATION_MS
+}
+
+// 📖 NEW_MODELS kept for backward compat with web/website surfaces that
+// 📖 don't have addedDate. Will be removed once all surfaces migrate.
 export const NEW_MODELS = new Set([
-  'nvidia/nemotron-3-ultra-550b-a55b',
-  '@cf/meta/llama-3.2-90b-instruct',
-  '@cf/mistralai/mistral-7b-instruct-v0.2',
-  '@cf/google/gemma-2-9b-it',
-  '@cf/anthropic/claude-3-5-sonnet',
-  '@cf/openai/gpt-4o-mini',
-  '@cf/qwen/qwen3-30b-a3b-fp8',
-  '@cf/qwen/qwen2.5-coder-32b-instruct',
-  '@cf/meta/llama-3.3-70b-instruct-fp8-fast',
-  '@cf/google/gemma-4-26b-a4b-it',
-  '@cf/mistralai/mistral-small-3.1-24b-instruct',
-  '@cf/ibm/granite-4.0-h-micro',
-  'minimaxai/minimax-m2.7',
-  'z-ai/glm-5.1',
-  'moonshotai/kimi-k2.6',
-  'stepfun-ai/step-3.5-flash',
-  'stepfun-ai/step-3.7-flash',
-  'qwen/qwen3-coder-480b-a35b-instruct',
-  'qwen/qwen3.5-397b-a17b',
-  'meta/llama-4-maverick-17b-128e-instruct',
-  'mistralai/mistral-medium-3.5-128b',
-  'mistralai/mistral-small-4-119b-2603',
-  'qwen/qwen3.5-122b-a10b',
-  'mistralai/mistral-large-3-675b-instruct-2512',
-  'nvidia/nemotron-3-super-120b-a12b',
-  'nvidia/nemotron-3-nano-omni-30b-a3b-reasoning',
-  'google/gemma-4-31b-it',
-  'bytedance/seed-oss-36b-instruct',
-  'stockmark/stockmark-2-100b-instruct',
-  'mistralai/ministral-14b-instruct-2512',
-  'meta/llama-3.2-11b-vision-instruct',
-  'microsoft/phi-4-mini-instruct',
-  'gemma-3-12b-it',
-  'nvidia/nemotron-nano-9b-v2',
-  'openrouter/owl-alpha',
-  'nousresearch/hermes-3-llama-3.1-405b:free',
-  'nvidia/nemotron-nano-30b-a3b:free',
-  'cognitivecomputations/dolphin-mistral-24b-venice-edition:free',
-  'meta-llama/llama-3.3-70b-instruct:free',
-  'meta-llama/llama-3.2-3b-instruct:free',
-  'liquid/lfm-2.5-1.2b-instruct:free',
-  'liquid/lfm-2.5-1.2b-thinking:free',
-  'qwen3.7-max',
-  'qwen3-max',
-  'qwen3.6-plus',
-  'qwen3-235b-a22b',
-  'qwen3.5-plus',
-  'qwen3-coder-plus',
-  'qwen3-coder-next',
-  'qwen3.6-flash',
-  'qwen3.5-flash',
-  'qwen3-coder-flash',
-  'qwen3-32b',
-  'qwen3-coder-30b-a3b-instruct',
-  'holo2-30b-a3b',
-  'llama-3.3-70b-instruct',
-  'mistral-small-3.2-24b-instruct-2506',
-  'gemma-3-27b-it',
-  'qwen3.5-397b-a17b',
-  'qwen3-coder-30b-a3b-instruct',
-  'gpt-oss-120b',
-  'gpt-oss-20b',
-  'Meta-Llama-3_3-70B-Instruct',
-  'Qwen3-32B',
-  'Mistral-Small-3.2-24B-Instruct-2506',
-  'Mistral-7B-Instruct-v0.3',
-  'Mistral-Nemo-Instruct-2407',
-  'Qwen3.5-9B',
-  'big-pickle',
-  'deepseek-v4-flash-free',
-  'mimo-v2.5-free',
-  'nemotron-3-super-free',
-  'minimax-m3-free'
 ]);
 
 export const getVerdict = (r) => {
@@ -376,34 +324,12 @@ export const sortResults = (results, sortColumn, sortDirection, { benchmarkResul
         break
       case 'swe': {
         // 📖 Sort by SWE-bench score — higher is better
-        // 📖 Parse percentage strings like "49.2%", "73.1%" or use 0 for missing values
-        const parseSwe = (score) => {
-          if (!score || score === '—') return 0
-          const num = parseFloat(score.replace('%', ''))
-          return isNaN(num) ? 0 : num
-        }
-        cmp = parseSwe(a.sweScore) - parseSwe(b.sweScore)
+        cmp = parseSweToNum(a.sweScore) - parseSweToNum(b.sweScore)
         break
       }
       case 'ctx': {
-        // 📖 Sort by context window size — larger is better
-        // 📖 Parse strings like "128k", "32k", "1m" into numeric tokens
-        const parseCtx = (ctx) => {
-          if (!ctx || ctx === '—') return 0
-          const str = ctx.toLowerCase()
-          // 📖 Handle millions (1m = 1000k)
-          if (str.includes('m')) {
-            const num = parseFloat(str.replace('m', ''))
-            return num * 1000
-          }
-          // 📖 Handle thousands (128k)
-          if (str.includes('k')) {
-            const num = parseFloat(str.replace('k', ''))
-            return num
-          }
-          return 0
-        }
-        cmp = parseCtx(a.ctx) - parseCtx(b.ctx)
+        // 📖 Sort by context window size — larger is better (uses parseCtxToK)
+        cmp = parseCtxToK(a.ctx) - parseCtxToK(b.ctx)
         break
       }
       case 'condition':
@@ -727,7 +653,7 @@ export const CONTEXT_BUDGETS = {
 
 // 📖 parseCtxToK: Convert context window string ("128k", "1m", "200k") into numeric K tokens.
 // 📖 Used by the scoring engine to compare against CONTEXT_BUDGETS thresholds.
-function parseCtxToK(ctx) {
+export function parseCtxToK(ctx) {
   if (!ctx || ctx === '—') return 0
   const str = ctx.toLowerCase()
   if (str.includes('m')) return parseFloat(str.replace('m', '')) * 1000
@@ -756,7 +682,7 @@ export function labelFromId(id) {
 
 // 📖 parseSweToNum: Convert SWE-bench score string ("49.2%", "73.1%") into a 0–100 number.
 // 📖 Returns 0 for missing or invalid scores.
-function parseSweToNum(sweScore) {
+export function parseSweToNum(sweScore) {
   if (!sweScore || sweScore === '—') return 0
   const num = parseFloat(sweScore.replace('%', ''))
   return isNaN(num) ? 0 : num

package/src/tui/app.js

@@ -307,8 +307,8 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
 
   let results = MODELS
     .filter(([,,,,,providerKey]) => isProviderEnabled(config, providerKey))
-    .map(([modelId, label, tier, sweScore, ctx, providerKey], i) => ({
-      idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey,
+    .map(([modelId, label, tier, sweScore, ctx, providerKey, addedDate], i) => ({
+      idx: i + 1, modelId, label, tier, sweScore, ctx, providerKey, addedDate: addedDate || null,
       status: 'pending',
       pings: [],  // 📖 All ping results (ms or 'TIMEOUT')
       httpCode: null,

package/src/tui/command-palette.js

@@ -202,6 +202,7 @@ const BASE_COMMAND_TREE = [
       { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
       { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '\u{1F504}', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
       { id: 'action-probe-404', label: 'Probe 404 Models', shortcut: 'Ctrl+Shift+P', icon: '\u{1F50D}', description: 'Test all configured models for 404/410 errors. Auto-hides broken models.', keywords: ['probe', '404', 'broken', 'dead', 'health', 'check', 'test', 'verify'] },
+      { id: 'action-toggle-auto-hide-broken', label: 'Toggle Auto-hide Broken Models', icon: '\u{1F6A9}', description: 'Enable/disable auto-hiding of 404/410 models. Unhides all when disabled.', keywords: ['auto', 'hide', 'broken', '404', 'models', 'toggle', 'probe'] },
     ],
   },
   // 📖 Pages - directly at root level, not in submenu