@wix/mcp 1.0.95 → 1.0.96

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

@@ -26,7 +26,8 @@ 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.',
@@ -87,16 +88,17 @@ export const HELP_CENTER_IS_FOR_PEOPLE = "The Help Center is written for people
  * Each tool named here carries a comment pointing back to this text. A change to any of them (a
  * name, what it is for, a new site-creation tool) updates this text and that list with it.
  */
-export const SERVER_INSTRUCTIONS = `Wix: build and manage Wix sites. A new 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 (forms, a store, bookings, a CMS, members, payments). WixSiteBuilder or SearchSiteTemplates only when the user asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor. For anything else, except ListWixSites and UploadImageToWixSite, call WixREADME first.`;
+export const SERVER_INSTRUCTIONS = `Wix: build and manage Wix sites. A new 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 (forms, a store, bookings, a CMS, members, payments). WixHarmonyEditorBuild or SearchSiteTemplates only when the user asked for Wix's editor, the Wix Harmony Editor, a template, Wix Studio or the Classic Editor. Call WixREADME first, except ListWixSites, UploadImageToWixSite, GetSuggestedDomains.`;
 /** The tools SERVER_INSTRUCTIONS names. */
 export const SERVER_INSTRUCTIONS_TOOLS = [
     'StartDeployWebsite',
     'StartHeadlessBuild',
-    'WixSiteBuilder',
+    'WixHarmonyEditorBuild',
     'SearchSiteTemplates',
     'WixREADME',
     'ListWixSites',
-    'UploadImageToWixSite'
+    'UploadImageToWixSite',
+    'GetSuggestedDomains'
 ];
 export const SITE_CREATION_COPY = {
     templatePick: {
@@ -115,7 +117,7 @@ export const toWidget = (text) => Object.values(SITE_CREATION_COPY).reduce((acc,
  */
 // The data the Wix REST API covers, product by product (from the ax-skills capability map), named
 // in the discovery tools' descriptions so a client's tool search finds them by what the user asks about.
-const 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";
+const 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)";
 const EXECUTE_WIX_API_INTRO = dedent `
   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.
@@ -432,8 +434,7 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
     ${reminder}
   `,
         ManageWixSite: dedent `
-    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.
@@ -503,7 +504,7 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
     ${reminder}
   `,
         WixSiteCreation: dedent `
-    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 `
     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.
@@ -945,16 +946,16 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
   `,
         ExecuteWixAPI: executeWixApiDescription,
         // Named in SERVER_INSTRUCTIONS: when this tool's name or what it is for changes, update them to match.
-        WixSiteBuilder: dedent `
-    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 `
+    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 `
     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 `
     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.
@@ -991,20 +992,20 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
         UploadHeadlessWebsiteFiles: dedent `
     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 `
     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 `
     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).
   `
     };
     // The tool's former name, kept for importers that read it by that key.
@@ -1275,7 +1276,7 @@ export function withUsageGuideOnEveryTool(config) {
  */
 export const widgetSiteCreationConfig = {
     toolDescriptions: Object.fromEntries([
-        'WixSiteBuilder',
+        'WixHarmonyEditorBuild',
         'WixSiteCreation',
         'SearchSiteTemplates',
         'CreateSiteFromTemplate'

package/build/dts/docs/docs.js

@@ -5,6 +5,7 @@ import { captureException } from '@sentry/node';
 import { fetchArticleContent, fetchSourceContent, isSkillsRegistryUrl, parseSourceContentUrl } from './fetch-article.js';
 import { normalizeMenuContent, summarizeLargeMenu, fetchMenuContent, MENU_CONTENT_THRESHOLD } from './normalize-menu-content.js';
 import { fetchPlatformizedMenu, MenuNotFoundError } from './browse-menu.js';
+import { closestMenuLinks, closestSkillFile, parentMenuUrls, skillManifestUrl, subMenusToRead } from './guessed-url.js';
 import { isQueryOrSearchEndpoint, QUERY_CAPABILITY_MARKER } from './searchFormatting.js';
 import { addGetToKnowTools, addGetSiteContextTool } from './get-to-know.js';
 import { addStartHeadlessBuildTool } from './start-headless-build.js';
@@ -55,7 +56,17 @@ 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);
+}
+// A 404 that says why (a deprecated page, a method with no schema) is the answer itself.
+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)}".`;
@@ -139,6 +150,51 @@ export const addDocsTools = (server, allowedTools = [
             ? summarizeLargeMenu(menuContent, url)
             : normalizeMenuContent(menuContent);
     };
+    // A docs or skills page that 404'd, most often a URL rewritten or guessed from a real one:
+    // the closest file in the skill or its folder's files, or the nearest menu above a docs page
+    // with its closest entries (one level into its closest sub-menus when none of its own is
+    // close). Null when nothing near exists, so the 404 stands.
+    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:\n\n${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}):\n\n${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:\n${closest.map((l) => `- ${l}`).join('\n')}`
+                        ]
+                        : []),
+                    text
+                ].join('\n\n');
+            }
+        }
+        catch (error) {
+            logger.error(`[docs] no nearest page for ${url}: ${error}`);
+        }
+        return null;
+    };
     // The two site-creation guides register first, so they head the tool list: an agent that
     // loads every definition at once and gets a cut-down copy keeps the start and the end.
     // On by default: they are routing slots, not docs sources.
@@ -865,6 +921,13 @@ export const addDocsTools = (server, allowedTools = [
                         // menu fallback failed too — fall through to error below
                     }
                 }
+                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: [

package/build/dts/docs/guessed-url.d.ts

@@ -0,0 +1,41 @@
+export declare const slugWords: (slug: string) => Set<string>;
+/** Shared words over all words (Jaccard): 1 for the same words, 0 for none in common. */
+export declare function slugSimilarity(a: string, b: string): number;
+/** A file at least this close to the asked name, and the only one that close, is read in its place. */
+export declare const SKILL_FILE_MATCH = 0.5;
+export type SkillFileGuess = {
+    kind: 'file';
+    url: string;
+    path: string;
+} | {
+    kind: 'folder';
+    folder: string;
+    files: string[];
+    manifestUrl: string;
+};
+/**
+ * The closest file to a skills registry URL that 404'd, from the skill's manifest
+ * (`https://www.wix.com/skills/<skill>.manifest.json`, `{ base, files: [{ path }] }`).
+ * A file of the same name in another folder counts when it is the only one; a near name
+ * counts in the same folder only. Null when the URL is not a skill file or the manifest
+ * can't be read.
+ */
+export declare function closestSkillFile(url: string, manifest: {
+    base?: string;
+    files?: {
+        path: string;
+    }[];
+}, manifestUrl: string): SkillFileGuess | null;
+/** The manifest of the skill a registry URL is in, or null for a URL that names no skill. */
+export declare function skillManifestUrl(url: string): string | null;
+/** How far above a docs page the nearest menu is looked for. */
+export declare const MENU_WALK_UP_LEVELS = 3;
+/** The menus above a dev.wix.com docs URL, nearest first. */
+export declare function parentMenuUrls(url: string): string[];
+/** The menu's own entries (links under it) whose last segment is closest to the asked page, best first. */
+export declare function closestMenuLinks(menuText: string, menuUrl: string, askedUrl: string, limit?: number): string[];
+/** Below this, a menu's best entry is no answer, and its closest sub-menus are read too. */
+export declare const MENU_ENTRY_MATCH = 0.75;
+/** The menu's sub-menus worth reading for the asked page: its entries sharing a word with it, closest first. */
+export declare function subMenusToRead(menuText: string, menuUrl: string, askedUrl: string, limit?: number): string[];
+//# sourceMappingURL=guessed-url.d.ts.map

package/build/dts/docs/guessed-url.js

@@ -0,0 +1,185 @@
+/**
+ * What ReadFullDocsArticle offers for a docs or skills URL that 404s. Most of these are
+ * guessed: a method slug invented under a real resource, a recipe link "tidied" into a
+ * path that never existed, a skill file renamed since an agent's notes were written.
+ * Instead of a bare not-found, the agent gets the nearest thing that exists:
+ *
+ * - a skills registry file: the skill's manifest names every file, so a file whose name
+ *   is close to the asked one, in the same folder, is read in its place; otherwise the
+ *   folder's files are listed;
+ * - a dev.wix.com docs page: the nearest menu above it, with the links whose names are
+ *   closest to the asked page listed first.
+ */
+import { normalizeSkillsUrl } from './fetch-article.js';
+const SKILLS_BASE = 'https://www.wix.com/skills/';
+// Every host and path ReadFullDocsArticle accepts for the skills registry, as the
+// www.wix.com/skills/ URL whose manifest is next to it.
+const registryUrl = (url) => normalizeSkillsUrl(url).replace(/^https:\/\/(?:dev\.wix\.com(?:\/docs)?|www\.wix\.com\/velo\/reference)\/skills\//, SKILLS_BASE);
+const DOCS_BASE = 'https://dev.wix.com/docs/';
+// Words that say nothing about which file or page is meant.
+const FILLER = new Set([
+    '',
+    'md',
+    'a',
+    'an',
+    'the',
+    'and',
+    'or',
+    'of',
+    'to',
+    'wix',
+    's'
+]);
+export const slugWords = (slug) => new Set(slug
+    .toLowerCase()
+    .replace(/\.md$/, '')
+    .split(/[^a-z0-9]+/)
+    .filter((w) => !FILLER.has(w))
+    // A plural names the same thing: posts, post.
+    .map((w) => (w.length > 3 && w.endsWith('s') ? w.slice(0, -1) : w)));
+/** Shared words over all words (Jaccard): 1 for the same words, 0 for none in common. */
+export 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);
+}
+const lastSegment = (path) => path.slice(path.lastIndexOf('/') + 1);
+const folderOf = (path) => path.includes('/') ? path.slice(0, path.lastIndexOf('/')) : '';
+/** A file at least this close to the asked name, and the only one that close, is read in its place. */
+export const SKILL_FILE_MATCH = 0.5;
+/**
+ * The closest file to a skills registry URL that 404'd, from the skill's manifest
+ * (`https://www.wix.com/skills/<skill>.manifest.json`, `{ base, files: [{ path }] }`).
+ * A file of the same name in another folder counts when it is the only one; a near name
+ * counts in the same folder only. Null when the URL is not a skill file or the manifest
+ * can't be read.
+ */
+export 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
+        };
+    }
+    // The folder doesn't exist either: the skill's top-level folders and files.
+    const top = [...new Set(paths.map((p) => p.split('/')[0]))].sort();
+    return {
+        kind: 'folder',
+        folder: '',
+        files: top.map((t) => base + t),
+        manifestUrl
+    };
+}
+/** The manifest of the skill a registry URL is in, or null for a URL that names no skill. */
+export 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;
+}
+/** How far above a docs page the nearest menu is looked for. */
+export const MENU_WALK_UP_LEVELS = 3;
+// A menu this close to the root (`/docs/velo`, `/docs/api-reference/crm`) lists whole
+// products, which says nothing about the page that was asked for.
+const MIN_MENU_SEGMENTS = 3;
+/** The menus above a dev.wix.com docs URL, nearest first. */
+export 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;
+}
+/** The menu's own entries (links under it) whose last segment is closest to the asked page, best first. */
+export 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);
+}
+const SMALL_MENU = 3;
+/** Below this, a menu's best entry is no answer, and its closest sub-menus are read too. */
+export const MENU_ENTRY_MATCH = 0.75;
+/** The menu's sub-menus worth reading for the asked page: its entries sharing a word with it, closest first. */
+export function subMenusToRead(menuText, menuUrl, askedUrl, limit = 2) {
+    const asked = lastSegment(askedUrl.replace(/[?#].*$/, '').replace(/\/+$/, ''));
+    const under = `${menuUrl.replace(/\/+$/, '')}/`;
+    // A method entry (`- [Create Order](…) _(POST)_`) is a page, not a menu.
+    const methods = new Set([
+        ...menuText.matchAll(/\]\((https:\/\/dev\.wix\.com\/docs\/[^)\s]+)\)\s*_\((?:GET|POST|PUT|PATCH|DELETE)\)_/g)
+    ].map((m) => m[1]));
+    // Direct children only: the legacy menu text also lists pages nested further down.
+    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 [];
+    // A menu of a few entries is read whole: none may share a word (catalog-v1 holds
+    // catalog and inventory; products sit under catalog).
+    if (entries.length <= SMALL_MENU)
+        return entries;
+    return scored
+        .filter((s) => s.score > 0)
+        .slice(0, limit)
+        .map((s) => s.l);
+}
+//# sourceMappingURL=guessed-url.js.map

package/build/dts/infra/redact-personal-data.d.ts

@@ -1,4 +1,4 @@
-export declare const FREE_TEXT_INFO_PARAMS: readonly ["userRequest", "siteDescription", "siteForm", "siteFunctionality", "agentIdentity", "wixAccess", "reason", "whyNotExecuteWixAPI"];
+export declare const FREE_TEXT_INFO_PARAMS: readonly ["userRequest", "siteDescription", "siteForm", "siteFunctionality", "agentIdentity", "wixAccess", "reason", "whyNotExecuteWixAPI", "editorRequest", "templateRequest"];
 export declare function redactPersonalData(text: string): string;
 export declare function serializeToolParamsForBi(args: unknown): string;
 //# sourceMappingURL=redact-personal-data.d.ts.map

package/build/dts/infra/redact-personal-data.js

@@ -1,3 +1,4 @@
+import { parseFileBundle } from '../api-call/site-files.js';
 // Free-text arguments that agents fill in for BI. Their descriptions ask for no
 // personal data; this is the backstop for what comes through anyway, applied to
 // these fields only before tool arguments are recorded. Other arguments (API
@@ -10,7 +11,9 @@ export const FREE_TEXT_INFO_PARAMS = [
     'agentIdentity',
     'wixAccess',
     'reason',
-    'whyNotExecuteWixAPI'
+    'whyNotExecuteWixAPI',
+    'editorRequest',
+    'templateRequest'
 ];
 const EMAIL = /[A-Z0-9._%+-]+@[A-Z0-9-]+(?:\.[A-Z0-9-]+)*\.[A-Z]{2,}/gi;
 // A secret's value after its name: "password: x", "token=x", "the password is x",
@@ -70,10 +73,76 @@ function redactInfoParams(value) {
     }
     return redacted;
 }
+// A `files` argument carries a site's text whole: the upload tool's text bundle
+// (`=== FILE: <path> ===` sections, `base64` for binaries) or a list of
+// `{ path, content }` entries. The BI event goes out as a GET with the
+// arguments in the query string, and a bundle past about 12 KB fails that
+// request and loses the row (2026-10-28: every upload above that size was
+// missing from BI). Recorded instead: the paths and their sizes, as the upload
+// parses them (a base64 file's decoded size), with the path list cut at
+// MAX_LISTED_PATHS_CHARS so a 2,000-file upload stays far below that limit too.
+const MAX_LISTED_PATHS_CHARS = 2_000;
+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));
+}
 // Tool arguments as recorded in BI and error reports: the arguments object, or
 // the MCP SDK's positional argument list, with the free-text info fields
-// redacted.
+// redacted and a `files` argument reduced to its paths and sizes.
 export function serializeToolParamsForBi(args) {
-    return JSON.stringify(Array.isArray(args) ? args.map(redactInfoParams) : redactInfoParams(args));
+    return JSON.stringify(Array.isArray(args) ? args.map(prepareForBi) : prepareForBi(args));
 }
 //# sourceMappingURL=redact-personal-data.js.map

package/build/dts/site-widget-tools/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const SITE_BUILDER_TOOL_NAME = "WixSiteBuilder";
+export declare const SITE_BUILDER_TOOL_NAME = "WixHarmonyEditorBuild";
 export declare const EDIT_SITE_TOOL_NAME = "EditSite";
 export declare const PULL_SITE_JOB_TOOL_NAME = "pullSiteCreationJob";
 export declare const CLAIM_SITE_TOOL_NAME = "ClaimAnonymousSite";
@@ -10,7 +10,7 @@ export declare const PICK_IMAGES_TOOL_NAME = "PickImagesForWixMedia";
 export declare const MEDIA_UPLOAD_URL_TOOL_NAME = "CreateWixMediaUploadUrl";
 /** The Wix business features that send a site to StartHeadlessBuild: what wix-headless-kit ships. */
 export declare const WIX_BUSINESS_FEATURES = "a store, bookings or appointments, rentals, events and tickets, a restaurant menu with online orders or reservations, a blog, a portfolio, pricing plans and memberships, donations, Wix Forms, members and login, a CMS, payments";
-/** WixSiteBuilder's and SearchSiteTemplates' answer when the agent says the user did not ask for them. */
+/** WixHarmonyEditorBuild's and SearchSiteTemplates' answer when the agent says the user did not ask for them. */
 /**
  * The widget payload of a refused editor call: the gallery and builder widgets render nothing
  * for it, since the host mounts them for every call of their tool.
@@ -20,7 +20,7 @@ export declare const NOT_REQUESTED_WIDGET_PAYLOAD: {
 };
 export declare const EDITOR_NOT_REQUESTED_MESSAGE = "Nothing was created: the user did not ask for this. A new site is written in code and uploaded: call StartDeployWebsite, or StartHeadlessBuild when it needs Wix business features. Don't offer Wix's editor or a template instead.";
 /** WixSiteCreation's answer: it no longer opens a chooser, it sends the agent to the code path. */
-export declare const SITE_CREATION_ROUTE_MESSAGE = "A new site is written in code and uploaded. Call StartDeployWebsite now for the upload guide, or StartHeadlessBuild when the site needs Wix business features. Use WixSiteBuilder or SearchSiteTemplates only when the user asked for the Wix Harmony Editor, a template, Wix Studio or the Classic Editor.";
+export declare const SITE_CREATION_ROUTE_MESSAGE = "A new site is written in code and uploaded. Call StartDeployWebsite now for the upload guide, or StartHeadlessBuild when the site needs Wix business features. Use WixHarmonyEditorBuild or SearchSiteTemplates only when the user asked for the Wix Harmony Editor, a template, Wix Studio or the Classic Editor.";
 /** Fallback actions when the industry is generic or unclear. */
 export declare const SITE_CREATION_DEFAULT_ACTIONS = "add products, set up bookings, and adjust your content";
 /**

package/build/dts/site-widget-tools/constants.js

@@ -1,7 +1,7 @@
 // Tool name constants - separated to avoid circular dependencies during widget builds
 // These constants can be imported by both the widgets and the tool implementations
 // Named in SERVER_INSTRUCTIONS (config/default-config.ts): when this tool's name or what it is for changes, update them to match.
-export const SITE_BUILDER_TOOL_NAME = 'WixSiteBuilder';
+export const SITE_BUILDER_TOOL_NAME = 'WixHarmonyEditorBuild';
 export const EDIT_SITE_TOOL_NAME = 'EditSite';
 export const PULL_SITE_JOB_TOOL_NAME = 'pullSiteCreationJob';
 export const CLAIM_SITE_TOOL_NAME = 'ClaimAnonymousSite';
@@ -15,7 +15,7 @@ export const PICK_IMAGES_TOOL_NAME = 'PickImagesForWixMedia';
 export const MEDIA_UPLOAD_URL_TOOL_NAME = 'CreateWixMediaUploadUrl';
 /** The Wix business features that send a site to StartHeadlessBuild: what wix-headless-kit ships. */
 export const WIX_BUSINESS_FEATURES = 'a store, bookings or appointments, rentals, events and tickets, a restaurant menu with online orders or reservations, a blog, a portfolio, pricing plans and memberships, donations, Wix Forms, members and login, a CMS, payments';
-/** WixSiteBuilder's and SearchSiteTemplates' answer when the agent says the user did not ask for them. */
+/** WixHarmonyEditorBuild's and SearchSiteTemplates' answer when the agent says the user did not ask for them. */
 /**
  * The widget payload of a refused editor call: the gallery and builder widgets render nothing
  * for it, since the host mounts them for every call of their tool.
@@ -23,7 +23,7 @@ export const WIX_BUSINESS_FEATURES = 'a store, bookings or appointments, rentals
 export const NOT_REQUESTED_WIDGET_PAYLOAD = { notRequested: true };
 export const EDITOR_NOT_REQUESTED_MESSAGE = `Nothing was created: the user did not ask for this. A new site is written in code and uploaded: call StartDeployWebsite, or StartHeadlessBuild when it needs Wix business features. Don't offer Wix's editor or a template instead.`;
 /** WixSiteCreation's answer: it no longer opens a chooser, it sends the agent to the code path. */
-export const SITE_CREATION_ROUTE_MESSAGE = `A new site is written in code and uploaded. Call StartDeployWebsite now for the upload guide, or StartHeadlessBuild when the site needs Wix business features. Use WixSiteBuilder or SearchSiteTemplates only when the user asked for the Wix Harmony Editor, a template, Wix Studio or the Classic Editor.`;
+export const SITE_CREATION_ROUTE_MESSAGE = `A new site is written in code and uploaded. Call StartDeployWebsite now for the upload guide, or StartHeadlessBuild when the site needs Wix business features. Use WixHarmonyEditorBuild or SearchSiteTemplates only when the user asked for the Wix Harmony Editor, a template, Wix Studio or the Classic Editor.`;
 /** Fallback actions when the industry is generic or unclear. */
 export const SITE_CREATION_DEFAULT_ACTIONS = 'add products, set up bookings, and adjust your content';
 /**

package/build/dts/site-widget-tools/pull-site-creation-job-tool/index.js

@@ -13,7 +13,7 @@ export function addPullSiteJobTool(server, authStrategy, options) {
         title: 'Pull Site Job',
         description: isWidgetClient
             ? 'Poll the status of a site creation or editing job. Do not call this tool unless the user explicitly asks for status polling.'
-            : 'Poll the status of a site creation or editing job. Call this tool with the jobId returned by WixSiteBuilder or EditSite to check if the site build is complete. When the job status is COMPLETED, the response includes the previewUrl and editorUrl.',
+            : 'Poll the status of a site creation or editing job. Call this tool with the jobId returned by WixHarmonyEditorBuild or EditSite to check if the site build is complete. When the job status is COMPLETED, the response includes the previewUrl and editorUrl.',
         inputSchema: {
             jobId: z.string().describe('The job ID to pull')
         },