@productmaker/mcp 0.4.0 → 0.8.0

package/dist/http.js

@@ -496,6 +496,92 @@ __name(translateError, "translateError");
 import { z } from "zod";
 var Lang = z.string().min(2).max(10);
 var Country = z.string().min(2).max(3);
+var VideoPresetEnum = z.enum([
+  "auto",
+  "ugc_dynamic",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review",
+  "problem_solution",
+  "pixar_problem",
+  "pixar_sassy",
+  "product_showcase",
+  "wearable_showcase"
+]);
+var VIDEO_PRESET_RESOLUTION = {
+  auto: null,
+  ugc_dynamic: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "review",
+    videoModel: "veo"
+  },
+  ugc_unboxing_chaos: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_unboxing_chaos",
+    videoModel: "veo"
+  },
+  ugc_curiosity_reveal: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_curiosity_reveal",
+    videoModel: "veo"
+  },
+  ugc_listicle_3: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_listicle_3",
+    videoModel: "kling"
+  },
+  ugc_skeptic_confession: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_skeptic_confession",
+    videoModel: "veo"
+  },
+  ugc_demo_review: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_demo_review",
+    videoModel: "kling"
+  },
+  problem_solution: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "problem_product_cta",
+    videoModel: "kling"
+  },
+  pixar_problem: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "animated_problem_pixar",
+    videoModel: "kling"
+  },
+  pixar_sassy: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "sassy_product_pixar",
+    videoModel: "seedance"
+  },
+  product_showcase: {
+    videoStyle: "product_only",
+    narrativeStyle: "product_showcase",
+    videoModel: "veo"
+  },
+  wearable_showcase: {
+    videoStyle: "ugc",
+    narrativeStyle: "wearable_showcase",
+    videoModel: "veo"
+  }
+};
+function resolveVideoPreset(preset) {
+  if (!preset) return null;
+  return VIDEO_PRESET_RESOLUTION[preset] ?? null;
+}
+__name(resolveVideoPreset, "resolveVideoPreset");
+var VideoTierEnum = z.enum([
+  "basic",
+  "standard"
+]);
+function resolveVideoTier(tier) {
+  if (!tier) return void 0;
+  return tier === "basic" ? "grok" : "standard";
+}
+__name(resolveVideoTier, "resolveVideoTier");
 var VideoStyleEnum = z.enum([
   "ugc",
   "cartoon_3d",
@@ -525,6 +611,30 @@ var VideoModelEnum = z.enum([
   "grok",
   "kling"
 ]);
+var ProductReferenceUserChoiceEnum = z.enum([
+  "same_product",
+  "variants",
+  "different_products",
+  "combo_distinct"
+]);
+var ProductReferenceCandidateGroupingEnum = z.enum([
+  "same_product_same_variant",
+  "same_product_different_variants",
+  "different_products",
+  "unclear"
+]);
+function buildSelectedImageUrlsHash(urls) {
+  const input = [
+    ...urls
+  ].sort().join("|");
+  let hash = 2166136261;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= input.charCodeAt(index);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `fnv1a:${hash.toString(16).padStart(8, "0")}:${urls.length}`;
+}
+__name(buildSelectedImageUrlsHash, "buildSelectedImageUrlsHash");
 var ImageCreativeStyleEnum = z.enum([
   "studio",
   "floating",
@@ -819,17 +929,16 @@ var CreateProductTaskInput = z2.object({
   country: Country.describe('C\xF3digo ISO del pa\xEDs objetivo. Ejemplos: "CO", "MX", "US", "AR". Define moneda, m\xE9todos de pago locales y tono. REQUERIDO \u2014 si el usuario no lo especific\xF3, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat.'),
   price: z2.string().optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
   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.'),
-  videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual del video. "ugc" = creador hablando a c\xE1mara (default, mejor CTR LATAM). "cartoon_3d" = animaci\xF3n 3D. "product_only" = sin actor. "ai_dynamic" = cinematogr\xE1fico AI. Si se omite, default "ugc".'),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = UGC cl\xE1sico multi-hook (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. "ugc_unboxing_chaos" = unboxing agresivo. "ugc_curiosity_reveal" = hook con producto oculto. "ugc_listicle_3" = 3 razones (30s recomendado). "ugc_skeptic_confession" = esc\xE9ptico\u2192conversi\xF3n (30s recomendado). "ugc_demo_review" = demo en uso a lo largo de d\xEDas. Si se omite, default "review".'),
-  videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). "bytedance"/"seedance" = TikTok-style. "kling"/"wan" = alternativos. "infinitalk" = lipsync largo. "grok" = grok-imagine. Si se omite, el sistema escoge seg\xFAn costo/calidad.'),
+  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).'),
   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). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; usa los mismos valores que narrativeStyle. Si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Ej: ["animated_problem_pixar","review","ugc_skeptic_confession"] para 3 \xE1ngulos distintos. Requiere multiAngleVideos:true (o videoAngleCount>1) para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan.'),
+  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([
     "landing",
     "video",
     "image"
   ])).min(2).max(3).optional().describe('Opcional. Qu\xE9 outputs generar. Default: todos ["landing","video","image"]. Para 2 outputs: ["landing","image"] (sin video), ["video","image"] (sin landing), ["landing","video"] (sin imagen). Para 1 solo output, usa generate_landing / generate_video_creative / generate_image_creatives.')
-});
+}).strict();
 var GetTaskStatusInput = z2.object({
   taskId: z2.string().min(1),
   waitSeconds: z2.number().int().min(0).max(120).optional()
@@ -853,8 +962,25 @@ var EditTaskDraftInput = z2.object({
     scriptNotes: z2.string().max(2e3).optional()
   })
 });
+var PendingActionPayload = z2.discriminatedUnion("kind", [
+  z2.object({
+    kind: z2.literal("product_reference_confirmation"),
+    userChoice: ProductReferenceUserChoiceEnum
+  })
+]);
+var ResolvePendingActionInput = z2.object({
+  taskId: z2.string().min(1),
+  action: PendingActionPayload
+}).strict();
+var StatusForResolveSchema = z2.object({
+  pendingUserAction: z2.object({
+    kind: z2.string(),
+    candidateGrouping: z2.string().optional(),
+    selectedImageUrls: z2.array(z2.string()).optional()
+  }).optional()
+}).passthrough();
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
-  server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoStyle, narrativeStyle, videoModel (enums \u2014 ver descripci\xF3n de cada campo)\n- multiAngleVideos (booleano)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime"), p\xEDdele una opci\xF3n v\xE1lida.', CreateProductTaskInput.shape, async (input) => {
+  server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoPreset (tipo/narrativa del video \u2014 \xFAnico campo de estilo)\n- videoTier (estilo: basic="Realista"/standard="Multiescena")\n- multiAngleVideos (booleano)\n- angleNarratives (override per-angle de la narrativa, avanzado)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nGUION: para revisar/editar el guion del video antes de renderizar, usa `generate_video_creative` con `pauseForVideoScriptReview: true` en vez de este tool. Despu\xE9s de la pausa: get_video_script para leer, approve_video_script para aprobar con ediciones.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime", "modelo X"), p\xEDdele una opci\xF3n v\xE1lida del enum correspondiente.', CreateProductTaskInput.shape, async (input) => {
     try {
       const imgs = await resolveImages(input.images, {
         transport
@@ -863,16 +989,19 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         ...img,
         filename: `image-${i}.png`
       }));
+      const resolved = resolveVideoPreset(input.videoPreset);
+      const wireTier = resolveVideoTier(input.videoTier);
       const fields = flatten({
         "options.languageCode": input.language,
         "options.country": input.country,
         "options.price": input.price,
         "options.offer": input.offer,
-        "options.videoStyle": input.videoStyle,
-        "options.narrativeStyle": input.narrativeStyle,
-        "options.angleNarratives": input.angleNarratives,
-        "options.videoModel": input.videoModel,
+        "options.videoPreset": input.videoPreset,
+        "options.videoStyle": resolved?.videoStyle,
+        "options.narrativeStyle": resolved?.narrativeStyle,
+        "options.videoTier": wireTier,
         "options.multiAngleVideos": input.multiAngleVideos,
+        "options.angleNarratives": input.angleNarratives,
         "options.selectedOutputs": input.outputs,
         url: input.productUrl
       });
@@ -888,7 +1017,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("get_task_status", "Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.", GetTaskStatusInput.shape, async (input, extra) => {
+  server.tool("get_task_status", 'Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo.\n\nIMPORTANTE \u2014 `pendingUserAction`: si est\xE1 presente, el pipeline est\xE1 PARADO esperando que el usuario decida algo. Mira el `kind` (hoy: `"product_reference_confirmation"` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos), mu\xE9strale al usuario `targetProductLabel` + `reason` en lenguaje natural, recoge su respuesta, y llama `resolve_pending_action` con `action: { kind: <mismo kind>, ... }` (las `options` v\xE1lidas vienen en el mismo objeto). Sin esto la tarea NUNCA avanza por m\xE1s que esperes. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.', GetTaskStatusInput.shape, async (input, extra) => {
     try {
       const fetcher = /* @__PURE__ */ __name(() => api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`), "fetcher");
       const signal = extra?.signal;
@@ -945,6 +1074,45 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
+  server.tool("resolve_pending_action", 'Resuelve una acci\xF3n que el pipeline est\xE1 esperando del usuario. La llamas cuando `get_task_status` devuelve `pendingUserAction` (sin esto la tarea NUNCA avanza por m\xE1s que esperes). El `action.kind` que mandas DEBE coincidir con el `pendingUserAction.kind` que viste en el status \u2014 es el contrato de simetr\xEDa que mantiene este tool como \xFAnica superficie de resoluci\xF3n de gates.\n\nKINDS soportados hoy:\n\n\u2022 `product_reference_confirmation` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos. Payload: `userChoice` \u2208 { "same_product" (mismo producto, fotos son s\xF3lo \xE1ngulos distintos), "variants" (mismo producto, distintos colores/tallas/sabores), "combo_distinct" (son 2 productos distintos vendidos juntos como combo \u2014 marca la tarea como combo), "different_products" (productos distintos y el usuario quiere generar s\xF3lo uno \u2014 el backend bloquea hasta que selecciones im\xE1genes de un solo producto; normalmente NO es la respuesta correcta para destrabar) }. PREG\xDANTALE al usuario antes de invocar \u2014 `pendingUserAction.targetProductLabel` y `reason` te dan contexto para formularle la pregunta en lenguaje natural. Usa SOLO valores presentes en `pendingUserAction.options`.\n\nFuturos kinds (no implementados a\xFAn) se agregar\xE1n como nuevas variantes del `action` discriminated union \u2014 el flujo "lee kind del status \u2192 manda mismo kind aqu\xED" sigue igual.', ResolvePendingActionInput.shape, async (input) => {
+    try {
+      const raw = await api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`);
+      const status = StatusForResolveSchema.parse(raw);
+      const pending = status.pendingUserAction;
+      if (!pending) {
+        throw new Error("No hay acci\xF3n pendiente para esta tarea \u2014 llama get_task_status primero para confirmar el estado.");
+      }
+      if (pending.kind !== input.action.kind) {
+        throw new Error(`La tarea espera una acci\xF3n de tipo "${pending.kind}" pero mandaste "${input.action.kind}". Reusa el mismo kind que viste en pendingUserAction.`);
+      }
+      switch (input.action.kind) {
+        case "product_reference_confirmation": {
+          const candidateGrouping = pending.candidateGrouping;
+          const selectedImageUrls = pending.selectedImageUrls ?? [];
+          if (!candidateGrouping || selectedImageUrls.length === 0) {
+            throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
+          }
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+            productReferenceConfirmation: {
+              candidateGrouping,
+              userChoice: input.action.userChoice,
+              // Server overwrites with its own server-side computation;
+              // we send the matching MCP-mirror value so the wire body
+              // is internally coherent if the server skips overwrite.
+              selectedImageUrlsHash: buildSelectedImageUrlsHash(selectedImageUrls)
+            }
+          });
+          return asText(r);
+        }
+        default: {
+          const _exhaustive = input.action.kind;
+          throw new Error(`Unsupported pending action kind: ${String(_exhaustive)}`);
+        }
+      }
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerTaskTools, "registerTaskTools");
 
@@ -971,15 +1139,15 @@ var VideoInput = z3.object({
     "Auto"
   ]).describe('Relaci\xF3n de aspecto. "9:16" = vertical (TikTok/Reels \u2014 default recomendado para ads). "16:9" = horizontal (YouTube). "Auto" = decide la IA.'),
   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."),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (UGC cl\xE1sico multi-hook, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase", "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).'),
-  videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual. "ugc" (creador hablando, default), "cartoon_3d", "product_only", "ai_dynamic".'),
-  videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). Ver lista de valores v\xE1lidos.'),
+  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.'),
   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,
   cta: z3.string().optional().describe('Opcional. Call-to-action final del video. Ej. "Compra ahora", "Pide el tuyo hoy", "Link en bio". Si se omite, la IA escribe uno.'),
-  scriptNotes: z3.string().optional().describe('Opcional. Notas/restricciones para el guion. Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico".')
-});
+  scriptNotes: z3.string().optional().describe('Opcional. Notas/restricciones para el guion (la IA las usa al redactar). Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico", "Mencionar 2x1". NO es el guion literal \u2014 para editar el guion palabra-por-palabra, pasa `pauseForVideoScriptReview: true` y usa get_video_script / approve_video_script tras la pausa.'),
+  pauseForVideoScriptReview: z3.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false.")
+}).strict();
 var imageStyleList = ImageCreativeStyleEnum.options.join(" | ");
 var archetypeList = ImageCreativeArchetypeEnum.options.join(" | ");
 var visualTreatmentList = ImageCreativeVisualTreatmentEnum.options.join(" | ");
@@ -1019,12 +1187,26 @@ var LandingInput = z3.object({
   isCombo: CreativeRefs.isCombo
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
-  server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds, narrativeStyle, videoStyle, videoModel, features, cta, scriptNotes.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado, p\xEDdele una opci\xF3n v\xE1lida.', VideoInput.shape, async (input) => {
+  server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds, videoPreset (tipo/narrativa del video), videoTier (estilo: basic="Realista"/standard="Multiescena"), features, cta, scriptNotes.\n\nGUION: el usuario NO escribe el guion desde cero \u2014 la IA lo redacta. Si quiere REVISARLO/EDITARLO antes de renderizar (igual que en la web), pasa `pauseForVideoScriptReview: true`; cuando la tarea quede pausada, usa get_video_script para leer las escenas, ofr\xE9celas al usuario, y llama approve_video_script con las ediciones. Para dirigir el guion ANTES de generar (sin pausar), usa scriptNotes.', VideoInput.shape, async (input) => {
     try {
+      if (input.videoTier === "basic" && (input.durationSeconds ?? 15) > 15) {
+        throw new Error('videoTier="basic" s\xF3lo admite durationSeconds \u2264 15. Para 30s usa "standard".');
+      }
+      const resolved = resolveVideoPreset(input.videoPreset);
+      const wireTier = resolveVideoTier(input.videoTier);
+      const { videoTier: _publicTier, ...rest } = input;
+      const wirePayload = {
+        ...rest
+      };
+      if (resolved) {
+        wirePayload.videoStyle = resolved.videoStyle;
+        wirePayload.narrativeStyle = resolved.narrativeStyle;
+      }
+      if (wireTier !== void 0) wirePayload.videoTier = wireTier;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
-        input,
+        input: wirePayload,
         transport
       });
     } catch (e) {
@@ -1058,10 +1240,68 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
 }
 __name(registerCreativeTools, "registerCreativeTools");
 
-// src/tools/connections.ts
+// src/tools/script-review.ts
 import { z as z4 } from "zod";
+var GetVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
+  angleKey: z4.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
+}).strict();
+var ApproveSceneEdit = z4.object({
+  index: z4.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
+  dialogue: z4.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "dialogue no puede ser s\xF3lo espacios"
+  }).describe("Di\xE1logo final de la escena. NO puede estar vac\xEDo ni ser s\xF3lo espacios. Puede ser el original sin cambios o la edici\xF3n del usuario.")
+}).strict();
+var ApproveVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea."),
+  angleKey: z4.string().min(1).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
+  scenes: z4.array(ApproveSceneEdit).min(1).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber al menos 1 entrada (scenes vac\xEDo = 400). Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
+}).strict();
+var RegenerateVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea."),
+  angleKey: z4.string().min(1).describe('Clave del \xE1ngulo a regenerar. Single-angle: pasa "angle_0". Multi-angle: el mismo que devuelve get_video_script. NO se puede omitir \u2014 el backend lo exige siempre.'),
+  narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion (mismos valores que angleNarratives). REQUERIDO \u2014 el backend NO acepta "mantener la actual"; siempre tienes que elegir una. Si el usuario quiere re-rolear con la misma narrativa, pasa la que ya tiene el \xE1ngulo (la ves en get_video_script o en get_task_status).')
+}).strict();
+function registerScriptReviewTools(server, api) {
+  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId? }] }.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
+    try {
+      const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
+      const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("regenerate_video_script", 'Re-rolea (regenera) el guion del video pendiente de revisi\xF3n. \xDAsalo cuando:\n- get_video_script devuelve status="error" (el LLM fall\xF3 al redactar).\n- El usuario rechaza el guion entero y prefiere reintentar (no editar l\xEDnea por l\xEDnea).\n- Quieres probar otra narrativa (pasa `narrativeStyle`).\n\nFlujo: llama este tool \u2192 polea get_video_script hasta que vuelva a status="ready" \u2192 mu\xE9strale el nuevo guion al usuario \u2192 approve_video_script.\n\nIMPORTANTE: regenerar CUESTA cr\xE9ditos de LLM. No lo invoques sin confirmaci\xF3n del usuario salvo que el status sea "error" (sin retry el usuario no tiene salida).\n\nMULTI-ANGLE: pasa el mismo `angleKey` que usaste con get_video_script.', RegenerateVideoScriptInput.shape, async (input) => {
+    try {
+      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/regenerate`, {
+        angleKey: input.angleKey,
+        narrativeStyle: input.narrativeStyle
+      });
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("approve_video_script", 'Aprueba el guion del video (con o sin ediciones). Tras llamarlo, el render arranca y consume cr\xE9ditos.\n\nREGLAS DURAS:\n1. INCLUYE EN scenes[] S\xD3LO las escenas que cambian. El backend mergea por `index` \u2014 las escenas no incluidas conservan su di\xE1logo original. scenes vac\xEDo es rechazado con 400, as\xED que si el usuario no quiere editar nada, manda AL MENOS UNA escena con su `dialogue` original (ser\xE1 un no-op sem\xE1ntico pero satisface el min(1)).\n2. Para cada entrada incluida cuyo `dialogue` difiera del original, el backend valida `minWords \u2264 words(dialogue) \u2264 maxWords` (los rangos vienen en get_video_script). Si te sales del rango, rechaza con 400 \u2014 NO recortes en silencio; p\xEDdele al usuario que ajuste.\n3. Escenas con LLM-original ya fuera de rango: el backend NO las valida si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas). Si quieres que pasen tal cual, simplemente no las incluyas en scenes[].\n4. NUNCA inventes ni reescribas el guion por tu cuenta. Aplica los cambios del usuario al pie de la letra dentro de los l\xEDmites de palabras.\n5. MULTI-ANGLE: pasa el mismo `angleKey` que usaste en get_video_script. Si lo omites, el backend resuelve a "angle_0" literal \u2014 puedes aprobar un \xE1ngulo equivocado.\n\nDevuelve { status }. status="approved" confirma la aprobaci\xF3n; otro valor significa que la pausa sigue activa.', ApproveVideoScriptInput.shape, async (input) => {
+    try {
+      const body = {
+        scenes: input.scenes
+      };
+      if (input.angleKey) body.angleKey = input.angleKey;
+      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/approve`, body);
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+}
+__name(registerScriptReviewTools, "registerScriptReviewTools");
+
+// src/tools/connections.ts
+import { z as z5 } from "zod";
 function registerConnectionTools(server, api) {
-  server.tool("list_shopify_shops", "Lista las tiendas Shopify conectadas por este usuario. Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z4.object({}).shape, async () => {
+  server.tool("list_shopify_shops", "Lista las tiendas Shopify conectadas por este usuario. Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/shopify/shops");
       return asText(r);
@@ -1069,7 +1309,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z4.object({}).shape, async () => {
+  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/facebook/ad-accounts");
       return asText(r);
@@ -1077,7 +1317,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z4.object({}).shape, async () => {
+  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/tiktok/advertisers");
       return asText(r);
@@ -1089,40 +1329,40 @@ function registerConnectionTools(server, api) {
 __name(registerConnectionTools, "registerConnectionTools");
 
 // src/tools/publish.ts
-import { z as z5 } from "zod";
-var ShopifyInput = z5.object({
-  taskId: z5.string().min(1),
-  shopDomain: z5.string().min(1),
-  numLandingImages: z5.number().int().min(1).max(7).optional(),
-  variantIndex: z5.number().int().min(0).optional(),
+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(),
+  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
   *  a single-option product page. Defaults to false. */
-  showVariantPicker: z5.boolean().optional()
+  showVariantPicker: z6.boolean().optional()
 });
-var McpCampaignConfig = z5.object({
-  dailyBudgetUsd: z5.number().positive().optional(),
+var McpCampaignConfig = z6.object({
+  dailyBudgetUsd: z6.number().positive().optional(),
   /** ISO-3166-1 alpha-2 country codes. Meta accepts max 1 (single-country
   *  ad set). TikTok takes only the first entry. */
-  targetCountries: z5.array(z5.string().length(2)).max(1).optional(),
-  campaignName: z5.string().trim().min(1).max(100).optional()
+  targetCountries: z6.array(z6.string().length(2)).max(1).optional(),
+  campaignName: z6.string().trim().min(1).max(100).optional()
 });
-var MetaInput = z5.object({
-  taskId: z5.string().min(1),
-  adAccountId: z5.string().min(1),
-  pixelId: z5.string().min(1).optional(),
-  landingUrl: z5.string().url().optional(),
+var MetaInput = z6.object({
+  taskId: z6.string().min(1),
+  adAccountId: z6.string().min(1),
+  pixelId: z6.string().min(1).optional(),
+  landingUrl: z6.string().url().optional(),
   /** Select which angles to publish by 0-based index. Omit to publish all
   *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
-  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional()
 });
-var TikTokInput = z5.object({
-  taskId: z5.string().min(1),
-  advertiserId: z5.string().min(1),
-  pixelId: z5.string().min(1).optional(),
-  landingUrl: z5.string().url().optional(),
-  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+var TikTokInput = z6.object({
+  taskId: z6.string().min(1),
+  advertiserId: z6.string().min(1),
+  pixelId: z6.string().min(1).optional(),
+  landingUrl: z6.string().url().optional(),
+  angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
@@ -1224,13 +1464,13 @@ function toTikTokCampaignConfig(cfg) {
 __name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
 
 // src/tools/campaigns.ts
-import { z as z6 } from "zod";
-var MetaStatusInput = z6.object({
-  campaignId: z6.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
+import { z as z7 } from "zod";
+var MetaStatusInput = z7.object({
+  campaignId: z7.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
 });
-var TikTokStatusInput = z6.object({
-  campaignId: z6.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
-  advertiserId: z6.string().min(1).describe("The same advertiserId used to publish the campaign.")
+var TikTokStatusInput = z7.object({
+  campaignId: z7.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
+  advertiserId: z7.string().min(1).describe("The same advertiserId used to publish the campaign.")
 });
 function registerCampaignTools(server, api) {
   server.tool("get_meta_campaign_status", "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada. Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, async (input) => {
@@ -1348,6 +1588,7 @@ function createServer(opts) {
   registerCreativeTools(server, api, {
     transport
   });
+  registerScriptReviewTools(server, api);
   registerConnectionTools(server, api);
   registerPublishTools(server, api);
   registerCampaignTools(server, api);

package/dist/stdio.js

@@ -493,6 +493,92 @@ __name(translateError, "translateError");
 import { z } from "zod";
 var Lang = z.string().min(2).max(10);
 var Country = z.string().min(2).max(3);
+var VideoPresetEnum = z.enum([
+  "auto",
+  "ugc_dynamic",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review",
+  "problem_solution",
+  "pixar_problem",
+  "pixar_sassy",
+  "product_showcase",
+  "wearable_showcase"
+]);
+var VIDEO_PRESET_RESOLUTION = {
+  auto: null,
+  ugc_dynamic: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "review",
+    videoModel: "veo"
+  },
+  ugc_unboxing_chaos: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_unboxing_chaos",
+    videoModel: "veo"
+  },
+  ugc_curiosity_reveal: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_curiosity_reveal",
+    videoModel: "veo"
+  },
+  ugc_listicle_3: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_listicle_3",
+    videoModel: "kling"
+  },
+  ugc_skeptic_confession: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_skeptic_confession",
+    videoModel: "veo"
+  },
+  ugc_demo_review: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "ugc_demo_review",
+    videoModel: "kling"
+  },
+  problem_solution: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "problem_product_cta",
+    videoModel: "kling"
+  },
+  pixar_problem: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "animated_problem_pixar",
+    videoModel: "kling"
+  },
+  pixar_sassy: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "sassy_product_pixar",
+    videoModel: "seedance"
+  },
+  product_showcase: {
+    videoStyle: "product_only",
+    narrativeStyle: "product_showcase",
+    videoModel: "veo"
+  },
+  wearable_showcase: {
+    videoStyle: "ugc",
+    narrativeStyle: "wearable_showcase",
+    videoModel: "veo"
+  }
+};
+function resolveVideoPreset(preset) {
+  if (!preset) return null;
+  return VIDEO_PRESET_RESOLUTION[preset] ?? null;
+}
+__name(resolveVideoPreset, "resolveVideoPreset");
+var VideoTierEnum = z.enum([
+  "basic",
+  "standard"
+]);
+function resolveVideoTier(tier) {
+  if (!tier) return void 0;
+  return tier === "basic" ? "grok" : "standard";
+}
+__name(resolveVideoTier, "resolveVideoTier");
 var VideoStyleEnum = z.enum([
   "ugc",
   "cartoon_3d",
@@ -522,6 +608,30 @@ var VideoModelEnum = z.enum([
   "grok",
   "kling"
 ]);
+var ProductReferenceUserChoiceEnum = z.enum([
+  "same_product",
+  "variants",
+  "different_products",
+  "combo_distinct"
+]);
+var ProductReferenceCandidateGroupingEnum = z.enum([
+  "same_product_same_variant",
+  "same_product_different_variants",
+  "different_products",
+  "unclear"
+]);
+function buildSelectedImageUrlsHash(urls) {
+  const input = [
+    ...urls
+  ].sort().join("|");
+  let hash = 2166136261;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= input.charCodeAt(index);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `fnv1a:${hash.toString(16).padStart(8, "0")}:${urls.length}`;
+}
+__name(buildSelectedImageUrlsHash, "buildSelectedImageUrlsHash");
 var ImageCreativeStyleEnum = z.enum([
   "studio",
   "floating",
@@ -775,17 +885,16 @@ var CreateProductTaskInput = z2.object({
   country: Country.describe('C\xF3digo ISO del pa\xEDs objetivo. Ejemplos: "CO", "MX", "US", "AR". Define moneda, m\xE9todos de pago locales y tono. REQUERIDO \u2014 si el usuario no lo especific\xF3, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat.'),
   price: z2.string().optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
   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.'),
-  videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual del video. "ugc" = creador hablando a c\xE1mara (default, mejor CTR LATAM). "cartoon_3d" = animaci\xF3n 3D. "product_only" = sin actor. "ai_dynamic" = cinematogr\xE1fico AI. Si se omite, default "ugc".'),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" = UGC cl\xE1sico multi-hook (default, alta conversi\xF3n). "problem_product_cta" = problema\u2192soluci\xF3n. "product_showcase" = features. "metaphor_product_cta" = met\xE1fora visual. "wearable_showcase" = para ropa/accesorios. "ugc_unboxing_chaos" = unboxing agresivo. "ugc_curiosity_reveal" = hook con producto oculto. "ugc_listicle_3" = 3 razones (30s recomendado). "ugc_skeptic_confession" = esc\xE9ptico\u2192conversi\xF3n (30s recomendado). "ugc_demo_review" = demo en uso a lo largo de d\xEDas. Si se omite, default "review".'),
-  videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). "bytedance"/"seedance" = TikTok-style. "kling"/"wan" = alternativos. "infinitalk" = lipsync largo. "grok" = grok-imagine. Si se omite, el sistema escoge seg\xFAn costo/calidad.'),
+  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).'),
   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). angleNarratives[i] fuerza la narrativa del \xE1ngulo en la posici\xF3n i; usa los mismos valores que narrativeStyle. Si la lista es m\xE1s corta que la cantidad de \xE1ngulos, las posiciones restantes las elige la IA. Ej: ["animated_problem_pixar","review","ugc_skeptic_confession"] para 3 \xE1ngulos distintos. Requiere multiAngleVideos:true (o videoAngleCount>1) para que haya varios \xE1ngulos. Si se omite, todas las narrativas se auto-seleccionan.'),
+  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([
     "landing",
     "video",
     "image"
   ])).min(2).max(3).optional().describe('Opcional. Qu\xE9 outputs generar. Default: todos ["landing","video","image"]. Para 2 outputs: ["landing","image"] (sin video), ["video","image"] (sin landing), ["landing","video"] (sin imagen). Para 1 solo output, usa generate_landing / generate_video_creative / generate_image_creatives.')
-});
+}).strict();
 var GetTaskStatusInput = z2.object({
   taskId: z2.string().min(1),
   waitSeconds: z2.number().int().min(0).max(120).optional()
@@ -809,8 +918,25 @@ var EditTaskDraftInput = z2.object({
     scriptNotes: z2.string().max(2e3).optional()
   })
 });
+var PendingActionPayload = z2.discriminatedUnion("kind", [
+  z2.object({
+    kind: z2.literal("product_reference_confirmation"),
+    userChoice: ProductReferenceUserChoiceEnum
+  })
+]);
+var ResolvePendingActionInput = z2.object({
+  taskId: z2.string().min(1),
+  action: PendingActionPayload
+}).strict();
+var StatusForResolveSchema = z2.object({
+  pendingUserAction: z2.object({
+    kind: z2.string(),
+    candidateGrouping: z2.string().optional(),
+    selectedImageUrls: z2.array(z2.string()).optional()
+  }).optional()
+}).passthrough();
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
-  server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoStyle, narrativeStyle, videoModel (enums \u2014 ver descripci\xF3n de cada campo)\n- multiAngleVideos (booleano)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime"), p\xEDdele una opci\xF3n v\xE1lida.', CreateProductTaskInput.shape, async (input) => {
+  server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoPreset (tipo/narrativa del video \u2014 \xFAnico campo de estilo)\n- videoTier (estilo: basic="Realista"/standard="Multiescena")\n- multiAngleVideos (booleano)\n- angleNarratives (override per-angle de la narrativa, avanzado)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nGUION: para revisar/editar el guion del video antes de renderizar, usa `generate_video_creative` con `pauseForVideoScriptReview: true` en vez de este tool. Despu\xE9s de la pausa: get_video_script para leer, approve_video_script para aprobar con ediciones.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime", "modelo X"), p\xEDdele una opci\xF3n v\xE1lida del enum correspondiente.', CreateProductTaskInput.shape, async (input) => {
     try {
       const imgs = await resolveImages(input.images, {
         transport
@@ -819,16 +945,19 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         ...img,
         filename: `image-${i}.png`
       }));
+      const resolved = resolveVideoPreset(input.videoPreset);
+      const wireTier = resolveVideoTier(input.videoTier);
       const fields = flatten({
         "options.languageCode": input.language,
         "options.country": input.country,
         "options.price": input.price,
         "options.offer": input.offer,
-        "options.videoStyle": input.videoStyle,
-        "options.narrativeStyle": input.narrativeStyle,
-        "options.angleNarratives": input.angleNarratives,
-        "options.videoModel": input.videoModel,
+        "options.videoPreset": input.videoPreset,
+        "options.videoStyle": resolved?.videoStyle,
+        "options.narrativeStyle": resolved?.narrativeStyle,
+        "options.videoTier": wireTier,
         "options.multiAngleVideos": input.multiAngleVideos,
+        "options.angleNarratives": input.angleNarratives,
         "options.selectedOutputs": input.outputs,
         url: input.productUrl
       });
@@ -844,7 +973,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("get_task_status", "Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.", GetTaskStatusInput.shape, async (input, extra) => {
+  server.tool("get_task_status", 'Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo.\n\nIMPORTANTE \u2014 `pendingUserAction`: si est\xE1 presente, el pipeline est\xE1 PARADO esperando que el usuario decida algo. Mira el `kind` (hoy: `"product_reference_confirmation"` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos), mu\xE9strale al usuario `targetProductLabel` + `reason` en lenguaje natural, recoge su respuesta, y llama `resolve_pending_action` con `action: { kind: <mismo kind>, ... }` (las `options` v\xE1lidas vienen en el mismo objeto). Sin esto la tarea NUNCA avanza por m\xE1s que esperes. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.', GetTaskStatusInput.shape, async (input, extra) => {
     try {
       const fetcher = /* @__PURE__ */ __name(() => api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`), "fetcher");
       const signal = extra?.signal;
@@ -901,6 +1030,45 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
+  server.tool("resolve_pending_action", 'Resuelve una acci\xF3n que el pipeline est\xE1 esperando del usuario. La llamas cuando `get_task_status` devuelve `pendingUserAction` (sin esto la tarea NUNCA avanza por m\xE1s que esperes). El `action.kind` que mandas DEBE coincidir con el `pendingUserAction.kind` que viste en el status \u2014 es el contrato de simetr\xEDa que mantiene este tool como \xFAnica superficie de resoluci\xF3n de gates.\n\nKINDS soportados hoy:\n\n\u2022 `product_reference_confirmation` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos. Payload: `userChoice` \u2208 { "same_product" (mismo producto, fotos son s\xF3lo \xE1ngulos distintos), "variants" (mismo producto, distintos colores/tallas/sabores), "combo_distinct" (son 2 productos distintos vendidos juntos como combo \u2014 marca la tarea como combo), "different_products" (productos distintos y el usuario quiere generar s\xF3lo uno \u2014 el backend bloquea hasta que selecciones im\xE1genes de un solo producto; normalmente NO es la respuesta correcta para destrabar) }. PREG\xDANTALE al usuario antes de invocar \u2014 `pendingUserAction.targetProductLabel` y `reason` te dan contexto para formularle la pregunta en lenguaje natural. Usa SOLO valores presentes en `pendingUserAction.options`.\n\nFuturos kinds (no implementados a\xFAn) se agregar\xE1n como nuevas variantes del `action` discriminated union \u2014 el flujo "lee kind del status \u2192 manda mismo kind aqu\xED" sigue igual.', ResolvePendingActionInput.shape, async (input) => {
+    try {
+      const raw = await api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`);
+      const status = StatusForResolveSchema.parse(raw);
+      const pending = status.pendingUserAction;
+      if (!pending) {
+        throw new Error("No hay acci\xF3n pendiente para esta tarea \u2014 llama get_task_status primero para confirmar el estado.");
+      }
+      if (pending.kind !== input.action.kind) {
+        throw new Error(`La tarea espera una acci\xF3n de tipo "${pending.kind}" pero mandaste "${input.action.kind}". Reusa el mismo kind que viste en pendingUserAction.`);
+      }
+      switch (input.action.kind) {
+        case "product_reference_confirmation": {
+          const candidateGrouping = pending.candidateGrouping;
+          const selectedImageUrls = pending.selectedImageUrls ?? [];
+          if (!candidateGrouping || selectedImageUrls.length === 0) {
+            throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
+          }
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+            productReferenceConfirmation: {
+              candidateGrouping,
+              userChoice: input.action.userChoice,
+              // Server overwrites with its own server-side computation;
+              // we send the matching MCP-mirror value so the wire body
+              // is internally coherent if the server skips overwrite.
+              selectedImageUrlsHash: buildSelectedImageUrlsHash(selectedImageUrls)
+            }
+          });
+          return asText(r);
+        }
+        default: {
+          const _exhaustive = input.action.kind;
+          throw new Error(`Unsupported pending action kind: ${String(_exhaustive)}`);
+        }
+      }
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerTaskTools, "registerTaskTools");
 
@@ -927,15 +1095,15 @@ var VideoInput = z3.object({
     "Auto"
   ]).describe('Relaci\xF3n de aspecto. "9:16" = vertical (TikTok/Reels \u2014 default recomendado para ads). "16:9" = horizontal (YouTube). "Auto" = decide la IA.'),
   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."),
-  narrativeStyle: NarrativeStyleEnum.optional().describe('Opcional. Estructura narrativa. "review" (UGC cl\xE1sico multi-hook, default), "problem_product_cta", "product_showcase", "metaphor_product_cta", "wearable_showcase", "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).'),
-  videoStyle: VideoStyleEnum.optional().describe('Opcional. Estilo visual. "ugc" (creador hablando, default), "cartoon_3d", "product_only", "ai_dynamic".'),
-  videoModel: VideoModelEnum.optional().describe('Opcional. Modelo de video. "veo" (default, calidad Google). Ver lista de valores v\xE1lidos.'),
+  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.'),
   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,
   cta: z3.string().optional().describe('Opcional. Call-to-action final del video. Ej. "Compra ahora", "Pide el tuyo hoy", "Link en bio". Si se omite, la IA escribe uno.'),
-  scriptNotes: z3.string().optional().describe('Opcional. Notas/restricciones para el guion. Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico".')
-});
+  scriptNotes: z3.string().optional().describe('Opcional. Notas/restricciones para el guion (la IA las usa al redactar). Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico", "Mencionar 2x1". NO es el guion literal \u2014 para editar el guion palabra-por-palabra, pasa `pauseForVideoScriptReview: true` y usa get_video_script / approve_video_script tras la pausa.'),
+  pauseForVideoScriptReview: z3.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false.")
+}).strict();
 var imageStyleList = ImageCreativeStyleEnum.options.join(" | ");
 var archetypeList = ImageCreativeArchetypeEnum.options.join(" | ");
 var visualTreatmentList = ImageCreativeVisualTreatmentEnum.options.join(" | ");
@@ -975,12 +1143,26 @@ var LandingInput = z3.object({
   isCombo: CreativeRefs.isCombo
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
-  server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds, narrativeStyle, videoStyle, videoModel, features, cta, scriptNotes.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado, p\xEDdele una opci\xF3n v\xE1lida.', VideoInput.shape, async (input) => {
+  server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds, videoPreset (tipo/narrativa del video), videoTier (estilo: basic="Realista"/standard="Multiescena"), features, cta, scriptNotes.\n\nGUION: el usuario NO escribe el guion desde cero \u2014 la IA lo redacta. Si quiere REVISARLO/EDITARLO antes de renderizar (igual que en la web), pasa `pauseForVideoScriptReview: true`; cuando la tarea quede pausada, usa get_video_script para leer las escenas, ofr\xE9celas al usuario, y llama approve_video_script con las ediciones. Para dirigir el guion ANTES de generar (sin pausar), usa scriptNotes.', VideoInput.shape, async (input) => {
     try {
+      if (input.videoTier === "basic" && (input.durationSeconds ?? 15) > 15) {
+        throw new Error('videoTier="basic" s\xF3lo admite durationSeconds \u2264 15. Para 30s usa "standard".');
+      }
+      const resolved = resolveVideoPreset(input.videoPreset);
+      const wireTier = resolveVideoTier(input.videoTier);
+      const { videoTier: _publicTier, ...rest } = input;
+      const wirePayload = {
+        ...rest
+      };
+      if (resolved) {
+        wirePayload.videoStyle = resolved.videoStyle;
+        wirePayload.narrativeStyle = resolved.narrativeStyle;
+      }
+      if (wireTier !== void 0) wirePayload.videoTier = wireTier;
       return await submitCreative(api, {
         path: "/v1/creatives/videos",
         estimatedSeconds: 300,
-        input,
+        input: wirePayload,
         transport
       });
     } catch (e) {
@@ -1014,10 +1196,68 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
 }
 __name(registerCreativeTools, "registerCreativeTools");
 
-// src/tools/connections.ts
+// src/tools/script-review.ts
 import { z as z4 } from "zod";
+var GetVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
+  angleKey: z4.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
+}).strict();
+var ApproveSceneEdit = z4.object({
+  index: z4.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
+  dialogue: z4.string().min(1).refine((v) => v.trim().length > 0, {
+    message: "dialogue no puede ser s\xF3lo espacios"
+  }).describe("Di\xE1logo final de la escena. NO puede estar vac\xEDo ni ser s\xF3lo espacios. Puede ser el original sin cambios o la edici\xF3n del usuario.")
+}).strict();
+var ApproveVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea."),
+  angleKey: z4.string().min(1).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
+  scenes: z4.array(ApproveSceneEdit).min(1).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber al menos 1 entrada (scenes vac\xEDo = 400). Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
+}).strict();
+var RegenerateVideoScriptInput = z4.object({
+  taskId: z4.string().min(1).describe("ID de la tarea."),
+  angleKey: z4.string().min(1).describe('Clave del \xE1ngulo a regenerar. Single-angle: pasa "angle_0". Multi-angle: el mismo que devuelve get_video_script. NO se puede omitir \u2014 el backend lo exige siempre.'),
+  narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion (mismos valores que angleNarratives). REQUERIDO \u2014 el backend NO acepta "mantener la actual"; siempre tienes que elegir una. Si el usuario quiere re-rolear con la misma narrativa, pasa la que ya tiene el \xE1ngulo (la ves en get_video_script o en get_task_status).')
+}).strict();
+function registerScriptReviewTools(server, api) {
+  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId? }] }.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
+    try {
+      const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
+      const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("regenerate_video_script", 'Re-rolea (regenera) el guion del video pendiente de revisi\xF3n. \xDAsalo cuando:\n- get_video_script devuelve status="error" (el LLM fall\xF3 al redactar).\n- El usuario rechaza el guion entero y prefiere reintentar (no editar l\xEDnea por l\xEDnea).\n- Quieres probar otra narrativa (pasa `narrativeStyle`).\n\nFlujo: llama este tool \u2192 polea get_video_script hasta que vuelva a status="ready" \u2192 mu\xE9strale el nuevo guion al usuario \u2192 approve_video_script.\n\nIMPORTANTE: regenerar CUESTA cr\xE9ditos de LLM. No lo invoques sin confirmaci\xF3n del usuario salvo que el status sea "error" (sin retry el usuario no tiene salida).\n\nMULTI-ANGLE: pasa el mismo `angleKey` que usaste con get_video_script.', RegenerateVideoScriptInput.shape, async (input) => {
+    try {
+      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/regenerate`, {
+        angleKey: input.angleKey,
+        narrativeStyle: input.narrativeStyle
+      });
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+  server.tool("approve_video_script", 'Aprueba el guion del video (con o sin ediciones). Tras llamarlo, el render arranca y consume cr\xE9ditos.\n\nREGLAS DURAS:\n1. INCLUYE EN scenes[] S\xD3LO las escenas que cambian. El backend mergea por `index` \u2014 las escenas no incluidas conservan su di\xE1logo original. scenes vac\xEDo es rechazado con 400, as\xED que si el usuario no quiere editar nada, manda AL MENOS UNA escena con su `dialogue` original (ser\xE1 un no-op sem\xE1ntico pero satisface el min(1)).\n2. Para cada entrada incluida cuyo `dialogue` difiera del original, el backend valida `minWords \u2264 words(dialogue) \u2264 maxWords` (los rangos vienen en get_video_script). Si te sales del rango, rechaza con 400 \u2014 NO recortes en silencio; p\xEDdele al usuario que ajuste.\n3. Escenas con LLM-original ya fuera de rango: el backend NO las valida si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas). Si quieres que pasen tal cual, simplemente no las incluyas en scenes[].\n4. NUNCA inventes ni reescribas el guion por tu cuenta. Aplica los cambios del usuario al pie de la letra dentro de los l\xEDmites de palabras.\n5. MULTI-ANGLE: pasa el mismo `angleKey` que usaste en get_video_script. Si lo omites, el backend resuelve a "angle_0" literal \u2014 puedes aprobar un \xE1ngulo equivocado.\n\nDevuelve { status }. status="approved" confirma la aprobaci\xF3n; otro valor significa que la pausa sigue activa.', ApproveVideoScriptInput.shape, async (input) => {
+    try {
+      const body = {
+        scenes: input.scenes
+      };
+      if (input.angleKey) body.angleKey = input.angleKey;
+      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/approve`, body);
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
+}
+__name(registerScriptReviewTools, "registerScriptReviewTools");
+
+// src/tools/connections.ts
+import { z as z5 } from "zod";
 function registerConnectionTools(server, api) {
-  server.tool("list_shopify_shops", "Lista las tiendas Shopify conectadas por este usuario. Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z4.object({}).shape, async () => {
+  server.tool("list_shopify_shops", "Lista las tiendas Shopify conectadas por este usuario. Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/shopify/shops");
       return asText(r);
@@ -1025,7 +1265,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z4.object({}).shape, async () => {
+  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/facebook/ad-accounts");
       return asText(r);
@@ -1033,7 +1273,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z4.object({}).shape, async () => {
+  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z5.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/tiktok/advertisers");
       return asText(r);
@@ -1045,40 +1285,40 @@ function registerConnectionTools(server, api) {
 __name(registerConnectionTools, "registerConnectionTools");
 
 // src/tools/publish.ts
-import { z as z5 } from "zod";
-var ShopifyInput = z5.object({
-  taskId: z5.string().min(1),
-  shopDomain: z5.string().min(1),
-  numLandingImages: z5.number().int().min(1).max(7).optional(),
-  variantIndex: z5.number().int().min(0).optional(),
+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(),
+  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
   *  a single-option product page. Defaults to false. */
-  showVariantPicker: z5.boolean().optional()
+  showVariantPicker: z6.boolean().optional()
 });
-var McpCampaignConfig = z5.object({
-  dailyBudgetUsd: z5.number().positive().optional(),
+var McpCampaignConfig = z6.object({
+  dailyBudgetUsd: z6.number().positive().optional(),
   /** ISO-3166-1 alpha-2 country codes. Meta accepts max 1 (single-country
   *  ad set). TikTok takes only the first entry. */
-  targetCountries: z5.array(z5.string().length(2)).max(1).optional(),
-  campaignName: z5.string().trim().min(1).max(100).optional()
+  targetCountries: z6.array(z6.string().length(2)).max(1).optional(),
+  campaignName: z6.string().trim().min(1).max(100).optional()
 });
-var MetaInput = z5.object({
-  taskId: z5.string().min(1),
-  adAccountId: z5.string().min(1),
-  pixelId: z5.string().min(1).optional(),
-  landingUrl: z5.string().url().optional(),
+var MetaInput = z6.object({
+  taskId: z6.string().min(1),
+  adAccountId: z6.string().min(1),
+  pixelId: z6.string().min(1).optional(),
+  landingUrl: z6.string().url().optional(),
   /** Select which angles to publish by 0-based index. Omit to publish all
   *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
-  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+  angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional()
 });
-var TikTokInput = z5.object({
-  taskId: z5.string().min(1),
-  advertiserId: z5.string().min(1),
-  pixelId: z5.string().min(1).optional(),
-  landingUrl: z5.string().url().optional(),
-  angleIndexes: z5.array(z5.number().int().nonnegative()).optional(),
+var TikTokInput = z6.object({
+  taskId: z6.string().min(1),
+  advertiserId: z6.string().min(1),
+  pixelId: z6.string().min(1).optional(),
+  landingUrl: z6.string().url().optional(),
+  angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional()
 });
 function registerPublishTools(server, api) {
@@ -1180,13 +1420,13 @@ function toTikTokCampaignConfig(cfg) {
 __name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
 
 // src/tools/campaigns.ts
-import { z as z6 } from "zod";
-var MetaStatusInput = z6.object({
-  campaignId: z6.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
+import { z as z7 } from "zod";
+var MetaStatusInput = z7.object({
+  campaignId: z7.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
 });
-var TikTokStatusInput = z6.object({
-  campaignId: z6.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
-  advertiserId: z6.string().min(1).describe("The same advertiserId used to publish the campaign.")
+var TikTokStatusInput = z7.object({
+  campaignId: z7.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
+  advertiserId: z7.string().min(1).describe("The same advertiserId used to publish the campaign.")
 });
 function registerCampaignTools(server, api) {
   server.tool("get_meta_campaign_status", "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada. Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, async (input) => {
@@ -1304,6 +1544,7 @@ function createServer(opts) {
   registerCreativeTools(server, api, {
     transport
   });
+  registerScriptReviewTools(server, api);
   registerConnectionTools(server, api);
   registerPublishTools(server, api);
   registerCampaignTools(server, api);

package/package.json

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