@theia/ai-core 1.76.0-next.28 → 1.76.0-next.34

package/src/browser/favorite-models-service.ts

@@ -0,0 +1,297 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { Emitter, Event, PreferenceScope, PreferenceService } from '@theia/core';
+import { inject, injectable, postConstruct } from '@theia/core/shared/inversify';
+import { PREFERENCE_NAME_FAVORITE_MODELS, PREFERENCE_NAME_HIDDEN_MODELS } from '../common/ai-core-preferences';
+import { DiscoveredModel, ModelDiscoveryStatus } from '../common/model-discovery-status';
+import { DiscoveredModels } from '../common/model-discovery-util';
+import { ModelDiscoveryStatusService } from './model-discovery-status-service';
+
+/**
+ * How many of a provider's models are offered without the user asking. Enough to cover a provider's
+ * current line-up (a flagship, a fast one, a cheap one and their immediate predecessors) without
+ * turning the model pickers back into a catalogue.
+ */
+export const FEATURED_MODEL_COUNT = 5;
+
+/** What {@link FavoriteModelsService} derives from what the providers last reported. */
+export interface DerivedFavorites {
+    /** Fully qualified ids of the models that are offered without the user asking. */
+    readonly featured: Set<string>;
+    /** Model-id prefixes of the providers that participate in discovery. */
+    readonly discoveryPrefixes: Set<string>;
+}
+
+/**
+ * Decides which models the model picker in the AI chat input offers.
+ *
+ * Discovery registers everything a provider offers, including one entry per release, which is far
+ * more than anyone picks between while chatting. What that picker shows is therefore the *favorites*:
+ * the models that are featured automatically plus the ones the user marked. Everywhere a model is
+ * chosen deliberately — an agent's model, a model alias — every discovered model stays on offer.
+ *
+ * A model is featured when it is one of the {@link FEATURED_MODEL_COUNT} most recently released
+ * undated ids of its provider — so `claude-opus-5` is featured while `claude-opus-5-20260401` is
+ * not. Because the featured set is derived from each discovery rather than stored, a model released
+ * tomorrow is offered the day it appears, and the user cannot end up pinned to a stale line-up.
+ *
+ * Both directions are the user's to override, and only the override is stored: a model offered by
+ * default is taken out of the picker by an entry in {@link PREFERENCE_NAME_HIDDEN_MODELS}, any other
+ * model is put into it by an entry in {@link PREFERENCE_NAME_FAVORITE_MODELS}. A model nobody touched
+ * appears in neither.
+ *
+ * Models of a provider that does not participate in discovery — one whose models are configured by
+ * hand, or a custom endpoint — are all favorites: listing them *was* the user's choice.
+ */
+@injectable()
+export class FavoriteModelsService {
+
+    @inject(PreferenceService)
+    protected readonly preferenceService: PreferenceService;
+
+    @inject(ModelDiscoveryStatusService)
+    protected readonly discoveryStatus: ModelDiscoveryStatusService;
+
+    protected readonly onDidChangeEmitter = new Emitter<void>();
+    /** Fired when the marked models or the featured set change. */
+    readonly onDidChange: Event<void> = this.onDidChangeEmitter.event;
+
+    /** Memoized {@link getDerived}, dropped whenever a discovery reports something new. */
+    protected derived: DerivedFavorites | undefined;
+
+    @postConstruct()
+    protected init(): void {
+        this.discoveryStatus.onDidChange(status => {
+            this.derived = undefined;
+            this.pruneFavorites(status);
+            this.onDidChangeEmitter.fire();
+        });
+        this.preferenceService.onPreferenceChanged(event => {
+            if (event.preferenceName === PREFERENCE_NAME_FAVORITE_MODELS || event.preferenceName === PREFERENCE_NAME_HIDDEN_MODELS) {
+                this.onDidChangeEmitter.fire();
+            }
+        });
+    }
+
+    /** Whether the chat input's model picker offers this model, be it featured, marked or hand-configured. */
+    isFavorite(modelId: string): boolean {
+        if (this.getHidden().includes(modelId)) {
+            return false;
+        }
+        return this.isOfferedByDefault(modelId) || this.getFavorites().includes(modelId);
+    }
+
+    /**
+     * Whether the picker would offer this model without the user marking it: one of the newest of a
+     * provider that discovers, or any model of a provider that does not. Nothing was discovered for
+     * the latter, so its models are there because someone put them there - a manually configured
+     * provider, or a custom endpoint. That is choice enough.
+     */
+    protected isOfferedByDefault(modelId: string): boolean {
+        return !this.participatesInDiscovery(modelId) || this.isFeatured(modelId);
+    }
+
+    /** Whether the model's provider reports a discovery status, i.e. whether featuring applies to it at all. */
+    protected participatesInDiscovery(modelId: string): boolean {
+        const separator = modelId.indexOf('/');
+        if (separator <= 0) {
+            return false;
+        }
+        return this.getDerived().discoveryPrefixes.has(modelId.substring(0, separator));
+    }
+
+    /**
+     * Whether the model is offered automatically because it is among its provider's newest, in which
+     * case it cannot be unmarked.
+     */
+    isFeatured(modelId: string): boolean {
+        return this.getFeatured().has(modelId);
+    }
+
+    /** The ids the user marked explicitly, the ones offered by default excluded. */
+    getFavorites(): string[] {
+        return this.preferenceService.get<string[]>(PREFERENCE_NAME_FAVORITE_MODELS, []);
+    }
+
+    /** The ids the user took out of the picker, which would otherwise be offered by default. */
+    getHidden(): string[] {
+        return this.preferenceService.get<string[]>(PREFERENCE_NAME_HIDDEN_MODELS, []);
+    }
+
+    /**
+     * Whether the user decided anything about this provider's models, i.e. whether resetting it to the
+     * models it offers by default would change what the picker shows.
+     *
+     * @param modelIdPrefix prefix of the provider's registered model ids, e.g. `openai`
+     */
+    hasOverrides(modelIdPrefix: string): boolean {
+        return [...this.getFavorites(), ...this.getHidden()].some(id => id.startsWith(`${modelIdPrefix}/`));
+    }
+
+    /**
+     * Drops what the user decided about one provider's models, so the picker shows the models that
+     * provider offers by default again. The other providers are left alone.
+     *
+     * @param modelIdPrefix prefix of the provider's registered model ids, e.g. `openai`
+     */
+    async resetToDefaults(modelIdPrefix: string): Promise<void> {
+        for (const preferenceName of [PREFERENCE_NAME_FAVORITE_MODELS, PREFERENCE_NAME_HIDDEN_MODELS]) {
+            const ids = this.preferenceService.get<string[]>(preferenceName, []);
+            const kept = ids.filter(id => !id.startsWith(`${modelIdPrefix}/`));
+            if (kept.length !== ids.length) {
+                await this.write(preferenceName, kept);
+            }
+        }
+    }
+
+    /**
+     * Puts a model into the picker or takes it out of it, whichever the current state calls for. Only
+     * the deviation from the default is stored: a model offered by default is taken out by an entry in
+     * the hidden list, and any other by dropping its entry from the favorites (or adding one).
+     */
+    async toggleFavorite(modelId: string): Promise<void> {
+        const favorites = this.getFavorites();
+        const hidden = this.getHidden();
+        if (this.isFavorite(modelId)) {
+            if (favorites.includes(modelId)) {
+                await this.write(PREFERENCE_NAME_FAVORITE_MODELS, favorites.filter(id => id !== modelId));
+            }
+            if (this.isOfferedByDefault(modelId)) {
+                await this.write(PREFERENCE_NAME_HIDDEN_MODELS, [...hidden, modelId]);
+            }
+            return;
+        }
+        if (hidden.includes(modelId)) {
+            await this.write(PREFERENCE_NAME_HIDDEN_MODELS, hidden.filter(id => id !== modelId));
+        }
+        // A model that was hidden while it was featured and has since fallen out of the featured set
+        // needs a mark of its own, or removing the entry would not bring it back.
+        if (!this.isOfferedByDefault(modelId)) {
+            await this.write(PREFERENCE_NAME_FAVORITE_MODELS, [...favorites, modelId]);
+        }
+    }
+
+    protected async write(preferenceName: string, ids: string[]): Promise<void> {
+        await this.preferenceService.set(preferenceName, ids, PreferenceScope.User);
+    }
+
+    /** The featured ids across all providers that participate in discovery, fully qualified. */
+    protected getFeatured(): Set<string> {
+        return this.getDerived().featured;
+    }
+
+    /**
+     * What the last discovery implies, computed once and kept until it changes. The chat input asks
+     * per model on every render, and ranking each provider's models per question would mean sorting
+     * the whole catalogue as many times as it has entries.
+     */
+    protected getDerived(): DerivedFavorites {
+        if (!this.derived) {
+            const featured = new Set<string>();
+            const discoveryPrefixes = new Set<string>();
+            for (const status of this.discoveryStatus.getStatuses()) {
+                const prefix = status.modelIdPrefix ?? status.providerId;
+                discoveryPrefixes.add(prefix);
+                for (const model of this.selectFeatured(status)) {
+                    featured.add(`${prefix}/${model.id}`);
+                }
+            }
+            this.derived = { featured, discoveryPrefixes };
+        }
+        return this.derived;
+    }
+
+    /**
+     * The models of one provider that are offered automatically: at most {@link FEATURED_MODEL_COUNT}
+     * of its undated ids. A release-pinned id is never featured — the undated form of the same model
+     * already is, and pinning a release is the deliberate choice the switch on its row makes.
+     *
+     * They are ranked by what the provider reports about them, in that order:
+     *
+     * 1. most recently released, where the provider reports release dates (Anthropic, OpenAI);
+     * 2. a `-latest` pointer the provider maintains at the current model of a family, which only
+     *    decides where there are no dates: a provider that reports them dates its pointers as well;
+     * 3. highest version in the id, which is what is left for Gemini — the naming of those models
+     *    carries their generation (`gemini-3.7-flash` over `gemini-2.5-pro`).
+     *
+     * What the model aliases name has no say in this: an alias is a curated list of its own, pointing
+     * at the model a purpose should use, which is a different question from which models are worth
+     * offering in the picker.
+     *
+     * An explicitly configured list (`modelOverrides`) is featured in full: the user named it. So is a
+     * provider's own nomination ({@link DiscoveredModel.featured}), which a provider makes when the
+     * generic ranking cannot serve it — Copilot carries models of many vendors and nominates one each
+     * of the three the other providers offer directly, where "the newest five" would pick five of
+     * whichever vendor numbers its models highest.
+     */
+    protected selectFeatured(status: ModelDiscoveryStatus): DiscoveredModel[] {
+        const discovered = status.discovered ?? [];
+        if (status.state === 'overridden') {
+            return [...discovered];
+        }
+        const nominated = discovered.filter(model => model.featured);
+        if (nominated.length > 0) {
+            return nominated;
+        }
+        return discovered
+            .filter(model => DiscoveredModels.undatedId(model.id) === undefined)
+            .map((model, index) => ({ model, index }))
+            .sort((left, right) => this.compareFeatured(left, right))
+            .slice(0, FEATURED_MODEL_COUNT)
+            .map(entry => entry.model);
+    }
+
+    /** Orders two candidates of the same provider; `index` preserves the reported order as the last resort. */
+    protected compareFeatured(
+        left: { model: DiscoveredModel; index: number },
+        right: { model: DiscoveredModel; index: number }
+    ): number {
+        const byRelease = (right.model.released ?? 0) - (left.model.released ?? 0);
+        if (byRelease !== 0) {
+            return byRelease;
+        }
+        // Only where a provider reports no dates: a pointer at its current model of a family is as
+        // current as a model gets, and it carries no version, so it would otherwise sort behind every
+        // id that does. Where there are dates, the pointer carries one too and has been ordered by it.
+        const byPointer = Number(DiscoveredModels.isLatestPointer(right.model.id)) - Number(DiscoveredModels.isLatestPointer(left.model.id));
+        if (byPointer !== 0) {
+            return byPointer;
+        }
+        const byVersion = DiscoveredModels.compareByVersion(left.model.id, right.model.id);
+        return byVersion !== 0 ? byVersion : left.index - right.index;
+    }
+
+    /**
+     * Drops the marked and hidden ids of a provider that a successful discovery no longer offers, so
+     * that neither list accumulates models that no longer exist. Only a live discovery prunes: a
+     * cached result, a failure or a missing credential says nothing about what the provider offers.
+     */
+    protected pruneFavorites(status: ModelDiscoveryStatus): void {
+        if (status.state !== 'ready' || status.fromCache || !status.discovered) {
+            return;
+        }
+        const prefix = status.modelIdPrefix ?? status.providerId;
+        const offered = new Set(status.discovered.map(model => `${prefix}/${model.id}`));
+        for (const preferenceName of [PREFERENCE_NAME_FAVORITE_MODELS, PREFERENCE_NAME_HIDDEN_MODELS]) {
+            const ids = this.preferenceService.get<string[]>(preferenceName, []);
+            const kept = ids.filter(id => !id.startsWith(`${prefix}/`) || offered.has(id));
+            if (kept.length !== ids.length) {
+                this.write(preferenceName, kept);
+            }
+        }
+    }
+}

package/src/browser/index.ts

@@ -28,6 +28,9 @@ export * from './ai-view-contribution';
 export * from './frontend-language-model-registry';
 export * from './frontend-language-model-alias-registry';
 export * from './hide-ai-preferences-contribution';
+export * from './model-discovery-status-service';
+export * from './favorite-models-service';
+export * from './discovering-provider-contribution';
 export * from './frontend-variable-service';
 export * from './prompttemplate-contribution';
 export * from './theia-variable-contribution';

package/src/browser/model-discovery-status-service.spec.ts

@@ -0,0 +1,95 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { expect } from 'chai';
+import { ModelDiscoveryStatus } from '../common/model-discovery-status';
+import { ModelDiscoveryStatusService } from './model-discovery-status-service';
+
+describe('ModelDiscoveryStatusService', () => {
+
+    it('registers a provider with an initial idle status', () => {
+        const service = new ModelDiscoveryStatusService();
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { } });
+        const status = service.getStatus('anthropic');
+        expect(status?.state).to.equal('idle');
+        expect(status?.label).to.equal('Anthropic');
+    });
+
+    it('merges partial updates and fires onDidChange', () => {
+        const service = new ModelDiscoveryStatusService();
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { } });
+
+        const events: ModelDiscoveryStatus[] = [];
+        service.onDidChange(e => events.push(e));
+
+        service.updateStatus('anthropic', { state: 'fetching' });
+        service.updateStatus('anthropic', { state: 'ready', lastFetch: 123, fromCache: false });
+
+        const status = service.getStatus('anthropic');
+        expect(status?.state).to.equal('ready');
+        expect(status?.lastFetch).to.equal(123);
+        // label is carried over from registration.
+        expect(status?.label).to.equal('Anthropic');
+        expect(events.map(e => e.state)).to.deep.equal(['fetching', 'ready']);
+    });
+
+    it('does not reset an existing status when the provider is re-registered', () => {
+        const service = new ModelDiscoveryStatusService();
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { } });
+        service.updateStatus('anthropic', { state: 'ready' });
+
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { } });
+        expect(service.getStatus('anthropic')?.state).to.equal('ready');
+    });
+
+    it('reports a failure and clears what the previous state offered', () => {
+        const service = new ModelDiscoveryStatusService();
+        service.registerProvider({ providerId: 'copilot', label: 'GitHub Copilot', refresh: async () => { } });
+        service.updateStatus('copilot', {
+            state: 'no-credentials',
+            stateLabel: 'Not signed in',
+            action: { label: 'Sign in', commandId: 'copilot.signIn' }
+        });
+
+        service.reportError('copilot', new Error('the CLI is not talking'));
+
+        const status = service.getStatus('copilot');
+        expect(status?.state).to.equal('error');
+        expect(status?.message).to.equal('the CLI is not talking');
+        // A failure must not keep reading like the state before it.
+        expect(status?.stateLabel).to.equal(undefined);
+        expect(status?.action).to.equal(undefined);
+    });
+
+    it('reports a rejection that is not an error', () => {
+        const service = new ModelDiscoveryStatusService();
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { } });
+        service.reportError('anthropic', 'nope');
+        expect(service.getStatus('anthropic')?.message).to.equal('nope');
+    });
+
+    it('delegates refresh to the registered provider', async () => {
+        const service = new ModelDiscoveryStatusService();
+        let refreshed = false;
+        service.registerProvider({ providerId: 'anthropic', label: 'Anthropic', refresh: async () => { refreshed = true; } });
+
+        await service.refresh('anthropic');
+        expect(refreshed).to.be.true;
+
+        // Refreshing an unknown provider is a no-op and does not throw.
+        await service.refresh('unknown');
+    });
+});

package/src/browser/model-discovery-status-service.ts

@@ -0,0 +1,118 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { Emitter, Event } from '@theia/core';
+import { injectable } from '@theia/core/shared/inversify';
+import { ModelDiscoveryStatus } from '../common/model-discovery-status';
+
+/**
+ * A provider that participates in dynamic model discovery. Provider frontend contributions
+ * register a descriptor so the UI can display their {@link ModelDiscoveryStatus} and trigger
+ * a manual refresh.
+ */
+export interface ModelDiscoveryProviderDescriptor {
+    readonly providerId: string;
+    readonly label: string;
+    /** Prefix of this provider's registered model ids, if it differs from {@link providerId}. */
+    readonly modelIdPrefix?: string;
+    /** Triggers a manual re-fetch (used by the "Refresh"/"Retry" action). */
+    refresh(): Promise<void>;
+}
+
+/**
+ * Frontend registry of provider-level model-discovery status.
+ *
+ * Provider frontend contributions push their state here as they fetch models; the AI
+ * configuration UI observes {@link onDidChange} to render fetching/error/no-credentials state.
+ * This is the provider-level counterpart to the per-model `LanguageModelStatus`.
+ */
+@injectable()
+export class ModelDiscoveryStatusService {
+
+    protected readonly descriptors = new Map<string, ModelDiscoveryProviderDescriptor>();
+    protected readonly statuses = new Map<string, ModelDiscoveryStatus>();
+
+    protected readonly onDidChangeEmitter = new Emitter<ModelDiscoveryStatus>();
+    /** Fired whenever a provider's status changes; the argument is the new status. */
+    readonly onDidChange: Event<ModelDiscoveryStatus> = this.onDidChangeEmitter.event;
+
+    /**
+     * Register a provider. Idempotent: re-registering keeps any existing status and only
+     * updates the refresh callback and label.
+     */
+    registerProvider(descriptor: ModelDiscoveryProviderDescriptor): void {
+        this.descriptors.set(descriptor.providerId, descriptor);
+        if (!this.statuses.has(descriptor.providerId)) {
+            this.statuses.set(descriptor.providerId, {
+                providerId: descriptor.providerId,
+                label: descriptor.label,
+                modelIdPrefix: descriptor.modelIdPrefix,
+                state: 'idle'
+            });
+        }
+        this.onDidChangeEmitter.fire(this.statuses.get(descriptor.providerId)!);
+    }
+
+    /**
+     * Update a provider's status. Only the provided fields are changed; the rest are carried
+     * over from the previous status. Passing `undefined` for an optional field explicitly clears it.
+     */
+    updateStatus(providerId: string, update: Partial<Omit<ModelDiscoveryStatus, 'providerId'>>): void {
+        const previous = this.statuses.get(providerId);
+        const next: ModelDiscoveryStatus = {
+            providerId,
+            label: update.label ?? previous?.label ?? providerId,
+            modelIdPrefix: 'modelIdPrefix' in update ? update.modelIdPrefix : previous?.modelIdPrefix,
+            state: update.state ?? previous?.state ?? 'idle',
+            stateLabel: 'stateLabel' in update ? update.stateLabel : previous?.stateLabel,
+            message: 'message' in update ? update.message : previous?.message,
+            lastFetch: 'lastFetch' in update ? update.lastFetch : previous?.lastFetch,
+            fromCache: 'fromCache' in update ? update.fromCache : previous?.fromCache,
+            discovered: 'discovered' in update ? update.discovered : previous?.discovered,
+            action: 'action' in update ? update.action : previous?.action
+        };
+        this.statuses.set(providerId, next);
+        this.onDidChangeEmitter.fire(next);
+    }
+
+    /**
+     * Reports a failed discovery run. Any step of a run can fail, including the ones that only talk to
+     * the backend, and nothing awaits the promise a rejection would travel on: a provider's startup
+     * does not, and a refresh button cannot act on it. What the previous state offered is cleared, so
+     * a failure does not keep reading like the state before it (a badge, a sign-in button).
+     */
+    reportError(providerId: string, error: unknown): void {
+        this.updateStatus(providerId, {
+            state: 'error',
+            stateLabel: undefined,
+            message: error instanceof Error ? error.message : String(error),
+            action: undefined
+        });
+    }
+
+    getStatus(providerId: string): ModelDiscoveryStatus | undefined {
+        return this.statuses.get(providerId);
+    }
+
+    getStatuses(): ModelDiscoveryStatus[] {
+        return [...this.statuses.values()];
+    }
+
+    /** Trigger a manual refresh for the given provider, if it is registered. */
+    async refresh(providerId: string): Promise<void> {
+        await this.descriptors.get(providerId)?.refresh();
+    }
+}

package/src/common/ai-core-preferences.ts

@@ -38,6 +38,15 @@ export const AI_CORE_PREFERENCES_TITLE = nls.localize('theia/ai-core/preferences
  */
 export const MODEL_PROVIDER_TYPE_DETAIL = 'aiModelProvider';
 
+/**
+ * Key under a preference's schema `typeDetails` marking a preference that the AI Configuration view
+ * edits through a dedicated control of its own, so it should not also appear as a raw settings row.
+ * The value stays a plain preference, editable in `settings.json` like any other; it is only the
+ * duplicate, less legible editor that is left out. Declare it as
+ * `typeDetails: { [DEDICATED_EDITOR_TYPE_DETAIL]: true }`.
+ */
+export const DEDICATED_EDITOR_TYPE_DETAIL = 'aiDedicatedEditor';
+
 /**
  * Shape a language-model provider stores under a preference's `typeDetails[MODEL_PROVIDER_TYPE_DETAIL]`
  * to describe its `ai-features.<provider>.*` block to the AI Configuration view's Models page. Declared
@@ -51,6 +60,8 @@ export const PREFERENCE_NAME_PROMPT_TEMPLATES = 'ai-features.promptTemplates.pro
 export const PREFERENCE_NAME_REQUEST_SETTINGS = 'ai-features.modelSettings.requestSettings';
 export const PREFERENCE_NAME_REASONING = 'ai-features.reasoning.defaults';
 export const PREFERENCE_NAME_MAX_RETRIES = 'ai-features.modelSettings.maxRetries';
+export const PREFERENCE_NAME_FAVORITE_MODELS = 'ai-features.modelSettings.favoriteModels';
+export const PREFERENCE_NAME_HIDDEN_MODELS = 'ai-features.modelSettings.hiddenModels';
 export const PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE = 'ai-features.notifications.default';
 export const PREFERENCE_NAME_SKILL_DIRECTORIES = 'ai-features.skills.skillDirectories';
 export const PREFERENCE_NAME_SERVER_SIDE_COMPACTION = 'ai-features.chat.serverSideCompaction';
@@ -169,6 +180,34 @@ export const aiCorePreferenceSchema: PreferenceSchema = {
             minimum: 0,
             default: 3
         },
+        [PREFERENCE_NAME_FAVORITE_MODELS]: {
+            title: nls.localize('theia/ai/core/favoriteModels/title', 'Favorite Models'),
+            markdownDescription: nls.localize('theia/ai/core/favoriteModels/mdDescription',
+                'Models the AI chat input\'s model picker shows in addition to the newest ones of each provider, as fully qualified ids '
+                + '(e.g. `anthropic/claude-opus-5`). This is for keeping an older or release-pinned model at hand. Check a model on its '
+                + 'provider\'s page in the AI Configuration view to add it.'),
+            type: 'array',
+            // The provider pages check models one by one; a second, raw editor for the same ids would
+            // invite typos and disagree with what the checks say.
+            typeDetails: { [DEDICATED_EDITOR_TYPE_DETAIL]: true },
+            items: {
+                type: 'string'
+            },
+            default: []
+        },
+        [PREFERENCE_NAME_HIDDEN_MODELS]: {
+            title: nls.localizeByDefault('Hidden Models'),
+            markdownDescription: nls.localize('theia/ai/core/hiddenModels/mdDescription',
+                'Models the AI chat input\'s model picker does not show even though it would by default, as fully qualified ids '
+                + '(e.g. `google/gemini-flash-lite-latest`). Only the models shown without being listed as a favorite end up here, '
+                + 'i.e. the newest ones of a provider. Uncheck a model on its provider\'s page in the AI Configuration view to add it.'),
+            type: 'array',
+            typeDetails: { [DEDICATED_EDITOR_TYPE_DETAIL]: true },
+            items: {
+                type: 'string'
+            },
+            default: []
+        },
         [PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE]: {
             title: nls.localize('theia/ai/core/defaultNotification/title', 'Default Notification Type'),
             markdownDescription: nls.localize('theia/ai/core/defaultNotification/mdDescription',
@@ -276,6 +315,7 @@ export interface AICoreConfiguration {
     [PREFERENCE_NAME_REQUEST_SETTINGS]: Array<RequestSetting> | undefined;
     [PREFERENCE_NAME_REASONING]: Array<ReasoningPreferenceEntry> | undefined;
     [PREFERENCE_NAME_MAX_RETRIES]: number | undefined;
+    [PREFERENCE_NAME_FAVORITE_MODELS]: string[] | undefined;
     [PREFERENCE_NAME_DEFAULT_NOTIFICATION_TYPE]: NotificationType | undefined;
     [PREFERENCE_NAME_SKILL_DIRECTORIES]: string[] | undefined;
     [PREFERENCE_NAME_SERVER_SIDE_COMPACTION]: boolean | undefined;

package/src/common/index.ts

@@ -22,6 +22,8 @@ export * from './language-model-delegate';
 export * from './language-model-util';
 export * from './language-model';
 export * from './language-model-alias';
+export * from './model-discovery-status';
+export * from './model-discovery-util';
 export * from './prompt-service';
 export * from './prompt-service-util';
 export * from './proxy-util';