@mastra/mongodb 1.24.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"
+  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",
+  "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'
@@ -467,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()`

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";
+var version = "1.25.0-alpha.0";
 // src/vector/filter.ts
 /**
 * Translator for MongoDB filter queries.
@@ -2440,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) {
@@ -2465,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;
@@ -2584,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) {
@@ -2607,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()
@@ -2639,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()