@mastra/upstash 1.2.1-alpha.1 → 1.2.2-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @mastra/upstash
 
+## 1.2.2-alpha.0
+
+### Patch Changes
+
+- Add optional `batchId`, `datasetId`, and `datasetItemId` fields to persisted scores so saved baseline scores can be grouped as one scoring pass and joined back to the dataset items they came from. ([#18331](https://github.com/mastra-ai/mastra/pull/18331))
+  - `scoreTrace()` accepts top-level `batchId`, `datasetId`, and `datasetItemId` when persisting a score for a stored trace.
+  - `ScoreRowData` and score save payloads now include nullable `batchId`, `datasetId`, and `datasetItemId`.
+  - Built-in stores with explicit score schema or attribute mappings now persist these provenance fields on saved scores.
+  - D1, DSQL, MSSQL, and Upstash score stores now apply additive provenance migrations or deterministic score ordering for persisted score reads.
+
+  ```ts
+  await scoreTrace({
+    storage,
+    scorer,
+    target: { traceId },
+    batchId: 'baseline-batch-1',
+    datasetId,
+    datasetItemId,
+  });
+  ```
+
+- Added optional `organizationId` and `projectId` fields to scores for multi-tenant isolation. Scores can now be saved with tenancy metadata and the `listScoresBy*` methods accept a `filters` option to scope results by organization and project. ([#18331](https://github.com/mastra-ai/mastra/pull/18331))
+
+  ```ts
+  await storage.saveScore({ ...score, organizationId: 'org-a', projectId: 'proj-1' });
+
+  const result = await storage.listScoresByScorerId({
+    scorerId,
+    filters: { organizationId: 'org-a', projectId: 'proj-1' },
+  });
+  ```
+
+  `projectId` identifies the project scope, separate from `resourceId` which continues to mean the agent memory resource.
+
+- Updated dependencies [[`9250acd`](https://github.com/mastra-ai/mastra/commit/9250acd1357f0f1f33d0dcca16f9655084c58eca), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`c64c2a8`](https://github.com/mastra-ai/mastra/commit/c64c2a8503a50252f9ca6b8e8c54cadee31b92a2), [`06e2680`](https://github.com/mastra-ai/mastra/commit/06e26806b51d2cbd858afdc66daa2b86ff3ba64a), [`1240f05`](https://github.com/mastra-ai/mastra/commit/1240f051c8e5371f1c014448bf37b1a1b9a05e47), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748)]:
+  - @mastra/core@1.49.0-alpha.5
+  - @mastra/redis@1.2.2-alpha.0
+
+## 1.2.1
+
+### Patch Changes
+
+- Fixed workflow runs preserving their original creation time when re-persisted in Upstash storage, including concurrent saves. ([#18004](https://github.com/mastra-ai/mastra/pull/18004))
+
+- Updated dependencies [[`86623c1`](https://github.com/mastra-ai/mastra/commit/86623c1adf7d22de32cc916dda17f4155184db36), [`023766f`](https://github.com/mastra-ai/mastra/commit/023766f44d59b30a50f3a381e33eddde8ab56c00), [`0200e75`](https://github.com/mastra-ai/mastra/commit/0200e7552d02d4221cd6040bf4eddf189a97a156), [`7c9dd77`](https://github.com/mastra-ai/mastra/commit/7c9dd77bd18cb8dc72797e25f1a0fbdc71a11347), [`7f9ae70`](https://github.com/mastra-ai/mastra/commit/7f9ae70826b047e5a66218f9e92f20e54a2d791f), [`a0509c7`](https://github.com/mastra-ai/mastra/commit/a0509c731a08aa3ed626557c5338126362856f57), [`06e0d63`](https://github.com/mastra-ai/mastra/commit/06e0d63d42bc2a202e18bc091f3781f409f5e6fb), [`bf3fe49`](https://github.com/mastra-ai/mastra/commit/bf3fe49f9467dbbdb8f9eaf74e0f7971ffb19559), [`01caf93`](https://github.com/mastra-ai/mastra/commit/01caf93d71ae2c1e65f49735cafb531975187426), [`438a971`](https://github.com/mastra-ai/mastra/commit/438a9715c8b4398e5eaf8914a1f19dc8a85dc1de), [`9990965`](https://github.com/mastra-ai/mastra/commit/999096571635a83b42ef40841fd7028cfa630779), [`77518cc`](https://github.com/mastra-ai/mastra/commit/77518ccb5bb8cc684875081e64213dc85cffdbee), [`fbeda0c`](https://github.com/mastra-ai/mastra/commit/fbeda0c0f35def07e6837936dd3a003b2b7c5172), [`8a68844`](https://github.com/mastra-ai/mastra/commit/8a688443013816105a09f89c6afa34b5ff13e26d), [`bb2a13b`](https://github.com/mastra-ai/mastra/commit/bb2a13bb4b32e6bb807200fe7b18ae8fa4322118), [`24ceaea`](https://github.com/mastra-ai/mastra/commit/24ceaea0bdd8609cabbab764380608ca6621a194), [`a73cd1a`](https://github.com/mastra-ai/mastra/commit/a73cd1a62a5e4ca023dcc39ba150029f4f1f74c1), [`c0ffa3c`](https://github.com/mastra-ai/mastra/commit/c0ffa3c897ccd326de880df734740a7f0681a18f), [`462a769`](https://github.com/mastra-ai/mastra/commit/462a769da61850862ca1be3d74134d33078ee6a7), [`0504bf5`](https://github.com/mastra-ai/mastra/commit/0504bf5e8cffc571a4b343326178de371e6f859b), [`0b5cc47`](https://github.com/mastra-ai/mastra/commit/0b5cc4726dc18d9a685a27520db39ff1b36bb89a), [`87f38a3`](https://github.com/mastra-ai/mastra/commit/87f38a3de03e24731f2dd6f8ed6a60b6722b85a1), [`d5fa3cd`](https://github.com/mastra-ai/mastra/commit/d5fa3cda1788c3cb93a361a3c6ec47de6ba21e98), [`fe98ef2`](https://github.com/mastra-ai/mastra/commit/fe98ef2e66dbfcbd7d645c88c9ee1e67b458a136), [`6ccf67b`](https://github.com/mastra-ai/mastra/commit/6ccf67bf075753754927a57bc2e1734ba2c820c5), [`793ea0f`](https://github.com/mastra-ai/mastra/commit/793ea0f52f831178837f21c83af6af93bf4ce638), [`825d8de`](https://github.com/mastra-ai/mastra/commit/825d8def9fa64c2bcc3d8dd6b49e09342c3ac5c7), [`bf026c5`](https://github.com/mastra-ai/mastra/commit/bf026c5b641019c97facfe5924d14dd363866cb0), [`507a5c4`](https://github.com/mastra-ai/mastra/commit/507a5c461bdc3136ad80744c0efbb55ce1f18f97), [`5afe423`](https://github.com/mastra-ai/mastra/commit/5afe423e4badf040f1b0d4525183a856fcb8146e), [`307573b`](https://github.com/mastra-ai/mastra/commit/307573b9ff3149b70c79540dbc86f1319b180f29), [`79b3626`](https://github.com/mastra-ai/mastra/commit/79b3626f8d647307eb07c8da14c9073c2699719d), [`c2c1d7b`](https://github.com/mastra-ai/mastra/commit/c2c1d7bb61d2602955f14ed3952f807c2d6eb576), [`86623c1`](https://github.com/mastra-ai/mastra/commit/86623c1adf7d22de32cc916dda17f4155184db36), [`1505c07`](https://github.com/mastra-ai/mastra/commit/1505c07603f6346bae12aa82f140e8b88ffea9ab), [`f328049`](https://github.com/mastra-ai/mastra/commit/f3280498c324afd2a8d36cd828f5b9f94a2dddc1), [`e545228`](https://github.com/mastra-ai/mastra/commit/e54522856934a5dc030b7b6385771e3548020d59), [`3eb852e`](https://github.com/mastra-ai/mastra/commit/3eb852e5435bc908b800193498103dc724f455b0), [`ffa09e7`](https://github.com/mastra-ai/mastra/commit/ffa09e772a5c92270eabe2090fc42d45bd8ec4b7), [`8c9f1c0`](https://github.com/mastra-ai/mastra/commit/8c9f1c0361d89066f9bcd14a2f69e761b01766c8), [`461a7c5`](https://github.com/mastra-ai/mastra/commit/461a7c501449295287f4f0ee4b0b42344f39fcf8), [`4211472`](https://github.com/mastra-ai/mastra/commit/4211472a5a2bd319c60cd2e42d9109c3eef7ac1c), [`9e45902`](https://github.com/mastra-ai/mastra/commit/9e4590208e745055cecca202e2db0e5c65e17d3c), [`5c0df77`](https://github.com/mastra-ai/mastra/commit/5c0df776c40efa420f8c07a2f3ee66010296618e), [`e940f09`](https://github.com/mastra-ai/mastra/commit/e940f099ef5d18b403e6f2b4937e086a4da857b1)]:
+  - @mastra/core@1.47.0
+  - @mastra/redis@1.2.1
+
 ## 1.2.1-alpha.1
 
 ### Patch Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.1-alpha.1",
+  "version": "1.2.2-alpha.0",
   "package": "@mastra/upstash",
   "exports": {
     "RedisServerCache": {

package/dist/docs/references/docs-memory-working-memory.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Working Memory
 
 While [message history](https://mastra.ai/docs/memory/message-history) and [semantic recall](https://mastra.ai/docs/memory/semantic-recall) help agents remember conversations, working memory allows them to maintain persistent information about users across interactions.
@@ -6,6 +8,8 @@ Think of it as the agent's active thoughts or scratchpad – the key information
 
 This is useful for maintaining ongoing state that's always relevant and should always be available to the agent.
 
+If you use [Observational Memory](https://mastra.ai/docs/memory/observational-memory), `observationalMemory.observation.manageWorkingMemory` lets OM update working memory for the agent.
+
 Working memory can persist at two different scopes:
 
 - **Resource-scoped** (default): Memory persists across all conversation threads for the same user

package/dist/docs/references/docs-rag-retrieval.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Retrieval in RAG systems
 
 After storing embeddings, you need to retrieve relevant chunks to answer user queries.

package/dist/docs/references/docs-rag-vector-databases.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Storing embeddings in a vector database
 
 After generating embeddings, you need to store them in a database that supports vector similarity search. Mastra provides a consistent interface for storing and querying embeddings across various vector databases.

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

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Upstash storage
 
 The Upstash storage implementation provides a serverless-friendly storage solution using Upstash's Redis-compatible key-value store.

package/dist/docs/references/reference-vectors-upstash.md

@@ -1,3 +1,5 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
 # Upstash vector store
 
 The UpstashVector class provides vector search using [Upstash Vector](https://upstash.com/vector), a serverless vector database service that provides vector similarity search with metadata filtering capabilities and hybrid search support.

package/dist/index.cjs

@@ -1456,6 +1456,16 @@ var StoreMemoryUpstash = class extends storage.MemoryStorage {
 function transformScoreRow(row) {
   return storage.transformScoreRow(row);
 }
+function matchesTenancy(row, filters) {
+  if (filters?.organizationId !== void 0 && row.organizationId !== filters.organizationId) return false;
+  if (filters?.projectId !== void 0 && row.projectId !== filters.projectId) return false;
+  return true;
+}
+function compareScoresByCreatedAtDesc(a, b) {
+  const createdAtDiff = new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime();
+  if (createdAtDiff !== 0) return createdAtDiff;
+  return String(b.id ?? "").localeCompare(String(a.id ?? ""));
+}
 var ScoresUpstash = class extends storage.ScoresStorage {
   client;
   #db;
@@ -1495,7 +1505,8 @@ var ScoresUpstash = class extends storage.ScoresStorage {
     entityId,
     entityType,
     source,
-    pagination = { page: 0, perPage: 20 }
+    pagination = { page: 0, perPage: 20 },
+    filters
   }) {
     const pattern = `${storage.TABLE_SCORERS}:*`;
     const keys = await this.#db.scanKeys(pattern);
@@ -1525,13 +1536,14 @@ var ScoresUpstash = class extends storage.ScoresStorage {
       if (entityId && row.entityId !== entityId) return false;
       if (entityType && row.entityType !== entityType) return false;
       if (source && row.source !== source) return false;
+      if (!matchesTenancy(row, filters)) return false;
       return true;
     });
     const perPage = storage.normalizePerPage(perPageInput, 100);
     const { offset: start, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const end = perPageInput === false ? filtered.length : start + perPage;
     const total = filtered.length;
-    const paged = filtered.slice(start, end);
+    const paged = [...filtered].sort(compareScoresByCreatedAtDesc).slice(start, end);
     const scores = paged.map((row) => transformScoreRow(row));
     return {
       scores,
@@ -1592,7 +1604,8 @@ var ScoresUpstash = class extends storage.ScoresStorage {
   }
   async listScoresByRunId({
     runId,
-    pagination = { page: 0, perPage: 20 }
+    pagination = { page: 0, perPage: 20 },
+    filters
   }) {
     const pattern = `${storage.TABLE_SCORERS}:*`;
     const keys = await this.#db.scanKeys(pattern);
@@ -1616,12 +1629,14 @@ var ScoresUpstash = class extends storage.ScoresStorage {
         }
       }
       return raw;
-    }).filter((row) => !!row && typeof row === "object" && row.runId === runId);
+    }).filter(
+      (row) => !!row && typeof row === "object" && row.runId === runId && matchesTenancy(row, filters)
+    );
     const total = filtered.length;
     const perPage = storage.normalizePerPage(perPageInput, 100);
     const { offset: start, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const end = perPageInput === false ? filtered.length : start + perPage;
-    const paged = filtered.slice(start, end);
+    const paged = [...filtered].sort(compareScoresByCreatedAtDesc).slice(start, end);
     const scores = paged.map((row) => transformScoreRow(row));
     return {
       scores,
@@ -1636,7 +1651,8 @@ var ScoresUpstash = class extends storage.ScoresStorage {
   async listScoresByEntityId({
     entityId,
     entityType,
-    pagination = { page: 0, perPage: 20 }
+    pagination = { page: 0, perPage: 20 },
+    filters
   }) {
     const pattern = `${storage.TABLE_SCORERS}:*`;
     const keys = await this.#db.scanKeys(pattern);
@@ -1664,13 +1680,14 @@ var ScoresUpstash = class extends storage.ScoresStorage {
       if (!row || typeof row !== "object") return false;
       if (row.entityId !== entityId) return false;
       if (entityType && row.entityType !== entityType) return false;
+      if (!matchesTenancy(row, filters)) return false;
       return true;
     });
     const total = filtered.length;
     const perPage = storage.normalizePerPage(perPageInput, 100);
     const { offset: start, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const end = perPageInput === false ? filtered.length : start + perPage;
-    const paged = filtered.slice(start, end);
+    const paged = [...filtered].sort(compareScoresByCreatedAtDesc).slice(start, end);
     const scores = paged.map((row) => transformScoreRow(row));
     return {
       scores,
@@ -1685,7 +1702,8 @@ var ScoresUpstash = class extends storage.ScoresStorage {
   async listScoresBySpan({
     traceId,
     spanId,
-    pagination = { page: 0, perPage: 20 }
+    pagination = { page: 0, perPage: 20 },
+    filters
   }) {
     const pattern = `${storage.TABLE_SCORERS}:*`;
     const keys = await this.#db.scanKeys(pattern);
@@ -1713,13 +1731,14 @@ var ScoresUpstash = class extends storage.ScoresStorage {
       if (!row || typeof row !== "object") return false;
       if (row.traceId !== traceId) return false;
       if (row.spanId !== spanId) return false;
+      if (!matchesTenancy(row, filters)) return false;
       return true;
     });
     const total = filtered.length;
     const perPage = storage.normalizePerPage(perPageInput, 100);
     const { offset: start, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const end = perPageInput === false ? filtered.length : start + perPage;
-    const paged = filtered.slice(start, end);
+    const paged = [...filtered].sort(compareScoresByCreatedAtDesc).slice(start, end);
     const scores = paged.map((row) => transformScoreRow(row));
     return {
       scores,