@mastra/upstash 0.0.0-workflow-deno-20250616132510 → 0.0.0-working-memory-per-user-20250620161509

package/CHANGELOG.md

@@ -1,6 +1,28 @@
 # @mastra/upstash
 
-## 0.0.0-workflow-deno-20250616132510
+## 0.0.0-working-memory-per-user-20250620161509
+
+### Patch Changes
+
+- d8f2d19: Add updateMessages API to storage classes (only support for PG and LibSQL for now) and to memory class. Additionally allow for metadata to be saved in the content field of a message.
+- 2097952: [MASTRA-4021] Fix PG getMessages and update messageLimit for all storage adapters
+- Updated dependencies [d8f2d19]
+- Updated dependencies [9d52b17]
+- Updated dependencies [2097952]
+- Updated dependencies [8ba1b51]
+  - @mastra/core@0.0.0-working-memory-per-user-20250620161509
+
+## 0.11.1-alpha.0
+
+### Patch Changes
+
+- d8f2d19: Add updateMessages API to storage classes (only support for PG and LibSQL for now) and to memory class. Additionally allow for metadata to be saved in the content field of a message.
+- Updated dependencies [d8f2d19]
+- Updated dependencies [9d52b17]
+- Updated dependencies [8ba1b51]
+  - @mastra/core@0.10.7-alpha.0
+
+## 0.11.0
 
 ### Minor Changes
 
@@ -15,15 +37,51 @@
 
 ### Patch Changes
 
+- 2fda031: Clarify upstash argument concepts.
+- e8fdbdd: Fix dynamic require of crypto using upstash.
+  caused by a bad import was used in the monorepo
+
+  Fixes #4801
+
 - Updated dependencies [63f6b7d]
+- Updated dependencies [12a95fc]
+- Updated dependencies [4b0f8a6]
+- Updated dependencies [51264a5]
+- Updated dependencies [8e6f677]
+- Updated dependencies [d70c420]
 - Updated dependencies [ee9af57]
 - Updated dependencies [36f1c36]
+- Updated dependencies [2a16996]
 - Updated dependencies [10d352e]
-- Updated dependencies [b0c32de]
+- Updated dependencies [9589624]
 - Updated dependencies [53d3c37]
+- Updated dependencies [751c894]
+- Updated dependencies [577ce3a]
+- Updated dependencies [9260b3a]
+  - @mastra/core@0.10.6
+
+## 0.11.0-alpha.2
+
+### Patch Changes
+
+- e8fdbdd: Fix dynamic require of crypto using upstash.
+  caused by a bad import was used in the monorepo
+
+  Fixes #4801
+
+- Updated dependencies [9589624]
+  - @mastra/core@0.10.6-alpha.4
+
+## 0.11.0-alpha.1
+
+### Patch Changes
+
+- 2fda031: Clarify upstash argument concepts.
+- Updated dependencies [ee9af57]
+- Updated dependencies [751c894]
 - Updated dependencies [577ce3a]
 - Updated dependencies [9260b3a]
-  - @mastra/core@0.0.0-workflow-deno-20250616132510
+  - @mastra/core@0.10.6-alpha.1
 
 ## 0.11.0-alpha.0
 

package/README.md

@@ -13,6 +13,7 @@ npm install @mastra/upstash
 ```typescript
 import { UpstashVector } from '@mastra/upstash';
 
+// In upstash they refer to the store as an index
 const vectorStore = new UpstashVector({
   url: process.env.UPSTASH_VECTOR_REST_URL,
   token: process.env.UPSTASH_VECTOR_TOKEN
@@ -27,6 +28,9 @@ const ids = await vectorStore.upsert({
   metadata
 });
 
+// There is no store.createIndex call here, Upstash creates indexes (known as namespaces in Upstash) automatically
+// when you upsert if that namespace does not exist yet.
+
 // Query vectors
 const results = await vectorStore.query({
   indexName: 'my-namespace',

package/dist/_tsup-dts-rollup.d.cts

@@ -5,8 +5,9 @@ import type { DeleteVectorParams } from '@mastra/core/vector';
 import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
+import type { MastraMessageContentV2 } from '@mastra/core/agent';
 import type { MastraMessageV1 } from '@mastra/core/memory';
-import type { MastraMessageV2 } from '@mastra/core/memory';
+import type { MastraMessageV2 } from '@mastra/core/agent';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
@@ -17,6 +18,7 @@ import type { QueryVectorParams } from '@mastra/core/vector';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
 import type { StorageGetTracesArg } from '@mastra/core/storage';
+import type { StorageResourceType } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import type { TABLE_NAMES } from '@mastra/core/storage';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -60,6 +62,7 @@ declare class UpstashStore extends MastraStorage {
     constructor(config: UpstashConfig);
     get supports(): {
         selectByIncludeResourceScope: boolean;
+        resourceWorkingMemory: boolean;
     };
     private transformEvalRecord;
     private parseJSON;
@@ -211,32 +214,87 @@ declare class UpstashStore extends MastraStorage {
         workflowName?: string;
     }): Promise<WorkflowRun | null>;
     close(): Promise<void>;
+    updateMessages(_args: {
+        messages: Partial<Omit<MastraMessageV2, 'createdAt'>> & {
+            id: string;
+            content?: {
+                metadata?: MastraMessageContentV2['metadata'];
+                content?: MastraMessageContentV2['content'];
+            };
+        }[];
+    }): Promise<MastraMessageV2[]>;
+    getResourceById({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageResourceType | null>;
+    saveResource({ resource }: {
+        resource: StorageResourceType;
+    }): Promise<StorageResourceType>;
+    updateResource({ resourceId, workingMemory, metadata, }: {
+        resourceId: string;
+        workingMemory?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<StorageResourceType>;
 }
 export { UpstashStore }
 export { UpstashStore as UpstashStore_alias_1 }
 
 declare class UpstashVector extends MastraVector {
     private client;
+    /**
+     * Creates a new UpstashVector instance.
+     * @param {object} params - The parameters for the UpstashVector.
+     * @param {string} params.url - The URL of the Upstash vector index.
+     * @param {string} params.token - The token for the Upstash vector index.
+     */
     constructor({ url, token }: {
         url: string;
         token: string;
     });
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Upserts vectors into the index.
+     * @param {UpsertVectorParams} params - The parameters for the upsert operation.
+     * @returns {Promise<string[]>} A promise that resolves to the IDs of the upserted vectors.
+     */
+    upsert({ indexName: namespace, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Transforms a Mastra vector filter into an Upstash-compatible filter string.
+     * @param {VectorFilter} [filter] - The filter to transform.
+     * @returns {string | undefined} The transformed filter string, or undefined if no filter is provided.
+     */
     transformFilter(filter?: VectorFilter): string | undefined;
+    /**
+     * Creates a new index. For Upstash, this is a no-op as indexes (known as namespaces in Upstash) are created on-the-fly.
+     * @param {CreateIndexParams} _params - The parameters for creating the index (ignored).
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
+     */
     createIndex(_params: CreateIndexParams): Promise<void>;
-    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Queries the vector index.
+     * @param {QueryVectorParams} params - The parameters for the query operation. indexName is the namespace in Upstash.
+     * @returns {Promise<QueryResult[]>} A promise that resolves to the query results.
+     */
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Lists all namespaces in the Upstash vector index, which correspond to indexes.
+     * @returns {Promise<string[]>} A promise that resolves to a list of index names.
+     */
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param {string} indexName - The name of the index to describe
+     * @param {string} indexName - The name of the namespace to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    describeIndex({ indexName: namespace }: DescribeIndexParams): Promise<IndexStats>;
+    /**
+     * Deletes an index (namespace).
+     * @param {DeleteIndexParams} params - The parameters for the delete operation.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     */
+    deleteIndex({ indexName: namespace }: DeleteIndexParams): Promise<void>;
     /**
      * Updates a vector by its ID with the provided vector and/or metadata.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace containing the vector.
      * @param id - The ID of the vector to update.
      * @param update - An object containing the vector and/or metadata to update.
      * @param update.vector - An optional array of numbers representing the new vector.
@@ -244,15 +302,15 @@ declare class UpstashVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace containing the vector.
      * @param id - The ID of the vector to delete.
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    deleteVector({ indexName: namespace, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }

package/dist/_tsup-dts-rollup.d.ts

@@ -5,8 +5,9 @@ import type { DeleteVectorParams } from '@mastra/core/vector';
 import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
+import type { MastraMessageContentV2 } from '@mastra/core/agent';
 import type { MastraMessageV1 } from '@mastra/core/memory';
-import type { MastraMessageV2 } from '@mastra/core/memory';
+import type { MastraMessageV2 } from '@mastra/core/agent';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
@@ -17,6 +18,7 @@ import type { QueryVectorParams } from '@mastra/core/vector';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
 import type { StorageGetTracesArg } from '@mastra/core/storage';
+import type { StorageResourceType } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import type { TABLE_NAMES } from '@mastra/core/storage';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -60,6 +62,7 @@ declare class UpstashStore extends MastraStorage {
     constructor(config: UpstashConfig);
     get supports(): {
         selectByIncludeResourceScope: boolean;
+        resourceWorkingMemory: boolean;
     };
     private transformEvalRecord;
     private parseJSON;
@@ -211,32 +214,87 @@ declare class UpstashStore extends MastraStorage {
         workflowName?: string;
     }): Promise<WorkflowRun | null>;
     close(): Promise<void>;
+    updateMessages(_args: {
+        messages: Partial<Omit<MastraMessageV2, 'createdAt'>> & {
+            id: string;
+            content?: {
+                metadata?: MastraMessageContentV2['metadata'];
+                content?: MastraMessageContentV2['content'];
+            };
+        }[];
+    }): Promise<MastraMessageV2[]>;
+    getResourceById({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageResourceType | null>;
+    saveResource({ resource }: {
+        resource: StorageResourceType;
+    }): Promise<StorageResourceType>;
+    updateResource({ resourceId, workingMemory, metadata, }: {
+        resourceId: string;
+        workingMemory?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<StorageResourceType>;
 }
 export { UpstashStore }
 export { UpstashStore as UpstashStore_alias_1 }
 
 declare class UpstashVector extends MastraVector {
     private client;
+    /**
+     * Creates a new UpstashVector instance.
+     * @param {object} params - The parameters for the UpstashVector.
+     * @param {string} params.url - The URL of the Upstash vector index.
+     * @param {string} params.token - The token for the Upstash vector index.
+     */
     constructor({ url, token }: {
         url: string;
         token: string;
     });
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Upserts vectors into the index.
+     * @param {UpsertVectorParams} params - The parameters for the upsert operation.
+     * @returns {Promise<string[]>} A promise that resolves to the IDs of the upserted vectors.
+     */
+    upsert({ indexName: namespace, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Transforms a Mastra vector filter into an Upstash-compatible filter string.
+     * @param {VectorFilter} [filter] - The filter to transform.
+     * @returns {string | undefined} The transformed filter string, or undefined if no filter is provided.
+     */
     transformFilter(filter?: VectorFilter): string | undefined;
+    /**
+     * Creates a new index. For Upstash, this is a no-op as indexes (known as namespaces in Upstash) are created on-the-fly.
+     * @param {CreateIndexParams} _params - The parameters for creating the index (ignored).
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
+     */
     createIndex(_params: CreateIndexParams): Promise<void>;
-    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Queries the vector index.
+     * @param {QueryVectorParams} params - The parameters for the query operation. indexName is the namespace in Upstash.
+     * @returns {Promise<QueryResult[]>} A promise that resolves to the query results.
+     */
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Lists all namespaces in the Upstash vector index, which correspond to indexes.
+     * @returns {Promise<string[]>} A promise that resolves to a list of index names.
+     */
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param {string} indexName - The name of the index to describe
+     * @param {string} indexName - The name of the namespace to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    describeIndex({ indexName: namespace }: DescribeIndexParams): Promise<IndexStats>;
+    /**
+     * Deletes an index (namespace).
+     * @param {DeleteIndexParams} params - The parameters for the delete operation.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     */
+    deleteIndex({ indexName: namespace }: DeleteIndexParams): Promise<void>;
     /**
      * Updates a vector by its ID with the provided vector and/or metadata.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace containing the vector.
      * @param id - The ID of the vector to update.
      * @param update - An object containing the vector and/or metadata to update.
      * @param update.vector - An optional array of numbers representing the new vector.
@@ -244,15 +302,15 @@ declare class UpstashVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace containing the vector.
      * @param id - The ID of the vector to delete.
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    deleteVector({ indexName: namespace, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }