@wix/mcp 1.0.92 → 1.0.94

package/build/dts/docs/start-headless-build.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { defaultToolDescriptions } from '../config/default-config.js';
+import { fetchArticleContent } from './fetch-article.js';
+import { START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS } from './start-deploy-website.js';
+export const START_HEADLESS_BUILD_TOOL_NAME = 'StartHeadlessBuild';
+/** Wix's headless guide; identical to https://www.wix.com/headless/skill.md. */
+export const HEADLESS_GUIDE_URL = 'https://www.wix.com/skills/headless-cold-start/headless-kit.md';
+export const START_HEADLESS_BUILD_STARTING_POINTS = [
+    'nothing yet',
+    'a design worked out in this conversation',
+    'an existing Wix Headless site',
+    'a project download link',
+    'a Wix site to move to code'
+];
+// Like StartDeployWebsite's, these arguments are read by people via BI; only
+// `startingPoint` changes the response.
+export const START_HEADLESS_BUILD_PARAM_DESCRIPTIONS = {
+    userRequest: START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.userRequest,
+    siteDescription: START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.siteDescription,
+    startingPoint: 'What the build starts from: nothing yet; a design worked out in this conversation; an existing Wix Headless site; a project download link (a download.zip from Wix); or a Wix site to move to code.',
+    siteFunctionality: START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.siteFunctionality,
+    agentIdentity: START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.agentIdentity,
+    wixAccess: START_DEPLOY_WEBSITE_PARAM_DESCRIPTIONS.wixAccess
+};
+const PREFIX = "The following is Wix's headless guide. Follow it end to end and do the work yourself. If you find the user already has the site's code, call StartDeployWebsite instead.";
+const MOVE_TO_CODE_LINE = 'Moving a Wix site to code starts from the site\'s dashboard (Headless settings, "Go Headless"), which hands the owner a prompt with the project\'s download link. Ask the user for that prompt, then follow the guide with it.';
+export function startHeadlessBuildResponse(guide, startingPoint) {
+    const lines = [];
+    if (startingPoint === 'a Wix site to move to code') {
+        lines.push(MOVE_TO_CODE_LINE);
+    }
+    if (guide && guide.trim()) {
+        lines.push(PREFIX, '---', guide.trim());
+    }
+    else {
+        lines.push(`Wix's headless guide could not be loaded here. It is at ${HEADLESS_GUIDE_URL}: read it whole with ReadFullDocsArticle if you have that tool, otherwise fetch it with curl or your web tool, then follow it end to end and do the work yourself. If you find the user already has the site's code, call StartDeployWebsite instead.`);
+    }
+    return lines.join('\n\n');
+}
+export function addStartHeadlessBuildTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+    if (disableTools.includes(START_HEADLESS_BUILD_TOOL_NAME)) {
+        return;
+    }
+    const d = START_HEADLESS_BUILD_PARAM_DESCRIPTIONS;
+    server.tool(START_HEADLESS_BUILD_TOOL_NAME, toolDescriptions?.[START_HEADLESS_BUILD_TOOL_NAME] ??
+        defaultToolDescriptions[START_HEADLESS_BUILD_TOOL_NAME], {
+        userRequest: z.string().min(1).describe(d.userRequest),
+        siteDescription: z.string().min(1).describe(d.siteDescription),
+        startingPoint: z
+            .enum(START_HEADLESS_BUILD_STARTING_POINTS)
+            .describe(d.startingPoint),
+        siteFunctionality: z.string().min(1).describe(d.siteFunctionality),
+        agentIdentity: z.string().min(1).describe(d.agentIdentity),
+        wixAccess: z.string().min(1).describe(d.wixAccess)
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (args, { httpClient }) => {
+        // Inline, not a link: chat agents cannot fetch www.wix.com themselves.
+        let guide;
+        try {
+            guide = await fetchArticleContent(httpClient, HEADLESS_GUIDE_URL, 'article', true, fetchOptions.skillsPortalUrl, fetchOptions.repo, fetchOptions.commitHash);
+        }
+        catch (error) {
+            console.warn('[StartHeadlessBuild] guide fetch failed, returning the pointer:', error instanceof Error ? error.message : error);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: startHeadlessBuildResponse(guide, args.startingPoint)
+                }
+            ]
+        };
+    });
+}
+//# sourceMappingURL=start-headless-build.js.map

package/build/dts/graphql/index.js

@@ -163,7 +163,9 @@ function addExecuteGraphqlTool(server, description, authStrategy, options) {
         scope: z.enum(['site', 'account']).optional().describe(d.scope),
         hasMutations: z.boolean().describe(d.hasMutations),
         reason: z.string().describe(d.reason)
-    }, { readOnlyHint: false, destructiveHint: true, openWorldHint: false }, async ({ query, variables, operationName, siteId, scope, hasMutations, reason }, extra) => {
+    }, 
+    // openWorldHint true: any operation in the Wix GraphQL schema, chosen at call time.
+    { readOnlyHint: false, destructiveHint: true, openWorldHint: true }, async ({ query, variables, operationName, siteId, scope, hasMutations, reason }, extra) => {
         const effectiveScope = scope ?? (siteId ? 'site' : 'account');
         logger.log(`[${EXECUTE_GRAPHQL_TOOL_NAME}] scope=${effectiveScope} siteId=${siteId ?? 'none'} hasMutations=${hasMutations} operationName=${operationName ?? '-'} reason="${reason}"`);
         if (effectiveScope === 'site' && !siteId) {

package/build/dts/import-claude-design-tool/index.js

@@ -125,11 +125,11 @@ export function addImportClaudeDesignTool(server, authStrategy, options) {
         }
         const contentLength = Number(response.headers.get('content-length'));
         if (contentLength > maxBundleBytes) {
-            return errorResult('The design is too large to import.');
+            return errorResult("The design is too large to import. This tool only takes Claude Design's bundle URL. To put this site live, call StartDeployWebsite with the site's files.");
         }
         const html = await readBodyWithLimit(response, maxBundleBytes);
         if (html === null) {
-            return errorResult('The design is too large to import.');
+            return errorResult("The design is too large to import. This tool only takes Claude Design's bundle URL. To put this site live, call StartDeployWebsite with the site's files.");
         }
         try {
             const { id, outcome } = await initInstantSite(wixstroOptions, args.title, args.claude_design_project_id, INSTANT_SITE_ORIGIN);

package/build/dts/index.d.ts

@@ -22,6 +22,7 @@ export { createWixToolkit, extractText, type WixTool, type WixToolkit, type WixT
 export { fetchRecipesIndex, fetchArticle, RECIPES_INDEX_URL } from './docs/fetch-article.js';
 export { generateDocsNavigationTree, fetchMenuContent, MENU_CONTENT_THRESHOLD, normalizeMenuContent, summarizeLargeMenu, parseDirectChildren } from './docs/normalize-menu-content.js';
 export { addCodeModeTools, addExecuteCodeModeTool, addSearchCodeModeTool, type CodeModeFetch, type CodeModeOptions } from './code-mode/index.js';
+export { addUploadHeadlessWebsiteFilesTool, UPLOAD_HEADLESS_WEBSITE_FILES_TOOL_NAME } from './api-call/upload-headless-website-files.js';
 export { validateExecuteCode, EXECUTE_FUNCTION_EXPRESSION_HINT, type CodeValidationResult } from './code-mode/validation.js';
 export { addGraphqlTools, resetGraphqlSchemaCache, GRAPHQL_TOOL_NAMES, SEARCH_GRAPHQL_TOOL_NAME, INSPECT_GRAPHQL_TOOL_NAME, EXECUTE_GRAPHQL_TOOL_NAME, WIX_GRAPHQL_ENDPOINT, type GraphqlToolsOptions, type GraphqlToolName } from './graphql/index.js';
 export { defaultConfig, defaultToolDescriptions, defaultReadmeDocs, widgetSiteCreationConfig, SITE_CREATION_COPY, toWidget, executeCodeModeToolDescriptions, SYSTEM_REMINDER_GUIDELINES, SYSTEM_REMINDER, mergeConfig, type ModeDefaultConfig } from './config/default-config.js';

package/build/dts/index.js

@@ -26,6 +26,7 @@ export { fetchRecipesIndex, fetchArticle, RECIPES_INDEX_URL } from './docs/fetch
 export { generateDocsNavigationTree, fetchMenuContent, MENU_CONTENT_THRESHOLD, normalizeMenuContent, summarizeLargeMenu, parseDirectChildren } from './docs/normalize-menu-content.js';
 // Code mode (search + execute via sandboxed JS)
 export { addCodeModeTools, addExecuteCodeModeTool, addSearchCodeModeTool } from './code-mode/index.js';
+export { addUploadHeadlessWebsiteFilesTool, UPLOAD_HEADLESS_WEBSITE_FILES_TOOL_NAME } from './api-call/upload-headless-website-files.js';
 export { validateExecuteCode, EXECUTE_FUNCTION_EXPRESSION_HINT } from './code-mode/validation.js';
 // GraphQL tools (search operations + inspect schema + execute)
 export { addGraphqlTools, resetGraphqlSchemaCache, GRAPHQL_TOOL_NAMES, SEARCH_GRAPHQL_TOOL_NAME, INSPECT_GRAPHQL_TOOL_NAME, EXECUTE_GRAPHQL_TOOL_NAME, WIX_GRAPHQL_ENDPOINT } from './graphql/index.js';

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

@@ -21,7 +21,8 @@ const BLANK_CANVAS_IMAGE_URL = 'https://images-wixmp-530a50041672c69d335ba4cf.wi
 const BLANK_CANVAS_DESCRIPTION = 'This Blank Canvas Responsive Template is ready to be customized to your exact needs.';
 const BLANK_CANVAS_META_SITE_ID = {
     studio: 'fe86a14e-ef67-49b4-a409-d086f3abaa1a',
-    harmony: '91532250-8835-46ac-9666-e4db8770b275'
+    harmony: '91532250-8835-46ac-9666-e4db8770b275',
+    classic: 'b55bdf43-95e0-4cef-b9bb-92dcc7af2742'
 };
 /**
  * Searches Wix templates server-side. Widget clients render a gallery to pick from
@@ -55,9 +56,9 @@ export function addSearchSiteTemplatesTool(server, _authStrategy, options) {
             defaultToolDescriptions[SEARCH_SITE_TEMPLATES_TOOL_NAME],
         inputSchema: {
             builder: z
-                .enum(['harmony', 'studio'])
+                .enum(['harmony', 'studio', 'classic'])
                 .default('harmony')
-                .describe('Which builder\'s templates to return: "studio" if the user asked for Wix Studio in this site creation flow, otherwise "harmony" (the default). You choose this from the request — don\'t ask the user which builder.'),
+                .describe('Which builder\'s templates to return: "studio" if the user asked for Wix Studio in this site creation flow, "classic" if they asked for the Classic Editor (the Wix Editor), otherwise "harmony" (the default). You choose this from the request — don\'t ask the user which builder.'),
             query: z
                 .string()
                 .min(1)
@@ -185,10 +186,19 @@ function blankCanvasCard(builder) {
     };
 }
 async function searchSiteTemplates(builder, query, limit) {
-    // Studio is selected via bookType; Harmony via the templateBuilders filter.
-    const builderParams = builder === 'harmony'
-        ? { filter: { templateBuilders: [TemplateBuilder.Harmony] } }
-        : { bookType: 'studio' };
+    // Studio is selected via bookType; Harmony and the Classic Editor via the
+    // templateBuilders filter (bookType "main-v2" now returns Harmony templates).
+    const builderParams = builder === 'studio'
+        ? { bookType: 'studio' }
+        : {
+            filter: {
+                templateBuilders: [
+                    builder === 'classic'
+                        ? TemplateBuilder.Editor
+                        : TemplateBuilder.Harmony
+                ]
+            }
+        };
     const response = await httpClient.request(searchTemplates({
         language: 'en',
         query: query.trim(),

package/build/dts/toolkit-entry.d.cts

@@ -126,9 +126,12 @@ export interface ReadmeDocConfig {
 }
 export interface DocsToolsOptions {
 	getToKnowWixEnabled?: boolean;
+	/** @deprecated CreateWixBusinessGuide was removed (StartHeadlessBuild replaces its headless route); ignored. */
 	createWixBusinessGuideEnabled?: boolean;
 	/** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
 	startDeployWebsiteEnabled?: boolean;
+	/** StartHeadlessBuild (build a new site in code) — an account-owner flow; off for visitor servers. */
+	startHeadlessBuildEnabled?: boolean;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;
@@ -152,8 +155,7 @@ export interface DocsToolsOptions {
 	dynamicContextEnabled?: boolean;
 	/** Enable partner context section in dynamic context output */
 	partnerContextEnabled?: boolean;
-	/** Whether the client is a CLI environment (e.g. Claude Code) where users can run terminal commands.
-	 *  Accepts a boolean or a function for lazy evaluation (useful when client name is only known after MCP init). */
+	/** @deprecated Only CreateWixBusinessGuide read it, and that tool was removed; ignored. */
 	cliEnabled?: boolean | (() => boolean);
 	/** Use the new platformized semantic search API (POST /v1/docs/search) instead of the legacy GET endpoint */
 	usePlatformizedSearch?: boolean;

package/build/dts/toolkit-entry.d.ts

@@ -126,9 +126,12 @@ export interface ReadmeDocConfig {
 }
 export interface DocsToolsOptions {
 	getToKnowWixEnabled?: boolean;
+	/** @deprecated CreateWixBusinessGuide was removed (StartHeadlessBuild replaces its headless route); ignored. */
 	createWixBusinessGuideEnabled?: boolean;
 	/** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
 	startDeployWebsiteEnabled?: boolean;
+	/** StartHeadlessBuild (build a new site in code) — an account-owner flow; off for visitor servers. */
+	startHeadlessBuildEnabled?: boolean;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;
@@ -152,8 +155,7 @@ export interface DocsToolsOptions {
 	dynamicContextEnabled?: boolean;
 	/** Enable partner context section in dynamic context output */
 	partnerContextEnabled?: boolean;
-	/** Whether the client is a CLI environment (e.g. Claude Code) where users can run terminal commands.
-	 *  Accepts a boolean or a function for lazy evaluation (useful when client name is only known after MCP init). */
+	/** @deprecated Only CreateWixBusinessGuide read it, and that tool was removed; ignored. */
 	cliEnabled?: boolean | (() => boolean);
 	/** Use the new platformized semantic search API (POST /v1/docs/search) instead of the legacy GET endpoint */
 	usePlatformizedSearch?: boolean;

package/build/dts/toolkit.js

@@ -34,6 +34,7 @@ import { addDocsTools } from './docs/docs.js';
 import { addApiCallTool } from './api-call/index.js';
 import { addGraphqlTools, GRAPHQL_TOOL_NAMES } from './graphql/index.js';
 import { addExecuteCodeModeTool, addSearchCodeModeTool } from './code-mode/index.js';
+import { addUploadHeadlessWebsiteFilesTool } from './api-call/upload-headless-website-files.js';
 import { defaultReadmeDocs, executeCodeModeToolDescriptions, buildToolDescriptions } from './config/default-config.js';
 import { getDynamicContext } from './docs/get-to-know.js';
 import { createPanoramaClient } from './infra/panorama.js';
@@ -227,6 +228,14 @@ export function createWixToolkit(options) {
                 maxResponseSize
             });
         }
+        if (requestedTools.has('UploadHeadlessWebsiteFiles') &&
+            !disableTools?.includes('UploadHeadlessWebsiteFiles')) {
+            addUploadHeadlessWebsiteFilesTool(server, {
+                authStrategy,
+                toolDescriptions: effectiveToolDescriptions,
+                clientName
+            });
+        }
         // GraphQL tools register only the ones requested (each is opt-in by name).
         const requestedGraphqlTools = GRAPHQL_TOOL_NAMES.filter((name) => requestedTools.has(name));
         if (requestedGraphqlTools.length > 0) {

package/build/dts/wix-mcp-server.d.ts

@@ -51,6 +51,8 @@ export declare class WixMcpServer extends McpServer {
     constructor(serverInfo: Implementation, options?: ServerOptions, context?: WixMcpServerContext | undefined);
     setUserIdGetter(getUserId: () => string | undefined): void;
     getSessionId(): string;
+    /** The connected client's name: the host's getter (User-Agent fallback) first, then clientInfo. */
+    clientName(): string | undefined;
     setClientNameGetter(getClientName: () => string | undefined): void;
     setUserAgentGetter(getUserAgent: () => string | undefined): void;
     setGptAppSchemesEnabled(enabled: boolean): void;

package/build/dts/wix-mcp-server.js

@@ -39,6 +39,10 @@ export class WixMcpServer extends McpServer {
     getSessionId() {
         return this.sessionId;
     }
+    /** The connected client's name: the host's getter (User-Agent fallback) first, then clientInfo. */
+    clientName() {
+        return this.getClientName?.() ?? this.server.getClientVersion()?.name;
+    }
     setClientNameGetter(getClientName) {
         this.getClientName = getClientName;
     }