@codingame/monaco-vscode-chat-service-override 20.1.1 → 20.2.0

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/slash.d.ts

@@ -1,6 +1,19 @@
 import { SimpleToken } from "./simpleToken.js";
+/**
+ * A token that represent a `/` with a `range`. The `range`
+ * value reflects the position of the token in the original data.
+ */
 export declare class Slash extends SimpleToken<"/"> {
+    /**
+     * The underlying symbol of the token.
+     */
     static readonly symbol: "/";
+    /**
+     * Return text representation of the token.
+     */
     get text(): "/";
+    /**
+     * Returns a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/space.d.ts

@@ -1,6 +1,19 @@
 import { SpacingToken } from "./simpleToken.js";
+/**
+ * A token that represent a `space` with a `range`. The `range`
+ * value reflects the position of the token in the original data.
+ */
 export declare class Space extends SpacingToken<" "> {
+    /**
+     * The underlying symbol of the `Space` token.
+     */
     static readonly symbol: " ";
+    /**
+     * Return text representation of the token.
+     */
     get text(): " ";
+    /**
+     * Returns a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/tab.d.ts

@@ -1,6 +1,19 @@
 import { SpacingToken } from "./simpleToken.js";
+/**
+ * A token that represent a `tab` with a `range`. The `range`
+ * value reflects the position of the token in the original data.
+ */
 export declare class Tab extends SpacingToken<"\t"> {
+    /**
+     * The underlying symbol of the token.
+     */
     static readonly symbol: "\t";
+    /**
+     * Return text representation of the token.
+     */
     get text(): "\t";
+    /**
+     * Returns a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/verticalTab.d.ts

@@ -1,6 +1,19 @@
 import { SpacingToken } from "./simpleToken.js";
+/**
+ * Token that represent a `vertical tab` with a `range`. The `range`
+ * value reflects the position of the token in the original data.
+ */
 export declare class VerticalTab extends SpacingToken<"\v"> {
+    /**
+     * The underlying symbol of the `VerticalTab` token.
+     */
     static readonly symbol: "\v";
+    /**
+     * Return text representation of the token.
+     */
     get text(): "\v";
+    /**
+     * Returns a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/word.d.ts

@@ -1,9 +1,32 @@
 import { BaseToken } from "../../baseToken.js";
 import { Line } from "../../linesCodec/tokens/line.js";
 import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * A token that represent a word - a set of continuous
+ * characters without stop characters, like a `space`,
+ * a `tab`, or a `new line`.
+ */
 export declare class Word<TText extends string = string> extends BaseToken<TText> {
+    /**
+     * The string value of the word.
+     */
     readonly text: TText;
-    constructor(range: Range, text: TText);
+    constructor(
+    /**
+     * The word range.
+     */
+    range: Range, 
+    /**
+     * The string value of the word.
+     */
+    text: TText);
+    /**
+     * Create new `Word` token with the given `text` and the range
+     * inside the given `Line` at the specified `column number`.
+     */
     static newOnLine(text: string, line: Line | number, atColumnNumber: number): Word;
+    /**
+     * Returns a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/textToken.d.ts

@@ -1,5 +1,9 @@
 import { type BaseToken } from "./baseToken.js";
 import { CompositeToken } from "./compositeToken.js";
+/**
+ * Tokens that represent a sequence of tokens that does not
+ * hold an additional meaning in the text.
+ */
 export declare class Text<TTokens extends readonly BaseToken[] = readonly BaseToken[]> extends CompositeToken<TTokens> {
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/utils/objectStream.d.ts

@@ -1,16 +1,44 @@
 import { CancellationToken } from "@codingame/monaco-vscode-api/vscode/vs/base/common/cancellation";
 import { ObservableDisposable } from "../../../utils/observableDisposable.js";
 import { ReadableStream } from "@codingame/monaco-vscode-api/vscode/vs/base/common/stream";
+/**
+ * A readable stream of provided objects.
+ */
 export declare class ObjectStream<T extends object> extends ObservableDisposable implements ReadableStream<T> {
     private readonly data;
     private readonly cancellationToken?;
+    /**
+     * Flag that indicates whether the stream has ended.
+     */
     private ended;
+    /**
+     * Underlying writable stream instance.
+     */
     private readonly stream;
+    /**
+     * Interval reference that is used to periodically send
+     * objects to the stream in the background.
+     */
     private timeoutHandle;
     constructor(data: Generator<T, undefined>, cancellationToken?: CancellationToken | undefined);
+    /**
+     * Starts process of sending data to the stream.
+     *
+     * @param stopAfterFirstSend whether to continue sending data to the stream
+     *             or stop sending after the first batch of data is sent instead
+     */
     send(stopAfterFirstSend?: boolean): void;
+    /**
+     * Stop the data sending loop.
+     */
     stopStream(): this;
+    /**
+     * Sends a provided number of objects to the stream.
+     */
     private sendData;
+    /**
+     * Ends the stream and stops sending data objects.
+     */
     private end;
     pause(): void;
     resume(): void;
@@ -19,7 +47,16 @@ export declare class ObjectStream<T extends object> extends ObservableDisposable
     on(event: "data", callback: (data: T) => void): void;
     on(event: "error", callback: (err: Error) => void): void;
     on(event: "end", callback: () => void): void;
+    /**
+     * Cleanup send interval and destroy the stream.
+     */
     dispose(): void;
+    /**
+     * Create new instance of the stream from a provided array.
+     */
     static fromArray<T extends object>(array: T[], cancellationToken?: CancellationToken): ObjectStream<T>;
 }
+/**
+ * Create a generator out of a provided array.
+ */
 export declare function arrayToGenerator<T extends NonNullable<unknown>>(array: T[]): Generator<T, undefined>;

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/utils/objectStreamFromTextModel.d.ts

@@ -2,4 +2,7 @@ import { ITextModel } from "@codingame/monaco-vscode-api/vscode/vs/editor/common
 import { ObjectStream } from "./objectStream.js";
 import { VSBuffer } from "@codingame/monaco-vscode-api/vscode/vs/base/common/buffer";
 import { CancellationToken } from "@codingame/monaco-vscode-api/vscode/vs/base/common/cancellation";
+/**
+ * Create new instance of the stream from a provided text model.
+ */
 export declare function objectStreamFromTextModel(model: ITextModel, cancellationToken?: CancellationToken): ObjectStream<VSBuffer>;

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/chatPromptCodec.d.ts

@@ -1,12 +1,42 @@
 import { VSBuffer } from "@codingame/monaco-vscode-api/vscode/vs/base/common/buffer";
 import { ReadableStream } from "@codingame/monaco-vscode-api/vscode/vs/base/common/stream";
 import { ChatPromptDecoder, TChatPromptToken } from "./chatPromptDecoder.js";
+/**
+ * A codec is an object capable of encoding/decoding a stream of data transforming its messages.
+ * Useful for abstracting a data transfer or protocol logic on top of a stream of bytes.
+ *
+ * For instance, if protocol messages need to be transferred over `TCP` connection, a codec that
+ * encodes the messages into a sequence of bytes before sending it to a network socket. Likewise,
+ * on the other end of the connection, the same codec can decode the sequence of bytes back into
+ * a sequence of the protocol messages.
+ */
 export interface ICodec<T, K> {
+    /**
+     * Encode a stream of `K`s into a stream of `T`s.
+     */
     encode: (value: ReadableStream<K>) => ReadableStream<T>;
+    /**
+     * Decode a stream of `T`s into a stream of `K`s.
+     */
     decode: (value: ReadableStream<T>) => ReadableStream<K>;
 }
+/**
+ * `ChatPromptCodec` type is a `ICodec<T, K>` with specific types for
+ * stream messages and return types of the `encode`/`decode` functions.
+ * @see {@link ICodec}
+ */
 interface IChatPromptCodec extends ICodec<VSBuffer, TChatPromptToken> {
+    /**
+     * Decode a stream of `VSBuffer`s into a stream of `TChatPromptToken`s.
+     *
+     * @see {@link TChatPromptToken}
+     * @see {@link VSBuffer}
+     * @see {@link ChatPromptDecoder}
+     */
     decode: (value: ReadableStream<VSBuffer>) => ChatPromptDecoder;
 }
+/**
+ * Codec that is capable to encode and decode tokens of an AI chatbot prompt message.
+ */
 export declare const ChatPromptCodec: IChatPromptCodec;
 export {};

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/chatPromptDecoder.d.ts

@@ -6,11 +6,26 @@ import { PromptTemplateVariable } from "./tokens/promptTemplateVariable.js";
 import { BaseDecoder } from "./base/baseDecoder.js";
 import { PromptVariable, PromptVariableWithData } from "./tokens/promptVariable.js";
 import { TMarkdownToken } from "./base/markdownCodec/markdownDecoder.js";
+/**
+ * Tokens produced by this decoder.
+ */
 export type TChatPromptToken = TMarkdownToken | (PromptVariable | PromptVariableWithData) | PromptAtMention | PromptSlashCommand | PromptTemplateVariable;
+/**
+ * Decoder for the common chatbot prompt message syntax.
+ * For instance, the file references `#file:./path/file.md` are handled by this decoder.
+ */
 export declare class ChatPromptDecoder extends BaseDecoder<TChatPromptToken, TMarkdownToken> {
+    /**
+     * Currently active parser object that is used to parse a well-known sequence of
+     * tokens, for instance, a `#file:/path/to/file.md` link that consists of `hash`,
+     * `word`, and `colon` tokens sequence plus the `file path` part that follows.
+     */
     private current?;
     constructor(stream: ReadableStream<VSBuffer>);
     protected onStreamData(token: TMarkdownToken): void;
     protected onStreamEnd(): void;
+    /**
+     * Re-emit tokens accumulated so far in the current parser object.
+     */
     protected reEmitCurrentTokens(): void;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/parsers/promptAtMentionParser.d.ts

@@ -2,10 +2,26 @@ import { PromptAtMention } from "../tokens/promptAtMention.js";
 import { At } from "../base/simpleCodec/tokens/at.js";
 import { TSimpleDecoderToken } from "../base/simpleCodec/simpleDecoder.js";
 import { ParserBase, TAcceptTokenResult } from "../base/simpleCodec/parserBase.js";
+/**
+ * List of characters that terminate the prompt at-mention sequence.
+ */
 export declare const STOP_CHARACTERS: readonly string[];
+/**
+ * List of characters that cannot be in an at-mention name (excluding the {@link STOP_CHARACTERS}).
+ */
 export declare const INVALID_NAME_CHARACTERS: readonly string[];
+/**
+ * The parser responsible for parsing a `prompt @mention` sequences.
+ * E.g., `@workspace` or `@github` participant mention.
+ */
 export declare class PartialPromptAtMention extends ParserBase<TSimpleDecoderToken, PartialPromptAtMention | PromptAtMention> {
     constructor(token: At);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptAtMention | PromptAtMention>;
+    /**
+     * Try to convert current parser instance into a fully-parsed {@link PromptAtMention} token.
+     *
+     * @throws if sequence of tokens received so far do not constitute a valid prompt variable,
+     *        for instance, if there is only `1` starting `@` token is available.
+     */
     asPromptAtMention(): PromptAtMention;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/parsers/promptSlashCommandParser.d.ts

@@ -2,10 +2,26 @@ import { PromptSlashCommand } from "../tokens/promptSlashCommand.js";
 import { Slash } from "../base/simpleCodec/tokens/slash.js";
 import { TSimpleDecoderToken } from "../base/simpleCodec/simpleDecoder.js";
 import { ParserBase, TAcceptTokenResult } from "../base/simpleCodec/parserBase.js";
+/**
+ * List of characters that terminate the prompt at-mention sequence.
+ */
 export declare const STOP_CHARACTERS: readonly string[];
+/**
+ * List of characters that cannot be in an at-mention name (excluding the {@link STOP_CHARACTERS}).
+ */
 export declare const INVALID_NAME_CHARACTERS: readonly string[];
+/**
+ * The parser responsible for parsing a `prompt /command` sequences.
+ * E.g., `/search` or `/explain` command.
+ */
 export declare class PartialPromptSlashCommand extends ParserBase<TSimpleDecoderToken, PartialPromptSlashCommand | PromptSlashCommand> {
     constructor(token: Slash);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptSlashCommand | PromptSlashCommand>;
+    /**
+     * Try to convert current parser instance into a fully-parsed {@link PromptSlashCommand} token.
+     *
+     * @throws if sequence of tokens received so far do not constitute a valid prompt variable,
+     *        for instance, if there is only `1` starting `/` token is available.
+     */
     asPromptSlashCommand(): PromptSlashCommand;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/parsers/promptTemplateVariableParser.d.ts

@@ -2,14 +2,35 @@ import { PromptTemplateVariable } from "../tokens/promptTemplateVariable.js";
 import { TSimpleDecoderToken } from "../base/simpleCodec/simpleDecoder.js";
 import { DollarSign, LeftCurlyBrace } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/codecs/base/simpleCodec/tokens/tokens";
 import { ParserBase, TAcceptTokenResult } from "../base/simpleCodec/parserBase.js";
+/**
+ * Parsers of the `${variable}` token sequence in a prompt text.
+ */
 export type TPromptTemplateVariableParser = PartialPromptTemplateVariableStart | PartialPromptTemplateVariable;
+/**
+ * Parser that handles start sequence of a `${variable}` token sequence in
+ * a prompt text. Transitions to {@link PartialPromptTemplateVariable} parser
+ * as soon as the `${` character sequence is found.
+ */
 export declare class PartialPromptTemplateVariableStart extends ParserBase<DollarSign | LeftCurlyBrace, PartialPromptTemplateVariableStart | PartialPromptTemplateVariable> {
     constructor(token: DollarSign);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptTemplateVariableStart | PartialPromptTemplateVariable>;
 }
+/**
+ * Parser that handles a partial `${variable}` token sequence in a prompt text.
+ */
 export declare class PartialPromptTemplateVariable extends ParserBase<TSimpleDecoderToken, PartialPromptTemplateVariable | PromptTemplateVariable> {
     constructor(tokens: (DollarSign | LeftCurlyBrace)[]);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptTemplateVariable | PromptTemplateVariable>;
+    /**
+     * Returns a string representation of the prompt template variable
+     * contents, if any is present.
+     */
     private get contents();
+    /**
+     * Try to convert current parser instance into a {@link PromptTemplateVariable} token.
+     *
+     * @throws if:
+     * 	- current tokens sequence cannot be converted to a valid template variable token
+     */
     asPromptTemplateVariable(): PromptTemplateVariable;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/parsers/promptVariableParser.d.ts

@@ -2,15 +2,41 @@ import { PromptVariable, PromptVariableWithData } from "../tokens/promptVariable
 import { Hash } from "../base/simpleCodec/tokens/hash.js";
 import { TSimpleDecoderToken } from "../base/simpleCodec/simpleDecoder.js";
 import { ParserBase, TAcceptTokenResult } from "../base/simpleCodec/parserBase.js";
+/**
+ * List of characters that terminate the prompt variable sequence.
+ */
 export declare const STOP_CHARACTERS: readonly string[];
+/**
+ * List of characters that cannot be in a variable name (excluding the {@link STOP_CHARACTERS}).
+ */
 export declare const INVALID_NAME_CHARACTERS: readonly string[];
+/**
+ * The parser responsible for parsing a `prompt variable name`.
+ * E.g., `#selection` or `#codebase` variable. If the `:` character follows
+ * the variable name, the parser transitions to {@link PartialPromptVariableWithData}
+ * that is also able to parse the `data` part of the variable. E.g., the `#file` part
+ * of the `#file:/path/to/something.md` sequence.
+ */
 export declare class PartialPromptVariableName extends ParserBase<TSimpleDecoderToken, PartialPromptVariableName | PartialPromptVariableWithData | PromptVariable> {
     constructor(token: Hash);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptVariableName | PartialPromptVariableWithData | PromptVariable>;
+    /**
+     * Try to convert current parser instance into a fully-parsed {@link PromptVariable} token.
+     *
+     * @throws if sequence of tokens received so far do not constitute a valid prompt variable,
+     *        for instance, if there is only `1` starting `#` token is available.
+     */
     asPromptVariable(): PromptVariable;
 }
+/**
+ * The parser responsible for parsing a `prompt variable name` with `data`.
+ * E.g., the `/path/to/something.md` part of the `#file:/path/to/something.md` sequence.
+ */
 export declare class PartialPromptVariableWithData extends ParserBase<TSimpleDecoderToken, PartialPromptVariableWithData | PromptVariableWithData> {
     constructor(tokens: readonly TSimpleDecoderToken[]);
     accept(token: TSimpleDecoderToken): TAcceptTokenResult<PartialPromptVariableWithData | PromptVariableWithData>;
+    /**
+     * Try to convert current parser instance into a fully-parsed {@link asPromptVariableWithData} token.
+     */
     asPromptVariableWithData(): PromptVariableWithData;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/fileReference.d.ts

@@ -1,8 +1,19 @@
 import { PromptVariableWithData } from "./promptVariable.js";
 import { IRange, Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * Object represents a file reference token inside a chatbot prompt.
+ */
 export declare class FileReference extends PromptVariableWithData {
     readonly path: string;
     constructor(range: Range, path: string);
+    /**
+     * Create a {@link FileReference} from a {@link PromptVariableWithData} instance.
+     * @throws if variable name is not equal to {@link VARIABLE_NAME}.
+     */
     static from(variable: PromptVariableWithData): FileReference;
+    /**
+     * Get the range of the `link` part of the token (e.g.,
+     * the `/path/to/file.md` part of `#file:/path/to/file.md`).
+     */
     get linkRange(): IRange | undefined;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/promptAtMention.d.ts

@@ -1,8 +1,24 @@
 import { PromptToken } from "./promptToken.js";
 import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * Represents a `@mention` token in a prompt text.
+ */
 export declare class PromptAtMention extends PromptToken {
+    /**
+     * The name of a mention, excluding the `@` character at the start.
+     */
     readonly name: string;
-    constructor(range: Range, name: string);
+    constructor(range: Range, 
+    /**
+     * The name of a mention, excluding the `@` character at the start.
+     */
+    name: string);
+    /**
+     * Get full text of the token.
+     */
     get text(): string;
+    /**
+     * Return a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/promptSlashCommand.d.ts

@@ -1,8 +1,24 @@
 import { PromptToken } from "./promptToken.js";
 import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * Represents a `/command` token in a prompt text.
+ */
 export declare class PromptSlashCommand extends PromptToken {
+    /**
+     * The name of a command, excluding the `/` character at the start.
+     */
     readonly name: string;
-    constructor(range: Range, name: string);
+    constructor(range: Range, 
+    /**
+     * The name of a command, excluding the `/` character at the start.
+     */
+    name: string);
+    /**
+     * Get full text of the token.
+     */
     get text(): string;
+    /**
+     * Return a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/promptTemplateVariable.d.ts

@@ -1,8 +1,26 @@
 import { PromptToken } from "./promptToken.js";
 import { Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * Represents a `${variable}` token in a prompt text.
+ */
 export declare class PromptTemplateVariable extends PromptToken {
+    /**
+     * The contents of the template variable, excluding
+     * the surrounding `${}` characters.
+     */
     readonly contents: string;
-    constructor(range: Range, contents: string);
+    constructor(range: Range, 
+    /**
+     * The contents of the template variable, excluding
+     * the surrounding `${}` characters.
+     */
+    contents: string);
+    /**
+     * Get full text of the token.
+     */
     get text(): string;
+    /**
+     * Return a string representation of the token.
+     */
     toString(): string;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/promptToken.d.ts

@@ -1,3 +1,6 @@
 import { BaseToken } from "../base/baseToken.js";
+/**
+ * Common base token that all chatbot `prompt` tokens should inherit from.
+ */
 export declare abstract class PromptToken extends BaseToken {
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/codecs/tokens/promptVariable.d.ts

@@ -1,14 +1,51 @@
 import { PromptToken } from "./promptToken.js";
 import { IRange, Range } from "@codingame/monaco-vscode-api/vscode/vs/editor/common/core/range";
+/**
+ * Represents a `#variable` token in a prompt text.
+ */
 export declare class PromptVariable extends PromptToken {
+    /**
+     * The name of a prompt variable, excluding the `#` character at the start.
+     */
     readonly name: string;
-    constructor(range: Range, name: string);
+    constructor(range: Range, 
+    /**
+     * The name of a prompt variable, excluding the `#` character at the start.
+     */
+    name: string);
+    /**
+     * Get full text of the token.
+     */
     get text(): string;
+    /**
+     * Return a string representation of the token.
+     */
     toString(): string;
 }
+/**
+ * Represents a {@link PromptVariable} with additional data token in a prompt text.
+ * (e.g., `#variable:/path/to/file.md`)
+ */
 export declare class PromptVariableWithData extends PromptVariable {
+    /**
+     * The data of the variable, excluding the starting {@link DATA_SEPARATOR} character.
+     */
     readonly data: string;
-    constructor(fullRange: Range, name: string, data: string);
+    constructor(fullRange: Range, 
+    /**
+     * The name of the variable, excluding the starting `#` character.
+     */
+    name: string, 
+    /**
+     * The data of the variable, excluding the starting {@link DATA_SEPARATOR} character.
+     */
+    data: string);
+    /**
+     * Get full text of the token.
+     */
     get text(): string;
+    /**
+     * Range of the `data` part of the variable.
+     */
     get dataRange(): IRange | undefined;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/config/configMigration.d.ts

@@ -1,9 +1,17 @@
 import { ILogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/log/common/log.service";
 import { IWorkbenchContribution } from "@codingame/monaco-vscode-api/vscode/vs/workbench/common/contributions";
 import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
+/**
+ * Contribution that migrates the old config setting value to a new one.
+ *
+ * Note! This is a temporary logic and can be removed on ~2026-04-29.
+ */
 export declare class ConfigMigration implements IWorkbenchContribution {
     private readonly logService;
     private readonly configService;
     constructor(logService: ILogService, configService: IConfigurationService);
+    /**
+     * The main function that implements the migration logic.
+     */
     private migrateConfig;
 }

package/vscode/src/vs/workbench/contrib/chat/common/promptSyntax/contentProviders/filePromptContentsProvider.d.ts

@@ -7,6 +7,10 @@ import { ILanguageService } from "@codingame/monaco-vscode-api/vscode/vs/editor/
 import { IPromptContentsProviderOptions, PromptContentsProviderBase } from "./promptContentsProviderBase.js";
 import { FileChangesEvent } from "@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files";
 import { IFileService } from "@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files.service";
+/**
+ * Prompt contents provider for a file on the disk referenced by
+ * a provided {@link URI}.
+ */
 export declare class FilePromptContentProvider extends PromptContentsProviderBase<FileChangesEvent> implements IPromptContentsProvider {
     readonly uri: URI;
     private readonly fileService;
@@ -15,9 +19,20 @@ export declare class FilePromptContentProvider extends PromptContentsProviderBas
     get sourceName(): string;
     get languageId(): string;
     constructor(uri: URI, options: IPromptContentsProviderOptions, fileService: IFileService, modelService: IModelService, languageService: ILanguageService);
+    /**
+     * Creates a stream of lines from the file based on the changes listed in
+     * the provided event.
+     *
+     * @param event - event that describes the changes in the file; `'full'` is
+     * 				  the special value that means that all contents have changed
+     * @param cancellationToken - token that cancels this operation
+     */
     protected getContentsStream(_event: FileChangesEvent | "full", cancellationToken?: CancellationToken): Promise<VSBufferReadableStream>;
     createNew(promptContentsSource: {
         uri: URI;
     }, options: IPromptContentsProviderOptions): IPromptContentsProvider;
+    /**
+     * String representation of this object.
+     */
     toString(): string;
 }