@productmaker/mcp 6.3.0 → 6.3.1

package/dist/http.js

@@ -619,7 +619,25 @@ var AdaptiveProductReferenceStateSchema = z5.object({
   * may enrich the candidate later without changing the photos the user
   * approved; that must not invalidate the answer and reopen the question.
   */
-  lastAnsweredSelectedImageUrlsHash: z5.string().min(1).max(128).optional()
+  lastAnsweredSelectedImageUrlsHash: z5.string().min(1).max(128).optional(),
+  /**
+  * SHE PRESSED "SIGUE CON ESTAS FOTOS".
+  *
+  * The evidence version she pressed it at. The guard is
+  * `keptSelectionAtEvidenceVersion <= referenceEvidenceVersion`, so the
+  * retraction SURVIVES a later photo change — exactly like every other answer
+  * since answers stopped being filtered by evidence version. Recording the
+  * version is what makes a retraction taken at a FUTURE version (impossible
+  * today, but the ordering is asserted rather than assumed) not count.
+  *
+  * This is a RETRACTION, and it needs its own field because it cannot be
+  * expressed as an answer: the `different_products` answer that opened visual
+  * recovery short-circuits `buildAdaptiveProductReferenceDecision` before any
+  * later answer is read, so recording one more answer could never close the
+  * gate. Bumping the evidence version instead would drop every answer and
+  * restart the interview from `sale_structure` — the opposite of "continue".
+  */
+  keptSelectionAtEvidenceVersion: z5.number().int().positive().optional()
 });
 var AdaptiveProductReferenceQuestionOptionSchema = z5.object({
   value: ProductReferenceUserChoiceSchema,
@@ -3078,7 +3096,8 @@ var ShopifyPublishResponse = z22.object({
 var ShopifyPublishErrorResponse = z22.object({
   code: z22.enum([
     "SHOPIFY_NOT_CONNECTED",
-    "SHOPIFY_PUBLISH_FAILED"
+    "SHOPIFY_PUBLISH_FAILED",
+    "SHOPIFY_NO_PUBLISHED_THEME"
   ]),
   message: z22.string().optional(),
   authUrl: z22.string().url().optional(),
@@ -3220,9 +3239,16 @@ var ConfirmProductReferencesRequest = z23.object({
   referenceEvidenceVersion: z23.number().int().positive().optional(),
   expectedEvidenceHash: z23.string().min(1).max(128).optional(),
   recovery: z23.object({
+    /**
+     * `keep_selection` is NOT a recovery in the billing sense: it commits
+     * no new evidence, re-enqueues no extract, and costs nothing. It rides
+     * on this field because it answers the same card, and the server
+     * branches on it BEFORE the billed recovery path.
+     */
     action: z23.enum([
       "replace_selection",
-      "refine_selection"
+      "refine_selection",
+      "keep_selection"
     ]),
     affectedRefKeys: z23.array(z23.string().min(1).max(200)).min(1).max(5).optional(),
     expectedReferenceVersionId: z23.string().uuid().optional(),
@@ -3230,6 +3256,16 @@ var ConfirmProductReferencesRequest = z23.object({
     uploadedImages: z23.array(ProductReferenceRecoveryUpload).max(INGEST_MAX_REFERENCE_IMAGES).optional()
   }).optional()
 }).superRefine((value, context) => {
+  if (value.recovery?.action === "keep_selection" && value.recovery.uploadedImages?.length) {
+    context.addIssue({
+      code: z23.ZodIssueCode.custom,
+      path: [
+        "recovery",
+        "uploadedImages"
+      ],
+      message: "keep_selection_does_not_accept_uploads"
+    });
+  }
   if (value.recovery?.action === "refine_selection" && value.recovery.uploadedImages?.length) {
     context.addIssue({
       code: z23.ZodIssueCode.custom,
@@ -3797,6 +3833,16 @@ var PendingUserActionSchema = z26.discriminatedUnion("kind", [
     referenceEvidenceVersion: z26.number().int().positive().optional(),
     expectedEvidenceHash: z26.string().min(1).max(128).optional(),
     question: AdaptiveProductReferenceQuestionSchema.optional(),
+    /**
+    * TRUE when "sigue con estas fotos" is a real exit from this card.
+    *
+    * Absent means the seller genuinely has to supply pixels we do not have,
+    * and offering to continue would be a lie: nothing is selected at all, or
+    * a combo component was never photographed. Every client reads this — web,
+    * MCP and WhatsApp — so no surface can invent an exit the server did not
+    * offer, nor omit one it did.
+    */
+    canKeepSelection: z26.boolean().optional(),
     recovery: z26.object({
       kind: z26.literal("combo_component_evidence"),
       minimumImageCount: z26.number().int().min(2).max(5),
@@ -3973,6 +4019,28 @@ var StatusResponse = z26.object({
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
   hasAnswerableGate: z26.boolean().optional(),
+  /**
+  * "Is the ANGLE gate — and only that gate — still open?"
+  *
+  * `needsReview` is an OR over every gate (reference, angles, SCRIPT review,
+  * grouping). The chat used to read that OR as proof that the server was
+  * waiting on ANGLES, because the two conditions it paired it with
+  * (`stageStatuses.video_generator === 'pending'` + `status === 'processing'`)
+  * are ALSO true throughout script review. So the moment a script became
+  * ready — a gate the seller had already passed the angle card to reach — the
+  * chat "recovered" the angle review card over a run that was already
+  * dispatched, released its own submit guard, and re-enabled «Generar». The
+  * seller pressed it again; the second resume lost the compare-and-clear and
+  * answered 201 with a plain status body, so the no-op read as success and the
+  * loop repeated (measured 2026-08-27: three resumes in 16s, two of them
+  * no-ops).
+  *
+  * Named rather than inferred, for the same reason as `hasAnswerableGate`: a
+  * gate added tomorrow widens `needsReview` and would silently re-arm that
+  * recovery path. Absent (undefined) means "an older API that cannot answer" —
+  * clients must fall back to `pauseForAngleReview` alone, never to the OR.
+  */
+  awaitingAngleReview: z26.boolean().optional(),
   /** Which landing pipeline produced this task's landing. 'code' tasks have no
   *  classic LandingImage rows — the result lives in the inline code editor. */
   landingMode: LandingModeSchema.optional(),
@@ -10516,6 +10584,10 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   defineCapability("cost_product", "6d1f85a999dbdabae4eda406ff4689cdff2016df375b5b6741b91f4308d819af", "none", "read_only", [
     "read"
   ], [
+    slot("product_reference", false, [], [
+      "selectedProductTitle",
+      "selectedProductUrl"
+    ], "server"),
     slot("market", true, [
       "country"
     ]),
@@ -10817,7 +10889,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("product_identity", true, [
       "productTitle"
@@ -10889,7 +10962,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("locale", true, [
       "language",
@@ -10956,6 +11030,15 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       explicitOmissionAllowed: false,
       fieldCompletion: "all"
     },
+    {
+      slot: "sales_context",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "any",
+      completionFields: [
+        "salesAngle"
+      ]
+    },
     {
       slot: "commercial_offer",
       askBeforePaidExecution: true,
@@ -10971,7 +11054,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("product_identity", true, [
       "title"
@@ -11024,6 +11108,25 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "product_reference"
   ], [
     "video"
+  ], SHARED_CHANNEL_EXPOSURE, [
+    {
+      slot: "product_reference",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "any"
+    },
+    {
+      slot: "locale",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "all"
+    },
+    {
+      slot: "commercial_offer",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: true,
+      fieldCompletion: "all"
+    }
   ]),
   defineCapability("get_meta_campaign_status", "92077241cf4e9d14edefca410e85715cc383b1433081c3461c925f8fc3d6e8ab", "none", "read_only", [
     "read"
@@ -11908,6 +12011,10 @@ function parsePublicHttpsOrigin(value) {
 }
 __name(parsePublicHttpsOrigin, "parsePublicHttpsOrigin");
 
+// ../../packages/types/src/whatsapp.ts
+var WHATSAPP_MAX_AUDIO_BYTES = 16 * 1024 * 1024;
+var WHATSAPP_MAX_AUDIO_DURATION_SECONDS = 10 * 60;
+
 // src/http.ts
 import express from "express";
 import rateLimit from "express-rate-limit";
@@ -13167,7 +13274,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "6.3.0";
+var MCP_VERSION = "6.3.1";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -14266,6 +14373,7 @@ var McpErrorCode = {
   SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
   SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
   SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  SHOPIFY_NO_PUBLISHED_THEME: "SHOPIFY_NO_PUBLISHED_THEME",
   // Meta / Facebook Ads
   META_NO_FB_PAGE: "META_NO_FB_PAGE",
   META_PORTFOLIO_MISMATCH: "META_PORTFOLIO_MISMATCH",
@@ -14333,6 +14441,7 @@ var CODE_MESSAGES = {
   SHOPIFY_TOKEN_EXPIRED: "The Shopify session expired. Reconnect the store at https://productmaker.app/integrations.",
   SHOPIFY_SCOPE_UPGRADE_REQUIRED: "The Shopify connection needs additional scopes. Reconnect it at https://productmaker.app/integrations to approve the new permissions.",
   SHOPIFY_PUBLISH_FAILED: "Shopify rejected the publish. Check that the product/landing does not already exist on the store and that your Shopify plan allows additional products.",
+  SHOPIFY_NO_PUBLISHED_THEME: "The Shopify store has no published theme, so there is nowhere to place the landing. Ask the user to publish a theme (Online Store > Themes > Publish) and retry.",
   // Meta — high-frequency
   META_NO_FB_PAGE: "No Facebook Page is associated with this account. Create one at https://www.facebook.com/pages/create before publishing (Meta requires a Page to run ads).",
   META_PORTFOLIO_MISMATCH: "The selected Meta portfolio does not contain the selected ad account. Call `list_meta_destinations` again and choose an account from that portfolio.",
@@ -14518,6 +14627,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_NO_PUBLISHED_THEME,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.NO_SHOPIFY_SHOPS,
   McpErrorCode.NO_META_AD_ACCOUNTS
@@ -14543,6 +14653,7 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  McpErrorCode.SHOPIFY_NO_PUBLISHED_THEME,
   // Meta
   McpErrorCode.META_NO_FB_PAGE,
   McpErrorCode.META_NO_ADS_CREATED,
@@ -14970,9 +15081,14 @@ function renderAngleReview(pending, authorizedVideoCount) {
 __name(renderAngleReview, "renderAngleReview");
 function renderReferenceConfirmation(pending) {
   if (pending.mode === "visual_recovery") {
-    return `## Faltan fotos del producto
+    const body = escapeMarkdownText(pending.reason ?? "Necesitamos revisar las fotos antes de continuar.");
+    return pending.canKeepSelection ? `## Revisa las fotos del producto
+
+${body}
+
+Puedes **seguir con estas fotos** (sin costo adicional) llamando \`resolve_pending_action\` con \`kind: "product_reference_confirmation"\`, o abrir la tarea en ProductMaker Web para subir otras.` : `## Faltan fotos del producto
 
-${escapeMarkdownText(pending.reason ?? "Necesitamos fotos claras adicionales para continuar.")}
+${body}
 
 Abre esta tarea en ProductMaker Web para reemplazar o completar las fotos.`;
   }
@@ -15461,6 +15577,8 @@ var StatusForResolveSchema = z54.object({
       "question",
       "visual_recovery"
     ]).optional(),
+    /** Hand-mirrored from packages/types result.ts — see CLAUDE.md § MCP Server Sync. */
+    canKeepSelection: z54.boolean().optional(),
     decisionKey: z54.string().optional(),
     questionOrdinal: z54.number().int().min(1).max(5).optional(),
     questionCeiling: z54.union([
@@ -15959,7 +16077,19 @@ ANTES de invocar, resume outputs, cantidad de videos y datos comerciales, explic
             const candidateGrouping = pending.candidateGrouping;
             const selectedImageUrls = pending.selectedImageUrls ?? [];
             if (pending.mode === "visual_recovery") {
-              throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
+              if (!pending.canKeepSelection) {
+                throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
+              }
+              const kept = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+                selectedImageUrls: pending.selectedImageUrls ?? [],
+                recovery: {
+                  action: "keep_selection",
+                  ...pending.expectedEvidenceHash ? {
+                    expectedEvidenceHash: pending.expectedEvidenceHash
+                  } : {}
+                }
+              });
+              return asText(kept);
             }
             if (!candidateGrouping || selectedImageUrls.length === 0) {
               throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
@@ -18677,6 +18807,16 @@ function renderMeta(meta) {
   ].filter(Boolean);
 }
 __name(renderMeta, "renderMeta");
+function renderDiscoveryLinks(links) {
+  if (!links) return [];
+  return [
+    links.originalProductUrl ? `- [Producto original en TikTok Shop](${links.originalProductUrl})` : "- Producto original en TikTok Shop: no disponible",
+    `- [Buscar d\xF3nde comprarlo](${links.googleSearchUrl})`,
+    links.metaAdUrl ? `- [Anuncio relacionado encontrado en Meta](${links.metaAdUrl}) \u2014 comp\xE1ralo; puede ser una variante o un producto parecido` : "- Anuncio relacionado en Meta: no disponible",
+    links.kaloDataUrl ? `- [Datos en KaloData](${links.kaloDataUrl})` : "- Datos en KaloData: no disponibles"
+  ];
+}
+__name(renderDiscoveryLinks, "renderDiscoveryLinks");
 function renderCandidate(candidate, index) {
   const name = candidate.nameLocal ?? candidate.nameOriginal;
   const lines = [
@@ -18692,7 +18832,12 @@ function renderCandidate(candidate, index) {
   ]);
   lines.push("", ...renderMeta(candidate.meta));
   lines.push("", `- **Venta (30d):** ${num(candidate.units30d)} unidades \xB7 ${num(candidate.revenueUsd30d, " USD")} \xB7 crecimiento ${num(candidate.growthPct30d, "%")} \xB7 precio ${num(candidate.priceUsd, " USD")}`);
-  if (candidate.productUrl) lines.push(`- [Ver producto](${candidate.productUrl})`);
+  const discoveryLines = renderDiscoveryLinks(candidate.discoveryLinks);
+  if (discoveryLines.length > 0) {
+    lines.push("", "**D\xF3nde encontrarlo:**", ...discoveryLines);
+  } else if (candidate.productUrl) {
+    lines.push(`- [Ver producto](${candidate.productUrl})`);
+  }
   return lines.join("\n");
 }
 __name(renderCandidate, "renderCandidate");

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "6.3.0";
+var MCP_VERSION = "6.3.1";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -950,7 +950,25 @@ var AdaptiveProductReferenceStateSchema = z5.object({
   * may enrich the candidate later without changing the photos the user
   * approved; that must not invalidate the answer and reopen the question.
   */
-  lastAnsweredSelectedImageUrlsHash: z5.string().min(1).max(128).optional()
+  lastAnsweredSelectedImageUrlsHash: z5.string().min(1).max(128).optional(),
+  /**
+  * SHE PRESSED "SIGUE CON ESTAS FOTOS".
+  *
+  * The evidence version she pressed it at. The guard is
+  * `keptSelectionAtEvidenceVersion <= referenceEvidenceVersion`, so the
+  * retraction SURVIVES a later photo change — exactly like every other answer
+  * since answers stopped being filtered by evidence version. Recording the
+  * version is what makes a retraction taken at a FUTURE version (impossible
+  * today, but the ordering is asserted rather than assumed) not count.
+  *
+  * This is a RETRACTION, and it needs its own field because it cannot be
+  * expressed as an answer: the `different_products` answer that opened visual
+  * recovery short-circuits `buildAdaptiveProductReferenceDecision` before any
+  * later answer is read, so recording one more answer could never close the
+  * gate. Bumping the evidence version instead would drop every answer and
+  * restart the interview from `sale_structure` — the opposite of "continue".
+  */
+  keptSelectionAtEvidenceVersion: z5.number().int().positive().optional()
 });
 var AdaptiveProductReferenceQuestionOptionSchema = z5.object({
   value: ProductReferenceUserChoiceSchema,
@@ -3409,7 +3427,8 @@ var ShopifyPublishResponse = z22.object({
 var ShopifyPublishErrorResponse = z22.object({
   code: z22.enum([
     "SHOPIFY_NOT_CONNECTED",
-    "SHOPIFY_PUBLISH_FAILED"
+    "SHOPIFY_PUBLISH_FAILED",
+    "SHOPIFY_NO_PUBLISHED_THEME"
   ]),
   message: z22.string().optional(),
   authUrl: z22.string().url().optional(),
@@ -3551,9 +3570,16 @@ var ConfirmProductReferencesRequest = z23.object({
   referenceEvidenceVersion: z23.number().int().positive().optional(),
   expectedEvidenceHash: z23.string().min(1).max(128).optional(),
   recovery: z23.object({
+    /**
+     * `keep_selection` is NOT a recovery in the billing sense: it commits
+     * no new evidence, re-enqueues no extract, and costs nothing. It rides
+     * on this field because it answers the same card, and the server
+     * branches on it BEFORE the billed recovery path.
+     */
     action: z23.enum([
       "replace_selection",
-      "refine_selection"
+      "refine_selection",
+      "keep_selection"
     ]),
     affectedRefKeys: z23.array(z23.string().min(1).max(200)).min(1).max(5).optional(),
     expectedReferenceVersionId: z23.string().uuid().optional(),
@@ -3561,6 +3587,16 @@ var ConfirmProductReferencesRequest = z23.object({
     uploadedImages: z23.array(ProductReferenceRecoveryUpload).max(INGEST_MAX_REFERENCE_IMAGES).optional()
   }).optional()
 }).superRefine((value, context) => {
+  if (value.recovery?.action === "keep_selection" && value.recovery.uploadedImages?.length) {
+    context.addIssue({
+      code: z23.ZodIssueCode.custom,
+      path: [
+        "recovery",
+        "uploadedImages"
+      ],
+      message: "keep_selection_does_not_accept_uploads"
+    });
+  }
   if (value.recovery?.action === "refine_selection" && value.recovery.uploadedImages?.length) {
     context.addIssue({
       code: z23.ZodIssueCode.custom,
@@ -4128,6 +4164,16 @@ var PendingUserActionSchema = z26.discriminatedUnion("kind", [
     referenceEvidenceVersion: z26.number().int().positive().optional(),
     expectedEvidenceHash: z26.string().min(1).max(128).optional(),
     question: AdaptiveProductReferenceQuestionSchema.optional(),
+    /**
+    * TRUE when "sigue con estas fotos" is a real exit from this card.
+    *
+    * Absent means the seller genuinely has to supply pixels we do not have,
+    * and offering to continue would be a lie: nothing is selected at all, or
+    * a combo component was never photographed. Every client reads this — web,
+    * MCP and WhatsApp — so no surface can invent an exit the server did not
+    * offer, nor omit one it did.
+    */
+    canKeepSelection: z26.boolean().optional(),
     recovery: z26.object({
       kind: z26.literal("combo_component_evidence"),
       minimumImageCount: z26.number().int().min(2).max(5),
@@ -4304,6 +4350,28 @@ var StatusResponse = z26.object({
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
   hasAnswerableGate: z26.boolean().optional(),
+  /**
+  * "Is the ANGLE gate — and only that gate — still open?"
+  *
+  * `needsReview` is an OR over every gate (reference, angles, SCRIPT review,
+  * grouping). The chat used to read that OR as proof that the server was
+  * waiting on ANGLES, because the two conditions it paired it with
+  * (`stageStatuses.video_generator === 'pending'` + `status === 'processing'`)
+  * are ALSO true throughout script review. So the moment a script became
+  * ready — a gate the seller had already passed the angle card to reach — the
+  * chat "recovered" the angle review card over a run that was already
+  * dispatched, released its own submit guard, and re-enabled «Generar». The
+  * seller pressed it again; the second resume lost the compare-and-clear and
+  * answered 201 with a plain status body, so the no-op read as success and the
+  * loop repeated (measured 2026-08-27: three resumes in 16s, two of them
+  * no-ops).
+  *
+  * Named rather than inferred, for the same reason as `hasAnswerableGate`: a
+  * gate added tomorrow widens `needsReview` and would silently re-arm that
+  * recovery path. Absent (undefined) means "an older API that cannot answer" —
+  * clients must fall back to `pauseForAngleReview` alone, never to the OR.
+  */
+  awaitingAngleReview: z26.boolean().optional(),
   /** Which landing pipeline produced this task's landing. 'code' tasks have no
   *  classic LandingImage rows — the result lives in the inline code editor. */
   landingMode: LandingModeSchema.optional(),
@@ -10847,6 +10915,10 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   defineCapability("cost_product", "6d1f85a999dbdabae4eda406ff4689cdff2016df375b5b6741b91f4308d819af", "none", "read_only", [
     "read"
   ], [
+    slot("product_reference", false, [], [
+      "selectedProductTitle",
+      "selectedProductUrl"
+    ], "server"),
     slot("market", true, [
       "country"
     ]),
@@ -11148,7 +11220,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("product_identity", true, [
       "productTitle"
@@ -11220,7 +11293,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("locale", true, [
       "language",
@@ -11287,6 +11361,15 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       explicitOmissionAllowed: false,
       fieldCompletion: "all"
     },
+    {
+      slot: "sales_context",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "any",
+      completionFields: [
+        "salesAngle"
+      ]
+    },
     {
       slot: "commercial_offer",
       askBeforePaidExecution: true,
@@ -11302,7 +11385,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "images"
     ], [
       "imageMessageIds",
-      "projectId"
+      "projectId",
+      "productUrl"
     ]),
     slot("product_identity", true, [
       "title"
@@ -11355,6 +11439,25 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "product_reference"
   ], [
     "video"
+  ], SHARED_CHANNEL_EXPOSURE, [
+    {
+      slot: "product_reference",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "any"
+    },
+    {
+      slot: "locale",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: false,
+      fieldCompletion: "all"
+    },
+    {
+      slot: "commercial_offer",
+      askBeforePaidExecution: true,
+      explicitOmissionAllowed: true,
+      fieldCompletion: "all"
+    }
   ]),
   defineCapability("get_meta_campaign_status", "92077241cf4e9d14edefca410e85715cc383b1433081c3461c925f8fc3d6e8ab", "none", "read_only", [
     "read"
@@ -11983,6 +12086,10 @@ var ReferralDashboardOverviewSchema = z51.object({
   monthlyRegistrations: z51.array(ReferralDashboardMonthlyRegistrationSchema).refine((months) => months.length === 6, "Expected six monthly registration buckets")
 });
 
+// ../../packages/types/src/whatsapp.ts
+var WHATSAPP_MAX_AUDIO_BYTES = 16 * 1024 * 1024;
+var WHATSAPP_MAX_AUDIO_DURATION_SECONDS = 10 * 60;
+
 // src/tools/tasks.ts
 import { z as z53 } from "zod";
 
@@ -13011,6 +13118,7 @@ var McpErrorCode = {
   SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
   SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
   SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  SHOPIFY_NO_PUBLISHED_THEME: "SHOPIFY_NO_PUBLISHED_THEME",
   // Meta / Facebook Ads
   META_NO_FB_PAGE: "META_NO_FB_PAGE",
   META_PORTFOLIO_MISMATCH: "META_PORTFOLIO_MISMATCH",
@@ -13078,6 +13186,7 @@ var CODE_MESSAGES = {
   SHOPIFY_TOKEN_EXPIRED: "The Shopify session expired. Reconnect the store at https://productmaker.app/integrations.",
   SHOPIFY_SCOPE_UPGRADE_REQUIRED: "The Shopify connection needs additional scopes. Reconnect it at https://productmaker.app/integrations to approve the new permissions.",
   SHOPIFY_PUBLISH_FAILED: "Shopify rejected the publish. Check that the product/landing does not already exist on the store and that your Shopify plan allows additional products.",
+  SHOPIFY_NO_PUBLISHED_THEME: "The Shopify store has no published theme, so there is nowhere to place the landing. Ask the user to publish a theme (Online Store > Themes > Publish) and retry.",
   // Meta — high-frequency
   META_NO_FB_PAGE: "No Facebook Page is associated with this account. Create one at https://www.facebook.com/pages/create before publishing (Meta requires a Page to run ads).",
   META_PORTFOLIO_MISMATCH: "The selected Meta portfolio does not contain the selected ad account. Call `list_meta_destinations` again and choose an account from that portfolio.",
@@ -13263,6 +13372,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
   McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_NO_PUBLISHED_THEME,
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.NO_SHOPIFY_SHOPS,
   McpErrorCode.NO_META_AD_ACCOUNTS
@@ -13288,6 +13398,7 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
   McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
   McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  McpErrorCode.SHOPIFY_NO_PUBLISHED_THEME,
   // Meta
   McpErrorCode.META_NO_FB_PAGE,
   McpErrorCode.META_NO_ADS_CREATED,
@@ -13768,9 +13879,14 @@ function renderAngleReview(pending, authorizedVideoCount) {
 __name(renderAngleReview, "renderAngleReview");
 function renderReferenceConfirmation(pending) {
   if (pending.mode === "visual_recovery") {
-    return `## Faltan fotos del producto
+    const body = escapeMarkdownText(pending.reason ?? "Necesitamos revisar las fotos antes de continuar.");
+    return pending.canKeepSelection ? `## Revisa las fotos del producto
+
+${body}
+
+Puedes **seguir con estas fotos** (sin costo adicional) llamando \`resolve_pending_action\` con \`kind: "product_reference_confirmation"\`, o abrir la tarea en ProductMaker Web para subir otras.` : `## Faltan fotos del producto
 
-${escapeMarkdownText(pending.reason ?? "Necesitamos fotos claras adicionales para continuar.")}
+${body}
 
 Abre esta tarea en ProductMaker Web para reemplazar o completar las fotos.`;
   }
@@ -14259,6 +14375,8 @@ var StatusForResolveSchema = z53.object({
       "question",
       "visual_recovery"
     ]).optional(),
+    /** Hand-mirrored from packages/types result.ts — see CLAUDE.md § MCP Server Sync. */
+    canKeepSelection: z53.boolean().optional(),
     decisionKey: z53.string().optional(),
     questionOrdinal: z53.number().int().min(1).max(5).optional(),
     questionCeiling: z53.union([
@@ -14757,7 +14875,19 @@ ANTES de invocar, resume outputs, cantidad de videos y datos comerciales, explic
             const candidateGrouping = pending.candidateGrouping;
             const selectedImageUrls = pending.selectedImageUrls ?? [];
             if (pending.mode === "visual_recovery") {
-              throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
+              if (!pending.canKeepSelection) {
+                throw new Error("Esta recuperaci\xF3n necesita subir fotos con un ticket ligado al usuario. \xC1brela en ProductMaker Web; MCP no acepta URLs arbitrarias.");
+              }
+              const kept = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/confirm-product-references`, {
+                selectedImageUrls: pending.selectedImageUrls ?? [],
+                recovery: {
+                  action: "keep_selection",
+                  ...pending.expectedEvidenceHash ? {
+                    expectedEvidenceHash: pending.expectedEvidenceHash
+                  } : {}
+                }
+              });
+              return asText(kept);
             }
             if (!candidateGrouping || selectedImageUrls.length === 0) {
               throw new Error("Estado inconsistente: la tarea est\xE1 pausada pero falta candidateGrouping o selectedImageUrls.");
@@ -17475,6 +17605,16 @@ function renderMeta(meta) {
   ].filter(Boolean);
 }
 __name(renderMeta, "renderMeta");
+function renderDiscoveryLinks(links) {
+  if (!links) return [];
+  return [
+    links.originalProductUrl ? `- [Producto original en TikTok Shop](${links.originalProductUrl})` : "- Producto original en TikTok Shop: no disponible",
+    `- [Buscar d\xF3nde comprarlo](${links.googleSearchUrl})`,
+    links.metaAdUrl ? `- [Anuncio relacionado encontrado en Meta](${links.metaAdUrl}) \u2014 comp\xE1ralo; puede ser una variante o un producto parecido` : "- Anuncio relacionado en Meta: no disponible",
+    links.kaloDataUrl ? `- [Datos en KaloData](${links.kaloDataUrl})` : "- Datos en KaloData: no disponibles"
+  ];
+}
+__name(renderDiscoveryLinks, "renderDiscoveryLinks");
 function renderCandidate(candidate, index) {
   const name = candidate.nameLocal ?? candidate.nameOriginal;
   const lines = [
@@ -17490,7 +17630,12 @@ function renderCandidate(candidate, index) {
   ]);
   lines.push("", ...renderMeta(candidate.meta));
   lines.push("", `- **Venta (30d):** ${num(candidate.units30d)} unidades \xB7 ${num(candidate.revenueUsd30d, " USD")} \xB7 crecimiento ${num(candidate.growthPct30d, "%")} \xB7 precio ${num(candidate.priceUsd, " USD")}`);
-  if (candidate.productUrl) lines.push(`- [Ver producto](${candidate.productUrl})`);
+  const discoveryLines = renderDiscoveryLinks(candidate.discoveryLinks);
+  if (discoveryLines.length > 0) {
+    lines.push("", "**D\xF3nde encontrarlo:**", ...discoveryLines);
+  } else if (candidate.productUrl) {
+    lines.push(`- [Ver producto](${candidate.productUrl})`);
+  }
   return lines.join("\n");
 }
 __name(renderCandidate, "renderCandidate");

package/package.json

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