@productmaker/mcp 3.4.2 → 3.4.3

package/dist/http.js

@@ -4901,6 +4901,7 @@ var MetaCampaignType = z33.enum([
   "traffic",
   "engagement"
 ]);
+var MetaPublishAttemptId = z33.string().uuid();
 var MetaOptimizationMode = z33.enum([
   "advantage_plus",
   "manual"
@@ -5084,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(),
@@ -5240,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(),
@@ -5309,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",
@@ -5456,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",
@@ -11678,7 +11687,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "3.4.2";
+var MCP_VERSION = "3.4.3";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -12724,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",
@@ -12785,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.",
@@ -12935,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,
@@ -12994,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,
@@ -13082,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) {
@@ -14755,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),
@@ -15082,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);
@@ -15110,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);
@@ -15190,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,
@@ -16077,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.2";
+var MCP_VERSION = "3.4.3";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -5523,6 +5523,7 @@ var MetaCampaignType = z33.enum([
   "traffic",
   "engagement"
 ]);
+var MetaPublishAttemptId = z33.string().uuid();
 var MetaOptimizationMode = z33.enum([
   "advantage_plus",
   "manual"
@@ -5706,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(),
@@ -5862,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(),
@@ -5931,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",
@@ -6078,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",
@@ -11473,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",
@@ -11534,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.",
@@ -11684,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,
@@ -11743,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,
@@ -11831,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) {
@@ -13557,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),
@@ -13884,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);
@@ -13912,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);
@@ -13992,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,
@@ -14879,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.2",
+  "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.",