@mastra/rag 2.7.3-alpha.0 → 2.7.3-alpha.1

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-rag
 description: Documentation for @mastra/rag. Use when working with @mastra/rag APIs, configuration, or implementation.
 metadata:
   package: "@mastra/rag"
-  version: "2.7.3-alpha.0"
+  version: "2.7.3-alpha.1"
 ---
 
 ## When to use
@@ -20,7 +20,6 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Reference
 
-- [RAG](references/reference-migrations-upgrade-to-v1-rag.md) - Migrate RAG code to Mastra v1 with renamed chunking parameters and narrowed option types, including updates to related document-processing APIs.
 - [Reference: .chunk()](references/reference-rag-chunk.md) - The .chunk() function splits documents into smaller segments using strategies and options.
 - [Chunking and embedding documents](references/reference-rag-chunking-and-embedding.md) - Chunk documents with MDocument, generate embeddings through the AI SDK, and prepare text and metadata for vector storage and RAG retrieval.
 - [Reference: DatabaseConfig](references/reference-rag-database-config.md) - The DatabaseConfig type allows you to specify database-specific configurations when using vector query tools.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.7.3-alpha.0",
+  "version": "2.7.3-alpha.1",
   "package": "@mastra/rag",
   "exports": {
     "CohereRelevanceScorer": {
@@ -10,7 +10,7 @@
     "GraphRAG": {
       "types": "dist/graph-rag/index.d.ts",
       "implementation": "dist/index.js",
-      "line": 6277
+      "line": 6285
     },
     "Language": {
       "types": "dist/document/types.d.ts",
@@ -35,57 +35,57 @@
     "createBedrockKBTool": {
       "types": "dist/tools/bedrock-knowledge-base.d.ts",
       "implementation": "dist/index.js",
-      "line": 7114
+      "line": 7115
     },
     "createDocumentChunkerTool": {
       "types": "dist/tools/document-chunker.d.ts",
       "implementation": "dist/index.js",
-      "line": 6498
+      "line": 6506
     },
     "createGraphRAGTool": {
       "types": "dist/tools/graph-rag.d.ts",
       "implementation": "dist/index.js",
-      "line": 6820
+      "line": 6821
     },
     "createVectorQueryTool": {
       "types": "dist/tools/vector-query.d.ts",
       "implementation": "dist/index.js",
-      "line": 6974
+      "line": 6975
     },
     "defaultGraphRagDescription": {
       "types": "dist/utils/default-settings.d.ts",
       "implementation": "dist/index.js",
-      "line": 6645
+      "line": 6653
     },
     "defaultVectorQueryDescription": {
       "types": "dist/utils/default-settings.d.ts",
       "implementation": "dist/index.js",
-      "line": 6644
+      "line": 6652
     },
     "filterDescription": {
       "types": "dist/utils/default-settings.d.ts",
       "implementation": "dist/index.js",
-      "line": 6664
+      "line": 6672
     },
     "queryTextDescription": {
       "types": "dist/utils/default-settings.d.ts",
       "implementation": "dist/index.js",
-      "line": 6646
+      "line": 6654
     },
     "rerank": {
       "types": "dist/rerank/index.d.ts",
       "implementation": "dist/index.js",
-      "line": 6264
+      "line": 6272
     },
     "rerankWithScorer": {
       "types": "dist/rerank/index.d.ts",
       "implementation": "dist/index.js",
-      "line": 6256
+      "line": 6264
     },
     "topKDescription": {
       "types": "dist/utils/default-settings.d.ts",
       "implementation": "dist/index.js",
-      "line": 6654
+      "line": 6662
     }
   },
   "modules": {}

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

@@ -103,7 +103,7 @@ serialize(): GraphRAGSnapshot
 
 Returns a `GraphRAGSnapshot` object containing:
 
-**version** (`number`): Snapshot format version, used to reject snapshots this version of the class can't load
+**version** (`1`): Snapshot format version. Always 1 in the current format, so deserialize rejects snapshots with any other version
 
 **dimension** (`number`): Dimension of the embedding vectors the graph was built with
 

package/dist/index.cjs

@@ -6219,6 +6219,14 @@ async function executeRerank({ results, query, scorer, options }) {
 		});
 		throw err;
 	}
+	if (!Number.isInteger(topK) || topK < 0) {
+		const err = /* @__PURE__ */ new Error(`topK must be a nonnegative integer. Got ${topK}`);
+		rerankSpan?.error({
+			error: err,
+			endSpan: true
+		});
+		throw err;
+	}
 	const resultLength = results.length;
 	const queryAnalysis = queryEmbedding ? analyzeQueryEmbedding(queryEmbedding) : null;
 	let scoredResults;
@@ -6752,15 +6760,8 @@ async function resolveVectorStore(options, context, logger) {
 	if (mastra) return mastra.getVector(vectorStoreName);
 }
 function coerceTopK(topK, defaultValue = 10) {
-	if (typeof topK === "number") {
-		if (Number.isFinite(topK) && topK > 0) return topK;
-		return defaultValue;
-	}
-	if (typeof topK === "string") {
-		const parsed = Number(topK);
-		if (Number.isFinite(parsed) && parsed > 0) return parsed;
-		return defaultValue;
-	}
+	const parsed = typeof topK === "string" ? Number(topK) : topK;
+	if (typeof parsed === "number" && Number.isFinite(parsed) && Math.floor(parsed) >= 1) return Math.floor(parsed);
 	return defaultValue;
 }
 function parseFilterValue(filter, logger) {