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

package/dist/_types/@internal_core/dist/memory/index.d.ts

@@ -9,18 +9,18 @@
  * into the table schema they get from `@mastra/core`, so the columns exist even when the
  * installed core predates them.
  */
-declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
+export declare const OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS: {
   readonly supersededBy: {
     readonly type: 'text';
     readonly nullable: true;
   };
 };
 /** `schema` plus {@link OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS}; `undefined` when `schema` is. */
-declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
+export declare function withObservationalMemoryLifecycleColumns<T extends object>(schema: T | undefined): (T & typeof OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS) | undefined;
 /**
  * Result of `commitActiveObservations`.
  */
-interface UpdateActiveObservationsResult {
+export interface UpdateActiveObservationsResult {
   /** Whether the observations were written. */
   applied: boolean;
   /**
@@ -38,14 +38,14 @@ interface UpdateActiveObservationsResult {
  * the head's cursor. Chunks carry `lastObservedAt = max message time + 1ms`, so a chunk is
  * wholly covered iff `head.lastObservedAt >= chunk.lastObservedAt - 1ms`.
  */
-interface UpdateBufferedObservationsResult {
+export interface UpdateBufferedObservationsResult {
   /** Whether the chunk was stored. */
   persisted: boolean;
   /** The record the chunk was written to (or would have been written to). */
   recordId: string;
 }
 /** The fields of an observational memory record that decide head order. */
-interface ObservationalMemoryHeadOrderFields {
+export interface ObservationalMemoryHeadOrderFields {
   generationCount: number;
   createdAt: Date | string;
   id: string;
@@ -54,16 +54,16 @@ interface ObservationalMemoryHeadOrderFields {
  * Canonical head order: `generationCount DESC, createdAt ASC, id ASC`.
  * Returns a negative number when `a` sorts before `b` (i.e. `a` is the better head candidate).
  */
-declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
+export declare function compareObservationalMemoryHeadOrder(a: ObservationalMemoryHeadOrderFields, b: ObservationalMemoryHeadOrderFields): number;
 /**
  * A buffered chunk stores `lastObservedAt = max message time + 1ms`. It is wholly covered
  * (every message it observed is already at or before the cursor) iff
  * `cursor >= chunk.lastObservedAt - 1ms`.
  */
-declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
+export declare function isBufferedChunkCoveredByCursor(chunkLastObservedAt: Date | string, cursor: Date | string | null | undefined): boolean;
 /** The later of two cursors; `undefined` only when both are absent. */
-declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
-interface ReflectionTextPlan {
+export declare function maxObservationCursor(a: Date | string | null | undefined, b: Date | string | null | undefined): Date | undefined;
+export interface ReflectionTextPlan {
   /** `equal`: stored text equals the snapshot. `append`: observations were appended after the snapshot. */
   mode: 'equal' | 'append';
   observations: string;
@@ -78,7 +78,7 @@ interface ReflectionTextPlan {
  *   after the reflection, and its tokens are added.
  * - Anything else (a non-append rewrite): `null` — the reflection must not be applied.
  */
-declare function planReflectionGenerationText(input: {
+export declare function planReflectionGenerationText(input: {
   storedObservations: string;
   storedObservationTokenCount: number;
   snapshotObservations: string;
@@ -91,12 +91,11 @@ declare function planReflectionGenerationText(input: {
  * Callers of `updateActiveObservations` (which resolves `void`) can't see a commit result, so a
  * write that was not applied throws instead of resolving as if it had committed.
  */
-declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
+export declare function assertActiveObservationsApplied(result: UpdateActiveObservationsResult, id: string): void;
 /**
  * Whether the stored text can still accept a reflection built from `snapshot`
  * (equal, or only appended to since).
  */
-declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
+export declare function isAppendOnlySince(storedObservations: string, snapshotObservations: string): boolean;
 //#endregion
-export { OBSERVATIONAL_MEMORY_LIFECYCLE_COLUMNS, ObservationalMemoryHeadOrderFields, ReflectionTextPlan, UpdateActiveObservationsResult, UpdateBufferedObservationsResult, assertActiveObservationsApplied, compareObservationalMemoryHeadOrder, isAppendOnlySince, isBufferedChunkCoveredByCursor, maxObservationCursor, planReflectionGenerationText, withObservationalMemoryLifecycleColumns };
 //# sourceMappingURL=index.d.ts.map

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.0-alpha.1"
+  version: "1.24.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

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

@@ -34,7 +34,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'agent-storage',
@@ -64,7 +64,7 @@ const agent = new Agent({
   id: 'support-agent',
   name: 'SupportAgent',
   instructions: 'You are a helpful support agent.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'agent-storage',
@@ -403,6 +403,28 @@ Memory uses a single embedder for both storing and recalling messages, so pick o
 
 Multilingual E5 produces 1024-dimensional vectors. Your vector index must be created with matching dimensions, and E5 vectors can't be mixed with vectors from another embedder in the same index.
 
+FastEmbed models embed at most 512 tokens per input (roughly 2,000 to 2,500 characters of English text). Longer inputs are truncated, so text past the limit doesn't affect the embedding and can't be found by semantic recall. The AI SDK v3 FastEmbed models return a warning when this happens. The legacy v1 and v2 models don't. If you embed long documents with FastEmbed, chunk them to fit the window, for example with `maxSize: 1500` in `MDocument.chunk()`.
+
+### Setting the embedding dimension
+
+To name the vector index, Memory needs the embedder's output dimension. By default it finds the dimension by embedding a short probe string the first time semantic recall is set up, once per `Memory` instance. If you already know the dimension, set `embeddingDimension`. Memory then skips the probe, so startup makes no embedding call and doesn't depend on the embedding provider being reachable:
+
+```ts
+import { Memory } from '@mastra/memory'
+
+const memory = new Memory({
+  embedder: 'openai/text-embedding-3-small',
+  embeddingDimension: 1536,
+  options: {
+    semanticRecall: true,
+  },
+})
+```
+
+The index name is the same whether the dimension is configured or probed, so existing indexes keep working.
+
+The value must match the vectors the embedder returns. Memory compares it with the first real embedding, and on a mismatch it throws a `MASTRA_MEMORY_EMBEDDING_DIMENSION_MISMATCH` error naming both values before creating or querying any index. Update `embeddingDimension` whenever you change the embedding model or its output dimension.
+
 ## PostgreSQL index optimization
 
 When using PostgreSQL as your vector store, you can optimize semantic recall performance by configuring the vector index. This is particularly important for large-scale deployments with thousands of messages.

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

@@ -34,7 +34,7 @@ const agent = new Agent({
   id: 'personal-assistant',
   name: 'PersonalAssistant',
   instructions: 'You are a helpful personal assistant.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -217,7 +217,7 @@ const paragraphMemory = new Memory({
 
 Working memory can also be defined using a structured schema instead of a Markdown template. A [Standard JSON Schema](https://standardschema.dev/json-schema) ([Zod](https://zod.dev/), [Valibot](https://valibot.dev/), [ArkType](https://arktype.io/), etc.). When using a schema, the agent will see and update working memory as a JSON object matching your schema.
 
-**Requirement:** You must specify either `template` or `schema`, but not both.
+You can specify either `template` or `schema`, but not both. If you omit both, Mastra uses the default working memory template.
 
 ### Example: Schema-Based Working Memory
 
@@ -418,7 +418,7 @@ const response = await agent.generate('What do you know about me?', {
 
 ## Opt in to state signals (experimental)
 
-By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/harness/signals) instead by setting `useStateSignals: true`:
+By default, working memory reaches the model as part of the system message. You can opt into delivering it as a [state signal](https://mastra.ai/docs/signals/state-signals) instead by setting `useStateSignals: true`:
 
 ```typescript
 const memory = new Memory({

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

@@ -146,7 +146,7 @@ export const supportAgent = new Agent({
   id: 'support-agent',
   name: 'Support agent',
   instructions: 'Answer customer support questions.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'support-agent-storage',

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

@@ -212,7 +212,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

package/dist/docs/references/reference-rag-retrieval.md

@@ -386,7 +386,7 @@ import { MONGODB_PROMPT } from '@mastra/mongodb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${MONGODB_PROMPT}
@@ -403,7 +403,7 @@ import { PGVECTOR_PROMPT } from '@mastra/pg'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PGVECTOR_PROMPT}
@@ -420,7 +420,7 @@ import { PINECONE_PROMPT } from '@mastra/pinecone'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${PINECONE_PROMPT}
@@ -437,7 +437,7 @@ import { QDRANT_PROMPT } from '@mastra/qdrant'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${QDRANT_PROMPT}
@@ -454,7 +454,7 @@ import { CHROMA_PROMPT } from '@mastra/chroma'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${CHROMA_PROMPT}
@@ -471,7 +471,7 @@ import { ASTRA_PROMPT } from '@mastra/astra'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ASTRA_PROMPT}
@@ -488,7 +488,7 @@ import { LIBSQL_PROMPT } from '@mastra/libsql'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${LIBSQL_PROMPT}
@@ -505,7 +505,7 @@ import { UPSTASH_PROMPT } from '@mastra/upstash'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${UPSTASH_PROMPT}
@@ -522,7 +522,7 @@ import { VECTORIZE_PROMPT } from '@mastra/vectorize'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${VECTORIZE_PROMPT}
@@ -539,7 +539,7 @@ import { OPENSEARCH_PROMPT } from '@mastra/opensearch'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${OPENSEARCH_PROMPT}
@@ -556,7 +556,7 @@ import { ORACLEDB_PROMPT } from '@mastra/oracledb'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${ORACLEDB_PROMPT}
@@ -573,7 +573,7 @@ import { S3VECTORS_PROMPT } from '@mastra/s3vectors'
 export const ragAgent = new Agent({
   id: 'rag-agent',
   name: 'RAG Agent',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   instructions: `
   Process queries using the provided context. Structure responses to be concise and relevant.
   ${S3VECTORS_PROMPT}
@@ -605,7 +605,7 @@ const initialResults = await pgVector.query({
 // Create a relevance scorer
 const relevanceProvider = new MastraAgentRelevanceScorer(
   'relevance-scorer',
-  'openai/gpt-5.6-sol',
+  'openai/gpt-6.1-sol',
 )
 
 // Re-rank the results

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

@@ -558,7 +558,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',
@@ -623,7 +623,7 @@ export const mongodbVoyageAgent = new Agent({
   id: 'mongodb-voyage-agent',
   name: 'MongoDB VoyageAI Agent',
   instructions: 'You are an AI agent with semantic recall powered by VoyageAI and MongoDB.',
-  model: 'openai/gpt-5.6-sol',
+  model: 'openai/gpt-6.1-sol',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

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.24.0-alpha.1";
+var version = "1.24.1-alpha.0";
 //#endregion
 //#region src/vector/filter.ts
 /**
@@ -42,13 +42,15 @@ var MongoDBFilterTranslator = class extends _mastra_core_vector_filter.BaseFilte
 		return Object.fromEntries(translatedEntries);
 	}
 	translateOperatorValue(operator, value) {
-		if (this.isLogicalOperator(operator)) if (operator === "$not") {
-			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 (this.isLogicalOperator(operator)) {
+			if (operator === "$not") {
+				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 (this.isBasicOperator(operator) || this.isNumericOperator(operator)) {
 			if (value instanceof Date) return value.toISOString();
@@ -1532,17 +1534,19 @@ var MongoDBVector = class MongoDBVector extends _mastra_core_vector.MastraVector
 		if (Array.isArray(filter)) return filter.map((item) => this.transformMetadataFilter(item, metadataMode));
 		if (metadataMode === "document") {
 			const transformed = {};
-			for (const [key, value] of Object.entries(filter)) if (key.startsWith("$")) if (Array.isArray(value)) transformed[key] = value.map((item) => this.transformMetadataFilter(item, metadataMode));
-			else if (typeof value === "object" && value !== null) transformed[key] = this.transformMetadataFilter(value, metadataMode);
-			else transformed[key] = value;
-			else transformed[key] = value;
+			for (const [key, value] of Object.entries(filter)) if (key.startsWith("$")) {
+				if (Array.isArray(value)) transformed[key] = value.map((item) => this.transformMetadataFilter(item, metadataMode));
+				else if (typeof value === "object" && value !== null) transformed[key] = this.transformMetadataFilter(value, metadataMode);
+				else transformed[key] = value;
+			} else transformed[key] = value;
 			return transformed;
 		}
 		const transformed = {};
-		for (const [key, value] of Object.entries(filter)) if (key.startsWith("$")) if (Array.isArray(value)) transformed[key] = value.map((item) => this.transformMetadataFilter(item, metadataMode));
-		else if (typeof value === "object" && value !== null) transformed[key] = this.transformMetadataFilter(value, metadataMode);
-		else transformed[key] = value;
-		else if (key.startsWith("metadata.")) transformed[key] = value;
+		for (const [key, value] of Object.entries(filter)) if (key.startsWith("$")) {
+			if (Array.isArray(value)) transformed[key] = value.map((item) => this.transformMetadataFilter(item, metadataMode));
+			else if (typeof value === "object" && value !== null) transformed[key] = this.transformMetadataFilter(value, metadataMode);
+			else transformed[key] = value;
+		} else if (key.startsWith("metadata.")) transformed[key] = value;
 		else if (this.isMetadataField(key)) transformed[`metadata.${key}`] = value;
 		else transformed[key] = value;
 		return transformed;
@@ -9577,15 +9581,13 @@ MIGRATION REQUIRED: Duplicate spans detected in ${_mastra_core_storage.TABLE_SPA
 							error: null
 						});
 						break;
-					case _mastra_core_storage.TraceStatus.SUCCESS:
-						andConditions.push({
-							endedAt: {
-								$exists: true,
-								$ne: null
-							},
-							error: null
-						});
-						break;
+					case _mastra_core_storage.TraceStatus.SUCCESS: andConditions.push({
+						endedAt: {
+							$exists: true,
+							$ne: null
+						},
+						error: null
+					});
 				}
 			}
 			if (andConditions.length) mongoFilter.$and = andConditions;
@@ -12367,8 +12369,10 @@ var WorkflowsStorageMongoDB = class WorkflowsStorageMongoDB extends _mastra_core
 			if (options.workflowName) query["workflow_name"] = options.workflowName;
 			if (options.status) query["snapshot.status"] = options.status;
 			if (options.fromDate) query["createdAt"] = { $gte: options.fromDate };
-			if (options.toDate) if (query["createdAt"]) query["createdAt"].$lte = options.toDate;
-			else query["createdAt"] = { $lte: options.toDate };
+			if (options.toDate) {
+				if (query["createdAt"]) query["createdAt"].$lte = options.toDate;
+				else query["createdAt"] = { $lte: options.toDate };
+			}
 			if (options.resourceId) query["resourceId"] = options.resourceId;
 			const collection = await this.getCollection(_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT);
 			let total = 0;