@productmaker/mcp 1.16.2 → 1.17.0

package/dist/http.js

@@ -12,6 +12,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/api-client.ts
+import { createHash } from "crypto";
 var ApiHttpError = class extends Error {
   static {
     __name(this, "ApiHttpError");
@@ -38,6 +39,15 @@ var ApiClient = class {
       Authorization: `Bearer ${this.apiKey}`
     };
   }
+  /**
+  * Stable per-key identifier. The MCP never sees the userId — the API key is
+  * the only per-user handle it holds — so this stands in as the user
+  * component of derived idempotency keys. Never log or return it raw to a
+  * caller: it is derived from a secret.
+  */
+  fingerprint() {
+    return createHash("sha256").update(this.apiKey).digest("hex").slice(0, 32);
+  }
   async getJson(path3) {
     const res = await fetch(`${this.baseUrl}${path3}`, {
       headers: this.authHeaders()
@@ -132,10 +142,10 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.16.2";
+var MCP_VERSION = "1.17.0";
 
 // src/tools/tasks.ts
-import { z as z38 } from "zod";
+import { z as z39 } from "zod";
 
 // src/resolve-image.ts
 import { lookup as dnsLookup } from "dns/promises";
@@ -3149,6 +3159,125 @@ var AdminQualityReportListResponse = z24.object({
 var UpdateQualityReportStatusRequest = z24.object({
   status: QualityReportStatus
 });
+var AdminSupportConversationStatus = z24.enum([
+  "bot_active",
+  "human_pending",
+  "human_active",
+  "closed"
+]);
+var AdminSupportDeliveryStatus = z24.enum([
+  "draft",
+  "pending",
+  "sent",
+  "delivered",
+  "read",
+  "failed",
+  "blocked"
+]);
+var AdminSupportMessage = z24.object({
+  id: z24.string().uuid(),
+  direction: z24.enum([
+    "inbound",
+    "outbound"
+  ]),
+  senderKind: z24.enum([
+    "user",
+    "bot",
+    "admin",
+    "system"
+  ]),
+  messageType: z24.enum([
+    "text",
+    "image",
+    "audio",
+    "document",
+    "interactive",
+    "status"
+  ]),
+  bodyRedacted: z24.string().nullable(),
+  deliveryStatus: AdminSupportDeliveryStatus.nullable(),
+  createdAt: z24.string().datetime()
+});
+var AdminSupportTicket = z24.object({
+  id: z24.string().uuid(),
+  category: z24.enum([
+    "how_to",
+    "credits",
+    "billing",
+    "task_status",
+    "task_error",
+    "video_quality",
+    "landing_quality",
+    "image_quality",
+    "feature_request",
+    "other"
+  ]),
+  failureMode: z24.string().nullable(),
+  status: z24.enum([
+    "open",
+    "triaged",
+    "resolved",
+    "rejected"
+  ]),
+  summary: z24.string(),
+  taskId: z24.string().nullable(),
+  mixTaskId: z24.string().nullable(),
+  qualityReportId: z24.string().nullable(),
+  handoffReason: z24.string().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime()
+});
+var AdminSupportConversation = z24.object({
+  id: z24.string().uuid(),
+  status: AdminSupportConversationStatus,
+  priority: z24.enum([
+    "low",
+    "normal",
+    "high",
+    "urgent"
+  ]),
+  currentIntent: z24.string().nullable(),
+  assignedAdminId: z24.string().nullable(),
+  customerServiceWindowEndsAt: z24.string().datetime().nullable(),
+  lastInboundAt: z24.string().datetime().nullable(),
+  createdAt: z24.string().datetime(),
+  updatedAt: z24.string().datetime(),
+  contact: z24.object({
+    id: z24.string().uuid(),
+    userId: z24.string().nullable(),
+    verifiedAt: z24.string().datetime().nullable(),
+    botMode: z24.enum([
+      "enabled",
+      "paused",
+      "opted_out"
+    ]),
+    locale: z24.string()
+  }),
+  messages: z24.array(AdminSupportMessage),
+  tickets: z24.array(AdminSupportTicket)
+});
+var AdminSupportListQuery = z24.object({
+  status: AdminSupportConversationStatus.optional(),
+  take: z24.coerce.number().int().min(1).max(100).default(50),
+  cursorId: z24.string().uuid().optional()
+}).strict();
+var AdminSupportListResponse = z24.object({
+  conversations: z24.array(AdminSupportConversation),
+  nextCursor: z24.string().uuid().nullable()
+});
+var AdminSupportReplyRequest = z24.object({
+  body: z24.string().trim().min(1).max(4096),
+  idempotencyKey: z24.string().regex(/^[A-Za-z0-9_-]{8,128}$/)
+}).strict();
+var AdminSupportEmptyActionRequest = z24.object({}).strict();
+var AdminSupportActionResponse = z24.object({
+  conversation: AdminSupportConversation
+});
+var AdminSupportReplyResponse = z24.object({
+  messageId: z24.string().uuid(),
+  deliveryStatus: AdminSupportDeliveryStatus,
+  duplicate: z24.boolean()
+});
 
 // ../../packages/types/src/promo.ts
 import { z as z25 } from "zod";
@@ -3288,8 +3417,21 @@ import { z as z31 } from "zod";
 // ../../packages/types/src/campaigns.ts
 import { z as z30 } from "zod";
 var CAMPAIGN_LIMITS = {
-  /** Maximum number of creatives per campaign */
-  MAX_CREATIVES: 4,
+  /**
+  * Maximum number of creatives (= ads) per campaign.
+  *
+  * Not a Meta limit — Meta allows far more ads per ad set. This is our own
+  * bound on how many uploads one publish call will push through the Graph API
+  * in a single request. It was 4 with no stated reason, which forced callers
+  * with a normal batch (3 videos + 3 images) to drop two by hand.
+  */
+  MAX_CREATIVES: 10,
+  /**
+  * Maximum ad sets per campaign. Distinct from MAX_CREATIVES, which it used
+  * to share a constant with — that coupling meant raising the creative cap
+  * would silently raise the ad-set cap too.
+  */
+  MAX_AD_SETS: 4,
   /** Maximum video duration in seconds */
   MAX_VIDEO_DURATION_SECONDS: 180,
   /** Maximum file size in bytes (350MB) */
@@ -3332,8 +3474,21 @@ var CampaignCreativeType = z30.enum([
 var CampaignCreative = z30.object({
   /** Unique identifier for the creative */
   id: z30.string(),
-  /** The uploaded file (null when loaded from server) */
-  file: z30.instanceof(File).nullable(),
+  /**
+  * The uploaded file (null when loaded from server).
+  *
+  * Deliberately NOT `z.instanceof(File)`: `File` is a browser global that Node
+  * only exposes from v20. `z.instanceof` dereferences it while the schema is
+  * being *constructed*, so merely importing this module threw
+  * `ReferenceError: File is not defined` on Node 18 — which killed the whole
+  * MCP CLI on startup, because its bundle pulls this barrel in for unrelated
+  * types and never touches this schema. `z.custom` defers the check to
+  * validation time and guards the global, so the module imports on any runtime
+  * and only the browser upload path needs a real `File`.
+  */
+  file: z30.custom((value) => typeof File !== "undefined" && value instanceof File, {
+    message: "Expected a File"
+  }).nullable(),
   /** Type of media: image or video */
   type: CampaignCreativeType,
   /** Creative title (max 120 chars) - Maps to Meta's "Título" */
@@ -3442,6 +3597,9 @@ var HttpUrl = z30.string().url().refine((value) => {
     return false;
   }
 }, "URL must use http or https");
+var MetaAdAccountId = z30.string().trim().min(1, "Debes seleccionar una cuenta publicitaria").transform((value) => /^\d+$/.test(value) ? `act_${value}` : value).refine((value) => /^act_\d+$/.test(value), {
+  message: 'adAccountId must look like "act_1234567890" (a bare numeric id is also accepted)'
+});
 var MetaCampaignDestination = z30.discriminatedUnion("type", [
   z30.object({
     type: z30.literal("landing"),
@@ -3474,7 +3632,7 @@ var MetaCampaignConfigBase = z30.object({
   campaignDailyBudget: z30.number().int().positive().optional(),
   /** Omitted preserves the historical recommended-floor behavior. */
   budgetPolicy: MetaBudgetPolicy.optional(),
-  adSets: z30.array(MetaAdSetConfig).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
+  adSets: z30.array(MetaAdSetConfig).min(1).max(CAMPAIGN_LIMITS.MAX_AD_SETS),
   destination: MetaCampaignDestination,
   saveAsDefault: z30.boolean().default(true)
 });
@@ -3507,7 +3665,7 @@ var MetaCampaignConfig = MetaCampaignConfigBase.superRefine((value, ctx) => {
 var MetaCampaignDefaults = MetaCampaignConfigBase.omit({
   saveAsDefault: true
 }).extend({
-  adSets: z30.array(MetaAdSetDefaults).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
+  adSets: z30.array(MetaAdSetDefaults).min(1).max(CAMPAIGN_LIMITS.MAX_AD_SETS),
   /**
   * Ad-account currency (ISO 4217: USD/COP/MXN/...) at the time the user saved
   * these defaults. The wizard re-uses the saved budget only when the current
@@ -3536,7 +3694,7 @@ var UploadToMetaRequest = z30.object({
     thumbnailUrl: HttpUrl.optional()
   })).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
   /** Meta Ad Account ID */
-  adAccountId: z30.string().min(1),
+  adAccountId: MetaAdAccountId,
   /** Optional Meta Pixel ID */
   pixelId: z30.string().optional(),
   /** Landing page URL (required for landing destinations; omitted for whatsapp) */
@@ -3618,7 +3776,7 @@ var MetaCampaignOverridesSchema = z31.object({
   destination: MetaCampaignDestination.optional()
 });
 var FacebookCreateCampaignBodySchema = z31.object({
-  adAccountId: z31.string().min(1, "Debes seleccionar una cuenta publicitaria"),
+  adAccountId: MetaAdAccountId,
   pixelId: z31.string().optional(),
   landingUrl: HttpUrl2.optional(),
   campaignConfig: MetaCampaignConfig.optional(),
@@ -3694,8 +3852,8 @@ var FacebookCreateCampaignFromCreativesBodySchema = z31.object({
     mediaUrl: HttpUrl2,
     thumbnailUrl: HttpUrl2.optional(),
     creativeId: z31.string().min(1).optional()
-  })).min(1).max(4),
-  adAccountId: z31.string().min(1),
+  })).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
+  adAccountId: MetaAdAccountId,
   pixelId: z31.string().optional(),
   /** Required unless campaignConfig.destination is 'whatsapp' (see superRefine below). */
   landingUrl: HttpUrl2.optional(),
@@ -3810,8 +3968,8 @@ var FacebookCreateCampaignFromTasksBodySchema = z31.object({
     description: z31.string().max(500).optional(),
     cta: MetaCtaType.optional(),
     creativeId: z31.string().min(1).optional()
-  })).min(1).max(4),
-  adAccountId: z31.string().min(1),
+  })).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
+  adAccountId: MetaAdAccountId,
   pixelId: z31.string().optional(),
   landingUrl: HttpUrl2.optional(),
   targetCountry: z31.string().length(2).default("US"),
@@ -3955,6 +4113,23 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.4,
     userPriceCents: 0.8
   },
+  // WhatsApp ProductMaker intent proposal. Real OpenRouter usage.cost wins;
+  // this is only the fallback when the relay omits cost.
+  "openrouter:whatsapp-product-agent-intent": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
+  // Internal support calls are cost-only: callers explicitly override user
+  // price to zero. Static COGS estimates apply because OpenAI Responses exposes
+  // token counts but not the provider's dollar charge.
+  "openai:whatsapp-support-classifier": {
+    ourCostCents: 0.1,
+    userPriceCents: 0.2
+  },
+  "openai:whatsapp-support-draft": {
+    ourCostCents: 0.4,
+    userPriceCents: 0.8
+  },
   // Task-derived creative recommendation (angle/persona/script/landing-section).
   // OpenRouter usage normally supplies the exact COGS and the call layer charges
   // 2x. This rule is the fail-closed fallback when usage.cost is unavailable.
@@ -6364,6 +6539,43 @@ var RegenerateEditRequestSchema = z36.object({
   comment: z36.string().min(1).max(2e3)
 });
 
+// ../../packages/types/src/scene-subject-contract.ts
+import { z as z37 } from "zod";
+var SceneSubjectContractSchema = z37.object({
+  maxPeople: z37.number().int().min(1).max(10),
+  minPeople: z37.number().int().min(0).max(10),
+  minDistinctPeople: z37.number().int().min(0).max(10),
+  maxHands: z37.number().int().min(0).max(20)
+}).superRefine((value, ctx) => {
+  if (value.minPeople > value.maxPeople) {
+    ctx.addIssue({
+      code: z37.ZodIssueCode.custom,
+      path: [
+        "minPeople"
+      ],
+      message: "minPeople cannot exceed maxPeople"
+    });
+  }
+  if (value.minDistinctPeople > value.maxPeople) {
+    ctx.addIssue({
+      code: z37.ZodIssueCode.custom,
+      path: [
+        "minDistinctPeople"
+      ],
+      message: "minDistinctPeople cannot exceed maxPeople"
+    });
+  }
+  if (value.minDistinctPeople > value.minPeople) {
+    ctx.addIssue({
+      code: z37.ZodIssueCode.custom,
+      path: [
+        "minDistinctPeople"
+      ],
+      message: "minDistinctPeople cannot exceed minPeople"
+    });
+  }
+});
+
 // src/resolve-media.ts
 var MAX_MEDIA_BYTES = CAMPAIGN_LIMITS.MAX_FILE_SIZE_BYTES;
 var MEDIA_FORMATS = [
@@ -6603,10 +6815,10 @@ async function resolveMediaRef(ref, opts) {
 __name(resolveMediaRef, "resolveMediaRef");
 
 // src/tools/shared.ts
-import { z as z37 } from "zod";
-var Lang = z37.string().min(2).max(10);
-var Country = z37.string().min(2).max(3);
-var LandingStrategyEnum = z37.enum([
+import { z as z38 } from "zod";
+var Lang = z38.string().min(2).max(10);
+var Country = z38.string().min(2).max(3);
+var LandingStrategyEnum = z38.enum([
   "auto",
   "classic",
   "pain_solution",
@@ -6615,12 +6827,12 @@ var LandingStrategyEnum = z37.enum([
   "offer_value",
   "lifestyle_identity"
 ]);
-var LandingImageFormatEnum = z37.enum([
+var LandingImageFormatEnum = z38.enum([
   "9:16",
   "4:5",
   "1:1"
 ]);
-var VideoPresetEnum = z37.enum([
+var VideoPresetEnum = z38.enum([
   "auto",
   "ugc_dynamic",
   "ugc_unboxing_chaos",
@@ -6631,7 +6843,7 @@ var VideoPresetEnum = z37.enum([
   "pixar_problem",
   "pixar_sassy"
 ]);
-var TaskCreativeVariantVideoPresetEnum = z37.enum([
+var TaskCreativeVariantVideoPresetEnum = z38.enum([
   "auto",
   "ugc_dynamic",
   "problem_solution",
@@ -6690,7 +6902,7 @@ function resolveVideoPreset(preset) {
   return VIDEO_PRESET_RESOLUTION[preset] ?? null;
 }
 __name(resolveVideoPreset, "resolveVideoPreset");
-var VideoTierEnum = z37.enum([
+var VideoTierEnum = z38.enum([
   "basic"
 ]);
 function resolveVideoTier(_tier) {
@@ -6705,17 +6917,17 @@ function resolveVideoFormatForDuration(durationSeconds) {
   return durationSeconds === 30 ? "double_30s" : "single_15s";
 }
 __name(resolveVideoFormatForDuration, "resolveVideoFormatForDuration");
-var VideoResolutionEnum = z37.enum([
+var VideoResolutionEnum = z38.enum([
   "480p",
   "720p"
 ]);
-var VideoStyleEnum = z37.enum([
+var VideoStyleEnum = z38.enum([
   "ugc",
   "cartoon_3d",
   "product_only",
   "ai_dynamic"
 ]);
-var NarrativeStyleEnum = z37.enum([
+var NarrativeStyleEnum = z38.enum([
   "review",
   "problem_product_cta",
   "product_showcase",
@@ -6730,7 +6942,7 @@ var NarrativeStyleEnum = z37.enum([
   "ugc_skeptic_confession",
   "ugc_demo_review"
 ]);
-var PublicNarrativeStyleEnum = z37.enum([
+var PublicNarrativeStyleEnum = z38.enum([
   "review",
   "ugc_unboxing_chaos",
   "problem_product_cta",
@@ -6740,7 +6952,7 @@ var PublicNarrativeStyleEnum = z37.enum([
   "animated_problem_pixar",
   "sassy_product_pixar"
 ]);
-var VideoModelEnum = z37.enum([
+var VideoModelEnum = z38.enum([
   "veo",
   "wan",
   "bytedance",
@@ -6748,25 +6960,25 @@ var VideoModelEnum = z37.enum([
   "grok",
   "kling"
 ]);
-var ProductReferenceUserChoiceEnum = z37.enum([
+var ProductReferenceUserChoiceEnum = z38.enum([
   "same_product",
   "variants",
   "different_products",
   "combo_distinct"
 ]);
-var ProductReferenceCandidateGroupingEnum = z37.enum([
+var ProductReferenceCandidateGroupingEnum = z38.enum([
   "same_product_same_variant",
   "same_product_different_variants",
   "different_products",
   "unclear"
 ]);
-var GapDurationChoiceMirror = z37.object({
-  angleIndex: z37.number().int().nonnegative(),
-  recommendedSec: z37.union([
-    z37.literal(15),
-    z37.literal(30)
+var GapDurationChoiceMirror = z38.object({
+  angleIndex: z38.number().int().nonnegative(),
+  recommendedSec: z38.union([
+    z38.literal(15),
+    z38.literal(30)
   ]),
-  estimatedDeltaCredits: z37.number().int().nonnegative().optional()
+  estimatedDeltaCredits: z38.number().int().nonnegative().optional()
 });
 function buildSelectedImageUrlsHash(urls) {
   const input = [
@@ -6780,13 +6992,13 @@ function buildSelectedImageUrlsHash(urls) {
   return `fnv1a:${hash.toString(16).padStart(8, "0")}:${urls.length}`;
 }
 __name(buildSelectedImageUrlsHash, "buildSelectedImageUrlsHash");
-var ImageCreativeStyleEnum = z37.enum([
+var ImageCreativeStyleEnum = z38.enum([
   "studio",
   "floating",
   "ingredients",
   "in_use"
 ]);
-var ImageCreativeArchetypeEnum = z37.enum([
+var ImageCreativeArchetypeEnum = z38.enum([
   "direct_response_product_ad",
   "hero_outcome",
   "offer_value_prop",
@@ -6795,23 +7007,23 @@ var ImageCreativeArchetypeEnum = z37.enum([
   "problem_solution",
   "lifestyle_identity"
 ]);
-var ImageCreativeVisualTreatmentEnum = z37.enum([
+var ImageCreativeVisualTreatmentEnum = z38.enum([
   "performance_product_ad",
   "premium_dtc_carousel"
 ]);
-var ImageCreativeAspectRatioEnum = z37.enum([
+var ImageCreativeAspectRatioEnum = z38.enum([
   "1:1",
   "4:5",
   "9:16",
   "16:9"
 ]);
-var ImageRefSchema = z37.object({
-  url: z37.string().url().optional().describe('URL p\xFAblica HTTPS de la foto. Ej: una URL de Shopify CDN, Cloudinary, Imgur. \xDAsala cuando el usuario te diga "est\xE1 en X.com/foto.jpg" o cuando la foto ya est\xE9 hospedada.'),
-  path: z37.string().min(1).optional().describe('Ruta del archivo en el computador del usuario. Ej: "/Users/maria/Desktop/foto.jpg", "~/Pictures/camiseta.png", "C:\\Users\\Maria\\Desktop\\foto.jpg". El MCP local la lee del disco y la sube. SOLO funciona cuando el MCP corre local (stdio). NO funciona en mcp.productmaker.app (HTTP) \u2014 ah\xED usa `url`.')
+var ImageRefSchema = z38.object({
+  url: z38.string().url().optional().describe('URL p\xFAblica HTTPS de la foto. Ej: una URL de Shopify CDN, Cloudinary, Imgur. \xDAsala cuando el usuario te diga "est\xE1 en X.com/foto.jpg" o cuando la foto ya est\xE9 hospedada.'),
+  path: z38.string().min(1).optional().describe('Ruta del archivo en el computador del usuario. Ej: "/Users/maria/Desktop/foto.jpg", "~/Pictures/camiseta.png", "C:\\Users\\Maria\\Desktop\\foto.jpg". El MCP local la lee del disco y la sube. SOLO funciona cuando el MCP corre local (stdio). NO funciona en mcp.productmaker.app (HTTP) \u2014 ah\xED usa `url`.')
 }).refine((v) => Boolean(v.url) !== Boolean(v.path), {
   message: "each image entry must have exactly one of `url` or `path`"
 });
-var ImagesInput = z37.array(ImageRefSchema).min(1).max(5).describe('1 a 5 fotos del MISMO producto. La PRIMERA es la principal (hero); las dem\xE1s son \xE1ngulos adicionales. NO mezcles productos distintos en una sola llamada.\n\nCada entrada tiene EXACTAMENTE uno de:\n\u2022 `url` \u2014 URL p\xFAblica HTTPS (Shopify CDN, Cloudinary). Prefi\xE9rela si la foto ya est\xE1 hospedada.\n\u2022 `path` \u2014 Ruta del archivo en el computador del usuario (ej. "/Users/maria/Desktop/foto.jpg", "~/Downloads/camiseta.png"). \xDAsala cuando el usuario te dijo d\xF3nde guard\xF3 la foto. Solo MCP local \u2014 el cliente web rechaza paths.\n\nSi el usuario te peg\xF3 la foto en el chat pero no te dio ni URL ni ruta: PREG\xDANTALE d\xF3nde la tiene guardada (Escritorio, Descargas, etc.). Si el `path` falla con IMAGE_PATH_NOT_FOUND, prueba 1-2 ubicaciones obvias alternativas (~/Desktop, ~/Downloads) antes de molestar al usuario. Tras 3 intentos fallidos, p\xEDdele la ruta completa.');
+var ImagesInput = z38.array(ImageRefSchema).min(1).max(5).describe('1 a 5 fotos del MISMO producto. La PRIMERA es la principal (hero); las dem\xE1s son \xE1ngulos adicionales. NO mezcles productos distintos en una sola llamada.\n\nCada entrada tiene EXACTAMENTE uno de:\n\u2022 `url` \u2014 URL p\xFAblica HTTPS (Shopify CDN, Cloudinary). Prefi\xE9rela si la foto ya est\xE1 hospedada.\n\u2022 `path` \u2014 Ruta del archivo en el computador del usuario (ej. "/Users/maria/Desktop/foto.jpg", "~/Downloads/camiseta.png"). \xDAsala cuando el usuario te dijo d\xF3nde guard\xF3 la foto. Solo MCP local \u2014 el cliente web rechaza paths.\n\nSi el usuario te peg\xF3 la foto en el chat pero no te dio ni URL ni ruta: PREG\xDANTALE d\xF3nde la tiene guardada (Escritorio, Descargas, etc.). Si el `path` falla con IMAGE_PATH_NOT_FOUND, prueba 1-2 ubicaciones obvias alternativas (~/Desktop, ~/Downloads) antes de molestar al usuario. Tras 3 intentos fallidos, p\xEDdele la ruta completa.');
 function asText(value) {
   return {
     content: [
@@ -6864,6 +7076,28 @@ async function submitCreative(api, opts) {
   });
 }
 __name(submitCreative, "submitCreative");
+var ResearchTargetCountryEnum = z38.enum([
+  "CO",
+  "MX",
+  "PE",
+  "EC",
+  "CL"
+]);
+var ResearchCategoryEnum = z38.enum([
+  "auto",
+  "automotive",
+  "kitchen",
+  "pets",
+  "home_organization",
+  "beauty",
+  "wellness",
+  "fitness",
+  "baby",
+  "tech",
+  "tools",
+  "garden",
+  "cleaning"
+]);
 
 // src/errors.ts
 var McpErrorCode = {
@@ -6895,6 +7129,7 @@ var McpErrorCode = {
   TASK_NOT_READY: "TASK_NOT_READY",
   CREATIVE_VARIANT_FAILED: "CREATIVE_VARIANT_FAILED",
   CREATIVE_VARIANT_DISPATCH_FAILED: "CREATIVE_VARIANT_DISPATCH_FAILED",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT",
   // Connection presence
   NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
   NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
@@ -7016,12 +7251,13 @@ var CODE_MESSAGES = {
   TASK_NOT_READY: "The task is not ready for this action yet. Wait for it to finish and retry.",
   CREATIVE_VARIANT_FAILED: "The previous creative variant attempt failed. Ask for confirmation before starting a new paid attempt with a new clientRequestId.",
   CREATIVE_VARIANT_DISPATCH_FAILED: "The creative variant could not be queued. Retry as a new paid attempt with a new clientRequestId.",
+  PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT: "A product research run with the same country and category is already running. Check it with `list_product_research_runs` instead of starting a new paid run.",
   // API key
   INVALID_API_KEY: "Invalid API key. Check your PM_API_KEY in the MCP client configuration.",
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
-  INSUFFICIENT_CREDITS: "Insufficient credits to create this variant. Check your balance and retry after adding credits.",
+  INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
   UPSTREAM_UNAVAILABLE: "The Product Maker service did not respond. Try again shortly.",
@@ -7034,6 +7270,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INVALID_INPUT,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   McpErrorCode.INVALID_API_KEY,
   McpErrorCode.REVOKED_API_KEY,
   McpErrorCode.IMAGE_PATH_NOT_FOUND,
@@ -7096,6 +7333,7 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.CREATIVE_VARIANT_DISPATCH_FAILED,
+  McpErrorCode.PRODUCT_RESEARCH_IDEMPOTENCY_CONFLICT,
   // Shopify
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
@@ -7189,6 +7427,11 @@ function resolveMessage(code, backendMessage) {
   return `The service returned an error (code: ${code}). Try again shortly or contact support if it persists.`;
 }
 __name(resolveMessage, "resolveMessage");
+function invalidInputFromZod(error) {
+  const detail = error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; ");
+  return mcp(McpErrorCode.INVALID_INPUT, detail || resolveMessage(McpErrorCode.INVALID_INPUT, void 0));
+}
+__name(invalidInputFromZod, "invalidInputFromZod");
 function translateError(err) {
   if (err instanceof McpError) {
     return err;
@@ -7204,9 +7447,11 @@ function translateError(err) {
     const body = isRecord(err.body) ? err.body : {};
     if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
       const code = body.code;
-      return mcp(code, resolveMessage(code, body.message), body.helpUrl ? {
-        helpUrl: body.helpUrl
-      } : {});
+      const extra = {};
+      if (body.helpUrl !== void 0) extra.helpUrl = body.helpUrl;
+      if (typeof body.requiredCredits === "number") extra.requiredCredits = body.requiredCredits;
+      if (typeof body.availableCredits === "number") extra.availableCredits = body.availableCredits;
+      return mcp(code, resolveMessage(code, body.message), extra);
     }
     if (err.status === 401) {
       return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
@@ -7451,66 +7696,66 @@ function renderOutputsMarkdown(outputs) {
 __name(renderOutputsMarkdown, "renderOutputsMarkdown");
 
 // src/tools/tasks.ts
-var CreateProductTaskInput = z38.object({
+var CreateProductTaskInput = z39.object({
   images: ImagesInput,
-  productUrl: z38.string().url().optional().describe("Opcional. URL de la p\xE1gina del producto (Shopify, AliExpress, Amazon, etc.) para enriquecer el contexto. Si se omite, la IA infiere todo desde la imagen."),
+  productUrl: z39.string().url().optional().describe("Opcional. URL de la p\xE1gina del producto (Shopify, AliExpress, Amazon, etc.) para enriquecer el contexto. Si se omite, la IA infiere todo desde la imagen."),
   language: Lang.describe('C\xF3digo de idioma para el contenido generado. Ejemplos: "es", "en", "pt". REQUERIDO \u2014 si el usuario no lo especific\xF3, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat ni asumas "es" por default.'),
   country: Country.describe('C\xF3digo ISO del pa\xEDs objetivo. Ejemplos: "CO", "MX", "US", "AR". Define moneda, m\xE9todos de pago locales y tono. REQUERIDO \u2014 si el usuario no lo especific\xF3, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat.'),
-  price: z38.string().min(1).max(120).optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
-  compareAtPrice: z38.string().min(1).max(120).optional().describe('Opcional. Precio anterior para comunicar un descuento real en landing e im\xE1genes. Ej. "$129.000" cuando price="$89.900".'),
-  offer: z38.string().min(1).max(240).optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
-  paymentMethods: z38.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago que puede mostrar la landing. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
-  productContext: z38.string().max(3e3).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
-  productLabel: z38.string().trim().max(80).optional().describe('Opcional. Qu\xE9 es el producto, en pocas palabras (ej. "quita pelusas para ropa"). Es AUTORITATIVO: si lo env\xEDas, la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA detecta el producto desde la imagen.'),
+  price: z39.string().min(1).max(120).optional().describe('Precio que se mostrar\xE1 en la landing y video. Formato libre \u2014 ej. "$89.900", "USD 29.99", "MXN 599". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si te dice "t\xFA elige", om\xEDtelo y el backend sugiere uno.'),
+  compareAtPrice: z39.string().min(1).max(120).optional().describe('Opcional. Precio anterior para comunicar un descuento real en landing e im\xE1genes. Ej. "$129.000" cuando price="$89.900".'),
+  offer: z39.string().min(1).max(240).optional().describe('Oferta o promoci\xF3n a destacar. Ej. "2x1", "Env\xEDo gratis hoy", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si te dice "t\xFA elige", om\xEDtelo.'),
+  paymentMethods: z39.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago que puede mostrar la landing. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
+  productContext: z39.string().max(3e3).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
+  productLabel: z39.string().trim().max(80).optional().describe('Opcional. Qu\xE9 es el producto, en pocas palabras (ej. "quita pelusas para ropa"). Es AUTORITATIVO: si lo env\xEDas, la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA detecta el producto desde la imagen.'),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan a 15s y 30s; 30s usa el ritmo Multiescena. Opciones: "auto", "ugc_dynamic" (UGC testimonial), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n), "ugc_demo_review" (demo en uso), "problem_solution" (problema\u2192producto\u2192CTA), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla), "product_showcase" (solo producto, sin actor), "wearable_showcase" (ropa/accesorios puestos). Si el usuario pide algo fuera de esta lista (ej. "estilo anime"), p\xEDdele una opci\xF3n v\xE1lida.'),
-  durationSeconds: z38.union([
-    z38.literal(15),
-    z38.literal(30)
+  durationSeconds: z39.union([
+    z39.literal(15),
+    z39.literal(30)
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo del video: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
-  pauseForAngleReview: z38.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. \xDAsalo si quiere decidir 15/30s cuando aparezca un winner. Default false."),
+  pauseForAngleReview: z39.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. \xDAsalo si quiere decidir 15/30s cuando aparezca un winner. Default false."),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista" para 15s; al pedir durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez (~el doble de precio). Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
-  multiAngleVideos: z38.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
+  multiAngleVideos: z39.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
   angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_unboxing_chaos", "problem_product_cta", "product_showcase", "wearable_showcase", "cinematic", "animated_problem_pixar", "sassy_product_pixar". angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para varios \xE1ngulos.'),
-  outputs: z38.array(z38.enum([
+  outputs: z39.array(z39.enum([
     "landing",
     "video",
     "image"
   ])).min(2).max(3).optional().describe('Opcional. Qu\xE9 outputs generar. Default: todos ["landing","video","image"]. Para 2 outputs: ["landing","image"] (sin video), ["video","image"] (sin landing), ["landing","video"] (sin imagen). Para 1 solo output, usa generate_landing / generate_video_creative / generate_image_creatives.'),
-  competitorScanEnabled: z38.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
-  brandId: z38.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
-  creativeDirection: z38.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo) que aplica a los outputs de IMAGEN y LANDING (no al video \u2014 el estilo/ambiente del video se dirige con scriptNotes). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Ej. "amarillo y azul, minimalista". M\xE1x 500 caracteres.'),
+  competitorScanEnabled: z39.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
+  brandId: z39.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
+  creativeDirection: z39.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo) que aplica a los outputs de IMAGEN y LANDING (no al video \u2014 el estilo/ambiente del video se dirige con scriptNotes). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Ej. "amarillo y azul, minimalista". M\xE1x 500 caracteres.'),
   landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social), "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".'),
   landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 }).strict();
-var GetTaskStatusInput = z38.object({
-  taskId: z38.string().min(1),
-  waitSeconds: z38.number().int().min(0).max(120).optional()
-});
-var ListTasksInput = z38.object({
-  limit: z38.number().int().min(1).max(50).optional(),
-  offset: z38.number().int().min(0).optional(),
-  search: z38.string().optional()
-});
-var EditTaskDraftInput = z38.object({
-  taskId: z38.string().min(1),
-  angleIndex: z38.number().int().min(0),
-  angle: z38.object({
-    angle: z38.string().min(1).max(480),
-    buyerPersona: z38.string().min(1).max(360),
-    actor: z38.string().min(1).max(360).optional(),
-    gender: z38.enum([
+var GetTaskStatusInput = z39.object({
+  taskId: z39.string().min(1),
+  waitSeconds: z39.number().int().min(0).max(120).optional()
+});
+var ListTasksInput = z39.object({
+  limit: z39.number().int().min(1).max(50).optional(),
+  offset: z39.number().int().min(0).optional(),
+  search: z39.string().optional()
+});
+var EditTaskDraftInput = z39.object({
+  taskId: z39.string().min(1),
+  angleIndex: z39.number().int().min(0),
+  angle: z39.object({
+    angle: z39.string().min(1).max(480),
+    buyerPersona: z39.string().min(1).max(360),
+    actor: z39.string().min(1).max(360).optional(),
+    gender: z39.enum([
       "female",
       "male"
     ]).optional(),
-    scriptNotes: z38.string().max(2e3).optional()
+    scriptNotes: z39.string().max(2e3).optional()
   })
 });
-var PendingActionPayload = z38.discriminatedUnion("kind", [
-  z38.object({
-    kind: z38.literal("product_reference_confirmation"),
+var PendingActionPayload = z39.discriminatedUnion("kind", [
+  z39.object({
+    kind: z39.literal("product_reference_confirmation"),
     userChoice: ProductReferenceUserChoiceEnum,
-    confirmedProductNames: z38.array(z38.string().min(1).max(120)).min(2).max(8).optional(),
+    confirmedProductNames: z39.array(z39.string().min(1).max(120)).min(2).max(8).optional(),
     // SCOPED multi-scene opt-in — the ONLY way STANDARD ("Multiescena") is
     // reachable via MCP. Valid ONLY together with userChoice='variants' (same
     // product in several colors): renders one shot per color and stitches them,
@@ -7521,62 +7766,62 @@ var PendingActionPayload = z38.discriminatedUnion("kind", [
     // safe because multi-scene IS the intended render for a color variant set,
     // not a blind quality upsell. Maps to `videoTier: 'standard'` on the
     // confirm call; the backend re-gates it (variants + variant_set only).
-    useMultiSceneShowcase: z38.boolean().optional().describe('Opcional (SOLO con userChoice="variants"). true = render Multiescena: una toma por color, mostrando todas las variantes, hasta 30s. Se factura POR ESCENA (m\xE1s caro que el render normal de una sola toma) \u2014 AV\xCDSALE del mayor costo al usuario antes de activarlo. Omitir = render est\xE1ndar de una sola toma. Se ignora si userChoice no es "variants".')
+    useMultiSceneShowcase: z39.boolean().optional().describe('Opcional (SOLO con userChoice="variants"). true = render Multiescena: una toma por color, mostrando todas las variantes, hasta 30s. Se factura POR ESCENA (m\xE1s caro que el render normal de una sola toma) \u2014 AV\xCDSALE del mayor costo al usuario antes de activarlo. Omitir = render est\xE1ndar de una sola toma. Se ignora si userChoice no es "variants".')
   }),
-  z38.object({
-    kind: z38.literal("angle_review_approval"),
+  z39.object({
+    kind: z39.literal("angle_review_approval"),
     // All edits are optional — empty action body just approves the
     // backend-generated draft as-is. Field shapes mirror the angle-review
     // request contracts in @packages/types/wizard.ts; the handler routes to
     // the dedicated video/image/autopilot endpoint based on StatusResponse.kind.
-    customAngle: z38.string().min(1).max(480).optional(),
+    customAngle: z39.string().min(1).max(480).optional(),
     // Keep the shared MCP action within the strictest downstream contract:
     // autopilot/image resume endpoints cap these fields at 1500 characters.
-    painPoints: z38.string().max(1500).optional(),
-    benefits: z38.string().max(1500).optional(),
-    features: z38.array(z38.string().min(1).max(300)).max(10).optional(),
-    gapDurationSeconds: z38.union([
-      z38.literal(15),
-      z38.literal(30)
+    painPoints: z39.string().max(1500).optional(),
+    benefits: z39.string().max(1500).optional(),
+    features: z39.array(z39.string().min(1).max(300)).max(10).optional(),
+    gapDurationSeconds: z39.union([
+      z39.literal(15),
+      z39.literal(30)
     ]).optional().describe("Opcional. Solo para aceptar expl\xEDcitamente la recomendaci\xF3n gapDurationChoice del status. 30 env\xEDa el override double_30s para el \xE1ngulo recomendado; 15 u omitido conserva la duraci\xF3n cotizada.")
   })
 ]);
-var ResolvePendingActionInput = z38.object({
-  taskId: z38.string().min(1),
+var ResolvePendingActionInput = z39.object({
+  taskId: z39.string().min(1),
   action: PendingActionPayload
 }).strict();
 function resolveVariantConfirmVideoTier(action) {
   return action.useMultiSceneShowcase && action.userChoice === "variants" ? "standard" : void 0;
 }
 __name(resolveVariantConfirmVideoTier, "resolveVariantConfirmVideoTier");
-var StatusForResolveSchema = z38.object({
+var StatusForResolveSchema = z39.object({
   // Metadata used to select the backend resume contract. Older API responses
   // may omit these fields, so the resolver keeps the generic fallback.
-  kind: z38.enum([
+  kind: z39.enum([
     "autopilot",
     "video",
     "image",
     "landing",
     "mix"
   ]).optional(),
-  selectedOutputs: z38.array(z38.enum([
+  selectedOutputs: z39.array(z39.enum([
     "landing",
     "video",
     "image"
   ])).optional(),
-  videoAngleCount: z38.number().int().min(1).max(3).optional(),
-  ugcFormat: z38.enum([
+  videoAngleCount: z39.number().int().min(1).max(3).optional(),
+  ugcFormat: z39.enum([
     "single_8s",
     "single_15s",
     "double_30s"
   ]).optional(),
-  videoStyle: z38.enum([
+  videoStyle: z39.enum([
     "ugc",
     "cartoon_3d",
     "product_only",
     "ai_dynamic"
   ]).optional(),
-  videoModel: z38.enum([
+  videoModel: z39.enum([
     "veo",
     "wan",
     "bytedance",
@@ -7584,26 +7829,26 @@ var StatusForResolveSchema = z38.object({
     "grok",
     "kling"
   ]).optional(),
-  videoTier: z38.enum([
+  videoTier: z39.enum([
     "legacy",
     "standard",
     "pro",
     "single_call"
   ]).optional(),
-  videoResolution: z38.enum([
+  videoResolution: z39.enum([
     "480p",
     "720p"
   ]).optional(),
   narrativeStyle: NarrativeStyleEnum.optional(),
-  pendingUserAction: z38.object({
-    kind: z38.string(),
-    candidateGrouping: z38.string().optional(),
-    selectedImageUrls: z38.array(z38.string()).optional(),
-    proposedProductNames: z38.array(z38.string()).optional(),
-    customAngleDraft: z38.string().optional(),
-    painPointsDraft: z38.string().optional(),
-    benefitsDraft: z38.string().optional(),
-    featuresDraft: z38.array(z38.string()).optional(),
+  pendingUserAction: z39.object({
+    kind: z39.string(),
+    candidateGrouping: z39.string().optional(),
+    selectedImageUrls: z39.array(z39.string()).optional(),
+    proposedProductNames: z39.array(z39.string()).optional(),
+    customAngleDraft: z39.string().optional(),
+    painPointsDraft: z39.string().optional(),
+    benefitsDraft: z39.string().optional(),
+    featuresDraft: z39.array(z39.string()).optional(),
     // Recommendation consumed only when the caller explicitly sends
     // gapDurationSeconds: 30 in the angle approval action.
     gapDurationChoice: GapDurationChoiceMirror.optional()
@@ -7925,54 +8170,54 @@ __name(registerTaskTools, "registerTaskTools");
 
 // src/tools/creatives.ts
 import { randomUUID } from "crypto";
-import { z as z39 } from "zod";
+import { z as z40 } from "zod";
 var CreativeRefs = {
   images: ImagesInput,
   language: Lang.describe('Idioma del contenido. Ej. "es", "en", "pt". REQUERIDO \u2014 si el usuario no lo dijo, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat ni asumas un default.'),
   country: Country.describe('Pa\xEDs objetivo ISO. Ej. "CO", "MX", "US", "AR". Define moneda, m\xE9todos de pago y tono. REQUERIDO \u2014 si el usuario no lo dijo, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat ni asumas un default.'),
-  price: z39.string().min(1).max(120).optional().describe('Precio en formato libre \u2014 ej. "$89.900", "USD 29.99". Opcional pero MUY IMPACTANTE para conversi\xF3n: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si el usuario te dice "t\xFA elige", omite el campo y la IA del backend sugiere uno.'),
-  offer: z39.string().min(1).max(240).optional().describe('Oferta a destacar \u2014 ej. "2x1", "Env\xEDo gratis", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si el usuario te dice "t\xFA elige", omite el campo.'),
-  compareAtPrice: z39.string().min(1).max(120).optional().describe('Opcional. Precio anterior o de referencia para mostrar descuento. Ej. "$129.000" cuando price="$89.900".'),
-  paymentMethods: z39.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago a mostrar. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
-  productContext: z39.string().max(3e3).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
-  productLabel: z39.string().trim().max(80).optional().describe('Opcional. Nombre o tipo del producto en pocas palabras (ej. "collar de oro", "quita pelusas para ropa"). Es AUTORITATIVO: la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA lo detecta desde la imagen. NO salta la extracci\xF3n.'),
-  buyerPersona: z39.string().optional().describe('Opcional. Descripci\xF3n del comprador objetivo. Ej. "Mujeres 35-50, profesionales urbanas". Si se omite, la IA infiere desde el \xE1ngulo y producto.'),
-  isCombo: z39.boolean().optional().describe("Opcional. Si true, el creativo presenta el producto como combo/pack. Default false."),
-  competitorScanEnabled: z39.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
-  brandId: z39.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo."),
-  creativeDirection: z39.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.')
+  price: z40.string().min(1).max(120).optional().describe('Precio en formato libre \u2014 ej. "$89.900", "USD 29.99". Opcional pero MUY IMPACTANTE para conversi\xF3n: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar. Si el usuario te dice "t\xFA elige", omite el campo y la IA del backend sugiere uno.'),
+  offer: z40.string().min(1).max(240).optional().describe('Oferta a destacar \u2014 ej. "2x1", "Env\xEDo gratis", "50% OFF". Opcional pero MUY IMPACTANTE: si el usuario no lo mencion\xF3, PREG\xDANTALE antes de invocar (es v\xE1lido que diga "sin oferta"). Si el usuario te dice "t\xFA elige", omite el campo.'),
+  compareAtPrice: z40.string().min(1).max(120).optional().describe('Opcional. Precio anterior o de referencia para mostrar descuento. Ej. "$129.000" cuando price="$89.900".'),
+  paymentMethods: z40.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago a mostrar. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
+  productContext: z40.string().max(3e3).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
+  productLabel: z40.string().trim().max(80).optional().describe('Opcional. Nombre o tipo del producto en pocas palabras (ej. "collar de oro", "quita pelusas para ropa"). Es AUTORITATIVO: la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA lo detecta desde la imagen. NO salta la extracci\xF3n.'),
+  buyerPersona: z40.string().optional().describe('Opcional. Descripci\xF3n del comprador objetivo. Ej. "Mujeres 35-50, profesionales urbanas". Si se omite, la IA infiere desde el \xE1ngulo y producto.'),
+  isCombo: z40.boolean().optional().describe("Opcional. Si true, el creativo presenta el producto como combo/pack. Default false."),
+  competitorScanEnabled: z40.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
+  brandId: z40.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo."),
+  creativeDirection: z40.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.')
 };
-var VideoInput = z39.object({
+var VideoInput = z40.object({
   images: CreativeRefs.images,
-  title: z39.string().min(1).describe('T\xEDtulo corto del producto. Aparece en la primera vista del video. Ej. "Crema Anti-Edad Premium".'),
-  primaryAngle: z39.string().min(1).describe('\xC1ngulo de venta principal (frase del beneficio). Ej. "Reduce arrugas en 14 d\xEDas" o "Para quienes odian las cremas grasosas".'),
+  title: z40.string().min(1).describe('T\xEDtulo corto del producto. Aparece en la primera vista del video. Ej. "Crema Anti-Edad Premium".'),
+  primaryAngle: z40.string().min(1).describe('\xC1ngulo de venta principal (frase del beneficio). Ej. "Reduce arrugas en 14 d\xEDas" o "Para quienes odian las cremas grasosas".'),
   language: CreativeRefs.language,
   country: CreativeRefs.country,
-  aspectRatio: z39.enum([
+  aspectRatio: z40.enum([
     "9:16",
     "16:9",
     "Auto"
   ]).describe('Relaci\xF3n de aspecto. "9:16" = vertical (TikTok/Reels \u2014 default recomendado para ads). "16:9" = horizontal (YouTube). "Auto" = decide la IA.'),
-  durationSeconds: z39.union([
-    z39.literal(15),
-    z39.literal(30)
+  durationSeconds: z40.union([
+    z40.literal(15),
+    z40.literal(30)
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
   videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla (en la web es el \xFAnico dropdown). Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan tanto a 15s como a 30s; el formato de 30s conserva el ritmo multi-escena. Opciones: "auto", "ugc_dynamic" (UGC cl\xE1sico testimonial multi-hook), "ugc_unboxing_chaos" (unboxing agresivo), "ugc_curiosity_reveal" (hook con producto oculto), "ugc_listicle_3" (3 razones numeradas), "ugc_skeptic_confession" (esc\xE9ptico\u2192conversi\xF3n), "ugc_demo_review" (demo en uso a lo largo de d\xEDas), "problem_solution" (problema\u2192producto\u2192CTA), "cinematic" (historia visual premium), "pixar_problem" (problema animado 3D estilo Pixar), "pixar_sassy" (producto que habla con personalidad), "product_showcase" (sin actor, solo producto), "wearable_showcase" (ropa/accesorios puestos).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista"; para durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "720p" = m\xE1xima nitidez (RECOMENDADO, default si se omite); "480p" = render m\xE1s econ\xF3mico. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 720p).'),
-  features: z39.array(z39.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
+  features: z40.array(z40.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
   price: CreativeRefs.price,
   offer: CreativeRefs.offer,
   productContext: CreativeRefs.productContext,
   productLabel: CreativeRefs.productLabel,
-  cta: z39.string().optional().describe('Opcional. Call-to-action final del video. Ej. "Compra ahora", "Pide el tuyo hoy", "Link en bio". Si se omite, la IA escribe uno.'),
-  scriptNotes: z39.string().optional().describe('Opcional. Notas/restricciones para el guion (la IA las usa al redactar). Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico", "Mencionar 2x1". NO es el guion literal \u2014 para editar el guion palabra-por-palabra, pasa `pauseForVideoScriptReview: true` y usa get_video_script / approve_video_script tras la pausa.'),
-  pauseForVideoScriptReview: z39.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false."),
-  pauseForAngleReview: z39.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. Default false."),
+  cta: z40.string().optional().describe('Opcional. Call-to-action final del video. Ej. "Compra ahora", "Pide el tuyo hoy", "Link en bio". Si se omite, la IA escribe uno.'),
+  scriptNotes: z40.string().optional().describe('Opcional. Notas/restricciones para el guion (la IA las usa al redactar). Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico", "Mencionar 2x1". NO es el guion literal \u2014 para editar el guion palabra-por-palabra, pasa `pauseForVideoScriptReview: true` y usa get_video_script / approve_video_script tras la pausa.'),
+  pauseForVideoScriptReview: z40.boolean().optional().describe("Opcional. Si true, la tarea pausa despu\xE9s de generar el guion y antes de renderizar. \xDAsalo cuando el usuario quiera editar el guion antes de gastar cr\xE9ditos en el video. Tras la pausa: get_video_script para leerlo, approve_video_script para aprobar (con o sin ediciones). Default false."),
+  pauseForAngleReview: z40.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo para que el usuario lo confirme o edite antes del render. Default false."),
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId
 }).strict();
-var FreeVideoQualityEnum = z39.enum([
+var FreeVideoQualityEnum = z40.enum([
   "economical",
   "high_detail"
 ]);
@@ -7994,38 +8239,38 @@ var FREE_VIDEO_DURATIONS_BY_QUALITY = {
     15
   ]
 };
-var FreeVideoInput = z39.object({
+var FreeVideoInput = z40.object({
   images: ImagesInput.optional().describe("Opcional. 1-5 fotos del producto. Om\xEDtelo para generar desde texto puro."),
-  rawPrompt: z39.string().trim().min(1).max(2e3).describe("Prompt o guion exacto del video. Si activas subt\xEDtulos, este mismo texto se usa como guion de subt\xEDtulos."),
+  rawPrompt: z40.string().trim().min(1).max(2e3).describe("Prompt o guion exacto del video. Si activas subt\xEDtulos, este mismo texto se usa como guion de subt\xEDtulos."),
   quality: FreeVideoQualityEnum.describe('Calidad del video: "economical" = Econ\xF3mico o "high_detail" = Alto detalle.'),
-  durationSeconds: z39.number().int().min(1).max(15).describe("Duraci\xF3n exacta. Econ\xF3mico permite 6, 8, 10 o 15s; Alto detalle permite 4, 8, 12 o 15s."),
+  durationSeconds: z40.number().int().min(1).max(15).describe("Duraci\xF3n exacta. Econ\xF3mico permite 6, 8, 10 o 15s; Alto detalle permite 4, 8, 12 o 15s."),
   videoResolution: VideoResolutionEnum.describe("Resoluci\xF3n del video: 480p o 720p."),
-  generateAiMusic: z39.boolean().default(false).describe("Opcional. Agrega m\xFAsica instrumental IA debajo del audio nativo. Default false."),
-  addSubtitles: z39.boolean().default(false).describe("Opcional. Quema subt\xEDtulos usando el rawPrompt exacto. Default false."),
-  idempotencyKey: z39.string().uuid().optional().describe("Opcional. UUID para reintentar exactamente esta misma solicitud sin crear ni cobrar otro video. Reutiliza el mismo valor si el cliente no recibi\xF3 la respuesta.")
+  generateAiMusic: z40.boolean().default(false).describe("Opcional. Agrega m\xFAsica instrumental IA debajo del audio nativo. Default false."),
+  addSubtitles: z40.boolean().default(false).describe("Opcional. Quema subt\xEDtulos usando el rawPrompt exacto. Default false."),
+  idempotencyKey: z40.string().uuid().optional().describe("Opcional. UUID para reintentar exactamente esta misma solicitud sin crear ni cobrar otro video. Reutiliza el mismo valor si el cliente no recibi\xF3 la respuesta.")
 }).strict();
 var imageStyleList = ImageCreativeStyleEnum.options.join(" | ");
 var archetypeList = ImageCreativeArchetypeEnum.options.join(" | ");
 var visualTreatmentList = ImageCreativeVisualTreatmentEnum.options.join(" | ");
 var aspectRatioList = ImageCreativeAspectRatioEnum.options.join(" | ");
-var ImageInput = z39.object({
+var ImageInput = z40.object({
   images: CreativeRefs.images,
-  productTitle: z39.string().min(1).describe('Nombre del producto. Ej. "Crema Anti-Edad Premium".'),
-  primaryAngle: z39.string().min(1).describe('\xC1ngulo de venta principal. Ej. "Reduce arrugas en 14 d\xEDas".'),
+  productTitle: z40.string().min(1).describe('Nombre del producto. Ej. "Crema Anti-Edad Premium".'),
+  primaryAngle: z40.string().min(1).describe('\xC1ngulo de venta principal. Ej. "Reduce arrugas en 14 d\xEDas".'),
   buyerPersona: CreativeRefs.buyerPersona,
   language: CreativeRefs.language,
   country: CreativeRefs.country,
-  nVariants: z39.number().int().min(1).max(6).optional().describe("Opcional. N\xFAmero de variantes a generar (1-6). Default 3."),
-  imageModel: z39.string().optional().describe('Opcional. Modelo de imagen. Ej. "gpt-image-2", "nano-banana-2". Om\xEDtelo para usar el default optimizado por costo/calidad.'),
+  nVariants: z40.number().int().min(1).max(6).optional().describe("Opcional. N\xFAmero de variantes a generar (1-6). Default 3."),
+  imageModel: z40.string().optional().describe('Opcional. Modelo de imagen. Ej. "gpt-image-2", "nano-banana-2". Om\xEDtelo para usar el default optimizado por costo/calidad.'),
   imageStyle: ImageCreativeStyleEnum.optional().describe(`Opcional. Estilo del shot del producto. Valores: ${imageStyleList}. Si se omite, la IA escoge seg\xFAn el archetype.`),
   creativeArchetype: ImageCreativeArchetypeEnum.optional().describe(`Opcional. Arquetipo CRO de la composici\xF3n. Valores: ${archetypeList}. Si se omite, la IA escoge seg\xFAn \xE1ngulo+oferta (ej. "offer_value_prop" cuando hay descuento, "social_proof_trust" cuando el \xE1ngulo es testimonial).`),
   visualTreatment: ImageCreativeVisualTreatmentEnum.optional().describe(`Opcional. Tratamiento gr\xE1fico. Valores: ${visualTreatmentList} ("performance_product_ad" = dealer-style alto CTR para Meta/TikTok ads; "premium_dtc_carousel" = fotograf\xEDa limpia estilo Allbirds/Glossier). Si se omite, la IA escoge.`),
-  styleMix: z39.boolean().optional().describe("Opcional. Si true, las N variantes mezclan distintos imageStyle para A/B test. Si false/omitido, todas comparten estilo. Default false."),
+  styleMix: z40.boolean().optional().describe("Opcional. Si true, las N variantes mezclan distintos imageStyle para A/B test. Si false/omitido, todas comparten estilo. Default false."),
   aspectRatio: ImageCreativeAspectRatioEnum.optional().describe(`Opcional. Relaci\xF3n de aspecto. Valores: ${aspectRatioList}. Default "4:5" (vertical Instagram feed).`),
-  generateAdCopy: z39.boolean().optional().describe("Opcional. Si true, tambi\xE9n genera headline/body/CTA para el ad. Default false."),
-  pauseForAngleReview: z39.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo y antes de las im\xE1genes para que el usuario edite v\xEDa edit_task_draft. Default false."),
-  features: z39.array(z39.string()).optional().describe('Opcional. Features/beneficios a destacar visualmente. Ej. ["resistente al agua", "ultra liviano"].'),
-  brandColors: z39.array(z39.string()).optional().describe('Opcional. Paleta de marca en hex. Ej. ["#FF6B35", "#004E89"]. Si se omite, la IA elige seg\xFAn el producto.'),
+  generateAdCopy: z40.boolean().optional().describe("Opcional. Si true, tambi\xE9n genera headline/body/CTA para el ad. Default false."),
+  pauseForAngleReview: z40.boolean().optional().describe("Opcional. Si true, pausa despu\xE9s de generar el \xE1ngulo y antes de las im\xE1genes para que el usuario edite v\xEDa edit_task_draft. Default false."),
+  features: z40.array(z40.string()).optional().describe('Opcional. Features/beneficios a destacar visualmente. Ej. ["resistente al agua", "ultra liviano"].'),
+  brandColors: z40.array(z40.string()).optional().describe('Opcional. Paleta de marca en hex. Ej. ["#FF6B35", "#004E89"]. Si se omite, la IA elige seg\xFAn el producto.'),
   price: CreativeRefs.price,
   compareAtPrice: CreativeRefs.compareAtPrice,
   offer: CreativeRefs.offer,
@@ -8036,11 +8281,11 @@ var ImageInput = z39.object({
   brandId: CreativeRefs.brandId,
   creativeDirection: CreativeRefs.creativeDirection
 });
-var LandingInput = z39.object({
+var LandingInput = z40.object({
   images: CreativeRefs.images,
   language: CreativeRefs.language,
   country: CreativeRefs.country,
-  salesAngle: z39.string().optional().describe('Opcional. \xC1ngulo de venta principal. Ej. "Reduce arrugas en 14 d\xEDas". Si se omite, la IA lo deduce de la imagen.'),
+  salesAngle: z40.string().optional().describe('Opcional. \xC1ngulo de venta principal. Ej. "Reduce arrugas en 14 d\xEDas". Si se omite, la IA lo deduce de la imagen.'),
   buyerPersona: CreativeRefs.buyerPersona,
   price: CreativeRefs.price,
   compareAtPrice: CreativeRefs.compareAtPrice,
@@ -8138,8 +8383,8 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
 __name(registerCreativeTools, "registerCreativeTools");
 
 // src/tools/creative-variants.ts
-import { z as z40 } from "zod";
-var LandingSectionKeyEnum = z40.enum([
+import { z as z41 } from "zod";
+var LandingSectionKeyEnum = z41.enum([
   "problem_hook",
   "problem_cost",
   "solution_mechanism",
@@ -8179,24 +8424,24 @@ var LandingSectionKeyEnum = z40.enum([
   "lifestyle_fit",
   "join_lifestyle"
 ]);
-var CreativeVariantKindEnum = z40.enum([
+var CreativeVariantKindEnum = z41.enum([
   "video",
   "image",
   "landing"
 ]);
-var EstimateCreativeVariantInputBase = z40.object({
-  sourceTaskId: z40.string().uuid().describe("ID de la tarea original completada."),
+var EstimateCreativeVariantInputBase = z41.object({
+  sourceTaskId: z41.string().uuid().describe("ID de la tarea original completada."),
   kind: CreativeVariantKindEnum,
   videoPreset: TaskCreativeVariantVideoPresetEnum.optional().describe("Opcional para video. Solo cambia el preset p\xFAblico; el servidor conserva el modelo/tier del task origen."),
   videoResolution: VideoResolutionEnum.optional().describe("Opcional para video. Resoluci\xF3n del nuevo render."),
-  nVariants: z40.number().int().min(1).max(3).optional().describe("Opcional para imagen. N\xFAmero de im\xE1genes adicionales (1-3)."),
+  nVariants: z41.number().int().min(1).max(3).optional().describe("Opcional para imagen. N\xFAmero de im\xE1genes adicionales (1-3)."),
   sectionKey: LandingSectionKeyEnum.optional().describe("Opcional para landing. Si ya conoces la secci\xF3n, evita cotizar la clasificaci\xF3n con IA."),
-  instructions: z40.string().trim().min(1).max(2e3).optional().describe("Opcional para landing. Si se env\xEDa sin sectionKey, el estimado suma la clasificaci\xF3n pagada con IA.")
+  instructions: z41.string().trim().min(1).max(2e3).optional().describe("Opcional para landing. Si se env\xEDa sin sectionKey, el estimado suma la clasificaci\xF3n pagada con IA.")
 }).strict();
 var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine((input, ctx) => {
   if (input.kind === "video" && input.nVariants !== void 0) {
     ctx.addIssue({
-      code: z40.ZodIssueCode.custom,
+      code: z41.ZodIssueCode.custom,
       path: [
         "nVariants"
       ],
@@ -8206,7 +8451,7 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
   if (input.kind !== "video") {
     if (input.videoPreset !== void 0) {
       ctx.addIssue({
-        code: z40.ZodIssueCode.custom,
+        code: z41.ZodIssueCode.custom,
         path: [
           "videoPreset"
         ],
@@ -8215,7 +8460,7 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
     }
     if (input.videoResolution !== void 0) {
       ctx.addIssue({
-        code: z40.ZodIssueCode.custom,
+        code: z41.ZodIssueCode.custom,
         path: [
           "videoResolution"
         ],
@@ -8225,7 +8470,7 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
   }
   if (input.kind !== "image" && input.nVariants !== void 0) {
     ctx.addIssue({
-      code: z40.ZodIssueCode.custom,
+      code: z41.ZodIssueCode.custom,
       path: [
         "nVariants"
       ],
@@ -8235,7 +8480,7 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
   if (input.kind !== "landing") {
     if (input.sectionKey !== void 0) {
       ctx.addIssue({
-        code: z40.ZodIssueCode.custom,
+        code: z41.ZodIssueCode.custom,
         path: [
           "sectionKey"
         ],
@@ -8244,7 +8489,7 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
     }
     if (input.instructions !== void 0) {
       ctx.addIssue({
-        code: z40.ZodIssueCode.custom,
+        code: z41.ZodIssueCode.custom,
         path: [
           "instructions"
         ],
@@ -8253,31 +8498,31 @@ var EstimateCreativeVariantInput = EstimateCreativeVariantInputBase.superRefine(
     }
   }
 });
-var CreateCreativeVariantInputBase = z40.object({
-  sourceTaskId: z40.string().uuid().describe("ID de la tarea original completada."),
+var CreateCreativeVariantInputBase = z41.object({
+  sourceTaskId: z41.string().uuid().describe("ID de la tarea original completada."),
   kind: CreativeVariantKindEnum,
-  confirm: z40.literal(true).describe("Confirmaci\xF3n expl\xEDcita del usuario despu\xE9s de mostrarle el estimado de cr\xE9ditos."),
-  clientRequestId: z40.string().uuid().describe("UUID estable y obligatorio para esta intenci\xF3n. Reutil\xEDzalo ante timeouts o transporte ambiguo. Si la API devuelve status=error, una nueva generaci\xF3n exige otra confirmaci\xF3n y un UUID nuevo."),
-  angle: z40.string().trim().min(1).max(500).optional().describe("\xC1ngulo nuevo para video o imagen."),
-  buyerPersona: z40.string().trim().min(1).max(360).optional().describe("Buyer persona coherente con el \xE1ngulo."),
-  scriptNotes: z40.string().trim().min(1).max(2e3).optional().describe("Direcci\xF3n breve del guion para una variante de video."),
-  creativeDirection: z40.string().trim().min(1).max(2e3).optional().describe("Direcci\xF3n creativa para una variante de imagen."),
+  confirm: z41.literal(true).describe("Confirmaci\xF3n expl\xEDcita del usuario despu\xE9s de mostrarle el estimado de cr\xE9ditos."),
+  clientRequestId: z41.string().uuid().describe("UUID estable y obligatorio para esta intenci\xF3n. Reutil\xEDzalo ante timeouts o transporte ambiguo. Si la API devuelve status=error, una nueva generaci\xF3n exige otra confirmaci\xF3n y un UUID nuevo."),
+  angle: z41.string().trim().min(1).max(500).optional().describe("\xC1ngulo nuevo para video o imagen."),
+  buyerPersona: z41.string().trim().min(1).max(360).optional().describe("Buyer persona coherente con el \xE1ngulo."),
+  scriptNotes: z41.string().trim().min(1).max(2e3).optional().describe("Direcci\xF3n breve del guion para una variante de video."),
+  creativeDirection: z41.string().trim().min(1).max(2e3).optional().describe("Direcci\xF3n creativa para una variante de imagen."),
   videoPreset: TaskCreativeVariantVideoPresetEnum.optional().describe("Opcional para video. Preset p\xFAblico; el servidor resuelve modelo/tier desde el task origen."),
   videoResolution: VideoResolutionEnum.optional().describe("Opcional para video."),
-  generateAiMusic: z40.boolean().optional().describe("Opcional para video."),
-  nVariants: z40.number().int().min(1).max(3).optional().describe("Opcional para imagen. N\xFAmero de im\xE1genes adicionales (1-3)."),
+  generateAiMusic: z41.boolean().optional().describe("Opcional para video."),
+  nVariants: z41.number().int().min(1).max(3).optional().describe("Opcional para imagen. N\xFAmero de im\xE1genes adicionales (1-3)."),
   imageStyle: ImageCreativeStyleEnum.optional().describe("Opcional para imagen."),
   creativeArchetype: ImageCreativeArchetypeEnum.optional().describe("Opcional para imagen."),
   visualTreatment: ImageCreativeVisualTreatmentEnum.optional().describe("Opcional para imagen."),
   aspectRatio: ImageCreativeAspectRatioEnum.optional().describe("Opcional para imagen."),
-  styleMix: z40.boolean().optional().describe("Opcional para imagen."),
+  styleMix: z41.boolean().optional().describe("Opcional para imagen."),
   sectionKey: LandingSectionKeyEnum.optional().describe("Opcional para landing. Si se omite, se clasifica con IA a partir de instructions."),
-  instructions: z40.string().trim().min(1).max(2e3).optional().describe("Solicitud libre para una nueva secci\xF3n de landing. La IA la clasifica si no env\xEDas sectionKey.")
+  instructions: z41.string().trim().min(1).max(2e3).optional().describe("Solicitud libre para una nueva secci\xF3n de landing. La IA la clasifica si no env\xEDas sectionKey.")
 }).strict();
 var CreateCreativeVariantInput = CreateCreativeVariantInputBase.superRefine((input, ctx) => {
   if ((input.kind === "video" || input.kind === "image") && !input.angle) {
     ctx.addIssue({
-      code: z40.ZodIssueCode.custom,
+      code: z41.ZodIssueCode.custom,
       path: [
         "angle"
       ],
@@ -8286,7 +8531,7 @@ var CreateCreativeVariantInput = CreateCreativeVariantInputBase.superRefine((inp
   }
   if (input.kind === "landing" && !input.sectionKey && !input.instructions) {
     ctx.addIssue({
-      code: z40.ZodIssueCode.custom,
+      code: z41.ZodIssueCode.custom,
       path: [
         "instructions"
       ],
@@ -8332,7 +8577,7 @@ var CreateCreativeVariantInput = CreateCreativeVariantInputBase.superRefine((inp
   for (const field of fieldsByKind[input.kind]) {
     if (input[field] !== void 0) {
       ctx.addIssue({
-        code: z40.ZodIssueCode.custom,
+        code: z41.ZodIssueCode.custom,
         path: [
           field
         ],
@@ -8449,27 +8694,27 @@ function registerCreativeVariantTools(server, api) {
 __name(registerCreativeVariantTools, "registerCreativeVariantTools");
 
 // src/tools/script-review.ts
-import { z as z41 } from "zod";
-var GetVideoScriptInput = z41.object({
-  taskId: z41.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
-  angleKey: z41.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
+import { z as z42 } from "zod";
+var GetVideoScriptInput = z42.object({
+  taskId: z42.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
+  angleKey: z42.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
 }).strict();
 var VIDEO_SCRIPT_APPROVAL_MAX_SCENES2 = 50;
 var VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS2 = 2e3;
-var ApproveSceneEdit = z41.object({
-  index: z41.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
-  dialogue: z41.string().min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS2).refine((v) => v.trim().length > 0, {
+var ApproveSceneEdit = z42.object({
+  index: z42.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
+  dialogue: z42.string().min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS2).refine((v) => v.trim().length > 0, {
     message: "dialogue no puede ser s\xF3lo espacios"
   }).describe("Di\xE1logo final de la escena. NO puede estar vac\xEDo ni ser s\xF3lo espacios. Puede ser el original sin cambios o la edici\xF3n del usuario.")
 }).strict();
-var ApproveVideoScriptInput = z41.object({
-  taskId: z41.string().min(1).describe("ID de la tarea."),
-  angleKey: z41.string().trim().min(1).max(120).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
-  scenes: z41.array(ApproveSceneEdit).min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_SCENES2).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber entre 1 y 50 entradas. Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
+var ApproveVideoScriptInput = z42.object({
+  taskId: z42.string().min(1).describe("ID de la tarea."),
+  angleKey: z42.string().trim().min(1).max(120).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
+  scenes: z42.array(ApproveSceneEdit).min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_SCENES2).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber entre 1 y 50 entradas. Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
 }).strict();
-var RegenerateVideoScriptInput = z41.object({
-  taskId: z41.string().min(1).describe("ID de la tarea."),
-  angleKey: z41.string().min(1).describe('Clave del \xE1ngulo a regenerar. Single-angle: pasa "angle_0". Multi-angle: el mismo que devuelve get_video_script. NO se puede omitir \u2014 el backend lo exige siempre.'),
+var RegenerateVideoScriptInput = z42.object({
+  taskId: z42.string().min(1).describe("ID de la tarea."),
+  angleKey: z42.string().min(1).describe('Clave del \xE1ngulo a regenerar. Single-angle: pasa "angle_0". Multi-angle: el mismo que devuelve get_video_script. NO se puede omitir \u2014 el backend lo exige siempre.'),
   narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion. 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) {
@@ -8509,9 +8754,9 @@ function registerScriptReviewTools(server, api) {
 __name(registerScriptReviewTools, "registerScriptReviewTools");
 
 // src/tools/connections.ts
-import { z as z42 } from "zod";
+import { z as z43 } 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.", z42.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.", z43.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/shopify/shops");
       return asText(r);
@@ -8519,10 +8764,10 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_shopify_products", 'Busca productos en una tienda Shopify conectada para elegir el target de una republicaci\xF3n. Usa el `id` devuelto junto con `publicationMode="existing"` en `publish_to_shopify`. Si `taskId` se proporciona, la respuesta tambi\xE9n indica el producto publicado actualmente para esa tarea y tienda. No modifica Shopify.', z42.object({
-    shopDomain: z42.string().min(3).max(120),
-    query: z42.string().trim().max(120).optional(),
-    taskId: z42.string().uuid().optional()
+  server.tool("list_shopify_products", 'Busca productos en una tienda Shopify conectada para elegir el target de una republicaci\xF3n. Usa el `id` devuelto junto con `publicationMode="existing"` en `publish_to_shopify`. Si `taskId` se proporciona, la respuesta tambi\xE9n indica el producto publicado actualmente para esa tarea y tienda. No modifica Shopify.', z43.object({
+    shopDomain: z43.string().min(3).max(120),
+    query: z43.string().trim().max(120).optional(),
+    taskId: z43.string().uuid().optional()
   }).shape, async ({ shopDomain, query, taskId }) => {
     try {
       const params = new URLSearchParams({
@@ -8536,7 +8781,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z42.object({}).shape, async () => {
+  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z43.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/facebook/ad-accounts");
       return asText(r);
@@ -8544,7 +8789,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.", z42.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.", z43.object({}).shape, async () => {
     try {
       const r = await api.getJson("/v1/tiktok/advertisers");
       return asText(r);
@@ -8556,115 +8801,128 @@ function registerConnectionTools(server, api) {
 __name(registerConnectionTools, "registerConnectionTools");
 
 // src/tools/publish.ts
-import { z as z43 } from "zod";
-var ShopifyInput = z43.object({
-  taskId: z43.string().min(1),
-  shopDomain: z43.string().min(1),
+import { z as z44 } from "zod";
+var ShopifyInput = z44.object({
+  taskId: z44.string().min(1),
+  shopDomain: z44.string().min(1),
   /** Override: number of landing images to include. Default = ALL images the
   *  task generated (the MCP fetches /v1/results first to count). Bounded
   *  generously here; the backend validates each index against
   *  landing.images.length and rejects out-of-range. */
-  numLandingImages: z43.number().int().min(1).max(20).optional(),
-  variantIndex: z43.number().int().min(0).optional(),
+  numLandingImages: z44.number().int().min(1).max(20).optional(),
+  variantIndex: z44.number().int().min(0).optional(),
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
   *  a single-option product page. Defaults to false. */
-  showVariantPicker: z43.boolean().optional(),
+  showVariantPicker: z44.boolean().optional(),
   /** Default `auto` updates the product previously published for this task and
   * shop. Use `existing` with targetProductId to choose another product, or
   * `new` only when the user explicitly wants a duplicate/new listing. */
-  publicationMode: z43.enum([
+  publicationMode: z44.enum([
     "auto",
     "existing",
     "new"
   ]).optional(),
   /** Shopify product GID, numeric id, or admin product URL. Required when
   * publicationMode is `existing`. */
-  targetProductId: z43.string().trim().min(1).max(300).optional()
+  targetProductId: z44.string().trim().min(1).max(300).optional()
 });
-var McpCampaignConfig = z43.object({
+var McpCampaignConfig = z44.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
   *  account the user's "60.000 al día" is `dailyBudgetUsd: 15`, not 60000. */
-  dailyBudgetUsd: z43.number().positive().optional(),
+  dailyBudgetUsd: z44.number().positive().optional(),
   /** ISO-3166-1 alpha-2 country codes. Meta accepts max 1 (single-country
   *  ad set). TikTok takes only the first entry. */
-  targetCountries: z43.array(z43.string().length(2)).max(1).optional(),
-  campaignName: z43.string().trim().min(1).max(100).optional()
-});
-var MetaInput = z43.object({
-  taskId: z43.string().min(1),
-  adAccountId: z43.string().min(1),
-  pixelId: z43.string().min(1).optional(),
-  landingUrl: z43.string().url().optional(),
+  targetCountries: z44.array(z44.string().length(2)).max(1).optional(),
+  campaignName: z44.string().trim().min(1).max(100).optional()
+});
+var McpAdAccountId = MetaAdAccountId.describe('Meta ad account id. Accepts "act_1234567890" or the bare numeric id "1234567890".');
+var MetaInput = z44.object({
+  taskId: z44.string().min(1),
+  adAccountId: McpAdAccountId,
+  pixelId: z44.string().min(1).optional(),
+  landingUrl: z44.string().url().optional(),
   /** Select which angles to publish by 0-based index. Omit to publish all
   *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
-  angleIndexes: z43.array(z43.number().int().nonnegative()).optional(),
+  angleIndexes: z44.array(z44.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional(),
   /** Override the ad's primary text (body copy). If omitted, ProductMaker
   *  uses the auto-generated copy attached to the task. Capped at 500 chars
   *  (Meta's primary-text limit). */
-  primaryText: z43.string().trim().min(1).max(500).optional(),
+  primaryText: z44.string().trim().min(1).max(500).optional(),
   /** Optional WhatsApp number. When set, the ad button opens a WhatsApp chat
   *  (wa.me) instead of a landing page. */
-  phoneNumber: z43.string().min(8).max(32).optional()
+  phoneNumber: z44.string().min(8).max(32).optional()
 });
-var GroupedTaskSource = z43.object({
-  type: z43.literal("task"),
-  taskId: z43.string().min(1),
-  angleIndex: z43.number().int().min(0).optional(),
-  videoVariant: z43.enum([
+var GroupedTaskSource = z44.object({
+  type: z44.literal("task"),
+  taskId: z44.string().min(1),
+  angleIndex: z44.number().int().min(0).optional(),
+  videoVariant: z44.enum([
     "with_subtitles",
     "without_subtitles"
   ]).optional(),
-  imageVariantIndex: z43.number().int().min(0).optional()
-});
-var GroupedMediaSource = z43.object({
-  type: z43.literal("media"),
-  url: z43.string().url().optional(),
-  path: z43.string().min(1).optional(),
-  thumbnailUrl: z43.string().url().optional(),
-  thumbnailPath: z43.string().min(1).optional()
+  imageVariantIndex: z44.number().int().min(0).optional()
+});
+var GroupedMediaSource = z44.object({
+  type: z44.literal("media"),
+  url: z44.string().url().optional(),
+  path: z44.string().min(1).optional(),
+  thumbnailUrl: z44.string().url().optional(),
+  thumbnailPath: z44.string().min(1).optional()
 }).refine((value) => Boolean(value.url) !== Boolean(value.path), {
   message: "media source needs exactly one of `url` or `path`"
 }).refine((value) => !(value.thumbnailUrl && value.thumbnailPath), {
   message: "media source needs at most one of `thumbnailUrl` or `thumbnailPath`"
 });
-var GroupedCreative = z43.object({
-  type: z43.enum([
+var GroupedCreative = z44.object({
+  type: z44.enum([
     "image",
     "video"
   ]),
-  source: z43.union([
+  source: z44.union([
     GroupedTaskSource,
     GroupedMediaSource
   ]),
-  title: z43.string().max(120).optional(),
-  description: z43.string().max(500).optional(),
+  title: z44.string().max(120).optional(),
+  description: z44.string().max(500).optional(),
   cta: MetaCtaType.optional(),
-  creativeId: z43.string().min(1).optional()
+  creativeId: z44.string().min(1).optional()
 });
-var GroupedCampaignConfig = z43.object({
+var GroupedCampaignConfig = z44.object({
   campaignType: MetaCampaignType.default("sales"),
   optimizationMode: MetaOptimizationMode.default("advantage_plus"),
   budgetMode: MetaBudgetMode.default("campaign"),
-  campaignDailyBudget: z43.number().int().positive().optional(),
-  adSets: z43.array(z43.object({
-    tempId: z43.string().min(1).max(80),
-    name: z43.string().min(1).max(100),
-    dailyBudget: z43.number().int().positive().optional(),
-    creativeIds: z43.array(z43.string().min(1)).min(1)
-  })).min(1).max(4),
-  destination: z43.object({
-    type: z43.literal("landing"),
-    landingUrl: z43.string().url()
-  }),
-  saveAsDefault: z43.boolean().default(false),
+  campaignDailyBudget: z44.number().int().positive().optional(),
+  adSets: z44.array(z44.object({
+    tempId: z44.string().min(1).max(80),
+    name: z44.string().min(1).max(100),
+    dailyBudget: z44.number().int().positive().optional(),
+    creativeIds: z44.array(z44.string().min(1)).min(1)
+  })).min(1).max(CAMPAIGN_LIMITS.MAX_AD_SETS),
+  /**
+  * Valid values are 'landing' and 'whatsapp' — there is no 'website'. This
+  * used to be hardcoded to `landing`, which both rejected `website` with an
+  * opaque `invalid_literal` and made the WhatsApp destination — supported by
+  * the API since #849 — unreachable from this tool.
+  */
+  destination: z44.discriminatedUnion("type", [
+    z44.object({
+      type: z44.literal("landing"),
+      landingUrl: z44.string().url()
+    }),
+    z44.object({
+      type: z44.literal("whatsapp"),
+      phoneNumber: z44.string().min(8).max(32)
+    })
+  ]),
+  saveAsDefault: z44.boolean().default(false),
   budgetPolicy: MetaBudgetPolicy.optional()
 }).superRefine((value, ctx) => {
   if (value.budgetMode === "campaign" && value.campaignDailyBudget === void 0) {
     ctx.addIssue({
-      code: z43.ZodIssueCode.custom,
+      code: z44.ZodIssueCode.custom,
       path: [
         "campaignDailyBudget"
       ],
@@ -8675,7 +8933,7 @@ var GroupedCampaignConfig = z43.object({
     value.adSets.forEach((adSet, index) => {
       if (adSet.dailyBudget === void 0) {
         ctx.addIssue({
-          code: z43.ZodIssueCode.custom,
+          code: z44.ZodIssueCode.custom,
           path: [
             "adSets",
             index,
@@ -8687,19 +8945,31 @@ var GroupedCampaignConfig = z43.object({
     });
   }
 });
-var PublishCreativesToMetaInputBase = z43.object({
-  creatives: z43.array(GroupedCreative).min(1).max(4),
-  adAccountId: z43.string().min(1),
-  pixelId: z43.string().min(1).optional(),
-  landingUrl: z43.string().url(),
-  targetCountry: z43.string().length(2),
-  campaignName: z43.string().trim().min(1).max(100),
+var PublishCreativesToMetaInputBase = z44.object({
+  creatives: z44.array(GroupedCreative).min(1).max(CAMPAIGN_LIMITS.MAX_CREATIVES),
+  adAccountId: McpAdAccountId,
+  pixelId: z44.string().min(1).optional(),
+  /** Required unless `campaignConfig.destination` is whatsapp — see the
+  *  superRefine below. Mirrors the API's `UploadToMetaRequest`. */
+  landingUrl: z44.string().url().optional(),
+  targetCountry: z44.string().length(2),
+  campaignName: z44.string().trim().min(1).max(100),
   campaignConfig: GroupedCampaignConfig.optional()
 });
 var PublishCreativesToMetaInput = PublishCreativesToMetaInputBase.superRefine((value, ctx) => {
-  if (value.campaignConfig && value.campaignConfig.destination.landingUrl !== value.landingUrl) {
+  const destination = value.campaignConfig?.destination;
+  if (destination?.type !== "whatsapp" && !value.landingUrl) {
+    ctx.addIssue({
+      code: z44.ZodIssueCode.custom,
+      path: [
+        "landingUrl"
+      ],
+      message: "landingUrl is required unless campaignConfig.destination.type is whatsapp"
+    });
+  }
+  if (destination?.type === "landing" && destination.landingUrl !== value.landingUrl) {
     ctx.addIssue({
-      code: z43.ZodIssueCode.custom,
+      code: z44.ZodIssueCode.custom,
       path: [
         "campaignConfig",
         "destination",
@@ -8709,12 +8979,12 @@ var PublishCreativesToMetaInput = PublishCreativesToMetaInputBase.superRefine((v
     });
   }
 });
-var PresignUploadResponseSchema = z43.object({
-  uploadUrl: z43.string().url().refine((value) => {
+var PresignUploadResponseSchema = z44.object({
+  uploadUrl: z44.string().url().refine((value) => {
     const url = new URL(value);
     return !url.username && !url.password && url.protocol === "https:";
   }, "presigned upload URL must be HTTPS without embedded credentials"),
-  publicUrl: z43.string().url().refine((value) => {
+  publicUrl: z44.string().url().refine((value) => {
     const url = new URL(value);
     return !url.username && !url.password;
   }, "public media URL must not contain embedded credentials")
@@ -8739,16 +9009,16 @@ async function resolveAndUploadMedia(api, ref, expectedKind, transport) {
   return uploadResolvedMedia(api, media);
 }
 __name(resolveAndUploadMedia, "resolveAndUploadMedia");
-var TikTokInput = z43.object({
-  taskId: z43.string().min(1),
-  advertiserId: z43.string().min(1),
-  pixelId: z43.string().min(1).optional(),
-  landingUrl: z43.string().url().optional(),
-  angleIndexes: z43.array(z43.number().int().nonnegative()).optional(),
+var TikTokInput = z44.object({
+  taskId: z44.string().min(1),
+  advertiserId: z44.string().min(1),
+  pixelId: z44.string().min(1).optional(),
+  landingUrl: z44.string().url().optional(),
+  angleIndexes: z44.array(z44.number().int().nonnegative()).optional(),
   campaignConfig: McpCampaignConfig.optional(),
   /** Override the ad's description (TikTok's body copy). If omitted,
   *  ProductMaker uses the auto-generated copy attached to the task. */
-  primaryText: z43.string().trim().min(1).max(500).optional()
+  primaryText: z44.string().trim().min(1).max(500).optional()
 });
 function registerPublishTools(server, api, opts = {}) {
   const transport = opts.transport ?? "http";
@@ -8787,7 +9057,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario SIEMPRE en d\xF3lares, ej. 25 \u2014 ProductMaker lo convierte a la moneda de la cuenta; si el usuario te dice '60.000 COP al d\xEDa' pasa el equivalente en USD, NUNCA el n\xFAmero en moneda local), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `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. `phoneNumber` (opcional): si el usuario quiere que el bot\xF3n del anuncio abra un chat de WhatsApp en vez de una landing, pasa el n\xFAmero (con c\xF3digo de pa\xEDs, ej. +573001234567) \u2014 no hace falta `landingUrl` en ese caso. Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", 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. Si quieres juntar creativos de VARIAS tareas en una misma campa\xF1a o en un mismo ad set, usa `publish_creatives_to_meta` \u2014 esta herramienta crea una campa\xF1a por tarea. `adAccountId` acepta tanto 'act_1234567890' como el id num\xE9rico pelado '1234567890'. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario SIEMPRE en d\xF3lares, ej. 25 \u2014 ProductMaker lo convierte a la moneda de la cuenta; si el usuario te dice '60.000 COP al d\xEDa' pasa el equivalente en USD, NUNCA el n\xFAmero en moneda local), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `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. `phoneNumber` (opcional): si el usuario quiere que el bot\xF3n del anuncio abra un chat de WhatsApp en vez de una landing, pasa el n\xFAmero (con c\xF3digo de pa\xEDs, ej. +573001234567) \u2014 no hace falta `landingUrl` en ese caso. Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, primaryText, phoneNumber, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -8815,8 +9085,11 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_creatives_to_meta", 'Crea UNA campa\xF1a de Meta Ads en estado PAUSED con 1\u20134 creativos agrupados en el mismo flujo. Cada creativo puede venir de una tarea (source.type="task") \u2014 usa angleIndex, videoVariant (with_subtitles/without_subtitles) o imageVariantIndex \u2014 o de media (source.type="media") con URL p\xFAblica o ruta local (stdio). Para videos media puedes dar thumbnailUrl o thumbnailPath; si el video es local, ProductMaker sube el archivo y genera la miniatura con FFmpeg server-side. La herramienta valida extensi\xF3n, MIME, magic bytes y tama\xF1o antes de crear la campa\xF1a. campaignConfig permite definir el ad set y budgetPolicy: exact respeta el presupuesto solicitado y falla expl\xEDcitamente si Meta exige un m\xEDnimo; recommended_floor aplica el piso recomendado. La campa\xF1a queda PAUSED; reporta campaignId, adSetId, IDs de ads, requestedBudget, appliedBudget y el enlace de Ads Manager. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, async (input) => {
+  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads en estado PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + " creativos (de tareas distintas si hace falta) en el mismo flujo, repartidos en hasta " + CAMPAIGN_LIMITS.MAX_AD_SETS + ' ad sets. Cada creativo puede venir de una tarea (source.type="task") \u2014 usa angleIndex, videoVariant (with_subtitles/without_subtitles) o imageVariantIndex \u2014 o de media (source.type="media") con URL p\xFAblica o ruta local (stdio). Para videos media, thumbnailUrl/thumbnailPath son OPCIONALES en ambos casos: ProductMaker sube el archivo y genera la miniatura con FFmpeg server-side, tanto si diste una URL como una ruta local. La herramienta valida extensi\xF3n, MIME, magic bytes y tama\xF1o antes de crear la campa\xF1a. `adAccountId` acepta tanto "act_1234567890" como el id num\xE9rico pelado "1234567890". `campaignConfig.destination` acepta exactamente dos valores: {type:"landing", landingUrl} o {type:"whatsapp", phoneNumber} \u2014 NO existe "website". campaignConfig permite definir el ad set y budgetPolicy: exact respeta el presupuesto solicitado y falla expl\xEDcitamente si Meta exige un m\xEDnimo; recommended_floor aplica el piso recomendado. La campa\xF1a queda PAUSED; reporta campaignId, adSetId, IDs de ads, requestedBudget, appliedBudget y el enlace de Ads Manager. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, async (rawInput) => {
     try {
+      const parsed = PublishCreativesToMetaInput.safeParse(rawInput);
+      if (!parsed.success) throw invalidInputFromZod(parsed.error);
+      const input = parsed.data;
       const creatives = [];
       for (let index = 0; index < input.creatives.length; index += 1) {
         const creative = input.creatives[index];
@@ -8844,9 +9117,6 @@ function registerPublishTools(server, api, opts = {}) {
         }, creative.type, transport);
         let thumbnailUrl;
         if (creative.type === "video") {
-          if (!creative.source.thumbnailUrl && !creative.source.thumbnailPath && !creative.source.path) {
-            throw new ResolveMediaError("META_NO_THUMBNAIL_SOURCE", "Video media requires thumbnailUrl or thumbnailPath unless the video is a local path; no campaign entities were created.");
-          }
           if (creative.source.thumbnailUrl || creative.source.thumbnailPath) {
             thumbnailUrl = await resolveAndUploadMedia(api, {
               url: creative.source.thumbnailUrl,
@@ -8959,13 +9229,13 @@ function toTikTokCampaignConfig(cfg) {
 __name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
 
 // src/tools/campaigns.ts
-import { z as z44 } from "zod";
-var MetaStatusInput = z44.object({
-  campaignId: z44.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
+import { z as z45 } from "zod";
+var MetaStatusInput = z45.object({
+  campaignId: z45.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
 });
-var TikTokStatusInput = z44.object({
-  campaignId: z44.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
-  advertiserId: z44.string().min(1).describe("The same advertiserId used to publish the campaign.")
+var TikTokStatusInput = z45.object({
+  campaignId: z45.string().min(1).describe("TikTok campaign ID returned by publish_to_tiktok."),
+  advertiserId: z45.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) => {
@@ -9062,10 +9332,10 @@ function renderTikTokStatusMarkdown(r) {
 __name(renderTikTokStatusMarkdown, "renderTikTokStatusMarkdown");
 
 // ../../packages/product-economics/src/product-costing.ts
-import { z as z46 } from "zod";
+import { z as z47 } from "zod";
 
 // ../../packages/product-economics/src/product-costing-countries.ts
-import { z as z45 } from "zod";
+import { z as z46 } from "zod";
 
 // ../../packages/product-economics/src/product-costing-shipping-references.json
 var product_costing_shipping_references_default = {
@@ -9129,21 +9399,21 @@ var product_costing_shipping_references_default = {
 };
 
 // ../../packages/product-economics/src/product-costing-countries.ts
-var ShippingReferenceSchema = z45.object({
-  reference: z45.number().positive(),
-  min: z45.number().nonnegative(),
-  max: z45.number().positive(),
-  updatedAt: z45.string().date(),
-  confidence: z45.enum([
+var ShippingReferenceSchema = z46.object({
+  reference: z46.number().positive(),
+  min: z46.number().nonnegative(),
+  max: z46.number().positive(),
+  updatedAt: z46.string().date(),
+  confidence: z46.enum([
     "high",
     "medium",
     "medium-low"
   ]),
-  sources: z45.array(z45.string().url().startsWith("https://")).min(1).max(3)
+  sources: z46.array(z46.string().url().startsWith("https://")).min(1).max(3)
 }).superRefine(({ reference, min, max }, context) => {
   if (min > reference || reference > max) {
     context.addIssue({
-      code: z45.ZodIssueCode.custom,
+      code: z46.ZodIssueCode.custom,
       message: "shipping_reference_outside_range",
       path: [
         "reference"
@@ -9151,7 +9421,7 @@ var ShippingReferenceSchema = z45.object({
     });
   }
 });
-var SHIPPING_REFERENCES = z45.record(ShippingReferenceSchema).parse(product_costing_shipping_references_default);
+var SHIPPING_REFERENCES = z46.record(ShippingReferenceSchema).parse(product_costing_shipping_references_default);
 var PRODUCT_COSTING_COUNTRY_CODES = Object.freeze(Object.keys(SHIPPING_REFERENCES));
 var SPANISH_LOCALE_COUNTRIES = /* @__PURE__ */ new Set([
   "MX",
@@ -9333,18 +9603,18 @@ function getProductCostingCountryName(country) {
 __name(getProductCostingCountryName, "getProductCostingCountryName");
 
 // ../../packages/product-economics/src/product-costing.ts
-var ProductCostingInputSchema = z46.object({
-  country: z46.string().refine(isProductCostingCountryCode, "unsupported_country"),
-  supplierCost: z46.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").positive("supplier_cost_positive"),
-  shippingCost: z46.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").nonnegative("shipping_cost_nonnegative"),
-  returnRate: z46.number().finite().min(0, "rate_nonnegative").lt(1, "rate_below_one"),
-  cancellationRate: z46.number().finite().min(0, "rate_nonnegative").lt(1, "rate_below_one"),
-  adsManagerCpa: z46.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").nonnegative("cpa_nonnegative"),
-  desiredMargin: z46.number().finite().min(0, "margin_nonnegative").lt(1, "margin_below_one")
+var ProductCostingInputSchema = z47.object({
+  country: z47.string().refine(isProductCostingCountryCode, "unsupported_country"),
+  supplierCost: z47.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").positive("supplier_cost_positive"),
+  shippingCost: z47.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").nonnegative("shipping_cost_nonnegative"),
+  returnRate: z47.number().finite().min(0, "rate_nonnegative").lt(1, "rate_below_one"),
+  cancellationRate: z47.number().finite().min(0, "rate_nonnegative").lt(1, "rate_below_one"),
+  adsManagerCpa: z47.number().finite().max(Number.MAX_SAFE_INTEGER, "amount_too_large").nonnegative("cpa_nonnegative"),
+  desiredMargin: z47.number().finite().min(0, "margin_nonnegative").lt(1, "margin_below_one")
 }).superRefine(({ returnRate, cancellationRate }, context) => {
   if (returnRate + cancellationRate >= 1) {
     context.addIssue({
-      code: z46.ZodIssueCode.custom,
+      code: z47.ZodIssueCode.custom,
       message: "delivery_rate_positive",
       path: [
         "cancellationRate"
@@ -9411,14 +9681,14 @@ function calculateProductCosting(rawInput) {
 __name(calculateProductCosting, "calculateProductCosting");
 
 // src/tools/product-costing.ts
-import { z as z47 } from "zod";
-var optionalAmount = /* @__PURE__ */ __name((description) => z47.number().finite().max(Number.MAX_SAFE_INTEGER).nonnegative().optional().describe(description), "optionalAmount");
-var optionalPercent = /* @__PURE__ */ __name((description) => z47.number().finite().min(0).lt(100).optional().describe(description), "optionalPercent");
-var ProductCostingToolInput = z47.object({
-  country: z47.string().trim().toUpperCase().refine(isProductCostingCountryCode, {
+import { z as z48 } from "zod";
+var optionalAmount = /* @__PURE__ */ __name((description) => z48.number().finite().max(Number.MAX_SAFE_INTEGER).nonnegative().optional().describe(description), "optionalAmount");
+var optionalPercent = /* @__PURE__ */ __name((description) => z48.number().finite().min(0).lt(100).optional().describe(description), "optionalPercent");
+var ProductCostingToolInput = z48.object({
+  country: z48.string().trim().toUpperCase().refine(isProductCostingCountryCode, {
     message: "Pa\xEDs no soportado por ProductMaker."
   }).optional().describe("C\xF3digo ISO-2 de cualquiera de los pa\xEDses disponibles en ProductMaker. Omite para Colombia."),
-  supplierCost: z47.number().finite().max(Number.MAX_SAFE_INTEGER).positive().optional().describe("Costo real de una unidad con el proveedor, en la moneda del pa\xEDs. Requerido salvo que uses supplierCostCop para Colombia."),
+  supplierCost: z48.number().finite().max(Number.MAX_SAFE_INTEGER).positive().optional().describe("Costo real de una unidad con el proveedor, en la moneda del pa\xEDs. Requerido salvo que uses supplierCostCop para Colombia."),
   supplierCostCop: optionalAmount("Alias anterior para costo del proveedor en Colombia. Prefiere supplierCost."),
   shippingCost: optionalAmount("Costo de un env\xEDo en la moneda del pa\xEDs. Omite para usar el valor gu\xEDa vigente."),
   shippingCostCop: optionalAmount("Alias anterior para flete en Colombia. Prefiere shippingCost."),
@@ -9549,6 +9819,224 @@ function formatPercent(value) {
 }
 __name(formatPercent, "formatPercent");
 
+// src/tools/product-research.ts
+import { z as z49 } from "zod";
+
+// src/tools/product-research-idempotency.ts
+import { createHash as createHash2 } from "crypto";
+var RESEARCH_IDEMPOTENCY_WINDOW_MS = 2 * 60 * 60 * 1e3;
+var NAMESPACE = "6f9d3a1e-8c47-4b52-9f10-2d7e5a3c8b64";
+function uuidV5(name, namespace) {
+  const namespaceBytes = Buffer.from(namespace.replace(/-/g, ""), "hex");
+  const digest = createHash2("sha1").update(namespaceBytes).update(name, "utf8").digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+__name(uuidV5, "uuidV5");
+function deriveIdempotencyKey(input) {
+  const window = Math.floor(input.nowMs / RESEARCH_IDEMPOTENCY_WINDOW_MS);
+  const name = `${input.fingerprint}:${input.targetCountry}:${input.categoryKey}:${window}`;
+  return uuidV5(name, NAMESPACE);
+}
+__name(deriveIdempotencyKey, "deriveIdempotencyKey");
+
+// src/tools/product-research-render.ts
+var num = /* @__PURE__ */ __name((value, suffix = "") => value === void 0 ? "\u2014" : `${Math.round(value * 100) / 100}${suffix}`, "num");
+function renderMeta(meta) {
+  if (meta.status === "evidence_failed") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se pudo consultar Meta Ads para este producto. La puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  if (meta.status === "evidence_empty") {
+    return [
+      "- \u26A0\uFE0F **Sin evidencia publicitaria:** no se encontraron anuncios activos en Meta. Puede ser un mercado virgen o una b\xFAsqueda sin cobertura; la puntuaci\xF3n se apoya s\xF3lo en datos de venta."
+    ];
+  }
+  return [
+    `- **Evidencia en Meta Ads:** ${meta.totalAds} anuncios de ${meta.distinctAdvertisers} anunciantes, m\xE1ximo ${meta.maxActiveDays} d\xEDas activos, oportunidad de \xE1ngulo ${meta.angleOpportunity}/100.`,
+    meta.summary ? `  ${meta.summary}` : ""
+  ].filter(Boolean);
+}
+__name(renderMeta, "renderMeta");
+function renderCandidate(candidate, index) {
+  const name = candidate.nameLocal ?? candidate.nameOriginal;
+  const lines = [
+    `### ${index + 1}. ${name}`,
+    `**${candidate.score}/100 \xB7 ${candidate.label} \xB7 confianza ${candidate.confidence}**`
+  ];
+  if (candidate.insight) lines.push("", candidate.insight);
+  lines.push("", "**Por qu\xE9:**");
+  lines.push(...candidate.reasons.map((reason) => `- ${reason}`));
+  lines.push("", "**Riesgos:**");
+  lines.push(...candidate.risks.length > 0 ? candidate.risks.map((risk) => `- ${risk}`) : [
+    "- No se identificaron riesgos espec\xEDficos."
+  ]);
+  lines.push("", ...renderMeta(candidate.meta));
+  lines.push("", `- **Venta (30d):** ${num(candidate.units30d)} unidades \xB7 ${num(candidate.revenueUsd30d, " USD")} \xB7 crecimiento ${num(candidate.growthPct30d, "%")} \xB7 precio ${num(candidate.priceUsd, " USD")}`);
+  if (candidate.productUrl) lines.push(`- [Ver producto](${candidate.productUrl})`);
+  return lines.join("\n");
+}
+__name(renderCandidate, "renderCandidate");
+function renderResearchReport(run) {
+  if (run.status === "failed" || run.status === "refunded") {
+    return [
+      `\u274C **La investigaci\xF3n no pudo completarse** (estado: ${run.status}).`,
+      run.errorCode ? `C\xF3digo: \`${run.errorCode}\`` : "",
+      run.refunded ? `Los ${run.priceCredits} cr\xE9ditos fueron reembolsados.` : "\u26A0\uFE0F No consta reembolso \u2014 rev\xEDsalo antes de reintentar."
+    ].filter(Boolean).join("\n");
+  }
+  if (run.status === "ready" && run.result === null) {
+    return [
+      `\u274C **No se pudo leer el reporte** (estado: ${run.status}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3, pero el reporte qued\xF3 corrupto y no puede recuperarse.`,
+      `Contacta a soporte con este runId para revisar un reembolso: \`${run.id}\`.`
+    ].join("\n");
+  }
+  if (run.result === null) {
+    return [
+      `\u23F3 **La investigaci\xF3n sigue en curso** (estado: ${run.status}, etapa: ${run.progressStage}).`,
+      `El cargo de ${run.priceCredits} cr\xE9ditos ya se realiz\xF3; el reporte no se pierde.`,
+      `Cons\xFAltalo con \`get_product_research_run\` usando runId \`${run.id}\`.`
+    ].join("\n");
+  }
+  const { result } = run;
+  const degraded = result.candidates.filter((candidate) => candidate.meta.status !== "evidence_available").length;
+  const header = [
+    `\u2705 **Productos ganadores \xB7 ${result.targetCountry} \xB7 ${result.categoryKey}**`,
+    "",
+    `Analizados ${result.methodology.kaloCandidateCount} candidatos del mercado ${result.sourceMarket}; ${result.methodology.metaCoveredCandidateCount} con cobertura de Meta Ads. Datos con ${num(result.freshnessHours, " h")} de antig\xFCedad.`
+  ];
+  if (degraded > 0) {
+    header.push("", `\u26A0\uFE0F ${degraded} de ${result.candidates.length} productos no tienen evidencia publicitaria. Su puntuaci\xF3n se apoya s\xF3lo en datos de venta.`);
+  }
+  return [
+    ...header,
+    "",
+    ...result.candidates.map((candidate, index) => renderCandidate(candidate, index))
+  ].join("\n\n");
+}
+__name(renderResearchReport, "renderResearchReport");
+
+// src/tools/product-research.ts
+var PRICE_CREDITS = 2e3;
+var TERMINAL2 = /* @__PURE__ */ new Set([
+  "ready",
+  "failed",
+  "refunded"
+]);
+var POLL_INTERVAL_MS = 5e3;
+var MAX_WAIT_SECONDS = 120;
+var FindInput = z49.object({
+  targetCountry: ResearchTargetCountryEnum.describe("Pa\xEDs objetivo. S\xF3lo CO, MX, PE, EC y CL tienen cobertura de investigaci\xF3n."),
+  categoryKey: ResearchCategoryEnum.default("auto").describe('Categor\xEDa a investigar. Usa "auto" para que la IA elija seg\xFAn el mercado.'),
+  confirmed: z49.boolean().describe(`Ponlo en true SOLO despu\xE9s de que el usuario haya aceptado el cargo de ${PRICE_CREDITS} cr\xE9ditos. No lo asumas.`),
+  waitSeconds: z49.number().int().min(0).max(MAX_WAIT_SECONDS).optional().describe("Segundos a esperar el reporte antes de devolver el runId. M\xE1ximo 120.")
+});
+var GetInput = z49.object({
+  runId: z49.string().uuid().describe("ID del run devuelto por find_winning_products.")
+});
+var ListInput = z49.object({
+  limit: z49.number().int().min(1).max(20).default(10)
+});
+function textResult(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ]
+  };
+}
+__name(textResult, "textResult");
+var sleep2 = /* @__PURE__ */ __name((ms) => new Promise((resolve3) => setTimeout(resolve3, ms)), "sleep");
+async function pollUntilTerminal(api, runId, waitSeconds) {
+  const deadline = Date.now() + Math.min(waitSeconds, MAX_WAIT_SECONDS) * 1e3;
+  let run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  while (!TERMINAL2.has(run.status) && Date.now() < deadline) {
+    await sleep2(POLL_INTERVAL_MS);
+    run = await api.getJson(`/v1/product-research/runs/${runId}`);
+  }
+  return run;
+}
+__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) => {
+    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.`);
+    }
+    try {
+      const idempotencyKey = deriveIdempotencyKey({
+        fingerprint: api.fingerprint(),
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        nowMs: Date.now()
+      });
+      const created = await api.postJson("/v1/product-research/runs", {
+        targetCountry: parsed.targetCountry,
+        categoryKey: parsed.categoryKey,
+        idempotencyKey
+      });
+      const waitSeconds = parsed.waitSeconds ?? 0;
+      let run = created;
+      if (waitSeconds > 0 && !TERMINAL2.has(created.status)) {
+        try {
+          run = await pollUntilTerminal(api, created.id, waitSeconds);
+        } catch {
+          run = created;
+        }
+      }
+      const notice = created.reused ? `
+
+_Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reciente con los mismos par\xE1metros. Para investigar una categor\xEDa distinta, vuelve a llamar con un \`categoryKey\` expl\xEDcito \u2014 eso inicia una investigaci\xF3n NUEVA con un cargo NUEVO de ${PRICE_CREDITS} cr\xE9ditos, as\xED que pide confirmaci\xF3n expl\xEDcita al usuario antes de hacerlo._` : "";
+      return textResult(`${renderResearchReport(run)}${notice}`);
+    } catch (error) {
+      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) => {
+    const parsed = GetInput.parse(input);
+    try {
+      const run = await api.getJson(`/v1/product-research/runs/${parsed.runId}`);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(run)
+          },
+          {
+            type: "text",
+            text: renderResearchReport(run)
+          }
+        ]
+      };
+    } catch (error) {
+      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) => {
+    const parsed = ListInput.parse(input);
+    try {
+      const runs = await api.getJson(`/v1/product-research/runs?limit=${parsed.limit}`);
+      return textResult(JSON.stringify(runs));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
+}
+__name(registerProductResearchTools, "registerProductResearchTools");
+
 // src/server.ts
 function createServer(opts) {
   const { apiKey, apiBaseUrl, proxyBaseUrl = null, transport = "http" } = opts;
@@ -9565,6 +10053,7 @@ function createServer(opts) {
   });
   const api = new ApiClient(apiBaseUrl, apiKey);
   registerProductCostingTools(server);
+  registerProductResearchTools(server, api);
   registerTaskTools(server, api, {
     proxyBaseUrl,
     transport