@productmaker/mcp 8.7.0 → 8.8.0

package/dist/http.js

@@ -1998,6 +1998,28 @@ var CreativeGeneratorJob = z14.object({
   referenceVersionId: z14.string().uuid().optional(),
   cleanImagesWaitAttempt: z14.number().int().nonnegative().optional()
 });
+var ImageCreativeEditStatus = z14.enum([
+  "queued",
+  "processing",
+  "published",
+  "failed"
+]);
+var ImageCreativeRegenerateRequest = z14.object({
+  variantIndex: z14.number().int().nonnegative(),
+  comment: z14.string().trim().min(1).max(1e3),
+  clientRequestId: z14.string().trim().min(1).max(160).optional()
+});
+var ImageCreativeEditStatusResponse = z14.object({
+  ok: z14.literal(true),
+  operationId: z14.string().uuid(),
+  taskId: z14.string().uuid(),
+  variantIndex: z14.number().int().nonnegative(),
+  status: ImageCreativeEditStatus,
+  assetKey: z14.string().optional(),
+  assetUrl: z14.string().url().optional(),
+  degraded: z14.boolean(),
+  error: z14.string().nullable()
+});
 
 // ../../packages/types/src/product-label.ts
 import { z as z15 } from "zod";
@@ -5189,8 +5211,10 @@ var VideoGenerator = z27.object({
   // `result.ts`. Write-side caps (angle.ts, wizard.ts, task-creative-variants.ts)
   // intentionally stay at 360.
   buyerPersona: z27.string().min(1).max(1200).optional(),
-  script: z27.string().min(1),
-  prompt: z27.string().min(1),
+  // Read contract: pending/pre-plan failed rows have no authored text yet.
+  // Preserve their empty fields and outcome; successful rows are checked below.
+  script: z27.string(),
+  prompt: z27.string(),
   // Empty string allowed: Pro pipeline pauses for script review BEFORE the grid
   // extraction that produces the Frame A URL; imageUrl stays '' until then.
   imageUrl: z27.string().url().or(z27.literal("")),
@@ -5216,11 +5240,29 @@ var VideoGenerator = z27.object({
   execution: VideoExecutionContract.optional(),
   adCopy: z27.string().optional(),
   /** TRUE when the seller APPROVED a script for this angle that the plan path
-  *  could not honor, so a fresh script was re-authored and rendered instead
-  *  (PR #1470). The angle still delivered — nothing was lost and nothing is
-  *  refundable — but the video is NOT the script they signed off on, and the
-  *  UI must say so. Absent (never `false`) on every honest delivery. */
+   *  could not honor, so a fresh script was re-authored and rendered instead
+   *  (PR #1470). The angle still delivered — nothing was lost and nothing is
+   *  refundable — but the video is NOT the script they signed off on, and the
+   *  UI must say so. Absent (never `false`) on every honest delivery. */
   scriptRewritten: z27.boolean().optional()
+}).superRefine((record, ctx) => {
+  if (record.status !== "success") return;
+  for (const field of [
+    "script",
+    "prompt"
+  ]) {
+    if (record[field].length > 0) continue;
+    ctx.addIssue({
+      code: z27.ZodIssueCode.too_small,
+      minimum: 1,
+      type: "string",
+      inclusive: true,
+      path: [
+        field
+      ],
+      message: "Successful video results require authored text"
+    });
+  }
 });
 var VideoScriptSceneForReview = z27.object({
   index: z27.number().int().nonnegative(),
@@ -6451,7 +6493,10 @@ var MVPResult = z35.object({
   landing: z35.object({
     // Allow legacy data (10 sections × 2 variants) and new data (7 sections × 2)
     images: z35.array(LandingImageReadable).max(MAX_LANDING_IMAGES),
-    manifestVersion: z35.literal("v1")
+    manifestVersion: z35.literal("v1"),
+    // Landing-scoped on purpose: the regeneration dialog warns that provider
+    // policy can block edits for licensed-character products.
+    licensedCharacter: z35.boolean().optional()
   }),
   videoGenerators: z35.array(VideoGenerator).min(1).optional(),
   videoStructure: VideoStructure.optional(),
@@ -9624,12 +9669,12 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.2,
     userPriceCents: 0.4
   },
-  // Landing image QA (gemini-3.8-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¢.
+  // Landing image QA (Qwen-2.5-VL-72B since 2026-10-02, 1-2 images). Anatomy/text/background cutoff.
+  // Measured on owner corpus with Qwen-2.5-VL-72B: ~1,500 prompt tokens + 150 completion ≈ $0.00135 (0.135¢ our cost).
+  // 0.25¢ ourCost keeps ~80% headroom; 2x house markup.
   "openrouter:landing-image-qa": {
-    ourCostCents: 1.88,
-    userPriceCents: 3.76
+    ourCostCents: 0.25,
+    userPriceCents: 0.5
   },
   // Usage decider (role `usage-decider`: Gemini 3.8 Flash effort:'high' since
   // 05f543eae, ≤6 images + seller text, temperature 0 json_object, once per
@@ -9706,9 +9751,10 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.82,
     userPriceCents: 1.64
   },
+  // Creative image anatomy QA (Qwen-2.5-VL-72B since 2026-10-02). Sized identically to landing-image-qa.
   "openrouter:creative-image-anatomy-qa": {
-    ourCostCents: 1.88,
-    userPriceCents: 3.76
+    ourCostCents: 0.25,
+    userPriceCents: 0.5
   },
   // Anatomy check (Gemini 3 Flash Preview, 1 image). Standalone anatomy verification.
   "openrouter:anatomy-check": {
@@ -9954,24 +10000,19 @@ var DEFAULT_PRICING = {
     userPriceCents: 4.5
   },
   // (d) DENSE anatomy detector (the default anatomy detector since 2026-09-26;
-  //     QA_ANATOMY_DETECTOR=frame_judge reverts): gemini-3.1-pro judges every extracted
-  //     frame at 1 fps, 5 frames per call, each call billing its frame count — the rate is
+  //     QA_ANATOMY_DETECTOR=frame_judge reverts): Qwen-2.5-VL-72B judges extracted
+  //     frames at 1 fps, 5 frames per call, each call billing its frame count — the rate is
   //     PER FRAME like (b) and scales with QA_DENSE_DETECTOR_MAX_FRAMES. Measured on the
   //     owner corpus with the shipped config (reasoning=low, grouped): $1.062 / 296 frames
-  //     ≈ 0.36c/frame; 0.5c keeps ~40% headroom. The old 3.0c fallback was the 2026-09-22
-  //     one-still-per-call spike at default reasoning (~1.95c/frame) and would have quoted
-  //     QA ~10x its cost. Re-derive from 30d BillingEntry once live.
+  //     ≈ 0.36c/frame; 0.5c keeps ~40% headroom. Preserved to protect the 30d video credit gate
+  //     ceiling until 30d of live Qwen volume is recorded. Re-derive from 30d BillingEntry once live.
   "openrouter:video-qa-anatomy-dense-detector": {
     ourCostCents: 0.5,
     userPriceCents: 1
   },
-  // (e) Dense-mode tracing confirmation: the SAME confirmer call as (c) but routed
-  //     to gemini-3.1-pro — flash measured 3/11 recall confirming dense stills, so
-  //     dense findings never confirm on the gate model. PER CALL.
-  //     Spike measured $2.22/80 ≈ 2.8c/call; the 2026-09-26 A/B measured 2.6c/flag.
-  //     3.0c keeps it above both. (The former 5.0c/10.0c, times the old 4-confirmation cap,
-  //     inflated the credit gate's `max` by up to ~12,600 credits on a 30 s multi-scene.)
-  //     Re-derive from 30d BillingEntry once live.
+  // (e) Dense-mode tracing confirmation: Qwen-2.5-VL-72B evaluates 3 frames (t-1, t, t+1)
+  //     per flagged finding. Preserved to protect the 30d video credit gate ceiling
+  //     until 30d of live Qwen volume is recorded. Re-derive from 30d BillingEntry once live.
   "openrouter:video-qa-anatomy-dense-confirm": {
     ourCostCents: 3,
     userPriceCents: 6
@@ -10946,71 +10987,106 @@ var MixAxes = z51.object({
   person: z51.boolean(),
   setting: z51.boolean()
 });
-var MixReferences = z51.object({
-  product: z51.array(PublicHttpsUrl).max(3, "at most 3 product references"),
-  person: z51.array(PublicHttpsUrl).max(3, "at most 3 person references"),
-  setting: z51.array(PublicHttpsUrl).max(3, "at most 3 setting references")
-});
+function createMixReferences(url) {
+  return z51.object({
+    product: z51.array(url).max(3, "at most 3 product references"),
+    person: z51.array(url).max(3, "at most 3 person references"),
+    setting: z51.array(url).max(3, "at most 3 setting references")
+  });
+}
+__name(createMixReferences, "createMixReferences");
+var MixReferences = createMixReferences(PublicHttpsUrl);
+var MAX_VIDEO_MIX_REFERENCE_IMAGES = 5;
+function countGeneratedVideoMixReferences(axes, references) {
+  return Number(axes.person && references.person.length === 0) + Number(axes.setting && references.setting.length === 0);
+}
+__name(countGeneratedVideoMixReferences, "countGeneratedVideoMixReferences");
+function countVideoMixReferenceImages(axes, references) {
+  return (axes.product ? references.product.length : 0) + (axes.person ? references.person.length : 0) + (axes.setting ? references.setting.length : 0) + countGeneratedVideoMixReferences(axes, references);
+}
+__name(countVideoMixReferenceImages, "countVideoMixReferenceImages");
 var MixImageEdit = z51.object({
   instruction: z51.string().min(1).max(600),
   imageUrls: z51.array(MixImageUrl).min(1).max(3)
 });
-var MixRequest = z51.object({
-  mediaType: z51.enum(MEDIA_TYPES),
-  originalUrl: z51.union([
-    PublicHttpsUrl,
-    InternalAssetPath
-  ]),
-  axes: MixAxes,
-  references: MixReferences,
-  personText: z51.string().max(500).optional(),
-  settingText: z51.string().max(500).optional(),
-  /**
-   * Optional public URL of a user-uploaded audio file (mp3/wav). Wan Video
-   * Edit has no audio input and the mix never lipsyncs: the Wan output is
-   * muted and, when this is set, the assemble worker mux'es THIS audio
-   * (instead of the original video's track) into the final concatenated mp4
-   * (mute + overlay). No per-scene slicing, no `reference_audio_urls`.
-   */
-  audioUrl: PublicHttpsUrl.optional(),
-  resolution: z51.enum(RESOLUTIONS).default("720p"),
-  originalDurationSec: z51.number().positive().max(600).optional(),
-  image: MixImageEdit.optional(),
-  sourceTaskId: z51.string().max(64).optional(),
-  sourceCreativeId: z51.string().max(64).optional()
-}).superRefine((req, ctx) => {
-  if (req.mediaType === "image") {
-    if (!req.image) {
+function createMixRequestSchema(allowAdditionalUrl) {
+  const acceptsUrl = /* @__PURE__ */ __name((url) => isPublicHttpsUrl(url) || Boolean(allowAdditionalUrl?.(url)), "acceptsUrl");
+  const acceptedUrl = z51.string().url().refine(acceptsUrl, {
+    message: "must be a public HTTPS URL"
+  });
+  return z51.object({
+    mediaType: z51.enum(MEDIA_TYPES),
+    originalUrl: z51.union([
+      acceptedUrl,
+      InternalAssetPath
+    ]),
+    axes: MixAxes,
+    references: createMixReferences(acceptedUrl),
+    personText: z51.string().max(500).optional(),
+    settingText: z51.string().max(500).optional(),
+    /**
+    * Optional public URL of a user-uploaded audio file (mp3/wav). Wan Video
+    * Edit has no audio input and the mix never lipsyncs: the Wan output is
+    * muted and, when this is set, the assemble worker mux'es THIS audio
+    * (instead of the original video's track) into the final concatenated mp4
+    * (mute + overlay). No per-scene slicing, no `reference_audio_urls`.
+    */
+    audioUrl: acceptedUrl.optional(),
+    resolution: z51.enum(RESOLUTIONS).default("720p"),
+    originalDurationSec: z51.number().positive().max(600).optional(),
+    image: MixImageEdit.extend({
+      imageUrls: z51.array(z51.union([
+        acceptedUrl,
+        InternalAssetPath
+      ])).min(1).max(3)
+    }).optional(),
+    sourceTaskId: z51.string().max(64).optional(),
+    sourceCreativeId: z51.string().max(64).optional()
+  }).superRefine((req, ctx) => {
+    if (req.mediaType === "image") {
+      if (!req.image) {
+        ctx.addIssue({
+          code: "custom",
+          message: "image mix requires an image edit (instruction + 1-3 images)"
+        });
+      }
+      return;
+    }
+    if (!acceptsUrl(req.originalUrl)) {
       ctx.addIssue({
         code: "custom",
-        message: "image mix requires an image edit (instruction + 1-3 images)"
+        path: [
+          "originalUrl"
+        ],
+        message: "must be a public HTTPS URL"
       });
     }
-    return;
-  }
-  if (!isPublicHttpsUrl(req.originalUrl)) {
-    ctx.addIssue({
-      code: "custom",
-      path: [
-        "originalUrl"
-      ],
-      message: "must be a public HTTPS URL"
-    });
-  }
-  if (req.axes.product && req.references.product.length === 0) {
-    ctx.addIssue({
-      code: "custom",
-      message: "product references required when product axis active"
-    });
-  }
-  const anyAxis = req.axes.product || req.axes.person || req.axes.setting;
-  if (!anyAxis && !req.audioUrl) {
-    ctx.addIssue({
-      code: "custom",
-      message: "mix requires at least one axis to swap or a user audio"
-    });
-  }
-});
+    if (req.axes.product && req.references.product.length === 0) {
+      ctx.addIssue({
+        code: "custom",
+        message: "product references required when product axis active"
+      });
+    }
+    if (countVideoMixReferenceImages(req.axes, req.references) > MAX_VIDEO_MIX_REFERENCE_IMAGES) {
+      ctx.addIssue({
+        code: "custom",
+        path: [
+          "references"
+        ],
+        message: `video mix accepts at most ${MAX_VIDEO_MIX_REFERENCE_IMAGES} reference images, including generated axes`
+      });
+    }
+    const anyAxis = req.axes.product || req.axes.person || req.axes.setting;
+    if (!anyAxis && !req.audioUrl) {
+      ctx.addIssue({
+        code: "custom",
+        message: "mix requires at least one axis to swap or a user audio"
+      });
+    }
+  });
+}
+__name(createMixRequestSchema, "createMixRequestSchema");
+var MixRequest = createMixRequestSchema();
 var ReferenceMap = z51.object({
   product: z51.object({
     start: z51.number().int(),
@@ -11110,6 +11186,7 @@ var MixResult = z51.object({
 });
 
 // ../../packages/types/src/mix-cost.ts
+var IMAGE_GEN_USER_PRICE_CENTS = DEFAULT_PRICING["kie:image-generation:gpt-image-2-5-sunburst-text-to-image"].userPriceCents;
 var MAX_QA_RETRIES_PER_SCENE_UPPER_BOUND = 1;
 var MAX_BILLABLE_GENERATIONS_PER_BLOCK = 1 + MAX_QA_RETRIES_PER_SCENE_UPPER_BOUND;
 
@@ -11349,6 +11426,13 @@ var RegenerateLandingRoleResponse = z55.object({
   promptIndex: z55.number().int().nonnegative(),
   operationId: z55.string().min(1)
 });
+var LandingRegenerationFailureCode = z55.enum([
+  "licensed_character_blocked",
+  "provider_policy_blocked",
+  "qa_rejected",
+  "superseded",
+  "provider_error"
+]);
 var LandingRegenerationStatusResponse = z55.object({
   ok: z55.literal(true),
   operationId: z55.string().min(1),
@@ -11356,6 +11440,7 @@ var LandingRegenerationStatusResponse = z55.object({
   status: LandingRegenerationStatus,
   refunded: z55.boolean(),
   failureReason: z55.string().nullable(),
+  failureCode: LandingRegenerationFailureCode.nullable().optional(),
   publishedAssetKey: z55.string().nullable(),
   updatedAt: z55.string().datetime()
 });
@@ -12313,6 +12398,23 @@ var CAPABILITY_MODEL_GUIDANCE = {
       "es trabajo pagado y requiere confirmaci\xF3n expl\xEDcita"
     ]
   },
+  get_image_edit_status: {
+    summary: "Consulta s\xF3lo el estado durable de una correcci\xF3n aceptada y su imagen entregada. No genera ni reintenta im\xE1genes; Task.done no significa que esta correcci\xF3n haya terminado.",
+    useWhen: [
+      "una correcci\xF3n de imagen ya devolvi\xF3 su operaci\xF3n aceptada",
+      "la persona consulta el resultado de esa correcci\xF3n"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una operaci\xF3n aceptada"
+    ],
+    defaults: [
+      "consulta la misma operaci\xF3n hasta su publicaci\xF3n o fallo durable",
+      "un fallo al consultar no autoriza otra correcci\xF3n pagada"
+    ],
+    disclosures: [
+      "la consulta no consume cr\xE9ditos ni inicia trabajo"
+    ]
+  },
   edit_task_draft: {
     summary: "Edita el draft de un angle de marketing antes de la generaci\xF3n.",
     useWhen: [
@@ -14268,7 +14370,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "task",
     "video"
   ]),
-  defineCapability("edit_image_creative", "ce0abba871436850bd1db0ea4bcdade9ef35420ebd83833e2d5c2dcf70378ec0", "credit_consuming", "creative", [
+  defineCapability("edit_image_creative", "50eca473829328dfb63b9cbae03a9835b79c510e29528563e09b7eb3e5e9bca4", "credit_consuming", "creative", [
     "credit_consuming",
     "state_change"
   ], [
@@ -14278,12 +14380,27 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     ]),
     slot("edit_instruction", true, [
       "instruction"
-    ])
+    ]),
+    slot("client_request", false, [
+      "clientRequestId"
+    ], [], "server")
   ], [
     "creative"
   ], [
     "creative"
   ]),
+  defineCapability("get_image_edit_status", "fe59aefd433afe7e5a2d8b4a81084583750c1447c877b6bce698340326665141", "none", "read_only", [
+    "read"
+  ], [
+    slot("creative_operation", true, [
+      "taskId",
+      "operationId"
+    ], [], "server")
+  ], [
+    "creative_edit_operation"
+  ], [
+    "creative_edit_status"
+  ], MCP_ONLY_CHANNEL_EXPOSURE),
   defineCapability("edit_task_draft", "1c9343bdce51aac36ec6254557c8a904037746523168527f012b4c5b6361e98e", "state_change", "creative", [
     "state_change"
   ], [
@@ -18628,7 +18745,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "8.7.0";
+var MCP_VERSION = "8.8.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -22260,6 +22377,7 @@ import { z as z83 } from "zod";
 var generateFreeVideoGuidance = getProductMakerCapabilityModelGuidance("generate_free_video");
 var generateVideoCreativeGuidance = getProductMakerCapabilityModelGuidance("generate_video_creative");
 var generateImageCreativesGuidance = getProductMakerCapabilityModelGuidance("generate_image_creatives");
+var imageEditStatusGuidance = getProductMakerCapabilityModelGuidance("get_image_edit_status");
 var editImageCreativeGuidance = getProductMakerCapabilityModelGuidance("edit_image_creative");
 var generateLandingGuidance = getProductMakerCapabilityModelGuidance("generate_landing");
 var CreativeRefs = {
@@ -22481,6 +22599,7 @@ var ImageInput = z83.object({
 var EditImageCreativeInput = z83.object({
   taskId: z83.string().uuid().describe("ID de la tarea de imagen ya finalizada."),
   variantIndex: z83.number().int().min(0).max(10).describe("\xCDndice de la variante a corregir (0 = primera imagen)."),
+  clientRequestId: z83.string().min(1).max(160).optional().describe("Identidad estable de esta correcci\xF3n; reutil\xEDzala al reconciliar una respuesta perdida, no para otra instrucci\xF3n."),
   instruction: z83.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 = z83.object({
@@ -22755,13 +22874,30 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       await requirePaidCreativeConfirmation(server, `Correcci\xF3n pagada de la imagen ${input.variantIndex + 1}.`);
       const r = await api.postJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/regenerate`, {
         comment: input.instruction,
-        variantIndex: input.variantIndex
+        variantIndex: input.variantIndex,
+        ...input.clientRequestId ? {
+          clientRequestId: input.clientRequestId
+        } : {}
       });
       return asText(r);
     } catch (e) {
       throw translateError(e);
     }
   });
+  server.registerTool("get_image_edit_status", {
+    description: imageEditStatusGuidance.summary,
+    inputSchema: {
+      taskId: z83.string().uuid(),
+      operationId: z83.string().uuid()
+    },
+    annotations: READS_INTERNAL
+  }, async (input) => {
+    try {
+      return asText(await api.getJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/operations/${encodeURIComponent(input.operationId)}`));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
   server.registerTool("generate_landing", {
     description: generateLandingGuidance.summary + " No expone landing editable/code mientras siga siendo admin-only. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), language, country y creativeSetup. Ante \u201Ccrea una landing con este producto\u201D y una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. Presenta UN checklist compacto \u2014no preguntas seriales\u2014 con estrategia, formato, competencia, m\xE9todos de pago, contexto, direcci\xF3n creativa y headline/subheadline exactos opcionales. Prop\xF3n defaults recomendados; null significa que el usuario deleg\xF3 esa decisi\xF3n concreta, nunca que el agente la olvid\xF3.\n\nANTES de invocar, muestra el resumen y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.",
     inputSchema: LandingInput.shape,

package/dist/stdio.js

@@ -2020,6 +2020,28 @@ var CreativeGeneratorJob = z14.object({
   referenceVersionId: z14.string().uuid().optional(),
   cleanImagesWaitAttempt: z14.number().int().nonnegative().optional()
 });
+var ImageCreativeEditStatus = z14.enum([
+  "queued",
+  "processing",
+  "published",
+  "failed"
+]);
+var ImageCreativeRegenerateRequest = z14.object({
+  variantIndex: z14.number().int().nonnegative(),
+  comment: z14.string().trim().min(1).max(1e3),
+  clientRequestId: z14.string().trim().min(1).max(160).optional()
+});
+var ImageCreativeEditStatusResponse = z14.object({
+  ok: z14.literal(true),
+  operationId: z14.string().uuid(),
+  taskId: z14.string().uuid(),
+  variantIndex: z14.number().int().nonnegative(),
+  status: ImageCreativeEditStatus,
+  assetKey: z14.string().optional(),
+  assetUrl: z14.string().url().optional(),
+  degraded: z14.boolean(),
+  error: z14.string().nullable()
+});
 
 // ../../packages/types/src/product-label.ts
 import { z as z15 } from "zod";
@@ -5211,8 +5233,10 @@ var VideoGenerator = z27.object({
   // `result.ts`. Write-side caps (angle.ts, wizard.ts, task-creative-variants.ts)
   // intentionally stay at 360.
   buyerPersona: z27.string().min(1).max(1200).optional(),
-  script: z27.string().min(1),
-  prompt: z27.string().min(1),
+  // Read contract: pending/pre-plan failed rows have no authored text yet.
+  // Preserve their empty fields and outcome; successful rows are checked below.
+  script: z27.string(),
+  prompt: z27.string(),
   // Empty string allowed: Pro pipeline pauses for script review BEFORE the grid
   // extraction that produces the Frame A URL; imageUrl stays '' until then.
   imageUrl: z27.string().url().or(z27.literal("")),
@@ -5238,11 +5262,29 @@ var VideoGenerator = z27.object({
   execution: VideoExecutionContract.optional(),
   adCopy: z27.string().optional(),
   /** TRUE when the seller APPROVED a script for this angle that the plan path
-  *  could not honor, so a fresh script was re-authored and rendered instead
-  *  (PR #1470). The angle still delivered — nothing was lost and nothing is
-  *  refundable — but the video is NOT the script they signed off on, and the
-  *  UI must say so. Absent (never `false`) on every honest delivery. */
+   *  could not honor, so a fresh script was re-authored and rendered instead
+   *  (PR #1470). The angle still delivered — nothing was lost and nothing is
+   *  refundable — but the video is NOT the script they signed off on, and the
+   *  UI must say so. Absent (never `false`) on every honest delivery. */
   scriptRewritten: z27.boolean().optional()
+}).superRefine((record, ctx) => {
+  if (record.status !== "success") return;
+  for (const field of [
+    "script",
+    "prompt"
+  ]) {
+    if (record[field].length > 0) continue;
+    ctx.addIssue({
+      code: z27.ZodIssueCode.too_small,
+      minimum: 1,
+      type: "string",
+      inclusive: true,
+      path: [
+        field
+      ],
+      message: "Successful video results require authored text"
+    });
+  }
 });
 var VideoScriptSceneForReview = z27.object({
   index: z27.number().int().nonnegative(),
@@ -6473,7 +6515,10 @@ var MVPResult = z35.object({
   landing: z35.object({
     // Allow legacy data (10 sections × 2 variants) and new data (7 sections × 2)
     images: z35.array(LandingImageReadable).max(MAX_LANDING_IMAGES),
-    manifestVersion: z35.literal("v1")
+    manifestVersion: z35.literal("v1"),
+    // Landing-scoped on purpose: the regeneration dialog warns that provider
+    // policy can block edits for licensed-character products.
+    licensedCharacter: z35.boolean().optional()
   }),
   videoGenerators: z35.array(VideoGenerator).min(1).optional(),
   videoStructure: VideoStructure.optional(),
@@ -9646,12 +9691,12 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.2,
     userPriceCents: 0.4
   },
-  // Landing image QA (gemini-3.8-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¢.
+  // Landing image QA (Qwen-2.5-VL-72B since 2026-10-02, 1-2 images). Anatomy/text/background cutoff.
+  // Measured on owner corpus with Qwen-2.5-VL-72B: ~1,500 prompt tokens + 150 completion ≈ $0.00135 (0.135¢ our cost).
+  // 0.25¢ ourCost keeps ~80% headroom; 2x house markup.
   "openrouter:landing-image-qa": {
-    ourCostCents: 1.88,
-    userPriceCents: 3.76
+    ourCostCents: 0.25,
+    userPriceCents: 0.5
   },
   // Usage decider (role `usage-decider`: Gemini 3.8 Flash effort:'high' since
   // 05f543eae, ≤6 images + seller text, temperature 0 json_object, once per
@@ -9728,9 +9773,10 @@ var DEFAULT_PRICING = {
     ourCostCents: 0.82,
     userPriceCents: 1.64
   },
+  // Creative image anatomy QA (Qwen-2.5-VL-72B since 2026-10-02). Sized identically to landing-image-qa.
   "openrouter:creative-image-anatomy-qa": {
-    ourCostCents: 1.88,
-    userPriceCents: 3.76
+    ourCostCents: 0.25,
+    userPriceCents: 0.5
   },
   // Anatomy check (Gemini 3 Flash Preview, 1 image). Standalone anatomy verification.
   "openrouter:anatomy-check": {
@@ -9976,24 +10022,19 @@ var DEFAULT_PRICING = {
     userPriceCents: 4.5
   },
   // (d) DENSE anatomy detector (the default anatomy detector since 2026-09-26;
-  //     QA_ANATOMY_DETECTOR=frame_judge reverts): gemini-3.1-pro judges every extracted
-  //     frame at 1 fps, 5 frames per call, each call billing its frame count — the rate is
+  //     QA_ANATOMY_DETECTOR=frame_judge reverts): Qwen-2.5-VL-72B judges extracted
+  //     frames at 1 fps, 5 frames per call, each call billing its frame count — the rate is
   //     PER FRAME like (b) and scales with QA_DENSE_DETECTOR_MAX_FRAMES. Measured on the
   //     owner corpus with the shipped config (reasoning=low, grouped): $1.062 / 296 frames
-  //     ≈ 0.36c/frame; 0.5c keeps ~40% headroom. The old 3.0c fallback was the 2026-09-22
-  //     one-still-per-call spike at default reasoning (~1.95c/frame) and would have quoted
-  //     QA ~10x its cost. Re-derive from 30d BillingEntry once live.
+  //     ≈ 0.36c/frame; 0.5c keeps ~40% headroom. Preserved to protect the 30d video credit gate
+  //     ceiling until 30d of live Qwen volume is recorded. Re-derive from 30d BillingEntry once live.
   "openrouter:video-qa-anatomy-dense-detector": {
     ourCostCents: 0.5,
     userPriceCents: 1
   },
-  // (e) Dense-mode tracing confirmation: the SAME confirmer call as (c) but routed
-  //     to gemini-3.1-pro — flash measured 3/11 recall confirming dense stills, so
-  //     dense findings never confirm on the gate model. PER CALL.
-  //     Spike measured $2.22/80 ≈ 2.8c/call; the 2026-09-26 A/B measured 2.6c/flag.
-  //     3.0c keeps it above both. (The former 5.0c/10.0c, times the old 4-confirmation cap,
-  //     inflated the credit gate's `max` by up to ~12,600 credits on a 30 s multi-scene.)
-  //     Re-derive from 30d BillingEntry once live.
+  // (e) Dense-mode tracing confirmation: Qwen-2.5-VL-72B evaluates 3 frames (t-1, t, t+1)
+  //     per flagged finding. Preserved to protect the 30d video credit gate ceiling
+  //     until 30d of live Qwen volume is recorded. Re-derive from 30d BillingEntry once live.
   "openrouter:video-qa-anatomy-dense-confirm": {
     ourCostCents: 3,
     userPriceCents: 6
@@ -10968,71 +11009,106 @@ var MixAxes = z51.object({
   person: z51.boolean(),
   setting: z51.boolean()
 });
-var MixReferences = z51.object({
-  product: z51.array(PublicHttpsUrl).max(3, "at most 3 product references"),
-  person: z51.array(PublicHttpsUrl).max(3, "at most 3 person references"),
-  setting: z51.array(PublicHttpsUrl).max(3, "at most 3 setting references")
-});
+function createMixReferences(url) {
+  return z51.object({
+    product: z51.array(url).max(3, "at most 3 product references"),
+    person: z51.array(url).max(3, "at most 3 person references"),
+    setting: z51.array(url).max(3, "at most 3 setting references")
+  });
+}
+__name(createMixReferences, "createMixReferences");
+var MixReferences = createMixReferences(PublicHttpsUrl);
+var MAX_VIDEO_MIX_REFERENCE_IMAGES = 5;
+function countGeneratedVideoMixReferences(axes, references) {
+  return Number(axes.person && references.person.length === 0) + Number(axes.setting && references.setting.length === 0);
+}
+__name(countGeneratedVideoMixReferences, "countGeneratedVideoMixReferences");
+function countVideoMixReferenceImages(axes, references) {
+  return (axes.product ? references.product.length : 0) + (axes.person ? references.person.length : 0) + (axes.setting ? references.setting.length : 0) + countGeneratedVideoMixReferences(axes, references);
+}
+__name(countVideoMixReferenceImages, "countVideoMixReferenceImages");
 var MixImageEdit = z51.object({
   instruction: z51.string().min(1).max(600),
   imageUrls: z51.array(MixImageUrl).min(1).max(3)
 });
-var MixRequest = z51.object({
-  mediaType: z51.enum(MEDIA_TYPES),
-  originalUrl: z51.union([
-    PublicHttpsUrl,
-    InternalAssetPath
-  ]),
-  axes: MixAxes,
-  references: MixReferences,
-  personText: z51.string().max(500).optional(),
-  settingText: z51.string().max(500).optional(),
-  /**
-   * Optional public URL of a user-uploaded audio file (mp3/wav). Wan Video
-   * Edit has no audio input and the mix never lipsyncs: the Wan output is
-   * muted and, when this is set, the assemble worker mux'es THIS audio
-   * (instead of the original video's track) into the final concatenated mp4
-   * (mute + overlay). No per-scene slicing, no `reference_audio_urls`.
-   */
-  audioUrl: PublicHttpsUrl.optional(),
-  resolution: z51.enum(RESOLUTIONS).default("720p"),
-  originalDurationSec: z51.number().positive().max(600).optional(),
-  image: MixImageEdit.optional(),
-  sourceTaskId: z51.string().max(64).optional(),
-  sourceCreativeId: z51.string().max(64).optional()
-}).superRefine((req, ctx) => {
-  if (req.mediaType === "image") {
-    if (!req.image) {
+function createMixRequestSchema(allowAdditionalUrl) {
+  const acceptsUrl = /* @__PURE__ */ __name((url) => isPublicHttpsUrl(url) || Boolean(allowAdditionalUrl?.(url)), "acceptsUrl");
+  const acceptedUrl = z51.string().url().refine(acceptsUrl, {
+    message: "must be a public HTTPS URL"
+  });
+  return z51.object({
+    mediaType: z51.enum(MEDIA_TYPES),
+    originalUrl: z51.union([
+      acceptedUrl,
+      InternalAssetPath
+    ]),
+    axes: MixAxes,
+    references: createMixReferences(acceptedUrl),
+    personText: z51.string().max(500).optional(),
+    settingText: z51.string().max(500).optional(),
+    /**
+    * Optional public URL of a user-uploaded audio file (mp3/wav). Wan Video
+    * Edit has no audio input and the mix never lipsyncs: the Wan output is
+    * muted and, when this is set, the assemble worker mux'es THIS audio
+    * (instead of the original video's track) into the final concatenated mp4
+    * (mute + overlay). No per-scene slicing, no `reference_audio_urls`.
+    */
+    audioUrl: acceptedUrl.optional(),
+    resolution: z51.enum(RESOLUTIONS).default("720p"),
+    originalDurationSec: z51.number().positive().max(600).optional(),
+    image: MixImageEdit.extend({
+      imageUrls: z51.array(z51.union([
+        acceptedUrl,
+        InternalAssetPath
+      ])).min(1).max(3)
+    }).optional(),
+    sourceTaskId: z51.string().max(64).optional(),
+    sourceCreativeId: z51.string().max(64).optional()
+  }).superRefine((req, ctx) => {
+    if (req.mediaType === "image") {
+      if (!req.image) {
+        ctx.addIssue({
+          code: "custom",
+          message: "image mix requires an image edit (instruction + 1-3 images)"
+        });
+      }
+      return;
+    }
+    if (!acceptsUrl(req.originalUrl)) {
       ctx.addIssue({
         code: "custom",
-        message: "image mix requires an image edit (instruction + 1-3 images)"
+        path: [
+          "originalUrl"
+        ],
+        message: "must be a public HTTPS URL"
       });
     }
-    return;
-  }
-  if (!isPublicHttpsUrl(req.originalUrl)) {
-    ctx.addIssue({
-      code: "custom",
-      path: [
-        "originalUrl"
-      ],
-      message: "must be a public HTTPS URL"
-    });
-  }
-  if (req.axes.product && req.references.product.length === 0) {
-    ctx.addIssue({
-      code: "custom",
-      message: "product references required when product axis active"
-    });
-  }
-  const anyAxis = req.axes.product || req.axes.person || req.axes.setting;
-  if (!anyAxis && !req.audioUrl) {
-    ctx.addIssue({
-      code: "custom",
-      message: "mix requires at least one axis to swap or a user audio"
-    });
-  }
-});
+    if (req.axes.product && req.references.product.length === 0) {
+      ctx.addIssue({
+        code: "custom",
+        message: "product references required when product axis active"
+      });
+    }
+    if (countVideoMixReferenceImages(req.axes, req.references) > MAX_VIDEO_MIX_REFERENCE_IMAGES) {
+      ctx.addIssue({
+        code: "custom",
+        path: [
+          "references"
+        ],
+        message: `video mix accepts at most ${MAX_VIDEO_MIX_REFERENCE_IMAGES} reference images, including generated axes`
+      });
+    }
+    const anyAxis = req.axes.product || req.axes.person || req.axes.setting;
+    if (!anyAxis && !req.audioUrl) {
+      ctx.addIssue({
+        code: "custom",
+        message: "mix requires at least one axis to swap or a user audio"
+      });
+    }
+  });
+}
+__name(createMixRequestSchema, "createMixRequestSchema");
+var MixRequest = createMixRequestSchema();
 var ReferenceMap = z51.object({
   product: z51.object({
     start: z51.number().int(),
@@ -11132,6 +11208,7 @@ var MixResult = z51.object({
 });
 
 // ../../packages/types/src/mix-cost.ts
+var IMAGE_GEN_USER_PRICE_CENTS = DEFAULT_PRICING["kie:image-generation:gpt-image-2-5-sunburst-text-to-image"].userPriceCents;
 var MAX_QA_RETRIES_PER_SCENE_UPPER_BOUND = 1;
 var MAX_BILLABLE_GENERATIONS_PER_BLOCK = 1 + MAX_QA_RETRIES_PER_SCENE_UPPER_BOUND;
 
@@ -11371,6 +11448,13 @@ var RegenerateLandingRoleResponse = z55.object({
   promptIndex: z55.number().int().nonnegative(),
   operationId: z55.string().min(1)
 });
+var LandingRegenerationFailureCode = z55.enum([
+  "licensed_character_blocked",
+  "provider_policy_blocked",
+  "qa_rejected",
+  "superseded",
+  "provider_error"
+]);
 var LandingRegenerationStatusResponse = z55.object({
   ok: z55.literal(true),
   operationId: z55.string().min(1),
@@ -11378,6 +11462,7 @@ var LandingRegenerationStatusResponse = z55.object({
   status: LandingRegenerationStatus,
   refunded: z55.boolean(),
   failureReason: z55.string().nullable(),
+  failureCode: LandingRegenerationFailureCode.nullable().optional(),
   publishedAssetKey: z55.string().nullable(),
   updatedAt: z55.string().datetime()
 });
@@ -12335,6 +12420,23 @@ var CAPABILITY_MODEL_GUIDANCE = {
       "es trabajo pagado y requiere confirmaci\xF3n expl\xEDcita"
     ]
   },
+  get_image_edit_status: {
+    summary: "Consulta s\xF3lo el estado durable de una correcci\xF3n aceptada y su imagen entregada. No genera ni reintenta im\xE1genes; Task.done no significa que esta correcci\xF3n haya terminado.",
+    useWhen: [
+      "una correcci\xF3n de imagen ya devolvi\xF3 su operaci\xF3n aceptada",
+      "la persona consulta el resultado de esa correcci\xF3n"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una operaci\xF3n aceptada"
+    ],
+    defaults: [
+      "consulta la misma operaci\xF3n hasta su publicaci\xF3n o fallo durable",
+      "un fallo al consultar no autoriza otra correcci\xF3n pagada"
+    ],
+    disclosures: [
+      "la consulta no consume cr\xE9ditos ni inicia trabajo"
+    ]
+  },
   edit_task_draft: {
     summary: "Edita el draft de un angle de marketing antes de la generaci\xF3n.",
     useWhen: [
@@ -14290,7 +14392,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "task",
     "video"
   ]),
-  defineCapability("edit_image_creative", "ce0abba871436850bd1db0ea4bcdade9ef35420ebd83833e2d5c2dcf70378ec0", "credit_consuming", "creative", [
+  defineCapability("edit_image_creative", "50eca473829328dfb63b9cbae03a9835b79c510e29528563e09b7eb3e5e9bca4", "credit_consuming", "creative", [
     "credit_consuming",
     "state_change"
   ], [
@@ -14300,12 +14402,27 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     ]),
     slot("edit_instruction", true, [
       "instruction"
-    ])
+    ]),
+    slot("client_request", false, [
+      "clientRequestId"
+    ], [], "server")
   ], [
     "creative"
   ], [
     "creative"
   ]),
+  defineCapability("get_image_edit_status", "fe59aefd433afe7e5a2d8b4a81084583750c1447c877b6bce698340326665141", "none", "read_only", [
+    "read"
+  ], [
+    slot("creative_operation", true, [
+      "taskId",
+      "operationId"
+    ], [], "server")
+  ], [
+    "creative_edit_operation"
+  ], [
+    "creative_edit_status"
+  ], MCP_ONLY_CHANNEL_EXPOSURE),
   defineCapability("edit_task_draft", "1c9343bdce51aac36ec6254557c8a904037746523168527f012b4c5b6361e98e", "state_change", "creative", [
     "state_change"
   ], [
@@ -16960,7 +17077,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "8.7.0";
+var MCP_VERSION = "8.8.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -20645,6 +20762,7 @@ import { z as z82 } from "zod";
 var generateFreeVideoGuidance = getProductMakerCapabilityModelGuidance("generate_free_video");
 var generateVideoCreativeGuidance = getProductMakerCapabilityModelGuidance("generate_video_creative");
 var generateImageCreativesGuidance = getProductMakerCapabilityModelGuidance("generate_image_creatives");
+var imageEditStatusGuidance = getProductMakerCapabilityModelGuidance("get_image_edit_status");
 var editImageCreativeGuidance = getProductMakerCapabilityModelGuidance("edit_image_creative");
 var generateLandingGuidance = getProductMakerCapabilityModelGuidance("generate_landing");
 var CreativeRefs = {
@@ -20866,6 +20984,7 @@ var ImageInput = z82.object({
 var EditImageCreativeInput = z82.object({
   taskId: z82.string().uuid().describe("ID de la tarea de imagen ya finalizada."),
   variantIndex: z82.number().int().min(0).max(10).describe("\xCDndice de la variante a corregir (0 = primera imagen)."),
+  clientRequestId: z82.string().min(1).max(160).optional().describe("Identidad estable de esta correcci\xF3n; reutil\xEDzala al reconciliar una respuesta perdida, no para otra instrucci\xF3n."),
   instruction: z82.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 = z82.object({
@@ -21140,13 +21259,30 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       await requirePaidCreativeConfirmation(server, `Correcci\xF3n pagada de la imagen ${input.variantIndex + 1}.`);
       const r = await api.postJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/regenerate`, {
         comment: input.instruction,
-        variantIndex: input.variantIndex
+        variantIndex: input.variantIndex,
+        ...input.clientRequestId ? {
+          clientRequestId: input.clientRequestId
+        } : {}
       });
       return asText(r);
     } catch (e) {
       throw translateError(e);
     }
   });
+  server.registerTool("get_image_edit_status", {
+    description: imageEditStatusGuidance.summary,
+    inputSchema: {
+      taskId: z82.string().uuid(),
+      operationId: z82.string().uuid()
+    },
+    annotations: READS_INTERNAL
+  }, async (input) => {
+    try {
+      return asText(await api.getJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/operations/${encodeURIComponent(input.operationId)}`));
+    } catch (error) {
+      throw translateError(error);
+    }
+  });
   server.registerTool("generate_landing", {
     description: generateLandingGuidance.summary + " No expone landing editable/code mientras siga siendo admin-only. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), language, country y creativeSetup. Ante \u201Ccrea una landing con este producto\u201D y una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. Presenta UN checklist compacto \u2014no preguntas seriales\u2014 con estrategia, formato, competencia, m\xE9todos de pago, contexto, direcci\xF3n creativa y headline/subheadline exactos opcionales. Prop\xF3n defaults recomendados; null significa que el usuario deleg\xF3 esa decisi\xF3n concreta, nunca que el agente la olvid\xF3.\n\nANTES de invocar, muestra el resumen y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.",
     inputSchema: LandingInput.shape,

package/package.json

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