@code-yeongyu/senpi-agent-core 2026.8.12 → 2026.8.13

package/dist/harness/session/session.d.ts

@@ -1,45 +1,50 @@
-import { type ImageContent, type TextContent, type Usage } from "@earendil-works/pi-ai";
 import type { AgentMessage } from "../../types.ts";
-import type { CustomEntry, SessionContext, SessionEntryCursorOptions, SessionMetadata, SessionReader, SessionStats, SessionStore, SessionTreeEntry } from "../types.ts";
-export type ContextEntryTransform = (entries: readonly SessionTreeEntry[]) => readonly SessionTreeEntry[];
-export type CustomEntryContextMessageProjector = (entry: CustomEntry, index: number, entries: readonly SessionTreeEntry[]) => readonly AgentMessage[] | undefined;
-export interface SessionContextBuildOptions {
-    /** Additional entry transforms applied after the default compaction transform. */
-    entryTransforms?: readonly ContextEntryTransform[];
-    /** Optional custom-entry projectors. Custom entries are omitted from model context by default. */
-    entryProjectors?: Readonly<Record<string, CustomEntryContextMessageProjector>>;
-}
-export declare function defaultContextEntryTransform(pathEntries: readonly SessionTreeEntry[]): SessionTreeEntry[];
-export declare function buildContextEntries(pathEntries: readonly SessionTreeEntry[], options?: SessionContextBuildOptions): SessionTreeEntry[];
-export declare function sessionEntryToContextMessages(entry: SessionTreeEntry, index: number, entries: readonly SessionTreeEntry[], options?: SessionContextBuildOptions): AgentMessage[];
-export declare function buildSessionContext(pathEntries: readonly SessionTreeEntry[], options?: SessionContextBuildOptions): SessionContext;
-export interface Session<TMetadata extends SessionMetadata = SessionMetadata> {
+import type { BranchBounds, Entry, EntryQuery, IdGenerator, LanePointer, LaneRecord, LogItem, LogOptions, NewRecord, OperationStartedRecord, ProvisionedEntry, RecordBase, RecordQuery, SessionMetadata, SessionStats, SessionStorage, SessionTree } from "./types.ts";
+export declare function assertJsonSerializable(value: unknown): void;
+export declare class Session<TMetadata extends SessionMetadata = SessionMetadata> implements SessionTree {
+    private readonly storage;
+    readonly idGenerator: IdGenerator;
+    constructor(storage: SessionStorage<TMetadata>, options?: {
+        idGenerator?: IdGenerator;
+    });
     getMetadata(): Promise<TMetadata>;
+    view(lane: string): SessionTree;
     getLeafId(): Promise<string | null>;
-    getEntry(id: string): Promise<SessionTreeEntry | undefined>;
-    getEntries(options?: SessionEntryCursorOptions): Promise<SessionTreeEntry[]>;
-    getBranch(fromId?: string | null): Promise<SessionTreeEntry[]>;
-    buildContextEntries(options?: SessionContextBuildOptions): Promise<SessionTreeEntry[]>;
-    buildContext(options?: SessionContextBuildOptions): Promise<SessionContext>;
-    getLabel(id: string): Promise<string | undefined>;
-    getSessionStats(): Promise<SessionStats>;
-    getSessionName(): Promise<string | undefined>;
+    getEntry(id: string): Promise<Entry | undefined>;
+    getStats(): Promise<SessionStats>;
+    getName(): Promise<string | undefined>;
+    setName(name: string): Promise<void>;
+    getLabel(targetId: string): Promise<string | undefined>;
+    setLabel(targetId: string, label: string | undefined): Promise<void>;
+    findEntries(query?: EntryQuery): Promise<Entry[]>;
+    findEntry(query?: EntryQuery): Promise<Entry | undefined>;
+    findEntriesOnBranch(query?: EntryQuery & BranchBounds): Promise<Entry[]>;
+    findEntryOnBranch(query?: EntryQuery & BranchBounds): Promise<Entry | undefined>;
     appendMessage(message: AgentMessage): Promise<string>;
-    appendThinkingLevelChange(thinkingLevel: string): Promise<string>;
-    appendModelChange(provider: string, modelId: string): Promise<string>;
-    appendActiveToolsChange(activeToolNames: string[]): Promise<string>;
-    appendCompaction<T = unknown>(summary: string, firstKeptEntryId: string | undefined, tokensBefore: number, details?: T, fromHook?: boolean, usage?: Usage, retainedTail?: AgentMessage[]): Promise<string>;
     appendCustomEntry(customType: string, data?: unknown): Promise<string>;
-    appendCustomMessageEntry<T = unknown>(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details?: T): Promise<string>;
-    appendLabel(targetId: string, label: string | undefined): Promise<string>;
-    appendSessionName(name: string): Promise<string>;
-    moveTo(entryId: string | null, summary?: {
-        summary: string;
-        details?: unknown;
-        usage?: Usage;
-        fromHook?: boolean;
-    }): Promise<string | undefined>;
+    getLanes(): Promise<LanePointer[]>;
+    createLane(lane: string, at: string | null): Promise<void>;
+    moveLane(lane: string, to: string | null): Promise<void>;
+    appendEntry<TEntry extends Entry>(entry: ProvisionedEntry<TEntry>, lane: string): Promise<TEntry>;
+    appendRecord<TNewRecord extends NewRecord>(record: TNewRecord): Promise<TNewRecord & Pick<RecordBase, "seq" | "timestamp">>;
+    findRecords<K extends LaneRecord["type"]>(query: RecordQuery & {
+        type: K;
+    }): Promise<Extract<LaneRecord, {
+        type: K;
+    }>[]>;
+    findRecords(query?: RecordQuery): Promise<LaneRecord[]>;
+    findOpenOperations(lane: string, options?: {
+        limit?: number;
+    }): Promise<OperationStartedRecord[]>;
+    getLog(options?: LogOptions): Promise<LogItem[]>;
+    private getLeafIdForLane;
+    private queryEntries;
+    private queryBranchEntries;
+    private queryRecords;
+    private queryLog;
+    private appendMessageToLane;
+    private appendCustomEntryToLane;
+    private commitEntry;
+    private commitRecord;
 }
-/** @internal Construct sessions only through SessionRepository. */
-export declare function createSessionFromReader<TMetadata extends SessionMetadata>(store: Pick<SessionStore<TMetadata>, "appendEntry">, reader: SessionReader<TMetadata>, contextBuildOptions?: SessionContextBuildOptions): Promise<Session<TMetadata>>;
 //# sourceMappingURL=session.d.ts.map

package/dist/harness/session/session.d.ts.map

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

package/dist/harness/session/session.js

@@ -1,338 +1,220 @@
 import { uuidv7 } from "@earendil-works/pi-ai";
-import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage } from "../messages.js";
-import { SessionError } from "../types.js";
-function deriveSessionContextState(pathEntries) {
-    let thinkingLevel = "off";
-    let model = null;
-    let activeToolNames = null;
-    for (const entry of pathEntries) {
-        if (entry.type === "thinking_level_change") {
-            thinkingLevel = entry.thinkingLevel;
+import { SessionError } from "./types.js";
+function invalidPayload(reason) {
+    throw new SessionError("invalid_payload", `Durable payload ${reason}`);
+}
+function assertValidLimit(limit) {
+    if (limit !== undefined && (!Number.isInteger(limit) || limit <= 0)) {
+        throw new SessionError("invalid_query", "limit must be a positive integer");
+    }
+}
+function assertValidCursor(afterSeq) {
+    if (afterSeq !== undefined && (!Number.isInteger(afterSeq) || afterSeq < 0)) {
+        throw new SessionError("invalid_query", "cursor sequence must be a non-negative integer");
+    }
+}
+export function assertJsonSerializable(value) {
+    const active = new WeakSet();
+    const stack = [{ value }];
+    while (stack.length > 0) {
+        const frame = stack.pop();
+        if ("exit" in frame) {
+            active.delete(frame.exit);
+            continue;
         }
-        else if (entry.type === "model_change") {
-            model = { provider: entry.provider, modelId: entry.modelId };
+        const candidate = frame.value;
+        if (candidate === null || typeof candidate === "string" || typeof candidate === "boolean") {
+            continue;
         }
-        else if (entry.type === "message" && entry.message.role === "assistant") {
-            model = { provider: entry.message.provider, modelId: entry.message.model };
+        if (typeof candidate === "number") {
+            if (!Number.isFinite(candidate))
+                invalidPayload("contains a non-finite number");
+            continue;
         }
-        else if (entry.type === "active_tools_change") {
-            activeToolNames = [...entry.activeToolNames];
+        if (typeof candidate !== "object")
+            invalidPayload(`contains ${typeof candidate}`);
+        if (active.has(candidate))
+            invalidPayload("contains a cycle");
+        active.add(candidate);
+        stack.push({ exit: candidate });
+        if (Array.isArray(candidate)) {
+            if (Object.getPrototypeOf(candidate) !== Array.prototype) {
+                invalidPayload("contains a non-standard array");
+            }
+            if (Object.getOwnPropertySymbols(candidate).length > 0 ||
+                Object.getOwnPropertyNames(candidate).length !== candidate.length + 1) {
+                invalidPayload("contains an array with unsupported properties");
+            }
+            for (let index = candidate.length - 1; index >= 0; index--) {
+                if (!Object.hasOwn(candidate, index))
+                    invalidPayload("contains a sparse array");
+                const descriptor = Object.getOwnPropertyDescriptor(candidate, index);
+                if (!("value" in descriptor))
+                    invalidPayload("contains an array accessor");
+                stack.push({ value: descriptor.value });
+            }
+            continue;
         }
-    }
-    return { thinkingLevel, model, activeToolNames };
-}
-export function defaultContextEntryTransform(pathEntries) {
-    let compaction = null;
-    for (const entry of pathEntries) {
-        if (entry.type === "compaction") {
-            compaction = entry;
+        const prototype = Object.getPrototypeOf(candidate);
+        if (prototype !== Object.prototype && prototype !== null) {
+            invalidPayload("contains a non-plain object");
         }
-    }
-    if (!compaction) {
-        return [...pathEntries];
-    }
-    const entries = [compaction];
-    const compactionIdx = pathEntries.findIndex((entry) => entry.type === "compaction" && entry.id === compaction.id);
-    if (compaction.retainedTail) {
-        for (let i = compactionIdx + 1; i < pathEntries.length; i++) {
-            entries.push(pathEntries[i]);
+        if (Object.getOwnPropertySymbols(candidate).length > 0) {
+            invalidPayload("contains a symbol-keyed property");
         }
-        return entries;
-    }
-    if (compaction.firstKeptEntryId) {
-        let foundFirstKept = false;
-        for (let i = 0; i < compactionIdx; i++) {
-            const entry = pathEntries[i];
-            if (entry.id === compaction.firstKeptEntryId)
-                foundFirstKept = true;
-            if (foundFirstKept)
-                entries.push(entry);
+        const keys = Object.keys(candidate);
+        if (Object.getOwnPropertyNames(candidate).length !== keys.length) {
+            invalidPayload("contains a non-enumerable property");
         }
-    }
-    for (let i = compactionIdx + 1; i < pathEntries.length; i++) {
-        entries.push(pathEntries[i]);
-    }
-    return entries;
-}
-export function buildContextEntries(pathEntries, options = {}) {
-    let entries = defaultContextEntryTransform(pathEntries);
-    for (const transform of options.entryTransforms ?? []) {
-        entries = [...transform(entries)];
-    }
-    return entries;
-}
-export function sessionEntryToContextMessages(entry, index, entries, options = {}) {
-    if (entry.type === "message") {
-        return [entry.message];
-    }
-    if (entry.type === "custom_message") {
-        return [
-            createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp),
-        ];
-    }
-    if (entry.type === "compaction") {
-        return [
-            createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),
-            ...(entry.retainedTail ?? []),
-        ];
-    }
-    if (entry.type === "branch_summary" && entry.summary) {
-        return [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];
-    }
-    if (entry.type === "custom") {
-        return [...(options.entryProjectors?.[entry.customType]?.(entry, index, entries) ?? [])];
-    }
-    return [];
-}
-export function buildSessionContext(pathEntries, options = {}) {
-    const state = deriveSessionContextState(pathEntries);
-    const contextEntries = buildContextEntries(pathEntries, options);
-    const messages = contextEntries.flatMap((entry, index) => sessionEntryToContextMessages(entry, index, contextEntries, options));
-    return { ...state, messages };
-}
-class HydratedSessionState {
-    constructor(entries) {
-        this.labelsById = new Map();
-        this.entries = [...entries];
-        for (const entry of this.entries)
-            this.applyProjection(entry);
-    }
-    getLabel(id) {
-        return this.labelsById.get(id);
-    }
-    getSessionName() {
-        for (let i = this.entries.length - 1; i >= 0; i--) {
-            const entry = this.entries[i];
-            if (entry.type === "session_info")
-                return entry.name?.trim() || undefined;
-        }
-        return undefined;
-    }
-    getSessionStats() {
-        let messageCount = 0;
-        let cachedTokens = 0;
-        let uncachedTokens = 0;
-        let totalTokens = 0;
-        let costTotal = 0;
-        for (const entry of this.entries) {
-            if (entry.type === "message")
-                messageCount += 1;
-            const usage = entry.type === "message"
-                ? entry.message.role === "assistant"
-                    ? entry.message.usage
-                    : undefined
-                : entry.type === "compaction" || entry.type === "branch_summary"
-                    ? entry.usage
-                    : undefined;
-            if (!usage ||
-                typeof usage.input !== "number" ||
-                typeof usage.output !== "number" ||
-                typeof usage.cacheRead !== "number" ||
-                typeof usage.cacheWrite !== "number" ||
-                typeof usage.cost?.total !== "number")
-                continue;
-            cachedTokens += usage.cacheRead;
-            uncachedTokens += usage.input + usage.cacheWrite;
-            totalTokens += usage.input + usage.output + usage.cacheRead + usage.cacheWrite;
-            costTotal += usage.cost.total;
+        for (let index = keys.length - 1; index >= 0; index--) {
+            const descriptor = Object.getOwnPropertyDescriptor(candidate, keys[index]);
+            if (!("value" in descriptor))
+                invalidPayload("contains an accessor");
+            stack.push({ value: descriptor.value });
         }
-        return { messageCount, cachedTokens, uncachedTokens, totalTokens, costTotal };
-    }
-    applyProjection(entry) {
-        if (entry.type !== "label")
-            return;
-        const label = entry.label?.trim();
-        if (label)
-            this.labelsById.set(entry.targetId, label);
-        else
-            this.labelsById.delete(entry.targetId);
     }
 }
-class StoreSession {
-    constructor(store, reader, leafId, contextBuildOptions = {}) {
-        this.appendTail = Promise.resolve();
-        this.store = store;
-        this.reader = reader;
-        this.metadata = reader.metadata;
-        this.leafId = leafId;
-        this.contextBuildOptions = contextBuildOptions;
+export class Session {
+    constructor(storage, options = {}) {
+        this.storage = storage;
+        this.idGenerator = options.idGenerator ?? { next: () => uuidv7() };
     }
     async getMetadata() {
-        return this.metadata;
+        return this.storage.getMetadata();
+    }
+    view(lane) {
+        if (lane === "main")
+            return this;
+        return {
+            getLeafId: () => this.getLeafIdForLane(lane),
+            getEntry: (id) => this.getEntry(id),
+            getStats: () => this.getStats(),
+            getName: () => this.getName(),
+            setName: (name) => this.setName(name),
+            getLabel: (targetId) => this.getLabel(targetId),
+            setLabel: (targetId, label) => this.setLabel(targetId, label),
+            findEntries: (query) => this.queryEntries(query),
+            findEntry: async (query = {}) => (await this.queryEntries(query, 1))[0],
+            findEntriesOnBranch: (query) => this.queryBranchEntries(lane, query),
+            findEntryOnBranch: async (query = {}) => (await this.queryBranchEntries(lane, query, 1))[0],
+            appendMessage: (message) => this.appendMessageToLane(lane, message),
+            appendCustomEntry: (customType, data) => this.appendCustomEntryToLane(lane, customType, data),
+        };
     }
     async getLeafId() {
-        return this.leafId;
+        return this.getLeafIdForLane("main");
     }
     async getEntry(id) {
-        return this.reader.readEntry(id);
+        return this.storage.getEntry(id);
     }
-    async getEntries(options) {
-        return [...(await this.reader.readEntries(options))];
+    async getStats() {
+        return this.storage.getStats();
     }
-    async getBranch(fromId) {
-        return [...(await this.reader.readPathToRootOrCompaction(fromId === undefined ? this.leafId : fromId))];
+    async getName() {
+        return this.storage.getName();
     }
-    async buildContextEntries(options = {}) {
-        return buildContextEntries(await this.getBranch(), this.mergeContextBuildOptions(options));
+    async setName(name) {
+        await this.storage.setName(name);
     }
-    async buildContext(options = {}) {
-        return buildSessionContext(await this.getBranch(), this.mergeContextBuildOptions(options));
+    async getLabel(targetId) {
+        return this.storage.getLabel(targetId);
     }
-    mergeContextBuildOptions(options) {
-        return {
-            entryTransforms: [...(this.contextBuildOptions.entryTransforms ?? []), ...(options.entryTransforms ?? [])],
-            entryProjectors: {
-                ...(this.contextBuildOptions.entryProjectors ?? {}),
-                ...(options.entryProjectors ?? {}),
-            },
-        };
+    async setLabel(targetId, label) {
+        await this.storage.setLabel(targetId, label);
     }
-    async getLabel(id) {
-        return (await this.getHydratedState()).getLabel(id);
+    async findEntries(query) {
+        return this.queryEntries(query);
     }
-    async getSessionStats() {
-        return (await this.getHydratedState()).getSessionStats();
+    async findEntry(query = {}) {
+        return (await this.queryEntries(query, 1))[0];
     }
-    async getSessionName() {
-        return (await this.getHydratedState()).getSessionName();
+    async findEntriesOnBranch(query) {
+        return this.queryBranchEntries("main", query);
     }
-    async getHydratedState() {
-        this.hydratedStatePromise ??= this.reader.readEntries().then((entries) => new HydratedSessionState(entries));
-        return this.hydratedStatePromise;
-    }
-    async createEntryId() {
-        for (let i = 0; i < 100; i++) {
-            const id = uuidv7().slice(-8);
-            if (!(await this.getEntry(id)))
-                return id;
-        }
-        return uuidv7();
-    }
-    enqueueAppend(createEntry) {
-        const operation = this.appendTail.then(async () => {
-            const entry = createEntry({
-                id: await this.createEntryId(),
-                parentId: this.leafId,
-                timestamp: new Date().toISOString(),
-            });
-            await this.store.appendEntry(this.metadata, entry);
-            this.leafId = entry.type === "leaf" ? entry.targetId : entry.id;
-            this.hydratedStatePromise = undefined;
-            return entry;
-        });
-        this.appendTail = operation.then(() => undefined, () => undefined);
-        return operation;
-    }
-    async setLeafId(leafId) {
-        if (leafId !== null && !(await this.getEntry(leafId))) {
-            throw new SessionError("not_found", `Entry ${leafId} not found`);
-        }
-        return this.enqueueAppend((base) => {
-            return { ...base, type: "leaf", targetId: leafId };
-        });
-    }
-    async appendTypedEntry(createEntry) {
-        return (await this.enqueueAppend(createEntry)).id;
+    async findEntryOnBranch(query = {}) {
+        return (await this.queryBranchEntries("main", query, 1))[0];
     }
     async appendMessage(message) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "message",
-            message,
-        }));
-    }
-    async appendThinkingLevelChange(thinkingLevel) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "thinking_level_change",
-            thinkingLevel,
-        }));
-    }
-    async appendModelChange(provider, modelId) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "model_change",
-            provider,
-            modelId,
-        }));
-    }
-    async appendActiveToolsChange(activeToolNames) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "active_tools_change",
-            activeToolNames: [...activeToolNames],
-        }));
-    }
-    async appendCompaction(summary, firstKeptEntryId, tokensBefore, details, fromHook, usage, retainedTail) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "compaction",
-            summary,
-            firstKeptEntryId,
-            tokensBefore,
-            retainedTail,
-            details,
-            usage,
-            fromHook,
-        }));
+        return this.appendMessageToLane("main", message);
     }
     async appendCustomEntry(customType, data) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "custom",
-            customType,
-            data,
-        }));
-    }
-    async appendCustomMessageEntry(customType, content, display, details) {
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "custom_message",
-            customType,
-            content,
-            display,
-            details,
-        }));
-    }
-    async appendLabel(targetId, label) {
-        if (!(await this.getEntry(targetId))) {
-            throw new SessionError("not_found", `Entry ${targetId} not found`);
-        }
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "label",
-            targetId,
-            label,
-        }));
-    }
-    async appendSessionName(name) {
-        const sanitizedName = name.replace(/[\r\n]+/g, " ").trim();
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "session_info",
-            name: sanitizedName,
-        }));
-    }
-    async moveTo(entryId, summary) {
-        if (entryId !== null && !(await this.getEntry(entryId))) {
-            throw new SessionError("not_found", `Entry ${entryId} not found`);
+        return this.appendCustomEntryToLane("main", customType, data);
+    }
+    async getLanes() {
+        return this.storage.getLanes();
+    }
+    async createLane(lane, at) {
+        await this.storage.createLane(lane, at);
+    }
+    async moveLane(lane, to) {
+        await this.storage.moveLane(lane, to);
+    }
+    async appendEntry(entry, lane) {
+        return this.commitEntry(entry, lane);
+    }
+    async appendRecord(record) {
+        return this.commitRecord(record);
+    }
+    async findRecords(query) {
+        return this.queryRecords(query);
+    }
+    async findOpenOperations(lane, options) {
+        assertValidLimit(options?.limit);
+        return this.storage.findOpenOperations(lane, options);
+    }
+    async getLog(options) {
+        return this.queryLog(options);
+    }
+    async getLeafIdForLane(lane) {
+        const pointer = (await this.getLanes()).find((candidate) => candidate.lane === lane);
+        if (!pointer)
+            throw new SessionError("invalid_lane", `Lane not found: ${lane}`);
+        return pointer.leafId;
+    }
+    async queryEntries(query = {}, resultLimit = query.limit) {
+        assertValidLimit(query.limit);
+        assertValidCursor(query.cursor?.afterSeq);
+        return this.storage.findEntries(resultLimit === query.limit ? query : { ...query, limit: resultLimit });
+    }
+    async queryBranchEntries(lane, query = {}, resultLimit = query.limit) {
+        assertValidLimit(query.limit);
+        assertValidCursor(query.cursor?.afterSeq);
+        const start = query.start ?? (await this.getLeafIdForLane(lane));
+        if (start === null)
+            return [];
+        const storageQuery = resultLimit === query.limit ? query : { ...query, limit: resultLimit };
+        return this.storage.findEntriesOnBranch({ ...storageQuery, start });
+    }
+    async queryRecords(query = {}) {
+        assertValidLimit(query.limit);
+        assertValidCursor(query.afterSeq);
+        if (query.operationKind !== undefined && query.type !== "operation_started") {
+            throw new SessionError("invalid_query", 'operationKind requires type "operation_started"');
         }
-        await this.setLeafId(entryId);
-        if (!summary)
-            return undefined;
-        return this.appendTypedEntry((base) => ({
-            ...base,
-            type: "branch_summary",
-            fromId: entryId ?? "root",
-            summary: summary.summary,
-            details: summary.details,
-            usage: summary.usage,
-            fromHook: summary.fromHook,
-        }));
+        return this.storage.findRecords(query);
+    }
+    async queryLog(options = {}) {
+        assertValidLimit(options.limit);
+        assertValidCursor(options.afterSeq);
+        return this.storage.getLog(options);
+    }
+    async appendMessageToLane(lane, message) {
+        const entry = await this.commitEntry({ type: "message", id: this.idGenerator.next(), message }, lane);
+        return entry.id;
+    }
+    async appendCustomEntryToLane(lane, customType, data) {
+        const entry = await this.commitEntry(data === undefined
+            ? { type: "custom", id: this.idGenerator.next(), customType }
+            : { type: "custom", id: this.idGenerator.next(), customType, data }, lane);
+        return entry.id;
+    }
+    async commitEntry(entry, lane) {
+        assertJsonSerializable(entry);
+        return this.storage.appendEntry(entry, lane);
+    }
+    async commitRecord(record) {
+        assertJsonSerializable(record);
+        return this.storage.appendRecord(record);
     }
-}
-/** @internal Construct sessions only through SessionRepository. */
-export async function createSessionFromReader(store, reader, contextBuildOptions = {}) {
-    return new StoreSession(store, reader, (await reader.readHead()).leafId, contextBuildOptions);
 }
 //# sourceMappingURL=session.js.map