ebay-mcp 1.13.2 → 1.14.0

package/build/utils/{llm-client-detector.js → llmClientDetector.js}

@@ -7,10 +7,13 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir, platform } from 'os';
+import { Effect, Either } from 'effect';
+import { getErrorMessage } from './errors.js';
+import { setupLogger } from './logger.js';
 /**
- * Get the config file path for Claude Desktop based on OS
+ * Gets the config file path for Claude Desktop based on OS.
  */
-function getClaudeConfigPath() {
+const getClaudeConfigPath = () => {
     const os = platform();
     const home = homedir();
     switch (os) {
@@ -23,11 +26,11 @@ function getClaudeConfigPath() {
         default:
             return join(home, '.config', 'Claude', 'claude_desktop_config.json');
     }
-}
+};
 /**
- * Get the config file path for Cline (VSCode extension)
+ * Gets the config file path for Cline (VSCode extension).
  */
-function getClineConfigPath() {
+const getClineConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -38,18 +41,18 @@ function getClineConfigPath() {
         default:
             return join(home, '.config', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
     }
-}
+};
 /**
- * Get config path for Continue.dev
+ * Gets the config path for Continue.dev.
  */
-function getContinueConfigPath() {
+const getContinueConfigPath = () => {
     const home = homedir();
     return join(home, '.continue', 'config.json');
-}
+};
 /**
- * Get config path for Zed editor
+ * Gets the config path for Zed editor.
  */
-function getZedConfigPath() {
+const getZedConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -60,11 +63,11 @@ function getZedConfigPath() {
         default:
             return join(home, '.config', 'zed', 'settings.json');
     }
-}
+};
 /**
- * Get config path for Cursor IDE
+ * Gets the config path for Cursor IDE.
  */
-function getCursorConfigPath() {
+const getCursorConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -75,11 +78,11 @@ function getCursorConfigPath() {
         default:
             return join(home, '.cursor', 'mcp.json');
     }
-}
+};
 /**
- * Get config path for Windsurf (Codeium)
+ * Gets the config path for Windsurf (Codeium).
  */
-function getWindsurfConfigPath() {
+const getWindsurfConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -90,11 +93,11 @@ function getWindsurfConfigPath() {
         default:
             return join(home, '.codeium', 'windsurf', 'mcp_config.json');
     }
-}
+};
 /**
- * Get config path for Roo Code (VSCode extension)
+ * Gets the config path for Roo Code (VSCode extension).
  */
-function getRooCodeConfigPath() {
+const getRooCodeConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -105,18 +108,18 @@ function getRooCodeConfigPath() {
         default:
             return join(home, '.config', 'Code', 'User', 'globalStorage', 'rooveterinaryinc.roo-cline', 'settings', 'mcp_settings.json');
     }
-}
+};
 /**
- * Get config path for Claude Code CLI
+ * Gets the config path for Claude Code CLI.
  */
-function getClaudeCodeConfigPath() {
+const getClaudeCodeConfigPath = () => {
     const home = homedir();
     return join(home, '.claude.json');
-}
+};
 /**
- * Get config path for Amazon Q Developer
+ * Gets the config path for Amazon Q Developer.
  */
-function getAmazonQConfigPath() {
+const getAmazonQConfigPath = () => {
     const home = homedir();
     const os = platform();
     switch (os) {
@@ -127,11 +130,17 @@ function getAmazonQConfigPath() {
         default:
             return join(home, '.aws', 'amazonq', 'mcp.json');
     }
-}
+};
 /**
- * Detect all available LLM clients
+ * Detects all supported LLM clients and their configuration file locations.
+ *
+ * @returns LLM clients annotated with config file and installation-directory presence.
+ * @example
+ * ```ts
+ * const clients = detectLLMClients();
+ * ```
  */
-export function detectLLMClients() {
+export const detectLLMClients = () => {
     const clients = [
         {
             name: 'claude',
@@ -205,45 +214,73 @@ export function detectLLMClients() {
         client.detected = existsSync(parentDir);
     }
     return clients;
-}
+};
 /**
- * Read and parse JSON config file safely
+ * Reads and parses a JSON config file safely.
  */
-function readJSONConfig(path) {
-    try {
+const readJSONConfig = (path) => Effect.runSync(Effect.try({
+    try: () => {
         if (!existsSync(path)) {
             return {};
         }
         const content = readFileSync(path, 'utf-8');
         return JSON.parse(content);
-    }
-    catch {
-        return {};
-    }
-}
+    },
+    catch: () => ({}),
+}).pipe(Effect.catchAll((fallbackConfig) => Effect.succeed(fallbackConfig))));
 /**
- * Write JSON config file safely
+ * Writes a JSON config file safely.
  */
-function writeJSONConfig(path, config) {
+const writeJSONConfig = (path, config) => {
     // Ensure directory exists
     const dir = dirname(path);
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
     }
     writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
-}
+};
+const runClientConfigurator = (clientLabel, configure) => {
+    const configured = Effect.runSync(Effect.either(Effect.try({
+        try: configure,
+        catch: (error) => error,
+    })));
+    if (Either.isRight(configured)) {
+        return true;
+    }
+    setupLogger.error(`Failed to configure ${clientLabel}`, {
+        error: getErrorMessage(configured.left),
+    });
+    return false;
+};
+const ensureMcpServersConfig = (config) => {
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+        config.mcpServers = {};
+    }
+    return config.mcpServers;
+};
+const hasMcpServerConfig = (configPath) => {
+    if (!existsSync(configPath)) {
+        return false;
+    }
+    const config = readJSONConfig(configPath);
+    const mcpServers = config.mcpServers;
+    return !!mcpServers?.['ebay-mcp-server'];
+};
 /**
- * Configure Claude Desktop with eBay MCP server
+ * Configures Claude Desktop with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureClaudeDesktop(process.cwd());
+ * ```
  */
-export function configureClaudeDesktop(projectRoot) {
-    try {
+export const configureClaudeDesktop = (projectRoot) => {
+    return runClientConfigurator('Claude Desktop', () => {
         const configPath = getClaudeConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -251,25 +288,23 @@ export function configureClaudeDesktop(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Claude Desktop:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Cline (VSCode extension) with eBay MCP server
+ * Configures Cline (VSCode extension) with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureCline(process.cwd());
+ * ```
  */
-export function configureCline(projectRoot) {
-    try {
+export const configureCline = (projectRoot) => {
+    return runClientConfigurator('Cline', () => {
         const configPath = getClineConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -277,18 +312,20 @@ export function configureCline(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Cline:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Continue.dev with eBay MCP server
+ * Configures Continue.dev with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureContinue(process.cwd());
+ * ```
  */
-export function configureContinue(projectRoot) {
-    try {
+export const configureContinue = (projectRoot) => {
+    return runClientConfigurator('Continue.dev', () => {
         const configPath = getContinueConfigPath();
         const config = readJSONConfig(configPath);
         // Initialize experimental.modelContextProtocolServers if it doesn't exist
@@ -296,8 +333,8 @@ export function configureContinue(projectRoot) {
             config.experimental = {};
         }
         const experimental = config.experimental;
-        if (!experimental.modelContextProtocolServers ||
-            !Array.isArray(experimental.modelContextProtocolServers)) {
+        if (!(experimental.modelContextProtocolServers &&
+            Array.isArray(experimental.modelContextProtocolServers))) {
             experimental.modelContextProtocolServers = [];
         }
         const mcpServers = experimental.modelContextProtocolServers;
@@ -316,19 +353,22 @@ export function configureContinue(projectRoot) {
         experimental.modelContextProtocolServers = mcpServers;
         config.experimental = experimental;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Continue.dev:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Zed editor with eBay MCP server
+ * Configures Zed editor with the eBay MCP server command.
+ *
  * Zed uses context_servers in settings.json
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureZed(process.cwd());
+ * ```
  */
-export function configureZed(projectRoot) {
-    try {
+export const configureZed = (projectRoot) => {
+    return runClientConfigurator('Zed', () => {
         const configPath = getZedConfigPath();
         const config = readJSONConfig(configPath);
         // Initialize context_servers if it doesn't exist
@@ -346,26 +386,25 @@ export function configureZed(projectRoot) {
         };
         config.context_servers = contextServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Zed:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Cursor IDE with eBay MCP server
+ * Configures Cursor IDE with the eBay MCP server command.
+ *
  * Cursor uses mcpServers in mcp.json
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureCursor(process.cwd());
+ * ```
  */
-export function configureCursor(projectRoot) {
-    try {
+export const configureCursor = (projectRoot) => {
+    return runClientConfigurator('Cursor', () => {
         const configPath = getCursorConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -373,25 +412,23 @@ export function configureCursor(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Cursor:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Windsurf (Codeium) with eBay MCP server
+ * Configures Windsurf (Codeium) with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureWindsurf(process.cwd());
+ * ```
  */
-export function configureWindsurf(projectRoot) {
-    try {
+export const configureWindsurf = (projectRoot) => {
+    return runClientConfigurator('Windsurf', () => {
         const configPath = getWindsurfConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -399,25 +436,23 @@ export function configureWindsurf(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Windsurf:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Roo Code (VSCode extension) with eBay MCP server
+ * Configures Roo Code (VSCode extension) with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureRooCode(process.cwd());
+ * ```
  */
-export function configureRooCode(projectRoot) {
-    try {
+export const configureRooCode = (projectRoot) => {
+    return runClientConfigurator('Roo Code', () => {
         const configPath = getRooCodeConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -425,26 +460,25 @@ export function configureRooCode(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Roo Code:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Claude Code CLI with eBay MCP server
+ * Configures Claude Code CLI with the eBay MCP server command.
+ *
  * Claude Code CLI uses mcpServers in ~/.claude.json
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureClaudeCode(process.cwd());
+ * ```
  */
-export function configureClaudeCode(projectRoot) {
-    try {
+export const configureClaudeCode = (projectRoot) => {
+    return runClientConfigurator('Claude Code CLI', () => {
         const configPath = getClaudeCodeConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -452,25 +486,23 @@ export function configureClaudeCode(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Claude Code CLI:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure Amazon Q Developer with eBay MCP server
+ * Configures Amazon Q Developer with the eBay MCP server command.
+ *
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the client config file was updated.
+ * @example
+ * ```ts
+ * const configured = configureAmazonQ(process.cwd());
+ * ```
  */
-export function configureAmazonQ(projectRoot) {
-    try {
+export const configureAmazonQ = (projectRoot) => {
+    return runClientConfigurator('Amazon Q', () => {
         const configPath = getAmazonQConfigPath();
         const config = readJSONConfig(configPath);
-        // Initialize mcpServers if it doesn't exist
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
+        const mcpServers = ensureMcpServersConfig(config);
         // Add or update eBay MCP server configuration
         mcpServers['ebay-mcp-server'] = {
             command: 'node',
@@ -478,17 +510,20 @@ export function configureAmazonQ(projectRoot) {
         };
         config.mcpServers = mcpServers;
         writeJSONConfig(configPath, config);
-        return true;
-    }
-    catch (error) {
-        console.error('Failed to configure Amazon Q:', error);
-        return false;
-    }
-}
+    });
+};
 /**
- * Configure specified LLM client
+ * Configures a supported LLM client with the eBay MCP server command.
+ *
+ * @param clientName Stable client key such as `claude`, `cursor`, or `amazonq`.
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns `true` when the named client configuration was updated.
+ * @example
+ * ```ts
+ * const configured = configureLLMClient('cursor', process.cwd());
+ * ```
  */
-export function configureLLMClient(clientName, projectRoot) {
+export const configureLLMClient = (clientName, projectRoot) => {
     switch (clientName) {
         case 'claude':
             return configureClaudeDesktop(projectRoot);
@@ -511,11 +546,19 @@ export function configureLLMClient(clientName, projectRoot) {
         default:
             return false;
     }
-}
+};
 /**
- * Get human-readable instructions for manual configuration
+ * Gets human-readable instructions for manual client configuration.
+ *
+ * @param clientName Stable client key such as `claude`, `cursor`, or `amazonq`.
+ * @param projectRoot Absolute project root containing `build/index.js`.
+ * @returns A formatted setup snippet for the requested client.
+ * @example
+ * ```ts
+ * const instructions = getManualConfigInstructions('claude', process.cwd());
+ * ```
  */
-export function getManualConfigInstructions(clientName, projectRoot) {
+export const getManualConfigInstructions = (clientName, projectRoot) => {
     const buildPath = join(projectRoot, 'build', 'index.js');
     switch (clientName) {
         case 'claude':
@@ -634,114 +677,92 @@ Add this to ${getAmazonQConfigPath()}:
         default:
             return 'Manual configuration instructions not available for this client.';
     }
-}
+};
 /**
- * Verify client configuration is correct
+ * Verifies that a client has an eBay MCP server entry.
+ *
+ * @param clientName Stable client key such as `claude`, `cursor`, or `amazonq`.
+ * @param _projectRoot Reserved project root parameter kept for signature parity with configuration helpers.
+ * @returns `true` when the expected eBay MCP server entry is present.
+ * @example
+ * ```ts
+ * const ready = verifyClientConfiguration('cursor', process.cwd());
+ * ```
  */
-export function verifyClientConfiguration(clientName, _projectRoot) {
-    try {
-        switch (clientName) {
-            case 'claude': {
-                const configPath = getClaudeConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'cline': {
-                const configPath = getClineConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'continue': {
-                const configPath = getContinueConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const experimental = config.experimental;
-                const mcpServers = experimental?.modelContextProtocolServers;
-                return !!mcpServers?.some((server) => server.args?.[0]?.includes('ebay-mcp-server'));
-            }
-            case 'zed': {
-                const configPath = getZedConfigPath();
-                if (!existsSync(configPath))
+export const verifyClientConfiguration = (clientName, _projectRoot) => {
+    const verified = Effect.runSync(Effect.either(Effect.try({
+        try: () => {
+            switch (clientName) {
+                case 'claude':
+                    return hasMcpServerConfig(getClaudeConfigPath());
+                case 'cline':
+                    return hasMcpServerConfig(getClineConfigPath());
+                case 'continue': {
+                    const configPath = getContinueConfigPath();
+                    if (!existsSync(configPath))
+                        return false;
+                    const config = readJSONConfig(configPath);
+                    const experimental = config.experimental;
+                    const mcpServers = experimental?.modelContextProtocolServers;
+                    return !!mcpServers?.some((server) => server.args?.[0]?.includes('ebay-mcp-server'));
+                }
+                case 'zed': {
+                    const configPath = getZedConfigPath();
+                    if (!existsSync(configPath))
+                        return false;
+                    const config = readJSONConfig(configPath);
+                    const contextServers = config.context_servers;
+                    return !!contextServers?.['ebay-mcp-server'];
+                }
+                case 'cursor':
+                    return hasMcpServerConfig(getCursorConfigPath());
+                case 'windsurf':
+                    return hasMcpServerConfig(getWindsurfConfigPath());
+                case 'roocode':
+                    return hasMcpServerConfig(getRooCodeConfigPath());
+                case 'claudecode':
+                    return hasMcpServerConfig(getClaudeCodeConfigPath());
+                case 'amazonq':
+                    return hasMcpServerConfig(getAmazonQConfigPath());
+                default:
                     return false;
-                const config = readJSONConfig(configPath);
-                const contextServers = config.context_servers;
-                return !!contextServers?.['ebay-mcp-server'];
             }
-            case 'cursor': {
-                const configPath = getCursorConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'windsurf': {
-                const configPath = getWindsurfConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'roocode': {
-                const configPath = getRooCodeConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'claudecode': {
-                const configPath = getClaudeCodeConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            case 'amazonq': {
-                const configPath = getAmazonQConfigPath();
-                if (!existsSync(configPath))
-                    return false;
-                const config = readJSONConfig(configPath);
-                const mcpServers = config.mcpServers;
-                return !!mcpServers?.['ebay-mcp-server'];
-            }
-            default:
-                return false;
-        }
-    }
-    catch {
-        return false;
-    }
-}
+        },
+        catch: () => false,
+    })));
+    return Either.isRight(verified) ? verified.right : false;
+};
 /**
- * Get all LLM clients (detected and undetected)
+ * Gets all supported LLM client keys.
+ *
+ * @returns Stable client keys accepted by setup and configuration helpers.
+ * @example
+ * ```ts
+ * const clientNames = getAllSupportedClients();
+ * ```
  */
-export function getAllSupportedClients() {
-    return [
-        'claude',
-        'cline',
-        'continue',
-        'zed',
-        'cursor',
-        'windsurf',
-        'roocode',
-        'claudecode',
-        'amazonq',
-    ];
-}
+export const getAllSupportedClients = () => [
+    'claude',
+    'cline',
+    'continue',
+    'zed',
+    'cursor',
+    'windsurf',
+    'roocode',
+    'claudecode',
+    'amazonq',
+];
 /**
- * Check if client supports MCP protocol
+ * Checks if a client key supports native MCP configuration.
+ *
+ * @param clientName Stable client key to test.
+ * @returns `true` when this setup utility can configure the named client.
+ * @example
+ * ```ts
+ * const supported = supportsNativeMCP('claude');
+ * ```
  */
-export function supportsNativeMCP(clientName) {
+export const supportsNativeMCP = (clientName) => {
     // All these clients support MCP (Model Context Protocol)
     const supportedClients = [
         'claude',
@@ -755,4 +776,4 @@ export function supportsNativeMCP(clientName) {
         'amazonq',
     ];
     return supportedClients.includes(clientName.toLowerCase());
-}
+};