@wix/mcp 1.0.13 → 1.0.15

package/build/bin-standalone.js

@@ -15064,65 +15064,134 @@ var runSemanticSearchAndFormat = async ({
 // src/docs/docs.ts
 import { captureException } from "@sentry/node";
 
+// src/constants.ts
+var RAW_DOCS_API_URL = "https://dev.wix.com/rawdocs/api";
+var GET_ARTICLE_CONTENT_URL = `${RAW_DOCS_API_URL}/get-article-content`;
+var PORTAL_INDEX_URL = `${RAW_DOCS_API_URL}/portal-index`;
+
 // src/docs/fetch-article.ts
-async function fetchArticleContentFromDigor(httpClient, articleUrl, mode) {
-  const url = new URL(`https://dev.wix.com/digor/api/get-article-content`);
+async function fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripHeader = false) {
+  const url = new URL(GET_ARTICLE_CONTENT_URL);
   url.searchParams.set("articleUrl", articleUrl);
   const schema = mode === "methodSchema" ? "true" : "false";
   url.searchParams.set("schema", schema);
   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"
+    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"
+    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"
+    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"
+    url: "https://dev.wix.com/docs/picasso/wix-ai-docs/index/wix-business-solutions-recipes",
+    action: "include"
   }
 ];
-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.
+var DESCRIPTION = `# Tool: WixREADME
 
-**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.
+**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**.
 
-**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."
+**Operational Protocol (Strictly Sequential):**
 
-**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.`;
+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 }) => {
-          const content = await fetchArticleContent(httpClient, url, "article");
-          return content;
+        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.map((content) => ({
-          type: "text",
-          text: content
-        }))
+        content: contents
       };
     } catch (error) {
       return {
@@ -16386,9 +16455,7 @@ var WixMcpServer = class extends McpServer {
 
 // src/resources/docs.ts
 var getPortalIndex = async (portalName) => {
-  const response = await fetch(
-    `https://dev.wix.com/digor/api/portal-index?portalName=${portalName}`
-  );
+  const response = await fetch(`${PORTAL_INDEX_URL}?portalName=${portalName}`);
   const data = await response.json();
   return data;
 };
@@ -16407,7 +16474,7 @@ var addPortalResources = async (server2, portalName) => {
       logger.log(`fetching resource ${uri2}`);
       const docsURL = uri2.toString().replace("wix-docs://", "https://dev.wix.com/docs/");
       const response = await fetch(
-        `https://dev.wix.com/digor/api/get-article-content?articleUrl=${encodeURIComponent(docsURL)}`
+        `${GET_ARTICLE_CONTENT_URL}?articleUrl=${encodeURIComponent(docsURL)}`
       );
       const data = await response.json();
       return {