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

package/lib/node/copilot-sdk-mappers.spec.js

@@ -0,0 +1,133 @@
+"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 copilot_sdk_mappers_1 = require("./copilot-sdk-mappers");
+// Minimal ModelInfo factory: selectSdkModelIds only reads `id` and `policy.state`.
+function model(id, state) {
+    return { id, policy: state ? { state } : undefined };
+}
+describe('copilot-sdk-mappers - selectSdkModelIds', () => {
+    it('keeps enabled and unconfigured models and drops disabled ones', () => {
+        const result = (0, copilot_sdk_mappers_1.selectSdkModelIds)([
+            model('gpt-4o', 'enabled'),
+            model('o1', 'disabled'),
+            model('claude', 'unconfigured'),
+            model('gpt-5')
+        ]);
+        (0, chai_1.expect)(result).to.deep.equal(['gpt-4o', 'claude', 'gpt-5']);
+    });
+    it('preserves order and removes duplicates', () => {
+        const result = (0, copilot_sdk_mappers_1.selectSdkModelIds)([
+            model('a', 'enabled'),
+            model('b', 'enabled'),
+            model('a', 'enabled')
+        ]);
+        (0, chai_1.expect)(result).to.deep.equal(['a', 'b']);
+    });
+    it('drops a dated release when its family is offered as well', () => {
+        const result = (0, copilot_sdk_mappers_1.selectSdkModelIds)([
+            model('gpt-5'),
+            model('gpt-5-2026-04-17'),
+            model('claude-sonnet-5'),
+            model('claude-sonnet-5-20260514')
+        ]);
+        (0, chai_1.expect)(result).to.deep.equal(['gpt-5', 'claude-sonnet-5']);
+    });
+    it('keeps a dated release that is the only way to select that model', () => {
+        const result = (0, copilot_sdk_mappers_1.selectSdkModelIds)([model('gpt-5'), model('o5-preview-2026-03-01')]);
+        (0, chai_1.expect)(result).to.deep.equal(['gpt-5', 'o5-preview-2026-03-01']);
+    });
+    it('keeps a dated release whose family is disabled by policy', () => {
+        const result = (0, copilot_sdk_mappers_1.selectSdkModelIds)([model('gpt-5', 'disabled'), model('gpt-5-2026-04-17')]);
+        (0, chai_1.expect)(result).to.deep.equal(['gpt-5-2026-04-17']);
+    });
+    it('returns an empty list when given no models', () => {
+        (0, chai_1.expect)((0, copilot_sdk_mappers_1.selectSdkModelIds)([])).to.deep.equal([]);
+    });
+});
+describe('copilot-sdk-mappers - buildSdkPrompt', () => {
+    it('forwards a lone user turn verbatim with no system text', () => {
+        const messages = [
+            { actor: 'user', type: 'text', text: 'hello world' }
+        ];
+        const result = (0, copilot_sdk_mappers_1.buildSdkPrompt)(messages);
+        (0, chai_1.expect)(result.systemText).to.equal('');
+        (0, chai_1.expect)(result.prompt).to.equal('hello world');
+    });
+    it('extracts and concatenates system messages', () => {
+        const messages = [
+            { actor: 'system', type: 'text', text: 'You are helpful.' },
+            { actor: 'system', type: 'text', text: 'Be concise.' },
+            { actor: 'user', type: 'text', text: 'hi' }
+        ];
+        const result = (0, copilot_sdk_mappers_1.buildSdkPrompt)(messages);
+        (0, chai_1.expect)(result.systemText).to.equal('You are helpful.\n\nBe concise.');
+        (0, chai_1.expect)(result.prompt).to.equal('hi');
+    });
+    it('renders a multi-message history as a role-labelled transcript', () => {
+        const messages = [
+            { actor: 'user', type: 'text', text: 'first' },
+            { actor: 'ai', type: 'text', text: 'reply' },
+            { actor: 'user', type: 'text', text: 'second' }
+        ];
+        const result = (0, copilot_sdk_mappers_1.buildSdkPrompt)(messages);
+        (0, chai_1.expect)(result.prompt).to.equal('User: first\n\nAssistant: reply\n\nUser: second');
+    });
+    it('drops thinking messages from the conversation body', () => {
+        const messages = [
+            { actor: 'ai', type: 'thinking', thinking: 'internal', signature: 's' },
+            { actor: 'user', type: 'text', text: 'only user' }
+        ];
+        const result = (0, copilot_sdk_mappers_1.buildSdkPrompt)(messages);
+        (0, chai_1.expect)(result.prompt).to.equal('only user');
+    });
+    it('summarises tool use and tool result messages in the transcript', () => {
+        const messages = [
+            { actor: 'user', type: 'text', text: 'run it' },
+            { actor: 'ai', type: 'tool_use', id: 'call_1', name: 'foo', input: { x: 1 } },
+            { actor: 'user', type: 'tool_result', tool_use_id: 'call_1', name: 'foo', content: 'done' }
+        ];
+        const result = (0, copilot_sdk_mappers_1.buildSdkPrompt)(messages);
+        (0, chai_1.expect)(result.prompt).to.equal('User: run it\n\nAssistant: [tool call: foo {"x":1}]\n\nUser: [tool result: done]');
+    });
+});
+describe('copilot-sdk-mappers - buildSdkSystemMessage', () => {
+    it('carries the system text as the content of the system message', () => {
+        const systemMessage = (0, copilot_sdk_mappers_1.buildSdkSystemMessage)('be helpful');
+        (0, chai_1.expect)(systemMessage?.mode).to.equal('customize');
+        (0, chai_1.expect)(systemMessage?.content).to.equal('be helpful');
+    });
+    it('removes the agent instructions of the CLI that the Theia prompt replaces', () => {
+        const systemMessage = (0, copilot_sdk_mappers_1.buildSdkSystemMessage)('be helpful');
+        const sections = systemMessage?.mode === 'customize' ? systemMessage.sections : undefined;
+        (0, chai_1.expect)(Object.keys(sections ?? {})).to.have.members(['identity', 'tone', 'guidelines', 'code_change_rules']);
+        for (const section of Object.values(sections ?? {})) {
+            (0, chai_1.expect)(section?.action).to.equal('remove');
+        }
+    });
+    it('keeps the tool instructions of the CLI, which tool calling relies on', () => {
+        const systemMessage = (0, copilot_sdk_mappers_1.buildSdkSystemMessage)('be helpful');
+        const sections = systemMessage?.mode === 'customize' ? systemMessage.sections : undefined;
+        (0, chai_1.expect)(sections).to.not.have.property('tool_instructions');
+        (0, chai_1.expect)(sections).to.not.have.property('safety');
+    });
+    it('configures nothing when the request has no system text', () => {
+        (0, chai_1.expect)((0, copilot_sdk_mappers_1.buildSdkSystemMessage)('')).to.be.undefined;
+    });
+});
+//# sourceMappingURL=copilot-sdk-mappers.spec.js.map

package/lib/node/copilot-sdk-mappers.spec.js.map

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

package/lib/node/copilot-sdk-types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * The part of the Copilot SDK API this integration uses, mirrored by hand.
+ *
+ * Mirrored from `@github/copilot-sdk` 1.0.9 (protocol version 3), which the Copilot CLI 1.0.79 ships.
+ * The package is deliberately not a dependency: it depends on the CLI, a large proprietary binary that
+ * would end up in the tree and the lockfile of every application. The CLI is a prerequisite on the
+ * backend host instead, see `CopilotCliLocator`, and the SDK is loaded from it at runtime, see
+ * `CopilotSdkLoader`.
+ *
+ * Only what this integration passes to the SDK or reads from it is declared, so a drift shows up as a
+ * compile error here rather than at runtime. `scripts/copilot-sdk-mirror` checks the mirror against a
+ * released SDK and runs in CI on a schedule; update the version above along with the declarations.
+ */
+export interface ModelPolicy {
+    state: 'enabled' | 'disabled' | 'unconfigured';
+}
+/** A model as reported by {@link CopilotClient.listModels}. */
+export interface ModelInfo {
+    /** Model identifier, for example `claude-sonnet-4.5`. */
+    id: string;
+    policy?: ModelPolicy;
+}
+/** The sections the runtime assembles its system prompt from. Unknown ids are a silent no-op there. */
+export type SystemMessageSection = 'preamble' | 'identity' | 'tone' | 'tool_efficiency' | 'environment_context' | 'code_change_rules' | 'guidelines' | 'safety' | 'tool_instructions' | 'custom_instructions' | 'runtime_instructions' | 'last_instructions';
+export type SectionTransformFn = (currentContent: string) => string | Promise<string>;
+export type SectionOverrideAction = 'replace' | 'remove' | 'append' | 'prepend' | 'preserve' | SectionTransformFn;
+export interface SectionOverride {
+    action: SectionOverrideAction;
+    content?: string;
+}
+/** The SDK foundation plus the given content. */
+export interface SystemMessageAppendConfig {
+    mode?: 'append';
+    content?: string;
+}
+/** The given content as the entire system message. */
+export interface SystemMessageReplaceConfig {
+    mode: 'replace';
+    content: string;
+}
+/** The SDK structure with section-level overrides, which is what this integration uses. */
+export interface SystemMessageCustomizeConfig {
+    mode: 'customize';
+    sections?: Partial<Record<SystemMessageSection, SectionOverride>>;
+    content?: string;
+}
+export type SystemMessageConfig = SystemMessageAppendConfig | SystemMessageReplaceConfig | SystemMessageCustomizeConfig;
+/** What the runtime tells a tool handler about its invocation. */
+export interface ToolInvocation {
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    arguments: unknown;
+}
+export type ToolHandler = (args: unknown, invocation: ToolInvocation) => Promise<unknown> | unknown;
+/** A tool declared to the runtime. `parameters` also accepts a Zod schema upstream. */
+export interface Tool {
+    name: string;
+    description?: string;
+    parameters?: Record<string, unknown>;
+    handler?: ToolHandler;
+    /** When true, the tool runs without a permission prompt of the runtime. */
+    skipPermission?: boolean;
+}
+/**
+ * A permission request of the runtime, upstream a union over the kind of operation with its own fields.
+ * Only `managedApprovalRequired` is read, which managed policy sets for a request it reserves for the
+ * user.
+ */
+export interface PermissionRequest {
+    readonly kind: string;
+    readonly managedApprovalRequired?: boolean;
+}
+/** The decisions this integration can return. Upstream also has scopes that outlive a request. */
+export type PermissionRequestResult = {
+    kind: 'approve-once';
+} | {
+    kind: 'reject';
+    feedback?: string;
+}
+/** No user is available to confirm the request. */
+ | {
+    kind: 'user-not-available';
+}
+/** Leaves the request pending, so that another connected client can answer it. */
+ | {
+    kind: 'no-result';
+};
+export type PermissionHandler = (request: PermissionRequest, invocation: {
+    sessionId: string;
+    managedSettingsEnabled?: boolean;
+}) => Promise<PermissionRequestResult> | PermissionRequestResult;
+/** The envelope every session event comes in. */
+export interface SessionEvent<T extends string, D> {
+    readonly type: T;
+    readonly data: D;
+}
+/** The session events this integration listens to, keyed by their type discriminator. */
+export interface CopilotSessionEvents {
+    'assistant.message_delta': SessionEvent<'assistant.message_delta', {
+        readonly deltaContent: string;
+    }>;
+    'assistant.reasoning_delta': SessionEvent<'assistant.reasoning_delta', {
+        readonly deltaContent: string;
+    }>;
+    'assistant.message': SessionEvent<'assistant.message', {
+        readonly content: string;
+        readonly outputTokens?: number;
+    }>;
+    'assistant.usage': SessionEvent<'assistant.usage', {
+        readonly inputTokens?: number;
+        readonly outputTokens?: number;
+    }>;
+    /** Nothing of its payload is read, the event itself is the signal that the turn is over. */
+    'session.idle': SessionEvent<'session.idle', unknown>;
+    'session.error': SessionEvent<'session.error', {
+        readonly errorType: string;
+        readonly message: string;
+        readonly statusCode?: number;
+        readonly stack?: string;
+    }>;
+}
+export type CopilotSessionEventType = keyof CopilotSessionEvents;
+/** A conversation with the runtime, upstream a class with resume, fork and sharing on top. */
+export interface CopilotSession {
+    readonly sessionId: string;
+    /**
+     * Registers a handler for one type of event and returns the function that removes it again.
+     */
+    on<K extends CopilotSessionEventType>(eventType: K, handler: (event: CopilotSessionEvents[K]) => void): () => void;
+    /** Sends a turn and resolves with the id of the message it created. */
+    send(options: {
+        prompt: string;
+    }): Promise<string>;
+    /** Stops the turn in flight. */
+    abort(): Promise<void>;
+    /** Releases the session in memory, leaving what it persisted in place. */
+    disconnect(): Promise<void>;
+}
+/** How the SDK reaches the runtime. This integration always spawns the CLI it located. */
+export interface StdioRuntimeConnection {
+    readonly kind: 'stdio';
+    readonly path?: string;
+    readonly args?: readonly string[];
+    readonly env?: Record<string, string>;
+}
+export type RuntimeConnection = StdioRuntimeConnection;
+/** The `RuntimeConnection` value of the SDK, of which only the stdio factory is used. */
+export interface RuntimeConnectionFactory {
+    readonly forStdio: (options?: {
+        path?: string;
+        args?: readonly string[];
+        env?: Record<string, string>;
+    }) => StdioRuntimeConnection;
+}
+/**
+ * Selects the defaults of the runtime: `copilot-cli` brings the ambient behaviour of the CLI along,
+ * `empty` requires the application to opt into what it needs.
+ */
+export type CopilotClientMode = 'empty' | 'copilot-cli';
+/** The client options this integration sets. */
+export interface CopilotClientOptions {
+    connection?: RuntimeConnection;
+    mode?: CopilotClientMode;
+    /** Copilot home of the runtime, which becomes its `COPILOT_HOME`. Required in `empty` mode. */
+    baseDirectory?: string;
+    logLevel?: 'none' | 'error' | 'warning' | 'info' | 'debug' | 'all';
+    env?: Record<string, string | undefined>;
+    gitHubToken?: string;
+    /** When false, only an explicit token is used and no sign-in found on the host. */
+    useLoggedInUser?: boolean;
+}
+/** The session configuration this integration passes. */
+export interface SessionConfig {
+    model?: string;
+    streaming?: boolean;
+    tools?: Tool[];
+    systemMessage?: SystemMessageConfig;
+    /**
+     * The tools to enable, as source-qualified patterns such as `custom:*` or `builtin:<name>`.
+     * Required in `empty` mode.
+     */
+    availableTools?: string[];
+    onPermissionRequest?: PermissionHandler;
+}
+/** The runtime as seen by this integration, upstream a class with the full session and status API. */
+export interface CopilotClient {
+    /** Starts the runtime and connects to it. */
+    start(): Promise<void>;
+    /** Stops the runtime and resolves with the errors its cleanup ran into, if any. */
+    stop(): Promise<Error[]>;
+    listModels(): Promise<ModelInfo[]>;
+    createSession(config: SessionConfig): Promise<CopilotSession>;
+    /** Removes a session and what it persisted in the Copilot home. */
+    deleteSession(sessionId: string): Promise<void>;
+}
+export type CopilotClientConstructor = new (options?: CopilotClientOptions) => CopilotClient;
+//# sourceMappingURL=copilot-sdk-types.d.ts.map

package/lib/node/copilot-sdk-types.d.ts.map

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

package/lib/{common/copilot-oauth-config.js → node/copilot-sdk-types.js}

@@ -1,6 +1,6 @@
 "use strict";
 // *****************************************************************************
-// Copyright (C) 2026 Lonti.com Pty Ltd.
+// 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
@@ -15,15 +15,4 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_COPILOT_OAUTH_CONFIG = exports.CopilotOAuthConfig = void 0;
-exports.CopilotOAuthConfig = Symbol('CopilotOAuthConfig');
-/**
- * Default OAuth configuration for the built-in Theia Copilot integration.
- */
-exports.DEFAULT_COPILOT_OAUTH_CONFIG = {
-    clientId: 'Ov23liS2vINy9VOAweyv',
-    userAgent: 'Theia-Copilot/1.0.0',
-    keystoreService: 'theia-copilot-auth',
-    keystoreAccount: 'github-copilot'
-};
-//# sourceMappingURL=copilot-oauth-config.js.map
+//# sourceMappingURL=copilot-sdk-types.js.map

package/lib/node/copilot-sdk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sdk-types.js","sourceRoot":"","sources":["../../src/node/copilot-sdk-types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,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"}

package/lib/node/index.d.ts

@@ -1,4 +1,12 @@
 export * from './copilot-auth-service-impl';
-export * from './copilot-language-model';
 export * from './copilot-language-models-manager-impl';
+export * from './copilot-cli-auth-provider';
+export * from './copilot-cli-locator';
+export * from './copilot-credential-store';
+export * from './copilot-runtime-env';
+export * from './copilot-sdk-client-provider';
+export * from './copilot-sdk-loader';
+export * from './copilot-sdk-mappers';
+export * from './copilot-sdk-language-model';
+export * from './copilot-sdk-types';
 //# 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,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC"}

package/lib/node/index.js

@@ -17,6 +17,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./copilot-auth-service-impl"), exports);
-tslib_1.__exportStar(require("./copilot-language-model"), exports);
 tslib_1.__exportStar(require("./copilot-language-models-manager-impl"), exports);
+tslib_1.__exportStar(require("./copilot-cli-auth-provider"), exports);
+tslib_1.__exportStar(require("./copilot-cli-locator"), exports);
+tslib_1.__exportStar(require("./copilot-credential-store"), exports);
+tslib_1.__exportStar(require("./copilot-runtime-env"), exports);
+tslib_1.__exportStar(require("./copilot-sdk-client-provider"), exports);
+tslib_1.__exportStar(require("./copilot-sdk-loader"), exports);
+tslib_1.__exportStar(require("./copilot-sdk-mappers"), exports);
+tslib_1.__exportStar(require("./copilot-sdk-language-model"), exports);
+tslib_1.__exportStar(require("./copilot-sdk-types"), 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,sEAA4C;AAC5C,mEAAyC;AACzC,iFAAuD"}
+{"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,sEAA4C;AAC5C,iFAAuD;AACvD,sEAA4C;AAC5C,gEAAsC;AACtC,qEAA2C;AAC3C,gEAAsC;AACtC,wEAA8C;AAC9C,+DAAqC;AACrC,gEAAsC;AACtC,uEAA6C;AAC7C,8DAAoC"}

package/package.json

@@ -1,12 +1,10 @@
 {
   "name": "@theia/ai-copilot",
-  "version": "1.75.0",
+  "version": "1.76.0-next.10+c8926e4df",
   "description": "Theia - GitHub Copilot Integration",
   "dependencies": {
-    "@theia/ai-core": "1.75.0",
-    "@theia/ai-openai": "1.75.0",
-    "@theia/core": "1.75.0",
-    "openai": "^6.49.0",
+    "@theia/ai-core": "1.76.0-next.10+c8926e4df",
+    "@theia/core": "1.76.0-next.10+c8926e4df",
     "tslib": "^2.8.1"
   },
   "publishConfig": {
@@ -48,5 +46,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "6d8e911f05f0fd9a13d76797e79b21ee3f038bc2"
+  "gitHead": "c8926e4df55986ad77d1f24c297873f1656fc9cb"
 }

package/src/browser/copilot-auth-dialog.tsx

@@ -89,7 +89,12 @@ export class CopilotAuthDialog extends ReactDialog<boolean> {
 
     override async open(): Promise<boolean | undefined> {
         this.initiateFlow();
-        return super.open();
+        const result = await super.open();
+        if (this.state !== 'success') {
+            // Leave no Copilot CLI process behind when the dialog is dismissed or retried.
+            await this.authService.cancelSignIn();
+        }
+        return result;
     }
 
     override update(): void {
@@ -102,7 +107,7 @@ export class CopilotAuthDialog extends ReactDialog<boolean> {
             this.state = 'loading';
             this.update();
 
-            this.deviceCodeResponse = await this.authService.initiateDeviceFlow(this.props.enterpriseUrl);
+            this.deviceCodeResponse = await this.authService.startSignIn(this.props.enterpriseUrl);
             this.state = 'waiting';
             this.update();
         } catch (error) {
@@ -121,11 +126,7 @@ export class CopilotAuthDialog extends ReactDialog<boolean> {
         this.update();
 
         try {
-            const success = await this.authService.pollForToken(
-                this.deviceCodeResponse.device_code,
-                this.deviceCodeResponse.interval,
-                this.props.enterpriseUrl
-            );
+            const success = await this.authService.waitForSignIn();
 
             if (success) {
                 this.state = 'success';
@@ -149,7 +150,10 @@ export class CopilotAuthDialog extends ReactDialog<boolean> {
 
     protected override isValid(_value: boolean, _mode: DialogError): DialogError {
         if (this.state === 'error') {
-            return this.errorMessage ?? 'An error occurred';
+            // The error is shown in the dialog body by renderError, where it can wrap. Returning only a
+            // failed result keeps the accept button disabled without repeating the (often long) message
+            // next to it, where it does not fit.
+            return { result: false, message: '' };
         }
         return '';
     }

package/src/browser/copilot-frontend-application-contribution.ts

@@ -19,7 +19,7 @@ import { CommandService, nls, PreferenceService } from '@theia/core';
 import { FrontendApplicationContribution } from '@theia/core/lib/browser';
 import { MessageService } from '@theia/core/lib/common/message-service';
 import { CopilotAuthService, CopilotLanguageModelsManager, CopilotModelDescription, COPILOT_PROVIDER_ID } from '../common';
-import { COPILOT_ENABLED_PREF, COPILOT_MODEL_OVERRIDES_PREF, COPILOT_ENTERPRISE_URL_PREF } from '../common/copilot-preferences';
+import { COPILOT_ENABLED_PREF, COPILOT_ENTERPRISE_URL_PREF, COPILOT_EXECUTABLE_PATH_PREF, COPILOT_MODEL_OVERRIDES_PREF } from '../common/copilot-preferences';
 import { AICorePreferences, PREFERENCE_NAME_MAX_RETRIES } from '@theia/ai-core/lib/common/ai-core-preferences';
 import { CopilotCommands } from './copilot-command-contribution';
 
@@ -49,24 +49,34 @@ export class CopilotFrontendApplicationContribution implements FrontendApplicati
 
     onStart(): void {
         this.preferenceService.ready.then(async () => {
-            const enterpriseUrl = this.preferenceService.get<string>(COPILOT_ENTERPRISE_URL_PREF);
-            this.manager.setEnterpriseUrl(enterpriseUrl || undefined);
-
+            // Before anything reaches for the CLI: the backend cannot read the preferences itself.
+            await this.updateExecutablePath();
             if (this.isCopilotEnabled()) {
                 const authState = await this.authService.getAuthState();
                 if (authState.migrationRequired) {
-                    this.notifyTokenMigration();
+                    this.notifySignInRequired();
                 }
                 await this.initializeModels();
             }
 
             this.preferenceService.onPreferenceChanged(event => {
-                if (event.preferenceName === COPILOT_ENABLED_PREF) {
+                if (event.preferenceName === COPILOT_EXECUTABLE_PATH_PREF) {
+                    this.updateExecutablePath().then(() => {
+                        if (this.isCopilotEnabled() && this.useAutoDiscovery) {
+                            // A CLI that could not be found before may be reachable now.
+                            this.discoverAndRegisterModels();
+                        }
+                    });
+                } else if (event.preferenceName === COPILOT_ENABLED_PREF) {
                     if (this.isCopilotEnabled()) {
                         this.initializeModels();
                     } else {
                         this.removeAllCopilotModels();
                     }
+                } else if (event.preferenceName === COPILOT_ENTERPRISE_URL_PREF) {
+                    // The domain is only read at sign-in time, so a change while signed in has no effect
+                    // until the next sign-in. Let the user know instead of silently ignoring it.
+                    this.notifyEnterpriseUrlChanged();
                 } else if (event.preferenceName === COPILOT_MODEL_OVERRIDES_PREF && this.isCopilotEnabled()) {
                     const newModels = this.preferenceService.get<string[]>(COPILOT_MODEL_OVERRIDES_PREF, []);
                     if (newModels.length > 0) {
@@ -77,15 +87,6 @@ export class CopilotFrontendApplicationContribution implements FrontendApplicati
                         this.removeAllCopilotModels();
                         this.discoverAndRegisterModels();
                     }
-                } else if (event.preferenceName === COPILOT_ENTERPRISE_URL_PREF && this.isCopilotEnabled()) {
-                    const url = this.preferenceService.get<string>(COPILOT_ENTERPRISE_URL_PREF);
-                    this.manager.setEnterpriseUrl(url || undefined);
-                    if (this.useAutoDiscovery) {
-                        this.removeAllCopilotModels();
-                        this.discoverAndRegisterModels();
-                    } else {
-                        this.manager.refreshModelsStatus();
-                    }
                 }
             });
 
@@ -111,6 +112,52 @@ export class CopilotFrontendApplicationContribution implements FrontendApplicati
         return this.preferenceService.get<boolean>(COPILOT_ENABLED_PREF, true);
     }
 
+    /**
+     * Hands the configured location of the Copilot CLI to the backend, which searches for it when
+     * none is configured.
+     */
+    protected async updateExecutablePath(): Promise<void> {
+        const executablePath = this.preferenceService.get<string>(COPILOT_EXECUTABLE_PATH_PREF, '').trim();
+        await this.authService.setExecutablePath(executablePath || undefined);
+    }
+
+    /**
+     * Tells the user why they are signed out after an update, since the sign-in of the previous
+     * version cannot be carried over: it belonged to an OAuth application that is no longer used.
+     */
+    protected async notifySignInRequired(): Promise<void> {
+        const signIn = nls.localize('theia/ai/copilot/commands/signIn', 'Sign in to GitHub Copilot');
+        const action = await this.messageService.info(
+            nls.localize('theia/ai/copilot/signInAgain',
+                'GitHub Copilot now signs in through the GitHub Copilot CLI. Your previous sign-in could not be carried over and has been '
+                + 'removed, please sign in again to use Copilot models.'),
+            signIn
+        );
+        if (action === signIn) {
+            this.commandService.executeCommand(CopilotCommands.SIGN_IN.id);
+        }
+    }
+
+    /**
+     * Tells the user that a changed GitHub Copilot domain only takes effect on the next sign-in, since
+     * the domain is read when signing in and not while a session is already established.
+     */
+    protected async notifyEnterpriseUrlChanged(): Promise<void> {
+        const authState = await this.authService.getAuthState();
+        if (!authState.isAuthenticated) {
+            return;
+        }
+        const signIn = nls.localize('theia/ai/copilot/commands/signIn', 'Sign in to GitHub Copilot');
+        const action = await this.messageService.info(
+            nls.localize('theia/ai/copilot/enterpriseUrlChanged',
+                'The GitHub Copilot domain changed. Sign in again for it to take effect.'),
+            signIn
+        );
+        if (action === signIn) {
+            this.commandService.executeCommand(CopilotCommands.SIGN_IN.id);
+        }
+    }
+
     protected async initializeModels(): Promise<void> {
         const configuredModels = this.preferenceService.get<string[]>(COPILOT_MODEL_OVERRIDES_PREF, []);
         if (configuredModels.length > 0) {
@@ -171,18 +218,6 @@ export class CopilotFrontendApplicationContribution implements FrontendApplicati
         this.manager.createOrUpdateLanguageModels(...models.map((modelId: string) => this.createCopilotModelDescription(modelId)));
     }
 
-    protected async notifyTokenMigration(): Promise<void> {
-        const signIn = nls.localize('theia/ai/copilot/commands/signIn', 'Sign in to GitHub Copilot');
-        const action = await this.messageService.info(
-            nls.localize('theia/ai/copilot/tokenMigration',
-                'Your GitHub Copilot session used an outdated authentication method and has been cleared. Please sign in again to access all available models.'),
-            signIn
-        );
-        if (action === signIn) {
-            this.commandService.executeCommand(CopilotCommands.SIGN_IN.id);
-        }
-    }
-
     protected createCopilotModelDescription(modelId: string): CopilotModelDescription {
         const id = `${COPILOT_PROVIDER_ID}/${modelId}`;
         const maxRetries = this.aiCorePreferences.get(PREFERENCE_NAME_MAX_RETRIES) ?? 3;
@@ -190,8 +225,6 @@ export class CopilotFrontendApplicationContribution implements FrontendApplicati
         return {
             id,
             model: modelId,
-            enableStreaming: true,
-            supportsStructuredOutput: true,
             maxRetries
         };
     }