@mastra/libsql 1.27.0-alpha.1 → 1.27.0-alpha.2

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-libsql
 description: Documentation for @mastra/libsql. Use when working with @mastra/libsql APIs, configuration, or implementation.
 metadata:
   package: "@mastra/libsql"
-  version: "1.27.0-alpha.1"
+  version: "1.27.0-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.27.0-alpha.1",
+  "version": "1.27.0-alpha.2",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -403,6 +403,8 @@ Memory uses a single embedder for both storing and recalling messages, so pick o
 
 Multilingual E5 produces 1024-dimensional vectors. Your vector index must be created with matching dimensions, and E5 vectors can't be mixed with vectors from another embedder in the same index.
 
+FastEmbed models embed at most 512 tokens per input (roughly 2,000 to 2,500 characters of English text). Longer inputs are truncated, so text past the limit doesn't affect the embedding and can't be found by semantic recall. The AI SDK v3 FastEmbed models return a warning when this happens. The legacy v1 and v2 models don't. If you embed long documents with FastEmbed, chunk them to fit the window, for example with `maxSize: 1500` in `MDocument.chunk()`.
+
 ## PostgreSQL index optimization
 
 When using PostgreSQL as your vector store, you can optimize semantic recall performance by configuring the vector index. This is particularly important for large-scale deployments with thousands of messages.

package/dist/index.cjs

@@ -1645,6 +1645,27 @@ function buildSelectColumnsWithAlias(tableName, alias) {
 function isLockError(error) {
 	return error.code === "SQLITE_BUSY" || error.code === "SQLITE_LOCKED" || error.message?.toLowerCase().includes("database is locked") || error.message?.toLowerCase().includes("database table is locked") || error.message?.toLowerCase().includes("table is locked") || error.constructor.name === "SqliteError" && error.message?.toLowerCase().includes("locked");
 }
+const TRANSIENT_NETWORK_PATTERNS = [
+	"fetch failed",
+	"econnreset",
+	"etimedout",
+	"eai_again",
+	"socket hang up",
+	"und_err_"
+];
+/**
+* Checks if an error (or any error in its `cause` chain) is a transient network failure
+* such as `fetch failed` from a remote libsql client.
+*/
+function isTransientNetworkError(error) {
+	let current = error;
+	for (let depth = 0; current && depth < 5; depth++) {
+		const text = `${current.message ?? ""} ${current.code ?? ""}`.toLowerCase();
+		if (TRANSIENT_NETWORK_PATTERNS.some((pattern) => text.includes(pattern))) return true;
+		current = current.cause;
+	}
+	return false;
+}
 function createExecuteWriteOperationWithRetry({ logger, maxRetries, initialBackoffMs }) {
 	return async function executeWriteOperationWithRetry(operationFn, operationDescription) {
 		let attempts = 0;
@@ -16584,6 +16605,8 @@ var LibSQLFactoryStorage = class extends _mastra_core_storage.FactoryStorage {
 };
 //#endregion
 //#region src/storage/index.ts
+const REMOTE_INIT_CONCURRENCY = 5;
+const REMOTE_INIT_MAX_ATTEMPTS = 3;
 const DEFAULT_LOCAL_CACHE_SIZE = -16e3;
 const DEFAULT_LOCAL_MMAP_SIZE = 134217728;
 /**
@@ -16730,8 +16753,31 @@ var LibSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		for (const store of this.getStoresToInit()) await store.init();
 		return true;
 	}
+	async initStoreWithRetry(store) {
+		for (let attempt = 1;; attempt++) try {
+			await store.init();
+			return;
+		} catch (error) {
+			if (attempt >= REMOTE_INIT_MAX_ATTEMPTS || !isTransientNetworkError(error)) throw error;
+			const backoff = this.initialBackoffMs * 2 ** (attempt - 1);
+			this.logger.warn(`LibSQLStore: Transient network error during domain init, retrying in ${backoff}ms (attempt ${attempt}/${REMOTE_INIT_MAX_ATTEMPTS}).`, error);
+			await new Promise((resolve) => setTimeout(resolve, backoff));
+		}
+	}
 	async initDomainsInParallel() {
-		await Promise.all(this.getStoresToInit().map((store) => store.init()));
+		const stores = this.getStoresToInit();
+		let next = 0;
+		let failed = false;
+		const worker = async () => {
+			while (!failed && next < stores.length) try {
+				await this.initStoreWithRetry(stores[next++]);
+			} catch (error) {
+				failed = true;
+				throw error;
+			}
+		};
+		const rejected = (await Promise.allSettled(Array.from({ length: Math.min(REMOTE_INIT_CONCURRENCY, stores.length) }, worker))).find((r) => r.status === "rejected");
+		if (rejected) throw rejected.reason;
 		return true;
 	}
 	async init() {
@@ -16742,7 +16788,10 @@ var LibSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 					await this.hasInitialized;
 					return;
 				}
-				this.hasInitialized = this.initDomainsInParallel();
+				this.hasInitialized = this.initDomainsInParallel().catch((error) => {
+					this.hasInitialized = null;
+					throw error;
+				});
 				await this.hasInitialized;
 				return;
 			}
@@ -16754,7 +16803,10 @@ var LibSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 				await this.hasInitialized;
 				return;
 			}
-			this.hasInitialized = this.initDomainsSequentially();
+			this.hasInitialized = this.initDomainsSequentially().catch((error) => {
+				this.hasInitialized = null;
+				throw error;
+			});
 			await this.hasInitialized;
 			return;
 		}