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

package/vscode/src/vs/workbench/contrib/chat/browser/languageModelToolsService.d.ts

@@ -28,6 +28,7 @@ export declare class LanguageModelToolsService extends Disposable implements ILa
     _serviceBrand: undefined;
     private _onDidChangeTools;
     readonly onDidChangeTools: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<void>;
+    /** Throttle tools updates because it sends all tools and runs on context key updates */
     private _onDidChangeToolsScheduler;
     private _tools;
     private _toolContextKeys;
@@ -58,6 +59,11 @@ export declare class LanguageModelToolsService extends Disposable implements ILa
     private cleanupCallDisposables;
     cancelToolCallsForRequest(requestId: string): void;
     toToolEnablementMap(toolOrToolsetNames: Set<string>): Record<string, boolean>;
+    /**
+     * Create a map that contains all tools and toolsets with their enablement state.
+     * @param toolOrToolSetNames A list of tool or toolset names to check for enablement. If undefined, all tools and toolsets are enabled.
+     * @returns A map of tool or toolset instances to their enablement state.
+     */
     toToolAndToolSetEnablementMap(enabledToolOrToolSetNames: readonly string[] | undefined): Map<ToolSet | IToolData, boolean>;
     private readonly _toolSets;
     readonly toolSets: IObservable<Iterable<ToolSet>>;

package/vscode/src/vs/workbench/contrib/chat/browser/media/chatEditingEditorOverlay.css

@@ -1,3 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .chat-editor-overlay-widget {
 	padding: 0px;
 	color: var(--vscode-button-foreground);
@@ -10,6 +15,7 @@
 	box-shadow: 0 2px 8px var(--vscode-widget-shadow);
 	overflow: hidden;
 }
+
 @keyframes pulse {
 	0% {
 		box-shadow: 0 2px 8px 0 var(--vscode-widget-shadow);
@@ -21,9 +27,11 @@
 		box-shadow: 0 2px 8px 0 var(--vscode-widget-shadow);
 	}
 }
+
 .chat-editor-overlay-widget.busy {
 	animation: pulse ease-in 2.3s infinite;
 }
+
 .chat-editor-overlay-widget .chat-editor-overlay-progress {
 	align-items: center;
 	display: none;
@@ -32,9 +40,11 @@
 	overflow: hidden;
 	gap: 6px;
 }
+
 .chat-editor-overlay-widget.busy .chat-editor-overlay-progress {
 	display: inline-flex;
 }
+
 .chat-editor-overlay-widget .chat-editor-overlay-progress .progress-message {
 	white-space: nowrap;
 	max-width: 13em;
@@ -42,22 +52,29 @@
 	text-overflow: ellipsis;
 	padding-right: 8px;
 }
+
 .chat-editor-overlay-widget .action-item > .action-label {
 	padding: 5px;
 	font-size: 12px;
 }
+
+
 .chat-editor-overlay-widget .action-item:first-child > .action-label {
 	padding-left: 7px;
 }
+
 .chat-editor-overlay-widget .action-item:last-child > .action-label {
 	padding-right: 7px;
 }
+
 .chat-editor-overlay-widget.busy .chat-editor-overlay-progress .codicon,
 .chat-editor-overlay-widget .action-item > .action-label.codicon {
 	color: var(--vscode-button-foreground);
 }
+
 .chat-diff-change-content-widget .monaco-action-bar .action-item.disabled,
 .chat-editor-overlay-widget .monaco-action-bar .action-item.disabled {
+
 	> .action-label.codicon::before,
 	> .action-label.codicon,
 	> .action-label,
@@ -66,18 +83,23 @@
 		opacity: 0.7;
 	}
 }
+
+
 .chat-editor-overlay-widget .action-item.label-item {
 	font-variant-numeric: tabular-nums;
 }
+
 .chat-editor-overlay-widget .monaco-action-bar .action-item.label-item > .action-label,
 .chat-editor-overlay-widget .monaco-action-bar .action-item.label-item > .action-label:hover {
 	color: var(--vscode-button-foreground);
 	opacity: 1;
 }
+
 .chat-editor-overlay-widget .action-item.auto {
 	position: relative;
 	overflow: hidden;
 }
+
 .chat-editor-overlay-widget .action-item.auto::before {
 	content: '';
 	position: absolute;

package/vscode/src/vs/workbench/contrib/chat/browser/media/chatEditorController.css

@@ -1,23 +1,32 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .chat-diff-change-content-widget {
 	opacity: 0;
 	transition: opacity 0.2s ease-in-out;
 	display: flex;
 	box-shadow: 0 2px 8px var(--vscode-widget-shadow);
 }
+
 .chat-diff-change-content-widget.hover {
 	opacity: 1;
 }
+
 .chat-diff-change-content-widget .monaco-action-bar {
 	padding: 0;
 	border-radius: 2px;
 	background-color: var(--vscode-button-background);
 	color: var(--vscode-button-foreground);
 }
+
 .chat-diff-change-content-widget .monaco-action-bar .action-item .action-label {
 	height: 14px;
 	border-radius: 2px;
 	color: var(--vscode-button-foreground);
 }
+
 .chat-diff-change-content-widget .monaco-action-bar .action-item .action-label.codicon {
 	width: unset;
 	padding: 2px;
@@ -25,6 +34,7 @@
 	line-height: 14px;
 	color: var(--vscode-button-foreground);
 }
+
 .chat-diff-change-content-widget .monaco-action-bar .action-item .action-label.codicon[class*='codicon-'] {
 	font-size: 12px;
 }

package/vscode/src/vs/workbench/contrib/chat/browser/media/chatSessions.css

@@ -1,21 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .chat-sessions-tree .monaco-tl-twistie {
 	display: none !important;
 }
+
 .chat-sessions-tree {
 	line-height: 22px;
 }
+
+/* Ensure consistent title background regardless of number of views */
 .composite.viewlet[id="workbench.view.chat.sessions"] .pane-header.expanded.not-collapsible {
 	background-color: var(--vscode-sideBarSectionHeader-background) !important;
 }
+
+/* Add padding to chat session item icons */
 .chat-sessions-tree .chat-session-item .monaco-icon-label-iconpath {
 	margin-right: 4px;
 	margin-left: 4px;
 }
+
+/* Style for empty state message */
 .chat-sessions-message {
 	padding: 20px;
 	text-align: center;
 	color: var(--vscode-descriptionForeground);
 }
+
 .chat-sessions-message .no-sessions-message {
 	display: flex;
 	align-items: center;
@@ -23,6 +36,7 @@
 	gap: 8px;
 	font-style: italic;
 }
+
 .chat-sessions-message .no-sessions-message .codicon {
 	opacity: 0.7;
 }

package/vscode/src/vs/workbench/contrib/chat/browser/media/chatSetup.css

@@ -1,4 +1,12 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .chat-setup-dialog {
+
+	/* Continue Buttons */
+
 	.dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button::before {
 		content: '';
 		background-size: 16px;
@@ -10,12 +18,17 @@
 		line-height: inherit !important;
 		display: inline-block;
 	}
+
 	.dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.default::before {
 		background-image: url('./github.svg');
 	}
+
 	.dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.google::before {
 		background-image: url('./google.svg');
 	}
+
+	/* Link Buttons */
+
 	.dialog-buttons-row > .dialog-buttons > .monaco-button.link-button {
 		border: 0 !important;
 		background-color: unset !important;
@@ -24,19 +37,25 @@
 		margin-left: auto;
 		margin-right: auto;
 	}
+
 	.dialog-buttons-row > .dialog-buttons > .monaco-button.link-button.skip-button {
 		font-size: 11px;
 		color: var(--vscode-descriptionForeground) !important;
 	}
+
+	/* Footer */
+
 	.chat-setup-dialog-footer {
 		font-size: 11px;
 		color: var(--vscode-descriptionForeground);
 	}
 }
+
 .monaco-workbench.hc-black .chat-setup-dialog .dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.apple::before,
 .monaco-workbench.vs-dark .chat-setup-dialog .dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.apple::before {
 	background-image: url('./apple-dark.svg');
 }
+
 .monaco-workbench.hc-light .chat-setup-dialog .dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.apple::before,
 .monaco-workbench.vs .chat-setup-dialog .dialog-buttons-row > .dialog-buttons > .monaco-button.continue-button.apple::before {
 	background-image: url('./apple-light.svg');

package/vscode/src/vs/workbench/contrib/chat/browser/media/chatStatus.css

@@ -1,11 +1,20 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/* Overall */
+
 .chat-status-bar-entry-tooltip {
 	margin-top: 4px;
 	margin-bottom: 4px;
 }
+
 .chat-status-bar-entry-tooltip hr {
 	margin-top: 8px;
 	margin-bottom: 8px;
 }
+
 .chat-status-bar-entry-tooltip div.header {
 	display: flex;
 	align-items: center;
@@ -13,35 +22,47 @@
 	margin-bottom: 4px;
 	font-weight: 600;
 }
+
 .chat-status-bar-entry-tooltip div.header .monaco-action-bar {
 	margin-left: auto;
 }
+
 .chat-status-bar-entry-tooltip div.description {
 	font-size: 11px;
 	color: var(--vscode-descriptionForeground);
 }
+
 .chat-status-bar-entry-tooltip .monaco-button {
 	margin-top: 5px;
 	margin-bottom: 5px;
 }
+
+/* Setup for New User */
+
 .chat-status-bar-entry-tooltip .setup .chat-feature-container {
 	display: flex;
 	align-items: center;
 	gap: 5px;
 	padding: 4px;
 }
+
+/* Quota Indicator */
+
 .chat-status-bar-entry-tooltip .quota-indicator {
 	margin-bottom: 6px;
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator .quota-label {
 	display: flex;
 	justify-content: space-between;
 	gap: 20px;
 	margin-bottom: 3px;
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator .quota-label .quota-value {
 	color: var(--vscode-descriptionForeground);
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator .quota-bar {
 	width: 100%;
 	height: 4px;
@@ -50,43 +71,58 @@
 	border: 1px solid var(--vscode-gauge-border);
 	margin: 4px 0;
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator .quota-bar .quota-bit {
 	height: 100%;
 	background-color: var(--vscode-gauge-background);
 	border-radius: 4px;
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator.warning .quota-bar {
 	background-color: var(--vscode-gauge-warningForeground);
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator.warning .quota-bar .quota-bit {
 	background-color: var(--vscode-gauge-warningBackground);
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator.error .quota-bar {
 	background-color: var(--vscode-gauge-errorForeground);
 }
+
 .chat-status-bar-entry-tooltip .quota-indicator.error .quota-bar .quota-bit {
 	background-color: var(--vscode-gauge-errorBackground);
 }
+
+/* Settings */
+
 .chat-status-bar-entry-tooltip .settings {
 	display: flex;
 	flex-direction: column;
 	gap: 5px;
 }
+
 .chat-status-bar-entry-tooltip .settings .setting {
 	display: flex;
 	align-items: center;
 }
+
 .chat-status-bar-entry-tooltip .settings .setting .monaco-checkbox {
 	height: 14px;
 	width: 14px;
 	margin-right: 5px;
 }
+
 .chat-status-bar-entry-tooltip .settings .setting .setting-label {
 	cursor: pointer;
 }
+
 .chat-status-bar-entry-tooltip .settings .setting.disabled .setting-label {
 	color: var(--vscode-disabledForeground);
 }
+
+/* Snoozing */
+
 .chat-status-bar-entry-tooltip .snooze-completions {
 	margin-top: 6px;
 	display: flex;
@@ -95,6 +131,7 @@
 	align-items: center;
 	gap: 6px;
 }
+
 .chat-status-bar-entry-tooltip .snooze-completions .monaco-button {
 	width: fit-content;
 	overflow: hidden;
@@ -104,6 +141,7 @@
 	user-select: none;
 	-webkit-user-select: none;
 }
+
 .chat-status-bar-entry-tooltip .snooze-completions .snooze-label {
 	flex: 1;
 	padding-left: 2px;
@@ -113,23 +151,30 @@
 	white-space: nowrap;
 	font-variant-numeric: tabular-nums;
 }
+
 .chat-status-bar-entry-tooltip .snooze-completions.disabled .snooze-label {
 	color: var(--vscode-disabledForeground);
 }
+
 .chat-status-bar-entry-tooltip .snooze-completions .snooze-action-bar {
 	margin-left: auto;
 }
+
+/* Contributions */
+
 .chat-status-bar-entry-tooltip .contribution .body {
 	display: flex;
 	flex-direction: row;
 	align-items: center;
 	gap: 5px;
+
 	.description,
 	.detail-item {
 		display: flex;
 		align-items: center;
 		gap: 3px;
 	}
+
 	.detail-item,
 	.detail-item a {
 		margin-left: auto;

package/vscode/src/vs/workbench/contrib/chat/browser/media/simpleBrowserOverlay.css

@@ -1,3 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .element-selection-message,
 .element-expand-container,
 .connecting-webview-element {
@@ -17,24 +22,29 @@
 	z-index: 1;
 	height: 42px;
 }
+
 .element-selection-message {
 	bottom: 10px;
 	right: 10px;
 }
+
 .element-expand-container,
 .connecting-webview-element {
 	bottom: 15px;
 	right: 15px;
 }
+
 .element-selection-cancel {
 	padding: 2px 8px;
 	width: fit-content;
 }
+
 .element-selection-message .monaco-button-dropdown > .monaco-button.monaco-text-button {
 	height: 24px;
 	align-content: center;
 	padding: 0px 5px;
 }
+
 .element-selection-message .monaco-button.codicon.codicon-close,
 .element-expand-container .monaco-button.codicon.codicon-layout,
 .element-selection-message .monaco-button.codicon.codicon-chevron-right,
@@ -53,6 +63,7 @@
 	border-radius: 5px;
 	cursor: pointer;
 }
+
 .element-selection .monaco-button {
 	height: 17px;
 	width: fit-content;
@@ -62,10 +73,12 @@
 	border: 1px solid var(--vscode-button-border);
 	color: var(--vscode-button-foreground);
 }
+
 .element-selection-message .monaco-button:hover,
 .element-expand-container .monaco-button:hover {
 	background-color: var(--vscode-toolbar-hoverBackground);
 }
+
 .element-selection-message .hidden,
 .element-expand-container.hidden,
 .element-selection-message.hidden {

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/attachInstructionsAction.d.ts

@@ -4,11 +4,33 @@ import { IPromptsService } from "@codingame/monaco-vscode-api/vscode/vs/workbenc
 import { IChatContextPickerItem, IChatContextPicker } from "@codingame/monaco-vscode-d0569cfb-4706-5ad6-b0b0-5115ad8685db-common/vscode/vs/workbench/contrib/chat/browser/chatContextPickService";
 import { ILabelService } from "@codingame/monaco-vscode-api/vscode/vs/platform/label/common/label.service";
 import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
+/**
+ * Options for the {@link AttachInstructionsAction} action.
+ */
 export interface IAttachInstructionsActionOptions {
+    /**
+     * Target chat widget reference to attach the instruction to. If the reference is
+     * provided, the command will attach the instruction as attachment of the widget.
+     * Otherwise, the command will re-use an existing one.
+     */
     readonly widget?: IChatWidget;
+    /**
+     * Instruction resource `URI` to attach to the chat input, if any.
+     * If provided the resource will be pre-selected in the prompt picker dialog,
+     * otherwise the dialog will show the prompts list without any pre-selection.
+     */
     readonly resource?: URI;
+    /**
+     * Whether to skip the instructions files selection dialog.
+     *
+     * Note! if this option is set to `true`, the {@link resource}
+     * option `must be defined`.
+     */
     readonly skipSelectionDialog?: boolean;
 }
+/**
+ * Helper to register the `Attach Prompt` action.
+ */
 export declare function registerAttachPromptActions(): void;
 export declare class ChatInstructionsPickerPick implements IChatContextPickerItem {
     private readonly promptsService;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/chatModeActions.d.ts

@@ -1 +1,4 @@
+/**
+ * Helper to register all the `Run Current Prompt` actions.
+ */
 export declare function registerChatModeActions(): void;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/pickers/askForPromptName.d.ts

@@ -1,4 +1,7 @@
 import { PromptsType } from "@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02df70296354-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
 import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
 import { ServicesAccessor } from "@codingame/monaco-vscode-api/vscode/vs/editor/browser/editorExtensions";
+/**
+ * Asks the user for a file name.
+ */
 export declare function askForPromptFileName(accessor: ServicesAccessor, type: PromptsType, selectedFolder: URI, existingFileName?: string): Promise<string | undefined>;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/pickers/askForPromptSourceFolder.d.ts

@@ -2,4 +2,7 @@ import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
 import { ServicesAccessor } from "@codingame/monaco-vscode-api/vscode/vs/editor/browser/editorExtensions";
 import { PromptsType } from "@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02df70296354-common/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes";
 import { IPromptPath } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService";
+/**
+ * Asks the user for a specific prompt folder, if multiple folders provided.
+ */
 export declare function askForPromptSourceFolder(accessor: ServicesAccessor, type: PromptsType, existingFolder?: URI | undefined, isMove?: boolean): Promise<IPromptPath | undefined>;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/pickers/promptFilePickers.d.ts

@@ -9,8 +9,19 @@ import { PromptsType } from "@codingame/monaco-vscode-e28ac690-06d5-5ee9-92d1-02
 import { IKeyMods } from "@codingame/monaco-vscode-api/vscode/vs/platform/quickinput/common/quickInput";
 import { IQuickInputService } from "@codingame/monaco-vscode-api/vscode/vs/platform/quickinput/common/quickInput.service";
 import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+/**
+ * Options for the {@link askToSelectInstructions} function.
+ */
 export interface ISelectOptions {
+    /**
+     * The text shows as placeholder in the selection dialog.
+     */
     readonly placeholder: string;
+    /**
+     * Prompt resource `URI` to attach to the chat input, if any.
+     * If provided the resource will be pre-selected in the prompt picker dialog,
+     * otherwise the dialog will show the prompts list without any pre-selection.
+     */
     readonly resource?: URI;
     readonly type: PromptsType;
     readonly optionNew?: boolean;
@@ -20,7 +31,13 @@ export interface ISelectOptions {
     readonly optionCopy?: boolean;
 }
 export interface ISelectPromptResult {
+    /**
+     * The selected prompt file.
+     */
     readonly promptFile: URI;
+    /**
+     * The key modifiers that were pressed when the prompt was selected.
+     */
     readonly keyMods: IKeyMods;
 }
 export declare class PromptFilePickers {
@@ -33,6 +50,12 @@ export declare class PromptFilePickers {
     private readonly _instaService;
     private readonly _promptsService;
     constructor(_labelService: ILabelService, _quickInputService: IQuickInputService, _openerService: IOpenerService, _fileService: IFileService, _dialogService: IDialogService, _commandService: ICommandService, _instaService: IInstantiationService, _promptsService: IPromptsService);
+    /**
+     * Shows the prompt file selection dialog to the user that allows to run a prompt file(s).
+     *
+     * If {@link ISelectOptions.resource resource} is provided, the dialog will have
+     * the resource pre-selected in the prompts list.
+     */
     selectPromptFile(options: ISelectOptions): Promise<ISelectPromptResult | undefined>;
     private _createPromptPickItems;
     private _getNewItems;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/promptFileActions.d.ts

@@ -1 +1,4 @@
+/**
+ * Helper to register all actions related to reusable prompt files.
+ */
 export declare function registerPromptActions(): void;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/runPromptAction.d.ts

@@ -1 +1,4 @@
+/**
+ * Helper to register all the `Run Current Prompt` actions.
+ */
 export declare function registerRunPromptActions(): void;

package/vscode/src/vs/workbench/contrib/chat/browser/promptSyntax/saveToPromptAction.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Action ID for the `Save Prompt` action.
+ */
 export declare const SAVE_TO_PROMPT_ACTION_ID = "workbench.action.chat.save-to-prompt";
+/**
+ * Name of the in-chat slash command associated with this action.
+ */
 export declare const SAVE_TO_PROMPT_SLASH_COMMAND_NAME = "save";
+/**
+ * Helper to register all the `Save Prompt` actions.
+ */
 export declare function registerSaveToPromptActions(): void;

package/vscode/src/vs/workbench/contrib/chat/common/chatServiceImpl.d.ts

@@ -40,6 +40,7 @@ export declare class ChatService extends Disposable implements IChatService {
     private readonly _contentProviderSessionModels;
     private readonly _pendingRequests;
     private _persistedSessions;
+    /** Just for empty windows, need to enforce that a chat was deleted, even though other windows still have it */
     private _deletedChatIds;
     private _transferredSessionData;
     get transferredSessionData(): IChatTransferredSessionData | undefined;
@@ -71,6 +72,11 @@ export declare class ChatService extends Disposable implements IChatService {
     private error;
     private deserializeChats;
     private getTransferredSessionData;
+    /**
+     * Returns an array of chat details for all persisted chat sessions that have at least one request.
+     * Chat sessions that have already been loaded into the chat view are excluded from the result.
+     * Imported chat sessions are also excluded from the result.
+     */
     getHistory(): Promise<IChatDetail[]>;
     removeHistoryEntry(sessionId: string): Promise<void>;
     clearAllHistoryEntries(): Promise<void>;
@@ -80,6 +86,9 @@ export declare class ChatService extends Disposable implements IChatService {
     activateDefaultAgent(location: ChatAgentLocation): Promise<void>;
     getSession(sessionId: string): IChatModel | undefined;
     getOrRestoreSession(sessionId: string): Promise<ChatModel | undefined>;
+    /**
+     * This is really just for migrating data from the edit session location to the panel.
+     */
     isPersistedSessionEmpty(sessionId: string): boolean;
     loadSessionFromContent(data: IExportableChatData | ISerializableChatData): IChatModel | undefined;
     loadSessionForResource(resource: URI, location: ChatAgentLocation, token: CancellationToken): Promise<IChatModel | undefined>;

package/vscode/src/vs/workbench/contrib/chat/common/chatSessionStore.d.ts

@@ -54,6 +54,11 @@ interface IChatSessionEntryMetadata {
     lastMessageDate: number;
     isImported?: boolean;
     initialLocation?: ChatAgentLocation;
+    /**
+     * This only exists because the migrated data from the storage service had empty sessions persisted, and it's impossible to know which ones are
+     * currently in use. Now, `clearSession` deletes empty sessions, so old ones shouldn't take up space in the store anymore, but we still need to
+     * filter the old ones out of history.
+     */
     isEmpty?: boolean;
 }
 export type IChatSessionIndex = Record<string, IChatSessionEntryMetadata>;
@@ -68,3 +73,6 @@ export interface IChatTransfer2 extends IChatTransfer {
     chat: ISerializableChatData;
 }
 export {};
+/**
+ * Map of destination workspace URI to chat transfer data
+ */