@theia/ai-copilot 1.75.0 → 1.76.0-next.10

package/lib/node/copilot-sdk-client-provider.js

@@ -0,0 +1,247 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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.CopilotSdkClientProvider = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+const env_variables_1 = require("@theia/core/lib/common/env-variables");
+const file_uri_1 = require("@theia/core/lib/common/file-uri");
+const copilot_credential_store_1 = require("./copilot-credential-store");
+const copilot_cli_locator_1 = require("./copilot-cli-locator");
+const copilot_runtime_env_1 = require("./copilot-runtime-env");
+const copilot_sdk_loader_1 = require("./copilot-sdk-loader");
+const copilot_sdk_mappers_1 = require("./copilot-sdk-mappers");
+/**
+ * Manages the lifecycle of a {@link CopilotClient}, which spawns and talks to the
+ * official Copilot CLI over JSON-RPC.
+ *
+ * The runtime is given the token this application holds, and nothing else: credentials the CLI could
+ * otherwise pick up on its own, from the environment or from the sign-in of the GitHub CLI, are not a
+ * sign-in of this application and are deliberately kept out of reach. The token is established by
+ * {@link CopilotCliAuthProvider} and kept in {@link CopilotCredentialStore}.
+ *
+ * A single client is started lazily and shared for the lifetime of the (connection-scoped) backend
+ * container. It is recreated when the host configuration changes.
+ *
+ * Note: this provider is bound in the per-connection container, so each frontend connection runs
+ * its own CLI process, authenticated with the credentials of the backend host. This is not suitable
+ * for multi-user backend deployments, where every connected frontend would share a single identity.
+ */
+let CopilotSdkClientProvider = class CopilotSdkClientProvider {
+    /**
+     * Returns a started {@link CopilotClient}, creating (or recreating, if the
+     * configuration changed) one on demand.
+     */
+    async getClient() {
+        const credentials = await this.credentialStore.get();
+        if (!credentials) {
+            throw new Error(core_1.nls.localize('theia/ai/copilot/notSignedInSignInFirst', 'Not signed in to GitHub Copilot. Please sign in first.'));
+        }
+        const configKey = this.getConfigKey(credentials);
+        if (this.clientPromise && this.clientConfigKey === configKey) {
+            return this.clientPromise;
+        }
+        // First use or changed credentials: (re)create the client. Capture the
+        // previous client and assign synchronously so concurrent callers share
+        // the same promise instead of spawning multiple CLI processes.
+        const previous = this.clientPromise;
+        this.clientConfigKey = configKey;
+        this.clientPromise = this.recreate(configKey, credentials, previous);
+        return this.clientPromise;
+    }
+    /**
+     * Lists the model IDs available to the authenticated user via the Copilot CLI.
+     * Because the CLI runs under an entitled identity, this returns the full current model lineup
+     * rather than the baseline set that the direct REST API exposes to an unentitled OAuth app.
+     */
+    async listModelIds() {
+        const client = await this.getClient();
+        try {
+            const models = await client.listModels();
+            return (0, copilot_sdk_mappers_1.selectSdkModelIds)(models);
+        }
+        catch (error) {
+            throw this.enrichEntitlementError(error);
+        }
+    }
+    /**
+     * Replaces the bare authorization failure of the Copilot runtime with an explanation of the
+     * possible causes, because the runtime only reports that the feature is not authorized.
+     */
+    enrichEntitlementError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.includes('not authorized to use this Copilot feature') && !message.includes('Access denied by policy settings')) {
+            return error;
+        }
+        return new Error(core_1.nls.localize('theia/ai/copilot/notAuthorized', 'GitHub Copilot rejected the request as not authorized for this account. Either the account has no Copilot subscription, or '
+            + 'access has to be enabled by an administrator through an organization or enterprise policy. Signing out and in again also '
+            + 'renews credentials that were revoked. GitHub reports requests sent to an API host that does not match the subscription the '
+            + 'same way, so as a last resort the host can be set explicitly with the `COPILOT_API_URL` environment variable of the backend. '
+            + 'Reported by the Copilot runtime: {0}', message));
+    }
+    getConfigKey(credentials) {
+        return `${credentials.enterpriseUrl ?? ''}|${credentials.token}`;
+    }
+    async recreate(configKey, credentials, previous) {
+        if (previous) {
+            try {
+                const previousClient = await previous;
+                await previousClient.stop();
+            }
+            catch (error) {
+                this.logger.warn('Copilot SDK: failed to stop previous client:', error);
+            }
+        }
+        const sdk = await this.sdkLoader.load();
+        const client = new sdk.CopilotClient(this.createClientOptions(sdk, credentials, await this.cliLocator.resolve(), await this.getCopilotHome()));
+        try {
+            await client.start();
+        }
+        catch (error) {
+            // Don't cache a failed start, otherwise every later call replays the rejection.
+            if (this.clientConfigKey === configKey) {
+                this.clientPromise = undefined;
+                this.clientConfigKey = undefined;
+            }
+            throw error;
+        }
+        return client;
+    }
+    /**
+     * Builds the options of the {@link CopilotClient}.
+     *
+     * The token of this application is passed explicitly and the resolution of a logged-in user is
+     * switched off, so that the runtime cannot fall back to credentials this application does not own.
+     *
+     * The CLI is passed explicitly as well, see {@link CopilotCliLocator}: the SDK would otherwise look
+     * for the JavaScript entry point of a platform package installed next to itself and spawn it with
+     * `process.execPath`, which is the Electron binary rather than Node.js in an Electron application.
+     *
+     * The runtime is configured in `empty` mode rather than in the `copilot-cli` mode the SDK defaults
+     * to. That mode brings the ambient behaviour of the CLI along, which the SDK documents as unsuitable
+     * for an application serving requests on a backend: instructions and skills found on the host,
+     * session and memory stores, host git operations and plugins. Theia drives the conversation itself
+     * and declares the tools of each request, so none of that applies, and `empty` mode additionally
+     * keeps the runtime away from the system keychain. Its two requirements are met here, a persistence
+     * location ({@link getCopilotHome}) and an explicit tool list per session.
+     */
+    createClientOptions(sdk, credentials, cliPath, baseDirectory) {
+        return {
+            connection: sdk.RuntimeConnection.forStdio({ path: cliPath }),
+            mode: 'empty',
+            baseDirectory,
+            gitHubToken: credentials.token,
+            useLoggedInUser: false,
+            logLevel: 'error',
+            env: this.createRuntimeEnv(credentials)
+        };
+    }
+    /**
+     * The Copilot home the runtime is pointed at, below the configuration directory of Theia.
+     *
+     * Requests are served in sessions that the runtime persists in its home, and the default home is
+     * the one the user's own Copilot CLI uses. Prompts sent from Theia would end up listed among the
+     * conversations the user started themselves, so this application keeps its own.
+     */
+    async getCopilotHome() {
+        const configDirectory = file_uri_1.FileUri.fsPath(new core_1.URI(await this.envVariablesServer.getConfigDirUri()));
+        const home = (0, path_1.join)(configDirectory, 'copilot');
+        await fs_1.promises.mkdir(home, { recursive: true });
+        return home;
+    }
+    /**
+     * Returns the environment for the runtime process.
+     *
+     * Tokens from the environment are removed: the runtime accepts them even when a token is passed
+     * explicitly, and they are not a sign-in of this application. The GitHub host is taken from the
+     * credentials, so that the runtime always talks to the deployment that was signed in to.
+     *
+     * The Copilot API endpoint is deliberately not set: the runtime resolves the one belonging to the
+     * subscription from the token, including for Business and Enterprise seats. The environment of the
+     * backend is inherited as-is, so an operator can still override it with `COPILOT_API_URL` should
+     * that resolution ever fail for a deployment.
+     */
+    createRuntimeEnv(credentials) {
+        return {
+            ...copilot_runtime_env_1.CopilotRuntimeEnv.withoutTokens(process.env),
+            ...(credentials.enterpriseUrl ? { COPILOT_GH_HOST: credentials.enterpriseUrl } : {})
+        };
+    }
+    /**
+     * Stops and clears the current client. Safe to call when no client exists.
+     */
+    async reset() {
+        const previous = this.clientPromise;
+        this.clientPromise = undefined;
+        this.clientConfigKey = undefined;
+        if (previous) {
+            try {
+                const client = await previous;
+                await client.stop();
+            }
+            catch (error) {
+                this.logger.warn('Copilot SDK: failed to stop client during reset:', error);
+            }
+        }
+    }
+    /**
+     * Stops the CLI when the container this provider lives in goes away, which happens when the
+     * frontend connection it belongs to is closed.
+     *
+     * A closing connection unbinds its container, and unbinding runs `@preDestroy` rather than
+     * `dispose`. Without this hook the CLI of every closed connection would keep running for the rest
+     * of the lifetime of the backend.
+     */
+    async stop() {
+        await this.reset();
+    }
+};
+exports.CopilotSdkClientProvider = CopilotSdkClientProvider;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(copilot_credential_store_1.CopilotCredentialStore),
+    tslib_1.__metadata("design:type", copilot_credential_store_1.CopilotCredentialStore)
+], CopilotSdkClientProvider.prototype, "credentialStore", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(copilot_cli_locator_1.CopilotCliLocator),
+    tslib_1.__metadata("design:type", copilot_cli_locator_1.CopilotCliLocator)
+], CopilotSdkClientProvider.prototype, "cliLocator", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(copilot_sdk_loader_1.CopilotSdkLoader),
+    tslib_1.__metadata("design:type", copilot_sdk_loader_1.CopilotSdkLoader)
+], CopilotSdkClientProvider.prototype, "sdkLoader", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(env_variables_1.EnvVariablesServer),
+    tslib_1.__metadata("design:type", Object)
+], CopilotSdkClientProvider.prototype, "envVariablesServer", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('ai-copilot:CopilotSdkClientProvider'),
+    tslib_1.__metadata("design:type", Object)
+], CopilotSdkClientProvider.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.preDestroy)(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], CopilotSdkClientProvider.prototype, "stop", null);
+exports.CopilotSdkClientProvider = CopilotSdkClientProvider = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], CopilotSdkClientProvider);
+//# sourceMappingURL=copilot-sdk-client-provider.js.map

package/lib/node/copilot-sdk-client-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-client-provider.js","sourceRoot":"","sources":["../../src/node/copilot-sdk-client-provider.ts"],"names":[],"mappings":"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"}

package/lib/node/copilot-sdk-client-provider.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=copilot-sdk-client-provider.spec.d.ts.map

package/lib/node/copilot-sdk-client-provider.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-client-provider.spec.d.ts","sourceRoot":"","sources":["../../src/node/copilot-sdk-client-provider.spec.ts"],"names":[],"mappings":""}

package/lib/node/copilot-sdk-client-provider.spec.js

@@ -0,0 +1,215 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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 });
+const chai_1 = require("chai");
+const fs_1 = require("fs");
+const os = require("os");
+const path_1 = require("path");
+const mock_logger_1 = require("@theia/core/lib/common/test/mock-logger");
+const file_uri_1 = require("@theia/core/lib/common/file-uri");
+const copilot_sdk_client_provider_1 = require("./copilot-sdk-client-provider");
+/** The SDK as the provider uses it: a client constructor and the stdio connection factory. */
+function sdkStub() {
+    const started = [];
+    const stopped = [];
+    class StubClient {
+        constructor(options) {
+            this.options = options;
+        }
+        async start() {
+            started.push(String(this.options?.gitHubToken));
+        }
+        async stop() {
+            stopped.push(String(this.options?.gitHubToken));
+            return [];
+        }
+        async listModels() {
+            return [];
+        }
+    }
+    return {
+        api: {
+            CopilotClient: StubClient,
+            RuntimeConnection: { forStdio: (options) => ({ kind: 'stdio', ...options }) }
+        },
+        started,
+        stopped
+    };
+}
+class TestableCopilotSdkClientProvider extends copilot_sdk_client_provider_1.CopilotSdkClientProvider {
+    constructor(sdk, configDirectory, cli = (0, path_1.join)('/opt', 'copilot', 'copilot')) {
+        super();
+        this.credentials = { token: 'gho_first' };
+        Object.assign(this, {
+            logger: new mock_logger_1.MockLogger(),
+            credentialStore: { get: async () => this.credentials },
+            cliLocator: { resolve: async () => cli },
+            sdkLoader: { load: async () => sdk },
+            envVariablesServer: { getConfigDirUri: async () => file_uri_1.FileUri.create(configDirectory).toString() }
+        });
+    }
+    callCreateRuntimeEnv(credentials) {
+        return this.createRuntimeEnv(credentials);
+    }
+    callEnrichEntitlementError(error) {
+        return this.enrichEntitlementError(error);
+    }
+    clientOptions(client) {
+        return client.options;
+    }
+}
+describe('CopilotSdkClientProvider - client options', () => {
+    let configDirectory;
+    let sdk;
+    beforeEach(async () => {
+        configDirectory = await fs_1.promises.mkdtemp((0, path_1.join)(os.tmpdir(), 'theia-copilot-config-'));
+        sdk = sdkStub();
+    });
+    afterEach(async () => {
+        await fs_1.promises.rm(configDirectory, { recursive: true, force: true });
+    });
+    it('should hand the located CLI and the token of this application to the runtime', async () => {
+        const provider = new TestableCopilotSdkClientProvider(sdk.api, configDirectory);
+        const options = provider.clientOptions(await provider.getClient());
+        (0, chai_1.expect)(options?.connection).to.deep.equal({ kind: 'stdio', path: (0, path_1.join)('/opt', 'copilot', 'copilot') });
+        (0, chai_1.expect)(options?.gitHubToken).to.equal('gho_first');
+        // Nothing the runtime finds on the host may make it appear signed in.
+        (0, chai_1.expect)(options?.useLoggedInUser).to.be.false;
+    });
+    it('should keep the runtime out of the ambient behaviour of the CLI', async () => {
+        const provider = new TestableCopilotSdkClientProvider(sdk.api, configDirectory);
+        const options = provider.clientOptions(await provider.getClient());
+        (0, chai_1.expect)(options?.mode).to.equal('empty');
+    });
+    it('should point the runtime at a Copilot home of the application and create it', async () => {
+        const provider = new TestableCopilotSdkClientProvider(sdk.api, configDirectory);
+        const options = provider.clientOptions(await provider.getClient());
+        const home = (0, path_1.join)(configDirectory, 'copilot');
+        // Compared without case, because the URI of the configuration directory lowercases the drive
+        // letter on Windows, which addresses the same location.
+        (0, chai_1.expect)(options?.baseDirectory?.toLowerCase()).to.equal(home.toLowerCase());
+        (0, chai_1.expect)((await fs_1.promises.stat(home)).isDirectory()).to.be.true;
+    });
+});
+describe('CopilotSdkClientProvider - runtime environment', () => {
+    const provider = new TestableCopilotSdkClientProvider(sdkStub().api, os.tmpdir());
+    it('should remove tokens of the environment, which are not a sign-in of this application', () => {
+        const previous = { ...process.env };
+        try {
+            process.env.GITHUB_TOKEN = 'gho_environment';
+            process.env.GH_TOKEN = 'gho_environment';
+            process.env.COPILOT_GITHUB_TOKEN = 'gho_environment';
+            const env = provider.callCreateRuntimeEnv({ token: 'gho_ours' });
+            (0, chai_1.expect)(env.GITHUB_TOKEN).to.be.undefined;
+            (0, chai_1.expect)(env.GH_TOKEN).to.be.undefined;
+            (0, chai_1.expect)(env.COPILOT_GITHUB_TOKEN).to.be.undefined;
+        }
+        finally {
+            process.env = previous;
+        }
+    });
+    it('should remove a token variable whatever its case, since Windows ignores it', () => {
+        const previous = { ...process.env };
+        try {
+            process.env.Gh_Token = 'gho_environment';
+            const env = provider.callCreateRuntimeEnv({ token: 'gho_ours' });
+            (0, chai_1.expect)(Object.keys(env).some(name => name.toLowerCase() === 'gh_token')).to.be.false;
+        }
+        finally {
+            process.env = previous;
+        }
+    });
+    it('should point the runtime at the deployment that was signed in to', () => {
+        const env = provider.callCreateRuntimeEnv({ token: 'gho_ours', enterpriseUrl: 'company.ghe.com' });
+        (0, chai_1.expect)(env.COPILOT_GH_HOST).to.equal('company.ghe.com');
+    });
+    it('should leave the host alone for a sign-in against GitHub.com', () => {
+        (0, chai_1.expect)(provider.callCreateRuntimeEnv({ token: 'gho_ours' })).to.not.have.property('COPILOT_GH_HOST');
+    });
+});
+describe('CopilotSdkClientProvider - lifecycle', () => {
+    let configDirectory;
+    let sdk;
+    let provider;
+    beforeEach(async () => {
+        configDirectory = await fs_1.promises.mkdtemp((0, path_1.join)(os.tmpdir(), 'theia-copilot-config-'));
+        sdk = sdkStub();
+        provider = new TestableCopilotSdkClientProvider(sdk.api, configDirectory);
+    });
+    afterEach(async () => {
+        await fs_1.promises.rm(configDirectory, { recursive: true, force: true });
+    });
+    it('should reject when the application is not signed in', async () => {
+        provider.credentials = undefined;
+        try {
+            await provider.getClient();
+            chai_1.expect.fail('should have rejected');
+        }
+        catch (error) {
+            (0, chai_1.expect)(String(error)).to.contain('sign in');
+        }
+    });
+    it('should start one CLI and share it, also for concurrent callers', async () => {
+        const [first, second] = await Promise.all([provider.getClient(), provider.getClient()]);
+        (0, chai_1.expect)(first).to.equal(second);
+        (0, chai_1.expect)(await provider.getClient()).to.equal(first);
+        (0, chai_1.expect)(sdk.started).to.deep.equal(['gho_first']);
+    });
+    it('should replace the client when the credentials changed, stopping the previous one', async () => {
+        const first = await provider.getClient();
+        provider.credentials = { token: 'gho_second' };
+        const second = await provider.getClient();
+        (0, chai_1.expect)(second).to.not.equal(first);
+        (0, chai_1.expect)(sdk.started).to.deep.equal(['gho_first', 'gho_second']);
+        (0, chai_1.expect)(sdk.stopped).to.deep.equal(['gho_first']);
+    });
+    it('should stop the CLI on reset and start a new one afterwards', async () => {
+        await provider.getClient();
+        await provider.reset();
+        (0, chai_1.expect)(sdk.stopped).to.deep.equal(['gho_first']);
+        await provider.getClient();
+        (0, chai_1.expect)(sdk.started).to.deep.equal(['gho_first', 'gho_first']);
+    });
+    it('should not cache a client whose runtime failed to start', async () => {
+        const failing = sdkStub();
+        failing.api.CopilotClient = class {
+            async start() {
+                throw new Error('runtime did not come up');
+            }
+        };
+        const other = new TestableCopilotSdkClientProvider(failing.api, configDirectory);
+        await other.getClient().catch(() => { });
+        // A cached rejection would keep replaying instead of trying again.
+        await other.getClient().catch(error => (0, chai_1.expect)(String(error)).to.contain('did not come up'));
+    });
+});
+describe('CopilotSdkClientProvider - entitlement errors', () => {
+    const provider = new TestableCopilotSdkClientProvider(sdkStub().api, os.tmpdir());
+    it('should explain what an authorization failure of the runtime can mean', () => {
+        const enriched = provider.callEnrichEntitlementError(new Error('user is not authorized to use this Copilot feature'));
+        (0, chai_1.expect)(String(enriched)).to.contain('subscription');
+        (0, chai_1.expect)(String(enriched)).to.contain('not authorized to use this Copilot feature');
+    });
+    it('should explain a policy rejection the same way', () => {
+        (0, chai_1.expect)(String(provider.callEnrichEntitlementError(new Error('Access denied by policy settings')))).to.contain('administrator');
+    });
+    it('should pass an unrelated failure through unchanged', () => {
+        const error = new Error('socket hang up');
+        (0, chai_1.expect)(provider.callEnrichEntitlementError(error)).to.equal(error);
+    });
+});
+//# sourceMappingURL=copilot-sdk-client-provider.spec.js.map

package/lib/node/copilot-sdk-client-provider.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-client-provider.spec.js","sourceRoot":"","sources":["../../src/node/copilot-sdk-client-provider.spec.ts"],"names":[],"mappings":"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"}

package/lib/node/copilot-sdk-language-model.d.ts

@@ -0,0 +1,85 @@
+import { LanguageModel, LanguageModelResponse, LanguageModelStatus, LanguageModelStreamResponsePart, ToolRequest, UserRequest } from '@theia/ai-core';
+import { CancellationToken, ILogger } from '@theia/core';
+import type { CopilotClient, CopilotSession, PermissionHandler, Tool } from './copilot-sdk-types';
+/**
+ * Answers the permission requests of the CLI for the tools of a request.
+ *
+ * Only Theia's own tools are declared to the CLI, and those are gated by Theia's tool confirmation
+ * already, so a second confirmation by the CLI would ask the user the same question twice. This is
+ * the behaviour of the SDK's own `approveAll`, which cannot be used here because it is not imported
+ * at runtime.
+ *
+ * A request that managed policy reserves for an explicit decision is not approved on the user's
+ * behalf but denied as unconfirmable. Leaving it unanswered is what the SDK's `no-result` does, and
+ * it is only correct when another client is connected that can answer it; here it would leave the
+ * turn pending until the request is cancelled.
+ */
+export declare const approveTheiaTools: PermissionHandler;
+/**
+ * Collects the stream parts produced by the session events and by the tool handlers, and hands them
+ * to the consuming generator as they arrive.
+ *
+ * A buffer is needed because the parts originate from callbacks rather than from a stream we can
+ * await, and because the tool handlers of a turn run while its response is still being produced.
+ */
+export declare class CopilotStreamSink {
+    protected readonly queue: LanguageModelStreamResponsePart[];
+    protected readonly flushWaiters: Array<() => void>;
+    protected notify: (() => void) | undefined;
+    protected done: boolean;
+    protected failure: unknown;
+    push(part: LanguageModelStreamResponsePart): void;
+    /**
+     * Resolves once everything pushed so far has been taken by the consumer.
+     *
+     * Needed because a tool call has to be reported before the tool runs: the caller creates the
+     * record of the call from the stream, and the tool handler then completes that record. Handing the
+     * part over and invoking the handler in the same turn would leave the handler with nothing to
+     * complete.
+     */
+    flush(): Promise<void>;
+    /**
+     * Ends the stream. A given error is raised to the consumer once the buffered parts are drained.
+     */
+    finish(error?: unknown): void;
+    drain(): AsyncIterable<LanguageModelStreamResponsePart>;
+    protected wake(): void;
+    protected releaseFlushWaiters(): void;
+}
+/**
+ * Language model implementation for GitHub Copilot backed by the official Copilot
+ * CLI via `@github/copilot-sdk`.
+ *
+ * The CLI is an agent that owns the tool-calling loop, whereas Theia's language model contract
+ * expects the caller to drive it. The two are reconciled by handing the tools of the request to the
+ * CLI as custom tools whose handlers delegate back to Theia, and by reporting every invocation as a
+ * tool call part, so that the conversation and its tool calls are recorded and rendered as usual.
+ * None of the CLI's own tools are exposed, so only what Theia provides can run.
+ *
+ * Structured output is not supported on this path.
+ */
+export declare class CopilotSdkLanguageModel implements LanguageModel {
+    readonly id: string;
+    model: string;
+    status: LanguageModelStatus;
+    maxRetries: number;
+    protected readonly clientProvider: () => Promise<CopilotClient>;
+    protected readonly logger: ILogger;
+    constructor(id: string, model: string, status: LanguageModelStatus, maxRetries: number, clientProvider: () => Promise<CopilotClient>, logger: ILogger);
+    request(request: UserRequest, cancellationToken?: CancellationToken): Promise<LanguageModelResponse>;
+    /**
+     * Maps the tools of the request onto tools of the CLI, reporting each invocation to the stream.
+     */
+    protected createTools(tools: ToolRequest[], sink: CopilotStreamSink): Tool[];
+    protected delay(ms: number): Promise<void>;
+    protected streamResponse(client: CopilotClient, session: CopilotSession, prompt: string, sink: CopilotStreamSink, cancellationToken?: CancellationToken): AsyncIterable<LanguageModelStreamResponsePart>;
+    /**
+     * Ends the session of a request and removes what it persisted.
+     *
+     * Disconnecting only releases the session in memory and keeps it stored for a later resumption,
+     * which Theia never does: it drives the conversation itself and starts a fresh session per
+     * request. Without the deletion, every request would leave a session behind in the Copilot home.
+     */
+    protected discardSession(client: CopilotClient, session: CopilotSession): Promise<void>;
+}
+//# sourceMappingURL=copilot-sdk-language-model.d.ts.map

package/lib/node/copilot-sdk-language-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-language-model.d.ts","sourceRoot":"","sources":["../../src/node/copilot-sdk-language-model.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEH,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,+BAA+B,EAC/B,WAAW,EACX,WAAW,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGlG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAOF;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAE1B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,+BAA+B,EAAE,CAAM;IACjE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAM;IACxD,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,IAAI,UAAS;IACvB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAE3B,IAAI,CAAC,IAAI,EAAE,+BAA+B,GAAG,IAAI;IAKjD;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAQtB,KAAK,IAAI,aAAa,CAAC,+BAA+B,CAAC;IAkB9D,SAAS,CAAC,IAAI,IAAI,IAAI;IAMtB,SAAS,CAAC,mBAAmB,IAAI,IAAI;CAMxC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,aAAa;aAGrC,EAAE,EAAE,MAAM;IACnB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,mBAAmB;IAC3B,UAAU,EAAE,MAAM;IACzB,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC;IAC/D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;gBALlB,EAAE,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,MAAM,EACN,cAAc,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EAC5C,MAAM,EAAE,OAAO;IAGhC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2B1G;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAAE;IA4C5E,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAIzB,cAAc,CAC3B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,iBAAiB,CAAC,EAAE,iBAAiB,GACtC,aAAa,CAAC,+BAA+B,CAAC;IAsEjD;;;;;;OAMG;cACa,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAYhG"}