synapse-mcp 1.0.0 → 1.0.2

package/dist/services/diagnostics.js

@@ -0,0 +1,271 @@
+// src/services/diagnostics.ts
+/**
+ * Diagnostic checks for host health monitoring
+ *
+ * Provides actionable health checks for Docker hosts:
+ * - Resources: CPU/memory/disk thresholds
+ * - Containers: Exited/unhealthy container detection
+ * - Logs: Recent error pattern scanning
+ * - Processes: Zombie/defunct process detection
+ * - Docker: Daemon health verification
+ * - Network: Connectivity testing
+ */
+import { logError } from "../utils/errors.js";
+const RESOURCE_THRESHOLD = 80; // Warn if CPU/memory/disk > 80%
+const HIGH_LATENCY_MS = 1000; // Warn if ping > 1000ms
+/**
+ * Check host resources (CPU, memory, disk)
+ * Warns if any resource exceeds 80% usage
+ */
+export async function checkResources(host, sshService) {
+    try {
+        const resources = await sshService.getHostResources(host);
+        const issues = [];
+        const recommendations = [];
+        // Check CPU usage
+        if (resources.cpu.usagePercent > RESOURCE_THRESHOLD) {
+            issues.push(`CPU usage high: ${resources.cpu.usagePercent}%`);
+            recommendations.push("Identify CPU-intensive processes with `top` or `htop`");
+        }
+        // Check memory usage
+        if (resources.memory.usagePercent > RESOURCE_THRESHOLD) {
+            issues.push(`Memory usage high: ${resources.memory.usagePercent}%`);
+            recommendations.push("Check for memory leaks or reduce container memory limits");
+        }
+        // Check disk usage
+        for (const disk of resources.disk) {
+            if (disk.usagePercent > RESOURCE_THRESHOLD) {
+                issues.push(`Disk usage high on ${disk.mount}: ${disk.usagePercent}%`);
+                recommendations.push("Free up disk space or expand storage capacity");
+            }
+        }
+        if (issues.length === 0) {
+            return {
+                status: "pass",
+                message: "Resources within normal thresholds",
+                details: `CPU: ${resources.cpu.usagePercent}%, Memory: ${resources.memory.usagePercent}%, Disk: ${resources.disk.map((d) => `${d.mount} ${d.usagePercent}%`).join(", ")}`
+            };
+        }
+        return {
+            status: "warn",
+            message: issues.join("; "),
+            details: `Load: ${resources.loadAverage.join(", ")} | CPU: ${resources.cpu.cores} cores @ ${resources.cpu.usagePercent}% | Memory: ${resources.memory.usedMB}MB / ${resources.memory.totalMB}MB`,
+            recommendations: recommendations.join("\n")
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkResources",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Failed to check resources",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Verify SSH connectivity and host availability"
+        };
+    }
+}
+/**
+ * Check container health
+ * Finds exited or unhealthy containers
+ */
+export async function checkContainers(host, dockerService) {
+    try {
+        const containers = await dockerService.listContainers([host]);
+        const exited = containers.filter((c) => c.state === "exited");
+        const unhealthy = containers.filter((c) => c.status?.toLowerCase().includes("unhealthy"));
+        const issues = [];
+        const recommendations = [];
+        if (exited.length > 0) {
+            issues.push(`Found ${exited.length} exited containers: ${exited.map((c) => c.name).join(", ")}`);
+            recommendations.push("Check container logs with `docker logs <container>`");
+            recommendations.push("Restart containers with `docker start <container>`");
+        }
+        if (unhealthy.length > 0) {
+            issues.push(`Found ${unhealthy.length} unhealthy containers: ${unhealthy.map((c) => c.name).join(", ")}`);
+            recommendations.push("Review health check configuration in docker-compose.yml");
+            recommendations.push("Inspect container health with `docker inspect <container>`");
+        }
+        if (issues.length === 0) {
+            return {
+                status: "pass",
+                message: "All containers healthy",
+                details: `${containers.length} total containers, ${containers.filter((c) => c.state === "running").length} running`
+            };
+        }
+        return {
+            status: "warn",
+            message: issues.join("; "),
+            details: exited.map((c) => `${c.name}: ${c.status}`).join("\n") +
+                "\n" +
+                unhealthy.map((c) => `${c.name}: ${c.status}`).join("\n"),
+            recommendations: recommendations.join("\n")
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkContainers",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Failed to check containers",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Verify Docker daemon is running and accessible"
+        };
+    }
+}
+/**
+ * Check system logs for error patterns
+ * Scans journalctl for recent errors/warnings
+ */
+export async function checkLogs(host, sshService) {
+    try {
+        // Get last 100 lines from journalctl (last 1 hour)
+        const logs = await sshService.executeSSHCommand(host, "journalctl", [
+            "--since",
+            "1 hour ago",
+            "--no-pager",
+            "-n",
+            "100"
+        ]);
+        // Count error patterns (case-insensitive)
+        const errorPattern = /error|failed|fatal|critical/gi;
+        const warningPattern = /warn|warning/gi;
+        const errorMatches = logs.match(errorPattern) || [];
+        const warningMatches = logs.match(warningPattern) || [];
+        if (errorMatches.length === 0 && warningMatches.length === 0) {
+            return {
+                status: "pass",
+                message: "No critical errors in recent logs",
+                details: "Scanned last 100 log entries from past hour"
+            };
+        }
+        return {
+            status: "warn",
+            message: "Found error patterns in logs",
+            details: `${errorMatches.length} error mentions, ${warningMatches.length} warning mentions in last hour`,
+            recommendations: "Review application logs with `journalctl -xe` or `docker logs <container>`"
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkLogs",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Failed to check logs",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Verify journalctl is available or check permissions"
+        };
+    }
+}
+/**
+ * Check for zombie or defunct processes
+ * Detects processes that failed to clean up properly
+ */
+export async function checkProcesses(host, sshService) {
+    try {
+        // Find zombie/defunct processes
+        const output = await sshService.executeSSHCommand(host, "ps", ["aux"]);
+        // Parse for defunct/zombie processes - split on newlines
+        const lines = output.split("\n").filter((line) => line.trim().length > 0);
+        const zombies = lines.filter((line) => line.includes("defunct") ||
+            line.includes("zombie") ||
+            line.includes("Z+") ||
+            line.includes("<defunct>"));
+        if (zombies.length === 0) {
+            return {
+                status: "pass",
+                message: "No zombie or defunct processes",
+                details: "All processes in healthy state"
+            };
+        }
+        return {
+            status: "warn",
+            message: `Found ${zombies.length} zombie/defunct processes`,
+            details: zombies.slice(0, 10).join("\n"),
+            recommendations: "Investigate parent processes with `ps -ef` and consider restarting affected services"
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkProcesses",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Failed to check processes",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Verify SSH access and ps command availability"
+        };
+    }
+}
+/**
+ * Check Docker daemon health
+ * Verifies Docker API connectivity and version
+ */
+export async function checkDocker(host, dockerService) {
+    try {
+        const info = await dockerService.getDockerInfo(host);
+        return {
+            status: "pass",
+            message: "Docker daemon healthy",
+            details: `Version: ${info.dockerVersion}, API: ${info.apiVersion}, ${info.containersRunning}/${info.containersTotal} containers running`,
+            recommendations: undefined
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkDocker",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Docker daemon unreachable",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Check Docker service status with `systemctl status docker`\nRestart Docker with `systemctl restart docker`"
+        };
+    }
+}
+/**
+ * Check network connectivity
+ * Tests external connectivity and measures latency
+ */
+export async function checkNetwork(host, sshService) {
+    try {
+        // Ping google.com with 1 packet
+        const output = await sshService.executeSSHCommand(host, "ping", ["-c", "1", "google.com"]);
+        // Extract latency from ping output
+        const timeMatch = output.match(/time=(\d+\.?\d*)\s*ms/);
+        const latency = timeMatch ? parseFloat(timeMatch[1]) : 0;
+        if (latency > HIGH_LATENCY_MS) {
+            return {
+                status: "warn",
+                message: "Network latency high",
+                details: `Ping latency: ${latency.toFixed(1)}ms (threshold: ${HIGH_LATENCY_MS}ms)`,
+                recommendations: "Check network configuration and routing\nVerify DNS resolution with `dig google.com`"
+            };
+        }
+        return {
+            status: "pass",
+            message: "Network connectivity OK",
+            details: `Ping latency: ${latency.toFixed(1)}ms`
+        };
+    }
+    catch (error) {
+        logError(error, {
+            operation: "checkNetwork",
+            metadata: { host: host.name }
+        });
+        return {
+            status: "fail",
+            message: "Network check failed",
+            details: error instanceof Error ? error.message : "Unknown error",
+            recommendations: "Verify network connectivity and DNS resolution\nCheck firewall rules with `iptables -L`"
+        };
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/services/diagnostics.js.map

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

package/dist/services/docker/container-service.d.ts

@@ -0,0 +1,123 @@
+import type { ContainerExecResult, ContainerInfo, ContainerProcessList, ContainerStats, DockerRawContainerInfo, DockerRawContainerInspectInfo, HostConfig, LogEntry } from "../../types.js";
+import type { ClientManager } from "./utils/client-manager.js";
+/**
+ * Service for Docker container operations.
+ * Handles container lifecycle, monitoring, and execution.
+ */
+export declare class ContainerService {
+    private clientManager;
+    constructor(clientManager: ClientManager);
+    private matchesContainerIdentifier;
+    /**
+     * List containers across multiple hosts with filtering and pagination.
+     *
+     * @param hosts - List of Docker hosts to query
+     * @param options - Filtering and pagination options
+     * @param options.state - Filter by container state
+     * @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")
+     * @param options.limit - Maximum number of containers to return
+     * @param options.offset - Number of containers to skip before returning results
+     * @returns Promise resolving to array of container information
+     */
+    listContainers(hosts: HostConfig[], options?: {
+        state?: "all" | "running" | "stopped" | "paused";
+        nameFilter?: string;
+        imageFilter?: string;
+        labelFilter?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ContainerInfo[]>;
+    /**
+     * List containers on a single host (internal helper).
+     */
+    private listContainersOnHost;
+    /**
+     * Find which host a container is on.
+     * Performs parallel scan across hosts for optimal performance.
+     *
+     * Note: For cache-optimized lookups, use DockerService.findContainerHost() with
+     * ContainerHostMapCache instead. The cache requires client-provider capability
+     * and is integrated at the facade level.
+     *
+     * @param containerId - Container ID, name, or ID prefix
+     * @param hosts - List of hosts to search
+     * @returns Host and container info if found, null otherwise
+     */
+    findContainerHost(containerId: string, hosts: HostConfig[]): Promise<{
+        host: HostConfig;
+        container: DockerRawContainerInfo;
+    } | null>;
+    /**
+     * Perform action on container.
+     *
+     * @param containerId - Container ID or name
+     * @param action - Action to perform
+     * @param host - Host configuration
+     */
+    containerAction(containerId: string, action: "start" | "stop" | "restart" | "pause" | "unpause", host: HostConfig): Promise<void>;
+    /**
+     * Get container by ID or name.
+     */
+    private getContainer;
+    /**
+     * Get container logs.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration
+     * @param options - Log filtering options
+     * @returns Promise resolving to array of log entries
+     */
+    getContainerLogs(containerId: string, host: HostConfig, options?: {
+        lines?: number;
+        since?: string;
+        until?: string;
+        stream?: "all" | "stdout" | "stderr";
+    }): Promise<LogEntry[]>;
+    /**
+     * Get container stats.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration
+     * @param containerName - Optional container name (avoids redundant inspect() call)
+     * @returns Promise resolving to container resource usage stats
+     */
+    getContainerStats(containerId: string, host: HostConfig, containerName?: string): Promise<ContainerStats>;
+    /**
+     * Execute a command inside a container.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration
+     * @param options - Execution options
+     * @param options.command - Shell command to execute
+     * @param options.user - Optional user to run as
+     * @param options.workdir - Optional working directory
+     * @param options.timeout - Optional timeout in ms (default 30s, max 5min)
+     * @returns Promise resolving to stdout, stderr, and exit code
+     * @throws Error if timeout exceeded or buffer limit exceeded
+     */
+    execContainer(containerId: string, host: HostConfig, options: {
+        command: string;
+        user?: string;
+        workdir?: string;
+        timeout?: number;
+    }): Promise<ContainerExecResult>;
+    /**
+     * List running processes inside a container.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration
+     * @returns Promise resolving to process list with titles and data
+     */
+    getContainerProcesses(containerId: string, host: HostConfig): Promise<ContainerProcessList>;
+    /**
+     * Inspect a container to get detailed information.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration
+     * @returns Promise resolving to Docker container inspection data
+     */
+    inspectContainer(containerId: string, host: HostConfig): Promise<DockerRawContainerInspectInfo>;
+}
+//# sourceMappingURL=container-service.d.ts.map

package/dist/services/docker/container-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-service.d.ts","sourceRoot":"","sources":["../../../src/services/docker/container-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,6BAA6B,EAC7B,UAAU,EACV,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD,OAAO,CAAC,0BAA0B;IAalC;;;;;;;;;;;;OAYG;IACG,cAAc,CAClB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;QACjD,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,aAAa,EAAE,CAAC;IA0B3B;;OAEG;YACW,oBAAoB;IAqElC;;;;;;;;;;;OAWG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,sBAAsB,CAAA;KAAE,GAAG,IAAI,CAAC;IA8C1E;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAC1D,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC;IAsBhB;;OAEG;YACW,YAAY;IAK1B;;;;;;;OAOG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;KACjC,GACL,OAAO,CAAC,QAAQ,EAAE,CAAC;IA8BtB;;;;;;;OAOG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC;IA4D1B;;;;;;;;;;;;OAYG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9E,OAAO,CAAC,mBAAmB,CAAC;IAyB/B;;;;;;OAMG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,oBAAoB,CAAC;IAUhC;;;;;;OAMG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,6BAA6B,CAAC;CAI1C"}