@hypnosis/docker-mcp-server 1.0.4 → 1.2.1

package/dist/utils/profiles-file.js

@@ -0,0 +1,167 @@
+/**
+ * Profiles File Loader
+ * Load SSH profiles from JSON configuration file
+ */
+import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
+import { logger } from './logger.js';
+/**
+ * Load profiles from JSON file
+ *
+ * @param filePath - Path to profiles JSON file
+ * @returns Profiles configuration and errors
+ */
+export function loadProfilesFile(filePath) {
+    const errors = [];
+    try {
+        // Resolve path (support ~ for home directory)
+        const resolvedPath = resolveFilePath(filePath);
+        // Check if file exists
+        if (!existsSync(resolvedPath)) {
+            errors.push(`Profiles file not found: ${resolvedPath}`);
+            return { config: null, errors };
+        }
+        // Read and parse JSON
+        const fileContent = readFileSync(resolvedPath, 'utf-8');
+        const parsed = JSON.parse(fileContent);
+        // Validate structure
+        if (typeof parsed !== 'object' || parsed === null) {
+            errors.push('Profiles file must contain a JSON object');
+            return { config: null, errors };
+        }
+        if (!parsed.profiles || typeof parsed.profiles !== 'object') {
+            errors.push('Profiles file must have a "profiles" object');
+            return { config: null, errors };
+        }
+        // Validate each profile
+        const profiles = {};
+        for (const [name, data] of Object.entries(parsed.profiles)) {
+            if (typeof data !== 'object' || data === null) {
+                errors.push(`Profile "${name}" must be an object`);
+                continue;
+            }
+            const profile = data;
+            // Check if this is a local mode profile
+            if (profile.mode === 'local') {
+                // For local mode, only mode is required
+                const profileData = {
+                    mode: 'local',
+                };
+                // projectsPath is optional even for local
+                if (profile.projectsPath && typeof profile.projectsPath === 'string') {
+                    profileData.projectsPath = profile.projectsPath.trim();
+                }
+                profiles[name] = profileData;
+                logger.debug(`Profile "${name}" configured for LOCAL mode`);
+                continue;
+            }
+            // For remote mode (mode === 'remote' or mode not specified), validate required fields
+            if (!profile.host || typeof profile.host !== 'string') {
+                errors.push(`Profile "${name}" must have a "host" string (or set mode: "local" for local Docker)`);
+                continue;
+            }
+            if (!profile.username || typeof profile.username !== 'string') {
+                errors.push(`Profile "${name}" must have a "username" string (or set mode: "local" for local Docker)`);
+                continue;
+            }
+            // Build remote profile
+            const profileData = {
+                mode: profile.mode === 'remote' ? 'remote' : undefined, // Explicitly set if specified
+                host: profile.host.trim(),
+                username: profile.username.trim(),
+            };
+            // Optional fields
+            if (profile.port !== undefined) {
+                const port = typeof profile.port === 'number' ? profile.port : parseInt(String(profile.port), 10);
+                if (isNaN(port) || port < 1 || port > 65535) {
+                    errors.push(`Profile "${name}" has invalid port: ${profile.port}`);
+                    continue;
+                }
+                profileData.port = port;
+            }
+            if (profile.privateKeyPath && typeof profile.privateKeyPath === 'string') {
+                profileData.privateKeyPath = profile.privateKeyPath.trim();
+            }
+            if (profile.passphrase && typeof profile.passphrase === 'string') {
+                profileData.passphrase = profile.passphrase;
+            }
+            if (profile.password && typeof profile.password === 'string') {
+                profileData.password = profile.password;
+            }
+            if (profile.projectsPath && typeof profile.projectsPath === 'string') {
+                profileData.projectsPath = profile.projectsPath.trim();
+            }
+            profiles[name] = profileData;
+        }
+        if (Object.keys(profiles).length === 0) {
+            errors.push('No valid profiles found in file');
+            return { config: null, errors };
+        }
+        // Build config
+        const config = {
+            profiles,
+        };
+        // Set default profile if specified
+        if (parsed.default && typeof parsed.default === 'string') {
+            if (profiles[parsed.default]) {
+                config.default = parsed.default;
+            }
+            else {
+                errors.push(`Default profile "${parsed.default}" not found in profiles`);
+            }
+        }
+        if (errors.length > 0) {
+            return { config: null, errors };
+        }
+        logger.info(`Loaded ${Object.keys(profiles).length} profiles from ${resolvedPath}`);
+        if (config.default) {
+            logger.info(`Default profile: ${config.default}`);
+        }
+        return { config, errors: [] };
+    }
+    catch (error) {
+        if (error.name === 'SyntaxError') {
+            errors.push(`Invalid JSON in profiles file: ${error.message}`);
+        }
+        else {
+            errors.push(`Failed to load profiles file: ${error.message}`);
+        }
+        return { config: null, errors };
+    }
+}
+/**
+ * Convert profile data to SSHConfig
+ * @throws Error with code 'LOCAL_MODE' if profile is configured for local Docker
+ */
+export function profileDataToSSHConfig(data) {
+    // Check if this is a local mode profile
+    if (data.mode === 'local') {
+        const error = new Error('Profile is configured for LOCAL mode');
+        error.code = 'LOCAL_MODE';
+        throw error;
+    }
+    // For remote profiles, host and username are required
+    if (!data.host || !data.username) {
+        throw new Error('Profile must have host and username for remote mode');
+    }
+    return {
+        host: data.host,
+        username: data.username,
+        port: data.port || 22,
+        privateKeyPath: data.privateKeyPath,
+        passphrase: data.passphrase,
+        password: data.password,
+        projectsPath: data.projectsPath,
+    };
+}
+/**
+ * Resolve file path with ~ expansion
+ */
+function resolveFilePath(filePath) {
+    if (filePath.startsWith('~')) {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        return filePath.replace('~', home);
+    }
+    return resolve(filePath);
+}
+//# sourceMappingURL=profiles-file.js.map

package/dist/utils/profiles-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles-file.js","sourceRoot":"","sources":["../../src/utils/profiles-file.ts"],"names":[],"mappings":"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"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Retry & Timeout Utility
+ * Утилита для повторных попыток с экспоненциальным backoff и timeout
+ */
+/**
+ * Опции для retry функции
+ */
+export interface RetryOptions {
+    /** Максимальное количество попыток (по умолчанию 3) */
+    maxAttempts?: number;
+    /** Таймаут на операцию в миллисекундах (по умолчанию 30000 = 30 секунд) */
+    timeout?: number;
+    /** Начальная задержка перед повторной попыткой в миллисекундах (по умолчанию 1000 = 1 секунда) */
+    initialDelay?: number;
+    /** Множитель для экспоненциального backoff (по умолчанию 2) */
+    backoffMultiplier?: number;
+    /** Функция для проверки, стоит ли повторять попытку для данной ошибки */
+    shouldRetry?: (error: any) => boolean;
+}
+/**
+ * Ошибка таймаута
+ */
+export declare class TimeoutError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Ошибка исчерпания попыток
+ */
+export declare class RetryExhaustedError extends Error {
+    readonly attempts: number;
+    readonly lastError: any;
+    constructor(attempts: number, lastError: any);
+}
+/**
+ * Выполнить функцию с повторными попытками и таймаутом
+ *
+ * @param fn - Асинхронная функция для выполнения
+ * @param options - Опции retry
+ * @returns Результат выполнения функции
+ * @throws TimeoutError - если операция превысила timeout
+ * @throws RetryExhaustedError - если исчерпаны все попытки
+ */
+export declare function retryWithTimeout<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Создать функцию shouldRetry для сетевых ошибок
+ * Повторяет попытку для сетевых ошибок и таймаутов, но не для ошибок валидации
+ */
+export declare function createNetworkRetryPredicate(): (error: any) => boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,GAAE,MAA8B;CAIpD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,GAAG,CAAC;gBAEnB,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG;CAM7C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA+DZ;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CA6BrE"}

package/dist/utils/retry.js

@@ -0,0 +1,120 @@
+/**
+ * Retry & Timeout Utility
+ * Утилита для повторных попыток с экспоненциальным backoff и timeout
+ */
+import { logger } from './logger.js';
+/**
+ * Ошибка таймаута
+ */
+export class TimeoutError extends Error {
+    constructor(message = 'Operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Ошибка исчерпания попыток
+ */
+export class RetryExhaustedError extends Error {
+    attempts;
+    lastError;
+    constructor(attempts, lastError) {
+        super(`Operation failed after ${attempts} attempts: ${lastError.message}`);
+        this.name = 'RetryExhaustedError';
+        this.attempts = attempts;
+        this.lastError = lastError;
+    }
+}
+/**
+ * Выполнить функцию с повторными попытками и таймаутом
+ *
+ * @param fn - Асинхронная функция для выполнения
+ * @param options - Опции retry
+ * @returns Результат выполнения функции
+ * @throws TimeoutError - если операция превысила timeout
+ * @throws RetryExhaustedError - если исчерпаны все попытки
+ */
+export async function retryWithTimeout(fn, options = {}) {
+    const { maxAttempts = 3, timeout = 30000, initialDelay = 1000, backoffMultiplier = 2, shouldRetry = () => true, // По умолчанию повторяем для любых ошибок
+     } = options;
+    let lastError;
+    let delay = initialDelay;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            // Создаем Promise с таймаутом
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new TimeoutError(`Operation timed out after ${timeout}ms`));
+                }, timeout);
+            });
+            // Выполняем функцию с таймаутом
+            const result = await Promise.race([fn(), timeoutPromise]);
+            // Если успешно выполнено с первой попытки - не логируем
+            if (attempt > 1) {
+                logger.info(`Operation succeeded on attempt ${attempt}/${maxAttempts}`);
+            }
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            // Если это TimeoutError - не повторяем
+            if (error instanceof TimeoutError) {
+                logger.error(`Operation timed out on attempt ${attempt}/${maxAttempts}`);
+                throw error;
+            }
+            // Проверяем, стоит ли повторять попытку
+            if (!shouldRetry(error)) {
+                logger.error(`Operation failed on attempt ${attempt}/${maxAttempts}, not retrying: ${error.message}`);
+                throw error;
+            }
+            // Если это последняя попытка - выбрасываем ошибку
+            if (attempt >= maxAttempts) {
+                logger.error(`Operation failed after ${maxAttempts} attempts: ${error.message}`);
+                throw new RetryExhaustedError(maxAttempts, lastError);
+            }
+            // Логируем попытку и ждем перед следующей
+            logger.warn(`Operation failed on attempt ${attempt}/${maxAttempts}: ${error.message}. Retrying in ${delay}ms...`);
+            await sleep(delay);
+            // Увеличиваем задержку для следующей попытки (экспоненциальный backoff)
+            delay *= backoffMultiplier;
+        }
+    }
+    // Этот код не должен выполняться, но на всякий случай
+    throw new RetryExhaustedError(maxAttempts, lastError);
+}
+/**
+ * Создать функцию shouldRetry для сетевых ошибок
+ * Повторяет попытку для сетевых ошибок и таймаутов, но не для ошибок валидации
+ */
+export function createNetworkRetryPredicate() {
+    return (error) => {
+        // Повторяем для сетевых ошибок
+        if (error.code === 'ECONNREFUSED' ||
+            error.code === 'ETIMEDOUT' ||
+            error.code === 'ENOTFOUND' ||
+            error.code === 'EAI_AGAIN' ||
+            error.code === 'ECONNRESET') {
+            return true;
+        }
+        // Повторяем для ошибок с сообщениями о таймауте
+        if (error.message && (error.message.includes('timeout') ||
+            error.message.includes('timed out') ||
+            error.message.includes('connection') ||
+            error.message.includes('network'))) {
+            return true;
+        }
+        // Не повторяем для ошибок валидации или авторизации
+        if (error.statusCode === 400 || error.statusCode === 401 || error.statusCode === 403) {
+            return false;
+        }
+        // По умолчанию повторяем
+        return true;
+    };
+}
+/**
+ * Утилита для задержки
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"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"}

package/dist/utils/ssh-config.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SSH Configuration Module
+ * SSH configuration management for remote Docker
+ */
+/**
+ * SSH configuration for connecting to remote Docker server
+ */
+export interface SSHConfig {
+    /** Server address (IP or domain name) */
+    host: string;
+    /** SSH port (default: 22) */
+    port?: number;
+    /** Username for SSH connection */
+    username: string;
+    /** Path to private SSH key */
+    privateKeyPath?: string;
+    /** Passphrase for encrypted SSH key */
+    passphrase?: string;
+    /** Password for authentication (not recommended for production) */
+    password?: string;
+    /** Base path for Docker projects on remote server (e.g., "/var/www") */
+    projectsPath?: string;
+}
+/**
+ * SSH profile with name and configuration
+ * Allows working with multiple servers
+ */
+export interface SSHProfile {
+    /** Profile name (e.g., 'production', 'staging') */
+    name: string;
+    /** SSH configuration */
+    config: SSHConfig;
+}
+/**
+ * SSH configuration loading result
+ */
+export interface SSHConfigResult {
+    /** SSH configuration or null if not found */
+    config: SSHConfig | null;
+    /** Validation errors (if any) */
+    errors: string[];
+}
+/**
+ * SSH profiles loading result
+ */
+export interface SSHProfilesResult {
+    /** Profiles or empty object if not found */
+    profiles: Record<string, SSHConfig>;
+    /** Validation errors (if any) */
+    errors: string[];
+}
+/**
+ * Валидация SSH конфигурации
+ * @param config - SSH конфигурация для проверки
+ * @returns Массив ошибок (пустой, если валидация прошла успешно)
+ */
+export declare function validateSSHConfig(config: Partial<SSHConfig>): string[];
+/**
+ * Load SSH configuration from environment variables or profiles file
+ *
+ * Priority order:
+ * 1. DOCKER_MCP_PROFILES_FILE - Load from JSON file
+ * 2. DOCKER_SSH_PROFILE + DOCKER_SSH_PROFILES - Load from env JSON
+ * 3. DOCKER_SSH_HOST + DOCKER_SSH_USER - Simple single server config
+ *
+ * @param env - Environment variables object (defaults to process.env)
+ * @param profileName - Optional profile name to load (overrides DOCKER_SSH_PROFILE)
+ * @returns SSH configuration result with config and errors
+ */
+export declare function loadSSHConfig(env?: Record<string, string | undefined>, profileName?: string): SSHConfigResult;
+/**
+ * Загрузить SSH профили из environment variables
+ *
+ * Формат DOCKER_SSH_PROFILES: JSON объект
+ * {
+ *   "profile1": {
+ *     "host": "server1.com",
+ *     "username": "user1",
+ *     "port": 22,
+ *     "privateKeyPath": "/path/to/key1"
+ *   },
+ *   "profile2": {
+ *     "host": "server2.com",
+ *     "username": "user2"
+ *   }
+ * }
+ *
+ * @param env - Объект с environment variables (по умолчанию process.env)
+ * @returns Результат загрузки с профилями и ошибками
+ */
+export declare function loadSSHProfiles(env?: Record<string, string | undefined>): SSHProfilesResult;
+/**
+ * Get active SSH profile name
+ * @param env - Environment variables object
+ * @returns Active profile name or null
+ */
+export declare function getActiveSSHProfile(env?: Record<string, string | undefined>): string | null;
+/**
+ * Проверить существование SSH ключа по пути
+ * @param keyPath - Путь к SSH ключу
+ * @returns true, если ключ существует
+ */
+export declare function checkSSHKeyExists(keyPath: string): boolean;
+//# sourceMappingURL=ssh-config.d.ts.map

package/dist/utils/ssh-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-config.d.ts","sourceRoot":"","sources":["../../src/utils/ssh-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,CAuCtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,CAgHjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,iBAAiB,CA0FxG;AA6ED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,GAAG,IAAI,CAExG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW1D"}