@wix/agent-skills 1.16.2 → 1.17.0

package/skills/wix-manage/references/sites/query-sites.md

@@ -1,173 +1,58 @@
 ---
 name: "Query Sites"
-description: Lists and queries all sites associated with a Wix account using the Sites API. Covers filtering, sorting, and cursor-based pagination.
+description: List, count, and find the sites in a Wix account. Covers the namespace filter for headless sites, counting before enumerating, cursor pagination, and resolving a site by name.
 ---
 # Query Sites
 
-This recipe demonstrates how to list and query the sites associated with a Wix account.
+List, count, and find the sites in a Wix account.
 
-## Prerequisites
+- **Auth**: account-level (a Wix user token, or an account-level API key). `wix token` prints one.
+- **Permission**: `SITE_LIST.READ` (scope `SCOPE.ACC-DC-OS.READ-SITE`).
+- **Endpoints**: list `POST https://www.wixapis.com/site-list/v2/sites/query` · count
+  `POST https://www.wixapis.com/site-list/v2/sites/count`.
 
-- Account-level API access (authenticated as a Wix user or using an account-level API key)
-- Permission `SITE_LIST.READ` (scope `SCOPE.ACC-DC-OS.READ-SITE`)
+## Include headless sites — filter by `namespace`
 
-## Required APIs
+Both endpoints see only `WIX`-namespace sites by default; **headless sites** (anything built on a
+connected OAuth app) are silently excluded. Filter on both namespaces to see everything:
 
-- **Query Sites API**: [REST](https://dev.wix.com/docs/api-reference/account-level/sites/sites/query-sites)
-
-> Returns up to **100** sites per request. Use cursor paging (below) to retrieve more.
-
----
-
-## Query Sites
-
-**Endpoint**: `POST https://www.wixapis.com/site-list/v2/sites/query`
-
-The request takes a `query` object that supports `filter`, `sort`, and `cursorPaging`.
-
-**Request Body**:
-```json
-{
-  "query": {
-    "filter": { "editorType": "EDITOR" },
-    "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
-    "cursorPaging": { "limit": 50 }
-  }
-}
-```
-
-All three fields are optional — `{ "query": { "cursorPaging": { "limit": 50 } } }` lists every site.
-
-**Request**:
 ```bash
-curl -X POST \
-  'https://www.wixapis.com/site-list/v2/sites/query' \
-  -H 'Authorization: <AUTH>' \
-  -H 'Content-Type: application/json' \
-  -d '{
-    "query": {
-      "filter": { "editorType": "EDITOR" },
-      "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
-      "cursorPaging": { "limit": 50 }
-    }
-  }'
-```
-
----
-
-## Response Structure
-
-The response has the sites array plus **two** paging objects: a top-level `cursorPaging`
-(echoes the applied limit and the next cursor) and `metadata` (count, `cursors.next`, `hasNext`).
-
-> ⚠️ There is **no** `pagingMetadata` field. Read paging info from `metadata`.
-
-```json
-{
-  "sites": [
-    {
-      "id": "f6061c5f-6aa3-42f8-8822-36a4981dabb2",
-      "htmlAppId": "70df538d-906c-44ca-9f27-c186b62f2b2b",
-      "name": "my-site-47",
-      "displayName": "My Site 47",
-      "createdDate": "2023-02-01T14:56:09.831Z",
-      "updatedDate": "2026-06-22T03:55:49.031Z",
-      "published": true,
-      "premium": false,
-      "viewUrl": "https://username.wixsite.com/my-site-47",
-      "editUrl": "/editor/f6061c5f-6aa3-42f8-8822-36a4981dabb2?editorSessionId=...",
-      "thumbnail": "/site-thumbnail/f6061c5f-6aa3-42f8-8822-36a4981dabb2",
-      "ownerAccountId": "e6a89eda-d100-4b2d-8a47-3040e2134497",
-      "contributorAccountIds": [],
-      "editorType": "EDITOR",
-      "blocked": false,
-      "namespace": "WIX",
-      "domainConnected": false,
-      "parentChildRole": "NONE"
-    }
-  ],
-  "cursorPaging": {
-    "limit": 50,
-    "cursor": "<cursor-for-next-page>"
-  },
-  "metadata": {
-    "count": 50,
-    "cursors": {
-      "next": "<cursor-for-next-page>"
-    },
-    "hasNext": true
-  }
-}
+curl -X POST 'https://www.wixapis.com/site-list/v2/sites/query' \
+  -H 'Authorization: <ACCOUNT_TOKEN>' -H 'Content-Type: application/json' \
+  -d '{ "query": { "filter": { "namespace": { "$in": ["WIX", "HEADLESS"] } }, "cursorPaging": { "limit": 100 } } }'
 ```
 
-### Site object fields
-
-Each entry in `sites` has these fields (from the `Site` schema):
-
-| Field | Type | Notes |
-|---|---|---|
-| `id` | string | Site ID — use for site-level API calls |
-| `htmlAppId` | string | Internal HTML app ID |
-| `name` | string | URL slug / internal name |
-| `displayName` | string | Human-readable site name |
-| `createdDate` / `updatedDate` | datetime | |
-| `trashedDate` | datetime | Present only if the site is in the trash |
-| `published` | boolean | Whether the site is published |
-| `premium` | boolean | Whether the site has a Wix Premium (paid) plan |
-| `viewUrl` | string | Public site address; empty string when unpublished. **There is no `siteUrl` field.** |
-| `editUrl` | string | Relative editor path; prefix with `https://manage.wix.com` to open |
-| `thumbnail` | string | Relative thumbnail path |
-| `ownerAccountId` | string | |
-| `contributorAccountIds` | string[] | |
-| `editorType` | string | e.g. `EDITOR`, `ODEDITOR` — also a valid `filter` field |
-| `blocked` | boolean | |
-| `folderId` / `parentId` | string | Set for sites organized in folders / parent-child setups |
-| `namespace` | string | e.g. `WIX` |
-| `domainConnected` | boolean | |
-| `parentChildRole` | string | e.g. `NONE` |
+`query` takes optional `filter`, `sort` (e.g. `[{ "fieldName": "createdDate", "order": "DESC" }]`),
+and `cursorPaging` (max `limit` 100).
 
----
+## Count before you enumerate
 
-## Pagination
+An account can hold thousands of sites. To find one by name, search (see "Find a site by name")
+rather than enumerate. To walk the whole list, count first and decide whether that's worth it:
 
-Cursor-based. Read the next cursor from `metadata.cursors.next` and stop when
-`metadata.hasNext` is `false`.
+```bash
+curl -X POST 'https://www.wixapis.com/site-list/v2/sites/count' \
+  -H 'Authorization: <ACCOUNT_TOKEN>' -H 'Content-Type: application/json' \
+  -d '{ "filter": { "namespace": { "$in": ["WIX", "HEADLESS"] } } }'   # → { "count": 1335 }
+```
 
-> The cursor does **not** carry the page limit, and it already encodes the filter/sort
-> from the first request. On follow-up pages send **only** the cursor (plus `limit` if you
-> want a non-default page size) — do **not** repeat `filter` or `sort`.
+Enumerating costs **~0.7s per 100 sites** (100 → ~0.7s, 500 → ~3.4s, ~1,300 → ~9s). For a large
+count, render the first N sites with a "…and N more" note instead of fetching all of them.
 
-**First request**:
-```json
-{
-  "query": {
-    "filter": { "editorType": "EDITOR" },
-    "sort": [{ "fieldName": "createdDate", "order": "ASC" }],
-    "cursorPaging": { "limit": 50 }
-  }
-}
-```
+## Paginate
 
-**Next page** (cursor from `metadata.cursors.next`):
-```json
-{
-  "query": {
-    "cursorPaging": {
-      "limit": 50,
-      "cursor": "<metadata.cursors.next from previous response>"
-    }
-  }
-}
-```
+The next cursor is at `metadata.cursors.next` (there is **no** `pagingMetadata` field); it already
+encodes the filter/sort, so follow-up pages send only the cursor:
 
-**Loop**:
 ```javascript
-async function listAllSites() {
+async function listAllSites(wixPost) {
   const sites = [];
   let cursor = null;
   do {
-    const cursorPaging = cursor ? { limit: 100, cursor } : { limit: 100 };
-    const res = await wixRequest({ query: { cursorPaging } }); // POST .../site-list/v2/sites/query
+    const query = cursor
+      ? { cursorPaging: { limit: 100, cursor } }
+      : { filter: { namespace: { $in: ["WIX", "HEADLESS"] } }, cursorPaging: { limit: 100 } };
+    const res = await wixPost("/site-list/v2/sites/query", { query });
     sites.push(...res.sites);
     cursor = res.metadata.hasNext ? res.metadata.cursors.next : null;
   } while (cursor);
@@ -175,23 +60,49 @@ async function listAllSites() {
 }
 ```
 
----
-
-## Common Use Cases
+## Find a site by name
 
-### List all sites
-Omit `filter` and page through with `cursorPaging` until `metadata.hasNext` is `false`.
+Substring-search by display name with `GET manage.wix.com/account/sites/api/sites/search`. It
+returns full site records (headless included) and, with `getCount=true`, the total:
 
-### Find a specific site
-Prefer server-side `filter` (e.g. `{ "editorType": "EDITOR" }`) and `sort` over fetching
-everything and filtering client-side. Filterable fields match the site object (e.g. `name`,
-`displayName`, `editorType`, `published`).
+```bash
+curl 'https://manage.wix.com/account/sites/api/sites/search?query=kintsugi&getCount=true' \
+  -H 'Authorization: <ACCOUNT_TOKEN>' -H 'accept: application/json'
+# → { "sites": [ { "metaSiteId", "displayName", "namespace", "published", "editUrl", … } ], "totalCount": 5 }
+```
 
----
+## Response — the `Site` object
+
+`sites` is an array of:
+
+```typescript
+interface Site {
+  id: string;                 // site ID — use for site-level API calls
+  htmlAppId: string;
+  name: string;               // URL slug / internal name; opaque `headless-<id>` for headless sites
+  displayName: string;        // human-readable name
+  createdDate: string;        // ISO datetime
+  updatedDate: string;        // ISO datetime
+  trashedDate?: string;       // present only when the site is in the trash
+  published: boolean;
+  premium: boolean;           // has a Wix Premium (paid) plan
+  viewUrl: string;            // public address; "" when unpublished (there is no `siteUrl` field)
+  editUrl: string;            // relative; prefix with https://manage.wix.com to open
+  thumbnail: string;
+  ownerAccountId: string;
+  contributorAccountIds: string[];
+  editorType: string;         // EDITOR | ODEDITOR | STUDIO | EDITORLESS
+  blocked: boolean;
+  folderId?: string;          // set for sites organized in folders / parent-child setups
+  namespace: string;          // WIX | HEADLESS
+  domainConnected: boolean;
+  parentChildRole: string;    // e.g. NONE
+}
+```
 
 ## Next Steps
 
-After finding a site:
-- Use the site `id` for site-level API calls
-- Create new sites using [Create Site from Template](create-site-from-template.md)
-- Manage site settings and content
+Use a site's `id` for site-level API calls — derive a site token from the account token
+(`wix token --site <id>`, or the `oauth2/token` refresh-grant in wix-auth `device-flow`), then read
+its context via [Read Site Context](read-site-context.md) or create sites with
+[Create Site from Template](create-site-from-template.md).

package/skills/wix-replatform/resources/rp-mapper/wix-business-solutions-taxonomy.md

@@ -25,8 +25,7 @@ This distinction must stay explicit in mapper output.
 It owns the purchase flow and operational commerce entities that are reused across multiple vertical apps.
 
 Typical `eCommerce` entities:
-- carts
-- checkouts
+- carts (the unified cart + checkout entity)
 - orders
 - order billing / refunds
 - payment and fulfillment state tied to orders
@@ -90,19 +89,19 @@ Main page:
 - [Integrating with Wix's Business Solutions](https://dev.wix.com/docs/build-apps/get-started/overview/integrating-with-wix-s-business-solutions)
 
 Short description:
-- Shared commerce platform for purchase flow and order operations. It is the canonical target for carts, checkouts, and orders, even when catalog data originates in a vertical app such as Stores or Bookings.
+- Shared commerce platform for purchase flow and order operations. It is the canonical target for carts (Cart V2, which now also covers checkout) and orders, even when catalog data originates in a vertical app such as Stores or Bookings.
 
 Primary entities:
 
 | Entity | What it does | Docs |
 | --- | --- | --- |
-| `cart` | First phase of the purchase flow; holds line items, buyer references, discounts, and pricing context before checkout | [About the eCommerce Cart API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart/cart/introduction) |
-| `current-cart` | Visitor/member scoped cart used in live purchase flows | [About the eCommerce Current Cart API](https://dev.wix.com/docs/sdk/backend-modules/ecom/current-cart/introduction) |
-| `checkout` | Second phase of purchase flow; holds calculated prices, tax, billing, shipping, and discount state before order creation | [About the eCommerce Checkout API](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction) |
+| `cart` | The unified purchase-flow entity — holds line items, buyer/contact info, discounts, delivery, billing, and payment context all the way through placing the order. | [About the Cart API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart-v2/introduction) |
+| `current-cart` | The current cart for a visitor/member session — the same entity as `cart`, addressed by the shopper's session rather than a cart id. | [About the Cart API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart-v2/introduction) |
 | `order` | Final commerce record for completed or externally recorded purchases | [About the Orders API](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/orders/introduction) |
 | `order-billing` | Payment capture, void, and refund operations for eCommerce orders | [About the Order Billing API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/introduction) |
 
 Mapper notes:
+- **A source system's separate "checkout" has no distinct Wix target.** The cart is the unified purchase-flow entity (there's no separate checkout), so map a source checkout's *input* state onto `cart`: billing → `paymentInfo.billingAddress`, shipping/delivery → `deliveryInfo`, applied coupons → cart `coupons`. **Calculated price *and* payment figures are NOT stored on the cart** — both the price totals (`summary.priceSummary`) and the payment breakdown (`summary.paymentSummary` — amount due, gift-card deductions, and the like) are computed on demand by Calculate/Estimate Cart (returned in a `CartSummary`), and the final figures live on the `order` after placement — so don't try to persist a source checkout's computed totals on the cart.
 - If the source platform exposes products and orders in one model, split catalog entities into the vertical app and transaction entities into `ecommerce`.
 - If the source has historical orders but no cart or checkout history, map directly to `order` and document missing pre-purchase state.
 

package/skills/wix-vibe-headless/platforms/base44-ecom-light-seed.md

@@ -6,24 +6,27 @@ initial prompt, and the Wix connector is already configured.
 Your Wix client id is in your prompt — a public, buyer-facing credential (anonymous visitor tokens
 only), safe in the frontend; use it directly for the Wix client setup.
 
-> **`wix-vibe-headless` and `wix-docs` are the complete build and seed path for this app.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).**
+> **The Wix skills installed below are the complete build and seed path for this app.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).**
 
 Follow STEPs 1–4 below exactly (run STEP 3 in parallel with STEP 2).
 
 ## STEP 1 — Install the Wix skills and deploy the storefront vertical to the app
 
-Install two skills — they land under `.agents/skills/`:
+Install three skills — they land under `.agents/skills/`:
 - **`wix-vibe-headless`** — the storefront build + seed guide (STEPs 2–3): your main source of truth.
-- **`wix-docs`** — a **fallback**: search + read the Wix API docs for anything `wix-vibe-headless`
-  doesn't cover.
+- **`wix-manage`** — REST recipes for managing and configuring the site (install apps, seed
+  catalogs, business setup).
+- **`wix-base44-connector`** — building on Wix from the Base44 sandbox: site context, API
+  contracts, and the docs **fallback** — find + read the Wix API docs for anything
+  `wix-vibe-headless` doesn't cover.
 
-Run this through exec_tool, exactly as written — installs both skills, deploys the `storefront` REST scaffolds + UI into `src/`, and pins the AGENTS.md note.
+Run this through exec_tool, exactly as written — installs all three skills, deploys the `storefront` REST scaffolds + UI into `src/`, and pins the AGENTS.md note.
 
 ```js
 const { execSync } = require('child_process');
 const { existsSync, readdirSync } = require('fs');
 const results = {};
-for (const skill of ['wix-vibe-headless', 'wix-docs']) {
+for (const skill of ['wix-vibe-headless', 'wix-manage', 'wix-base44-connector']) {
   if (existsSync(`/app/.agents/skills/${skill}/SKILL.md`)) { results[skill] = 'already_installed'; continue; }
   try {
     const out = execSync(`CI=1 npx -y skills add wix/skills/skills/${skill} --yes 2>&1`,
@@ -58,7 +61,7 @@ cleanup truly seems needed, ask the user first.
 Seed by calling the storefront's ready-made seed module — read
 `.agents/skills/wix-vibe-headless/references/storefront/seed/SEED.md` and load its `seed-*.js` via
 its loader snippet (build-time exec_tool); call its functions with your data. Gaps or an unexpected
-shape → the **`wix-docs`** skill.
+shape → the **`wix-base44-connector`** skill's doc discovery.
 
 **Auth for these admin calls is the already-configured Wix headless connector — nothing else.** Get its
 access token and send it as a bearer token:
@@ -73,7 +76,8 @@ Inline via exec_tool, `base44` is already declared — use it directly; do **not
 inline it throws *"Identifier 'base44' has already been declared."*).
 
 **Product images.** Generate with **Base44's built-in image generation**, then attach via the
-storefront seed module's image-attach step — `wix-docs` if the module doesn't cover it.
+storefront seed module's image-attach step — `wix-base44-connector` doc discovery if the module
+doesn't cover it.
 
 **Seed images with the FINAL url, in one call.** Use the real `https://media.base44.com/...` url
 from the **completed** `generate_image` result and pass it straight into your single `setupStore`
@@ -101,4 +105,4 @@ const res = await fetch("https://www.wixapis.com/<api-path>", {
 return await res.json();
 ```
 
-`base44` is already declared inline in exec_tool — use it directly; do **not** import `@base44/sdk` or call `createClient()`. For what to call, check the storefront seed module (`.agents/skills/wix-vibe-headless/references/storefront/seed/SEED.md`) or look up the endpoint via `wix-docs`.
+`base44` is already declared inline in exec_tool — use it directly; do **not** import `@base44/sdk` or call `createClient()`. For what to call, check the storefront seed module (`.agents/skills/wix-vibe-headless/references/storefront/seed/SEED.md`) or look up the endpoint via the `wix-base44-connector` skill's doc discovery.

package/skills/wix-vibe-headless/platforms/base44-ecom-light.md

@@ -6,24 +6,27 @@ initial prompt, and the Wix connector is already configured.
 Your Wix client id is in your prompt — a public, buyer-facing credential (anonymous visitor tokens
 only), safe in the frontend; use it directly for the Wix client setup.
 
-> **`wix-vibe-headless` and `wix-docs` are the complete build path for this app.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).** **This flow builds the client only — there is no seeding step.**
+> **The Wix skills installed below are the complete build path for this app.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).** **This flow builds the client only — there is no seeding step.**
 
 Follow STEPs 1–3 below exactly.
 
 ## STEP 1 — Install the Wix skills and deploy the storefront vertical to the app
 
-Install two skills — they land under `.agents/skills/`:
+Install three skills — they land under `.agents/skills/`:
 - **`wix-vibe-headless`** — the storefront build guide (STEP 2): your main source of truth.
-- **`wix-docs`** — a **fallback**: search + read the Wix API docs for anything `wix-vibe-headless`
-  doesn't cover.
+- **`wix-manage`** — REST recipes for managing and configuring the site (install apps, seed
+  catalogs, business setup).
+- **`wix-base44-connector`** — building on Wix from the Base44 sandbox: site context, API
+  contracts, and the docs **fallback** — find + read the Wix API docs for anything
+  `wix-vibe-headless` doesn't cover.
 
-Run this through exec_tool, exactly as written — installs both skills, deploys the `storefront` REST scaffolds + UI into `src/`, and pins the AGENTS.md note.
+Run this through exec_tool, exactly as written — installs all three skills, deploys the `storefront` REST scaffolds + UI into `src/`, and pins the AGENTS.md note.
 
 ```js
 const { execSync } = require('child_process');
 const { existsSync, readdirSync } = require('fs');
 const results = {};
-for (const skill of ['wix-vibe-headless', 'wix-docs']) {
+for (const skill of ['wix-vibe-headless', 'wix-manage', 'wix-base44-connector']) {
   if (existsSync(`/app/.agents/skills/${skill}/SKILL.md`)) { results[skill] = 'already_installed'; continue; }
   try {
     const out = execSync(`CI=1 npx -y skills add wix/skills/skills/${skill} --yes 2>&1`,
@@ -71,4 +74,4 @@ const res = await fetch("https://www.wixapis.com/<api-path>", {
 return await res.json();
 ```
 
-`base44` is already declared inline in exec_tool — use it directly; do **not** import `@base44/sdk` or call `createClient()`. For what to call, check the storefront seed module (`.agents/skills/wix-vibe-headless/references/storefront/seed/SEED.md`) or look up the endpoint via `wix-docs`.
+`base44` is already declared inline in exec_tool — use it directly; do **not** import `@base44/sdk` or call `createClient()`. For what to call, check the storefront seed module (`.agents/skills/wix-vibe-headless/references/storefront/seed/SEED.md`) or look up the endpoint via the `wix-base44-connector` skill's doc discovery.

package/skills/wix-vibe-headless/platforms/base44.md

@@ -6,19 +6,22 @@ initial prompt, and the Wix connector is already configured; use it for all admi
 Your Wix client id is in your prompt — a public, buyer-facing credential (anonymous visitor tokens
 only), safe in the frontend; use it directly for the Wix client setup.
 
-> **`wix-vibe-headless` and `wix-docs` are the complete build and seed path for this app — the Wix connector supplies the token for admin API calls.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).**
+> **The Wix skills installed below are the complete build and seed path for this app — the Wix connector supplies the token for admin API calls.** **Do NOT use the Base44 commerce kit (or any Base44 solution kit).**
 
 Follow STEPs 1–5 below exactly (run STEP 4 in parallel with STEP 3).
 
 ## STEP 1 — Install the Wix skills locally
 
-Install two skills — they land under `.agents/skills/`:
+Install three skills — they land under `.agents/skills/`:
 - **`wix-vibe-headless`** — the client build **and** seed guide (STEPs 3–4): your main source of
   truth. Seeding lives here too, per-vertical under `references/<vertical>/seed/`.
-- **`wix-docs`** — a **fallback**: search + read the Wix API docs for anything `wix-vibe-headless`
-  doesn't cover.
+- **`wix-manage`** — REST recipes for managing and configuring the site (install apps, seed
+  catalogs, business setup).
+- **`wix-base44-connector`** — building on Wix from the Base44 sandbox: site context, API
+  contracts, and the docs **fallback** — find + read the Wix API docs for anything
+  `wix-vibe-headless` doesn't cover.
 
-Run this through exec_tool, exactly as written — installs both skills, deploys REST scaffolds + UI into `src/`, writes `wix-config.js`, and pins the AGENTS.md note.
+Run this through exec_tool, exactly as written — installs all three skills, deploys REST scaffolds + UI into `src/`, writes `wix-config.js`, and pins the AGENTS.md note.
 
 **Set `VERTICALS`** to what the prompt asks for (too vague to tell? do STEP 2 first, then set it):
 
@@ -46,7 +49,7 @@ const VERTICALS = ['storefront'];        // ← set from the prompt; list every
 const WIX_CLIENT_ID = '<client id from the prompt>';
 const WIX_METASITE_ID = '<site id from the prompt>';
 const results = {};
-for (const skill of ['wix-vibe-headless', 'wix-docs']) {
+for (const skill of ['wix-vibe-headless', 'wix-manage', 'wix-base44-connector']) {
   if (existsSync(`/app/.agents/skills/${skill}/SKILL.md`)) { results[skill] = 'already_installed'; continue; }
   try {
     const out = execSync(`CI=1 npx -y skills add wix/skills/skills/${skill} --yes 2>&1`,
@@ -103,7 +106,7 @@ cleanup truly seems needed, ask the user first.
 Seed by calling your vertical's ready-made seed module — read
 `.agents/skills/wix-vibe-headless/references/<vertical>/seed/SEED.md` and load its `seed-*.js` via
 its loader snippet (build-time exec_tool); call its functions with your data. Gaps or an unexpected
-shape → the **`wix-docs`** skill.
+shape → the **`wix-base44-connector`** skill's doc discovery.
 
 **Auth for these admin calls is the already-configured Wix connector — nothing else.** Get its
 access token and send it as a bearer token:
@@ -119,8 +122,8 @@ inline it throws *"Identifier 'base44' has already been declared."*).
 
 **Entity images.** For image-bearing entities (store products, blog covers, bookings services,
 restaurant items, portfolio projects, event heroes, CMS items), generate with **Base44's built-in
-image generation**, then attach via the vertical seed module's image-attach step — `wix-docs` if the
-module doesn't cover that entity.
+image generation**, then attach via the vertical seed module's image-attach step —
+`wix-base44-connector` doc discovery if the module doesn't cover that entity.
 
 **Seed images with the FINAL url, in one call.** Seeding writes to Wix, so use the real
 `https://media.base44.com/...` url from the **completed** `generate_image` result and pass it straight
@@ -147,6 +150,6 @@ Once the site is built and seeded:
 ## Later admin requests
 
 For any later admin/management request, work as in STEP 4: your vertical's seed module first, else
-`wix-docs` — all over the connector.
+`wix-base44-connector` doc discovery — all over the connector.
 
 version: v1338

package/skills/wix-vibe-headless/references/bookings/INSTRUCTIONS.md

@@ -165,6 +165,8 @@ stale render.
 ## Using the client from your own UI
 The two shipped hooks are the whole flow. If you build a custom surface, drive it the same way:
 
+> Migrating from Cart V1 / Checkout V1? These helpers are V2-only — see the [migration guide](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/migration-guide) for the before/after.
+
 ```jsx
 // LIST — every list helper returns an OBJECT, not a bare array. Destructure it:
 const { services, total, nextOffset } = await queryServices({ limit: 24 });   // total 0 → empty state

package/skills/wix-vibe-headless/references/bookings/app/rest/wix-bookings-checkout.js

@@ -3,7 +3,7 @@ import { wixApiRequest } from "./wix-client.js";
 // Data model reference: see INSTRUCTIONS.md
 // Service and TimeSlot shapes: see wix-bookings-services.js
 
-// Wix Bookings app id — required inside catalogReference for the eCommerce checkout.
+// Wix Bookings app id — required inside catalogReference when adding the booking to the eCom cart.
 const BOOKINGS_APP_ID = "13d21c63-b5ec-5912-8397-c3a5ddb27a97";
 
 /**
@@ -101,27 +101,28 @@ export async function createBooking(slot, contactDetails, { totalParticipants =
 }
 
 /**
- * Create an eCommerce checkout for a created booking and return the hosted checkout URL.
+ * Add a created booking to the current eCom cart and return the hosted checkout URL.
+ * In Cart V2 the cart id IS the checkout id — add the booking line to the current cart, then create
+ * the redirect session straight from that cart's id (there is no separate checkout-creation call).
  * Redirect the buyer there (window.location.href = ...). On return, the booking is confirmed.
  * Throws if no redirect URL is produced.
- * https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout.md
+ * https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/add-line-items-to-current-cart.md
  * @param {string} bookingId  booking.id from createBooking().
  * @returns {Promise<string>} The hosted-checkout URL to redirect to.
  */
 export async function checkoutBooking(bookingId) {
   if (!bookingId) throw new Error("checkoutBooking requires a bookingId.");
 
-  const checkoutRes = await wixApiRequest("/ecom/v1/checkouts", {
+  const cartRes = await wixApiRequest("/ecom/v2/carts/current/add-line-items", {
     method: "POST",
     body: {
-      channelType: "WEB",
-      lineItems: [
+      catalogItems: [
         { quantity: 1, catalogReference: { appId: BOOKINGS_APP_ID, catalogItemId: bookingId } },
       ],
     },
   });
-  const checkoutId = checkoutRes?.checkout?.id;
-  if (!checkoutId) throw new Error("Failed to create a checkout for the booking.");
+  const checkoutId = cartRes?.cart?.id;
+  if (!checkoutId) throw new Error("Failed to add the booking to the cart for checkout.");
 
   const redirect = await wixApiRequest("/headless/v1/redirect-session", {
     method: "POST",

package/skills/wix-vibe-headless/references/restaurants/INSTRUCTIONS.md

@@ -170,6 +170,8 @@ render.
 
 ## Using the client from your own UI (menu, order cart)
 
+> Migrating from Cart V1 / Checkout V1? These helpers are V2-only — see the [migration guide](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/migration-guide) for the before/after.
+
 ```jsx
 import { getFullMenu } from "@/rest/wix-restaurants-menu";
 import { useOrderCart } from "@/context/OrderCartContext";
@@ -188,7 +190,8 @@ const { menus } = await getFullMenu();            // [] when no menus → show t
 // Load-bearing field paths (the shipped components already do these):
 // - item.image / section.image / label.icon are OBJECTS → render `.url`, never the object; //-urls → https:
 // - MENU prices are plain decimal strings with NO currency symbol ("12.50") — format in the UI.
-//   The eCom cart line price (line.price.formattedAmount) DOES include the symbol.
+//   The eCom cart line price (line.pricing.unitPrice / line.pricing.totalPrice) is a ConvertedMoney
+//   { amount, convertedAmount } with NO symbol either — format the number yourself.
 // - an item is priced by EITHER item.price (single) OR item.variants[] (one-of, each { name, price }).
 // - a cart mutation uses cart.lineItems[].id (the lineItemId), NOT the menu item id.
 ```

package/skills/wix-vibe-headless/references/restaurants/app/components/OrderCartDrawer.jsx

@@ -1,9 +1,18 @@
 // Slide-over order cart. Reads everything from useOrderCart(); mutate by lineItem.id (NOT the menu
-// item id), check out via the context (redirect-session URL). The eCom cart price
-// (line.price.formattedAmount) DOES include the currency symbol, unlike menu prices. Styled with
-// base44 design tokens (shadcn Tailwind classes). Mount it once in the Layout.
+// item id), check out via the context (redirect-session URL). The eCom Cart V2 line price is
+// `pricing.totalPrice`, a ConvertedMoney { amount, convertedAmount } with NO formatted string —
+// format it with the cart's currency (formatCartMoney below). Styled with base44 design tokens
+// (shadcn Tailwind classes). Mount it once in the Layout.
 import { useOrderCart } from "@/context/OrderCartContext";
 
+// Cart V2 money is a ConvertedMoney { amount, convertedAmount } with NO formatted string — format it
+// with the cart's currency (buyer's display currency when present, else the site currency).
+function formatCartMoney(money, cart) {
+  const value = money?.convertedAmount ?? money?.amount;
+  const currency = cart?.customerInfo?.currencyCode ?? cart?.businessInfo?.currencyCode ?? "USD";
+  return value == null ? "" : new Intl.NumberFormat(undefined, { style: "currency", currency }).format(Number(value));
+}
+
 export default function OrderCartDrawer() {
   const { cart, isOpen, setIsOpen, removeItem, updateQuantity, checkout, loading } = useOrderCart();
   const lineItems = cart?.lineItems ?? [];
@@ -22,23 +31,26 @@ export default function OrderCartDrawer() {
         <div className="flex-1 overflow-y-auto p-4">
           {lineItems.length === 0 ? (
             <p className="text-muted-foreground">Your order is empty.</p>
-          ) : lineItems.map((line) => (
+          ) : lineItems.map((line) => {
+            const qty = line.quantityInfo?.confirmedQuantity;
+            return (
             <div key={line.id} className="flex gap-3 py-3 border-b border-border">
               {/* line.id is the lineItemId for mutations — NOT the menu item id */}
               <div className="flex-1 flex flex-col gap-1">
-                <span className="font-semibold">{line.productName?.original}</span>
+                <span className="font-semibold">{line.name?.original}</span>
                 <div className="flex items-center gap-2 mt-1">
-                  <QtyButton onClick={() => updateQuantity(line.id, Math.max(1, line.quantity - 1))}>−</QtyButton>
-                  <span className="min-w-[20px] text-center">{line.quantity}</span>
-                  <QtyButton onClick={() => updateQuantity(line.id, line.quantity + 1)}>+</QtyButton>
+                  <QtyButton onClick={() => updateQuantity(line.id, Math.max(1, qty - 1))}>−</QtyButton>
+                  <span className="min-w-[20px] text-center">{qty}</span>
+                  <QtyButton onClick={() => updateQuantity(line.id, qty + 1)}>+</QtyButton>
                   <button onClick={() => removeItem(line.id)}
                     className="ml-auto border-none bg-transparent cursor-pointer text-muted-foreground text-[13px] underline">Remove</button>
                 </div>
               </div>
-              {/* eCom cart price DOES include the currency symbol (unlike menu prices) */}
-              <span className="font-semibold">{line.price?.formattedAmount}</span>
+              {/* Cart V2 has no formatted string — format the ConvertedMoney client-side */}
+              <span className="font-semibold">{formatCartMoney(line.pricing?.totalPrice, cart)}</span>
             </div>
-          ))}
+            );
+          })}
         </div>
 
         {lineItems.length > 0 && (

package/skills/wix-vibe-headless/references/restaurants/app/context/OrderCartContext.jsx

@@ -30,7 +30,7 @@ export function OrderCartProvider({ children }) {
     return () => document.removeEventListener("visibilitychange", onVisible);
   }, [refreshCart]);
 
-  const itemCount = (cart?.lineItems ?? []).reduce((n, li) => n + (li.quantity || 0), 0);
+  const itemCount = (cart?.lineItems ?? []).reduce((n, li) => n + (li.quantityInfo?.confirmedQuantity || 0), 0);
 
   // A menu item carries its menuId/sectionId from the getFullMenu tree — the caller passes both.
   // addItemToCart throws on a missing operation/menu/section or an unavailable line; let it propagate.