@aria-cli/tools 1.0.0

package/dist-cjs/executors/process-registry.js

@@ -0,0 +1,470 @@
+"use strict";
+/**
+ * @aria/tools - Spawned Process Registry
+ *
+ * Tracks PIDs of child processes spawned by shell executors.
+ * Allows bulk cleanup (SIGTERM then SIGKILL) when a RunSession closes,
+ * preventing orphaned processes from lingering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpawnedProcessRegistry = void 0;
+/**
+ * How long to wait after SIGTERM before escalating to SIGKILL (ms).
+ */
+const SIGKILL_TIMEOUT_MS = 2000;
+const POST_KILL_POLL_INTERVAL_MS = 25;
+const PROCESS_REAP_POLL_INTERVAL_MS = 250;
+/**
+ * Max number of exited-process snapshots to retain for observability.
+ */
+const EXIT_HISTORY_LIMIT = 100;
+/**
+ * Registry that tracks spawned child process PIDs.
+ *
+ * Usage:
+ * - Shell executors call `add(pid)` after spawning a process
+ * - Shell executors call `remove(pid)` when a process exits normally
+ * - RunSession calls `killAll()` during close() to clean up orphans
+ */
+class SpawnedProcessRegistry {
+    active = new Map();
+    exited = new Map();
+    waiters = new Map();
+    reapers = new Map();
+    /**
+     * Register a spawned process PID.
+     */
+    add(pid, metadata = {}) {
+        const existing = this.active.get(pid);
+        if (existing) {
+            this.active.set(pid, {
+                ...existing,
+                command: metadata.command ?? existing.command,
+                args: metadata.args ? [...metadata.args] : existing.args,
+                cwd: metadata.cwd ?? existing.cwd,
+                interactive: metadata.interactive ?? existing.interactive,
+            });
+            return;
+        }
+        const startedAtMs = Date.now();
+        this.active.set(pid, {
+            pid,
+            command: metadata.command ?? null,
+            args: metadata.args ? [...metadata.args] : [],
+            cwd: metadata.cwd ?? null,
+            interactive: metadata.interactive ?? false,
+            reapOnExit: isTrackedProcessAlive(pid),
+            deferredExitCode: null,
+            deferredSignal: null,
+            startedAtMs,
+            startedAt: new Date(startedAtMs).toISOString(),
+        });
+        this.exited.delete(pid);
+        this.ensureReaper(pid);
+    }
+    /**
+     * Deregister a process PID (e.g., after normal exit).
+     */
+    remove(pid, exit = {}) {
+        const record = this.active.get(pid);
+        if (!record) {
+            const exitedRecord = this.exited.get(pid);
+            if (exitedRecord) {
+                this.exited.set(pid, {
+                    ...exitedRecord,
+                    exitCode: exitedRecord.exitCode ?? normalizeExitCode(exit.exitCode),
+                    signal: exitedRecord.exitCode !== null
+                        ? exitedRecord.signal
+                        : (exitedRecord.signal ?? normalizeSignal(exit.signal)),
+                });
+            }
+            return;
+        }
+        this.clearReaper(pid);
+        this.active.delete(pid);
+        const endedAtMs = Date.now();
+        const recordedExitCode = normalizeExitCode(exit.exitCode) ?? record.deferredExitCode;
+        const exitedRecord = {
+            ...record,
+            exitCode: recordedExitCode,
+            signal: record.deferredSignal ?? normalizeSignal(exit.signal),
+            endedAtMs,
+            endedAt: new Date(endedAtMs).toISOString(),
+        };
+        this.exited.set(pid, exitedRecord);
+        this.pruneExitedHistory();
+        const waiters = this.waiters.get(pid);
+        if (waiters && waiters.length > 0) {
+            this.waiters.delete(pid);
+            for (const waiter of waiters) {
+                waiter(exitedRecord);
+            }
+        }
+    }
+    /**
+     * Check whether a PID is tracked.
+     */
+    has(pid) {
+        return this.active.has(pid);
+    }
+    recordExitMetadata(pid, exit = {}) {
+        const record = this.active.get(pid);
+        if (!record) {
+            return;
+        }
+        record.deferredExitCode = normalizeExitCode(exit.exitCode);
+        record.deferredSignal = normalizeSignal(exit.signal);
+    }
+    /**
+     * Number of tracked PIDs.
+     */
+    get size() {
+        return this.active.size;
+    }
+    /**
+     * Return a snapshot of all tracked PIDs.
+     */
+    getAll() {
+        return [...this.active.keys()];
+    }
+    /**
+     * Return process snapshots for observability.
+     */
+    listProcesses(options = {}) {
+        const now = Date.now();
+        const snapshots = [];
+        for (const pid of [...this.active.keys()]) {
+            this.reapIfExited(pid);
+        }
+        for (const record of this.active.values()) {
+            snapshots.push(this.toRunningSnapshot(record, now));
+        }
+        if (options.includeExited) {
+            for (const record of this.exited.values()) {
+                snapshots.push(this.toExitedSnapshot(record));
+            }
+        }
+        return snapshots.sort((a, b) => a.pid - b.pid);
+    }
+    /**
+     * Return a single process snapshot by PID.
+     */
+    getProcess(pid) {
+        this.reapIfExited(pid);
+        const activeRecord = this.active.get(pid);
+        if (activeRecord) {
+            return this.toRunningSnapshot(activeRecord);
+        }
+        const exitedRecord = this.exited.get(pid);
+        if (exitedRecord) {
+            return this.toExitedSnapshot(exitedRecord);
+        }
+        return undefined;
+    }
+    /**
+     * Wait for a tracked process to exit, up to timeoutMs.
+     */
+    async waitForExit(pid, timeoutMs = 30_000) {
+        this.reapIfExited(pid);
+        const exitedRecord = this.exited.get(pid);
+        if (exitedRecord) {
+            return {
+                pid,
+                status: "exited",
+                timedOut: false,
+                process: this.toExitedSnapshot(exitedRecord),
+            };
+        }
+        const activeRecord = this.active.get(pid);
+        if (!activeRecord) {
+            return {
+                pid,
+                status: "not_found",
+                timedOut: false,
+            };
+        }
+        if (timeoutMs <= 0) {
+            return {
+                pid,
+                status: "running",
+                timedOut: true,
+                process: this.toRunningSnapshot(activeRecord),
+            };
+        }
+        return new Promise((resolve) => {
+            let settled = false;
+            const settle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(result);
+            };
+            const removeWaiter = (target) => {
+                const existing = this.waiters.get(pid);
+                if (!existing)
+                    return;
+                const next = existing.filter((entry) => entry !== target);
+                if (next.length === 0) {
+                    this.waiters.delete(pid);
+                }
+                else {
+                    this.waiters.set(pid, next);
+                }
+            };
+            const waiter = (record) => {
+                clearTimeout(timeoutId);
+                removeWaiter(waiter);
+                settle({
+                    pid,
+                    status: "exited",
+                    timedOut: false,
+                    process: this.toExitedSnapshot(record),
+                });
+            };
+            const timeoutId = setTimeout(() => {
+                const current = this.active.get(pid);
+                if (current) {
+                    removeWaiter(waiter);
+                    settle({
+                        pid,
+                        status: "running",
+                        timedOut: true,
+                        process: this.toRunningSnapshot(current),
+                    });
+                    return;
+                }
+                const exited = this.exited.get(pid);
+                if (exited) {
+                    removeWaiter(waiter);
+                    settle({
+                        pid,
+                        status: "exited",
+                        timedOut: false,
+                        process: this.toExitedSnapshot(exited),
+                    });
+                    return;
+                }
+                removeWaiter(waiter);
+                settle({
+                    pid,
+                    status: "not_found",
+                    timedOut: false,
+                });
+            }, timeoutMs);
+            const existingWaiters = this.waiters.get(pid) ?? [];
+            existingWaiters.push(waiter);
+            this.waiters.set(pid, existingWaiters);
+            // Close the race window where remove() can happen between the initial
+            // active check above and waiter registration.
+            const exitedAfterRegistration = this.exited.get(pid);
+            if (exitedAfterRegistration) {
+                clearTimeout(timeoutId);
+                removeWaiter(waiter);
+                settle({
+                    pid,
+                    status: "exited",
+                    timedOut: false,
+                    process: this.toExitedSnapshot(exitedAfterRegistration),
+                });
+                return;
+            }
+            if (!this.active.has(pid)) {
+                clearTimeout(timeoutId);
+                removeWaiter(waiter);
+                settle({
+                    pid,
+                    status: "not_found",
+                    timedOut: false,
+                });
+            }
+        });
+    }
+    /**
+     * Send SIGTERM to all tracked PIDs, then SIGKILL after a timeout
+     * for any that are still alive. Clears the registry afterwards.
+     *
+     * Returns the list of PIDs that were signalled.
+     */
+    async killAll() {
+        const tracked = [...this.active.keys()];
+        if (tracked.length === 0)
+            return [];
+        // Phase 1: SIGTERM all tracked processes
+        const alive = [];
+        const signaledTerm = new Set();
+        for (const pid of tracked) {
+            if (isTrackedProcessAlive(pid)) {
+                if (sendSignalToTrackedProcess(pid, "SIGTERM")) {
+                    alive.push(pid);
+                    signaledTerm.add(pid);
+                }
+            }
+        }
+        if (alive.length === 0) {
+            for (const pid of tracked) {
+                this.remove(pid);
+            }
+            return tracked;
+        }
+        // Phase 2: Wait, then SIGKILL any survivors
+        await new Promise((resolve) => setTimeout(resolve, SIGKILL_TIMEOUT_MS));
+        const signaledKill = new Set();
+        for (const pid of alive) {
+            if (isTrackedProcessAlive(pid)) {
+                if (sendSignalToTrackedProcess(pid, "SIGKILL")) {
+                    signaledKill.add(pid);
+                }
+            }
+        }
+        await waitForProcessesToExit([...signaledKill], SIGKILL_TIMEOUT_MS);
+        for (const pid of tracked) {
+            this.remove(pid, {
+                signal: signaledKill.has(pid) ? "SIGKILL" : signaledTerm.has(pid) ? "SIGTERM" : null,
+            });
+        }
+        return tracked;
+    }
+    toRunningSnapshot(record, now = Date.now()) {
+        return {
+            pid: record.pid,
+            command: record.command,
+            args: [...record.args],
+            cwd: record.cwd,
+            interactive: record.interactive,
+            startedAt: record.startedAt,
+            runtimeMs: Math.max(0, now - record.startedAtMs),
+            status: "running",
+            exitCode: null,
+            signal: null,
+            endedAt: null,
+        };
+    }
+    toExitedSnapshot(record) {
+        return {
+            pid: record.pid,
+            command: record.command,
+            args: [...record.args],
+            cwd: record.cwd,
+            interactive: record.interactive,
+            startedAt: record.startedAt,
+            runtimeMs: Math.max(0, record.endedAtMs - record.startedAtMs),
+            status: "exited",
+            exitCode: record.exitCode,
+            signal: record.signal,
+            endedAt: record.endedAt,
+        };
+    }
+    pruneExitedHistory() {
+        while (this.exited.size > EXIT_HISTORY_LIMIT) {
+            const oldestPid = this.exited.keys().next().value;
+            if (oldestPid === undefined) {
+                break;
+            }
+            this.exited.delete(oldestPid);
+        }
+    }
+    ensureReaper(pid) {
+        if (!this.active.get(pid)?.reapOnExit) {
+            return;
+        }
+        if (this.reapers.has(pid)) {
+            return;
+        }
+        const timer = setInterval(() => {
+            this.reapIfExited(pid);
+        }, PROCESS_REAP_POLL_INTERVAL_MS);
+        timer.unref?.();
+        this.reapers.set(pid, timer);
+    }
+    clearReaper(pid) {
+        const timer = this.reapers.get(pid);
+        if (!timer) {
+            return;
+        }
+        clearInterval(timer);
+        this.reapers.delete(pid);
+    }
+    reapIfExited(pid) {
+        const record = this.active.get(pid);
+        if (!record) {
+            this.clearReaper(pid);
+            return false;
+        }
+        if (!record.reapOnExit) {
+            return false;
+        }
+        if (isTrackedProcessAlive(pid)) {
+            return false;
+        }
+        this.remove(pid);
+        return true;
+    }
+}
+exports.SpawnedProcessRegistry = SpawnedProcessRegistry;
+/**
+ * Check whether a process is still alive by sending signal 0.
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isTrackedProcessAlive(pid) {
+    if (pid > 0) {
+        try {
+            process.kill(-pid, 0);
+            return true;
+        }
+        catch {
+            // Fall back to the tracked pid itself when the process group is gone or unsupported.
+        }
+    }
+    return isProcessAlive(pid);
+}
+function sendSignalToTrackedProcess(pid, signal) {
+    try {
+        if (pid > 0) {
+            process.kill(-pid, signal);
+            return true;
+        }
+    }
+    catch {
+        // Fall back to the tracked pid itself when there is no process group to target.
+    }
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForProcessesToExit(pids, timeoutMs) {
+    if (pids.length === 0) {
+        return;
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (pids.every((pid) => !isTrackedProcessAlive(pid))) {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, POST_KILL_POLL_INTERVAL_MS));
+    }
+}
+function normalizeExitCode(value) {
+    if (typeof value !== "number" || Number.isNaN(value)) {
+        return null;
+    }
+    return value;
+}
+function normalizeSignal(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=process-registry.js.map

package/dist-cjs/executors/process-registry.js.map

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

package/dist-cjs/executors/pty-session-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PTYSessionStore — manages PTY sessions for interactive process I/O.
+ * Separate from SpawnedProcessRegistry (which is a PID-only cleanup safety net).
+ */
+import type { PTYSession } from "./pty.js";
+export declare class PTYSessionStore {
+    private sessions;
+    add(pid: number, session: PTYSession): void;
+    get(pid: number): PTYSession | undefined;
+    has(pid: number): boolean;
+    remove(pid: number): void;
+    closeAll(): Promise<void>;
+    get size(): number;
+}

package/dist-cjs/executors/pty-session-store.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PTYSessionStore = void 0;
+class PTYSessionStore {
+    sessions = new Map();
+    add(pid, session) {
+        this.sessions.set(pid, session);
+    }
+    get(pid) {
+        return this.sessions.get(pid);
+    }
+    has(pid) {
+        return this.sessions.has(pid);
+    }
+    remove(pid) {
+        this.sessions.delete(pid);
+    }
+    async closeAll() {
+        const sessions = Array.from(this.sessions.values());
+        this.sessions.clear();
+        await Promise.allSettled(sessions.map((s) => {
+            try {
+                return Promise.resolve(s.close());
+            }
+            catch {
+                return Promise.resolve();
+            }
+        }));
+    }
+    get size() {
+        return this.sessions.size;
+    }
+}
+exports.PTYSessionStore = PTYSessionStore;
+//# sourceMappingURL=pty-session-store.js.map

package/dist-cjs/executors/pty-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-session-store.js","sourceRoot":"","sources":["../../src/executors/pty-session-store.ts"],"names":[],"mappings":";;;AAMA,MAAa,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEjD,GAAG,CAAC,GAAW,EAAE,OAAmB;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,UAAU,CACtB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACjB,IAAI,CAAC;gBACH,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF;AApCD,0CAoCC"}

package/dist-cjs/executors/pty.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @aria/tools - PTY executor for interactive terminal programs
+ *
+ * Provides PTY (pseudo-terminal) support for running interactive programs
+ * that require a terminal environment (like vim, less, etc.)
+ */
+import * as nodePty from "node-pty";
+/**
+ * Options for creating a PTY session.
+ */
+export interface PTYOptions {
+    /** Command to execute */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Terminal columns (default: 80) */
+    cols?: number;
+    /** Terminal rows (default: 24) */
+    rows?: number;
+}
+/**
+ * Result of running a command in a PTY.
+ */
+export interface PTYResult {
+    /** All output from the command */
+    output: string;
+    /** Exit code of the process */
+    exitCode: number;
+}
+/**
+ * Error thrown when a PTY operation times out.
+ */
+export declare class PTYTimeoutError extends Error {
+    readonly output: string;
+    constructor(message: string, output: string);
+}
+/**
+ * Error thrown when a PTY operation fails.
+ */
+export declare class PTYError extends Error {
+    readonly output?: string | undefined;
+    constructor(message: string, output?: string | undefined);
+}
+/**
+ * A session wrapping a PTY process.
+ * Provides methods for interacting with the process and collecting output.
+ */
+export declare class PTYSession {
+    private static MAX_OUTPUT;
+    private _output;
+    private _isRunning;
+    private _exitCode;
+    private _exitPromise;
+    private _exitResolve;
+    private _pty;
+    private _dataDisposable;
+    private _exitDisposable;
+    constructor(pty: nodePty.IPty);
+    /**
+     * Write data to the terminal input.
+     */
+    write(data: string): void;
+    /**
+     * Resize the terminal.
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Wait for a pattern to appear in the output.
+     * @param pattern String or RegExp to match
+     * @param timeoutMs Timeout in milliseconds (default: 5000)
+     * @returns The output accumulated up to and including the match
+     */
+    waitFor(pattern: string | RegExp, timeoutMs?: number): Promise<string>;
+    /**
+     * Wait for the process to exit.
+     * @param timeoutMs Timeout in milliseconds (default: 30000)
+     * @returns The complete output
+     */
+    waitForExit(timeoutMs?: number): Promise<string>;
+    /**
+     * Kill the process.
+     * @param signal Signal to send (default: SIGHUP on Unix)
+     */
+    kill(signal?: string): void;
+    /**
+     * Close the session and clean up resources.
+     */
+    close(): void;
+    /**
+     * Get the current output buffer.
+     */
+    get output(): string;
+    /**
+     * Check if the process is still running.
+     */
+    get isRunning(): boolean;
+    /**
+     * Get the process ID.
+     */
+    get pid(): number;
+    /**
+     * Get the exit code (undefined if still running).
+     */
+    get exitCode(): number | undefined;
+    /**
+     * Get the current terminal columns.
+     */
+    get cols(): number;
+    /**
+     * Get the current terminal rows.
+     */
+    get rows(): number;
+}
+/**
+ * Create a new PTY session.
+ * @param options Options for the PTY
+ * @returns A PTYSession wrapping the process
+ */
+export declare function createPTYSession(options: PTYOptions): Promise<PTYSession>;
+/**
+ * Run a command in a PTY and wait for it to complete.
+ * This is a convenience function for commands that don't require interaction.
+ *
+ * @param options Options for the PTY, with optional timeout
+ * @returns The output and exit code
+ */
+export declare function runInPTY(options: PTYOptions & {
+    timeoutMs?: number;
+}): Promise<PTYResult>;