@pentoshi/clai 4.18.0 → 5.0.0

package/dist/rea/download.js

@@ -0,0 +1,198 @@
+import { createHash } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { rm } from "node:fs/promises";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { publish } from "./install.js";
+const MAX_REDIRECTS = 5;
+const STALL_TIMEOUT_MS = 60_000;
+const PROGRESS_STEP_BYTES = 1024 * 1024;
+const REDIRECTS = new Set([301, 302, 303, 307, 308]);
+export function allowedHost(url, hosts) {
+    if (url.protocol !== "https:" || url.username || url.password || url.port)
+        return false;
+    return hosts.some((host) => host.startsWith("*.") ? url.hostname.endsWith(host.slice(1)) : url.hostname === host);
+}
+function checkedUrl(value, hosts) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`Refusing malformed download URL: ${value.slice(0, 80)}`);
+    }
+    if (!allowedHost(url, hosts))
+        throw new Error(`Refusing unofficial download origin: ${url.origin}`);
+    return url;
+}
+async function open(url, options, signal) {
+    const request = options.fetch ?? fetch;
+    let current = checkedUrl(url, options.hosts);
+    for (let hop = 0; hop <= MAX_REDIRECTS; hop += 1) {
+        const response = await request(current.href, {
+            redirect: "manual",
+            signal,
+            headers: { "User-Agent": "clai-rea-installer", ...options.headers },
+        });
+        if (!REDIRECTS.has(response.status))
+            return response;
+        const location = response.headers.get("location");
+        await response.body?.cancel().catch(() => undefined);
+        if (!location)
+            throw new Error(`Download redirect without a location (${current.origin})`);
+        current = checkedUrl(new URL(location, current).href, options.hosts);
+    }
+    throw new Error(`Download redirected more than ${MAX_REDIRECTS} times`);
+}
+function stallGuard(options) {
+    const stall = new AbortController();
+    const limit = options.stallMs ?? STALL_TIMEOUT_MS;
+    let timer;
+    const touch = () => {
+        clearTimeout(timer);
+        timer = setTimeout(() => stall.abort(new Error(`Download stalled: no data for ${Math.round(limit / 1000)}s`)), limit);
+    };
+    touch();
+    return {
+        signal: options.signal ? AbortSignal.any([options.signal, stall.signal]) : stall.signal,
+        touch,
+        stop: () => clearTimeout(timer),
+    };
+}
+function cancelled(signal) {
+    return signal.reason instanceof Error ? signal.reason : new Error("Download cancelled");
+}
+async function* chunksOf(body, signal) {
+    const reader = body.getReader();
+    const onAbort = () => {
+        reader.cancel(cancelled(signal)).catch(() => undefined);
+    };
+    if (signal.aborted)
+        onAbort();
+    else
+        signal.addEventListener("abort", onAbort, { once: true });
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (signal.aborted)
+                throw cancelled(signal);
+            if (done)
+                return;
+            yield value;
+        }
+    }
+    finally {
+        signal.removeEventListener("abort", onAbort);
+        reader.cancel().catch(() => undefined);
+    }
+}
+function requestFailure(response, host) {
+    const base = `Request failed: HTTP ${response.status} (${host})`;
+    const remaining = response.headers.get("x-ratelimit-remaining");
+    const reset = Number(response.headers.get("x-ratelimit-reset"));
+    const retryAfter = Number(response.headers.get("retry-after"));
+    const limited = response.status === 429 || ((response.status === 403 || response.status === 503) && (remaining === "0" || retryAfter > 0));
+    if (!limited)
+        return base;
+    const seconds = Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter : Number.isFinite(reset) && reset > 0 ? Math.max(0, reset - Math.floor(Date.now() / 1000)) : undefined;
+    const minutes = seconds === undefined ? undefined : Math.max(1, Math.ceil(seconds / 60));
+    return `${base}: ${host} is rate limiting this network${minutes === undefined ? "" : `; try again in about ${minutes} minute${minutes === 1 ? "" : "s"}`}`;
+}
+export async function fetchText(url, options) {
+    const guard = stallGuard(options);
+    try {
+        const response = await open(url, options, guard.signal);
+        if (!response.ok) {
+            await response.body?.cancel().catch(() => undefined);
+            throw new Error(requestFailure(response, new URL(url).hostname));
+        }
+        if (!response.body)
+            throw new Error("Empty response");
+        const chunks = [];
+        let received = 0;
+        for await (const chunk of chunksOf(response.body, guard.signal)) {
+            guard.touch();
+            received += chunk.byteLength;
+            if (received > options.maxBytes)
+                throw new Error(`Response exceeds ${options.maxBytes} bytes`);
+            chunks.push(chunk);
+        }
+        return Buffer.concat(chunks, received).toString("utf8");
+    }
+    finally {
+        guard.stop();
+    }
+}
+export async function fetchJsonValue(url, options) {
+    const text = await fetchText(url, options);
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error("Release metadata is not valid JSON");
+    }
+}
+export async function downloadFile(url, destination, options) {
+    const expected = options.sha256?.toLowerCase();
+    if (expected !== undefined && !/^[0-9a-f]{64}$/.test(expected))
+        throw new Error("A SHA-256 checksum is required for downloads");
+    const guard = stallGuard(options);
+    const partial = `${destination}.part`;
+    try {
+        await rm(partial, { force: true });
+        const response = await open(url, options, guard.signal);
+        if (!response.ok) {
+            await response.body?.cancel().catch(() => undefined);
+            throw new Error(`Download failed: HTTP ${response.status} (${new URL(url).hostname})`);
+        }
+        const encoding = response.headers.get("content-encoding")?.toLowerCase();
+        const declared = encoding && encoding !== "identity" ? 0 : Number(response.headers.get("content-length"));
+        const total = options.bytes ?? (Number.isFinite(declared) && declared > 0 ? declared : undefined);
+        const refuse = async (message) => {
+            await response.body?.cancel().catch(() => undefined);
+            throw new Error(message);
+        };
+        if ((total ?? 0) > options.maxBytes)
+            await refuse(`Download exceeds ${options.maxBytes} bytes`);
+        if (options.bytes !== undefined && declared > 0 && declared !== options.bytes) {
+            await refuse(`Download size ${declared} does not match the published size ${options.bytes}`);
+        }
+        if (!response.body)
+            throw new Error("Empty download");
+        const hash = createHash("sha256");
+        let received = 0;
+        let reported = 0;
+        async function* counted(body) {
+            for await (const chunk of chunksOf(body, guard.signal)) {
+                guard.touch();
+                received += chunk.byteLength;
+                if (received > options.maxBytes || (total !== undefined && received > total)) {
+                    throw new Error(`Download exceeds ${total ?? options.maxBytes} bytes`);
+                }
+                hash.update(chunk);
+                if (received - reported >= PROGRESS_STEP_BYTES) {
+                    reported = received;
+                    options.onProgress?.(received, total);
+                }
+                yield chunk;
+            }
+        }
+        await pipeline(Readable.from(counted(response.body)), createWriteStream(partial, { flags: "wx", mode: 0o600 }), { signal: guard.signal });
+        if (received === 0 || (total !== undefined && received !== total))
+            throw new Error("Incomplete download");
+        const digest = hash.digest("hex");
+        if (expected !== undefined && digest !== expected)
+            throw new Error("Downloaded file checksum mismatch");
+        options.onProgress?.(received, total);
+        await publish(partial, destination);
+        return { bytes: received, sha256: digest };
+    }
+    catch (error) {
+        await rm(partial, { force: true }).catch(() => undefined);
+        throw guard.signal.aborted && guard.signal.reason instanceof Error ? guard.signal.reason : error;
+    }
+    finally {
+        guard.stop();
+    }
+}
+//# sourceMappingURL=download.js.map

package/dist/rea/download.js.map

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

package/dist/rea/engine-report.d.ts

@@ -0,0 +1,4 @@
+import type { ReaBlockedGroup } from "./availability.js";
+import type { EngineReport } from "./engine-status.js";
+export declare function describeEngines(report: EngineReport, blocked?: readonly ReaBlockedGroup[]): string;
+export declare function engineSummary(report: EngineReport): string;

package/dist/rea/engine-report.js

@@ -0,0 +1,77 @@
+import { bundlesDecompiler, ghidraHostProblem, GHIDRA_SERIES } from "./ghidra.js";
+const LABELS = { ghidra: "Ghidra", hopper: "Hopper", ida: "IDA", kuna: "Kuna" };
+const FALLBACK_ENGINES = ["ghidra", "hopper", "ida", "kuna"];
+const MAX_BLOCKED_LINES = 8;
+const code = (text) => `\`${text}\``;
+function hint(engine, report) {
+    const { host, settings, found } = report;
+    const windows = host.platform === "win32";
+    if (engine === "ghidra") {
+        const lines = [];
+        if (settings.ghidra)
+            lines.push(`configured: ${code(settings.ghidra.dir)} (${settings.ghidra.managed ? "installed by clai" : "your own installation"}${settings.ghidra.version ? `, ${settings.ghidra.version}` : ""})`);
+        const existing = found.find((entry) => entry.dir !== settings.ghidra?.dir);
+        if (existing) {
+            lines.push(`found ${existing.version} at ${code(existing.dir)}${existing.decompiler ? "" : " (no native decompiler for this machine)"}`);
+            if (existing.decompiler)
+                lines.push(code(`/rea engines use ghidra ${existing.dir}`));
+        }
+        const unsupported = ghidraHostProblem(host);
+        if (unsupported)
+            lines.push(unsupported);
+        else
+            lines.push(`${code("/rea engines install ghidra")} official Ghidra ${GHIDRA_SERIES}.x from github.com, about 570 MB, checksum verified${bundlesDecompiler(host) ? "" : ", then builds its native decompiler once (needs make, a C++ compiler and bison)"}`);
+        lines.push(`${code("/rea engines use ghidra <folder>")} point at an extracted Ghidra you already have`);
+        if (windows)
+            lines.push("REA's Windows Ghidra support is experimental (x64 only)");
+        return lines;
+    }
+    if (engine === "hopper") {
+        return windows
+            ? ["Hopper is not available on Windows"]
+            : [`commercial app: install it yourself (hopperapp.com), then ${code("/rea engines use hopper <launcher path>")}`];
+    }
+    if (engine === "ida")
+        return [`needs your IDA installation plus an MCP registration: ${code("/rea engines use ida <registration.json>")}`];
+    if (engine === "kuna") {
+        return windows
+            ? ["Kuna is not supported on Windows"]
+            : [`bring your own executable: ${code("/rea engines use kuna <executable>")} (ELF and thin Mach-O only)`];
+    }
+    return [];
+}
+function engineLines(engine, report) {
+    const head = `${engine.ready ? "✓" : "✗"} ${LABELS[engine.id] ?? engine.name}${engine.ready ? " · ready" : engine.reason ? ` · ${engine.reason}` : " · not available"}`;
+    return [head, ...(engine.ready ? [] : hint(engine.id, report).map((line) => `    ${line}`))];
+}
+export function describeEngines(report, blocked = []) {
+    const lines = [];
+    if (report.rea.state === "ready")
+        lines.push(`REA ${report.rea.installation.version} is installed.`);
+    else
+        lines.push(`REA is not installed: run ${code("/rea setup")} first, then ${code("/rea engines")}.`);
+    lines.push("", "Native decompilation (procedures, pseudocode, strings, cross-references) needs one analysis engine:", "");
+    const engines = report.availability?.engines.length
+        ? report.availability.engines
+        : FALLBACK_ENGINES.map((id) => ({ id, name: LABELS[id], ready: false, reason: report.failure }));
+    for (const engine of engines)
+        lines.push(...engineLines(engine, report));
+    if (report.failure && report.rea.state === "ready")
+        lines.push("", `Could not read REA's engine report: ${report.failure}`);
+    lines.push("", "Without an engine REA still handles JavaScript and Electron apps, .NET assemblies, archives, Mach-O headers, plists and signatures.", `Engines are installed only when you run ${code("/rea engines install")}; the agent never installs or configures them.`);
+    if (blocked.length > 0) {
+        lines.push("", "Other tasks that need extra tools on this machine:");
+        for (const group of blocked.slice(0, MAX_BLOCKED_LINES))
+            lines.push(`  ${group.tools.slice(0, 3).join(", ")}${group.tools.length > 3 ? ", …" : ""}: ${group.remediation}`);
+        if (blocked.length > MAX_BLOCKED_LINES)
+            lines.push(`  … and ${blocked.length - MAX_BLOCKED_LINES} more`);
+    }
+    return lines.join("\n");
+}
+export function engineSummary(report) {
+    const ready = report.availability?.engines.filter((engine) => engine.ready) ?? [];
+    if (ready.length > 0)
+        return `engine ready: ${ready.map((engine) => LABELS[engine.id] ?? engine.name).join(", ")}`;
+    return "no analysis engine ready · /rea engines";
+}
+//# sourceMappingURL=engine-report.js.map

package/dist/rea/engine-report.js.map

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

package/dist/rea/engine-status.d.ts

@@ -0,0 +1,24 @@
+import { type ReaAvailability } from "./availability.js";
+import { type EngineSettings } from "./engines.js";
+import { type EngineHost, type GhidraInspection } from "./ghidra.js";
+import type { ReaStatus } from "./types.js";
+export interface EngineReport {
+    readonly rea: ReaStatus;
+    readonly settings: EngineSettings;
+    readonly availability: ReaAvailability | undefined;
+    readonly failure: string | undefined;
+    readonly found: readonly Extract<GhidraInspection, {
+        ok: true;
+    }>[];
+    readonly host: EngineHost;
+}
+export declare function ghidraSearchPatterns(host: EngineHost, home: string, env?: NodeJS.ProcessEnv): string[];
+export declare function discoverGhidra(host?: EngineHost, patterns?: readonly string[]): Promise<Array<Extract<GhidraInspection, {
+    ok: true;
+}>>>;
+export declare function collectEngineReport(options?: {
+    root?: string;
+    signal?: AbortSignal;
+    host?: EngineHost;
+    patterns?: readonly string[];
+}): Promise<EngineReport>;

package/dist/rea/engine-status.js

@@ -0,0 +1,103 @@
+import { readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, posix, win32 } from "node:path";
+import { parseReaAvailability } from "./availability.js";
+import { engineEnvironment, readEngineSettings } from "./engines.js";
+import { compareVersions, currentHost, inspectGhidraDirectory } from "./ghidra.js";
+import { detectRea, reaRoot } from "./install.js";
+import { runReaNode } from "./node.js";
+const MAX_EXPANSIONS = 200;
+function pathModule(host) {
+    return host.platform === "win32" ? win32 : posix;
+}
+export function ghidraSearchPatterns(host, home, env = process.env) {
+    const path = pathModule(host);
+    const names = ["ghidra*", "Ghidra*", "ghidra_*_PUBLIC"];
+    const under = (...bases) => bases.flatMap((base) => names.map((name) => path.join(base, name)));
+    if (host.platform === "darwin") {
+        return [
+            ...under("/Applications", path.join(home, "Applications"), "/opt", "/usr/local", home, path.join(home, "Downloads"), path.join(home, "tools"), path.join(home, "Tools")),
+            path.join("/opt/homebrew/Caskroom/ghidra", "*", "ghidra_*_PUBLIC"),
+            path.join("/usr/local/Caskroom/ghidra", "*", "ghidra_*_PUBLIC"),
+        ];
+    }
+    if (host.platform === "win32") {
+        const roots = [env.SystemDrive ? `${env.SystemDrive}\\` : "C:\\", env.ProgramFiles, env["ProgramFiles(x86)"], env.LOCALAPPDATA ? path.join(env.LOCALAPPDATA, "Programs") : undefined, home, path.join(home, "Downloads"), path.join(home, "tools")]
+            .filter((entry) => !!entry);
+        return under(...roots);
+    }
+    return under("/opt", "/usr/local", "/usr/share", "/usr/lib", home, path.join(home, "Downloads"), path.join(home, "tools"), path.join(home, ".local", "share"));
+}
+async function expand(pattern, host) {
+    const path = pathModule(host);
+    const { root } = path.parse(pattern);
+    let current = [root || "."];
+    for (const part of pattern.slice(root.length).split(/[\\/]/).filter(Boolean)) {
+        const next = [];
+        for (const base of current) {
+            if (!part.includes("*")) {
+                next.push(path.join(base, part));
+                continue;
+            }
+            const matcher = new RegExp(`^${part.split("*").map((piece) => piece.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join(".*")}$`, host.platform === "linux" ? "" : "i");
+            const entries = await readdir(base, { withFileTypes: true }).catch(() => []);
+            for (const entry of entries) {
+                if (entry.isDirectory() && matcher.test(entry.name))
+                    next.push(path.join(base, entry.name));
+                if (next.length >= MAX_EXPANSIONS)
+                    break;
+            }
+        }
+        current = next.slice(0, MAX_EXPANSIONS);
+    }
+    return current;
+}
+export async function discoverGhidra(host = currentHost(), patterns = ghidraSearchPatterns(host, homedir())) {
+    const candidates = new Set();
+    for (const pattern of patterns) {
+        for (const path of await expand(pattern, host))
+            candidates.add(path);
+    }
+    const found = [];
+    for (const directory of candidates) {
+        for (const candidate of [directory, join(directory, "libexec")]) {
+            const inspection = await inspectGhidraDirectory(candidate, host);
+            if (inspection.ok) {
+                found.push(inspection);
+                break;
+            }
+        }
+    }
+    return found.sort((left, right) => Number(right.decompiler) - Number(left.decompiler) || compareVersions(right.version, left.version));
+}
+function jsonObjectText(text) {
+    const start = text.indexOf("{");
+    return start >= 0 ? text.slice(start) : text;
+}
+export async function collectEngineReport(options = {}) {
+    const root = options.root ?? reaRoot();
+    const host = options.host ?? currentHost();
+    const [rea, settings, found] = await Promise.all([
+        detectRea(root),
+        readEngineSettings(root),
+        discoverGhidra(host, options.patterns),
+    ]);
+    let availability;
+    let failure;
+    if (rea.state === "ready") {
+        try {
+            const output = await runReaNode(rea.installation.node, [rea.installation.entry, "providers", "--json"], {
+                timeout: 90_000, maxBuffer: 16 * 1024 * 1024, env: engineEnvironment(settings),
+                ...(options.signal ? { signal: options.signal } : {}),
+            });
+            availability = parseReaAvailability(jsonObjectText(output));
+            if (!availability)
+                failure = "REA returned an unexpected provider report";
+        }
+        catch (error) {
+            failure = error instanceof Error ? error.message.split("\n")[0] : String(error);
+        }
+    }
+    return { rea, settings, availability, failure, found, host };
+}
+//# sourceMappingURL=engine-status.js.map

package/dist/rea/engine-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-status.js","sourceRoot":"","sources":["../../src/rea/engine-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAwB,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAuB,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,sBAAsB,EAA0C,MAAM,aAAa,CAAC;AAC3H,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,cAAc,GAAG,GAAG,CAAC;AAW3B,SAAS,UAAU,CAAC,IAAgB;IAClC,OAAO,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,IAAY,EAAE,MAAyB,OAAO,CAAC,GAAG;IACvG,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,GAAG,KAAe,EAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,KAAK,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxK,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE,iBAAiB,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE,iBAAiB,CAAC;SAChE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aAChP,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACjK,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,OAAe,EAAE,IAAgB;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,GAAa,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBACjC,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAChK,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5F,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc;oBAAE,MAAM;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAmB,WAAW,EAAE,EAChC,WAA8B,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAEnE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,KAAK,GAAmD,EAAE,CAAC;IACjE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,SAAS,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACzI,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAoG,EAAE;IAEtG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;IAC3C,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,SAAS,CAAC,IAAI,CAAC;QACf,kBAAkB,CAAC,IAAI,CAAC;QACxB,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;KACvC,CAAC,CAAC;IACH,IAAI,YAAyC,CAAC;IAC9C,IAAI,OAA2B,CAAC;IAChC,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;gBACtG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,EAAE,iBAAiB,CAAC,QAAQ,CAAC;gBAC9E,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC,CAAC;YACH,YAAY,GAAG,oBAAoB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC,YAAY;gBAAE,OAAO,GAAG,4CAA4C,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/rea/engines.d.ts

@@ -0,0 +1,43 @@
+export declare const ENGINE_IDS: readonly ["ghidra", "hopper", "ida", "kuna"];
+export type EngineId = typeof ENGINE_IDS[number];
+export interface EngineSettings {
+    readonly ghidra?: {
+        readonly dir: string;
+        readonly managed: boolean;
+        readonly version?: string;
+    };
+    readonly java?: {
+        readonly home: string;
+        readonly managed: boolean;
+        readonly version?: string;
+    };
+    readonly hopper?: {
+        readonly launcher: string;
+    };
+    readonly ida?: {
+        readonly config: string;
+    };
+    readonly kuna?: {
+        readonly command: string;
+    };
+}
+export interface EngineRoots {
+    readonly settings: string;
+    readonly ghidra: string;
+    readonly java: string;
+}
+export declare function engineRoots(root?: string): EngineRoots;
+export declare function stagingName(): string;
+export declare function clearStaging(directory: string): Promise<void>;
+export declare function removeTree(path: string): Promise<void>;
+export interface DiscardOptions {
+    readonly platform?: NodeJS.Platform | undefined;
+    readonly attempts?: number | undefined;
+    readonly delayMs?: number | undefined;
+}
+export declare function discardTree(path: string, options?: DiscardOptions): Promise<"removed" | "busy">;
+export declare function windowsPathProblem(platform: NodeJS.Platform, directory: string, deepestEntry: number): string | undefined;
+export declare function parseEngineSettings(text: string): EngineSettings;
+export declare function readEngineSettings(root?: string): Promise<EngineSettings>;
+export declare function updateEngineSettings(change: (current: EngineSettings) => EngineSettings, root?: string, signal?: AbortSignal): Promise<EngineSettings>;
+export declare function engineEnvironment(settings: EngineSettings, base?: NodeJS.ProcessEnv): Record<string, string>;

package/dist/rea/engines.js

@@ -0,0 +1,160 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { withMcpStorageLock } from "../mcp/storage-lock.js";
+import { publish, reaRoot } from "./install.js";
+export const ENGINE_IDS = ["ghidra", "hopper", "ida", "kuna"];
+const MAX_PATH_CHARS = 1_024;
+const VERSION = /^[0-9A-Za-z._+-]{1,40}$/;
+const WINDOWS_PATH_LIMIT = 259;
+const IN_USE_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
+const STAGING_NAME = /^\.(?:staging-[0-9a-f-]{36}|s-[0-9a-f]{8})$/;
+export function engineRoots(root = reaRoot()) {
+    const base = resolve(root);
+    return {
+        settings: join(base, "engines.json"),
+        ghidra: join(dirname(base), "ghidra"),
+        java: join(dirname(base), "jdk"),
+    };
+}
+export function stagingName() {
+    return `.s-${randomUUID().slice(0, 8)}`;
+}
+export async function clearStaging(directory) {
+    const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+    await Promise.all(entries
+        .filter((entry) => entry.isDirectory() && STAGING_NAME.test(entry.name))
+        .map((entry) => removeTree(join(directory, entry.name)).catch(() => undefined)));
+}
+export function removeTree(path) {
+    return rm(path, { recursive: true, force: true, maxRetries: 8, retryDelay: 100 });
+}
+export async function discardTree(path, options = {}) {
+    const { platform = process.platform, attempts = 20, delayMs = 250 } = options;
+    const trash = join(dirname(path), stagingName());
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            await rename(path, trash);
+            break;
+        }
+        catch (error) {
+            const code = error.code ?? "";
+            if (code === "ENOENT")
+                return "removed";
+            if (platform !== "win32" || !IN_USE_CODES.has(code))
+                throw error;
+            if (attempt >= attempts)
+                return "busy";
+            await delay(delayMs);
+        }
+    }
+    await removeTree(trash);
+    return "removed";
+}
+export function windowsPathProblem(platform, directory, deepestEntry) {
+    if (platform !== "win32")
+        return undefined;
+    const longest = join(directory, stagingName(), "t").length + 1 + deepestEntry;
+    if (longest <= WINDOWS_PATH_LIMIT)
+        return undefined;
+    return `${directory} is too deep for Windows, whose path limit is ${WINDOWS_PATH_LIMIT + 1} characters (this install needs ${longest}). Move clai's data folder somewhere shorter by setting CLAI_DATA_DIR, for example C:\\clai, then run the command again.`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function absolutePath(value) {
+    if (typeof value !== "string" || value.length === 0 || value.length > MAX_PATH_CHARS || value.includes("\0"))
+        return undefined;
+    return isAbsolute(value) ? value : undefined;
+}
+function version(value) {
+    return typeof value === "string" && VERSION.test(value) ? { version: value } : {};
+}
+export function parseEngineSettings(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+    if (!isRecord(parsed))
+        return {};
+    const settings = {};
+    if (isRecord(parsed.ghidra)) {
+        const dir = absolutePath(parsed.ghidra.dir);
+        if (dir)
+            settings.ghidra = { dir, managed: parsed.ghidra.managed === true, ...version(parsed.ghidra.version) };
+    }
+    if (isRecord(parsed.java)) {
+        const home = absolutePath(parsed.java.home);
+        if (home)
+            settings.java = { home, managed: parsed.java.managed === true, ...version(parsed.java.version) };
+    }
+    if (isRecord(parsed.hopper)) {
+        const launcher = absolutePath(parsed.hopper.launcher);
+        if (launcher)
+            settings.hopper = { launcher };
+    }
+    if (isRecord(parsed.ida)) {
+        const config = absolutePath(parsed.ida.config);
+        if (config)
+            settings.ida = { config };
+    }
+    if (isRecord(parsed.kuna)) {
+        const command = absolutePath(parsed.kuna.command);
+        if (command)
+            settings.kuna = { command };
+    }
+    return settings;
+}
+export async function readEngineSettings(root = reaRoot()) {
+    try {
+        return parseEngineSettings(await readFile(engineRoots(root).settings, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+async function writeEngineSettings(settings, root) {
+    const file = engineRoots(root).settings;
+    await mkdir(dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = join(dirname(file), `engines-${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, `${JSON.stringify({ v: 1, ...settings }, null, 2)}\n`, { mode: 0o600, flag: "wx" });
+        await publish(temporary, file);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+}
+export async function updateEngineSettings(change, root = reaRoot(), signal) {
+    return withMcpStorageLock(`rea-engines:${resolve(root)}`, async () => {
+        const next = change(await readEngineSettings(root));
+        await writeEngineSettings(next, resolve(root));
+        return next;
+    }, signal);
+}
+function environmentKey(env, key) {
+    if (process.platform !== "win32")
+        return key;
+    const wanted = key.toLowerCase();
+    return Object.keys(env).find((name) => name.toLowerCase() === wanted) ?? key;
+}
+export function engineEnvironment(settings, base = process.env) {
+    const wanted = [
+        ["GHIDRA_INSTALL_DIR", settings.ghidra?.dir],
+        ["JAVA_HOME", settings.java?.home],
+        ["HOPPER_LAUNCHER_PATH", settings.hopper?.launcher],
+        ["REA_IDA_MCP_CONFIG", settings.ida?.config],
+        ["REA_KUNA_COMMAND", settings.kuna?.command],
+    ];
+    const env = {};
+    for (const [key, value] of wanted) {
+        if (value)
+            env[environmentKey(base, key)] = value;
+    }
+    return env;
+}
+//# sourceMappingURL=engines.js.map