@productmaker/mcp 3.3.0 → 3.4.0

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.3.0";
+var MCP_VERSION = "3.4.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -1517,6 +1517,42 @@ var VideoTier = z5.preprocess((v) => v === "grok" ? "single_call" : v, z5.enum([
 ]));
 var DEFAULT_VIDEO_TIER = "single_call";
 
+// ../../packages/types/src/image-provider.ts
+var GPT_IMAGE_2_RATIOS_BLOCKED_ABOVE_1K = [
+  "4:5",
+  "5:4"
+];
+function gptImage2SupportsTier(aspectRatio, tier) {
+  if (tier === "gpt-image-2:1k") return true;
+  return !GPT_IMAGE_2_RATIOS_BLOCKED_ABOVE_1K.includes(aspectRatio);
+}
+__name(gptImage2SupportsTier, "gptImage2SupportsTier");
+var IMAGE_TIER_UNSUPPORTED_FOR_RATIO_RULE = "image_tier_unsupported_for_ratio";
+var IMAGE_TIER_LIST = [
+  "gpt-image-2:1k",
+  "gpt-image-2:2k",
+  "gpt-image-2:4k"
+];
+function parseImageTier(imageModel) {
+  const normalized = imageModel.trim().toLowerCase();
+  return IMAGE_TIER_LIST.includes(normalized) ? normalized : null;
+}
+__name(parseImageTier, "parseImageTier");
+function validateImageTierForRatio(aspectRatio, imageModel) {
+  if (!aspectRatio || !imageModel) return null;
+  const tier = parseImageTier(imageModel);
+  if (!tier) return null;
+  const ratio = aspectRatio.trim();
+  if (!GPT_IMAGE_2_RATIOS_BLOCKED_ABOVE_1K.includes(ratio)) return null;
+  if (gptImage2SupportsTier(ratio, tier)) return null;
+  return buildImageTierUnsupportedMessage(ratio);
+}
+__name(validateImageTierForRatio, "validateImageTierForRatio");
+function buildImageTierUnsupportedMessage(aspectRatio) {
+  return `El formato ${aspectRatio} solo est\xE1 disponible en calidad est\xE1ndar (1K). Elige 1K, o cambia el formato para usar Premium.`;
+}
+__name(buildImageTierUnsupportedMessage, "buildImageTierUnsupportedMessage");
+
 // ../../packages/types/src/angle.ts
 import { z as z6 } from "zod";
 var ImageWinnerSignal = z6.enum([
@@ -2857,6 +2893,19 @@ var IngestOptions = z15.object({
       message
     });
   }
+  const tierMessage = validateImageTierForRatio(data.aspectRatio, data.imageModel);
+  if (tierMessage) {
+    ctx.addIssue({
+      code: z15.ZodIssueCode.custom,
+      path: [
+        "imageModel"
+      ],
+      params: {
+        rule: IMAGE_TIER_UNSUPPORTED_FOR_RATIO_RULE
+      },
+      message: tierMessage
+    });
+  }
 });
 var IngestRequest = z15.object({
   url: z15.string().url(),
@@ -3401,6 +3450,7 @@ var ShopifyPublicationMode = z20.enum([
   "existing",
   "new"
 ]);
+var SHOPIFY_ANNOUNCEMENT_BAR_MAX_LENGTH = 160;
 var ShopifyPublishRequest = z20.object({
   shopDomain: z20.string().min(3).max(120).optional(),
   /**
@@ -3419,7 +3469,9 @@ var ShopifyPublishRequest = z20.object({
   */
   publicationMode: ShopifyPublicationMode.default("auto"),
   /** Shopify product GID, numeric id, or admin product URL. Required for existing mode. */
-  targetProductId: z20.string().trim().min(1).max(300).optional()
+  targetProductId: z20.string().trim().min(1).max(300).optional(),
+  announcementBarEnabled: z20.boolean().optional(),
+  announcementBarText: z20.string().trim().min(1).max(SHOPIFY_ANNOUNCEMENT_BAR_MAX_LENGTH).optional()
 }).superRefine((data, ctx) => {
   if (data.publicationMode === "existing" && !data.targetProductId) {
     ctx.addIssue({
@@ -3430,6 +3482,24 @@ var ShopifyPublishRequest = z20.object({
       message: "Selecciona un producto de Shopify."
     });
   }
+  if (data.announcementBarEnabled && !data.announcementBarText) {
+    ctx.addIssue({
+      code: z20.ZodIssueCode.custom,
+      path: [
+        "announcementBarText"
+      ],
+      message: "Escribe el texto del anuncio."
+    });
+  }
+  if (!data.announcementBarEnabled && data.announcementBarText) {
+    ctx.addIssue({
+      code: z20.ZodIssueCode.custom,
+      path: [
+        "announcementBarText"
+      ],
+      message: "Activa el anuncio para usar texto."
+    });
+  }
 });
 var ShopifyPublicationStatus = z20.enum([
   "pending",
@@ -3512,6 +3582,10 @@ var CreateShopifyBillingChargeRequest = z20.object({
 var CancelShopifySubscriptionRequest = z20.object({
   subscriptionId: z20.string().min(1)
 });
+var ShopifyAnnouncementBarState = z20.object({
+  enabled: z20.boolean(),
+  text: z20.string().max(SHOPIFY_ANNOUNCEMENT_BAR_MAX_LENGTH).optional()
+});
 var LandingHealthResponse = z20.object({
   taskId: z20.string(),
   state: z20.enum([
@@ -3553,9 +3627,20 @@ var ApproveAnglesRequest = z21.object({
     "mixed"
   ]).optional()
 });
+var ApproveAnglesRefusalReason = z21.enum([
+  "photo_review_pending",
+  "photos_not_ready",
+  "reference_out_of_date"
+]);
 var ApproveAnglesResponse = z21.object({
   success: z21.boolean(),
-  taskId: z21.string().uuid()
+  taskId: z21.string().uuid(),
+  reason: ApproveAnglesRefusalReason.optional()
+});
+var IngestResumeRefusalResponse = z21.object({
+  success: z21.literal(false),
+  taskId: z21.string().uuid(),
+  reason: ApproveAnglesRefusalReason.optional()
 });
 var GenerateSuggestionsResponse = z21.object({
   painPoints: z21.array(z21.string()),
@@ -3671,7 +3756,8 @@ var ApproveVideoAnglesRequest = z21.object({
 });
 var ApproveVideoAnglesResponse = z21.object({
   success: z21.boolean(),
-  taskId: z21.string().uuid()
+  taskId: z21.string().uuid(),
+  reason: ApproveAnglesRefusalReason.optional()
 });
 var SaveVideoDraftRequest = z21.object({
   /** Global creative direction for all videos. Not spoken dialogue. */
@@ -3703,7 +3789,8 @@ var ApproveImageAnglesRequest = z21.object({
 });
 var ApproveImageAnglesResponse = z21.object({
   success: z21.boolean(),
-  taskId: z21.string().uuid()
+  taskId: z21.string().uuid(),
+  reason: ApproveAnglesRefusalReason.optional()
 });
 var SaveImageDraftRequest = z21.object({
   customAngle: z21.string().max(480).optional(),
@@ -4060,6 +4147,10 @@ var MVPResult = z24.object({
   videoAngleCount: z24.number().int().min(1).max(3).optional(),
   adCreative: AdCreative.optional(),
   shopifyPageUrl: z24.string().url().optional(),
+  /** What the announcement bar looks like ON THE PUBLISHED landing right now.
+  *  The publish dialog prefills from this: without it the checkbox always opens
+  *  unchecked, and republishing anything would read as "remove the bar". */
+  shopifyAnnouncementBar: ShopifyAnnouncementBarState.optional(),
   // Pain points and benefits for image wizard pre-filling
   painPoints: z24.string().optional(),
   benefits: z24.string().optional(),
@@ -4185,7 +4276,19 @@ var StatusResponse = z24.object({
     "done",
     "error"
   ]),
+  /** ENGINEERING string (`Task.error`). Never render this to a seller. */
   error: z24.string().optional(),
+  /**
+  * SELLER-FACING failure copy, in Spanish, already decided by the backend —
+  * render it VERBATIM. Present only for `status: 'error'`.
+  *
+  * Clients used to receive only `error` and guess at it with a local regex
+  * table; measured 2026-08-18 over 187 failed tasks in 60 days, that guess
+  * produced contentless copy ("Error desconocido." / "Error interno") for 123
+  * of them. Populated from `Task.userMessage`, falling back to the same
+  * resolver for rows written before that column existed.
+  */
+  userMessage: z24.string().optional(),
   startedAt: z24.string().datetime().optional(),
   updatedAt: z24.string().datetime().optional(),
   stageStatuses: StageStatusSnapshot,
@@ -4196,6 +4299,10 @@ var StatusResponse = z24.object({
   *  campaign target geo when creating Meta ads from this task. */
   targetCountry: z24.string().optional(),
   shopifyPageUrl: z24.string().url().optional(),
+  /** What the announcement bar looks like ON THE PUBLISHED landing right now.
+  *  The publish dialog prefills from this: without it the checkbox always opens
+  *  unchecked, and republishing anything would read as "remove the bar". */
+  shopifyAnnouncementBar: ShopifyAnnouncementBarState.optional(),
   shopifyShops: z24.array(z24.object({
     shopDomain: z24.string(),
     primaryDomain: z24.string().nullable()
@@ -4206,6 +4313,10 @@ var StatusResponse = z24.object({
   requiresAction: z24.boolean().optional(),
   /** True when the task needs the user's attention rather than passive progress. */
   needsReview: z24.boolean().optional(),
+  /** True when an open gate exists that somebody can actually ANSWER. A strictly
+  *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
+  *  below for why conflating the two produced a call to action that led nowhere. */
+  hasAnswerableGate: z24.boolean().optional(),
   /** Which landing pipeline produced this task's landing. 'code' tasks have no
   *  classic LandingImage rows — the result lives in the inline code editor. */
   landingMode: LandingModeSchema.optional(),
@@ -4276,6 +4387,27 @@ var TaskSummary = z24.object({
   /** True when user action is ACTUALLY needed (angle review or script review ready).
   *  Use this for status display to show "Revisar" vs "Progreso". */
   needsReview: z24.boolean().optional(),
+  /**
+  * True when an open gate exists that somebody can actually ANSWER.
+  *
+  * DIFFERENT FACT from `needsReview`, and the difference is the bug. `needsReview`
+  * means "this task is waiting on the seller"; the list badge renders «Revisar»
+  * from it. But a task whose dispatch was lost is also "waiting", with no question
+  * open anywhere — and so is the autopilot angle wait, whose resume button is
+  * measurably INERT (`resumeAfterAngles` CASes on a flag that is false there, so
+  * it returns 200 and dispatches nothing). Both render «Revisar» today and both
+  * lead the seller nowhere. The owner spent hours one night convinced the platform
+  * was frozen, chasing a ghost the badge itself invented.
+  *
+  * Derived from the reconciler's gate registry, NOT from a hand-maintained flag:
+  * being a registry entry is what "answerable" means, because every entry declares
+  * a decider and a deadline at compile time. A gate added tomorrow reports itself
+  * here on its own. See `answerableGateIdsFor` in
+  * apps/api/src/modules/cron/gate-reconciler/gate-registry.ts.
+  *
+  * Render «Revisar» on THIS, not on `needsReview`.
+  */
+  hasAnswerableGate: z24.boolean().optional(),
   createdAt: z24.string().datetime().optional(),
   startedAt: z24.string().datetime().optional(),
   updatedAt: z24.string().datetime().optional(),
@@ -9365,6 +9497,7 @@ function slot(name, required, mcp2, whatsapp = mcp2, source = "user") {
 }
 __name(slot, "slot");
 var SERVER_SELECTED_OR_ARTIFACT_FIELDS = /* @__PURE__ */ new Set([
+  "actionKind",
   "actorId",
   "adAccountId",
   "advertiserId",
@@ -10189,7 +10322,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "meta_publication"
   ]),
-  defineCapability("publish_to_shopify", "ec37111aac872e6be22f34c8b547c1e4b58875f798c48e24ca9ca067a0a22d8b", "external_mutation", "publishing", [
+  defineCapability("publish_to_shopify", "6a75ad9bfe04aed24ed41564011ac785657bab12caccd4d78c1de846ce798e82", "external_mutation", "publishing", [
     "external_mutation",
     "state_change"
   ], [
@@ -10209,7 +10342,13 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     slot("publication_target", false, [
       "publicationMode",
       "targetProductId"
-    ])
+    ]),
+    // MCP + web only: the WhatsApp publish tool exposes no announcement fields,
+    // and claiming them here breaks the schema-parity invariant.
+    slot("announcement_bar", false, [
+      "announcementBarEnabled",
+      "announcementBarText"
+    ], [])
   ], [
     "product",
     "shop"
@@ -11110,6 +11249,42 @@ var ResearchCategoryEnum = z47.enum([
   "garden",
   "cleaning"
 ]);
+var READS_INTERNAL = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var READS_EXTERNAL = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: true
+};
+var CREATES_INTERNAL = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var CREATES_EXTERNAL = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: false,
+  openWorldHint: true
+};
+var OVERWRITES_INTERNAL = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var OVERWRITES_EXTERNAL = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: false,
+  openWorldHint: true
+};
 
 // src/errors.ts
 var McpErrorCode = {
@@ -11567,6 +11742,18 @@ function translateError(err) {
 }
 __name(translateError, "translateError");
 
+// src/tools/approve-refusal-message.ts
+function approveRefusalMessage(reason) {
+  if (reason === "photo_review_pending") {
+    return "No se inici\xF3 la generaci\xF3n: faltan por revisar las fotos del producto. Abre la tarea, aprueba las fotos y vuelve a intentar. No se cobr\xF3 nada.";
+  }
+  if (reason === "photos_not_ready") {
+    return "No se inici\xF3 la generaci\xF3n: todav\xEDa estamos preparando las fotos del producto. Intenta de nuevo en un momento. No se cobr\xF3 nada.";
+  }
+  return "No se inici\xF3 la generaci\xF3n y no se cobr\xF3 nada. Los cambios siguen guardados: vuelve a intentar.";
+}
+__name(approveRefusalMessage, "approveRefusalMessage");
+
 // src/asset-proxy.ts
 import { createHmac, timingSafeEqual } from "crypto";
 var TOKEN_TTL_SECONDS = 3600;
@@ -12047,7 +12234,7 @@ function resolveStatusTaskKind(status) {
 }
 __name(resolveStatusTaskKind, "resolveStatusTaskKind");
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
-  server.tool("create_product_task", "Crea una tarea de producto desde fotos o desde un proyecto guiado propio. Por defecto genera los 3 outputs (landing + video + image creatives) EN UN MISMO TASK. Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero) O projectId si el proyecto ya tiene una imagen guardada; adem\xE1s language y country. Para fotos en una laptop con MCP remoto llama `request_media_upload` con mediaKind=image y luego usa los assetId devueltos dentro de images; no pidas path ni URL cuando el App est\xE9 disponible.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son inputs de alto impacto en la landing y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si est\xE1 en LATAM.\n\nSi env\xEDas projectId, debe ser el proyecto propio que el usuario acaba de costear; el backend resolver\xE1 la imagen privada y conservar\xE1 todos los controles de cr\xE9ditos/confirmaci\xF3n. Si el usuario adjunta images junto con projectId, esas fotos reemplazan la referencia solo para este task.\n\nANTES de invocar, DILE CLARAMENTE qu\xE9 outputs vas a generar y que `create_product_task` los genera juntos en un mismo task.\n\nUsa SOLO valores declarados en los enums.", CreateProductTaskInput.shape, async (input) => {
+  server.tool("create_product_task", "Crea una tarea de producto desde fotos o desde un proyecto guiado propio. Por defecto genera los 3 outputs (landing + video + image creatives) EN UN MISMO TASK. Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero) O projectId si el proyecto ya tiene una imagen guardada; adem\xE1s language y country. Para fotos en una laptop con MCP remoto llama `request_media_upload` con mediaKind=image y luego usa los assetId devueltos dentro de images; no pidas path ni URL cuando el App est\xE9 disponible.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son inputs de alto impacto en la landing y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si est\xE1 en LATAM.\n\nSi env\xEDas projectId, debe ser el proyecto propio que el usuario acaba de costear; el backend resolver\xE1 la imagen privada y conservar\xE1 todos los controles de cr\xE9ditos/confirmaci\xF3n. Si el usuario adjunta images junto con projectId, esas fotos reemplazan la referencia solo para este task.\n\nANTES de invocar, DILE CLARAMENTE qu\xE9 outputs vas a generar y que `create_product_task` los genera juntos en un mismo task.\n\nUsa SOLO valores declarados en los enums.", CreateProductTaskInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       if (!input.images && !input.projectId) {
         throw new Error("images es requerido salvo que env\xEDes projectId.");
@@ -12115,7 +12302,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("create_service_video", "Crea un video para un servicio desde su landing. Esta acci\xF3n consume cr\xE9ditos: confirma la intenci\xF3n del usuario antes de llamarla. `automatic` genera directamente; `guided` devuelve conceptos para que el usuario apruebe uno mediante `resolve_pending_action`. La web tambi\xE9n acepta demos y anuncios de referencia; el transporte MCP de video adjunto todav\xEDa falla cerrado hasta poder subir bytes de forma segura.", CreateServiceVideoInput.shape, async (input) => {
+  server.tool("create_service_video", "Crea un video para un servicio desde su landing. Esta acci\xF3n consume cr\xE9ditos: confirma la intenci\xF3n del usuario antes de llamarla. `automatic` genera directamente; `guided` devuelve conceptos para que el usuario apruebe uno mediante `resolve_pending_action`. La web tambi\xE9n acepta demos y anuncios de referencia; el transporte MCP de video adjunto todav\xEDa falla cerrado hasta poder subir bytes de forma segura.", CreateServiceVideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const created = await api.postJson("/v2/ingest", {
         taskType: "service",
@@ -12166,7 +12353,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, aparezca `pendingUserAction`, o llegue al timeout (max 120s). Cuando la tarea queda en `done`, incluye enlaces a sus outputs.\n\nSIGUE LLAM\xC1NDOLA hasta que el estado sea terminal (`done` o `error`) o aparezca `pendingUserAction`. Un retorno sin ninguna de esas dos cosas significa que la tarea sigue corriendo y que alcanzaste el timeout, NO que se colg\xF3 ni que termin\xF3: vuelve a llamarla con waitSeconds alto. Si dejas de llamarla, la tarea sigue avanzando sin que nadie la mire y el usuario se queda esperando en silencio.\n\nSi aparece `pendingUserAction`, el pipeline est\xE1 PARADO esperando una decisi\xF3n del USUARIO: muestra el draft, PREG\xDANTALE y espera su respuesta. Resp\xF3ndela t\xFA mismo con `resolve_pending_action` \xFAnicamente si el usuario ya te deleg\xF3 esa decisi\xF3n \u2014 porque te lo dijo en la conversaci\xF3n, o porque la tarea corre con `aiDecidesAll` / `reviewMode: automatic`. Nunca deduzcas la delegaci\xF3n del contenido del draft: que la propuesta te parezca obvia o correcta no es un permiso. Al responder, repite el mismo `kind`. Kinds: `product_reference_set_approval`, `product_reference_confirmation`, `angle_review_approval`, `service_angle_approval` y `service_script_approval`.", 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, aparezca `pendingUserAction`, o llegue al timeout (max 120s). Cuando la tarea queda en `done`, incluye enlaces a sus outputs.\n\nSIGUE LLAM\xC1NDOLA hasta que el estado sea terminal (`done` o `error`) o aparezca `pendingUserAction`. Un retorno sin ninguna de esas dos cosas significa que la tarea sigue corriendo y que alcanzaste el timeout, NO que se colg\xF3 ni que termin\xF3: vuelve a llamarla con waitSeconds alto. Si dejas de llamarla, la tarea sigue avanzando sin que nadie la mire y el usuario se queda esperando en silencio.\n\nSi aparece `pendingUserAction`, el pipeline est\xE1 PARADO esperando una decisi\xF3n del USUARIO: muestra el draft, PREG\xDANTALE y espera su respuesta. Resp\xF3ndela t\xFA mismo con `resolve_pending_action` \xFAnicamente si el usuario ya te deleg\xF3 esa decisi\xF3n \u2014 porque te lo dijo en la conversaci\xF3n, o porque la tarea corre con `aiDecidesAll` / `reviewMode: automatic`. Nunca deduzcas la delegaci\xF3n del contenido del draft: que la propuesta te parezca obvia o correcta no es un permiso. Al responder, repite el mismo `kind`. Kinds: `product_reference_set_approval`, `product_reference_confirmation`, `angle_review_approval`, `service_angle_approval` y `service_script_approval`.", GetTaskStatusInput.shape, READS_INTERNAL, async (input, extra) => {
     try {
       const signal = extra?.signal;
       const fetcher = /* @__PURE__ */ __name(() => api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`, {
@@ -12226,7 +12413,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("list_tasks", "Lista de forma read-only las tareas recientes del usuario. \xDAsala para encontrar una tarea previa por nombre o revisar el historial antes de pedir un taskId. Soporta paginaci\xF3n con limit/offset y filtro de texto. No crea, reanuda ni modifica tareas.", ListTasksInput.shape, async (input) => {
+  server.tool("list_tasks", "Lista de forma read-only las tareas recientes del usuario. \xDAsala para encontrar una tarea previa por nombre o revisar el historial antes de pedir un taskId. Soporta paginaci\xF3n con limit/offset y filtro de texto. No crea, reanuda ni modifica tareas.", ListTasksInput.shape, READS_INTERNAL, async (input) => {
     try {
       const qs = new URLSearchParams();
       if (input.limit != null) qs.set("limit", String(input.limit));
@@ -12239,7 +12426,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("edit_task_draft", "Edita el draft de un angle de marketing antes de la generaci\xF3n. Campos editables: angle (texto del angle), buyerPersona, actor (descripci\xF3n del personaje), actorId (ID de un personaje guardado; usa list_actors), gender (female|male), scriptNotes. Use this only before generation completes. Editing already-generated images or videos is not supported.", EditTaskDraftInput.shape, async (input) => {
+  server.tool("edit_task_draft", "Edita el draft de un angle de marketing antes de la generaci\xF3n. Campos editables: angle (texto del angle), buyerPersona, actor (descripci\xF3n del personaje), actorId (ID de un personaje guardado; usa list_actors), gender (female|male), scriptNotes. Use this only before generation completes. Editing already-generated images or videos is not supported.", EditTaskDraftInput.shape, OVERWRITES_INTERNAL, async (input) => {
     try {
       const angle = await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/angles/${input.angleIndex}`, input.angle ?? {});
       return asText({
@@ -12249,257 +12436,273 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("resolve_pending_action", "Resuelve la acci\xF3n pendiente devuelta por `get_task_status`; `action.kind` debe coincidir exactamente. Esta llamada habla EN NOMBRE DEL USUARIO: \xFAsala solo con una respuesta que \xE9l te haya dado, o cuando te haya delegado la decisi\xF3n de forma expl\xEDcita o v\xEDa `aiDecidesAll` / `reviewMode: automatic`. Si nadie te deleg\xF3 nada, pregunta y espera en vez de llamarla. Puede aprobar el conjunto exacto de referencias del producto, confirmar agrupaci\xF3n, o resolver revisiones de \xE1ngulos/servicios. Nunca env\xEDes una lista de referencias: el servidor conserva el conjunto mostrado y rechaza snapshots obsoletos. La recuperaci\xF3n que necesita fotos nuevas se completa en ProductMaker Web porque MCP no acepta URLs arbitrarias sin ticket de upload ligado al usuario.", 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_set_approval": {
-          if (pending.scope !== input.action.scope || pending.scopeKey !== input.action.scopeKey || pending.scopeSnapshotId !== input.action.scopeSnapshotId || pending.scopeHash !== input.action.expectedScopeHash || !pending.allowedDecisions?.includes(input.action.decision)) {
-            throw new Error("La aprobaci\xF3n de referencias no coincide con el snapshot mostrado; vuelve a llamar get_task_status.");
-          }
-          if (input.action.decision === "reject" && (!input.action.reason || !input.action.affectedRefKeys?.length || !input.action.recoveryAction)) {
-            throw new Error("Una referencia rechazada necesita motivo, referencias afectadas y acci\xF3n de recuperaci\xF3n.");
-          }
-          if (input.action.decision === "correct_view" && (!input.action.reason || !input.action.affectedRefKeys?.length)) {
-            throw new Error("Una correcci\xF3n de \xE1ngulo necesita motivo y referencias afectadas.");
-          }
-          if (input.action.decision === "correct_view" && input.action.affectedRefKeys?.length !== 1) {
-            throw new Error("Corrige una sola vista por intento.");
-          }
-          if (pending.phase === "preparation" && input.action.decision === "approve" && (!pending.selectedRefKeys || pending.selectedRefKeys.length === 0)) {
-            throw new Error("No hay fotos seleccionadas para preparar. Abre la tarea en ProductMaker Web y elige al menos una.");
-          }
-          const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/resolve-product-reference-set`, {
-            ...input.action,
-            ...pending.phase === "preparation" && input.action.decision === "approve" && pending.selectedRefKeys ? {
-              selectedRefKeys: pending.selectedRefKeys
-            } : {}
-          });
-          return asText(result);
+  server.tool(
+    "resolve_pending_action",
+    "Resuelve la acci\xF3n pendiente devuelta por `get_task_status`; `action.kind` debe coincidir exactamente. Esta llamada habla EN NOMBRE DEL USUARIO: \xFAsala solo con una respuesta que \xE9l te haya dado, o cuando te haya delegado la decisi\xF3n de forma expl\xEDcita o v\xEDa `aiDecidesAll` / `reviewMode: automatic`. Si nadie te deleg\xF3 nada, pregunta y espera en vez de llamarla. Puede aprobar el conjunto exacto de referencias del producto, confirmar agrupaci\xF3n, o resolver revisiones de \xE1ngulos/servicios. Nunca env\xEDes una lista de referencias: el servidor conserva el conjunto mostrado y rechaza snapshots obsoletos. La recuperaci\xF3n que necesita fotos nuevas se completa en ProductMaker Web porque MCP no acepta URLs arbitrarias sin ticket de upload ligado al usuario.",
+    ResolvePendingActionInput.shape,
+    // Approving the gate RELEASES the pipeline into paid generation at the video
+    // and image providers (registry effects: credit_consuming + state_change),
+    // and decision=reject discards the approved reference set. Both halves, hence
+    // destructive AND open-world.
+    OVERWRITES_EXTERNAL,
+    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.");
         }
-        case "product_reference_confirmation": {
-          const candidateGrouping = pending.candidateGrouping;
-          const selectedImageUrls = pending.selectedImageUrls ?? [];
-          if (pending.mode === "visual_recovery") {
-            throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
-          }
-          if (!candidateGrouping || selectedImageUrls.length === 0) {
-            throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
-          }
-          const userChoice = input.action.userChoice;
-          if (!userChoice) {
-            throw new Error("La pregunta adaptativa necesita userChoice.");
-          }
-          const offeredChoices = pending.question?.options.map((option) => option.value) ?? pending.options;
-          if (!offeredChoices) {
-            throw new Error("Estado inconsistente: falta la pregunta adaptativa con sus opciones verificables. Vuelve a llamar get_task_status.");
-          }
-          if (!offeredChoices.includes(userChoice)) {
-            throw new Error(`La opci\xF3n "${userChoice}" no fue ofrecida en la pregunta pendiente. Elige una opci\xF3n mostrada por get_task_status.`);
-          }
-          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
-            productReferenceConfirmation: {
-              candidateGrouping,
-              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)
-            },
-            ...input.action.confirmedProductNames ? {
-              confirmedProductNames: input.action.confirmedProductNames
-            } : {},
-            ...pending.decisionKey && pending.referenceEvidenceVersion && pending.expectedEvidenceHash ? {
-              decisionKey: pending.decisionKey,
-              referenceEvidenceVersion: pending.referenceEvidenceVersion,
-              expectedEvidenceHash: pending.expectedEvidenceHash
-            } : {},
-            // Multi-scene color showcase → upgrade to STANDARD. Gated to the
-            // variants choice client-side so the wire body stays coherent; the
-            // backend re-gates on variant_set grouping.
-            ...resolveVariantConfirmVideoTier(input.action) === "standard" ? {
-              videoTier: "standard"
-            } : {}
-          });
-          return asText(r);
+        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.`);
         }
-        case "angle_review_approval": {
-          const body = {};
-          if (pending.customAngleDraft && pending.customAngleDraft.length > 0) {
-            body.customAngle = pending.customAngleDraft;
+        switch (input.action.kind) {
+          case "product_reference_set_approval": {
+            if (pending.scope !== input.action.scope || pending.scopeKey !== input.action.scopeKey || pending.scopeSnapshotId !== input.action.scopeSnapshotId || pending.scopeHash !== input.action.expectedScopeHash || !pending.allowedDecisions?.includes(input.action.decision)) {
+              throw new Error("La aprobaci\xF3n de referencias no coincide con el snapshot mostrado; vuelve a llamar get_task_status.");
+            }
+            if (input.action.decision === "reject" && (!input.action.reason || !input.action.affectedRefKeys?.length || !input.action.recoveryAction)) {
+              throw new Error("Una referencia rechazada necesita motivo, referencias afectadas y acci\xF3n de recuperaci\xF3n.");
+            }
+            if (input.action.decision === "correct_view" && (!input.action.reason || !input.action.affectedRefKeys?.length)) {
+              throw new Error("Una correcci\xF3n de \xE1ngulo necesita motivo y referencias afectadas.");
+            }
+            if (input.action.decision === "correct_view" && input.action.affectedRefKeys?.length !== 1) {
+              throw new Error("Corrige una sola vista por intento.");
+            }
+            if (pending.phase === "preparation" && input.action.decision === "approve" && (!pending.selectedRefKeys || pending.selectedRefKeys.length === 0)) {
+              throw new Error("No hay fotos seleccionadas para preparar. Abre la tarea en ProductMaker Web y elige al menos una.");
+            }
+            const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/resolve-product-reference-set`, {
+              ...input.action,
+              ...pending.phase === "preparation" && input.action.decision === "approve" && pending.selectedRefKeys ? {
+                selectedRefKeys: pending.selectedRefKeys
+              } : {}
+            });
+            return asText(result);
           }
-          if (pending.painPointsDraft != null) body.painPoints = pending.painPointsDraft;
-          if (pending.benefitsDraft != null) body.benefits = pending.benefitsDraft;
-          if (pending.featuresDraft != null) body.features = [
-            ...pending.featuresDraft
-          ];
-          if (input.action.customAngle != null) body.customAngle = input.action.customAngle;
-          if (input.action.painPoints != null) body.painPoints = input.action.painPoints;
-          if (input.action.benefits != null) body.benefits = input.action.benefits;
-          if (input.action.features != null) body.features = input.action.features;
-          if (input.action.gapDurationSeconds != null && !pending.gapDurationChoice) {
-            throw new Error("No hay una recomendaci\xF3n gapDurationChoice pendiente para elegir una duraci\xF3n. Consulta get_task_status y confirma el winner primero.");
+          case "product_reference_confirmation": {
+            const candidateGrouping = pending.candidateGrouping;
+            const selectedImageUrls = pending.selectedImageUrls ?? [];
+            if (pending.mode === "visual_recovery") {
+              throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
+            }
+            if (!candidateGrouping || selectedImageUrls.length === 0) {
+              throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
+            }
+            const userChoice = input.action.userChoice;
+            if (!userChoice) {
+              throw new Error("La pregunta adaptativa necesita userChoice.");
+            }
+            const offeredChoices = pending.question?.options.map((option) => option.value) ?? pending.options;
+            if (!offeredChoices) {
+              throw new Error("Estado inconsistente: falta la pregunta adaptativa con sus opciones verificables. Vuelve a llamar get_task_status.");
+            }
+            if (!offeredChoices.includes(userChoice)) {
+              throw new Error(`La opci\xF3n "${userChoice}" no fue ofrecida en la pregunta pendiente. Elige una opci\xF3n mostrada por get_task_status.`);
+            }
+            const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+              productReferenceConfirmation: {
+                candidateGrouping,
+                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)
+              },
+              ...input.action.confirmedProductNames ? {
+                confirmedProductNames: input.action.confirmedProductNames
+              } : {},
+              ...pending.decisionKey && pending.referenceEvidenceVersion && pending.expectedEvidenceHash ? {
+                decisionKey: pending.decisionKey,
+                referenceEvidenceVersion: pending.referenceEvidenceVersion,
+                expectedEvidenceHash: pending.expectedEvidenceHash
+              } : {},
+              // Multi-scene color showcase → upgrade to STANDARD. Gated to the
+              // variants choice client-side so the wire body stays coherent; the
+              // backend re-gates on variant_set grouping.
+              ...resolveVariantConfirmVideoTier(input.action) === "standard" ? {
+                videoTier: "standard"
+              } : {}
+            });
+            return asText(r);
           }
-          if (input.action.gapDurationSeconds === 30) {
-            const choice = pending.gapDurationChoice;
-            if (!choice) throw new Error("No hay una recomendaci\xF3n gapDurationChoice pendiente para aceptar 30s.");
-            if (choice.recommendedSec !== 30) {
-              throw new Error(`La recomendaci\xF3n de duraci\xF3n para este winner es ${choice.recommendedSec}s; no se puede solicitar 30s con este estado.`);
+          case "angle_review_approval": {
+            const body = {};
+            if (pending.customAngleDraft && pending.customAngleDraft.length > 0) {
+              body.customAngle = pending.customAngleDraft;
             }
-            body.angleVideoOptions = [
-              {
-                angleIndex: choice.angleIndex,
-                ugcFormat: "double_30s"
-              }
+            if (pending.painPointsDraft != null) body.painPoints = pending.painPointsDraft;
+            if (pending.benefitsDraft != null) body.benefits = pending.benefitsDraft;
+            if (pending.featuresDraft != null) body.features = [
+              ...pending.featuresDraft
             ];
-          }
-          const selectedAngleIndices = resolveSelectedAngleIndices(status, pending.gapDurationChoice);
-          const resolvedTaskKind = resolveStatusTaskKind(status);
-          const isVideoTask = resolvedTaskKind === "video";
-          const isAutopilotTask = resolvedTaskKind === "autopilot";
-          if ((isVideoTask || isAutopilotTask) && body.customAngle != null) {
-            const existingOptions = Array.isArray(body.angleVideoOptions) ? body.angleVideoOptions : [];
-            const optionsByIndex = new Map(existingOptions.map((option) => [
-              option.angleIndex,
-              {
-                ...option
+            if (input.action.customAngle != null) body.customAngle = input.action.customAngle;
+            if (input.action.painPoints != null) body.painPoints = input.action.painPoints;
+            if (input.action.benefits != null) body.benefits = input.action.benefits;
+            if (input.action.features != null) body.features = input.action.features;
+            if (input.action.gapDurationSeconds != null && !pending.gapDurationChoice) {
+              throw new Error("No hay una recomendaci\xF3n gapDurationChoice pendiente para elegir una duraci\xF3n. Consulta get_task_status y confirma el winner primero.");
+            }
+            if (input.action.gapDurationSeconds === 30) {
+              const choice = pending.gapDurationChoice;
+              if (!choice) throw new Error("No hay una recomendaci\xF3n gapDurationChoice pendiente para aceptar 30s.");
+              if (choice.recommendedSec !== 30) {
+                throw new Error(`La recomendaci\xF3n de duraci\xF3n para este winner es ${choice.recommendedSec}s; no se puede solicitar 30s con este estado.`);
               }
-            ]));
-            for (const angleIndex of selectedAngleIndices) {
-              optionsByIndex.set(angleIndex, {
-                ...optionsByIndex.get(angleIndex) ?? {
-                  angleIndex
+              body.angleVideoOptions = [
+                {
+                  angleIndex: choice.angleIndex,
+                  ugcFormat: "double_30s"
+                }
+              ];
+            }
+            const selectedAngleIndices = resolveSelectedAngleIndices(status, pending.gapDurationChoice);
+            const resolvedTaskKind = resolveStatusTaskKind(status);
+            const isVideoTask = resolvedTaskKind === "video";
+            const isAutopilotTask = resolvedTaskKind === "autopilot";
+            if ((isVideoTask || isAutopilotTask) && body.customAngle != null) {
+              const existingOptions = Array.isArray(body.angleVideoOptions) ? body.angleVideoOptions : [];
+              const optionsByIndex = new Map(existingOptions.map((option) => [
+                option.angleIndex,
+                {
+                  ...option
+                }
+              ]));
+              for (const angleIndex of selectedAngleIndices) {
+                optionsByIndex.set(angleIndex, {
+                  ...optionsByIndex.get(angleIndex) ?? {
+                    angleIndex
+                  },
+                  angle: body.customAngle
+                });
+              }
+              body.angleVideoOptions = [
+                ...optionsByIndex.values()
+              ].sort((left, right) => Number(left.angleIndex) - Number(right.angleIndex));
+            }
+            if (isVideoTask) {
+              body.selectedAngleIndices = selectedAngleIndices;
+              const r2 = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/approve-video-angles`, body);
+              return asText(r2);
+            }
+            if (isAutopilotTask) {
+              const resumeBody = {
+                selectedAngleIndices,
+                ...status.ugcFormat ? {
+                  ugcFormat: status.ugcFormat
+                } : {
+                  ugcFormat: "single_15s"
                 },
-                angle: body.customAngle
-              });
+                ...status.videoStyle ? {
+                  videoStyle: status.videoStyle
+                } : {},
+                ...status.videoModel ? {
+                  videoModel: status.videoModel
+                } : {},
+                ...status.videoTier ? {
+                  videoTier: status.videoTier
+                } : {},
+                ...status.videoResolution ? {
+                  videoResolution: status.videoResolution
+                } : {},
+                ...status.narrativeStyle ? {
+                  narrativeStyle: status.narrativeStyle
+                } : {},
+                ...body.customAngle != null ? {
+                  customAngleOverride: body.customAngle
+                } : {},
+                ...body.painPoints != null ? {
+                  painPoints: body.painPoints
+                } : {},
+                ...body.benefits != null ? {
+                  benefits: body.benefits
+                } : {},
+                ...body.angleVideoOptions ? {
+                  angleVideoOptions: body.angleVideoOptions
+                } : {}
+              };
+              if (body.features !== void 0) {
+                await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/update-product-features`, {
+                  features: body.features
+                });
+              }
+              const r2 = await api.postJson(`/v1/ingest/${encodeURIComponent(input.taskId)}/resume`, resumeBody);
+              if (r2?.success === false) {
+                throw new Error(approveRefusalMessage(r2.reason));
+              }
+              return asText(r2);
             }
-            body.angleVideoOptions = [
-              ...optionsByIndex.values()
-            ].sort((left, right) => Number(left.angleIndex) - Number(right.angleIndex));
-          }
-          if (isVideoTask) {
-            body.selectedAngleIndices = selectedAngleIndices;
-            const r2 = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/approve-video-angles`, body);
-            return asText(r2);
-          }
-          if (isAutopilotTask) {
-            const resumeBody = {
-              selectedAngleIndices,
-              ...status.ugcFormat ? {
-                ugcFormat: status.ugcFormat
-              } : {
-                ugcFormat: "single_15s"
-              },
-              ...status.videoStyle ? {
-                videoStyle: status.videoStyle
-              } : {},
-              ...status.videoModel ? {
-                videoModel: status.videoModel
-              } : {},
-              ...status.videoTier ? {
-                videoTier: status.videoTier
-              } : {},
-              ...status.videoResolution ? {
-                videoResolution: status.videoResolution
-              } : {},
-              ...status.narrativeStyle ? {
-                narrativeStyle: status.narrativeStyle
-              } : {},
+            const route = resolvedTaskKind === "image" ? `/v1/tasks/${encodeURIComponent(input.taskId)}/approve-image-angles` : `/v1/tasks/${encodeURIComponent(input.taskId)}/approve-angles`;
+            const imageBody = status.kind === "image" ? {
               ...body.customAngle != null ? {
-                customAngleOverride: body.customAngle
+                customAngle: body.customAngle
               } : {},
               ...body.painPoints != null ? {
                 painPoints: body.painPoints
               } : {},
-              ...body.benefits != null ? {
-                benefits: body.benefits
-              } : {},
-              ...body.angleVideoOptions ? {
-                angleVideoOptions: body.angleVideoOptions
-              } : {}
-            };
-            if (body.features !== void 0) {
-              await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/update-product-features`, {
+              ...body.features != null ? {
                 features: body.features
-              });
+              } : {}
+            } : body;
+            const r = await api.postJson(route, imageBody);
+            if (r?.success === false) {
+              throw new Error(approveRefusalMessage(r.reason));
             }
-            const r2 = await api.postJson(`/v1/ingest/${encodeURIComponent(input.taskId)}/resume`, resumeBody);
-            return asText(r2);
+            return asText(r);
           }
-          const route = resolvedTaskKind === "image" ? `/v1/tasks/${encodeURIComponent(input.taskId)}/approve-image-angles` : `/v1/tasks/${encodeURIComponent(input.taskId)}/approve-angles`;
-          const imageBody = status.kind === "image" ? {
-            ...body.customAngle != null ? {
-              customAngle: body.customAngle
-            } : {},
-            ...body.painPoints != null ? {
-              painPoints: body.painPoints
-            } : {},
-            ...body.features != null ? {
-              features: body.features
-            } : {}
-          } : body;
-          const r = await api.postJson(route, imageBody);
-          return asText(r);
-        }
-        case "service_angle_approval": {
-          const action = input.action;
-          const candidate = pending.angles?.find((angle) => angle.id === action.angleId);
-          if (!candidate) {
-            throw new Error("El angleId no pertenece a los conceptos pendientes de esta tarea.");
+          case "service_angle_approval": {
+            const action = input.action;
+            const candidate = pending.angles?.find((angle) => angle.id === action.angleId);
+            if (!candidate) {
+              throw new Error("El angleId no pertenece a los conceptos pendientes de esta tarea.");
+            }
+            const edits = {
+              content: action.content ?? candidate.content,
+              creativeDirection: action.creativeDirection ?? candidate.creativeDirection,
+              actor: action.actor ?? candidate.actor,
+              // Echo the persisted saved actor. Omitted when absent so the PATCH
+              // never writes a null over a selection made elsewhere — the
+              // backend only updates the keys it receives.
+              ...candidate.actorId ? {
+                actorId: candidate.actorId
+              } : {}
+            };
+            await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-angles/${encodeURIComponent(candidate.id)}`, edits);
+            const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-angles/select`, {
+              angleIds: [
+                candidate.id
+              ]
+            });
+            return asText(result);
           }
-          const edits = {
-            content: action.content ?? candidate.content,
-            creativeDirection: action.creativeDirection ?? candidate.creativeDirection,
-            actor: action.actor ?? candidate.actor,
-            // Echo the persisted saved actor. Omitted when absent so the PATCH
-            // never writes a null over a selection made elsewhere — the
-            // backend only updates the keys it receives.
-            ...candidate.actorId ? {
-              actorId: candidate.actorId
-            } : {}
-          };
-          await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-angles/${encodeURIComponent(candidate.id)}`, edits);
-          const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-angles/select`, {
-            angleIds: [
-              candidate.id
-            ]
-          });
-          return asText(result);
-        }
-        case "service_script_approval": {
-          const panels = pending.panels ?? [];
-          if (panels.length === 0) {
-            throw new Error("El storyboard pendiente no contiene paneles aprobables.");
+          case "service_script_approval": {
+            const panels = pending.panels ?? [];
+            if (panels.length === 0) {
+              throw new Error("El storyboard pendiente no contiene paneles aprobables.");
+            }
+            const voiceovers = {};
+            const visualDirections = {};
+            for (const panel of panels) {
+              voiceovers[panel.beatId] = input.action.voiceovers?.[panel.beatId] ?? panel.voiceover;
+              visualDirections[panel.beatId] = input.action.visualDirections?.[panel.beatId] ?? panel.visualDirection;
+            }
+            const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-script/approve`, {
+              voiceovers,
+              visualDirections
+            });
+            return asText(result);
           }
-          const voiceovers = {};
-          const visualDirections = {};
-          for (const panel of panels) {
-            voiceovers[panel.beatId] = input.action.voiceovers?.[panel.beatId] ?? panel.voiceover;
-            visualDirections[panel.beatId] = input.action.visualDirections?.[panel.beatId] ?? panel.visualDirection;
+          default: {
+            const _exhaustive = input.action;
+            throw new Error(`Unsupported pending action kind: ${String(_exhaustive.kind)}`);
           }
-          const result = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/service-script/approve`, {
-            voiceovers,
-            visualDirections
-          });
-          return asText(result);
-        }
-        default: {
-          const _exhaustive = input.action;
-          throw new Error(`Unsupported pending action kind: ${String(_exhaustive.kind)}`);
         }
+      } catch (e) {
+        throw translateError(e);
       }
-    } catch (e) {
-      throw translateError(e);
     }
-  });
+  );
 }
 __name(registerTaskTools, "registerTaskTools");
 
@@ -12653,7 +12856,7 @@ var LandingInput = z49.object({
   subheadline: CreativeRefs.subheadline
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
-  server.tool("generate_free_video", 'Genera UN video libre con prompt/guion exacto, opcionalmente con imagen de referencia. Si el usuario adjunta o menciona una imagen local, llama primero request_media_upload con mediaKind=image y usa el assetId devuelto; no pidas path ni URL. Devuelve un taskId y procesa el job de forma as\xEDncrona.\n\nREQUERIDOS: rawPrompt, quality, durationSeconds y videoResolution.\n\nCALIDAD: "economical" = Econ\xF3mico y "high_detail" = Alto detalle. La duraci\xF3n debe pertenecer a la lista admitida por la calidad escogida; si el usuario pide otra, preg\xFAntale una duraci\xF3n v\xE1lida.\n\nSUBT\xCDTULOS: si addSubtitles=true, el rawPrompt completo se usa como texto exacto de subt\xEDtulos y debe tener m\xE1ximo 500 caracteres; no existe una pregunta adicional de transcripci\xF3n.\n\nPara videos normales con narrativa/\xE1ngulo usa generate_video_creative. Para tareas combinadas de producto usa create_product_task.', FreeVideoInput.shape, async (input) => {
+  server.tool("generate_free_video", 'Genera UN video libre con prompt/guion exacto, opcionalmente con imagen de referencia. Si el usuario adjunta o menciona una imagen local, llama primero request_media_upload con mediaKind=image y usa el assetId devuelto; no pidas path ni URL. Devuelve un taskId y procesa el job de forma as\xEDncrona.\n\nREQUERIDOS: rawPrompt, quality, durationSeconds y videoResolution.\n\nCALIDAD: "economical" = Econ\xF3mico y "high_detail" = Alto detalle. La duraci\xF3n debe pertenecer a la lista admitida por la calidad escogida; si el usuario pide otra, preg\xFAntale una duraci\xF3n v\xE1lida.\n\nSUBT\xCDTULOS: si addSubtitles=true, el rawPrompt completo se usa como texto exacto de subt\xEDtulos y debe tener m\xE1ximo 500 caracteres; no existe una pregunta adicional de transcripci\xF3n.\n\nPara videos normales con narrativa/\xE1ngulo usa generate_video_creative. Para tareas combinadas de producto usa create_product_task.', FreeVideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const allowedDurations = FREE_VIDEO_DURATIONS_BY_QUALITY[input.quality];
       if (!allowedDurations.includes(input.durationSeconds)) {
@@ -12683,7 +12886,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  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. Si el usuario adjunta o menciona fotos locales y a\xFAn no hay assetId, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\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 (15 o 30), videoPreset (tipo/narrativa del video), features, cta, scriptNotes (dirige el guion Y el ambiente/escenario/est\xE9tica del video, ej. "en una playa, opulento").\n\nCOMPETENCIA Y GAP REPLICATION: con videoPreset="auto" (default) y competitorScanEnabled=true (default), el sistema analiza anuncios de competencia. Si encuentra un winner de video coherente, ancla el primaryAngle y genera autom\xE1ticamente la narrativa `gap_replication` para copiar su estructura audiovisual. No la selecciones manualmente: es un resultado del an\xE1lisis. Si competitorScanEnabled=false, esta b\xFAsqueda se omite.\n\nESTILO: 15s usa "Realista" (single_call); 30s usa "Multiescena" (multi-toma, aproximadamente 30s). Multiescena se factura por escena, as\xED que avisa el costo antes de activarlo.\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. Para revisar el \xE1ngulo y decidir duraci\xF3n tras el an\xE1lisis de competencia, pasa `pauseForAngleReview: true` y luego resuelve `angle_review_approval` con `gapDurationSeconds`.', 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. Si el usuario adjunta o menciona fotos locales y a\xFAn no hay assetId, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\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 (15 o 30), videoPreset (tipo/narrativa del video), features, cta, scriptNotes (dirige el guion Y el ambiente/escenario/est\xE9tica del video, ej. "en una playa, opulento").\n\nCOMPETENCIA Y GAP REPLICATION: con videoPreset="auto" (default) y competitorScanEnabled=true (default), el sistema analiza anuncios de competencia. Si encuentra un winner de video coherente, ancla el primaryAngle y genera autom\xE1ticamente la narrativa `gap_replication` para copiar su estructura audiovisual. No la selecciones manualmente: es un resultado del an\xE1lisis. Si competitorScanEnabled=false, esta b\xFAsqueda se omite.\n\nESTILO: 15s usa "Realista" (single_call); 30s usa "Multiescena" (multi-toma, aproximadamente 30s). Multiescena se factura por escena, as\xED que avisa el costo antes de activarlo.\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. Para revisar el \xE1ngulo y decidir duraci\xF3n tras el an\xE1lisis de competencia, pasa `pauseForAngleReview: true` y luego resuelve `angle_review_approval` con `gapDurationSeconds`.', VideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveWireVideoTier(input.videoTier, input.durationSeconds);
@@ -12708,7 +12911,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("generate_image_creatives", 'Genera N variantes de imagen creativa (ads est\xE1ticos). Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), productTitle, primaryAngle, language, country. Si el usuario adjunta o menciona fotos locales y a\xFAn no hay assetId, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\n\nANTES de invocar, PREG\xDANTALE al usuario:\n- price y offer (se renderizan en la imagen \u2014 nunca los asumas; si dice "t\xFA elige", om\xEDtelos).\n- compareAtPrice si hay descuento (ej. "$129.000" para tachar).\n- creativeArchetype y visualTreatment si quiere un look espec\xEDfico (performance vs premium DTC). Si no le importa, om\xEDtelos.\n\nNO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente.\n\nOTROS OPCIONALES: buyerPersona, nVariants (default 3), imageModel, imageStyle, styleMix, aspectRatio (default 4:5), generateAdCopy, pauseForAngleReview, features, brandColors, isCombo, creativeDirection.', ImageInput.shape, async (input) => {
+  server.tool("generate_image_creatives", 'Genera N variantes de imagen creativa (ads est\xE1ticos). Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), productTitle, primaryAngle, language, country. Si el usuario adjunta o menciona fotos locales y a\xFAn no hay assetId, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\n\nANTES de invocar, PREG\xDANTALE al usuario:\n- price y offer (se renderizan en la imagen \u2014 nunca los asumas; si dice "t\xFA elige", om\xEDtelos).\n- compareAtPrice si hay descuento (ej. "$129.000" para tachar).\n- creativeArchetype y visualTreatment si quiere un look espec\xEDfico (performance vs premium DTC). Si no le importa, om\xEDtelos.\n\nNO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente.\n\nOTROS OPCIONALES: buyerPersona, nVariants (default 3), imageModel, imageStyle, styleMix, aspectRatio (default 4:5), generateAdCopy, pauseForAngleReview, features, brandColors, isCombo, creativeDirection.', ImageInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const { projectId, ...rest } = input;
       return await submitCreative(api, {
@@ -12726,7 +12929,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("edit_image_creative", "Corrige UNA imagen ya generada de una tarea de creativos, sin regenerar el set completo.\n\nCUESTA CR\xC9DITOS: cobra una sola imagen (sin brief ni extracci\xF3n), mucho menos que volver a generar todo. ANTES de invocar, PREG\xDANTALE al usuario si quiere pagar esa correcci\xF3n.\n\nSolo funciona con la tarea en estado `done` \u2014 si a\xFAn est\xE1 procesando, espera con get_task_status. Una tarea en error terminal no se puede corregir.\n\nUsa variantIndex para elegir cu\xE1l de las im\xE1genes corregir (0 = la primera) e instruction para describir el cambio en lenguaje natural.", EditImageCreativeInput.shape, async (input) => {
+  server.tool("edit_image_creative", "Corrige UNA imagen ya generada de una tarea de creativos, sin regenerar el set completo.\n\nCUESTA CR\xC9DITOS: cobra una sola imagen (sin brief ni extracci\xF3n), mucho menos que volver a generar todo. ANTES de invocar, PREG\xDANTALE al usuario si quiere pagar esa correcci\xF3n.\n\nSolo funciona con la tarea en estado `done` \u2014 si a\xFAn est\xE1 procesando, espera con get_task_status. Una tarea en error terminal no se puede corregir.\n\nUsa variantIndex para elegir cu\xE1l de las im\xE1genes corregir (0 = la primera) e instruction para describir el cambio en lenguaje natural.", EditImageCreativeInput.shape, OVERWRITES_EXTERNAL, async (input) => {
     try {
       const r = await api.postJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/regenerate`, {
         comment: input.instruction,
@@ -12737,7 +12940,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("generate_landing", 'Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), language, country. Si el usuario dice algo natural como \u201Ccrea una landing con este producto\u201D y adjunta o menciona fotos locales, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para esos campos, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults): salesAngle, buyerPersona, isCombo, creativeDirection, landingStrategy.', LandingInput.shape, async (input) => {
+  server.tool("generate_landing", 'Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), language, country. Si el usuario dice algo natural como \u201Ccrea una landing con este producto\u201D y adjunta o menciona fotos locales, llama primero `request_media_upload` con mediaKind=image y despu\xE9s usa los assetId en images; no pidas path ni URL.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para esos campos, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults): salesAngle, buyerPersona, isCombo, creativeDirection, landingStrategy.', LandingInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const { projectId, ...rest } = input;
       return await submitCreative(api, {
@@ -12987,7 +13190,7 @@ function estimatePayload(input) {
 }
 __name(estimatePayload, "estimatePayload");
 function registerCreativeVariantTools(server, api) {
-  server.tool("estimate_creative_variant", "Calcula el costo de crear una variante desde una tarea existente, sin consumir cr\xE9ditos. Usa el task origen para resolver el modelo/tier real y devuelve m\xEDnimo, m\xE1ximo, saldo y si alcanza. Para landing env\xEDa las mismas instructions/sectionKey que usar\xE1s al crear: si hay instructions sin sectionKey, el rango incluye la clasificaci\xF3n pagada con IA. Llama esto antes de create_creative_variant y muestra el rango al usuario.", EstimateCreativeVariantInputBase.shape, async (input) => {
+  server.tool("estimate_creative_variant", "Calcula el costo de crear una variante desde una tarea existente, sin consumir cr\xE9ditos. Usa el task origen para resolver el modelo/tier real y devuelve m\xEDnimo, m\xE1ximo, saldo y si alcanza. Para landing env\xEDa las mismas instructions/sectionKey que usar\xE1s al crear: si hay instructions sin sectionKey, el rango incluye la clasificaci\xF3n pagada con IA. Llama esto antes de create_creative_variant y muestra el rango al usuario.", EstimateCreativeVariantInputBase.shape, READS_INTERNAL, async (input) => {
     try {
       const validatedInput = parseVariantInput(EstimateCreativeVariantInput, input);
       const estimate = await api.postJson(`/v1/tasks/${encodeURIComponent(validatedInput.sourceTaskId)}/creative-variants/estimate`, estimatePayload(validatedInput));
@@ -13000,7 +13203,7 @@ function registerCreativeVariantTools(server, api) {
       throw translateError(error);
     }
   });
-  server.tool("create_creative_variant", "Crea un video, imagen o secci\xF3n de landing adicional dentro de una tarea existente. ES UNA ACCI\xD3N DE PAGO: primero llama estimate_creative_variant, muestra el rango de cr\xE9ditos al usuario y solo despu\xE9s invoca este tool con confirm=true. Las recomendaciones IA tambi\xE9n son acciones pagas a 2x del costo real. clientRequestId es obligatorio: genera un UUID por intenci\xF3n y reutiliza el mismo ante timeouts o transporte ambiguo. Si recibes status=error, pide confirmaci\xF3n para un intento nuevo y usa otro UUID. Reutiliza el producto y referencias del task origen; crea un child task independiente y devuelve variantTaskId. Para landing puedes enviar instructions en texto libre y omitir sectionKey: el backend lo clasifica con IA. No expone ni permite cambiar videoModel, videoTier, videoStyle o narrativeStyle; esos valores se heredan del task origen.", CreateCreativeVariantInputBase.shape, async (input) => {
+  server.tool("create_creative_variant", "Crea un video, imagen o secci\xF3n de landing adicional dentro de una tarea existente. ES UNA ACCI\xD3N DE PAGO: primero llama estimate_creative_variant, muestra el rango de cr\xE9ditos al usuario y solo despu\xE9s invoca este tool con confirm=true. Las recomendaciones IA tambi\xE9n son acciones pagas a 2x del costo real. clientRequestId es obligatorio: genera un UUID por intenci\xF3n y reutiliza el mismo ante timeouts o transporte ambiguo. Si recibes status=error, pide confirmaci\xF3n para un intento nuevo y usa otro UUID. Reutiliza el producto y referencias del task origen; crea un child task independiente y devuelve variantTaskId. Para landing puedes enviar instructions en texto libre y omitir sectionKey: el backend lo clasifica con IA. No expone ni permite cambiar videoModel, videoTier, videoStyle o narrativeStyle; esos valores se heredan del task origen.", CreateCreativeVariantInputBase.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const validatedInput = parseVariantInput(CreateCreativeVariantInput, input);
       const estimateInput = EstimateCreativeVariantInput.parse({
@@ -13094,7 +13297,7 @@ var RegenerateVideoScriptInput = z51.object({
   narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion. Incluye valores hist\xF3ricos porque esta herramienta tambi\xE9n regenera tareas antiguas. 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?, 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 (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\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) => {
+  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?, 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 (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\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, READS_INTERNAL, async (input) => {
     try {
       const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
       const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);
@@ -13103,7 +13306,7 @@ function registerScriptReviewTools(server, api) {
       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) => {
+  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, OVERWRITES_EXTERNAL, async (input) => {
     try {
       const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/regenerate`, {
         angleKey: input.angleKey,
@@ -13114,25 +13317,36 @@ function registerScriptReviewTools(server, api) {
       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 valida el rango POR-ESCENA si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas).\n4. TOPE GLOBAL: adem\xE1s del rango por-escena, el backend rechaza con 400 ("El guion no cabe en el tiempo del video. Ac\xF3rtalo y vuelve a aprobar.") cuando el TOTAL de palabras de TODO el guion (incluidas las escenas que no editaste) supera el cupo de la voz \u2014 porque ese guion se pasar\xEDa del tope de duraci\xF3n al renderizar. Si lo ves, acorta las escenas m\xE1s largas (la suma de `maxWords` de get_video_script es el techo total) y reintenta; o usa regenerate_video_script. Este 400 es s\xEDncrono y NO consume render.\n5. 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.\n6. 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);
+  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 valida el rango POR-ESCENA si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas).\n4. TOPE GLOBAL: adem\xE1s del rango por-escena, el backend rechaza con 400 ("El guion no cabe en el tiempo del video. Ac\xF3rtalo y vuelve a aprobar.") cuando el TOTAL de palabras de TODO el guion (incluidas las escenas que no editaste) supera el cupo de la voz \u2014 porque ese guion se pasar\xEDa del tope de duraci\xF3n al renderizar. Si lo ves, acorta las escenas m\xE1s largas (la suma de `maxWords` de get_video_script es el techo total) y reintenta; o usa regenerate_video_script. Este 400 es s\xEDncrono y NO consume render.\n5. 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.\n6. 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,
+    // Not CREATES_INTERNAL: approving the script is what STARTS the render, so
+    // this call dispatches jobs to the video providers and burns credits. Its own
+    // description says so ("Tras llamarlo, el render arranca y consume créditos").
+    // A host that decides when to interrupt the user by `destructiveHint ||
+    // openWorldHint` would otherwise auto-invoke the one call that spends money.
+    CREATES_EXTERNAL,
+    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 z52 } 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.", z52.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.", z52.object({}).shape, READS_INTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/shopify/shops");
       return asText(r);
@@ -13144,7 +13358,7 @@ function registerConnectionTools(server, api) {
     shopDomain: z52.string().min(3).max(120),
     query: z52.string().trim().max(120).optional(),
     taskId: z52.string().uuid().optional()
-  }).shape, async ({ shopDomain, query, taskId }) => {
+  }).shape, READS_EXTERNAL, async ({ shopDomain, query, taskId }) => {
     try {
       const params = new URLSearchParams({
         shopDomain
@@ -13157,7 +13371,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Para publicar, prefiere `list_meta_destinations`, que tambi\xE9n devuelve el portfolio y las p\xE1ginas disponibles. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z52.object({}).shape, async () => {
+  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Para publicar, prefiere `list_meta_destinations`, que tambi\xE9n devuelve el portfolio y las p\xE1ginas disponibles. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z52.object({}).shape, READS_EXTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/facebook/ad-accounts");
       return asText(r);
@@ -13168,6 +13382,7 @@ function registerConnectionTools(server, api) {
   server.registerTool("list_meta_destinations", {
     description: "Lista los destinos de publicaci\xF3n de Meta del usuario: Business portfolios, cuentas publicitarias dentro de cada portfolio y Facebook Pages disponibles. Es obligatorio llamar esta herramienta antes de publicar, mostrar las opciones y enviar al publicador el `portfolioId`, `adAccountId` y `pageId` elegidos; nunca elijas silenciosamente la primera p\xE1gina o cuenta. No modifica Meta.",
     inputSchema: z52.object({}).shape,
+    annotations: READS_EXTERNAL,
     _meta: {
       "openai/widgetAccessible": true
     }
@@ -13179,7 +13394,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.", z52.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.", z52.object({}).shape, READS_EXTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/tiktok/advertisers");
       return asText(r);
@@ -13193,7 +13408,7 @@ __name(registerConnectionTools, "registerConnectionTools");
 // src/tools/actors.ts
 import { z as z53 } from "zod";
 function registerActorTools(server, api) {
-  server.tool("list_actors", "Lista los personajes guardados del usuario (personas creadas con IA que pueden protagonizar los videos e im\xE1genes). Devuelve id, nombre, descripci\xF3n, g\xE9nero y voz. Usa el `id` como `actorId` al crear o editar una tarea. Solo aparecen los personajes listos para usar; si la lista est\xE1 vac\xEDa, dile al usuario que cree uno en productmaker.app antes de intentar asignarlo. No modifica nada.", z53.object({}).shape, async () => {
+  server.tool("list_actors", "Lista los personajes guardados del usuario (personas creadas con IA que pueden protagonizar los videos e im\xE1genes). Devuelve id, nombre, descripci\xF3n, g\xE9nero y voz. Usa el `id` como `actorId` al crear o editar una tarea. Solo aparecen los personajes listos para usar; si la lista est\xE1 vac\xEDa, dile al usuario que cree uno en productmaker.app antes de intentar asignarlo. No modifica nada.", z53.object({}).shape, READS_INTERNAL, async () => {
     try {
       const rows = await api.getJson("/v1/actors");
       const actors = (Array.isArray(rows) ? rows : []).filter((actor) => actor.status === "ready").map(({ id, name, description, gender, voiceId }) => ({
@@ -13238,8 +13453,37 @@ var ShopifyInput = z54.object({
   ]).optional(),
   /** Shopify product GID, numeric id, or admin product URL. Required when
   * publicationMode is `existing`. */
-  targetProductId: z54.string().trim().min(1).max(300).optional()
+  targetProductId: z54.string().trim().min(1).max(300).optional(),
+  /** Add an announcement bar text above add-to-cart (optional). */
+  announcementBarEnabled: z54.boolean().optional(),
+  announcementBarText: z54.string().trim().min(1).max(SHOPIFY_ANNOUNCEMENT_BAR_MAX_LENGTH).optional()
+});
+var ShopifyInputWithAnnouncementBarValidation = ShopifyInput.superRefine((value, ctx) => {
+  if (value.announcementBarEnabled && !value.announcementBarText) {
+    ctx.addIssue({
+      code: z54.ZodIssueCode.custom,
+      path: [
+        "announcementBarText"
+      ],
+      message: "announcementBarText is required when announcementBarEnabled is true"
+    });
+  }
+  if (!value.announcementBarEnabled && value.announcementBarText) {
+    ctx.addIssue({
+      code: z54.ZodIssueCode.custom,
+      path: [
+        "announcementBarText"
+      ],
+      message: "announcementBarText requires announcementBarEnabled to be true"
+    });
+  }
 });
+function parseShopifyInput(rawInput) {
+  const parsed = ShopifyInputWithAnnouncementBarValidation.safeParse(rawInput);
+  if (!parsed.success) throw invalidInputFromZod(parsed.error);
+  return parsed.data;
+}
+__name(parseShopifyInput, "parseShopifyInput");
 var McpCampaignConfig = z54.object({
   /** ALWAYS in US dollars, whatever the ad account's currency is. ProductMaker
   *  converts to the account currency server-side. Do NOT pre-convert: on a COP
@@ -13475,9 +13719,10 @@ var TikTokInput = z54.object({
 });
 function registerPublishTools(server, api, opts = {}) {
   const transport = opts.transport ?? "http";
-  server.tool("publish_to_shopify", "Publica o actualiza la landing en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica o actualiza la landing en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input) => {
     try {
-      if (input.publicationMode === "existing" && !input.targetProductId) {
+      const parsed = parseShopifyInput(input);
+      if (parsed.publicationMode === "existing" && !parsed.targetProductId) {
         return {
           isError: true,
           content: [
@@ -13488,29 +13733,31 @@ function registerPublishTools(server, api, opts = {}) {
           ]
         };
       }
-      const variantIndex = input.variantIndex ?? 0;
-      const availableImages = await fetchLandingImageCount(api, input.taskId);
+      const variantIndex = parsed.variantIndex ?? 0;
+      const availableImages = await fetchLandingImageCount(api, parsed.taskId);
       const effectiveAvailable = availableImages > 0 ? availableImages : 3;
-      const numImages = Math.min(input.numLandingImages ?? effectiveAvailable, effectiveAvailable);
+      const numImages = Math.min(parsed.numLandingImages ?? effectiveAvailable, effectiveAvailable);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
         imageIndex: i,
         variantIndex
       }));
-      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/publish/shopify`, {
-        shopDomain: input.shopDomain,
+      const r = await api.postJson(`/v1/tasks/${encodeURIComponent(parsed.taskId)}/publish/shopify`, {
+        shopDomain: parsed.shopDomain,
         selectedLandingImages,
-        showVariantPicker: input.showVariantPicker,
-        publicationMode: input.publicationMode,
-        targetProductId: input.targetProductId
+        showVariantPicker: parsed.showVariantPicker,
+        publicationMode: parsed.publicationMode,
+        targetProductId: parsed.targetProductId,
+        announcementBarEnabled: parsed.announcementBarEnabled,
+        announcementBarText: parsed.announcementBarText
       });
       return renderShopifyPublishMarkdown(r);
     } catch (e) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`.", MetaInput.shape, async ({ taskId, campaignConfig, primaryText, phoneNumber, ...rest }) => {
+  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`.", MetaInput.shape, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, phoneNumber, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -13538,7 +13785,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, publica s\xF3lo los assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla, quedan durante el TTL para reintento. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, async (rawInput) => {
+  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, publica s\xF3lo los assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla, quedan durante el TTL para reintento. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, CREATES_EXTERNAL, async (rawInput) => {
     try {
       const parsed = PublishCreativesToMetaInput.safeParse(rawInput);
       if (!parsed.success) throw invalidInputFromZod(parsed.error);
@@ -13628,7 +13875,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario SIEMPRE en d\xF3lares, ej. 25 \u2014 nunca el n\xFAmero en moneda local), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
+  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario SIEMPRE en d\xF3lares, ej. 25 \u2014 nunca el n\xFAmero en moneda local), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -13854,6 +14101,7 @@ function registerMediaUploadTools(server, api) {
     title: "Subir archivos",
     description: "Abre el selector universal de ProductMaker para im\xE1genes o videos del usuario. Ll\xE1malo autom\xE1ticamente y antes de preguntar por campos faltantes cuando una petici\xF3n natural adjunte o mencione un archivo local, por ejemplo \u2018crea una landing con este producto\u2019, \u2018haz creativos con esta foto\u2019 o \u2018sube este video a Meta\u2019; hazlo aunque el usuario diga que todav\xEDa no generes ni publiques, porque esta herramienta solo prepara el archivo y no consume cr\xE9ditos, salvo que proh\xEDba expl\xEDcitamente subir, compartir o almacenar el archivo; no pidas una ruta local ni URL. Es la \xFAnica ruta de carga para create_product_task, generate_image_creatives, generate_video_creative, generate_free_video, generate_landing y publish_creatives_to_meta. Pasa las referencias opcionales de ChatGPT en files; si el host no puede transferirlas, el mismo App muestra el selector inline. Usa uploadPurpose=product_reference para fotos de producto y landings, creative para creativos o anuncios, y generic solo cuando ninguno aplique. Usa mediaKind=image para referencias de producto y landings; mixed solo cuando el consumidor acepte ambos tipos. El App NO te avisa cuando termina: en cuanto el usuario diga que ya subi\xF3 el archivo o que sigas, llama `check_media_upload` con este sessionId para obtener los assetId, y reanuda la intenci\xF3n original usando \xFAnicamente assetId y mediaKind, sin pedir que vuelva a subir ni mostrar datos t\xE9cnicos. El enlace externo es fallback solo si el App inline falla. Esta herramienta no genera, publica ni consume cr\xE9ditos.",
     inputSchema: UploadSessionToolInputShape,
+    annotations: CREATES_INTERNAL,
     outputSchema: UniversalUploadStructuredResponse.shape,
     _meta: {
       ui: {
@@ -13894,6 +14142,7 @@ function registerMediaUploadTools(server, api) {
   server.registerTool("check_media_upload", {
     description: "Comprueba la carga universal. Ll\xE1mala cuando el usuario diga que ya subi\xF3 sus archivos: es la \xFAnica forma de enterarte, porque el App no manda mensajes al chat. Si status=pending, el usuario todav\xEDa no ha terminado: d\xEDselo y espera, no inventes un assetId ni abras otra sesi\xF3n de carga. Si status=uploaded, conserva assets[] para la petici\xF3n anterior y pasa cada assetId \xFAnicamente a un consumidor compatible. Un asset de video solo sirve donde se admite video; las referencias de producto, imagen y landing requieren mediaKind=image. No muestres IDs t\xE9cnicos como JSON al usuario.",
     inputSchema: UploadStatusInput.shape,
+    annotations: READS_INTERNAL,
     _meta: {
       "openai/widgetAccessible": true
     }
@@ -13918,7 +14167,7 @@ var TikTokStatusInput = z56.object({
   advertiserId: z56.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) => {
+  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, READS_EXTERNAL, async (input) => {
     try {
       const r = await api.getJson(`/v1/facebook/campaigns/${encodeURIComponent(input.campaignId)}`);
       return renderMetaStatusMarkdown(r);
@@ -13926,7 +14175,7 @@ function registerCampaignTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("get_tiktok_campaign_status", "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada. Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, async (input) => {
+  server.tool("get_tiktok_campaign_status", "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada. Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, READS_EXTERNAL, async (input) => {
     try {
       const r = await api.getJson(`/v1/tiktok/campaigns/${encodeURIComponent(input.campaignId)}?advertiserId=${encodeURIComponent(input.advertiserId)}`);
       return renderTikTokStatusMarkdown(r);
@@ -14379,7 +14628,7 @@ var ProductCostingToolInput = z59.object({
   desiredMarginPercent: optionalPercent("Margen de ganancia deseado. Ejemplo: 10 significa 10%. Omite para usar el valor gu\xEDa editable del pa\xEDs.")
 });
 function registerProductCostingTools(server) {
-  server.tool("cost_product", "Calcula GRATIS y sin cr\xE9ditos cu\xE1nto cobrar por un producto de dropshipping en cualquiera de los pa\xEDses disponibles en ProductMaker. Es READ-ONLY: no crea tareas ni publica nada. Pide country y el costo real del proveedor; los dem\xE1s campos pueden usar valores gu\xEDa editables del pa\xEDs. Devuelve `price` y `compareAtPrice` listos para `create_product_task`. No inventes un costo de proveedor.", ProductCostingToolInput.shape, async (input) => {
+  server.tool("cost_product", "Calcula GRATIS y sin cr\xE9ditos cu\xE1nto cobrar por un producto de dropshipping en cualquiera de los pa\xEDses disponibles en ProductMaker. Es READ-ONLY: no crea tareas ni publica nada. Pide country y el costo real del proveedor; los dem\xE1s campos pueden usar valores gu\xEDa editables del pa\xEDs. Devuelve `price` y `compareAtPrice` listos para `create_product_task`. No inventes un costo de proveedor.", ProductCostingToolInput.shape, READS_INTERNAL, async (input) => {
     if (input.country !== void 0 && input.country !== "CO" && [
       input.supplierCostCop,
       input.shippingCostCop,
@@ -14651,7 +14900,7 @@ async function pollUntilTerminal(api, runId, waitSeconds) {
 }
 __name(pollUntilTerminal, "pollUntilTerminal");
 function registerProductResearchTools(server, api) {
-  server.tool("find_winning_products", `Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads). CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, async (input) => {
+  server.tool("find_winning_products", `Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads). CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, CREATES_EXTERNAL, async (input) => {
     const parsed = FindInput.parse(input);
     if (!parsed.confirmed) {
       throw mcp(McpErrorCode.INVALID_INPUT, `This research run costs ${PRICE_CREDITS} credits. Tell the user the cost, get an explicit yes, then call again with confirmed: true.`);
@@ -14685,7 +14934,7 @@ _Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reci
       throw translateError(error);
     }
   });
-  server.tool("get_product_research_run", "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto. GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, async (input) => {
+  server.tool("get_product_research_run", "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto. GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, READS_INTERNAL, async (input) => {
     const parsed = GetInput.parse(input);
     try {
       const run = await api.getJson(`/v1/product-research/runs/${parsed.runId}`);
@@ -14705,7 +14954,7 @@ _Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reci
       throw translateError(error);
     }
   });
-  server.tool("list_product_research_runs", "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua. GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, async (input) => {
+  server.tool("list_product_research_runs", "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua. GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, READS_INTERNAL, async (input) => {
     const parsed = ListInput.parse(input);
     try {
       const runs = await api.getJson(`/v1/product-research/runs?limit=${parsed.limit}`);
@@ -14948,28 +15197,38 @@ function projectText(raw) {
 }
 __name(projectText, "projectText");
 function registerDropshippingProjectTools(server, api) {
-  server.tool("start_dropshipping_project", "Inicia o reanuda un proyecto opcional de dropshipping. \xDAsalo cuando el usuario quiera seguir un producto hasta publicarlo; para una operaci\xF3n puntual usa el tool directo. La creaci\xF3n es idempotente y no cobra cr\xE9ditos.", StartProjectInput.shape, async (input) => {
+  server.tool("start_dropshipping_project", "Inicia o reanuda un proyecto opcional de dropshipping. \xDAsalo cuando el usuario quiera seguir un producto hasta publicarlo; para una operaci\xF3n puntual usa el tool directo. La creaci\xF3n es idempotente y no cobra cr\xE9ditos.", StartProjectInput.shape, CREATES_INTERNAL, async (input) => {
     try {
       return projectText(await api.postJson("/v1/dropshipping-projects", input));
     } catch (error) {
       throw translateError(error);
     }
   });
-  server.tool("cost_dropshipping_project", "Guarda el costeo de un proyecto guiado. Escribe solo inputs; el backend recalcula el resultado can\xF3nico y controla la versi\xF3n. Pide al usuario el costo real del proveedor: nunca lo inventes. No crea tarea ni publica nada.", CostProjectInput.shape, async (input) => {
-    try {
-      if (input.returnRate + input.cancellationRate >= 1) {
-        throw new Error("returnRate + cancellationRate debe ser menor que 1.");
+  server.tool(
+    "cost_dropshipping_project",
+    "Guarda el costeo de un proyecto guiado. Escribe solo inputs; el backend recalcula el resultado can\xF3nico y controla la versi\xF3n. Pide al usuario el costo real del proveedor: nunca lo inventes. No crea tarea ni publica nada.",
+    CostProjectInput.shape,
+    // Overwrites the costing inputs already saved on the project — the same
+    // "previous values are gone" case as edit_task_draft, so destructive.
+    // idempotentHint stays false despite the PUT: the `version` guard makes a
+    // blind retry FAIL rather than replay, so a host should not auto-retry it.
+    OVERWRITES_INTERNAL,
+    async (input) => {
+      try {
+        if (input.returnRate + input.cancellationRate >= 1) {
+          throw new Error("returnRate + cancellationRate debe ser menor que 1.");
+        }
+        const { projectId, version, ...costingInput } = input;
+        return projectText(await api.putJson(`/v1/dropshipping-projects/${encodeURIComponent(projectId)}/costing`, {
+          version,
+          input: costingInput
+        }));
+      } catch (error) {
+        throw translateError(error);
       }
-      const { projectId, version, ...costingInput } = input;
-      return projectText(await api.putJson(`/v1/dropshipping-projects/${encodeURIComponent(projectId)}/costing`, {
-        version,
-        input: costingInput
-      }));
-    } catch (error) {
-      throw translateError(error);
     }
-  });
-  server.tool("guide_dropshipping_launch", "Gu\xEDa read-only de un recorrido COMPLETO de dropshipping, desde producto/costeo hasta creativos, tienda y publicidad. No uses este tool para subir o publicar un creativo puntual en Meta: llama directamente `request_media_upload`, `list_meta_destinations` y `publish_creatives_to_meta`. Sin projectId explica cu\xE1ndo usar un flujo directo versus uno guiado; con projectId devuelve la fase y la \xFAnica nextAction calculada por ProductMaker. Despu\xE9s de cada mutaci\xF3n vuelve a llamar este tool o lee el proyecto. Nunca activa Meta.", GuideInput.shape, async (input) => {
+  );
+  server.tool("guide_dropshipping_launch", "Gu\xEDa read-only de un recorrido COMPLETO de dropshipping, desde producto/costeo hasta creativos, tienda y publicidad. No uses este tool para subir o publicar un creativo puntual en Meta: llama directamente `request_media_upload`, `list_meta_destinations` y `publish_creatives_to_meta`. Sin projectId explica cu\xE1ndo usar un flujo directo versus uno guiado; con projectId devuelve la fase y la \xFAnica nextAction calculada por ProductMaker. Despu\xE9s de cada mutaci\xF3n vuelve a llamar este tool o lee el proyecto. Nunca activa Meta.", GuideInput.shape, READS_INTERNAL, async (input) => {
     try {
       if (!input.projectId) {
         return asText({