@wix/mcp 1.0.25 → 1.0.26

package/build/esm/index.js

@@ -28700,23 +28700,32 @@ var runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = f
   const url = new URL(
     `https://www.wixapis.com/mcp-docs-search/v1/search?maxResults=${maxResults}&rerank=${rerank}`
   );
+  const kbNames = [];
   if (toolName === "SDK") {
-    url.searchParams.append("kbName", "SDK_SCHEMAS_KB_ID");
-    url.searchParams.append("kbName", "SDK_DOCS_KB_ID");
+    kbNames.push(
+      "API_REFERENCE_SDK_KB_ID",
+      "FRONTEND_SDK_AND_EXTENSIONS_KB_ID",
+      "REST_DOCS_KB_ID"
+    );
   } else if (toolName === "REST" || toolName === "BUSINESS_SOLUTIONS") {
     if (toolName === "REST") {
-      url.searchParams.append("kbName", "REST_METHODS_KB_ID");
+      kbNames.push("REST_METHODS_KB_ID");
     }
-    url.searchParams.append("kbName", "REST_DOCS_KB_ID");
+    kbNames.push("REST_DOCS_KB_ID");
   } else if (toolName === "WDS") {
-    url.searchParams.append("kbName", "WDS_DOCS_KB_ID");
+    kbNames.push("WDS_DOCS_KB_ID");
   } else if (toolName === "BUILD_APPS") {
-    url.searchParams.append("kbName", "BUILD_APPS_KB_ID");
+    kbNames.push("BUILD_APPS_KB_ID");
   } else if (toolName === "WIX_HEADLESS") {
-    url.searchParams.append("kbName", "HEADLESS_KB_ID");
+    kbNames.push("HEADLESS_KB_ID");
   } else if (toolName === "VELO") {
-    url.searchParams.append("kbName", "VELO_DOCS_KB_ID");
-    url.searchParams.append("kbName", "VELO_METHODS_KB_ID");
+    kbNames.push("VELO_DOCS_KB_ID", "VELO_METHODS_KB_ID");
+  }
+  logger2.log(
+    `[SemanticSearch] Tool: ${toolName}, KBs: [${kbNames.join(", ")}], Query: "${toolParams.searchTerm}"`
+  );
+  for (const kbName of kbNames) {
+    url.searchParams.append("kbName", kbName);
   }
   for (const [key, value] of Object.entries(toolParams)) {
     url.searchParams.append(key, value);
@@ -28905,6 +28914,39 @@ ${preview}${truncated}`);
   return content;
 }
 
+// src/docs/normalize-menu-content.ts
+var SCHEMA_HINT = "use ReadFullDocsMethodSchema to get the method full schema";
+var ARTICLE_HINT = "use ReadFullDocsArticle to see method code examples";
+var MENU_HINT = "use BrowseWixRESTDocsMenu to browse this category";
+function safeDecode(encoded) {
+  try {
+    return decodeURIComponent(encoded);
+  } catch {
+    return encoded;
+  }
+}
+function normalizeMenuContent(content) {
+  try {
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-article-content\?articleUrl=([^&)]+)[^)]*schema=true[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${SCHEMA_HINT})](${safeDecode(encoded)})`
+    );
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-article-content\?articleUrl=([^&)]+)[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${ARTICLE_HINT})](${safeDecode(encoded)})`
+    );
+    content = content.replace(
+      /\[([^\]]+)\]\(https:\/\/[^)]*get-menu-content\?url=([^&)]+)[^)]*\)/g,
+      (_, title, encoded) => `[${title} (${MENU_HINT})](${safeDecode(encoded)})`
+    );
+  } catch (error2) {
+    logger2.error(
+      `[BrowseWixRESTDocsMenu] Failed to normalize menu content: ${error2}`
+    );
+  }
+  return content;
+}
+
 // ../../node_modules/dedent/dist/dedent.mjs
 function ownKeys(object3, enumerableOnly) {
   var keys = Object.keys(object3);
@@ -29813,7 +29855,8 @@ var addDocsTools = (server, allowedTools = [
                 type: "text",
                 text: [
                   result,
-                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method."
+                  "you should use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method.",
+                  "IMPORTANT: When sharing dev.wix.com/docs/rest or dev.wix.com/docs/api-reference links with the user, add ?apiView=SDK suffix to each link (or &apiView=SDK if the URL already has query params). for other prefix (dev.wix.com/docs/sdk) - no need to add the suffix."
                 ].join("\n---\n")
               }
             ]
@@ -30141,7 +30184,7 @@ var addDocsTools = (server, allowedTools = [
             content: [
               {
                 type: "text",
-                text: content
+                text: normalizeMenuContent(content)
               }
             ]
           };
@@ -30718,7 +30761,7 @@ var PULL_SITE_JOB_TOOL_NAME = "pullSiteCreationJob";
 // src/site-widget-tools/site-builder-tool/index.ts
 var httpClient = createHttpClient2();
 var CREATE_SITE_WIDGET_URI = "ui://widget/site-builder.html";
-function addCreateSiteWidgetTool(server, authStrategy) {
+function addCreateSiteWidgetTool(server, authStrategy, options) {
   const { getAccountAuthHeaders } = authStrategy;
   const toolMeta = (widgetPayload) => {
     return {
@@ -30827,18 +30870,35 @@ function addCreateSiteWidgetTool(server, authStrategy) {
         jobId = newJobId;
         console.log(`[${SITE_BUILDER_TOOL_NAME}] Created new job:`, jobId);
       }
+      const isWidgetClient = options?.widgetSupported ?? true;
+      const responseText = isWidgetClient ? "Website build started successfully." : [
+        "Website build started successfully.",
+        "",
+        "<agent_instruction>",
+        "IMPORTANT: The website is now being built. You MUST now poll for the build status by calling the",
+        `"${PULL_SITE_JOB_TOOL_NAME}" tool with jobId: "${jobId}".`,
+        "",
+        "Polling instructions:",
+        `1. Call ${PULL_SITE_JOB_TOOL_NAME} with { "jobId": "${jobId}" }`,
+        '2. If the job status is "IN_PROGRESS" or "STARTED", wait approximately 10 seconds, then call again.',
+        '3. Repeat polling until the job status is "COMPLETED" or "FAILED".',
+        "4. When COMPLETED, share the previewUrl with the user so they can see their new website.",
+        "5. If FAILED, inform the user that the site build failed and suggest they try again.",
+        "",
+        "Do NOT mention the jobId to the user. Just confirm the build has started, then begin polling.",
+        "</agent_instruction>"
+      ].join("\n");
       return {
         content: [
           {
             type: "text",
-            text: "Respond only with a confirmation that the website build has started and that progress is available in the widget. No other content is allowed. DO NOT mention jobId."
+            text: responseText
           }
         ],
         structuredContent: {
           success: true,
-          status: "Respond only with a confirmation that the website build has started and that progress is available in the widget. No other content is allowed. DO NOT mention jobId.",
+          status: "Website build started successfully.",
           jobId
-          // Return jobId so model can use it in future calls
         },
         _meta: toolMeta({ jobId, extras: server.getWidgetExtras() })
       };
@@ -31079,13 +31139,13 @@ function siteCreatedUsingWixMcpSrc39Evid1608(params) {
 
 // src/site-widget-tools/pull-site-creation-job-tool/index.ts
 var httpClient3 = createHttpClient2();
-function addPullSiteJobTool(server, authStrategy) {
+function addPullSiteJobTool(server, authStrategy, options) {
   const { getAccountAuthHeaders, getSiteAuthHeaders } = authStrategy;
   server.registerTool(
     PULL_SITE_JOB_TOOL_NAME,
     {
       title: "Pull Site Job",
-      description: "Pull the status of a site job",
+      description: "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. Continue polling every 10 seconds until the job reaches COMPLETED or FAILED status.",
       inputSchema: {
         jobId: zod_default.string().describe("The job ID to pull")
       },
@@ -31096,8 +31156,7 @@ function addPullSiteJobTool(server, authStrategy) {
       },
       _meta: {
         "openai/toolInvocation/invoking": "Fetching codegen job",
-        "openai/toolInvocation/invoked": "Jobs retrieved",
-        "openai/visibility": "private"
+        "openai/toolInvocation/invoked": "Jobs retrieved"
       }
     },
     async (args, { biLogger, setToolBiParams }) => {
@@ -31130,7 +31189,7 @@ function addPullSiteJobTool(server, authStrategy) {
         }
         const job = response.data.job;
         const isEditJob = job.type === "EDIT_SITE";
-        const pullJobMessage = job.status === "COMPLETED" ? `Job completed. previewUrl: ${job.data?.previewUrl} editorUrl: ${job.data?.editorUrl} siteId: ${job.data?.siteId}` : "Job in progress";
+        const isWidgetClient = options?.widgetSupported ?? true;
         if (job.status === "COMPLETED" && job.data?.siteId) {
           console.log(`[pullSiteJob] job is completed ${jobId}`);
           try {
@@ -31189,12 +31248,26 @@ function addPullSiteJobTool(server, authStrategy) {
             );
           }
         }
+        const isInProgress = job.status === "IN_PROGRESS" || job.status === "STARTED";
+        let responseText;
+        if (job.status === "COMPLETED") {
+          responseText = isWidgetClient ? "Site successfully created." : `Site successfully created!
+
+Site URL: ${job.data?.previewUrl}
+Editor URL: ${job.data?.editorUrl}`;
+        } else if (isInProgress) {
+          const pollingHint = !isWidgetClient ? `
+
+<agent_instruction>The job is still in progress. Wait approximately 10 seconds and then call ${PULL_SITE_JOB_TOOL_NAME} again with { "jobId": "${jobId}" }. Do not tell the user about polling details.</agent_instruction>` : "";
+          responseText = `Job in progress.${pollingHint}`;
+        } else {
+          responseText = `Job status: ${job.status}`;
+        }
         return {
           content: [
             {
               type: "text",
-              text: `Job pulled successfully.
-${pullJobMessage}`
+              text: responseText
             }
           ],
           structuredContent: { job: response.data.job }
@@ -31274,7 +31347,7 @@ async function getPublishedSiteUrl({
   return;
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serialization/utils.js
+// ../../node_modules/@wix/metro-runtime/es/build/serialization/utils.js
 function parseLeanSchemaRef(renderedSchemaName = "") {
   const [typeOrName, schemaName] = getSchemaNameAndType(renderedSchemaName);
   if (schemaName) {
@@ -31289,7 +31362,7 @@ function parseLeanSchemaRef(renderedSchemaName = "") {
 }
 var getSchemaNameAndType = (leanSchema) => leanSchema.split("#");
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/utils.js
+// ../../node_modules/@wix/metro-runtime/es/build/utils.js
 function findByPath(obj, path2, defaultValue, suffix) {
   let result = obj;
   for (const field of path2.split(".")) {
@@ -31301,7 +31374,7 @@ function findByPath(obj, path2, defaultValue, suffix) {
   return `${result}${suffix}`;
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/url-resolver.js
+// ../../node_modules/@wix/metro-runtime/es/build/url-resolver.js
 var USER_DOMAIN = "_";
 var DOMAINS = ["wix.com", "editorx.com"];
 var WIX_API_DOMAINS = ["42.wixprod.net", "uw2-edt-1.wixprod.net"];
@@ -31418,7 +31491,7 @@ var utob = (u) => u.replace(re_utob, cb_utob);
 var _encode = _hasBuffer ? (s) => Buffer.from(s, "utf8").toString("base64") : _TE ? (s) => _fromUint8Array(_TE.encode(s)) : (s) => _btoa(utob(s));
 var encode = (src, urlsafe = false) => urlsafe ? _mkUriSafe(_encode(src)) : _encode(src);
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/flatten-params.js
+// ../../node_modules/@wix/metro-runtime/es/build/flatten-params.js
 function flattenParams(data, path2 = "") {
   const params = {};
   Object.entries(data).forEach(([key, value]) => {
@@ -31456,14 +31529,14 @@ function toURLSearchParams(params, isComplexRequest) {
   }
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/domain.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/domain.js
 var ConverterType;
 (function(ConverterType2) {
   ConverterType2[ConverterType2["TO_JSON"] = 0] = "TO_JSON";
   ConverterType2[ConverterType2["FROM_JSON"] = 1] = "FROM_JSON";
-})(ConverterType || (ConverterType = {}));
+})(ConverterType = ConverterType || (ConverterType = {}));
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/serializer.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/serializer.js
 function schemaSerializer(rootSchema, depSchemas = {}, converterSets) {
   return function serialize(json = {}, converterType) {
     return typeof json === "string" ? json : transformSchema(rootSchema, json);
@@ -31514,7 +31587,7 @@ function schemaSerializer(rootSchema, depSchemas = {}, converterSets) {
   };
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/timestamp.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/timestamp.js
 var timestamp = {
   types: ["google.protobuf.Timestamp"],
   [ConverterType.TO_JSON]: {
@@ -31530,7 +31603,7 @@ var timestamp = {
   }
 };
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/field-mask.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/field-mask.js
 var fieldMask = {
   types: ["google.protobuf.FieldMask"],
   [ConverterType.TO_JSON]: {
@@ -31563,7 +31636,7 @@ var fieldMask = {
   }
 };
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/bytes.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/bytes.js
 var bytes = {
   types: ["google.protobuf.BytesValue", "BYTES"],
   [ConverterType.TO_JSON]: {
@@ -31579,7 +31652,7 @@ var bytes = {
   }
 };
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/duration.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/duration.js
 var duration3 = {
   types: ["google.protobuf.Duration"],
   [ConverterType.TO_JSON]: {
@@ -31610,7 +31683,7 @@ function nanosForString(nanos) {
   return res;
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/float.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/float.js
 var float = {
   types: [
     "FLOAT",
@@ -31639,7 +31712,7 @@ var float = {
   }
 };
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/protobuf-converters/converters.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/protobuf-converters/converters.js
 var protobufConverters = [
   timestamp,
   fieldMask,
@@ -31648,7 +31721,7 @@ var protobufConverters = [
   float
 ];
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/serializer/utils.js
+// ../../node_modules/@wix/metro-runtime/es/build/serializer/utils.js
 function typeToConverterSet(converterSets) {
   return converterSets.reduce((result, converterSet) => {
     const types = converterSet.types.reduce((typeResult, type) => {
@@ -31664,7 +31737,7 @@ function typeToConverterSet(converterSets) {
   }, {});
 }
 
-// ../../node_modules/@wix/metro-runtime/dist/esm/ambassador-index.js
+// ../../node_modules/@wix/metro-runtime/es/build/ambassador-index.js
 var ambassadorConverters = typeToConverterSet([...protobufConverters]);
 function serializer(rootSchema, depSchemas = {}) {
   const transform2 = schemaSerializer(rootSchema, depSchemas, ambassadorConverters);
@@ -32336,7 +32409,7 @@ var WWW_PROJECT_V1_PROJECT_API_BASE_URL = "https://manage.wix.com/";
 var WWW_ASSET_V1_ASSET_API_BASE_URL = "https://manage.wix.com/";
 
 // src/wixel/api.ts
-var CONDUCTOR_OVERRIDE = "0061524d-1fe2-4ecc-94a7-44a09d2aab45";
+var CONDUCTOR_OVERRIDE = "f14cea3d-0f6b-448b-9093-d424ab8073b1";
 var COMMON_HEADERS = {};
 function parseWidget(content) {
   const match = content?.match(/<<(.+?)>>/s);
@@ -32522,7 +32595,8 @@ async function sendMessageToWix({
   message,
   wixelAssistantId = WIXEL_ASSISTANT_ID,
   apiBaseURL = GENIE_CHAT_SERVICE_V1_NO_ENTITY_API_BASE_URL,
-  conductorOverride = CONDUCTOR_OVERRIDE
+  conductorOverride = CONDUCTOR_OVERRIDE,
+  images
 }) {
   const httpClient4 = createHttpClient2({
     headers: {
@@ -32537,6 +32611,13 @@ async function sendMessageToWix({
     messageLength: message.length,
     messagePreview: message.substring(0, 300) + (message.length > 300 ? "..." : "")
   });
+  const attachments = images && images.length > 0 ? {
+    attachments: images.map((image, index) => ({
+      fileName: `Image ${index + 1}`,
+      mimeType: "image/png",
+      url: image.download_url
+    }))
+  } : {};
   const response = await httpClient4.request(
     createConversationUserMessage({
       conversationId,
@@ -32548,7 +32629,8 @@ async function sendMessageToWix({
             value: projectId
           }
         ]
-      }
+      },
+      ...attachments
     })
   );
   const userMessage = response.data.userMessage;
@@ -32604,7 +32686,8 @@ async function sendMessageToWixWithAutoConfirmation({
   message,
   wixelAssistantId = WIXEL_ASSISTANT_ID,
   apiBaseURL = GENIE_CHAT_SERVICE_V1_NO_ENTITY_API_BASE_URL,
-  conductorOverride = CONDUCTOR_OVERRIDE
+  conductorOverride = CONDUCTOR_OVERRIDE,
+  images
 }) {
   const { completedMsg, widget, messageText } = await sendMessageToWix({
     siteAuthHeaders,
@@ -32613,7 +32696,8 @@ async function sendMessageToWixWithAutoConfirmation({
     message,
     wixelAssistantId,
     apiBaseURL,
-    conductorOverride
+    conductorOverride,
+    images
   });
   if (widget?.widget === "SINGLE_SELECT_WIDGET" && widget.data?.primaryButton?.respondText) {
     console.log("Auto-confirm SINGLE_SELECT_WIDGET", widget);
@@ -32694,6 +32778,12 @@ async function getAsset2({
   return asset;
 }
 
+// src/wixel/utils.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isValidUuid(value) {
+  return typeof value === "string" && UUID_REGEX.test(value);
+}
+
 // src/wixel/index.ts
 var SEND_MESSAGE_TO_WIXEL_TOOL_NAME = "SendMessageToWixel";
 var GET_WIXEL_JOB_STATUS_TOOL_NAME = "getWixelJobStatus";
@@ -32749,7 +32839,8 @@ function addSendMessageToWixelTool(server, authStrategy) {
   const toolMeta = {
     ...widgetMeta,
     "openai/toolInvocation/invoking": "Sending message to Wixel...",
-    "openai/toolInvocation/invoked": "Response from Wixel received"
+    "openai/toolInvocation/invoked": "Response from Wixel received",
+    "openai/fileParams": ["images"]
   };
   server.registerResource(
     `${WIDGET_NAME}_RESOURCE`,
@@ -32792,18 +32883,25 @@ You can also use this tool to:
         metaSiteId: external_exports.string().optional().describe("Wixel site ID (auto-creates if not provided)"),
         projectId: external_exports.string().optional().describe("Wixel project ID (auto-creates if not provided)"),
         conversationId: external_exports.string().optional().describe("Existing conversation ID (auto-creates if not provided)"),
-        message: external_exports.string().describe("The message to send to Wixel")
+        message: external_exports.string().describe("The message to send to Wixel"),
+        images: external_exports.array(
+          external_exports.object({
+            download_url: external_exports.string().url(),
+            file_id: external_exports.string()
+          })
+        ).optional().describe("Attached image files provided by the user")
       },
       annotations: { readOnlyHint: true },
       _meta: toolMeta
     },
     async (args) => {
       try {
+        console.log(`[Wixel] \u{1F680} Start Building Your asset`, { ...args });
         const accountAuthHeaders = await getAccountAuthHeaders();
         let metaSiteId;
         let projectId;
         let messageHint = "";
-        if (args.metaSiteId && args.projectId) {
+        if (isValidUuid(args.metaSiteId) && isValidUuid(args.projectId)) {
           metaSiteId = args.metaSiteId;
           projectId = args.projectId;
         } else {
@@ -32854,7 +32952,8 @@ You can also use this tool to:
           siteAuthHeaders,
           projectId,
           conversationId,
-          message: messageWithHint
+          message: messageWithHint,
+          images: args.images
         });
         let widget = parsedWidget;
         let textContent = messageText.replaceAll("**", "");