@wix/mcp 1.0.84 → 1.0.86

package/build/bin-standalone.js

@@ -72663,6 +72663,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((a2) => a2.appId && (a2.hasSkills || a2.hasTools)).sort(
+    (a2, b) => (a2.appName ?? a2.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 = [];
@@ -72725,6 +72741,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("");
@@ -73527,7 +73552,9 @@ function getErrorMessage(error2) {
 }
 function shouldTryMenuFallbackForDocsRead(error2, articleUrl) {
   const message = getErrorMessage(error2);
-  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(
@@ -74180,7 +74207,7 @@ var addDocsTools = (server2, 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}`
                     }
@@ -74272,7 +74299,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}`
                     }
@@ -85350,7 +85377,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(
+    (identity3) => identity3?.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(
@@ -85367,6 +85412,7 @@ function formatToolResultAdditionalFields(result, extras) {
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
     resultContentTypes: contentTypes,
+    codexTruncation: getCodexTruncation(resultText, client),
     ...extras
   });
 }
@@ -85545,10 +85591,17 @@ var WixMcpServer = class extends McpServer {
         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: this.getClientName?.() || this.server.getClientVersion()?.name,
+              userAgent: this.getUserAgent?.()
+            }
+          );
         }
         if (toolSucceeded && !isDevEnvironment) {
           panorama.transaction(toolName).finish({ toolInvocationId });

package/build/cjs/index.cjs

@@ -36024,7 +36024,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(
@@ -36041,6 +36059,7 @@ function formatToolResultAdditionalFields(result, extras) {
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
     resultContentTypes: contentTypes,
+    codexTruncation: getCodexTruncation(resultText, client),
     ...extras
   });
 }
@@ -36222,10 +36241,17 @@ var WixMcpServer = class extends McpServer {
         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: this.getClientName?.() || this.server.getClientVersion()?.name,
+              userAgent: this.getUserAgent?.()
+            }
+          );
         }
         if (toolSucceeded && !isDevEnvironment) {
           panorama.transaction(toolName).finish({ toolInvocationId });
@@ -38283,6 +38309,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((a2) => a2.appId && (a2.hasSkills || a2.hasTools)).sort(
+    (a2, b2) => (a2.appName ?? a2.appId ?? "").localeCompare(b2.appName ?? b2.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 = [];
@@ -38345,6 +38387,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("");
@@ -39147,7 +39198,9 @@ function getErrorMessage(error2) {
 }
 function shouldTryMenuFallbackForDocsRead(error2, articleUrl) {
   const message = getErrorMessage(error2);
-  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(
@@ -39800,7 +39853,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}`
                     }
@@ -39892,7 +39945,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}`
                     }
@@ -52838,11 +52891,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";
 async function addCodeModeTools(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     disableTools = [],
     toolDescriptions,
@@ -52852,6 +52907,7 @@ async function addCodeModeTools(server, options) {
   if (!disableTools.includes(EXECUTE_TOOL_NAME) && authStrategy) {
     addExecuteCodeModeTool(server, {
       codeModeBaseUrl,
+      codeModeFetch,
       authStrategy,
       disableTools,
       toolDescriptions,
@@ -52862,6 +52918,7 @@ async function addCodeModeTools(server, options) {
 function addSearchCodeModeTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     disableTools = [],
     toolDescriptions,
@@ -52876,12 +52933,14 @@ function addSearchCodeModeTool(server, options) {
     codeModeBaseUrl,
     description,
     maxResponseSize,
-    authStrategy
+    authStrategy,
+    codeModeFetch
   );
 }
 function addExecuteCodeModeTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     disableTools = [],
@@ -52893,6 +52952,7 @@ function addExecuteCodeModeTool(server, options) {
   }
   addExecuteTool(server, {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -52907,7 +52967,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,
@@ -52927,7 +52987,7 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
       );
       try {
         const authorization = await resolveLoopbackAuthorization(authStrategy);
-        const resp = await fetch(searchUrl, {
+        const resp = await codeModeFetch(searchUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -52978,8 +53038,8 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
     }
   );
 }
-async function postExecute(executeUrl, body, authorization) {
-  const resp = await fetch(executeUrl, {
+async function postExecute(executeUrl, body, authorization, codeModeFetch = defaultCodeModeFetch) {
+  const resp = await codeModeFetch(executeUrl, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -53021,6 +53081,7 @@ function formatExecuteResult(data, maxResponseSize, reportBi) {
 function addExecuteTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -53109,7 +53170,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(
@@ -53269,7 +53331,8 @@ function createWixToolkit(options) {
       toolDescriptions,
       toolHints,
       maxResponseSize,
-      codeModeBaseUrl = "https://mcp.wix.com"
+      codeModeBaseUrl = "https://mcp.wix.com",
+      codeModeFetch
     } = api;
     const effectiveToolDescriptions = {
       ...descriptionsWithoutReadme,
@@ -53293,6 +53356,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("SearchWixAPISpec") && !disableTools?.includes("SearchWixAPISpec")) {
       addSearchCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -53302,6 +53366,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("ExecuteWixAPI") && !disableTools?.includes("ExecuteWixAPI")) {
       addExecuteCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -53384,10 +53449,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/build/cjs/toolkit.cjs

@@ -18804,6 +18804,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 = [];
@@ -18866,6 +18882,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("");
@@ -19657,7 +19682,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(
@@ -20310,7 +20337,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}`
                     }
@@ -20402,7 +20429,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}`
                     }
@@ -22028,11 +22055,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,
@@ -22047,12 +22076,14 @@ function addSearchCodeModeTool(server, options) {
     codeModeBaseUrl,
     description,
     maxResponseSize,
-    authStrategy
+    authStrategy,
+    codeModeFetch
   );
 }
 function addExecuteCodeModeTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     disableTools = [],
@@ -22064,6 +22095,7 @@ function addExecuteCodeModeTool(server, options) {
   }
   addExecuteTool(server, {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -22078,7 +22110,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,
@@ -22098,7 +22130,7 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
       );
       try {
         const authorization = await resolveLoopbackAuthorization(authStrategy);
-        const resp = await fetch(searchUrl, {
+        const resp = await codeModeFetch(searchUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -22149,8 +22181,8 @@ function registerSearchTool(server, codeModeBaseUrl, description, maxResponseSiz
     }
   );
 }
-async function postExecute(executeUrl, body, authorization) {
-  const resp = await fetch(executeUrl, {
+async function postExecute(executeUrl, body, authorization, codeModeFetch = defaultCodeModeFetch) {
+  const resp = await codeModeFetch(executeUrl, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -22192,6 +22224,7 @@ function formatExecuteResult(data, maxResponseSize, reportBi) {
 function addExecuteTool(server, options) {
   const {
     codeModeBaseUrl,
+    codeModeFetch,
     authStrategy,
     visitor,
     toolDescriptions,
@@ -22280,7 +22313,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(
@@ -22388,7 +22422,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(
@@ -22405,6 +22457,7 @@ function formatToolResultAdditionalFields(result, extras) {
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
     resultContentTypes: contentTypes,
+    codexTruncation: getCodexTruncation(resultText, client),
     ...extras
   });
 }
@@ -22542,7 +22595,8 @@ function createWixToolkit(options) {
       toolDescriptions,
       toolHints,
       maxResponseSize,
-      codeModeBaseUrl = "https://mcp.wix.com"
+      codeModeBaseUrl = "https://mcp.wix.com",
+      codeModeFetch
     } = api;
     const effectiveToolDescriptions = {
       ...descriptionsWithoutReadme,
@@ -22566,6 +22620,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("SearchWixAPISpec") && !disableTools?.includes("SearchWixAPISpec")) {
       addSearchCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -22575,6 +22630,7 @@ function createWixToolkit(options) {
     if (requestedTools.has("ExecuteWixAPI") && !disableTools?.includes("ExecuteWixAPI")) {
       addExecuteCodeModeTool(server, {
         codeModeBaseUrl,
+        codeModeFetch,
         authStrategy,
         disableTools,
         toolDescriptions: effectiveToolDescriptions,
@@ -22657,10 +22713,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/build/dts/code-mode/index.d.ts

@@ -1,7 +1,14 @@
 import { WixMcpServer } from '../wix-mcp-server.js';
 import { type McpAuthenticationStrategy } from '../auth/index.js';
+/**
+ * Transport for the code-mode endpoints (`/api/code-mode/search|execute`).
+ * Defaults to the global `fetch`; a host that serves those endpoints itself
+ * can pass an in-runtime loopback instead.
+ */
+export type CodeModeFetch = (url: string, init: RequestInit) => Promise<Response>;
 export interface CodeModeOptions {
     codeModeBaseUrl: string;
+    codeModeFetch?: CodeModeFetch;
     authStrategy?: McpAuthenticationStrategy;
     /**
      * Visitor mode: pin ExecuteWixAPI to one site and take an agent-supplied