agent-termo 1.0.0 → 1.0.2

package/dist/utils/ansi.d.ts

@@ -0,0 +1,62 @@
+export declare const COLORS: {
+    primary: string;
+    primaryBg: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    background: string;
+    surface: string;
+    elevated: string;
+    border: string;
+    borderLight: string;
+    text: string;
+    textSecondary: string;
+    muted: string;
+    dim: string;
+    manager: string;
+    architect: string;
+    expert: string;
+    security: string;
+    codeKeyword: string;
+    codeString: string;
+    codeComment: string;
+    codeFunction: string;
+    codeType: string;
+    userMsg: string;
+    aiMsg: string;
+    accent: string;
+    reset: string;
+    bright: string;
+    dim_text: string;
+    italic: string;
+    underline: string;
+};
+export declare const BG: {
+    surface: string;
+    elevated: string;
+    primaryBg: string;
+};
+export declare const FMT: {
+    bold: string;
+    dim: string;
+    ita: string;
+    ul: string;
+    reset: string;
+};
+export declare function color(colorCode: string, text: string): string;
+export declare function bg(colorCode: string, text: string): string;
+export declare function bold(text: string): string;
+export declare function dim(text: string): string;
+export declare function spinnerFrame(): string;
+export declare function resetSpinner(): void;
+export declare function hbar(length: number, char?: string): string;
+export declare function clamp(text: string, maxLength: number): string;
+export declare function progressBar(percent: number, width?: number): string;
+export declare function agentColor(agentName: string): string;
+export declare const clearLine = "\u001B[2K\r";
+export declare const clearScreen = "\u001B[2J";
+export declare const cursorHome = "\u001B[H";
+export declare const hideCursor = "\u001B[?25l";
+export declare const showCursor = "\u001B[?25h";
+//# sourceMappingURL=ansi.d.ts.map

package/dist/utils/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/utils/ansi.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDlB,CAAC;AAEF,eAAO,MAAM,EAAE;;;;CAId,CAAC;AAEF,eAAO,MAAM,GAAG;;;;;;CAMf,CAAC;AAGF,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAMD,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAGD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7D;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAI/D;AAGD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMpD;AAGD,eAAO,MAAM,SAAS,gBAAc,CAAC;AACrC,eAAO,MAAM,WAAW,cAAY,CAAC;AACrC,eAAO,MAAM,UAAU,aAAW,CAAC;AACnC,eAAO,MAAM,UAAU,gBAAc,CAAC;AACtC,eAAO,MAAM,UAAU,gBAAc,CAAC"}

package/dist/utils/ansi.js

@@ -0,0 +1,116 @@
+// =============================================================================
+// ANSI Color Utilities
+// =============================================================================
+// Design System colors (ANSI 256-color codes for cross-platform terminal)
+export const COLORS = {
+    // Primary: #A855F7 → ANSI 135
+    primary: '\x1b[38;5;135m',
+    primaryBg: '\x1b[48;5;57m',
+    // Semantic
+    success: '\x1b[38;5;82m', // green-500
+    warning: '\x1b[38;5;214m', // amber-500
+    error: '\x1b[38;5;203m', // red-500
+    info: '\x1b[38;5;75m', // blue-500
+    // Dark theme neutrals
+    background: '\x1b[48;5;17m', // slate-900
+    surface: '\x1b[48;5;30m', // slate-800
+    elevated: '\x1b[48;5;31m', // slate-700
+    border: '\x1b[38;5;240m', // #646B7B
+    borderLight: '\x1b[38;5;241m', // #7C8796
+    // Text
+    text: '\x1b[38;5;255m', // slate-50
+    textSecondary: '\x1b[38;5;188m', // slate-300
+    muted: '\x1b[38;5;250m', // slate-400
+    dim: '\x1b[38;5;244m', // slate-400
+    // Agent badge colors
+    manager: '\x1b[38;5;135m', // purple
+    architect: '\x1b[38;5;75m', // blue
+    expert: '\x1b[38;5;82m', // green
+    security: '\x1b[38;5;214m', // amber
+    // Code syntax
+    codeKeyword: '\x1b[38;5;219m', // pink-400
+    codeString: '\x1b[38;5;114m', // green-400
+    codeComment: '\x1b[38;5;245m', // gray-400
+    codeFunction: '\x1b[38;5;75m', // blue-400
+    codeType: '\x1b[38;5;171m', // emerald-400
+    // Roles
+    userMsg: '\x1b[38;5;82m', // green for user
+    aiMsg: '\x1b[38;5;135m', // purple for AI
+    // Decorators
+    accent: '\x1b[38;5;75m', // blue accent
+    // Reset
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim_text: '\x1b[2m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+};
+export const BG = {
+    surface: '\x1b[48;5;30m',
+    elevated: '\x1b[48;5;31m',
+    primaryBg: '\x1b[48;5;57m',
+};
+export const FMT = {
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    ita: '\x1b[3m',
+    ul: '\x1b[4m',
+    reset: '\x1b[0m',
+};
+// Escape helpers
+export function color(colorCode, text) {
+    return `${colorCode}${text}${COLORS.reset}`;
+}
+export function bg(colorCode, text) {
+    return `${colorCode}${text}${COLORS.reset}`;
+}
+export function bold(text) {
+    return `${FMT.bold}${text}${FMT.reset}`;
+}
+export function dim(text) {
+    return `${FMT.dim}${text}${FMT.reset}`;
+}
+// Spinner frames (80ms per frame, 12 chars cycle)
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+let spinnerIndex = 0;
+export function spinnerFrame() {
+    const frame = SPINNER_FRAMES[spinnerIndex % SPINNER_FRAMES.length];
+    spinnerIndex++;
+    return frame ?? ' ';
+}
+export function resetSpinner() {
+    spinnerIndex = 0;
+}
+// Box drawing helpers
+export function hbar(length, char = '─') {
+    return char.repeat(length);
+}
+export function clamp(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return text.slice(0, maxLength - 3) + '...';
+}
+// Progress bar
+export function progressBar(percent, width = 30) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    return `[${COLORS.success}${'█'.repeat(filled)}${'░'.repeat(empty)}${COLORS.reset}]`;
+}
+// Agent badge color
+export function agentColor(agentName) {
+    const lower = agentName.toLowerCase();
+    if (lower.includes('project-manager'))
+        return COLORS.manager;
+    if (lower.includes('architecture') || lower.includes('stack'))
+        return COLORS.architect;
+    if (lower.includes('security') || lower.includes('deploy'))
+        return COLORS.security;
+    return COLORS.expert;
+}
+// Clear line (ANSI)
+export const clearLine = '\x1b[2K\r';
+export const clearScreen = '\x1b[2J';
+export const cursorHome = '\x1b[H';
+export const hideCursor = '\x1b[?25l';
+export const showCursor = '\x1b[?25h';
+//# sourceMappingURL=ansi.js.map

package/dist/utils/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/utils/ansi.ts"],"names":[],"mappings":"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"}

package/dist/utils/config.d.ts

@@ -0,0 +1,9 @@
+import type { AppConfig } from '../types/index.js';
+declare const PROJECT_ROOT: string;
+export { PROJECT_ROOT };
+export declare function getAgentTermoDir(): string;
+export declare function saveNimApiKey(apiKey: string): void;
+export declare function saveNimModel(model: string): void;
+export declare function getConfig(projectRoot: string): AppConfig;
+export declare function resolveProjectRoot(cwd?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiCnD,QAAA,MAAM,YAAY,QAAmB,CAAC;AAItC,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAmDD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAKD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAgBxD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/utils/config.js

@@ -0,0 +1,120 @@
+// =============================================================================
+// Config Management
+// =============================================================================
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Find project root reliably (works even when cwd != project dir)
+function getProjectRoot() {
+    // Try import.meta.url first (ESM)
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        return dirname(dirname(thisFile)); // src/utils/ → src/ → project root
+    }
+    catch {
+        // Fall back to process.cwd()
+        return process.cwd();
+    }
+}
+// Load .env files at startup
+function loadEnvFile(envPath) {
+    try {
+        const content = readFileSync(envPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1 || eqIdx === trimmed.length - 1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            const value = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, '');
+            if (!process.env[key])
+                process.env[key] = value;
+        }
+    }
+    catch {
+        // file not found — continue silently
+    }
+}
+// Load .env from project root and current directory
+const PROJECT_ROOT = getProjectRoot();
+loadEnvFile(resolve(PROJECT_ROOT, '.env'));
+loadEnvFile(resolve('.env')); // also try cwd
+export { PROJECT_ROOT };
+export function getAgentTermoDir() {
+    const envDir = process.env.AGENT_TERMO_DIR;
+    if (envDir) {
+        return resolve(process.env.HOME || process.env.USERPROFILE || '.', envDir);
+    }
+    return resolve(process.env.HOME || process.env.USERPROFILE || '.', '.agent-termo');
+}
+function readStoredConfig() {
+    try {
+        const existing = JSON.parse(readFileSync(resolve(getAgentTermoDir(), 'config.json'), 'utf-8'));
+        if (existing && typeof existing === 'object' && !Array.isArray(existing)) {
+            return existing;
+        }
+    }
+    catch {
+        // No saved user configuration yet.
+    }
+    return {};
+}
+function updateStoredConfig(patch) {
+    const configDir = getAgentTermoDir();
+    const configPath = resolve(configDir, 'config.json');
+    const storedConfig = { ...readStoredConfig(), ...patch };
+    mkdirSync(configDir, { recursive: true, mode: 0o700 });
+    writeFileSync(configPath, `${JSON.stringify(storedConfig, null, 2)}\n`, {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+    // Restrict permissions even when updating an existing file on Unix.
+    if (process.platform !== 'win32')
+        chmodSync(configPath, 0o600);
+}
+function loadStoredNimApiKey() {
+    if (process.env.NIM_API_KEY)
+        return;
+    const { nimApiKey } = readStoredConfig();
+    if (typeof nimApiKey === 'string' && nimApiKey.trim()) {
+        process.env.NIM_API_KEY = nimApiKey;
+    }
+}
+/**
+ * A model picked with /model is saved and wins over NIM_MODEL from .env, so
+ * the choice survives restarts. The --model CLI flag still overrides it.
+ */
+function loadStoredNimModel() {
+    const { nimModel } = readStoredConfig();
+    if (typeof nimModel === 'string' && nimModel.trim()) {
+        process.env.NIM_MODEL = nimModel;
+    }
+}
+export function saveNimApiKey(apiKey) {
+    updateStoredConfig({ nimApiKey: apiKey });
+}
+export function saveNimModel(model) {
+    updateStoredConfig({ nimModel: model });
+}
+loadStoredNimApiKey();
+loadStoredNimModel();
+export function getConfig(projectRoot) {
+    loadEnvFile(resolve(projectRoot, '.env'));
+    return {
+        nimApiKey: process.env.NIM_API_KEY ?? '',
+        nimBaseUrl: process.env.NIM_BASE_URL ?? 'https://integrate.api.nvidia.com/v1',
+        nimModel: process.env.NIM_MODEL ?? 'stepfun-ai/step-3.7-flash',
+        agentTermoDir: process.env.AGENT_TERMO_DIR ?? '.claude',
+        logLevel: process.env.LOG_LEVEL || 'info',
+        confirmDestructive: process.env.CONFIRM_DESTRUCTIVE !== 'false',
+        allowedCommands: (process.env.ALLOWED_COMMANDS ?? 'git,npm,node,pnpm,yarn,tsx,tsc,npx').split(','),
+        llmTimeout: parseInt(process.env.LLM_TIMEOUT ?? '120000', 10),
+        bashTimeout: parseInt(process.env.BASH_TIMEOUT ?? '300000', 10),
+    };
+}
+export function resolveProjectRoot(cwd) {
+    return cwd || PROJECT_ROOT;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-termo",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Terminal-based AI coding agent that replicates Claude Code experience",
   "type": "module",
   "main": "dist/main.js",
@@ -87,4 +87,4 @@
     ],
     "outputPath": "dist"
   }
-}
+}

package/src/cli.ts

@@ -5,25 +5,104 @@
 
 import { Command } from 'commander';
 import { runRepl } from './main.js';
+import { saveNimApiKey } from './utils/config.js';
 
 const program = new Command();
 
+async function promptForApiKey(): Promise<string> {
+  const input = process.stdin;
+  const output = process.stdout;
+
+  if (!input.isTTY || typeof input.setRawMode !== 'function') {
+    throw new Error(
+      'NVIDIA NIM API key is missing. Run Agent-Termo in an interactive terminal or set NIM_API_KEY before starting.',
+    );
+  }
+
+  console.log('An NVIDIA NIM API key is required to start Agent-Termo.');
+  console.log('Get your key at https://build.nvidia.com/');
+  output.write('Enter your API key (input hidden): ');
+
+  return new Promise((resolve, reject) => {
+    let apiKey = '';
+    let previousWasCarriageReturn = false;
+
+    const restoreTerminal = () => {
+      input.off('data', onData);
+      input.setRawMode(false);
+      input.pause();
+      output.write('\n');
+    };
+
+    const onData = (data: Buffer) => {
+      for (const char of data.toString('utf-8')) {
+        if (char === '\n' && previousWasCarriageReturn) {
+          previousWasCarriageReturn = false;
+          continue;
+        }
+        previousWasCarriageReturn = char === '\r';
+
+        if (char === '\u0003' || char === '\u0004') {
+          restoreTerminal();
+          reject(new Error('API key setup cancelled.'));
+          return;
+        }
+
+        if (char === '\r' || char === '\n') {
+          if (!apiKey.trim()) {
+            output.write('\nAn API key is required. Enter your API key: ');
+            continue;
+          }
+
+          restoreTerminal();
+          resolve(apiKey.trim());
+          return;
+        }
+
+        if (char === '\u007f' || char === '\b') {
+          apiKey = apiKey.slice(0, -1);
+        } else if (char >= ' ') {
+          apiKey += char;
+        }
+      }
+    };
+
+    input.setRawMode(true);
+    input.resume();
+    input.on('data', onData);
+  });
+}
+
+async function startAgent(
+  project: string,
+  options: { apiKey?: string; model?: string; debug?: boolean },
+): Promise<void> {
+  // Apply CLI overrides to env before main initializes.
+  if (options.apiKey) process.env.NIM_API_KEY = options.apiKey;
+  if (options.model) process.env.NIM_MODEL = options.model;
+  if (options.debug) process.env.LOG_LEVEL = 'debug';
+
+  if (!process.env.NIM_API_KEY?.trim()) {
+    const apiKey = await promptForApiKey();
+    saveNimApiKey(apiKey);
+    process.env.NIM_API_KEY = apiKey;
+    console.log('API key saved. Agent-Termo will remember it for future sessions.');
+  }
+
+  console.log(`Starting Agent-Termo in: ${project}`);
+  await runRepl(project);
+}
+
 program
   .name('agent-termo')
   .description('Terminal AI coding agent with Nvidia NIM APIs')
-  .version('1.0.0')
+  .version('1.0.2')
   .argument('[project]', 'Project directory to operate in', process.cwd())
   .option('-k, --api-key <key>', 'Nvidia NIM API key')
   .option('-m, --model <model>', 'Model name to use')
   .option('--debug', 'Enable debug logging')
   .action(async (project: string, options: { apiKey?: string; model?: string; debug?: boolean }) => {
-    // Apply CLI overrides to env before main initializes
-    if (options.apiKey) process.env.NIM_API_KEY = options.apiKey;
-    if (options.model) process.env.NIM_MODEL = options.model;
-    if (options.debug) process.env.LOG_LEVEL = 'debug';
-
-    console.log(`Starting Agent-Termo in: ${project}`);
-    await runRepl(project);
+    await startAgent(project, options);
   });
 
 program
@@ -56,14 +135,14 @@ program
 
     console.log(`\n✓ Initialized Agent-Termo in ${resolve(dir)}`);
     console.log('  Created: docs/MEMORY.md, docs/TIMELINE.md');
-    console.log('  Create a .env file with your NIM_API_KEY to get started.');
+    console.log('  Agent-Termo will ask for your NVIDIA NIM API key the first time you launch it.');
   });
 
 async function main() {
-  // Check for unparsed arguments — if none, run repl mode
+  // Run REPL mode directly when no command or options are supplied.
   const args = process.argv.slice(2);
   if (args.length === 0) {
-    await runRepl(process.cwd());
+    await startAgent(process.cwd(), {});
     return;
   }
 
@@ -73,4 +152,4 @@ async function main() {
 main().catch((err) => {
   console.error(`\nFatal error: ${err instanceof Error ? err.message : err}`);
   process.exit(1);
-});
+});

package/src/llm/client.ts

@@ -4,6 +4,7 @@
 
 import OpenAI from 'openai';
 import type { ToolCall, ConversationMessage, ToolDef } from '../types/index.js';
+import { mergeModels, type ModelInfo } from './models.js';
 
 type NIMTool = OpenAI.Chat.ChatCompletionTool;
 
@@ -40,6 +41,29 @@ export class NimClient {
     return this.model;
   }
 
+  setModel(model: string): void {
+    this.model = model;
+  }
+
+  /**
+   * Fetch the models this API key can use. Never throws: on failure the curated
+   * list is returned with `live: false` and the reason in `error`.
+   */
+  async listModels(): Promise<{ models: ModelInfo[]; live: boolean; error?: string }> {
+    try {
+      const page = await this.client.models.list({ timeout: 10_000 });
+      const ids = page.data.map((m) => m.id);
+      if (ids.length === 0) throw new Error('empty model list');
+      return { models: mergeModels(ids), live: true };
+    } catch (err) {
+      return {
+        models: mergeModels(null),
+        live: false,
+        error: err instanceof Error ? err.message : String(err),
+      };
+    }
+  }
+
   /**
    * Streaming chat completion.
    * Handles Stepfun's quirks: filters "null" reasoning chunks, strips reasoning field.

package/src/llm/models.ts

@@ -0,0 +1,55 @@
+// =============================================================================
+// NVIDIA NIM model catalogue — curated suggestions + live /v1/models merge
+// =============================================================================
+
+export interface ModelInfo {
+  id: string;
+  note?: string;
+}
+
+/**
+ * Hand-picked chat/coding models worth surfacing first. This list is only a
+ * starting point: when the live catalogue is reachable, entries NIM no longer
+ * serves are dropped, and everything else NIM returns is still selectable.
+ */
+export const CURATED_MODELS: ModelInfo[] = [
+  { id: 'stepfun-ai/step-3.7-flash', note: 'default' },
+  { id: 'meta/llama-3.1-8b-instruct', note: 'fast, low cost' },
+  { id: 'meta/llama-3.1-70b-instruct', note: 'balanced' },
+  { id: 'meta/llama-3.3-70b-instruct', note: 'balanced' },
+  { id: 'meta/llama-3.1-405b-instruct', note: 'highest quality Llama' },
+  { id: 'nvidia/llama-3.1-nemotron-70b-instruct', note: 'NVIDIA tuned' },
+  { id: 'qwen/qwen2.5-coder-32b-instruct', note: 'coding' },
+  { id: 'deepseek-ai/deepseek-r1', note: 'reasoning' },
+  { id: 'moonshotai/kimi-k2-instruct', note: 'agentic / tool use' },
+  { id: 'openai/gpt-oss-120b', note: 'open-weight GPT' },
+];
+
+// NIM serves embedding, vision, speech and other non-chat models from the same
+// endpoint. Hide the obvious ones so the picker stays about chat models.
+const NON_CHAT =
+  /embed|rerank|retriev|reward|guard|safety|parse|clip|vila|neva|fuyu|kosmos|paligemma|deplot|riva|asr|tts|whisper|diffusion|sdxl|flux|cosmos|segment|bge-|e5-|gliner|pii|streampetr|ocdrnet|bevformer/i;
+
+export function isChatModel(id: string): boolean {
+  return !NON_CHAT.test(id);
+}
+
+/**
+ * Build the picker list.
+ * - live === null: the catalogue could not be fetched, so offer the curated list.
+ * - otherwise: curated entries that NIM serves first, then the rest of the live
+ *   chat models alphabetically.
+ */
+export function mergeModels(live: string[] | null): ModelInfo[] {
+  if (!live) return [...CURATED_MODELS];
+
+  const liveSet = new Set(live);
+  const curated = CURATED_MODELS.filter((m) => liveSet.has(m.id));
+  const curatedIds = new Set(curated.map((m) => m.id));
+  const rest = live
+    .filter((id) => !curatedIds.has(id) && isChatModel(id))
+    .sort((a, b) => a.localeCompare(b))
+    .map((id): ModelInfo => ({ id }));
+
+  return [...curated, ...rest];
+}