@wix/mcp 1.0.84 → 1.0.86

package/build/esm/toolkit.js

@@ -13226,6 +13226,22 @@ function renderApps(apps, knownApps) {
   }
   return lines.join("\n");
 }
+function sanitizeCustomAppName(raw) {
+  return raw.replace(/[\x00-\x1f\x7f]/g, " ").replace(/[`*_[\]|<>]/g, "").replace(/\s+/g, " ").trim().slice(0, 60);
+}
+function renderCustomAppsWithSkillsTools(apps) {
+  const relevant = apps.filter((a) => a.appId && (a.hasSkills || a.hasTools)).sort(
+    (a, b) => (a.appName ?? a.appId ?? "").localeCompare(b.appName ?? b.appId ?? "")
+  );
+  if (!relevant.length) return "";
+  const lines = [];
+  for (const app of relevant) {
+    const sanitizedName = app.appName ? sanitizeCustomAppName(app.appName) : "";
+    const name = sanitizedName || app.appId;
+    lines.push(`- \`${name}\` (ID: \`${app.appId}\`)`);
+  }
+  return lines.join("\n");
+}
 function renderProperties(props) {
   const sections = [];
   const regionalFormat = [];
@@ -13288,6 +13304,15 @@ function renderSite(site, index, knownApps) {
     lines.push("");
     lines.push(appsContent);
   }
+  const customAppsWithSkillsToolsContent = renderCustomAppsWithSkillsTools(
+    site.customApps ?? []
+  );
+  if (customAppsWithSkillsToolsContent) {
+    lines.push("");
+    lines.push("### Custom Apps with skills and tools");
+    lines.push("");
+    lines.push(customAppsWithSkillsToolsContent);
+  }
   lines.push("");
   lines.push("---");
   lines.push("");
@@ -14079,7 +14104,9 @@ function getErrorMessage(error) {
 }
 function shouldTryMenuFallbackForDocsRead(error, articleUrl) {
   const message = getErrorMessage(error);
-  if (!message.includes("404") || !articleUrl.includes("/api-reference/")) {
+  const { pathname } = new URL(articleUrl);
+  const isMenuFallbackUrl = articleUrl.includes("/api-reference/") || pathname.startsWith("/docs/velo");
+  if (!message.includes("404") || !isMenuFallbackUrl) {
     return false;
   }
   return !["This resource is deprecated", "No schema found"].some(
@@ -14732,7 +14759,7 @@ var addDocsTools = (server, allowedTools = [
                   content: [
                     {
                       type: "text",
-                      text: `Note: "${articleUrl}" is a documentation category, not an article. Showing its menu contents below. For category URLs, use BrowseWixRESTDocsMenu directly next time.
+                      text: `Note: "${articleUrl}" is not an article. Showing the closest documentation menu below; read the article you need from its links. For category URLs, use BrowseWixRESTDocsMenu directly next time.
 
 ${text}`
                     }
@@ -14824,7 +14851,7 @@ ${text}`
                   content: [
                     {
                       type: "text",
-                      text: `Note: "${articleUrl}" is a documentation category, not an article. Showing its menu contents below. For category URLs, use BrowseWixRESTDocsMenu directly next time.
+                      text: `Note: "${articleUrl}" is not an article. Showing the closest documentation menu below; read the article you need from its links. For category URLs, use BrowseWixRESTDocsMenu directly next time.
 
 ${text}`
                     }
@@ -16447,11 +16474,13 @@ function validateExecuteCode(code) {
 }
 
 // src/code-mode/index.ts
+var defaultCodeModeFetch = (url, init) => fetch(url, init);
 var SEARCH_TOOL_NAME = "SearchWixAPISpec";
 var EXECUTE_TOOL_NAME = "ExecuteWixAPI";
 function addSearchCodeModeTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     disableTools = [],
     toolDescriptions,
@@ -16466,12 +16495,14 @@ function addSearchCodeModeTool(server, options) {
     codeModeBaseUrl,
     description,
     maxResponseSize,
-    authStrategy
+    authStrategy,
+    codeModeFetch
   );
 }
 function addExecuteCodeModeTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     disableTools = [],
@@ -16483,6 +16514,7 @@ function addExecuteCodeModeTool(server, options) {
   }
   addExecuteTool(server, {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -16497,7 +16529,7 @@ async function resolveLoopbackAuthorization(authStrategy) {
     return void 0;
   }
 }
-function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSize, authStrategy) {
+function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSize, authStrategy, codeModeFetch = defaultCodeModeFetch) {
   const searchUrl = `${codeModeBaseUrl}/api/code-mode/search`;
   server.tool(
     SEARCH_TOOL_NAME,
@@ -16517,7 +16549,7 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
       );
       try {
         const authorization3 = await resolveLoopbackAuthorization(authStrategy);
-        const resp = await fetch(searchUrl, {
+        const resp = await codeModeFetch(searchUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -16568,8 +16600,8 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
     }
   );
 }
-async function postExecute(executeUrl, body, authorization3) {
-  const resp = await fetch(executeUrl, {
+async function postExecute(executeUrl, body, authorization3, codeModeFetch = defaultCodeModeFetch) {
+  const resp = await codeModeFetch(executeUrl, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -16611,6 +16643,7 @@ function formatExecuteResult(data, maxResponseSize, reportBi) {
 function addExecuteTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -16699,7 +16732,8 @@ function addExecuteTool(server, options) {
             accountId: accountHeaders?.["wix-account-id"],
             siteAuthContext
           },
-          visitor ? visitorToken : accountHeaders?.Authorization ?? siteHeaders?.Authorization
+          visitor ? visitorToken : accountHeaders?.Authorization ?? siteHeaders?.Authorization,
+          codeModeFetch
         );
         if (data.authErrorStatus && visitor) {
           return executeErrorResult(
@@ -18559,7 +18593,25 @@ function extractText(result) {
   return result.content.filter((content) => content.type === "text" && content.text != null).map((content) => content.text).join("\n");
 }
 var TOOL_RESULT_PREVIEW_MAX_CHARS = 4e3;
-function formatToolResultAdditionalFields(result, extras) {
+var CODEX_OUTPUT_BUDGET_BYTES = 4e4;
+function getCodexTruncation(resultText, client) {
+  const isCodex = [client?.name, client?.userAgent].some(
+    (identity) => identity?.toLowerCase().includes("codex")
+  );
+  if (!isCodex) {
+    return void 0;
+  }
+  const resultBytes = new TextEncoder().encode(resultText).length;
+  if (resultBytes <= CODEX_OUTPUT_BUDGET_BYTES) {
+    return void 0;
+  }
+  return {
+    resultBytes,
+    budgetBytes: CODEX_OUTPUT_BUDGET_BYTES,
+    truncatedBytes: resultBytes - CODEX_OUTPUT_BUDGET_BYTES
+  };
+}
+function formatToolResultAdditionalFields(result, extras, client) {
   const resultText = extractText(result);
   const contentTypes = [
     ...new Set(
@@ -18576,6 +18628,7 @@ function formatToolResultAdditionalFields(result, extras) {
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
     resultContentTypes: contentTypes,
+    codexTruncation: getCodexTruncation(resultText, client),
     ...extras
   });
 }
@@ -18713,7 +18766,8 @@ function createWixToolkit(options) {
       toolDescriptions,
       toolHints,
       maxResponseSize,
-      codeModeBaseUrl = "https://mcp.wix.com"
+      codeModeBaseUrl = "https://mcp.wix.com",
+      codeModeFetch
     } = api;
     const effectiveToolDescriptions = {
       ...descriptionsWithoutReadme,
@@ -18737,6 +18791,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("SearchWixAPISpec") && !disableTools?.includes("SearchWixAPISpec")) {
       addSearchCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -18746,6 +18801,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("ExecuteWixAPI") && !disableTools?.includes("ExecuteWixAPI")) {
       addExecuteCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -18828,10 +18884,14 @@ function createWixToolkit(options) {
         if (!toolSucceeded) {
           errorBody = extractText(cbResult);
         } else {
-          additionalFields = formatToolResultAdditionalFields(cbResult, {
-            returnedRows: toolBiParams.returnedRows,
-            originalLength: toolBiParams.originalLength
-          });
+          additionalFields = formatToolResultAdditionalFields(
+            cbResult,
+            {
+              returnedRows: toolBiParams.returnedRows,
+              originalLength: toolBiParams.originalLength
+            },
+            { name: clientName }
+          );
         }
         if (!isDevEnvironment) {
           if (toolSucceeded) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/mcp",
-  "version": "1.0.84",
+  "version": "1.0.86",
   "description": "A Model Context Protocol server for Wix AI tools",
   "bin": "./build/bin-standalone.js",
   "dependencies": {
@@ -43,7 +43,7 @@
     "@wix/bi-logger-wix-code-data": "^1.485.0",
     "@wix/common-widget-types": "^1.77.0",
     "@wix/design-system": "^1.256.2",
-    "@wix/dynamic-context-enricher": "0.1.3",
+    "@wix/dynamic-context-enricher": "0.1.4",
     "@wix/http-client": "^2.85.0",
     "@wix/panorama-client-node": "^3.253.0",
     "@wix/standalone-node-bi-logger": "^1.7.24",
@@ -133,5 +133,5 @@
       ]
     }
   },
-  "falconPackageHash": "c391c0fba13ea30921f1c007a71a652bd532ba1f063ebed6c8c35627"
+  "falconPackageHash": "bfa0ad2bd45ba9e54844e736741354d379ec2790f92872287c5fc1d2"
 }