@wuyax/mcps 0.1.0-beta.2 → 0.1.0

package/dist/index.d.cts

@@ -1,104 +1,6 @@
-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.cjs';
+export { k as McpSourceType, l as ServerConfigDialectName, m as ServerConfigDialectOptions } from './types-lEP3zGvf.cjs';
 
-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;
-    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;
-    error?: 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;
@@ -108,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;
@@ -134,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;
@@ -184,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;
@@ -199,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[];
@@ -242,201 +242,53 @@ interface TargetResolutionResult {
  */
 declare const resolveTargetAgents: (query?: TargetResolutionQuery) => TargetResolutionResult;
 
-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 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 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 WizardManageOptions extends McpScopeOptions {
-    serverName?: string;
-}
-/**
- * Reusable display function for server details with secret masking.
- */
-declare const displayServerDetails: ({ serverName, config, agents, isGlobal, titlePrefix, }: {
-    serverName: string;
-    config: McpServerConfig;
-    agents?: McpAgentType[];
-    isGlobal?: boolean;
-    titlePrefix?: string;
-}) => void;
-declare const wizardManage: (options?: WizardManageOptions) => Promise<void>;
-
-interface WizardRemoveOptions extends McpScopeOptions {
-    name?: string;
-    agents?: McpAgentType[];
-}
-declare const wizardRemove: (options?: WizardRemoveOptions) => Promise<boolean>;
+declare const installMcpServer: (options: InstallMcpServerOptions) => InstallMcpServerResult;
 
-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: "=" | ":";
+type InstallMcpServerForAgentOptions = McpScopeOptions;
+interface InstallToCompatibleAgentsOptions extends McpScopeOptions {
+    allAgents: McpAgentType[];
+    incompatible?: Array<{
+        agent: McpAgentType;
+        reason: string;
+    }>;
 }
 /**
- * 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>>;
-
-/**
- * Masks sensitive values for secure CLI display.
- */
-declare const maskSecretValue: (key: string, value: 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>>;
-
-/**
- * Masks sensitive HTTP header values for secure CLI display.
- */
-declare const maskSecretHeader: (key: string, value: string) => string;
-/**
- * Formats a key-value headers record into multiline Key: Value text.
+ * Backward-compatible wrapper: installs a server config for a single agent
+ * via the deepened AgentConfigStore.
  */
-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>;
+declare const installMcpServerForAgent: (serverName: string, serverConfig: McpServerConfig, agentType: McpAgentType, options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent;
 /**
- * Interactively prompts user for HTTP headers.
+ * Backward-compatible wrapper: installs a server config to multiple agents
+ * via the deepened AgentConfigStore.
  */
-declare const promptHeadersConfig: (initialHeaders?: Record<string, string>) => Promise<Record<string, string>>;
+declare const installMcpServerForAgents: (serverName: string, serverConfig: McpServerConfig, agentTypes: McpAgentType[], options?: InstallMcpServerForAgentOptions) => McpInstallResultForAgent[];
 /**
- * Dedicated prompt loop for inspecting, modifying, adding, and removing
- * HTTP headers of an existing MCP server configuration.
+ * Backward-compatible wrapper: filters out incompatible agents and installs
+ * to the remaining compatible ones via the deepened AgentConfigStore.
  */
-declare const promptEditHeadersConfig: (currentHeaders?: Record<string, string>) => Promise<Record<string, string>>;
+declare const installToCompatibleAgents: (serverName: string, serverConfig: McpServerConfig, options: InstallToCompatibleAgentsOptions) => McpInstallResultForAgent[];
 
 /**
- * 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.
+ * Core Orchestration: Updates an existing MCP server across specified or installed coding agents,
+ * sanitizing protocol dirty fields and validating transport capabilities.
  */
-declare const formatArgsString: (args: string[]) => string;
-/**
- * Dedicated prompt for editing command arguments with current arguments pre-filled.
- */
-declare const promptEditArgs: (currentArgs?: string[]) => Promise<string[]>;
+declare const updateMcpServer: (options: UpdateMcpServerOptions) => UpdateMcpServerResult;
 
-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.
- */
-declare const promptScopeAndAgents: (options?: PromptScopeAndAgentsOptions) => Promise<ScopeAndAgentsResult>;
+declare const removeMcpServer: (options: RemoveMcpServerOptions) => RemoveMcpServerResult[];
 
-interface PromptScopeOptions extends McpScopeOptions {
-    defaultGlobal?: boolean;
-    message?: string;
+interface ListInstalledMcpServersOptions extends McpScopeOptions {
+    agents?: McpAgentType[];
 }
 /**
- * Prompts user to choose between project and global scope.
- * Returns true for global, false for project.
+ * Deep module query: Lists installed MCP servers across agents.
+ * Adapter read caching is encapsulated by AgentConfigStore.
  */
-declare const promptScope: (options?: PromptScopeOptions) => Promise<boolean>;
-
-declare const mcpManageCommand: Command;
-
-interface GroupedInstalledServer {
-    serverName: string;
-    agents: McpAgentType[];
-    paths: string[];
-    config: McpServerConfig;
-}
-declare const normalizeServerConfig: (raw: unknown) => McpServerConfig;
+declare const listInstalledMcpServers: (options?: ListInstalledMcpServersOptions) => ListedMcpServer[];
 /**
- * Groups a flat array of ListedMcpServer entries by serverName.
+ * High-level query combining server listing and grouping in a single call.
  */
-declare const groupInstalledServersByName: (installed: ListedMcpServer[]) => Map<string, GroupedInstalledServer>;
+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.
  */
@@ -451,4 +303,15 @@ declare const transformServerConfigForAgent: (agent: McpAgentConfig, serverName:
     global: boolean;
 }) => unknown;
 
-export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, 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, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, type WizardManageOptions, installMcpServer as add, agentConfigStore, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, displayServerDetails, extractPackageName, formatArgsString, formatEnvText, formatHeadersText, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, 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, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, transformServerConfig, transformServerConfigForAgent, installMcpServerForAgent as updateMcpServerForAgent, installMcpServerForAgents as updateMcpServerForAgents, 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 };