free-coding-models 0.5.9 → 0.5.11

package/src/tui/app.js

@@ -343,6 +343,12 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
     updateInstallFailures: startupUpdate.failures || 0,
   })
 
+  // 📖 `--playground` / `playground` subcommand: open the in-TUI chat
+  // 📖 overlay on first render so the user lands directly in the chat.
+  if (startupOptions.wantPlayground === true) {
+    state.playgroundOpen = true
+  }
+
   // 📖 Apply the pre-fetched last release date now that state is initialized
   state.lastReleaseDate = lastReleaseDate
 
@@ -759,7 +765,7 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
     // 📖 usable right now: models enter/leave as soon as ping status changes.
     applyTierFilter()
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
-    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.changelogOpen && !state.installedModelsOpen && !state.routerDashboardOpen && !state.commandPaletteOpen) {
+    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.changelogOpen && !state.installedModelsOpen && !state.routerDashboardOpen && !state.playgroundOpen && !state.commandPaletteOpen) {
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
         pinFavorites: state.favoritesPinnedAndSticky,
@@ -834,6 +840,8 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
         ? overlays.renderInstalledModels()
       : state.routerDashboardOpen
         ? overlays.renderRouterDashboard()
+      : state.playgroundOpen
+        ? overlays.renderPlayground()
       : state.tokenUsageOpen
         ? overlays.renderTokenUsage()
       : state.routerOnboardingOpen

package/src/tui/cli-help.js

@@ -37,6 +37,7 @@ const ANALYSIS_FLAGS = [
 
 const CONFIG_FLAGS = [
   { flag: 'web | --web | --gui', description: 'Start the full-catalog realtime Web Dashboard' },
+  { flag: 'playground | --playground', description: 'Open the in-TUI Playground chat overlay (auto-starts the router if needed)' },
   { flag: '--daemon', description: 'Start the FCM Router daemon + web dashboard (same port)' },
   { flag: '--daemon-bg', description: 'Start the FCM Router daemon in the background' },
   { flag: '--daemon-status', description: 'Print FCM Router daemon status JSON' },
@@ -54,6 +55,7 @@ const EXAMPLES = [
   'free-coding-models --daemon-status',
   'free-coding-models --sync-set',
   'free-coding-models --sync-set my-coding-set',
+  'free-coding-models --playground',
   'free-coding-models --openclaw --tier S',
   "free-coding-models --json | jq '.[0]'",
 ]

package/src/tui/command-palette.js

@@ -211,6 +211,7 @@ const BASE_COMMAND_TREE = [
   { id: 'open-changelog', label: 'Changelog', icon: '📋', type: 'page', description: 'Version history', keywords: ['changelog', 'release'] },
 
   { id: 'open-recommend', label: 'Smart recommend', shortcut: 'Q', icon: '🎯', type: 'page', description: 'Find best model for task', keywords: ['recommend', 'best model'] },
+  { id: 'open-playground', label: 'Playground', shortcut: ';', icon: '💬', type: 'page', description: 'Chat with the FCM router', keywords: ['playground', 'chat', 'try', 'prompt', 'router'] },
   { id: 'open-install-endpoints', label: 'Install endpoints', icon: '🔌', type: 'page', description: 'Install provider catalogs', keywords: ['install', 'endpoints', 'providers'] },
   { id: 'open-installed-models', label: 'Installed models', icon: '🗂️', type: 'page', description: 'View models configured in tools', keywords: ['installed', 'models', 'configured', 'tools', 'manager', 'goose', 'crush', 'aider'] },
 ]

package/src/tui/key-handler.js

@@ -55,6 +55,11 @@ import {
   restartRouterDashboardDaemon,
   toggleRouterDashboardProbePause,
 } from '../core/router-dashboard.js'
+import {
+  closePlaygroundOverlay,
+  openPlaygroundOverlay,
+  handlePlaygroundKeypress,
+} from '../core/playground.js'
 import { benchmarkModel } from '../core/benchmark.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
@@ -1283,6 +1288,7 @@ export function createKeyHandler(ctx) {
       || state.toolInstallPromptOpen
       || state.installedModelsOpen
       || state.routerDashboardOpen
+      || state.playgroundOpen
       || state.recommendOpen
 
       || state.helpVisible
@@ -1475,6 +1481,7 @@ export function createKeyHandler(ctx) {
 
       case 'open-recommend': return openRecommendOverlay()
       case 'open-router-dashboard': return openRouterDashboardOverlay(state)
+      case 'open-playground': return openPlaygroundOverlay(state)
       case 'open-token-usage': return openTokenUsageOverlay()
       case 'open-install-endpoints': return openInstallEndpointsOverlay()
       case 'open-installed-models': return openInstalledModelsOverlay()
@@ -1745,6 +1752,14 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Playground overlay: handles Enter, Esc, Backspace, Ctrl+S, Ctrl+L,
+    // 📖 PageUp/PageDown, and printable input itself. The dedicated handler
+    // 📖 in core/playground.js owns the draft and submission state.
+    if (state.playgroundOpen) {
+      if (handlePlaygroundKeypress(key.string != null ? key.string : key.name, { fetchFn: globalThis.fetch })) return
+      return
+    }
+
     // 📖 Install Endpoints overlay: provider → tool → connection → scope → optional model subset.
     if (state.installEndpointsOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
@@ -2838,6 +2853,13 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 ; (semicolon) key: open the Playground chat overlay. Avoids clashes
+    // 📖 with P (settings), K (help), Z (tool), N (changelog), etc.
+    if (key.name === ';' || (key.shift && key.name === ':')) {
+      void openPlaygroundOverlay(state)
+      return
+    }
+
     // 📖 Y key toggles favorites display mode (pinned+sticky vs normal rows).
     if (key.name === 'y' && !key.ctrl && !key.meta) {
       toggleFavoritesDisplayMode()

package/src/tui/overlays.js

@@ -22,6 +22,7 @@
 import { loadChangelog } from '../core/changelog-loader.js'
 import { buildCliHelpLines } from './cli-help.js'
 import { renderRouterDashboard as renderRouterDashboardOverlay } from '../core/router-dashboard.js'
+import { renderPlayground as renderPlaygroundOverlay } from '../core/playground.js'
 import { themeColors, getThemeStatusLabel, getProviderRgb } from './theme.js'
 
 export function createOverlayRenderers(state, deps) {
@@ -1334,6 +1335,15 @@ export function createOverlayRenderers(state, deps) {
     return renderRouterDashboardOverlay(state, { LOCAL_VERSION })
   }
 
+  // ─── Playground overlay ───────────────────────────────────────────────────────
+  // 📖 Renders the in-TUI chat playground when the user presses `;` or opens
+  // 📖 it from the command palette. All chat traffic flows to the local
+  // 📖 daemon over HTTP, so the TUI process never has to import the
+  // 📖 provider catalog.
+  function renderPlayground() {
+    return renderPlaygroundOverlay(state, state.terminalRows, state.terminalCols)
+  }
+
   // ─── Incompatible fallback overlay ─────────────────────────────────────────
   // 📖 renderIncompatibleFallback shows when user presses Enter on a model that
   // 📖 is NOT compatible with the active tool. Two sections:
@@ -1615,6 +1625,7 @@ export function createOverlayRenderers(state, deps) {
     renderChangelog,
     renderInstalledModels,
     renderRouterDashboard,
+    renderPlayground,
     renderIncompatibleFallback,
     renderTokenUsage,
     renderRouterOnboarding,

package/src/tui/theme.js

@@ -53,6 +53,7 @@ const PALETTES = {
       feedback: [31, 13, 20],
       changelog: [12, 24, 44],
       commandPalette: [14, 20, 36],
+      playground: [10, 22, 18],
     },
     cursor: {
       defaultBg: [39, 55, 90],
@@ -99,6 +100,7 @@ const PALETTES = {
       feedback: [255, 247, 248],
       changelog: [244, 248, 255],
       commandPalette: [242, 247, 255],
+      playground: [244, 252, 246],
     },
     cursor: {
       defaultBg: [217, 231, 255],
@@ -326,5 +328,6 @@ export const themeColors = {
   overlayBgRecommend: (text) => paintBg(currentPalette().overlayBg.recommend, text, currentPalette().overlayFg),
   overlayBgFeedback: (text) => paintBg(currentPalette().overlayBg.feedback, text, currentPalette().overlayFg),
   overlayBgChangelog: (text) => paintBg(currentPalette().overlayBg.changelog, text, currentPalette().overlayFg),
+  overlayBgPlayground: (text) => paintBg(currentPalette().overlayBg.playground, text, currentPalette().overlayFg),
   overlayBgCommandPalette: (text) => paintBg(currentPalette().overlayBg.commandPalette, text, currentPalette().overlayFg),
 }