@wuyax/mcps 0.1.0-beta.3 → 0.1.0

package/dist/index.d.ts

@@ -1,129 +1,6 @@
-import { Separator, Theme } from '@inquirer/core';
-import { Context } from '@inquirer/type';
-import { Command } from 'commander';
+import { M as McpAgentType, d as McpAgentConfig, e as McpTransportType, b as McpServerConfig, c as McpRemoteTransport, P as ParsedMcpSource, f as McpConfigFormat, a as McpScopeOptions, C as ConfigCluster, g as McpInstallResultForAgent, R as RemoveMcpServerResult, I as InstallMcpServerOptions, h as InstallMcpServerResult, U as UpdateMcpServerOptions, i as UpdateMcpServerResult, j as RemoveMcpServerOptions, L as ListedMcpServer, G as GroupedInstalledServer, S as ServerConfigDialect } from './types-lEP3zGvf.js';
+export { k as McpSourceType, l as ServerConfigDialectName, m as ServerConfigDialectOptions } from './types-lEP3zGvf.js';
 
-type McpAgentType = "amp" | "antigravity" | "antigravity-cli" | "augment" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "grok" | "goose" | "github-copilot-cli" | "kimi-code-cli" | "kiro" | "opencode" | "pi" | "qoder" | "qwen-code" | "trae" | "vscode" | "zed";
-type McpConfigFormat = "json" | "jsonc" | "yaml" | "toml";
-type McpTransportType = "http" | "sse" | "stdio";
-type McpRemoteTransport = "http" | "sse";
-type McpSourceType = "remote" | "package" | "command";
-interface ParsedMcpSource {
-    type: McpSourceType;
-    value: string;
-    inferredName: string;
-}
-interface McpServerConfig {
-    type?: McpRemoteTransport;
-    url?: string;
-    headers?: Record<string, string>;
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-}
-type ServerConfigDialectName = "vscode" | "augment" | "amp" | "trae" | "grok" | "cline" | "goose" | "kimi-code" | "kiro" | "opencode" | "pi" | "qwen-code" | "zed";
-interface ServerConfigDialectOptions {
-    stdioTransport?: "none" | "type-stdio" | "transport-stdio" | "type-local";
-    remoteTransport?: "type-http-sse" | "sse-only-type" | "sse-only-transport" | "none" | "streamable-http" | "streamableHttp" | "streamable_http" | "remote-type" | "qwen";
-    commandArray?: boolean;
-    commandField?: string;
-    argsField?: string;
-    envField?: string;
-    urlField?: string;
-    defaultEnvEmpty?: boolean;
-    defaultHeadersEmpty?: boolean;
-    extraFields?: Record<string, unknown>;
-    includeServerName?: boolean;
-    timeoutSeconds?: number;
-}
-type ServerConfigDialect = ServerConfigDialectName | ServerConfigDialectOptions;
-interface McpAgentConfig {
-    name: McpAgentType;
-    displayName: string;
-    globalConfigPath: string;
-    projectConfigPath?: string;
-    configKey: string;
-    projectConfigKey?: string;
-    format: McpConfigFormat;
-    supportedTransports: readonly McpTransportType[];
-    unsupportedTransportMessage?: string;
-    detectGlobalInstall: () => boolean;
-    detectProjectInstall?: (cwd: string) => boolean;
-    resolveConfigPath?: (options: {
-        global: boolean;
-        cwd: string;
-    }) => string;
-    transformDialect?: ServerConfigDialect;
-    transformConfig?: (serverName: string, config: McpServerConfig, context: {
-        global: boolean;
-    }) => unknown;
-}
-interface McpScopeOptions {
-    global?: boolean;
-    cwd?: string;
-}
-interface InstallMcpServerOptions extends McpScopeOptions {
-    source: string;
-    name?: string;
-    agents?: McpAgentType[];
-    args?: string[];
-    transport?: McpRemoteTransport;
-    headers?: Record<string, string>;
-    env?: Record<string, string>;
-}
-interface McpInstallResultForAgent {
-    agent: McpAgentType;
-    success: boolean;
-    path: string;
-    coConfiguredAgents?: McpAgentType[];
-    error?: string;
-}
-interface InstallMcpServerResult {
-    serverName: string;
-    config: McpServerConfig;
-    results: McpInstallResultForAgent[];
-}
-interface ListedMcpServer {
-    serverName: string;
-    agent: McpAgentType;
-    path: string;
-    config: unknown;
-    serverConfig?: McpServerConfig;
-}
-interface RemoveMcpServerOptions extends McpScopeOptions {
-    name: string;
-    agents?: McpAgentType[];
-}
-interface RemoveMcpServerResult {
-    agent: McpAgentType;
-    path: string;
-    removed: boolean;
-    coAffectedAgents?: McpAgentType[];
-    error?: string;
-}
-interface ConfigCluster {
-    configPath: string;
-    configKey: string;
-    targetAgents: McpAgentType[];
-    coHostedAgents: McpAgentType[];
-}
-interface UpdateMcpServerOptions extends McpScopeOptions {
-    serverName: string;
-    config: McpServerConfig;
-    previousConfig?: McpServerConfig;
-    agents?: McpAgentType[];
-}
-interface UpdateMcpServerResult {
-    serverName: string;
-    config: McpServerConfig;
-    results: McpInstallResultForAgent[];
-    incompatible: {
-        agent: McpAgentType;
-        reason: string;
-    }[];
-}
-
-declare const mcpAgents: Record<McpAgentType, McpAgentConfig>;
-declare const mcpAgentAliases: Record<string, McpAgentType>;
 declare const getMcpAgentConfig: (agentType: McpAgentType) => McpAgentConfig;
 declare const getMcpAgentTypes: () => McpAgentType[];
 declare const isMcpAgentType: (value: string) => value is McpAgentType;
@@ -133,14 +10,7 @@ declare const detectProjectInstalledMcpAgents: (cwd: string) => McpAgentType[];
 declare const detectGloballyInstalledMcpAgents: () => McpAgentType[];
 declare const getMcpAgentsSupportingProjectScope: () => McpAgentType[];
 
-interface BuildMcpServerConfigOptions {
-    transport?: McpRemoteTransport;
-    headers?: Record<string, string>;
-    env?: Record<string, string>;
-    args?: string[];
-}
-declare const buildMcpServerConfig: (parsed: ParsedMcpSource, options?: BuildMcpServerConfigOptions) => McpServerConfig;
-
+type UpdateTransitionType = "switch-to-remote" | "switch-to-stdio" | "merge-remote" | "merge-stdio";
 interface McpRemoteServerConfig {
     type: McpRemoteTransport;
     url: string;
@@ -159,31 +29,81 @@ declare const isRemoteServerConfig: (config: McpServerConfig) => config is McpRe
  * Type guard for local (stdio command/script) server configuration.
  */
 declare const isStdioServerConfig: (config: McpServerConfig) => config is McpStdioServerConfig;
+interface BuildMcpServerConfigOptions {
+    transport?: McpRemoteTransport;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+    args?: string[];
+}
+/**
+ * Deep module builder: Constructs a typed standard McpServerConfig from parsed MCP source.
+ */
+declare const buildMcpServerConfig: (parsed: ParsedMcpSource, options?: BuildMcpServerConfigOptions) => McpServerConfig;
 /**
  * Parses and normalizes any unknown raw configuration object from agent config files
  * into a typed standard McpServerConfig domain model.
  */
 declare const parseServerConfig: (raw: unknown) => McpServerConfig;
+/**
+ * Transforms a server configuration into a clean remote configuration,
+ * stripping stdio-exclusive fields (command, args, env).
+ */
+declare const toRemoteServerConfig: (config: McpServerConfig, defaultTransport?: McpRemoteTransport) => McpServerConfig;
+/**
+ * Transforms a server configuration into a clean stdio configuration,
+ * stripping remote-exclusive fields (url, type, headers).
+ */
+declare const toStdioServerConfig: (config: McpServerConfig) => McpServerConfig;
+/**
+ * Determines the transition category when updating an MCP server configuration.
+ */
+declare const detectUpdateTransition: (incoming: McpServerConfig, previous?: McpServerConfig) => UpdateTransitionType;
+/**
+ * Strips obsolete fields when switching between stdio and remote protocols.
+ * When switching to remote (url is provided), stdio fields (command, args, env) are removed.
+ * When switching to stdio (command is provided), remote fields (url, type, headers) are removed.
+ */
+declare const sanitizeUpdatedServerConfig: (incoming: McpServerConfig, previous?: McpServerConfig) => McpServerConfig;
+interface ServerConfigDeltaOptions {
+    command?: string;
+    args?: string[];
+    clearArgs?: boolean;
+    env?: Record<string, string>;
+    clearEnv?: boolean;
+    url?: string;
+    transport?: McpRemoteTransport;
+    headers?: Record<string, string>;
+    clearHeaders?: boolean;
+}
+interface ApplyServerConfigDeltaResult {
+    config: McpServerConfig;
+    transition: UpdateTransitionType;
+    protocol: "remote" | "stdio";
+    ignoredFlags: string[];
+}
+/**
+ * Deep domain operation: Applies modification flags to an existing configuration,
+ * validates command vs url mutual exclusion, determines the target protocol,
+ * identifies ignored incompatible flags, and produces a clean, sanitized configuration.
+ */
+declare const applyServerConfigDelta: (previousConfig: McpServerConfig | undefined, options: ServerConfigDeltaOptions) => ApplyServerConfigDeltaResult;
 
 declare const DEFAULT_REMOTE_TRANSPORT: "http";
-declare const NPX_COMMAND = "npx";
-declare const NPX_DASH_Y = "-y";
 
-declare const readConfigFile: (filePath: string, format: McpConfigFormat) => Record<string, unknown>;
-declare const writeServerToConfigFile: (filePath: string, format: McpConfigFormat, dottedKey: string, serverName: string, serverConfig: unknown) => void;
-declare const removeServerFromConfigFile: (filePath: string, format: McpConfigFormat, dottedKey: string, serverName: string) => boolean;
-declare const listServersInConfigFile: (filePath: string, format: McpConfigFormat, dottedKey: string) => Record<string, unknown>;
+declare const extractPackageName: (input: string) => string;
+declare const parseMcpSource: (input: string) => ParsedMcpSource;
+declare const isRemoteMcpSource: (parsed: ParsedMcpSource) => boolean;
 
 interface McpConfigTarget {
     configPath: string;
     configKey: string;
 }
-interface ResolveMcpConfigTargetOptions {
-    global?: boolean;
-    cwd?: string;
-}
-declare const resolveMcpConfigTarget: (agent: McpAgentConfig, options?: ResolveMcpConfigTargetOptions) => McpConfigTarget;
+declare const resolveMcpConfigTarget: (agent: McpAgentConfig, options?: McpScopeOptions) => McpConfigTarget;
 
+/**
+ * Returns candidate agent types relevant for the given scope.
+ */
+declare const getCandidateAgentsForScope: (options?: McpScopeOptions) => McpAgentType[];
 interface ConfigTargetDescriptor {
     filePath: string;
     format: McpConfigFormat;
@@ -209,8 +129,8 @@ interface AgentConfigStoreListResult {
     servers: Record<string, unknown>;
 }
 /**
- * Deep module: Coordinates Agent config target resolution, file checking,
- * and format persistence behind a unified seam.
+ * Deep module: Coordinates Agent config target resolution, cluster deduplication,
+ * dialect transforms, file checking, and format persistence behind a unified seam.
  */
 declare class AgentConfigStore {
     private adapter;
@@ -224,15 +144,70 @@ declare class AgentConfigStore {
     writeServer(agent: McpAgentType | McpAgentConfig, serverName: string, serverConfig: unknown, options?: McpScopeOptions): AgentConfigStoreWriteResult;
     removeServer(agent: McpAgentType | McpAgentConfig, serverName: string, options?: McpScopeOptions): AgentConfigStoreRemoveResult;
     listServers(agent: McpAgentType | McpAgentConfig, options?: McpScopeOptions): AgentConfigStoreListResult;
+    /**
+     * Batch lists servers for multiple agents, caching adapter reads for co-hosted
+     * agents that share the exact same physical configuration file and dotted key.
+     */
+    listServersForAgents(agents: McpAgentType[], options?: McpScopeOptions): Array<{
+        agent: McpAgentType;
+        path: string;
+        exists: boolean;
+        servers: Record<string, unknown>;
+    }>;
     read(agent: McpAgentType | McpAgentConfig, options?: McpScopeOptions): Record<string, unknown>;
     readServer(agent: McpAgentType | McpAgentConfig, serverName: string, options?: McpScopeOptions): unknown | undefined;
+    /**
+     * Returns all other agents sharing the exact same physical configuration target
+     * (same configPath and configKey) for the given scope.
+     */
+    getCoHostedAgents(agentType: McpAgentType, options?: McpScopeOptions): McpAgentType[];
+    /**
+     * Resolves configuration clusters for a given list of requested agents.
+     * Groups requested agents sharing the same physical config path, and tracks
+     * any remaining co-hosted agents sharing the same target that were not in the request.
+     */
+    resolveConfigClusters(agentTypes: McpAgentType[], options?: McpScopeOptions): ConfigCluster[];
+    /**
+     * Sorts agent types so that agents sharing the same physical config target
+     * appear adjacent to each other in the returned array.
+     */
+    sortAgentsByClusters(agentTypes: McpAgentType[], options?: McpScopeOptions): McpAgentType[];
+    /**
+     * Alias for sortAgentsByClusters for backward compatibility.
+     */
+    sortAgentsWithClusters(agentTypes: McpAgentType[], options?: McpScopeOptions): McpAgentType[];
+    /**
+     * Batch write: transforms and writes a server config to multiple agents,
+     * with automatic cluster deduplication, dialect transform, and co-hosted awareness.
+     * Callers pass standard McpServerConfig; the Store applies per-Agent dialect transforms
+     * internally before persisting.
+     */
+    writeServers(agents: McpAgentType[], serverName: string, serverConfig: McpServerConfig, options?: McpScopeOptions): McpInstallResultForAgent[];
+    /**
+     * Batch remove: removes a server from multiple agents' configs,
+     * with automatic cluster deduplication and co-hosted awareness.
+     */
+    removeServers(agents: McpAgentType[], serverName: string, options?: McpScopeOptions): RemoveMcpServerResult[];
 }
 /**
  * Singleton AgentConfigStore using standard file system adapter.
  */
 declare const agentConfigStore: AgentConfigStore;
 
-declare const installMcpServer: (options: InstallMcpServerOptions) => InstallMcpServerResult;
+/**
+ * Returns all other agents sharing the exact same physical configuration target
+ * (same configPath and configKey) for the given scope.
+ */
+declare const getCoHostedAgents: (agentType: McpAgentType, options?: McpScopeOptions) => McpAgentType[];
+/**
+ * Resolves configuration clusters for a given list of requested agents.
+ */
+declare const resolveConfigClusters: (agentTypes: McpAgentType[], options?: McpScopeOptions) => ConfigCluster[];
+/**
+ * Sorts agent types so that agents sharing the same physical config target
+ * appear adjacent to each other in the returned array.
+ */
+declare const sortAgentsByClusters: (agentTypes: McpAgentType[], options?: McpScopeOptions) => McpAgentType[];
 
 interface TargetResolutionQuery extends McpScopeOptions {
     requested?: string[] | McpAgentType[];
@@ -267,9 +242,9 @@ interface TargetResolutionResult {
  */
 declare const resolveTargetAgents: (query?: TargetResolutionQuery) => TargetResolutionResult;
 
+declare const installMcpServer: (options: InstallMcpServerOptions) => InstallMcpServerResult;
+
 type InstallMcpServerForAgentOptions = McpScopeOptions;
-declare const installMcpServerForAgent: (serverName: string, serverConfig: McpServerConfig, agentType: McpAgentType, options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent;
-declare const installMcpServerForAgents: (serverName: string, serverConfig: McpServerConfig, agentTypes: McpAgentType[], options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent[];
 interface InstallToCompatibleAgentsOptions extends McpScopeOptions {
     allAgents: McpAgentType[];
     incompatible?: Array<{
@@ -277,329 +252,43 @@ interface InstallToCompatibleAgentsOptions extends McpScopeOptions {
         reason: string;
     }>;
 }
-declare const installToCompatibleAgents: (serverName: string, serverConfig: McpServerConfig, options: InstallToCompatibleAgentsOptions) => McpInstallResultForAgent[];
-
 /**
- * Returns candidate agent types relevant for the given scope.
+ * Backward-compatible wrapper: installs a server config for a single agent
+ * via the deepened AgentConfigStore.
  */
-declare const getCandidateAgentsForScope: (options?: McpScopeOptions) => McpAgentType[];
+declare const installMcpServerForAgent: (serverName: string, serverConfig: McpServerConfig, agentType: McpAgentType, options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent;
 /**
- * Returns all other agents sharing the exact same physical configuration target
- * (same configPath and configKey) for the given scope.
+ * Backward-compatible wrapper: installs a server config to multiple agents
+ * via the deepened AgentConfigStore.
  */
-declare const getCoHostedAgents: (agentType: McpAgentType, options?: McpScopeOptions) => McpAgentType[];
-/**
- * Resolves configuration clusters for a given list of requested agents.
- * Groups requested agents sharing the same physical config path, and tracks
- * any remaining co-hosted agents sharing the same target that were not in the request.
- */
-declare const resolveConfigClusters: (agentTypes: McpAgentType[], options?: McpScopeOptions) => ConfigCluster[];
+declare const installMcpServerForAgents: (serverName: string, serverConfig: McpServerConfig, agentTypes: McpAgentType[], options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent[];
 /**
- * Sorts agent types so that agents sharing the same physical config target
- * appear adjacent to each other in the returned array.
+ * Backward-compatible wrapper: filters out incompatible agents and installs
+ * to the remaining compatible ones via the deepened AgentConfigStore.
  */
-declare const sortAgentsWithClusters: (agentTypes: McpAgentType[], options?: McpScopeOptions) => McpAgentType[];
-
-interface ListInstalledMcpServersOptions extends McpScopeOptions {
-    agents?: McpAgentType[];
-}
-declare const listInstalledMcpServers: (options?: ListInstalledMcpServersOptions) => ListedMcpServer[];
-
-declare const extractPackageName: (input: string) => string;
-declare const parseMcpSource: (input: string) => ParsedMcpSource;
-declare const isRemoteMcpSource: (parsed: ParsedMcpSource) => boolean;
-
-declare const removeMcpServerFromAgent: (serverName: string, agentType: McpAgentType, options?: {
-    global?: boolean;
-    cwd?: string;
-}) => RemoveMcpServerResult;
-declare const removeMcpServer: (options: RemoveMcpServerOptions) => RemoveMcpServerResult[];
+declare const installToCompatibleAgents: (serverName: string, serverConfig: McpServerConfig, options: InstallToCompatibleAgentsOptions) => McpInstallResultForAgent[];
 
-/**
- * Transforms a server configuration into a clean remote configuration,
- * stripping stdio-exclusive fields (command, args, env).
- */
-declare const toRemoteServerConfig: (config: McpServerConfig, defaultTransport?: McpRemoteTransport) => McpServerConfig;
-/**
- * Transforms a server configuration into a clean stdio configuration,
- * stripping remote-exclusive fields (url, type, headers).
- */
-declare const toStdioServerConfig: (config: McpServerConfig) => McpServerConfig;
-type UpdateTransitionType = "switch-to-remote" | "switch-to-stdio" | "merge-remote" | "merge-stdio";
-/**
- * Determines the transition category when updating an MCP server configuration.
- */
-declare const detectUpdateTransition: (incoming: McpServerConfig, previous?: McpServerConfig) => UpdateTransitionType;
-/**
- * Strips obsolete fields when switching between stdio and remote protocols.
- * When switching to remote (url is provided), stdio fields (command, args, env) are removed.
- * When switching to stdio (command is provided), remote fields (url, type, headers) are removed.
- */
-declare const sanitizeUpdatedServerConfig: (incoming: McpServerConfig, previous?: McpServerConfig) => McpServerConfig;
 /**
  * Core Orchestration: Updates an existing MCP server across specified or installed coding agents,
  * sanitizing protocol dirty fields and validating transport capabilities.
  */
 declare const updateMcpServer: (options: UpdateMcpServerOptions) => UpdateMcpServerResult;
 
-declare const mainMenu: () => Promise<void>;
-
-interface WizardAddOptions extends McpScopeOptions {
-    source?: string;
-    name?: string;
-    agents?: McpAgentType[];
-    args?: string[];
-    transport?: McpRemoteTransport;
-    headers?: Record<string, string>;
-    env?: Record<string, string>;
-}
-declare const wizardAdd: (initial?: WizardAddOptions) => Promise<boolean>;
-
-interface DisplayServerDetailsOptions extends McpScopeOptions {
-    serverName: string;
-    config: McpServerConfig;
-    agents?: McpAgentType[];
-    hasDivergence?: boolean;
-    titlePrefix?: string;
-}
-/**
- * Reusable display function for server details with secret masking.
- */
-declare const displayServerDetails: ({ serverName, config, agents, hasDivergence, global: isGlobal, titlePrefix, }: DisplayServerDetailsOptions) => void;
-
-/**
- * Validates and resolves remote transport string into McpRemoteTransport.
- */
-declare const resolveTransport: (input: string | undefined) => McpRemoteTransport | undefined;
-
-declare const SECRET_KEY_PATTERN: RegExp;
-/**
- * Masks sensitive values for secure CLI display.
- */
-declare const maskSecretValue: (key: string, value: string) => string;
-declare const SECRET_HEADER_PATTERN: RegExp;
-/**
- * Masks sensitive HTTP header values for secure CLI display.
- */
-declare const maskSecretHeader: (key: string, value: string) => string;
-
-interface GroupedInstalledServer {
-    serverName: string;
-    agents: McpAgentType[];
-    paths: string[];
-    config: McpServerConfig;
-    hasDivergence?: boolean;
-}
-declare const normalizeServerConfig: (raw: unknown) => McpServerConfig;
-/**
- * Groups a flat array of ListedMcpServer entries by serverName.
- */
-declare const groupInstalledServersByName: (installed: ListedMcpServer[]) => Map<string, GroupedInstalledServer>;
-
-interface WizardManageOptions extends McpScopeOptions {
-    serverName?: string;
-}
-interface EditServerConfigOptions extends McpScopeOptions {
-    targetGroup: GroupedInstalledServer;
-}
-/**
- * Interactive prompt flow to switch an MCP server between stdio and remote protocols.
- */
-declare const promptSwitchServerType: (currentConfig: McpServerConfig, serverName: string) => Promise<McpServerConfig>;
-declare const wizardManage: (options?: WizardManageOptions) => Promise<void>;
+declare const removeMcpServer: (options: RemoveMcpServerOptions) => RemoveMcpServerResult[];
 
-interface WizardRemoveOptions extends McpScopeOptions {
-    name?: string;
+interface ListInstalledMcpServersOptions extends McpScopeOptions {
     agents?: McpAgentType[];
 }
-declare const wizardRemove: (options?: WizardRemoveOptions) => Promise<boolean>;
-
-interface PromptEditKeyValueOptions {
-    title: string;
-    itemNoun: string;
-    itemsNoun: string;
-    maskValue: (key: string, value: string) => string;
-    isSecretKey: (key: string) => boolean;
-    formatText: (items: Record<string, string>) => string;
-    parseText: (text: string) => Record<string, string>;
-    editorPostfix?: string;
-    editorMessage: string;
-    pasteMessage: string;
-    keyPromptMessage: string;
-    valuePromptMessage: string;
-    separator: "=" | ":";
-}
-/**
- * Generic reusable interactive key-value editing loop supporting:
- * - Editor launch with pre-filled content ($EDITOR)
- * - Single item upsert (with secret detection & password masking)
- * - Single item deletion
- * - Multiline paste (with merge or replace choices)
- * - Clear all items
- */
-declare const promptEditKeyValueConfig: (currentItems: Record<string, string> | undefined, options: PromptEditKeyValueOptions) => Promise<Record<string, string>>;
-
-/**
- * Formats a key-value env record into .env formatted multiline string.
- */
-declare const formatEnvText: (env: Record<string, string>) => string;
-/**
- * Parses multiline .env formatted text into a key-value record.
- * Supports:
- * - Empty lines and comments (#)
- * - `export KEY=VALUE` or `KEY=VALUE`
- * - Values with `=` inside
- * - Single/double quoted values
- */
-declare const parseEnvText: (rawText: string) => Record<string, string>;
-/**
- * Prompts user for environment variables.
- * Offers choices:
- * 1. Skip / No env vars
- * 2. Paste multiline .env text
- * 3. Add key-value one by one (with secret mask detection)
- */
-declare const promptEnvConfig: (initialEnv?: Record<string, string>) => Promise<Record<string, string>>;
-/**
- * Dedicated prompt loop for inspecting, modifying, adding, and removing
- * environment variables of an existing MCP server configuration.
- */
-declare const promptEditEnvConfig: (currentEnv?: Record<string, string>) => Promise<Record<string, string>>;
-
-/**
- * Formats a key-value headers record into multiline Key: Value text.
- */
-declare const formatHeadersText: (headers: Record<string, string>) => string;
-/**
- * Parses multiline HTTP headers text (Key: Value or Key=Value) into a Record<string, string>.
- */
-declare const parseHeadersText: (rawText: string) => Record<string, string>;
-/**
- * Interactively prompts user for HTTP headers.
- */
-declare const promptHeadersConfig: (initialHeaders?: Record<string, string>) => Promise<Record<string, string>>;
-/**
- * Dedicated prompt loop for inspecting, modifying, adding, and removing
- * HTTP headers of an existing MCP server configuration.
- */
-declare const promptEditHeadersConfig: (currentHeaders?: Record<string, string>) => Promise<Record<string, string>>;
-
-/**
- * Parses a command-line argument string into an array of arguments,
- * respecting single and double quotes for arguments with spaces.
- */
-declare const parseArgsString: (rawText: string) => string[];
-/**
- * Prompts the user for additional command-line arguments.
- */
-declare const promptArgsConfig: (initialArgs?: string[]) => Promise<string[]>;
-/**
- * Formats an array of argument strings into a space-separated CLI string,
- * quoting arguments containing spaces or quotes.
- */
-declare const formatArgsString: (args: string[]) => string;
-/**
- * Dedicated prompt for editing command arguments with current arguments pre-filled.
- */
-declare const promptEditArgs: (currentArgs?: string[]) => Promise<string[]>;
-
-interface PromptScopeAndAgentsOptions extends McpScopeOptions {
-    defaultGlobal?: boolean;
-    defaultAgents?: McpAgentType[];
-}
-interface ScopeAndAgentsResult {
-    global: boolean;
-    agents: McpAgentType[];
-}
 /**
- * Interactively prompts for scope (Project vs Global) and target agents.
- * Auto-detects installed agents and pre-selects them.
+ * Deep module query: Lists installed MCP servers across agents.
+ * Adapter read caching is encapsulated by AgentConfigStore.
  */
-declare const promptScopeAndAgents: (options?: PromptScopeAndAgentsOptions) => Promise<ScopeAndAgentsResult>;
-
-interface PromptScopeOptions extends McpScopeOptions {
-    defaultGlobal?: boolean;
-    message?: string;
-}
-/**
- * Prompts user to choose between project and global scope.
- * Returns true for global, false for project.
- */
-declare const promptScope: (options?: PromptScopeOptions) => Promise<boolean>;
-
-interface LinkedChoice<Value> {
-    value: Value;
-    name?: string;
-    checkedName?: string;
-    description?: string;
-    short?: string;
-    disabled?: boolean | string;
-    checked?: boolean;
-    linkedValues?: Value[];
-}
-interface NormalizedLinkedChoice<Value> {
-    value: Value;
-    name: string;
-    checkedName: string;
-    description?: string;
-    short: string;
-    disabled: boolean | string;
-    checked: boolean;
-    linkedValues: Value[];
-}
-interface LinkedCheckboxTheme {
-    icon: {
-        checked: string;
-        unchecked: string;
-        cursor: string;
-        disabledChecked: string;
-        disabledUnchecked: string;
-    };
-    style: {
-        disabled: (text: string) => string;
-        renderSelectedChoices: <T>(selectedChoices: ReadonlyArray<NormalizedLinkedChoice<T>>, allChoices: ReadonlyArray<NormalizedLinkedChoice<T> | Separator>) => string;
-        description: (text: string) => string;
-        keysHelpTip: (keys: [key: string, action: string][]) => string;
-        highlight: (text: string) => string;
-    };
-    i18n: {
-        disabledError: string;
-    };
-}
-interface LinkedCheckboxConfig<Value = string> {
-    message: string;
-    prefix?: string;
-    pageSize?: number;
-    choices: ReadonlyArray<Separator | Value | LinkedChoice<Value>>;
-    loop?: boolean;
-    required?: boolean;
-    validate?: (choices: readonly NormalizedLinkedChoice<Value>[]) => boolean | string | Promise<string | boolean>;
-    theme?: Partial<Theme<LinkedCheckboxTheme>>;
-}
-type LinkedCheckboxPrompt = <Value>(config: LinkedCheckboxConfig<Value>, context?: Context) => Promise<Value[]>;
-declare const linkedCheckbox: LinkedCheckboxPrompt;
-
-declare const mcpManageCommand: Command;
-
-interface BuildLinkedAgentChoicesOptions {
-    agents: McpAgentType[];
-    checkedAgents: McpAgentType[];
-    detectedAgents?: McpAgentType[];
-    scopeOptions?: McpScopeOptions;
-}
+declare const listInstalledMcpServers: (options?: ListInstalledMcpServersOptions) => ListedMcpServer[];
 /**
- * Builds normalized LinkedChoice items for an interactive agent list,
- * calculating co-hosted agents and attaching link indicators.
+ * High-level query combining server listing and grouping in a single call.
  */
-declare const buildLinkedAgentChoices: (options: BuildLinkedAgentChoicesOptions) => LinkedChoice<McpAgentType>[];
+declare const queryGroupedInstalledServers: (options?: ListInstalledMcpServersOptions) => Map<string, GroupedInstalledServer>;
 
-/**
- * Deep module: Transforms standard McpServerConfig into an Agent-specific configuration shape
- * driven by declarative dialects.
- */
-declare const transformServerConfig: (serverName: string, config: McpServerConfig, dialect: ServerConfigDialect, _context?: {
-    global?: boolean;
-}) => unknown;
 /**
  * Factory creating an agent-bound transform function from a declarative dialect.
  */
@@ -614,4 +303,15 @@ declare const transformServerConfigForAgent: (agent: McpAgentConfig, serverName:
     global: boolean;
 }) => unknown;
 
-export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type BuildLinkedAgentChoicesOptions, type ConfigCluster, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type DisplayServerDetailsOptions, type EditServerConfigOptions, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, type InstallToCompatibleAgentsOptions, type LinkedCheckboxPrompt, type LinkedChoice, type ListedMcpServer, type McpAgentConfig, type McpAgentType, type McpConfigFormat, type McpInstallResultForAgent, type McpRemoteServerConfig, type McpRemoteTransport, type McpScopeOptions, type McpServerConfig, type McpSourceType, type McpStdioServerConfig, type McpTransportType, NPX_COMMAND, NPX_DASH_Y, type ParsedMcpSource, type PromptEditKeyValueOptions, type RemoveMcpServerOptions, type RemoveMcpServerResult, SECRET_HEADER_PATTERN, SECRET_KEY_PATTERN, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, type UpdateMcpServerOptions, type UpdateMcpServerResult, type UpdateTransitionType, type WizardManageOptions, installMcpServer as add, agentConfigStore, buildLinkedAgentChoices, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, detectUpdateTransition, displayServerDetails, extractPackageName, formatArgsString, formatEnvText, formatHeadersText, getCandidateAgentsForScope, getCoHostedAgents, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, installToCompatibleAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, linkedCheckbox, listInstalledMcpServers as list, listInstalledMcpServers, listServersInConfigFile, mainMenu, maskSecretHeader, maskSecretValue, mcpAgentAliases, mcpAgents, mcpManageCommand, normalizeServerConfig, parseArgsString, parseEnvText, parseHeadersText, parseMcpSource, parseServerConfig, parseMcpSource as parseSource, promptArgsConfig, promptEditArgs, promptEditEnvConfig, promptEditHeadersConfig, promptEditKeyValueConfig, promptEnvConfig, promptHeadersConfig, promptScope, promptScopeAndAgents, promptSwitchServerType, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveConfigClusters, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, resolveTransport, sanitizeUpdatedServerConfig, sortAgentsWithClusters, toRemoteServerConfig, toStdioServerConfig, transformServerConfig, transformServerConfigForAgent, updateMcpServer as update, updateMcpServer, wizardAdd, wizardManage, wizardRemove, writeServerToConfigFile };
+declare const SECRET_KEY_PATTERN: RegExp;
+/**
+ * Masks sensitive values for secure CLI display.
+ */
+declare const maskSecretValue: (key: string, value: string) => string;
+declare const SECRET_HEADER_PATTERN: RegExp;
+/**
+ * Masks sensitive HTTP header values for secure CLI display.
+ */
+declare const maskSecretHeader: (key: string, value: string) => string;
+
+export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ApplyServerConfigDeltaResult, type BuildMcpServerConfigOptions, ConfigCluster, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, GroupedInstalledServer, type IncompatibleAgent, InstallMcpServerOptions, InstallMcpServerResult, type InstallToCompatibleAgentsOptions, ListedMcpServer, McpAgentConfig, McpAgentType, McpConfigFormat, type McpConfigTarget, McpInstallResultForAgent, type McpRemoteServerConfig, McpRemoteTransport, McpScopeOptions, McpServerConfig, type McpStdioServerConfig, McpTransportType, ParsedMcpSource, RemoveMcpServerOptions, RemoveMcpServerResult, SECRET_HEADER_PATTERN, SECRET_KEY_PATTERN, type ServerConfigDeltaOptions, ServerConfigDialect, type TargetResolutionQuery, type TargetResolutionResult, UpdateMcpServerOptions, UpdateMcpServerResult, type UpdateTransitionType, agentConfigStore, applyServerConfigDelta, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, detectUpdateTransition, extractPackageName, getCandidateAgentsForScope, getCoHostedAgents, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, installToCompatibleAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, listInstalledMcpServers, maskSecretHeader, maskSecretValue, parseMcpSource, parseServerConfig, queryGroupedInstalledServers, removeMcpServer, resolveConfigClusters, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, sanitizeUpdatedServerConfig, sortAgentsByClusters, toRemoteServerConfig, toStdioServerConfig, transformServerConfigForAgent, updateMcpServer };