free-coding-models 0.2.1 → 0.2.2

package/src/overlays.js

@@ -4,7 +4,8 @@
  *
  * @details
  *   This module centralizes all overlay rendering in one place:
- *   - Settings, Help, Log, Smart Recommend, Feature Request, Bug Report
+ *   - Settings, Install Endpoints, Help, Log, Smart Recommend, Feature Request, Bug Report
+ *   - Settings diagnostics for provider key tests, including wrapped retry/error details
  *   - Recommend analysis timer orchestration and progress updates
  *
  *   The factory pattern keeps stateful UI logic isolated while still
@@ -48,8 +49,32 @@ export function createOverlayRenderers(state, deps) {
     getTopRecommendations,
     adjustScrollOffset,
     getPingModel,
+    getConfiguredInstallableProviders,
+    getInstallTargetModes,
+    getProviderCatalogModels,
   } = deps
 
+  // 📖 Wrap plain diagnostic text so long Settings messages stay readable inside
+  // 📖 the overlay instead of turning into one truncated red line.
+  const wrapPlainText = (text, width = 104) => {
+    const normalized = typeof text === 'string' ? text.trim() : ''
+    if (!normalized) return []
+    const words = normalized.split(/\s+/)
+    const lines = []
+    let current = ''
+    for (const word of words) {
+      const next = current ? `${current} ${word}` : word
+      if (next.length > width && current) {
+        lines.push(current)
+        current = word
+      } else {
+        current = next
+      }
+    }
+    if (current) lines.push(current)
+    return lines
+  }
+
   // 📖 Keep log token formatting aligned with the main table so the same totals
   // 📖 read the same everywhere in the TUI.
   const formatLogTokens = (totalTokens) => {
@@ -118,9 +143,13 @@ export function createOverlayRenderers(state, deps) {
 
       // 📖 Test result badge
       const testResult = state.settingsTestResults[pk]
-      let testBadge = chalk.dim('[Test —]')
+      // 📖 Default badge reflects configuration first: a saved key should look
+      // 📖 ready to test even before the user has run the probe once.
+      let testBadge = keyCount > 0 ? chalk.cyan('[Test]') : chalk.dim('[Missing Key 🔑]')
       if (testResult === 'pending') testBadge = chalk.yellow('[Testing…]')
       else if (testResult === 'ok')   testBadge = chalk.greenBright('[Test ✅]')
+      else if (testResult === 'missing_key') testBadge = chalk.dim('[Missing Key 🔑]')
+      else if (testResult === 'auth_error') testBadge = chalk.red('[Auth ❌]')
       else if (testResult === 'rate_limited') testBadge = chalk.yellow('[Rate limit ⏳]')
       else if (testResult === 'no_callable_model') testBadge = chalk.magenta('[No model ⚠]')
       else if (testResult === 'fail') testBadge = chalk.red('[Test ❌]')
@@ -151,6 +180,14 @@ export function createOverlayRenderers(state, deps) {
         const accountIdStatus = hasAccountId ? chalk.green('CLOUDFLARE_ACCOUNT_ID detected ✅') : chalk.yellow('Set CLOUDFLARE_ACCOUNT_ID ⚠')
         lines.push(chalk.dim(`  4) Export ${chalk.yellow('CLOUDFLARE_ACCOUNT_ID')} in your shell. Status: ${accountIdStatus}`))
       }
+      const testDetail = state.settingsTestDetails?.[selectedProviderKey]
+      if (testDetail) {
+        lines.push('')
+        lines.push(chalk.red.bold('  Test Diagnostics'))
+        for (const detailLine of wrapPlainText(testDetail)) {
+          lines.push(chalk.red(`  ${detailLine}`))
+        }
+      }
       lines.push('')
     }
 
@@ -266,6 +303,168 @@ export function createOverlayRenderers(state, deps) {
     return cleared.join('\n')
   }
 
+  // ─── Install Endpoints overlay renderer ───────────────────────────────────
+  // 📖 renderInstallEndpoints drives the provider → tool → scope → model flow
+  // 📖 behind the `Y` hotkey. It deliberately reuses the same overlay viewport
+  // 📖 helpers as Settings so long provider/model lists stay navigable.
+  function renderInstallEndpoints() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+    const providerChoices = getConfiguredInstallableProviders(state.config)
+    const toolChoices = getInstallTargetModes()
+    const scopeChoices = [
+      {
+        key: 'all',
+        label: 'Install all models',
+        hint: 'Recommended — FCM will refresh this provider catalog automatically later.',
+      },
+      {
+        key: 'selected',
+        label: 'Install selected models only',
+        hint: 'Choose a smaller curated subset for a cleaner model picker.',
+      },
+    ]
+    const selectedProviderLabel = state.installEndpointsProviderKey
+      ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
+      : '—'
+    const selectedToolLabel = state.installEndpointsToolMode
+      ? (state.installEndpointsToolMode === 'opencode-desktop'
+          ? 'OpenCode Desktop (shared opencode.json)'
+          : (state.installEndpointsToolMode === 'opencode'
+              ? 'OpenCode CLI (shared opencode.json)'
+              : state.installEndpointsToolMode === 'openclaw'
+                ? 'OpenClaw'
+                : state.installEndpointsToolMode === 'crush'
+                  ? 'Crush'
+                  : 'Goose'))
+      : '—'
+
+    lines.push('')
+    lines.push(`  ${chalk.bold('🔌 Install Endpoints')}  ${chalk.dim('— install provider catalogs into supported coding tools')}`)
+    if (state.installEndpointsErrorMsg) {
+      lines.push(`  ${chalk.yellow(state.installEndpointsErrorMsg)}`)
+    }
+    lines.push('')
+
+    if (state.installEndpointsPhase === 'providers') {
+      lines.push(`  ${chalk.bold('Step 1/4')}  ${chalk.cyan('Choose a configured provider')}`)
+      lines.push('')
+
+      if (providerChoices.length === 0) {
+        lines.push(chalk.dim('  No configured providers can be installed directly right now.'))
+        lines.push(chalk.dim('  Add an API key in Settings (`P`) first, then reopen this screen.'))
+      } else {
+        providerChoices.forEach((provider, idx) => {
+          const isCursor = idx === state.installEndpointsCursor
+          const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+          const row = `${bullet}${chalk.bold(provider.label.padEnd(24))} ${chalk.dim(`${provider.modelCount} models`)}` 
+          cursorLineByRow[idx] = lines.length
+          lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+        })
+      }
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose provider  •  Esc Close'))
+    } else if (state.installEndpointsPhase === 'tools') {
+      lines.push(`  ${chalk.bold('Step 2/4')}  ${chalk.cyan('Choose the target tool')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}`))
+      lines.push('')
+
+      toolChoices.forEach((toolMode, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const label = toolMode === 'opencode-desktop'
+          ? 'OpenCode Desktop'
+          : toolMode === 'opencode'
+            ? 'OpenCode CLI'
+            : toolMode === 'openclaw'
+              ? 'OpenClaw'
+              : toolMode === 'crush'
+                ? 'Crush'
+                : 'Goose'
+        const note = toolMode.startsWith('opencode')
+          ? chalk.dim('shared config file')
+          : chalk.dim('managed provider install')
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const row = `${bullet}${chalk.bold(label.padEnd(22))} ${note}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+      })
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Choose tool  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'scope') {
+      lines.push(`  ${chalk.bold('Step 3/4')}  ${chalk.cyan('Choose the install scope')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
+      lines.push('')
+
+      scopeChoices.forEach((scope, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const row = `${bullet}${chalk.bold(scope.label)}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+        lines.push(chalk.dim(`      ${scope.hint}`))
+        lines.push('')
+      })
+
+      lines.push(chalk.dim('  Enter Continue  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'models') {
+      const models = getProviderCatalogModels(state.installEndpointsProviderKey)
+      const selectedCount = state.installEndpointsSelectedModelIds.size
+
+      lines.push(`  ${chalk.bold('Step 4/4')}  ${chalk.cyan('Choose which models to install')}`)
+      lines.push(chalk.dim(`  Provider: ${selectedProviderLabel}  •  Tool: ${selectedToolLabel}`))
+      lines.push(chalk.dim(`  Selected: ${selectedCount}/${models.length}`))
+      lines.push('')
+
+      models.forEach((model, idx) => {
+        const isCursor = idx === state.installEndpointsCursor
+        const selected = state.installEndpointsSelectedModelIds.has(model.modelId)
+        const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+        const checkbox = selected ? chalk.greenBright('[✓]') : chalk.dim('[ ]')
+        const tier = chalk.cyan(model.tier.padEnd(2))
+        const row = `${bullet}${checkbox} ${chalk.bold(model.label.padEnd(26))} ${tier} ${chalk.dim(model.ctx.padEnd(6))} ${chalk.dim(model.modelId)}`
+        cursorLineByRow[idx] = lines.length
+        lines.push(isCursor ? chalk.bgRgb(24, 44, 62)(row) : row)
+      })
+
+      lines.push('')
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Space Toggle model  •  A All/None  •  Enter Install  •  Esc Back'))
+    } else if (state.installEndpointsPhase === 'result') {
+      const result = state.installEndpointsResult
+      const accent = result?.type === 'success' ? chalk.greenBright : chalk.redBright
+      lines.push(`  ${chalk.bold('Result')}  ${accent(result?.title || 'Install result unavailable')}`)
+      lines.push('')
+
+      for (const detail of result?.lines || []) {
+        lines.push(`  ${detail}`)
+      }
+
+      if (result?.type === 'success') {
+        lines.push('')
+        lines.push(chalk.dim('  Future FCM launches will refresh this catalog automatically when the provider list evolves.'))
+      }
+
+      lines.push('')
+      lines.push(chalk.dim('  Enter or Esc Close'))
+    }
+
+    const targetLine = cursorLineByRow[state.installEndpointsCursor] ?? 0
+    state.installEndpointsScrollOffset = keepOverlayTargetVisible(
+      state.installEndpointsScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.installEndpointsScrollOffset, state.terminalRows)
+    state.installEndpointsScrollOffset = offset
+
+    const tintedLines = tintOverlayLines(visible, SETTINGS_OVERLAY_BG)
+    const cleared = tintedLines.map((line) => line + EL)
+    return cleared.join('\n')
+  }
+
   // ─── Help overlay renderer ────────────────────────────────────────────────
   // 📖 renderHelp: Draw the help overlay listing all key bindings.
   // 📖 Toggled with K key. Gives users a quick reference without leaving the TUI.
@@ -280,7 +479,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.cyan('Rank')}        SWE-bench rank (1 = best coding score)  ${chalk.dim('Sort:')} ${chalk.yellow('R')}`)
     lines.push(`              ${chalk.dim('Quick glance at which model is objectively the best coder right now.')}`)
     lines.push('')
-    lines.push(`  ${chalk.cyan('Tier')}        S+ / S / A+ / A / A- / B+ / B / C based on SWE-bench score  ${chalk.dim('Sort:')} ${chalk.yellow('Y')}  ${chalk.dim('Cycle:')} ${chalk.yellow('T')}`)
+    lines.push(`  ${chalk.cyan('Tier')}        S+ / S / A+ / A / A- / B+ / B / C based on SWE-bench score  ${chalk.dim('Cycle:')} ${chalk.yellow('T')}`)
     lines.push(`              ${chalk.dim('Skip the noise — S/S+ models solve real GitHub issues, C models are for light tasks.')}`)
     lines.push('')
     lines.push(`  ${chalk.cyan('SWE%')}        SWE-bench score — coding ability benchmark (color-coded)  ${chalk.dim('Sort:')} ${chalk.yellow('S')}`)
@@ -331,6 +530,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('X')}  Toggle token log page  ${chalk.dim('(shows recent request usage from request-log.jsonl)')}`)
     lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode → Desktop → OpenClaw → Crush → Goose)')}`)
     lines.push(`  ${chalk.yellow('F')}  Toggle favorite on selected row  ${chalk.dim('(⭐ pinned at top, persisted)')}`)
+    lines.push(`  ${chalk.yellow('Y')}  Install endpoints  ${chalk.dim('(provider catalog → OpenCode/OpenClaw/Crush/Goose, no proxy)')}`)
     lines.push(`  ${chalk.yellow('Q')}  Smart Recommend  ${chalk.dim('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${chalk.rgb(57, 255, 20).bold('J')}  Request Feature  ${chalk.dim('(📝 send anonymous feedback to the project team)')}`)
     lines.push(`  ${chalk.rgb(255, 87, 51).bold('I')}  Report Bug  ${chalk.dim('(🐛 send anonymous bug report to the project team)')}`)
@@ -907,6 +1107,7 @@ export function createOverlayRenderers(state, deps) {
 
   return {
     renderSettings,
+    renderInstallEndpoints,
     renderHelp,
     renderLog,
     renderRecommend,

package/src/provider-metadata.js

@@ -114,7 +114,9 @@ export const PROVIDER_METADATA = {
     label: 'Hugging Face Inference',
     color: chalk.rgb(255, 245, 157),
     signupUrl: 'https://huggingface.co/settings/tokens',
-    signupHint: 'Settings → Access Tokens',
+    // 📖 Hugging Face serverless inference now expects a fine-grained token with
+    // 📖 the dedicated Inference Providers permission, not a generic read token.
+    signupHint: 'Settings → Access Tokens → Fine-grained → enable "Make calls to Inference Providers"',
     rateLimits: 'Free monthly credits (~$0.10)',
   },
   replicate: {

package/src/render-table.js

@@ -14,6 +14,8 @@
  *   - Viewport clipping with above/below indicators
  *   - Smart badges (mode, tier filter, origin filter, profile)
  *   - Proxy status line integrated in footer
+ *   - Install-endpoints shortcut surfaced directly in the footer hints
+ *   - Distinct auth-failure vs missing-key health labels so configured providers stay honest
  *
  *   → Functions:
  *   - `setActiveProxy` — Provide the active proxy instance for footer status rendering
@@ -434,6 +436,11 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       // 📖 Server responded but needs an API key — shown dimly since it IS reachable
       statusText = `🔑 NO KEY`
       statusColor = (s) => chalk.dim(s)
+    } else if (r.status === 'auth_error') {
+      // 📖 A key is configured but the provider rejected it — keep this distinct
+      // 📖 from "no key" so configured-only mode does not look misleading.
+      statusText = `🔐 AUTH FAIL`
+      statusColor = (s) => chalk.redBright(s)
     } else if (r.status === 'pending') {
       statusText = `${FRAMES[frame % FRAMES.length]} wait`
       statusColor = (s) => chalk.dim.yellow(s)
@@ -635,8 +642,8 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     chalk.dim(`  •  `) +
     hotkey('K', ' Help')
   )
-  // 📖 Line 2: profiles, recommend, feature request, bug report, and extended hints — gives visibility to less-obvious features
-  lines.push(chalk.dim(`  `) + hotkey('⇧P', ' Cycle profile') + chalk.dim(`  •  `) + hotkey('⇧S', ' Save profile') + chalk.dim(`  •  `) + hotkey('Q', ' Smart Recommend') + chalk.dim(`  •  `) + hotkey('J', ' Request feature') + chalk.dim(`  •  `) + hotkey('I', ' Report bug'))
+  // 📖 Line 2: profiles, install flow, recommend, feature request, bug report, and extended hints.
+  lines.push(chalk.dim(`  `) + hotkey('⇧P', ' Cycle profile') + chalk.dim(`  •  `) + hotkey('⇧S', ' Save profile') + chalk.dim(`  •  `) + hotkey('Y', ' Install endpoints') + chalk.dim(`  •  `) + hotkey('Q', ' Smart Recommend') + chalk.dim(`  •  `) + hotkey('J', ' Request feature') + chalk.dim(`  •  `) + hotkey('I', ' Report bug'))
   // 📖 Proxy status line — always rendered with explicit state (starting/running/failed/stopped)
   lines.push(renderProxyStatusLine(proxyStartupStatus, activeProxyRef, proxyEnabled))
   if (versionStatus.isOutdated) {

package/src/utils.js

@@ -218,9 +218,11 @@ export const getStabilityScore = (r) => {
 // 📖 sortResults: Sort the results array by any column the user can click/press in the TUI.
 // 📖 Returns a NEW array — never mutates the original (important for React-style re-renders).
 //
-// 📖 Supported columns (matching the keyboard shortcuts in the TUI):
+// 📖 Supported columns in the sorter.
+// 📖 Most map directly to visible TUI sort hotkeys; `tier` remains available internally
+// 📖 even though the live TUI now reserves `Y` for the install-endpoints flow.
 //   - 'rank'      (R key) — original index from sources.js
-//   - 'tier'      (T key) — tier hierarchy (S+ first, C last)
+//   - 'tier'      (internal) — tier hierarchy (S+ first, C last)
 //   - 'origin'    (O key) — provider name (all NIM for now, future-proofed)
 //   - 'model'     (M key) — alphabetical by display label
 //   - 'ping'      (L key) — last ping latency (only successful ones count)