@wix/mcp 1.0.82 → 1.0.84

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

@@ -6,9 +6,13 @@ const WIX_APIS_BASE_URL = 'https://www.wixapis.com';
 // Sites keep this placeholder until the owner renames them, and domain search
 // rejects it as a blacklisted term.
 const DEFAULT_SITE_NAME = /^my site(\s+\d+)?$/i;
-function isDefaultSiteName(siteName) {
-    return DEFAULT_SITE_NAME.test(siteName.trim());
+// Domains are Latin, so the caller's query beats a site name in another script.
+const NON_LATIN_LETTER = /(?![\p{Script=Latin}])\p{L}/u;
+function isSearchableSiteName(siteName) {
+    return (!DEFAULT_SITE_NAME.test(siteName.trim()) && !NON_LATIN_LETTER.test(siteName));
 }
+// Domain search rejects longer queries.
+const MAX_QUERY_LENGTH = 100;
 async function fetchSiteDisplayName(siteAuthorization, siteId) {
     const response = await fetch(`${WIX_APIS_BASE_URL}/site-properties/v4/properties`, {
         headers: {
@@ -39,7 +43,7 @@ export function addSuggestedDomainTool(server, authStrategy) {
             query: z
                 .string()
                 .optional()
-                .describe("Free-text keywords, business idea, or brand concept to base suggestions on. Use the user's own words."),
+                .describe("A few keywords, a business idea, or a brand name to base suggestions on, up to 100 characters. Use the user's own words."),
             siteId: z
                 .string()
                 .optional()
@@ -47,7 +51,7 @@ export function addSuggestedDomainTool(server, authStrategy) {
             tlds: z
                 .array(z.string())
                 .optional()
-                .describe('Filter by specific TLDs (e.g. ["com", "net"]). Do not include the dot.'),
+                .describe('Optional. Include only when the user asks for specific TLDs. Filter by specific TLDs (e.g. ["com", "net"]). Do not include the dot.'),
             limit: z
                 .number()
                 .optional()
@@ -106,7 +110,7 @@ export function addSuggestedDomainTool(server, authStrategy) {
                             structuredContent: { domains: [] }
                         };
                     }
-                    if (!isDefaultSiteName(siteName) || !resolvedQuery) {
+                    if (isSearchableSiteName(siteName) || !resolvedQuery) {
                         resolvedQuery = siteName;
                     }
                 }
@@ -126,7 +130,9 @@ export function addSuggestedDomainTool(server, authStrategy) {
                     }
                 }
             }
-            const params = new URLSearchParams({ query: resolvedQuery });
+            const params = new URLSearchParams({
+                query: resolvedQuery.slice(0, MAX_QUERY_LENGTH)
+            });
             if (limit) {
                 params.set('paging.limit', String(limit));
             }
@@ -135,14 +141,21 @@ export function addSuggestedDomainTool(server, authStrategy) {
                     params.append('tlds', tld);
                 }
             }
-            const response = await fetch(`${WIX_APIS_BASE_URL}/domain-search/v2/suggest-domains?${params}`, {
+            const suggestDomains = () => fetch(`${WIX_APIS_BASE_URL}/domain-search/v2/suggest-domains?${params}`, {
                 method: 'GET',
                 headers: {
                     Accept: 'application/json'
                 }
             });
+            let response = await suggestDomains();
+            let errorText = response.ok ? '' : await response.text();
+            // Domain search sells only some TLDs and rejects the whole request for one it doesn't.
+            if (errorText.includes('TLD_NOT_SUPPORTED') && params.has('tlds')) {
+                params.delete('tlds');
+                response = await suggestDomains();
+                errorText = response.ok ? '' : await response.text();
+            }
             if (!response.ok) {
-                const errorText = await response.text();
                 throw new Error(`Domain suggestions API returned ${response.status}: ${errorText}`);
             }
             const data = (await response.json());

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

@@ -314,6 +314,17 @@ export interface CodeValidationResult {
 	error?: string;
 }
 export declare function validateExecuteCode(code: string): CodeValidationResult;
+/** Wix "Auto GraphQL": one schema generated over all Wix public APIs. */
+export declare const WIX_GRAPHQL_ENDPOINT = "https://www.wixapis.com/graphql/alpha";
+export declare const SEARCH_GRAPHQL_TOOL_NAME = "SearchWixGraphQLOperations";
+export declare const INSPECT_GRAPHQL_TOOL_NAME = "InspectWixGraphQLSchema";
+export declare const EXECUTE_GRAPHQL_TOOL_NAME = "ExecuteWixGraphQL";
+export declare const GRAPHQL_TOOL_NAMES: readonly [
+	"SearchWixGraphQLOperations",
+	"InspectWixGraphQLSchema",
+	"ExecuteWixGraphQL"
+];
+export type GraphqlToolName = (typeof GRAPHQL_TOOL_NAMES)[number];
 /** URL for the management recipes index article */
 export declare const RECIPES_INDEX_URL = "https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/skills/wix-management-recipes-index";
 /**
@@ -379,6 +390,7 @@ export interface ModeDefaultConfig {
 	partnerContextEnabled?: boolean;
 	usePlatformizedSearch?: boolean;
 	skillsPrOverrideEnabled?: boolean;
+	graphqlEnabled?: boolean;
 }
 export declare const SYSTEM_REMINDER_GUIDELINES: string;
 export declare const SYSTEM_REMINDER: string;

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

@@ -314,6 +314,17 @@ export interface CodeValidationResult {
 	error?: string;
 }
 export declare function validateExecuteCode(code: string): CodeValidationResult;
+/** Wix "Auto GraphQL": one schema generated over all Wix public APIs. */
+export declare const WIX_GRAPHQL_ENDPOINT = "https://www.wixapis.com/graphql/alpha";
+export declare const SEARCH_GRAPHQL_TOOL_NAME = "SearchWixGraphQLOperations";
+export declare const INSPECT_GRAPHQL_TOOL_NAME = "InspectWixGraphQLSchema";
+export declare const EXECUTE_GRAPHQL_TOOL_NAME = "ExecuteWixGraphQL";
+export declare const GRAPHQL_TOOL_NAMES: readonly [
+	"SearchWixGraphQLOperations",
+	"InspectWixGraphQLSchema",
+	"ExecuteWixGraphQL"
+];
+export type GraphqlToolName = (typeof GRAPHQL_TOOL_NAMES)[number];
 /** URL for the management recipes index article */
 export declare const RECIPES_INDEX_URL = "https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/skills/wix-management-recipes-index";
 /**
@@ -379,6 +390,7 @@ export interface ModeDefaultConfig {
 	partnerContextEnabled?: boolean;
 	usePlatformizedSearch?: boolean;
 	skillsPrOverrideEnabled?: boolean;
+	graphqlEnabled?: boolean;
 }
 export declare const SYSTEM_REMINDER_GUIDELINES: string;
 export declare const SYSTEM_REMINDER: string;

package/build/dts/toolkit-entry.js

@@ -16,6 +16,10 @@ export { WixFetchError } from './wix-fetch-error.js';
 export { attachConsoleLogger } from './infra/logger.js';
 // Code-mode validation (pre-flight the same check the runtime applies)
 export { validateExecuteCode, EXECUTE_FUNCTION_EXPRESSION_HINT } from './code-mode/validation.js';
+// GraphQL tool names/constants (register the tools via createWixToolkit's
+// api.tools / api.enableTools; addGraphqlTools itself stays on the main entry
+// because its WixMcpServer parameter would pull the SDK types into this bundle)
+export { GRAPHQL_TOOL_NAMES, SEARCH_GRAPHQL_TOOL_NAME, INSPECT_GRAPHQL_TOOL_NAME, EXECUTE_GRAPHQL_TOOL_NAME, WIX_GRAPHQL_ENDPOINT } from './graphql/index.js';
 // Docs fetch utilities
 export { fetchRecipesIndex, fetchArticle, RECIPES_INDEX_URL } from './docs/fetch-article.js';
 // Config (the widget-related config exports stay on the main entry)

package/build/dts/toolkit.js

@@ -32,6 +32,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { HttpClient } from '@wix/http-client';
 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 { defaultReadmeDocs, executeCodeModeToolDescriptions, buildToolDescriptions } from './config/default-config.js';
 import { getDynamicContext } from './docs/get-to-know.js';
@@ -224,6 +225,19 @@ export function createWixToolkit(options) {
                 maxResponseSize
             });
         }
+        // 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) {
+            addGraphqlTools(server, {
+                authStrategy,
+                disableTools: [
+                    ...(disableTools ?? []),
+                    ...GRAPHQL_TOOL_NAMES.filter((n) => !requestedTools.has(n))
+                ],
+                toolDescriptions: effectiveToolDescriptions,
+                maxResponseSize
+            });
+        }
     }
     else {
         // Default: register all API tools

package/build/dts/wixel/wixel-session-tools.d.ts

@@ -3,6 +3,8 @@ import { WixMcpServer } from '../wix-mcp-server.js';
 export interface WixelSessionToolOptions {
     conductorOverride?: string;
     supportsWidgets?: () => boolean;
+    /** Shared by the session tools of one server; created by addWixelSessionTools. */
+    liveCards?: LiveCardRegistry;
 }
 type WixelAssetEntity = {
     id?: string;
@@ -30,11 +32,52 @@ export type WixelDeck = {
 };
 export declare function collectDecks(projectAssets: WixelAssetEntity[], deckIds: Set<string>): Map<string, WixelDeck>;
 export declare function extractAssetIds(text: string): string[];
+/**
+ * Live result cards, per Wixel session handle: the turns a card was rendered
+ * for (and when), the asset ids / media URLs those cards display, and the
+ * last turn send_wixel_message opened. The model does not reliably obey "do
+ * not poll" once a live card is up, so the tools enforce it: list_wixel_events
+ * refuses while a card is active, get_wixel_asset_result refuses to render
+ * the same result a second time, and get_wixel_pending_question stays quiet
+ * for a question the card already shows.
+ *
+ * One registry per server instance (like list_wixel_events' cursor memory),
+ * so sessions never see each other's records. In-memory like that memory
+ * too: a Durable Object wake-up starts empty, and the intercepts simply
+ * don't apply until the next send.
+ */
+type LiveCardRecord = {
+    /** Turn id → when its live card was rendered. */
+    turns: Map<string, number>;
+    /** Turns whose card reached done/failed — the agent may poll again. */
+    finishedTurns: Set<string>;
+    shownAssets: Set<string>;
+    lastSentTurn: string | null;
+};
+export type LiveCardRegistry = ReturnType<typeof createLiveCardRegistry>;
+export declare function createLiveCardRegistry(): {
+    get: (handle: string) => LiveCardRecord | undefined;
+    forHandle: (handle: string) => LiveCardRecord;
+    isActive: (handle: string, params: {
+        authHeaders: Record<string, string>;
+        conductorOverride?: string;
+        metaSiteId: string;
+    }) => Promise<boolean>;
+};
 export declare function addGetWixelPendingQuestionTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export declare function addStartWixelSessionTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export declare function addSendWixelMessageTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export declare function addListWixelEventsTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export declare function addGetWixelStylePresetsTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
+export type WixelTurnStatus = 'generating' | 'question' | 'done' | 'failed';
+export declare function addGetWixelTurnResultTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
+export type WixelResultAssetEntry = {
+    id: string;
+    kind: 'image' | 'video' | 'slides' | 'document';
+    name: string | null;
+    url: string;
+    slideUrls?: string[];
+};
 export declare function addGetWixelAssetResultTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export declare function addWixelSessionTools(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, options?: WixelSessionToolOptions): void;
 export {};