@mastra/rag 2.7.2 → 2.7.3-alpha.0

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,6 +1,92 @@
 {
-  "version": "2.7.2",
+  "version": "2.7.3-alpha.0",
   "package": "@mastra/rag",
-  "exports": {},
+  "exports": {
+    "CohereRelevanceScorer": {
+      "types": "dist/rerank/relevance/cohere/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6088
+    },
+    "GraphRAG": {
+      "types": "dist/graph-rag/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6277
+    },
+    "Language": {
+      "types": "dist/document/types.d.ts",
+      "implementation": "dist/index.js",
+      "line": 3842
+    },
+    "MDocument": {
+      "types": "dist/document/document.d.ts",
+      "implementation": "dist/index.js",
+      "line": 5821
+    },
+    "MastraAgentRelevanceScorer": {
+      "types": "dist/rerank/relevance/mastra-agent/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6123
+    },
+    "ZeroEntropyRelevanceScorer": {
+      "types": "dist/rerank/relevance/zeroentropy/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6152
+    },
+    "createBedrockKBTool": {
+      "types": "dist/tools/bedrock-knowledge-base.d.ts",
+      "implementation": "dist/index.js",
+      "line": 7114
+    },
+    "createDocumentChunkerTool": {
+      "types": "dist/tools/document-chunker.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6498
+    },
+    "createGraphRAGTool": {
+      "types": "dist/tools/graph-rag.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6820
+    },
+    "createVectorQueryTool": {
+      "types": "dist/tools/vector-query.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6974
+    },
+    "defaultGraphRagDescription": {
+      "types": "dist/utils/default-settings.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6645
+    },
+    "defaultVectorQueryDescription": {
+      "types": "dist/utils/default-settings.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6644
+    },
+    "filterDescription": {
+      "types": "dist/utils/default-settings.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6664
+    },
+    "queryTextDescription": {
+      "types": "dist/utils/default-settings.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6646
+    },
+    "rerank": {
+      "types": "dist/rerank/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6264
+    },
+    "rerankWithScorer": {
+      "types": "dist/rerank/index.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6256
+    },
+    "topKDescription": {
+      "types": "dist/utils/default-settings.d.ts",
+      "implementation": "dist/index.js",
+      "line": 6654
+    }
+  },
   "modules": {}
 }

package/dist/docs/references/reference-tools-vector-query-tool.md

@@ -88,14 +88,14 @@ The tool returns an object with:
 ```typescript
 {
   id: string;         // Unique chunk/document identifier
-  metadata: any;      // All metadata fields (document ID, etc.)
-  vector: number[];   // Embedding vector (if available)
+  metadata?: any;     // All metadata fields (document ID, etc.)
+  vector: number[];   // Embedding vector, or [] when unavailable
   score: number;      // Similarity score for this retrieval
   document: string;   // Full chunk/document text (if available)
 }
 ```
 
-`document` is only populated by vector stores whose `query()` returns document content, such as Chroma, Elasticsearch, LanceDB, and MongoDB. For other stores, such as PgVector, it's an empty string. Read the chunk text from `sources[i].metadata.text` (or whichever metadata key you stored it under).
+`document` is only populated by vector stores whose `query()` returns document content, such as Chroma, Elasticsearch, LanceDB, and MongoDB. For other stores, such as PgVector, it's an empty string. Read the chunk text from `sources[i].metadata?.text` (or whichever metadata key you stored it under). `metadata` is `undefined` when the store returns no metadata for a result.
 
 ## Default tool description
 

package/dist/document/transformers/character.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../src/document/transformers/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAqEzC,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEpC,YAAY,EAAE,SAAkB,EAAE,gBAAwB,EAAE,GAAG,WAAW,EAAE,GAAE,qBAA0B,EAIvG;IAED,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAmB9C;IAED,OAAO,CAAC,YAAY;CAyDrB;AAED,qBAAa,6BAA8B,SAAQ,eAAe;IAChE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEpC,YAAY,EAAE,UAAU,EAAE,gBAAwB,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAE,qBAA0B,EAIzG;IAED,OAAO,CAAC,UAAU;IA8DlB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAE9C;IAED,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,gBAAqB,GAAG,6BAA6B,CAQrG;IAED,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAua5D;CACF"}
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../src/document/transformers/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAuEzC,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEpC,YAAY,EAAE,SAAkB,EAAE,gBAAwB,EAAE,GAAG,WAAW,EAAE,GAAE,qBAA0B,EAIvG;IAED,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAmB9C;IAED,OAAO,CAAC,YAAY;CAyDrB;AAED,qBAAa,6BAA8B,SAAQ,eAAe;IAChE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEpC,YAAY,EAAE,UAAU,EAAE,gBAAwB,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAE,qBAA0B,EAIzG;IAED,OAAO,CAAC,UAAU;IA8DlB,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,CAE9C;IAED,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,gBAAqB,GAAG,6BAA6B,CAQrG;IAED,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAua5D;CACF"}

package/dist/index.cjs

@@ -4008,7 +4008,7 @@ var TextTransformer = class {
 };
 // src/document/transformers/character.ts
 function splitTextWithRegex(text, separator, separatorPosition) {
-	if (!separator) return text.split("");
+	if (!separator) return Array.from(text);
 	if (!text) return [];
 	const result = [];
 	let lastIndex = 0;