@productmaker/mcp 0.7.0 → 0.9.0

package/dist/http.js

@@ -611,6 +611,30 @@ var VideoModelEnum = z.enum([
   "grok",
   "kling"
 ]);
+var ProductReferenceUserChoiceEnum = z.enum([
+  "same_product",
+  "variants",
+  "different_products",
+  "combo_distinct"
+]);
+var ProductReferenceCandidateGroupingEnum = z.enum([
+  "same_product_same_variant",
+  "same_product_different_variants",
+  "different_products",
+  "unclear"
+]);
+function buildSelectedImageUrlsHash(urls) {
+  const input = [
+    ...urls
+  ].sort().join("|");
+  let hash = 2166136261;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= input.charCodeAt(index);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `fnv1a:${hash.toString(16).padStart(8, "0")}:${urls.length}`;
+}
+__name(buildSelectedImageUrlsHash, "buildSelectedImageUrlsHash");
 var ImageCreativeStyleEnum = z.enum([
   "studio",
   "floating",
@@ -938,6 +962,38 @@ var EditTaskDraftInput = z2.object({
     scriptNotes: z2.string().max(2e3).optional()
   })
 });
+var PendingActionPayload = z2.discriminatedUnion("kind", [
+  z2.object({
+    kind: z2.literal("product_reference_confirmation"),
+    userChoice: ProductReferenceUserChoiceEnum
+  }),
+  z2.object({
+    kind: z2.literal("angle_review_approval"),
+    // All edits are optional — empty action body just approves the
+    // backend-generated draft as-is. Field shapes mirror ApproveAnglesRequest
+    // in @packages/types/wizard.ts (the only path-of-resolution endpoint is
+    // POST /v1/tasks/:taskId/approve-angles).
+    customAngle: z2.string().min(1).max(480).optional(),
+    painPoints: z2.string().max(3e3).optional(),
+    benefits: z2.string().max(3e3).optional(),
+    features: z2.array(z2.string().min(1).max(300)).max(10).optional()
+  })
+]);
+var ResolvePendingActionInput = z2.object({
+  taskId: z2.string().min(1),
+  action: PendingActionPayload
+}).strict();
+var StatusForResolveSchema = z2.object({
+  pendingUserAction: z2.object({
+    kind: z2.string(),
+    candidateGrouping: z2.string().optional(),
+    selectedImageUrls: z2.array(z2.string()).optional(),
+    customAngleDraft: z2.string().optional(),
+    painPointsDraft: z2.string().optional(),
+    benefitsDraft: z2.string().optional(),
+    featuresDraft: z2.array(z2.string()).optional()
+  }).optional()
+}).passthrough();
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
   server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\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 del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoPreset (tipo/narrativa del video \u2014 \xFAnico campo de estilo)\n- videoTier (estilo: basic="Realista"/standard="Multiescena")\n- multiAngleVideos (booleano)\n- angleNarratives (override per-angle de la narrativa, avanzado)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nGUION: para revisar/editar el guion del video antes de renderizar, usa `generate_video_creative` con `pauseForVideoScriptReview: true` en vez de este tool. Despu\xE9s de la pausa: get_video_script para leer, approve_video_script para aprobar con ediciones.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime", "modelo X"), p\xEDdele una opci\xF3n v\xE1lida del enum correspondiente.', CreateProductTaskInput.shape, async (input) => {
     try {
@@ -976,7 +1032,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("get_task_status", "Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.", GetTaskStatusInput.shape, async (input, extra) => {
+  server.tool("get_task_status", 'Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo.\n\nIMPORTANTE \u2014 `pendingUserAction`: si est\xE1 presente, el pipeline est\xE1 PARADO esperando que el usuario decida algo. Mira el `kind` (hoy: `"product_reference_confirmation"` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos), mu\xE9strale al usuario `targetProductLabel` + `reason` en lenguaje natural, recoge su respuesta, y llama `resolve_pending_action` con `action: { kind: <mismo kind>, ... }` (las `options` v\xE1lidas vienen en el mismo objeto). Sin esto la tarea NUNCA avanza por m\xE1s que esperes. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.', GetTaskStatusInput.shape, async (input, extra) => {
     try {
       const fetcher = /* @__PURE__ */ __name(() => api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`), "fetcher");
       const signal = extra?.signal;
@@ -1033,6 +1089,62 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
+  server.tool("resolve_pending_action", 'Resuelve una acci\xF3n que el pipeline est\xE1 esperando del usuario. La llamas cuando `get_task_status` devuelve `pendingUserAction` (sin esto la tarea NUNCA avanza por m\xE1s que esperes). El `action.kind` que mandas DEBE coincidir con el `pendingUserAction.kind` que viste en el status \u2014 es el contrato de simetr\xEDa que mantiene este tool como \xFAnica superficie de resoluci\xF3n de gates.\n\nKINDS soportados hoy:\n\n\u2022 `product_reference_confirmation` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos. Payload: `userChoice` \u2208 { "same_product" (mismo producto, fotos son s\xF3lo \xE1ngulos distintos), "variants" (mismo producto, distintos colores/tallas/sabores), "combo_distinct" (son 2 productos distintos vendidos juntos como combo \u2014 marca la tarea como combo), "different_products" (productos distintos y el usuario quiere generar s\xF3lo uno \u2014 el backend bloquea hasta que selecciones im\xE1genes de un solo producto; normalmente NO es la respuesta correcta para destrabar) }. PREG\xDANTALE al usuario antes de invocar \u2014 `pendingUserAction.targetProductLabel` y `reason` te dan contexto para formularle la pregunta en lenguaje natural. Usa SOLO valores presentes en `pendingUserAction.options`.\n\n\u2022 `angle_review_approval` \u2014 el usuario opto por `pauseForAngleReview: true` al crear el creativo (en `generate_image_creatives`, `generate_video_creative` o `generate_landing`). La IA ya gener\xF3 el \xE1ngulo + pain points + benefits + features y la tarea est\xE1 pausada esperando que el usuario apruebe o edite antes de renderizar. Lee `customAngleDraft`, `painPointsDraft`, `benefitsDraft`, `featuresDraft` del `pendingUserAction` para mostr\xE1rselos al usuario en lenguaje natural ("la IA propuso este \xE1ngulo: ... \xBFlo apruebas o cambias algo?"). Payload (TODOS opcionales \u2014 sin nada = aprobar tal cual; con campos = aprobar con ediciones): `customAngle` (override del \xE1ngulo), `painPoints`, `benefits`, `features` (array de 1-10 bullets). Llamar sin ning\xFAn campo es v\xE1lido y aprueba el draft sin cambios.\n\nFuturos kinds (no implementados a\xFAn) se agregar\xE1n como nuevas variantes del `action` discriminated union \u2014 el flujo "lee kind del status \u2192 manda mismo kind aqu\xED" sigue igual.', ResolvePendingActionInput.shape, async (input) => {
+    try {
+      const raw = await api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`);
+      const status = StatusForResolveSchema.parse(raw);
+      const pending = status.pendingUserAction;
+      if (!pending) {
+        throw new Error("No hay acci\xF3n pendiente para esta tarea \u2014 llama get_task_status primero para confirmar el estado.");
+      }
+      if (pending.kind !== input.action.kind) {
+        throw new Error(`La tarea espera una acci\xF3n de tipo "${pending.kind}" pero mandaste "${input.action.kind}". Reusa el mismo kind que viste en pendingUserAction.`);
+      }
+      switch (input.action.kind) {
+        case "product_reference_confirmation": {
+          const candidateGrouping = pending.candidateGrouping;
+          const selectedImageUrls = pending.selectedImageUrls ?? [];
+          if (!candidateGrouping || selectedImageUrls.length === 0) {
+            throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
+          }
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+            productReferenceConfirmation: {
+              candidateGrouping,
+              userChoice: input.action.userChoice,
+              // Server overwrites with its own server-side computation;
+              // we send the matching MCP-mirror value so the wire body
+              // is internally coherent if the server skips overwrite.
+              selectedImageUrlsHash: buildSelectedImageUrlsHash(selectedImageUrls)
+            }
+          });
+          return asText(r);
+        }
+        case "angle_review_approval": {
+          const body = {};
+          if (pending.customAngleDraft && pending.customAngleDraft.length > 0) {
+            body.customAngle = pending.customAngleDraft;
+          }
+          if (pending.painPointsDraft != null) body.painPoints = pending.painPointsDraft;
+          if (pending.benefitsDraft != null) body.benefits = pending.benefitsDraft;
+          if (pending.featuresDraft != null) body.features = [
+            ...pending.featuresDraft
+          ];
+          if (input.action.customAngle != null) body.customAngle = input.action.customAngle;
+          if (input.action.painPoints != null) body.painPoints = input.action.painPoints;
+          if (input.action.benefits != null) body.benefits = input.action.benefits;
+          if (input.action.features != null) body.features = input.action.features;
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/approve-angles`, body);
+          return asText(r);
+        }
+        default: {
+          const _exhaustive = input.action;
+          throw new Error(`Unsupported pending action kind: ${String(_exhaustive.kind)}`);
+        }
+      }
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerTaskTools, "registerTaskTools");
 

package/dist/stdio.js

@@ -608,6 +608,30 @@ var VideoModelEnum = z.enum([
   "grok",
   "kling"
 ]);
+var ProductReferenceUserChoiceEnum = z.enum([
+  "same_product",
+  "variants",
+  "different_products",
+  "combo_distinct"
+]);
+var ProductReferenceCandidateGroupingEnum = z.enum([
+  "same_product_same_variant",
+  "same_product_different_variants",
+  "different_products",
+  "unclear"
+]);
+function buildSelectedImageUrlsHash(urls) {
+  const input = [
+    ...urls
+  ].sort().join("|");
+  let hash = 2166136261;
+  for (let index = 0; index < input.length; index += 1) {
+    hash ^= input.charCodeAt(index);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return `fnv1a:${hash.toString(16).padStart(8, "0")}:${urls.length}`;
+}
+__name(buildSelectedImageUrlsHash, "buildSelectedImageUrlsHash");
 var ImageCreativeStyleEnum = z.enum([
   "studio",
   "floating",
@@ -894,6 +918,38 @@ var EditTaskDraftInput = z2.object({
     scriptNotes: z2.string().max(2e3).optional()
   })
 });
+var PendingActionPayload = z2.discriminatedUnion("kind", [
+  z2.object({
+    kind: z2.literal("product_reference_confirmation"),
+    userChoice: ProductReferenceUserChoiceEnum
+  }),
+  z2.object({
+    kind: z2.literal("angle_review_approval"),
+    // All edits are optional — empty action body just approves the
+    // backend-generated draft as-is. Field shapes mirror ApproveAnglesRequest
+    // in @packages/types/wizard.ts (the only path-of-resolution endpoint is
+    // POST /v1/tasks/:taskId/approve-angles).
+    customAngle: z2.string().min(1).max(480).optional(),
+    painPoints: z2.string().max(3e3).optional(),
+    benefits: z2.string().max(3e3).optional(),
+    features: z2.array(z2.string().min(1).max(300)).max(10).optional()
+  })
+]);
+var ResolvePendingActionInput = z2.object({
+  taskId: z2.string().min(1),
+  action: PendingActionPayload
+}).strict();
+var StatusForResolveSchema = z2.object({
+  pendingUserAction: z2.object({
+    kind: z2.string(),
+    candidateGrouping: z2.string().optional(),
+    selectedImageUrls: z2.array(z2.string()).optional(),
+    customAngleDraft: z2.string().optional(),
+    painPointsDraft: z2.string().optional(),
+    benefitsDraft: z2.string().optional(),
+    featuresDraft: z2.array(z2.string()).optional()
+  }).optional()
+}).passthrough();
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
   server.tool("create_product_task", 'Crea una tarea de producto desde una o varias fotos. Por defecto genera los 3 outputs (landing + video + image creatives). Devuelve un taskId.\n\nINPUTS REQUERIDOS: images (1-5 fotos del MISMO producto; la primera es la hero), language, country.\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 del chat: preg\xFAntale expl\xEDcitamente, incluso si el usuario est\xE1 en LATAM. Si te dice "t\xFA elige" para price/offer, om\xEDtelos.\n\nSi el usuario tiene varias fotos del MISMO producto (frente, lateral, detalle, uso), incl\xFAyelas todas en images[] hasta 5. Si tiene fotos de productos DIFERENTES, son llamadas separadas (una tarea por producto).\n\nOTROS OPCIONALES (puedes invocar sin ellos y dejar que la IA elija defaults sensatos):\n- videoPreset (tipo/narrativa del video \u2014 \xFAnico campo de estilo)\n- videoTier (estilo: basic="Realista"/standard="Multiescena")\n- multiAngleVideos (booleano)\n- angleNarratives (override per-angle de la narrativa, avanzado)\n- outputs (subconjunto de {landing,video,image})\n- productUrl\n\nGUION: para revisar/editar el guion del video antes de renderizar, usa `generate_video_creative` con `pauseForVideoScriptReview: true` en vez de este tool. Despu\xE9s de la pausa: get_video_script para leer, approve_video_script para aprobar con ediciones.\n\nUsa SOLO valores declarados en los enums. Si el usuario pide algo no soportado (ej. "estilo anime", "modelo X"), p\xEDdele una opci\xF3n v\xE1lida del enum correspondiente.', CreateProductTaskInput.shape, async (input) => {
     try {
@@ -932,7 +988,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("get_task_status", "Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.", GetTaskStatusInput.shape, async (input, extra) => {
+  server.tool("get_task_status", 'Devuelve el estado y URLs de outputs de una tarea. Si waitSeconds>0, hace polling hasta que cambie la fase o llegue al timeout (max 120s). Cuando la tarea queda en `done`, la respuesta incluye un segundo bloque markdown con previews inline de las im\xE1genes, links descargables al video MP4 y un enlace a Product Maker para ver el resultado completo.\n\nIMPORTANTE \u2014 `pendingUserAction`: si est\xE1 presente, el pipeline est\xE1 PARADO esperando que el usuario decida algo. Mira el `kind` (hoy: `"product_reference_confirmation"` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos), mu\xE9strale al usuario `targetProductLabel` + `reason` en lenguaje natural, recoge su respuesta, y llama `resolve_pending_action` con `action: { kind: <mismo kind>, ... }` (las `options` v\xE1lidas vienen en el mismo objeto). Sin esto la tarea NUNCA avanza por m\xE1s que esperes. Use this to check on a task progress; pass waitSeconds for a near-synchronous response.', GetTaskStatusInput.shape, async (input, extra) => {
     try {
       const fetcher = /* @__PURE__ */ __name(() => api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`), "fetcher");
       const signal = extra?.signal;
@@ -989,6 +1045,62 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
+  server.tool("resolve_pending_action", 'Resuelve una acci\xF3n que el pipeline est\xE1 esperando del usuario. La llamas cuando `get_task_status` devuelve `pendingUserAction` (sin esto la tarea NUNCA avanza por m\xE1s que esperes). El `action.kind` que mandas DEBE coincidir con el `pendingUserAction.kind` que viste en el status \u2014 es el contrato de simetr\xEDa que mantiene este tool como \xFAnica superficie de resoluci\xF3n de gates.\n\nKINDS soportados hoy:\n\n\u2022 `product_reference_confirmation` \u2014 el clasificador no est\xE1 seguro si las fotos son variantes del mismo producto o productos distintos. Payload: `userChoice` \u2208 { "same_product" (mismo producto, fotos son s\xF3lo \xE1ngulos distintos), "variants" (mismo producto, distintos colores/tallas/sabores), "combo_distinct" (son 2 productos distintos vendidos juntos como combo \u2014 marca la tarea como combo), "different_products" (productos distintos y el usuario quiere generar s\xF3lo uno \u2014 el backend bloquea hasta que selecciones im\xE1genes de un solo producto; normalmente NO es la respuesta correcta para destrabar) }. PREG\xDANTALE al usuario antes de invocar \u2014 `pendingUserAction.targetProductLabel` y `reason` te dan contexto para formularle la pregunta en lenguaje natural. Usa SOLO valores presentes en `pendingUserAction.options`.\n\n\u2022 `angle_review_approval` \u2014 el usuario opto por `pauseForAngleReview: true` al crear el creativo (en `generate_image_creatives`, `generate_video_creative` o `generate_landing`). La IA ya gener\xF3 el \xE1ngulo + pain points + benefits + features y la tarea est\xE1 pausada esperando que el usuario apruebe o edite antes de renderizar. Lee `customAngleDraft`, `painPointsDraft`, `benefitsDraft`, `featuresDraft` del `pendingUserAction` para mostr\xE1rselos al usuario en lenguaje natural ("la IA propuso este \xE1ngulo: ... \xBFlo apruebas o cambias algo?"). Payload (TODOS opcionales \u2014 sin nada = aprobar tal cual; con campos = aprobar con ediciones): `customAngle` (override del \xE1ngulo), `painPoints`, `benefits`, `features` (array de 1-10 bullets). Llamar sin ning\xFAn campo es v\xE1lido y aprueba el draft sin cambios.\n\nFuturos kinds (no implementados a\xFAn) se agregar\xE1n como nuevas variantes del `action` discriminated union \u2014 el flujo "lee kind del status \u2192 manda mismo kind aqu\xED" sigue igual.', ResolvePendingActionInput.shape, async (input) => {
+    try {
+      const raw = await api.getJson(`/v1/status/${encodeURIComponent(input.taskId)}`);
+      const status = StatusForResolveSchema.parse(raw);
+      const pending = status.pendingUserAction;
+      if (!pending) {
+        throw new Error("No hay acci\xF3n pendiente para esta tarea \u2014 llama get_task_status primero para confirmar el estado.");
+      }
+      if (pending.kind !== input.action.kind) {
+        throw new Error(`La tarea espera una acci\xF3n de tipo "${pending.kind}" pero mandaste "${input.action.kind}". Reusa el mismo kind que viste en pendingUserAction.`);
+      }
+      switch (input.action.kind) {
+        case "product_reference_confirmation": {
+          const candidateGrouping = pending.candidateGrouping;
+          const selectedImageUrls = pending.selectedImageUrls ?? [];
+          if (!candidateGrouping || selectedImageUrls.length === 0) {
+            throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
+          }
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+            productReferenceConfirmation: {
+              candidateGrouping,
+              userChoice: input.action.userChoice,
+              // Server overwrites with its own server-side computation;
+              // we send the matching MCP-mirror value so the wire body
+              // is internally coherent if the server skips overwrite.
+              selectedImageUrlsHash: buildSelectedImageUrlsHash(selectedImageUrls)
+            }
+          });
+          return asText(r);
+        }
+        case "angle_review_approval": {
+          const body = {};
+          if (pending.customAngleDraft && pending.customAngleDraft.length > 0) {
+            body.customAngle = pending.customAngleDraft;
+          }
+          if (pending.painPointsDraft != null) body.painPoints = pending.painPointsDraft;
+          if (pending.benefitsDraft != null) body.benefits = pending.benefitsDraft;
+          if (pending.featuresDraft != null) body.features = [
+            ...pending.featuresDraft
+          ];
+          if (input.action.customAngle != null) body.customAngle = input.action.customAngle;
+          if (input.action.painPoints != null) body.painPoints = input.action.painPoints;
+          if (input.action.benefits != null) body.benefits = input.action.benefits;
+          if (input.action.features != null) body.features = input.action.features;
+          const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/approve-angles`, body);
+          return asText(r);
+        }
+        default: {
+          const _exhaustive = input.action;
+          throw new Error(`Unsupported pending action kind: ${String(_exhaustive.kind)}`);
+        }
+      }
+    } catch (e) {
+      throw translateError(e);
+    }
+  });
 }
 __name(registerTaskTools, "registerTaskTools");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "private": false,
   "description": "Product Maker MCP server — connect Claude Desktop, Claude Code, ChatGPT, or Gemini to Product Maker AI to generate dropshipping landing pages, UGC videos, and ad creatives, and publish to Shopify and Meta Ads from your AI assistant.",