@phuetz/code-buddy 1.1.0 → 1.3.0

package/dist/wizard/provider-onboarding.js

@@ -1,12 +1,13 @@
 /**
- * Provider Onboarding
+ * Provider validation library
  *
- * Guided setup for AI providers with API key validation.
- * Each provider config defines the env key, base URL, and a validation
- * endpoint that is probed with a GET request to confirm the key works.
+ * Shared key/endpoint validation used by the onboarding wizard
+ * (`src/wizard/onboarding.ts`). Each provider config defines the env key, base
+ * URL, and a GET validation endpoint that is probed to confirm the key works
+ * AND to list the provider's available models — the same mechanism Hermes uses
+ * during `hermes setup` so onboarding fails fast on a bad key instead of
+ * persisting it and breaking the first chat.
  */
-import * as readline from 'readline';
-import { logger } from '../utils/logger.js';
 // ============================================================================
 // Provider Configs
 // ============================================================================
@@ -38,7 +39,7 @@ export const PROVIDER_CONFIGS = [
     {
         id: 'google',
         name: 'Google (Gemini)',
-        envKey: 'GOOGLE_API_KEY',
+        envKey: 'GEMINI_API_KEY',
         baseUrl: 'https://generativelanguage.googleapis.com',
         validateEndpoint: '/v1beta/models',
         instructions: 'Get your API key from https://aistudio.google.com/apikey',
@@ -68,6 +69,28 @@ export const PROVIDER_CONFIGS = [
         instructions: 'Install LM Studio from https://lmstudio.ai and start the server',
     },
 ];
+/**
+ * Map an onboarding-wizard provider id (`src/wizard/onboarding.ts`
+ * PROVIDER_GUIDES) to its validation config. The wizard uses friendlier ids
+ * (`claude`, `gemini`) than the catalog (`anthropic`, `google`), so alias them.
+ * OAuth/unsupported wizard ids (`chatgpt`) return undefined — they don't carry
+ * an API key to validate against a `/models` endpoint.
+ */
+const GUIDE_ID_TO_CONFIG_ID = {
+    grok: 'grok',
+    openai: 'openai',
+    claude: 'anthropic',
+    anthropic: 'anthropic',
+    gemini: 'google',
+    google: 'google',
+    ollama: 'ollama',
+    lmstudio: 'lmstudio',
+    openrouter: 'openrouter',
+};
+export function getValidationConfigForGuide(guideId) {
+    const configId = GUIDE_ID_TO_CONFIG_ID[guideId];
+    return configId ? getProviderConfig(configId) : undefined;
+}
 // ============================================================================
 // Validation
 // ============================================================================
@@ -114,7 +137,15 @@ export async function validateProviderKey(config, apiKey) {
     }
     if (!response.ok) {
         const errorText = await response.text().catch(() => '');
-        if (response.status === 401 || response.status === 403) {
+        // Classify clear auth failures uniformly — providers are inconsistent:
+        // OpenAI/Anthropic return 401/403, but xAI returns 400 "Incorrect API key
+        // provided". Without this, a plainly-bad key looks like a network blip and
+        // the wizard would offer to save it anyway.
+        const looksLikeBadKey = response.status === 401 ||
+            response.status === 403 ||
+            (response.status === 400 &&
+                /incorrect api key|invalid api key|invalid.*key|unauthor|api key/i.test(errorText));
+        if (looksLikeBadKey) {
             return { valid: false, error: 'Invalid API key (authentication failed)' };
         }
         return {
@@ -151,160 +182,10 @@ async function extractModels(config, response) {
         return [];
     }
 }
-// ============================================================================
-// Interactive Onboarding
-// ============================================================================
-/**
- * Run interactive onboarding for a specific provider.
- * Prompts for API key, validates it, and saves to the environment.
- */
-export async function runProviderOnboarding(providerId) {
-    const config = PROVIDER_CONFIGS.find((c) => c.id === providerId);
-    if (!config) {
-        logger.error(`Unknown provider: ${providerId}`);
-        return false;
-    }
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    const ask = (question) => new Promise((resolve) => {
-        rl.question(`  ${question}`, (answer) => resolve(answer.trim()));
-    });
-    try {
-        console.log('');
-        console.log(`  === ${config.name} Setup ===`);
-        console.log('');
-        console.log(`  ${config.instructions}`);
-        console.log('');
-        // Check if already configured
-        const existingKey = process.env[config.envKey];
-        if (existingKey) {
-            console.log(`  ${config.envKey} is already set in your environment.`);
-            const revalidate = await ask('  Validate existing key? (y/n) [y]: ');
-            if (revalidate.toLowerCase() !== 'n') {
-                console.log('  Validating...');
-                const result = await validateProviderKey(config, existingKey);
-                if (result.valid) {
-                    console.log('  Key is valid!');
-                    if (result.models && result.models.length > 0) {
-                        console.log(`  Available models: ${result.models.slice(0, 5).join(', ')}${result.models.length > 5 ? '...' : ''}`);
-                    }
-                    rl.close();
-                    return true;
-                }
-                console.log(`  Validation failed: ${result.error}`);
-            }
-        }
-        // Local providers (Ollama, LM Studio) check connectivity only
-        if (config.id === 'ollama' || config.id === 'lmstudio') {
-            console.log(`  Checking ${config.name} connectivity...`);
-            const host = config.id === 'ollama'
-                ? process.env.OLLAMA_HOST || config.baseUrl
-                : process.env.LMSTUDIO_HOST || config.baseUrl;
-            const result = await validateProviderKey({ ...config, baseUrl: host }, '');
-            if (result.valid) {
-                console.log(`  ${config.name} is running and accessible!`);
-                if (result.models && result.models.length > 0) {
-                    console.log(`  Available models: ${result.models.join(', ')}`);
-                }
-                rl.close();
-                return true;
-            }
-            console.log(`  Could not connect: ${result.error}`);
-            console.log(`  Make sure ${config.name} is running.`);
-            rl.close();
-            return false;
-        }
-        // Prompt for API key
-        const apiKey = await ask(`  Enter your ${config.name} API key: `);
-        if (!apiKey) {
-            console.log('  No API key provided. Skipping validation.');
-            rl.close();
-            return false;
-        }
-        // Validate
-        console.log('  Validating...');
-        const result = await validateProviderKey(config, apiKey);
-        if (!result.valid) {
-            console.log(`  Validation failed: ${result.error}`);
-            console.log('');
-            console.log('  The key was not saved. Please check your API key and try again.');
-            rl.close();
-            return false;
-        }
-        console.log('  Key is valid!');
-        if (result.models && result.models.length > 0) {
-            console.log(`  Available models: ${result.models.slice(0, 5).join(', ')}${result.models.length > 5 ? ` (+${result.models.length - 5} more)` : ''}`);
-        }
-        // Set in process environment (for current session)
-        process.env[config.envKey] = apiKey;
-        console.log('');
-        console.log(`  ${config.envKey} set for this session.`);
-        console.log(`  To persist, add to your shell profile: export ${config.envKey}="${apiKey}"`);
-        console.log('');
-        rl.close();
-        return true;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logger.error('Provider onboarding failed', { provider: providerId, error: msg });
-        rl.close();
-        return false;
-    }
-}
-/**
- * Run interactive onboarding that lets the user choose a provider.
- */
-export async function runFullProviderOnboarding() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    const askChoice = (question, choices) => new Promise((resolve) => {
-        console.log(`\n  ${question}`);
-        choices.forEach((c, i) => console.log(`    ${i + 1}. ${c}`));
-        rl.question(`  Choice [1]: `, (answer) => {
-            const idx = parseInt(answer) - 1;
-            resolve(idx >= 0 && idx < choices.length ? idx : 0);
-        });
-    });
-    try {
-        console.log('');
-        console.log('  === Provider Onboarding ===');
-        console.log('');
-        const choiceIdx = await askChoice('Which AI provider would you like to set up?', PROVIDER_CONFIGS.map((c) => `${c.name} (${c.envKey})`));
-        rl.close();
-        const config = PROVIDER_CONFIGS[choiceIdx];
-        if (!config) {
-            logger.error('No provider configuration available to onboard');
-            return false;
-        }
-        return await runProviderOnboarding(config.id);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logger.error('Full provider onboarding failed', { error: msg });
-        rl.close();
-        return false;
-    }
-}
 /**
  * Get a provider config by ID.
  */
 export function getProviderConfig(providerId) {
     return PROVIDER_CONFIGS.find((c) => c.id === providerId);
 }
-/**
- * List all configured providers (those with env keys set).
- */
-export function listConfiguredProviders() {
-    return PROVIDER_CONFIGS.filter((c) => {
-        if (c.id === 'ollama' || c.id === 'lmstudio') {
-            // Local providers are always "available" (may not be running)
-            return true;
-        }
-        return !!process.env[c.envKey];
-    });
-}
 //# sourceMappingURL=provider-onboarding.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phuetz/code-buddy",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Open-source multi-provider AI coding agent for the terminal. Supports Grok, Claude, ChatGPT, Gemini, Ollama and LM Studio with 52+ tools, multi-channel messaging, skills system, and Enterprise-grade architecture.",
   "author": "Patrice Huetz <patrice.huetz@gmail.com>",
   "repository": {
@@ -69,6 +69,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:real": "RUN_REAL_TESTS=1 vitest run",
     "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
     "lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix",
     "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
@@ -137,6 +138,8 @@
     "@huggingface/transformers": "^4.2.0",
     "@iarna/toml": "^2.2.5",
     "@modelcontextprotocol/sdk": "^1.24.3",
+    "@ngrok/ngrok": "^1.7.0",
+    "@noble/curves": "^1.9.7",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.212.0",
     "@opentelemetry/instrumentation-http": "^0.212.0",
@@ -160,7 +163,6 @@
     "google-auth-library": "^10.6.2",
     "ignore": "^5.3.2",
     "ink": "^4.4.1",
-    "kokoro-js": "^1.2.1",
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "ml-matrix": "^6.12.2",

package/dist/plugins/provider-onboarding.d.ts

@@ -1,23 +0,0 @@
-/**
- * Provider Onboarding Orchestrator
- *
- * Runs the 5-phase provider onboarding lifecycle:
- *   1. auth          — validate credentials
- *   2. wizard.onboarding — interactive setup
- *   3. discovery.run — discover available models
- *   4. wizard.modelPicker — let user pick a model
- *   5. onModelSelected — post-selection hook
- *
- * Phases that are not implemented by the provider are silently skipped.
- * An auth failure short-circuits the entire pipeline.
- *
- * Native Engine v2026.3.19 — Provider Plugin Onboarding Architecture.
- */
-import type { PluginProvider, OnboardingResult } from './types.js';
-/**
- * Run the full provider onboarding lifecycle.
- *
- * @param provider - The plugin provider with optional onboarding hooks
- * @returns An OnboardingResult summarising the outcome
- */
-export declare function runProviderOnboarding(provider: PluginProvider): Promise<OnboardingResult>;

package/dist/plugins/provider-onboarding.js

@@ -1,116 +0,0 @@
-/**
- * Provider Onboarding Orchestrator
- *
- * Runs the 5-phase provider onboarding lifecycle:
- *   1. auth          — validate credentials
- *   2. wizard.onboarding — interactive setup
- *   3. discovery.run — discover available models
- *   4. wizard.modelPicker — let user pick a model
- *   5. onModelSelected — post-selection hook
- *
- * Phases that are not implemented by the provider are silently skipped.
- * An auth failure short-circuits the entire pipeline.
- *
- * Native Engine v2026.3.19 — Provider Plugin Onboarding Architecture.
- */
-import { logger } from '../utils/logger.js';
-/**
- * Run the full provider onboarding lifecycle.
- *
- * @param provider - The plugin provider with optional onboarding hooks
- * @returns An OnboardingResult summarising the outcome
- */
-export async function runProviderOnboarding(provider) {
-    const hooks = provider.onboarding;
-    if (!hooks) {
-        return { success: true, message: 'No onboarding hooks defined — skipped' };
-    }
-    const tag = `[onboarding:${provider.id}]`;
-    // ── Phase 1: auth ─────────────────────────────────────────────────────
-    if (hooks.auth) {
-        logger.debug(`${tag} Phase 1/5 — auth`);
-        try {
-            const authResult = await hooks.auth();
-            if (!authResult.valid) {
-                const reason = authResult.error ?? 'unknown auth error';
-                logger.warn(`${tag} Auth failed: ${reason}`);
-                return { success: false, message: `Auth failed: ${reason}` };
-            }
-            logger.debug(`${tag} Auth succeeded`);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`${tag} Auth threw: ${msg}`);
-            return { success: false, message: `Auth error: ${msg}` };
-        }
-    }
-    // ── Phase 2: wizard.onboarding ────────────────────────────────────────
-    let wizardConfig;
-    if (hooks['wizard.onboarding']) {
-        logger.debug(`${tag} Phase 2/5 — wizard.onboarding`);
-        try {
-            const wizardResult = await hooks['wizard.onboarding']();
-            if (!wizardResult.success) {
-                logger.warn(`${tag} Onboarding wizard failed: ${wizardResult.message ?? 'unknown'}`);
-                return wizardResult;
-            }
-            wizardConfig = wizardResult.config;
-            logger.debug(`${tag} Onboarding wizard succeeded`);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`${tag} Onboarding wizard threw: ${msg}`);
-            return { success: false, message: `Onboarding error: ${msg}` };
-        }
-    }
-    // ── Phase 3: discovery.run ────────────────────────────────────────────
-    let models = [];
-    if (hooks['discovery.run']) {
-        logger.debug(`${tag} Phase 3/5 — discovery.run`);
-        try {
-            models = await hooks['discovery.run']();
-            logger.debug(`${tag} Discovered ${models.length} model(s)`);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`${tag} Discovery threw: ${msg}`);
-            return { success: false, message: `Discovery error: ${msg}` };
-        }
-    }
-    // ── Phase 4: wizard.modelPicker ───────────────────────────────────────
-    let selectedModel;
-    if (hooks['wizard.modelPicker'] && models.length > 0) {
-        logger.debug(`${tag} Phase 4/5 — wizard.modelPicker`);
-        try {
-            selectedModel = await hooks['wizard.modelPicker'](models);
-            logger.debug(`${tag} User selected model: ${selectedModel}`);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`${tag} Model picker threw: ${msg}`);
-            return { success: false, message: `Model picker error: ${msg}` };
-        }
-    }
-    // ── Phase 5: onModelSelected ──────────────────────────────────────────
-    if (hooks.onModelSelected && selectedModel) {
-        logger.debug(`${tag} Phase 5/5 — onModelSelected`);
-        try {
-            await hooks.onModelSelected(selectedModel);
-            logger.debug(`${tag} onModelSelected completed`);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            logger.warn(`${tag} onModelSelected threw: ${msg}`);
-            return { success: false, message: `Post-selection error: ${msg}` };
-        }
-    }
-    return {
-        success: true,
-        config: {
-            ...wizardConfig,
-            ...(selectedModel ? { selectedModel } : {}),
-        },
-        message: `Onboarding completed for ${provider.name}`,
-    };
-}
-//# sourceMappingURL=provider-onboarding.js.map

package/dist/utils/kokoro-tts.d.ts

@@ -1,8 +0,0 @@
-export declare class KokoroTTSService {
-    private tts;
-    private initializing;
-    private init;
-    generateSpeech(text: string, voice?: string): Promise<Buffer>;
-    private float32ArrayToWav;
-}
-export declare const kokoroTtsService: KokoroTTSService;

package/dist/utils/kokoro-tts.js

@@ -1,67 +0,0 @@
-import { KokoroTTS } from 'kokoro-js';
-import { logger } from './logger.js';
-export class KokoroTTSService {
-    tts = null;
-    initializing = null;
-    async init() {
-        if (this.tts)
-            return;
-        if (this.initializing) {
-            return this.initializing;
-        }
-        this.initializing = (async () => {
-            logger.info('[KokoroTTS] Initializing Kokoro TTS (downloading model if not cached)...');
-            this.tts = await KokoroTTS.from_pretrained('hexgrad/Kokoro-82M', {
-                dtype: 'q8',
-                device: 'cpu',
-            });
-            logger.info('[KokoroTTS] Kokoro TTS successfully initialized');
-        })();
-        await this.initializing;
-        this.initializing = null;
-    }
-    async generateSpeech(text, voice = 'af_bella') {
-        await this.init();
-        if (!this.tts) {
-            throw new Error('TTS engine not initialized');
-        }
-        logger.info(`[KokoroTTS] Generating speech for text length: ${text.length} with voice: ${voice}`);
-        const result = await this.tts.generate(text, { voice: voice });
-        // Convert Float32Array to 16-bit PCM WAV
-        return this.float32ArrayToWav(result.audio, result.sampling_rate);
-    }
-    float32ArrayToWav(audioData, sampleRate) {
-        const numChannels = 1; // Kokoro outputs mono audio
-        const byteRate = sampleRate * numChannels * 2;
-        const blockAlign = numChannels * 2;
-        const dataSize = audioData.length * 2;
-        const buffer = Buffer.alloc(44 + dataSize);
-        // RIFF chunk descriptor
-        buffer.write('RIFF', 0);
-        buffer.writeUInt32LE(36 + dataSize, 4);
-        buffer.write('WAVE', 8);
-        // fmt sub-chunk
-        buffer.write('fmt ', 12);
-        buffer.writeUInt32LE(16, 16); // Subchunk1Size (16 for PCM)
-        buffer.writeUInt16LE(1, 20); // AudioFormat (1 for PCM)
-        buffer.writeUInt16LE(numChannels, 22); // NumChannels
-        buffer.writeUInt32LE(sampleRate, 24); // SampleRate
-        buffer.writeUInt32LE(byteRate, 28); // ByteRate
-        buffer.writeUInt16LE(blockAlign, 32); // BlockAlign
-        buffer.writeUInt16LE(16, 34); // BitsPerSample
-        // data sub-chunk
-        buffer.write('data', 36);
-        buffer.writeUInt32LE(dataSize, 40);
-        // Write PCM data
-        let offset = 44;
-        for (const sample of audioData) {
-            const s = Math.max(-1, Math.min(1, sample));
-            const val = s < 0 ? s * 0x8000 : s * 0x7FFF;
-            buffer.writeInt16LE(val, offset);
-            offset += 2;
-        }
-        return buffer;
-    }
-}
-export const kokoroTtsService = new KokoroTTSService();
-//# sourceMappingURL=kokoro-tts.js.map