@productmaker/mcp 12.5.0 → 12.6.0

package/README.md

@@ -212,6 +212,7 @@ its service-page editor, including its generation progress.
 | `set_ad_spend`                  | Correct by hand what was spent on ads that month. `amount: 0` ASSERTS "I did not advertise"; `null` WITHDRAWS the correction and gives the campaigns back the say. They are not the same                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | `prepare_winning_product_image` | Prepare and show the exact photo of a user-selected winning-product candidate for free; securely stages it before the next photo choice.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | `get_product_control`           | Read-only daily profitability verdicts and measurement status per store product. Incomplete samples or unmeasured delivered sales must remain explicit; never changes campaigns.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `get_product_ads`               | Read-only Meta figures for each ad (sales angle) of one product on one day: spend, pixel purchases, cost per purchase, video retention and a keep/turn off/review suggestion against the break-even. Pixel purchases are not store orders; never changes ads.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `list_importable_products`      | Read one page of store products eligible for financial control; preserve `hasNextPage` and already-imported markers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `import_product_controls`       | Add selected store products to financial control. They remain `no_costing` until their real costs are saved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `set_product_costing`           | Save seller-provided supplier cost, freight and estimated cancellation/return rates; store price stays canonical and missing costs cannot be invented.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

package/dist/http.js

@@ -2315,6 +2315,15 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.01,
     userPriceCents: 0.02
   },
+  // OpenAI Decisions same-product check of DropKiller listings (market formats study),
+  // per 1,000 input tokens. Decisions has no price row of its own; it bills as its
+  // model, gpt-6-luna: $0.10/1M input (https://developers.openai.com/api/docs/pricing,
+  // 2026-11-02). Answers are closed choices, so output is negligible. Cost-only:
+  // the seller is not charged, the fixed study quote absorbs it.
+  "openai:competitor-listing-decision": {
+    ourCostCents: 0.01,
+    userPriceCents: 0
+  },
   // Full competitor-source transcript used by the flat-price Frankenstein bundle.
   "openai:frankenstein-source-transcribe": {
     ourCostCents: 0.01,
@@ -2476,6 +2485,19 @@ var DEFAULT_PRICING = {
     ourCostCents: 1,
     userPriceCents: 2
   },
+  // Market formats read each competitor ad by its medium. Video: Gemini over
+  // the whole ad with audio, measured 1.641¢ avg / 2.071¢ max over 60 local
+  // analyses (6.9k in / 3.0k out tokens, 2026-11-04). Image: one still with the
+  // same prompt, estimated (~4.2k in / ~2k out) — no producer until image ads
+  // are analyzed. Frames (the key above) stays the flag-off and fallback leg.
+  "openrouter:market-ad-video-analysis": {
+    ourCostCents: 1.65,
+    userPriceCents: 3.3
+  },
+  "openrouter:market-ad-image-analysis": {
+    ourCostCents: 1.1,
+    userPriceCents: 2.2
+  },
   "openrouter:competitor-commercial-dossier": {
     ourCostCents: 5,
     userPriceCents: 10
@@ -4093,6 +4115,13 @@ var AiEditWinnerOverlayItemSchema = z5.object({
   /** Target-truth field ids backing `text` (from the adaptation plan). */
   truthSourceIds: z5.array(z5.string().min(1).max(200)).max(16).optional()
 }).strict();
+var AiEditDeliveredExecutionSchema = z5.object({
+  taskId: z5.string().min(1).max(200),
+  angleKey: z5.string().min(1).max(200),
+  creativeRevision: z5.string().min(1).max(200),
+  planHash: z5.string().min(1).max(200),
+  outputHash: z5.string().min(1).max(200)
+}).strict();
 var AiEditWinnerOverlaysSchema = z5.object({
   version: z5.literal(1),
   source: z5.object({
@@ -4102,13 +4131,7 @@ var AiEditWinnerOverlaysSchema = z5.object({
     adaptationPlanRevision: z5.string().regex(/^[a-f0-9]{64}$/).optional()
   }).strict(),
   /** The delivered execution this plan was fitted against. */
-  current: z5.object({
-    taskId: z5.string().min(1).max(200),
-    angleKey: z5.string().min(1).max(200),
-    creativeRevision: z5.string().min(1).max(200),
-    planHash: z5.string().min(1).max(200),
-    outputHash: z5.string().min(1).max(200)
-  }).strict(),
+  current: AiEditDeliveredExecutionSchema,
   items: z5.array(AiEditWinnerOverlayItemSchema).max(64),
   omitted: z5.array(z5.object({
     id: z5.string().min(1).max(200),
@@ -4124,12 +4147,46 @@ var AiEditWinnerOverlaysSchema = z5.object({
     ])
   }).strict()).max(64)
 }).strict();
+var AiEditMarketFormatOverlaysSchema = z5.object({
+  version: z5.literal(1),
+  source: z5.object({
+    formatId: z5.string().min(1).max(200),
+    anchorSourceId: z5.string().min(1).max(200),
+    contextHash: z5.string().min(1).max(200)
+  }).strict(),
+  current: AiEditDeliveredExecutionSchema,
+  /** The format's look and editing pace, for the overlay style. */
+  style: z5.object({
+    visualStyle: z5.string().max(600),
+    editingPace: z5.string().max(300).optional()
+  }).strict(),
+  items: z5.array(z5.object({
+    formatBeatIndex: z5.number().int().nonnegative(),
+    beat: z5.string().max(200),
+    sourceText: z5.string().min(1).max(400),
+    target: z5.object({
+      sceneId: z5.string().min(1).max(200),
+      beatIds: z5.array(z5.string().min(1).max(200)).max(16),
+      startSec: z5.number().finite().nonnegative(),
+      endSec: z5.number().finite().nonnegative()
+    }).strict()
+  }).strict()).max(10),
+  omitted: z5.array(z5.object({
+    formatBeatIndex: z5.number().int().nonnegative(),
+    reason: z5.enum([
+      "unmapped_beat",
+      "unfitted_interval"
+    ])
+  }).strict()).max(10)
+}).strict();
 var AiEditBriefSchema = z5.object({
   script: z5.string(),
   words: z5.array(AiEditWordSchema),
   sceneCutsSec: z5.array(z5.number().min(0)),
   /** Optional winner-overlay adaptation plan; absent without winner+edit consent. */
-  winnerOverlays: AiEditWinnerOverlaysSchema.optional()
+  winnerOverlays: AiEditWinnerOverlaysSchema.optional(),
+  /** Optional market-format overlays; absent without an applied format. */
+  marketFormatOverlays: AiEditMarketFormatOverlaysSchema.optional()
 });
 var AiEditOutputsSchema = z5.object({
   editKey: z5.string(),
@@ -5279,8 +5336,11 @@ var COUNTRY_NAME_TO_ISO2 = {
 var COUNTRY_NAME_ALIASES = {
   usa: "united states",
   "estados unidos": "united states",
+  estadosunidos: "united states",
+  unitedstates: "united states",
   uk: "united kingdom",
   "reino unido": "united kingdom",
+  unitedkingdom: "united kingdom",
   brasil: "brazil",
   espana: "spain",
   alemania: "germany",
@@ -5333,6 +5393,7 @@ function normalizeToIso2(value) {
   return void 0;
 }
 __name(normalizeToIso2, "normalizeToIso2");
+var SUPPORTED_COUNTRY_ISO2 = new Set(Object.values(COUNTRY_NAME_TO_ISO2));
 var CountryIso2Schema = z11.preprocess(
   (value) => typeof value === "string" ? normalizeToIso2(value) ?? value : value,
   // The regex rejects unresolvable 2-unit garbage ('$$', '💩') that would
@@ -7885,6 +7946,13 @@ var CodeLandingCommerceSnapshotSchema = z23.object({
   compareAtPrice: z23.string().trim().min(1).max(500).optional(),
   /** Explicit removal survives projections that otherwise derive a comparison. */
   compareAtPriceRemoved: z23.literal(true).optional(),
+  /** Seller-confirmed prices by product option, never purchase quantities. */
+  offerVariants: z23.array(z23.object({
+    option: z23.string().trim().min(1).max(60),
+    value: z23.string().trim().min(1).max(60),
+    price: PublishCommerceValuesSchema.shape.unitPrice,
+    compareAtPrice: PublishCommerceValuesSchema.shape.unitPrice.nullable().optional()
+  }).strict()).max(20).optional(),
   /** Confirmed offer facts before Shopify supplies real chargeable variants. */
   offerPacks: z23.array(z23.object({
     units: z23.number().int().min(2).max(99),
@@ -10478,6 +10546,49 @@ var ObservedCommercialClaimSchema = z37.object({
     "other"
   ])
 }).strict();
+var CreativeFormatFramingSchema = z37.object({
+  shotSize: z37.enum([
+    "macro",
+    "close_up",
+    "medium",
+    "wide"
+  ]),
+  camera: z37.enum([
+    "static",
+    "handheld",
+    "selfie",
+    "moving"
+  ]),
+  faceVisible: z37.boolean()
+}).strict();
+var CompetitorCreativeFormatSchema = z37.object({
+  formatName: z37.string().trim().min(1).max(120),
+  renderTechnique: z37.string().trim().min(1).max(300),
+  visualWorld: z37.string().trim().min(1).max(600),
+  protagonist: z37.string().trim().min(1).max(300),
+  narrativeEngine: z37.string().trim().min(1).max(600),
+  beats: z37.array(z37.object({
+    atSec: z37.number().finite().nonnegative(),
+    beat: z37.string().trim().min(1).max(200),
+    /** What physically happens on camera, never its overlay text. */
+    visual: z37.string().trim().min(1).max(400),
+    /** Text, captions or graphics shown over that beat ("" = none). */
+    onScreenText: z37.string().trim().max(400).optional()
+  }).strict()).min(1).max(12),
+  hookDevice: z37.string().trim().min(1).max(600),
+  ctaDevice: z37.string().trim().min(1).max(600),
+  productRole: z37.string().trim().min(1).max(600),
+  tone: z37.string().trim().min(1).max(300),
+  editingPace: z37.string().trim().min(1).max(300),
+  confidence: z37.enum([
+    "high",
+    "medium",
+    "low"
+  ]),
+  /** ISO 639-1 of the spoken words, or "none" without speech. */
+  spokenLanguage: z37.string().trim().toLowerCase().regex(/^(?:[a-z]{2}|none)$/).optional(),
+  framing: CreativeFormatFramingSchema.optional()
+}).strict();
 var CompetitorCommercialProfileSchema = z37.object({
   durationSec: z37.number().finite().positive(),
   transcript: z37.string().max(2e4).optional(),
@@ -10503,7 +10614,9 @@ var CompetitorCommercialProfileSchema = z37.object({
     "incompatible",
     "uncertain"
   ]).optional(),
-  marketRelevanceEvidence: z37.string().trim().min(1).max(1e3).optional()
+  marketRelevanceEvidence: z37.string().trim().min(1).max(1e3).optional(),
+  /** Requested only for market-format studies; absent on every other path. */
+  creativeFormat: CompetitorCreativeFormatSchema.optional()
 }).strict();
 var MarketSceneIntentSchema = z37.object({
   id: z37.string().trim().min(1).max(80),
@@ -10561,6 +10674,99 @@ var CommercialMarketDossierSchema = z37.object({
   recipes: z37.array(MarketCreativeRecipeSchema).length(3),
   evidenceDisclaimer: z37.string().trim().min(1).max(1e3)
 }).strict();
+var MarketVoiceLineSchema = z37.object({
+  /** Quoted exactly as spoken in the source transcript, original language. */
+  text: z37.string().trim().min(1).max(400),
+  sourceId: z37.string().trim().min(1)
+}).strict();
+var MarketFormatVoiceSchema = z37.object({
+  hookLines: z37.array(MarketVoiceLineSchema).max(6),
+  ctaLines: z37.array(MarketVoiceLineSchema).max(6),
+  recurringPhrases: z37.array(z37.string().trim().min(1).max(200)).max(12),
+  topics: z37.array(z37.string().trim().min(1).max(200)).max(10),
+  rawness: z37.number().int().min(1).max(5)
+}).strict();
+var MarketFormatAnchorFrameSchema = z37.object({
+  index: z37.number().int().min(0).max(3),
+  assetKey: z37.string().trim().min(1).max(500),
+  timestampSec: z37.number().finite().nonnegative()
+}).strict();
+var MarketFormatPacingSchema = z37.object({
+  shotCount: z37.number().int().min(1).max(12),
+  secondsPerShot: z37.number().finite().positive().max(600),
+  editingPace: z37.string().trim().min(1).max(300).optional()
+}).strict();
+var MarketBeatExampleSchema = z37.object({
+  visual: z37.string().trim().min(1).max(400),
+  sourceId: z37.string().trim().min(1)
+}).strict();
+var MarketFormatDirectionSchema = z37.object({
+  id: z37.string().trim().min(1).max(80),
+  formatName: z37.string().trim().min(1).max(120),
+  anchorSourceId: z37.string().trim().min(1),
+  sourceIds: z37.array(z37.string().trim().min(1)).min(1).max(20),
+  advertiserCount: z37.number().int().positive(),
+  weightShare: z37.number().finite().min(0).max(1),
+  advertiserShare: z37.number().finite().min(0).max(1),
+  visualStyle: z37.string().trim().min(1).max(600),
+  protagonist: z37.string().trim().min(1).max(300),
+  narrative: z37.string().trim().min(1).max(600),
+  storyLine: z37.string().trim().min(1).max(600),
+  beats: z37.array(z37.object({
+    beat: z37.string().trim().min(1).max(200),
+    /** The on-camera action to stage (a CTA action included). */
+    visual: z37.string().trim().min(1).max(600),
+    /** Graphics for the optional edit ("" = none); never staged. */
+    onScreenText: z37.string().trim().max(400).optional(),
+    /** How different member ads stage this shared beat. */
+    examples: z37.array(MarketBeatExampleSchema).max(4).optional()
+  }).strict()).min(2).max(10),
+  hook: z37.string().trim().min(1).max(600),
+  cta: z37.string().trim().min(1).max(600),
+  productRole: z37.string().trim().min(1).max(600),
+  adaptToProduct: z37.string().trim().min(1).max(1e3),
+  doNotCopy: z37.array(z37.string().trim().min(1).max(300)).max(10),
+  whyThisFormat: z37.string().trim().min(1).max(1e3),
+  voice: MarketFormatVoiceSchema.optional(),
+  anchorFrames: z37.array(MarketFormatAnchorFrameSchema).max(4).optional(),
+  /** Server-owned: the anchor ad's framing, binding for the director. */
+  framing: CreativeFormatFramingSchema.optional(),
+  /** Server-owned: the anchor ad's cut rhythm, binding for the director. */
+  pacing: MarketFormatPacingSchema.optional(),
+  /** Server-owned: no member speaks the target market's language. */
+  languageFallback: z37.boolean().optional()
+}).strict();
+var MarketMenuItemSchema = z37.object({
+  kind: z37.string().trim().min(1).max(120),
+  description: z37.string().trim().min(1).max(400),
+  lines: z37.array(MarketVoiceLineSchema).max(4).optional(),
+  sourceIds: z37.array(z37.string().trim().min(1)).min(1).max(20),
+  advertiserCount: z37.number().int().positive(),
+  weightShare: z37.number().finite().min(0).max(1)
+}).strict();
+var MarketCreativeMenuSchema = z37.object({
+  hooks: z37.array(MarketMenuItemSchema).max(6),
+  ctas: z37.array(MarketMenuItemSchema).max(6),
+  visualStyles: z37.array(MarketMenuItemSchema).max(6),
+  demos: z37.array(MarketMenuItemSchema).max(8),
+  rhythms: z37.array(MarketMenuItemSchema).max(4)
+}).strict();
+var MarketCreativeDirectionSchema = z37.object({
+  version: z37.literal("1.0.0"),
+  sourceSnapshotHash: z37.string().trim().min(1),
+  evidenceSource: z37.enum([
+    "dropkiller",
+    "meta",
+    "mixed"
+  ]),
+  analyzedVideoCount: z37.number().int().positive(),
+  advertiserCount: z37.number().int().positive(),
+  /** Dropi units sold in 30 days across confirmed listings, when known. */
+  productSoldUnits30d: z37.number().int().nonnegative().optional(),
+  formats: z37.array(MarketFormatDirectionSchema).min(1).max(3),
+  /** The market's recurring hooks, CTAs, styles, demos and rhythms. */
+  menu: MarketCreativeMenuSchema.optional()
+}).strict();
 var MarketPersuasionDeviceSchema = z37.object({
   /** Verbatim hook/CTA/market pattern from the persisted dossier. */
   sourcePattern: z37.string().trim().min(1).max(1e3),
@@ -10769,6 +10975,24 @@ var CreativeEngineWinnerContextSchema = z38.object({
     }).strict()).max(24)
   }).strict().optional()
 }).strict();
+var CreativeEngineMarketPickSchema = z38.object({
+  kind: z38.string().trim().min(1).max(120),
+  description: z38.string().trim().min(1).max(400),
+  /** A verbatim market line to adapt (hooks and CTAs). */
+  line: z38.string().trim().min(1).max(400).optional(),
+  sourceId: id2
+}).strict();
+var CreativeEngineMarketSelectionSchema = z38.object({
+  version: z38.literal(1),
+  formatId: id2,
+  /** The member ad shown as one example of the format, never a template. */
+  exampleSourceId: id2,
+  hook: CreativeEngineMarketPickSchema.optional(),
+  cta: CreativeEngineMarketPickSchema.optional(),
+  visualStyle: CreativeEngineMarketPickSchema.optional(),
+  demo: CreativeEngineMarketPickSchema.optional(),
+  rhythm: CreativeEngineMarketPickSchema.optional()
+}).strict();
 var CreativeEngineMarketInputSchema = z38.object({
   version: z38.literal(1),
   /** The dossier's own snapshot hash (not necessarily hex-64). */
@@ -10797,7 +11021,22 @@ var CreativeEngineMarketInputSchema = z38.object({
     ])
   }).strict()).max(64),
   /** Validated when it names a recipe actually present in `recipes`. */
-  marketRecipeId: id2.optional()
+  marketRecipeId: id2.optional(),
+  /**
+   * Market formats flag only: formats #1..#3 (HOW the video looks and flows)
+   * with the anchor ad's transcript. Absent keeps the historical context.
+   */
+  formats: z38.array(MarketFormatDirectionSchema.extend({
+    anchorTranscript: z38.string().max(2e4).optional()
+  }).strict()).min(1).max(3).optional(),
+  /** The format the server binds; the director may drop to the next with a reason. */
+  marketFormatId: id2.optional(),
+  /**
+   * Market formats only: the combination sampled for this creative by market
+   * weight (format, hook, CTA, style, demo, example member), seeded by the
+   * task so a retry repeats it and sibling creatives vary inside the market.
+   */
+  marketSelection: CreativeEngineMarketSelectionSchema.optional()
 }).strict();
 var CreativeEngineCommercialExecutionSchema = z38.discriminatedUnion("mode", [
   z38.object({
@@ -10806,7 +11045,17 @@ var CreativeEngineCommercialExecutionSchema = z38.discriminatedUnion("mode", [
     mode: z38.literal("market"),
     sourceSnapshotHash: z38.string().min(1).max(200),
     recipeId: id2,
-    sourceIds: z38.array(id2).min(1).max(64)
+    sourceIds: z38.array(id2).min(1).max(64),
+    /** The market format actually applied (context `market.formats` only). */
+    formatId: id2.optional(),
+    /** Each format beat mapped onto the authored scene/beats. */
+    beatMap: z38.array(z38.object({
+      formatBeatIndex: z38.number().int().nonnegative(),
+      targetSceneId: id2,
+      targetBeatIds: z38.array(id2).max(16)
+    }).strict()).min(1).max(10).optional(),
+    /** Required only when formatId is not the server-bound format. */
+    formatFallbackReason: z38.string().min(1).max(500).optional()
   }).strict(),
   z38.object({
     version: z38.literal(1),
@@ -15508,8 +15757,13 @@ var AdminQualityReportSummary = z53.object({
   mixTaskId: z53.string().nullable(),
   kind: QualityReportKind,
   // Historical rows can contain `quality` in the DB's free-text reason column.
+  // Support refunds can also contain `generation_failed`, presented as `other`.
   // Normalize only on read; new submissions keep the strict QualityReportReason enum.
-  reason: z53.preprocess((value) => value === "quality" ? "unacceptable_quality" : value, QualityReportReason),
+  reason: z53.preprocess((value) => {
+    if (value === "quality") return "unacceptable_quality";
+    if (value === "generation_failed") return "other";
+    return value;
+  }, QualityReportReason),
   status: QualityReportStatus,
   estimatedCostCents: z53.number().nullable(),
   refundedCents: z53.number().nullable(),
@@ -21553,6 +21807,24 @@ var CAPABILITY_MODEL_GUIDANCE = {
       "solo lectura; un d\xEDa sin conteos usa la tasa estimada"
     ]
   },
+  get_product_ads: {
+    summary: "Muestra cada anuncio (\xE1ngulo de venta) de un producto en un d\xEDa, con cifras de Meta y qu\xE9 hacer con \xE9l.",
+    useWhen: [
+      "cu\xE1l de mis anuncios est\xE1 vendiendo",
+      "qu\xE9 anuncio apago",
+      "c\xF3mo le fue a cada \xE1ngulo ayer"
+    ],
+    avoidWhen: [
+      "pregunta por el producto entero: get_product_control"
+    ],
+    defaults: [
+      "el id sale de get_product_control, nunca se inventa",
+      "compras del p\xEDxel de Meta, no pedidos de la tienda"
+    ],
+    disclosures: [
+      "solo lectura; nunca pausa ni modifica un anuncio"
+    ]
+  },
   report_product_counts: {
     summary: "Registra lo que de verdad pas\xF3 con un producto en un d\xEDa: pedidos, cancelados, entregados y devueltos.",
     useWhen: [
@@ -22933,6 +23205,76 @@ var CreateManualProductControlResponseSchema = z100.object({
   productControlId: z100.string().guid(),
   created: z100.boolean()
 });
+var ProductControlAdsQuerySchema = z100.object({
+  date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/)
+});
+var PRODUCT_CONTROL_AD_VERDICTS = [
+  "keep",
+  "turn_off",
+  "review",
+  "no_data"
+];
+var ProductControlAdVerdictSchema = z100.enum(PRODUCT_CONTROL_AD_VERDICTS);
+var PRODUCT_CONTROL_AD_REASONS = [
+  "sells_within_break_even",
+  "sells_above_break_even",
+  "spent_break_even_without_sales",
+  "low_spend_no_sales",
+  "no_spend",
+  "missing_break_even",
+  "unknown_purchases",
+  "different_time_zone"
+];
+var ProductControlAdReasonSchema = z100.enum(PRODUCT_CONTROL_AD_REASONS);
+var metric = z100.number().finite().nonnegative().nullable();
+var ProductControlAdSchema = z100.object({
+  adId: z100.string(),
+  campaignId: z100.string(),
+  accountId: z100.string(),
+  name: z100.string(),
+  /** `effective_status` de Meta (ACTIVE, PAUSED, …), tal cual. */
+  status: z100.string().nullable(),
+  thumbnailUrl: z100.string().url().nullable(),
+  creativeKind: z100.enum([
+    "video",
+    "image",
+    "unknown"
+  ]),
+  adsManagerUrl: z100.string().url(),
+  spend: metric,
+  impressions: metric,
+  clicks: metric,
+  ctr: metric,
+  landingPageViews: metric,
+  viewContent: metric,
+  initiatedCheckout: metric,
+  /** Compras del píxel (`offsite_conversion.fb_pixel_purchase`). */
+  purchases: metric,
+  costPerPurchase: metric,
+  videoPlays: metric,
+  videoP25: metric,
+  videoP75: metric,
+  videoP100: metric,
+  /** p100 / reproducciones; `null` si no es vídeo o no hubo reproducciones. */
+  completionRate: z100.number().finite().min(0).max(1).nullable(),
+  verdict: ProductControlAdVerdictSchema,
+  reason: ProductControlAdReasonSchema
+});
+var ProductControlAdsStatusSchema = z100.enum([
+  "ok",
+  "no_meta_campaign",
+  "meta_not_connected",
+  "unavailable"
+]);
+var ProductControlAdsResponseSchema = z100.object({
+  productControlId: z100.string(),
+  date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  status: ProductControlAdsStatusSchema,
+  currency: z100.string().nullable(),
+  /** Publicidad máxima por compra para no perder (CPA de equilibrio). */
+  breakEvenCpa: z100.number().finite().nonnegative().nullable(),
+  ads: z100.array(ProductControlAdSchema)
+});
 
 // ../../packages/types/src/productmaker-capability-registry.ts
 var SHARED_CHANNEL_EXPOSURE = {
@@ -24723,6 +25065,20 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_control_report"
   ]),
+  defineCapability("get_product_ads", "df2873f9776f34f8a5a4c02b2878fbd6fb6ed1cfd9998cf728603b2bbd10069b", "none", "read_only", [
+    "read"
+  ], [
+    slot("product_control", true, [
+      "productControlId"
+    ]),
+    slot("day", true, [
+      "date"
+    ])
+  ], [
+    "product_control"
+  ], [
+    "product_control_ads"
+  ], MCP_ONLY_CHANNEL_EXPOSURE),
   defineCapability("report_product_counts", "8fa2561901b7743506a3639038d7806186c0512470bc6988a54c6bee5dbbb0b0", "state_change", "business", [
     "state_change"
   ], [
@@ -30987,7 +31343,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.5.0";
+var MCP_VERSION = "12.6.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -40924,6 +41280,7 @@ import { readFile, stat } from "fs/promises";
 import { basename as basename2, isAbsolute, resolve as resolve3 } from "path";
 import { z as z156 } from "zod";
 var getProductControlGuidance = getProductMakerCapabilityModelGuidance("get_product_control");
+var getProductAdsGuidance = getProductMakerCapabilityModelGuidance("get_product_ads");
 var listImportableProductsGuidance = getProductMakerCapabilityModelGuidance("list_importable_products");
 var importProductControlsGuidance = getProductMakerCapabilityModelGuidance("import_product_controls");
 var setProductCostingGuidance = getProductMakerCapabilityModelGuidance("set_product_costing");
@@ -40951,6 +41308,10 @@ var ProductControlListInput = z156.object({
   date: DateOnly2.optional().describe("D\xEDa final de la ventana (YYYY-MM-DD). Si se omite, termina en el \xFAltimo d\xEDa cerrado \u2014 nunca hoy, que est\xE1 incompleto."),
   shopDomain: z156.string().min(1).optional().describe("Tienda, si tiene m\xE1s de una conectada.")
 }).strict();
+var ProductAdsInput = z156.object({
+  productControlId: z156.string().uuid().describe("El `productControlId` que devuelve get_product_control."),
+  date: DateOnly2.describe("D\xEDa a leer (YYYY-MM-DD).")
+}).strict();
 var ImportableProductsInput = z156.object({
   q: z156.string().trim().max(120).optional().describe("B\xFAsqueda por t\xEDtulo. Sin esto un cat\xE1logo grande es inrecorrible."),
   after: z156.string().max(512).optional().describe("Cursor de la p\xE1gina anterior, tal como vino en la respuesta."),
@@ -41078,6 +41439,20 @@ function registerProductControlTools(server, api, { transport = "http" } = {}) {
       throw translateError(error);
     }
   });
+  server.registerTool("get_product_ads", {
+    description: getProductAdsGuidance.summary + " Devuelve cada anuncio de las campa\xF1as de Meta enlazadas al producto, con sus cifras DE META ese d\xEDa: gasto, impresiones, clics, CTR, visitas a la landing, view content, inicios de pago, compras del p\xEDxel, costo por compra y retenci\xF3n del v\xEDdeo (reproducciones, 25/75/100 % y `completionRate`). `verdict` es lo que la pantalla le sugiere: `keep` (mantener), `turn_off` (apagar), `review` (revisar) y `no_data` (todav\xEDa no hay con qu\xE9 juzgarlo); `reason` dice por qu\xE9, y el umbral es `breakEvenCpa`, la publicidad m\xE1xima por compra para no perder. Las compras del p\xEDxel NO son los pedidos de la tienda: el producto se decide con get_product_control y los anuncios se comparan entre s\xED con esto, porque un pedido contraentrega no dice de qu\xE9 anuncio vino. `status` distinto de `ok` no trae anuncios: `meta_not_connected` (conectar Meta), `no_meta_campaign` (enlazar campa\xF1a) o `unavailable` (Meta no respondi\xF3). Si falta un dato o Meta no respondi\xF3 y el usuario tiene su propio MCP de Meta, complementa ah\xED y di de d\xF3nde sale cada cifra. Es READ-ONLY: nunca pausa ni modifica un anuncio; apagar lo decide y lo hace ella en Meta.",
+    inputSchema: ProductAdsInput.shape,
+    annotations: READS_EXTERNAL
+  }, async (input) => {
+    try {
+      const params = new URLSearchParams({
+        date: input.date
+      });
+      return asText(await api.getJson(`/v1/product-control/${encodeURIComponent(input.productControlId)}/ads?${params.toString()}`));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
   server.registerTool("get_finances", {
     description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana. Si viene `costEstimate` con `source: "product_costing"`, presenta sus importes como ESTIMACI\xD3N antes de impuestos, usando los costos actuales configurados del producto: no son costos reales confirmados de esos pedidos. Conserva el aviso de `costsKnown: false` y distingue esta estimaci\xF3n de los importes reales del libro. `linesEstimated` indica cu\xE1ntas l\xEDneas usan costos configurados. La API s\xF3lo ofrece esta estimaci\xF3n cuando cubre todos los costos faltantes con perfiles asociados del mismo pa\xEDs y moneda, y conoce ventas entregadas, publicidad y gastos revisados. Si `costEstimate` es null o no existe, no inventes una estimaci\xF3n ni completes importes faltantes.',
     inputSchema: GetFinancesInput.shape,

package/dist/stdio.js

@@ -2090,6 +2090,15 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.01,
     userPriceCents: 0.02
   },
+  // OpenAI Decisions same-product check of DropKiller listings (market formats study),
+  // per 1,000 input tokens. Decisions has no price row of its own; it bills as its
+  // model, gpt-6-luna: $0.10/1M input (https://developers.openai.com/api/docs/pricing,
+  // 2026-11-02). Answers are closed choices, so output is negligible. Cost-only:
+  // the seller is not charged, the fixed study quote absorbs it.
+  "openai:competitor-listing-decision": {
+    ourCostCents: 0.01,
+    userPriceCents: 0
+  },
   // Full competitor-source transcript used by the flat-price Frankenstein bundle.
   "openai:frankenstein-source-transcribe": {
     ourCostCents: 0.01,
@@ -2251,6 +2260,19 @@ var DEFAULT_PRICING = {
     ourCostCents: 1,
     userPriceCents: 2
   },
+  // Market formats read each competitor ad by its medium. Video: Gemini over
+  // the whole ad with audio, measured 1.641¢ avg / 2.071¢ max over 60 local
+  // analyses (6.9k in / 3.0k out tokens, 2026-11-04). Image: one still with the
+  // same prompt, estimated (~4.2k in / ~2k out) — no producer until image ads
+  // are analyzed. Frames (the key above) stays the flag-off and fallback leg.
+  "openrouter:market-ad-video-analysis": {
+    ourCostCents: 1.65,
+    userPriceCents: 3.3
+  },
+  "openrouter:market-ad-image-analysis": {
+    ourCostCents: 1.1,
+    userPriceCents: 2.2
+  },
   "openrouter:competitor-commercial-dossier": {
     ourCostCents: 5,
     userPriceCents: 10
@@ -3868,6 +3890,13 @@ var AiEditWinnerOverlayItemSchema = z5.object({
   /** Target-truth field ids backing `text` (from the adaptation plan). */
   truthSourceIds: z5.array(z5.string().min(1).max(200)).max(16).optional()
 }).strict();
+var AiEditDeliveredExecutionSchema = z5.object({
+  taskId: z5.string().min(1).max(200),
+  angleKey: z5.string().min(1).max(200),
+  creativeRevision: z5.string().min(1).max(200),
+  planHash: z5.string().min(1).max(200),
+  outputHash: z5.string().min(1).max(200)
+}).strict();
 var AiEditWinnerOverlaysSchema = z5.object({
   version: z5.literal(1),
   source: z5.object({
@@ -3877,13 +3906,7 @@ var AiEditWinnerOverlaysSchema = z5.object({
     adaptationPlanRevision: z5.string().regex(/^[a-f0-9]{64}$/).optional()
   }).strict(),
   /** The delivered execution this plan was fitted against. */
-  current: z5.object({
-    taskId: z5.string().min(1).max(200),
-    angleKey: z5.string().min(1).max(200),
-    creativeRevision: z5.string().min(1).max(200),
-    planHash: z5.string().min(1).max(200),
-    outputHash: z5.string().min(1).max(200)
-  }).strict(),
+  current: AiEditDeliveredExecutionSchema,
   items: z5.array(AiEditWinnerOverlayItemSchema).max(64),
   omitted: z5.array(z5.object({
     id: z5.string().min(1).max(200),
@@ -3899,12 +3922,46 @@ var AiEditWinnerOverlaysSchema = z5.object({
     ])
   }).strict()).max(64)
 }).strict();
+var AiEditMarketFormatOverlaysSchema = z5.object({
+  version: z5.literal(1),
+  source: z5.object({
+    formatId: z5.string().min(1).max(200),
+    anchorSourceId: z5.string().min(1).max(200),
+    contextHash: z5.string().min(1).max(200)
+  }).strict(),
+  current: AiEditDeliveredExecutionSchema,
+  /** The format's look and editing pace, for the overlay style. */
+  style: z5.object({
+    visualStyle: z5.string().max(600),
+    editingPace: z5.string().max(300).optional()
+  }).strict(),
+  items: z5.array(z5.object({
+    formatBeatIndex: z5.number().int().nonnegative(),
+    beat: z5.string().max(200),
+    sourceText: z5.string().min(1).max(400),
+    target: z5.object({
+      sceneId: z5.string().min(1).max(200),
+      beatIds: z5.array(z5.string().min(1).max(200)).max(16),
+      startSec: z5.number().finite().nonnegative(),
+      endSec: z5.number().finite().nonnegative()
+    }).strict()
+  }).strict()).max(10),
+  omitted: z5.array(z5.object({
+    formatBeatIndex: z5.number().int().nonnegative(),
+    reason: z5.enum([
+      "unmapped_beat",
+      "unfitted_interval"
+    ])
+  }).strict()).max(10)
+}).strict();
 var AiEditBriefSchema = z5.object({
   script: z5.string(),
   words: z5.array(AiEditWordSchema),
   sceneCutsSec: z5.array(z5.number().min(0)),
   /** Optional winner-overlay adaptation plan; absent without winner+edit consent. */
-  winnerOverlays: AiEditWinnerOverlaysSchema.optional()
+  winnerOverlays: AiEditWinnerOverlaysSchema.optional(),
+  /** Optional market-format overlays; absent without an applied format. */
+  marketFormatOverlays: AiEditMarketFormatOverlaysSchema.optional()
 });
 var AiEditOutputsSchema = z5.object({
   editKey: z5.string(),
@@ -5054,8 +5111,11 @@ var COUNTRY_NAME_TO_ISO2 = {
 var COUNTRY_NAME_ALIASES = {
   usa: "united states",
   "estados unidos": "united states",
+  estadosunidos: "united states",
+  unitedstates: "united states",
   uk: "united kingdom",
   "reino unido": "united kingdom",
+  unitedkingdom: "united kingdom",
   brasil: "brazil",
   espana: "spain",
   alemania: "germany",
@@ -5108,6 +5168,7 @@ function normalizeToIso2(value) {
   return void 0;
 }
 __name(normalizeToIso2, "normalizeToIso2");
+var SUPPORTED_COUNTRY_ISO2 = new Set(Object.values(COUNTRY_NAME_TO_ISO2));
 var CountryIso2Schema = z11.preprocess(
   (value) => typeof value === "string" ? normalizeToIso2(value) ?? value : value,
   // The regex rejects unresolvable 2-unit garbage ('$$', '💩') that would
@@ -7660,6 +7721,13 @@ var CodeLandingCommerceSnapshotSchema = z23.object({
   compareAtPrice: z23.string().trim().min(1).max(500).optional(),
   /** Explicit removal survives projections that otherwise derive a comparison. */
   compareAtPriceRemoved: z23.literal(true).optional(),
+  /** Seller-confirmed prices by product option, never purchase quantities. */
+  offerVariants: z23.array(z23.object({
+    option: z23.string().trim().min(1).max(60),
+    value: z23.string().trim().min(1).max(60),
+    price: PublishCommerceValuesSchema.shape.unitPrice,
+    compareAtPrice: PublishCommerceValuesSchema.shape.unitPrice.nullable().optional()
+  }).strict()).max(20).optional(),
   /** Confirmed offer facts before Shopify supplies real chargeable variants. */
   offerPacks: z23.array(z23.object({
     units: z23.number().int().min(2).max(99),
@@ -10253,6 +10321,49 @@ var ObservedCommercialClaimSchema = z37.object({
     "other"
   ])
 }).strict();
+var CreativeFormatFramingSchema = z37.object({
+  shotSize: z37.enum([
+    "macro",
+    "close_up",
+    "medium",
+    "wide"
+  ]),
+  camera: z37.enum([
+    "static",
+    "handheld",
+    "selfie",
+    "moving"
+  ]),
+  faceVisible: z37.boolean()
+}).strict();
+var CompetitorCreativeFormatSchema = z37.object({
+  formatName: z37.string().trim().min(1).max(120),
+  renderTechnique: z37.string().trim().min(1).max(300),
+  visualWorld: z37.string().trim().min(1).max(600),
+  protagonist: z37.string().trim().min(1).max(300),
+  narrativeEngine: z37.string().trim().min(1).max(600),
+  beats: z37.array(z37.object({
+    atSec: z37.number().finite().nonnegative(),
+    beat: z37.string().trim().min(1).max(200),
+    /** What physically happens on camera, never its overlay text. */
+    visual: z37.string().trim().min(1).max(400),
+    /** Text, captions or graphics shown over that beat ("" = none). */
+    onScreenText: z37.string().trim().max(400).optional()
+  }).strict()).min(1).max(12),
+  hookDevice: z37.string().trim().min(1).max(600),
+  ctaDevice: z37.string().trim().min(1).max(600),
+  productRole: z37.string().trim().min(1).max(600),
+  tone: z37.string().trim().min(1).max(300),
+  editingPace: z37.string().trim().min(1).max(300),
+  confidence: z37.enum([
+    "high",
+    "medium",
+    "low"
+  ]),
+  /** ISO 639-1 of the spoken words, or "none" without speech. */
+  spokenLanguage: z37.string().trim().toLowerCase().regex(/^(?:[a-z]{2}|none)$/).optional(),
+  framing: CreativeFormatFramingSchema.optional()
+}).strict();
 var CompetitorCommercialProfileSchema = z37.object({
   durationSec: z37.number().finite().positive(),
   transcript: z37.string().max(2e4).optional(),
@@ -10278,7 +10389,9 @@ var CompetitorCommercialProfileSchema = z37.object({
     "incompatible",
     "uncertain"
   ]).optional(),
-  marketRelevanceEvidence: z37.string().trim().min(1).max(1e3).optional()
+  marketRelevanceEvidence: z37.string().trim().min(1).max(1e3).optional(),
+  /** Requested only for market-format studies; absent on every other path. */
+  creativeFormat: CompetitorCreativeFormatSchema.optional()
 }).strict();
 var MarketSceneIntentSchema = z37.object({
   id: z37.string().trim().min(1).max(80),
@@ -10336,6 +10449,99 @@ var CommercialMarketDossierSchema = z37.object({
   recipes: z37.array(MarketCreativeRecipeSchema).length(3),
   evidenceDisclaimer: z37.string().trim().min(1).max(1e3)
 }).strict();
+var MarketVoiceLineSchema = z37.object({
+  /** Quoted exactly as spoken in the source transcript, original language. */
+  text: z37.string().trim().min(1).max(400),
+  sourceId: z37.string().trim().min(1)
+}).strict();
+var MarketFormatVoiceSchema = z37.object({
+  hookLines: z37.array(MarketVoiceLineSchema).max(6),
+  ctaLines: z37.array(MarketVoiceLineSchema).max(6),
+  recurringPhrases: z37.array(z37.string().trim().min(1).max(200)).max(12),
+  topics: z37.array(z37.string().trim().min(1).max(200)).max(10),
+  rawness: z37.number().int().min(1).max(5)
+}).strict();
+var MarketFormatAnchorFrameSchema = z37.object({
+  index: z37.number().int().min(0).max(3),
+  assetKey: z37.string().trim().min(1).max(500),
+  timestampSec: z37.number().finite().nonnegative()
+}).strict();
+var MarketFormatPacingSchema = z37.object({
+  shotCount: z37.number().int().min(1).max(12),
+  secondsPerShot: z37.number().finite().positive().max(600),
+  editingPace: z37.string().trim().min(1).max(300).optional()
+}).strict();
+var MarketBeatExampleSchema = z37.object({
+  visual: z37.string().trim().min(1).max(400),
+  sourceId: z37.string().trim().min(1)
+}).strict();
+var MarketFormatDirectionSchema = z37.object({
+  id: z37.string().trim().min(1).max(80),
+  formatName: z37.string().trim().min(1).max(120),
+  anchorSourceId: z37.string().trim().min(1),
+  sourceIds: z37.array(z37.string().trim().min(1)).min(1).max(20),
+  advertiserCount: z37.number().int().positive(),
+  weightShare: z37.number().finite().min(0).max(1),
+  advertiserShare: z37.number().finite().min(0).max(1),
+  visualStyle: z37.string().trim().min(1).max(600),
+  protagonist: z37.string().trim().min(1).max(300),
+  narrative: z37.string().trim().min(1).max(600),
+  storyLine: z37.string().trim().min(1).max(600),
+  beats: z37.array(z37.object({
+    beat: z37.string().trim().min(1).max(200),
+    /** The on-camera action to stage (a CTA action included). */
+    visual: z37.string().trim().min(1).max(600),
+    /** Graphics for the optional edit ("" = none); never staged. */
+    onScreenText: z37.string().trim().max(400).optional(),
+    /** How different member ads stage this shared beat. */
+    examples: z37.array(MarketBeatExampleSchema).max(4).optional()
+  }).strict()).min(2).max(10),
+  hook: z37.string().trim().min(1).max(600),
+  cta: z37.string().trim().min(1).max(600),
+  productRole: z37.string().trim().min(1).max(600),
+  adaptToProduct: z37.string().trim().min(1).max(1e3),
+  doNotCopy: z37.array(z37.string().trim().min(1).max(300)).max(10),
+  whyThisFormat: z37.string().trim().min(1).max(1e3),
+  voice: MarketFormatVoiceSchema.optional(),
+  anchorFrames: z37.array(MarketFormatAnchorFrameSchema).max(4).optional(),
+  /** Server-owned: the anchor ad's framing, binding for the director. */
+  framing: CreativeFormatFramingSchema.optional(),
+  /** Server-owned: the anchor ad's cut rhythm, binding for the director. */
+  pacing: MarketFormatPacingSchema.optional(),
+  /** Server-owned: no member speaks the target market's language. */
+  languageFallback: z37.boolean().optional()
+}).strict();
+var MarketMenuItemSchema = z37.object({
+  kind: z37.string().trim().min(1).max(120),
+  description: z37.string().trim().min(1).max(400),
+  lines: z37.array(MarketVoiceLineSchema).max(4).optional(),
+  sourceIds: z37.array(z37.string().trim().min(1)).min(1).max(20),
+  advertiserCount: z37.number().int().positive(),
+  weightShare: z37.number().finite().min(0).max(1)
+}).strict();
+var MarketCreativeMenuSchema = z37.object({
+  hooks: z37.array(MarketMenuItemSchema).max(6),
+  ctas: z37.array(MarketMenuItemSchema).max(6),
+  visualStyles: z37.array(MarketMenuItemSchema).max(6),
+  demos: z37.array(MarketMenuItemSchema).max(8),
+  rhythms: z37.array(MarketMenuItemSchema).max(4)
+}).strict();
+var MarketCreativeDirectionSchema = z37.object({
+  version: z37.literal("1.0.0"),
+  sourceSnapshotHash: z37.string().trim().min(1),
+  evidenceSource: z37.enum([
+    "dropkiller",
+    "meta",
+    "mixed"
+  ]),
+  analyzedVideoCount: z37.number().int().positive(),
+  advertiserCount: z37.number().int().positive(),
+  /** Dropi units sold in 30 days across confirmed listings, when known. */
+  productSoldUnits30d: z37.number().int().nonnegative().optional(),
+  formats: z37.array(MarketFormatDirectionSchema).min(1).max(3),
+  /** The market's recurring hooks, CTAs, styles, demos and rhythms. */
+  menu: MarketCreativeMenuSchema.optional()
+}).strict();
 var MarketPersuasionDeviceSchema = z37.object({
   /** Verbatim hook/CTA/market pattern from the persisted dossier. */
   sourcePattern: z37.string().trim().min(1).max(1e3),
@@ -10544,6 +10750,24 @@ var CreativeEngineWinnerContextSchema = z38.object({
     }).strict()).max(24)
   }).strict().optional()
 }).strict();
+var CreativeEngineMarketPickSchema = z38.object({
+  kind: z38.string().trim().min(1).max(120),
+  description: z38.string().trim().min(1).max(400),
+  /** A verbatim market line to adapt (hooks and CTAs). */
+  line: z38.string().trim().min(1).max(400).optional(),
+  sourceId: id2
+}).strict();
+var CreativeEngineMarketSelectionSchema = z38.object({
+  version: z38.literal(1),
+  formatId: id2,
+  /** The member ad shown as one example of the format, never a template. */
+  exampleSourceId: id2,
+  hook: CreativeEngineMarketPickSchema.optional(),
+  cta: CreativeEngineMarketPickSchema.optional(),
+  visualStyle: CreativeEngineMarketPickSchema.optional(),
+  demo: CreativeEngineMarketPickSchema.optional(),
+  rhythm: CreativeEngineMarketPickSchema.optional()
+}).strict();
 var CreativeEngineMarketInputSchema = z38.object({
   version: z38.literal(1),
   /** The dossier's own snapshot hash (not necessarily hex-64). */
@@ -10572,7 +10796,22 @@ var CreativeEngineMarketInputSchema = z38.object({
     ])
   }).strict()).max(64),
   /** Validated when it names a recipe actually present in `recipes`. */
-  marketRecipeId: id2.optional()
+  marketRecipeId: id2.optional(),
+  /**
+   * Market formats flag only: formats #1..#3 (HOW the video looks and flows)
+   * with the anchor ad's transcript. Absent keeps the historical context.
+   */
+  formats: z38.array(MarketFormatDirectionSchema.extend({
+    anchorTranscript: z38.string().max(2e4).optional()
+  }).strict()).min(1).max(3).optional(),
+  /** The format the server binds; the director may drop to the next with a reason. */
+  marketFormatId: id2.optional(),
+  /**
+   * Market formats only: the combination sampled for this creative by market
+   * weight (format, hook, CTA, style, demo, example member), seeded by the
+   * task so a retry repeats it and sibling creatives vary inside the market.
+   */
+  marketSelection: CreativeEngineMarketSelectionSchema.optional()
 }).strict();
 var CreativeEngineCommercialExecutionSchema = z38.discriminatedUnion("mode", [
   z38.object({
@@ -10581,7 +10820,17 @@ var CreativeEngineCommercialExecutionSchema = z38.discriminatedUnion("mode", [
     mode: z38.literal("market"),
     sourceSnapshotHash: z38.string().min(1).max(200),
     recipeId: id2,
-    sourceIds: z38.array(id2).min(1).max(64)
+    sourceIds: z38.array(id2).min(1).max(64),
+    /** The market format actually applied (context `market.formats` only). */
+    formatId: id2.optional(),
+    /** Each format beat mapped onto the authored scene/beats. */
+    beatMap: z38.array(z38.object({
+      formatBeatIndex: z38.number().int().nonnegative(),
+      targetSceneId: id2,
+      targetBeatIds: z38.array(id2).max(16)
+    }).strict()).min(1).max(10).optional(),
+    /** Required only when formatId is not the server-bound format. */
+    formatFallbackReason: z38.string().min(1).max(500).optional()
   }).strict(),
   z38.object({
     version: z38.literal(1),
@@ -15283,8 +15532,13 @@ var AdminQualityReportSummary = z53.object({
   mixTaskId: z53.string().nullable(),
   kind: QualityReportKind,
   // Historical rows can contain `quality` in the DB's free-text reason column.
+  // Support refunds can also contain `generation_failed`, presented as `other`.
   // Normalize only on read; new submissions keep the strict QualityReportReason enum.
-  reason: z53.preprocess((value) => value === "quality" ? "unacceptable_quality" : value, QualityReportReason),
+  reason: z53.preprocess((value) => {
+    if (value === "quality") return "unacceptable_quality";
+    if (value === "generation_failed") return "other";
+    return value;
+  }, QualityReportReason),
   status: QualityReportStatus,
   estimatedCostCents: z53.number().nullable(),
   refundedCents: z53.number().nullable(),
@@ -21328,6 +21582,24 @@ var CAPABILITY_MODEL_GUIDANCE = {
       "solo lectura; un d\xEDa sin conteos usa la tasa estimada"
     ]
   },
+  get_product_ads: {
+    summary: "Muestra cada anuncio (\xE1ngulo de venta) de un producto en un d\xEDa, con cifras de Meta y qu\xE9 hacer con \xE9l.",
+    useWhen: [
+      "cu\xE1l de mis anuncios est\xE1 vendiendo",
+      "qu\xE9 anuncio apago",
+      "c\xF3mo le fue a cada \xE1ngulo ayer"
+    ],
+    avoidWhen: [
+      "pregunta por el producto entero: get_product_control"
+    ],
+    defaults: [
+      "el id sale de get_product_control, nunca se inventa",
+      "compras del p\xEDxel de Meta, no pedidos de la tienda"
+    ],
+    disclosures: [
+      "solo lectura; nunca pausa ni modifica un anuncio"
+    ]
+  },
   report_product_counts: {
     summary: "Registra lo que de verdad pas\xF3 con un producto en un d\xEDa: pedidos, cancelados, entregados y devueltos.",
     useWhen: [
@@ -22708,6 +22980,76 @@ var CreateManualProductControlResponseSchema = z100.object({
   productControlId: z100.string().guid(),
   created: z100.boolean()
 });
+var ProductControlAdsQuerySchema = z100.object({
+  date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/)
+});
+var PRODUCT_CONTROL_AD_VERDICTS = [
+  "keep",
+  "turn_off",
+  "review",
+  "no_data"
+];
+var ProductControlAdVerdictSchema = z100.enum(PRODUCT_CONTROL_AD_VERDICTS);
+var PRODUCT_CONTROL_AD_REASONS = [
+  "sells_within_break_even",
+  "sells_above_break_even",
+  "spent_break_even_without_sales",
+  "low_spend_no_sales",
+  "no_spend",
+  "missing_break_even",
+  "unknown_purchases",
+  "different_time_zone"
+];
+var ProductControlAdReasonSchema = z100.enum(PRODUCT_CONTROL_AD_REASONS);
+var metric = z100.number().finite().nonnegative().nullable();
+var ProductControlAdSchema = z100.object({
+  adId: z100.string(),
+  campaignId: z100.string(),
+  accountId: z100.string(),
+  name: z100.string(),
+  /** `effective_status` de Meta (ACTIVE, PAUSED, …), tal cual. */
+  status: z100.string().nullable(),
+  thumbnailUrl: z100.string().url().nullable(),
+  creativeKind: z100.enum([
+    "video",
+    "image",
+    "unknown"
+  ]),
+  adsManagerUrl: z100.string().url(),
+  spend: metric,
+  impressions: metric,
+  clicks: metric,
+  ctr: metric,
+  landingPageViews: metric,
+  viewContent: metric,
+  initiatedCheckout: metric,
+  /** Compras del píxel (`offsite_conversion.fb_pixel_purchase`). */
+  purchases: metric,
+  costPerPurchase: metric,
+  videoPlays: metric,
+  videoP25: metric,
+  videoP75: metric,
+  videoP100: metric,
+  /** p100 / reproducciones; `null` si no es vídeo o no hubo reproducciones. */
+  completionRate: z100.number().finite().min(0).max(1).nullable(),
+  verdict: ProductControlAdVerdictSchema,
+  reason: ProductControlAdReasonSchema
+});
+var ProductControlAdsStatusSchema = z100.enum([
+  "ok",
+  "no_meta_campaign",
+  "meta_not_connected",
+  "unavailable"
+]);
+var ProductControlAdsResponseSchema = z100.object({
+  productControlId: z100.string(),
+  date: z100.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  status: ProductControlAdsStatusSchema,
+  currency: z100.string().nullable(),
+  /** Publicidad máxima por compra para no perder (CPA de equilibrio). */
+  breakEvenCpa: z100.number().finite().nonnegative().nullable(),
+  ads: z100.array(ProductControlAdSchema)
+});
 
 // ../../packages/types/src/productmaker-capability-registry.ts
 var SHARED_CHANNEL_EXPOSURE = {
@@ -24498,6 +24840,20 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "product_control_report"
   ]),
+  defineCapability("get_product_ads", "df2873f9776f34f8a5a4c02b2878fbd6fb6ed1cfd9998cf728603b2bbd10069b", "none", "read_only", [
+    "read"
+  ], [
+    slot("product_control", true, [
+      "productControlId"
+    ]),
+    slot("day", true, [
+      "date"
+    ])
+  ], [
+    "product_control"
+  ], [
+    "product_control_ads"
+  ], MCP_ONLY_CHANNEL_EXPOSURE),
   defineCapability("report_product_counts", "8fa2561901b7743506a3639038d7806186c0512470bc6988a54c6bee5dbbb0b0", "state_change", "business", [
     "state_change"
   ], [
@@ -29314,7 +29670,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.5.0";
+var MCP_VERSION = "12.6.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -39409,6 +39765,7 @@ import { readFile, stat } from "fs/promises";
 import { basename as basename2, isAbsolute, resolve as resolve3 } from "path";
 import { z as z155 } from "zod";
 var getProductControlGuidance = getProductMakerCapabilityModelGuidance("get_product_control");
+var getProductAdsGuidance = getProductMakerCapabilityModelGuidance("get_product_ads");
 var listImportableProductsGuidance = getProductMakerCapabilityModelGuidance("list_importable_products");
 var importProductControlsGuidance = getProductMakerCapabilityModelGuidance("import_product_controls");
 var setProductCostingGuidance = getProductMakerCapabilityModelGuidance("set_product_costing");
@@ -39436,6 +39793,10 @@ var ProductControlListInput = z155.object({
   date: DateOnly2.optional().describe("D\xEDa final de la ventana (YYYY-MM-DD). Si se omite, termina en el \xFAltimo d\xEDa cerrado \u2014 nunca hoy, que est\xE1 incompleto."),
   shopDomain: z155.string().min(1).optional().describe("Tienda, si tiene m\xE1s de una conectada.")
 }).strict();
+var ProductAdsInput = z155.object({
+  productControlId: z155.string().uuid().describe("El `productControlId` que devuelve get_product_control."),
+  date: DateOnly2.describe("D\xEDa a leer (YYYY-MM-DD).")
+}).strict();
 var ImportableProductsInput = z155.object({
   q: z155.string().trim().max(120).optional().describe("B\xFAsqueda por t\xEDtulo. Sin esto un cat\xE1logo grande es inrecorrible."),
   after: z155.string().max(512).optional().describe("Cursor de la p\xE1gina anterior, tal como vino en la respuesta."),
@@ -39563,6 +39924,20 @@ function registerProductControlTools(server, api, { transport = "http" } = {}) {
       throw translateError(error);
     }
   });
+  server.registerTool("get_product_ads", {
+    description: getProductAdsGuidance.summary + " Devuelve cada anuncio de las campa\xF1as de Meta enlazadas al producto, con sus cifras DE META ese d\xEDa: gasto, impresiones, clics, CTR, visitas a la landing, view content, inicios de pago, compras del p\xEDxel, costo por compra y retenci\xF3n del v\xEDdeo (reproducciones, 25/75/100 % y `completionRate`). `verdict` es lo que la pantalla le sugiere: `keep` (mantener), `turn_off` (apagar), `review` (revisar) y `no_data` (todav\xEDa no hay con qu\xE9 juzgarlo); `reason` dice por qu\xE9, y el umbral es `breakEvenCpa`, la publicidad m\xE1xima por compra para no perder. Las compras del p\xEDxel NO son los pedidos de la tienda: el producto se decide con get_product_control y los anuncios se comparan entre s\xED con esto, porque un pedido contraentrega no dice de qu\xE9 anuncio vino. `status` distinto de `ok` no trae anuncios: `meta_not_connected` (conectar Meta), `no_meta_campaign` (enlazar campa\xF1a) o `unavailable` (Meta no respondi\xF3). Si falta un dato o Meta no respondi\xF3 y el usuario tiene su propio MCP de Meta, complementa ah\xED y di de d\xF3nde sale cada cifra. Es READ-ONLY: nunca pausa ni modifica un anuncio; apagar lo decide y lo hace ella en Meta.",
+    inputSchema: ProductAdsInput.shape,
+    annotations: READS_EXTERNAL
+  }, async (input) => {
+    try {
+      const params = new URLSearchParams({
+        date: input.date
+      });
+      return asText(await api.getJson(`/v1/product-control/${encodeURIComponent(input.productControlId)}/ads?${params.toString()}`));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
   server.registerTool("get_finances", {
     description: getFinancesGuidance.summary + ' Contesta la pregunta que de verdad importa --- \xABeste negocio gana plata?\xBB --- con el mes armado: ventas totales y entregadas, fletes, costo de los productos, utilidad bruta, publicidad, gastos fijos y utilidad NETA. Esa utilidad es ANTES de impuestos y hay que decirlo asi: el contador es un gasto mas, no un calculo nuestro. Trae tambien los porcentajes contra sus metas. Si `deliveredSalesKnown` no es true, faltan importes de ventas entregadas: la utilidad y los m\xE1rgenes no est\xE1n completos. `grossSalesKnown` distinto de true indica ventas totales parciales. Si `costsKnown` viene en `false`, esos pedidos llegaron de una fuente que NO sabe cuanto costaron \u2014la tienda, o la API del proveedor\u2014 y la utilidad BRUTA esta incompleta: no es que el producto salga gratis. Si `adSpendKnown` viene en `false`, la publicidad NO se pudo leer y la utilidad esta INCOMPLETA: dilo antes de que alguien celebre un mes que perdio plata. `adSpendSource: "user"` significa que ella corrigio la cifra a mano, y eso se revisa distinto de una leida. Si `unconfirmedExpenses` es mayor que cero, ese monto viene heredado del mes pasado y ella no lo ha revisado. Es READ-ONLY: nunca pausa ni modifica una campana. Si viene `costEstimate` con `source: "product_costing"`, presenta sus importes como ESTIMACI\xD3N antes de impuestos, usando los costos actuales configurados del producto: no son costos reales confirmados de esos pedidos. Conserva el aviso de `costsKnown: false` y distingue esta estimaci\xF3n de los importes reales del libro. `linesEstimated` indica cu\xE1ntas l\xEDneas usan costos configurados. La API s\xF3lo ofrece esta estimaci\xF3n cuando cubre todos los costos faltantes con perfiles asociados del mismo pa\xEDs y moneda, y conoce ventas entregadas, publicidad y gastos revisados. Si `costEstimate` es null o no existe, no inventes una estimaci\xF3n ni completes importes faltantes.',
     inputSchema: GetFinancesInput.shape,

package/package.json

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