mcp-meilisearch 1.4.11 → 1.4.13

package/README.md

@@ -13,7 +13,7 @@ A Model Context Protocol (MCP) server implementation that provides a bridge betw
 - **Multiple Transport Options**: Supports both STDIO and StreamableHTTP transports.
 - **Meilisearch API Support**: Full access to Meilisearch functionalities.
 - **Web Client Demo**: Updated interface showcasing search capabilities and features.
-- **AI Inference**: Leverages LLMs from providers such as OpenAIo HuggingFace to intelligently determine and utilize the most suitable tool for user queries.
+- **AI Inference**: Leverages LLMs from providers such as OpenAI, HuggingFace, OpenRouter, and Ollama to intelligently determine and utilize the most suitable tool for user queries.
 
 ## Getting Started
 
@@ -100,10 +100,13 @@ const result = await client.callTool("global-search", {
 
 // Use AI inference to choose the most appropriate tool
 
-const result = await client.callToolWithAI("Find articles about cucumber");
+const result = await client.callToolWithAI("Find articles about cucumber", {
+  provideSummary: true,
+});
 console.log(`Tool used: ${result.toolUsed}`);
 console.log(`Reasoning: ${result.reasoning}`);
 console.log(`Results: ${JSON.stringify(result.data)}`);
+console.log(`Summary: ${result.summary}`);
 ```
 
 #### AI Inference Client Methods
@@ -117,7 +120,9 @@ Processes a user query through AI to determine and execute the most appropriate
 - `query`: String - The user's query or request to be processed
 - `options`: Object (Optional) - Configuration options
   - `specificTools`: String[] (Optional) - Restricts tool selection to this list of tool names
-  - `justReasoning`: Boolean (Optional) - When set to `true`, returns only the AI's reasoning without executing the selected tool
+  - `justReasoning`: Boolean (Optional) - When set to `true`, returns only the AI's reasoning without executing the
+    selected tool
+  - `provideSummary`: Boolean (Optional) - When set to `true`, generates a concise summary of the search results along with the regular response
 
 ### Starting the Server
 

package/dist/client.d.ts

@@ -1,3 +1,16 @@
+interface AIToolClientOptions {
+    specificTools?: string[];
+    justReasoning?: boolean;
+    provideSummary?: boolean;
+}
+interface AIToolClientResponse {
+    data?: any;
+    summary?: any;
+    error?: string;
+    success: boolean;
+    toolUsed?: string;
+    reasoning?: string;
+}
 export declare class MCPClient {
     /**
      * Indicates whether the client is connected to the MCP server
@@ -60,19 +73,11 @@ export declare class MCPClient {
      * @param options Options for the AI processing
      * @param options.specificTools Optional array of specific tool names to consider
      * @param options.justReasoning If true, only returns the reasoning without calling the tool
+     * @param options.provideSummary If true, beyond the raw JSON, it will also provide a summary of the result
      * @throws Error if AI inference fails
      * @returns The result of calling the selected tool, or an error
      */
-    callToolWithAI(query: string, options?: {
-        specificTools?: string[];
-        justReasoning?: boolean;
-    }): Promise<{
-        success: boolean;
-        data?: any;
-        error?: string;
-        toolUsed?: string;
-        reasoning?: string;
-    }>;
+    callToolWithAI(query: string, options?: AIToolClientOptions): Promise<AIToolClientResponse>;
     private setUpTransport;
     /**
      * Closes the connection to the server and resets the connection state
@@ -80,4 +85,5 @@ export declare class MCPClient {
      */
     cleanup(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;IACpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAS;IAE7B;;;OAGG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,EAAE,CAAM;IAET,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,oBAAoB,CAEZ;gBAEJ,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI;IAKzE;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhE;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBzC,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAW1B;;;;;;;OAOG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA2CF;;;;;;;;OAQG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAClE,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IA6CF,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAS;IAE7B;;;OAGG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,EAAE,CAAM;IAET,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,oBAAoB,CAEZ;gBAEJ,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI;IAKzE;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhE;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBzC,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAW1B;;;;;;;OAOG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA2CF;;;;;;;;;OASG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,oBAAoB,CAAC;IA2DhC,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/client.js

@@ -147,13 +147,14 @@ export class MCPClient {
      * @param options Options for the AI processing
      * @param options.specificTools Optional array of specific tool names to consider
      * @param options.justReasoning If true, only returns the reasoning without calling the tool
+     * @param options.provideSummary If true, beyond the raw JSON, it will also provide a summary of the result
      * @throws Error if AI inference fails
      * @returns The result of calling the selected tool, or an error
      */
     async callToolWithAI(query, options = {}) {
-        const { specificTools, justReasoning } = options;
+        const { specificTools, justReasoning, provideSummary } = options;
         try {
-            const result = await this.callTool("process-ai-query", {
+            const result = await this.callTool("process-ai-tool", {
                 query,
                 specificTools,
             });
@@ -174,11 +175,22 @@ export class MCPClient {
                 };
             }
             const toolResult = await this.callTool(toolName, parameters);
-            return {
+            if (!toolResult.success)
+                return toolResult;
+            const response = {
                 ...toolResult,
                 reasoning,
                 toolUsed: toolName,
             };
+            if (provideSummary) {
+                const summary = await this.callTool("process-ai-text", {
+                    query: JSON.stringify(toolResult.data),
+                });
+                if (!summary.success)
+                    console.error(summary);
+                response["summary"] = summary.data;
+            }
+            return response;
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);

package/dist/prompts/developer/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    tool: string;
+    text: string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/developer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/developer/index.ts"],"names":[],"mappings":";;;;AAGA,wBAA8B"}

package/dist/prompts/developer/index.js

@@ -0,0 +1,3 @@
+import tool from "./tool.js";
+import text from "./text.js";
+export default { tool, text };

package/dist/prompts/developer/text.d.ts

@@ -0,0 +1,3 @@
+declare const _default: "\n<identity>\n  You are PATI, an AI agent.\n</identity>\n\n<instructions>\n  Your primary function is to generate a summary. This summary MUST adhere to the following rules:\n\n 1.  **Language Matching:** The language of your summary MUST strictly match the predominant language of the user's provided input.\n      - If the user's input is in Spanish, your summary MUST be in Spanish.\n      - If the user's input is in English, your summary MUST be in English.\n      - And so on for any other language.\n\n  2.  **Content to Summarize:** Your summary MUST be a description of the key information, findings, or results presented in the user's input.\n      - Do NOT summarize the user's instructions to you or the act of providing input.\n      - Focus ONLY on the core data or text provided by the user for summarization.\n\n  3.  **Handling Structured Data (e.g., JSON):**\n      - If the user provides structured data (like a JSON object), identify the key textual fields that contain the main information (e.g., 'title', 'abstract', 'summary', 'content_to_search', 'description', 'text', etc.).\n      - Synthesize the information from these relevant fields into a coherent, natural language summary.\n      - If the JSON contains multiple results (e.g., in a 'hits' or 'results' array), list each result separately and provide a summary for each.\n      - Include a general summary of all results at the beginning or end when multiple results are present.\n      - Do NOT describe the structure of the data (e.g., \"The JSON has a 'hits' array...\"). Summarize the *meaning* conveyed by the content within those fields.\n\n  4.  **Output Format:**\n      - Your response MUST be formatted as valid HTML.\n      - Use appropriate HTML elements for structure (headings, paragraphs, lists, etc.).\n      - No greetings, no apologies, no explanations, no meta-comments. Just the summary in HTML format.\n      - Do not include HTML, HEAD, or BODY tags - focus only on the content elements.\n</instructions>\n";
+export default _default;
+//# sourceMappingURL=text.d.ts.map

package/dist/prompts/developer/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/prompts/developer/text.ts"],"names":[],"mappings":";AAAA,wBA8BE"}

package/dist/prompts/developer/text.js

@@ -0,0 +1,31 @@
+export default `
+<identity>
+  You are PATI, an AI agent.
+</identity>
+
+<instructions>
+  Your primary function is to generate a summary. This summary MUST adhere to the following rules:
+
+ 1.  **Language Matching:** The language of your summary MUST strictly match the predominant language of the user's provided input.
+      - If the user's input is in Spanish, your summary MUST be in Spanish.
+      - If the user's input is in English, your summary MUST be in English.
+      - And so on for any other language.
+
+  2.  **Content to Summarize:** Your summary MUST be a description of the key information, findings, or results presented in the user's input.
+      - Do NOT summarize the user's instructions to you or the act of providing input.
+      - Focus ONLY on the core data or text provided by the user for summarization.
+
+  3.  **Handling Structured Data (e.g., JSON):**
+      - If the user provides structured data (like a JSON object), identify the key textual fields that contain the main information (e.g., 'title', 'abstract', 'summary', 'content_to_search', 'description', 'text', etc.).
+      - Synthesize the information from these relevant fields into a coherent, natural language summary.
+      - If the JSON contains multiple results (e.g., in a 'hits' or 'results' array), list each result separately and provide a summary for each.
+      - Include a general summary of all results at the beginning or end when multiple results are present.
+      - Do NOT describe the structure of the data (e.g., "The JSON has a 'hits' array..."). Summarize the *meaning* conveyed by the content within those fields.
+
+  4.  **Output Format:**
+      - Your response MUST be formatted as valid HTML.
+      - Use appropriate HTML elements for structure (headings, paragraphs, lists, etc.).
+      - No greetings, no apologies, no explanations, no meta-comments. Just the summary in HTML format.
+      - Do not include HTML, HEAD, or BODY tags - focus only on the content elements.
+</instructions>
+`;

package/dist/prompts/{system.d.ts → developer/tool.d.ts}

@@ -1,3 +1,3 @@
 declare const _default: "\n  <identity>\n    You are PATI, an AI agent that translates user requests into JSON tool calls.\n    Your output MUST be ONLY the JSON tool call or error object. NO TEXT BEFORE OR AFTER.\n  </identity>\n\n  <instructions>\n    1. Select the most appropriate tool from the <functions> section based on the user's request.\n    \n    2. Extract parameters directly from the user's request:\n      \u2022 Extract ONLY what is explicitly stated or clearly implied.\n      \u2022 Preserve quoted values EXACTLY as provided by the user.\n      \u2022 For indexUid parameters, ALWAYS translate to English equivalent (e.g., \"articulos\" \u2192 \"articles\").\n    \n    3. Format:\n      \u2022 RESPONSE MUST BE JUST A VALID JSON OBJECT with this structure:\n        {\n          \"name\": \"tool_name_from_schema\",\n          \"parameters\": {\n            \"parameter1\": \"value1\",\n            \"parameter2\": \"value2\"\n          }\n        }\n      \n      \u2022 For errors, use:\n        {\n          \"name\": \"cannot_fulfill_request\",\n          \"parameters\": {\n            \"reason_code\": \"CODE\",\n            \"message\": \"Brief explanation\",\n            \"missing_parameters\": [\"param1\", \"param2\"]  // Only for MISSING_REQUIRED_PARAMETERS\n          }\n        }\n  </instructions>\n\n  <functions>\n    MCP_TOOLS\n  </functions>\n";
 export default _default;
-//# sourceMappingURL=system.d.ts.map
+//# sourceMappingURL=tool.d.ts.map

package/dist/prompts/developer/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/prompts/developer/tool.ts"],"names":[],"mappings":";AAAA,wBAsCE"}

package/dist/tools/core/ai-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/core/ai-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBpE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SA6DhD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/core/ai-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6EpE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SAsIhD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/tools/core/ai-tools.js

@@ -3,12 +3,57 @@ import { zodToJsonSchema } from "zod-to-json-schema";
 import { AIService } from "../../utils/ai-handler.js";
 import { createErrorResponse } from "../../utils/error-handler.js";
 import { convertNullToUndefined } from "../../utils/response-handler.js";
+const setAvailableTools = (aiService, server) => {
+    const registeredTools = Object.entries(server._registeredTools);
+    const availableTools = registeredTools
+        .filter(([_, { annotations }]) => annotations?.category !== "core")
+        .map(([name, { description, inputSchema }]) => {
+        const { definitions } = zodToJsonSchema(inputSchema, "parameters");
+        return {
+            name,
+            description,
+            parameters: definitions?.parameters ?? {},
+        };
+    });
+    aiService.setAvailableTools(availableTools);
+};
+const splitTextIntoChunks = (text, chunkSize) => {
+    if (text.length <= chunkSize) {
+        return [text];
+    }
+    let currentIndex = 0;
+    const chunks = [];
+    while (currentIndex < text.length) {
+        let endIndex = Math.min(currentIndex + chunkSize, text.length);
+        if (endIndex < text.length) {
+            const sentenceEndMatch = text
+                .substring(currentIndex, endIndex)
+                .match(/[.!?]\s+/g);
+            if (sentenceEndMatch?.length) {
+                const lastMatch = sentenceEndMatch[sentenceEndMatch.length - 1];
+                const lastMatchIndex = text.lastIndexOf(lastMatch, currentIndex + chunkSize);
+                if (lastMatchIndex > currentIndex) {
+                    endIndex = lastMatchIndex + lastMatch.length;
+                }
+            }
+            else {
+                const lastSpace = text.lastIndexOf(" ", endIndex);
+                if (lastSpace > currentIndex) {
+                    endIndex = lastSpace + 1;
+                }
+            }
+        }
+        chunks.push(text.substring(currentIndex, endIndex));
+        currentIndex = endIndex;
+    }
+    return chunks;
+};
 /**
  * Register AI tools with the MCP server
  * @param server - The MCP server instance
  */
 export const registerAITools = (server) => {
-    server.tool("process-ai-query", "Process a natural language query using AI to determine which tool to use", {
+    server.tool("process-ai-tool", "Process a natural language query using AI to determine which tool to use", {
         query: z.string().describe("The natural language query to process"),
         specificTools: z
             .array(z.string())
@@ -17,40 +62,93 @@ export const registerAITools = (server) => {
     }, { category: "core" }, async ({ query, specificTools }) => {
         try {
             const aiService = AIService.getInstance();
-            const registeredTools = Object.entries(server._registeredTools);
-            const availableTools = registeredTools
-                .filter(([_, { annotations }]) => annotations?.category !== "core")
-                .map(([name, { description, inputSchema }]) => {
-                const { definitions } = zodToJsonSchema(inputSchema, "parameters");
-                return {
-                    name,
-                    description,
-                    parameters: definitions?.parameters ?? {},
-                };
+            setAvailableTools(aiService, server);
+            const response = await aiService.setupAIProcess(query, {
+                specificTools,
+                processType: "tool",
             });
-            aiService.setAvailableTools(availableTools);
-            const response = await aiService.processQuery(query, specificTools);
             if (response.error)
                 return createErrorResponse(response.error);
+            const { toolName, parameters: rawParameters } = response;
+            const parameters = convertNullToUndefined(rawParameters);
+            const result = {
+                toolName,
+                parameters,
+                reasoning: JSON.stringify({ name: toolName, parameters }),
+            };
             return {
                 isError: false,
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            toolName: response.toolName,
-                            parameters: convertNullToUndefined(response.parameters),
-                            get reasoning() {
-                                return { name: this.toolName, parameters: this.parameters };
-                            },
-                        }, null, 2),
-                    },
-                ],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             return createErrorResponse(error);
         }
     });
+    server.tool("process-ai-text", "Process a summary text using AI to describe the data result from a tool", {
+        query: z.string().describe("The natural language query to process"),
+        chunkSize: z
+            .number()
+            .positive()
+            .default(50000)
+            .describe("Optional size of chunks to split the query into (characters)"),
+    }, { category: "core" }, async ({ query, chunkSize }) => {
+        try {
+            const aiService = AIService.getInstance();
+            if (query.length <= chunkSize) {
+                const response = await aiService.setupAIProcess(query, {
+                    processType: "text",
+                });
+                return response.error
+                    ? createErrorResponse(response.error)
+                    : {
+                        isError: false,
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(response.summary, null, 2),
+                            },
+                        ],
+                    };
+            }
+            const chunks = splitTextIntoChunks(query, chunkSize);
+            const chunkPromises = chunks.map((chunk) => aiService.setupAIProcess(chunk, { processType: "text" }));
+            const chunkResponses = await Promise.all(chunkPromises);
+            const errorResponse = chunkResponses.find((response) => response.error);
+            if (errorResponse) {
+                return createErrorResponse(errorResponse.error);
+            }
+            const summaries = chunkResponses
+                .map((response) => response.summary)
+                .filter(Boolean);
+            if (!summaries.length) {
+                return createErrorResponse("Failed to process query chunks");
+            }
+            if (summaries.length === 1) {
+                return {
+                    isError: false,
+                    content: [
+                        { type: "text", text: JSON.stringify(summaries[0], null, 2) },
+                    ],
+                };
+            }
+            const combinedText = summaries.join(" ");
+            const finalResponse = await aiService.setupAIProcess(`Synthesize the following text into a coherent summary: ${combinedText}`, { processType: "text" });
+            return finalResponse.error
+                ? createErrorResponse(finalResponse.error)
+                : {
+                    isError: false,
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(finalResponse.summary || combinedText, null, 2),
+                        },
+                    ],
+                };
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
 };
 export default registerAITools;

package/dist/utils/ai-handler.d.ts

@@ -4,11 +4,20 @@ interface AITool {
     description: string;
     parameters: Record<string, unknown>;
 }
+interface AIProcessSetupOptions {
+    specificTools?: string[];
+    processType: "tool" | "text";
+}
 interface AIToolResponse {
-    error?: unknown;
     toolName?: string;
     parameters?: Record<string, unknown>;
 }
+interface AITextResponse {
+    summary?: string;
+}
+interface AIProcessResponse extends AIToolResponse, AITextResponse {
+    error?: unknown;
+}
 /**
  * AI Inference Service
  *
@@ -21,7 +30,6 @@ export declare class AIService {
     private static instance;
     private static serverInitialized;
     private provider;
-    private readonly systemPrompt;
     private client;
     /**
      * Private constructor to prevent direct instantiation
@@ -59,15 +67,11 @@ export declare class AIService {
      * @returns Array of tool names mentioned in the query, or empty array if none found
      */
     private extractToolNames;
-    /**
-     * Process a user query and determine which tool to use
-     * @param query User query
-     * @param specificTools Optional array of specific tool names to consider
-     * @returns Object containing the selected tool name and parameters
-     */
-    processQuery(query: string, specificTools?: string[]): Promise<AIToolResponse>;
-    private processOpenAIQuery;
-    private processHuggingFaceQuery;
+    setupAIProcess(query: string, options: AIProcessSetupOptions): Promise<AIProcessResponse>;
+    private processOpenAITool;
+    private processOpenAIText;
+    private processHuggingFaceText;
+    private processHuggingFaceTool;
 }
 export {};
 //# sourceMappingURL=ai-handler.d.ts.map

package/dist/utils/ai-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAmBD,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IA4BP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,CAAC;YA4BZ,kBAAkB;YA6DlB,uBAAuB;CAwDtC"}
+{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,UAAU,qBAAqB;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAkBD,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAkB,SAAQ,cAAc,EAAE,cAAc;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IA4BP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAalB,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;YAwCf,iBAAiB;YA+DjB,iBAAiB;YA+BjB,sBAAsB;YAiCtB,sBAAsB;CA8DrC"}

package/dist/utils/ai-handler.js

@@ -1,5 +1,5 @@
 import { OpenAI } from "openai";
-import systemPrompt from "../prompts/system.js";
+import developerPrompts from "../prompts/developer/index.js";
 import { markdownToJson } from "./response-handler.js";
 import { InferenceClient } from "@huggingface/inference";
 import { OLLAMA_API, OPEN_ROUTER_API } from "../types/enums.js";
@@ -15,7 +15,6 @@ export class AIService {
     static instance = null;
     static serverInitialized = false;
     provider = "openai";
-    systemPrompt = systemPrompt;
     client = null;
     /**
      * Private constructor to prevent direct instantiation
@@ -87,7 +86,6 @@ export class AIService {
         return tools.map((tool) => ({
             type: "function",
             function: {
-                strict: true,
                 name: tool.name,
                 parameters: tool.parameters,
                 description: tool.description,
@@ -109,47 +107,57 @@ export class AIService {
         }
         return mentionedTools;
     }
-    /**
-     * Process a user query and determine which tool to use
-     * @param query User query
-     * @param specificTools Optional array of specific tool names to consider
-     * @returns Object containing the selected tool name and parameters
-     */
-    async processQuery(query, specificTools) {
+    async setupAIProcess(query, options) {
         if (!this.ensureInitialized()) {
             return {
                 error: "AI service not initialized. Please provide an API key.",
             };
         }
+        const toolsSubstringIdentifier = "MCP_TOOLS";
+        const { processType, specificTools } = options;
+        let developerPrompt = developerPrompts[processType];
         const mentionedTools = this.extractToolNames(query);
         const toolsToUse = specificTools || (mentionedTools.length ? mentionedTools : undefined);
         const tools = this.getToolDefinitions(toolsToUse);
-        const systemPrompt = this.systemPrompt.replace("MCP_TOOLS", JSON.stringify(tools, null, 2));
+        if (developerPrompt.includes(toolsSubstringIdentifier)) {
+            developerPrompt = developerPrompt.replace(toolsSubstringIdentifier, JSON.stringify(tools, null, 2));
+        }
         const messages = [
-            { role: "system", content: systemPrompt },
+            { role: "developer", content: developerPrompt },
             { role: "user", content: query },
         ];
-        if (this.provider === "huggingface") {
-            return await this.processHuggingFaceQuery(tools, messages);
+        if (processType === "text") {
+            return this.provider === "huggingface"
+                ? await this.processHuggingFaceText(messages)
+                : await this.processOpenAIText(messages);
+        }
+        else {
+            return this.provider === "huggingface"
+                ? await this.processHuggingFaceTool(tools, messages)
+                : await this.processOpenAITool(tools, messages);
         }
-        return await this.processOpenAIQuery(tools, messages);
     }
-    async processOpenAIQuery(tools, messages, withoutFC = false) {
+    async processOpenAITool(tools, messages) {
         try {
             const client = this.client;
             const response = await client.chat.completions.create({
+                tools,
                 messages,
                 model: this.model,
-                ...(!withoutFC && { tools, tool_choice: "required" }),
+                tool_choice: "required",
             });
             if (!response.choices?.length) {
-                return { error: "No choices returned from OpenAI" };
+                return {
+                    error: "No choices returned from OpenAI; processType: 'tool'",
+                };
             }
             const message = response.choices[0].message;
             if (message.tool_calls?.length) {
                 const toolCall = message.tool_calls[0]?.function;
                 if (!toolCall) {
-                    return { error: "Invalid tool from OpenAI response" };
+                    return {
+                        error: "Invalid tool from OpenAI response; processType: 'tool'",
+                    };
                 }
                 return {
                     toolName: toolCall.name,
@@ -160,7 +168,7 @@ export class AIService {
                 const toolCall = markdownToJson(message.content);
                 if (!toolCall) {
                     return {
-                        error: `Invalid tool call format in content: ${message.content}`,
+                        error: "Invalid tool call format in content; processType: 'tool'",
                     };
                 }
                 return {
@@ -168,33 +176,84 @@ export class AIService {
                     parameters: toolCall.parameters,
                 };
             }
-            return { error: "No tool call or content in OpenAI response" };
+            return {
+                error: "No tool call or content in OpenAI response; processType: 'tool'.",
+            };
+        }
+        catch (error) {
+            console.error(error);
+            return { error };
+        }
+    }
+    async processOpenAIText(messages) {
+        try {
+            const client = this.client;
+            const response = await client.chat.completions.create({
+                messages,
+                model: this.model,
+            });
+            if (!response.choices?.length) {
+                return {
+                    error: "No response returned from OpenAI; processType: 'text'.",
+                };
+            }
+            const message = response.choices[0].message;
+            if (message.content) {
+                return { summary: message.content };
+            }
+            return { error: "No content in OpenAI response; processType: 'text'." };
         }
         catch (error) {
             console.error(error);
-            if (!withoutFC) {
-                console.info("Retrying without function calling...");
-                return this.processOpenAIQuery(tools, messages, true);
+            return { error };
+        }
+    }
+    async processHuggingFaceText(messages) {
+        try {
+            const client = this.client;
+            const response = await client.chatCompletion({
+                messages,
+                model: this.model,
+            });
+            if (!response.choices?.length) {
+                return {
+                    error: "No response returned from OpenAI; processType: 'text'.",
+                };
+            }
+            const message = response.choices[0].message;
+            if (message.content) {
+                return { summary: message.content };
             }
+            return {
+                error: "No content in Hugging Face response; processType: 'text'.",
+            };
+        }
+        catch (error) {
+            console.error(error);
             return { error };
         }
     }
-    async processHuggingFaceQuery(tools, messages, withoutFC = false) {
+    async processHuggingFaceTool(tools, messages) {
         try {
             const client = this.client;
             const response = await client.chatCompletion({
+                tools,
                 messages,
                 model: this.model,
-                ...(!withoutFC && { tools, tool_choice: "required" }),
+                tool_choice: "required",
             });
             if (!response.choices?.length) {
-                return { error: "No choices in Hugging Face response" };
+                return {
+                    error: "No choices in Hugging Face response; processType: 'tool'",
+                };
             }
             const message = response.choices[0].message;
             if (message.tool_calls?.length) {
                 const toolCall = message.tool_calls[0]?.function;
                 if (!toolCall) {
-                    return { error: "Invalid tool from Hugging Face response" };
+                    return {
+                        error: "Invalid tool from Hugging Face response; processType: 'tool'",
+                    };
                 }
                 return {
                     toolName: toolCall.name,
@@ -204,20 +263,20 @@ export class AIService {
             if (message.content) {
                 const toolCall = markdownToJson(message.content);
                 if (!toolCall)
-                    return { error: "Invalid tool call format in content" };
+                    return {
+                        error: "Invalid tool call format in content; processType: 'tool'",
+                    };
                 return {
                     toolName: toolCall.name,
                     parameters: toolCall.parameters,
                 };
             }
-            return { error: "No tool call or content in Hugging Face response" };
+            return {
+                error: "No tool call or content in Hugging Face response; processType: 'tool'",
+            };
         }
         catch (error) {
             console.error(error);
-            if (!withoutFC) {
-                console.info("Retrying without function calling...");
-                return this.processHuggingFaceQuery(tools, messages, true);
-            }
             return { error };
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meilisearch",
-  "version": "1.4.11",
+  "version": "1.4.13",
   "description": "Model Context Protocol (MCP) implementation for Meilisearch",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/prompts/system.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/prompts/system.ts"],"names":[],"mappings":";AAAA,wBAsCE"}