@theia/ai-core 1.76.0-next.7 → 1.76.0

package/lib/node/backend-language-model-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend-language-model-registry.js","sourceRoot":"","sources":["../../src/node/backend-language-model-registry.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,4DAA0D;AAC1D,sCAAgI;AAEhI;;GAEG;AAEI,IAAM,gCAAgC,GAAtC,MAAM,gCAAiC,SAAQ,yCAAgC;IAIlF,SAAS,CAAC,MAAmC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAEQ,iBAAiB,CAAC,MAAuB;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAChD,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChC,iDAAiD;QACjD,KAAK,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7D,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAEQ,oBAAoB,CAAC,GAAa;QACvC,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,kBAAkB,CAA0C,EAAU,EAAE,KAAiB;QACpG,MAAM,KAAK,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IAED,aAAa,CAAC,KAAoB;QAC9B,OAAO;YACH,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;SACjE,CAAC;IACN,CAAC;CACJ,CAAA;AA9CY,4EAAgC;2CAAhC,gCAAgC;IAD5C,IAAA,sBAAU,GAAE;GACA,gCAAgC,CA8C5C"}
+{"version":3,"file":"backend-language-model-registry.js","sourceRoot":"","sources":["../../src/node/backend-language-model-registry.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,4DAA0D;AAC1D,sCAAgI;AAEhI;;GAEG;AAEI,IAAM,gCAAgC,GAAtC,MAAM,gCAAiC,SAAQ,yCAAgC;IAIlF,SAAS,CAAC,MAAmC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAEQ,iBAAiB,CAAC,MAAuB;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAChD,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChC,iDAAiD;QACjD,KAAK,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7D,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAEQ,oBAAoB,CAAC,GAAa;QACvC,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,kBAAkB,CAA0C,EAAU,EAAE,KAAiB;QACpG,MAAM,KAAK,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IAED,aAAa,CAAC,KAAoB;QAC9B,OAAO;YACH,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;SACjE,CAAC;IACN,CAAC;CACJ,CAAA;AA/CY,4EAAgC;2CAAhC,gCAAgC;IAD5C,IAAA,sBAAU,GAAE;GACA,gCAAgC,CA+C5C"}

package/lib/node/index.d.ts

@@ -1,2 +1,4 @@
 export * from './proxy-util';
+export * from './model-snapshot-store';
+export * from './model-discovery-fetcher';
 //# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/lib/node/index.js

@@ -17,4 +17,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./proxy-util"), exports);
+tslib_1.__exportStar(require("./model-snapshot-store"), exports);
+tslib_1.__exportStar(require("./model-discovery-fetcher"), exports);
 //# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.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,uDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.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,uDAA6B;AAC7B,iEAAuC;AACvC,oEAA0C"}

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

@@ -0,0 +1,43 @@
+import { ILogger } from '@theia/core';
+import { DiscoveredModel, ModelDiscoveryResult } from '../common/model-discovery-status';
+import { ModelSnapshotStore } from './model-snapshot-store';
+export declare const ModelDiscoveryFetcher: unique symbol;
+/** What a provider contributes to a discovery run; everything around it is the same for all of them. */
+export interface ModelDiscoveryRequest {
+    /** Name the provider's snapshot is kept under, e.g. `anthropic-models.json`. */
+    readonly snapshotFile: string;
+    /** The provider, for the log entry a failed fetch leaves, e.g. `Anthropic`. */
+    readonly providerLabel: string;
+    /** Asks the provider what it offers. Called again while {@link isRetryable} accepts the failure. */
+    listModels(): Promise<DiscoveredModel[]>;
+    /**
+     * Whether a failure is transient enough to try again. Nothing is retried by default: a provider
+     * knows which of its SDK's errors are a connection giving out and which are an answer.
+     */
+    isRetryable?(error: unknown): boolean;
+}
+/**
+ * Runs a provider's model discovery: asks it what it offers, retries a transient failure, and keeps
+ * the answer as a snapshot so the models survive a later failure or an offline start.
+ */
+export interface ModelDiscoveryFetcher {
+    /**
+     * Discovers the models of one provider. Returns the snapshot with `fromCache` set when the fetch
+     * failed and there is one, and rejects with the fetch's own error when there is not.
+     */
+    fetch(request: ModelDiscoveryRequest): Promise<ModelDiscoveryResult>;
+}
+export declare class ModelDiscoveryFetcherImpl implements ModelDiscoveryFetcher {
+    /** Number of attempts (including the first) for a discovery fetch on a retryable error. */
+    protected maxAttempts: number;
+    /** Base linear backoff between attempts; multiplied by the number of the attempt that failed. */
+    protected retryDelayMs: number;
+    protected readonly snapshotStore: ModelSnapshotStore;
+    protected readonly logger: ILogger;
+    fetch(request: ModelDiscoveryRequest): Promise<ModelDiscoveryResult>;
+    /** Lists the models, retrying a transient failure with a linear backoff. */
+    protected listWithRetry(request: ModelDiscoveryRequest): Promise<DiscoveredModel[]>;
+    /** Waits between two attempts. Overridable so a test does not have to. */
+    protected delay(ms: number): Promise<void>;
+}
+//# sourceMappingURL=model-discovery-fetcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-discovery-fetcher.d.ts","sourceRoot":"","sources":["../../src/node/model-discovery-fetcher.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AAErE,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oGAAoG;IACpG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxE;AAED,qBACa,yBAA0B,YAAW,qBAAqB;IAEnE,2FAA2F;IAC3F,SAAS,CAAC,WAAW,SAAK;IAC1B,iGAAiG;IACjG,SAAS,CAAC,YAAY,SAAO;IAG7B,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAGrD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAE7B,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkB1E,4EAA4E;cAC5D,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAgBzF,0EAA0E;IAC1E,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C"}

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

@@ -0,0 +1,85 @@
+"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 };
+            }
+            // A run that never succeeded has no snapshot to fall back on, so record the failure here.
+            this.logger.error(`${request.providerLabel}: model discovery failed; no cached snapshot to fall back on.`, error);
+            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":"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"}

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,21 +1,21 @@
 {
   "name": "@theia/ai-core",
-  "version": "1.76.0-next.7+7c303b183",
+  "version": "1.76.0",
   "description": "Theia - AI Core",
   "dependencies": {
-    "@theia/core": "1.76.0-next.7+7c303b183",
-    "@theia/editor": "1.76.0-next.7+7c303b183",
-    "@theia/filesystem": "1.76.0-next.7+7c303b183",
-    "@theia/monaco": "1.76.0-next.7+7c303b183",
+    "@theia/core": "1.76.0",
+    "@theia/editor": "1.76.0",
+    "@theia/filesystem": "1.76.0",
+    "@theia/monaco": "1.76.0",
     "@theia/monaco-editor-core": "1.108.201",
-    "@theia/output": "1.76.0-next.7+7c303b183",
-    "@theia/variable-resolver": "1.76.0-next.7+7c303b183",
-    "@theia/workspace": "1.76.0-next.7+7c303b183",
+    "@theia/output": "1.76.0",
+    "@theia/variable-resolver": "1.76.0",
+    "@theia/workspace": "1.76.0",
     "@types/js-yaml": "^4.0.9",
     "fast-deep-equal": "^3.1.3",
-    "js-yaml": "^4.3.1",
+    "js-yaml": "^4.3.2",
     "tslib": "^2.8.1",
-    "undici": "^7.29.0"
+    "undici": "^7.29.1"
   },
   "main": "lib/common",
   "publishConfig": {
@@ -53,10 +53,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.75.0"
+    "@theia/ext-scripts": "1.76.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "7c303b1836421183d7013f0bd679a9a30ff0b5dc"
+  "gitHead": "b9b54c500b46515512e2b44371bc0c7122947bed"
 }

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();