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

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

@@ -1,21 +1,216 @@
-import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { Disposable, DisposableStore } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
 import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+import { IListRenderer } from "@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/list/list";
+import { ThemeIcon } from "@codingame/monaco-vscode-api/vscode/vs/base/common/themables";
+import { Button } from "@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/button/button";
 import { ICommandService } from "@codingame/monaco-vscode-api/vscode/vs/platform/commands/common/commands.service";
 import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
-import { IWorkbenchMcpServer } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/mcp/common/mcpTypes";
+import { IMcpGalleryManifestService } from "@codingame/monaco-vscode-api/vscode/vs/platform/mcp/common/mcpGalleryManifest.service";
+import { IWorkbenchMcpServer, McpConnectionState, IMcpServer } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/mcp/common/mcpTypes";
 import { IMcpWorkbenchService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/mcp/common/mcpTypes.service";
 import { IMcpService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/mcp/common/mcpTypes.service";
 import { IMcpRegistry } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/mcp/common/mcpRegistryTypes.service";
+import { ContributionEnablementState } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/enablement";
+import { IReader } from "@codingame/monaco-vscode-api/vscode/vs/base/common/observable";
 import { IOpenerService } from "@codingame/monaco-vscode-api/vscode/vs/platform/opener/common/opener.service";
+import { URI } from "@codingame/monaco-vscode-api/vscode/vs/base/common/uri";
 import { IContextMenuService } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextview/browser/contextView.service";
 import { IContextViewService } from "@codingame/monaco-vscode-api/vscode/vs/platform/contextview/browser/contextView.service";
+import { Action, IAction } from "@codingame/monaco-vscode-api/vscode/vs/base/common/actions";
 import { IAgentPluginService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/plugins/agentPluginService.service";
 import { IDialogService } 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 { IManagedHover } from "@codingame/monaco-vscode-api/vscode/vs/base/browser/ui/hover/hover";
 import { IAICustomizationWorkspaceService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/aiCustomizationWorkspaceService.service";
 import { IAgentPluginItem } from "../agentPluginEditor/agentPluginItems.js";
 import { ICustomizationHarnessService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/customizationHarnessService.service";
 import { IAgentHostCustomizationService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/agentSessions/agentHost/agentHostCustomizationService.service";
+import { McpServerStatus } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/state/protocol/state";
+import { IOutputService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/output/common/output.service";
+import { type CustomizationDisabledReason } from "@codingame/monaco-vscode-api/vscode/vs/platform/agentHost/common/customizationEnablement";
+import { INotificationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/notification/common/notification.service";
+import { IMcpServerDetailInput } from "./embeddedMcpServerDetail.js";
+export declare const MCP_ERROR_PREVIEW_LENGTH = 300;
+/**
+ * Represents an individual MCP server item in the list.
+ */
+interface IMcpServerItemEntry {
+    readonly type: "server-item";
+    readonly server: IWorkbenchMcpServer;
+    readonly activeSessionServer?: AgentHostMcpServer;
+    readonly localServer?: IMcpServer;
+    /**
+     * Whether this entry originates from a marketplace browse result. Marketplace rows always use
+     * the gallery row presentation (with an Install/Installed button), even when the server is
+     * already installed, so installed and not-installed results look consistent.
+     */
+    readonly marketplace?: boolean;
+}
+interface IMcpSessionServerItemEntry {
+    readonly type: "session-server-item";
+    readonly server: AgentHostMcpServer;
+}
+/**
+ * Represents a built-in MCP server provided by an extension or plugin.
+ */
+interface IMcpBuiltinItemEntry {
+    readonly type: "builtin-item";
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+    readonly collectionId?: string;
+    readonly activeSessionServer?: AgentHostMcpServer;
+    readonly localServer?: IMcpServer;
+}
+export type AgentHostMcpServer = ReturnType<IAgentHostCustomizationService["getMcpServers"]>[number];
+export declare function createBuiltinActiveSessionMcpEntries(servers: readonly AgentHostMcpServer[]): readonly IMcpSessionServerItemEntry[];
+export declare function isMcpServerCollectionVisible(collectionId: string, hiddenCollectionIds: readonly string[] | undefined): boolean;
+type IMcpInstalledEntry = IMcpServerItemEntry | IMcpSessionServerItemEntry | IMcpBuiltinItemEntry;
+interface IMcpInstalledPresentation {
+    readonly entry: IMcpInstalledEntry;
+}
+export type McpStatusKind = McpConnectionState.Kind | McpServerStatus | "disabled";
+export declare function getToggledMcpEnablementState(state: ContributionEnablementState): ContributionEnablementState;
+interface IMcpServerItemTemplateData {
+    readonly container: HTMLElement;
+    readonly typeIcon: HTMLElement;
+    readonly name: HTMLElement;
+    readonly statusBadge: HTMLElement;
+    readonly description: HTMLElement;
+    readonly descriptionHover: IManagedHover;
+    readonly expandButton: Button;
+    readonly actions: HTMLElement;
+    readonly templateDisposables: DisposableStore;
+    readonly elementDisposables: DisposableStore;
+    readonly actionDisposables: DisposableStore;
+    /** Which row the actions currently belong to, so a recycled template cannot reuse another row's. */
+    renderedRowKey?: string;
+    /** What the actions currently show, so an unchanged status does not rebuild them. */
+    renderedStatusSignature?: string;
+    renderedDescription?: string;
+    currentElement?: IMcpInstalledEntry;
+    currentError?: string;
+    isRendering: boolean;
+    isExpanded: boolean;
+    isClipped: boolean;
+    currentIndex: number;
+}
+/**
+ * Renderer for local MCP server list items.
+ */
+/**
+ * Renderer for local MCP server list items.
+ *
+ * Exported for testing: the guard that keeps a row's actions alive across no-op updates is only
+ * observable by driving the renderer itself.
+ */
+export declare class McpServerItemRenderer extends Disposable implements IListRenderer<IMcpServerItemEntry | IMcpSessionServerItemEntry | IMcpBuiltinItemEntry, IMcpServerItemTemplateData> {
+    private readonly _renderManagementActions;
+    private readonly workspaceService;
+    private readonly agentPluginService;
+    private readonly hoverService;
+    private readonly agentHostCustomizationService;
+    private readonly customizationHarnessService;
+    readonly templateId = "mcpServerItem";
+    private readonly _templates;
+    private _focusedIndex;
+    private readonly _onDidChangeHeight;
+    readonly onDidChangeHeight: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<{
+        index: number;
+        text: string | undefined;
+        expanded: boolean;
+    }>;
+    private readonly errorExpansionChanged;
+    private readonly expandedErrors;
+    private expansionSession;
+    constructor(_renderManagementActions: (getEntry: () => IMcpInstalledEntry | undefined, actions: HTMLElement, disposables: DisposableStore, updateTabbability: () => void) => void, workspaceService: IAICustomizationWorkspaceService, agentPluginService: IAgentPluginService, hoverService: IHoverService, agentHostCustomizationService: IAgentHostCustomizationService, customizationHarnessService: ICustomizationHarnessService);
+    readErrorExpansion(reader: IReader): void;
+    syncError(element: IMcpInstalledEntry, error: string | undefined): void;
+    isErrorExpanded(element: IMcpInstalledEntry, error: string | undefined): boolean;
+    isErrorClipped(element: IMcpInstalledEntry): boolean;
+    renderTemplate(container: HTMLElement): IMcpServerItemTemplateData;
+    renderElement(element: IMcpServerItemEntry | IMcpSessionServerItemEntry | IMcpBuiltinItemEntry, index: number, templateData: IMcpServerItemTemplateData): void;
+    private renderEntry;
+    private updateKnownServerStatus;
+    private updateActiveSessionStatus;
+    private updateStatus;
+    setFocusedIndex(index: number): void;
+    private updateActionsTabbability;
+    private notifyHeightChange;
+    private renderDescription;
+    private updateExpandButton;
+    disposeElement(_element: IMcpInstalledEntry, _index: number, templateData: IMcpServerItemTemplateData): void;
+    disposeTemplate(templateData: IMcpServerItemTemplateData): void;
+    dispose(): void;
+}
+/** Registers an inline MCP button without allowing its pointer or click events to open the containing list row. */
+export declare function registerMcpInlineButtonAction(store: Pick<DisposableStore, "add">, button: Button, action: () => void | Promise<void>): void;
+/** Runs authentication for one active-session MCP server. */
+export declare function authenticateMcpServer(agentHostCustomizationService: IAgentHostCustomizationService, sessionResource: URI, serverId: string): Promise<boolean>;
+/** Resolves the output action for an MCP server, preferring its active agent-host output. */
+export declare function getMcpServerOutputHandler(outputService: Pick<IOutputService, "showChannel">, localServer: Pick<IMcpServer, "showOutput"> | undefined, activeSessionServer: AgentHostMcpServer | undefined, closeCustomizationEditor?: () => Promise<void>, showActiveSessionOutput?: (beforeShow?: () => Promise<void>) => Promise<void>): (() => Promise<void>) | undefined;
+export interface IMcpStatusPresentation {
+    readonly label: string;
+    readonly className: string;
+    readonly icon?: ThemeIcon;
+}
+export declare function getMcpStatusPresentation(state: McpStatusKind | undefined, disabledReason?: CustomizationDisabledReason): IMcpStatusPresentation | undefined;
+export declare function getMcpErrorPreview(message: string): {
+    text: string;
+    truncated: boolean;
+};
+/** Everything the status actions of a row are built from: what they show, and what they act on. */
+export interface IMcpStatusRenderInput {
+    /** Identifies the row, so a recycled template never mistakes one server's actions for another's. */
+    readonly rowKey: string;
+    /** The server's name, which appears in the button titles and aria labels. */
+    readonly label: string;
+    /** Decides which actions exist at all: sign-in when auth is required, output on error. */
+    readonly state: McpStatusKind | undefined;
+    readonly statusLabel: string | undefined;
+    readonly statusClassName: string | undefined;
+    readonly statusIconId: string | undefined;
+    /** The active-session twin the sign-in and management actions are bound to. */
+    readonly activeSessionServerId: string | undefined;
+    readonly logOutputChannelId: string | undefined;
+    /** The local server the output action falls back to. */
+    readonly localServerId: string | undefined;
+    /** The session owning the row actions, so switching sessions invalidates their bindings. */
+    readonly activeSessionResource: string | undefined;
+}
+/**
+ * Reduces a row's status actions to a comparable value, so they are rebuilt only when they would
+ * actually differ. Rebuilding replaces the button nodes, and a node replaced between mousedown and
+ * mouseup never receives the click.
+ *
+ * Must cover every value the actions are built from -- what they render and what they act on --
+ * or a change that matters is dropped. The tests enforce completeness at compile time.
+ */
+export declare function getMcpStatusRenderSignature(input: IMcpStatusRenderInput): string;
+export declare function getActiveSessionServerPresentation(server: AgentHostMcpServer): {
+    readonly enabled: boolean;
+    readonly status: McpStatusKind;
+};
+export declare function updateMcpCardRuntimePresentation(statusBadge: HTMLElement, primaryAction: HTMLElement, description: HTMLElement, statusKind: McpStatusKind | undefined, disabledReason: CustomizationDisabledReason | undefined, ariaLabel: string, descriptionText: string): void;
+export declare function shouldLoadMcpGallerySnapshot(visible: boolean, query: string, itemCount: number, failed: boolean, loading: boolean, accessEnabled: boolean): boolean;
+export declare function hasSameMcpMembership(previous: string, current: string): boolean;
+export declare function getActiveSessionServerLifecycleAction(server: AgentHostMcpServer): Action | undefined;
+type AgentHostMcpServerEnablementScope = "global" | "workspace" | "session";
+/** Creates enablement actions for an agent-host server. */
+export declare function getAgentHostMcpServerEnablementActions(agentHostCustomizations: IAgentHostCustomizationService, agentPluginService: IAgentPluginService, sessionResource: URI, server: AgentHostMcpServer, scopes?: readonly AgentHostMcpServerEnablementScope[]): IAction[];
+export declare function setPrimaryMcpServerEnablement(mcpService: IMcpService, agentHostCustomizations: IAgentHostCustomizationService, sessionResource: URI, localServerId: string | undefined, activeSessionServer: AgentHostMcpServer | undefined, enabled: boolean): void;
+export declare function isPrimaryMcpServerEnabled(mcpService: IMcpService, localServerId: string | undefined, activeSessionServer: AgentHostMcpServer | undefined): boolean;
+/** Creates durable profile/workspace actions for a locally backed built-in server row. */
+export declare function getLocalMcpServerEnablementActions(mcpService: IMcpService, serverId: string, isEmptyWorkbench: boolean, options?: {
+    readonly includeWorkspace?: boolean;
+    readonly activeSessionServer?: AgentHostMcpServer;
+}): IAction[];
+/** Creates enablement actions for a built-in row, using the active agent-host session for scoped actions. */
+export declare function getBuiltinMcpServerEnablementActions(mcpService: IMcpService, serverId: string, isEmptyWorkbench: boolean, agentHostCustomizations: IAgentHostCustomizationService, agentPluginService: IAgentPluginService, sessionResource: URI, activeSessionServer: AgentHostMcpServer | undefined): IAction[];
+/** Composes lifecycle, scoped enablement, and options actions for an agent-host-only row. */
+export declare function getActiveSessionServerOptionsActions(commandService: ICommandService, agentHostCustomizations: IAgentHostCustomizationService, agentPluginService: IAgentPluginService, sessionResource: URI, server: AgentHostMcpServer): IAction[];
+export declare function getServerItemContextMenuActions(menuActionGroups: readonly (readonly IAction[])[], activeSessionServer: AgentHostMcpServer | undefined, activeSessionLifecycleAction: IAction | undefined, agentHostEnablementActions: readonly IAction[]): IAction[];
+export declare function createInstalledMcpServerDetailInput(entry: IMcpInstalledEntry): IMcpServerDetailInput;
 /**
  * Widget that displays a list of MCP servers with marketplace browsing.
  */
@@ -28,16 +223,17 @@ export declare class McpListWidget extends Disposable {
     private readonly openerService;
     private readonly contextViewService;
     private readonly contextMenuService;
-    private readonly hoverService;
     private readonly agentPluginService;
     private readonly dialogService;
     private readonly configurationService;
     private readonly customizationHarnessService;
     private readonly agentHostCustomizationService;
     private readonly workspaceService;
+    private readonly notificationService;
+    private readonly outputService;
     readonly element: HTMLElement;
     private readonly _onDidSelectServer;
-    readonly onDidSelectServer: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<IWorkbenchMcpServer>;
+    readonly onDidSelectServer: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<IMcpServerDetailInput>;
     private readonly _onDidChangeItemCount;
     readonly onDidChangeItemCount: import("@codingame/monaco-vscode-api/vscode/vs/base/common/event").Event<number>;
     private readonly _onDidRequestShowPlugin;
@@ -46,8 +242,10 @@ export declare class McpListWidget extends Disposable {
     private sectionLink;
     private searchAndButtonContainer;
     private searchInput;
-    private listContainer;
-    private list;
+    private cardContainer;
+    private cardScrollable;
+    private cardScrollableNode;
+    private sectionLayoutContainer;
     private emptyContainer;
     private emptyText;
     private emptySubtext;
@@ -55,33 +253,74 @@ export declare class McpListWidget extends Disposable {
     private disabledIcon;
     private disabledMessage;
     private readonly disabledLinkListener;
-    private browseButton;
-    private backButton;
-    private addButton;
+    private installedAddButton;
     private filteredServers;
     private filteredBuiltinCount;
     private filteredActiveSessionCount;
-    private displayEntries;
+    private installedEntries;
+    private gallerySnapshotServers;
     private galleryServers;
     private searchQuery;
-    private browseMode;
+    private gallerySnapshotFailed;
+    private gallerySnapshotLoading;
+    private gallerySearchLoading;
+    private visible;
+    private mcpAccessEnabled;
+    private firstCardFocusElement;
+    private availableSection;
+    private narrowLayout;
+    private wideLayout;
     private lastHeight;
     private lastWidth;
     private lastHeaderHeight;
     private _layoutDeferred;
-    private readonly collapsedGroups;
+    private readonly revealLastItemScheduler;
+    private readonly sectionScrollPositions;
     private galleryCts;
+    private readonly cardDisposables;
+    private readonly pendingSectionLayout;
+    private readonly cardListControllers;
+    private sectionLists;
+    private collapsedSections;
     private readonly delayedFilter;
     private readonly delayedGallerySearch;
-    constructor(instantiationService: IInstantiationService, mcpWorkbenchService: IMcpWorkbenchService, mcpService: IMcpService, mcpRegistry: IMcpRegistry, commandService: ICommandService, openerService: IOpenerService, contextViewService: IContextViewService, contextMenuService: IContextMenuService, hoverService: IHoverService, agentPluginService: IAgentPluginService, dialogService: IDialogService, configurationService: IConfigurationService, customizationHarnessService: ICustomizationHarnessService, agentHostCustomizationService: IAgentHostCustomizationService, workspaceService: IAICustomizationWorkspaceService);
+    private readonly agentHostCustomizationsChanged;
+    constructor(instantiationService: IInstantiationService, mcpWorkbenchService: IMcpWorkbenchService, mcpService: IMcpService, mcpRegistry: IMcpRegistry, commandService: ICommandService, openerService: IOpenerService, contextViewService: IContextViewService, contextMenuService: IContextMenuService, agentPluginService: IAgentPluginService, dialogService: IDialogService, configurationService: IConfigurationService, customizationHarnessService: ICustomizationHarnessService, agentHostCustomizationService: IAgentHostCustomizationService, workspaceService: IAICustomizationWorkspaceService, notificationService: INotificationService, outputService: IOutputService, mcpGalleryManifestService: IMcpGalleryManifestService);
     private create;
     private refresh;
+    setVisible(visible: boolean): void;
     private updateAccessState;
     showBrowseMarketplace(): void;
-    private toggleBrowseMode;
-    private queryGallery;
-    private updateGalleryList;
+    private queryGallerySnapshot;
+    private queryMcpSearch;
+    private showCardSurface;
+    private showEmptySurface;
+    private createCardScrollContent;
+    private addSurfaceActivation;
+    private renderCardSection;
+    private createMcpSectionList;
+    private captureSectionScrollPositions;
+    private getMcpEntryAriaLabel;
+    private renderMcpListActions;
+    private layoutMcpSectionLists;
+    private scheduleMcpSectionLayout;
+    private renderMcpHome;
+    private renderInstalledSectionActions;
+    private renderAvailableServers;
+    protected appendInstalledServerRow(parent: HTMLElement, presentation: IMcpInstalledPresentation): void;
+    private appendInstalledServerSignIn;
+    private appendInstalledServerToggle;
+    protected appendMarketplaceServerRow(parent: HTMLElement, server: IWorkbenchMcpServer): void;
+    private installMarketplaceServer;
+    private getAvailableGalleryServers;
+    private matchesGalleryServerQuery;
+    private getInstalledEntryDescription;
+    private isInstalledEntryEnabled;
+    private setInstalledEntryEnabled;
+    private updateSearchResults;
     private filterServers;
+    private renderFilteredServers;
+    private getInstalledEntryMembershipSignature;
     /**
      * Gets the total item count from the underlying data arrays
      * (the same source used to build group headers).
@@ -92,17 +331,7 @@ export declare class McpListWidget extends Disposable {
      * to ensure the subscriber receives the latest count.
      */
     fireItemCount(): void;
-    /**
-     * Toggles the collapsed state of a group.
-     */
-    private toggleGroup;
-    /**
-     * Whether the widget is currently in marketplace browse mode.
-     */
     isInBrowseMode(): boolean;
-    /**
-     * Exits marketplace browse mode and returns to the installed servers list.
-     */
     exitBrowseMode(): void;
     /**
      * Layouts the widget.
@@ -120,9 +349,9 @@ export declare class McpListWidget extends Disposable {
      * Focuses the list.
      */
     focus(): void;
-    private openActiveSessionServerOptions;
-    /**
-     * Handles context menu for MCP server items.
-     */
-    private onContextMenu;
+    private updateResponsiveLayout;
+    private showMcpServerActions;
+    private getMcpServerActions;
+    private getMcpServerManagementActions;
 }
+export {};