@productmaker/mcp 0.10.0 → 0.12.0

package/dist/http.js

@@ -391,106 +391,6 @@ __name(sleep, "sleep");
 
 // src/errors.ts
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-var McpErrorCode = {
-  INVALID_API_KEY: "INVALID_API_KEY",
-  REVOKED_API_KEY: "REVOKED_API_KEY",
-  RATE_LIMITED: "RATE_LIMITED",
-  INVALID_INPUT: "INVALID_INPUT",
-  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
-  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
-  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
-  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
-  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
-  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
-  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
-  TASK_NOT_FOUND: "TASK_NOT_FOUND",
-  TASK_NOT_READY: "TASK_NOT_READY",
-  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
-  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
-  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
-  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
-  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
-  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
-  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
-  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
-  INTERNAL: "INTERNAL"
-};
-var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
-  McpErrorCode.INVALID_INPUT,
-  McpErrorCode.INVALID_API_KEY,
-  McpErrorCode.REVOKED_API_KEY,
-  McpErrorCode.IMAGE_PATH_NOT_FOUND,
-  McpErrorCode.IMAGE_PATH_NOT_READABLE,
-  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
-  // The caller passed a campaignId that does not exist — semantically a
-  // bad parameter, not an internal failure. Matches the spec contract
-  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
-  McpErrorCode.CAMPAIGN_NOT_FOUND
-]);
-function mcp(code, message, extra = {}) {
-  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
-  return new McpError(errCode, message, {
-    code,
-    ...extra
-  });
-}
-__name(mcp, "mcp");
-var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
-  "META_CAPABILITY_MISSING",
-  "NO_SHOPIFY_SHOPS",
-  "NO_META_AD_ACCOUNTS",
-  "SHOPIFY_NOT_CONNECTED",
-  "TIKTOK_NOT_CONNECTED",
-  "REVOKED_API_KEY",
-  "CAMPAIGN_NOT_FOUND"
-]);
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-__name(isRecord, "isRecord");
-function translateError(err) {
-  if (err instanceof ResolveImageError) {
-    return mcp(McpErrorCode[err.code], err.message);
-  }
-  if (err instanceof ApiHttpError) {
-    const body = isRecord(err.body) ? err.body : {};
-    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
-      return mcp(body.code, String(body.message ?? body.code), {
-        ...body.helpUrl ? {
-          helpUrl: body.helpUrl
-        } : {}
-      });
-    }
-    if (err.status === 401) {
-      return mcp(McpErrorCode.INVALID_API_KEY, "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.");
-    }
-    if (err.status === 429) {
-      return mcp(McpErrorCode.RATE_LIMITED, "Demasiadas solicitudes. Espera unos segundos.", {
-        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
-      });
-    }
-    if (err.status === 400) {
-      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : "Entrada inv\xE1lida.");
-    }
-    if (err.status === 404) {
-      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
-      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, "Recurso no encontrado.");
-    }
-    if (err.status === 409) {
-      return mcp(McpErrorCode.TASK_NOT_READY, "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n.");
-    }
-    if (err.status >= 500) {
-      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.");
-    }
-    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
-  }
-  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
-    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, "Tiempo de espera agotado.");
-  }
-  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : "Error interno.");
-}
-__name(translateError, "translateError");
 
 // src/tools/shared.ts
 import { z } from "zod";
@@ -682,6 +582,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isRecord, "isRecord");
 function escapeMdLabel(s) {
   return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
 }
@@ -718,6 +622,341 @@ async function submitCreative(api, opts) {
 }
 __name(submitCreative, "submitCreative");
 
+// src/errors.ts
+var McpErrorCode = {
+  // Auth / API key
+  INVALID_API_KEY: "INVALID_API_KEY",
+  REVOKED_API_KEY: "REVOKED_API_KEY",
+  // Rate limit / quota
+  RATE_LIMITED: "RATE_LIMITED",
+  // Input
+  INVALID_INPUT: "INVALID_INPUT",
+  // Image upload (MCP-local)
+  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
+  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
+  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
+  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
+  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
+  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
+  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
+  // Task lifecycle
+  TASK_NOT_FOUND: "TASK_NOT_FOUND",
+  TASK_NOT_READY: "TASK_NOT_READY",
+  // Connection presence
+  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
+  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
+  // Campaigns (shared Meta + TikTok)
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
+  CAMPAIGN_TASK_NOT_FOUND: "CAMPAIGN_TASK_NOT_FOUND",
+  CAMPAIGN_MISSING_LANDING_URL: "CAMPAIGN_MISSING_LANDING_URL",
+  CAMPAIGN_NO_CREATIVES: "CAMPAIGN_NO_CREATIVES",
+  CAMPAIGN_MISSING_THUMBNAILS: "CAMPAIGN_MISSING_THUMBNAILS",
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
+  SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
+  SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  // Meta / Facebook Ads
+  META_NO_FB_PAGE: "META_NO_FB_PAGE",
+  META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
+  META_NO_ASSETS_READY: "META_NO_ASSETS_READY",
+  META_NO_THUMBNAIL_SOURCE: "META_NO_THUMBNAIL_SOURCE",
+  META_NO_LANDING_URL: "META_NO_LANDING_URL",
+  META_TASK_NOT_FOUND: "META_TASK_NOT_FOUND",
+  META_INVALID_DATA: "META_INVALID_DATA",
+  META_INVALID_AD_ACCOUNT: "META_INVALID_AD_ACCOUNT",
+  META_MISSING_PAYMENT: "META_MISSING_PAYMENT",
+  META_TOKEN_EXPIRED: "META_TOKEN_EXPIRED",
+  META_ACCOUNT_RESTRICTED: "META_ACCOUNT_RESTRICTED",
+  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  META_PERMISSION_DENIED: "META_PERMISSION_DENIED",
+  META_PIXEL_NOT_FOUND: "META_PIXEL_NOT_FOUND",
+  META_OBJECT_NOT_FOUND: "META_OBJECT_NOT_FOUND",
+  META_AI_DISCLOSURE_REQUIRED: "META_AI_DISCLOSURE_REQUIRED",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "META_BID_STRATEGY_REQUIRES_AMOUNT",
+  META_CBO_BUDGET_CONFLICT: "META_CBO_BUDGET_CONFLICT",
+  META_BUDGET_MODE_CONFLICT: "META_BUDGET_MODE_CONFLICT",
+  META_AD_SET_BUDGET_REQUIRED: "META_AD_SET_BUDGET_REQUIRED",
+  META_DAILY_BUDGET_TOO_HIGH: "META_DAILY_BUDGET_TOO_HIGH",
+  META_CAMPAIGN_CONFIG_INVALID: "META_CAMPAIGN_CONFIG_INVALID",
+  META_WHATSAPP_DESTINATION_DISABLED: "META_WHATSAPP_DESTINATION_DISABLED",
+  // TikTok Ads
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
+  TIKTOK_TOKEN_EXPIRED: "TIKTOK_TOKEN_EXPIRED",
+  TIKTOK_PERMISSION_DENIED: "TIKTOK_PERMISSION_DENIED",
+  TIKTOK_MISSING_PAYMENT: "TIKTOK_MISSING_PAYMENT",
+  TIKTOK_PIXEL_NOT_FOUND: "TIKTOK_PIXEL_NOT_FOUND",
+  TIKTOK_INVALID_ADVERTISER: "TIKTOK_INVALID_ADVERTISER",
+  TIKTOK_ADVERTISER_REQUIRED: "TIKTOK_ADVERTISER_REQUIRED",
+  TIKTOK_IDENTITY_REQUIRED: "TIKTOK_IDENTITY_REQUIRED",
+  TIKTOK_IDENTITY_API_REQUIRED: "TIKTOK_IDENTITY_API_REQUIRED",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TIKTOK_VIDEO_UPLOAD_FAILED",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "TIKTOK_VIDEO_UPLOAD_TIMEOUT",
+  TIKTOK_RATE_LIMITED: "TIKTOK_RATE_LIMITED",
+  TIKTOK_SERVER_ERROR: "TIKTOK_SERVER_ERROR",
+  TIKTOK_INVALID_DATA: "TIKTOK_INVALID_DATA",
+  // Generic transport / catch-all
+  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
+  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CODE_MESSAGES = {
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "No Shopify store is connected. Connect one at https://productmaker.app/integrations before publishing.",
+  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.",
+  // 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_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.",
+  META_NO_LANDING_URL: "Missing landing URL. Pass it in `landingUrl` or publish to Shopify first with `publish_to_shopify`.",
+  META_TASK_NOT_FOUND: "Task not found or does not belong to this user. Verify the `taskId`.",
+  META_INVALID_DATA: "Meta rejected the request due to invalid data. Verify that `adAccountId` and `pixelId` are correct.",
+  META_INVALID_AD_ACCOUNT: "Ad account not found or no access. Confirm the `adAccountId` with `list_meta_ad_accounts`.",
+  META_MISSING_PAYMENT: "Your Meta Ads account has no payment method configured. Visit https://business.facebook.com/billing_hub/payment_settings, select the ad account, and add a card before retrying.",
+  META_TOKEN_EXPIRED: "Your Meta session expired. Reconnect Facebook at https://productmaker.app/integrations.",
+  META_ACCOUNT_RESTRICTED: "Your Meta Ads account is temporarily restricted from creating ads. Check the notices at https://business.facebook.com and complete the required verification.",
+  META_CAPABILITY_MISSING: "The Facebook app lacks required permissions for this ad account. Reconnect Facebook at https://productmaker.app/integrations and accept ALL requested permissions (including business_management).",
+  META_PERMISSION_DENIED: "The Facebook connection lacks sufficient permissions. Reconnect it at https://productmaker.app/integrations and accept all permissions.",
+  META_PIXEL_NOT_FOUND: "Pixel not found or not associated with the ad account. Verify the `pixelId` at https://business.facebook.com/events_manager.",
+  META_OBJECT_NOT_FOUND: "The requested object (campaign/ad set/ad) does not exist in Meta. Verify the ID or create a new one.",
+  META_AI_DISCLOSURE_REQUIRED: "Meta rejected the ad for undisclosed AI content. The system adds the disclosure automatically; if it persists, edit the copy to avoid language Meta flags as misleading.",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "Meta requires an explicit bid amount for this account/budget. Raise the daily budget or disable account-level bid caps.",
+  META_CBO_BUDGET_CONFLICT: "Budget conflict between campaign (CBO) and ad set. They cannot be mixed.",
+  META_BUDGET_MODE_CONFLICT: "Meta received budget at BOTH campaign and ad set level. Set only one.",
+  META_AD_SET_BUDGET_REQUIRED: "This campaign configuration requires ad-set-level budget, not campaign-level.",
+  META_DAILY_BUDGET_TOO_HIGH: "The daily budget exceeds the maximum allowed by Meta for this account. Lower it and retry.",
+  META_CAMPAIGN_CONFIG_INVALID: "Campaign configuration is invalid. Verify `dailyBudgetUsd`, `targetCountries`, and `campaignName`.",
+  META_WHATSAPP_DESTINATION_DISABLED: "WhatsApp destination is not enabled for this Meta account. Change the ad destination or enable WhatsApp Business on the account.",
+  // TikTok
+  TIKTOK_NOT_CONNECTED: "TikTok Ads is not connected. Connect it at https://productmaker.app/integrations.",
+  TIKTOK_TOKEN_EXPIRED: "The TikTok session expired. Reconnect it at https://productmaker.app/integrations.",
+  TIKTOK_PERMISSION_DENIED: "The TikTok connection lacks sufficient permissions. Reconnect it and accept all requested permissions.",
+  TIKTOK_MISSING_PAYMENT: "Your TikTok Ads account has no payment method configured. Add one at https://ads.tiktok.com.",
+  TIKTOK_PIXEL_NOT_FOUND: "TikTok Pixel not found or not associated with the advertiser. Verify the `pixelId`.",
+  TIKTOK_INVALID_ADVERTISER: "Advertiser not found or no access. Confirm the `advertiserId` with `list_tiktok_advertisers`.",
+  TIKTOK_ADVERTISER_REQUIRED: "Missing `advertiserId`. Obtain one with `list_tiktok_advertisers` before publishing.",
+  TIKTOK_IDENTITY_REQUIRED: "TikTok requires an identity (advertiser profile) to publish. Create one at https://ads.tiktok.com.",
+  TIKTOK_IDENTITY_API_REQUIRED: "TikTok requires the identities API to be enabled on this account. Contact TikTok Ads Support.",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TikTok rejected the video upload. Verify the format is MP4 under 500MB.",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "The video upload to TikTok timed out. Retry in a few minutes.",
+  TIKTOK_RATE_LIMITED: "TikTok rate-limited the request. Wait a few minutes before retrying.",
+  TIKTOK_SERVER_ERROR: "TikTok returned a server error. Retry in a few minutes.",
+  TIKTOK_INVALID_DATA: "TikTok rejected the request due to invalid data. Verify `advertiserId`, `pixelId`, and `campaignConfig`.",
+  // Campaign (shared)
+  CAMPAIGN_NOT_FOUND: "Campaign not found or does not belong to this user. Verify the `campaignId`.",
+  CAMPAIGN_TASK_NOT_FOUND: "Campaign task not found. Verify the `taskId`.",
+  CAMPAIGN_MISSING_LANDING_URL: "Missing landing URL for the campaign. Publish to Shopify first or pass `landingUrl` explicitly.",
+  CAMPAIGN_NO_CREATIVES: "The task has no creatives (video/image) ready for the campaign. Wait for generation to finish.",
+  CAMPAIGN_MISSING_THUMBNAILS: "Missing thumbnails for the videos. Verify that image/video generation has finished.",
+  // Connections
+  NO_SHOPIFY_SHOPS: "No Shopify stores connected. Connect one at https://productmaker.app/integrations.",
+  NO_META_AD_ACCOUNTS: "No Meta Ads accounts connected. Connect Facebook at https://productmaker.app/integrations.",
+  // Task lifecycle
+  TASK_NOT_FOUND: "Task not found or does not belong to this user. Verify the `taskId`.",
+  TASK_NOT_READY: "The task is not ready for this action yet. Wait for it to finish and retry.",
+  // API key
+  INVALID_API_KEY: "Invalid API key. Check your PM_API_KEY in the MCP client configuration.",
+  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.",
+  // Generic
+  UPSTREAM_UNAVAILABLE: "The Product Maker service did not respond. Try again shortly.",
+  UPSTREAM_TIMEOUT: "Request timed out. Retry shortly.",
+  INTERNAL: "Internal error.",
+  INVALID_INPUT: "Invalid input."
+};
+var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
+  // Input/auth
+  McpErrorCode.INVALID_INPUT,
+  McpErrorCode.INVALID_API_KEY,
+  McpErrorCode.REVOKED_API_KEY,
+  McpErrorCode.IMAGE_PATH_NOT_FOUND,
+  McpErrorCode.IMAGE_PATH_NOT_READABLE,
+  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // Identifier mismatches
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.TASK_NOT_FOUND,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  // Validation-shape backend errors (data-level rejection)
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Out-of-band user-resolvable auth/billing/connection — caller fixes by
+  // going to Facebook/TikTok/Shopify and reconnecting, finishing
+  // verification, or adding a payment method. None of these are transient,
+  // so InternalError would mislead the agent into retrying blindly.
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS
+]);
+var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  // Shopify
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  // Meta
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.META_NO_ADS_CREATED,
+  McpErrorCode.META_NO_ASSETS_READY,
+  McpErrorCode.META_NO_THUMBNAIL_SOURCE,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.META_AI_DISCLOSURE_REQUIRED,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_WHATSAPP_DESTINATION_DISABLED,
+  // TikTok
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_FAILED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_TIMEOUT,
+  McpErrorCode.TIKTOK_RATE_LIMITED,
+  McpErrorCode.TIKTOK_SERVER_ERROR,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Campaign (shared)
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.CAMPAIGN_NO_CREATIVES,
+  McpErrorCode.CAMPAIGN_MISSING_THUMBNAILS,
+  // Connections
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS,
+  // Auth
+  McpErrorCode.REVOKED_API_KEY
+]);
+function mcp(code, message, extra = {}) {
+  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
+  return new McpError(errCode, message, {
+    code,
+    ...extra
+  });
+}
+__name(mcp, "mcp");
+var GENERIC_BACKEND_MESSAGES = /* @__PURE__ */ new Set([
+  "No ads could be created for the campaign.",
+  "No assets could be created for the campaign.",
+  "Invalid data provided to Meta API",
+  "Insufficient permissions for Meta account",
+  "Meta session has expired",
+  "Meta Ads account has no payment method configured"
+]);
+function looksLikeMeaningfulBackendMessage(message, mapped) {
+  if (!message || message.length === 0) return false;
+  if (GENERIC_BACKEND_MESSAGES.has(message)) return false;
+  const norm = /* @__PURE__ */ __name((s) => s.toLowerCase().replace(/[.\s]+$/, ""), "norm");
+  if (norm(mapped).includes(norm(message))) return false;
+  return true;
+}
+__name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
+function resolveMessage(code, backendMessage) {
+  const mapped = CODE_MESSAGES[code];
+  const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
+    return `${mapped} (Detail: ${backend})`;
+  }
+  if (mapped) return mapped;
+  if (backend) return backend;
+  return `The service returned an error (code: ${code}). Try again shortly or contact support if it persists.`;
+}
+__name(resolveMessage, "resolveMessage");
+function translateError(err) {
+  if (err instanceof ResolveImageError) {
+    return mcp(McpErrorCode[err.code], err.message);
+  }
+  if (err instanceof ApiHttpError) {
+    const body = isRecord(err.body) ? err.body : {};
+    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
+      const code = body.code;
+      return mcp(code, resolveMessage(code, body.message), {
+        ...body.helpUrl ? {
+          helpUrl: body.helpUrl
+        } : {}
+      });
+    }
+    if (err.status === 401) {
+      return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
+    }
+    if (err.status === 429) {
+      return mcp(McpErrorCode.RATE_LIMITED, resolveMessage(McpErrorCode.RATE_LIMITED, void 0), {
+        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
+      });
+    }
+    if (err.status === 400) {
+      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : resolveMessage(McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 404) {
+      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
+      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, resolveMessage(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 409) {
+      return mcp(McpErrorCode.TASK_NOT_READY, resolveMessage(McpErrorCode.TASK_NOT_READY, void 0));
+    }
+    if (err.status >= 500) {
+      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, resolveMessage(McpErrorCode.UPSTREAM_UNAVAILABLE, void 0));
+    }
+    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
+  }
+  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
+    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, resolveMessage(McpErrorCode.UPSTREAM_TIMEOUT, void 0));
+  }
+  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : resolveMessage(McpErrorCode.INTERNAL, void 0));
+}
+__name(translateError, "translateError");
+
 // src/asset-proxy.ts
 import { createHmac, timingSafeEqual } from "crypto";
 var TOKEN_TTL_SECONDS = 3600;
@@ -1377,7 +1616,11 @@ import { z as z6 } from "zod";
 var ShopifyInput = z6.object({
   taskId: z6.string().min(1),
   shopDomain: z6.string().min(1),
-  numLandingImages: z6.number().int().min(1).max(7).optional(),
+  /** Override: number of landing images to include. Default = ALL images the
+  *  task generated (the MCP fetches /v1/results first to count). Bounded
+  *  generously here; the backend validates each index against
+  *  landing.images.length and rejects out-of-range. */
+  numLandingImages: z6.number().int().min(1).max(20).optional(),
   variantIndex: z6.number().int().min(0).optional(),
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
@@ -1399,7 +1642,11 @@ var MetaInput = z6.object({
   /** Select which angles to publish by 0-based index. Omit to publish all
   *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
   angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
-  campaignConfig: McpCampaignConfig.optional()
+  campaignConfig: McpCampaignConfig.optional(),
+  /** Override the ad's primary text (body copy). If omitted, ProductMaker
+  *  uses the auto-generated copy attached to the task. Capped at 500 chars
+  *  (Meta's primary-text limit). */
+  primaryText: z6.string().trim().min(1).max(500).optional()
 });
 var TikTokInput = z6.object({
   taskId: z6.string().min(1),
@@ -1407,13 +1654,18 @@ var TikTokInput = z6.object({
   pixelId: z6.string().min(1).optional(),
   landingUrl: z6.string().url().optional(),
   angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
-  campaignConfig: McpCampaignConfig.optional()
+  campaignConfig: McpCampaignConfig.optional(),
+  /** Override the ad's description (TikTok's body copy). If omitted,
+  *  ProductMaker uses the auto-generated copy attached to the task. */
+  primaryText: z6.string().trim().min(1).max(500).optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
-      const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
+      const availableImages = await fetchLandingImageCount(api, input.taskId);
+      const effectiveAvailable = availableImages > 0 ? availableImages : 3;
+      const numImages = Math.min(input.numLandingImages ?? effectiveAvailable, effectiveAvailable);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -1430,7 +1682,7 @@ function registerPublishTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -1438,6 +1690,7 @@ function registerPublishTools(server, api) {
       if (campaignConfig) {
         body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
       }
+      if (primaryText) body.primaryText = primaryText;
       const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
@@ -1447,7 +1700,7 @@ function registerPublishTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -1455,6 +1708,7 @@ function registerPublishTools(server, api) {
       if (campaignConfig) {
         body.campaignConfig = toTikTokCampaignConfig(campaignConfig);
       }
+      if (primaryText) body.primaryText = primaryText;
       const r = await api.postJson(`/v1/tiktok/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
@@ -1490,6 +1744,19 @@ function renderShopifyPublishMarkdown(r) {
   };
 }
 __name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+async function fetchLandingImageCount(api, taskId) {
+  try {
+    const r = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}`);
+    if (!isRecord(r)) return 0;
+    const landing = r.landing;
+    if (!isRecord(landing)) return 0;
+    const images = landing.images;
+    return Array.isArray(images) ? images.length : 0;
+  } catch {
+    return 0;
+  }
+}
+__name(fetchLandingImageCount, "fetchLandingImageCount");
 function toMetaCampaignOverrides(cfg) {
   const out = {};
   if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;

package/dist/stdio.js

@@ -388,106 +388,6 @@ __name(sleep, "sleep");
 
 // src/errors.ts
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-var McpErrorCode = {
-  INVALID_API_KEY: "INVALID_API_KEY",
-  REVOKED_API_KEY: "REVOKED_API_KEY",
-  RATE_LIMITED: "RATE_LIMITED",
-  INVALID_INPUT: "INVALID_INPUT",
-  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
-  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
-  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
-  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
-  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
-  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
-  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
-  TASK_NOT_FOUND: "TASK_NOT_FOUND",
-  TASK_NOT_READY: "TASK_NOT_READY",
-  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
-  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
-  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
-  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
-  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
-  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
-  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
-  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
-  INTERNAL: "INTERNAL"
-};
-var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
-  McpErrorCode.INVALID_INPUT,
-  McpErrorCode.INVALID_API_KEY,
-  McpErrorCode.REVOKED_API_KEY,
-  McpErrorCode.IMAGE_PATH_NOT_FOUND,
-  McpErrorCode.IMAGE_PATH_NOT_READABLE,
-  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
-  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
-  // The caller passed a campaignId that does not exist — semantically a
-  // bad parameter, not an internal failure. Matches the spec contract
-  // (mcp-server.spec.ts: "McpError INVALID_PARAMS code=CAMPAIGN_NOT_FOUND").
-  McpErrorCode.CAMPAIGN_NOT_FOUND
-]);
-function mcp(code, message, extra = {}) {
-  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
-  return new McpError(errCode, message, {
-    code,
-    ...extra
-  });
-}
-__name(mcp, "mcp");
-var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
-  "META_CAPABILITY_MISSING",
-  "NO_SHOPIFY_SHOPS",
-  "NO_META_AD_ACCOUNTS",
-  "SHOPIFY_NOT_CONNECTED",
-  "TIKTOK_NOT_CONNECTED",
-  "REVOKED_API_KEY",
-  "CAMPAIGN_NOT_FOUND"
-]);
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-__name(isRecord, "isRecord");
-function translateError(err) {
-  if (err instanceof ResolveImageError) {
-    return mcp(McpErrorCode[err.code], err.message);
-  }
-  if (err instanceof ApiHttpError) {
-    const body = isRecord(err.body) ? err.body : {};
-    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
-      return mcp(body.code, String(body.message ?? body.code), {
-        ...body.helpUrl ? {
-          helpUrl: body.helpUrl
-        } : {}
-      });
-    }
-    if (err.status === 401) {
-      return mcp(McpErrorCode.INVALID_API_KEY, "API key inv\xE1lida. Revisa tu PM_API_KEY en la configuraci\xF3n del cliente MCP.");
-    }
-    if (err.status === 429) {
-      return mcp(McpErrorCode.RATE_LIMITED, "Demasiadas solicitudes. Espera unos segundos.", {
-        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
-      });
-    }
-    if (err.status === 400) {
-      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : "Entrada inv\xE1lida.");
-    }
-    if (err.status === 404) {
-      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
-      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, "Recurso no encontrado.");
-    }
-    if (err.status === 409) {
-      return mcp(McpErrorCode.TASK_NOT_READY, "La tarea a\xFAn no est\xE1 lista para esta acci\xF3n.");
-    }
-    if (err.status >= 500) {
-      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, "El servicio Product Maker no respondi\xF3. Intenta de nuevo en un momento.");
-    }
-    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
-  }
-  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
-    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, "Tiempo de espera agotado.");
-  }
-  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : "Error interno.");
-}
-__name(translateError, "translateError");
 
 // src/tools/shared.ts
 import { z } from "zod";
@@ -679,6 +579,10 @@ function asText(value) {
   };
 }
 __name(asText, "asText");
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isRecord, "isRecord");
 function escapeMdLabel(s) {
   return s.replace(/[\[\]\(\)\{\}`<>\r\n\\*_]/g, " ").replace(/\s+/g, " ").trim();
 }
@@ -715,6 +619,341 @@ async function submitCreative(api, opts) {
 }
 __name(submitCreative, "submitCreative");
 
+// src/errors.ts
+var McpErrorCode = {
+  // Auth / API key
+  INVALID_API_KEY: "INVALID_API_KEY",
+  REVOKED_API_KEY: "REVOKED_API_KEY",
+  // Rate limit / quota
+  RATE_LIMITED: "RATE_LIMITED",
+  // Input
+  INVALID_INPUT: "INVALID_INPUT",
+  // Image upload (MCP-local)
+  IMAGE_DOWNLOAD_FAILED: "IMAGE_DOWNLOAD_FAILED",
+  IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
+  IMAGE_TYPE_UNSUPPORTED: "IMAGE_TYPE_UNSUPPORTED",
+  IMAGE_PATH_NOT_FOUND: "IMAGE_PATH_NOT_FOUND",
+  IMAGE_PATH_NOT_READABLE: "IMAGE_PATH_NOT_READABLE",
+  IMAGE_PATH_NOT_A_FILE: "IMAGE_PATH_NOT_A_FILE",
+  PATH_NOT_SUPPORTED_IN_HTTP_MODE: "PATH_NOT_SUPPORTED_IN_HTTP_MODE",
+  // Task lifecycle
+  TASK_NOT_FOUND: "TASK_NOT_FOUND",
+  TASK_NOT_READY: "TASK_NOT_READY",
+  // Connection presence
+  NO_SHOPIFY_SHOPS: "NO_SHOPIFY_SHOPS",
+  NO_META_AD_ACCOUNTS: "NO_META_AD_ACCOUNTS",
+  // Campaigns (shared Meta + TikTok)
+  CAMPAIGN_NOT_FOUND: "CAMPAIGN_NOT_FOUND",
+  CAMPAIGN_TASK_NOT_FOUND: "CAMPAIGN_TASK_NOT_FOUND",
+  CAMPAIGN_MISSING_LANDING_URL: "CAMPAIGN_MISSING_LANDING_URL",
+  CAMPAIGN_NO_CREATIVES: "CAMPAIGN_NO_CREATIVES",
+  CAMPAIGN_MISSING_THUMBNAILS: "CAMPAIGN_MISSING_THUMBNAILS",
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "SHOPIFY_NOT_CONNECTED",
+  SHOPIFY_TOKEN_EXPIRED: "SHOPIFY_TOKEN_EXPIRED",
+  SHOPIFY_SCOPE_UPGRADE_REQUIRED: "SHOPIFY_SCOPE_UPGRADE_REQUIRED",
+  SHOPIFY_PUBLISH_FAILED: "SHOPIFY_PUBLISH_FAILED",
+  // Meta / Facebook Ads
+  META_NO_FB_PAGE: "META_NO_FB_PAGE",
+  META_NO_ADS_CREATED: "META_NO_ADS_CREATED",
+  META_NO_ASSETS_READY: "META_NO_ASSETS_READY",
+  META_NO_THUMBNAIL_SOURCE: "META_NO_THUMBNAIL_SOURCE",
+  META_NO_LANDING_URL: "META_NO_LANDING_URL",
+  META_TASK_NOT_FOUND: "META_TASK_NOT_FOUND",
+  META_INVALID_DATA: "META_INVALID_DATA",
+  META_INVALID_AD_ACCOUNT: "META_INVALID_AD_ACCOUNT",
+  META_MISSING_PAYMENT: "META_MISSING_PAYMENT",
+  META_TOKEN_EXPIRED: "META_TOKEN_EXPIRED",
+  META_ACCOUNT_RESTRICTED: "META_ACCOUNT_RESTRICTED",
+  META_CAPABILITY_MISSING: "META_CAPABILITY_MISSING",
+  META_PERMISSION_DENIED: "META_PERMISSION_DENIED",
+  META_PIXEL_NOT_FOUND: "META_PIXEL_NOT_FOUND",
+  META_OBJECT_NOT_FOUND: "META_OBJECT_NOT_FOUND",
+  META_AI_DISCLOSURE_REQUIRED: "META_AI_DISCLOSURE_REQUIRED",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "META_BID_STRATEGY_REQUIRES_AMOUNT",
+  META_CBO_BUDGET_CONFLICT: "META_CBO_BUDGET_CONFLICT",
+  META_BUDGET_MODE_CONFLICT: "META_BUDGET_MODE_CONFLICT",
+  META_AD_SET_BUDGET_REQUIRED: "META_AD_SET_BUDGET_REQUIRED",
+  META_DAILY_BUDGET_TOO_HIGH: "META_DAILY_BUDGET_TOO_HIGH",
+  META_CAMPAIGN_CONFIG_INVALID: "META_CAMPAIGN_CONFIG_INVALID",
+  META_WHATSAPP_DESTINATION_DISABLED: "META_WHATSAPP_DESTINATION_DISABLED",
+  // TikTok Ads
+  TIKTOK_NOT_CONNECTED: "TIKTOK_NOT_CONNECTED",
+  TIKTOK_TOKEN_EXPIRED: "TIKTOK_TOKEN_EXPIRED",
+  TIKTOK_PERMISSION_DENIED: "TIKTOK_PERMISSION_DENIED",
+  TIKTOK_MISSING_PAYMENT: "TIKTOK_MISSING_PAYMENT",
+  TIKTOK_PIXEL_NOT_FOUND: "TIKTOK_PIXEL_NOT_FOUND",
+  TIKTOK_INVALID_ADVERTISER: "TIKTOK_INVALID_ADVERTISER",
+  TIKTOK_ADVERTISER_REQUIRED: "TIKTOK_ADVERTISER_REQUIRED",
+  TIKTOK_IDENTITY_REQUIRED: "TIKTOK_IDENTITY_REQUIRED",
+  TIKTOK_IDENTITY_API_REQUIRED: "TIKTOK_IDENTITY_API_REQUIRED",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TIKTOK_VIDEO_UPLOAD_FAILED",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "TIKTOK_VIDEO_UPLOAD_TIMEOUT",
+  TIKTOK_RATE_LIMITED: "TIKTOK_RATE_LIMITED",
+  TIKTOK_SERVER_ERROR: "TIKTOK_SERVER_ERROR",
+  TIKTOK_INVALID_DATA: "TIKTOK_INVALID_DATA",
+  // Generic transport / catch-all
+  UPSTREAM_TIMEOUT: "UPSTREAM_TIMEOUT",
+  UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE",
+  INTERNAL: "INTERNAL"
+};
+var CODE_MESSAGES = {
+  // Shopify
+  SHOPIFY_NOT_CONNECTED: "No Shopify store is connected. Connect one at https://productmaker.app/integrations before publishing.",
+  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.",
+  // 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_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.",
+  META_NO_LANDING_URL: "Missing landing URL. Pass it in `landingUrl` or publish to Shopify first with `publish_to_shopify`.",
+  META_TASK_NOT_FOUND: "Task not found or does not belong to this user. Verify the `taskId`.",
+  META_INVALID_DATA: "Meta rejected the request due to invalid data. Verify that `adAccountId` and `pixelId` are correct.",
+  META_INVALID_AD_ACCOUNT: "Ad account not found or no access. Confirm the `adAccountId` with `list_meta_ad_accounts`.",
+  META_MISSING_PAYMENT: "Your Meta Ads account has no payment method configured. Visit https://business.facebook.com/billing_hub/payment_settings, select the ad account, and add a card before retrying.",
+  META_TOKEN_EXPIRED: "Your Meta session expired. Reconnect Facebook at https://productmaker.app/integrations.",
+  META_ACCOUNT_RESTRICTED: "Your Meta Ads account is temporarily restricted from creating ads. Check the notices at https://business.facebook.com and complete the required verification.",
+  META_CAPABILITY_MISSING: "The Facebook app lacks required permissions for this ad account. Reconnect Facebook at https://productmaker.app/integrations and accept ALL requested permissions (including business_management).",
+  META_PERMISSION_DENIED: "The Facebook connection lacks sufficient permissions. Reconnect it at https://productmaker.app/integrations and accept all permissions.",
+  META_PIXEL_NOT_FOUND: "Pixel not found or not associated with the ad account. Verify the `pixelId` at https://business.facebook.com/events_manager.",
+  META_OBJECT_NOT_FOUND: "The requested object (campaign/ad set/ad) does not exist in Meta. Verify the ID or create a new one.",
+  META_AI_DISCLOSURE_REQUIRED: "Meta rejected the ad for undisclosed AI content. The system adds the disclosure automatically; if it persists, edit the copy to avoid language Meta flags as misleading.",
+  META_BID_STRATEGY_REQUIRES_AMOUNT: "Meta requires an explicit bid amount for this account/budget. Raise the daily budget or disable account-level bid caps.",
+  META_CBO_BUDGET_CONFLICT: "Budget conflict between campaign (CBO) and ad set. They cannot be mixed.",
+  META_BUDGET_MODE_CONFLICT: "Meta received budget at BOTH campaign and ad set level. Set only one.",
+  META_AD_SET_BUDGET_REQUIRED: "This campaign configuration requires ad-set-level budget, not campaign-level.",
+  META_DAILY_BUDGET_TOO_HIGH: "The daily budget exceeds the maximum allowed by Meta for this account. Lower it and retry.",
+  META_CAMPAIGN_CONFIG_INVALID: "Campaign configuration is invalid. Verify `dailyBudgetUsd`, `targetCountries`, and `campaignName`.",
+  META_WHATSAPP_DESTINATION_DISABLED: "WhatsApp destination is not enabled for this Meta account. Change the ad destination or enable WhatsApp Business on the account.",
+  // TikTok
+  TIKTOK_NOT_CONNECTED: "TikTok Ads is not connected. Connect it at https://productmaker.app/integrations.",
+  TIKTOK_TOKEN_EXPIRED: "The TikTok session expired. Reconnect it at https://productmaker.app/integrations.",
+  TIKTOK_PERMISSION_DENIED: "The TikTok connection lacks sufficient permissions. Reconnect it and accept all requested permissions.",
+  TIKTOK_MISSING_PAYMENT: "Your TikTok Ads account has no payment method configured. Add one at https://ads.tiktok.com.",
+  TIKTOK_PIXEL_NOT_FOUND: "TikTok Pixel not found or not associated with the advertiser. Verify the `pixelId`.",
+  TIKTOK_INVALID_ADVERTISER: "Advertiser not found or no access. Confirm the `advertiserId` with `list_tiktok_advertisers`.",
+  TIKTOK_ADVERTISER_REQUIRED: "Missing `advertiserId`. Obtain one with `list_tiktok_advertisers` before publishing.",
+  TIKTOK_IDENTITY_REQUIRED: "TikTok requires an identity (advertiser profile) to publish. Create one at https://ads.tiktok.com.",
+  TIKTOK_IDENTITY_API_REQUIRED: "TikTok requires the identities API to be enabled on this account. Contact TikTok Ads Support.",
+  TIKTOK_VIDEO_UPLOAD_FAILED: "TikTok rejected the video upload. Verify the format is MP4 under 500MB.",
+  TIKTOK_VIDEO_UPLOAD_TIMEOUT: "The video upload to TikTok timed out. Retry in a few minutes.",
+  TIKTOK_RATE_LIMITED: "TikTok rate-limited the request. Wait a few minutes before retrying.",
+  TIKTOK_SERVER_ERROR: "TikTok returned a server error. Retry in a few minutes.",
+  TIKTOK_INVALID_DATA: "TikTok rejected the request due to invalid data. Verify `advertiserId`, `pixelId`, and `campaignConfig`.",
+  // Campaign (shared)
+  CAMPAIGN_NOT_FOUND: "Campaign not found or does not belong to this user. Verify the `campaignId`.",
+  CAMPAIGN_TASK_NOT_FOUND: "Campaign task not found. Verify the `taskId`.",
+  CAMPAIGN_MISSING_LANDING_URL: "Missing landing URL for the campaign. Publish to Shopify first or pass `landingUrl` explicitly.",
+  CAMPAIGN_NO_CREATIVES: "The task has no creatives (video/image) ready for the campaign. Wait for generation to finish.",
+  CAMPAIGN_MISSING_THUMBNAILS: "Missing thumbnails for the videos. Verify that image/video generation has finished.",
+  // Connections
+  NO_SHOPIFY_SHOPS: "No Shopify stores connected. Connect one at https://productmaker.app/integrations.",
+  NO_META_AD_ACCOUNTS: "No Meta Ads accounts connected. Connect Facebook at https://productmaker.app/integrations.",
+  // Task lifecycle
+  TASK_NOT_FOUND: "Task not found or does not belong to this user. Verify the `taskId`.",
+  TASK_NOT_READY: "The task is not ready for this action yet. Wait for it to finish and retry.",
+  // API key
+  INVALID_API_KEY: "Invalid API key. Check your PM_API_KEY in the MCP client configuration.",
+  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.",
+  // Generic
+  UPSTREAM_UNAVAILABLE: "The Product Maker service did not respond. Try again shortly.",
+  UPSTREAM_TIMEOUT: "Request timed out. Retry shortly.",
+  INTERNAL: "Internal error.",
+  INVALID_INPUT: "Invalid input."
+};
+var INVALID_PARAM_CODES = /* @__PURE__ */ new Set([
+  // Input/auth
+  McpErrorCode.INVALID_INPUT,
+  McpErrorCode.INVALID_API_KEY,
+  McpErrorCode.REVOKED_API_KEY,
+  McpErrorCode.IMAGE_PATH_NOT_FOUND,
+  McpErrorCode.IMAGE_PATH_NOT_READABLE,
+  McpErrorCode.IMAGE_PATH_NOT_A_FILE,
+  McpErrorCode.PATH_NOT_SUPPORTED_IN_HTTP_MODE,
+  // Identifier mismatches
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.TASK_NOT_FOUND,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  // Validation-shape backend errors (data-level rejection)
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Out-of-band user-resolvable auth/billing/connection — caller fixes by
+  // going to Facebook/TikTok/Shopify and reconnecting, finishing
+  // verification, or adding a payment method. None of these are transient,
+  // so InternalError would mislead the agent into retrying blindly.
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS
+]);
+var PASSTHROUGH_CODES = /* @__PURE__ */ new Set([
+  // Shopify
+  McpErrorCode.SHOPIFY_NOT_CONNECTED,
+  McpErrorCode.SHOPIFY_TOKEN_EXPIRED,
+  McpErrorCode.SHOPIFY_SCOPE_UPGRADE_REQUIRED,
+  McpErrorCode.SHOPIFY_PUBLISH_FAILED,
+  // Meta
+  McpErrorCode.META_NO_FB_PAGE,
+  McpErrorCode.META_NO_ADS_CREATED,
+  McpErrorCode.META_NO_ASSETS_READY,
+  McpErrorCode.META_NO_THUMBNAIL_SOURCE,
+  McpErrorCode.META_NO_LANDING_URL,
+  McpErrorCode.META_TASK_NOT_FOUND,
+  McpErrorCode.META_INVALID_DATA,
+  McpErrorCode.META_INVALID_AD_ACCOUNT,
+  McpErrorCode.META_MISSING_PAYMENT,
+  McpErrorCode.META_TOKEN_EXPIRED,
+  McpErrorCode.META_ACCOUNT_RESTRICTED,
+  McpErrorCode.META_CAPABILITY_MISSING,
+  McpErrorCode.META_PERMISSION_DENIED,
+  McpErrorCode.META_PIXEL_NOT_FOUND,
+  McpErrorCode.META_OBJECT_NOT_FOUND,
+  McpErrorCode.META_AI_DISCLOSURE_REQUIRED,
+  McpErrorCode.META_BID_STRATEGY_REQUIRES_AMOUNT,
+  McpErrorCode.META_CBO_BUDGET_CONFLICT,
+  McpErrorCode.META_BUDGET_MODE_CONFLICT,
+  McpErrorCode.META_AD_SET_BUDGET_REQUIRED,
+  McpErrorCode.META_DAILY_BUDGET_TOO_HIGH,
+  McpErrorCode.META_CAMPAIGN_CONFIG_INVALID,
+  McpErrorCode.META_WHATSAPP_DESTINATION_DISABLED,
+  // TikTok
+  McpErrorCode.TIKTOK_NOT_CONNECTED,
+  McpErrorCode.TIKTOK_TOKEN_EXPIRED,
+  McpErrorCode.TIKTOK_PERMISSION_DENIED,
+  McpErrorCode.TIKTOK_MISSING_PAYMENT,
+  McpErrorCode.TIKTOK_PIXEL_NOT_FOUND,
+  McpErrorCode.TIKTOK_INVALID_ADVERTISER,
+  McpErrorCode.TIKTOK_ADVERTISER_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_REQUIRED,
+  McpErrorCode.TIKTOK_IDENTITY_API_REQUIRED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_FAILED,
+  McpErrorCode.TIKTOK_VIDEO_UPLOAD_TIMEOUT,
+  McpErrorCode.TIKTOK_RATE_LIMITED,
+  McpErrorCode.TIKTOK_SERVER_ERROR,
+  McpErrorCode.TIKTOK_INVALID_DATA,
+  // Campaign (shared)
+  McpErrorCode.CAMPAIGN_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_TASK_NOT_FOUND,
+  McpErrorCode.CAMPAIGN_MISSING_LANDING_URL,
+  McpErrorCode.CAMPAIGN_NO_CREATIVES,
+  McpErrorCode.CAMPAIGN_MISSING_THUMBNAILS,
+  // Connections
+  McpErrorCode.NO_SHOPIFY_SHOPS,
+  McpErrorCode.NO_META_AD_ACCOUNTS,
+  // Auth
+  McpErrorCode.REVOKED_API_KEY
+]);
+function mcp(code, message, extra = {}) {
+  const errCode = INVALID_PARAM_CODES.has(code) ? ErrorCode.InvalidParams : ErrorCode.InternalError;
+  return new McpError(errCode, message, {
+    code,
+    ...extra
+  });
+}
+__name(mcp, "mcp");
+var GENERIC_BACKEND_MESSAGES = /* @__PURE__ */ new Set([
+  "No ads could be created for the campaign.",
+  "No assets could be created for the campaign.",
+  "Invalid data provided to Meta API",
+  "Insufficient permissions for Meta account",
+  "Meta session has expired",
+  "Meta Ads account has no payment method configured"
+]);
+function looksLikeMeaningfulBackendMessage(message, mapped) {
+  if (!message || message.length === 0) return false;
+  if (GENERIC_BACKEND_MESSAGES.has(message)) return false;
+  const norm = /* @__PURE__ */ __name((s) => s.toLowerCase().replace(/[.\s]+$/, ""), "norm");
+  if (norm(mapped).includes(norm(message))) return false;
+  return true;
+}
+__name(looksLikeMeaningfulBackendMessage, "looksLikeMeaningfulBackendMessage");
+function resolveMessage(code, backendMessage) {
+  const mapped = CODE_MESSAGES[code];
+  const backend = typeof backendMessage === "string" ? backendMessage.trim() : "";
+  if (mapped && backend && looksLikeMeaningfulBackendMessage(backend, mapped)) {
+    return `${mapped} (Detail: ${backend})`;
+  }
+  if (mapped) return mapped;
+  if (backend) return backend;
+  return `The service returned an error (code: ${code}). Try again shortly or contact support if it persists.`;
+}
+__name(resolveMessage, "resolveMessage");
+function translateError(err) {
+  if (err instanceof ResolveImageError) {
+    return mcp(McpErrorCode[err.code], err.message);
+  }
+  if (err instanceof ApiHttpError) {
+    const body = isRecord(err.body) ? err.body : {};
+    if (typeof body.code === "string" && PASSTHROUGH_CODES.has(body.code)) {
+      const code = body.code;
+      return mcp(code, resolveMessage(code, body.message), {
+        ...body.helpUrl ? {
+          helpUrl: body.helpUrl
+        } : {}
+      });
+    }
+    if (err.status === 401) {
+      return mcp(McpErrorCode.INVALID_API_KEY, resolveMessage(McpErrorCode.INVALID_API_KEY, void 0));
+    }
+    if (err.status === 429) {
+      return mcp(McpErrorCode.RATE_LIMITED, resolveMessage(McpErrorCode.RATE_LIMITED, void 0), {
+        retryAfterSeconds: Number(body.retryAfterSeconds ?? 30)
+      });
+    }
+    if (err.status === 400) {
+      return mcp(McpErrorCode.INVALID_INPUT, typeof body.message === "string" ? body.message : resolveMessage(McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 404) {
+      const isTask = body.resource === "task" || /task/i.test(String(body.message ?? ""));
+      return mcp(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, resolveMessage(isTask ? McpErrorCode.TASK_NOT_FOUND : McpErrorCode.INVALID_INPUT, void 0));
+    }
+    if (err.status === 409) {
+      return mcp(McpErrorCode.TASK_NOT_READY, resolveMessage(McpErrorCode.TASK_NOT_READY, void 0));
+    }
+    if (err.status >= 500) {
+      return mcp(McpErrorCode.UPSTREAM_UNAVAILABLE, resolveMessage(McpErrorCode.UPSTREAM_UNAVAILABLE, void 0));
+    }
+    return mcp(McpErrorCode.INTERNAL, `HTTP ${err.status}`);
+  }
+  if (err instanceof Error && /aborted|timeout/i.test(err.message)) {
+    return mcp(McpErrorCode.UPSTREAM_TIMEOUT, resolveMessage(McpErrorCode.UPSTREAM_TIMEOUT, void 0));
+  }
+  return mcp(McpErrorCode.INTERNAL, err instanceof Error ? err.message : resolveMessage(McpErrorCode.INTERNAL, void 0));
+}
+__name(translateError, "translateError");
+
 // src/asset-proxy.ts
 import { createHmac, timingSafeEqual } from "crypto";
 var TOKEN_TTL_SECONDS = 3600;
@@ -1333,7 +1572,11 @@ import { z as z6 } from "zod";
 var ShopifyInput = z6.object({
   taskId: z6.string().min(1),
   shopDomain: z6.string().min(1),
-  numLandingImages: z6.number().int().min(1).max(7).optional(),
+  /** Override: number of landing images to include. Default = ALL images the
+  *  task generated (the MCP fetches /v1/results first to count). Bounded
+  *  generously here; the backend validates each index against
+  *  landing.images.length and rejects out-of-range. */
+  numLandingImages: z6.number().int().min(1).max(20).optional(),
   variantIndex: z6.number().int().min(0).optional(),
   /** ASK THE USER before setting: "¿Tu producto tiene variantes (talla, color, etc.)?".
   *  When true, the landing renders variant-picker pills; when false, it ships
@@ -1355,7 +1598,11 @@ var MetaInput = z6.object({
   /** Select which angles to publish by 0-based index. Omit to publish all
   *  successful angles. Example: a task with 3 angles → `[0,2]` publishes #0 + #2. */
   angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
-  campaignConfig: McpCampaignConfig.optional()
+  campaignConfig: McpCampaignConfig.optional(),
+  /** Override the ad's primary text (body copy). If omitted, ProductMaker
+  *  uses the auto-generated copy attached to the task. Capped at 500 chars
+  *  (Meta's primary-text limit). */
+  primaryText: z6.string().trim().min(1).max(500).optional()
 });
 var TikTokInput = z6.object({
   taskId: z6.string().min(1),
@@ -1363,13 +1610,18 @@ var TikTokInput = z6.object({
   pixelId: z6.string().min(1).optional(),
   landingUrl: z6.string().url().optional(),
   angleIndexes: z6.array(z6.number().int().nonnegative()).optional(),
-  campaignConfig: McpCampaignConfig.optional()
+  campaignConfig: McpCampaignConfig.optional(),
+  /** Override the ad's description (TikTok's body copy). If omitted,
+  *  ProductMaker uses the auto-generated copy attached to the task. */
+  primaryText: z6.string().trim().min(1).max(500).optional()
 });
 function registerPublishTools(server, api) {
-  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto incluye 3 im\xE1genes del hero. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
+  server.tool("publish_to_shopify", "Publica la landing y producto generados en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. ANTES de llamar preg\xFAntale al usuario \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED \u2014 eso renderiza los pills de variantes en la landing. Por defecto publica TODAS las im\xE1genes que la tarea gener\xF3 para la landing; pasa `numLandingImages` s\xF3lo si el usuario te pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, async (input) => {
     try {
-      const numImages = input.numLandingImages ?? 3;
       const variantIndex = input.variantIndex ?? 0;
+      const availableImages = await fetchLandingImageCount(api, input.taskId);
+      const effectiveAvailable = availableImages > 0 ? availableImages : 3;
+      const numImages = Math.min(input.numLandingImages ?? effectiveAvailable, effectiveAvailable);
       const selectedLandingImages = Array.from({
         length: numImages
       }, (_, i) => ({
@@ -1386,7 +1638,7 @@ function registerPublishTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+  server.tool("publish_to_meta", "Crea una campa\xF1a de Meta Ads (Facebook/Instagram) desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en Meta Ads Manager. Use `list_meta_ad_accounts` antes para un adAccountId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 si la tarea gener\xF3 3 \xE1ngulos y el usuario solo quiere los #0 y #2, pasa [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, m\xE1x 1 para Meta), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_meta_campaign_status` para chequear el estado.", MetaInput.shape, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -1394,6 +1646,7 @@ function registerPublishTools(server, api) {
       if (campaignConfig) {
         body.campaignOverrides = toMetaCampaignOverrides(campaignConfig);
       }
+      if (primaryText) body.primaryText = primaryText;
       const r = await api.postJson(`/v1/facebook/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
@@ -1403,7 +1656,7 @@ function registerPublishTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, ...rest }) => {
+  server.tool("publish_to_tiktok", "Crea una campa\xF1a de TikTok Ads desde la tarea. La campa\xF1a se crea SIEMPRE en estado PAUSED \u2014 el usuario la activa manualmente en TikTok Ads Manager. Use `list_tiktok_advertisers` antes para un advertiserId v\xE1lido. `pixelId` opcional pero recomendado para tracking. `angleIndexes` (opcional): selecciona qu\xE9 \xE1ngulos publicar \u2014 ej. [0,2]; omitir = publicar todos. `campaignConfig` (opcional): `dailyBudgetUsd` (presupuesto diario en USD, ej. 25), `targetCountries` (c\xF3digos ISO-2, primero se usa), `campaignName` (m\xE1x 100 chars). `primaryText` (opcional, m\xE1x 500 chars): override del copy del anuncio \u2014 solo \xFAsalo si el usuario te pas\xF3 un texto espec\xEDfico; si no, ProductMaker usa el copy auto-generado de la tarea. Despu\xE9s de publicar usa `get_tiktok_campaign_status` para chequear el estado.", TikTokInput.shape, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -1411,6 +1664,7 @@ function registerPublishTools(server, api) {
       if (campaignConfig) {
         body.campaignConfig = toTikTokCampaignConfig(campaignConfig);
       }
+      if (primaryText) body.primaryText = primaryText;
       const r = await api.postJson(`/v1/tiktok/campaigns/from-task/${encodeURIComponent(taskId)}`, body);
       return asText({
         ...r,
@@ -1446,6 +1700,19 @@ function renderShopifyPublishMarkdown(r) {
   };
 }
 __name(renderShopifyPublishMarkdown, "renderShopifyPublishMarkdown");
+async function fetchLandingImageCount(api, taskId) {
+  try {
+    const r = await api.getJson(`/v1/results/${encodeURIComponent(taskId)}`);
+    if (!isRecord(r)) return 0;
+    const landing = r.landing;
+    if (!isRecord(landing)) return 0;
+    const images = landing.images;
+    return Array.isArray(images) ? images.length : 0;
+  } catch {
+    return 0;
+  }
+}
+__name(fetchLandingImageCount, "fetchLandingImageCount");
 function toMetaCampaignOverrides(cfg) {
   const out = {};
   if (cfg.dailyBudgetUsd !== void 0) out.dailyBudgetUsd = cfg.dailyBudgetUsd;

package/package.json

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