@pellux/goodvibes-sdk 0.18.14 → 0.18.15

package/dist/_internal/platform/providers/registry.js

@@ -0,0 +1,603 @@
+import { join } from 'node:path';
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { ProviderCapabilityRegistry, } from './capabilities.js';
+import { createDiscoveredProvider, getDiscoveredReasoningFormat } from './discovered-factory.js';
+import { getDiscoveredTraits } from './discovered-traits.js';
+import { getConfiguredApiKeys, getConfiguredModelId, getConfiguredProviderId } from '../config/index.js';
+import { emitProvidersChanged, emitProviderWarning } from '../runtime/emitters/index.js';
+import { loadCustomProviders, watchCustomProviders } from './custom-loader.js';
+import { buildSyntheticCanonicalModels, fetchCatalog, getCatalogCachePath, getCatalogModelDefinitionsFrom, getCatalogTmpPath, getCostFromPricingCatalog, getSyntheticBackendModelIds, getSyntheticModelDefinitions, getSyntheticModelInfo, isCatalogCacheStale, loadCatalogCache, notifyCatalogChanges, saveCatalogCache, } from './model-catalog.js';
+import { registerBuiltinProviders, CATALOG_PROVIDER_NAME_ALIASES } from './builtin-registry.js';
+import { LocalContextIngestionService } from '@pellux/goodvibes-sdk/platform/providers/local-context-ingestion';
+import { getModelLimitsCachePath, ModelLimitsService } from './model-limits.js';
+import { getGitHubCopilotTokenCachePath } from './github-copilot.js';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+import { getBaseModelId, splitModelRegistryKey, stableStringify, withRegistryKey, } from './registry-helpers.js';
+import { buildModelRegistry, findModelDefinition, findModelDefinitionForProvider, } from './registry-models.js';
+/**
+ * ProviderRegistry — manages LLM provider instances and model selection.
+ * Lazily instantiates providers on first use.
+ */
+export class ProviderRegistry {
+    providers = new Map();
+    currentModelId;
+    discoveredProviderNames = new Set();
+    runtimeProviderNames = new Set();
+    customModels = [];
+    runtimeModels = [];
+    discoveredModels = [];
+    runtimeCatalogSuppressions = new Map();
+    _watcher;
+    _readyPromise = null;
+    configManager;
+    subscriptionManager;
+    capabilityRegistry;
+    cacheHitTracker;
+    featureFlags;
+    favoritesStore;
+    benchmarkStore;
+    modelLimitsService;
+    runtimeMetadataDeps;
+    runtimeBus;
+    localContextIngestionService = new LocalContextIngestionService();
+    catalogModels = [];
+    pricingCatalog = null;
+    syntheticCanonicalModels = [];
+    constructor(options) {
+        this.configManager = options.configManager;
+        this.subscriptionManager = options.subscriptionManager;
+        this.capabilityRegistry = options.capabilityRegistry;
+        this.cacheHitTracker = options.cacheHitTracker;
+        this.favoritesStore = options.favoritesStore;
+        this.benchmarkStore = options.benchmarkStore;
+        this.modelLimitsService = options.modelLimitsService ?? new ModelLimitsService({
+            cachePath: getModelLimitsCachePath(this.getPersistenceRoot()),
+        });
+        this.runtimeMetadataDeps = {
+            secretsManager: options.secretsManager,
+            serviceRegistry: options.serviceRegistry,
+            subscriptionManager: options.subscriptionManager,
+        };
+        this.featureFlags = options.featureFlags ?? null;
+        this.runtimeBus = options.runtimeBus ?? null;
+        this.currentModelId = getConfiguredModelId(this.configManager) || 'openrouter/free';
+        this.registerBuiltins();
+    }
+    registerBuiltins() {
+        const apiKey = (name) => getConfiguredApiKeys()[name] ?? '';
+        registerBuiltinProviders(this, (name) => this.providers.has(name), apiKey, {
+            cacheHitTracker: this.cacheHitTracker,
+            resolveProvider: (providerName) => this.get(providerName),
+            getCatalogModels: () => this.syntheticCanonicalModels,
+            getBenchmarks: (modelId) => this.benchmarkStore.getBenchmarks(modelId),
+            githubCopilotTokenCachePath: getGitHubCopilotTokenCachePath(this.getPersistenceRoot()),
+            subscriptionManager: this.subscriptionManager,
+            runtimeBus: this.runtimeBus,
+        });
+    }
+    getPersistenceRoot() {
+        return this.configManager.getControlPlaneConfigDir();
+    }
+    getCustomProvidersDir() {
+        return join(this.getPersistenceRoot(), 'providers');
+    }
+    getCatalogCachePaths() {
+        const cachePath = getCatalogCachePath(this.getPersistenceRoot());
+        return {
+            cachePath,
+            tmpPath: getCatalogTmpPath(this.getPersistenceRoot()),
+        };
+    }
+    getCatalogBuiltins() {
+        return getCatalogModelDefinitionsFrom(this.catalogModels);
+    }
+    getSyntheticBuiltins() {
+        return getSyntheticModelDefinitions(this.catalogModels, this.syntheticCanonicalModels);
+    }
+    updateCatalogState(models) {
+        this.catalogModels = [...models];
+        this.pricingCatalog = { fetchedAt: Date.now(), models: this.catalogModels };
+        this.syntheticCanonicalModels = buildSyntheticCanonicalModels(this.catalogModels);
+    }
+    getSuppressedCatalogModelIds() {
+        return new Set([...this.runtimeCatalogSuppressions.values()].flat());
+    }
+    getModelRegistry() {
+        return buildModelRegistry({
+            customModels: this.customModels,
+            runtimeModels: this.runtimeModels,
+            syntheticModels: this.getSyntheticBuiltins(),
+            catalogModels: this.getCatalogBuiltins(),
+            discoveredModels: this.discoveredModels,
+            suppressedCatalogIds: this.getSuppressedCatalogModelIds(),
+        });
+    }
+    /** Register a provider. Overwrites any existing entry with the same name. */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Register a runtime/plugin-owned provider and optional model definitions.
+     * Returns an unregister callback so plugin cleanup can remove the provider and
+     * its runtime model/catalog contributions.
+     */
+    registerRuntimeProvider(registration) {
+        const { provider, models = [], suppressCatalogModels = [], replace = false } = registration;
+        if (this.providers.has(provider.name) && !this.runtimeProviderNames.has(provider.name) && !replace) {
+            throw new Error(`Provider '${provider.name}' is already registered.`);
+        }
+        this.providers.set(provider.name, provider);
+        this.runtimeProviderNames.add(provider.name);
+        this.runtimeModels = [
+            ...this.runtimeModels.filter((model) => model.provider !== provider.name),
+            ...models.map((model) => withRegistryKey({
+                ...model,
+                provider: provider.name,
+                registryKey: model.registryKey || `${provider.name}:${model.id}`,
+            })),
+        ];
+        this.runtimeCatalogSuppressions.set(provider.name, [...new Set(suppressCatalogModels)]);
+        this.capabilityRegistry.invalidate();
+        return () => {
+            if (!this.runtimeProviderNames.has(provider.name))
+                return;
+            this.providers.delete(provider.name);
+            this.runtimeProviderNames.delete(provider.name);
+            this.runtimeModels = this.runtimeModels.filter((model) => model.provider !== provider.name);
+            this.runtimeCatalogSuppressions.delete(provider.name);
+            this.capabilityRegistry.invalidate();
+        };
+    }
+    listProviders() {
+        return [...this.providers.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * Register providers discovered by the local LLM scanner.
+     * Clears previously discovered providers before re-registering.
+     * Does not overwrite built-in or custom-loaded providers/models.
+     */
+    registerDiscoveredProviders(servers) {
+        // Unregister previously discovered providers
+        for (const name of this.discoveredProviderNames) {
+            this.providers.delete(name);
+        }
+        this.discoveredProviderNames.clear();
+        this.discoveredModels = [];
+        for (const server of servers) {
+            // Skip if a non-discovered provider already holds this name
+            if (this.providers.has(server.name))
+                continue;
+            // Skip servers with no models — defaultModel would be undefined
+            if (server.models.length === 0)
+                continue;
+            const reasoningFormat = getDiscoveredReasoningFormat(server.serverType);
+            const traits = getDiscoveredTraits(server.serverType);
+            const provider = createDiscoveredProvider(server);
+            this.providers.set(server.name, provider);
+            this.discoveredProviderNames.add(server.name);
+            for (const modelId of server.models) {
+                this.discoveredModels.push({
+                    id: modelId,
+                    provider: server.name,
+                    registryKey: `${server.name}:${modelId}`,
+                    displayName: modelId,
+                    description: `Discovered local model on ${server.baseURL}`,
+                    capabilities: traits.modelCapabilities,
+                    ...(traits.reasoningEffort ? { reasoningEffort: traits.reasoningEffort } : {}),
+                    contextWindow: server.modelContextWindows?.[modelId] ?? 8192,
+                    ...(server.modelContextWindows?.[modelId] != null
+                        ? { contextWindowProvenance: 'provider_api' }
+                        : {}),
+                    ...(server.modelOutputLimits?.[modelId] != null
+                        ? { tokenLimits: { maxOutputTokens: server.modelOutputLimits[modelId] } }
+                        : {}),
+                    selectable: true,
+                    tier: 'standard',
+                });
+            }
+        }
+    }
+    /** Retrieve a provider by name. Throws if not found. */
+    get(name) {
+        if (name === 'openai' && this.subscriptionManager.get('openai')) {
+            const subscriber = this.providers.get('openai-subscriber');
+            if (subscriber)
+                return subscriber;
+        }
+        return this.getRegistered(name);
+    }
+    /** Retrieve the directly-registered provider without subscription route aliasing. */
+    getRegistered(name) {
+        const p = this.providers.get(name);
+        if (p)
+            return p;
+        // Check alias map — catalog may use a different name than the registered provider
+        const aliased = CATALOG_PROVIDER_NAME_ALIASES[name];
+        if (aliased) {
+            const pa = this.providers.get(aliased);
+            if (pa)
+                return pa;
+        }
+        throw new Error(`Provider '${name}' is not registered.`);
+    }
+    async describeRuntime(name) {
+        const provider = this.getRegistered(name);
+        if (!provider.describeRuntime)
+            return null;
+        return await provider.describeRuntime(this.runtimeMetadataDeps);
+    }
+    /** Return the provider responsible for a given model ID.
+     * Accepts a registryKey (`provider:modelId`) OR a plain modelId.
+     * - If input contains `:`, treats as registryKey — exact match on `m.registryKey`
+     * - If no `:`, treats as plain modelId — exact match on `m.id`
+     * When `provider` is supplied alongside a plain modelId, it disambiguates.
+     * Explicit provider constraints do not fall through to other providers.
+     */
+    getForModel(modelId, provider) {
+        const registry = this.getModelRegistry();
+        const def = provider
+            ? findModelDefinitionForProvider(modelId, provider, registry, CATALOG_PROVIDER_NAME_ALIASES)
+            : findModelDefinition(modelId, registry);
+        if (!def) {
+            if (provider)
+                throw new Error(`No model '${modelId}' for provider '${provider}' in registry.`);
+            throw new Error(`No model '${modelId}' in registry.`);
+        }
+        return this.get(def.provider);
+    }
+    /** All registered model definitions. */
+    listModels() {
+        return this.getModelRegistry();
+    }
+    getCostFromCatalog(modelId) {
+        return getCostFromPricingCatalog(modelId, this.pricingCatalog ?? { fetchedAt: Date.now(), models: this.catalogModels }, this.modelLimitsService);
+    }
+    getContextWindowForModel(modelDef) {
+        return this.modelLimitsService.getContextWindowForModel(modelDef);
+    }
+    getTokenLimitsForModel(modelDef) {
+        return this.modelLimitsService.getTokenLimitsForModel(modelDef);
+    }
+    getPricingForModel(modelId, provider) {
+        return this.modelLimitsService.getPricingForModel(modelId, provider);
+    }
+    getToolResultMaxCharsForModel(model) {
+        return this.modelLimitsService.getToolResultMaxCharsForModel(model);
+    }
+    initModelLimits() {
+        this.modelLimitsService.init();
+    }
+    refreshModelLimits() {
+        return this.modelLimitsService.refresh();
+    }
+    getRawCatalogModels() {
+        return [...this.catalogModels];
+    }
+    getCatalogModelDefinitions() {
+        return getCatalogModelDefinitionsFrom(this.catalogModels);
+    }
+    getSyntheticModelDefinitions() {
+        return getSyntheticModelDefinitions(this.catalogModels, this.syntheticCanonicalModels);
+    }
+    getSyntheticCanonicalModels() {
+        return [...this.syntheticCanonicalModels];
+    }
+    getSyntheticBackendModelIds() {
+        return getSyntheticBackendModelIds(this.syntheticCanonicalModels);
+    }
+    getSyntheticModelInfoFromCatalog(modelId) {
+        return getSyntheticModelInfo(modelId, this.syntheticCanonicalModels, (candidateId) => this.benchmarkStore.getBenchmarks(candidateId));
+    }
+    getConfiguredProviderIds() {
+        const configured = new Set();
+        const providerEnvMap = new Map();
+        for (const model of this.catalogModels) {
+            if (!providerEnvMap.has(model.providerId)) {
+                providerEnvMap.set(model.providerId, model.providerEnvVars);
+            }
+        }
+        for (const [providerId, envVars] of providerEnvMap) {
+            if (envVars.length === 0) {
+                configured.add(providerId);
+            }
+            else if (envVars.some((envVar) => {
+                const value = process.env[envVar];
+                return typeof value === 'string' && value.length > 0;
+            })) {
+                configured.add(providerId);
+            }
+        }
+        try {
+            const configApiKeys = getConfiguredApiKeys();
+            const configToCatalog = { gemini: 'google', inceptionlabs: 'inception' };
+            for (const [configName, key] of Object.entries(configApiKeys)) {
+                if (key) {
+                    configured.add(configToCatalog[configName] ?? configName);
+                }
+            }
+        }
+        catch {
+            // non-fatal
+        }
+        if (this.getSyntheticBackendModelIds().size > 0) {
+            configured.add('synthetic');
+        }
+        return [...configured];
+    }
+    /** Only the models the user can switch to. */
+    getSelectableModels() {
+        return this.getModelRegistry().filter((m) => m.selectable);
+    }
+    /** Currently active model definition. */
+    getCurrentModel() {
+        const registry = this.getModelRegistry();
+        const def = findModelDefinition(this.currentModelId, registry);
+        if (!def) {
+            const baseId = getBaseModelId(this.currentModelId);
+            const isInCatalog = this.getCatalogBuiltins().some((m) => m.id === baseId || m.id === this.currentModelId);
+            if (!isInCatalog && this.currentModelId) {
+                const placeholderProvider = this.currentModelId.includes(':')
+                    ? this.currentModelId.split(':')[0]
+                    : (getConfiguredProviderId(this.configManager) || 'unknown');
+                return {
+                    id: baseId,
+                    provider: placeholderProvider ?? 'unknown',
+                    registryKey: this.currentModelId.includes(':') ? this.currentModelId : `${placeholderProvider}:${baseId}`,
+                    displayName: baseId,
+                    description: 'Waiting for provider discovery...',
+                    capabilities: { toolCalling: false, codeEditing: false, reasoning: false, multimodal: false },
+                    contextWindow: 0, // Unknown until provider discovery completes; 0 = no progress bar
+                    selectable: true,
+                    tier: 'standard',
+                };
+            }
+            // Builtin model not found — genuinely broken, fall back to first selectable
+            const fallback = this.getModelRegistry().find((m) => m.selectable);
+            if (fallback) {
+                this.currentModelId = fallback.id;
+                return fallback;
+            }
+            throw new Error(`Current model '${this.currentModelId}' not in registry.`);
+        }
+        return def;
+    }
+    /**
+     * Override the context window cap for a custom or discovered (local) model.
+     * Mutates the live model entry in customModels or discoveredModels so the change
+     * is reflected immediately without requiring a full provider reload.
+     *
+     * @param registryKey - The model's registryKey (`provider:id`).
+     * @param cap         - New context window value in tokens.
+     * @remarks Context cap is session-only. Not persisted to config — lost on restart.
+     */
+    setModelContextCap(registryKey, cap) {
+        // Try customModels first, then discoveredModels
+        const customIdx = this.customModels.findIndex((m) => m.registryKey === registryKey || m.id === registryKey);
+        if (customIdx >= 0) {
+            this.customModels[customIdx] = {
+                ...this.customModels[customIdx],
+                contextWindow: cap,
+                contextWindowProvenance: 'configured_cap',
+            };
+            return;
+        }
+        const discoveredIdx = this.discoveredModels.findIndex((m) => m.registryKey === registryKey || m.id === registryKey);
+        if (discoveredIdx >= 0) {
+            this.discoveredModels[discoveredIdx] = {
+                ...this.discoveredModels[discoveredIdx],
+                contextWindow: cap,
+                contextWindowProvenance: 'configured_cap',
+            };
+            return;
+        }
+        logger.warn('[registry] setModelContextCap: model not found', { registryKey });
+    }
+    /** Switch to a different model. Accepts registryKey or plain modelId. Throws if not selectable. */
+    setCurrentModel(modelId) {
+        const def = findModelDefinition(modelId, this.getModelRegistry());
+        if (!def)
+            throw new Error(`Model '${modelId}' not found.`);
+        if (!def.selectable)
+            throw new Error(`Model '${modelId}' is not selectable.`);
+        // Store the registryKey for unambiguous future lookups
+        this.currentModelId = def.registryKey ?? modelId;
+    }
+    /**
+     * Load custom providers from ~/.goodvibes/goodvibes/providers/ and merge them
+     * into the live model registry. Returns any warnings collected during loading.
+     * Call this after construction to populate custom providers.
+     */
+    async loadCustomProviders() {
+        const result = await loadCustomProviders({
+            providersDir: this.getCustomProvidersDir(),
+            ingestContextWindows: this.featureFlags?.isEnabled('local-provider-context-ingestion') ?? false,
+            contextIngestion: this.localContextIngestionService,
+        });
+        const previousIds = new Set(this.customModels.map((m) => m.id));
+        const newIds = new Set(result.models.map((m) => m.id));
+        const added = [];
+        const removed = [];
+        const updated = [];
+        for (const id of newIds) {
+            if (!previousIds.has(id)) {
+                added.push(id);
+            }
+            else {
+                // Only mark as updated if the model definition actually changed
+                const oldModel = this.customModels.find((m) => m.id === id);
+                const newModel = result.models.find((m) => m.id === id);
+                if (stableStringify(oldModel) !== stableStringify(newModel)) {
+                    updated.push(id);
+                }
+            }
+        }
+        for (const id of previousIds) {
+            if (!newIds.has(id))
+                removed.push(id);
+        }
+        // Warn about collisions with catalog models
+        const catalogIds = new Set(this.getCatalogBuiltins().map((b) => b.id));
+        for (const model of result.models) {
+            if (catalogIds.has(model.id)) {
+                const msg = `[registry] Custom model '${model.id}' from provider '${model.provider}' overrides catalog model.`;
+                result.warnings.push(msg);
+                // Warning already added to result.warnings — don't console.warn (corrupts TUI)
+            }
+        }
+        // Register provider instances
+        for (const { provider } of result.providers) {
+            this.register(provider);
+        }
+        // Swap custom models
+        this.customModels = result.models;
+        return { warnings: result.warnings, added, removed, updated };
+    }
+    /**
+     * Start watching ~/.goodvibes/goodvibes/providers/ for file changes.
+     * On change, reloads custom providers and emits typed provider runtime events.
+     * Safe to call multiple times — stops the previous watcher first.
+     */
+    startWatching(runtimeBus = null) {
+        this.stopWatching();
+        this._watcher = watchCustomProviders(runtimeBus, async () => {
+            const result = await this.loadCustomProviders();
+            for (const msg of result.warnings) {
+                if (runtimeBus) {
+                    emitProviderWarning(runtimeBus, {
+                        sessionId: 'system',
+                        traceId: `providers:warning:${Date.now()}`,
+                        source: 'provider-registry',
+                    }, { message: msg });
+                }
+            }
+            if (runtimeBus) {
+                emitProvidersChanged(runtimeBus, {
+                    sessionId: 'system',
+                    traceId: `providers:changed:${Date.now()}`,
+                    source: 'provider-registry',
+                }, {
+                    added: result.added,
+                    removed: result.removed,
+                    updated: result.updated,
+                });
+            }
+        }, this.getCustomProvidersDir());
+    }
+    /** Stop the file watcher started by startWatching(). */
+    stopWatching() {
+        if (this._watcher) {
+            this._watcher.close();
+            this._watcher = undefined;
+        }
+    }
+    /**
+     * Returns a promise that resolves when the initial custom provider load
+     * completes. Callers can await this before calling getForModel() with a
+     * custom model ID to avoid a "model not found" race window.
+     */
+    ready() {
+        return this._readyPromise ?? Promise.resolve();
+    }
+    /**
+     * Find an alternative model when the current provider fails non-transiently.
+     * Prefers a synthetic failover wrapper; falls back to same-tier model on a different provider.
+     */
+    findAlternativeModel(currentModelId) {
+        const current = findModelDefinition(currentModelId, this.getModelRegistry());
+        if (!current || current.provider === 'synthetic')
+            return null;
+        // Check if synthetic wrapper exists
+        const baseName = current.id.split('/').pop() ?? '';
+        const syntheticMatch = this.getModelRegistry().find((model) => model.provider === 'synthetic' && (model.id === baseName || model.id.endsWith('/' + baseName)));
+        if (syntheticMatch)
+            return syntheticMatch;
+        // Find same-tier model on different provider
+        return this.getModelRegistry().find((model) => model.id !== currentModelId && model.provider !== current.provider && model.tier === current.tier && model.selectable) ?? null;
+    }
+    /**
+     * Resolve the full capability record for a model.
+     * Accepts a plain model ID or a `provider:modelId` registryKey.
+     *
+     * @param modelId - Plain model ID or registryKey (`provider:modelId`).
+     * @returns A fully-resolved, immutable `ProviderCapability`.
+     */
+    getCapabilityForModel(modelId) {
+        const { providerId, resolvedModelId, provider } = this._resolveModelContext(modelId);
+        return this.capabilityRegistry.getCapability(providerId, resolvedModelId, provider);
+    }
+    /**
+     * Check whether a model can handle a request described by `profile`.
+     * Fails early with a typed explanation when unsupported — avoids mid-stream errors.
+     *
+     * @param modelId - Plain model ID or registryKey.
+     * @param profile - The capability requirements for this request.
+     * @returns A `RouteExplanation` with `accepted` flag, rejections, and capability.
+     */
+    explainRoute(modelId, profile) {
+        const { providerId, resolvedModelId, provider } = this._resolveModelContext(modelId);
+        return this.capabilityRegistry.getRouteExplanation(providerId, resolvedModelId, profile, provider);
+    }
+    /**
+     * Resolve the provider identity and instance for a plain model ID or registryKey.
+     * Shared by `getCapabilityForModel` and `explainRoute` to avoid duplication.
+     *
+     * @param modelId - Plain model ID or registryKey (`provider:modelId`).
+     */
+    _resolveModelContext(modelId) {
+        const registry = this.getModelRegistry();
+        const def = findModelDefinition(modelId, registry);
+        const { providerId: fallbackProviderId, resolvedModelId: fallbackModelId } = splitModelRegistryKey(modelId);
+        const providerId = def?.provider ?? fallbackProviderId;
+        const resolvedModelId = def?.id ?? fallbackModelId;
+        let provider;
+        try {
+            provider = this.get(providerId);
+        }
+        catch {
+            // Provider not registered yet — proceed without self-declared capabilities
+        }
+        return { providerId, resolvedModelId, provider };
+    }
+    /** Kick off async custom provider loading. Called once from bootstrap-owned construction. */
+    initCustomProviders() {
+        this._readyPromise = this.loadCustomProviders()
+            .then((result) => {
+            // Warnings captured in result.warnings — don't console.warn (corrupts TUI)
+            // Invalidate the capability cache so custom providers' self-declared
+            // capabilities are reflected in subsequent getCapabilityForModel calls.
+            this.capabilityRegistry.invalidate();
+            this._readyPromise = null;
+        })
+            .catch((err) => {
+            // Non-fatal — don't console.warn (corrupts TUI display)
+            this._readyPromise = null;
+        });
+    }
+    initCatalog() {
+        const cached = loadCatalogCache(this.getCatalogCachePaths().cachePath);
+        if (cached) {
+            this.catalogModels = [...cached.models];
+            this.pricingCatalog = { fetchedAt: cached.fetchedAt, models: this.catalogModels };
+            this.syntheticCanonicalModels = buildSyntheticCanonicalModels(this.catalogModels);
+        }
+        if (!cached || isCatalogCacheStale(cached)) {
+            void this.refreshCatalog().catch((err) => {
+                logger.debug('[model-catalog] Background refresh failed', { error: summarizeError(err) });
+            });
+        }
+    }
+    async refreshCatalog() {
+        const previous = [...this.catalogModels];
+        const models = await fetchCatalog();
+        if (models.length === 0) {
+            logger.warn('[model-catalog] Refresh returned 0 models — keeping existing catalog');
+            return;
+        }
+        const { cachePath, tmpPath } = this.getCatalogCachePaths();
+        saveCatalogCache(models, cachePath, tmpPath);
+        this.updateCatalogState(models);
+        const favorites = await this.favoritesStore.load();
+        notifyCatalogChanges(previous, this.catalogModels, favorites, this.benchmarkStore.getTopBenchmarkModelIds(10));
+        logger.debug('[model-catalog] Catalog updated', { count: models.length });
+    }
+}

package/dist/_internal/platform/providers/runtime-metadata.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderAuthRouteDescriptor, ProviderRuntimeMetadataDeps } from './interface.js';
+export interface StandardProviderAuthOptions {
+    readonly providerId: string;
+    readonly apiKeyEnvVars?: readonly string[];
+    readonly secretKeys?: readonly string[];
+    readonly serviceNames?: readonly string[];
+    readonly subscriptionProviderId?: string;
+    readonly allowAnonymous?: boolean;
+    readonly anonymousConfigured?: boolean;
+    readonly anonymousDetail?: string;
+}
+export declare function buildStandardProviderAuthRoutes(options: StandardProviderAuthOptions, deps: ProviderRuntimeMetadataDeps): Promise<readonly ProviderAuthRouteDescriptor[]>;
+//# sourceMappingURL=runtime-metadata.d.ts.map

package/dist/_internal/platform/providers/runtime-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-metadata.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/providers/runtime-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE/F,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AASD,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,2BAA2B,EACpC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CA4HjD"}