humanish 0.104.3 → 0.106.0

package/dist/local-runtime-release.js

@@ -1,33 +0,0 @@
-/** Updated with the verified, public runtime artifact before release. */
-export const LOCAL_RUNTIME_RELEASE = {
-    url: "https://github.com/danielgwilson/humanish/releases/download/runtime-2026.09.28.1/runtime-linux-amd64.tar.gz",
-    sha256: "224be52467d6a808c79f156c6537d8a34c2dfb7b71daa836d34c8611fbbb6647",
-    bytes: 596142100,
-    image: "sha256:89cec77ea8097d32f3ef14bf2bdb0a93ffd25c3975913f8c5ffc6a2f360482a2"
-};
-/** Architecture-specific artifacts; each retains matching sources and notices. */
-export const LOCAL_RUNTIME_RELEASES = {
-    amd64: LOCAL_RUNTIME_RELEASE,
-    arm64: {
-        url: "https://github.com/danielgwilson/humanish/releases/download/runtime-2026.09.28.2/runtime-linux-arm64.tar.gz",
-        sha256: "d03e1b6335bea76a22bf88ca9aa8dc1f4fe0af16fba02c654a333766e27cd2ea",
-        bytes: 582661785,
-        image: "sha256:c3d584d9586d2e86833ee8d050c43774d456c6c4f8f3c9a53194bd90910fa938"
-    }
-};
-/** Media assets are separate so ordinary browser studies keep the smaller download. */
-export const LOCAL_MEDIA_RUNTIME_RELEASES = {
-    amd64: {
-        url: "https://github.com/danielgwilson/humanish/releases/download/runtime-2026.09.28.7/runtime-linux-amd64.tar.gz",
-        sha256: "f4758b39cb26c819c7f952eb329d5096fcfe9f05f7381bd37d205b2f6e51826c",
-        bytes: 846986597,
-        image: "sha256:91b132c72cdcb750fba3b48ee78ea8087c794d515d970a273b6f5ee22d443b9f"
-    },
-    arm64: {
-        url: "https://github.com/danielgwilson/humanish/releases/download/runtime-2026.09.28.8/runtime-linux-arm64.tar.gz",
-        sha256: "77f65fd945b582067cfde7740c26f4c06c2727afffcb0025720652c168377a01",
-        bytes: 828200616,
-        image: "sha256:68dd2c00f713bd8be03e209011531bbd4da5b840819cd2de203c11ece29aa255"
-    }
-};
-//# sourceMappingURL=local-runtime-release.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"local-runtime-release.js","sourceRoot":"","sources":["../src/local-runtime-release.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,GAAG,EAAE,6GAA6G;IAClH,MAAM,EAAE,kEAAkE;IAC1E,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,yEAAyE;CACjF,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAA4D;IAC7F,KAAK,EAAE,qBAAqB;IAC5B,KAAK,EAAE;QACL,GAAG,EAAE,6GAA6G;QAClH,MAAM,EAAE,kEAAkE;QAC1E,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,yEAAyE;KACjF;CACF,CAAC;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,4BAA4B,GAA4D;IACnG,KAAK,EAAE;QACL,GAAG,EAAE,6GAA6G;QAClH,MAAM,EAAE,kEAAkE;QAC1E,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,yEAAyE;KACjF;IACD,KAAK,EAAE;QACL,GAAG,EAAE,6GAA6G;QAClH,MAAM,EAAE,kEAAkE;QAC1E,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,yEAAyE;KACjF;CACF,CAAC"}

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

@@ -1,27 +0,0 @@
-/** Standard OpenSSH streamlocal forwarding; no browser-control protocol here. */
-export declare function openRuntimeSshTunnel(options: {
-    config: string;
-    destination: string;
-    localSocket: string;
-    remoteSocket: string;
-    appSocket: string;
-    appHost: string;
-    appPort: number;
-    signal: AbortSignal;
-    inbox?: {
-        socket: string;
-        host: string;
-        port: number;
-    };
-}): Promise<{
-    close(): Promise<boolean>;
-}>;
-export declare function openLimaTunnel(options: {
-    work: string;
-    socketRoot: string;
-    appUrl: URL;
-    inboxUrl?: URL;
-    signal: AbortSignal;
-}): Promise<{
-    close(): Promise<boolean>;
-}>;

package/dist/local-runtime-ssh.js

@@ -1,91 +0,0 @@
-import { spawn } from "node:child_process";
-import path from "node:path";
-import { setTimeout as delay } from "node:timers/promises";
-import { hostExec, LIMA_INSTANCE } from "./local-runtime-host.js";
-/** Standard OpenSSH streamlocal forwarding; no browser-control protocol here. */
-export async function openRuntimeSshTunnel(options) {
-    options.signal.throwIfAborted();
-    const child = spawn("ssh", ["-F", options.config, "-T", "-a", "-o", "BatchMode=yes",
-        "-o", "ControlMaster=no", "-o", "ControlPath=none", "-o", "ExitOnForwardFailure=yes",
-        "-o", "ConnectTimeout=15", "-o", "StreamLocalBindMask=0177",
-        "-L", `${options.localSocket}:${options.remoteSocket}`,
-        "-R", `${options.appSocket}:${options.appHost}:${options.appPort}`,
-        ...(options.inbox ? ["-R", `${options.inbox.socket}:${options.inbox.host}:${options.inbox.port}`] : []),
-        options.destination, "sh -c 'printf \"HUMANISH_SSH_READY\\n\"; exec cat'"], { stdio: ["pipe", "pipe", "pipe"] });
-    let exited = false;
-    const closed = new Promise(resolve => child.once("close", () => { exited = true; resolve(); }));
-    child.stdin.on("error", () => { });
-    let closing;
-    const close = () => closing ??= (async () => {
-        options.signal.removeEventListener("abort", aborted);
-        // EOF also closes the remote cat if the parent dies unexpectedly. Do not
-        // detach/multiplex this SSH child into Lima's persistent control connection.
-        child.stdin.end();
-        await Promise.race([closed, delay(1000)]);
-        if (!exited)
-            child.kill("SIGTERM");
-        await Promise.race([closed, delay(1000)]);
-        if (!exited)
-            child.kill("SIGKILL");
-        await Promise.race([closed, delay(1000)]);
-        return exited;
-    })();
-    const aborted = () => { void close(); };
-    options.signal.addEventListener("abort", aborted, { once: true });
-    try {
-        await new Promise((resolve, reject) => {
-            const timer = setTimeout(() => finish(new Error("Lima SSH forwarding timed out.")), 20_000);
-            let bytes = 0, output = "", ready = false;
-            const finish = (error) => {
-                if (ready)
-                    return;
-                ready = true;
-                clearTimeout(timer);
-                if (error)
-                    reject(error);
-                else
-                    resolve();
-            };
-            child.once("error", () => finish(new Error("Could not start SSH for the Lima browser.")));
-            child.once("close", () => finish(new Error("Lima SSH forwarding closed before it was ready.")));
-            child.stderr.on("data", (data) => {
-                bytes += data.length;
-                if (bytes > 64 * 1024) {
-                    finish(new Error("Lima SSH forwarding failed."));
-                    void close();
-                }
-            });
-            child.stdout.on("data", (data) => {
-                bytes += data.length;
-                if (bytes > 64 * 1024) {
-                    finish(new Error("Lima SSH forwarding failed."));
-                    void close();
-                    return;
-                }
-                if (!ready) {
-                    output += data.toString();
-                    if (output === "HUMANISH_SSH_READY\n")
-                        finish();
-                }
-            });
-        });
-        options.signal.throwIfAborted();
-        return { close };
-    }
-    catch (error) {
-        await close();
-        throw error;
-    }
-}
-export async function openLimaTunnel(options) {
-    const settings = await hostExec("limactl", ["list", "--format={{.SSHConfigFile}}", LIMA_INSTANCE], { signal: options.signal });
-    const config = settings.stdout.trim();
-    if (!path.isAbsolute(config))
-        throw new Error("Lima did not return its SSH configuration path.");
-    return openRuntimeSshTunnel({ config, destination: `lima-${LIMA_INSTANCE}`,
-        localSocket: path.join(options.work, "vsock.sock"), remoteSocket: `${options.socketRoot}/vsock.sock`,
-        appSocket: `${options.socketRoot}/vsock.sock_8000`, appHost: options.appUrl.hostname,
-        ...(options.inboxUrl ? { inbox: { socket: `${options.socketRoot}/vsock.sock_8001`, host: options.inboxUrl.hostname, port: Number(options.inboxUrl.port) } } : {}),
-        appPort: Number(options.appUrl.port), signal: options.signal });
-}
-//# sourceMappingURL=local-runtime-ssh.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"local-runtime-ssh.js","sourceRoot":"","sources":["../src/local-runtime-ssh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAElE,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAI1C;IACC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe;QACjF,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,0BAA0B;QACpF,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,0BAA0B;QAC3D,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE;QACtD,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE;QAClE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvG,OAAO,CAAC,WAAW,EAAE,oDAAoD,CAAC,EAC5E,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClC,IAAI,OAAqC,CAAC;IAC1C,MAAM,KAAK,GAAG,GAAqB,EAAE,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE;QAC5D,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,yEAAyE;QACzE,6EAA6E;QAC7E,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,CAAC;IACL,MAAM,OAAO,GAAG,GAAS,EAAE,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5F,IAAI,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC;YAC1C,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;gBACrC,IAAI,KAAK;oBAAE,OAAO;gBAClB,KAAK,GAAG,IAAI,CAAC;gBAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;oBAAM,OAAO,EAAE,CAAC;YAC3C,CAAC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC,CAAC;YAC1F,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC,CAAC,CAAC;YAChG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;gBACrB,IAAI,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;oBAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;oBAAC,KAAK,KAAK,EAAE,CAAC;gBAAC,CAAC;YAC5F,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;gBACrB,IAAI,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;oBAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;oBAAC,KAAK,KAAK,EAAE,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAClG,IAAI,CAAC,KAAK,EAAE,CAAC;oBAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAAC,IAAI,MAAM,KAAK,sBAAsB;wBAAE,MAAM,EAAE,CAAC;gBAAC,CAAC;YAC7F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,EAAE,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAEpC;IACC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,6BAA6B,EAAE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/H,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACjG,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,aAAa,EAAE;QACxE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,aAAa;QACpG,SAAS,EAAE,GAAG,OAAO,CAAC,UAAU,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ;QACpF,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjK,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/local-runtime.d.ts

@@ -1,25 +0,0 @@
-import type { LocalFirecrackerAssets } from "./local-firecracker-desktop.js";
-import { type RuntimeHostOptions } from "./local-runtime-host.js";
-export interface LocalRuntimeRelease {
-    url: string;
-    sha256: string;
-    bytes: number;
-    image: string;
-}
-export interface LocalRuntimeStatus {
-    ok: boolean;
-    installed: boolean;
-    message: string;
-    assets?: LocalFirecrackerAssets;
-}
-interface RuntimeOptions extends RuntimeHostOptions {
-    media?: boolean;
-    progress?: (message: string) => void;
-    /** Explicit source-build/test override; never provided by a participant. */
-    release?: LocalRuntimeRelease;
-}
-/** Read-only host and cache inspection. Never pulls an image or starts a container. */
-export declare function localRuntimeStatus(options?: RuntimeOptions): Promise<LocalRuntimeStatus>;
-/** Docker owns the installed image/cache. The archive is verified before docker load. */
-export declare function prepareLocalRuntime(options?: RuntimeOptions): Promise<LocalFirecrackerAssets>;
-export {};

package/dist/local-runtime.js

@@ -1,133 +0,0 @@
-import { createHash } from "node:crypto";
-import { createWriteStream } from "node:fs";
-import { access, mkdtemp, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { Readable, Transform } from "node:stream";
-import { pipeline } from "node:stream/promises";
-import { LOCAL_MEDIA_RUNTIME_RELEASES, LOCAL_RUNTIME_RELEASES } from "./local-runtime-release.js";
-import { limaStatus, loadRuntimeArchive, prepareLima, runtimeArchitecture, runtimeDocker, runtimeExec, usesLima } from "./local-runtime-host.js";
-const docker = async (args, options) => (await runtimeDocker(args, options)).stdout.trim();
-const runtimeRelease = (options) => options.release ?? (options.media ? LOCAL_MEDIA_RUNTIME_RELEASES : LOCAL_RUNTIME_RELEASES)[runtimeArchitecture(options) ?? "amd64"];
-/** Read-only host and cache inspection. Never pulls an image or starts a container. */
-export async function localRuntimeStatus(options = {}) {
-    const architecture = runtimeArchitecture(options), lima = usesLima(options);
-    if (!architecture)
-        return { ok: false, installed: false, message: "Local browsers need Linux x64/ARM64 or an M3-or-newer Mac with Lima." };
-    if (lima) {
-        try {
-            const status = await limaStatus(options);
-            if (!status.ready)
-                return { ok: true, installed: false, message: status.message };
-        }
-        catch (error) {
-            return { ok: false, installed: false, message: error.message };
-        }
-    }
-    const env = options.env ?? process.env;
-    if (!lima && env.DOCKER_HOST && !env.DOCKER_HOST.startsWith("unix://")) {
-        return { ok: false, installed: false, message: "Local browsers need Docker on this machine; a remote DOCKER_HOST cannot reach the local app and control socket." };
-    }
-    try {
-        if (lima)
-            await runtimeExec("sh", ["-c", "test -c /dev/kvm && test -c /dev/net/tun"], options);
-        else {
-            await access("/dev/kvm");
-            await access("/dev/net/tun");
-        }
-    }
-    catch {
-        return { ok: false, installed: false, message: "Local browsers need Linux KVM (/dev/kvm) and TUN (/dev/net/tun). Enable virtualization on this host." };
-    }
-    try {
-        if (!lima && (env.DOCKER_CONTEXT || !env.DOCKER_HOST)) {
-            const endpoint = JSON.parse(await docker(["context", "inspect", "--format", "{{json .Endpoints.docker.Host}}"], options));
-            if (typeof endpoint !== "string" || !endpoint.startsWith("unix://")) {
-                return { ok: false, installed: false, message: "Select a local Docker context. Remote Docker cannot reach the local app and control socket." };
-            }
-        }
-        const info = JSON.parse(await docker(["info", "--format", "{{json .}}"], options));
-        if (info.OSType !== "linux" || !(architecture === "amd64" ? ["x86_64", "amd64"] : ["aarch64", "arm64"]).includes(info.Architecture) ||
-            info.SecurityOptions?.some((value) => value.includes("rootless"))) {
-            return { ok: false, installed: false, message: "Local browsers need a local, rootful Linux Docker engine of the matching architecture with KVM access." };
-        }
-    }
-    catch {
-        return { ok: false, installed: false, message: lima
-                ? "Docker is unavailable inside the Humanish Lima host. Check limactl shell humanish-runtime -- sudo systemctl status docker; Docker Desktop is not used."
-                : "Docker is unavailable. Install/start Docker Engine and give your account access, then run humanish runtime setup." };
-    }
-    const release = runtimeRelease(options);
-    const imageVariable = options.media ? "HUMANISH_LOCAL_MEDIA_RUNTIME_IMAGE" : "HUMANISH_LOCAL_RUNTIME_IMAGE";
-    const reference = env[imageVariable]?.trim() || release?.image;
-    if (!reference)
-        return { ok: false, installed: false, message: `This build does not include a published local ${options.media ? "media " : ""}runtime. Source builds can set ${imageVariable}.` };
-    let images;
-    try {
-        images = JSON.parse(await docker(["image", "inspect", reference], options));
-    }
-    catch {
-        return env[imageVariable]?.trim()
-            ? { ok: false, installed: false, message: `${imageVariable} must name an already-built local image. Build or load it before running.` }
-            : { ok: true, installed: false, message: "Local runtime will download before the first live run. Run humanish runtime setup to prepare it now." };
-    }
-    const image = images[0];
-    const labels = image?.Config?.Labels ?? {};
-    const revision = labels["to.humanish.runtime.revision"];
-    if (image?.Os !== "linux" || image.Architecture !== architecture || labels["to.humanish.runtime.api"] !== "1" ||
-        typeof revision !== "string" || !/^guest-api1-[a-f0-9]{64}$/.test(revision) ||
-        (options.media === true && labels["to.humanish.runtime.media"] !== "1")) {
-        return { ok: false, installed: false, message: "The cached image is not a compatible Humanish local browser runtime." };
-    }
-    return { ok: true, installed: true, message: `Local ${options.media ? "media" : "browser"} runtime is installed. No E2B key is needed.`,
-        assets: { image: image.Id, runtimeRevision: revision, ...(labels["to.humanish.runtime.media"] === "1" ? { media: true } : {}) } };
-}
-/** Docker owns the installed image/cache. The archive is verified before docker load. */
-export async function prepareLocalRuntime(options = {}) {
-    if (!runtimeArchitecture(options))
-        throw new Error((await localRuntimeStatus(options)).message);
-    if (usesLima(options))
-        await prepareLima(options, options.progress);
-    const before = await localRuntimeStatus(options);
-    if (!before.ok)
-        throw new Error(before.message);
-    if (before.assets)
-        return before.assets;
-    const release = runtimeRelease(options);
-    if (!release)
-        throw new Error(before.message);
-    options.progress?.(`Downloading local browser runtime (${Math.ceil(release.bytes / 1024 / 1024)} MiB)…`);
-    const work = await mkdtemp(path.join(tmpdir(), "humanish-runtime-download-"));
-    const archive = path.join(work, "runtime.tar.gz");
-    const signal = AbortSignal.any([AbortSignal.timeout(30 * 60_000), ...(options.signal ? [options.signal] : [])]);
-    try {
-        const response = await fetch(release.url, { signal });
-        if (!response.ok || !response.body)
-            throw new Error(`Runtime download failed (HTTP ${response.status}). Run humanish runtime setup to retry.`);
-        let bytes = 0;
-        const hash = createHash("sha256");
-        await pipeline(Readable.fromWeb(response.body), new Transform({
-            transform(chunk, _encoding, done) {
-                bytes += chunk.length;
-                if (bytes > release.bytes) {
-                    done(new Error("Runtime archive exceeds its published size."));
-                    return;
-                }
-                hash.update(chunk);
-                done(null, chunk);
-            }
-        }), createWriteStream(archive, { flags: "wx", mode: 0o600 }), { signal });
-        if (bytes !== release.bytes || hash.digest("hex") !== release.sha256)
-            throw new Error("Runtime archive integrity check failed; it was not installed.");
-        options.progress?.("Installing the local browser image…");
-        await loadRuntimeArchive(archive, { ...options, signal });
-        const after = await localRuntimeStatus(options);
-        if (!after.assets)
-            throw new Error("Downloaded runtime did not provide the expected image. Run humanish runtime setup to retry.");
-        return after.assets;
-    }
-    finally {
-        await rm(work, { recursive: true, force: true });
-    }
-}
-//# sourceMappingURL=local-runtime.js.map

package/dist/local-runtime.js.map

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

package/dist/observer-data.d.ts

@@ -1,114 +0,0 @@
-import { type ActorEnding } from "./actor-stop-cause.js";
-import type { RunBundle, RunCostSummary, RunEvent, RunSimulation, RunStream, RunStreamKind } from "./run.js";
-export declare const OBSERVER_DATA_SCHEMA = "humanish.observer-data.v1";
-export interface ObserverArtifactLink {
-    label: string;
-    href: string;
-    kind: string;
-}
-export interface ObserverData {
-    schema: typeof OBSERVER_DATA_SCHEMA;
-    schemaVersion: 1;
-    generatedAt: string;
-    /** Served-only liveness observation. Never a replacement for the recorded evidence verdict. */
-    runtime?: {
-        state: "running" | "finished" | "interrupted" | "unknown";
-        observedAt: string;
-        source: "local-run-status";
-    };
-    run: {
-        runId: string;
-        mode: RunBundle["mode"];
-        status: RunBundle["review"]["verdict"];
-        title: string;
-        createdAt: string;
-        simCount: number;
-        persona: RunBundle["persona"];
-        scenario: RunBundle["scenario"];
-        packageName: string | null;
-        redaction: RunBundle["redaction"];
-        lifecycle: RunBundle["lifecycle"];
-        knownGaps: string[];
-        /**
-         * What happened to the PARTICIPANTS, with the denominator attached. `status` above collapses the
-         * run to one word for a gate; this is the study result, and it is what the person watching
-         * through the glass actually wants to know. Absent on a bundle with no participants.
-         *
-         * A viewing room that shows only vivid moments manufactures certainty from n=1 — so the count
-         * travels with the outcome here, always (docs/principles/three-roles.md).
-         */
-        participants?: RunBundle["review"]["participants"];
-        /** The same thing as one readable line, so a renderer cannot accidentally show a number
-         *  without its denominator. */
-        participantsLine?: string;
-        /** The study's per-task completion rates (#414), when the lab declared a protocol. */
-        tasks?: RunBundle["review"]["tasks"];
-        /** Pre-formatted like participantsLine, denominator on every number. */
-        tasksLine?: string;
-    };
-    summary: {
-        streams: number;
-        byKind: Record<RunStreamKind, number>;
-        active: number;
-        blocked: number;
-        warnings: number;
-    };
-    laneGroups: ObserverLaneGroup[];
-    /**
-     * OPTIONAL run-level cost ESTIMATE projected straight through from the bundle
-     * (humanish.run-cost-summary.v1). Absent when the bundle carries none. The Observer LABELS every
-     * figure as estimated (rates as of <asOf>) and never presents it as an authoritative charge.
-     */
-    cost?: RunCostSummary;
-    streams: ObserverStream[];
-    events: RunEvent[];
-    artifactLinks: ObserverArtifactLink[];
-    publicSafety: {
-        publishable: false;
-        note: string;
-        /**
-         * ADDITIVE + OPTIONAL (#584): the result of verification at static render or
-         * export time. Unverified projections omit this field. The timestamp records
-         * that check; it is not an assertion about subsequent file changes.
-         */
-        share?: {
-            status: "share_ready" | "local_only" | "blocked";
-            verifiedAt: string;
-            reasons: string[];
-        };
-    };
-    raw: {
-        bundleSchema: string;
-        artifactRoot: string;
-    };
-}
-export interface ObserverStream extends RunStream {
-    /** Only the attached server may grant provider-origin access for a live desktop iframe. */
-    embed?: NonNullable<RunStream["embed"]> & {
-        runtimeDesktop?: true;
-    };
-    /** Participant-facing status. The actor and simulation retain their original protocol status. */
-    status: RunStream["status"];
-    /** Precise recorded interruption; absent when the source carries no cause. */
-    ending?: ActorEnding;
-    sim: RunSimulation;
-    kindLabel: string;
-    statusLabel: string;
-    terminalPlain: string;
-    timeline: RunEvent[];
-}
-/** Discard a forged or stale runtime grant before projecting persisted evidence. */
-export declare function recordedStreamEmbed(embed: NonNullable<RunStream["embed"]>): NonNullable<RunStream["embed"]>;
-export interface ObserverLaneGroup {
-    roleId: string;
-    simId: string;
-    streamId: string;
-    status: string;
-    actorType?: string;
-    surface?: string;
-    caseGroup?: string;
-}
-export declare function buildObserverData(bundle: RunBundle, generatedAt?: string): ObserverData;
-/** Refresh presentation from recorded actor evidence, including older exported snapshots. */
-export declare function withObserverEndings(data: ObserverData): ObserverData;
-export declare function stripAnsi(value: string): string;