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

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

@@ -0,0 +1,762 @@
+
+import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
+import { createCommandUri, MarkdownString } from '@codingame/monaco-vscode-api/vscode/vs/base/common/htmlContent';
+import { equals } from '@codingame/monaco-vscode-api/vscode/vs/base/common/objects';
+import { basename } from '@codingame/monaco-vscode-api/vscode/vs/base/common/resources';
+import { PromptsConfig } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/config/config';
+import { PromptsType } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/promptTypes';
+import { isMcpServerCustomizationMigrationCandidate, isPromptFileMigrationCandidate, getCustomizationMigrationEnablementSetting, CustomizationMigrationType, isUserDataMigrationCandidate, isConfiguredLocationMigrationCandidate, McpServerCustomizationMigrationFailureReason } from '../../common/promptSyntax/service/customizationMigrationService.js';
+import { PromptsStorage } from '@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/promptSyntax/service/promptsService';
+
+var CustomizationMigrationCategoryId;
+(function(CustomizationMigrationCategoryId) {
+    CustomizationMigrationCategoryId["PromptFiles"] = "promptFiles";
+    CustomizationMigrationCategoryId["UserData"] = "userData";
+    CustomizationMigrationCategoryId["ConfiguredLocations"] = "configuredLocations";
+    CustomizationMigrationCategoryId["McpServers"] = "mcpServers";
+})(
+    CustomizationMigrationCategoryId || (CustomizationMigrationCategoryId = {})
+);
+const SKILLS_DOCUMENTATION_URL = "https://code.visualstudio.com/docs/agent-customization/agent-skills?referrer=in-product";
+const CUSTOMIZATION_DOCUMENTATION_URL = "https://code.visualstudio.com/docs/agent-customization/overview?referrer=in-product";
+const MCP_DOCUMENTATION_URL = "https://code.visualstudio.com/docs/agent-customization/mcp-servers?referrer=in-product";
+const CONFIGURED_LOCATION_SETTING_IDS = [
+    PromptsConfig.AGENTS_LOCATION_KEY,
+    PromptsConfig.MODE_LOCATION_KEY,
+    PromptsConfig.SKILLS_LOCATION_KEY,
+    PromptsConfig.INSTRUCTIONS_LOCATION_KEY
+];
+const promptFilesMigrationCategory = {
+    id: CustomizationMigrationCategoryId.PromptFiles,
+    migrationType: CustomizationMigrationType.PromptFiles,
+    sourceTypes: [PromptsType.prompt],
+    enablementSetting: getCustomizationMigrationEnablementSetting(CustomizationMigrationType.PromptFiles),
+    shortcutLabel: ( localize(6599, "Migrate Prompts")),
+    shortcutTooltip: ( localize(6600, "Convert deprecated prompt files to skills")),
+    cardLabel: ( localize(6601, "Migrate Prompt Files")),
+    cardActionLabel: ( localize(6602, "Convert to Skills...")),
+    cardActionAriaLabel: ( localize(6603, "Convert prompt files to skills")),
+    pageTitle: ( localize(6604, "Migrate Prompt Files")),
+    pageLinkLabel: ( localize(6605, "Learn more about agent skills")),
+    pageLinkUrl: SKILLS_DOCUMENTATION_URL,
+    pageEmptyMessage: ( localize(6606, "No prompt files are available to migrate.")),
+    migrateButtonTooltip: ( localize(6607, "Convert selected prompt files to skills")),
+    backLabel: ( localize(6608, "Back to Migrate Prompt Files")),
+    noFilesMigratedMessage: ( localize(6609, "No prompt files were converted.")),
+    isCandidate: isPromptFileMigrationCandidate,
+    getCandidatePresentation: getFileCandidatePresentation,
+    group(customizations) {
+        return [{
+            key: PromptsStorage.local,
+            label: ( localize(6610, "Workspace")),
+            customizations: customizations.filter(
+                customization => !isMcpServerCustomizationMigrationCandidate(customization) && customization.storage === PromptsStorage.local
+            )
+        }, {
+            key: PromptsStorage.user,
+            label: ( localize(6611, "User")),
+            customizations: customizations.filter(
+                customization => !isMcpServerCustomizationMigrationCandidate(customization) && customization.storage === PromptsStorage.user
+            )
+        }];
+    },
+    getShortcutAriaLabel(count) {
+        return localize(6612, "Prompts, {0} deprecated prompt files need migration", count);
+    },
+    getCardDescription(customizations, harnessLabel) {
+        const {
+            workspaceCount,
+            userCount,
+            totalCount
+        } = countPromptStorages(customizations);
+        if (workspaceCount > 0 && userCount > 0) {
+            return localize(
+                6613,
+                "Prompt files are deprecated for this harness. Found {0} prompt files ({1} workspace, {2} global) that local VS Code can still run, but {3} ignores. Convert them to skills to keep them available.",
+                totalCount,
+                workspaceCount,
+                userCount,
+                harnessLabel
+            );
+        }
+        if (workspaceCount > 0) {
+            return localize(
+                6614,
+                "Prompt files are deprecated for this harness. Found {0} workspace prompt files that local VS Code can still run, but {1} ignores. Convert them to skills to keep them available.",
+                workspaceCount,
+                harnessLabel
+            );
+        }
+        return localize(
+            6615,
+            "Prompt files are deprecated for this harness. Found {0} global prompt files that local VS Code can still run, but {1} ignores. Convert them to skills to keep them available.",
+            userCount,
+            harnessLabel
+        );
+    },
+    getPageDescription(customizations, harnessLabel) {
+        const {
+            workspaceCount,
+            userCount,
+            totalCount
+        } = countPromptStorages(customizations);
+        if (totalCount === 0) {
+            return localize(6616, "Select prompt files to convert into skills for the active harness.");
+        }
+        if (workspaceCount > 0 && userCount > 0) {
+            return localize(
+                6617,
+                "Prompt files are not supported for this harness. Found {0} prompt files ({1} workspace, {2} user) that local VS Code can still run, but {3} ignores. Convert them to skills to keep them available.",
+                totalCount,
+                workspaceCount,
+                userCount,
+                harnessLabel
+            );
+        }
+        if (workspaceCount > 0) {
+            return localize(
+                6618,
+                "Prompt files are not supported for this harness. Found {0} workspace prompt files that local VS Code can still run, but {1} ignores. Convert them to skills to keep them available.",
+                workspaceCount,
+                harnessLabel
+            );
+        }
+        return localize(
+            6619,
+            "Prompt files are not supported for this harness. Found {0} user prompt files that local VS Code can still run, but {1} ignores. Convert them to skills to keep them available.",
+            userCount,
+            harnessLabel
+        );
+    },
+    getBanner(_customizations, harnessLabel) {
+        return {
+            message: ( localize(
+                6620,
+                "Prompts are no longer supported by {0}. Convert them to skills to keep them available in both VS Code and this harness.",
+                harnessLabel
+            ))
+        };
+    },
+    getConfirmation(customizations) {
+        const {
+            workspaceCount,
+            userCount
+        } = countPromptStorages(customizations);
+        const detail = workspaceCount > 0 && userCount > 0 ? ( localize(
+            6621,
+            "This converts {0} workspace prompt files and {1} user prompt files into skills.",
+            workspaceCount,
+            userCount
+        )) : workspaceCount > 0 ? ( localize(
+            6622,
+            "This converts {0} workspace prompt files into skills.",
+            workspaceCount
+        )) : ( localize(6623, "This converts {0} user prompt files into skills.", userCount));
+        return {
+            message: ( localize(6624, "Convert prompt files to skills?")),
+            detail,
+            primaryButton: ( localize(6625, "Convert to Skills")),
+            deleteOriginalsLabel: ( localize(6626, "Delete original prompt files after migration"))
+        };
+    },
+    getMigratedMessage(migratedCount) {
+        return localize(6627, "Converted {0} prompt files to skills.", migratedCount);
+    },
+    getMigratedWithReviewMessage(migratedCount, unsupportedHeaderKeys) {
+        return localize(
+            6628,
+            "Converted {0} prompt files to skills. Review migrated skills that used unsupported prompt headers: {1}.",
+            migratedCount,
+            unsupportedHeaderKeys
+        );
+    },
+    getFailedMessage(failedFileNames, hiddenFileCount) {
+        return hiddenFileCount > 0 ? ( localize(
+            6629,
+            "Failed to migrate {0} prompt files: {1}, and {2} more.",
+            failedFileNames.length + hiddenFileCount,
+            failedFileNames.join(", "),
+            hiddenFileCount
+        )) : ( localize(
+            6630,
+            "Failed to migrate {0} prompt files: {1}.",
+            failedFileNames.length,
+            failedFileNames.join(", ")
+        ));
+    }
+};
+const userDataMigrationCategory = {
+    id: CustomizationMigrationCategoryId.UserData,
+    migrationType: CustomizationMigrationType.UserData,
+    sourceTypes: [PromptsType.agent, PromptsType.instructions],
+    enablementSetting: getCustomizationMigrationEnablementSetting(CustomizationMigrationType.UserData),
+    shortcutLabel: ( localize(6631, "Migrate User Data")),
+    shortcutTooltip: ( localize(6632, "Move user data agents and instructions to the active harness")),
+    cardLabel: ( localize(6633, "Migrate User Data Customizations")),
+    cardActionLabel: ( localize(6634, "Migrate...")),
+    cardActionAriaLabel: ( localize(6635, "Migrate user data customizations to the active harness")),
+    pageTitle: ( localize(6636, "Migrate User Data Customizations")),
+    pageLinkLabel: ( localize(6637, "Learn more about agent customizations")),
+    pageLinkUrl: CUSTOMIZATION_DOCUMENTATION_URL,
+    pageEmptyMessage: ( localize(6638, "No user data customizations are available to migrate.")),
+    migrateButtonTooltip: ( localize(6639, "Move the selected user data customizations to the active harness")),
+    backLabel: ( localize(6640, "Back to Migrate User Data Customizations")),
+    noFilesMigratedMessage: ( localize(6641, "No user data customizations were migrated.")),
+    isCandidate: isUserDataMigrationCandidate,
+    getCandidatePresentation: getFileCandidatePresentation,
+    group(customizations) {
+        return [{
+            key: PromptsType.agent,
+            label: ( localize(6642, "Agents")),
+            customizations: customizations.filter(customization => customization.type === PromptsType.agent)
+        }, {
+            key: PromptsType.instructions,
+            label: ( localize(6643, "Instructions")),
+            customizations: customizations.filter(customization => customization.type === PromptsType.instructions)
+        }];
+    },
+    getShortcutAriaLabel(count) {
+        return count === 1 ? ( localize(6644, "User data, 1 customization needs migration")) : ( localize(6645, "User data, {0} customizations need migration", count));
+    },
+    getCardDescription(customizations, harnessLabel) {
+        const {
+            agentCount,
+            instructionsCount,
+            totalCount
+        } = countUserDataTypes(customizations);
+        if (agentCount > 0 && instructionsCount > 0) {
+            return localize(
+                6646,
+                "User data customizations are only used by VS Code. Found {0} customizations that {1} ignores. Move them to keep them available.",
+                totalCount,
+                harnessLabel
+            );
+        }
+        if (agentCount > 0) {
+            return agentCount === 1 ? ( localize(
+                6647,
+                "User data customizations are only used by VS Code. Found 1 agent that {0} ignores. Move it to keep it available.",
+                harnessLabel
+            )) : ( localize(
+                6648,
+                "User data customizations are only used by VS Code. Found {0} agents that {1} ignores. Move them to keep them available.",
+                agentCount,
+                harnessLabel
+            ));
+        }
+        return instructionsCount === 1 ? ( localize(
+            6649,
+            "User data customizations are only used by VS Code. Found 1 instruction file that {0} ignores. Move it to keep it available.",
+            harnessLabel
+        )) : ( localize(
+            6650,
+            "User data customizations are only used by VS Code. Found {0} instruction files that {1} ignores. Move them to keep them available.",
+            instructionsCount,
+            harnessLabel
+        ));
+    },
+    getBanner(_customizations, harnessLabel, destinationLabel) {
+        return {
+            message: destinationLabel ? ( localize(
+                6651,
+                "They are stored in user data, which only VS Code reads. Move them to '{0}' so both VS Code and this harness can use them, keeping their name, type, and content.",
+                destinationLabel
+            )) : ( localize(
+                6652,
+                "They are stored in user data, which only VS Code reads. Migrating moves them into the folders {0} reads, keeping their name, type, and content, so you can keep using them.",
+                harnessLabel
+            )),
+            consequence: ( localize(6653, "Migrated files aren't currently included in Settings Sync."))
+        };
+    },
+    getPageDescription(customizations, harnessLabel) {
+        const {
+            agentCount,
+            instructionsCount,
+            totalCount
+        } = countUserDataTypes(customizations);
+        if (totalCount === 0) {
+            return localize(6654, "Select user data customizations to move to the active harness.");
+        }
+        if (agentCount > 0 && instructionsCount > 0) {
+            return localize(
+                6655,
+                "Found {0} customizations in user data that local VS Code can still use, but {1} ignores. Move them to the harness folders to keep their type and content.",
+                totalCount,
+                harnessLabel
+            );
+        }
+        if (agentCount > 0) {
+            return agentCount === 1 ? ( localize(
+                6656,
+                "Found 1 agent in user data that local VS Code can still use, but {0} ignores. Move it to the harness agents folder to keep it available.",
+                harnessLabel
+            )) : ( localize(
+                6657,
+                "Found {0} agents in user data that local VS Code can still use, but {1} ignores. Move them to the harness agents folder to keep them available.",
+                agentCount,
+                harnessLabel
+            ));
+        }
+        return instructionsCount === 1 ? ( localize(
+            6658,
+            "Found 1 instruction file in user data that local VS Code can still use, but {0} ignores. Move it to the harness instructions folder to keep it available.",
+            harnessLabel
+        )) : ( localize(
+            6659,
+            "Found {0} instruction files in user data that local VS Code can still use, but {1} ignores. Move them to the harness instructions folder to keep them available.",
+            instructionsCount,
+            harnessLabel
+        ));
+    },
+    getConfirmation(customizations, harnessLabel, destinationLabel) {
+        const {
+            agentCount,
+            instructionsCount,
+            totalCount
+        } = countUserDataTypes(customizations);
+        let detail;
+        if (agentCount > 0 && instructionsCount > 0) {
+            detail = ( localize(6660, "This moves {0} customizations out of user data.", totalCount));
+        } else if (agentCount > 0) {
+            detail = agentCount === 1 ? ( localize(6661, "This moves 1 agent out of user data.")) : ( localize(6662, "This moves {0} agents out of user data.", agentCount));
+        } else {
+            detail = instructionsCount === 1 ? ( localize(6663, "This moves 1 instruction file out of user data.")) : ( localize(
+                6664,
+                "This moves {0} instruction files out of user data.",
+                instructionsCount
+            ));
+        }
+        return {
+            message: destinationLabel ? ( localize(6665, "Migrate user data customizations to '{0}'?", destinationLabel)) : ( localize(6666, "Migrate user data customizations to {0}?", harnessLabel)),
+            detail,
+            primaryButton: ( localize(6667, "Migrate")),
+            deleteOriginalsLabel: ( localize(6668, "Delete the original files from user data after migration"))
+        };
+    },
+    getMigratedMessage(migratedCount) {
+        return migratedCount === 1 ? ( localize(6669, "Migrated 1 user data customization.")) : ( localize(6670, "Migrated {0} user data customizations.", migratedCount));
+    },
+    getFailedMessage(failedFileNames, hiddenFileCount) {
+        const failedCount = failedFileNames.length + hiddenFileCount;
+        if (failedCount === 1) {
+            return localize(
+                6671,
+                "Failed to migrate 1 user data customization: {0}.",
+                failedFileNames[0]
+            );
+        }
+        return hiddenFileCount > 0 ? ( localize(
+            6672,
+            "Failed to migrate {0} user data customizations: {1}, and {2} more.",
+            failedCount,
+            failedFileNames.join(", "),
+            hiddenFileCount
+        )) : ( localize(
+            6673,
+            "Failed to migrate {0} user data customizations: {1}.",
+            failedCount,
+            failedFileNames.join(", ")
+        ));
+    }
+};
+const configuredLocationsMigrationCategory = {
+    id: CustomizationMigrationCategoryId.ConfiguredLocations,
+    migrationType: CustomizationMigrationType.ConfiguredLocations,
+    sourceTypes: [PromptsType.agent, PromptsType.instructions, PromptsType.skill],
+    enablementSetting: getCustomizationMigrationEnablementSetting(CustomizationMigrationType.ConfiguredLocations),
+    configurationSettingIds: CONFIGURED_LOCATION_SETTING_IDS,
+    shortcutLabel: ( localize(6674, "Migrate Location Settings")),
+    shortcutTooltip: ( localize(
+        6675,
+        "Move customizations from locations unsupported by the active harness"
+    )),
+    cardLabel: ( localize(6676, "Migrate Location Settings")),
+    cardActionLabel: ( localize(6677, "Migrate...")),
+    cardActionAriaLabel: ( localize(6678, "Migrate customizations from unsupported configured locations")),
+    pageTitle: ( localize(6679, "Migrate Location Settings")),
+    pageLinkLabel: ( localize(6680, "Learn more about agent customizations")),
+    pageLinkUrl: CUSTOMIZATION_DOCUMENTATION_URL,
+    pageEmptyMessage: ( localize(
+        6681,
+        "No customizations in unsupported configured locations are available to migrate."
+    )),
+    migrateButtonTooltip: ( localize(
+        6682,
+        "Move the selected customizations to locations supported by the active harness"
+    )),
+    backLabel: ( localize(6683, "Back to Migrate Location Settings")),
+    noFilesMigratedMessage: ( localize(6684, "No customizations from configured locations were migrated.")),
+    isCandidate: isConfiguredLocationMigrationCandidate,
+    getCandidatePresentation: getFileCandidatePresentation,
+    getModifiedSettingIds(configurationService) {
+        return CONFIGURED_LOCATION_SETTING_IDS.filter(settingId => {
+            const inspected = configurationService.inspect(settingId);
+            return !equals(inspected.value, inspected.defaultValue);
+        });
+    },
+    group(customizations) {
+        return [{
+            key: PromptsType.agent,
+            label: ( localize(6685, "Agents")),
+            customizations: customizations.filter(customization => customization.type === PromptsType.agent)
+        }, {
+            key: PromptsType.instructions,
+            label: ( localize(6686, "Instructions")),
+            customizations: customizations.filter(customization => customization.type === PromptsType.instructions)
+        }, {
+            key: PromptsType.skill,
+            label: ( localize(6687, "Skills")),
+            customizations: customizations.filter(customization => customization.type === PromptsType.skill)
+        }].filter(group => group.customizations.length > 0);
+    },
+    getShortcutAriaLabel(count) {
+        return count === 1 ? ( localize(6688, "Locations, 1 customization needs migration")) : ( localize(6689, "Locations, {0} customizations need migration", count));
+    },
+    getCardDescription(customizations, harnessLabel) {
+        return customizations.length === 1 ? ( localize(
+            6690,
+            "Found 1 customization in a configured location that {0} does not use. Move it to keep it available.",
+            harnessLabel
+        )) : ( localize(
+            6691,
+            "Found {0} customizations in configured locations that {1} does not use. Move them to keep them available.",
+            customizations.length,
+            harnessLabel
+        ));
+    },
+    getPageDescription(customizations, harnessLabel) {
+        return customizations.length === 0 ? ( localize(
+            6692,
+            "Select customizations to move to locations supported by the active harness."
+        )) : ( localize(
+            6693,
+            "Found {0} customizations in locations configured through VS Code settings that {1} does not use. Move them to supported harness locations.",
+            customizations.length,
+            harnessLabel
+        ));
+    },
+    getBanner(_customizations, harnessLabel, destinationLabel, modifiedSettingIds) {
+        const settingsLinks = ( modifiedSettingIds.map(
+            settingId => `[${settingId}](${createCommandUri("workbench.action.openSettings", {
+    query: `@id:${settingId}`
+})})`
+        ));
+        const settingsList = formatSettingLinks(settingsLinks);
+        const message = settingsLinks.length === 1 ? destinationLabel ? ( localize(
+            6694,
+            "The setting {0} is no longer read by {1}. Move the customizations to '{2}' so both VS Code and {1} can use them.",
+            settingsList,
+            harnessLabel,
+            destinationLabel
+        )) : ( localize(
+            6695,
+            "The setting {0} is no longer read by {1}. Move the customizations into supported harness folders so both VS Code and {1} can use them.",
+            settingsList,
+            harnessLabel
+        )) : destinationLabel ? ( localize(
+            6696,
+            "The settings {0} are no longer read by {1}. Move the customizations to '{2}' so both VS Code and {1} can use them.",
+            settingsList,
+            harnessLabel,
+            destinationLabel
+        )) : ( localize(
+            6697,
+            "The settings {0} are no longer read by {1}. Move the customizations into supported harness folders so both VS Code and {1} can use them.",
+            settingsList,
+            harnessLabel
+        ));
+        return {
+            message: ( new MarkdownString(message, {
+                isTrusted: {
+                    enabledCommands: ["workbench.action.openSettings"]
+                }
+            })),
+            consequence: ( localize(
+                6698,
+                "The option to clear unused location settings after migration is selected by default."
+            ))
+        };
+    },
+    getConfirmation(customizations, harnessLabel, destinationLabel) {
+        return {
+            message: destinationLabel ? ( localize(6699, "Migrate customizations to '{0}'?", destinationLabel)) : ( localize(6700, "Migrate customizations to {0}?", harnessLabel)),
+            detail: customizations.length === 1 ? ( localize(
+                6701,
+                "This moves 1 customization out of an unsupported configured location."
+            )) : ( localize(
+                6702,
+                "This moves {0} customizations out of unsupported configured locations.",
+                customizations.length
+            )),
+            primaryButton: ( localize(6703, "Migrate")),
+            deleteOriginalsLabel: ( localize(6704, "Delete the original files after migration"))
+        };
+    },
+    getMigratedMessage(migratedCount) {
+        return migratedCount === 1 ? ( localize(6705, "Migrated 1 customization from a configured location.")) : ( localize(
+            6706,
+            "Migrated {0} customizations from configured locations.",
+            migratedCount
+        ));
+    },
+    getFailedMessage(failedFileNames, hiddenFileCount) {
+        const failedCount = failedFileNames.length + hiddenFileCount;
+        if (failedCount === 1) {
+            return localize(6707, "Failed to migrate 1 customization: {0}.", failedFileNames[0]);
+        }
+        return hiddenFileCount > 0 ? ( localize(
+            6708,
+            "Failed to migrate {0} customizations: {1}, and {2} more.",
+            failedCount,
+            failedFileNames.join(", "),
+            hiddenFileCount
+        )) : ( localize(
+            6709,
+            "Failed to migrate {0} customizations: {1}.",
+            failedCount,
+            failedFileNames.join(", ")
+        ));
+    }
+};
+const mcpServersMigrationCategory = {
+    id: CustomizationMigrationCategoryId.McpServers,
+    migrationType: CustomizationMigrationType.McpServers,
+    enablementSetting: getCustomizationMigrationEnablementSetting(CustomizationMigrationType.McpServers),
+    shortcutLabel: ( localize(6710, "Migrate MCP Servers")),
+    shortcutTooltip: ( localize(6711, "Move supported workspace MCP servers to root .mcp.json files")),
+    cardLabel: ( localize(6712, "Migrate MCP Servers")),
+    cardActionLabel: ( localize(6713, "Migrate...")),
+    cardActionAriaLabel: ( localize(6714, "Migrate supported workspace MCP servers")),
+    pageTitle: ( localize(6715, "Migrate MCP Servers")),
+    pageLinkLabel: ( localize(6716, "Learn more about MCP servers")),
+    pageLinkUrl: MCP_DOCUMENTATION_URL,
+    pageEmptyMessage: ( localize(6717, "No supported workspace MCP servers are available to migrate.")),
+    migrateButtonTooltip: ( localize(6718, "Move selected MCP servers to root .mcp.json files")),
+    backLabel: ( localize(6719, "Back to Migrate MCP Servers")),
+    noFilesMigratedMessage: ( localize(6720, "No MCP servers were migrated.")),
+    getCandidatePresentation(customization, getUriLabel) {
+        if (!isMcpServerCustomizationMigrationCandidate(customization)) {
+            throw ( new Error("Expected an MCP server migration candidate"));
+        }
+        const sourceLabel = getUriLabel(customization.sourceUri);
+        return {
+            name: customization.name,
+            selectionAriaLabel: ( localize(6721, "Select {0} from {1}", customization.name, sourceLabel)),
+            pathLabel: ( localize(6722, "{0} to {1}", sourceLabel, getUriLabel(customization.targetUri)))
+        };
+    },
+    group(customizations) {
+        return [{
+            key: "workspace",
+            label: ( localize(6723, "Workspace")),
+            customizations
+        }];
+    },
+    getShortcutAriaLabel(count) {
+        return count === 1 ? ( localize(6724, "MCP servers, 1 server can be migrated")) : ( localize(6725, "MCP servers, {0} servers can be migrated", count));
+    },
+    getCardDescription(customizations, harnessLabel) {
+        return customizations.length === 1 ? ( localize(
+            6726,
+            "Found 1 supported server in .vscode/mcp.json that can move to the workspace root so {0} can discover it directly.",
+            harnessLabel
+        )) : ( localize(
+            6727,
+            "Found {0} supported servers in .vscode/mcp.json that can move to workspace root files so {1} can discover them directly.",
+            customizations.length,
+            harnessLabel
+        ));
+    },
+    getPageDescription(customizations, harnessLabel) {
+        return customizations.length === 1 ? ( localize(
+            6728,
+            "Select the supported MCP server to move so {0} can discover it directly. Unsupported and unselected servers stay in .vscode/mcp.json.",
+            harnessLabel
+        )) : ( localize(
+            6729,
+            "Select supported MCP servers to move so {0} can discover them directly. Unsupported and unselected servers stay in .vscode/mcp.json.",
+            harnessLabel
+        ));
+    },
+    getBanner(_customizations, harnessLabel) {
+        return {
+            message: ( localize(
+                6730,
+                "Eligible servers move from .vscode/mcp.json to .mcp.json at each workspace root so {0} can discover them directly. Unsupported and unselected servers stay in their current files.",
+                harnessLabel
+            )),
+            consequence: ( localize(
+                6731,
+                "Migrated entries are removed from .vscode/mcp.json only after the root .mcp.json entries are written successfully."
+            ))
+        };
+    },
+    getConfirmation(customizations) {
+        return {
+            message: customizations.length === 1 ? ( localize(6732, "Migrate 1 MCP server to .mcp.json?")) : ( localize(6733, "Migrate {0} MCP servers to .mcp.json?", customizations.length)),
+            detail: ( localize(
+                6734,
+                "Selected entries are removed from .vscode/mcp.json after they are written and verified in .mcp.json. Unsupported and unselected entries stay in place."
+            )),
+            primaryButton: ( localize(6735, "Migrate"))
+        };
+    },
+    getMigratedMessage(migratedCount) {
+        return migratedCount === 1 ? ( localize(6736, "Migrated 1 MCP server.")) : ( localize(6737, "Migrated {0} MCP servers.", migratedCount));
+    },
+    getFailedMessage(failedServerNames, hiddenServerCount) {
+        const failedCount = failedServerNames.length + hiddenServerCount;
+        if (failedCount === 1) {
+            return localize(6738, "Failed to migrate MCP server: {0}.", failedServerNames[0]);
+        }
+        return hiddenServerCount > 0 ? ( localize(
+            6739,
+            "Failed to migrate {0} MCP servers: {1}, and {2} more.",
+            failedCount,
+            failedServerNames.join(", "),
+            hiddenServerCount
+        )) : ( localize(
+            6740,
+            "Failed to migrate {0} MCP servers: {1}.",
+            failedCount,
+            failedServerNames.join(", ")
+        ));
+    },
+    getMcpServerFailureMessage(failures) {
+        if (( failures.some(
+            failure => failure.reason === McpServerCustomizationMigrationFailureReason.RollbackFailed
+        ))) {
+            return failures.length === 1 ? ( localize(
+                6741,
+                "Could not safely complete or roll back the migration for '{0}'. Review both MCP configuration files.",
+                failures[0].name
+            )) : ( localize(
+                6742,
+                "Some MCP server migrations could not be safely completed or rolled back. Review the affected source and destination MCP configuration files."
+            ));
+        }
+        const crossRootConflicts = failures.filter(
+            failure => failure.reason === McpServerCustomizationMigrationFailureReason.CrossRootConflict
+        );
+        if (crossRootConflicts.length > 0) {
+            return failures.length === 1 ? ( localize(
+                6743,
+                "Could not migrate '{0}' because another workspace root defines an MCP server with the same name. Rename or remove the duplicate before migrating.",
+                crossRootConflicts[0].name
+            )) : ( localize(
+                6744,
+                "Some MCP servers could not be migrated because their names conflict across workspace roots. Rename or remove the duplicates before migrating."
+            ));
+        }
+        if (failures.length !== 1) {
+            const displayedFailures = failures.slice(0, 3);
+            return this.getFailedMessage(( displayedFailures.map(failure => failure.name)), failures.length - displayedFailures.length);
+        }
+        const [failure] = failures;
+        switch (failure.reason) {
+        case McpServerCustomizationMigrationFailureReason.NoLongerEligible:
+            return localize(
+                6745,
+                "Could not migrate '{0}' because it is no longer eligible.",
+                failure.name
+            );
+        case McpServerCustomizationMigrationFailureReason.SourceChanged:
+            return localize(
+                6746,
+                "Could not migrate '{0}' because its source configuration changed.",
+                failure.name
+            );
+        case McpServerCustomizationMigrationFailureReason.TargetConflict:
+            return localize(
+                6747,
+                "Could not migrate '{0}' because .mcp.json already contains a different server with that name.",
+                failure.name
+            );
+        case McpServerCustomizationMigrationFailureReason.InvalidTarget:
+            return localize(
+                6748,
+                "Could not migrate '{0}' because the destination .mcp.json is invalid.",
+                failure.name
+            );
+        default:
+            return this.getFailedMessage([failure.name], 0);
+        }
+    }
+};
+function formatSettingLinks(settingsLinks) {
+    switch (settingsLinks.length) {
+    case 1:
+        return settingsLinks[0];
+    case 2:
+        return localize(6749, "{0} and {1}", settingsLinks[0], settingsLinks[1]);
+    case 3:
+        return localize(
+            6750,
+            "{0}, {1}, and {2}",
+            settingsLinks[0],
+            settingsLinks[1],
+            settingsLinks[2]
+        );
+    case 4:
+        return localize(
+            6751,
+            "{0}, {1}, {2}, and {3}",
+            settingsLinks[0],
+            settingsLinks[1],
+            settingsLinks[2],
+            settingsLinks[3]
+        );
+    default:
+        throw ( new Error("Expected at least one configured location setting"));
+    }
+}
+const CUSTOMIZATION_MIGRATION_CATEGORIES = [
+    promptFilesMigrationCategory,
+    userDataMigrationCategory,
+    configuredLocationsMigrationCategory,
+    mcpServersMigrationCategory
+];
+function getCustomizationMigrationCategory(id) {
+    const category = CUSTOMIZATION_MIGRATION_CATEGORIES.find(candidate => candidate.id === id);
+    if (!category) {
+        throw ( new Error(`Unknown customization migration category: ${id}`));
+    }
+    return category;
+}
+function getFileCandidatePresentation(customization, getUriLabel) {
+    if (isMcpServerCustomizationMigrationCandidate(customization)) {
+        throw ( new Error("Expected a file migration candidate"));
+    }
+    const name = customization.name ?? basename(customization.uri);
+    const pathLabel = getUriLabel(customization.uri);
+    return {
+        name,
+        selectionAriaLabel: ( localize(6752, "Select {0}", name)),
+        pathLabel,
+        file: customization
+    };
+}
+function countPromptStorages(customizations) {
+    const fileCustomizations = customizations.filter(
+        customization => !isMcpServerCustomizationMigrationCandidate(customization)
+    );
+    const workspaceCount = fileCustomizations.filter(customization => customization.storage === PromptsStorage.local).length;
+    const userCount = fileCustomizations.filter(customization => customization.storage === PromptsStorage.user).length;
+    return {
+        workspaceCount,
+        userCount,
+        totalCount: workspaceCount + userCount
+    };
+}
+function countUserDataTypes(customizations) {
+    const agentCount = customizations.filter(customization => customization.type === PromptsType.agent).length;
+    const instructionsCount = customizations.filter(customization => customization.type === PromptsType.instructions).length;
+    return {
+        agentCount,
+        instructionsCount,
+        totalCount: agentCount + instructionsCount
+    };
+}
+
+export { CUSTOMIZATION_MIGRATION_CATEGORIES, CustomizationMigrationCategoryId, getCustomizationMigrationCategory };