@codingame/monaco-vscode-api 2.0.3 → 2.1.0

package/vscode/src/vs/workbench/services/{hover/browser/hover.js → views/common/viewsService.js}

@@ -1,3 +1,3 @@
 import { createDecorator } from '../../../../platform/instantiation/common/instantiation.js';
-const IHoverService = ( createDecorator('hoverService'));
-export { IHoverService };
+const IViewsService = ( createDecorator('viewsService'));
+export { IViewsService };

package/vscode/src/vs/workbench/services/workingCopy/common/storedFileWorkingCopy.d.ts

@@ -1,6 +1,6 @@
 import { Event } from '../../../../base/common/event.js';
 import { CancellationToken } from '../../../../base/common/cancellation.js';
-import { IWriteFileOptions, IFileStatWithMetadata } from '../../../../platform/files/common/files.js';
+import { IWriteFileOptions, IFileStatWithMetadata, IFileReadLimits } from '../../../../platform/files/common/files.js';
 import '../../../../editor/editor.api.js';
 import { IMarkdownString } from '../../../../base/common/htmlContent.js';
 import { VSBufferReadableStream } from '../../../../base/common/buffer.js';
@@ -167,6 +167,11 @@ interface IStoredFileWorkingCopyResolveOptions {
      * Go to disk bypassing any cache of the stored file working copy if any.
      */
     readonly forceReadFromFile?: boolean;
+    /**
+     * If provided, the size of the file will be checked against the limits
+     * and an error will be thrown if any limit is exceeded.
+     */
+    readonly limits?: IFileReadLimits;
 }
 interface IStoredFileWorkingCopySaveEvent extends IWorkingCopySaveEvent {
     /**

package/vscode/src/vs/workbench/services/workingCopy/common/storedFileWorkingCopy.js

@@ -69,7 +69,7 @@ let StoredFileWorkingCopy = class StoredFileWorkingCopy extends ResourceWorkingC
         this.registerListeners();
     }
     registerListeners() {
-        this._register(this.filesConfigurationService.onReadonlyChange(() => this._onDidChangeReadonly.fire()));
+        this._register(this.filesConfigurationService.onDidChangeReadonly(() => this._onDidChangeReadonly.fire()));
     }
     isDirty() {
         return this.dirty;
@@ -213,7 +213,10 @@ let StoredFileWorkingCopy = class StoredFileWorkingCopy extends ResourceWorkingC
         }
         const currentVersionId = this.versionId;
         try {
-            const content = await this.fileService.readFileStream(this.resource, { etag });
+            const content = await this.fileService.readFileStream(this.resource, {
+                etag,
+                limits: options?.limits
+            });
             this.setOrphaned(false);
             if (currentVersionId !== this.versionId) {
                 this.trace('resolveFromFile() - exit - without resolving because file working copy content changed');

package/vscode/src/vs/workbench/services/workspaces/common/workspaceTrust.js

@@ -618,6 +618,7 @@ class WorkspaceTrustTransitionManager extends Disposable {
     }
     dispose() {
         this.participants.clear();
+        super.dispose();
     }
 }
 class WorkspaceTrustMemento {

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

@@ -5,11 +5,17 @@
 
 declare module 'vscode' {
 
+	export interface ChatAgentHistoryEntry {
+		request: ChatAgentRequest;
+		response: ChatAgentContentProgress[];
+		result: ChatAgentResult2;
+	}
+
 	export interface ChatAgentContext {
 		/**
 		 * All of the chat messages so far in the current chat session.
 		 */
-		history: ChatMessage[];
+		history: ChatAgentHistoryEntry[];
 	}
 
 	/**
@@ -64,12 +70,12 @@ declare module 'vscode' {
 	/**
 	 * Represents user feedback for a result.
 	 */
-	export interface ChatAgentResult2Feedback {
+	export interface ChatAgentResult2Feedback<TResult extends ChatAgentResult2> {
 		/**
 		 * This instance of ChatAgentResult2 is the same instance that was returned from the chat agent,
 		 * and it can be extended with arbitrary properties if needed.
 		 */
-		readonly result: ChatAgentResult2;
+		readonly result: TResult;
 
 		/**
 		 * The kind of feedback that was received.
@@ -77,12 +83,12 @@ declare module 'vscode' {
 		readonly kind: ChatAgentResultFeedbackKind;
 	}
 
-	export interface ChatAgentSlashCommand {
+	export interface ChatAgentSubCommand {
 		/**
 		 * A short name by which this command is referred to in the UI, e.g. `fix` or
 		 * `explain` for commands that fix an issue or explain code.
 		 *
-		 * **Note**: The name should be unique among the slash commands provided by this agent.
+		 * **Note**: The name should be unique among the subCommands provided by this agent.
 		 */
 		readonly name: string;
 
@@ -92,37 +98,39 @@ declare module 'vscode' {
 		readonly description: string;
 
 		/**
-		 * When the user clicks this slash command in `/help`, this text will be submitted to this slash command
+		 * When the user clicks this subCommand in `/help`, this text will be submitted to this subCommand
 		 */
 		readonly sampleRequest?: string;
 
 		/**
 		 * Whether executing the command puts the
 		 * chat into a persistent mode, where the
-		 * slash command is prepended to the chat input.
+		 * subCommand is prepended to the chat input.
 		 */
 		readonly shouldRepopulate?: boolean;
+
 		/**
 		 * Placeholder text to render in the chat input
-		 * when the slash command has been repopulated.
+		 * when the subCommand has been repopulated.
 		 * Has no effect if `shouldRepopulate` is `false`.
 		 */
+		// TODO@API merge this with shouldRepopulate? so that invalid state cannot be represented?
 		readonly followupPlaceholder?: string;
 	}
 
-	export interface ChatAgentSlashCommandProvider {
+	export interface ChatAgentSubCommandProvider {
 
 		/**
-		 * Returns a list of slash commands that its agent is capable of handling. A slash command
+		 * Returns a list of subCommands that its agent is capable of handling. A subCommand
 		 * can be selected by the user and will then be passed to the {@link ChatAgentHandler handler}
-		 * via the {@link ChatAgentRequest.slashCommand slashCommand} property.
+		 * via the {@link ChatAgentRequest.subCommand subCommand} property.
 		 *
 		 *
 		 * @param token A cancellation token.
-		 * @returns A list of slash commands. The lack of a result can be signaled by returning `undefined`, `null`, or
+		 * @returns A list of subCommands. The lack of a result can be signaled by returning `undefined`, `null`, or
 		 * an empty array.
 		 */
-		provideSlashCommands(token: CancellationToken): ProviderResult<ChatAgentSlashCommand[]>;
+		provideSubCommands(token: CancellationToken): ProviderResult<ChatAgentSubCommand[]>;
 	}
 
 	// TODO@API This should become a progress type, and use vscode.Command
@@ -159,16 +167,16 @@ declare module 'vscode' {
 	/**
 	 * Will be invoked once after each request to get suggested followup questions to show the user. The user can click the followup to send it to the chat.
 	 */
-	export interface FollowupProvider {
+	export interface FollowupProvider<TResult extends ChatAgentResult2> {
 		/**
 		 *
 		 * @param result The same instance of the result object that was returned by the chat agent, and it can be extended with arbitrary properties if needed.
 		 * @param token A cancellation token.
 		 */
-		provideFollowups(result: ChatAgentResult2, token: CancellationToken): ProviderResult<ChatAgentFollowup[]>;
+		provideFollowups(result: TResult, token: CancellationToken): ProviderResult<ChatAgentFollowup[]>;
 	}
 
-	export interface ChatAgent2 {
+	export interface ChatAgent2<TResult extends ChatAgentResult2> {
 
 		/**
 		 * The short name by which this agent is referred to in the UI, e.g `workspace`.
@@ -200,17 +208,17 @@ declare module 'vscode' {
 		} | ThemeIcon;
 
 		/**
-		 * This provider will be called to retrieve the agent's slash commands.
+		 * This provider will be called to retrieve the agent's subCommands.
 		 */
-		slashCommandProvider?: ChatAgentSlashCommandProvider;
+		subCommandProvider?: ChatAgentSubCommandProvider;
 
 		/**
 		 * This provider will be called once after each request to retrieve suggested followup questions.
 		 */
-		followupProvider?: FollowupProvider;
+		followupProvider?: FollowupProvider<TResult>;
 
 		/**
-		 * When the user clicks this agent in `/help`, this text will be submitted to this slash command
+		 * When the user clicks this agent in `/help`, this text will be submitted to this subCommand
 		 */
 		sampleRequest?: string;
 
@@ -221,10 +229,9 @@ declare module 'vscode' {
 		 * The passed {@link ChatAgentResult2Feedback.result result} is guaranteed to be the same instance that was
 		 * previously returned from this chat agent.
 		 */
-		onDidReceiveFeedback: Event<ChatAgentResult2Feedback>;
+		onDidReceiveFeedback: Event<ChatAgentResult2Feedback<TResult>>;
 
 		/**
-		 * TODO@API explain what happens wrt to history, in-flight requests etc...
 		 * Dispose this agent and free resources
 		 */
 		dispose(): void;
@@ -233,31 +240,45 @@ declare module 'vscode' {
 	export interface ChatAgentRequest {
 
 		/**
-		 * The prompt entered by the user. The {@link ChatAgent2.name name} of the agent or the {@link ChatAgentSlashCommand.name slash command}
+		 * The prompt entered by the user. The {@link ChatAgent2.name name} of the agent or the {@link ChatAgentSubCommand.name subCommand}
 		 * are not part of the prompt.
 		 *
-		 * @see {@link ChatAgentRequest.slashCommand}
+		 * @see {@link ChatAgentRequest.subCommand}
 		 */
 		prompt: string;
 
 		/**
-		 * The {@link ChatAgentSlashCommand slash command} that was selected for this request. It is guaranteed that the passed slash
-		 * command is an instance that was previously returned from the {@link ChatAgentSlashCommandProvider.provideSlashCommands slash command provider}.
+		 * The ID of the chat agent to which this request was directed.
 		 */
-		slashCommand?: ChatAgentSlashCommand;
+		agentId: string;
+
+		/**
+		 * The {@link ChatAgentSubCommand subCommand} that was selected for this request. It is guaranteed that the passed subCommand
+		 * is an instance that was previously returned from the {@link ChatAgentSubCommandProvider.provideSubCommands subCommand provider}.
+		 * @deprecated this will be replaced by `subCommand`
+		 */
+		slashCommand?: ChatAgentSubCommand;
+
+		/**
+		 * The name of the {@link ChatAgentSubCommand subCommand} that was selected for this request.
+		 */
+		subCommand?: string;
 
 		variables: Record<string, ChatVariableValue[]>;
 	}
 
-	export type ChatAgentProgress =
+	export type ChatAgentContentProgress =
 		| ChatAgentContent
-		| ChatAgentTask
 		| ChatAgentFileTree
+		| ChatAgentInlineContentReference;
+
+	export type ChatAgentMetadataProgress =
 		| ChatAgentUsedContext
 		| ChatAgentContentReference
-		| ChatAgentInlineContentReference
 		| ChatAgentProgressMessage;
 
+	export type ChatAgentProgress = ChatAgentContentProgress | ChatAgentMetadataProgress;
+
 	/**
 	 * Is displayed in the UI to communicate steps of progress to the user. Should be used when the agent may be slow to respond, e.g. due to doing extra work before sending the actual request to the LLM.
 	 */
@@ -300,22 +321,6 @@ declare module 'vscode' {
 		content: string;
 	}
 
-	/**
-	 * Represents a piece of the chat response's content that is resolved asynchronously. It is rendered immediately with a placeholder,
-	 * which is replaced once the full content is available.
-	 */
-	export interface ChatAgentTask {
-		/**
-		 * The markdown string to be rendered immediately.
-		 */
-		placeholder: string;
-
-		/**
-		 * A Thenable resolving to the real content. The placeholder will be replaced with this content once it's available.
-		 */
-		resolvedContent: Thenable<ChatAgentContent | ChatAgentFileTree>;
-	}
-
 	/**
 	 * Represents a tree, such as a file and directory structure, rendered in the chat response.
 	 */
@@ -338,8 +343,17 @@ declare module 'vscode' {
 		/**
 		 * A Uri for this node, opened when it's clicked.
 		 */
+		// TODO@API why label and uri. Can the former be derived from the latter?
+		// TODO@API don't use uri but just names? This API allows to to build nonsense trees where the data structure doesn't match the uris
+		// path-structure.
 		uri: Uri;
 
+		/**
+		 * The type of this node. Defaults to {@link FileType.Directory} if it has {@link ChatAgentFileTreeData.children children}.
+		 */
+		// TODO@API cross API usage
+		type?: FileType;
+
 		/**
 		 * The children of this node.
 		 */
@@ -370,6 +384,57 @@ declare module 'vscode' {
 		 * @param handler The reply-handler of the agent.
 		 * @returns A new chat agent
 		 */
-		export function createChatAgent(name: string, handler: ChatAgentHandler): ChatAgent2;
+		export function createChatAgent<TResult extends ChatAgentResult2>(name: string, handler: ChatAgentHandler): ChatAgent2<TResult>;
+
+		/**
+		 * Register a variable which can be used in a chat request to any agent.
+		 * @param name The name of the variable, to be used in the chat input as `#name`.
+		 * @param description A description of the variable for the chat input suggest widget.
+		 * @param resolver Will be called to provide the chat variable's value when it is used.
+		 */
+		export function registerVariable(name: string, description: string, resolver: ChatVariableResolver): Disposable;
+	}
+
+	/**
+	 * The detail level of this chat variable value.
+	 */
+	export enum ChatVariableLevel {
+		Short = 1,
+		Medium = 2,
+		Full = 3
+	}
+
+	export interface ChatVariableValue {
+		/**
+		 * The detail level of this chat variable value. If possible, variable resolvers should try to offer shorter values that will consume fewer tokens in an LLM prompt.
+		 */
+		level: ChatVariableLevel;
+
+		/**
+		 * The variable's value, which can be included in an LLM prompt as-is, or the chat agent may decide to read the value and do something else with it.
+		 */
+		value: string | Uri;
+
+		/**
+		 * A description of this value, which could be provided to the LLM as a hint.
+		 */
+		description?: string;
+	}
+
+	export interface ChatVariableContext {
+		/**
+		 * The message entered by the user, which includes this variable.
+		 */
+		prompt: string;
+	}
+
+	export interface ChatVariableResolver {
+		/**
+		 * A callback to resolve the value of a chat variable.
+		 * @param name The name of the variable.
+		 * @param context Contextual information about this chat request.
+		 * @param token A cancellation token.
+		 */
+		resolve(name: string, context: ChatVariableContext, token: CancellationToken): ProviderResult<ChatVariableValue[]>;
 	}
 }

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

@@ -5,12 +5,7 @@
 
 declare module 'vscode' {
 
-	export interface ChatAgentUserActionEvent {
-		readonly result: ChatAgentResult2;
-		readonly action: InteractiveSessionCopyAction | InteractiveSessionInsertAction | InteractiveSessionTerminalAction | InteractiveSessionCommandAction | InteractiveSessionFollowupAction | InteractiveSessionBugReportAction;
-	}
-
-	export interface ChatAgent2 {
+	export interface ChatAgent2<TResult extends ChatAgentResult2> {
 		onDidPerformAction: Event<ChatAgentUserActionEvent>;
 		supportIssueReporting?: boolean;
 	}
@@ -31,7 +26,7 @@ declare module 'vscode' {
 
 	export interface ChatAgentDetectedAgent {
 		agentName: string;
-		command?: ChatAgentSlashCommand;
+		command?: ChatAgentSubCommand;
 	}
 
 	export interface ChatAgentVulnerability {
@@ -48,7 +43,7 @@ declare module 'vscode' {
 		| ChatAgentMarkdownContent
 		| ChatAgentDetectedAgent;
 
-	export interface ChatAgent2 {
+	export interface ChatAgent2<TResult extends ChatAgentResult2> {
 		/**
 		 * Provide a set of variables that can only be used with this agent.
 		 */
@@ -75,6 +70,70 @@ declare module 'vscode' {
 		/**
 		 * Create a chat agent with the extended progress type
 		 */
-		export function createChatAgent(name: string, handler: ChatAgentExtendedHandler): ChatAgent2;
+		export function createChatAgent<TResult extends ChatAgentResult2>(name: string, handler: ChatAgentExtendedHandler): ChatAgent2<TResult>;
+	}
+
+	/*
+	 * User action events
+	 */
+
+	export enum ChatAgentCopyKind {
+		// Keyboard shortcut or context menu
+		Action = 1,
+		Toolbar = 2
+	}
+
+	export interface ChatAgentCopyAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'copy';
+		codeBlockIndex: number;
+		copyKind: ChatAgentCopyKind;
+		copiedCharacters: number;
+		totalCharacters: number;
+		copiedText: string;
+	}
+
+	export interface ChatAgentInsertAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'insert';
+		codeBlockIndex: number;
+		totalCharacters: number;
+		newFile?: boolean;
+	}
+
+	export interface ChatAgentTerminalAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'runInTerminal';
+		codeBlockIndex: number;
+		languageId?: string;
+	}
+
+	export interface ChatAgentCommandAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'command';
+		command: ChatAgentCommandFollowup;
+	}
+
+	export interface ChatAgentSessionFollowupAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'followUp';
+		followup: ChatAgentFollowup;
+	}
+
+	export interface ChatAgentBugReportAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'bug';
+	}
+
+	export interface ChatAgentUserActionEvent {
+		readonly result: ChatAgentResult2;
+		readonly action: ChatAgentCopyAction | ChatAgentInsertAction | ChatAgentTerminalAction | ChatAgentCommandAction | ChatAgentSessionFollowupAction | ChatAgentBugReportAction;
+	}
+
+	export interface ChatVariableValue {
+		/**
+		 * An optional type tag for extensions to communicate the kind of the variable. An extension might use it to interpret the shape of `value`.
+		 */
+		kind?: string;
 	}
 }

package/vscode-dts/{vscode.proposed.scmInputBoxActionButton.d.ts → vscode.proposed.codeActionRanges.d.ts}

@@ -4,16 +4,14 @@
  *--------------------------------------------------------------------------------------------*/
 
 declare module 'vscode' {
-	// https://github.com/microsoft/vscode/issues/195474
 
-	export interface SourceControlInputBoxActionButton {
-		readonly command: Command;
-		readonly enabled: boolean;
-		readonly icon?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
+	export interface CodeAction {
+		/**
+		 *
+		 * The range to which this Code Action applies to, which will be highlighted.
+		 *
+		 * Ex: A refactoring action will highlight the range of text that will be affected.
+		 */
+		ranges?: Range[];
 	}
-
-	export interface SourceControlInputBox {
-		actionButton?: SourceControlInputBoxActionButton;
-	}
-
 }

package/vscode-dts/{vscode.proposed.readonlyMessage.d.ts → vscode.proposed.commentReactor.d.ts}

@@ -3,12 +3,11 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// https://github.com/microsoft/vscode/issues/166971
-
 declare module 'vscode' {
 
-	export namespace workspace {
+	// @alexr00 https://github.com/microsoft/vscode/issues/201131
 
-		export function registerFileSystemProvider(scheme: string, provider: FileSystemProvider, options?: { readonly isCaseSensitive?: boolean; readonly isReadonly?: boolean | MarkdownString }): Disposable;
+	export interface CommentReaction {
+		readonly reactors?: readonly CommentAuthorInformation[];
 	}
 }

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

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for `multiDiffEditor/*` menus

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

@@ -0,0 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for the `scm/incomingChanges`-menu contribution point
+// empty placeholder declaration for the `scm/outgoingChanges`-menu contribution point
+// https://github.com/microsoft/vscode/issues/201997

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

@@ -0,0 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for the `scm/incomingChanges/historyItem/context`-menu contribution point
+// empty placeholder declaration for the `scm/outgoingChanges/historyItem/context`-menu contribution point
+// https://github.com/microsoft/vscode/issues/201997

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

@@ -0,0 +1,100 @@
+/*---------------------------------------------------------------------------------------------
+ *  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 debug {
+		/**
+		 * Registers a custom data visualization for variables when debugging.
+		 *
+		 * @param id The corresponding ID in the package.json `debugVisualizers` contribution point.
+		 * @param provider The {@link DebugVisualizationProvider} to register
+		 */
+		export function registerDebugVisualizationProvider<T extends DebugVisualization>(
+			id: string,
+			provider: DebugVisualizationProvider<T>
+		): Disposable;
+	}
+
+	export class DebugVisualization {
+		/**
+		 * The name of the visualization to show to the user.
+		 */
+		name: string;
+
+		/**
+		 * An icon for the view when it's show in inline actions.
+		 */
+		iconPath?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
+
+		/**
+		 * Visualization to use for the variable. This may be either:
+		 * - A command to run when the visualization is selected for a variable.
+		 * - A {@link TreeDataProvider} which is used to display the data in-line
+		 *   where the variable is shown. If a single root item is returned from
+		 *   the data provider, it will replace the variable in its tree.
+		 *   Otherwise, the items will be shown as children of the variable.
+		 */
+		visualization?: Command | TreeDataProvider<unknown>;
+
+		/**
+		 * Creates a new debug visualization object.
+		 * @param name Name of the visualization to show to the user.
+		 */
+		constructor(name: string);
+	}
+
+	export interface DebugVisualizationProvider<T extends DebugVisualization = DebugVisualization> {
+		/**
+		 * Called for each variable when the debug session stops. It should return
+		 * any visualizations the extension wishes to show to the user.
+		 *
+		 * Note that this is only called when its `when` clause defined under the
+		 * `debugVisualizers` contribution point in the `package.json` evaluates
+		 * to true.
+		 */
+		provideDebugVisualization(context: DebugVisualizationContext, token: CancellationToken): ProviderResult<T[]>;
+
+		/**
+		 * Invoked for a variable when a user picks the visualizer.
+		 *
+		 * It may return a {@link TreeView} that's shown in the Debug Console or
+		 * inline in a hover. A visualizer may choose to return `undefined` from
+		 * this function and instead trigger other actions in the UI, such as opening
+		 * a custom {@link WebviewView}.
+		 */
+		resolveDebugVisualization?(visualization: T, token: CancellationToken): ProviderResult<T>;
+	}
+
+	export interface DebugVisualizationContext {
+		/**
+		 * The Debug Adapter Protocol Variable to be visualized.
+		 * @see https://microsoft.github.io/debug-adapter-protocol/specification#Types_Variable
+		 */
+		variable: any;
+		/**
+		 * The Debug Adapter Protocol variable reference the type (such as a scope
+		 * or another variable) that contained this one. Empty for variables
+		 * that came from user evaluations in the Debug Console.
+		 * @see https://microsoft.github.io/debug-adapter-protocol/specification#Types_Variable
+		 */
+		containerId?: string;
+		/**
+		 * The ID of the Debug Adapter Protocol StackFrame in which the variable was found,
+		 * for variables that came from scopes in a stack frame.
+		 * @see https://microsoft.github.io/debug-adapter-protocol/specification#Types_StackFrame
+		 */
+		frameId?: number;
+		/**
+		 * The ID of the Debug Adapter Protocol Thread in which the variable was found.
+		 * @see https://microsoft.github.io/debug-adapter-protocol/specification#Types_StackFrame
+		 */
+		threadId: number;
+		/**
+		 * The debug session the variable belongs to.
+		 */
+		session: DebugSession;
+	}
+}

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

@@ -5,7 +5,7 @@
 
 declare module 'vscode' {
 
-	export interface ChatAgent2 {
+	export interface ChatAgent2<TResult extends ChatAgentResult2> {
 		/**
 		 * When true, this agent is invoked by default when no other agent is being invoked
 		 */