@mastra/mongodb 1.5.3 → 1.5.4-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mastra/mongodb
 
+## 1.5.4-alpha.0
+
+### Patch Changes
+
+- Fixed MongoDB observational memory buffering so legacy records with `bufferedObservationChunks: null` can append chunks safely and continue storing chunk buffers as arrays after activation. ([#13803](https://github.com/mastra-ai/mastra/pull/13803))
+
+- Updated dependencies [[`41e48c1`](https://github.com/mastra-ai/mastra/commit/41e48c198eee846478e60c02ec432c19d322a517), [`82469d3`](https://github.com/mastra-ai/mastra/commit/82469d3135d5a49dd8dc8feec0ff398b4e0225a0), [`33e2fd5`](https://github.com/mastra-ai/mastra/commit/33e2fd5088f83666df17401e2da68c943dbc0448), [`7ef6e2c`](https://github.com/mastra-ai/mastra/commit/7ef6e2c61be5a42e26f55d15b5902866fc76634f), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`fa37d39`](https://github.com/mastra-ai/mastra/commit/fa37d39910421feaf8847716292e3d65dd4f30c2), [`b12d2a5`](https://github.com/mastra-ai/mastra/commit/b12d2a59a48be0477cabae66eb6cf0fc94a7d40d), [`71c38bf`](https://github.com/mastra-ai/mastra/commit/71c38bf905905148ecd0e75c07c1f9825d299b76), [`f993c38`](https://github.com/mastra-ai/mastra/commit/f993c3848c97479b813231be872443bedeced6ab), [`f51849a`](https://github.com/mastra-ai/mastra/commit/f51849a568935122b5100b7ee69704e6d680cf7b), [`9bf3a0d`](https://github.com/mastra-ai/mastra/commit/9bf3a0dac602787925f1762f1f0387d7b4a59620), [`cafa045`](https://github.com/mastra-ai/mastra/commit/cafa0453c9de141ad50c09a13894622dffdd9978), [`1fd9ddb`](https://github.com/mastra-ai/mastra/commit/1fd9ddbb3fe83b281b12bd2e27e426ae86288266), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443), [`d9d228c`](https://github.com/mastra-ai/mastra/commit/d9d228c0c6ae82ae6ce3b540a3a56b2b1c2b8d98), [`5576507`](https://github.com/mastra-ai/mastra/commit/55765071e360fb97e443aa0a91ccf7e1cd8d92aa), [`79d69c9`](https://github.com/mastra-ai/mastra/commit/79d69c9d5f842ff1c31352fb6026f04c1f6190f3), [`94f44b8`](https://github.com/mastra-ai/mastra/commit/94f44b827ce57b179e50f4916a84c0fa6e7f3b8c), [`13187db`](https://github.com/mastra-ai/mastra/commit/13187dbac880174232dedc5a501ff6c5d0fe59bc), [`2ae5311`](https://github.com/mastra-ai/mastra/commit/2ae531185fff66a80fa165c0999e3d801900e89d), [`6135ef4`](https://github.com/mastra-ai/mastra/commit/6135ef4f5288652bf45f616ec590607e4c95f443)]:
+  - @mastra/core@1.10.0-alpha.0
+
 ## 1.5.3
 
 ### Patch Changes

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.3",
+  "version": "1.5.4-alpha.0",
   "package": "@mastra/mongodb",
   "exports": {},
   "modules": {}

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

@@ -44,15 +44,15 @@ const storage = new MongoDBStore({
 
 ## Parameters
 
-**id:** (`string`): Unique identifier for this storage instance.
+**id** (`string`): Unique identifier for this storage instance.
 
-**uri:** (`string`): MongoDB connection string (e.g., mongodb+srv://user:password\@cluster.mongodb.net)
+**uri** (`string`): MongoDB connection string (e.g., mongodb+srv://user:password\@cluster.mongodb.net)
 
-**url?:** (`string`): Deprecated. Use uri instead. MongoDB connection string (supported for backward compatibility).
+**url** (`string`): Deprecated. Use uri instead. MongoDB connection string (supported for backward compatibility).
 
-**dbName:** (`string`): The name of the database you want the storage to use.
+**dbName** (`string`): The name of the database you want the storage to use.
 
-**options?:** (`MongoClientOptions`): MongoDB client options for advanced configuration (SSL, connection pooling, etc.).
+**options** (`MongoClientOptions`): MongoDB client options for advanced configuration (SSL, connection pooling, etc.).
 
 > **Deprecation Notice:** The `url` parameter is deprecated but still supported for backward compatibility. Please use `uri` instead in all new code.
 

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

@@ -57,15 +57,15 @@ const store = new MongoDBVector({
 
 ## Constructor Options
 
-**id:** (`string`): Unique identifier for this vector store instance
+**id** (`string`): Unique identifier for this vector store instance
 
-**uri:** (`string`): MongoDB connection string
+**uri** (`string`): MongoDB connection string
 
-**dbName:** (`string`): Name of the MongoDB database to use
+**dbName** (`string`): Name of the MongoDB database to use
 
-**options?:** (`MongoClientOptions`): Optional MongoDB client options
+**options** (`MongoClientOptions`): Optional MongoDB client options
 
-**embeddingFieldPath?:** (`string`): Path to the field that stores vector embeddings. Supports nested paths using dot notation (e.g., 'text.contentEmbedding'). (Default: `embedding`)
+**embeddingFieldPath** (`string`): Path to the field that stores vector embeddings. Supports nested paths using dot notation (e.g., 'text.contentEmbedding'). (Default: `embedding`)
 
 ## Methods
 
@@ -73,47 +73,47 @@ const store = new MongoDBVector({
 
 Creates a new vector index (collection) in MongoDB.
 
-**indexName:** (`string`): Name of the collection to create
+**indexName** (`string`): Name of the collection to create
 
-**dimension:** (`number`): Vector dimension (must match your embedding model)
+**dimension** (`number`): Vector dimension (must match your embedding model)
 
-**metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
 
 ### upsert()
 
 Adds or updates vectors and their metadata in the collection.
 
-**indexName:** (`string`): Name of the collection to insert into
+**indexName** (`string`): Name of the collection to insert into
 
-**vectors:** (`number[][]`): Array of embedding vectors
+**vectors** (`number[][]`): Array of embedding vectors
 
-**metadata?:** (`Record<string, any>[]`): Metadata for each vector
+**metadata** (`Record<string, any>[]`): Metadata for each vector
 
-**ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
+**ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
 
 ### query()
 
 Searches for similar vectors with optional metadata filtering.
 
-**indexName:** (`string`): Name of the collection to search in
+**indexName** (`string`): Name of the collection to search in
 
-**queryVector:** (`number[]`): Query vector to find similar vectors for
+**queryVector** (`number[]`): Query vector to find similar vectors for
 
-**topK?:** (`number`): Number of results to return (Default: `10`)
+**topK** (`number`): Number of results to return (Default: `10`)
 
-**filter?:** (`Record<string, any>`): Metadata filters (applies to the \`metadata\` field)
+**filter** (`Record<string, any>`): Metadata filters (applies to the \`metadata\` field)
 
-**documentFilter?:** (`Record<string, any>`): Filters on original document fields (not just metadata)
+**documentFilter** (`Record<string, any>`): Filters on original document fields (not just metadata)
 
-**includeVector?:** (`boolean`): Whether to include vector data in results (Default: `false`)
+**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
 
-**minScore?:** (`number`): Minimum similarity score threshold (Default: `0`)
+**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
 
 ### describeIndex()
 
 Returns information about the index (collection).
 
-**indexName:** (`string`): Name of the collection to describe
+**indexName** (`string`): Name of the collection to describe
 
 Returns:
 
@@ -129,7 +129,7 @@ interface IndexStats {
 
 Deletes a collection and all its data.
 
-**indexName:** (`string`): Name of the collection to delete
+**indexName** (`string`): Name of the collection to delete
 
 ### listIndexes()
 
@@ -141,35 +141,35 @@ Returns: `Promise<string[]>`
 
 Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
 
-**indexName:** (`string`): Name of the collection containing the vector
+**indexName** (`string`): Name of the collection containing the vector
 
-**id?:** (`string`): ID of the vector entry to update (mutually exclusive with filter)
+**id** (`string`): ID of the vector entry to update (mutually exclusive with filter)
 
-**filter?:** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
+**filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
 
-**update:** (`object`): Update data containing vector and/or metadata
+**update** (`object`): Update data containing vector and/or metadata
 
-**update.vector?:** (`number[]`): New vector data to update
+**update.vector** (`number[]`): New vector data to update
 
-**update.metadata?:** (`Record<string, any>`): New metadata to update
+**update.metadata** (`Record<string, any>`): New metadata to update
 
 ### deleteVector()
 
 Deletes a specific vector entry from an index by its ID.
 
-**indexName:** (`string`): Name of the collection containing the vector
+**indexName** (`string`): Name of the collection containing the vector
 
-**id:** (`string`): ID of the vector entry to delete
+**id** (`string`): ID of the vector entry to delete
 
 ### deleteVectors()
 
 Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
 
-**indexName:** (`string`): Name of the collection containing the vectors to delete
+**indexName** (`string`): Name of the collection containing the vectors to delete
 
-**ids?:** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
+**ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
 
-**filter?:** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
+**filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
 
 ### disconnect()
 

package/dist/index.cjs

@@ -14,7 +14,7 @@ var evals = require('@mastra/core/evals');
 
 // package.json
 var package_default = {
-  version: "1.5.3"};
+  version: "1.5.4-alpha.0"};
 var MongoDBFilterTranslator = class extends filter.BaseFilterTranslator {
   getSupportedOperators() {
     return {
@@ -3796,7 +3796,7 @@ var MemoryStorageMongoDB = class _MemoryStorageMongoDB extends storage.MemorySto
       generationCount: Number(doc.generationCount || 0),
       activeObservations: doc.activeObservations || "",
       // Handle new chunk-based structure
-      bufferedObservationChunks: doc.bufferedObservationChunks || void 0,
+      bufferedObservationChunks: Array.isArray(doc.bufferedObservationChunks) ? doc.bufferedObservationChunks : void 0,
       // Deprecated fields (for backward compatibility)
       bufferedObservations: doc.activeObservationsPendingUpdate || void 0,
       bufferedObservationTokens: doc.bufferedObservationTokens ? Number(doc.bufferedObservationTokens) : void 0,
@@ -3947,7 +3947,7 @@ var MemoryStorageMongoDB = class _MemoryStorageMongoDB extends storage.MemorySto
         totalTokensObserved: record.totalTokensObserved || 0,
         observationTokenCount: record.observationTokenCount || 0,
         observedMessageIds: record.observedMessageIds || null,
-        bufferedObservationChunks: record.bufferedObservationChunks || null,
+        bufferedObservationChunks: Array.isArray(record.bufferedObservationChunks) ? record.bufferedObservationChunks : [],
         bufferedReflection: record.bufferedReflection || null,
         bufferedReflectionTokens: record.bufferedReflectionTokens ?? null,
         bufferedReflectionInputTokens: record.bufferedReflectionInputTokens ?? null,
@@ -4288,17 +4288,17 @@ var MemoryStorageMongoDB = class _MemoryStorageMongoDB extends storage.MemorySto
         suggestedContinuation: input.chunk.suggestedContinuation,
         currentTask: input.chunk.currentTask
       };
-      const $set = { updatedAt: /* @__PURE__ */ new Date() };
+      const now = /* @__PURE__ */ new Date();
+      const setStage = {
+        updatedAt: now,
+        bufferedObservationChunks: {
+          $concatArrays: [{ $ifNull: ["$bufferedObservationChunks", []] }, [newChunk]]
+        }
+      };
       if (input.lastBufferedAtTime) {
-        $set.lastBufferedAtTime = input.lastBufferedAtTime;
+        setStage.lastBufferedAtTime = input.lastBufferedAtTime;
       }
-      const result = await collection.updateOne(
-        { id: input.id },
-        {
-          $push: { bufferedObservationChunks: newChunk },
-          $set
-        }
-      );
+      const result = await collection.updateOne({ id: input.id }, [{ $set: setStage }]);
       if (result.matchedCount === 0) {
         throw new error.MastraError({
           id: storage.createStorageErrorId("MONGODB", "UPDATE_BUFFERED_OBSERVATIONS", "NOT_FOUND"),
@@ -4411,7 +4411,7 @@ ${activatedContent}` : activatedContent;
             activeObservations: newActive,
             observationTokenCount: newTokenCount,
             pendingMessageTokens: newPending,
-            bufferedObservationChunks: remainingChunks.length > 0 ? remainingChunks : null,
+            bufferedObservationChunks: remainingChunks,
             lastObservedAt,
             updatedAt: /* @__PURE__ */ new Date()
           }