@mastra/rag 1.0.8-alpha.0 → 1.0.9-alpha.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @mastra/rag@1.0.8-alpha.0 build /home/runner/work/mastra/mastra/packages/rag
+> @mastra/rag@1.0.9-alpha.0 build /home/runner/work/mastra/mastra/packages/rag
 > tsup --silent --config tsup.config.ts
 

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @mastra/rag
 
+## 1.0.9-alpha.0
+
+### Patch Changes
+
+- a741dde: generateVNext plumbing
+- Updated dependencies [0a7f675]
+- Updated dependencies [12cae67]
+- Updated dependencies [5a37d0c]
+- Updated dependencies [4bde0cb]
+- Updated dependencies [1a80071]
+- Updated dependencies [36a3be8]
+- Updated dependencies [361757b]
+- Updated dependencies [2bb9955]
+- Updated dependencies [2454423]
+- Updated dependencies [a44d91e]
+- Updated dependencies [dfb91e9]
+- Updated dependencies [a741dde]
+- Updated dependencies [7cb3fc0]
+- Updated dependencies [195eabb]
+- Updated dependencies [b78b95b]
+  - @mastra/core@0.14.0-alpha.4
+
+## 1.0.8
+
+### Patch Changes
+
+- 1be6004: Added semantic markdown chunking strategy.
+- Updated dependencies [d5330bf]
+- Updated dependencies [2e74797]
+- Updated dependencies [8388649]
+- Updated dependencies [a239d41]
+- Updated dependencies [dd94a26]
+- Updated dependencies [3ba6772]
+- Updated dependencies [b5cf2a3]
+- Updated dependencies [2fff911]
+- Updated dependencies [b32c50d]
+- Updated dependencies [63449d0]
+- Updated dependencies [121a3f8]
+- Updated dependencies [ec510e7]
+  - @mastra/core@0.13.2
+
 ## 1.0.8-alpha.0
 
 ### Patch Changes

package/dist/document/extractors/keywords.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/keywords.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,GAAG,EAAE,mBAAmB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAK;IACrB,cAAc,EAAE,oBAAoB,CAAC;IAErC;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE,kBAAkB;IAexC;;;;OAIG;IACH;;;OAGG;IACG,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAwCvE;;;;OAIG;IACH;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;CAKjE"}
+{"version":3,"file":"keywords.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/keywords.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,cAAc,GAAG;IACpB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,GAAG,EAAE,mBAAmB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAK;IACrB,cAAc,EAAE,oBAAoB,CAAC;IAErC;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE,kBAAkB;IAexC;;;;OAIG;IACH;;;OAGG;IACG,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDvE;;;;OAIG;IACH;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;CAKjE"}

package/dist/document/extractors/questions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/questions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG;IACrB;;OAEG;IACH,6BAA6B,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAK;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,aAAa,EAAE,OAAO,CAAS;IAE/B;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IAkB/C;;;;OAIG;IACG,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IA0CxE;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;CAKlF"}
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/questions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG;IACrB;;OAEG;IACH,6BAA6B,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,GAAG,EAAE,mBAAmB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAK;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,aAAa,EAAE,OAAO,CAAS;IAE/B;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IAkB/C;;;;OAIG;IACG,wBAAwB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IA4CxE;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;CAKlF"}

package/dist/document/extractors/summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/summary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,cAAc,GAAG;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,OAAO,CAAC,GAAG,CAAsB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAU;gBACjB,OAAO,CAAC,EAAE,kBAAkB;IAsBxC;;;;OAIG;IACG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAmC1D;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAqB5D"}
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/summary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,cAAc,GAAG;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,OAAO,CAAC,GAAG,CAAsB;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAU;gBACjB,OAAO,CAAC,EAAE,kBAAkB;IAsBxC;;;;OAIG;IACG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC1D;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAqB5D"}

package/dist/document/extractors/title.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,KAAK,YAAY,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,GAAG,EAAE,mBAAmB,CAAC;IACzB,cAAc,EAAE,OAAO,CAAS;IAChC,KAAK,EAAE,MAAM,CAAK;IAClB,YAAY,EAAE,oBAAoB,CAAC;IACnC,eAAe,EAAE,kBAAkB,CAAC;gBAExB,OAAO,CAAC,EAAE,mBAAmB;IAqBzC;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAoC9D,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,uBAAuB;YAYjB,aAAa;YAoCb,mBAAmB;CA8BlC"}
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../../src/document/extractors/title.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,KAAK,YAAY,GAAG;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,GAAG,EAAE,mBAAmB,CAAC;IACzB,cAAc,EAAE,OAAO,CAAS;IAChC,KAAK,EAAE,MAAM,CAAK;IAClB,YAAY,EAAE,oBAAoB,CAAC;IACnC,eAAe,EAAE,kBAAkB,CAAC;gBAExB,OAAO,CAAC,EAAE,mBAAmB;IAqBzC;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAoC9D,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,uBAAuB;YAYjB,aAAa;YA4Cb,mBAAmB;CAiClC"}

package/dist/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
+var agent = require('@mastra/core/agent');
 var crypto = require('crypto');
 var zod = require('zod');
 var nodeHtmlBetterParser = require('node-html-better-parser');
 var jsTiktoken = require('js-tiktoken');
 var big_js = require('big.js');
-var agent = require('@mastra/core/agent');
 var relevance = require('@mastra/core/relevance');
 var ZeroEntropy = require('zeroentropy');
 var tools = require('@mastra/core/tools');
@@ -2291,7 +2291,7 @@ var openaiChatChunkSchema = zod.z.union([
   openaiErrorDataSchema
 ]);
 function isReasoningModel(modelId) {
-  return modelId.startsWith("o");
+  return modelId.startsWith("o") || modelId.startsWith("gpt-5");
 }
 function isAudioModel(modelId) {
   return modelId.startsWith("gpt-4o-audio-preview");
@@ -3814,7 +3814,7 @@ function isErrorChunk(chunk) {
   return chunk.type === "error";
 }
 function getResponsesModelConfig(modelId) {
-  if (modelId.startsWith("o")) {
+  if (modelId.startsWith("o") || modelId.startsWith("gpt-5")) {
     if (modelId.startsWith("o1-mini") || modelId.startsWith("o1-preview")) {
       return {
         isReasoningModel: true,
@@ -4140,64 +4140,65 @@ var TitleExtractor = class extends BaseExtractor {
     for (const [key, nodes] of Object.entries(nodesByDocument)) {
       const titleCandidates = await this.getTitlesCandidates(nodes);
       const combinedTitles = titleCandidates.join(", ");
-      const completion = await this.llm.doGenerate({
-        inputFormat: "messages",
-        mode: { type: "regular" },
-        prompt: [
-          {
-            role: "user",
-            content: [
-              {
-                type: "text",
-                text: this.combineTemplate.format({
-                  context: combinedTitles
-                })
-              }
-            ]
-          }
-        ]
-      });
       let title = "";
-      if (typeof completion.text === "string") {
-        title = completion.text.trim();
+      if (this.llm.specificationVersion === "v2") {
+        const miniAgent = new agent.Agent({
+          model: this.llm,
+          name: "title-extractor",
+          instructions: "You are a title extractor. You are given a list of nodes and you need to extract the title from the nodes."
+        });
+        const result = await miniAgent.generateVNext(
+          [{ role: "user", content: this.combineTemplate.format({ context: combinedTitles }) }],
+          { format: "mastra" }
+        );
+        title = result.text;
       } else {
-        console.warn("Title extraction LLM output was not a string:", completion.text);
+        const miniAgent = new agent.Agent({
+          model: this.llm,
+          name: "title-extractor",
+          instructions: "You are a title extractor. You are given a list of nodes and you need to extract the title from the nodes."
+        });
+        const result = await miniAgent.generate([
+          { role: "user", content: this.combineTemplate.format({ context: combinedTitles }) }
+        ]);
+        title = result.text;
+      }
+      if (!title) {
+        console.warn("Title extraction LLM output returned empty");
       }
       titlesByDocument[key] = title;
     }
     return titlesByDocument;
   }
   async getTitlesCandidates(nodes) {
+    const miniAgent = new agent.Agent({
+      model: this.llm,
+      name: "titles-candidates-extractor",
+      instructions: "You are a titles candidates extractor. You are given a list of nodes and you need to extract the titles candidates from the nodes."
+    });
     const titleJobs = nodes.map(async (node) => {
-      const completion = await this.llm.doGenerate({
-        inputFormat: "messages",
-        mode: { type: "regular" },
-        prompt: [
-          {
-            role: "user",
-            content: [
-              {
-                type: "text",
-                text: this.nodeTemplate.format({
-                  context: node.getContent()
-                })
-              }
-            ]
-          }
-        ]
-      });
-      if (typeof completion.text === "string") {
-        return completion.text.trim();
+      let completion;
+      if (this.llm.specificationVersion === "v2") {
+        const result = await miniAgent.generateVNext(
+          [{ role: "user", content: this.nodeTemplate.format({ context: node.getContent() }) }],
+          { format: "mastra" }
+        );
+        completion = result.text;
       } else {
-        console.warn("Title candidate extraction LLM output was not a string:", completion.text);
+        const result = await miniAgent.generate([
+          { role: "user", content: this.nodeTemplate.format({ context: node.getContent() }) }
+        ]);
+        completion = result.text;
+      }
+      if (!completion) {
+        console.warn("Title candidate extraction LLM output returned empty");
         return "";
       }
+      return completion.trim();
     });
     return await Promise.all(titleJobs);
   }
 };
-
-// src/document/extractors/summary.ts
 var SummaryExtractor = class extends BaseExtractor {
   llm;
   summaries;
@@ -4237,21 +4238,22 @@ var SummaryExtractor = class extends BaseExtractor {
     const prompt = this.promptTemplate.format({
       context
     });
-    const result = await this.llm.doGenerate({
-      inputFormat: "messages",
-      mode: { type: "regular" },
-      prompt: [
-        {
-          role: "user",
-          content: [{ type: "text", text: prompt }]
-        }
-      ]
+    const miniAgent = new agent.Agent({
+      model: this.llm,
+      name: "summary-extractor",
+      instructions: "You are a summary extractor. You are given a node and you need to extract the summary from the node."
     });
     let summary = "";
-    if (typeof result.text === "string") {
-      summary = result.text.trim();
+    if (this.llm.specificationVersion === "v2") {
+      const result = await miniAgent.generateVNext([{ role: "user", content: prompt }], { format: "mastra" });
+      summary = result.text;
     } else {
-      console.warn("Summary extraction LLM output was not a string:", result.text);
+      const result = await miniAgent.generate([{ role: "user", content: prompt }]);
+      summary = result.text;
+    }
+    if (!summary) {
+      console.warn("Summary extraction LLM output returned empty");
+      return "";
     }
     return summary.replace(STRIP_REGEX, "");
   }
@@ -4278,8 +4280,6 @@ var SummaryExtractor = class extends BaseExtractor {
     return metadataList;
   }
 };
-
-// src/document/extractors/questions.ts
 var QuestionsAnsweredExtractor = class extends BaseExtractor {
   llm;
   questions = 5;
@@ -4323,26 +4323,24 @@ var QuestionsAnsweredExtractor = class extends BaseExtractor {
       context: contextStr,
       numQuestions: this.questions.toString()
     });
-    const questions = await this.llm.doGenerate({
-      inputFormat: "messages",
-      mode: { type: "regular" },
-      prompt: [
-        {
-          role: "user",
-          content: [{ type: "text", text: prompt }]
-        }
-      ]
+    const miniAgent = new agent.Agent({
+      model: this.llm,
+      name: "question-extractor",
+      instructions: "You are a question extractor. You are given a node and you need to extract the questions from the node."
     });
-    let result = "";
-    try {
-      if (typeof questions.text === "string") {
-        result = questions.text.replace(STRIP_REGEX, "").trim();
-      } else {
-        console.warn("Question extraction LLM output was not a string:", questions.text);
-      }
-    } catch (err) {
-      console.warn("Question extraction failed:", err);
+    let questionsText = "";
+    if (this.llm.specificationVersion === "v2") {
+      const result2 = await miniAgent.generateVNext([{ role: "user", content: prompt }], { format: "mastra" });
+      questionsText = result2.text;
+    } else {
+      const result2 = await miniAgent.generate([{ role: "user", content: prompt }]);
+      questionsText = result2.text;
+    }
+    if (!questionsText) {
+      console.warn("Question extraction LLM output returned empty");
+      return { questionsThisExcerptCanAnswer: "" };
     }
+    const result = questionsText.replace(STRIP_REGEX, "").trim();
     return {
       questionsThisExcerptCanAnswer: result
     };
@@ -4357,8 +4355,6 @@ var QuestionsAnsweredExtractor = class extends BaseExtractor {
     return results;
   }
 };
-
-// src/document/extractors/keywords.ts
 var KeywordExtractor = class extends BaseExtractor {
   llm;
   keywords = 5;
@@ -4399,33 +4395,43 @@ var KeywordExtractor = class extends BaseExtractor {
     }
     let keywords = "";
     try {
-      const completion = await this.llm.doGenerate({
-        inputFormat: "messages",
-        mode: { type: "regular" },
-        prompt: [
+      const miniAgent = new agent.Agent({
+        model: this.llm,
+        name: "keyword-extractor",
+        instructions: "You are a keyword extractor. You are given a node and you need to extract the keywords from the node."
+      });
+      if (this.llm.specificationVersion === "v2") {
+        const result = await miniAgent.generateVNext(
+          [
+            {
+              role: "user",
+              content: this.promptTemplate.format({
+                context: node.getContent(),
+                maxKeywords: this.keywords.toString()
+              })
+            }
+          ],
+          { format: "mastra" }
+        );
+        keywords = result.text;
+      } else {
+        const result = await miniAgent.generate([
           {
             role: "user",
-            content: [
-              {
-                type: "text",
-                text: this.promptTemplate.format({
-                  context: node.getContent(),
-                  maxKeywords: this.keywords.toString()
-                })
-              }
-            ]
+            content: this.promptTemplate.format({ context: node.getContent(), maxKeywords: this.keywords.toString() })
           }
-        ]
-      });
-      if (typeof completion.text === "string") {
-        keywords = completion.text.trim();
-      } else {
-        console.warn("Keyword extraction LLM output was not a string:", completion.text);
+        ]);
+        keywords = result.text;
+      }
+      if (!keywords) {
+        console.warn("Keyword extraction LLM output returned empty");
+        return { excerptKeywords: "" };
       }
+      return { excerptKeywords: keywords.trim() };
     } catch (err) {
       console.warn("Keyword extraction failed:", err);
+      return { excerptKeywords: "" };
     }
-    return { excerptKeywords: keywords };
   }
   /**
    *