@wix/mcp 1.0.95 → 1.0.96

package/build/dts/site-widget-tools/search-site-templates-tool/index.js

@@ -8,6 +8,7 @@ import { RESOURCE_MIME_TYPE } from '@modelcontextprotocol/ext-apps/server';
 import { defaultToolDescriptions } from '../../config/default-config.js';
 import { EDITOR_NOT_REQUESTED_MESSAGE, NOT_REQUESTED_WIDGET_PAYLOAD, SEARCH_SITE_TEMPLATES_TOOL_NAME, CREATE_SITE_FROM_TEMPLATE_TOOL_NAME, SITE_WIDGET_MCP_CSP, OPEN_AI_SITE_WIDGET_CSP } from '../constants.js';
 import { withJsonContent } from '../../tool-utils.js';
+import { NO_PERSONAL_DATA, START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS } from '../../docs/start-deploy-website.js';
 // baseURL pins the host so the ambassador resolves to the public template-search
 // endpoint: https://www.wix.com/_api/template-cms-view-service/view/v2/templates/search
 const httpClient = createHttpClient({ baseURL: 'https://www.wix.com' });
@@ -73,7 +74,15 @@ export function addSearchSiteTemplatesTool(server, _authStrategy, options) {
             templatesExplicitlyRequested: z
                 .boolean()
                 .optional()
-                .describe("Did the user, in their own words or their answer to your question, ask for a template, Wix Studio, or the Classic Editor by name? Wanting Wix's editor, or to design the site themselves, is not that: ask them how to start first. Nor are a site's business, features or look.")
+                .describe("Did the user, in their own words or their answer to your question, ask for a template, Wix Studio, or the Classic Editor by name? Wanting Wix's editor, or to design the site themselves, is not that: ask them how to start first. Nor are a site's business, features or look."),
+            templateRequest: z
+                .string()
+                .optional()
+                .describe(`The user's own words that asked for a template, Wix Studio or the Classic Editor, quoted from their message or their answer to your question. Empty when they asked for none of them; then templatesExplicitlyRequested is false. Recorded, not checked. ${NO_PERSONAL_DATA}`),
+            agentIdentity: z
+                .string()
+                .optional()
+                .describe(START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.agentIdentity)
         },
         _meta: {
             ui: {

package/build/dts/site-widget-tools/site-builder-tool/index.js

@@ -5,6 +5,7 @@ import { RESOURCE_MIME_TYPE } from '@modelcontextprotocol/ext-apps/server';
 import { EDITOR_NOT_REQUESTED_MESSAGE, NOT_REQUESTED_WIDGET_PAYLOAD, SITE_BUILDER_TOOL_NAME, SITE_WIDGET_MCP_CSP, OPEN_AI_SITE_WIDGET_CSP, OPENAI_WIDGET_MIME_TYPE } from '../constants.js';
 import { defaultToolDescriptions } from '../../config/default-config.js';
 import { withJsonContent } from '../../tool-utils.js';
+import { NO_PERSONAL_DATA, START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS } from '../../docs/start-deploy-website.js';
 const httpClient = createHttpClient();
 const CREATE_SITE_WIDGET_URI = 'ui://widget/site-builder.html';
 export function addCreateSiteWidgetTool(server, authStrategy, options) {
@@ -71,7 +72,15 @@ export function addCreateSiteWidgetTool(server, authStrategy, options) {
             wixEditorExplicitlyRequested: z
                 .boolean()
                 .optional()
-                .describe("Did the user, in their own words or their answer to your question, ask for the Wix Harmony Editor, or for Wix to design the site? Wanting Wix's editor, or to design the site themselves, is not that: ask them how to start first. Nor are a site's business, features or look.")
+                .describe("Did the user, in their own words or their answer to your question, ask for the Wix Harmony Editor, or for Wix to design the site in Wix's editor? Asking for a site on Wix, or for Wix to build or make one, is not that. Wanting Wix's editor, or to design the site themselves, is not that either: ask them how to start first. Nor are a site's business, features or look."),
+            editorRequest: z
+                .string()
+                .optional()
+                .describe(`On a new build: the user's own words that asked for the Wix Harmony Editor or for Wix to design the site, quoted from their message or their answer to your question. Empty when they asked for neither; then wixEditorExplicitlyRequested is false. Recorded, not checked. ${NO_PERSONAL_DATA}`),
+            agentIdentity: z
+                .string()
+                .optional()
+                .describe(START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.agentIdentity)
         },
         _meta: toolDefinitionMeta,
         annotations: {
@@ -98,7 +107,10 @@ export function addCreateSiteWidgetTool(server, authStrategy, options) {
             });
         }
         console.log(`[${SITE_BUILDER_TOOL_NAME}] 🚀 tool invoked`, {
-            ...args,
+            jobId: args.jobId,
+            suggestedSiteName: args.suggestedSiteName,
+            wixEditorExplicitlyRequested: args.wixEditorExplicitlyRequested,
+            hasEditorRequest: !!args.editorRequest,
             isAnonymous
         });
         let jobId;

package/build/dts/site-widget-tools/suggested-domain-tool/index.js

@@ -38,6 +38,8 @@ export function addSuggestedDomainTool(server, authStrategy) {
         - wants to find a domain for their site, new or existing
         - wants alternatives or variations of a domain name, e.g. "something similar to mybakery.com"
 
+        Do not use this tool to check domain availability.
+
         Provide either a free-text \`query\` (e.g. "pancakes business", "modern yoga studio") OR a \`siteId\` to base the suggestions on that site's name. At least one of them is required.
 
         Present the returned domains to the user as a short list. This tool only suggests domains — it does not purchase or connect them.
@@ -66,7 +68,10 @@ export function addSuggestedDomainTool(server, authStrategy) {
             openWorldHint: false
         },
         _meta: {
-            securitySchemes: [{ type: 'oauth2', scopes: ['offline_access'] }],
+            securitySchemes: [
+                { type: 'noauth' },
+                { type: 'oauth2', scopes: ['offline_access'] }
+            ],
             // Model-visible so hosts (e.g. Microsoft 365 Copilot) can call it directly and show it
             // in their debug info; 'app' keeps it callable from the site-builder widget.
             ui: { visibility: ['app', 'model'] },
@@ -75,13 +80,6 @@ export function addSuggestedDomainTool(server, authStrategy) {
         }
     }, async (args, { panorama }) => {
         console.log('[getSuggestedDomains] Invoked with args:', args);
-        if (isAnonymous?.()) {
-            console.log('[getSuggestedDomains] Returning empty response for anonymous user');
-            return {
-                content: [{ type: 'text', text: '' }],
-                structuredContent: { domains: [], success: true }
-            };
-        }
         const { query, siteId, tlds, limit } = args;
         if (!query && !siteId) {
             return {
@@ -95,9 +93,22 @@ export function addSuggestedDomainTool(server, authStrategy) {
                 structuredContent: { domains: [] }
             };
         }
+        const anonymous = isAnonymous?.() ?? false;
+        if (anonymous && !query) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: "Without a connected Wix account the site's name can't be read: pass a query (the business or site name) instead of the siteId"
+                    }
+                ],
+                structuredContent: { domains: [] }
+            };
+        }
         try {
             let resolvedQuery = query;
-            if (siteId) {
+            if (siteId && !anonymous) {
                 try {
                     const siteHeaders = await getSiteAuthHeaders(siteId);
                     const siteName = await fetchSiteDisplayName(siteHeaders.Authorization, siteId);

package/build/dts/tool-utils.d.ts

@@ -1,13 +1,20 @@
 import type { HttpResponse } from '@wix/http-client';
+/**
+ * Whether an account-scoped call failed for want of a site: `certain` when the API says so,
+ * `likely` for the empty 403 site APIs answer without one, null otherwise.
+ */
+export declare function missingSiteContext(status: number | undefined, responseData: unknown): 'certain' | 'likely' | null;
 export declare const DEFAULT_OPENAI_SECURITY_SCHEMES: {
     type: "oauth2";
     scopes: string[];
 }[];
-export declare const buildErrorMessage: ({ status, statusText, requestId, responseData }: {
+export declare const buildErrorMessage: ({ status, statusText, requestId, responseData, retryHint }: {
     status?: number;
     statusText?: string;
     requestId: string | null;
     responseData?: any;
+    /** Replaces the hint picked from the error details. */
+    retryHint?: string;
 }) => string;
 export declare const handleWixAPIResponse: <T = any>(response: HttpResponse) => Promise<T>;
 export declare function withJsonContent(result: any): any;

package/build/dts/tool-utils.js

@@ -11,6 +11,30 @@ const getRetryHint = (errorDetails) => {
         ? SINGLE_OPERATOR_PER_FIELD_HINT
         : FIELD_CAPABILITIES_HINT;
 };
+// What site APIs answer when a call carries no site: an explicit "no site in the request" in
+// one of its many spellings, or a 403 with an empty body.
+const NO_SITE_IN_REQUEST = /META_SITE_NOT_FOUND|MetaSite(?:Id)? (?:context )?(?:is missing|was not found|not found)|NO_METASITE_IN_CALL_CONTEXT|MISSING_METASITE_ID|MISSING_REQUEST_SITE_CONTEXT|metasiteId from the request context/i;
+/**
+ * Whether an account-scoped call failed for want of a site: `certain` when the API says so,
+ * `likely` for the empty 403 site APIs answer without one, null otherwise.
+ */
+export function missingSiteContext(status, responseData) {
+    const details = typeof responseData === 'string'
+        ? responseData
+        : JSON.stringify(responseData ?? '');
+    if (NO_SITE_IN_REQUEST.test(details))
+        return 'certain';
+    const parsed = typeof responseData === 'string'
+        ? safeParseJSON(responseData)
+        : responseData;
+    if (status === 403 &&
+        parsed &&
+        typeof parsed === 'object' &&
+        !parsed.message) {
+        return 'likely';
+    }
+    return null;
+}
 export const DEFAULT_OPENAI_SECURITY_SCHEMES = [
     { type: 'oauth2', scopes: ['offline_access'] }
 ];
@@ -22,7 +46,7 @@ const safeParseJSON = (text) => {
         return text;
     }
 };
-export const buildErrorMessage = ({ status, statusText, requestId, responseData }) => {
+export const buildErrorMessage = ({ status, statusText, requestId, responseData, retryHint }) => {
     const responseDataObject = typeof responseData === 'string'
         ? safeParseJSON(responseData)
         : responseData;
@@ -39,7 +63,7 @@ export const buildErrorMessage = ({ status, statusText, requestId, responseData
     ]
         .filter((str) => !!str)
         .join('\n');
-    return `${baseMessage}\n\n${getRetryHint(String(errorDetails))}`;
+    return `${baseMessage}\n\n${retryHint ?? getRetryHint(String(errorDetails))}`;
 };
 export const handleWixAPIResponse = async (response) => {
     const requestId = response.headers?.['x-wix-request-id'];

package/build/dts/toolkit.js

@@ -238,7 +238,13 @@ export function createWixToolkit(options) {
             addUploadHeadlessWebsiteFilesTool(server, {
                 authStrategy,
                 toolDescriptions: effectiveToolDescriptions,
-                clientName
+                clientName,
+                // The headless guide the drop reply carries is read the way the docs tools read it.
+                guide: {
+                    skillsPortalUrl: docs?.skillsPortalUrl,
+                    repo: docs?.repo ?? docs?.skillsRepo,
+                    commitHash: docs?.commitHash ?? docs?.skillsPr
+                }
             });
         }
         // GraphQL tools register only the ones requested (each is opt-in by name).