@productmaker/mcp 12.11.0 → 12.12.0

package/dist/http.js

@@ -47,7 +47,11 @@ var NarrativeStyle = z.enum([
   "animated_storyteller",
   "animated_inner_journey",
   "animated_object_soul",
-  "animated_timeline"
+  "animated_timeline",
+  // Voiceless story on the unified engine only: on-screen labels, before/after
+  // and a format the director picks from the Product Truth. Manual-only and
+  // admitted per user (`CREATIVE_VIRAL_NARRATIVE_USER_IDS`); never Auto.
+  "viral"
 ]);
 var BLOCKED_NARRATIVE_STYLES = [
   "animated_storyteller",
@@ -93,7 +97,8 @@ var VideoPreset = z.enum([
   "ugc_listicle_3",
   "ugc_skeptic_confession",
   "ugc_demo_review",
-  "metaphor_product"
+  "metaphor_product",
+  "viral"
 ]);
 var VoiceId = z.string().refine((value) => !value.trim().toLowerCase().startsWith("bank:"), "El banco de voces fue retirado. Usa Auto o la voz privada de un actor.");
 var _VIDEO_MODEL_SET = new Set(VideoModel.options);
@@ -4531,6 +4536,37 @@ var TaskKind = z8.enum([
 // ../../packages/types/src/product.ts
 import { z as z10 } from "zod";
 
+// ../../packages/types/src/price-numeric.ts
+function parsePriceNumeric(raw) {
+  if (!raw) return null;
+  const cleaned = raw.replace(/[^\d.,-]/g, "").trim();
+  if (!cleaned || cleaned === "-") return null;
+  const hasDot = cleaned.includes(".");
+  const hasComma = cleaned.includes(",");
+  let normalized = cleaned;
+  if (hasDot && hasComma) {
+    const lastDot = cleaned.lastIndexOf(".");
+    const lastComma = cleaned.lastIndexOf(",");
+    const decimal = lastDot > lastComma ? "." : ",";
+    const thousands = decimal === "." ? "," : ".";
+    normalized = cleaned.split(thousands).join("");
+    if (decimal === ",") normalized = normalized.replace(",", ".");
+  } else if (hasDot) {
+    const parts = cleaned.split(".");
+    const lastGroup = parts[parts.length - 1] ?? "";
+    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
+    if (isThousands) normalized = parts.join("");
+  } else if (hasComma) {
+    const parts = cleaned.split(",");
+    const lastGroup = parts[parts.length - 1] ?? "";
+    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
+    normalized = isThousands ? parts.join("") : cleaned.replace(",", ".");
+  }
+  const n = Number(normalized);
+  return Number.isFinite(n) ? n : null;
+}
+__name(parsePriceNumeric, "parsePriceNumeric");
+
 // ../../packages/types/src/product-reference-set.ts
 import { z as z9 } from "zod";
 var ProductReferenceScopeSchema = z9.enum([
@@ -4998,35 +5034,6 @@ var OfferSchema = z10.string().min(1).max(240);
 var CompareAtPriceSchema = z10.string().min(1).max(120);
 var PaymentMethodsSchema = z10.string().min(1).max(240);
 var LanguageCodeSchema = z10.string().regex(/^[a-z]{2}(?:[-_][a-zA-Z]{2})?$/, "Invalid language code").max(10);
-function parsePriceNumeric(raw) {
-  if (!raw) return null;
-  const cleaned = raw.replace(/[^\d.,-]/g, "").trim();
-  if (!cleaned || cleaned === "-") return null;
-  const hasDot = cleaned.includes(".");
-  const hasComma = cleaned.includes(",");
-  let normalized = cleaned;
-  if (hasDot && hasComma) {
-    const lastDot = cleaned.lastIndexOf(".");
-    const lastComma = cleaned.lastIndexOf(",");
-    const decimal = lastDot > lastComma ? "." : ",";
-    const thousands = decimal === "." ? "," : ".";
-    normalized = cleaned.split(thousands).join("");
-    if (decimal === ",") normalized = normalized.replace(",", ".");
-  } else if (hasDot) {
-    const parts = cleaned.split(".");
-    const lastGroup = parts[parts.length - 1] ?? "";
-    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
-    if (isThousands) normalized = parts.join("");
-  } else if (hasComma) {
-    const parts = cleaned.split(",");
-    const lastGroup = parts[parts.length - 1] ?? "";
-    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
-    normalized = isThousands ? parts.join("") : cleaned.replace(",", ".");
-  }
-  const n = Number(normalized);
-  return Number.isFinite(n) ? n : null;
-}
-__name(parsePriceNumeric, "parsePriceNumeric");
 var PRICE_SKIP_SENTINELS = /* @__PURE__ */ new Set([
   "skip",
   "none",
@@ -7861,11 +7868,16 @@ var PersistedBundleBindingSchema = z22.object({
    * the price comparison when it is absent.
    */
   priceAtPublish: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).optional(),
+  compareAtPriceAtPublish: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).nullable().optional(),
+  /** Seller's offer at publish time, independent of what Shopify charged. */
+  offerAtPublish: z22.object({
+    price: z22.string().trim().min(1).max(MAX_MONEY_LENGTH),
+    compareAtPrice: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).nullable()
+  }).strict().optional(),
   /**
    * How the binding was produced: `mapped` = merchant-confirmed against an
    * existing catalog, `created` = ProductMaker-created "Oferta" variant,
-   * `implicit` = legacy exact-structure match (not persisted today; kept
-   * for forward compatibility).
+   * `implicit` = exact-structure match.
    */
   mode: z22.enum([
     "mapped",
@@ -11465,6 +11477,28 @@ var CreativeEngineSceneSchema = z38.object({
   timeline: CreativeEngineTimelineSchema.optional(),
   factPaths: z38.array(id2)
 }).strict();
+var CreativeEngineViralFormatSchema = z38.enum([
+  "pas",
+  "before_after",
+  "demo",
+  "pov",
+  "gift",
+  "concept_vs_result"
+]);
+var CreativeEngineViralPlanSchema = z38.object({
+  format: CreativeEngineViralFormatSchema,
+  /** The scene that shows the product's critical feature working. */
+  mechanismSceneId: id2,
+  /** Two stills of the same subject and framing: rigid surfaces wipe, soft ones (hair, skin, fabric) cut. */
+  beforeAfter: z38.object({
+    beforeSceneId: id2,
+    afterSceneId: id2,
+    surface: z38.enum([
+      "rigid",
+      "soft"
+    ])
+  }).strict().optional()
+}).strict();
 var CreativeEnginePlanSchema = z38.object({
   revision: z38.number().int().positive(),
   execution: CreativeEngineExecutionSchema.optional(),
@@ -11481,7 +11515,9 @@ var CreativeEnginePlanSchema = z38.object({
   music: z38.literal(false),
   scenes: z38.array(CreativeEngineSceneSchema).min(1).max(CREATIVE_ENGINE_MAX_PLAN_SCENES),
   /** The commercial binding actually applied; absent on guided/historical. */
-  commercialExecution: CreativeEngineCommercialExecutionSchema.optional()
+  commercialExecution: CreativeEngineCommercialExecutionSchema.optional(),
+  /** Voiceless «Viral» story; absent on every other narrative. */
+  viral: CreativeEngineViralPlanSchema.optional()
 }).strict();
 var CreativeEngineSpeakerRegionSchema = z38.object({
   x: z38.number().finite().min(0).max(1),
@@ -12001,6 +12037,14 @@ var CreativeEngineStateSchema = z38.object({
      * seller-facing script equals the approved one (no second approval).
      */
     carriedPlanHash: hash.optional(),
+    /**
+     * Who approved without the seller: a «Viral» script has no editable
+     * dialogue, so the system approves it on the seller's behalf.
+     */
+    approvedBy: z38.object({
+      actor: z38.literal("system"),
+      reason: z38.literal("viral_auto")
+    }).strict().optional(),
     waitingStartedAtMs: z38.number().int().nonnegative().optional(),
     pausedMs: z38.number().int().nonnegative()
   }).strict().optional(),
@@ -12225,7 +12269,8 @@ var VideoGeneratorAiEdit = z39.object({
   error: z39.string().optional()
 });
 var VideoCreativeDirection = CreativeEnginePlanSchema.pick({
-  guide: true
+  guide: true,
+  viral: true
 });
 var VideoGenerator = z39.object({
   aiEdit: VideoGeneratorAiEdit.nullable().optional(),
@@ -12326,7 +12371,10 @@ var VideoScriptSceneForReview = z39.object({
   /** Objective visual observed in the winner source scene. */
   winnerVisual: z39.string().optional(),
   /** Localized target visual expected to accompany this spoken line. */
-  expectedVisual: z39.string().optional()
+  expectedVisual: z39.string().optional(),
+  /** «Viral» (voiceless) plans only: the label burned on screen over this
+  * scene. Shown read-only in place of dialogue; the scene has no voice. */
+  onScreenLabel: z39.string().optional()
 });
 var VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
 var VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
@@ -24226,7 +24274,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 8.6.0: + storyteller narrative family and animationStyle axis.
     // MCP 8.10.0: storyteller family blocked (BLOCKED_NARRATIVE_STYLES).
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
-    "5991b2e897aad7b10c4e38a93e8c58234741498393439cf0228ed9ffd966efef",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bfe5130b1941f5f0a690949411d83cdbd32c1ee65cc75f2c22568b87bfe90a42",
     "credit_consuming",
     "creative",
     [
@@ -24285,7 +24334,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
     // MCP 12.4.0: landingStrategy narrowed to classic + social_proof.
     // MCP 12.5.0: pain_solution restored to landingStrategy.
-    "68a740d97238e720000c16db56ae5748ceb560e342f8fbfe605c954e6284fda7",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bc90378e921718099faae3f6a11cac4f1fdd81727729d6df581f1f827f94a240",
     "credit_consuming",
     "creative",
     [
@@ -24491,28 +24541,38 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "task_draft"
   ]),
-  defineCapability("estimate_creative_variant", "468079ba24e5e0d3c5c707cd54fec64571be429e66cadc12019af4d6e9d10c4e", "none", "read_only", [
-    "read"
-  ], [
-    slot("source_task", true, [
-      "sourceTaskId"
-    ]),
-    slot("creative_kind", true, [
-      "kind"
-    ]),
-    slot("variant_options", false, [
-      "videoPreset",
-      "videoResolution",
-      "nVariants",
-      "sectionKey",
-      "instructions"
-    ])
-  ], [
-    "task",
-    "creative"
-  ], [
-    "cost_estimate"
-  ]),
+  defineCapability(
+    "estimate_creative_variant",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "743d227d050dab27a8b385c9bc2c0c2d5b450e22abfed811c344b65faffb29ab",
+    "none",
+    "read_only",
+    [
+      "read"
+    ],
+    [
+      slot("source_task", true, [
+        "sourceTaskId"
+      ]),
+      slot("creative_kind", true, [
+        "kind"
+      ]),
+      slot("variant_options", false, [
+        "videoPreset",
+        "videoResolution",
+        "nVariants",
+        "sectionKey",
+        "instructions"
+      ])
+    ],
+    [
+      "task",
+      "creative"
+    ],
+    [
+      "cost_estimate"
+    ]
+  ),
   defineCapability("estimate_market_study_cost", "d1fbe8ead642d481258c419a1eed059f9c8188d1cd9f2d4eed12e202fc8800a4", "none", "read_only", [
     "read"
   ], [
@@ -24845,7 +24905,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 8.6.0: + storyteller narrative family and animationStyle axis.
     // MCP 8.10.0: storyteller family blocked (BLOCKED_NARRATIVE_STYLES).
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
-    "66dee35d59da0e88e72e24c503f3f1dc46c17c1162d98d48705e2bfe552f3f02",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "0669339f0e89332c23588c9a91be31e4700a655367beaa5945569fe329cbf5b9",
     "credit_consuming",
     "creative",
     [
@@ -25624,42 +25685,52 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "media_upload_session"
   ], MCP_ONLY_CHANNEL_EXPOSURE),
-  defineCapability("resolve_pending_action", "a7fef1e3299c2bfb387a16b3e1e243fba8df1db961ebc1f27d2119209124c293", "credit_consuming", "creative", [
+  defineCapability(
+    "resolve_pending_action",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bba3af0b7022b79ba4859c7d6b880e835459cb23095d22147cb17127e8fb0dc9",
     "credit_consuming",
-    "state_change"
-  ], [
-    slot("task", true, [
-      "taskId"
-    ]),
-    slot("action", true, [
-      "action"
-    ], [
-      "actionKind"
-    ]),
-    slot("action_payload", false, [], [
-      "userChoice",
-      "selectedAngleIndex",
-      "confirmedProductNames",
-      "customAngle",
-      "painPoints",
-      "benefits",
-      "features",
-      "useMultiSceneShowcase",
-      "gapDurationSeconds",
-      "narrativeSelection",
-      "angleId",
-      "content",
-      "creativeDirection",
-      "actor",
-      "voiceovers",
-      "visualDirections"
-    ])
-  ], [
-    "task",
-    "pending_action"
-  ], [
-    "task"
-  ]),
+    "creative",
+    [
+      "credit_consuming",
+      "state_change"
+    ],
+    [
+      slot("task", true, [
+        "taskId"
+      ]),
+      slot("action", true, [
+        "action"
+      ], [
+        "actionKind"
+      ]),
+      slot("action_payload", false, [], [
+        "userChoice",
+        "selectedAngleIndex",
+        "confirmedProductNames",
+        "customAngle",
+        "painPoints",
+        "benefits",
+        "features",
+        "useMultiSceneShowcase",
+        "gapDurationSeconds",
+        "narrativeSelection",
+        "angleId",
+        "content",
+        "creativeDirection",
+        "actor",
+        "voiceovers",
+        "visualDirections"
+      ])
+    ],
+    [
+      "task",
+      "pending_action"
+    ],
+    [
+      "task"
+    ]
+  ),
   defineCapability("start_dropshipping_project", "996385df905ed85a933c5726fbebf5a29a98f29364badd8256ff306aff38797c", "state_change", "business", [
     "state_change"
   ], [
@@ -26577,7 +26648,10 @@ var MCP_HIDDEN_NARRATIVE_STYLES = [
   "gap_replication",
   // The blocked storyteller family is not offered, not even when revising an
   // existing script.
-  ...BLOCKED_NARRATIVE_STYLES
+  ...BLOCKED_NARRATIVE_STYLES,
+  // «Viral» only renders on the unified engine, whose scripts are reviewed in
+  // place: the previous engine's narrative regeneration cannot produce it.
+  "viral"
 ];
 var McpNarrativeStyleSchema = NarrativeStyle.exclude(MCP_HIDDEN_NARRATIVE_STYLES);
 var MCP_ANGLE_NARRATIVE_STYLES = [
@@ -26591,6 +26665,9 @@ var MCP_ANGLE_NARRATIVE_STYLES = [
   "wild_card",
   "animated_problem_pixar",
   "sassy_product_pixar",
+  // Manual-only, voiceless, unified engine only; the API admits it per user
+  // (`CREATIVE_VIRAL_NARRATIVE_USER_IDS`).
+  "viral",
   "market"
 ];
 var McpAngleNarrativeStyleSchema = NarrativeStyle.extract(MCP_ANGLE_NARRATIVE_STYLES);
@@ -27783,8 +27860,11 @@ var CreativeCompositionLocalManifestSchema = z111.object({
     scenes: z111.array(z111.object({
       id: id3,
       startSec: z111.number().nonnegative(),
-      durationSec: z111.number().positive()
-    }).strict()).min(1)
+      durationSec: z111.number().positive(),
+      /** «Viral» plans only: the one label the page burns over this scene. */
+      copy: z111.array(z111.string()).optional()
+    }).strict()).min(1),
+    viral: CreativeEngineViralPlanSchema.optional()
   }).strict(),
   planHash: hash2,
   context: CreativeEngineContextBindingSchema,
@@ -32212,7 +32292,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.11.0";
+var MCP_VERSION = "12.12.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -33219,7 +33299,8 @@ var VideoPresetEnum = VideoPreset.extract([
   "cinematic",
   "wild_card",
   "pixar_problem",
-  "pixar_sassy"
+  "pixar_sassy",
+  "viral"
 ]);
 var VideoStructureEnum = VideoStructure;
 var VideoQualityEnum = VideoQuality;
@@ -33251,6 +33332,10 @@ var VIDEO_PRESET_RESOLUTION = {
     videoStyle: "ai_dynamic",
     narrativeStyle: "sassy_product_pixar"
   },
+  viral: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "viral"
+  },
   product_showcase: {
     videoStyle: "product_only",
     narrativeStyle: "product_showcase"
@@ -36133,7 +36218,7 @@ var CreateProductTaskInput = z141.object({
   paymentMethods: z141.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago que puede mostrar la landing. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
   productContext: z141.string().max(PRODUCT_CONTEXT_MAX_CHARS).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
   productLabel: z141.string().trim().max(80).optional().describe('Opcional. Qu\xE9 es el producto, en pocas palabras (ej. "quita pelusas para ropa"). Es AUTORITATIVO: si lo env\xEDas, la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA detecta el producto desde la imagen.'),
-  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets funcionan a 15s (single_call) y 30s (Multiescena); "problem_solution" en single_call abre sin el producto y el producto entra por referencia en su beat de soluci\xF3n. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (idea imposible: un truco visual que en la vida real no podr\xEDa pasar, y al cierre la invitaci\xF3n a comprar), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
+  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets salvo "viral" (solo Multiescena de 15 s) funcionan a 15s (single_call) y 30s (Multiescena); "problem_solution" en single_call abre sin el producto y el producto entra por referencia en su beat de soluci\xF3n. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (idea imposible: un truco visual que en la vida real no podr\xEDa pasar, y al cierre la invitaci\xF3n a comprar), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla), "viral" (video sin voz con r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
   animationStyle: AnimationStyleEnum.optional().describe('Opcional. Estilo visual SOLO para presets animados ("pixar_problem" o "pixar_sassy") \u2014 la API lo rechaza con cualquier otro preset. Opciones: "pixar_3d" (default, look 3D de pel\xEDcula animada), "claymation" (plastilina stop-motion artesanal), "wes_anderson" (tableau sim\xE9trico pastel), "sci_fi" (futurista con HUDs y ne\xF3n), "realista" (fotorrealista, fiel al producto). Si el usuario pide un look animado sin nombrar el estilo, omite el campo.'),
   durationSeconds: z141.union([
     z141.literal(15),
@@ -36146,7 +36231,7 @@ var CreateProductTaskInput = z141.object({
   videoQuality: VideoQualityEnum.default("economy").describe('Opcional. Calidad: "economy" = Econ\xF3mico, "medium" = Medio o "pro" = Pro. El proveedor se elige internamente. Default: economy.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   videoAngleCount: z141.number().int().min(1).max(3).optional().describe("Cantidad de videos a renderizar: 1, 2 o 3. REQUERIDO cuando outputs incluye video (o se omite outputs, cuyo default incluye video); om\xEDtelo s\xF3lo cuando no se generar\xE1 video. Preg\xFAntalo incluso con aiDecidesAll=true porque cambia el costo."),
-  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
+  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "viral" (video sin voz: r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones), "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
   outputs: z141.array(z141.enum([
     "landing",
     "video",
@@ -36256,7 +36341,7 @@ var PendingActionPayload = z141.discriminatedUnion("kind", [
     // an opaque HTTP 400 after the model already believed it had been saved.
     features: z141.array(z141.string().min(1).max(MCP_REVIEW_FEATURE_ITEM_MAX)).max(10).optional(),
     buyerPersona: z141.string().min(1).max(360).optional(),
-    narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora.'),
+    narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora. "viral" (sin voz, r\xF3tulos y antes/despu\xE9s; solo Multiescena de 15 s) solo est\xE1 disponible para cuentas habilitadas y tareas del motor nuevo.'),
     actor: z141.string().min(1).max(360).optional().describe("Nueva descripci\xF3n del presentador. Al enviarla sin actorId, se elimina autom\xE1ticamente cualquier actor guardado previo de esos \xE1ngulos."),
     actorId: z141.string().max(120).nullable().optional(),
     creativeDirection: z141.string().max(2e3).optional(),
@@ -36269,7 +36354,7 @@ var PendingActionPayload = z141.discriminatedUnion("kind", [
       ]).optional().describe("Elecci\xF3n expl\xEDcita: market usa el estudio disponible; guided usa la narrativa elegida para este \xE1ngulo."),
       angle: z141.string().min(1).max(480).optional(),
       buyerPersona: z141.string().min(1).max(360).optional(),
-      narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora.'),
+      narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora. "viral" (sin voz, r\xF3tulos y antes/despu\xE9s; solo Multiescena de 15 s) solo est\xE1 disponible para cuentas habilitadas y tareas del motor nuevo.'),
       actor: z141.string().min(1).max(360).optional(),
       actorId: z141.string().max(120).nullable().optional(),
       creativeDirection: z141.string().max(2e3).optional()
@@ -38429,7 +38514,7 @@ var VideoCreativeSetup = z145.discriminatedUnion("mode", [
   }).strict(),
   z145.object({
     mode: z145.literal("guided"),
-    videoPreset: VideoPresetEnum.default("auto").describe('Narrativa opcional. Con estudio de mercado no la preguntes: se usa "auto" y el estudio define la estructura. Sin estudio conserva la elecci\xF3n del usuario. Todas las narrativas funcionan en Un solo clip y Multiescena.'),
+    videoPreset: VideoPresetEnum.default("auto").describe('Narrativa opcional. Con estudio de mercado no la preguntes: se usa "auto" y el estudio define la estructura. Sin estudio conserva la elecci\xF3n del usuario. Todas las narrativas salvo "viral" funcionan en Un solo clip y Multiescena. "viral" es un video sin voz (r\xF3tulos en pantalla, antes/despu\xE9s), solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones.'),
     buyerPersona: z145.string().trim().min(1).max(360),
     animationStyle: AnimationStyleEnum.optional().describe('Opcional. Estilo visual SOLO para presets animados ("pixar_problem" o "pixar_sassy") \u2014 la API lo rechaza con cualquier otro preset. Opciones: "pixar_3d" (default, look 3D de pel\xEDcula animada), "claymation" (plastilina stop-motion artesanal), "wes_anderson" (tableau sim\xE9trico pastel), "sci_fi" (futurista con HUDs y ne\xF3n), "realista" (fotorrealista, fiel al producto). Si el usuario pide un look animado sin nombrar el estilo, omite el campo.'),
     presenter: VideoPresenter,
@@ -38451,7 +38536,7 @@ var VideoInput = z145.object({
   generateAiEdit: AiEditRequestSchema.optional().describe('Opcional. Pide la Edici\xF3n con IA: una pasada que a\xF1ade texto, efectos y m\xFAsica sobre cada video entregado (variante with_ai_edit; se cobra al entregar, por video). Nivel: "economy" (Econ\xF3mica, Sonnet 5.5, m\xE1s barata) o "pro" (Opus 5.5, mejor calidad, ~10 min). true equivale a "pro"; false/omitido = sin edici\xF3n.'),
   durationSeconds: z145.number().int().min(4).max(30).default(15).describe("Opcional. Duraci\xF3n objetivo: Un solo clip Econ\xF3mico o Medio usa 15s; Un solo clip Pro usa 15s o 30s; Multiescena usa 15s o 30s totales. La combinaci\xF3n de formato y calidad determina la ruta y el costo."),
   videoAngleCount: z145.number().int().min(1).max(3).describe("Cantidad de videos a renderizar: 1, 2 o 3. Es una decisi\xF3n de costo obligatoria: preg\xFAntala incluso cuando creativeSetup.mode=automatic."),
-  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
+  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "viral" (video sin voz: r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones), "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
   creativeSetup: VideoCreativeSetup.describe("Configuraci\xF3n creativa obligatoria. En guided pregunta narrativa, p\xFAblico, presentador y direcci\xF3n antes de confirmar. Usa automatic s\xF3lo si el usuario deleg\xF3 todo expl\xEDcitamente."),
   videoStructure: VideoStructureEnum.default("single_take").describe('Opcional. Formato: "single_take" = Un solo clip (generado completo; puede incluir cambios de plano) o "multi_scene" = Multiescena (varias tomas concatenadas). Default: single_take.'),
   videoQuality: VideoQualityEnum.default("economy").describe('Opcional. Calidad: "economy" = Econ\xF3mico, "medium" = Medio o "pro" = Pro. El sistema elige el proveedor internamente. Default: economy.'),
@@ -39364,7 +39449,7 @@ var RegenerateVideoScriptInput = RegenerateVideoScriptCapabilityRequest.extend({
 });
 function registerScriptReviewTools(server, api) {
   server.registerTool("get_video_script", {
-    description: getVideoScriptGuidance.summary + ' 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?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\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 llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 consulta `get_task_status` antes de ofrecer recuperaci\xF3n. No regeneres autom\xE1ticamente una tarea terminal.\n\nANGLE KEY: usa las claves expl\xEDcitas de reviewNextAction.calls, incluso si s\xF3lo seleccionaste un candidato. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.',
+    description: getVideoScriptGuidance.summary + ' 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?, persuasiveFunction?, winnerVisual?, expectedVisual?, onScreenLabel? }], error? }. En videos \xABViral\xBB (sin voz) cada escena trae `onScreenLabel`: mu\xE9stralo como \xABTexto en pantalla\xBB; su `dialogue` viene vac\xEDo y no pidas di\xE1logo para esas escenas. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\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 llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 consulta `get_task_status` antes de ofrecer recuperaci\xF3n. No regeneres autom\xE1ticamente una tarea terminal.\n\nANGLE KEY: usa las claves expl\xEDcitas de reviewNextAction.calls, incluso si s\xF3lo seleccionaste un candidato. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.',
     inputSchema: GetVideoScriptInput.shape,
     annotations: READS_INTERNAL
   }, async (input) => {

package/dist/stdio.js

@@ -69,7 +69,11 @@ var NarrativeStyle = z.enum([
   "animated_storyteller",
   "animated_inner_journey",
   "animated_object_soul",
-  "animated_timeline"
+  "animated_timeline",
+  // Voiceless story on the unified engine only: on-screen labels, before/after
+  // and a format the director picks from the Product Truth. Manual-only and
+  // admitted per user (`CREATIVE_VIRAL_NARRATIVE_USER_IDS`); never Auto.
+  "viral"
 ]);
 var BLOCKED_NARRATIVE_STYLES = [
   "animated_storyteller",
@@ -115,7 +119,8 @@ var VideoPreset = z.enum([
   "ugc_listicle_3",
   "ugc_skeptic_confession",
   "ugc_demo_review",
-  "metaphor_product"
+  "metaphor_product",
+  "viral"
 ]);
 var VoiceId = z.string().refine((value) => !value.trim().toLowerCase().startsWith("bank:"), "El banco de voces fue retirado. Usa Auto o la voz privada de un actor.");
 var _VIDEO_MODEL_SET = new Set(VideoModel.options);
@@ -4306,6 +4311,37 @@ var TaskKind = z8.enum([
 // ../../packages/types/src/product.ts
 import { z as z10 } from "zod";
 
+// ../../packages/types/src/price-numeric.ts
+function parsePriceNumeric(raw) {
+  if (!raw) return null;
+  const cleaned = raw.replace(/[^\d.,-]/g, "").trim();
+  if (!cleaned || cleaned === "-") return null;
+  const hasDot = cleaned.includes(".");
+  const hasComma = cleaned.includes(",");
+  let normalized = cleaned;
+  if (hasDot && hasComma) {
+    const lastDot = cleaned.lastIndexOf(".");
+    const lastComma = cleaned.lastIndexOf(",");
+    const decimal = lastDot > lastComma ? "." : ",";
+    const thousands = decimal === "." ? "," : ".";
+    normalized = cleaned.split(thousands).join("");
+    if (decimal === ",") normalized = normalized.replace(",", ".");
+  } else if (hasDot) {
+    const parts = cleaned.split(".");
+    const lastGroup = parts[parts.length - 1] ?? "";
+    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
+    if (isThousands) normalized = parts.join("");
+  } else if (hasComma) {
+    const parts = cleaned.split(",");
+    const lastGroup = parts[parts.length - 1] ?? "";
+    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
+    normalized = isThousands ? parts.join("") : cleaned.replace(",", ".");
+  }
+  const n = Number(normalized);
+  return Number.isFinite(n) ? n : null;
+}
+__name(parsePriceNumeric, "parsePriceNumeric");
+
 // ../../packages/types/src/product-reference-set.ts
 import { z as z9 } from "zod";
 var ProductReferenceScopeSchema = z9.enum([
@@ -4773,35 +4809,6 @@ var OfferSchema = z10.string().min(1).max(240);
 var CompareAtPriceSchema = z10.string().min(1).max(120);
 var PaymentMethodsSchema = z10.string().min(1).max(240);
 var LanguageCodeSchema = z10.string().regex(/^[a-z]{2}(?:[-_][a-zA-Z]{2})?$/, "Invalid language code").max(10);
-function parsePriceNumeric(raw) {
-  if (!raw) return null;
-  const cleaned = raw.replace(/[^\d.,-]/g, "").trim();
-  if (!cleaned || cleaned === "-") return null;
-  const hasDot = cleaned.includes(".");
-  const hasComma = cleaned.includes(",");
-  let normalized = cleaned;
-  if (hasDot && hasComma) {
-    const lastDot = cleaned.lastIndexOf(".");
-    const lastComma = cleaned.lastIndexOf(",");
-    const decimal = lastDot > lastComma ? "." : ",";
-    const thousands = decimal === "." ? "," : ".";
-    normalized = cleaned.split(thousands).join("");
-    if (decimal === ",") normalized = normalized.replace(",", ".");
-  } else if (hasDot) {
-    const parts = cleaned.split(".");
-    const lastGroup = parts[parts.length - 1] ?? "";
-    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
-    if (isThousands) normalized = parts.join("");
-  } else if (hasComma) {
-    const parts = cleaned.split(",");
-    const lastGroup = parts[parts.length - 1] ?? "";
-    const isThousands = parts.length > 2 || parts.length === 2 && lastGroup.length === 3;
-    normalized = isThousands ? parts.join("") : cleaned.replace(",", ".");
-  }
-  const n = Number(normalized);
-  return Number.isFinite(n) ? n : null;
-}
-__name(parsePriceNumeric, "parsePriceNumeric");
 var PRICE_SKIP_SENTINELS = /* @__PURE__ */ new Set([
   "skip",
   "none",
@@ -7636,11 +7643,16 @@ var PersistedBundleBindingSchema = z22.object({
    * the price comparison when it is absent.
    */
   priceAtPublish: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).optional(),
+  compareAtPriceAtPublish: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).nullable().optional(),
+  /** Seller's offer at publish time, independent of what Shopify charged. */
+  offerAtPublish: z22.object({
+    price: z22.string().trim().min(1).max(MAX_MONEY_LENGTH),
+    compareAtPrice: z22.string().trim().min(1).max(MAX_MONEY_LENGTH).nullable()
+  }).strict().optional(),
   /**
    * How the binding was produced: `mapped` = merchant-confirmed against an
    * existing catalog, `created` = ProductMaker-created "Oferta" variant,
-   * `implicit` = legacy exact-structure match (not persisted today; kept
-   * for forward compatibility).
+   * `implicit` = exact-structure match.
    */
   mode: z22.enum([
     "mapped",
@@ -11240,6 +11252,28 @@ var CreativeEngineSceneSchema = z38.object({
   timeline: CreativeEngineTimelineSchema.optional(),
   factPaths: z38.array(id2)
 }).strict();
+var CreativeEngineViralFormatSchema = z38.enum([
+  "pas",
+  "before_after",
+  "demo",
+  "pov",
+  "gift",
+  "concept_vs_result"
+]);
+var CreativeEngineViralPlanSchema = z38.object({
+  format: CreativeEngineViralFormatSchema,
+  /** The scene that shows the product's critical feature working. */
+  mechanismSceneId: id2,
+  /** Two stills of the same subject and framing: rigid surfaces wipe, soft ones (hair, skin, fabric) cut. */
+  beforeAfter: z38.object({
+    beforeSceneId: id2,
+    afterSceneId: id2,
+    surface: z38.enum([
+      "rigid",
+      "soft"
+    ])
+  }).strict().optional()
+}).strict();
 var CreativeEnginePlanSchema = z38.object({
   revision: z38.number().int().positive(),
   execution: CreativeEngineExecutionSchema.optional(),
@@ -11256,7 +11290,9 @@ var CreativeEnginePlanSchema = z38.object({
   music: z38.literal(false),
   scenes: z38.array(CreativeEngineSceneSchema).min(1).max(CREATIVE_ENGINE_MAX_PLAN_SCENES),
   /** The commercial binding actually applied; absent on guided/historical. */
-  commercialExecution: CreativeEngineCommercialExecutionSchema.optional()
+  commercialExecution: CreativeEngineCommercialExecutionSchema.optional(),
+  /** Voiceless «Viral» story; absent on every other narrative. */
+  viral: CreativeEngineViralPlanSchema.optional()
 }).strict();
 var CreativeEngineSpeakerRegionSchema = z38.object({
   x: z38.number().finite().min(0).max(1),
@@ -11776,6 +11812,14 @@ var CreativeEngineStateSchema = z38.object({
      * seller-facing script equals the approved one (no second approval).
      */
     carriedPlanHash: hash.optional(),
+    /**
+     * Who approved without the seller: a «Viral» script has no editable
+     * dialogue, so the system approves it on the seller's behalf.
+     */
+    approvedBy: z38.object({
+      actor: z38.literal("system"),
+      reason: z38.literal("viral_auto")
+    }).strict().optional(),
     waitingStartedAtMs: z38.number().int().nonnegative().optional(),
     pausedMs: z38.number().int().nonnegative()
   }).strict().optional(),
@@ -12000,7 +12044,8 @@ var VideoGeneratorAiEdit = z39.object({
   error: z39.string().optional()
 });
 var VideoCreativeDirection = CreativeEnginePlanSchema.pick({
-  guide: true
+  guide: true,
+  viral: true
 });
 var VideoGenerator = z39.object({
   aiEdit: VideoGeneratorAiEdit.nullable().optional(),
@@ -12101,7 +12146,10 @@ var VideoScriptSceneForReview = z39.object({
   /** Objective visual observed in the winner source scene. */
   winnerVisual: z39.string().optional(),
   /** Localized target visual expected to accompany this spoken line. */
-  expectedVisual: z39.string().optional()
+  expectedVisual: z39.string().optional(),
+  /** «Viral» (voiceless) plans only: the label burned on screen over this
+  * scene. Shown read-only in place of dialogue; the scene has no voice. */
+  onScreenLabel: z39.string().optional()
 });
 var VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
 var VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
@@ -24001,7 +24049,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 8.6.0: + storyteller narrative family and animationStyle axis.
     // MCP 8.10.0: storyteller family blocked (BLOCKED_NARRATIVE_STYLES).
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
-    "5991b2e897aad7b10c4e38a93e8c58234741498393439cf0228ed9ffd966efef",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bfe5130b1941f5f0a690949411d83cdbd32c1ee65cc75f2c22568b87bfe90a42",
     "credit_consuming",
     "creative",
     [
@@ -24060,7 +24109,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
     // MCP 12.4.0: landingStrategy narrowed to classic + social_proof.
     // MCP 12.5.0: pain_solution restored to landingStrategy.
-    "68a740d97238e720000c16db56ae5748ceb560e342f8fbfe605c954e6284fda7",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bc90378e921718099faae3f6a11cac4f1fdd81727729d6df581f1f827f94a240",
     "credit_consuming",
     "creative",
     [
@@ -24266,28 +24316,38 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "task_draft"
   ]),
-  defineCapability("estimate_creative_variant", "468079ba24e5e0d3c5c707cd54fec64571be429e66cadc12019af4d6e9d10c4e", "none", "read_only", [
-    "read"
-  ], [
-    slot("source_task", true, [
-      "sourceTaskId"
-    ]),
-    slot("creative_kind", true, [
-      "kind"
-    ]),
-    slot("variant_options", false, [
-      "videoPreset",
-      "videoResolution",
-      "nVariants",
-      "sectionKey",
-      "instructions"
-    ])
-  ], [
-    "task",
-    "creative"
-  ], [
-    "cost_estimate"
-  ]),
+  defineCapability(
+    "estimate_creative_variant",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "743d227d050dab27a8b385c9bc2c0c2d5b450e22abfed811c344b65faffb29ab",
+    "none",
+    "read_only",
+    [
+      "read"
+    ],
+    [
+      slot("source_task", true, [
+        "sourceTaskId"
+      ]),
+      slot("creative_kind", true, [
+        "kind"
+      ]),
+      slot("variant_options", false, [
+        "videoPreset",
+        "videoResolution",
+        "nVariants",
+        "sectionKey",
+        "instructions"
+      ])
+    ],
+    [
+      "task",
+      "creative"
+    ],
+    [
+      "cost_estimate"
+    ]
+  ),
   defineCapability("estimate_market_study_cost", "d1fbe8ead642d481258c419a1eed059f9c8188d1cd9f2d4eed12e202fc8800a4", "none", "read_only", [
     "read"
   ], [
@@ -24620,7 +24680,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 8.6.0: + storyteller narrative family and animationStyle axis.
     // MCP 8.10.0: storyteller family blocked (BLOCKED_NARRATIVE_STYLES).
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
-    "66dee35d59da0e88e72e24c503f3f1dc46c17c1162d98d48705e2bfe552f3f02",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "0669339f0e89332c23588c9a91be31e4700a655367beaa5945569fe329cbf5b9",
     "credit_consuming",
     "creative",
     [
@@ -25399,42 +25460,52 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "media_upload_session"
   ], MCP_ONLY_CHANNEL_EXPOSURE),
-  defineCapability("resolve_pending_action", "a7fef1e3299c2bfb387a16b3e1e243fba8df1db961ebc1f27d2119209124c293", "credit_consuming", "creative", [
+  defineCapability(
+    "resolve_pending_action",
+    // MCP 12.8.0: + manual-only, cohort-gated «viral» preset/angle narrative.
+    "bba3af0b7022b79ba4859c7d6b880e835459cb23095d22147cb17127e8fb0dc9",
     "credit_consuming",
-    "state_change"
-  ], [
-    slot("task", true, [
-      "taskId"
-    ]),
-    slot("action", true, [
-      "action"
-    ], [
-      "actionKind"
-    ]),
-    slot("action_payload", false, [], [
-      "userChoice",
-      "selectedAngleIndex",
-      "confirmedProductNames",
-      "customAngle",
-      "painPoints",
-      "benefits",
-      "features",
-      "useMultiSceneShowcase",
-      "gapDurationSeconds",
-      "narrativeSelection",
-      "angleId",
-      "content",
-      "creativeDirection",
-      "actor",
-      "voiceovers",
-      "visualDirections"
-    ])
-  ], [
-    "task",
-    "pending_action"
-  ], [
-    "task"
-  ]),
+    "creative",
+    [
+      "credit_consuming",
+      "state_change"
+    ],
+    [
+      slot("task", true, [
+        "taskId"
+      ]),
+      slot("action", true, [
+        "action"
+      ], [
+        "actionKind"
+      ]),
+      slot("action_payload", false, [], [
+        "userChoice",
+        "selectedAngleIndex",
+        "confirmedProductNames",
+        "customAngle",
+        "painPoints",
+        "benefits",
+        "features",
+        "useMultiSceneShowcase",
+        "gapDurationSeconds",
+        "narrativeSelection",
+        "angleId",
+        "content",
+        "creativeDirection",
+        "actor",
+        "voiceovers",
+        "visualDirections"
+      ])
+    ],
+    [
+      "task",
+      "pending_action"
+    ],
+    [
+      "task"
+    ]
+  ),
   defineCapability("start_dropshipping_project", "996385df905ed85a933c5726fbebf5a29a98f29364badd8256ff306aff38797c", "state_change", "business", [
     "state_change"
   ], [
@@ -26345,7 +26416,10 @@ var MCP_HIDDEN_NARRATIVE_STYLES = [
   "gap_replication",
   // The blocked storyteller family is not offered, not even when revising an
   // existing script.
-  ...BLOCKED_NARRATIVE_STYLES
+  ...BLOCKED_NARRATIVE_STYLES,
+  // «Viral» only renders on the unified engine, whose scripts are reviewed in
+  // place: the previous engine's narrative regeneration cannot produce it.
+  "viral"
 ];
 var McpNarrativeStyleSchema = NarrativeStyle.exclude(MCP_HIDDEN_NARRATIVE_STYLES);
 var MCP_ANGLE_NARRATIVE_STYLES = [
@@ -26359,6 +26433,9 @@ var MCP_ANGLE_NARRATIVE_STYLES = [
   "wild_card",
   "animated_problem_pixar",
   "sassy_product_pixar",
+  // Manual-only, voiceless, unified engine only; the API admits it per user
+  // (`CREATIVE_VIRAL_NARRATIVE_USER_IDS`).
+  "viral",
   "market"
 ];
 var McpAngleNarrativeStyleSchema = NarrativeStyle.extract(MCP_ANGLE_NARRATIVE_STYLES);
@@ -27551,8 +27628,11 @@ var CreativeCompositionLocalManifestSchema = z111.object({
     scenes: z111.array(z111.object({
       id: id3,
       startSec: z111.number().nonnegative(),
-      durationSec: z111.number().positive()
-    }).strict()).min(1)
+      durationSec: z111.number().positive(),
+      /** «Viral» plans only: the one label the page burns over this scene. */
+      copy: z111.array(z111.string()).optional()
+    }).strict()).min(1),
+    viral: CreativeEngineViralPlanSchema.optional()
   }).strict(),
   planHash: hash2,
   context: CreativeEngineContextBindingSchema,
@@ -30539,7 +30619,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.11.0";
+var MCP_VERSION = "12.12.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -31550,7 +31630,8 @@ var VideoPresetEnum = VideoPreset.extract([
   "cinematic",
   "wild_card",
   "pixar_problem",
-  "pixar_sassy"
+  "pixar_sassy",
+  "viral"
 ]);
 var VideoStructureEnum = VideoStructure;
 var VideoQualityEnum = VideoQuality;
@@ -31582,6 +31663,10 @@ var VIDEO_PRESET_RESOLUTION = {
     videoStyle: "ai_dynamic",
     narrativeStyle: "sassy_product_pixar"
   },
+  viral: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "viral"
+  },
   product_showcase: {
     videoStyle: "product_only",
     narrativeStyle: "product_showcase"
@@ -34618,7 +34703,7 @@ var CreateProductTaskInput = z140.object({
   paymentMethods: z140.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago que puede mostrar la landing. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
   productContext: z140.string().max(PRODUCT_CONTEXT_MAX_CHARS).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
   productLabel: z140.string().trim().max(80).optional().describe('Opcional. Qu\xE9 es el producto, en pocas palabras (ej. "quita pelusas para ropa"). Es AUTORITATIVO: si lo env\xEDas, la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA detecta el producto desde la imagen.'),
-  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets funcionan a 15s (single_call) y 30s (Multiescena); "problem_solution" en single_call abre sin el producto y el producto entra por referencia en su beat de soluci\xF3n. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (idea imposible: un truco visual que en la vida real no podr\xEDa pasar, y al cierre la invitaci\xF3n a comprar), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
+  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets salvo "viral" (solo Multiescena de 15 s) funcionan a 15s (single_call) y 30s (Multiescena); "problem_solution" en single_call abre sin el producto y el producto entra por referencia en su beat de soluci\xF3n. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (idea imposible: un truco visual que en la vida real no podr\xEDa pasar, y al cierre la invitaci\xF3n a comprar), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla), "viral" (video sin voz con r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
   animationStyle: AnimationStyleEnum.optional().describe('Opcional. Estilo visual SOLO para presets animados ("pixar_problem" o "pixar_sassy") \u2014 la API lo rechaza con cualquier otro preset. Opciones: "pixar_3d" (default, look 3D de pel\xEDcula animada), "claymation" (plastilina stop-motion artesanal), "wes_anderson" (tableau sim\xE9trico pastel), "sci_fi" (futurista con HUDs y ne\xF3n), "realista" (fotorrealista, fiel al producto). Si el usuario pide un look animado sin nombrar el estilo, omite el campo.'),
   durationSeconds: z140.union([
     z140.literal(15),
@@ -34631,7 +34716,7 @@ var CreateProductTaskInput = z140.object({
   videoQuality: VideoQualityEnum.default("economy").describe('Opcional. Calidad: "economy" = Econ\xF3mico, "medium" = Medio o "pro" = Pro. El proveedor se elige internamente. Default: economy.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   videoAngleCount: z140.number().int().min(1).max(3).optional().describe("Cantidad de videos a renderizar: 1, 2 o 3. REQUERIDO cuando outputs incluye video (o se omite outputs, cuyo default incluye video); om\xEDtelo s\xF3lo cuando no se generar\xE1 video. Preg\xFAntalo incluso con aiDecidesAll=true porque cambia el costo."),
-  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
+  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "viral" (video sin voz: r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones), "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
   outputs: z140.array(z140.enum([
     "landing",
     "video",
@@ -34741,7 +34826,7 @@ var PendingActionPayload = z140.discriminatedUnion("kind", [
     // an opaque HTTP 400 after the model already believed it had been saved.
     features: z140.array(z140.string().min(1).max(MCP_REVIEW_FEATURE_ITEM_MAX)).max(10).optional(),
     buyerPersona: z140.string().min(1).max(360).optional(),
-    narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora.'),
+    narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora. "viral" (sin voz, r\xF3tulos y antes/despu\xE9s; solo Multiescena de 15 s) solo est\xE1 disponible para cuentas habilitadas y tareas del motor nuevo.'),
     actor: z140.string().min(1).max(360).optional().describe("Nueva descripci\xF3n del presentador. Al enviarla sin actorId, se elimina autom\xE1ticamente cualquier actor guardado previo de esos \xE1ngulos."),
     actorId: z140.string().max(120).nullable().optional(),
     creativeDirection: z140.string().max(2e3).optional(),
@@ -34754,7 +34839,7 @@ var PendingActionPayload = z140.discriminatedUnion("kind", [
       ]).optional().describe("Elecci\xF3n expl\xEDcita: market usa el estudio disponible; guided usa la narrativa elegida para este \xE1ngulo."),
       angle: z140.string().min(1).max(480).optional(),
       buyerPersona: z140.string().min(1).max(360).optional(),
-      narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora.'),
+      narrativeStyle: PublicNarrativeStyleEnum.optional().describe('Narrativa del video. "problem_product_cta" (Problema y Soluci\xF3n) funciona en ambos formatos \u2014 en Un solo clip abre sin producto y el producto entra por referencia en su beat. La familia storyteller ("animated_storyteller", "animated_inner_journey", "animated_object_soul", "animated_timeline") no est\xE1 disponible por ahora. "viral" (sin voz, r\xF3tulos y antes/despu\xE9s; solo Multiescena de 15 s) solo est\xE1 disponible para cuentas habilitadas y tareas del motor nuevo.'),
       actor: z140.string().min(1).max(360).optional(),
       actorId: z140.string().max(120).nullable().optional(),
       creativeDirection: z140.string().max(2e3).optional()
@@ -36914,7 +36999,7 @@ var VideoCreativeSetup = z144.discriminatedUnion("mode", [
   }).strict(),
   z144.object({
     mode: z144.literal("guided"),
-    videoPreset: VideoPresetEnum.default("auto").describe('Narrativa opcional. Con estudio de mercado no la preguntes: se usa "auto" y el estudio define la estructura. Sin estudio conserva la elecci\xF3n del usuario. Todas las narrativas funcionan en Un solo clip y Multiescena.'),
+    videoPreset: VideoPresetEnum.default("auto").describe('Narrativa opcional. Con estudio de mercado no la preguntes: se usa "auto" y el estudio define la estructura. Sin estudio conserva la elecci\xF3n del usuario. Todas las narrativas salvo "viral" funcionan en Un solo clip y Multiescena. "viral" es un video sin voz (r\xF3tulos en pantalla, antes/despu\xE9s), solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones.'),
     buyerPersona: z144.string().trim().min(1).max(360),
     animationStyle: AnimationStyleEnum.optional().describe('Opcional. Estilo visual SOLO para presets animados ("pixar_problem" o "pixar_sassy") \u2014 la API lo rechaza con cualquier otro preset. Opciones: "pixar_3d" (default, look 3D de pel\xEDcula animada), "claymation" (plastilina stop-motion artesanal), "wes_anderson" (tableau sim\xE9trico pastel), "sci_fi" (futurista con HUDs y ne\xF3n), "realista" (fotorrealista, fiel al producto). Si el usuario pide un look animado sin nombrar el estilo, omite el campo.'),
     presenter: VideoPresenter,
@@ -36936,7 +37021,7 @@ var VideoInput = z144.object({
   generateAiEdit: AiEditRequestSchema.optional().describe('Opcional. Pide la Edici\xF3n con IA: una pasada que a\xF1ade texto, efectos y m\xFAsica sobre cada video entregado (variante with_ai_edit; se cobra al entregar, por video). Nivel: "economy" (Econ\xF3mica, Sonnet 5.5, m\xE1s barata) o "pro" (Opus 5.5, mejor calidad, ~10 min). true equivale a "pro"; false/omitido = sin edici\xF3n.'),
   durationSeconds: z144.number().int().min(4).max(30).default(15).describe("Opcional. Duraci\xF3n objetivo: Un solo clip Econ\xF3mico o Medio usa 15s; Un solo clip Pro usa 15s o 30s; Multiescena usa 15s o 30s totales. La combinaci\xF3n de formato y calidad determina la ruta y el costo."),
   videoAngleCount: z144.number().int().min(1).max(3).describe("Cantidad de videos a renderizar: 1, 2 o 3. Es una decisi\xF3n de costo obligatoria: preg\xFAntala incluso cuando creativeSetup.mode=automatic."),
-  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
+  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar", "viral" (video sin voz: r\xF3tulos en pantalla y antes/despu\xE9s; solo Multiescena de 15 s y solo para cuentas habilitadas; la API rechaza otras combinaciones), "market" (narrativa an\xE1lisis de mercado: adapta el video a los patrones ganadores estudiados de la competencia; requiere competitorScanEnabled: true). angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. La lista no puede superar videoAngleCount.'),
   creativeSetup: VideoCreativeSetup.describe("Configuraci\xF3n creativa obligatoria. En guided pregunta narrativa, p\xFAblico, presentador y direcci\xF3n antes de confirmar. Usa automatic s\xF3lo si el usuario deleg\xF3 todo expl\xEDcitamente."),
   videoStructure: VideoStructureEnum.default("single_take").describe('Opcional. Formato: "single_take" = Un solo clip (generado completo; puede incluir cambios de plano) o "multi_scene" = Multiescena (varias tomas concatenadas). Default: single_take.'),
   videoQuality: VideoQualityEnum.default("economy").describe('Opcional. Calidad: "economy" = Econ\xF3mico, "medium" = Medio o "pro" = Pro. El sistema elige el proveedor internamente. Default: economy.'),
@@ -37849,7 +37934,7 @@ var RegenerateVideoScriptInput = RegenerateVideoScriptCapabilityRequest.extend({
 });
 function registerScriptReviewTools(server, api) {
   server.registerTool("get_video_script", {
-    description: getVideoScriptGuidance.summary + ' 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?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\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 llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 consulta `get_task_status` antes de ofrecer recuperaci\xF3n. No regeneres autom\xE1ticamente una tarea terminal.\n\nANGLE KEY: usa las claves expl\xEDcitas de reviewNextAction.calls, incluso si s\xF3lo seleccionaste un candidato. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.',
+    description: getVideoScriptGuidance.summary + ' 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?, persuasiveFunction?, winnerVisual?, expectedVisual?, onScreenLabel? }], error? }. En videos \xABViral\xBB (sin voz) cada escena trae `onScreenLabel`: mu\xE9stralo como \xABTexto en pantalla\xBB; su `dialogue` viene vac\xEDo y no pidas di\xE1logo para esas escenas. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\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 llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 consulta `get_task_status` antes de ofrecer recuperaci\xF3n. No regeneres autom\xE1ticamente una tarea terminal.\n\nANGLE KEY: usa las claves expl\xEDcitas de reviewNextAction.calls, incluso si s\xF3lo seleccionaste un candidato. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.',
     inputSchema: GetVideoScriptInput.shape,
     annotations: READS_INTERNAL
   }, async (input) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "12.11.0",
+  "version": "12.12.0",
   "type": "module",
   "private": false,
   "description": "ProductMaker MCP server — cost products, generate landing pages, UGC videos, and ad creatives, and publish to Shopify, Meta Ads, and TikTok Ads.",