synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/store/durable-file.js

@@ -0,0 +1,84 @@
+import { randomBytes } from "node:crypto";
+import { open, rename, unlink } from "node:fs/promises";
+import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+const RETRYABLE_RENAME_CODES = new Set(["EPERM", "EACCES", "EBUSY"]);
+const RENAME_ATTEMPTS = 8;
+const IGNORED_DIRECTORY_SYNC_CODES = new Set(["EISDIR", "EINVAL", "EPERM", "EBADF", "ENOTSUP"]);
+export const PRIVATE_FILE_MODE = 0o600;
+export const PRIVATE_DIRECTORY_MODE = 0o700;
+export function errnoCode(error) {
+    return error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : undefined;
+}
+export function isMissing(error) {
+    return errnoCode(error) === "ENOENT";
+}
+/**
+ * Temp file in the target directory, fsync, rename over the target, fsync the directory. On
+ * Windows a rename over a file another process holds open fails transiently with EPERM/EACCES/
+ * EBUSY, so the rename is retried with a bounded backoff instead of spinning.
+ */
+export async function writeFileDurably(target, data) {
+    const directory = path.dirname(target);
+    const temporary = path.join(directory, `.${path.basename(target)}.${randomBytes(6).toString("hex")}.tmp`);
+    const handle = await open(temporary, "wx", PRIVATE_FILE_MODE);
+    try {
+        await handle.writeFile(data);
+        await handle.sync();
+    }
+    catch (error) {
+        await handle.close();
+        await unlink(temporary).catch(() => undefined);
+        throw error;
+    }
+    await handle.close();
+    try {
+        await renameWithRetry(temporary, target);
+    }
+    catch (error) {
+        await unlink(temporary).catch(() => undefined);
+        throw error;
+    }
+    await syncDirectory(directory);
+}
+export async function renameWithRetry(from, to) {
+    for (let attempt = 1;; attempt += 1) {
+        try {
+            await rename(from, to);
+            return;
+        }
+        catch (error) {
+            if (attempt >= RENAME_ATTEMPTS || !RETRYABLE_RENAME_CODES.has(errnoCode(error) ?? ""))
+                throw error;
+            await delay(5 * 2 ** attempt);
+        }
+    }
+}
+/** Makes a create/rename/unlink in `directory` durable. Windows cannot open directories; NTFS journals metadata. */
+export async function syncDirectory(directory) {
+    if (process.platform === "win32")
+        return;
+    let handle;
+    try {
+        handle = await open(directory, "r");
+        await handle.sync();
+    }
+    catch (error) {
+        if (!IGNORED_DIRECTORY_SYNC_CODES.has(errnoCode(error) ?? ""))
+            throw error;
+    }
+    finally {
+        await handle?.close();
+    }
+}
+/** Writes every byte; a file handle may report a short write. */
+export async function writeAll(handle, bytes) {
+    let offset = 0;
+    while (offset < bytes.byteLength) {
+        const { bytesWritten } = await handle.write(bytes, offset, bytes.byteLength - offset);
+        if (bytesWritten <= 0)
+            throw new Error("short write: no bytes written");
+        offset += bytesWritten;
+    }
+}
+//# sourceMappingURL=durable-file.js.map

package/dist/harness/store/durable-file.js.map

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

package/dist/harness/store/event-store.d.ts

@@ -0,0 +1,56 @@
+import { type EventReadItem, type EventStore, type QuarantinedTail, type ReadOnlyEventStore, type SessionEvent, type SessionEventDraft, type SessionId, type SessionManifest } from "../contracts/index.ts";
+import type { SessionLeaseHandle } from "./lease.ts";
+import { type ScanItem } from "./segments.ts";
+/** The JSONL implementation of `EventStore`, plus what `openForWrite` quarantined. */
+export interface SegmentedEventStore extends EventStore {
+    readonly manifest: SessionManifest;
+    readonly quarantinedTail: QuarantinedTail | undefined;
+    /** Runs one lease heartbeat now; the timer does the same every `LEASE_HEARTBEAT_MS`. */
+    heartbeat(): Promise<void>;
+}
+export interface SessionLocation {
+    readonly directory: string;
+    readonly manifest: SessionManifest;
+}
+export type LocateSession = (sessionId: SessionId) => Promise<SessionLocation>;
+export interface WriterSettings {
+    readonly clock: () => Date;
+    readonly writerVersion: string;
+    readonly segmentMaxBytes: number;
+}
+export interface WriterPosition {
+    readonly lastSeq: number;
+    readonly segment: number;
+    readonly segmentBytes: number;
+    readonly segmentEvents: number;
+}
+/** First seq a session's own segments start at: 1, or right after the fork point. */
+export declare function firstOwnSeq(manifest: SessionManifest): number;
+/**
+ * Reads a session including its fork ancestry: ancestor events up to `parent.up_to_seq` first
+ * (never their torn tails), then the session's own segments.
+ */
+export declare function readSessionItems(location: SessionLocation, locate: LocateSession, fromSeq: number, toSeq: number, reportTornTail: boolean): AsyncGenerator<ScanItem>;
+export declare function toReadItem(item: ScanItem): EventReadItem;
+export declare class JsonlReadOnlyEventStore implements ReadOnlyEventStore {
+    #private;
+    readonly sessionId: SessionId;
+    constructor(location: SessionLocation, locate: LocateSession);
+    read(fromSeq?: number, toSeq?: number): AsyncIterable<EventReadItem>;
+}
+export declare class JsonlEventStore implements SegmentedEventStore {
+    #private;
+    readonly sessionId: SessionId;
+    readonly manifest: SessionManifest;
+    readonly quarantinedTail: QuarantinedTail | undefined;
+    private constructor();
+    /** Opens the append handle at a validated position; creates segment 1 when the session has none yet. */
+    static open(location: SessionLocation, locate: LocateSession, lease: SessionLeaseHandle, settings: WriterSettings, position: WriterPosition | undefined, quarantined: QuarantinedTail | undefined): Promise<JsonlEventStore>;
+    get lastSeq(): number;
+    append(draft: SessionEventDraft): Promise<SessionEvent>;
+    /** Reads what this writer has durably appended; the in-flight line (if any) is never visible. */
+    read(fromSeq?: number, toSeq?: number): AsyncIterable<EventReadItem>;
+    close(): Promise<void>;
+    heartbeat(): Promise<void>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/harness/store/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../../src/harness/store/event-store.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAkD,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9F,sFAAsF;AACtF,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,wFAAwF;IACxF,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAuB,gBAAgB,CACrC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,OAAO,GACtB,cAAc,CAAC,QAAQ,CAAC,CAe1B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,CAExD;AAED,qBAAa,uBAAwB,YAAW,kBAAkB;;IAChE,SAAgB,SAAS,EAAE,SAAS,CAAC;gBAIlB,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa;IAMrD,IAAI,CAAC,OAAO,SAAI,EAAE,KAAK,SAA2B,GAAG,aAAa,CAAC,aAAa,CAAC;CAKhG;AAID,qBAAa,eAAgB,YAAW,mBAAmB;;IACzD,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAC1C,SAAgB,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAc7D,OAAO;IAuBP,wGAAwG;WACpF,IAAI,CACtB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,WAAW,EAAE,eAAe,GAAG,SAAS,GACvC,OAAO,CAAC,eAAe,CAAC;IAe3B,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEM,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9D,iGAAiG;IACnF,IAAI,CAAC,OAAO,SAAI,EAAE,KAAK,SAA2B,GAAG,aAAa,CAAC,aAAa,CAAC;IAQxF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CA+DlC"}

package/dist/harness/store/event-store.js

@@ -0,0 +1,210 @@
+import { open } from "node:fs/promises";
+import { createId, HARNESS_SCHEMA_VERSION, parseSessionEvent, StoreFailure, } from "../contracts/index.js";
+import { errnoCode, PRIVATE_FILE_MODE, syncDirectory, writeAll } from "./durable-file.js";
+import { segmentPath, segmentsDirectory } from "./layout.js";
+import { encodeLine, MAX_EVENT_LINE_BYTES, scanSegments } from "./segments.js";
+/** First seq a session's own segments start at: 1, or right after the fork point. */
+export function firstOwnSeq(manifest) {
+    return manifest.parent === undefined ? 1 : manifest.parent.up_to_seq + 1;
+}
+/**
+ * Reads a session including its fork ancestry: ancestor events up to `parent.up_to_seq` first
+ * (never their torn tails), then the session's own segments.
+ */
+export async function* readSessionItems(location, locate, fromSeq, toSeq, reportTornTail) {
+    const { manifest } = location;
+    if (manifest.parent !== undefined && fromSeq <= manifest.parent.up_to_seq) {
+        const parent = await locate(manifest.parent.session_id);
+        yield* readSessionItems(parent, locate, fromSeq, Math.min(toSeq, manifest.parent.up_to_seq), false);
+    }
+    const firstSeq = firstOwnSeq(manifest);
+    if (toSeq < firstSeq)
+        return;
+    yield* scanSegments(segmentsDirectory(location.directory), {
+        sessionId: manifest.session_id,
+        firstSeq,
+        fromSeq: Math.max(fromSeq, firstSeq),
+        toSeq,
+        reportTornTail,
+    });
+}
+export function toReadItem(item) {
+    return item.kind === "event" ? item.result : { status: "torn-tail", segment: item.segment, bytes: item.bytes };
+}
+export class JsonlReadOnlyEventStore {
+    sessionId;
+    #location;
+    #locate;
+    constructor(location, locate) {
+        this.sessionId = location.manifest.session_id;
+        this.#location = location;
+        this.#locate = locate;
+    }
+    async *read(fromSeq = 1, toSeq = Number.POSITIVE_INFINITY) {
+        for await (const item of readSessionItems(this.#location, this.#locate, fromSeq, toSeq, true)) {
+            yield toReadItem(item);
+        }
+    }
+}
+export class JsonlEventStore {
+    sessionId;
+    manifest;
+    quarantinedTail;
+    #location;
+    #locate;
+    #lease;
+    #settings;
+    #handle;
+    #lastSeq;
+    #segment;
+    #segmentBytes;
+    #segmentEvents;
+    #queue = Promise.resolve();
+    #closed = false;
+    #failure;
+    constructor(location, locate, lease, settings, handle, position, quarantined) {
+        this.sessionId = location.manifest.session_id;
+        this.manifest = location.manifest;
+        this.quarantinedTail = quarantined;
+        this.#location = location;
+        this.#locate = locate;
+        this.#lease = lease;
+        this.#settings = settings;
+        this.#handle = handle;
+        this.#lastSeq = position.lastSeq;
+        this.#segment = position.segment;
+        this.#segmentBytes = position.segmentBytes;
+        this.#segmentEvents = position.segmentEvents;
+    }
+    /** Opens the append handle at a validated position; creates segment 1 when the session has none yet. */
+    static async open(location, locate, lease, settings, position, quarantined) {
+        if (position === undefined) {
+            const first = firstOwnSeq(location.manifest);
+            const created = await createSegment(location, settings, 1, first);
+            return new JsonlEventStore(location, locate, lease, settings, created.handle, {
+                lastSeq: first - 1,
+                segment: 1,
+                segmentBytes: created.bytes,
+                segmentEvents: 0,
+            }, quarantined);
+        }
+        const handle = await open(segmentPath(location.directory, position.segment), "a");
+        return new JsonlEventStore(location, locate, lease, settings, handle, position, quarantined);
+    }
+    get lastSeq() {
+        return this.#lastSeq;
+    }
+    append(draft) {
+        return this.#serialize(() => this.#appendNow(draft));
+    }
+    /** Reads what this writer has durably appended; the in-flight line (if any) is never visible. */
+    async *read(fromSeq = 1, toSeq = Number.POSITIVE_INFINITY) {
+        const limit = Math.min(toSeq, this.#lastSeq);
+        if (limit < fromSeq)
+            return;
+        for await (const item of readSessionItems(this.#location, this.#locate, fromSeq, limit, false)) {
+            yield toReadItem(item);
+        }
+    }
+    close() {
+        return this.#serialize(async () => {
+            if (this.#closed)
+                return;
+            this.#closed = true;
+            try {
+                await this.#handle.close();
+            }
+            finally {
+                await this.#lease.release();
+            }
+        });
+    }
+    heartbeat() {
+        return this.#lease.renew();
+    }
+    #serialize(task) {
+        const run = this.#queue.then(task, task);
+        this.#queue = run.catch(() => undefined);
+        return run;
+    }
+    async #appendNow(draft) {
+        if (this.#closed)
+            throw new StoreFailure("write_failed", `session ${this.sessionId} is closed`);
+        if (this.#failure !== undefined)
+            throw new StoreFailure("write_failed", `session ${this.sessionId} stopped accepting writes: ${this.#failure}`);
+        try {
+            await this.#lease.verify();
+        }
+        catch (error) {
+            this.#failure = error instanceof Error ? error.message : String(error);
+            throw error;
+        }
+        const seq = this.#lastSeq + 1;
+        const now = this.#settings.clock();
+        const identity = {
+            schema_version: HARNESS_SCHEMA_VERSION,
+            event_id: createId("event", now.getTime()),
+            session_id: this.sessionId,
+            seq,
+            timestamp: now.toISOString(),
+        };
+        const candidate = { ...identity, ...draft, ...identity };
+        const parsed = parseSessionEvent(candidate);
+        if (parsed.status !== "ok") {
+            const detail = parsed.status === "invalid" ? parsed.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ") : `unsupported ${parsed.type} v${parsed.event_version ?? "?"}`;
+            throw new StoreFailure("write_failed", `event ${draft.type} rejected: ${detail}`);
+        }
+        const line = encodeLine(parsed.event);
+        if (line.byteLength > MAX_EVENT_LINE_BYTES) {
+            throw new StoreFailure("write_failed", `event ${draft.type} is ${line.byteLength} bytes; store large payloads as blobs`);
+        }
+        try {
+            if (this.#segmentEvents > 0 && this.#segmentBytes + line.byteLength > this.#settings.segmentMaxBytes) {
+                await this.#rotate(seq);
+            }
+            await writeAll(this.#handle, line);
+            await this.#handle.datasync();
+        }
+        catch (error) {
+            this.#failure = `append of seq ${seq} failed: ${errnoCode(error) ?? (error instanceof Error ? error.message : String(error))}`;
+            throw new StoreFailure("write_failed", this.#failure);
+        }
+        this.#segmentBytes += line.byteLength;
+        this.#segmentEvents += 1;
+        this.#lastSeq = seq;
+        return parsed.event;
+    }
+    async #rotate(firstSeq) {
+        const next = this.#segment + 1;
+        const created = await createSegment(this.#location, this.#settings, next, firstSeq);
+        await this.#handle.close();
+        this.#handle = created.handle;
+        this.#segment = next;
+        this.#segmentBytes = created.bytes;
+        this.#segmentEvents = 0;
+    }
+}
+async function createSegment(location, settings, segment, firstSeq) {
+    const header = {
+        kind: "segment",
+        schema_version: 1,
+        session_id: location.manifest.session_id,
+        segment,
+        first_seq: firstSeq,
+        created_at: settings.clock().toISOString(),
+        writer: { name: "synorch", version: settings.writerVersion },
+    };
+    const line = encodeLine(header);
+    const handle = await open(segmentPath(location.directory, segment), "wx", PRIVATE_FILE_MODE);
+    try {
+        await writeAll(handle, line);
+        await handle.datasync();
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+    await syncDirectory(segmentsDirectory(location.directory));
+    return { handle, bytes: line.byteLength };
+}
+//# sourceMappingURL=event-store.js.map

package/dist/harness/store/event-store.js.map

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

package/dist/harness/store/index.d.ts

@@ -0,0 +1,8 @@
+/** I1 — segmented JSONL session store, lease, content-addressed blobs. */
+export type { BlobStore, EventStore, ReadOnlyEventStore, SessionStore, SessionSummary } from "../contracts/index.ts";
+export { createBlobStore } from "./blob-store.ts";
+export type { QuarantinedTail } from "../contracts/index.ts";
+export type { SegmentedEventStore } from "./event-store.ts";
+export { MAX_EVENT_LINE_BYTES } from "./segments.ts";
+export { createSessionStore, type SessionStoreOptions } from "./session-store.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/store/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/harness/store/index.js

@@ -0,0 +1,4 @@
+export { createBlobStore } from "./blob-store.js";
+export { MAX_EVENT_LINE_BYTES } from "./segments.js";
+export { createSessionStore } from "./session-store.js";
+//# sourceMappingURL=index.js.map

package/dist/harness/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/store/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAA4B,MAAM,oBAAoB,CAAC"}

package/dist/harness/store/layout.d.ts

@@ -0,0 +1,12 @@
+import type { Digest } from "../contracts/index.ts";
+export declare const MANIFEST_FILE = "session.json";
+export declare const LOCK_FILE = "lock.json";
+export declare const SEGMENTS_DIRECTORY = "segments";
+export declare function sessionsRoot(home: string): string;
+export declare function projectDirectory(home: string, projectId: string): string;
+export declare function sessionDirectory(home: string, projectId: string, sessionId: string): string;
+export declare function segmentsDirectory(sessionDir: string): string;
+export declare function segmentFileName(segment: number): string;
+export declare function segmentPath(sessionDir: string, segment: number): string;
+export declare function blobPath(home: string, digest: Digest): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/harness/store/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/harness/store/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAC5C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/harness/store/layout.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+export const MANIFEST_FILE = "session.json";
+export const LOCK_FILE = "lock.json";
+export const SEGMENTS_DIRECTORY = "segments";
+export function sessionsRoot(home) {
+    return path.join(home, "sessions");
+}
+export function projectDirectory(home, projectId) {
+    return path.join(sessionsRoot(home), projectId);
+}
+export function sessionDirectory(home, projectId, sessionId) {
+    return path.join(projectDirectory(home, projectId), sessionId);
+}
+export function segmentsDirectory(sessionDir) {
+    return path.join(sessionDir, SEGMENTS_DIRECTORY);
+}
+export function segmentFileName(segment) {
+    return `${String(segment).padStart(6, "0")}.jsonl`;
+}
+export function segmentPath(sessionDir, segment) {
+    return path.join(segmentsDirectory(sessionDir), segmentFileName(segment));
+}
+export function blobPath(home, digest) {
+    const hex = digest.slice("sha256:".length);
+    return path.join(home, "blobs", "sha256", hex.slice(0, 2), hex.slice(2));
+}
+//# sourceMappingURL=layout.js.map

package/dist/harness/store/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/harness/store/layout.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB;IACjF,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAe;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAc;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/harness/store/lease.d.ts

@@ -0,0 +1,37 @@
+import { type SessionId, type SessionLease } from "../contracts/index.ts";
+export interface LeaseSettings {
+    readonly clock: () => Date;
+    readonly pid: number;
+    readonly host: string;
+    readonly ttlMs: number;
+    readonly heartbeatMs: number;
+    /** Test seam: awaited inside a renewal after the token was verified, where a suspended process would stall. */
+    readonly checkpoint?: (point: "renew-verified") => Promise<void>;
+}
+export type LeaseInspection = {
+    readonly state: "absent";
+} | {
+    readonly state: "live";
+    readonly lease: SessionLease | undefined;
+} | {
+    readonly state: "stale";
+    readonly lease: SessionLease | undefined;
+    readonly reason: string;
+};
+/** The single writer's hold on `lock.json`: created with O_EXCL, renewed by heartbeat, bound to a random token. */
+export declare class SessionLeaseHandle {
+    #private;
+    private constructor();
+    get lease(): SessionLease;
+    get lostReason(): string | undefined;
+    /** Acquires the lease, taking over one that expired or whose holder process is gone. */
+    static acquire(file: string, sessionId: SessionId, settings: LeaseSettings): Promise<SessionLeaseHandle>;
+    /** Confirms `lock.json` still carries this writer's token, renewing when the lease is close to expiry. */
+    verify(): Promise<void>;
+    /** One heartbeat: re-reads the token and extends `expires_at`; a foreign token marks the lease lost. */
+    renew(): Promise<void>;
+    release(): Promise<void>;
+}
+/** Reads `lock.json` and classifies it; used by `openForWrite` and by `list` for the `locked` flag. */
+export declare function inspectLease(file: string, settings: Pick<LeaseSettings, "clock" | "host" | "ttlMs">): Promise<LeaseInspection>;
+//# sourceMappingURL=lease.d.ts.map

package/dist/harness/store/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../src/harness/store/lease.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AA8DD,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,mHAAmH;AACnH,qBAAa,kBAAkB;;IAQ7B,OAAO;IAMP,IAAW,KAAK,IAAI,YAAY,CAE/B;IAED,IAAW,UAAU,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,wFAAwF;WACpE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBrH,0GAA0G;IAC7F,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC,wGAAwG;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgFtC;AAED,uGAAuG;AACvG,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAapI"}