@wix/mcp 1.0.95 → 1.0.96

package/build/bin-standalone.js

@@ -71493,6 +71493,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(a2, b) {
+  const x = slugWords(a2);
+  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 = (path10) => path10.slice(path10.lastIndexOf("/") + 1);
+var folderOf = (path10) => path10.includes("/") ? path10.slice(0, path10.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((a2, b) => b.score - a2.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((a2, b) => b.score - a2.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((a2, b) => b.score - a2.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 ownKeys2(object3, enumerableOnly) {
   var keys = Object.keys(object3);
@@ -71697,7 +71831,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 ? [
@@ -71771,7 +71906,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.
@@ -72087,8 +72222,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.
@@ -72158,7 +72292,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.
@@ -72600,16 +72734,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.
@@ -72646,20 +72780,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;
@@ -72849,7 +72983,7 @@ var defaultReadmeDocs = buildReadmeDocs();
 var widgetSiteCreationConfig = {
   toolDescriptions: Object.fromEntries(
     [
-      "WixSiteBuilder",
+      "WixHarmonyEditorBuild",
       "WixSiteCreation",
       "SearchSiteTemplates",
       "CreateSiteFromTemplate"
@@ -74270,9 +74404,16 @@ function shouldTryMenuFallbackForDocsRead(error2, articleUrl) {
   if (!message.includes("404") || !isMenuFallbackUrl) {
     return false;
   }
-  return !["This resource is deprecated", "No schema found"].some(
-    (knownArticleError) => message.includes(knownArticleError)
-  );
+  return !isKnownArticleError(error2);
+}
+function isKnownArticleError(error2) {
+  const message = getErrorMessage(error2);
+  return [
+    "This resource is deprecated",
+    "This method is deprecated",
+    "This article is deprecated",
+    "No schema found"
+  ].some((knownArticleError) => message.includes(knownArticleError));
 }
 function formatDocsReadError(toolAction, error2) {
   return `Could not fetch ${toolAction}: "${getErrorMessage(error2)}".`;
@@ -74359,6 +74500,58 @@ var addDocsTools = (server2, 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 (error2) {
+      logger2.error(`[docs] no nearest page for ${url}: ${error2}`);
+    }
+    return null;
+  };
   if (startDeployWebsiteEnabled) {
     addStartDeployWebsiteTool(server2, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
@@ -75095,6 +75288,16 @@ ${text}`
             } catch {
             }
           }
+          if (getErrorMessage(error2).includes("404") && !isKnownArticleError(error2)) {
+            const nearest = await nearestToMissingPage(
+              httpClient,
+              articleUrl,
+              isSkillsPage
+            );
+            if (nearest) {
+              return { content: [{ type: "text", text: nearest }] };
+            }
+          }
           return {
             isError: true,
             content: [
@@ -79336,11 +79539,11 @@ var getEncodingTransformGenerator = (binary, encoding, skipped) => {
     final: encodingStringFinal.bind(void 0, stringDecoder)
   };
 };
-var encodingUint8ArrayGenerator = function* (textEncoder3, chunk) {
+var encodingUint8ArrayGenerator = function* (textEncoder4, chunk) {
   if (Buffer3.isBuffer(chunk)) {
     yield bufferToUint8Array(chunk);
   } else if (typeof chunk === "string") {
-    yield textEncoder3.encode(chunk);
+    yield textEncoder4.encode(chunk);
   } else {
     yield chunk;
   }
@@ -86146,6 +86349,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 DEFAULT_OPENAI_SECURITY_SCHEMES = [
   { type: "oauth2", scopes: ["offline_access"] }
 ];
@@ -86160,7 +86373,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;
@@ -86172,7 +86386,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"];
@@ -86313,6 +86527,49 @@ function createToolBiEvent(params) {
   return wixMcpRequestSrc39Evid1607(params);
 }
 
+// src/api-call/site-files.ts
+var MAX_FILES_BUNDLE_CHARS = 4e6;
+var MAX_UNZIP_BYTES = 64 * 1024 * 1024;
+var textEncoder3 = new TextEncoder();
+function base64ToBytes(b64) {
+  const clean = b64.replace(/^data:[^,]*,/, "").replace(/\s+/g, "");
+  return Uint8Array.from(atob(clean), (c3) => c3.charCodeAt(0));
+}
+function parseFileBundle(bundle) {
+  if (!bundle || !bundle.trim()) return [];
+  if (bundle.length > MAX_FILES_BUNDLE_CHARS) {
+    throw new Error(
+      `files bundle is too large (${bundle.length} chars; max ${MAX_FILES_BUNDLE_CHARS}). Keep it to text and small base64 assets; pass larger files through attachments or reference media by URL.`
+    );
+  }
+  const delimiter = /^=== FILE: (.+?)(?: (base64))? ===[ \t]*$/gm;
+  const matches = [...bundle.matchAll(delimiter)];
+  if (matches.length === 0) {
+    throw new Error(
+      "files bundle has no `=== FILE: <path> ===` sections. Start each file with that line (add ` base64` before the closing === for binary content)."
+    );
+  }
+  return matches.map((match, i2) => {
+    const path10 = match[1].trim();
+    const start = (match.index ?? 0) + match[0].length;
+    const end = i2 + 1 < matches.length ? matches[i2 + 1].index ?? bundle.length : bundle.length;
+    const content = bundle.slice(start, end).replace(/^\r?\n/, "").replace(/\r?\n$/, "");
+    return {
+      path: path10,
+      bytes: match[2] === "base64" ? base64ToBytes(content) : textEncoder3.encode(content)
+    };
+  });
+}
+var CRC_TABLE = (() => {
+  const t = new Uint32Array(256);
+  for (let n2 = 0; n2 < 256; n2++) {
+    let c3 = n2;
+    for (let k = 0; k < 8; k++) c3 = c3 & 1 ? 3988292384 ^ c3 >>> 1 : c3 >>> 1;
+    t[n2] = c3 >>> 0;
+  }
+  return t;
+})();
+
 // src/infra/redact-personal-data.ts
 var FREE_TEXT_INFO_PARAMS = [
   "userRequest",
@@ -86322,7 +86579,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;
@@ -86370,9 +86629,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 record2 = value;
+  const files = record2.files;
+  if (typeof files === "string") {
+    return { ...record2, files: summarizeFileBundle(files) };
+  }
+  if (Array.isArray(files) && files.length > 0 && files.every(
+    (entry) => entry && typeof entry === "object" && typeof entry.content === "string"
+  )) {
+    return {
+      ...record2,
+      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)
   );
 }
 
@@ -87109,6 +87424,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") {
@@ -87432,6 +87750,18 @@ function addApiCallTool(server2, strategy, allowedTools = ["CallWixSiteAPI", "Li
           if (!response) {
             throw new Error(`Failed to call Wix Account API: ${error2}`);
           }
+          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);
         }
       }