@mastra/mongodb 1.18.4 → 1.18.5-alpha.1

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.18.4"
+  version: "1.18.5-alpha.1"
 ---
 
 ## When to use
@@ -16,20 +16,20 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Docs
 
-- [Semantic recall](references/docs-memory-semantic-recall.md) - Learn how to use semantic recall in Mastra to retrieve relevant messages from past conversations using vector search and embeddings.
-- [Working memory](references/docs-memory-working-memory.md) - Learn how to configure working memory in Mastra to store persistent user data, preferences.
-- [Storage](references/docs-storage.md) - Configure storage for Mastra to persist runtime state across agents, workflows, observability, evals, schedules, and memory.
+- [Semantic recall](references/docs-memory-semantic-recall.md) - Retrieve relevant messages from past Mastra conversations with semantic recall, vector search, embeddings, metadata filters, and configurable storage.
+- [Working memory](references/docs-memory-working-memory.md) - Persist user profiles, preferences, and application data with Mastra working memory using resource- or thread-scoped templates and storage adapters.
+- [Storage](references/docs-storage.md) - Configure Mastra storage to persist memory, workflow state, observability data, evals, schedules, and long-running agent state across restarts.
 
 ### Integrations
 
-- [MongoDB](references/integrations-databases-mongodb.md) - Documentation for the MongoDB storage implementation in Mastra.
+- [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.
 
 ### Reference
 
-- [Retrieval, semantic search, reranking](references/reference-rag-retrieval.md) - Guide on retrieval processes in Mastra's RAG systems, including semantic search, filtering, and re-ranking.
-- [Storing embeddings in a vector database](references/reference-rag-vector-databases.md) - Guide on vector storage options in Mastra, including embedded and dedicated vector databases for similarity search.
-- [Reference: Composite storage](references/reference-storage-composite.md) - Documentation for combining multiple storage backends in Mastra.
-- [Reference: MongoDB vector store](references/reference-vectors-mongodb.md) - Documentation for the MongoDBVector class in Mastra, which provides vector search using MongoDB Atlas and Vector Search.
+- [Retrieval, semantic search, reranking](references/reference-rag-retrieval.md) - After storing embeddings, you need to retrieve relevant chunks to answer user queries.
+- [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: 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.18.4",
+  "version": "1.18.5-alpha.1",
   "package": "@mastra/mongodb",
   "exports": {},
   "modules": {}

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

@@ -14,8 +14,6 @@ Semantic recall is RAG-based search that helps agents maintain context across lo
 
 It uses vector embeddings of messages for similarity search and integrates with vector stores, plus has configurable context windows around retrieved messages.
 
-![Diagram showing Mastra Memory semantic recall](/assets/images/semantic-recall-fd7b9336a6d0d18019216cb6d3dbe710.png)
-
 When it's enabled, new messages are used to query a vector DB for semantically similar messages.
 
 After getting a response from the LLM, all new messages (user, assistant, and tool calls/results) are inserted into the vector DB to be recalled in later interactions.

package/dist/docs/references/docs-memory-working-memory.md

@@ -275,7 +275,7 @@ Schema-based working memory uses **merge semantics**, meaning the agent only nee
 ## Choosing between template and schema
 
 - Use a **template** (Markdown) if you want the agent to maintain memory as a free-form text block, such as a user profile or scratchpad. Templates use **replace semantics**: the agent must provide the complete memory content on each update.
-- Use a **schema** if you need structured, type-safe data that can be validated and programmatically accessed as JSON. The `workingMemory.schema` field accepts any `PublicSchema`-compatible schema (including Zod v3, Zod v4, JSON Schema, or already-standard schemas). Schemas use **merge semantics**: the agent only provides fields to update, and existing fields are preserved.
+- Use a **schema** for structured, type-safe JSON data that supports validation and programmatic access. The `workingMemory.schema` field accepts any `PublicSchema`-compatible schema, such as Zod v3 or v4. JSON Schema and already-standard schemas are also supported. **Merge semantics** preserve existing fields when the agent provides only the fields to update.
 - Only one mode can be active at a time: setting both `template` and `schema` isn't supported.
 
 ## Example: Multi-step retention

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

@@ -35,11 +35,11 @@ MongoDB Vector Search is a good solution for teams who want to consolidate vecto
 
 ### Using VoyageAI with MongoDB
 
-MongoDB works seamlessly 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/reference/vectors/mongodb).
 
 ### Hybrid Search (Vector + Full-Text)
 
-MongoDB supports hybrid search that fuses vector similarity with BM25 full-text search using server-side `$rankFusion` (requires MongoDB >= 8.0; generally available from 8.1, and enabled on MongoDB Atlas 8.0.x). This is useful when you want to combine semantic and keyword-based retrieval:
+MongoDB supports hybrid search that combines vector similarity with BM25 full-text search through server-side `$rankFusion`. It requires MongoDB 8.0 or later, is generally available from 8.1, and is enabled on MongoDB Atlas 8.0.x. Use it to combine semantic retrieval with keyword-based results:
 
 ```ts
 await store.createSearchIndex({ indexName: 'myCollection', fields: ['text'] })
@@ -107,7 +107,7 @@ await store.upsert({
 
 ### Using Oracle Database Vector Search
 
-OracleDB stores embeddings in native `VECTOR` columns and metadata in Oracle JSON. Exact search is the default; HNSW and IVF indexes can be configured for tuned deployments.
+OracleDB stores embeddings in native `VECTOR` columns and metadata in Oracle JSON. Exact search is the default. HNSW and IVF indexes can be configured for tuned deployments.
 
 **Pinecone**:
 
@@ -239,8 +239,8 @@ const store = new UpstashVector({
   token: process.env.UPSTASH_TOKEN,
 })
 
-// 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.
+// Upstash creates indexes (known as namespaces) automatically, so no store.createIndex call is needed here
+// when you upsert if that namespace doesn't exist yet.
 await store.upsert({
   indexName: 'myCollection', // the namespace name in Upstash
   vectors: embeddings,
@@ -426,20 +426,20 @@ Collection and index names must:
 
 - Start with a letter or underscore
 - Be up to 120 bytes long
-- Contain only letters, numbers, underscores, or dots
-- Cannot contain `$` or the null character
+- Contain only letters, numbers, underscore characters, or dots
+- Can't contain `$` or the null character
 - Example: `my_collection.123` is valid
-- Example: `my-index` is not valid (contains hyphen)
-- Example: `My$Collection` is not valid (contains `$`)
+- Example: `my-index` isn't valid (contains hyphen)
+- Example: `My$Collection` isn't valid (contains `$`)
 
 **PgVector**:
 
 Index names must:
 
 - Start with a letter or underscore
-- Contain only letters, numbers, and underscores
+- Contain only letters, numbers, and underscore characters
 - Example: `my_index_123` is valid
-- Example: `my-index` is not valid (contains hyphen)
+- Example: `my-index` isn't valid (contains hyphen)
 
 **OracleDB**:
 
@@ -466,7 +466,7 @@ Index names must:
 - Have a combined length (with project ID) under 52 characters
 
   - Example: `my-index-123` is valid
-  - Example: `my.index` is not valid (contains dot)
+  - Example: `my.index` isn't valid (contains dot)
 
 **Qdrant**:
 
@@ -482,7 +482,7 @@ Collection names must:
 
 - Example: `my_collection_123` is valid
 
-- Example: `my/collection` is not valid (contains slash)
+- Example: `my/collection` isn't valid (contains slash)
 
 **Chroma**:
 
@@ -490,11 +490,11 @@ Collection names must:
 
 - Be 3-63 characters long
 - Start and end with a letter or number
-- Contain only letters, numbers, underscores, or hyphens
+- Contain only letters, numbers, underscore characters, or hyphens
 - Not contain consecutive periods (..)
 - Not be a valid IPv4 address
 - Example: `my-collection-123` is valid
-- Example: `my..collection` is not valid (consecutive periods)
+- Example: `my..collection` isn't valid (consecutive periods)
 
 **Astra**:
 
@@ -502,18 +502,18 @@ Collection names must:
 
 - Not be empty
 - Be 48 characters or less
-- Contain only letters, numbers, and underscores
+- Contain only letters, numbers, and `_` characters
 - Example: `my_collection_123` is valid
-- Example: `my-collection` is not valid (contains hyphen)
+- Example: `my-collection` isn't valid (contains hyphen)
 
 **libSQL**:
 
 Index names must:
 
 - Start with a letter or underscore
-- Contain only letters, numbers, and underscores
+- Contain only letters, numbers, and `_` characters
 - Example: `my_index_123` is valid
-- Example: `my-index` is not valid (contains hyphen)
+- Example: `my-index` isn't valid (contains hyphen)
 
 **Upstash**:
 
@@ -532,7 +532,7 @@ Namespace names must:
 
 - Example: `MyNamespace123` is valid
 
-- Example: `_namespace` is not valid (starts with underscore)
+- Example: `_namespace` isn't valid (starts with underscore)
 
 **Cloudflare**:
 
@@ -543,19 +543,19 @@ Index names must:
 - Contain only lowercase ASCII letters, numbers, and dashes
 - Use dashes instead of spaces
 - Example: `my-index-123` is valid
-- Example: `My_Index` is not valid (uppercase and underscore)
+- Example: `My_Index` isn't valid (uppercase and underscore)
 
 **OpenSearch**:
 
 Index names must:
 
 - Use only lowercase letters
-- Not begin with underscores or hyphens
+- Not begin with underscore characters or hyphens
 - Not contain spaces, commas
 - Not contain special characters (e.g. `:`, `"`, `*`, `+`, `/`, `\`, `|`, `?`, `#`, `>`, `<`)
 - Example: `my-index-123` is valid
-- Example: `My_Index` is not valid (contains uppercase letters)
-- Example: `_myindex` is not valid (begins with underscore)
+- Example: `My_Index` isn't valid (contains uppercase letters)
+- Example: `_myindex` isn't valid (begins with underscore)
 
 **Elasticsearch**:
 
@@ -563,29 +563,29 @@ Index names must:
 
 - Use only lowercase letters
 - Not exceed 255 bytes (counting multi-byte characters)
-- Not begin with underscores, hyphens, or plus signs
+- Not begin with underscore characters, hyphens, or plus signs
 - Not contain spaces, commas
 - Not contain special characters (e.g. `:`, `"`, `*`, `+`, `/`, `\`, `|`, `?`, `#`, `>`, `<`)
 - Not be "." or ".."
 - Not start with "." (deprecated except for system/hidden indices)
 - Example: `my-index-123` is valid
-- Example: `My_Index` is not valid (contains uppercase letters)
-- Example: `_myindex` is not valid (begins with underscore)
-- Example: `.myindex` is not valid (begins with dot, deprecated)
+- Example: `My_Index` isn't valid (contains uppercase letters)
+- Example: `_myindex` isn't valid (begins with underscore)
+- Example: `.myindex` isn't valid (begins with dot, deprecated)
 
 **S3 Vectors**:
 
 Index names must:
 
 - Be unique within the same vector bucket
-- Be 3–63 characters long
+- Be between 3 and 63 characters long
 - Use only lowercase letters (`a–z`), numbers (`0–9`), hyphens (`-`), and dots (`.`)
 - Begin and end with a letter or number
 - Example: `my-index.123` is valid
-- Example: `my_index` is not valid (contains underscore)
-- Example: `-myindex` is not valid (begins with hyphen)
-- Example: `myindex-` is not valid (ends with hyphen)
-- Example: `MyIndex` is not valid (contains uppercase letters)
+- Example: `my_index` isn't valid (contains underscore)
+- Example: `-myindex` isn't valid (begins with hyphen)
+- Example: `myindex-` isn't valid (ends with hyphen)
+- Example: `MyIndex` isn't valid (contains uppercase letters)
 
 ### Upserting Embeddings
 

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

@@ -255,7 +255,7 @@ const thread = await memoryStore?.getThreadById({ threadId: '...' })
 
 ## Closing connections
 
-`close()` releases the connections of the stores a composite was built from: the `default` and `editor` stores, plus any domain that owns its own client. Each store is closed once, even when it backs several domains. When passed to the Mastra class, `close()` is called by `shutdown()`:
+`close()` releases connections for the stores used by a composite, including the `default` and `editor` stores and any domain with its own client. Each store closes once even if it backs several domains. When the composite is passed to the Mastra class, `shutdown()` calls `close()`:
 
 ```typescript
 import { MastraCompositeStore } from '@mastra/core/storage'

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

@@ -222,7 +222,7 @@ const results = await store.textQuery({
 
 ### `hybridQuery()`
 
-Runs a hybrid search that fuses vector similarity and full-text results using MongoDB's server-side `$rankFusion`. It requires MongoDB >= 8.0 and is generally available from 8.1. On 8.0.x, it may require a MongoDB support case for enablement. It runs where enabled, including MongoDB Atlas 8.0.x. A full-text search index must exist: it's auto-created for managed indexes, but for a bring-your-own collection you must call `createSearchIndex()` first (opt-in).
+Runs a hybrid search that fuses vector similarity with full-text results through MongoDB's server-side `$rankFusion`. The feature requires MongoDB 8.0 or later and is generally available from 8.1. MongoDB Atlas 8.0.x supports it where enabled, although enablement may require a support case. A full-text search index must exist. Managed indexes create one automatically, while bring-your-own collections require an explicit `createSearchIndex()` call.
 
 **indexName** (`string`): Name of the Mastra index to search
 
@@ -255,7 +255,7 @@ const results = await store.hybridQuery({
 })
 ```
 
-`hybridQuery()` requires MongoDB >= 8.0 for the `$rankFusion` stage. The stage is generally available from 8.1. On 8.0.x, it may need a MongoDB support case to enable and runs where enabled, such as MongoDB Atlas 8.0.x. If you're running an older version, or `$rankFusion` isn't enabled on your 8.0.x deployment, use `query()` and `textQuery()` separately and merge the results client-side.
+`hybridQuery()` requires MongoDB 8.0 or later for the `$rankFusion` stage, which is generally available from 8.1. On 8.0.x, the stage runs where enabled, including MongoDB Atlas, but enablement may require a support case. If your deployment is older or lacks `$rankFusion`, run `query()` and `textQuery()` separately before merging the results client-side.
 
 ### `describeIndex()`
 

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");
 //#region package.json
-var version = "1.18.4";
+var version = "1.18.5-alpha.1";
 //#endregion
 //#region src/vector/filter.ts
 /**
@@ -10897,6 +10897,7 @@ function docToDefinition(doc) {
 	if (doc.metadata != null) def.metadata = doc.metadata;
 	if (doc.stateSchema != null) def.stateSchema = doc.stateSchema;
 	if (doc.requestContextSchema != null) def.requestContextSchema = doc.requestContextSchema;
+	if (doc.schedule != null) def.schedule = doc.schedule;
 	if (doc.authorId != null) def.authorId = doc.authorId;
 	return def;
 }
@@ -10963,6 +10964,7 @@ var MongoDBWorkflowDefinitionsStore = class MongoDBWorkflowDefinitionsStore exte
 				stateSchema: input.stateSchema ?? null,
 				requestContextSchema: input.requestContextSchema ?? null,
 				graph: input.graph,
+				schedule: "schedule" in input ? input.schedule ?? null : null,
 				status: "active",
 				source: "storage",
 				authorId: "authorId" in input ? input.authorId ?? null : null,
@@ -10989,6 +10991,7 @@ var MongoDBWorkflowDefinitionsStore = class MongoDBWorkflowDefinitionsStore exte
 		if ("stateSchema" in input && input.stateSchema !== void 0) update.stateSchema = input.stateSchema;
 		if ("requestContextSchema" in input && input.requestContextSchema !== void 0) update.requestContextSchema = input.requestContextSchema;
 		if ("graph" in input && input.graph !== void 0) update.graph = input.graph;
+		if ("schedule" in input && input.schedule !== void 0) update.schedule = input.schedule;
 		if ("status" in input && input.status !== void 0) update.status = input.status;
 		if ("authorId" in input && input.authorId !== void 0) update.authorId = input.authorId;
 		await collection.updateOne({ id: input.id }, { $set: update });