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

package/lib/node/model-discovery-fetcher.js

@@ -0,0 +1,83 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelDiscoveryFetcherImpl = exports.ModelDiscoveryFetcher = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@theia/core");
+const promise_util_1 = require("@theia/core/lib/common/promise-util");
+const inversify_1 = require("@theia/core/shared/inversify");
+const model_snapshot_store_1 = require("./model-snapshot-store");
+exports.ModelDiscoveryFetcher = Symbol('ModelDiscoveryFetcher');
+let ModelDiscoveryFetcherImpl = class ModelDiscoveryFetcherImpl {
+    constructor() {
+        /** Number of attempts (including the first) for a discovery fetch on a retryable error. */
+        this.maxAttempts = 3;
+        /** Base linear backoff between attempts; multiplied by the number of the attempt that failed. */
+        this.retryDelayMs = 500;
+    }
+    async fetch(request) {
+        try {
+            const models = await this.listWithRetry(request);
+            await this.snapshotStore.write(request.snapshotFile, models);
+            return { models, fromCache: false };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const cached = await this.snapshotStore.read(request.snapshotFile);
+            if (cached) {
+                this.logger.warn(`${request.providerLabel}: model discovery failed (${message}); using cached snapshot.`);
+                return { models: cached, fromCache: true, error: message };
+            }
+            throw error;
+        }
+    }
+    /** Lists the models, retrying a transient failure with a linear backoff. */
+    async listWithRetry(request) {
+        let lastError;
+        for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {
+            try {
+                return await request.listModels();
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === this.maxAttempts || !request.isRetryable?.(error)) {
+                    break;
+                }
+                await this.delay(this.retryDelayMs * attempt);
+            }
+        }
+        throw lastError;
+    }
+    /** Waits between two attempts. Overridable so a test does not have to. */
+    delay(ms) {
+        return (0, promise_util_1.timeout)(ms);
+    }
+};
+exports.ModelDiscoveryFetcherImpl = ModelDiscoveryFetcherImpl;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(model_snapshot_store_1.ModelSnapshotStore),
+    tslib_1.__metadata("design:type", Object)
+], ModelDiscoveryFetcherImpl.prototype, "snapshotStore", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('ai-core:ModelDiscoveryFetcherImpl'),
+    tslib_1.__metadata("design:type", Object)
+], ModelDiscoveryFetcherImpl.prototype, "logger", void 0);
+exports.ModelDiscoveryFetcherImpl = ModelDiscoveryFetcherImpl = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], ModelDiscoveryFetcherImpl);
+//# sourceMappingURL=model-discovery-fetcher.js.map

package/lib/node/model-discovery-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-discovery-fetcher.js","sourceRoot":"","sources":["../../src/node/model-discovery-fetcher.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,sCAAsC;AACtC,sEAA8D;AAC9D,4DAAyE;AAEzE,iEAA4D;AAE/C,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AA8B9D,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IAA/B;QAEH,2FAA2F;QACjF,gBAAW,GAAG,CAAC,CAAC;QAC1B,iGAAiG;QACvF,iBAAY,GAAG,GAAG,CAAC;IA6CjC,CAAC;IArCG,KAAK,CAAC,KAAK,CAAC,OAA8B;QACtC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACnE,IAAI,MAAM,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,aAAa,6BAA6B,OAAO,2BAA2B,CAAC,CAAC;gBAC1G,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC/D,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,4EAA4E;IAClE,KAAK,CAAC,aAAa,CAAC,OAA8B;QACxD,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACD,OAAO,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChE,MAAM;gBACV,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC;YAClD,CAAC;QACL,CAAC;QACD,MAAM,SAAS,CAAC;IACpB,CAAC;IAED,0EAA0E;IAChE,KAAK,CAAC,EAAU;QACtB,OAAO,IAAA,sBAAO,EAAC,EAAE,CAAC,CAAC;IACvB,CAAC;CACJ,CAAA;AAlDY,8DAAyB;AAQf;IADlB,IAAA,kBAAM,EAAC,yCAAkB,CAAC;;gEAC0B;AAGlC;IADlB,IAAA,kBAAM,EAAC,cAAO,CAAC;IAAE,IAAA,iBAAK,EAAC,mCAAmC,CAAC;;yDACzB;oCAX1B,yBAAyB;IADrC,IAAA,sBAAU,GAAE;GACA,yBAAyB,CAkDrC"}

package/lib/node/model-snapshot-store.d.ts

@@ -0,0 +1,26 @@
+import { ILogger } from '@theia/core';
+import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
+import { DiscoveredModel } from '../common/model-discovery-status';
+export declare const ModelSnapshotStore: unique symbol;
+/** Directory below the configuration directory that holds the snapshots, one file per provider. */
+export declare const MODEL_SNAPSHOT_DIRECTORY = "model-snapshots";
+/**
+ * Persists what a provider's model discovery found, so the models stay available when a later
+ * fetch fails or the application starts offline.
+ */
+export interface ModelSnapshotStore {
+    /** Reads a provider's snapshot, or `undefined` when there is none (or it cannot be read). */
+    read(fileName: string): Promise<DiscoveredModel[] | undefined>;
+    /** Writes a provider's snapshot. Failures are logged, not thrown: a snapshot is a convenience. */
+    write(fileName: string, models: DiscoveredModel[]): Promise<void>;
+}
+/** Stores one JSON file per provider in {@link MODEL_SNAPSHOT_DIRECTORY} below the configuration directory. */
+export declare class ModelSnapshotStoreImpl implements ModelSnapshotStore {
+    protected readonly envVariablesServer: EnvVariablesServer;
+    protected readonly logger: ILogger;
+    read(fileName: string): Promise<DiscoveredModel[] | undefined>;
+    write(fileName: string, models: DiscoveredModel[]): Promise<void>;
+    protected isDiscoveredModel(candidate: unknown): candidate is DiscoveredModel;
+    protected snapshotPath(fileName: string): Promise<string>;
+}
+//# sourceMappingURL=model-snapshot-store.d.ts.map

package/lib/node/model-snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-snapshot-store.d.ts","sourceRoot":"","sources":["../../src/node/model-snapshot-store.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAY,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,eAA+B,CAAC;AAE/D,mGAAmG;AACnG,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6FAA6F;IAC7F,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/D,kGAAkG;IAClG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,+GAA+G;AAC/G,qBACa,sBAAuB,YAAW,kBAAkB;IAG7D,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAG1D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAE7B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,SAAS,CAAC;IAW9D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,IAAI,eAAe;cAI7D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlE"}

package/lib/node/model-snapshot-store.js

@@ -0,0 +1,73 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelSnapshotStoreImpl = exports.MODEL_SNAPSHOT_DIRECTORY = exports.ModelSnapshotStore = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path = require("path");
+const core_1 = require("@theia/core");
+const env_variables_1 = require("@theia/core/lib/common/env-variables");
+const uri_1 = require("@theia/core/lib/common/uri");
+const inversify_1 = require("@theia/core/shared/inversify");
+exports.ModelSnapshotStore = Symbol('ModelSnapshotStore');
+/** Directory below the configuration directory that holds the snapshots, one file per provider. */
+exports.MODEL_SNAPSHOT_DIRECTORY = 'model-snapshots';
+/** Stores one JSON file per provider in {@link MODEL_SNAPSHOT_DIRECTORY} below the configuration directory. */
+let ModelSnapshotStoreImpl = class ModelSnapshotStoreImpl {
+    async read(fileName) {
+        try {
+            const content = await fs_1.promises.readFile(await this.snapshotPath(fileName), 'utf8');
+            const models = JSON.parse(content).models;
+            return Array.isArray(models) ? models.filter(model => this.isDiscoveredModel(model)) : undefined;
+        }
+        catch {
+            // A missing or unreadable snapshot is an expected state, not an error: discovery falls back to a live fetch.
+            return undefined;
+        }
+    }
+    async write(fileName, models) {
+        try {
+            const file = await this.snapshotPath(fileName);
+            await fs_1.promises.mkdir(path.dirname(file), { recursive: true });
+            await fs_1.promises.writeFile(file, JSON.stringify({ models }, undefined, 2));
+        }
+        catch (error) {
+            this.logger.warn(`Failed to persist the model snapshot '${fileName}':`, error instanceof Error ? error.message : error);
+        }
+    }
+    isDiscoveredModel(candidate) {
+        return (0, core_1.isObject)(candidate) && typeof candidate.id === 'string';
+    }
+    async snapshotPath(fileName) {
+        const configDirUri = await this.envVariablesServer.getConfigDirUri();
+        return new uri_1.default(configDirUri).resolve(exports.MODEL_SNAPSHOT_DIRECTORY).resolve(fileName).path.fsPath();
+    }
+};
+exports.ModelSnapshotStoreImpl = ModelSnapshotStoreImpl;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(env_variables_1.EnvVariablesServer),
+    tslib_1.__metadata("design:type", Object)
+], ModelSnapshotStoreImpl.prototype, "envVariablesServer", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('ai-core:ModelSnapshotStoreImpl'),
+    tslib_1.__metadata("design:type", Object)
+], ModelSnapshotStoreImpl.prototype, "logger", void 0);
+exports.ModelSnapshotStoreImpl = ModelSnapshotStoreImpl = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], ModelSnapshotStoreImpl);
+//# sourceMappingURL=model-snapshot-store.js.map

package/lib/node/model-snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-snapshot-store.js","sourceRoot":"","sources":["../../src/node/model-snapshot-store.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,2BAAoC;AACpC,6BAA6B;AAC7B,sCAAgD;AAChD,wEAA0E;AAC1E,oDAA6C;AAC7C,4DAAyE;AAG5D,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAE/D,mGAAmG;AACtF,QAAA,wBAAwB,GAAG,iBAAiB,CAAC;AAa1D,+GAA+G;AAExG,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAQ/B,KAAK,CAAC,IAAI,CAAC,QAAgB;QACvB,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,CAAC,MAAM,CAAC;YACpE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrG,CAAC;QAAC,MAAM,CAAC;YACL,6GAA6G;YAC7G,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,MAAyB;QACnD,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,aAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,aAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,QAAQ,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5H,CAAC;IACL,CAAC;IAES,iBAAiB,CAAC,SAAkB;QAC1C,OAAO,IAAA,eAAQ,EAAkB,SAAS,CAAC,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC;IACpF,CAAC;IAES,KAAK,CAAC,YAAY,CAAC,QAAgB;QACzC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAC;QACrE,OAAO,IAAI,aAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,gCAAwB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACnG,CAAC;CACJ,CAAA;AArCY,wDAAsB;AAGZ;IADlB,IAAA,kBAAM,EAAC,kCAAkB,CAAC;;kEAC+B;AAGvC;IADlB,IAAA,kBAAM,EAAC,cAAO,CAAC;IAAE,IAAA,iBAAK,EAAC,gCAAgC,CAAC;;sDACtB;iCAN1B,sBAAsB;IADlC,IAAA,sBAAU,GAAE;GACA,sBAAsB,CAqClC"}

package/lib/node/test/test-model-discovery-fetcher.d.ts

@@ -0,0 +1,21 @@
+import { DiscoveredModel } from '../../common/model-discovery-status';
+import { ModelDiscoveryFetcherImpl } from '../model-discovery-fetcher';
+import { ModelSnapshotStore } from '../model-snapshot-store';
+/** Keeps what a discovery run writes in memory, so a test can seed and inspect the snapshot. */
+export declare class InMemoryModelSnapshotStore implements ModelSnapshotStore {
+    snapshot: DiscoveredModel[] | undefined;
+    read(): Promise<DiscoveredModel[] | undefined>;
+    write(_fileName: string, models: DiscoveredModel[]): Promise<void>;
+}
+/**
+ * The real fetcher against an in-memory snapshot store and without the waiting, so that a provider's
+ * spec exercises the retry and fallback behaviour it actually runs with.
+ */
+export declare class TestModelDiscoveryFetcher extends ModelDiscoveryFetcherImpl {
+    readonly store: InMemoryModelSnapshotStore;
+    get snapshot(): DiscoveredModel[] | undefined;
+    set snapshot(models: DiscoveredModel[] | undefined);
+    constructor();
+    protected delay(): Promise<void>;
+}
+//# sourceMappingURL=test-model-discovery-fetcher.d.ts.map

package/lib/node/test/test-model-discovery-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model-discovery-fetcher.d.ts","sourceRoot":"","sources":["../../../src/node/test/test-model-discovery-fetcher.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,gGAAgG;AAChG,qBAAa,0BAA2B,YAAW,kBAAkB;IAEjE,QAAQ,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IAElC,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,GAAG,SAAS,CAAC;IAI9C,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3E;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,yBAAyB;IAEpE,QAAQ,CAAC,KAAK,6BAAoC;IAElD,IAAI,QAAQ,IAAI,eAAe,EAAE,GAAG,SAAS,CAE5C;IAED,IAAI,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,SAAS,EAEjD;;cASkB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/lib/node/test/test-model-discovery-fetcher.js

@@ -0,0 +1,54 @@
+"use strict";
+// *****************************************************************************
+// 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
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestModelDiscoveryFetcher = exports.InMemoryModelSnapshotStore = void 0;
+const mock_logger_1 = require("@theia/core/lib/common/test/mock-logger");
+const model_discovery_fetcher_1 = require("../model-discovery-fetcher");
+/** Keeps what a discovery run writes in memory, so a test can seed and inspect the snapshot. */
+class InMemoryModelSnapshotStore {
+    async read() {
+        return this.snapshot;
+    }
+    async write(_fileName, models) {
+        this.snapshot = [...models];
+    }
+}
+exports.InMemoryModelSnapshotStore = InMemoryModelSnapshotStore;
+/**
+ * The real fetcher against an in-memory snapshot store and without the waiting, so that a provider's
+ * spec exercises the retry and fallback behaviour it actually runs with.
+ */
+class TestModelDiscoveryFetcher extends model_discovery_fetcher_1.ModelDiscoveryFetcherImpl {
+    get snapshot() {
+        return this.store.snapshot;
+    }
+    set snapshot(models) {
+        this.store.snapshot = models;
+    }
+    constructor() {
+        super();
+        this.store = new InMemoryModelSnapshotStore();
+        const injected = this;
+        injected.snapshotStore = this.store;
+        injected.logger = new mock_logger_1.MockLogger();
+    }
+    delay() {
+        return Promise.resolve();
+    }
+}
+exports.TestModelDiscoveryFetcher = TestModelDiscoveryFetcher;
+//# sourceMappingURL=test-model-discovery-fetcher.js.map

package/lib/node/test/test-model-discovery-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model-discovery-fetcher.js","sourceRoot":"","sources":["../../../src/node/test/test-model-discovery-fetcher.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,yEAAqE;AAErE,wEAAuE;AAGvE,gGAAgG;AAChG,MAAa,0BAA0B;IAInC,KAAK,CAAC,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,MAAyB;QACpD,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAChC,CAAC;CACJ;AAXD,gEAWC;AAED;;;GAGG;AACH,MAAa,yBAA0B,SAAQ,mDAAyB;IAIpE,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ,CAAC,MAAqC;QAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC;IACjC,CAAC;IAED;QACI,KAAK,EAAE,CAAC;QAXH,UAAK,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAY9C,MAAM,QAAQ,GAAG,IAA4E,CAAC;QAC9F,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC;QACpC,QAAQ,CAAC,MAAM,GAAG,IAAI,wBAAU,EAAE,CAAC;IACvC,CAAC;IAEkB,KAAK;QACpB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;CACJ;AAtBD,8DAsBC"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@theia/ai-core",
-  "version": "1.76.0-next.28+98d1a268f",
+  "version": "1.76.0-next.34+258d11e3e",
   "description": "Theia - AI Core",
   "dependencies": {
-    "@theia/core": "1.76.0-next.28+98d1a268f",
-    "@theia/editor": "1.76.0-next.28+98d1a268f",
-    "@theia/filesystem": "1.76.0-next.28+98d1a268f",
-    "@theia/monaco": "1.76.0-next.28+98d1a268f",
+    "@theia/core": "1.76.0-next.34+258d11e3e",
+    "@theia/editor": "1.76.0-next.34+258d11e3e",
+    "@theia/filesystem": "1.76.0-next.34+258d11e3e",
+    "@theia/monaco": "1.76.0-next.34+258d11e3e",
     "@theia/monaco-editor-core": "1.108.201",
-    "@theia/output": "1.76.0-next.28+98d1a268f",
-    "@theia/variable-resolver": "1.76.0-next.28+98d1a268f",
-    "@theia/workspace": "1.76.0-next.28+98d1a268f",
+    "@theia/output": "1.76.0-next.34+258d11e3e",
+    "@theia/variable-resolver": "1.76.0-next.34+258d11e3e",
+    "@theia/workspace": "1.76.0-next.34+258d11e3e",
     "@types/js-yaml": "^4.0.9",
     "fast-deep-equal": "^3.1.3",
     "js-yaml": "^4.3.2",
@@ -58,5 +58,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "98d1a268f03bc1a6709b0fbf6842c54c2ee13ccb"
+  "gitHead": "258d11e3e42d4527e85bd480fce9b22f72d4ab7c"
 }

package/src/browser/ai-core-frontend-module.ts

@@ -22,6 +22,8 @@ import {
 import { ContainerModule } from '@theia/core/shared/inversify';
 import { DefaultLanguageModelAliasRegistry } from './frontend-language-model-alias-registry';
 import { HideAiPreferencesContribution, aiConfigurationOpenPlaceholderSchema } from './hide-ai-preferences-contribution';
+import { ModelDiscoveryStatusService } from './model-discovery-status-service';
+import { FavoriteModelsService } from './favorite-models-service';
 import { TrustAwarePreferenceReader } from './trust-aware-preference-reader';
 import { AiConfigurationServiceImpl } from './ai-configuration-service-impl';
 import { LanguageModelAliasRegistry } from '../common/language-model-alias';
@@ -207,6 +209,9 @@ export default new ContainerModule(bind => {
     // ...and leave a single placeholder entry there that links to the AI Configuration view.
     bind(PreferenceContribution).toConstantValue({ schema: aiConfigurationOpenPlaceholderSchema });
 
+    bind(ModelDiscoveryStatusService).toSelf().inSingletonScope();
+    bind(FavoriteModelsService).toSelf().inSingletonScope();
+
     // Internal implementation detail of AiConfigurationService; consumers inject AiConfigurationService.
     bind(TrustAwarePreferenceReader).toSelf().inSingletonScope();
 

package/src/browser/discovering-provider-contribution.spec.ts

@@ -0,0 +1,303 @@
+// *****************************************************************************
+// 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 { ApiKeySource, DiscoveredModel, ModelDiscoveryResult } from '../common/model-discovery-status';
+import { DiscoveringLanguageModelsManager, DiscoveringProviderContribution, ModelDiscoveryMessages } from './discovering-provider-contribution';
+import { ModelDiscoveryStatusService } from './model-discovery-status-service';
+
+interface TestModelDescription {
+    id: string;
+    model: string;
+}
+
+const OVERRIDES_PREF = 'test.modelOverrides';
+const ALLOW_ENV_PREF = 'test.allowEnvironmentApiKey';
+
+class TestManager implements DiscoveringLanguageModelsManager<TestModelDescription> {
+
+    result: ModelDiscoveryResult = { models: [], fromCache: false };
+    /** Consumed one entry per fetch, so a test can give consecutive runs different answers. */
+    readonly resultQueue: ModelDiscoveryResult[] = [];
+    failWith: Error | undefined;
+    apiKeySource: ApiKeySource = 'preference';
+    fetchCalls = 0;
+    allowEnvironmentApiKey: boolean | undefined;
+    /** Every registration and removal in the order they happened, e.g. `remove:test/a`. */
+    readonly calls: string[] = [];
+
+    async fetchAvailableModels(): Promise<ModelDiscoveryResult> {
+        this.fetchCalls++;
+        if (this.failWith) {
+            throw this.failWith;
+        }
+        return this.resultQueue.shift() ?? this.result;
+    }
+
+    async getApiKeySource(): Promise<ApiKeySource> {
+        return this.apiKeySource;
+    }
+
+    setAllowEnvironmentApiKey(allowed: boolean): void {
+        this.allowEnvironmentApiKey = allowed;
+    }
+
+    async createOrUpdateLanguageModels(...modelDescriptions: TestModelDescription[]): Promise<void> {
+        this.calls.push(`register:${modelDescriptions.map(description => description.id).join(',')}`);
+    }
+
+    removeLanguageModels(...modelIds: string[]): void {
+        this.calls.push(`remove:${modelIds.join(',')}`);
+    }
+}
+
+class TestContribution extends DiscoveringProviderContribution<TestModelDescription> {
+
+    protected readonly providerId = 'test';
+    protected readonly providerLabel = 'Test Provider';
+    protected readonly modelOverridesPreference = OVERRIDES_PREF;
+    protected readonly allowEnvironmentApiKeyPreference = ALLOW_ENV_PREF;
+    protected readonly manager: TestManager;
+
+    initialized = 0;
+
+    constructor(manager: TestManager) {
+        super();
+        this.manager = manager;
+    }
+
+    protected get discoveryMessages(): ModelDiscoveryMessages {
+        return {
+            noCredentials: 'no key',
+            consentRequired: 'confirm the key',
+            consentPrompt: 'may I use the key?',
+            useEnvironmentKey: 'Use key',
+            overridden: 'configured by hand',
+            cached: error => `cached: ${error}`
+        };
+    }
+
+    protected createModelDescription(model: DiscoveredModel): TestModelDescription {
+        return { id: this.qualifiedModelId(model.id), model: model.id };
+    }
+
+    protected override initializeProvider(): void {
+        this.initialized++;
+    }
+
+    /** The queued entry point, which is protected on the contribution itself. */
+    discover(): Promise<void> {
+        return this.discoverAndRegisterModels();
+    }
+}
+
+class PrefixedContribution extends TestContribution {
+    protected override get modelIdPrefix(): string {
+        return 'prefixed';
+    }
+}
+
+function createContribution(
+    preferences: Record<string, unknown> = {},
+    factory: (testManager: TestManager) => TestContribution = testManager => new TestContribution(testManager)
+): {
+    contribution: TestContribution;
+    manager: TestManager;
+    status: ModelDiscoveryStatusService;
+    written: Record<string, unknown>;
+    prompts: string[];
+    answer: (choice: string | undefined) => void;
+} {
+    const manager = new TestManager();
+    const contribution = factory(manager);
+    const status = new ModelDiscoveryStatusService();
+    const written: Record<string, unknown> = {};
+    const prompts: string[] = [];
+    let choice: string | undefined;
+    const preferenceService = {
+        ready: Promise.resolve(),
+        get: (name: string, defaultValue: unknown) => (name in preferences ? preferences[name] : defaultValue),
+        set: async (name: string, value: unknown) => { written[name] = value; },
+        onPreferenceChanged: () => ({ dispose: () => { } })
+    };
+    const messageService = {
+        info: async (text: string) => {
+            prompts.push(text);
+            return choice;
+        }
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const internals = contribution as any;
+    internals.preferenceService = preferenceService;
+    internals.discoveryStatus = status;
+    internals.messageService = messageService;
+    return { contribution, manager, status, written, prompts, answer: next => { choice = next; } };
+}
+
+function discovered(id: string): DiscoveredModel {
+    return { id };
+}
+
+describe('DiscoveringProviderContribution', () => {
+
+    it('registers what the provider offers and reports it as ready', async () => {
+        const { contribution, manager, status } = createContribution();
+        manager.result = { models: [discovered('a'), discovered('b')], fromCache: false };
+
+        await contribution.discover();
+
+        expect(manager.calls).to.deep.equal(['remove:', 'register:test/a,test/b']);
+        const reported = status.getStatus('test');
+        expect(reported?.state).to.equal('ready');
+        expect(reported?.discovered?.map(entry => entry.id)).to.deep.equal(['a', 'b']);
+        expect(reported?.lastFetch).to.be.a('number');
+    });
+
+    it('unregisters the models a later discovery no longer offers', async () => {
+        const { contribution, manager } = createContribution();
+        manager.result = { models: [discovered('a'), discovered('b')], fromCache: false };
+        await contribution.discover();
+        manager.calls.length = 0;
+
+        manager.result = { models: [discovered('b')], fromCache: false };
+        await contribution.discover();
+
+        expect(manager.calls).to.deep.equal(['remove:test/a', 'register:test/b']);
+    });
+
+    it('qualifies the model ids with the prefix the provider registers under', async () => {
+        const { contribution, manager } = createContribution({}, testManager => new PrefixedContribution(testManager));
+        manager.result = { models: [discovered('a')], fromCache: false };
+        await contribution.discover();
+        manager.calls.length = 0;
+
+        manager.result = { models: [], fromCache: false };
+        await contribution.discover();
+
+        expect(manager.calls).to.deep.equal(['remove:prefixed/a', 'register:']);
+    });
+
+    it('replaces discovery with a configured list without asking the provider', async () => {
+        const { contribution, manager, status } = createContribution({ [OVERRIDES_PREF]: ['pinned-1', 'pinned-2'] });
+
+        await contribution.discover();
+
+        expect(manager.fetchCalls).to.equal(0);
+        expect(manager.calls).to.deep.equal(['remove:', 'register:test/pinned-1,test/pinned-2']);
+        expect(status.getStatus('test')?.state).to.equal('overridden');
+    });
+
+    it('drops the registered models and asks for a credential when there is none', async () => {
+        const { contribution, manager, status } = createContribution();
+        manager.result = { models: [discovered('a')], fromCache: false };
+        await contribution.discover();
+        manager.calls.length = 0;
+
+        manager.apiKeySource = 'none';
+        await contribution.discover();
+
+        expect(manager.calls).to.deep.equal(['remove:test/a']);
+        expect(manager.fetchCalls).to.equal(1);
+        expect(status.getStatus('test')?.state).to.equal('no-credentials');
+        expect(status.getStatus('test')?.message).to.equal('no key');
+    });
+
+    it('withholds an environment key until it is confirmed, asking once', async () => {
+        const { contribution, manager, status, prompts } = createContribution();
+        manager.apiKeySource = 'environment';
+
+        await contribution.discover();
+        await contribution.discover();
+
+        expect(manager.fetchCalls).to.equal(0);
+        expect(status.getStatus('test')?.state).to.equal('awaiting-consent');
+        // Asked once per session, however often the state is reached again.
+        expect(prompts).to.deep.equal(['may I use the key?']);
+    });
+
+    it('persists the consent when the user grants it', async () => {
+        const { contribution, manager, written, answer } = createContribution();
+        manager.apiKeySource = 'environment';
+        answer('Use key');
+
+        await contribution.discover();
+        // The prompt is answered asynchronously, after the run itself has returned.
+        await Promise.resolve();
+
+        expect(written[ALLOW_ENV_PREF]).to.equal(true);
+    });
+
+    it('uses an environment key once the consent is on record', async () => {
+        const { contribution, manager, status } = createContribution({ [ALLOW_ENV_PREF]: true });
+        manager.apiKeySource = 'environment';
+        manager.result = { models: [discovered('a')], fromCache: false };
+
+        await contribution.discover();
+
+        expect(manager.fetchCalls).to.equal(1);
+        expect(status.getStatus('test')?.state).to.equal('ready');
+    });
+
+    it('keeps cached models usable and says that they may be stale', async () => {
+        const { contribution, status } = createContribution();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (contribution as any).manager.result = { models: [discovered('a')], fromCache: true, error: 'network down' };
+
+        await contribution.discover();
+
+        const reported = status.getStatus('test');
+        expect(reported?.state).to.equal('ready');
+        expect(reported?.fromCache).to.equal(true);
+        expect(reported?.message).to.equal('cached: network down');
+        // Nothing was fetched, so there is no successful fetch to date.
+        expect(reported?.lastFetch).to.equal(undefined);
+    });
+
+    it('reports a failed run instead of rejecting, since nobody awaits it', async () => {
+        const { contribution, manager, status } = createContribution();
+        manager.failWith = new Error('the endpoint is gone');
+
+        // Rejecting here would surface as an unhandled rejection from the unawaited startup call.
+        await contribution.discover();
+
+        expect(status.getStatus('test')?.state).to.equal('error');
+        expect(status.getStatus('test')?.message).to.equal('the endpoint is gone');
+    });
+
+    it('queues overlapping runs so they cannot compute what to unregister from the same list', async () => {
+        const { contribution, manager } = createContribution();
+        // The runs start before either has fetched, so what they see has to come from the queue.
+        manager.resultQueue.push({ models: [discovered('a')], fromCache: false }, { models: [discovered('b')], fromCache: false });
+
+        await Promise.all([contribution.discover(), contribution.discover()]);
+
+        // The second run sees what the first registered, rather than the empty list both started from.
+        expect(manager.calls).to.deep.equal(['remove:', 'register:test/a', 'remove:test/a', 'register:test/b']);
+    });
+
+    it('registers the provider, hands over the consent and discovers on startup', async () => {
+        const { contribution, manager, status } = createContribution();
+        manager.result = { models: [discovered('a')], fromCache: false };
+
+        contribution.onStart();
+        await contribution.discover();
+
+        expect(status.getStatus('test')?.label).to.equal('Test Provider');
+        expect(manager.allowEnvironmentApiKey).to.equal(false);
+        expect(contribution.initialized).to.equal(1);
+        expect(manager.fetchCalls).to.be.greaterThan(0);
+    });
+});