@compilr-dev/cli 0.5.0 → 0.5.1

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

@@ -4,7 +4,7 @@
  * Creates persistent anchors from user input prefixed with "#".
  * Auto-detects priority based on keywords in the note.
  */
-import type { Agent } from '@compilr-dev/agents';
+import type { Agent } from '@compilr-dev/sdk';
 import type { Footer } from '../ui/footer.js';
 export interface MemoryHandlerContext {
     agent: Agent;

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

@@ -8,6 +8,7 @@ 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
 // =============================================================================
@@ -52,7 +53,7 @@ export function handleMemoryInput(input, ctx) {
     ctx.footer.clearForOutput();
     const scope = activeProject ? `project "${activeProject.displayName || activeProject.name}"` : 'global';
     const priorityLabel = priority === 'info' ? '' : ` (${priority})`;
-    conversation.printSuccess(`Saved${priorityLabel}: "${note.length > 50 ? note.slice(0, 47) + '...' : note}" → ${scope}`);
+    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)

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 };
+}

package/dist/models/ollama-models.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Ollama Model Auto-Detection
+ *
+ * Fetches available models from a running Ollama instance.
+ * Provides caching to avoid repeated API calls.
+ */
+/**
+ * Information about an Ollama model as returned by the API.
+ */
+export interface OllamaModelInfo {
+    /** Model name (e.g., "llama3.2:8b", "deepseek-r1:14b") */
+    name: string;
+    /** Model size in bytes */
+    size: number;
+    /** When the model was modified/pulled */
+    modifiedAt: string;
+    /** Model digest (hash) */
+    digest: string;
+    /** Model details (family, parameter size, quantization) */
+    details?: {
+        family?: string;
+        parameterSize?: string;
+        quantizationLevel?: string;
+    };
+}
+/**
+ * Result of listing Ollama models.
+ */
+export interface OllamaModelsResult {
+    /** Whether the fetch was successful */
+    success: boolean;
+    /** Available models (empty if failed) */
+    models: OllamaModelInfo[];
+    /** Error message if failed */
+    error?: string;
+    /** Whether Ollama is running */
+    ollamaRunning: boolean;
+    /** Timestamp of the fetch (for cache management) */
+    fetchedAt: number;
+}
+/**
+ * Clear the cache (useful for testing or forcing refresh).
+ */
+export declare function clearOllamaModelsCache(): void;
+/**
+ * List all locally available Ollama models.
+ *
+ * Features:
+ * - Caches results for 30 seconds to avoid repeated API calls
+ * - Returns gracefully with error info when Ollama is not running
+ * - Parses model metadata (size, family, quantization)
+ *
+ * @param forceRefresh - If true, bypasses the cache
+ */
+export declare function listOllamaModels(forceRefresh?: boolean): Promise<OllamaModelsResult>;
+/**
+ * Check if a specific model is available locally.
+ * Uses the cached model list for efficiency.
+ */
+export declare function isOllamaModelAvailable(modelId: string): Promise<boolean>;
+/**
+ * Format model size for display (e.g., "4.1 GB").
+ */
+export declare function formatModelSize(bytes: number): string;
+/**
+ * Get a friendly display name for a model.
+ * Capitalizes the base name and formats the tag.
+ */
+export declare function getOllamaModelDisplayName(name: string): string;
+/**
+ * Get a short description for a model based on its metadata.
+ */
+export declare function getOllamaModelDescription(model: OllamaModelInfo): string;