humanish 0.105.0 → 0.106.0

package/dist/local-firecracker-desktop.js

@@ -1,191 +0,0 @@
-import { desktopRecordingConfigSchema } from "./desktop-recording-types.js";
-import { randomUUID } from "node:crypto";
-import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { connect, createServer } from "node:net";
-import path from "node:path";
-import { setTimeout as delay } from "node:timers/promises";
-import { connectGuestBootstrap, validateGuestInitialUrl } from "./guest-bootstrap.js";
-import { ownDesktopAllocation } from "./desktop-session.js";
-import { runtimeDocker, runtimeExec, usesLima } from "./local-runtime-host.js";
-import { openLimaTunnel } from "./local-runtime-ssh.js";
-import { guestMediaConfigSchema } from "./guest-media-config.js";
-const docker = async (args) => (await runtimeDocker(args, {}, 60_000)).stdout.trim();
-const readLogs = async (id) => {
-    const result = await runtimeDocker(["logs", "--tail", "100", id], {}, 10_000);
-    return result.stdout + result.stderr;
-};
-/** One VM with opaque TCP forwards to the selected app and optional scoped inbox. */
-export async function createLocalFirecrackerDesktop(options) {
-    if (options.media !== undefined) {
-        guestMediaConfigSchema.parse(options.media);
-        if (options.assets.media !== true)
-            throw new Error("This local runtime does not include media. Run humanish runtime setup --media.");
-    }
-    if (options.recording !== undefined) {
-        desktopRecordingConfigSchema.parse(options.recording);
-        if (options.assets.media !== true)
-            throw new Error("This runtime does not include the recorder. Run humanish runtime setup --media.");
-    }
-    let url;
-    try {
-        url = new URL(validateGuestInitialUrl(options.appUrl));
-    }
-    catch {
-        throw new Error("Local Firecracker requires a loopback HTTP(S) app on a port above 1023.");
-    }
-    const inbox = options.inboxUrl === undefined ? undefined : new URL(validateGuestInitialUrl(options.inboxUrl));
-    if (inbox && (inbox.protocol !== "http:" || inbox.port === url.port)) {
-        throw new Error("The local inbox requires its own loopback HTTP port.");
-    }
-    options.signal?.throwIfAborted();
-    await mkdir(options.outputRoot, { recursive: true, mode: 0o700 });
-    // Unix socket paths have a small fixed limit; project paths may be much longer.
-    const work = await mkdtemp("/tmp/humanish-fc-");
-    const lima = usesLima();
-    const sockets = new Set();
-    let container;
-    let client;
-    const stop = new AbortController();
-    const signal = options.signal ? AbortSignal.any([options.signal, stop.signal]) : stop.signal;
-    let remoteWork;
-    let tunnel;
-    let socketRoot = path.join(work, "vm"), cidfile = path.join(work, "container-id");
-    let controlSocket = path.join(socketRoot, "vsock.sock");
-    const forwards = [{ url, port: 8000 }, ...(inbox ? [{ url: inbox, port: 8001 }] : [])].map(endpoint => ({
-        port: endpoint.port, server: createServer(incoming => {
-            if (signal.aborted) {
-                incoming.destroy();
-                return;
-            }
-            const target = connect({ host: endpoint.url.hostname, port: Number(endpoint.url.port), autoSelectFamily: true });
-            for (const socket of [incoming, target]) {
-                sockets.add(socket);
-                socket.once("close", () => sockets.delete(socket));
-                socket.on("error", () => { incoming.destroy(); target.destroy(); });
-            }
-            incoming.pipe(target);
-            target.pipe(incoming);
-            incoming.once("close", () => target.destroy());
-            target.once("close", () => incoming.destroy());
-        })
-    }));
-    let closing;
-    const close = () => closing ??= (async () => {
-        stop.abort();
-        client?.close();
-        for (const socket of sockets)
-            socket.destroy();
-        for (const forward of forwards)
-            if (forward.server.listening)
-                forward.server.close();
-        options.signal?.removeEventListener("abort", aborted);
-        // Docker can create the container before its command's reply is interrupted.
-        // Only this invocation's private cidfile is cleanup authority.
-        container ??= await (lima ? runtimeExec("cat", [cidfile]).then(result => result.stdout) : readFile(cidfile, "utf8")).then(value => /^[a-f0-9]{64}$/.test(value.trim()) ? value.trim() : undefined, () => undefined);
-        if (container) {
-            try {
-                await docker(["rm", "--force", "--volumes", container]);
-            }
-            catch (error) {
-                const stderr = error.stderr ?? "";
-                if (!stderr.includes(`No such container: ${container}`))
-                    return { status: "unconfirmed", reason: "release_failed" };
-            }
-        }
-        if (tunnel && !await tunnel.close())
-            return { status: "unconfirmed", reason: "release_failed" };
-        try {
-            if (remoteWork)
-                await runtimeExec("rm", ["-rf", "--", remoteWork]);
-            await rm(work, { recursive: true, force: true });
-        }
-        catch {
-            return { status: "unconfirmed", reason: "release_failed" };
-        }
-        return { status: "released", reason: "terminated" };
-    })();
-    const aborted = () => { void close(); };
-    try {
-        let uid = process.getuid?.() || 1000, gid = process.getgid?.() || 1000;
-        if (lima) {
-            remoteWork = (await runtimeExec("mktemp", ["-d", "/tmp/humanish-fc-XXXXXX"])).stdout.trim();
-            socketRoot = remoteWork;
-            cidfile = `${remoteWork}/container-id`;
-            controlSocket = path.join(work, "vsock.sock");
-            uid = Number((await runtimeExec("id", ["-u"])).stdout.trim());
-            gid = Number((await runtimeExec("id", ["-g"])).stdout.trim());
-            tunnel = await openLimaTunnel({ work, socketRoot, appUrl: url, ...(inbox ? { inboxUrl: inbox } : {}), signal });
-        }
-        else {
-            await mkdir(socketRoot, { mode: 0o700 });
-        }
-        if (!lima)
-            for (const { server, port } of forwards)
-                await new Promise((resolve, reject) => {
-                    server.once("error", reject);
-                    server.listen(path.join(socketRoot, `vsock.sock_${port}`), () => { server.off("error", reject); resolve(); });
-                });
-        const created = await docker(["create", "--rm", "--cidfile", cidfile, "--init", "--user", "0:0", "--read-only", "--cap-drop", "ALL",
-            "--cap-add", "NET_ADMIN", "--cap-add", "SETUID", "--cap-add", "SETGID", "--cap-add", "CHOWN",
-            "--device", "/dev/kvm", "--device", "/dev/net/tun", "--security-opt", "no-new-privileges",
-            "--sysctl", "net.ipv4.ip_forward=1", "--memory", "3g", "--memory-swap", "3g", "--cpus", "2", "--pids-limit", "128",
-            "--tmpfs", "/tmp:rw,nosuid,nodev,size=16m", "--stop-timeout", "5",
-            "--mount", `type=bind,src=${socketRoot},dst=/run/vm`,
-            "--mount", "type=volume,dst=/run/state,volume-nocopy",
-            options.assets.image, url.port, String(uid), String(gid), ...(inbox ? [inbox.port] : [])]);
-        if (!/^[a-f0-9]{64}$/.test(created))
-            throw new Error("Docker did not return a container ID.");
-        container = created;
-        signal.throwIfAborted();
-        await docker(["start", container]);
-        const deadline = performance.now() + 45_000;
-        while (!(await readLogs(container)).includes("HUMANISH_GUEST_LISTENING_V1")) {
-            signal.throwIfAborted();
-            if (await docker(["inspect", "--format", "{{.State.Running}}", container]) !== "true")
-                throw new Error("Firecracker exited during startup.");
-            if (performance.now() >= deadline)
-                throw new Error("Firecracker guest did not become ready.");
-            await delay(200, undefined, { signal });
-        }
-        let stream;
-        while (!stream) {
-            signal.throwIfAborted();
-            if (performance.now() >= deadline)
-                throw new Error("Firecracker browser startup timed out.");
-            stream = await new Promise(resolve => {
-                const socket = connect(controlSocket);
-                socket.once("connect", () => resolve(socket));
-                socket.once("error", () => { socket.destroy(); resolve(undefined); });
-            });
-            if (!stream)
-                await delay(100, undefined, { signal });
-        }
-        const identity = { generation: randomUUID(), challenge: randomUUID(), runtimeRevision: options.assets.runtimeRevision };
-        try {
-            client = await connectGuestBootstrap(stream, identity, signal, url.href, options.media, options.recording);
-        }
-        catch (error) {
-            signal.throwIfAborted();
-            throw new Error("Local browser startup or initial page navigation failed or timed out.", { cause: error });
-        }
-        await client.ready();
-        signal.throwIfAborted();
-        options.signal?.addEventListener("abort", aborted, { once: true });
-        const session = ownDesktopAllocation({ resourceId: container, release: async () => {
-                const result = await close();
-                return result.status === "retained" ? { status: "unconfirmed", reason: "invalid_result" } : result;
-            } }).open(client.executor);
-        const recorderClient = client;
-        return { ...session, finishRecording: destination => recorderClient.finishRecording(destination) };
-    }
-    catch (error) {
-        if (container) {
-            const logs = await readLogs(container).catch(() => "");
-            // Development-only diagnostics stay in the caller's private output directory.
-            await writeFile(path.join(options.outputRoot, `startup-${path.basename(work)}.log`), logs, { mode: 0o600 }).catch(() => undefined);
-        }
-        await close();
-        throw error;
-    }
-}
-//# sourceMappingURL=local-firecracker-desktop.js.map

package/dist/local-firecracker-desktop.js.map

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

package/dist/local-firecracker-study.d.ts

@@ -1,9 +0,0 @@
-import { type LabOutcome, type RunLabOptions } from "./lab-engine.js";
-import type { LabConfig } from "./lab-config.js";
-import { type LocalFirecrackerAssets } from "./local-firecracker-desktop.js";
-/** Local desktop/provider composition over the shared lab runner. */
-export declare function runLocalFirecrackerStudy(options: RunLabOptions & {
-    config: LabConfig;
-    assets?: LocalFirecrackerAssets;
-    signal?: AbortSignal;
-}): Promise<LabOutcome>;

package/dist/local-firecracker-study.js

@@ -1,135 +0,0 @@
-import { collectDesktopRecording } from "./desktop-recording-artifact.js";
-import path from "node:path";
-import { runLab } from "./lab-engine.js";
-import { inboxRecipientFor } from "./cua-desktop-lane.js";
-import { runCuaActorSession } from "./computer-use-actor.js";
-import { createLocalFirecrackerDesktop } from "./local-firecracker-desktop.js";
-import { localBrowserDefaults, localBrowserUnsupportedReason } from "./local-runtime-config.js";
-import { prepareLocalRuntime } from "./local-runtime.js";
-import { checkRestrictedCodexAnalysisReadiness } from "./restricted-codex-analysis.js";
-import { createRestrictedCodexParticipant } from "./restricted-codex-participant.js";
-import { guestMediaConfigSchema } from "./guest-media-config.js";
-import { startLocalCapturedInbox } from "./local-captured-inbox.js";
-/** Local desktop/provider composition over the shared lab runner. */
-export async function runLocalFirecrackerStudy(options) {
-    const config = localBrowserDefaults(options.config);
-    const unsupported = localBrowserUnsupportedReason(config);
-    if (unsupported)
-        throw new Error(unsupported);
-    const recording = config.execution?.desktop?.recording;
-    const declaredMedia = config.execution?.desktop?.media;
-    const media = declaredMedia === undefined ? undefined : guestMediaConfigSchema.parse({
-        ...declaredMedia, permission: config.policies?.mediaPermission ?? "prompt"
-    });
-    const account = config.actors[0]?.type === "local-agent";
-    let preparing;
-    const assets = () => preparing ??= (async () => {
-        if (account) {
-            const readiness = await checkRestrictedCodexAnalysisReadiness({ timeoutMs: 5000 });
-            if (!readiness.ready)
-                throw new Error(`Codex account is not ready (${readiness.errorCode}). Run humanish doctor --lab <lab> before starting a local study.`);
-        }
-        return options.assets ?? await prepareLocalRuntime({
-            ...(media === undefined && recording === undefined ? {} : { media: true }),
-            ...(options.signal ? { signal: options.signal } : {}),
-            progress: message => process.stderr.write(`${message}\n`)
-        });
-    })();
-    const sessions = [];
-    const participants = [];
-    let cleanupUnconfirmed = false;
-    try {
-        return await runLab(config, { ...options,
-            automaticAnalysis: { ...options.automaticAnalysis, onStart() {
-                    if (cleanupUnconfirmed)
-                        throw new Error("Local study cleanup is unconfirmed.");
-                    return options.automaticAnalysis?.onStart?.();
-                } },
-            cuaHooks: {
-                createDesktopLane(spec, warnings, artifactRoot) {
-                    let session;
-                    let inbox;
-                    const email = config.comms?.email;
-                    const address = email?.kind === "fake" ? inboxRecipientFor(email, spec.laneId)?.address : undefined;
-                    let finalizing;
-                    const evidence = { killed: false, streamUrlPresent: false, stateStepRecords: [], phaseRecords: [] };
-                    return {
-                        async prepare() {
-                            const runtime = await assets();
-                            if (address && email?.kind === "fake" && email.external)
-                                inbox = await startLocalCapturedInbox(email.external, address);
-                            session = await createLocalFirecrackerDesktop({ assets: runtime,
-                                ...(inbox ? { inboxUrl: inbox.url } : {}),
-                                ...(media === undefined ? {} : { media }),
-                                ...(recording === undefined ? {} : { recording }),
-                                appUrl: spec.targetUrl ?? config.subject.appUrl, outputRoot: path.join(options.cwd, ".humanish", "local-runtime"),
-                                ...(options.signal === undefined ? {} : { signal: options.signal }) });
-                            sessions.push(session);
-                            if (media !== undefined)
-                                evidence.desktopBrowser = { requested: "chromium", resolved: "chromium", media: {
-                                        ...(media.camera === undefined ? {} : { camera: { source: "synthetic", file: "/dev/video0" } }),
-                                        ...(media.microphone === undefined ? {} : { microphone: { source: "speech" } }),
-                                        permission: media.permission,
-                                        flags: media.permission === "granted" ? ["--use-fake-ui-for-media-stream"] : []
-                                    } };
-                        },
-                        async openSession() {
-                            if (!session)
-                                throw new Error("The local desktop has not been prepared.");
-                            return { executor: session.executor, ...(inbox && address ? { inbox: { url: inbox.url, address } } : {}) };
-                        },
-                        finalize() {
-                            return finalizing ??= (async () => {
-                                try {
-                                    await inbox?.close();
-                                }
-                                catch {
-                                    cleanupUnconfirmed = true;
-                                    warnings.push("Local inbox cleanup is unconfirmed.");
-                                }
-                                if (!session)
-                                    return;
-                                if (recording) {
-                                    const desktop = session;
-                                    try {
-                                        evidence.recording = await collectDesktopRecording(artifactRoot, spec.laneId, destination => desktop.finishRecording(destination));
-                                    }
-                                    catch {
-                                        warnings.push("Desktop video/audio recording could not be retained. Screenshots and participant evidence remain available.");
-                                    }
-                                }
-                                try {
-                                    evidence.killed = (await session.close()).status === "released";
-                                }
-                                catch {
-                                    evidence.killed = false;
-                                }
-                                if (!evidence.killed) {
-                                    cleanupUnconfirmed = true;
-                                    warnings.push("Local desktop cleanup is unconfirmed.");
-                                }
-                            })();
-                        },
-                        snapshot: () => evidence
-                    };
-                },
-                ...(account ? { async buildProvider({ executor }) {
-                        const participant = createRestrictedCodexParticipant({ speechEnabled: executor?.speechEnabled === true });
-                        participants.push(participant);
-                        return Object.assign(participant.provider, { async close() {
-                                if ((await participant.close()).status !== "confirmed") {
-                                    cleanupUnconfirmed = true;
-                                    throw new Error("Local participant cleanup is unconfirmed.");
-                                }
-                            } });
-                    } } : {}),
-                ...(options.signal ? { runSession: (input) => runCuaActorSession({ ...input, signal: options.signal }) } : {})
-            }
-        });
-    }
-    finally {
-        await Promise.allSettled(participants.map(participant => participant.close()));
-        await Promise.allSettled(sessions.map(session => session.close()));
-    }
-}
-//# sourceMappingURL=local-firecracker-study.js.map

package/dist/local-firecracker-study.js.map

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

package/dist/local-runtime-config.d.ts

@@ -1,6 +0,0 @@
-import type { LabConfig } from "./lab-config.js";
-export declare const LOCAL_BROWSER_LIFETIME_MS: number;
-export declare function isLocalBrowserLab(config: LabConfig): boolean;
-/** Defaults for the explicitly selected local substrate; hosted configurations are untouched. */
-export declare function localBrowserDefaults(config: LabConfig): LabConfig;
-export declare function localBrowserUnsupportedReason(config: LabConfig): string | undefined;

package/dist/local-runtime-config.js

@@ -1,60 +0,0 @@
-// The runtime image enforces a 30-minute lifetime; reserve setup/teardown room.
-export const LOCAL_BROWSER_LIFETIME_MS = 30 * 60_000;
-const MAX_SESSION_MS = 20 * 60_000;
-export function isLocalBrowserLab(config) {
-    return config.subject.source === "app-url" && config.execution?.target === "local" &&
-        ["local-agent", "openai-computer-use"].includes(config.actors[0]?.type ?? "");
-}
-/** Defaults for the explicitly selected local substrate; hosted configurations are untouched. */
-export function localBrowserDefaults(config) {
-    if (!isLocalBrowserLab(config))
-        return config;
-    return { ...config,
-        actors: config.actors.map(actor => ({ ...actor, model: actor.model ?? "gpt-6-astra", reasoningEffort: actor.reasoningEffort ?? "low" })),
-        execution: { ...config.execution, timeoutMs: config.execution?.timeoutMs ?? MAX_SESSION_MS, desktop: { ...config.execution?.desktop,
-                resolution: config.execution?.desktop?.resolution ?? [960, 720] } },
-        ...(config.review?.analysis === undefined && config.actors[0]?.type === "local-agent"
-            ? { review: { ...config.review, analysis: { provider: "codex" } } } : {}) };
-}
-export function localBrowserUnsupportedReason(config) {
-    const actor = config.actors[0];
-    const desktop = config.execution?.desktop;
-    if ((config.execution?.timeoutMs ?? MAX_SESSION_MS) > MAX_SESSION_MS) {
-        return "Local browser sessions currently support at most 20 minutes, within the runtime's 30-minute lifetime.";
-    }
-    if (config.actors.length !== 1 || !actor ||
-        (actor.type === "local-agent" && (actor.localAgent !== undefined && actor.localAgent !== "codex"))) {
-        return "Local browser studies currently support Codex local-agent or openai-computer-use participants.";
-    }
-    if (desktop?.resolution?.[0] !== 960 || desktop.resolution[1] !== 720 || desktop.device !== undefined ||
-        (desktop.browser !== undefined && !["default", "chromium"].includes(desktop.browser)) ||
-        actor.lanes?.some(lane => lane.device !== undefined) || desktop.template !== undefined || desktop.sandboxTimeoutMs !== undefined) {
-        return "The local browser runtime currently uses a 960×720 Chromium desktop. Omit hosted templates, device presets and sandboxTimeoutMs.";
-    }
-    if (config.comms !== undefined && (config.comms.email?.kind !== "fake" || !config.comms.email.external)) {
-        return "Local browser inboxes require captured email with comms.email.external.catchBaseUrl. Run humanish comms catch and point your app's email sends at it. Real receiving requires a supported hosted route.";
-    }
-    if (desktop.media?.camera !== undefined && desktop.media.camera.source !== "synthetic") {
-        return "Local cameras currently use source: synthetic. Camera files remain supported on hosted desktops.";
-    }
-    if (actor.type === "local-agent" && (actor.model !== "gpt-6-astra" || actor.reasoningEffort !== "low" ||
-        actor.lanes?.some(lane => lane.reasoningEffort !== undefined && lane.reasoningEffort !== "low") ||
-        actor.maxOutputTokens !== undefined || config.execution?.caps?.maxUsd !== undefined || config.execution?.caps?.maxTotalUsd !== undefined ||
-        config.scenario?.caps?.maxUsd !== undefined || config.scenario?.caps?.maxTotalUsd !== undefined)) {
-        return "Local Codex participants currently use gpt-6-astra at low effort. Account dollar/output-token caps are unavailable; use API participants for those controls.";
-    }
-    for (const target of [config.subject.appUrl, ...(actor.lanes ?? []).map(lane => lane.target)].filter(Boolean)) {
-        let url;
-        try {
-            url = new URL(target);
-        }
-        catch {
-            return "Local browser targets must be loopback HTTP(S) URLs.";
-        }
-        if (!["http:", "https:"].includes(url.protocol) || !["localhost", "127.0.0.1"].includes(url.hostname) ||
-            url.username || url.password || Number(url.port) < 1024)
-            return "Local browser targets must use localhost or 127.0.0.1 on a port above 1023.";
-    }
-    return undefined;
-}
-//# sourceMappingURL=local-runtime-config.js.map

package/dist/local-runtime-config.js.map

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

package/dist/local-runtime-host.d.ts

@@ -1,31 +0,0 @@
-export declare const LIMA_INSTANCE = "humanish-runtime";
-export interface RuntimeHostOptions {
-    env?: NodeJS.ProcessEnv;
-    signal?: AbortSignal;
-    platform?: NodeJS.Platform;
-    arch?: string;
-}
-export declare const usesLima: (options?: RuntimeHostOptions) => boolean;
-export declare function runtimeArchitecture(options?: RuntimeHostOptions): "amd64" | "arm64" | undefined;
-export declare function hostExec(file: string, args: string[], options?: RuntimeHostOptions, timeout?: number): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-/** Commands inside the Linux host. Lima carries argv; no shell interpolation. */
-export declare function runtimeExec(file: string, args: string[], options?: RuntimeHostOptions, timeout?: number): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-export declare function runtimeDocker(args: string[], options?: RuntimeHostOptions, timeout?: number): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-export declare const LIMA_TEMPLATE = "minimumLimaVersion: 2.2.0\nvmType: vz\narch: aarch64\nnestedVirtualization: true\ncpus: 6\nmemory: 8GiB\ndisk: 80GiB\nimages:\n  - location: https://cloud.debian.org/images/cloud/trixie/20260712-2537/debian-13-genericcloud-arm64-20260712-2537.qcow2\n    arch: aarch64\n    digest: sha512:8543d795f2fde630eb66c492f245a8c1da19dedc636e0a8e7b3d0f95920e1a05aa911ef2d82d177d41cc53ced5fccbd2a3945d07fa5e15018914c4d864bb07ed\nmounts: []\ncontainerd:\n  system: false\n  user: false\nssh:\n  forwardAgent: false\nportForwards:\n  - guestIP: 0.0.0.0\n    guestIPMustBeZero: false\n    guestPortRange: [1, 65535]\n    proto: any\n    ignore: true\nprovision:\n  - mode: system\n    script: |\n      #!/bin/sh\n      set -eu\n      export DEBIAN_FRONTEND=noninteractive\n      apt-get update\n      apt-get install -y --no-install-recommends docker.io docker-cli ca-certificates\n      systemctl enable --now docker\n";
-export declare function limaStatus(options?: RuntimeHostOptions): Promise<{
-    ready: boolean;
-    exists: boolean;
-    message: string;
-}>;
-export declare function prepareLima(options?: RuntimeHostOptions, progress?: (message: string) => void): Promise<void>;
-/** Copy across the OS boundary explicitly; shared folders cannot carry sockets. */
-export declare function loadRuntimeArchive(archive: string, options: RuntimeHostOptions): Promise<void>;

package/dist/local-runtime-host.js

@@ -1,128 +0,0 @@
-import { execFile } from "node:child_process";
-import { mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { promisify } from "node:util";
-const exec = promisify(execFile);
-export const LIMA_INSTANCE = "humanish-runtime";
-export const usesLima = (options = {}) => (options.platform ?? process.platform) === "darwin";
-export function runtimeArchitecture(options = {}) {
-    const platform = options.platform ?? process.platform, arch = options.arch ?? process.arch;
-    if (platform === "linux" && arch === "x64")
-        return "amd64";
-    if ((platform === "linux" || platform === "darwin") && arch === "arm64")
-        return "arm64";
-    return undefined;
-}
-export async function hostExec(file, args, options = {}, timeout = 15_000) {
-    return exec(file, args, { env: options.env ?? process.env, timeout, maxBuffer: 1024 * 1024,
-        ...(options.signal ? { signal: options.signal } : {}) });
-}
-/** Commands inside the Linux host. Lima carries argv; no shell interpolation. */
-export async function runtimeExec(file, args, options = {}, timeout = 15_000) {
-    return usesLima(options)
-        ? hostExec("limactl", ["shell", "--workdir", "/", LIMA_INSTANCE, "--", file, ...args], options, timeout)
-        : hostExec(file, args, options, timeout);
-}
-export async function runtimeDocker(args, options = {}, timeout = 15_000) {
-    return usesLima(options)
-        ? runtimeExec("sudo", ["-n", "docker", "--host", "unix:///var/run/docker.sock", ...args], options, timeout)
-        : runtimeExec("docker", args, options, timeout);
-}
-// No host mounts, agent forwarding or automatic app-port discovery. Per-study
-// OpenSSH forwards grant just the selected app and browser-control sockets.
-export const LIMA_TEMPLATE = `minimumLimaVersion: 2.2.0
-vmType: vz
-arch: aarch64
-nestedVirtualization: true
-cpus: 6
-memory: 8GiB
-disk: 80GiB
-images:
-  - location: https://cloud.debian.org/images/cloud/trixie/20260712-2537/debian-13-genericcloud-arm64-20260712-2537.qcow2
-    arch: aarch64
-    digest: sha512:8543d795f2fde630eb66c492f245a8c1da19dedc636e0a8e7b3d0f95920e1a05aa911ef2d82d177d41cc53ced5fccbd2a3945d07fa5e15018914c4d864bb07ed
-mounts: []
-containerd:
-  system: false
-  user: false
-ssh:
-  forwardAgent: false
-portForwards:
-  - guestIP: 0.0.0.0
-    guestIPMustBeZero: false
-    guestPortRange: [1, 65535]
-    proto: any
-    ignore: true
-provision:
-  - mode: system
-    script: |
-      #!/bin/sh
-      set -eu
-      export DEBIAN_FRONTEND=noninteractive
-      apt-get update
-      apt-get install -y --no-install-recommends docker.io docker-cli ca-certificates
-      systemctl enable --now docker
-`;
-export async function limaStatus(options = {}) {
-    const chip = (await hostExec("sysctl", ["-n", "machdep.cpu.brand_string"], options)).stdout.trim();
-    const generation = /^Apple M(\d+)/.exec(chip);
-    if (!generation || Number(generation[1]) < 3)
-        throw new Error("Local Firecracker on Mac requires an M3 or newer Apple Silicon Mac with nested virtualization.");
-    let version;
-    try {
-        version = (await hostExec("limactl", ["--version"], options)).stdout;
-    }
-    catch {
-        throw new Error("Install Lima 2.2 or newer (brew install lima), then run humanish runtime setup. Docker Desktop is not required.");
-    }
-    const match = /\b(\d+)\.(\d+)\.\d+/.exec(version);
-    if (!match || Number(match[1]) < 2 || (Number(match[1]) === 2 && Number(match[2]) < 2))
-        throw new Error("Update Lima to 2.2 or newer (brew upgrade lima), then run humanish runtime setup.");
-    const output = (await hostExec("limactl", ["list", "--json"], options)).stdout.trim();
-    const instance = output.split("\n").filter(Boolean).map(line => JSON.parse(line))
-        .find(value => value.name === LIMA_INSTANCE);
-    if (instance && (instance.name !== LIMA_INSTANCE || instance.vmType !== "vz" || instance.arch !== "aarch64"))
-        throw new Error(`The existing ${LIMA_INSTANCE} Lima instance is incompatible. Humanish will not replace it.`);
-    return { ready: instance?.status === "Running", exists: !!instance,
-        message: instance ? "The Humanish Lima host is stopped. Run humanish runtime setup to start it."
-            : "Run humanish runtime setup to create the Humanish Lima host and install the browser runtime." };
-}
-export async function prepareLima(options = {}, progress) {
-    const status = await limaStatus(options);
-    if (status.ready)
-        return;
-    progress?.(status.exists ? "Starting the Humanish Lima host…" : "Preparing the Humanish Lima host (first setup downloads Linux and Docker)…");
-    if (status.exists) {
-        await hostExec("limactl", ["start", "--tty=false", LIMA_INSTANCE], options, 15 * 60_000);
-    }
-    else {
-        const work = await mkdtemp(path.join(tmpdir(), "humanish-lima-"));
-        try {
-            const file = path.join(work, "host.yaml");
-            await writeFile(file, LIMA_TEMPLATE, { mode: 0o600 });
-            await hostExec("limactl", ["start", "--tty=false", "--name", LIMA_INSTANCE, file], options, 15 * 60_000);
-        }
-        finally {
-            await rm(work, { recursive: true, force: true });
-        }
-    }
-}
-/** Copy across the OS boundary explicitly; shared folders cannot carry sockets. */
-export async function loadRuntimeArchive(archive, options) {
-    if (!usesLima(options)) {
-        await runtimeDocker(["load", "--input", archive], options, 10 * 60_000);
-        return;
-    }
-    const work = (await runtimeExec("mktemp", ["-d", "/tmp/humanish-image-XXXXXX"], options)).stdout.trim();
-    try {
-        await hostExec("limactl", ["copy", archive, `${LIMA_INSTANCE}:${work}/runtime.tar.gz`], options, 10 * 60_000);
-        await runtimeDocker(["load", "--input", `${work}/runtime.tar.gz`], options, 10 * 60_000);
-    }
-    finally {
-        // Cancellation must not skip removal of this invocation's copied archive.
-        const { signal: _signal, ...cleanup } = options;
-        await runtimeExec("rm", ["-rf", "--", work], cleanup);
-    }
-}
-//# sourceMappingURL=local-runtime-host.js.map

package/dist/local-runtime-host.js.map

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

package/dist/local-runtime-release.d.ts

@@ -1,7 +0,0 @@
-import type { LocalRuntimeRelease } from "./local-runtime.js";
-/** Updated with the verified, public runtime artifact before release. */
-export declare const LOCAL_RUNTIME_RELEASE: LocalRuntimeRelease;
-/** Architecture-specific artifacts; each retains matching sources and notices. */
-export declare const LOCAL_RUNTIME_RELEASES: Partial<Record<"amd64" | "arm64", LocalRuntimeRelease>>;
-/** Media assets are separate so ordinary browser studies keep the smaller download. */
-export declare const LOCAL_MEDIA_RUNTIME_RELEASES: Partial<Record<"amd64" | "arm64", LocalRuntimeRelease>>;