@loop_ouroboros/mcp-hub-lite 1.0.0

package/dist/server/src/cli/commands/status.js

@@ -0,0 +1,164 @@
+import { Command } from 'commander';
+import { getServerStatus } from '../server.js';
+import os from 'os';
+/**
+ * CLI command for retrieving the current status of the MCP Hub Lite server.
+ *
+ * This command provides comprehensive information about the running MCP Hub Lite instance,
+ * including process details, configuration status, and managed MCP servers. It is designed
+ * to help users monitor their MCP gateway service and troubleshoot any operational issues.
+ *
+ * The status command performs the following functions:
+ * - Checks if the MCP Hub Lite process is currently running
+ * - Retrieves the process ID (PID) from the PID file
+ * - Displays the configured host and port settings
+ * - Shows the current MCP integration endpoint configuration
+ * - Lists all managed MCP servers and their connection status
+ * - Provides detailed operational status information
+ *
+ * Usage scenarios:
+ * - Verifying that the MCP Hub Lite service is running correctly
+ * - Debugging connection issues with managed MCP servers
+ * - Monitoring system health and resource usage
+ * - Validating configuration after changes or updates
+ * - Checking the status before performing maintenance operations
+ *
+ * The command supports an optional --pid parameter to check a specific process ID,
+ * which is useful when multiple instances might be running or when the PID file
+ * is unavailable or corrupted.
+ *
+ * @example
+ * // Basic usage - check default instance
+ * mcp-hub-lite status
+ *
+ * @example
+ * // Check specific process ID
+ * mcp-hub-lite status --pid 12345
+ *
+ * @returns {Command} The configured status command instance for registration with Commander.js
+ */
+export const statusCommand = new Command('status')
+    .description('Get the status of MCP Hub Lite server')
+    .option('--pid <pid>', 'PID of the server to check')
+    .action(async (options) => {
+    try {
+        const status = await getServerStatus(options.pid);
+        printFormattedStatus(status);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Failed to get server status:', error);
+        process.exit(1);
+    }
+});
+/**
+ * Prints formatted status output with emojis and sections.
+ *
+ * @param status - The enhanced server status object to display
+ */
+function printFormattedStatus(status) {
+    // ANSI color codes
+    const reset = '\x1b[0m';
+    const green = '\x1b[32m';
+    const red = '\x1b[31m';
+    const yellow = '\x1b[33m';
+    const cyan = '\x1b[36m';
+    const dim = '\x1b[2m';
+    const webUiUrl = `http://${status.host}:${status.port}`;
+    const mcpEndpoint = `${webUiUrl}/mcp`;
+    // Main header
+    console.log('');
+    console.log(`${cyan}📊 MCP Hub Lite - System Status${reset}`);
+    console.log(`${dim}════════════════════════════════════${reset}`);
+    // Status section
+    const statusIcon = status.running ? `${green}✅${reset}` : `${red}❌${reset}`;
+    const statusText = status.running ? 'Running' : 'Stopped';
+    console.log(`${statusIcon} Status: ${status.running ? green : red}${statusText}${reset}`);
+    if (status.pid) {
+        console.log(`🆔 Process ID: ${cyan}${status.pid}${reset}`);
+    }
+    console.log(`🌐 Host: ${cyan}${status.host}${reset}`);
+    console.log(`🔌 Port: ${cyan}${status.port}${reset}`);
+    console.log(`📡 Web UI: ${cyan}${webUiUrl}${reset}`);
+    console.log(`🔗 MCP Endpoint: ${cyan}${mcpEndpoint}${reset}`);
+    console.log(`📄 PID File: ${dim}${formatPath(status.pidFilePath)}${reset}`);
+    // MCP Servers section
+    if (status.mcpServers && status.mcpServers.length > 0) {
+        console.log('');
+        console.log(`${yellow}MCP Servers:${reset}`);
+        console.log(`${dim}═════════════${reset}`);
+        // Calculate column widths
+        let maxNameLen = 'Server Name'.length;
+        let maxTypeLen = 'Type'.length;
+        const maxStatusLen = 'Disconnected'.length;
+        for (const server of status.mcpServers) {
+            maxNameLen = Math.max(maxNameLen, (server.name || '').length);
+            maxTypeLen = Math.max(maxTypeLen, (server.type || '').length);
+        }
+        // Simple table without complex borders
+        const headerName = 'Server Name'.padEnd(maxNameLen);
+        const headerType = 'Type'.padEnd(maxTypeLen);
+        const headerStatus = 'Status'.padEnd(maxStatusLen);
+        console.log(`${cyan}${headerName}  ${headerType}  ${headerStatus}  Tools  Resources${reset}`);
+        console.log(`${dim}${'─'.repeat(maxNameLen + maxTypeLen + maxStatusLen + 20)}${reset}`);
+        for (const server of status.mcpServers) {
+            const name = (server.name || '').padEnd(maxNameLen);
+            const type = (server.type || '').padEnd(maxTypeLen);
+            const statusText = server.connected
+                ? `${green}Connected${reset}`.padEnd(maxStatusLen + 9)
+                : `${red}Disconnected${reset}`.padEnd(maxStatusLen + 9);
+            const tools = server.toolsCount.toString().padStart(5);
+            const resources = server.resourcesCount.toString().padStart(9);
+            console.log(`${name}  ${type}  ${statusText}  ${tools}  ${resources}`);
+            if (server.error) {
+                console.log(`  ${red}Error: ${server.error}${reset}`);
+            }
+        }
+    }
+    // MCP Client Configuration
+    console.log('');
+    console.log(`${yellow}🔌 MCP Client Configuration:${reset}`);
+    console.log(`${dim}═══════════════════════════════${reset}`);
+    console.log('Add this to your MCP client config:');
+    console.log('');
+    console.log(`${dim}{${reset}`);
+    console.log(`${dim}  "mcpServers": {${reset}`);
+    console.log(`${dim}    "mcp-hub-lite": {${reset}`);
+    console.log(`${dim}      "url": "${cyan}${mcpEndpoint}${dim}"${reset}`);
+    console.log(`${dim}    }${reset}`);
+    console.log(`${dim}  }${reset}`);
+    console.log(`${dim}}${reset}`);
+    // Quick Commands
+    console.log('');
+    console.log(`${yellow}💡 Quick Commands:${reset}`);
+    console.log(`   ${cyan}mcp-hub-lite ui${reset}     ${dim}# Open web interface${reset}`);
+    console.log(`   ${cyan}mcp-hub-lite list${reset}   ${dim}# List all MCP servers${reset}`);
+    if (status.running) {
+        console.log(`   ${cyan}mcp-hub-lite stop${reset}   ${dim}# Stop the server${reset}`);
+    }
+    else {
+        console.log(`   ${cyan}mcp-hub-lite start${reset}  ${dim}# Start the server${reset}`);
+    }
+    console.log('');
+    // Final message
+    if (status.running) {
+        console.log(`${green}🚀 Ready to use!${reset}`);
+    }
+    else {
+        console.log(`${yellow}⏸️ Server not running. Use "mcp-hub-lite start" to start it.${reset}`);
+    }
+    console.log('');
+}
+/**
+ * Formats a file path for display, replacing home directory with ~.
+ *
+ * @param filePath - The full file path to format
+ * @returns Formatted path with ~ for home directory
+ */
+function formatPath(filePath) {
+    const homeDir = os.homedir();
+    if (filePath.startsWith(homeDir)) {
+        return '~' + filePath.slice(homeDir.length);
+    }
+    return filePath;
+}

package/dist/server/src/cli/commands/stop.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Stop command implementation for MCP Hub Lite CLI.
+ *
+ * This command handles the graceful shutdown of the MCP Hub Lite server.
+ * It can stop either the currently running server instance or a specific
+ * server process identified by PID.
+ *
+ * @module cli/commands/stop
+ */
+import { Command } from 'commander';
+/**
+ * Creates and configures the stop command for the CLI.
+ *
+ * The stop command gracefully terminates the MCP Hub Lite server process,
+ * ensuring proper cleanup of resources, active connections, and persistent
+ * session data. It reads the PID from the PID file or accepts a specific
+ * PID as an option.
+ *
+ * Available options:
+ * - `--pid`: Specify a specific PID to stop (optional)
+ *
+ * @returns {Command} Configured Commander.js command instance
+ *
+ * @example
+ * ```bash
+ * # Stop the currently running server
+ * mcp-hub-lite stop
+ *
+ * # Stop a specific server process by PID
+ * mcp-hub-lite stop --pid 12345
+ * ```
+ */
+export declare const stopCommand: Command;
+//# sourceMappingURL=stop.d.ts.map

package/dist/server/src/cli/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,SAYpB,CAAC"}

package/dist/server/src/cli/commands/stop.js

@@ -0,0 +1,47 @@
+/**
+ * Stop command implementation for MCP Hub Lite CLI.
+ *
+ * This command handles the graceful shutdown of the MCP Hub Lite server.
+ * It can stop either the currently running server instance or a specific
+ * server process identified by PID.
+ *
+ * @module cli/commands/stop
+ */
+import { Command } from 'commander';
+import { stopServer } from '../server.js';
+/**
+ * Creates and configures the stop command for the CLI.
+ *
+ * The stop command gracefully terminates the MCP Hub Lite server process,
+ * ensuring proper cleanup of resources, active connections, and persistent
+ * session data. It reads the PID from the PID file or accepts a specific
+ * PID as an option.
+ *
+ * Available options:
+ * - `--pid`: Specify a specific PID to stop (optional)
+ *
+ * @returns {Command} Configured Commander.js command instance
+ *
+ * @example
+ * ```bash
+ * # Stop the currently running server
+ * mcp-hub-lite stop
+ *
+ * # Stop a specific server process by PID
+ * mcp-hub-lite stop --pid 12345
+ * ```
+ */
+export const stopCommand = new Command('stop')
+    .description('Stop the MCP Hub Lite server')
+    .option('--pid <pid>', 'PID of the server to stop')
+    .action(async (options) => {
+    try {
+        await stopServer(options.pid);
+        console.log('MCP Hub Lite server stopped successfully');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Failed to stop server:', error);
+        process.exit(1);
+    }
+});

package/dist/server/src/cli/commands/ui.d.ts

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+/**
+ * CLI command to open the MCP Hub Lite web user interface in the default system browser.
+ *
+ * This command provides a convenient way for users to access the web-based management
+ * interface without manually typing the URL. It automatically constructs the URL using
+ * the specified host and port options, then opens it in the user's default browser.
+ *
+ * The command is designed to work with both local development instances and production
+ * deployments, allowing users to easily access the UI regardless of the server configuration.
+ *
+ * Priority order for host and port resolution:
+ * 1. Command line options (--host, --port)
+ * 2. Environment variables (HOST, PORT)
+ * 3. Configuration file settings
+ * 4. Default values (localhost:7788)
+ *
+ * @example
+ * ```bash
+ * # Open UI with configured settings from .mcp-hub.json
+ * mcp-hub-lite ui
+ *
+ * # Open UI on a specific port
+ * mcp-hub-lite ui --port 7788
+ *
+ * # Open UI on a specific host and port
+ * mcp-hub-lite ui --host 192.168.1.100 --port 8080
+ *
+ * # Using short option flags
+ * mcp-hub-lite ui -p 7788 -h my-server.local
+ *
+ * # Using environment variables
+ * PORT=9999 mcp-hub-lite ui
+ * ```
+ *
+ * @command ui
+ * @description Opens the MCP Hub Lite web UI in the default system browser
+ * @option {string} -p, --port <port> - Port where the MCP Hub Lite server is running
+ * @option {string} -h, --host <host> - Host where the MCP Hub Lite server is running
+ * @throws {Error} If the browser fails to open or the system encounters an error during execution
+ * @returns {Promise<void>} Resolves when the browser has been successfully opened
+ */
+export declare const uiCommand: Command;
+//# sourceMappingURL=ui.d.ts.map

package/dist/server/src/cli/commands/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,SAAS,SAmDlB,CAAC"}

package/dist/server/src/cli/commands/ui.js

@@ -0,0 +1,95 @@
+import { Command } from 'commander';
+import { exec } from 'child_process';
+import { getConfigManager } from '../../config/config-manager.js';
+/**
+ * CLI command to open the MCP Hub Lite web user interface in the default system browser.
+ *
+ * This command provides a convenient way for users to access the web-based management
+ * interface without manually typing the URL. It automatically constructs the URL using
+ * the specified host and port options, then opens it in the user's default browser.
+ *
+ * The command is designed to work with both local development instances and production
+ * deployments, allowing users to easily access the UI regardless of the server configuration.
+ *
+ * Priority order for host and port resolution:
+ * 1. Command line options (--host, --port)
+ * 2. Environment variables (HOST, PORT)
+ * 3. Configuration file settings
+ * 4. Default values (localhost:7788)
+ *
+ * @example
+ * ```bash
+ * # Open UI with configured settings from .mcp-hub.json
+ * mcp-hub-lite ui
+ *
+ * # Open UI on a specific port
+ * mcp-hub-lite ui --port 7788
+ *
+ * # Open UI on a specific host and port
+ * mcp-hub-lite ui --host 192.168.1.100 --port 8080
+ *
+ * # Using short option flags
+ * mcp-hub-lite ui -p 7788 -h my-server.local
+ *
+ * # Using environment variables
+ * PORT=9999 mcp-hub-lite ui
+ * ```
+ *
+ * @command ui
+ * @description Opens the MCP Hub Lite web UI in the default system browser
+ * @option {string} -p, --port <port> - Port where the MCP Hub Lite server is running
+ * @option {string} -h, --host <host> - Host where the MCP Hub Lite server is running
+ * @throws {Error} If the browser fails to open or the system encounters an error during execution
+ * @returns {Promise<void>} Resolves when the browser has been successfully opened
+ */
+export const uiCommand = new Command('ui')
+    .description('Open the MCP Hub Lite web UI in browser')
+    .option('-p, --port <port>', 'Port where server is running')
+    .option('-h, --host <host>', 'Host where server is running')
+    .action(async (options) => {
+    try {
+        const configManager = getConfigManager();
+        const config = configManager.getConfig();
+        // Priority: command line options > environment variables > config file > defaults
+        const host = options.host || process.env.HOST || config.system.host || 'localhost';
+        const port = options.port || process.env.PORT || String(config.system.port) || '7788';
+        const url = `http://${host}:${port}`;
+        console.log(`Opening MCP Hub Lite UI at ${url}`);
+        // Open URL in browser based on platform
+        const platform = process.platform;
+        let openCommand = '';
+        if (platform === 'win32') {
+            // Windows
+            openCommand = `start ${url}`;
+        }
+        else if (platform === 'darwin') {
+            // macOS
+            openCommand = `open ${url}`;
+        }
+        else if (platform === 'linux') {
+            // Linux
+            openCommand = `xdg-open ${url}`;
+        }
+        else {
+            console.error('Unsupported platform for opening browser');
+            process.exit(1);
+        }
+        exec(openCommand, (error) => {
+            if (error) {
+                console.error('Failed to open browser:', error.message);
+                process.exit(1);
+            }
+            else {
+                process.exit(0);
+            }
+        });
+        // Set a timeout to exit in case exec callback doesn't fire
+        setTimeout(() => {
+            process.exit(0);
+        }, 2000);
+    }
+    catch (error) {
+        console.error('Failed to open UI:', error);
+        process.exit(1);
+    }
+});

package/dist/server/src/cli/index.d.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * MCP Hub Lite CLI Entry Point
+ * Implements 6 core commands: start, stop, status, ui, list, restart
+ */
+import { Command } from 'commander';
+/**
+ * Creates and configures the CLI application using Commander.js
+ *
+ * This function initializes the main CLI program with its name, description, and version,
+ * then registers all available commands to provide a complete command-line interface
+ * for managing the MCP Hub Lite service.
+ *
+ * The CLI provides six core commands:
+ * - start: Launches the MCP Hub Lite service in daemon or foreground mode
+ * - stop: Gracefully terminates the running service instance
+ * - status: Displays current service status including PID, port, host, and server count
+ * - ui: Opens the web-based user interface in the default browser
+ * - list: Shows all configured MCP servers in a tabular format
+ * - restart: Stops and restarts the service with the same configuration
+ *
+ * Usage examples:
+ * ```bash
+ * # Start service in daemon mode
+ * mcp-hub-lite start
+ *
+ * # Start service in foreground mode on custom port
+ * mcp-hub-lite start --port 8080 --foreground
+ *
+ * # Stop the running service
+ * mcp-hub-lite stop
+ *
+ * # Check service status
+ * mcp-hub-lite status
+ *
+ * # Open web UI
+ * mcp-hub-lite ui
+ *
+ * # List all configured servers
+ * mcp-hub-lite list
+ *
+ * # Restart the service
+ * mcp-hub-lite restart
+ * ```
+ *
+ * @returns {Command} The configured CLI program instance ready for parsing
+ *
+ * @example
+ * ```typescript
+ * const cli = createCli();
+ * cli.parse(); // Parse command line arguments and execute
+ * ```
+ *
+ * @see {@link startCommand} - Implementation of the start command
+ * @see {@link stopCommand} - Implementation of the stop command
+ * @see {@link statusCommand} - Implementation of the status command
+ * @see {@link uiCommand} - Implementation of the ui command
+ * @see {@link listCommand} - Implementation of the list command
+ * @see {@link restartCommand} - Implementation of the restart command
+ */
+export declare function createCli(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/src/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAiBnC"}

package/dist/server/src/cli/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * MCP Hub Lite CLI Entry Point
+ * Implements 6 core commands: start, stop, status, ui, list, restart
+ */
+import { Command } from 'commander';
+import { argv } from 'node:process';
+import { pathToFileURL } from 'node:url';
+import { startCommand } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { statusCommand } from './commands/status.js';
+import { uiCommand } from './commands/ui.js';
+import { listCommand } from './commands/list.js';
+import { restartCommand } from './commands/restart.js';
+/**
+ * Creates and configures the CLI application using Commander.js
+ *
+ * This function initializes the main CLI program with its name, description, and version,
+ * then registers all available commands to provide a complete command-line interface
+ * for managing the MCP Hub Lite service.
+ *
+ * The CLI provides six core commands:
+ * - start: Launches the MCP Hub Lite service in daemon or foreground mode
+ * - stop: Gracefully terminates the running service instance
+ * - status: Displays current service status including PID, port, host, and server count
+ * - ui: Opens the web-based user interface in the default browser
+ * - list: Shows all configured MCP servers in a tabular format
+ * - restart: Stops and restarts the service with the same configuration
+ *
+ * Usage examples:
+ * ```bash
+ * # Start service in daemon mode
+ * mcp-hub-lite start
+ *
+ * # Start service in foreground mode on custom port
+ * mcp-hub-lite start --port 8080 --foreground
+ *
+ * # Stop the running service
+ * mcp-hub-lite stop
+ *
+ * # Check service status
+ * mcp-hub-lite status
+ *
+ * # Open web UI
+ * mcp-hub-lite ui
+ *
+ * # List all configured servers
+ * mcp-hub-lite list
+ *
+ * # Restart the service
+ * mcp-hub-lite restart
+ * ```
+ *
+ * @returns {Command} The configured CLI program instance ready for parsing
+ *
+ * @example
+ * ```typescript
+ * const cli = createCli();
+ * cli.parse(); // Parse command line arguments and execute
+ * ```
+ *
+ * @see {@link startCommand} - Implementation of the start command
+ * @see {@link stopCommand} - Implementation of the stop command
+ * @see {@link statusCommand} - Implementation of the status command
+ * @see {@link uiCommand} - Implementation of the ui command
+ * @see {@link listCommand} - Implementation of the list command
+ * @see {@link restartCommand} - Implementation of the restart command
+ */
+export function createCli() {
+    const program = new Command();
+    program
+        .name('mcp-hub-lite')
+        .description('Lightweight MCP Gateway for managing MCP servers')
+        .version('1.0.0');
+    // Register all core commands
+    program.addCommand(startCommand);
+    program.addCommand(stopCommand);
+    program.addCommand(statusCommand);
+    program.addCommand(uiCommand);
+    program.addCommand(listCommand);
+    program.addCommand(restartCommand);
+    return program;
+}
+// Execute the CLI if this file is run directly
+if (argv[1] && pathToFileURL(argv[1]).href === import.meta.url) {
+    const cli = createCli();
+    cli.parse();
+}

package/dist/server/src/cli/parse-args.d.ts

@@ -0,0 +1,108 @@
+/**
+ * CLI argument parsing utility
+ * Provides parameter validation and parsing functions
+ */
+import type { LogLevel } from '../../shared/types/common.types.js';
+export interface CliOptions {
+    port?: number;
+    host?: string;
+    config?: string;
+    foreground?: boolean;
+    stdio?: boolean;
+}
+/**
+ * Parses and validates a port number from a string input.
+ *
+ * This function converts a string representation of a port number to an integer
+ * and validates that it falls within the valid TCP/UDP port range (1-65535).
+ * It is primarily used for CLI argument parsing when users specify custom ports
+ * via command line options like `--port` or `-p`.
+ *
+ * @param value - The string representation of the port number to parse
+ * @returns The validated port number as an integer
+ * @throws {Error} If the input is not a valid number or outside the valid port range (1-65535)
+ *
+ * @example
+ * ```typescript
+ * const port = parsePort("8080"); // Returns 8080
+ * const invalidPort = parsePort("99999"); // Throws Error: Invalid port: 99999. Must be between 1 and 65535.
+ * ```
+ */
+export declare function parsePort(value: string): number;
+/**
+ * Parses and validates a hostname or IP address from a string input.
+ *
+ * This function performs basic validation on hostname/IP address inputs by ensuring
+ * the value is not empty or whitespace-only. It trims any leading/trailing whitespace
+ * from the input and returns the cleaned hostname. This function is used when parsing
+ * CLI arguments for host configuration via options like `--host` or `-h`.
+ *
+ * Note: This function performs only basic validation (non-empty check). More complex
+ * hostname format validation (e.g., DNS compliance, IP address format) should be
+ * handled at the network layer or by the underlying server implementation.
+ *
+ * @param value - The hostname or IP address string to parse and validate
+ * @returns The trimmed hostname/IP address string
+ * @throws {Error} If the input is null, undefined, or contains only whitespace
+ *
+ * @example
+ * ```typescript
+ * const host = parseHost("localhost"); // Returns "localhost"
+ * const hostWithSpaces = parseHost("  127.0.0.1  "); // Returns "127.0.0.1"
+ * const emptyHost = parseHost(""); // Throws Error: Host cannot be empty
+ * ```
+ */
+export declare function parseHost(value: string): string;
+/**
+ * Validates a configuration file path to ensure it points to a valid JSON file.
+ *
+ * This function checks that the provided file path ends with the `.json` extension,
+ * ensuring that only JSON configuration files are accepted. It is used during CLI
+ * argument parsing when users specify custom configuration files via the `--config`
+ * option. The function does not verify file existence or accessibility, as those
+ * checks should be performed by the file system operations that actually read the file.
+ *
+ * @param path - The file path to validate as a configuration file path
+ * @returns The original path string if validation passes
+ * @throws {Error} If the path does not end with the '.json' extension
+ *
+ * @example
+ * ```typescript
+ * const validPath = validateConfigPath("./config.json"); // Returns "./config.json"
+ * const invalidPath = validateConfigPath("./config.txt"); // Throws Error: Config file must be a .json file
+ * ```
+ */
+export declare function validateConfigPath(path: string): string;
+/**
+ * Validate log level
+ */
+export declare function validateLogLevel(level: string): LogLevel;
+/**
+ * Merges CLI options with default values to create a complete configuration object.
+ *
+ * This function takes partial CLI options (which may contain only some of the available
+ * options) and merges them with a complete set of default values. It uses nullish coalescing
+ * (??) to ensure that only undefined or null values are replaced with defaults, preserving
+ * explicitly set falsy values like `false` for boolean options.
+ *
+ * The function handles all standard CLI options including:
+ * - port: TCP port number for the server
+ * - host: Hostname or IP address to bind to
+ * - config: Path to configuration file
+ * - foreground: Whether to run in foreground mode
+ * - stdio: Whether to use stdio transport mode
+ *
+ * @param options - Partial CLI options object containing user-specified values
+ * @param defaults - Complete CLI options object containing default values
+ * @returns {CliOptions} A complete CLI options object with merged values
+ *
+ * @example
+ * ```typescript
+ * const userOptions = { port: 8080 };
+ * const defaultOptions = { port: 7788, host: 'localhost', config: '.mcp-hub.json', foreground: false, stdio: false };
+ * const merged = mergeOptions(userOptions, defaultOptions);
+ * // Result: { port: 8080, host: 'localhost', config: '.mcp-hub.json', foreground: false, stdio: false }
+ * ```
+ */
+export declare function mergeOptions(options: Partial<CliOptions>, defaults: CliOptions): CliOptions;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/server/src/cli/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../../../src/cli/parse-args.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAOxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAQ3F"}