@mastra/spanner 1.5.0 → 1.6.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @mastra/spanner
 
+## 1.6.0-alpha.1
+
+### Patch Changes
+
+- Fixed resource-scoped message includes across storage adapters so included context cannot cross resource boundaries. ([#20984](https://github.com/mastra-ai/mastra/pull/20984))
+
+- Updated dependencies [[`6445eba`](https://github.com/mastra-ai/mastra/commit/6445eba6020abac681aba1cc9289f446cb400cbe), [`df31eb0`](https://github.com/mastra-ai/mastra/commit/df31eb0c7087d782a0d9346e467f9a4af4b0eef6), [`fcd0667`](https://github.com/mastra-ai/mastra/commit/fcd0667a4e378be35c9a1b1eb19cce78fbfd7282), [`bab06b1`](https://github.com/mastra-ai/mastra/commit/bab06b18923873a584bdfc71a6b4ec7fb4727fb7)]:
+  - @mastra/core@1.58.0-alpha.5
+
+## 1.6.0-alpha.0
+
+### Minor Changes
+
+- Added experiment provenance and grouping support to the LibSQL, MongoDB, MySQL, PostgreSQL, and Spanner storage adapters. These fields remain available for later grouping and filtering. ([#20645](https://github.com/mastra-ai/mastra/pull/20645))
+
+  ```ts
+  import { PostgresStore } from '@mastra/pg';
+
+  const storage = new PostgresStore({
+    id: 'postgres-storage',
+    connectionString: process.env.DATABASE_URL!,
+  });
+
+  await dataset.startExperiment({
+    task,
+    scorers,
+    provenance: { source: 'github', sourceVersion: 'abc123' },
+    grouping: { experimentSetId: 'benchmark-1', variantId: 'candidate', trialIndex: 0 },
+  });
+  ```
+
+- Memory list reads now surface database errors instead of silently returning empty results. ([#17910](https://github.com/mastra-ai/mastra/pull/17910))
+
+  Previously, the paginated memory reads (`listThreads`, `listMessages`, `listMessagesByResourceId`, and `listMessagesById`) caught backend failures, logged them, and returned an empty payload like `{ threads: [], total: 0, hasMore: false }`. A transient outage (locked table, dropped connection) was therefore indistinguishable from a genuinely empty result, so an agent reading conversation history during a brief failure would treat it as "no history" and could overwrite real state. These methods now re-throw the failure as a `MastraError`. Validation (USER) errors and genuinely empty results are unchanged.
+
+  **Behavior change**
+
+  Callers that previously received an empty result on a backend failure will now receive a thrown `MastraError`. If you call these read methods directly (rather than through an agent, which already surfaces errors), wrap them so a transient outage doesn't crash the caller:
+
+  ```ts
+  try {
+    const { threads } = await storage.listThreads({ resourceId });
+    // ...use threads
+  } catch (error) {
+    // a real backend failure. Decide whether to retry, surface, or degrade.
+    // An empty thread list no longer hides here; it only means "no threads".
+  }
+  ```
+
+### Patch Changes
+
+- dependencies updates: ([#20409](https://github.com/mastra-ai/mastra/pull/20409))
+  - Updated dependency [`@google-cloud/spanner@^8.10.0` ↗︎](https://www.npmjs.com/package/@google-cloud/spanner/v/8.10.0) (from `^8.9.0`, in `dependencies`)
+- Updated dependencies [[`e7109ee`](https://github.com/mastra-ai/mastra/commit/e7109ee6f731bacc79c885906f3c7dca8d8f013a), [`772c0c8`](https://github.com/mastra-ai/mastra/commit/772c0c897cec383258de2e6178147f8014767c7b), [`578bf2e`](https://github.com/mastra-ai/mastra/commit/578bf2e6a88e9d5b8bf502204e15a95dfbb679ae), [`06b2d87`](https://github.com/mastra-ai/mastra/commit/06b2d87e63bcdd0ed59215c6789692b9b12de376), [`ac01d63`](https://github.com/mastra-ai/mastra/commit/ac01d6355974aec73fdb8781449ed12bac582094), [`a810a05`](https://github.com/mastra-ai/mastra/commit/a810a058f62ad407cfc1701e0be36ae91145d7cf), [`f8da216`](https://github.com/mastra-ai/mastra/commit/f8da21633e7eb0e31c9ce0fc30567870d19416d3), [`6104347`](https://github.com/mastra-ai/mastra/commit/61043473ba6bfd0a25156824e853e13165562e6c), [`45bfb88`](https://github.com/mastra-ai/mastra/commit/45bfb88fd52f1dd3be20e2a38905777c96499c90), [`e3b9307`](https://github.com/mastra-ai/mastra/commit/e3b9307098daefbfae2a52ae2ef51bc9fc701190), [`d6834c5`](https://github.com/mastra-ai/mastra/commit/d6834c5a7866b16734d23900163c2414ed70d791), [`c52d346`](https://github.com/mastra-ai/mastra/commit/c52d3462ec831a5d95926ecd3d3373f5928ad2e5), [`0023e79`](https://github.com/mastra-ai/mastra/commit/0023e7919431078280abd11c89d1edeae35fcc69), [`c2ad51e`](https://github.com/mastra-ai/mastra/commit/c2ad51e2467f901eecba8c9f4a45e22a50bd7c18), [`3dc97ea`](https://github.com/mastra-ai/mastra/commit/3dc97ea415fad353b48a13095fad1835933cc12a), [`3d01cd3`](https://github.com/mastra-ai/mastra/commit/3d01cd387321b6f9c5cac31d487c84bf51b19c78), [`7bf3086`](https://github.com/mastra-ai/mastra/commit/7bf308663f0115ca74ad20554ade740f06640859), [`a8dd139`](https://github.com/mastra-ai/mastra/commit/a8dd1391a9fe9a6632c25809ef236980afa9a020), [`e5786be`](https://github.com/mastra-ai/mastra/commit/e5786be02bb903073082bd9d6da880ebaacc343f), [`2093fbd`](https://github.com/mastra-ai/mastra/commit/2093fbd53bb744bae19ec89f6d73db9a66fbe8a7), [`e7a5da4`](https://github.com/mastra-ai/mastra/commit/e7a5da4ef8e4dd452d2f232961b4e682a85ffe43), [`7b4393d`](https://github.com/mastra-ai/mastra/commit/7b4393d557411fdcf07b0e30e5acaf7cc85154ae)]:
+  - @mastra/core@1.58.0-alpha.1
+
 ## 1.5.0
 
 ### Minor Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.0",
+  "version": "1.6.0-alpha.1",
   "package": "@mastra/spanner",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -3971,6 +3971,12 @@ function rowToExperiment(row) {
 		name: t.name ?? void 0,
 		description: t.description ?? void 0,
 		metadata: t.metadata ?? void 0,
+		provenance: t.provenance ?? null,
+		runnerAttestation: t.runnerAttestation ?? null,
+		experimentSetId: t.experimentSetId ?? null,
+		comparisonId: t.comparisonId ?? null,
+		variantId: t.variantId ?? null,
+		trialIndex: t.trialIndex == null ? null : Number(t.trialIndex),
 		datasetId: t.datasetId ?? null,
 		datasetVersion: t.datasetVersion == null ? null : Number(t.datasetVersion),
 		organizationId: t.organizationId ?? null,
@@ -4051,7 +4057,17 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 		await this.db.alterTable({
 			tableName: _mastra_core_storage.TABLE_EXPERIMENTS,
 			schema: _mastra_core_storage.TABLE_SCHEMAS[_mastra_core_storage.TABLE_EXPERIMENTS],
-			ifNotExists: ["organizationId", "projectId"]
+			ifNotExists: [
+				"agentVersion",
+				"organizationId",
+				"projectId",
+				"provenance",
+				"runnerAttestation",
+				"experimentSetId",
+				"comparisonId",
+				"variantId",
+				"trialIndex"
+			]
 		});
 		await this.db.alterTable({
 			tableName: _mastra_core_storage.TABLE_EXPERIMENT_RESULTS,
@@ -4072,6 +4088,16 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 				table: _mastra_core_storage.TABLE_EXPERIMENTS,
 				columns: ["datasetId"]
 			},
+			{
+				name: "mastra_experiments_grouping_idx",
+				table: _mastra_core_storage.TABLE_EXPERIMENTS,
+				columns: [
+					"experimentSetId",
+					"comparisonId",
+					"variantId",
+					"trialIndex"
+				]
+			},
 			{
 				name: "mastra_experiment_results_experimentid_idx",
 				table: _mastra_core_storage.TABLE_EXPERIMENT_RESULTS,
@@ -4116,6 +4142,12 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 				name: input.name ?? void 0,
 				description: input.description ?? void 0,
 				metadata: input.metadata ?? void 0,
+				provenance: input.provenance ?? null,
+				runnerAttestation: input.runnerAttestation ?? null,
+				experimentSetId: input.experimentSetId ?? null,
+				comparisonId: input.comparisonId ?? null,
+				variantId: input.variantId ?? null,
+				trialIndex: input.trialIndex ?? null,
 				datasetId: input.datasetId ?? null,
 				datasetVersion: input.datasetVersion ?? null,
 				organizationId: input.organizationId ?? null,
@@ -4140,6 +4172,12 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 					name: experiment.name ?? null,
 					description: experiment.description ?? null,
 					metadata: experiment.metadata ?? null,
+					provenance: experiment.provenance,
+					runnerAttestation: experiment.runnerAttestation,
+					experimentSetId: experiment.experimentSetId,
+					comparisonId: experiment.comparisonId,
+					variantId: experiment.variantId,
+					trialIndex: experiment.trialIndex,
 					datasetId: experiment.datasetId,
 					datasetVersion: experiment.datasetVersion,
 					organizationId: experiment.organizationId,
@@ -4274,6 +4312,22 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 				conditions.push(`${quoteIdent("status", "column name")} = @status`);
 				params.status = args.status;
 			}
+			if (args.experimentSetId !== void 0) {
+				conditions.push(`${quoteIdent("experimentSetId", "column name")} = @experimentSetId`);
+				params.experimentSetId = args.experimentSetId;
+			}
+			if (args.comparisonId !== void 0) {
+				conditions.push(`${quoteIdent("comparisonId", "column name")} = @comparisonId`);
+				params.comparisonId = args.comparisonId;
+			}
+			if (args.variantId !== void 0) {
+				conditions.push(`${quoteIdent("variantId", "column name")} = @variantId`);
+				params.variantId = args.variantId;
+			}
+			if (args.trialIndex !== void 0) {
+				conditions.push(`${quoteIdent("trialIndex", "column name")} = @trialIndex`);
+				params.trialIndex = args.trialIndex;
+			}
 			if (args.filters) {
 				const { organizationId, projectId } = args.filters;
 				if (organizationId !== void 0) {
@@ -6681,15 +6735,23 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 			}, error);
 			this.logger?.error?.(mastraError.toString());
 			this.logger?.trackException?.(mastraError);
-			return { messages: [] };
+			throw mastraError;
 		}
 	}
-	/** Resolves the `include` clause: pinned messages plus their before/after windows. */
-	async getIncludedMessages({ include }) {
+	/**
+	* Resolves the `include` clause: pinned messages plus their before/after windows.
+	*
+	* @param include - Message ids to pin, each with an optional before/after window.
+	* @param resourceId - When set, restricts both the pinned messages and their context
+	* to that resource so an id from another resource returns nothing.
+	*/
+	async getIncludedMessages({ include, resourceId }) {
 		if (!include || include.length === 0) return null;
+		const resourceCondition = resourceId ? ` AND ${quoteIdent("resourceId", "column name")} = @scopedResourceId` : "";
+		const resourceParams = resourceId ? { scopedResourceId: resourceId } : {};
 		const ids = include.map((i) => i.id);
 		const placeholders = [];
-		const idParams = {};
+		const idParams = { ...resourceParams };
 		ids.forEach((id, i) => {
 			const name = `tid${i}`;
 			placeholders.push(`@${name}`);
@@ -6697,7 +6759,7 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 		});
 		const targetsSql = `SELECT id, content, role, type, ${quoteIdent("createdAt", "column name")}, ${quoteIdent("thread_id", "column name")} AS threadId, ${quoteIdent("resourceId", "column name")}
                         FROM ${quoteIdent(_mastra_core_storage.TABLE_MESSAGES, "table name")}
-                        WHERE id IN (${placeholders.join(", ")})`;
+                        WHERE id IN (${placeholders.join(", ")})${resourceCondition}`;
 		const [targetRows] = await this.database.run({
 			sql: targetsSql,
 			params: idParams,
@@ -6722,14 +6784,15 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 					sql: `SELECT id, content, role, type, ${quoteIdent("createdAt", "column name")}, ${quoteIdent("thread_id", "column name")} AS threadId, ${quoteIdent("resourceId", "column name")}
                 FROM ${quoteIdent(_mastra_core_storage.TABLE_MESSAGES, "table name")}
                 WHERE ${quoteIdent("thread_id", "column name")} = @threadId
-                  AND (${quoteIdent("createdAt", "column name")} < @ts OR (${quoteIdent("createdAt", "column name")} = @ts AND id < @id))
+                  AND (${quoteIdent("createdAt", "column name")} < @ts OR (${quoteIdent("createdAt", "column name")} = @ts AND id < @id))${resourceCondition}
                 ORDER BY ${quoteIdent("createdAt", "column name")} DESC, id DESC
                 LIMIT @lim`,
 					params: {
 						threadId,
 						ts: targetCreatedAt,
 						id: target.id,
-						lim: withPreviousMessages
+						lim: withPreviousMessages,
+						...resourceParams
 					},
 					json: true
 				});
@@ -6743,14 +6806,15 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 					sql: `SELECT id, content, role, type, ${quoteIdent("createdAt", "column name")}, ${quoteIdent("thread_id", "column name")} AS threadId, ${quoteIdent("resourceId", "column name")}
                 FROM ${quoteIdent(_mastra_core_storage.TABLE_MESSAGES, "table name")}
                 WHERE ${quoteIdent("thread_id", "column name")} = @threadId
-                  AND (${quoteIdent("createdAt", "column name")} > @ts OR (${quoteIdent("createdAt", "column name")} = @ts AND id > @id))
+                  AND (${quoteIdent("createdAt", "column name")} > @ts OR (${quoteIdent("createdAt", "column name")} = @ts AND id > @id))${resourceCondition}
                 ORDER BY ${quoteIdent("createdAt", "column name")} ASC, id ASC
                 LIMIT @lim`,
 					params: {
 						threadId,
 						ts: targetCreatedAt,
 						id: target.id,
-						lim: withNextMessages
+						lim: withNextMessages,
+						...resourceParams
 					},
 					json: true
 				});
@@ -6803,7 +6867,10 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 				hasMore: false
 			};
 			if (perPage === 0 && include && include.length > 0) {
-				const includeMessages = await this.getIncludedMessages({ include }) ?? [];
+				const includeMessages = await this.getIncludedMessages({
+					include,
+					resourceId
+				}) ?? [];
 				const parsedIncludes = this.parseAndFormatMessages(includeMessages, "v2");
 				const dirMul = direction === "ASC" ? 1 : -1;
 				return {
@@ -6861,7 +6928,10 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 			};
 			if (include?.length) {
 				const seen = new Set(messages.map((m) => m.id));
-				(await this.getIncludedMessages({ include }))?.forEach((msg) => {
+				(await this.getIncludedMessages({
+					include,
+					resourceId
+				}))?.forEach((msg) => {
 					if (!seen.has(msg.id)) {
 						messages.push(msg);
 						seen.add(msg.id);