@wix/mcp 1.0.28 → 1.0.30

package/build/cjs/index.cjs

@@ -20393,6 +20393,7 @@ __export(index_exports, {
   VALID_DOCS_TOOLS: () => VALID_DOCS_TOOLS,
   WixMcpServer: () => WixMcpServer,
   addApiCallTool: () => addApiCallTool,
+  addCodeModeTools: () => addCodeModeTools,
   addCreateSiteWidgetTool: () => addCreateSiteWidgetTool,
   addDocsResources: () => addDocsResources,
   addDocsTools: () => addDocsTools,
@@ -35614,6 +35615,8 @@ var runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = f
     kbNames.push("HEADLESS_KB_ID");
   } else if (toolName === "VELO") {
     kbNames.push("VELO_DOCS_KB_ID", "VELO_METHODS_KB_ID");
+  } else if (toolName === "CLI") {
+    kbNames.push("CLI_KB_ID");
   }
   logger2.log(
     `[SemanticSearch] Tool: ${toolName}, KBs: [${kbNames.join(", ")}], Query: "${toolParams.searchTerm}"`
@@ -36114,7 +36117,8 @@ var defaultToolDescriptions = {
     ${SYSTEM_REMINDER}
   `,
   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,
+    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.
+    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.
     Error Handling:
@@ -36131,6 +36135,7 @@ var defaultToolDescriptions = {
   `,
   ManageWixSite: dedent_default`
     Use account level API in order to create a site, update a site and publish site.
+    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.
     ${SYSTEM_REMINDER}
@@ -36208,6 +36213,148 @@ var defaultToolDescriptions = {
   `,
   VeloREADME: dedent_default`
     This tool is set for providing Velo context in order to be used by the agent for executing Velo-related tasks.
+  `,
+  SearchWixCLIDocumentation: dedent_default`
+    Searches the Wix CLI documentation for website development and CLI commands.
+    Use this tool when you need information about Wix CLI commands, local development workflows, or CLI-based website development.
+    Specify what you need information about (e.g., 'wix dev command', 'local development setup', 'CLI authentication', 'wix deploy').
+    If you can't find what you need, try to rephrase your search term or use bigger maxResults value.
+    ${SYSTEM_REMINDER}
+  `,
+  SearchWixAPISpec: dedent_default`
+    Search the Wix REST API documentation by writing JavaScript code that runs in a sandboxed environment.
+    Your code has access to two globals:
+
+    **lightIndex** — Array of all Wix REST API resources (~330):
+    \`\`\`typescript
+    interface LightResource {
+      name: string;           // e.g. "Products V3", "Contact V4"
+      resourceId: string;
+      menuPath: string[];     // e.g. ["business-solutions", "stores", "catalog-v3", "products-v3"]
+      methods: Array<{
+        operationId: string;  // e.g. "wix.stores.catalog.v3.CatalogApi.CreateProduct"
+        summary: string;      // e.g. "Create Product"
+        httpMethod: string;   // "get" | "post" | "patch" | "delete"
+        path: string;         // e.g. "/v3/products"
+        description: string;  // truncated to 200 chars
+      }>;
+    }
+    \`\`\`
+
+    **getResourceSchema(resourceId)** — Async function returning the full schema for a resource:
+    \`\`\`typescript
+    interface FullSchema {
+      title: string;
+      description: string;
+      fqdn: string;
+      methods: Array<{
+        summary: string;
+        description: string;
+        operationId: string;
+        httpMethod: string;
+        path: string;
+        servers: Array<{ url: string }>;           // Base URLs (e.g. "https://www.wixapis.com/...")
+        requestBody: object | null;
+        responses: object;
+        parameters: Array<object>;
+        permissions: string[];
+        legacyExamples: Array<{                    // Curl examples
+          content: { title: string; request: string; response: string };
+        }>;
+        sdkData: {                                 // JS SDK examples
+          packageName: string;
+          namespace: string;
+          methodExamples: Array<{ title: string; content: string }>;
+        };
+      }>;
+      components: { schemas: object };
+    }
+    \`\`\`
+
+    Your code MUST be an \`async function()\` expression that returns a value.
+
+    Top-level verticals: business-solutions (stores, e-commerce, bookings, events, restaurants, pricing-plans, coupons), crm (contacts, members, loyalty-program, forms, community), business-management (payments, invoices, automations), assets (media, files), app-management (oauth, billing), account-level, site.
+
+    Examples:
+
+    Find APIs by keyword:
+    \`\`\`javascript
+    async function() {
+      return lightIndex.filter(r => r.methods.some(m => m.summary.toLowerCase().includes("query products")))
+        .map(r => ({ name: r.name, methods: r.methods.map(m => m.summary + " (" + m.httpMethod.toUpperCase() + " " + m.path + ")") }));
+    }
+    \`\`\`
+
+    Get full schema with base URL, curl examples, and permissions:
+    \`\`\`javascript
+    async function() {
+      const resource = lightIndex.find(r => r.name === "Contact V4");
+      const schema = await getResourceSchema(resource.resourceId);
+      const method = schema.methods.find(m => m.summary === "Query Contacts");
+      return {
+        baseUrl: method.servers?.find(s => s.url.includes("wixapis.com"))?.url,
+        path: method.path,
+        httpMethod: method.httpMethod,
+        permissions: method.permissions,
+        requestBody: method.requestBody,
+        curlExample: method.legacyExamples?.[0]?.content,
+        sdkExample: method.sdkData?.methodExamples?.[0]?.content
+      };
+    }
+    \`\`\`
+
+    Browse a vertical:
+    \`\`\`javascript
+    async function() {
+      return lightIndex.filter(r => r.menuPath[0] === "crm")
+        .map(r => ({ name: r.name, path: r.menuPath.join(" > "), methods: r.methods.length }));
+    }
+    \`\`\`
+  `,
+  ExecuteWixAPI: dedent_default`
+    Execute JavaScript code against the Wix REST API. First use the 'SearchWixAPISpec' tool to find the right endpoints, base URLs, and request/response schemas. Then write code using the wix.request() function. Auth is handled automatically — do not set Authorization headers.
+
+    Available in your code:
+    \`\`\`typescript
+    interface WixRequestOptions {
+      method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+      url: string;           // Full URL from schema servers field, e.g. "https://www.wixapis.com/contacts/v4/contacts"
+      body?: unknown;
+      headers?: Record<string, string>;  // Do NOT set Authorization — it is injected automatically
+    }
+
+    interface WixResponse<T = unknown> {
+      status: number;
+      data: T;
+    }
+
+    declare const wix: {
+      request<T = unknown>(options: WixRequestOptions): Promise<WixResponse<T>>;
+    };
+
+    declare const siteId: string | undefined;
+    \`\`\`
+
+    Your code MUST be an \`async function()\` expression that returns the result.
+
+    Example — query products then update one:
+    \`\`\`javascript
+    async function() {
+      const list = await wix.request({
+        method: "POST",
+        url: "https://www.wixapis.com/stores/v1/products/query",
+        body: { query: { paging: { limit: 5 } } }
+      });
+      const product = list.data.products[0];
+      if (!product) return { error: "No products found" };
+      const updated = await wix.request({
+        method: "PATCH",
+        url: \`https://www.wixapis.com/stores/v1/products/\${product.id}\`,
+        body: { product: { name: "Updated Name" } }
+      });
+      return updated.data;
+    }
+    \`\`\`
   `
 };
 var defaultReadmeDocs = [
@@ -36291,7 +36438,8 @@ function mergeConfig(base, overrides) {
     toolHints: { ...base.toolHints, ...overrides.toolHints },
     docsTools: overrides.docsTools ?? base.docsTools,
     getToKnowWixEnabled: overrides.getToKnowWixEnabled ?? base.getToKnowWixEnabled,
-    createWixBusinessGuideEnabled: overrides.createWixBusinessGuideEnabled ?? base.createWixBusinessGuideEnabled
+    createWixBusinessGuideEnabled: overrides.createWixBusinessGuideEnabled ?? base.createWixBusinessGuideEnabled,
+    codeModeEnabled: overrides.codeModeEnabled ?? base.codeModeEnabled
   };
 }
 var defaultConfig = {
@@ -36525,7 +36673,7 @@ var paramDescriptions = {
       `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`
     ].join("\n"),
     method: "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)",
-    body: 'The request body object. YOU MUST NEVER MAKE UP A BODY - the body should be based on the conversation context, i.e from the user prompt OR got into the conversation context by the "ReadFullDocsArticle" tool OR by the "ReadFullDocsMethodSchema" tool - i.e based on the API docs, a relevant recipe you read (preferably), a code example you found in the docs, a schema you read etc.. YOU MUST NEVER ASSUME YOU KNOW WHAT THE BODY SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT. Prefer reading relevant recipes if you have them in context for understand the body schema for API calls.',
+    body: 'The request body as a JSON object with all the required fields and values, including nested objects. Pass the actual object, NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - the body should be based on the conversation context, i.e from the user prompt OR got into the conversation context by the "ReadFullDocsArticle" tool OR by the "ReadFullDocsMethodSchema" tool - i.e based on the API docs, a relevant recipe you read (preferably), a code example you found in the docs, a schema you read etc.. YOU MUST NEVER ASSUME YOU KNOW WHAT THE BODY SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT. Prefer reading relevant recipes if you have them in context for understand the body schema for API calls.',
     reason: "One sentence explaining the original user request and why you are calling this API to complete it.",
     sourceDocUrl: [
       "The URL of the documentation or recipe where you found this API endpoint.",
@@ -36543,7 +36691,7 @@ var paramDescriptions = {
   ManageWixSite: {
     url: "The url of the api to call - ALWAYS get the information from the Wix REST docs DONT GUESS IT, the URL MUST BE ABSOLUTE URL",
     method: "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)",
-    body: 'The request body object. YOU MUST NEVER MAKE UP A BODY - this should be based on the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool or from the "ReadFullDocsMethodSchema" tool - i.e based on the API docs. YOU MUST NEVER ASSUME YOU KNOW WHAT THE SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT.'
+    body: 'The request body as a JSON object with all the required fields and values, including nested objects. Pass the actual object, NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - this should be based on the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool or from the "ReadFullDocsMethodSchema" tool - i.e based on the API docs. YOU MUST NEVER ASSUME YOU KNOW WHAT THE SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT.'
   },
   SearchWixWDSDocumentation: {
     searchTerm: "The search term to search for in the Wix Design System Documentation",
@@ -36574,6 +36722,11 @@ var paramDescriptions = {
     searchTerm: "The search term to search for in the Velo Documentation",
     maxResults: "The maximum number of results to return, default is 5, max is 15"
   },
+  SearchWixCLIDocumentation: {
+    searchTerm: "The search term to search for in the Wix CLI Documentation",
+    maxResults: "The maximum number of results to return, default is 5, max is 15",
+    reason: "One sentence describing the original user request and the task you are trying to accomplish with this search."
+  },
   ReadFullDocsArticle: {
     articleUrl: "The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../.../..."
   },
@@ -36612,7 +36765,8 @@ var VALID_DOCS_TOOLS = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "VELO",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ];
 var addDocsTools = (server, allowedTools = [
   "WDS",
@@ -36620,7 +36774,8 @@ var addDocsTools = (server, allowedTools = [
   "SDK",
   "BUILD_APPS",
   "WIX_HEADLESS",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ], options = {}) => {
   const {
     getToKnowWixEnabled = false,
@@ -37029,6 +37184,62 @@ var addDocsTools = (server, allowedTools = [
       }
     );
   }
+  if (allowedTools.includes("CLI") && !disableTools?.includes("SearchWixCLIDocumentation")) {
+    server.tool(
+      "SearchWixCLIDocumentation",
+      getDescription(
+        "SearchWixCLIDocumentation",
+        defaultToolDescriptions.SearchWixCLIDocumentation ?? ""
+      ),
+      (() => {
+        const d = desc("SearchWixCLIDocumentation");
+        return {
+          searchTerm: external_exports.string().describe(d.searchTerm),
+          maxResults: external_exports.number().describe(d.maxResults).min(1).max(15).optional().default(10),
+          reason: external_exports.string().describe(d.reason)
+        };
+      })(),
+      { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+      async ({ searchTerm, maxResults, reason }, { panorama }) => {
+        try {
+          logger2.log(
+            `[SearchWixCLIDocumentation] searchTerm="${searchTerm}", reason="${reason}"`
+          );
+          const result = await runSemanticSearchAndFormat({
+            toolName: "CLI",
+            toolParams: {
+              searchTerm
+            },
+            maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
+            linesInEachResult: 15
+          });
+          return {
+            content: [
+              {
+                type: "text",
+                text: result
+              }
+            ]
+          };
+        } catch (error2) {
+          panorama.errorMonitor().reportError(error2);
+          captureException(error2, {
+            tags: {
+              componentId: "SearchWixCLIDocumentation",
+              toolName: "SearchWixCLIDocumentation"
+            }
+          });
+          logger2.error(
+            `Error searching for ${searchTerm} in Wix CLI: ${error2}`
+          );
+          return {
+            isError: true,
+            content: [{ type: "text", text: "Error: " + error2.message }]
+          };
+        }
+      }
+    );
+  }
   if (!disableTools?.includes("ReadFullDocsArticle")) {
     server.tool(
       "ReadFullDocsArticle",
@@ -37882,20 +38093,18 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
       };
     }
   );
-  const isCompactPrompt = options?.compactSitePrompt ?? true;
-  const compactSuffix = " Keep the prompt short and concise, single page site if possible, do not add pages that are not explicitly requested.";
-  const toolDescription = `A tool that builds a site using Wix. Use this ONLY when the user explicitly asks to build/create/generate a site/website/application. The widget resource is available at ${CREATE_SITE_WIDGET_URI}.${isCompactPrompt ? compactSuffix : ""}`;
-  const sitePromptDescription = `The prompt to build the site.${isCompactPrompt ? compactSuffix : ""} If not provided, the user will be asked to provide a prompt.`;
   server.registerTool(
     SITE_BUILDER_TOOL_NAME,
     {
       title: "Wix Site Builder",
-      description: toolDescription,
+      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.`,
       inputSchema: {
         jobId: external_exports.string().optional().describe(
           "The job ID of the site build. If not provided, a new job will be created."
         ),
-        sitePrompt: external_exports.string().describe(sitePromptDescription)
+        sitePrompt: external_exports.string().describe(
+          `The prompt to build the site. If not provided, the user will be asked to provide a prompt.`
+        )
       },
       _meta: toolMeta(),
       annotations: {
@@ -37907,7 +38116,7 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
     async (args, { setToolBiParams }) => {
       console.log(
         `[${SITE_BUILDER_TOOL_NAME}] \u{1F680} Start Building Your Site tool invoked!`,
-        { prompt: args.sitePrompt, jobId: args.jobId, isCompactPrompt }
+        { prompt: args.sitePrompt, jobId: args.jobId }
       );
       const accountHeaders = await getAccountAuthHeaders();
       let jobId;
@@ -37990,9 +38199,7 @@ async function buildHarmonySite({
     withScreenshots: true,
     actionContext: "wix-mcp"
   };
-  console.log("[buildHarmonySite] request", {
-    buildSiteRequest
-  });
+  console.log("[buildHarmonySite] request", { buildSiteRequest });
   try {
     const response = await httpClient.post(
       "https://manage.wix.com/_api/harmony-site-builder/generate-harmony-site",
@@ -39485,6 +39692,170 @@ function createWixToolkit(options) {
     }
   };
 }
+
+// src/code-mode/index.ts
+var SEARCH_TOOL_NAME = "SearchWixAPISpec";
+var EXECUTE_TOOL_NAME = "ExecuteWixAPI";
+function addCodeModeTools(server, options) {
+  const {
+    codeModeBaseUrl,
+    authStrategy,
+    disableTools = [],
+    toolDescriptions
+  } = options;
+  if (!disableTools.includes(SEARCH_TOOL_NAME)) {
+    addSearchTool(server, codeModeBaseUrl, disableTools, toolDescriptions);
+  }
+  if (!disableTools.includes(EXECUTE_TOOL_NAME) && authStrategy) {
+    addExecuteTool(
+      server,
+      codeModeBaseUrl,
+      authStrategy,
+      disableTools,
+      toolDescriptions
+    );
+  }
+}
+function addSearchTool(server, codeModeBaseUrl, disableTools, toolDescriptions) {
+  const searchUrl = `${codeModeBaseUrl}/api/code-mode/search`;
+  server.tool(
+    SEARCH_TOOL_NAME,
+    toolDescriptions?.[SEARCH_TOOL_NAME] ?? defaultToolDescriptions.SearchWixAPISpec,
+    {
+      code: external_exports.string().describe(
+        "JavaScript async function() expression to search the Wix API index. Has access to `lightIndex` (array of resources) and `getResourceSchema(resourceId)` (returns full schema)."
+      )
+    },
+    { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+    async ({ code }) => {
+      logger2.log(`[SearchWixAPISpec] Executing search (${code.length} chars)`);
+      try {
+        const resp = await fetch(searchUrl, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ code })
+        });
+        if (!resp.ok) {
+          const errorBody = await resp.text();
+          logger2.log(`[SearchWixAPISpec] HTTP ${resp.status}: ${errorBody}`);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Search error (${resp.status}): ${errorBody}`,
+                isError: true
+              }
+            ]
+          };
+        }
+        const data = await resp.json();
+        if (data.error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Search error: ${data.error}`,
+                isError: true
+              }
+            ]
+          };
+        }
+        const text = typeof data.result === "string" ? data.result : JSON.stringify(data.result, null, 2);
+        return {
+          content: [{ type: "text", text }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger2.log(`[SearchWixAPISpec] Error: ${message}`);
+        return {
+          content: [
+            { type: "text", text: `Search error: ${message}`, isError: true }
+          ]
+        };
+      }
+    }
+  );
+}
+function addExecuteTool(server, codeModeBaseUrl, authStrategy, disableTools, toolDescriptions) {
+  const executeUrl = `${codeModeBaseUrl}/api/code-mode/execute`;
+  server.tool(
+    EXECUTE_TOOL_NAME,
+    toolDescriptions?.[EXECUTE_TOOL_NAME] ?? defaultToolDescriptions.ExecuteWixAPI,
+    {
+      code: external_exports.string().describe(
+        "JavaScript async function() expression to execute against the Wix REST API. Has access to `wix.request({ method, url, body, headers })` and `siteId`."
+      ),
+      siteId: external_exports.string().optional().describe(
+        "Wix site ID to execute against. You can find site IDs using the ListWixSites tool or by querying the Wix API."
+      )
+    },
+    { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+    async ({ code, siteId }) => {
+      if (!siteId) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Error: siteId is required. You can list available sites using the ListWixSites tool or by querying the Wix Sites API.",
+              isError: true
+            }
+          ]
+        };
+      }
+      logger2.log(
+        `[ExecuteWixAPI] Executing code (${code.length} chars), siteId=${siteId}`
+      );
+      try {
+        const authHeaders = await authStrategy.getSiteAuthHeaders(siteId);
+        const resp = await fetch(executeUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            ...authHeaders
+          },
+          body: JSON.stringify({ code, siteId })
+        });
+        if (!resp.ok) {
+          const errorBody = await resp.text();
+          logger2.log(`[ExecuteWixAPI] HTTP ${resp.status}: ${errorBody}`);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Execute error (${resp.status}): ${errorBody}`,
+                isError: true
+              }
+            ]
+          };
+        }
+        const data = await resp.json();
+        if (data.error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Execute error: ${data.error}`,
+                isError: true
+              }
+            ]
+          };
+        }
+        const text = typeof data.result === "string" ? data.result : JSON.stringify(data.result, null, 2);
+        return {
+          content: [{ type: "text", text }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger2.log(`[ExecuteWixAPI] Error: ${message}`);
+        return {
+          content: [
+            { type: "text", text: `Execute error: ${message}`, isError: true }
+          ]
+        };
+      }
+    }
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   MENU_CONTENT_THRESHOLD,
@@ -39493,6 +39864,7 @@ function createWixToolkit(options) {
   VALID_DOCS_TOOLS,
   WixMcpServer,
   addApiCallTool,
+  addCodeModeTools,
   addCreateSiteWidgetTool,
   addDocsResources,
   addDocsTools,