@vybestack/llxprt-code-core 0.8.0 → 0.9.0-nightly.260119.0f050754d

package/dist/src/models/profiles.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ModelsDevModel, LlxprtDefaultProfile } from './schema.js';
+/**
+ * Generate optimal default settings per model based on capabilities
+ */
+export declare function generateDefaultProfile(model: ModelsDevModel): LlxprtDefaultProfile | undefined;
+/**
+ * Get recommended thinking budget based on model context window
+ */
+export declare function getRecommendedThinkingBudget(contextWindow: number): number;
+/**
+ * Merge user profile settings with model defaults
+ * User settings take precedence over defaults
+ */
+export declare function mergeProfileWithDefaults(userProfile: Partial<LlxprtDefaultProfile>, modelDefaults: LlxprtDefaultProfile | undefined): LlxprtDefaultProfile;

package/dist/src/models/profiles.js

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Generate optimal default settings per model based on capabilities
+ */
+export function generateDefaultProfile(model) {
+    const profile = {};
+    // Reasoning models
+    if (model.reasoning) {
+        profile.thinkingEnabled = true;
+        profile.thinkingBudget = 10000; // Conservative default
+        // Lower temperature for reasoning models
+        if (model.temperature) {
+            profile.temperature = 0.7;
+        }
+    }
+    else {
+        // Non-reasoning models
+        if (model.temperature) {
+            profile.temperature = 1.0;
+        }
+    }
+    // Top-p recommendations
+    if (model.temperature) {
+        profile.topP = 0.95; // Standard default
+    }
+    // Provider/family-specific tuning
+    const family = model.family?.toLowerCase() ?? '';
+    const modelId = model.id.toLowerCase();
+    if (family.includes('gpt-5') || modelId.includes('gpt-5')) {
+        // GPT-5 models prefer higher temperature
+        profile.temperature = 1.2;
+        profile.topP = 0.98;
+    }
+    else if (family.includes('claude') || modelId.includes('claude')) {
+        // Claude models work well with slightly lower values
+        profile.temperature = 0.8;
+        profile.topP = 0.9;
+    }
+    else if (family.includes('gemini') || modelId.includes('gemini')) {
+        // Gemini tuning
+        profile.temperature = 1.0;
+        profile.topP = 0.95;
+        profile.topK = 40;
+    }
+    else if (family.includes('deepseek') || modelId.includes('deepseek')) {
+        // DeepSeek models
+        profile.temperature = 0.7;
+        profile.topP = 0.9;
+    }
+    else if (family.includes('qwen') || modelId.includes('qwen')) {
+        // Qwen models
+        profile.temperature = 0.7;
+        profile.topP = 0.8;
+    }
+    // Return undefined if no profile settings were set
+    if (Object.keys(profile).length === 0) {
+        return undefined;
+    }
+    return profile;
+}
+/**
+ * Get recommended thinking budget based on model context window
+ */
+export function getRecommendedThinkingBudget(contextWindow) {
+    // Use ~5% of context window for thinking, capped at reasonable limits
+    const budget = Math.floor(contextWindow * 0.05);
+    return Math.min(Math.max(budget, 5000), 50000);
+}
+/**
+ * Merge user profile settings with model defaults
+ * User settings take precedence over defaults
+ */
+export function mergeProfileWithDefaults(userProfile, modelDefaults) {
+    return {
+        ...modelDefaults,
+        ...userProfile,
+    };
+}
+//# sourceMappingURL=profiles.js.map

package/dist/src/models/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../src/models/profiles.ts"],"names":[],"mappings":"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"}

package/dist/src/models/provider-integration.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Provider Integration Layer for ModelsRegistry
+ *
+ * Provides utilities for IProvider implementations to fetch model data
+ * from the ModelsRegistry with graceful fallback to hardcoded lists.
+ */
+import type { IModel } from '../providers/IModel.js';
+import type { LlxprtModel } from './schema.js';
+/**
+ * Maps llxprt provider names to models.dev provider IDs
+ * models.dev uses different naming in some cases
+ */
+export declare const PROVIDER_ID_MAP: Record<string, string[]>;
+/**
+ * Converts an LlxprtModel to the IModel interface
+ * LlxprtModel already has all IModel fields, but this ensures type safety
+ */
+export declare function llxprtModelToIModel(model: LlxprtModel): IModel;
+/**
+ * Get the models.dev provider IDs for a given llxprt provider name.
+ * Falls back to using the provider name itself if no mapping exists.
+ *
+ * @param providerName - The llxprt provider name (e.g., 'gemini', 'openai')
+ * @returns Array of models.dev provider IDs
+ */
+export declare function getModelsDevProviderIds(providerName: string): string[];
+/**
+ * Check if a specific model ID exists in the registry for a provider
+ */
+export declare function hasModelInRegistry(providerName: string, modelId: string): boolean;
+/**
+ * Get extended model info from registry (pricing, capabilities, etc.)
+ * Returns undefined if model not found or registry unavailable
+ */
+export declare function getExtendedModelInfo(providerName: string, modelId: string): LlxprtModel | undefined;
+/**
+ * Get recommended model for a provider based on capabilities
+ * Useful for selecting default models
+ */
+export declare function getRecommendedModel(providerName: string, options?: {
+    requireToolCalling?: boolean;
+    requireReasoning?: boolean;
+    preferCheaper?: boolean;
+}): LlxprtModel | undefined;

package/dist/src/models/provider-integration.js

@@ -0,0 +1,162 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getModelRegistry } from './registry.js';
+/**
+ * Maps llxprt provider names to models.dev provider IDs
+ * models.dev uses different naming in some cases
+ */
+export const PROVIDER_ID_MAP = {
+    // llxprt provider name -> models.dev provider ID(s)
+    gemini: ['google', 'google-vertex'],
+    openai: ['openai'],
+    anthropic: ['anthropic'],
+    'openai-responses': ['openai'],
+    'openai-vercel': ['openai'],
+    deepseek: ['deepseek'],
+    groq: ['groq'],
+    mistral: ['mistral'],
+    cohere: ['cohere'],
+    xai: ['xai'],
+    ollama: ['ollama'],
+    togetherai: ['togetherai'],
+    perplexity: ['perplexity'],
+    fireworks: ['fireworks-ai'],
+    // Alias provider display names -> models.dev provider IDs
+    'Chutes.ai': ['chutes'],
+    xAI: ['xai'],
+    Synthetic: ['synthetic'],
+    Fireworks: ['fireworks-ai'],
+    OpenRouter: ['openrouter'],
+    'Cerebras Code': ['cerebras'],
+    'LM Studio': ['lmstudio'],
+    'llama.cpp': ['llama'],
+    qwen: ['alibaba'],
+    qwenvercel: ['alibaba'],
+    codex: ['openai'],
+    kimi: ['kimi-for-coding'],
+};
+/**
+ * Converts an LlxprtModel to the IModel interface
+ * LlxprtModel already has all IModel fields, but this ensures type safety
+ */
+export function llxprtModelToIModel(model) {
+    return {
+        id: model.modelId, // Use the short model ID, not the full "provider/model" ID
+        name: model.name,
+        provider: model.provider,
+        supportedToolFormats: model.supportedToolFormats,
+        contextWindow: model.contextWindow,
+        maxOutputTokens: model.maxOutputTokens,
+    };
+}
+/**
+ * Get the models.dev provider IDs for a given llxprt provider name.
+ * Falls back to using the provider name itself if no mapping exists.
+ *
+ * @param providerName - The llxprt provider name (e.g., 'gemini', 'openai')
+ * @returns Array of models.dev provider IDs
+ */
+export function getModelsDevProviderIds(providerName) {
+    return PROVIDER_ID_MAP[providerName] ?? [providerName];
+}
+/**
+ * Check if a specific model ID exists in the registry for a provider
+ */
+export function hasModelInRegistry(providerName, modelId) {
+    try {
+        const registry = getModelRegistry();
+        if (!registry.isInitialized()) {
+            return false;
+        }
+        const providerIds = getModelsDevProviderIds(providerName);
+        for (const providerId of providerIds) {
+            // Try full ID format (provider/model)
+            const fullId = `${providerId}/${modelId}`;
+            if (registry.getById(fullId)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get extended model info from registry (pricing, capabilities, etc.)
+ * Returns undefined if model not found or registry unavailable
+ */
+export function getExtendedModelInfo(providerName, modelId) {
+    try {
+        const registry = getModelRegistry();
+        if (!registry.isInitialized()) {
+            return undefined;
+        }
+        const providerIds = getModelsDevProviderIds(providerName);
+        for (const providerId of providerIds) {
+            const fullId = `${providerId}/${modelId}`;
+            const model = registry.getById(fullId);
+            if (model) {
+                return model;
+            }
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get recommended model for a provider based on capabilities
+ * Useful for selecting default models
+ */
+export function getRecommendedModel(providerName, options) {
+    try {
+        const registry = getModelRegistry();
+        if (!registry.isInitialized()) {
+            return undefined;
+        }
+        const providerIds = getModelsDevProviderIds(providerName);
+        // Collect all models from mapped providers
+        let candidates = [];
+        for (const providerId of providerIds) {
+            candidates.push(...registry.getByProvider(providerId));
+        }
+        // Filter out deprecated
+        candidates = candidates.filter((m) => m.metadata?.status !== 'deprecated');
+        // Apply capability filters
+        if (options?.requireToolCalling) {
+            candidates = candidates.filter((m) => m.capabilities.toolCalling);
+        }
+        if (options?.requireReasoning) {
+            candidates = candidates.filter((m) => m.capabilities.reasoning);
+        }
+        if (candidates.length === 0) {
+            return undefined;
+        }
+        // Sort by preference
+        if (options?.preferCheaper) {
+            candidates.sort((a, b) => {
+                const priceA = a.pricing?.input ?? Infinity;
+                const priceB = b.pricing?.input ?? Infinity;
+                return priceA - priceB;
+            });
+        }
+        else {
+            // Default: prefer larger context window (usually better models)
+            candidates.sort((a, b) => {
+                const ctxA = a.limits.contextWindow ?? 0;
+                const ctxB = b.limits.contextWindow ?? 0;
+                return ctxB - ctxA;
+            });
+        }
+        return candidates[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=provider-integration.js.map

package/dist/src/models/provider-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-integration.js","sourceRoot":"","sources":["../../../src/models/provider-integration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,oDAAoD;IACpD,MAAM,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,eAAe,EAAE,CAAC,QAAQ,CAAC;IAC3B,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,GAAG,EAAE,CAAC,KAAK,CAAC;IACZ,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,SAAS,EAAE,CAAC,cAAc,CAAC;IAE3B,0DAA0D;IAC1D,WAAW,EAAE,CAAC,QAAQ,CAAC;IACvB,GAAG,EAAE,CAAC,KAAK,CAAC;IACZ,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,SAAS,EAAE,CAAC,cAAc,CAAC;IAC3B,UAAU,EAAE,CAAC,YAAY,CAAC;IAC1B,eAAe,EAAE,CAAC,UAAU,CAAC;IAC7B,WAAW,EAAE,CAAC,UAAU,CAAC;IACzB,WAAW,EAAE,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,IAAI,EAAE,CAAC,iBAAiB,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,2DAA2D;QAC9E,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,OAAO,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAoB,EACpB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAE1D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,sCAAsC;YACtC,MAAM,MAAM,GAAG,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC;YAC1C,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAE1D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,OAIC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAE1D,2CAA2C;QAC3C,IAAI,UAAU,GAAkB,EAAE,CAAC;QACnC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,wBAAwB;QACxB,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC;QAE3E,2BAA2B;QAC3B,IAAI,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAChC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;YAC9B,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC;gBAC5C,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC;gBAC5C,OAAO,MAAM,GAAG,MAAM,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;gBACzC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;gBACzC,OAAO,IAAI,GAAG,IAAI,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/src/models/registry.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type LlxprtModel, type LlxprtProvider, type ModelCacheMetadata } from './schema.js';
+/**
+ * Search query options for filtering models
+ */
+export interface ModelSearchQuery {
+    provider?: string;
+    capability?: keyof LlxprtModel['capabilities'];
+    maxPrice?: number;
+    minContext?: number;
+    reasoning?: boolean;
+    toolCalling?: boolean;
+}
+/**
+ * Event types emitted by the registry
+ */
+export type ModelRegistryEvent = 'models:updated' | 'models:error';
+type EventCallback = () => void;
+/**
+ * ModelRegistry - Central registry for AI model metadata from models.dev
+ *
+ * Provides:
+ * - Automatic loading from cache or bundled fallback
+ * - Background periodic refresh (24h)
+ * - Search and filtering by capabilities, price, context
+ * - Event emission for UI updates
+ */
+export declare class ModelRegistry {
+    private models;
+    private providers;
+    private lastRefresh;
+    private refreshTimer;
+    private listeners;
+    private initialized;
+    private initPromise;
+    /**
+     * Get the cache file path
+     */
+    private static getCachePath;
+    /**
+     * Initialize the registry - loads models and starts background refresh
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load models from cache or trigger fresh fetch
+     */
+    private loadModels;
+    /**
+     * Load from cache file if fresh
+     */
+    private loadFromCache;
+    /**
+     * Refresh models from models.dev API (non-blocking)
+     */
+    refresh(): Promise<boolean>;
+    /**
+     * Save data to cache file
+     */
+    private saveToCache;
+    /**
+     * Populate internal maps from API response
+     */
+    private populateModels;
+    /**
+     * Start background refresh timer
+     */
+    private startBackgroundRefresh;
+    /**
+     * Stop background refresh and cleanup
+     */
+    dispose(): void;
+    /**
+     * Get all models
+     */
+    getAll(): LlxprtModel[];
+    /**
+     * Get model by full ID (provider/model-id)
+     */
+    getById(id: string): LlxprtModel | undefined;
+    /**
+     * Get all models for a specific provider
+     */
+    getByProvider(providerId: string): LlxprtModel[];
+    /**
+     * Search models by various criteria
+     */
+    search(query: ModelSearchQuery): LlxprtModel[];
+    /**
+     * Get all providers
+     */
+    getProviders(): LlxprtProvider[];
+    /**
+     * Get provider by ID
+     */
+    getProvider(providerId: string): LlxprtProvider | undefined;
+    /**
+     * Get cache metadata
+     */
+    getCacheMetadata(): ModelCacheMetadata | null;
+    /**
+     * Check if registry has been initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get model count
+     */
+    getModelCount(): number;
+    /**
+     * Get provider count
+     */
+    getProviderCount(): number;
+    /**
+     * Subscribe to registry events
+     */
+    on(event: ModelRegistryEvent, callback: EventCallback): void;
+    /**
+     * Unsubscribe from registry events
+     */
+    off(event: ModelRegistryEvent, callback: EventCallback): void;
+    /**
+     * Emit an event
+     */
+    private emit;
+}
+/**
+ * Get the global ModelRegistry instance
+ */
+export declare function getModelRegistry(): ModelRegistry;
+/**
+ * Initialize the global ModelRegistry
+ */
+export declare function initializeModelRegistry(): Promise<ModelRegistry>;
+export {};