@codingame/monaco-vscode-api 22.1.9 → 23.0.0

package/vscode-dts/vscode.proposed.dataChannels.d.ts

@@ -10,7 +10,7 @@ declare module 'vscode' {
 	}
 
 	export interface DataChannel<T = unknown> {
-		onDidReceiveData: Event<DataChannelEvent<T>>;
+		readonly onDidReceiveData: Event<DataChannelEvent<T>>;
 	}
 
 	export interface DataChannelEvent<T> {

package/vscode-dts/vscode.proposed.inlineCompletionsAdditions.d.ts

@@ -32,23 +32,8 @@ declare module 'vscode' {
 		export const onDidChangeCompletionsUnificationState: Event<void>;
 	}
 
-	/**
-	 * temporary: to be removed
-	 */
-	export interface InlineCompletionsUnificationState {
-		codeUnification: boolean;
-		modelUnification: boolean;
-		expAssignments: string[];
-	}
-
 	export interface InlineCompletionItem {
-		/**
-		 * If set to `true`, unopened closing brackets are removed and unclosed opening brackets are closed.
-		 * Defaults to `false`.
-		*/
-		completeBracketPairs?: boolean;
-
-		warning?: InlineCompletionWarning;
+		// insertText: string | SnippetString | undefined;
 
 		/** If set to `true`, this item is treated as inline edit. */
 		isInlineEdit?: boolean;
@@ -61,23 +46,39 @@ declare module 'vscode' {
 
 		showInlineEditMenu?: boolean;
 
+		/**
+		 * If set, specifies where insertText, filterText and range apply to.
+		*/
+		uri?: Uri;
+
+		// TODO: rename to gutterMenuLinkAction
 		action?: Command;
 
 		displayLocation?: InlineCompletionDisplayLocation;
 
 		/** Used for telemetry. Can be an arbitrary string. */
 		correlationId?: string;
-	}
 
-	export enum InlineCompletionDisplayLocationKind {
-		Code = 1,
-		Label = 2
+		/**
+		 * If set to `true`, unopened closing brackets are removed and unclosed opening brackets are closed.
+		 * Defaults to `false`.
+		*/
+		completeBracketPairs?: boolean;
+
+		warning?: InlineCompletionWarning;
 	}
 
+
 	export interface InlineCompletionDisplayLocation {
 		range: Range;
 		kind: InlineCompletionDisplayLocationKind;
 		label: string;
+		jumpToEdit?: boolean;
+	}
+
+	export enum InlineCompletionDisplayLocationKind {
+		Code = 1,
+		Label = 2
 	}
 
 	export interface InlineCompletionWarning {
@@ -131,7 +132,7 @@ declare module 'vscode' {
 		// eslint-disable-next-line local/vscode-dts-provider-naming
 		handleListEndOfLifetime?(list: InlineCompletionList, reason: InlineCompletionsDisposeReason): void;
 
-		onDidChange?: Event<void>;
+		readonly onDidChange?: Event<void>;
 
 		// #region Deprecated methods
 
@@ -217,4 +218,14 @@ declare module 'vscode' {
 		 */
 		enableForwardStability?: boolean;
 	}
+
+	/**
+	 * temporary: to be removed
+	 */
+	export interface InlineCompletionsUnificationState {
+		codeUnification: boolean;
+		modelUnification: boolean;
+		extensionUnification: boolean;
+		expAssignments: string[];
+	}
 }

package/vscode-dts/vscode.proposed.languageModelProxy.d.ts

@@ -0,0 +1,31 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+	export interface LanguageModelProxy extends Disposable {
+		readonly uri: Uri;
+		readonly key: string;
+	}
+
+	export namespace lm {
+		/**
+		 * Returns false if
+		 * - Copilot Chat extension is not installed
+		 * - Copilot Chat has not finished activating or finished auth
+		 * - The user is not logged in, or isn't the right SKU, with expected model access
+		 */
+		export const isModelProxyAvailable: boolean;
+
+		/**
+		 * Fired when isModelProxyAvailable changes.
+		 */
+		export const onDidChangeModelProxyAvailability: Event<void>;
+
+		/**
+		 * Throws if the server fails to start for some reason, or something else goes wrong.
+		 */
+		export function getModelProxy(): Thenable<LanguageModelProxy>;
+	}
+}

package/vscode-dts/vscode.proposed.languageModelThinkingPart.d.ts

@@ -46,4 +46,66 @@ declare module 'vscode' {
 		 */
 		stream: AsyncIterable<LanguageModelTextPart | LanguageModelThinkingPart | LanguageModelToolCallPart | unknown>;
 	}
+
+	export interface LanguageModelChat {
+		sendRequest(messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options?: LanguageModelChatRequestOptions, token?: CancellationToken): Thenable<LanguageModelChatResponse>;
+		countTokens(text: string | LanguageModelChatMessage | LanguageModelChatMessage2, token?: CancellationToken): Thenable<number>;
+	}
+
+	/**
+	 * Represents a message in a chat. Can assume different roles, like user or assistant.
+	 */
+	export class LanguageModelChatMessage2 {
+
+		/**
+		 * Utility to create a new user message.
+		 *
+		 * @param content The content of the message.
+		 * @param name The optional name of a user for the message.
+		 */
+		static User(content: string | Array<LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelDataPart>, name?: string): LanguageModelChatMessage2;
+
+		/**
+		 * Utility to create a new assistant message.
+		 *
+		 * @param content The content of the message.
+		 * @param name The optional name of a user for the message.
+		 */
+		static Assistant(content: string | Array<LanguageModelTextPart | LanguageModelToolCallPart | LanguageModelDataPart>, name?: string): LanguageModelChatMessage2;
+
+		/**
+		 * The role of this message.
+		 */
+		role: LanguageModelChatMessageRole;
+
+		/**
+		 * A string or heterogeneous array of things that a message can contain as content. Some parts may be message-type
+		 * specific for some models.
+		 */
+		content: Array<LanguageModelTextPart | LanguageModelToolResultPart | LanguageModelToolCallPart | LanguageModelDataPart | LanguageModelThinkingPart>;
+
+		/**
+		 * The optional name of a user for this message.
+		 */
+		name: string | undefined;
+
+		/**
+		 * Create a new user message.
+		 *
+		 * @param role The role of the message.
+		 * @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 | LanguageModelDataPart | LanguageModelThinkingPart>, name?: string);
+	}
+
+	/**
+	 * Temporary alias for LanguageModelToolResultPart to avoid breaking changes in chat.
+	 */
+	export class LanguageModelToolResultPart2 extends LanguageModelToolResultPart { }
+
+	/**
+	 * Temporary alias for LanguageModelToolResult to avoid breaking changes in chat.
+	 */
+	export class LanguageModelToolResult2 extends LanguageModelToolResult { }
 }

package/vscode-dts/vscode.proposed.markdownAlertSyntax.d.ts

@@ -0,0 +1,29 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// @kycutler https://github.com/microsoft/vscode/issues/209652
+
+	export interface MarkdownString {
+
+		/**
+		 * Indicates that this markdown string can contain alert syntax. Defaults to `false`.
+		 *
+		 * When `supportAlertSyntax` is true, the markdown renderer will parse GitHub-style alert syntax:
+		 *
+		 * ```markdown
+		 * > [!NOTE]
+		 * > This is a note alert
+		 *
+		 * > [!WARNING]
+		 * > This is a warning alert
+		 * ```
+		 *
+		 * Supported alert types: `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`.
+		 */
+		supportAlertSyntax?: boolean;
+	}
+}

package/vscode-dts/vscode.proposed.mcpToolDefinitions.d.ts

@@ -0,0 +1,89 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/272000 @connor4312
+
+	/**
+	 * Defines when a {@link McpServerLanguageModelToolDefinition} is available
+	 * for calling.
+	 */
+	export enum McpToolAvailability {
+		/**
+		 * The MCP tool is available when the server starts up.
+		 */
+		Initial = 0,
+
+		/**
+		 * The MCP tool is conditionally available when certain preconditions are met.
+		 */
+		Dynamic = 1,
+	}
+
+	/**
+	 * The definition for a tool an MCP server provides. Extensions may provide
+	 * this as part of their server metadata to allow the editor to defer
+	 * starting the server until it's called by a language model.
+	 */
+	export interface McpServerLanguageModelToolDefinition {
+		/**
+		 * The definition of the tool as it appears on the MCP protocol. This should
+		 * be an object that includes the `inputSchema` and `name`,
+		 * among other optional properties.
+		 */
+		definition?: unknown;
+
+		/**
+		 * An indicator for when the tool is available for calling.
+		 */
+		availability: McpToolAvailability;
+	}
+
+	/**
+	 * Metadata which the editor can use to hydrate information about the server
+	 * prior to starting it. The extension can provide tools and basic server
+	 * instructions as they would be expected to appear on MCP itself.
+	 *
+	 * Once a server is started, the observed values will be cached and take
+	 * precedence over those statically declared here unless and until the
+	 * server's {@link McpStdioServerDefinition.version version} is updated. If
+	 * you can ensure the metadata is always accurate and do not otherwise have
+	 * a server `version` to use, it is reasonable to set the server `version`
+	 * to a hash of this object to ensure the cache tracks the {@link McpServerMetadata}.
+	 */
+	export interface McpServerMetadata {
+		/**
+		 * Tools the MCP server exposes.
+		 */
+		tools?: McpServerLanguageModelToolDefinition[];
+
+		/**
+		 * MCP server instructions as it would appear on the `initialize` result in the protocol.
+		 */
+		instructions?: string;
+
+		/**
+		 * MCP server capabilities as they would appear on the `initialize` result in the protocol.
+		 */
+		capabilities?: unknown;
+
+		/**
+		 * MCP server info as it would appear on the `initialize` result in the protocol.
+		 */
+		serverInfo?: unknown;
+	}
+
+
+	export class McpStdioServerDefinition2 extends McpStdioServerDefinition {
+		metadata?: McpServerMetadata;
+		constructor(label: string, command: string, args?: string[], env?: Record<string, string | number | null>, version?: string, metadata?: McpServerMetadata);
+	}
+
+	export class McpHttpServerDefinition2 extends McpHttpServerDefinition {
+		metadata?: McpServerMetadata;
+		constructor(label: string, uri: Uri, headers?: Record<string, string>, version?: string, metadata?: McpServerMetadata);
+	}
+}

package/vscode-dts/vscode.proposed.notebookKernelSource.d.ts

@@ -25,7 +25,7 @@ declare module 'vscode' {
 		/**
 		 * An optional event to signal that the kernel source actions have changed.
 		 */
-		onDidChangeNotebookKernelSourceActions?: Event<void>;
+		readonly onDidChangeNotebookKernelSourceActions?: Event<void>;
 		/**
 		 * Provide kernel source actions
 		 */

package/vscode-dts/vscode.proposed.notebookVariableProvider.d.ts

@@ -21,7 +21,7 @@ declare module 'vscode' {
 	}
 
 	export interface NotebookVariableProvider {
-		onDidChangeVariables: Event<NotebookDocument>;
+		readonly onDidChangeVariables: Event<NotebookDocument>;
 
 		/** When parent is undefined, this is requesting global Variables. When a variable is passed, it's requesting child props of that Variable. */
 		provideVariables(notebook: NotebookDocument, parent: Variable | undefined, kind: NotebookVariablesRequestKind, start: number, token: CancellationToken): AsyncIterable<VariablesResult>;

package/vscode-dts/vscode.proposed.quickInputButtonLocation.d.ts

@@ -16,7 +16,12 @@ declare module 'vscode' {
 		/**
 		 * To the right of the input box.
 		 */
-		Inline = 2
+		Inline = 2,
+
+		/**
+		 * At the far end inside the input box.
+		 */
+		Input = 3
 	}
 
 	export interface QuickInputButton {
@@ -25,5 +30,13 @@ declare module 'vscode' {
 		 * @note This property is ignored if the button was added to a QuickPickItem.
 		 */
 		location?: QuickInputButtonLocation;
+
+		/**
+		 * When present, indicates that the button is a toggle that can be checked.
+		 * @note This property is currently only applicable to buttons with location {@link QuickInputButtonLocation.Input}.
+		 * It must be set for such buttons and the state will be updated when the button is toggled.
+		 * It cannot be set for buttons with other location value currently.
+		 */
+		readonly toggle?: { checked: boolean };
 	}
 }

package/vscode-dts/vscode.proposed.quickPickItemResource.d.ts

@@ -0,0 +1,21 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/59826
+
+	export interface QuickPickItem {
+		/**
+		 * The {@link Uri} of the resource representing this item.
+		 *
+		 * Will be used to derive the {@link label}, when it is not provided (falsy or empty).
+		 * Will be used to derive the {@link description}, when it is not provided (falsy or empty).
+		 * Will be used to derive the icon from current file icon theme, when {@link iconPath} has either
+		 * {@link ThemeIcon.File} or {@link ThemeIcon.Folder} value.
+		 */
+		resourceUri?: Uri;
+	}
+}

package/vscode-dts/vscode.proposed.quickPickPrompt.d.ts

@@ -0,0 +1,25 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/78335
+
+	export interface QuickPick<T extends QuickPickItem> extends QuickInput {
+		/**
+		 * An optional prompt text providing some ask or explanation to the user.
+		 * Shown below the input box and above the quick pick items.
+		 */
+		prompt: string | undefined;
+	}
+
+	export interface QuickPickOptions {
+		/**
+		 * An optional prompt text providing some ask or explanation to the user.
+		 * Shown below the input box and above the quick pick items.
+		 */
+		prompt?: string;
+	}
+}

package/vscode-dts/vscode.proposed.resolvers.d.ts

@@ -34,9 +34,9 @@ declare module 'vscode' {
 	}
 
 	export interface ManagedMessagePassing {
-		onDidReceiveMessage: Event<Uint8Array>;
-		onDidClose: Event<Error | undefined>;
-		onDidEnd: Event<void>;
+		readonly onDidReceiveMessage: Event<Uint8Array>;
+		readonly onDidClose: Event<Error | undefined>;
+		readonly onDidEnd: Event<void>;
 
 		send: (data: Uint8Array) => void;
 		end: () => void;
@@ -102,7 +102,7 @@ declare module 'vscode' {
 
 	export interface Tunnel extends TunnelDescription {
 		// Implementers of Tunnel should fire onDidDispose when dispose is called.
-		onDidDispose: Event<void>;
+		readonly onDidDispose: Event<void>;
 		dispose(): void | Thenable<void>;
 	}
 

package/vscode-dts/vscode.proposed.scmArtifactProvider.d.ts

@@ -0,0 +1,32 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+	// https://github.com/microsoft/vscode/issues/253665
+
+	export interface SourceControl {
+		artifactProvider?: SourceControlArtifactProvider;
+	}
+
+	export interface SourceControlArtifactProvider {
+		readonly onDidChangeArtifacts: Event<string[]>;
+
+		provideArtifactGroups(token: CancellationToken): ProviderResult<SourceControlArtifactGroup[]>;
+		provideArtifacts(group: string, token: CancellationToken): ProviderResult<SourceControlArtifact[]>;
+	}
+
+	export interface SourceControlArtifactGroup {
+		readonly id: string;
+		readonly name: string;
+		readonly icon?: IconPath;
+	}
+
+	export interface SourceControlArtifact {
+		readonly id: string;
+		readonly name: string;
+		readonly description?: string;
+		readonly icon?: IconPath;
+	}
+}

package/vscode-dts/vscode.proposed.scmHistoryProvider.d.ts

@@ -19,12 +19,12 @@ declare module 'vscode' {
 		 * Fires when the current history item refs (local, remote, base)
 		 * change after a user action (ex: commit, checkout, fetch, pull, push)
 		 */
-		onDidChangeCurrentHistoryItemRefs: Event<void>;
+		readonly onDidChangeCurrentHistoryItemRefs: Event<void>;
 
 		/**
 		 * Fires when history item refs change
 		 */
-		onDidChangeHistoryItemRefs: Event<SourceControlHistoryItemRefsChangeEvent>;
+		readonly onDidChangeHistoryItemRefs: Event<SourceControlHistoryItemRefsChangeEvent>;
 
 		provideHistoryItemRefs(historyItemRefs: string[] | undefined, token: CancellationToken): ProviderResult<SourceControlHistoryItemRef[]>;
 		provideHistoryItems(options: SourceControlHistoryOptions, token: CancellationToken): ProviderResult<SourceControlHistoryItem[]>;
@@ -61,6 +61,7 @@ declare module 'vscode' {
 		readonly timestamp?: number;
 		readonly statistics?: SourceControlHistoryItemStatistics;
 		readonly references?: SourceControlHistoryItemRef[];
+		readonly tooltip?: string | MarkdownString | undefined;
 	}
 
 	export interface SourceControlHistoryItemRef {