@wix/mcp 1.0.80 → 1.0.81

package/build/cjs/toolkit.cjs

@@ -17648,6 +17648,9 @@ function rethrowIfUnauthorized(error) {
   }
 }
 
+// src/config/api-request-rules.ts
+var ARRAY_QUERY_PARAMS_RULE = "Repeat array query params once per value: `?fieldsets=URL&fieldsets=RICH_CONTENT`. Do NOT comma-join values (`fieldsets=URL,RICH_CONTENT`), do NOT leave a trailing comma, and do NOT use a value the method schema does not list, even if a sibling method accepts it (draft posts have no `SEO` fieldset).";
+
 // src/config/default-config.ts
 var AGENT_GOAL = dedent_default`
   You are an agent that helps the user manage their Wix site.
@@ -17769,11 +17772,13 @@ var EXECUTE_WIX_API_INTRO = dedent_default`
   CODE CONTRACT:
   - Pass an async function expression: \`async function() { ... }\` or \`async () => { ... }\`. Put every declaration, \`await\`, and \`return\` inside it, and do not invoke it yourself.
   - Use only \`wix.request({ method, url, body })\` and in-memory JavaScript. Node.js modules, filesystem access, and downloadable-file creation are unavailable.
+  - Do not minify the code. Put each object property on its own line, with spaces after colons and commas, and declare deep literals (request bodies, filters, patch lists) as a named \`const\` before use so each \`wix.request({ ... })\` argument stays short.
 
   CONFIRM API CONTRACTS:
   - Do not rely on memory for endpoints, methods, bodies, response paths, filters, enum values, or auth scope. Confirm every method from conversation-provided details, a complete matching docs example, or the schema/docs tools before executing.
   - Prefer \`method.publicUrl\` from SearchWixAPISpec; never use \`method.servers[0]\`. Pass all supporting documentation URLs through \`sourceDocUrls\`.
   - A response field is not automatically filterable or sortable. Use only capabilities declared for that exact query/search method. If an unsupported filter is unavoidable, fetch a bounded result set and filter it in code.
+  - ${ARRAY_QUERY_PARAMS_RULE}
   - Read-only probes may inspect state or resolve IDs. Never use speculative create/update/delete calls to discover request or response shapes, and never repeat a successful mutation merely to obtain more response data.
 `;
 var EXECUTE_WIX_API_OUTPUT_AND_ERRORS = dedent_default`
@@ -17789,6 +17794,7 @@ var ACCOUNT_SITE_EXECUTE_SCOPE = dedent_default`
   SCOPE AND SITE TARGETING:
   - Set \`scope: "site"\` for site-level APIs and \`scope: "account"\` for account-level APIs. Account-level acts on the account itself, or on sites as objects within it; anything that reads or writes inside a site is site-level.
   - If \`scope\` is omitted it defaults to site when either the ExecuteWixAPI call or \`wix.request\` provides a \`siteId\`; otherwise it defaults to account.
+  - Site-level calls need a site ID; there is no implicit current site. Before any \`scope: "site"\` call, pass the site's ID as the ExecuteWixAPI \`siteId\` parameter or per request. \`scope: "site"\` without a \`siteId\` fails.
   - \`scope: "account"\` ignores any \`siteId\` you pass, so a site-level endpoint called that way fails.
   - Authentication is injected automatically; never set Authorization, wix-site-id, or wix-account-id headers.
   - For one named site, prefer GetSiteContext. If it is unavailable, resolve the exact site and perform the action in the same invocation.
@@ -18109,8 +18115,10 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     SearchBuildAppsDocumentation: dedent_default`
     Searches the Wix Build Apps documentation.
   `,
-    SearchOverviewDocumentation: dedent_default`
-    Searches high-level Wix platform and business overview documentation.
+    SearchDevelopmentDocumentation: dedent_default`
+    Broad Wix development documentation (platform concepts, developer guides, getting started). **Last resort — development tasks only.**
+    Skip it entirely for general, business, support, or Wix-editor questions.
+    Call it only after the specific search for your task returned nothing useful: \`SearchWixRESTDocumentation\` (REST), \`SearchWixSDKDocumentation\` (JS SDK), \`SearchWixCLIDocumentation\` (CLI), \`SearchBuildAppsDocumentation\` (apps), \`SearchWixHeadlessDocumentation\` (Headless), \`SearchWixWDSDocumentation\` (WDS). Never use it as a first search.
   `,
     SearchWixHeadlessDocumentation: dedent_default`
     Searches the Wix Headless documentation.
@@ -18762,14 +18770,20 @@ function renderApps(apps, knownApps) {
 }
 function renderProperties(props) {
   const sections = [];
-  const locale = [];
-  if (props.language) locale.push(`- Language: **${props.language}**`);
-  if (props.locale?.country) locale.push(`- Country: **${props.locale.country}**`);
-  if (props.timeZone) locale.push(`- Timezone: **${props.timeZone}**`);
-  if (props.paymentCurrency) locale.push(`- Currency: **${props.paymentCurrency}**`);
-  if (locale.length) {
-    sections.push(`**Locale & Region**
-${locale.join("\n")}`);
+  const regionalFormat = [];
+  if (props.language) regionalFormat.push(`- Language: **${props.language}**`);
+  if (props.locale?.country)
+    regionalFormat.push(`- Locale region: **${props.locale.country}**`);
+  if (props.timeZone) regionalFormat.push(`- Timezone: **${props.timeZone}**`);
+  if (props.paymentCurrency)
+    regionalFormat.push(`- Currency: **${props.paymentCurrency}**`);
+  if (regionalFormat.length) {
+    sections.push(`**Regional Format**
+${regionalFormat.join("\n")}`);
+  }
+  if (props.address?.country) {
+    sections.push(`**Location**
+- Country: **${props.address.country}**`);
   }
   const contact = [];
   if (props.email) contact.push(`- Email: **${props.email}**`);
@@ -18916,6 +18930,7 @@ var known_apps_default = {
   "225dd912-7dea-4738-8688-4b8c6955ffc2": "Wix Forms",
   "d80111c5-a0f4-47a8-b63a-65b54d774a27": "Wix Gift Cards",
   "148c2287-c669-d849-d153-463c7486a694": "Wix Groups",
+  "14bca956-e09f-f4d6-14d7-466cb3f09103": "Wix Hotels",
   "13ee94c1-b635-8505-3391-97919052c16f": "Wix Invoices",
   "14cc59bc-f0b7-15b8-e1c7-89ce41d0e0c9": "Wix Members Area",
   "14d84998-ae09-1abf-c6fc-3f3cace5bf19": "Wix Multilingual",
@@ -18950,8 +18965,8 @@ async function getDynamicContext(auth, httpClient, filter, options) {
     partnerContextEnabled: options,
     includeAccountContext: options
   } : options;
-  const includePartnerContext = contextOptions?.partnerContextEnabled ?? false;
-  const includeAccountContext = contextOptions?.includeAccountContext ?? false;
+  const includePartnerContext = contextOptions?.partnerContextEnabled ?? true;
+  const includeAccountContext = contextOptions?.includeAccountContext ?? true;
   try {
     const accountHeaders = await auth.getAccountAuthHeaders();
     const noFilter = !filter?.siteId && !filter?.siteName;
@@ -19065,7 +19080,8 @@ var paramDescriptions = {
       "The url of the api to call - ALWAYS get the API url from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL",
       'NEVER guess the API url, ALWAYS get it from the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool',
       `Allowed API urls are: ${ALLOWED_HOSTNAMES.join(", ")}`,
-      `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`
+      `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`,
+      ARRAY_QUERY_PARAMS_RULE
     ].join("\n"),
     method: "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)",
     body: 'The request body as a JSON object or array with all the required fields and values, including nested objects. Pass the actual value (object or array), NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - the body should be based on the conversation context, i.e from the user prompt OR got into the conversation context by the "ReadFullDocsArticle" tool OR by the "SearchWixAPISpec" tool OR by the "ReadFullDocsMethodSchema" tool - i.e based on the API docs, a relevant recipe you read (preferably), a code example you found in the docs, a schema you read etc.. YOU MUST NEVER ASSUME YOU KNOW WHAT THE BODY SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT. Prefer reading relevant recipes if you have them in context for understand the body schema for API calls.',
@@ -19138,8 +19154,8 @@ var paramDescriptions = {
     searchTerm: "The search term to search for in the Build Apps Documentation",
     maxResults: "The maximum number of results to return, default is 10, max is 15"
   },
-  SearchOverviewDocumentation: {
-    searchTerm: "The search term to search for in the Wix Overview Documentation",
+  SearchDevelopmentDocumentation: {
+    searchTerm: "The development-related search term. Use only after a more specific docs search (REST/SDK/CLI/Build Apps/Headless/WDS) came back empty.",
     maxResults: "The maximum number of results to return, default is 10, max is 15"
   },
   SearchWixHeadlessDocumentation: {
@@ -19935,15 +19951,15 @@ var addDocsTools = (server, allowedTools = [
       }
     );
   }
-  if (allowedTools.includes("OVERVIEW") && !disableTools?.includes("SearchOverviewDocumentation")) {
+  if (allowedTools.includes("OVERVIEW") && !disableTools?.includes("SearchDevelopmentDocumentation")) {
     server.tool(
-      "SearchOverviewDocumentation",
+      "SearchDevelopmentDocumentation",
       getDescription(
-        "SearchOverviewDocumentation",
-        defaultToolDescriptions.SearchOverviewDocumentation ?? ""
+        "SearchDevelopmentDocumentation",
+        defaultToolDescriptions.SearchDevelopmentDocumentation ?? ""
       ),
       (() => {
-        const d = desc("SearchOverviewDocumentation");
+        const d = desc("SearchDevelopmentDocumentation");
         return {
           searchTerm: external_exports.string().describe(d.searchTerm),
           maxResults: external_exports.number().describe(d.maxResults).min(1).max(15).optional().default(15)
@@ -19973,8 +19989,8 @@ var addDocsTools = (server, allowedTools = [
           panorama.errorMonitor().reportError(error);
           captureException(error, {
             tags: {
-              componentId: "SearchOverviewDocumentation",
-              toolName: "SearchOverviewDocumentation"
+              componentId: "SearchDevelopmentDocumentation",
+              toolName: "SearchDevelopmentDocumentation"
             }
           });
           logger.error(
@@ -20838,6 +20854,19 @@ var MAX_ALLOWED_RESPONSE_CHARS = 2e6;
 
 // src/api-call/index.ts
 var DEFAULT_MAX_RESPONSE_SIZE = 5e4;
+function extractReturnedRows(responseData) {
+  if (responseData === null || typeof responseData !== "object") {
+    return void 0;
+  }
+  const data = responseData;
+  const block = data.pagingMetadata ?? data.cursorPagingMetadata ?? data.pagingOffsetMetadata ?? data.metaData ?? data.metadata;
+  const raw = block?.count;
+  if (typeof raw !== "number" && (typeof raw !== "string" || raw.trim() === "")) {
+    return void 0;
+  }
+  const count = Number(raw);
+  return Number.isFinite(count) ? count : void 0;
+}
 function formatApiResponse(responseData, maxResponseSize = DEFAULT_MAX_RESPONSE_SIZE) {
   if (typeof responseData === "string" && responseData.trim().startsWith("<!DOCTYPE")) {
     return {
@@ -20845,13 +20874,15 @@ function formatApiResponse(responseData, maxResponseSize = DEFAULT_MAX_RESPONSE_
       isError: true
     };
   }
+  const returnedRows = extractReturnedRows(responseData);
   let responseText = JSON.stringify(responseData);
+  const originalLength = responseText.length;
   const effectiveMax = Math.min(maxResponseSize, MAX_ALLOWED_RESPONSE_CHARS);
   if (responseText.length > effectiveMax) {
     responseText = responseText.slice(0, effectiveMax) + `
 ...[TRUNCATED - response was ${responseText.length} chars, showing first ${effectiveMax}]`;
   }
-  return { text: responseText, isError: false };
+  return { text: responseText, isError: false, originalLength, returnedRows };
 }
 function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "ListWixSites", "ManageWixSite"], disableTools = [], enableTools = [], toolDescriptions, toolHints, maxResponseSize) {
   const effectiveAllowedTools = [
@@ -20914,9 +20945,14 @@ function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "Lis
             data: method === "GET" ? void 0 : body
           });
           const requestId = response.headers?.["x-wix-request-id"];
-          setToolBiParams({ requestId, siteId });
           const responseData = await handleWixAPIResponse(response);
           const formatted = formatApiResponse(responseData, maxResponseSize);
+          setToolBiParams({
+            requestId,
+            siteId,
+            returnedRows: formatted.returnedRows,
+            originalLength: formatted.originalLength
+          });
           if (formatted.isError) {
             return {
               content: [
@@ -21055,7 +21091,7 @@ function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "Lis
         destructiveHint: true,
         openWorldHint: false
       }),
-      async ({ url, body, method, reason }, { httpClient }) => {
+      async ({ url, body, method, reason }, { httpClient, setToolBiParams }) => {
         logger.log(
           `Calling Wix Account level API: ${url}, reason="${reason}", body: ${JSON.stringify(body)}`
         );
@@ -21084,6 +21120,10 @@ function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "Lis
           });
           const responseData = await handleWixAPIResponse(response);
           const formatted = formatApiResponse(responseData, maxResponseSize);
+          setToolBiParams({
+            returnedRows: formatted.returnedRows,
+            originalLength: formatted.originalLength
+          });
           if (formatted.isError) {
             return {
               content: [
@@ -21306,10 +21346,13 @@ function executeTextResult(message) {
     content: [{ type: "text", text: message }]
   };
 }
-function formatExecuteResult(data, maxResponseSize) {
+function formatExecuteResult(data, maxResponseSize, reportBi) {
   if (data.error) {
     return executeErrorResult(data.error);
   }
+  reportBi?.({
+    originalLength: typeof data.result === "string" ? data.result.length : JSON.stringify(data.result)?.length
+  });
   return {
     content: [
       { type: "text", text: truncateResponse(data.result, maxResponseSize) }
@@ -21419,7 +21462,11 @@ function addExecuteTool(server, options) {
             status: data.authErrorStatus
           });
         }
-        return formatExecuteResult(data, maxResponseSize);
+        return formatExecuteResult(
+          data,
+          maxResponseSize,
+          extra?.setToolBiParams
+        );
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         logger.log(
@@ -21511,7 +21558,7 @@ 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) {
+function formatToolResultAdditionalFields(result, extras) {
   const resultText = extractText(result);
   const contentTypes = [
     ...new Set(
@@ -21527,7 +21574,8 @@ function formatToolResultAdditionalFields(result) {
     resultPreview: resultText.slice(0, TOOL_RESULT_PREVIEW_MAX_CHARS),
     resultTextLength: resultText.length,
     resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
-    resultContentTypes: contentTypes
+    resultContentTypes: contentTypes,
+    ...extras
   });
 }
 function createToolBiEvent(params) {
@@ -21765,7 +21813,10 @@ function createWixToolkit(options) {
         if (!toolSucceeded) {
           errorBody = extractText(cbResult);
         } else {
-          additionalFields = formatToolResultAdditionalFields(cbResult);
+          additionalFields = formatToolResultAdditionalFields(cbResult, {
+            returnedRows: toolBiParams.returnedRows,
+            originalLength: toolBiParams.originalLength
+          });
         }
         if (!isDevEnvironment) {
           if (toolSucceeded) {

package/build/dts/api-call/index.js

@@ -10,6 +10,32 @@ import { desc } from '../config/param-descriptions.js';
 import { MAX_ALLOWED_RESPONSE_CHARS } from '../infra/response-size-limits.js';
 export { addUploadImageTool } from './upload-image-tool.js';
 const DEFAULT_MAX_RESPONSE_SIZE = 50000; // ~50KB cap
+/**
+ * Rows the API actually served, read before truncation. Endpoints often return
+ * fewer than asked for, so an offset advance that does not match
+ * offset + requested limit can still be correct -- without this, BI cannot tell
+ * a paging defect from a short page.
+ */
+function extractReturnedRows(responseData) {
+    if (responseData === null || typeof responseData !== 'object') {
+        return undefined;
+    }
+    const data = responseData;
+    const block = (data.pagingMetadata ??
+        data.cursorPagingMetadata ??
+        data.pagingOffsetMetadata ??
+        data.metaData ??
+        data.metadata);
+    const raw = block?.count;
+    // A blank string coerces to 0, which would report a page size the endpoint
+    // never sent -- worse than reporting nothing.
+    if (typeof raw !== 'number' &&
+        (typeof raw !== 'string' || raw.trim() === '')) {
+        return undefined;
+    }
+    const count = Number(raw);
+    return Number.isFinite(count) ? count : undefined;
+}
 function formatApiResponse(responseData, maxResponseSize = DEFAULT_MAX_RESPONSE_SIZE) {
     // Detect if response is HTML (likely wrong endpoint or auth redirect)
     if (typeof responseData === 'string' &&
@@ -19,14 +45,16 @@ function formatApiResponse(responseData, maxResponseSize = DEFAULT_MAX_RESPONSE_
             isError: true
         };
     }
+    const returnedRows = extractReturnedRows(responseData);
     let responseText = JSON.stringify(responseData);
+    const originalLength = responseText.length;
     const effectiveMax = Math.min(maxResponseSize, MAX_ALLOWED_RESPONSE_CHARS);
     if (responseText.length > effectiveMax) {
         responseText =
             responseText.slice(0, effectiveMax) +
                 `\n...[TRUNCATED - response was ${responseText.length} chars, showing first ${effectiveMax}]`;
     }
-    return { text: responseText, isError: false };
+    return { text: responseText, isError: false, originalLength, returnedRows };
 }
 export function addApiCallTool(server, strategy, allowedTools = ['CallWixSiteAPI', 'ListWixSites', 'ManageWixSite'], disableTools = [], enableTools = [], toolDescriptions, toolHints, maxResponseSize) {
     // Compute effective allowed tools: (default + enableTools) - disableTools
@@ -89,9 +117,15 @@ export function addApiCallTool(server, strategy, allowedTools = ['CallWixSiteAPI
                     data: method === 'GET' ? undefined : body
                 });
                 const requestId = response.headers?.['x-wix-request-id'];
-                setToolBiParams({ requestId, siteId });
                 const responseData = await handleWixAPIResponse(response);
                 const formatted = formatApiResponse(responseData, maxResponseSize);
+                // One call only -- setToolBiParams replaces rather than merges.
+                setToolBiParams({
+                    requestId,
+                    siteId,
+                    returnedRows: formatted.returnedRows,
+                    originalLength: formatted.originalLength
+                });
                 if (formatted.isError) {
                     return {
                         content: [
@@ -222,7 +256,7 @@ export function addApiCallTool(server, strategy, allowedTools = ['CallWixSiteAPI
             readOnlyHint: false,
             destructiveHint: true,
             openWorldHint: false
-        }), async ({ url, body, method, reason }, { httpClient }) => {
+        }), async ({ url, body, method, reason }, { httpClient, setToolBiParams }) => {
             logger.log(`Calling Wix Account level API: ${url}, reason="${reason}", body: ${JSON.stringify(body)}`);
             const { isAllowed, error: urlError } = isApiUrlAllowed(url);
             if (!isAllowed) {
@@ -251,6 +285,10 @@ export function addApiCallTool(server, strategy, allowedTools = ['CallWixSiteAPI
                 });
                 const responseData = await handleWixAPIResponse(response);
                 const formatted = formatApiResponse(responseData, maxResponseSize);
+                setToolBiParams({
+                    returnedRows: formatted.returnedRows,
+                    originalLength: formatted.originalLength
+                });
                 if (formatted.isError) {
                     return {
                         content: [

package/build/dts/code-mode/index.js

@@ -162,10 +162,16 @@ function executeTextResult(message) {
         content: [{ type: 'text', text: message }]
     };
 }
-function formatExecuteResult(data, maxResponseSize) {
+function formatExecuteResult(data, maxResponseSize, reportBi) {
     if (data.error) {
         return executeErrorResult(data.error);
     }
+    // Before the slice -- resultTextLength is measured after it and saturates.
+    reportBi?.({
+        originalLength: typeof data.result === 'string'
+            ? data.result.length
+            : JSON.stringify(data.result)?.length
+    });
     return {
         content: [
             { type: 'text', text: truncateResponse(data.result, maxResponseSize) }
@@ -293,7 +299,7 @@ function addExecuteTool(server, options) {
                     status: data.authErrorStatus
                 });
             }
-            return formatExecuteResult(data, maxResponseSize);
+            return formatExecuteResult(data, maxResponseSize, extra?.setToolBiParams);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);

package/build/dts/config/api-request-rules.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Request-shape rules shared by every tool that lets an agent write a Wix REST
+ * URL by hand (ExecuteWixAPI's `wix.request` and CallWixSiteAPI's `url`).
+ */
+/**
+ * The Wix API gateway deserializes enum-typed array query params only when the
+ * parameter is repeated once per value. Comma-joined values are read as a
+ * single unknown enum member and rejected with HTTP 400.
+ */
+export declare const ARRAY_QUERY_PARAMS_RULE = "Repeat array query params once per value: `?fieldsets=URL&fieldsets=RICH_CONTENT`. Do NOT comma-join values (`fieldsets=URL,RICH_CONTENT`), do NOT leave a trailing comma, and do NOT use a value the method schema does not list, even if a sibling method accepts it (draft posts have no `SEO` fieldset).";
+//# sourceMappingURL=api-request-rules.d.ts.map

package/build/dts/config/api-request-rules.js

@@ -0,0 +1,11 @@
+/**
+ * Request-shape rules shared by every tool that lets an agent write a Wix REST
+ * URL by hand (ExecuteWixAPI's `wix.request` and CallWixSiteAPI's `url`).
+ */
+/**
+ * The Wix API gateway deserializes enum-typed array query params only when the
+ * parameter is repeated once per value. Comma-joined values are read as a
+ * single unknown enum member and rejected with HTTP 400.
+ */
+export const ARRAY_QUERY_PARAMS_RULE = 'Repeat array query params once per value: `?fieldsets=URL&fieldsets=RICH_CONTENT`. Do NOT comma-join values (`fieldsets=URL,RICH_CONTENT`), do NOT leave a trailing comma, and do NOT use a value the method schema does not list, even if a sibling method accepts it (draft posts have no `SEO` fieldset).';
+//# sourceMappingURL=api-request-rules.js.map

package/build/dts/config/default-config.js

@@ -1,4 +1,5 @@
 import dedent from 'dedent';
+import { ARRAY_QUERY_PARAMS_RULE } from './api-request-rules.js';
 /**
  * Common agent goal - used in both SYSTEM_REMINDER and defaultReadmeDocs
  */
@@ -104,11 +105,13 @@ const EXECUTE_WIX_API_INTRO = dedent `
   CODE CONTRACT:
   - Pass an async function expression: \`async function() { ... }\` or \`async () => { ... }\`. Put every declaration, \`await\`, and \`return\` inside it, and do not invoke it yourself.
   - Use only \`wix.request({ method, url, body })\` and in-memory JavaScript. Node.js modules, filesystem access, and downloadable-file creation are unavailable.
+  - Do not minify the code. Put each object property on its own line, with spaces after colons and commas, and declare deep literals (request bodies, filters, patch lists) as a named \`const\` before use so each \`wix.request({ ... })\` argument stays short.
 
   CONFIRM API CONTRACTS:
   - Do not rely on memory for endpoints, methods, bodies, response paths, filters, enum values, or auth scope. Confirm every method from conversation-provided details, a complete matching docs example, or the schema/docs tools before executing.
   - Prefer \`method.publicUrl\` from SearchWixAPISpec; never use \`method.servers[0]\`. Pass all supporting documentation URLs through \`sourceDocUrls\`.
   - A response field is not automatically filterable or sortable. Use only capabilities declared for that exact query/search method. If an unsupported filter is unavoidable, fetch a bounded result set and filter it in code.
+  - ${ARRAY_QUERY_PARAMS_RULE}
   - Read-only probes may inspect state or resolve IDs. Never use speculative create/update/delete calls to discover request or response shapes, and never repeat a successful mutation merely to obtain more response data.
 `;
 const EXECUTE_WIX_API_OUTPUT_AND_ERRORS = dedent `
@@ -124,6 +127,7 @@ const ACCOUNT_SITE_EXECUTE_SCOPE = dedent `
   SCOPE AND SITE TARGETING:
   - Set \`scope: "site"\` for site-level APIs and \`scope: "account"\` for account-level APIs. Account-level acts on the account itself, or on sites as objects within it; anything that reads or writes inside a site is site-level.
   - If \`scope\` is omitted it defaults to site when either the ExecuteWixAPI call or \`wix.request\` provides a \`siteId\`; otherwise it defaults to account.
+  - Site-level calls need a site ID; there is no implicit current site. Before any \`scope: "site"\` call, pass the site's ID as the ExecuteWixAPI \`siteId\` parameter or per request. \`scope: "site"\` without a \`siteId\` fails.
   - \`scope: "account"\` ignores any \`siteId\` you pass, so a site-level endpoint called that way fails.
   - Authentication is injected automatically; never set Authorization, wix-site-id, or wix-account-id headers.
   - For one named site, prefer GetSiteContext. If it is unavailable, resolve the exact site and perform the action in the same invocation.
@@ -441,8 +445,10 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
         SearchBuildAppsDocumentation: dedent `
     Searches the Wix Build Apps documentation.
   `,
-        SearchOverviewDocumentation: dedent `
-    Searches high-level Wix platform and business overview documentation.
+        SearchDevelopmentDocumentation: dedent `
+    Broad Wix development documentation (platform concepts, developer guides, getting started). **Last resort — development tasks only.**
+    Skip it entirely for general, business, support, or Wix-editor questions.
+    Call it only after the specific search for your task returned nothing useful: \`SearchWixRESTDocumentation\` (REST), \`SearchWixSDKDocumentation\` (JS SDK), \`SearchWixCLIDocumentation\` (CLI), \`SearchBuildAppsDocumentation\` (apps), \`SearchWixHeadlessDocumentation\` (Headless), \`SearchWixWDSDocumentation\` (WDS). Never use it as a first search.
   `,
         SearchWixHeadlessDocumentation: dedent `
     Searches the Wix Headless documentation.

package/build/dts/config/param-descriptions.d.ts

@@ -54,7 +54,7 @@ export declare const paramDescriptions: {
         searchTerm: string;
         maxResults: string;
     };
-    SearchOverviewDocumentation: {
+    SearchDevelopmentDocumentation: {
         searchTerm: string;
         maxResults: string;
     };

package/build/dts/config/param-descriptions.js

@@ -1,4 +1,5 @@
 import { ALLOWED_HOSTNAMES } from '../api-call/validation.js';
+import { ARRAY_QUERY_PARAMS_RULE } from './api-request-rules.js';
 /**
  * Centralized parameter descriptions organized by tool.
  * Each tool has all its parameter descriptions in one place.
@@ -10,7 +11,8 @@ export const paramDescriptions = {
             'The url of the api to call - ALWAYS get the API url from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL',
             'NEVER guess the API url, ALWAYS get it from the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool',
             `Allowed API urls are: ${ALLOWED_HOSTNAMES.join(', ')}`,
-            `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`
+            `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`,
+            ARRAY_QUERY_PARAMS_RULE
         ].join('\n'),
         method: 'The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)',
         body: 'The request body as a JSON object or array with all the required fields and values, including nested objects. Pass the actual value (object or array), NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - the body should be based on the conversation context, i.e from the user prompt OR got into the conversation context by the "ReadFullDocsArticle" tool OR by the "SearchWixAPISpec" tool OR by the "ReadFullDocsMethodSchema" tool - i.e based on the API docs, a relevant recipe you read (preferably), a code example you found in the docs, a schema you read etc.. YOU MUST NEVER ASSUME YOU KNOW WHAT THE BODY SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT. Prefer reading relevant recipes if you have them in context for understand the body schema for API calls.',
@@ -83,8 +85,8 @@ export const paramDescriptions = {
         searchTerm: 'The search term to search for in the Build Apps Documentation',
         maxResults: 'The maximum number of results to return, default is 10, max is 15'
     },
-    SearchOverviewDocumentation: {
-        searchTerm: 'The search term to search for in the Wix Overview Documentation',
+    SearchDevelopmentDocumentation: {
+        searchTerm: 'The development-related search term. Use only after a more specific docs search (REST/SDK/CLI/Build Apps/Headless/WDS) came back empty.',
         maxResults: 'The maximum number of results to return, default is 10, max is 15'
     },
     SearchWixHeadlessDocumentation: {

package/build/dts/docs/docs.js

@@ -399,11 +399,11 @@ export const addDocsTools = (server, allowedTools = [
             }
         });
     }
-    // Overview Documentation
+    // Development Documentation
     if (allowedTools.includes('OVERVIEW') &&
-        !disableTools?.includes('SearchOverviewDocumentation')) {
-        server.tool('SearchOverviewDocumentation', getDescription('SearchOverviewDocumentation', defaultToolDescriptions.SearchOverviewDocumentation ?? ''), (() => {
-            const d = desc('SearchOverviewDocumentation');
+        !disableTools?.includes('SearchDevelopmentDocumentation')) {
+        server.tool('SearchDevelopmentDocumentation', getDescription('SearchDevelopmentDocumentation', defaultToolDescriptions.SearchDevelopmentDocumentation ?? ''), (() => {
+            const d = desc('SearchDevelopmentDocumentation');
             return {
                 searchTerm: z.string().describe(d.searchTerm),
                 maxResults: z
@@ -438,8 +438,8 @@ export const addDocsTools = (server, allowedTools = [
                 panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
-                        componentId: 'SearchOverviewDocumentation',
-                        toolName: 'SearchOverviewDocumentation'
+                        componentId: 'SearchDevelopmentDocumentation',
+                        toolName: 'SearchDevelopmentDocumentation'
                     }
                 });
                 logger.error(`Error searching for ${searchTerm} in Wix Overview: ${error}`);

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

@@ -6,7 +6,7 @@ import { wixMcpRequestSrc39Evid1607, executeWixApiToolRequestSrc39Evid1612 } fro
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult): string | undefined;
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): 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,7 @@ export function extractText(result) {
         .join('\n');
 }
 const TOOL_RESULT_PREVIEW_MAX_CHARS = 4000;
-export function formatToolResultAdditionalFields(result) {
+export function formatToolResultAdditionalFields(result, extras) {
     const resultText = extractText(result);
     const contentTypes = [
         ...new Set(result.content?.map((content) => content.type) ?? [])
@@ -23,7 +23,8 @@ export function formatToolResultAdditionalFields(result) {
         resultPreview: resultText.slice(0, TOOL_RESULT_PREVIEW_MAX_CHARS),
         resultTextLength: resultText.length,
         resultPreviewTruncated: resultText.length > TOOL_RESULT_PREVIEW_MAX_CHARS,
-        resultContentTypes: contentTypes
+        resultContentTypes: contentTypes,
+        ...extras
     });
 }
 export function createToolBiEvent(params) {

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

@@ -169,7 +169,7 @@ export interface ToolHintsConfig {
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult): string | undefined;
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): 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

@@ -169,7 +169,7 @@ export interface ToolHintsConfig {
  * and concatenates text blocks with newlines.
  */
 export declare function extractText(result: WixToolCallResult): string;
-export declare function formatToolResultAdditionalFields(result: WixToolCallResult): string | undefined;
+export declare function formatToolResultAdditionalFields(result: WixToolCallResult, extras?: Record<string, unknown>): 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

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

package/build/dts/wix-mcp-server.d.ts

@@ -17,6 +17,8 @@ interface ToolBiParams {
     conversationId?: string;
     projectId?: string;
     assetId?: string;
+    returnedRows?: number;
+    originalLength?: number;
 }
 type WixRequestHandlerExtra = RequestHandlerExtra<any, any> & {
     logger: Logger;

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

@@ -175,7 +175,10 @@ export class WixMcpServer extends McpServer {
                     errorBody = extractText(cbResult);
                 }
                 else {
-                    additionalFields = formatToolResultAdditionalFields(cbResult);
+                    additionalFields = formatToolResultAdditionalFields(cbResult, {
+                        returnedRows: toolBiParams.returnedRows,
+                        originalLength: toolBiParams.originalLength
+                    });
                 }
                 if (toolSucceeded && !isDevEnvironment) {
                     panorama.transaction(toolName).finish({ toolInvocationId });