labgate 0.5.27 → 0.5.29

package/dist/lib/web-terminal.d.ts

@@ -0,0 +1,54 @@
+export type WebTerminalAgent = 'claude' | 'codex';
+export type WebTerminalStatus = 'running' | 'exited' | 'failed';
+export interface WebTerminalRecord {
+    id: string;
+    agent: WebTerminalAgent;
+    workdir: string;
+    node: string;
+    tmuxSession: string;
+    createdAt: string;
+    updatedAt: string;
+    status: WebTerminalStatus;
+    exitCode: number | null;
+    error: string | null;
+}
+export interface WebTerminalExitInfo {
+    exitCode: number;
+    finishedAt: string;
+}
+export declare function isValidWebTerminalId(raw: string): boolean;
+export declare function getWebTerminalsDir(): string;
+export declare function getWebTerminalRecordPath(id: string): string;
+export declare function getWebTerminalExitPath(id: string): string;
+export declare function ensureWebTerminalsDir(): void;
+export declare function tmuxSessionNameForWebTerminalId(id: string): string;
+export declare function createWebTerminalRecord(input: {
+    id: string;
+    agent: WebTerminalAgent;
+    workdir: string;
+}): WebTerminalRecord;
+export declare function writeWebTerminalRecord(record: WebTerminalRecord): void;
+export declare function clearWebTerminalExitInfo(id: string): void;
+export declare function readWebTerminalRecord(id: string): WebTerminalRecord | null;
+export declare function listWebTerminalRecords(): WebTerminalRecord[];
+export declare function resolveWebTerminalRecord(idOrPrefix: string): {
+    record: WebTerminalRecord | null;
+    matches: WebTerminalRecord[];
+};
+export declare function updateWebTerminalRecordStatus(id: string, next: {
+    status: WebTerminalStatus;
+    exitCode?: number | null;
+    error?: string | null;
+}): WebTerminalRecord | null;
+export declare function readWebTerminalExitInfo(id: string): WebTerminalExitInfo | null;
+export declare function getTmuxBinary(): Promise<string>;
+export declare function ensureTmuxAvailable(): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function hasTmuxSession(sessionName: string): Promise<boolean>;
+export declare function startTmuxWebTerminalSession(record: WebTerminalRecord, cliEntrypoint: string): Promise<void>;
+export declare function killTmuxSession(sessionName: string): Promise<void>;
+export declare function sanitizeExistingWebTerminalRecords(): void;

package/dist/lib/web-terminal.js

@@ -0,0 +1,327 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidWebTerminalId = isValidWebTerminalId;
+exports.getWebTerminalsDir = getWebTerminalsDir;
+exports.getWebTerminalRecordPath = getWebTerminalRecordPath;
+exports.getWebTerminalExitPath = getWebTerminalExitPath;
+exports.ensureWebTerminalsDir = ensureWebTerminalsDir;
+exports.tmuxSessionNameForWebTerminalId = tmuxSessionNameForWebTerminalId;
+exports.createWebTerminalRecord = createWebTerminalRecord;
+exports.writeWebTerminalRecord = writeWebTerminalRecord;
+exports.clearWebTerminalExitInfo = clearWebTerminalExitInfo;
+exports.readWebTerminalRecord = readWebTerminalRecord;
+exports.listWebTerminalRecords = listWebTerminalRecords;
+exports.resolveWebTerminalRecord = resolveWebTerminalRecord;
+exports.updateWebTerminalRecordStatus = updateWebTerminalRecordStatus;
+exports.readWebTerminalExitInfo = readWebTerminalExitInfo;
+exports.getTmuxBinary = getTmuxBinary;
+exports.ensureTmuxAvailable = ensureTmuxAvailable;
+exports.hasTmuxSession = hasTmuxSession;
+exports.startTmuxWebTerminalSession = startTmuxWebTerminalSession;
+exports.killTmuxSession = killTmuxSession;
+exports.sanitizeExistingWebTerminalRecords = sanitizeExistingWebTerminalRecords;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const config_js_1 = require("./config.js");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const TMUX_BIN_OVERRIDE_ENV = 'LABGATE_TMUX_BIN';
+const TMUX_BIN_CANDIDATES = ['tmux', '/opt/homebrew/bin/tmux', '/usr/local/bin/tmux', '/usr/bin/tmux'];
+let cachedTmuxBinary = null;
+function normalizeId(raw) {
+    return (raw || '').trim();
+}
+function isValidWebTerminalId(raw) {
+    const id = normalizeId(raw);
+    return /^wt-[a-z0-9_-]{4,80}$/i.test(id);
+}
+function getWebTerminalsDir() {
+    return (0, path_1.join)(config_js_1.LABGATE_DIR, 'web-terminals');
+}
+function getWebTerminalRecordPath(id) {
+    return (0, path_1.join)(getWebTerminalsDir(), `${id}.json`);
+}
+function getWebTerminalExitPath(id) {
+    return (0, path_1.join)(getWebTerminalsDir(), `${id}.exit.json`);
+}
+function ensureWebTerminalsDir() {
+    (0, config_js_1.ensurePrivateDir)(getWebTerminalsDir());
+}
+function tmuxSessionNameForWebTerminalId(id) {
+    const safe = id.replace(/[^a-zA-Z0-9_-]/g, '').slice(0, 64) || 'session';
+    return `labgate-${safe}`;
+}
+function createWebTerminalRecord(input) {
+    const now = new Date().toISOString();
+    return {
+        id: input.id,
+        agent: input.agent,
+        workdir: input.workdir,
+        node: (0, os_1.hostname)(),
+        tmuxSession: tmuxSessionNameForWebTerminalId(input.id),
+        createdAt: now,
+        updatedAt: now,
+        status: 'running',
+        exitCode: null,
+        error: null,
+    };
+}
+function writeWebTerminalRecord(record) {
+    ensureWebTerminalsDir();
+    const target = getWebTerminalRecordPath(record.id);
+    const temp = `${target}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        (0, fs_1.writeFileSync)(temp, JSON.stringify(record, null, 2) + '\n', { encoding: 'utf-8', mode: config_js_1.PRIVATE_FILE_MODE });
+        (0, config_js_1.ensurePrivateFile)(temp);
+        (0, fs_1.renameSync)(temp, target);
+        (0, config_js_1.ensurePrivateFile)(target);
+    }
+    finally {
+        try {
+            if ((0, fs_1.existsSync)(temp))
+                (0, fs_1.unlinkSync)(temp);
+        }
+        catch {
+            // Best effort cleanup.
+        }
+    }
+}
+function clearWebTerminalExitInfo(id) {
+    const path = getWebTerminalExitPath(id);
+    try {
+        if ((0, fs_1.existsSync)(path))
+            (0, fs_1.unlinkSync)(path);
+    }
+    catch {
+        // Best effort.
+    }
+}
+function readWebTerminalRecord(id) {
+    if (!isValidWebTerminalId(id))
+        return null;
+    const path = getWebTerminalRecordPath(id);
+    if (!(0, fs_1.existsSync)(path))
+        return null;
+    try {
+        const raw = (0, fs_1.readFileSync)(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function listWebTerminalRecords() {
+    ensureWebTerminalsDir();
+    const dir = getWebTerminalsDir();
+    const out = [];
+    for (const file of (0, fs_1.readdirSync)(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const parsed = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(dir, file), 'utf-8'));
+            if (!parsed || typeof parsed !== 'object' || !isValidWebTerminalId(parsed.id || ''))
+                continue;
+            out.push(parsed);
+        }
+        catch {
+            // Skip malformed records.
+        }
+    }
+    out.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    return out;
+}
+function resolveWebTerminalRecord(idOrPrefix) {
+    const query = normalizeId(idOrPrefix);
+    if (!query)
+        return { record: null, matches: [] };
+    if (isValidWebTerminalId(query)) {
+        const exact = readWebTerminalRecord(query);
+        if (exact)
+            return { record: exact, matches: [exact] };
+    }
+    const all = listWebTerminalRecords();
+    const matches = all.filter((r) => r.id.startsWith(query));
+    return { record: matches.length === 1 ? matches[0] : null, matches };
+}
+function updateWebTerminalRecordStatus(id, next) {
+    const existing = readWebTerminalRecord(id);
+    if (!existing)
+        return null;
+    const updated = {
+        ...existing,
+        status: next.status,
+        exitCode: next.exitCode !== undefined ? next.exitCode : existing.exitCode,
+        error: next.error !== undefined ? next.error : existing.error,
+        updatedAt: new Date().toISOString(),
+    };
+    writeWebTerminalRecord(updated);
+    return updated;
+}
+function readWebTerminalExitInfo(id) {
+    if (!isValidWebTerminalId(id))
+        return null;
+    const path = getWebTerminalExitPath(id);
+    if (!(0, fs_1.existsSync)(path))
+        return null;
+    try {
+        const raw = (0, fs_1.readFileSync)(path, 'utf-8');
+        const parsed = JSON.parse(raw || '{}');
+        const code = Number(parsed.exitCode);
+        const finishedAt = typeof parsed.finishedAt === 'string' ? parsed.finishedAt : '';
+        if (!Number.isFinite(code))
+            return null;
+        return {
+            exitCode: Math.trunc(code),
+            finishedAt: finishedAt || new Date().toISOString(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function tmuxErrorDetail(err) {
+    return [
+        err?.message,
+        err?.stderr,
+        err?.stdout,
+        err?.cause?.message,
+        err?.cause?.stderr,
+        err?.cause?.stdout,
+    ].filter((part) => typeof part === 'string').join('\n');
+}
+function isMissingTmuxSessionError(err) {
+    return /(can't find session|no such session)/i.test(tmuxErrorDetail(err));
+}
+async function getTmuxBinary() {
+    const override = (process.env[TMUX_BIN_OVERRIDE_ENV] || '').trim();
+    if (override) {
+        try {
+            await execFileAsync(override, ['-V'], { timeout: 5_000 });
+            cachedTmuxBinary = override;
+            return override;
+        }
+        catch (err) {
+            const detail = err?.message ?? String(err);
+            throw new Error(`${TMUX_BIN_OVERRIDE_ENV} is set to "${override}" but unusable: ${detail}`);
+        }
+    }
+    if (cachedTmuxBinary) {
+        try {
+            await execFileAsync(cachedTmuxBinary, ['-V'], { timeout: 5_000 });
+            return cachedTmuxBinary;
+        }
+        catch {
+            cachedTmuxBinary = null;
+        }
+    }
+    let lastError = 'spawn tmux ENOENT';
+    for (const candidate of TMUX_BIN_CANDIDATES) {
+        try {
+            await execFileAsync(candidate, ['-V'], { timeout: 5_000 });
+            cachedTmuxBinary = candidate;
+            return candidate;
+        }
+        catch (err) {
+            lastError = err?.message ?? String(err);
+        }
+    }
+    throw new Error(lastError);
+}
+async function ensureTmuxAvailable() {
+    try {
+        await getTmuxBinary();
+        return { ok: true };
+    }
+    catch (err) {
+        const detail = err?.message ?? String(err);
+        const guidance = [
+            'tmux is required but unavailable.',
+            `Detected error: ${detail}`,
+            'HPC quick fixes:',
+            '  1. If your cluster uses environment modules: `module avail tmux` then `module load tmux`',
+            '  2. Verify availability: `tmux -V`',
+            '  3. If still missing, ask your platform admin to provide tmux on login/compute node PATH',
+            `  4. If tmux exists but PATH differs, set ${TMUX_BIN_OVERRIDE_ENV}=<absolute-tmux-path> before \`labgate ui\``,
+        ].join('\n');
+        return { ok: false, error: guidance };
+    }
+}
+async function hasTmuxSession(sessionName) {
+    try {
+        const tmuxBin = await getTmuxBinary();
+        await execFileAsync(tmuxBin, ['has-session', '-t', sessionName], { timeout: 5_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function startTmuxWebTerminalSession(record, cliEntrypoint) {
+    const tmuxBin = await getTmuxBinary();
+    clearWebTerminalExitInfo(record.id);
+    const launchInner = [
+        `LABGATE_WEB_TERMINAL_ID=${shellQuote(record.id)}`,
+        shellQuote(process.execPath),
+        shellQuote(cliEntrypoint),
+        shellQuote(record.agent),
+        shellQuote(record.workdir),
+        '--no-footer',
+    ].join(' ');
+    const exitsDir = shellQuote(getWebTerminalsDir());
+    const exitFile = shellQuote(getWebTerminalExitPath(record.id));
+    const launchScript = [
+        'set +e',
+        `${launchInner}`,
+        'labgate_exit_code=$?',
+        `mkdir -p ${exitsDir}`,
+        `printf '{"exitCode":%s,"finishedAt":"%s"}\\n' "$labgate_exit_code" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > ${exitFile}`,
+        `chmod 600 ${exitFile} 2>/dev/null || true`,
+        'exit "$labgate_exit_code"',
+    ].join('; ');
+    const shell = (process.env.SHELL || '/bin/bash').trim() || '/bin/bash';
+    const launch = `${shellQuote(shell)} -lc ${shellQuote(launchScript)}`;
+    await execFileAsync(tmuxBin, ['new-session', '-d', '-s', record.tmuxSession, '-c', record.workdir, launch], { timeout: 120_000 });
+    try {
+        // Web terminal sessions should not render tmux status/footer lines.
+        await execFileAsync(tmuxBin, ['set-option', '-t', record.tmuxSession, 'status', 'off'], { timeout: 10_000 });
+    }
+    catch (err) {
+        // If the command exited immediately, the session may already be gone.
+        if (!isMissingTmuxSessionError(err))
+            throw err;
+    }
+}
+async function killTmuxSession(sessionName) {
+    const tmuxBin = await getTmuxBinary();
+    try {
+        await execFileAsync(tmuxBin, ['kill-session', '-t', sessionName], { timeout: 10_000 });
+    }
+    catch (err) {
+        // Treat missing sessions as already stopped to keep stop/restart idempotent.
+        if (isMissingTmuxSessionError(err))
+            return;
+        throw err;
+    }
+}
+function sanitizeExistingWebTerminalRecords() {
+    const dir = getWebTerminalsDir();
+    if (!(0, fs_1.existsSync)(dir))
+        return;
+    try {
+        const fd = (0, fs_1.openSync)(dir, 'r');
+        (0, fs_1.closeSync)(fd);
+    }
+    catch {
+        (0, config_js_1.ensurePrivateDir)((0, path_1.dirname)(dir));
+        (0, config_js_1.ensurePrivateDir)(dir);
+    }
+}
+//# sourceMappingURL=web-terminal.js.map

package/dist/lib/web-terminal.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "labgate",
-  "version": "0.5.27",
-  "description": "Policy-controlled sandboxes for AI coding agents — https://labgate.dev",
+  "version": "0.5.29",
+  "description": "Secure HPC wrapper for AI coding agents (Claude-first): policy controls, Apptainer sandboxes, and SLURM workflows — https://labgate.dev",
   "homepage": "https://labgate.dev",
   "keywords": [
     "sandbox",
@@ -43,19 +43,24 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/xterm": "^6.0.0",
     "commander": "^12.1.0",
-    "fast-glob": "^3.3.3"
+    "fast-glob": "^3.3.3",
+    "ws": "^8.19.0"
   },
   "optionalDependencies": {
     "better-sqlite3": "^12.6.2",
-    "node-pty": "^1.1.0"
+    "node-pty": "^1.2.0-beta.11"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "esbuild": "^0.25.0",
     "geist": "^1.7.0",
     "typescript": "^5.6.0",
-    "esbuild": "^0.25.0",
     "vitest": "^4.0.18"
   },
   "engines": {