@codingame/monaco-vscode-api 19.1.3 → 20.0.0

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

@@ -66,10 +66,10 @@ declare module 'vscode' {
 
 	export class ChatResponseConfirmationPart {
 		title: string;
-		message: string;
+		message: string | MarkdownString;
 		data: any;
 		buttons?: string[];
-		constructor(title: string, message: string, data: any, buttons?: string[]);
+		constructor(title: string, message: string | MarkdownString, data: any, buttons?: string[]);
 	}
 
 	export class ChatResponseCodeCitationPart {
@@ -84,8 +84,72 @@ declare module 'vscode' {
 		constructor(toolName: string);
 	}
 
-	export type ExtendedChatResponsePart = ChatResponsePart | ChatResponseTextEditPart | ChatResponseNotebookEditPart | ChatResponseConfirmationPart | ChatResponseCodeCitationPart | ChatResponseReferencePart2 | ChatResponseMovePart | ChatResponseExtensionsPart | ChatPrepareToolInvocationPart;
+	export interface ChatTerminalToolInvocationData {
+		commandLine: {
+			original: string;
+			userEdited?: string;
+			toolEdited?: string;
+		};
+		language: string;
+	}
+
+	export class ChatToolInvocationPart {
+		toolName: string;
+		toolCallId: string;
+		isError?: boolean;
+		invocationMessage?: string | MarkdownString;
+		originMessage?: string | MarkdownString;
+		pastTenseMessage?: string | MarkdownString;
+		isConfirmed?: boolean;
+		isComplete?: boolean;
+		toolSpecificData?: ChatTerminalToolInvocationData;
+
+		constructor(toolName: string, toolCallId: string, isError?: boolean);
+	}
+
+	/**
+	 * Represents a single file diff entry in a multi diff view.
+	 */
+	export interface ChatResponseDiffEntry {
+		/**
+		 * The original file URI (undefined for new files).
+		 */
+		originalUri?: Uri;
+
+		/**
+		 * The modified file URI (undefined for deleted files).
+		 */
+		modifiedUri?: Uri;
+
+		/**
+		 * Optional URI to navigate to when clicking on the file.
+		 */
+		goToFileUri?: Uri;
+	}
 
+	/**
+	 * Represents a part of a chat response that shows multiple file diffs.
+	 */
+	export class ChatResponseMultiDiffPart {
+		/**
+		 * Array of file diff entries to display.
+		 */
+		value: ChatResponseDiffEntry[];
+
+		/**
+		 * The title for the multi diff editor.
+		 */
+		title: string;
+
+		/**
+		 * Create a new ChatResponseMultiDiffPart.
+		 * @param value Array of file diff entries.
+		 * @param title The title for the multi diff editor.
+		 */
+		constructor(value: ChatResponseDiffEntry[], title: string);
+	}
+
+	export type ExtendedChatResponsePart = ChatResponsePart | ChatResponseTextEditPart | ChatResponseNotebookEditPart | ChatResponseConfirmationPart | ChatResponseCodeCitationPart | ChatResponseReferencePart2 | ChatResponseMovePart | ChatResponseExtensionsPart | ChatResponsePullRequestPart | ChatPrepareToolInvocationPart | ChatToolInvocationPart | ChatResponseMultiDiffPart;
 	export class ChatResponseWarningPart {
 		value: MarkdownString;
 		constructor(value: string | MarkdownString);
@@ -171,6 +235,15 @@ declare module 'vscode' {
 		constructor(extensions: string[]);
 	}
 
+	export class ChatResponsePullRequestPart {
+		readonly uri: Uri;
+		readonly linkTag: string;
+		readonly title: string;
+		readonly description: string;
+		readonly author: string;
+		constructor(uri: Uri, title: string, description: string, author: string, linkTag: string);
+	}
+
 	export interface ChatResponseStream {
 
 		/**
@@ -205,7 +278,7 @@ declare module 'vscode' {
 		 * TODO@API should this be MarkdownString?
 		 * TODO@API should actually be a more generic function that takes an array of buttons
 		 */
-		confirmation(title: string, message: string, data: any, buttons?: string[]): void;
+		confirmation(title: string, message: string | MarkdownString, data: any, buttons?: string[]): void;
 
 		/**
 		 * Push a warning to this stream. Short-hand for
@@ -225,6 +298,8 @@ declare module 'vscode' {
 		prepareToolInvocation(toolName: string): void;
 
 		push(part: ExtendedChatResponsePart): void;
+
+		clearToPreviousToolInvocation(reason: ChatResponseClearToPreviousToolInvocationReason): void;
 	}
 
 	export enum ChatResponseReferencePartStatusKind {
@@ -233,6 +308,11 @@ declare module 'vscode' {
 		Omitted = 3
 	}
 
+	export enum ChatResponseClearToPreviousToolInvocationReason {
+		NoReason = 0,
+		FilteredContentRetry = 1,
+		CopyrightContentRetry = 2,
+	}
 
 	/**
 	 * Does this piggy-back on the existing ChatRequest, or is it a different type of request entirely?
@@ -258,6 +338,50 @@ declare module 'vscode' {
 		readonly tools: Map<string, boolean>;
 	}
 
+	export namespace lm {
+		/**
+		 * Fired when the set of tools on a chat request changes.
+		 */
+		export const onDidChangeChatRequestTools: Event<ChatRequest>;
+	}
+
+	export class LanguageModelToolExtensionSource {
+		/**
+		 * ID of the extension that published the tool.
+		 */
+		readonly id: string;
+
+		/**
+		 * Label of the extension that published the tool.
+		 */
+		readonly label: string;
+
+		private constructor(id: string, label: string);
+	}
+
+	export class LanguageModelToolMCPSource {
+		/**
+		 * Editor-configured label of the MCP server that published the tool.
+		 */
+		readonly label: string;
+
+		/**
+		 * Server-defined name of the MCP server.
+		 */
+		readonly name: string;
+
+		/**
+		 * Server-defined instructions for MCP tool use.
+		 */
+		readonly instructions?: string;
+
+		private constructor(label: string, name: string, instructions?: string);
+	}
+
+	export interface LanguageModelToolInformation {
+		source: LanguageModelToolExtensionSource | LanguageModelToolMCPSource | undefined;
+	}
+
 	// TODO@API fit this into the stream
 	export interface ChatUsedContext {
 		documents: ChatDocumentContext[];
@@ -307,6 +431,10 @@ declare module 'vscode' {
 			participant?: string;
 			command?: string;
 		};
+		/**
+		 * An optional detail string that will be rendered at the end of the response in certain UI contexts.
+		 */
+		details?: string;
 	}
 
 	export namespace chat {
@@ -401,6 +529,15 @@ declare module 'vscode' {
 		outcome: ChatEditingSessionActionOutcome;
 	}
 
+	export interface ChatEditingHunkAction {
+		// eslint-disable-next-line local/vscode-dts-string-type-literals
+		kind: 'chatEditingHunkAction';
+		uri: Uri;
+		lineCount: number;
+		outcome: ChatEditingSessionActionOutcome;
+		hasRemainingEdits: boolean;
+	}
+
 	export enum ChatEditingSessionActionOutcome {
 		Accepted = 1,
 		Rejected = 2,
@@ -409,7 +546,7 @@ declare module 'vscode' {
 
 	export interface ChatUserActionEvent {
 		readonly result: ChatResult;
-		readonly action: ChatCopyAction | ChatInsertAction | ChatApplyAction | ChatTerminalAction | ChatCommandAction | ChatFollowupAction | ChatBugReportAction | ChatEditorAction | ChatEditingSessionAction;
+		readonly action: ChatCopyAction | ChatInsertAction | ChatApplyAction | ChatTerminalAction | ChatCommandAction | ChatFollowupAction | ChatBugReportAction | ChatEditorAction | ChatEditingSessionAction | ChatEditingHunkAction;
 	}
 
 	export interface ChatPromptReference {

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

@@ -137,7 +137,31 @@ declare module 'vscode' {
 		/**
 		 * @hidden
 		 */
-		private constructor(prompt: string, command: string | undefined, references: ChatPromptReference[], participant: string, toolReferences: ChatLanguageModelToolReference[], editedFileEvents: ChatRequestEditedFileEvent[] | undefined);
+		constructor(prompt: string, command: string | undefined, references: ChatPromptReference[], participant: string, toolReferences: ChatLanguageModelToolReference[], editedFileEvents: ChatRequestEditedFileEvent[] | undefined);
+	}
+
+	export class ChatResponseTurn2 {
+		/**
+		 * The content that was received from the chat participant. Only the stream parts that represent actual content (not metadata) are represented.
+		 */
+		readonly response: ReadonlyArray<ChatResponseMarkdownPart | ChatResponseFileTreePart | ChatResponseAnchorPart | ChatResponseCommandButtonPart | ExtendedChatResponsePart | ChatToolInvocationPart>;
+
+		/**
+		 * The result that was received from the chat participant.
+		 */
+		readonly result: ChatResult;
+
+		/**
+		 * The id of the chat participant that this response came from.
+		 */
+		readonly participant: string;
+
+		/**
+		 * The name of the command that this response came from.
+		 */
+		readonly command?: string;
+
+		constructor(response: ReadonlyArray<ChatResponseMarkdownPart | ChatResponseFileTreePart | ChatResponseAnchorPart | ChatResponseCommandButtonPart | ExtendedChatResponsePart>, result: ChatResult, participant: string);
 	}
 
 	export interface ChatParticipant {
@@ -205,24 +229,6 @@ declare module 'vscode' {
 		presentation?: 'hidden' | undefined;
 	}
 
-	export interface LanguageModelTool<T> {
-		prepareInvocation2?(options: LanguageModelToolInvocationPrepareOptions<T>, token: CancellationToken): ProviderResult<PreparedTerminalToolInvocation>;
-	}
-
-	export class PreparedTerminalToolInvocation {
-		readonly command: string;
-		readonly language: string;
-		readonly confirmationMessages?: LanguageModelToolConfirmationMessages;
-		readonly presentation?: 'hidden' | undefined;
-
-		constructor(
-			command: string,
-			language: string,
-			confirmationMessages?: LanguageModelToolConfirmationMessages,
-			presentation?: 'hidden'
-		);
-	}
-
 	export class ExtendedLanguageModelToolResult extends LanguageModelToolResult {
 		toolResultMessage?: string | MarkdownString;
 		toolResultDetails?: Array<Uri | Location>;

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

@@ -47,9 +47,6 @@ declare module 'vscode' {
 	// TODO@API names: LanguageModelChatMetadata, LanguageModelChatItem
 	export interface LanguageModelChatInformation {
 
-		// TODO@API IMPLICT from package-json registration
-		// readonly vendor: string;
-
 		readonly id: string;
 
 		/**
@@ -128,15 +125,14 @@ declare module 'vscode' {
 		// NOT cacheable (between reloads)
 		prepareLanguageModelChat(options: { silent: boolean }, token: CancellationToken): ProviderResult<T[]>;
 
-		provideLanguageModelChatResponse(model: T, messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options: LanguageModelChatRequestHandleOptions, progress: Progress<LanguageModelTextPart | LanguageModelToolCallPart>, token: CancellationToken): Thenable<any>;
+		provideLanguageModelChatResponse(model: T, messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options: LanguageModelChatRequestHandleOptions, progress: Progress<ChatResponseFragment2>, token: CancellationToken): Thenable<any>;
 
 		provideTokenCount(model: T, text: string | LanguageModelChatMessage | LanguageModelChatMessage2, token: CancellationToken): Thenable<number>;
 	}
 
 	export namespace lm {
 
-		//
-		// export function registerChatModelProvider(vendor: string, provider: LanguageModelChatProvider2): Disposable;
+		export function registerChatModelProvider(vendor: string, provider: LanguageModelChatProvider2): Disposable;
 	}
 
 
@@ -145,101 +141,4 @@ declare module 'vscode' {
 		index: number;
 		part: LanguageModelTextPart | LanguageModelToolCallPart;
 	}
-
-
-	/**
-	 * Represents a large language model that accepts ChatML messages and produces a streaming response
-	*/
-	export interface LanguageModelChatProvider {
-
-		// TODO@API remove or keep proposed?
-		onDidReceiveLanguageModelResponse2?: Event<{ readonly extensionId: string; readonly participant?: string; readonly tokenCount?: number }>;
-
-		// TODO@API
-		// have dedicated options, don't reuse the LanguageModelChatRequestOptions so that consumer and provider part of the API can develop independently
-		provideLanguageModelResponse(messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options: LanguageModelChatRequestOptions, extensionId: string, progress: Progress<ChatResponseFragment2>, token: CancellationToken): Thenable<any>;
-
-		provideTokenCount(text: string | LanguageModelChatMessage | LanguageModelChatMessage2, token: CancellationToken): Thenable<number>;
-	}
-
-	export type ChatResponseProvider = LanguageModelChatProvider;
-
-	export interface ChatResponseProviderMetadata {
-
-		readonly vendor: string;
-
-		/**
-		 * Human-readable name of the language model.
-		 */
-		readonly name: string;
-		/**
-		 * Opaque family-name of the language model. Values might be `gpt-3.5-turbo`, `gpt4`, `phi2`, or `llama`
-		 * but they are defined by extensions contributing languages and subject to change.
-		 */
-		readonly family: string;
-
-		/**
-		 * An optional, human-readable description of the language model.
-		 */
-		readonly description?: string;
-
-		/**
-		 * An optional, human-readable string representing the cost of using the language model.
-		 */
-		readonly cost?: string;
-
-		/**
-		 * Opaque version string of the model. This is defined by the extension contributing the language model
-		 * and subject to change while the identifier is stable.
-		 */
-		readonly version: string;
-
-		readonly maxInputTokens: number;
-
-		readonly maxOutputTokens: number;
-
-		/**
-		 * When present, this gates the use of `requestLanguageModelAccess` behind an authorization flow where
-		 * the user must approve of another extension accessing the models contributed by this extension.
-		 * Additionally, the extension can provide a label that will be shown in the UI.
-		 */
-		auth?: true | { label: string };
-
-		// TODO@API maybe an enum, LanguageModelChatProviderPickerAvailability?
-		readonly isDefault?: boolean;
-		readonly isUserSelectable?: boolean;
-
-		readonly capabilities?: {
-			readonly vision?: boolean;
-
-			// TODO@API should be `boolean | number` so extensions can express how many tools they support
-			readonly toolCalling?: boolean;
-
-			// TODO@API WHY is agentMode a capability? This seems wrong?
-			readonly agentMode?: boolean;
-
-			// TODO@API support prompt TSX style messages
-			// readonly promptTsx?:boolean
-		};
-
-		/**
-		 * Optional category to group models by in the model picker.
-		 * The lower the order, the higher the category appears in the list.
-		 * Has no effect if `isUserSelectable` is `false`.
-		 * If not specified, the model will appear in the "Other Models" category.
-		 */
-		readonly category?: { label: string; order: number };
-	}
-
-	export interface ChatResponseProviderMetadata {
-		// limit this provider to some extensions
-		// TODO@API remove? unused?
-		extensions?: string[];
-	}
-
-	export namespace lm {
-
-		export function registerChatModelProvider(id: string, provider: LanguageModelChatProvider, metadata: ChatResponseProviderMetadata): Disposable;
-	}
-
 }

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

@@ -0,0 +1,129 @@
+/*---------------------------------------------------------------------------------------------
+ *  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' {
+	/**
+	 * Provides a list of information about chat sessions.
+	 */
+	export interface ChatSessionItemProvider {
+		/**
+		 * Event that the provider can fire to signal that chat sessions have changed.
+		 */
+		readonly onDidChangeChatSessionItems: Event<void>;
+
+		// /**
+		//  * Create a new chat session item
+		//  */
+		// provideNewChatSessionItem(context: {
+		// 	// This interface should be extracted
+		// 	readonly triggerChat?: {
+		// 		readonly prompt: string;
+		// 		readonly history: ReadonlyArray<ChatRequestTurn | ChatResponseTurn>;
+		// 	};
+		// }, token: CancellationToken): Thenable<ChatSessionItem> | ChatSessionItem;
+
+		/**
+		 * Provides a list of chat sessions.
+		 */
+		// TODO: Do we need a flag to try auth if needed?
+		provideChatSessionItems(token: CancellationToken): ProviderResult<ChatSessionItem[]>;
+	}
+
+	export interface ChatSessionItem {
+		/**
+		 * Unique identifier for the chat session.
+		 */
+		id: string;
+
+		/**
+		 * Human readable name of the session shown in the UI
+		 */
+		label: string;
+
+		/**
+		 * An icon for the participant shown in UI.
+		 */
+		iconPath?: IconPath;
+	}
+
+	export interface ChatSession {
+
+		/**
+		 * The full history of the session
+		 *
+		 * This should not include any currently active responses
+		 */
+		// TODO: Are these the right types to use?
+		// TODO: link request + response to encourage correct usage?
+		readonly history: ReadonlyArray<ChatRequestTurn | ChatResponseTurn2>;
+
+		/**
+		 * Callback invoked by the editor for a currently running response. This allows the session to push items for the
+		 * current response and stream these in as them come in. The current response will be considered complete once the
+		 * callback resolved.
+		 *
+		 * If not provided, the chat session is assumed to not currently be running.
+		 */
+		readonly activeResponseCallback?: (stream: ChatResponseStream, token: CancellationToken) => Thenable<void>;
+
+		/**
+		 * Handles new request for the session.
+		 *
+		 * If not set, then the session will be considered read-only and no requests can be made.
+		 */
+		// TODO: Should we introduce our own type for `ChatRequestHandler` since not all field apply to chat sessions?
+		readonly requestHandler: ChatRequestHandler | undefined;
+	}
+
+	export interface ChatSessionContentProvider {
+		/**
+		 * Resolves a chat session into a full `ChatSession` object.
+		 *
+		 * @param sessionId The id of the chat session to open.
+		 * @param token A cancellation token that can be used to cancel the operation.
+		 */
+		provideChatSessionContent(sessionId: string, token: CancellationToken): Thenable<ChatSession> | ChatSession;
+	}
+
+	export namespace chat {
+		/**
+		 * Registers a new {@link ChatSessionItemProvider chat session item provider}.
+		 *
+		 * To use this, also make sure to also add `chatSessions` contribution in the `package.json`.
+		 *
+		 * @param chatSessionType The type of chat session the provider is for.
+		 * @param provider The provider to register.
+		 *
+		 * @returns A disposable that unregisters the provider when disposed.
+		 */
+		export function registerChatSessionItemProvider(chatSessionType: string, provider: ChatSessionItemProvider): Disposable;
+
+		/**
+		 * Registers a new {@link ChatSessionContentProvider chat session content provider}.
+		 *
+		 * @param chatSessionType A unique identifier for the chat session type. This is used to differentiate between different chat session providers.
+		 * @param provider The provider to register.
+		 *
+		 * @returns A disposable that unregisters the provider when disposed.
+		 */
+		export function registerChatSessionContentProvider(chatSessionType: string, provider: ChatSessionContentProvider): Disposable;
+	}
+
+	export interface ChatSessionShowOptions {
+		/**
+		 * The editor view column to show the chat session in.
+		 *
+		 * If not provided, the chat session will be shown in the chat panel instead.
+		 */
+		readonly viewColumn?: ViewColumn;
+	}
+
+	export namespace window {
+		/**
+		 * Shows a chat session in the panel or editor.
+		 */
+		export function showChatSession(chatSessionType: string, sessionId: string, options: ChatSessionShowOptions): Thenable<void>;
+	}
+}

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

@@ -9,11 +9,13 @@ import "./vscode.proposed.authProviderSpecific.d.ts"
 import "./vscode.proposed.authSession.d.ts"
 import "./vscode.proposed.canonicalUriProvider.d.ts"
 import "./vscode.proposed.chatEditing.d.ts"
+import "./vscode.proposed.chatOutputRenderer.d.ts"
 import "./vscode.proposed.chatParticipantAdditions.d.ts"
 import "./vscode.proposed.chatParticipantPrivate.d.ts"
 import "./vscode.proposed.chatProvider.d.ts"
 import "./vscode.proposed.chatReferenceBinaryData.d.ts"
 import "./vscode.proposed.chatReferenceDiagnostic.d.ts"
+import "./vscode.proposed.chatSessionsProvider.d.ts"
 import "./vscode.proposed.chatStatusItem.d.ts"
 import "./vscode.proposed.chatTab.d.ts"
 import "./vscode.proposed.codeActionAI.d.ts"
@@ -50,6 +52,7 @@ import "./vscode.proposed.contribViewContainerTitle.d.ts"
 import "./vscode.proposed.contribViewsRemote.d.ts"
 import "./vscode.proposed.contribViewsWelcome.d.ts"
 import "./vscode.proposed.customEditorMove.d.ts"
+import "./vscode.proposed.dataChannels.d.ts"
 import "./vscode.proposed.debugVisualization.d.ts"
 import "./vscode.proposed.defaultChatParticipant.d.ts"
 import "./vscode.proposed.diffCommand.d.ts"
@@ -76,6 +79,7 @@ import "./vscode.proposed.ipc.d.ts"
 import "./vscode.proposed.languageModelCapabilities.d.ts"
 import "./vscode.proposed.languageModelDataPart.d.ts"
 import "./vscode.proposed.languageModelSystem.d.ts"
+import "./vscode.proposed.languageModelToolResultAudience.d.ts"
 import "./vscode.proposed.languageStatusText.d.ts"
 import "./vscode.proposed.mappedEditsProvider.d.ts"
 import "./vscode.proposed.multiDocumentHighlightProvider.d.ts"
@@ -102,14 +106,17 @@ import "./vscode.proposed.resolvers.d.ts"
 import "./vscode.proposed.scmActionButton.d.ts"
 import "./vscode.proposed.scmHistoryProvider.d.ts"
 import "./vscode.proposed.scmMultiDiffEditor.d.ts"
+import "./vscode.proposed.scmProviderOptions.d.ts"
 import "./vscode.proposed.scmSelectedProvider.d.ts"
 import "./vscode.proposed.scmTextDocument.d.ts"
 import "./vscode.proposed.scmValidation.d.ts"
+import "./vscode.proposed.secretStorageKeys.d.ts"
 import "./vscode.proposed.shareProvider.d.ts"
 import "./vscode.proposed.speech.d.ts"
 import "./vscode.proposed.statusBarItemTooltip.d.ts"
 import "./vscode.proposed.tabInputMultiDiff.d.ts"
 import "./vscode.proposed.tabInputTextMerge.d.ts"
+import "./vscode.proposed.taskExecutionTerminal.d.ts"
 import "./vscode.proposed.taskPresentationGroup.d.ts"
 import "./vscode.proposed.taskProblemMatcherStatus.d.ts"
 import "./vscode.proposed.telemetry.d.ts"

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

@@ -0,0 +1,19 @@
+/*---------------------------------------------------------------------------------------------
+ *  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 env {
+		export function getDataChannel<T>(channelId: string): DataChannel<T>;
+	}
+
+	export interface DataChannel<T = unknown> {
+		onDidReceiveData: Event<DataChannelEvent<T>>;
+	}
+
+	export interface DataChannelEvent<T> {
+		data: T;
+	}
+}

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

@@ -154,6 +154,8 @@ declare module 'vscode' {
 		readonly userPrompt?: string;
 
 		readonly requestUuid: string;
+
+		readonly requestIssuedDateTime: number;
 	}
 
 	export interface PartialAcceptInfo {

package/vscode-dts/vscode.proposed.languageModelToolResultAudience.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' {
+
+	export enum ToolResultAudience {
+		Assistant = 0,
+		User = 1,
+	}
+
+	/**
+	 * A language model response part containing a piece of text, returned from a {@link LanguageModelChatResponse}.
+	 */
+	export class LanguageModelTextPart2 extends LanguageModelTextPart {
+		audience: ToolResultAudience[] | undefined;
+		constructor(value: string, audience?: ToolResultAudience[]);
+	}
+
+	export class LanguageModelDataPart2 extends LanguageModelDataPart {
+		audience: ToolResultAudience[] | undefined;
+		constructor(data: Uint8Array, mimeType: string, audience?: ToolResultAudience[]);
+	}
+}

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

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------------------------
+ *  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/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;
+	}
+}