@frontmcp/storage-sqlite 1.8.6 → 1.8.7

package/encryption.d.ts

@@ -4,6 +4,14 @@
  * Provides AES-256-GCM encryption for stored values using @frontmcp/utils crypto.
  * Keys are stored in plaintext (needed for lookups); only values are encrypted.
  */
+/**
+ * Thrown when a stored value cannot be decrypted: the encryption secret differs
+ * from the one the value was written with, or the value was tampered with.
+ */
+export declare class SqliteDecryptionError extends Error {
+    readonly code = "SQLITE_DECRYPTION_FAILED";
+    constructor();
+}
 /**
  * Derives a 256-bit encryption key from a user-provided secret using HKDF-SHA256.
  *

package/encryption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAG9D;AAQD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYvE"}
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,8BAA8B;;CAS5C;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAG9D;AAQD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAevE"}

package/esm/index.mjs

@@ -1,5 +1,6 @@
-import { createRequire as __frontmcpCreateRequire } from 'module';
-const require = __frontmcpCreateRequire(import.meta.url || 'file:///');
+const __frontmcpModule = typeof process !== "undefined" && typeof process.getBuiltinModule === "function" ? process.getBuiltinModule("module") : undefined;
+const require = __frontmcpModule ? __frontmcpModule.createRequire(import.meta.url || 'file:///') : undefined;
+// __frontmcpCreateRequire
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
@@ -9,13 +10,22 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // libs/storage-sqlite/src/encryption.ts
 import {
-  encryptAesGcm,
+  base64urlDecode,
+  base64urlEncode,
   decryptAesGcm,
+  encryptAesGcm,
   hkdfSha256,
-  randomBytes,
-  base64urlEncode,
-  base64urlDecode
+  randomBytes
 } from "@frontmcp/utils";
+var SqliteDecryptionError = class extends Error {
+  code = "SQLITE_DECRYPTION_FAILED";
+  constructor() {
+    super(
+      "SqliteKvStore: failed to decrypt a stored value. The encryption secret differs from the one the database was written with (or the value is corrupted). Restore the original secret, or delete the database file to start empty."
+    );
+    this.name = "SqliteDecryptionError";
+  }
+};
 var HKDF_SALT = new TextEncoder().encode("frontmcp-sqlite-storage-v1");
 var HKDF_INFO = new TextEncoder().encode("aes-256-gcm-value-encryption");
 var KEY_LENGTH = 32;
@@ -38,8 +48,11 @@ function decryptValue(key, encrypted) {
   const iv = base64urlDecode(parts[0]);
   const tag = base64urlDecode(parts[1]);
   const ciphertext = base64urlDecode(parts[2]);
-  const plaintext = decryptAesGcm(key, ciphertext, iv, tag);
-  return new TextDecoder().decode(plaintext);
+  try {
+    return new TextDecoder().decode(decryptAesGcm(key, ciphertext, iv, tag));
+  } catch {
+    throw new SqliteDecryptionError();
+  }
 }
 
 // libs/storage-sqlite/src/open-database.ts
@@ -58,7 +71,27 @@ function loadBetterSqlite3() {
 
 // libs/storage-sqlite/src/open-database.ts
 var MEMORY_PATH = ":memory:";
-function openDatabase(path, storeName) {
+var DEFAULT_BUSY_TIMEOUT_MS = 5e3;
+function isBusyError(err) {
+  const code = err?.code;
+  return code === "SQLITE_BUSY" || code === "SQLITE_BUSY_RECOVERY" || code === "SQLITE_BUSY_SNAPSHOT";
+}
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function withBusyRetry(operation, options = {}) {
+  const attempts = options.attempts ?? 5;
+  const delayMs = options.delayMs ?? 50;
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return operation();
+    } catch (err) {
+      if (!isBusyError(err) || attempt >= attempts) throw err;
+      sleepSync(delayMs * attempt);
+    }
+  }
+}
+function openDatabase(path, storeName, options = {}) {
   const BetterSqlite3 = loadBetterSqlite3();
   if (path !== MEMORY_PATH && path !== "") {
     const dir = dirname(path);
@@ -67,16 +100,28 @@ function openDatabase(path, storeName) {
         ensureDirSync(dir);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`${storeName}: failed to create directory "${dir}" for database "${path}": ${message}`);
+        throw new Error(`${storeName}: failed to create directory "${dir}" for database "${path}": ${message}`, {
+          cause: err
+        });
       }
     }
   }
+  let db;
+  try {
+    db = new BetterSqlite3(path);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`${storeName}: failed to open database at "${path}": ${message}`, { cause: err });
+  }
   try {
-    return new BetterSqlite3(path);
+    db.pragma(`busy_timeout = ${Math.max(0, Math.floor(options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS))}`);
+    if (options.walMode) withBusyRetry(() => db.pragma("journal_mode = WAL"));
   } catch (err) {
+    db.close();
     const message = err instanceof Error ? err.message : String(err);
-    throw new Error(`${storeName}: failed to open database at "${path}": ${message}`);
+    throw new Error(`${storeName}: failed to configure database at "${path}": ${message}`, { cause: err });
   }
+  return db;
 }
 
 // libs/storage-sqlite/src/sqlite-kv.store.ts
@@ -86,14 +131,14 @@ var SqliteKvStore = class {
   cleanupTimer = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteKvStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteKvStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     if (options.encryption?.secret) {
       this.encryptionKey = deriveEncryptionKey(options.encryption.secret);
     }
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -560,17 +605,17 @@ var SqliteTaskStore = class {
   encryptionKey = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteTaskStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteTaskStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     this.logger = options.logger;
     this.liveness = options.livenessProbe ?? defaultLivenessProbe;
     if (options.encryption?.secret) {
       this.encryptionKey = deriveEncryptionKey(options.encryption.secret);
     }
     this.emitter.setMaxListeners(200);
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -809,13 +854,13 @@ var SqliteEventStore = class {
   cleanupTimer = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteEventStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteEventStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     this.maxEvents = options.maxEvents ?? 1e4;
     this.ttlMs = options.ttlMs ?? 3e5;
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -952,9 +997,11 @@ var sqliteStorageOptionsSchema = z.object({
     secret: z.string().min(1)
   }).optional(),
   ttlCleanupIntervalMs: z.number().int().nonnegative().optional().default(6e4),
-  walMode: z.boolean().optional().default(true)
+  walMode: z.boolean().optional().default(true),
+  busyTimeoutMs: z.number().int().nonnegative().optional().default(5e3)
 });
 export {
+  SqliteDecryptionError,
   SqliteElicitationStore,
   SqliteEventStore,
   SqliteKvStore,
@@ -966,5 +1013,6 @@ export {
   encryptValue,
   loadBetterSqlite3,
   openDatabase,
-  sqliteStorageOptionsSchema
+  sqliteStorageOptionsSchema,
+  withBusyRetry
 };

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/storage-sqlite",
-  "version": "1.8.6",
+  "version": "1.8.7",
   "description": "SQLite storage backend for FrontMCP - local session, elicitation, and event persistence without Redis",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -44,11 +44,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "1.8.6",
+    "@frontmcp/utils": "1.8.7",
     "better-sqlite3": "^12.6.2"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.6"
+    "@frontmcp/lazy-zod": "1.8.7"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/index.d.ts

@@ -6,7 +6,8 @@
  */
 export { SqliteKvStore } from './sqlite-kv.store';
 export { SqliteStorageAdapter } from './sqlite-storage.adapter';
-export { openDatabase } from './open-database';
+export { openDatabase, withBusyRetry } from './open-database';
+export type { OpenDatabaseOptions, BusyRetryOptions } from './open-database';
 export { loadBetterSqlite3 } from './better-sqlite3-loader';
 export { SqliteSessionStore } from './sqlite-session.store';
 export type { SqliteSessionStoreOptions, SessionStoreInterface, StoredSessionData } from './sqlite-session.store';
@@ -16,7 +17,7 @@ export { SqliteTaskStore } from './sqlite-task.store';
 export type { SqliteTaskStoreOptions, TaskStoreInterface, TaskRecord as SqliteTaskRecord, TaskStatus as SqliteTaskStatus, TaskOutcome as SqliteTaskOutcome, TaskListPage as SqliteTaskListPage, ProcessLivenessProbe, SqliteTaskLogger, } from './sqlite-task.store';
 export { SqliteEventStore } from './sqlite-event.store';
 export type { SqliteEventStoreOptions, EventStoreInterface } from './sqlite-event.store';
-export { deriveEncryptionKey, encryptValue, decryptValue } from './encryption';
+export { deriveEncryptionKey, encryptValue, decryptValue, SqliteDecryptionError } from './encryption';
 export { sqliteStorageOptionsSchema } from './sqlite.options';
 export type { SqliteStorageOptions, SqliteStorageOptionsInput, SqliteStorageOptionsParsed } from './sqlite.options';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,IAAI,gBAAgB,EAC9B,UAAU,IAAI,gBAAgB,EAC9B,WAAW,IAAI,iBAAiB,EAChC,YAAY,IAAI,kBAAkB,EAClC,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC3G,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,IAAI,gBAAgB,EAC9B,UAAU,IAAI,gBAAgB,EAC9B,WAAW,IAAI,iBAAiB,EAChC,YAAY,IAAI,kBAAkB,EAClC,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // libs/storage-sqlite/src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  SqliteDecryptionError: () => SqliteDecryptionError,
   SqliteElicitationStore: () => SqliteElicitationStore,
   SqliteEventStore: () => SqliteEventStore,
   SqliteKvStore: () => SqliteKvStore,
@@ -31,12 +32,22 @@ __export(index_exports, {
   encryptValue: () => encryptValue,
   loadBetterSqlite3: () => loadBetterSqlite3,
   openDatabase: () => openDatabase,
-  sqliteStorageOptionsSchema: () => sqliteStorageOptionsSchema
+  sqliteStorageOptionsSchema: () => sqliteStorageOptionsSchema,
+  withBusyRetry: () => withBusyRetry
 });
 module.exports = __toCommonJS(index_exports);
 
 // libs/storage-sqlite/src/encryption.ts
 var import_utils = require("@frontmcp/utils");
+var SqliteDecryptionError = class extends Error {
+  code = "SQLITE_DECRYPTION_FAILED";
+  constructor() {
+    super(
+      "SqliteKvStore: failed to decrypt a stored value. The encryption secret differs from the one the database was written with (or the value is corrupted). Restore the original secret, or delete the database file to start empty."
+    );
+    this.name = "SqliteDecryptionError";
+  }
+};
 var HKDF_SALT = new TextEncoder().encode("frontmcp-sqlite-storage-v1");
 var HKDF_INFO = new TextEncoder().encode("aes-256-gcm-value-encryption");
 var KEY_LENGTH = 32;
@@ -59,8 +70,11 @@ function decryptValue(key, encrypted) {
   const iv = (0, import_utils.base64urlDecode)(parts[0]);
   const tag = (0, import_utils.base64urlDecode)(parts[1]);
   const ciphertext = (0, import_utils.base64urlDecode)(parts[2]);
-  const plaintext = (0, import_utils.decryptAesGcm)(key, ciphertext, iv, tag);
-  return new TextDecoder().decode(plaintext);
+  try {
+    return new TextDecoder().decode((0, import_utils.decryptAesGcm)(key, ciphertext, iv, tag));
+  } catch {
+    throw new SqliteDecryptionError();
+  }
 }
 
 // libs/storage-sqlite/src/open-database.ts
@@ -79,7 +93,27 @@ function loadBetterSqlite3() {
 
 // libs/storage-sqlite/src/open-database.ts
 var MEMORY_PATH = ":memory:";
-function openDatabase(path, storeName) {
+var DEFAULT_BUSY_TIMEOUT_MS = 5e3;
+function isBusyError(err) {
+  const code = err?.code;
+  return code === "SQLITE_BUSY" || code === "SQLITE_BUSY_RECOVERY" || code === "SQLITE_BUSY_SNAPSHOT";
+}
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function withBusyRetry(operation, options = {}) {
+  const attempts = options.attempts ?? 5;
+  const delayMs = options.delayMs ?? 50;
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return operation();
+    } catch (err) {
+      if (!isBusyError(err) || attempt >= attempts) throw err;
+      sleepSync(delayMs * attempt);
+    }
+  }
+}
+function openDatabase(path, storeName, options = {}) {
   const BetterSqlite3 = loadBetterSqlite3();
   if (path !== MEMORY_PATH && path !== "") {
     const dir = (0, import_utils2.dirname)(path);
@@ -88,16 +122,28 @@ function openDatabase(path, storeName) {
         (0, import_utils2.ensureDirSync)(dir);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        throw new Error(`${storeName}: failed to create directory "${dir}" for database "${path}": ${message}`);
+        throw new Error(`${storeName}: failed to create directory "${dir}" for database "${path}": ${message}`, {
+          cause: err
+        });
       }
     }
   }
+  let db;
+  try {
+    db = new BetterSqlite3(path);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`${storeName}: failed to open database at "${path}": ${message}`, { cause: err });
+  }
   try {
-    return new BetterSqlite3(path);
+    db.pragma(`busy_timeout = ${Math.max(0, Math.floor(options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS))}`);
+    if (options.walMode) withBusyRetry(() => db.pragma("journal_mode = WAL"));
   } catch (err) {
+    db.close();
     const message = err instanceof Error ? err.message : String(err);
-    throw new Error(`${storeName}: failed to open database at "${path}": ${message}`);
+    throw new Error(`${storeName}: failed to configure database at "${path}": ${message}`, { cause: err });
   }
+  return db;
 }
 
 // libs/storage-sqlite/src/sqlite-kv.store.ts
@@ -107,14 +153,14 @@ var SqliteKvStore = class {
   cleanupTimer = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteKvStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteKvStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     if (options.encryption?.secret) {
       this.encryptionKey = deriveEncryptionKey(options.encryption.secret);
     }
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -581,17 +627,17 @@ var SqliteTaskStore = class {
   encryptionKey = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteTaskStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteTaskStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     this.logger = options.logger;
     this.liveness = options.livenessProbe ?? defaultLivenessProbe;
     if (options.encryption?.secret) {
       this.encryptionKey = deriveEncryptionKey(options.encryption.secret);
     }
     this.emitter.setMaxListeners(200);
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -830,13 +876,13 @@ var SqliteEventStore = class {
   cleanupTimer = null;
   stmts = null;
   constructor(options) {
-    this.db = openDatabase(options.path, "SqliteEventStore");
-    if (options.walMode !== false) {
-      this.db.pragma("journal_mode = WAL");
-    }
+    this.db = openDatabase(options.path, "SqliteEventStore", {
+      busyTimeoutMs: options.busyTimeoutMs,
+      walMode: options.walMode !== false
+    });
     this.maxEvents = options.maxEvents ?? 1e4;
     this.ttlMs = options.ttlMs ?? 3e5;
-    this.initSchema();
+    withBusyRetry(() => this.initSchema());
     this.prepareStatements();
     const cleanupInterval = options.ttlCleanupIntervalMs ?? 6e4;
     if (cleanupInterval > 0) {
@@ -973,10 +1019,12 @@ var sqliteStorageOptionsSchema = import_lazy_zod.z.object({
     secret: import_lazy_zod.z.string().min(1)
   }).optional(),
   ttlCleanupIntervalMs: import_lazy_zod.z.number().int().nonnegative().optional().default(6e4),
-  walMode: import_lazy_zod.z.boolean().optional().default(true)
+  walMode: import_lazy_zod.z.boolean().optional().default(true),
+  busyTimeoutMs: import_lazy_zod.z.number().int().nonnegative().optional().default(5e3)
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SqliteDecryptionError,
   SqliteElicitationStore,
   SqliteEventStore,
   SqliteKvStore,
@@ -988,5 +1036,6 @@ var sqliteStorageOptionsSchema = import_lazy_zod.z.object({
   encryptValue,
   loadBetterSqlite3,
   openDatabase,
-  sqliteStorageOptionsSchema
+  sqliteStorageOptionsSchema,
+  withBusyRetry
 });

package/open-database.d.ts

@@ -12,14 +12,33 @@
  * 2. **ESM-safe native module load.** See {@link loadBetterSqlite3}.
  */
 import type Database from 'better-sqlite3';
+/** How long a connection waits on another process's lock before SQLITE_BUSY. */
+export declare const DEFAULT_BUSY_TIMEOUT_MS = 5000;
+export interface OpenDatabaseOptions {
+    /** Milliseconds to wait for a lock held by another connection or process. @default 5000 */
+    busyTimeoutMs?: number;
+    /** Switch the database to WAL journaling. @default false */
+    walMode?: boolean;
+}
+export interface BusyRetryOptions {
+    attempts?: number;
+    delayMs?: number;
+}
+/**
+ * Run a synchronous SQLite operation, retrying while it reports `SQLITE_BUSY`.
+ * `busy_timeout` covers ordinary lock waits; a few statements (the WAL switch,
+ * schema changes racing another process's first open) can still fail fast.
+ */
+export declare function withBusyRetry<T>(operation: () => T, options?: BusyRetryOptions): T;
 /**
  * Open (or create) a better-sqlite3 database at `path`, creating the parent
  * directory if necessary.
  *
  * @param path - Filesystem path to the `.sqlite` file, or `:memory:`.
  * @param storeName - Name used in error messages (e.g. `'SqliteKvStore'`).
+ * @param options - `busyTimeoutMs` (set before anything else touches the file) and `walMode`.
  * @returns An open better-sqlite3 `Database` instance.
  * @throws Error wrapping the underlying failure with the store name and path.
  */
-export declare function openDatabase(path: string, storeName: string): Database.Database;
+export declare function openDatabase(path: string, storeName: string, options?: OpenDatabaseOptions): Database.Database;
 //# sourceMappingURL=open-database.d.ts.map

package/open-database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-database.d.ts","sourceRoot":"","sources":["../src/open-database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAS3C;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAwB/E"}
+{"version":3,"file":"open-database.d.ts","sourceRoot":"","sources":["../src/open-database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAS3C,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,CAAC,CAWtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,QAAQ,CAAC,QAAQ,CAuClH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/storage-sqlite",
-  "version": "1.8.6",
+  "version": "1.8.7",
   "description": "SQLite storage backend for FrontMCP - local session, elicitation, and event persistence without Redis",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -44,11 +44,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "1.8.6",
+    "@frontmcp/utils": "1.8.7",
     "better-sqlite3": "^12.6.2"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.6"
+    "@frontmcp/lazy-zod": "1.8.7"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/sqlite-event.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-event.store.d.ts","sourceRoot":"","sources":["../src/sqlite-event.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACxE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAmC;gBAEpC,OAAO,EAAE,uBAAuB;IAwB5C,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBhB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/D,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnE,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,CAAC;IAyBlB,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAIjB;CACF"}
+{"version":3,"file":"sqlite-event.store.d.ts","sourceRoot":"","sources":["../src/sqlite-event.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChE,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACxE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB;;;;OAIG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAmC;gBAEpC,OAAO,EAAE,uBAAuB;IAuB5C,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBhB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/D,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKnE,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,CAAC;IAyBlB,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAIjB;CACF"}

package/sqlite-kv.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-kv.store.d.ts","sourceRoot":"","sources":["../src/sqlite-kv.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAe7D;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAqC;gBAEtC,OAAO,EAAE,oBAAoB;IA4BzC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB/B;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAW3C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASrD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAchC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAM3C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAexB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAKtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;CAGjC"}
+{"version":3,"file":"sqlite-kv.store.d.ts","sourceRoot":"","sources":["../src/sqlite-kv.store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAe7D;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,KAAK,CAAqC;gBAEtC,OAAO,EAAE,oBAAoB;IA0BzC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmB/B;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAW3C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASrD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAchC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAM3C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAexB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAKtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;CAGjC"}

package/sqlite-task.store.d.ts.map

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

package/sqlite.options.d.ts

@@ -28,6 +28,12 @@ export interface SqliteStorageOptions {
      * @default true
      */
     walMode?: boolean;
+    /**
+     * Milliseconds a connection waits for a lock held by another process before
+     * failing with SQLITE_BUSY.
+     * @default 5000
+     */
+    busyTimeoutMs?: number;
 }
 /**
  * Zod schema for SQLite storage configuration.
@@ -39,6 +45,7 @@ export declare const sqliteStorageOptionsSchema: import("@frontmcp/lazy-zod").Zo
     }, import("zod/v4/core").$strip>>;
     ttlCleanupIntervalMs: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>>;
     walMode: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodBoolean>>;
+    busyTimeoutMs: import("@frontmcp/lazy-zod").ZodDefault<import("@frontmcp/lazy-zod").ZodOptional<import("@frontmcp/lazy-zod").ZodNumber>>;
 }, import("zod/v4/core").$strip>;
 /**
  * SQLite storage input type (before Zod defaults).

package/sqlite.options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.options.d.ts","sourceRoot":"","sources":["../src/sqlite.options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE;QACX,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;gCASrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"sqlite.options.d.ts","sourceRoot":"","sources":["../src/sqlite.options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,oBAAoB,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,UAAU,CAAC,EAAE;QACX,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;gCAUrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}