@ebowwa/terminal 0.2.1 → 0.3.0

package/src/exec.js

@@ -1,183 +0,0 @@
-"use strict";
-/**
- * SSH command execution functions
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execSSHParallel = execSSHParallel;
-exports.testSSHConnection = testSSHConnection;
-var client_js_1 = require("./client.js");
-var pool_js_1 = require("./pool.js");
-/**
- * Execute multiple SSH commands in parallel using multiple connections
- *
- * DESIGN DECISION: Multiple Connections vs Single Connection
- * ===========================================================
- *
- * We use MULTIPLE SSH connections to avoid channel saturation issues.
- * SSH servers typically limit concurrent channels per connection (~10).
- * When executing 9+ commands in parallel, we can exceed this limit.
- *
- * Solution: Distribute commands across multiple pooled connections.
- * Each connection handles a subset of commands, staying within channel limits.
- *
- * DESIGN DECISION: Promise.allSettled() vs Promise.all()
- * ======================================================
- *
- * We use Promise.allSettled() instead of Promise.all() for a critical reason:
- * Resource monitoring should be RESILIENT. If one command fails (e.g., GPU
- * query on a CPU-only server), we still want results from all other commands.
- *
- * Example scenario:
- * - CPU, memory, disk commands: succeed
- * - GPU command: fails (no NVIDIA GPU)
- * - Network command: succeeds
- *
- * With Promise.all(): entire batch fails, no metrics collected
- * With Promise.allSettled(): we get 6/7 metrics, GPU returns "0" fallback
- *
- * ERROR HANDLING:
- * ==============
- * 1. Individual command failures are logged to console
- * 2. Failed commands return "0" as fallback (matches execSSH default)
- * 3. The function always completes successfully (never throws)
- * 4. Calling code can check for "0" values to detect failures
- */
-function execSSHParallel(commands, options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var entries, pool, numCommands, numConnections, connections, connectionPromises, allSettledResults, results, _i, allSettledResults_1, connResults, _a, connResults_1, result;
-        var _this = this;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    entries = Object.entries(commands);
-                    pool = (0, pool_js_1.getSSHPool)();
-                    numCommands = entries.length;
-                    numConnections = Math.min(numCommands, 4);
-                    return [4 /*yield*/, pool.getConnections(options, numConnections)];
-                case 1:
-                    connections = _b.sent();
-                    connectionPromises = connections.map(function (ssh, connIndex) {
-                        // Assign commands to this connection
-                        var assignedCommands = entries.filter(function (_, i) { return i % numConnections === connIndex; });
-                        // Execute all assigned commands on this connection
-                        return Promise.allSettled(assignedCommands.map(function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
-                            var result, error_1;
-                            var key = _b[0], cmd = _b[1];
-                            return __generator(this, function (_c) {
-                                switch (_c.label) {
-                                    case 0:
-                                        _c.trys.push([0, 2, , 3]);
-                                        return [4 /*yield*/, ssh.execCommand(cmd, {
-                                                execOptions: {
-                                                    timeout: (options.timeout || 5) * 1000,
-                                                },
-                                            })];
-                                    case 1:
-                                        result = _c.sent();
-                                        // If we have stderr but no stdout, the command failed
-                                        if (result.stderr && !result.stdout) {
-                                            throw new Error(result.stderr);
-                                        }
-                                        return [2 /*return*/, [key, result.stdout.trim()]];
-                                    case 2:
-                                        error_1 = _c.sent();
-                                        // Log the error with full details including cause
-                                        console.error("[execSSHParallel] Command \"".concat(key, "\" failed:"), error_1 instanceof Error ? error_1.message : error_1);
-                                        // Log the underlying cause if available
-                                        if (error_1 instanceof Error && error_1.cause) {
-                                            console.error("[execSSHParallel] Command \"".concat(key, "\" cause:"), error_1.cause);
-                                        }
-                                        return [2 /*return*/, [key, "0"]]; // Fallback value
-                                    case 3: return [2 /*return*/];
-                                }
-                            });
-                        }); }));
-                    });
-                    return [4 /*yield*/, Promise.all(connectionPromises)];
-                case 2:
-                    allSettledResults = _b.sent();
-                    results = [];
-                    for (_i = 0, allSettledResults_1 = allSettledResults; _i < allSettledResults_1.length; _i++) {
-                        connResults = allSettledResults_1[_i];
-                        for (_a = 0, connResults_1 = connResults; _a < connResults_1.length; _a++) {
-                            result = connResults_1[_a];
-                            if (result.status === "fulfilled") {
-                                results.push(__spreadArray([], result.value, true));
-                            }
-                            // Rejected promises are already logged and return "0" above
-                        }
-                    }
-                    return [2 /*return*/, Object.fromEntries(results)];
-            }
-        });
-    });
-}
-/**
- * Test SSH connection to a remote server
- * @param options - SSH connection options
- * @returns True if connection successful
- */
-function testSSHConnection(options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var _a;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0:
-                    _b.trys.push([0, 2, , 3]);
-                    return [4 /*yield*/, (0, client_js_1.execSSH)('echo "connection_test"', options)];
-                case 1:
-                    _b.sent();
-                    return [2 /*return*/, true];
-                case 2:
-                    _a = _b.sent();
-                    return [2 /*return*/, false];
-                case 3: return [2 /*return*/];
-            }
-        });
-    });
-}