@wix/mcp 1.0.20 → 1.0.22

package/build/bin-standalone.js

@@ -51,8 +51,8 @@ var require_v2 = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.wixDocsHoverOnContentTerms = exports.docsAiAssistantCostSrc112Evid1436 = exports.docsAiAssistantOpenCloseSrc112Evid1435 = exports.apiExampleGenerationCompletedByAiTool = exports.wixDocsClickOnLinks = exports.relativeLinksFailure = exports.wixDocsMenuEditorReviewSaveModalClicks = exports.wixDocsMenuEditorInstructionsClicks = exports.wixDocsMenuEditorContentFilterChange = exports.wixDocsMenuEditorVersionsSideBarClicks = exports.wixDocsMenuEditorVersionsSideBarLoaded = exports.wixDocsMenuEditorSideBarActionMoveToReview = exports.wixDocsMenuEditorEditModeStatusChange = exports.wixDocsModalClick = exports.wixDocsModalWasClose = exports.wixDocsModalWasOpen = exports.wixDocsMainPageScroll = exports.wixDocsMainPageClick = exports.wixDocsDocsWasPublished = exports.wixDocsMenuEditorSideBarPositionChanged = exports.wixDocsMenuEditorSideBarActionFinished = exports.wixDocsMenuEditorSideBarActionClick = exports.wixDocsClickInPage = exports.wixDocsSubmitFeedback = exports.wixDocsClickOnGiveFeedback = exports.wixDocsClickedOnNavbar = exports.wixDocsNavbarLoaded = exports.wixDocsClickOnSidebarItem = exports.wixDocsSidebarState = exports.wixDocsCloseSearchDialog = exports.wixDocsChooseASearchResult = exports.wixDocsHoverOverASearchResultItem = exports.wixDocsScrollingInSearchResultView = exports.wixDocsTypeASearchTerm = exports.wixDocsSearchOpened = exports.wixDocsFinishLoadingPage = exports.wixDocsStartLoadingPage = exports.docsSsrRequestSrc112Evid140 = exports.docsAiAssistantAnswerSrc112Evid14 = exports.wixDocsChangelogItemSeen = exports.wixDocsClickOnItem = exports.wixDocsChangelogFilterUsage = exports.wixDocsViewLiveSiteClick = exports.docsAiAssistantClickSrc112Evid13 = exports.testTokenTokenGeneratedServerless = exports.wixDocsPlaygroundLinksDropdownClick = exports.wixDocsFeedbackSubmittedServer = exports.wixDocsSendRequestServer = exports.wixDocsSendRequestClient = exports.wixDocs404PageLoaded = void 0;
-    exports.triggerValueWasSelected = exports.apiKeysClickOnOauthPageLink = exports.apiKeysClickOnSendCodeAgain = exports.apiKeysClickOnSendCode = exports.apiKeysFinishDeleteKey = exports.apiKeysStartDeleteKey = exports.apiKeysFinishRotateKey = exports.apiKeysStartRotateKey = exports.apiKeysFinishDuplicateKey = exports.apiKeysStartDuplicateKey = exports.apiKeysFinishEditKey = exports.apiKeysStartEditKey = exports.apiKeysClickOnCopyAccountId = exports.apiKeysClickOnViewApiReferences = exports.apiKeysClickOnGenerateKeyEmptyState = exports.apiKeysClickOnGenerateKeyTopButton = exports.apiKeysClickOnActionFromThe3Dots = exports.apiKeysFinishGenerateKey = exports.apiKeysStartGenerateKey = exports.oauthAppOauthAppActionWasMadeServer = exports.oauthAppClickAtTheGenerateClientSecretDialog = exports.oauthAppOauthAppActionWasMade = exports.oauthAppClickAtTheDeleteOauthAppDialog = exports.oauthAppClickOnSaveFromCreateEditOauthAppPage = exports.oauthAppClickOnCloseFromCreateEditOauthAppPage = exports.oauthAppClickAtTheCreateEditOauthAppPage = exports.oauthAppClickNextCloseAtTheCreateOauthAppDialog = exports.oauthAppClickAtTheOauthAppMainPage = exports.oauthAppClickOnOauthAppAction = exports.headlessPlaygroundModalFinishedLoading = exports.headlessQuickStartModalShown = exports.publicSdkCall = exports.wixDocsShareableLinkClick = exports.wixDocsTryItOutClick = exports.wixDocsCopyCode = exports.wixDocsContactOwnerLinkClicked = exports.wixDocsNavigationClick = exports.wixDocsSearchResults = exports.gitToResourceUpdateSrc112Evid30 = exports.wixDocsGiveFeedbackClick = exports.wixDocsToggleClick = exports.wixDocsSiteVisit = exports.wixDocsObjectShowMembersClick = exports.wixDocsViewSourceClick = exports.wixDocsRelatedSiteClick = exports.wixDocsRedirectByExternalIdSrc112Evid1601 = exports.docsRedirectFailure = exports.wixDocsOpenCloseExamples = exports.wixDocsVisitLocalViewer = exports.wixDocsHover = void 0;
-    exports.spiExternalInvocationSrc96Evid199 = exports.devCenterWebhookSentTriggered = exports.webhooksInDcMainPageClicks = exports.webhooksInDcCreateEventPageClicks = exports.webhooksInDcCodeExampleWindowScroll = exports.webhooksInDcTriggeredTestModalClicks = exports.webhooksInDcCodeExampleWindowClicks = exports.wixMcpRequestSrc39Evid1607 = exports.testSrc184Evid9999 = exports.copyOfHeadlessResumeSetUpDialogClick = exports.headlessResumeSetUpDialogIsShown = exports.headlessDeployThisTemplatePageClick = exports.headlessDeployThisTemplatePageIsShown = exports.headlessAddWixToYourProjectDialogClick = exports.headlessOAuthInstalled = exports.headlessAddWixToYourProjectDialogIsShown = exports.apiBlockGaRule = exports.settingsAccess = exports.appsSettingsDeletionCandidate = exports.autoVeloSiteCallForAMethod = exports.graphqlCall = exports.webhooksDispatcherResponseChannelTopicSrc155Evid3 = exports.headlessMigrationTourModalShown = exports.zapierCustomZapCreatedOrDeleted = exports.zapierTestDataClick = void 0;
+    exports.apiKeysClickOnOauthPageLink = exports.apiKeysClickOnSendCodeAgain = exports.apiKeysClickOnSendCode = exports.apiKeysFinishDeleteKey = exports.apiKeysStartDeleteKey = exports.apiKeysFinishRotateKey = exports.apiKeysStartRotateKey = exports.apiKeysFinishDuplicateKey = exports.apiKeysStartDuplicateKey = exports.apiKeysFinishEditKey = exports.apiKeysStartEditKey = exports.apiKeysClickOnCopyAccountId = exports.apiKeysClickOnViewApiReferences = exports.apiKeysClickOnGenerateKeyEmptyState = exports.apiKeysClickOnGenerateKeyTopButton = exports.apiKeysClickOnActionFromThe3Dots = exports.apiKeysFinishGenerateKey = exports.apiKeysStartGenerateKey = exports.oauthAppOauthAppActionWasMadeServer = exports.oauthAppClickAtTheGenerateClientSecretDialog = exports.oauthAppOauthAppActionWasMade = exports.oauthAppClickAtTheDeleteOauthAppDialog = exports.oauthAppClickOnSaveFromCreateEditOauthAppPage = exports.oauthAppClickOnCloseFromCreateEditOauthAppPage = exports.oauthAppClickAtTheCreateEditOauthAppPage = exports.oauthAppClickNextCloseAtTheCreateOauthAppDialog = exports.oauthAppClickAtTheOauthAppMainPage = exports.oauthAppClickOnOauthAppAction = exports.headlessPlaygroundModalFinishedLoading = exports.headlessQuickStartModalShown = exports.astraCmdEnteredSrc11Evid4001 = exports.publicSdkCall = exports.wixDocsShareableLinkClick = exports.wixDocsTryItOutClick = exports.wixDocsCopyCode = exports.wixDocsContactOwnerLinkClicked = exports.wixDocsNavigationClick = exports.wixDocsSearchResults = exports.gitToResourceUpdateSrc112Evid30 = exports.wixDocsGiveFeedbackClick = exports.wixDocsToggleClick = exports.wixDocsSiteVisit = exports.wixDocsObjectShowMembersClick = exports.wixDocsViewSourceClick = exports.wixDocsRelatedSiteClick = exports.wixDocsRedirectByExternalIdSrc112Evid1601 = exports.docsRedirectFailure = exports.wixDocsOpenCloseExamples = exports.wixDocsVisitLocalViewer = exports.wixDocsHover = void 0;
+    exports.spiExternalInvocationSrc96Evid199 = exports.devCenterWebhookSentTriggered = exports.webhooksInDcMainPageClicks = exports.webhooksInDcCreateEventPageClicks = exports.webhooksInDcCodeExampleWindowScroll = exports.webhooksInDcTriggeredTestModalClicks = exports.webhooksInDcCodeExampleWindowClicks = exports.wixMcpRequestSrc39Evid1607 = exports.testSrc184Evid9999 = exports.copyOfHeadlessResumeSetUpDialogClick = exports.headlessResumeSetUpDialogIsShown = exports.headlessDeployThisTemplatePageClick = exports.headlessDeployThisTemplatePageIsShown = exports.headlessAddWixToYourProjectDialogClick = exports.headlessOAuthInstalled = exports.headlessAddWixToYourProjectDialogIsShown = exports.apiBlockGaRule = exports.settingsAccess = exports.appsSettingsDeletionCandidate = exports.autoVeloSiteCallForAMethod = exports.graphqlCall = exports.webhooksDispatcherResponseChannelTopicSrc155Evid3 = exports.headlessMigrationTourModalShown = exports.zapierCustomZapCreatedOrDeleted = exports.zapierTestDataClick = exports.triggerValueWasSelected = void 0;
     function wixDocs404PageLoaded(params) {
       return { evid: 10, src: 112, endpoint: "", params };
     }
@@ -329,6 +329,10 @@ var require_v2 = __commonJS({
       return { evid: 1606, src: 11, endpoint: "", params };
     }
     exports.publicSdkCall = publicSdkCall;
+    function astraCmdEnteredSrc11Evid4001(params) {
+      return { evid: 4001, src: 11, endpoint: "", params };
+    }
+    exports.astraCmdEnteredSrc11Evid4001 = astraCmdEnteredSrc11Evid4001;
     function headlessQuickStartModalShown(params) {
       return { evid: 11, src: 151, endpoint: "", params };
     }
@@ -1865,7 +1869,7 @@ var require_cjs2 = __commonJS({
   "../../node_modules/@wix/panorama-client-node/dist/cjs/index.js"(exports) {
     "use strict";
     exports.__esModule = true;
-    exports.panoramaClientFactory = exports.createGlobalConfig = exports.PanoramaPlatform = exports.PanoramaExceptionType = exports.PanoramaErrorSeverity = void 0;
+    exports.panoramaClientFactory = exports.nodeReporter = exports.createGlobalConfig = exports.PanoramaPlatform = exports.PanoramaExceptionType = exports.PanoramaErrorSeverity = void 0;
     var _panoramaClientNode = require_panorama_client_node();
     exports.panoramaClientFactory = _panoramaClientNode.panoramaClientFactory;
     var _panoramaClient = require_cjs();
@@ -1873,6 +1877,8 @@ var require_cjs2 = __commonJS({
     exports.PanoramaExceptionType = _panoramaClient.ExceptionType;
     exports.PanoramaErrorSeverity = _panoramaClient.ErrorSeverity;
     exports.PanoramaPlatform = _panoramaClient.Platform;
+    var _reporter = require_reporter();
+    exports.nodeReporter = _reporter.nodeReporter;
   }
 });
 
@@ -11089,6 +11095,87 @@ ${description}`
   });
 }
 
+// src/docs/create-site-guide.ts
+var CREATE_SITE_DOCS = [
+  {
+    url: "https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_create_a_new_site_from_template",
+    title: "How to Create a New Wix Site",
+    nextSteps: "\n\n**Next Steps:** Use the ManageWixSite tool to make the API call for creating the Wix site."
+  },
+  {
+    url: "https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_wix.devcenter.apps.installer.v1.AppsInstallerService.InstallApp",
+    title: "How to Install App on a Wix Site",
+    nextSteps: "\n\n**Next Steps:** Use the CallWixSiteAPI tool to make the API call for installing apps on the Wix site."
+  }
+];
+var CREATE_SITE_DESCRIPTION = `
+Provides comprehensive documentation for creating a new Wix Business (i.e site, app, etc.)
+
+## When to Use This Tool
+
+Use this tool when the user requests to create a new Wix site.
+
+## What This Tool Contains
+
+This tool provides complete documentation including:
+- Template selection (empty sites or designed templates)
+- Wix Editor vs Wix Studio options
+- Regular vs Headless site creation
+- API endpoint details and parameters
+- Post-creation steps (OAuth for headless, publishing for regular sites)
+- App installation instructions
+
+## Important Notes
+
+**Do NOT use WixREADME or SearchWixRESTDocumentation before this tool.** If the user wants to create a Wix site, call this tool directly. It contains ALL necessary documentation.
+
+**After reading this documentation:**
+1. Use ManageWixSite to create the site
+2. Use CallWixSiteAPI to install apps (if needed)
+
+If the user wants to create a Wix site, call this tool directly. It contains ALL necessary documentation. You don't need to search for additional documentation, read more articles, use the WixREADME tool etc unless the user asks you to do so explicitly or you encounter an error.`;
+async function addCreateWixBusinessGuideTools(server2) {
+  server2.tool(
+    "CreateWixBusinessGuide",
+    CREATE_SITE_DESCRIPTION,
+    {},
+    async (_args, { httpClient }) => {
+      try {
+        const contents = await Promise.all(
+          CREATE_SITE_DOCS.map(async ({ url, title, nextSteps }) => {
+            const articleContent = await fetchArticleContent(
+              httpClient,
+              url,
+              "article",
+              true
+            );
+            const fullContent = `# ${title}
+
+${articleContent}${nextSteps}`;
+            return {
+              type: "text",
+              text: fullContent
+            };
+          })
+        );
+        return {
+          content: contents
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Error fetching create site documentation: ${error.message}`
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
 // src/docs/docs.ts
 var VALID_DOCS_TOOLS = [
   "WDS",
@@ -11106,10 +11193,14 @@ var addDocsTools = (server2, allowedTools = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "BUSINESS_SOLUTIONS"
-], getToKnowWixEnabled = false) => {
+], options = {}) => {
+  const { getToKnowWixEnabled = false, createWixBusinessGuideEnabled = true } = options;
   if (getToKnowWixEnabled) {
     addGetToKnowTools(server2);
   }
+  if (createWixBusinessGuideEnabled) {
+    addCreateWixBusinessGuideTools(server2);
+  }
   if (allowedTools.includes("WDS")) {
     server2.tool(
       "SearchWixWDSDocumentation",
@@ -12352,6 +12443,7 @@ var EXPERIMENTAL_TOOLS = [
   "WIX_API",
   "CLI_COMMAND",
   "GET_TO_KNOW_WIX",
+  "CREATE_WIX_BUSINESS_GUIDE",
   "VELO_README",
   "WIX_API_THROUGH_FS"
 ];
@@ -12419,9 +12511,16 @@ logger.log("Active tools:", activeTools);
 var docsTools = activeTools.filter(
   (tool) => VALID_DOCS_TOOLS.includes(tool)
 );
-if (docsTools.length > 0) {
+var hasGetToKnowWix = activeTools.includes("GET_TO_KNOW_WIX");
+var hasCreateWixBusinessGuide = activeTools.includes(
+  "CREATE_WIX_BUSINESS_GUIDE"
+);
+if (docsTools.length > 0 || hasGetToKnowWix || hasCreateWixBusinessGuide) {
   logger.log("Adding docs tools:", docsTools);
-  addDocsTools(server, docsTools, activeTools.includes("GET_TO_KNOW_WIX"));
+  addDocsTools(server, docsTools, {
+    getToKnowWixEnabled: hasGetToKnowWix,
+    createWixBusinessGuideEnabled: hasCreateWixBusinessGuide
+  });
 }
 if (activeTools.includes("VELO_README")) {
   addVeloReadmeTools(server);
@@ -12430,7 +12529,9 @@ if (activeTools.includes("WIX_API_THROUGH_FS")) {
   logger.log("Using file system auth strategy for WIX_API_THROUGH_FS");
   const fileSystemAuthStrategy = {
     getSiteAuthHeaders: (siteId) => ({
-      Authorization: getCliAuthToken(siteId)
+      Authorization: `Bearer ${getCliAuthToken(siteId)}`,
+      "wix-site-id": siteId
+      // When using an API key for authentication, include a wix-site-id header with the ID, https://dev.wix.com/docs/api-reference/articles/get-started/api-keys#account-level-and-site-level-api-requests
     }),
     getAccountAuthHeaders: () => ({
       Authorization: getCliAuthToken("api-key")