@wix/mcp 1.0.95 → 1.0.96

package/build/esm/toolkit.js

@@ -12018,6 +12018,140 @@ async function fetchPlatformizedMenu(menuUrl) {
   return data.content;
 }
 
+// src/docs/guessed-url.ts
+var SKILLS_BASE = "https://www.wix.com/skills/";
+var registryUrl = (url) => normalizeSkillsUrl(url).replace(
+  /^https:\/\/(?:dev\.wix\.com(?:\/docs)?|www\.wix\.com\/velo\/reference)\/skills\//,
+  SKILLS_BASE
+);
+var DOCS_BASE = "https://dev.wix.com/docs/";
+var FILLER = /* @__PURE__ */ new Set([
+  "",
+  "md",
+  "a",
+  "an",
+  "the",
+  "and",
+  "or",
+  "of",
+  "to",
+  "wix",
+  "s"
+]);
+var slugWords = (slug) => new Set(
+  slug.toLowerCase().replace(/\.md$/, "").split(/[^a-z0-9]+/).filter((w) => !FILLER.has(w)).map((w) => w.length > 3 && w.endsWith("s") ? w.slice(0, -1) : w)
+);
+function slugSimilarity(a, b) {
+  const x = slugWords(a);
+  const y = slugWords(b);
+  if (x.size === 0 || y.size === 0) return 0;
+  let shared = 0;
+  for (const w of x) if (y.has(w)) shared++;
+  return shared / (x.size + y.size - shared);
+}
+var lastSegment = (path) => path.slice(path.lastIndexOf("/") + 1);
+var folderOf = (path) => path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
+var SKILL_FILE_MATCH = 0.5;
+function closestSkillFile(url, manifest, manifestUrl) {
+  const normalized = registryUrl(url).replace(/[?#].*$/, "");
+  if (!normalized.startsWith(SKILLS_BASE)) return null;
+  const [, ...rest] = normalized.slice(SKILLS_BASE.length).split("/");
+  const asked = rest.join("/");
+  const paths = (manifest.files ?? []).map((f) => f.path);
+  if (!asked || paths.length === 0) return null;
+  const base = manifest.base ?? manifestUrl.replace(/\.manifest\.json$/, "/");
+  const name = lastSegment(asked);
+  const folder = folderOf(asked);
+  const sameName = paths.filter((p) => lastSegment(p) === name);
+  if (sameName.length === 1) {
+    return { kind: "file", path: sameName[0], url: base + sameName[0] };
+  }
+  const ranked = paths.filter((p) => folderOf(p) === folder).map((p) => ({ p, score: slugSimilarity(lastSegment(p), name) })).sort((a, b) => b.score - a.score);
+  const [best, next] = ranked;
+  if (best && best.score >= SKILL_FILE_MATCH && best.score > (next?.score ?? 0)) {
+    return { kind: "file", path: best.p, url: base + best.p };
+  }
+  if (ranked.length > 0) {
+    return {
+      kind: "folder",
+      folder,
+      files: ranked.map((r) => base + r.p),
+      manifestUrl
+    };
+  }
+  const top = [...new Set(paths.map((p) => p.split("/")[0]))].sort();
+  return {
+    kind: "folder",
+    folder: "",
+    files: top.map((t) => base + t),
+    manifestUrl
+  };
+}
+function skillManifestUrl(url) {
+  const normalized = registryUrl(url);
+  if (!normalized.startsWith(SKILLS_BASE)) return null;
+  const skill = normalized.slice(SKILLS_BASE.length).split(/[/?#]/)[0];
+  return skill ? `${SKILLS_BASE}${skill}.manifest.json` : null;
+}
+var MENU_WALK_UP_LEVELS = 3;
+var MIN_MENU_SEGMENTS = 3;
+function parentMenuUrls(url) {
+  const clean = url.replace(/[?#].*$/, "").replace(/\/+$/, "");
+  if (!clean.startsWith(DOCS_BASE)) return [];
+  const segments = clean.slice(DOCS_BASE.length).split("/");
+  const out = [];
+  for (let up = 1; up <= MENU_WALK_UP_LEVELS; up++) {
+    const kept = segments.length - up;
+    if (kept < MIN_MENU_SEGMENTS) break;
+    out.push(DOCS_BASE + segments.slice(0, kept).join("/"));
+  }
+  return out;
+}
+function closestMenuLinks(menuText, menuUrl, askedUrl, limit = 3) {
+  const asked = lastSegment(
+    askedUrl.replace(/[?#].*$/, "").replace(/\/+$/, "")
+  );
+  const under = `${menuUrl.replace(/\/+$/, "")}/`;
+  const links = [
+    ...new Set(
+      menuText.match(/https:\/\/dev\.wix\.com\/docs\/[^\s)\]>"'`]+/g) ?? []
+    )
+  ].filter((l) => l.startsWith(under));
+  return links.map((l) => ({
+    l,
+    score: slugSimilarity(lastSegment(l.replace(/\.md$/, "")), asked)
+  })).filter((r) => r.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((r) => r.l);
+}
+var SMALL_MENU = 3;
+var MENU_ENTRY_MATCH = 0.75;
+function subMenusToRead(menuText, menuUrl, askedUrl, limit = 2) {
+  const asked = lastSegment(
+    askedUrl.replace(/[?#].*$/, "").replace(/\/+$/, "")
+  );
+  const under = `${menuUrl.replace(/\/+$/, "")}/`;
+  const methods = new Set(
+    [
+      ...menuText.matchAll(
+        /\]\((https:\/\/dev\.wix\.com\/docs\/[^)\s]+)\)\s*_\((?:GET|POST|PUT|PATCH|DELETE)\)_/g
+      )
+    ].map((m) => m[1])
+  );
+  const entries = [
+    ...new Set(
+      menuText.match(/https:\/\/dev\.wix\.com\/docs\/[^\s)\]>"'`]+/g) ?? []
+    )
+  ].filter(
+    (l) => l.startsWith(under) && !l.slice(under.length).replace(/\.md$/, "").includes("/") && !methods.has(l)
+  );
+  const scored = entries.map((l) => ({
+    l,
+    score: slugSimilarity(lastSegment(l.replace(/\.md$/, "")), asked)
+  })).sort((a, b) => b.score - a.score);
+  if (scored.some((s) => s.score >= MENU_ENTRY_MATCH)) return [];
+  if (entries.length <= SMALL_MENU) return entries;
+  return scored.filter((s) => s.score > 0).slice(0, limit).map((s) => s.l);
+}
+
 // ../../node_modules/dedent/dist/dedent.mjs
 function ownKeys(object, enumerableOnly) {
   var keys = Object.keys(object);
@@ -12222,7 +12356,8 @@ var DISCOVERY_FLOWS = [
 function directRouteLines(includeReadme, includeImageUploadGuidance) {
   return [
     ...includeReadme ? [
-      `- **Creating a new site.** Skip the docs too. A site is written in code and uploaded: StartDeployWebsite returns the upload guide; StartHeadlessBuild returns the headless guide, for a site that needs Wix business features (${WIX_BUSINESS_FEATURES}). Call one right away, without asking the user anything first: StartHeadlessBuild when the site needs Wix business features, otherwise StartDeployWebsite. WixSiteBuilder or SearchSiteTemplates only when the user asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor. Never create a site through ManageWixSite, CallWixSiteAPI or ExecuteWixAPI.`
+      `- **Creating a new site.** Skip the docs too. A site is written in code and uploaded: StartDeployWebsite returns the upload guide; StartHeadlessBuild returns the headless guide, for a site that needs Wix business features (${WIX_BUSINESS_FEATURES}). Call one right away, without asking the user anything first: StartHeadlessBuild when the site needs Wix business features, otherwise StartDeployWebsite. WixHarmonyEditorBuild or SearchSiteTemplates only when the user asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor. Never create a site through ManageWixSite, CallWixSiteAPI or ExecuteWixAPI.`,
+      "- **Suggesting domain names**: call GetSuggestedDomains directly, with the business or site name as the query."
     ] : [],
     "- **Listing, showing or finding their Wix sites**: call ListWixSites directly.",
     ...includeImageUploadGuidance ? [
@@ -12296,7 +12431,7 @@ var toWidget = (text) => Object.values(SITE_CREATION_COPY).reduce(
   (acc, { nonWidget, widget }) => acc.replaceAll(nonWidget, widget),
   text
 );
-var WIX_API_DATA = "products, inventory, carts, checkouts, orders, bookings, services, staff, time slots, rentals, restaurant menus, online orders, reservations, events, tickets, RSVPs, blog posts, CMS collections and items, pricing plans, subscriptions, portfolios, gift cards, coupons, donations, forms, form submissions, contacts, members, loyalty points, groups, reviews, inbox messages, CRM tasks, automations, email campaigns, payments, invoices, SEO, redirects, translations, locations, analytics, media files, site properties, installed apps, and the account's sites and domains";
+var WIX_API_DATA = "products, inventory, carts, checkouts, orders, bookings, services, staff, time slots, rentals, restaurant menus, online orders, reservations, events, tickets, RSVPs, blog posts, CMS collections and items, pricing plans, subscriptions, portfolios, gift cards, coupons, donations, forms, form submissions, contacts, members, loyalty points, groups, reviews, inbox messages, CRM tasks, automations, email campaigns, payments, invoices, SEO, redirects, translations, locations, analytics, media files, site properties, installed apps, and the account's sites and domains (searching whether a domain is available, buying one, and connecting one bought elsewhere)";
 var EXECUTE_WIX_API_INTRO = dedent_default`
   Reads and changes the data of a Wix site or account: query, list, count, create, update and delete it with one JavaScript function over the Wix REST API.
   One function holds the whole task: chained calls, pagination, loops, branching, and the reads that feed its writes.
@@ -12612,8 +12747,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true,
     ${reminder}
   `,
     ManageWixSite: dedent_default`
-    Use account level API in order to update a site.
-    Account-level only: this tool acts on the account itself, or on sites as objects within it, and sends no site context. Anything that reads or writes inside a site is site-level and does not belong here — use a site-level tool with that site's \`siteId\`.
+    Calls an account-level Wix API: one that acts on the account itself (its sites list, domains, account settings) or on sites as objects in it (create, rename, duplicate, delete a site). It sends no site, so an API that reads or writes inside a site (its products, data, bookings, members, pages, publishing) fails here: call that through ExecuteWixAPI with the site's \`siteId\`.
     For POST/PATCH/PUT requests, pass the request body as a JSON object or array in the "body" parameter with all the required fields and values as described in the API schema, code examples, or docs you retrieved (e.g. body: {"name": "value", "nested": {"key": "value"}} or body: [{"key": "value"}]).
     The API endpoint url param MUST ALWAYS be taken from the conversation context.
     By conversation context we mean the endpoint url was given in the user prompt or got into the conversation context ${includeReadme ? 'by the "WixREADME" tool or ' : ""}by the "SearchWixRESTDocumentation" tool or by the "BrowseWixRESTDocsMenu" tool or by the "ReadFullDocsArticle" tool.
@@ -12683,7 +12817,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true,
     ${reminder}
   `,
     WixSiteCreation: dedent_default`
-    A new Wix site is written in code and uploaded: call StartDeployWebsite for the upload guide, or StartHeadlessBuild when the site needs Wix business features. WixSiteBuilder or SearchSiteTemplates only when the user asked for the Wix Harmony Editor, a template, Wix Studio or the Classic Editor.
+    Returns which Wix tool creates a new site, and creates nothing itself. A new site is written in code and uploaded: StartDeployWebsite returns the upload guide, and StartHeadlessBuild returns the guide for a site that needs Wix business features. Use WixHarmonyEditorBuild or SearchSiteTemplates only when the user asked for Wix's editor, a template, Wix Studio or the Classic Editor.
   `,
     "import-claude-design-from-url": dedent_default`
     Import a design created in Claude's design tool into Wix. Only for the signed \`claudeusercontent.com\` bundle URL Claude Design's "Send to Wix" produces (a self-contained HTML bundle with all images, fonts, and styles inlined). Creates a live Wix-hosted site and returns its URL.
@@ -13125,16 +13259,16 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true,
   `,
     ExecuteWixAPI: executeWixApiDescription,
     // Named in SERVER_INSTRUCTIONS: when this tool's name or what it is for changes, update them to match.
-    WixSiteBuilder: dedent_default`
-    A secondary site-creation tool, only for a user who asked for the Wix Harmony Editor or for Wix to design the site. Don't call it for any other site request, not even to check with the flag false. A new site is otherwise written in code and uploaded, with StartDeployWebsite, or StartHeadlessBuild when it needs Wix business features.
+    WixHarmonyEditorBuild: dedent_default`
+    A secondary site-creation tool, only for a user who asked for the Wix Harmony Editor or for Wix to design the site in Wix's editor. A request for a site on Wix, or for Wix to build or make one, is neither. Don't call it for any other site request, not even to check with the flag false. A new site is otherwise written in code and uploaded, with StartDeployWebsite, or StartHeadlessBuild when it needs Wix business features.
     Builds a site with the Wix Harmony Editor: Wix designs a first version from the user's description, and the user keeps designing it in Wix's editor. Shows the build's progress and a preview.
-    Call it when the user asked for the Wix Harmony Editor, or for Wix to design the site, in their own words or as their answer to your question. ${EDITOR_TAIL}
+    Call it when the user asked for the Wix Harmony Editor, or for Wix to design the site in Wix's editor, in their own words or as their answer to your question, and quote those words in \`editorRequest\`. ${EDITOR_TAIL}
   `,
     // Named in SERVER_INSTRUCTIONS: when this tool's name or what it is for changes, update them to match.
     SearchSiteTemplates: dedent_default`
     A secondary site-creation tool, only for a user who asked for a template, Wix Studio or the Classic Editor. Don't call it for any other site request, not even to check with the flag false. A new site is otherwise written in code and uploaded, with StartDeployWebsite, or StartHeadlessBuild when it needs Wix business features.
     Shows a gallery of Wix templates, from Harmony, Wix Studio or the Classic Editor, for a site the user will design in Wix's editor. Wix templates come with Wix's business features (a store, online ordering, bookings, forms), so a request for a template comes here even when the site needs them.
-    Call it when the user asked for a template, Wix Studio or the Classic Editor, in their own words or as their answer to your question. ${EDITOR_TAIL} ${SITE_CREATION_COPY.templatePick.nonWidget}
+    Call it when the user asked for a template, Wix Studio or the Classic Editor, in their own words or as their answer to your question, and quote those words in \`templateRequest\`. ${EDITOR_TAIL} ${SITE_CREATION_COPY.templatePick.nonWidget}
   `,
     CreateSiteFromTemplate: dedent_default`
     Creates a Wix site from a specific template (by \`metaSiteId\` or \`templateId\`), publishes it when possible, and shows a live preview with links to the editor and the published site.
@@ -13171,20 +13305,20 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true,
     UploadHeadlessWebsiteFiles: dedent_default`
     The upload step of the StartDeployWebsite and StartHeadlessBuild guides, and nothing else: puts a finished website's files — a static site (index.html plus its CSS/JS/images, a static build, or a zip of the site) or a Wix Astro build — onto an existing Wix Headless site by its metaSiteId. Call it ONLY after one of them has returned its guide in this conversation and the site exists: for a new site, first run the recipe's provision call and pass the metaSiteId it returns; for a site deployed earlier, pass its metaSiteId. It does not create sites. Every upload replaces the whole file set and the URL stays. Returns the live URL and the dashboard link, and points back to the recipe for what comes next.
     Pass the files themselves: in ${FILE_PARAM_CLIENTS} as \`attachments\` (any type, a zip is unpacked), elsewhere as the \`files\` text bundle (\`=== FILE: <path> ===\` sections, \`base64\` tag for small binaries). A static site must contain index.html at its root. A Wix Astro build with no file handle, from a shell that reaches the internet, goes in two calls: zip the build, call with \`prepare: true\` and the zip's \`size\` in bytes, PUT the zips it names with the \`curl\` commands it returns (the build, and the project source when the site's repository accepts it), then call again with the \`uploadKey\` it returned; that releases the build. The two calls, literally: {siteId, prepare: true, size} then {siteId, uploadKey, sourceUploadId?, expectedHeadRevisionId?, releaseNotes?}. A sandbox whose network is limited to a few hosts cannot upload to those URLs. A static site does not use the two calls. A Wix Astro build (the project's .wix/ and dist/ after \`astro build\` with the Wix hosting adapter, zipped from the project root) needs no index.html: it is released to the site's Wix hosting instead, server-rendered pages, the same site and URL. The project's source is stored with the release when the upload holds the project and the site's repository accepts it.
-    NOT a site-creation tool: a request to create, build, design or generate a site — with or without a description — never comes here first. Unless the user asked for Wix's editor or a template (WixSiteBuilder, SearchSiteTemplates), call StartDeployWebsite right away, without asking the user anything: it also takes files the user brought, uploaded first even when the site needs business features. StartHeadlessBuild instead for a new site with no files that needs Wix business features. Also NOT for media uploads to an existing site (UploadImageToWixSite) or any other API call (ExecuteWixAPI).
+    NOT a site-creation tool: a request to create, build, design or generate a site — with or without a description — never comes here first. Unless the user asked for Wix's editor or a template (WixHarmonyEditorBuild, SearchSiteTemplates), call StartDeployWebsite right away, without asking the user anything: it also takes files the user brought, uploaded first even when the site needs business features. StartHeadlessBuild instead for a new site with no files that needs Wix business features. Also NOT for media uploads to an existing site (UploadImageToWixSite) or any other API call (ExecuteWixAPI).
   `,
     // Named in SERVER_INSTRUCTIONS: when this tool's name or what it is for changes, update them to match.
     StartDeployWebsite: dedent_default`
     Creates a website on Wix and puts it live, or replaces the files of one deployed earlier. You write the site's code, or take the files the user brought (HTML/CSS/JS, a static build, a zip, another builder's export), and this returns the guide to create the site and upload them. Updates keep the same site and URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell. Call it right away, without asking the user anything first.
     When a new site needs Wix business features (${WIX_BUSINESS_FEATURES}), call StartHeadlessBuild instead. When the user brought files and the site needs those features, upload the files here first; the upload's result then points to StartHeadlessBuild to connect them.
     Returns the guide; follow it and do the work yourself. Upload with UploadHeadlessWebsiteFiles once the site exists; the drop page is only the fallback.
-    NOT for: a user who asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor (WixSiteBuilder, SearchSiteTemplates); a Claude Design bundle URL (import-claude-design-from-url); migrating a live site by URL or CSV exports; adding HTML or code into an existing Wix editor site; uploading images or documents to a site's media (UploadImageToWixSite).
+    NOT for: a user who asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor (WixHarmonyEditorBuild, SearchSiteTemplates); a Claude Design bundle URL (import-claude-design-from-url); migrating a live site by URL or CSV exports; adding HTML or code into an existing Wix editor site; uploading images or documents to a site's media (UploadImageToWixSite).
   `,
     // Named in SERVER_INSTRUCTIONS: when this tool's name or what it is for changes, update them to match.
     StartHeadlessBuild: dedent_default`
     Returns Wix's headless guide, for a site that needs Wix business features (${WIX_BUSINESS_FEATURES}), run by Wix as a Wix Headless site. You write the site; the guide creates it, connects the features, and uploads it. Also to add those features to an existing Wix Headless site (one deployed from files is one), from a project download link, or to move a Wix site to code.
     Call it right away: it only returns the guide, and the site's details are not needed first.
-    NOT for: a site that needs no Wix business feature, or files the user brought that are not live yet (StartDeployWebsite: upload them first, then come back here for the features); a user who asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor, even when the site needs business features (WixSiteBuilder, SearchSiteTemplates); a Claude Design URL (import-claude-design-from-url).
+    NOT for: a site that needs no Wix business feature, or files the user brought that are not live yet (StartDeployWebsite: upload them first, then come back here for the features); a user who asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor, even when the site needs business features (WixHarmonyEditorBuild, SearchSiteTemplates); a Claude Design URL (import-claude-design-from-url).
   `
   };
   descriptions.SupportAndFeedback = descriptions.ReportIssueToWix;
@@ -13412,7 +13546,7 @@ var defaultConfig = {
 var widgetSiteCreationConfig = {
   toolDescriptions: Object.fromEntries(
     [
-      "WixSiteBuilder",
+      "WixHarmonyEditorBuild",
       "WixSiteCreation",
       "SearchSiteTemplates",
       "CreateSiteFromTemplate"
@@ -14835,9 +14969,16 @@ function shouldTryMenuFallbackForDocsRead(error, articleUrl) {
   if (!message.includes("404") || !isMenuFallbackUrl) {
     return false;
   }
-  return !["This resource is deprecated", "No schema found"].some(
-    (knownArticleError) => message.includes(knownArticleError)
-  );
+  return !isKnownArticleError(error);
+}
+function isKnownArticleError(error) {
+  const message = getErrorMessage(error);
+  return [
+    "This resource is deprecated",
+    "This method is deprecated",
+    "This article is deprecated",
+    "No schema found"
+  ].some((knownArticleError) => message.includes(knownArticleError));
 }
 function formatDocsReadError(toolAction, error) {
   return `Could not fetch ${toolAction}: "${getErrorMessage(error)}".`;
@@ -14924,6 +15065,58 @@ var addDocsTools = (server, allowedTools = [
     }
     return menuContent.length > MENU_CONTENT_THRESHOLD ? summarizeLargeMenu(menuContent, url) : normalizeMenuContent(menuContent);
   };
+  const nearestToMissingPage = async (httpClient, url, isSkillsPage) => {
+    try {
+      if (isSkillsPage) {
+        const manifestUrl = skillManifestUrl(url);
+        if (!manifestUrl) return null;
+        const manifest = JSON.parse(
+          await fetchArticleContent(httpClient, manifestUrl, "article")
+        );
+        const guess = closestSkillFile(url, manifest, manifestUrl);
+        if (!guess) return null;
+        if (guess.kind === "file") {
+          const text = await fetchArticleContent(
+            httpClient,
+            guess.url,
+            "article"
+          );
+          return `Note: "${url}" does not exist. Found a similar file in the skill, ${guess.url}, and read it:
+
+${text}`;
+        }
+        return `Note: "${url}" does not exist, and no file in ${guess.folder ? `its folder (${guess.folder}/)` : "the skill"} has a name close to it. ${guess.folder ? "The files in that folder" : "The skill's top-level folders and files"}, to read the one you need (every file: ${guess.manifestUrl}):
+
+${guess.files.map((f) => `- ${f}`).join("\n")}`;
+      }
+      for (const menuUrl of parentMenuUrls(url)) {
+        const text = await fetchMenuTextForUrl(httpClient, menuUrl);
+        if (!text) continue;
+        const subMenus = (await Promise.all(
+          subMenusToRead(text, menuUrl, url).map(async (sub) => ({
+            sub,
+            text: await fetchMenuTextForUrl(httpClient, sub).catch(() => null)
+          }))
+        )).filter((m) => !!m.text);
+        const closest = closestMenuLinks(
+          [text, ...subMenus.map((m) => m.text)].join("\n"),
+          menuUrl,
+          url
+        );
+        return [
+          `Note: "${url}" does not exist. Showing the nearest documentation menu above it, ${menuUrl}; read the page you need from its links.`,
+          ...closest.length ? [
+            `Closest to what you asked for:
+${closest.map((l) => `- ${l}`).join("\n")}`
+          ] : [],
+          text
+        ].join("\n\n");
+      }
+    } catch (error) {
+      logger.error(`[docs] no nearest page for ${url}: ${error}`);
+    }
+    return null;
+  };
   if (startDeployWebsiteEnabled) {
     addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
@@ -15660,6 +15853,16 @@ ${text}`
             } catch {
             }
           }
+          if (getErrorMessage(error).includes("404") && !isKnownArticleError(error)) {
+            const nearest = await nearestToMissingPage(
+              httpClient,
+              articleUrl,
+              isSkillsPage
+            );
+            if (nearest) {
+              return { content: [{ type: "text", text: nearest }] };
+            }
+          }
           return {
             isError: true,
             content: [
@@ -15850,6 +16053,16 @@ var getRetryHint = (errorDetails) => {
   }
   return /"operator":"\{/.test(errorDetails) ? SINGLE_OPERATOR_PER_FIELD_HINT : FIELD_CAPABILITIES_HINT;
 };
+var NO_SITE_IN_REQUEST = /META_SITE_NOT_FOUND|MetaSite(?:Id)? (?:context )?(?:is missing|was not found|not found)|NO_METASITE_IN_CALL_CONTEXT|MISSING_METASITE_ID|MISSING_REQUEST_SITE_CONTEXT|metasiteId from the request context/i;
+function missingSiteContext(status, responseData) {
+  const details = typeof responseData === "string" ? responseData : JSON.stringify(responseData ?? "");
+  if (NO_SITE_IN_REQUEST.test(details)) return "certain";
+  const parsed = typeof responseData === "string" ? safeParseJSON(responseData) : responseData;
+  if (status === 403 && parsed && typeof parsed === "object" && !parsed.message) {
+    return "likely";
+  }
+  return null;
+}
 var safeParseJSON = (text) => {
   try {
     return JSON.parse(text);
@@ -15861,7 +16074,8 @@ var buildErrorMessage = ({
   status,
   statusText,
   requestId,
-  responseData
+  responseData,
+  retryHint
 }) => {
   const responseDataObject = typeof responseData === "string" ? safeParseJSON(responseData) : responseData;
   const errorDetails = typeof responseDataObject === "object" ? JSON.stringify(responseDataObject) : responseDataObject;
@@ -15873,7 +16087,7 @@ var buildErrorMessage = ({
   ].filter((str) => !!str).join("\n");
   return `${baseMessage}
 
-${getRetryHint(String(errorDetails))}`;
+${retryHint ?? getRetryHint(String(errorDetails))}`;
 };
 var handleWixAPIResponse = async (response) => {
   const requestId = response.headers?.["x-wix-request-id"];
@@ -16285,6 +16499,9 @@ If you can't deliver the image any of these ways, call ${imagePickerToolName} so
 var MAX_ALLOWED_RESPONSE_CHARS = 2e6;
 
 // src/api-call/index.ts
+var siteToolCall = (executeServed) => executeServed ? "through ExecuteWixAPI with that site's `siteId` (`scope: \"site\"`), loading ExecuteWixAPI through your client's tool search if it isn't loaded" : "through CallWixSiteAPI with that site's `siteId`";
+var manageNoSiteHint = (executeServed) => `This is a site-level API: it acts inside a site, and ManageWixSite sends no site, so the same call fails here every time. Call the same URL, method and body ${siteToolCall(executeServed)}.`;
+var manageEmpty403Hint = (executeServed) => `If this endpoint acts inside a site (its products, data, bookings, members, pages, publishing), it is site-level, and ManageWixSite sends no site: call the same URL, method and body ${siteToolCall(executeServed)}. If it acts on the account or on sites as objects in it, the account lacks the permission; don't retry.`;
 var DEFAULT_MAX_RESPONSE_SIZE = 5e4;
 function extractReturnedRows(responseData) {
   if (responseData === null || typeof responseData !== "object") {
@@ -16608,6 +16825,18 @@ function addApiCallTool(server, strategy, allowedTools = ["CallWixSiteAPI", "Lis
           if (!response) {
             throw new Error(`Failed to call Wix Account API: ${error}`);
           }
+          const noSite = missingSiteContext(response.status, response.data);
+          if (noSite) {
+            throw new Error(
+              buildErrorMessage({
+                status: response.status,
+                statusText: response.statusText,
+                requestId: response.headers?.["x-wix-request-id"] ?? null,
+                responseData: response.data,
+                retryHint: (noSite === "certain" ? manageNoSiteHint : manageEmpty403Hint)(!!options?.executeWixAPIServed)
+              })
+            );
+          }
           return handleWixAPIResponse(response);
         }
       }
@@ -17434,15 +17663,18 @@ var OAI_BLOB_ACCOUNTS = new Set(
     "westus3"
   ].map((region) => `oaisdmntpr${region}.blob.core.windows.net`)
 );
-function isAllowedAttachmentHost(hostname) {
+var WIX_AI_ASSISTANT_ATTACHMENT_HOSTS = /* @__PURE__ */ new Set([
+  "wixmp-a85a29aaf55baa3e5171a82d.wixmp.com"
+]);
+function isAllowedAttachmentHost(hostname, extraHosts) {
   const h = hostname.toLowerCase();
-  return OAI_USERCONTENT_HOST.test(h) || OAI_BLOB_ACCOUNTS.has(h);
+  return OAI_USERCONTENT_HOST.test(h) || OAI_BLOB_ACCOUNTS.has(h) || !!extraHosts?.has(h);
 }
-function checkAttachmentUrl(url) {
+function checkAttachmentUrl(url, extraHosts) {
   if (url.protocol !== "https:") return "is not an https URL";
   if (url.port) return "uses a non-default port";
-  if (!isAllowedAttachmentHost(url.hostname)) {
-    return `host "${url.hostname}" is not a ChatGPT file host`;
+  if (!isAllowedAttachmentHost(url.hostname, extraHosts)) {
+    return `host "${url.hostname}" is not a chat attachment host`;
   }
   return void 0;
 }
@@ -17469,7 +17701,7 @@ function toBase64(bytes) {
   }
   return btoa(binary);
 }
-async function fetchAllowed(start, fetchImpl, label) {
+async function fetchAllowed(start, fetchImpl, label, extraHosts) {
   let url = start;
   for (let hop = 0; ; hop++) {
     const res = await fetchImpl(url.toString(), { redirect: "manual" });
@@ -17486,7 +17718,7 @@ async function fetchAllowed(start, fetchImpl, label) {
     } catch {
       throw new AttachmentError(`${label}: redirect to an invalid URL.`);
     }
-    const problem = checkAttachmentUrl(next);
+    const problem = checkAttachmentUrl(next, extraHosts);
     if (problem) {
       throw new AttachmentError(
         `${label}: the download redirected to a URL that ${problem}; refused.`
@@ -17524,7 +17756,7 @@ async function readWithin(res, budget, overBudget) {
   }
   return out;
 }
-async function resolveAttachments(attachments, fetchImpl = fetch) {
+async function resolveAttachments(attachments, fetchImpl = fetch, extraHosts) {
   if (!Array.isArray(attachments) || attachments.length === 0) return [];
   const items = [];
   attachments.forEach((raw, i) => {
@@ -17543,10 +17775,10 @@ async function resolveAttachments(attachments, fetchImpl = fetch) {
         )}). \`attachments\` works only in ChatGPT, which swaps each file for a download URL before the call reaches Wix. Here it arrived as written, and Wix cannot read a path on your machine, so retrying the same value fails the same way. Upload another way. With a shell that reaches the internet, send the file from there (for a site, the StartDeployWebsite recipe's curl drop). Otherwise leave \`attachments\` out and put the files in \`files\`: text as is, and a binary as a \`=== FILE: <path> base64 ===\` entry only when it is a few KB (an icon, a logo), since a larger base64 payload does not survive your own output. A larger image goes in by public URL or through the user (the Media Manager).`
       );
     }
-    const problem = checkAttachmentUrl(url);
+    const problem = checkAttachmentUrl(url, extraHosts);
     if (problem) {
       throw new AttachmentError(
-        `attachments[${i}].download_url ${problem}. Only platform-resolved attachments are accepted here; for any other URL fetch it in \`code\` via wix.request or put the bytes in the \`files\` bundle.`
+        `attachments[${i}].download_url ${problem}. \`attachments\` takes only files the chat platform attached and resolved; leave it out. For a file at a URL, import it in \`code\` with \`POST https://www.wixapis.com/site-media/v1/files/import\` and \`{ url }\` (Wix fetches it); for a small file you have as text, use the \`files\` bundle.`
       );
     }
     items.push({ a, url });
@@ -17558,7 +17790,7 @@ async function resolveAttachments(attachments, fetchImpl = fetch) {
     const label = `attachments[${i}] (${path})`;
     let res;
     try {
-      res = await fetchAllowed(url, fetchImpl, label);
+      res = await fetchAllowed(url, fetchImpl, label, extraHosts);
     } catch (e) {
       if (e instanceof AttachmentError) throw e;
       throw new AttachmentError(
@@ -17988,7 +18220,9 @@ var FREE_TEXT_INFO_PARAMS = [
   "agentIdentity",
   "wixAccess",
   "reason",
-  "whyNotExecuteWixAPI"
+  "whyNotExecuteWixAPI",
+  "editorRequest",
+  "templateRequest"
 ];
 var EMAIL = /[A-Z0-9._%+-]+@[A-Z0-9-]+(?:\.[A-Z0-9-]+)*\.[A-Z]{2,}/gi;
 var NAMED_SECRET = /\b(passwords?|passwd|pwd|passcodes?|secrets?|tokens?|api[ _-]?keys?|access[ _-]?keys?|credentials?)(\s*[:=]\s*|\s+(?:is|was|to)\s+)(?:"[^"]*"|'[^']*'|`[^`]*`|[^\s"'`,;][^,;\n]*?(?=[.!?]\s|[,;\n]|$))/gi;
@@ -18036,9 +18270,65 @@ function redactInfoParams(value) {
   }
   return redacted;
 }
+var MAX_LISTED_PATHS_CHARS = 2e3;
+function summarizeFileBundle(bundle) {
+  let sections;
+  try {
+    sections = parseFileBundle(bundle).map((file) => ({
+      path: file.path,
+      bytes: file.bytes.length
+    }));
+  } catch {
+    sections = [];
+  }
+  if (sections.length === 0) {
+    return `${new TextEncoder().encode(bundle).length} bytes, no file sections`;
+  }
+  return formatFileSummary(sections);
+}
+function formatFileSummary(files) {
+  const total = files.reduce((sum, file) => sum + file.bytes, 0);
+  let listed = "";
+  let shown = 0;
+  for (const file of files) {
+    const entry = `${shown ? ", " : ""}${file.path} (${file.bytes})`;
+    if (listed.length + entry.length > MAX_LISTED_PATHS_CHARS) break;
+    listed += entry;
+    shown++;
+  }
+  const more = files.length - shown;
+  return `${files.length} file(s), ${total} bytes: ${listed}${more ? `${shown ? ", " : ""}and ${more} more` : ""}`;
+}
+function compactFileParams(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return value;
+  }
+  const record = value;
+  const files = record.files;
+  if (typeof files === "string") {
+    return { ...record, files: summarizeFileBundle(files) };
+  }
+  if (Array.isArray(files) && files.length > 0 && files.every(
+    (entry) => entry && typeof entry === "object" && typeof entry.content === "string"
+  )) {
+    return {
+      ...record,
+      files: formatFileSummary(
+        files.map((entry) => ({
+          path: entry.path ?? "?",
+          bytes: new TextEncoder().encode(entry.content).length
+        }))
+      )
+    };
+  }
+  return value;
+}
+function prepareForBi(value) {
+  return compactFileParams(redactInfoParams(value));
+}
 function serializeToolParamsForBi(args) {
   return JSON.stringify(
-    Array.isArray(args) ? args.map(redactInfoParams) : redactInfoParams(args)
+    Array.isArray(args) ? args.map(prepareForBi) : prepareForBi(args)
   );
 }
 
@@ -18046,6 +18336,8 @@ function serializeToolParamsForBi(args) {
 var UPLOAD_HEADLESS_WEBSITE_FILES_TOOL_NAME = "UploadHeadlessWebsiteFiles";
 var HEADLESS_BUSINESS = "https://www.wixapis.com/headless-business-setup/v1/headless-business";
 var MAX_BUNDLE_BYTES = 100 * 1024 * 1024;
+var MAX_RELEASE_STATIC_FILES = 2500;
+var MAX_SOURCE_ZIP_BYTES = 64 * 1024 * 1024;
 function dropAttribution(clientName) {
   const slug = (clientName ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
   return `?campaign=mcp&agent=${encodeURIComponent(slug || "wix-mcp")}`;
@@ -18068,6 +18360,17 @@ var UPLOAD_HEADLESS_WEBSITE_FILES_PARAM_DESCRIPTIONS = {
 };
 var UPLOAD_RECIPE_SKILL_URL = "https://www.wix.com/skills/wix-manage/references/sites/upload-static-site.md";
 var DOMAIN_RECIPE_SKILL_URL = "https://www.wix.com/skills/wix-manage/references/domains/domain-search-purchase-and-connect.md";
+function formatInlineGuide(guide) {
+  if (!guide || !guide.trim()) return "";
+  return [
+    "",
+    "---",
+    "",
+    `Wix's headless guide, the build of a site that needs Wix business features (also at https://www.wix.com/headless/skill.md):`,
+    "",
+    guide.trim()
+  ].join("\n");
+}
 function formatDropResult(r) {
   const shown = r.files.slice(0, 60);
   return [
@@ -18080,7 +18383,7 @@ function formatDropResult(r) {
     `Give the user both links, each on its own line and named for what it is: the live site, and the site's dashboard. Then offer a custom domain, bought through Wix or one they already own (${DOMAIN_RECIPE_SKILL_URL}).`,
     "",
     `- To change this site later: "Change it later" in ${UPLOAD_RECIPE_SKILL_URL}, with this metaSiteId (${r.metaSiteId}). The same site every time, never a new one.`,
-    `- Wix business features (${WIX_BUSINESS_FEATURES}): call StartHeadlessBuild with startingPoint "an existing Wix Headless site"; this site is one.`
+    `- When the site needs Wix business features (${WIX_BUSINESS_FEATURES}), a drop of static pages is not its build: a full Wix Headless site has those features run by Wix and its pages reading from them. That build is Wix's headless guide, https://www.wix.com/headless/skill.md (what StartHeadlessBuild returns; call it with startingPoint "an existing Wix Headless site", this site is one): it installs the solution on this site, seeds its content through the API, and puts up pages that fetch it, uploaded here again. A site with no business features is done.`
   ].join("\n");
 }
 function curlPut(zipName, put, fallback) {
@@ -18108,7 +18411,7 @@ function formatPrepareResult(siteId, urls, size, given = {}) {
   const lines = [
     `Upload URLs ready for site ${siteId}.${expiry} Two steps, then call this tool again.`,
     "",
-    `1. ${BUILD_ZIP_CONTENTS} Upload the zip you measured${size ? ` (${size} bytes)` : ""}; the URL takes a body of exactly that length, so a zip changed since needs a new prepare with its size:`,
+    `1. ${BUILD_ZIP_CONTENTS} Its client folder (\`dist/client\`) holds at most ${MAX_RELEASE_STATIC_FILES} files (\`find dist/client -type f | wc -l\`); a larger build fails the release. Upload the zip you measured${size ? ` (${size} bytes)` : ""}; the URL takes a body of exactly that length, so a zip changed since needs a new prepare with its size:`,
     `   ${curlPut("build.zip", urls, zipHeaders)}`
   ];
   if (given.expectedHeadRevisionId)
@@ -18120,7 +18423,7 @@ function formatPrepareResult(siteId, urls, size, given = {}) {
       secondCall.expectedHeadRevisionId = s.headRevisionId;
     lines.push(
       "",
-      `2. ${SOURCE_ZIP_CONTENTS} Upload it:`,
+      `2. ${SOURCE_ZIP_CONTENTS} At most 64 MiB (\`wc -c < source.zip\`): a larger one fails the whole release. Leave large media and generated files out of it; if it is still larger, skip this upload and leave \`sourceUploadId\` out of the second call, and the site is released without its source. Upload it:`,
       `   ${curlPut("source.zip", s, { "content-type": "application/zip" })}`,
       ...s.expiresAt && s.expiresAt !== urls.expiresAt ? [`   This URL expires at ${s.expiresAt}.`] : [],
       ...s.headRevisionId ? [
@@ -18139,6 +18442,13 @@ function formatPrepareResult(siteId, urls, size, given = {}) {
     "",
     `3. Call UploadHeadlessWebsiteFiles again with ${JSON.stringify(secondCall)} (plus \`calledStartDeployWebsite\`, \`agentIdentity\`, \`reason\`). No \`files\` or \`attachments\` on that call.`
   );
+  if (secondCall.sourceUploadId) {
+    const withoutSource = { ...secondCall };
+    delete withoutSource.sourceUploadId;
+    lines.push(
+      `   If you skipped the source upload in step 2, call with ${JSON.stringify(withoutSource)} instead: a \`sourceUploadId\` whose zip was never uploaded fails the release.`
+    );
+  }
   return lines.join("\n");
 }
 function formatBundleReleaseResult(siteId, r, notes = []) {
@@ -18156,10 +18466,21 @@ function formatBundleReleaseResult(siteId, r, notes = []) {
 }
 var startOver = (retry) => retry === "prepare" ? "call with `prepare: true` and the zip's `size` again, upload the zips to the new URLs, and release with the new `uploadKey`" : "call this tool again with the same files";
 var apiBody = (err) => err.response.data ? ` (${err.response.data.slice(0, 300)})` : "";
-function describeBundleUploadUrlError(err) {
+var SITE_ACCESS_PERMISSION = "OAUTH_APP.APP_CREATE";
+function describeSiteAccessDenied(err, siteId, stagedKey) {
+  if (!(err instanceof WixFetchError) || err.status !== 403 || !err.response.data.includes(SITE_ACCESS_PERMISSION)) {
+    return null;
+  }
+  const site = siteId ? `site ${siteId}` : "this site";
+  const outcome = stagedKey ? `Nothing was released; the build you uploaded is still staged under uploadKey ${stagedKey} and counts against the site's unreleased uploads, so do not call \`prepare\` again and do not send the files again. The same call fails the same way until the login changes; once connected as the owning account, release that staged upload by calling with \`uploadKey: "${stagedKey}"\` before preparing a new one.` : "Nothing was uploaded, and the same call fails the same way, so do not retry and do not stage another upload.";
+  return `The connected Wix login has no rights on ${site}: Wix refused it the \`${SITE_ACCESS_PERMISSION}\` permission there. That means the site belongs to another Wix account, or this login's role on the owning account is too low (a Basic Team Member cannot upload). ${outcome} Ask the user which Wix account owns the site. Reconnecting Wix helps only if they pick that account, as its owner or an admin, at the consent screen; otherwise the owner has to give this login a higher role on the account, or move the site to it.${apiBody(err)}`;
+}
+function describeBundleUploadUrlError(err, siteId) {
   if (!(err instanceof WixFetchError)) {
     return err instanceof Error ? err.message : String(err);
   }
+  const denied = describeSiteAccessDenied(err, siteId);
+  if (denied) return denied;
   const body = apiBody(err);
   switch (err.status) {
     case 400:
@@ -18179,17 +18500,24 @@ function releaseNotesForService(notes) {
   const chars = [...notes.replace(/\s+/g, " ").trim()];
   return chars.length <= RELEASE_NOTES_MAX_CHARS ? chars.join("") : `${chars.slice(0, RELEASE_NOTES_MAX_CHARS - 1).join("").trimEnd()}\u2026`;
 }
-function describeBundleReleaseError(err, uploadKey, retry = "prepare") {
+function describeBundleReleaseError(err, uploadKey, retry = "prepare", siteId) {
   if (!(err instanceof WixFetchError)) {
     return err instanceof Error ? err.message : String(err);
   }
+  const denied = describeSiteAccessDenied(err, siteId, uploadKey);
+  if (denied) return denied;
   const body = apiBody(err);
   const code = err.response.data ?? "";
+  const sameCall = `calling with \`uploadKey: "${uploadKey}"\`${retry === "resend" ? " (plus the `expectedHeadRevisionId` and `releaseNotes` you passed, if any; the source is stored with the next release)" : " and the same ids and `releaseNotes`"}`;
+  const afterDrop = "If an earlier call with this `uploadKey` ended in a dropped connection, that release went through: the site is live with this build, so do not upload it again.";
+  if (err.status >= 502 && err.status <= 504 && !code.includes("RELEASE_NOT_HELD") && !code.includes("{")) {
+    return `The connection to Wix dropped while the release ran (HTTP ${err.status}); the release most likely went through. Do not call \`prepare\` again and do not send the files again. Wait two minutes, then check once by ${sameCall}: an answer that nothing is staged for this key, or that the repository moved, means the first release went through and the site is live. Any other answer is about the release itself.${body}`;
+  }
   switch (err.status) {
     case 404:
-      return `Nothing uploaded for uploadKey ${uploadKey}: the build zip was not PUT to its URL, or the URL expired. To try again, ${startOver(retry)}.${body}`;
+      return `Nothing uploaded for uploadKey ${uploadKey}: the build zip was not PUT to its URL, the URL expired, or a release of it already went through (a staged zip is deleted once released). ${afterDrop} Otherwise, to try again, ${startOver(retry)}.${body}`;
     case 409:
-      return `The project's source repository moved since the upload URLs were made; nothing was released. ${retry === "prepare" ? "Call with `prepare: true` and the zip's `size` again, re-upload the source zip to the new URL, and release with the new `uploadKey`, `sourceUploadId` and `expectedHeadRevisionId`." : "Download the project again from the repository, carry your change over, and upload with `expectedHeadRevisionId` set to the revision you downloaded."}${body}`;
+      return `The project's source repository moved since the upload URLs were made; nothing was released by this call. ${afterDrop} Otherwise: ${retry === "prepare" ? "call with `prepare: true` and the zip's `size` again, re-upload the source zip to the new URL, and release with the new `uploadKey`, `sourceUploadId` and `expectedHeadRevisionId`." : "download the project again from the repository, carry your change over, and upload with `expectedHeadRevisionId` set to the revision you downloaded."}${body}`;
     case 403:
       return `Wix refused to deploy this build onto the site's project; nothing was released, and the same call will be refused again. Do not call \`prepare\` again. Tell the user the release is blocked on Wix's side and give them the request id from the error.${body}`;
     case 413:
@@ -18211,8 +18539,9 @@ function describeBundleReleaseError(err, uploadKey, retry = "prepare") {
       return `The uploaded zip was not accepted. Zip \`dist/\` and \`.wix/build-metadata.json\` from the project root after \`astro build\` with the Wix hosting adapter, then ${startOver(retry)}. A static site goes in \`files\` or \`attachments\` instead, or is dropped as the StartDeployWebsite recipe shows.${body}`;
     default:
       if (err.status >= 500) {
-        const what = err.status === 503 ? "The release could not hold its upload" : `Wix's release step failed on its side (HTTP ${err.status})`;
-        return `${what}; nothing was released. The staged upload is kept under uploadKey ${uploadKey}, so do not call \`prepare\` again and do not send the files again: every upload staged and not released counts against the site, which refuses new ones after a few. Retry once, after a minute, by calling with \`uploadKey: "${uploadKey}"\`${retry === "resend" ? " (plus the `expectedHeadRevisionId` and `releaseNotes` you passed, if any; the source is stored with the next release)" : " and the same ids and `releaseNotes`"}. If that fails too, stop and tell the user the release is blocked on Wix's side, with the request id from the error.${body}`;
+        const what = code.includes("RELEASE_NOT_HELD") ? "The release could not hold its upload" : `Wix's release step failed on its side (HTTP ${err.status})`;
+        const limits = retry === "prepare" && !code.includes("RELEASE_NOT_HELD") ? ` A build over Wix's limits fails here with no reason given: more than ${MAX_RELEASE_STATIC_FILES} files in its client folder (\`find dist/client -type f | wc -l\`), or a source zip over 64 MiB (\`wc -c < source.zip\`). If either is over, a retry fails the same way: make the build or the source zip smaller, then call with \`prepare: true\` again.` : "";
+        return `${what}; nothing was released.${limits} The staged upload is kept under uploadKey ${uploadKey}, so do not call \`prepare\` again${limits ? " for the same zips" : ""} and do not send the files again: every upload staged and not released counts against the site, which refuses new ones after a few. Retry once, after a minute, by ${sameCall}. If that fails too, stop and tell the user the release is blocked on Wix's side, with the request id from the error.${body}`;
       }
       return err.message;
   }
@@ -18332,6 +18661,18 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
   const { authStrategy, toolDescriptions } = options;
   const clientName = () => options.clientName ?? server.clientName?.() ?? server.server?.getClientVersion?.()?.name;
   const fetchImpl = options.fetchImpl ?? ((u, i) => fetch(u, i));
+  const guideFetch = options.guideFetch ?? (async (httpClient) => {
+    if (!httpClient) return void 0;
+    return fetchArticleContent(
+      httpClient,
+      HEADLESS_GUIDE_URL,
+      "article",
+      true,
+      options.guide?.skillsPortalUrl,
+      options.guide?.repo,
+      options.guide?.commitHash
+    );
+  });
   const d = UPLOAD_HEADLESS_WEBSITE_FILES_PARAM_DESCRIPTIONS;
   const registered = server.tool(
     UPLOAD_HEADLESS_WEBSITE_FILES_TOOL_NAME,
@@ -18457,7 +18798,7 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
           rethrowIfUnauthorized(err);
           await authStrategy.enforceValidWixToken?.(err);
           return errorResult2(
-            uploadKey ? describeBundleReleaseError(err, uploadKey) : describeBundleUploadUrlError(err)
+            uploadKey ? describeBundleReleaseError(err, uploadKey, "prepare", siteId) : describeBundleUploadUrlError(err, siteId)
           );
         }
       }
@@ -18539,7 +18880,7 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
           rethrowIfUnauthorized(err);
           await authStrategy.enforceValidWixToken?.(err);
           return errorResult2(
-            stagedKey ? describeBundleReleaseError(err, stagedKey, "resend") : describeBundleUploadUrlError(err)
+            stagedKey ? describeBundleReleaseError(err, stagedKey, "resend", siteId) : describeBundleUploadUrlError(err, siteId)
           );
         }
       }
@@ -18563,6 +18904,14 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
           siteId: metaSiteId,
           upload: { path: "drop", files: siteFiles.length }
         });
+        let guide;
+        try {
+          guide = await guideFetch(extra?.httpClient);
+        } catch (e) {
+          logger.log(
+            `[UploadHeadlessWebsiteFiles] guide fetch failed: ${e instanceof Error ? e.message : String(e)}`
+          );
+        }
         return {
           content: [
             {
@@ -18572,7 +18921,7 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
                 siteUrl: dropped.siteUrl,
                 uploadId: dropped.uploadId,
                 files: siteFiles.map((f) => f.path)
-              }) + (releaseNotes ? "\n\nRelease notes are kept for a Wix Astro build only; a static drop has none, so yours were not stored." : "")
+              }) + (releaseNotes ? "\n\nRelease notes are kept for a Wix Astro build only; a static drop has none, so yours were not stored." : "") + formatInlineGuide(guide)
             }
           ]
         };
@@ -18581,7 +18930,7 @@ function addUploadHeadlessWebsiteFilesTool(server, options) {
         logger.log(`[UploadHeadlessWebsiteFiles] Error: ${message}`);
         rethrowIfUnauthorized(err);
         await authStrategy.enforceValidWixToken?.(err);
-        return errorResult2(message);
+        return errorResult2(describeSiteAccessDenied(err, siteId) ?? message);
       }
     }
   );
@@ -18890,7 +19239,11 @@ function addExecuteTool(server, options) {
       }
       let attachmentFiles = [];
       try {
-        attachmentFiles = await resolveAttachments(attachments);
+        attachmentFiles = await resolveAttachments(
+          attachments,
+          void 0,
+          WIX_AI_ASSISTANT_ATTACHMENT_HOSTS
+        );
       } catch (e) {
         if (e instanceof AttachmentError) return executeErrorResult(e.message);
         throw e;
@@ -21020,7 +21373,13 @@ function createWixToolkit(options) {
       addUploadHeadlessWebsiteFilesTool(server, {
         authStrategy,
         toolDescriptions: effectiveToolDescriptions,
-        clientName
+        clientName,
+        // The headless guide the drop reply carries is read the way the docs tools read it.
+        guide: {
+          skillsPortalUrl: docs?.skillsPortalUrl,
+          repo: docs?.repo ?? docs?.skillsRepo,
+          commitHash: docs?.commitHash ?? docs?.skillsPr
+        }
       });
     }
     const requestedGraphqlTools = GRAPHQL_TOOL_NAMES.filter(