free-coding-models 0.5.94 → 0.5.96

package/src/core/opencode.js

@@ -165,6 +165,11 @@ async function createZaiProxy(apiKey) {
 // ─── Shared OpenCode spawn helper ─────────────────────────────────────────────
 
 // 📖 spawnOpenCode: Resolve API keys + spawn opencode CLI with correct env.
+// 📖 Never pass --model on the command line: opencode v2 rejects flags its
+// 📖 entry points don't know ("Unrecognized flag: --model", issue #194) and
+// 📖 `opencode web` never accepted it. Every caller writes `config.model`
+// 📖 into opencode.json first, so a bare launch picks the right model on
+// 📖 both v1 and v2.
 async function spawnOpenCode(args, providerKey, fcmConfig, existingZaiProxy = null) {
   const envVarName = ENV_VAR_NAMES[providerKey]
   const resolvedKey = getApiKey(fcmConfig, providerKey)
@@ -295,7 +300,7 @@ export async function startOpenCode(model, fcmConfig) {
     console.log(chalk.dim('  Starting OpenCode...'))
     console.log()
 
-    await spawnOpenCode(['--model', modelRef], providerKey, fcmConfig)
+    await spawnOpenCode([], providerKey, fcmConfig)
     return
   }
 
@@ -359,7 +364,7 @@ export async function startOpenCode(model, fcmConfig) {
     console.log(chalk.dim('  Starting OpenCode...'))
     console.log()
 
-    await spawnOpenCode(['--model', modelRef], providerKey, fcmConfig, zaiProxyServer)
+    await spawnOpenCode([], providerKey, fcmConfig, zaiProxyServer)
     return
   }
 
@@ -394,7 +399,7 @@ export async function startOpenCode(model, fcmConfig) {
     }
     console.log()
 
-    await spawnOpenCode(['--model', zenModelRef], providerKey, fcmConfig)
+    await spawnOpenCode([], providerKey, fcmConfig)
     return
   }
 
@@ -584,7 +589,7 @@ export async function startOpenCode(model, fcmConfig) {
   console.log(chalk.dim('  Starting OpenCode...'))
   console.log()
 
-  await spawnOpenCode(['--model', modelRef], providerKey, fcmConfig)
+  await spawnOpenCode([], providerKey, fcmConfig)
 }
 
 // ─── Start OpenCode Web ───────────────────────────────────────────────────────
@@ -640,7 +645,9 @@ export async function startOpenCodeWeb(model, fcmConfig) {
   console.log(chalk.dim('  Starting OpenCode Web...'))
   console.log()
 
-  await spawnOpenCode(['web', '--model', modelRef], providerKey, fcmConfig)
+  // 📖 `opencode web` accepts no --model flag; the default written in
+  // 📖 opencode.json above is what the web UI starts with.
+  await spawnOpenCode(['web'], providerKey, fcmConfig)
 }
 
 // ─── Start OpenCode Desktop ───────────────────────────────────────────────────
@@ -672,9 +679,9 @@ export async function startOpenCodeDesktop(model, fcmConfig) {
         execFile(cmd, args, (err) => resolve(!err))
       })
       const launched =
-        (await tryExecFile('opencode-desktop', ['--model', modelRef])) ||
-        (await tryExecFile('flatpak', ['run', 'ai.opencode.OpenCode', '--model', modelRef])) ||
-        (await tryExecFile('snap', ['run', 'opencode', '--model', modelRef])) ||
+        (await tryExecFile('opencode-desktop', [])) ||
+        (await tryExecFile('flatpak', ['run', 'ai.opencode.OpenCode'])) ||
+        (await tryExecFile('snap', ['run', 'opencode'])) ||
         (await tryExecFile('xdg-open', ['/usr/share/applications/opencode.desktop']))
       if (!launched) printDesktopLaunchError()
       return

package/src/core/ping.js

@@ -200,6 +200,30 @@ async function isDisabledThinkingRejected(resp, req) {
   }
 }
 
+// 📖 Pollinations paid-wall sniffing (issue #190): models that left the free
+// 📖 tier answer HTTP 200 with the error embedded in the completion content
+// ("The account behind this API key doesn't have enough credits. This model
+// needs paid Pollen..."). Status codes alone mark them healthy, so sniff the
+// body and surface 402 (Payment Required) instead. Scoped to pollinations to
+// avoid false positives on other providers.
+const POLLINATIONS_PAID_WALL_MARKERS = [
+  // 📖 Apostrophe-free fragments: the API may return straight ' or typographic ’
+  'have enough credits',
+  'needs paid pollen',
+]
+
+async function isPollinationsPaidWall(resp) {
+  try {
+    const body = await resp.clone().json()
+    const content = body?.choices?.[0]?.message?.content
+    if (typeof content !== 'string') return false
+    const lower = content.toLowerCase()
+    return POLLINATIONS_PAID_WALL_MARKERS.some((marker) => lower.includes(marker))
+  } catch {
+    return false
+  }
+}
+
 // 📖 ping: Send a single chat completion request to measure model availability and latency.
 // 📖 providerKey and url determine provider-specific request format.
 // 📖 apiKey can be null — in that case no Authorization header is sent.
@@ -234,7 +258,13 @@ export async function ping(apiKey, modelId, providerKey, url) {
       if (retryMs > 0) pauseProviderQuota(providerKey, retryMs)
     }
     // 📖 Normalize all HTTP 2xx statuses to "200" so existing verdict/avg logic still works.
-    const code = resp.status >= 200 && resp.status < 300 ? '200' : String(resp.status)
+    let code = resp.status >= 200 && resp.status < 300 ? '200' : String(resp.status)
+    // 📖 Pollinations paid-wall (issue #190): a 200 whose completion content is
+    // 📖 the credits error means the model is NOT usable on a free key. Report
+    // 📖 402 so rows show a failure instead of a fake-healthy green.
+    if (code === '200' && providerKey === 'pollinations' && (await isPollinationsPaidWall(resp))) {
+      code = '402'
+    }
     // 📖 Passive quota tracker (t2): parse the response headers via the shared module.
     // 📖 1) Write to the passive snapshot map so /stats + TUI footer see live quota.
     // 📖 2) Return the percent number for the per-call consumer below.

package/src/core/playground.js

@@ -21,10 +21,11 @@
  * @see ../tui/overlays.js — overlay factory that mounts this renderer
  */
 
-import { displayWidth, sliceOverlayLines, tintOverlayLines } from '../tui/render-helpers.js'
+import { displayWidth, sliceOverlayLines, tintOverlayLines, truncateAnsiWidth } from '../tui/render-helpers.js'
 import { ROUTER_PORT_PATH, getRouterPortPath } from './router-daemon.js'
 import { existsSync, readFileSync } from 'node:fs'
 import { themeColors } from '../tui/theme.js'
+import { t } from './i18n/index.js'
 
 // 📖 Width budget for the wrapped input + transcript columns inside the
 // 📖 overlay. Slightly tighter than the full terminal so borders have room
@@ -162,7 +163,7 @@ export async function playgroundSubmit(state, deps = {}) {
 
   const port = await readDaemonPort()
   if (!port) {
-    PLAYGROUND_OVERLAY_STATE.lastError = 'Router is not running. Press R or run `free-coding-models --daemon-bg`.'
+    PLAYGROUND_OVERLAY_STATE.lastError = t('playground.routerStartError')
     return
   }
 
@@ -173,7 +174,7 @@ export async function playgroundSubmit(state, deps = {}) {
   PLAYGROUND_OVERLAY_STATE.cursor = 0
   PLAYGROUND_OVERLAY_STATE.busy = true
   PLAYGROUND_OVERLAY_STATE.lastError = null
-  PLAYGROUND_OVERLAY_STATE.statusMessage = 'Sending…'
+  PLAYGROUND_OVERLAY_STATE.statusMessage = t('playground.sending')
 
   const controller = new AbortController()
   PLAYGROUND_OVERLAY_STATE.abortController = controller
@@ -403,22 +404,22 @@ export function renderPlayground(state, terminalRows, terminalCols) {
   const innerWidth = Math.max(40, terminalCols - 8)
 
   // 📖 Header
-  lines.push(themeColors.accentBold('  💬 Playground — chat with the FCM router'))
-  lines.push(themeColors.dim('  Press Enter to send · Shift+Tab cycles model · Ctrl+S toggles streaming · Esc closes · Ctrl+L clears'))
+  lines.push(themeColors.accentBold(`  💬 ${t('playground.title')} — ${t('playground.chatViaRouter')}`))
+  lines.push(themeColors.dim(`  ${t('playground.tuiHotkeys')}`))
   lines.push('')
 
   // 📖 Persona pill (one liner preview of the pre-prompt)
   const pre = PLAYGROUND_OVERLAY_STATE.prePrompt
   if (pre && pre.enabled && pre.text) {
-    const preview = pre.text.length > innerWidth - 16 ? `${pre.text.slice(0, innerWidth - 19)}…` : pre.text
-    lines.push(themeColors.dim(`  Persona: ${preview.replace(/\n+/g, ' ')}`))
+    const preview = displayWidth(pre.text) > innerWidth - 16 ? truncateAnsiWidth(pre.text.replace(/\n+/g, ' '), innerWidth - 16, { ellipsis: '…' }) : pre.text.replace(/\n+/g, ' ')
+    lines.push(themeColors.dim(`  ${t('playground.persona')}: ${preview}`))
   } else {
-    lines.push(themeColors.dim('  Persona: (none)'))
+    lines.push(themeColors.dim(`  ${t('playground.persona')}: ${t('common.none')}`))
   }
 
   // 📖 Model + mode row
-  const mode = PLAYGROUND_OVERLAY_STATE.streamOn ? 'streaming' : 'one-shot'
-  lines.push(themeColors.dim(`  Model: ${PLAYGROUND_OVERLAY_STATE.model} · ${mode}`))
+  const mode = PLAYGROUND_OVERLAY_STATE.streamOn ? t('playground.streamOn') : t('playground.streamOff')
+  lines.push(themeColors.dim(`  ${t('playground.model')}: ${PLAYGROUND_OVERLAY_STATE.model} · ${mode}`))
   if (PLAYGROUND_OVERLAY_STATE.lastError) {
     lines.push(themeColors.errorBold(`  ⚠ ${PLAYGROUND_OVERLAY_STATE.lastError}`))
   }
@@ -428,7 +429,7 @@ export function renderPlayground(state, terminalRows, terminalCols) {
   const transcriptLines = []
   for (const msg of PLAYGROUND_OVERLAY_STATE.messages) {
     const role = msg.role === 'user'
-      ? themeColors.accentBold('  ❯ you')
+      ? themeColors.accentBold(`  ❯ ${t('playground.you')}`)
       : msg.role === 'assistant'
         ? themeColors.dim('  ✦ fcm')
         : themeColors.dim(`  · ${msg.role}`)
@@ -439,18 +440,18 @@ export function renderPlayground(state, terminalRows, terminalCols) {
     }
     if (msg.role === 'assistant' && msg.meta) {
       const metaChips = []
-      if (msg.meta.provider) metaChips.push(`routed ${msg.meta.provider}/${msg.meta.model || '?'}`)
+      if (msg.meta.provider) metaChips.push(`${t('playground.routed')} ${msg.meta.provider}/${msg.meta.model || '?'}`)
       if (msg.meta.latencyMs != null) metaChips.push(`${msg.meta.latencyMs}ms`)
-      if (msg.meta.tokens) metaChips.push(`${msg.meta.tokens} tok`)
-      if (msg.meta.fallbackAttempts) metaChips.push(`${msg.meta.fallbackAttempts} fallback`)
+      if (msg.meta.tokens) metaChips.push(`${msg.meta.tokens} ${t('playground.tokensShort')}`)
+      if (msg.meta.fallbackAttempts) metaChips.push(`${msg.meta.fallbackAttempts} ${t('playground.fallbackShort')}`)
       if (metaChips.length) {
         transcriptLines.push(themeColors.dim(`    [ ${metaChips.join(' · ')} ]`))
       }
       if (msg.meta.aborted) {
-        transcriptLines.push(themeColors.dim('    [ stopped ]'))
+        transcriptLines.push(themeColors.dim(`    [ ${t('playground.stopped')} ]`))
       }
       if (msg.meta.error) {
-        transcriptLines.push(themeColors.error(`    [ error: ${msg.meta.error} ]`))
+        transcriptLines.push(themeColors.error(`    [ ${t('common.error')}: ${msg.meta.error} ]`))
       }
     }
     transcriptLines.push('')
@@ -465,16 +466,16 @@ export function renderPlayground(state, terminalRows, terminalCols) {
   // 📖 Input box
   lines.push(themeColors.dim('  ─'.repeat(Math.max(8, Math.floor(innerWidth / 4)))))
   if (PLAYGROUND_OVERLAY_STATE.busy) {
-    lines.push(themeColors.accent('  ⏳ waiting for response — Esc to stop'))
+    lines.push(themeColors.accent(`  ⏳ ${t('playground.waitingResponse')}`))
   } else {
-    const draft = PLAYGROUND_OVERLAY_STATE.draft || 'Type your message and press Enter…'
+    const draft = PLAYGROUND_OVERLAY_STATE.draft || t('playground.draftPlaceholder')
     const draftDisplay = PLAYGROUND_OVERLAY_STATE.draft ? draft : themeColors.dim(draft)
     const wrappedDraft = wrapMessage(draftDisplay, innerWidth - 4)
     for (const line of wrappedDraft) {
       lines.push(`  ❯ ${line}`)
     }
     if (!PLAYGROUND_OVERLAY_STATE.draft) {
-      lines.push(themeColors.dim('  (Enter to send · Shift+Tab for a pinned model)'))
+      lines.push(themeColors.dim(`  (${t('playground.enterToSend')} · Shift+Tab ${t('playground.pinModel')})`))
     }
   }
 

package/src/core/provider-key-tester.js

@@ -70,6 +70,7 @@ export const PROVIDER_AUTH_ENDPOINTS = {
   requesty:     null,
   orcarouter:   { url: 'https://api.orcarouter.ai/v1/models',   method: 'GET' },
   'vercel-gateway': { url: 'https://ai-gateway.vercel.sh/v1/models', method: 'GET' },
+  onomeo:       { url: 'https://onomeo.com/v1/models',          method: 'GET' },
   together:     { url: 'https://api.together.xyz/v1/models',        method: 'GET' },
   perplexity:   { url: 'https://api.perplexity.ai/v1/models',       method: 'GET' },
   chutes:       { url: 'https://chutes.ai/v1/models',               method: 'GET' },

package/src/core/provider-metadata.js

@@ -67,6 +67,7 @@ export const ENV_VAR_NAMES = {
   requesty:   'REQUESTY_API_KEY',
   orcarouter: 'ORCAROUTER_API_KEY',
   'vercel-gateway': 'VERCEL_AI_GATEWAY_API_KEY',
+  onomeo:     'ONOMEO_API_KEY',
   // 📖 Providers whose OpenCode/Kilo config writers reference {env:VAR} - names
   // 📖 must match those tables exactly (see opencode.js / kilo.js).
   huggingface: 'HUGGINGFACE_API_KEY',
@@ -358,6 +359,14 @@ export const PROVIDER_METADATA = {
     rateLimits: 'Free tier · $5 credits/30 days + $0 models',
     detailedLimits: 'Official Vercel gateway at list prices, zero markup.\nEvery account gets $5 of credits every 30 days, no card required.\nThe monthly credit covers a subset of the catalog; the explicit $0 models stay free.\nCaution: purchasing credits once permanently moves the account to the paid tier and the monthly free credit stops.',
   },
+  onomeo: {
+    label: 'onomeo',
+    color: chalk.rgb(240, 120, 60),
+    signupUrl: 'https://onomeo.com/dashboard',
+    signupHint: 'Sign in (email, Google or GitHub, no card) → check in daily → Dashboard → API key',
+    rateLimits: 'Daily check-in credits (50,000-200,000/day) · 12 req/min per key · 60 req/5h per account',
+    detailedLimits: 'Public beta: not every feature is guaranteed to work; feedback is welcome at https://onomeo.com/feedback.\nCredits come from a daily check-in: 50,000 on day 1, rising to 200,000/day from day 7 of a streak. No card needed.\nEvery call spends credits and the cost per reply varies by model (see https://onomeo.com/models), so this is a small allowance. Each account that has not paid can spend up to 50,000 credits/day on premium models. Optional: $5 one-time buys 1,000,000 credits.\nLimits: 12 req/min per key, 60 req per 5 hours per account, 120 per 5 hours per IP, 450 per 5 hours site-wide for accounts that have not bought credits. Health probes count against them.\nSome upstreams may train on prompts; each model page on onomeo.com says which.',
+  },
   'ollama-cloud': {
     label: 'Ollama Cloud',
     color: chalk.rgb(230, 230, 230),

package/src/core/quota-capabilities.js

@@ -67,6 +67,8 @@ export const PROVIDER_CAPABILITIES = {
   orcarouter: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'unknown' },
   // 📖 Vercel AI Gateway exposes GET /v1/credits but no fetcher is wired yet; treat as monthly reset.
   'vercel-gateway': { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'monthly' },
+  // 📖 onomeo: daily check-in credits; balance is at GET /api/me but no fetcher is wired yet.
+  onomeo: { telemetryType: 'unknown', supportsEndpoint: false, usageDisplay: 'ok', resetCadence: 'daily' },
 }
 
 /** Fallback for unrecognized providers */

package/src/core/router-daemon.js

@@ -55,6 +55,8 @@ import { TIER_ORDER } from './utils.js'
 import { atomicWriteJson, safeJsonParse, sleep, maskApiKey, isRouteableProvider } from './shared-helpers.js'
 import { normalizeRequestBody } from './schema-normalizer.js'
 import { pickNextCandidate } from './model-family.js'
+// 📖 Shared install-target list (same order the TUI Z-cycle and web/server.js use)
+import { getInstallTargetModes } from './endpoint-installer.js'
 import {
   loadCache as loadProbeCache,
   flushCache as flushProbeCache,
@@ -3686,12 +3688,41 @@ export class RouterRuntime {
         sendJson(res, 200, getWebModelsPayload(this), { 'x-request-id': requestId })
         return
       }
-      // 📖 Stub endpoints for the web dashboard's hooks (useToolMode, useFavorites,
-      // 📖 useUpdateChecker). These were 404 before - minimal shapes that match
-      // 📖 what the dashboard hooks expect. See PR #108 for context.
-      if (req.method === 'GET' && (url.pathname === '/api/tool-mode')) {
-        sendJson(res, 200, { mode: 'opencode', tools: ['opencode', 'openclaw', 'opencode-desktop', 'opencode-web'] }, { 'x-request-id': requestId })
-        return
+      // 📖 Web dashboard hooks (useToolMode, useFavorites, useUpdateChecker).
+      // These were 404 before - minimal shapes that match what the dashboard
+      // hooks expect. See PR #108 for context.
+      // 📖 /api/tool-mode must handle POST too: useUrlState re-persists
+      // `?toolMode=` from the URL on load, and a POST falling through to the
+      // OpenAI-style 404 catch-all showed "[object Object]" toasts (issue #189).
+      if (url.pathname === '/api/tool-mode') {
+        const webToolModes = getInstallTargetModes()
+        const normalizeToolMode = (m) => (typeof m === 'string' && webToolModes.includes(m) ? m : 'opencode')
+        if (req.method === 'GET') {
+          sendJson(res, 200, { mode: normalizeToolMode(this.config?.settings?.preferredToolMode), tools: webToolModes }, { 'x-request-id': requestId })
+          return
+        }
+        if (req.method === 'POST') {
+          if (!isSameOriginOrLocal(req)) {
+            sendError(res, 403, 'Forbidden cross-origin request', 'invalid_request_error', 'forbidden_origin', requestId)
+            return
+          }
+          const body = await readJsonBody(req)
+          if (!body || typeof body.mode !== 'string' || !webToolModes.includes(body.mode)) {
+            sendError(res, 422, 'Invalid tool mode', 'invalid_request_error', 'invalid_tool_mode', requestId)
+            return
+          }
+          const mode = normalizeToolMode(body.mode)
+          if (!this.config || typeof this.config !== 'object') this.config = {}
+          if (!this.config.settings || typeof this.config.settings !== 'object') this.config.settings = {}
+          this.config.settings.preferredToolMode = mode
+          const saveResult = this.saveRouterConfig()
+          if (!saveResult?.success) {
+            sendError(res, 500, saveResult?.error || 'Failed to save tool mode', 'api_error', 'save_failed', requestId)
+            return
+          }
+          sendJson(res, 200, { mode }, { 'x-request-id': requestId })
+          return
+        }
       }
       if (req.method === 'GET' && (url.pathname === '/api/favorites')) {
         const cfg = this.config || {}

package/src/core/router-dashboard.js

@@ -44,6 +44,7 @@ import chalk from 'chalk'
 import { existsSync, readFileSync } from 'node:fs'
 import { displayWidth, padEndDisplay, sliceOverlayLines, tintOverlayLines } from '../tui/render-helpers.js'
 import { ROUTER_DEFAULT_PORT, ROUTER_MAX_PORT, getRouterPidPath, getRouterPortPath, getRouterPortRange } from './router-daemon.js'
+import { t } from './i18n/index.js'
 import { themeColors, getTierRgb } from '../tui/theme.js'
 import { formatTokenTotalCompact } from './token-usage-reader.js'
 import { sendUsageTelemetry } from './telemetry.js'
@@ -871,12 +872,12 @@ export function renderRouterDashboard(state, deps = {}) {
   const { defaultPort: currentDefaultPort } = getRouterPortRange()
   const port = snapshot.port || state.routerDashboardPort || currentDefaultPort
   const baseUrl = `http://localhost:${port}/v1`
-  lines.push(`  ${themeColors.textBold('Quick Setup')} ${themeColors.dim('— paste into your coding tool config')}`)
+  lines.push(`  ${themeColors.textBold(t('router.quickSetup'))} ${themeColors.dim(`— ${t('router.pasteIntoToolConfig')}`)}`)
   lines.push(`  ${themeColors.dim('URL')}     ${themeColors.infoBold(baseUrl)}`)
-  lines.push(`  ${themeColors.dim('Model')}   ${themeColors.infoBold('fcm')}`)
+  lines.push(`  ${themeColors.dim(t('router.model'))}   ${themeColors.infoBold('fcm')}`)
   lines.push(`  ${themeColors.dim('API Key')} ${themeColors.infoBold('fcm-local')}`)
   if (isRunning) {
-    lines.push(`  ${themeColors.dim('Uptime')}  ${themeColors.success(formatRouterDuration(snapshot.uptimeSeconds))}  ${themeColors.dim('Requests routed:')} ${themeColors.info(String(snapshot.requestsRouted))}`)
+    lines.push(`  ${themeColors.dim(t('router.uptime'))}  ${themeColors.success(formatRouterDuration(snapshot.uptimeSeconds))}  ${themeColors.dim(`${t('router.requests')}:`)} ${themeColors.info(String(snapshot.requestsRouted))}`)
   } else {
     lines.push(`  ${themeColors.dim('Hint')}    ${themeColors.dim('Start the daemon to enable routing')}`)
   }
@@ -886,7 +887,7 @@ export function renderRouterDashboard(state, deps = {}) {
   // ── Favorites / Router Fallback Models ──────────────────────────────────────
   // 📖 Instead of the old "sets" system, show the user's favorites from the main
   // 📖 table as the router fallback chain. #1 = tried first, #2 = next, etc.
-  lines.push(`  ${themeColors.textBold('Router Models')} ${themeColors.dim('— your favorites, in fallback order')}`)
+  lines.push(`  ${themeColors.textBold(t('router.routerModels'))} ${themeColors.dim(`— ${t('router.favoritesFallbackOrder')}`)}`)
   lines.push(`  ${themeColors.dim('Star models with F in the main table. Shift+↑↓ to reorder here.')}`)
   lines.push('')
 
@@ -895,7 +896,7 @@ export function renderRouterDashboard(state, deps = {}) {
   const cursor = state.routerDashboardCursorIndex ?? 0
 
   if (favorites.length === 0) {
-    lines.push(`  ${themeColors.warning('No favorites yet. Press Esc, then F on any model to add it.')}`)
+    lines.push(`  ${themeColors.warning(t('router.noFavoritesTui'))}`)
     lines.push(`  ${themeColors.dim('Favorites become your router fallback chain — #1 is tried first.')}`)
   } else {
     // 📖 Priority keycap glyphs for the fallback order
@@ -1010,7 +1011,7 @@ export function renderRouterDashboard(state, deps = {}) {
   lines.push('')
   const btnCursor = favorites.length
   const isBtnCursor = cursor === btnCursor
-  const btnText = isStopped ? '▶ Start Router Daemon' : '⏹ Stop Router Daemon'
+  const btnText = isStopped ? `▶ ${t('router.start')}` : `⏹ ${t('router.stop')}`
   const btnRowText = `  [ ${btnText} ]`
   
   if (isBtnCursor) {
@@ -1022,7 +1023,7 @@ export function renderRouterDashboard(state, deps = {}) {
   // 📖 Install Endpoint Button
   const installBtnCursor = favorites.length + 1
   const isInstallBtnCursor = cursor === installBtnCursor
-  const installBtnText = '🔌 Install Router Endpoint to CLI Tool'
+  const installBtnText = `🔌 ${t('router.installEndpointCli')}`
   const installBtnRowText = `  [ ${installBtnText} ]`
   
   if (isInstallBtnCursor) {
@@ -1036,11 +1037,11 @@ export function renderRouterDashboard(state, deps = {}) {
   lines.push('')
 
   // ── Token Summary (compact, visual) ─────────────────────────────────────────
-  lines.push(`  ${themeColors.textBold('📊 Tokens')}  ${themeColors.dim('Today:')} ${themeColors.info(formatTokenTotalCompact(snapshot.tokens.today.total_tokens))} ${themeColors.dim(`(${snapshot.tokens.today.requests} req)`)}  ${themeColors.dim('Lifetime:')} ${themeColors.info(formatTokenTotalCompact(snapshot.tokens.all_time.total_tokens))} ${themeColors.dim(`(${snapshot.tokens.all_time.requests} req)`)}`)
+  lines.push(`  ${themeColors.textBold('📊 Token')}  ${themeColors.dim(`${t('analytics.today')}:`)} ${themeColors.info(formatTokenTotalCompact(snapshot.tokens.today.total_tokens))} ${themeColors.dim(t('analytics.requestsShort', { count: snapshot.tokens.today.requests }))}  ${themeColors.dim(`${t('router.lifetime')}:`)} ${themeColors.info(formatTokenTotalCompact(snapshot.tokens.all_time.total_tokens))} ${themeColors.dim(t('analytics.requestsShort', { count: snapshot.tokens.all_time.requests }))}`)
 
   // ── Active Requests ────────────────────────────────────────────────────────
   lines.push('')
-  lines.push(`  ${themeColors.warningBold('⚡ Active Requests')} ${themeColors.dim(`(${snapshot.activeRequests?.length || 0})`)}`)
+  lines.push(`  ${themeColors.warningBold(`⚡ ${t('router.activeRequests')}`)} ${themeColors.dim(`(${snapshot.activeRequests?.length || 0})`)}`)
   if (snapshot.activeRequests?.length > 0) {
     for (const req of snapshot.activeRequests) {
       const model = compactText(req.model, 24)
@@ -1052,15 +1053,15 @@ export function renderRouterDashboard(state, deps = {}) {
       lines.push(`  ${themeColors.dim('•')} ${shortId}${model} → ${themeColors.info(current)} ${status}${tokens} ${themeColors.dim(duration)}`)
     }
   } else {
-    lines.push(`  ${themeColors.dim('No active requests')}`)
+    lines.push(`  ${themeColors.dim(t('router.noActiveRequests'))}`)
   }
 
   // ── Live Request Log (compact) ──────────────────────────────────────────────
   const requestRows = requestLogRows(state, snapshot)
   lines.push('')
-  lines.push(`  ${themeColors.textBold('Recent Requests')}`)
+  lines.push(`  ${themeColors.textBold(t('router.recentRequests'))}`)
   if (requestRows.length > 0) {
-    const header = `  ${padEndDisplay('ID', 5)} ${padEndDisplay('Time', 10)} ${padEndDisplay('Model', 34)} ${padEndDisplay('Status', 8)} ${padEndDisplay('Latency', 9)} Detail`
+    const header = `  ${padEndDisplay('ID', 5)} ${padEndDisplay(t('router.time'), 10)} ${padEndDisplay(t('router.model'), 34)} ${padEndDisplay(t('router.state'), 8)} ${padEndDisplay(t('router.lastLatency'), 9)} ${t('router.detail')}`
     lines.push(themeColors.dim(header))
     for (const row of requestRows.slice(0, 6)) {
       const atMs = Date.parse(row.at)
@@ -1086,7 +1087,7 @@ export function renderRouterDashboard(state, deps = {}) {
       )
     }
   } else {
-    lines.push(`  ${themeColors.dim('No requests routed yet')}`)
+    lines.push(`  ${themeColors.dim(t('router.noRequests'))}`)
   }
 
   // ── Health check speed ──────────────────────────────────────────────────────
@@ -1111,7 +1112,7 @@ export function renderRouterDashboard(state, deps = {}) {
   // ── Footer ──────────────────────────────────────────────────────────────────
   lines.push('')
   lines.push(`  ${separator}`)
-  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim('Navigate')}  ${themeColors.dim('•')}  ${themeColors.hotkey('Shift+↑↓')} ${themeColors.dim('Reorder')}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? 'Start daemon' : 'Stop daemon')}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`Health check: ${probeLabel}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim('Clear log')}  ${themeColors.dim('•')}  ${themeColors.hotkey('R')} ${themeColors.dim('Sync best')}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim('Back')}`)
+  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim(t('settings.navigate'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('Shift+↑↓')} ${themeColors.dim(t('router.reorder'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? t('router.start') : t('router.stop'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`${t('router.healthCheck')}: ${probeLabel}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim(t('router.clearLog'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('R')} ${themeColors.dim(t('router.syncBest'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim(t('common.back'))}`)
 
   const { visible, offset } = sliceOverlayLines(lines, state.routerDashboardScrollOffset || 0, state.terminalRows || 24)
   state.routerDashboardScrollOffset = offset

package/src/core/router-v2/tui-dashboard.js

@@ -49,6 +49,7 @@ import { discoverRouterV2Port, testModelViaRouter, testSetViaRouter } from './be
 // 📖 After the merge, the v2 engine lives in the MAIN router daemon: all
 // discovery and lifecycle calls target the historical daemon paths/ports.
 import { getRouterPidPath, getRouterPortPath, getRouterPortRange } from '../router-daemon.js'
+import { t } from '../i18n/index.js'
 
 export const ROUTER_V2_DASHBOARD_POLL_INTERVAL_MS = 2000
 export const ROUTER_V2_DASHBOARD_FETCH_TIMEOUT_MS = 1500
@@ -429,15 +430,15 @@ function formatDurationV2(seconds) {
 
 function stateBadgeV2(modelState) {
   switch (modelState) {
-    case 'CLOSED': return { text: '✅ UP', color: themeColors.success }
-    case 'DEGRADED': return { text: '🟠 DEGRADED', color: themeColors.warningBold }
-    case 'HALF_OPEN': return { text: '🔁 PROBING', color: themeColors.warning }
-    case 'OPEN': return { text: '⛔ OPEN', color: themeColors.error }
-    case 'AUTH_ERROR': return { text: '🔐 AUTH FAIL', color: themeColors.errorBold }
-    case 'QUOTA_PAUSED': return { text: '🔥 QUOTA', color: themeColors.warningBold }
-    case 'STALE': return { text: '👻 STALE', color: themeColors.dim }
-    case 'UNSUPPORTED': return { text: '🚫 UNSUPPORTED', color: themeColors.dim }
-    default: return { text: '⏳ PENDING', color: themeColors.dim }
+    case 'CLOSED': return { text: `✅ ${t('dashboard.working').toUpperCase()}`, color: themeColors.success }
+    case 'DEGRADED': return { text: `🟠 ${t('router.circuit.degraded').toUpperCase()}`, color: themeColors.warningBold }
+    case 'HALF_OPEN': return { text: `🔁 ${t('router.circuit.probing').toUpperCase()}`, color: themeColors.warning }
+    case 'OPEN': return { text: `⛔ ${t('router.circuit.down').toUpperCase()}`, color: themeColors.error }
+    case 'AUTH_ERROR': return { text: `🔐 ${t('router.circuit.authError').toUpperCase()}`, color: themeColors.errorBold }
+    case 'QUOTA_PAUSED': return { text: `🔥 ${t('router.circuit.quotaPaused').toUpperCase()}`, color: themeColors.warningBold }
+    case 'STALE': return { text: `👻 ${t('router.circuit.deprecated').toUpperCase()}`, color: themeColors.dim }
+    case 'UNSUPPORTED': return { text: `🚫 ${t('router.circuit.unsupported').toUpperCase()}`, color: themeColors.dim }
+    default: return { text: `⏳ ${t('dashboard.pending').toUpperCase()}`, color: themeColors.dim }
   }
 }
 
@@ -489,17 +490,17 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   // ── Quick Setup ─────────────────────────────────────────────────────────────
   const { defaultPort } = getRouterPortRange()
   const port = state.routerV2Port || defaultPort
-  lines.push(`  ${themeColors.textBold('Quick Setup')} ${themeColors.dim('(beta)')} ${themeColors.dim('- point your coding tool at v2')}`)
+  lines.push(`  ${themeColors.textBold(t('router.quickSetup'))} ${themeColors.dim(`(${t('router.v2.beta')})`)} ${themeColors.dim(`— ${t('router.v2.pointToolAtV2')}`)}`)
   lines.push(`  ${themeColors.dim('URL')}     ${themeColors.infoBold(`http://localhost:${port}/v1`)}   ${themeColors.dim('Anthropic:')} ${themeColors.infoBold(`http://localhost:${port}`)}  ${themeColors.dim('(POST /v1/messages)')}`)
-  lines.push(`  ${themeColors.dim('Model')}   ${themeColors.infoBold('fcm')}  ${themeColors.dim('or pin one:')} ${themeColors.infoBold('fcm:@provider/model')}`)
+  lines.push(`  ${themeColors.dim(t('router.model'))}   ${themeColors.infoBold('fcm')}  ${themeColors.dim(t('router.v2.orPinOne'))} ${themeColors.infoBold('fcm:@provider/model')}`)
   lines.push(`  ${themeColors.dim('API Key')} ${themeColors.infoBold('fcm-local')}`)
   if (isRunning) {
-    lines.push(`  ${themeColors.dim('Uptime')}  ${themeColors.success(formatDurationV2(toFiniteNumber(stats?.uptimeSeconds, 0)))}  ${themeColors.dim('Routed:')} ${themeColors.info(String(toFiniteNumber(stats?.requestsRouted, 0)))}  ${themeColors.dim('Failover rate:')} ${themeColors.info(`${Math.round(toFiniteNumber(stats?.history?.failover_rate, 0) * 100)}%`)}`)
+    lines.push(`  ${themeColors.dim(t('router.uptime'))}  ${themeColors.success(formatDurationV2(toFiniteNumber(stats?.uptimeSeconds, 0)))}  ${themeColors.dim(`${t('router.requests')}:`)} ${themeColors.info(String(toFiniteNumber(stats?.requestsRouted, 0)))}  ${themeColors.dim(`${t('router.v2.failoverRate')}:`)} ${themeColors.info(`${Math.round(toFiniteNumber(stats?.history?.failover_rate, 0) * 100)}%`)}`)
   }
   lines.push(`  ${separator}`)
 
   // ── Fallback chain with live breaker states ─────────────────────────────────
-  lines.push(`  ${themeColors.textBold('Fallback Chain')} ${themeColors.dim('- routing order for the next request')}`)
+  lines.push(`  ${themeColors.textBold(t('router.v2.fallbackChain'))} ${themeColors.dim(`— ${t('router.v2.exactOrder')}`)}`)
   const routingOrder = Array.isArray(stats?.routingOrder) ? stats.routingOrder : []
   const models = Array.isArray(stats?.models) ? stats.models : []
   const healthByKey = new Map(models.map((m) => [m.key, m]))
@@ -507,11 +508,11 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   const cursor = state.routerV2CursorIndex ?? 0
 
   if (!isRunning) {
-    lines.push(`  ${themeColors.dim('Start the daemon to see the live chain.')}`)
+    lines.push(`  ${themeColors.dim(t('router.v2.startToSeeChain'))}`)
   } else if (routingOrder.length === 0) {
-    lines.push(`  ${themeColors.warning('No routeable candidates right now (keys missing or all models failing).')}`)
+    lines.push(`  ${themeColors.warning(t('router.v2.emptyCandidates'))}`)
   } else {
-    lines.push(`   ${themeColors.dim(padEndDisplay('PRI', 4))} ${themeColors.dim(padEndDisplay('MODEL', 44))} ${themeColors.dim(padEndDisplay('STATE', 15))} ${themeColors.dim(padEndDisplay('UPTIME', 7))} ${themeColors.dim(padEndDisplay('V2 TEST', 12))} ${themeColors.dim('LAST ERROR')}`)
+    lines.push(`   ${themeColors.dim(padEndDisplay('PRI', 4))} ${themeColors.dim(padEndDisplay(t('router.model'), 44))} ${themeColors.dim(padEndDisplay(t('router.state'), 15))} ${themeColors.dim(padEndDisplay(t('router.uptime'), 7))} ${themeColors.dim(padEndDisplay('V2 ' + t('router.v2.testViaRouter'), 12))} ${themeColors.dim(t('router.v2.lastError'))}`)
     const maxRows = Math.max(1, routingOrder.length)
     routingOrder.forEach((entry, i) => {
       const health = healthByKey.get(entry.key)
@@ -535,21 +536,21 @@ export function renderRouterV2Dashboard(state, deps = {}) {
 
   // ── Recent requests WITH fallback chains (the v1 gap) ───────────────────────
   lines.push('')
-  lines.push(`  ${themeColors.textBold('Request Chains')} ${themeColors.dim('- every attempt, skips and the winner')}`)
+  lines.push(`  ${themeColors.textBold(t('router.v2.requestChains'))} ${themeColors.dim(`— ${t('router.v2.attemptsHint')}`)}`)
   const historyEntries = Array.isArray(state.routerV2History?.entries) ? state.routerV2History.entries : []
   if (!isRunning) {
-    lines.push(`  ${themeColors.dim('No history (daemon stopped).')}`)
+    lines.push(`  ${themeColors.dim(t('router.v2.noHistory'))}`)
   } else if (historyEntries.length === 0) {
-    lines.push(`  ${themeColors.dim('No requests routed yet')}`)
+    lines.push(`  ${themeColors.dim(t('router.noRequests'))}`)
   } else {
     for (const entry of historyEntries.slice(0, 6)) {
       const atMs = Date.parse(entry.at)
       const time = Number.isFinite(atMs) ? new Date(atMs).toLocaleTimeString() : '-'
       const outcome = entry.outcome === 'served'
-        ? themeColors.success('served')
+        ? themeColors.success(t('router.v2.outcome.served'))
         : entry.outcome === 'client_aborted'
-          ? themeColors.dim('aborted')
-          : themeColors.error(entry.outcome || 'failed')
+          ? themeColors.dim(t('router.v2.outcome.aborted'))
+          : themeColors.error(t('router.v2.outcome.failed'))
       const chain = attemptChainLabel(entry)
       const skips = Array.isArray(entry.skipped) && entry.skipped.length > 0
         ? ` ${themeColors.dim(`[skips: ${entry.skipped.map((s) => s.reason).join(', ')}]`)}`
@@ -572,7 +573,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
       `🔐 auth ${stateCounts.AUTH_ERROR ?? 0}`,
       `🔥 quota ${stateCounts.QUOTA_PAUSED ?? 0}`,
     ]
-    lines.push(`  ${themeColors.textBold('Models:')} ${chips.map((c) => themeColors.dim(c)).join('  ')}`)
+    lines.push(`  ${themeColors.textBold(`${t('router.models')}:`)} ${chips.map((c) => themeColors.dim(c)).join('  ')}`)
     const pauses = Array.isArray(stats?.quotaPauses) ? stats.quotaPauses : []
     if (pauses.length > 0) {
       for (const pause of pauses.slice(0, 3)) {
@@ -592,7 +593,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   const isStopped = !isRunning && !isLoading
   const cursorBase = Math.max(1, routingOrder.length)
   const startBtnCursor = cursorBase
-  const startBtnText = isStopped ? '▶ Start Router Daemon (v2 engine)' : '⏹ Stop Router Daemon (v2 engine)'
+  const startBtnText = isStopped ? `▶ ${t('router.start')} (v2)` : `⏹ ${t('router.stop')} (v2)`
   const startBtnRow = `  [ ${startBtnText} ]`
   lines.push(cursor === startBtnCursor
     ? themeColors.bgCursor(startBtnRow + ' '.repeat(Math.max(0, width - displayWidth(startBtnRow) - 3)))
@@ -616,7 +617,7 @@ export function renderRouterV2Dashboard(state, deps = {}) {
   lines.push('')
   lines.push(`  ${separator}`)
   const probeMode = stats?.probeMode || 'balanced'
-  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim('Navigate')}  ${themeColors.dim('•')}  ${themeColors.hotkey('T')} ${themeColors.dim('Test via router')}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? 'Start' : 'Stop')}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`Probes: ${probeMode}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim('Clear history')}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim('Back')}`)
+  lines.push(`  ${themeColors.hotkey('↑↓')} ${themeColors.dim(t('settings.navigate'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('T')} ${themeColors.dim(t('router.v2.testViaRouter'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('S')} ${themeColors.dim(isStopped ? t('router.start') : t('router.stop'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('I')} ${themeColors.dim(`${t('router.v2.probes')}: ${probeMode}`)}  ${themeColors.dim('•')}  ${themeColors.hotkey('C')} ${themeColors.dim(t('router.clearHistory'))}  ${themeColors.dim('•')}  ${themeColors.hotkey('Esc')} ${themeColors.dim(t('common.back'))}`)
   lines.push(`  ${themeColors.dim('BETA: the v2 engine now powers the main router daemon. Ctrl+T tests the selected table model, Ctrl+Shift+T tests all visible models through the router.')}`)
 
   const { visible, offset } = sliceOverlayLines(lines, state.routerV2ScrollOffset || 0, state.terminalRows || 24)
@@ -628,5 +629,5 @@ export function renderRouterV2Dashboard(state, deps = {}) {
 function compactTextV2(value, width) {
   const text = String(value ?? '')
   if (displayWidth(text) <= width) return themeColors.dim(text)
-  return themeColors.dim(`${text.slice(0, Math.max(1, width - 1))}…`)
+  return themeColors.dim(truncateAnsiWidth(text, width, { ellipsis: '…' }))
 }

package/src/tui/app.js

@@ -95,6 +95,7 @@ import { randomUUID } from 'crypto'
 import { MODELS, sources } from '../../sources.js'
 import { getAvg, getVerdict, getUptime, getP95, getJitter, getStabilityScore, sortResults, filterByTier, parseArgs, TIER_ORDER, VERDICT_ORDER, TIER_LETTER_MAP, scoreModelForTask, getTopRecommendations, TASK_TYPES, PRIORITY_TYPES, CONTEXT_BUDGETS, formatResultsAsJSON } from '../core/utils.js'
 import { loadConfig, saveConfig, getApiKey, resolveApiKeys, addApiKey, removeApiKey, isProviderEnabled, persistApiKeysForProvider } from '../core/config.js'
+import { setLocale } from '../core/i18n/index.js'
 import { buildMergedModels } from '../core/model-merger.js'
 import { loadOpenCodeConfig, saveOpenCodeConfig } from '../core/opencode-config.js'
 import { usageForRow as _usageForRow } from '../core/usage-reader.js'
@@ -256,6 +257,7 @@ const LOCAL_VERSION = pkg.version
 // 📖 OpenCode helpers are imported from ../src/opencode.js
 
 export async function runApp(cliArgs, config, startupOptions = {}) {
+  setLocale(config.settings?.language || 'en')
   // 📖 t4: prime the sync extended-benchmark stats so the footer chip is
   // 📖 accurate on the first render (no async, no network — just a sync read).
   ensureBenchStatsLoaded()