@platless/axom-cli 0.3.13 → 0.5.9

package/dist/workstation/tools/terminal.js

@@ -1,214 +0,0 @@
-import os from 'node:os';
-import { createRequire } from 'node:module';
-import { identifier, integer, keys, TOOL_RESULT_BYTES } from './validation.js';
-const require = createRequire(import.meta.url);
-const { Terminal } = require('@xterm/headless');
-const { SerializeAddon } = require('@xterm/addon-serialize');
-const HISTORY_BYTES = 1024 * 1024;
-const MAX_POLL_BYTES = 64 * 1024;
-const SCROLLBACK = 1000;
-export class PersistentTerminals {
-    files;
-    options;
-    sessions = new Map();
-    ptyModule;
-    error;
-    constructor(files, options) {
-        this.files = files;
-        this.options = options;
-        try {
-            this.ptyModule = (options.loadPty ?? (() => require('node-pty')))();
-        }
-        catch {
-            this.error = 'Terminal native dependency unavailable; reinstall CLI with optional node-pty support';
-        }
-    }
-    get available() { return !!this.ptyModule; }
-    descriptor(s) {
-        return { id: s.id, name: s.name, cwd: s.cwd, cols: s.cols, rows: s.rows, exited: s.exited, exitCode: s.exitCode, controllerId: s.controllerId };
-    }
-    control(s, clientId) {
-        if (s.controllerId !== clientId)
-            throw new Error('Terminal is controlled by another client; take control explicitly');
-    }
-    resize(s, p) {
-        const cols = integer(p, 'cols', 20, 300, s.cols);
-        const rows = integer(p, 'rows', 5, 100, s.rows);
-        if (cols !== s.cols || rows !== s.rows) {
-            if (!s.exited)
-                s.pty.resize(cols, rows);
-            s.terminal.resize(cols, rows);
-            s.cols = cols;
-            s.rows = rows;
-        }
-    }
-    snapshot(s) {
-        // Scroll position belongs to the viewer, never the keeper. Serialization includes normal and
-        // alternate buffers, SGR attributes, cursor and modes; it starts from a clean emulator.
-        for (let scrollback = SCROLLBACK;; scrollback = Math.floor(scrollback / 2)) {
-            const snapshot = '\x1bc' + s.serializer.serialize({ scrollback });
-            if (Buffer.byteLength(JSON.stringify({ snapshot })) < TOOL_RESULT_BYTES - 8192)
-                return snapshot;
-            if (!scrollback)
-                throw new Error('Terminal screen exceeds snapshot limit; resize to a smaller viewport');
-        }
-    }
-    output(s, data) {
-        if (!data || s.closed)
-            return;
-        const bytes = Buffer.byteLength(data);
-        s.pendingBytes += bytes;
-        if (s.pendingBytes > 256 * 1024)
-            s.pty.pause();
-        const previous = s.rendered;
-        s.rendered = previous.then(() => new Promise(resolve => {
-            s.terminal.write(data, () => {
-                // Each PTY event is a sequence boundary. A single large event can exceed the history budget;
-                // dropping it is safe because poll then returns a fully rendered snapshot.
-                s.seq += 1;
-                s.ring.push({ seq: s.seq, data, bytes });
-                s.ringBytes += bytes;
-                const limit = this.options.historyBytes ?? HISTORY_BYTES;
-                while (s.ringBytes > limit && s.ring.length)
-                    s.ringBytes -= s.ring.shift().bytes;
-                s.pendingBytes -= bytes;
-                if (s.pendingBytes < 64 * 1024 && !s.exited)
-                    s.pty.resume();
-                resolve();
-            });
-        }));
-    }
-    async dispatch(method, p) {
-        if (method === 'terminal.list') {
-            keys(p, []);
-            return { sessions: [...this.sessions.values()].map(s => this.descriptor(s)) };
-        }
-        if (!this.ptyModule)
-            throw new Error(this.error ?? 'Terminal unavailable');
-        const id = identifier(p, 'id');
-        const clientId = identifier(p, 'clientId');
-        if (method === 'terminal.create') {
-            keys(p, ['id', 'clientId', 'name', 'cwd', 'cols', 'rows']);
-            const cols = integer(p, 'cols', 20, 300, 100);
-            const rows = integer(p, 'rows', 5, 100, 30);
-            if (p.name !== undefined && (typeof p.name !== 'string' || !p.name.length || p.name.length > 128 || /[\x00-\x1f]/.test(p.name)))
-                throw new Error('Invalid terminal name');
-            const old = this.sessions.get(id);
-            if (old)
-                return this.descriptor(old);
-            if (this.sessions.size >= 8)
-                throw new Error('Terminal session limit exceeded');
-            if (p.cwd !== undefined && typeof p.cwd !== 'string')
-                throw new Error('Invalid cwd');
-            const cwd = await this.files.resolve(p.cwd ?? this.files.home);
-            const terminal = new Terminal({ cols, rows, scrollback: SCROLLBACK, allowProposedApi: true });
-            const serializer = new SerializeAddon();
-            // Headless and browser xterm share the addon contract, but their declaration packages differ.
-            terminal.loadAddon(serializer);
-            let pty;
-            try {
-                pty = this.ptyModule.spawn(this.options.shell ?? process.env.SHELL ?? os.userInfo().shell ?? '/bin/sh', ['-l'], { name: 'xterm-256color', cwd, cols, rows, env: { ...process.env, TERM: 'xterm-256color', COLORTERM: 'truecolor' } });
-            }
-            catch (error) {
-                terminal.dispose();
-                throw error;
-            }
-            const session = { id, name: p.name ?? 'Terminal', cwd, cols, rows, exited: false, exitCode: null, controllerId: clientId, pty, closed: false, terminal, serializer, seq: 0, ring: [], ringBytes: 0, pendingBytes: 0, rendered: Promise.resolve() };
-            pty.onData(data => this.output(session, data));
-            pty.onExit(event => { session.exited = true; session.exitCode = event.exitCode; });
-            // Answering terminal queries (DA/DSR, etc.) is keeper-owned and does not require a web client.
-            terminal.onData(data => { if (!session.exited)
-                pty.write(data); });
-            this.sessions.set(id, session);
-            return this.descriptor(session);
-        }
-        const s = this.sessions.get(id);
-        if (!s)
-            throw new Error('Terminal session not found; keeper restart loses live PTYs');
-        switch (method) {
-            case 'terminal.attach': {
-                keys(p, ['id', 'clientId', 'cols', 'rows']);
-                // Validate dimensions even for a viewer, but only the controller's dimensions affect PTY.
-                integer(p, 'cols', 20, 300, s.cols);
-                integer(p, 'rows', 5, 100, s.rows);
-                await s.rendered;
-                if (s.controllerId === null)
-                    s.controllerId = clientId;
-                if (s.controllerId === clientId)
-                    this.resize(s, p);
-                return { session: this.descriptor(s), seq: s.seq, snapshot: this.snapshot(s), control: s.controllerId === clientId };
-            }
-            case 'terminal.poll': {
-                keys(p, ['id', 'clientId', 'after']);
-                const after = integer(p, 'after', 0, Number.MAX_SAFE_INTEGER);
-                await s.rendered;
-                const common = { exited: s.exited, exitCode: s.exitCode, control: s.controllerId === clientId };
-                if (after > s.seq || after < (s.ring[0]?.seq ?? s.seq + 1) - 1)
-                    return { ...common, seq: s.seq, data: '', reset: true, snapshot: this.snapshot(s) };
-                let data = '';
-                let bytes = 0;
-                let seq = after;
-                for (const output of s.ring) {
-                    if (output.seq <= after)
-                        continue;
-                    if (bytes + output.bytes > MAX_POLL_BYTES) {
-                        if (!bytes)
-                            return { ...common, seq: s.seq, data: '', reset: true, snapshot: this.snapshot(s) };
-                        break;
-                    }
-                    data += output.data;
-                    bytes += output.bytes;
-                    seq = output.seq;
-                }
-                return { ...common, seq, data, reset: false };
-            }
-            case 'terminal.takeover':
-                keys(p, ['id', 'clientId']);
-                s.controllerId = clientId;
-                return { ok: true };
-            case 'terminal.detach':
-                keys(p, ['id', 'clientId']);
-                if (s.controllerId === clientId)
-                    s.controllerId = null;
-                return { ok: true };
-            case 'terminal.write':
-                keys(p, ['id', 'clientId', 'data']);
-                this.control(s, clientId);
-                if (s.exited)
-                    throw new Error('Terminal has exited');
-                if (typeof p.data !== 'string' || Buffer.byteLength(p.data) > 64 * 1024)
-                    throw new Error('Invalid terminal input');
-                s.pty.write(p.data);
-                return { ok: true };
-            case 'terminal.resize':
-                keys(p, ['id', 'clientId', 'cols', 'rows']);
-                this.control(s, clientId);
-                integer(p, 'cols', 20, 300);
-                integer(p, 'rows', 5, 100);
-                await s.rendered;
-                this.resize(s, p);
-                return { ok: true };
-            case 'terminal.close':
-                keys(p, ['id', 'clientId']);
-                this.control(s, clientId);
-                this.sessions.delete(id);
-                s.closed = true;
-                if (!s.exited)
-                    s.pty.kill();
-                await s.rendered;
-                s.terminal.dispose();
-                return { ok: true };
-            default: throw new Error('Unsupported terminal tool');
-        }
-    }
-    async dispose() {
-        for (const session of this.sessions.values()) {
-            session.closed = true;
-            if (!session.exited)
-                session.pty.kill();
-            await session.rendered;
-            session.terminal.dispose();
-        }
-        this.sessions.clear();
-    }
-}