@wix/mcp 1.0.85 → 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}`
                     }
@@ -53396,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}`
                     }
@@ -22395,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(
@@ -22412,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
   });
 }
@@ -22667,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/docs/docs.js

@@ -47,7 +47,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((knownArticleError) => message.includes(knownArticleError));
@@ -671,7 +673,7 @@ export const 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.\n\n${text}`
+                                        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.\n\n${text}`
                                     }
                                 ]
                             };
@@ -746,7 +748,7 @@ export const 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.\n\n${text}`
+                                        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.\n\n${text}`
                                     }
                                 ]
                             };

package/build/dts/infra/tool-bi.d.ts

@@ -6,7 +6,11 @@ import { wixMcpRequestSrc39Evid1607, executeWixApiToolRequestSrc39Evid1612 } fro
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): string | undefined;
+export interface ToolResultClient {
+    name?: string;
+    userAgent?: string;
+}
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>, client?: ToolResultClient): string | undefined;
 export declare function createToolBiEvent(params: Parameters<typeof wixMcpRequestSrc39Evid1607>[0]): import("@wix/bi-logger-api-infra-data/v2/types").LogObject<import("@wix/bi-logger-api-infra-data/v2/types").wixMcpRequestSrc39Evid1607Params>;
 export declare function createExecuteWixAPICallToolBiEvent(params: Parameters<typeof executeWixApiToolRequestSrc39Evid1612>[0]): import("@wix/bi-logger-api-infra-data/v2/types").LogObject<import("@wix/bi-logger-api-infra-data/v2/types").executeWixApiToolRequestSrc39Evid1612Params>;
 //# sourceMappingURL=tool-bi.d.ts.map

package/build/dts/infra/tool-bi.js

@@ -11,7 +11,27 @@ export function extractText(result) {
         .join('\n');
 }
 const TOOL_RESULT_PREVIEW_MAX_CHARS = 4000;
-export function formatToolResultAdditionalFields(result, extras) {
+// Codex keeps 10,000 tokens of a tool result by default, estimated at 4 bytes
+// per token, and drops the middle of anything longer.
+const CODEX_OUTPUT_BUDGET_BYTES = 40_000;
+// Predicted from the default budget: a user who raised Codex's
+// tool_output_token_limit is flagged here but not actually truncated.
+function getCodexTruncation(resultText, client) {
+    const isCodex = [client?.name, client?.userAgent].some((identity) => identity?.toLowerCase().includes('codex'));
+    if (!isCodex) {
+        return undefined;
+    }
+    const resultBytes = new TextEncoder().encode(resultText).length;
+    if (resultBytes <= CODEX_OUTPUT_BUDGET_BYTES) {
+        return undefined;
+    }
+    return {
+        resultBytes,
+        budgetBytes: CODEX_OUTPUT_BUDGET_BYTES,
+        truncatedBytes: resultBytes - CODEX_OUTPUT_BUDGET_BYTES
+    };
+}
+export function formatToolResultAdditionalFields(result, extras, client) {
     const resultText = extractText(result);
     const contentTypes = [
         ...new Set(result.content?.map((content) => content.type) ?? [])
@@ -24,6 +44,7 @@ export function formatToolResultAdditionalFields(result, extras) {
         resultTextLength: resultText.length,
         resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
         resultContentTypes: contentTypes,
+        codexTruncation: getCodexTruncation(resultText, client),
         ...extras
     });
 }

package/build/dts/toolkit-entry.d.cts

@@ -175,7 +175,11 @@ export type CodeModeFetch = (url: string, init: RequestInit) => Promise<Response
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): string | undefined;
+export interface ToolResultClient {
+	name?: string;
+	userAgent?: string;
+}
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>, client?: ToolResultClient): string | undefined;
 /** A single tool extracted from @wix/mcp, ready to execute. */
 export interface WixTool {
 	/** Tool name (e.g. 'CallWixSiteAPI', 'SearchWixRESTDocumentation') */

package/build/dts/toolkit-entry.d.ts

@@ -175,7 +175,11 @@ export type CodeModeFetch = (url: string, init: RequestInit) => Promise<Response
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): string | undefined;
+export interface ToolResultClient {
+	name?: string;
+	userAgent?: string;
+}
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>, client?: ToolResultClient): string | undefined;
 /** A single tool extracted from @wix/mcp, ready to execute. */
 export interface WixTool {
 	/** Tool name (e.g. 'CallWixSiteAPI', 'SearchWixRESTDocumentation') */

package/build/dts/toolkit.js

@@ -319,7 +319,7 @@ export function createWixToolkit(options) {
                     additionalFields = formatToolResultAdditionalFields(cbResult, {
                         returnedRows: toolBiParams.returnedRows,
                         originalLength: toolBiParams.originalLength
-                    });
+                    }, { name: clientName });
                 }
                 // Panorama: finish or report error
                 if (!isDevEnvironment) {

package/build/dts/wix-mcp-server.js

@@ -183,6 +183,9 @@ export class WixMcpServer extends McpServer {
                     additionalFields = formatToolResultAdditionalFields(cbResult, {
                         returnedRows: toolBiParams.returnedRows,
                         originalLength: toolBiParams.originalLength
+                    }, {
+                        name: this.getClientName?.() || this.server.getClientVersion()?.name,
+                        userAgent: this.getUserAgent?.()
                     });
                 }
                 if (toolSucceeded && !isDevEnvironment) {

package/build/esm/index.js

@@ -29740,7 +29740,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(
@@ -29757,6 +29775,7 @@ function formatToolResultAdditionalFields(result, extras) {
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
     resultContentTypes: contentTypes,
+    codexTruncation: getCodexTruncation(resultText, client),
     ...extras
   });
 }
@@ -29938,10 +29957,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 });
@@ -31996,6 +32022,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 = [];
@@ -32058,6 +32100,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("");
@@ -32860,7 +32911,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(
@@ -33513,7 +33566,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}`
                     }
@@ -33605,7 +33658,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}`
                     }
@@ -47160,10 +47213,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/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}`
                     }
@@ -18566,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(
@@ -18583,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
   });
 }
@@ -18838,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.85",
+  "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": "fa4f66edf0696bfeabc3430c4fc334d1b036704c758c5d5c65aa2b60"
+  "falconPackageHash": "bfa0ad2bd45ba9e54844e736741354d379ec2790f92872287c5fc1d2"
 }