@codingame/monaco-vscode-api 34.1.3 → 35.0.0

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 3
-
 declare module 'vscode' {
 
 	export interface ChatParticipant {
@@ -444,6 +442,7 @@ declare module 'vscode' {
 		ChatResponseThinkingProgressPart: ChatResponseThinkingProgressPart;
 		ChatResponseExternalEditPart: ChatResponseExternalEditPart;
 		ChatResponseQuestionCarouselPart: ChatResponseQuestionCarouselPart;
+		ChatResponseAutoModeResolutionPart: ChatResponseAutoModeResolutionPart;
 	}
 
 	export type ExtendedChatResponsePart = ExtendedChatResponseParts[keyof ExtendedChatResponseParts];
@@ -568,6 +567,22 @@ declare module 'vscode' {
 		constructor(uriOrCommand: Uri | Command, title: string, description: string, author: string, linkTag: string);
 	}
 
+	/**
+	 * Represents an auto-mode model routing resolution. Displayed as a collapsible
+	 * widget in the chat stream showing which model was selected and why.
+	 */
+	export class ChatResponseAutoModeResolutionPart {
+		/** The model ID that was selected by the router */
+		resolvedModel: string;
+		/** The user-facing display name of the resolved model */
+		resolvedModelName: string;
+		/** The router's classification label */
+		predictedLabel: string;
+		/** Confidence score (0-1) from the router */
+		confidence: number;
+		constructor(resolvedModel: string, resolvedModelName: string, predictedLabel: string, confidence: number);
+	}
+
 	export interface ChatResponseStream {
 
 		/**
@@ -859,6 +874,11 @@ declare module 'vscode' {
 		 */
 		readonly outputBuffer?: number;
 
+		/**
+		 * The number of copilot credits consumed by this request.
+		 */
+		readonly copilotCredits?: number;
+
 		/**
 		 * Optional breakdown of prompt token usage by category and label.
 		 * If the percentages do not sum to 100%, the remaining will be shown as "Uncategorized".
@@ -1080,6 +1100,7 @@ declare module 'vscode' {
 		readonly name: string;
 		readonly content: string;
 		readonly toolReferences?: readonly ChatLanguageModelToolReference[];
+		readonly allowedSubagents?: readonly string[];
 		readonly metadata?: Record<string, boolean | string | number>;
 		/**
 		 * Whether the mode is a builtin mode (e.g. Ask, Edit, Agent) rather than a user or extension-defined custom mode.

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 15
-
 declare module 'vscode' {
 
 	/**
@@ -459,12 +457,6 @@ declare module 'vscode' {
 	export interface LanguageModelToolInformation {
 		/**
 		 * The full reference name of this tool as used in agent definition files.
-		 *
-		 * For MCP tools, this is the canonical name in the format `serverShortName/toolReferenceName`
-		 * (e.g., `github/search_issues`). This can be used to map between the tool names specified
-		 * in agent `.md` files and the tool's internal {@link LanguageModelToolInformation.name id}.
-		 *
-		 * This property is only set for MCP tools. For other tool types, it is `undefined`.
 		 */
 		readonly fullReferenceName?: string;
 	}

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 2
-
 declare module 'vscode' {
 	// #region Resource Classes
 

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 5
-
 declare module 'vscode' {
 
 	/**
@@ -47,6 +45,14 @@ declare module 'vscode' {
 		 */
 		readonly multiplierNumeric?: number;
 
+		/**
+		 * Whether this model is a "bring your own key" (BYOK) model, i.e. it is
+		 * served using credentials the user supplied rather than through the
+		 * built-in Copilot (CAPI) service. When unset, the model is treated as
+		 * a non-BYOK / CAPI-served model.
+		 */
+		readonly isBYOK?: boolean;
+
 		/**
 		 * Whether or not this will be selected by default in the model picker
 		 * NOT BEING FINALIZED
@@ -77,6 +83,13 @@ declare module 'vscode' {
 		 * The value must match a `type` declared in a `chatSessions` extension contribution.
 		 */
 		readonly targetChatSessionType?: string;
+
+		/**
+		 * Optional warning text to display in the model picker hover as a warning banner.
+		 * The keys are warning categories (e.g. "data_retention") and the values are markdown strings.
+		 * Unlike degradation warnings, this does not produce a warning icon in the picker list.
+		 */
+		readonly warningText?: Record<string, string>;
 	}
 
 	export interface LanguageModelChatCapabilities {

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

@@ -29,6 +29,17 @@ declare module 'vscode' {
 		 */
 		readonly reference?: Uri;
 
+		/**
+		 * Whether this image was pasted from the clipboard.
+		 */
+		readonly isPasted?: boolean;
+
+		/**
+		 * Whether this image originated from a URL. `true` when it was attached from a URL,
+		 * `false` when it came from a local file, and `undefined` when the origin is unknown.
+		 */
+		readonly isURL?: boolean;
+
 		/**
 		 * @param mimeType The MIME type of the binary data.
 		 * @param data The binary data of the reference.

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

@@ -106,6 +106,13 @@ declare module 'vscode' {
 		 */
 		readonly pluginUri?: Uri;
 
+		/**
+		 * Human-readable name of the plugin that contributed this customization, if any.
+		 * Used to qualify plugin-scoped slash command names when `pluginUri` points to
+		 * an implementation-specific install directory.
+		 */
+		readonly pluginLabel?: string;
+
 		/**
 		 * Optional group key for display grouping. Items sharing the same
 		 * `groupKey` are placed under a shared collapsible header in the
@@ -169,6 +176,33 @@ declare module 'vscode' {
 		 * @returns The list of customization items, or `undefined` if unavailable.
 		 */
 		provideChatSessionCustomizations(sessionResource: Uri, token: CancellationToken): ProviderResult<ChatSessionCustomizationItem[]>;
+
+		/**
+		 * Optionally provide the directories where new customization files
+		 * of the given {@link type} can be created for this session. The
+		 * management UI offers these locations in a picker when the user
+		 * creates a new item.
+		 *
+		 * @param sessionResource URI of the chat session whose creation
+		 *   locations should be returned.
+		 * @param type The customization type the user is creating.
+		 * @param token A cancellation token.
+		 * @returns The list of source folders, or `undefined` when no
+		 *   folders apply for this type.
+		 */
+		provideSourceFolders?(sessionResource: Uri, type: ChatSessionCustomizationType, token: CancellationToken): ProviderResult<ChatSessionCustomizationSourceFolder[]>;
+	}
+
+	/**
+	 * A directory where new customization files of a given type can be created.
+	 */
+	export interface ChatSessionCustomizationSourceFolder {
+		/** Directory where the new file should be written. */
+		readonly uri: Uri;
+		/** Display label for the picker when multiple folders are offered. */
+		readonly label: string;
+		/** Source of the customization folder. */
+		readonly source: ChatSessionCustomizationSource;
 	}
 
 	// #endregion

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 3
-
 declare module 'vscode' {
 	/**
 	 * Represents the status of a chat session.
@@ -710,9 +708,11 @@ declare module 'vscode' {
 		readonly inputCost?: number;
 		readonly outputCost?: number;
 		readonly cacheCost?: number;
+		readonly cacheWriteCost?: number;
 		readonly longContextInputCost?: number;
 		readonly longContextOutputCost?: number;
 		readonly longContextCacheCost?: number;
+		readonly longContextCacheWriteCost?: number;
 		readonly priceCategory?: string;
 		readonly maxInputTokens?: number;
 		readonly maxOutputTokens?: number;

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

@@ -5,20 +5,40 @@
 
 declare module 'vscode' {
 
+	/**
+	 * The pair of documents being compared in a custom editor diff.
+	 */
 	export interface CustomEditorDiffDocuments<T> {
+		/**
+		 * The original (left-hand side) document of the diff.
+		 */
 		readonly original: T;
+
+		/**
+		 * The modified (right-hand side) document of the diff.
+		 */
 		readonly modified: T;
 	}
 
-	export interface CustomEditorDiffWebviewPanels {
+	/**
+	 * The pair of webview panels used to render a side-by-side custom editor diff.
+	 */
+	export interface CustomEditorSideBySideDiffWebviewPanels {
+		/**
+		 * The webview panel used to display the original (left-hand side) document of the diff.
+		 */
 		readonly original: WebviewPanel;
+
+		/**
+		 * The webview panel used to display the modified (right-hand side) document of the diff.
+		 */
 		readonly modified: WebviewPanel;
 	}
 
 	export interface CustomReadonlyEditorProvider<T extends CustomDocument = CustomDocument> {
 
 		/**
-		 * Resolve a custom editor the shows the diff between two documents using a single webview.
+		 * Resolve a custom editor that shows the diff between two documents using a single webview.
 		 *
 		 * @param documents Original and modified documents for the diff editor.
 		 * @param webviewPanel The webview panel used to display the editor UI for this diff.
@@ -37,7 +57,7 @@ declare module 'vscode' {
 		 *
 		 * @returns Thenable indicating that the custom diff editor has been resolved.
 		 */
-		resolveCustomEditorSideBySideDiff?(documents: CustomEditorDiffDocuments<T>, webviewPanels: CustomEditorDiffWebviewPanels, token: CancellationToken): Thenable<void> | void;
+		resolveCustomEditorSideBySideDiff?(documents: CustomEditorDiffDocuments<T>, webviewPanels: CustomEditorSideBySideDiffWebviewPanels, token: CancellationToken): Thenable<void> | void;
 	}
 
 	export interface CustomTextEditorProvider {
@@ -62,6 +82,6 @@ declare module 'vscode' {
 		 *
 		 * @returns Thenable indicating that the custom diff editor has been resolved.
 		 */
-		resolveCustomTextEditorSideBySideDiff?(documents: CustomEditorDiffDocuments<TextDocument>, webviewPanels: CustomEditorDiffWebviewPanels, token: CancellationToken): Thenable<void> | void;
+		resolveCustomTextEditorSideBySideDiff?(documents: CustomEditorDiffDocuments<TextDocument>, webviewPanels: CustomEditorSideBySideDiffWebviewPanels, token: CancellationToken): Thenable<void> | void;
 	}
 }

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

@@ -1,5 +1,6 @@
 
 import "./vscode.proposed.activeComment.d.ts"
+import "./vscode.proposed.agentEditorComments.d.ts"
 import "./vscode.proposed.agentSessionsWorkspace.d.ts"
 import "./vscode.proposed.agentsWindowConfiguration.d.ts"
 import "./vscode.proposed.aiRelatedInformation.d.ts"
@@ -76,6 +77,7 @@ import "./vscode.proposed.diffCommand.d.ts"
 import "./vscode.proposed.diffContentOptions.d.ts"
 import "./vscode.proposed.documentDiff.d.ts"
 import "./vscode.proposed.documentFiltersExclusive.d.ts"
+import "./vscode.proposed.documentSyntaxHighlighting.d.ts"
 import "./vscode.proposed.editSessionIdentityProvider.d.ts"
 import "./vscode.proposed.editorHoverVerbosityLevel.d.ts"
 import "./vscode.proposed.editorInsets.d.ts"

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 4
-
 declare module 'vscode' {
 
 	export interface ChatWelcomeMessageContent {

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

@@ -0,0 +1,87 @@
+/*---------------------------------------------------------------------------------------------
+ *  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 namespace languages {
+		/**
+		 * Syntax-highlight `source` as `languageId` using the installed TextMate
+		 * grammars and the active color theme.
+		 *
+		 * The whole string is tokenized in one call ("full token sync"). Tokens are
+		 * dense and offset-free: they cover `source` exactly, back to back, so the sum
+		 * of all {@link SyntaxHighlightingToken.length} equals `source.length` (newline characters
+		 * are included as their own runs). A token's position is implied by the lengths
+		 * of the tokens before it.
+		 *
+		 * @param source The text to tokenize.
+		 * @param languageId A language identifier, e.g. `typescript` or `markdown`.
+		 *   Embedded languages (such as fenced code blocks) are resolved automatically.
+		 * @returns The tokens together with the {@link SyntaxHighlightingResult.colorMap colorMap}
+		 *   their {@link SyntaxHighlightingToken.foreground} values index into. Resolves even when no
+		 *   grammar is registered for `languageId`, in which case a single unstyled token
+		 *   spanning the whole input is returned.
+		 */
+		export function computeFullSyntaxHighlighting(source: string, languageId: string): Thenable<SyntaxHighlightingResult>;
+
+		/**
+		 * An event that fires when the active color theme changes. After it fires, the
+		 * {@link SyntaxHighlightingResult.colorMap colorMap} of previously returned
+		 * results is stale; call {@link computeFullSyntaxHighlighting} again to obtain up-to-date colors.
+		 */
+		export const onDidChangeSyntaxHighlighting: Event<void>;
+	}
+
+	/**
+	 * The result of {@link languages.computeFullSyntaxHighlighting}.
+	 */
+	export interface SyntaxHighlightingResult {
+		/**
+		 * The tokens covering the input exactly, back to back. `sum(token.length)`
+		 * equals the length of the highlighted `source`.
+		 */
+		readonly tokens: readonly SyntaxHighlightingToken[];
+
+		/**
+		 * Maps a {@link SyntaxHighlightingToken.foreground} index to a CSS color string (e.g.
+		 * `#d7ba7d`). Index `0` is the absent/default color. The map reflects the
+		 * active color theme at the time of the call.
+		 */
+		readonly colorMap: readonly string[];
+	}
+
+	/**
+	 * A colored run of {@link SyntaxHighlightingToken.length length} characters.
+	 */
+	export interface SyntaxHighlightingToken {
+		/**
+		 * The number of characters this token spans.
+		 */
+		readonly length: number;
+
+		/**
+		 * An index into {@link SyntaxHighlightingResult.colorMap} selecting this run's
+		 * foreground color.
+		 */
+		readonly foreground: number;
+
+		/**
+		 * The font style of this run, as a bitmask of {@link SyntaxHighlightingTokenFontStyle}.
+		 */
+		readonly fontStyle: SyntaxHighlightingTokenFontStyle;
+	}
+
+	/**
+	 * Font styles applied to a {@link SyntaxHighlightingToken}. Values are powers of two and can
+	 * be combined into a bitmask.
+	 */
+	export enum SyntaxHighlightingTokenFontStyle {
+		None = 0,
+		Italic = 1,
+		Bold = 2,
+		Underline = 4,
+		Strikethrough = 8,
+	}
+}

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 2
-
 declare module 'vscode' {
 
 	export interface FindFiles2Options {

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

@@ -32,6 +32,12 @@ declare module 'vscode' {
 		 */
 		readonly cacheCost?: number;
 
+		/**
+		 * Optional cache write cost in AI credits for this model.
+		 * Displayed in the model management UI as the cost per million cache-write tokens.
+		 */
+		readonly cacheWriteCost?: number;
+
 		/**
 		 * Optional long-context input cost in AI credits for this model.
 		 * Present only when long-context pricing differs from default pricing.
@@ -52,11 +58,23 @@ declare module 'vscode' {
 		 */
 		readonly longContextCacheCost?: number;
 
+		/**
+		 * Optional long-context cache write cost in AI credits for this model.
+		 * Present only when long-context pricing differs from default pricing.
+		 */
+		readonly longContextCacheWriteCost?: number;
+
 		/**
 		 * Optional relative pricing category for this model (e.g. "low", "medium", "high", "very_high").
 		 * Displayed in the model picker as a visual indicator of relative cost.
 		 */
 		readonly priceCategory?: string;
+
+		/**
+		 * Optional model category describing the model's tier (e.g. "lightweight", "versatile", "powerful").
+		 * Displayed in the model picker as a tag. Clients should be resilient to additional categories.
+		 */
+		readonly category?: string;
 	}
 
 	export interface LanguageModelChat {
@@ -81,6 +99,11 @@ declare module 'vscode' {
 		 */
 		readonly cacheCost?: number;
 
+		/**
+		 * Optional cache write cost in AI credits for this model.
+		 */
+		readonly cacheWriteCost?: number;
+
 		/**
 		 * Optional long-context input cost in AI credits for this model.
 		 * Present only when long-context pricing differs from default pricing.
@@ -99,10 +122,22 @@ declare module 'vscode' {
 		 */
 		readonly longContextCacheCost?: number;
 
+		/**
+		 * Optional long-context cache write cost in AI credits for this model.
+		 * Present only when long-context pricing differs from default pricing.
+		 */
+		readonly longContextCacheWriteCost?: number;
+
 		/**
 		 * Optional relative pricing category for this model (e.g. "low", "medium", "high", "very_high").
 		 * Displayed in the model picker as a visual indicator of relative cost.
 		 */
 		readonly priceCategory?: string;
+
+		/**
+		 * Optional model category describing the model's tier (e.g. "lightweight", "versatile", "powerful").
+		 * Displayed in the model picker as a tag. Clients should be resilient to additional categories.
+		 */
+		readonly category?: string;
 	}
 }

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 1
-
 declare module 'vscode' {
 
 	/**

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 1
-
 declare module 'vscode' {
 
 	export interface LanguageModelToolDefinition extends LanguageModelToolInformation {

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

@@ -3,8 +3,6 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 1
-
 declare module 'vscode' {
 
 	// https://github.com/microsoft/vscode/issues/288777 @DonJayamanne

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

@@ -40,8 +40,43 @@ declare module 'vscode' {
 		readonly diffInformation: TextEditorDiffInformation[] | undefined;
 	}
 
+	/**
+	 * A live, disposable view of the source control diff information of a resource
+	 * that is not necessarily shown in a {@link TextEditor} (for example a document
+	 * rendered by a custom editor).
+	 */
+	export interface SourceControlDiffInformationProvider extends Disposable {
+		/**
+		 * The current diff information for the resource, reflecting the primary
+		 * source control provider (e.g. git), or `undefined` while it is unavailable
+		 * (for example before the first diff has been computed or when the resource
+		 * is not under source control).
+		 */
+		readonly diffInformation: TextEditorDiffInformation | undefined;
+
+		/**
+		 * An event that fires whenever {@link diffInformation} changes.
+		 */
+		readonly onDidChange: Event<void>;
+	}
+
 	export namespace window {
 		export const onDidChangeTextEditorDiffInformation: Event<TextEditorDiffInformationChangeEvent>;
+
+		/**
+		 * Observe the source control diff information for a resource.
+		 *
+		 * Unlike {@link TextEditor.diffInformation}, this does not require the
+		 * resource to be shown in a {@link TextEditor}; the resource only needs to be
+		 * backed by an open {@link TextDocument}. This is useful for custom editors,
+		 * which render their document in a webview rather than a text editor.
+		 *
+		 * The returned provider must be disposed once it is no longer needed.
+		 *
+		 * @param uri The resource to observe.
+		 * @returns A live, disposable view of the resource's diff information.
+		 */
+		export function createSourceControlDiffInformation(uri: Uri): SourceControlDiffInformationProvider;
 	}
 
 }

package/vscode/src/vs/platform/agentHost/common/agentPluginManager.d.ts

@@ -1,11 +0,0 @@
-import { URI } from "../../../base/common/uri.js";
-import type { PluginCustomization } from "./state/sessionState.js";
-/**
- * A synced customization with its local plugin directory (when available).
- */
-export interface ISyncedCustomization {
-    /** The session customization with loading/error status. */
-    readonly customization: PluginCustomization;
-    /** Local plugin directory URI, defined when the sync was successful. */
-    readonly pluginDir?: URI;
-}