synapse-mcp 1.0.0 → 1.0.2

package/dist/services/host-resolver.js

@@ -0,0 +1,176 @@
+/**
+ * Timeout for host resolution operations.
+ * Defaults to 30s, overridable via COMPOSE_HOST_RESOLUTION_TIMEOUT_MS.
+ */
+function getResolutionTimeoutMs() {
+    const raw = process.env.COMPOSE_HOST_RESOLUTION_TIMEOUT_MS;
+    if (!raw)
+        return 30000;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return 30000;
+    return parsed;
+}
+/**
+ * Grace period (ms) after first match to collect concurrent matches
+ * for conflict detection. Defaults to 500ms unless overridden.
+ */
+function getConflictGraceMs() {
+    const raw = process.env.COMPOSE_CONFLICT_GRACE_MS;
+    if (!raw)
+        return 500;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return 500;
+    return parsed;
+}
+/**
+ * Error thrown when host resolution fails
+ */
+export class HostResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HostResolutionError";
+    }
+}
+/**
+ * Resolves which host contains a compose project when not explicitly specified
+ */
+export class HostResolver {
+    discovery;
+    hosts;
+    constructor(discovery, hosts) {
+        this.discovery = discovery;
+        this.hosts = hosts;
+    }
+    /**
+     * Resolve which host to use for a compose operation
+     *
+     * @param projectName - Name of the compose project
+     * @param specifiedHost - Optional host name explicitly provided by user
+     * @returns The resolved host configuration
+     * @throws {HostResolutionError} If resolution fails
+     */
+    async resolveHost(projectName, specifiedHost) {
+        // If host is specified, validate and return it
+        if (specifiedHost) {
+            const host = this.hosts.find((h) => h.name === specifiedHost);
+            if (!host) {
+                throw new HostResolutionError(`Host "${specifiedHost}" not found in configuration`);
+            }
+            return host;
+        }
+        // Auto-resolve: check all hosts in parallel
+        if (this.hosts.length === 0) {
+            throw new HostResolutionError("No hosts configured");
+        }
+        const matchingHosts = await this.findMatchingHosts(projectName);
+        if (matchingHosts.length === 0) {
+            throw new HostResolutionError(`Project "${projectName}" not found on any configured host`);
+        }
+        if (matchingHosts.length > 1) {
+            const hostNames = matchingHosts.map((h) => h.name).join(", ");
+            throw new HostResolutionError(`Project "${projectName}" found on multiple hosts: ${hostNames}. Please specify which host to use.`);
+        }
+        return matchingHosts[0];
+    }
+    /**
+     * Find all hosts that contain the specified project.
+     *
+     * Uses an AbortController to cancel remaining checks on early exit or timeout.
+     * SECURITY (CWE-404): Timer is properly cleared when resolution settles
+     * to prevent dangling promise rejection and memory leak.
+     */
+    async findMatchingHosts(projectName) {
+        const resolutionTimeoutMs = getResolutionTimeoutMs();
+        const abortController = new AbortController();
+        let timeoutId;
+        const checkPromise = this.checkAllHosts(projectName, abortController.signal);
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                abortController.abort();
+                reject(new HostResolutionError(`Host resolution timed out after ${resolutionTimeoutMs}ms`));
+            }, resolutionTimeoutMs);
+        });
+        try {
+            const result = await Promise.race([checkPromise, timeoutPromise]);
+            return result;
+        }
+        finally {
+            abortController.abort();
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    /**
+     * Check all hosts in parallel for the project with early-exit.
+     *
+     * When the first match arrives, starts a short grace period to collect
+     * any near-simultaneous matches (for conflict detection). After the
+     * grace period or when all checks settle (whichever is first), resolves
+     * with all collected matches.
+     *
+     * If all checks fail before any match, resolves immediately with
+     * an empty array.
+     *
+     * This avoids blocking on slow/offline hosts while still detecting
+     * conflicts between responsive hosts.
+     */
+    checkAllHosts(projectName, signal) {
+        const matchingHosts = [];
+        let settledCount = 0;
+        const totalChecks = this.hosts.length;
+        const conflictGraceMs = getConflictGraceMs();
+        return new Promise((resolve) => {
+            if (totalChecks === 0) {
+                resolve([]);
+                return;
+            }
+            let resolved = false;
+            let graceTimeoutId;
+            const doResolve = () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                if (graceTimeoutId) {
+                    clearTimeout(graceTimeoutId);
+                }
+                resolve(matchingHosts);
+            };
+            const startGracePeriod = () => {
+                if (graceTimeoutId)
+                    return; // Already started
+                graceTimeoutId = setTimeout(doResolve, conflictGraceMs);
+            };
+            const tryResolve = () => {
+                if (resolved || signal.aborted)
+                    return;
+                settledCount++;
+                // All checks settled — no more results possible
+                if (settledCount === totalChecks) {
+                    doResolve();
+                    return;
+                }
+                // First match arrived — start grace period for conflict detection
+                if (matchingHosts.length >= 1 && !graceTimeoutId) {
+                    startGracePeriod();
+                }
+            };
+            for (const host of this.hosts) {
+                this.discovery
+                    .resolveProjectPath(host, projectName)
+                    .then(() => {
+                    if (!resolved && !signal.aborted) {
+                        matchingHosts.push(host);
+                    }
+                    tryResolve();
+                })
+                    .catch(() => {
+                    tryResolve();
+                });
+            }
+        });
+    }
+}
+//# sourceMappingURL=host-resolver.js.map

package/dist/services/host-resolver.js.map

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

package/dist/services/interfaces.d.ts

@@ -1,197 +1,9 @@
-import type { HostConfig, ContainerInfo, ContainerStats, HostStatus, LogEntry, ImageInfo } from "../types.js";
-import type Docker from "dockerode";
 import type { NodeSSH } from "node-ssh";
+import type { ComposeProject, HostConfig } from "../types.js";
+import type { DockerOperations } from "./docker-interfaces.js";
 import type { HostResources } from "./ssh.js";
-import type { DockerSystemInfo, DockerDiskUsage, PruneResult, ListImagesOptions } from "./docker.js";
 import type { PoolStats } from "./ssh-pool.js";
-import type { ComposeProject } from "./compose.js";
-/**
- * Docker service interface for managing Docker containers, images, and resources.
- * Provides operations for container lifecycle management, image operations, system queries,
- * and Docker daemon interactions across multiple hosts.
- */
-export interface IDockerService {
-    /**
-     * Get a Docker client instance for the specified host configuration.
-     * Clients are cached per host to reuse connections.
-     *
-     * @param config - Host configuration containing connection details
-     * @returns Docker client instance (dockerode)
-     */
-    getDockerClient(config: HostConfig): Docker;
-    /**
-     * List containers across multiple hosts with optional filtering.
-     *
-     * @param hosts - Array of host configurations to query
-     * @param options - Filtering options
-     * @param options.state - Filter by container state (all, running, stopped, paused)
-     * @param options.nameFilter - Filter by container name (partial match)
-     * @param options.imageFilter - Filter by image name (partial match)
-     * @param options.labelFilter - Filter by label (format: "key=value")
-     * @returns Array of containers with their details and host information
-     */
-    listContainers(hosts: HostConfig[], options?: {
-        state?: "all" | "running" | "stopped" | "paused";
-        nameFilter?: string;
-        imageFilter?: string;
-        labelFilter?: string;
-    }): Promise<ContainerInfo[]>;
-    /**
-     * Perform a lifecycle action on a container.
-     *
-     * @param containerId - Container ID or name
-     * @param action - Action to perform (start, stop, restart, pause, unpause)
-     * @param host - Host configuration where container is located
-     */
-    containerAction(containerId: string, action: "start" | "stop" | "restart" | "pause" | "unpause", host: HostConfig): Promise<void>;
-    /**
-     * Retrieve logs from a container.
-     *
-     * @param containerId - Container ID or name
-     * @param host - Host configuration where container is located
-     * @param options - Log retrieval options
-     * @param options.lines - Number of lines to retrieve (default: 100)
-     * @param options.since - Show logs since timestamp or duration (e.g., "2023-01-01T00:00:00Z" or "10m")
-     * @param options.until - Show logs until timestamp or duration
-     * @param options.stream - Stream to retrieve (all, stdout, stderr)
-     * @returns Array of log entries with timestamps and content
-     */
-    getContainerLogs(containerId: string, host: HostConfig, options?: {
-        lines?: number;
-        since?: string;
-        until?: string;
-        stream?: "all" | "stdout" | "stderr";
-    }): Promise<LogEntry[]>;
-    /**
-     * Get resource usage statistics for a container.
-     *
-     * @param containerId - Container ID or name
-     * @param host - Host configuration where container is located
-     * @returns Resource statistics including CPU, memory, network, and I/O
-     */
-    getContainerStats(containerId: string, host: HostConfig): Promise<ContainerStats>;
-    /**
-     * Find which host a container is running on.
-     * Searches across all provided hosts.
-     *
-     * @param containerId - Container ID or name to find
-     * @param hosts - Array of host configurations to search
-     * @returns Host config and container info if found, null otherwise
-     */
-    findContainerHost(containerId: string, hosts: HostConfig[]): Promise<{
-        host: HostConfig;
-        container: Docker.ContainerInfo;
-    } | null>;
-    /**
-     * Get Docker daemon status and version info for multiple hosts.
-     *
-     * @param hosts - Array of host configurations to check
-     * @returns Array of host statuses with daemon info and reachability
-     */
-    getHostStatus(hosts: HostConfig[]): Promise<HostStatus[]>;
-    /**
-     * List Docker images across multiple hosts with optional filtering.
-     *
-     * @param hosts - Array of host configurations to query
-     * @param options - Filtering options (dangling, reference, etc.)
-     * @returns Array of images with their details and host information
-     */
-    listImages(hosts: HostConfig[], options?: ListImagesOptions): Promise<ImageInfo[]>;
-    /**
-     * Get detailed information about a container.
-     *
-     * @param containerId - Container ID or name
-     * @param host - Host configuration where container is located
-     * @returns Full container inspection data from Docker API
-     */
-    inspectContainer(containerId: string, host: HostConfig): Promise<Docker.ContainerInspectInfo>;
-    /**
-     * Get Docker daemon system information.
-     *
-     * @param host - Host configuration to query
-     * @returns System info including version, OS, architecture, and resource limits
-     */
-    getDockerInfo(host: HostConfig): Promise<DockerSystemInfo>;
-    /**
-     * Get Docker disk usage information.
-     *
-     * @param host - Host configuration to query
-     * @returns Disk usage breakdown for images, containers, volumes, and build cache
-     */
-    getDockerDiskUsage(host: HostConfig): Promise<DockerDiskUsage>;
-    /**
-     * Remove unused Docker resources (prune operation).
-     *
-     * @param host - Host configuration where pruning should occur
-     * @param target - Resource type to prune (containers, images, volumes, networks, buildcache, all)
-     * @returns Array of prune results showing what was removed and space reclaimed
-     */
-    pruneDocker(host: HostConfig, target: "containers" | "images" | "volumes" | "networks" | "buildcache" | "all"): Promise<PruneResult[]>;
-    /**
-     * Pull a Docker image from a registry.
-     *
-     * @param imageName - Image name with optional tag (e.g., "nginx:latest")
-     * @param host - Host configuration where image should be pulled
-     * @returns Operation status
-     */
-    pullImage(imageName: string, host: HostConfig): Promise<{
-        status: string;
-    }>;
-    /**
-     * Recreate a container with the same configuration.
-     * Optionally pulls the latest image before recreating.
-     *
-     * @param containerId - Container ID or name to recreate
-     * @param host - Host configuration where container is located
-     * @param options - Recreate options
-     * @param options.pull - Whether to pull latest image before recreating
-     * @returns Operation status and new container ID
-     */
-    recreateContainer(containerId: string, host: HostConfig, options?: {
-        pull?: boolean;
-    }): Promise<{
-        status: string;
-        containerId: string;
-    }>;
-    /**
-     * Remove a Docker image.
-     *
-     * @param imageId - Image ID or name to remove
-     * @param host - Host configuration where image is located
-     * @param options - Removal options
-     * @param options.force - Force removal even if image is in use
-     * @returns Operation status
-     */
-    removeImage(imageId: string, host: HostConfig, options?: {
-        force?: boolean;
-    }): Promise<{
-        status: string;
-    }>;
-    /**
-     * Build a Docker image from a Dockerfile.
-     *
-     * @param host - Host configuration where build should occur
-     * @param options - Build options
-     * @param options.context - Path to build context directory
-     * @param options.tag - Tag for the built image
-     * @param options.dockerfile - Path to Dockerfile (relative to context, default: "Dockerfile")
-     * @param options.noCache - Disable build cache
-     * @returns Operation status
-     */
-    buildImage(host: HostConfig, options: {
-        context: string;
-        tag: string;
-        dockerfile?: string;
-        noCache?: boolean;
-    }): Promise<{
-        status: string;
-    }>;
-    /**
-     * Clear all cached Docker client connections.
-     * Useful for cleanup during shutdown or when connections need to be reset.
-     */
-    clearClients(): void;
-}
+export type { DockerOperations, IContainerOperations, IDockerClientProvider, IDockerSystemInfo, IImageOperations, IResourceOperations, } from "./docker-interfaces.js";
 /**
  * SSH service interface for executing commands on remote hosts.
  * Provides secure command execution and resource monitoring via SSH connections.
@@ -225,6 +37,13 @@ export interface ISSHService {
  * Provides operations for Compose project lifecycle management, service control,
  * and log retrieval.
  */
+/**
+ * Interface for resolving compose project file paths.
+ * Extracted to break the circular dependency between ComposeService and ComposeDiscovery.
+ */
+export interface IComposePathResolver {
+    resolveProjectPath(host: HostConfig, projectName: string): Promise<string>;
+}
 export interface IComposeService {
     /**
      * Execute a Docker Compose command on a remote host.
@@ -392,6 +211,39 @@ export interface ISSHConnectionPool {
      * @returns Statistics including active connections, pool size, and usage metrics
      */
     getStats(): PoolStats;
+    /**
+     * Get pool health status.
+     * Returns whether the pool is healthy based on connection states and health check results.
+     *
+     * @returns Health status object with healthy flag
+     */
+    getHealth(): {
+        healthy: boolean;
+    };
+}
+/**
+ * Local command executor interface for executing commands on localhost.
+ * Provides secure command execution using Node.js child_process for local operations
+ * without SSH overhead.
+ */
+export interface ILocalExecutorService {
+    /**
+     * Execute a command locally using Node.js execFile.
+     * Uses execFile (not shell) to prevent command injection.
+     *
+     * @param command - Command to execute (path or binary name)
+     * @param args - Array of command arguments
+     * @param options - Execution options
+     * @param options.timeoutMs - Command timeout in milliseconds (default: 30000)
+     * @param options.cwd - Working directory for command execution
+     * @returns Command output as string (stdout, trimmed)
+     * @throws Error if command fails (non-zero exit code), times out, or binary not found
+     * @note stderr output is included in error messages but does not cause failure by itself
+     */
+    executeLocalCommand(command: string, args?: string[], options?: {
+        timeoutMs?: number;
+        cwd?: string;
+    }): Promise<string>;
 }
 /**
  * Service factory interface for creating service instances with dependency injection.
@@ -404,7 +256,7 @@ export interface IServiceFactory {
      *
      * @returns Docker service instance
      */
-    createDockerService(): IDockerService;
+    createDockerService(): DockerOperations;
     /**
      * Create an SSH connection pool instance.
      *
@@ -423,14 +275,22 @@ export interface IServiceFactory {
      * @returns SSH service instance
      */
     createSSHService(pool: ISSHConnectionPool): ISSHService;
+    /**
+     * Create a local executor service instance.
+     * Local executor runs commands on localhost without SSH.
+     *
+     * @returns Local executor service instance
+     */
+    createLocalExecutor(): ILocalExecutorService;
     /**
      * Create a Docker Compose service instance.
-     * Compose service requires SSH service for executing remote commands.
+     * Compose service requires SSH service for remote commands and local executor for local commands.
      *
      * @param sshService - SSH service to use for remote command execution
+     * @param localExecutor - Local executor service for local command execution
      * @returns Compose service instance
      */
-    createComposeService(sshService: ISSHService): IComposeService;
+    createComposeService(sshService: ISSHService, localExecutor: ILocalExecutorService): IComposeService;
     /**
      * Create a File service instance.
      * File service requires SSH service for remote file operations.
@@ -534,4 +394,11 @@ export interface IFileService {
      */
     diffFiles(host1: HostConfig, path1: string, host2: HostConfig, path2: string, contextLines: number): Promise<string>;
 }
+/**
+ * Minimal interface for listing compose projects
+ * Used by ComposeDiscovery to avoid circular dependency with ComposeService
+ */
+export interface IComposeProjectLister {
+    listComposeProjects(host: HostConfig): Promise<ComposeProject[]>;
+}
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/services/interfaces.d.ts.map

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

package/dist/services/local-executor.d.ts

@@ -0,0 +1,31 @@
+import type { ILocalExecutorService } from "./interfaces.js";
+/**
+ * Options for local command execution
+ */
+export interface LocalCommandOptions {
+    timeoutMs?: number;
+    cwd?: string;
+}
+/**
+ * LocalExecutorService implementation for executing commands on localhost.
+ * Uses Node.js execFile for secure command execution without shell interpretation.
+ *
+ * SECURITY: Uses execFile (not exec) to prevent shell injection attacks.
+ * Command and arguments are passed separately, preventing metacharacter interpretation.
+ */
+export declare class LocalExecutorService implements ILocalExecutorService {
+    /**
+     * Execute a command locally using Node.js execFile
+     *
+     * SECURITY: Uses execFile which does NOT invoke a shell, preventing command injection.
+     * Arguments are passed as array elements, not concatenated strings.
+     *
+     * @param command - Command to execute (binary name or path)
+     * @param args - Command arguments (each element is a separate argument)
+     * @param options - Execution options (timeout, cwd)
+     * @returns Command stdout (trimmed)
+     * @throws Error if command fails, times out, or binary not found
+     */
+    executeLocalCommand(command: string, args?: string[], options?: LocalCommandOptions): Promise<string>;
+}
+//# sourceMappingURL=local-executor.d.ts.map

package/dist/services/local-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.d.ts","sourceRoot":"","sources":["../../src/services/local-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE;;;;;;;;;;;OAWG;IACG,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC;CAgEnB"}

package/dist/services/local-executor.js

@@ -0,0 +1,71 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * LocalExecutorService implementation for executing commands on localhost.
+ * Uses Node.js execFile for secure command execution without shell interpretation.
+ *
+ * SECURITY: Uses execFile (not exec) to prevent shell injection attacks.
+ * Command and arguments are passed separately, preventing metacharacter interpretation.
+ */
+export class LocalExecutorService {
+    /**
+     * Execute a command locally using Node.js execFile
+     *
+     * SECURITY: Uses execFile which does NOT invoke a shell, preventing command injection.
+     * Arguments are passed as array elements, not concatenated strings.
+     *
+     * @param command - Command to execute (binary name or path)
+     * @param args - Command arguments (each element is a separate argument)
+     * @param options - Execution options (timeout, cwd)
+     * @returns Command stdout (trimmed)
+     * @throws Error if command fails, times out, or binary not found
+     */
+    async executeLocalCommand(command, args = [], options = {}) {
+        const timeoutMs = options.timeoutMs ?? 30000;
+        if (!command || command.trim() === "") {
+            throw new Error("Command cannot be empty");
+        }
+        try {
+            // execFile does NOT use shell - args are passed directly to the binary
+            // This prevents injection: echo "foo; rm -rf /" becomes literal string, not executed
+            const { stdout } = await execFileAsync(command, args, {
+                timeout: timeoutMs,
+                cwd: options.cwd,
+                maxBuffer: 10 * 1024 * 1024, // 10MB max output
+                encoding: "utf8",
+                // IMPORTANT: no shell option - we want execFile's default behavior (no shell)
+                shell: false,
+            });
+            // execFile can succeed with stderr output in some cases
+            // We only fail on non-zero exit codes (handled by execFile rejection)
+            return stdout.trim();
+        }
+        catch (error) {
+            // Type guard for Error objects
+            if (error instanceof Error) {
+                // execFile throws with code property on command errors
+                const execError = error;
+                // Handle timeout or forced termination
+                // killed=true indicates process was forcibly terminated
+                // SIGTERM is graceful termination, SIGKILL is forced termination
+                if (execError.killed || execError.signal === "SIGTERM" || execError.signal === "SIGKILL") {
+                    throw new Error(`Local command timeout after ${timeoutMs}ms: ${command} ${args.join(" ")}`, { cause: error });
+                }
+                // Handle command not found
+                if (execError.code === "ENOENT") {
+                    throw new Error(`Command not found: ${command}`, { cause: error });
+                }
+                // Handle command execution failure with context
+                const argsStr = args.length > 0 ? ` ${args.join(" ")}` : "";
+                const stderrInfo = execError.stderr ? `\nStderr: ${execError.stderr}` : "";
+                throw new Error(`Local command failed: ${command}${argsStr}${stderrInfo}\nOriginal error: ${error.message}`, { cause: error });
+            }
+            // Non-Error exceptions (rare) - preserve original error as cause
+            throw new Error(`Local command execution failed: ${String(error)}`, {
+                cause: error,
+            });
+        }
+    }
+}
+//# sourceMappingURL=local-executor.js.map

package/dist/services/local-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.js","sourceRoot":"","sources":["../../src/services/local-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAU1C;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAAe,EACf,OAAiB,EAAE,EACnB,UAA+B,EAAE;QAEjC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAE7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC;YACH,uEAAuE;YACvE,qFAAqF;YACrF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;gBACpD,OAAO,EAAE,SAAS;gBAClB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,kBAAkB;gBAC/C,QAAQ,EAAE,MAAM;gBAChB,8EAA8E;gBAC9E,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YAEH,wDAAwD;YACxD,sEAAsE;YACtE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+BAA+B;YAC/B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,uDAAuD;gBACvD,MAAM,SAAS,GAAG,KAMjB,CAAC;gBAEF,uCAAuC;gBACvC,wDAAwD;gBACxD,iEAAiE;gBACjE,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzF,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,OAAO,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC1E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;gBACJ,CAAC;gBAED,2BAA2B;gBAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBACrE,CAAC;gBAED,gDAAgD;gBAChD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,GAAG,OAAO,GAAG,UAAU,qBAAqB,KAAK,CAAC,OAAO,EAAE,EAC3F,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YAED,iEAAiE;YACjE,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/services/ssh-config-loader.d.ts

@@ -0,0 +1,35 @@
+import type { HostConfig } from "../types.js";
+/**
+ * Load host configurations from SSH config file
+ *
+ * @param configPath - Path to SSH config file (defaults to ~/.ssh/config)
+ * @returns Promise resolving to array of HostConfig objects parsed from SSH config
+ *
+ * @example
+ * ```typescript
+ * const hosts = await loadFromSSHConfig("~/.ssh/config");
+ * // Returns: [{ name: "server1", host: "192.168.1.100", protocol: "ssh", ... }]
+ * ```
+ */
+export declare function loadFromSSHConfig(configPath?: string): Promise<HostConfig[]>;
+/**
+ * Merge host configurations with manual config taking precedence
+ *
+ * Manual hosts completely replace SSH config hosts with the same name.
+ * No property merging - manual config is used as-is.
+ *
+ * @param sshConfigHosts - Hosts loaded from SSH config
+ * @param manualHosts - Hosts from manual configuration (config file or env var)
+ * @returns Merged array with manual hosts taking precedence
+ *
+ * @example
+ * ```typescript
+ * const sshHosts = [{ name: "server1", host: "192.168.1.100", protocol: "ssh" }];
+ * const manualHosts = [{ name: "server1", host: "10.0.0.100", protocol: "http" }];
+ * const merged = mergeHostConfigs(sshHosts, manualHosts);
+ * // Result: [{ name: "server1", host: "10.0.0.100", protocol: "http" }]
+ * // Manual config completely replaces SSH config
+ * ```
+ */
+export declare function mergeHostConfigs(sshConfigHosts: HostConfig[], manualHosts: HostConfig[]): HostConfig[];
+//# sourceMappingURL=ssh-config-loader.d.ts.map