@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/core-session/dist/session-interchange.js

@@ -0,0 +1,271 @@
+import { assertSessionEvent } from "@xrkseek/protocol";
+export const SESSION_INTERCHANGE_VERSION = 1;
+function messageText(value) {
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value)) {
+        return value
+            .map((part) => {
+            if (!part || typeof part !== "object")
+                return "";
+            const row = part;
+            return typeof row.text === "string" ? row.text : "";
+        })
+            .join("");
+    }
+    return "";
+}
+function roleOf(raw) {
+    const role = raw.role ?? raw.type;
+    if (role === "user" || role === "human")
+        return "user";
+    if (role === "assistant" || role === "agent" || role === "model") {
+        return "assistant";
+    }
+    if (role === "tool" || role === "function")
+        return "tool";
+    return undefined;
+}
+function timestampOf(raw) {
+    const value = raw.ts ?? raw.timestamp;
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function toolCallsOf(raw) {
+    const calls = raw.tool_calls ?? raw.toolCalls;
+    if (!Array.isArray(calls))
+        return [];
+    const out = [];
+    for (const call of calls) {
+        if (!call || typeof call !== "object")
+            continue;
+        const row = call;
+        const fn = row.function;
+        const name = typeof row.name === "string" ? row.name : fn?.name;
+        if (typeof name !== "string" || !name)
+            continue;
+        const id = typeof row.id === "string" && row.id ? row.id : `call_${out.length}`;
+        let args = row.arguments ?? fn?.arguments ?? {};
+        if (typeof args === "string") {
+            try {
+                args = JSON.parse(args);
+            }
+            catch {
+                args = { raw: args };
+            }
+        }
+        const ts = timestampOf(raw);
+        out.push({
+            role: "tool",
+            text: "",
+            name,
+            callId: id,
+            phase: "call",
+            arguments: args,
+            ...(ts !== undefined ? { ts } : {}),
+        });
+    }
+    return out;
+}
+/** Pull user/assistant/tool lines. Skips the interchange header and unknown rows. */
+export function readSessionInterchange(text) {
+    const out = [];
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let raw;
+        try {
+            raw = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (!raw || typeof raw !== "object")
+            continue;
+        const row = raw;
+        if (row.xrkInterchange === SESSION_INTERCHANGE_VERSION)
+            continue;
+        const role = roleOf(row);
+        if (!role)
+            continue;
+        const ts = timestampOf(row);
+        if (role === "tool") {
+            const name = typeof row.name === "string" ? row.name : "tool";
+            const callId = typeof row.callId === "string"
+                ? row.callId
+                : typeof row.tool_call_id === "string"
+                    ? row.tool_call_id
+                    : typeof row.id === "string"
+                        ? row.id
+                        : `call_${out.length}`;
+            const phase = row.phase === "call" ? "call" : "result";
+            out.push({
+                role,
+                text: messageText(row.text ?? row.content ?? row.message ?? row.body),
+                name,
+                callId,
+                phase,
+                ...(row.arguments !== undefined ? { arguments: row.arguments } : {}),
+                ...(ts !== undefined ? { ts } : {}),
+            });
+            continue;
+        }
+        const textBody = messageText(row.text ?? row.content ?? row.message ?? row.body).trim();
+        const calls = role === "assistant" ? toolCallsOf(row) : [];
+        if (!textBody && calls.length === 0)
+            continue;
+        if (textBody) {
+            out.push({
+                role,
+                text: textBody,
+                ...(ts !== undefined ? { ts } : {}),
+            });
+        }
+        out.push(...calls);
+    }
+    return out;
+}
+function splitTurns(messages) {
+    const turns = [];
+    let current = [];
+    let sawModel = false;
+    for (const message of messages) {
+        if (message.role === "user" && sawModel && current.length > 0) {
+            turns.push(current);
+            current = [];
+            sawModel = false;
+        }
+        current.push(message);
+        if (message.role !== "user")
+            sawModel = true;
+    }
+    if (current.length > 0)
+        turns.push(current);
+    return turns;
+}
+/** XRK events for an imported transcript. Does not touch the session store. */
+export function importSessionInterchange(text, now = Date.now()) {
+    const turns = splitTurns(readSessionInterchange(text));
+    const built = [];
+    turns.forEach((messages, turnIndex) => {
+        const turnId = `turn_interchange_${turnIndex}`;
+        const stepId = `step_interchange_${turnIndex}`;
+        const openedAt = messages.find((row) => row.ts !== undefined)?.ts ?? now;
+        built.push({ type: "turn/start", ts: openedAt, turnId }, { type: "step/start", ts: openedAt, turnId, stepId });
+        let index = 0;
+        for (const message of messages) {
+            const ts = message.ts ?? openedAt;
+            if (message.role === "user") {
+                built.push({
+                    type: "user/message",
+                    ts,
+                    turnId,
+                    messageId: `umsg_interchange_${turnIndex}_${index}`,
+                    content: message.text,
+                });
+            }
+            else if (message.role === "assistant") {
+                built.push({
+                    type: "assistant/message",
+                    ts,
+                    turnId,
+                    stepId,
+                    content: message.text,
+                });
+            }
+            else if (message.phase === "call") {
+                built.push({
+                    type: "tool/call",
+                    ts,
+                    turnId,
+                    stepId,
+                    call: {
+                        id: message.callId ?? `call_${turnIndex}_${index}`,
+                        name: message.name ?? "tool",
+                        arguments: message.arguments ?? {},
+                    },
+                });
+            }
+            else {
+                built.push({
+                    type: "tool/result",
+                    ts,
+                    turnId,
+                    stepId,
+                    result: {
+                        toolCallId: message.callId ?? `call_${turnIndex}_${index}`,
+                        name: message.name ?? "tool",
+                        content: message.text,
+                    },
+                });
+            }
+            index += 1;
+        }
+        const closedAt = messages.at(-1)?.ts ?? openedAt;
+        built.push({ type: "step/end", ts: closedAt, turnId, stepId }, { type: "turn/end", ts: closedAt, turnId, reason: { kind: "completed" } });
+    });
+    return built.map((row) => assertSessionEvent(row));
+}
+function eventText(event) {
+    if (event.type === "user/message") {
+        const text = messageText(event.content).trim();
+        return text ? { role: "user", text, ts: event.ts } : undefined;
+    }
+    if (event.type === "assistant/message") {
+        const text = event.content.trim();
+        return text ? { role: "assistant", text, ts: event.ts } : undefined;
+    }
+    if (event.type === "tool/call") {
+        return {
+            role: "tool",
+            text: "",
+            name: event.call.name,
+            callId: event.call.id,
+            phase: "call",
+            arguments: event.call.arguments,
+            ts: event.ts,
+        };
+    }
+    if (event.type === "tool/result") {
+        return {
+            role: "tool",
+            text: messageText(event.result.content),
+            name: event.result.name,
+            callId: event.result.toolCallId,
+            phase: "result",
+            ts: event.ts,
+        };
+    }
+    return undefined;
+}
+/** Portable role JSONL. Header marks this as interchange, not schema v3. */
+export function exportSessionInterchange(events) {
+    const lines = [
+        {
+            xrkInterchange: SESSION_INTERCHANGE_VERSION,
+            kind: "transcript",
+            not: ["sqlite-schema-v3", "session-format-v3"],
+        },
+    ];
+    for (const event of events) {
+        const message = eventText(event);
+        if (!message)
+            continue;
+        const row = {
+            role: message.role,
+            ...(message.role === "tool" ? { content: message.text } : { text: message.text }),
+        };
+        if (message.ts !== undefined)
+            row.ts = message.ts;
+        if (message.role === "tool") {
+            row.name = message.name;
+            row.callId = message.callId;
+            row.phase = message.phase;
+            if (message.phase === "call")
+                row.arguments = message.arguments ?? {};
+        }
+        lines.push(row);
+    }
+    return `${lines.map((row) => JSON.stringify(row)).join("\n")}\n`;
+}
+//# sourceMappingURL=session-interchange.js.map

package/node_modules/@xrkseek/core-session/dist/session-interchange.js.map

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

package/node_modules/@xrkseek/core-session/dist/sqlite-store.d.ts

@@ -1,5 +1,6 @@
 import type { SessionEvent } from "@xrkseek/protocol";
 import type { SessionStore } from "./store.js";
+export { acquireSessionsDirLock, SessionsDirInUseError, SESSIONS_WRITE_LOCK_FILENAME, type SessionsDirLock, } from "./store-lock.js";
 export interface PersistentSessionStore extends SessionStore {
     /** Flush batched chunk writes (also called from {@link close}). */
     flush(): void;
@@ -30,6 +31,13 @@ export interface PersistentSessionStoreOptions {
      * temporarily exceed this cap while many turns are in flight.
      */
     readonly maxResidentSessions?: number;
+    /**
+     * When true, skip the exclusive write lease and open the DB read-only
+     * (inspect / secondary readers). Mutating APIs throw. Host and CLI writers
+     * must omit this so a second Host fails closed instead of silently sharing
+     * `sessions.db`.
+     */
+    readonly shared?: boolean;
 }
 /** Escape a user query for FTS5 MATCH (trigram substring). */
 export declare function ftsMatchQuery(query: string): string;

package/node_modules/@xrkseek/core-session/dist/sqlite-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../src/sqlite-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtD,OAAO,KAAK,EAAmC,YAAY,EAAE,MAAM,YAAY,CAAC;AAShF,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAC;IACd,kFAAkF;IAClF,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnD;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAoBD,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAwKD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CA4PxB;AAED,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,gBAAU,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,IAAiB,CAAC"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../src/sqlite-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtD,OAAO,KAAK,EAAmC,YAAY,EAAE,MAAM,YAAY,CAAC;AAMhF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AASzB,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAC;IACd,kFAAkF;IAClF,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnD;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAAC;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAoBD,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAwKD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,CA2UxB;AAED,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,gBAAU,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,IAAiB,CAAC"}

package/node_modules/@xrkseek/core-session/dist/sqlite-store.js

@@ -7,9 +7,11 @@ import { repairOpenTurnEvents, sessionHasOpenTurn, } from "./repair-open-turn.js
 import { extractEventSearchText } from "./search-text.js";
 import { snapshotEvents } from "./seq.js";
 import { computeListHints } from "./list-hints.js";
-function openDatabase(dbPath) {
+import { acquireSessionsDirLock, } from "./store-lock.js";
+export { acquireSessionsDirLock, SessionsDirInUseError, SESSIONS_WRITE_LOCK_FILENAME, } from "./store-lock.js";
+function openDatabase(dbPath, readOnly = false) {
     const { DatabaseSync: Db } = process.getBuiltinModule("node:sqlite");
-    return new Db(dbPath);
+    return readOnly ? new Db(dbPath, { readOnly: true }) : new Db(dbPath);
 }
 const ID_RE = /^[A-Za-z0-9._-]+$/;
 /** v3: durable rows may be packed `text-chunks` / `tool-call-chunks` (expanded on load). */
@@ -44,13 +46,13 @@ function storageTs(record) {
     return isPackedChunkRow(record) ? record.ts0 : record.ts;
 }
 function ensureFts(db) {
-    db.exec(`
-    CREATE VIRTUAL TABLE IF NOT EXISTS search_fts USING fts5(
-      session_id UNINDEXED,
-      seq UNINDEXED,
-      text,
-      tokenize = 'trigram'
-    );
+    db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS search_fts USING fts5(
+      session_id UNINDEXED,
+      seq UNINDEXED,
+      text,
+      tokenize = 'trigram'
+    );
   `);
 }
 function schemaVersion(db) {
@@ -90,24 +92,24 @@ function rebuildFts(db) {
 function initSchema(db) {
     db.exec("PRAGMA journal_mode = WAL");
     db.exec("PRAGMA synchronous = FULL");
-    db.exec(`
-    CREATE TABLE IF NOT EXISTS meta (
-      key TEXT PRIMARY KEY,
-      value TEXT NOT NULL
-    );
-    CREATE TABLE IF NOT EXISTS sessions (
-      id TEXT PRIMARY KEY
-    );
-    CREATE TABLE IF NOT EXISTS events (
-      session_id TEXT NOT NULL,
-      seq INTEGER NOT NULL,
-      ts INTEGER NOT NULL,
-      payload TEXT NOT NULL,
-      PRIMARY KEY (session_id, seq),
-      FOREIGN KEY (session_id) REFERENCES sessions(id)
-    );
-    CREATE INDEX IF NOT EXISTS idx_events_session_seq
-      ON events (session_id, seq);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS meta (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS sessions (
+      id TEXT PRIMARY KEY
+    );
+    CREATE TABLE IF NOT EXISTS events (
+      session_id TEXT NOT NULL,
+      seq INTEGER NOT NULL,
+      ts INTEGER NOT NULL,
+      payload TEXT NOT NULL,
+      PRIMARY KEY (session_id, seq),
+      FOREIGN KEY (session_id) REFERENCES sessions(id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_events_session_seq
+      ON events (session_id, seq);
   `);
     ensureFts(db);
     const current = schemaVersion(db);
@@ -149,16 +151,16 @@ function nextSeqFromDb(db, sessionId) {
 }
 function hasTurnStartInDb(db, sessionId) {
     const row = db
-        .prepare(`SELECT 1 AS hit FROM events
-       WHERE session_id = ? AND json_extract(payload, '$.type') = 'turn/start'
+        .prepare(`SELECT 1 AS hit FROM events
+       WHERE session_id = ? AND json_extract(payload, '$.type') = 'turn/start'
        LIMIT 1`)
         .get(sessionId);
     return row !== undefined;
 }
 function hasCommandRunInDb(db, sessionId) {
     const row = db
-        .prepare(`SELECT 1 AS hit FROM events
-       WHERE session_id = ? AND json_extract(payload, '$.type') = 'command/run'
+        .prepare(`SELECT 1 AS hit FROM events
+       WHERE session_id = ? AND json_extract(payload, '$.type') = 'command/run'
        LIMIT 1`)
         .get(sessionId);
     return row !== undefined;
@@ -184,17 +186,40 @@ function loadSessionIds(db) {
  */
 export function createPersistentSessionStore(dir, options = {}) {
     const maxResident = options.maxResidentSessions ?? DEFAULT_MAX_RESIDENT_SESSIONS;
+    const shared = Boolean(options.shared);
     const root = path.resolve(dir);
     mkdirSync(root, { recursive: true });
+    const writeLock = shared
+        ? undefined
+        : acquireSessionsDirLock(root);
     const dbPath = path.join(root, DB_NAME);
-    const db = openDatabase(dbPath);
-    initSchema(db);
+    let db;
+    try {
+        db = openDatabase(dbPath, shared);
+        if (!shared) {
+            initSchema(db);
+        }
+    }
+    catch (err) {
+        writeLock?.release();
+        throw err;
+    }
+    const assertWritable = () => {
+        if (shared) {
+            throw new Error("persistent session store is read-only when opened with { shared: true }");
+        }
+    };
     const sessionIds = loadSessionIds(db);
     const sessions = new Map();
     const residentOrder = [];
     let onEvict;
     const nextSeqBySession = new Map();
     let pending = [];
+    const restoreSeqMap = (snapshot) => {
+        nextSeqBySession.clear();
+        for (const [k, v] of snapshot)
+            nextSeqBySession.set(k, v);
+    };
     const touchResident = (id) => {
         const idx = residentOrder.indexOf(id);
         if (idx >= 0)
@@ -228,9 +253,15 @@ export function createPersistentSessionStore(dir, options = {}) {
                 residentOrder.splice(idx, 1);
         }
     };
-    const insertSession = db.prepare("INSERT INTO sessions (id) VALUES (?)");
-    const insertEvent = db.prepare("INSERT INTO events (session_id, seq, ts, payload) VALUES (?, ?, ?, ?)");
-    const insertFts = db.prepare("INSERT INTO search_fts (session_id, seq, text) VALUES (?, ?, ?)");
+    const insertSession = shared
+        ? undefined
+        : db.prepare("INSERT INTO sessions (id) VALUES (?)");
+    const insertEvent = shared
+        ? undefined
+        : db.prepare("INSERT INTO events (session_id, seq, ts, payload) VALUES (?, ?, ?, ?)");
+    const insertFts = shared
+        ? undefined
+        : db.prepare("INSERT INTO search_fts (session_id, seq, text) VALUES (?, ?, ?)");
     const allocateSeq = (sessionId) => {
         let next = nextSeqBySession.get(sessionId);
         if (next === undefined) {
@@ -247,11 +278,13 @@ export function createPersistentSessionStore(dir, options = {}) {
             insertFts.run(sessionId, seq, text);
     };
     const flushPending = () => {
-        if (pending.length === 0)
+        if (shared || pending.length === 0)
             return;
+        const batch = pending;
+        pending = [];
         const order = [];
         const bySession = new Map();
-        for (const row of pending) {
+        for (const row of batch) {
             let list = bySession.get(row.sessionId);
             if (!list) {
                 list = [];
@@ -260,7 +293,7 @@ export function createPersistentSessionStore(dir, options = {}) {
             }
             list.push(row.event);
         }
-        pending = [];
+        const seqSnapshot = new Map(nextSeqBySession);
         db.exec("BEGIN IMMEDIATE");
         try {
             for (const sessionId of order) {
@@ -272,7 +305,16 @@ export function createPersistentSessionStore(dir, options = {}) {
             db.exec("COMMIT");
         }
         catch (err) {
-            db.exec("ROLLBACK");
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                /* already rolled back / closed */
+            }
+            restoreSeqMap(seqSnapshot);
+            // Prepend failed batch so later flush/close can retry; keep any events
+            // appended while this flush ran.
+            pending = batch.concat(pending);
             throw err;
         }
     };
@@ -295,11 +337,30 @@ export function createPersistentSessionStore(dir, options = {}) {
         const events = loadSessionEvents(db, id);
         const repairs = repairOpenTurnEvents(events);
         if (repairs.length > 0) {
-            for (const ev of repairs) {
-                const frozen = deepFreeze(structuredClone(assertSessionEvent(ev)));
-                events.push(frozen);
-                persistImmediate(id, frozen);
+            const frozenRepairs = repairs.map((ev) => deepFreeze(structuredClone(assertSessionEvent(ev))));
+            if (!shared) {
+                const seqSnapshot = new Map(nextSeqBySession);
+                db.exec("BEGIN IMMEDIATE");
+                try {
+                    for (const frozen of frozenRepairs) {
+                        persistImmediate(id, frozen);
+                    }
+                    db.exec("COMMIT");
+                }
+                catch (err) {
+                    try {
+                        db.exec("ROLLBACK");
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    restoreSeqMap(seqSnapshot);
+                    throw err;
+                }
             }
+            // Shared: apply repair in memory only (read-only DB). Exclusive: durable
+            // first, then memory — crash between COMMIT and push re-repairs on reload.
+            events.push(...frozenRepairs);
         }
         sessions.set(id, events);
         touchResident(id);
@@ -307,6 +368,7 @@ export function createPersistentSessionStore(dir, options = {}) {
     };
     return {
         create(id = newSessionId()) {
+            assertWritable();
             const sid = assertSafeId(id);
             if (sessionIds.has(sid)) {
                 throw new Error(`session already exists: ${sid}`);
@@ -330,14 +392,29 @@ export function createPersistentSessionStore(dir, options = {}) {
             return sessionIds.has(id);
         },
         append(id, event) {
+            assertWritable();
             if (!sessionIds.has(id)) {
                 throw new Error(`session not found: ${id}`);
             }
             const events = ensureLoaded(id);
             const parsed = assertSessionEvent(event);
             const frozen = deepFreeze(structuredClone(parsed));
-            persistEvent(id, frozen);
             events.push(frozen);
+            try {
+                persistEvent(id, frozen);
+            }
+            catch (err) {
+                events.pop();
+                // flushPending restores the whole batch on ROLLBACK; drop only this
+                // append so prior pending chunks remain retryable.
+                for (let i = pending.length - 1; i >= 0; i -= 1) {
+                    if (pending[i].event === frozen) {
+                        pending.splice(i, 1);
+                        break;
+                    }
+                }
+                throw err;
+            }
             return frozen;
         },
         list() {
@@ -379,12 +456,17 @@ export function createPersistentSessionStore(dir, options = {}) {
             flushPending();
         },
         close() {
-            flushPending();
             try {
-                db.close();
+                flushPending();
             }
-            catch {
-                /* already closed */
+            finally {
+                try {
+                    db.close();
+                }
+                catch {
+                    /* already closed */
+                }
+                writeLock?.release();
             }
         },
         eventsRef(id) {