craftclose 0.1.0

package/dist/connectors/ssh.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * SSH Connector — Connect to Minecraft servers via SSH
+ *
+ * Handles health checks (CPU, RAM, disk), log tailing, and command execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SshConnector = void 0;
+const ssh2_1 = require("ssh2");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+/** Resolve ~ to actual home directory in a path */
+function resolvePath(p) {
+    if (p.startsWith("~/") || p === "~") {
+        return p.replace("~", (0, node_os_1.homedir)());
+    }
+    return p;
+}
+/** Parse "used total percent" output into {used, total, percent} or null */
+function parseThreePartMetric(stdout) {
+    const parts = stdout.split(" ");
+    if (parts.length !== 3)
+        return null;
+    const used = Number.parseInt(parts[0], 10);
+    const total = Number.parseInt(parts[1], 10);
+    const percent = Number.parseFloat(parts[2]);
+    if (Number.isNaN(used) || Number.isNaN(total) || Number.isNaN(percent))
+        return null;
+    return { used, total, percent };
+}
+class SshConnector {
+    options;
+    conn = null;
+    connected = false;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Ensure the SSH client is connected. Reuses existing connection. */
+    async ensureConnected() {
+        if (this.conn && this.connected) {
+            return this.conn;
+        }
+        const { host, config, timeout } = this.options;
+        const conn = new ssh2_1.Client();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                conn.destroy();
+                reject(new Error(`SSH connection to ${host} timed out after ${timeout ?? 10000}ms`));
+            }, timeout ?? 10000);
+            conn.on("ready", () => {
+                clearTimeout(timer);
+                this.conn = conn;
+                this.connected = true;
+                resolve(conn);
+            });
+            conn.on("error", (err) => {
+                clearTimeout(timer);
+                this.connected = false;
+                reject(new Error(`SSH connection to ${host} failed: ${err.message}`));
+            });
+            conn.on("close", () => {
+                this.connected = false;
+                this.conn = null;
+            });
+            let privateKey;
+            if (config.key) {
+                try {
+                    privateKey = (0, node_fs_1.readFileSync)(resolvePath(config.key));
+                }
+                catch {
+                    // Key file not found — fall through to password auth
+                }
+            }
+            conn.connect({
+                host: config.host ?? host,
+                port: config.port ?? 22,
+                username: config.user,
+                privateKey,
+                password: config.password,
+                readyTimeout: timeout ?? 10000,
+            });
+        });
+    }
+    /**
+     * Execute a single command over SSH with a per-command timeout.
+     */
+    async execCommand(command, cmdTimeout) {
+        const conn = await this.ensureConnected();
+        const effectiveTimeout = cmdTimeout ?? this.options.timeout ?? 10000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`SSH command timed out after ${effectiveTimeout}ms: ${command}`));
+            }, effectiveTimeout);
+            conn.exec(command, (err, stream) => {
+                if (err) {
+                    clearTimeout(timer);
+                    reject(new Error(`SSH exec error: ${err.message}`));
+                    return;
+                }
+                let stdout = "";
+                let stderr = "";
+                stream.on("data", (data) => {
+                    stdout += data.toString();
+                });
+                stream.stderr.on("data", (data) => {
+                    stderr += data.toString();
+                });
+                stream.on("close", (code) => {
+                    clearTimeout(timer);
+                    resolve({ stdout: stdout.trim(), stderr: stderr.trim(), code: code ?? 0 });
+                });
+            });
+        });
+    }
+    /**
+     * Test SSH connectivity.
+     */
+    async testConnection() {
+        try {
+            const result = await this.execCommand("echo ok");
+            return result.stdout === "ok";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get server health metrics via SSH.
+     */
+    async getHealth() {
+        const result = {
+            server: this.options.serverName,
+            timestamp: new Date(),
+        };
+        // Check for the server by container/server name first, then fall back to generic MC process detection
+        const serverName = this.options.serverName;
+        const processCmd = `docker ps --format '{{.Names}} {{.Status}}' 2>/dev/null | grep -i '${serverName}' || docker ps --format '{{.Names}} {{.Status}}' 2>/dev/null | grep -iE 'paper|minecraft|spigot' || pgrep -fa 'java.*minecraft\\|java.*paper\\|java.*spigot'`;
+        // Run all health commands in parallel
+        const [cpuResult, ramResult, diskResult, processResult, uptimeResult] = await Promise.allSettled([
+            this.execCommand("top -bn1 | grep 'Cpu(s)' | awk '{print $2}'"),
+            this.execCommand("free -m | awk '/Mem:/ {printf \"%d %d %.1f\", $3, $2, $3/$2*100}'"),
+            this.execCommand("df -m / | awk 'NR==2 {printf \"%d %d %.1f\", $3, $2, $5}'"),
+            this.execCommand(processCmd),
+            this.execCommand("uptime -p"),
+        ]);
+        // Parse CPU
+        if (cpuResult.status === "fulfilled" && cpuResult.value.stdout) {
+            const cpu = Number.parseFloat(cpuResult.value.stdout.replace(",", "."));
+            if (!Number.isNaN(cpu)) {
+                result.cpu = cpu;
+            }
+        }
+        // Parse RAM
+        if (ramResult.status === "fulfilled" && ramResult.value.stdout) {
+            result.ram = parseThreePartMetric(ramResult.value.stdout) ?? undefined;
+        }
+        // Parse Disk
+        if (diskResult.status === "fulfilled" && diskResult.value.stdout) {
+            result.disk = parseThreePartMetric(diskResult.value.stdout) ?? undefined;
+        }
+        // Parse process check — if we got output, the process is running
+        result.online = processResult.status === "fulfilled" && processResult.value.code === 0 && processResult.value.stdout.length > 0;
+        // Parse uptime
+        if (uptimeResult.status === "fulfilled" && uptimeResult.value.stdout) {
+            result.uptime = uptimeResult.value.stdout.replace(/^up\s+/, "");
+        }
+        return result;
+    }
+    /**
+     * Read the last N lines of the server log.
+     */
+    async tailLog(lines = 200) {
+        // If a log path is configured, use it directly
+        if (this.options.logPath) {
+            const result = await this.execCommand(`tail -n ${lines} ${this.options.logPath}`);
+            if (result.code === 0) {
+                return result.stdout;
+            }
+        }
+        // Try Docker logs first (blueth-stable container)
+        const dockerContainers = ["blueth-stable", "minecraft", "paper", "mc"];
+        for (const container of dockerContainers) {
+            try {
+                const result = await this.execCommand(`docker logs --tail ${lines} ${container} 2>&1`);
+                if (result.code === 0 && result.stdout) {
+                    return result.stdout;
+                }
+            }
+            catch {
+                // Container doesn't exist, try next
+            }
+        }
+        // Try common bare-metal log paths
+        const logPaths = [
+            "~/minecraft/logs/latest.log",
+            "/opt/minecraft/logs/latest.log",
+            "/home/minecraft/logs/latest.log",
+            "/srv/minecraft/logs/latest.log",
+        ];
+        for (const logPath of logPaths) {
+            try {
+                const result = await this.execCommand(`tail -n ${lines} ${logPath}`);
+                if (result.code === 0 && result.stdout) {
+                    return result.stdout;
+                }
+            }
+            catch {
+                // Path doesn't exist, try next
+            }
+        }
+        throw new Error("Could not find server log. Set log_path in config.");
+    }
+    /**
+     * Execute a command on the remote server (e.g., restart).
+     */
+    async exec(command) {
+        return this.execCommand(command);
+    }
+    /**
+     * Create a local port forward through the SSH connection.
+     * Returns the local port number and a close function.
+     */
+    async createTunnel(remoteHost, remotePort) {
+        const conn = await this.ensureConnected();
+        const net = await import("node:net");
+        return new Promise((resolve, reject) => {
+            const server = net.createServer((socket) => {
+                conn.forwardOut("127.0.0.1", 0, remoteHost, remotePort, (err, stream) => {
+                    if (err) {
+                        socket.destroy();
+                        return;
+                    }
+                    socket.pipe(stream).pipe(socket);
+                });
+            });
+            server.listen(0, "127.0.0.1", () => {
+                const addr = server.address();
+                if (!addr || typeof addr === "string") {
+                    reject(new Error("Failed to bind tunnel"));
+                    return;
+                }
+                resolve({
+                    localPort: addr.port,
+                    close: () => server.close(),
+                });
+            });
+            server.on("error", reject);
+        });
+    }
+    /**
+     * Execute a Minecraft console command via docker exec.
+     * Useful when RCON isn't configured at all.
+     */
+    async dockerRcon(containerName, command) {
+        // Sanitize inputs to prevent command injection
+        const safeContainer = containerName.replaceAll(/[^a-zA-Z0-9_.-]/g, "");
+        const safeCommand = command.replaceAll("'", String.raw `'\''`);
+        const result = await this.execCommand(`docker exec ${safeContainer} rcon-cli ${safeCommand} 2>/dev/null || docker exec -i ${safeContainer} mc-send-to-console '${safeCommand}' 2>/dev/null`);
+        return result.stdout.trim();
+    }
+    /**
+     * Close the SSH connection.
+     */
+    async disconnect() {
+        if (this.conn) {
+            this.conn.end();
+            this.conn = null;
+            this.connected = false;
+        }
+    }
+}
+exports.SshConnector = SshConnector;
+//# sourceMappingURL=ssh.js.map

package/dist/connectors/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../src/connectors/ssh.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,+BAA8B;AAC9B,qCAAuC;AACvC,qCAAkC;AAalC,mDAAmD;AACnD,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAA,iBAAO,GAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,4EAA4E;AAC5E,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED,MAAa,YAAY;IACN,OAAO,CAAsB;IACtC,IAAI,GAAkB,IAAI,CAAC;IAC3B,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,sEAAsE;IAC9D,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,aAAM,EAAE,CAAC;QAE1B,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,oBAAoB,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;YACvF,CAAC,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;YAErB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACnB,CAAC,CAAC,CAAC;YAEH,IAAI,UAA8B,CAAC;YACnC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,UAAU,GAAG,IAAA,sBAAY,EAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrD,CAAC;gBAAC,MAAM,CAAC;oBACP,qDAAqD;gBACvD,CAAC;YACH,CAAC;YAED,IAAI,CAAC,OAAO,CAAC;gBACX,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBACvB,QAAQ,EAAE,MAAM,CAAC,IAAI;gBACrB,UAAU;gBACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,YAAY,EAAE,OAAO,IAAI,KAAK;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,UAAmB;QAC5D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,gBAAgB,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QAErE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,gBAAgB,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAErB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACjC,IAAI,GAAG,EAAE,CAAC;oBACR,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACpD,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,IAAI,MAAM,GAAG,EAAE,CAAC;gBAEhB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;oBACjC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,CAAC,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;oBACxC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,CAAC,CAAC,CAAC;gBACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;oBACzC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7E,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAA+B;YACzC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,sGAAsG;QACtG,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3C,MAAM,UAAU,GAAG,sEAAsE,UAAU,8JAA8J,CAAC;QAElQ,sCAAsC;QACtC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YAC/F,IAAI,CAAC,WAAW,CAAC,6CAA6C,CAAC;YAC/D,IAAI,CAAC,WAAW,CAAC,mEAAmE,CAAC;YACrF,IAAI,CAAC,WAAW,CAAC,2DAA2D,CAAC;YAC7E,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;YAC5B,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;SAC9B,CAAC,CAAC;QAEH,YAAY;QACZ,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;YACnB,CAAC;QACH,CAAC;QAED,YAAY;QACZ,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QACzE,CAAC;QAED,aAAa;QACb,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,GAAG,oBAAoB,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QAC3E,CAAC;QAED,iEAAiE;QACjE,MAAM,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,KAAK,WAAW,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhI,eAAe;QACf,IAAI,YAAY,CAAC,MAAM,KAAK,WAAW,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACrE,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,GAAG;QAC/B,+CAA+C;QAC/C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,MAAM,gBAAgB,GAAG,CAAC,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACvE,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,sBAAsB,KAAK,IAAI,SAAS,OAAO,CAAC,CAAC;gBACvF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBACvC,OAAO,MAAM,CAAC,MAAM,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;YACtC,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,MAAM,QAAQ,GAAG;YACf,6BAA6B;YAC7B,gCAAgC;YAChC,iCAAiC;YACjC,gCAAgC;SACjC,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;gBACrE,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBACvC,OAAO,MAAM,CAAC,MAAM,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,UAAkB;QACvD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAErC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;gBACzC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;oBACtE,IAAI,GAAG,EAAE,CAAC;wBAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAAC,OAAO;oBAAC,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;gBACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAC9F,OAAO,CAAC;oBACN,SAAS,EAAE,IAAI,CAAC,IAAI;oBACpB,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;iBAC5B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,aAAqB,EAAE,OAAe;QACrD,+CAA+C;QAC/C,MAAM,aAAa,GAAG,aAAa,CAAC,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CACnC,eAAe,aAAa,aAAa,WAAW,kCAAkC,aAAa,wBAAwB,WAAW,eAAe,CACtJ,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AA5QD,oCA4QC"}

package/dist/craft-close-skill.d.ts

@@ -0,0 +1,106 @@
+/**
+ * CraftClose Skill — Main orchestrator
+ *
+ * Coordinates monitoring, crash detection, pattern matching, AI analysis, and alerting.
+ */
+import type { CraftCloseConfig, HealthCheckResult } from "./types.js";
+import { HistoryTracker } from "./history.js";
+export declare class CraftCloseSkill {
+    private readonly config;
+    private monitoringInterval;
+    private readonly restartCounts;
+    private readonly telegramAlert;
+    private readonly discordAlert;
+    private readonly serverStates;
+    private readonly activeIncidents;
+    private readonly history;
+    private readonly aiAnalyzer;
+    private lastResults;
+    constructor(config: CraftCloseConfig, dbPath?: string);
+    /**
+     * Start monitoring all configured servers.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop monitoring.
+     */
+    stop(): void;
+    /**
+     * Get a formatted status string for all servers (for chat/CLI display).
+     */
+    getStatus(): Promise<string>;
+    /** Get the most recent health check results (from memory, not a new check) */
+    getLastResults(): HealthCheckResult[];
+    /** Get the config (without sensitive fields — callers handle filtering) */
+    getConfig(): CraftCloseConfig;
+    /** Get access to the history tracker for querying */
+    getHistoryTracker(): HistoryTracker;
+    /**
+     * Run a single health check across all servers.
+     */
+    checkAllServers(): Promise<HealthCheckResult[]>;
+    /**
+     * Process a health check result: recovery detection, crash handling, TPS warnings.
+     */
+    private processCheckResult;
+    /**
+     * Attempt SSH health check, merging results into the given HealthCheckResult.
+     * Returns the SshConnector for cleanup.
+     */
+    private trySshHealth;
+    /**
+     * Attempt RCON health check, merging results into the given HealthCheckResult.
+     * Returns the RconConnector for cleanup.
+     * If RCON host is localhost and SSH is available, tunnels through SSH.
+     */
+    private tryRconHealth;
+    /**
+     * Attempt Pterodactyl health check, merging results into the given HealthCheckResult.
+     */
+    private tryPteroHealth;
+    /**
+     * Attempt Docker exec fallback for TPS/players when no RCON is configured.
+     */
+    private tryDockerRcon;
+    /**
+     * Check a single server's health.
+     */
+    checkServer(serverName: string): Promise<HealthCheckResult>;
+    /**
+     * Handle a server that's detected as down.
+     * Includes crash detection, pattern matching, dedup, restart, and alerting.
+     */
+    private handleServerDown;
+    /**
+     * Classify crash type based on available data.
+     */
+    private classifyCrashType;
+    /**
+     * Enrich a crash event with log tail pattern matching (best-effort).
+     * Tries Pterodactyl file read first, then SSH tail as fallback.
+     */
+    private enrichCrashWithPatterns;
+    /**
+     * Attempt to fetch recent log text via Pterodactyl or SSH.
+     */
+    private fetchCrashLog;
+    /**
+     * Handle low TPS warning with deduplication.
+     */
+    private handleTpsWarning;
+    /**
+     * Circuit breaker: check if we're allowed to restart.
+     * Max 3 restarts per 10-minute window.
+     */
+    private canRestart;
+    /**
+     * Restart a server via Pterodactyl power action or SSH restart command.
+     */
+    private restartServer;
+    /**
+     * Send an alert to configured channels (Telegram, Discord).
+     * Alert failures are caught and logged — they never stop monitoring.
+     */
+    private sendAlert;
+}
+//# sourceMappingURL=craft-close-skill.d.ts.map

package/dist/craft-close-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-close-skill.d.ts","sourceRoot":"","sources":["../src/craft-close-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,kBAAkB,CAA+C;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgE;IAG9F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAG1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoF;IAGpH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAGzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAGtD,OAAO,CAAC,WAAW,CAA2B;gBAElC,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM;IAoBrD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAelC,8EAA8E;IAC9E,cAAc,IAAI,iBAAiB,EAAE;IAIrC,2EAA2E;IAC3E,SAAS,IAAI,gBAAgB;IAI7B,qDAAqD;IACrD,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA0BrD;;OAEG;YACW,kBAAkB;IA4BhC;;;OAGG;YACW,YAAY;IA8B1B;;;;OAIG;YACW,aAAa;IAqD3B;;OAEG;YACW,cAAc;IA4B5B;;OAEG;YACW,aAAa;IA0B3B;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4CjE;;;OAGG;YACW,gBAAgB;IAyE9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;OAGG;YACW,uBAAuB;IA4BrC;;OAEG;YACW,aAAa;IAoC3B;;OAEG;YACW,gBAAgB;IA2B9B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;YACW,aAAa;IA2C3B;;;OAGG;YACW,SAAS;CAuBxB"}