dexto 1.5.5 → 1.5.7

package/dist/cli/commands/setup.js

@@ -3,11 +3,13 @@ import chalk from 'chalk';
 import { z } from 'zod';
 import { getDefaultModelForProvider, LLM_PROVIDERS, LLM_REGISTRY, isValidProviderModel, getSupportedModels, acceptsAnyModel, supportsCustomModels, requiresApiKey, isReasoningCapableModel, } from '@dexto/core';
 import { resolveApiKeyForProvider } from '@dexto/core';
-import { createInitialPreferences, saveGlobalPreferences, loadGlobalPreferences, getGlobalPreferencesPath, updateGlobalPreferences, setActiveModel, } from '@dexto/agent-management';
+import { createInitialPreferences, saveGlobalPreferences, loadGlobalPreferences, getGlobalPreferencesPath, updateGlobalPreferences, setActiveModel, isDextoAuthEnabled, } from '@dexto/agent-management';
 import { interactiveApiKeySetup, hasApiKeyConfigured } from '../utils/api-key-setup.js';
 import { selectProvider, getProviderDisplayName, getProviderEnvVar, providerRequiresBaseURL, getDefaultModel, } from '../utils/provider-setup.js';
 import { setupLocalModels, setupOllamaModels, hasSelectedModel, getModelFromResult, } from '../utils/local-model-setup.js';
 import { requiresSetup } from '../utils/setup-utils.js';
+import { canUseDextoProvider } from '../utils/dexto-setup.js';
+import { handleBrowserLogin } from './auth/login.js';
 import * as p from '@clack/prompts';
 import { logger } from '@dexto/core';
 import { capture } from '../../analytics/index.js';
@@ -155,19 +157,90 @@ export async function handleSetupCommand(options) {
     await handleNonInteractiveSetup(validated);
 }
 /**
- * Quick start flow - uses Google Gemini with minimal prompts
+ * Quick start flow - pick a free provider with minimal prompts
  */
 async function handleQuickStart() {
-    console.log(chalk.cyan('\n🚀 Quick Start with Google Gemini\n'));
+    console.log(chalk.cyan('\n🚀 Quick Start\n'));
     p.intro(chalk.cyan('Quick Setup'));
-    const provider = 'google';
-    const model = getDefaultModelForProvider(provider) || 'gemini-2.5-pro';
+    // Let user pick from popular free providers
+    const quickProvider = await p.select({
+        message: 'Choose a provider',
+        options: [
+            {
+                value: 'google',
+                label: `${chalk.green('●')} Google Gemini`,
+                hint: 'Free, 1M+ context (recommended)',
+            },
+            {
+                value: 'groq',
+                label: `${chalk.green('●')} Groq`,
+                hint: 'Free, ultra-fast',
+            },
+            {
+                value: 'local',
+                label: `${chalk.cyan('●')} Local Models`,
+                hint: 'Free, private, runs on your machine',
+            },
+        ],
+    });
+    if (p.isCancel(quickProvider)) {
+        p.cancel('Setup cancelled');
+        process.exit(0);
+    }
+    // Handle local models with dedicated setup flow
+    if (quickProvider === 'local') {
+        const localResult = await setupLocalModels();
+        if (!hasSelectedModel(localResult)) {
+            p.cancel('Setup cancelled');
+            process.exit(0);
+        }
+        const model = getModelFromResult(localResult);
+        // CLI mode confirmation for local
+        const useCli = await p.confirm({
+            message: 'Start in Terminal mode? (You can change this later)',
+            initialValue: true,
+        });
+        if (p.isCancel(useCli)) {
+            p.cancel('Setup cancelled');
+            process.exit(0);
+        }
+        const defaultMode = useCli ? 'cli' : await selectDefaultMode();
+        if (defaultMode === null) {
+            p.cancel('Setup cancelled');
+            process.exit(0);
+        }
+        // Sync the active model for local provider
+        await setActiveModel(model);
+        const preferences = createInitialPreferences({
+            provider: 'local',
+            model,
+            defaultMode,
+            setupCompleted: true,
+            apiKeyPending: false,
+        });
+        await saveGlobalPreferences(preferences);
+        capture('dexto_setup', {
+            provider: 'local',
+            model,
+            setupMode: 'interactive',
+            setupVariant: 'quick-start',
+            defaultMode,
+            apiKeySkipped: false,
+        });
+        await showSetupComplete('local', model, defaultMode, false);
+        return;
+    }
+    // Cloud provider flow (google or groq)
+    const provider = quickProvider;
+    const model = getDefaultModelForProvider(provider) ||
+        (provider === 'google' ? 'gemini-2.5-pro' : 'llama-3.3-70b-versatile');
     const apiKeyVar = getProviderEnvVar(provider);
     let apiKeySkipped = false;
     // Check if API key exists
     const hasKey = hasApiKeyConfigured(provider);
     if (!hasKey) {
-        p.note(`Google Gemini is ${chalk.green('free')} to use!\n\n` +
+        const providerName = getProviderDisplayName(provider);
+        p.note(`${providerName} is ${chalk.green('free')} to use!\n\n` +
             `We'll help you get an API key in just a few seconds.`, 'Free AI Access');
         const result = await interactiveApiKeySetup(provider, {
             exitOnCancel: false, // Don't exit - allow skipping
@@ -184,8 +257,16 @@ async function handleQuickStart() {
     else {
         p.log.success(`API key for ${getProviderDisplayName(provider)} already configured`);
     }
-    // Ask about default mode
-    const defaultMode = await selectDefaultMode();
+    // CLI mode confirmation
+    const useCli = await p.confirm({
+        message: 'Start in Terminal mode? (You can change this later)',
+        initialValue: true,
+    });
+    if (p.isCancel(useCli)) {
+        p.cancel('Setup cancelled');
+        process.exit(0);
+    }
+    const defaultMode = useCli ? 'cli' : await selectDefaultMode();
     // Handle cancellation
     if (defaultMode === null) {
         p.cancel('Setup cancelled');
@@ -213,7 +294,153 @@ async function handleQuickStart() {
         defaultMode,
         apiKeySkipped,
     });
-    showSetupComplete(provider, model, defaultMode, apiKeySkipped);
+    await showSetupComplete(provider, model, defaultMode, apiKeySkipped);
+}
+/**
+ * Dexto setup flow - login if needed, select model, save preferences
+ *
+ * Config storage:
+ * - provider: 'dexto' (the gateway provider)
+ * - model: OpenRouter-style ID (e.g., 'anthropic/claude-haiku-4.5')
+ *
+ * Runtime handles routing requests through the Dexto gateway to the underlying provider.
+ */
+async function handleDextoProviderSetup() {
+    console.log(chalk.magenta('\n★ Dexto Setup\n'));
+    // Check if user already has DEXTO_API_KEY
+    const hasKey = await canUseDextoProvider();
+    if (!hasKey) {
+        p.note(`Dexto gives you instant access to ${chalk.cyan('all AI models')} with a single account.\n\n` +
+            `We'll open your browser to sign in or create an account.`, 'Login Required');
+        const shouldLogin = await p.confirm({
+            message: 'Continue with browser login?',
+            initialValue: true,
+        });
+        if (p.isCancel(shouldLogin) || !shouldLogin) {
+            p.cancel('Setup cancelled');
+            process.exit(0);
+        }
+        try {
+            await handleBrowserLogin();
+            // Verify key was actually provisioned (provisionKeys silently catches errors)
+            if (!(await canUseDextoProvider())) {
+                p.log.error('API key provisioning failed. Please try again or use `dexto setup` with a different provider.');
+                process.exit(1);
+            }
+            p.log.success('Login successful! Continuing with setup...');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            p.log.error(`Login failed: ${errorMessage}`);
+            p.cancel('Setup cancelled - login required for Dexto');
+            process.exit(1);
+        }
+    }
+    else {
+        p.log.success('Already logged in to Dexto');
+    }
+    // Model selection - show popular models in OpenRouter format
+    // NOTE: This list is intentionally hardcoded (not from registry) to include
+    // curated hints for onboarding UX. Keep model IDs in sync with:
+    // packages/core/src/llm/registry.ts (LLM_REGISTRY.dexto.models)
+    const model = await p.select({
+        message: 'Select a model to start with',
+        options: [
+            // Claude models (Anthropic via Dexto gateway)
+            {
+                value: 'anthropic/claude-haiku-4.5',
+                label: 'Claude 4.5 Haiku',
+                hint: 'Fast & affordable (recommended)',
+            },
+            {
+                value: 'anthropic/claude-sonnet-4.5',
+                label: 'Claude 4.5 Sonnet',
+                hint: 'Balanced performance and cost',
+            },
+            {
+                value: 'anthropic/claude-opus-4.5',
+                label: 'Claude 4.5 Opus',
+                hint: 'Most capable Claude model',
+            },
+            // OpenAI models (via Dexto gateway)
+            {
+                value: 'openai/gpt-5.2',
+                label: 'GPT-5.2',
+                hint: 'OpenAI flagship model',
+            },
+            {
+                value: 'openai/gpt-5.2-codex',
+                label: 'GPT-5.2 Codex',
+                hint: 'Optimized for coding',
+            },
+            // Google models (via Dexto gateway)
+            {
+                value: 'google/gemini-3-pro-preview',
+                label: 'Gemini 3 Pro',
+                hint: 'Google flagship model',
+            },
+            {
+                value: 'google/gemini-3-flash-preview',
+                label: 'Gemini 3 Flash',
+                hint: 'Fast and efficient',
+            },
+            // Free models (via Dexto gateway)
+            {
+                value: 'qwen/qwen3-coder:free',
+                label: 'Qwen3 Coder (Free)',
+                hint: 'Free coding model, 262k context',
+            },
+            {
+                value: 'deepseek/deepseek-r1-0528:free',
+                label: 'DeepSeek R1 (Free)',
+                hint: 'Free reasoning model, 163k context',
+            },
+            // Other models (via Dexto gateway)
+            {
+                value: 'z-ai/glm-4.7',
+                label: 'GLM 4.7',
+                hint: 'Zhipu AI flagship model',
+            },
+            {
+                value: 'minimax/minimax-m2.1',
+                label: 'Minimax M2.1',
+                hint: 'Fast model with 196k context',
+            },
+        ],
+    });
+    if (p.isCancel(model)) {
+        p.cancel('Setup cancelled');
+        process.exit(0);
+    }
+    // Dexto setup always uses 'dexto' provider with OpenRouter model IDs
+    const provider = 'dexto';
+    // Cast model to string (prompts library typing)
+    const selectedModel = model;
+    p.log.info(`${chalk.dim('Tip:')} You can switch models anytime with ${chalk.cyan('/model')}`);
+    // Ask about default mode
+    const defaultMode = await selectDefaultMode();
+    if (defaultMode === null) {
+        p.cancel('Setup cancelled');
+        process.exit(0);
+    }
+    // Save preferences with explicit dexto provider and OpenRouter model ID
+    const preferences = createInitialPreferences({
+        provider,
+        model: selectedModel,
+        defaultMode,
+        setupCompleted: true,
+        apiKeyPending: false,
+        apiKeyVar: 'DEXTO_API_KEY',
+    });
+    await saveGlobalPreferences(preferences);
+    capture('dexto_setup', {
+        provider,
+        model: selectedModel,
+        setupMode: 'interactive',
+        setupVariant: 'dexto',
+        defaultMode,
+    });
+    await showSetupComplete(provider, selectedModel, defaultMode, false);
 }
 /**
  * Full interactive setup flow with wizard navigation.
@@ -257,25 +484,37 @@ async function handleInteractiveSetup(_options) {
  * Wizard Step: Setup Type (Quick Start vs Custom)
  */
 async function wizardStepSetupType(state) {
+    // Build options list - only show Dexto Credits when feature is enabled
+    const options = [];
+    if (isDextoAuthEnabled()) {
+        options.push({
+            value: 'dexto',
+            label: `${chalk.magenta('★')} Dexto Credits`,
+            hint: 'All models, one account - login to get started (recommended)',
+        });
+    }
+    options.push({
+        value: 'quick',
+        label: `${chalk.green('●')} Quick Start`,
+        hint: 'Google Gemini (free) - no account needed',
+    }, {
+        value: 'custom',
+        label: `${chalk.blue('●')} Custom Setup`,
+        hint: 'Choose your provider (OpenAI, Anthropic, Ollama, etc.)',
+    });
     const setupType = await p.select({
         message: 'How would you like to set up Dexto?',
-        options: [
-            {
-                value: 'quick',
-                label: `${chalk.green('●')} Quick Start`,
-                hint: 'Google Gemini (free) - recommended for new users',
-            },
-            {
-                value: 'custom',
-                label: `${chalk.blue('●')} Custom Setup`,
-                hint: 'Choose your provider (OpenAI, Anthropic, Ollama, etc.)',
-            },
-        ],
+        options,
     });
     if (p.isCancel(setupType)) {
         p.cancel('Setup cancelled');
         process.exit(0);
     }
+    if (setupType === 'dexto') {
+        // Handle Dexto Credits flow - login if needed, then proceed to model selection
+        await handleDextoProviderSetup();
+        return { ...state, step: 'complete', quickStartHandled: true };
+    }
     if (setupType === 'quick') {
         // Quick start bypasses the wizard - handle it directly
         await handleQuickStart();
@@ -494,18 +733,18 @@ async function selectDefaultModeWithBack() {
         options: [
             {
                 value: 'cli',
-                label: `${chalk.green('●')} Terminal CLI`,
-                hint: 'Interactive command-line interface (recommended)',
+                label: `${chalk.green('●')} Terminal`,
+                hint: 'Chat in your terminal (most popular)',
             },
             {
                 value: 'web',
-                label: `${chalk.blue('●')} Web UI`,
-                hint: 'Opens in browser at localhost:3000',
+                label: `${chalk.blue('●')} Browser`,
+                hint: 'Web UI at localhost:3000',
             },
             {
                 value: 'server',
-                label: `${chalk.rgb(255, 165, 0)('●')} API Server`,
-                hint: 'REST API for programmatic access',
+                label: `${chalk.cyan('●')} API Server`,
+                hint: 'REST API for integrations',
             },
             { value: '_back', label: chalk.gray('← Back'), hint: 'Go to previous step' },
         ],
@@ -558,7 +797,7 @@ async function saveWizardPreferences(state) {
         hasBaseURL: Boolean(state.baseURL),
         apiKeySkipped,
     });
-    showSetupComplete(provider, model, defaultMode, apiKeySkipped);
+    await showSetupComplete(provider, model, defaultMode, apiKeySkipped);
 }
 /**
  * Non-interactive setup with CLI options
@@ -661,7 +900,7 @@ async function showSettingsMenu() {
         });
         // Exit conditions
         if (p.isCancel(action) || action === 'exit') {
-            p.outro(chalk.gray('Settings closed'));
+            p.outro(`Run ${chalk.cyan('dexto')} to start Dexto`);
             return;
         }
         // Execute action and loop back (except for reset which exits)
@@ -695,7 +934,40 @@ async function showSettingsMenu() {
  * Change model setting (includes provider selection)
  */
 async function changeModel(currentProvider) {
-    const provider = currentProvider || (await selectProvider());
+    let provider = currentProvider ?? null;
+    // If no provider specified, show selection
+    // When Dexto auth is enabled, show Dexto/Other choice first (matching first-time setup flow)
+    if (!provider && isDextoAuthEnabled()) {
+        const providerChoice = await p.select({
+            message: 'Choose your model source',
+            options: [
+                {
+                    value: 'dexto',
+                    label: `${chalk.magenta('★')} Dexto Credits`,
+                    hint: 'All models, one account',
+                },
+                {
+                    value: 'other',
+                    label: `${chalk.blue('●')} Other providers`,
+                    hint: 'OpenAI, Anthropic, Gemini, Ollama, etc.',
+                },
+            ],
+        });
+        if (p.isCancel(providerChoice)) {
+            p.log.warn('Model change cancelled');
+            return;
+        }
+        if (providerChoice === 'dexto') {
+            // Use the same Dexto setup flow as first-time setup
+            await handleDextoProviderSetup();
+            return;
+        }
+        // 'other' - fall through to normal provider selection
+    }
+    // Get provider if not already set
+    if (!provider) {
+        provider = await selectProvider();
+    }
     // Handle cancellation or back from selectProvider
     if (provider === null || provider === '_back') {
         p.log.warn('Model change cancelled');
@@ -758,6 +1030,22 @@ async function changeModel(currentProvider) {
     }
     const apiKeyVar = getProviderEnvVar(provider);
     const needsApiKey = requiresApiKey(provider);
+    const hasKey = hasApiKeyConfigured(provider);
+    // Check if API key is needed and missing - prompt for it
+    if (needsApiKey && !hasKey) {
+        const result = await interactiveApiKeySetup(provider, {
+            exitOnCancel: false,
+            model,
+        });
+        if (result.cancelled) {
+            p.log.warn('Model change cancelled');
+            return;
+        }
+        // If user skipped API key setup, still allow model change but warn
+        if (result.skipped || !result.success) {
+            p.log.warn(`API key setup was skipped. You'll need to configure ${apiKeyVar} before using this model.`);
+        }
+    }
     const llmUpdate = {
         provider,
         model,
@@ -892,18 +1180,18 @@ async function selectDefaultMode() {
         options: [
             {
                 value: 'cli',
-                label: `${chalk.green('●')} Terminal CLI`,
-                hint: 'Interactive command-line interface (recommended)',
+                label: `${chalk.green('●')} Terminal`,
+                hint: 'Chat in your terminal (most popular)',
             },
             {
                 value: 'web',
-                label: `${chalk.blue('●')} Web UI`,
-                hint: 'Opens in browser at localhost:3000',
+                label: `${chalk.blue('●')} Browser`,
+                hint: 'Web UI at localhost:3000',
             },
             {
                 value: 'server',
-                label: `${chalk.rgb(255, 165, 0)('●')} API Server`,
-                hint: 'REST API for programmatic access',
+                label: `${chalk.cyan('●')} API Server`,
+                hint: 'REST API for integrations',
             },
         ],
     });
@@ -1024,7 +1312,7 @@ async function promptForBaseURL(provider) {
 /**
  * Show setup complete message
  */
-function showSetupComplete(provider, model, defaultMode, apiKeySkipped = false) {
+async function showSetupComplete(provider, model, defaultMode, apiKeySkipped = false) {
     const modeCommand = defaultMode === 'web' ? 'dexto' : `dexto --mode ${defaultMode}`;
     const isLocalProvider = provider === 'local' || provider === 'ollama';
     if (apiKeySkipped) {

package/dist/cli/commands/sync-agents.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Options for the sync-agents command
+ */
+export interface SyncAgentsCommandOptions {
+    /** Just list status without updating */
+    list?: boolean;
+    /** Update all without prompting */
+    force?: boolean;
+    /** Minimal output - used when called from startup prompt */
+    quiet?: boolean;
+}
+/**
+ * Mark sync as dismissed for current version
+ */
+export declare function markSyncDismissed(currentVersion: string): Promise<void>;
+/**
+ * Clear sync dismissed state (called after successful sync)
+ */
+export declare function clearSyncDismissed(): Promise<void>;
+/**
+ * Quick check if any installed agents have updates available
+ *
+ * Used at CLI startup to prompt for sync without full command output.
+ * Returns true if at least one installed agent differs from bundled
+ * AND the user hasn't dismissed the prompt for this version.
+ *
+ * @param currentVersion Current CLI version to check dismissal state
+ * @returns true if should prompt for sync
+ */
+export declare function shouldPromptForSync(currentVersion: string): Promise<boolean>;
+/**
+ * Main handler for the sync-agents command
+ *
+ * @param options Command options
+ *
+ * @example
+ * ```bash
+ * dexto sync-agents          # Interactive - prompt for each
+ * dexto sync-agents --list   # Show what would be updated
+ * dexto sync-agents --force  # Update all without prompting
+ * ```
+ */
+export declare function handleSyncAgentsCommand(options: SyncAgentsCommandOptions): Promise<void>;
+//# sourceMappingURL=sync-agents.d.ts.map

package/dist/cli/commands/sync-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-agents.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync-agents.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAgND;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWxD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BlF;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiO9F"}