@mastra/rag 0.1.19-alpha.3 → 0.1.19-alpha.4

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/rag@0.1.19-alpha.3 build /home/runner/work/mastra/mastra/packages/rag
+> @mastra/rag@0.1.19-alpha.4 build /home/runner/work/mastra/mastra/packages/rag
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 16290ms
+TSC ⚡️ Build success in 16612ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.2
 Writing package typings: /home/runner/work/mastra/mastra/packages/rag/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.2
 Writing package typings: /home/runner/work/mastra/mastra/packages/rag/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 15267ms
+DTS ⚡️ Build success in 15610ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 96.18 KB
-CJS ⚡️ Build success in 2159ms
-ESM dist/index.js 95.46 KB
-ESM ⚡️ Build success in 2165ms
+ESM dist/index.js 218.60 KB
+ESM ⚡️ Build success in 4018ms
+CJS dist/index.cjs 220.36 KB
+CJS ⚡️ Build success in 4018ms

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/rag
 
+## 0.1.19-alpha.4
+
+### Patch Changes
+
+- f850f80: use custom extractors rather than llamaindex versions, and remove @llamaindex/core and @llamaindex/env packages
+- Updated dependencies [7e92011]
+  - @mastra/core@0.9.0-alpha.4
+
 ## 0.1.19-alpha.3
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -1,8 +1,9 @@
+import { BaseExtractor } from 'llamaindex';
+import type { BaseNode } from 'llamaindex';
 import { createTool } from '@mastra/core/tools';
 import { Document } from 'llamaindex';
 import type { EmbeddingModel } from 'ai';
 import type { KeywordExtractPrompt } from 'llamaindex';
-import type { LLM } from 'llamaindex';
 import type { MastraLanguageModel } from '@mastra/core/agent';
 import type { MastraVector } from '@mastra/core/vector';
 import type { QueryResult } from '@mastra/core/vector';
@@ -22,6 +23,10 @@ declare const ASTRA_PROMPT = "When querying Astra, you can ONLY use the operator
 export { ASTRA_PROMPT }
 export { ASTRA_PROMPT as ASTRA_PROMPT_alias_1 }
 
+declare const baseLLM: MastraLanguageModel;
+export { baseLLM }
+export { baseLLM as baseLLM_alias_1 }
+
 export declare class CharacterTransformer extends TextTransformer {
     protected separator: string;
     protected isSeparatorRegex: boolean;
@@ -134,6 +139,13 @@ export { defaultVectorQueryDescription }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_1 }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_2 }
 
+declare type ExtractKeyword = {
+    /**
+     * Comma-separated keywords extracted from the node. May be empty if extraction fails.
+     */
+    excerptKeywords: string;
+};
+
 declare type ExtractParams = {
     title?: TitleExtractorsArgs | boolean;
     summary?: SummaryExtractArgs | boolean;
@@ -143,6 +155,23 @@ declare type ExtractParams = {
 export { ExtractParams }
 export { ExtractParams as ExtractParams_alias_1 }
 
+declare type ExtractQuestion = {
+    /**
+     * Questions extracted from the node as a string (may be empty if extraction fails).
+     */
+    questionsThisExcerptCanAnswer: string;
+};
+
+declare type ExtractSummary = {
+    sectionSummary?: string;
+    prevSectionSummary?: string;
+    nextSectionSummary?: string;
+};
+
+declare type ExtractTitle = {
+    documentTitle: string;
+};
+
 declare const filterDescription = "JSON-formatted criteria to refine search results.\n- ALWAYS provide a filter value\n- If no filter is provided, use the default (\"{}\")\n- MUST be a valid, complete JSON object with proper quotes and brackets\n- Uses provided filter if specified\n- Default: \"{}\" (no filtering)\n- Example for no filtering: \"filter\": \"{}\"\n- Example: '{\"category\": \"health\"}'\n- Based on query intent\n- Do NOT use single quotes or unquoted properties\n- IMPORTANT: Always ensure JSON is properly closed with matching brackets\n- Multiple filters can be combined";
 export { filterDescription }
 export { filterDescription as filterDescription_alias_1 }
@@ -226,13 +255,66 @@ export declare class HTMLSectionTransformer {
 }
 
 declare type KeywordExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     keywords?: number;
     promptTemplate?: KeywordExtractPrompt['template'];
 };
 export { KeywordExtractArgs }
 export { KeywordExtractArgs as KeywordExtractArgs_alias_1 }
 
+/**
+ * Extract keywords from a list of nodes.
+ */
+declare class KeywordExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Number of keywords to extract.
+     * @type {number}
+     * @default 5
+     */
+    keywords: number;
+    /**
+     * The prompt template to use for the question extractor.
+     * @type {string}
+     */
+    promptTemplate: KeywordExtractPrompt;
+    /**
+     * Constructor for the KeywordExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} keywords Number of keywords to extract.
+     * @param {string} [promptTemplate] Optional custom prompt template (must include {context})
+     * @throws {Error} If keywords is less than 1.
+     */
+    constructor(options?: KeywordExtractArgs);
+    /**
+     *
+     * @param node Node to extract keywords from.
+     * @returns Keywords extracted from the node.
+     */
+    /**
+     * Extract keywords from a node. Returns an object with a comma-separated string of keywords, or an empty string if extraction fails.
+     * Adds error handling for malformed/empty LLM output.
+     */
+    extractKeywordsFromNodes(node: BaseNode): Promise<ExtractKeyword>;
+    /**
+     *
+     * @param nodes Nodes to extract keywords from.
+     * @returns Keywords extracted from the nodes.
+     */
+    /**
+     * Extract keywords from an array of nodes. Always returns an array (may be empty).
+     * @param nodes Nodes to extract keywords from.
+     * @returns Array of keyword extraction results.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractKeyword>>;
+}
+export { KeywordExtractor }
+export { KeywordExtractor as KeywordExtractor_alias_1 }
+
 declare enum Language {
     CPP = "cpp",
     GO = "go",
@@ -354,7 +436,7 @@ export { queryTextDescription as queryTextDescription_alias_1 }
 export { queryTextDescription as queryTextDescription_alias_2 }
 
 declare type QuestionAnswerExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     questions?: number;
     promptTemplate?: QuestionExtractPrompt['template'];
     embeddingOnly?: boolean;
@@ -362,6 +444,56 @@ declare type QuestionAnswerExtractArgs = {
 export { QuestionAnswerExtractArgs }
 export { QuestionAnswerExtractArgs as QuestionAnswerExtractArgs_alias_1 }
 
+/**
+ * Extract questions from a list of nodes.
+ */
+declare class QuestionsAnsweredExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Number of questions to generate.
+     * @type {number}
+     * @default 5
+     */
+    questions: number;
+    /**
+     * The prompt template to use for the question extractor.
+     * @type {string}
+     */
+    promptTemplate: QuestionExtractPrompt;
+    /**
+     * Wheter to use metadata for embeddings only
+     * @type {boolean}
+     * @default false
+     */
+    embeddingOnly: boolean;
+    /**
+     * Constructor for the QuestionsAnsweredExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} questions Number of questions to generate.
+     * @param {QuestionExtractPrompt['template']} promptTemplate Optional custom prompt template (should include {context}).
+     * @param {boolean} embeddingOnly Whether to use metadata for embeddings only.
+     */
+    constructor(options?: QuestionAnswerExtractArgs);
+    /**
+     * Extract answered questions from a node.
+     * @param {BaseNode} node Node to extract questions from.
+     * @returns {Promise<Array<ExtractQuestion> | Array<{}>>} Questions extracted from the node.
+     */
+    extractQuestionsFromNode(node: BaseNode): Promise<ExtractQuestion>;
+    /**
+     * Extract answered questions from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract questions from.
+     * @returns {Promise<Array<ExtractQuestion> | Array<{}>>} Questions extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractQuestion> | Array<object>>;
+}
+export { QuestionsAnsweredExtractor }
+export { QuestionsAnsweredExtractor as QuestionsAnsweredExtractor_alias_1 }
+
 declare interface RankedNode extends GraphNode {
     score: number;
 }
@@ -528,14 +660,61 @@ export declare function splitTextOnTokens({ text, tokenizer }: {
     tokenizer: Tokenizer;
 }): string[];
 
+declare const STRIP_REGEX: RegExp;
+export { STRIP_REGEX }
+export { STRIP_REGEX as STRIP_REGEX_alias_1 }
+
 declare type SummaryExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     summaries?: string[];
     promptTemplate?: SummaryPrompt['template'];
 };
 export { SummaryExtractArgs }
 export { SummaryExtractArgs as SummaryExtractArgs_alias_1 }
 
+/**
+ * Summarize an array of nodes using a custom LLM.
+ *
+ * @param nodes Array of node-like objects
+ * @param options Summary extraction options
+ * @returns Array of summary results
+ */
+declare class SummaryExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    private llm;
+    /**
+     * List of summaries to extract: 'self', 'prev', 'next'
+     * @type {string[]}
+     */
+    summaries: string[];
+    /**
+     * The prompt template to use for the summary extractor.
+     * @type {string}
+     */
+    promptTemplate: SummaryPrompt;
+    private selfSummary;
+    private prevSummary;
+    private nextSummary;
+    constructor(options?: SummaryExtractArgs);
+    /**
+     * Extract summary from a node.
+     * @param {BaseNode} node Node to extract summary from.
+     * @returns {Promise<string>} Summary extracted from the node.
+     */
+    generateNodeSummary(node: BaseNode): Promise<string>;
+    /**
+     * Extract summaries from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract summaries from.
+     * @returns {Promise<ExtractSummary[]>} Summaries extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<ExtractSummary[]>;
+}
+export { SummaryExtractor }
+export { SummaryExtractor as SummaryExtractor_alias_1 }
+
 /**
  * TODO: GraphRAG Enhancements
  *  - Add support for more edge types (sequential, hierarchical, citation, etc)
@@ -564,8 +743,61 @@ export declare abstract class TextTransformer implements Transformer {
     protected mergeSplits(splits: string[], separator: string): string[];
 }
 
+/**
+ * Extract title from a list of nodes.
+ */
+declare class TitleExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Can work for mixture of text and non-text nodes
+     * @type {boolean}
+     * @default false
+     */
+    isTextNodeOnly: boolean;
+    /**
+     * Number of nodes to extrct titles from.
+     * @type {number}
+     * @default 5
+     */
+    nodes: number;
+    /**
+     * The prompt template to use for the title extractor.
+     * @type {string}
+     */
+    nodeTemplate: TitleExtractorPrompt;
+    /**
+     * The prompt template to merge title with..
+     * @type {string}
+     */
+    combineTemplate: TitleCombinePrompt;
+    /**
+     * Constructor for the TitleExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} nodes Number of nodes to extract titles from.
+     * @param {TitleExtractorPrompt} nodeTemplate The prompt template to use for the title extractor.
+     * @param {string} combineTemplate The prompt template to merge title with..
+     */
+    constructor(options?: TitleExtractorsArgs);
+    /**
+     * Extract titles from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract titles from.
+     * @returns {Promise<BaseNode<ExtractTitle>[]>} Titles extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractTitle>>;
+    private filterNodes;
+    private separateNodesByDocument;
+    private extractTitles;
+    private getTitlesCandidates;
+}
+export { TitleExtractor }
+export { TitleExtractor as TitleExtractor_alias_1 }
+
 declare type TitleExtractorsArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     nodes?: number;
     nodeTemplate?: TitleExtractorPrompt['template'];
     combineTemplate?: TitleCombinePrompt['template'];

package/dist/_tsup-dts-rollup.d.ts

@@ -1,8 +1,9 @@
+import { BaseExtractor } from 'llamaindex';
+import type { BaseNode } from 'llamaindex';
 import { createTool } from '@mastra/core/tools';
 import { Document } from 'llamaindex';
 import type { EmbeddingModel } from 'ai';
 import type { KeywordExtractPrompt } from 'llamaindex';
-import type { LLM } from 'llamaindex';
 import type { MastraLanguageModel } from '@mastra/core/agent';
 import type { MastraVector } from '@mastra/core/vector';
 import type { QueryResult } from '@mastra/core/vector';
@@ -22,6 +23,10 @@ declare const ASTRA_PROMPT = "When querying Astra, you can ONLY use the operator
 export { ASTRA_PROMPT }
 export { ASTRA_PROMPT as ASTRA_PROMPT_alias_1 }
 
+declare const baseLLM: MastraLanguageModel;
+export { baseLLM }
+export { baseLLM as baseLLM_alias_1 }
+
 export declare class CharacterTransformer extends TextTransformer {
     protected separator: string;
     protected isSeparatorRegex: boolean;
@@ -134,6 +139,13 @@ export { defaultVectorQueryDescription }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_1 }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_2 }
 
+declare type ExtractKeyword = {
+    /**
+     * Comma-separated keywords extracted from the node. May be empty if extraction fails.
+     */
+    excerptKeywords: string;
+};
+
 declare type ExtractParams = {
     title?: TitleExtractorsArgs | boolean;
     summary?: SummaryExtractArgs | boolean;
@@ -143,6 +155,23 @@ declare type ExtractParams = {
 export { ExtractParams }
 export { ExtractParams as ExtractParams_alias_1 }
 
+declare type ExtractQuestion = {
+    /**
+     * Questions extracted from the node as a string (may be empty if extraction fails).
+     */
+    questionsThisExcerptCanAnswer: string;
+};
+
+declare type ExtractSummary = {
+    sectionSummary?: string;
+    prevSectionSummary?: string;
+    nextSectionSummary?: string;
+};
+
+declare type ExtractTitle = {
+    documentTitle: string;
+};
+
 declare const filterDescription = "JSON-formatted criteria to refine search results.\n- ALWAYS provide a filter value\n- If no filter is provided, use the default (\"{}\")\n- MUST be a valid, complete JSON object with proper quotes and brackets\n- Uses provided filter if specified\n- Default: \"{}\" (no filtering)\n- Example for no filtering: \"filter\": \"{}\"\n- Example: '{\"category\": \"health\"}'\n- Based on query intent\n- Do NOT use single quotes or unquoted properties\n- IMPORTANT: Always ensure JSON is properly closed with matching brackets\n- Multiple filters can be combined";
 export { filterDescription }
 export { filterDescription as filterDescription_alias_1 }
@@ -226,13 +255,66 @@ export declare class HTMLSectionTransformer {
 }
 
 declare type KeywordExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     keywords?: number;
     promptTemplate?: KeywordExtractPrompt['template'];
 };
 export { KeywordExtractArgs }
 export { KeywordExtractArgs as KeywordExtractArgs_alias_1 }
 
+/**
+ * Extract keywords from a list of nodes.
+ */
+declare class KeywordExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Number of keywords to extract.
+     * @type {number}
+     * @default 5
+     */
+    keywords: number;
+    /**
+     * The prompt template to use for the question extractor.
+     * @type {string}
+     */
+    promptTemplate: KeywordExtractPrompt;
+    /**
+     * Constructor for the KeywordExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} keywords Number of keywords to extract.
+     * @param {string} [promptTemplate] Optional custom prompt template (must include {context})
+     * @throws {Error} If keywords is less than 1.
+     */
+    constructor(options?: KeywordExtractArgs);
+    /**
+     *
+     * @param node Node to extract keywords from.
+     * @returns Keywords extracted from the node.
+     */
+    /**
+     * Extract keywords from a node. Returns an object with a comma-separated string of keywords, or an empty string if extraction fails.
+     * Adds error handling for malformed/empty LLM output.
+     */
+    extractKeywordsFromNodes(node: BaseNode): Promise<ExtractKeyword>;
+    /**
+     *
+     * @param nodes Nodes to extract keywords from.
+     * @returns Keywords extracted from the nodes.
+     */
+    /**
+     * Extract keywords from an array of nodes. Always returns an array (may be empty).
+     * @param nodes Nodes to extract keywords from.
+     * @returns Array of keyword extraction results.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractKeyword>>;
+}
+export { KeywordExtractor }
+export { KeywordExtractor as KeywordExtractor_alias_1 }
+
 declare enum Language {
     CPP = "cpp",
     GO = "go",
@@ -354,7 +436,7 @@ export { queryTextDescription as queryTextDescription_alias_1 }
 export { queryTextDescription as queryTextDescription_alias_2 }
 
 declare type QuestionAnswerExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     questions?: number;
     promptTemplate?: QuestionExtractPrompt['template'];
     embeddingOnly?: boolean;
@@ -362,6 +444,56 @@ declare type QuestionAnswerExtractArgs = {
 export { QuestionAnswerExtractArgs }
 export { QuestionAnswerExtractArgs as QuestionAnswerExtractArgs_alias_1 }
 
+/**
+ * Extract questions from a list of nodes.
+ */
+declare class QuestionsAnsweredExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Number of questions to generate.
+     * @type {number}
+     * @default 5
+     */
+    questions: number;
+    /**
+     * The prompt template to use for the question extractor.
+     * @type {string}
+     */
+    promptTemplate: QuestionExtractPrompt;
+    /**
+     * Wheter to use metadata for embeddings only
+     * @type {boolean}
+     * @default false
+     */
+    embeddingOnly: boolean;
+    /**
+     * Constructor for the QuestionsAnsweredExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} questions Number of questions to generate.
+     * @param {QuestionExtractPrompt['template']} promptTemplate Optional custom prompt template (should include {context}).
+     * @param {boolean} embeddingOnly Whether to use metadata for embeddings only.
+     */
+    constructor(options?: QuestionAnswerExtractArgs);
+    /**
+     * Extract answered questions from a node.
+     * @param {BaseNode} node Node to extract questions from.
+     * @returns {Promise<Array<ExtractQuestion> | Array<{}>>} Questions extracted from the node.
+     */
+    extractQuestionsFromNode(node: BaseNode): Promise<ExtractQuestion>;
+    /**
+     * Extract answered questions from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract questions from.
+     * @returns {Promise<Array<ExtractQuestion> | Array<{}>>} Questions extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractQuestion> | Array<object>>;
+}
+export { QuestionsAnsweredExtractor }
+export { QuestionsAnsweredExtractor as QuestionsAnsweredExtractor_alias_1 }
+
 declare interface RankedNode extends GraphNode {
     score: number;
 }
@@ -528,14 +660,61 @@ export declare function splitTextOnTokens({ text, tokenizer }: {
     tokenizer: Tokenizer;
 }): string[];
 
+declare const STRIP_REGEX: RegExp;
+export { STRIP_REGEX }
+export { STRIP_REGEX as STRIP_REGEX_alias_1 }
+
 declare type SummaryExtractArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     summaries?: string[];
     promptTemplate?: SummaryPrompt['template'];
 };
 export { SummaryExtractArgs }
 export { SummaryExtractArgs as SummaryExtractArgs_alias_1 }
 
+/**
+ * Summarize an array of nodes using a custom LLM.
+ *
+ * @param nodes Array of node-like objects
+ * @param options Summary extraction options
+ * @returns Array of summary results
+ */
+declare class SummaryExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    private llm;
+    /**
+     * List of summaries to extract: 'self', 'prev', 'next'
+     * @type {string[]}
+     */
+    summaries: string[];
+    /**
+     * The prompt template to use for the summary extractor.
+     * @type {string}
+     */
+    promptTemplate: SummaryPrompt;
+    private selfSummary;
+    private prevSummary;
+    private nextSummary;
+    constructor(options?: SummaryExtractArgs);
+    /**
+     * Extract summary from a node.
+     * @param {BaseNode} node Node to extract summary from.
+     * @returns {Promise<string>} Summary extracted from the node.
+     */
+    generateNodeSummary(node: BaseNode): Promise<string>;
+    /**
+     * Extract summaries from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract summaries from.
+     * @returns {Promise<ExtractSummary[]>} Summaries extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<ExtractSummary[]>;
+}
+export { SummaryExtractor }
+export { SummaryExtractor as SummaryExtractor_alias_1 }
+
 /**
  * TODO: GraphRAG Enhancements
  *  - Add support for more edge types (sequential, hierarchical, citation, etc)
@@ -564,8 +743,61 @@ export declare abstract class TextTransformer implements Transformer {
     protected mergeSplits(splits: string[], separator: string): string[];
 }
 
+/**
+ * Extract title from a list of nodes.
+ */
+declare class TitleExtractor extends BaseExtractor {
+    /**
+     * MastraLanguageModel instance.
+     * @type {MastraLanguageModel}
+     */
+    llm: MastraLanguageModel;
+    /**
+     * Can work for mixture of text and non-text nodes
+     * @type {boolean}
+     * @default false
+     */
+    isTextNodeOnly: boolean;
+    /**
+     * Number of nodes to extrct titles from.
+     * @type {number}
+     * @default 5
+     */
+    nodes: number;
+    /**
+     * The prompt template to use for the title extractor.
+     * @type {string}
+     */
+    nodeTemplate: TitleExtractorPrompt;
+    /**
+     * The prompt template to merge title with..
+     * @type {string}
+     */
+    combineTemplate: TitleCombinePrompt;
+    /**
+     * Constructor for the TitleExtractor class.
+     * @param {MastraLanguageModel} llm MastraLanguageModel instance.
+     * @param {number} nodes Number of nodes to extract titles from.
+     * @param {TitleExtractorPrompt} nodeTemplate The prompt template to use for the title extractor.
+     * @param {string} combineTemplate The prompt template to merge title with..
+     */
+    constructor(options?: TitleExtractorsArgs);
+    /**
+     * Extract titles from a list of nodes.
+     * @param {BaseNode[]} nodes Nodes to extract titles from.
+     * @returns {Promise<BaseNode<ExtractTitle>[]>} Titles extracted from the nodes.
+     */
+    extract(nodes: BaseNode[]): Promise<Array<ExtractTitle>>;
+    private filterNodes;
+    private separateNodesByDocument;
+    private extractTitles;
+    private getTitlesCandidates;
+}
+export { TitleExtractor }
+export { TitleExtractor as TitleExtractor_alias_1 }
+
 declare type TitleExtractorsArgs = {
-    llm?: LLM;
+    llm?: MastraLanguageModel;
     nodes?: number;
     nodeTemplate?: TitleExtractorPrompt['template'];
     combineTemplate?: TitleCombinePrompt['template'];