@codingame/monaco-vscode-api 18.3.1 → 19.0.0

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

@@ -5,10 +5,6 @@
 
 declare module 'vscode' {
 
-	export interface ChatResponseFragment2 {
-		index: number;
-		part: LanguageModelTextPart | LanguageModelToolCallPart;
-	}
 
 	// @API extension ship a d.ts files for their options
 
@@ -16,19 +12,141 @@ declare module 'vscode' {
 	// concrete models. The `provideLanguageModelChatData` would do the discovery and auth dances and later
 	// the model data is passed to the concrete function for making a requested or counting token
 
-	export interface LanguageModelChatData {
-		// like ChatResponseProviderMetadata
+
+	// TODO@API name scheme
+	export interface LanguageModelChatRequestHandleOptions {
+
+		// initiator
+		readonly extensionId: string;
+
+		/**
+		 * A set of options that control the behavior of the language model. These options are specific to the language model
+		 * and need to be looked up in the respective documentation.
+		 */
+		readonly modelOptions: { [name: string]: any };
+
+		/**
+		 * An optional list of tools that are available to the language model. These could be registered tools available via
+		 * {@link lm.tools}, or private tools that are just implemented within the calling extension.
+		 *
+		 * If the LLM requests to call one of these tools, it will return a {@link LanguageModelToolCallPart} in
+		 * {@link LanguageModelChatResponse.stream}. It's the caller's responsibility to invoke the tool. If it's a tool
+		 * registered in {@link lm.tools}, that means calling {@link lm.invokeTool}.
+		 *
+		 * Then, the tool result can be provided to the LLM by creating an Assistant-type {@link LanguageModelChatMessage} with a
+		 * {@link LanguageModelToolCallPart}, followed by a User-type message with a {@link LanguageModelToolResultPart}.
+		 */
+		tools?: LanguageModelChatTool[];
+
+		/**
+		 * 	The tool-selecting mode to use. {@link LanguageModelChatToolMode.Auto} by default.
+		 */
+		toolMode?: LanguageModelChatToolMode;
+	}
+
+	// TODO@API names: LanguageModelChatMetadata, LanguageModelChatItem
+	export interface LanguageModelChatInformation {
+
+		// TODO@API IMPLICT from package-json registration
+		// readonly vendor: string;
+
+		readonly id: 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?
+		// TODO@API isPreselected proposed
+		readonly isDefault?: boolean;
+
+		// TODO@API nuke
+		readonly isUserSelectable?: boolean;
+
+		readonly capabilities?: {
+
+			// TODO@API have mimeTypes that you support
+			readonly vision?: boolean;
+
+			// TODO@API should be `boolean | number` so extensions can express how many tools they support
+			readonly toolCalling?: boolean | number;
+
+			// TODO@API DO NOT SUPPORT THIS
+			// readonly agentMode?: boolean;
+
+			// TODO@API support prompt TSX style messages, MAYBE leave it out for now
+			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 LanguageModelChatProvider2 {
+	export interface LanguageModelChatProvider2<T extends LanguageModelChatInformation = LanguageModelChatInformation> {
 
-		provideLanguageModelChatData(options: { force: boolean }, token: CancellationToken): ProviderResult<LanguageModelChatData[]>;
+		// signals a change from the provider to the editor so that prepareLanguageModelChat is called again
+		onDidChange?: Event<void>;
 
-		provideResponse(model: LanguageModelChatData, messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options: LanguageModelChatRequestOptions, extensionId: string, progress: Progress<ChatResponseFragment2>, token: CancellationToken): Thenable<any>;
+		// NOT cacheable (between reloads)
+		prepareLanguageModelChat(options: { silent: boolean }, token: CancellationToken): ProviderResult<T[]>;
 
-		provideTokenCount(model: LanguageModelChatData, text: string | LanguageModelChatMessage | LanguageModelChatMessage2, token: CancellationToken): Thenable<number>;
+		provideLanguageModelChatResponse(model: T, messages: Array<LanguageModelChatMessage | LanguageModelChatMessage2>, options: LanguageModelChatRequestHandleOptions, progress: Progress<LanguageModelTextPart | LanguageModelToolCallPart>, 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 interface ChatResponseFragment2 {
+		index: number;
+		part: LanguageModelTextPart | LanguageModelToolCallPart;
+	}
+
+
 	/**
 	 * Represents a large language model that accepts ChatML messages and produces a streaming response
 	*/
@@ -37,6 +155,8 @@ declare module 'vscode' {
 		// 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>;
@@ -88,10 +208,18 @@ declare module 'vscode' {
 		// 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
 		};
 
 		/**
@@ -105,6 +233,7 @@ declare module 'vscode' {
 
 	export interface ChatResponseProviderMetadata {
 		// limit this provider to some extensions
+		// TODO@API remove? unused?
 		extensions?: string[];
 	}
 

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

@@ -5,6 +5,7 @@ import "./vscode.proposed.aiSettingsSearch.d.ts"
 import "./vscode.proposed.aiTextSearchProvider.d.ts"
 import "./vscode.proposed.authIssuers.d.ts"
 import "./vscode.proposed.authLearnMore.d.ts"
+import "./vscode.proposed.authProviderSpecific.d.ts"
 import "./vscode.proposed.authSession.d.ts"
 import "./vscode.proposed.canonicalUriProvider.d.ts"
 import "./vscode.proposed.chatEditing.d.ts"
@@ -69,7 +70,6 @@ import "./vscode.proposed.findTextInFiles2.d.ts"
 import "./vscode.proposed.fsChunks.d.ts"
 import "./vscode.proposed.idToken.d.ts"
 import "./vscode.proposed.inlineCompletionsAdditions.d.ts"
-import "./vscode.proposed.inlineEdit.d.ts"
 import "./vscode.proposed.interactive.d.ts"
 import "./vscode.proposed.interactiveWindow.d.ts"
 import "./vscode.proposed.ipc.d.ts"
@@ -97,6 +97,7 @@ import "./vscode.proposed.quickDiffProvider.d.ts"
 import "./vscode.proposed.quickInputButtonLocation.d.ts"
 import "./vscode.proposed.quickPickItemTooltip.d.ts"
 import "./vscode.proposed.quickPickSortByLabel.d.ts"
+import "./vscode.proposed.remoteCodingAgents.d.ts"
 import "./vscode.proposed.resolvers.d.ts"
 import "./vscode.proposed.scmActionButton.d.ts"
 import "./vscode.proposed.scmHistoryProvider.d.ts"
@@ -121,6 +122,7 @@ import "./vscode.proposed.terminalSelection.d.ts"
 import "./vscode.proposed.terminalShellEnv.d.ts"
 import "./vscode.proposed.testObserver.d.ts"
 import "./vscode.proposed.testRelatedCode.d.ts"
+import "./vscode.proposed.textDocumentChangeReason.d.ts"
 import "./vscode.proposed.textEditorDiffInformation.d.ts"
 import "./vscode.proposed.textSearchComplete2.d.ts"
 import "./vscode.proposed.textSearchProvider.d.ts"

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

@@ -29,6 +29,10 @@ declare module 'vscode' {
 		provideChatTitle(context: ChatContext, token: CancellationToken): ProviderResult<string>;
 	}
 
+	export interface ChatSummarizer {
+		provideChatSummary(context: ChatContext, token: CancellationToken): ProviderResult<string>;
+	}
+
 	export interface ChatParticipant {
 		/**
 		 * A string that will be added before the listing of chat participants in `/help`.
@@ -47,6 +51,7 @@ declare module 'vscode' {
 
 		additionalWelcomeMessage?: string | MarkdownString;
 		titleProvider?: ChatTitleProvider;
+		summarizer?: ChatSummarizer;
 		requester?: ChatRequesterInformation;
 	}
 }

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

@@ -64,6 +64,10 @@ declare module 'vscode' {
 		 * If some inline completion provider registered by such an extension returns a result, this provider is not asked.
 		 */
 		yieldTo?: string[];
+		/**
+		 * Can override the extension id for the yieldTo mechanism. Used for testing, so that yieldTo can be tested within one extension.
+		*/
+		groupId?: string;
 
 		debounceDelayMs?: number;
 
@@ -92,13 +96,16 @@ declare module 'vscode' {
 		// eslint-disable-next-line local/vscode-dts-provider-naming
 		handleEndOfLifetime?(completionItem: InlineCompletionItem, reason: InlineCompletionEndOfLifeReason): void;
 
+		/**
+		 * Is called when an inline completion list is no longer being used (same reference as the list returned by provideInlineEditsForRange).
+		*/
+		// eslint-disable-next-line local/vscode-dts-provider-naming
+		handleListEndOfLifetime?(list: InlineCompletionList, reason: InlineCompletionsDisposeReason): void;
+
 		onDidChange?: Event<void>;
 
 		// #region Deprecated methods
 
-		/** @deprecated */
-		provideInlineEditsForRange?(document: TextDocument, range: Range, context: InlineCompletionContext, token: CancellationToken): ProviderResult<InlineCompletionItem[] | InlineCompletionList>;
-
 		/**
 		 * Is called when an inline completion item was accepted partially.
 		 * @param acceptedLength The length of the substring of the inline completion that was accepted already.
@@ -133,6 +140,16 @@ declare module 'vscode' {
 		userTypingDisagreed: boolean;
 	};
 
+	export enum InlineCompletionsDisposeReasonKind {
+		Other = 0,
+		Empty = 1,
+		TokenCancellation = 2,
+		LostRace = 3,
+		NotTaken = 4,
+	}
+
+	export type InlineCompletionsDisposeReason = { kind: InlineCompletionsDisposeReasonKind };
+
 	export interface InlineCompletionContext {
 		readonly userPrompt?: string;
 
@@ -159,7 +176,7 @@ declare module 'vscode' {
 		/**
 		 * A list of commands associated with the inline completions of this list.
 		 */
-		commands?: Command[];
+		commands?: Array<Command | { command: Command; icon: ThemeIcon }>;
 
 		/**
 		 * When set and the user types a suggestion without deviating from it, the inline suggestion is not updated.

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

@@ -68,6 +68,7 @@ declare module 'vscode' {
 		 * @param data Binary image data
 		 * @param mimeType The MIME type of the image
 		 */
+		// TODO@API just use string, no enum required
 		static image(data: Uint8Array, mimeType: ChatImageMimeType): LanguageModelDataPart;
 
 		static json(value: any, mime?: string): LanguageModelDataPart;

package/vscode-dts/vscode.proposed.remoteCodingAgents.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 for coding agent contribution point from core
+
+// @joshspicer

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

@@ -66,6 +66,8 @@ declare module 'vscode' {
 		Option = 5,
 		OptionValue = 6,
 		Flag = 7,
+		SymbolicLinkFile = 8,
+		SymbolicLinkFolder = 9,
 	}
 
 	export interface TerminalCompletionContext {

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

@@ -0,0 +1,30 @@
+/*---------------------------------------------------------------------------------------------
+ *  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' {
+
+	/**
+	 * Detailed information about why a text document changed.
+	 */
+	export interface TextDocumentDetailedChangeReason {
+		/**
+		 * The source of the change (e.g., 'inline-completion', 'chat-edit', 'extension')
+		 */
+		readonly source: string;
+
+		/**
+		 * Additional context-specific metadata
+		 */
+		readonly metadata: { readonly [key: string]: any };
+	}
+
+	export interface TextDocumentChangeEvent {
+		/**
+		 * The precise reason for the document change.
+		 * Only available to extensions that have enabled the `textDocumentChangeReason` proposed API.
+		 */
+		readonly detailedReason: TextDocumentDetailedChangeReason | undefined;
+	}
+}

package/workbench.d.ts

@@ -1,5 +1,5 @@
 import { type IAnyWorkspaceIdentifier } from "./vscode/src/vs/platform/workspace/common/workspace.js";
-import type { IWorkbenchConstructionOptions } from "@codingame/monaco-vscode-fab30422-b487-5f4e-8d30-8b4d266e3fcd-common/vscode/vs/workbench/browser/web.api";
+import type { IWorkbenchConstructionOptions } from "@codingame/monaco-vscode-c465110a-57c0-59d7-a6b2-be0a4db7e517-common/vscode/vs/workbench/browser/web.api";
 import { URI } from "./vscode/src/vs/base/common/uri.js";
 export interface EnvironmentOverride {
     userHome?: URI;

package/vscode/src/vs/base/browser/domImpl/domObservable.d.ts

@@ -1,3 +0,0 @@
-import { IDisposable } from "../../common/lifecycle.js";
-import { IObservable } from "../../common/observable.js";
-export declare function createStyleSheetFromObservable(css: IObservable<string>): IDisposable;

package/vscode/src/vs/base/browser/domImpl/domObservable.js

@@ -1,16 +0,0 @@
-
-import { DisposableStore } from '../../common/lifecycle.js';
-import '../../common/observableInternal/index.js';
-import { createStyleSheet2 } from '../domStylesheets.js';
-import { autorun } from '../../common/observableInternal/reactions/autorun.js';
-
-function createStyleSheetFromObservable(css) {
-    const store = ( new DisposableStore());
-    const w = store.add(createStyleSheet2());
-    store.add(autorun(reader => {
-        w.setStyle(css.read(reader));
-    }));
-    return store;
-}
-
-export { createStyleSheetFromObservable };

package/vscode/src/vs/base/browser/domImpl/n.d.ts

@@ -1,83 +0,0 @@
-import { DisposableStore, IDisposable } from "../../common/lifecycle.js";
-import { IObservable, IReader } from "../../common/observable.js";
-export declare namespace n {
-    const div: DomCreateFn<HTMLDivElement, HTMLDivElement>;
-    const elem: DomTagCreateFn<HTMLElementTagNameMap>;
-    const svg: DomCreateFn<SVGElementTagNameMap2["svg"], SVGElement>;
-    const svgElem: DomTagCreateFn<SVGElementTagNameMap2>;
-    function ref<T = Element>(): IRefWithVal<T>;
-}
-type Value<T> = T | IObservable<T>;
-type ValueOrList<T> = Value<T> | ValueOrList<T>[];
-type ValueOrList2<T> = ValueOrList<T> | ValueOrList<ValueOrList<T>>;
-type Element = HTMLElement | SVGElement;
-type SVGElementTagNameMap2 = {
-    svg: SVGElement & {
-        width: number;
-        height: number;
-        transform: string;
-        viewBox: string;
-        fill: string;
-    };
-    path: SVGElement & {
-        d: string;
-        stroke: string;
-        fill: string;
-    };
-    linearGradient: SVGElement & {
-        id: string;
-        x1: string | number;
-        x2: string | number;
-    };
-    stop: SVGElement & {
-        offset: string;
-    };
-    rect: SVGElement & {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-        fill: string;
-    };
-    defs: SVGElement;
-};
-type DomTagCreateFn<TMap extends Record<string, any>> = <TTag extends keyof TMap>(tag: TTag, attributes: ElementAttributeKeys<TMap[TTag]> & {
-    class?: ValueOrList<string | false | undefined>;
-    ref?: IRef<TMap[TTag]>;
-    obsRef?: IRef<ObserverNodeWithElement<TMap[TTag]> | null>;
-}, children?: ChildNode) => ObserverNode<TMap[TTag]>;
-type DomCreateFn<TAttributes, TResult extends Element> = (attributes: ElementAttributeKeys<TAttributes> & {
-    class?: ValueOrList<string | false | undefined>;
-    ref?: IRef<TResult>;
-    obsRef?: IRef<ObserverNodeWithElement<TResult> | null>;
-}, children?: ChildNode) => ObserverNode<TResult>;
-export type ChildNode = ValueOrList2<Element | string | ObserverNode | undefined>;
-export type IRef<T> = (value: T) => void;
-export interface IRefWithVal<T> extends IRef<T> {
-    readonly element: T;
-}
-export declare abstract class ObserverNode<T extends Element = Element> {
-    private readonly _deriveds;
-    protected readonly _element: T;
-    constructor(tag: string, ref: IRef<T> | undefined, obsRef: IRef<ObserverNodeWithElement<T> | null> | undefined, ns: string | undefined, className: ValueOrList<string | undefined | false> | undefined, attributes: ElementAttributeKeys<T>, children: ChildNode);
-    readEffect(reader: IReader | undefined): void;
-    keepUpdated(store: DisposableStore): ObserverNodeWithElement<T>;
-    toDisposableLiveElement(): LiveElement<T>;
-}
-export declare class LiveElement<T extends Element = HTMLElement> {
-    readonly element: T;
-    private readonly _disposable;
-    constructor(element: T, _disposable: IDisposable);
-    dispose(): void;
-}
-export declare class ObserverNodeWithElement<T extends Element = Element> extends ObserverNode<T> {
-    get element(): T;
-    private _isHovered;
-    get isHovered(): IObservable<boolean>;
-    private _didMouseMoveDuringHover;
-    get didMouseMoveDuringHover(): IObservable<boolean>;
-}
-type ElementAttributeKeys<T> = Partial<{
-    [K in keyof T]: T[K] extends Function ? never : T[K] extends object ? ElementAttributeKeys<T[K]> : Value<number | T[K] | undefined | null>;
-}>;
-export {};