@wix/agent-skills 1.31.0 → 1.31.2

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

@@ -27,6 +27,7 @@
 // Seeding is ADDITIVE — never deletes or overwrites existing forms.
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 import { readFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 
@@ -556,7 +557,7 @@ export async function setupForms(ctx, plan) {
 
 // ---- CLI entry -------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/members/rest/auth.ts

@@ -8,8 +8,8 @@
 // client id; nothing elevated. Porting: keep the paths and bodies; the exchange is three calls.
 // docs: https://dev.wix.com/docs/go-headless/authentication/members/custom-login-page/build-a-custom-login-page-rest.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { WIX_CLIENT_ID } from "./config.js";
-import { WixApiError, clearTokens, loadTokens, mintTokens, setTokens, wixRequest, type Tokens } from "./client.js";
+import { WIX_CLIENT_ID } from "../../shared/rest/config.js";
+import { WixApiError, clearTokens, loadTokens, mintTokens, setTokens, wixRequest, type Tokens } from "../../shared/rest/client.js";
 import {
   NO_SESSION_ERROR,
   authOutcome,
@@ -20,7 +20,7 @@ import {
   type LoginResult,
   type LoginState,
   type RawAuth,
-} from "./auth-core.js";
+} from "../app/wix/members/auth-core.js";
 
 export type { LoginResult, LoginState };
 

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

@@ -4,10 +4,10 @@
 // whatever token ./client.js holds — a member's after a rest/auth.ts login → the profile; a
 // visitor's → 403 → null. Porting: keep the path and the fieldsets, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/get-my-member.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { MEMBER_FIELDSETS, memberId, toCurrentMember, type Raw } from "./members-core.js";
-import type { CurrentMember } from "./types.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { MEMBER_FIELDSETS, memberId, toCurrentMember, type Raw } from "../app/wix/members/members-core.js";
+import type { CurrentMember } from "../app/wix/members/types.js";
 
 /**
  * The current member, or null: for a visitor (the call is refused — "Missing site member id"), for

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

@@ -15,6 +15,7 @@
 // Members Area app's App Market id; the identity/profile split is described beside it.
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 import { readFileSync } from "node:fs";
 
 const API = "https://www.wixapis.com";
@@ -77,7 +78,7 @@ export async function setupMembers(ctx, { installMembersArea = true } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   const plan = planPath ? JSON.parse(readFileSync(planPath, "utf8")) : {};

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

@@ -8,8 +8,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/list-projects.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/projects/query-projects.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/portfolio/project-items/list-project-items.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   galleryItems,
   visibleCollection,
@@ -18,8 +18,8 @@ import {
   visibleProjects,
   type Raw,
   type VideoSrc,
-} from "./portfolio-core.js";
-import type { CollectionSummary, GalleryItem, ProjectDetail, ProjectSummary } from "./types.js";
+} from "../app/wix/portfolio/portfolio-core.js";
+import type { CollectionSummary, GalleryItem, ProjectDetail, ProjectSummary } from "../app/wix/portfolio/types.js";
 
 // REST never returns the bare wix:video:// string — videoInfo arrives as { resolutions, posters },
 // which the core reads directly. A string here has no resolver on this transport → dropped.

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

@@ -53,8 +53,10 @@ rows (Role, Year, Client…).
 - Every image field's default is a prompt (`coverImagePrompt` / `items[].imagePrompt` —
   AI-generated, ~1 Wix AI credit per image, account-billed): brand-contextual — subject,
   aesthetic/mood, palette, lighting — always ending "no text, no watermarks". At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually supplied
-  use a path (`coverImagePath` / `items[].imagePath` — a file on this machine, uploaded to
-  Wix Media) or a url (`coverImageUrl` / `items[].imageUrl` — their own hosted URL; verify it
+  use a Media Manager file (`coverImageMediaId` / `items[].imageMediaId` — a file already in the
+  site's Media Manager, such as one the user uploaded there: used as it is, no copy; a
+  `static.wixstatic.com/media/<file id>` URL of a site file counts as one), a path
+  (`coverImagePath` / `items[].imagePath` — a file on this machine, uploaded to Wix Media) or a url (`coverImageUrl` / `items[].imageUrl` — their own hosted URL; verify it
   with `curl -sI` → 200) — never a stock-photo or guessed URL. All images —
   covers and gallery items alike — resolve in one parallel wave and never block the seed; a
   failed image skips just that item/cover. The **cover** is the

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

@@ -9,12 +9,12 @@
 // project's gallery items, and imports+attaches cover images. Prints a JSON result to stdout.
 //
 // Plan shape (see SEED.md):
-//   { "collections": [{ "title", "description"?, "hidden"?, "coverImageUrl"? | "coverImagePrompt"? }],
+//   { "collections": [{ "title", "description"?, "hidden"?, "coverImageMediaId"? | "coverImageUrl"? | "coverImagePrompt"? }],
 //     "projects":    [{ "title", "description"?, "hidden"?,
 //                       "collection"? (title),        // resolved to that collection's id
 //                       "details"?: [{ "label", "text" }],
-//                       "coverImageUrl"? | "coverImagePrompt"?,
-//                       "items"?: [{ "sortOrder", "title"?, "imageUrl" | "imagePrompt" }] }] }
+//                       "coverImageMediaId"? | "coverImageUrl"? | "coverImagePrompt"?,
+//                       "items"?: [{ "sortOrder", "title"?, "imageMediaId" | "imageUrl" | "imagePrompt" }] }] }
 //
 // Seeding is ADDITIVE — never deletes or overwrites existing content. A fresh Portfolio
 // install ships its own sample content ("My Portfolio" + sample projects); removing it is the
@@ -24,6 +24,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const PORTFOLIO_APP_ID = "d90652a2-f5a1-4c7c-84c4-d4cdcc41f130";
@@ -186,13 +187,13 @@ export async function setupPortfolio(ctx, { collections = [], projects = [] } =
   projects.forEach((p, pi) => {
     for (const it of p.items ?? []) {
       galleryRefs.push({ pi, it, spec: specs.length });
-      specs.push({ path: it.imagePath, url: it.imageUrl, prompt: it.imagePrompt, displayName: `${it.title || "item"}.png` });
+      specs.push({ mediaId: it.imageMediaId, path: it.imagePath, url: it.imageUrl, prompt: it.imagePrompt, displayName: `${it.title || "item"}.png` });
     }
   });
   const projCoverAt = specs.length;
-  projects.forEach((p) => specs.push({ path: p.coverImagePath, url: p.coverImageUrl, prompt: p.coverImagePrompt, displayName: `${p.title || "project"}-cover.png` }));
+  projects.forEach((p) => specs.push({ mediaId: p.coverImageMediaId, path: p.coverImagePath, url: p.coverImageUrl, prompt: p.coverImagePrompt, displayName: `${p.title || "project"}-cover.png` }));
   const colCoverAt = specs.length;
-  collections.forEach((c) => specs.push({ path: c.coverImagePath, url: c.coverImageUrl, prompt: c.coverImagePrompt, displayName: `${c.title || "collection"}-cover.png` }));
+  collections.forEach((c) => specs.push({ mediaId: c.coverImageMediaId, path: c.coverImagePath, url: c.coverImageUrl, prompt: c.coverImagePrompt, displayName: `${c.title || "collection"}-cover.png` }));
   const files = await resolveItemImages(ctx, specs);
   const dims = { height: 1024, width: 1024 };
 
@@ -235,7 +236,7 @@ export async function setupPortfolio(ctx, { collections = [], projects = [] } =
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

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

@@ -5,9 +5,9 @@
 // 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
-import { wixRequest } from "./client.js";
-import { hasPlanAccess, memberOrdersQuery, type MemberOrdersQuery } from "./plan-access-core.js";
-import type { Raw } from "./plans-core.js";
+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";
 
 export type { MemberOrdersQuery };
 

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

@@ -5,10 +5,10 @@
 // A plan without a numeric price is malformed and never returned (plans-core `planAmount`).
 // Porting: keep the path, keep the body, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/plans-v3/query-plans.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
-import { plansQuery, toDetail, toSummaries, type FormatOptions, type Raw } from "./plans-core.js";
-import type { PlanDetail, PlanSummary } from "./types.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
+import { plansQuery, toDetail, toSummaries, type FormatOptions, type Raw } from "../app/wix/pricing-plans/plans-core.js";
+import type { PlanDetail, PlanSummary } from "../app/wix/pricing-plans/types.js";
 
 export type { FormatOptions };
 

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

@@ -4,9 +4,9 @@
 // order form, and payment itself, so a visitor token starts it. Never create the order yourself,
 // never hand-build a checkout URL.
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { wixRequest } from "./client.js";
-import { purchaseBody, redirectUrl, type PurchaseOptions } from "./purchase-core.js";
-import type { Raw } from "./plans-core.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { purchaseBody, redirectUrl, type PurchaseOptions } from "../app/wix/pricing-plans/purchase-core.js";
+import type { Raw } from "../app/wix/pricing-plans/plans-core.js";
 
 export type { PurchaseOptions };
 

package/skills/wix-headless-templates/pricing-plans/seed/seed-pricing-plans.mjs

@@ -23,6 +23,7 @@
 import { setSiteCurrency } from "../../shared/seed/site.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 import { readFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 
@@ -283,7 +284,7 @@ export async function setupPricingPlans(ctx, { plans = [], currency } = {}) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

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

@@ -10,8 +10,8 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/create-booking.md
 // 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
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   FALLBACK_FIELDS,
   RENTALS_APP_ID,
@@ -42,8 +42,8 @@ import {
   toSummary,
   type Raw,
   type StartWindow,
-} from "./rentals-core.js";
-import type { EndOption, RentalDetail, RentalFormField, RentalQuote, RentalResult, RentalSummary, StartOption } from "./types.js";
+} from "../app/wix/rentals/rentals-core.js";
+import type { EndOption, RentalDetail, RentalFormField, RentalQuote, RentalResult, RentalSummary, StartOption } from "../app/wix/rentals/types.js";
 
 export { RENTALS_APP_ID, RENTALS_FORM_ID, RENTALS_PAGE_SIZE, dailyEndOptions, defaultTimeZone };
 

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

@@ -19,7 +19,7 @@ exercise the UI: one hourly and one daily rental when the business allows it, a
 approval-gated one where it fits, and an image per rental — the default is an `imagePrompt`
 (AI-generated, ~1 Wix AI credit per image, account-billed): brand-contextual — subject,
 aesthetic/mood, palette, lighting — always ending "no text, no watermarks". At least one image shows
-the real thing being rented. For an asset the user actually supplied use `imagePath` (a file on this
+the real thing being rented. For an asset the user actually supplied use `imageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `imagePath` (a file on this
 machine — uploaded to Wix Media) or `imageUrl` (their own hosted URL; verify it with `curl -sI` →
 200) — never a stock-photo or guessed URL. Images resolve in parallel and never block the seed.
 

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

@@ -17,7 +17,7 @@
 //     "resourceTypes": [{ "name": "Kayaks", "resources": ["Kayak 1", "Kayak 2"] }],
 //     "rentals": [{ "name", "description", "tagLine"?, "unit": "HOUR"|"DAY", "rate": 25, "min"?, "max"?,
 //                   "resourceType": "Kayaks", "resources"?: ["Kayak 1"], "free"?, "requireManualApproval"?,
-//                   "imageUrl"? | "imagePath"? | "imagePrompt"? }] }
+//                   "imageMediaId"? | "imageUrl"? | "imagePath"? | "imagePrompt"? }] }
 //
 // Seeding is ADDITIVE — never deletes or overwrites existing content. Unexpected shapes →
 // read the live API reference; every call below carries a docs: line with its reference page.
@@ -26,6 +26,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 /** The Wix Rentals app: the service's immutable appId, the catalog filter, the cart's appId. */
@@ -268,6 +269,7 @@ export async function setupRentals(ctx, { resourceTypes = [], rentals = [], curr
   // Pass 2 — images: resolve (import by url / generate by prompt) in one parallel wave, then attach.
   // Failures leave the rental text-only; the seed's exit never depends on images.
   const files = await resolveItemImages(ctx, created.map((c, i) => ({
+    mediaId: rentals[i]?.imageMediaId,
     url: rentals[i]?.imageUrl,
     path: rentals[i]?.imagePath,
     prompt: rentals[i]?.imagePrompt,
@@ -300,7 +302,7 @@ export async function setupRentals(ctx, { resourceTypes = [], rentals = [], curr
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

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

@@ -7,8 +7,8 @@
 // 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 "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import {
   anyLabels,
   assembleMenus,
@@ -19,8 +19,8 @@ import {
   nextCursor,
   toSiteMoney,
   type Raw,
-} from "./menu-core.js";
-import type { MenuData, SiteMoney } from "./types.js";
+} from "../app/wix/restaurants/menu-core.js";
+import type { MenuData, SiteMoney } from "../app/wix/restaurants/types.js";
 
 const get = (path: string, query?: Record<string, string | readonly string[]>) => wixRequest<Raw>(path, { method: "GET", query });
 

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

@@ -12,10 +12,10 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/fulfillment-methods/list-fulfillment-methods.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/add-line-items-to-current-cart.md
 // docs: https://dev.wix.com/docs/api-reference/business-management/headless/redirects/create-redirect-session.md
-import { WixApiError, wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { WixApiError, wixRequest } from "../../shared/rest/client.js";
+import { imgSrc } from "../../shared/rest/media.js";
 import { fetchSiteMoney } from "./menu.js";
-import { initialSelection, nextCursor, validateSelection, type Raw } from "./menu-core.js";
+import { initialSelection, nextCursor, validateSelection, type Raw } from "../app/wix/restaurants/menu-core.js";
 import {
   RESTAURANTS_ORDERS_APP_ID,
   assertOrderAdded,
@@ -29,8 +29,8 @@ import {
   toFulfillmentMethods,
   toMenuOrderingMap,
   toOrderCart,
-} from "./ordering-core.js";
-import type { FulfillmentMethodInfo, MenuItem, MenuOrderingInfo, OrderCart, OrderSelection, OrderingStatus } from "./types.js";
+} from "../app/wix/restaurants/ordering-core.js";
+import type { FulfillmentMethodInfo, MenuItem, MenuOrderingInfo, OrderCart, OrderSelection, OrderingStatus } from "../app/wix/restaurants/types.js";
 
 export { RESTAURANTS_ORDERS_APP_ID };
 

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

@@ -9,9 +9,9 @@
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/create-held-reservation.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/reserve-reservation.md
 // docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/reservations/reservations/create-reservation.md
-import { wixRequest } from "./client.js";
-import { availableSlots, reservationBody, reserveeBody, toConfirmation, toHold, toLocations } from "./reservations-core.js";
-import type { Raw } from "./menu-core.js";
+import { wixRequest } from "../../shared/rest/client.js";
+import { availableSlots, reservationBody, reserveeBody, toConfirmation, toHold, toLocations } from "../app/wix/restaurants/reservations-core.js";
+import type { Raw } from "../app/wix/restaurants/menu-core.js";
 import type {
   ReservationConfirmation,
   ReservationFormConfig,
@@ -19,7 +19,7 @@ import type {
   ReservationLocationInfo,
   ReservationReservee,
   ReservationSlot,
-} from "./types.js";
+} from "../app/wix/restaurants/types.js";
 
 const RESERVATIONS = "/table-reservations/reservations/v1";
 

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

@@ -16,7 +16,7 @@ of 2–3 items each** (the seed shows the shape; the owner adds the rest in the
 every item with an image (a menu without photos looks broken) — the default is an
 `imagePrompt` (AI-generated, ~1 Wix AI credit per image, account-billed): brand-contextual —
 subject, aesthetic/mood, palette, lighting — always ending "no text, no watermarks". At least one image in the set shows the real subject of the business — the actual product/space/service, not abstract decoration. For an asset the user actually
-supplied use `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl`
+supplied use `imageMediaId` (a file already in the site's Media Manager, such as one the user uploaded there: used as it is, no copy; a `static.wixstatic.com/media/<file id>` URL of a site file counts as one), `imagePath` (a file on this machine — uploaded to Wix Media) or `imageUrl`
 (their own hosted URL; verify it with `curl -sI` → 200) — never a stock-photo or guessed URL. Images resolve in parallel and never
 block the seed, a failed image leaves that item text-only — and both add-ons on for a
 restaurant that takes orders and reservations. Give at least one dish a choice (a `variants`

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

@@ -14,7 +14,7 @@
 //                 "items": [{ "name", "description"?, "price"? | "variants"?: [{ "name", "price" }],
 //                             "modifierGroups"?: [{ "name", "required"?, "min"?, "max"?,
 //                               "modifiers": [{ "name", "price"?, "preSelected"?, "inStock"? }] }],
-//                             "acceptSpecialRequests"?, "imageUrl"? | "imagePath"? | "imagePrompt"? }] }] }],
+//                             "acceptSpecialRequests"?, "imageMediaId"? | "imageUrl"? | "imagePath"? | "imagePrompt"? }] }] }],
 //     "ordering"?: true | { "address"? },        // menu-first add-on; address is STEP 0
 //     "reservations"?: true | { "partySize"? { "min","max" }, "address"? } }
 //
@@ -28,6 +28,7 @@ import { readFileSync } from "node:fs";
 import { resolveItemImages } from "../../shared/seed/images.mjs";
 import { seedSiteId } from "../../shared/seed/site-context.mjs";
 import { wixToken } from "../../shared/seed/wix-cli.mjs";
+import { isMain } from "../../shared/seed/main.mjs";
 
 const API = "https://www.wixapis.com";
 const MENUS_APP_ID = "b278a256-2757-4f19-9313-c05c783bec92";
@@ -459,12 +460,13 @@ export async function setupRestaurants(ctx, plan) {
     const flat = m.sections.flatMap((s) => s.items || []);
     flat.forEach((it, i) => {
       const created = createdMenus[mi]?.items?.[i];
-      if ((it.imageUrl || it.imagePath || it.imagePrompt) && created?.id) {
-        imageItems.push({ ...created, imageUrl: it.imageUrl, imagePath: it.imagePath, imagePrompt: it.imagePrompt, name: it.name });
+      if ((it.imageMediaId || it.imageUrl || it.imagePath || it.imagePrompt) && created?.id) {
+        imageItems.push({ ...created, imageMediaId: it.imageMediaId, imageUrl: it.imageUrl, imagePath: it.imagePath, imagePrompt: it.imagePrompt, name: it.name });
       }
     });
   });
   const files = await resolveItemImages(ctx, imageItems.map((it) => ({
+    mediaId: it.imageMediaId,
     url: it.imageUrl,
     path: it.imagePath,
     prompt: it.imagePrompt,
@@ -559,7 +561,7 @@ export async function setupRestaurants(ctx, plan) {
 
 // ---- CLI entry ----------------------------------------------------------------------------------
 
-const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv[1].split("/").pop());
+const invokedDirectly = isMain(import.meta.url);
 if (invokedDirectly) {
   const planPath = process.argv[2];
   if (!planPath) {

package/skills/wix-headless-templates/shared/capabilities/site-search/rest/search.ts

@@ -4,8 +4,8 @@
 // a literal body per function. Every call here answers a visitor token (observed live). Porting:
 // keep the paths, keep the bodies, port the core once.
 // docs: https://dev.wix.com/docs/api-reference/business-management/site-search/wix-site-search/search.md
-import { wixRequest } from "./client.js";
-import { imgSrc } from "./media.js";
+import { wixRequest } from "../../../rest/client.js";
+import { imgSrc } from "../../../rest/media.js";
 import { siteSearchPlan } from "./site-search-config.generated.js";
 import {
   GROUP_LIMIT,
@@ -23,8 +23,8 @@ import {
   toSearchAll,
   toSuggestGroups,
   type Raw,
-} from "./search-core.js";
-import type { SearchAllResult, SearchOptions, SearchPage, SiteSearchConfig, SuggestGroup } from "./types.js";
+} from "../app/wix/site-search/search-core.js";
+import type { SearchAllResult, SearchOptions, SearchPage, SiteSearchConfig, SuggestGroup } from "../app/wix/site-search/types.js";
 
 /** The plan's siteSearch entry resolved — types in order, routes, labels. */
 export const config: SiteSearchConfig = resolveConfig(siteSearchPlan);

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

@@ -11,10 +11,10 @@
 // (searchAll("<a seeded title word>")) and expect a non-empty group before wiring the UI. Zero
 // documents after a minute means the app is not installed or the content is not visible to the
 // index (hidden products, drafts), not that the query is wrong.
-import { execFileSync } from "node:child_process";
 import { seedSiteId } from "../../../seed/site-context.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { installSiteSearch } from "../../../seed/site.mjs";
+import { wixToken } from "../../../seed/wix-cli.mjs";
 
 function flag(name) {
   const i = process.argv.indexOf(`--${name}`);
@@ -29,9 +29,11 @@ if (!siteId) {
   console.log(JSON.stringify({ error: "no site: pass --site <siteId> or run in a folder with wix.config.json" }));
   process.exit(1);
 }
-const token = execFileSync("npx", ["-y", "@wix/cli@1.1.258", "token", "--site", siteId], { encoding: "utf8" }).trim();
-if (!token) {
-  console.log(JSON.stringify({ error: "the Wix CLI returned no token — run `npx @wix/cli@1.1.258 login` first" }));
+let token;
+try {
+  token = wixToken(siteId);
+} catch (e) {
+  console.log(JSON.stringify({ error: String(e.message).slice(0, 400) }));
   process.exit(1);
 }
 try {

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

@@ -124,6 +124,37 @@ async function findExisting(ctx, displayName) {
   }
 }
 
+/**
+ * The Media Manager file a spec names, when it names one: `mediaId`, or the file id at the end of a
+ * `static.wixstatic.com/media/<fileId>` URL. Returns { id, url, existing: true } for a file on this
+ * site, waiting out a short PENDING (an upload still processing), or null when the URL's file is
+ * not on this site (it is then imported like any external URL). An explicit `mediaId` that is not
+ * on the site throws, so the product is reported text-only with the reason.
+ */
+// docs: https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/get-file-descriptor.md
+const WIX_MEDIA_URL = /^https?:\/\/static\.wixstatic\.com\/media\/([^/?#]+)/;
+async function existingMediaFile(ctx, s) {
+  const id = s.mediaId ?? s.url?.match(WIX_MEDIA_URL)?.[1];
+  if (!id) return null;
+  for (let attempt = 0; attempt < 10; attempt++) {
+    const res = await fetch(`${API}/site-media/v1/files/get-file-by-id?fileId=${encodeURIComponent(id)}`, {
+      headers: { Authorization: `Bearer ${ctx.token}`, "wix-site-id": ctx.siteId },
+      signal: AbortSignal.timeout(20_000),
+    });
+    if (res.status === 404) {
+      if (s.mediaId) throw new Error(`no Media Manager file ${id} on this site`);
+      return null;
+    }
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) throw new Error(`GET get-file-by-id -> ${res.status}: ${JSON.stringify(json).slice(0, 200)}`);
+    const f = json.file;
+    if (f?.operationStatus === "FAILED") throw new Error(`Media Manager file ${id} failed processing`);
+    if (f?.url && f.operationStatus !== "PENDING") return { id: f.id, url: f.url, existing: true };
+    await new Promise((r) => setTimeout(r, 3000));
+  }
+  throw new Error(`Media Manager file ${id} still processing`);
+}
+
 /** Short stable fingerprint of an image's source (url, prompt + size, or file bytes). */
 function sourceHash(s) {
   const h = createHash("sha1");
@@ -149,8 +180,10 @@ export async function importImage(ctx, url, displayName = "image.png") {
 
 /**
  * THE seed entry point. Resolves a batch of image specs to Wix Media files in ONE parallel
- * wave. Each spec: { path } (LOCAL file — the user's own asset, uploaded) OR { url }
- * (verified external URL — imported) OR { prompt } (generated, ~1 credit) — plus optional
+ * wave. Each spec: { mediaId } (a file already in this site's Media Manager — used as it is,
+ * as is a static.wixstatic.com/media URL of one) OR { path } (LOCAL file — the user's own asset,
+ * uploaded) OR { url } (verified external URL — imported) OR { prompt } (generated, ~1 credit) —
+ * plus optional
  * displayName, width, height. Returns an array aligned with the input: { file, error } per
  * spec — `file` is { id, url } on success and null otherwise; `error` is the reason it is null
  * (the thrown message, "empty spec", or "timed out"). Never throws. Every failure is also
@@ -166,8 +199,11 @@ export async function resolveItemImagesDetailed(ctx, specs, { perImageBudgetMs =
   });
   const results = await Promise.allSettled(
     (specs ?? []).map(async (s) => {
-      if (!s || (!s.path && !s.url && !s.prompt)) return null;
+      if (!s || (!s.path && !s.url && !s.prompt && !s.mediaId)) return null;
       const resolve = (async () => {
+        // A file already in this site's Media Manager is used as it is: no import, no copy.
+        const inMedia = await existingMediaFile(ctx, s);
+        if (inMedia) return inMedia;
         const name = stableName(s);
         // uploadImage swaps in the file's own extension; look for what it will actually be named
         const uploadedName = s.path ? name.replace(/\.[a-z0-9]+$/i, "") + extname(s.path).toLowerCase() : name;
@@ -184,10 +220,10 @@ export async function resolveItemImagesDetailed(ctx, specs, { perImageBudgetMs =
   );
   return results.map((r, i) => {
     const spec = specs?.[i] ?? {};
-    const label = spec.displayName ?? spec.path ?? spec.url ?? (spec.prompt ? "(prompt)" : "(empty)");
+    const label = spec.displayName ?? spec.mediaId ?? spec.path ?? spec.url ?? (spec.prompt ? "(prompt)" : "(empty)");
     if (r.status === "fulfilled") {
       if (r.value) return { file: r.value, error: null };
-      const error = !spec.path && !spec.url && !spec.prompt ? "empty spec" : `timed out after ${perImageBudgetMs} ms`;
+      const error = !spec.path && !spec.url && !spec.prompt && !spec.mediaId ? "empty spec" : `timed out after ${perImageBudgetMs} ms`;
       if (error !== "empty spec") console.error(`image ${label}: ${error}`);
       return { file: null, error };
     }

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

@@ -0,0 +1,15 @@
+// Whether a seed module is the script node was started with (`node seed-<vertical>.mjs plan.json`)
+// rather than imported. Compares real paths, so Windows backslashes, relative invocations and
+// symlinked folders all match (node reports the module's real path in import.meta.url).
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export function isMain(moduleUrl) {
+  if (!process.argv[1]) return false;
+  try {
+    return realpathSync(resolve(process.argv[1])) === realpathSync(fileURLToPath(moduleUrl));
+  } catch {
+    return false;
+  }
+}