@productmaker/mcp 12.4.1 → 12.6.0

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
@@ -6108,7 +6169,8 @@ var LANDING_STRATEGIES = [
 var LandingStrategySchema = z14.enum(LANDING_STRATEGIES);
 var SELECTABLE_LANDING_STRATEGIES = [
   "classic",
-  "social_proof"
+  "social_proof",
+  "pain_solution"
 ];
 var SelectableLandingStrategySchema = z14.enum(SELECTABLE_LANDING_STRATEGIES);
 var EffectiveLandingStrategySchema = LandingStrategySchema.exclude([
@@ -6389,6 +6451,13 @@ var CODE_LANDING_USAGE_VARIANTS = [
   "steps"
 ];
 var CodeLandingUsageVariantSchema = z16.enum(CODE_LANDING_USAGE_VARIANTS);
+var CODE_LANDING_BUY_BOX_FORMATS = [
+  "classic",
+  "benefits",
+  "impact",
+  "pop"
+];
+var CodeLandingBuyBoxFormatSchema = z16.enum(CODE_LANDING_BUY_BOX_FORMATS);
 var CodeLandingRecipeVariantsSchema = z16.object({
   hero: CodeLandingHeroVariantSchema,
   "benefits-grid": CodeLandingBenefitsVariantSchema,
@@ -6429,7 +6498,8 @@ var CodeLandingRecipePlanFields = {
 var CodeLandingRecipeProposalSchema = z16.object(CodeLandingRecipePlanFields).strict();
 var CodeLandingRecipePlanObjectSchema = z16.object({
   version: z16.literal(1),
-  ...CodeLandingRecipePlanFields
+  ...CodeLandingRecipePlanFields,
+  buyBoxFormat: CodeLandingBuyBoxFormatSchema.optional()
 }).strict();
 function hasDuplicateIds(ids) {
   return new Set(ids).size !== ids.length;
@@ -7876,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),
@@ -8653,6 +8730,16 @@ var LandingEditAttachmentDto = z23.object({
   width: z23.number().int().positive().nullable(),
   height: z23.number().int().positive().nullable()
 });
+var ApplyLandingCarouselGifRequest = z23.object({
+  attachmentId: z23.string().uuid(),
+  expectedRevision: z23.number().int().nonnegative(),
+  idempotencyKey: z23.string().uuid()
+}).strict();
+var ApplyLandingCarouselGifResponse = z23.object({
+  artifact: CodeLandingArtifactSchema,
+  appliedRevision: z23.number().int().positive(),
+  replayed: z23.boolean()
+});
 var UploadLandingEditAttachmentResponse = z23.object({
   attachment: LandingEditAttachmentDto
 });
@@ -10459,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(),
@@ -10484,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),
@@ -10542,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),
@@ -10750,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). */
@@ -10778,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({
@@ -10787,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),
@@ -11491,6 +11759,13 @@ var CreativeEngineRepairAuthorContractRetrySchema = z38.object({
   requestedAtMs: z38.number().int().nonnegative(),
   token: id2
 }).strict();
+var CreativeEngineReplanAuthorContractRetrySchema = z38.object({
+  failedOperationId: id2,
+  planHash: hash,
+  context: CreativeEngineContextBindingSchema,
+  requestedAtMs: z38.number().int().nonnegative(),
+  token: id2
+}).strict();
 var CreativeEngineCompositionRepairSchema = z38.object({
   reviewId: id2,
   outputHash: hash,
@@ -11624,6 +11899,7 @@ var CreativeEngineStateSchema = z38.object({
     token: id2
   }).strict().optional(),
   repairAuthorContractRetry: CreativeEngineRepairAuthorContractRetrySchema.optional(),
+  replanAuthorContractRetry: CreativeEngineReplanAuthorContractRetrySchema.optional(),
   final: CreativeEngineFinalSchema.optional()
 }).strict().superRefine((state, ctx) => {
   const repairAuthorContractRetry = state.repairAuthorContractRetry;
@@ -11782,6 +12058,13 @@ var CreativeEngineEventSchema = z38.discriminatedUnion("type", [
     context: CreativeEngineContextBindingSchema,
     token: id2
   }).strict(),
+  z38.object({
+    type: z38.literal("replan_author_contract_retry_requested"),
+    failedOperationId: id2,
+    planHash: hash,
+    context: CreativeEngineContextBindingSchema,
+    token: id2
+  }).strict(),
   z38.object({
     type: z38.literal("repair_author_contract_retry_requested"),
     failedOperationId: id2,
@@ -12029,10 +12312,10 @@ import { z as z40 } from "zod";
 var MAX_BILLING_DECIMAL_PLACES = 10;
 function countDecimalPlaces(value) {
   if (!Number.isFinite(value)) return MAX_BILLING_DECIMAL_PLACES + 1;
-  const normalized = value.toString();
+  let normalized = value.toString();
   if (/e/i.test(normalized)) {
-    const fixed = value.toFixed(MAX_BILLING_DECIMAL_PLACES);
-    return countDecimalPlaces(Number(fixed));
+    if (Math.abs(value) >= 1e21) return 0;
+    normalized = value.toFixed(MAX_BILLING_DECIMAL_PLACES);
   }
   const parts = normalized.split(".");
   if (parts.length < 2) return 0;
@@ -14575,6 +14858,8 @@ var CostEstimationRequest = z50.discriminatedUnion("type", [
 var CostEstimationResponse = z50.object({
   /** Server confirms the range includes the first generated classic-landing GIF. */
   includesInitialLandingGif: z50.boolean().optional(),
+  /** The initial-GIF choice is offerable for this config (code landings only quote it after explicit consent). */
+  initialLandingGifOffered: z50.boolean().optional(),
   estimatedCostCents: z50.number().nonnegative(),
   estimatedCostCredits: z50.number().int().nonnegative(),
   /** Scan-only midpoint; excludes generating a winner replica. Not an admission limit. */
@@ -15472,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(),
@@ -21517,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: [
@@ -22897,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 = {
@@ -23177,7 +23555,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     // MCP 8.10.0: storyteller family blocked (BLOCKED_NARRATIVE_STYLES).
     // MCP 9.1.0: combine current animated-video controls and initial GIF choice.
     // MCP 12.4.0: landingStrategy narrowed to classic + social_proof.
-    "5a6dd48977702dbb92a315fb668054f13918fd1cfae5056de82e94144e6f5804",
+    // MCP 12.5.0: pain_solution restored to landingStrategy.
+    "68a740d97238e720000c16db56ae5748ceb560e342f8fbfe605c954e6284fda7",
     "credit_consuming",
     "creative",
     [
@@ -23623,7 +24002,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   defineCapability(
     "generate_landing",
     // MCP 12.4.0: guided landingStrategy narrowed to classic + social_proof.
-    "6db8df9db5410d0abe0f44da7027af4cc40aff37ef6e66e82164edbd889eeb63",
+    // MCP 12.5.0: pain_solution restored to guided landingStrategy.
+    "16c4e1ea0cd12ee3367e06b4f73a177c94e16ab7d5323d971d577301ba2c7b70",
     "credit_consuming",
     "creative",
     [
@@ -24685,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"
   ], [
@@ -30949,7 +31343,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "12.4.1";
+var MCP_VERSION = "12.6.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -34810,7 +35204,7 @@ var CreateProductTaskInput = z138.object({
   creativeDirection: z138.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.'),
   headline: z138.string().max(120).optional().describe("Opcional. Titular EXACTO a renderizar. Se imprime tal cual: la IA no lo reescribe, no lo acorta y no lo traduce. Se aplica a las IM\xC1GENES y a la portada de la landing de esta task (el video no lo usa; para el video usa scriptNotes). \xDAsalo cuando el copy es de marca y no es negociable. M\xE1x 120 caracteres. Si lo omites, la IA escribe el titular."),
   subheadline: z138.string().max(160).optional().describe("Opcional. Subt\xEDtulo EXACTO a renderizar, misma regla que headline. Independiente: puedes fijar solo el subt\xEDtulo. M\xE1x 160 caracteres."),
-  landingStrategy: LandingStrategyEnum.optional().describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (Landing cl\xE1sica de ProductMaker: estructura original probada y recomendada) o "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social). Default "classic".'),
+  landingStrategy: LandingStrategyEnum.optional().describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (Landing cl\xE1sica de ProductMaker: estructura original probada y recomendada) , "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social) o "pain_solution" (Problema y soluci\xF3n: dolor reconocible, demostraci\xF3n y transformaci\xF3n). 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 CreateServiceVideoInput = z138.object({
@@ -40886,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");
@@ -40913,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."),
@@ -41040,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,