@codingame/monaco-vscode-chat-service-override 30.0.0 → 31.0.0

package/vscode/src/vs/workbench/contrib/chat/browser/aiCustomization/aiCustomizationManagementEditor.js

@@ -61,7 +61,6 @@ import { ITextModelService } from '@codingame/monaco-vscode-api/vscode/vs/editor
 import { IConfigurationService } from '@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service';
 import { getSimpleEditorOptions } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/codeEditor/browser/simpleEditorOptions';
 import { IWorkingCopyService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/services/workingCopy/common/workingCopyService.service';
-import { IFileDialogService } from '@codingame/monaco-vscode-api/vscode/vs/platform/dialogs/common/dialogs.service';
 import { IHoverService } from '@codingame/monaco-vscode-api/vscode/vs/platform/hover/browser/hover.service';
 import { IFileService } from '@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files.service';
 import { INotificationService } from '@codingame/monaco-vscode-api/vscode/vs/platform/notification/common/notification.service';
@@ -76,16 +75,18 @@ import { AgentPluginEditorInput } from '../agentPluginEditor/agentPluginEditorIn
 import { CustomizationHarness, matchesWorkspaceSubpath } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/customizationHarnessService';
 import { ICustomizationHarnessService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/customizationHarnessService.service';
 import { ChatConfiguration } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/constants';
-import { AICustomizationManagementSection, BUILTIN_STORAGE } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService';
+import { AICustomizationWelcomePage } from './aiCustomizationWelcomePage.js';
+import { IViewsService } from '@codingame/monaco-vscode-api/vscode/vs/workbench/services/views/common/viewsService.service';
 import { autorun } from '@codingame/monaco-vscode-api/vscode/vs/base/common/observableInternal/reactions/autorun';
 import { Orientation } from '@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/sash/sash';
+import { AICustomizationManagementSection, BUILTIN_STORAGE } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService';
 
 var AICustomizationManagementEditor_1;
 registerCss(aiCustomizationManagement);
 const $ = $$1;
 const aiCustomizationManagementSashBorder = registerColor("aiCustomizationManagement.sashBorder", PANEL_BORDER, ( localize(
-    5393,
-    "The color of the Chat Customization Management editor splitview sash border."
+    5410,
+    "The color of the Agent Customizations editor splitview sash border."
 )));
 class SectionItemDelegate {
     getHeight() {
@@ -96,7 +97,8 @@ class SectionItemDelegate {
     }
 }
 class SectionItemRenderer {
-    constructor() {
+    constructor(hoverService) {
+        this.hoverService = hoverService;
         this.templateId = "sectionItem";
     }
     renderTemplate(container) {
@@ -104,14 +106,17 @@ class SectionItemRenderer {
         const icon = append(container, $(".section-icon"));
         const label = append(container, $(".section-label"));
         const count = append(container, $(".section-count"));
+        const templateDisposables = ( new DisposableStore());
         return {
             container,
             icon,
             label,
-            count
+            count,
+            templateDisposables
         };
     }
     renderElement(element, index, templateData) {
+        templateData.templateDisposables.clear();
         templateData.icon.className = "section-icon";
         templateData.icon.classList.add(...ThemeIcon.asClassNameArray(element.icon));
         templateData.label.textContent = element.label;
@@ -122,8 +127,15 @@ class SectionItemRenderer {
             templateData.count.textContent = "";
             templateData.count.style.display = "none";
         }
+        templateData.templateDisposables.add(this.hoverService.setupManagedHover(
+            getDefaultHoverDelegate("element"),
+            templateData.container,
+            element.description
+        ));
+    }
+    disposeTemplate(templateData) {
+        templateData.templateDisposables.dispose();
     }
-    disposeTemplate() {}
 }
 let AICustomizationManagementEditor = class AICustomizationManagementEditor extends EditorPane {
     static {
@@ -146,14 +158,14 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         textModelService,
         configurationService,
         workingCopyService,
-        fileDialogService,
         hoverService,
         modelService,
         quickInputService,
         contextMenuService,
         fileService,
         notificationService,
-        harnessService
+        harnessService,
+        viewsService
     ) {
         super(
             AICustomizationManagementEditor_1.ID,
@@ -171,7 +183,6 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this.textModelService = textModelService;
         this.configurationService = configurationService;
         this.workingCopyService = workingCopyService;
-        this.fileDialogService = fileDialogService;
         this.hoverService = hoverService;
         this.modelService = modelService;
         this.quickInputService = quickInputService;
@@ -179,6 +190,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this.fileService = fileService;
         this.notificationService = notificationService;
         this.harnessService = harnessService;
+        this.viewsService = viewsService;
         this.editorActionButtonInProgress = false;
         this.editorModelChangeDisposables = this._register(( new DisposableStore()));
         this.builtinEditingSessions = ( new Map());
@@ -187,7 +199,6 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this.pluginDetailDisposables = this._register(( new DisposableStore()));
         this.sections = [];
         this.allSections = [];
-        this.selectedSection = AICustomizationManagementSection.Agents;
         this.editorDisposables = this._register(( new DisposableStore()));
         this.promptsSectionCountScheduler = this._register(( new RunOnceScheduler(() => this._doRefreshAllPromptsSectionCounts(), 100)));
         this._editorContentChanged = false;
@@ -207,36 +218,62 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this._register(toDisposable(() => this.disposeBuiltinEditingSessions()));
         const sectionInfo = {
             [AICustomizationManagementSection.Agents]: {
-                label: ( localize(5394, "Agents")),
-                icon: agentIcon
+                label: ( localize(5411, "Agents")),
+                icon: agentIcon,
+                description: ( localize(
+                    5412,
+                    "Define custom agents with specialized personas, tool access, and instructions for specific tasks."
+                ))
             },
             [AICustomizationManagementSection.Skills]: {
-                label: ( localize(5395, "Skills")),
-                icon: skillIcon
+                label: ( localize(5413, "Skills")),
+                icon: skillIcon,
+                description: ( localize(
+                    5414,
+                    "Create reusable skill files that provide domain-specific knowledge and workflows."
+                ))
             },
             [AICustomizationManagementSection.Instructions]: {
-                label: ( localize(5396, "Instructions")),
-                icon: instructionsIcon
+                label: ( localize(5415, "Instructions")),
+                icon: instructionsIcon,
+                description: ( localize(
+                    5416,
+                    "Set always-on instructions that guide AI behavior across your workspace or user profile."
+                ))
             },
             [AICustomizationManagementSection.Prompts]: {
-                label: ( localize(5397, "Prompts")),
-                icon: promptIcon
+                label: ( localize(5417, "Prompts")),
+                icon: promptIcon,
+                description: ( localize(5418, "Reusable prompt templates that can be invoked as slash commands."))
             },
             [AICustomizationManagementSection.Hooks]: {
-                label: ( localize(5398, "Hooks")),
-                icon: hookIcon
+                label: ( localize(5419, "Hooks")),
+                icon: hookIcon,
+                description: ( localize(
+                    5420,
+                    "Configure automated actions triggered by events like saving files or running tasks."
+                ))
             },
             [AICustomizationManagementSection.McpServers]: {
-                label: ( localize(5399, "MCP Servers")),
-                icon: Codicon.server
+                label: ( localize(5421, "MCP Servers")),
+                icon: Codicon.server,
+                description: ( localize(
+                    5422,
+                    "Connect external tool servers that extend AI capabilities with custom tools and data sources."
+                ))
             },
             [AICustomizationManagementSection.Plugins]: {
-                label: ( localize(5400, "Plugins")),
-                icon: pluginIcon
+                label: ( localize(5423, "Plugins")),
+                icon: pluginIcon,
+                description: ( localize(
+                    5424,
+                    "Install and manage agent plugins that add additional tools, skills, and integrations."
+                ))
             },
             [AICustomizationManagementSection.Models]: {
-                label: ( localize(5401, "Models")),
-                icon: Codicon.vm
+                label: ( localize(5425, "Models")),
+                icon: Codicon.vm,
+                description: ( localize(5426, "Configure and manage language models available for use."))
             }
         };
         for (const id of this.workspaceService.managementSections) {
@@ -253,8 +290,8 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const savedSection = this.storageService.get(AI_CUSTOMIZATION_MANAGEMENT_SELECTED_SECTION_KEY, StorageScope.PROFILE);
         if (savedSection && ( this.sections.some(s => s.id === savedSection))) {
             this.selectedSection = savedSection;
-        } else if (this.sections.length > 0) {
-            this.selectedSection = this.sections[0].id;
+        } else {
+            this.selectedSection = undefined;
         }
     }
     createEditor(parent) {
@@ -286,9 +323,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             layout: (width, _, height) => {
                 this.sidebarContainer.style.width = `${width}px`;
                 if (height !== undefined) {
-                    const footerHeight = this.folderPickerContainer?.offsetHeight ?? 0;
-                    const listHeight = height - 8 - footerHeight;
-                    this.sectionsList.layout(listHeight, width);
+                    this.sectionsList.layout(height - 8, width);
                 }
             }
         }, savedWidth, undefined, true);
@@ -360,29 +395,30 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         if (this.sectionsList) {
             this.sectionsList.splice(0, this.sectionsList.length, this.sections);
         }
-        if (!( this.sections.some(s => s.id === this.selectedSection)) && this.sections.length > 0) {
-            this.selectSection(this.sections[0].id);
+        this.welcomePage?.rebuildCards(( new Set(( this.sections.map(s => s.id)))));
+        if (this.selectedSection !== undefined && !( this.sections.some(s => s.id === this.selectedSection)) && this.sections.length > 0) {
+            this.showWelcomePage();
         } else {
             this.ensureSectionsListReflectsActiveSection();
         }
     }
     createSidebar() {
-        const sidebarContent = this.sidebarContent = append(this.sidebarContainer, $(".sidebar-content"));
-        this.createHarnessDropdown(sidebarContent);
+        const sidebarContent = append(this.sidebarContainer, $(".sidebar-content"));
+        this.createSidebarHeader(sidebarContent);
         const sectionsListContainer = append(sidebarContent, $(".sidebar-sections-list"));
         this.sectionsList = this.editorDisposables.add(this.instantiationService.createInstance(
             WorkbenchList,
             "AICustomizationManagementSections",
             sectionsListContainer,
             ( new SectionItemDelegate()),
-            [( new SectionItemRenderer())],
+            [( new SectionItemRenderer(this.hoverService))],
             {
                 multipleSelectionSupport: false,
                 setRowLineHeight: false,
                 horizontalScrolling: false,
                 accessibilityProvider: {
                     getAriaLabel: item => item.label,
-                    getWidgetAriaLabel: () => ( localize(5402, "Chat Customization Sections"))
+                    getWidgetAriaLabel: () => ( localize(5427, "Agent Customization Sections"))
                 },
                 openOnSingleClick: true,
                 identityProvider: {
@@ -394,7 +430,9 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this.ensureSectionsListReflectsActiveSection();
         this.editorDisposables.add(this.sectionsList.onDidChangeSelection(e => {
             if (e.elements.length === 0) {
-                this.ensureSectionsListReflectsActiveSection();
+                if (this.selectedSection !== undefined) {
+                    this.showWelcomePage();
+                }
                 return;
             }
             this.selectSection(e.elements[0].id);
@@ -410,6 +448,12 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             this.rebuildVisibleSections();
             this.ensureHarnessDropdown();
             this.updateHarnessDropdown();
+            if (this._previousActiveHarnessId !== undefined && this._previousActiveHarnessId !== activeId) {
+                for (const section of this.sections) {
+                    this.updateSectionCount(section.id, 0);
+                }
+            }
+            this._previousActiveHarnessId = activeId;
             this.refreshAllPromptsSectionCounts();
         }));
         if (!this.isHarnessSelectorEnabled) {
@@ -422,18 +466,39 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
                 }
             }
         }));
-        if (this.workspaceService.isSessionsWindow) {
-            this.createFolderPicker(sidebarContent);
-        }
     }
-    createHarnessDropdown(sidebarContent) {
+    createSidebarHeader(sidebarContent) {
+        const headerRow = this.sidebarHeaderContainer = append(sidebarContent, $(".sidebar-header-row"));
+        const homeButton = this.homeButton = append(headerRow, $("button.sidebar-home-button"));
+        homeButton.setAttribute("aria-label", ( localize(5428, "Overview")));
+        this.editorDisposables.add(
+            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), homeButton, ( localize(5429, "Back to overview")))
+        );
+        const homeIcon = append(homeButton, $("span.sidebar-home-icon"));
+        homeIcon.classList.add(...ThemeIcon.asClassNameArray(Codicon.home));
+        homeIcon.setAttribute("aria-hidden", "true");
+        const homeLabel = this.homeButtonLabel = append(homeButton, $("span.sidebar-home-label"));
+        homeLabel.textContent = ( localize(5430, "Overview"));
+        this.editorDisposables.add(addDisposableListener(homeButton, "click", () => {
+            this.showWelcomePage();
+        }));
+        this.createHarnessDropdown(headerRow);
+        this.updateHomeButtonStyle();
+    }
+    createHarnessDropdown(parent) {
         if (!this.isHarnessSelectorEnabled) {
             return;
         }
-        const container = this.harnessDropdownContainer = append(sidebarContent, $(".sidebar-harness-dropdown"));
+        const container = this.harnessDropdownContainer = append(parent, $(".sidebar-harness-dropdown"));
         this.harnessDropdownButton = append(container, $("button.harness-dropdown-button"));
-        this.harnessDropdownButton.setAttribute("aria-label", ( localize(5403, "Select customization target")));
+        this.harnessDropdownButton.setAttribute("aria-label", ( localize(5431, "Select customization target")));
         this.harnessDropdownButton.setAttribute("aria-haspopup", "listbox");
+        this.editorDisposables.add(
+            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), this.harnessDropdownButton, () => {
+                const descriptor = this.harnessService.availableHarnesses.get().find(h => h.id === this.harnessService.activeHarness.get());
+                return descriptor?.label ?? "";
+            })
+        );
         this.harnessDropdownIcon = append(this.harnessDropdownButton, $("span.harness-dropdown-icon"));
         this.harnessDropdownLabel = append(this.harnessDropdownButton, $("span.harness-dropdown-label"));
         append(
@@ -446,17 +511,25 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }));
     }
     ensureHarnessDropdown() {
-        const harnesses = this.harnessService.availableHarnesses.get();
-        const shouldShow = this.isHarnessSelectorEnabled && harnesses.length > 1;
-        if (shouldShow && !this.harnessDropdownContainer && this.sidebarContent) {
-            this.createHarnessDropdown(this.sidebarContent);
-        } else if (!shouldShow && this.harnessDropdownContainer) {
+        if (!this.isHarnessSelectorEnabled && this.harnessDropdownContainer) {
             this.harnessDropdownContainer.remove();
             this.harnessDropdownContainer = undefined;
             this.harnessDropdownButton = undefined;
             this.harnessDropdownIcon = undefined;
             this.harnessDropdownLabel = undefined;
+            this.updateHomeButtonStyle();
+        } else if (this.isHarnessSelectorEnabled && !this.harnessDropdownContainer && this.sidebarHeaderContainer) {
+            this.createHarnessDropdown(this.sidebarHeaderContainer);
+            this.updateHomeButtonStyle();
+        }
+    }
+    updateHomeButtonStyle() {
+        if (!this.homeButtonLabel || !this.homeButton) {
+            return;
         }
+        const harnessVisible = this.harnessDropdownContainer && this.harnessDropdownContainer.style.display !== "none";
+        this.homeButtonLabel.style.display = harnessVisible ? "none" : "";
+        this.homeButton.style.flex = harnessVisible ? "" : "1";
     }
     updateHarnessDropdown() {
         if (!this.harnessDropdownContainer || !this.harnessDropdownIcon || !this.harnessDropdownLabel) {
@@ -464,6 +537,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }
         const harnesses = this.harnessService.availableHarnesses.get();
         this.harnessDropdownContainer.style.display = harnesses.length <= 1 ? "none" : "";
+        this.updateHomeButtonStyle();
         const activeId = this.harnessService.activeHarness.get();
         const descriptor = harnesses.find(h => h.id === activeId);
         if (descriptor) {
@@ -491,62 +565,75 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             getCheckedActionsRepresentation: () => "radio"
         });
     }
-    createFolderPicker(sidebarContent) {
-        const footer = this.folderPickerContainer = append(sidebarContent, $(".sidebar-folder-picker"));
-        const button = append(footer, $("button.folder-picker-button"));
-        button.setAttribute("aria-label", ( localize(5404, "Browse folder")));
-        const folderIcon = append(button, $(`.codicon.codicon-${Codicon.folder.id}`));
-        folderIcon.classList.add("folder-picker-icon");
-        this.folderPickerLabel = append(button, $("span.folder-picker-label"));
-        this.folderPickerClearButton = append(footer, $("button.folder-picker-clear"));
-        this.folderPickerClearButton.setAttribute("aria-label", ( localize(5405, "Reset to session folder")));
-        append(this.folderPickerClearButton, $(`.codicon.codicon-${Codicon.close.id}`));
-        this.editorDisposables.add(addDisposableListener(button, "click", () => {
-            this.browseForFolder();
-        }));
-        this.editorDisposables.add(addDisposableListener(this.folderPickerClearButton, "click", () => {
-            this.workspaceService.clearOverrideProjectRoot();
-        }));
+    createWelcomePage(parent) {
+        this.welcomePage = this.editorDisposables.add(( new AICustomizationWelcomePage(parent, this.workspaceService.welcomePageFeatures, {
+            selectSection: section => this.selectSection(section),
+            selectSectionWithMarketplace: section => this.selectSection(section, {
+                showMarketplace: true
+            }),
+            closeEditor: () => {
+                if (this.input) {
+                    this.group.closeEditor(this.input);
+                }
+            },
+            prefillChat: async (query, options) => {
+                try {
+                    if (this.workspaceService.isSessionsWindow) {
+                        const sessionsViewId = "workbench.view.sessions.chat";
+                        if (options?.newChat) {
+                            await this.commandService.executeCommand("workbench.action.sessions.newChat");
+                        }
+                        const view = await this.viewsService.openView(sessionsViewId, true);
+                        const chatView = view;
+                        if (options?.isPartialQuery && chatView?.prefillInput) {
+                            chatView.prefillInput(query);
+                        } else if (chatView?.sendQuery) {
+                            chatView.sendQuery(query);
+                        }
+                    } else {
+                        if (options?.newChat) {
+                            await this.commandService.executeCommand("workbench.action.chat.newChat");
+                        }
+                        await this.commandService.executeCommand("workbench.action.chat.open", {
+                            query,
+                            isPartialQuery: options?.isPartialQuery ?? false
+                        });
+                    }
+                } catch (err) {
+                    onUnexpectedError(err);
+                }
+            }
+        }, this.commandService, this.workspaceService, this.hoverService)));
+        this.welcomePage.rebuildCards(( new Set(( this.sections.map(s => s.id)))));
+    }
+    createBackArrowButton() {
+        const button = $("button.section-back-arrow-button");
+        button.type = "button";
+        button.setAttribute("aria-label", ( localize(5432, "Back to overview")));
         this.editorDisposables.add(
-            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), button, () => {
-                const root = this.workspaceService.getActiveProjectRoot();
-                return root?.fsPath ?? "";
-            })
+            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), button, ( localize(5433, "Back to overview")))
         );
-        this.editorDisposables.add(autorun(reader => {
-            const root = this.workspaceService.activeProjectRoot.read(reader);
-            const hasOverride = this.workspaceService.hasOverrideProjectRoot.read(reader);
-            this.updateFolderPickerLabel(root, hasOverride);
+        const icon = append(button, $("span.section-back-arrow-icon"));
+        icon.classList.add(...ThemeIcon.asClassNameArray(Codicon.arrowLeft));
+        icon.setAttribute("aria-hidden", "true");
+        this.editorDisposables.add(addDisposableListener(button, "click", () => {
+            this.showWelcomePage();
         }));
+        return button;
     }
-    updateFolderPickerLabel(root, hasOverride) {
-        if (this.folderPickerLabel) {
-            this.folderPickerLabel.textContent = root ? basename(root) : ( localize(5406, "No folder"));
-        }
-        if (this.folderPickerClearButton) {
-            this.folderPickerClearButton.style.display = hasOverride ? "" : "none";
-        }
-    }
-    async browseForFolder() {
-        const result = await this.fileDialogService.showOpenDialog({
-            canSelectFolders: true,
-            canSelectFiles: false,
-            canSelectMany: false,
-            title: ( localize(5407, "Select Folder to Explore")),
-            defaultUri: this.workspaceService.getActiveProjectRoot()
-        });
-        if (result?.[0]) {
-            this.workspaceService.setOverrideProjectRoot(result[0]);
-        }
+    injectBackArrowIntoSearchRow(widget) {
+        widget.prependToSearchRow(this.createBackArrowButton());
     }
     createContent() {
         const contentInner = append(this.contentContainer, $(".content-inner"));
+        this.createWelcomePage(contentInner);
         this.promptsContentContainer = append(contentInner, $(".prompts-content-container"));
         this.listWidget = this.editorDisposables.add(this.instantiationService.createInstance(AICustomizationListWidget));
         this.promptsContentContainer.appendChild(this.listWidget.element);
+        this.injectBackArrowIntoSearchRow(this.listWidget);
         this.editorDisposables.add(this.listWidget.onDidSelectItem(item => {
             this.telemetryService.publicLog2("chatCustomizationEditor.itemSelected", {
-                section: this.selectedSection,
+                section: this.selectedSection ?? "welcome",
                 promptType: item.promptType,
                 storage: item.storage ?? "external"
             });
@@ -577,16 +664,18 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const hasSections = ( new Set(this.workspaceService.managementSections));
         if (( hasSections.has(AICustomizationManagementSection.Models))) {
             this.modelsContentContainer = append(contentInner, $(".models-content-container"));
+            const modelsBackBar = append(this.modelsContentContainer, $(".section-back-bar"));
+            modelsBackBar.appendChild(this.createBackArrowButton());
             this.modelsWidget = this.editorDisposables.add(this.instantiationService.createInstance(ChatModelsWidget));
             this.modelsContentContainer.appendChild(this.modelsWidget.element);
             this.modelsFooterElement = append(this.modelsContentContainer, $(".section-footer"));
             const modelsDescription = append(this.modelsFooterElement, $("p.section-footer-description"));
             modelsDescription.textContent = ( localize(
-                5408,
+                5434,
                 "Browse and manage language models from different providers. Select models for use in chat, code completion, and other AI features."
             ));
             const modelsLink = append(this.modelsFooterElement, $("a.section-footer-link"));
-            modelsLink.textContent = ( localize(5409, "Learn more about language models"));
+            modelsLink.textContent = ( localize(5435, "Learn more about language models"));
             modelsLink.href = "https://code.visualstudio.com/docs/copilot/customization/language-models";
             this.editorDisposables.add(addDisposableListener(modelsLink, "click", e => {
                 e.preventDefault();
@@ -597,6 +686,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             this.mcpContentContainer = append(contentInner, $(".mcp-content-container"));
             this.mcpListWidget = this.editorDisposables.add(this.instantiationService.createInstance(McpListWidget));
             this.mcpContentContainer.appendChild(this.mcpListWidget.element);
+            this.injectBackArrowIntoSearchRow(this.mcpListWidget);
             this.mcpDetailContainer = append(contentInner, $(".mcp-detail-container"));
             this.createEmbeddedMcpDetail();
             this.editorDisposables.add(this.mcpListWidget.onDidSelectServer(server => {
@@ -610,6 +700,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             this.pluginContentContainer = append(contentInner, $(".plugin-content-container"));
             this.pluginListWidget = this.editorDisposables.add(this.instantiationService.createInstance(PluginListWidget));
             this.pluginContentContainer.appendChild(this.pluginListWidget.element);
+            this.injectBackArrowIntoSearchRow(this.pluginListWidget);
             this.pluginDetailContainer = append(contentInner, $(".plugin-detail-container"));
             this.createEmbeddedPluginDetail();
             this.editorDisposables.add(this.pluginListWidget.onDidSelectPlugin(item => {
@@ -684,8 +775,25 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             }
         }
     }
-    selectSection(section) {
-        if (this.selectedSection === section) {
+    showWelcomePage() {
+        if (this.viewMode === "editor") {
+            this.goBackToList();
+        }
+        if (this.viewMode === "mcpDetail") {
+            this.goBackFromMcpDetail();
+        }
+        if (this.viewMode === "pluginDetail") {
+            this.goBackFromPluginDetail();
+        }
+        this.selectedSection = undefined;
+        this.sectionContextKey.set("");
+        this.storageService.remove(AI_CUSTOMIZATION_MANAGEMENT_SELECTED_SECTION_KEY, StorageScope.PROFILE);
+        this.welcomePage?.reset();
+        this.updateContentVisibility();
+        this.ensureSectionsListReflectsActiveSection(undefined);
+    }
+    selectSection(section, options) {
+        if (this.selectedSection === section && !options?.showMarketplace) {
             this.ensureSectionsListReflectsActiveSection(section);
             return;
         }
@@ -714,11 +822,23 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             void this.listWidget.setSection(section);
         }
         this.ensureSectionsListReflectsActiveSection(section);
+        if (options?.showMarketplace) {
+            if (section === AICustomizationManagementSection.McpServers) {
+                this.mcpListWidget?.showBrowseMarketplace();
+            } else if (section === AICustomizationManagementSection.Plugins) {
+                this.pluginListWidget?.showBrowseMarketplace();
+            }
+        }
     }
     ensureSectionsListReflectsActiveSection(section = this.selectedSection) {
         if (!this.sectionsList) {
             return;
         }
+        if (section === undefined) {
+            this.sectionsList.setSelection([]);
+            this.sectionsList.setFocus([]);
+            return;
+        }
         const index = this.sections.findIndex(s => s.id === section);
         if (index < 0) {
             return;
@@ -737,10 +857,14 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const isMcpDetailMode = this.viewMode === "mcpDetail";
         const isPluginDetailMode = this.viewMode === "pluginDetail";
         const isDetailMode = isMcpDetailMode || isPluginDetailMode;
-        const isPromptsSection = this.isPromptsSection(this.selectedSection);
+        const isWelcome = this.selectedSection === undefined;
+        const isPromptsSection = this.selectedSection !== undefined && this.isPromptsSection(this.selectedSection);
         const isModelsSection = this.selectedSection === AICustomizationManagementSection.Models;
         const isMcpSection = this.selectedSection === AICustomizationManagementSection.McpServers;
         const isPluginsSection = this.selectedSection === AICustomizationManagementSection.Plugins;
+        if (this.welcomePage) {
+            this.welcomePage.container.style.display = isWelcome && !isEditorMode && !isDetailMode ? "" : "none";
+        }
         if (this.promptsContentContainer) {
             this.promptsContentContainer.style.display = !isEditorMode && !isDetailMode && isPromptsSection ? "" : "none";
         }
@@ -771,7 +895,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
     }
     async createNewItemWithAI(type) {
         this.telemetryService.publicLog2("chatCustomizationEditor.createItem", {
-            section: this.selectedSection,
+            section: this.selectedSection ?? "welcome",
             promptType: type,
             creationMode: "ai",
             target: "workspace"
@@ -783,7 +907,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
     }
     async createNewItemManual(type, target, rootFileName) {
         this.telemetryService.publicLog2("chatCustomizationEditor.createItem", {
-            section: this.selectedSection,
+            section: this.selectedSection ?? "welcome",
             promptType: type,
             creationMode: "manual",
             target: target === "workspace-root" ? "workspace" : target
@@ -793,7 +917,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             if (!projectRoot) {
                 return;
             }
-            const override = this.harnessService.getActiveDescriptor().sectionOverrides?.get(this.selectedSection);
+            const override = this.selectedSection ? this.harnessService.getActiveDescriptor().sectionOverrides?.get(this.selectedSection) : undefined;
             const fileName = rootFileName ?? override?.rootFile ?? AGENT_MD_FILENAME;
             const fileUri = URI.joinPath(projectRoot, fileName);
             if (await this.fileService.exists(fileUri)) {
@@ -828,7 +952,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         if (targetDir === null) {
             return;
         }
-        const override = this.harnessService.getActiveDescriptor().sectionOverrides?.get(this.selectedSection);
+        const override = this.selectedSection ? this.harnessService.getActiveDescriptor().sectionOverrides?.get(this.selectedSection) : undefined;
         const options = {
             targetFolder: targetDir,
             targetStorage: target === "user" ? PromptsStorage.user : PromptsStorage.local,
@@ -910,7 +1034,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             uri: folder.uri
         })));
         const picked = await this.quickInputService.pick(items, {
-            placeHolder: ( localize(5410, "Select a directory for the new customization file"))
+            placeHolder: ( localize(5436, "Select a directory for the new customization file"))
         });
         return picked?.uri ?? null;
     }
@@ -925,10 +1049,10 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
     async setInput(input, options, context, token) {
         this.workspaceService.clearOverrideProjectRoot();
         this.inEditorContextKey.set(true);
-        this.sectionContextKey.set(this.selectedSection);
+        this.sectionContextKey.set(this.selectedSection ?? "");
         input.setSaveHandler(() => this.handleBuiltinSave());
         this.telemetryService.publicLog2("chatCustomizationEditor.opened", {
-            section: this.selectedSection
+            section: this.selectedSection ?? "welcome"
         });
         await super.setInput(input, options, context, token);
         if (this.dimension) {
@@ -968,6 +1092,10 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             this.embeddedEditor?.focus();
             return;
         }
+        if (this.selectedSection === undefined) {
+            this.welcomePage?.focus();
+            return;
+        }
         if (this.selectedSection === AICustomizationManagementSection.McpServers) {
             this.mcpListWidget?.focusSearch();
         } else if (this.selectedSection === AICustomizationManagementSection.Plugins) {
@@ -978,7 +1106,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             this.listWidget?.focusSearch();
         }
     }
-    selectSectionById(sectionId) {
+    selectSectionById(sectionId, options) {
         const index = this.sections.findIndex(s => s.id === sectionId);
         if (index >= 0) {
             if (this.viewMode === "editor") {
@@ -1006,6 +1134,13 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
                 this.layout(this.dimension);
             }
             this.ensureSectionsListReflectsActiveSection(sectionId);
+            if (options?.showMarketplace) {
+                if (sectionId === AICustomizationManagementSection.McpServers) {
+                    this.mcpListWidget?.showBrowseMarketplace();
+                } else if (sectionId === AICustomizationManagementSection.Plugins) {
+                    this.pluginListWidget?.showBrowseMarketplace();
+                }
+            }
         }
     }
     refreshList() {
@@ -1029,7 +1164,12 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }
         const editorHeader = append(this.editorContentContainer, $(".editor-header"));
         this.editorActionButton = append(editorHeader, $("button.editor-back-button"));
-        this.editorActionButton.setAttribute("aria-label", ( localize(5411, "Back to list")));
+        this.editorActionButton.setAttribute("aria-label", ( localize(5437, "Back to list")));
+        this.editorDisposables.add(this.hoverService.setupManagedHover(
+            getDefaultHoverDelegate("element"),
+            this.editorActionButton,
+            ( localize(5438, "Back to list"))
+        ));
         this.editorActionButtonIcon = append(
             this.editorActionButton,
             $(`.codicon.codicon-${Codicon.arrowLeft.id}.editor-action-button-icon`)
@@ -1038,7 +1178,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         this.editorDisposables.add(addDisposableListener(this.editorActionButton, "click", () => {
             void this.handleEditorActionButton().catch(error => {
                 console.error("Failed to handle editor back action:", error);
-                this.notificationService.error(( localize(5412, "Failed to finish the prompt action.")));
+                this.notificationService.error(( localize(5439, "Failed to finish the prompt action.")));
             });
         }));
         const itemInfo = append(editorHeader, $(".editor-item-info"));
@@ -1142,7 +1282,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
                     this._editorContentChanged = this.workingCopyService.isDirty(uri);
                     this.editorSaveIndicator.className = "editor-save-indicator visible saved";
                     this.editorSaveIndicator.classList.add(...ThemeIcon.asClassNameArray(Codicon.check));
-                    this.editorSaveIndicator.title = ( localize(5413, "Saved"));
+                    this.editorSaveIndicator.title = ( localize(5440, "Saved"));
                 }
             }));
         } catch (error) {
@@ -1187,7 +1327,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             const saveRequest = backgroundSaveRequest;
             void this.saveExistingCustomization(saveRequest).catch(error => {
                 console.error("Failed to save customization changes on exit:", error);
-                this.notificationService.warn(( localize(5414, "Could not save changes to {0}.", basename(saveRequest.fileUri))));
+                this.notificationService.warn(( localize(5441, "Could not save changes to {0}.", basename(saveRequest.fileUri))));
             });
         }
     }
@@ -1280,7 +1420,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const workspaceFolder = resolveWorkspaceTargetDirectory(this.workspaceService, promptType);
         if (workspaceFolder) {
             items.push({
-                label: ( localize(5415, "Workspace")),
+                label: ( localize(5442, "Workspace")),
                 description: workspaceFolder.fsPath,
                 target: "workspace",
                 folder: workspaceFolder
@@ -1289,19 +1429,19 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const userFolder = await resolveUserTargetDirectory(this.promptsService, promptType);
         if (userFolder) {
             items.push({
-                label: ( localize(5416, "User")),
+                label: ( localize(5443, "User")),
                 description: userFolder.fsPath,
                 target: "user",
                 folder: userFolder
             });
         }
         items.push({
-            label: ( localize(5417, "Cancel")),
+            label: ( localize(5444, "Cancel")),
             target: "cancel"
         });
         return this.quickInputService.pick(items, {
             canPickMany: false,
-            placeHolder: ( localize(5418, "Select Workspace, User, or Cancel")),
+            placeHolder: ( localize(5445, "Select Workspace, User, or Cancel")),
             matchOnDescription: true
         });
     }
@@ -1334,7 +1474,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
                     void this.listWidget?.refresh();
                 }, error => {
                     console.error("Failed to save built-in override:", error);
-                    this.notificationService.warn(saveRequest.target === "workspace" ? ( localize(5419, "Could not save the override to the workspace.")) : ( localize(5420, "Could not save the override to your user folder.")));
+                    this.notificationService.warn(saveRequest.target === "workspace" ? ( localize(5446, "Could not save the override to the workspace.")) : ( localize(5447, "Could not save the override to your user folder.")));
                 });
             }
         } finally {
@@ -1350,8 +1490,8 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         const shouldShowBuiltinSaveAction = this.shouldShowBuiltinSaveAction();
         this.editorActionButtonIcon.className = `codicon codicon-${shouldShowBuiltinSaveAction ? Codicon.save.id : Codicon.arrowLeft.id} editor-action-button-icon`;
         this.editorActionButton.disabled = this.editorActionButtonInProgress;
-        this.editorActionButton.setAttribute("aria-label", shouldShowBuiltinSaveAction ? ( localize(5421, "Save override")) : ( localize(5411, "Back to list")));
-        this.editorActionButton.title = shouldShowBuiltinSaveAction ? ( localize(5422, "Save override (choose Workspace, User, or Cancel)")) : ( localize(5411, "Back to list"));
+        this.editorActionButton.setAttribute("aria-label", shouldShowBuiltinSaveAction ? ( localize(5448, "Save override")) : ( localize(5437, "Back to list")));
+        this.editorActionButton.title = shouldShowBuiltinSaveAction ? ( localize(5449, "Save override (choose Workspace, User, or Cancel)")) : ( localize(5437, "Back to list"));
     }
     shouldShowBuiltinSaveAction() {
         return this._editorContentChanged && this.currentEditingStorage === BUILTIN_STORAGE && (this.currentEditingPromptType === PromptsType.prompt || this.currentEditingPromptType === PromptsType.skill);
@@ -1386,7 +1526,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
             return true;
         } catch (error) {
             console.error("Failed to save built-in override:", error);
-            this.notificationService.warn(target.target === "workspace" ? ( localize(5419, "Could not save the override to the workspace.")) : ( localize(5420, "Could not save the override to your user folder.")));
+            this.notificationService.warn(target.target === "workspace" ? ( localize(5446, "Could not save the override to the workspace.")) : ( localize(5447, "Could not save the override to your user folder.")));
             return false;
         }
     }
@@ -1415,7 +1555,10 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }
         const detailHeader = append(this.mcpDetailContainer, $(".editor-header"));
         const backButton = append(detailHeader, $("button.editor-back-button"));
-        backButton.setAttribute("aria-label", ( localize(5423, "Back to MCP servers")));
+        backButton.setAttribute("aria-label", ( localize(5450, "Back to MCP servers")));
+        this.editorDisposables.add(
+            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), backButton, ( localize(5451, "Back to MCP servers")))
+        );
         const backIconEl = append(backButton, $(`.codicon.codicon-${Codicon.arrowLeft.id}`));
         backIconEl.setAttribute("aria-hidden", "true");
         this.editorDisposables.add(addDisposableListener(backButton, "click", () => {
@@ -1460,7 +1603,10 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }
         const detailHeader = append(this.pluginDetailContainer, $(".editor-header"));
         const backButton = append(detailHeader, $("button.editor-back-button"));
-        backButton.setAttribute("aria-label", ( localize(5424, "Back to plugins")));
+        backButton.setAttribute("aria-label", ( localize(5452, "Back to plugins")));
+        this.editorDisposables.add(
+            this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), backButton, ( localize(5453, "Back to plugins")))
+        );
         const backIconEl = append(backButton, $(`.codicon.codicon-${Codicon.arrowLeft.id}`));
         backIconEl.setAttribute("aria-hidden", "true");
         this.editorDisposables.add(addDisposableListener(backButton, "click", () => {
@@ -1491,7 +1637,7 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
     }
     async showPluginDetail(item) {
         if (this.selectedSection !== AICustomizationManagementSection.Plugins) {
-            this.pluginDetailReturnSection = this.selectedSection;
+            this.pluginDetailReturnSection = this.selectedSection ?? AICustomizationManagementSection.Agents;
         }
         await this.showEmbeddedPluginDetail(item);
     }
@@ -1514,6 +1660,6 @@ let AICustomizationManagementEditor = class AICustomizationManagementEditor exte
         }
     }
 };
-AICustomizationManagementEditor = AICustomizationManagementEditor_1 = ( __decorate([( __param(1, ITelemetryService)), ( __param(2, IThemeService)), ( __param(3, IStorageService)), ( __param(4, IInstantiationService)), ( __param(5, IContextKeyService)), ( __param(6, IOpenerService)), ( __param(7, ICommandService)), ( __param(8, IAICustomizationWorkspaceService)), ( __param(9, IPromptsService)), ( __param(10, ITextModelService)), ( __param(11, IConfigurationService)), ( __param(12, IWorkingCopyService)), ( __param(13, IFileDialogService)), ( __param(14, IHoverService)), ( __param(15, IModelService)), ( __param(16, IQuickInputService)), ( __param(17, IContextMenuService)), ( __param(18, IFileService)), ( __param(19, INotificationService)), ( __param(20, ICustomizationHarnessService))], AICustomizationManagementEditor));
+AICustomizationManagementEditor = AICustomizationManagementEditor_1 = ( __decorate([( __param(1, ITelemetryService)), ( __param(2, IThemeService)), ( __param(3, IStorageService)), ( __param(4, IInstantiationService)), ( __param(5, IContextKeyService)), ( __param(6, IOpenerService)), ( __param(7, ICommandService)), ( __param(8, IAICustomizationWorkspaceService)), ( __param(9, IPromptsService)), ( __param(10, ITextModelService)), ( __param(11, IConfigurationService)), ( __param(12, IWorkingCopyService)), ( __param(13, IHoverService)), ( __param(14, IModelService)), ( __param(15, IQuickInputService)), ( __param(16, IContextMenuService)), ( __param(17, IFileService)), ( __param(18, INotificationService)), ( __param(19, ICustomizationHarnessService)), ( __param(20, IViewsService))], AICustomizationManagementEditor));
 
 export { AICustomizationManagementEditor, aiCustomizationManagementSashBorder };