@mastra/libsql 1.22.3-alpha.0 → 1.22.3-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.22.3-alpha.0"
+  version: "1.22.3-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/index.cjs

@@ -5,6 +5,8 @@ let _mastra_core_storage = require("@mastra/core/storage");
 let _mastra_core_utils = require("@mastra/core/utils");
 let _mastra_core_vector = require("@mastra/core/vector");
 let _mastra_core_vector_filter = require("@mastra/core/vector/filter");
+let fs_promises = require("fs/promises");
+let path = require("path");
 let _mastra_core_base = require("@mastra/core/base");
 let crypto$1 = require("crypto");
 let _mastra_core_agent = require("@mastra/core/agent");
@@ -385,6 +387,31 @@ const processOperator = (key, operator, operatorValue) => {
 	};
 };
 //#endregion
+//#region src/vector/write-lock.ts
+const databaseWriteChains = /* @__PURE__ */ new Map();
+async function getLocalFileDatabaseKey({ url, syncUrl, cwd }) {
+	if (!url.startsWith("file:") || url.includes(":memory:") || syncUrl) return;
+	const uriPath = url.slice(5).split(/[?#]/, 1)[0];
+	const decodedPath = decodeURIComponent(uriPath);
+	const absolutePath = (0, path.isAbsolute)(decodedPath) ? decodedPath : (0, path.resolve)(cwd, decodedPath);
+	try {
+		return await (0, fs_promises.realpath)(absolutePath);
+	} catch (error) {
+		if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") throw error;
+	}
+	return (0, path.join)(await (0, fs_promises.realpath)((0, path.dirname)(absolutePath)), (0, path.basename)(absolutePath));
+}
+function withLocalFileDatabaseWriteLock(key, fn) {
+	if (!key) return fn();
+	const result = (databaseWriteChains.get(key) ?? Promise.resolve()).then(fn, fn);
+	const tail = result.then(() => void 0, () => void 0);
+	databaseWriteChains.set(key, tail);
+	tail.then(() => {
+		if (databaseWriteChains.get(key) === tail) databaseWriteChains.delete(key);
+	});
+	return result;
+}
+//#endregion
 //#region src/vector/index.ts
 var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	turso;
@@ -392,25 +419,57 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	initialBackoffMs;
 	overFetchMultiplier;
 	isMemoryDb;
-	vectorIndexes;
+	initialization;
+	databaseKey;
+	vectorIndexes = /* @__PURE__ */ new Set();
 	constructor({ url, authToken, syncUrl, syncInterval, maxRetries = 5, initialBackoffMs = 100, vectorTopKOverFetchMultiplier = 10, id }) {
 		super({ id });
+		this.isMemoryDb = url.includes(":memory:");
+		const isLocalDb = (url.startsWith("file:") || this.isMemoryDb) && !syncUrl;
+		const cwd = process.cwd();
 		this.turso = (0, _libsql_client.createClient)({
 			url,
 			syncUrl,
 			authToken,
-			syncInterval
+			syncInterval,
+			...isLocalDb ? { timeout: 5e3 } : {}
 		});
 		this.maxRetries = maxRetries;
 		this.initialBackoffMs = initialBackoffMs;
 		if (!Number.isInteger(vectorTopKOverFetchMultiplier) || vectorTopKOverFetchMultiplier < 1) throw new Error("vectorTopKOverFetchMultiplier must be a positive integer");
 		this.overFetchMultiplier = vectorTopKOverFetchMultiplier;
-		this.isMemoryDb = url.includes(":memory:");
-		if (url.includes(`file:`) || this.isMemoryDb) {
-			this.turso.execute("PRAGMA journal_mode=WAL;").then(() => this.logger.debug("LibSQLStore: PRAGMA journal_mode=WAL set.")).catch((err) => this.logger.warn("LibSQLStore: Failed to set PRAGMA journal_mode=WAL.", err));
-			this.turso.execute("PRAGMA busy_timeout = 5000;").then(() => this.logger.debug("LibSQLStore: PRAGMA busy_timeout=5000 set.")).catch((err) => this.logger.warn("LibSQLStore: Failed to set PRAGMA busy_timeout=5000.", err));
+		this.initialization = this.initialize({
+			url,
+			syncUrl,
+			cwd,
+			isLocalDb
+		});
+	}
+	async initialize({ url, syncUrl, cwd, isLocalDb }) {
+		if (isLocalDb) {
+			await this.applyLocalPragmas();
+			this.databaseKey = await getLocalFileDatabaseKey({
+				url,
+				syncUrl,
+				cwd
+			});
+		}
+		if (!this.isMemoryDb) this.vectorIndexes = await this.discoverVectorIndexes();
+	}
+	async applyLocalPragmas() {
+		for (const [label, sql] of [["journal_mode=WAL", "PRAGMA journal_mode=WAL;"], ["busy_timeout=5000", "PRAGMA busy_timeout = 5000;"]]) try {
+			await this.turso.execute(sql);
+			this.logger.debug(`LibSQLStore: PRAGMA ${label} set.`);
+		} catch (err) {
+			this.logger.warn(`LibSQLStore: Failed to set PRAGMA ${label}.`, err);
 		}
-		this.vectorIndexes = this.isMemoryDb ? Promise.resolve(/* @__PURE__ */ new Set()) : this.discoverVectorIndexes();
+	}
+	async ensureInitialized() {
+		await this.initialization;
+	}
+	async executeMutation(operation, isTransaction = false) {
+		await this.ensureInitialized();
+		return withLocalFileDatabaseWriteLock(this.databaseKey, () => this.executeWriteOperationWithRetry(operation, isTransaction));
 	}
 	/**
 	* Closes the underlying libsql client, releasing this vector store's OS file handles.
@@ -418,6 +477,7 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	* Safe to call more than once; subsequent calls are no-ops.
 	*/
 	async close() {
+		await this.ensureInitialized();
 		if (!this.turso.closed) this.turso.close();
 	}
 	async discoverVectorIndexes() {
@@ -453,8 +513,8 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	transformFilter(filter) {
 		return new LibSQLFilterTranslator().translate(filter);
 	}
-	async hasVectorIndex(parsedIndexName) {
-		return (await this.vectorIndexes).has(`${parsedIndexName}_vector_idx`);
+	hasVectorIndex(parsedIndexName) {
+		return this.vectorIndexes.has(`${parsedIndexName}_vector_idx`);
 	}
 	async queryWithIndex(parsedIndexName, vectorStr, topK, filter, includeVector, minScore) {
 		const { sql: filterQuery, values: filterValues } = buildFilterQuery(this.transformFilter(filter));
@@ -509,9 +569,10 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 			details: { message: "queryVector must be an array of finite numbers" }
 		});
 		try {
+			await this.ensureInitialized();
 			const parsedIndexName = (0, _mastra_core_utils.parseSqlIdentifier)(indexName, "index name");
 			const vectorStr = `[${queryVector.join(",")}]`;
-			if (!this.isMemoryDb && await this.hasVectorIndex(parsedIndexName)) try {
+			if (!this.isMemoryDb && this.hasVectorIndex(parsedIndexName)) try {
 				const indexedResults = await this.queryWithIndex(parsedIndexName, vectorStr, topK, filter, includeVector, minScore);
 				if (!filter || indexedResults.length >= topK) return indexedResults;
 			} catch (err) {
@@ -552,9 +613,9 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 			}, error);
 		}
 	}
-	upsert(args) {
+	async upsert(args) {
 		try {
-			return this.executeWriteOperationWithRetry(() => this.doUpsert(args), true);
+			return await this.executeMutation(() => this.doUpsert(args), true);
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createVectorErrorId)("LIBSQL", "UPSERT", "FAILED"),
@@ -602,9 +663,9 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 			throw error;
 		}
 	}
-	createIndex(args) {
+	async createIndex(args) {
 		try {
-			return this.executeWriteOperationWithRetry(() => this.doCreateIndex(args));
+			return await this.executeMutation(() => this.doCreateIndex(args));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createVectorErrorId)("LIBSQL", "CREATE_INDEX", "FAILED"),
@@ -638,11 +699,11 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
         `,
 			args: []
 		});
-		this.vectorIndexes.then((indexes) => indexes.add(`${parsedIndexName}_vector_idx`));
+		this.vectorIndexes.add(`${parsedIndexName}_vector_idx`);
 	}
-	deleteIndex(args) {
+	async deleteIndex(args) {
 		try {
-			return this.executeWriteOperationWithRetry(() => this.doDeleteIndex(args));
+			return await this.executeMutation(() => this.doDeleteIndex(args));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createVectorErrorId)("LIBSQL", "DELETE_INDEX", "FAILED"),
@@ -658,10 +719,11 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 			sql: `DROP TABLE IF EXISTS ${parsedIndexName}`,
 			args: []
 		});
-		this.vectorIndexes.then((indexes) => indexes.delete(`${parsedIndexName}_vector_idx`));
+		this.vectorIndexes.delete(`${parsedIndexName}_vector_idx`);
 	}
 	async listIndexes() {
 		try {
+			await this.ensureInitialized();
 			return (await this.turso.execute({
 				sql: `
         SELECT name FROM sqlite_master 
@@ -686,6 +748,7 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	*/
 	async describeIndex({ indexName }) {
 		try {
+			await this.ensureInitialized();
 			const parsedIndexName = (0, _mastra_core_utils.parseSqlIdentifier)(indexName, "index name");
 			const tableInfo = await this.turso.execute({
 				sql: `
@@ -731,7 +794,7 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	* @throws Will throw an error if no updates are provided or if the update operation fails.
 	*/
 	updateVector(args) {
-		return this.executeWriteOperationWithRetry(() => this.doUpdateVector(args));
+		return this.executeMutation(() => this.doUpdateVector(args));
 	}
 	async doUpdateVector(params) {
 		const { indexName, update } = params;
@@ -836,9 +899,9 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 	* @returns A promise that resolves when the deletion is complete.
 	* @throws Will throw an error if the deletion operation fails.
 	*/
-	deleteVector(args) {
+	async deleteVector(args) {
 		try {
-			return this.executeWriteOperationWithRetry(() => this.doDeleteVector(args));
+			return await this.executeMutation(() => this.doDeleteVector(args));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createVectorErrorId)("LIBSQL", "DELETE_VECTOR", "FAILED"),
@@ -859,7 +922,7 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 		});
 	}
 	deleteVectors(args) {
-		return this.executeWriteOperationWithRetry(() => this.doDeleteVectors(args));
+		return this.executeMutation(() => this.doDeleteVectors(args));
 	}
 	async doDeleteVectors({ indexName, filter, ids }) {
 		const parsedIndexName = (0, _mastra_core_utils.parseSqlIdentifier)(indexName, "index name");
@@ -941,9 +1004,9 @@ var LibSQLVector = class extends _mastra_core_vector.MastraVector {
 			}, error);
 		}
 	}
-	truncateIndex(args) {
+	async truncateIndex(args) {
 		try {
-			return this.executeWriteOperationWithRetry(() => this._doTruncateIndex(args));
+			return await this.executeMutation(() => this._doTruncateIndex(args));
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
 				id: (0, _mastra_core_storage.createVectorErrorId)("LIBSQL", "TRUNCATE_INDEX", "FAILED"),
@@ -2499,6 +2562,26 @@ var AgentsLibSQL = class extends _mastra_core_storage.AgentsStorage {
 			}, error);
 		}
 	}
+	async getVersions(ids) {
+		if (ids.length === 0) return [];
+		try {
+			return (await this.#db.selectMany({
+				tableName: _mastra_core_storage.TABLE_AGENT_VERSIONS,
+				whereClause: {
+					sql: `WHERE id IN (${ids.map(() => "?").join(", ")})`,
+					args: ids
+				}
+			}) ?? []).map((row) => this.parseVersionRow(row));
+		} catch (error) {
+			if (error instanceof _mastra_core_error.MastraError) throw error;
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "GET_VERSIONS", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { count: ids.length }
+			}, error);
+		}
+	}
 	async getVersionByNumber(agentId, versionNumber) {
 		try {
 			const rows = await this.#db.selectMany({
@@ -12242,6 +12325,24 @@ var SkillsLibSQL = class extends _mastra_core_storage.SkillsStorage {
 			}, error);
 		}
 	}
+	async getVersions(ids) {
+		if (ids.length === 0) return [];
+		try {
+			const placeholders = ids.map(() => "?").join(", ");
+			return ((await this.#client.execute({
+				sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_SKILL_VERSIONS)} FROM "${_mastra_core_storage.TABLE_SKILL_VERSIONS}" WHERE id IN (${placeholders})`,
+				args: ids
+			})).rows ?? []).map((row) => this.#parseVersionRow(row));
+		} catch (error) {
+			if (error instanceof _mastra_core_error.MastraError) throw error;
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "GET_SKILL_VERSIONS", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { count: ids.length }
+			}, error);
+		}
+	}
 	async getVersionByNumber(skillId, versionNumber) {
 		try {
 			const row = (await this.#client.execute({
@@ -12762,6 +12863,9 @@ function parseJson(val, column, rowId) {
 	}
 	return val;
 }
+function workflowDefinitionSelectColumns() {
+	return buildSelectColumns(_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS).replace("json(\"schedule\") as \"schedule\"", "\"schedule\"");
+}
 function rowToDefinition(row) {
 	const inputSchema = parseJson(row.inputSchema, "inputSchema", row.id);
 	const outputSchema = parseJson(row.outputSchema, "outputSchema", row.id);
@@ -12784,6 +12888,12 @@ function rowToDefinition(row) {
 	if (stateSchema !== void 0) def.stateSchema = stateSchema;
 	const requestContextSchema = parseJson(row.requestContextSchema, "requestContextSchema", row.id);
 	if (requestContextSchema !== void 0) def.requestContextSchema = requestContextSchema;
+	try {
+		const schedule = parseJson(row.schedule, "schedule", row.id);
+		if (schedule != null) def.schedule = schedule;
+	} catch {
+		def.schedule = row.schedule;
+	}
 	if (row.authorId != null) def.authorId = String(row.authorId);
 	return def;
 }
@@ -12805,6 +12915,11 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 			tableName: _mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS,
 			schema: _mastra_core_storage.TABLE_SCHEMAS[_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS]
 		});
+		await this.#db.alterTable({
+			tableName: _mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS,
+			schema: _mastra_core_storage.TABLE_SCHEMAS[_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS],
+			ifNotExists: ["schedule"]
+		});
 		await this.#client.execute({
 			sql: `CREATE INDEX IF NOT EXISTS idx_workflow_definitions_status ON "${_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS}" ("status")`,
 			args: []
@@ -12828,6 +12943,7 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 				stateSchema: input.stateSchema ?? null,
 				requestContextSchema: input.requestContextSchema ?? null,
 				graph: input.graph,
+				schedule: "schedule" in input ? input.schedule ?? null : null,
 				status: "active",
 				source: "storage",
 				authorId: "authorId" in input ? input.authorId ?? null : null,
@@ -12858,6 +12974,7 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 		if ("stateSchema" in input && input.stateSchema !== void 0) data.stateSchema = input.stateSchema;
 		if ("requestContextSchema" in input && input.requestContextSchema !== void 0) data.requestContextSchema = input.requestContextSchema;
 		if ("graph" in input && input.graph !== void 0) data.graph = input.graph;
+		if ("schedule" in input && input.schedule !== void 0) data.schedule = input.schedule;
 		if ("status" in input && input.status !== void 0) data.status = input.status;
 		if ("authorId" in input && input.authorId !== void 0) data.authorId = input.authorId;
 		await this.#db.update({
@@ -12871,7 +12988,7 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 	}
 	async get(id) {
 		const row = (await this.#client.execute({
-			sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS)} FROM "${_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS}" WHERE id = ?`,
+			sql: `SELECT ${workflowDefinitionSelectColumns()} FROM "${_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS}" WHERE id = ?`,
 			args: [id]
 		})).rows[0];
 		return row ? rowToDefinition(row) : null;
@@ -12889,7 +13006,7 @@ var WorkflowDefinitionsLibSQL = class extends _mastra_core_storage.WorkflowDefin
 		}
 		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
 		const definitions = (await this.#client.execute({
-			sql: `SELECT ${buildSelectColumns(_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS)} FROM "${_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS}" ${where} ORDER BY updatedAt DESC`,
+			sql: `SELECT ${workflowDefinitionSelectColumns()} FROM "${_mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS}" ${where} ORDER BY updatedAt DESC`,
 			args: params
 		})).rows.map((row) => rowToDefinition(row));
 		return {