@mastra/upstash 0.12.4-alpha.0 → 0.13.0-alpha.2

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/upstash@0.12.4-alpha.0 build /home/runner/work/mastra/mastra/stores/upstash
+> @mastra/upstash@0.13.0-alpha.2 build /home/runner/work/mastra/mastra/stores/upstash
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 TSC Build start
-TSC ⚡️ Build success in 11022ms
+TSC ⚡️ Build success in 10556ms
 DTS Build start
+CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/upstash/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/upstash/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 13901ms
-CLI Target: es2022
+DTS ⚡️ Build success in 15161ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 73.33 KB
-ESM ⚡️ Build success in 1893ms
-CJS dist/index.cjs 74.17 KB
-CJS ⚡️ Build success in 1887ms
+ESM dist/index.js 75.40 KB
+ESM ⚡️ Build success in 1933ms
+CJS dist/index.cjs 76.30 KB
+CJS ⚡️ Build success in 1938ms

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @mastra/upstash
 
+## 0.13.0-alpha.2
+
+### Minor Changes
+
+- f42c4c2: update peer deps for packages to latest core range
+
+### Patch Changes
+
+- @mastra/core@0.12.0-alpha.5
+
+## 0.12.4-alpha.1
+
+### Patch Changes
+
+- b92bc89: Added hybrid search support to @mastra/upstash vector store. Supports sparse vectors, fusion algorithm, and query mode.
+- b8efbb9: feat: add flexible deleteMessages method to memory API
+  - Added `memory.deleteMessages(input)` method that accepts multiple input types:
+    - Single message ID as string: `deleteMessages('msg-123')`
+    - Array of message IDs: `deleteMessages(['msg-1', 'msg-2'])`
+    - Message object with id property: `deleteMessages({ id: 'msg-123' })`
+    - Array of message objects: `deleteMessages([{ id: 'msg-1' }, { id: 'msg-2' }])`
+  - Implemented in all storage adapters (LibSQL, PostgreSQL, Upstash, InMemory)
+  - Added REST API endpoint: `POST /api/memory/messages/delete`
+  - Updated client SDK: `thread.deleteMessages()` accepts all input types
+  - Updates thread timestamps when messages are deleted
+  - Added comprehensive test coverage and documentation
+
+- Updated dependencies [27cc97a]
+- Updated dependencies [41daa63]
+- Updated dependencies [254a36b]
+- Updated dependencies [0b89602]
+- Updated dependencies [4d37822]
+- Updated dependencies [ff9c125]
+- Updated dependencies [b8efbb9]
+- Updated dependencies [71466e7]
+- Updated dependencies [0c99fbe]
+  - @mastra/core@0.12.0-alpha.2
+
 ## 0.12.4-alpha.0
 
 ### Patch Changes

package/README.md

@@ -41,6 +41,100 @@ const results = await vectorStore.query({
 });
 ```
 
+### Hybrid Vector Search (Dense + Sparse)
+
+Upstash supports hybrid search that combines semantic search (dense vectors) with keyword-based search (sparse vectors) for improved relevance and accuracy.
+
+#### Upserting Hybrid Vectors
+
+```typescript
+import { UpstashVector } from '@mastra/upstash';
+
+const vectorStore = new UpstashVector({
+  url: process.env.UPSTASH_VECTOR_REST_URL,
+  token: process.env.UPSTASH_VECTOR_TOKEN
+});
+
+const vectors = [[0.1, 0.2, 0.3, ...], [0.4, 0.5, 0.6, ...]];
+const sparseVectors = [
+  { indices: [1, 5, 10], values: [0.8, 0.6, 0.4] },
+  { indices: [2, 6, 11], values: [0.7, 0.5, 0.3] }
+];
+const metadata = [{ title: 'Document 1' }, { title: 'Document 2' }];
+
+const ids = await vectorStore.upsert({
+  indexName: 'hybrid-index',
+  vectors,
+  sparseVectors,
+  metadata
+});
+```
+
+#### Querying with Hybrid Search
+
+```typescript
+import { FusionAlgorithm, QueryMode } from '@upstash/vector';
+
+// Query with both dense and sparse vectors (default hybrid mode)
+const results = await vectorStore.query({
+  indexName: 'hybrid-index',
+  queryVector: [0.1, 0.2, 0.3, ...],
+  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
+  topK: 10,
+  fusionAlgorithm: FusionAlgorithm.RRF,
+  includeVector: false
+});
+
+// Dense-only query (backward compatible)
+const denseResults = await vectorStore.query({
+  indexName: 'hybrid-index',
+  queryVector: [0.1, 0.2, 0.3, ...],
+  topK: 10
+});
+
+// Query only the dense component for custom reranking
+const denseOnlyResults = await vectorStore.query({
+  indexName: 'hybrid-index',
+  queryVector: [0.1, 0.2, 0.3, ...],
+  queryMode: QueryMode.DENSE,
+  topK: 10
+});
+
+// Query only the sparse component for custom reranking
+const sparseOnlyResults = await vectorStore.query({
+  indexName: 'hybrid-index',
+  queryVector: [0.1, 0.2, 0.3, ...],              // Still needed for dense index structure
+  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
+  queryMode: QueryMode.SPARSE,
+  topK: 10
+});
+
+// Explicit hybrid mode (same as default)
+const explicitHybridResults = await vectorStore.query({
+  indexName: 'hybrid-index',
+  queryVector: [0.1, 0.2, 0.3, ...],
+  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
+  queryMode: QueryMode.HYBRID,
+  fusionAlgorithm: FusionAlgorithm.RRF,
+  topK: 10
+});
+```
+
+#### Fusion Algorithms & Query Modes
+
+Upstash provides built-in fusion algorithms to combine dense and sparse search results:
+
+- **RRF (Reciprocal Rank Fusion)**: Default algorithm that combines rankings from both dense and sparse searches
+- **DBSF (Distribution-Based Score Fusion)**
+
+Query modes enable fine-grained control over hybrid index queries:
+
+- **`QueryMode.HYBRID`**: Default mode that queries both dense and sparse components and fuses results
+- **`QueryMode.DENSE`**: Query only the dense component, useful for custom reranking scenarios
+- **`QueryMode.SPARSE`**: Query only the sparse component, useful for custom reranking scenarios
+
+Use query modes when you want to implement custom fusion logic or need separate dense/sparse results for advanced reranking algorithms.
+
 ### Vector Store Configuration
 
 The Upstash vector store requires the following configuration:
@@ -70,13 +164,17 @@ The Upstash store requires the following configuration:
 ## Features
 
 - Serverless vector database and key-value store
+- **Hybrid vector search** combining dense and sparse vectors
+- **Advanced fusion algorithms** (RRF) for optimal search ranking
 - Pay-per-use pricing
 - Low latency global access
 - REST API interface
 - Built-in vector similarity search
 - Durable storage for chat history and agent memory
+- Backward compatible with existing dense vector implementations
 
 ## Related Links
 
 - [Upstash Vector Documentation](https://docs.upstash.com/vector)
+- [Upstash Hybrid Indexes Documentation](https://docs.upstash.com/vector/features/hybridindexes)
 - [Upstash Redis Documentation](https://docs.upstash.com/redis)

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

@@ -4,6 +4,7 @@ import type { DeleteIndexParams } from '@mastra/core/vector';
 import type { DeleteVectorParams } from '@mastra/core/vector';
 import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
+import type { FusionAlgorithm } from '@upstash/vector';
 import type { IndexStats } from '@mastra/core/vector';
 import { LegacyEvalsStorage } from '@mastra/core/storage';
 import type { MastraMessageContentV2 } from '@mastra/core/agent';
@@ -17,6 +18,7 @@ import type { OperatorSupport } from '@mastra/core/vector/filter';
 import type { OperatorValueMap } from '@mastra/core/vector/filter';
 import type { PaginationArgs } from '@mastra/core/storage';
 import type { PaginationInfo } from '@mastra/core/storage';
+import type { QueryMode } from '@upstash/vector';
 import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { Redis } from '@upstash/redis';
@@ -219,6 +221,7 @@ export declare class StoreMemoryUpstash extends MemoryStorage {
             };
         })[];
     }): Promise<MastraMessageV2_2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
 }
 
 export declare class StoreOperationsUpstash extends StoreOperations {
@@ -315,7 +318,16 @@ declare type UpstashOperatorValueMap = Omit<OperatorValueMap, '$options' | '$ele
     $contains: string;
 };
 
-declare type UpstashQueryVectorParams = QueryVectorParams<UpstashVectorFilter>;
+export declare interface UpstashQueryVectorParams extends QueryVectorParams<UpstashVectorFilter> {
+    sparseVector?: UpstashSparseVector;
+    fusionAlgorithm?: FusionAlgorithm;
+    queryMode?: QueryMode;
+}
+
+export declare interface UpstashSparseVector {
+    indices: number[];
+    values: number[];
+}
 
 declare class UpstashStore extends MastraStorage {
     private redis;
@@ -326,6 +338,7 @@ declare class UpstashStore extends MastraStorage {
         resourceWorkingMemory: boolean;
         hasColumn: boolean;
         createTable: boolean;
+        deleteMessages: boolean;
     };
     /**
      * @deprecated Use getEvals instead
@@ -472,6 +485,7 @@ declare class UpstashStore extends MastraStorage {
             };
         })[];
     }): Promise<MastraMessageV2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     getResourceById({ resourceId }: {
         resourceId: string;
     }): Promise<StorageResourceType | null>;
@@ -515,6 +529,18 @@ declare class UpstashStore extends MastraStorage {
 export { UpstashStore }
 export { UpstashStore as UpstashStore_alias_1 }
 
+export declare interface UpstashUpdateVectorParams extends UpdateVectorParams {
+    update: {
+        vector?: number[];
+        metadata?: Record<string, any>;
+        sparseVector?: UpstashSparseVector;
+    };
+}
+
+export declare interface UpstashUpsertVectorParams extends UpsertVectorParams {
+    sparseVectors?: UpstashSparseVector[];
+}
+
 declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
     private client;
     /**
@@ -532,7 +558,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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[]>;
+    upsert({ indexName: namespace, vectors, metadata, ids, sparseVectors, }: UpstashUpsertVectorParams): Promise<string[]>;
     /**
      * Transforms a Mastra vector filter into an Upstash-compatible filter string.
      * @param {UpstashVectorFilter} [filter] - The filter to transform.
@@ -550,7 +576,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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, }: UpstashQueryVectorParams): Promise<QueryResult[]>;
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, sparseVector, fusionAlgorithm, queryMode, }: UpstashQueryVectorParams): 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.
@@ -579,7 +605,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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: namespace, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpstashUpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the namespace containing the vector.

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

@@ -4,6 +4,7 @@ import type { DeleteIndexParams } from '@mastra/core/vector';
 import type { DeleteVectorParams } from '@mastra/core/vector';
 import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
+import type { FusionAlgorithm } from '@upstash/vector';
 import type { IndexStats } from '@mastra/core/vector';
 import { LegacyEvalsStorage } from '@mastra/core/storage';
 import type { MastraMessageContentV2 } from '@mastra/core/agent';
@@ -17,6 +18,7 @@ import type { OperatorSupport } from '@mastra/core/vector/filter';
 import type { OperatorValueMap } from '@mastra/core/vector/filter';
 import type { PaginationArgs } from '@mastra/core/storage';
 import type { PaginationInfo } from '@mastra/core/storage';
+import type { QueryMode } from '@upstash/vector';
 import type { QueryResult } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { Redis } from '@upstash/redis';
@@ -219,6 +221,7 @@ export declare class StoreMemoryUpstash extends MemoryStorage {
             };
         })[];
     }): Promise<MastraMessageV2_2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
 }
 
 export declare class StoreOperationsUpstash extends StoreOperations {
@@ -315,7 +318,16 @@ declare type UpstashOperatorValueMap = Omit<OperatorValueMap, '$options' | '$ele
     $contains: string;
 };
 
-declare type UpstashQueryVectorParams = QueryVectorParams<UpstashVectorFilter>;
+export declare interface UpstashQueryVectorParams extends QueryVectorParams<UpstashVectorFilter> {
+    sparseVector?: UpstashSparseVector;
+    fusionAlgorithm?: FusionAlgorithm;
+    queryMode?: QueryMode;
+}
+
+export declare interface UpstashSparseVector {
+    indices: number[];
+    values: number[];
+}
 
 declare class UpstashStore extends MastraStorage {
     private redis;
@@ -326,6 +338,7 @@ declare class UpstashStore extends MastraStorage {
         resourceWorkingMemory: boolean;
         hasColumn: boolean;
         createTable: boolean;
+        deleteMessages: boolean;
     };
     /**
      * @deprecated Use getEvals instead
@@ -472,6 +485,7 @@ declare class UpstashStore extends MastraStorage {
             };
         })[];
     }): Promise<MastraMessageV2[]>;
+    deleteMessages(messageIds: string[]): Promise<void>;
     getResourceById({ resourceId }: {
         resourceId: string;
     }): Promise<StorageResourceType | null>;
@@ -515,6 +529,18 @@ declare class UpstashStore extends MastraStorage {
 export { UpstashStore }
 export { UpstashStore as UpstashStore_alias_1 }
 
+export declare interface UpstashUpdateVectorParams extends UpdateVectorParams {
+    update: {
+        vector?: number[];
+        metadata?: Record<string, any>;
+        sparseVector?: UpstashSparseVector;
+    };
+}
+
+export declare interface UpstashUpsertVectorParams extends UpsertVectorParams {
+    sparseVectors?: UpstashSparseVector[];
+}
+
 declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
     private client;
     /**
@@ -532,7 +558,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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[]>;
+    upsert({ indexName: namespace, vectors, metadata, ids, sparseVectors, }: UpstashUpsertVectorParams): Promise<string[]>;
     /**
      * Transforms a Mastra vector filter into an Upstash-compatible filter string.
      * @param {UpstashVectorFilter} [filter] - The filter to transform.
@@ -550,7 +576,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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, }: UpstashQueryVectorParams): Promise<QueryResult[]>;
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, sparseVector, fusionAlgorithm, queryMode, }: UpstashQueryVectorParams): 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.
@@ -579,7 +605,7 @@ declare class UpstashVector extends MastraVector<UpstashVectorFilter> {
      * @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: namespace, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpstashUpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the namespace containing the vector.

package/dist/index.cjs

@@ -951,6 +951,60 @@ var StoreMemoryUpstash = class extends storage.MemoryStorage {
       );
     }
   }
+  async deleteMessages(messageIds) {
+    if (!messageIds || messageIds.length === 0) {
+      return;
+    }
+    try {
+      const threadIds = /* @__PURE__ */ new Set();
+      const messageKeys = [];
+      for (const messageId of messageIds) {
+        const pattern = getMessageKey("*", messageId);
+        const keys = await this.operations.scanKeys(pattern);
+        for (const key of keys) {
+          const message = await this.client.get(key);
+          if (message && message.id === messageId) {
+            messageKeys.push(key);
+            if (message.threadId) {
+              threadIds.add(message.threadId);
+            }
+            break;
+          }
+        }
+      }
+      if (messageKeys.length === 0) {
+        return;
+      }
+      const pipeline = this.client.pipeline();
+      for (const key of messageKeys) {
+        pipeline.del(key);
+      }
+      if (threadIds.size > 0) {
+        for (const threadId of threadIds) {
+          const threadKey = getKey(storage.TABLE_THREADS, { id: threadId });
+          const thread = await this.client.get(threadKey);
+          if (thread) {
+            const updatedThread = {
+              ...thread,
+              updatedAt: /* @__PURE__ */ new Date()
+            };
+            pipeline.set(threadKey, processRecord(storage.TABLE_THREADS, updatedThread).processedRecord);
+          }
+        }
+      }
+      await pipeline.exec();
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_UPSTASH_DELETE_MESSAGES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { messageIds: messageIds.join(", ") }
+        },
+        error$1
+      );
+    }
+  }
 };
 var StoreOperationsUpstash = class extends storage.StoreOperations {
   client;
@@ -1615,7 +1669,8 @@ var UpstashStore = class extends storage.MastraStorage {
       selectByIncludeResourceScope: true,
       resourceWorkingMemory: true,
       hasColumn: false,
-      createTable: false
+      createTable: false,
+      deleteMessages: true
     };
   }
   /**
@@ -1739,6 +1794,9 @@ var UpstashStore = class extends storage.MastraStorage {
   async updateMessages(args) {
     return this.stores.memory.updateMessages(args);
   }
+  async deleteMessages(messageIds) {
+    return this.stores.memory.deleteMessages(messageIds);
+  }
   async getResourceById({ resourceId }) {
     return this.stores.memory.getResourceById({ resourceId });
   }
@@ -1995,11 +2053,18 @@ var UpstashVector = class extends vector.MastraVector {
    * @param {UpsertVectorParams} params - The parameters for the upsert operation.
    * @returns {Promise<string[]>} A promise that resolves to the IDs of the upserted vectors.
    */
-  async upsert({ indexName: namespace, vectors, metadata, ids }) {
+  async upsert({
+    indexName: namespace,
+    vectors,
+    metadata,
+    ids,
+    sparseVectors
+  }) {
     const generatedIds = ids || vectors.map(() => crypto.randomUUID());
     const points = vectors.map((vector, index) => ({
       id: generatedIds[index],
       vector,
+      ...sparseVectors?.[index] && { sparseVector: sparseVectors[index] },
       metadata: metadata?.[index]
     }));
     try {
@@ -2046,7 +2111,10 @@ var UpstashVector = class extends vector.MastraVector {
     queryVector,
     topK = 10,
     filter,
-    includeVector = false
+    includeVector = false,
+    sparseVector,
+    fusionAlgorithm,
+    queryMode
   }) {
     try {
       const ns = this.client.namespace(namespace);
@@ -2054,9 +2122,12 @@ var UpstashVector = class extends vector.MastraVector {
       const results = await ns.query({
         topK,
         vector: queryVector,
+        ...sparseVector && { sparseVector },
         includeVectors: includeVector,
         includeMetadata: true,
-        ...filterString ? { filter: filterString } : {}
+        ...filterString ? { filter: filterString } : {},
+        ...fusionAlgorithm && { fusionAlgorithm },
+        ...queryMode && { queryMode }
       });
       return (results || []).map((result) => ({
         id: `${result.id}`,
@@ -2152,40 +2223,30 @@ var UpstashVector = class extends vector.MastraVector {
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
   async updateVector({ indexName: namespace, id, update }) {
-    try {
-      if (!update.vector && !update.metadata) {
-        throw new Error("No update data provided");
-      }
-      if (!update.vector && update.metadata) {
-        throw new Error("Both vector and metadata must be provided for an update");
-      }
-    } catch (error$1) {
-      throw new error.MastraError(
-        {
-          id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
-          domain: error.ErrorDomain.STORAGE,
-          category: error.ErrorCategory.THIRD_PARTY,
-          details: { namespace, id }
-        },
-        error$1
-      );
+    if (!update.vector && !update.metadata && !update.sparseVector) {
+      throw new error.MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.THIRD_PARTY,
+        details: { namespace, id },
+        text: "No update data provided"
+      });
     }
-    try {
-      const updatePayload = { id };
-      if (update.vector) {
-        updatePayload.vector = update.vector;
-      }
-      if (update.metadata) {
-        updatePayload.metadata = update.metadata;
-      }
-      const points = {
-        id: updatePayload.id,
-        vector: updatePayload.vector,
-        metadata: updatePayload.metadata
-      };
-      await this.client.upsert(points, {
-        namespace
+    if (!update.vector && !update.sparseVector && update.metadata) {
+      throw new error.MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.THIRD_PARTY,
+        details: { namespace, id },
+        text: "Both vector and metadata must be provided for an update"
       });
+    }
+    try {
+      const points = { id };
+      if (update.vector) points.vector = update.vector;
+      if (update.metadata) points.metadata = update.metadata;
+      if (update.sparseVector) points.sparseVector = update.sparseVector;
+      await this.client.upsert(points, { namespace });
     } catch (error$1) {
       throw new error.MastraError(
         {