@productmaker/mcp 3.4.1 → 3.4.3

package/dist/http.js

@@ -3692,6 +3692,32 @@ var StatusResponse = z24.object({
   requiresAction: z24.boolean().optional(),
   /** True when the task needs the user's attention rather than passive progress. */
   needsReview: z24.boolean().optional(),
+  /**
+  * THE answer to "does this task still owe the seller a question — now OR later
+  * in this run?". The chat leaves for /tasks/:id only on an explicit `false`,
+  * and /tasks/:id bounces her back on `true`. ONE field drives BOTH directions
+  * on purpose: deciding them on two different facts is what looped
+  * /tasks/:id ↔ wizard before (see apps/web/lib/task-routing.ts).
+  *
+  * STRICTLY WIDER THAN `needsReview`, and the difference is the whole point:
+  *  · `needsReview` answers "is a gate open RIGHT NOW", and it under-reports —
+  *    `buildPendingUserAction` only serves the reference-grouping question when
+  *    it is RENDERABLE, so an unconfirmed target reports `false` while
+  *    `angles.worker` will still pause at the END of the angles stage.
+  *  · this field adds the gates that are GUARANTEED to open: both pause flags,
+  *    plus that same worker prediction, through the one shared helper.
+  *
+  * Absent (undefined) means "an older API that cannot answer" — the client must
+  * treat that as `true` and stay put. Uncertainty resolves to staying: a false
+  * positive costs her a wait, a false negative strands her on a screen that
+  * cannot render the gate (prod bd4d0bb1 / 52dc15a7, both refunded and
+  * undelivered).
+  *
+  * ALWAYS false on a terminal task. `pauseForAngleReview` SURVIVES on completed
+  * tasks, so without that guard a finished landing would report `true` forever
+  * and get bounced into a chat with nothing left to ask.
+  */
+  willAskAgain: z24.boolean().optional(),
   /** True when an open gate exists that somebody can actually ANSWER. A strictly
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
@@ -3826,6 +3852,9 @@ var CostEstimationType = z25.enum([
   "landing-regenerate",
   "landing-creative",
   "campaign-copy",
+  "brand-extract",
+  "persona-suggest",
+  "chat-parse",
   "service-creative",
   "actor-grid"
 ]);
@@ -3991,11 +4020,14 @@ var LandingCreativeEstimationOptions = z25.object({
   landingStrategy: LandingStrategySchema.optional()
 });
 var CampaignCopyEstimationOptions = z25.object({
-  /** Number of creatives to generate copy for (1-4) */
-  nCreatives: z25.number().int().min(1).max(4),
-  /** Number of image creatives that will use vision analysis (0-4) */
-  nImages: z25.number().int().min(0).max(4).default(0)
-});
+  /** Number of creatives in the one copy-completion request (1-10). */
+  nCreatives: z25.number().int().min(1).max(10),
+  /** Number of image creatives that can each use one vision analysis (0-10). */
+  nImages: z25.number().int().min(0).max(10).default(0)
+});
+var BrandExtractEstimationOptions = z25.object({}).strict();
+var PersonaSuggestEstimationOptions = z25.object({}).strict();
+var ChatParseEstimationOptions = z25.object({}).strict();
 var ServiceCreativeEstimationOptions = z25.object({
   mediaAssetCount: z25.number().int().min(0).max(8).optional(),
   uploadedVideoDurationSeconds: z25.number().min(0).max(240).optional()
@@ -4034,6 +4066,18 @@ var CostEstimationRequest = z25.discriminatedUnion("type", [
     type: z25.literal("campaign-copy"),
     options: CampaignCopyEstimationOptions
   }),
+  z25.object({
+    type: z25.literal("brand-extract"),
+    options: BrandExtractEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("persona-suggest"),
+    options: PersonaSuggestEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("chat-parse"),
+    options: ChatParseEstimationOptions
+  }),
   z25.object({
     type: z25.literal("service-creative"),
     options: ServiceCreativeEstimationOptions
@@ -4533,6 +4577,9 @@ var VideoMixQaJobSchema = z30.object({
 });
 var BrandExtractJobSchema = z30.object({
   brandId: z30.string().uuid(),
+  // Generation is part of the durable paid-spend identity. Default 1 keeps
+  // pre-migration BullMQ payloads parseable; their DB state fails safe.
+  generation: z30.number().int().positive().default(1),
   url: z30.string().url().refine((value) => {
     const protocol = new URL(value).protocol;
     return protocol === "http:" || protocol === "https:";
@@ -4854,6 +4901,7 @@ var MetaCampaignType = z33.enum([
   "traffic",
   "engagement"
 ]);
+var MetaPublishAttemptId = z33.string().uuid();
 var MetaOptimizationMode = z33.enum([
   "advantage_plus",
   "manual"
@@ -5037,6 +5085,8 @@ var MetaCampaignDefaults = MetaCampaignConfigBase.omit({
   currency: z33.string().length(3).regex(/^[A-Z]{3}$/).nullable().optional()
 });
 var UploadToMetaRequest = z33.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   /** Array of creatives to upload */
   creatives: z33.array(z33.object({
     creativeId: z33.string().min(1).optional(),
@@ -5193,6 +5243,8 @@ var MetaCampaignOverridesSchema = z34.object({
   destination: MetaCampaignDestination.optional()
 });
 var FacebookCreateCampaignBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   adAccountId: MetaAdAccountId,
   portfolioId: z34.string().min(1).optional(),
   pageId: z34.string().min(1).optional(),
@@ -5262,6 +5314,8 @@ var FacebookCreateCampaignResponseSchema = z34.object({
   appliedBudget: z34.number().int().positive()
 });
 var FacebookCreateCampaignFromCreativesBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   creatives: z34.array(z34.object({
     type: z34.enum([
       "image",
@@ -5409,6 +5463,8 @@ var FacebookCreativeSourceSchema = z34.discriminatedUnion("type", [
   FacebookMediaCreativeSourceSchema
 ]);
 var FacebookCreateCampaignFromTasksBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   creatives: z34.array(z34.object({
     type: z34.enum([
       "image",
@@ -11631,7 +11687,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.4.1";
+var MCP_VERSION = "3.4.3";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -11943,6 +11999,7 @@ __name(resolveOne, "resolveOne");
 
 // src/status-poller.ts
 var TERMINAL = /* @__PURE__ */ new Set([
+  "done",
   "complete",
   "error"
 ]);
@@ -12618,6 +12675,7 @@ var McpErrorCode = {
   REVOKED_API_KEY: "REVOKED_API_KEY",
   // Rate limit / quota
   RATE_LIMITED: "RATE_LIMITED",
+  CREDIT_ADMISSION_UNAVAILABLE: "CREDIT_ADMISSION_UNAVAILABLE",
   // Input
   INVALID_INPUT: "INVALID_INPUT",
   INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
@@ -12675,6 +12733,12 @@ var McpErrorCode = {
   META_STAGED_ASSET_AMBIGUOUS: "META_STAGED_ASSET_AMBIGUOUS",
   META_STAGED_ASSET_TYPE_MISMATCH: "META_STAGED_ASSET_TYPE_MISMATCH",
   META_STAGED_ASSET_INVALID: "META_STAGED_ASSET_INVALID",
+  META_STAGING_QUOTA_EXCEEDED: "META_STAGING_QUOTA_EXCEEDED",
+  CAPACITY_UNAVAILABLE: "CAPACITY_UNAVAILABLE",
+  UPLOAD_INCOMPLETE: "UPLOAD_INCOMPLETE",
+  UPLOAD_EXPIRED: "UPLOAD_EXPIRED",
+  META_UPLOAD_SESSION_EXPIRED: "META_UPLOAD_SESSION_EXPIRED",
+  META_PUBLICATION_LEASE_STALE: "META_PUBLICATION_LEASE_STALE",
   META_PUBLICATION_RECONCILIATION_REQUIRED: "META_PUBLICATION_RECONCILIATION_REQUIRED",
   META_PUBLICATION_IN_PROGRESS: "META_PUBLICATION_IN_PROGRESS",
   META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
@@ -12736,8 +12800,14 @@ var CODE_MESSAGES = {
   META_STAGED_ASSET_AMBIGUOUS: "The temporary media upload could not be uniquely resolved. Re-upload the media and retry the Meta publication.",
   META_STAGED_ASSET_TYPE_MISMATCH: "The temporary media type does not match the creative. Re-upload the correct image or video and retry.",
   META_STAGED_ASSET_INVALID: "The temporary media is empty or exceeds the server size limit. Re-upload the file and retry.",
-  META_PUBLICATION_RECONCILIATION_REQUIRED: "A previous Meta publication with these exact inputs may already exist. Check Meta before retrying so you do not create a duplicate campaign.",
-  META_PUBLICATION_IN_PROGRESS: "A Meta publication with these exact inputs is already in progress. Wait for it to finish, then check the campaign status.",
+  META_STAGING_QUOTA_EXCEEDED: "The temporary Meta staging quota was reached. Keep completed files and retry only pending files after retryAt.",
+  CAPACITY_UNAVAILABLE: "Temporary Meta staging capacity is unavailable. Keep completed files and retry only pending files later.",
+  UPLOAD_INCOMPLETE: "A temporary Meta upload is incomplete. Keep completed files and retry only pending files.",
+  UPLOAD_EXPIRED: "The temporary Meta upload expired. Re-upload this file before publishing.",
+  META_UPLOAD_SESSION_EXPIRED: "The Meta upload session expired. Open a new session and retry only pending files.",
+  META_PUBLICATION_LEASE_STALE: "The Meta publication lease expired or was replaced. Do not continue this stale publication; start a new explicit attempt only after confirming Meta did not receive it.",
+  META_PUBLICATION_RECONCILIATION_REQUIRED: "Meta may already have received this publication. Do not resend it; check Meta Ads Manager.",
+  META_PUBLICATION_IN_PROGRESS: "This Meta publication is already in progress. Do not resend it.",
   META_NO_ADS_CREATED: "No ads could be created. Most likely: the Meta Ads account has no payment method, no Facebook Page is linked, or the Facebook app lost permissions. Verify all three at https://business.facebook.com.",
   META_NO_ASSETS_READY: "The task has no videos or ad creative ready to publish yet. Wait for generation to finish or regenerate the assets.",
   META_NO_THUMBNAIL_SOURCE: "No image is available to use as the video thumbnail. Upload a product image or generate the ad creative before publishing.",
@@ -12806,6 +12876,7 @@ var CODE_MESSAGES = {
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
+  CREDIT_ADMISSION_UNAVAILABLE: "Credit admission is temporarily unavailable. Do not retry a paid action until ProductMaker can verify the balance.",
   INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
@@ -12885,6 +12956,11 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.META_STAGED_ASSET_AMBIGUOUS,
   McpErrorCode.META_STAGED_ASSET_TYPE_MISMATCH,
   McpErrorCode.META_STAGED_ASSET_INVALID,
+  McpErrorCode.META_STAGING_QUOTA_EXCEEDED,
+  McpErrorCode.UPLOAD_INCOMPLETE,
+  McpErrorCode.UPLOAD_EXPIRED,
+  McpErrorCode.META_UPLOAD_SESSION_EXPIRED,
+  McpErrorCode.META_PUBLICATION_LEASE_STALE,
   McpErrorCode.META_PUBLICATION_RECONCILIATION_REQUIRED,
   McpErrorCode.META_PUBLICATION_IN_PROGRESS,
   McpErrorCode.TIKTOK_TOKEN_EXPIRED,
@@ -12900,6 +12976,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.NO_META_AD_ACCOUNTS
 ]);
 var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.DROPSHIPPING_PROJECT_NOT_FOUND,
@@ -12943,6 +13020,14 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
   McpErrorCode.META_WHATSAPP_INVALID_NUMBER,
   McpErrorCode.META_INVALID_CTA,
+  McpErrorCode.META_STAGING_QUOTA_EXCEEDED,
+  McpErrorCode.CAPACITY_UNAVAILABLE,
+  McpErrorCode.UPLOAD_INCOMPLETE,
+  McpErrorCode.UPLOAD_EXPIRED,
+  McpErrorCode.META_UPLOAD_SESSION_EXPIRED,
+  McpErrorCode.META_PUBLICATION_LEASE_STALE,
+  McpErrorCode.META_PUBLICATION_RECONCILIATION_REQUIRED,
+  McpErrorCode.META_PUBLICATION_IN_PROGRESS,
   // TikTok
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.TIKTOK_TOKEN_EXPIRED,
@@ -12998,6 +13083,7 @@ __name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
 function resolveMessage(code, backendMessage) {
   const mapped = CODE_MESSAGES[code];
   const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (code === McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE && mapped) return mapped;
   if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
     return `${mapped} (Detail: ${backend})`;
   }
@@ -13030,6 +13116,10 @@ function translateError(err) {
       if (body.helpUrl !== void 0) extra.helpUrl = body.helpUrl;
       if (typeof body.requiredCredits === "number") extra.requiredCredits = body.requiredCredits;
       if (typeof body.availableCredits === "number") extra.availableCredits = body.availableCredits;
+      if (typeof body.dimension === "string") extra.dimension = body.dimension;
+      if (typeof body.usage === "number") extra.usage = body.usage;
+      if (typeof body.limit === "number") extra.limit = body.limit;
+      if (typeof body.retryAt === "string") extra.retryAt = body.retryAt;
       return mcp(code, resolveMessage(code, body.message), extra);
     }
     if (err.status === 401) {
@@ -14703,6 +14793,57 @@ __name(registerActorTools, "registerActorTools");
 
 // src/tools/publish.ts
 import { z as z56 } from "zod";
+
+// src/tools/stable-uuid.ts
+import { createHash as createHash3 } from "crypto";
+function canonicalize(value) {
+  if (Array.isArray(value)) return value.map(canonicalize);
+  if (value === null || typeof value !== "object") return value;
+  const record = value;
+  return Object.fromEntries(Object.keys(record).sort().filter((key) => record[key] !== void 0).map((key) => [
+    key,
+    canonicalize(record[key])
+  ]));
+}
+__name(canonicalize, "canonicalize");
+function canonicalJson(value) {
+  return JSON.stringify(canonicalize(value));
+}
+__name(canonicalJson, "canonicalJson");
+function deriveUuidV5(name, namespace) {
+  const namespaceBytes = Buffer.from(namespace.replaceAll("-", ""), "hex");
+  const digest = createHash3("sha1").update(namespaceBytes).update(name, "utf8").digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+__name(deriveUuidV5, "deriveUuidV5");
+
+// src/tools/meta-publish-attempt-id.ts
+var META_PUBLISH_NAMESPACE = "7b19c9ac-b4eb-4db1-970e-c2f24ce30b98";
+function deriveMetaPublishAttemptId(input) {
+  const operationIdentity = canonicalJson([
+    input.fingerprint,
+    input.toolName,
+    [
+      typeof input.requestId,
+      input.requestId
+    ],
+    input.canonicalInput
+  ]);
+  return deriveUuidV5(operationIdentity, META_PUBLISH_NAMESPACE);
+}
+__name(deriveMetaPublishAttemptId, "deriveMetaPublishAttemptId");
+
+// src/tools/publish.ts
 var ShopifyInput = z56.object({
   taskId: z56.string().min(1),
   shopDomain: z56.string().min(1),
@@ -15030,10 +15171,19 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`.", MetaInput.shape, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, phoneNumber, ...rest }) => {
+  server.tool("publish_to_meta", "Publica tus creativos en Meta sin gastar cr\xE9ditos de ProductMaker. El presupuesto de anuncios se paga directamente desde tu cuenta de Meta. Crear creativos o copy con IA sigue usando cr\xE9ditos. Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`. Si el resultado es ambiguo, NO reenv\xEDes: revisa Meta Ads Manager.", MetaInput.shape, CREATES_EXTERNAL, async (rawInput, extra) => {
     try {
+      const parsed = MetaInput.safeParse(rawInput);
+      if (!parsed.success) throw invalidInputFromZod(parsed.error);
+      const { taskId, campaignConfig, primaryText, phoneNumber, ...rest } = parsed.data;
       const body = {
-        ...rest
+        ...rest,
+        publishAttemptId: deriveMetaPublishAttemptId({
+          fingerprint: api.fingerprint(),
+          toolName: "publish_to_meta",
+          requestId: extra.requestId,
+          canonicalInput: parsed.data
+        })
       };
       if (campaignConfig) {
         body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
@@ -15058,7 +15208,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, publica s\xF3lo los assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla, quedan durante el TTL para reintento. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, CREATES_EXTERNAL, async (rawInput) => {
+  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Publica tus creativos en Meta sin gastar cr\xE9ditos de ProductMaker. El presupuesto de anuncios se paga directamente desde tu cuenta de Meta. Crear creativos o copy con IA sigue usando cr\xE9ditos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, conserva los assets confirmados, procesa s\xF3lo los pendientes y publica \xFAnicamente assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla antes de enviar una mutaci\xF3n a Meta, quedan durante el TTL. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente. Si el resultado es ambiguo, NO reenv\xEDes: revisa Meta Ads Manager.', PublishCreativesToMetaInputBase.shape, CREATES_EXTERNAL, async (rawInput, extra) => {
     try {
       const parsed = PublishCreativesToMetaInput.safeParse(rawInput);
       if (!parsed.success) throw invalidInputFromZod(parsed.error);
@@ -15138,7 +15288,13 @@ function registerPublishTools(server, api, opts = {}) {
         landingUrl: input.landingUrl,
         targetCountry: input.targetCountry,
         campaignName: input.campaignName,
-        campaignConfig: input.campaignConfig
+        campaignConfig: input.campaignConfig,
+        publishAttemptId: deriveMetaPublishAttemptId({
+          fingerprint: api.fingerprint(),
+          toolName: "publish_creatives_to_meta",
+          requestId: extra.requestId,
+          canonicalInput: input
+        })
       });
       return asText({
         ...r,
@@ -16025,29 +16181,12 @@ __name(formatPercent, "formatPercent");
 import { z as z62 } from "zod";
 
 // src/tools/product-research-idempotency.ts
-import { createHash as createHash3 } from "crypto";
 var RESEARCH_IDEMPOTENCY_WINDOW_MS = 2 * 60 * 60 * 1e3;
 var NAMESPACE = "6f9d3a1e-8c47-4b52-9f10-2d7e5a3c8b64";
-function uuidV5(name, namespace) {
-  const namespaceBytes = Buffer.from(namespace.replace(/-/g, ""), "hex");
-  const digest = createHash3("sha1").update(namespaceBytes).update(name, "utf8").digest();
-  const bytes = Buffer.from(digest.subarray(0, 16));
-  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
-  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
-  const hex = bytes.toString("hex");
-  return [
-    hex.slice(0, 8),
-    hex.slice(8, 12),
-    hex.slice(12, 16),
-    hex.slice(16, 20),
-    hex.slice(20)
-  ].join("-");
-}
-__name(uuidV5, "uuidV5");
 function deriveIdempotencyKey(input) {
   const window = Math.floor(input.nowMs / RESEARCH_IDEMPOTENCY_WINDOW_MS);
   const name = `${input.fingerprint}:${input.targetCountry}:${input.categoryKey}:${window}`;
-  return uuidV5(name, NAMESPACE);
+  return deriveUuidV5(name, NAMESPACE);
 }
 __name(deriveIdempotencyKey, "deriveIdempotencyKey");
 

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.4.1";
+var MCP_VERSION = "3.4.3";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -576,6 +576,7 @@ __name(resolveOne, "resolveOne");
 
 // src/status-poller.ts
 var TERMINAL = /* @__PURE__ */ new Set([
+  "done",
   "complete",
   "error"
 ]);
@@ -4313,6 +4314,32 @@ var StatusResponse = z24.object({
   requiresAction: z24.boolean().optional(),
   /** True when the task needs the user's attention rather than passive progress. */
   needsReview: z24.boolean().optional(),
+  /**
+  * THE answer to "does this task still owe the seller a question — now OR later
+  * in this run?". The chat leaves for /tasks/:id only on an explicit `false`,
+  * and /tasks/:id bounces her back on `true`. ONE field drives BOTH directions
+  * on purpose: deciding them on two different facts is what looped
+  * /tasks/:id ↔ wizard before (see apps/web/lib/task-routing.ts).
+  *
+  * STRICTLY WIDER THAN `needsReview`, and the difference is the whole point:
+  *  · `needsReview` answers "is a gate open RIGHT NOW", and it under-reports —
+  *    `buildPendingUserAction` only serves the reference-grouping question when
+  *    it is RENDERABLE, so an unconfirmed target reports `false` while
+  *    `angles.worker` will still pause at the END of the angles stage.
+  *  · this field adds the gates that are GUARANTEED to open: both pause flags,
+  *    plus that same worker prediction, through the one shared helper.
+  *
+  * Absent (undefined) means "an older API that cannot answer" — the client must
+  * treat that as `true` and stay put. Uncertainty resolves to staying: a false
+  * positive costs her a wait, a false negative strands her on a screen that
+  * cannot render the gate (prod bd4d0bb1 / 52dc15a7, both refunded and
+  * undelivered).
+  *
+  * ALWAYS false on a terminal task. `pauseForAngleReview` SURVIVES on completed
+  * tasks, so without that guard a finished landing would report `true` forever
+  * and get bounced into a chat with nothing left to ask.
+  */
+  willAskAgain: z24.boolean().optional(),
   /** True when an open gate exists that somebody can actually ANSWER. A strictly
   *  narrower fact than `needsReview` — see the identical field on `TaskSummary`
   *  below for why conflating the two produced a call to action that led nowhere. */
@@ -4447,6 +4474,9 @@ var CostEstimationType = z25.enum([
   "landing-regenerate",
   "landing-creative",
   "campaign-copy",
+  "brand-extract",
+  "persona-suggest",
+  "chat-parse",
   "service-creative",
   "actor-grid"
 ]);
@@ -4612,11 +4642,14 @@ var LandingCreativeEstimationOptions = z25.object({
   landingStrategy: LandingStrategySchema.optional()
 });
 var CampaignCopyEstimationOptions = z25.object({
-  /** Number of creatives to generate copy for (1-4) */
-  nCreatives: z25.number().int().min(1).max(4),
-  /** Number of image creatives that will use vision analysis (0-4) */
-  nImages: z25.number().int().min(0).max(4).default(0)
-});
+  /** Number of creatives in the one copy-completion request (1-10). */
+  nCreatives: z25.number().int().min(1).max(10),
+  /** Number of image creatives that can each use one vision analysis (0-10). */
+  nImages: z25.number().int().min(0).max(10).default(0)
+});
+var BrandExtractEstimationOptions = z25.object({}).strict();
+var PersonaSuggestEstimationOptions = z25.object({}).strict();
+var ChatParseEstimationOptions = z25.object({}).strict();
 var ServiceCreativeEstimationOptions = z25.object({
   mediaAssetCount: z25.number().int().min(0).max(8).optional(),
   uploadedVideoDurationSeconds: z25.number().min(0).max(240).optional()
@@ -4655,6 +4688,18 @@ var CostEstimationRequest = z25.discriminatedUnion("type", [
     type: z25.literal("campaign-copy"),
     options: CampaignCopyEstimationOptions
   }),
+  z25.object({
+    type: z25.literal("brand-extract"),
+    options: BrandExtractEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("persona-suggest"),
+    options: PersonaSuggestEstimationOptions
+  }),
+  z25.object({
+    type: z25.literal("chat-parse"),
+    options: ChatParseEstimationOptions
+  }),
   z25.object({
     type: z25.literal("service-creative"),
     options: ServiceCreativeEstimationOptions
@@ -5154,6 +5199,9 @@ var VideoMixQaJobSchema = z30.object({
 });
 var BrandExtractJobSchema = z30.object({
   brandId: z30.string().uuid(),
+  // Generation is part of the durable paid-spend identity. Default 1 keeps
+  // pre-migration BullMQ payloads parseable; their DB state fails safe.
+  generation: z30.number().int().positive().default(1),
   url: z30.string().url().refine((value) => {
     const protocol = new URL(value).protocol;
     return protocol === "http:" || protocol === "https:";
@@ -5475,6 +5523,7 @@ var MetaCampaignType = z33.enum([
   "traffic",
   "engagement"
 ]);
+var MetaPublishAttemptId = z33.string().uuid();
 var MetaOptimizationMode = z33.enum([
   "advantage_plus",
   "manual"
@@ -5658,6 +5707,8 @@ var MetaCampaignDefaults = MetaCampaignConfigBase.omit({
   currency: z33.string().length(3).regex(/^[A-Z]{3}$/).nullable().optional()
 });
 var UploadToMetaRequest = z33.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   /** Array of creatives to upload */
   creatives: z33.array(z33.object({
     creativeId: z33.string().min(1).optional(),
@@ -5814,6 +5865,8 @@ var MetaCampaignOverridesSchema = z34.object({
   destination: MetaCampaignDestination.optional()
 });
 var FacebookCreateCampaignBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   adAccountId: MetaAdAccountId,
   portfolioId: z34.string().min(1).optional(),
   pageId: z34.string().min(1).optional(),
@@ -5883,6 +5936,8 @@ var FacebookCreateCampaignResponseSchema = z34.object({
   appliedBudget: z34.number().int().positive()
 });
 var FacebookCreateCampaignFromCreativesBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   creatives: z34.array(z34.object({
     type: z34.enum([
       "image",
@@ -6030,6 +6085,8 @@ var FacebookCreativeSourceSchema = z34.discriminatedUnion("type", [
   FacebookMediaCreativeSourceSchema
 ]);
 var FacebookCreateCampaignFromTasksBodySchema = z34.object({
+  /** Caller-owned retry fence. Required before any provider operation. */
+  publishAttemptId: MetaPublishAttemptId,
   creatives: z34.array(z34.object({
     type: z34.enum([
       "image",
@@ -11367,6 +11424,7 @@ var McpErrorCode = {
   REVOKED_API_KEY: "REVOKED_API_KEY",
   // Rate limit / quota
   RATE_LIMITED: "RATE_LIMITED",
+  CREDIT_ADMISSION_UNAVAILABLE: "CREDIT_ADMISSION_UNAVAILABLE",
   // Input
   INVALID_INPUT: "INVALID_INPUT",
   INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS",
@@ -11424,6 +11482,12 @@ var McpErrorCode = {
   META_STAGED_ASSET_AMBIGUOUS: "META_STAGED_ASSET_AMBIGUOUS",
   META_STAGED_ASSET_TYPE_MISMATCH: "META_STAGED_ASSET_TYPE_MISMATCH",
   META_STAGED_ASSET_INVALID: "META_STAGED_ASSET_INVALID",
+  META_STAGING_QUOTA_EXCEEDED: "META_STAGING_QUOTA_EXCEEDED",
+  CAPACITY_UNAVAILABLE: "CAPACITY_UNAVAILABLE",
+  UPLOAD_INCOMPLETE: "UPLOAD_INCOMPLETE",
+  UPLOAD_EXPIRED: "UPLOAD_EXPIRED",
+  META_UPLOAD_SESSION_EXPIRED: "META_UPLOAD_SESSION_EXPIRED",
+  META_PUBLICATION_LEASE_STALE: "META_PUBLICATION_LEASE_STALE",
   META_PUBLICATION_RECONCILIATION_REQUIRED: "META_PUBLICATION_RECONCILIATION_REQUIRED",
   META_PUBLICATION_IN_PROGRESS: "META_PUBLICATION_IN_PROGRESS",
   META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
@@ -11485,8 +11549,14 @@ var CODE_MESSAGES = {
   META_STAGED_ASSET_AMBIGUOUS: "The temporary media upload could not be uniquely resolved. Re-upload the media and retry the Meta publication.",
   META_STAGED_ASSET_TYPE_MISMATCH: "The temporary media type does not match the creative. Re-upload the correct image or video and retry.",
   META_STAGED_ASSET_INVALID: "The temporary media is empty or exceeds the server size limit. Re-upload the file and retry.",
-  META_PUBLICATION_RECONCILIATION_REQUIRED: "A previous Meta publication with these exact inputs may already exist. Check Meta before retrying so you do not create a duplicate campaign.",
-  META_PUBLICATION_IN_PROGRESS: "A Meta publication with these exact inputs is already in progress. Wait for it to finish, then check the campaign status.",
+  META_STAGING_QUOTA_EXCEEDED: "The temporary Meta staging quota was reached. Keep completed files and retry only pending files after retryAt.",
+  CAPACITY_UNAVAILABLE: "Temporary Meta staging capacity is unavailable. Keep completed files and retry only pending files later.",
+  UPLOAD_INCOMPLETE: "A temporary Meta upload is incomplete. Keep completed files and retry only pending files.",
+  UPLOAD_EXPIRED: "The temporary Meta upload expired. Re-upload this file before publishing.",
+  META_UPLOAD_SESSION_EXPIRED: "The Meta upload session expired. Open a new session and retry only pending files.",
+  META_PUBLICATION_LEASE_STALE: "The Meta publication lease expired or was replaced. Do not continue this stale publication; start a new explicit attempt only after confirming Meta did not receive it.",
+  META_PUBLICATION_RECONCILIATION_REQUIRED: "Meta may already have received this publication. Do not resend it; check Meta Ads Manager.",
+  META_PUBLICATION_IN_PROGRESS: "This Meta publication is already in progress. Do not resend it.",
   META_NO_ADS_CREATED: "No ads could be created. Most likely: the Meta Ads account has no payment method, no Facebook Page is linked, or the Facebook app lost permissions. Verify all three at https://business.facebook.com.",
   META_NO_ASSETS_READY: "The task has no videos or ad creative ready to publish yet. Wait for generation to finish or regenerate the assets.",
   META_NO_THUMBNAIL_SOURCE: "No image is available to use as the video thumbnail. Upload a product image or generate the ad creative before publishing.",
@@ -11555,6 +11625,7 @@ var CODE_MESSAGES = {
   REVOKED_API_KEY: "API key revoked. Generate a new one at https://productmaker.app/account/api-keys.",
   // Rate
   RATE_LIMITED: "Too many requests. Wait a few seconds.",
+  CREDIT_ADMISSION_UNAVAILABLE: "Credit admission is temporarily unavailable. Do not retry a paid action until ProductMaker can verify the balance.",
   INSUFFICIENT_CREDITS: "Insufficient credits for this action. Check your balance and add credits at https://productmaker.app before retrying.",
   TASK_QUOTA_EXCEEDED: "You reached the active-task limit. Wait for a task to finish before creating another variant.",
   // Generic
@@ -11634,6 +11705,11 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.META_STAGED_ASSET_AMBIGUOUS,
   McpErrorCode.META_STAGED_ASSET_TYPE_MISMATCH,
   McpErrorCode.META_STAGED_ASSET_INVALID,
+  McpErrorCode.META_STAGING_QUOTA_EXCEEDED,
+  McpErrorCode.UPLOAD_INCOMPLETE,
+  McpErrorCode.UPLOAD_EXPIRED,
+  McpErrorCode.META_UPLOAD_SESSION_EXPIRED,
+  McpErrorCode.META_PUBLICATION_LEASE_STALE,
   McpErrorCode.META_PUBLICATION_RECONCILIATION_REQUIRED,
   McpErrorCode.META_PUBLICATION_IN_PROGRESS,
   McpErrorCode.TIKTOK_TOKEN_EXPIRED,
@@ -11649,6 +11725,7 @@ var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.NO_META_AD_ACCOUNTS
 ]);
 var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE,
   McpErrorCode.INSUFFICIENT_CREDITS,
   McpErrorCode.TASK_QUOTA_EXCEEDED,
   McpErrorCode.DROPSHIPPING_PROJECT_NOT_FOUND,
@@ -11692,6 +11769,14 @@ var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
   McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
   McpErrorCode.META_WHATSAPP_INVALID_NUMBER,
   McpErrorCode.META_INVALID_CTA,
+  McpErrorCode.META_STAGING_QUOTA_EXCEEDED,
+  McpErrorCode.CAPACITY_UNAVAILABLE,
+  McpErrorCode.UPLOAD_INCOMPLETE,
+  McpErrorCode.UPLOAD_EXPIRED,
+  McpErrorCode.META_UPLOAD_SESSION_EXPIRED,
+  McpErrorCode.META_PUBLICATION_LEASE_STALE,
+  McpErrorCode.META_PUBLICATION_RECONCILIATION_REQUIRED,
+  McpErrorCode.META_PUBLICATION_IN_PROGRESS,
   // TikTok
   McpErrorCode.TIKTOK_NOT_CONNECTED,
   McpErrorCode.TIKTOK_TOKEN_EXPIRED,
@@ -11747,6 +11832,7 @@ __name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
 function resolveMessage(code, backendMessage) {
   const mapped = CODE_MESSAGES[code];
   const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (code === McpErrorCode.CREDIT_ADMISSION_UNAVAILABLE && mapped) return mapped;
   if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
     return `${mapped} (Detail: ${backend})`;
   }
@@ -11779,6 +11865,10 @@ function translateError(err) {
       if (body.helpUrl !== void 0) extra.helpUrl = body.helpUrl;
       if (typeof body.requiredCredits === "number") extra.requiredCredits = body.requiredCredits;
       if (typeof body.availableCredits === "number") extra.availableCredits = body.availableCredits;
+      if (typeof body.dimension === "string") extra.dimension = body.dimension;
+      if (typeof body.usage === "number") extra.usage = body.usage;
+      if (typeof body.limit === "number") extra.limit = body.limit;
+      if (typeof body.retryAt === "string") extra.retryAt = body.retryAt;
       return mcp(code, resolveMessage(code, body.message), extra);
     }
     if (err.status === 401) {
@@ -13505,6 +13595,57 @@ __name(registerActorTools, "registerActorTools");
 
 // src/tools/publish.ts
 import { z as z55 } from "zod";
+
+// src/tools/stable-uuid.ts
+import { createHash as createHash2 } from "crypto";
+function canonicalize(value) {
+  if (Array.isArray(value)) return value.map(canonicalize);
+  if (value === null || typeof value !== "object") return value;
+  const record = value;
+  return Object.fromEntries(Object.keys(record).sort().filter((key) => record[key] !== void 0).map((key) => [
+    key,
+    canonicalize(record[key])
+  ]));
+}
+__name(canonicalize, "canonicalize");
+function canonicalJson(value) {
+  return JSON.stringify(canonicalize(value));
+}
+__name(canonicalJson, "canonicalJson");
+function deriveUuidV5(name, namespace) {
+  const namespaceBytes = Buffer.from(namespace.replaceAll("-", ""), "hex");
+  const digest = createHash2("sha1").update(namespaceBytes).update(name, "utf8").digest();
+  const bytes = Buffer.from(digest.subarray(0, 16));
+  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = bytes.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+__name(deriveUuidV5, "deriveUuidV5");
+
+// src/tools/meta-publish-attempt-id.ts
+var META_PUBLISH_NAMESPACE = "7b19c9ac-b4eb-4db1-970e-c2f24ce30b98";
+function deriveMetaPublishAttemptId(input) {
+  const operationIdentity = canonicalJson([
+    input.fingerprint,
+    input.toolName,
+    [
+      typeof input.requestId,
+      input.requestId
+    ],
+    input.canonicalInput
+  ]);
+  return deriveUuidV5(operationIdentity, META_PUBLISH_NAMESPACE);
+}
+__name(deriveMetaPublishAttemptId, "deriveMetaPublishAttemptId");
+
+// src/tools/publish.ts
 var ShopifyInput = z55.object({
   taskId: z55.string().min(1),
   shopDomain: z55.string().min(1),
@@ -13832,10 +13973,19 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`.", MetaInput.shape, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, phoneNumber, ...rest }) => {
+  server.tool("publish_to_meta", "Publica tus creativos en Meta sin gastar cr\xE9ditos de ProductMaker. El presupuesto de anuncios se paga directamente desde tu cuenta de Meta. Crear creativos o copy con IA sigue usando cr\xE9ditos. Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde UNA sola tarea. Antes llama `list_meta_destinations`, deja que el usuario elija el `portfolioId` (Business portfolio), el `adAccountId` y el `pageId` exactos, y env\xEDa esos tres valores; no adivines ni uses la primera p\xE1gina. Si quieres juntar creativos de VARIAS tareas usa `publish_creatives_to_meta`. La campa\xF1a se crea SIEMPRE PAUSED y el usuario la activa manualmente. `pixelId` es opcional. `angleIndexes` permite seleccionar \xE1ngulos. `campaignConfig` admite presupuesto en USD, pa\xEDses ISO-2 y nombre. `primaryText` permite reemplazar el copy y `phoneNumber` configura WhatsApp. Despu\xE9s usa `get_meta_campaign_status`. Si el resultado es ambiguo, NO reenv\xEDes: revisa Meta Ads Manager.", MetaInput.shape, CREATES_EXTERNAL, async (rawInput, extra) => {
     try {
+      const parsed = MetaInput.safeParse(rawInput);
+      if (!parsed.success) throw invalidInputFromZod(parsed.error);
+      const { taskId, campaignConfig, primaryText, phoneNumber, ...rest } = parsed.data;
       const body = {
-        ...rest
+        ...rest,
+        publishAttemptId: deriveMetaPublishAttemptId({
+          fingerprint: api.fingerprint(),
+          toolName: "publish_to_meta",
+          requestId: extra.requestId,
+          canonicalInput: parsed.data
+        })
       };
       if (campaignConfig) {
         body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
@@ -13860,7 +14010,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, publica s\xF3lo los assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla, quedan durante el TTL para reintento. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente.', PublishCreativesToMetaInputBase.shape, CREATES_EXTERNAL, async (rawInput) => {
+  server.tool("publish_creatives_to_meta", "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta " + CAMPAIGN_LIMITS.MAX_CREATIVES + ' creativos. Publica tus creativos en Meta sin gastar cr\xE9ditos de ProductMaker. El presupuesto de anuncios se paga directamente desde tu cuenta de Meta. Crear creativos o copy con IA sigue usando cr\xE9ditos. Si la petici\xF3n natural adjunta o menciona archivos locales, llama primero `request_media_upload`; tras OK usa cada resultado como `source.type="asset"` con su `assetId` y el `type` que coincide con `mediaKind`. No pidas path ni URL. Despu\xE9s llama `list_meta_destinations` y pregunta en el chat por el `portfolioId`, `adAccountId` y `pageId` exactos; el App es solo para archivos. Si la carga fue parcial, conserva los assets confirmados, procesa s\xF3lo los pendientes y publica \xFAnicamente assets confirmados; nunca inventes assets ni superes diez creativos. Las rutas locales s\xF3lo funcionan con MCP stdio. Los medios propios se eliminan despu\xE9s de publicar correctamente; si falla antes de enviar una mutaci\xF3n a Meta, quedan durante el TTL. Para videos la miniatura es opcional y ProductMaker puede generarla con FFmpeg. `campaignConfig.destination` acepta landing o WhatsApp. Para landing basta `campaignConfig.destination.landingUrl`; no dupliques la URL arriba. Si omites `budgetMode`, se infiere `ad_set` cuando cada ad set trae `dailyBudget`, o `campaign` cuando env\xEDas `campaignDailyBudget`. No actives la campa\xF1a autom\xE1ticamente. Si el resultado es ambiguo, NO reenv\xEDes: revisa Meta Ads Manager.', PublishCreativesToMetaInputBase.shape, CREATES_EXTERNAL, async (rawInput, extra) => {
     try {
       const parsed = PublishCreativesToMetaInput.safeParse(rawInput);
       if (!parsed.success) throw invalidInputFromZod(parsed.error);
@@ -13940,7 +14090,13 @@ function registerPublishTools(server, api, opts = {}) {
         landingUrl: input.landingUrl,
         targetCountry: input.targetCountry,
         campaignName: input.campaignName,
-        campaignConfig: input.campaignConfig
+        campaignConfig: input.campaignConfig,
+        publishAttemptId: deriveMetaPublishAttemptId({
+          fingerprint: api.fingerprint(),
+          toolName: "publish_creatives_to_meta",
+          requestId: extra.requestId,
+          canonicalInput: input
+        })
       });
       return asText({
         ...r,
@@ -14827,29 +14983,12 @@ __name(formatPercent, "formatPercent");
 import { z as z61 } from "zod";
 
 // src/tools/product-research-idempotency.ts
-import { createHash as createHash2 } from "crypto";
 var RESEARCH_IDEMPOTENCY_WINDOW_MS = 2 * 60 * 60 * 1e3;
 var NAMESPACE = "6f9d3a1e-8c47-4b52-9f10-2d7e5a3c8b64";
-function uuidV5(name, namespace) {
-  const namespaceBytes = Buffer.from(namespace.replace(/-/g, ""), "hex");
-  const digest = createHash2("sha1").update(namespaceBytes).update(name, "utf8").digest();
-  const bytes = Buffer.from(digest.subarray(0, 16));
-  bytes[6] = (bytes[6] ?? 0) & 15 | 80;
-  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
-  const hex = bytes.toString("hex");
-  return [
-    hex.slice(0, 8),
-    hex.slice(8, 12),
-    hex.slice(12, 16),
-    hex.slice(16, 20),
-    hex.slice(20)
-  ].join("-");
-}
-__name(uuidV5, "uuidV5");
 function deriveIdempotencyKey(input) {
   const window = Math.floor(input.nowMs / RESEARCH_IDEMPOTENCY_WINDOW_MS);
   const name = `${input.fingerprint}:${input.targetCountry}:${input.categoryKey}:${window}`;
-  return uuidV5(name, NAMESPACE);
+  return deriveUuidV5(name, NAMESPACE);
 }
 __name(deriveIdempotencyKey, "deriveIdempotencyKey");
 

package/package.json

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