general-agent-runtime 0.0.1

package/dist/session/jsonl-store.js

@@ -0,0 +1,264 @@
+import { access, appendFile, mkdir, open, readdir, readFile, } from "node:fs/promises";
+import path from "node:path";
+import { RuntimeError, normalizeUnknownError } from "../errors/index.js";
+import { deserializeSessionEntry, serializeSessionEntry, } from "./serializer.js";
+function abortIfNeeded(signal) {
+    signal?.throwIfAborted();
+}
+function notFound(sessionId, cause) {
+    return new RuntimeError({
+        code: "SESSION_NOT_FOUND",
+        category: "session",
+        message: `Session not found: ${sessionId}`,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function writeFailed(message, cause) {
+    return new RuntimeError({
+        code: "SESSION_WRITE_FAILED",
+        category: "storage",
+        message,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function readFailed(message, cause) {
+    return new RuntimeError({
+        code: "INTERNAL",
+        category: "session",
+        message,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function isNodeError(error, code) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === code);
+}
+export class JsonlSessionStore {
+    directory;
+    writeTails = new Map();
+    constructor(options) {
+        this.directory =
+            typeof options === "string" ? options : options.directory;
+    }
+    async create(sessionId, initial, signal) {
+        await this.withSessionLock(sessionId, async () => {
+            abortIfNeeded(signal);
+            this.validateSessionId(sessionId);
+            if (initial.sessionId !== sessionId) {
+                throw writeFailed("Initial entry sessionId does not match target session");
+            }
+            if (initial.seq !== 0) {
+                throw writeFailed("Initial session entry seq must be 0");
+            }
+            if (initial.parentId !== undefined) {
+                throw writeFailed("Initial session entry must not have a parentId");
+            }
+            const line = `${serializeSessionEntry(initial)}\n`;
+            try {
+                await mkdir(this.directory, { recursive: true });
+                abortIfNeeded(signal);
+                const handle = await open(this.filePath(sessionId), "wx");
+                try {
+                    await handle.writeFile(line, { encoding: "utf8", signal });
+                }
+                finally {
+                    await handle.close();
+                }
+            }
+            catch (error) {
+                const normalized = normalizeUnknownError(error);
+                if (normalized.code === "ABORTED") {
+                    throw normalized;
+                }
+                throw writeFailed(isNodeError(error, "EEXIST")
+                    ? `Session already exists: ${sessionId}`
+                    : `Failed to create session: ${sessionId}`, error);
+            }
+        });
+    }
+    async append(sessionId, entries, signal) {
+        if (entries.length === 0) {
+            abortIfNeeded(signal);
+            return;
+        }
+        await this.withSessionLock(sessionId, async () => {
+            abortIfNeeded(signal);
+            this.validateSessionId(sessionId);
+            const existing = await this.loadEntries(sessionId, signal);
+            const previous = existing.at(-1);
+            if (!previous) {
+                throw writeFailed(`Cannot append to empty session log: ${sessionId}`);
+            }
+            let expectedSeq = previous.seq + 1;
+            let expectedParent = previous.id;
+            for (const entry of entries) {
+                if (entry.sessionId !== sessionId) {
+                    throw writeFailed(`Entry sessionId does not match target session: ${sessionId}`);
+                }
+                if (entry.seq !== expectedSeq) {
+                    throw writeFailed(`Session seq must be strictly increasing: expected ${expectedSeq}, received ${entry.seq}`);
+                }
+                if (entry.parentId !== expectedParent) {
+                    throw writeFailed(`Session parentId mismatch at seq ${entry.seq}`);
+                }
+                expectedSeq += 1;
+                expectedParent = entry.id;
+            }
+            const content = entries.map((entry) => serializeSessionEntry(entry)).join("\n") + "\n";
+            try {
+                await appendFile(this.filePath(sessionId), content, {
+                    encoding: "utf8",
+                    signal,
+                });
+            }
+            catch (error) {
+                const normalized = normalizeUnknownError(error);
+                if (normalized.code === "ABORTED") {
+                    throw normalized;
+                }
+                if (isNodeError(error, "ENOENT")) {
+                    throw notFound(sessionId, error);
+                }
+                throw writeFailed(`Failed to append session: ${sessionId}`, error);
+            }
+        });
+    }
+    async *read(sessionId, signal) {
+        const entries = await this.loadEntries(sessionId, signal);
+        for (const entry of entries) {
+            abortIfNeeded(signal);
+            yield entry;
+        }
+    }
+    async exists(sessionId, signal) {
+        abortIfNeeded(signal);
+        this.validateSessionId(sessionId);
+        try {
+            await access(this.filePath(sessionId));
+            abortIfNeeded(signal);
+            return true;
+        }
+        catch (error) {
+            const normalized = normalizeUnknownError(error);
+            if (normalized.code === "ABORTED") {
+                throw normalized;
+            }
+            if (isNodeError(error, "ENOENT")) {
+                return false;
+            }
+            throw readFailed(`Failed to check session: ${sessionId}`, error);
+        }
+    }
+    async list(signal) {
+        abortIfNeeded(signal);
+        try {
+            const names = await readdir(this.directory, { encoding: "utf8" });
+            abortIfNeeded(signal);
+            return names
+                .filter((name) => name.endsWith(".jsonl"))
+                .map((name) => name.slice(0, -".jsonl".length))
+                .sort();
+        }
+        catch (error) {
+            const normalized = normalizeUnknownError(error);
+            if (normalized.code === "ABORTED") {
+                throw normalized;
+            }
+            if (isNodeError(error, "ENOENT")) {
+                return [];
+            }
+            throw readFailed("Failed to list sessions", error);
+        }
+    }
+    async loadEntries(sessionId, signal) {
+        abortIfNeeded(signal);
+        this.validateSessionId(sessionId);
+        let text;
+        try {
+            text = await readFile(this.filePath(sessionId), {
+                encoding: "utf8",
+                signal,
+            });
+        }
+        catch (error) {
+            const normalized = normalizeUnknownError(error);
+            if (normalized.code === "ABORTED") {
+                throw normalized;
+            }
+            if (isNodeError(error, "ENOENT")) {
+                throw notFound(sessionId, error);
+            }
+            throw readFailed(`Failed to read session: ${sessionId}`, error);
+        }
+        if (text.length === 0) {
+            return [];
+        }
+        const lines = text.split(/\r?\n/);
+        if (lines.at(-1) === "") {
+            lines.pop();
+        }
+        const entries = [];
+        let expectedSeq = 0;
+        let previousId;
+        for (let index = 0; index < lines.length; index += 1) {
+            abortIfNeeded(signal);
+            const line = lines[index];
+            if (line === undefined || line.length === 0) {
+                throw readFailed(`Corrupted session JSONL at line ${index + 1}: empty line`);
+            }
+            const entry = deserializeSessionEntry(line, index + 1);
+            if (entry.sessionId !== sessionId) {
+                throw readFailed(`Session entry at line ${index + 1} belongs to a different session`);
+            }
+            if (entry.seq !== expectedSeq) {
+                throw readFailed(`Invalid session seq at line ${index + 1}: expected ${expectedSeq}, received ${entry.seq}`);
+            }
+            if (expectedSeq === 0) {
+                if (entry.parentId !== undefined) {
+                    throw readFailed("Initial session entry must not have a parentId");
+                }
+            }
+            else if (entry.parentId !== previousId) {
+                throw readFailed(`Invalid parentId at line ${index + 1}`);
+            }
+            entries.push(entry);
+            expectedSeq += 1;
+            previousId = entry.id;
+        }
+        return entries;
+    }
+    filePath(sessionId) {
+        return path.join(this.directory, `${sessionId}.jsonl`);
+    }
+    validateSessionId(sessionId) {
+        if (!/^[A-Za-z0-9._-]+$/.test(sessionId)) {
+            throw new RuntimeError({
+                code: "INTERNAL",
+                category: "session",
+                message: "Session id contains unsupported path characters",
+            });
+        }
+    }
+    async withSessionLock(sessionId, operation) {
+        const key = String(sessionId);
+        const previous = this.writeTails.get(key) ?? Promise.resolve();
+        let release;
+        const gate = new Promise((resolve) => {
+            release = resolve;
+        });
+        const tail = previous.catch(() => undefined).then(() => gate);
+        this.writeTails.set(key, tail);
+        await previous.catch(() => undefined);
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.writeTails.get(key) === tail) {
+                this.writeTails.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=jsonl-store.js.map

package/dist/session/jsonl-store.js.map

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

package/dist/session/projector.d.ts

@@ -0,0 +1,4 @@
+import type { SessionEntry, SessionProjection, SessionProjector } from "./types.js";
+export declare class DefaultSessionProjector implements SessionProjector {
+    project(entries: AsyncIterable<SessionEntry>, signal?: AbortSignal): Promise<SessionProjection>;
+}

package/dist/session/projector.js

@@ -0,0 +1,104 @@
+import { RuntimeError } from "../errors/index.js";
+function projectionError(message) {
+    return new RuntimeError({
+        code: "INTERNAL",
+        category: "session",
+        message,
+    });
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function asMessage(payload) {
+    if (!isRecord(payload) ||
+        typeof payload.id !== "string" ||
+        typeof payload.role !== "string" ||
+        !["system", "user", "assistant", "tool"].includes(payload.role) ||
+        !Array.isArray(payload.parts) ||
+        typeof payload.createdAt !== "string") {
+        throw projectionError("Invalid message payload in session");
+    }
+    return payload;
+}
+function asUsage(payload) {
+    if (!isRecord(payload) ||
+        !isRecord(payload.tokens) ||
+        typeof payload.tokens.inputTokens !== "number" ||
+        typeof payload.tokens.outputTokens !== "number" ||
+        typeof payload.tokens.totalTokens !== "number") {
+        throw projectionError("Invalid usage payload in session");
+    }
+    return payload;
+}
+function asCompaction(payload) {
+    if (!isRecord(payload) ||
+        typeof payload.id !== "string" ||
+        typeof payload.createdAt !== "string" ||
+        typeof payload.reason !== "string" ||
+        typeof payload.summary !== "string") {
+        throw projectionError("Invalid compaction payload in session");
+    }
+    return payload;
+}
+export class DefaultSessionProjector {
+    async project(entries, signal) {
+        let sessionId;
+        let expectedSeq = 0;
+        let previousId;
+        let headEntryId;
+        const messages = [];
+        let latestCompaction;
+        let latestUsage;
+        for await (const entry of entries) {
+            signal?.throwIfAborted();
+            if (sessionId === undefined) {
+                sessionId = entry.sessionId;
+            }
+            else if (entry.sessionId !== sessionId) {
+                throw projectionError("Cannot project entries from multiple sessions");
+            }
+            if (entry.seq !== expectedSeq) {
+                throw projectionError(`Invalid session seq during projection: expected ${expectedSeq}, received ${entry.seq}`);
+            }
+            if (expectedSeq === 0) {
+                if (entry.parentId !== undefined) {
+                    throw projectionError("Initial projected entry must not have a parentId");
+                }
+            }
+            else if (entry.parentId !== previousId) {
+                throw projectionError(`Invalid parentId during projection at seq ${entry.seq}`);
+            }
+            switch (entry.type) {
+                case "message":
+                    messages.push(asMessage(entry.payload));
+                    break;
+                case "compaction":
+                    latestCompaction = asCompaction(entry.payload);
+                    break;
+                case "usage":
+                    latestUsage = asUsage(entry.payload);
+                    break;
+                case "session_meta":
+                case "context_patch":
+                case "model_change":
+                    break;
+                default:
+                    break;
+            }
+            expectedSeq += 1;
+            previousId = entry.id;
+            headEntryId = entry.id;
+        }
+        if (sessionId === undefined) {
+            throw projectionError("Cannot project an empty session log");
+        }
+        return {
+            sessionId,
+            messages,
+            ...(latestCompaction === undefined ? {} : { latestCompaction }),
+            ...(latestUsage === undefined ? {} : { latestUsage }),
+            ...(headEntryId === undefined ? {} : { headEntryId }),
+        };
+    }
+}
+//# sourceMappingURL=projector.js.map

package/dist/session/projector.js.map

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

package/dist/session/serializer.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "../types/index.js";
+import { type SessionEntry } from "./types.js";
+export declare function isJsonSafe(value: unknown, seen?: Set<object>): value is JsonValue;
+export declare function serializeSessionEntry(entry: SessionEntry): string;
+export declare function deserializeSessionEntry(line: string, lineNumber?: number): SessionEntry;

package/dist/session/serializer.js

@@ -0,0 +1,126 @@
+import { RuntimeError } from "../errors/index.js";
+import { SESSION_SCHEMA_VERSION, } from "./types.js";
+function sessionDataError(message, cause) {
+    return new RuntimeError({
+        code: "INTERNAL",
+        category: "session",
+        message,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function isPlainObject(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+export function isJsonSafe(value, seen = new Set()) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean") {
+        return true;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value);
+    }
+    if (typeof value !== "object") {
+        return false;
+    }
+    if (seen.has(value)) {
+        return false;
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.every((item) => isJsonSafe(item, seen));
+        }
+        if (!isPlainObject(value)) {
+            return false;
+        }
+        return Object.values(value).every((item) => isJsonSafe(item, seen));
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function assertMetadata(value) {
+    if (!isPlainObject(value) || !isJsonSafe(value)) {
+        throw sessionDataError("Session entry metadata must be a JSON-safe object");
+    }
+}
+export function serializeSessionEntry(entry) {
+    if (!isJsonSafe(entry.payload)) {
+        throw sessionDataError("Session entry payload must be JSON-safe");
+    }
+    if (entry.metadata !== undefined) {
+        assertMetadata(entry.metadata);
+    }
+    try {
+        return JSON.stringify(entry);
+    }
+    catch (error) {
+        throw sessionDataError("Failed to serialize session entry", error);
+    }
+}
+export function deserializeSessionEntry(line, lineNumber) {
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch (error) {
+        const suffix = lineNumber === undefined ? "" : ` at line ${lineNumber}`;
+        throw sessionDataError(`Corrupted session JSONL${suffix}`, error);
+    }
+    if (!isPlainObject(value)) {
+        throw sessionDataError("Session entry must be a JSON object");
+    }
+    const { id, parentId, sessionId, seq, type, timestamp, schemaVersion, payload, metadata, } = value;
+    if (typeof schemaVersion !== "number" || !Number.isInteger(schemaVersion)) {
+        throw sessionDataError("Session entry has an invalid schemaVersion");
+    }
+    if (schemaVersion !== SESSION_SCHEMA_VERSION) {
+        throw sessionDataError(`Unsupported session schema version: ${schemaVersion}; supported version: ${SESSION_SCHEMA_VERSION}`);
+    }
+    if (typeof id !== "string" || id.length === 0) {
+        throw sessionDataError("Session entry has an invalid id");
+    }
+    if (parentId !== undefined &&
+        (typeof parentId !== "string" || parentId.length === 0)) {
+        throw sessionDataError("Session entry has an invalid parentId");
+    }
+    if (typeof sessionId !== "string" || sessionId.length === 0) {
+        throw sessionDataError("Session entry has an invalid sessionId");
+    }
+    if (typeof seq !== "number" || !Number.isSafeInteger(seq) || seq < 0) {
+        throw sessionDataError("Session entry has an invalid seq");
+    }
+    if (typeof type !== "string" || type.length === 0) {
+        throw sessionDataError("Session entry has an invalid type");
+    }
+    if (typeof timestamp !== "string" ||
+        timestamp.length === 0 ||
+        Number.isNaN(Date.parse(timestamp))) {
+        throw sessionDataError("Session entry has an invalid timestamp");
+    }
+    if (!isJsonSafe(payload)) {
+        throw sessionDataError("Session entry payload is not JSON-safe");
+    }
+    if (metadata !== undefined) {
+        assertMetadata(metadata);
+    }
+    return {
+        id: id,
+        ...(parentId === undefined
+            ? {}
+            : { parentId: parentId }),
+        sessionId: sessionId,
+        seq,
+        type: type,
+        timestamp,
+        schemaVersion,
+        payload,
+        ...(metadata === undefined ? {} : { metadata }),
+    };
+}
+//# sourceMappingURL=serializer.js.map

package/dist/session/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/session/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,OAAO,EACL,sBAAsB,GAGvB,MAAM,YAAY,CAAC;AAEpB,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAe;IACxD,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,SAAS;QACnB,OAAO;QACP,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,OAAO,IAAI,GAAG,EAAU;IAExB,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,gBAAgB,CAAC,mDAAmD,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,gBAAgB,CAAC,yCAAyC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,gBAAgB,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,UAAmB;IAEnB,IAAI,KAAc,CAAC;IAEnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,UAAU,EAAE,CAAC;QACxE,MAAM,gBAAgB,CAAC,0BAA0B,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,gBAAgB,CAAC,qCAAqC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,EACJ,EAAE,EACF,QAAQ,EACR,SAAS,EACT,GAAG,EACH,IAAI,EACJ,SAAS,EACT,aAAa,EACb,OAAO,EACP,QAAQ,GACT,GAAG,KAAK,CAAC;IAEV,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1E,MAAM,gBAAgB,CAAC,4CAA4C,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,aAAa,KAAK,sBAAsB,EAAE,CAAC;QAC7C,MAAM,gBAAgB,CACpB,uCAAuC,aAAa,wBAAwB,sBAAsB,EAAE,CACrG,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,gBAAgB,CAAC,iCAAiC,CAAC,CAAC;IAC5D,CAAC;IAED,IACE,QAAQ,KAAK,SAAS;QACtB,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EACvD,CAAC;QACD,MAAM,gBAAgB,CAAC,uCAAuC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,gBAAgB,CAAC,wCAAwC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACrE,MAAM,gBAAgB,CAAC,kCAAkC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,gBAAgB,CAAC,mCAAmC,CAAC,CAAC;IAC9D,CAAC;IAED,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,CAAC,MAAM,KAAK,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EACnC,CAAC;QACD,MAAM,gBAAgB,CAAC,wCAAwC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,gBAAgB,CAAC,wCAAwC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,EAAE,EAAE,EAAoB;QACxB,GAAG,CAAC,QAAQ,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAA0B,EAAE,CAAC;QAC7C,SAAS,EAAE,SAAsB;QACjC,GAAG;QACH,IAAI,EAAE,IAAwB;QAC9B,SAAS;QACT,aAAa;QACb,OAAO;QACP,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/session/session.d.ts

@@ -0,0 +1,32 @@
+import type { Metadata, SessionEntryId, SessionId } from "../types/index.js";
+import type { SessionStore } from "./store.js";
+import { type NewSessionEntry, type SessionEntry } from "./types.js";
+export interface Session {
+    readonly id: SessionId;
+    append(entry: NewSessionEntry, signal?: AbortSignal): Promise<SessionEntry>;
+    appendMany(entries: readonly NewSessionEntry[], signal?: AbortSignal): Promise<readonly SessionEntry[]>;
+    entries(signal?: AbortSignal): AsyncIterable<SessionEntry>;
+    head(): SessionEntryId | undefined;
+}
+export interface CreateSessionOptions {
+    id?: SessionId;
+    metadata?: Metadata;
+}
+export declare class DefaultSession implements Session {
+    private readonly store;
+    readonly id: SessionId;
+    private nextSeq;
+    private headEntryId;
+    private tail;
+    private constructor();
+    static create(store: SessionStore, options?: CreateSessionOptions, signal?: AbortSignal): Promise<DefaultSession>;
+    static open(store: SessionStore, id: SessionId, signal?: AbortSignal): Promise<DefaultSession>;
+    append(entry: NewSessionEntry, signal?: AbortSignal): Promise<SessionEntry>;
+    appendMany(entries: readonly NewSessionEntry[], signal?: AbortSignal): Promise<readonly SessionEntry[]>;
+    entries(signal?: AbortSignal): AsyncIterable<SessionEntry>;
+    head(): SessionEntryId | undefined;
+    private appendUnlocked;
+    private lock;
+}
+export declare function createSession(store: SessionStore, options?: CreateSessionOptions, signal?: AbortSignal): Promise<DefaultSession>;
+export declare function openSession(store: SessionStore, id: SessionId, signal?: AbortSignal): Promise<DefaultSession>;