@wix/mcp 1.0.83 → 1.0.84

package/build/cjs/toolkit.cjs

@@ -19494,7 +19494,16 @@ ${skillsContent}`
       ] : await Promise.all(
         baseDocs.filter((doc) => doc.url === RECIPES_INDEX_URL).map(fetchDoc)
       );
-      const contents = [...baseContents, ...recipesContents];
+      const recipeNotes = !skillsContent?.includes("Dashboard Navigation") ? [] : [
+        await fetchDoc({
+          action: "text",
+          title: "Recipe Notes",
+          content: dedent_default`
+                - **Navigation recipes** (the *Dashboard Navigation* family) build direct manage.wix.com URLs. If your environment provides dedicated navigation tools, use those to perform the actual navigation — opening a recipe-built URL forces a full page refresh. Use the recipe URLs for composing a link to hand the user, or for navigating when no dedicated tool exists.
+              `
+        })
+      ];
+      const contents = [...baseContents, ...recipesContents, ...recipeNotes];
       const dynamicContext = await dynamicContextPromise;
       const parts = [
         ...contents.filter(

package/build/dts/docs/get-to-know.js

@@ -217,7 +217,23 @@ export async function addGetToKnowTools({ server, disableTools = [], toolDescrip
             : await Promise.all(baseDocs
                 .filter((doc) => doc.url === RECIPES_INDEX_URL)
                 .map(fetchDoc));
-        const contents = [...baseContents, ...recipesContents];
+        // Cross-recipe steering that applies to a family of recipes rather than
+        // any single article; rendered right after the index. Gated on the note's
+        // target family actually appearing in the rendered index — this also
+        // covers a failed/custom index (no recipes → no notes) and tag-filtered
+        // visitor indexes, which carry no Dashboard Navigation recipes.
+        const recipeNotes = !skillsContent?.includes('Dashboard Navigation')
+            ? []
+            : [
+                await fetchDoc({
+                    action: 'text',
+                    title: 'Recipe Notes',
+                    content: dedent `
+                - **Navigation recipes** (the *Dashboard Navigation* family) build direct manage.wix.com URLs. If your environment provides dedicated navigation tools, use those to perform the actual navigation — opening a recipe-built URL forces a full page refresh. Use the recipe URLs for composing a link to hand the user, or for navigating when no dedicated tool exists.
+              `
+                })
+            ];
+        const contents = [...baseContents, ...recipesContents, ...recipeNotes];
         const dynamicContext = await dynamicContextPromise;
         const parts = [
             ...contents

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

@@ -11,6 +11,8 @@ 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: {
@@ -41,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()
@@ -49,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()
@@ -128,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));
             }
@@ -137,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/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 {};