@codingame/monaco-vscode-api 30.0.1 → 31.0.0

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

@@ -3,19 +3,255 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
-// version: 1
+// version: 2
 
 declare module 'vscode' {
 	// #region Resource Classes
 
 	/**
-	 * Represents a chat-related resource, such as a custom agent, instructions, prompt file, or skill.
+	 * Indicates where a chat resource was loaded from.
+	 */
+	export type ChatResourceSource = 'local' | 'user' | 'extension' | 'plugin';
+
+	/**
+	 * Represents a chat-related resource, such as a custom agent, instructions, prompt file, skill, or slash command.
 	 */
 	export interface ChatResource {
 		/**
 		 * Uri to the chat resource. This is typically a `.agent.md`, `.instructions.md`, `.prompt.md`, or `SKILL.md` file.
 		 */
 		readonly uri: Uri;
+
+		/**
+		 * Optional condition that must evaluate to true for the resource to be offered.
+		 */
+		readonly when?: string;
+
+		/**
+		 * Optional session types that describe when the resource should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+	}
+
+	/**
+	 * Represents a custom chat agent resource.
+	 */
+	export interface ChatCustomAgent {
+		/**
+		 * Uri to the custom agent. This is typically a `.agent.md` file.
+		 */
+		readonly uri: Uri;
+
+		/**
+		 * Display name of the custom agent.
+		 */
+		readonly name: string;
+
+		/**
+		 * Optional description of the custom agent.
+		 */
+		readonly description?: string;
+
+		/**
+		 * Where the custom agent was loaded from.
+		 */
+		readonly source: ChatResourceSource;
+
+		/**
+		 * Optional session types that describe when the custom agent should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+
+		/**
+		 * The contributing extension identifier when {@link source} is `extension`.
+		 */
+		readonly extensionId?: string;
+
+		/**
+		 * The contributing plugin URI when {@link source} is `plugin`.
+		 */
+		readonly pluginUri?: Uri;
+
+		/**
+		 * Optional hint that describes what arguments the custom agent accepts.
+		 */
+		readonly argumentHint?: string;
+
+		/**
+		 * Optional tool restrictions declared by the custom agent.
+		 */
+		readonly tools?: readonly string[];
+
+		/**
+		 * Optional model preferences declared by the custom agent.
+		 */
+		readonly model?: readonly string[];
+
+		/**
+		 * Whether this custom agent should be shown to users as invocable.
+		 */
+		readonly userInvocable: boolean;
+
+		/**
+		 * Whether this custom agent should be excluded from model invocation.
+		 */
+		readonly disableModelInvocation: boolean;
+	}
+
+	/**
+	 * Represents an instruction file resource.
+	 */
+	export interface ChatInstruction {
+		/**
+		 * Uri to the instruction.
+		 */
+		readonly uri: Uri;
+
+		/**
+		 * Display name of the instruction.
+		 */
+		readonly name: string;
+
+		/**
+		 * Optional description of the instruction.
+		 */
+		readonly description?: string;
+
+		/**
+		 * Where the instruction was loaded from.
+		 */
+		readonly source: ChatResourceSource;
+
+		/**
+		 * Optional session types that describe when the instruction should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+
+		/**
+		 * The contributing extension identifier when {@link source} is `extension`.
+		 */
+		readonly extensionId?: string;
+
+		/**
+		 * The contributing plugin URI when {@link source} is `plugin`.
+		 */
+		readonly pluginUri?: Uri;
+
+		/**
+		 * The optional apply pattern used to scope the instruction.
+		 */
+		readonly pattern?: string;
+	}
+
+	/**
+	 * Represents a skill resource.
+	 */
+	export interface ChatSkill {
+		/**
+		 * Uri to the chat resource. This is typically a `.agent.md`, `.instructions.md`, `.prompt.md`, or `SKILL.md` file.
+		 */
+		readonly uri: Uri;
+
+		/**
+		 * Display name of the skill.
+		 */
+		readonly name: string;
+
+		/**
+		 * Optional description of the skill.
+		 */
+		readonly description?: string;
+
+		/**
+		 * Where the skill was loaded from.
+		 */
+		readonly source: ChatResourceSource;
+
+		/**
+		 * Optional session types that describe when the skill should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+
+		/**
+		 * The contributing extension identifier when {@link source} is `extension`.
+		 */
+		readonly extensionId?: string;
+
+		/**
+		 * The contributing plugin URI when {@link source} is `plugin`.
+		 */
+		readonly pluginUri?: Uri;
+
+		/**
+		 * Whether this skill should be shown to users as invocable.
+		 */
+		readonly userInvocable?: boolean;
+	}
+
+	/**
+	 * Represents a slash command resource.
+	 */
+	export interface ChatSlashCommand {
+		/**
+		 * Uri to the chat resource.
+		 */
+		readonly uri: Uri;
+
+		/**
+		 * Display name of the chat resource.
+		 */
+		readonly name: string;
+
+		/**
+		 * Optional description of the chat resource.
+		 */
+		readonly description?: string;
+
+		/**
+		 * Where the chat resource was loaded from.
+		 */
+		readonly source: ChatResourceSource;
+
+		/**
+		 * Optional session types that describe when the slash command should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+
+		/**
+		 * The contributing extension identifier when {@link source} is `extension`.
+		 */
+		readonly extensionId?: string;
+
+		/**
+		 * The contributing plugin URI when {@link source} is `plugin`.
+		 */
+		readonly pluginUri?: Uri;
+
+		/**
+		 * Optional hint that describes what arguments the slash command accepts.
+		 */
+		readonly argumentHint?: string;
+
+		/**
+		 * Whether this slash command should be shown to users as invocable.
+		 */
+		readonly userInvocable?: boolean;
+	}
+
+	export interface ChatHook {
+		readonly uri: Uri;
+		/**
+		 * Optional session types that describe when the hook should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
+	}
+
+	export interface ChatPlugin {
+		readonly uri: Uri;
+		/**
+		 * Optional session types that describe when the plugin should be offered.
+		 */
+		readonly sessionTypes?: readonly string[];
 	}
 
 	// #endregion
@@ -78,6 +314,28 @@ declare module 'vscode' {
 
 	// #endregion
 
+	// #region HookProvider
+
+	/**
+	 * A provider that supplies hook configuration resources (from hooks JSON files).
+	 */
+	export interface ChatHookProvider {
+		/**
+		 * An optional event to signal that hooks have changed.
+		 */
+		readonly onDidChangeHooks?: Event<void>;
+
+		/**
+		 * Provide the list of hook configuration files available.
+		 * @param context Context for the provide call.
+		 * @param token A cancellation token.
+		 * @returns An array of hook resources or a promise that resolves to such.
+		 */
+		provideHooks(context: unknown, token: CancellationToken): ProviderResult<ChatResource[]>;
+	}
+
+	// #endregion
+
 	// #region SkillProvider
 
 	/**
@@ -108,33 +366,76 @@ declare module 'vscode' {
 		 */
 		export const onDidChangeCustomAgents: Event<void>;
 
+
 		/**
-		 * The list of currently available custom agents. These are `.agent.md` files
+		 * Provide the list of currently available custom agents. These are `.agent.md` files
 		 * from all sources (workspace, user, and extension-provided).
+		 * @param token A cancellation token.
 		 */
-		export const customAgents: readonly ChatResource[];
+		export function getCustomAgents(token: CancellationToken): Thenable<readonly ChatCustomAgent[]>;
 
 		/**
 		 * An event that fires when the list of {@link instructions instructions} changes.
 		 */
 		export const onDidChangeInstructions: Event<void>;
 
+
 		/**
-		 * The list of currently available instructions. These are `.instructions.md` files
+		 * Provide the list of currently available instructions. These are `.instructions.md` files
 		 * from all sources (workspace, user, and extension-provided).
+		 * @param token A cancellation token.
 		 */
-		export const instructions: readonly ChatResource[];
+		export function getInstructions(token: CancellationToken): Thenable<readonly ChatInstruction[]>;
 
 		/**
 		 * An event that fires when the list of {@link skills skills} changes.
 		 */
 		export const onDidChangeSkills: Event<void>;
 
+
 		/**
-		 * The list of currently available skills. These are `SKILL.md` files
+		 * Provide the list of currently available skills. These are `SKILL.md` files
 		 * from all sources (workspace, user, and extension-provided).
+		 * @param token A cancellation token.
+		 */
+		export function getSkills(token: CancellationToken): Thenable<readonly ChatSkill[]>;
+
+		/**
+		 * An event that fires when the list of {@link slashCommands slash commands} changes.
+		 */
+		export const onDidChangeSlashCommands: Event<void>;
+
+
+		/**
+		 * Provide the list of currently available slash commands. These are `.prompt.md` files and
+		 * user-invocable `SKILL.md` files from all sources (workspace, user, and extension-provided).
+		 * @param token A cancellation token.
+		 */
+		export function getSlashCommands(token: CancellationToken): Thenable<readonly ChatSlashCommand[]>;
+
+		/**
+		 * An event that fires when the list of {@link hooks hooks} changes.
+		 */
+		export const onDidChangeHooks: Event<void>;
+
+
+		/**
+		 * Provide the list of currently available hook configuration files. These are JSON files that define lifecycle hooks from all sources (workspace, user, and extension-provided).
+		 * @param token A cancellation token.
 		 */
-		export const skills: readonly ChatResource[];
+		export function getHooks(token: CancellationToken): Thenable<readonly ChatHook[]>;
+
+		/**
+		 * An event that fires when the list of {@link plugins plugins} changes.
+		 */
+		export const onDidChangePlugins: Event<void>;
+
+
+		/**
+		 * Provide the list of currently installed agent plugins.
+		 * @param token A cancellation token.
+		 */
+		export function getPlugins(token: CancellationToken): Thenable<readonly ChatPlugin[]>;
 
 		/**
 		 * Register a provider for custom agents.
@@ -163,6 +464,13 @@ declare module 'vscode' {
 		 * @returns A disposable that unregisters the provider when disposed.
 		 */
 		export function registerSkillProvider(provider: ChatSkillProvider): Disposable;
+
+		/**
+		 * Register a provider for hooks.
+		 * @param provider The hook provider.
+		 * @returns A disposable that unregisters the provider when disposed.
+		 */
+		export function registerHookProvider(provider: ChatHookProvider): Disposable;
 	}
 
 	// #endregion

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

@@ -25,6 +25,8 @@ declare module 'vscode' {
 		static readonly Prompt: ChatSessionCustomizationType;
 		/** Hook customization (event-driven automation). */
 		static readonly Hook: ChatSessionCustomizationType;
+		/** Plugin customization (agent runtime plugins). */
+		static readonly Plugins: ChatSessionCustomizationType;
 
 		/**
 		 * The string identifier for this customization type.
@@ -56,11 +58,11 @@ declare module 'vscode' {
 		readonly iconId?: string;
 
 		/**
-		 * Customization types that this provider does **not** support.
-		 * The corresponding sections will be hidden in the management UI
-		 * when this provider is active.
+		 * Customization types that this provider supports.
+		 * Only the corresponding sections will be shown in the management UI
+		 * when this provider is active. When omitted, all sections are shown.
 		 */
-		readonly unsupportedTypes?: readonly ChatSessionCustomizationType[];
+		readonly supportedTypes?: readonly ChatSessionCustomizationType[];
 	}
 
 	/**

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

@@ -100,7 +100,12 @@ declare module 'vscode' {
 			readonly command?: string;
 		};
 
+		/**
+		 * @deprecated Use `inputState` instead
+		 */
 		readonly sessionOptions: ReadonlyArray<{ optionId: string; value: string | ChatSessionProviderOptionItem }>;
+
+		readonly inputState: ChatSessionInputState;
 	}
 
 	/**
@@ -108,6 +113,23 @@ declare module 'vscode' {
 	 */
 	export type ChatSessionItemControllerNewItemHandler = (context: ChatSessionItemControllerNewItemHandlerContext, token: CancellationToken) => Thenable<ChatSessionItem>;
 
+	/**
+	 * Extension callback invoked to get the input state for a chat session.
+	 *
+	 * @param sessionResource The resource of the chat session to get the input state for. `undefined` indicates this is
+	 * for a blank chat editor that is not yet associated with a session.
+	 * @param context Additional context
+	 * @param token Cancellation token.
+	 *
+	 * @return A new chat session input state. This should be created using {@link ChatSessionItemController.createChatSessionInputState}.
+	 */
+	export type ChatSessionControllerGetInputState = (sessionResource: Uri | undefined, context: {
+		/**
+		 * The previous input state for the session.
+		 */
+		readonly previousInputState: ChatSessionInputState | undefined;
+	}, token: CancellationToken) => Thenable<ChatSessionInputState> | ChatSessionInputState;
+
 	/**
 	 * Extension callback invoked to fork an existing chat session item managed by a {@linkcode ChatSessionItemController}.
 	 *
@@ -150,6 +172,11 @@ declare module 'vscode' {
 		 */
 		readonly refreshHandler: ChatSessionItemControllerRefreshHandler;
 
+		/**
+		 * Fired when an item's archived state changes.
+		 */
+		readonly onDidChangeChatSessionItemState: Event<ChatSessionItem>;
+
 		/**
 		 * Invoked when a new chat session is started.
 		 *
@@ -168,9 +195,14 @@ declare module 'vscode' {
 		forkHandler?: ChatSessionItemControllerForkHandler;
 
 		/**
-		 * Fired when an item's archived state changes.
+		 * Gets the input state for a chat session.
 		 */
-		readonly onDidChangeChatSessionItemState: Event<ChatSessionItem>;
+		getChatSessionInputState?: ChatSessionControllerGetInputState;
+
+		/**
+		 * Create a new managed ChatSessionInputState object.
+		 */
+		createChatSessionInputState(groups: ChatSessionProviderOptionGroup[]): ChatSessionInputState;
 	}
 
 	/**
@@ -311,7 +343,7 @@ declare module 'vscode' {
 		/**
 		 * Statistics about the chat session.
 		 */
-		changes?: readonly ChatSessionChangedFile[] | readonly ChatSessionChangedFile2[];
+		changes?: readonly ChatSessionChangedFile[];
 
 		/**
 		 * Arbitrary metadata for the chat session. Can be anything, but must be JSON-stringifyable.
@@ -322,30 +354,6 @@ declare module 'vscode' {
 	}
 
 	export class ChatSessionChangedFile {
-		/**
-		 * URI of the file.
-		 */
-		modifiedUri: Uri;
-
-		/**
-		 * File opened when the user takes the 'compare' action.
-		 */
-		originalUri?: Uri;
-
-		/**
-		 * Number of insertions made during the session.
-		 */
-		insertions: number;
-
-		/**
-		 * Number of deletions made during the session.
-		 */
-		deletions: number;
-
-		constructor(modifiedUri: Uri, insertions: number, deletions: number, originalUri?: Uri);
-	}
-
-	export class ChatSessionChangedFile2 {
 		/**
 		 * URI of the file.
 		 */
@@ -468,11 +476,15 @@ declare module 'vscode' {
 	 */
 	export interface ChatSessionContentProvider {
 		/**
+		 * @deprecated
+		 *
 		 * Event that the provider can fire to signal that the options for a chat session have changed.
 		 */
 		readonly onDidChangeChatSessionOptions?: Event<ChatSessionOptionChangeEvent>;
 
 		/**
+		 * @deprecated
+		 *
 		 * Event that the provider can fire to signal that the available provider options have changed.
 		 *
 		 * When fired, the editor will re-query {@link ChatSessionContentProvider.provideChatSessionProviderOptions}
@@ -492,10 +504,17 @@ declare module 'vscode' {
 		 * @return The {@link ChatSession chat session} associated with the given URI.
 		 */
 		provideChatSessionContent(resource: Uri, token: CancellationToken, context: {
+			readonly inputState: ChatSessionInputState;
+
+			/**
+			 * @deprecated Use `inputState` instead
+			 */
 			readonly sessionOptions: ReadonlyArray<{ optionId: string; value: string | ChatSessionProviderOptionItem }>;
 		}): Thenable<ChatSession> | ChatSession;
 
 		/**
+		 * @deprecated
+		 *
 		 * @param resource Identifier of the chat session being updated.
 		 * @param updates Collection of option identifiers and their new values. Only the options that changed are included.
 		 * @param token A cancellation token that can be used to cancel the notification if the session is disposed.
@@ -503,6 +522,8 @@ declare module 'vscode' {
 		provideHandleOptionsChange?(resource: Uri, updates: ReadonlyArray<ChatSessionOptionUpdate>, token: CancellationToken): void;
 
 		/**
+		 * @deprecated
+		 *
 		 * Called as soon as you register (call me once)
 		 */
 		provideChatSessionProviderOptions?(token: CancellationToken): Thenable<ChatSessionProviderOptions>;
@@ -546,8 +567,15 @@ declare module 'vscode' {
 		/**
 		 * The initial option selections for the session, provided with the first request.
 		 * Contains the options the user selected (or defaults) before the session was created.
+		 *
+		 * @deprecated Use `inputState` instead
 		 */
 		readonly initialSessionOptions?: ReadonlyArray<{ optionId: string; value: string | ChatSessionProviderOptionItem }>;
+
+		/**
+		 * The current input state of the chat session.
+		 */
+		readonly inputState: ChatSessionInputState;
 	}
 
 	export interface ChatSessionCapabilities {
@@ -614,10 +642,15 @@ declare module 'vscode' {
 		 */
 		readonly description?: string;
 
+		/**
+		 * The currently selected option for this group. This must be one of the items provided in the `items` array.
+		 */
+		readonly selected?: ChatSessionProviderOptionItem;
+
 		/**
 		 * The selectable items within this option group.
 		 */
-		readonly items: ChatSessionProviderOptionItem[];
+		readonly items: readonly ChatSessionProviderOptionItem[];
 
 		/**
 		 * A context key expression that controls when this option group picker is visible.
@@ -629,31 +662,20 @@ declare module 'vscode' {
 		 */
 		readonly when?: string;
 
-		/**
-		 * When true, displays a searchable QuickPick with a "See more..." option.
-		 * Recommended for option groups with additional async items (e.g., repositories).
-		 */
-		readonly searchable?: boolean;
-
 		/**
 		 * An icon for the option group shown in UI.
 		 */
 		readonly icon?: ThemeIcon;
 
-		/**
-		 * Handler for dynamic search when `searchable` is true.
-		 * Called when the user types in the searchable QuickPick or clicks "See more..." to load additional items.
-		 *
-		 * @param query The search query entered by the user. Empty string for initial load.
-		 * @param token A cancellation token.
-		 * @returns Additional items to display in the searchable QuickPick.
-		 */
-		readonly onSearch?: (query: string, token: CancellationToken) => Thenable<ChatSessionProviderOptionItem[]>;
-
 		/**
 		 * Optional commands.
 		 *
 		 * These commands will be displayed at the bottom of the group.
+		 *
+		 * For extensions using the legacy `commands` API, these commands are passed the sessionResource as the first argument.
+		 *
+		 * For extensions that use the new `provideChatSessionInputState` API, these commands are passed a context object
+		 * `{ inputState: ChatSessionInputState; sessionResource: Uri | undefined }` that they can use to determine which session and options they are being invoked for.
 		 */
 		readonly commands?: Command[];
 	}
@@ -672,4 +694,30 @@ declare module 'vscode' {
 		 */
 		readonly newSessionOptions?: Record<string, string | ChatSessionProviderOptionItem>;
 	}
+
+	/**
+	 * Represents the current state of user inputs for a chat session.
+	 */
+	export interface ChatSessionInputState {
+		/**
+		 * Fired when the input state is changed by the user.
+		 *
+		 * Move to controller?
+		 */
+		readonly onDidChange: Event<void>;
+
+		/**
+		 * The resource associated with this chat session.
+		 *
+		 * This is `undefined` for chat sessions that have not yet started.
+		 */
+		readonly sessionResource: Uri | undefined;
+
+		/**
+		 * The groups of options to show in the UI for user input.
+		 *
+		 * To update the groups you must replace the entire `groups` array with a new array.
+		 */
+		groups: readonly ChatSessionProviderOptionGroup[];
+	}
 }

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

@@ -77,9 +77,12 @@ declare module 'vscode' {
 		 * when the last gateway is disposed. The gateway dynamically tracks server
 		 * additions and removals via {@link McpGateway.onDidChangeServers}.
 		 *
+		 * @param chatSessionResource Optional chat session resource URI to associate with this
+		 * gateway. When provided, MCP tool calls made through this gateway will be associated
+		 * with the chat session, enabling inline elicitation UI in the chat response.
 		 * @returns A promise that resolves to an {@link McpGateway} if successful,
 		 * or `undefined` if no Node process is available (e.g., in serverless web environments).
 		 */
-		export function startMcpGateway(): Thenable<McpGateway | undefined>;
+		export function startMcpGateway(chatSessionResource?: Uri): Thenable<McpGateway | undefined>;
 	}
 }

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

@@ -10,13 +10,22 @@ declare module 'vscode' {
 	export interface LanguageModelToolConfirmationMessages {
 		/**
 		 * When set, a button will be shown allowing the user to approve this particular
-		 * combination of tool and arguments. The value is shown as the label for the
-		 * approval option.
+		 * combination of tool and arguments.
 		 *
-		 * For example, a tool that reads files could set this to `"Allow reading 'foo.txt'"`,
+		 * For example, a tool that reads files could set this to
+		 * `{ message: "Allow reading 'foo.txt'", arguments: JSON.stringify({ file: 'foo.txt' }) }`,
 		 * so that the user can approve that specific file without approving all invocations
 		 * of the tool.
 		 */
-		approveCombination?: string | MarkdownString;
+		approveCombination?: {
+			/**
+			 * The label shown for the approval option.
+			 */
+			message: string | MarkdownString;
+			/**
+			 * A string representation of the arguments that can be shown to the user.
+			 */
+			arguments?: string;
+		};
 	}
 }