@productmaker/mcp 3.2.0 → 3.3.0

package/dist/http.js

@@ -2600,7 +2600,13 @@ var VideoGenerator = z18.object({
   videoResolution: VideoResolution.optional(),
   /** Requested controls and the effective provider route that produced this result. */
   execution: VideoExecutionContract.optional(),
-  adCopy: z18.string().optional()
+  adCopy: z18.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. */
+  scriptRewritten: z18.boolean().optional()
 });
 var VideoScriptSceneForReview = z18.object({
   index: z18.number().int().nonnegative(),
@@ -4136,8 +4142,20 @@ var AdminUserListResponse = z27.object({
   page: z27.number().int().positive(),
   pageSize: z27.number().int().positive()
 });
+var AdminCreditGrantReason = z27.enum([
+  "compensation",
+  "goodwill",
+  "promo",
+  "internal-testing",
+  "correction"
+]);
 var UpdateUserCreditsRequest = z27.object({
-  creditCents: z27.number().nonnegative()
+  creditCents: z27.number().nonnegative(),
+  reason: AdminCreditGrantReason,
+  /** Free-text detail. Required when the enum alone does not explain the grant. */
+  notes: z27.string().trim().min(1).max(500).optional(),
+  /** The task the grant compensates, when there is one. */
+  taskId: z27.string().uuid().optional()
 });
 var QualityReportStatus = z27.enum([
   "open",
@@ -11400,7 +11418,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.2.0";
+var MCP_VERSION = "3.3.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -12850,7 +12868,12 @@ async function fetchTaskOutputs(api, taskId, options) {
     return {
       angleKey: vg.angleKey ?? "",
       angleIndex: vg.angleIndex ?? 0,
-      variants: variants2.length ? variants2 : fallback
+      variants: variants2.length ? variants2 : fallback,
+      // Only ever true — an honest delivery leaves the key off entirely so no
+      // consumer has to distinguish `false` from "the API is older than this".
+      ...vg.scriptRewritten === true ? {
+        scriptRewritten: true
+      } : {}
     };
   }).filter((v) => v.angleKey && v.variants.length);
   const sections = (raw.landing?.images ?? []).filter((img) => Boolean(img.role) && Boolean(img.url)).map((img) => ({
@@ -12913,6 +12936,9 @@ function renderOutputsMarkdown(outputs) {
       for (const variant of v.variants) {
         parts.push(`- [${escapeMdLabel(v.angleKey)} \xB7 ${escapeMdLabel(variant.kind)}](${variant.url})`);
       }
+      if (v.scriptRewritten) {
+        parts.push(`  \u26A0\uFE0F No pudimos usar el guion que aprobaste para este \xE1ngulo, as\xED que generamos el video con un guion nuevo. Si no te sirve, ed\xEDtalo o vuelve a generarlo.`);
+      }
     }
   }
   return parts.join("\n");
@@ -15984,7 +16010,7 @@ var CostProjectInput = z62.object({
 var GuideInput = z62.object({
   projectId: ProjectId.optional()
 }).strict();
-var DropshippingProjectNextAction = z62.discriminatedUnion("kind", [
+var NEXT_ACTION_KINDS = [
   "cost_product",
   "provide_product_media",
   "generate_creatives",
@@ -15998,7 +16024,8 @@ var DropshippingProjectNextAction = z62.discriminatedUnion("kind", [
   "create_meta_campaign",
   "repair_meta_campaign",
   "review_paused_campaign"
-].map((kind) => z62.object({
+];
+var DropshippingProjectNextAction = z62.discriminatedUnion("kind", NEXT_ACTION_KINDS.map((kind) => z62.object({
   kind: z62.literal(kind),
   href: z62.string().min(1)
 })));
@@ -16072,9 +16099,25 @@ var ProjectResponseSchema = z62.object({
   createdAt: z62.string().datetime(),
   updatedAt: z62.string().datetime()
 }).passthrough();
+var NEXT_ACTION_GUIDANCE = {
+  cost_product: "Llama `cost_dropshipping_project` con el costo real del proveedor. Nunca lo inventes: p\xEDdeselo al usuario.",
+  provide_product_media: "Llama `request_media_upload` con mediaKind=image y uploadPurpose=product_reference. Cuando el usuario diga que ya subi\xF3, llama `check_media_upload` y usa los assetId. No pidas ruta local ni URL.",
+  generate_creatives: "Llama `create_product_task` con los assetId del producto. Antes dile al usuario qu\xE9 outputs vas a generar y confirma precio y oferta.",
+  wait_for_creatives: "No hay nada que hacer todav\xEDa: la tarea est\xE1 corriendo. Llama `get_task_status` y espera. No crees otra tarea.",
+  repair_creatives: "La tarea fall\xF3. Llama `get_task_status` para leer el error y expl\xEDcaselo al usuario antes de reintentar nada.",
+  complete_creative_set: "Faltan outputs por terminar. Llama `get_task_status` y revisa si hay una acci\xF3n pendiente que resolver con `resolve_pending_action`.",
+  connect_shopify: "Llama `list_shopify_shops`. Si no hay ninguna tienda conectada, el usuario debe conectarla en la web: d\xE1selo como paso manual.",
+  publish_storefront: "Llama `publish_to_shopify` con el taskId y la tienda elegida.",
+  wait_for_storefront: "La publicaci\xF3n en Shopify est\xE1 en curso. Llama `get_task_status` y espera; no publiques otra vez.",
+  connect_meta: "Llama `list_meta_destinations`. Si no hay cuentas, el usuario debe conectar Meta en la web: d\xE1selo como paso manual.",
+  create_meta_campaign: "Llama `list_meta_destinations`, pregunta en el chat por portfolioId, adAccountId y pageId, y luego `publish_to_meta`. La campa\xF1a queda PAUSED.",
+  repair_meta_campaign: "La campa\xF1a qued\xF3 en error o pendiente. Llama `get_meta_campaign_status` y expl\xEDcale al usuario qu\xE9 pas\xF3 antes de reintentar.",
+  review_paused_campaign: "Todo est\xE1 listo. La campa\xF1a qued\xF3 PAUSED a prop\xF3sito: dile al usuario que la active \xE9l mismo en Ads Manager."
+};
 function projectText(raw) {
   const project = ProjectResponseSchema.parse(raw);
-  const next = project.nextAction ? `${project.nextAction.kind} (${project.nextAction.href})` : "ninguna";
+  const kind = project.nextAction?.kind;
+  const guidance = kind ? NEXT_ACTION_GUIDANCE[kind] : void 0;
   return {
     content: [
       {
@@ -16084,6 +16127,9 @@ function projectText(raw) {
           productName: project.productName,
           phase: project.phase,
           nextAction: project.nextAction,
+          // The href is a web anchor and is useless to an agent; the guidance
+          // is the executable form of the same step.
+          nextActionGuidance: guidance ?? null,
           hasReferenceImage: project.hasReferenceImage,
           costingSaved: Boolean(project.costingResult),
           rewardProgress: {
@@ -16092,7 +16138,7 @@ function projectText(raw) {
             milestones: project.rewards.milestones
           },
           version: project.version,
-          message: `Siguiente paso: ${next}. Relee este proyecto despu\xE9s de cada mutaci\xF3n.`
+          message: guidance ? `Siguiente paso: ${guidance} Relee este proyecto despu\xE9s de cada mutaci\xF3n.` : "El proyecto no tiene ning\xFAn paso pendiente."
         })
       }
     ]

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.2.0";
+var MCP_VERSION = "3.3.0";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -3221,7 +3221,13 @@ var VideoGenerator = z18.object({
   videoResolution: VideoResolution.optional(),
   /** Requested controls and the effective provider route that produced this result. */
   execution: VideoExecutionContract.optional(),
-  adCopy: z18.string().optional()
+  adCopy: z18.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. */
+  scriptRewritten: z18.boolean().optional()
 });
 var VideoScriptSceneForReview = z18.object({
   index: z18.number().int().nonnegative(),
@@ -4757,8 +4763,20 @@ var AdminUserListResponse = z27.object({
   page: z27.number().int().positive(),
   pageSize: z27.number().int().positive()
 });
+var AdminCreditGrantReason = z27.enum([
+  "compensation",
+  "goodwill",
+  "promo",
+  "internal-testing",
+  "correction"
+]);
 var UpdateUserCreditsRequest = z27.object({
-  creditCents: z27.number().nonnegative()
+  creditCents: z27.number().nonnegative(),
+  reason: AdminCreditGrantReason,
+  /** Free-text detail. Required when the enum alone does not explain the grant. */
+  notes: z27.string().trim().min(1).max(500).optional(),
+  /** The task the grant compensates, when there is one. */
+  taskId: z27.string().uuid().optional()
 });
 var QualityReportStatus = z27.enum([
   "open",
@@ -11652,7 +11670,12 @@ async function fetchTaskOutputs(api, taskId, options) {
     return {
       angleKey: vg.angleKey ?? "",
       angleIndex: vg.angleIndex ?? 0,
-      variants: variants2.length ? variants2 : fallback
+      variants: variants2.length ? variants2 : fallback,
+      // Only ever true — an honest delivery leaves the key off entirely so no
+      // consumer has to distinguish `false` from "the API is older than this".
+      ...vg.scriptRewritten === true ? {
+        scriptRewritten: true
+      } : {}
     };
   }).filter((v) => v.angleKey && v.variants.length);
   const sections = (raw.landing?.images ?? []).filter((img) => Boolean(img.role) && Boolean(img.url)).map((img) => ({
@@ -11715,6 +11738,9 @@ function renderOutputsMarkdown(outputs) {
       for (const variant of v.variants) {
         parts.push(`- [${escapeMdLabel(v.angleKey)} \xB7 ${escapeMdLabel(variant.kind)}](${variant.url})`);
       }
+      if (v.scriptRewritten) {
+        parts.push(`  \u26A0\uFE0F No pudimos usar el guion que aprobaste para este \xE1ngulo, as\xED que generamos el video con un guion nuevo. Si no te sirve, ed\xEDtalo o vuelve a generarlo.`);
+      }
     }
   }
   return parts.join("\n");
@@ -14786,7 +14812,7 @@ var CostProjectInput = z61.object({
 var GuideInput = z61.object({
   projectId: ProjectId.optional()
 }).strict();
-var DropshippingProjectNextAction = z61.discriminatedUnion("kind", [
+var NEXT_ACTION_KINDS = [
   "cost_product",
   "provide_product_media",
   "generate_creatives",
@@ -14800,7 +14826,8 @@ var DropshippingProjectNextAction = z61.discriminatedUnion("kind", [
   "create_meta_campaign",
   "repair_meta_campaign",
   "review_paused_campaign"
-].map((kind) => z61.object({
+];
+var DropshippingProjectNextAction = z61.discriminatedUnion("kind", NEXT_ACTION_KINDS.map((kind) => z61.object({
   kind: z61.literal(kind),
   href: z61.string().min(1)
 })));
@@ -14874,9 +14901,25 @@ var ProjectResponseSchema = z61.object({
   createdAt: z61.string().datetime(),
   updatedAt: z61.string().datetime()
 }).passthrough();
+var NEXT_ACTION_GUIDANCE = {
+  cost_product: "Llama `cost_dropshipping_project` con el costo real del proveedor. Nunca lo inventes: p\xEDdeselo al usuario.",
+  provide_product_media: "Llama `request_media_upload` con mediaKind=image y uploadPurpose=product_reference. Cuando el usuario diga que ya subi\xF3, llama `check_media_upload` y usa los assetId. No pidas ruta local ni URL.",
+  generate_creatives: "Llama `create_product_task` con los assetId del producto. Antes dile al usuario qu\xE9 outputs vas a generar y confirma precio y oferta.",
+  wait_for_creatives: "No hay nada que hacer todav\xEDa: la tarea est\xE1 corriendo. Llama `get_task_status` y espera. No crees otra tarea.",
+  repair_creatives: "La tarea fall\xF3. Llama `get_task_status` para leer el error y expl\xEDcaselo al usuario antes de reintentar nada.",
+  complete_creative_set: "Faltan outputs por terminar. Llama `get_task_status` y revisa si hay una acci\xF3n pendiente que resolver con `resolve_pending_action`.",
+  connect_shopify: "Llama `list_shopify_shops`. Si no hay ninguna tienda conectada, el usuario debe conectarla en la web: d\xE1selo como paso manual.",
+  publish_storefront: "Llama `publish_to_shopify` con el taskId y la tienda elegida.",
+  wait_for_storefront: "La publicaci\xF3n en Shopify est\xE1 en curso. Llama `get_task_status` y espera; no publiques otra vez.",
+  connect_meta: "Llama `list_meta_destinations`. Si no hay cuentas, el usuario debe conectar Meta en la web: d\xE1selo como paso manual.",
+  create_meta_campaign: "Llama `list_meta_destinations`, pregunta en el chat por portfolioId, adAccountId y pageId, y luego `publish_to_meta`. La campa\xF1a queda PAUSED.",
+  repair_meta_campaign: "La campa\xF1a qued\xF3 en error o pendiente. Llama `get_meta_campaign_status` y expl\xEDcale al usuario qu\xE9 pas\xF3 antes de reintentar.",
+  review_paused_campaign: "Todo est\xE1 listo. La campa\xF1a qued\xF3 PAUSED a prop\xF3sito: dile al usuario que la active \xE9l mismo en Ads Manager."
+};
 function projectText(raw) {
   const project = ProjectResponseSchema.parse(raw);
-  const next = project.nextAction ? `${project.nextAction.kind} (${project.nextAction.href})` : "ninguna";
+  const kind = project.nextAction?.kind;
+  const guidance = kind ? NEXT_ACTION_GUIDANCE[kind] : void 0;
   return {
     content: [
       {
@@ -14886,6 +14929,9 @@ function projectText(raw) {
           productName: project.productName,
           phase: project.phase,
           nextAction: project.nextAction,
+          // The href is a web anchor and is useless to an agent; the guidance
+          // is the executable form of the same step.
+          nextActionGuidance: guidance ?? null,
           hasReferenceImage: project.hasReferenceImage,
           costingSaved: Boolean(project.costingResult),
           rewardProgress: {
@@ -14894,7 +14940,7 @@ function projectText(raw) {
             milestones: project.rewards.milestones
           },
           version: project.version,
-          message: `Siguiente paso: ${next}. Relee este proyecto despu\xE9s de cada mutaci\xF3n.`
+          message: guidance ? `Siguiente paso: ${guidance} Relee este proyecto despu\xE9s de cada mutaci\xF3n.` : "El proyecto no tiene ning\xFAn paso pendiente."
         })
       }
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productmaker/mcp",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "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.",