@productmaker/mcp 1.16.0 → 1.16.1

package/dist/http.js

@@ -2348,7 +2348,7 @@ var require_video = __commonJS({
     Object.defineProperty(exports, "__esModule", {
       value: true
     });
-    exports.RegenerateVideoResponse = exports.RegenerateVideoRequest = exports.RegenerateVideoScriptNarrativeResponse = exports.RegenerateVideoScriptNarrativeRequest = exports.ApproveVideoScriptResponse = exports.ApproveVideoScriptRequest = exports.GetVideoScriptForReviewResponse = exports.VideoScriptSceneForReview = exports.VideoGenerator = exports.VideoGeneratorVariant = exports.ScriptReviewStatus = exports.VideoGeneratorStatus = void 0;
+    exports.RegenerateVideoResponse = exports.RegenerateVideoRequest = exports.RegenerateVideoScriptNarrativeResponse = exports.RegenerateVideoScriptNarrativeRequest = exports.ApproveVideoScriptResponse = exports.ApproveVideoScriptRequest = exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES = exports.GetVideoScriptForReviewResponse = exports.VideoScriptSceneForReview = exports.VideoGenerator = exports.VideoGeneratorVariant = exports.ScriptReviewStatus = exports.VideoGeneratorStatus = void 0;
     var zod_1 = __require("zod");
     var video_enums_1 = require_video_enums();
     exports.VideoGeneratorStatus = zod_1.z.enum([
@@ -2423,7 +2423,14 @@ var require_video = __commonJS({
        *  mute shot. The review UI must NOT block approval on an empty scene when this
        *  is set. Absent/false → a spoken beat that must carry dialogue (the approval
        *  gate blocks an empty one). Optional for backwards compatibility. */
-      silentAllowed: zod_1.z.boolean().optional()
+      silentAllowed: zod_1.z.boolean().optional(),
+      /** Winner scene's persuasive job. Shown beside editable dialogue so edits
+       * preserve why the source beat exists. */
+      persuasiveFunction: zod_1.z.string().optional(),
+      /** Objective visual observed in the winner source scene. */
+      winnerVisual: zod_1.z.string().optional(),
+      /** Localized target visual expected to accompany this spoken line. */
+      expectedVisual: zod_1.z.string().optional()
     });
     exports.GetVideoScriptForReviewResponse = zod_1.z.object({
       status: exports.ScriptReviewStatus,
@@ -2436,13 +2443,15 @@ var require_video = __commonJS({
        *  reverts an approved card back to "Revisar" without telling the user why. */
       error: zod_1.z.string().optional()
     });
+    exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
+    exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
     exports.ApproveVideoScriptRequest = zod_1.z.object({
-      angleKey: zod_1.z.string().min(1).optional(),
+      angleKey: zod_1.z.string().trim().min(1).max(120).optional(),
       scenes: zod_1.z.array(zod_1.z.object({
         index: zod_1.z.number().int().nonnegative(),
-        dialogue: zod_1.z.string()
-      })).min(1)
-    });
+        dialogue: zod_1.z.string().trim().min(1).max(exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS)
+      }).strict()).min(1).max(exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES)
+    }).strict();
     exports.ApproveVideoScriptResponse = zod_1.z.object({
       status: exports.ScriptReviewStatus
     });
@@ -6023,15 +6032,16 @@ var require_pricing = __commonJS({
       // Observed on the gap render 090ce235-55bd-401c-8ae8-ce362f4d7769 (local, the
       // only place these ran — zero prod BillingEntry rows for these labels as of
       // 2026-07-18, so there is no prod p75 to calibrate against yet):
-      //   gap-panel-fidelity-qa ×5 = 0.700¢ our  → 0.14¢ our / 0.28¢ user each
+      // Grok 4.5 HIGH is billed on actual token use. A recent P2 E2E measured
+      // ~0.74¢/panel, so quote a conservative whole-cent ceiling per call.
       //   clip-payoff-judge     ×2 = 2.638¢ our  → 1.32¢ our / 2.64¢ user each
       // ⚠️ OWNER DECISION PENDING: these are provisional ceilings from ONE render.
       // Re-derive from prod BillingEntry once gap_replication has volume.
       // Unit = one per-panel gap fidelity judge (3 images: our panel + the winner
       // keyframe + the product reference). Always on for gap_replication.
       "openrouter:gap-panel-fidelity-qa": {
-        ourCostCents: 0.2,
-        userPriceCents: 0.4
+        ourCostCents: 1,
+        userPriceCents: 2
       },
       // Unit = one payoff-judge pass over a RENDERED clip (video input → the most
       // expensive of the three). Behind PAYOFF_JUDGE_ENABLED (default OFF).
@@ -6141,6 +6151,18 @@ var require_pricing = __commonJS({
         ourCostCents: 1,
         userPriceCents: 2
       },
+      // P2 post-edit path. These two high-reasoning text calls run only when a user
+      // changes a winner-mapped spoken line: first localized reconciliation, then
+      // an independent whole-plan audit. Both are unmeasured at launch; quote each
+      // at the same conservative ceiling as gap-shot-alignment and bill actual use.
+      "openrouter:gap-script-reconciliation": {
+        ourCostCents: 1,
+        userPriceCents: 2
+      },
+      "openrouter:gap-script-visual-audit": {
+        ourCostCents: 1,
+        userPriceCents: 2
+      },
       // 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
@@ -8094,7 +8116,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.16.0";
+var MCP_VERSION = "1.16.1";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -10468,16 +10490,18 @@ var GetVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
   angleKey: z5.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
 }).strict();
+var VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
+var VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
 var ApproveSceneEdit = z5.object({
   index: z5.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
-  dialogue: z5.string().min(1).refine((v) => v.trim().length > 0, {
+  dialogue: z5.string().min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS).refine((v) => v.trim().length > 0, {
     message: "dialogue no puede ser s\xF3lo espacios"
   }).describe("Di\xE1logo final de la escena. NO puede estar vac\xEDo ni ser s\xF3lo espacios. Puede ser el original sin cambios o la edici\xF3n del usuario.")
 }).strict();
 var ApproveVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea."),
-  angleKey: z5.string().min(1).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
-  scenes: z5.array(ApproveSceneEdit).min(1).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber al menos 1 entrada (scenes vac\xEDo = 400). Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
+  angleKey: z5.string().trim().min(1).max(120).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
+  scenes: z5.array(ApproveSceneEdit).min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_SCENES).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber entre 1 y 50 entradas. Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
 }).strict();
 var RegenerateVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea."),
@@ -10485,7 +10509,7 @@ var RegenerateVideoScriptInput = z5.object({
   narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion. Incluye valores hist\xF3ricos porque esta herramienta tambi\xE9n regenera tareas antiguas. REQUERIDO \u2014 el backend NO acepta "mantener la actual"; siempre tienes que elegir una. Si el usuario quiere re-rolear con la misma narrativa, pasa la que ya tiene el \xE1ngulo (la ves en get_video_script o en get_task_status).')
 }).strict();
 function registerScriptReviewTools(server, api) {
-  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId? }], error? }. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
+  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
     try {
       const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
       const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);

package/dist/stdio.js

@@ -2349,7 +2349,7 @@ var require_video = __commonJS({
     Object.defineProperty(exports, "__esModule", {
       value: true
     });
-    exports.RegenerateVideoResponse = exports.RegenerateVideoRequest = exports.RegenerateVideoScriptNarrativeResponse = exports.RegenerateVideoScriptNarrativeRequest = exports.ApproveVideoScriptResponse = exports.ApproveVideoScriptRequest = exports.GetVideoScriptForReviewResponse = exports.VideoScriptSceneForReview = exports.VideoGenerator = exports.VideoGeneratorVariant = exports.ScriptReviewStatus = exports.VideoGeneratorStatus = void 0;
+    exports.RegenerateVideoResponse = exports.RegenerateVideoRequest = exports.RegenerateVideoScriptNarrativeResponse = exports.RegenerateVideoScriptNarrativeRequest = exports.ApproveVideoScriptResponse = exports.ApproveVideoScriptRequest = exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES = exports.GetVideoScriptForReviewResponse = exports.VideoScriptSceneForReview = exports.VideoGenerator = exports.VideoGeneratorVariant = exports.ScriptReviewStatus = exports.VideoGeneratorStatus = void 0;
     var zod_1 = __require("zod");
     var video_enums_1 = require_video_enums();
     exports.VideoGeneratorStatus = zod_1.z.enum([
@@ -2424,7 +2424,14 @@ var require_video = __commonJS({
        *  mute shot. The review UI must NOT block approval on an empty scene when this
        *  is set. Absent/false → a spoken beat that must carry dialogue (the approval
        *  gate blocks an empty one). Optional for backwards compatibility. */
-      silentAllowed: zod_1.z.boolean().optional()
+      silentAllowed: zod_1.z.boolean().optional(),
+      /** Winner scene's persuasive job. Shown beside editable dialogue so edits
+       * preserve why the source beat exists. */
+      persuasiveFunction: zod_1.z.string().optional(),
+      /** Objective visual observed in the winner source scene. */
+      winnerVisual: zod_1.z.string().optional(),
+      /** Localized target visual expected to accompany this spoken line. */
+      expectedVisual: zod_1.z.string().optional()
     });
     exports.GetVideoScriptForReviewResponse = zod_1.z.object({
       status: exports.ScriptReviewStatus,
@@ -2437,13 +2444,15 @@ var require_video = __commonJS({
        *  reverts an approved card back to "Revisar" without telling the user why. */
       error: zod_1.z.string().optional()
     });
+    exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
+    exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
     exports.ApproveVideoScriptRequest = zod_1.z.object({
-      angleKey: zod_1.z.string().min(1).optional(),
+      angleKey: zod_1.z.string().trim().min(1).max(120).optional(),
       scenes: zod_1.z.array(zod_1.z.object({
         index: zod_1.z.number().int().nonnegative(),
-        dialogue: zod_1.z.string()
-      })).min(1)
-    });
+        dialogue: zod_1.z.string().trim().min(1).max(exports.VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS)
+      }).strict()).min(1).max(exports.VIDEO_SCRIPT_APPROVAL_MAX_SCENES)
+    }).strict();
     exports.ApproveVideoScriptResponse = zod_1.z.object({
       status: exports.ScriptReviewStatus
     });
@@ -6024,15 +6033,16 @@ var require_pricing = __commonJS({
       // Observed on the gap render 090ce235-55bd-401c-8ae8-ce362f4d7769 (local, the
       // only place these ran — zero prod BillingEntry rows for these labels as of
       // 2026-07-18, so there is no prod p75 to calibrate against yet):
-      //   gap-panel-fidelity-qa ×5 = 0.700¢ our  → 0.14¢ our / 0.28¢ user each
+      // Grok 4.5 HIGH is billed on actual token use. A recent P2 E2E measured
+      // ~0.74¢/panel, so quote a conservative whole-cent ceiling per call.
       //   clip-payoff-judge     ×2 = 2.638¢ our  → 1.32¢ our / 2.64¢ user each
       // ⚠️ OWNER DECISION PENDING: these are provisional ceilings from ONE render.
       // Re-derive from prod BillingEntry once gap_replication has volume.
       // Unit = one per-panel gap fidelity judge (3 images: our panel + the winner
       // keyframe + the product reference). Always on for gap_replication.
       "openrouter:gap-panel-fidelity-qa": {
-        ourCostCents: 0.2,
-        userPriceCents: 0.4
+        ourCostCents: 1,
+        userPriceCents: 2
       },
       // Unit = one payoff-judge pass over a RENDERED clip (video input → the most
       // expensive of the three). Behind PAYOFF_JUDGE_ENABLED (default OFF).
@@ -6142,6 +6152,18 @@ var require_pricing = __commonJS({
         ourCostCents: 1,
         userPriceCents: 2
       },
+      // P2 post-edit path. These two high-reasoning text calls run only when a user
+      // changes a winner-mapped spoken line: first localized reconciliation, then
+      // an independent whole-plan audit. Both are unmeasured at launch; quote each
+      // at the same conservative ceiling as gap-shot-alignment and bill actual use.
+      "openrouter:gap-script-reconciliation": {
+        ourCostCents: 1,
+        userPriceCents: 2
+      },
+      "openrouter:gap-script-visual-audit": {
+        ourCostCents: 1,
+        userPriceCents: 2
+      },
       // 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
@@ -8091,7 +8113,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "1.16.0";
+var MCP_VERSION = "1.16.1";
 
 // src/tools/tasks.ts
 import { z as z2 } from "zod";
@@ -10424,16 +10446,18 @@ var GetVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
   angleKey: z5.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
 }).strict();
+var VIDEO_SCRIPT_APPROVAL_MAX_SCENES = 50;
+var VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS = 2e3;
 var ApproveSceneEdit = z5.object({
   index: z5.number().int().nonnegative().describe("\xCDndice de la escena (0-based, mismo que devuelve get_video_script)."),
-  dialogue: z5.string().min(1).refine((v) => v.trim().length > 0, {
+  dialogue: z5.string().min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_DIALOGUE_CHARS).refine((v) => v.trim().length > 0, {
     message: "dialogue no puede ser s\xF3lo espacios"
   }).describe("Di\xE1logo final de la escena. NO puede estar vac\xEDo ni ser s\xF3lo espacios. Puede ser el original sin cambios o la edici\xF3n del usuario.")
 }).strict();
 var ApproveVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea."),
-  angleKey: z5.string().min(1).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
-  scenes: z5.array(ApproveSceneEdit).min(1).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber al menos 1 entrada (scenes vac\xEDo = 400). Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
+  angleKey: z5.string().trim().min(1).max(120).optional().describe('Mismo angleKey usado en get_video_script. REQUERIDO en multi-angle (si se omite el backend resuelve a "angle_0" literal). En single-angle puede omitirse.'),
+  scenes: z5.array(ApproveSceneEdit).min(1).max(VIDEO_SCRIPT_APPROVAL_MAX_SCENES).describe("Escenas con los di\xE1logos finales. El backend mergea por `index` \u2014 las escenas NO incluidas conservan el di\xE1logo original. Debe haber entre 1 y 50 entradas. Para cada entrada que mandes con un dialogue distinto del original, el backend valida minWords \u2264 words \u2264 maxWords y rechaza con 400 si te sales del rango.")
 }).strict();
 var RegenerateVideoScriptInput = z5.object({
   taskId: z5.string().min(1).describe("ID de la tarea."),
@@ -10441,7 +10465,7 @@ var RegenerateVideoScriptInput = z5.object({
   narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion. Incluye valores hist\xF3ricos porque esta herramienta tambi\xE9n regenera tareas antiguas. REQUERIDO \u2014 el backend NO acepta "mantener la actual"; siempre tienes que elegir una. Si el usuario quiere re-rolear con la misma narrativa, pasa la que ya tiene el \xE1ngulo (la ves en get_video_script o en get_task_status).')
 }).strict();
 function registerScriptReviewTools(server, api) {
-  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId? }], error? }. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
+  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado (p.ej. el guion no cab\xEDa en el tiempo y el \xE1ngulo volvi\xF3 a "ready"); mu\xE9straselo al usuario.\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y a partir de ah\xED llama este tool peri\xF3dicamente \u2014 la respuesta de get_video_script trae su propio campo `status` que es la se\xF1al real:\n- "ready" \u2192 el guion est\xE1 listo; mu\xE9strale al usuario cada `scenes[].dialogue` por `index` con su tope `maxWords`, recoge ediciones, llama approve_video_script.\n- "not_ready" \u2192 el guion a\xFAn se est\xE1 generando; espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle puede ser que ese \xE1ngulo ya est\xE9 hecho \u2014 vuelve a llamar con otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar en una pausa previa.\n- "error" \u2192 el backend no pudo generar el guion; usa `regenerate_video_script` para re-intentar (es la ruta de recuperaci\xF3n v\xE1lida \u2014 el guion no se aprueba en estado "error").\n\nMULTI-ANGLE: si la tarea tiene varios \xE1ngulos, omitir angleKey siempre devuelve "angle_0" literal \u2014 itera expl\xEDcitamente por "angle_0", "angle_1", ... hasta encontrar uno con status="ready".', GetVideoScriptInput.shape, async (input) => {
     try {
       const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
       const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — cost products, generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from Claude, ChatGPT, or Gemini.",
@@ -63,8 +63,8 @@
     "tsx": "^4.16.0",
     "typescript": "^7.0.2",
     "vitest": "^2.1.9",
-    "@packages/product-economics": "0.1.0",
-    "@packages/types": "0.1.0"
+    "@packages/types": "0.1.0",
+    "@packages/product-economics": "0.1.0"
   },
   "publishConfig": {
     "access": "public"