@productmaker/mcp 7.1.0 → 7.2.0

package/dist/http.js

@@ -1475,9 +1475,23 @@ var LandingSectionPlanSchema = z11.array(LandingSectionPlanEntrySchema).superRef
 
 // ../../packages/types/src/landing.ts
 var LandingImageReadable = z12.object({
+  /**
+  * Display position in the AGGREGATED gallery (parent images + every `done`
+  * variant's images, concatenated). Recalculated on every read from
+  * `creativeVariants` order (createdAt asc), so it DRIFTS for a given image
+  * when a sibling variant finishes out of creation order — it is NOT a
+  * stable identity. Use `sourceIndex` for that.
+  */
   index: z12.number().int().min(1).max(20),
   /** Child task that owns this image when variants are rendered alongside the root task. */
   variantTaskId: z12.string().uuid().optional(),
+  /**
+  * The image's own `indexNum` within its OWN task (root or variant) — set
+  * once at render time and never recomputed. Unlike `index`, this is stable
+  * across reads and is the correct key for identity/selection tracking.
+  * Optional only for legacy rows persisted before this field existed.
+  */
+  sourceIndex: z12.number().int().min(1).optional(),
   role: LandingRoleLegacy,
   /** Strategy-specific display identity; absent on legacy tasks. */
   sectionKey: LandingSectionKeySchema.optional(),
@@ -5102,6 +5116,7 @@ var SelectedLandingImage = z28.object({
   /** 0-based index of the selected variant (from img.notes JSON array) */
   variantIndex: z28.number().int().nonnegative()
 });
+var SHOPIFY_MAX_LANDING_IMAGES = 20;
 var ShopifyPublicationMode = z28.enum([
   "auto",
   "existing",
@@ -5116,9 +5131,9 @@ var ShopifyPublishRequest = z28.object({
    * Landing images to include in the Shopify page with their selected variants.
    * Required (≥1) for CLASSIC image landings — the classic publish branch enforces
    * that itself. CODE landings have no images and send an empty array, so the schema
-   * allows empty; max 10 (one per landing section).
+   * allows empty; at most SHOPIFY_MAX_LANDING_IMAGES.
    */
-  selectedLandingImages: z28.array(SelectedLandingImage).max(10).default([]),
+  selectedLandingImages: z28.array(SelectedLandingImage).max(SHOPIFY_MAX_LANDING_IMAGES).default([]),
   /** Show variant picker pills in the landing when the product has multiple variants. */
   showVariantPicker: z28.boolean().optional(),
   /**
@@ -5304,7 +5319,13 @@ var ShopifyPublishErrorResponse = z28.discriminatedUnion("code", [
       "SHOPIFY_PUBLISH_FAILED",
       "SHOPIFY_NO_PUBLISHED_THEME",
       "SHOPIFY_THEME_STRUCTURE_UNSUPPORTED",
-      "SHOPIFY_PUBLISH_CONTEXT_CHANGED"
+      "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
+      /**
+      * A publish failure we understand (Shopify did not keep the offer's
+      * variants, another app rewrote the product, landing too large).
+      * `message` carries the seller's next step; never a 500.
+      */
+      "SHOPIFY_PUBLISH_VERIFICATION_FAILED"
     ]),
     message: z28.string().optional(),
     authUrl: z28.string().url().optional(),
@@ -5314,13 +5335,31 @@ var ShopifyPublishErrorResponse = z28.discriminatedUnion("code", [
   z28.object({
     code: z28.literal("SHOPIFY_PUBLISH_INPUT_REQUIRED"),
     message: z28.string().optional(),
-    recovery: PublishPreparationSchema.options[1]
+    recovery: PublishPreparationSchema.options[1],
+    /**
+    * Present when this answers a confirmed correction: the seller already
+    * submitted the form and these issue codes are WHY it was refused. Every
+    * surface must say so instead of re-opening the same form mute (C1).
+    */
+    correctionRejected: z28.literal(true).optional(),
+    rejectedIssueCodes: z28.array(PublishRecoveryCodeSchema).max(6).optional()
   }),
   z28.object({
     code: z28.literal("SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR"),
     action: z28.literal("open_editor"),
     message: z28.string().optional()
   }),
+  z28.object({
+    /**
+    * The seller confirmed exactly what we suggested and the offer still
+    * cannot publish: another pass of the recovery form cannot converge, so
+    * the only exit is the landing editor. `message` names the reason.
+    */
+    code: z28.literal("SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED"),
+    action: z28.literal("open_editor"),
+    message: z28.string().optional(),
+    commerceCorrectionSaved: z28.literal(true).optional()
+  }),
   z28.object({
     /**
     * The chosen existing product cannot express the confirmed offer's
@@ -7229,7 +7268,13 @@ var ImageQaGateEntry = z36.object({
     "passed",
     "failed",
     "unavailable"
-  ]).optional()
+  ]).optional(),
+  // Paid edit QA telemetry (plan t2-j9): whether the edit could be checked at all,
+  // whether a previous image was actually available to compare against, and the
+  // measured pixel-delta between the two images.
+  requestedEditVerifiable: z36.boolean().optional(),
+  previousImageUsed: z36.boolean().optional(),
+  editPixelDelta: z36.number().min(0).max(1).optional()
 }).passthrough();
 var ImageQaAssessmentState = z36.enum([
   "approved",
@@ -16715,7 +16760,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "7.1.0";
+var MCP_VERSION = "7.2.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -17869,6 +17914,8 @@ var McpErrorCode = {
   SHOPIFY_PUBLISH_INPUT_REQUIRED: "SHOPIFY_PUBLISH_INPUT_REQUIRED",
   SHOPIFY_PUBLISH_CONTEXT_CHANGED: "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
   SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR: "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR",
+  SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED: "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED",
+  SHOPIFY_PUBLISH_VERIFICATION_FAILED: "SHOPIFY_PUBLISH_VERIFICATION_FAILED",
   SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE: "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
   SHOPIFY_THEME_SETUP_REQUIRED: "SHOPIFY_THEME_SETUP_REQUIRED",
   // Meta / Facebook Ads
@@ -17941,6 +17988,8 @@ var CODE_MESSAGES = {
   SHOPIFY_PUBLISH_INPUT_REQUIRED: "Review every recovery issue with the seller. Ask for missing prices and confirm the exact currency, unit price and pack totals before resending commerceCorrection with confirmed:true. Never invent amounts, convert currency or remove an offer.",
   SHOPIFY_PUBLISH_CONTEXT_CHANGED: "The publication context changed. Reopen the task in ProductMaker, review the current store, product and landing revision, and obtain fresh confirmation. Do not reuse this correction.",
   SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR: "Open the landing editor in ProductMaker to reconcile the visible offer with checkout prices. The correction was not saved; do not retry it automatically or regenerate the landing without approval.",
+  SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED: "The seller confirmed exactly the suggested values and the offer still cannot publish \u2014 resending the same correction will loop. Read the error's reason to the user and send them to the landing editor in ProductMaker to adjust the offer, then publish again. Do not resend commerceCorrection.",
+  SHOPIFY_PUBLISH_VERIFICATION_FAILED: "Shopify did not keep what the publish wrote (offer variants, template or inventory), or the landing is too large. Read the error's reason to the user; retry the publish once, and if it repeats follow the step in the reason (map packs to existing variants, check apps that edit products, or trim the landing in the editor).",
   SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE: "The selected Shopify product cannot carry the confirmed offer (missing quantity options/prices) or no longer exists. Read the error's message to the user, then retry with publicationMode:'new' to create a fresh product, or ask the user to pick a different existing product.",
   SHOPIFY_THEME_SETUP_REQUIRED: "The store's Shopify theme is missing the ProductMaker 'Code Landing' app block \u2014 publishing now would create a product whose page renders blank. Send the user the themeEditorDeepLink (in error data) to open the Shopify theme editor, have them confirm the Code Landing block is added and press Save, then retry publishing. This is a one-time step per store; nothing was published.",
   SHOPIFY_NO_PUBLISHED_THEME: "The Shopify store has no published theme, so there is nowhere to place the landing. Ask the user to publish a theme (Online Store > Themes > Publish) and retry.",
@@ -18136,6 +18185,8 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED,
   McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR,
+  McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED,
+  McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED,
   McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
@@ -18163,6 +18214,8 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED,
   McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR,
+  McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED,
+  McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED,
   McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
@@ -18286,13 +18339,20 @@ function translateError(err) {
   }
   if (err instanceof ApiHttpError) {
     const body = isRecord2(err.body) ? err.body : {};
-    if (body.code === McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR || body.code === McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE || body.code === McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_FAILED) {
+    if (body.code === McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED || body.code === McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE || body.code === McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_FAILED) {
       const parsed = ShopifyPublishErrorResponse.safeParse(body);
       if (!parsed.success) return mcp(McpErrorCode.INTERNAL, resolveMessage(McpErrorCode.INTERNAL, void 0));
       const details = parsed.data;
       const extra = {};
-      if (details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED") extra.recovery = details.recovery;
-      if (details.code === "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR") extra.action = details.action;
+      if (details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED") {
+        extra.recovery = details.recovery;
+        if (details.correctionRejected) {
+          extra.correctionRejected = true;
+          if (details.rejectedIssueCodes) extra.rejectedIssueCodes = details.rejectedIssueCodes;
+        }
+      }
+      if (details.code === "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR" || details.code === "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED") extra.action = details.action;
+      if ((details.code === "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED" || details.code === "SHOPIFY_PUBLISH_VERIFICATION_FAILED" || details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED" && details.correctionRejected) && details.message) extra.reason = details.message.slice(0, 500);
       if (details.code === "SHOPIFY_THEME_SETUP_REQUIRED") extra.themeEditorDeepLink = details.themeEditorDeepLink;
       const saved = "commerceCorrectionSaved" in details && details.commerceCorrectionSaved === true;
       if (saved) extra.commerceCorrectionSaved = true;
@@ -21597,7 +21657,7 @@ var TikTokInput = z78.object({
 });
 function registerPublishTools(server, api, opts = {}) {
   const transport = opts.transport ?? "http";
-  server.tool("publish_to_shopify", publishToShopifyGuidance.summary + " Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. En code landings con una oferta expl\xEDcita de packs, ProductMaker s\xF3lo publica el selector si variantes reales de Shopify cobran los totales exactos; la respuesta explica si las cre\xF3, verific\xF3 o descart\xF3 por no existir ahorro. Si devuelve SHOPIFY_PUBLISH_INPUT_REQUIRED, muestra todos los problemas de recovery y solicita los importes faltantes. Solo env\xEDa commerceCorrection con su revisi\xF3n/huella y confirmed:true despu\xE9s de confirmar los valores exactos; nunca inventes importes, conviertas moneda ni elimines ofertas. Un contexto obsoleto requiere volver a revisar; open_editor requiere el editor de ProductMaker. Si devuelve SHOPIFY_THEME_SETUP_REQUIRED, el tema de la tienda no tiene el bloque Code Landing y nada se public\xF3: env\xEDa al usuario el themeEditorDeepLink del error para abrir el editor del tema de Shopify, p\xEDdele que agregue el bloque y pulse Guardar (una sola vez por tienda), y reintenta s\xF3lo despu\xE9s. Ante resultado incierto, verifica la tarea/tienda antes de volver a publicar, especialmente con new; commerceCorrectionSaved no prueba publicaci\xF3n. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input, extra) => {
+  server.tool("publish_to_shopify", publishToShopifyGuidance.summary + " Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. En code landings con una oferta expl\xEDcita de packs, ProductMaker s\xF3lo publica el selector si variantes reales de Shopify cobran los totales exactos; la respuesta explica si las cre\xF3, verific\xF3 o descart\xF3 por no existir ahorro. Si devuelve SHOPIFY_PUBLISH_INPUT_REQUIRED, muestra todos los problemas de recovery y solicita los importes faltantes. Solo env\xEDa commerceCorrection con su revisi\xF3n/huella y confirmed:true despu\xE9s de confirmar los valores exactos; nunca inventes importes, conviertas moneda ni elimines ofertas. Si adem\xE1s trae correctionRejected, lo que el vendedor confirm\xF3 fue rechazado: l\xE9ele `reason` ANTES de volver a pedir datos. Un contexto obsoleto requiere volver a revisar; open_editor (incluido SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED) requiere el editor de ProductMaker y NO se reenv\xEDa la misma correcci\xF3n. SHOPIFY_PUBLISH_VERIFICATION_FAILED trae en `reason` el siguiente paso: reintenta una vez y si se repite sigue ese paso. Si devuelve SHOPIFY_THEME_SETUP_REQUIRED, el tema de la tienda no tiene el bloque Code Landing y nada se public\xF3: env\xEDa al usuario el themeEditorDeepLink del error para abrir el editor del tema de Shopify, p\xEDdele que agregue el bloque y pulse Guardar (una sola vez por tienda), y reintenta s\xF3lo despu\xE9s. Ante resultado incierto, verifica la tarea/tienda antes de volver a publicar, especialmente con new; commerceCorrectionSaved no prueba publicaci\xF3n. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input, extra) => {
     try {
       const parsed = parseShopifyInput(input);
       if (parsed.publicationMode === "existing" && !parsed.targetProductId) {
@@ -21614,7 +21674,7 @@ function registerPublishTools(server, api, opts = {}) {
       const variantIndex = parsed.variantIndex ?? 0;
       const availableImages = await fetchLandingImageCount(api, parsed.taskId);
       const effectiveAvailable = availableImages > 0 ? availableImages : 3;
-      const numImages = Math.min(parsed.numLandingImages ?? effectiveAvailable, effectiveAvailable);
+      const numImages = Math.min(parsed.numLandingImages ?? effectiveAvailable, effectiveAvailable, SHOPIFY_MAX_LANDING_IMAGES);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -21645,6 +21705,8 @@ function registerPublishTools(server, api, opts = {}) {
         "SHOPIFY_PUBLISH_INPUT_REQUIRED",
         "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
         "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR",
+        "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED",
+        "SHOPIFY_PUBLISH_VERIFICATION_FAILED",
         "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
         "SHOPIFY_THEME_SETUP_REQUIRED",
         "SHOPIFY_PUBLISH_FAILED"

package/dist/stdio.js

@@ -1497,9 +1497,23 @@ var LandingSectionPlanSchema = z11.array(LandingSectionPlanEntrySchema).superRef
 
 // ../../packages/types/src/landing.ts
 var LandingImageReadable = z12.object({
+  /**
+  * Display position in the AGGREGATED gallery (parent images + every `done`
+  * variant's images, concatenated). Recalculated on every read from
+  * `creativeVariants` order (createdAt asc), so it DRIFTS for a given image
+  * when a sibling variant finishes out of creation order — it is NOT a
+  * stable identity. Use `sourceIndex` for that.
+  */
   index: z12.number().int().min(1).max(20),
   /** Child task that owns this image when variants are rendered alongside the root task. */
   variantTaskId: z12.string().uuid().optional(),
+  /**
+  * The image's own `indexNum` within its OWN task (root or variant) — set
+  * once at render time and never recomputed. Unlike `index`, this is stable
+  * across reads and is the correct key for identity/selection tracking.
+  * Optional only for legacy rows persisted before this field existed.
+  */
+  sourceIndex: z12.number().int().min(1).optional(),
   role: LandingRoleLegacy,
   /** Strategy-specific display identity; absent on legacy tasks. */
   sectionKey: LandingSectionKeySchema.optional(),
@@ -5124,6 +5138,7 @@ var SelectedLandingImage = z28.object({
   /** 0-based index of the selected variant (from img.notes JSON array) */
   variantIndex: z28.number().int().nonnegative()
 });
+var SHOPIFY_MAX_LANDING_IMAGES = 20;
 var ShopifyPublicationMode = z28.enum([
   "auto",
   "existing",
@@ -5138,9 +5153,9 @@ var ShopifyPublishRequest = z28.object({
    * Landing images to include in the Shopify page with their selected variants.
    * Required (≥1) for CLASSIC image landings — the classic publish branch enforces
    * that itself. CODE landings have no images and send an empty array, so the schema
-   * allows empty; max 10 (one per landing section).
+   * allows empty; at most SHOPIFY_MAX_LANDING_IMAGES.
    */
-  selectedLandingImages: z28.array(SelectedLandingImage).max(10).default([]),
+  selectedLandingImages: z28.array(SelectedLandingImage).max(SHOPIFY_MAX_LANDING_IMAGES).default([]),
   /** Show variant picker pills in the landing when the product has multiple variants. */
   showVariantPicker: z28.boolean().optional(),
   /**
@@ -5326,7 +5341,13 @@ var ShopifyPublishErrorResponse = z28.discriminatedUnion("code", [
       "SHOPIFY_PUBLISH_FAILED",
       "SHOPIFY_NO_PUBLISHED_THEME",
       "SHOPIFY_THEME_STRUCTURE_UNSUPPORTED",
-      "SHOPIFY_PUBLISH_CONTEXT_CHANGED"
+      "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
+      /**
+      * A publish failure we understand (Shopify did not keep the offer's
+      * variants, another app rewrote the product, landing too large).
+      * `message` carries the seller's next step; never a 500.
+      */
+      "SHOPIFY_PUBLISH_VERIFICATION_FAILED"
     ]),
     message: z28.string().optional(),
     authUrl: z28.string().url().optional(),
@@ -5336,13 +5357,31 @@ var ShopifyPublishErrorResponse = z28.discriminatedUnion("code", [
   z28.object({
     code: z28.literal("SHOPIFY_PUBLISH_INPUT_REQUIRED"),
     message: z28.string().optional(),
-    recovery: PublishPreparationSchema.options[1]
+    recovery: PublishPreparationSchema.options[1],
+    /**
+    * Present when this answers a confirmed correction: the seller already
+    * submitted the form and these issue codes are WHY it was refused. Every
+    * surface must say so instead of re-opening the same form mute (C1).
+    */
+    correctionRejected: z28.literal(true).optional(),
+    rejectedIssueCodes: z28.array(PublishRecoveryCodeSchema).max(6).optional()
   }),
   z28.object({
     code: z28.literal("SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR"),
     action: z28.literal("open_editor"),
     message: z28.string().optional()
   }),
+  z28.object({
+    /**
+    * The seller confirmed exactly what we suggested and the offer still
+    * cannot publish: another pass of the recovery form cannot converge, so
+    * the only exit is the landing editor. `message` names the reason.
+    */
+    code: z28.literal("SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED"),
+    action: z28.literal("open_editor"),
+    message: z28.string().optional(),
+    commerceCorrectionSaved: z28.literal(true).optional()
+  }),
   z28.object({
     /**
     * The chosen existing product cannot express the confirmed offer's
@@ -7251,7 +7290,13 @@ var ImageQaGateEntry = z36.object({
     "passed",
     "failed",
     "unavailable"
-  ]).optional()
+  ]).optional(),
+  // Paid edit QA telemetry (plan t2-j9): whether the edit could be checked at all,
+  // whether a previous image was actually available to compare against, and the
+  // measured pixel-delta between the two images.
+  requestedEditVerifiable: z36.boolean().optional(),
+  previousImageUsed: z36.boolean().optional(),
+  editPixelDelta: z36.number().min(0).max(1).optional()
 }).passthrough();
 var ImageQaAssessmentState = z36.enum([
   "approved",
@@ -15094,7 +15139,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "7.1.0";
+var MCP_VERSION = "7.2.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -16248,6 +16293,8 @@ var McpErrorCode = {
   SHOPIFY_PUBLISH_INPUT_REQUIRED: "SHOPIFY_PUBLISH_INPUT_REQUIRED",
   SHOPIFY_PUBLISH_CONTEXT_CHANGED: "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
   SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR: "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR",
+  SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED: "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED",
+  SHOPIFY_PUBLISH_VERIFICATION_FAILED: "SHOPIFY_PUBLISH_VERIFICATION_FAILED",
   SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE: "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
   SHOPIFY_THEME_SETUP_REQUIRED: "SHOPIFY_THEME_SETUP_REQUIRED",
   // Meta / Facebook Ads
@@ -16320,6 +16367,8 @@ var CODE_MESSAGES = {
   SHOPIFY_PUBLISH_INPUT_REQUIRED: "Review every recovery issue with the seller. Ask for missing prices and confirm the exact currency, unit price and pack totals before resending commerceCorrection with confirmed:true. Never invent amounts, convert currency or remove an offer.",
   SHOPIFY_PUBLISH_CONTEXT_CHANGED: "The publication context changed. Reopen the task in ProductMaker, review the current store, product and landing revision, and obtain fresh confirmation. Do not reuse this correction.",
   SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR: "Open the landing editor in ProductMaker to reconcile the visible offer with checkout prices. The correction was not saved; do not retry it automatically or regenerate the landing without approval.",
+  SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED: "The seller confirmed exactly the suggested values and the offer still cannot publish \u2014 resending the same correction will loop. Read the error's reason to the user and send them to the landing editor in ProductMaker to adjust the offer, then publish again. Do not resend commerceCorrection.",
+  SHOPIFY_PUBLISH_VERIFICATION_FAILED: "Shopify did not keep what the publish wrote (offer variants, template or inventory), or the landing is too large. Read the error's reason to the user; retry the publish once, and if it repeats follow the step in the reason (map packs to existing variants, check apps that edit products, or trim the landing in the editor).",
   SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE: "The selected Shopify product cannot carry the confirmed offer (missing quantity options/prices) or no longer exists. Read the error's message to the user, then retry with publicationMode:'new' to create a fresh product, or ask the user to pick a different existing product.",
   SHOPIFY_THEME_SETUP_REQUIRED: "The store's Shopify theme is missing the ProductMaker 'Code Landing' app block \u2014 publishing now would create a product whose page renders blank. Send the user the themeEditorDeepLink (in error data) to open the Shopify theme editor, have them confirm the Code Landing block is added and press Save, then retry publishing. This is a one-time step per store; nothing was published.",
   SHOPIFY_NO_PUBLISHED_THEME: "The Shopify store has no published theme, so there is nowhere to place the landing. Ask the user to publish a theme (Online Store > Themes > Publish) and retry.",
@@ -16515,6 +16564,8 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED,
   McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR,
+  McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED,
+  McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED,
   McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
@@ -16542,6 +16593,8 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED,
   McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR,
+  McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED,
+  McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED,
   McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
@@ -16665,13 +16718,20 @@ function translateError(err) {
   }
   if (err instanceof ApiHttpError) {
     const body = isRecord2(err.body) ? err.body : {};
-    if (body.code === McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR || body.code === McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE || body.code === McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_FAILED) {
+    if (body.code === McpErrorCode.SHOPIFY_PUBLISH_INPUT_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CONTEXT_CHANGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR || body.code === McpErrorCode.SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED || body.code === McpErrorCode.SHOPIFY_PUBLISH_VERIFICATION_FAILED || body.code === McpErrorCode.SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE || body.code === McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED || body.code === McpErrorCode.SHOPIFY_PUBLISH_FAILED) {
       const parsed = ShopifyPublishErrorResponse.safeParse(body);
       if (!parsed.success) return mcp(McpErrorCode.INTERNAL, resolveMessage(McpErrorCode.INTERNAL, void 0));
       const details = parsed.data;
       const extra = {};
-      if (details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED") extra.recovery = details.recovery;
-      if (details.code === "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR") extra.action = details.action;
+      if (details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED") {
+        extra.recovery = details.recovery;
+        if (details.correctionRejected) {
+          extra.correctionRejected = true;
+          if (details.rejectedIssueCodes) extra.rejectedIssueCodes = details.rejectedIssueCodes;
+        }
+      }
+      if (details.code === "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR" || details.code === "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED") extra.action = details.action;
+      if ((details.code === "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED" || details.code === "SHOPIFY_PUBLISH_VERIFICATION_FAILED" || details.code === "SHOPIFY_PUBLISH_INPUT_REQUIRED" && details.correctionRejected) && details.message) extra.reason = details.message.slice(0, 500);
       if (details.code === "SHOPIFY_THEME_SETUP_REQUIRED") extra.themeEditorDeepLink = details.themeEditorDeepLink;
       const saved = "commerceCorrectionSaved" in details && details.commerceCorrectionSaved === true;
       if (saved) extra.commerceCorrectionSaved = true;
@@ -20029,7 +20089,7 @@ var TikTokInput = z77.object({
 });
 function registerPublishTools(server, api, opts = {}) {
   const transport = opts.transport ?? "http";
-  server.tool("publish_to_shopify", publishToShopifyGuidance.summary + " Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. En code landings con una oferta expl\xEDcita de packs, ProductMaker s\xF3lo publica el selector si variantes reales de Shopify cobran los totales exactos; la respuesta explica si las cre\xF3, verific\xF3 o descart\xF3 por no existir ahorro. Si devuelve SHOPIFY_PUBLISH_INPUT_REQUIRED, muestra todos los problemas de recovery y solicita los importes faltantes. Solo env\xEDa commerceCorrection con su revisi\xF3n/huella y confirmed:true despu\xE9s de confirmar los valores exactos; nunca inventes importes, conviertas moneda ni elimines ofertas. Un contexto obsoleto requiere volver a revisar; open_editor requiere el editor de ProductMaker. Si devuelve SHOPIFY_THEME_SETUP_REQUIRED, el tema de la tienda no tiene el bloque Code Landing y nada se public\xF3: env\xEDa al usuario el themeEditorDeepLink del error para abrir el editor del tema de Shopify, p\xEDdele que agregue el bloque y pulse Guardar (una sola vez por tienda), y reintenta s\xF3lo despu\xE9s. Ante resultado incierto, verifica la tarea/tienda antes de volver a publicar, especialmente con new; commerceCorrectionSaved no prueba publicaci\xF3n. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input, extra) => {
+  server.tool("publish_to_shopify", publishToShopifyGuidance.summary + " Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. En code landings con una oferta expl\xEDcita de packs, ProductMaker s\xF3lo publica el selector si variantes reales de Shopify cobran los totales exactos; la respuesta explica si las cre\xF3, verific\xF3 o descart\xF3 por no existir ahorro. Si devuelve SHOPIFY_PUBLISH_INPUT_REQUIRED, muestra todos los problemas de recovery y solicita los importes faltantes. Solo env\xEDa commerceCorrection con su revisi\xF3n/huella y confirmed:true despu\xE9s de confirmar los valores exactos; nunca inventes importes, conviertas moneda ni elimines ofertas. Si adem\xE1s trae correctionRejected, lo que el vendedor confirm\xF3 fue rechazado: l\xE9ele `reason` ANTES de volver a pedir datos. Un contexto obsoleto requiere volver a revisar; open_editor (incluido SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED) requiere el editor de ProductMaker y NO se reenv\xEDa la misma correcci\xF3n. SHOPIFY_PUBLISH_VERIFICATION_FAILED trae en `reason` el siguiente paso: reintenta una vez y si se repite sigue ese paso. Si devuelve SHOPIFY_THEME_SETUP_REQUIRED, el tema de la tienda no tiene el bloque Code Landing y nada se public\xF3: env\xEDa al usuario el themeEditorDeepLink del error para abrir el editor del tema de Shopify, p\xEDdele que agregue el bloque y pulse Guardar (una sola vez por tienda), y reintenta s\xF3lo despu\xE9s. Ante resultado incierto, verifica la tarea/tienda antes de volver a publicar, especialmente con new; commerceCorrectionSaved no prueba publicaci\xF3n. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input, extra) => {
     try {
       const parsed = parseShopifyInput(input);
       if (parsed.publicationMode === "existing" && !parsed.targetProductId) {
@@ -20046,7 +20106,7 @@ function registerPublishTools(server, api, opts = {}) {
       const variantIndex = parsed.variantIndex ?? 0;
       const availableImages = await fetchLandingImageCount(api, parsed.taskId);
       const effectiveAvailable = availableImages > 0 ? availableImages : 3;
-      const numImages = Math.min(parsed.numLandingImages ?? effectiveAvailable, effectiveAvailable);
+      const numImages = Math.min(parsed.numLandingImages ?? effectiveAvailable, effectiveAvailable, SHOPIFY_MAX_LANDING_IMAGES);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -20077,6 +20137,8 @@ function registerPublishTools(server, api, opts = {}) {
         "SHOPIFY_PUBLISH_INPUT_REQUIRED",
         "SHOPIFY_PUBLISH_CONTEXT_CHANGED",
         "SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR",
+        "SHOPIFY_PUBLISH_CORRECTION_NOT_CONVERGED",
+        "SHOPIFY_PUBLISH_VERIFICATION_FAILED",
         "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
         "SHOPIFY_THEME_SETUP_REQUIRED",
         "SHOPIFY_PUBLISH_FAILED"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — cost products, generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from Claude, ChatGPT, or Gemini.",