free-coding-models 0.2.15 → 0.3.0

package/src/render-table.js

@@ -13,7 +13,7 @@
  *   - Emoji-aware padding via padEndDisplay for aligned verdict/status cells
  *   - Viewport clipping with above/below indicators
  *   - Smart badges (mode, tier filter, origin filter, profile)
- *   - Proxy status line integrated in footer
+ *   - Footer J badge: green "Proxy On" / red "Proxy Off" indicator with direct overlay access
  *   - Install-endpoints shortcut surfaced directly in the footer hints
  *   - Distinct auth-failure vs missing-key health labels so configured providers stay honest
  *
@@ -40,7 +40,7 @@ import { TIER_COLOR } from './tier-colors.js'
 import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from './utils.js'
 import { usagePlaceholderForProvider } from './ping.js'
 import { formatTokenTotalCompact } from './token-usage-reader.js'
-import { calculateViewport, sortResultsWithPinnedFavorites, renderProxyStatusLine, padEndDisplay } from './render-helpers.js'
+import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay } from './render-helpers.js'
 import { getToolMeta } from './tool-metadata.js'
 
 const ACTIVE_FILTER_BG_BY_TIER = {
@@ -92,7 +92,7 @@ export function setActiveProxy(proxyInstance) {
 }
 
 // ─── renderTable: mode param controls footer hint text (opencode vs openclaw) ─────────
-export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, proxyEnabled = false, isOutdated = false, latestVersion = null) {
+export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, proxyEnabled = false, isOutdated = false, latestVersion = null) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -193,23 +193,25 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const W_TOKENS = 7
   const W_USAGE = 7
   const MIN_TABLE_WIDTH = 166
-  const warningDurationMs = 5_000
+  const warningDurationMs = 4_000
   const elapsed = widthWarningStartedAt ? Math.max(0, Date.now() - widthWarningStartedAt) : warningDurationMs
   const remainingMs = Math.max(0, warningDurationMs - elapsed)
-  const showWidthWarning = terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH && !widthWarningDismissed && remainingMs > 0
+  const showWidthWarning = terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH && !widthWarningDismissed && widthWarningShowCount < 2 && remainingMs > 0
 
   if (showWidthWarning) {
     const lines = []
-    const blankLines = Math.max(0, Math.floor(((terminalRows || 24) - 5) / 2))
-    const warning = 'Please maximize your terminal for optimal use.'
-    const warning2 = 'The current terminal is too small.'
-    const warning3 = 'Reduce font size or maximize width of terminal.'
+    const blankLines = Math.max(0, Math.floor(((terminalRows || 24) - 7) / 2))
+    const warning = '🖥️  Please maximize your terminal for optimal use.'
+    const warning2 = '⚠️  The current terminal is too small.'
+    const warning3 = '📏  Reduce font size or maximize width of terminal.'
     const padLeft = Math.max(0, Math.floor((terminalCols - warning.length) / 2))
     const padLeft2 = Math.max(0, Math.floor((terminalCols - warning2.length) / 2))
     const padLeft3 = Math.max(0, Math.floor((terminalCols - warning3.length) / 2))
     for (let i = 0; i < blankLines; i++) lines.push('')
     lines.push(' '.repeat(padLeft) + chalk.red.bold(warning))
+    lines.push('')
     lines.push(' '.repeat(padLeft2) + chalk.red(warning2))
+    lines.push('')
     lines.push(' '.repeat(padLeft3) + chalk.red(warning3))
     lines.push('')
     lines.push(' '.repeat(Math.max(0, Math.floor((terminalCols - 34) / 2))) + chalk.yellow(`this message will hide in ${(remainingMs / 1000).toFixed(1)}s`))
@@ -620,7 +622,8 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const activeHotkey = (keyLabel, text, bg = [57, 255, 20], fg = [0, 0, 0]) => chalk.bgRgb(...bg).rgb(...fg)(` ${keyLabel}${text} `)
   // 📖 Line 1: core navigation + filtering shortcuts
   lines.push(
-    chalk.dim(`  ↑↓ Navigate  •  `) +
+    (proxyEnabled ? activeHotkey('J', ' 📡 FCM Proxy V2 On') : activeHotkey('J', ' 📡 FCM Proxy V2 Off', [180, 30, 30], [255, 255, 255])) +
+    chalk.dim(`  •  `) +
     hotkey('F', ' Toggle Favorite') +
     chalk.dim(`  •  `) +
     (tierFilterMode > 0
@@ -631,7 +634,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       ? activeHotkey('D', ` Provider (${activeOriginLabel})`, [0, 0, 0], PROVIDER_COLOR[[null, ...Object.keys(sources)][originFilterMode]] || [255, 255, 255])
       : hotkey('D', ' Provider')) +
     chalk.dim(`  •  `) +
-    (hideUnconfiguredModels ? activeHotkey('E', ' Configured Only') : hotkey('E', ' Configured Only')) +
+    (hideUnconfiguredModels ? activeHotkey('E', ' Configured Models Only') : hotkey('E', ' Configured Models Only')) +
     chalk.dim(`  •  `) +
     hotkey('X', ' Token Logs') +
     chalk.dim(`  •  `) +
@@ -639,10 +642,16 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     chalk.dim(`  •  `) +
     hotkey('K', ' Help')
   )
-  // 📖 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))
+  // 📖 Line 2: profiles, install flow, recommend, proxy shortcut, feedback, 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('I', ' Feedback, bugs & requests')
+  )
+  // 📖 Proxy status is now shown via the J badge in line 2 above — no need for a dedicated line
   if (versionStatus.isOutdated) {
     const outdatedBadge = chalk.bgRed.bold.yellow(' This version is outdated . ')
     const latestLabel = chalk.redBright(` local v${LOCAL_VERSION} · latest v${versionStatus.latestVersion}`)

package/src/tool-launchers.js

@@ -15,8 +15,16 @@
  *   For those, we prefer a transparent warning over pretending the integration is
  *   fully official. The user still gets a reproducible env/config handoff.
  *
+ *   📖 Goose: writes custom provider JSON + secrets.yaml + updates config.yaml (GOOSE_PROVIDER/GOOSE_MODEL)
+ *   📖 Crush: writes crush.json with provider config + models.large/small defaults
+ *   📖 Pi: uses --provider/--model CLI flags for guaranteed auto-selection
+ *   📖 Aider: writes ~/.aider.conf.yml + passes --model flag
+ *   📖 Claude Code: uses ANTHROPIC_BASE_URL env + --model flag (proxy translates Anthropic ↔ OpenAI)
+ *
  * @functions
  *   → `resolveLauncherModelId` — choose the provider-specific id or proxy slug for a launch
+ *   → `writeGooseConfig` — install provider + set GOOSE_PROVIDER/GOOSE_MODEL in config.yaml
+ *   → `writeCrushConfig` — write provider + models.large/small to crush.json
  *   → `startExternalTool` — configure and launch the selected external tool mode
  *
  * @exports resolveLauncherModelId, startExternalTool
@@ -37,6 +45,7 @@ import { getApiKey, getProxySettings } from './config.js'
 import { ENV_VAR_NAMES, isWindows } from './provider-metadata.js'
 import { getToolMeta } from './tool-metadata.js'
 import { ensureProxyRunning, resolveProxyModelId } from './opencode.js'
+import { PROVIDER_METADATA } from './provider-metadata.js'
 
 function ensureDir(filePath) {
   const dir = dirname(filePath)
@@ -173,8 +182,10 @@ function writeCrushConfig(model, apiKey, baseUrl, providerId) {
   const filePath = join(homedir(), '.config', 'crush', 'crush.json')
   const backupPath = backupIfExists(filePath)
   const config = readJson(filePath, { $schema: 'https://charm.land/crush.json' })
-  if (!config.options || typeof config.options !== 'object') config.options = {}
-  config.options.disable_default_providers = true
+  // 📖 Remove legacy disable_default_providers — it can prevent Crush from auto-selecting models
+  if (config.options && config.options.disable_default_providers) {
+    delete config.options.disable_default_providers
+  }
   if (!config.providers || typeof config.providers !== 'object') config.providers = {}
   config.providers[providerId] = {
     name: 'Free Coding Models',
@@ -189,10 +200,11 @@ function writeCrushConfig(model, apiKey, baseUrl, providerId) {
     ],
   }
   // 📖 Crush expects structured selected models at config.models.{large,small}.
-  // 📖 Root `crush` reads these defaults in interactive mode, unlike `crush run --model`.
+  // 📖 Setting both large AND small ensures Crush auto-selects the model in interactive mode.
   config.models = {
     ...(config.models && typeof config.models === 'object' ? config.models : {}),
     large: { model: model.modelId, provider: providerId },
+    small: { model: model.modelId, provider: providerId },
   }
   writeJson(filePath, config)
   return { filePath, backupPath }
@@ -252,6 +264,73 @@ function writePiConfig(model, apiKey, baseUrl) {
   return { filePath: modelsFilePath, backupPath: modelsBackupPath, settingsFilePath, settingsBackupPath }
 }
 
+// 📖 writeGooseConfig: Install/update the provider in Goose's custom_providers/, set the
+// 📖 API key in secrets.yaml, and update config.yaml with GOOSE_PROVIDER + GOOSE_MODEL
+// 📖 so Goose auto-selects the model on launch.
+function writeGooseConfig(model, apiKey, baseUrl, providerKey) {
+  const home = homedir()
+  const providerId = `fcm-${providerKey}`
+  const providerLabel = PROVIDER_METADATA[providerKey]?.label || sources[providerKey]?.name || providerKey
+  const secretEnvName = `FCM_${providerKey.toUpperCase().replace(/[^A-Z0-9]+/g, '_')}_API_KEY`
+
+  // 📖 Step 1: Write custom provider JSON (same format as endpoint-installer)
+  const providerDir = join(home, '.config', 'goose', 'custom_providers')
+  const providerFilePath = join(providerDir, `${providerId}.json`)
+  ensureDir(providerFilePath)
+  const providerConfig = {
+    name: providerId,
+    engine: 'openai',
+    display_name: `FCM ${providerLabel}`,
+    description: `Managed by free-coding-models for ${providerLabel}`,
+    api_key_env: secretEnvName,
+    base_url: baseUrl?.endsWith('/chat/completions') ? baseUrl : (baseUrl || ''),
+    models: [{ name: model.modelId, context_limit: 128000 }],
+    supports_streaming: true,
+    requires_auth: true,
+  }
+  writeFileSync(providerFilePath, JSON.stringify(providerConfig, null, 2) + '\n')
+
+  // 📖 Step 2: Write API key to secrets.yaml (simple key: value format)
+  const secretsPath = join(home, '.config', 'goose', 'secrets.yaml')
+  let secretsContent = ''
+  if (existsSync(secretsPath)) {
+    secretsContent = readFileSync(secretsPath, 'utf8')
+  }
+  // 📖 Replace existing secret or append new one
+  const secretLine = `${secretEnvName}: ${JSON.stringify(apiKey)}`
+  const secretRegex = new RegExp(`^${secretEnvName}:.*$`, 'm')
+  if (secretRegex.test(secretsContent)) {
+    secretsContent = secretsContent.replace(secretRegex, secretLine)
+  } else {
+    secretsContent = secretsContent.trimEnd() + '\n' + secretLine + '\n'
+  }
+  ensureDir(secretsPath)
+  writeFileSync(secretsPath, secretsContent)
+
+  // 📖 Step 3: Update config.yaml — set GOOSE_PROVIDER and GOOSE_MODEL at top level
+  const configPath = join(home, '.config', 'goose', 'config.yaml')
+  let configContent = ''
+  if (existsSync(configPath)) {
+    configContent = readFileSync(configPath, 'utf8')
+  }
+  // 📖 Replace or add GOOSE_PROVIDER line
+  if (/^GOOSE_PROVIDER:.*/m.test(configContent)) {
+    configContent = configContent.replace(/^GOOSE_PROVIDER:.*/m, `GOOSE_PROVIDER: ${providerId}`)
+  } else {
+    configContent = `GOOSE_PROVIDER: ${providerId}\n` + configContent
+  }
+  // 📖 Replace or add GOOSE_MODEL line
+  if (/^GOOSE_MODEL:.*/m.test(configContent)) {
+    configContent = configContent.replace(/^GOOSE_MODEL:.*/m, `GOOSE_MODEL: ${model.modelId}`)
+  } else {
+    // 📖 Insert after GOOSE_PROVIDER line
+    configContent = configContent.replace(/^(GOOSE_PROVIDER:.*)/m, `$1\nGOOSE_MODEL: ${model.modelId}`)
+  }
+  writeFileSync(configPath, configContent)
+
+  return { providerFilePath, secretsPath, configPath }
+}
+
 function writeAmpConfig(model, baseUrl) {
   const filePath = join(homedir(), '.config', 'amp', 'settings.json')
   const backupPath = backupIfExists(filePath)
@@ -315,40 +394,80 @@ export async function startExternalTool(mode, model, config) {
   }
 
   if (mode === 'goose') {
-    let gooseBaseUrl = baseUrl
+    let gooseBaseUrl = sources[model.providerKey]?.url || baseUrl || ''
     let gooseApiKey = apiKey
     let gooseModelId = resolveLauncherModelId(model, false)
+    let gooseProviderKey = model.providerKey
 
     if (proxySettings.enabled) {
       const started = await ensureProxyRunning(config)
       gooseApiKey = started.proxyToken
-      gooseBaseUrl = `http://127.0.0.1:${started.port}/v1`
+      gooseBaseUrl = `http://127.0.0.1:${started.port}/v1/chat/completions`
       gooseModelId = resolveLauncherModelId(model, true)
-      applyOpenAiCompatEnv(env, gooseApiKey, gooseBaseUrl, gooseModelId)
+      gooseProviderKey = 'proxy'
       console.log(chalk.dim(`  📖 Goose will use the local FCM proxy on :${started.port} for this launch.`))
     }
 
-    env.OPENAI_HOST = gooseBaseUrl
-    env.OPENAI_BASE_PATH = 'v1/chat/completions'
-    env.OPENAI_MODEL = gooseModelId
-    console.log(chalk.dim(`  📖 Goose uses env-based OpenAI-compatible configuration for ${proxySettings.enabled ? 'the proxy' : 'this provider'} launch.`))
+    // 📖 Write Goose config: custom provider JSON + secrets.yaml + config.yaml (GOOSE_PROVIDER/GOOSE_MODEL)
+    const gooseResult = writeGooseConfig({ ...model, modelId: gooseModelId }, gooseApiKey, gooseBaseUrl, gooseProviderKey)
+    console.log(chalk.dim(`  📄 Goose config updated: ${gooseResult.configPath}`))
+    console.log(chalk.dim(`  📄 Provider installed: ${gooseResult.providerFilePath}`))
+
+    // 📖 Also set env vars as belt-and-suspenders
+    env.GOOSE_PROVIDER = `fcm-${gooseProviderKey}`
+    env.GOOSE_MODEL = gooseModelId
+    applyOpenAiCompatEnv(env, gooseApiKey, gooseBaseUrl.replace(/\/chat\/completions$/, ''), gooseModelId)
     return spawnCommand('goose', [], env)
   }
 
+  // 📖 Claude Code, Codex, and Gemini require the FCM Proxy V2 background service.
+  // 📖 Without it, these tools cannot connect to the free providers (protocol mismatch / no direct support).
+  if (mode === 'claude-code' || mode === 'codex' || mode === 'gemini') {
+    if (!proxySettings.enabled) {
+      console.log()
+      console.log(chalk.red(`  ✖ ${meta.label} requires FCM Proxy V2 to work with free providers.`))
+      console.log()
+      console.log(chalk.yellow('  The proxy translates between provider protocols and handles key rotation,'))
+      console.log(chalk.yellow('  which is required for this tool to connect.'))
+      console.log()
+      console.log(chalk.white('  To enable it:'))
+      console.log(chalk.dim('    1. Press ') + chalk.bold.white('J') + chalk.dim(' to open FCM Proxy V2 settings'))
+      console.log(chalk.dim('    2. Enable ') + chalk.bold.white('Proxy mode') + chalk.dim(' and install the ') + chalk.bold.white('background service'))
+      console.log(chalk.dim('    3. Come back and select your model again'))
+      console.log()
+      return 1
+    }
+  }
+
   if (mode === 'claude-code') {
-    console.log(chalk.yellow('  ⚠ Claude Code expects an Anthropic/Bedrock/Vertex-compatible gateway.'))
-    console.log(chalk.dim('  This launch passes proxy env vars, but your endpoint must support Claude Code wire semantics.'))
-    return spawnCommand('claude', ['--model', model.modelId], env)
+    // 📖 Claude Code needs Anthropic-compatible wire format (POST /v1/messages).
+    // 📖 The FCM proxy natively translates Anthropic ↔ OpenAI.
+    const started = await ensureProxyRunning(config)
+    const proxyBase = `http://127.0.0.1:${started.port}`
+    env.ANTHROPIC_BASE_URL = proxyBase
+    env.ANTHROPIC_API_KEY = started.proxyToken
+    const launchModelId = resolveLauncherModelId(model, true)
+    console.log(chalk.dim(`  📖 Claude Code routed through FCM proxy on :${started.port} (Anthropic translation enabled)`))
+    return spawnCommand('claude', ['--model', launchModelId], env)
   }
 
   if (mode === 'codex') {
-    console.log(chalk.dim('  📖 Codex CLI is launched with proxy env vars for this session.'))
-    return spawnCommand('codex', ['--model', model.modelId], env)
+    const started = await ensureProxyRunning(config)
+    env.OPENAI_API_KEY = started.proxyToken
+    env.OPENAI_BASE_URL = `http://127.0.0.1:${started.port}/v1`
+    const launchModelId = resolveLauncherModelId(model, true)
+    console.log(chalk.dim(`  📖 Codex routed through FCM proxy on :${started.port}`))
+    return spawnCommand('codex', ['--model', launchModelId], env)
   }
 
   if (mode === 'gemini') {
-    printConfigResult(meta.label, writeGeminiConfig(model))
-    return spawnCommand('gemini', ['--model', model.modelId], env)
+    const started = await ensureProxyRunning(config)
+    env.OPENAI_API_KEY = started.proxyToken
+    env.OPENAI_BASE_URL = `http://127.0.0.1:${started.port}/v1`
+    const launchModelId = resolveLauncherModelId(model, true)
+    printConfigResult(meta.label, writeGeminiConfig({ ...model, modelId: launchModelId }))
+    console.log(chalk.dim(`  📖 Gemini routed through FCM proxy on :${started.port}`))
+    return spawnCommand('gemini', ['--model', launchModelId], env)
   }
 
   if (mode === 'qwen') {
@@ -375,7 +494,8 @@ export async function startExternalTool(mode, model, config) {
     const piResult = writePiConfig(model, apiKey, baseUrl)
     printConfigResult(meta.label, { filePath: piResult.filePath, backupPath: piResult.backupPath })
     printConfigResult(meta.label, { filePath: piResult.settingsFilePath, backupPath: piResult.settingsBackupPath })
-    return spawnCommand('pi', [], env)
+    // 📖 Pi supports --provider and --model flags for guaranteed auto-selection
+    return spawnCommand('pi', ['--provider', 'freeCodingModels', '--model', model.modelId, '--api-key', apiKey], env)
   }
 
   console.log(chalk.red(`  X Unsupported external tool mode: ${mode}`))

package/src/tool-metadata.js

@@ -29,13 +29,13 @@ export const TOOL_METADATA = {
   crush: { label: 'Crush', emoji: '💘', flag: '--crush' },
   goose: { label: 'Goose', emoji: '🪿', flag: '--goose' },
   pi: { label: 'Pi', emoji: 'π', flag: '--pi' },
-  // aider: { label: 'Aider', emoji: '🛠', flag: '--aider' },
-  // 'claude-code': { label: 'Claude Code', emoji: '🧠', flag: '--claude-code' },
-  // codex: { label: 'Codex CLI', emoji: '⌘', flag: '--codex' },
-  // gemini: { label: 'Gemini CLI', emoji: '✦', flag: '--gemini' },
-  // qwen: { label: 'Qwen Code', emoji: '🌊', flag: '--qwen' },
-  // openhands: { label: 'OpenHands', emoji: '🤲', flag: '--openhands' },
-  // amp: { label: 'Amp', emoji: '⚡', flag: '--amp' },
+  aider: { label: 'Aider', emoji: '🛠', flag: '--aider' },
+  'claude-code': { label: 'Claude Code', emoji: '🧠', flag: '--claude-code' },
+  codex: { label: 'Codex CLI', emoji: '⌘', flag: '--codex' },
+  gemini: { label: 'Gemini CLI', emoji: '✦', flag: '--gemini' },
+  qwen: { label: 'Qwen Code', emoji: '🌊', flag: '--qwen' },
+  openhands: { label: 'OpenHands', emoji: '🤲', flag: '--openhands' },
+  amp: { label: 'Amp', emoji: '⚡', flag: '--amp' },
 }
 
 export const TOOL_MODE_ORDER = [
@@ -45,13 +45,13 @@ export const TOOL_MODE_ORDER = [
   'crush',
   'goose',
   'pi',
-  // 'aider',
-  // 'claude-code',
-  // 'codex',
-  // 'gemini',
-  // 'qwen',
-  // 'openhands',
-  // 'amp',
+  'aider',
+  'claude-code',
+  'codex',
+  'gemini',
+  'qwen',
+  'openhands',
+  'amp',
 ]
 
 export function getToolMeta(mode) {