@mastra/mongodb 1.24.1-alpha.1 → 1.25.0-alpha.0

package/README.md

@@ -57,7 +57,7 @@ await vectorDB.disconnect();
 ## Documentation
 
 - [MongoDB integration guide](https://mastra.ai/integrations/databases/mongodb)
-- [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb)
+- [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb)
 
 ## Changelog
 

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.24.1-alpha.1"
+  version: "1.25.0-alpha.0"
 ---
 
 ## When to use
@@ -23,6 +23,7 @@ Read the individual reference documents for detailed explanations and code examp
 ### Integrations
 
 - [MongoDB](references/integrations-databases-mongodb.md) - Store Mastra application data and vectors in MongoDB, configure connections and collections, initialize schemas, and add persistent agent memory.
+- [MongoDB](references/integrations-vectors-mongodb.md) - Run MongoDB Vector Search from Mastra with automatic or manual embedding, metadata filtering, hybrid search, and indexing of existing collections.
 
 ### Reference
 
@@ -30,7 +31,6 @@ Read the individual reference documents for detailed explanations and code examp
 - [Storing embeddings in a vector database](references/reference-rag-vector-databases.md) - After generating embeddings, you need to store them in a database that supports vector similarity search.
 - [Reference: Composite storage](references/reference-storage-composite.md) - MastraCompositeStore can compose storage domains from different providers. Use it when you need different databases for different purposes.
 - [Reference: Storage retention (prune)](references/reference-storage-retention.md) - prune() deletes rows. It caps growth and is safe to run against large tables (batched, bounded, resumable, cancellable).
-- [Reference: MongoDB vector store](references/reference-vectors-mongodb.md) - The MongoDBVector class provides vector search using MongoDB Vector Search. It enables efficient similarity search and metadata filtering within your MongoDB collections.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/docs-memory-semantic-recall.md

@@ -141,24 +141,24 @@ const agent = new Agent({
 
 Each vector store page below includes installation instructions, configuration parameters, and usage examples:
 
-- [Astra](https://mastra.ai/reference/vectors/astra)
-- [Chroma](https://mastra.ai/reference/vectors/chroma)
-- [Cloudflare Vectorize](https://mastra.ai/reference/vectors/vectorize)
-- [Convex](https://mastra.ai/reference/vectors/convex)
-- [Couchbase](https://mastra.ai/reference/vectors/couchbase)
-- [DuckDB](https://mastra.ai/reference/vectors/duckdb)
-- [Elasticsearch](https://mastra.ai/reference/vectors/elasticsearch)
-- [LanceDB](https://mastra.ai/reference/vectors/lance)
-- [libSQL](https://mastra.ai/reference/vectors/libsql)
-- [MongoDB](https://mastra.ai/reference/vectors/mongodb)
-- [OpenSearch](https://mastra.ai/reference/vectors/opensearch)
-- [OracleDB](https://mastra.ai/reference/vectors/oracledb)
-- [Pinecone](https://mastra.ai/reference/vectors/pinecone)
-- [PostgreSQL](https://mastra.ai/reference/vectors/pg)
-- [Qdrant](https://mastra.ai/reference/vectors/qdrant)
-- [S3 Vectors](https://mastra.ai/reference/vectors/s3vectors)
-- [Turbopuffer](https://mastra.ai/reference/vectors/turbopuffer)
-- [Upstash](https://mastra.ai/reference/vectors/upstash)
+- [Astra](https://mastra.ai/integrations/vectors/astra)
+- [Chroma](https://mastra.ai/integrations/vectors/chroma)
+- [Cloudflare Vectorize](https://mastra.ai/integrations/vectors/vectorize)
+- [Convex](https://mastra.ai/integrations/vectors/convex)
+- [Couchbase](https://mastra.ai/integrations/vectors/couchbase)
+- [DuckDB](https://mastra.ai/integrations/vectors/duckdb)
+- [Elasticsearch](https://mastra.ai/integrations/vectors/elasticsearch)
+- [LanceDB](https://mastra.ai/integrations/vectors/lance)
+- [libSQL](https://mastra.ai/integrations/vectors/libsql)
+- [MongoDB](https://mastra.ai/integrations/vectors/mongodb)
+- [OpenSearch](https://mastra.ai/integrations/vectors/opensearch)
+- [OracleDB](https://mastra.ai/integrations/vectors/oracledb)
+- [Pinecone](https://mastra.ai/integrations/vectors/pinecone)
+- [PostgreSQL](https://mastra.ai/integrations/vectors/pg)
+- [Qdrant](https://mastra.ai/integrations/vectors/qdrant)
+- [S3 Vectors](https://mastra.ai/integrations/vectors/s3vectors)
+- [Turbopuffer](https://mastra.ai/integrations/vectors/turbopuffer)
+- [Upstash](https://mastra.ai/integrations/vectors/upstash)
 
 ## Recall configuration
 
@@ -250,7 +250,7 @@ const options = {
 
 Some vector stores generate the embeddings themselves. With one of those, semantic recall runs without an `embedder`: the database embeds each message on write and the search string on arrival. The embedding provider stays out of your application entirely.
 
-MongoDB does this through [Automated Embedding](https://mastra.ai/reference/vectors/mongodb): name a Voyage AI model on the vector store and leave the `embedder` out.
+MongoDB does this through [Automated Embedding](https://mastra.ai/integrations/vectors/mongodb): name a Voyage AI model on the vector store and leave the `embedder` out.
 
 ```typescript
 import { Memory } from '@mastra/memory'
@@ -456,8 +456,10 @@ const agent = new Agent({
         indexConfig: {
           type: 'hnsw', // Use HNSW for better performance
           metric: 'dotproduct', // Best for OpenAI embeddings
-          m: 16, // Number of bi-directional links (default: 16)
-          efConstruction: 64, // Size of candidate list during construction (default: 64)
+          hnsw: {
+            m: 16, // Number of bi-directional links (default: 16)
+            efConstruction: 64, // Size of candidate list during construction (default: 64)
+          },
         },
       },
     },
@@ -465,7 +467,7 @@ const agent = new Agent({
 })
 ```
 
-For detailed information about index configuration options and performance tuning, see the [PgVector configuration guide](https://mastra.ai/reference/vectors/pg).
+For detailed information about index configuration options and performance tuning, see the [PgVector configuration guide](https://mastra.ai/integrations/vectors/pg).
 
 ## Disable semantic recall
 

package/dist/docs/references/integrations-databases-mongodb.md

@@ -194,7 +194,7 @@ await storage.close()
 
 ## Vector search capabilities
 
-MongoDB storage includes built-in vector search capabilities for AI applications. For detailed vector operations including index creation, upserting embeddings, similarity search, and metadata filtering, see the [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb).
+MongoDB storage includes built-in vector search capabilities for AI applications. For detailed vector operations including index creation, upserting embeddings, similarity search, and metadata filtering, see the [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb).
 
 ## Usage example
 

package/dist/docs/references/{reference-vectors-mongodb.md → integrations-vectors-mongodb.md}

@@ -71,6 +71,8 @@ const store = new MongoDBVector({
 
 **embeddingFieldPath** (`string`): Path to the field that stores vector embeddings. Supports nested paths using dot notation (e.g., 'text.contentEmbedding'). (Default: `embedding`)
 
+**autoEmbed** (`MongoDBAutoEmbedConfig`): Automated Embedding defaults for indexes this store creates, such as { model: 'voyage-4' }. An index created without its own autoEmbed or dimension uses these settings, which makes the store embed text server-side instead of receiving vectors.
+
 ## Methods
 
 ### `connect()`
@@ -178,7 +180,7 @@ await store.createSearchIndex({
 })
 ```
 
-The field-mapped index name includes the logical `indexName`, so two logical indexes on the same collection get distinct text indexes. Recreating the _same_ logical index with different `fields` still requires dropping the existing index first (`IndexAlreadyExists`).
+The field-mapped index name includes the logical `indexName`, so two logical indexes on the same collection get distinct text indexes. Calling `createSearchIndex()` again for the _same_ logical index with different `fields` updates the existing text index definition in place. You don't need to drop it first.
 
 ### `waitForSearchIndexReady()`
 
@@ -279,18 +281,18 @@ Returns:
 interface IndexStats {
   dimension: number
   count: number
-  metric: 'cosine' | 'euclidean' | 'dotproduct'
+  metric?: 'cosine' | 'euclidean' | 'dotproduct'
 }
 ```
 
-On an `autoEmbed` index, `dimension` is read from the index definition and reports MongoDB's default of `1024` when the index doesn't pin one. `count` counts documents that carry the embedded text field, since the generated vectors aren't stored on your documents.
+On an `autoEmbed` index, `dimension` is read from the index definition and reports MongoDB's default of `1024` when the index doesn't pin one. `metric` is omitted when the `autoEmbed` index doesn't specify a similarity. `count` counts documents that carry the embedded text field, since the generated vectors aren't stored on your documents.
 
 ### `deleteIndex()`
 
 Deletes a vector index. Behavior depends on how the index was created:
 
 - **Managed index** (created without `collectionName`): drops the entire collection and all its data.
-- **Bring-your-own index** (created with `collectionName`): drops the MongoDB vectorSearch index. If `createSearchIndex()` provisioned a companion full-text search index, it drops that index too. The caller's operational collection and its documents are preserved. This store never drops a collection it didn't create.
+- **Bring-your-own index** (created with `collectionName`): drops the MongoDB vectorSearch index. If `createSearchIndex()` provisioned a companion full-text search index, it drops that index too. A vectorSearch or full-text index that another logical index on the same collection still references is kept for that index. The caller's operational collection and its documents are preserved. This store never drops a collection it didn't create.
 
 The BYO classification is recorded durably when the index is created, so it's applied correctly even by a different process (e.g. an index created by a setup job and later deleted by a long-lived service). Always pass the **logical index name** (the `indexName` used at `createIndex`), not the physical collection name.
 
@@ -350,7 +352,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
   document?: string // Source text stored with the vector, when available
 }

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

@@ -35,7 +35,7 @@ MongoDB Vector Search is a good solution for teams who want to consolidate vecto
 
 ### Using VoyageAI with MongoDB
 
-MongoDB works directly with VoyageAI's embedding models, which are optimized for retrieval tasks. For complete examples and specialized models, see the [VoyageAI embeddings documentation](https://mastra.ai/models/embeddings) and [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb).
+MongoDB works directly with VoyageAI's embedding models, which are optimized for retrieval tasks. For complete examples and specialized models, see the [VoyageAI embeddings documentation](https://mastra.ai/models/embeddings) and [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb).
 
 ### Hybrid Search (Vector + Full-Text)
 
@@ -52,7 +52,7 @@ const results = await store.hybridQuery({
 })
 ```
 
-See the [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb) for details on `createSearchIndex()`, `textQuery()`, and `hybridQuery()`.
+See the [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb) for details on `createSearchIndex()`, `textQuery()`, and `hybridQuery()`.
 
 ### Automated Embedding
 
@@ -75,7 +75,7 @@ const results = await store.query({
 })
 ```
 
-Automated Embedding is a MongoDB Preview feature and needs a deployment where it's available. See the [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb) for the supported options and requirements.
+Automated Embedding is a MongoDB Preview feature and needs a deployment where it's available. See the [MongoDB vector reference](https://mastra.ai/integrations/vectors/mongodb) for the supported options and requirements.
 
 **PgVector**:
 

package/dist/index.cjs

@@ -10,7 +10,7 @@ let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
 let _mastra_core_storage_domains_skills = require("@mastra/core/storage/domains/skills");
 // package.json
-var version = "1.24.1-alpha.1";
+var version = "1.25.0-alpha.0";
 // src/vector/filter.ts
 /**
 * Translator for MongoDB filter queries.
@@ -46,10 +46,9 @@ var MongoDBFilterTranslator = class extends _mastra_core_vector_filter.BaseFilte
 				if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("$not operator requires an object");
 				if (this.isEmpty(value)) throw new Error("$not operator cannot be empty");
 				return this.translateNode(value);
-			} else {
-				if (!Array.isArray(value)) throw new Error(`Value for logical operator ${operator} must be an array`);
-				return value.map((item) => this.translateNode(item));
 			}
+			if (!Array.isArray(value)) throw new Error(`Value for logical operator ${operator} must be an array`);
+			return value.map((item) => this.translateNode(item));
 		}
 		if (this.isBasicOperator(operator) || this.isNumericOperator(operator)) {
 			if (value instanceof Date) return value.toISOString();
@@ -2441,7 +2440,9 @@ function toDoc(task) {
 		suspendedAt: task.suspendedAt?.toISOString() ?? null,
 		completedAt: task.completedAt?.toISOString() ?? null,
 		ownerId: task.ownerId ?? null,
-		leaseExpiresAt: task.leaseExpiresAt?.toISOString() ?? null
+		leaseExpiresAt: task.leaseExpiresAt?.toISOString() ?? null,
+		expiresAt: task.expiresAt?.toISOString() ?? null,
+		metadata: task.metadata ?? null
 	};
 }
 function fromDoc(doc) {
@@ -2466,10 +2467,13 @@ function fromDoc(doc) {
 		suspendedAt: doc.suspendedAt ? new Date(doc.suspendedAt) : void 0,
 		completedAt: doc.completedAt ? new Date(doc.completedAt) : void 0,
 		ownerId: doc.ownerId ?? void 0,
-		leaseExpiresAt: doc.leaseExpiresAt ? new Date(doc.leaseExpiresAt) : void 0
+		leaseExpiresAt: doc.leaseExpiresAt ? new Date(doc.leaseExpiresAt) : void 0,
+		expiresAt: doc.expiresAt ? new Date(doc.expiresAt) : void 0,
+		metadata: doc.metadata ?? void 0
 	};
 }
 var BackgroundTasksStorageMongoDB = class BackgroundTasksStorageMongoDB extends _mastra_core_storage.BackgroundTasksStorage {
+	supportsTaskExpiry = true;
 	#connector;
 	#skipDefaultIndexes;
 	#indexes;
@@ -2585,11 +2589,14 @@ var BackgroundTasksStorageMongoDB = class BackgroundTasksStorageMongoDB extends
 		if ("completedAt" in update) $set.completedAt = update.completedAt?.toISOString() ?? null;
 		if ("ownerId" in update) $set.ownerId = update.ownerId ?? null;
 		if ("leaseExpiresAt" in update) $set.leaseExpiresAt = update.leaseExpiresAt?.toISOString() ?? null;
+		if ("expiresAt" in update) $set.expiresAt = update.expiresAt?.toISOString() ?? null;
+		if ("metadata" in update) $set.metadata = update.metadata ?? null;
 		if (Object.keys($set).length === 0) return false;
 		const filter = { id: taskId };
 		if (options?.expectedStatus) filter.status = options.expectedStatus;
 		if (options?.expectedOwnerId !== void 0) filter.ownerId = options.expectedOwnerId;
 		if (options?.expectedLeaseExpiresAt !== void 0) filter.leaseExpiresAt = options.expectedLeaseExpiresAt?.toISOString() ?? null;
+		if (options?.expectedSuspendedAt !== void 0) filter.suspendedAt = options.expectedSuspendedAt?.toISOString() ?? null;
 		return (await (await this.getCollection()).updateOne(filter, { $set })).matchedCount > 0;
 	}
 	async getTask(taskId) {
@@ -2608,7 +2615,8 @@ var BackgroundTasksStorageMongoDB = class BackgroundTasksStorageMongoDB extends
 		if (filter.runId) query.run_id = filter.runId;
 		if (filter.toolName) query.tool_name = filter.toolName;
 		if (filter.toolCallId) query.tool_call_id = filter.toolCallId;
-		const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+		const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : filter.dateFilterBy === "expiresAt" ? "expiresAt" : "createdAt";
+		if (filter.hasExpiresAt !== void 0) query.expiresAt = filter.hasExpiresAt ? { $ne: null } : { $eq: null };
 		if (filter.fromDate) query[dateCol] = {
 			...query[dateCol] || {},
 			$gte: filter.fromDate.toISOString()
@@ -2640,7 +2648,8 @@ var BackgroundTasksStorageMongoDB = class BackgroundTasksStorageMongoDB extends
 			const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
 			query.status = statuses.length === 1 ? statuses[0] : { $in: statuses };
 		}
-		const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : "createdAt";
+		const dateCol = filter.dateFilterBy === "startedAt" ? "startedAt" : filter.dateFilterBy === "suspendedAt" ? "suspendedAt" : filter.dateFilterBy === "completedAt" ? "completedAt" : filter.dateFilterBy === "expiresAt" ? "expiresAt" : "createdAt";
+		if (filter.hasExpiresAt !== void 0) query.expiresAt = filter.hasExpiresAt ? { $ne: null } : { $eq: null };
 		if (filter.fromDate) query[dateCol] = {
 			...query[dateCol] || {},
 			$gte: filter.fromDate.toISOString()