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

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @mastra/libsql
 
+## 1.22.0-alpha.2
+
+### Minor Changes
+
+- Added embedded-replica sync support to LibSQLStore. You can now pass `syncUrl` and `syncInterval` to keep a local database file synced with a remote libSQL primary (for example Turso), matching the options LibSQLVector already supports. ([#22261](https://github.com/mastra-ai/mastra/pull/22261))
+
+  ```typescript
+  import { LibSQLStore } from '@mastra/libsql';
+
+  const storage = new LibSQLStore({
+    id: 'libsql-storage',
+    url: 'file:./replica.db',
+    syncUrl: 'libsql://your-db-name.turso.io',
+    authToken: process.env.TURSO_AUTH_TOKEN,
+    syncInterval: 60,
+  });
+  ```
+
+  See https://github.com/mastra-ai/mastra/issues/21994
+
+### Patch Changes
+
+- Experiment results now include isolated metadata snapshots from the dataset items that ran. ([#22005](https://github.com/mastra-ai/mastra/pull/22005))
+
+- Enforce atomic conditional background task state updates so cancellation cannot be overwritten during dispatch. Background task storage is no longer exposed by Cloudflare KV or ClickHouse, which cannot provide the required compare-and-set semantics. ([#22228](https://github.com/mastra-ai/mastra/pull/22228))
+
+- Updated dependencies [[`aa3a85d`](https://github.com/mastra-ai/mastra/commit/aa3a85daf094c683bb97efdf4b6a696d2e474af5), [`d29d06f`](https://github.com/mastra-ai/mastra/commit/d29d06fe00bbd35b4571150ea04c59d2ed783c71), [`e6516df`](https://github.com/mastra-ai/mastra/commit/e6516dfcdae4f4ac0e7971d84359a81385ee602f), [`0b2a3d1`](https://github.com/mastra-ai/mastra/commit/0b2a3d1783875c5b97b7b36ab3d03d7360e0dde7), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`57de7d6`](https://github.com/mastra-ai/mastra/commit/57de7d644ba7146edb4e9e6111ec4fa98c3a59e9), [`e8e299c`](https://github.com/mastra-ai/mastra/commit/e8e299cc6abdfc39947e2fec25803493015d3882), [`edfc548`](https://github.com/mastra-ai/mastra/commit/edfc548886bc7bae17b681f8b6b41a47eb32bcd2), [`a8a4871`](https://github.com/mastra-ai/mastra/commit/a8a4871215f51da95c47129602157ce5372f634a), [`5165cdc`](https://github.com/mastra-ai/mastra/commit/5165cdcdcf50e144bb8113278535196cc9b07065), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`9ee8120`](https://github.com/mastra-ai/mastra/commit/9ee8120ce17f76b9f617489e05a283353742690a), [`d975e92`](https://github.com/mastra-ai/mastra/commit/d975e924d4936f46c386bd3dee39c671720289f6), [`1cfa878`](https://github.com/mastra-ai/mastra/commit/1cfa8784d8da0dfaa0317e5048bc48b6084a5ea5), [`c118318`](https://github.com/mastra-ai/mastra/commit/c1183181c9804303db4b511c2e2648f8b714712b), [`fc07c64`](https://github.com/mastra-ai/mastra/commit/fc07c6465043e08e99193a6751a01c56ffc2e7a1), [`542dee2`](https://github.com/mastra-ai/mastra/commit/542dee254167f974ff8cbbbfc0ce10f9a2616a7b), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`895e9df`](https://github.com/mastra-ai/mastra/commit/895e9dfc17d6f34299eca64e317ded9e5f5e5ef8)]:
+  - @mastra/core@1.62.0-alpha.8
+
 ## 1.22.0-alpha.1
 
 ### Minor Changes

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.0-alpha.1"
+  version: "1.22.0-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/docs-storage.md

@@ -197,6 +197,7 @@ Each provider page includes installation instructions, configuration parameters,
 - [Convex](https://mastra.ai/integrations/databases/convex)
 - [DuckDB](https://mastra.ai/integrations/databases/duckdb)
 - [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
+- [Elasticsearch](https://mastra.ai/integrations/databases/elasticsearch)
 - [Google Cloud Spanner](https://mastra.ai/integrations/databases/spanner)
 - [LanceDB](https://mastra.ai/integrations/databases/lancedb)
 - [libSQL](https://mastra.ai/integrations/databases/libsql)

package/dist/docs/references/integrations-databases-libsql.md

@@ -89,12 +89,28 @@ storage: new LibSQLStore({
 
 > **Warning:** In-memory storage resets when the process changes. Only suitable for development.
 
+Embedded replica synced with a remote primary (for example Turso):
+
+```typescript
+storage: new LibSQLStore({
+  id: 'libsql-storage',
+  url: 'file:./replica.db',
+  syncUrl: 'libsql://your-db-name.aws-ap-northeast-1.turso.io',
+  authToken: process.env.TURSO_AUTH_TOKEN,
+  syncInterval: 60,
+})
+```
+
 ## Options
 
 **url** (`string`): Database URL. Use :memory: for in-memory database, file:filename.db for a file database, or a libSQL connection string (e.g., libsql://your-database.turso.io) for remote storage.
 
 **authToken** (`string`): Authentication token for remote libSQL databases.
 
+**syncUrl** (`string`): URL of the remote primary database to sync from, enabling an embedded replica. Requires a local file: url.
+
+**syncInterval** (`number`): Interval in seconds for automatic sync with the remote primary. Only applies when syncUrl is set.
+
 ## Managed tables
 
 The storage implementation creates the core storage tables automatically, including `mastra_notifications` for notification inbox records and delivery metadata.

package/dist/index.cjs

@@ -2967,7 +2967,7 @@ var BackgroundTasksLibSQL = class BackgroundTasksLibSQL extends _mastra_core_sto
 			}
 		});
 	}
-	async updateTask(taskId, update) {
+	async updateTask(taskId, update, options) {
 		const setClauses = [];
 		const params = [];
 		if ("status" in update) {
@@ -3002,12 +3002,17 @@ var BackgroundTasksLibSQL = class BackgroundTasksLibSQL extends _mastra_core_sto
 			setClauses.push("completedAt = ?");
 			params.push(update.completedAt?.toISOString() ?? null);
 		}
-		if (setClauses.length === 0) return;
+		if (setClauses.length === 0) return false;
 		params.push(taskId);
-		await this.#client.execute({
-			sql: `UPDATE ${_mastra_core_storage.TABLE_BACKGROUND_TASKS} SET ${setClauses.join(", ")} WHERE id = ?`,
+		let where = "id = ?";
+		if (options?.expectedStatus) {
+			where += " AND status = ?";
+			params.push(options.expectedStatus);
+		}
+		return (await this.#client.execute({
+			sql: `UPDATE ${_mastra_core_storage.TABLE_BACKGROUND_TASKS} SET ${setClauses.join(", ")} WHERE ${where}`,
 			args: params
-		});
+		})).rowsAffected > 0;
 	}
 	async getTask(taskId) {
 		const row = (await this.#client.execute({
@@ -4617,6 +4622,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 				"tags",
 				"comment",
 				"toolMockReport",
+				"metadata",
 				"organizationId",
 				"projectId",
 				"attempt"
@@ -4763,6 +4769,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 			input: (0, _mastra_core_storage.safelyParseJSON)(row.input),
 			output: row.output ? (0, _mastra_core_storage.safelyParseJSON)(row.output) : null,
 			groundTruth: row.groundTruth ? (0, _mastra_core_storage.safelyParseJSON)(row.groundTruth) : null,
+			metadata: row.metadata ? (0, _mastra_core_storage.safelyParseJSON)(row.metadata) : null,
 			error: row.error ? (0, _mastra_core_storage.safelyParseJSON)(row.error) : null,
 			startedAt: (0, _mastra_core_storage.ensureDate)(row.startedAt),
 			completedAt: (0, _mastra_core_storage.ensureDate)(row.completedAt),
@@ -5065,6 +5072,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 					input: input.input,
 					output: input.output,
 					groundTruth: input.groundTruth,
+					metadata: input.metadata ?? null,
 					error: input.error ?? null,
 					startedAt: input.startedAt.toISOString(),
 					completedAt: input.completedAt.toISOString(),
@@ -5087,6 +5095,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 				input: input.input,
 				output: input.output,
 				groundTruth: input.groundTruth,
+				metadata: input.metadata ?? null,
 				error: input.error,
 				startedAt: input.startedAt,
 				completedAt: input.completedAt,
@@ -5141,7 +5150,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 			await this.#client.execute({
 				sql: `UPDATE ${_mastra_core_storage.TABLE_EXPERIMENT_RESULTS} SET
           "itemDatasetVersion" = ?, "organizationId" = ?, "projectId" = ?,
-          "input" = ?, "output" = ?, "groundTruth" = ?, "error" = ?,
+          "input" = ?, "output" = ?, "groundTruth" = ?, "metadata" = ?, "error" = ?,
           "startedAt" = ?, "completedAt" = ?, "retryCount" = ?, "attempt" = ?,
           "traceId" = ?, "status" = ?, "tags" = ?, "toolMockReport" = ?
         WHERE "id" = ?`,
@@ -5152,6 +5161,7 @@ var ExperimentsLibSQL = class extends _mastra_core_storage.ExperimentsStorage {
 					JSON.stringify(input.input),
 					input.output != null ? JSON.stringify(input.output) : null,
 					input.groundTruth != null ? JSON.stringify(input.groundTruth) : null,
+					input.metadata != null ? JSON.stringify(input.metadata) : null,
 					input.error != null ? JSON.stringify(input.error) : null,
 					input.startedAt.toISOString(),
 					input.completedAt.toISOString(),
@@ -14133,10 +14143,12 @@ var LibSQLStore = class extends _mastra_core_storage.MastraCompositeStore {
 		};
 		if ("url" in config) {
 			if (config.url.includes(":memory:")) this.shouldCacheInit = false;
-			this.isLocalDb = config.url.startsWith("file:") || config.url.includes(":memory:");
+			this.isLocalDb = (config.url.startsWith("file:") || config.url.includes(":memory:")) && !config.syncUrl;
 			this.client = (0, _libsql_client.createClient)({
 				url: config.url,
 				...config.authToken ? { authToken: config.authToken } : {},
+				...config.syncUrl ? { syncUrl: config.syncUrl } : {},
+				...config.syncInterval !== void 0 ? { syncInterval: config.syncInterval } : {},
 				...this.isLocalDb ? { timeout: this.connectionTimeoutMs } : {}
 			});
 			this.pragmasReady = this.isLocalDb ? this.applyLocalPragmas() : Promise.resolve();