free-coding-models 0.4.3 → 0.5.1

package/README.md

@@ -145,7 +145,15 @@ docker run -p 19280:19280 ghcr.io/vava-nessa/free-coding-models:latest
 docker run -p 19280:19280 -e OPENROUTER_API_KEY=your_key ghcr.io/vava-nessa/free-coding-models:latest
 ```
 
-Access the web dashboard at `http://localhost:19280/` and configure your coding tool to use `http://localhost:19280/v1` with model `fcm`.
+Access the daemon web dashboard at `http://localhost:19280/` and configure your coding tool to use `http://localhost:19280/v1` with model `fcm`.
+
+For the full TUI-style catalog dashboard from an npm install, run:
+
+```bash
+free-coding-models web
+```
+
+This starts the realtime Web Dashboard locally, opens it in your browser, and uses `http://localhost:3333/` by default. Override the port with `FCM_WEB_PORT=3334 free-coding-models web`.
 
 ### Available Image Tags
 

package/bin/free-coding-models.js

@@ -10,13 +10,13 @@ if (process.argv.includes('--dev')) {
 }
 
 import chalk from 'chalk';
-import { parseArgs, TIER_LETTER_MAP } from '../src/utils.js';
-import { loadConfig } from '../src/config.js';
-import { ensureTelemetryConfig } from '../src/telemetry.js';
-import { ensureFavoritesConfig } from '../src/favorites.js';
-import { buildCliHelpText } from '../src/cli-help.js';
-import { ALT_LEAVE } from '../src/constants.js';
-import { runApp } from '../src/app.js';
+import { parseArgs, TIER_LETTER_MAP } from '../src/core/utils.js';
+import { loadConfig } from '../src/core/config.js';
+import { ensureTelemetryConfig } from '../src/core/telemetry.js';
+import { ensureFavoritesConfig } from '../src/core/favorites.js';
+import { buildCliHelpText } from '../src/tui/cli-help.js';
+import { ALT_LEAVE } from '../src/core/constants.js';
+import { runApp } from '../src/tui/app.js';
 
 // Global error handlers to ensure terminal is restored if something crashes catastrophically
 process.on('uncaughtException', (err) => {
@@ -53,6 +53,16 @@ async function main() {
     process.exit(0);
   }
 
+  // 📖 Standalone web dashboard: same full-catalog ping UI as the TUI, served
+  // 📖 locally with Socket.IO/SSE/REST realtime updates.
+  if (cliArgs.webMode) {
+    const { startWebServer } = await import('../web/server.js');
+    const parsedPort = Number.parseInt(process.env.FCM_WEB_PORT || process.env.FCM_PORT || '3333', 10);
+    const port = Number.isFinite(parsedPort) && parsedPort > 0 ? parsedPort : 3333;
+    await startWebServer(port, { open: true, startPingLoop: true });
+    return;
+  }
+
   // 📖 Router daemon lifecycle flags run before the TUI so automation and
   // 📖 editor integrations can manage the local OpenAI-compatible endpoint.
   if (cliArgs.daemonMode || cliArgs.daemonBackgroundMode || cliArgs.daemonStopMode || cliArgs.daemonStatusMode) {
@@ -61,7 +71,7 @@ async function main() {
       runRouterDaemon,
       startRouterDaemonBackground,
       stopRouterDaemon,
-    } = await import('../src/router-daemon.js');
+    } = await import('../src/core/router-daemon.js');
 
     if (cliArgs.daemonMode) {
       await runRouterDaemon();
@@ -80,7 +90,7 @@ async function main() {
 
   // 📖 --sync-set [name] — auto-discover, probe, and populate a router set
   if (cliArgs.syncSetMode) {
-    const { syncSet } = await import('../src/sync-set.js');
+    const { syncSet } = await import('../src/core/sync-set.js');
     const result = await syncSet({ name: cliArgs.syncSetName || 'auto' });
     console.log(JSON.stringify(result, null, 2));
     process.exit(result.ok ? 0 : 1);

package/changelog/v0.5.0.md

@@ -0,0 +1,15 @@
+# Changelog v0.5.0 - 2026-05-31
+
+### Added
+- **Final Desktop PRD**: Completed `desktop/prd-desktop.md` defining Tauri v2 shell, Bun/Node sidecar integration, zombie process prevention (parent-death binding), and loopback-only security models.
+- **Sub-Project Documentation**: Added `/web/README.md` and `/desktop/README.md` to guide modular frontend and desktop sidecar development.
+
+### Changed
+- **Architectural Segregation (Core vs. TUI)**: Partitioned the codebase into isolated layers:
+  - `src/core/` for 100% shared business logic (routing, scoring, pings, daemon, quota, and config management) shared 1:1 with CLI, Docker, and Tauri sidecar.
+  - `src/tui/` for terminal-only layouts, keystroke handlers, ANSI renderers, and interactive loops.
+- **Relative Import Pathways**: Restructured and re-routed relative imports across all entry points, TUI assets, and core logic files.
+- **Port Consistency**: Standardized loopback proxy and daemon endpoints on port `19280` across all CLI, Docker, and Desktop configurations.
+
+### Fixed
+- **Clean workspace**: Fully purged `.kandown` task manager logs, `.claude-mcp.json`, and stale planning/analysis documents to ensure a zero-noise, lightweight npm package profile.

package/changelog/v0.5.1.md

@@ -0,0 +1,24 @@
+# Changelog v0.5.1 - 2026-05-31
+
+### Added
+- Added `free-coding-models web` as the npm-friendly way to launch the full TUI-style realtime Web Dashboard from a global install.
+- Added Socket.IO as the primary dashboard realtime transport, with SSE and REST polling fallbacks so the UI keeps updating even when one transport is unavailable.
+- Added `/api/state` support for dashboard clients and daemon dashboard clients, including ping mode, countdown, per-model ping state, and benchmark progress metadata.
+- Added tests that lock every visible web table column as sortable, including display-only columns such as `❔`, Last Ping, AI Latency, TPS, and Trend.
+
+### Changed
+- Reworked the standalone web server to mirror the TUI ping cadence more closely: startup speed mode, normal cadence, idle slow mode, per-model `isPinging`, and frequent incremental updates.
+- Changed the Web Dashboard AI Latency global benchmark to benchmark only the models currently visible after filters and search, instead of always benchmarking the full catalog.
+- Made every dashboard table column cycle through ascending, descending, and reset sorting, with missing values consistently pushed to the bottom.
+- Removed the top stats card row from the dashboard for a cleaner, table-first layout.
+- Removed the `ms` suffix from Last Ping and Avg cells in the dashboard table to make dense latency columns easier to scan.
+- Improved dashboard table borders and added visible column separators, including stronger light-theme borders.
+- Updated npm and web documentation to distinguish the full catalog dashboard (`free-coding-models web`, default `localhost:3333`) from the router daemon dashboard (`free-coding-models --daemon`, default `localhost:19280`).
+
+### Fixed
+- Fixed `free-coding-models web` being parsed as an API key by treating `web` as a real subcommand.
+- Fixed dashboard benchmark spinners so only the actively benchmarked row shows running state instead of making unrelated rows spin during global scans.
+- Fixed benchmark result keys by using provider/model identifiers, avoiding collisions and invisible results when providers share model ids.
+- Fixed the Tier “All” filter mismatch in the Web Dashboard.
+- Fixed light-theme button contrast where accent buttons could render unreadable black-on-black text.
+- Fixed the web development readiness check so it waits for the correct local server response.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",
@@ -53,6 +53,7 @@
     "start": "node bin/free-coding-models.js",
     "test": "node --test test/test.js",
     "prepack": "npm run build:web",
+    "dev": "node scripts/dev-web.mjs",
     "dev:web": "node scripts/dev-web.mjs",
     "build:web": "vite build",
     "preview:web": "vite preview",
@@ -60,7 +61,11 @@
     "test:fcm:mock": "node scripts/testfcm-runner.mjs --tool crush --tool-bin-dir test/fixtures/mock-bin"
   },
   "dependencies": {
-    "chalk": "^5.6.2"
+    "@tabler/icons-react": "^3.44.0",
+    "@tanstack/react-table": "^8.21.3",
+    "chalk": "^5.6.2",
+    "socket.io": "^4.8.3",
+    "socket.io-client": "^4.8.3"
   },
   "packageManager": "pnpm@10.33.2",
   "engines": {

package/src/{analysis.js → core/analysis.js}

@@ -35,11 +35,11 @@
  *   @see {@link ../src/ping.js} ping implementation
  */
 
-import { MODELS, sources } from '../sources.js'
-import { findBestModel, filterByTier, formatCtxWindow, labelFromId, TIER_LETTER_MAP } from '../src/utils.js'
-import { isProviderEnabled, getApiKey } from '../src/config.js'
-import { ping } from '../src/ping.js'
-import { PROVIDER_COLOR } from './render-table.js'
+import { MODELS, sources } from '../../sources.js'
+import { findBestModel, filterByTier, formatCtxWindow, labelFromId, TIER_LETTER_MAP } from './utils.js'
+import { isProviderEnabled, getApiKey } from './config.js'
+import { ping } from './ping.js'
+import { PROVIDER_COLOR } from '../tui/render-table.js'
 import chalk from 'chalk'
 
 // 📖 runFiableMode: Analyze models for reliability over 10 seconds, output the best one.

package/src/{constants.js → core/constants.js}

@@ -48,7 +48,7 @@ import chalk from 'chalk'
 // 📖 \x1b[?7l disables auto-wrap so wide rows clip at the right edge instead of
 // 📖 wrapping to the next line (which would double the row height and overflow).
 // 📖 Mouse tracking sequences are appended/prepended so clicks and scroll work in the TUI.
-import { MOUSE_ENABLE, MOUSE_DISABLE } from './mouse.js'
+import { MOUSE_ENABLE, MOUSE_DISABLE } from '../tui/mouse.js'
 
 export const ALT_ENTER = '\x1b[?1049h\x1b[?25l\x1b[?7l' + MOUSE_ENABLE
 export const ALT_LEAVE = MOUSE_DISABLE + '\x1b[?7h\x1b[?1049l\x1b[?25h'

package/src/{endpoint-installer.js → core/endpoint-installer.js}

@@ -43,7 +43,7 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
-import { MODELS, sources } from '../sources.js'
+import { MODELS, sources } from '../../sources.js'
 import { getApiKey, saveConfig } from './config.js'
 import { ENV_VAR_NAMES, PROVIDER_METADATA } from './provider-metadata.js'
 import { getToolMeta } from './tool-metadata.js'

package/src/{installed-models-manager.js → core/installed-models-manager.js}

@@ -48,7 +48,7 @@
 import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join, dirname } from 'node:path'
-import { sources } from '../sources.js'
+import { sources } from '../../sources.js'
 
 const BACKUP_PATH = join(homedir(), '.free-coding-models-backups.json')
 

package/src/{kilo.js → core/kilo.js}

@@ -4,12 +4,11 @@
  */
 
 import chalk from 'chalk'
-import { PROVIDER_COLOR } from './render-table.js'
+import { sources } from '../../sources.js'
 import { loadKiloConfig, saveKiloConfig, getKiloConfigPath } from './kilo-config.js'
 import { getApiKey } from './config.js'
 import { ENV_VAR_NAMES, OPENCODE_MODEL_MAP } from './provider-metadata.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
-import { sources } from '../sources.js'
 
 // 📖 Map source model IDs to Kilo built-in IDs (same as OpenCode).
 function getKiloModelId(providerKey, modelId) {

package/src/{openclaw.js → core/openclaw.js}

@@ -31,7 +31,7 @@ import { homedir } from 'os'
 import { dirname, join } from 'path'
 import { installProviderEndpoints } from './endpoint-installer.js'
 import { ENV_VAR_NAMES } from './provider-metadata.js'
-import { PROVIDER_COLOR } from './render-table.js'
+import { PROVIDER_COLOR } from '../tui/render-table.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
 import { getApiKey } from './config.js'
 import { syncShellEnv } from './shell-env.js'

package/src/{opencode.js → core/opencode.js}

@@ -28,7 +28,8 @@ import { request as httpsRequest } from 'https'
 import { homedir } from 'os'
 import { join } from 'path'
 import { copyFileSync, existsSync } from 'fs'
-import { PROVIDER_COLOR } from './render-table.js'
+import { PROVIDER_COLOR } from '../tui/render-table.js'
+import { sources } from '../../sources.js'
 import { loadOpenCodeConfig, saveOpenCodeConfig } from './opencode-config.js'
 import { getApiKey } from './config.js'
 import { ENV_VAR_NAMES, OPENCODE_MODEL_MAP, isWindows, isMac, isLinux } from './provider-metadata.js'

package/src/{ping-loop.js → core/ping-loop.js}

@@ -28,7 +28,7 @@ import {
   PING_MODE_INTERVALS,
   SPEED_MODE_DURATION_MS,
   IDLE_SLOW_AFTER_MS,
-} from './tui-state.js'
+} from '../tui/tui-state.js'
 
 /**
  * 📖 createPingLoop: Build the ping loop control functions for a given TUI state.

package/src/{router-daemon.js → core/router-daemon.js}

@@ -37,7 +37,7 @@ import { randomUUID } from 'node:crypto'
 import { appendFileSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
-import { MODELS, sources } from '../sources.js'
+import { MODELS, sources } from '../../sources.js'
 import {
   CONFIG_PATH,
   DEFAULT_ROUTER_SETTINGS,
@@ -48,6 +48,7 @@ import {
   saveConfig,
 } from './config.js'
 import { buildChatCompletionPingBody, resolveCloudflareUrl, shouldUseDisabledThinkingForProvider } from './ping.js'
+import { benchmarkModel, BENCHMARK_TIMEOUT_MS } from './benchmark.js'
 import { sendUsageTelemetry } from './telemetry.js'
 
 export const ROUTER_DEFAULT_PORT = 19280
@@ -71,7 +72,7 @@ export function getRouterPortRange() {
 }
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
-const CLI_ENTRY_PATH = join(__dirname, '..', 'bin', 'free-coding-models.js')
+const CLI_ENTRY_PATH = join(__dirname, '..', '..', 'bin', 'free-coding-models.js')
 const MAX_BODY_BYTES = 10 * 1024 * 1024
 const MAX_REQUEST_LOG = 200
 const MAX_SSE_CLIENTS = 10
@@ -343,12 +344,32 @@ function getWebModelsPayload(runtime) {
         pingCount: pings.length,
         hasApiKey,
         inRouterSet: inSetIndex.has(`${providerKey}::${modelId}`),
+        benchmarkKey: key,
+        isBenchmarking: runtime.webBenchmarkRunning?.has(key) || false,
+        benchmark: runtime.webBenchmarkResults?.get(key) || null,
       })
     }
   }
   return payload
 }
 
+function getWebStatePayload(runtime) {
+  const router = runtime.routerConfig()
+  const probeInterval = router.probeIntervals?.[router.probeMode] || DEFAULT_ROUTER_SETTINGS.probeIntervals.balanced
+  return {
+    pingMode: router.probeMode === 'aggressive' ? 'speed' : router.probeMode === 'eco' ? 'slow' : 'normal',
+    pingModeSource: 'daemon-probe-mode',
+    pingInterval: probeInterval,
+    nextPingAt: runtime.lastProbeAt ? runtime.lastProbeAt + probeInterval : null,
+    pendingPings: runtime.probeTimeouts?.size || 0,
+    isPinging: (runtime.probeTimeouts?.size || 0) > 0,
+    globalBenchmarkRunning: runtime.webGlobalBenchmarkRunning || false,
+    globalBenchmarkTotal: runtime.webGlobalBenchmarkTotal || 0,
+    globalBenchmarkCompleted: runtime.webGlobalBenchmarkCompleted || 0,
+    models: getWebModelsPayload(runtime),
+  }
+}
+
 function getWebConfigPayload(runtime) {
   const providers = {}
   for (const [key, src] of Object.entries(sources)) {
@@ -365,7 +386,7 @@ function getWebConfigPayload(runtime) {
   return { providers, totalModels: MODELS.length }
 }
 
-const WEB_DIST_DIR = resolvePath(__dirname, '..', 'web', 'dist')
+const WEB_DIST_DIR = resolvePath(__dirname, '..', '..', 'web', 'dist')
 
 function serveStaticFromDist(res, absPath) {
   const ext = absPath.slice(absPath.lastIndexOf('.'))
@@ -786,6 +807,11 @@ class RouterRuntime {
     this.quotaExhausted = new Set()
     this.quotaDetails = new Map()
     this.staleNotifications = new Set()
+    this.webBenchmarkRunning = new Set()
+    this.webBenchmarkResults = new Map()
+    this.webGlobalBenchmarkRunning = false
+    this.webGlobalBenchmarkTotal = 0
+    this.webGlobalBenchmarkCompleted = 0
     this.refreshRouteState()
   }
 
@@ -1131,6 +1157,99 @@ class RouterRuntime {
     }
   }
 
+  broadcastWebState() {
+    this.broadcast('models', getWebStatePayload(this))
+  }
+
+  async runWebBenchmark(providerKey, modelId) {
+    const key = modelKey(providerKey, modelId)
+    if (this.webBenchmarkRunning.has(key)) return { skipped: true }
+    const source = sources[providerKey]
+    if (!source?.url) {
+      return { ok: false, code: 'UNSUPPORTED', totalMs: 0, error: 'Provider has no benchmark URL', retries: 0 }
+    }
+
+    this.webBenchmarkRunning.add(key)
+    this.broadcastWebState()
+    try {
+      const result = await benchmarkModel({
+        apiKey: this.getApiKeyForProvider(providerKey) ?? null,
+        modelId,
+        providerKey,
+        url: source.url,
+        timeoutMs: BENCHMARK_TIMEOUT_MS,
+      })
+      this.webBenchmarkResults.set(key, result)
+      return result
+    } catch (err) {
+      const fallback = { ok: false, code: 'ERR', totalMs: 0, error: err?.message || 'Benchmark failed', retries: 0 }
+      this.webBenchmarkResults.set(key, fallback)
+      return fallback
+    } finally {
+      this.webBenchmarkRunning.delete(key)
+      this.broadcastWebState()
+    }
+  }
+
+  async runWebGlobalBenchmark(models) {
+    if (this.webGlobalBenchmarkRunning) return { started: false, error: 'Global benchmark already running' }
+    const knownModels = []
+    const seen = new Set()
+    for (const item of Array.isArray(models) ? models : []) {
+      const providerKey = typeof item?.providerKey === 'string' ? item.providerKey : ''
+      const modelId = typeof item?.modelId === 'string' ? item.modelId : ''
+      const key = modelKey(providerKey, modelId)
+      if (!this.modelCatalog.has(key) || seen.has(key)) continue
+      seen.add(key)
+      knownModels.push({ providerKey, modelId, key })
+    }
+
+    const fallbackModels = knownModels.length > 0
+      ? knownModels
+      : [...this.modelCatalog.values()].filter((m) => sources[m.providerKey]?.url && !sources[m.providerKey]?.cliOnly)
+
+    this.webGlobalBenchmarkRunning = true
+    this.webGlobalBenchmarkTotal = fallbackModels.length
+    this.webGlobalBenchmarkCompleted = 0
+    this.broadcastWebState()
+
+    const healthPriority = { up: 0, pending: 1, timeout: 2, noauth: 3, auth_error: 4, down: 5 }
+    const sorted = [...fallbackModels].sort((a, b) => {
+      const aw = this.probeWindows.get(modelKey(a.providerKey, a.modelId)) || []
+      const bw = this.probeWindows.get(modelKey(b.providerKey, b.modelId)) || []
+      const aLast = aw.at(-1)
+      const bLast = bw.at(-1)
+      const aState = aLast?.ok ? 'up' : aw.length ? 'down' : 'pending'
+      const bState = bLast?.ok ? 'up' : bw.length ? 'down' : 'pending'
+      const hpA = healthPriority[aState] ?? 6
+      const hpB = healthPriority[bState] ?? 6
+      if (hpA !== hpB) return hpA - hpB
+      return (aLast?.latencyMs ?? 99999) - (bLast?.latencyMs ?? 99999)
+    })
+
+    const workers = new Array(Math.min(5, sorted.length)).fill(null).map(async () => {
+      while (sorted.length > 0) {
+        const next = sorted.shift()
+        if (!next) break
+        try {
+          await this.runWebBenchmark(next.providerKey, next.modelId)
+        } finally {
+          this.webGlobalBenchmarkCompleted += 1
+          this.broadcastWebState()
+        }
+      }
+    })
+
+    void Promise.all(workers).finally(() => {
+      this.webGlobalBenchmarkRunning = false
+      this.webGlobalBenchmarkTotal = 0
+      this.webGlobalBenchmarkCompleted = 0
+      this.broadcastWebState()
+    })
+
+    return { started: true, total: fallbackModels.length }
+  }
+
   statusPayload() {
     const router = this.routerConfig()
     const activeSet = this.getSet(router.activeSet)
@@ -1892,6 +2011,10 @@ class RouterRuntime {
         sendJson(res, 200, getWebModelsPayload(this), { 'x-request-id': requestId })
         return
       }
+      if (req.method === 'GET' && url.pathname === '/api/state') {
+        sendJson(res, 200, getWebStatePayload(this), { 'x-request-id': requestId })
+        return
+      }
       if (req.method === 'GET' && url.pathname === '/api/config') {
         sendJson(res, 200, getWebConfigPayload(this), { 'x-request-id': requestId })
         return
@@ -1907,11 +2030,53 @@ class RouterRuntime {
           'Connection': 'keep-alive',
           'x-request-id': requestId,
         })
-        res.write(`data: ${JSON.stringify(getWebModelsPayload(this))}\n\n`)
+        res.write(`data: ${JSON.stringify(getWebStatePayload(this))}\n\n`)
         this.sseClients.add(res)
         req.on('close', () => this.sseClients.delete(res))
         return
       }
+      if (req.method === 'POST' && url.pathname === '/api/activity') {
+        sendJson(res, 200, { ok: true }, { 'x-request-id': requestId })
+        return
+      }
+      if (req.method === 'POST' && url.pathname === '/api/benchmark') {
+        const body = await readJsonBody(req)
+        const providerKey = typeof body.providerKey === 'string' ? body.providerKey : ''
+        const modelId = typeof body.modelId === 'string' ? body.modelId : ''
+        if (!this.modelCatalog.has(modelKey(providerKey, modelId))) {
+          sendJson(res, 404, { error: 'Model not found' }, { 'x-request-id': requestId })
+          return
+        }
+        if (this.webBenchmarkRunning.has(modelKey(providerKey, modelId))) {
+          sendJson(res, 409, { error: 'Benchmark already in progress for this model' }, { 'x-request-id': requestId })
+          return
+        }
+        const result = await this.runWebBenchmark(providerKey, modelId)
+        sendJson(res, 200, result, { 'x-request-id': requestId })
+        return
+      }
+      if (url.pathname === '/api/global-benchmark') {
+        if (req.method === 'GET') {
+          sendJson(res, 200, {
+            running: this.webGlobalBenchmarkRunning,
+            total: this.webGlobalBenchmarkTotal,
+            completed: this.webGlobalBenchmarkCompleted,
+          }, { 'x-request-id': requestId })
+          return
+        }
+        if (req.method !== 'POST') {
+          sendError(res, 405, 'Method not allowed', 'invalid_request_error', 'method_not_allowed', requestId)
+          return
+        }
+        if (this.webGlobalBenchmarkRunning) {
+          sendJson(res, 409, { error: 'Global benchmark already running' }, { 'x-request-id': requestId })
+          return
+        }
+        const body = await readJsonBody(req)
+        const result = await this.runWebGlobalBenchmark(body.models)
+        sendJson(res, result.started ? 202 : 409, result, { 'x-request-id': requestId })
+        return
+      }
       if (req.method === 'GET' && url.pathname.startsWith('/api/key/')) {
         // 📖 Reveals raw API keys — same-origin only to prevent malicious sites
         // 📖 from exfiltrating provider credentials via XHR/fetch.

package/src/{router-dashboard.js → core/router-dashboard.js}

@@ -41,9 +41,9 @@
 
 import chalk from 'chalk'
 import { existsSync, readFileSync } from 'node:fs'
-import { displayWidth, padEndDisplay, sliceOverlayLines, tintOverlayLines } from './render-helpers.js'
+import { displayWidth, padEndDisplay, sliceOverlayLines, tintOverlayLines } from '../tui/render-helpers.js'
 import { ROUTER_DEFAULT_PORT, ROUTER_MAX_PORT, ROUTER_PID_PATH, ROUTER_PORT_PATH, getRouterPortRange } from './router-daemon.js'
-import { themeColors, getTierRgb } from './theme.js'
+import { themeColors, getTierRgb } from '../tui/theme.js'
 import { formatTokenTotalCompact } from './token-usage-reader.js'
 import { sendUsageTelemetry } from './telemetry.js'
 import { getAvg, getVerdict } from './utils.js'

package/src/{setup.js → core/setup.js}

@@ -35,7 +35,7 @@
 
 import chalk from 'chalk'
 import { createRequire } from 'module'
-import { sources } from '../sources.js'
+import { sources } from '../../sources.js'
 import { PROVIDER_METADATA } from './provider-metadata.js'
 import { saveConfig } from './config.js'
 

package/src/{sync-set.js → core/sync-set.js}

@@ -28,7 +28,7 @@
  * @see ../sources.js — model catalog
  */
 
-import { sources } from '../sources.js'
+import { sources } from '../../sources.js'
 import {
   CONFIG_PATH,
   getApiKey,

package/src/{telemetry.js → core/telemetry.js}

@@ -51,7 +51,7 @@ import { createRequire } from 'module'
 import { saveConfig } from './config.js'
 
 const require = createRequire(import.meta.url)
-const pkg = require('../package.json')
+const pkg = require('../../package.json')
 const LOCAL_VERSION = pkg.version
 
 // 📖 PostHog capture endpoint and defaults.

package/src/{tool-launchers.js → core/tool-launchers.js}

@@ -41,8 +41,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from
 import { homedir } from 'os'
 import { dirname, join } from 'path'
 import { spawn, spawnSync } from 'child_process'
-import { sources } from '../sources.js'
-import { PROVIDER_COLOR } from './render-table.js'
+import { sources } from '../../sources.js'
+import { PROVIDER_COLOR } from '../tui/render-table.js'
 import { getApiKey } from './config.js'
 import { ENV_VAR_NAMES, isWindows } from './provider-metadata.js'
 import { getToolMeta, TOOL_METADATA } from './tool-metadata.js'

package/src/{updater.js → core/updater.js}

@@ -46,7 +46,7 @@ import { accessSync, constants } from 'fs'
 
 const require = createRequire(import.meta.url)
 const readline = require('readline')
-const pkg = require('../package.json')
+const pkg = require('../../package.json')
 const LOCAL_VERSION = pkg.version
 
 /**

package/src/{utils.js → core/utils.js}

@@ -471,6 +471,8 @@ export function parseArgs(argv) {
       flags.push(arg.toLowerCase())
     } else if (skipIndices.has(i)) {
       // 📖 Skip — this is a value for --tier, not an API key
+    } else if (i === 0 && arg.toLowerCase() === 'web') {
+      // 📖 `free-coding-models web` is a subcommand, not a provider API key.
     } else if (!apiKey) {
       apiKey = arg
     }