@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/hypervisor/lock.js

@@ -0,0 +1,185 @@
+import { mkdir, rmdir, stat, unlink } from "node:fs/promises";
+import { createConnection, createServer } from "node:net";
+import { dirname, join } from "node:path";
+import { note } from "@inhuman.tools/harness-diagnostics";
+import { errnoCode, sleep, waitUntil } from "./util.js";
+/** Kernel bind retries after a confirmed-dead leftover socket file. */
+const ACQUIRE_ATTEMPTS = 3;
+const PROBE_MS = 200;
+/** Wait for another acquirer to leave the reclaim gate. */
+const GATE_WAIT_MS = 1_000;
+/**
+ * Crash leftover only. A live acquire is milliseconds; do not rmdir a recent
+ * gate — that would let a second process unlink+bind beside the first.
+ */
+const GATE_STALE_MS = 2_000;
+export class LockHeldError extends Error {
+    path;
+    constructor(path) {
+        super(`lifetime lock held: ${path}`);
+        this.path = path;
+        this.name = "LockHeldError";
+    }
+}
+export class LifetimeLock {
+    kind;
+    path;
+    server;
+    released = false;
+    constructor(kind, path, server) {
+        this.kind = kind;
+        this.path = path;
+        this.server = server;
+    }
+    static async acquire(path, kind) {
+        const held = await LifetimeLock.tryAcquire(path, kind);
+        if (held === null)
+            throw new LockHeldError(path);
+        return held;
+    }
+    static async tryAcquire(path, kind) {
+        await mkdir(dirname(path), { recursive: true });
+        // One process may unlink+bind a leftover. Concurrent reclaim would unlink
+        // a just-bound socket and create a second owner at the same path.
+        const entered = await enterReclaimGate(path);
+        if (!entered)
+            return null;
+        try {
+            for (let attempt = 0; attempt < ACQUIRE_ATTEMPTS; attempt++) {
+                const bound = await bindLockSocket(path);
+                if (bound.status === "held")
+                    return null;
+                if (bound.status === "owned") {
+                    return new LifetimeLock(kind, path, bound.server);
+                }
+                try {
+                    await unlink(path);
+                }
+                catch {
+                    /* already gone */
+                }
+                await sleep(10);
+            }
+            return null;
+        }
+        finally {
+            await leaveReclaimGate(path);
+        }
+    }
+    async release() {
+        if (this.released)
+            return;
+        this.released = true;
+        await new Promise((resolve, reject) => {
+            this.server.close((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+        try {
+            await unlink(this.path);
+        }
+        catch {
+            /* closed bind; leftover path is not ownership */
+        }
+        note(`hypervisor lock released kind=${this.kind} path=${this.path}`);
+    }
+}
+/** Darwin unix-socket paths cap at 104 bytes; keep names short under `/tmp`. */
+export function lockPathFor(root, kind) {
+    return join(root, `${kind}.sock`);
+}
+export async function isLifetimeLockHeld(path) {
+    return (await probeLockSocket(path)) !== "dead";
+}
+export async function waitForLockRelease(path, timeoutMs) {
+    await waitUntil(`lock release ${path}`, async () => !(await isLifetimeLockHeld(path)), timeoutMs);
+}
+async function bindLockSocket(path) {
+    const server = createServer((socket) => {
+        socket.end();
+    });
+    try {
+        await listenUnix(server, path);
+        return { status: "owned", server };
+    }
+    catch (error) {
+        server.close();
+        if (errnoCode(error) !== "EADDRINUSE")
+            throw error;
+        const probe = await probeLockSocket(path);
+        // Timeout/busy is occupancy, never a license to unlink.
+        return probe === "dead" ? { status: "stale" } : { status: "held" };
+    }
+}
+function reclaimGatePath(path) {
+    return `${path}.gate`;
+}
+async function enterReclaimGate(path) {
+    const gate = reclaimGatePath(path);
+    const deadline = Date.now() + GATE_WAIT_MS;
+    while (Date.now() < deadline) {
+        try {
+            await mkdir(gate);
+            return true;
+        }
+        catch (error) {
+            if (errnoCode(error) !== "EEXIST")
+                throw error;
+            if (await isReclaimGateStale(gate)) {
+                await rmdir(gate).catch(() => undefined);
+                continue;
+            }
+            await sleep(10);
+        }
+    }
+    return false;
+}
+async function isReclaimGateStale(gate) {
+    try {
+        const info = await stat(gate);
+        return Date.now() - info.mtimeMs >= GATE_STALE_MS;
+    }
+    catch {
+        return true;
+    }
+}
+async function leaveReclaimGate(path) {
+    await rmdir(reclaimGatePath(path)).catch(() => undefined);
+}
+function listenUnix(server, path) {
+    return new Promise((resolve, reject) => {
+        const onError = (error) => {
+            server.off("error", onError);
+            reject(error);
+        };
+        server.once("error", onError);
+        server.listen({ path }, () => {
+            server.off("error", onError);
+            resolve();
+        });
+    });
+}
+function probeLockSocket(path) {
+    return new Promise((resolve) => {
+        const socket = createConnection(path);
+        const settle = (result) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve(result);
+        };
+        const timer = setTimeout(() => settle("busy"), PROBE_MS);
+        socket.once("connect", () => {
+            clearTimeout(timer);
+            settle("live");
+        });
+        socket.once("error", (error) => {
+            clearTimeout(timer);
+            const code = errnoCode(error);
+            settle(code === "ECONNREFUSED" || code === "ENOENT" || code === "ENOTSOCK" || code === "ECONNRESET" ? "dead" : "busy");
+        });
+    });
+}
+//# sourceMappingURL=lock.js.map

package/dist/hypervisor/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/hypervisor/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAe,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAExD,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,2DAA2D;AAC3D,MAAM,YAAY,GAAG,KAAK,CAAC;AAC3B;;;GAGG;AACH,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B,MAAM,OAAO,aAAc,SAAQ,KAAK;IACjB;IAArB,YAAqB,IAAY;QAC/B,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QADlB,SAAI,GAAJ,IAAI,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IAIZ;IACA;IACQ;IALX,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACW,IAAc,EACd,IAAY,EACJ,MAAc;QAFtB,SAAI,GAAJ,IAAI,CAAU;QACd,SAAI,GAAJ,IAAI,CAAQ;QACJ,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAc;QAC/C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,IAAc;QAClD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,IAAI,CAAC;YACH,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC;gBAC5D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;oBAAE,OAAO,IAAI,CAAC;gBACzC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC7B,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpD,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,kBAAkB;gBACpB,CAAC;gBACD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1B,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;oBACpB,OAAO,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;QACD,IAAI,CAAC,iCAAiC,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAc;IACtD,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,OAAO,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAAiB;IACtE,MAAM,SAAS,CAAC,gBAAgB,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACpG,CAAC;AAMD,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,YAAY;YAAE,MAAM,KAAK,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,wDAAwD;QACxD,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,GAAG,IAAI,OAAO,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC/C,IAAI,MAAM,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACzC,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,MAAM,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,UAAU,CAAC,MAAc,EAAE,IAAY;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAQ,EAAE;YACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,MAAa,EAAQ,EAAE;YACrC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACpC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CACJ,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAC/G,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/hypervisor/supervised-child.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supervised-child.d.ts.map

package/dist/hypervisor/supervised-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervised-child.d.ts","sourceRoot":"","sources":["../../src/hypervisor/supervised-child.ts"],"names":[],"mappings":""}

package/dist/hypervisor/supervised-child.js

@@ -0,0 +1,10 @@
+import { fail } from "@inhuman.tools/harness-diagnostics";
+import { runSupervisedProcess } from "./child-runtime.js";
+try {
+    process.exit(await runSupervisedProcess());
+}
+catch (error) {
+    fail("supervised-child", error);
+    process.exit(1);
+}
+//# sourceMappingURL=supervised-child.js.map

package/dist/hypervisor/supervised-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervised-child.js","sourceRoot":"","sources":["../../src/hypervisor/supervised-child.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,IAAI,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;AAC7C,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/hypervisor/util.d.ts

@@ -0,0 +1,5 @@
+export declare function errnoCode(error: unknown): string | undefined;
+export declare function sleep(ms: number): Promise<void>;
+export declare function waitUntil(label: string, pred: () => boolean | Promise<boolean>, timeoutMs: number): Promise<void>;
+export declare function pidAlive(pid: number): boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/hypervisor/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/hypervisor/util.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK5D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ7C"}

package/dist/hypervisor/util.js

@@ -0,0 +1,32 @@
+export function errnoCode(error) {
+    if (typeof error !== "object" || error === null || !("code" in error)) {
+        return undefined;
+    }
+    return typeof error.code === "string" ? error.code : undefined;
+}
+export function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export async function waitUntil(label, pred, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await pred())
+            return;
+        await sleep(20);
+    }
+    throw new Error(`timeout waiting for ${label}`);
+}
+export function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return errnoCode(error) === "EPERM";
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/hypervisor/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/hypervisor/util.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAa,EACb,IAAsC,EACtC,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,IAAI,EAAE;YAAE,OAAO;QACzB,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/interpreter/ComputedExecBox.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { type ExecOptions } from "@here.build/arrival";
+export type ComputedExecOptions = Omit<ExecOptions, "membraneClosure">;
+export declare class ComputedExecBox<T> {
+    #private;
+    constructor(source: string, opts: ComputedExecOptions);
+    get(): T | undefined;
+}
+//# sourceMappingURL=ComputedExecBox.d.ts.map

package/dist/interpreter/ComputedExecBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputedExecBox.d.ts","sourceRoot":"","sources":["../../src/interpreter/ComputedExecBox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAOvE,qBAAa,eAAe,CAAC,CAAC;;gBAUhB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB;IAUrD,GAAG,IAAI,CAAC,GAAG,SAAS;CAmErB"}

package/dist/interpreter/ComputedExecBox.js

@@ -0,0 +1,88 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { exec } from "@here.build/arrival";
+import { comparer, createAtom, Reaction, runInAction } from "mobx";
+export class ComputedExecBox {
+    #source;
+    #opts;
+    #atom;
+    #value;
+    #generation = 0;
+    #controller = null;
+    #rx = null;
+    #probe = null;
+    constructor(source, opts) {
+        this.#source = source;
+        this.#opts = opts;
+        this.#atom = createAtom("computedExec", () => this.#start(), () => this.#stop());
+    }
+    get() {
+        this.#atom.reportObserved();
+        return this.#value;
+    }
+    #start() {
+        this.#controller = new AbortController();
+        this.#rx = new Reaction("computedExec.deps", () => void this.#run(), undefined, false);
+        this.#probe = new Reaction("computedExec.probe", () => undefined, undefined, false);
+        void this.#run();
+    }
+    #stop() {
+        this.#generation += 1;
+        this.#controller?.abort();
+        this.#controller = null;
+        this.#rx?.dispose();
+        this.#rx = null;
+        this.#probe?.dispose();
+        this.#probe = null;
+    }
+    async #run() {
+        const rx = this.#rx;
+        const probe = this.#probe;
+        const controller = this.#controller;
+        if (rx === null || probe === null || controller === null)
+            return;
+        const generation = (this.#generation += 1);
+        const held = new Set();
+        try {
+            const values = await exec(this.#source, {
+                ...this.#opts,
+                signal: AbortSignal.any([this.#opts.signal, controller.signal].filter((v) => v !== undefined)),
+                membraneClosure: (work) => {
+                    let result;
+                    probe.track(() => {
+                        result = work();
+                    });
+                    for (const dep of probe.observing_)
+                        held.add(dep);
+                    return result;
+                },
+            });
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+            rx.track(() => {
+                // Every held atom. Returning after the first drops `rows.keys` / `row.name`.
+                for (const dep of held) {
+                    if (typeof dep.reportObserved === "function") {
+                        dep.reportObserved();
+                        continue;
+                    }
+                    dep.get?.();
+                }
+            });
+            const next = values.at(-1);
+            if (comparer.structural(next, this.#value))
+                return;
+            runInAction(() => {
+                this.#value = next;
+                this.#atom.reportChanged();
+            });
+        }
+        catch {
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+        }
+    }
+}
+//# sourceMappingURL=ComputedExecBox.js.map

package/dist/interpreter/ComputedExecBox.js.map

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

package/dist/interpreter/image.d.ts

@@ -0,0 +1,10 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@inhuman.tools/arrival";
+import { z } from "zod";
+import { KernelRoot } from "@inhuman.tools/harness-sdk";
+import { SessionRoot } from "@inhuman.tools/harness-sdk";
+export declare const imageCapability: EnvCapability<{
+    kernel: z.ZodCustom<KernelRoot, KernelRoot>;
+    session: z.ZodOptional<z.ZodCustom<SessionRoot, SessionRoot>>;
+}, Record<string, never>>;
+//# sourceMappingURL=image.d.ts.map

package/dist/interpreter/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/interpreter/image.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,eAAO,MAAM,eAAe;;;yBA2C1B,CAAC"}

package/dist/interpreter/image.js

@@ -0,0 +1,67 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@inhuman.tools/arrival";
+import { z } from "zod";
+import { KernelRoot } from "@inhuman.tools/harness-sdk";
+import { SessionRoot } from "@inhuman.tools/harness-sdk";
+export const imageCapability = EnvCapability.define("harness/image", {
+    configuration: {
+        kernel: z.instanceof(KernelRoot),
+        session: z.instanceof(SessionRoot).optional(),
+    },
+    symbols: (symbol, sz) => ({
+        "harness/kernel/connections": symbol.rosetta `harness/kernel/connections: live ConnectionSpec list`({ input: [], output: [sz.list(sz.box)], provenance: "source" }, function () {
+            return Object.values(this.configuration.kernel.connections);
+        }),
+        "harness/kernel/drivers": symbol.rosetta `harness/kernel/drivers: live DriverSpec list`({
+            input: [],
+            inputRest: { can: sz.foldName.optional() },
+            output: [sz.list(sz.box)],
+            provenance: "source",
+        }, function ({ can: want }) {
+            const all = Object.values(this.configuration.kernel.drivers);
+            return want === undefined ? all : all.filter((item) => item.can.includes(want));
+        }),
+        // pipe, not source: pure projection of the driver ARGUMENT — mints nothing.
+        "harness/kernel/offers": symbol.rosetta `harness/kernel/offers: class-bootstrap offers on a driver`({ input: [sz.box], output: [sz.list(sz.box)], provenance: "pipe" }, function (driver) {
+            return parseOffers(driver.offersJson);
+        }),
+        // Total read over a possibly-empty image: sessionless eval (kernel-scope
+        // commands) and a missing key both read as "" — connect.scm's
+        // `(equal? last "")` pins that contract. Not a door candidate.
+        "harness/session/get-current": symbol.rosetta `harness/session/get-current: immutable current kv; "" when unset or sessionless`({ input: [sz.foldName], output: [sz.string], provenance: "source" }, function (key) {
+            const session = this.configuration.session;
+            if (session === undefined)
+                return "";
+            return session.kvs[key] ?? "";
+        }),
+    }),
+});
+/** Absence (no `offersJson`, empty string) is a legitimate no-offers state; a
+ * present-but-malformed payload is a driver defect and refuses loudly — a
+ * silent [] would cost the plugin author the hours the machine can catch. */
+function parseOffers(raw) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (typeof raw !== "string") {
+        throw new Error("harness/kernel/offers: offersJson must be a JSON string");
+    }
+    if (raw.trim() === "")
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`harness/kernel/offers: offersJson is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error("harness/kernel/offers: offersJson must be a JSON array of offer objects");
+    }
+    for (const item of parsed) {
+        if (typeof item !== "object" || item === null || Array.isArray(item)) {
+            throw new Error("harness/kernel/offers: offersJson entries must be objects");
+        }
+    }
+    return parsed;
+}
+//# sourceMappingURL=image.js.map

package/dist/interpreter/image.js.map

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

package/dist/interpreter/imageCapability.d.ts

@@ -0,0 +1,9 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@here.build/arrival";
+import { KernelRoot, SessionRoot } from "@inhuman.tools/harness-model";
+import { z } from "zod";
+export declare const imageCapability: EnvCapability<{
+    kernel: z.ZodCustom<KernelRoot, KernelRoot>;
+    session: z.ZodOptional<z.ZodCustom<SessionRoot, SessionRoot>>;
+}, Record<string, never>>;
+//# sourceMappingURL=imageCapability.d.ts.map

package/dist/interpreter/imageCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageCapability.d.ts","sourceRoot":"","sources":["../../src/interpreter/imageCapability.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;yBA0D1B,CAAC"}

package/dist/interpreter/imageCapability.js

@@ -0,0 +1,49 @@
+/** Kernel and session reads only. Choice/action constructors are `harness/ui`. */
+import { EnvCapability } from "@here.build/arrival";
+import { KernelRoot, SessionRoot } from "@inhuman.tools/harness-model";
+import { DriverSpec } from "@inhuman.tools/plexus-expectations";
+import { z } from "zod";
+export const imageCapability = EnvCapability.define("harness/image", {
+    configuration: {
+        kernel: z.instanceof(KernelRoot),
+        session: z.instanceof(SessionRoot).optional(),
+    },
+    symbols: (symbol, sz) => ({
+        "harness/kernel/connections": symbol.rosetta `harness/kernel/connections: live ConnectionSpec list`({ input: [], output: [sz.list(sz.box)], provenance: "source" }, function () {
+            return Object.values(this.configuration.kernel.connections);
+        }),
+        "harness/kernel/drivers": symbol.rosetta `harness/kernel/drivers: live DriverSpec list`({
+            input: [],
+            inputRest: { abilityClaim: sz.foldName.optional() },
+            output: [sz.list(sz.box)],
+            provenance: "source",
+        }, function ({ abilityClaim: want }) {
+            const all = Object.values(this.configuration.kernel.drivers);
+            return want === undefined ? all : all.filter((item) => item.abilityClaim.includes(want));
+        }),
+        // pipe, not source: pure projection of the driver ARGUMENT — mints nothing.
+        "harness/kernel/offers": symbol.rosetta `harness/kernel/offers: class-bootstrap offers on a driver`({ input: [sz.box.pipe(z.instanceof(DriverSpec))], output: [sz.list(sz.box)], provenance: "pipe" }, function (driver) {
+            return [...driver.offers];
+        }),
+        // Total read over a possibly-empty image: sessionless eval (kernel-scope
+        // commands) and a missing key both read as "" — connect.scm's
+        // `(equal? last "")` pins that contract. Not a door candidate.
+        "harness/session/get-current": symbol.rosetta `harness/session/get-current: immutable current kv; "" when unset or sessionless`({ input: [sz.foldName], output: [sz.string], provenance: "source" }, function (key) {
+            const session = this.configuration.session;
+            if (session === undefined)
+                return "";
+            return session.kvs[key] ?? "";
+        }),
+        // Same total-read contract as get-current. A session reads its own snapshot
+        // (mint + this conversation's writes); sessionless eval reads the live
+        // kernel index. connect.scm falls back to a version-derived default.
+        "harness/session/last-used-model": symbol.rosetta `harness/session/last-used-model: model last used on a connection; "" when none`({ input: [sz.foldName], output: [sz.string], provenance: "source" }, function (connection) {
+            const session = this.configuration.session;
+            if (session?.lastUsedConnectionModel[connection] !== undefined) {
+                return session.lastUsedConnectionModel[connection];
+            }
+            return this.configuration.kernel.lastUsedConnectionModel[connection] ?? "";
+        }),
+    }),
+});
+//# sourceMappingURL=imageCapability.js.map

package/dist/interpreter/imageCapability.js.map

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

package/dist/interpreter/reactivity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { type ExecOptions } from "@inhuman.tools/arrival";
+export type ComputedExecOptions = Omit<ExecOptions, "membraneClosure">;
+export declare class ComputedExecBox<T> {
+    #private;
+    constructor(source: string, opts: ComputedExecOptions);
+    get(): T | undefined;
+}
+//# sourceMappingURL=reactivity.d.ts.map

package/dist/interpreter/reactivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity.d.ts","sourceRoot":"","sources":["../../src/interpreter/reactivity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGhE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAOvE,qBAAa,eAAe,CAAC,CAAC;;IAU5B,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAQpD;IAED,GAAG,IAAI,CAAC,GAAG,SAAS,CAGnB;CA8DF"}

package/dist/interpreter/reactivity.js

@@ -0,0 +1,86 @@
+/**
+ * Observe-on-demand Arrival exec. The box is a MobX atom: first observer
+ * arms membraneClosure tracking; last observer tears the reaction down.
+ */
+import { exec } from "@inhuman.tools/arrival";
+import { comparer, createAtom, Reaction } from "mobx";
+export class ComputedExecBox {
+    #source;
+    #opts;
+    #atom;
+    #value;
+    #generation = 0;
+    #controller = null;
+    #rx = null;
+    #probe = null;
+    constructor(source, opts) {
+        this.#source = source;
+        this.#opts = opts;
+        this.#atom = createAtom("computedExec", () => this.#start(), () => this.#stop());
+    }
+    get() {
+        this.#atom.reportObserved();
+        return this.#value;
+    }
+    #start() {
+        this.#controller = new AbortController();
+        this.#rx = new Reaction("computedExec.deps", () => void this.#run(), undefined, false);
+        this.#probe = new Reaction("computedExec.probe", () => undefined, undefined, false);
+        void this.#run();
+    }
+    #stop() {
+        this.#generation += 1;
+        this.#controller?.abort();
+        this.#controller = null;
+        this.#rx?.dispose();
+        this.#rx = null;
+        this.#probe?.dispose();
+        this.#probe = null;
+    }
+    async #run() {
+        const rx = this.#rx;
+        const probe = this.#probe;
+        const controller = this.#controller;
+        if (rx === null || probe === null || controller === null)
+            return;
+        const generation = (this.#generation += 1);
+        const held = new Set();
+        try {
+            const values = await exec(this.#source, {
+                ...this.#opts,
+                signal: AbortSignal.any([this.#opts.signal, controller.signal].filter(v => v !== undefined)),
+                membraneClosure: (work) => {
+                    let result;
+                    probe.track(() => {
+                        result = work();
+                    });
+                    for (const dep of probe.observing_)
+                        held.add(dep);
+                    return result;
+                },
+            });
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+            rx.track(() => {
+                // Every held atom. Returning after the first drops `rows.keys` / `row.name`.
+                for (const dep of held) {
+                    if (typeof dep.reportObserved === "function") {
+                        dep.reportObserved();
+                        continue;
+                    }
+                    dep.get?.();
+                }
+            });
+            const next = values.at(-1);
+            if (comparer.structural(next, this.#value))
+                return;
+            this.#value = next;
+            this.#atom.reportChanged();
+        }
+        catch {
+            if (generation !== this.#generation || controller.signal.aborted)
+                return;
+        }
+    }
+}
+//# sourceMappingURL=reactivity.js.map