@productmaker/mcp 6.8.2 → 6.9.1

package/dist/http.js

@@ -2677,6 +2677,7 @@ function getCurrencyForCountry(country) {
 }
 __name(getCurrencyForCountry, "getCurrencyForCountry");
 var MAX_PLAUSIBLE_AMOUNT = 1e10;
+var KNOWN_CURRENCY_CODES = new Set(Object.values(CURRENCY_BY_COUNTRY).map((c) => c.code));
 
 // ../../packages/types/src/shopify-publish-recovery.ts
 var MAX_MONEY_LENGTH = 40;
@@ -5083,6 +5084,52 @@ var ShopifyPublishErrorResponse = z27.discriminatedUnion("code", [
     code: z27.literal("SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR"),
     action: z27.literal("open_editor"),
     message: z27.string().optional()
+  }),
+  z27.object({
+    /**
+    * The chosen existing product cannot express the confirmed offer's
+    * quantity/price options. `message` carries the merchant-facing reason;
+    * the client offers a one-click "create a new product and retry" path.
+    */
+    code: z27.literal("SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE"),
+    message: z27.string().optional(),
+    commerceCorrectionSaved: z27.literal(true).optional()
+  }),
+  z27.object({
+    /**
+    * Code-landing publish refused BEFORE any product mutation: the shared
+    * cl-landing template exists but the merchant has not saved the
+    * code-landing-renderer app block, so the product page would render blank.
+    * `themeEditorDeepLink` is the one-click fix — mandatory because without it
+    * the client has nothing actionable to show.
+    */
+    code: z27.literal("SHOPIFY_THEME_SETUP_REQUIRED"),
+    message: z27.string().optional(),
+    shopDomain: z27.string().optional(),
+    themeEditorDeepLink: z27.string().url(),
+    /**
+    * Present when the request also carried a commerceCorrection that was
+    * committed before the gate refused — the client must drop the stale
+    * correction before retrying or it dies on CONTEXT_CHANGED.
+    */
+    commerceCorrectionSaved: z27.literal(true).optional()
+  })
+]);
+var CodeLandingThemeSetupResponse = z27.discriminatedUnion("status", [
+  z27.object({
+    /** The app block is saved (ready) or still missing (setup_required). */
+    status: z27.enum([
+      "ready",
+      "setup_required"
+    ]),
+    /** One-click theme-editor link that pre-adds the Code Landing block. */
+    themeEditorDeepLink: z27.string().url(),
+    shopDomain: z27.string()
+  }),
+  z27.object({
+    /** Not a code-landing task — the gate does not apply. */
+    status: z27.literal("not_applicable"),
+    shopDomain: z27.string().optional()
   })
 ]);
 var ShopifyAuthUrlResponse = z27.object({
@@ -6292,7 +6339,7 @@ var SharedOutputEstimationFields = {
   *  The lightweight competitor scan must never imply this add-on. */
   competitorCommercialStudyRequested: z33.boolean().optional(),
   /** Declining the winner replica makes `gap_replication` unreachable, so its
-  *  forced-STANDARD ceiling must not be quoted. See
+  *  tier-matched replication ceiling must not be quoted. See
   *  `.agent/specs/winner-replication-consent.spec.test.ts`. */
   replicateWinnerWhenFound: z33.boolean().optional()
 };
@@ -13047,6 +13094,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_reference"
   ], [
+    "task",
+    "product",
     "landing"
   ], SHARED_CHANNEL_EXPOSURE, [
     {
@@ -13144,6 +13193,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_reference"
   ], [
+    "task",
+    "creative",
     "video"
   ], SHARED_CHANNEL_EXPOSURE, [
     {
@@ -14198,6 +14249,60 @@ import { z as z65 } from "zod";
 
 // ../../packages/types/src/whatsapp-presentation-finalizer.ts
 import { z as z64 } from "zod";
+var WhatsAppQuoteRecoveryChoiceSchema = z64.enum([
+  "without_winner",
+  "retry",
+  "cancel"
+]);
+var recoveryBase = {
+  version: z64.literal(1),
+  requestHash: z64.string().min(1).max(256),
+  issuedAt: z64.string().datetime(),
+  expiresAt: z64.string().datetime(),
+  offeredAlternative: z64.literal("without_winner").nullable()
+};
+var WhatsAppQuoteRecoveryReceiptSchema = z64.discriminatedUnion("state", [
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("open"),
+    successorCommandId: z64.null(),
+    choice: z64.null()
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("consumed"),
+    successorCommandId: z64.string().uuid(),
+    choice: z64.enum([
+      "without_winner",
+      "retry"
+    ])
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("awaiting_media"),
+    successorCommandId: z64.null(),
+    successorCollectionId: z64.string().uuid(),
+    choice: z64.enum([
+      "without_winner",
+      "retry"
+    ])
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("cancelled"),
+    successorCommandId: z64.null(),
+    choice: z64.literal("cancel")
+  }).strict()
+]).refine((receipt) => {
+  const duration = Date.parse(receipt.expiresAt) - Date.parse(receipt.issuedAt);
+  return duration > 0 && duration <= 24 * 60 * 60 * 1e3;
+}, "Recovery must expire within twenty-four hours");
+var WhatsAppQuoteBudgetResultSchema = z64.object({
+  estimatedMinCredits: z64.number().finite().nonnegative(),
+  estimatedMaxCredits: z64.number().finite().positive(),
+  balanceCredits: z64.number().finite(),
+  budgetRecovery: WhatsAppQuoteRecoveryReceiptSchema.optional()
+}).strict().refine((result) => result.estimatedMinCredits <= result.estimatedMaxCredits, "Minimum budget cannot exceed maximum");
 var json = z64.lazy(() => z64.union([
   z64.null(),
   z64.boolean(),
@@ -14228,6 +14333,12 @@ function sameJson(a, b) {
 __name(sameJson, "sameJson");
 var WhatsAppPresentationFinalizerSchema = z64.object({
   command: z64.discriminatedUnion("kind", [
+    z64.object({
+      ...proposedSnapshot,
+      kind: z64.literal("reject_quote"),
+      errorCode: z64.literal("insufficient_balance"),
+      result: WhatsAppQuoteBudgetResultSchema
+    }).strict(),
     z64.object({
       ...proposedSnapshot,
       kind: z64.literal("reject_command"),
@@ -14287,7 +14398,7 @@ var WhatsAppPresentationFinalizerSchema = z64.object({
     expiresAt: z64.string().datetime()
   }).strict().optional()
 }).strict().superRefine((value, ctx) => {
-  if (value.command?.kind === "reject_command" || value.command?.kind === "complete_cancel") {
+  if (value.command?.kind === "reject_command" || value.command?.kind === "reject_quote" || value.command?.kind === "complete_cancel") {
     if (value.plan || value.collection) ctx.addIssue({
       code: z64.ZodIssueCode.custom,
       message: "Proposed command finalizers cannot bind plans or collections"
@@ -14296,6 +14407,13 @@ var WhatsAppPresentationFinalizerSchema = z64.object({
       code: z64.ZodIssueCode.custom,
       message: "Rejection must preserve the original result"
     });
+    if (value.command.kind === "reject_quote") {
+      const receipt = value.command.result.budgetRecovery;
+      if (receipt && (receipt.requestHash !== value.command.requestHash || receipt.state !== "open")) ctx.addIssue({
+        code: z64.ZodIssueCode.custom,
+        message: "Budget recovery must be new and bound to the rejected request"
+      });
+    }
   }
   if (!value.command && !value.plan && !value.collection) ctx.addIssue({
     code: z64.ZodIssueCode.custom,
@@ -16081,7 +16199,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "6.8.2";
+var MCP_VERSION = "6.9.1";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -17199,6 +17317,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_TARGET_INCOMPATIBLE: "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
+  SHOPIFY_THEME_SETUP_REQUIRED: "SHOPIFY_THEME_SETUP_REQUIRED",
   // Meta / Facebook Ads
   META_NO_FB_PAGE: "META_NO_FB_PAGE",
   META_PORTFOLIO_MISMATCH: "META_PORTFOLIO_MISMATCH",
@@ -17269,6 +17389,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_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.",
   SHOPIFY_THEME_STRUCTURE_UNSUPPORTED: "The active Shopify theme contains an HTML structure ProductMaker cannot process safely. Ask the user to restore a valid layout/theme.liquid or contact ProductMaker support to correct the theme, then retry.",
   // Meta — high-frequency
@@ -17462,6 +17584,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_TARGET_INCOMPATIBLE,
+  McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.NO_SHOPIFY_SHOPS,
   McpErrorCode.NO_META_AD_ACCOUNTS
@@ -17487,6 +17611,7 @@ 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_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
@@ -17609,13 +17734,14 @@ 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_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_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_THEME_SETUP_REQUIRED") extra.themeEditorDeepLink = details.themeEditorDeepLink;
       const saved = "commerceCorrectionSaved" in details && details.commerceCorrectionSaved === true;
       if (saved) extra.commerceCorrectionSaved = true;
       const message = resolveMessage(body.code, void 0);
@@ -20889,7 +21015,7 @@ var TikTokInput = z76.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. 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. 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) => {
     try {
       const parsed = parseShopifyInput(input);
       if (parsed.publicationMode === "existing" && !parsed.targetProductId) {

package/dist/stdio.js

@@ -2699,6 +2699,7 @@ function getCurrencyForCountry(country) {
 }
 __name(getCurrencyForCountry, "getCurrencyForCountry");
 var MAX_PLAUSIBLE_AMOUNT = 1e10;
+var KNOWN_CURRENCY_CODES = new Set(Object.values(CURRENCY_BY_COUNTRY).map((c) => c.code));
 
 // ../../packages/types/src/shopify-publish-recovery.ts
 var MAX_MONEY_LENGTH = 40;
@@ -5105,6 +5106,52 @@ var ShopifyPublishErrorResponse = z27.discriminatedUnion("code", [
     code: z27.literal("SHOPIFY_PUBLISH_CORRECTION_REQUIRES_EDITOR"),
     action: z27.literal("open_editor"),
     message: z27.string().optional()
+  }),
+  z27.object({
+    /**
+    * The chosen existing product cannot express the confirmed offer's
+    * quantity/price options. `message` carries the merchant-facing reason;
+    * the client offers a one-click "create a new product and retry" path.
+    */
+    code: z27.literal("SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE"),
+    message: z27.string().optional(),
+    commerceCorrectionSaved: z27.literal(true).optional()
+  }),
+  z27.object({
+    /**
+    * Code-landing publish refused BEFORE any product mutation: the shared
+    * cl-landing template exists but the merchant has not saved the
+    * code-landing-renderer app block, so the product page would render blank.
+    * `themeEditorDeepLink` is the one-click fix — mandatory because without it
+    * the client has nothing actionable to show.
+    */
+    code: z27.literal("SHOPIFY_THEME_SETUP_REQUIRED"),
+    message: z27.string().optional(),
+    shopDomain: z27.string().optional(),
+    themeEditorDeepLink: z27.string().url(),
+    /**
+    * Present when the request also carried a commerceCorrection that was
+    * committed before the gate refused — the client must drop the stale
+    * correction before retrying or it dies on CONTEXT_CHANGED.
+    */
+    commerceCorrectionSaved: z27.literal(true).optional()
+  })
+]);
+var CodeLandingThemeSetupResponse = z27.discriminatedUnion("status", [
+  z27.object({
+    /** The app block is saved (ready) or still missing (setup_required). */
+    status: z27.enum([
+      "ready",
+      "setup_required"
+    ]),
+    /** One-click theme-editor link that pre-adds the Code Landing block. */
+    themeEditorDeepLink: z27.string().url(),
+    shopDomain: z27.string()
+  }),
+  z27.object({
+    /** Not a code-landing task — the gate does not apply. */
+    status: z27.literal("not_applicable"),
+    shopDomain: z27.string().optional()
   })
 ]);
 var ShopifyAuthUrlResponse = z27.object({
@@ -6314,7 +6361,7 @@ var SharedOutputEstimationFields = {
   *  The lightweight competitor scan must never imply this add-on. */
   competitorCommercialStudyRequested: z33.boolean().optional(),
   /** Declining the winner replica makes `gap_replication` unreachable, so its
-  *  forced-STANDARD ceiling must not be quoted. See
+  *  tier-matched replication ceiling must not be quoted. See
   *  `.agent/specs/winner-replication-consent.spec.test.ts`. */
   replicateWinnerWhenFound: z33.boolean().optional()
 };
@@ -13069,6 +13116,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_reference"
   ], [
+    "task",
+    "product",
     "landing"
   ], SHARED_CHANNEL_EXPOSURE, [
     {
@@ -13166,6 +13215,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_reference"
   ], [
+    "task",
+    "creative",
     "video"
   ], SHARED_CHANNEL_EXPOSURE, [
     {
@@ -13966,6 +14017,60 @@ import { z as z65 } from "zod";
 
 // ../../packages/types/src/whatsapp-presentation-finalizer.ts
 import { z as z64 } from "zod";
+var WhatsAppQuoteRecoveryChoiceSchema = z64.enum([
+  "without_winner",
+  "retry",
+  "cancel"
+]);
+var recoveryBase = {
+  version: z64.literal(1),
+  requestHash: z64.string().min(1).max(256),
+  issuedAt: z64.string().datetime(),
+  expiresAt: z64.string().datetime(),
+  offeredAlternative: z64.literal("without_winner").nullable()
+};
+var WhatsAppQuoteRecoveryReceiptSchema = z64.discriminatedUnion("state", [
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("open"),
+    successorCommandId: z64.null(),
+    choice: z64.null()
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("consumed"),
+    successorCommandId: z64.string().uuid(),
+    choice: z64.enum([
+      "without_winner",
+      "retry"
+    ])
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("awaiting_media"),
+    successorCommandId: z64.null(),
+    successorCollectionId: z64.string().uuid(),
+    choice: z64.enum([
+      "without_winner",
+      "retry"
+    ])
+  }).strict(),
+  z64.object({
+    ...recoveryBase,
+    state: z64.literal("cancelled"),
+    successorCommandId: z64.null(),
+    choice: z64.literal("cancel")
+  }).strict()
+]).refine((receipt) => {
+  const duration = Date.parse(receipt.expiresAt) - Date.parse(receipt.issuedAt);
+  return duration > 0 && duration <= 24 * 60 * 60 * 1e3;
+}, "Recovery must expire within twenty-four hours");
+var WhatsAppQuoteBudgetResultSchema = z64.object({
+  estimatedMinCredits: z64.number().finite().nonnegative(),
+  estimatedMaxCredits: z64.number().finite().positive(),
+  balanceCredits: z64.number().finite(),
+  budgetRecovery: WhatsAppQuoteRecoveryReceiptSchema.optional()
+}).strict().refine((result) => result.estimatedMinCredits <= result.estimatedMaxCredits, "Minimum budget cannot exceed maximum");
 var json = z64.lazy(() => z64.union([
   z64.null(),
   z64.boolean(),
@@ -13996,6 +14101,12 @@ function sameJson(a, b) {
 __name(sameJson, "sameJson");
 var WhatsAppPresentationFinalizerSchema = z64.object({
   command: z64.discriminatedUnion("kind", [
+    z64.object({
+      ...proposedSnapshot,
+      kind: z64.literal("reject_quote"),
+      errorCode: z64.literal("insufficient_balance"),
+      result: WhatsAppQuoteBudgetResultSchema
+    }).strict(),
     z64.object({
       ...proposedSnapshot,
       kind: z64.literal("reject_command"),
@@ -14055,7 +14166,7 @@ var WhatsAppPresentationFinalizerSchema = z64.object({
     expiresAt: z64.string().datetime()
   }).strict().optional()
 }).strict().superRefine((value, ctx) => {
-  if (value.command?.kind === "reject_command" || value.command?.kind === "complete_cancel") {
+  if (value.command?.kind === "reject_command" || value.command?.kind === "reject_quote" || value.command?.kind === "complete_cancel") {
     if (value.plan || value.collection) ctx.addIssue({
       code: z64.ZodIssueCode.custom,
       message: "Proposed command finalizers cannot bind plans or collections"
@@ -14064,6 +14175,13 @@ var WhatsAppPresentationFinalizerSchema = z64.object({
       code: z64.ZodIssueCode.custom,
       message: "Rejection must preserve the original result"
     });
+    if (value.command.kind === "reject_quote") {
+      const receipt = value.command.result.budgetRecovery;
+      if (receipt && (receipt.requestHash !== value.command.requestHash || receipt.state !== "open")) ctx.addIssue({
+        code: z64.ZodIssueCode.custom,
+        message: "Budget recovery must be new and bound to the rejected request"
+      });
+    }
   }
   if (!value.command && !value.plan && !value.collection) ctx.addIssue({
     code: z64.ZodIssueCode.custom,
@@ -14460,7 +14578,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "6.8.2";
+var MCP_VERSION = "6.9.1";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -15578,6 +15696,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_TARGET_INCOMPATIBLE: "SHOPIFY_PUBLISH_TARGET_INCOMPATIBLE",
+  SHOPIFY_THEME_SETUP_REQUIRED: "SHOPIFY_THEME_SETUP_REQUIRED",
   // Meta / Facebook Ads
   META_NO_FB_PAGE: "META_NO_FB_PAGE",
   META_PORTFOLIO_MISMATCH: "META_PORTFOLIO_MISMATCH",
@@ -15648,6 +15768,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_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.",
   SHOPIFY_THEME_STRUCTURE_UNSUPPORTED: "The active Shopify theme contains an HTML structure ProductMaker cannot process safely. Ask the user to restore a valid layout/theme.liquid or contact ProductMaker support to correct the theme, then retry.",
   // Meta — high-frequency
@@ -15841,6 +15963,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_TARGET_INCOMPATIBLE,
+  McpErrorCode.SHOPIFY_THEME_SETUP_REQUIRED,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.NO_SHOPIFY_SHOPS,
   McpErrorCode.NO_META_AD_ACCOUNTS
@@ -15866,6 +15990,7 @@ 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_TARGET_INCOMPATIBLE,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
@@ -15988,13 +16113,14 @@ 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_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_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_THEME_SETUP_REQUIRED") extra.themeEditorDeepLink = details.themeEditorDeepLink;
       const saved = "commerceCorrectionSaved" in details && details.commerceCorrectionSaved === true;
       if (saved) extra.commerceCorrectionSaved = true;
       const message = resolveMessage(body.code, void 0);
@@ -19321,7 +19447,7 @@ var TikTokInput = z75.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. 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. 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) => {
     try {
       const parsed = parseShopifyInput(input);
       if (parsed.publicationMode === "existing" && !parsed.targetProductId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "6.8.2",
+  "version": "6.9.1",
   "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.",