@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/hypervisor/hypervisor.js

@@ -0,0 +1,472 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { mkdir } from "node:fs/promises";
+import { note, trace } from "@inhuman.tools/harness-diagnostics";
+import { publishedReadiness, serverRosterSchema, SUPERVISION_PROTOCOL_VERSION, } from "../protocol/schemas/index.js";
+import { isPlaneReady, isStaleSupervisionIdentity, mayReplaceExecutionOwner, mayStartExecutionOwnerAfterYjsLoss, replacementDecision, } from "../protocol/supervision/index.js";
+import { readSupervisionMessages, writeSupervisionMessage } from "./ipc.js";
+import { isLifetimeLockHeld, LifetimeLock, lockPathFor, waitForLockRelease } from "./lock.js";
+import { pidAlive, sleep, waitUntil } from "./util.js";
+const READY_TIMEOUT_MS = 10_000;
+const LOCK_WAIT_MS = 10_000;
+const STOP_GRACE_MS = 500;
+export class AdmissionRefusedError extends Error {
+    constructor() {
+        super("hypervisor admission refused");
+        this.name = "AdmissionRefusedError";
+    }
+}
+export class ReplacementRefusedError extends Error {
+    reason;
+    constructor(reason) {
+        super(`replacement refused: ${reason}`);
+        this.reason = reason;
+        this.name = "ReplacementRefusedError";
+    }
+}
+export class Hypervisor {
+    root;
+    hypervisorId;
+    serverRoster;
+    env;
+    readyTimeoutMs;
+    children = new Map();
+    admission = "open";
+    rootLock;
+    serverEpoch = 1;
+    runtimeGeneration = 1;
+    chain = Promise.resolve();
+    constructor(options, roster) {
+        this.root = options.root;
+        this.hypervisorId = options.hypervisorId ?? randomUUID();
+        this.serverRoster = roster;
+        this.env = options.env ?? process.env;
+        this.readyTimeoutMs = options.readyTimeoutMs ?? READY_TIMEOUT_MS;
+    }
+    static async start(options) {
+        const roster = serverRosterSchema.parse(options.serverRoster);
+        const hv = new Hypervisor(options, roster);
+        await mkdir(options.root, { recursive: true });
+        hv.rootLock = await LifetimeLock.acquire(lockPathFor(options.root, "root"), "root");
+        try {
+            await hv.boot();
+        }
+        catch (error) {
+            await hv.shutdown({ deadlineMs: 5_000 }).catch(() => undefined);
+            throw error;
+        }
+        return hv;
+    }
+    get admissionState() {
+        return this.admission;
+    }
+    health() {
+        const yjs = this.roleChild("yjs");
+        const runtime = this.roleChild("runtime");
+        return {
+            sync: planeOf(yjs, "sync"),
+            storage: planeOf(yjs, "storage"),
+            execution: planeOf(runtime, "execution"),
+        };
+    }
+    snapshot() {
+        return [...this.children.values()].map((child) => ({
+            id: child.descriptor.id,
+            role: child.descriptor.role,
+            pid: child.process?.pid,
+            identity: child.identity,
+            health: child.health,
+            exit: child.exit,
+            cutoff: child.cutoff,
+        }));
+    }
+    async replace(id) {
+        await this.enqueue(() => this.replaceExclusive(id));
+    }
+    async replaceExclusive(id) {
+        const child = this.requireChild(id);
+        if (this.admission === "refused")
+            throw new AdmissionRefusedError();
+        const evidence = await this.ownerEvidence(child);
+        const decision = replacementDecision(evidence);
+        if (decision.action !== "replace") {
+            throw new ReplacementRefusedError(decision.reason);
+        }
+        if (child.descriptor.role === "runtime")
+            this.runtimeGeneration += 1;
+        if (child.descriptor.role === "yjs")
+            this.serverEpoch += 1;
+        await this.spawnAndWaitReady(child.descriptor);
+    }
+    async shutdown(options) {
+        const deadlineMs = options?.deadlineMs ?? 5_000;
+        this.admission = "refused";
+        const live = [...this.children.values()].filter((child) => child.process !== undefined && child.exit === undefined);
+        await Promise.all(live.map((child) => this.send(child, {
+            v: SUPERVISION_PROTOCOL_VERSION,
+            op: "shutdown",
+            identity: child.identity,
+            deadlineMs,
+        })));
+        const deadline = Date.now() + deadlineMs;
+        try {
+            await waitUntil("children stop", () => [...this.children.values()].every((child) => child.exit !== undefined), Math.max(0, deadline - Date.now()));
+        }
+        catch {
+            /* force remaining */
+        }
+        let forced = false;
+        for (const child of this.children.values()) {
+            if (child.exit !== undefined)
+                continue;
+            forced = true;
+            const pid = child.process?.pid;
+            if (pid !== undefined && pidAlive(pid)) {
+                try {
+                    child.process?.kill("SIGTERM");
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+        }
+        await sleep(STOP_GRACE_MS);
+        for (const child of this.children.values()) {
+            if (child.exit !== undefined)
+                continue;
+            const pid = child.process?.pid;
+            if (pid !== undefined && pidAlive(pid)) {
+                try {
+                    child.process?.kill("SIGKILL");
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+        }
+        await waitUntil("forced child exit", () => [...this.children.values()].every((child) => child.exit !== undefined), 5_000).catch(() => undefined);
+        for (const child of this.children.values()) {
+            if (child.lockPath !== undefined) {
+                await waitForLockRelease(child.lockPath, LOCK_WAIT_MS).catch(() => undefined);
+            }
+        }
+        const flush = this.aggregateFlush();
+        const cutoff = {
+            admission: "refused",
+            drain: [...this.children.values()].every((child) => child.exit !== undefined) ? "complete" : "pending",
+            flush,
+            forced,
+        };
+        await this.rootLock?.release();
+        this.rootLock = undefined;
+        note(`hypervisor shutdown complete forced=${forced} flush=${flush}`);
+        return cutoff;
+    }
+    async [Symbol.asyncDispose]() {
+        if (this.rootLock !== undefined) {
+            await this.shutdown({ deadlineMs: 5_000 });
+        }
+    }
+    async boot() {
+        const remaining = new Set(this.serverRoster.servers.map((server) => server.id));
+        while (remaining.size > 0) {
+            const next = this.serverRoster.servers.find((server) => remaining.has(server.id) && server.requires.every((required) => this.isReady(required)));
+            if (next === undefined) {
+                await waitUntil("readiness dependencies", () => this.serverRoster.servers.some((server) => remaining.has(server.id) && server.requires.every((required) => this.isReady(required))), this.readyTimeoutMs);
+                continue;
+            }
+            remaining.delete(next.id);
+            await this.spawnAndWaitReady(next);
+        }
+    }
+    isReady(id) {
+        const child = this.children.get(id);
+        if (child === undefined || child.exit !== undefined)
+            return false;
+        return publishedReadiness(child.descriptor.role).every((kind) => isPlaneReady(child.health, kind));
+    }
+    roleChild(role) {
+        return [...this.children.values()].find((child) => child.descriptor.role === role);
+    }
+    requireChild(id) {
+        const child = this.children.get(id);
+        if (child === undefined)
+            throw new Error(`unknown descriptor ${id}`);
+        return child;
+    }
+    makeIdentity(descriptor) {
+        return {
+            hypervisor: { kind: "hypervisor", id: this.hypervisorId },
+            process: { kind: descriptor.role, id: descriptor.id },
+            serverEpoch: this.serverEpoch,
+            runtimeGeneration: this.runtimeGeneration,
+            connectionEpoch: 1,
+        };
+    }
+    lockPathForRole(role) {
+        return role === "runtime" ? lockPathFor(this.root, "runtime") : undefined;
+    }
+    async ownerEvidence(child) {
+        const lockReleased = child.lockPath === undefined ? true : !(await isLifetimeLockHeld(child.lockPath));
+        return {
+            exitConfirmed: child.exit !== undefined,
+            lockReleased,
+            parentLost: child.parentLost,
+            dataDisconnected: child.dataDisconnected,
+            heartbeatMissing: child.heartbeatMissing,
+        };
+    }
+    async spawnAndWaitReady(descriptor) {
+        if (this.admission === "refused")
+            throw new AdmissionRefusedError();
+        await this.waitForRequires(descriptor);
+        const lockPath = this.lockPathForRole(descriptor.role);
+        const previous = this.roleChild(descriptor.role);
+        if (previous !== undefined && previous.exit === undefined) {
+            const decision = replacementDecision(await this.ownerEvidence(previous));
+            if (decision.action !== "replace") {
+                throw new ReplacementRefusedError(decision.reason);
+            }
+        }
+        if (lockPath !== undefined) {
+            await waitForLockRelease(lockPath, LOCK_WAIT_MS);
+        }
+        if (previous !== undefined && descriptor.role === "runtime") {
+            const decision = replacementDecision(await this.ownerEvidence(previous));
+            if (decision.action !== "replace") {
+                throw new ReplacementRefusedError(decision.reason);
+            }
+        }
+        // Shutdown may have collected its live set during the awaits above.
+        if (this.admissionState === "refused")
+            throw new AdmissionRefusedError();
+        const identity = this.makeIdentity(descriptor);
+        const childEnv = {
+            ...this.env,
+            HARNESS_ROLE: descriptor.role,
+            HARNESS_SUPERVISION_IDENTITY: JSON.stringify(identity),
+        };
+        if (lockPath !== undefined) {
+            childEnv.HARNESS_LOCK_PATH = lockPath;
+            childEnv.HARNESS_LOCK_KIND = "runtime";
+        }
+        trace("harness:hypervisor", `spawn ${descriptor.id} role=${descriptor.role} gen=${identity.runtimeGeneration} epoch=${identity.serverEpoch}`);
+        const childProcess = spawn(descriptor.executable, descriptor.args, {
+            cwd: this.root,
+            env: childEnv,
+            stdio: ["pipe", "pipe", "inherit"],
+        });
+        childProcess.stdin.on("error", () => {
+            /* EPIPE after child death is not a hypervisor failure */
+        });
+        childProcess.stdout.on("error", () => {
+            /* closed pipe */
+        });
+        const record = {
+            descriptor,
+            process: childProcess,
+            identity,
+            health: {},
+            lockPath,
+            exit: undefined,
+            cutoff: undefined,
+            restartAttempts: this.children.get(descriptor.id)?.restartAttempts ?? 0,
+            parentLost: false,
+            dataDisconnected: false,
+            heartbeatMissing: false,
+        };
+        this.children.set(descriptor.id, record);
+        readSupervisionMessages(childProcess.stdout, (message) => this.onMessage(descriptor.id, message), (error) => {
+            note(`hypervisor ${descriptor.id} control ipc fatal ${String(error)}`);
+            try {
+                childProcess.kill("SIGTERM");
+            }
+            catch {
+                /* gone */
+            }
+        });
+        childProcess.once("exit", (code, signal) => {
+            const current = this.children.get(descriptor.id);
+            if (current?.process !== undefined && current.process !== childProcess) {
+                return;
+            }
+            // Record exit on the event, not only inside the serialized onExit
+            // chain — spawnAndWaitReady may be on that chain already.
+            this.recordExit(descriptor.id, childProcess, code, signal);
+            void this.enqueue(() => this.onExit(descriptor.id, code, signal));
+        });
+        try {
+            await waitUntil(`${descriptor.id} ready`, () => record.exit !== undefined ||
+                publishedReadiness(descriptor.role).every((kind) => isPlaneReady(record.health, kind)), this.readyTimeoutMs);
+        }
+        catch (error) {
+            // A child that never came ready still holds its lock. Its exit runs the restart policy.
+            childProcess.kill("SIGKILL");
+            throw error;
+        }
+        if (record.exit !== undefined) {
+            throw new Error(`${descriptor.id} exited before ready code=${record.exit.code} signal=${record.exit.signal}`);
+        }
+        record.restartAttempts = 0;
+    }
+    onMessage(id, message) {
+        const child = this.children.get(id);
+        if (child === undefined)
+            return;
+        if (isStaleSupervisionIdentity(child.identity, message.identity)) {
+            trace("harness:hypervisor", `drop stale frame from ${id}`);
+            return;
+        }
+        if (message.identity.process.id !== child.descriptor.id)
+            return;
+        if (message.op === "ready" || message.op === "health" || message.op === "failed") {
+            child.health = message.health;
+        }
+        if (message.op === "failed") {
+            note(`hypervisor ${id} failed ${message.reason}`);
+        }
+        if (message.op === "stopped") {
+            child.cutoff = message.cutoff;
+        }
+        if (message.op === "loss") {
+            if (message.kind === "parent-lost")
+                child.parentLost = true;
+            if (message.kind === "data-disconnected")
+                child.dataDisconnected = true;
+            if (message.kind === "heartbeat-missing")
+                child.heartbeatMissing = true;
+        }
+    }
+    enqueue(op) {
+        const run = this.chain.then(op, op);
+        this.chain = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    recordExit(id, childProcess, code, signal) {
+        const child = this.children.get(id);
+        if (child === undefined)
+            return;
+        if (child.process !== undefined && child.process !== childProcess)
+            return;
+        if (child.exit !== undefined)
+            return;
+        child.exit = { code, signal };
+        child.process = undefined;
+    }
+    async waitForRequires(descriptor) {
+        if (descriptor.requires.length === 0)
+            return;
+        await waitUntil(`${descriptor.id} requires`, () => descriptor.requires.every((required) => this.isReady(required)), this.readyTimeoutMs);
+    }
+    async onExit(id, code, signal) {
+        const child = this.children.get(id);
+        if (child === undefined)
+            return;
+        child.exit ??= { code, signal };
+        child.process = undefined;
+        note(`hypervisor ${id} exited code=${code} signal=${signal ?? "none"}`);
+        if (child.lockPath !== undefined) {
+            await waitForLockRelease(child.lockPath, LOCK_WAIT_MS).catch(() => {
+                note(`hypervisor ${id} lock still held after exit`);
+            });
+        }
+        if (this.admission === "refused")
+            return;
+        if (child.descriptor.role === "yjs") {
+            await this.stopRuntimeBeforeYjsReplace(child);
+        }
+        if (!(await this.shouldRestart(child)))
+            return;
+        child.restartAttempts += 1;
+        if (child.descriptor.role === "runtime")
+            this.runtimeGeneration += 1;
+        if (child.descriptor.role === "yjs")
+            this.serverEpoch += 1;
+        await sleep(child.descriptor.restart.backoffMs);
+        try {
+            await this.spawnAndWaitReady(child.descriptor);
+        }
+        catch (error) {
+            note(`hypervisor restart ${id} failed ${String(error)}`);
+        }
+    }
+    async stopRuntimeBeforeYjsReplace(yjs) {
+        const runtime = this.roleChild("runtime");
+        if (runtime === undefined || runtime.exit !== undefined)
+            return;
+        await this.send(runtime, {
+            v: SUPERVISION_PROTOCOL_VERSION,
+            op: "shutdown",
+            identity: runtime.identity,
+            deadlineMs: 5_000,
+        });
+        try {
+            await waitUntil("runtime exit after yjs loss", () => runtime.exit !== undefined, 5_000);
+        }
+        catch {
+            try {
+                runtime.process?.kill("SIGKILL");
+            }
+            catch {
+                /* gone */
+            }
+        }
+        const evidence = await this.ownerEvidence(runtime);
+        if (!mayStartExecutionOwnerAfterYjsLoss(evidence)) {
+            note(`hypervisor yjs ${yjs.descriptor.id} loss still holds runtime lock`);
+        }
+    }
+    async shouldRestart(child) {
+        if (this.admission === "refused")
+            return false;
+        if (child.exit === undefined)
+            return false;
+        const { mode, maxAttempts } = child.descriptor.restart;
+        if (mode === "never")
+            return false;
+        if (child.restartAttempts >= maxAttempts)
+            return false;
+        const failed = child.exit.code !== 0 || child.exit.signal != null;
+        if (mode === "on-failure" && !failed)
+            return false;
+        const evidence = await this.ownerEvidence(child);
+        if (child.descriptor.role === "runtime" && !mayReplaceExecutionOwner(evidence)) {
+            return false;
+        }
+        return true;
+    }
+    async send(child, message) {
+        const stdin = child.process?.stdin;
+        if (stdin == null)
+            return;
+        try {
+            await writeSupervisionMessage(stdin, message);
+        }
+        catch {
+            /* child already closing */
+        }
+    }
+    aggregateFlush() {
+        const reports = [...this.children.values()].map((child) => child.cutoff);
+        if (reports.length === 0)
+            return "ok";
+        if (reports.some((cutoff) => cutoff?.flush === "failed"))
+            return "failed";
+        if (reports.every((cutoff) => cutoff?.flush === "ok"))
+            return "ok";
+        // Missing cutoff is not success. Forced-pending stays visible.
+        return "pending";
+    }
+}
+function planeOf(child, kind) {
+    if (child === undefined)
+        return { state: "starting" };
+    if (child.exit !== undefined) {
+        const plane = child.health[kind];
+        if (plane?.state === "failed" || plane?.state === "degraded")
+            return plane;
+        return { state: "disconnected", reason: "process exited" };
+    }
+    return child.health[kind] ?? { state: "starting" };
+}
+//# sourceMappingURL=hypervisor.js.map

package/dist/hypervisor/hypervisor.js.map

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

package/dist/hypervisor/index.d.ts

@@ -0,0 +1,4 @@
+export { runSupervisedProcess as runSupervisedProcess } from "./child-runtime.js";
+export * from "./hypervisor.js";
+export * from "./lock.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hypervisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,IAAI,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/hypervisor/index.js

@@ -0,0 +1,4 @@
+export { runSupervisedProcess as runSupervisedProcess } from "./child-runtime.js";
+export * from "./hypervisor.js";
+export * from "./lock.js";
+//# sourceMappingURL=index.js.map

package/dist/hypervisor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hypervisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,IAAI,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/hypervisor/ipc.d.ts

@@ -0,0 +1,5 @@
+import type { Readable, Writable } from "node:stream";
+import type { SupervisionMessage } from "../protocol/schemas/index.js";
+export declare function writeSupervisionMessage(out: Writable, message: SupervisionMessage): Promise<void>;
+export declare function readSupervisionMessages(input: Readable, onMessage: (message: SupervisionMessage) => void, onFatal: (error: unknown) => void): void;
+//# sourceMappingURL=ipc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.d.ts","sourceRoot":"","sources":["../../src/hypervisor/ipc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,EAChD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,IAAI,CAmBN"}

package/dist/hypervisor/ipc.js

@@ -0,0 +1,36 @@
+import { decodeSupervisionMessage, encodeSupervisionMessage } from "../protocol/supervision/index.js";
+export function writeSupervisionMessage(out, message) {
+    const line = `${encodeSupervisionMessage(message)}\n`;
+    return new Promise((resolve, reject) => {
+        out.write(line, (error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
+export function readSupervisionMessages(input, onMessage, onFatal) {
+    let buffer = "";
+    input.setEncoding("utf8");
+    input.on("data", (chunk) => {
+        buffer += chunk;
+        for (;;) {
+            const index = buffer.indexOf("\n");
+            if (index === -1)
+                break;
+            const line = buffer.slice(0, index).trim();
+            buffer = buffer.slice(index + 1);
+            if (line === "")
+                continue;
+            try {
+                onMessage(decodeSupervisionMessage(line));
+            }
+            catch (error) {
+                onFatal(error);
+                return;
+            }
+        }
+    });
+}
+//# sourceMappingURL=ipc.js.map

package/dist/hypervisor/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../src/hypervisor/ipc.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE5F,MAAM,UAAU,uBAAuB,CAAC,GAAa,EAAE,OAA2B;IAChF,MAAM,IAAI,GAAG,GAAG,wBAAwB,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACxB,IAAI,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;gBACpB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAAe,EACf,SAAgD,EAChD,OAAiC;IAEjC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC;QAChB,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,MAAM;YACxB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,EAAE;gBAAE,SAAS;YAC1B,IAAI,CAAC;gBACH,SAAS,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/hypervisor/lock.d.ts

@@ -0,0 +1,20 @@
+import type { LockKind } from "../protocol/schemas/index.js";
+export declare class LockHeldError extends Error {
+    readonly path: string;
+    constructor(path: string);
+}
+export declare class LifetimeLock {
+    readonly kind: LockKind;
+    readonly path: string;
+    private readonly server;
+    private released;
+    private constructor();
+    static acquire(path: string, kind: LockKind): Promise<LifetimeLock>;
+    static tryAcquire(path: string, kind: LockKind): Promise<LifetimeLock | null>;
+    release(): Promise<void>;
+}
+/** Darwin unix-socket paths cap at 104 bytes; keep names short under `/tmp`. */
+export declare function lockPathFor(root: string, kind: LockKind): string;
+export declare function isLifetimeLockHeld(path: string): Promise<boolean>;
+export declare function waitForLockRelease(path: string, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/hypervisor/lock.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAenD,qBAAa,aAAc,SAAQ,KAAK;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIlC;AAED,qBAAa,YAAY;IAIrB,QAAQ,CAAC,IAAI,EAAE,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;WAMM,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;WAM5D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA0B7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB/B;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEhE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF"}