synapse-mcp 1.0.0

package/dist/services/ssh-pool.js

@@ -0,0 +1,253 @@
+import { NodeSSH } from "node-ssh";
+import { HostOperationError, logError } from "../utils/errors.js";
+/**
+ * Default pool configuration
+ */
+export const DEFAULT_POOL_CONFIG = {
+    maxConnections: 5,
+    idleTimeoutMs: 60000,
+    connectionTimeoutMs: 5000,
+    enableHealthChecks: true,
+    healthCheckIntervalMs: 30000
+};
+/**
+ * Generate unique pool key for host
+ * Format: ${host.name}:${port}
+ */
+export function generatePoolKey(host) {
+    const port = host.port || 22;
+    return `${host.name}:${port}`;
+}
+/**
+ * SSH Connection Pool Implementation
+ */
+export class SSHConnectionPoolImpl {
+    config;
+    pool;
+    stats;
+    healthCheckTimer;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_POOL_CONFIG, ...config };
+        this.pool = new Map();
+        this.stats = {
+            poolHits: 0,
+            poolMisses: 0,
+            activeConnections: 0,
+            idleConnections: 0,
+            totalConnections: 0,
+            healthChecksPassed: 0,
+            healthCheckFailures: 0
+        };
+        if (this.config.enableHealthChecks) {
+            this.startHealthChecks();
+        }
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    startHealthChecks() {
+        this.healthCheckTimer = setInterval(() => {
+            void this.performHealthChecks();
+        }, this.config.healthCheckIntervalMs);
+    }
+    async performHealthChecks() {
+        const healthCheckPromises = [];
+        for (const [poolKey, connections] of this.pool.entries()) {
+            for (const metadata of connections) {
+                // Only check idle connections
+                if (!metadata.isActive) {
+                    healthCheckPromises.push(this.checkConnectionHealth(poolKey, metadata));
+                }
+            }
+        }
+        await Promise.allSettled(healthCheckPromises);
+    }
+    async checkConnectionHealth(poolKey, metadata) {
+        try {
+            // Verify connection using echo command
+            const result = await metadata.connection.execCommand("echo ok");
+            if (result.code === 0) {
+                // Health check passed (exit code 0 indicates success)
+                metadata.healthChecksPassed++;
+                this.stats.healthChecksPassed++;
+            }
+            else {
+                // Command failed
+                throw new Error("Health check command failed");
+            }
+        }
+        catch (error) {
+            logError(new HostOperationError("Health check failed", metadata.host.name, "healthCheck", error), {
+                metadata: {
+                    poolKey,
+                    failureCount: metadata.healthChecksFailed + 1,
+                    lastUsed: new Date(metadata.lastUsed).toISOString()
+                }
+            });
+            metadata.healthChecksFailed++;
+            this.stats.healthCheckFailures++;
+            await this.removeConnection(poolKey, metadata);
+        }
+    }
+    async getConnection(host) {
+        const poolKey = generatePoolKey(host);
+        const connections = this.pool.get(poolKey) || [];
+        // Try to find idle connection
+        const idleConnection = connections.find((c) => !c.isActive);
+        if (idleConnection) {
+            // Reuse existing connection (pool hit)
+            idleConnection.isActive = true;
+            idleConnection.lastUsed = Date.now();
+            this.stats.poolHits++;
+            this.updateConnectionStats();
+            return idleConnection.connection;
+        }
+        // Check if we can create new connection
+        if (connections.length >= this.config.maxConnections) {
+            throw new Error(`Connection pool exhausted for ${poolKey} (max: ${this.config.maxConnections})`);
+        }
+        // Create new connection (pool miss)
+        const connection = await this.createConnection(host);
+        const metadata = {
+            connection,
+            host,
+            lastUsed: Date.now(),
+            created: Date.now(),
+            healthChecksPassed: 0,
+            healthChecksFailed: 0,
+            isActive: true
+        };
+        connections.push(metadata);
+        this.pool.set(poolKey, connections);
+        this.stats.poolMisses++;
+        this.updateConnectionStats();
+        return connection;
+    }
+    async createConnection(host) {
+        const ssh = new NodeSSH();
+        const connectionConfig = {
+            host: host.host,
+            port: host.port || 22,
+            username: host.sshUser || process.env.USER || "root",
+            privateKeyPath: host.sshKeyPath,
+            readyTimeout: this.config.connectionTimeoutMs
+        };
+        console.error(`[SSH Pool] Attempting connection to ${host.name} (${connectionConfig.host}:${connectionConfig.port})`);
+        console.error(`[SSH Pool] - Username: ${connectionConfig.username}`);
+        console.error(`[SSH Pool] - Private key: ${connectionConfig.privateKeyPath}`);
+        console.error(`[SSH Pool] - Ready timeout: ${connectionConfig.readyTimeout}ms`);
+        try {
+            await ssh.connect(connectionConfig);
+            console.error(`[SSH Pool] Successfully connected to ${host.name}`);
+            return ssh;
+        }
+        catch (error) {
+            console.error(`[SSH Pool] Connection failed to ${host.name}: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    updateConnectionStats() {
+        let active = 0;
+        let idle = 0;
+        let total = 0;
+        for (const connections of this.pool.values()) {
+            for (const conn of connections) {
+                total++;
+                if (conn.isActive) {
+                    active++;
+                }
+                else {
+                    idle++;
+                }
+            }
+        }
+        this.stats.activeConnections = active;
+        this.stats.idleConnections = idle;
+        this.stats.totalConnections = total;
+    }
+    async releaseConnection(host, connection) {
+        const poolKey = generatePoolKey(host);
+        const connections = this.pool.get(poolKey);
+        if (!connections) {
+            return;
+        }
+        const metadata = connections.find((c) => c.connection === connection);
+        if (metadata) {
+            metadata.isActive = false;
+            metadata.lastUsed = Date.now();
+            this.updateConnectionStats();
+            // Start idle timeout timer
+            this.scheduleIdleCleanup(poolKey, metadata);
+        }
+    }
+    scheduleIdleCleanup(poolKey, metadata) {
+        setTimeout(async () => {
+            const now = Date.now();
+            const idleTime = now - metadata.lastUsed;
+            // Only close if still idle and exceeded timeout
+            if (!metadata.isActive && idleTime >= this.config.idleTimeoutMs) {
+                await this.removeConnection(poolKey, metadata);
+            }
+        }, this.config.idleTimeoutMs);
+    }
+    async removeConnection(poolKey, metadata) {
+        const connections = this.pool.get(poolKey);
+        if (!connections)
+            return;
+        const index = connections.indexOf(metadata);
+        if (index !== -1) {
+            try {
+                await metadata.connection.dispose();
+            }
+            catch (error) {
+                logError(new HostOperationError("Failed to dispose SSH connection", metadata.host.name, "dispose", error), { metadata: { poolKey } });
+            }
+            connections.splice(index, 1);
+            if (connections.length === 0) {
+                this.pool.delete(poolKey);
+            }
+            this.updateConnectionStats();
+        }
+    }
+    async closeConnection(host) {
+        const poolKey = generatePoolKey(host);
+        const connections = this.pool.get(poolKey);
+        if (!connections) {
+            return;
+        }
+        const closePromises = connections.map(async (metadata) => {
+            try {
+                await metadata.connection.dispose();
+            }
+            catch (error) {
+                logError(new HostOperationError("Failed to dispose SSH connection during closeConnection", metadata.host.name, "closeConnection", error), { metadata: { poolKey } });
+            }
+        });
+        await Promise.allSettled(closePromises);
+        this.pool.delete(poolKey);
+        this.updateConnectionStats();
+    }
+    async closeAll() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+        const closePromises = [];
+        for (const connections of this.pool.values()) {
+            for (const metadata of connections) {
+                closePromises.push((async () => {
+                    try {
+                        await metadata.connection.dispose();
+                    }
+                    catch (error) {
+                        logError(new HostOperationError("Failed to dispose SSH connection during closeAll", metadata.host.name, "closeAll", error), { operation: "closeAll" });
+                    }
+                })());
+            }
+        }
+        await Promise.allSettled(closePromises);
+        this.pool.clear();
+        this.updateConnectionStats();
+    }
+}
+//# sourceMappingURL=ssh-pool.js.map

package/dist/services/ssh-pool.js.map

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

package/dist/services/ssh-service.d.ts

@@ -0,0 +1,39 @@
+import type { HostConfig } from "../types.js";
+import type { ISSHConnectionPool, ISSHService } from "./interfaces.js";
+import type { HostResources } from "./ssh.js";
+/**
+ * Options for SSH command execution
+ */
+export interface SSHCommandOptions {
+    timeoutMs?: number;
+}
+/**
+ * SSH service implementation using connection pool for command execution.
+ * Provides secure command execution and resource monitoring via SSH connections.
+ */
+export declare class SSHService implements ISSHService {
+    private readonly pool;
+    constructor(pool: ISSHConnectionPool);
+    /**
+     * Execute SSH command using connection pool
+     *
+     * Automatically acquires connection from pool, executes command, and releases.
+     * Connections are reused across calls for better performance.
+     *
+     * @param host - Host configuration
+     * @param command - Command to execute
+     * @param args - Command arguments (optional)
+     * @param options - Execution options (timeout, etc.)
+     * @returns Command stdout (trimmed)
+     * @throws SSHCommandError if command fails or times out
+     */
+    executeSSHCommand(host: HostConfig, command: string, args?: string[], options?: SSHCommandOptions): Promise<string>;
+    /**
+     * Get host resource usage via SSH using connection pool
+     *
+     * @param host - Host configuration to query
+     * @returns Resource information including CPU, memory, disk, and uptime
+     */
+    getHostResources(host: HostConfig): Promise<HostResources>;
+}
+//# sourceMappingURL=ssh-service.d.ts.map

package/dist/services/ssh-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-service.d.ts","sourceRoot":"","sources":["../../src/services/ssh-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,kBAAkB;IAErD;;;;;;;;;;;;OAYG;IACG,iBAAiB,CACrB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC;IAiElB;;;;;OAKG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;CAoFjE"}

package/dist/services/ssh-service.js

@@ -0,0 +1,143 @@
+import { SSHCommandError } from "../utils/errors.js";
+/**
+ * SSH service implementation using connection pool for command execution.
+ * Provides secure command execution and resource monitoring via SSH connections.
+ */
+export class SSHService {
+    pool;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    /**
+     * Execute SSH command using connection pool
+     *
+     * Automatically acquires connection from pool, executes command, and releases.
+     * Connections are reused across calls for better performance.
+     *
+     * @param host - Host configuration
+     * @param command - Command to execute
+     * @param args - Command arguments (optional)
+     * @param options - Execution options (timeout, etc.)
+     * @returns Command stdout (trimmed)
+     * @throws SSHCommandError if command fails or times out
+     */
+    async executeSSHCommand(host, command, args = [], options = {}) {
+        const timeoutMs = options.timeoutMs || 30000;
+        // Get connection from pool
+        const connection = await this.pool.getConnection(host);
+        // Build full command
+        const fullCommand = args.length > 0 ? `${command} ${args.join(" ")}` : command;
+        try {
+            // Execute with timeout
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`SSH command timeout after ${timeoutMs}ms: ${command}`));
+                }, timeoutMs);
+            });
+            const execPromise = connection.execCommand(fullCommand);
+            const result = await Promise.race([execPromise, timeoutPromise]);
+            // Check exit code
+            if (result.code !== 0) {
+                throw new SSHCommandError("SSH command failed with non-zero exit code", host.name, fullCommand, result.code ?? undefined, result.stderr, result.stdout);
+            }
+            return result.stdout.trim();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error instanceof SSHCommandError) {
+                    throw error;
+                }
+                const baseMessage = error.message || "SSH command execution failed";
+                throw new SSHCommandError(baseMessage, host.name, fullCommand, undefined, undefined, undefined, error);
+            }
+            throw new SSHCommandError("SSH command execution failed", host.name, fullCommand, undefined, undefined, undefined, error);
+        }
+        finally {
+            // Always release connection back to pool
+            await this.pool.releaseConnection(host, connection);
+        }
+    }
+    /**
+     * Get host resource usage via SSH using connection pool
+     *
+     * @param host - Host configuration to query
+     * @returns Resource information including CPU, memory, disk, and uptime
+     */
+    async getHostResources(host) {
+        // Run all commands in one SSH session for efficiency
+        const script = `
+    hostname
+    echo "---"
+    uptime -p 2>/dev/null || uptime | sed 's/.*up/up/'
+    echo "---"
+    cat /proc/loadavg | awk '{print $1,$2,$3}'
+    echo "---"
+    nproc
+    echo "---"
+    top -bn1 | grep "Cpu(s)" | awk '{print 100-$8}' 2>/dev/null || echo "0"
+    echo "---"
+    free -m | awk '/^Mem:/ {print $2,$3,$4}'
+    echo "---"
+    df -BG --output=source,target,size,used,avail,pcent 2>/dev/null | grep -E '^/dev' || df -h | grep -E '^/dev'
+  `
+            .trim()
+            .replace(/\n/g, "; ");
+        const output = await this.executeSSHCommand(host, script);
+        const sections = output.split("---").map((s) => s.trim());
+        // Parse hostname
+        const hostname = sections[0] || host.name;
+        // Parse uptime
+        const uptime = sections[1] || "unknown";
+        // Parse load average
+        const loadParts = (sections[2] || "0 0 0").split(" ").map(Number);
+        const loadAverage = [
+            loadParts[0] || 0,
+            loadParts[1] || 0,
+            loadParts[2] || 0
+        ];
+        // Parse CPU
+        const cores = parseInt(sections[3] || "1", 10);
+        const cpuUsage = parseFloat(sections[4] || "0");
+        // Parse memory
+        const memParts = (sections[5] || "0 0 0").split(" ").map(Number);
+        const totalMB = memParts[0] || 0;
+        const usedMB = memParts[1] || 0;
+        const freeMB = memParts[2] || 0;
+        const memUsagePercent = totalMB > 0 ? (usedMB / totalMB) * 100 : 0;
+        // Parse disk
+        const diskLines = (sections[6] || "").split("\n").filter((l) => l.trim());
+        const disk = diskLines
+            .map((line) => {
+            const parts = line.trim().split(/\s+/);
+            if (parts.length >= 6) {
+                return {
+                    filesystem: parts[0],
+                    mount: parts[1],
+                    totalGB: parseFloat(parts[2].replace("G", "")) || 0,
+                    usedGB: parseFloat(parts[3].replace("G", "")) || 0,
+                    availGB: parseFloat(parts[4].replace("G", "")) || 0,
+                    usagePercent: parseFloat(parts[5].replace("%", "")) || 0
+                };
+            }
+            return null;
+        })
+            .filter((d) => d !== null);
+        return {
+            hostname,
+            uptime,
+            loadAverage,
+            cpu: {
+                cores,
+                usagePercent: Math.round(cpuUsage * 10) / 10
+            },
+            memory: {
+                totalMB,
+                usedMB,
+                freeMB,
+                usagePercent: Math.round(memUsagePercent * 10) / 10
+            },
+            disk
+        };
+    }
+}
+//# sourceMappingURL=ssh-service.js.map

package/dist/services/ssh-service.js.map

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

package/dist/services/ssh.d.ts

@@ -0,0 +1,37 @@
+import { HostConfig } from "../types.js";
+/**
+ * Sanitize string for safe shell usage
+ * Rejects any potentially dangerous characters
+ */
+export declare function sanitizeForShell(input: string): string;
+/**
+ * Validate host configuration for SSH
+ */
+export declare function validateHostForSsh(host: HostConfig): void;
+/**
+ * Host resource stats from SSH
+ */
+export interface HostResources {
+    hostname: string;
+    uptime: string;
+    loadAverage: [number, number, number];
+    cpu: {
+        cores: number;
+        usagePercent: number;
+    };
+    memory: {
+        totalMB: number;
+        usedMB: number;
+        freeMB: number;
+        usagePercent: number;
+    };
+    disk: Array<{
+        filesystem: string;
+        mount: string;
+        totalGB: number;
+        usedGB: number;
+        availGB: number;
+        usagePercent: number;
+    }>;
+}
+//# sourceMappingURL=ssh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../../src/services/ssh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4BzC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAezD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,IAAI,EAAE,KAAK,CAAC;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ"}

package/dist/services/ssh.js

@@ -0,0 +1,50 @@
+import { SSHService } from "./ssh-service.js";
+import { SSHConnectionPoolImpl } from "./ssh-pool.js";
+/**
+ * Temporary global SSH service for backward compatibility
+ * @deprecated Use ServiceContainer.getSSHService() instead
+ */
+let globalSSHService = null;
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function getGlobalSSHService() {
+    if (!globalSSHService) {
+        const pool = new SSHConnectionPoolImpl({
+            maxConnections: parseInt(process.env.HOMELAB_SSH_MAX_CONNECTIONS || "5", 10),
+            idleTimeoutMs: parseInt(process.env.HOMELAB_SSH_IDLE_TIMEOUT_MS || "60000", 10),
+            connectionTimeoutMs: parseInt(process.env.HOMELAB_SSH_CONNECTION_TIMEOUT_MS || "5000", 10),
+            enableHealthChecks: process.env.HOMELAB_SSH_ENABLE_HEALTH_CHECKS !== "false",
+            healthCheckIntervalMs: parseInt(process.env.HOMELAB_SSH_HEALTH_CHECK_INTERVAL_MS || "30000", 10)
+        });
+        globalSSHService = new SSHService(pool);
+    }
+    return globalSSHService;
+}
+/**
+ * Sanitize string for safe shell usage
+ * Rejects any potentially dangerous characters
+ */
+export function sanitizeForShell(input) {
+    // Only allow alphanumeric, dots, hyphens, underscores, and forward slashes (for paths)
+    if (!/^[a-zA-Z0-9._\-/]+$/.test(input)) {
+        throw new Error(`Invalid characters in input: ${input}`);
+    }
+    return input;
+}
+/**
+ * Validate host configuration for SSH
+ */
+export function validateHostForSsh(host) {
+    // Validate hostname/IP - allow alphanumeric, dots, hyphens, colons (IPv6), and brackets
+    if (host.host && !/^[a-zA-Z0-9.\-:[\]/]+$/.test(host.host)) {
+        throw new Error(`Invalid host format: ${host.host}`);
+    }
+    // Validate SSH user if provided
+    if (host.sshUser && !/^[a-zA-Z0-9_-]+$/.test(host.sshUser)) {
+        throw new Error(`Invalid SSH user: ${host.sshUser}`);
+    }
+    // Validate key path if provided
+    if (host.sshKeyPath && !/^[a-zA-Z0-9._\-/~]+$/.test(host.sshKeyPath)) {
+        throw new Error(`Invalid SSH key path: ${host.sshKeyPath}`);
+    }
+}
+//# sourceMappingURL=ssh.js.map

package/dist/services/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../src/services/ssh.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,IAAI,gBAAgB,GAAsB,IAAI,CAAC;AAE/C,6DAA6D;AAC7D,SAAS,mBAAmB;IAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,qBAAqB,CAAC;YACrC,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,GAAG,EAAE,EAAE,CAAC;YAC5E,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,OAAO,EAAE,EAAE,CAAC;YAC/E,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,MAAM,EAAE,EAAE,CAAC;YAC1F,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,gCAAgC,KAAK,OAAO;YAC5E,qBAAqB,EAAE,QAAQ,CAC7B,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,OAAO,EAC3D,EAAE,CACH;SACF,CAAC,CAAC;QACH,gBAAgB,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,uFAAuF;IACvF,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,wFAAwF;IACxF,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/tools/flux.d.ts

@@ -0,0 +1,14 @@
+import type { ServiceContainer } from '../services/container.js';
+/**
+ * Flux tool handler - Docker infrastructure management
+ *
+ * Handles 4 action categories with 39 total subactions:
+ * - container: 14 subactions (list, start, stop, restart, pause, resume, logs, stats, inspect, search, pull, recreate, exec, top)
+ * - compose: 9 subactions (list, status, up, down, restart, logs, build, pull, recreate)
+ * - docker: 9 subactions (info, df, prune, images, pull, build, rmi, networks, volumes)
+ * - host: 7 subactions (status, resources, info, uptime, services, network, mounts)
+ *
+ * Plus 'help' pseudo-action for auto-generated documentation.
+ */
+export declare function handleFluxTool(input: unknown, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=flux.d.ts.map

package/dist/tools/flux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flux.d.ts","sourceRoot":"","sources":["../../src/tools/flux.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAQjE;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/tools/flux.js

@@ -0,0 +1,86 @@
+// src/tools/flux.ts
+import { FluxSchema } from '../schemas/flux/index.js';
+import { generateHelp, formatHelpMarkdown, formatHelpJson } from '../utils/help.js';
+/**
+ * Flux tool handler - Docker infrastructure management
+ *
+ * Handles 4 action categories with 39 total subactions:
+ * - container: 14 subactions (list, start, stop, restart, pause, resume, logs, stats, inspect, search, pull, recreate, exec, top)
+ * - compose: 9 subactions (list, status, up, down, restart, logs, build, pull, recreate)
+ * - docker: 9 subactions (info, df, prune, images, pull, build, rmi, networks, volumes)
+ * - host: 7 subactions (status, resources, info, uptime, services, network, mounts)
+ *
+ * Plus 'help' pseudo-action for auto-generated documentation.
+ */
+export async function handleFluxTool(input, container) {
+    // Handle help action before schema validation
+    if (typeof input === 'object' && input !== null && 'action' in input && input.action === 'help') {
+        const helpInput = input;
+        const entries = generateHelp(FluxSchema, helpInput.topic);
+        if (helpInput.format === 'json') {
+            return formatHelpJson(entries);
+        }
+        return formatHelpMarkdown(entries);
+    }
+    // Validate input against Flux schema
+    const validated = FluxSchema.parse(input);
+    // Route to appropriate handler based on action
+    switch (validated.action) {
+        case 'container':
+            return handleContainerAction(validated, container);
+        case 'compose':
+            return handleComposeAction(validated, container);
+        case 'docker':
+            return handleDockerAction(validated, container);
+        case 'host':
+            return handleHostAction(validated, container);
+        default:
+            // Zod validation should prevent reaching here
+            throw new Error(`Unknown action: ${validated.action}`);
+    }
+}
+/**
+ * Placeholder handler for container actions
+ * Will be implemented in Task 16
+ */
+function handleContainerAction(input, _container) {
+    // Type guard to ensure we have container action
+    if (input.action !== 'container') {
+        throw new Error(`Invalid action for container handler: ${input.action}`);
+    }
+    throw new Error(`Handler not implemented: container:${input.subaction}`);
+}
+/**
+ * Placeholder handler for compose actions
+ * Will be implemented in Task 17
+ */
+function handleComposeAction(input, _container) {
+    // Type guard to ensure we have compose action
+    if (input.action !== 'compose') {
+        throw new Error(`Invalid action for compose handler: ${input.action}`);
+    }
+    throw new Error(`Handler not implemented: compose:${input.subaction}`);
+}
+/**
+ * Placeholder handler for docker actions
+ * Will be implemented in Task 18
+ */
+function handleDockerAction(input, _container) {
+    // Type guard to ensure we have docker action
+    if (input.action !== 'docker') {
+        throw new Error(`Invalid action for docker handler: ${input.action}`);
+    }
+    throw new Error(`Handler not implemented: docker:${input.subaction}`);
+}
+/**
+ * Placeholder handler for host actions
+ * Will be implemented in Task 19
+ */
+function handleHostAction(input, _container) {
+    // Type guard to ensure we have host action
+    if (input.action !== 'host') {
+        throw new Error(`Invalid action for host handler: ${input.action}`);
+    }
+    throw new Error(`Handler not implemented: host:${input.subaction}`);
+}
+//# sourceMappingURL=flux.js.map