@wix/mcp 1.0.12 → 1.0.14

package/build/bin-standalone.js

@@ -15065,7 +15065,7 @@ var runSemanticSearchAndFormat = async ({
 import { captureException } from "@sentry/node";
 
 // src/docs/fetch-article.ts
-async function fetchArticleContentFromDigor(httpClient, articleUrl, mode) {
+async function fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripHeader = false) {
   const url = new URL(`https://dev.wix.com/digor/api/get-article-content`);
   url.searchParams.set("articleUrl", articleUrl);
   const schema = mode === "methodSchema" ? "true" : "false";
@@ -15073,14 +15073,133 @@ async function fetchArticleContentFromDigor(httpClient, articleUrl, mode) {
   logger.log(`Fetching resource from docs ${url.toString()}`);
   const { data } = await httpClient.get(url.toString());
   logger.log(`Fetched resource from docs: ${data.articleContent}`);
+  const headerDivider = "## Article Content:";
+  if (stripHeader) {
+    const headerIndex = data.articleContent.indexOf(headerDivider);
+    if (headerIndex !== -1) {
+      return data.articleContent.substring(
+        headerIndex + headerDivider.length
+      );
+    }
+  }
   return data.articleContent;
 }
-async function fetchArticleContent(httpClient, articleUrl, mode) {
+async function fetchArticleContent(httpClient, articleUrl, mode, stripHeader = false) {
   if (mode === "raw") {
     const { data: doc } = await httpClient.get(articleUrl);
     return doc;
   }
-  return fetchArticleContentFromDigor(httpClient, articleUrl, mode);
+  return fetchArticleContentFromDigor(
+    httpClient,
+    articleUrl,
+    mode,
+    stripHeader
+  );
+}
+
+// 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",
+    action: "include"
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-concepts",
+    action: "include"
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions",
+    action: "index",
+    title: "Wix Business Solutions",
+    description: `This document provides an overview of the all business solutions available in Wix.
+  
+Use this document under the following scenarios:
+1. The user asks general questions about Wix business solutions.
+2. The user asks about a specific business solution, and you want to provide a high-level overview of it.
+3. The user looks for a specific business solution, and you want to provide a list of all available solutions.
+
+Please note that this is a large document. Only use it for the scenarios mentioned above.`
+  },
+  {
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions-recipes",
+    action: "include"
+  }
+];
+var DESCRIPTION = `# Tool: WixREADME
+
+**Directive:** \`WixREADME\` is the **MANDATORY FIRST STEP** for all Wix-related tasks. Its output (including relevant linked documents) provides foundational context for all other Wix tools. Adherence to this protocol is **NON-NEGOTIABLE**.
+
+**Operational Protocol (Strictly Sequential):**
+
+1.  **Execute \`WixREADME\`:**
+    * **Action:** Invoke \`WixREADME\`.
+    * **Constraint:** MUST complete successfully. NO other Wix tool before this.
+
+2.  **Process \`WixREADME\` Output (Link Identification & Relevance Assessment):**
+    * **A. Identify Candidate Links:** Scan \`WixREADME\` output. Extract *only* URLs found within \`<urls>{urls}</urls>\` tags. Ignore all other URLs.
+    * **B. Assess Relevance:** For EACH candidate URL from (A), assess its relevance to the **current user's specific prompt/task**.
+    * **Outcome:** A list of *relevant* document URLs. If no links are found in \`<urls>\` tags or none are deemed relevant, note this and proceed to Step 4.
+
+3.  **Fetch Relevant Documents (via \`ReadFullDocsArticle\`):**
+    * **Condition:** ONLY if Step 2B identified one or more *relevant* URLs.
+    * **Action:** For EACH *relevant* URL, invoke \`ReadFullDocsArticle\` to fetch its full content.
+    * **Constraint:** All *relevant* documents MUST be fetched before Step 4.
+
+4.  **Proceed with Other Wix Tools:**
+    * **Condition:** ONLY after completing Steps 1, 2, and 3 (if Step 3 was applicable).
+    * **Action:** Use other Wix tools as needed, utilizing the full context from \`WixREADME\` and fetched relevant documents.
+
+**Summary of Critical Rules:**
+* \`WixREADME\` is **ALWAYS FIRST**.
+* Analyze \`WixREADME\` output: Extract links *only* from \`<urls>{urls}</urls>\` tags.
+* Assess relevance of *each* extracted link against the user's current task.
+* Fetch **ONLY RELEVANT** linked documents using \`ReadFullDocsArticle\` before any other Wix tool.
+* **FAILURE TO FOLLOW THIS EXACT SEQUENCE WILL LEAD TO ERRORS.** Strict adherence is mandatory.`;
+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, action, description, title }) => {
+          if (action === "index") {
+            return {
+              type: "text",
+              text: `## ${title}
+
+<urls>
+${url}
+</urls>
+
+${description}`
+            };
+          }
+          const content = await fetchArticleContent(
+            httpClient,
+            url,
+            "article",
+            true
+          );
+          return {
+            type: "text",
+            text: content
+          };
+        })
+      );
+      return {
+        content: contents
+      };
+    } catch (error) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text",
+            text: `Error fetching the document: ${error.message}`
+          }
+        ]
+      };
+    }
+  });
 }
 
 // src/docs/docs.ts
@@ -15099,7 +15218,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 +15229,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 +15284,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 +15337,7 @@ var addDocsTools = (server2, allowedTools = [
       }
     );
   }
-  if (allowedTools.includes("BUSINESS_SOLUTIONS")) {
+  if (allowedTools.includes("BUSINESS_SOLUTIONS") && !getToKnowWixEnabled) {
     server2.tool(
       "WixBusinessFlowsDocumentation",
       [
@@ -15282,7 +15406,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 +15468,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 +15522,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 +15573,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 +15667,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";
 
@@ -16473,7 +16566,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 +16576,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) {