@aria-cli/tools 1.0.0

package/dist/definitions/process/process.js

@@ -0,0 +1,387 @@
+/**
+ * process tool — ARIA Tool wrapper for background shell process management.
+ *
+ * Supports spawn/read/write/kill/list/send_key actions.
+ * Uses node:child_process (no native deps).
+ * Process registry forked from OpenClaw (MIT).
+ */
+import { spawn as nodeSpawn } from "node:child_process";
+import { sanitizeEnv } from "../../executors/shell.js";
+import { createSessionSlug, addSession, getSession, getFinishedSession, appendOutput, drainSession, markExited, markBackgrounded, listRunningSessions, listFinishedSessions, } from "./process-registry.js";
+import { encodeKeySequence } from "./pty-keys.js";
+// ── Constants ───────────────────────────────────────────────────────
+const MAX_OUTPUT_CHARS = 200_000; // 200KB ring buffer cap per process
+const DEFAULT_SPAWN_TIMEOUT_MS = 30_000;
+const MAX_SPAWN_TIMEOUT_MS = 300_000; // 5 minutes
+const OUTPUT_SETTLE_MS = 200; // wait for initial output after spawn
+// ── Action handlers ─────────────────────────────────────────────────
+function handleSpawn(input, cwd) {
+    return new Promise((resolve) => {
+        const command = input.command;
+        if (!command) {
+            resolve({ success: false, message: "spawn requires 'command' parameter" });
+            return;
+        }
+        const sessionId = createSessionSlug();
+        const timeout = Math.min(input.timeout ?? DEFAULT_SPAWN_TIMEOUT_MS, MAX_SPAWN_TIMEOUT_MS);
+        const child = nodeSpawn("sh", ["-c", command], {
+            cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            env: sanitizeEnv(),
+            detached: false,
+        });
+        const session = {
+            id: sessionId,
+            command,
+            pid: child.pid,
+            startedAt: Date.now(),
+            cwd,
+            maxOutputChars: MAX_OUTPUT_CHARS,
+            totalOutputChars: 0,
+            pendingStdout: [],
+            pendingStderr: [],
+            pendingStdoutChars: 0,
+            pendingStderrChars: 0,
+            aggregated: "",
+            tail: "",
+            exited: false,
+            truncated: false,
+            backgrounded: true,
+            child,
+            stdin: child.stdin
+                ? {
+                    write: (data, cb) => child.stdin.write(data, cb),
+                    end: () => child.stdin.end(),
+                    destroy: () => child.stdin.destroy(),
+                    get destroyed() {
+                        return child.stdin.destroyed;
+                    },
+                }
+                : undefined,
+        };
+        addSession(session);
+        markBackgrounded(session);
+        child.stdout?.on("data", (chunk) => {
+            appendOutput(session, "stdout", chunk.toString());
+        });
+        child.stderr?.on("data", (chunk) => {
+            appendOutput(session, "stderr", chunk.toString());
+        });
+        child.on("error", (err) => {
+            markExited(session, null, null, "failed");
+            // Error after we already resolved is fine — the process just failed later
+        });
+        child.on("exit", (code, signal) => {
+            if (session.exited)
+                return;
+            const status = signal ? "killed" : code === 0 ? "completed" : "failed";
+            markExited(session, code, signal, status);
+        });
+        // Set up timeout to kill if it runs too long without interaction
+        if (timeout > 0) {
+            const timer = setTimeout(() => {
+                if (!session.exited) {
+                    try {
+                        child.kill("SIGTERM");
+                    }
+                    catch {
+                        // Process may have already exited
+                    }
+                }
+            }, timeout);
+            timer.unref();
+            // Clear timeout if process exits before timeout
+            child.on("exit", () => clearTimeout(timer));
+        }
+        // Wait briefly for initial output
+        setTimeout(() => {
+            const { stdout, stderr } = drainSession(session);
+            const initialOutput = [stdout && `stdout: ${stdout}`, stderr && `stderr: ${stderr}`]
+                .filter(Boolean)
+                .join("\n");
+            resolve({
+                success: true,
+                message: [
+                    `Process spawned with session_id: ${sessionId}`,
+                    `PID: ${child.pid}`,
+                    `Command: ${command}`,
+                    initialOutput && `\nInitial output:\n${initialOutput}`,
+                ]
+                    .filter(Boolean)
+                    .join("\n"),
+                data: { session_id: sessionId, pid: child.pid },
+            });
+        }, OUTPUT_SETTLE_MS);
+    });
+}
+function handleRead(input) {
+    const sessionId = input.session_id;
+    if (!sessionId) {
+        return { success: false, message: "read requires 'session_id' parameter" };
+    }
+    const session = getSession(sessionId);
+    if (session) {
+        const { stdout, stderr } = drainSession(session);
+        const hasOutput = stdout || stderr;
+        return {
+            success: true,
+            message: [
+                `Session: ${sessionId} (running, PID: ${session.pid})`,
+                hasOutput ? "" : "(no new output since last read)",
+                stdout && `stdout:\n${stdout}`,
+                stderr && `stderr:\n${stderr}`,
+            ]
+                .filter((s) => typeof s === "string" && s !== "")
+                .join("\n"),
+            data: {
+                session_id: sessionId,
+                status: "running",
+                pid: session.pid,
+                stdout,
+                stderr,
+                total_output_chars: session.totalOutputChars,
+                truncated: session.truncated,
+            },
+        };
+    }
+    const finished = getFinishedSession(sessionId);
+    if (finished) {
+        return {
+            success: true,
+            message: [
+                `Session: ${sessionId} (${finished.status})`,
+                `Exit code: ${finished.exitCode ?? "N/A"}`,
+                finished.exitSignal && `Signal: ${finished.exitSignal}`,
+                `Output:\n${finished.tail}`,
+                finished.truncated && "(output was truncated)",
+            ]
+                .filter(Boolean)
+                .join("\n"),
+            data: {
+                session_id: sessionId,
+                status: finished.status,
+                exit_code: finished.exitCode,
+                exit_signal: finished.exitSignal,
+                output: finished.tail,
+                total_output_chars: finished.totalOutputChars,
+                truncated: finished.truncated,
+            },
+        };
+    }
+    return { success: false, message: `No session found with id: ${sessionId}` };
+}
+async function handleWrite(input) {
+    const sessionId = input.session_id;
+    if (!sessionId) {
+        return { success: false, message: "write requires 'session_id' parameter" };
+    }
+    if (input.input === undefined || input.input === null) {
+        return { success: false, message: "write requires 'input' parameter" };
+    }
+    const session = getSession(sessionId);
+    if (!session) {
+        const finished = getFinishedSession(sessionId);
+        if (finished) {
+            return {
+                success: false,
+                message: `Session ${sessionId} has already exited (${finished.status})`,
+            };
+        }
+        return { success: false, message: `No session found with id: ${sessionId}` };
+    }
+    if (!session.stdin || session.stdin.destroyed) {
+        return { success: false, message: `Session ${sessionId} stdin is not available` };
+    }
+    return new Promise((resolve) => {
+        session.stdin.write(input.input, (err) => {
+            if (err) {
+                resolve({
+                    success: false,
+                    message: `Failed to write to session ${sessionId}: ${err.message}`,
+                });
+                return;
+            }
+            resolve({
+                success: true,
+                message: `Wrote ${input.input.length} chars to session ${sessionId}`,
+                data: { session_id: sessionId, bytes_written: input.input.length },
+            });
+        });
+    });
+}
+function handleKill(input) {
+    const sessionId = input.session_id;
+    if (!sessionId) {
+        return { success: false, message: "kill requires 'session_id' parameter" };
+    }
+    const session = getSession(sessionId);
+    if (!session) {
+        const finished = getFinishedSession(sessionId);
+        if (finished) {
+            return {
+                success: false,
+                message: `Session ${sessionId} has already exited (${finished.status})`,
+            };
+        }
+        return { success: false, message: `No session found with id: ${sessionId}` };
+    }
+    const signal = (input.signal ?? "SIGTERM");
+    if (session.child) {
+        try {
+            session.child.kill(signal);
+        }
+        catch {
+            // Process may have already exited
+        }
+    }
+    return {
+        success: true,
+        message: `Sent ${signal} to session ${sessionId} (PID: ${session.pid})`,
+        data: { session_id: sessionId, signal },
+    };
+}
+function handleList() {
+    const running = listRunningSessions().map((s) => ({
+        session_id: s.id,
+        command: s.command,
+        pid: s.pid,
+        status: s.exited ? "exited" : "running",
+        started_at: new Date(s.startedAt).toISOString(),
+        runtime_ms: Date.now() - s.startedAt,
+        total_output_chars: s.totalOutputChars,
+    }));
+    const finished = listFinishedSessions().map((s) => ({
+        session_id: s.id,
+        command: s.command,
+        status: s.status,
+        exit_code: s.exitCode,
+        started_at: new Date(s.startedAt).toISOString(),
+        ended_at: new Date(s.endedAt).toISOString(),
+        runtime_ms: s.endedAt - s.startedAt,
+        total_output_chars: s.totalOutputChars,
+    }));
+    const all = [...running, ...finished];
+    if (all.length === 0) {
+        return { success: true, message: "No active or recent sessions.", data: { sessions: [] } };
+    }
+    const lines = all.map((s) => `  ${s.session_id}: ${s.command} [${s.status}] (${s.runtime_ms}ms)`);
+    return {
+        success: true,
+        message: `Sessions (${all.length}):\n${lines.join("\n")}`,
+        data: { sessions: all },
+    };
+}
+async function handleSendKey(input) {
+    const sessionId = input.session_id;
+    if (!sessionId) {
+        return { success: false, message: "send_key requires 'session_id' parameter" };
+    }
+    if (!input.key) {
+        return { success: false, message: "send_key requires 'key' parameter" };
+    }
+    const session = getSession(sessionId);
+    if (!session) {
+        const finished = getFinishedSession(sessionId);
+        if (finished) {
+            return {
+                success: false,
+                message: `Session ${sessionId} has already exited (${finished.status})`,
+            };
+        }
+        return { success: false, message: `No session found with id: ${sessionId}` };
+    }
+    if (!session.stdin || session.stdin.destroyed) {
+        return { success: false, message: `Session ${sessionId} stdin is not available` };
+    }
+    const { data: keyData, warnings } = encodeKeySequence({ keys: [input.key] });
+    if (!keyData) {
+        return {
+            success: false,
+            message: `Could not encode key: ${input.key}${warnings.length ? ` (${warnings.join(", ")})` : ""}`,
+        };
+    }
+    return new Promise((resolve) => {
+        session.stdin.write(keyData, (err) => {
+            if (err) {
+                resolve({
+                    success: false,
+                    message: `Failed to send key to session ${sessionId}: ${err.message}`,
+                });
+                return;
+            }
+            resolve({
+                success: true,
+                message: `Sent key '${input.key}' to session ${sessionId}${warnings.length ? ` (warnings: ${warnings.join(", ")})` : ""}`,
+                data: { session_id: sessionId, key: input.key, warnings },
+            });
+        });
+    });
+}
+// ── Tool definition ─────────────────────────────────────────────────
+export const processTool = {
+    name: "process",
+    description: "Manage background shell processes. Supports spawning long-running commands, reading their output, writing input, and killing them. Each process gets a human-readable session ID.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["spawn", "read", "write", "kill", "list", "send_key"],
+                description: "Action to perform",
+            },
+            command: {
+                type: "string",
+                description: "Shell command to run (for spawn)",
+            },
+            session_id: {
+                type: "string",
+                description: "Session ID (from spawn result)",
+            },
+            input: {
+                type: "string",
+                description: "Input to write to stdin (for write)",
+            },
+            key: {
+                type: "string",
+                description: "Special key to send (for send_key): Enter, Tab, Ctrl+C, Up, Down, etc.",
+            },
+            timeout: {
+                type: "number",
+                description: "Timeout in ms (for spawn, default 30000)",
+            },
+            signal: {
+                type: "string",
+                description: "Signal to send (for kill, default SIGTERM)",
+            },
+        },
+        required: ["action"],
+    },
+    riskLevel: "dangerous",
+    isReadOnly: false,
+    loadingTier: "always",
+    async execute(rawInput, context) {
+        const input = rawInput;
+        const cwd = context.workingDir;
+        switch (input.action) {
+            case "spawn":
+                return handleSpawn(input, cwd);
+            case "read":
+                return handleRead(input);
+            case "write":
+                return handleWrite(input);
+            case "kill":
+                return handleKill(input);
+            case "list":
+                return handleList();
+            case "send_key":
+                return handleSendKey(input);
+            default:
+                return {
+                    success: false,
+                    message: `Unknown action: ${input.action}. Valid actions: spawn, read, write, kill, list, send_key`,
+                };
+        }
+    },
+};
+//# sourceMappingURL=process.js.map

package/dist/definitions/process/process.js.map

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

package/dist/definitions/process/pty-keys.d.ts

@@ -0,0 +1,14 @@
+export declare const BRACKETED_PASTE_START = "\u001B[200~";
+export declare const BRACKETED_PASTE_END = "\u001B[201~";
+export type KeyEncodingRequest = {
+    keys?: string[];
+    hex?: string[];
+    literal?: string;
+};
+export type KeyEncodingResult = {
+    data: string;
+    warnings: string[];
+};
+export declare function encodeKeySequence(request: KeyEncodingRequest): KeyEncodingResult;
+export declare function encodePaste(text: string, bracketed?: boolean): string;
+//# sourceMappingURL=pty-keys.d.ts.map

package/dist/definitions/process/pty-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-keys.d.ts","sourceRoot":"","sources":["../../../src/definitions/process/pty-keys.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAqFjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA0BhF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAKlE"}

package/dist/definitions/process/pty-keys.js

@@ -0,0 +1,255 @@
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, inlined escapeRegExp
+const ESC = "\x1b";
+const CR = "\r";
+const TAB = "\t";
+const BACKSPACE = "\x7f";
+export const BRACKETED_PASTE_START = `${ESC}[200~`;
+export const BRACKETED_PASTE_END = `${ESC}[201~`;
+const namedKeyMap = new Map([
+    ["enter", CR],
+    ["return", CR],
+    ["tab", TAB],
+    ["escape", ESC],
+    ["esc", ESC],
+    ["space", " "],
+    ["bspace", BACKSPACE],
+    ["backspace", BACKSPACE],
+    ["up", `${ESC}[A`],
+    ["down", `${ESC}[B`],
+    ["right", `${ESC}[C`],
+    ["left", `${ESC}[D`],
+    ["home", `${ESC}[1~`],
+    ["end", `${ESC}[4~`],
+    ["pageup", `${ESC}[5~`],
+    ["pgup", `${ESC}[5~`],
+    ["ppage", `${ESC}[5~`],
+    ["pagedown", `${ESC}[6~`],
+    ["pgdn", `${ESC}[6~`],
+    ["npage", `${ESC}[6~`],
+    ["insert", `${ESC}[2~`],
+    ["ic", `${ESC}[2~`],
+    ["delete", `${ESC}[3~`],
+    ["del", `${ESC}[3~`],
+    ["dc", `${ESC}[3~`],
+    ["btab", `${ESC}[Z`],
+    ["f1", `${ESC}OP`],
+    ["f2", `${ESC}OQ`],
+    ["f3", `${ESC}OR`],
+    ["f4", `${ESC}OS`],
+    ["f5", `${ESC}[15~`],
+    ["f6", `${ESC}[17~`],
+    ["f7", `${ESC}[18~`],
+    ["f8", `${ESC}[19~`],
+    ["f9", `${ESC}[20~`],
+    ["f10", `${ESC}[21~`],
+    ["f11", `${ESC}[23~`],
+    ["f12", `${ESC}[24~`],
+    ["kp/", `${ESC}Oo`],
+    ["kp*", `${ESC}Oj`],
+    ["kp-", `${ESC}Om`],
+    ["kp+", `${ESC}Ok`],
+    ["kp7", `${ESC}Ow`],
+    ["kp8", `${ESC}Ox`],
+    ["kp9", `${ESC}Oy`],
+    ["kp4", `${ESC}Ot`],
+    ["kp5", `${ESC}Ou`],
+    ["kp6", `${ESC}Ov`],
+    ["kp1", `${ESC}Oq`],
+    ["kp2", `${ESC}Or`],
+    ["kp3", `${ESC}Os`],
+    ["kp0", `${ESC}Op`],
+    ["kp.", `${ESC}On`],
+    ["kpenter", `${ESC}OM`],
+]);
+const modifiableNamedKeys = new Set([
+    "up",
+    "down",
+    "left",
+    "right",
+    "home",
+    "end",
+    "pageup",
+    "pgup",
+    "ppage",
+    "pagedown",
+    "pgdn",
+    "npage",
+    "insert",
+    "ic",
+    "delete",
+    "del",
+    "dc",
+]);
+export function encodeKeySequence(request) {
+    const warnings = [];
+    let data = "";
+    if (request.literal) {
+        data += request.literal;
+    }
+    if (request.hex?.length) {
+        for (const raw of request.hex) {
+            const byte = parseHexByte(raw);
+            if (byte === null) {
+                warnings.push(`Invalid hex byte: ${raw}`);
+                continue;
+            }
+            data += String.fromCharCode(byte);
+        }
+    }
+    if (request.keys?.length) {
+        for (const token of request.keys) {
+            data += encodeKeyToken(token, warnings);
+        }
+    }
+    return { data, warnings };
+}
+export function encodePaste(text, bracketed = true) {
+    if (!bracketed) {
+        return text;
+    }
+    return `${BRACKETED_PASTE_START}${text}${BRACKETED_PASTE_END}`;
+}
+function encodeKeyToken(raw, warnings) {
+    const token = raw.trim();
+    if (!token) {
+        return "";
+    }
+    if (token.length === 2 && token.startsWith("^")) {
+        const ctrl = toCtrlChar(token[1]);
+        if (ctrl) {
+            return ctrl;
+        }
+    }
+    const parsed = parseModifiers(token);
+    const base = parsed.base;
+    const baseLower = base.toLowerCase();
+    if (baseLower === "tab" && parsed.mods.shift) {
+        return `${ESC}[Z`;
+    }
+    const baseSeq = namedKeyMap.get(baseLower);
+    if (baseSeq) {
+        let seq = baseSeq;
+        if (modifiableNamedKeys.has(baseLower) && hasAnyModifier(parsed.mods)) {
+            const mod = xtermModifier(parsed.mods);
+            if (mod > 1) {
+                const modified = applyXtermModifier(seq, mod);
+                if (modified) {
+                    seq = modified;
+                    return seq;
+                }
+            }
+        }
+        if (parsed.mods.alt) {
+            return `${ESC}${seq}`;
+        }
+        return seq;
+    }
+    if (base.length === 1) {
+        return applyCharModifiers(base, parsed.mods);
+    }
+    if (parsed.hasModifiers) {
+        warnings.push(`Unknown key "${base}" for modifiers; sending literal.`);
+    }
+    return base;
+}
+function parseModifiers(token) {
+    const mods = { ctrl: false, alt: false, shift: false };
+    let rest = token;
+    let sawModifiers = false;
+    while (rest.length > 2 && rest[1] === "-") {
+        const mod = rest[0].toLowerCase();
+        if (mod === "c") {
+            mods.ctrl = true;
+        }
+        else if (mod === "m") {
+            mods.alt = true;
+        }
+        else if (mod === "s") {
+            mods.shift = true;
+        }
+        else {
+            break;
+        }
+        sawModifiers = true;
+        rest = rest.slice(2);
+    }
+    return { mods, base: rest, hasModifiers: sawModifiers };
+}
+function applyCharModifiers(char, mods) {
+    let value = char;
+    if (mods.shift && value.length === 1 && /[a-z]/.test(value)) {
+        value = value.toUpperCase();
+    }
+    if (mods.ctrl) {
+        const ctrl = toCtrlChar(value);
+        if (ctrl) {
+            value = ctrl;
+        }
+    }
+    if (mods.alt) {
+        value = `${ESC}${value}`;
+    }
+    return value;
+}
+function toCtrlChar(char) {
+    if (char.length !== 1) {
+        return null;
+    }
+    if (char === "?") {
+        return "\x7f";
+    }
+    const code = char.toUpperCase().charCodeAt(0);
+    if (code >= 64 && code <= 95) {
+        return String.fromCharCode(code & 0x1f);
+    }
+    return null;
+}
+function xtermModifier(mods) {
+    let mod = 1;
+    if (mods.shift) {
+        mod += 1;
+    }
+    if (mods.alt) {
+        mod += 2;
+    }
+    if (mods.ctrl) {
+        mod += 4;
+    }
+    return mod;
+}
+/** Inlined from OpenClaw src/utils.ts — escapes special regex characters */
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function applyXtermModifier(sequence, modifier) {
+    const escPattern = escapeRegExp(ESC);
+    const csiNumber = new RegExp(`^${escPattern}\\[(\\d+)([~A-Z])$`);
+    const csiArrow = new RegExp(`^${escPattern}\\[(A|B|C|D|H|F)$`);
+    const numberMatch = sequence.match(csiNumber);
+    if (numberMatch) {
+        return `${ESC}[${numberMatch[1]};${modifier}${numberMatch[2]}`;
+    }
+    const arrowMatch = sequence.match(csiArrow);
+    if (arrowMatch) {
+        return `${ESC}[1;${modifier}${arrowMatch[1]}`;
+    }
+    return null;
+}
+function hasAnyModifier(mods) {
+    return mods.ctrl || mods.alt || mods.shift;
+}
+function parseHexByte(raw) {
+    const trimmed = raw.trim().toLowerCase();
+    const normalized = trimmed.startsWith("0x") ? trimmed.slice(2) : trimmed;
+    if (!/^[0-9a-f]{1,2}$/.test(normalized)) {
+        return null;
+    }
+    const value = Number.parseInt(normalized, 16);
+    if (Number.isNaN(value) || value < 0 || value > 0xff) {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=pty-keys.js.map