@productmaker/mcp 2.2.0 → 2.3.1

package/dist/stdio.js

@@ -150,7 +150,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "2.2.0";
+var MCP_VERSION = "2.3.1";
 
 // src/tools/tasks.ts
 import { z as z40 } from "zod";
@@ -932,7 +932,7 @@ var Product = z4.object({
 });
 
 // ../../packages/types/src/ingest.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 
 // ../../packages/types/src/video-tier.ts
 import { z as z5 } from "zod";
@@ -944,18 +944,204 @@ var VideoTier = z5.preprocess((v) => v === "grok" ? "single_call" : v, z5.enum([
 ]));
 var DEFAULT_VIDEO_TIER = "single_call";
 
+// ../../packages/types/src/angle.ts
+import { z as z6 } from "zod";
+var ImageWinnerSignal = z6.enum([
+  "winner",
+  "opportunity",
+  "saturated_twist"
+]);
+var WinnerVisualMode = z6.enum([
+  "auto",
+  "inspired",
+  "original"
+]);
+var AnchoredIntel = z6.object({
+  painPointIndices: z6.array(z6.number().int().nonnegative()).max(10),
+  hookIndices: z6.array(z6.number().int().nonnegative()).max(10),
+  claimIndices: z6.array(z6.number().int().nonnegative()).max(10),
+  sourceAngleType: z6.enum([
+    "gap",
+    "validated_local",
+    "saturated_differentiated",
+    "novel"
+  ]),
+  // SNAPSHOT of the resolved intel strings at angle-generation time.
+  // Indices reference into Task.competitorIntel which we treat as immutable
+  // post-scan, but defensive: a future re-scan path that rewrites
+  // Task.competitorIntel would invalidate the indices silently. Persisting
+  // the resolved strings ALONGSIDE the indices means downstream consumers
+  // (script writer, landing copy) can safely use the strings directly
+  // without re-resolving — staleness-immune. The indices remain useful for
+  // analytics ("which intel items did angles cite?") and as a sanity-check.
+  resolvedPainPoints: z6.array(z6.string()).max(10).optional(),
+  resolvedHooks: z6.array(z6.string()).max(10).optional(),
+  resolvedClaims: z6.array(z6.string()).max(10).optional(),
+  /**
+  * Free-form pillar name describing the AXIS of the product this angle
+  * attacks (e.g. "ciencia/mecanismo", "tiempo/ritual", "comparación-con-
+  * alternativas", "social-proof", "dolor-emocional", "identidad/persona").
+  * The LLM picks the label — we do NOT lock an enum because the right
+  * pillar taxonomy varies per product (a supplement's "mecanismo" pillar
+  * is different from a gadget's "fricción de uso"). Constraint enforced
+  * at generation time: the 3 angles emitted for one task MUST use 3
+  * DISTINCT pillars (anti-convergence). Lives inside AnchoredIntel because
+  * it ships as analytics metadata alongside the anchoredIntel sourceType +
+  * indices, and persists as JSON without a column migration. Optional
+  * because angles persisted before this change have no pillar.
+  */
+  pillar: z6.string().min(1).max(60).optional(),
+  // Telemetry: why the angle did NOT import a gapAngle. The legacy single value
+  // 'none_relevant' was OVERLOADED (it meant "no gaps existed" AND "gaps existed
+  // but none fit" AND was the sanitizer default) which made the gap feature
+  // unmeasurable. Split into distinct, one-meaning-each states:
+  //   - persona_mismatch / product_mismatch: the LLM saw gaps and judged them a
+  //     wrong-persona / wrong-subcategory fit (trusted from the LLM).
+  //   - no_gaps_in_block: there were no gapAngles in the block (or no block).
+  //   - gaps_present_not_imported: gaps existed and the angle went novel anyway
+  //     (the sanitizer's honest default when the LLM didn't pick persona/product).
+  //   - gaps_all_filtered_noise: the reference HAD gaps but every one was dropped
+  //     as detection noise (retailer-meta/cross-category) so the LLM saw none.
+  //   - n_a: the angle imported a gap (sourceAngleType="gap"), so "why skipped"
+  //     is moot.
+  // The deterministic gap-presence states (no_gaps_in_block / gaps_present_not_
+  // imported / gaps_all_filtered_noise) are set by sanitizeAnchoredIntel from
+  // facts it computes (intel.gapAngles.length, intel.gapAnglesFilteredCount), NOT
+  // trusted from the lazy LLM. z.preprocess aliases historical 'none_relevant'
+  // rows → 'no_gaps_in_block' so the JSON column parses with no migration.
+  // Analytics-only: NO runtime path branches on this value.
+  skippedGapReason: z6.preprocess((v) => v === "none_relevant" ? "no_gaps_in_block" : v, z6.enum([
+    "persona_mismatch",
+    "product_mismatch",
+    "no_gaps_in_block",
+    "gaps_present_not_imported",
+    "gaps_all_filtered_noise",
+    "n_a"
+  ])).optional(),
+  // Telemetry: captures the prod-observed case where a "novel" angle actually
+  // reflects a GAP's theme/promise without formally anchoring indices (gapAngles
+  // are a separate array, not index-cited, so a real gap import is reclassified
+  // 'novel' by the empty-indices coherence guard). Self-reported by the LLM:
+  //   - gap_imported: the angle's theme imports a gap's logic.
+  //   - product_derived: derived purely from the product.
+  //   - hybrid: a mix.
+  // SOFT analytics-only signal (the LLM may confabulate) — validated against
+  // known prod cases before trusting aggregates; never a control-flow input.
+  // Optional in storage; on the wire it ships as a required enum with a 'none'
+  // sentinel (strict structured output forbids optional properties) that the
+  // sanitizer maps to undefined.
+  themeSourceType: z6.enum([
+    "gap_imported",
+    "product_derived",
+    "hybrid"
+  ]).optional()
+});
+var Angle = z6.object({
+  angle: z6.string().min(1).max(480),
+  buyerPersona: z6.string().min(1).max(360),
+  /** Character description for video (role + appearance + attitude). Drives voice selection and Frame0Spec. */
+  actor: z6.string().min(1).max(360).optional(),
+  // Binary only: voice catalog has no non-binary voices.
+  // See packages/angles/src/index.ts + getAngles coercion in angle.repository.ts.
+  gender: z6.enum([
+    "female",
+    "male"
+  ]).optional(),
+  /** Per-angle user-supplied script/visual notes. Hydrated from the
+  *  `Angle.scriptNotes` DB column or the `angleVideoOptions[i].scriptNotes`
+  *  passed from the chat. Per-angle overrides global `videoScriptNotes`. */
+  scriptNotes: z6.string().max(2e3).optional(),
+  /** AI-chosen per-angle narrative (set by the batch selector in angles.worker).
+  *  Pre-fills the review dropdown; user can override per angle. */
+  narrativeStyle: NarrativeStyle.optional(),
+  /** See AnchoredIntel docs. Optional because angles persisted before this
+  *  change have no anchoring captured; new angles ALWAYS emit it (with empty
+  *  arrays + 'novel' when intel was unavailable). */
+  anchoredIntel: AnchoredIntel.optional(),
+  /** Server-computed: true when this angle is eligible for the gap_replication
+  *  narrative (isReplicationAngle(anchoredIntel, intel) && intel.gapBlueprint
+  *  present). Computed server-side (not derived client-side) because the web
+  *  only sees this angle's anchoredIntel, not the task's
+  *  competitorIntel.gapBlueprint. Gates the review dropdown's gap_replication
+  *  option — absent/false = hidden. */
+  gapReplicationEligible: z6.boolean().optional(),
+  /** Server-computed: true when this angle's effective narrative is
+  *  gap_replication, which FORCES the multi-shot STANDARD ("Multiescena")
+  *  render pipeline regardless of the task's chosen tier (single_call can't
+  *  produce the multi-shot replication — see task-results.service.ts and the
+  *  render-time tier override). Surfaces "renders in Multiescena" on the
+  *  review card so a single_call user isn't surprised by the STANDARD-tier
+  *  charge. */
+  rendersMultiShot: z6.boolean().optional(),
+  /** Server-computed product-level origin bucket for the review card's badge
+  *  (NOT the internal sourceAngleType taxonomy — see resolveAngleOrigin in
+  *  task-results.service.ts): 'gap' = market opportunity competitors aren't
+  *  using; 'saturated_twist' = competitors' most-used approach with our own
+  *  twist; 'ai_recommended' = AI-authored for this product (default). */
+  angleOrigin: z6.enum([
+    "gap",
+    "saturated_twist",
+    "ai_recommended"
+  ]).optional(),
+  /** Server-computed badge TIER for the replication angle (two-tier UX,
+  *  v1.32.0 — see resolveReplicationTier). 'winner' = a validated angle
+  *  opportunity backed by a proven ad (anchor gap/saturated → golden badge);
+  *  'opportunity' = a product-coherent replicable winner with no validated
+  *  angle gap (anchor 'dominant' → opportunity/twist badge, no overclaim).
+  *  Present only on the angle that carries gap_replication; absent otherwise. */
+  replicationTier: z6.enum([
+    "winner",
+    "opportunity"
+  ]).optional(),
+  /** Server-confirmed availability of a coherent, captured IMAGE winner for
+  *  this task. The review UI must not claim "anuncio ganador" from the user's
+  *  mode choice alone: fail-open scans may legitimately have no winner. */
+  imageWinnerAvailable: z6.boolean().optional(),
+  /** True when `winnerVisualMode=auto` will actually attach the image reference.
+  *  A single-image request requires `imageWinnerSignal="winner"`; a multi-image
+  *  portfolio may spend one experimental slot on opportunity/twist. Explicit
+  *  `inspired` may also apply it; `original` always suppresses it. */
+  imageWinnerAutoApplied: z6.boolean().optional(),
+  /** Server-authored evidence tier for the image reference. The UI renders
+  *  this on the inspired control and the selected strategy badge. */
+  imageWinnerSignal: ImageWinnerSignal.optional()
+});
+var AdVideo = z6.object({
+  source: z6.enum([
+    "tiktok_shop",
+    "meta_ads"
+  ]),
+  url: z6.string().url(),
+  title: z6.string().optional(),
+  description: z6.string().optional(),
+  metrics: z6.object({
+    impressions: z6.number().int().nonnegative().optional(),
+    views: z6.number().int().nonnegative().optional(),
+    likes: z6.number().int().nonnegative().optional(),
+    ctaClicks: z6.number().int().nonnegative().optional(),
+    diggCount: z6.number().int().nonnegative().optional(),
+    shareCount: z6.number().int().nonnegative().optional(),
+    commentCount: z6.number().int().nonnegative().optional(),
+    playCount: z6.number().int().nonnegative().optional(),
+    collectCount: z6.number().int().nonnegative().optional(),
+    durationSeconds: z6.number().int().nonnegative().optional()
+  }).partial().optional(),
+  country: z6.string().optional(),
+  lastSeen: z6.string().datetime().optional()
+});
+
 // ../../packages/types/src/creative.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 
 // ../../packages/types/src/landing.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 
 // ../../packages/types/src/landing-strategy.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // ../../packages/types/src/landing-role.ts
-import { z as z6 } from "zod";
-var LandingRole = z6.enum([
+import { z as z7 } from "zod";
+var LandingRole = z7.enum([
   "hero",
   "benefits1",
   "socialproof",
@@ -967,7 +1153,7 @@ var LandingRole = z6.enum([
   "authority",
   "logistics"
 ]);
-var LandingRoleLegacy = z6.enum([
+var LandingRoleLegacy = z7.enum([
   "hero",
   "benefits1",
   "benefits2",
@@ -993,7 +1179,7 @@ var LANDING_STRATEGIES = [
   "offer_value",
   "lifestyle_identity"
 ];
-var LandingStrategySchema = z7.enum(LANDING_STRATEGIES);
+var LandingStrategySchema = z8.enum(LANDING_STRATEGIES);
 var EffectiveLandingStrategySchema = LandingStrategySchema.exclude([
   "auto"
 ]);
@@ -1004,8 +1190,8 @@ var SEMANTIC_LANDING_STRATEGIES = [
   "offer_value",
   "lifestyle_identity"
 ];
-var SemanticLandingStrategySchema = z7.enum(SEMANTIC_LANDING_STRATEGIES);
-var LandingVisualStyleFamilySchema = z7.enum([
+var SemanticLandingStrategySchema = z8.enum(SEMANTIC_LANDING_STRATEGIES);
+var LandingVisualStyleFamilySchema = z8.enum([
   "editorial_dtc",
   "ugc_scrapbook",
   "technical_diagram",
@@ -1013,39 +1199,39 @@ var LandingVisualStyleFamilySchema = z7.enum([
   "warm_organic",
   "cinematic_problem_solution"
 ]);
-var LandingVisualTypographySchema = z7.enum([
+var LandingVisualTypographySchema = z8.enum([
   "serif_editorial",
   "sans_modern",
   "display_bold",
   "handwritten_warm"
 ]);
-var LandingVisualCompositionSchema = z7.enum([
+var LandingVisualCompositionSchema = z8.enum([
   "full_bleed",
   "editorial_panels",
   "cards_collage",
   "diagrammatic",
   "commerce_modules"
 ]);
-var LandingVisualImageTreatmentSchema = z7.enum([
+var LandingVisualImageTreatmentSchema = z8.enum([
   "studio_editorial",
   "phone_ugc",
   "documentary_lifestyle",
   "technical_macro",
   "high_contrast_direct_response"
 ]);
-var LandingVisualDensitySchema = z7.enum([
+var LandingVisualDensitySchema = z8.enum([
   "minimal",
   "balanced",
   "rich"
 ]);
-var LandingVisualSignatureSchema = z7.object({
+var LandingVisualSignatureSchema = z8.object({
   styleFamily: LandingVisualStyleFamilySchema,
   typography: LandingVisualTypographySchema,
   composition: LandingVisualCompositionSchema,
   imageTreatment: LandingVisualImageTreatmentSchema,
   density: LandingVisualDensitySchema,
-  paletteIntent: z7.string().trim().min(1).max(160),
-  recurringMotif: z7.string().trim().min(1).max(160)
+  paletteIntent: z8.string().trim().min(1).max(160),
+  recurringMotif: z8.string().trim().min(1).max(160)
 });
 var LANDING_SECTION_KEYS = [
   "problem_hook",
@@ -1087,18 +1273,18 @@ var LANDING_SECTION_KEYS = [
   "lifestyle_fit",
   "join_lifestyle"
 ];
-var LandingSectionKeySchema = z7.enum(LANDING_SECTION_KEYS);
-var LandingSectionPlanEntrySchema = z7.object({
+var LandingSectionKeySchema = z8.enum(LANDING_SECTION_KEYS);
+var LandingSectionPlanEntrySchema = z8.object({
   /** Stable persistence/regeneration identifier. Never shown to the user. */
   role: LandingRole,
   /** Strategy-specific section identity shown in UI and used by prompts. */
   sectionKey: LandingSectionKeySchema,
-  index: z7.number().int().min(1).max(10)
+  index: z8.number().int().min(1).max(10)
 });
-var LandingSectionPlanSchema = z7.array(LandingSectionPlanEntrySchema).superRefine((plan, ctx) => {
+var LandingSectionPlanSchema = z8.array(LandingSectionPlanEntrySchema).superRefine((plan, ctx) => {
   if (plan.length !== 7 && plan.length !== 10) {
     ctx.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       message: "sectionPlan must contain exactly 7 or 10 entries"
     });
   }
@@ -1107,13 +1293,13 @@ var LandingSectionPlanSchema = z7.array(LandingSectionPlanEntrySchema).superRefi
   const positions = new Set(plan.map((entry) => entry.index));
   if (roles.size !== plan.length) {
     ctx.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       message: "sectionPlan roles must be unique"
     });
   }
   if (keys.size !== plan.length) {
     ctx.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       message: "sectionPlan sectionKeys must be unique"
     });
   }
@@ -1122,48 +1308,50 @@ var LandingSectionPlanSchema = z7.array(LandingSectionPlanEntrySchema).superRefi
   }, (_, index) => index + 1);
   if (positions.size !== plan.length || !requiredPositions.every((position) => positions.has(position))) {
     ctx.addIssue({
-      code: z7.ZodIssueCode.custom,
+      code: z8.ZodIssueCode.custom,
       message: "sectionPlan indexes must be contiguous from 1 through plan length"
     });
   }
 });
 
 // ../../packages/types/src/landing.ts
-var LandingImageReadable = z8.object({
-  index: z8.number().int().min(1).max(20),
+var LandingImageReadable = z9.object({
+  index: z9.number().int().min(1).max(20),
   /** Child task that owns this image when variants are rendered alongside the root task. */
-  variantTaskId: z8.string().uuid().optional(),
+  variantTaskId: z9.string().uuid().optional(),
   role: LandingRoleLegacy,
   /** Strategy-specific display identity; absent on legacy tasks. */
   sectionKey: LandingSectionKeySchema.optional(),
-  url: z8.string().min(1),
-  width: z8.number().int(),
-  height: z8.number().int(),
-  notes: z8.string().optional()
+  url: z9.string().min(1),
+  width: z9.number().int(),
+  height: z9.number().int(),
+  notes: z9.string().optional()
 });
-var LandingImage = z8.object({
-  index: z8.number().int().min(1).max(10),
+var LandingImage = z9.object({
+  index: z9.number().int().min(1).max(10),
   role: LandingRole,
   sectionKey: LandingSectionKeySchema.optional(),
-  url: z8.string().min(1),
-  width: z8.number().int(),
-  height: z8.number().int(),
-  notes: z8.string().optional()
+  url: z9.string().min(1),
+  width: z9.number().int(),
+  height: z9.number().int(),
+  notes: z9.string().optional()
 });
 
 // ../../packages/types/src/creative.ts
-var VideoCreativeAspectRatio = z9.enum([
+var VideoCreativeAspectRatio = z10.enum([
   "16:9",
   "9:16",
   "Auto"
 ]);
-var ImageCreativeStyle = z9.enum([
+var PINNED_HEADLINE_MAX_CHARS = 120;
+var PINNED_SUBHEADLINE_MAX_CHARS = 160;
+var ImageCreativeStyle = z10.enum([
   "studio",
   "floating",
   "ingredients",
   "in_use"
 ]);
-var ImageCreativeArchetype = z9.enum([
+var ImageCreativeArchetype = z10.enum([
   "direct_response_product_ad",
   "hero_outcome",
   "offer_value_prop",
@@ -1172,215 +1360,228 @@ var ImageCreativeArchetype = z9.enum([
   "problem_solution",
   "lifestyle_identity"
 ]);
-var ImageCreativeVisualTreatment = z9.enum([
+var ImageCreativeVisualTreatment = z10.enum([
   "performance_product_ad",
   "premium_dtc_carousel"
 ]);
-var ImageCreativeAspectRatio = z9.enum([
+var ImageCreativeAspectRatio = z10.enum([
   "1:1",
   "4:5",
   "9:16",
   "16:9"
 ]);
-var VideoCreativeVariant = z9.object({
-  id: z9.string(),
-  assetKey: z9.string(),
-  url: z9.string().url().optional(),
-  thumbnailUrl: z9.string().url().optional(),
-  label: z9.string().optional(),
-  format: z9.string().optional()
-});
-var VideoCreativeVideo = z9.object({
-  provider: z9.string(),
-  model: z9.string(),
-  durationSeconds: z9.number().int().positive().optional(),
-  variants: z9.array(VideoCreativeVariant).default([]),
-  clipUrls: z9.array(z9.string().url()).optional(),
-  adCopy: z9.string().optional()
-});
-var VideoCreativeContext = z9.object({
-  productTitle: z9.string(),
-  primaryAngle: z9.string(),
-  buyerPersona: z9.string().optional(),
-  brandId: z9.string().uuid().optional(),
-  features: z9.array(z9.string()).default([]),
-  scriptNotes: z9.string().optional(),
-  cta: z9.string().optional(),
-  language: z9.string(),
+var VideoCreativeVariant = z10.object({
+  id: z10.string(),
+  assetKey: z10.string(),
+  url: z10.string().url().optional(),
+  thumbnailUrl: z10.string().url().optional(),
+  label: z10.string().optional(),
+  format: z10.string().optional()
+});
+var VideoCreativeVideo = z10.object({
+  provider: z10.string(),
+  model: z10.string(),
+  durationSeconds: z10.number().int().positive().optional(),
+  variants: z10.array(VideoCreativeVariant).default([]),
+  clipUrls: z10.array(z10.string().url()).optional(),
+  adCopy: z10.string().optional()
+});
+var VideoCreativeContext = z10.object({
+  productTitle: z10.string(),
+  primaryAngle: z10.string(),
+  buyerPersona: z10.string().optional(),
+  brandId: z10.string().uuid().optional(),
+  features: z10.array(z10.string()).default([]),
+  scriptNotes: z10.string().optional(),
+  cta: z10.string().optional(),
+  language: z10.string(),
   aspectRatio: VideoCreativeAspectRatio,
-  durationSeconds: z9.number().int().positive()
+  durationSeconds: z10.number().int().positive()
 });
-var VideoCreativeJobResult = z9.object({
+var VideoCreativeJobResult = z10.object({
   video: VideoCreativeVideo,
   context: VideoCreativeContext,
-  createdAt: z9.string().datetime().optional()
+  createdAt: z10.string().datetime().optional()
 });
-var VideoCreativeJobStatusEnum = z9.enum([
+var VideoCreativeJobStatusEnum = z10.enum([
   "pending",
   "processing",
   "completed",
   "error"
 ]);
-var VideoCreativeJobStatus = z9.object({
-  jobId: z9.string(),
+var VideoCreativeJobStatus = z10.object({
+  jobId: z10.string(),
   status: VideoCreativeJobStatusEnum,
-  progress: z9.number().min(0).max(100).optional(),
-  etaSeconds: z9.number().int().nonnegative().optional(),
-  message: z9.string().optional(),
-  error: z9.string().optional(),
+  progress: z10.number().min(0).max(100).optional(),
+  etaSeconds: z10.number().int().nonnegative().optional(),
+  message: z10.string().optional(),
+  error: z10.string().optional(),
   /**
   * Primary angle that the backend will use for generation.
   * Can be user-provided (request.primaryAngle) or generated (angles[0]).
   */
-  primaryAngle: z9.string().optional(),
-  primaryAngleSource: z9.enum([
+  primaryAngle: z10.string().optional(),
+  primaryAngleSource: z10.enum([
     "user",
     "generated"
   ]).optional(),
-  buyerPersona: z9.string().optional(),
+  buyerPersona: z10.string().optional(),
   result: VideoCreativeJobResult.nullable().optional()
 });
-var VideoCreativeJobPayload = z9.object({
-  jobId: z9.string().optional(),
+var VideoCreativeJobPayload = z10.object({
+  jobId: z10.string().optional(),
   status: VideoCreativeJobStatusEnum.optional(),
-  progress: z9.number().min(0).max(100).optional(),
-  etaSeconds: z9.number().int().nonnegative().optional(),
-  message: z9.string().optional(),
-  error: z9.string().optional(),
-  primaryAngle: z9.string().optional(),
-  primaryAngleSource: z9.enum([
+  progress: z10.number().min(0).max(100).optional(),
+  etaSeconds: z10.number().int().nonnegative().optional(),
+  message: z10.string().optional(),
+  error: z10.string().optional(),
+  primaryAngle: z10.string().optional(),
+  primaryAngleSource: z10.enum([
     "user",
     "generated"
   ]).optional(),
-  buyerPersona: z9.string().optional(),
+  buyerPersona: z10.string().optional(),
   result: VideoCreativeJobResult.nullable().optional()
 });
-var VideoCreativeHistoryEntry = z9.object({
-  id: z9.string(),
-  createdAt: z9.string().datetime(),
+var VideoCreativeHistoryEntry = z10.object({
+  id: z10.string(),
+  createdAt: z10.string().datetime(),
   status: VideoCreativeJobStatusEnum,
   result: VideoCreativeJobResult.nullable(),
-  error: z9.string().optional()
+  error: z10.string().optional()
+});
+var AdCreative = z10.object({
+  provider: z10.string(),
+  model: z10.string(),
+  prompt: z10.string().min(1),
+  url: z10.string().min(1),
+  width: z10.number().int().positive(),
+  height: z10.number().int().positive(),
+  error: z10.string().optional(),
+  variants: z10.array(z10.string().url()).optional(),
+  /** One-to-one with `variants`: null for ProductMaker-original images and the
+  *  evidence tier for the competitor-reference variant. */
+  variantSignals: z10.array(ImageWinnerSignal.nullable()).optional(),
+  createdAt: z10.string().datetime().optional(),
+  adCopy: z10.string().optional()
+}).superRefine((creative, ctx) => {
+  if (creative.variantSignals !== void 0 && (creative.variants === void 0 || creative.variantSignals.length !== creative.variants.length)) {
+    ctx.addIssue({
+      code: z10.ZodIssueCode.custom,
+      path: [
+        "variantSignals"
+      ],
+      message: "variantSignals must align one-to-one with variants"
+    });
+  }
 });
-var AdCreative = z9.object({
-  provider: z9.string(),
-  model: z9.string(),
-  prompt: z9.string().min(1),
-  url: z9.string().min(1),
-  width: z9.number().int().positive(),
-  height: z9.number().int().positive(),
-  error: z9.string().optional(),
-  variants: z9.array(z9.string().url()).optional(),
-  createdAt: z9.string().datetime().optional(),
-  adCopy: z9.string().optional()
-});
-var ImageCreativeCopy = z9.object({
-  title: z9.string().optional(),
-  subtitle: z9.string().optional(),
-  headline: z9.string().optional(),
-  bullets: z9.array(z9.string()).optional(),
-  discount: z9.string().optional(),
-  promoSticker: z9.string().optional(),
-  colors: z9.array(z9.string()).optional()
+var ImageCreativeCopy = z10.object({
+  title: z10.string().optional(),
+  subtitle: z10.string().optional(),
+  headline: z10.string().optional(),
+  bullets: z10.array(z10.string()).optional(),
+  discount: z10.string().optional(),
+  promoSticker: z10.string().optional(),
+  colors: z10.array(z10.string()).optional()
 }).partial();
-var ImageCreativeVariant = z9.object({
-  id: z9.string(),
-  url: z9.string().url(),
-  downloadUrl: z9.string().url().optional()
-});
-var ImageCreativeResult = z9.object({
-  provider: z9.string(),
-  model: z9.string(),
-  prompt: z9.string(),
-  width: z9.number().int().positive(),
-  height: z9.number().int().positive(),
-  variants: z9.array(ImageCreativeVariant).min(1),
+var ImageCreativeVariant = z10.object({
+  id: z10.string(),
+  url: z10.string().url(),
+  downloadUrl: z10.string().url().optional()
+});
+var ImageCreativeResult = z10.object({
+  provider: z10.string(),
+  model: z10.string(),
+  prompt: z10.string(),
+  width: z10.number().int().positive(),
+  height: z10.number().int().positive(),
+  variants: z10.array(ImageCreativeVariant).min(1),
   copy: ImageCreativeCopy.optional(),
-  createdAt: z9.string().datetime().optional(),
-  adCopy: z9.string().optional()
-});
-var ImageCreativeEditableRequest = z9.object({
-  price: z9.string(),
-  offer: z9.string(),
-  compareAtPrice: z9.string(),
-  country: z9.string()
+  createdAt: z10.string().datetime().optional(),
+  adCopy: z10.string().optional()
+});
+var ImageCreativeEditableRequest = z10.object({
+  price: z10.string(),
+  offer: z10.string(),
+  compareAtPrice: z10.string(),
+  country: z10.string()
 }).partial();
-var ImageCreativeJobStatusEnum = z9.enum([
+var ImageCreativeJobStatusEnum = z10.enum([
   "pending",
   "processing",
   "completed",
   "error"
 ]);
-var ImageCreativeJobStatus = z9.object({
-  jobId: z9.string().uuid(),
+var ImageCreativeJobStatus = z10.object({
+  jobId: z10.string().uuid(),
   status: ImageCreativeJobStatusEnum,
-  error: z9.string().optional(),
+  error: z10.string().optional(),
   result: ImageCreativeResult.nullable().optional(),
   request: ImageCreativeEditableRequest.optional()
 });
-var ImageCreativeJobPayload = z9.object({
-  jobId: z9.string().uuid(),
+var ImageCreativeJobPayload = z10.object({
+  jobId: z10.string().uuid(),
   status: ImageCreativeJobStatusEnum
 });
-var ImageCreativeHistoryEntry = z9.object({
-  id: z9.string().uuid(),
-  createdAt: z9.string().datetime(),
+var ImageCreativeHistoryEntry = z10.object({
+  id: z10.string().uuid(),
+  createdAt: z10.string().datetime(),
   status: ImageCreativeJobStatusEnum,
   result: ImageCreativeResult.nullable(),
-  error: z9.string().optional()
+  error: z10.string().optional()
 });
-var LandingCreativeJobStatusEnum = z9.enum([
+var LandingCreativeJobStatusEnum = z10.enum([
   "pending",
   "processing",
   "completed",
   "error"
 ]);
-var LandingCreativeResult = z9.object({
-  images: z9.array(LandingImageReadable).max(20),
-  createdAt: z9.string().datetime().optional()
+var LandingCreativeResult = z10.object({
+  images: z10.array(LandingImageReadable).max(20),
+  createdAt: z10.string().datetime().optional()
 });
-var LandingCreativeJobStatus = z9.object({
-  jobId: z9.string().uuid(),
+var LandingCreativeJobStatus = z10.object({
+  jobId: z10.string().uuid(),
   status: LandingCreativeJobStatusEnum,
-  error: z9.string().optional(),
+  error: z10.string().optional(),
   result: LandingCreativeResult.nullable().optional()
 });
-var LandingCreativeJobPayload = z9.object({
-  jobId: z9.string().uuid(),
+var LandingCreativeJobPayload = z10.object({
+  jobId: z10.string().uuid(),
   status: LandingCreativeJobStatusEnum
 });
-var LandingCreativeHistoryEntry = z9.object({
-  id: z9.string().uuid(),
-  createdAt: z9.string().datetime(),
+var LandingCreativeHistoryEntry = z10.object({
+  id: z10.string().uuid(),
+  createdAt: z10.string().datetime(),
   status: LandingCreativeJobStatusEnum,
   result: LandingCreativeResult.nullable(),
-  error: z9.string().optional()
+  error: z10.string().optional()
 });
-var CreativeGeneratorJob = z9.object({
-  taskId: z9.string().uuid(),
-  cleanImagesWaitAttempt: z9.number().int().nonnegative().optional()
+var CreativeGeneratorJob = z10.object({
+  taskId: z10.string().uuid(),
+  cleanImagesWaitAttempt: z10.number().int().nonnegative().optional()
 });
 
 // ../../packages/types/src/product-label.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var PRODUCT_LABEL_MAX_CHARS = 80;
-var ProductLabelSchema = z10.string().transform((value) => value.trim()).pipe(z10.string().max(PRODUCT_LABEL_MAX_CHARS)).optional();
+var ProductLabelSchema = z11.string().transform((value) => value.trim()).pipe(z11.string().max(PRODUCT_LABEL_MAX_CHARS)).optional();
 
 // ../../packages/types/src/landing-mode.ts
-import { z as z11 } from "zod";
-var LandingModeSchema = z11.enum([
+import { z as z12 } from "zod";
+var LandingModeSchema = z12.enum([
   "classic",
   "code"
 ]);
 
 // ../../packages/types/src/landing-image-format.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var LANDING_IMAGE_FORMATS = [
   "9:16",
   "4:5",
   "1:1"
 ];
-var LandingImageFormatSchema = z12.enum(LANDING_IMAGE_FORMATS);
+var LandingImageFormatSchema = z13.enum(LANDING_IMAGE_FORMATS);
 
 // ../../packages/types/src/ingest.ts
 var INGEST_MAX_REFERENCE_IMAGES = 5;
@@ -1399,9 +1600,9 @@ var INGEST_ALLOWED_IMAGE_MIME_TYPES = [
 ];
 var PRODUCT_CONTEXT_MAX_CHARS = 3e3;
 var INGEST_ALLOWED_IMAGE_MIME_TYPE_SET = new Set(INGEST_ALLOWED_IMAGE_MIME_TYPES);
-var IngestOptions = z13.object({
+var IngestOptions = z14.object({
   /** Optional owner-scoped guided journey context. Never bypasses ingest gates. */
-  dropshippingProjectId: z13.string().uuid().optional(),
+  dropshippingProjectId: z14.string().uuid().optional(),
   languageCode: LanguageCodeSchema.default("es-CO"),
   ugcFormat: VideoFormat.default("single_15s"),
   country: CountrySchema,
@@ -1414,27 +1615,33 @@ var IngestOptions = z13.object({
   videoTier: VideoTier.default(DEFAULT_VIDEO_TIER),
   narrativeStyle: NarrativeStyle.default("review"),
   videoPreset: VideoPreset.optional(),
-  multiAngleVideos: z13.boolean().default(false),
-  videoAngleCount: z13.number().int().min(1).max(3).optional(),
+  multiAngleVideos: z14.boolean().default(false),
+  videoAngleCount: z14.number().int().min(1).max(3).optional(),
   /** Per-angle narrative override (positional). angleNarratives[i] forces the
   *  narrative of angle position i, overriding the batch auto-selector; a list
   *  shorter than the generated angle count leaves the remaining positions
   *  auto-selected. Empty/omitted → all angles auto-select as before. */
-  angleNarratives: z13.array(NarrativeStyle).max(3).optional(),
+  angleNarratives: z14.array(NarrativeStyle).max(3).optional(),
   // 480p is the recommended default for every tier (flipped back 2026-07-30 — the
   // 720p premium is real but small, and users on the entry plan were defaulting
   // into it while burning half a month of credits on one video).
   // This Zod default is what callers that omit the field (MCP/API) actually get,
   // so it must agree with resolveSingleCallAwareResolution's unset fallback (480p).
   videoResolution: VideoResolution.default("480p"),
-  generateAdCopy: z13.boolean().default(true),
-  generateAiMusic: z13.boolean().optional(),
+  generateAdCopy: z14.boolean().default(true),
+  generateAiMusic: z14.boolean().optional(),
   voiceId: VoiceId.optional(),
-  isCombo: z13.boolean().default(false),
-  productContext: z13.string().transform((value) => value.trim()).pipe(z13.string().max(PRODUCT_CONTEXT_MAX_CHARS)).optional(),
-  creativeDirection: z13.string().transform((value) => value.trim()).pipe(z13.string().max(500)).optional(),
+  isCombo: z14.boolean().default(false),
+  productContext: z14.string().transform((value) => value.trim()).pipe(z14.string().max(PRODUCT_CONTEXT_MAX_CHARS)).optional(),
+  creativeDirection: z14.string().transform((value) => value.trim()).pipe(z14.string().max(500)).optional(),
+  /** Exact copy the user pinned. Rendered VERBATIM on the image creatives this task
+  *  produces and on the landing hero — never on video, which steers via scriptNotes.
+  *  `.pipe(...max)` REJECTS over-cap instead of truncating: silently shortening a pin
+  *  would ship copy the user never wrote, which is the bug the pin exists to prevent. */
+  headline: z14.string().transform((value) => value.trim()).pipe(z14.string().max(PINNED_HEADLINE_MAX_CHARS)).optional(),
+  subheadline: z14.string().transform((value) => value.trim()).pipe(z14.string().max(PINNED_SUBHEADLINE_MAX_CHARS)).optional(),
   productLabel: ProductLabelSchema,
-  selectedOutputs: z13.array(z13.enum([
+  selectedOutputs: z14.array(z14.enum([
     "landing",
     "video",
     "image"
@@ -1446,26 +1653,26 @@ var IngestOptions = z13.object({
   landingStrategy: LandingStrategySchema.optional(),
   /** Aspect ratio for classic image landing blocks. Ignored by code landing. Absent ⇒ '9:16'. */
   landingImageFormat: LandingImageFormatSchema.optional(),
-  imageStyle: z13.string().optional(),
-  creativeArchetype: ImageCreativeArchetype.or(z13.literal("ai_decides")).optional(),
-  visualTreatment: ImageCreativeVisualTreatment.or(z13.literal("ai_decides")).optional(),
-  aspectRatio: z13.string().optional(),
-  brandColors: z13.string().optional(),
-  nVariants: z13.number().int().min(1).max(6).optional(),
-  imageModel: z13.string().optional(),
-  styleMix: z13.string().optional(),
-  aiDecidesAll: z13.boolean().optional(),
+  imageStyle: z14.string().optional(),
+  creativeArchetype: ImageCreativeArchetype.or(z14.literal("ai_decides")).optional(),
+  visualTreatment: ImageCreativeVisualTreatment.or(z14.literal("ai_decides")).optional(),
+  aspectRatio: z14.string().optional(),
+  brandColors: z14.string().optional(),
+  nVariants: z14.number().int().min(1).max(6).optional(),
+  imageModel: z14.string().optional(),
+  styleMix: z14.string().optional(),
+  aiDecidesAll: z14.boolean().optional(),
   /** Opt out of the competitor-spy analysis. When false the worker skips
   *  enqueueCompetitorScan entirely, saving ~$0.25-0.35 user-visible per
   *  scan. Default true preserves the existing flow; users with their own
   *  competitor intel or in privacy-sensitive niches can disable. */
-  competitorScanEnabled: z13.boolean().default(true),
-  brandId: z13.string().uuid().optional()
+  competitorScanEnabled: z14.boolean().default(true),
+  brandId: z14.string().uuid().optional()
 }).partial().superRefine((data, ctx) => {
   const message = validatePriceInversion(data.price, data.compareAtPrice);
   if (message) {
     ctx.addIssue({
-      code: z13.ZodIssueCode.custom,
+      code: z14.ZodIssueCode.custom,
       path: [
         "compareAtPrice"
       ],
@@ -1476,11 +1683,11 @@ var IngestOptions = z13.object({
     });
   }
 });
-var IngestRequest = z13.object({
-  url: z13.string().url(),
+var IngestRequest = z14.object({
+  url: z14.string().url(),
   options: IngestOptions.optional()
 });
-var VideoOptionsOverride = z13.object({
+var VideoOptionsOverride = z14.object({
   videoModel: VideoModel.optional(),
   videoTier: VideoTier.optional(),
   ugcFormat: VideoFormat.optional(),
@@ -1489,38 +1696,38 @@ var VideoOptionsOverride = z13.object({
   videoResolution: VideoResolution.optional(),
   voiceId: VoiceId.optional(),
   /** Actor/character description (role + appearance + attitude). Drives voice and video character. */
-  actor: z13.string().max(360).optional()
+  actor: z14.string().max(360).optional()
 });
 var AngleVideoOptions = VideoOptionsOverride.extend({
-  angleIndex: z13.number().int().nonnegative(),
+  angleIndex: z14.number().int().nonnegative(),
   /** Per-angle angle/hook text override. When provided, replaces the auto-generated angle. */
-  angle: z13.string().max(480).optional(),
+  angle: z14.string().max(480).optional(),
   /** Per-angle creative direction (camera/action/setting/tone). NOT spoken dialogue — the script is authored/edited at script review. */
-  scriptNotes: z13.string().max(2e3).optional(),
+  scriptNotes: z14.string().max(2e3).optional(),
   /** Per-angle buyer persona override (describes the target audience) */
-  buyerPersona: z13.string().max(360).optional(),
+  buyerPersona: z14.string().max(360).optional(),
   /** Per-angle actor/character description (role + appearance + attitude). Drives voice and video character. */
-  actor: z13.string().max(360).optional()
-});
-var RapidScriptBlueprintShotForApproval = z13.object({
-  id: z13.string().min(1),
-  beatSource: z13.string().min(1),
-  durationSec: z13.number().positive(),
-  role: z13.string().min(1).max(120),
-  text: z13.string().min(1).max(320),
-  visualIntent: z13.string().min(1).max(500).optional(),
-  variantKey: z13.string().min(1).max(120).optional(),
-  targetWords: z13.number().int().positive().optional(),
-  minWords: z13.number().int().positive(),
-  maxWords: z13.number().int().positive()
+  actor: z14.string().max(360).optional()
+});
+var RapidScriptBlueprintShotForApproval = z14.object({
+  id: z14.string().min(1),
+  beatSource: z14.string().min(1),
+  durationSec: z14.number().positive(),
+  role: z14.string().min(1).max(120),
+  text: z14.string().min(1).max(320),
+  visualIntent: z14.string().min(1).max(500).optional(),
+  variantKey: z14.string().min(1).max(120).optional(),
+  targetWords: z14.number().int().positive().optional(),
+  minWords: z14.number().int().positive(),
+  maxWords: z14.number().int().positive()
 }).refine((shot) => shot.maxWords >= shot.minWords, {
   message: "maxWords must be greater than or equal to minWords",
   path: [
     "maxWords"
   ]
 });
-var RapidScriptBlueprintForApproval = z13.object({
-  shots: z13.array(RapidScriptBlueprintShotForApproval).min(1).max(10)
+var RapidScriptBlueprintForApproval = z14.object({
+  shots: z14.array(RapidScriptBlueprintShotForApproval).min(1).max(10)
 }).refine((blueprint) => {
   const ids = blueprint.shots.map((shot) => shot.id);
   return new Set(ids).size === ids.length;
@@ -1533,9 +1740,9 @@ var RapidScriptBlueprintForApproval = z13.object({
 var AngleVideoOptionsWithBlueprint = AngleVideoOptions.extend({
   rapidScriptBlueprint: RapidScriptBlueprintForApproval.optional()
 });
-var ProductImageSelection = z13.string().min(1).max(2048).refine((value) => !value.includes("\0"), "Invalid image reference");
-var IngestResumePayload = z13.object({
-  selectedAngleIndices: z13.array(z13.number().int().nonnegative()).min(1).max(3),
+var ProductImageSelection = z14.string().min(1).max(2048).refine((value) => !value.includes("\0"), "Invalid image reference");
+var IngestResumePayload = z14.object({
+  selectedAngleIndices: z14.array(z14.number().int().nonnegative()).min(1).max(3),
   ugcFormat: VideoFormat.default("single_15s"),
   videoStyle: VideoStyle.default("ugc"),
   videoModel: VideoModel.default("veo"),
@@ -1544,16 +1751,16 @@ var IngestResumePayload = z13.object({
   // 480p is the recommended default for every tier (flipped back 2026-07-30) — keep in
   // sync with IngestOptions.videoResolution and resolveSingleCallAwareResolution.
   videoResolution: VideoResolution.default("480p"),
-  pauseForVideoScriptReview: z13.boolean().optional(),
-  generateAiMusic: z13.boolean().optional(),
-  scriptNotes: z13.string().max(2e3).optional(),
+  pauseForVideoScriptReview: z14.boolean().optional(),
+  generateAiMusic: z14.boolean().optional(),
+  scriptNotes: z14.string().max(2e3).optional(),
   languageCode: LanguageCodeSchema.optional(),
   country: CountrySchema.optional(),
   price: PriceSchema.optional(),
   offer: OfferSchema.optional(),
   compareAtPrice: CompareAtPriceSchema.optional(),
   paymentMethods: PaymentMethodsSchema.optional(),
-  angleVideoOptions: z13.array(AngleVideoOptionsWithBlueprint).max(3).refine((opts) => {
+  angleVideoOptions: z14.array(AngleVideoOptionsWithBlueprint).max(3).refine((opts) => {
     if (!opts?.length) return true;
     const indices = opts.map((o) => o.angleIndex);
     return new Set(indices).size === indices.length;
@@ -1562,191 +1769,29 @@ var IngestResumePayload = z13.object({
   }).optional(),
   voiceId: VoiceId.optional(),
   /** Global actor/character description (role + appearance + attitude). Default for all angles. */
-  actor: z13.string().max(360).optional(),
+  actor: z14.string().max(360).optional(),
   /** Custom angle override for landing/creative (uses this instead of first angle) */
-  customAngleOverride: z13.string().min(1).max(480).optional(),
+  customAngleOverride: z14.string().min(1).max(480).optional(),
   /** Pain points to emphasize in landings, creatives, and videos */
-  painPoints: z13.string().max(1500).optional(),
+  painPoints: z14.string().max(1500).optional(),
   /** Benefits to highlight in landings, creatives, and videos */
-  benefits: z13.string().max(1500).optional(),
+  benefits: z14.string().max(1500).optional(),
   /** Target gender for landing/creative images */
-  creativeGender: z13.enum([
+  creativeGender: z14.enum([
     "female",
     "male",
     "mixed"
   ]).optional(),
+  /** Non-blocking static winner preference. Omitted defaults to original. */
+  winnerVisualMode: WinnerVisualMode.optional(),
   /** Which product image URLs to use for this generation (ephemeral selection) */
-  selectedImageUrls: z13.array(ProductImageSelection).max(INGEST_MAX_REFERENCE_IMAGES).optional(),
+  selectedImageUrls: z14.array(ProductImageSelection).max(INGEST_MAX_REFERENCE_IMAGES).optional(),
   /** User-confirmed intended product target for the selected reference image set */
   productTargetConfirmation: ProductTargetConfirmationSchema.optional(),
   /** User-confirmed grouping for the selected reference image set */
   productReferenceConfirmation: ProductReferenceConfirmationSchema.optional()
 });
 
-// ../../packages/types/src/angle.ts
-import { z as z14 } from "zod";
-var AnchoredIntel = z14.object({
-  painPointIndices: z14.array(z14.number().int().nonnegative()).max(10),
-  hookIndices: z14.array(z14.number().int().nonnegative()).max(10),
-  claimIndices: z14.array(z14.number().int().nonnegative()).max(10),
-  sourceAngleType: z14.enum([
-    "gap",
-    "validated_local",
-    "saturated_differentiated",
-    "novel"
-  ]),
-  // SNAPSHOT of the resolved intel strings at angle-generation time.
-  // Indices reference into Task.competitorIntel which we treat as immutable
-  // post-scan, but defensive: a future re-scan path that rewrites
-  // Task.competitorIntel would invalidate the indices silently. Persisting
-  // the resolved strings ALONGSIDE the indices means downstream consumers
-  // (script writer, landing copy) can safely use the strings directly
-  // without re-resolving — staleness-immune. The indices remain useful for
-  // analytics ("which intel items did angles cite?") and as a sanity-check.
-  resolvedPainPoints: z14.array(z14.string()).max(10).optional(),
-  resolvedHooks: z14.array(z14.string()).max(10).optional(),
-  resolvedClaims: z14.array(z14.string()).max(10).optional(),
-  /**
-  * Free-form pillar name describing the AXIS of the product this angle
-  * attacks (e.g. "ciencia/mecanismo", "tiempo/ritual", "comparación-con-
-  * alternativas", "social-proof", "dolor-emocional", "identidad/persona").
-  * The LLM picks the label — we do NOT lock an enum because the right
-  * pillar taxonomy varies per product (a supplement's "mecanismo" pillar
-  * is different from a gadget's "fricción de uso"). Constraint enforced
-  * at generation time: the 3 angles emitted for one task MUST use 3
-  * DISTINCT pillars (anti-convergence). Lives inside AnchoredIntel because
-  * it ships as analytics metadata alongside the anchoredIntel sourceType +
-  * indices, and persists as JSON without a column migration. Optional
-  * because angles persisted before this change have no pillar.
-  */
-  pillar: z14.string().min(1).max(60).optional(),
-  // Telemetry: why the angle did NOT import a gapAngle. The legacy single value
-  // 'none_relevant' was OVERLOADED (it meant "no gaps existed" AND "gaps existed
-  // but none fit" AND was the sanitizer default) which made the gap feature
-  // unmeasurable. Split into distinct, one-meaning-each states:
-  //   - persona_mismatch / product_mismatch: the LLM saw gaps and judged them a
-  //     wrong-persona / wrong-subcategory fit (trusted from the LLM).
-  //   - no_gaps_in_block: there were no gapAngles in the block (or no block).
-  //   - gaps_present_not_imported: gaps existed and the angle went novel anyway
-  //     (the sanitizer's honest default when the LLM didn't pick persona/product).
-  //   - gaps_all_filtered_noise: the reference HAD gaps but every one was dropped
-  //     as detection noise (retailer-meta/cross-category) so the LLM saw none.
-  //   - n_a: the angle imported a gap (sourceAngleType="gap"), so "why skipped"
-  //     is moot.
-  // The deterministic gap-presence states (no_gaps_in_block / gaps_present_not_
-  // imported / gaps_all_filtered_noise) are set by sanitizeAnchoredIntel from
-  // facts it computes (intel.gapAngles.length, intel.gapAnglesFilteredCount), NOT
-  // trusted from the lazy LLM. z.preprocess aliases historical 'none_relevant'
-  // rows → 'no_gaps_in_block' so the JSON column parses with no migration.
-  // Analytics-only: NO runtime path branches on this value.
-  skippedGapReason: z14.preprocess((v) => v === "none_relevant" ? "no_gaps_in_block" : v, z14.enum([
-    "persona_mismatch",
-    "product_mismatch",
-    "no_gaps_in_block",
-    "gaps_present_not_imported",
-    "gaps_all_filtered_noise",
-    "n_a"
-  ])).optional(),
-  // Telemetry: captures the prod-observed case where a "novel" angle actually
-  // reflects a GAP's theme/promise without formally anchoring indices (gapAngles
-  // are a separate array, not index-cited, so a real gap import is reclassified
-  // 'novel' by the empty-indices coherence guard). Self-reported by the LLM:
-  //   - gap_imported: the angle's theme imports a gap's logic.
-  //   - product_derived: derived purely from the product.
-  //   - hybrid: a mix.
-  // SOFT analytics-only signal (the LLM may confabulate) — validated against
-  // known prod cases before trusting aggregates; never a control-flow input.
-  // Optional in storage; on the wire it ships as a required enum with a 'none'
-  // sentinel (strict structured output forbids optional properties) that the
-  // sanitizer maps to undefined.
-  themeSourceType: z14.enum([
-    "gap_imported",
-    "product_derived",
-    "hybrid"
-  ]).optional()
-});
-var Angle = z14.object({
-  angle: z14.string().min(1).max(480),
-  buyerPersona: z14.string().min(1).max(360),
-  /** Character description for video (role + appearance + attitude). Drives voice selection and Frame0Spec. */
-  actor: z14.string().min(1).max(360).optional(),
-  // Binary only: voice catalog has no non-binary voices.
-  // See packages/angles/src/index.ts + getAngles coercion in angle.repository.ts.
-  gender: z14.enum([
-    "female",
-    "male"
-  ]).optional(),
-  /** Per-angle user-supplied script/visual notes. Hydrated from the
-  *  `Angle.scriptNotes` DB column or the `angleVideoOptions[i].scriptNotes`
-  *  passed from the chat. Per-angle overrides global `videoScriptNotes`. */
-  scriptNotes: z14.string().max(2e3).optional(),
-  /** AI-chosen per-angle narrative (set by the batch selector in angles.worker).
-  *  Pre-fills the review dropdown; user can override per angle. */
-  narrativeStyle: NarrativeStyle.optional(),
-  /** See AnchoredIntel docs. Optional because angles persisted before this
-  *  change have no anchoring captured; new angles ALWAYS emit it (with empty
-  *  arrays + 'novel' when intel was unavailable). */
-  anchoredIntel: AnchoredIntel.optional(),
-  /** Server-computed: true when this angle is eligible for the gap_replication
-  *  narrative (isReplicationAngle(anchoredIntel, intel) && intel.gapBlueprint
-  *  present). Computed server-side (not derived client-side) because the web
-  *  only sees this angle's anchoredIntel, not the task's
-  *  competitorIntel.gapBlueprint. Gates the review dropdown's gap_replication
-  *  option — absent/false = hidden. */
-  gapReplicationEligible: z14.boolean().optional(),
-  /** Server-computed: true when this angle's effective narrative is
-  *  gap_replication, which FORCES the multi-shot STANDARD ("Multiescena")
-  *  render pipeline regardless of the task's chosen tier (single_call can't
-  *  produce the multi-shot replication — see task-results.service.ts and the
-  *  render-time tier override). Surfaces "renders in Multiescena" on the
-  *  review card so a single_call user isn't surprised by the STANDARD-tier
-  *  charge. */
-  rendersMultiShot: z14.boolean().optional(),
-  /** Server-computed product-level origin bucket for the review card's badge
-  *  (NOT the internal sourceAngleType taxonomy — see resolveAngleOrigin in
-  *  task-results.service.ts): 'gap' = market opportunity competitors aren't
-  *  using; 'saturated_twist' = competitors' most-used approach with our own
-  *  twist; 'ai_recommended' = AI-authored for this product (default). */
-  angleOrigin: z14.enum([
-    "gap",
-    "saturated_twist",
-    "ai_recommended"
-  ]).optional(),
-  /** Server-computed badge TIER for the replication angle (two-tier UX,
-  *  v1.32.0 — see resolveReplicationTier). 'winner' = a validated angle
-  *  opportunity backed by a proven ad (anchor gap/saturated → golden badge);
-  *  'opportunity' = a product-coherent replicable winner with no validated
-  *  angle gap (anchor 'dominant' → opportunity/twist badge, no overclaim).
-  *  Present only on the angle that carries gap_replication; absent otherwise. */
-  replicationTier: z14.enum([
-    "winner",
-    "opportunity"
-  ]).optional()
-});
-var AdVideo = z14.object({
-  source: z14.enum([
-    "tiktok_shop",
-    "meta_ads"
-  ]),
-  url: z14.string().url(),
-  title: z14.string().optional(),
-  description: z14.string().optional(),
-  metrics: z14.object({
-    impressions: z14.number().int().nonnegative().optional(),
-    views: z14.number().int().nonnegative().optional(),
-    likes: z14.number().int().nonnegative().optional(),
-    ctaClicks: z14.number().int().nonnegative().optional(),
-    diggCount: z14.number().int().nonnegative().optional(),
-    shareCount: z14.number().int().nonnegative().optional(),
-    commentCount: z14.number().int().nonnegative().optional(),
-    playCount: z14.number().int().nonnegative().optional(),
-    collectCount: z14.number().int().nonnegative().optional(),
-    durationSeconds: z14.number().int().nonnegative().optional()
-  }).partial().optional(),
-  country: z14.string().optional(),
-  lastSeen: z14.string().datetime().optional()
-});
-
 // ../../packages/types/src/frame0.ts
 import { z as z15 } from "zod";
 var Frame0SpecVersion = z15.literal("frame0_spec_v1");
@@ -1925,7 +1970,15 @@ var VideoGenerator = z16.object({
   angleKey: z16.string().min(1),
   angleIndex: z16.number().int().nonnegative(),
   angle: z16.string().min(1).max(480).optional(),
-  buyerPersona: z16.string().min(1).max(360).optional(),
+  // READ contract: the cap must fit what the generators actually persist, not
+  // what the write surfaces accept. Angle-derived personas are LLM-written and
+  // routinely exceed the 360-char write cap (prod alert 88badc8: 419 chars), and
+  // this schema serializes existing DB rows — a too-tight cap turns a valid row
+  // into a ZodError that 500s the whole `GET /v1/results/:taskId` payload and
+  // hides the entire task. Same reasoning as the landing-images cap in
+  // `result.ts`. Write-side caps (angle.ts, wizard.ts, task-creative-variants.ts)
+  // intentionally stay at 360.
+  buyerPersona: z16.string().min(1).max(1200).optional(),
   script: z16.string().min(1),
   prompt: z16.string().min(1),
   // Empty string allowed: Pro pipeline pauses for script review BEFORE the grid
@@ -2354,6 +2407,8 @@ var ApproveImageAnglesRequest = z19.object({
   painPoints: z19.string().max(1500).optional(),
   /** Features to include in the image */
   features: z19.array(z19.string().min(1).max(240)).max(20).optional(),
+  /** Non-blocking static winner preference. Omitted defaults to original. */
+  winnerVisualMode: WinnerVisualMode.optional(),
   /** Which product image URLs to use for this generation (ephemeral selection) */
   selectedImageUrls: z19.array(ProductImageSelection).max(5).optional(),
   productTargetConfirmation: ProductTargetConfirmationSchema.optional(),
@@ -2378,12 +2433,13 @@ var ImageSuggestionsResponse = z19.object({
   buyerPersona: z19.string().optional()
 });
 var RefineAngleRequest = z19.object({
-  /** Refine mode: 'all' refines angle + pains + benefits, 'pain_points'/'benefits' regenerate just that section */
+  /** Refine mode: 'reference' adapts a competitor image winner's selling structure to the user's product. */
   mode: z19.enum([
     "all",
     "pain_points",
     "benefits",
-    "video"
+    "video",
+    "reference"
   ]),
   /** Current angle text (used as context for aligned generation) */
   currentAngle: z19.string().max(480).optional(),
@@ -2476,7 +2532,6 @@ var TASK_CREATIVE_VARIANT_TEXT_LIMITS = {
   recommendationRationale: 600
 };
 var TaskCreativeVariantVideoPreset = VideoPreset.exclude([
-  "problem_solution",
   "ugc_unboxing_chaos",
   "ugc_curiosity_reveal",
   "ugc_listicle_3",
@@ -2833,7 +2888,10 @@ var StatusResponse = z22.object({
   /** Derived from landingEnabled/videoGeneratorEnabled/adCreativeEnabled flags;
   *  canonical [landing, video, image] order regardless of input order.
   *  Always present (server derivation has a "legacy = enabled" fallback). */
-  selectedOutputs: SelectedOutputsSchema
+  selectedOutputs: SelectedOutputsSchema,
+  /** Persisted image portfolio size so a refreshed review reconstructs the
+  * same visual plan even when browser session state is unavailable. */
+  imageVariantCount: z22.number().int().min(1).max(6).optional()
 });
 var TaskSummary = z22.object({
   taskId: z22.string().uuid(),
@@ -4118,6 +4176,8 @@ var TikTokCreateCampaignResponseSchema = z32.object({
 // ../../packages/types/src/pricing.ts
 var CREDITS_PER_USD_CENT = 10;
 var CREDITS_PER_DOLLAR = 100 * CREDITS_PER_USD_CENT;
+var KALODATA_USD_CENTS_PER_PROVIDER_CREDIT = 9;
+var KALODATA_PROVIDER_CREDITS_PER_SOURCE_CEILING = 7.5;
 var DEFAULT_PRICING = {
   // IMPORTANT: despite the field name, these values are in *USD cents* (not USD dollars).
   // We store cents (and sometimes fractional cents) everywhere so we can convert to credits:
@@ -4163,16 +4223,16 @@ var DEFAULT_PRICING = {
     userPriceCents: 0.8
   },
   "openrouter:chat-parse": {
-    ourCostCents: 0.05,
-    userPriceCents: 0.1
+    ourCostCents: 0.2,
+    userPriceCents: 0.4
   },
   "openrouter:audio-tag-injection": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 0.1,
+    userPriceCents: 0.2
   },
   "openrouter:product-consolidation": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 0.07,
+    userPriceCents: 0.14
   },
   "openrouter:video-final-simplify-rewrite": {
     ourCostCents: 0.4,
@@ -4191,12 +4251,12 @@ var DEFAULT_PRICING = {
     userPriceCents: 0.3
   },
   "openrouter:vision-extract-combo": {
-    ourCostCents: 0.3,
-    userPriceCents: 0.6
+    ourCostCents: 0.6,
+    userPriceCents: 1.2
   },
   "openrouter:rich-scene-analyzer": {
-    ourCostCents: 0.15,
-    userPriceCents: 0.3
+    ourCostCents: 13.42,
+    userPriceCents: 26.84
   },
   "openrouter:product-info-extractor": {
     ourCostCents: 0.15,
@@ -4536,6 +4596,10 @@ var DEFAULT_PRICING = {
     ourCostCents: 2,
     userPriceCents: 4
   },
+  "kie:image-generation:nano-banana-2-lite": {
+    ourCostCents: 2,
+    userPriceCents: 4
+  },
   "kie:image-generation:nano-banana-2": {
     ourCostCents: 4,
     userPriceCents: 8
@@ -4572,6 +4636,10 @@ var DEFAULT_PRICING = {
     ourCostCents: 3,
     userPriceCents: 6
   },
+  "fal:image-generation:gpt-image-2:1k": {
+    ourCostCents: 1.5,
+    userPriceCents: 6
+  },
   // Video reference pricing varies by model:
   // - gpt-image-2 @ 2K (primary since 2026-04-24): $0.05 / $0.10
   // - nano-banana-2 (fallback for 5xx/timeout): $0.04 / $0.08
@@ -4768,15 +4836,16 @@ var DEFAULT_PRICING = {
     ourCostCents: 2.5,
     userPriceCents: 5
   },
-  // Usage spec extraction (Gemini 3 Flash Preview:online)
+  // Usage spec extraction (gemini-3-flash-preview:online). Measured 1.5807¢ — the :online
+  // web-search surcharge is what makes it ~4x the plain-Flash rate it used to be priced at.
   "openrouter:product-usage-extract": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 1.58,
+    userPriceCents: 3.16
   },
-  // Functional demonstration extraction (Gemini 3 Flash Preview:online with web search)
+  // Functional demonstration extraction (gemini-3-flash-preview:online). Measured 1.0643¢.
   "openrouter:functional-demo-extract": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 1.06,
+    userPriceCents: 2.12
   },
   // Fusion of angles and usage into visual context (Gemini 3 Flash Preview)
   "openrouter:visual-context-fusion": {
@@ -4793,6 +4862,38 @@ var DEFAULT_PRICING = {
     ourCostCents: 2,
     userPriceCents: 4
   },
+  // Free-form (v2) code landings — estimator inputs + usage.cost fallbacks. Edit-chat
+  // rows are the FLAT per-message price (100/300 credits).
+  "openrouter:landing-art-direction": {
+    ourCostCents: 5,
+    userPriceCents: 10
+  },
+  // v2.1: ONE coherent call authors every section (replaced the per-section
+  // 'landing-section-code' fan-out — kept below for legacy BillingEntry rows).
+  "openrouter:landing-section-authoring": {
+    ourCostCents: 20,
+    userPriceCents: 40
+  },
+  "openrouter:landing-section-code": {
+    ourCostCents: 5,
+    userPriceCents: 10
+  },
+  "openrouter:landing-visual-judge": {
+    ourCostCents: 3,
+    userPriceCents: 6
+  },
+  "system:landing-qa": {
+    ourCostCents: 1,
+    userPriceCents: 0
+  },
+  "openrouter:landing-edit-chat-section": {
+    ourCostCents: 5,
+    userPriceCents: 10
+  },
+  "openrouter:landing-edit-chat-full": {
+    ourCostCents: 15,
+    userPriceCents: 30
+  },
   // Product mix helper calls (Gemini 3 Flash Preview)
   "openrouter:product-mix-script-generation": {
     ourCostCents: 0.4,
@@ -4823,15 +4924,18 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.2,
     userPriceCents: 0.4
   },
-  // Landing image QA (Gemini 3 Flash Preview, 1 image). Checks anatomy/text/background cutoff.
+  // Landing image QA (gemini-3.6-flash since 2026-08-01, 1-2 images). Anatomy/text/background cutoff.
+  // 1.88¢ = the post-model-swap steady state at prod averages (11,109 prompt / 928 completion
+  // tokens) WITH the prompt-cache breakpoint; without caching it would be ~2.36¢.
   "openrouter:landing-image-qa": {
-    ourCostCents: 0.15,
-    userPriceCents: 0.3
+    ourCostCents: 1.88,
+    userPriceCents: 3.76
   },
-  // Creative image QA (Gemini 3 Flash Preview, 1 image). Checks product fidelity and severe render defects.
+  // Creative image QA (gemini-3-flash-preview — deliberately NOT on 3.6; see ai_models.md).
+  // Measured 0.8196¢ over 30d of prod.
   "openrouter:creative-image-qa": {
-    ourCostCents: 0.15,
-    userPriceCents: 0.3
+    ourCostCents: 0.82,
+    userPriceCents: 1.64
   },
   // Anatomy check (Gemini 3 Flash Preview, 1 image). Standalone anatomy verification.
   "openrouter:anatomy-check": {
@@ -4870,10 +4974,10 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.15,
     userPriceCents: 0.3
   },
-  // Policy rewrite helper (Gemini 3 Flash Preview)
+  // Policy rewrite helper (gemini-3-flash-preview). Measured 0.0416¢ — a short text-only call.
   "openrouter:policy-prompt-rewrite": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 0.04,
+    userPriceCents: 0.08
   },
   // TTS dialogue rewrite helper (OpenRouter model: google/gemini-3-flash-preview)
   // Our cost: ~$0.0005 USD per request => 0.05 USD cents; keep 2x markup.
@@ -4944,14 +5048,25 @@ var DEFAULT_PRICING = {
     userPriceCents: 0.8
   },
   // single_call: flattens the approved plan into the one Grok render prompt
-  // (gemini-3.6-flash, medium reasoning, 8k maxTokens). Sized from 30d of prod entries on
-  // the SAME model — rapid-grok-shot-action averaged 2.11¢ our / 4.23¢ user. Only
-  // attempt 1 is charged; the flatten's internal retries record COGS only, so this
-  // quotes once per render. Real calls bill the actual usage.cost x2; this value is
-  // the estimator basis + the fallback when usage.cost is missing.
+  // (gemini-3.6-flash, medium reasoning, 8k maxTokens).
+  //
+  // RE-DERIVED 2026-08-01 from 860 prod rows (July 2026, still-paper-34632546):
+  // mean 4.573¢ our, p50 4.674¢, p95 6.205¢. The previous 2¢ was inferred by
+  // ANALOGY from `rapid-grok-shot-action` (2.11¢) rather than measured on this
+  // label, and was 2.3x too low — real calls bill the actual usage.cost x2, so
+  // the money was always collected correctly, but every QUOTE understated this
+  // line by that factor. 5¢ sits above the mean and the median with headroom,
+  // below the p95.
+  //
+  // ⚠️ This is a PER-CALL rate and the flatten is NOT called once per render:
+  // measured 4.34 calls per (task, angle) on average, because a structurally
+  // valid prompt that exceeds Grok's 4090-BYTE ceiling is regenerated shorter
+  // (up to MAX_FLATTEN_ATTEMPTS). The estimator multiplies this rate by that cap.
+  // Reducing the CALL COUNT is the real cost lever here, not this rate — see the
+  // note on the flatten line in cost-estimator.service.ts.
   "openrouter:single-call-flatten": {
-    ourCostCents: 2,
-    userPriceCents: 4
+    ourCostCents: 5,
+    userPriceCents: 10
   },
   "openrouter:hand-detector": {
     ourCostCents: 0.15,
@@ -4970,8 +5085,8 @@ var DEFAULT_PRICING = {
     userPriceCents: 0.8
   },
   "openrouter:wearable-product-semantics": {
-    ourCostCents: 0.4,
-    userPriceCents: 0.8
+    ourCostCents: 0.11,
+    userPriceCents: 0.22
   },
   // Clip Judge — text-only comparison of QA results between original and retry clips
   // (google/gemini-3-flash-preview, text-only). Our cost: ~$0.0006 => 0.06 cents; 2x markup.
@@ -4988,14 +5103,14 @@ var DEFAULT_PRICING = {
   // Image Judge — text-only comparison of QA results between image candidates
   // (google/gemini-3-flash-preview, text-only). Our cost: ~$0.0006 => 0.06 cents; 2x markup.
   "openrouter:image-judge-text": {
-    ourCostCents: 0.06,
-    userPriceCents: 0.12
+    ourCostCents: 0.39,
+    userPriceCents: 0.78
   },
   // Image Judge — vision comparison of two images + product reference (google/gemini-3-flash-preview)
-  // Our cost: ~$0.0015 => 0.15 cents; 2x markup (images are cheaper than video).
+  // Measured 0.8863¢ over 30d of prod (the old ~0.15¢ predated the multi-image comparison).
   "openrouter:image-judge-vision": {
-    ourCostCents: 0.15,
-    userPriceCents: 0.3
+    ourCostCents: 0.89,
+    userPriceCents: 1.78
   },
   // Video QA — product integrity scanner (Gemini 3 Flash Preview, 5 frames + reference).
   "openrouter:video-product-integrity": {
@@ -5005,10 +5120,19 @@ var DEFAULT_PRICING = {
   // Video QA — anatomy. THREE keys, and they do NOT share a unit. Getting this wrong
   // over-charges by ~42x, which is exactly what a first pass at the 2026-07-30 change did.
   //
-  // (a) The arm-scan's per-FRAME counting sweep. STILL LIVE on the whole-video concat path
-  //     (`scanClipArms` at apps/api/src/workers/core/video-concat-core.ts), which bills
-  //     units:1 PER SAMPLED FRAME, up to ARM_SCAN_FRAME_CEILING. Rate must stay per-frame.
-  //     Sized above the 30d prod average (10303 rows => 0.132c user/frame).
+  // (a) The arm-scan's per-FRAME counting sweep. RETIRED 2026-07-30 — it has NO producer left.
+  //     Its last call site was the whole-video concat gate, removed as redundant with the
+  //     per-scene frame judge (b). It was ALSO duration-blind on `double_30s` — the sweep
+  //     samples t=0,1,2… capped at 16, so a 30s assembled video was only partly read while all
+  //     16 frames still billed — but NOT on `single_15s` (~15s, covered completely), which is
+  //     the dominant format. Redundancy is what carries the removal; the blindness is secondary.
+  //     The estimator no longer quotes it either.
+  //     The KEY STAYS DEFINED ON PURPOSE. `BillingService.record` treats an unknown key as
+  //     "No pricing rule found; skipping" and bills NOTHING — that silent hole already cost us
+  //     10,303 unbilled calls before 2026-07-18. `scanClipArms` is still exported, so if
+  //     anything ever calls it again it must land on a rate, not on the skip branch.
+  //     Rate stays PER FRAME, sized above the
+  //     30d prod average (10303 rows => 0.132c user/frame).
   "openrouter:video-anatomy-arm-scan": {
     ourCostCents: 0.1,
     userPriceCents: 0.2
@@ -5074,10 +5198,11 @@ var DEFAULT_PRICING = {
     ourCostCents: 1,
     userPriceCents: 2
   },
-  // LLM image ranking (Gemini 3 Flash, ~10 images multi-modal)
+  // LLM image ranking (gemini-3-flash-preview, ~10 images multi-modal). Unit = one CANDIDATE
+  // image, not one call, so the per-unit rate is small: measured 0.0924¢/unit.
   "openrouter:image-ranking": {
-    ourCostCents: 0.3,
-    userPriceCents: 0.6
+    ourCostCents: 0.09,
+    userPriceCents: 0.18
   },
   // Visual context pass — frame0 description (Gemini 3 Flash Preview, 1 image)
   "openrouter:visual-context-frame0-describe": {
@@ -5166,10 +5291,50 @@ var DEFAULT_PRICING = {
     ourCostCents: 1,
     userPriceCents: 2
   },
-  // Product research acquires KaloPilot credits at $0.10 per provider credit;
-  // the source worker overrides ourCostCents with the exact reported usage.
+  // ─── Product research (winning products) ─────────────────────────────────
+  // BUNDLE, billed as two rows against the same `productResearchRunId`:
+  //   revenue → `system:product-research-report`  = 200¢ / 2,000 credits, charged
+  //             UP FRONT by purchaseProductResearchRun (which also debits
+  //             User.creditCents in the same transaction), and reversed by a
+  //             `system:product-research-failure-refund` row when the run fails.
+  //   cost    → `kalodata:product-research-source` (+ `openrouter:*` analysis),
+  //             recorded AFTER the provider answers, with creditOperation
+  //             'ledger_only' — the user was already debited.
+  //
+  // ⚠️ `userPriceCents: 0` on the kalodata row is DELIBERATE, not a missing
+  // charge. Revenue cannot live here: the cost row is written after the
+  // provider bills us, while the price is committed at purchase time, and a
+  // run that fails post-source is refunded in full while its kalodata cost
+  // stands. Any per-provider markup report that divides price÷cost will
+  // therefore show kalodata (and the openrouter product-research labels) at
+  // 0.00×. The cost row carries `bundledRevenue*` metadata so the pairing is
+  // discoverable from the row itself.
+  //
+  // ⚠️ Two traps in aggregating this bundle, both measured on the 27 runs to
+  // 2026-08-01 — read before writing a P&L query:
+  //   1. Refunds are stored as a POSITIVE `userPriceCents` on
+  //      `system:product-research-failure-refund` (metadata.target 'refund',
+  //      not 'product_research'). Grouping on target='product_research' counts
+  //      the purchase and drops its reversal; summing userPriceCents across
+  //      the run double-counts instead of netting. Retained revenue is
+  //      Σ(label='product-research-report') − Σ(label='product-research-failure-refund').
+  //      For those 27 runs that is $54 charged − $30 refunded = $24 kept.
+  //   2. A cost row is per PROVIDER CALL, not per run: `getFreshProductResearchSource`
+  //      serves repeat queries from the source cache, so a charged run can have
+  //      no kalodata row at all (12 of the 27 did). `bundledRevenueCents` is
+  //      therefore context for THIS row — never a revenue total to sum.
+  // Total COGS is Σ ourCostCents over every row with a non-null
+  // productResearchRunId, which needs no per-provider grouping at all.
+  //
+  // The source worker overrides ourCostCents with the exact reported usage
+  // (providerCredits × KALODATA_USD_CENTS_PER_PROVIDER_CREDIT). Nothing reads
+  // this entry today — no cost-estimator key and no credit gate resolves it,
+  // since the gate is a flat `creditCents >= 200` in
+  // purchaseProductResearchRun. It is kept as the audited reference rate so
+  // the estimate stops contradicting the ledger the moment something does
+  // quote from it.
   "kalodata:product-research-source": {
-    ourCostCents: 24.9,
+    ourCostCents: KALODATA_PROVIDER_CREDITS_PER_SOURCE_CEILING * KALODATA_USD_CENTS_PER_PROVIDER_CREDIT,
     userPriceCents: 0
   },
   "system:product-research-report": {
@@ -5277,9 +5442,9 @@ var DEFAULT_PRICING = {
   // here (0.0653¢ our/frame) is LOWER, so the prod-derived rate stands per the
   // quote-at-the-ceiling rule. Do not re-add a second key: TS1117 duplicate.
   // Unit = one winner-selection pass over the scraped ad pool (measured 0.3744¢).
-  // ⚠️ NOT once per scan any more: the deep-capture candidate fallback re-runs this
-  // selector for each retry, so the estimate must quote it at
-  // GAP_DEEP_CAPTURE_MAX_CANDIDATES (default 3), never at 1.
+  // ⚠️ NOT once per scan any more: the deep-capture candidate fallback re-runs the
+  // video selector for each retry, and static replication independently selects
+  // one image winner. The estimate quotes GAP_DEEP_CAPTURE_MAX_CANDIDATES + 1.
   "openrouter:gap-winner-selection": {
     ourCostCents: 0.4,
     userPriceCents: 0.8
@@ -5291,6 +5456,13 @@ var DEFAULT_PRICING = {
     ourCostCents: 2.5,
     userPriceCents: 5
   },
+  // Unit = one independent multimodal argument extraction for the selected
+  // static-image winner. Quote at the blueprint ceiling until BillingEntry has
+  // enough production volume to establish a narrower measured rate.
+  "openrouter:competitor-image-winner-argument": {
+    ourCostCents: 2.5,
+    userPriceCents: 5
+  },
   // Unit = one multimodal temporal observation of the captured winner MP4.
   // Includes the bounded full video plus measured frame samples and high
   // reasoning. Unmeasured at launch, so quote at 2x the keyframe-only blueprint
@@ -5309,6 +5481,19 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.2,
     userPriceCents: 0.4
   },
+  // Unit = one product-use SHEET derivation: Flash reads the product photos + the seller's raw
+  // text and writes the three lines the video QA judge needs to rule on product MISUSE. Same
+  // model, same effort and the same image budget as the exposure classifier directly above, so
+  // it is priced at that rate rather than re-measured on n=1. Sized ABOVE the measured campaign
+  // cost of the equivalent call (~2.4¢ USER for the sheet+judge PAIR, of which the sheet is the
+  // smaller half) because this table is only the fallback for when OpenRouter omits usage.cost.
+  // ONCE PER TASK, not per clip and not per render attempt: the sheet is derived at ingest and
+  // every QA call on that task reads the stored copy. Quoting it per scene would over-quote a
+  // 3-scene single by 3x and inflate the credit gate for spend that never happens.
+  "openrouter:product-use-sheet": {
+    ourCostCents: 0.2,
+    userPriceCents: 0.4
+  },
   // Unit = one reference-grouping pass over the user's product images (0.1241¢).
   "openrouter:product-reference-grouping": {
     ourCostCents: 0.15,
@@ -5356,6 +5541,68 @@ var DEFAULT_PRICING = {
     ourCostCents: 1,
     userPriceCents: 2
   },
+  // ── Rapid / single_call pipeline: keys that did NOT exist until 2026-08-01 ──
+  //
+  // These labels bill real money every day but had NO entry here, so whenever
+  // OpenRouter omitted `usage.cost` the fallback resolved to `undefined` and the
+  // call was recorded at ZERO. `rapid-plan` alone is the single most expensive
+  // OpenRouter label we have ($116.60 / 30d). The rates below are MEASURED, not
+  // guessed: SUM(ourCostCents)/SUM(units) over 30 days of prod BillingEntry
+  // (neon still-paper-34632546, queried 2026-08-01), at the standard 2x markup.
+  //
+  // None of these keys is read by cost-estimator.service.ts — the rapid pipeline
+  // quotes them through the calibrated STANDARD_PIPELINE_OVERHEAD_CENTS blob — so
+  // adding them changes the billing FALLBACK only and cannot move any quote.
+  // Unit = one rapid plan authoring call (measured 4.3968¢).
+  "openrouter:rapid-plan": {
+    ourCostCents: 4.4,
+    userPriceCents: 8.8
+  },
+  // Unit = one rapid script blueprint call (measured 4.2748¢).
+  "openrouter:rapid-script-blueprint": {
+    ourCostCents: 4.28,
+    userPriceCents: 8.56
+  },
+  // Unit = one whole-video standard QA pass (measured 2.4104¢).
+  "openrouter:video-qa-standard": {
+    ourCostCents: 2.41,
+    userPriceCents: 4.82
+  },
+  // Unit = one frame0 anchor compose (measured 0.7351¢).
+  "openrouter:frame0-anchor-compose": {
+    ourCostCents: 0.74,
+    userPriceCents: 1.48
+  },
+  // Unit = one voiceover↔visual alignment pass (measured 0.9092¢).
+  "openrouter:rapid-voiceover-visual-alignment": {
+    ourCostCents: 0.91,
+    userPriceCents: 1.82
+  },
+  // Unit = one rapid plan character/setting pass (measured 0.5547¢).
+  "openrouter:rapid-plan-character": {
+    ourCostCents: 0.55,
+    userPriceCents: 1.1
+  },
+  // Unit = one segment naturalization pass (measured 0.5470¢).
+  "openrouter:rapid-naturalize": {
+    ourCostCents: 0.55,
+    userPriceCents: 1.1
+  },
+  // Unit = one rapid script validation pass (measured 0.3704¢).
+  "openrouter:rapid-script-validation": {
+    ourCostCents: 0.37,
+    userPriceCents: 0.74
+  },
+  // Unit = one voiceover shortening pass (measured 0.3081¢).
+  "openrouter:rapid-voiceover-shorten": {
+    ourCostCents: 0.31,
+    userPriceCents: 0.62
+  },
+  // Unit = one POV judge call on the rapid plan (measured 0.0769¢).
+  "openrouter:rapid-plan-pov-judge": {
+    ourCostCents: 0.08,
+    userPriceCents: 0.16
+  },
   // Unit = one ffmpeg mix laying the replicated winner's own audio track under our
   // voiceover, producing the extra `ad_final_with_winner_music` deliverable
   // (gap_replication only, behind GAP_WINNER_MUSIC_ENABLED, default OFF). No AI
@@ -6536,9 +6783,107 @@ var LandingConfigSchema = z35.object({
   */
   showVariantPicker: z35.boolean().optional()
 });
+var FreeformSlotTypeSchema = z35.enum([
+  "text",
+  "image",
+  "price",
+  "cta",
+  "list"
+]);
+var FreeformSlotSchema = z35.object({
+  type: FreeformSlotTypeSchema,
+  /** Human label shown in the editor ("Título", "Imagen principal"). */
+  label: z35.string().min(1).max(60),
+  /** text/price/cta: display text. image: absolute URL. list: unused (see items). */
+  value: z35.string().max(2e3),
+  /** Only for type 'list'. */
+  items: z35.array(z35.string().max(300)).max(12).optional()
+});
+var FreeformSectionSchema = z35.object({
+  id: z35.string().regex(/^[a-z0-9][a-z0-9_-]{0,39}$/),
+  label: z35.string().min(1).max(60),
+  /** Sanitized free markup with {{slot:key}} markers and data-cl-* attributes. */
+  layoutHtml: z35.string().min(1).max(16e3),
+  slots: z35.record(z35.string().regex(/^[a-zA-Z0-9_]{1,40}$/), FreeformSlotSchema),
+  /** Section CSS, selectors prefixed with [data-cl-s="<id>"]. */
+  css: z35.string().max(8e3).optional()
+});
+var DesignSystemSchema = z35.object({
+  /** Same 4 roles as v1 preset — they feed the --cl-* CSS vars the buy form uses. */
+  colors: z35.object({
+    primary: HexColorSchema,
+    bg: HexColorSchema,
+    text: HexColorSchema,
+    accent: HexColorSchema
+  }),
+  fonts: z35.object({
+    heading: FontNameSchema,
+    body: FontNameSchema
+  }),
+  radius: z35.string().regex(/^\d{1,2}(px|rem|em)$/),
+  /** Prompt-only vocabulary ("brutalist", "editorial"); not rendered. */
+  styleKeywords: z35.array(z35.string().max(40)).max(8).default([])
+});
+var FreeformLandingConfigSchema = z35.object({
+  version: z35.literal(2),
+  themeVersion: z35.literal(2),
+  locale: z35.string().min(2),
+  designSystem: DesignSystemSchema,
+  globalCss: z35.string().max(2e4).default(""),
+  sections: z35.array(FreeformSectionSchema).min(1).max(14),
+  /** Buy form is inserted AFTER this section (assembler adds BUY_FORM_MARKER). */
+  buyFormAfterSectionId: z35.string(),
+  /** Assembled + sanitized final HTML — source of truth for render/publish. */
+  html: z35.string().min(1),
+  product: LandingProductSchema,
+  showVariantPicker: z35.boolean().optional(),
+  /**
+  * Suppress the native Shopify buy form (the `BUY_FORM_MARKER` block). The page
+  * CTAs already carry `data-cl-buy-trigger` → they open the ReleaseIt COD popup,
+  * so on ReleaseIt-only stores the native add-to-cart form is a redundant second
+  * buy path (it rendered as a bare "price + Comprar" block). When true the
+  * assembler omits the marker entirely. Undefined/false = keep the native form
+  * (backward compatible with already-assembled configs).
+  */
+  hideNativeBuyForm: z35.boolean().optional()
+});
+var AnyLandingConfigSchema = z35.union([
+  FreeformLandingConfigSchema,
+  LandingConfigSchema
+]);
 var UpdateLandingConfigResponse = z35.object({
   ok: z35.boolean()
 });
+var CreateLandingEditRequest = z35.object({
+  message: z35.string().min(3).max(1e3),
+  sectionId: z35.string().optional()
+});
+var LandingEditDto = z35.object({
+  id: z35.string(),
+  scope: z35.enum([
+    "section",
+    "full"
+  ]),
+  sectionId: z35.string().nullable(),
+  message: z35.string(),
+  status: z35.enum([
+    "pending",
+    "processing",
+    "applied",
+    "failed",
+    "reverted"
+  ]),
+  costCents: z35.number(),
+  error: z35.string().nullable(),
+  createdAt: z35.string()
+});
+var CreateLandingEditResponse = z35.object({
+  edit: LandingEditDto,
+  chargedCredits: z35.number()
+});
+var ListLandingEditsResponse = z35.object({
+  edits: z35.array(LandingEditDto)
+});
 
 // ../../packages/types/src/video-edit.ts
 import { z as z36 } from "zod";
@@ -6834,12 +7179,17 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "create_creative_variant",
     confirmation: "credit_consuming",
-    schemaHash: "8feeed1e6e6a14bdcb0a1d9d8b03350ce7d8117d926db49f19ca5c5a8f1e7033"
+    schemaHash: "6a777fbe7ad17966d16502e8872e15e4db2dcfacdfd2992d24853340d4f22a00"
   },
   {
     name: "create_product_task",
     confirmation: "credit_consuming",
-    schemaHash: "5b19f7c6dfdc55b0c472df045e24fe73aa134624a141b63342bfbd3bbb0d043b"
+    schemaHash: "3f03c4886f65a030e03a531c02e0ef879aaf3f5820e90ab3ca04a02350e693e6"
+  },
+  {
+    name: "edit_image_creative",
+    confirmation: "credit_consuming",
+    schemaHash: "ce0abba871436850bd1db0ea4bcdade9ef35420ebd83833e2d5c2dcf70378ec0"
   },
   {
     name: "edit_task_draft",
@@ -6849,7 +7199,7 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "estimate_creative_variant",
     confirmation: "none",
-    schemaHash: "a5601adcb9578319528ca0a96f37a35b613370646a75932d1b3978d593f7e302"
+    schemaHash: "d4453364c0706bf88f480cebc977916f06d222d7eebebc9cfa91165929a1a998"
   },
   {
     name: "find_winning_products",
@@ -6864,17 +7214,17 @@ var PRODUCTMAKER_MCP_CAPABILITIES = [
   {
     name: "generate_image_creatives",
     confirmation: "credit_consuming",
-    schemaHash: "82b520e8001e9c57ab0a89d9d66ea5dfc92e6306eed302edfe1005cee5025fbf"
+    schemaHash: "bf6a7599dac65c31a43e23badad8fd8e1ab3e8aee8a5a55ac47f9c39268b2fa6"
   },
   {
     name: "generate_landing",
     confirmation: "credit_consuming",
-    schemaHash: "23f0c56dc719235e51d16fd61a9703b64fa6d300356ffbf6b21d703324b0bb18"
+    schemaHash: "15465f9bda1ec945cc49f4f4a830d56a17a43b0cb5f6063d5594ddc92c830c21"
   },
   {
     name: "generate_video_creative",
     confirmation: "credit_consuming",
-    schemaHash: "79d3ec9310885b482d62c94a27e9c039833c0619d9332a593fe7d32a60ae1388"
+    schemaHash: "c80208df75f2c7cbc459e9ae494a75a0a5f5bc4cf044b3fc9ef9c0e9af2c2452"
   },
   {
     name: "get_meta_campaign_status",
@@ -7235,6 +7585,7 @@ var VideoPresetEnum = z39.enum([
   "ugc_dynamic",
   "ugc_how_to",
   "ugc_unboxing_chaos",
+  "problem_solution",
   "product_showcase",
   "wearable_showcase",
   "cinematic",
@@ -7246,6 +7597,7 @@ var TaskCreativeVariantVideoPresetEnum = z39.enum([
   "auto",
   "ugc_dynamic",
   "ugc_how_to",
+  "problem_solution",
   "product_showcase",
   "cinematic",
   "wild_card",
@@ -7271,6 +7623,11 @@ var VIDEO_PRESET_RESOLUTION = {
     narrativeStyle: "ugc_unboxing_chaos",
     videoModel: "veo"
   },
+  problem_solution: {
+    videoStyle: "ai_dynamic",
+    narrativeStyle: "problem_product_cta",
+    videoModel: "kling"
+  },
   pixar_problem: {
     videoStyle: "ai_dynamic",
     narrativeStyle: "animated_problem_pixar",
@@ -7318,6 +7675,12 @@ function resolveWireVideoTier(tier, durationSeconds) {
   return durationSeconds === 30 ? "standard" : resolveVideoTier(tier);
 }
 __name(resolveWireVideoTier, "resolveWireVideoTier");
+function assertVideoPresetDurationCompatibility(videoPreset, durationSeconds) {
+  if (videoPreset === "problem_solution" && durationSeconds !== 30) {
+    throw new Error("Problema y Soluci\xF3n solo est\xE1 disponible en videos Multiescena de 30 segundos.");
+  }
+}
+__name(assertVideoPresetDurationCompatibility, "assertVideoPresetDurationCompatibility");
 function resolveVideoFormatForDuration(durationSeconds) {
   return durationSeconds === 30 ? "double_30s" : "single_15s";
 }
@@ -7353,6 +7716,7 @@ var PublicNarrativeStyleEnum = z39.enum([
   "review",
   "ugc_how_to",
   "ugc_unboxing_chaos",
+  "problem_product_cta",
   "product_showcase",
   "wearable_showcase",
   "cinematic",
@@ -7994,6 +8358,7 @@ function proxifyOutputs(outputs, proxyBaseUrl) {
   }) ?? url, "rewrite");
   return {
     webappUrl: outputs.webappUrl,
+    adCopy: outputs.adCopy,
     images: outputs.images.map((img, i) => ({
       ...img,
       url: rewrite(img.url, `image-${i}.png`)
@@ -8061,7 +8426,8 @@ async function fetchTaskOutputs(api, taskId) {
     landing: {
       sections
     },
-    images
+    images,
+    adCopy: typeof raw.adCreative?.adCopy === "string" && raw.adCreative.adCopy.length ? raw.adCreative.adCopy : void 0
   };
 }
 __name(fetchTaskOutputs, "fetchTaskOutputs");
@@ -8076,6 +8442,10 @@ function renderOutputsMarkdown(outputs) {
       parts.push(`[\u2B07 Descargar v${i}](${img.url})`);
     });
   }
+  if (outputs.adCopy) {
+    parts.push("\n### Ad copy");
+    parts.push(outputs.adCopy);
+  }
   if (outputs.landing.sections.length) {
     parts.push(`
 ### Landing (${outputs.landing.sections.length} secciones)`);
@@ -8109,7 +8479,7 @@ var CreateProductTaskInput = z40.object({
   paymentMethods: z40.string().min(1).max(240).optional().describe('Opcional. M\xE9todos de pago que puede mostrar la landing. Ej. "Tarjeta, PSE, Nequi, Contraentrega". Si se omite, la landing no muestra m\xE9todos de pago.'),
   productContext: z40.string().max(3e3).optional().describe("Opcional. Informacion adicional del producto que la IA debe usar como contexto prioritario: uso real, comprador, restricciones, diferenciadores o direccion creativa. No reemplaza la investigacion de competencia; si hay competencia, guia el primer angulo y los outputs no deben contradecirlo."),
   productLabel: z40.string().trim().max(80).optional().describe('Opcional. Qu\xE9 es el producto, en pocas palabras (ej. "quita pelusas para ropa"). Es AUTORITATIVO: si lo env\xEDas, la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA detecta el producto desde la imagen.'),
-  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan a 15s y 30s. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
+  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets funcionan a 15s y 30s, excepto "problem_solution", que requiere 30s Multiescena. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla). Si el usuario pide algo fuera de esta lista, p\xEDdele una opci\xF3n v\xE1lida.'),
   durationSeconds: z40.union([
     z40.literal(15),
     z40.literal(30)
@@ -8118,7 +8488,7 @@ var CreateProductTaskInput = z40.object({
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista" para 15s; al pedir durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   multiAngleVideos: z40.boolean().optional().describe("Opcional. Si true, genera m\xFAltiples \xE1ngulos de venta en paralelo (3-5 videos). Si false/omitido, genera 1 video del \xE1ngulo principal. Default false."),
-  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar". angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para varios \xE1ngulos.'),
+  angleNarratives: PublicNarrativeStyleEnum.array().max(3).optional().describe('Opcional. Narrativa POR \xC1NGULO (posicional). Valores actuales: "review", "ugc_how_to", "ugc_unboxing_chaos", "problem_product_cta" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase", "wearable_showcase", "cinematic", "wild_card", "animated_problem_pixar", "sassy_product_pixar". angleNarratives[i] fuerza la narrativa del \xE1ngulo i; las posiciones restantes las elige la IA. Requiere multiAngleVideos:true para varios \xE1ngulos.'),
   outputs: z40.array(z40.enum([
     "landing",
     "video",
@@ -8127,6 +8497,8 @@ var CreateProductTaskInput = z40.object({
   competitorScanEnabled: z40.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z40.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
   creativeDirection: z40.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: z40.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: z40.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.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution", "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social), "benefits_clarity", "offer_value" o "lifestyle_identity". Default "classic".'),
   landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica cuando landing est\xE1 entre outputs: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
 }).strict();
@@ -8293,6 +8665,7 @@ __name(resolveStatusTaskKind, "resolveStatusTaskKind");
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
   server.tool("create_product_task", "Crea una tarea de producto desde fotos o desde un proyecto guiado propio. Por defecto genera los 3 outputs (landing + video + image creatives) EN UN MISMO TASK. Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero) O projectId si el proyecto ya tiene una imagen guardada; adem\xE1s language y country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son inputs de alto impacto en la landing y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto del chat: preg\xFAntale expl\xEDcitamente, incluso si est\xE1 en LATAM.\n\nSi env\xEDas projectId, debe ser el proyecto propio que el usuario acaba de costear; el backend resolver\xE1 la imagen privada y conservar\xE1 todos los controles de cr\xE9ditos/confirmaci\xF3n. Si el usuario adjunta images junto con projectId, esas fotos reemplazan la referencia solo para este task.\n\nANTES de invocar, DILE CLARAMENTE qu\xE9 outputs vas a generar y que `create_product_task` los genera juntos en un mismo task.\n\nUsa SOLO valores declarados en los enums.", CreateProductTaskInput.shape, async (input) => {
     try {
+      assertVideoPresetDurationCompatibility(input.videoPreset, input.durationSeconds);
       if (!input.images && !input.projectId) {
         throw new Error("images es requerido salvo que env\xEDes projectId.");
       }
@@ -8328,6 +8701,8 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
         "options.competitorScanEnabled": input.competitorScanEnabled,
         "options.brandId": input.brandId,
         "options.creativeDirection": input.creativeDirection,
+        "options.headline": input.headline,
+        "options.subheadline": input.subheadline,
         "options.landingStrategy": input.landingStrategy,
         "options.landingImageFormat": input.landingImageFormat,
         pauseForAngleReview: input.pauseForAngleReview,
@@ -8592,7 +8967,9 @@ var CreativeRefs = {
   competitorScanEnabled: z41.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z41.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo."),
   projectId: z41.string().uuid().optional().describe("Opcional. ID de un proyecto guiado de dropshipping activo del usuario. Enlaza esta generaci\xF3n con su progreso y recompensas."),
-  creativeDirection: z41.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.')
+  creativeDirection: z41.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Aplica SOLO a im\xE1genes y landing. Ej. im\xE1genes: "amarillo, azul y rojo, minimalista"; landing: "elegante, paleta fr\xEDa". Para video usa scriptNotes (ambiente/escenario). M\xE1x 500 caracteres.'),
+  headline: z41.string().max(120).optional().describe("Opcional. Titular EXACTO a renderizar en la imagen (o en la portada de la landing). Se imprime tal cual: la IA no lo reescribe, no lo acorta y no lo traduce. \xDAsalo cuando el copy es de marca y no es negociable. M\xE1x 120 caracteres. Si lo omites, la IA escribe el titular."),
+  subheadline: z41.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.")
 };
 var VideoInput = z41.object({
   images: CreativeRefs.images,
@@ -8609,7 +8986,7 @@ var VideoInput = z41.object({
     z41.literal(15),
     z41.literal(30)
   ]).default(15).describe("Opcional. Duraci\xF3n objetivo: 15s (single_call, default) o 30s (Multiescena, aproximadamente 30s y facturado por escena)."),
-  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Los presets funcionan a 15s y 30s. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla).'),
+  videoPreset: VideoPresetEnum.default("auto").describe('Opcional. Tipo/narrativa del video \u2014 \xFAnico campo de "estilo" que el usuario controla. Default "auto" (la IA escoge tras analizar el producto). Todos los presets funcionan a 15s y 30s, excepto "problem_solution", que requiere 30s Multiescena. Opciones: "auto", "ugc_dynamic" (review con experiencia y prueba), "ugc_how_to" (tutorial con pasos y resultado visible), "ugc_unboxing_chaos" (apertura y primera prueba), "problem_solution" (problema concreto, producto como soluci\xF3n y CTA), "product_showcase" (producto ejecutando una funci\xF3n real), "wearable_showcase" (prenda o accesorio modelado), "cinematic" (TV spot con receta cinematogr\xE1fica), "wild_card" (una regla visual experimental original), "pixar_problem" (problema animado 3D), "pixar_sassy" (producto que habla).'),
   videoTier: VideoTierEnum.optional().describe('Opcional. Estilo del video. "basic" = "Realista"; para durationSeconds=30 el sistema selecciona internamente Multiescena. No se expone el tier interno directamente.'),
   videoResolution: VideoResolutionEnum.optional().describe('Opcional. Resoluci\xF3n del render. En la web se pregunta "\xBFResoluci\xF3n del video?". "480p" = excelente calidad y m\xE1s econ\xF3mico (RECOMENDADO, default si se omite); "720p" = m\xE1xima nitidez, entre 3% y 15% m\xE1s caro seg\xFAn formato y tier. Si el usuario no menciona resoluci\xF3n, OMITE este campo (el backend usa 480p).'),
   features: z41.array(z41.string()).optional().describe('Opcional. Lista de features/beneficios clave a mencionar. Ej. ["resistente al agua", "bater\xEDa 24h", "carga inal\xE1mbrica"].'),
@@ -8688,7 +9065,14 @@ var ImageInput = z41.object({
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
   brandId: CreativeRefs.brandId,
   projectId: CreativeRefs.projectId,
-  creativeDirection: CreativeRefs.creativeDirection
+  creativeDirection: CreativeRefs.creativeDirection,
+  headline: CreativeRefs.headline,
+  subheadline: CreativeRefs.subheadline
+});
+var EditImageCreativeInput = z41.object({
+  taskId: z41.string().uuid().describe("ID de la tarea de imagen ya finalizada."),
+  variantIndex: z41.number().int().min(0).max(10).describe("\xCDndice de la variante a corregir (0 = primera imagen)."),
+  instruction: z41.string().min(1).max(1e3).describe('Qu\xE9 cambiar en esa imagen. Ej. "quita el badge de env\xEDo gratis", "cambia el fondo a blanco".')
 });
 var LandingInput = z41.object({
   images: CreativeRefs.images,
@@ -8708,7 +9092,9 @@ var LandingInput = z41.object({
   projectId: CreativeRefs.projectId,
   creativeDirection: CreativeRefs.creativeDirection,
   landingStrategy: LandingStrategyEnum.default("classic").describe('Opcional. Estructura de la landing cl\xE1sica: "classic" (estructura original probada y recomendada; default del primer rollout), "auto" (la IA decide; experimental), "pain_solution" (problema\u2192soluci\xF3n), "social_proof" (Landing Viral: UGC, WhatsApp, Instagram y evidencia social), "benefits_clarity" (beneficios claros), "offer_value" (promoci\xF3n/valor) o "lifestyle_identity" (estilo de vida). Default "classic".'),
-  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".')
+  landingImageFormat: LandingImageFormatEnum.default("9:16").describe('Opcional. Formato/relaci\xF3n de aspecto de las im\xE1genes de la landing cl\xE1sica: "9:16" (vertical, por defecto), "4:5" (vertical compacto para feed) o "1:1" (cuadrado). Default "9:16".'),
+  headline: CreativeRefs.headline,
+  subheadline: CreativeRefs.subheadline
 });
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
   server.tool("generate_free_video", 'Genera UN video libre con prompt/guion exacto, opcionalmente con imagen de referencia. Devuelve un taskId y procesa el job de forma as\xEDncrona.\n\nREQUERIDOS: rawPrompt, quality, durationSeconds y videoResolution.\n\nCALIDAD: "economical" = Econ\xF3mico y "high_detail" = Alto detalle. La duraci\xF3n debe pertenecer a la lista admitida por la calidad escogida; si el usuario pide otra, preg\xFAntale una duraci\xF3n v\xE1lida.\n\nSUBT\xCDTULOS: si addSubtitles=true, el rawPrompt completo se usa como texto exacto de subt\xEDtulos y debe tener m\xE1ximo 500 caracteres; no existe una pregunta adicional de transcripci\xF3n.\n\nPara videos normales con narrativa/\xE1ngulo usa generate_video_creative. Para tareas combinadas de producto usa create_product_task.', FreeVideoInput.shape, async (input) => {
@@ -8743,6 +9129,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
   });
   server.tool("generate_video_creative", 'Genera UN video creativo independiente. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), title, primaryAngle, language, country, aspectRatio.\n\nANTES de invocar, PREG\xDANTALE al usuario por price y offer si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos): durationSeconds (15 o 30), videoPreset (tipo/narrativa del video), features, cta, scriptNotes (dirige el guion Y el ambiente/escenario/est\xE9tica del video, ej. "en una playa, opulento").\n\nESTILO: 15s usa "Realista" (single_call); 30s usa "Multiescena" (multi-toma, aproximadamente 30s). Multiescena se factura por escena, as\xED que avisa el costo antes de activarlo.\n\nGUION: el usuario NO escribe el guion desde cero \u2014 la IA lo redacta. Si quiere REVISARLO/EDITARLO antes de renderizar (igual que en la web), pasa `pauseForVideoScriptReview: true`; cuando la tarea quede pausada, usa get_video_script para leer las escenas, ofr\xE9celas al usuario, y llama approve_video_script con las ediciones. Para dirigir el guion ANTES de generar (sin pausar), usa scriptNotes. Para revisar el \xE1ngulo y decidir duraci\xF3n tras el an\xE1lisis de competencia, pasa `pauseForAngleReview: true` y luego resuelve `angle_review_approval` con `gapDurationSeconds`.', VideoInput.shape, async (input) => {
     try {
+      assertVideoPresetDurationCompatibility(input.videoPreset, input.durationSeconds);
       const resolved = resolveVideoPreset(input.videoPreset);
       const wireTier = resolveWireVideoTier(input.videoTier, input.durationSeconds);
       const { videoTier: _publicTier, videoResolution: _vr, projectId, ...rest } = input;
@@ -8784,6 +9171,17 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
+  server.tool("edit_image_creative", "Corrige UNA imagen ya generada de una tarea de creativos, sin regenerar el set completo.\n\nCUESTA CR\xC9DITOS: cobra una sola imagen (sin brief ni extracci\xF3n), mucho menos que volver a generar todo. ANTES de invocar, PREG\xDANTALE al usuario si quiere pagar esa correcci\xF3n.\n\nSolo funciona con la tarea en estado `done` \u2014 si a\xFAn est\xE1 procesando, espera con get_task_status. Una tarea en error terminal no se puede corregir.\n\nUsa variantIndex para elegir cu\xE1l de las im\xE1genes corregir (0 = la primera) e instruction para describir el cambio en lenguaje natural.", EditImageCreativeInput.shape, async (input) => {
+    try {
+      const r = await api.postJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/regenerate`, {
+        comment: input.instruction,
+        variantIndex: input.variantIndex
+      });
+      return asText(r);
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
   server.tool("generate_landing", 'Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. Devuelve un taskId.\n\nREQUERIDOS: images (array de 1-5 fotos), language, country.\n\nANTES de invocar, PREG\xDANTALE al usuario por price, offer y paymentMethods si no los mencion\xF3 \u2014 son los inputs de mayor impacto en conversi\xF3n y nunca debes asumirlos. Si hay descuento, pregunta tambi\xE9n compareAtPrice. NO defaultes country/language desde el contexto: preg\xFAntale expl\xEDcitamente. Si el usuario te dice "t\xFA elige" para esos campos, om\xEDtelos.\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults): salesAngle, buyerPersona, isCombo, creativeDirection, landingStrategy.', LandingInput.shape, async (input) => {
     try {
       const { projectId, ...rest } = input;