@theia/plugin 1.65.0-next.55 → 1.65.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.65.0-next.55+d141c3601",
+  "version": "1.65.0",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -27,10 +27,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.64.0"
+    "@theia/ext-scripts": "1.65.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "d141c3601e8c3d9cd254468790fed3566aa23305"
+  "gitHead": "500dfc80cee94fd2a623b5fb59b22d5a575247c2"
 }

package/src/theia.d.ts

@@ -40,10 +40,12 @@ import './theia.proposed.notebookMessaging';
 import './theia.proposed.portsAttributes';
 import './theia.proposed.profileContentHandlers';
 import './theia.proposed.resolvers';
+import './theia.proposed.scmProviderOptions';
 import './theia.proposed.scmValidation';
 import './theia.proposed.shareProvider';
 import './theia.proposed.terminalCompletionProvider';
 import './theia.proposed.terminalQuickFixProvider';
+import './theia.proposed.textEditorDiffInformation';
 import './theia.proposed.textSearchProvider';
 import './theia.proposed.timeline';
 
@@ -3597,6 +3599,20 @@ export module '@theia/plugin' {
          * recommended for the best contrast and consistency across themes.
          */
         color?: ThemeColor;
+
+        /**
+         * The nonce to use to verify shell integration sequences are coming from a trusted source.
+         * An example impact of UX of this is if the command line is reported with a nonce, it will
+         * not need to verify with the user that the command line is correct before rerunning it
+         * via the [shell integration command decoration](https://code.visualstudio.com/docs/terminal/shell-integration#_command-decorations-and-the-overview-ruler).
+         *
+         * This should be used if the terminal includes [custom shell integration support](https://code.visualstudio.com/docs/terminal/shell-integration#_supported-escape-sequences).
+         * It should be set to a random GUID which will then set the `VSCODE_NONCE` environment
+         * variable. Inside the shell, this should then be removed from the environment so as to
+         * protect it from general access. Once that is done it can be passed through in the
+         * relevant sequences to make them trusted.
+         */
+        shellIntegrationNonce?: string;
     }
 
     /**
@@ -3718,6 +3734,18 @@ export module '@theia/plugin' {
          * @stubbed
          */
         color?: ThemeColor;
+
+        /**
+         * The nonce to use to verify shell integration sequences are coming from a trusted source.
+         * An example impact of UX of this is if the command line is reported with a nonce, it will
+         * not need to verify with the user that the command line is correct before rerunning it
+         * via the [shell integration command decoration](https://code.visualstudio.com/docs/terminal/shell-integration#_command-decorations-and-the-overview-ruler).
+         *
+         * This should be used if the terminal includes [custom shell integration support](https://code.visualstudio.com/docs/terminal/shell-integration#_supported-escape-sequences).
+         * It should be set to a random GUID. Inside the {@link Pseudoterminal} implementation, this value
+         * can be passed through in the relevant sequences to make them trusted.
+         */
+        shellIntegrationNonce?: string;
     }
 
     /**
@@ -12093,12 +12121,12 @@ export module '@theia/plugin' {
      */
     export class EvaluatableExpression {
 
-        /*
+        /**
          * The range is used to extract the evaluatable expression from the underlying document and to highlight it.
          */
         readonly range: Range;
 
-        /*
+        /**
          * If specified the expression overrides the extracted expression.
          */
         readonly expression?: string | undefined;
@@ -17812,7 +17840,7 @@ export module '@theia/plugin' {
          * Creates a {@link FileCoverage} instance with counts filled in from
          * the coverage details.
          * @param uri Covered file URI
-         * @param detailed Detailed coverage information
+         * @param details Detailed coverage information
          */
         static fromDetails(uri: Uri, details: readonly FileCoverageDetail[]): FileCoverage;
 
@@ -18593,7 +18621,7 @@ export module '@theia/plugin' {
          * specific for some models.
          * @stubbed
          */
-        content: Array<(LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelToolCallPart)>;
+        content: Array<LanguageModelInputPart>;
 
         /**
          * The optional name of a user for this message.
@@ -18609,9 +18637,21 @@ export module '@theia/plugin' {
          * @param content The content of the message.
          * @param name The optional name of a user for the message.
          */
-        constructor(role: LanguageModelChatMessageRole, content: string | Array<LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelToolCallPart>, name?: string);
+        constructor(role: LanguageModelChatMessageRole, content: string | Array<LanguageModelInputPart>, name?: string);
     }
 
+    /**
+     * The various message types which a {@linkcode LanguageModelChatProvider} can emit in the chat response stream
+     * @stubbed
+     */
+    export type LanguageModelResponsePart = LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelToolCallPart;
+
+    /**
+     * The various message types which can be sent via {@linkcode LanguageModelChat.sendRequest } and processed by a {@linkcode LanguageModelChatProvider}
+     * @stubbed
+     */
+    export type LanguageModelInputPart = LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelToolCallPart;
+
     /**
      * Represents a language model response.
      *
@@ -19000,6 +19040,202 @@ export module '@theia/plugin' {
          */
         resolveMcpServerDefinition?(server: T, token: CancellationToken): ProviderResult<T>;
     }
+
+    /**
+     * The provider version of {@linkcode LanguageModelChatRequestOptions}
+     * @stubbed
+     */
+    export interface ProvideLanguageModelChatResponseOptions {
+        /**
+         * A set of options that control the behavior of the language model. These options are specific to the language model.
+         * @stubbed
+         */
+        readonly modelOptions?: { readonly [name: string]: any };
+
+        /**
+         * An optional list of tools that are available to the language model. These could be registered tools available via
+         * {@link lm.tools}, or private tools that are just implemented within the calling extension.
+         *
+         * If the LLM requests to call one of these tools, it will return a {@link LanguageModelToolCallPart} in
+         * {@link LanguageModelChatResponse.stream}. It's the caller's responsibility to invoke the tool. If it's a tool
+         * registered in {@link lm.tools}, that means calling {@link lm.invokeTool}.
+         *
+         * Then, the tool result can be provided to the LLM by creating an Assistant-type {@link LanguageModelChatMessage} with a
+         * {@link LanguageModelToolCallPart}, followed by a User-type message with a {@link LanguageModelToolResultPart}.
+         * @stubbed
+         */
+        readonly tools?: readonly LanguageModelChatTool[];
+
+        /**
+         * The tool-selecting mode to use. The provider must implement respecting this.
+         * @stubbed
+         */
+        readonly toolMode: LanguageModelChatToolMode;
+    }
+
+    /**
+     * Represents a language model provided by a {@linkcode LanguageModelChatProvider}.
+     * @stubbed
+     */
+    export interface LanguageModelChatInformation {
+
+        /**
+         * Unique identifier for the language model. Must be unique per provider, but not required to be globally unique.
+         * @stubbed
+         */
+        readonly id: string;
+
+        /**
+         * Human-readable name of the language model.
+         * @stubbed
+         */
+        readonly name: string;
+
+        /**
+         * Opaque family-name of the language model. Values might be `gpt-3.5-turbo`, `gpt4`, `phi2`, or `llama`
+         * @stubbed
+         */
+        readonly family: string;
+
+        /**
+         * The tooltip to render when hovering the model. Used to provide more information about the model.
+         * @stubbed
+         */
+        readonly tooltip?: string;
+
+        /**
+         * An optional, human-readable string which will be rendered alongside the model.
+         * Useful for distinguishing models of the same name in the UI.
+         * @stubbed
+         */
+        readonly detail?: string;
+
+        /**
+         * Opaque version string of the model.
+         * This is used as a lookup value in {@linkcode LanguageModelChatSelector.version}
+         * An example is how GPT 4o has multiple versions like 2024-11-20 and 2024-08-06
+         * @stubbed
+         */
+        readonly version: string;
+
+        /**
+         * The maximum number of tokens the model can accept as input.
+         * @stubbed
+         */
+        readonly maxInputTokens: number;
+
+        /**
+         * The maximum number of tokens the model is capable of producing.
+         * @stubbed
+         */
+        readonly maxOutputTokens: number;
+
+        /**
+         * Various features that the model supports such as tool calling or image input.
+         * @stubbed
+         */
+        readonly capabilities: {
+
+            /**
+             * Whether image input is supported by the model.
+             * Common supported images are jpg and png, but each model will vary in supported mimetypes.
+             * @stubbed
+             */
+            readonly imageInput?: boolean;
+
+            /**
+             * Whether tool calling is supported by the model.
+             * If a number is provided, that is the maximum number of tools that can be provided in a request to the model.
+             * @stubbed
+             */
+            readonly toolCalling?: boolean | number;
+        };
+    }
+
+    /**
+     * The provider version of {@linkcode LanguageModelChatMessage}.
+     * @stubbed
+     */
+    export interface LanguageModelChatRequestMessage {
+        /**
+         * The role of this message.
+         * @stubbed
+         */
+        readonly role: LanguageModelChatMessageRole;
+
+        /**
+         * A heterogeneous array of things that a message can contain as content. Some parts may be message-type
+         * specific for some models.
+         * @stubbed
+         */
+        readonly content: ReadonlyArray<LanguageModelInputPart | unknown>;
+
+        /**
+         * The optional name of a user for this message.
+         * @stubbed
+         */
+        readonly name: string | undefined;
+    }
+
+    /**
+     * A LanguageModelChatProvider implements access to language models, which users can then use through the chat view, or through extension API by acquiring a LanguageModelChat.
+     * An example of this would be an OpenAI provider that provides models like gpt-5, o3, etc.
+     * @stubbed
+     */
+    export interface LanguageModelChatProvider<T extends LanguageModelChatInformation = LanguageModelChatInformation> {
+
+        /**
+         * An optional event fired when the available set of language models changes.
+         * @stubbed
+         */
+        readonly onDidChangeLanguageModelChatInformation?: Event<void>;
+
+        /**
+         * Get the list of available language models provided by this provider
+         * @param options Options which specify the calling context of this function
+         * @param token A cancellation token
+         * @returns The list of available language models
+         * @stubbed
+         */
+        provideLanguageModelChatInformation(options: PrepareLanguageModelChatModelOptions, token: CancellationToken): ProviderResult<T[]>;
+
+        /**
+         * Returns the response for a chat request, passing the results to the progress callback.
+         * The {@linkcode LanguageModelChatProvider} must emit the response parts to the progress callback as they are received from the language model.
+         * @param model The language model to use
+         * @param messages The messages to include in the request
+         * @param options Options for the request
+         * @param progress The progress to emit the streamed response chunks to
+         * @param token A cancellation token
+         * @returns A promise that resolves when the response is complete. Results are actually passed to the progress callback.
+         * @stubbed
+         */
+        provideLanguageModelChatResponse(model: T, messages: readonly LanguageModelChatRequestMessage[], options: ProvideLanguageModelChatResponseOptions, progress: Progress<LanguageModelResponsePart>, token: CancellationToken): Thenable<void>;
+
+        /**
+         * Returns the number of tokens for a given text using the model-specific tokenizer logic
+         * @param model The language model to use
+         * @param text The text to count tokens for
+         * @param token A cancellation token
+         * @returns The number of tokens
+         * @stubbed
+         */
+        provideTokenCount(model: T, text: string | LanguageModelChatRequestMessage, token: CancellationToken): Thenable<number>;
+    }
+
+    /**
+     * The list of options passed into {@linkcode LanguageModelChatProvider.provideLanguageModelChatInformation}
+     * @stubbed
+     */
+    export interface PrepareLanguageModelChatModelOptions {
+        /**
+         * Whether or not the user should be prompted via some UI flow, or if models should be attempted to be resolved silently.
+         * If silent is true, all models may not be resolved due to lack of info such as API keys.
+         * @stubbed
+         */
+        readonly silent: boolean;
+    }
+
     /**
      * Namespace for language model related functionality.
      */
@@ -19063,7 +19299,7 @@ export module '@theia/plugin' {
          * any custom flow.
          *
          * In the former case, the caller shall pass the
-         * {@link LanguageModelToolInvocationOptions.toolInvocationToken toolInvocationToken}, which comes with the a
+         * {@link LanguageModelToolInvocationOptions.toolInvocationToken toolInvocationToken}, which comes from a
          * {@link ChatRequest.toolInvocationToken chat request}. This makes sure the chat UI shows the tool invocation for the
          * correct conversation.
          *
@@ -19111,6 +19347,16 @@ export module '@theia/plugin' {
          * @returns A disposable that unregisters the provider when disposed.
          */
         export function registerMcpServerDefinitionProvider(id: string, provider: McpServerDefinitionProvider): Disposable;
+
+        /**
+         * Registers a {@linkcode LanguageModelChatProvider}
+         * Note: You must also define the language model chat provider via the `languageModelChatProviders` contribution point in package.json
+         * @param vendor The vendor for this provider. Must be globally unique. An example is `copilot` or `openai`.
+         * @param provider The provider to register
+         * @returns A disposable that unregisters the provider when disposed
+         * @stubbed
+         */
+        export function registerLanguageModelChatProvider(vendor: string, provider: LanguageModelChatProvider): Disposable;
     }
 
     /**
@@ -19276,7 +19522,7 @@ export module '@theia/plugin' {
 
         /**
          * Construct a prompt-tsx part with the given content.
-         * @param value The value of the part, the result of `renderPromptElementJSON` from `@vscode/prompt-tsx`.
+         * @param value The value of the part, the result of `renderElementJSON` from `@vscode/prompt-tsx`.
          * @stubbed
          */
         constructor(value: unknown);

package/src/theia.proposed.scmProviderOptions.d.ts

@@ -0,0 +1,56 @@
+// *****************************************************************************
+// Copyright (C) 2025 STMicroelectronics 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
+// *****************************************************************************
+
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// code copied and modified from https://github.com/microsoft/vscode/blob/1.103.2/src/vscode-dts/vscode.proposed.scmProviderOptions.d.ts
+
+declare module '@theia/plugin' {
+    // https://github.com/microsoft/vscode/issues/254910
+
+    export interface SourceControl {
+        /**
+         * Context value of the source control. This can be used to contribute source control specific actions.
+         * For example, if a source control is given a context value of `repository`, when contributing actions to `scm/sourceControl/context`
+         * using `menus` extension point, you can specify context value for key `scmProviderContext` in `when` expressions, like `scmProviderContext == repository`.
+         * ```json
+         * "contributes": {
+         *   "menus": {
+         *     "scm/sourceControl/context": [
+         *       {
+         *         "command": "extension.gitAction",
+         *         "when": "scmProviderContext == repository"
+         *       }
+         *     ]
+         *   }
+         * }
+         * ```
+         * This will show action `extension.gitAction` only for source controls with `contextValue` equal to `repository`.
+         */
+        contextValue?: string;
+
+        /**
+         * Fired when the parent source control is disposed.
+         */
+        readonly onDidDisposeParent: Event<void>;
+    }
+
+    export namespace scm {
+        export function createSourceControl(id: string, label: string, rootUri?: Uri, iconPath?: IconPath, parent?: SourceControl): SourceControl;
+    }
+}

package/src/theia.proposed.terminalCompletionProvider.d.ts

@@ -69,9 +69,21 @@ declare module '@theia/plugin' {
     export enum TerminalCompletionItemKind {
         File = 0,
         Folder = 1,
-        Flag = 2,
-        Method = 3,
-        Argument = 4
+        Method = 2,
+        Alias = 3,
+        Argument = 4,
+        Option = 5,
+        OptionValue = 6,
+        Flag = 7,
+        SymbolicLinkFile = 8,
+        SymbolicLinkFolder = 9,
+        Commit = 10,
+        Branch = 11,
+        Tag = 12,
+        Stash = 13,
+        Remote = 14,
+        PullRequest = 15,
+        PullRequestDone = 16,
     }
 
     export interface TerminalCompletionContext {

package/src/theia.proposed.textEditorDiffInformation.d.ts

@@ -0,0 +1,64 @@
+// *****************************************************************************
+// Copyright (C) 2025 STMicroelectronics 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
+// *****************************************************************************
+
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// code copied and modified from https://github.com/microsoft/vscode/blob/1.103.2/src/vscode-dts/vscode.proposed.textEditorDiffInformation.d.ts
+
+declare module '@theia/plugin' {
+    // https://github.com/microsoft/vscode/issues/84899
+
+    export enum TextEditorChangeKind {
+        Addition = 1,
+        Deletion = 2,
+        Modification = 3
+    }
+
+    export interface TextEditorLineRange {
+        readonly startLineNumber: number;
+        readonly endLineNumberExclusive: number;
+    }
+
+    export interface TextEditorChange {
+        readonly original: TextEditorLineRange;
+        readonly modified: TextEditorLineRange;
+        readonly kind: TextEditorChangeKind;
+    }
+
+    export interface TextEditorDiffInformation {
+        readonly documentVersion: number;
+        readonly original: Uri | undefined;
+        readonly modified: Uri;
+        readonly changes: readonly TextEditorChange[];
+        readonly isStale: boolean;
+    }
+
+    export interface TextEditorDiffInformationChangeEvent {
+        readonly textEditor: TextEditor;
+        readonly diffInformation: TextEditorDiffInformation[] | undefined;
+    }
+
+    export interface TextEditor {
+        readonly diffInformation: TextEditorDiffInformation[] | undefined;
+    }
+
+    export namespace window {
+        export const onDidChangeTextEditorDiffInformation: Event<TextEditorDiffInformationChangeEvent>;
+    }
+
+}