@compilr-dev/cli 0.10.1 → 0.10.2

package/dist/guide/shared-content.js

@@ -8,6 +8,7 @@
  * Content is stored as plain text with simple structure.
  * Styling is applied at render time by each consumer.
  */
+import { imageProviderNames } from '../models/model-registry.js';
 // =============================================================================
 // Content Topics
 // =============================================================================
@@ -1296,7 +1297,7 @@ export const CONTENT_TOPICS = [
                     'Images are resized to max 1568px to save tokens',
                     'After a few turns, old images are replaced with text placeholders',
                     'The agent can also view image files on disk via the view_image tool',
-                    'All major providers support vision: Claude, GPT-4o, Gemini',
+                    `Which models can see an image comes from the registry: ${imageProviderNames()}`,
                 ],
             },
         ],

package/dist/index.js

@@ -117,8 +117,8 @@ Other Environment Variables:
 
 Examples:
   compilr                                          Start with auto-detected provider
-  compilr --model claude-sonnet-4-6                Use a specific model
-  compilr --provider gemini --model gemini-2.5-flash
+  compilr --model ${getDefaultModel('claude')}${' '.repeat(Math.max(1, 33 - getDefaultModel('claude').length))}Use a specific model
+  compilr --provider gemini --model ${getDefaultModel('gemini')}
   compilr --minimal --show-filtering               Minimal tools with analysis
   compilr --update                                 Check for updates
 `);

package/dist/models/model-registry.d.ts

@@ -36,3 +36,9 @@ export declare function getDefaultModelsForProvider(provider: ProviderType): Mod
  * Get all models for a provider (including non-defaults), formatted for UI overlays.
  */
 export declare function getAllModelsForProviderUI(provider: ProviderType): ModelOptionForUI[];
+/** "Haiku 4.5, GPT-6 Luna, Gemini 3.5 Flash Lite" — the current line-up for one tier. */
+export declare function tierModelExamples(tier: ModelTier, providers?: readonly string[]): string;
+/** The current default model's display name for a tier and provider: "Sonnet 5.5". */
+export declare function tierModelName(provider: string, tier: ModelTier): string;
+/** "Claude, OpenAI, Gemini" — the providers whose current models accept images. */
+export declare function imageProviderNames(): string;

package/dist/models/model-registry.js

@@ -68,3 +68,37 @@ export function getAllModelsForProviderUI(provider) {
         tier: m.defaultTier,
     }));
 }
+// =============================================================================
+// Tutorial / help text helpers
+// =============================================================================
+/*
+  ⚠️ MODEL NAMES IN TUTORIAL TEXT ARE DERIVED, NEVER TYPED IN.
+
+  The tutorials used to name models in prose and in their screen mock-ups — "Haiku, GPT-4o-mini",
+  "Sonnet, GPT-4o", "Opus, o1", "Model: gemini-2.5-flash". All retired, and the tutorials are
+  what a new user follows on their first day: a stale model there sends them looking for a model
+  that no longer exists and reads as the tool being broken.
+
+  A current tier model is one with a `defaultTier` — the registry keeps older ids addressable but
+  untiered, which is exactly the line to draw for a "here is what to pick" tutorial.
+*/
+/** "Haiku 4.5, GPT-6 Luna, Gemini 3.5 Flash Lite" — the current line-up for one tier. */
+export function tierModelExamples(tier, providers = ['claude', 'openai', 'gemini']) {
+    const names = providers.flatMap((p) => MODEL_REGISTRY.filter((m) => m.provider === p && m.defaultTier === tier).map((m) => m.displayName));
+    return names.join(', ');
+}
+/** The current default model's display name for a tier and provider: "Sonnet 5.5". */
+export function tierModelName(provider, tier) {
+    return (MODEL_REGISTRY.find((m) => m.provider === provider && m.defaultTier === tier)?.displayName ?? '');
+}
+/** "Claude, OpenAI, Gemini" — the providers whose current models accept images. */
+export function imageProviderNames() {
+    const seen = [];
+    for (const m of MODEL_REGISTRY) {
+        if (m.supportsImages && m.defaultTier !== undefined && !seen.includes(m.provider)) {
+            seen.push(m.provider);
+        }
+    }
+    const label = { claude: 'Claude', openai: 'OpenAI', gemini: 'Gemini' };
+    return seen.map((p) => label[p] ?? p).join(', ');
+}

package/dist/tools/db-tools.d.ts

@@ -10,7 +10,7 @@ export { getActiveProject, setActiveProject } from './project-db.js';
 /**
  * All database tools combined (32 tools from SDK)
  */
-export declare const allDbTools: import("@compilr-dev/agents").Tool<never>[];
+export declare const allDbTools: import("@compilr-dev/sdk").Tool<never>[];
 /**
  * All factory tools (5 tools from @compilr-dev/factory)
  */

package/dist/ui/overlay/data/tutorials/basics/first-conversation.js

@@ -3,6 +3,7 @@
  *
  * How to interact with the AI in REPL mode.
  */
+import { getDefaultModelForTier } from '../../../../../models/model-registry.js';
 export const firstConversationTutorial = (s) => ({
     id: 'first-conversation',
     title: 'Your First Conversation',
@@ -41,7 +42,7 @@ export const firstConversationTutorial = (s) => ({
                 '',
                 `    ${s.muted('✓ Agent connected')}`,
                 '',
-                `    ${s.muted('Model: gemini-2.5-flash')}`,
+                `    ${s.muted(`Model: ${getDefaultModelForTier('gemini', 'balanced')?.id ?? ''}`)}`,
                 `    ${s.muted('Provider: gemini')}`,
                 `    ${s.muted('[^_^] Switched to project: My First Project')}`,
                 '',

package/dist/ui/overlay/data/tutorials/basics/image-support.js

@@ -4,6 +4,7 @@
  * How to share images (screenshots, mockups, diagrams) with the agent
  * for visual analysis.
  */
+import { imageProviderNames } from '../../../../../models/model-registry.js';
 export const imageSupportTutorial = (s) => ({
     id: 'image-support',
     title: 'Image Support',
@@ -28,7 +29,7 @@ export const imageSupportTutorial = (s) => ({
                 '',
                 `    ${s.primaryBold('PNG')} · ${s.primaryBold('JPEG')} · ${s.primaryBold('GIF')} · ${s.primaryBold('WebP')}`,
                 '',
-                `  ${s.secondary('Supported by:')} Claude, GPT-4o, Gemini (all major vision models)`,
+                `  ${s.secondary('Supported by:')} ${imageProviderNames()} (from the model registry)`,
                 '',
             ],
         },

package/dist/ui/overlay/data/tutorials/config/model-selection.js

@@ -3,6 +3,7 @@
  *
  * Covers the /model overlay: provider tabs, tiers, API keys, model cycling.
  */
+import { tierModelExamples, tierModelName } from '../../../../../models/model-registry.js';
 export const modelSelectionTutorial = (s) => ({
     id: 'model-selection',
     title: 'Model Selection',
@@ -44,9 +45,9 @@ export const modelSelectionTutorial = (s) => ({
                 '',
                 `  ${s.success('●')} API Key: Set`,
                 '',
-                `  ${s.primary('>')} ${s.success('●')} Fast          Haiku 4.5              (active)`,
-                `    ${s.success('●')} Balanced      Sonnet 4.5`,
-                `    ${s.success('●')} Powerful      Opus 4.5`,
+                `  ${s.primary('>')} ${s.success('●')} Fast          ${tierModelName('claude', 'fast')}${' '.repeat(Math.max(1, 23 - tierModelName('claude', 'fast').length))}(active)`,
+                `    ${s.success('●')} Balanced      ${tierModelName('claude', 'balanced')}`,
+                `    ${s.success('●')} Powerful      ${tierModelName('claude', 'powerful')}`,
                 '',
                 `  ${s.muted('Status indicators:')}`,
                 `    ${s.success('●')} API key set / Ollama installed`,
@@ -139,13 +140,13 @@ export const modelSelectionTutorial = (s) => ({
                 '',
                 `  ${s.warning('TIP:')} Match the model to the task:`,
                 '',
-                `    ${s.primary('Fast')} tier ${s.muted('(Haiku, GPT-4o-mini)')}`,
+                `    ${s.primary('Fast')} tier ${s.muted(`(${tierModelExamples('fast')})`)}`,
                 `      Simple questions, quick edits, file reads`,
                 '',
-                `    ${s.primary('Balanced')} tier ${s.muted('(Sonnet, GPT-4o)')}`,
+                `    ${s.primary('Balanced')} tier ${s.muted(`(${tierModelExamples('balanced')})`)}`,
                 `      Feature implementation, debugging, code review`,
                 '',
-                `    ${s.primary('Powerful')} tier ${s.muted('(Opus, o1)')}`,
+                `    ${s.primary('Powerful')} tier ${s.muted(`(${tierModelExamples('powerful')})`)}`,
                 `      Architecture decisions, complex refactoring`,
                 '',
                 `  ${s.warning('TIP:')} Team agents can use different tiers.`,

package/dist/ui/overlay/data/tutorials/teams/working-with-agents.js

@@ -3,6 +3,7 @@
  *
  * Covers $ prefix switching, autocomplete, custom agents, and tool profiles.
  */
+import { tierModelExamples } from '../../../../../models/model-registry.js';
 export const workingWithAgentsTutorial = (s) => ({
     id: 'working-with-agents',
     title: 'Working with Agents',
@@ -95,10 +96,10 @@ export const workingWithAgentsTutorial = (s) => ({
                 `  Each agent has a ${s.primaryBold('model tier')} setting:`,
                 '',
                 `    ${s.primaryBold('Fast')}        Quick responses, low cost`,
-                `    ${s.muted('             Claude Haiku, GPT-4o Mini, Gemini Flash')}`,
+                `    ${s.muted(`             ${tierModelExamples('fast')}`)}`,
                 '',
                 `    ${s.primaryBold('Balanced')}    Good quality/speed balance (default)`,
-                `    ${s.muted('             Claude Sonnet, GPT-4o, Gemini Pro')}`,
+                `    ${s.muted(`             ${tierModelExamples('balanced')}`)}`,
                 '',
                 `    ${s.primaryBold('Powerful')}    Maximum capability`,
                 `    ${s.muted('             Claude Opus, GPT-4, Gemini Ultra')}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -55,12 +55,12 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
-    "@compilr-dev/agents": "^0.6.8",
+    "@compilr-dev/agents": "^0.8.0",
     "@compilr-dev/agents-coding": "^1.0.4",
     "@compilr-dev/editor-core": "^0.0.3",
     "@compilr-dev/factory": "^0.1.35",
     "@compilr-dev/logger": "^0.1.0",
-    "@compilr-dev/sdk": "^0.33.0",
+    "@compilr-dev/sdk": "^0.35.0",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "ansi-escapes": "^7.3.0",