@pentoshi/clai 4.19.0 → 5.1.0

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>;

package/dist/rea/jdk.js

@@ -0,0 +1,171 @@
+import { execFile } from "node:child_process";
+import { mkdir, readdir, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { withMcpStorageLock } from "../mcp/storage-lock.js";
+import { downloadFile, fetchJsonValue } from "./download.js";
+import { clearStaging, discardTree, engineRoots, removeTree, stagingName, updateEngineSettings, windowsPathProblem } from "./engines.js";
+import { currentHost } from "./ghidra.js";
+import { publish, reaRoot } from "./install.js";
+import { ensureFreeSpace, extractZip } from "./zip.js";
+export const JDK_MAJOR = 21;
+const ASSETS_HOST = ["api.adoptium.net"];
+const DOWNLOAD_HOSTS = ["github.com", "*.githubusercontent.com"];
+const RELEASE_PREFIX = `https://github.com/adoptium/temurin${JDK_MAJOR}-binaries/releases/download/`;
+const MIN_ARCHIVE_BYTES = 50_000_000;
+const MAX_ARCHIVE_BYTES = 800_000_000;
+const MAX_EXTRACTED_BYTES = 1_500_000_000;
+const MAX_ENTRIES = 20_000;
+const EXTRACTED_BYTES = 450_000_000;
+const JDK_DIRECTORY = /^jdk-\d/;
+const DEEPEST_ENTRY_CHARS = 80;
+const run = promisify(execFile);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function temurinQuery(host, musl = false) {
+    const architecture = host.arch === "x64" ? "x64" : host.arch === "arm64" ? "aarch64" : undefined;
+    if (!architecture)
+        return undefined;
+    if (host.platform === "darwin")
+        return { os: "mac", architecture };
+    if (host.platform === "win32")
+        return architecture === "x64" ? { os: "windows", architecture } : undefined;
+    if (host.platform === "linux")
+        return musl ? undefined : { os: "linux", architecture };
+    return undefined;
+}
+export function selectTemurinRelease(assets) {
+    if (!Array.isArray(assets))
+        throw new Error("Unexpected JDK release listing");
+    for (const asset of assets) {
+        if (!isRecord(asset) || !isRecord(asset.binary) || !isRecord(asset.binary.package))
+            continue;
+        const { link, checksum, size, name } = asset.binary.package;
+        const release = typeof asset.release_name === "string" ? asset.release_name : "";
+        if (typeof link !== "string" || !link.startsWith(RELEASE_PREFIX) || typeof checksum !== "string" || !/^[0-9a-f]{64}$/.test(checksum))
+            continue;
+        if (typeof size !== "number" || !Number.isInteger(size) || size < MIN_ARCHIVE_BYTES || size > MAX_ARCHIVE_BYTES)
+            continue;
+        if (!new RegExp(`^jdk-${JDK_MAJOR}[0-9A-Za-z.+_-]*$`).test(release))
+            continue;
+        const format = typeof name === "string" && name.endsWith(".tar.gz") ? "tar.gz" : typeof name === "string" && name.endsWith(".zip") ? "zip" : undefined;
+        if (format)
+            return { name: release, url: link, bytes: size, sha256: checksum, format };
+    }
+    throw new Error(`No official Temurin ${JDK_MAJOR} JDK with a published checksum was found for this system`);
+}
+export async function resolveJdkRelease(host = currentHost(), options = {}) {
+    const query = temurinQuery(host, options.musl ?? host.musl ?? false);
+    if (!query) {
+        return { ok: false, reason: `No official portable JDK ${JDK_MAJOR} exists for ${host.platform}/${host.arch}${host.platform === "linux" ? " (musl libc is not covered)" : ""}. Install a 64-bit JDK ${JDK_MAJOR} or newer yourself and run /rea engines use java <JDK home>.` };
+    }
+    const url = `https://api.adoptium.net/v3/assets/latest/${JDK_MAJOR}/hotspot?architecture=${query.architecture}&image_type=jdk&os=${query.os}&vendor=eclipse`;
+    const assets = await fetchJsonValue(url, { hosts: ASSETS_HOST, maxBytes: 2 * 1024 * 1024, signal: options.signal, fetch: options.fetch });
+    return { ok: true, release: selectTemurinRelease(assets) };
+}
+export function jdkDiskBytes(release) {
+    return release.bytes + EXTRACTED_BYTES;
+}
+export function javaHomeIn(tree, platform) {
+    return platform === "darwin" ? join(tree, "Contents", "Home") : tree;
+}
+export function javaExecutable(home, platform = process.platform) {
+    return join(home, "bin", platform === "win32" ? "java.exe" : "java");
+}
+export async function javaVersion(home, platform = process.platform) {
+    try {
+        const { stderr, stdout } = await run(javaExecutable(home, platform), ["-version"], { timeout: 30_000, windowsHide: true, maxBuffer: 256 * 1024 });
+        return /version "([^"]+)"/.exec(`${stderr}\n${stdout}`)?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+async function extractTarball(archive, destination, signal) {
+    const { x } = await import("tar");
+    let total = 0;
+    let entries = 0;
+    await mkdir(destination, { recursive: true, mode: 0o700 });
+    await x({
+        file: archive, cwd: destination, strip: 1, strict: true, preservePaths: false, preserveOwner: false, noMtime: true,
+        maxDecompressionRatio: 200,
+        filter: (_path, entry) => {
+            entries += 1;
+            total += "size" in entry ? entry.size : 0;
+            if (entries > MAX_ENTRIES || total > MAX_EXTRACTED_BYTES)
+                throw new Error("The JDK archive exceeds extraction limits");
+            return true;
+        },
+    });
+    signal?.throwIfAborted();
+}
+const operations = new Map();
+async function install(options, root) {
+    const { release, signal, onProgress } = options;
+    const host = options.host ?? currentHost();
+    const roots = engineRoots(root);
+    const target = join(roots.java, release.name);
+    const home = javaHomeIn(target, host.platform);
+    signal?.throwIfAborted();
+    const present = await stat(javaExecutable(home, host.platform)).then((info) => info.isFile(), () => false);
+    const probe = options.probe ?? javaVersion;
+    const known = present ? await probe(home, host.platform) : undefined;
+    if (known) {
+        await updateEngineSettings((current) => ({ ...current, java: { home, managed: true, version: release.name } }), root, signal);
+        return { ok: true, home, version: known, changed: false };
+    }
+    const tooDeep = windowsPathProblem(host.platform, roots.java, DEEPEST_ENTRY_CHARS);
+    if (tooDeep)
+        throw new Error(tooDeep);
+    await mkdir(roots.java, { recursive: true, mode: 0o700 });
+    await clearStaging(roots.java);
+    await ensureFreeSpace(roots.java, jdkDiskBytes(release));
+    const staging = join(roots.java, stagingName());
+    await mkdir(staging, { mode: 0o700 });
+    try {
+        const archive = join(staging, `jdk.${release.format}`);
+        onProgress?.({ phase: "downloading", message: `Downloading JDK ${release.name}`, totalBytes: release.bytes });
+        await downloadFile(release.url, archive, {
+            hosts: DOWNLOAD_HOSTS, maxBytes: MAX_ARCHIVE_BYTES, sha256: release.sha256, bytes: release.bytes, signal, fetch: options.fetch,
+            onProgress: (receivedBytes, totalBytes) => onProgress?.({ phase: "downloading", message: `Downloading JDK ${release.name}`, receivedBytes, totalBytes: totalBytes ?? release.bytes }),
+        });
+        const tree = join(staging, "t");
+        onProgress?.({ phase: "extracting", message: `Extracting JDK ${release.name}` });
+        if (release.format === "zip")
+            await extractZip(archive, tree, { strip: 1, signal, limits: { totalBytes: MAX_EXTRACTED_BYTES, entries: MAX_ENTRIES } });
+        else
+            await extractTarball(archive, tree, signal);
+        await rm(archive, { force: true });
+        onProgress?.({ phase: "verifying", message: `Checking the JDK runs on this machine` });
+        const version = await probe(javaHomeIn(tree, host.platform), host.platform);
+        if (!version)
+            throw new Error(`The downloaded JDK does not run on ${host.platform}/${host.arch}`);
+        signal?.throwIfAborted();
+        if (await discardTree(target) === "busy")
+            throw new Error(`${target} is in use by another program. Stop REA with /rea disable, then run the install again.`);
+        await publish(tree, target);
+        await updateEngineSettings((current) => ({ ...current, java: { home, managed: true, version: release.name } }), root, signal);
+        const siblings = await readdir(roots.java, { withFileTypes: true }).catch(() => []);
+        await Promise.all(siblings
+            .filter((entry) => entry.isDirectory() && entry.name !== release.name && JDK_DIRECTORY.test(entry.name))
+            .map((entry) => discardTree(join(roots.java, entry.name)).catch(() => undefined)));
+        return { ok: true, home, version, changed: true };
+    }
+    finally {
+        await removeTree(staging).catch(() => undefined);
+    }
+}
+export function installJdk(options) {
+    const root = options.root ?? reaRoot();
+    const key = `jdk:${engineRoots(root).java}`;
+    const running = operations.get(key);
+    if (running)
+        return running;
+    const promise = withMcpStorageLock(`rea-engine:${key}`, () => install(options, root), options.signal)
+        .catch((error) => ({ ok: false, reason: error instanceof Error ? error.message : String(error) }))
+        .finally(() => { operations.delete(key); });
+    operations.set(key, promise);
+    return promise;
+}
+//# sourceMappingURL=jdk.js.map

package/dist/rea/jdk.js.map

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

package/dist/rea/node.d.ts

@@ -0,0 +1,22 @@
+import type { ReaInstallOptions } from "./types.js";
+export interface ReaNode {
+    readonly node: string;
+    readonly npm: string;
+}
+export declare function supportsReaNode(version: string): boolean;
+export declare function reaEnvironment(node: string): NodeJS.ProcessEnv;
+export declare function runReaNode(node: string, args: readonly string[], options?: {
+    cwd?: string;
+    signal?: AbortSignal;
+    timeout?: number;
+    env?: Readonly<Record<string, string>>;
+    maxBuffer?: number;
+}): Promise<string>;
+export declare function isNodeExecutable(path: string): boolean;
+export declare function nodeTarget(platform: NodeJS.Platform, arch: string, musl?: boolean): string;
+export declare function downloadReaNode(directory: string, host: {
+    readonly platform: NodeJS.Platform;
+    readonly arch: string;
+    readonly musl?: boolean;
+}, options?: ReaInstallOptions): Promise<ReaNode>;
+export declare function resolveReaNode(directory: string, options?: ReaInstallOptions): Promise<ReaNode>;