@pentoshi/clai 4.18.0 → 5.0.0

package/dist/rea/guide.js

@@ -0,0 +1,178 @@
+import { join } from "node:path";
+import { REA_SERVER } from "./workflow.js";
+const REFERENCES = [
+    ["javascript-applications.md", "JavaScript, Electron and ASAR workflows"],
+    ["native-and-artifacts.md", "native binaries, archives, SQLite and firmware"],
+    ["android-applications.md", "APK and device analysis"],
+    ["evidence-workflows.md", "Evidence IDs, paging and comparisons"],
+    ["runtime-observation.md", "browser, Electron and process observation"],
+    ["connection-and-recovery.md", "connection problems and provider prerequisites"],
+];
+const SYSTEM_NOTES = {
+    darwin: [
+        "Native decompilation uses Ghidra, Hopper or IDA. `/rea engines install ghidra` sets up Ghidra for you (x64 and arm64) and builds its native decompiler once, which needs the Xcode Command Line Tools (`xcode-select --install`). Hopper is started on demand; complete its first-run demo or licence dialog once in your user session.",
+        "Ghidra opens one architecture at a time, so the agent thins a universal Mach-O with `lipo` first. Hopper opens universal files itself.",
+        "Process capture and runtime observation are available (native PTY).",
+        "Linux-only features are unavailable here: firmware extraction, offline ELF layout, recorded crashes, EVM bytecode, TShark field extraction and sigrok decoding.",
+    ],
+    linux: [
+        "JavaScript/Electron analysis, Ghidra, JADX and firmware tools need a procps-compatible `ps` on PATH. Minimal containers often lack it: install `procps` (or `procps-ng`).",
+        "Native decompilation uses Ghidra, Hopper or IDA. `/rea engines install ghidra` sets up Ghidra: x64 ships a ready decompiler, arm64 builds it once and needs make, a C++ compiler and bison.",
+        "Linux supports the widest range of targets, including firmware, ELF layout, packet and signal tools.",
+    ],
+    win32: [
+        "Static analysis needs no extra software for JavaScript/Electron, .NET, Go, Rust, Flutter and saved captures. Android packages also need JADX and a JDK.",
+        "Native decompilation uses Ghidra's experimental, read-only Windows support for PE files (x64). `/rea engines install ghidra` sets it up with its bundled decompiler. Hopper and Kuna are not available on Windows.",
+        "Linux-only features are unavailable here: firmware extraction, offline ELF layout, recorded crashes, EVM bytecode, TShark field extraction and sigrok decoding. Process capture needs a native PTY (Linux or macOS).",
+    ],
+};
+function statusLine(view) {
+    const progress = view.maintenance ? ` · ${view.maintenance} in progress` : "";
+    if (view.status.state === "missing")
+        return `**Status:** not installed${progress}. Run \`/rea setup\` to install and connect it.`;
+    if (view.status.state === "broken")
+        return `**Status:** needs repair${progress}. ${view.status.reason}`;
+    const installed = `REA ${view.status.installation.version} installed`;
+    if (!view.server)
+        return `**Status:** ${installed} · not running (it starts only when enabled)${progress}`;
+    const detail = view.server.detail ? ` — ${view.server.detail}` : "";
+    const selected = view.selected ? "selected for this session" : "not selected";
+    return `**Status:** ${installed} · ${view.server.status} (${view.server.toolCount} tools) · ${selected}${detail}${progress}`;
+}
+function filesSection(view) {
+    const lines = [
+        "## Files and settings",
+        "",
+        `- Everything lives in \`${view.root}\`: \`current.json\` (the active release), \`versions/\`, \`npm-cache/\` and \`engines.json\` (the engines you set up). Engines that clai installs live beside it in \`ghidra/\` and \`jdk/\`. \`CLAI_DATA_DIR\` moves them all.`,
+        "- `CLAI_REA_NODE` selects the Node executable REA runs on. It must be set before installing; to switch an existing installation, delete `current.json` and run `/rea setup`.",
+        "- clai passes your environment to REA, so engine settings such as `GHIDRA_INSTALL_DIR`, `JAVA_HOME`, `HOPPER_LAUNCHER_PATH`, `REA_GHIDRA_STARTUP_TIMEOUT_MS`, `REA_TSHARK_COMMAND`, `REA_WABT_BIN_DIRECTORY`, `REA_KUNA_COMMAND` and `REA_JEB_MCP_URL` work when set before you start clai. An engine you choose with `/rea engines` takes precedence over the same variable in your environment (for REA only); `/rea engines remove` hands control back.",
+    ];
+    if (view.status.state !== "ready")
+        return lines;
+    const skill = join(view.status.installation.directory, "node_modules", "rea-agents", "skills", "reverse-engineer-anything");
+    return [
+        ...lines,
+        "",
+        "The installed version ships its own detailed references. Ask the agent to read the one you need, or open them yourself:",
+        "",
+        `- \`${join(skill, "SKILL.md")}\``,
+        ...REFERENCES.map(([file, topic]) => `- \`${join(skill, "references", file)}\` — ${topic}`),
+    ];
+}
+export function reaUserGuide(view) {
+    return [
+        "# REA · Reverse Engineer Anything",
+        "",
+        statusLine(view),
+        "",
+        "REA lets the agent inspect software that you only have in shipped form — binaries, packaged apps, Electron and JavaScript bundles, .NET assemblies, Android packages, firmware and saved network captures — and explain how it works, with the evidence behind each claim. clai installs and runs it privately. Nothing is added to other agents, skills or your project's MCP configuration.",
+        "",
+        "## Quick start",
+        "",
+        "1. `/rea setup` installs the latest official release if needed and connects it for this session. The first run can take a minute or more; press Esc to cancel.",
+        "2. Ask for the analysis and name the artifact: `@rea explain how the updater in /Applications/Foo.app works`.",
+        "3. `/rea off` stops its background process when you are done.",
+        "",
+        "You do not have to enable REA yourself. In agent mode the agent can choose it when a task needs it; your permission policy decides whether it asks first.",
+        "",
+        "## When to use it",
+        "",
+        "Use REA when the answer depends on a **shipped artifact** rather than source code:",
+        "",
+        "- native executables, libraries and firmware images",
+        "- Electron and JavaScript applications, ASAR archives, minified bundles",
+        "- .NET assemblies, Android APKs, Flutter apps, Unity IL2CPP metadata, Go and Rust binaries",
+        "- saved network captures (HAR, SAZ), packet captures and SQLite databases",
+        "- runtime behaviour of an application you are authorised to run",
+        "",
+        "Do not use it to read or change a source repository you already have. Normal file and search tools are faster and cheaper.",
+        "",
+        "## Commands",
+        "",
+        "- `/rea` opens a picker with the actions below. `/rea` is the command; `@rea` is the token that attaches REA to a prompt.",
+        "- `/rea setup` installs if needed and connects.",
+        "- `/rea install` installs or repairs without connecting.",
+        "- `/rea update` stages the newest release. A running analysis keeps its version.",
+        "- `/rea use` connects and inserts an editable `@rea` token in your draft.",
+        "- `/rea on` connects without touching the draft. `/rea off` disconnects.",
+        "- `/rea status` reports installation and connection state without starting anything.",
+        "- `/rea reconnect` restarts the connection to adopt an update or repair a fault. It discards the current analysis.",
+        "- `/rea engines` shows which analysis engines are ready and what to run for the rest. `/rea engines install ghidra` downloads and sets up Ghidra after you confirm, `/rea engines install java` adds a private JDK 21, `/rea engines use <ghidra|java|hopper|ida|kuna> <location>` adopts one you already have, and `/rea engines remove <engine>` forgets it. Only you can run these; the agent never installs or configures an engine.",
+        "- `/rea guide` shows this page.",
+        "- `/rea <task>` submits `@rea <task>`.",
+        "- Type `@rea` anywhere in a prompt to select it. It is highlighted like `@mcp:` and `skill:` mentions, and connects REA first if it is installed but not running. A file named `rea` is not affected: use `@./rea` to attach it.",
+        "",
+        "## How the agent uses it",
+        "",
+        "REA has about 200 tools. Sending all of them with every message would be slow and costly, so they stay out of the model's tool list. Three small steps replace that:",
+        "",
+        "1. `@rea` in your prompt, or `rea.manage` called by the agent, connects REA and hands the model a short workflow plus an index of every tool with its required arguments. It is sent once per conversation (roughly 3,500 tokens).",
+        `2. \`mcp.call\` runs a tool as \`mcp.${REA_SERVER}.<tool>\` straight from that index.`,
+        `3. \`mcp.tools server="${REA_SERVER}" query="<tool name>"\` reads one full schema when the agent needs optional fields or a structured argument, or after a call is rejected.`,
+        "",
+        "REA validates arguments strictly: a field a tool does not list is rejected, and clai then shows the agent the accepted names. Results carry **Evidence IDs**. The agent starts from a summary, then pages through the retained evidence with exact filters instead of repeating the analysis. Turning REA on or off never changes the system prompt or the native tool list, so the provider's prompt cache survives it. Compaction and switching models still reset that cache.",
+        "",
+        "## Example prompts",
+        "",
+        "- `@rea show how the Electron app at ~/Downloads/Foo.asar talks to its backend, with evidence`",
+        "- `@rea which Go modules and compiler version was ./agent built with?`",
+        "- `@rea compare the exports of old.asar and new.asar and summarise the behaviour changes`",
+        "- `@rea decompile the licence check in ./target.exe` (needs an engine: `/rea engines`)",
+        "- `@rea list the endpoints in session.har and where the bundle builds each request`",
+        "",
+        "## What REA can analyse",
+        "",
+        "| Target | Needs |",
+        "| --- | --- |",
+        "| Native binaries | Ghidra (`/rea engines install ghidra`), Hopper, IDA or Kuna |",
+        "| JavaScript / Electron | nothing extra (Linux: `ps` from procps) |",
+        "| .NET, Go, Rust, Flutter, IL2CPP | nothing extra (static) |",
+        "| Saved captures (HAR, SAZ) | nothing extra |",
+        "| SQLite databases | Node.js 24.15+ or 26+ |",
+        "| Android APKs | headless JADX and a full JDK |",
+        "| Android devices | adb |",
+        "| Websites | a Chrome-family browser |",
+        "| Packet captures | Wireshark tshark and capinfos |",
+        "| Firmware | Binwalk or Unblob (Linux) |",
+        "| ELF layout, crashes | pwntools (Linux x64) |",
+        "| Process behaviour | Linux or macOS |",
+        "",
+        "Android packages, ELF layout, recorded crashes and EVM bytecode are documented for x64 hosts. Without a native engine REA still inspects JavaScript, .NET, archives, Mach-O headers, plists and signatures. When a tool needs something missing, the agent says what and continues with what is supported; it never installs software itself. You install Ghidra from `/rea engines`, and the other tools are yours to provide.",
+        "",
+        `## On this system (${view.platform})`,
+        "",
+        ...(SYSTEM_NOTES[view.platform] ?? ["REA runs wherever a compatible Node.js does. Engine support depends on the host."]).map((note) => `- ${note}`),
+        "",
+        "REA needs Node.js 22.19+, 24.15+ or 26+ with npm. clai reuses a compatible Node it finds (`CLAI_REA_NODE`, the Node running clai, then PATH) and otherwise downloads the official Node 24 LTS for itself. Linux builds for musl (Alpine) are not published, so install Node there with your package manager.",
+        "",
+        "## Permissions and safety",
+        "",
+        "- `/rea status` and `/rea guide` are read-only. Commands you type run immediately; when the agent installs or connects REA, your permission policy applies.",
+        "- `@rea` connects an installed REA in any mode, because you asked for it. In ask mode only the few tools REA marks read-only can run and the agent cannot install or reconnect it; in plan mode it cannot install or change REA's state. Switch to agent mode for analysis.",
+        "- Under `/permissions default` each REA tool call asks for approval, because almost none of its tools are marked read-only. `auto-allow` and `full-access` (the default for new setups) do not ask.",
+        "- Analysis is local, but the model provider you chose receives the tool results. Do not analyse material you cannot share with it.",
+        "- Static analysis never runs the target. Runtime tools (process capture, browser and Electron observation, Frida, debuggers, adb) execute or attach to software with your permissions. Use them only on targets you own or are authorised to test.",
+        "- Text inside an analysed artifact is untrusted data. The agent is told not to follow instructions found in it.",
+        "",
+        "## Disk, memory and network",
+        "",
+        "- Nothing runs until REA is enabled. Install, update, status and guide never start its server.",
+        "- An install uses about 250 MB with your own Node, or about 450 MB when clai also downloads Node. Releases older than the previous one are removed after 7 days. Ghidra adds about 900 MB (1.6 GB of free space is needed while it installs) and a private JDK about 350 MB, only if you install them. Installing streams to disk and keeps clai itself near 250 MB of memory; building the decompiler on macOS and arm64 Linux runs `make` with at most four jobs for about a minute.",
+        "- Installing needs HTTPS access to `registry.npmjs.org`, plus `nodejs.org` when clai downloads Node. `/rea engines install` uses `api.github.com`, `github.com` and its release CDN for Ghidra, and `api.adoptium.net` for the JDK. Downloads are checksum-verified and package install scripts are disabled.",
+        "- While connected, the REA process typically holds 400-650 MB (measured with REA 6.7.0), and native engines such as Ghidra add their own. `/rea off`, or ending the session, stops it and frees that memory.",
+        "",
+        ...filesSection(view),
+        "",
+        "## Troubleshooting",
+        "",
+        "- **Not installed or needs repair:** run `/rea setup`.",
+        "- **Did not connect:** `/rea status` shows the launch error. `/rea reconnect` retries without reinstalling.",
+        "- **A tool reports a missing engine:** run `/rea engines`. It shows what is ready and the exact command for the rest, such as `/rea engines install ghidra`. Hopper, IDA and Kuna are yours to install; point REA at them with `/rea engines use`.",
+        "- **Ghidra cannot build its decompiler:** on macOS install the Command Line Tools (`xcode-select --install`); on Linux install `build-essential bison` or your distribution's equivalent. Then run the install again.",
+        "- **A call timed out:** the analysis may still be running. Ask the agent to check state and retained Evidence before retrying.",
+        "- **Another session is installing:** wait for it, then check `/rea status`.",
+        `- **Name clash:** a server you configured as \`${REA_SERVER}\` is never replaced. Rename yours to use the managed integration.`,
+        "- **Install stalls or fails:** clai downloads from the hosts above and does not configure a proxy for them, so make sure they are reachable from this machine. A compatible Node on PATH, or `CLAI_REA_NODE`, avoids the `nodejs.org` download.",
+    ].join("\n");
+}
+//# sourceMappingURL=guide.js.map

package/dist/rea/guide.js.map

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

package/dist/rea/hints.d.ts

@@ -0,0 +1,3 @@
+import { type McpFailureHint } from "../mcp/argument-hint.js";
+import type { ReaAvailability } from "./availability.js";
+export declare function reaFailureHint(availability: () => ReaAvailability | undefined): McpFailureHint;

package/dist/rea/hints.js

@@ -0,0 +1,99 @@
+import { argumentHint, isArgumentRejection } from "../mcp/argument-hint.js";
+const PATH_KEYS = /^(?:path|file|file_path|filepath|binary|binary_path|app|app_path|executable|input|input_path|target|target_path)$/i;
+const TARGET_CODES = new Set(["architecture_unsupported", "target_format_unsupported", "target_unsupported"]);
+const OPEN_TOOL = "open_binary";
+const PROVIDER_ID = /^[a-z][a-z0-9-]{0,31}$/;
+const REJECTION_CODE = /^[a-z][a-z0-9_]{0,47}$/;
+const MAX_SUMMARY_CHARS = 120;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorOf(output) {
+    const text = output.trimStart();
+    if (!text.startsWith("{"))
+        return undefined;
+    try {
+        const parsed = JSON.parse(text);
+        return isRecord(parsed) && isRecord(parsed.error) ? parsed.error : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function rejections(details) {
+    if (!Array.isArray(details.rejections))
+        return [];
+    return details.rejections.flatMap((entry) => {
+        if (!isRecord(entry) || typeof entry.provider_id !== "string" || !PROVIDER_ID.test(entry.provider_id))
+            return [];
+        if (typeof entry.code !== "string" || !REJECTION_CODE.test(entry.code))
+            return [];
+        const diagnostics = isRecord(entry.diagnostics) ? entry.diagnostics : {};
+        const architectures = Array.isArray(diagnostics.available_architectures)
+            ? diagnostics.available_architectures.filter((value) => typeof value === "string" && /^[A-Za-z0-9_]{1,16}$/.test(value))
+            : [];
+        return [{
+                provider: entry.provider_id,
+                code: entry.code,
+                architectures,
+                universal: diagnostics.target_format === "mach-o-universal",
+            }];
+    });
+}
+function describe(code) {
+    switch (code) {
+        case "not_configured": return "not configured";
+        case "executable_missing": return "launcher or runtime missing";
+        case "architecture_unsupported": return "cannot open a universal Mach-O";
+        case "target_format_unsupported": return "does not support this file format";
+        default: return code.replace(/_/g, " ").slice(0, MAX_SUMMARY_CHARS);
+    }
+}
+function providerFailure(operation, error) {
+    const details = isRecord(error.details) ? error.details : undefined;
+    if (!details || !Array.isArray(details.candidate_ids) || details.candidate_ids.length === 0)
+        return undefined;
+    const found = rejections(details);
+    if (found.length === 0)
+        return undefined;
+    const tool = typeof details.operation === "string" && /^[A-Za-z0-9_]{1,64}$/.test(details.operation) ? details.operation : operation;
+    const byProvider = new Map();
+    for (const entry of found)
+        byProvider.set(entry.provider, [...(byProvider.get(entry.provider) ?? []), entry]);
+    const states = [...byProvider].map(([provider, entries]) => `${provider}: ${[...new Set(entries.map((entry) => describe(entry.code)))].join(" and ")}`);
+    const unusable = [...byProvider.values()].filter((entries) => entries.some((entry) => !TARGET_CODES.has(entry.code))).length;
+    const blockedByTarget = [...byProvider.values()].some((entries) => entries.every((entry) => TARGET_CODES.has(entry.code)));
+    const lines = [`REA ${tool} needs an analysis engine (tools marked ^) and none can serve this target now:`, ...states.map((state) => `- ${state}`)];
+    const universal = found.find((entry) => entry.universal);
+    if (universal && blockedByTarget) {
+        const architectures = [...new Set(found.flatMap((entry) => entry.architectures))];
+        lines.push(`This target is a universal Mach-O${architectures.length > 0 ? ` (${architectures.join(", ")})` : ""}. Thin one slice into the session scratch directory, for example lipo "<path>" -thin <arch> -output "<scratch>/<name>-<arch>", call ${OPEN_TOOL} on that file, then retry.`);
+    }
+    if (unusable === byProvider.size) {
+        lines.push("No engine is ready. Do not retry this or other ^ tools and do not install anything yourself: tell the user to run /rea engines (it can install Ghidra on request), and continue with # tools that lack ^ and other REA tools.");
+    }
+    return lines.join("\n");
+}
+function outsideSchema(context) {
+    const known = new Set(Object.keys(context.tool.inputSchema.properties));
+    return Object.keys(context.args).filter((key) => !known.has(key));
+}
+export function reaFailureHint(availability) {
+    return (context) => {
+        const { tool, output } = context;
+        const error = errorOf(output);
+        if (error?.code === "provider_unavailable")
+            return providerFailure(tool.toolName, error);
+        if (error?.code === "target_unavailable") {
+            return `${output}\nNo target is open. If the user already named a target, call mcp.clai-rea.${OPEN_TOOL} with its absolute path now, then retry this call.`;
+        }
+        if (!isArgumentRejection(output))
+            return undefined;
+        const stray = outsideSchema(context).filter((key) => PATH_KEYS.test(key));
+        const marks = availability();
+        if (stray.length === 0 || (marks && !marks.open.has(tool.toolName)))
+            return undefined;
+        return `${output}\n${argumentHint(tool)}\n${tool.toolName} acts on the binary opened by ${OPEN_TOOL} and takes no ${stray[0]} argument: call mcp.clai-rea.${OPEN_TOOL} once with {"path": <absolute path>}, then call ${tool.toolName} again without ${stray[0]}.`;
+    };
+}
+//# sourceMappingURL=hints.js.map

package/dist/rea/hints.js.map

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

package/dist/rea/install.d.ts

@@ -0,0 +1,10 @@
+import type { ReaInstallOptions, ReaMaintenanceAction, ReaMaintenanceResult, ReaProgress, ReaStatus } from "./types.js";
+export declare const reaRoot: () => string;
+export declare function reaMaintenance(root?: string): {
+    action: ReaMaintenanceAction;
+    progress?: ReaProgress;
+} | undefined;
+export declare function subscribeReaProgress(listener: (root: string, progress: ReaProgress) => void): () => void;
+export declare function detectRea(root?: string, verify?: boolean): Promise<ReaStatus>;
+export declare function publish(pointer: string, destination: string): Promise<void>;
+export declare function runReaMaintenance(action: ReaMaintenanceAction, options?: ReaInstallOptions): Promise<ReaMaintenanceResult>;

package/dist/rea/install.js

@@ -0,0 +1,173 @@
+import { randomUUID } from "node:crypto";
+import { access, mkdir, mkdtemp, readdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { withMcpStorageLock } from "../mcp/storage-lock.js";
+import { McpTransportError } from "../mcp/transport.js";
+import { getDataDir } from "../store/paths.js";
+import { fetchBytes, jsonObject, npmRelease, verifyIntegrity } from "./distribution.js";
+import { resolveReaNode, runReaNode } from "./node.js";
+const PRUNE_AFTER_MS = 7 * 24 * 60 * 60 * 1000;
+const PUBLISH_ATTEMPTS = 8;
+const operations = new Map();
+const listeners = new Set();
+const describe = (error) => error instanceof Error ? error.message : String(error);
+const failure = (error) => error instanceof McpTransportError && error.kind === "timeout"
+    ? "Another clai session is installing or updating REA. Wait for it to finish, then check /rea status."
+    : describe(error);
+export const reaRoot = () => resolve(getDataDir(), "tools", "rea");
+export function reaMaintenance(root = reaRoot()) {
+    const current = operations.get(root);
+    return current ? { action: current.action, ...(current.progress ? { progress: current.progress } : {}) } : undefined;
+}
+export function subscribeReaProgress(listener) {
+    listeners.add(listener);
+    return () => { listeners.delete(listener); };
+}
+function inside(parent, path) {
+    const local = relative(parent, path);
+    return local !== "" && !isAbsolute(local) && local !== ".." && !local.startsWith("../") && !local.startsWith("..\\");
+}
+export async function detectRea(root = reaRoot(), verify = false) {
+    let text;
+    try {
+        text = await readFile(join(root, "current.json"), "utf8");
+    }
+    catch (error) {
+        return error.code === "ENOENT"
+            ? { state: "missing" }
+            : { state: "broken", reason: describe(error) };
+    }
+    try {
+        const data = jsonObject(JSON.parse(text));
+        const { version, node, entry, directory } = data;
+        if (typeof version !== "string" || !/^\d+\.\d+\.\d+$/.test(version) ||
+            typeof node !== "string" || !isAbsolute(node) || typeof entry !== "string" ||
+            typeof directory !== "string" || !inside(join(root, "versions"), directory) || !inside(directory, entry)) {
+            throw new Error("Invalid managed REA installation record");
+        }
+        const installation = { version, node, entry, directory };
+        await Promise.all([access(node), access(entry)]);
+        if (verify)
+            await verifyInstallation(installation);
+        return { state: "ready", installation };
+    }
+    catch (error) {
+        return { state: "broken", reason: `${describe(error)} · repair with /rea install` };
+    }
+}
+export async function publish(pointer, destination) {
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            await rename(pointer, destination);
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            const sharing = code === "EPERM" || code === "EACCES" || code === "EBUSY";
+            if (process.platform !== "win32" || !sharing || attempt >= PUBLISH_ATTEMPTS)
+                throw error;
+            await delay(Math.min(25 * 2 ** attempt, 200));
+        }
+    }
+}
+async function pruneVersions(root, keep) {
+    const versions = join(root, "versions");
+    const entries = await readdir(versions, { withFileTypes: true }).catch(() => []);
+    const cutoff = Date.now() - PRUNE_AFTER_MS;
+    await Promise.all(entries.map(async (entry) => {
+        const directory = join(versions, entry.name);
+        if (!entry.isDirectory() || keep.includes(directory))
+            return;
+        const info = await stat(directory).catch(() => undefined);
+        if (info && info.mtimeMs < cutoff)
+            await rm(directory, { force: true, recursive: true }).catch(() => undefined);
+    }));
+}
+async function verifyInstallation(installation, signal) {
+    const reported = await runReaNode(installation.node, [installation.entry, "--version"], {
+        ...(signal ? { signal } : {}), timeout: 30_000,
+    });
+    if (!new RegExp(`(?:^|\\s)${installation.version.replace(/\./g, "\\.")}(?:$|\\s)`).test(reported)) {
+        throw new Error(`REA version verification failed: expected ${installation.version}, got ${reported.slice(0, 200)}`);
+    }
+}
+async function install(action, root, options) {
+    const { signal, onProgress } = options;
+    signal?.throwIfAborted();
+    const before = await detectRea(root, true);
+    if (action === "install" && before.state === "ready")
+        return { ok: true, installation: before.installation, changed: false };
+    onProgress?.({ phase: "resolving", message: "Checking the latest official REA release" });
+    const release = await npmRelease("rea-agents", "latest", signal);
+    if (before.state === "ready" && before.installation.version === release.version) {
+        return { ok: true, installation: before.installation, changed: false };
+    }
+    const versions = join(root, "versions");
+    await mkdir(versions, { recursive: true, mode: 0o700 });
+    const directory = await mkdtemp(join(versions, `${release.version}-`));
+    const pointer = join(root, `current-${randomUUID()}.json`);
+    let published = false;
+    try {
+        const runtime = await resolveReaNode(join(directory, "runtime"), options);
+        signal?.throwIfAborted();
+        onProgress?.({ phase: "downloading", message: `Downloading REA ${release.version}` });
+        const bytes = await fetchBytes(release.tarball, 64 * 1024 * 1024, signal, (receivedBytes, totalBytes) => {
+            onProgress?.({ phase: "downloading", message: `Downloading REA ${release.version}`, receivedBytes, ...(totalBytes ? { totalBytes } : {}) });
+        });
+        verifyIntegrity(bytes, release.integrity);
+        const archive = join(directory, "rea.tgz");
+        const userConfig = join(directory, "user.npmrc");
+        const globalConfig = join(directory, "global.npmrc");
+        await Promise.all([
+            writeFile(archive, bytes, { mode: 0o600, flag: "wx" }),
+            writeFile(join(directory, "package.json"), JSON.stringify({ private: true }), { mode: 0o600, flag: "wx" }),
+            writeFile(userConfig, "", { mode: 0o600, flag: "wx" }),
+            writeFile(globalConfig, "", { mode: 0o600, flag: "wx" }),
+        ]);
+        onProgress?.({ phase: "installing", message: `Installing REA ${release.version} and its dependencies privately` });
+        await runReaNode(runtime.node, [runtime.npm, "install", archive,
+            "--ignore-scripts", "--no-audit", "--no-fund", "--no-update-notifier", "--loglevel=error",
+            "--registry=https://registry.npmjs.org", `--userconfig=${userConfig}`, `--globalconfig=${globalConfig}`,
+            `--cache=${join(root, "npm-cache")}`, "--engine-strict", "--fetch-retries=2", "--fetch-timeout=120000",
+        ], { cwd: directory, ...(signal ? { signal } : {}), timeout: 600_000 });
+        const installation = {
+            version: release.version, node: runtime.node, directory,
+            entry: join(directory, "node_modules", "rea-agents", "scripts", "rea.mjs"),
+        };
+        onProgress?.({ phase: "verifying", message: `Verifying REA ${release.version}` });
+        await verifyInstallation(installation, signal);
+        signal?.throwIfAborted();
+        await writeFile(pointer, JSON.stringify(installation), { mode: 0o600, flag: "wx" });
+        await publish(pointer, join(root, "current.json"));
+        published = true;
+        await rm(archive, { force: true }).catch(() => undefined);
+        await pruneVersions(root, [directory, ...(before.state === "ready" ? [before.installation.directory] : [])]);
+        return { ok: true, installation, changed: true };
+    }
+    finally {
+        await rm(pointer, { force: true }).catch(() => undefined);
+        if (!published)
+            await rm(directory, { force: true, recursive: true }).catch(() => undefined);
+    }
+}
+export function runReaMaintenance(action, options = {}) {
+    const root = resolve(options.root ?? reaRoot());
+    const existing = operations.get(root);
+    if (existing)
+        return existing.promise;
+    const onProgress = (progress) => {
+        const operation = operations.get(root);
+        if (operation)
+            operation.progress = progress;
+        options.onProgress?.(progress);
+        for (const listener of listeners)
+            listener(root, progress);
+    };
+    const promise = withMcpStorageLock(`rea:${root}`, () => install(action, root, { ...options, onProgress }), options.signal)
+        .catch((error) => ({ ok: false, reason: failure(error) }))
+        .finally(() => { operations.delete(root); });
+    operations.set(root, { action, promise });
+    return promise;
+}
+//# sourceMappingURL=install.js.map

package/dist/rea/install.js.map

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

package/dist/rea/jdk.d.ts

@@ -0,0 +1,50 @@
+import { type FetchFunction } from "./download.js";
+import { type EngineHost, type EngineProgress } from "./ghidra.js";
+export declare const JDK_MAJOR = 21;
+export interface JdkRelease {
+    readonly name: string;
+    readonly url: string;
+    readonly bytes: number;
+    readonly sha256: string;
+    readonly format: "tar.gz" | "zip";
+}
+export type JdkResolution = {
+    readonly ok: true;
+    readonly release: JdkRelease;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export interface InstallJdkOptions {
+    readonly root?: string;
+    readonly release: JdkRelease;
+    readonly host?: EngineHost;
+    readonly signal?: AbortSignal | undefined;
+    readonly onProgress?: ((progress: EngineProgress) => void) | undefined;
+    readonly fetch?: FetchFunction | undefined;
+    readonly probe?: ((home: string, platform: NodeJS.Platform) => Promise<string | undefined>) | undefined;
+}
+export type InstallJdkResult = {
+    readonly ok: true;
+    readonly home: string;
+    readonly version: string;
+    readonly changed: boolean;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export declare function temurinQuery(host: EngineHost, musl?: boolean): {
+    os: string;
+    architecture: string;
+} | undefined;
+export declare function selectTemurinRelease(assets: unknown): JdkRelease;
+export declare function resolveJdkRelease(host?: EngineHost, options?: {
+    signal?: AbortSignal | undefined;
+    fetch?: FetchFunction | undefined;
+    musl?: boolean;
+}): Promise<JdkResolution>;
+export declare function jdkDiskBytes(release: JdkRelease): number;
+export declare function javaHomeIn(tree: string, platform: NodeJS.Platform): string;
+export declare function javaExecutable(home: string, platform?: NodeJS.Platform): string;
+export declare function javaVersion(home: string, platform?: NodeJS.Platform): Promise<string | undefined>;
+export declare function installJdk(options: InstallJdkOptions): Promise<InstallJdkResult>;