@mastra/upstash 1.5.1 → 1.5.2-alpha.0

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.5.1"
+  version: "1.5.2-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.1",
+  "version": "1.5.2-alpha.0",
   "package": "@mastra/upstash",
   "exports": {},
   "modules": {}

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

@@ -272,6 +272,22 @@ Schema-based working memory uses **merge semantics**, meaning the agent only nee
 - **Set a field to `null` to delete it:** This explicitly removes the field from memory
 - **Arrays are replaced entirely:** When an array field is provided, it replaces the existing array (arrays aren't merged element-by-element)
 
+### Concurrent updates
+
+With `scope: 'resource'` and a storage adapter that supports atomic merges (currently `@mastra/pg`), each merge runs inside a row-locked database transaction. Concurrent updates to different fields from separate processes are all kept. Other adapters merge in the application, which only serializes writers inside a single process.
+
+To merge a partial update from your own code, call `memory.mergeWorkingMemory()`:
+
+```typescript
+await memory.mergeWorkingMemory({
+  threadId: 'thread-1',
+  resourceId: 'user-123',
+  workingMemory: { preferences: { tone: 'formal' } },
+})
+```
+
+It throws if working memory isn't schema-based and resource-scoped, or if the storage adapter doesn't support atomic merges. Check `await memory.supportsAtomicWorkingMemoryMerge()` first if you need to fall back.
+
 ## Choosing between template and schema
 
 - Use a **template** (Markdown) if you want the agent to maintain memory as a free-form text block, such as a user profile or scratchpad. Templates use **replace semantics**: the agent must provide the complete memory content on each update.

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

@@ -50,23 +50,25 @@ console.log(results)
 
 The `topK` parameter specifies the maximum number of most similar results to return from the vector search.
 
-Results include both the text content and a similarity score:
+Each result includes an `id`, a similarity `score`, and the stored `metadata`. When you store chunk text in metadata, it's available as `metadata.text`:
 
 ```ts
 [
   {
-    text: 'Climate change poses significant challenges...',
+    id: 'chunk-1',
     score: 0.89,
-    metadata: { source: 'article1.txt' },
+    metadata: { text: 'Climate change poses significant challenges...', source: 'article1.txt' },
   },
   {
-    text: 'Rising temperatures affect crop yields...',
+    id: 'chunk-2',
     score: 0.82,
-    metadata: { source: 'article1.txt' },
+    metadata: { text: 'Rising temperatures affect crop yields...', source: 'article1.txt' },
   },
 ]
 ```
 
+Results can also include `vector` when you set `includeVector: true`, and `document` when the store returns the original document (Chroma only).
+
 ## Advanced retrieval options
 
 ### Metadata Filtering

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

@@ -230,7 +230,7 @@ await store.upsert({
 **libSQL**:
 
 ```ts
-import { LibSQLVector } from '@mastra/core/vector/libsql'
+import { LibSQLVector } from '@mastra/libsql'
 
 const store = new LibSQLVector({
   id: 'libsql-vector',

package/dist/index.cjs

@@ -1642,7 +1642,7 @@ var WorkflowsUpstash = class extends _mastra_core_storage.WorkflowsStorage {
 			return this.client.get(key);
 		}))).find((w) => w?.run_id === runId && (!workflowName || w.workflow_name === workflowName) && (!resourceId || w.resourceId === resourceId)) ?? null;
 	}
-	async updateWorkflowResults({ workflowName, runId, stepId, result, requestContext }) {
+	async updateWorkflowResults({ workflowName, runId, stepId, result, requestContext, state }) {
 		try {
 			const key = getKey(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT, {
 				namespace: "workflows",
@@ -1660,6 +1660,7 @@ var WorkflowsUpstash = class extends _mastra_core_storage.WorkflowsStorage {
         local workflowName = ARGV[6]
         local runId = ARGV[7]
         local timestamp = tonumber(ARGV[8])
+        local stateJson = ARGV[9]
 
         -- Get existing data
         local existing = redis.call('GET', key)
@@ -1706,6 +1707,11 @@ var WorkflowsUpstash = class extends _mastra_core_storage.WorkflowsStorage {
         local stepResult = cjson.decode(resultJson)
         snapshot.context[stepId] = stepResult
 
+        -- Record workflow state in the same write when provided
+        if stateJson ~= '' then
+          snapshot.context['__state'] = cjson.decode(stateJson)
+        end
+
         -- Merge request context
         local newRequestContext = cjson.decode(requestContextJson)
         if snapshot.requestContext == nil then
@@ -1732,7 +1738,8 @@ var WorkflowsUpstash = class extends _mastra_core_storage.WorkflowsStorage {
 				"workflows",
 				workflowName,
 				runId,
-				String(Date.now())
+				String(Date.now()),
+				state === void 0 ? "" : JSON.stringify(state)
 			]);
 			let data;
 			if (typeof resultJson === "string") data = JSON.parse(resultJson);