@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/runtime/ui/model-picker/data-provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * ModelPickerDataProvider — enriched model picker data surface.
+ *
+ * Combines ModelDefinition records from the provider registry with
+ * ProviderHealthDomainState and ModelDomainState to produce a single,
+ * sorted, health-enriched ModelPickerData snapshot for UI consumption.
+ *
+ * This class is a data provider only — it contains no rendering logic.
+ * Subscribe to change notifications and call getSnapshot() to render.
+ */
+import type { ModelDefinition } from '../../../providers/registry.js';
+import type { ProviderRegistry } from '../../../providers/registry.js';
+import type { BenchmarkStore } from '@pellux/goodvibes-sdk/platform/providers/model-benchmarks';
+import type { ProviderHealthDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/provider-health';
+import type { ModelDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/model';
+import type { ModelPickerData } from './types.js';
+/** Options for constructing a ModelPickerDataProvider. */
+export interface ModelPickerDataProviderOptions {
+    /**
+     * Initial set of pinned model IDs.
+     * Call updatePinnedIds() to update at runtime.
+     */
+    readonly pinnedIds?: ReadonlySet<string>;
+    readonly benchmarkStore: Pick<BenchmarkStore, 'getBenchmarks'>;
+    readonly providerRegistry: Pick<ProviderRegistry, 'getSyntheticModelInfoFromCatalog' | 'getContextWindowForModel'>;
+}
+/**
+ * ModelPickerDataProvider produces enriched model picker data snapshots.
+ *
+ * Usage:
+ * ```ts
+ * const provider = new ModelPickerDataProvider(models, healthState, modelState);
+ * const unsub = provider.subscribe(() => {
+ *   const data = provider.getSnapshot();
+ *   // render data.entries or data.groups
+ * });
+ * // When health or model state changes:
+ * provider.updateHealthState(newHealthState);
+ * provider.updateModelState(newModelState);
+ * // Cleanup:
+ * unsub();
+ * provider.dispose();
+ * ```
+ */
+export declare class ModelPickerDataProvider {
+    private _models;
+    private _healthState;
+    private _modelState;
+    private _pinnedIds;
+    private _snapshot;
+    private readonly benchmarkStore;
+    private readonly providerRegistry;
+    private readonly _subscribers;
+    constructor(models: readonly ModelDefinition[], healthState: ProviderHealthDomainState, modelState: ModelDomainState, options: ModelPickerDataProviderOptions);
+    /**
+     * Return the current enriched model picker data snapshot.
+     * This is updated synchronously when state changes via update methods.
+     */
+    getSnapshot(): ModelPickerData;
+    /**
+     * Register a callback invoked whenever the snapshot changes.
+     * @returns An unsubscribe function.
+     */
+    subscribe(callback: () => void): () => void;
+    /**
+     * Update the model list (e.g. after registry reload).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateModels(models: readonly ModelDefinition[]): void;
+    /**
+     * Update health state (e.g. on ProviderHealthDomainState change).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateHealthState(healthState: ProviderHealthDomainState): void;
+    /**
+     * Update model domain state (e.g. on active model or fallback change).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateModelState(modelState: ModelDomainState): void;
+    /**
+     * Update the pinned/favorites model ID set.
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updatePinnedIds(pinnedIds: ReadonlySet<string>): void;
+    /**
+     * Release all subscriber references.
+     * Does not clear internal state — getSnapshot() remains usable after disposal.
+     */
+    dispose(): void;
+    private _rebuild;
+    private _buildSnapshot;
+    private _notify;
+}
+//# sourceMappingURL=data-provider.d.ts.map

package/dist/_internal/platform/runtime/ui/model-picker/data-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-provider.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/ui/model-picker/data-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sEAAsE,CAAC;AACtH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AAEnG,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AAEpE,0DAA0D;AAC1D,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kCAAkC,GAAG,0BAA0B,CAAC,CAAC;CACpH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0F;IAC3H,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAGpD,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,yBAAyB,EACtC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,8BAA8B;IAWzC;;;OAGG;IACI,WAAW,IAAI,eAAe;IAIrC;;;OAGG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKlD;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;IAK7D;;;OAGG;IACI,iBAAiB,CAAC,WAAW,EAAE,yBAAyB,GAAG,IAAI;IAKtE;;;OAGG;IACI,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAK3D;;;OAGG;IACI,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAK5D;;;OAGG;IACI,OAAO,IAAI,IAAI;IAMtB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,OAAO;CAShB"}

package/dist/_internal/platform/runtime/ui/model-picker/data-provider.js

@@ -0,0 +1,129 @@
+import { enrichModelEntries, groupEntriesByProvider } from './health-enrichment.js';
+/**
+ * ModelPickerDataProvider produces enriched model picker data snapshots.
+ *
+ * Usage:
+ * ```ts
+ * const provider = new ModelPickerDataProvider(models, healthState, modelState);
+ * const unsub = provider.subscribe(() => {
+ *   const data = provider.getSnapshot();
+ *   // render data.entries or data.groups
+ * });
+ * // When health or model state changes:
+ * provider.updateHealthState(newHealthState);
+ * provider.updateModelState(newModelState);
+ * // Cleanup:
+ * unsub();
+ * provider.dispose();
+ * ```
+ */
+export class ModelPickerDataProvider {
+    _models;
+    _healthState;
+    _modelState;
+    _pinnedIds;
+    _snapshot;
+    benchmarkStore;
+    providerRegistry;
+    _subscribers = new Set();
+    constructor(models, healthState, modelState, options) {
+        this._models = models;
+        this._healthState = healthState;
+        this._modelState = modelState;
+        this._pinnedIds = options.pinnedIds ?? new Set();
+        this.benchmarkStore = options.benchmarkStore;
+        this.providerRegistry = options.providerRegistry;
+        this._snapshot = this._buildSnapshot();
+    }
+    /**
+     * Return the current enriched model picker data snapshot.
+     * This is updated synchronously when state changes via update methods.
+     */
+    getSnapshot() {
+        return this._snapshot;
+    }
+    /**
+     * Register a callback invoked whenever the snapshot changes.
+     * @returns An unsubscribe function.
+     */
+    subscribe(callback) {
+        this._subscribers.add(callback);
+        return () => this._subscribers.delete(callback);
+    }
+    /**
+     * Update the model list (e.g. after registry reload).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateModels(models) {
+        this._models = models;
+        this._rebuild();
+    }
+    /**
+     * Update health state (e.g. on ProviderHealthDomainState change).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateHealthState(healthState) {
+        this._healthState = healthState;
+        this._rebuild();
+    }
+    /**
+     * Update model domain state (e.g. on active model or fallback change).
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updateModelState(modelState) {
+        this._modelState = modelState;
+        this._rebuild();
+    }
+    /**
+     * Update the pinned/favorites model ID set.
+     * Triggers a snapshot rebuild and notifies subscribers.
+     */
+    updatePinnedIds(pinnedIds) {
+        this._pinnedIds = pinnedIds;
+        this._rebuild();
+    }
+    /**
+     * Release all subscriber references.
+     * Does not clear internal state — getSnapshot() remains usable after disposal.
+     */
+    dispose() {
+        this._subscribers.clear();
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    _rebuild() {
+        this._snapshot = this._buildSnapshot();
+        this._notify();
+    }
+    _buildSnapshot() {
+        const entries = enrichModelEntries(this._models, this._healthState, this._modelState, this._pinnedIds, this.benchmarkStore, this.providerRegistry);
+        const groups = groupEntriesByProvider(entries);
+        const degradedProviderIds = [];
+        const unavailableProviderIds = [];
+        for (const [id, record] of this._healthState.providers) {
+            if (record.status === 'degraded' || record.status === 'rate_limited') {
+                degradedProviderIds.push(id);
+            }
+            else if (record.status === 'unavailable' || record.status === 'auth_error') {
+                unavailableProviderIds.push(id);
+            }
+        }
+        return {
+            entries,
+            groups,
+            degradedProviderIds,
+            unavailableProviderIds,
+            activeModelId: this._modelState.activeModelId,
+            snapshotAt: Date.now(),
+        };
+    }
+    _notify() {
+        for (const cb of this._subscribers) {
+            try {
+                cb();
+            }
+            catch {
+                // Non-fatal: subscriber errors must not crash the provider
+            }
+        }
+    }
+}

package/dist/_internal/platform/runtime/ui/model-picker/health-enrichment.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Health enrichment for model picker entries.
+ *
+ * Joins ModelDefinition records from the provider registry with health
+ * telemetry from ProviderHealthDomainState to produce enriched
+ * ModelPickerEntry objects ready for UI consumption.
+ */
+import type { ModelDefinition } from '../../../providers/registry.js';
+import type { ProviderRegistry } from '../../../providers/registry.js';
+import type { BenchmarkStore } from '@pellux/goodvibes-sdk/platform/providers/model-benchmarks';
+import type { ProviderHealthDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/provider-health';
+import type { ModelDomainState } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/model';
+import type { ModelPickerEntry, ModelPickerGroup } from './types.js';
+/**
+ * Enrich a flat list of ModelDefinitions with health and state data.
+ *
+ * @param models - All selectable models from the registry.
+ * @param healthState - Current provider health domain state.
+ * @param modelState - Current model domain state.
+ * @param pinnedIds - Set of pinned/favorited model IDs.
+ * @returns Sorted, enriched ModelPickerEntry array.
+ */
+export declare function enrichModelEntries(models: readonly ModelDefinition[], healthState: ProviderHealthDomainState, modelState: ModelDomainState, pinnedIds: ReadonlySet<string>, benchmarkStore: Pick<BenchmarkStore, 'getBenchmarks'>, providerRegistry: Pick<ProviderRegistry, 'getSyntheticModelInfoFromCatalog' | 'getContextWindowForModel'>): ModelPickerEntry[];
+/**
+ * Group a sorted list of ModelPickerEntry records by their provider ID.
+ * Preserves the sort order of entries within each group.
+ *
+ * @param entries - Pre-sorted enriched entries.
+ * @returns Groups ordered by first appearance of each provider in entries.
+ */
+export declare function groupEntriesByProvider(entries: readonly ModelPickerEntry[]): ModelPickerGroup[];
+//# sourceMappingURL=health-enrichment.d.ts.map

package/dist/_internal/platform/runtime/ui/model-picker/health-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-enrichment.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/ui/model-picker/health-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAwB,MAAM,sEAAsE,CAAC;AAC5I,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AAEnG,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAMjB,MAAM,YAAY,CAAC;AAkIpB;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,yBAAyB,EACtC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EACrD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kCAAkC,GAAG,0BAA0B,CAAC,GACxG,gBAAgB,EAAE,CAiEpB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAgB/F"}

package/dist/_internal/platform/runtime/ui/model-picker/health-enrichment.js

@@ -0,0 +1,208 @@
+import { getQualityTier, getQualityTierFromScore, compositeScore } from '@pellux/goodvibes-sdk/platform/providers/model-benchmarks';
+/** Status sort priority (lower = shown first). */
+const STATUS_ORDER = {
+    healthy: 0,
+    unknown: 1,
+    degraded: 2,
+    rate_limited: 3,
+    auth_error: 4,
+    unavailable: 5,
+};
+const FAMILY_PATTERNS = [
+    { pattern: /claude/i, family: 'Claude' },
+    { pattern: /gpt|\bo1\b|\bo3\b|\bo4\b/i, family: 'GPT' },
+    { pattern: /gemini/i, family: 'Gemini' },
+    { pattern: /llama/i, family: 'Llama' },
+    { pattern: /qwen/i, family: 'Qwen' },
+    { pattern: /glm|chatglm/i, family: 'GLM' },
+    { pattern: /minimax|abab/i, family: 'MiniMax' },
+    { pattern: /deepseek/i, family: 'DeepSeek' },
+    { pattern: /mistral|mixtral/i, family: 'Mistral' },
+    { pattern: /command|cohere/i, family: 'Command' },
+    { pattern: /grok/i, family: 'Grok' },
+    { pattern: /kimi|moonshot/i, family: 'Kimi' },
+];
+function detectFamily(model) {
+    const haystack = `${model.id} ${model.displayName}`;
+    for (const { pattern, family } of FAMILY_PATTERNS) {
+        if (pattern.test(haystack))
+            return family;
+    }
+    return 'Other';
+}
+function tierToCategoryFilter(tier) {
+    if (tier === 'free')
+        return 'free';
+    if (tier === 'subscription')
+        return 'subscription';
+    return 'paid';
+}
+/**
+ * Derive ProviderHealthContext from a ProviderHealthRecord.
+ * Returns a safe default when the record is absent (provider not yet observed).
+ */
+function buildHealthContext(record) {
+    if (!record) {
+        return {
+            status: 'unknown',
+            isConfigured: false,
+        };
+    }
+    let latency;
+    if (record.stats.totalCalls > 0) {
+        latency = {
+            avgMs: record.stats.avgLatencyMs,
+            p95Ms: record.stats.maxLatencyMs,
+            minMs: record.stats.minLatencyMs,
+        };
+    }
+    return {
+        status: record.status,
+        latency,
+        cacheHitRate: record.cacheMetrics?.hitRate,
+        isConfigured: record.isConfigured,
+        rateLimitResetAt: record.rateLimitResetAt,
+    };
+}
+/**
+ * Derive CapabilityFlags from a ModelDefinition.
+ */
+function buildCapabilityFlags(model) {
+    return {
+        reasoning: model.capabilities?.reasoning ?? false,
+        caching: false, // caching capability is provider-level; enriched separately if needed
+        toolCalling: model.capabilities?.toolCalling ?? false,
+        multimodal: model.capabilities?.multimodal ?? false,
+        codeEditing: model.capabilities?.codeEditing ?? false,
+    };
+}
+/**
+ * Derive quality tier and benchmark score for a model.
+ * Handles synthetic models (catalog-backed composite scores) and standard models.
+ */
+function buildQualityInfo(model, benchmarkStore, providerRegistry) {
+    if (model.provider === 'synthetic') {
+        const info = providerRegistry.getSyntheticModelInfoFromCatalog(model.id);
+        if (info?.bestCompositeScore != null) {
+            return {
+                qualityTier: getQualityTierFromScore(info.bestCompositeScore),
+                benchmarkScore: info.bestCompositeScore,
+            };
+        }
+        return {};
+    }
+    const benchmarks = benchmarkStore.getBenchmarks(model.id) ?? benchmarkStore.getBenchmarks(model.displayName);
+    if (!benchmarks)
+        return {};
+    return {
+        qualityTier: getQualityTier(benchmarks.benchmarks),
+        benchmarkScore: compositeScore(benchmarks.benchmarks) ?? undefined,
+    };
+}
+/**
+ * Build the set of model IDs in the current fallback chain.
+ * Returns a Map from modelId to its position (0 = primary).
+ */
+function buildFallbackPositionMap(modelState) {
+    const map = new Map();
+    // Position 0 is always the primary active model
+    map.set(modelState.activeModelId, 0);
+    for (let i = 0; i < modelState.fallbackChain.length; i++) {
+        const entry = modelState.fallbackChain[i];
+        if (!map.has(entry.modelId)) {
+            map.set(entry.modelId, i + 1);
+        }
+    }
+    return map;
+}
+/**
+ * Enrich a flat list of ModelDefinitions with health and state data.
+ *
+ * @param models - All selectable models from the registry.
+ * @param healthState - Current provider health domain state.
+ * @param modelState - Current model domain state.
+ * @param pinnedIds - Set of pinned/favorited model IDs.
+ * @returns Sorted, enriched ModelPickerEntry array.
+ */
+export function enrichModelEntries(models, healthState, modelState, pinnedIds, benchmarkStore, providerRegistry) {
+    const fallbackPositions = buildFallbackPositionMap(modelState);
+    const entries = models.map((model) => {
+        const record = healthState.providers.get(model.provider);
+        const health = buildHealthContext(record);
+        const { qualityTier, benchmarkScore } = buildQualityInfo(model, benchmarkStore, providerRegistry);
+        const isProviderDegraded = health.status === 'degraded' || health.status === 'rate_limited';
+        const isProviderUnavailable = health.status === 'unavailable' || health.status === 'auth_error';
+        const fallbackPosition = fallbackPositions.get(model.id);
+        // Resolve effective context window and determine display source label.
+        const effectiveContextWindow = providerRegistry.getContextWindowForModel(model);
+        // Determine source: custom/local providers carry provenance on ModelDefinition;
+        // for catalog models, if getContextWindowForModel returned more than the
+        // static contextWindow it came from OpenRouter, else it's the registry value.
+        let contextWindowSource;
+        if (model.contextWindowProvenance) {
+            contextWindowSource = model.contextWindowProvenance;
+        }
+        else if (effectiveContextWindow !== model.contextWindow) {
+            contextWindowSource = 'openrouter';
+        }
+        else {
+            contextWindowSource = 'registry';
+        }
+        return {
+            modelId: model.id,
+            providerId: model.provider,
+            displayName: model.displayName,
+            family: detectFamily(model),
+            pricingTier: tierToCategoryFilter(model.tier),
+            qualityTier,
+            benchmarkScore,
+            capabilities: buildCapabilityFlags(model),
+            health,
+            contextWindow: effectiveContextWindow,
+            contextWindowSource,
+            isPinned: pinnedIds.has(model.id),
+            isActive: model.id === modelState.activeModelId,
+            isProviderDegraded,
+            isProviderUnavailable,
+            isInFallbackChain: fallbackPosition !== undefined,
+            fallbackPosition,
+        };
+    });
+    // Sort: healthy providers first, then degraded, then unavailable.
+    // Within each status bucket: pinned first, then active, then by display name.
+    entries.sort((a, b) => {
+        const statusDiff = (STATUS_ORDER[a.health.status] ?? 1) - (STATUS_ORDER[b.health.status] ?? 1);
+        if (statusDiff !== 0)
+            return statusDiff;
+        // Pinned before unpinned
+        if (a.isPinned !== b.isPinned)
+            return a.isPinned ? -1 : 1;
+        // Active before inactive
+        if (a.isActive !== b.isActive)
+            return a.isActive ? -1 : 1;
+        return a.displayName.localeCompare(b.displayName);
+    });
+    return entries;
+}
+/**
+ * Group a sorted list of ModelPickerEntry records by their provider ID.
+ * Preserves the sort order of entries within each group.
+ *
+ * @param entries - Pre-sorted enriched entries.
+ * @returns Groups ordered by first appearance of each provider in entries.
+ */
+export function groupEntriesByProvider(entries) {
+    const groupMap = new Map();
+    const groupOrder = [];
+    for (const entry of entries) {
+        if (!groupMap.has(entry.providerId)) {
+            groupMap.set(entry.providerId, []);
+            groupOrder.push(entry.providerId);
+        }
+        groupMap.get(entry.providerId).push(entry);
+    }
+    return groupOrder.map((providerId) => ({
+        label: providerId,
+        entries: groupMap.get(providerId),
+    }));
+}

package/dist/_internal/platform/runtime/ui/model-picker/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Model picker UI data surface barrel.
+ *
+ * Re-exports all types and the ModelPickerDataProvider class.
+ * Also provides the createModelPickerData() factory for one-shot snapshots.
+ */
+export type { CapabilityFlags, ProviderLatencyStats, ProviderHealthContext, ModelPickerEntry, ModelPickerGroup, ModelPickerData, } from './types.js';
+export type { ProviderStatus } from './types.js';
+export { ModelPickerDataProvider } from './data-provider.js';
+export type { ModelPickerDataProviderOptions } from './data-provider.js';
+import type { ModelDefinition } from '../../../providers/registry.js';
+import type { ProviderRegistry } from '../../../providers/registry.js';
+import type { BenchmarkStore } from '../../../providers/model-benchmarks.js';
+import type { ProviderHealthDomainState } from '../../store/domains/provider-health.js';
+import type { ModelDomainState } from '../../store/domains/model.js';
+import type { ModelPickerData } from './types.js';
+/**
+ * Produce a one-shot ModelPickerData snapshot without creating a long-lived provider.
+ *
+ * Use this when you need a single render pass and do not require change subscriptions.
+ * For reactive/subscription-based UIs, prefer ModelPickerDataProvider.
+ *
+ * @param models - All selectable models from the registry.
+ * @param healthState - Current provider health domain state.
+ * @param modelState - Current model domain state.
+ * @param pinnedIds - Set of pinned/favorited model IDs.
+ * @returns Immutable ModelPickerData snapshot.
+ */
+export declare function createModelPickerData(models: readonly ModelDefinition[], healthState: ProviderHealthDomainState, modelState: ModelDomainState, benchmarkStore: Pick<BenchmarkStore, 'getBenchmarks'>, providerRegistry: Pick<ProviderRegistry, 'getSyntheticModelInfoFromCatalog' | 'getContextWindowForModel'>, pinnedIds?: ReadonlySet<string>): ModelPickerData;
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/runtime/ui/model-picker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/ui/model-picker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,WAAW,EAAE,yBAAyB,EACtC,UAAU,EAAE,gBAAgB,EAC5B,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EACrD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,kCAAkC,GAAG,0BAA0B,CAAC,EACzG,SAAS,GAAE,WAAW,CAAC,MAAM,CAAa,GACzC,eAAe,CAWjB"}

package/dist/_internal/platform/runtime/ui/model-picker/index.js

@@ -0,0 +1,26 @@
+export { ModelPickerDataProvider } from './data-provider.js';
+import { ModelPickerDataProvider } from './data-provider.js';
+/**
+ * Produce a one-shot ModelPickerData snapshot without creating a long-lived provider.
+ *
+ * Use this when you need a single render pass and do not require change subscriptions.
+ * For reactive/subscription-based UIs, prefer ModelPickerDataProvider.
+ *
+ * @param models - All selectable models from the registry.
+ * @param healthState - Current provider health domain state.
+ * @param modelState - Current model domain state.
+ * @param pinnedIds - Set of pinned/favorited model IDs.
+ * @returns Immutable ModelPickerData snapshot.
+ */
+export function createModelPickerData(models, healthState, modelState, benchmarkStore, providerRegistry, pinnedIds = new Set()) {
+    // Delegate to the data provider for consistent derivation logic,
+    // then dispose immediately since no subscriptions are needed.
+    const dp = new ModelPickerDataProvider(models, healthState, modelState, {
+        pinnedIds,
+        benchmarkStore,
+        providerRegistry,
+    });
+    const snapshot = dp.getSnapshot();
+    dp.dispose();
+    return snapshot;
+}

package/dist/_internal/platform/runtime/ui/model-picker/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Model picker UI data types.
+ *
+ * Purely data-oriented — no rendering logic. These types are produced by
+ * ModelPickerDataProvider and consumed by renderers/components.
+ */
+import type { ProviderStatus } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/provider-health';
+export type { ProviderStatus };
+export type CategoryFilter = 'all' | 'free' | 'paid' | 'subscription';
+export type ModelFamily = 'GPT' | 'Claude' | 'Gemini' | 'Llama' | 'Qwen' | 'GLM' | 'MiniMax' | 'DeepSeek' | 'Mistral' | 'Command' | 'Grok' | 'Kimi' | 'Other';
+/**
+ * Capability flags indicating what a model can do.
+ */
+export interface CapabilityFlags {
+    /** Model supports extended reasoning / chain-of-thought. */
+    readonly reasoning: boolean;
+    /** Model supports prompt caching. */
+    readonly caching: boolean;
+    /** Model supports tool/function calling. */
+    readonly toolCalling: boolean;
+    /** Model supports vision/multimodal inputs. */
+    readonly multimodal: boolean;
+    /** Model supports code editing operations. */
+    readonly codeEditing: boolean;
+}
+/**
+ * Latency statistics for a provider, derived from health telemetry.
+ */
+export interface ProviderLatencyStats {
+    /** Moving average latency in ms (last N calls). */
+    readonly avgMs: number;
+    /** Approximate 95th-percentile latency in ms (max of recent observations). */
+    readonly p95Ms: number;
+    /** Minimum observed latency in ms. */
+    readonly minMs: number;
+}
+/**
+ * Health context for a single provider, enriched into model picker entries.
+ */
+export interface ProviderHealthContext {
+    /** Current health status of the provider. */
+    readonly status: ProviderStatus;
+    /** Latency stats. Present only when the provider has call history. */
+    readonly latency?: ProviderLatencyStats;
+    /** Cache hit rate (0–1). Present only when cache metrics are available. */
+    readonly cacheHitRate?: number;
+    /** True when the provider is configured with a valid API key. */
+    readonly isConfigured: boolean;
+    /** Rate limit reset time (epoch ms), if the provider is currently rate-limited. */
+    readonly rateLimitResetAt?: number;
+}
+/**
+ * A single entry in the model picker list, enriched with health and benchmark data.
+ */
+export interface ModelPickerEntry {
+    /** Unique model identifier. */
+    readonly modelId: string;
+    /** Provider identifier. */
+    readonly providerId: string;
+    /** Human-readable display name. */
+    readonly displayName: string;
+    /** Model family (GPT, Claude, Gemini, …). */
+    readonly family: ModelFamily;
+    /** Pricing tier bucket. */
+    readonly pricingTier: CategoryFilter;
+    /** Quality tier badge (S/A/B/C), derived from benchmark composite score. */
+    readonly qualityTier?: string;
+    /** Benchmark composite score (0–1). */
+    readonly benchmarkScore?: number;
+    /** Capability flags for this model. */
+    readonly capabilities: CapabilityFlags;
+    /** Health context for the model's provider. */
+    readonly health: ProviderHealthContext;
+    /**
+     * Effective context window in tokens.
+     * Use this for display and budgeting — it is the authoritative value.
+     */
+    readonly contextWindow: number;
+    /**
+     * How `contextWindow` was determined.
+     * - `provider_api`   — reported by the provider's /v1/models endpoint
+     * - `configured_cap` — set explicitly in the provider config file
+     * - `fallback`       — default constant (no config or API source)
+     * - `openrouter`     — sourced from OpenRouter model data (built-in catalog models)
+     * - `registry`       — static value in the built-in model registry
+     */
+    readonly contextWindowSource: 'provider_api' | 'configured_cap' | 'fallback' | 'openrouter' | 'registry';
+    /** True if this model is in the user's favorites/pinned list. */
+    readonly isPinned: boolean;
+    /** True if this is the currently active model. */
+    readonly isActive: boolean;
+    /** True when the provider is currently in a degraded or critical state. */
+    readonly isProviderDegraded: boolean;
+    /** True when the provider is unavailable or in auth error. */
+    readonly isProviderUnavailable: boolean;
+    /** True if this model is part of the current fallback chain. */
+    readonly isInFallbackChain: boolean;
+    /** Position in the fallback chain (0 = primary, 1+ = fallback index). */
+    readonly fallbackPosition?: number;
+}
+/**
+ * A visual group in the model picker list.
+ */
+export interface ModelPickerGroup {
+    /** Group label (e.g. provider name, family name, quality tier). */
+    readonly label: string;
+    /** Entries belonging to this group, sorted by health then favorites. */
+    readonly entries: readonly ModelPickerEntry[];
+}
+/**
+ * Complete data snapshot produced by ModelPickerDataProvider.
+ */
+export interface ModelPickerData {
+    /** All enriched model entries (flat, pre-sorted). */
+    readonly entries: readonly ModelPickerEntry[];
+    /** Grouped view for rendering with section headers. */
+    readonly groups: readonly ModelPickerGroup[];
+    /** IDs of providers that are currently degraded. */
+    readonly degradedProviderIds: readonly string[];
+    /** IDs of providers that are currently unavailable. */
+    readonly unavailableProviderIds: readonly string[];
+    /** Model ID currently at the head of the fallback chain (active model). */
+    readonly activeModelId: string;
+    /** Epoch ms when this snapshot was produced. */
+    readonly snapshotAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/_internal/platform/runtime/ui/model-picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/ui/model-picker/types.ts"],"names":[],"mappings":"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"}