@productmaker/mcp 0.9.0 → 0.11.0

package/dist/http.js

@@ -391,106 +391,6 @@ __name(sleep, "sleep");
 
 // src/errors.ts
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-var McpErrorCode = {
-  INVALID_API_KEY: "INVALID_API_KEY",
-  REVOKED_API_KEY: "REVOKED_API_KEY",
-  RATE_LIMITED: "RATE_LIMITED",
-  INVALID_INPUT: "INVALID_INPUT",
-  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
-  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
-  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
-  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
-  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
-  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
-  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
-  TASK_NOT_FOUND: "TASK_NOT_FOUND",
-  TASK_NOT_READY: "TASK_NOT_READY",
-  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
-  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
-  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
-  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
-  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
-  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
-  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
-  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
-  INTERNAL: "INTERNAL"
-};
-var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
-  McpErrorCode.INVALID_INPUT,
-  McpErrorCode.INVALID_API_KEY,
-  McpErrorCode.REVOKED_API_KEY,
-  McpErrorCode.IMAGE_PATH_NOT_FOUND,
-  McpErrorCode.IMAGE_PATH_NOT_READABLE,
-  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
-  // The caller passed a campaignId that does not exist — semantically a
-  // bad parameter, not an internal failure. Matches the spec contract
-  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
-  McpErrorCode.CAMPAIGN_NOT_FOUND
-]);
-function mcp(code, message, extra = {}) {
-  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
-  return new McpError(errCode, message, {
-    code,
-    ...extra
-  });
-}
-__name(mcp, "mcp");
-var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
-  "META_CAPABILITY_MISSING",
-  "NO_SHOPIFY_SHOPS",
-  "NO_META_AD_ACCOUNTS",
-  "SHOPIFY_NOT_CONNECTED",
-  "TIKTOK_NOT_CONNECTED",
-  "REVOKED_API_KEY",
-  "CAMPAIGN_NOT_FOUND"
-]);
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-__name(isRecord, "isRecord");
-function translateError(err) {
-  if (err instanceof ResolveImageError) {
-    return mcp(McpErrorCode[err.code], err.message);
-  }
-  if (err instanceof ApiHttpError) {
-    const body = isRecord(err.body) ? err.body : {};
-    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
-      return mcp(body.code, String(body.message ?? body.code), {
-        ...body.helpUrl ? {
-          helpUrl: body.helpUrl
-        } : {}
-      });
-    }
-    if (err.status === 401) {
-      return mcp(McpErrorCode.INVALID_API_KEY, "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.");
-    }
-    if (err.status === 429) {
-      return mcp(McpErrorCode.RATE_LIMITED, "Demasiadas solicitudes. Espera unos segundos.", {
-        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
-      });
-    }
-    if (err.status === 400) {
-      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : "Entrada inv\xE1lida.");
-    }
-    if (err.status === 404) {
-      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
-      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, "Recurso no encontrado.");
-    }
-    if (err.status === 409) {
-      return mcp(McpErrorCode.TASK_NOT_READY, "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n.");
-    }
-    if (err.status >= 500) {
-      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.");
-    }
-    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
-  }
-  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
-    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, "Tiempo de espera agotado.");
-  }
-  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : "Error interno.");
-}
-__name(translateError, "translateError");
 
 // src/tools/shared.ts
 import { z } from "zod";
@@ -582,6 +482,10 @@ function resolveVideoTier(tier) {
   return tier === "basic" ? "grok" : "standard";
 }
 __name(resolveVideoTier, "resolveVideoTier");
+var VideoResolutionEnum = z.enum([
+  "480p",
+  "720p"
+]);
 var VideoStyleEnum = z.enum([
   "ugc",
   "cartoon_3d",
@@ -678,6 +582,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isRecord, "isRecord");
 function escapeMdLabel(s) {
   return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
 }
@@ -714,6 +622,341 @@ async function submitCreative(api, opts) {
 }
 __name(submitCreative, "submitCreative");
 
+// src/errors.ts
+var McpErrorCode = {
+  // Auth / API key
+  INVALID_API_KEY: "INVALID_API_KEY",
+  REVOKED_API_KEY: "REVOKED_API_KEY",
+  // Rate limit / quota
+  RATE_LIMITED: "RATE_LIMITED",
+  // Input
+  INVALID_INPUT: "INVALID_INPUT",
+  // Image upload (MCP-local)
+  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
+  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
+  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
+  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
+  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
+  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
+  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
+  // Task lifecycle
+  TASK_NOT_FOUND: "TASK_NOT_FOUND",
+  TASK_NOT_READY: "TASK_NOT_READY",
+  // Connection presence
+  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
+  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
+  // Campaigns (shared Meta + TikTok)
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
+  CAMPAIGN_TASK_NOT_FOUND: "CAMPAIGN_TASK_NOT_FOUND",
+  CAMPAIGN_MISSING_LANDING_URL: "CAMPAIGN_MISSING_LANDING_URL",
+  CAMPAIGN_NO_CREATIVES: "CAMPAIGN_NO_CREATIVES",
+  CAMPAIGN_MISSING_THUMBNAILS: "CAMPAIGN_MISSING_THUMBNAILS",
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
+  SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
+  SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  // Meta / Facebook Ads
+  META_NO_FB_PAGE: "META_NO_FB_PAGE",
+  META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
+  META_NO_ASSETS_READY: "META_NO_ASSETS_READY",
+  META_NO_THUMBNAIL_SOURCE: "META_NO_THUMBNAIL_SOURCE",
+  META_NO_LANDING_URL: "META_NO_LANDING_URL",
+  META_TASK_NOT_FOUND: "META_TASK_NOT_FOUND",
+  META_INVALID_DATA: "META_INVALID_DATA",
+  META_INVALID_AD_ACCOUNT: "META_INVALID_AD_ACCOUNT",
+  META_MISSING_PAYMENT: "META_MISSING_PAYMENT",
+  META_TOKEN_EXPIRED: "META_TOKEN_EXPIRED",
+  META_ACCOUNT_RESTRICTED: "META_ACCOUNT_RESTRICTED",
+  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  META_PERMISSION_DENIED: "META_PERMISSION_DENIED",
+  META_PIXEL_NOT_FOUND: "META_PIXEL_NOT_FOUND",
+  META_OBJECT_NOT_FOUND: "META_OBJECT_NOT_FOUND",
+  META_AI_DISCLOSURE_REQUIRED: "META_AI_DISCLOSURE_REQUIRED",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "META_BID_STRATEGY_REQUIRES_AMOUNT",
+  META_CBO_BUDGET_CONFLICT: "META_CBO_BUDGET_CONFLICT",
+  META_BUDGET_MODE_CONFLICT: "META_BUDGET_MODE_CONFLICT",
+  META_AD_SET_BUDGET_REQUIRED: "META_AD_SET_BUDGET_REQUIRED",
+  META_DAILY_BUDGET_TOO_HIGH: "META_DAILY_BUDGET_TOO_HIGH",
+  META_CAMPAIGN_CONFIG_INVALID: "META_CAMPAIGN_CONFIG_INVALID",
+  META_WHATSAPP_DESTINATION_DISABLED: "META_WHATSAPP_DESTINATION_DISABLED",
+  // TikTok Ads
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
+  TIKTOK_TOKEN_EXPIRED: "TIKTOK_TOKEN_EXPIRED",
+  TIKTOK_PERMISSION_DENIED: "TIKTOK_PERMISSION_DENIED",
+  TIKTOK_MISSING_PAYMENT: "TIKTOK_MISSING_PAYMENT",
+  TIKTOK_PIXEL_NOT_FOUND: "TIKTOK_PIXEL_NOT_FOUND",
+  TIKTOK_INVALID_ADVERTISER: "TIKTOK_INVALID_ADVERTISER",
+  TIKTOK_ADVERTISER_REQUIRED: "TIKTOK_ADVERTISER_REQUIRED",
+  TIKTOK_IDENTITY_REQUIRED: "TIKTOK_IDENTITY_REQUIRED",
+  TIKTOK_IDENTITY_API_REQUIRED: "TIKTOK_IDENTITY_API_REQUIRED",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TIKTOK_VIDEO_UPLOAD_FAILED",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "TIKTOK_VIDEO_UPLOAD_TIMEOUT",
+  TIKTOK_RATE_LIMITED: "TIKTOK_RATE_LIMITED",
+  TIKTOK_SERVER_ERROR: "TIKTOK_SERVER_ERROR",
+  TIKTOK_INVALID_DATA: "TIKTOK_INVALID_DATA",
+  // Generic transport / catch-all
+  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
+  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CODE_MESSAGES = {
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "No tienes ninguna tienda Shopify conectada. Conecta una en https://productmaker.app/integrations antes de publicar.",
+  SHOPIFY_TOKEN_EXPIRED: "La sesi\xF3n con Shopify expir\xF3. Reconecta la tienda en https://productmaker.app/integrations.",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "La conexi\xF3n con Shopify necesita permisos adicionales. Recon\xE9ctala en https://productmaker.app/integrations para aprobar los nuevos permisos.",
+  SHOPIFY_PUBLISH_FAILED: "Shopify rechaz\xF3 la publicaci\xF3n. Verifica que el producto/landing no exista ya en la tienda y que tu plan permita publicar m\xE1s productos.",
+  // Meta — high-frequency
+  META_NO_FB_PAGE: "No encontramos una P\xE1gina de Facebook asociada a tu cuenta. Crea una en https://www.facebook.com/pages/create antes de publicar (Meta exige una Page para correr ads).",
+  META_NO_ADS_CREATED: "No se pudieron crear los ads. Lo m\xE1s probable: la cuenta de Meta Ads no tiene m\xE9todo de pago, falta vincular una P\xE1gina, o la app de Facebook perdi\xF3 permisos. Verifica los tres en https://business.facebook.com.",
+  META_NO_ASSETS_READY: "La tarea a\xFAn no tiene videos ni ad creative listos para publicar. Espera a que termine la generaci\xF3n o regenera los assets.",
+  META_NO_THUMBNAIL_SOURCE: "No hay imagen disponible para usar de portada del video. Sube una imagen de producto o genera el ad creative antes de publicar.",
+  META_NO_LANDING_URL: "Falta la URL de la landing. P\xE1sala en `landingUrl` o publica primero a Shopify con `publish_to_shopify`.",
+  META_TASK_NOT_FOUND: "La tarea no existe o no pertenece a este usuario. Verifica el `taskId`.",
+  META_INVALID_DATA: "Meta rechaz\xF3 la solicitud por datos inv\xE1lidos. Verifica que `adAccountId` y `pixelId` sean correctos.",
+  META_INVALID_AD_ACCOUNT: "La cuenta publicitaria no existe o no tienes acceso. Confirma el `adAccountId` con `list_meta_ad_accounts`.",
+  META_MISSING_PAYMENT: "Tu cuenta de Meta Ads no tiene m\xE9todo de pago configurado. Visita https://business.facebook.com/billing_hub/payment_settings, selecciona la cuenta publicitaria y agrega una tarjeta antes de reintentar.",
+  META_TOKEN_EXPIRED: "Tu sesi\xF3n con Meta expir\xF3. Reconecta Facebook en https://productmaker.app/integrations.",
+  META_ACCOUNT_RESTRICTED: "Tu cuenta de Meta Ads est\xE1 temporalmente restringida para crear anuncios. Revisa avisos en https://business.facebook.com y completa la verificaci\xF3n requerida.",
+  META_CAPABILITY_MISSING: "Tu app de Facebook no tiene los permisos requeridos para esta cuenta publicitaria. Reconecta Facebook en https://productmaker.app/integrations y acepta TODOS los permisos solicitados (incluyendo business_management).",
+  META_PERMISSION_DENIED: "Tu conexi\xF3n de Facebook no tiene los permisos suficientes. Recon\xE9ctala en https://productmaker.app/integrations y acepta todos los permisos.",
+  META_PIXEL_NOT_FOUND: "El Pixel no existe o no est\xE1 asociado a la cuenta publicitaria. Verifica el `pixelId` en https://business.facebook.com/events_manager.",
+  META_OBJECT_NOT_FOUND: "El objeto solicitado (campa\xF1a/ad set/ad) no existe en Meta. Verifica el ID o crea uno nuevo.",
+  META_AI_DISCLOSURE_REQUIRED: "Meta rechaz\xF3 el ad por contenido IA no declarado. El sistema agrega la divulgaci\xF3n autom\xE1ticamente; si persiste, edita la copy para evitar lenguaje que Meta marque como enga\xF1oso.",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "Meta requiere un monto de puja expl\xEDcito para esta cuenta/presupuesto. Sube el presupuesto diario o desactiva las pujas con tope a nivel cuenta.",
+  META_CBO_BUDGET_CONFLICT: "Conflicto de presupuesto entre la campa\xF1a (CBO) y el ad set. No se puede mezclar.",
+  META_BUDGET_MODE_CONFLICT: "Meta recibi\xF3 presupuesto a nivel campa\xF1a Y a nivel ad set. Define s\xF3lo uno.",
+  META_AD_SET_BUDGET_REQUIRED: "Esta configuraci\xF3n de campa\xF1a requiere presupuesto a nivel ad set, no a nivel campa\xF1a.",
+  META_DAILY_BUDGET_TOO_HIGH: "El presupuesto diario excede el m\xE1ximo permitido por Meta para tu cuenta. B\xE1jalo y reintenta.",
+  META_CAMPAIGN_CONFIG_INVALID: "La configuraci\xF3n de la campa\xF1a es inv\xE1lida. Verifica `dailyBudgetUsd`, `targetCountries` y `campaignName`.",
+  META_WHATSAPP_DESTINATION_DISABLED: "El destino WhatsApp no est\xE1 habilitado para esta cuenta de Meta. Cambia el destino del ad o habilita WhatsApp Business en la cuenta.",
+  // TikTok
+  TIKTOK_NOT_CONNECTED: "No tienes TikTok Ads conectado. Con\xE9ctalo en https://productmaker.app/integrations.",
+  TIKTOK_TOKEN_EXPIRED: "La sesi\xF3n con TikTok expir\xF3. Recon\xE9ctalo en https://productmaker.app/integrations.",
+  TIKTOK_PERMISSION_DENIED: "Tu conexi\xF3n de TikTok no tiene los permisos suficientes. Recon\xE9ctala y acepta todos los permisos solicitados.",
+  TIKTOK_MISSING_PAYMENT: "Tu cuenta de TikTok Ads no tiene m\xE9todo de pago configurado. Agrega uno en https://ads.tiktok.com.",
+  TIKTOK_PIXEL_NOT_FOUND: "El Pixel de TikTok no existe o no est\xE1 asociado al advertiser. Verifica el `pixelId`.",
+  TIKTOK_INVALID_ADVERTISER: "El advertiser no existe o no tienes acceso. Confirma el `advertiserId` con `list_tiktok_advertisers`.",
+  TIKTOK_ADVERTISER_REQUIRED: "Falta el `advertiserId`. Obt\xE9n uno con `list_tiktok_advertisers` antes de publicar.",
+  TIKTOK_IDENTITY_REQUIRED: "TikTok requiere una identidad (perfil del anunciante) para publicar. Crea una en https://ads.tiktok.com.",
+  TIKTOK_IDENTITY_API_REQUIRED: "TikTok requiere habilitar la API de identidades en tu cuenta. Contacta a TikTok Ads Support.",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TikTok rechaz\xF3 la subida del video. Verifica que el formato sea MP4 < 500MB.",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "La subida del video a TikTok se demor\xF3 demasiado. Reintenta en unos minutos.",
+  TIKTOK_RATE_LIMITED: "TikTok limit\xF3 las solicitudes. Espera unos minutos antes de reintentar.",
+  TIKTOK_SERVER_ERROR: "TikTok devolvi\xF3 un error de servidor. Reintenta en unos minutos.",
+  TIKTOK_INVALID_DATA: "TikTok rechaz\xF3 la solicitud por datos inv\xE1lidos. Verifica `advertiserId`, `pixelId` y `campaignConfig`.",
+  // Campaign (shared)
+  CAMPAIGN_NOT_FOUND: "La campa\xF1a no existe o no pertenece a este usuario. Verifica el `campaignId`.",
+  CAMPAIGN_TASK_NOT_FOUND: "La tarea de la campa\xF1a no existe. Verifica el `taskId`.",
+  CAMPAIGN_MISSING_LANDING_URL: "Falta la URL de la landing en la campa\xF1a. Publica primero a Shopify o pasa `landingUrl` expl\xEDcitamente.",
+  CAMPAIGN_NO_CREATIVES: "La tarea no tiene creativos (video/imagen) listos para la campa\xF1a. Espera a que termine la generaci\xF3n.",
+  CAMPAIGN_MISSING_THUMBNAILS: "Faltan miniaturas para los videos. Verifica que la generaci\xF3n de imagen/video haya terminado.",
+  // Connections
+  NO_SHOPIFY_SHOPS: "No hay tiendas Shopify conectadas. Conecta una en https://productmaker.app/integrations.",
+  NO_META_AD_ACCOUNTS: "No hay cuentas de Meta Ads conectadas. Conecta Facebook en https://productmaker.app/integrations.",
+  // Task lifecycle
+  TASK_NOT_FOUND: "La tarea no existe o no pertenece a este usuario. Verifica el `taskId`.",
+  TASK_NOT_READY: "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n. Espera a que termine y reintenta.",
+  // API key
+  INVALID_API_KEY: "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.",
+  REVOKED_API_KEY: "API key revocada. Genera una nueva en https://productmaker.app/account/api-keys.",
+  // Rate
+  RATE_LIMITED: "Demasiadas solicitudes. Espera unos segundos.",
+  // Generic
+  UPSTREAM_UNAVAILABLE: "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.",
+  UPSTREAM_TIMEOUT: "Tiempo de espera agotado. Reintenta en un momento.",
+  INTERNAL: "Error interno.",
+  INVALID_INPUT: "Entrada inv\xE1lida."
+};
+var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
+  // Input/auth
+  McpErrorCode.INVALID_INPUT,
+  McpErrorCode.INVALID_API_KEY,
+  McpErrorCode.REVOKED_API_KEY,
+  McpErrorCode.IMAGE_PATH_NOT_FOUND,
+  McpErrorCode.IMAGE_PATH_NOT_READABLE,
+  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // Identifier mismatches
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.TASK_NOT_FOUND,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  // Validation-shape backend errors (data-level rejection)
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Out-of-band user-resolvable auth/billing/connection — caller fixes by
+  // going to Facebook/TikTok/Shopify and reconnecting, finishing
+  // verification, or adding a payment method. None of these are transient,
+  // so InternalError would mislead the agent into retrying blindly.
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS
+]);
+var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  // Shopify
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  // Meta
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.META_NO_ADS_CREATED,
+  McpErrorCode.META_NO_ASSETS_READY,
+  McpErrorCode.META_NO_THUMBNAIL_SOURCE,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.META_AI_DISCLOSURE_REQUIRED,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_WHATSAPP_DESTINATION_DISABLED,
+  // TikTok
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_FAILED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_TIMEOUT,
+  McpErrorCode.TIKTOK_RATE_LIMITED,
+  McpErrorCode.TIKTOK_SERVER_ERROR,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Campaign (shared)
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.CAMPAIGN_NO_CREATIVES,
+  McpErrorCode.CAMPAIGN_MISSING_THUMBNAILS,
+  // Connections
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS,
+  // Auth
+  McpErrorCode.REVOKED_API_KEY
+]);
+function mcp(code, message, extra = {}) {
+  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
+  return new McpError(errCode, message, {
+    code,
+    ...extra
+  });
+}
+__name(mcp, "mcp");
+var GENERIC_BACKEND_MESSAGES = /* @__PURE__ */ new Set([
+  "No ads could be created for the campaign.",
+  "No assets could be created for the campaign.",
+  "Invalid data provided to Meta API",
+  "Insufficient permissions for Meta account",
+  "Meta session has expired",
+  "Meta Ads account has no payment method configured"
+]);
+function looksLikeMeaningfulBackendMessage(message, mapped) {
+  if (!message || message.length === 0) return false;
+  if (GENERIC_BACKEND_MESSAGES.has(message)) return false;
+  const norm = /* @__PURE__ */ __name((s) => s.toLowerCase().replace(/[.\s]+$/, ""), "norm");
+  if (norm(mapped).includes(norm(message))) return false;
+  return true;
+}
+__name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
+function resolveMessage(code, backendMessage) {
+  const mapped = CODE_MESSAGES[code];
+  const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
+    return `${mapped} (Detalle: ${backend})`;
+  }
+  if (mapped) return mapped;
+  if (backend) return backend;
+  return `El servicio devolvi\xF3 un error (c\xF3digo: ${code}). Intenta de nuevo en un momento o contacta soporte si persiste.`;
+}
+__name(resolveMessage, "resolveMessage");
+function translateError(err) {
+  if (err instanceof ResolveImageError) {
+    return mcp(McpErrorCode[err.code], err.message);
+  }
+  if (err instanceof ApiHttpError) {
+    const body = isRecord(err.body) ? err.body : {};
+    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
+      const code = body.code;
+      return mcp(code, resolveMessage(code, body.message), {
+        ...body.helpUrl ? {
+          helpUrl: body.helpUrl
+        } : {}
+      });
+    }
+    if (err.status === 401) {
+      return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
+    }
+    if (err.status === 429) {
+      return mcp(McpErrorCode.RATE_LIMITED, resolveMessage(McpErrorCode.RATE_LIMITED, void 0), {
+        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
+      });
+    }
+    if (err.status === 400) {
+      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : resolveMessage(McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 404) {
+      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
+      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, resolveMessage(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 409) {
+      return mcp(McpErrorCode.TASK_NOT_READY, resolveMessage(McpErrorCode.TASK_NOT_READY, void 0));
+    }
+    if (err.status >= 500) {
+      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, resolveMessage(McpErrorCode.UPSTREAM_UNAVAILABLE, void 0));
+    }
+    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
+  }
+  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
+    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, resolveMessage(McpErrorCode.UPSTREAM_TIMEOUT, void 0));
+  }
+  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : resolveMessage(McpErrorCode.INTERNAL, void 0));
+}
+__name(translateError, "translateError");
+
 // src/asset-proxy.ts
 import { createHmac, timingSafeEqual } from "crypto";
 var TOKEN_TTL_SECONDS = 3600;
@@ -931,6 +1174,7 @@ var CreateProductTaskInput = z2.object({
   offer: z2.string().optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Opciones: "auto", "ugc_dynamic" (UGC testimonial), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones, ideal 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, ideal 30s), "ugc_demo_review" (demo en uso), "problem_solution" (problema\u2192producto\u2192CTA), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla), "product_showcase" (solo producto, sin actor), "wearable_showcase" (ropa/accesorios puestos). Si el usuario pide algo fuera de esta lista (ej. "estilo anime"), p\xEDdele una opci\xF3n v\xE1lida.'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video (en la web la etiqueta es "\xBFCalidad de video?", 2 opciones \u2014 sin escalera de calidad, son ESTILOS distintos). "basic" = "Realista" (RECOMENDADO por la web): render de 15s con audio nativo, el m\xE1s natural \u2014 S\xD3LO v\xE1lido si la duraci\xF3n del video es 15s. "standard" = "Multiescena": m\xFAltiples tomas, hasta 30s. Si el usuario no menciona estilo, OMITE este campo y el backend usa su default. Para duraci\xF3n 30s s\xF3lo aplica "standard" (Realista est\xE1 vetada).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render \u2014 aplica S\xD3LO al tier "basic" (Realista); "standard" la deriva solo. En la web se pregunta "\xBFResoluci\xF3n del video?" tras elegir "basic". "720p" = m\xE1xima nitidez (default si se omite); "480p" = m\xE1s econ\xF3mico (~la mitad del precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p para basic).'),
   multiAngleVideos: z2.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
   angleNarratives: NarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional, override avanzado). Usa los mismos identificadores de narrativa que videoPreset (ej. "animated_problem_pixar", "review", "ugc_skeptic_confession"). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan seg\xFAn el producto.'),
   outputs: z2.array(z2.enum([
@@ -1015,6 +1259,11 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.videoStyle": resolved?.videoStyle,
         "options.narrativeStyle": resolved?.narrativeStyle,
         "options.videoTier": wireTier,
+        // Resolution is meaningful ONLY for the basic/grok tier; for every
+        // other tier the backend derives it. Forward it ONLY for grok so the
+        // MCP never presents a "user choice where there is none" (the web has
+        // no resolution knob for standard) — for non-grok it's dropped.
+        "options.videoResolution": wireTier === "grok" ? input.videoResolution : void 0,
         "options.multiAngleVideos": input.multiAngleVideos,
         "options.angleNarratives": input.angleNarratives,
         "options.selectedOutputs": input.outputs,
@@ -1173,6 +1422,7 @@ var VideoInput = z3.object({
   durationSeconds: z3.number().int().min(5).max(60).optional().describe("Opcional. Duraci\xF3n del video en segundos (5-60). Default 15s. Para hooks cortos usa 8, para storytelling usa 30."),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Opciones: "auto", "ugc_dynamic" (UGC cl\xE1sico testimonial multi-hook), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones numeradas, recomendado 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, recomendado 30s), "ugc_demo_review" (demo en uso a lo largo de d\xEDas), "problem_solution" (problema\u2192producto\u2192CTA), "pixar_problem" (problema animado 3D estilo Pixar), "pixar_sassy" (producto que habla con personalidad), "product_showcase" (sin actor, solo producto), "wearable_showcase" (ropa/accesorios puestos).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video (en la web la etiqueta es "\xBFCalidad de video?", 2 opciones \u2014 sin escalera de calidad, son ESTILOS distintos). "basic" = "Realista" (RECOMENDADO por la web): render de 15s con audio nativo, el m\xE1s natural \u2014 S\xD3LO v\xE1lido cuando durationSeconds \u2264 15 (el handler lo valida). "standard" = "Multiescena": m\xFAltiples tomas, hasta 30s. Si la duraci\xF3n es 30s, s\xF3lo aplica "standard". Si el usuario no menciona estilo, OMITE este campo y el backend usa su default.'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render \u2014 aplica S\xD3LO al tier "basic" (Realista); el tier "standard" la deriva solo. En la web se pregunta "\xBFResoluci\xF3n del video?" tras elegir "basic". "720p" = m\xE1xima nitidez (default si se omite); "480p" = m\xE1s econ\xF3mico (~la mitad del precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p para basic).'),
   features: z3.array(z3.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
   price: CreativeRefs.price,
   offer: CreativeRefs.offer,
@@ -1226,7 +1476,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       }
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveVideoTier(input.videoTier);
-      const { videoTier: _publicTier, ...rest } = input;
+      const { videoTier: _publicTier, videoResolution: _vr, ...rest } = input;
       const wirePayload = {
         ...rest
       };
@@ -1235,6 +1485,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
         wirePayload.narrativeStyle = resolved.narrativeStyle;
       }
       if (wireTier !== void 0) wirePayload.videoTier = wireTier;
+      if (wireTier === "grok" && input.videoResolution) wirePayload.videoResolution = input.videoResolution;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
@@ -1365,7 +1616,11 @@ import { z as z6 } from "zod";
 var ShopifyInput = z6.object({
   taskId: z6.string().min(1),
   shopDomain: z6.string().min(1),
-  numLandingImages: z6.number().int().min(1).max(7).optional(),
+  /** Override: number of landing images to include. Default = ALL images the
+  *  task generated (the MCP fetches /v1/results first to count). Bounded
+  *  generously here; the backend validates each index against
+  *  landing.images.length and rejects out-of-range. */
+  numLandingImages: z6.number().int().min(1).max(20).optional(),
   variantIndex: z6.number().int().min(0).optional(),
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
@@ -1398,10 +1653,12 @@ var TikTokInput = z6.object({
   campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
-      const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
+      const availableImages = await fetchLandingImageCount(api, input.taskId);
+      const effectiveAvailable = availableImages > 0 ? availableImages : 3;
+      const numImages = Math.min(input.numLandingImages ?? effectiveAvailable, effectiveAvailable);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -1478,6 +1735,19 @@ function renderShopifyPublishMarkdown(r) {
   };
 }
 __name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+async function fetchLandingImageCount(api, taskId) {
+  try {
+    const r = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}`);
+    if (!isRecord(r)) return 0;
+    const landing = r.landing;
+    if (!isRecord(landing)) return 0;
+    const images = landing.images;
+    return Array.isArray(images) ? images.length : 0;
+  } catch {
+    return 0;
+  }
+}
+__name(fetchLandingImageCount, "fetchLandingImageCount");
 function toMetaCampaignOverrides(cfg) {
   const out = {};
   if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;

package/dist/stdio.js

@@ -388,106 +388,6 @@ __name(sleep, "sleep");
 
 // src/errors.ts
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-var McpErrorCode = {
-  INVALID_API_KEY: "INVALID_API_KEY",
-  REVOKED_API_KEY: "REVOKED_API_KEY",
-  RATE_LIMITED: "RATE_LIMITED",
-  INVALID_INPUT: "INVALID_INPUT",
-  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
-  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
-  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
-  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
-  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
-  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
-  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
-  TASK_NOT_FOUND: "TASK_NOT_FOUND",
-  TASK_NOT_READY: "TASK_NOT_READY",
-  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
-  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
-  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
-  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
-  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
-  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
-  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
-  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
-  INTERNAL: "INTERNAL"
-};
-var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
-  McpErrorCode.INVALID_INPUT,
-  McpErrorCode.INVALID_API_KEY,
-  McpErrorCode.REVOKED_API_KEY,
-  McpErrorCode.IMAGE_PATH_NOT_FOUND,
-  McpErrorCode.IMAGE_PATH_NOT_READABLE,
-  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
-  // The caller passed a campaignId that does not exist — semantically a
-  // bad parameter, not an internal failure. Matches the spec contract
-  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
-  McpErrorCode.CAMPAIGN_NOT_FOUND
-]);
-function mcp(code, message, extra = {}) {
-  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
-  return new McpError(errCode, message, {
-    code,
-    ...extra
-  });
-}
-__name(mcp, "mcp");
-var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
-  "META_CAPABILITY_MISSING",
-  "NO_SHOPIFY_SHOPS",
-  "NO_META_AD_ACCOUNTS",
-  "SHOPIFY_NOT_CONNECTED",
-  "TIKTOK_NOT_CONNECTED",
-  "REVOKED_API_KEY",
-  "CAMPAIGN_NOT_FOUND"
-]);
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-__name(isRecord, "isRecord");
-function translateError(err) {
-  if (err instanceof ResolveImageError) {
-    return mcp(McpErrorCode[err.code], err.message);
-  }
-  if (err instanceof ApiHttpError) {
-    const body = isRecord(err.body) ? err.body : {};
-    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
-      return mcp(body.code, String(body.message ?? body.code), {
-        ...body.helpUrl ? {
-          helpUrl: body.helpUrl
-        } : {}
-      });
-    }
-    if (err.status === 401) {
-      return mcp(McpErrorCode.INVALID_API_KEY, "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.");
-    }
-    if (err.status === 429) {
-      return mcp(McpErrorCode.RATE_LIMITED, "Demasiadas solicitudes. Espera unos segundos.", {
-        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
-      });
-    }
-    if (err.status === 400) {
-      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : "Entrada inv\xE1lida.");
-    }
-    if (err.status === 404) {
-      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
-      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, "Recurso no encontrado.");
-    }
-    if (err.status === 409) {
-      return mcp(McpErrorCode.TASK_NOT_READY, "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n.");
-    }
-    if (err.status >= 500) {
-      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.");
-    }
-    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
-  }
-  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
-    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, "Tiempo de espera agotado.");
-  }
-  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : "Error interno.");
-}
-__name(translateError, "translateError");
 
 // src/tools/shared.ts
 import { z } from "zod";
@@ -579,6 +479,10 @@ function resolveVideoTier(tier) {
   return tier === "basic" ? "grok" : "standard";
 }
 __name(resolveVideoTier, "resolveVideoTier");
+var VideoResolutionEnum = z.enum([
+  "480p",
+  "720p"
+]);
 var VideoStyleEnum = z.enum([
   "ugc",
   "cartoon_3d",
@@ -675,6 +579,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isRecord, "isRecord");
 function escapeMdLabel(s) {
   return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
 }
@@ -711,6 +619,341 @@ async function submitCreative(api, opts) {
 }
 __name(submitCreative, "submitCreative");
 
+// src/errors.ts
+var McpErrorCode = {
+  // Auth / API key
+  INVALID_API_KEY: "INVALID_API_KEY",
+  REVOKED_API_KEY: "REVOKED_API_KEY",
+  // Rate limit / quota
+  RATE_LIMITED: "RATE_LIMITED",
+  // Input
+  INVALID_INPUT: "INVALID_INPUT",
+  // Image upload (MCP-local)
+  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
+  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
+  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
+  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
+  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
+  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
+  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
+  // Task lifecycle
+  TASK_NOT_FOUND: "TASK_NOT_FOUND",
+  TASK_NOT_READY: "TASK_NOT_READY",
+  // Connection presence
+  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
+  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
+  // Campaigns (shared Meta + TikTok)
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
+  CAMPAIGN_TASK_NOT_FOUND: "CAMPAIGN_TASK_NOT_FOUND",
+  CAMPAIGN_MISSING_LANDING_URL: "CAMPAIGN_MISSING_LANDING_URL",
+  CAMPAIGN_NO_CREATIVES: "CAMPAIGN_NO_CREATIVES",
+  CAMPAIGN_MISSING_THUMBNAILS: "CAMPAIGN_MISSING_THUMBNAILS",
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
+  SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
+  SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  // Meta / Facebook Ads
+  META_NO_FB_PAGE: "META_NO_FB_PAGE",
+  META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
+  META_NO_ASSETS_READY: "META_NO_ASSETS_READY",
+  META_NO_THUMBNAIL_SOURCE: "META_NO_THUMBNAIL_SOURCE",
+  META_NO_LANDING_URL: "META_NO_LANDING_URL",
+  META_TASK_NOT_FOUND: "META_TASK_NOT_FOUND",
+  META_INVALID_DATA: "META_INVALID_DATA",
+  META_INVALID_AD_ACCOUNT: "META_INVALID_AD_ACCOUNT",
+  META_MISSING_PAYMENT: "META_MISSING_PAYMENT",
+  META_TOKEN_EXPIRED: "META_TOKEN_EXPIRED",
+  META_ACCOUNT_RESTRICTED: "META_ACCOUNT_RESTRICTED",
+  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  META_PERMISSION_DENIED: "META_PERMISSION_DENIED",
+  META_PIXEL_NOT_FOUND: "META_PIXEL_NOT_FOUND",
+  META_OBJECT_NOT_FOUND: "META_OBJECT_NOT_FOUND",
+  META_AI_DISCLOSURE_REQUIRED: "META_AI_DISCLOSURE_REQUIRED",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "META_BID_STRATEGY_REQUIRES_AMOUNT",
+  META_CBO_BUDGET_CONFLICT: "META_CBO_BUDGET_CONFLICT",
+  META_BUDGET_MODE_CONFLICT: "META_BUDGET_MODE_CONFLICT",
+  META_AD_SET_BUDGET_REQUIRED: "META_AD_SET_BUDGET_REQUIRED",
+  META_DAILY_BUDGET_TOO_HIGH: "META_DAILY_BUDGET_TOO_HIGH",
+  META_CAMPAIGN_CONFIG_INVALID: "META_CAMPAIGN_CONFIG_INVALID",
+  META_WHATSAPP_DESTINATION_DISABLED: "META_WHATSAPP_DESTINATION_DISABLED",
+  // TikTok Ads
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
+  TIKTOK_TOKEN_EXPIRED: "TIKTOK_TOKEN_EXPIRED",
+  TIKTOK_PERMISSION_DENIED: "TIKTOK_PERMISSION_DENIED",
+  TIKTOK_MISSING_PAYMENT: "TIKTOK_MISSING_PAYMENT",
+  TIKTOK_PIXEL_NOT_FOUND: "TIKTOK_PIXEL_NOT_FOUND",
+  TIKTOK_INVALID_ADVERTISER: "TIKTOK_INVALID_ADVERTISER",
+  TIKTOK_ADVERTISER_REQUIRED: "TIKTOK_ADVERTISER_REQUIRED",
+  TIKTOK_IDENTITY_REQUIRED: "TIKTOK_IDENTITY_REQUIRED",
+  TIKTOK_IDENTITY_API_REQUIRED: "TIKTOK_IDENTITY_API_REQUIRED",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TIKTOK_VIDEO_UPLOAD_FAILED",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "TIKTOK_VIDEO_UPLOAD_TIMEOUT",
+  TIKTOK_RATE_LIMITED: "TIKTOK_RATE_LIMITED",
+  TIKTOK_SERVER_ERROR: "TIKTOK_SERVER_ERROR",
+  TIKTOK_INVALID_DATA: "TIKTOK_INVALID_DATA",
+  // Generic transport / catch-all
+  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
+  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CODE_MESSAGES = {
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "No tienes ninguna tienda Shopify conectada. Conecta una en https://productmaker.app/integrations antes de publicar.",
+  SHOPIFY_TOKEN_EXPIRED: "La sesi\xF3n con Shopify expir\xF3. Reconecta la tienda en https://productmaker.app/integrations.",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "La conexi\xF3n con Shopify necesita permisos adicionales. Recon\xE9ctala en https://productmaker.app/integrations para aprobar los nuevos permisos.",
+  SHOPIFY_PUBLISH_FAILED: "Shopify rechaz\xF3 la publicaci\xF3n. Verifica que el producto/landing no exista ya en la tienda y que tu plan permita publicar m\xE1s productos.",
+  // Meta — high-frequency
+  META_NO_FB_PAGE: "No encontramos una P\xE1gina de Facebook asociada a tu cuenta. Crea una en https://www.facebook.com/pages/create antes de publicar (Meta exige una Page para correr ads).",
+  META_NO_ADS_CREATED: "No se pudieron crear los ads. Lo m\xE1s probable: la cuenta de Meta Ads no tiene m\xE9todo de pago, falta vincular una P\xE1gina, o la app de Facebook perdi\xF3 permisos. Verifica los tres en https://business.facebook.com.",
+  META_NO_ASSETS_READY: "La tarea a\xFAn no tiene videos ni ad creative listos para publicar. Espera a que termine la generaci\xF3n o regenera los assets.",
+  META_NO_THUMBNAIL_SOURCE: "No hay imagen disponible para usar de portada del video. Sube una imagen de producto o genera el ad creative antes de publicar.",
+  META_NO_LANDING_URL: "Falta la URL de la landing. P\xE1sala en `landingUrl` o publica primero a Shopify con `publish_to_shopify`.",
+  META_TASK_NOT_FOUND: "La tarea no existe o no pertenece a este usuario. Verifica el `taskId`.",
+  META_INVALID_DATA: "Meta rechaz\xF3 la solicitud por datos inv\xE1lidos. Verifica que `adAccountId` y `pixelId` sean correctos.",
+  META_INVALID_AD_ACCOUNT: "La cuenta publicitaria no existe o no tienes acceso. Confirma el `adAccountId` con `list_meta_ad_accounts`.",
+  META_MISSING_PAYMENT: "Tu cuenta de Meta Ads no tiene m\xE9todo de pago configurado. Visita https://business.facebook.com/billing_hub/payment_settings, selecciona la cuenta publicitaria y agrega una tarjeta antes de reintentar.",
+  META_TOKEN_EXPIRED: "Tu sesi\xF3n con Meta expir\xF3. Reconecta Facebook en https://productmaker.app/integrations.",
+  META_ACCOUNT_RESTRICTED: "Tu cuenta de Meta Ads est\xE1 temporalmente restringida para crear anuncios. Revisa avisos en https://business.facebook.com y completa la verificaci\xF3n requerida.",
+  META_CAPABILITY_MISSING: "Tu app de Facebook no tiene los permisos requeridos para esta cuenta publicitaria. Reconecta Facebook en https://productmaker.app/integrations y acepta TODOS los permisos solicitados (incluyendo business_management).",
+  META_PERMISSION_DENIED: "Tu conexi\xF3n de Facebook no tiene los permisos suficientes. Recon\xE9ctala en https://productmaker.app/integrations y acepta todos los permisos.",
+  META_PIXEL_NOT_FOUND: "El Pixel no existe o no est\xE1 asociado a la cuenta publicitaria. Verifica el `pixelId` en https://business.facebook.com/events_manager.",
+  META_OBJECT_NOT_FOUND: "El objeto solicitado (campa\xF1a/ad set/ad) no existe en Meta. Verifica el ID o crea uno nuevo.",
+  META_AI_DISCLOSURE_REQUIRED: "Meta rechaz\xF3 el ad por contenido IA no declarado. El sistema agrega la divulgaci\xF3n autom\xE1ticamente; si persiste, edita la copy para evitar lenguaje que Meta marque como enga\xF1oso.",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "Meta requiere un monto de puja expl\xEDcito para esta cuenta/presupuesto. Sube el presupuesto diario o desactiva las pujas con tope a nivel cuenta.",
+  META_CBO_BUDGET_CONFLICT: "Conflicto de presupuesto entre la campa\xF1a (CBO) y el ad set. No se puede mezclar.",
+  META_BUDGET_MODE_CONFLICT: "Meta recibi\xF3 presupuesto a nivel campa\xF1a Y a nivel ad set. Define s\xF3lo uno.",
+  META_AD_SET_BUDGET_REQUIRED: "Esta configuraci\xF3n de campa\xF1a requiere presupuesto a nivel ad set, no a nivel campa\xF1a.",
+  META_DAILY_BUDGET_TOO_HIGH: "El presupuesto diario excede el m\xE1ximo permitido por Meta para tu cuenta. B\xE1jalo y reintenta.",
+  META_CAMPAIGN_CONFIG_INVALID: "La configuraci\xF3n de la campa\xF1a es inv\xE1lida. Verifica `dailyBudgetUsd`, `targetCountries` y `campaignName`.",
+  META_WHATSAPP_DESTINATION_DISABLED: "El destino WhatsApp no est\xE1 habilitado para esta cuenta de Meta. Cambia el destino del ad o habilita WhatsApp Business en la cuenta.",
+  // TikTok
+  TIKTOK_NOT_CONNECTED: "No tienes TikTok Ads conectado. Con\xE9ctalo en https://productmaker.app/integrations.",
+  TIKTOK_TOKEN_EXPIRED: "La sesi\xF3n con TikTok expir\xF3. Recon\xE9ctalo en https://productmaker.app/integrations.",
+  TIKTOK_PERMISSION_DENIED: "Tu conexi\xF3n de TikTok no tiene los permisos suficientes. Recon\xE9ctala y acepta todos los permisos solicitados.",
+  TIKTOK_MISSING_PAYMENT: "Tu cuenta de TikTok Ads no tiene m\xE9todo de pago configurado. Agrega uno en https://ads.tiktok.com.",
+  TIKTOK_PIXEL_NOT_FOUND: "El Pixel de TikTok no existe o no est\xE1 asociado al advertiser. Verifica el `pixelId`.",
+  TIKTOK_INVALID_ADVERTISER: "El advertiser no existe o no tienes acceso. Confirma el `advertiserId` con `list_tiktok_advertisers`.",
+  TIKTOK_ADVERTISER_REQUIRED: "Falta el `advertiserId`. Obt\xE9n uno con `list_tiktok_advertisers` antes de publicar.",
+  TIKTOK_IDENTITY_REQUIRED: "TikTok requiere una identidad (perfil del anunciante) para publicar. Crea una en https://ads.tiktok.com.",
+  TIKTOK_IDENTITY_API_REQUIRED: "TikTok requiere habilitar la API de identidades en tu cuenta. Contacta a TikTok Ads Support.",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TikTok rechaz\xF3 la subida del video. Verifica que el formato sea MP4 < 500MB.",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "La subida del video a TikTok se demor\xF3 demasiado. Reintenta en unos minutos.",
+  TIKTOK_RATE_LIMITED: "TikTok limit\xF3 las solicitudes. Espera unos minutos antes de reintentar.",
+  TIKTOK_SERVER_ERROR: "TikTok devolvi\xF3 un error de servidor. Reintenta en unos minutos.",
+  TIKTOK_INVALID_DATA: "TikTok rechaz\xF3 la solicitud por datos inv\xE1lidos. Verifica `advertiserId`, `pixelId` y `campaignConfig`.",
+  // Campaign (shared)
+  CAMPAIGN_NOT_FOUND: "La campa\xF1a no existe o no pertenece a este usuario. Verifica el `campaignId`.",
+  CAMPAIGN_TASK_NOT_FOUND: "La tarea de la campa\xF1a no existe. Verifica el `taskId`.",
+  CAMPAIGN_MISSING_LANDING_URL: "Falta la URL de la landing en la campa\xF1a. Publica primero a Shopify o pasa `landingUrl` expl\xEDcitamente.",
+  CAMPAIGN_NO_CREATIVES: "La tarea no tiene creativos (video/imagen) listos para la campa\xF1a. Espera a que termine la generaci\xF3n.",
+  CAMPAIGN_MISSING_THUMBNAILS: "Faltan miniaturas para los videos. Verifica que la generaci\xF3n de imagen/video haya terminado.",
+  // Connections
+  NO_SHOPIFY_SHOPS: "No hay tiendas Shopify conectadas. Conecta una en https://productmaker.app/integrations.",
+  NO_META_AD_ACCOUNTS: "No hay cuentas de Meta Ads conectadas. Conecta Facebook en https://productmaker.app/integrations.",
+  // Task lifecycle
+  TASK_NOT_FOUND: "La tarea no existe o no pertenece a este usuario. Verifica el `taskId`.",
+  TASK_NOT_READY: "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n. Espera a que termine y reintenta.",
+  // API key
+  INVALID_API_KEY: "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.",
+  REVOKED_API_KEY: "API key revocada. Genera una nueva en https://productmaker.app/account/api-keys.",
+  // Rate
+  RATE_LIMITED: "Demasiadas solicitudes. Espera unos segundos.",
+  // Generic
+  UPSTREAM_UNAVAILABLE: "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.",
+  UPSTREAM_TIMEOUT: "Tiempo de espera agotado. Reintenta en un momento.",
+  INTERNAL: "Error interno.",
+  INVALID_INPUT: "Entrada inv\xE1lida."
+};
+var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
+  // Input/auth
+  McpErrorCode.INVALID_INPUT,
+  McpErrorCode.INVALID_API_KEY,
+  McpErrorCode.REVOKED_API_KEY,
+  McpErrorCode.IMAGE_PATH_NOT_FOUND,
+  McpErrorCode.IMAGE_PATH_NOT_READABLE,
+  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // Identifier mismatches
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.TASK_NOT_FOUND,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  // Validation-shape backend errors (data-level rejection)
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Out-of-band user-resolvable auth/billing/connection — caller fixes by
+  // going to Facebook/TikTok/Shopify and reconnecting, finishing
+  // verification, or adding a payment method. None of these are transient,
+  // so InternalError would mislead the agent into retrying blindly.
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS
+]);
+var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  // Shopify
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  // Meta
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.META_NO_ADS_CREATED,
+  McpErrorCode.META_NO_ASSETS_READY,
+  McpErrorCode.META_NO_THUMBNAIL_SOURCE,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.META_AI_DISCLOSURE_REQUIRED,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_WHATSAPP_DESTINATION_DISABLED,
+  // TikTok
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_FAILED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_TIMEOUT,
+  McpErrorCode.TIKTOK_RATE_LIMITED,
+  McpErrorCode.TIKTOK_SERVER_ERROR,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Campaign (shared)
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.CAMPAIGN_NO_CREATIVES,
+  McpErrorCode.CAMPAIGN_MISSING_THUMBNAILS,
+  // Connections
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS,
+  // Auth
+  McpErrorCode.REVOKED_API_KEY
+]);
+function mcp(code, message, extra = {}) {
+  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
+  return new McpError(errCode, message, {
+    code,
+    ...extra
+  });
+}
+__name(mcp, "mcp");
+var GENERIC_BACKEND_MESSAGES = /* @__PURE__ */ new Set([
+  "No ads could be created for the campaign.",
+  "No assets could be created for the campaign.",
+  "Invalid data provided to Meta API",
+  "Insufficient permissions for Meta account",
+  "Meta session has expired",
+  "Meta Ads account has no payment method configured"
+]);
+function looksLikeMeaningfulBackendMessage(message, mapped) {
+  if (!message || message.length === 0) return false;
+  if (GENERIC_BACKEND_MESSAGES.has(message)) return false;
+  const norm = /* @__PURE__ */ __name((s) => s.toLowerCase().replace(/[.\s]+$/, ""), "norm");
+  if (norm(mapped).includes(norm(message))) return false;
+  return true;
+}
+__name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
+function resolveMessage(code, backendMessage) {
+  const mapped = CODE_MESSAGES[code];
+  const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
+    return `${mapped} (Detalle: ${backend})`;
+  }
+  if (mapped) return mapped;
+  if (backend) return backend;
+  return `El servicio devolvi\xF3 un error (c\xF3digo: ${code}). Intenta de nuevo en un momento o contacta soporte si persiste.`;
+}
+__name(resolveMessage, "resolveMessage");
+function translateError(err) {
+  if (err instanceof ResolveImageError) {
+    return mcp(McpErrorCode[err.code], err.message);
+  }
+  if (err instanceof ApiHttpError) {
+    const body = isRecord(err.body) ? err.body : {};
+    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
+      const code = body.code;
+      return mcp(code, resolveMessage(code, body.message), {
+        ...body.helpUrl ? {
+          helpUrl: body.helpUrl
+        } : {}
+      });
+    }
+    if (err.status === 401) {
+      return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
+    }
+    if (err.status === 429) {
+      return mcp(McpErrorCode.RATE_LIMITED, resolveMessage(McpErrorCode.RATE_LIMITED, void 0), {
+        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
+      });
+    }
+    if (err.status === 400) {
+      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : resolveMessage(McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 404) {
+      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
+      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, resolveMessage(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 409) {
+      return mcp(McpErrorCode.TASK_NOT_READY, resolveMessage(McpErrorCode.TASK_NOT_READY, void 0));
+    }
+    if (err.status >= 500) {
+      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, resolveMessage(McpErrorCode.UPSTREAM_UNAVAILABLE, void 0));
+    }
+    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
+  }
+  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
+    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, resolveMessage(McpErrorCode.UPSTREAM_TIMEOUT, void 0));
+  }
+  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : resolveMessage(McpErrorCode.INTERNAL, void 0));
+}
+__name(translateError, "translateError");
+
 // src/asset-proxy.ts
 import { createHmac, timingSafeEqual } from "crypto";
 var TOKEN_TTL_SECONDS = 3600;
@@ -887,6 +1130,7 @@ var CreateProductTaskInput = z2.object({
   offer: z2.string().optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Opciones: "auto", "ugc_dynamic" (UGC testimonial), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones, ideal 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, ideal 30s), "ugc_demo_review" (demo en uso), "problem_solution" (problema\u2192producto\u2192CTA), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla), "product_showcase" (solo producto, sin actor), "wearable_showcase" (ropa/accesorios puestos). Si el usuario pide algo fuera de esta lista (ej. "estilo anime"), p\xEDdele una opci\xF3n v\xE1lida.'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video (en la web la etiqueta es "\xBFCalidad de video?", 2 opciones \u2014 sin escalera de calidad, son ESTILOS distintos). "basic" = "Realista" (RECOMENDADO por la web): render de 15s con audio nativo, el m\xE1s natural \u2014 S\xD3LO v\xE1lido si la duraci\xF3n del video es 15s. "standard" = "Multiescena": m\xFAltiples tomas, hasta 30s. Si el usuario no menciona estilo, OMITE este campo y el backend usa su default. Para duraci\xF3n 30s s\xF3lo aplica "standard" (Realista est\xE1 vetada).'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render \u2014 aplica S\xD3LO al tier "basic" (Realista); "standard" la deriva solo. En la web se pregunta "\xBFResoluci\xF3n del video?" tras elegir "basic". "720p" = m\xE1xima nitidez (default si se omite); "480p" = m\xE1s econ\xF3mico (~la mitad del precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p para basic).'),
   multiAngleVideos: z2.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
   angleNarratives: NarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional, override avanzado). Usa los mismos identificadores de narrativa que videoPreset (ej. "animated_problem_pixar", "review", "ugc_skeptic_confession"). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan seg\xFAn el producto.'),
   outputs: z2.array(z2.enum([
@@ -971,6 +1215,11 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.videoStyle": resolved?.videoStyle,
         "options.narrativeStyle": resolved?.narrativeStyle,
         "options.videoTier": wireTier,
+        // Resolution is meaningful ONLY for the basic/grok tier; for every
+        // other tier the backend derives it. Forward it ONLY for grok so the
+        // MCP never presents a "user choice where there is none" (the web has
+        // no resolution knob for standard) — for non-grok it's dropped.
+        "options.videoResolution": wireTier === "grok" ? input.videoResolution : void 0,
         "options.multiAngleVideos": input.multiAngleVideos,
         "options.angleNarratives": input.angleNarratives,
         "options.selectedOutputs": input.outputs,
@@ -1129,6 +1378,7 @@ var VideoInput = z3.object({
   durationSeconds: z3.number().int().min(5).max(60).optional().describe("Opcional. Duraci\xF3n del video en segundos (5-60). Default 15s. Para hooks cortos usa 8, para storytelling usa 30."),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Opciones: "auto", "ugc_dynamic" (UGC cl\xE1sico testimonial multi-hook), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones numeradas, recomendado 30s), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n, recomendado 30s), "ugc_demo_review" (demo en uso a lo largo de d\xEDas), "problem_solution" (problema\u2192producto\u2192CTA), "pixar_problem" (problema animado 3D estilo Pixar), "pixar_sassy" (producto que habla con personalidad), "product_showcase" (sin actor, solo producto), "wearable_showcase" (ropa/accesorios puestos).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video (en la web la etiqueta es "\xBFCalidad de video?", 2 opciones \u2014 sin escalera de calidad, son ESTILOS distintos). "basic" = "Realista" (RECOMENDADO por la web): render de 15s con audio nativo, el m\xE1s natural \u2014 S\xD3LO v\xE1lido cuando durationSeconds \u2264 15 (el handler lo valida). "standard" = "Multiescena": m\xFAltiples tomas, hasta 30s. Si la duraci\xF3n es 30s, s\xF3lo aplica "standard". Si el usuario no menciona estilo, OMITE este campo y el backend usa su default.'),
+  videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render \u2014 aplica S\xD3LO al tier "basic" (Realista); el tier "standard" la deriva solo. En la web se pregunta "\xBFResoluci\xF3n del video?" tras elegir "basic". "720p" = m\xE1xima nitidez (default si se omite); "480p" = m\xE1s econ\xF3mico (~la mitad del precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p para basic).'),
   features: z3.array(z3.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
   price: CreativeRefs.price,
   offer: CreativeRefs.offer,
@@ -1182,7 +1432,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       }
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveVideoTier(input.videoTier);
-      const { videoTier: _publicTier, ...rest } = input;
+      const { videoTier: _publicTier, videoResolution: _vr, ...rest } = input;
       const wirePayload = {
         ...rest
       };
@@ -1191,6 +1441,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
         wirePayload.narrativeStyle = resolved.narrativeStyle;
       }
       if (wireTier !== void 0) wirePayload.videoTier = wireTier;
+      if (wireTier === "grok" && input.videoResolution) wirePayload.videoResolution = input.videoResolution;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
@@ -1321,7 +1572,11 @@ import { z as z6 } from "zod";
 var ShopifyInput = z6.object({
   taskId: z6.string().min(1),
   shopDomain: z6.string().min(1),
-  numLandingImages: z6.number().int().min(1).max(7).optional(),
+  /** Override: number of landing images to include. Default = ALL images the
+  *  task generated (the MCP fetches /v1/results first to count). Bounded
+  *  generously here; the backend validates each index against
+  *  landing.images.length and rejects out-of-range. */
+  numLandingImages: z6.number().int().min(1).max(20).optional(),
   variantIndex: z6.number().int().min(0).optional(),
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
@@ -1354,10 +1609,12 @@ var TikTokInput = z6.object({
   campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
-      const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
+      const availableImages = await fetchLandingImageCount(api, input.taskId);
+      const effectiveAvailable = availableImages > 0 ? availableImages : 3;
+      const numImages = Math.min(input.numLandingImages ?? effectiveAvailable, effectiveAvailable);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -1434,6 +1691,19 @@ function renderShopifyPublishMarkdown(r) {
   };
 }
 __name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+async function fetchLandingImageCount(api, taskId) {
+  try {
+    const r = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}`);
+    if (!isRecord(r)) return 0;
+    const landing = r.landing;
+    if (!isRecord(landing)) return 0;
+    const images = landing.images;
+    return Array.isArray(images) ? images.length : 0;
+  } catch {
+    return 0;
+  }
+}
+__name(fetchLandingImageCount, "fetchLandingImageCount");
 function toMetaCampaignOverrides(cfg) {
   const out = {};
   if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — connect Claude Desktop, Claude Code, ChatGPT, or Gemini to Product Maker AI to generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from your AI assistant.",