@wix/mcp 1.0.31 → 1.0.32

package/build/cjs/index.cjs

@@ -15697,9 +15697,9 @@ var require_dist4 = __commonJS({
   }
 });
 
-// ../../node_modules/@wix/http-client/node_modules/https-proxy-agent/dist/parse-proxy-response.js
+// ../../node_modules/https-proxy-agent/dist/parse-proxy-response.js
 var require_parse_proxy_response = __commonJS({
-  "../../node_modules/@wix/http-client/node_modules/https-proxy-agent/dist/parse-proxy-response.js"(exports2) {
+  "../../node_modules/https-proxy-agent/dist/parse-proxy-response.js"(exports2) {
     "use strict";
     var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
       return mod && mod.__esModule ? mod : { "default": mod };
@@ -15793,9 +15793,9 @@ var require_parse_proxy_response = __commonJS({
   }
 });
 
-// ../../node_modules/@wix/http-client/node_modules/https-proxy-agent/dist/index.js
+// ../../node_modules/https-proxy-agent/dist/index.js
 var require_dist5 = __commonJS({
-  "../../node_modules/@wix/http-client/node_modules/https-proxy-agent/dist/index.js"(exports2) {
+  "../../node_modules/https-proxy-agent/dist/index.js"(exports2) {
     "use strict";
     var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -34564,6 +34564,8 @@ var SYSTEM_REMINDER = dedent_default`
   </goal>
   <guidelines>
   if the WixREADME tool is available to you, YOU MUST USE IT AT THE BEGINNING OF ANY CONVERSATION and then continue with calling the other tools and calling the Wix APIs until the task is completed.
+  **Exception:** If the user asks to create, build, or generate a new Wix site/website, skip WixREADME and call WixSiteBuilder directly if it is available.
+  **Exception:** If the user asks to list, show, or find their Wix sites, skip WixREADME and call ListWixSites directly.
   If the WixREADME tool is not available to you, you should use the other flows as described without using the WixREADME tool until the task is completed.
   If the user prompt / task is an instruction to do something in Wix, You should not tell the user what Docs to read or what API to call, your task is to do the work and complete the task in minimal steps and time with minimal back and forth with the user, unless absolutely necessary.
   </guidelines>
@@ -34606,6 +34608,7 @@ var defaultToolDescriptions = {
   `,
   CallWixSiteAPI: dedent_default`
     Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site.
+    **Prefer using the "ListWixSites" tool when the user asks to list or show their sites.** Only use this tool for site listing if the user needs advanced filtering or specific site details beyond what ListWixSites provides.
     For POST/PATCH/PUT requests, pass the request body as a JSON object 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"}}).
     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 by the "WixREADME" tool OR by the "SearchWixRESTDocumentation" tool OR by the "BrowseWixRESTDocsMenu" tool OR by the "ReadFullDocsArticle" tool.
@@ -34618,7 +34621,11 @@ var defaultToolDescriptions = {
     ${SYSTEM_REMINDER}
   `,
   ListWixSites: dedent_default`
-    List Wix sites for the current user, by default it will return all sites, but you can filter by name
+    **Use this tool whenever the user asks to list, show, get, or find their Wix sites.** This is the dedicated tool for listing Wix sites for the current user. By default it returns all sites, but you can filter by name.
+
+    **Do NOT use WixREADME before this tool.** When the user asks to list their sites, call this tool directly — no need to read documentation first.
+
+    **Prefer this tool over CallWixSiteAPI for listing sites.** Call this tool directly — it already knows the correct API and handles everything needed. Only fall back to CallWixSiteAPI if the user needs advanced filtering or specific site details beyond what this tool provides.
     ${SYSTEM_REMINDER}
   `,
   ManageWixSite: dedent_default`
@@ -34660,6 +34667,15 @@ var defaultToolDescriptions = {
     - Site Properties: "https://dev.wix.com/docs/api-reference/business-management/site-properties"
     ${SYSTEM_REMINDER}
   `,
+  WixSiteBuilder: dedent_default`
+    **PRIMARY tool for creating/building/generating a Wix site or website.** This is the preferred and recommended way to create a new Wix site. Use this tool whenever the user asks to build, create, or generate a site/website/application. Do NOT use CreateWixBusinessGuide for site creation — use this tool instead.
+
+    **Do NOT use WixREADME or SearchWixRESTDocumentation before this tool.** When the user asks to build, create, or generate a site, call this tool directly. It handles everything needed for site creation.
+
+    **IMPORTANT: You MUST call this tool to build the site.** Do NOT suggest HTML code, prompt templates, or alternative approaches instead of actually building the site. When a user asks to create a site, your job is to call this tool and build it — not to describe how to build it or suggest alternatives.
+
+    **IMPORTANT: The sitePrompt must be under 6000 characters.** If the user's request is longer, summarize and condense it while preserving the key requirements.
+  `,
   CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix Business (i.e site, app, etc.)
 
@@ -34955,7 +34971,12 @@ var defaultReadmeDocs = [
 
       <flow-description>
       Wix MCP Site Management Flows:
-      
+
+      Site Creation flow (highest priority for site creation requests):
+      1. User asks to create, build, or generate a Wix site/website,
+      2. Call the "WixSiteBuilder" tool directly with the user's prompt. Do NOT call WixREADME first.
+      3. Do NOT suggest HTML code or alternative approaches — actually build the site.
+
       "Recipe" based flow (The most preferred flow):
       1. User asks you to do something,
       2. You use the "WixREADME" tool to get the context, it will return a list of "recipes" which are essentially Wix docs articles that describe how to do something in Wix.
@@ -35024,7 +35045,8 @@ function mergeConfig(base, overrides) {
     getToKnowWixEnabled: overrides.getToKnowWixEnabled ?? base.getToKnowWixEnabled,
     createWixBusinessGuideEnabled: overrides.createWixBusinessGuideEnabled ?? base.createWixBusinessGuideEnabled,
     codeModeEnabled: overrides.codeModeEnabled ?? base.codeModeEnabled,
-    maxResponseSize: overrides.maxResponseSize ?? base.maxResponseSize
+    maxResponseSize: overrides.maxResponseSize ?? base.maxResponseSize,
+    dynamicContextEnabled: overrides.dynamicContextEnabled ?? base.dynamicContextEnabled
   };
 }
 var defaultConfig = {
@@ -35034,11 +35056,271 @@ var defaultConfig = {
   readmeDocs: defaultReadmeDocs,
   // docsTools not set - defaults to all docs tools in addDocsTools()
   getToKnowWixEnabled: true,
-  createWixBusinessGuideEnabled: true
+  createWixBusinessGuideEnabled: true,
+  dynamicContextEnabled: true
+};
+
+// ../dynamic-context-enricher/build/index.mjs
+var __defProp2 = Object.defineProperty;
+var __getOwnPropNames2 = Object.getOwnPropertyNames;
+var __esm2 = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames2(fn)[0]])(fn = 0)), res;
 };
+var __export2 = (target, all) => {
+  for (var name in all)
+    __defProp2(target, name, { get: all[name], enumerable: true });
+};
+var enrich_exports = {};
+__export2(enrich_exports, {
+  enrichDynamicContext: () => enrichDynamicContext
+});
+function snakeToCamel(obj) {
+  if (Array.isArray(obj)) return obj.map(snakeToCamel);
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const camelKey = key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+      result[camelKey] = snakeToCamel(value);
+    }
+    return result;
+  }
+  return obj;
+}
+function formatTimestamp(value) {
+  if (!value) return "";
+  try {
+    const date3 = new Date(value);
+    return date3.toLocaleDateString("en-US", {
+      month: "short",
+      day: "2-digit",
+      year: "numeric",
+      hour: "2-digit",
+      minute: "2-digit",
+      hour12: false,
+      timeZone: "UTC"
+    });
+  } catch {
+    return value;
+  }
+}
+function capitalize(s) {
+  if (!s) return s;
+  return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function renderAccountHeader(account) {
+  const lines = [];
+  if (account.displayName) {
+    lines.push(`**Account**: ${account.displayName}`);
+  }
+  if (account.id) {
+    lines.push(`**Account ID**: \`${account.id}\``);
+  }
+  const meta = [];
+  if (account.status) meta.push(`Status: **${account.status}**`);
+  if (account.coBranding && account.coBranding !== "None" && account.coBranding !== "CO_BRANDING_UNSPECIFIED") {
+    meta.push("Co-branded");
+  }
+  if (meta.length) lines.push(meta.join(" \xB7 "));
+  if (account.createdDate) {
+    let dateLine = `**Created**: ${formatTimestamp(account.createdDate)}`;
+    if (account.updatedDate) {
+      dateLine += ` \xB7 **Updated**: ${formatTimestamp(account.updatedDate)}`;
+    }
+    lines.push(dateLine);
+  }
+  return lines.length ? lines.join("\n") : "";
+}
+function renderStatusBadges(site) {
+  const tags = [];
+  tags.push(site.published ? "Published" : "Draft");
+  if (site.premium) tags.push("Premium");
+  if (site.domainConnected) tags.push("Custom Domain");
+  if (site.editorType && site.editorType !== "EDITOR_TYPE_UNSPECIFIED" && site.editorType !== "UNKNOWN") {
+    tags.push(capitalize(site.editorType.replace(/_/g, " ").toLowerCase()));
+  }
+  return tags.join(" \xB7 ");
+}
+function renderApps(apps) {
+  const relevant = apps.filter((a) => a.appId && KNOWN_APPS[a.appId]).sort(
+    (a, b) => (KNOWN_APPS[a.appId] ?? "").localeCompare(KNOWN_APPS[b.appId] ?? "")
+  );
+  if (!relevant.length) return "";
+  const lines = [];
+  for (const app of relevant) {
+    let line = `- **${KNOWN_APPS[app.appId]}**`;
+    if (app.catalogVersion) {
+      line += ` \u2014 catalog: **${app.catalogVersion}**`;
+    }
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+function renderProperties(props) {
+  const items = [];
+  if (props.language) items.push(`**Language**: ${props.language}`);
+  if (props.locale?.country) items.push(`**Country**: ${props.locale.country}`);
+  if (props.paymentCurrency) items.push(`**Currency**: ${props.paymentCurrency}`);
+  if (props.timeZone) items.push(`**Timezone**: ${props.timeZone}`);
+  if (props.email) items.push(`**Email**: ${props.email}`);
+  if (props.phone) items.push(`**Phone**: ${props.phone}`);
+  return items.join("\n");
+}
+function renderCmsCollections(collections) {
+  const nonEmpty = collections.filter(
+    (c) => c.displayName || c.fields && c.fields.length > 0
+  );
+  if (!nonEmpty.length) return "";
+  const lines = [];
+  for (const col of nonEmpty) {
+    const name = col.displayName ?? col.id ?? "Unnamed";
+    lines.push(`- **${name}**`);
+    const customFields = (col.fields ?? []).filter((f) => !f.systemField);
+    if (customFields.length) {
+      for (const field of customFields) {
+        const fieldName = field.displayName ?? field.key ?? "";
+        let fieldLine = `  - ${fieldName}`;
+        if (field.type) fieldLine += ` (\`${field.type}\`)`;
+        if (field.referencedCollection) {
+          fieldLine += ` \u2192 \`${field.referencedCollection}\``;
+        }
+        lines.push(fieldLine);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+function renderSite(site, index) {
+  const lines = [];
+  const heading = site.displayName ?? `Site ${index}`;
+  lines.push(`## ${index}. ${heading}`);
+  lines.push("");
+  if (site.id) lines.push(`**ID**: \`${site.id}\``);
+  if (site.url) lines.push(`**URL**: [${site.url}](${site.url})`);
+  lines.push(`**Status**: ${renderStatusBadges(site)}`);
+  if (site.createdDate) {
+    let dateLine = `**Created**: ${formatTimestamp(site.createdDate)}`;
+    if (site.updatedDate) {
+      dateLine += ` \xB7 **Updated**: ${formatTimestamp(site.updatedDate)}`;
+    }
+    lines.push(dateLine);
+  }
+  if (site.veloEnabled !== void 0 && site.veloEnabled !== null) {
+    lines.push(`**Velo**: ${site.veloEnabled ? "Enabled" : "Disabled"}`);
+  }
+  if (site.properties) {
+    const propsContent = renderProperties(site.properties);
+    if (propsContent) {
+      lines.push("");
+      lines.push("### Properties");
+      lines.push("");
+      lines.push(propsContent);
+    }
+  }
+  const appsContent = renderApps(site.installedApps ?? []);
+  if (appsContent) {
+    lines.push("");
+    lines.push("### Apps");
+    lines.push("");
+    lines.push(appsContent);
+  }
+  if (site.cmsCollections?.length) {
+    const cmsContent = renderCmsCollections(site.cmsCollections);
+    if (cmsContent) {
+      lines.push("");
+      lines.push("### CMS Collections");
+      lines.push("");
+      lines.push(cmsContent);
+    }
+  }
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  return lines.join("\n");
+}
+function enrichDynamicContext(data) {
+  let parsed = data;
+  if (typeof data === "string") {
+    try {
+      parsed = JSON.parse(data);
+    } catch {
+      return data;
+    }
+  }
+  if (parsed === null || parsed === void 0) return "";
+  if (typeof parsed !== "object") return "";
+  const response = snakeToCamel(parsed);
+  const sections = [];
+  sections.push("# My Wix Sites Context");
+  sections.push("");
+  if (response.account) {
+    const accountSection = renderAccountHeader(response.account);
+    if (accountSection) {
+      sections.push(accountSection);
+    }
+  }
+  const siteCount = response.sites?.length ?? 0;
+  const hasNext = Boolean(response.pagingMetadata?.cursors?.next);
+  let countLine = `_Showing ${siteCount} sites`;
+  if (hasNext) countLine += " (more available)";
+  countLine += "_";
+  sections.push(countLine);
+  sections.push("");
+  sections.push("---");
+  sections.push("");
+  if (response.sites?.length) {
+    for (let i = 0; i < response.sites.length; i++) {
+      sections.push(renderSite(response.sites[i], i + 1));
+    }
+  }
+  if (!response.account && !siteCount) return "";
+  return sections.join("\n");
+}
+var KNOWN_APPS;
+var init_enrich = __esm2({
+  "src/enrich.ts"() {
+    "use strict";
+    KNOWN_APPS = {
+      "14bcded7-0066-7c35-14d7-466cb3f09103": "Wix Bookings",
+      "215238eb-22a5-4c36-9e7b-e7c08025e04e": "Wix Stores",
+      "9a5d83fd-8570-482e-81ab-cfa88942ee60": "Wix Restaurants (Orders)",
+      "b278a256-2757-4f19-9313-c05c783bec92": "Wix Restaurants (Menus)"
+    };
+  }
+});
+init_enrich();
+var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+async function getDynamicContext(auth, httpClient6, filter) {
+  const { enrichDynamicContext: enrichDynamicContext2 } = await Promise.resolve().then(() => (init_enrich(), enrich_exports));
+  try {
+    const accountHeaders = await auth.getAccountAuthHeaders();
+    const body = {};
+    if (filter?.siteId) body.site_id = filter.siteId;
+    else if (filter?.siteName) body.site_name = filter.siteName;
+    const response = await httpClient6.request({
+      url: DYNAMIC_CONTEXT_URL,
+      method: "POST",
+      headers: { ...accountHeaders, "Content-Type": "application/json" },
+      data: body
+    });
+    return enrichDynamicContext2(response.data);
+  } catch (error2) {
+    console.error(
+      `[dynamic-context-enricher] Fetch failed: ${error2.message}`
+    );
+    return "";
+  }
+}
 
 // src/docs/get-to-know.ts
-async function addGetToKnowTools(server, disableTools = [], toolDescriptions, readmeDocs, authStrategy, picassoPortalUrl) {
+async function addGetToKnowTools({
+  server,
+  disableTools = [],
+  toolDescriptions,
+  readmeDocs,
+  authStrategy,
+  picassoPortalUrl,
+  dynamicContextEnabled
+}) {
   if (disableTools.includes("WixREADME")) {
     return;
   }
@@ -35049,6 +35331,7 @@ async function addGetToKnowTools(server, disableTools = [], toolDescriptions, re
     {},
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_, { httpClient: httpClient6 }) => {
+      const { siteId, siteName } = _;
       const contents = await Promise.all(
         docsToUse.map(
           async ({
@@ -35145,12 +35428,23 @@ Failed to fetch content: ${errorMsg}`
           }
         )
       );
-      const filteredContents = contents.filter(
-        (item) => item !== null
-      );
-      const concatenatedText = filteredContents.map((item) => item.text).join("\n\n");
+      const filter = {};
+      if (siteId) filter.siteId = siteId;
+      if (siteName) filter.siteName = siteName;
+      const dynamicContext = dynamicContextEnabled && authStrategy ? await getDynamicContext(
+        authStrategy,
+        httpClient6,
+        Object.keys(filter).length ? filter : void 0
+      ) : "";
+      const parts = [
+        ...contents.filter(
+          (item) => item !== null
+        ).map((item) => item.text),
+        ...dynamicContext ? [dynamicContext] : []
+      ];
+      const text = parts.join("\n\n");
       return {
-        content: [{ type: "text", text: concatenatedText }]
+        content: [{ type: "text", text }]
       };
     }
   );
@@ -35370,18 +35664,20 @@ var addDocsTools = (server, allowedTools = [
     toolDescriptions,
     readmeDocs,
     authStrategy,
-    picassoPortalUrl
+    picassoPortalUrl,
+    dynamicContextEnabled
   } = options;
   const getDescription = (toolName, defaultDesc) => toolDescriptions?.[toolName] ?? defaultDesc;
   if (getToKnowWixEnabled && !disableTools?.includes("WixREADME")) {
-    addGetToKnowTools(
+    addGetToKnowTools({
       server,
-      disableTools || [],
+      disableTools: disableTools || [],
       toolDescriptions,
       readmeDocs,
       authStrategy,
-      picassoPortalUrl
-    );
+      picassoPortalUrl,
+      dynamicContextEnabled
+    });
   }
   if (createWixBusinessGuideEnabled && !disableTools?.includes("CreateWixBusinessGuide")) {
     addCreateWixBusinessGuideTools(
@@ -36636,6 +36932,7 @@ var CLAIM_SITE_TOOL_NAME = "ClaimAnonymousSite";
 // src/site-widget-tools/site-builder-tool/index.ts
 var httpClient = (0, import_http_client4.createHttpClient)();
 var CREATE_SITE_WIDGET_URI = "ui://widget/site-builder.html";
+var MAX_SITE_PROMPT_CHARS = 6e3;
 function addCreateSiteWidgetTool(server, authStrategy, options) {
   const { getAccountAuthHeaders } = authStrategy;
   const isAnonymous = authStrategy.isAnonymous?.() ?? false;
@@ -36691,7 +36988,7 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
     SITE_BUILDER_TOOL_NAME,
     {
       title: "Wix Site Builder",
-      description: `**PRIMARY tool for creating/building/generating a Wix site or website.** This is the preferred and recommended way to create a new Wix site. Use this tool whenever the user asks to build, create, or generate a site/website/application. Do NOT use CreateWixBusinessGuide for site creation \u2014 use this tool instead.`,
+      description: options?.toolDescriptions?.[SITE_BUILDER_TOOL_NAME] ?? defaultToolDescriptions[SITE_BUILDER_TOOL_NAME],
       inputSchema: {
         jobId: external_exports.string().optional().describe(
           "The job ID of the site build. If not provided, a new job will be created."
@@ -36712,6 +37009,26 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
         `[${SITE_BUILDER_TOOL_NAME}] \u{1F680} Start Building Your Site tool invoked!`,
         { prompt: args.sitePrompt, jobId: args.jobId }
       );
+      const charCount = args.sitePrompt.length;
+      if (charCount > MAX_SITE_PROMPT_CHARS) {
+        console.log(
+          `[${SITE_BUILDER_TOOL_NAME}] The site prompt is too long (${charCount} characters). Please shorten it to under ${MAX_SITE_PROMPT_CHARS} characters and try again.`
+        );
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `The site prompt is too long (${charCount} characters). Please shorten it to under ${MAX_SITE_PROMPT_CHARS} characters and try again.`
+            }
+          ],
+          structuredContent: {
+            success: false,
+            status: `Prompt exceeds maximum length of ${MAX_SITE_PROMPT_CHARS} characters`,
+            jobId: null
+          }
+        };
+      }
       let jobId;
       if (args.jobId) {
         console.log(
@@ -39020,7 +39337,9 @@ function createWixToolkit(options) {
       authStrategy
     });
   } else {
-    addDocsTools(server, void 0, { authStrategy });
+    addDocsTools(server, void 0, {
+      authStrategy
+    });
   }
   if (api) {
     const {
@@ -39174,15 +39493,23 @@ function createWixToolkit(options) {
     getTools: () => allTools,
     getTool: (name) => toolsByName.get(name),
     getToolNames: () => allTools.map((t) => t.name),
-    preloadReadme: async () => {
+    preloadReadme: async (filter) => {
       const readmeTool = toolsByName.get("WixREADME");
       if (!readmeTool) return null;
       try {
-        const result = await readmeTool.execute({});
+        const result = await readmeTool.execute(filter ?? {});
         return extractText(result);
       } catch {
         return null;
       }
+    },
+    preloadDynamicContext: async (filter) => {
+      try {
+        const httpClient6 = new import_http_client10.HttpClient();
+        return await getDynamicContext(authStrategy, httpClient6, filter) || null;
+      } catch {
+        return null;
+      }
     }
   };
 }