@wix/mcp 1.0.29 → 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}"`
@@ -36210,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 = [
@@ -36293,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 = {
@@ -36576,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/.../.../..."
   },
@@ -36614,7 +36765,8 @@ var VALID_DOCS_TOOLS = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "VELO",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ];
 var addDocsTools = (server, allowedTools = [
   "WDS",
@@ -36622,7 +36774,8 @@ var addDocsTools = (server, allowedTools = [
   "SDK",
   "BUILD_APPS",
   "WIX_HEADLESS",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ], options = {}) => {
   const {
     getToKnowWixEnabled = false,
@@ -37031,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",
@@ -37884,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: {
@@ -37909,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;
@@ -37992,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",
@@ -39487,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,
@@ -39495,6 +39864,7 @@ function createWixToolkit(options) {
   VALID_DOCS_TOOLS,
   WixMcpServer,
   addApiCallTool,
+  addCodeModeTools,
   addCreateSiteWidgetTool,
   addDocsResources,
   addDocsTools,