@mastra/rag 0.1.8-alpha.2 → 0.1.8-alpha.4

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/rag@0.1.8-alpha.2 build /home/runner/work/mastra/mastra/packages/rag
+> @mastra/rag@0.1.8-alpha.4 build /home/runner/work/mastra/mastra/packages/rag
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.3.6
 TSC Build start
-TSC ⚡️ Build success in 23720ms
+TSC ⚡️ Build success in 26963ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.7.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/rag/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.7.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/rag/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 36072ms
+DTS ⚡️ Build success in 24816ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 83.96 KB
-CJS ⚡️ Build success in 1659ms
-ESM dist/index.js 83.29 KB
-ESM ⚡️ Build success in 1661ms
+ESM dist/index.js 83.18 KB
+ESM ⚡️ Build success in 689ms
+CJS dist/index.cjs 83.86 KB
+CJS ⚡️ Build success in 686ms

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/rag
 
+## 0.1.8-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [d79aedf]
+  - @mastra/core@0.5.0-alpha.4
+
+## 0.1.8-alpha.3
+
+### Patch Changes
+
+- f2e8e5f: Updated descriptions and input schema for vector and graph rag tools
+- Updated dependencies [3d0e290]
+  - @mastra/core@0.5.0-alpha.3
+
 ## 0.1.8-alpha.2
 
 ### Patch Changes

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

@@ -123,22 +123,12 @@ export { createVectorQueryTool }
 export { createVectorQueryTool as createVectorQueryTool_alias_1 }
 export { createVectorQueryTool as createVectorQueryTool_alias_2 }
 
-declare const defaultFilter = "You MUST generate for each query:\n    filter: query filter (REQUIRED) (Default: {})\n        - Generate filter based on user's explicit query intent\n        - Must be valid JSON string\n\n    Notes: \n    - If user provides a valid filter, use the filter provided\n    - If user does not specify filter or provides an invalid filter, use default filter: {}\n";
-export { defaultFilter }
-export { defaultFilter as defaultFilter_alias_1 }
-export { defaultFilter as defaultFilter_alias_2 }
-
-declare const defaultGraphRagDescription: (vectorStoreName: string, indexName: string) => string;
+declare const defaultGraphRagDescription: () => string;
 export { defaultGraphRagDescription }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_1 }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_2 }
 
-declare const defaultTopK = "You MUST generate for each query:\n    topK: number of results to return (REQUIRED) (Default: 10)\n        - Generate topK based on exactly what user specifies\n        - must be a valid number\n\n    Notes: \n    - If user provides a valid topK, use the topK provided\n    - If user does not specify topK or provides an invalid topK, use default topK: 10\n";
-export { defaultTopK }
-export { defaultTopK as defaultTopK_alias_1 }
-export { defaultTopK as defaultTopK_alias_2 }
-
-declare const defaultVectorQueryDescription: (vectorStoreName: string, indexName: string) => string;
+declare const defaultVectorQueryDescription: () => string;
 export { defaultVectorQueryDescription }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_1 }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_2 }
@@ -152,6 +142,11 @@ declare type ExtractParams = {
 export { ExtractParams }
 export { ExtractParams as ExtractParams_alias_1 }
 
+declare const filterDescription = "JSON-formatted criteria to refine search results.\n- Uses provided filter if specified\n- Default: {} (no filtering)\n- Example: {\"category\": \"health\"}\n- Must be valid JSON format\n- Based on query intent\n- Multiple filters can be combined";
+export { filterDescription }
+export { filterDescription as filterDescription_alias_1 }
+export { filterDescription as filterDescription_alias_2 }
+
 export declare interface GraphChunk {
     text: string;
     metadata: Record<string, any>;
@@ -578,6 +573,11 @@ export declare class TokenTransformer extends TextTransformer {
     }): TokenTransformer;
 }
 
+declare const topKDescription = "Controls how many matching documents to return.\n- Uses provided value if specified\n- Default: 10 results\n- Higher values provide more context\n- Lower values focus on best matches\n- Must be a valid number\n- Based on query requirements";
+export { topKDescription }
+export { topKDescription as topKDescription_alias_1 }
+export { topKDescription as topKDescription_alias_2 }
+
 declare interface Transformer_2 {
     transformDocuments(documents: Document_2[]): Document_2[];
 }

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

@@ -123,22 +123,12 @@ export { createVectorQueryTool }
 export { createVectorQueryTool as createVectorQueryTool_alias_1 }
 export { createVectorQueryTool as createVectorQueryTool_alias_2 }
 
-declare const defaultFilter = "You MUST generate for each query:\n    filter: query filter (REQUIRED) (Default: {})\n        - Generate filter based on user's explicit query intent\n        - Must be valid JSON string\n\n    Notes: \n    - If user provides a valid filter, use the filter provided\n    - If user does not specify filter or provides an invalid filter, use default filter: {}\n";
-export { defaultFilter }
-export { defaultFilter as defaultFilter_alias_1 }
-export { defaultFilter as defaultFilter_alias_2 }
-
-declare const defaultGraphRagDescription: (vectorStoreName: string, indexName: string) => string;
+declare const defaultGraphRagDescription: () => string;
 export { defaultGraphRagDescription }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_1 }
 export { defaultGraphRagDescription as defaultGraphRagDescription_alias_2 }
 
-declare const defaultTopK = "You MUST generate for each query:\n    topK: number of results to return (REQUIRED) (Default: 10)\n        - Generate topK based on exactly what user specifies\n        - must be a valid number\n\n    Notes: \n    - If user provides a valid topK, use the topK provided\n    - If user does not specify topK or provides an invalid topK, use default topK: 10\n";
-export { defaultTopK }
-export { defaultTopK as defaultTopK_alias_1 }
-export { defaultTopK as defaultTopK_alias_2 }
-
-declare const defaultVectorQueryDescription: (vectorStoreName: string, indexName: string) => string;
+declare const defaultVectorQueryDescription: () => string;
 export { defaultVectorQueryDescription }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_1 }
 export { defaultVectorQueryDescription as defaultVectorQueryDescription_alias_2 }
@@ -152,6 +142,11 @@ declare type ExtractParams = {
 export { ExtractParams }
 export { ExtractParams as ExtractParams_alias_1 }
 
+declare const filterDescription = "JSON-formatted criteria to refine search results.\n- Uses provided filter if specified\n- Default: {} (no filtering)\n- Example: {\"category\": \"health\"}\n- Must be valid JSON format\n- Based on query intent\n- Multiple filters can be combined";
+export { filterDescription }
+export { filterDescription as filterDescription_alias_1 }
+export { filterDescription as filterDescription_alias_2 }
+
 export declare interface GraphChunk {
     text: string;
     metadata: Record<string, any>;
@@ -578,6 +573,11 @@ export declare class TokenTransformer extends TextTransformer {
     }): TokenTransformer;
 }
 
+declare const topKDescription = "Controls how many matching documents to return.\n- Uses provided value if specified\n- Default: 10 results\n- Higher values provide more context\n- Lower values focus on best matches\n- Must be a valid number\n- Based on query requirements";
+export { topKDescription }
+export { topKDescription as topKDescription_alias_1 }
+export { topKDescription as topKDescription_alias_2 }
+
 declare interface Transformer_2 {
     transformDocuments(documents: Document_2[]): Document_2[];
 }

package/dist/index.cjs

@@ -1613,34 +1613,22 @@ var vectorQuerySearch = async ({
 };
 
 // src/utils/default-settings.ts
-var defaultTopK = `You MUST generate for each query:
-    topK: number of results to return (REQUIRED) (Default: 10)
-        - Generate topK based on exactly what user specifies
-        - must be a valid number
-
-    Notes: 
-    - If user provides a valid topK, use the topK provided
-    - If user does not specify topK or provides an invalid topK, use default topK: 10
-`;
-var defaultFilter = `You MUST generate for each query:
-    filter: query filter (REQUIRED) (Default: {})
-        - Generate filter based on user's explicit query intent
-        - Must be valid JSON string
-
-    Notes: 
-    - If user provides a valid filter, use the filter provided
-    - If user does not specify filter or provides an invalid filter, use default filter: {}
-`;
-var defaultVectorQueryDescription = (vectorStoreName, indexName) => `Retrieves relevant information from ${vectorStoreName} using ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
-var defaultGraphRagDescription = (vectorStoreName, indexName) => `Fetches and reranks the most relevant chunks using GraphRAG from the ${vectorStoreName} vector store using the ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
+var defaultVectorQueryDescription = () => `Access the knowledge base to find information needed to answer user questions.`;
+var defaultGraphRagDescription = () => `Access and analyze relationships between information in the knowledge base to answer complex questions about connections and patterns.`;
+var topKDescription = `Controls how many matching documents to return.
+- Uses provided value if specified
+- Default: 10 results
+- Higher values provide more context
+- Lower values focus on best matches
+- Must be a valid number
+- Based on query requirements`;
+var filterDescription = `JSON-formatted criteria to refine search results.
+- Uses provided filter if specified
+- Default: {} (no filtering)
+- Example: {"category": "health"}
+- Must be valid JSON format
+- Based on query intent
+- Multiple filters can be combined`;
 
 // src/tools/graph-rag.ts
 var createGraphRAGTool = ({
@@ -1658,15 +1646,15 @@ var createGraphRAGTool = ({
   description
 }) => {
   const toolId = id || `GraphRAG ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultGraphRagDescription(vectorStoreName, indexName);
+  const toolDescription = description || defaultGraphRagDescription();
   const graphRag = new GraphRAG(graphOptions.dimension, graphOptions.threshold);
   let isInitialized = false;
   return tools.createTool({
     id: toolId,
     inputSchema: zod.z.object({
-      queryText: zod.z.string(),
-      topK: zod.z.number(),
-      filter: zod.z.string()
+      queryText: zod.z.string().describe("The text query to search for in the vector database"),
+      topK: zod.z.number().describe(topKDescription),
+      filter: zod.z.string().describe(filterDescription)
     }),
     outputSchema: zod.z.object({
       relevantContext: zod.z.any()
@@ -1735,19 +1723,23 @@ var createVectorQueryTool = ({
   description
 }) => {
   const toolId = id || `VectorQuery ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultVectorQueryDescription(vectorStoreName, indexName);
+  const toolDescription = description || defaultVectorQueryDescription();
   return tools.createTool({
     id: toolId,
     inputSchema: zod.z.object({
-      queryText: zod.z.string(),
-      topK: zod.z.number(),
-      filter: zod.z.string()
+      queryText: zod.z.string().describe("The text query to search for in the vector database"),
+      topK: zod.z.number().describe(topKDescription),
+      filter: zod.z.string().describe(filterDescription)
     }),
     outputSchema: zod.z.object({
       relevantContext: zod.z.any()
     }),
     description: toolDescription,
     execute: async ({ context: { queryText, topK, filter }, mastra }) => {
+      console.log({
+        topK,
+        filter
+      });
       const vectorStore = mastra?.vectors?.[vectorStoreName];
       if (vectorStore) {
         let queryFilter = {};
@@ -2523,8 +2515,8 @@ exports.VECTORIZE_PROMPT = VECTORIZE_PROMPT;
 exports.createDocumentChunkerTool = createDocumentChunkerTool;
 exports.createGraphRAGTool = createGraphRAGTool;
 exports.createVectorQueryTool = createVectorQueryTool;
-exports.defaultFilter = defaultFilter;
 exports.defaultGraphRagDescription = defaultGraphRagDescription;
-exports.defaultTopK = defaultTopK;
 exports.defaultVectorQueryDescription = defaultVectorQueryDescription;
+exports.filterDescription = filterDescription;
 exports.rerank = rerank;
+exports.topKDescription = topKDescription;

package/dist/index.d.cts

@@ -16,7 +16,7 @@ export { PINECONE_PROMPT } from './_tsup-dts-rollup.cjs';
 export { QDRANT_PROMPT } from './_tsup-dts-rollup.cjs';
 export { UPSTASH_PROMPT } from './_tsup-dts-rollup.cjs';
 export { VECTORIZE_PROMPT } from './_tsup-dts-rollup.cjs';
-export { defaultTopK } from './_tsup-dts-rollup.cjs';
-export { defaultFilter } from './_tsup-dts-rollup.cjs';
 export { defaultVectorQueryDescription } from './_tsup-dts-rollup.cjs';
 export { defaultGraphRagDescription } from './_tsup-dts-rollup.cjs';
+export { topKDescription } from './_tsup-dts-rollup.cjs';
+export { filterDescription } from './_tsup-dts-rollup.cjs';

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { PINECONE_PROMPT } from './_tsup-dts-rollup.js';
 export { QDRANT_PROMPT } from './_tsup-dts-rollup.js';
 export { UPSTASH_PROMPT } from './_tsup-dts-rollup.js';
 export { VECTORIZE_PROMPT } from './_tsup-dts-rollup.js';
-export { defaultTopK } from './_tsup-dts-rollup.js';
-export { defaultFilter } from './_tsup-dts-rollup.js';
 export { defaultVectorQueryDescription } from './_tsup-dts-rollup.js';
 export { defaultGraphRagDescription } from './_tsup-dts-rollup.js';
+export { topKDescription } from './_tsup-dts-rollup.js';
+export { filterDescription } from './_tsup-dts-rollup.js';

package/dist/index.js

@@ -1611,34 +1611,22 @@ var vectorQuerySearch = async ({
 };
 
 // src/utils/default-settings.ts
-var defaultTopK = `You MUST generate for each query:
-    topK: number of results to return (REQUIRED) (Default: 10)
-        - Generate topK based on exactly what user specifies
-        - must be a valid number
-
-    Notes: 
-    - If user provides a valid topK, use the topK provided
-    - If user does not specify topK or provides an invalid topK, use default topK: 10
-`;
-var defaultFilter = `You MUST generate for each query:
-    filter: query filter (REQUIRED) (Default: {})
-        - Generate filter based on user's explicit query intent
-        - Must be valid JSON string
-
-    Notes: 
-    - If user provides a valid filter, use the filter provided
-    - If user does not specify filter or provides an invalid filter, use default filter: {}
-`;
-var defaultVectorQueryDescription = (vectorStoreName, indexName) => `Retrieves relevant information from ${vectorStoreName} using ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
-var defaultGraphRagDescription = (vectorStoreName, indexName) => `Fetches and reranks the most relevant chunks using GraphRAG from the ${vectorStoreName} vector store using the ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
+var defaultVectorQueryDescription = () => `Access the knowledge base to find information needed to answer user questions.`;
+var defaultGraphRagDescription = () => `Access and analyze relationships between information in the knowledge base to answer complex questions about connections and patterns.`;
+var topKDescription = `Controls how many matching documents to return.
+- Uses provided value if specified
+- Default: 10 results
+- Higher values provide more context
+- Lower values focus on best matches
+- Must be a valid number
+- Based on query requirements`;
+var filterDescription = `JSON-formatted criteria to refine search results.
+- Uses provided filter if specified
+- Default: {} (no filtering)
+- Example: {"category": "health"}
+- Must be valid JSON format
+- Based on query intent
+- Multiple filters can be combined`;
 
 // src/tools/graph-rag.ts
 var createGraphRAGTool = ({
@@ -1656,15 +1644,15 @@ var createGraphRAGTool = ({
   description
 }) => {
   const toolId = id || `GraphRAG ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultGraphRagDescription(vectorStoreName, indexName);
+  const toolDescription = description || defaultGraphRagDescription();
   const graphRag = new GraphRAG(graphOptions.dimension, graphOptions.threshold);
   let isInitialized = false;
   return createTool({
     id: toolId,
     inputSchema: z.object({
-      queryText: z.string(),
-      topK: z.number(),
-      filter: z.string()
+      queryText: z.string().describe("The text query to search for in the vector database"),
+      topK: z.number().describe(topKDescription),
+      filter: z.string().describe(filterDescription)
     }),
     outputSchema: z.object({
       relevantContext: z.any()
@@ -1733,19 +1721,23 @@ var createVectorQueryTool = ({
   description
 }) => {
   const toolId = id || `VectorQuery ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultVectorQueryDescription(vectorStoreName, indexName);
+  const toolDescription = description || defaultVectorQueryDescription();
   return createTool({
     id: toolId,
     inputSchema: z.object({
-      queryText: z.string(),
-      topK: z.number(),
-      filter: z.string()
+      queryText: z.string().describe("The text query to search for in the vector database"),
+      topK: z.number().describe(topKDescription),
+      filter: z.string().describe(filterDescription)
     }),
     outputSchema: z.object({
       relevantContext: z.any()
     }),
     description: toolDescription,
     execute: async ({ context: { queryText, topK, filter }, mastra }) => {
+      console.log({
+        topK,
+        filter
+      });
       const vectorStore = mastra?.vectors?.[vectorStoreName];
       if (vectorStore) {
         let queryFilter = {};
@@ -2508,4 +2500,4 @@ Example Complex Query:
   "inStock": true
 }`;
 
-export { ASTRA_PROMPT, CHROMA_PROMPT, GraphRAG, LIBSQL_PROMPT, MDocument, PGVECTOR_PROMPT, PINECONE_PROMPT, QDRANT_PROMPT, UPSTASH_PROMPT, VECTORIZE_PROMPT, createDocumentChunkerTool, createGraphRAGTool, createVectorQueryTool, defaultFilter, defaultGraphRagDescription, defaultTopK, defaultVectorQueryDescription, rerank };
+export { ASTRA_PROMPT, CHROMA_PROMPT, GraphRAG, LIBSQL_PROMPT, MDocument, PGVECTOR_PROMPT, PINECONE_PROMPT, QDRANT_PROMPT, UPSTASH_PROMPT, VECTORIZE_PROMPT, createDocumentChunkerTool, createGraphRAGTool, createVectorQueryTool, defaultGraphRagDescription, defaultVectorQueryDescription, filterDescription, rerank, topKDescription };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/rag",
-  "version": "0.1.8-alpha.2",
+  "version": "0.1.8-alpha.4",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "node-html-better-parser": "^1.4.7",
     "pathe": "^2.0.2",
     "zod": "^3.24.1",
-    "@mastra/core": "^0.5.0-alpha.2"
+    "@mastra/core": "^0.5.0-alpha.4"
   },
   "peerDependencies": {
     "ai": "^4.0.0"

package/src/tools/graph-rag.ts

@@ -3,7 +3,7 @@ import type { EmbeddingModel } from 'ai';
 import { z } from 'zod';
 
 import { GraphRAG } from '../graph-rag';
-import { vectorQuerySearch, defaultGraphRagDescription } from '../utils';
+import { vectorQuerySearch, defaultGraphRagDescription, filterDescription, topKDescription } from '../utils';
 
 export const createGraphRAGTool = ({
   vectorStoreName,
@@ -33,8 +33,7 @@ export const createGraphRAGTool = ({
   description?: string;
 }): ReturnType<typeof createTool> => {
   const toolId = id || `GraphRAG ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultGraphRagDescription(vectorStoreName, indexName);
-
+  const toolDescription = description || defaultGraphRagDescription();
   // Initialize GraphRAG
   const graphRag = new GraphRAG(graphOptions.dimension, graphOptions.threshold);
   let isInitialized = false;
@@ -42,9 +41,9 @@ export const createGraphRAGTool = ({
   return createTool({
     id: toolId,
     inputSchema: z.object({
-      queryText: z.string(),
-      topK: z.number(),
-      filter: z.string(),
+      queryText: z.string().describe('The text query to search for in the vector database'),
+      topK: z.number().describe(topKDescription),
+      filter: z.string().describe(filterDescription),
     }),
     outputSchema: z.object({
       relevantContext: z.any(),

package/src/tools/vector-query.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
 
 import { rerank } from '../rerank';
 import type { RerankConfig } from '../rerank';
-import { vectorQuerySearch, defaultVectorQueryDescription } from '../utils';
+import { vectorQuerySearch, defaultVectorQueryDescription, filterDescription, topKDescription } from '../utils';
 
 export const createVectorQueryTool = ({
   vectorStoreName,
@@ -24,20 +24,23 @@ export const createVectorQueryTool = ({
   description?: string;
 }): ReturnType<typeof createTool> => {
   const toolId = id || `VectorQuery ${vectorStoreName} ${indexName} Tool`;
-  const toolDescription = description || defaultVectorQueryDescription(vectorStoreName, indexName);
-
+  const toolDescription = description || defaultVectorQueryDescription();
   return createTool({
     id: toolId,
     inputSchema: z.object({
-      queryText: z.string(),
-      topK: z.number(),
-      filter: z.string(),
+      queryText: z.string().describe('The text query to search for in the vector database'),
+      topK: z.number().describe(topKDescription),
+      filter: z.string().describe(filterDescription),
     }),
     outputSchema: z.object({
       relevantContext: z.any(),
     }),
     description: toolDescription,
     execute: async ({ context: { queryText, topK, filter }, mastra }) => {
+      console.log({
+        topK,
+        filter,
+      });
       const vectorStore = mastra?.vectors?.[vectorStoreName];
 
       // Get relevant chunks from the vector database

package/src/utils/default-settings.ts

@@ -1,33 +1,21 @@
-export const defaultTopK = `You MUST generate for each query:
-    topK: number of results to return (REQUIRED) (Default: 10)
-        - Generate topK based on exactly what user specifies
-        - must be a valid number
+export const defaultVectorQueryDescription = () =>
+  `Access the knowledge base to find information needed to answer user questions.`;
 
-    Notes: 
-    - If user provides a valid topK, use the topK provided
-    - If user does not specify topK or provides an invalid topK, use default topK: 10
-`;
+export const defaultGraphRagDescription = () =>
+  `Access and analyze relationships between information in the knowledge base to answer complex questions about connections and patterns.`;
 
-export const defaultFilter = `You MUST generate for each query:
-    filter: query filter (REQUIRED) (Default: {})
-        - Generate filter based on user's explicit query intent
-        - Must be valid JSON string
+export const topKDescription = `Controls how many matching documents to return.
+- Uses provided value if specified
+- Default: 10 results
+- Higher values provide more context
+- Lower values focus on best matches
+- Must be a valid number
+- Based on query requirements`;
 
-    Notes: 
-    - If user provides a valid filter, use the filter provided
-    - If user does not specify filter or provides an invalid filter, use default filter: {}
-`;
-
-export const defaultVectorQueryDescription = (vectorStoreName: string, indexName: string) =>
-  `Retrieves relevant information from ${vectorStoreName} using ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
-
-export const defaultGraphRagDescription = (vectorStoreName: string, indexName: string) =>
-  `Fetches and reranks the most relevant chunks using GraphRAG from the ${vectorStoreName} vector store using the ${indexName} index.
-
-    ${defaultTopK}
-    ${defaultFilter}
-    `;
+export const filterDescription = `JSON-formatted criteria to refine search results.
+- Uses provided filter if specified
+- Default: {} (no filtering)
+- Example: {"category": "health"}
+- Must be valid JSON format
+- Based on query intent
+- Multiple filters can be combined`;