synapse-mcp 1.0.0 → 1.0.2

package/dist/tools/handlers/host.js

@@ -0,0 +1,196 @@
+// src/tools/handlers/host.ts
+import { formatHostResourcesMarkdown, formatHostStatusMarkdown } from "../../formatters/index.js";
+import { logError } from "../../utils/errors.js";
+import { escapeShellArg, isLocalHost, validateSSHArg, validateSystemdServiceName, } from "../../utils/index.js";
+import { createExhaustiveError, formatResponse, getHostConfigOptional, initializeHandler, resolveTargetHosts, } from "./base-handler.js";
+/**
+ * Execute command on local or remote host based on configuration.
+ *
+ * Routes to LocalExecutor for localhost detection, SSH for remote hosts.
+ * Provides unified interface for command execution across host types.
+ *
+ * @param host - Host configuration specifying target
+ * @param command - Command name to execute
+ * @param args - Command arguments (pre-validated)
+ * @param container - Service container for executor access
+ * @returns Command stdout output
+ * @throws {Error} When command execution fails
+ */
+async function executeCommand(host, command, args, container) {
+    if (isLocalHost(host)) {
+        const localExecutor = container.getLocalExecutor();
+        return await localExecutor.executeLocalCommand(command, args);
+    }
+    else {
+        const sshService = container.getSSHService();
+        return await sshService.executeSSHCommand(host, command, args);
+    }
+}
+/**
+ * Handle all host subactions for system-level operations.
+ *
+ * Supports 7 subactions: status, resources, info, uptime, services, network, mounts.
+ * Can query all hosts (status, resources) or require specific host (others).
+ *
+ * @param input - Validated Flux input with host action
+ * @param container - Service container with SSH and Docker services
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or command fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleHostAction(
+ *   { action: 'host', subaction: 'status' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleHostAction(input, container) {
+    const validated = input;
+    const hostName = validated.host;
+    const { service: dockerService, hosts, format, } = await initializeHandler(validated, container, (c) => c.getDockerService());
+    const sshService = container.getSSHService();
+    // Find the target host (can query all hosts if not specified for some actions)
+    const hostConfig = getHostConfigOptional(hosts, hostName);
+    // For most operations, require the host
+    if (hostName && !hostConfig) {
+        throw new Error(`Host not found: ${hostName}`);
+    }
+    switch (validated.subaction) {
+        case "status": {
+            // For status, we can check all hosts or specific host
+            const targetHosts = resolveTargetHosts(hosts, hostName);
+            const statusResults = await Promise.all(targetHosts.map(async (h) => {
+                try {
+                    const info = await dockerService.getDockerInfo(h);
+                    const containers = await dockerService.listContainers([h]);
+                    const runningCount = containers.filter((c) => c.state === "running").length;
+                    return {
+                        name: h.name,
+                        connected: true,
+                        containerCount: containers.length,
+                        runningCount,
+                        dockerVersion: info.dockerVersion,
+                        error: undefined,
+                    };
+                }
+                catch (err) {
+                    logError(err, {
+                        operation: "handleHostAction:status",
+                        metadata: { host: h.name, action: "status" },
+                    });
+                    return {
+                        name: h.name,
+                        connected: false,
+                        containerCount: 0,
+                        runningCount: 0,
+                        dockerVersion: undefined,
+                        error: err instanceof Error ? err.message : "Unknown error",
+                    };
+                }
+            }));
+            return formatResponse(hostConfig ? statusResults[0] : statusResults, format, () => formatHostStatusMarkdown(statusResults));
+        }
+        case "resources": {
+            // Resources requires SSH, must have a specific host
+            const targetHosts = resolveTargetHosts(hosts, hostName);
+            const resourceResults = await Promise.all(targetHosts.map(async (h) => {
+                try {
+                    const resources = await sshService.getHostResources(h);
+                    return { host: h.name, resources, error: undefined };
+                }
+                catch (err) {
+                    logError(err, {
+                        operation: "handleHostAction:resources",
+                        metadata: { host: h.name, action: "resources" },
+                    });
+                    return {
+                        host: h.name,
+                        resources: null,
+                        error: err instanceof Error ? err.message : "Unknown error",
+                    };
+                }
+            }));
+            return formatResponse(hostConfig ? resourceResults[0] : resourceResults, format, () => formatHostResourcesMarkdown(resourceResults));
+        }
+        case "info": {
+            if (!hostConfig) {
+                throw new Error("Host is required for host:info");
+            }
+            const output = await executeCommand(hostConfig, "uname", ["-a"], container);
+            const infoResult = { host: hostConfig.name, info: output.trim() };
+            return formatResponse(infoResult, format, (data) => `## System Info - ${data.host}\n\n\`\`\`\n${data.info}\n\`\`\``);
+        }
+        case "uptime": {
+            if (!hostConfig) {
+                throw new Error("Host is required for host:uptime");
+            }
+            const output = await executeCommand(hostConfig, "uptime", [], container);
+            const uptimeResult = { host: hostConfig.name, uptime: output.trim() };
+            return formatResponse(uptimeResult, format, (data) => `## Uptime - ${data.host}\n\n\`\`\`\n${data.uptime}\n\`\`\``);
+        }
+        case "services": {
+            if (!hostConfig) {
+                throw new Error("Host is required for host:services");
+            }
+            // Use validated properties directly
+            const state = validated.subaction === "services" ? validated.state : undefined;
+            const service = validated.subaction === "services" ? validated.service : undefined;
+            // SECURITY: Defense-in-depth validation to prevent command injection
+            // The SSH service joins args with spaces and executes as shell command,
+            // so we must reject shell metacharacters like ; | & ` $ etc.
+            // Note: Schema already validates state enum, this is defense-in-depth
+            if (state && state !== "all") {
+                validateSSHArg(state, "state");
+            }
+            // Note: Schema already validates service name pattern, this is defense-in-depth
+            if (service) {
+                validateSystemdServiceName(service);
+            }
+            // Build systemctl command based on options
+            const args = ["list-units", "--type=service", "--no-pager"];
+            if (state && state !== "all") {
+                const safeState = escapeShellArg(state);
+                args.push(`--state=${safeState}`);
+            }
+            if (service) {
+                const safeService = escapeShellArg(service);
+                args.push(safeService);
+            }
+            const output = await executeCommand(hostConfig, "systemctl", args, container);
+            const servicesResult = { host: hostConfig.name, services: output.trim() };
+            return formatResponse(servicesResult, format, (data) => `## Systemd Services - ${data.host}\n\n\`\`\`\n${data.services}\n\`\`\``);
+        }
+        case "network": {
+            if (!hostConfig) {
+                throw new Error("Host is required for host:network");
+            }
+            // Use ip addr or ifconfig
+            let output;
+            try {
+                output = await executeCommand(hostConfig, "ip", ["addr", "show"], container);
+            }
+            catch (error) {
+                // Fallback to ifconfig if ip command not available
+                logError(error, {
+                    operation: "host:network",
+                    metadata: { host: hostConfig.name, fallback: "ifconfig" },
+                });
+                output = await executeCommand(hostConfig, "ifconfig", ["-a"], container);
+            }
+            const networkResult = { host: hostConfig.name, network: output.trim() };
+            return formatResponse(networkResult, format, (data) => `## Network Interfaces - ${data.host}\n\n\`\`\`\n${data.network}\n\`\`\``);
+        }
+        case "mounts": {
+            if (!hostConfig) {
+                throw new Error("Host is required for host:mounts");
+            }
+            const output = await executeCommand(hostConfig, "df", ["-h"], container);
+            const mountsResult = { host: hostConfig.name, mounts: output.trim() };
+            return formatResponse(mountsResult, format, (data) => `## Mounted Filesystems - ${data.host}\n\n\`\`\`\n${data.mounts}\n\`\`\``);
+        }
+        default:
+            throw createExhaustiveError(validated, "host subaction");
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/tools/handlers/host.js.map

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

package/dist/tools/handlers/scout-logs.d.ts

@@ -0,0 +1,24 @@
+import type { ScoutInput } from "../../schemas/scout/index.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all logs subactions for system log retrieval.
+ *
+ * Supports 4 subactions: syslog, journal, dmesg, auth.
+ * Implements defense-in-depth security: grep filtering is performed locally
+ * after command execution to prevent command injection.
+ *
+ * @param input - Validated Scout input with logs action
+ * @param container - Service container with SSH service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or log retrieval fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleLogsAction(
+ *   { action: 'logs', subaction: 'journal', host: 'host1', lines: 100 },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleLogsAction(input: ScoutInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=scout-logs.d.ts.map

package/dist/tools/handlers/scout-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout-logs.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/scout-logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAUpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAuIjB"}

package/dist/tools/handlers/scout-logs.js

@@ -0,0 +1,119 @@
+import { scoutLogsSchema } from "../../schemas/scout/logs.js";
+import { applyGrepFilter } from "../../utils/text-filters.js";
+import { createExhaustiveError, formatResponse, getHostConfigOrThrow, initializeHandler, validateInput, } from "./base-handler.js";
+/**
+ * Handle all logs subactions for system log retrieval.
+ *
+ * Supports 4 subactions: syslog, journal, dmesg, auth.
+ * Implements defense-in-depth security: grep filtering is performed locally
+ * after command execution to prevent command injection.
+ *
+ * @param input - Validated Scout input with logs action
+ * @param container - Service container with SSH service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or log retrieval fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleLogsAction(
+ *   { action: 'logs', subaction: 'journal', host: 'host1', lines: 100 },
+ *   container
+ * );
+ * ```
+ */
+export async function handleLogsAction(input, container) {
+    if (input.action !== "logs") {
+        throw new Error(`Invalid action for logs handler: ${input.action}`);
+    }
+    // Validate and parse with the specific logs schema
+    const validatedInput = validateInput(input, scoutLogsSchema, "scout-logs");
+    const { hosts, format } = await initializeHandler(validatedInput, container, (c) => c.getSSHService());
+    const sshService = container.getSSHService();
+    // Find the target host
+    const hostConfig = getHostConfigOrThrow(hosts, validatedInput.host);
+    const lines = validatedInput.lines;
+    const grep = validatedInput.grep;
+    switch (validatedInput.subaction) {
+        case "syslog": {
+            const args = ["-n", String(lines), "/var/log/syslog"];
+            const command = "tail";
+            let output = await sshService.executeSSHCommand(hostConfig, command, args);
+            // Apply grep filter locally if specified (immune to command injection)
+            output = applyGrepFilter(output, grep);
+            return formatResponse({
+                host: hostConfig.name,
+                subaction: "syslog",
+                lines,
+                grep,
+                output: output.trim(),
+            }, format, () => output.trim());
+        }
+        case "journal": {
+            const args = ["-n", String(lines), "--no-pager"];
+            // Add unit filter
+            if (validatedInput.unit) {
+                args.push("-u", validatedInput.unit);
+            }
+            // Add time range filters
+            if (validatedInput.since) {
+                args.push("--since", validatedInput.since);
+            }
+            if (validatedInput.until) {
+                args.push("--until", validatedInput.until);
+            }
+            // Add priority filter
+            if (validatedInput.priority) {
+                args.push("-p", validatedInput.priority);
+            }
+            let output = await sshService.executeSSHCommand(hostConfig, "journalctl", args);
+            // Apply local grep filtering if provided
+            output = applyGrepFilter(output, grep);
+            return formatResponse({
+                host: hostConfig.name,
+                subaction: "journal",
+                lines,
+                unit: validatedInput.unit,
+                since: validatedInput.since,
+                until: validatedInput.until,
+                priority: validatedInput.priority,
+                grep,
+                output: output.trim(),
+            }, format, () => output.trim());
+        }
+        case "dmesg": {
+            // Execute dmesg with args, pipe output to tail
+            const dmesgOutput = await sshService.executeSSHCommand(hostConfig, "dmesg", [
+                "--color=never",
+            ]);
+            // Apply grep filter locally if specified (immune to command injection)
+            const filteredOutput = applyGrepFilter(dmesgOutput, grep);
+            // Apply tail locally (limit lines)
+            const outputLines = filteredOutput.trim().split("\n");
+            const output = outputLines.slice(-lines).join("\n");
+            return formatResponse({
+                host: hostConfig.name,
+                subaction: "dmesg",
+                lines,
+                grep,
+                output: output.trim(),
+            }, format, () => output.trim());
+        }
+        case "auth": {
+            const args = ["-n", String(lines), "/var/log/auth.log"];
+            const command = "tail";
+            let output = await sshService.executeSSHCommand(hostConfig, command, args);
+            // Apply grep filter locally if specified (immune to command injection)
+            output = applyGrepFilter(output, grep);
+            return formatResponse({
+                host: hostConfig.name,
+                subaction: "auth",
+                lines,
+                grep,
+                output: output.trim(),
+            }, format, () => output.trim());
+        }
+        default:
+            throw createExhaustiveError(validatedInput, "scout-logs subaction");
+    }
+}
+//# sourceMappingURL=scout-logs.js.map

package/dist/tools/handlers/scout-logs.js.map

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

package/dist/tools/handlers/scout-simple.d.ts

@@ -0,0 +1,23 @@
+import type { ScoutInput } from "../../schemas/scout/index.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all Scout simple actions for SSH file and process operations.
+ *
+ * Supports 9 actions: nodes, peek, exec, find, delta, emit, beam, ps, df.
+ * These actions operate directly without subactions.
+ *
+ * @param input - Validated Scout input with simple action
+ * @param container - Service container with SSH and file services
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found, target invalid, or operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleScoutSimpleAction(
+ *   { action: 'peek', target: 'host1:/etc/hosts' },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleScoutSimpleAction(input: ScoutInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=scout-simple.d.ts.map

package/dist/tools/handlers/scout-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/scout-simple.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAsCpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqUjB"}