@aria-cli/tools 1.0.10 → 1.0.12

package/dist-cjs/definitions/patch/patch-parser.d.ts

@@ -0,0 +1,50 @@
+export declare const BEGIN_PATCH_MARKER = "*** Begin Patch";
+export declare const END_PATCH_MARKER = "*** End Patch";
+export declare const ADD_FILE_MARKER = "*** Add File: ";
+export declare const DELETE_FILE_MARKER = "*** Delete File: ";
+export declare const UPDATE_FILE_MARKER = "*** Update File: ";
+export declare const MOVE_TO_MARKER = "*** Move to: ";
+export declare const EOF_MARKER = "*** End of File";
+export declare const CHANGE_CONTEXT_MARKER = "@@ ";
+export declare const EMPTY_CHANGE_CONTEXT_MARKER = "@@";
+export type AddFileHunk = {
+    kind: "add";
+    path: string;
+    contents: string;
+};
+export type DeleteFileHunk = {
+    kind: "delete";
+    path: string;
+};
+export type UpdateFileChunk = {
+    changeContext?: string;
+    oldLines: string[];
+    newLines: string[];
+    isEndOfFile: boolean;
+};
+export type UpdateFileHunk = {
+    kind: "update";
+    path: string;
+    movePath?: string;
+    chunks: UpdateFileChunk[];
+};
+export type Hunk = AddFileHunk | DeleteFileHunk | UpdateFileHunk;
+export type ApplyPatchSummary = {
+    added: string[];
+    modified: string[];
+    deleted: string[];
+};
+export declare function normalizeUnicodeSpaces(value: string): string;
+export declare function parsePatchText(input: string): {
+    hunks: Hunk[];
+    patch: string;
+};
+export declare function checkPatchBoundariesLenient(lines: string[]): string[];
+export declare function parseOneHunk(lines: string[], lineNumber: number): {
+    hunk: Hunk;
+    consumed: number;
+};
+export declare function parseUpdateFileChunk(lines: string[], lineNumber: number, allowMissingContext: boolean): {
+    chunk: UpdateFileChunk;
+    consumed: number;
+};

package/dist-cjs/definitions/patch/patch-parser.js

@@ -0,0 +1,215 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_CHANGE_CONTEXT_MARKER = exports.CHANGE_CONTEXT_MARKER = exports.EOF_MARKER = exports.MOVE_TO_MARKER = exports.UPDATE_FILE_MARKER = exports.DELETE_FILE_MARKER = exports.ADD_FILE_MARKER = exports.END_PATCH_MARKER = exports.BEGIN_PATCH_MARKER = void 0;
+exports.normalizeUnicodeSpaces = normalizeUnicodeSpaces;
+exports.parsePatchText = parsePatchText;
+exports.checkPatchBoundariesLenient = checkPatchBoundariesLenient;
+exports.parseOneHunk = parseOneHunk;
+exports.parseUpdateFileChunk = parseUpdateFileChunk;
+// ── Marker Constants ───────────────────────────────────────────────
+exports.BEGIN_PATCH_MARKER = "*** Begin Patch";
+exports.END_PATCH_MARKER = "*** End Patch";
+exports.ADD_FILE_MARKER = "*** Add File: ";
+exports.DELETE_FILE_MARKER = "*** Delete File: ";
+exports.UPDATE_FILE_MARKER = "*** Update File: ";
+exports.MOVE_TO_MARKER = "*** Move to: ";
+exports.EOF_MARKER = "*** End of File";
+exports.CHANGE_CONTEXT_MARKER = "@@ ";
+exports.EMPTY_CHANGE_CONTEXT_MARKER = "@@";
+// ── Unicode Normalization ──────────────────────────────────────────
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+function normalizeUnicodeSpaces(value) {
+    return value.replace(UNICODE_SPACES, " ");
+}
+// ── Parser ─────────────────────────────────────────────────────────
+function parsePatchText(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("Invalid patch: input is empty.");
+    }
+    const lines = trimmed.split(/\r?\n/);
+    const validated = checkPatchBoundariesLenient(lines);
+    const hunks = [];
+    const lastLineIndex = validated.length - 1;
+    let remaining = validated.slice(1, lastLineIndex);
+    let lineNumber = 2;
+    while (remaining.length > 0) {
+        const { hunk, consumed } = parseOneHunk(remaining, lineNumber);
+        hunks.push(hunk);
+        lineNumber += consumed;
+        remaining = remaining.slice(consumed);
+    }
+    return { hunks, patch: validated.join("\n") };
+}
+function checkPatchBoundariesLenient(lines) {
+    const strictError = checkPatchBoundariesStrict(lines);
+    if (!strictError) {
+        return lines;
+    }
+    if (lines.length < 4) {
+        throw new Error(strictError);
+    }
+    const first = lines[0];
+    const last = lines[lines.length - 1];
+    if ((first === "<<EOF" || first === "<<'EOF'" || first === '<<"EOF"') && last?.endsWith("EOF")) {
+        const inner = lines.slice(1, lines.length - 1);
+        const innerError = checkPatchBoundariesStrict(inner);
+        if (!innerError) {
+            return inner;
+        }
+        throw new Error(innerError);
+    }
+    throw new Error(strictError);
+}
+function checkPatchBoundariesStrict(lines) {
+    const firstLine = lines[0]?.trim();
+    const lastLine = lines[lines.length - 1]?.trim();
+    if (firstLine === exports.BEGIN_PATCH_MARKER && lastLine === exports.END_PATCH_MARKER) {
+        return null;
+    }
+    if (firstLine !== exports.BEGIN_PATCH_MARKER) {
+        return "The first line of the patch must be '*** Begin Patch'";
+    }
+    return "The last line of the patch must be '*** End Patch'";
+}
+function parseOneHunk(lines, lineNumber) {
+    if (lines.length === 0) {
+        throw new Error(`Invalid patch hunk at line ${lineNumber}: empty hunk`);
+    }
+    const firstLine = lines[0].trim();
+    if (firstLine.startsWith(exports.ADD_FILE_MARKER)) {
+        const targetPath = firstLine.slice(exports.ADD_FILE_MARKER.length);
+        let contents = "";
+        let consumed = 1;
+        for (const addLine of lines.slice(1)) {
+            if (addLine.startsWith("+")) {
+                contents += `${addLine.slice(1)}\n`;
+                consumed += 1;
+            }
+            else {
+                break;
+            }
+        }
+        return {
+            hunk: { kind: "add", path: targetPath, contents },
+            consumed,
+        };
+    }
+    if (firstLine.startsWith(exports.DELETE_FILE_MARKER)) {
+        const targetPath = firstLine.slice(exports.DELETE_FILE_MARKER.length);
+        return {
+            hunk: { kind: "delete", path: targetPath },
+            consumed: 1,
+        };
+    }
+    if (firstLine.startsWith(exports.UPDATE_FILE_MARKER)) {
+        const targetPath = firstLine.slice(exports.UPDATE_FILE_MARKER.length);
+        let remaining = lines.slice(1);
+        let consumed = 1;
+        let movePath;
+        const moveCandidate = remaining[0]?.trim();
+        if (moveCandidate?.startsWith(exports.MOVE_TO_MARKER)) {
+            movePath = moveCandidate.slice(exports.MOVE_TO_MARKER.length);
+            remaining = remaining.slice(1);
+            consumed += 1;
+        }
+        const chunks = [];
+        while (remaining.length > 0) {
+            if (remaining[0].trim() === "") {
+                remaining = remaining.slice(1);
+                consumed += 1;
+                continue;
+            }
+            if (remaining[0].startsWith("***")) {
+                break;
+            }
+            const { chunk, consumed: chunkLines } = parseUpdateFileChunk(remaining, lineNumber + consumed, chunks.length === 0);
+            chunks.push(chunk);
+            remaining = remaining.slice(chunkLines);
+            consumed += chunkLines;
+        }
+        if (chunks.length === 0) {
+            throw new Error(`Invalid patch hunk at line ${lineNumber}: Update file hunk for path '${targetPath}' is empty`);
+        }
+        return {
+            hunk: {
+                kind: "update",
+                path: targetPath,
+                movePath,
+                chunks,
+            },
+            consumed,
+        };
+    }
+    throw new Error(`Invalid patch hunk at line ${lineNumber}: '${lines[0]}' is not a valid hunk header. Valid hunk headers: '*** Add File: {path}', '*** Delete File: {path}', '*** Update File: {path}'`);
+}
+function parseUpdateFileChunk(lines, lineNumber, allowMissingContext) {
+    if (lines.length === 0) {
+        throw new Error(`Invalid patch hunk at line ${lineNumber}: Update hunk does not contain any lines`);
+    }
+    const firstLine = lines[0];
+    let changeContext;
+    let startIndex = 0;
+    if (firstLine === exports.EMPTY_CHANGE_CONTEXT_MARKER) {
+        startIndex = 1;
+    }
+    else if (firstLine.startsWith(exports.CHANGE_CONTEXT_MARKER)) {
+        changeContext = firstLine.slice(exports.CHANGE_CONTEXT_MARKER.length);
+        startIndex = 1;
+    }
+    else if (!allowMissingContext) {
+        throw new Error(`Invalid patch hunk at line ${lineNumber}: Expected update hunk to start with a @@ context marker, got: '${firstLine}'`);
+    }
+    if (startIndex >= lines.length) {
+        throw new Error(`Invalid patch hunk at line ${lineNumber + 1}: Update hunk does not contain any lines`);
+    }
+    const chunk = {
+        changeContext,
+        oldLines: [],
+        newLines: [],
+        isEndOfFile: false,
+    };
+    let parsedLines = 0;
+    for (const line of lines.slice(startIndex)) {
+        if (line === exports.EOF_MARKER) {
+            if (parsedLines === 0) {
+                throw new Error(`Invalid patch hunk at line ${lineNumber + 1}: Update hunk does not contain any lines`);
+            }
+            chunk.isEndOfFile = true;
+            parsedLines += 1;
+            break;
+        }
+        const marker = line[0];
+        if (!marker) {
+            chunk.oldLines.push("");
+            chunk.newLines.push("");
+            parsedLines += 1;
+            continue;
+        }
+        if (marker === " ") {
+            const content = line.slice(1);
+            chunk.oldLines.push(content);
+            chunk.newLines.push(content);
+            parsedLines += 1;
+            continue;
+        }
+        if (marker === "+") {
+            chunk.newLines.push(line.slice(1));
+            parsedLines += 1;
+            continue;
+        }
+        if (marker === "-") {
+            chunk.oldLines.push(line.slice(1));
+            parsedLines += 1;
+            continue;
+        }
+        if (parsedLines === 0) {
+            throw new Error(`Invalid patch hunk at line ${lineNumber + 1}: Unexpected line found in update hunk: '${line}'. Every line should start with ' ' (context line), '+' (added line), or '-' (removed line)`);
+        }
+        break;
+    }
+    return { chunk, consumed: parsedLines + startIndex };
+}

package/dist-cjs/definitions/patch/sandbox-paths.d.ts

@@ -0,0 +1,18 @@
+export declare function resolveSandboxInputPath(filePath: string, cwd: string): string;
+export declare function resolveSandboxPath(params: {
+    filePath: string;
+    cwd: string;
+    root: string;
+}): {
+    resolved: string;
+    relative: string;
+};
+export declare function assertSandboxPath(params: {
+    filePath: string;
+    cwd: string;
+    root: string;
+    allowFinalSymlink?: boolean;
+}): Promise<{
+    resolved: string;
+    relative: string;
+}>;

package/dist-cjs/definitions/patch/sandbox-paths.js

@@ -0,0 +1,113 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSandboxInputPath = resolveSandboxInputPath;
+exports.resolveSandboxPath = resolveSandboxPath;
+exports.assertSandboxPath = assertSandboxPath;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
+function normalizeUnicodeSpaces(str) {
+    return str.replace(UNICODE_SPACES, " ");
+}
+function expandPath(filePath) {
+    const normalized = normalizeUnicodeSpaces(filePath);
+    if (normalized === "~") {
+        return node_os_1.default.homedir();
+    }
+    if (normalized.startsWith("~/")) {
+        return node_os_1.default.homedir() + normalized.slice(1);
+    }
+    return normalized;
+}
+function resolveToCwd(filePath, cwd) {
+    const expanded = expandPath(filePath);
+    if (node_path_1.default.isAbsolute(expanded)) {
+        return expanded;
+    }
+    return node_path_1.default.resolve(cwd, expanded);
+}
+function resolveSandboxInputPath(filePath, cwd) {
+    return resolveToCwd(filePath, cwd);
+}
+function resolveSandboxPath(params) {
+    const resolved = resolveSandboxInputPath(params.filePath, params.cwd);
+    const rootResolved = node_path_1.default.resolve(params.root);
+    const relative = node_path_1.default.relative(rootResolved, resolved);
+    if (!relative || relative === "") {
+        return { resolved, relative: "" };
+    }
+    if (relative.startsWith("..") || node_path_1.default.isAbsolute(relative)) {
+        throw new Error(`Path escapes sandbox root (${shortPath(rootResolved)}): ${params.filePath}`);
+    }
+    return { resolved, relative };
+}
+async function assertSandboxPath(params) {
+    const resolved = resolveSandboxPath(params);
+    await assertNoSymlinkEscape(resolved.relative, node_path_1.default.resolve(params.root), {
+        allowFinalSymlink: params.allowFinalSymlink,
+    });
+    return resolved;
+}
+async function assertNoSymlinkEscape(relative, root, options) {
+    if (!relative) {
+        return;
+    }
+    const rootReal = await tryRealpath(root);
+    const parts = relative.split(node_path_1.default.sep).filter(Boolean);
+    let current = root;
+    for (let idx = 0; idx < parts.length; idx += 1) {
+        const part = parts[idx];
+        const isLast = idx === parts.length - 1;
+        current = node_path_1.default.join(current, part);
+        try {
+            const stat = await promises_1.default.lstat(current);
+            if (stat.isSymbolicLink()) {
+                // Unlinking a symlink itself is safe even if it points outside the root. What we
+                // must prevent is traversing through a symlink to reach targets outside root.
+                if (options?.allowFinalSymlink && isLast) {
+                    return;
+                }
+                const target = await tryRealpath(current);
+                if (!isPathInside(rootReal, target)) {
+                    throw new Error(`Symlink escapes sandbox root (${shortPath(rootReal)}): ${shortPath(current)}`);
+                }
+                current = target;
+            }
+        }
+        catch (err) {
+            const anyErr = err;
+            if (anyErr.code === "ENOENT") {
+                return;
+            }
+            throw err;
+        }
+    }
+}
+async function tryRealpath(value) {
+    try {
+        return await promises_1.default.realpath(value);
+    }
+    catch {
+        return node_path_1.default.resolve(value);
+    }
+}
+function isPathInside(root, target) {
+    const relative = node_path_1.default.relative(root, target);
+    if (!relative || relative === "") {
+        return true;
+    }
+    return !(relative.startsWith("..") || node_path_1.default.isAbsolute(relative));
+}
+function shortPath(value) {
+    if (value.startsWith(node_os_1.default.homedir())) {
+        return `~${value.slice(node_os_1.default.homedir().length)}`;
+    }
+    return value;
+}

package/dist-cjs/definitions/process/index.d.ts

@@ -0,0 +1 @@
+export { processTool } from "./process.js";

package/dist-cjs/definitions/process/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processTool = void 0;
+var process_js_1 = require("./process.js");
+Object.defineProperty(exports, "processTool", { enumerable: true, get: function () { return process_js_1.processTool; } });

package/dist-cjs/definitions/process/process-registry.d.ts

@@ -0,0 +1,67 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
+export type ProcessStatus = "running" | "completed" | "failed" | "killed";
+export type SessionStdin = {
+    write: (data: string, cb?: (err?: Error | null) => void) => void;
+    end: () => void;
+    destroy?: () => void;
+    destroyed?: boolean;
+};
+export interface ProcessSession {
+    id: string;
+    command: string;
+    notifyOnExit?: boolean;
+    notifyOnExitEmptySuccess?: boolean;
+    exitNotified?: boolean;
+    child?: ChildProcessWithoutNullStreams;
+    stdin?: SessionStdin;
+    pid?: number;
+    startedAt: number;
+    cwd?: string;
+    maxOutputChars: number;
+    pendingMaxOutputChars?: number;
+    totalOutputChars: number;
+    pendingStdout: string[];
+    pendingStderr: string[];
+    pendingStdoutChars: number;
+    pendingStderrChars: number;
+    aggregated: string;
+    tail: string;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | number | null;
+    exited: boolean;
+    truncated: boolean;
+    backgrounded: boolean;
+}
+export interface FinishedSession {
+    id: string;
+    command: string;
+    startedAt: number;
+    endedAt: number;
+    cwd?: string;
+    status: ProcessStatus;
+    exitCode?: number | null;
+    exitSignal?: NodeJS.Signals | number | null;
+    aggregated: string;
+    tail: string;
+    truncated: boolean;
+    totalOutputChars: number;
+}
+export declare function createSessionSlug(): string;
+export declare function addSession(session: ProcessSession): void;
+export declare function getSession(id: string): ProcessSession | undefined;
+export declare function getFinishedSession(id: string): FinishedSession | undefined;
+export declare function deleteSession(id: string): void;
+export declare function appendOutput(session: ProcessSession, stream: "stdout" | "stderr", chunk: string): void;
+export declare function drainSession(session: ProcessSession): {
+    stdout: string;
+    stderr: string;
+};
+export declare function markExited(session: ProcessSession, exitCode: number | null, exitSignal: NodeJS.Signals | number | null, status: ProcessStatus): void;
+export declare function markBackgrounded(session: ProcessSession): void;
+export declare function tail(text: string, max?: number): string;
+export declare function trimWithCap(text: string, max: number): string;
+export declare function listRunningSessions(): ProcessSession[];
+export declare function listFinishedSessions(): FinishedSession[];
+export declare function clearFinished(): void;
+export declare function resetProcessRegistryForTests(): void;
+export declare function setJobTtlMs(value?: number): void;