@wix/mcp 1.0.80 → 1.0.82

package/build/esm/index.js

@@ -29740,7 +29740,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(
@@ -29756,7 +29756,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) {
@@ -29817,6 +29818,11 @@ var WixMcpServer = class extends McpServer {
   isMcpAppsInMcpEnabled() {
     return this.mcpAppsInMcpEnabled;
   }
+  /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+  isMicrosoftCopilotClient() {
+    const clientName = this.getClientName?.()?.toLowerCase() ?? "";
+    return clientName.includes("sydney") || clientName.includes("copilot");
+  }
   shouldRenderMcpApps() {
     const clientName = this.getClientName?.()?.toLowerCase();
     const isOpenAi = clientName?.includes("openai") ?? false;
@@ -29932,7 +29938,10 @@ var WixMcpServer = class extends McpServer {
         if (!toolSucceeded) {
           errorBody = extractText(cbResult);
         } else {
-          additionalFields = formatToolResultAdditionalFields(cbResult);
+          additionalFields = formatToolResultAdditionalFields(cbResult, {
+            returnedRows: toolBiParams.returnedRows,
+            originalLength: toolBiParams.originalLength
+          });
         }
         if (toolSucceeded && !isDevEnvironment) {
           panorama.transaction(toolName).finish({ toolInvocationId });
@@ -30836,6 +30845,9 @@ function rethrowIfUnauthorized(error2) {
   }
 }
 
+// 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.
@@ -30935,6 +30947,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -30957,11 +30971,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`
@@ -30977,6 +30993,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.
@@ -31264,7 +31281,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -31297,8 +31315,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.
@@ -31663,6 +31683,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -31950,14 +31971,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}**`);
@@ -32104,6 +32131,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",
@@ -32121,7 +32149,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname2) => hostname2 === "wix.com" || hostname2.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname2 = window.location?.hostname;
+  return typeof hostname2 === "string" && isWixHost(hostname2) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -32138,8 +32175,8 @@ async function getDynamicContext(auth, httpClient6, 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;
@@ -32173,7 +32210,7 @@ async function getDynamicContext(auth, httpClient6, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient6.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,
@@ -32253,7 +32290,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.',
@@ -32326,8 +32364,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: {
@@ -33134,15 +33172,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 d2 = desc("SearchOverviewDocumentation");
+        const d2 = desc("SearchDevelopmentDocumentation");
         return {
           searchTerm: external_exports.string().describe(d2.searchTerm),
           maxResults: external_exports.number().describe(d2.maxResults).min(1).max(15).optional().default(15)
@@ -33172,8 +33210,8 @@ var addDocsTools = (server, allowedTools = [
           panorama.errorMonitor().reportError(error2);
           captureException(error2, {
             tags: {
-              componentId: "SearchOverviewDocumentation",
-              toolName: "SearchOverviewDocumentation"
+              componentId: "SearchDevelopmentDocumentation",
+              toolName: "SearchDevelopmentDocumentation"
             }
           });
           logger2.error(
@@ -33992,6 +34030,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 {
@@ -33999,13 +34050,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 = [
@@ -34068,9 +34121,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: [
@@ -34209,7 +34267,7 @@ function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "Lis
         destructiveHint: true,
         openWorldHint: false
       }),
-      async ({ url, body, method, reason }, { httpClient: httpClient6 }) => {
+      async ({ url, body, method, reason }, { httpClient: httpClient6, setToolBiParams }) => {
         logger2.log(
           `Calling Wix Account level API: ${url}, reason="${reason}", body: ${JSON.stringify(body)}`
         );
@@ -34238,6 +34296,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: [
@@ -34599,9 +34661,18 @@ var SITE_CREATION_CUSTOM_ACTIONS_GUIDANCE = `2\u20133 specific, high-value setup
 * Events / Weddings / Real Estate: "add event schedules, display listings, and manage RSVP forms"
 * General / Unspecified: "${SITE_CREATION_DEFAULT_ACTIONS}"
 If none of these patterns fit the site, infer 2\u20133 actions that suit what that kind of business would manage on its site.`;
-function buildSiteCreationSelectorMessage(siteType, customActions) {
+function buildSiteCreationSelectorMessage(siteType, customActions, { plain = false } = {}) {
   const type = (siteType ?? "").trim() || "new";
   const actions = (customActions ?? "").trim() || SITE_CREATION_DEFAULT_ACTIONS;
+  const body = `Ready to set up your ${type} site? Choose your path in the widget above:
+
+* **Build with AI** for a custom, tailor-made layout
+* **Pick a template** to start with a pre-designed layout
+
+**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+  if (plain) {
+    return body;
+  }
   return `You are the assistant replying to the user \u2014 say this message out loud in chat (do NOT stay silent, and do NOT just point at the widget). Your reply is only complete if it includes ALL of the following, word for word, each on its own line and in this order:
 1. "Ready to set up your ${type} site? Choose your path in the widget above:" \u2014 keep the "Choose your path in the widget above:" part.
 2. "* **Build with AI** for a custom, tailor-made layout"
@@ -34610,12 +34681,7 @@ function buildSiteCreationSelectorMessage(siteType, customActions) {
 
 Copy those four lines as written; do not summarize, shorten, reorder, or reword any of them. Here is the full message to send:
 
-Ready to set up your ${type} site? Choose your path in the widget above:
-
-* **Build with AI** for a custom, tailor-made layout
-* **Pick a template** to start with a pre-designed layout
-
-**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+${body}`;
 }
 var OPENAI_WIDGET_MIME_TYPE = "text/html+skybridge";
 var SITE_WIDGET_MCP_CSP = {
@@ -41570,7 +41636,7 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
           `The prompt to build the site. If not provided, the user will be asked to provide a prompt.`
         ),
         suggestedSiteName: external_exports.string().optional().describe(
-          "Suggested site name to use for the site based on the site prompt."
+          "You must provide this on every call, including updates to an existing job, in English. A short name for the site: the business name the user gave, or one you derive from the site prompt."
         )
       },
       _meta: toolDefinitionMeta,
@@ -41727,6 +41793,10 @@ async function buildHarmonySite({
 
 // src/site-widget-tools/suggested-domain-tool/index.ts
 var WIX_APIS_BASE_URL3 = "https://www.wixapis.com";
+var DEFAULT_SITE_NAME = /^my site(\s+\d+)?$/i;
+function isDefaultSiteName(siteName) {
+  return DEFAULT_SITE_NAME.test(siteName.trim());
+}
 async function fetchSiteDisplayName(siteAuthorization, siteId) {
   const response = await fetch(
     `${WIX_APIS_BASE_URL3}/site-properties/v4/properties`,
@@ -41751,7 +41821,15 @@ function addSuggestedDomainTool(server, authStrategy) {
     GET_SUGGESTED_DOMAINS_TOOL_NAME,
     {
       title: "Get Suggested Domains",
-      description: 'Suggest available domain names. Provide either a free-text query (e.g. "pancakes business", "modern yoga studio") OR a siteId to auto-suggest based on the site name. At least one of query or siteId is required.',
+      description: dedent_default`
+        Suggests available domain names for a business, brand, or Wix site.
+
+        Call this when the user asks for domain name ideas, wants to know which domains are available, or wants a domain for a new or existing site.
+
+        Provide either a free-text \`query\` (the user's own words, e.g. "pancakes business", "modern yoga studio") OR a \`siteId\` to base the suggestions on that site's name. At least one of them is required.
+
+        Present the returned domains to the user as a short list. This tool only suggests domains — it does not purchase or connect them.
+      `,
       inputSchema: {
         query: zod_default.string().optional().describe(
           "Free-text keywords, business idea, or brand concept to base suggestions on. Use the user's own words."
@@ -41771,10 +41849,11 @@ function addSuggestedDomainTool(server, authStrategy) {
       },
       _meta: {
         securitySchemes: [{ type: "oauth2", scopes: ["offline_access"] }],
-        ui: { visibility: ["app"] },
+        // Model-visible so hosts (e.g. Microsoft 365 Copilot) can call it directly and show it
+        // in their debug info; 'app' keeps it callable from the site-builder widget.
+        ui: { visibility: ["app", "model"] },
         "openai/toolInvocation/invoking": "Fetching suggested domains",
-        "openai/toolInvocation/invoked": "Suggested domains retrieved",
-        "openai/visibility": "private"
+        "openai/toolInvocation/invoked": "Suggested domains retrieved"
       }
     },
     async (args, { panorama }) => {
@@ -41822,7 +41901,9 @@ function addSuggestedDomainTool(server, authStrategy) {
                 structuredContent: { domains: [] }
               };
             }
-            resolvedQuery = siteName;
+            if (!isDefaultSiteName(siteName) || !resolvedQuery) {
+              resolvedQuery = siteName;
+            }
           } catch (error2) {
             panorama.logger().error(
               `[getSuggestedDomains] Error fetching site name for siteId: ${siteId}`,
@@ -42278,7 +42359,8 @@ function addWixSiteCreationTool(server, _authStrategy, options) {
       };
       const message = buildSiteCreationSelectorMessage(
         args.query,
-        args.customActions
+        args.customActions,
+        { plain: server.isMicrosoftCopilotClient() }
       );
       return withJsonContent({
         content: [
@@ -43232,7 +43314,6 @@ function listAssetsByProjectId(payload) {
 // src/wixel/constants.ts
 var WIXEL_ASSISTANT_V1_NO_ENTITY_API_BASE_URL = "https://manage.wix.com/";
 var WWW_ASSET_V1_ASSET_API_BASE_URL = "https://manage.wix.com/";
-var HARMONY_SITE_BUILDER_API_BASE_URL = "https://manage.wix.com/";
 var WIXEL_AGENT_EXTERNAL_API_BASE_URL = "https://manage.wix.com/";
 var WIXEL_WIDGET_URI = "ui://widget/wixel-widget.html";
 var WIXEL_ICON_PNG_URL = "https://wixmp-e9a92e1fa066d7bc836e4d31.wixmp.com/logos/wixel-icon-180.png";
@@ -43349,87 +43430,6 @@ async function queryAssets({
   } = await httpClient6.request(listAssetsByProjectId({ projectId }));
   return { assets };
 }
-async function openHeadlessWixelProject({
-  accountAuthHeaders,
-  apiBaseURL = HARMONY_SITE_BUILDER_API_BASE_URL,
-  url,
-  userPrompt,
-  jobId,
-  siteId,
-  projectId,
-  conversationId,
-  withScreenshots,
-  useProvidedCookies,
-  timeout,
-  conductorOverride
-}) {
-  const httpClient6 = createHttpClient2({
-    headers: {
-      ...COMMON_HEADERS,
-      ...accountAuthHeaders,
-      ...conductorOverride ? { ...CONDUCTOR_OVERRIDE_HEADERS } : {},
-      "Content-Type": "application/json"
-    },
-    baseURL: apiBaseURL
-  });
-  const response = await httpClient6.post(
-    "/_api/harmony-site-builder/open-wixel-project",
-    {
-      url,
-      userPrompt,
-      jobId,
-      siteId,
-      projectId,
-      conversationId,
-      withScreenshots,
-      useProvidedCookies,
-      timeout
-    }
-  );
-  return response.data;
-}
-async function updateHeadlessWixelJob({
-  accountAuthHeaders,
-  job,
-  apiBaseURL = HARMONY_SITE_BUILDER_API_BASE_URL,
-  conductorOverride
-}) {
-  const httpClient6 = createHttpClient2({
-    headers: {
-      ...COMMON_HEADERS,
-      ...accountAuthHeaders,
-      ...conductorOverride ? { ...CONDUCTOR_OVERRIDE_HEADERS } : {},
-      "Content-Type": "application/json"
-    },
-    baseURL: apiBaseURL
-  });
-  const response = await httpClient6.post(
-    "/_api/harmony-site-builder/update-wixel-job",
-    { job }
-  );
-  return response.data;
-}
-async function pullHeadlessWixelJob({
-  accountAuthHeaders,
-  apiBaseURL = HARMONY_SITE_BUILDER_API_BASE_URL,
-  jobId,
-  conductorOverride
-}) {
-  const httpClient6 = createHttpClient2({
-    headers: {
-      ...COMMON_HEADERS,
-      ...accountAuthHeaders,
-      ...conductorOverride ? { ...CONDUCTOR_OVERRIDE_HEADERS } : {},
-      "Content-Type": "application/json"
-    },
-    baseURL: apiBaseURL
-  });
-  const response = await httpClient6.post(
-    "/_api/harmony-site-builder/pull-wixel-job",
-    { jobId }
-  );
-  return response.data;
-}
 async function getStylePresetsByIds2({
   siteAuthHeaders,
   stylePresetIds,
@@ -43749,240 +43749,6 @@ function addGetWixelProjectAssetsTool(server, authStrategy, options = {}) {
   );
 }
 
-// src/wixel/update-headless-wixel-job-tool.ts
-var TOOL_NAME5 = "updateHeadlessWixelJob";
-var TOOL_TITLE5 = "Update Headless Wixel Job";
-var TOOL_DESCRIPTION5 = `Update the status and data of a headless Wixel job.`;
-var TOOL_META5 = {
-  ui: { visibility: ["app"] }
-};
-var wixelJobStatusSchema = external_exports.enum([
-  "STARTED",
-  "IN_PROGRESS",
-  "COMPLETED",
-  "FAILED",
-  "CANCELLED"
-]);
-function addUpdateHeadlessWixelJobTool(server, authStrategy, options = {}) {
-  const { getAccountAuthHeaders } = authStrategy;
-  vD(
-    server,
-    TOOL_NAME5,
-    {
-      title: TOOL_TITLE5,
-      description: TOOL_DESCRIPTION5,
-      inputSchema: {
-        id: external_exports.string().describe("The job ID"),
-        status: wixelJobStatusSchema.describe("The job status"),
-        userPrompt: external_exports.string().optional().describe("The user prompt for the job"),
-        shouldRefresh: external_exports.boolean().optional().describe("Whether the job should refresh"),
-        errorMessage: external_exports.string().optional().describe("Error message if the job failed"),
-        type: external_exports.string().optional().describe("The type of asset being created"),
-        data: external_exports.object({
-          siteId: external_exports.string().optional().describe("The site ID"),
-          assetId: external_exports.string().optional().describe("The asset ID"),
-          projectId: external_exports.string().optional().describe("The project ID"),
-          conversationId: external_exports.string().optional().describe("The conversation ID")
-        }).optional().describe("Additional job data"),
-        userId: external_exports.string().optional().describe("The user ID"),
-        accountId: external_exports.string().optional().describe("The account ID")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: true,
-        openWorldHint: false
-      },
-      _meta: TOOL_META5
-    },
-    async (args) => {
-      try {
-        const accountAuthHeaders = await getAccountAuthHeaders();
-        const result = await updateHeadlessWixelJob({
-          accountAuthHeaders,
-          conductorOverride: options.conductorOverride,
-          job: {
-            id: args.id,
-            status: args.status,
-            userPrompt: args.userPrompt,
-            shouldRefresh: args.shouldRefresh,
-            errorMessage: args.errorMessage,
-            type: args.type,
-            data: args.data,
-            userId: args.userId,
-            accountId: args.accountId
-          }
-        });
-        return {
-          isError: false,
-          content: [
-            {
-              type: "text",
-              text: `Headless Wixel job ${args.id} updated to status: ${args.status}`
-            }
-          ],
-          structuredContent: {
-            jobId: args.id,
-            status: args.status,
-            ...result
-          }
-        };
-      } catch (error2) {
-        console.error("\u274C Error updating headless Wixel job:", error2);
-        const errorMessage = error2.message;
-        return {
-          isError: true,
-          content: [{ type: "text", text: errorMessage }],
-          structuredContent: {
-            success: false,
-            error: errorMessage
-          }
-        };
-      }
-    }
-  );
-}
-
-// src/wixel/pull-headless-wixel-job-tool.ts
-var TOOL_NAME6 = "pullHeadlessWixelJob";
-var TOOL_TITLE6 = "Pull Headless Wixel Job";
-var TOOL_DESCRIPTION6 = `Pull the next available headless Wixel job.`;
-var TOOL_META6 = {
-  ui: { visibility: ["app"] }
-};
-function addPullHeadlessWixelJobTool(server, authStrategy, options = {}) {
-  const { getAccountAuthHeaders } = authStrategy;
-  vD(
-    server,
-    TOOL_NAME6,
-    {
-      title: TOOL_TITLE6,
-      description: TOOL_DESCRIPTION6,
-      inputSchema: {
-        jobId: external_exports.string().describe("The job ID")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        openWorldHint: false
-      },
-      _meta: TOOL_META6
-    },
-    async (args) => {
-      try {
-        const accountAuthHeaders = await getAccountAuthHeaders();
-        const result = await pullHeadlessWixelJob({
-          accountAuthHeaders,
-          jobId: args.jobId,
-          conductorOverride: options.conductorOverride
-        });
-        return {
-          isError: false,
-          content: [
-            {
-              type: "text",
-              text: result.job ? `Pulled headless Wixel job: ${result.job.id}` : "No headless Wixel job available"
-            }
-          ],
-          structuredContent: {
-            ...result
-          }
-        };
-      } catch (error2) {
-        console.error("\u274C Error pulling headless Wixel job:", error2);
-        const errorMessage = error2.message;
-        return {
-          isError: true,
-          content: [{ type: "text", text: errorMessage }],
-          structuredContent: {
-            success: false,
-            error: errorMessage
-          }
-        };
-      }
-    }
-  );
-}
-
-// src/wixel/open-headless-wixel-project-tool.ts
-var TOOL_NAME7 = "openHeadlessWixelProject";
-var TOOL_TITLE7 = "Open Headless Wixel Project";
-var TOOL_DESCRIPTION7 = `Open a headless Wixel project for background asset generation.`;
-var TOOL_META7 = {
-  ui: { visibility: ["app"] }
-};
-function addOpenHeadlessWixelProjectTool(server, authStrategy, options = {}) {
-  const { getAccountAuthHeaders } = authStrategy;
-  vD(
-    server,
-    TOOL_NAME7,
-    {
-      title: TOOL_TITLE7,
-      description: TOOL_DESCRIPTION7,
-      inputSchema: {
-        url: external_exports.string().describe("The URL of the Wixel project"),
-        userPrompt: external_exports.string().describe("The user prompt for the project"),
-        jobId: external_exports.string().describe("The job ID"),
-        siteId: external_exports.string().describe("The site ID"),
-        projectId: external_exports.string().describe("The project ID"),
-        conversationId: external_exports.string().describe("The conversation ID"),
-        withScreenshots: external_exports.boolean().optional().describe("Whether to include screenshots"),
-        useProvidedCookies: external_exports.boolean().optional().describe("Whether to use provided cookies"),
-        timeout: external_exports.number().optional().describe("Timeout in milliseconds")
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: true,
-        openWorldHint: false
-      },
-      _meta: TOOL_META7
-    },
-    async (args) => {
-      try {
-        const accountAuthHeaders = await getAccountAuthHeaders();
-        const result = await openHeadlessWixelProject({
-          accountAuthHeaders,
-          url: args.url,
-          userPrompt: args.userPrompt,
-          jobId: args.jobId,
-          siteId: args.siteId,
-          projectId: args.projectId,
-          conversationId: args.conversationId,
-          withScreenshots: args.withScreenshots,
-          useProvidedCookies: args.useProvidedCookies,
-          timeout: args.timeout,
-          conductorOverride: options.conductorOverride
-        });
-        return {
-          isError: false,
-          content: [
-            {
-              type: "text",
-              text: `Headless Wixel project opened for job ${args.jobId}`
-            }
-          ],
-          structuredContent: {
-            success: true,
-            jobId: args.jobId,
-            projectId: args.projectId,
-            ...result
-          }
-        };
-      } catch (error2) {
-        console.error("\u274C Error opening headless Wixel project:", error2);
-        const errorMessage = error2.message;
-        return {
-          isError: true,
-          content: [{ type: "text", text: errorMessage }],
-          structuredContent: {
-            success: false,
-            error: errorMessage
-          }
-        };
-      }
-    }
-  );
-}
-
 // ../../node_modules/@wix/ambassador-www-wixel-agent-v1-external-agent/es/build/http.impl.js
 init_ambassador_index();
 init_build();
@@ -44321,7 +44087,7 @@ async function getWixelPendingQuestion({
 }
 
 // src/wixel/wixel-session-tools.ts
-var TOOL_META8 = {
+var TOOL_META5 = {
   ui: { visibility: ["app", "model"] }
 };
 function buildWixelEditorUrl(metaSiteId, projectId) {
@@ -44630,7 +44396,7 @@ Without arguments Wixel provisions a new project and session. Pass metaSiteId to
         destructiveHint: false,
         openWorldHint: false
       },
-      _meta: TOOL_META8
+      _meta: TOOL_META5
     },
     async (args, extra) => {
       setWixelToolBi(extra, {
@@ -44724,7 +44490,7 @@ Send the user's request as THEY phrased it. Do NOT add creative direction they d
         destructiveHint: true,
         openWorldHint: false
       },
-      _meta: TOOL_META8
+      _meta: TOOL_META5
     },
     async (args, extra) => {
       setWixelToolBi(extra, {
@@ -44825,7 +44591,7 @@ Event types: "reply" (the agent's answer), "failed" (the turn failed), and "user
         destructiveHint: false,
         openWorldHint: false
       },
-      _meta: TOOL_META8
+      _meta: TOOL_META5
     },
     async (args, extra) => {
       setWixelToolBi(extra, {
@@ -44995,7 +44761,7 @@ function addGetWixelStylePresetsTool(server, authStrategy, options = {}) {
         destructiveHint: false,
         openWorldHint: false
       },
-      _meta: TOOL_META8
+      _meta: TOOL_META5
     },
     async (args, extra) => {
       setWixelToolBi(extra, { siteId: args.metaSiteId });
@@ -45298,9 +45064,6 @@ function addWixelTools(server, authStrategy, options = {}) {
   addMarkWixelJobAsFulfilledTool(server, authStrategy, options);
   addGetWixelAssetTool(server, authStrategy, options);
   addGetWixelProjectAssetsTool(server, authStrategy, options);
-  addUpdateHeadlessWixelJobTool(server, authStrategy, options);
-  addOpenHeadlessWixelProjectTool(server, authStrategy, options);
-  addPullHeadlessWixelJobTool(server, authStrategy, options);
   addWixelSessionTools(server, authStrategy, options);
 }
 
@@ -45453,10 +45216,14 @@ function addImportClaudeDesignTool(server, authStrategy, options) {
       try {
         designUrl = new URL(args.url);
       } catch {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       if (designUrl.protocol !== "https:" || !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       const accountHeaders = await authStrategy.getAccountAuthHeaders();
       const wixstroOptions = { baseUrl: wixstroBaseUrl, accountHeaders };
@@ -45737,10 +45504,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) }
@@ -45850,7 +45620,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);
         logger2.log(
@@ -46095,7 +45869,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) {
@@ -46253,8 +46030,6 @@ export {
   addImportClaudeDesignTool,
   addListWixelEventsTool,
   addMarkWixelJobAsFulfilledTool,
-  addOpenHeadlessWixelProjectTool,
-  addPullHeadlessWixelJobTool,
   addPullSiteJobTool,
   addSearchCodeModeTool,
   addSearchSiteTemplatesTool,
@@ -46262,7 +46037,6 @@ export {
   addSiteCreationWidgetTools,
   addStartWixelSessionTool,
   addSupportTool,
-  addUpdateHeadlessWixelJobTool,
   addWixSiteCreationTool,
   addWixelSessionTools,
   addWixelTools,