@mastra/rag 0.1.20-alpha.0 → 0.1.20-alpha.2

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

@@ -1,18 +1,10 @@
-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 { MastraLanguageModel } from '@mastra/core/agent';
 import type { MastraVector } from '@mastra/core/vector';
 import type { QueryResult } from '@mastra/core/vector';
-import type { QuestionExtractPrompt } from 'llamaindex';
-import type { SummaryPrompt } from 'llamaindex';
 import type { TiktokenEncoding } from 'js-tiktoken';
 import type { TiktokenModel } from 'js-tiktoken';
-import type { TitleCombinePrompt } from 'llamaindex';
-import type { TitleExtractorPrompt } from 'llamaindex';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
 /**
@@ -23,9 +15,66 @@ 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 abstract class BaseExtractor {
+    isTextNodeOnly: boolean;
+    abstract extract(nodes: BaseNode[]): Promise<Record<string, any>[]>;
+    /**
+     *
+     * @param nodes Nodes to extract metadata from.
+     * @returns Metadata extracted from the nodes.
+     */
+    processNodes(nodes: BaseNode[]): Promise<BaseNode[]>;
+}
+
+export declare const baseLLM: MastraLanguageModel;
+
+/**
+ * Generic abstract class for retrievable nodes
+ */
+declare abstract class BaseNode<T extends Metadata = Metadata> {
+    id_: string;
+    metadata: T;
+    relationships: Partial<Record<NodeRelationship, RelatedNodeType<T>>>;
+    accessor hash: string;
+    protected constructor(init?: BaseNodeParams<T>);
+    abstract get type(): ObjectType;
+    abstract getContent(): string;
+    abstract getMetadataStr(): string;
+    get sourceNode(): RelatedNodeInfo<T> | undefined;
+    get prevNode(): RelatedNodeInfo<T> | undefined;
+    get nextNode(): RelatedNodeInfo<T> | undefined;
+    get parentNode(): RelatedNodeInfo<T> | undefined;
+    get childNodes(): RelatedNodeInfo<T>[] | undefined;
+    abstract generateHash(): string;
+}
+export { BaseNode }
+export { BaseNode as BaseNode_alias_1 }
+
+declare type BaseNodeParams<T extends Metadata = Metadata> = {
+    id_?: string | undefined;
+    metadata?: T | undefined;
+    relationships?: Partial<Record<NodeRelationship, RelatedNodeType<T>>> | undefined;
+    hash?: string | undefined;
+};
+export { BaseNodeParams }
+export { BaseNodeParams as BaseNodeParams_alias_1 }
+
+declare abstract class BasePromptTemplate<const TemplatesVar extends readonly string[] = string[]> {
+    templateVars: Set<string>;
+    options: Partial<Record<TemplatesVar[number] | (string & {}), string>>;
+    protected constructor(options: BasePromptTemplateOptions<TemplatesVar>);
+    abstract partialFormat(options: Partial<Record<TemplatesVar[number] | (string & {}), string>>): BasePromptTemplate<TemplatesVar>;
+    abstract format(options?: Partial<Record<TemplatesVar[number] | (string & {}), string>>): string;
+    abstract formatMessages(options?: Partial<Record<TemplatesVar[number] | (string & {}), string>>): ChatMessage[];
+    abstract get template(): string;
+}
+export { BasePromptTemplate }
+export { BasePromptTemplate as BasePromptTemplate_alias_1 }
+
+export declare type BasePromptTemplateOptions<TemplatesVar extends readonly string[]> = {
+    templateVars?: TemplatesVar | readonly string[];
+    options?: Partial<Record<TemplatesVar[number] | (string & {}), string>>;
+};
 
 export declare class CharacterTransformer extends TextTransformer {
     protected separator: string;
@@ -48,6 +97,12 @@ export declare class CharacterTransformer extends TextTransformer {
     private __splitChunk;
 }
 
+export declare type ChatMessage<AdditionalMessageOptions extends object = object> = {
+    content: MessageContent;
+    role: MessageType;
+    options?: undefined | AdditionalMessageOptions;
+};
+
 declare const CHROMA_PROMPT = "When querying Chroma, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nRestrictions:\n- Regex patterns are not supported\n- Element operators are not supported\n- Only $and and $or logical operators are supported\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- Empty arrays in $in/$nin will return no results\n- If multiple top-level fields exist, they're wrapped in $and\n- Only logical operators ($and, $or) can be used at the top level\n- All other operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n  Invalid: { \"$in\": [...] }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"$or\": [\n      { \"inStock\": true },\n      { \"preorder\": true }\n    ]}\n  ]\n}";
 export { CHROMA_PROMPT }
 export { CHROMA_PROMPT as CHROMA_PROMPT_alias_1 }
@@ -134,11 +189,41 @@ export { defaultGraphRagDescription }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_1 }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_2 }
 
+declare const defaultKeywordExtractPrompt: KeywordExtractPrompt;
+export { defaultKeywordExtractPrompt }
+export { defaultKeywordExtractPrompt as defaultKeywordExtractPrompt_alias_1 }
+
+declare const defaultQuestionExtractPrompt: PromptTemplate<readonly ["numQuestions", "context"]>;
+export { defaultQuestionExtractPrompt }
+export { defaultQuestionExtractPrompt as defaultQuestionExtractPrompt_alias_1 }
+
+declare const defaultSummaryPrompt: SummaryPrompt;
+export { defaultSummaryPrompt }
+export { defaultSummaryPrompt as defaultSummaryPrompt_alias_1 }
+
+declare const defaultTitleCombinePromptTemplate: PromptTemplate<readonly ["context"]>;
+export { defaultTitleCombinePromptTemplate }
+export { defaultTitleCombinePromptTemplate as defaultTitleCombinePromptTemplate_alias_1 }
+
+declare const defaultTitleExtractorPromptTemplate: PromptTemplate<readonly ["context"]>;
+export { defaultTitleExtractorPromptTemplate }
+export { defaultTitleExtractorPromptTemplate as defaultTitleExtractorPromptTemplate_alias_1 }
+
 declare const defaultVectorQueryDescription: () => string;
 export { defaultVectorQueryDescription }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_1 }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_2 }
 
+/**
+ * A document is just a special text node with a docId.
+ */
+declare class Document<T extends Metadata = Metadata> extends TextNode<T> {
+    constructor(init?: TextNodeParams<T>);
+    get type(): ObjectType;
+}
+export { Document }
+export { Document as Document_alias_1 }
+
 declare type ExtractKeyword = {
     /**
      * Comma-separated keywords extracted from the node. May be empty if extraction fails.
@@ -177,6 +262,14 @@ export { filterDescription }
 export { filterDescription as filterDescription_alias_1 }
 export { filterDescription as filterDescription_alias_2 }
 
+/**
+ * Formats a string by replacing placeholders with values from the provided parameters.
+ * @param str The string to format.
+ * @param params A record of placeholder names to their corresponding values.
+ * @returns The formatted string.
+ */
+export declare function format(str: string, params: Record<string, string>): string;
+
 export declare interface GraphChunk {
     text: string;
     metadata: Record<string, any>;
@@ -266,21 +359,8 @@ 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.
@@ -315,6 +395,10 @@ declare class KeywordExtractor extends BaseExtractor {
 export { KeywordExtractor }
 export { KeywordExtractor as KeywordExtractor_alias_1 }
 
+declare type KeywordExtractPrompt = PromptTemplate<['context', 'maxKeywords']>;
+export { KeywordExtractPrompt }
+export { KeywordExtractPrompt as KeywordExtractPrompt_alias_1 }
+
 declare enum Language {
     CPP = "cpp",
     GO = "go",
@@ -418,6 +502,42 @@ export { MDocument }
 export { MDocument as MDocument_alias_1 }
 export { MDocument as MDocument_alias_2 }
 
+/**
+ * Extended type for the content of a message that allows for multi-modal messages.
+ */
+export declare type MessageContent = string | MessageContentTextDetail[];
+
+export declare type MessageContentTextDetail = {
+    type: 'text';
+    text: string;
+};
+
+export declare type MessageType = 'user' | 'assistant' | 'system' | 'memory' | 'developer';
+
+declare type Metadata = Record<string, any>;
+export { Metadata }
+export { Metadata as Metadata_alias_1 }
+
+declare enum NodeRelationship {
+    SOURCE = "SOURCE",
+    PREVIOUS = "PREVIOUS",
+    NEXT = "NEXT",
+    PARENT = "PARENT",
+    CHILD = "CHILD"
+}
+export { NodeRelationship }
+export { NodeRelationship as NodeRelationship_alias_1 }
+
+declare enum ObjectType {
+    TEXT = "TEXT",
+    IMAGE = "IMAGE",
+    INDEX = "INDEX",
+    DOCUMENT = "DOCUMENT",
+    IMAGE_DOCUMENT = "IMAGE_DOCUMENT"
+}
+export { ObjectType }
+export { ObjectType as ObjectType_alias_1 }
+
 declare const PGVECTOR_PROMPT = "When querying PG Vector, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n- $all: Match all values in array\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n- $elemMatch: Match array elements that meet all specified conditions\n  Example: { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 100 } } } }\n- $contains: Check if array contains value\n  Example: { \"tags\": { \"$contains\": \"premium\" } }\n\nLogical Operators:\n- $and: Logical AND\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n- $nor: Logical NOR\n  Example: { \"$nor\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nSpecial Operators:\n- $size: Array length check\n  Example: { \"tags\": { \"$size\": 2 } }\n- $regex: Pattern matching (PostgreSQL regex syntax)\n  Example: { \"name\": { \"$regex\": \"^iphone\" } }\n- $options: Regex options (used with $regex)\n  Example: { \"name\": { \"$regex\": \"iphone\", \"$options\": \"i\" } }\n\nRestrictions:\n- Direct RegExp patterns are supported\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- Array operations work on array fields only\n- Regex patterns must follow PostgreSQL syntax\n- Empty arrays in conditions are handled gracefully\n- Only logical operators ($and, $or, $not, $nor) can be used at the top level\n- All other operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n  Invalid: { \"$regex\": \"pattern\" }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- $not operator:\n  - Must be an object\n  - Cannot be empty\n  - Can be used at field level or top level\n  - Valid: { \"$not\": { \"field\": \"value\" } }\n  - Valid: { \"field\": { \"$not\": { \"$eq\": \"value\" } } }\n- Other logical operators ($and, $or, $nor):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n- $elemMatch requires an object with conditions\n  Valid: { \"array\": { \"$elemMatch\": { \"field\": \"value\" } } }\n  Invalid: { \"array\": { \"$elemMatch\": \"value\" } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"tags\": { \"$all\": [\"premium\", \"sale\"] } },\n    { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 50 }, \"inStock\": true } } },\n    { \"$or\": [\n      { \"name\": { \"$regex\": \"^iphone\", \"$options\": \"i\" } },\n      { \"description\": { \"$regex\": \".*apple.*\" } }\n    ]}\n  ]\n}";
 export { PGVECTOR_PROMPT }
 export { PGVECTOR_PROMPT as PGVECTOR_PROMPT_alias_1 }
@@ -426,6 +546,21 @@ declare const PINECONE_PROMPT = "When querying Pinecone, you can ONLY use the op
 export { PINECONE_PROMPT }
 export { PINECONE_PROMPT as PINECONE_PROMPT_alias_1 }
 
+declare class PromptTemplate<const TemplatesVar extends readonly string[] = string[]> extends BasePromptTemplate<TemplatesVar> {
+    #private;
+    constructor(options: PromptTemplateOptions<TemplatesVar>);
+    partialFormat(options: Partial<Record<TemplatesVar[number] | (string & {}), string>>): PromptTemplate<TemplatesVar>;
+    format(options?: Partial<Record<TemplatesVar[number] | (string & {}), string>>): string;
+    formatMessages(options?: Partial<Record<TemplatesVar[number] | (string & {}), string>>): ChatMessage[];
+    get template(): string;
+}
+export { PromptTemplate }
+export { PromptTemplate as PromptTemplate_alias_1 }
+
+export declare type PromptTemplateOptions<TemplatesVar extends readonly string[]> = BasePromptTemplateOptions<TemplatesVar> & {
+    template: string;
+};
+
 declare const QDRANT_PROMPT = "When querying Qdrant, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (implicit when using multiple conditions)\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nSpecial Operators:\n- $regex: Pattern matching\n  Example: { \"name\": { \"$regex\": \"iphone.*\" } }\n- $count: Array length/value count\n  Example: { \"tags\": { \"$count\": { \"$gt\": 2 } } }\n- $geo: Geographical filters (supports radius, box, polygon)\n  Example: {\n    \"location\": {\n      \"$geo\": {\n        \"type\": \"radius\",\n        \"center\": { \"lat\": 52.5, \"lon\": 13.4 },\n        \"radius\": 10000\n      }\n    }\n  }\n- $hasId: Match specific document IDs\n  Example: { \"$hasId\": [\"doc1\", \"doc2\"] }\n- $hasVector: Check vector existence\n  Example: { \"$hasVector\": \"\" }\n- $datetime: RFC 3339 datetime range\n  Example: {\n    \"created_at\": {\n      \"$datetime\": {\n        \"range\": {\n          \"gt\": \"2024-01-01T00:00:00Z\",\n          \"lt\": \"2024-12-31T23:59:59Z\"\n        }\n      }\n    }\n  }\n- $null: Check for null values\n  Example: { \"field\": { \"$null\": true } }\n- $empty: Check for empty values\n  Example: { \"array\": { \"$empty\": true } }\n- $nested: Nested object filters\n  Example: {\n    \"items[]\": {\n      \"$nested\": {\n        \"price\": { \"$gt\": 100 },\n        \"stock\": { \"$gt\": 0 }\n      }\n    }\n  }\n\nRestrictions:\n- Only logical operators ($and, $or, $not) and collection operators ($hasId, $hasVector) can be used at the top level\n- All other operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Valid: { \"$hasId\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Nested fields are supported using dot notation\n- Array fields with nested objects use [] suffix: \"items[]\"\n- Geo filtering requires specific format for radius, box, or polygon\n- Datetime values must be in RFC 3339 format\n- Empty arrays in conditions are handled as empty values\n- Null values are handled with $null operator\n- Empty values are handled with $empty operator\n- $regex uses standard regex syntax\n- $count can only be used with numeric comparison operators\n- $nested requires an object with conditions\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- $not operator:\n  - Must be an object\n  - Cannot be empty\n  - Can be used at field level or top level\n  - Valid: { \"$not\": { \"field\": \"value\" } }\n  - Valid: { \"field\": { \"$not\": { \"$eq\": \"value\" } } }\n- Other logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\"] } },\n    { \"price\": { \"$gt\": 100 } },\n    { \"location\": {\n      \"$geo\": {\n        \"type\": \"radius\",\n        \"center\": { \"lat\": 52.5, \"lon\": 13.4 },\n        \"radius\": 5000\n      }\n    }},\n    { \"items[]\": {\n      \"$nested\": {\n        \"price\": { \"$gt\": 50 },\n        \"stock\": { \"$gt\": 0 }\n      }\n    }},\n    { \"created_at\": {\n      \"$datetime\": {\n        \"range\": {\n          \"gt\": \"2024-01-01T00:00:00Z\"\n        }\n      }\n    }},\n    { \"$or\": [\n      { \"status\": { \"$ne\": \"discontinued\" } },\n      { \"clearance\": true }\n    ]}\n  ]\n}";
 export { QDRANT_PROMPT }
 export { QDRANT_PROMPT as QDRANT_PROMPT_alias_1 }
@@ -444,31 +579,17 @@ declare type QuestionAnswerExtractArgs = {
 export { QuestionAnswerExtractArgs }
 export { QuestionAnswerExtractArgs as QuestionAnswerExtractArgs_alias_1 }
 
+declare type QuestionExtractPrompt = PromptTemplate<['context', 'numQuestions']>;
+export { QuestionExtractPrompt }
+export { QuestionExtractPrompt as QuestionExtractPrompt_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.
@@ -611,6 +732,19 @@ export declare class RecursiveJsonTransformer {
     }): Document[];
 }
 
+declare interface RelatedNodeInfo<T extends Metadata = Metadata> {
+    nodeId: string;
+    nodeType?: ObjectType;
+    metadata: T;
+    hash?: string;
+}
+export { RelatedNodeInfo }
+export { RelatedNodeInfo as RelatedNodeInfo_alias_1 }
+
+declare type RelatedNodeType<T extends Metadata = Metadata> = RelatedNodeInfo<T> | RelatedNodeInfo<T>[];
+export { RelatedNodeType }
+export { RelatedNodeType as RelatedNodeType_alias_1 }
+
 declare function rerank(results: QueryResult[], query: string, model: MastraLanguageModel, options: RerankerFunctionOptions): Promise<RerankResult[]>;
 export { rerank }
 export { rerank as rerank_alias_1 }
@@ -660,9 +794,7 @@ 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 }
+export declare const STRIP_REGEX: RegExp;
 
 declare type SummaryExtractArgs = {
     llm?: MastraLanguageModel;
@@ -680,20 +812,8 @@ export { SummaryExtractArgs as SummaryExtractArgs_alias_1 }
  * @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;
@@ -715,6 +835,10 @@ declare class SummaryExtractor extends BaseExtractor {
 export { SummaryExtractor }
 export { SummaryExtractor as SummaryExtractor_alias_1 }
 
+declare type SummaryPrompt = PromptTemplate<['context']>;
+export { SummaryPrompt }
+export { SummaryPrompt as SummaryPrompt_alias_1 }
+
 /**
  * TODO: GraphRAG Enhancements
  *  - Add support for more edge types (sequential, hierarchical, citation, etc)
@@ -724,6 +848,42 @@ export { SummaryExtractor as SummaryExtractor_alias_1 }
  */
 declare type SupportedEdgeType = 'semantic';
 
+/**
+ * TextNode is the default node type for text.
+ */
+declare class TextNode<T extends Metadata = Metadata> extends BaseNode<T> {
+    text: string;
+    startCharIdx?: number;
+    endCharIdx?: number;
+    metadataSeparator: string;
+    constructor(init?: TextNodeParams<T>);
+    /**
+     * Generate a hash of the text node.
+     * The ID is not part of the hash as it can change independent of content.
+     * @returns
+     */
+    generateHash(): string;
+    get type(): ObjectType;
+    getContent(): string;
+    getMetadataStr(): string;
+    getNodeInfo(): {
+        start: number | undefined;
+        end: number | undefined;
+    };
+    getText(): string;
+}
+export { TextNode }
+export { TextNode as TextNode_alias_1 }
+
+declare type TextNodeParams<T extends Metadata = Metadata> = BaseNodeParams<T> & {
+    text?: string | undefined;
+    startCharIdx?: number | undefined;
+    endCharIdx?: number | undefined;
+    metadataSeparator?: string | undefined;
+};
+export { TextNodeParams }
+export { TextNodeParams as TextNodeParams_alias_1 }
+
 export declare abstract class TextTransformer implements Transformer {
     protected size: number;
     protected overlap: number;
@@ -743,44 +903,19 @@ export declare abstract class TextTransformer implements Transformer {
     protected mergeSplits(splits: string[], separator: string): string[];
 }
 
+declare type TitleCombinePrompt = PromptTemplate<['context']>;
+export { TitleCombinePrompt }
+export { TitleCombinePrompt as TitleCombinePrompt_alias_1 }
+
 /**
  * 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.
@@ -796,6 +931,10 @@ declare class TitleExtractor extends BaseExtractor {
 export { TitleExtractor }
 export { TitleExtractor as TitleExtractor_alias_1 }
 
+declare type TitleExtractorPrompt = PromptTemplate<['context']>;
+export { TitleExtractorPrompt }
+export { TitleExtractorPrompt as TitleExtractorPrompt_alias_1 }
+
 declare type TitleExtractorsArgs = {
     llm?: MastraLanguageModel;
     nodes?: number;