@wix/mcp 1.0.25 → 1.0.26

package/build/bin-standalone.js

@@ -10309,23 +10309,32 @@ var runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = f
   const url = new URL(
     `https://www.wixapis.com/mcp-docs-search/v1/search?maxResults=${maxResults}&rerank=${rerank}`
   );
+  const kbNames = [];
   if (toolName === "SDK") {
-    url.searchParams.append("kbName", "SDK_SCHEMAS_KB_ID");
-    url.searchParams.append("kbName", "SDK_DOCS_KB_ID");
+    kbNames.push(
+      "API_REFERENCE_SDK_KB_ID",
+      "FRONTEND_SDK_AND_EXTENSIONS_KB_ID",
+      "REST_DOCS_KB_ID"
+    );
   } else if (toolName === "REST" || toolName === "BUSINESS_SOLUTIONS") {
     if (toolName === "REST") {
-      url.searchParams.append("kbName", "REST_METHODS_KB_ID");
+      kbNames.push("REST_METHODS_KB_ID");
     }
-    url.searchParams.append("kbName", "REST_DOCS_KB_ID");
+    kbNames.push("REST_DOCS_KB_ID");
   } else if (toolName === "WDS") {
-    url.searchParams.append("kbName", "WDS_DOCS_KB_ID");
+    kbNames.push("WDS_DOCS_KB_ID");
   } else if (toolName === "BUILD_APPS") {
-    url.searchParams.append("kbName", "BUILD_APPS_KB_ID");
+    kbNames.push("BUILD_APPS_KB_ID");
   } else if (toolName === "WIX_HEADLESS") {
-    url.searchParams.append("kbName", "HEADLESS_KB_ID");
+    kbNames.push("HEADLESS_KB_ID");
   } else if (toolName === "VELO") {
-    url.searchParams.append("kbName", "VELO_DOCS_KB_ID");
-    url.searchParams.append("kbName", "VELO_METHODS_KB_ID");
+    kbNames.push("VELO_DOCS_KB_ID", "VELO_METHODS_KB_ID");
+  }
+  logger.log(
+    `[SemanticSearch] Tool: ${toolName}, KBs: [${kbNames.join(", ")}], Query: "${toolParams.searchTerm}"`
+  );
+  for (const kbName of kbNames) {
+    url.searchParams.append("kbName", kbName);
   }
   for (const [key, value] of Object.entries(toolParams)) {
     url.searchParams.append(key, value);
@@ -10517,6 +10526,39 @@ ${preview}${truncated}`);
   return content;
 }
 
+// src/docs/normalize-menu-content.ts
+var SCHEMA_HINT = "use ReadFullDocsMethodSchema to get the method full schema";
+var ARTICLE_HINT = "use ReadFullDocsArticle to see method code examples";
+var MENU_HINT = "use BrowseWixRESTDocsMenu to browse this category";
+function safeDecode(encoded) {
+  try {
+    return decodeURIComponent(encoded);
+  } catch {
+    return encoded;
+  }
+}
+function normalizeMenuContent(content) {
+  try {
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-article-content\?articleUrl=([^&)]+)[^)]*schema=true[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${SCHEMA_HINT})](${safeDecode(encoded)})`
+    );
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-article-content\?articleUrl=([^&)]+)[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${ARTICLE_HINT})](${safeDecode(encoded)})`
+    );
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-menu-content\?url=([^&)]+)[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${MENU_HINT})](${safeDecode(encoded)})`
+    );
+  } catch (error) {
+    logger.error(
+      `[BrowseWixRESTDocsMenu] Failed to normalize menu content: ${error}`
+    );
+  }
+  return content;
+}
+
 // ../../node_modules/dedent/dist/dedent.mjs
 function ownKeys(object, enumerableOnly) {
   var keys = Object.keys(object);
@@ -11401,7 +11443,8 @@ var addDocsTools = (server2, allowedTools = [
                 type: "text",
                 text: [
                   result,
-                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method."
+                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method.",
+                  "IMPORTANT: When sharing dev.wix.com/docs/rest or dev.wix.com/docs/api-reference links with the user, add ?apiView=SDK suffix to each link (or &apiView=SDK if the URL already has query params). for other prefix (dev.wix.com/docs/sdk) - no need to add the suffix."
                 ].join("\n---\n")
               }
             ]
@@ -11729,7 +11772,7 @@ var addDocsTools = (server2, allowedTools = [
             content: [
               {
                 type: "text",
-                text: content
+                text: normalizeMenuContent(content)
               }
             ]
           };