@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-app/references/editor-react-component/VISUAL-QUALITY.md

@@ -0,0 +1,39 @@
+# Visual Quality
+
+Use this reference for a component's default look: hierarchy, spacing, and
+foreground/background contrast.
+
+**Visual intent.** When the request specifies how the component should look —
+mood, palette, layout style, or a reference — follow that direction. Default to a modern, refined look — intentional layout, pleasing proportions, polished and deliberate styling.
+
+## Default Visual Quality
+
+Create a clear hierarchy with at least two techniques that fit the component:
+a defined surface, border or soft shadow, type scale or weight, spacing, an
+accent, or visible interaction states. Use these neutral defaults unless the
+request or existing design provides better values:
+
+- 16px or larger body text, 14px or larger labels, and 600–700 weight for titles
+- 8–16px spacing inside controls and 16–32px spacing inside containers
+- 8–12px corner radii for cards and controls; `50%` for circular media
+- a subtle border or soft shadow when a card, panel, or control needs separation
+- touch targets at least 44 by 44px and visible keyboard focus states
+
+### Foreground and Background Ownership
+
+If the component is a self-contained block (card, panel, banner, accordion item), give the root a background. An inline control meant to blend in (link, ghost button, icon button) may leave it transparent.
+
+- On a transparent root, don't hardcode text or icon colors; inherit them from the parent.
+- Set the background and main text/icon color together on the same element. Any secondary text (captions, hints, icons) must still be readable against that same background.
+- If an interactive state changes the background, set the foreground color in that state too. Don't assume a color inherited from a parent or from a previous state will still look right on the new background.
+- In every default and interactive state, meet WCAG AA contrast: 4.5:1 for body text and 3:1 for large text and UI controls.
+
+A neutral owned surface may use a light background with dark primary and
+secondary foregrounds, plus one accessible accent. The exact colors are not a
+contract; the contrast relationship is.
+
+## Checklist
+
+- [ ] Visual containers have deliberate hierarchy rather than bare scaffolding.
+- [ ] Every explicit foreground has a known contrasting background; transparent
+      components inherit foregrounds from their host.

package/skills/wix-docs/references/CALLING.md

@@ -68,7 +68,7 @@ Append `.md` to read:
 - [`rest-api-authentication`](https://dev.wix.com/docs/api-reference/articles/authentication/rest-api-authentication) — headers, token kinds
 - [`retrieve-tokens`](https://dev.wix.com/docs/api-reference/business-management/headless/authentication/retrieve-tokens) — the `/oauth2/token` contract, all grant types
 - [`about-authentication`](https://dev.wix.com/docs/go-headless/authentication/about-authentication) — visitor vs member sessions
-- [`create-an-oauth-app-for-visitors-and-members`](https://dev.wix.com/docs/go-headless/getting-started/setup/authentication/create-an-oauth-app-for-visitors-and-members) — where the client id comes from
+- [`create-oauth-app`](https://dev.wix.com/docs/api-reference/business-management/headless/oauth-apps/create-oauth-app) — where the client id comes from
 - [`set-up-a-headless-client`](https://dev.wix.com/docs/go-headless/authentication/setup/set-up-a-headless-client) — wiring the client
 
 ## Dynamic Site Context — "what IS this site?"

package/skills/wix-headless-kit/guides/api-run.md

@@ -69,7 +69,7 @@ visitor tokens only, which cover what a visitor may see and nothing here.
 
 Unchanged from SKILL.md step 2 and its Verticals table: the brief names the business, the table
 names the solutions it needs. Read each solution's `{TEMPLATES}/{solution}/INSTRUCTIONS.md` for
-what it covers and `{TEMPLATES}/{solution}/seed/SEED.md` for what a seeded site holds.
+what it covers and `{TEMPLATES}/{solution}/seed/SEED.md` (`{solution}` is the template folder name, e.g. `storefront`, `bookings`) for what a seeded site holds.
 
 A brief that needs no solution (a game, a landing page, a tool) is a run of two steps: the site
 (step 2, with no `seedOptions`) and the frontend (step 5). No apps, no seed.

package/skills/wix-headless-kit/install/pins.json

@@ -3,6 +3,6 @@
   "@wix/create-new": "0.0.124",
   "typescript": "5.8.3",
   "templates": {
-    "ref": "v1.35.1"
+    "ref": "v1.36.1"
   }
 }

package/skills/wix-headless-templates/blog/seed/seed-blog.mjs

@@ -118,7 +118,7 @@ export async function installBlogApp(ctx) {
 
 // Every post create needs a REAL author memberId — a fabricated id fails with
 // "memberIds ... do not exist". A provisioned site has the owner as members[0].
-// docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/members/list-members.md
+// docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/list-members.md
 export async function getAuthorMemberId(ctx) {
   const r = await req(ctx, "/members/v1/members?fieldsets=PUBLIC&paging.limit=1", { method: "GET" });
   const id = r.members?.[0]?.id;

package/skills/wix-headless-templates/donations/app/wix/donations/campaigns.ts

@@ -22,7 +22,6 @@ const settingsApi = wixModule(ecommerceSettings);
 // The metrics list is EMPTY on a campaign nobody has donated to yet, and the campaign entity carries
 // formatted amounts but no currency code — so a fresh site would format nothing. The site's currency
 // comes from the eCommerce settings then (BUSINESS_INFO), read once per process; "" when refused.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= settingsApi

package/skills/wix-headless-templates/donations/app/wix/donations/donate.ts

@@ -6,7 +6,7 @@
 // (shared with the REST twin); this file is the transport only. Copy as-is.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { cartV2 as cartV2Module, orders as ordersModule } from "@wix/ecom";
 import { redirects as redirectsModule } from "@wix/redirects";
 import { wixModule } from "../sdk";

package/skills/wix-headless-templates/donations/project/src/wix/donations/campaigns.ts

@@ -22,7 +22,6 @@ const settingsApi = wixModule(ecommerceSettings);
 // The metrics list is EMPTY on a campaign nobody has donated to yet, and the campaign entity carries
 // formatted amounts but no currency code — so a fresh site would format nothing. The site's currency
 // comes from the eCommerce settings then (BUSINESS_INFO), read once per process; "" when refused.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= settingsApi

package/skills/wix-headless-templates/donations/project/src/wix/donations/donate.ts

@@ -6,7 +6,7 @@
 // (shared with the REST twin); this file is the transport only. Copy as-is.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { cartV2 as cartV2Module, orders as ordersModule } from "@wix/ecom";
 import { redirects as redirectsModule } from "@wix/redirects";
 import { wixModule } from "../sdk";

package/skills/wix-headless-templates/donations/rest/campaigns.ts

@@ -16,7 +16,6 @@ const BASE = "/donation-campaigns/v2/donation-campaigns";
 // A campaign nobody has donated to yet has no metrics entry, and the entity carries no currency code:
 // the site's currency then comes from the eCommerce settings, read once.
 // GET /_api/ecommerce-settings/v1/ecommerce-settings?fields=BUSINESS_INFO → { ecommerceSettings: { businessInfo: { currency } } }
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 let siteCurrencyPromise: Promise<string> | null = null;
 function siteCurrency(): Promise<string> {
   siteCurrencyPromise ??= wixRequest<Raw>("/_api/ecommerce-settings/v1/ecommerce-settings", { method: "GET", query: { fields: ["BUSINESS_INFO"] } })

package/skills/wix-headless-templates/donations/rest/donate.ts

@@ -6,7 +6,7 @@
 // order yourself, never hand-build a checkout URL.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/create-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/orders/get-order.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/get-order.md
 import { wixRequest } from "../../shared/rest/client.js";
 import {
   cartBody,

package/skills/wix-headless-templates/events/seed/seed-events.mjs

@@ -85,7 +85,7 @@ function buildRegistration(ev) {
 // Forms API AFTER the event exists (Create Event ignores form.controls; probed live 2026-09-28). The
 // control lands as a count input (options "0".."N") plus a names list capped at N — the shape the
 // site's form reader (events-core toRsvpForm) reads its max from — and takes effect at once.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/forms/add-control.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/form/add-control.md
 export async function addGuestControl(ctx, eventId, guests) {
   const n = Number(guests);
   if (!Number.isInteger(n) || n < 1) return false;

package/skills/wix-headless-templates/faq/INSTRUCTIONS.md

@@ -296,7 +296,7 @@ without telling the owner.
 
 ## Verification caveats
 
-The FAQ API's reference exists (`https://dev.wix.com/docs/rest/business-management/faq-app/…`) and the
+The FAQ API's reference exists (`https://dev.wix.com/docs/api-reference/business-management/faq-app/…`) and the
 shipped calls follow it: `POST /faq/v2/categories/query`, `POST /faq/v2/question-entries/query`, the
 `RICH_CONTENT` content format and the `SHARE_LINKS` field set. Not confirmed on a live site, and
 guarded in the code:

package/skills/wix-headless-templates/faq/app/wix/faq/faq.ts

@@ -3,8 +3,8 @@
 // rules and mappers live in ./faq-core (shared with the REST twin in templates/faq/rest/); this file
 // is the transport only. Copy as-is; extend by adding functions, not by editing these. The vertical
 // is read-only: authoring stays in the dashboard.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { category as categoryModule, questionEntry as questionModule } from "@wix/faq";
 import { wixModule } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/faq/project/src/wix/faq/faq.ts

@@ -3,8 +3,8 @@
 // rules and mappers live in ./faq-core (shared with the REST twin in templates/faq/rest/); this file
 // is the transport only. Copy as-is; extend by adding functions, not by editing these. The vertical
 // is read-only: authoring stays in the dashboard.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { category as categoryModule, questionEntry as questionModule } from "@wix/faq";
 import { wixModule } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/faq/rest/faq.ts

@@ -5,8 +5,8 @@
 // them is not documented — the reference shows an elevated example — so a 403 here means the site's
 // read needs a server-side path, not that the body is wrong (INSTRUCTIONS.md, verification caveats).
 // Porting: keep the paths, keep the bodies, port the core once.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { imgSrc } from "../../shared/rest/media.js";
 import {

package/skills/wix-headless-templates/faq/seed/SEED.md

@@ -82,7 +82,7 @@ partial re-seed.
 
 ## Verification caveats
 
-The FAQ API's reference pages exist (`dev.wix.com/docs/rest/business-management/faq-app/…`) and
+The FAQ API's reference pages exist (`dev.wix.com/docs/api-reference/business-management/faq-app/…`) and
 every path, verb, and body here follows them; the following were not checked on a live site:
 
 - Whether the create endpoints answer 409 on a duplicate title/question or create a second copy. The

package/skills/wix-headless-templates/faq/seed/read-site.mjs

@@ -3,7 +3,7 @@
 import { runReader } from "../../shared/seed/read-site.mjs";
 
 const FAQ_APP_ID = "14c92d28-031e-7910-c9a8-a670011e062d";
-const D = "https://dev.wix.com/docs/rest/business-management/faq-app/faq";
+const D = "https://dev.wix.com/docs/api-reference/business-management/faq-app";
 
 await runReader({
   vertical: "faq",

package/skills/wix-headless-templates/faq/seed/seed-faq.mjs

@@ -25,7 +25,7 @@ import { readFileSync } from "node:fs";
 
 const API = "https://www.wixapis.com";
 const FAQ_APP_ID = "14c92d28-031e-7910-c9a8-a670011e062d";
-const D = "https://dev.wix.com/docs/rest/business-management/faq-app/faq";
+const D = "https://dev.wix.com/docs/api-reference/business-management/faq-app";
 /** The API's page cap (CursorPaging.limit max 100). */
 const PAGE_LIMIT = 100;
 /** sortOrder step — increments of 10 leave room to insert between items later (the reference's own tip). */
@@ -134,14 +134,14 @@ export async function installFaqApp(ctx) {
 }
 
 // Existing categories, straight from the query (the source of truth for what persisted).
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/query-categories.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/query-categories.md
 export async function readCategories(ctx) {
   const r = await reqRetryOnce(ctx, "/faq/v2/categories/query", { body: { query: { cursorPaging: { limit: PAGE_LIMIT } } } });
   return (r.categories ?? []).map((c) => ({ id: rawId(c), title: c.title ?? "", sortOrder: typeof c.sortOrder === "number" ? c.sortOrder : null }));
 }
 
 // Every existing question (paged by cursor; PLAIN_TEXT keeps the read light — only the text is compared).
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/query-question-entries.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/query-question-entries.md
 export async function readQuestions(ctx) {
   const out = [];
   let cursor = null;
@@ -164,7 +164,7 @@ export async function readQuestions(ctx) {
 //  2. Idempotency — an already-present title (a partial-failure re-run, Wix's sample content) is kept.
 // New categories append after the existing ones: sortOrder = max(existing) + 10, +20, …
 // Body is NESTED: { category: { title, sortOrder } } → { category: { id, … } }.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/category-v2/create-category.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/category-v2/create-category.md
 export async function ensureCategories(ctx, titles) {
   let existing = await readCategories(ctx);
   const byTitle = () => new Map(existing.map((c) => [norm(c.title), c]));
@@ -196,7 +196,7 @@ export async function ensureCategories(ctx, titles) {
 
 // One question, one call (the SDK exports no bulk create). Body is NESTED: { questionEntry: { … } } →
 // { questionEntry: { id, slug, … } }. `question` and `categoryId` are required; the answer is a oneof.
-// docs: https://dev.wix.com/docs/rest/business-management/faq-app/faq/question-entry-v2/create-question-entry.md
+// docs: https://dev.wix.com/docs/api-reference/business-management/faq-app/question-entry-v2/create-question-entry.md
 export async function createQuestion(ctx, { question, categoryId, sortOrder, labels, answer }, idx) {
   const body = {
     questionEntry: {

package/skills/wix-headless-templates/forms/app/wix/forms/forms.ts

@@ -13,8 +13,8 @@
 // implicit visitor access so a published site can render its own forms. Do NOT add a backend, a
 // connector token, or auth.elevate to make a form load.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/get-form.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/list-forms.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/list-forms.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/about-form-fields.md
 import { wixFetch } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/forms/app/wix/forms/submissions.ts

@@ -13,8 +13,8 @@
 // scope and 403s. The resolved create IS the confirmation — show a thank-you; the entry appears
 // in the owner's dashboard. A site that must LIST what visitors submitted needs `cms` instead.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/create-submission.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/get-media-upload-url.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md?apiView=SDK
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/get-media-upload-url.md?apiView=SDK
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/about-submission-values.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 import { submissions as submissionsModule } from "@wix/forms";

package/skills/wix-headless-templates/forms/project/src/wix/forms/forms.ts

@@ -13,8 +13,8 @@
 // implicit visitor access so a published site can render its own forms. Do NOT add a backend, a
 // connector token, or auth.elevate to make a form load.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/get-form.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/forms/list-forms.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/get-form.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/list-forms.md
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/about-form-fields.md
 import { wixFetch } from "../sdk";
 import { imgSrc } from "../media";

package/skills/wix-headless-templates/forms/project/src/wix/forms/submissions.ts

@@ -13,8 +13,8 @@
 // scope and 403s. The resolved create IS the confirmation — show a thank-you; the entry appears
 // in the owner's dashboard. A site that must LIST what visitors submitted needs `cms` instead.
 //
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/create-submission.md
-// docs: https://dev.wix.com/docs/sdk/business-solutions/forms/submissions/get-media-upload-url.md
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/create-submission.md?apiView=SDK
+// docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/get-media-upload-url.md?apiView=SDK
 // docs: https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/about-submission-values.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
 import { submissions as submissionsModule } from "@wix/forms";

package/skills/wix-headless-templates/members/seed/read-site.mjs

@@ -3,7 +3,7 @@
 import { runReader } from "../../shared/seed/read-site.mjs";
 
 const MEMBERS_AREA_APP_ID = "14cc59bc-f0b7-15b8-e1c7-89ce41d0e0c9";
-const D = "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/members";
+const D = "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members";
 
 await runReader({
   vertical: "members",

package/skills/wix-headless-templates/pricing-plans/app/wix/pricing-plans/plan-access.ts

@@ -12,7 +12,7 @@
 //   manual client (React SPA, lib) — the shared seam holds a VISITOR token; pass a call bound to the
 //             member's client instead, e.g. from templates/members' client.ts strategy:
 //             `createClient({ auth: membersAuth, modules: { orders } }).orders.memberListOrders`.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { orders as ordersModule } from "@wix/pricing-plans";
 import { wixModule } from "../sdk";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "./plan-access-core";

package/skills/wix-headless-templates/pricing-plans/project/src/wix/pricing-plans/plan-access.ts

@@ -12,7 +12,7 @@
 //   manual client (React SPA, lib) — the shared seam holds a VISITOR token; pass a call bound to the
 //             member's client instead, e.g. from templates/members' client.ts strategy:
 //             `createClient({ auth: membersAuth, modules: { orders } }).orders.memberListOrders`.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { orders as ordersModule } from "@wix/pricing-plans";
 import { wixModule } from "../sdk";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "./plan-access-core";

package/skills/wix-headless-templates/pricing-plans/rest/plan-access.ts

@@ -4,7 +4,7 @@
 // after the members vertical's rest/auth.ts login (`loggedInHint()` true) — and is refused for a
 // visitor, so callers check the session first (the store does) and never call for a visitor.
 // Porting: keep the path and the query string; the rule is one line in the core.
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-list-orders.md
+// docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/member-orders-service-list-orders.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "../app/wix/pricing-plans/plan-access-core.js";
 import type { Raw } from "../app/wix/pricing-plans/plans-core.js";

package/skills/wix-headless-templates/restaurants/app/wix/restaurants/menu.ts

@@ -9,7 +9,6 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifier-groups/list-modifier-groups.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifiers/list-modifiers.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-labels/list-labels.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import {
   menus as menusModule,
   sections as sectionsModule,

package/skills/wix-headless-templates/restaurants/project/src/wix/restaurants/menu.ts

@@ -9,7 +9,6 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifier-groups/list-modifier-groups.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-modifiers/list-modifiers.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-labels/list-labels.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import {
   menus as menusModule,
   sections as sectionsModule,

package/skills/wix-headless-templates/restaurants/rest/menu.ts

@@ -6,7 +6,6 @@
 // port the core once. Entities carry `id` here (the SDK spells it `_id`); the core accepts both.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/menus/list-menus.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/items/list-items.md
-// docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/ecommerce-settings/get-ecommerce-settings.md
 import { wixRequest } from "../../shared/rest/client.js";
 import { imgSrc } from "../../shared/rest/media.js";
 import {

package/skills/wix-headless-templates/shared/rest/client.ts

@@ -14,7 +14,7 @@
 //   server (a Python/PHP/Go port) — the SHOPPER'S SESSION, one token set per shopper. Never one
 //             process-wide token for everyone: that is one shared cart for all visitors.
 //             This is the only part of a port that isn't line-for-line.
-// docs: https://dev.wix.com/docs/go-headless/coding/authentication/visitors.md
+// docs: https://dev.wix.com/docs/go-headless/authentication/visitors/authenticate-visitors-rest.md
 import { WIX_CLIENT_ID } from "./config.js";
 
 export const WIX_API_BASE = "https://www.wixapis.com";

package/skills/wix-headless-templates/shared/seed/site.mjs

@@ -7,7 +7,8 @@ const API = "https://www.wixapis.com";
 // cannot be repriced afterwards. A new site starts in the currency of the account that created
 // it, not the business's. Reads can report the old currency for a few seconds after this returns;
 // that lag is expected and self-resolves.
-// docs: https://dev.wix.com/docs/rest/business-management/site-properties/properties/update-site-properties
+// No reference page documents this PATCH any more (Update Site Properties left the docs). The docs
+// cover the same field only under Update Business Region, a different endpoint and body.
 export async function setSiteCurrency(ctx, currency) {
   if (!/^[A-Z]{3}$/.test(currency)) throw new Error(`currency must be a 3-letter ISO code, got "${currency}"`);
   const res = await fetch(`${API}/site-properties/v4/properties`, {

package/skills/wix-manage/SKILL.md

@@ -343,11 +343,11 @@ Import Google Business Profile locations into the authenticated Wix site, list a
 
 ## Marketing
 
-### [Create and Publish a Social Media Post (with AI generation)](references/marketing/create-and-publish-social-post.md)
-"End-to-end flow to create a social media post, optionally generating it with AI, and publish or schedule it to a site's connected channel (Instagram, Facebook, LinkedIn, X/Twitter, TikTok, Pinterest, YouTube, Google Business Profile) using the Wix Publisher API. Can generate a full per-channel post from a free-text idea or from the site's own assets (products, blog posts, events, bookings, coupons, categories), generate caption/title suggestions, and edit an existing image with AI. Settles the post content with you first, then confirms the channel is connected, checks premium quota, creates a draft, and publishes now or schedules it. Use for 'create a post', 'generate a post from my product/idea', 'write a caption', 'caption ideas/suggestions', 'edit a post image with AI', 'post to Instagram/Facebook/TikTok', 'connect my Instagram/Pinterest/LinkedIn', or 'schedule a post'."
+### [Create and Publish a Social Media Post](references/marketing/create-and-publish-social-post.md)
+"End-to-end flow to create a social media post, with its text written for you or your own, and publish or schedule it to a site's connected channel (Instagram, Facebook, LinkedIn, X/Twitter, TikTok, Pinterest, YouTube, Google Business Profile) using the Wix Publisher API. Can write a full per-channel post from a free-text idea or from the site's own assets (products, blog posts, events, bookings, coupons, categories), with your own image, and suggest captions and titles. Settles the post content with you first, then confirms the channel is connected, checks premium quota, creates a draft, and publishes now or schedules it. Use for 'create a post', 'generate a post from my product/idea', 'write a caption', 'caption ideas/suggestions', 'post to Instagram/Facebook/TikTok', 'connect my Instagram/Pinterest/LinkedIn', or 'schedule a post'."
 
 ### [Generate a Marketing Plan and Schedule Its Posts](references/marketing/generate-and-publish-marketing-plan.md)
-"End-to-end flow to generate an AI-powered social media marketing plan for a site and schedule its generated posts for publishing, using the Wix Marketing Plan API. Recommends configuring marketing settings (goal, tone, cadence, content pillars) before the first generation, generates the plan asynchronously, polls until it's ready, then schedules the DRAFT posts. Includes generating posts for additional activities. Use for 'generate a marketing plan', 'create a social media plan/calendar', or 'schedule my plan's posts' requests."
+"End-to-end flow to generate a site's social media marketing plan with the Wix Marketing Plan API and schedule the post drafts it returns. Recommends configuring marketing settings (goal, tone, cadence, content pillars) before the first generation, generates the plan asynchronously, polls until it's ready, then schedules the DRAFT posts. Includes generating posts for additional activities. Use for 'generate a marketing plan', 'create a social media plan/calendar', or 'schedule my plan's posts' requests."
 
 ### [Marketing Dashboard Navigation](references/marketing/marketing-dashboard-navigation.md)
 "Builds direct links to Wix marketing dashboard pages on manage.wix.com — the social posts hub (drafts, scheduled and published posts across connected channels), post design templates, saved designs, and the email marketing pages (campaigns list, campaign templates, campaign analytics). Pairs each main marketing entity (social post item, connected social account, marketing-plan post, email campaign) with its read API so you can fetch an entity and hand back a 'view it in your dashboard' link. Use when the user asks where something is in the Wix dashboard, wants a direct link to a dashboard page, or you need a dashboard URL to include with the result of an API operation."

package/skills/wix-manage/references/cms/cms-data-items-crud.md

@@ -37,6 +37,83 @@ It may be, that user refers to schema by its `displayName` rather than `id`, if
 
 ---
 
+## Writing Image Fields
+
+Read the collection schema before setting an image: `IMAGE` takes an HTTP URL or
+`wix:image://` string; `MEDIA_IMAGE` takes a structured object. Never put a bare media ID,
+a URL string, or an editor media-search result directly into a `MEDIA_IMAGE` field.
+The API can return 200 and store an invalid string unchanged; an identical read-back
+is not proof that the image can render.
+
+1. Reuse the selected image if it is already in the site's Media Manager. For a new
+   external image, follow [Upload Media to Wix](../media/upload-media-to-wix.md).
+   If the user requested a generated image, first follow
+   [Generate an Image with AI](../media/generate-image-with-ai.md), then import it.
+   Confirm before importing or changing site data unless the user already authorized it.
+2. Build the field value from the Media Manager file descriptor: use
+   `file.media.image.image` for image metadata, with `file.id`, `file.url`, and
+   `file.displayName` as fallbacks for the ID, URL, and filename. Import can return
+   `PENDING` without image metadata; fetch the ready descriptor using the upload
+   recipe before using dimensions. Do not invent IDs or dimensions.
+3. For a Wix-hosted image, preserve `id`, `url`, `width`, `height`, `filename`, and
+   `altText` when available, and include a full `uri`:
+   `wix:image://v1/{id}/{encodedFilename}#originWidth={width}&originHeight={height}`.
+   An editor search result's `uri` may be only a media ID; resolve its file descriptor
+   and build the CMS value rather than copying that result. An external image may
+   instead use `{ "url": "https://example.com/photo.jpg", "altText": "Photo" }`;
+   not every supported object requires all the Wix-hosted metadata.
+4. Insert the object under `dataItem.data.<fieldKey>`, or patch an existing item
+   with `SET_FIELD` as below. For `IMAGE`, use the image URL or full Wix URI string
+   instead of the object. Leave the collection's existing field type unchanged.
+5. Read the item back and check the field against its declared type: for
+   `MEDIA_IMAGE`, require an object with a usable image source and the intended
+   image identity, not a string echoed by the API. Preserve unrelated item fields.
+   When browser access is available, check the image in the CMS or bound view.
+   Otherwise report that the structured value was saved and that rendering was
+   not visually verified. If generation or import fails, report the missing image;
+   do not write a placeholder or claim it was added.
+
+**Example — replace only the `image` field on an existing item**:
+
+`PATCH https://www.wixapis.com/wix-data/v2/items/{dataItemId}`
+
+The values below stand for metadata from the selected file, not values to fabricate.
+
+```json
+{
+  "dataCollectionId": "Milkshakes",
+  "patch": {
+    "dataItemId": "<dataItemId>",
+    "fieldModifications": [
+      {
+        "fieldPath": "image",
+        "action": "SET_FIELD",
+        "setFieldOptions": {
+          "value": {
+            "id": "<mediaId>",
+            "url": "https://static.wixstatic.com/media/<mediaId>",
+            "uri": "wix:image://v1/<mediaId>/Rainbow.jpg#originWidth=1024&originHeight=1024",
+            "filename": "Rainbow.jpg",
+            "width": 1024,
+            "height": 1024,
+            "altText": "Rainbow milkshake"
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+Verify with `GET https://www.wixapis.com/wix-data/v2/items/{dataItemId}?dataCollectionId=Milkshakes`
+and inspect `dataItem.data.image`.
+
+References: [Patch Data Item](https://dev.wix.com/docs/api-reference/business-solutions/cms/data-items/patch-data-item),
+[Import File](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/import-file),
+and [Importing Files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files).
+
+---
+
 ## Insert Data Item
 
 **Endpoint**: `POST https://www.wixapis.com/wix-data/v2/items`
@@ -612,7 +689,7 @@ The method article documents the same expansion as `"includeReferences": [{ "fie
 | `IMAGE` | Image reference (HTTP url or wix:image://v1/{mediaId}/{friendlyName}) | `"wix:image://v1/3f72369f2219e2ee853e9e3df0217ce1.jpg/Colorful%20Business%20Cards.jpg"` |
 | `VIDEO` | Video reference (HTTP url or wix:video://v1/{mediaId}/{friendlyName}) | `"wix:video://v1/11062b_484182533ede4b9a81329daf20238867/Sketching%20Design%20Concepts#posterUri=11062b_484182533ede4b9a81329daf20238867f000.jpg&posterWidth=1920&posterHeight=1080"` |
 | `DOCUMENT` | Document reference  (HTTP url or wix:document://v1/{mediaId}) | `"wix:document://v1/..."` |
-| `MEDIA_IMAGE` | Wix Media Image | `{ "id": "<mediaId>", "url": "http://...", "height": 640, "width": 480, "altText": "Picture" }` |
+| `MEDIA_IMAGE` | Structured image object, never a bare ID or URL string; see [Writing Image Fields](cms-data-items-crud.md#writing-image-fields) | `{ "id": "<mediaId>", "url": "https://static.wixstatic.com/media/<mediaId>", "uri": "wix:image://v1/<mediaId>/Photo.jpg#originWidth=480&originHeight=640", "height": 640, "width": 480, "altText": "Picture" }` |
 | `MEDIA_VECTOR_ART` | Wix Media Vector Art | `{ "uri": "wix:vector://v1/...", "viewBox": "0 0 100 100", "contentType": "shape", "svgContent": "<svg>...</svg>" }` |
 | `URL` | Web URL | `"https://example.com"` |
 | `RICH_TEXT` | HTML content | `"<p>Rich text</p>"` |

package/skills/wix-manage/references/google-ads/create-performance-max-campaign.md

@@ -4,7 +4,7 @@ description: "Creates and launches a Google Ads Performance Max (PMAX) campaign
 ---
 # RECIPE: Create and Launch a Performance Max Campaign
 
-A **Performance Max (PMAX)** campaign runs across every Google channel from a single **asset group** — a bundle of headlines, descriptions, images, and (optionally) videos that Google mixes into ads. There are three flavors, set by `campaignType`:
+A **Performance Max (PMAX)** campaign runs across every Google channel from a single **asset group** — a bundle of headlines, descriptions, and images that Google mixes into ads. There are three flavors, set by `campaignType`:
 
 - **`PERFORMANCE_MAX`** — general multi-channel campaign.
 - **`PERFORMANCE_MAX_LEADS`** — lead-gen variant (phone/form conversions, search-theme signals, negative keywords, a ~28-day learning phase). **Requires** at least one asset group with headlines, descriptions, and images; assets are validated synchronously, so bad assets fail the create call immediately.
@@ -110,19 +110,19 @@ Use `recommendedBudgetAmountMicros` as `budget.amountMicros`, or present the `bu
 
 ## Assemble & create the campaign (in PAUSED)
 
-An **asset group** lives at `performanceMaxCampaign.assetGroups[]`. Its creative assets go under `assetGroupAssets.assets[]` — each asset sets **exactly one** payload field plus its `assetFieldType`. For a PMAX Leads asset group, meet Google's minimums or the create call fails with `NOT_ENOUGH_ASSETS`:
+An **asset group** lives at `performanceMaxCampaign.assetGroups[]`. Its creative assets go under `assetGroupAssets.assets[]` — each asset sets **exactly one** payload field plus its `assetFieldType`. For a PMAX Leads asset group, keep each asset type within its count below, or the create call fails with `INVALID_ASSET_GROUP_ASSETS`:
 
 | Asset | Payload field | `assetFieldType` | Count | Max chars |
 | --- | --- | --- | --- | --- |
 | Short headline | `headlineAsset.text` | `HEADLINE` | 3–15 | 30 |
-| Long headline | `longHeadlineAsset.text` | `LONG_HEADLINE` | exactly 1 | 90 |
-| Description | `descriptionAsset.text` | `DESCRIPTION` | 2–4 | 90 |
+| Long headline | `longHeadlineAsset.text` | `LONG_HEADLINE` | 1–5 | 90 |
+| Description | `descriptionAsset.text` | `DESCRIPTION` | 2–5 | 90 |
 | Business name | `businessNameAsset.text` | `BUSINESS_NAME` | exactly 1 | 25 |
-| Landscape image (1.91:1) | `imageAsset.{name,url}` | `MARKETING_IMAGE` | ≥1 | — |
-| Square image (1:1) | `imageAsset.{name,url}` | `SQUARE_MARKETING_IMAGE` | ≥1 | — |
-| Logo (1:1) | `imageAsset.{name,url}` | `LOGO` | ≥1 | — |
-| CTA button | `callToActionSelectionAsset.callToAction` | `CALL_TO_ACTION_SELECTION` | optional | `LEARN_MORE` \| `SHOP_NOW` \| `SIGN_UP` \| `CONTACT_US` |
-| YouTube video | `youtubeVideoAsset.{title,id}` | `YOUTUBE_VIDEO` | optional (1–5) | 11-char video id |
+| Landscape image (1.91:1) | `imageAsset.{name,url}` | `MARKETING_IMAGE` | 1–20 | — |
+| Square image (1:1) | `imageAsset.{name,url}` | `SQUARE_MARKETING_IMAGE` | 1–20 | — |
+| Logo (1:1) | `imageAsset.{name,url}` | `LOGO` | 1–5 | — |
+
+Call-to-action, YouTube video, and media bundle assets are not supported — leave them out of the asset group.
 
 Image `url` must be a Wix Media Manager URL (`static.wixstatic.com`) — the STEP 2 generated images already are; for other images, upload via the Media Manager first (see [Upload Media to Wix](../media/upload-media-to-wix.md)). Search themes go under `assetGroupSignals.signals[]` (PMAX Leads).
 
@@ -155,7 +155,7 @@ curl -X POST 'https://www.wixapis.com/_serverless/pa-google/v1/campaigns' \
             { "businessNameAsset": { "text": "Sunrise Bakery" }, "assetFieldType": "BUSINESS_NAME" },
             { "imageAsset": { "name": "storefront-banner", "url": "https://static.wixstatic.com/media/abc123.jpg" }, "assetFieldType": "MARKETING_IMAGE" },
             { "imageAsset": { "name": "product-square",    "url": "https://static.wixstatic.com/media/def456.jpg" }, "assetFieldType": "SQUARE_MARKETING_IMAGE" },
-            { "callToActionSelectionAsset": { "callToAction": "SHOP_NOW" }, "assetFieldType": "CALL_TO_ACTION_SELECTION" }
+            { "imageAsset": { "name": "bakery-logo",       "url": "https://static.wixstatic.com/media/ghi789.png" }, "assetFieldType": "LOGO" }
           ] },
           "assetGroupSignals": { "signals": [
             { "searchTheme": { "text": "artisan bakery" } },
@@ -192,7 +192,7 @@ Returns the campaign with an updated `status`. Ads begin serving across Google c
 | --- | --- | --- |
 | `ACCOUNT_NOT_FOUND` | No Google Ads account | Run [install-and-create-account](install-and-create-account.md) |
 | `INVALID_ARGUMENT` / `NOT_ENOUGH_ASSETS` | Asset group below minimums | Add assets to meet the per-type counts in the table |
-| `INVALID_ARGUMENT` / `INVALID_ASSET_GROUP_ASSETS` | An asset is malformed or violates Google requirements | Fix the offending asset (length, type, url) |
+| `INVALID_ARGUMENT` / `INVALID_ASSET_GROUP_ASSETS` | An asset type's count is outside its range in the table, an asset type is unsupported, or an asset is malformed | Fix the count or the offending asset (length, type, url) |
 | `INVALID_ARGUMENT` / `INVALID_IMAGE_FORMAT` | Image format/dimensions unsupported | Use a supported ratio/size; regenerate via image-asset-suggestions |
 | `INVALID_ARGUMENT` / `DUPLICATE_IMAGE_ASSETS` / `DUPLICATE_ASSET` | Same asset provided twice | Deduplicate the asset group |
 | `INVALID_ARGUMENT` / `SEARCH_THEME_POLICY_VIOLATION` / `POLICY_VIOLATION` | A signal/asset violates Google policy | Remove or rewrite the flagged item |

package/skills/wix-manage/references/google-ads/get-campaign-suggestions.md

@@ -107,4 +107,3 @@ Returns `lowOffer` / `mediumOffer` / `highOffer`, each with `incentiveId`, `awar
 - [Get Keyword Theme Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-keyword-theme-suggestions)
 - [Get Geo Options](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-geo-options)
 - [Get Budget Suggestions](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-budget-suggestions)
-- [Get Incentives](https://dev.wix.com/docs/api-reference/business-management/marketing/ads/google-ads/google-suggestion-v1/get-incentives)