@inhuman.tools/harness 0.0.0-stage → 0.2.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":"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"}

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/policy-processor/explain.d.ts

@@ -0,0 +1,2 @@
+export { explainCall, type Explanation, type ExplainProbe } from "@inhuman.tools/turn/explain";
+//# sourceMappingURL=explain.d.ts.map

package/dist/policy-processor/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/policy-processor/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/policy-processor/explain.js

@@ -0,0 +1,2 @@
+export { explainCall } from "@inhuman.tools/turn/explain";
+//# sourceMappingURL=explain.js.map

package/dist/policy-processor/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/policy-processor/explain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuC,MAAM,6BAA6B,CAAC"}

package/dist/policy-processor/index.d.ts

@@ -0,0 +1,2 @@
+export type { Disposition as Disposition, Policy as Policy } from "@inhuman.tools/turn/policy";
+//# sourceMappingURL=index.d.ts.map

package/dist/policy-processor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/policy-processor/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/policy-processor/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/policy-processor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policy-processor/index.ts"],"names":[],"mappings":""}

package/dist/policy-processor/license.d.ts

@@ -0,0 +1,2 @@
+export { license, noteDenied } from "@inhuman.tools/turn/license";
+//# sourceMappingURL=license.d.ts.map

package/dist/policy-processor/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/policy-processor/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/policy-processor/license.js

@@ -0,0 +1,2 @@
+export { license, noteDenied } from "@inhuman.tools/turn/license";
+//# sourceMappingURL=license.js.map

package/dist/policy-processor/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../src/policy-processor/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/policy-processor/peel-cwd.d.ts

@@ -0,0 +1,2 @@
+export { peelShellCwd } from "@inhuman.tools/turn/peel-cwd";
+//# sourceMappingURL=peel-cwd.d.ts.map

package/dist/policy-processor/peel-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peel-cwd.d.ts","sourceRoot":"","sources":["../../src/policy-processor/peel-cwd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/policy-processor/peel-cwd.js

@@ -0,0 +1,2 @@
+export { peelShellCwd } from "@inhuman.tools/turn/peel-cwd";
+//# sourceMappingURL=peel-cwd.js.map

package/dist/policy-processor/peel-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peel-cwd.js","sourceRoot":"","sources":["../../src/policy-processor/peel-cwd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/policy-processor/scope.d.ts

@@ -0,0 +1,2 @@
+export { floorVerdict, LicenseScope, scopes, withRealRoots } from "@inhuman.tools/turn/scope";
+//# sourceMappingURL=scope.d.ts.map

package/dist/policy-processor/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/policy-processor/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/policy-processor/scope.js

@@ -0,0 +1,2 @@
+export { floorVerdict, LicenseScope, scopes, withRealRoots } from "@inhuman.tools/turn/scope";
+//# sourceMappingURL=scope.js.map

package/dist/policy-processor/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/policy-processor/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/protocol/document/checkpoint.d.ts

@@ -0,0 +1,32 @@
+import * as Y from "yjs";
+import { type DocumentKey } from "./keys.js";
+export type DocumentCheckpoint = {
+    readonly key: DocumentKey;
+    readonly serverEpoch: number;
+    readonly revision: number;
+    /** Yjs state vector of the covered prefix — not a durability receipt. */
+    readonly stateVector: Uint8Array;
+};
+export type DurableReceipt = {
+    readonly key: DocumentKey;
+    readonly serverEpoch: number;
+    readonly runtimeGeneration: number;
+    readonly connectionEpoch: number;
+    readonly revision: number;
+    /** Covered update prefix, including deletions. */
+    readonly prefix: Uint8Array;
+};
+export type FlushResult = {
+    readonly ok: true;
+    readonly receipt: DurableReceipt;
+} | {
+    readonly ok: false;
+    readonly reason: "storage-failed" | "disconnected" | "overload";
+};
+export declare function checkpointOf(doc: Y.Doc, key: DocumentKey, serverEpoch: number, revision: number): DocumentCheckpoint;
+export declare function receiptCoversCheckpoint(receipt: DurableReceipt, checkpoint: DocumentCheckpoint): boolean;
+export declare function encodeDocumentCheckpoint(checkpoint: DocumentCheckpoint): Uint8Array;
+export declare function decodeDocumentCheckpoint(bytes: Uint8Array): DocumentCheckpoint | null;
+export declare function encodeDurableReceipt(receipt: DurableReceipt): Uint8Array;
+export declare function decodeDurableReceipt(bytes: Uint8Array): DurableReceipt | null;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/protocol/document/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/checkpoint.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAwD,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GACvD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,GAAG,UAAU,CAAC;CACjE,CAAC;AAEN,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAOpH;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAMxG;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,GAAG,UAAU,CAOnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI,CAWrF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CASxE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAoB7E"}

package/dist/protocol/document/checkpoint.js

@@ -0,0 +1,76 @@
+/**
+ * Flush checkpoints and exact-prefix durable receipts. A state vector alone
+ * is not a durability proof; the receipt covers server epoch, runtime
+ * generation, connection epoch, and the update prefix.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import * as Y from "yjs";
+import { documentKeysEqual, readDocumentKey, writeDocumentKey } from "./keys.js";
+export function checkpointOf(doc, key, serverEpoch, revision) {
+    return {
+        key,
+        serverEpoch,
+        revision,
+        stateVector: Y.encodeStateVector(doc),
+    };
+}
+export function receiptCoversCheckpoint(receipt, checkpoint) {
+    return (documentKeysEqual(receipt.key, checkpoint.key) &&
+        receipt.serverEpoch === checkpoint.serverEpoch &&
+        receipt.revision >= checkpoint.revision);
+}
+export function encodeDocumentCheckpoint(checkpoint) {
+    const encoder = encoding.createEncoder();
+    writeDocumentKey(encoder, checkpoint.key);
+    encoding.writeVarUint(encoder, checkpoint.serverEpoch);
+    encoding.writeVarUint(encoder, checkpoint.revision);
+    encoding.writeVarUint8Array(encoder, checkpoint.stateVector);
+    return encoding.toUint8Array(encoder);
+}
+export function decodeDocumentCheckpoint(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const key = readDocumentKey(decoder);
+        const serverEpoch = decoding.readVarUint(decoder);
+        const revision = decoding.readVarUint(decoder);
+        const stateVector = decoding.readVarUint8Array(decoder);
+        return { key, serverEpoch, revision, stateVector };
+    }
+    catch {
+        return null;
+    }
+}
+export function encodeDurableReceipt(receipt) {
+    const encoder = encoding.createEncoder();
+    writeDocumentKey(encoder, receipt.key);
+    encoding.writeVarUint(encoder, receipt.serverEpoch);
+    encoding.writeVarUint(encoder, receipt.runtimeGeneration);
+    encoding.writeVarUint(encoder, receipt.connectionEpoch);
+    encoding.writeVarUint(encoder, receipt.revision);
+    encoding.writeVarUint8Array(encoder, receipt.prefix);
+    return encoding.toUint8Array(encoder);
+}
+export function decodeDurableReceipt(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const key = readDocumentKey(decoder);
+        const serverEpoch = decoding.readVarUint(decoder);
+        const runtimeGeneration = decoding.readVarUint(decoder);
+        const connectionEpoch = decoding.readVarUint(decoder);
+        const revision = decoding.readVarUint(decoder);
+        const prefix = decoding.readVarUint8Array(decoder);
+        return {
+            key,
+            serverEpoch,
+            runtimeGeneration,
+            connectionEpoch,
+            revision,
+            prefix,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/protocol/document/checkpoint.js.map

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

package/dist/protocol/document/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./keys.js";
+export * from "./checkpoint.js";
+export * from "./inventory.js";
+export * from "./occupancy.js";
+export * from "./ordering.js";
+export * from "./private.js";
+export { applyPeerSyncFrame, decodeAwarenessPayload, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, encodeSyncStep1, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, peekMessageType, replyLensSyncFrame, } from "@inhuman.tools/harness-peer/frames";
+export { bindPlexusAwareness, encodeLocalAwarenessFrame, forwardPlexusAwareness, ingestPlexusAwareness, REMOTE_AWARENESS_ORIGIN, type AwarenessPlane, type AwarenessUpdate, } from "@inhuman.tools/harness-peer/awareness";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/document/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,uCAAuC,CAAC"}

package/dist/protocol/document/index.js

@@ -0,0 +1,11 @@
+export * from "./keys.js";
+export * from "./checkpoint.js";
+export * from "./inventory.js";
+export * from "./occupancy.js";
+export * from "./ordering.js";
+export * from "./private.js";
+// The Yjs frame codecs and the awareness plane live in the browser-safe peer package.
+// Subpaths, not the barrel: the barrel registers every synced model, which the Yjs server does not need.
+export { applyPeerSyncFrame, decodeAwarenessPayload, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, encodeSyncStep1, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, peekMessageType, replyLensSyncFrame, } from "@inhuman.tools/harness-peer/frames";
+export { bindPlexusAwareness, encodeLocalAwarenessFrame, forwardPlexusAwareness, ingestPlexusAwareness, REMOTE_AWARENESS_ORIGIN, } from "@inhuman.tools/harness-peer/awareness";
+//# sourceMappingURL=index.js.map

package/dist/protocol/document/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/document/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,sFAAsF;AACtF,yGAAyG;AACzG,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GAGxB,MAAM,uCAAuC,CAAC"}

package/dist/protocol/document/inventory.d.ts

@@ -0,0 +1,37 @@
+import { type DocumentKey, type DocumentKind } from "./keys.js";
+export type InventoryEntry = {
+    readonly key: DocumentKey;
+    readonly durableRevision: number;
+    readonly storagePath: string;
+};
+export type InventoryCheckpoint = {
+    readonly serverEpoch: number;
+    readonly cut: number;
+};
+export type InventoryPage = {
+    readonly entries: readonly InventoryEntry[];
+    readonly cursor: string | null;
+    readonly checkpoint: InventoryCheckpoint;
+};
+export type InventoryListQuery = {
+    readonly kind: DocumentKind;
+    readonly cursor: string | null;
+};
+export type InventoryGapReason = "overflow" | "missing-checkpoint" | "epoch-change";
+export type InventoryWatchEvent = {
+    readonly type: "change";
+    readonly key: DocumentKey;
+    readonly revision: number;
+} | {
+    readonly type: "gap";
+    readonly reason: InventoryGapReason;
+    readonly serverEpoch: number;
+};
+export type InventoryErrorReason = "mismatch" | "corrupt" | "empty" | "decode-failure";
+export type InventoryError = {
+    readonly storagePath: string;
+    readonly reason: InventoryErrorReason;
+};
+export declare function encodeInventoryWatchEvent(event: InventoryWatchEvent): Uint8Array;
+export declare function decodeInventoryWatchEvent(bytes: Uint8Array): InventoryWatchEvent | null;
+//# sourceMappingURL=inventory.d.ts.map

package/dist/protocol/document/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../src/protocol/document/inventory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqC,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnG,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,oBAAoB,GAAG,cAAc,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,CAYhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CAmBvF"}

package/dist/protocol/document/inventory.js

@@ -0,0 +1,44 @@
+/**
+ * Identity inventory: catalog rows, pagination cuts, invalidations, and
+ * explicit gaps. Filenames are hashes; overviews are not the catalog.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import { readDocumentKey, writeDocumentKey } from "./keys.js";
+export function encodeInventoryWatchEvent(event) {
+    const encoder = encoding.createEncoder();
+    if (event.type === "change") {
+        encoding.writeVarUint(encoder, 0);
+        writeDocumentKey(encoder, event.key);
+        encoding.writeVarUint(encoder, event.revision);
+    }
+    else {
+        encoding.writeVarUint(encoder, 1);
+        encoding.writeVarString(encoder, event.reason);
+        encoding.writeVarUint(encoder, event.serverEpoch);
+    }
+    return encoding.toUint8Array(encoder);
+}
+export function decodeInventoryWatchEvent(bytes) {
+    try {
+        const decoder = decoding.createDecoder(bytes);
+        const type = decoding.readVarUint(decoder);
+        if (type === 0) {
+            const key = readDocumentKey(decoder);
+            const revision = decoding.readVarUint(decoder);
+            return { type: "change", key, revision };
+        }
+        if (type === 1) {
+            const reason = decoding.readVarString(decoder);
+            if (reason !== "overflow" && reason !== "missing-checkpoint" && reason !== "epoch-change")
+                return null;
+            const serverEpoch = decoding.readVarUint(decoder);
+            return { type: "gap", reason, serverEpoch };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=inventory.js.map

package/dist/protocol/document/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../../src/protocol/document/inventory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAuC,MAAM,WAAW,CAAC;AA6CnG,MAAM,UAAU,yBAAyB,CAAC,KAA0B;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAiB;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,oBAAoB,IAAI,MAAM,KAAK,cAAc;gBAAE,OAAO,IAAI,CAAC;YACvG,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/protocol/document/keys.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Document identity, public rooms, storage-path hashing, and Y.Doc guid
+ * prefixes. Directory names are not identities; images live at
+ * `documents/{kind}/{sha256(id)}.yjs`.
+ */
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+export declare const DOCUMENT_KINDS: readonly ["kernel", "sessions", "projects"];
+export type DocumentKind = (typeof DOCUMENT_KINDS)[number];
+export type DocumentKey = {
+    readonly kind: DocumentKind;
+    readonly id: string;
+};
+/** Storage kind `kernel`, identity `"kernel"`. */
+export declare const KERNEL_DOCUMENT_KEY: DocumentKey;
+/** Matches KernelPlexus. A project guid is minted, not hashed from path. */
+export declare const KERNEL_DOCUMENT_GUID = "harness:kernel";
+export declare const SESSION_DOCUMENT_GUID_PREFIX = "harness:session:";
+export declare const PROJECT_DOCUMENT_GUID_PREFIX = "harness:project";
+export declare const PUBLIC_ROOM: {
+    readonly kernel: "kernel";
+    readonly project: "project";
+    readonly session: "session";
+};
+export type PublicRoomName = (typeof PUBLIC_ROOM)[keyof typeof PUBLIC_ROOM];
+export declare function isDocumentKind(value: string): value is DocumentKind;
+export declare function parseDocumentKind(value: string): DocumentKind;
+export declare function documentKey(kind: DocumentKind, id: string): DocumentKey;
+export declare function documentKeysEqual(a: DocumentKey, b: DocumentKey): boolean;
+export declare function sessionDocumentGuid(sessionId: string): string;
+export declare function publicRoomName(kind: DocumentKind): PublicRoomName;
+export declare function sha256Hex(id: string): string;
+export declare function documentImageFileName(id: string): string;
+/** Path segments under a daemon root. Join with the platform separator at the store. */
+export declare function documentImageSegments(kind: string, id: string): readonly ["documents", string, string];
+export declare function writeDocumentKey(encoder: encoding.Encoder, key: DocumentKey): void;
+export declare function readDocumentKey(decoder: decoding.Decoder): DocumentKey;
+//# sourceMappingURL=keys.d.ts.map