@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/input-handlers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Input Handlers - Process special input prefixes
+ *
+ * Handles input that doesn't go to the agent, like:
+ * - "#" prefix for memory notes (persistent anchors)
+ */
+export { isMemoryInput, handleMemoryInput, type MemoryHandlerContext } from './memory-handler.js';

package/dist/input-handlers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Input Handlers - Process special input prefixes
+ *
+ * Handles input that doesn't go to the agent, like:
+ * - "#" prefix for memory notes (persistent anchors)
+ */
+export { isMemoryInput, handleMemoryInput } from './memory-handler.js';

package/dist/input-handlers/memory-handler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Memory Handler - Process "# note" input prefix
+ *
+ * Creates persistent anchors from user input prefixed with "#".
+ * Auto-detects priority based on keywords in the note.
+ */
+import type { Agent } from '@compilr-dev/sdk';
+import type { Footer } from '../ui/footer.js';
+export interface MemoryHandlerContext {
+    agent: Agent;
+    footer: Footer;
+}
+/**
+ * Check if input is a memory note (starts with #)
+ */
+export declare function isMemoryInput(input: string): boolean;
+/**
+ * Handle memory note input ("# note text")
+ *
+ * Creates a persistent anchor from the note, stored either globally or
+ * in the current project if one is active.
+ *
+ * @param input - The full input string (including # prefix)
+ * @param ctx - Handler context with agent and footer
+ */
+export declare function handleMemoryInput(input: string, ctx: MemoryHandlerContext): void;

package/dist/input-handlers/memory-handler.js

@@ -0,0 +1,69 @@
+/**
+ * Memory Handler - Process "# note" input prefix
+ *
+ * Creates persistent anchors from user input prefixed with "#".
+ * Auto-detects priority based on keywords in the note.
+ */
+import { addAnchor } from '../anchors/index.js';
+import { getActiveProject } from '../tools/project-db.js';
+import * as conversation from '../ui/conversation.js';
+import * as terminal from '../ui/terminal.js';
+import { truncate } from '../ui/base/index.js';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * Check if input is a memory note (starts with #)
+ */
+export function isMemoryInput(input) {
+    return input.startsWith('#') && input.length > 1 && input.slice(1).trim().length > 0;
+}
+/**
+ * Handle memory note input ("# note text")
+ *
+ * Creates a persistent anchor from the note, stored either globally or
+ * in the current project if one is active.
+ *
+ * @param input - The full input string (including # prefix)
+ * @param ctx - Handler context with agent and footer
+ */
+export function handleMemoryInput(input, ctx) {
+    const note = input.slice(1).trim();
+    // Get active project to determine scope
+    const activeProject = getActiveProject();
+    const projectId = activeProject?.id;
+    // Determine priority based on keywords
+    let priority = 'info';
+    const lowerNote = note.toLowerCase();
+    if (lowerNote.includes('never') || lowerNote.includes('always') || lowerNote.includes('must')) {
+        priority = 'safety';
+    }
+    if (lowerNote.includes('critical') || lowerNote.includes('important')) {
+        priority = 'critical';
+    }
+    // Create the anchor (persisted to file)
+    const anchor = addAnchor({
+        content: note,
+        priority,
+        scope: 'persistent',
+        projectId: projectId?.toString(),
+        tags: ['user-note'],
+    });
+    // Show confirmation
+    ctx.footer.clearForOutput();
+    const scope = activeProject ? `project "${activeProject.displayName || activeProject.name}"` : 'global';
+    const priorityLabel = priority === 'info' ? '' : ` (${priority})`;
+    conversation.printSuccess(`Saved${priorityLabel}: "${truncate(note, 50)}" → ${scope}`);
+    terminal.writeLine('');
+    ctx.footer.forceRender();
+    // Also add to agent's anchor manager if enabled (for current session)
+    if (ctx.agent.getAnchorManager()) {
+        ctx.agent.addAnchor({
+            id: anchor.id,
+            content: note,
+            priority,
+            scope: 'persistent',
+            tags: ['user-note'],
+        });
+    }
+}

package/dist/models/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Models Module
+ *
+ * Model-related types and utilities.
+ */
+export { type ModelTier, type TierInfo, type ProviderModelMap, TIER_INFO, MODEL_TIERS, getModelForTier, getTierMappings, getTierDisplayName, getShortModelName, getDefaultTierMappings, isValidTier, setTierOverride, clearTierOverride, } from './model-tiers.js';
+export { type ModelValidationResult, validateModel, checkApiKeyStatus, } from './model-validation.js';
+export { type ThinkingFormat, type ModelStatus, type ModelInfo, type ModelOptionForUI, MODEL_REGISTRY, getModelsForProvider, getModelsSortedForDisplay, getModelInfo, isKnownModel, isModelSupported, getThinkingFormat, getStatusIndicator, getStatusLabel, getDefaultModelForTier, areThinkingFormatsCompatible, shouldClearHistoryOnModelChange, getDefaultModelsForUI, getDefaultModelsForProvider, getAllModelsForProviderUI, getModelDisplayName, getModelDescription, getModelContextWindow, } from './model-registry.js';
+export { type ProviderMetadata, type OthersProviderModel, PROVIDER_METADATA, TOGETHER_MODELS, GROQ_MODELS, FIREWORKS_MODELS, PERPLEXITY_MODELS, OPENROUTER_MODELS, getModelsForOthersProvider, getOthersProviders, getProviderMetadata, isOthersProvider, } from './providers.js';
+export { type OllamaModelInfo, type OllamaModelsResult, listOllamaModels, clearOllamaModelsCache, isOllamaModelAvailable, formatModelSize, getOllamaModelDisplayName, getOllamaModelDescription, } from './ollama-models.js';

package/dist/models/index.js

@@ -0,0 +1,12 @@
+/**
+ * Models Module
+ *
+ * Model-related types and utilities.
+ */
+export { TIER_INFO, MODEL_TIERS, getModelForTier, getTierMappings, getTierDisplayName, getShortModelName, getDefaultTierMappings, isValidTier, setTierOverride, clearTierOverride, } from './model-tiers.js';
+export { validateModel, checkApiKeyStatus, } from './model-validation.js';
+export { MODEL_REGISTRY, getModelsForProvider, getModelsSortedForDisplay, getModelInfo, isKnownModel, isModelSupported, getThinkingFormat, getStatusIndicator, getStatusLabel, getDefaultModelForTier, areThinkingFormatsCompatible, shouldClearHistoryOnModelChange, 
+// UI helpers
+getDefaultModelsForUI, getDefaultModelsForProvider, getAllModelsForProviderUI, getModelDisplayName, getModelDescription, getModelContextWindow, } from './model-registry.js';
+export { PROVIDER_METADATA, TOGETHER_MODELS, GROQ_MODELS, FIREWORKS_MODELS, PERPLEXITY_MODELS, OPENROUTER_MODELS, getModelsForOthersProvider, getOthersProviders, getProviderMetadata, isOthersProvider, } from './providers.js';
+export { listOllamaModels, clearOllamaModelsCache, isOllamaModelAvailable, formatModelSize, getOllamaModelDisplayName, getOllamaModelDescription, } from './ollama-models.js';

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

@@ -0,0 +1,38 @@
+/**
+ * Model Registry — Re-exported from @compilr-dev/sdk
+ *
+ * The SDK owns the model registry data and core helpers.
+ * This file re-exports those and adds CLI-specific UI helpers.
+ */
+import type { ProviderType } from './provider-types.js';
+import type { ModelTier } from './types.js';
+export { type ThinkingFormat, type ModelStatus, type ModelInfo, MODEL_REGISTRY, getModelsForProvider, getModelsSortedForDisplay, getModelInfo, isKnownModel, isModelSupported, getThinkingFormat, getStatusIndicator, getStatusLabel, getDefaultModelForTier, areThinkingFormatsCompatible, shouldClearHistoryOnModelChange, getModelContextWindow, getModelDisplayName, getModelDescription, } from '@compilr-dev/sdk';
+/**
+ * Model option for UI overlays (config, model selector).
+ * Simplified interface for overlay display.
+ */
+export interface ModelOptionForUI {
+    /** Model ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Short description */
+    description: string;
+    /** Provider */
+    provider: ProviderType;
+    /** Tier (if this is a default model for a tier) */
+    tier?: ModelTier;
+}
+/**
+ * Get default models for each tier, formatted for UI overlays.
+ * Returns one model per tier per provider (fast, balanced, powerful).
+ */
+export declare function getDefaultModelsForUI(): ModelOptionForUI[];
+/**
+ * Get default models for a specific provider, formatted for UI overlays.
+ */
+export declare function getDefaultModelsForProvider(provider: ProviderType): ModelOptionForUI[];
+/**
+ * Get all models for a provider (including non-defaults), formatted for UI overlays.
+ */
+export declare function getAllModelsForProviderUI(provider: ProviderType): ModelOptionForUI[];

package/dist/models/model-registry.js

@@ -0,0 +1,69 @@
+/**
+ * Model Registry — Re-exported from @compilr-dev/sdk
+ *
+ * The SDK owns the model registry data and core helpers.
+ * This file re-exports those and adds CLI-specific UI helpers.
+ */
+// Re-export everything from SDK
+export { MODEL_REGISTRY, getModelsForProvider, getModelsSortedForDisplay, getModelInfo, isKnownModel, isModelSupported, getThinkingFormat, getStatusIndicator, getStatusLabel, getDefaultModelForTier, areThinkingFormatsCompatible, shouldClearHistoryOnModelChange, getModelContextWindow, getModelDisplayName, getModelDescription, } from '@compilr-dev/sdk';
+// Import for use in CLI-specific helpers below
+import { MODEL_REGISTRY } from '@compilr-dev/sdk';
+/**
+ * Get default models for each tier, formatted for UI overlays.
+ * Returns one model per tier per provider (fast, balanced, powerful).
+ */
+export function getDefaultModelsForUI() {
+    const result = [];
+    // Get models with defaultTier set (these are the defaults)
+    const defaultModels = MODEL_REGISTRY.filter((m) => m.defaultTier !== undefined && m.status === 'supported');
+    // Sort by provider, then by tier order (fast → balanced → powerful)
+    const tierOrder = { fast: 0, balanced: 1, powerful: 2 };
+    const providerOrder = {
+        claude: 0,
+        openai: 1,
+        gemini: 2,
+        ollama: 3,
+        together: 4,
+        groq: 5,
+        fireworks: 6,
+        perplexity: 7,
+        openrouter: 8,
+        custom: 9,
+    };
+    defaultModels.sort((a, b) => {
+        const providerDiff = providerOrder[a.provider] - providerOrder[b.provider];
+        if (providerDiff !== 0)
+            return providerDiff;
+        return tierOrder[a.defaultTier ?? 'balanced'] - tierOrder[b.defaultTier ?? 'balanced'];
+    });
+    for (const model of defaultModels) {
+        result.push({
+            id: model.id,
+            name: model.displayName,
+            description: model.description,
+            provider: model.provider,
+            tier: model.defaultTier,
+        });
+    }
+    return result;
+}
+/**
+ * Get default models for a specific provider, formatted for UI overlays.
+ */
+export function getDefaultModelsForProvider(provider) {
+    return getDefaultModelsForUI().filter(m => m.provider === provider);
+}
+/**
+ * Get all models for a provider (including non-defaults), formatted for UI overlays.
+ */
+export function getAllModelsForProviderUI(provider) {
+    return MODEL_REGISTRY
+        .filter((m) => m.provider === provider && m.status === 'supported')
+        .map((m) => ({
+        id: m.id,
+        name: m.displayName,
+        description: m.description,
+        provider: m.provider,
+        tier: m.defaultTier,
+    }));
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Model Tiers — CLI wrapper over SDK's pure tier functions
+ *
+ * Adds settings integration: reads/writes user overrides from
+ * the CLI's settings store.
+ */
+import type { ProviderType } from './provider-types.js';
+import type { ModelTier, ProviderModelMap } from './types.js';
+export { type ModelTier, type TierInfo, type ProviderModelMap, MODEL_TIERS, TIER_INFO, isValidTier, } from './types.js';
+export { getTierDisplayName, getShortModelName, getDefaultTierMappings } from '@compilr-dev/sdk';
+/**
+ * Get the model ID for a given tier and provider.
+ * Checks user overrides in settings first, then falls back to registry defaults.
+ */
+export declare function getModelForTier(provider: ProviderType, tier: ModelTier): string;
+/**
+ * Get all tier mappings for a provider (with user overrides applied).
+ */
+export declare function getTierMappings(provider: ProviderType): ProviderModelMap;
+/**
+ * Set a tier override for a provider.
+ * This saves the custom model to settings.
+ */
+export declare function setTierOverride(provider: ProviderType, tier: ModelTier, model: string): void;
+/**
+ * Clear a tier override for a provider (revert to default).
+ */
+export declare function clearTierOverride(provider: ProviderType, tier: ModelTier): void;

package/dist/models/model-tiers.js

@@ -0,0 +1,71 @@
+/**
+ * Model Tiers — CLI wrapper over SDK's pure tier functions
+ *
+ * Adds settings integration: reads/writes user overrides from
+ * the CLI's settings store.
+ */
+import { getSetting, setSetting } from '../settings/index.js';
+import { getModelForTier as sdkGetModelForTier, getTierMappings as sdkGetTierMappings, } from '@compilr-dev/sdk';
+// Re-export types and pure functions from SDK (via types.ts)
+export { MODEL_TIERS, TIER_INFO, isValidTier, } from './types.js';
+// Re-export pure functions that don't need settings
+export { getTierDisplayName, getShortModelName, getDefaultTierMappings } from '@compilr-dev/sdk';
+// =============================================================================
+// CLI Functions (with settings integration)
+// =============================================================================
+/**
+ * Get user tier overrides from settings.
+ */
+function getUserOverrides() {
+    return getSetting('modelTiers');
+}
+/**
+ * Get the model ID for a given tier and provider.
+ * Checks user overrides in settings first, then falls back to registry defaults.
+ */
+export function getModelForTier(provider, tier) {
+    return sdkGetModelForTier(provider, tier, getUserOverrides());
+}
+/**
+ * Get all tier mappings for a provider (with user overrides applied).
+ */
+export function getTierMappings(provider) {
+    return sdkGetTierMappings(provider, getUserOverrides());
+}
+/**
+ * Set a tier override for a provider.
+ * This saves the custom model to settings.
+ */
+export function setTierOverride(provider, tier, model) {
+    const current = (getSetting('modelTiers') ?? {});
+    // Initialize provider if not exists
+    let providerOverrides = current[provider];
+    if (providerOverrides === undefined) {
+        providerOverrides = {};
+        current[provider] = providerOverrides;
+    }
+    // Set the override
+    providerOverrides[tier] = model;
+    setSetting('modelTiers', current);
+}
+/**
+ * Clear a tier override for a provider (revert to default).
+ */
+export function clearTierOverride(provider, tier) {
+    const current = (getSetting('modelTiers') ?? {});
+    const providerOverrides = current[provider];
+    if (providerOverrides === undefined || !(tier in providerOverrides)) {
+        return; // Nothing to clear
+    }
+    // Remove the tier override
+    const { [tier]: _removed, ...remaining } = providerOverrides;
+    // Update or remove the provider entry
+    if (Object.keys(remaining).length === 0) {
+        const { [provider]: _removedProvider, ...remainingProviders } = current;
+        setSetting('modelTiers', remainingProviders);
+    }
+    else {
+        current[provider] = remaining;
+        setSetting('modelTiers', current);
+    }
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Model Validation
+ *
+ * Validates model names by making lightweight API calls.
+ * Uses direct HTTP requests to avoid SDK dependencies.
+ */
+import type { ProviderType } from './provider-types.js';
+export interface ModelValidationResult {
+    valid: boolean;
+    error?: string;
+    errorType?: 'no_api_key' | 'invalid_model' | 'network_error' | 'rate_limit' | 'unknown';
+}
+/**
+ * Validate a model by making a minimal API call.
+ * Returns result indicating if model is valid, with error details if not.
+ */
+export declare function validateModel(provider: ProviderType, modelId: string): Promise<ModelValidationResult>;
+/**
+ * Check if API key is set for a provider.
+ * Returns user-friendly hint if not set.
+ */
+export declare function checkApiKeyStatus(provider: ProviderType): {
+    hasKey: boolean;
+    hint?: string;
+};

package/dist/models/model-validation.js

@@ -0,0 +1,291 @@
+/**
+ * Model Validation
+ *
+ * Validates model names by making lightweight API calls.
+ * Uses direct HTTP requests to avoid SDK dependencies.
+ */
+import { getApiKey, hasApiKey } from '../utils/credentials.js';
+import { getSetting } from '../settings/index.js';
+import { PROVIDER_METADATA } from './providers.js';
+// =============================================================================
+// Validation Functions
+// =============================================================================
+/**
+ * Validate a model by making a minimal API call.
+ * Returns result indicating if model is valid, with error details if not.
+ */
+export async function validateModel(provider, modelId) {
+    switch (provider) {
+        case 'claude':
+            return validateAnthropicModel(modelId);
+        case 'openai':
+            return validateOpenAIModel(modelId);
+        case 'gemini':
+            return validateGeminiModel(modelId);
+        case 'ollama':
+            return validateOllamaModel(modelId);
+        default:
+            return { valid: false, error: 'Unknown provider', errorType: 'unknown' };
+    }
+}
+/**
+ * Validate an Anthropic/Claude model via HTTP.
+ */
+async function validateAnthropicModel(modelId) {
+    const apiKey = getApiKey('anthropic');
+    if (!apiKey) {
+        return {
+            valid: false,
+            error: 'No Anthropic API key set. Run /keys to configure.',
+            errorType: 'no_api_key',
+        };
+    }
+    try {
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: modelId,
+                max_tokens: 1,
+                messages: [{ role: 'user', content: 'hi' }],
+            }),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (response.ok) {
+            return { valid: true };
+        }
+        const data = await response.json().catch(() => ({}));
+        return parseHttpError(response.status, data, 'Anthropic');
+    }
+    catch (error) {
+        return parseNetworkError(error, 'Anthropic');
+    }
+}
+/**
+ * Validate an OpenAI model via HTTP.
+ */
+async function validateOpenAIModel(modelId) {
+    const apiKey = getApiKey('openai');
+    if (!apiKey) {
+        return {
+            valid: false,
+            error: 'No OpenAI API key set. Run /keys to configure.',
+            errorType: 'no_api_key',
+        };
+    }
+    try {
+        const response = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: modelId,
+                max_tokens: 1,
+                messages: [{ role: 'user', content: 'hi' }],
+            }),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (response.ok) {
+            return { valid: true };
+        }
+        const data = await response.json().catch(() => ({}));
+        return parseHttpError(response.status, data, 'OpenAI');
+    }
+    catch (error) {
+        return parseNetworkError(error, 'OpenAI');
+    }
+}
+/**
+ * Validate a Gemini model via HTTP (using OpenAI-compatible endpoint).
+ */
+async function validateGeminiModel(modelId) {
+    const apiKey = getApiKey('google');
+    if (!apiKey) {
+        return {
+            valid: false,
+            error: 'No Google API key set. Run /keys to configure.',
+            errorType: 'no_api_key',
+        };
+    }
+    try {
+        // Use OpenAI-compatible endpoint (same as @compilr-dev/agents)
+        const response = await fetch('https://generativelanguage.googleapis.com/v1beta/openai/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: modelId,
+                max_tokens: 1,
+                messages: [{ role: 'user', content: 'hi' }],
+            }),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (response.ok) {
+            return { valid: true };
+        }
+        const data = await response.json().catch(() => ({}));
+        return parseHttpError(response.status, data, 'Google');
+    }
+    catch (error) {
+        return parseNetworkError(error, 'Google');
+    }
+}
+/**
+ * Validate an Ollama model by checking if it exists locally.
+ * This doesn't make an LLM call - just lists available models.
+ */
+async function validateOllamaModel(modelId) {
+    // Get base URL from settings first, then env var, then default
+    const settingUrl = getSetting('ollamaBaseUrl');
+    const ollamaHost = (typeof settingUrl === 'string' ? settingUrl : null)
+        ?? process.env.OLLAMA_BASE_URL
+        ?? process.env.OLLAMA_HOST
+        ?? 'http://localhost:11434';
+    try {
+        // List models to check if Ollama is running and model exists
+        const response = await fetch(`${ollamaHost}/api/tags`, {
+            method: 'GET',
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            return {
+                valid: false,
+                error: 'Cannot connect to Ollama. Is it running?',
+                errorType: 'network_error',
+            };
+        }
+        const data = await response.json();
+        const models = data.models || [];
+        // Check if the model exists (handle "model:tag" format)
+        const normalizedModelId = modelId.toLowerCase();
+        const modelExists = models.some(m => {
+            const name = m.name.toLowerCase();
+            return name === normalizedModelId ||
+                name.startsWith(normalizedModelId + ':') ||
+                normalizedModelId.startsWith(name.split(':')[0]);
+        });
+        if (modelExists) {
+            return { valid: true };
+        }
+        return {
+            valid: false,
+            error: `Model '${modelId}' not found locally. Run: ollama pull ${modelId}`,
+            errorType: 'invalid_model',
+        };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.name === 'AbortError' || error.message.includes('timeout')) {
+                return {
+                    valid: false,
+                    error: 'Ollama connection timed out. Is Ollama running?',
+                    errorType: 'network_error',
+                };
+            }
+            if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch failed')) {
+                return {
+                    valid: false,
+                    error: 'Cannot connect to Ollama. Start it with: ollama serve',
+                    errorType: 'network_error',
+                };
+            }
+        }
+        return {
+            valid: false,
+            error: `Ollama error: ${error instanceof Error ? error.message : 'Unknown'}`,
+            errorType: 'unknown',
+        };
+    }
+}
+function parseHttpError(status, data, provider) {
+    const errorMsg = data.error?.message || '';
+    const errorType = data.error?.type || data.error?.code || '';
+    const lowerMsg = errorMsg.toLowerCase();
+    const lowerType = errorType.toLowerCase();
+    // Model not found
+    if (status === 404 ||
+        lowerMsg.includes('model') && (lowerMsg.includes('not found') || lowerMsg.includes('does not exist')) ||
+        lowerType.includes('invalid_model') || lowerType.includes('model_not_found')) {
+        return {
+            valid: false,
+            error: `Model not found. Check the model ID is correct for ${provider}.`,
+            errorType: 'invalid_model',
+        };
+    }
+    // Authentication error
+    if (status === 401 || status === 403 ||
+        lowerMsg.includes('api key') || lowerMsg.includes('authentication') || lowerMsg.includes('unauthorized')) {
+        return {
+            valid: false,
+            error: `${provider} API key is invalid or expired. Run /keys to update.`,
+            errorType: 'no_api_key',
+        };
+    }
+    // Rate limit
+    if (status === 429 || lowerType.includes('rate_limit')) {
+        return {
+            valid: false,
+            error: `${provider} rate limit hit. Model may be valid - try again later.`,
+            errorType: 'rate_limit',
+        };
+    }
+    // Generic error
+    return {
+        valid: false,
+        error: errorMsg || `${provider} returned error ${String(status)}`,
+        errorType: 'unknown',
+    };
+}
+function parseNetworkError(error, provider) {
+    if (error instanceof Error) {
+        if (error.name === 'AbortError' || error.message.includes('timeout')) {
+            return {
+                valid: false,
+                error: `${provider} request timed out. Check your connection.`,
+                errorType: 'network_error',
+            };
+        }
+        if (error.message.includes('fetch failed') || error.message.includes('ECONNREFUSED')) {
+            return {
+                valid: false,
+                error: `Cannot connect to ${provider}. Check your internet connection.`,
+                errorType: 'network_error',
+            };
+        }
+    }
+    return {
+        valid: false,
+        error: `${provider} error: ${error instanceof Error ? error.message : 'Unknown'}`,
+        errorType: 'unknown',
+    };
+}
+// =============================================================================
+// API Key Status Check
+// =============================================================================
+/**
+ * Check if API key is set for a provider.
+ * Returns user-friendly hint if not set.
+ */
+export function checkApiKeyStatus(provider) {
+    // Get provider metadata for correct credential key and env var
+    const metadata = PROVIDER_METADATA[provider];
+    if (!metadata.requiresKey) {
+        return { hasKey: true }; // Ollama and other local providers don't need API key
+    }
+    const keySet = hasApiKey(metadata.credentialKey);
+    if (!keySet) {
+        return {
+            hasKey: false,
+            hint: `Set ${metadata.envVar} or run /keys`,
+        };
+    }
+    return { hasKey: true };
+}