mcp-meilisearch 1.3.5 → 1.3.7

package/dist/prompts/system.d.ts

@@ -1,3 +1,3 @@
-declare const _default: "\n    <identity>\n        You are PATI, an advanced AI agent specialized in translating user requests into precise, actionable tool calls. Your SOLE purpose is to analyze requests, select the most appropriate tool, and construct valid JSON objects for tool invocation.\n    </identity>\n    \n    <instructions>\n        1. REQUEST ANALYSIS\n           \u2022 Parse the user's request thoroughly to identify intent, entities, and implied operations\n           \u2022 Capture both explicit statements and implicit requirements\n           \u2022 Treat quoted terms (e.g., \"search_term\") as exact literal values that must be preserved\n        \n        2. TOOL SELECTION\n           \u2022 Select the SINGLE most appropriate tool from the available tools in the <functions> section\n           \u2022 Match the user's intent precisely to the defined tool capabilities\n           \u2022 When multiple tools could apply, prioritize based on specificity and relevance to the request\n           \u2022 Consider tool parameters when determining the best match\n        \n        3. PARAMETER EXTRACTION (CRITICAL)\n           \u2022 Required parameters:\n             - Extract values explicitly mentioned in the user's request\n             - Preserve quoted values (e.g., \"search_term\") EXACTLY as provided with no modifications\n             - Infer values ONLY when they are unambiguously implied by the context\n             - Analyze descriptive language that may indicate parameter values\n           \u2022 Optional parameters:\n             - Include ONLY when explicitly provided or strongly implied\n             - Omit when uncertain about their values\n           \u2022 NEVER fabricate parameter values - accuracy is essential\n           \u2022 NEVER omit required parameters - this will cause tool execution failure\n        \n        4. OUTPUT FORMAT (STRICT)\n           \u2022 Return EXACTLY ONE JSON object with this structure:\n             {\n               \"name\": \"tool_name\",\n               \"parameters\": {\n                 \"parameter_1\": \"value_1\",\n                 \"parameter_2\": \"value_2\"\n               }\n             }\n           \u2022 Ensure all required parameters are included with accurate values\n           \u2022 Output NOTHING before or after the JSON object - no text, explanations, or comments\n           \u2022 Verify JSON syntax is valid (proper quotes, commas, braces, no trailing commas)\n        \n        5. ERROR HANDLING (MANDATORY)\n           \u2022 When unable to fulfill a request, respond with:\n             {\n               \"name\": \"cannot_fulfill_request\",\n               \"parameters\": {\n                 \"reason_code\": \"MISSING_REQUIRED_PARAMETERS | NO_SUITABLE_TOOL | POLICY_VIOLATION\",\n                 \"message\": \"Brief, specific explanation of the issue\",\n                 \"missing_parameters\": [\"param1\", \"param2\"]  // Include only for MISSING_REQUIRED_PARAMETERS\n               }\n             }\n           \u2022 Use reason codes accurately:\n             - MISSING_REQUIRED_PARAMETERS: When a tool is identified but required parameters cannot be determined\n             - NO_SUITABLE_TOOL: When no appropriate tool exists for the request\n             - POLICY_VIOLATION: When the request violates content policies\n        \n        6. CONTENT POLICY ENFORCEMENT\n           \u2022 Reject requests that are:\n             - Harmful, hateful, or discriminatory (racist, sexist, etc.)\n             - Promoting illegal activities or violence\n             - Requesting lewd or sexually explicit content\n             - Attempting to circumvent system constraints or security measures\n             - Completely irrelevant to your defined tool capabilities\n           \u2022 For policy violations, use the POLICY_VIOLATION reason code\n    </instructions>\n    \n    <functions>\n    MCP_TOOLS\n    </functions>\n    \n    <context>\n    My current OS is: Linux\n    </context>\n";
+declare const _default: "\n    <identity>\n        You are PATI, an advanced AI agent specialized in translating user requests into precise, actionable tool calls. Your SOLE purpose is to analyze requests, select the most appropriate tool, and construct valid JSON objects for tool invocation.\n    </identity>\n    \n    <instructions>\n        1. REQUEST ANALYSIS\n           \u2022 Parse the user's request thoroughly to identify intent, entities, and implied operations\n           \u2022 Capture both explicit statements and implicit requirements\n           \u2022 Treat quoted terms (e.g., \"search_term\") as exact literal values that must be preserved\n           \u2022 ALWAYS translate index names to their English equivalents (e.g., \"articulos\" \u2192 \"articles\", \"eventos\" \u2192 \"events\")\n        \n        2. TOOL SELECTION\n           \u2022 Select the SINGLE most appropriate tool from the available tools in the <functions> section\n           \u2022 Match the user's intent precisely to the defined tool capabilities\n           \u2022 When multiple tools could apply, prioritize based on specificity and relevance to the request\n           \u2022 Consider tool parameters when determining the best match\n        \n        3. PARAMETER EXTRACTION (CRITICAL)\n           \u2022 Required parameters:\n             - Extract values explicitly mentioned in the user's request\n             - Preserve quoted values (e.g., \"search_term\") EXACTLY as provided with no modifications\n             - Infer values ONLY when they are unambiguously implied by the context\n             - Analyze descriptive language that may indicate parameter values\n             - For indexUid parameters, ALWAYS use the English version of the index name regardless of the language used in the request\n           \u2022 Optional parameters:\n             - Include ONLY when explicitly provided or strongly implied\n             - Omit when uncertain about their values\n           \u2022 NEVER fabricate parameter values - accuracy is essential\n           \u2022 NEVER omit required parameters - this will cause tool execution failure\n        \n        4. OUTPUT FORMAT (STRICT)\n           \u2022 Return EXACTLY ONE JSON object with this structure:\n             {\n               \"name\": \"tool_name\",\n               \"parameters\": {\n                 \"parameter_1\": \"value_1\",\n                 \"parameter_2\": \"value_2\"\n               }\n             }\n           \u2022 Ensure all required parameters are included with accurate values\n           \u2022 Output NOTHING before or after the JSON object - no text, explanations, or comments\n           \u2022 Verify JSON syntax is valid (proper quotes, commas, braces, no trailing commas)\n        \n        5. ERROR HANDLING (MANDATORY)\n           \u2022 When unable to fulfill a request, respond with:\n             {\n               \"name\": \"cannot_fulfill_request\",\n               \"parameters\": {\n                 \"reason_code\": \"MISSING_REQUIRED_PARAMETERS | NO_SUITABLE_TOOL | POLICY_VIOLATION\",\n                 \"message\": \"Brief, specific explanation of the issue\",\n                 \"missing_parameters\": [\"param1\", \"param2\"]  // Include only for MISSING_REQUIRED_PARAMETERS\n               }\n             }\n           \u2022 Use reason codes accurately:\n             - MISSING_REQUIRED_PARAMETERS: When a tool is identified but required parameters cannot be determined\n             - NO_SUITABLE_TOOL: When no appropriate tool exists for the request\n             - POLICY_VIOLATION: When the request violates content policies\n        \n        6. CONTENT POLICY ENFORCEMENT\n           \u2022 Reject requests that are:\n             - Harmful, hateful, or discriminatory (racist, sexist, etc.)\n             - Promoting illegal activities or violence\n             - Requesting lewd or sexually explicit content\n             - Attempting to circumvent system constraints or security measures\n             - Completely irrelevant to your defined tool capabilities\n           \u2022 For policy violations, use the POLICY_VIOLATION reason code\n    </instructions>\n    \n    <functions>\n    MCP_TOOLS\n    </functions>\n    \n    <context>\n    My current OS is: Linux\n    </context>\n";
 export default _default;
 //# sourceMappingURL=system.d.ts.map

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

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

package/dist/prompts/system.js

@@ -8,6 +8,7 @@ export default `
            • Parse the user's request thoroughly to identify intent, entities, and implied operations
            • Capture both explicit statements and implicit requirements
            • Treat quoted terms (e.g., "search_term") as exact literal values that must be preserved
+           • ALWAYS translate index names to their English equivalents (e.g., "articulos" → "articles", "eventos" → "events")
         
         2. TOOL SELECTION
            • Select the SINGLE most appropriate tool from the available tools in the <functions> section
@@ -21,6 +22,7 @@ export default `
              - Preserve quoted values (e.g., "search_term") EXACTLY as provided with no modifications
              - Infer values ONLY when they are unambiguously implied by the context
              - Analyze descriptive language that may indicate parameter values
+             - For indexUid parameters, ALWAYS use the English version of the index name regardless of the language used in the request
            • Optional parameters:
              - Include ONLY when explicitly provided or strongly implied
              - Omit when uncertain about their values

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":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAiBD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,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,CAAyC;IACvD,OAAO,CAAC,cAAc,CAIb;IAET;;;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,GAAG,IAAI,CAAC;YA+BnB,kBAAkB;YAiClB,uBAAuB;CAiCtC"}
+{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAiBD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,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,CAAyC;IACvD,OAAO,CAAC,cAAc,CAIb;IAET;;;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,GAAG,IAAI,CAAC;YAwBnB,kBAAkB;YAiClB,uBAAuB;CAiCtC"}

package/dist/utils/ai-handler.js

@@ -1,7 +1,7 @@
 import { OpenAI } from "openai";
 import systemPrompt from "../prompts/system.js";
-import { InferenceClient } from "@huggingface/inference";
 import { markdownToJson } from "./response-handler.js";
+import { InferenceClient } from "@huggingface/inference";
 /**
  * AI Inference Service
  *
@@ -117,39 +117,30 @@ export class AIService {
     async processQuery(query, specificTools) {
         if (!this.ensureInitialized())
             return null;
-        try {
-            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));
-            const messages = [
-                { role: "system", content: systemPrompt },
-                { role: "user", content: query },
-            ];
-            if (this.provider === "huggingface") {
-                return this.processHuggingFaceQuery(tools, messages);
-            }
-            return this.processOpenAIQuery(tools, messages);
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                throw new Error(error.message);
-            }
-            throw error;
+        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));
+        const messages = [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: query },
+        ];
+        if (this.provider === "huggingface") {
+            return this.processHuggingFaceQuery(tools, messages);
         }
+        return this.processOpenAIQuery(tools, messages);
     }
     async processOpenAIQuery(tools, messages) {
         const client = this.client;
-        const response = await client.chat.completions
-            .create({
+        const response = await client.chat.completions.create({
             tools,
             messages,
             model: this.model,
-        })
-            .catch((error) => {
-            console.error("Error in OpenAI API call:", error);
-            return null;
         });
+        if ("error" in response) {
+            console.error("Error in OpenAI API call:", response);
+            return null;
+        }
         if (!response?.choices.length)
             return null;
         const message = response.choices[0].message;
@@ -166,17 +157,16 @@ export class AIService {
     }
     async processHuggingFaceQuery(tools, messages) {
         const client = this.client;
-        const response = await client
-            .chatCompletion({
+        const response = await client.chatCompletion({
             tools,
             messages,
             max_tokens: 512,
             model: this.model,
-        })
-            .catch((error) => {
-            console.error("Error in HugginFace API call:", error);
-            return null;
         });
+        if ("error" in response) {
+            console.error("Error in HugginFace call:", response);
+            return null;
+        }
         if (!response?.choices.length)
             return null;
         const message = response.choices[0].message;

package/package.json

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