@codingame/monaco-vscode-chat-service-override 36.2.7 → 37.1.0

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

@@ -9,9 +9,10 @@ import { IModalEditorOptions, IModalEditorOptionsProvider } from "@codingame/mon
 export declare class AICustomizationManagementEditorInput extends EditorInput implements IModalEditorOptionsProvider {
     static readonly ID: string;
     readonly resource: undefined;
-    private static _activeHarnessLabel;
     private _isDirty;
     private _saveHandler?;
+    private _harnessLabel;
+    private _workspaceLabel;
     get capabilities(): EditorInputCapabilities;
     private static _instance;
     /**
@@ -22,13 +23,15 @@ export declare class AICustomizationManagementEditorInput extends EditorInput im
     matches(otherInput: EditorInput | IUntypedEditorInput): boolean;
     get typeId(): string;
     getName(): string;
+    getDescription(): string | undefined;
     getIcon(): ThemeIcon;
+    getLabelExtraClasses(): string[];
     getModalEditorOptions(): IModalEditorOptions;
     resolve(): Promise<null>;
     isDirty(): boolean;
     save(group: GroupIdentifier, options?: ISaveOptions): Promise<EditorInput | undefined>;
     revert(): Promise<void>;
-    setHarnessLabel(label: string): void;
     setDirty(dirty: boolean): void;
     setSaveHandler(handler: (() => Promise<boolean>) | undefined): void;
+    setTargetLabels(harnessLabel: string | undefined, workspaceLabel?: string): void;
 }

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

@@ -9,15 +9,11 @@ class AICustomizationManagementEditorInput extends EditorInput {
     static {
         this.ID = AI_CUSTOMIZATION_MANAGEMENT_EDITOR_INPUT_ID;
     }
-    static {
-        this._activeHarnessLabel = "";
-    }
     get capabilities() {
         return super.capabilities | EditorInputCapabilities.Singleton | EditorInputCapabilities.RequiresModal;
     }
     static getOrCreate() {
         if (!AICustomizationManagementEditorInput._instance || AICustomizationManagementEditorInput._instance.isDisposed()) {
-            AICustomizationManagementEditorInput._activeHarnessLabel = "";
             AICustomizationManagementEditorInput._instance = ( new AICustomizationManagementEditorInput());
         }
         return AICustomizationManagementEditorInput._instance;
@@ -34,12 +30,23 @@ class AICustomizationManagementEditorInput extends EditorInput {
         return AICustomizationManagementEditorInput.ID;
     }
     getName() {
-        const harnessLabel = AICustomizationManagementEditorInput._activeHarnessLabel;
-        return harnessLabel ? ( localize(5921, "Agent Customizations for {0}", harnessLabel)) : ( localize(5922, "Agent Customizations"));
+        return localize(6674, "Agent Customizations");
+    }
+    getDescription() {
+        if (this._harnessLabel && this._workspaceLabel) {
+            return localize(6675, "({0} · {1})", this._harnessLabel, this._workspaceLabel);
+        }
+        if (this._harnessLabel || this._workspaceLabel) {
+            return localize(6676, "({0})", this._harnessLabel ?? this._workspaceLabel);
+        }
+        return undefined;
     }
     getIcon() {
         return Codicon.settingsGear;
     }
+    getLabelExtraClasses() {
+        return ["ai-customization-management-editor-label"];
+    }
     getModalEditorOptions() {
         return {
             compactHeader: true
@@ -64,13 +71,6 @@ class AICustomizationManagementEditorInput extends EditorInput {
     async revert() {
         this.setDirty(false);
     }
-    setHarnessLabel(label) {
-        if (AICustomizationManagementEditorInput._activeHarnessLabel === label) {
-            return;
-        }
-        AICustomizationManagementEditorInput._activeHarnessLabel = label;
-        this._onDidChangeLabel.fire();
-    }
     setDirty(dirty) {
         if (this._isDirty !== dirty) {
             this._isDirty = dirty;
@@ -80,6 +80,14 @@ class AICustomizationManagementEditorInput extends EditorInput {
     setSaveHandler(handler) {
         this._saveHandler = handler;
     }
+    setTargetLabels(harnessLabel, workspaceLabel) {
+        if (this._harnessLabel === harnessLabel && this._workspaceLabel === workspaceLabel) {
+            return;
+        }
+        this._harnessLabel = harnessLabel;
+        this._workspaceLabel = workspaceLabel;
+        this._onDidChangeLabel.fire();
+    }
 }
 
 export { AICustomizationManagementEditorInput };

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

@@ -0,0 +1,26 @@
+import { Dimension } from "@codingame/monaco-vscode-api/vscode/vs/base/browser/dom";
+import { IDisposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { ThemeIcon } from "@codingame/monaco-vscode-api/vscode/vs/base/common/themables";
+import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+import { AICustomizationManagementSection } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService";
+export interface IAICustomizationManagementSectionWidget extends IDisposable {
+    layout?(dimension: Dimension): void;
+    focus?(): void;
+}
+export interface IAICustomizationManagementSectionContribution {
+    readonly id: AICustomizationManagementSection;
+    readonly label: string;
+    readonly icon: ThemeIcon;
+    readonly description: string;
+    readonly supportsHarness: (harnessId: string) => boolean;
+    create(instantiationService: IInstantiationService, container: HTMLElement): IAICustomizationManagementSectionWidget;
+}
+declare class AICustomizationManagementSectionRegistry {
+    private readonly contributions;
+    register(contribution: IAICustomizationManagementSectionContribution): IDisposable;
+    has(id: AICustomizationManagementSection): boolean;
+    getDefault(id: AICustomizationManagementSection): IAICustomizationManagementSectionContribution | undefined;
+    get(id: AICustomizationManagementSection, harnessId: string): IAICustomizationManagementSectionContribution | undefined;
+}
+export declare const aiCustomizationManagementSectionRegistry: AICustomizationManagementSectionRegistry;
+export {};

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

@@ -0,0 +1,34 @@
+
+import { toDisposable } from '@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle';
+
+class AICustomizationManagementSectionRegistry {
+    constructor() {
+        this.contributions = ( new Map());
+    }
+    register(contribution) {
+        const contributions = this.contributions.get(contribution.id) ?? [];
+        contributions.push(contribution);
+        this.contributions.set(contribution.id, contributions);
+        return toDisposable(() => {
+            const index = contributions.indexOf(contribution);
+            if (index !== -1) {
+                contributions.splice(index, 1);
+            }
+            if (contributions.length === 0) {
+                this.contributions.delete(contribution.id);
+            }
+        });
+    }
+    has(id) {
+        return ( this.contributions.has(id));
+    }
+    getDefault(id) {
+        return this.contributions.get(id)?.[0];
+    }
+    get(id, harnessId) {
+        return this.contributions.get(id)?.find(contribution => contribution.supportsHarness(harnessId));
+    }
+}
+const aiCustomizationManagementSectionRegistry = ( new AICustomizationManagementSectionRegistry());
+
+export { aiCustomizationManagementSectionRegistry };

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

@@ -0,0 +1,2 @@
+import { IAgentPlugin } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/plugins/agentPluginService";
+export declare function getPluginInclusionLabel(plugin: IAgentPlugin): string;

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

@@ -0,0 +1,23 @@
+
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { ContributionEnablementState } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/enablement';
+
+function getPluginInclusionLabel(plugin) {
+    if (plugin.policyBlocked?.get() === true) {
+        return localize(6677, "Blocked by Organization");
+    }
+    switch (plugin.enablement.get()) {
+    case ContributionEnablementState.EnabledWorkspace:
+        return localize(6678, "Included in Workspace");
+    case ContributionEnablementState.DisabledWorkspace:
+        return localize(6679, "Excluded from Workspace");
+    case ContributionEnablementState.EnabledProfile:
+        return localize(6680, "Included for Profile");
+    case ContributionEnablementState.DisabledProfile:
+        return localize(6681, "Excluded from Profile");
+    default:
+        return localize(6682, "Inclusion Unknown");
+    }
+}
+
+export { getPluginInclusionLabel };

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

@@ -1,13 +1,26 @@
 import { Disposable, IDisposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
 import { ICommandService } from "@codingame/monaco-vscode-api/vscode/vs/platform/commands/common/commands.service";
 import { AICustomizationManagementSection } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/aiCustomization/aiCustomizationManagement";
+import { CustomizationMigrationCategoryId } from "./customizationMigrationCategories.js";
 import { IWelcomePageFeatures } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService";
 import { IAICustomizationWorkspaceService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService.service";
 import { IHoverService } from "@codingame/monaco-vscode-api/vscode/vs/platform/hover/browser/hover.service";
+/**
+ * A migration flow offered on the overview, already resolved to display copy.
+ */
+export interface ICustomizationMigrationCategorySummary {
+    readonly id: CustomizationMigrationCategoryId;
+    readonly label: string;
+    readonly description: string;
+    readonly actionLabel: string;
+    readonly actionAriaLabel: string;
+    readonly count: number;
+}
 export interface IWelcomePageCallbacks {
     selectSection(section: AICustomizationManagementSection): void;
     selectSectionWithMarketplace(section: AICustomizationManagementSection): void;
     closeEditor(): void;
+    reviewMigrations(): void;
     /**
      * Prefill the chat input with a query. In the sessions window this
      * uses the sessions chat widget; in core VS Code it opens the chat view.
@@ -24,6 +37,7 @@ export interface IAICustomizationWelcomePageImplementation extends IDisposable {
     readonly container: HTMLElement;
     rebuildCards(visibleSectionIds: ReadonlySet<AICustomizationManagementSection>): void;
     setHarnessLabel(label: string): void;
+    setMigrationCategories(categories: readonly ICustomizationMigrationCategorySummary[]): void;
     focus(): void;
     /** Called when the welcome page becomes visible after navigation — clears any transient state. */
     reset?(): void;
@@ -37,6 +51,7 @@ export declare class AICustomizationWelcomePage extends Disposable {
     constructor(parent: HTMLElement, welcomePageFeatures: IWelcomePageFeatures | undefined, callbacks: IWelcomePageCallbacks, commandService: ICommandService, workspaceService: IAICustomizationWorkspaceService, hoverService: IHoverService, harnessLabel: string);
     rebuildCards(visibleSectionIds: ReadonlySet<AICustomizationManagementSection>): void;
     setHarnessLabel(label: string): void;
+    setMigrationCategories(categories: readonly ICustomizationMigrationCategorySummary[]): void;
     focus(): void;
     reset(): void;
 }

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

@@ -34,6 +34,9 @@ class AICustomizationWelcomePage extends Disposable {
     setHarnessLabel(label) {
         this.implementation.setHarnessLabel(label);
     }
+    setMigrationCategories(categories) {
+        this.implementation.setMigrationCategories(categories);
+    }
     focus() {
         this.implementation.focus();
     }

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

@@ -3,11 +3,12 @@ import { ICommandService } from "@codingame/monaco-vscode-api/vscode/vs/platform
 import { AICustomizationManagementSection } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/aiCustomization/aiCustomizationManagement";
 import { IWelcomePageFeatures } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService";
 import { IAICustomizationWorkspaceService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService.service";
-import type { IAICustomizationWelcomePageImplementation, IWelcomePageCallbacks } from "./aiCustomizationWelcomePage.js";
+import type { IAICustomizationWelcomePageImplementation, ICustomizationMigrationCategorySummary, IWelcomePageCallbacks } from "./aiCustomizationWelcomePage.js";
 import { IHoverService } from "@codingame/monaco-vscode-api/vscode/vs/platform/hover/browser/hover.service";
 export declare class PromptLaunchersAICustomizationWelcomePage extends Disposable implements IAICustomizationWelcomePageImplementation {
     private readonly welcomePageFeatures;
     private readonly callbacks;
+    private readonly commandService;
     private readonly workspaceService;
     private readonly hoverService;
     private harnessLabel;
@@ -18,15 +19,22 @@ export declare class PromptLaunchersAICustomizationWelcomePage extends Disposabl
     private firstCard;
     private heading;
     private inputElement;
+    private visibleSectionIds;
     private sentLabel;
     private submitBtn;
     private inputRow;
+    private migrationCategories;
     private readonly categoryDescriptions;
-    constructor(parent: HTMLElement, welcomePageFeatures: IWelcomePageFeatures | undefined, callbacks: IWelcomePageCallbacks, _commandService: ICommandService, workspaceService: IAICustomizationWorkspaceService, hoverService: IHoverService, harnessLabel: string);
+    private readonly standaloneCustomizations;
+    constructor(parent: HTMLElement, welcomePageFeatures: IWelcomePageFeatures | undefined, callbacks: IWelcomePageCallbacks, commandService: ICommandService, workspaceService: IAICustomizationWorkspaceService, hoverService: IHoverService, harnessLabel: string);
     private _clearSentState;
     reset(): void;
     rebuildCards(visibleSectionIds: ReadonlySet<AICustomizationManagementSection>): void;
+    private renderOverviewSection;
+    private renderStandaloneCustomization;
+    setMigrationCategories(categories: readonly ICustomizationMigrationCategorySummary[]): void;
     setHarnessLabel(label: string): void;
     private updateHeading;
+    private renderCustomizationMigrationCard;
     focus(): void;
 }

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

@@ -12,6 +12,7 @@ import '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/ai
 import { agentIcon, skillIcon, instructionsIcon, hookIcon, pluginIcon, toolsIcon } from './aiCustomizationIcons.js';
 import { PromptsType } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
 import { getDefaultHoverDelegate } from '@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/hover/hoverDelegateFactory';
+import { CONFIGURE_VOICE_INSTRUCTIONS_ACTION_ID, CONFIGURE_DICTATION_INSTRUCTIONS_ACTION_ID } from '@codingame/monaco-vscode-katex-common/vscode/vs/workbench/contrib/chat/browser/actions/configureVoiceInstructionsAction';
 import { AICustomizationManagementSection } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService';
 
 registerCss(aiCustomizationWelcomePromptLaunchers);
@@ -21,7 +22,7 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
         parent,
         welcomePageFeatures,
         callbacks,
-        _commandService,
+        commandService,
         workspaceService,
         hoverService,
         harnessLabel
@@ -29,67 +30,87 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
         super();
         this.welcomePageFeatures = welcomePageFeatures;
         this.callbacks = callbacks;
+        this.commandService = commandService;
         this.workspaceService = workspaceService;
         this.hoverService = hoverService;
         this.harnessLabel = harnessLabel;
         this.cardDisposables = this._register(( new DisposableStore()));
+        this.visibleSectionIds = ( new Set());
+        this.migrationCategories = [];
         this.categoryDescriptions = [{
             id: AICustomizationManagementSection.Agents,
-            label: ( localize(5923, "Agents")),
+            label: ( localize(6683, "Agents")),
             icon: agentIcon,
             description: ( localize(
-                5924,
-                "Define custom agents with specialized personas, tool access, and instructions for specific tasks."
+                6684,
+                "Create specialized agents for focused development tasks. Control their instructions, tools, and behavior."
             )),
             promptType: PromptsType.agent
         }, {
             id: AICustomizationManagementSection.Skills,
-            label: ( localize(5925, "Skills")),
+            label: ( localize(6685, "Skills")),
             icon: skillIcon,
             description: ( localize(
-                5926,
-                "Create reusable skill files that provide domain-specific knowledge and workflows."
+                6686,
+                "Add reusable knowledge and workflows for specialized tasks. Agents load relevant skills when needed."
             )),
             promptType: PromptsType.skill
         }, {
             id: AICustomizationManagementSection.Instructions,
-            label: ( localize(5927, "Instructions")),
+            label: ( localize(6687, "Instructions")),
             icon: instructionsIcon,
             description: ( localize(
-                5928,
-                "Set always-on instructions that guide AI behavior across your workspace or user profile."
+                6688,
+                "Define guidance that shapes how agents work. Apply it across a workspace or keep it in your user profile."
             )),
             promptType: PromptsType.instructions
         }, {
             id: AICustomizationManagementSection.Hooks,
-            label: ( localize(5929, "Hooks")),
+            label: ( localize(6689, "Hooks")),
             icon: hookIcon,
             description: ( localize(
-                5930,
-                "Configure automated actions triggered by events like saving files or running tasks."
+                6690,
+                "Run automated commands at key points in the agent lifecycle. Use hooks to validate, format, or coordinate work."
             )),
             promptType: PromptsType.hook
         }, {
             id: AICustomizationManagementSection.McpServers,
-            label: ( localize(5931, "MCP Servers")),
+            label: ( localize(6691, "MCP Servers")),
             icon: Codicon.server,
             description: ( localize(
-                5932,
-                "Connect external tool servers that extend AI capabilities with custom tools and data sources."
+                6692,
+                "Connect agents to external tools and data through MCP servers. Manage the servers available to your agent."
             ))
         }, {
             id: AICustomizationManagementSection.Plugins,
-            label: ( localize(5933, "Plugins")),
+            label: ( localize(6693, "Plugins")),
             icon: pluginIcon,
             description: ( localize(
-                5934,
-                "Install and manage agent plugins that add additional tools, skills, and integrations."
+                6694,
+                "Install reusable packages that extend the agent. Plugins can add tools, skills, agents, hooks, and MCP servers."
             ))
         }, {
             id: AICustomizationManagementSection.Tools,
-            label: ( localize(5935, "Tools")),
+            label: ( localize(6695, "Tools")),
             icon: toolsIcon,
-            description: ( localize(5936, "Enable or disable the tools available to chat."))
+            description: ( localize(
+                6696,
+                "Review the tools available to the active agent. Enable or disable configurable tool groups."
+            ))
+        }];
+        this.standaloneCustomizations = [{
+            label: ( localize(6697, "Voice Mode Instructions")),
+            icon: Codicon.voiceMode,
+            description: ( localize(6698, "Customize Voice Mode behavior and terminology with voice.md.")),
+            commandId: CONFIGURE_VOICE_INSTRUCTIONS_ACTION_ID
+        }, {
+            label: ( localize(6699, "Dictation Instructions")),
+            icon: Codicon.mic,
+            description: ( localize(
+                6700,
+                "Customize Dictation terminology and transcript formatting with dictation.md."
+            )),
+            commandId: CONFIGURE_DICTATION_INSTRUCTIONS_ACTION_ID
         }];
         this.container = $(".welcome-prompts-content-container");
         this.scrollable = this._register(( new DomScrollableElement(this.container, {
@@ -110,7 +131,7 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
         this.updateHeading();
         const subtitle = append(welcomeInner, $("p.welcome-prompts-subtitle"));
         subtitle.textContent = ( localize(
-            5937,
+            6701,
             "Tailor how agents work in your projects. Configure workspace customizations for the entire team, or create personal ones that follow you across projects."
         ));
         if (this.welcomePageFeatures?.showGettingStartedBanner !== false) {
@@ -122,23 +143,23 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
             );
             icon.setAttribute("aria-hidden", "true");
             const title = append(header, $("span"));
-            title.textContent = ( localize(5938, "Customize Your Agent"));
+            title.textContent = ( localize(6702, "Customize Your Agent"));
             const description = append(gettingStarted, $("p.welcome-prompts-input-helper"));
             description.textContent = ( localize(
-                5939,
+                6703,
                 "Describe your preferences and conventions to draft agents, skills, and instructions."
             ));
             const inputRow = append(gettingStarted, $(".welcome-prompts-input-row"));
             this.inputRow = inputRow;
             this.inputElement = append(inputRow, $("input.welcome-prompts-input"));
             this.inputElement.type = "text";
-            this.inputElement.placeholder = ( localize(5940, "Prefer concise commits, thorough reviews, and tested code..."));
-            this.inputElement.setAttribute("aria-label", ( localize(5941, "Describe your preferences to customize your agent")));
+            this.inputElement.placeholder = ( localize(6704, "Prefer concise commits, thorough reviews, and tested code..."));
+            this.inputElement.setAttribute("aria-label", ( localize(6705, "Describe your preferences to customize your agent")));
             const submitBtn = append(inputRow, $("button.welcome-prompts-input-submit"));
             this.submitBtn = submitBtn;
-            submitBtn.setAttribute("aria-label", ( localize(5942, "Customize agent")));
+            submitBtn.setAttribute("aria-label", ( localize(6706, "Customize agent")));
             this._register(
-                this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), submitBtn, ( localize(5943, "Open in Chat")))
+                this.hoverService.setupManagedHover(getDefaultHoverDelegate("element"), submitBtn, ( localize(6707, "Open in Chat")))
             );
             const chevron = append(submitBtn, $("span.codicon.codicon-arrow-up"));
             chevron.setAttribute("aria-hidden", "true");
@@ -168,7 +189,9 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
                     this.sentLabel.remove();
                 }
                 this.sentLabel = append(inputRow, $("span.welcome-prompts-sent-label"));
-                this.sentLabel.textContent = ( localize(5944, "Sent to chat ✓"));
+                this.sentLabel.setAttribute("role", "status");
+                this.sentLabel.setAttribute("aria-live", "polite");
+                this.sentLabel.textContent = ( localize(6708, "Sent to chat ✓"));
                 this.callbacks.prefillChat(query, {
                     isPartialQuery: false,
                     newChat: true
@@ -211,16 +234,26 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
         if (!this.cardsContainer) {
             return;
         }
+        this.visibleSectionIds = ( new Set(visibleSectionIds));
         this.cardDisposables.clear();
         clearNode(this.cardsContainer);
         this.firstCard = undefined;
-        for (const category of this.categoryDescriptions) {
-            if (!( visibleSectionIds.has(category.id))) {
+        if (this.migrationCategories.length > 0) {
+            const migrationGrid = this.renderOverviewSection(( localize(6709, "Needs Attention")), ( localize(6710, "Review customizations that need an update for the active agent.")), "welcome-prompts-attention-section");
+            this.renderCustomizationMigrationCard(migrationGrid, this.migrationCategories);
+        }
+        const exploreGrid = this.renderOverviewSection(( localize(6711, "Explore Customizations")), ( localize(6712, "Manage what the active agent knows and can do.")), "welcome-prompts-explore-section");
+        for (const section of this.workspaceService.managementSections) {
+            const category = this.categoryDescriptions.find(candidate => candidate.id === section);
+            if (!category || !( visibleSectionIds.has(category.id))) {
                 continue;
             }
-            const card = append(this.cardsContainer, $(".welcome-prompts-card"));
-            card.setAttribute("tabindex", "0");
-            card.setAttribute("role", "button");
+            const card = append(
+                exploreGrid,
+                $("button.welcome-prompts-card.welcome-prompts-navigation-card")
+            );
+            card.type = "button";
+            card.setAttribute("aria-label", ( localize(6713, "Open {0}", category.label)));
             if (!this.firstCard) {
                 this.firstCard = card;
             }
@@ -231,45 +264,56 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
             labelEl.textContent = category.label;
             const descEl = append(card, $("p.welcome-prompts-card-description"));
             descEl.textContent = category.description;
-            const footer = append(card, $(".welcome-prompts-card-footer"));
-            if (category.promptType) {
-                const generateBtn = append(footer, $("button.welcome-prompts-card-action"));
-                generateBtn.textContent = ( localize(5945, "New..."));
-                generateBtn.setAttribute("aria-label", ( localize(5946, "New {0}...", category.label)));
-                this.cardDisposables.add(addDisposableListener(generateBtn, "click", e => {
-                    e.stopPropagation();
-                    this.callbacks.closeEditor();
-                    if (this.workspaceService.isSessionsWindow) {
-                        const typeLabel = category.label.toLowerCase().replace(/s$/, "");
-                        this.callbacks.prefillChat(`Create me a custom ${typeLabel} that `, {
-                            isPartialQuery: true,
-                            newChat: true
-                        });
-                    } else {
-                        this.workspaceService.generateCustomization(category.promptType);
-                    }
-                }));
-            } else {
-                const browseBtn = append(footer, $("button.welcome-prompts-card-action"));
-                browseBtn.textContent = ( localize(5947, "Browse..."));
-                browseBtn.setAttribute("aria-label", ( localize(5948, "Browse {0}...", category.label)));
-                this.cardDisposables.add(addDisposableListener(browseBtn, "click", e => {
-                    e.stopPropagation();
-                    this.callbacks.selectSectionWithMarketplace(category.id);
-                }));
-            }
             this.cardDisposables.add(addDisposableListener(card, "click", () => {
                 this.callbacks.selectSection(category.id);
             }));
-            this.cardDisposables.add(addDisposableListener(card, "keydown", e => {
-                if (e.key === "Enter" || e.key === " ") {
-                    e.preventDefault();
-                    this.callbacks.selectSection(category.id);
-                }
-            }));
+        }
+        if (!this.workspaceService.isSessionsWindow) {
+            const otherGrid = this.renderOverviewSection(( localize(6714, "Other Customizations")), ( localize(6715, "Configure specialized voice and dictation behavior.")), "welcome-prompts-other-section");
+            for (const customization of this.standaloneCustomizations) {
+                this.renderStandaloneCustomization(otherGrid, customization);
+            }
         }
         this.scrollable.scanDomNode();
     }
+    renderOverviewSection(title, description, className) {
+        const section = append(this.cardsContainer, $(".welcome-prompts-overview-section"));
+        section.classList.add(className);
+        const heading = append(section, $("h3.welcome-prompts-overview-section-title"));
+        heading.textContent = title;
+        const descriptionElement = append(section, $("p.welcome-prompts-overview-section-description"));
+        descriptionElement.textContent = description;
+        return append(section, $(".welcome-prompts-overview-grid"));
+    }
+    renderStandaloneCustomization(parent, customization) {
+        const card = append(parent, $("button.welcome-prompts-card.welcome-prompts-navigation-card"));
+        card.type = "button";
+        card.setAttribute("aria-label", ( localize(6716, "Configure {0}", customization.label)));
+        if (!this.firstCard) {
+            this.firstCard = card;
+        }
+        const cardHeader = append(card, $(".welcome-prompts-card-header"));
+        const iconEl = append(cardHeader, $(".welcome-prompts-card-icon"));
+        iconEl.classList.add(...ThemeIcon.asClassNameArray(customization.icon));
+        const labelEl = append(cardHeader, $("span.welcome-prompts-card-label"));
+        labelEl.textContent = customization.label;
+        const descEl = append(card, $("p.welcome-prompts-card-description"));
+        descEl.textContent = customization.description;
+        const configure = () => {
+            void this.commandService.executeCommand(customization.commandId);
+        };
+        this.cardDisposables.add(addDisposableListener(card, "click", configure));
+    }
+    setMigrationCategories(categories) {
+        const didChange = categories.length !== this.migrationCategories.length || ( categories.some((category, index) => {
+            const previous = this.migrationCategories[index];
+            return previous.id !== category.id || previous.count !== category.count || previous.description !== category.description;
+        }));
+        this.migrationCategories = categories;
+        if (didChange) {
+            this.rebuildCards(this.visibleSectionIds);
+        }
+    }
     setHarnessLabel(label) {
         if (this.harnessLabel === label) {
             return;
@@ -279,8 +323,39 @@ class PromptLaunchersAICustomizationWelcomePage extends Disposable {
     }
     updateHeading() {
         if (this.heading) {
-            this.heading.textContent = ( localize(5949, "Agent Customizations for {0}", this.harnessLabel));
+            this.heading.textContent = ( localize(6717, "Agent Customizations"));
+        }
+    }
+    renderCustomizationMigrationCard(parent, categories) {
+        const migrationCard = append(parent, $("button.welcome-prompts-card.welcome-prompts-migration-card"));
+        migrationCard.type = "button";
+        const totalCount = categories.reduce((total, category) => total + category.count, 0);
+        migrationCard.setAttribute("aria-label", ( localize(6718, "Review {0} customizations that need migration", totalCount)));
+        const cardHeader = append(migrationCard, $(".welcome-prompts-card-header"));
+        const iconEl = append(cardHeader, $(".welcome-prompts-card-icon"));
+        iconEl.classList.add(...ThemeIcon.asClassNameArray(Codicon.warning));
+        iconEl.setAttribute("aria-hidden", "true");
+        const labelEl = append(cardHeader, $("span.welcome-prompts-card-label"));
+        labelEl.textContent = ( localize(6719, "Review Customization Migrations"));
+        const descEl = append(migrationCard, $("p.welcome-prompts-card-description"));
+        descEl.textContent = totalCount === 1 ? ( localize(
+            6720,
+            "1 customization needs an update before it can be used by {0}. Review what will change before migrating.",
+            this.harnessLabel
+        )) : ( localize(
+            6721,
+            "{0} customizations need an update before they can be used by {1}. Review what will change before migrating.",
+            totalCount,
+            this.harnessLabel
+        ));
+        if (!this.firstCard) {
+            this.firstCard = migrationCard;
         }
+        const actionLabel = append(migrationCard, $("span.welcome-prompts-card-action-label"));
+        actionLabel.textContent = ( localize(6722, "Review Migrations..."));
+        this.cardDisposables.add(
+            addDisposableListener(migrationCard, "click", () => this.callbacks.reviewMigrations())
+        );
     }
     focus() {
         if (this.inputElement) {

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

@@ -14,6 +14,7 @@ export declare class AICustomizationWorkspaceService implements IAICustomization
     private readonly promptsService;
     readonly _serviceBrand: undefined;
     readonly activeProjectRoot: IObservable<URI | undefined>;
+    readonly activeProjectLabel: IObservable<string | undefined>;
     constructor(workspaceContextService: IWorkspaceContextService, commandService: ICommandService, promptsService: IPromptsService);
     getActiveProjectRoot(): URI | undefined;
     readonly managementSections: readonly AICustomizationManagementSection[];