clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/dist/dashboard/session-log-journal.d.ts

@@ -0,0 +1,43 @@
+import { type SessionLogAvailabilityV1, type SessionLogEventV1, type SessionLogOwnerV1 } from "./session-log-contract.js";
+export interface SessionLogJournalOptions {
+    readonly rootDir: string;
+    readonly owner: SessionLogOwnerV1;
+    readonly now?: (() => Date) | undefined;
+    readonly maxEventBytes?: number | undefined;
+    readonly maxJournalBytes?: number | undefined;
+    readonly maxEvents?: number | undefined;
+    readonly writeAdapter?: (filePath: string, record: Uint8Array) => Promise<void>;
+}
+export interface SessionLogAppendInput {
+    readonly owner: SessionLogOwnerV1;
+    readonly event: unknown;
+    readonly truncation: SessionLogEventV1["truncation"];
+    readonly completeness: SessionLogEventV1["completeness"];
+    readonly parseWarnings: SessionLogEventV1["parseWarnings"];
+}
+export type SessionLogAppendResult = Readonly<{
+    retained: true;
+    sequence: number;
+    availability: Extract<SessionLogAvailabilityV1, {
+        availability: "available";
+    }>;
+    event: SessionLogEventV1;
+    bytes: number;
+}> | Readonly<{
+    retained: false;
+    availability: Readonly<{
+        availability: "pruned";
+        reason: "size_limit" | "event_limit";
+    }>;
+}>;
+export interface SessionLogJournal {
+    append(input: SessionLogAppendInput): Promise<SessionLogAppendResult>;
+}
+/**
+ * Binds one journal to one leaf owner and its derived lane/generation.
+ * Recovery treats newline-terminated records as durable, truncates one
+ * unterminated tail, rejects malformed terminated records, and resumes at one
+ * greater than the highest durable sequence. Non-retained outcomes do not own
+ * or advance authoritative event sequences.
+ */
+export declare function createSessionLogJournal(options: SessionLogJournalOptions): Promise<SessionLogJournal>;

package/clinkx-workflows/dist/dashboard/session-log-journal.js

@@ -0,0 +1,529 @@
+import { createHash } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { lstat, mkdir, open } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { SESSION_LOG_V1_SCHEMA_VERSION, parseSessionLogEventV1, } from "./session-log-contract.js";
+import { prepareSessionLogEventV1 } from "./session-log-redaction.js";
+const DEFAULT_MAX_EVENT_BYTES = 256 * 1_024;
+const DEFAULT_MAX_JOURNAL_BYTES = 64 * 1_024 * 1_024;
+const DEFAULT_MAX_EVENTS = 100_000;
+/**
+ * Binds one journal to one leaf owner and its derived lane/generation.
+ * Recovery treats newline-terminated records as durable, truncates one
+ * unterminated tail, rejects malformed terminated records, and resumes at one
+ * greater than the highest durable sequence. Non-retained outcomes do not own
+ * or advance authoritative event sequences.
+ */
+export async function createSessionLogJournal(options) {
+    const admittedOptions = admitJournalOptions(options);
+    const pathSegments = admittedOptions.rootDir.split(/[\\/]+/);
+    if (!isAbsolute(admittedOptions.rootDir) ||
+        pathSegments.includes(".") ||
+        pathSegments.includes("..")) {
+        throw new TypeError("session-log-v1 journal root is invalid");
+    }
+    const binding = parseOwnerBinding(admittedOptions.owner);
+    const maxEventBytes = positiveBound(admittedOptions.maxEventBytes, DEFAULT_MAX_EVENT_BYTES, "maxEventBytes");
+    const maxJournalBytes = positiveBound(admittedOptions.maxJournalBytes, DEFAULT_MAX_JOURNAL_BYTES, "maxJournalBytes");
+    const maxEvents = positiveBound(admittedOptions.maxEvents, DEFAULT_MAX_EVENTS, "maxEvents");
+    const generation = ownerGeneration(binding.owner);
+    const digest = createHash("sha256")
+        .update(JSON.stringify(binding.owner), "utf8")
+        .digest("hex")
+        .slice(0, 32);
+    const journalDir = join(admittedOptions.rootDir, binding.owner.family, generation);
+    const journalPath = join(journalDir, `${digest}.jsonl`);
+    let recovery;
+    try {
+        await ensurePrivateDirectory(admittedOptions.rootDir, true);
+        await ensurePrivateDirectory(join(admittedOptions.rootDir, binding.owner.family), false);
+        await ensurePrivateDirectory(journalDir, false);
+        recovery = await recoverJournal(journalPath, JSON.stringify(binding.owner), JSON.stringify(binding.lane), maxEventBytes, maxJournalBytes);
+    }
+    catch (error) {
+        if (error instanceof JournalSafetyError)
+            throw error;
+        throw new Error("session-log-v1 journal initialization failed");
+    }
+    const now = admittedOptions.now ?? (() => new Date());
+    let expectedFileIdentity = recovery.fileIdentity;
+    const writeRecord = admittedOptions.writeAdapter ??
+        (async (filePath, record) => {
+            expectedFileIdentity = await appendRecordDurably(filePath, record, expectedFileIdentity);
+        });
+    const ownerJson = JSON.stringify(binding.owner);
+    let nextDurableSequence = recovery.nextSequence;
+    let journalBytes = recovery.bytes;
+    let eventCount = recovery.eventCount;
+    let capReason = recovery.capReason;
+    let writeChain = Promise.resolve();
+    let poisoned = false;
+    return Object.freeze({
+        append(input) {
+            const admittedInput = admitAppendInput(input);
+            let appendOwnerJson;
+            try {
+                appendOwnerJson = JSON.stringify(parseOwnerBinding(admittedInput.owner).owner);
+            }
+            catch {
+                throw new TypeError("session-log-v1 journal owner mismatch");
+            }
+            if (appendOwnerJson !== ownerJson) {
+                throw new TypeError("session-log-v1 journal owner mismatch");
+            }
+            let prepared;
+            try {
+                prepared = prepareSessionLogEventV1(admittedInput.event);
+            }
+            catch {
+                throw new TypeError("session-log-v1 journal event rejected");
+            }
+            const task = async () => {
+                if (poisoned) {
+                    throw new Error("session-log-v1 journal append failed");
+                }
+                if (capReason !== null)
+                    return prunedResult(capReason);
+                const sequence = nextDurableSequence;
+                const timestamp = now().toISOString();
+                let event;
+                try {
+                    event = parseSessionLogEventV1({
+                        schemaVersion: SESSION_LOG_V1_SCHEMA_VERSION,
+                        sequence,
+                        timestamp,
+                        producerFamily: binding.owner.family,
+                        owner: binding.owner,
+                        lane: binding.lane,
+                        authority: "observability_only",
+                        redaction: prepared.redaction,
+                        truncation: admittedInput.truncation === "none" && prepared.truncated
+                            ? "tail" : admittedInput.truncation,
+                        completeness: (prepared.truncated || prepared.omitted) &&
+                            (admittedInput.completeness === "complete" || admittedInput.completeness === "unknown")
+                            ? "partial" : admittedInput.completeness,
+                        parseWarnings: [
+                            ...admittedInput.parseWarnings,
+                            ...(prepared.truncated && !admittedInput.parseWarnings.includes("content_truncated") ? ["content_truncated"] : []),
+                            ...(prepared.omitted && !admittedInput.parseWarnings.includes("provider_payload_omitted") ? ["provider_payload_omitted"] : []),
+                        ],
+                        event: prepared.event,
+                    });
+                }
+                catch {
+                    throw new TypeError("session-log-v1 journal event rejected");
+                }
+                const record = Buffer.from(`${JSON.stringify(event)}\n`, "utf8");
+                const eventLimitReached = eventCount + 1 >= maxEvents;
+                const nextSentinel = capSentinelRecord(binding.owner, binding.lane, sequence + 1, timestamp, 
+                // The event-limit marker is one byte larger, so reserving it also
+                // reserves enough journal capacity for the size-limit variant.
+                "event_limit");
+                const sizeLimitReached = record.byteLength > maxEventBytes ||
+                    journalBytes + record.byteLength + nextSentinel.byteLength > maxJournalBytes;
+                if (eventLimitReached || sizeLimitReached) {
+                    const reason = eventLimitReached ? "event_limit" : "size_limit";
+                    const sentinel = capSentinelRecord(binding.owner, binding.lane, sequence, timestamp, reason);
+                    if (journalBytes + sentinel.byteLength > maxJournalBytes) {
+                        poisoned = true;
+                        throw new Error("session-log-v1 journal cannot retain its cap marker");
+                    }
+                    try {
+                        await writeRecord(journalPath, sentinel);
+                    }
+                    catch {
+                        poisoned = true;
+                        throw new Error("session-log-v1 journal append failed");
+                    }
+                    nextDurableSequence = sequence + 1;
+                    journalBytes += sentinel.byteLength;
+                    eventCount += 1;
+                    capReason = reason;
+                    return prunedResult(reason);
+                }
+                try {
+                    await writeRecord(journalPath, record);
+                }
+                catch {
+                    poisoned = true;
+                    throw new Error("session-log-v1 journal append failed");
+                }
+                nextDurableSequence = sequence + 1;
+                journalBytes += record.byteLength;
+                eventCount += 1;
+                return Object.freeze({
+                    retained: true,
+                    sequence,
+                    availability: Object.freeze({ availability: "available" }),
+                    event,
+                    bytes: record.byteLength,
+                });
+            };
+            const result = writeChain.then(task, task);
+            writeChain = result.then(() => undefined, () => undefined);
+            return result;
+        },
+    });
+}
+class JournalSafetyError extends Error {
+}
+function admitJournalOptions(options) {
+    const values = exactDataProperties(options, ["rootDir", "owner"], [
+        "rootDir",
+        "owner",
+        "now",
+        "maxEventBytes",
+        "maxJournalBytes",
+        "maxEvents",
+        "writeAdapter",
+    ]);
+    if (typeof values.rootDir !== "string" ||
+        values.owner === null ||
+        typeof values.owner !== "object" ||
+        (values.now !== undefined && typeof values.now !== "function") ||
+        (values.writeAdapter !== undefined && typeof values.writeAdapter !== "function")) {
+        throw new TypeError("session-log-v1 journal options are invalid");
+    }
+    return values;
+}
+function admitAppendInput(input) {
+    try {
+        const values = exactDataProperties(input, ["owner", "event", "truncation", "completeness", "parseWarnings"], ["owner", "event", "truncation", "completeness", "parseWarnings"]);
+        return values;
+    }
+    catch {
+        throw new TypeError("session-log-v1 journal owner mismatch");
+    }
+}
+function exactDataProperties(input, required, allowed) {
+    try {
+        if (input === null || typeof input !== "object")
+            throw new Error();
+        const prototype = Object.getPrototypeOf(input);
+        if (prototype !== Object.prototype && prototype !== null)
+            throw new Error();
+        const keys = Reflect.ownKeys(input);
+        if (keys.some((key) => typeof key !== "string" || !allowed.includes(key))) {
+            throw new Error();
+        }
+        if (required.some((key) => !keys.includes(key)))
+            throw new Error();
+        const values = {};
+        for (const key of keys) {
+            const descriptor = Object.getOwnPropertyDescriptor(input, key);
+            if (descriptor === undefined ||
+                !("value" in descriptor) ||
+                !descriptor.enumerable) {
+                throw new Error();
+            }
+            values[key] = descriptor.value;
+        }
+        return values;
+    }
+    catch {
+        throw new TypeError("session-log-v1 journal options are invalid");
+    }
+}
+function positiveBound(value, fallback, label) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new TypeError(`session-log-v1 journal ${label} is invalid`);
+    }
+    return Math.min(value, fallback);
+}
+function prunedResult(reason) {
+    return Object.freeze({
+        retained: false,
+        availability: Object.freeze({ availability: "pruned", reason }),
+    });
+}
+function capSentinelRecord(owner, lane, sequence, timestamp, reason) {
+    const event = parseSessionLogEventV1({
+        schemaVersion: SESSION_LOG_V1_SCHEMA_VERSION,
+        sequence,
+        timestamp,
+        producerFamily: owner.family,
+        owner,
+        lane,
+        authority: "observability_only",
+        redaction: { ran: true, status: "no_matches", count: 0 },
+        truncation: "tail",
+        completeness: "partial",
+        parseWarnings: ["content_truncated"],
+        event: {
+            kind: "unknown",
+            originalKind: reason === "event_limit"
+                ? "capture_event_limit_reached"
+                : "capture_size_limit_reached",
+            summary: "Session log capture stopped before tail completion",
+            forwardCaptured: true,
+        },
+    });
+    return Buffer.from(`${JSON.stringify(event)}\n`, "utf8");
+}
+function capReasonFromEvent(event) {
+    if (event.event.kind !== "unknown" ||
+        (event.event.originalKind !== "capture_event_limit_reached" &&
+            event.event.originalKind !== "capture_size_limit_reached"))
+        return null;
+    return event.event.originalKind === "capture_event_limit_reached"
+        ? "event_limit"
+        : "size_limit";
+}
+async function ensurePrivateDirectory(path, recursive) {
+    try {
+        const existing = await lstat(path);
+        if (existing.isSymbolicLink() || !existing.isDirectory()) {
+            throw new JournalSafetyError("session-log-v1 journal path is not a private directory");
+        }
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        try {
+            await mkdir(path, { recursive, mode: 0o700 });
+        }
+        catch (mkdirError) {
+            if (mkdirError.code !== "EEXIST") {
+                throw mkdirError;
+            }
+        }
+    }
+    let handle;
+    try {
+        handle = await open(path, fsConstants.O_RDONLY |
+            (fsConstants.O_NOFOLLOW ?? 0) |
+            (fsConstants.O_DIRECTORY ?? 0));
+    }
+    catch {
+        throw new JournalSafetyError("session-log-v1 journal path is not a private directory");
+    }
+    try {
+        const opened = await handle.stat();
+        const linked = await lstat(path);
+        if (!opened.isDirectory() ||
+            linked.isSymbolicLink() ||
+            !linked.isDirectory() ||
+            opened.dev !== linked.dev ||
+            opened.ino !== linked.ino) {
+            throw new JournalSafetyError("session-log-v1 journal path is not a private directory");
+        }
+        await handle.chmod(0o700);
+        const linkedAfter = await lstat(path);
+        if (linkedAfter.isSymbolicLink() ||
+            !linkedAfter.isDirectory() ||
+            opened.dev !== linkedAfter.dev ||
+            opened.ino !== linkedAfter.ino) {
+            throw new JournalSafetyError("session-log-v1 journal path is not a private directory");
+        }
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function recoverJournal(journalPath, ownerJson, laneJson, maxEventBytes, maxJournalBytes) {
+    let handle;
+    try {
+        handle = await open(journalPath, fsConstants.O_RDWR | (fsConstants.O_NOFOLLOW ?? 0));
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { nextSequence: 0, bytes: 0, eventCount: 0, fileIdentity: null, capReason: null };
+        }
+        throw new JournalSafetyError("session-log-v1 journal cannot be opened safely");
+    }
+    try {
+        const before = await handle.stat();
+        const linkedBefore = await lstat(journalPath);
+        if (!before.isFile() ||
+            linkedBefore.isSymbolicLink() ||
+            !linkedBefore.isFile() ||
+            before.dev !== linkedBefore.dev ||
+            before.ino !== linkedBefore.ino ||
+            before.size > maxJournalBytes) {
+            throw new JournalSafetyError("session-log-v1 journal recovery bounds exceeded");
+        }
+        await handle.chmod(0o600);
+        const fileIdentity = Object.freeze({ dev: before.dev, ino: before.ino });
+        const bytes = Buffer.alloc(before.size);
+        let offset = 0;
+        while (offset < bytes.byteLength) {
+            const read = await handle.read(bytes, offset, bytes.byteLength - offset, offset);
+            if (read.bytesRead === 0) {
+                throw new JournalSafetyError("session-log-v1 journal changed during recovery");
+            }
+            offset += read.bytesRead;
+        }
+        const after = await handle.stat();
+        const linkedAfter = await lstat(journalPath);
+        if (after.dev !== before.dev ||
+            after.ino !== before.ino ||
+            after.size !== before.size ||
+            linkedAfter.isSymbolicLink() ||
+            !linkedAfter.isFile() ||
+            after.dev !== linkedAfter.dev ||
+            after.ino !== linkedAfter.ino) {
+            throw new JournalSafetyError("session-log-v1 journal changed during recovery");
+        }
+        if (bytes.byteLength === 0) {
+            return { nextSequence: 0, bytes: 0, eventCount: 0, fileIdentity, capReason: null };
+        }
+        const lastNewline = bytes.lastIndexOf(0x0a);
+        const durableBytes = lastNewline + 1;
+        if (durableBytes !== bytes.byteLength) {
+            await handle.truncate(durableBytes);
+            await handle.sync();
+            await handle.chmod(0o600);
+        }
+        if (durableBytes === 0) {
+            return { nextSequence: 0, bytes: 0, eventCount: 0, fileIdentity, capReason: null };
+        }
+        const lines = new TextDecoder("utf-8", { fatal: true })
+            .decode(bytes.subarray(0, durableBytes))
+            .slice(0, -1)
+            .split("\n");
+        let previous = -1;
+        let recoveredCapReason = null;
+        for (const line of lines) {
+            let event;
+            try {
+                event = parseSessionLogEventV1(JSON.parse(line));
+            }
+            catch {
+                throw new JournalSafetyError("session-log-v1 journal contains a malformed record");
+            }
+            const eventCapReason = capReasonFromEvent(event);
+            if (Buffer.byteLength(line, "utf8") + 1 > maxEventBytes &&
+                eventCapReason === null) {
+                throw new JournalSafetyError("session-log-v1 journal event bound exceeded");
+            }
+            if (eventCapReason !== null) {
+                if (recoveredCapReason !== null || line !== lines.at(-1)) {
+                    throw new JournalSafetyError("session-log-v1 journal cap marker is invalid");
+                }
+                recoveredCapReason = eventCapReason;
+            }
+            if (JSON.stringify(event.owner) !== ownerJson ||
+                JSON.stringify(event.lane) !== laneJson ||
+                event.sequence <= previous) {
+                throw new JournalSafetyError("session-log-v1 journal binding or sequence mismatch");
+            }
+            previous = event.sequence;
+        }
+        return {
+            nextSequence: previous + 1,
+            bytes: durableBytes,
+            eventCount: lines.length,
+            fileIdentity,
+            capReason: recoveredCapReason,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function appendRecordDurably(journalPath, record, expectedIdentity) {
+    let existingIdentity = null;
+    try {
+        const existing = await lstat(journalPath);
+        if (existing.isSymbolicLink() || !existing.isFile()) {
+            throw new Error("unsafe journal file");
+        }
+        existingIdentity = { dev: existing.dev, ino: existing.ino };
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    if ((expectedIdentity === null && existingIdentity !== null) ||
+        (expectedIdentity !== null && (existingIdentity === null ||
+            expectedIdentity.dev !== existingIdentity.dev ||
+            expectedIdentity.ino !== existingIdentity.ino))) {
+        throw new Error("unsafe journal file");
+    }
+    const flags = fsConstants.O_WRONLY |
+        fsConstants.O_APPEND |
+        (fsConstants.O_NOFOLLOW ?? 0) |
+        (expectedIdentity === null
+            ? fsConstants.O_CREAT | fsConstants.O_EXCL
+            : 0);
+    const handle = await open(journalPath, flags, 0o600);
+    try {
+        const opened = await handle.stat();
+        const linked = await lstat(journalPath);
+        if (!opened.isFile() ||
+            linked.isSymbolicLink() ||
+            !linked.isFile() ||
+            opened.dev !== linked.dev ||
+            opened.ino !== linked.ino ||
+            (expectedIdentity !== null && (opened.dev !== expectedIdentity.dev ||
+                opened.ino !== expectedIdentity.ino))) {
+            throw new Error("unsafe journal file");
+        }
+        await handle.chmod(0o600);
+        let offset = 0;
+        while (offset < record.byteLength) {
+            const written = await handle.write(record, offset, record.byteLength - offset, null);
+            if (written.bytesWritten === 0)
+                throw new Error("journal write made no progress");
+            offset += written.bytesWritten;
+        }
+        await handle.sync();
+        const current = await lstat(journalPath);
+        if (current.isSymbolicLink() ||
+            !current.isFile() ||
+            opened.dev !== current.dev ||
+            opened.ino !== current.ino) {
+            throw new Error("unsafe journal file");
+        }
+        return Object.freeze({ dev: opened.dev, ino: opened.ino });
+    }
+    finally {
+        await handle.close();
+    }
+}
+function parseOwnerBinding(owner) {
+    try {
+        const laneId = owner.family === "workflow"
+            ? owner.attempt === undefined ? undefined : `attempt:${owner.attempt}`
+            : owner.family === "activity"
+                ? owner.turnId === undefined ? undefined : `turn:${owner.turnId}`
+                : owner.executionId === undefined || owner.attempt === undefined
+                    ? undefined
+                    : `execution:${owner.executionId}:${owner.attempt}`;
+        if (laneId === undefined)
+            throw new MissingLeafIdentityError();
+        const event = parseSessionLogEventV1({
+            schemaVersion: SESSION_LOG_V1_SCHEMA_VERSION,
+            sequence: 0,
+            timestamp: "2000-01-01T00:00:00.000Z",
+            producerFamily: owner.family,
+            owner,
+            lane: { laneId },
+            authority: "observability_only",
+            redaction: { ran: true, status: "no_matches", count: 0 },
+            truncation: "none",
+            completeness: "complete",
+            parseWarnings: [],
+            event: { kind: "lifecycle", state: "pending" },
+        });
+        return Object.freeze({ owner: event.owner, lane: event.lane });
+    }
+    catch (error) {
+        if (error instanceof MissingLeafIdentityError) {
+            throw new TypeError("session-log-v1 journal owner requires leaf identity");
+        }
+        throw new TypeError("invalid session-log-v1 journal owner");
+    }
+}
+class MissingLeafIdentityError extends Error {
+}
+function ownerGeneration(owner) {
+    switch (owner.family) {
+        case "workflow": return owner.runGeneration;
+        case "activity": return owner.activityGeneration;
+        case "context": return owner.contextGeneration;
+    }
+}
+//# sourceMappingURL=session-log-journal.js.map

package/clinkx-workflows/dist/dashboard/session-log-journal.js.map

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

package/clinkx-workflows/dist/dashboard/session-log-reader.d.ts

@@ -0,0 +1,61 @@
+import { type SessionLogEventV1, type SessionLogOwnerV1, type SessionLogPageV1 } from "./session-log-contract.js";
+export type SessionLogScopeV1 = Readonly<{
+    family: "workflow";
+    runId: string;
+    runGeneration: string;
+    stageId: string;
+    callId: string;
+}> | Readonly<{
+    family: "activity";
+    activityId: string;
+    activityGeneration: string;
+}> | Readonly<{
+    family: "context";
+    contextRunId: string;
+    contextGeneration: string;
+}>;
+export interface SessionLogLaneDescriptorV1 {
+    readonly owner: SessionLogOwnerV1;
+    readonly lane: SessionLogEventV1["lane"];
+    readonly nextSequence: number;
+}
+export type SessionLogLaneReadResult = Readonly<{
+    kind: "available";
+    lanes: readonly SessionLogLaneDescriptorV1[];
+}> | Readonly<{
+    kind: "not_retained";
+}> | Readonly<{
+    kind: "unavailable";
+    reason: "bounds_exceeded" | "malformed_journal" | "source_changed";
+}>;
+export type SessionLogPageReadResult = Readonly<{
+    kind: "available";
+    page: SessionLogPageV1;
+}> | Readonly<{
+    kind: "missing";
+}> | Readonly<{
+    kind: "unavailable";
+    reason: "bounds_exceeded" | "malformed_journal" | "source_changed";
+}>;
+export interface SessionLogReaderOptions {
+    readonly rootDir: string;
+    readonly maxJournalBytes?: number | undefined;
+    readonly maxEventBytes?: number | undefined;
+    readonly maxScanBytes?: number | undefined;
+    readonly maxFiles?: number | undefined;
+    readonly maxEvents?: number | undefined;
+    readonly maxPageEvents?: number | undefined;
+    /** Deterministic race-injection seam; receives only normalized identity. */
+    readonly beforeCommitVerification?: ((identity: Readonly<{
+        family: SessionLogScopeV1["family"];
+        laneId?: string | undefined;
+    }>) => void | Promise<void>) | undefined;
+}
+export interface SessionLogReader {
+    listLanes(scope: SessionLogScopeV1): Promise<SessionLogLaneReadResult>;
+    readPage(scope: SessionLogScopeV1, laneId: string, query: Readonly<{
+        sequence: number;
+        limit: number;
+    }>): Promise<SessionLogPageReadResult>;
+}
+export declare function createSessionLogReader(options: SessionLogReaderOptions): SessionLogReader;