@wix/mcp 1.0.11 → 1.0.13

package/build/bin-standalone.js

@@ -15083,6 +15083,61 @@ async function fetchArticleContent(httpClient, articleUrl, mode) {
   return fetchArticleContentFromDigor(httpClient, articleUrl, mode);
 }
 
+// src/docs/get-to-know.ts
+var docURLs = [
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/get-to-know-wix-llm-instructions"
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-concepts"
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions"
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions-recipes"
+  }
+];
+var DESCRIPTION = `**Tool Name:** WixREADME
+**Description for LLM:**
+"**Mandatory First Action for Wix Tasks.** This tool, 'WixREADME', MUST be executed at the very beginning of any process involving Wix functionalities. It provides the indispensable foundational Wix ecosystem context, global setup details, and current best practices.
+
+**Operational Rule:** Your processing protocol for any Wix-related task dictates that 'WixREADME' is successfully invoked and its output comprehensively analyzed BEFORE any other Wix-specific tool (such as 'ReadFullDocsArticle' or 'SearchX..') is considered or used. This is a non-negotiable prerequisite.
+
+**Function:** Acts as the sole authoritative source for Wix global operational standards and session initialization. Its output is essential for the correct and safe execution of all subsequent Wix-related actions. All other Wix tools are designed to rely on the information it provides."
+
+**Next Steps:** After executing 'WixREADME', relevant information from the README may include links to other documents. You MUST use the 'ReadFullDocsArticle' tool to fetch the full content of these documents. This is a critical step to ensure you have all necessary information before proceeding with any other Wix tools.
+`;
+var WixREADME_DEPENDENT_DESCRIPTION = `**Dependency:** Must be used after 'WixREADME' has successfully run.`;
+async function addGetToKnowTools(server2) {
+  server2.tool("WixREADME", DESCRIPTION, async ({ httpClient }) => {
+    try {
+      const contents = await Promise.all(
+        docURLs.map(async ({ url }) => {
+          const content = await fetchArticleContent(httpClient, url, "article");
+          return content;
+        })
+      );
+      return {
+        content: contents.map((content) => ({
+          type: "text",
+          text: content
+        }))
+      };
+    } catch (error) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text",
+            text: `Error fetching the document: ${error.message}`
+          }
+        ]
+      };
+    }
+  });
+}
+
 // src/docs/docs.ts
 var VALID_DOCS_TOOLS = [
   "WDS",
@@ -15099,7 +15154,10 @@ var addDocsTools = (server2, allowedTools = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "BUSINESS_SOLUTIONS"
-]) => {
+], getToKnowWixEnabled = false) => {
+  if (getToKnowWixEnabled) {
+    addGetToKnowTools(server2);
+  }
   if (allowedTools.includes("WDS")) {
     server2.tool(
       "SearchWixWDSDocumentation",
@@ -15107,7 +15165,8 @@ var addDocsTools = (server2, allowedTools = [
         "Searches the Wix Design System Documentation for components and patterns.",
         "Use this tool when you need to understand or implement UI components and design patterns in a Wix project.",
         "Search for specific component names, patterns, or UI requirements.",
-        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
+        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value.",
+        getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
       ].join("\n"),
       {
         searchTerm: z.string().describe(
@@ -15161,7 +15220,8 @@ var addDocsTools = (server2, allowedTools = [
         "Searches the official Wix REST API documentation.",
         "Use this tool whenever you need to to interact with the Wix platform via HTTP requests.",
         "Specify the API endpoint, resource, or action you need information about (e.g., 'get site details endpoint', 'create data collection', 'update product API', 'REST authentication').",
-        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
+        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value.",
+        getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
       ].join("\n"),
       {
         searchTerm: z.string().describe(
@@ -15213,7 +15273,7 @@ var addDocsTools = (server2, allowedTools = [
       }
     );
   }
-  if (allowedTools.includes("BUSINESS_SOLUTIONS")) {
+  if (allowedTools.includes("BUSINESS_SOLUTIONS") && !getToKnowWixEnabled) {
     server2.tool(
       "WixBusinessFlowsDocumentation",
       [
@@ -15282,7 +15342,8 @@ var addDocsTools = (server2, allowedTools = [
         "Searches the official Wix javascript SDK documentation.",
         "Use this tool whenever you need to write or modify Wix related SDK code.",
         "Specify the SDK module, function, or feature you need information about (e.g., 'how to query all items from a data collection?', 'how to use wix-stores-backend', 'authentication methods in the SDK').",
-        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
+        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value.",
+        getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
       ].join("\n"),
       {
         searchTerm: z.string().describe(
@@ -15343,7 +15404,8 @@ var addDocsTools = (server2, allowedTools = [
         "Searches the official Build Apps documentation.",
         "Use this tool when you need to understand or implement Wix CLI applications related code.",
         "The search term should be a specific Wix CLI command or specific topic related to Wix CLI applications or its ecosystem (e.g. deployment, creating new extensions etc).",
-        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
+        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value.",
+        getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
       ].join("\n"),
       {
         searchTerm: z.string().describe(
@@ -15396,7 +15458,8 @@ var addDocsTools = (server2, allowedTools = [
         "Searches the official Wix Headless Documentation.",
         "Use this tool when you need to understand or implement Headless related code.",
         "The search term should be a specific Wix Headless topic or feature you need information about.",
-        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value."
+        "If you can't find what you need, try to rephrase your search term or use bigger maxResults value.",
+        getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
       ].join("\n"),
       {
         searchTerm: z.string().describe(
@@ -15446,7 +15509,8 @@ var addDocsTools = (server2, allowedTools = [
     "ReadFullDocsArticle",
     [
       "Fetches the full Wix docs article or method article.",
-      "Use this tool when you read a summary of a docs article or method article, you have the docs url and want to read the full article."
+      "Use this tool when you read a summary of a docs article or method article, you have the docs url and want to read the full article.",
+      getToKnowWixEnabled ? WixREADME_DEPENDENT_DESCRIPTION : ""
     ].join("\n"),
     {
       articleUrl: z.string().describe(
@@ -15539,41 +15603,6 @@ var addDocsTools = (server2, allowedTools = [
   );
 };
 
-// src/docs/get-to-know.ts
-var defaultDocUrl = "https://dev.wix.com/docs/picasso/wix-ai-docs/rules/get-to-know-wix-llm-instructions";
-var DESCRIPTION = `**Tool Name:** WixREADME
-**Description for LLM:**
-"**Mandatory First Action for Wix Tasks.** This tool, 'WixREADME', MUST be executed at the very beginning of any process involving Wix functionalities. It provides the indispensable foundational Wix ecosystem context, global setup details, and current best practices.
-
-**Operational Rule:** Your processing protocol for any Wix-related task dictates that 'WixREADME' is successfully invoked and its output comprehensively analyzed BEFORE any other Wix-specific tool (such as 'ReadFullDocsArticle' or 'SearchX..') is considered or used. This is a non-negotiable prerequisite.
-
-**Function:** Acts as the sole authoritative source for Wix global operational standards and session initialization. Its output is essential for the correct and safe execution of all subsequent Wix-related actions. All other Wix tools are designed to rely on the information it provides."`;
-async function addGetToKnowTools(server2, docUrl) {
-  server2.tool("WixREADME", DESCRIPTION, async ({ httpClient }) => {
-    try {
-      const doc = docUrl ? await fetchArticleContent(httpClient, docUrl, "raw") : await fetchArticleContent(httpClient, defaultDocUrl, "article");
-      return {
-        content: [
-          {
-            type: "text",
-            text: doc
-          }
-        ]
-      };
-    } catch (error) {
-      return {
-        isError: true,
-        content: [
-          {
-            type: "text",
-            text: `Error fetching the document: ${error.message}`
-          }
-        ]
-      };
-    }
-  });
-}
-
 // src/cli-tools/cli.ts
 import { z as z2 } from "zod";
 
@@ -15801,7 +15830,7 @@ var buildErrorMessage = ({
   ].filter((str) => !!str).join("\n");
 };
 var handleWixAPIResponse = async (response) => {
-  const requestId = response.headers.get("x-wix-request-id");
+  const requestId = response.headers.get?.("x-wix-request-id");
   if (!response.status.toString().startsWith("2")) {
     const errorMessage = buildErrorMessage({
       status: response.status,
@@ -16473,7 +16502,7 @@ var docsTools = activeTools.filter(
 );
 if (docsTools.length > 0) {
   logger.log("Adding docs tools:", docsTools);
-  addDocsTools(server, docsTools);
+  addDocsTools(server, docsTools, activeTools.includes("GET_TO_KNOW_WIX"));
 }
 var isWixOne = parsedArgs["cli"] === "wix-one";
 var cliTools = activeTools.filter(
@@ -16483,10 +16512,6 @@ if (cliTools.length > 0) {
   logger.log("Adding cli tools:", cliTools, "isWixOne:", isWixOne);
   addCliTools(server, cliTools, isWixOne);
 }
-if (activeTools.includes("GET_TO_KNOW_WIX")) {
-  const docUrl = parsedArgs["get-to-know-wix-url"];
-  await addGetToKnowTools(server, docUrl);
-}
 try {
   const portals = parsedArgs["portals"]?.split(",") || [];
   if (portals.length > 0) {