@productmaker/mcp 6.0.0 → 6.1.1

package/dist/stdio.js

@@ -264,7 +264,7 @@ var ApiClient = class {
 };
 
 // src/index.ts
-var MCP_VERSION = "6.0.0";
+var MCP_VERSION = "6.1.1";
 
 // src/meta-upload-app.ts
 import { readFileSync } from "fs";
@@ -335,630 +335,339 @@ function registerMediaUploadAppResource(server, resolveEndpoint) {
 }
 __name(registerMediaUploadAppResource, "registerMediaUploadAppResource");
 
-// src/tools/tasks.ts
-import { z as z51 } from "zod";
+// ../../packages/types/src/video-enums.ts
+import { z } from "zod";
+var VideoFormat = z.enum([
+  "single_8s",
+  "single_15s",
+  "double_30s"
+]);
+var VideoStyle = z.enum([
+  "ugc",
+  "cartoon_3d",
+  "product_only",
+  "ai_dynamic"
+]);
+var VideoModel = z.enum([
+  "veo",
+  "wan",
+  "bytedance",
+  "seedance",
+  "grok",
+  "kling"
+]);
+var NarrativeStyle = z.enum([
+  "review",
+  "ugc_how_to",
+  "problem_product_cta",
+  "product_showcase",
+  "cinematic",
+  "wild_card",
+  "metaphor_product_cta",
+  "wearable_showcase",
+  "animated_problem_pixar",
+  "sassy_product_pixar",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review",
+  "gap_replication"
+]);
+var VideoResolution = z.enum([
+  "480p",
+  "720p"
+]);
+var VideoPreset = z.enum([
+  "auto",
+  "ugc_dynamic",
+  "ugc_how_to",
+  "problem_solution",
+  "product_showcase",
+  "cinematic",
+  "wild_card",
+  "wearable_showcase",
+  "pixar_problem",
+  "pixar_sassy",
+  "ugc_unboxing_chaos",
+  "ugc_curiosity_reveal",
+  "ugc_listicle_3",
+  "ugc_skeptic_confession",
+  "ugc_demo_review",
+  "metaphor_product"
+]);
+var VoiceId = z.string();
+var _VIDEO_MODEL_SET = new Set(VideoModel.options);
 
-// src/resolve-image.ts
-import { lookup as dnsLookup } from "dns/promises";
-import { promises as fs, createReadStream } from "fs";
-import * as path from "path";
-import * as os from "os";
-var MAX_BYTES = 20 * 1024 * 1024;
-var IMAGE_FORMATS = [
-  {
-    mime: "image/jpeg",
-    exts: [
-      ".jpg",
-      ".jpeg"
-    ]
-  },
-  {
-    mime: "image/png",
-    exts: [
-      ".png"
-    ]
-  },
-  {
-    mime: "image/webp",
-    exts: [
-      ".webp"
-    ]
-  }
-];
-var ALLOWED_MIMES = new Set(IMAGE_FORMATS.map((f) => f.mime));
-var ALLOWED_EXTS = new Set(IMAGE_FORMATS.flatMap((f) => f.exts));
-var ResolveImageError = class extends Error {
-  static {
-    __name(this, "ResolveImageError");
-  }
-  code;
-  constructor(code, message) {
-    super(message), this.code = code;
-    this.name = "ResolveImageError";
-  }
-};
-function sniffMime(buf) {
-  if (buf.length < 4) return null;
-  if (buf.readUInt8(0) === 137 && buf.readUInt8(1) === 80 && buf.readUInt8(2) === 78 && buf.readUInt8(3) === 71) return "image/png";
-  if (buf.readUInt8(0) === 255 && buf.readUInt8(1) === 216 && buf.readUInt8(2) === 255) return "image/jpeg";
-  if (buf.length < 12) return null;
-  if (buf.readUInt8(0) === 82 && buf.readUInt8(1) === 73 && buf.readUInt8(2) === 70 && buf.readUInt8(3) === 70 && buf.readUInt8(8) === 87 && buf.readUInt8(9) === 69 && buf.readUInt8(10) === 66 && buf.readUInt8(11) === 80) return "image/webp";
-  return null;
-}
-__name(sniffMime, "sniffMime");
-function isPrivateHost(host) {
-  if (host === "localhost" || host === "0.0.0.0") return true;
-  if (host === "metadata.google.internal" || host === "169.254.169.254") return true;
-  if (/^127\./.test(host)) return true;
-  if (/^10\./.test(host)) return true;
-  if (/^192\.168\./.test(host)) return true;
-  if (/^172\.(1[6-9]|2\d|3[0-1])\./.test(host)) return true;
-  if (host.startsWith("169.254.")) return true;
-  if (host === "[::1]" || host === "::1") return true;
-  if (/^\[?0*:(?:0*:){6}0*1\]?$/i.test(host)) return true;
-  const ipv4Mapped = host.match(/^\[?::ffff:([0-9a-f.:]+)\]?$/i);
-  if (ipv4Mapped && ipv4Mapped[1]) {
-    const inner = ipv4Mapped[1];
-    if (inner.includes(".")) return isPrivateHost(inner);
-    const parts = inner.split(":").map((h) => parseInt(h, 16));
-    if (parts.length === 2 && parts.every((n) => !Number.isNaN(n))) {
-      const bytes = [
-        parts[0] >> 8,
-        parts[0] & 255,
-        parts[1] >> 8,
-        parts[1] & 255
-      ];
-      return isPrivateHost(bytes.join("."));
+// ../../packages/types/src/task.ts
+import { z as z2 } from "zod";
+var TaskStage = z2.enum([
+  "extract",
+  "angles",
+  "video_generator",
+  "creative",
+  "landing"
+]);
+var TaskStageStatus = z2.enum([
+  "pending",
+  "success",
+  "error"
+]);
+var StageStatusSnapshot = z2.object({
+  extract: TaskStageStatus,
+  angles: TaskStageStatus,
+  video_generator: TaskStageStatus,
+  creative: TaskStageStatus,
+  landing: TaskStageStatus
+});
+var TaskKind = z2.enum([
+  "autopilot",
+  "image",
+  "video",
+  "landing",
+  "mix",
+  "service"
+]);
+
+// ../../packages/types/src/product.ts
+import { z as z4 } from "zod";
+
+// ../../packages/types/src/product-reference-set.ts
+import { z as z3 } from "zod";
+var ProductReferenceScopeSchema = z3.enum([
+  "base",
+  "video_view_pack"
+]);
+var SaleConfigurationSchema = z3.object({
+  quantity: z3.number().int().positive(),
+  variantSelections: z3.array(z3.object({
+    axisKey: z3.string().min(1).max(120),
+    valueKey: z3.string().min(1).max(120)
+  })).superRefine((selections, context) => {
+    const axes = selections.map((selection) => selection.axisKey);
+    if (new Set(axes).size !== axes.length) {
+      context.addIssue({
+        code: z3.ZodIssueCode.custom,
+        message: "variant_axes_must_be_unique"
+      });
     }
-  }
-  if (/^\[?f[cd][0-9a-f]{2}:/i.test(host)) return true;
-  if (/^\[?fe[89ab][0-9a-f]:/i.test(host)) return true;
-  return false;
-}
-__name(isPrivateHost, "isPrivateHost");
-async function assertHostResolvesPublic(hostname) {
-  let records;
-  try {
-    records = await dnsLookup(hostname, {
-      all: true
+  })
+});
+var SaleItemSchema = z3.object({
+  productKey: z3.string().min(1).max(120),
+  configurations: z3.array(SaleConfigurationSchema).min(1),
+  includedComponentKeys: z3.array(z3.string().min(1).max(120)).superRefine((keys, context) => {
+    if (new Set(keys).size !== keys.length) {
+      context.addIssue({
+        code: z3.ZodIssueCode.custom,
+        message: "included_components_must_be_unique"
+      });
+    }
+  })
+});
+var SaleStructureDecisionSchema = z3.object({
+  kind: z3.enum([
+    "single_product",
+    "distinct_product_combo",
+    "select_single_product"
+  ]),
+  items: z3.array(SaleItemSchema).min(1)
+}).superRefine((value, context) => {
+  const productKeys = new Set(value.items.map((item) => item.productKey));
+  if (value.kind !== "distinct_product_combo" && value.items.length !== 1) {
+    context.addIssue({
+      code: z3.ZodIssueCode.custom,
+      path: [
+        "items"
+      ],
+      message: "single_product_decision_requires_one_item"
     });
-  } catch {
-    if (process.env.NODE_ENV === "test" || process.env.VITEST) return;
-    throw new ResolveImageError("INVALID_INPUT", `imageUrl DNS lookup failed for ${hostname}`);
   }
-  for (const { address } of records) {
-    if (isPrivateHost(address)) {
-      throw new ResolveImageError("INVALID_INPUT", `imageUrl host resolves to a private address (${address})`);
-    }
+  if (value.kind === "distinct_product_combo" && productKeys.size < 2) {
+    context.addIssue({
+      code: z3.ZodIssueCode.custom,
+      path: [
+        "items"
+      ],
+      message: "combo_requires_distinct_products"
+    });
   }
-}
-__name(assertHostResolvesPublic, "assertHostResolvesPublic");
-function expandUserPath(raw) {
-  let s = raw.trim();
-  if (s === "~") return os.homedir();
-  if (s.startsWith("~/") || s.startsWith("~\\")) s = path.join(os.homedir(), s.slice(2));
-  s = s.replace(/^\$HOME(?=$|[/\\])/, os.homedir());
-  s = s.replace(/^%USERPROFILE%(?=$|[/\\])/i, os.homedir());
-  return s;
-}
-__name(expandUserPath, "expandUserPath");
-async function readFileWithCap(absPath, max) {
-  const chunks = [];
-  let total = 0;
-  let exceeded = false;
-  const stream = createReadStream(absPath);
-  try {
-    for await (const chunk of stream) {
-      total += chunk.length;
-      if (total > max) {
-        exceeded = true;
-        break;
-      }
-      chunks.push(chunk);
-    }
-  } catch (e) {
-    const code = e.code;
-    if (code === "ENOENT") throw new ResolveImageError("IMAGE_PATH_NOT_FOUND", "file disappeared during read");
-    if (code === "EACCES" || code === "EPERM") throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `cannot read file (${code})`);
-    throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", e.message);
-  } finally {
-    if (!stream.destroyed) stream.destroy();
-  }
-  if (exceeded) throw new ResolveImageError("IMAGE_TOO_LARGE", `file exceeds ${max} bytes`);
-  return Buffer.concat(chunks, total);
-}
-__name(readFileWithCap, "readFileWithCap");
-async function resolvePath(rawPath) {
-  const expanded = expandUserPath(rawPath);
-  const abs = path.resolve(expanded);
-  const ext = path.extname(abs).toLowerCase();
-  if (!ALLOWED_EXTS.has(ext)) {
-    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `path extension ${ext || "(none)"} is not in the image allowlist (.jpg .jpeg .png .webp)`);
-  }
-  let stat;
-  try {
-    stat = await fs.stat(abs);
-  } catch (e) {
-    const code = e.code;
-    if (code === "ENOENT") {
-      throw new ResolveImageError("IMAGE_PATH_NOT_FOUND", `no such file: ${abs}`);
-    }
-    if (code === "EACCES" || code === "EPERM") {
-      throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `cannot access ${abs} (${code})`);
-    }
-    throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `stat failed: ${e.message}`);
-  }
-  if (!stat.isFile()) {
-    throw new ResolveImageError("IMAGE_PATH_NOT_A_FILE", `${abs} is not a regular file`);
-  }
-  if (stat.size > MAX_BYTES) {
-    throw new ResolveImageError("IMAGE_TOO_LARGE", `${stat.size} bytes (cap ${MAX_BYTES})`);
-  }
-  const buf = await readFileWithCap(abs, MAX_BYTES);
-  const sniffed = sniffMime(buf);
-  if (!sniffed) {
-    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `magic bytes do not match PNG/JPEG/WEBP for ${abs}`);
-  }
-  return {
-    buffer: buf,
-    mimetype: sniffed
-  };
-}
-__name(resolvePath, "resolvePath");
-async function resolveImageUrl(rawUrl) {
-  let u;
-  try {
-    u = new URL(rawUrl);
-  } catch {
-    throw new ResolveImageError("INVALID_INPUT", "imageUrl is not a valid URL");
-  }
-  if (u.protocol !== "https:") throw new ResolveImageError("INVALID_INPUT", "imageUrl must be HTTPS");
-  if (isPrivateHost(u.hostname)) throw new ResolveImageError("INVALID_INPUT", "imageUrl host not allowed");
-  await assertHostResolvesPublic(u.hostname);
-  let res;
-  try {
-    res = await fetch(rawUrl, {
-      signal: AbortSignal.timeout(3e4),
-      redirect: "error"
+});
+var ProductReferenceRejectionReasonSchema = z3.enum([
+  "replacement_requested",
+  "wrong_product_identity",
+  "wrong_variant",
+  "wrong_color",
+  "wrong_quantity_or_packaging",
+  "wrong_view",
+  "low_quality",
+  "not_a_product_photo",
+  "other"
+]);
+var ProductReferenceResolutionDecisionSchema = z3.enum([
+  "approve",
+  "reject",
+  "observed_only",
+  "correct_view"
+]);
+var IdentityAnchorSchema = z3.object({
+  productKey: z3.string().min(1).max(120),
+  variantKey: z3.string().min(1).max(120).optional(),
+  primaryRefKey: z3.string().min(1).max(200)
+});
+var ProductReferenceApprovalSchema = z3.object({
+  version: z3.literal(1),
+  scope: ProductReferenceScopeSchema,
+  scopeKey: z3.string().min(1).max(120),
+  scopeHash: z3.string().min(1).max(128),
+  baseReferenceSetHash: z3.string().min(1).max(128),
+  approvedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
+  identityAnchors: z3.array(IdentityAnchorSchema).min(1),
+  approvedAt: z3.string().datetime(),
+  approvedBy: z3.string().min(1).max(200),
+  invalidatedAt: z3.string().datetime().optional(),
+  invalidationReason: z3.enum([
+    "evidence_changed",
+    "assignment_changed",
+    "required_output_changed",
+    "prepared_content_changed",
+    "anchor_changed"
+  ]).optional()
+});
+var ProductReferencePreviewSchema = z3.object({
+  refKey: z3.string().min(1).max(200),
+  assetKey: z3.string().min(1).max(2e3).optional(),
+  previewUrl: z3.string().url(),
+  estimatedCreditCents: z3.number().int().nonnegative().optional(),
+  retryAllowanceCents: z3.number().int().nonnegative().optional(),
+  source: z3.enum([
+    "upload",
+    "product_page",
+    "internet",
+    "cleaned",
+    "observed",
+    "generated"
+  ]),
+  productKey: z3.string().min(1).max(120),
+  variantKey: z3.string().min(1).max(120).optional(),
+  label: z3.string().min(1).max(160),
+  view: z3.string().min(1).max(80),
+  isAuthoritative: z3.boolean()
+});
+var ApprovedProductReferencesSchema = z3.object({
+  scopeSnapshotId: z3.string().uuid(),
+  scopeHash: z3.string().min(1).max(128),
+  previews: z3.array(ProductReferencePreviewSchema).min(1)
+});
+var ProductReferencePendingActionSchema = z3.object({
+  kind: z3.literal("product_reference_set_approval"),
+  phase: z3.enum([
+    "preparation",
+    "final"
+  ]).default("final"),
+  scope: ProductReferenceScopeSchema,
+  scopeKey: z3.string().min(1).max(120),
+  referenceVersionId: z3.string().uuid(),
+  scopeSnapshotId: z3.string().uuid(),
+  baseReferenceSetHash: z3.string().min(1).max(128),
+  scopeHash: z3.string().min(1).max(128),
+  approvedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
+  /** Server-owned selection shown when preparation has not started yet.
+  * It may be empty when every candidate came from internet discovery, forcing
+  * an explicit user choice before any paid cleaning call. */
+  selectedRefKeys: z3.array(z3.string().min(1).max(200)).optional(),
+  /** True when the server selected sensible defaults without a user photo-review
+  * interaction. Clients must let the user change this selection before approval. */
+  selectionReviewRequired: z3.boolean().optional(),
+  identityAnchors: z3.array(IdentityAnchorSchema).min(1),
+  previews: z3.array(ProductReferencePreviewSchema).min(1),
+  allowedDecisions: z3.array(ProductReferenceResolutionDecisionSchema).min(1),
+  maxAuthorizedCreditCents: z3.number().int().nonnegative().optional(),
+  costBreakdown: z3.object({
+    preparationCreditCents: z3.number().int().nonnegative(),
+    retryReserveCreditCents: z3.number().int().nonnegative(),
+    videoViewPerIdentityCreditCents: z3.number().int().nonnegative().optional()
+  }).optional(),
+  recovery: z3.object({
+    kind: z3.enum([
+      "replace_evidence",
+      "combo_component_evidence"
+    ]),
+    currentSelectionHash: z3.string().min(1).max(128),
+    minimumImageCount: z3.number().int().positive(),
+    affectedRefKeys: z3.array(z3.string().min(1).max(200))
+  }).optional(),
+  reason: z3.string().max(500).optional()
+});
+var ProductReferencePreparationCostSchema = z3.object({
+  preparationCreditCents: z3.number().int().nonnegative(),
+  retryReserveCreditCents: z3.number().int().nonnegative(),
+  additionalVideoViewCreditCents: z3.number().int().nonnegative(),
+  maxCreditCents: z3.number().int().nonnegative()
+});
+var ResolutionEnvelopeSchema = z3.object({
+  expectedScopeHash: z3.string().min(1).max(128),
+  scope: ProductReferenceScopeSchema,
+  scopeKey: z3.string().min(1).max(120),
+  scopeSnapshotId: z3.string().uuid()
+});
+var ResolveProductReferenceSetRequestSchema = z3.discriminatedUnion("decision", [
+  ResolutionEnvelopeSchema.extend({
+    decision: z3.literal("approve"),
+    /** Exact subset selected from the server-owned base previews. The backend
+    * validates and freezes it before preparation or final generation resumes. */
+    selectedRefKeys: z3.array(z3.string().min(1).max(200)).min(1).optional()
+  }),
+  ResolutionEnvelopeSchema.extend({
+    decision: z3.literal("reject"),
+    reason: ProductReferenceRejectionReasonSchema,
+    affectedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
+    recoveryAction: z3.enum([
+      "remove",
+      "replace",
+      "upload",
+      "return_to_selection"
+    ])
+  }),
+  ResolutionEnvelopeSchema.extend({
+    decision: z3.literal("observed_only")
+  }),
+  ResolutionEnvelopeSchema.extend({
+    decision: z3.literal("correct_view"),
+    affectedRefKeys: z3.array(z3.string().min(1).max(200)).length(1),
+    reason: ProductReferenceRejectionReasonSchema
+  })
+]).superRefine((value, context) => {
+  if (value.scope === "base" && (value.decision === "observed_only" || value.decision === "correct_view")) {
+    context.addIssue({
+      code: z3.ZodIssueCode.custom,
+      path: [
+        "scope"
+      ],
+      message: "base_scope_does_not_support_video_only_decision"
     });
-  } catch (e) {
-    throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", e.message);
-  }
-  if (!res.ok) throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", `HTTP ${res.status}`);
-  const cl = res.headers.get("content-length");
-  if (cl && Number(cl) > MAX_BYTES) {
-    throw new ResolveImageError("IMAGE_TOO_LARGE", `content-length ${cl}`);
   }
-  const ct = (res.headers.get("content-type") ?? "").split(";")[0]?.trim() ?? "";
-  if (!ALLOWED_MIMES.has(ct)) throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `content-type ${ct}`);
-  let buf;
-  try {
-    buf = Buffer.from(await readResponseBytes(res, MAX_BYTES));
-  } catch (error) {
-    if (error instanceof ResponseBodyTooLargeError) {
-      throw new ResolveImageError("IMAGE_TOO_LARGE", `image URL exceeds ${MAX_BYTES} bytes`);
-    }
-    throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", "image response could not be read");
+  if (value.scope !== "base" && value.decision === "approve" && value.selectedRefKeys) {
+    context.addIssue({
+      code: z3.ZodIssueCode.custom,
+      path: [
+        "selectedRefKeys"
+      ],
+      message: "selected_references_are_only_valid_for_base_preparation"
+    });
   }
-  const sniffed = sniffMime(buf);
-  if (!sniffed || sniffed !== ct) {
-    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `magic bytes (${sniffed ?? "unknown"}) do not match content-type (${ct})`);
-  }
-  return {
-    buffer: buf,
-    mimetype: sniffed
-  };
-}
-__name(resolveImageUrl, "resolveImageUrl");
-async function resolveImages(images, opts = {
-  transport: "http"
-}) {
-  if (!images.length) throw new ResolveImageError("INVALID_INPUT", "images: at least one entry required");
-  if (images.length > 5) throw new ResolveImageError("INVALID_INPUT", "images: max 5 per request");
-  return Promise.all(images.map((ref) => resolveOne(ref, opts.transport)));
-}
-__name(resolveImages, "resolveImages");
-async function resolveOne(ref, transport) {
-  const hasUrl = Boolean(ref.url);
-  const hasPath = Boolean(ref.path);
-  if (hasUrl === hasPath) {
-    throw new ResolveImageError("INVALID_INPUT", "each image entry must have exactly one of `url` or `path`");
-  }
-  if (hasPath) {
-    if (transport === "http") {
-      throw new ResolveImageError("PATH_NOT_SUPPORTED_IN_HTTP_MODE", "Local file paths are only available when running the MCP locally (npm). For the hosted endpoint at mcp.productmaker.app, pass a public HTTPS `url` instead, or ask the user to host the photo first.");
-    }
-    return resolvePath(ref.path);
-  }
-  return resolveImageUrl(ref.url);
-}
-__name(resolveOne, "resolveOne");
-
-// src/status-poller.ts
-var TERMINAL = /* @__PURE__ */ new Set([
-  "done",
-  "complete",
-  "error"
-]);
-async function pollStatus(fetcher, waitSeconds, signal, opts = {}) {
-  const intervalMs = opts.intervalMs ?? 3e3;
-  const maxWait = opts.maxWaitSeconds ?? 120;
-  const effective = Math.min(Math.max(0, waitSeconds), maxWait);
-  let snapshot = await fetcher();
-  if (effective === 0) return snapshot;
-  if (TERMINAL.has(snapshot.status) || snapshot.status === "awaiting_review" || snapshot.pendingUserAction != null) return snapshot;
-  const deadline = Date.now() + effective * 1e3;
-  while (Date.now() < deadline) {
-    if (signal?.aborted) throw new Error("aborted");
-    await sleep(intervalMs, signal);
-    const next = await fetcher();
-    if (next.status !== snapshot.status || next.phase !== snapshot.phase || TERMINAL.has(next.status) || next.status === "awaiting_review" || next.pendingUserAction != null) {
-      return next;
-    }
-    snapshot = next;
-  }
-  return snapshot;
-}
-__name(pollStatus, "pollStatus");
-function sleep(ms, signal) {
-  return new Promise((resolve3, reject) => {
-    const onAbort = /* @__PURE__ */ __name(() => {
-      clearTimeout(t);
-      reject(new Error("aborted"));
-    }, "onAbort");
-    const t = setTimeout(() => {
-      signal?.removeEventListener("abort", onAbort);
-      resolve3();
-    }, ms);
-    signal?.addEventListener("abort", onAbort, {
-      once: true
-    });
-  });
-}
-__name(sleep, "sleep");
-
-// src/errors.ts
-import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-
-// src/resolve-media.ts
-import { lookup as dnsLookup2 } from "dns/promises";
-import { promises as fs2, createReadStream as createReadStream2 } from "fs";
-import * as os2 from "os";
-import * as path2 from "path";
-
-// ../../packages/types/src/video-enums.ts
-import { z } from "zod";
-var VideoFormat = z.enum([
-  "single_8s",
-  "single_15s",
-  "double_30s"
-]);
-var VideoStyle = z.enum([
-  "ugc",
-  "cartoon_3d",
-  "product_only",
-  "ai_dynamic"
-]);
-var VideoModel = z.enum([
-  "veo",
-  "wan",
-  "bytedance",
-  "seedance",
-  "grok",
-  "kling"
-]);
-var NarrativeStyle = z.enum([
-  "review",
-  "ugc_how_to",
-  "problem_product_cta",
-  "product_showcase",
-  "cinematic",
-  "wild_card",
-  "metaphor_product_cta",
-  "wearable_showcase",
-  "animated_problem_pixar",
-  "sassy_product_pixar",
-  "ugc_unboxing_chaos",
-  "ugc_curiosity_reveal",
-  "ugc_listicle_3",
-  "ugc_skeptic_confession",
-  "ugc_demo_review",
-  "gap_replication"
-]);
-var VideoResolution = z.enum([
-  "480p",
-  "720p"
-]);
-var VideoPreset = z.enum([
-  "auto",
-  "ugc_dynamic",
-  "ugc_how_to",
-  "problem_solution",
-  "product_showcase",
-  "cinematic",
-  "wild_card",
-  "wearable_showcase",
-  "pixar_problem",
-  "pixar_sassy",
-  "ugc_unboxing_chaos",
-  "ugc_curiosity_reveal",
-  "ugc_listicle_3",
-  "ugc_skeptic_confession",
-  "ugc_demo_review",
-  "metaphor_product"
-]);
-var VoiceId = z.string();
-var _VIDEO_MODEL_SET = new Set(VideoModel.options);
-
-// ../../packages/types/src/task.ts
-import { z as z2 } from "zod";
-var TaskStage = z2.enum([
-  "extract",
-  "angles",
-  "video_generator",
-  "creative",
-  "landing"
-]);
-var TaskStageStatus = z2.enum([
-  "pending",
-  "success",
-  "error"
-]);
-var StageStatusSnapshot = z2.object({
-  extract: TaskStageStatus,
-  angles: TaskStageStatus,
-  video_generator: TaskStageStatus,
-  creative: TaskStageStatus,
-  landing: TaskStageStatus
-});
-var TaskKind = z2.enum([
-  "autopilot",
-  "image",
-  "video",
-  "landing",
-  "mix",
-  "service"
-]);
-
-// ../../packages/types/src/product.ts
-import { z as z4 } from "zod";
-
-// ../../packages/types/src/product-reference-set.ts
-import { z as z3 } from "zod";
-var ProductReferenceScopeSchema = z3.enum([
-  "base",
-  "video_view_pack"
-]);
-var SaleConfigurationSchema = z3.object({
-  quantity: z3.number().int().positive(),
-  variantSelections: z3.array(z3.object({
-    axisKey: z3.string().min(1).max(120),
-    valueKey: z3.string().min(1).max(120)
-  })).superRefine((selections, context) => {
-    const axes = selections.map((selection) => selection.axisKey);
-    if (new Set(axes).size !== axes.length) {
-      context.addIssue({
-        code: z3.ZodIssueCode.custom,
-        message: "variant_axes_must_be_unique"
-      });
-    }
-  })
 });
-var SaleItemSchema = z3.object({
-  productKey: z3.string().min(1).max(120),
-  configurations: z3.array(SaleConfigurationSchema).min(1),
-  includedComponentKeys: z3.array(z3.string().min(1).max(120)).superRefine((keys, context) => {
-    if (new Set(keys).size !== keys.length) {
-      context.addIssue({
-        code: z3.ZodIssueCode.custom,
-        message: "included_components_must_be_unique"
-      });
-    }
-  })
+var ResolveProductReferenceSetResponseSchema = z3.object({
+  success: z3.literal(true),
+  taskId: z3.string().uuid(),
+  resolutionId: z3.string().uuid(),
+  decision: ProductReferenceResolutionDecisionSchema
 });
-var SaleStructureDecisionSchema = z3.object({
-  kind: z3.enum([
-    "single_product",
-    "distinct_product_combo",
-    "select_single_product"
-  ]),
-  items: z3.array(SaleItemSchema).min(1)
-}).superRefine((value, context) => {
-  const productKeys = new Set(value.items.map((item) => item.productKey));
-  if (value.kind !== "distinct_product_combo" && value.items.length !== 1) {
-    context.addIssue({
-      code: z3.ZodIssueCode.custom,
-      path: [
-        "items"
-      ],
-      message: "single_product_decision_requires_one_item"
-    });
-  }
-  if (value.kind === "distinct_product_combo" && productKeys.size < 2) {
-    context.addIssue({
-      code: z3.ZodIssueCode.custom,
-      path: [
-        "items"
-      ],
-      message: "combo_requires_distinct_products"
-    });
-  }
-});
-var ProductReferenceRejectionReasonSchema = z3.enum([
-  "replacement_requested",
-  "wrong_product_identity",
-  "wrong_variant",
-  "wrong_color",
-  "wrong_quantity_or_packaging",
-  "wrong_view",
-  "low_quality",
-  "not_a_product_photo",
-  "other"
-]);
-var ProductReferenceResolutionDecisionSchema = z3.enum([
-  "approve",
-  "reject",
-  "observed_only",
-  "correct_view"
-]);
-var IdentityAnchorSchema = z3.object({
-  productKey: z3.string().min(1).max(120),
-  variantKey: z3.string().min(1).max(120).optional(),
-  primaryRefKey: z3.string().min(1).max(200)
-});
-var ProductReferenceApprovalSchema = z3.object({
-  version: z3.literal(1),
-  scope: ProductReferenceScopeSchema,
-  scopeKey: z3.string().min(1).max(120),
-  scopeHash: z3.string().min(1).max(128),
-  baseReferenceSetHash: z3.string().min(1).max(128),
-  approvedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
-  identityAnchors: z3.array(IdentityAnchorSchema).min(1),
-  approvedAt: z3.string().datetime(),
-  approvedBy: z3.string().min(1).max(200),
-  invalidatedAt: z3.string().datetime().optional(),
-  invalidationReason: z3.enum([
-    "evidence_changed",
-    "assignment_changed",
-    "required_output_changed",
-    "prepared_content_changed",
-    "anchor_changed"
-  ]).optional()
-});
-var ProductReferencePreviewSchema = z3.object({
-  refKey: z3.string().min(1).max(200),
-  assetKey: z3.string().min(1).max(2e3).optional(),
-  previewUrl: z3.string().url(),
-  estimatedCreditCents: z3.number().int().nonnegative().optional(),
-  retryAllowanceCents: z3.number().int().nonnegative().optional(),
-  source: z3.enum([
-    "upload",
-    "product_page",
-    "internet",
-    "cleaned",
-    "observed",
-    "generated"
-  ]),
-  productKey: z3.string().min(1).max(120),
-  variantKey: z3.string().min(1).max(120).optional(),
-  label: z3.string().min(1).max(160),
-  view: z3.string().min(1).max(80),
-  isAuthoritative: z3.boolean()
-});
-var ApprovedProductReferencesSchema = z3.object({
-  scopeSnapshotId: z3.string().uuid(),
-  scopeHash: z3.string().min(1).max(128),
-  previews: z3.array(ProductReferencePreviewSchema).min(1)
-});
-var ProductReferencePendingActionSchema = z3.object({
-  kind: z3.literal("product_reference_set_approval"),
-  phase: z3.enum([
-    "preparation",
-    "final"
-  ]).default("final"),
-  scope: ProductReferenceScopeSchema,
-  scopeKey: z3.string().min(1).max(120),
-  referenceVersionId: z3.string().uuid(),
-  scopeSnapshotId: z3.string().uuid(),
-  baseReferenceSetHash: z3.string().min(1).max(128),
-  scopeHash: z3.string().min(1).max(128),
-  approvedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
-  /** Server-owned selection shown when preparation has not started yet.
-  * It may be empty when every candidate came from internet discovery, forcing
-  * an explicit user choice before any paid cleaning call. */
-  selectedRefKeys: z3.array(z3.string().min(1).max(200)).optional(),
-  /** True when the server selected sensible defaults without a user photo-review
-  * interaction. Clients must let the user change this selection before approval. */
-  selectionReviewRequired: z3.boolean().optional(),
-  identityAnchors: z3.array(IdentityAnchorSchema).min(1),
-  previews: z3.array(ProductReferencePreviewSchema).min(1),
-  allowedDecisions: z3.array(ProductReferenceResolutionDecisionSchema).min(1),
-  maxAuthorizedCreditCents: z3.number().int().nonnegative().optional(),
-  costBreakdown: z3.object({
-    preparationCreditCents: z3.number().int().nonnegative(),
-    retryReserveCreditCents: z3.number().int().nonnegative(),
-    videoViewPerIdentityCreditCents: z3.number().int().nonnegative().optional()
-  }).optional(),
-  recovery: z3.object({
-    kind: z3.enum([
-      "replace_evidence",
-      "combo_component_evidence"
-    ]),
-    currentSelectionHash: z3.string().min(1).max(128),
-    minimumImageCount: z3.number().int().positive(),
-    affectedRefKeys: z3.array(z3.string().min(1).max(200))
-  }).optional(),
-  reason: z3.string().max(500).optional()
-});
-var ProductReferencePreparationCostSchema = z3.object({
-  preparationCreditCents: z3.number().int().nonnegative(),
-  retryReserveCreditCents: z3.number().int().nonnegative(),
-  additionalVideoViewCreditCents: z3.number().int().nonnegative(),
-  maxCreditCents: z3.number().int().nonnegative()
-});
-var ResolutionEnvelopeSchema = z3.object({
-  expectedScopeHash: z3.string().min(1).max(128),
-  scope: ProductReferenceScopeSchema,
-  scopeKey: z3.string().min(1).max(120),
-  scopeSnapshotId: z3.string().uuid()
-});
-var ResolveProductReferenceSetRequestSchema = z3.discriminatedUnion("decision", [
-  ResolutionEnvelopeSchema.extend({
-    decision: z3.literal("approve"),
-    /** Exact subset selected from the server-owned base previews. The backend
-    * validates and freezes it before preparation or final generation resumes. */
-    selectedRefKeys: z3.array(z3.string().min(1).max(200)).min(1).optional()
-  }),
-  ResolutionEnvelopeSchema.extend({
-    decision: z3.literal("reject"),
-    reason: ProductReferenceRejectionReasonSchema,
-    affectedRefKeys: z3.array(z3.string().min(1).max(200)).min(1),
-    recoveryAction: z3.enum([
-      "remove",
-      "replace",
-      "upload",
-      "return_to_selection"
-    ])
-  }),
-  ResolutionEnvelopeSchema.extend({
-    decision: z3.literal("observed_only")
-  }),
-  ResolutionEnvelopeSchema.extend({
-    decision: z3.literal("correct_view"),
-    affectedRefKeys: z3.array(z3.string().min(1).max(200)).length(1),
-    reason: ProductReferenceRejectionReasonSchema
-  })
-]).superRefine((value, context) => {
-  if (value.scope === "base" && (value.decision === "observed_only" || value.decision === "correct_view")) {
-    context.addIssue({
-      code: z3.ZodIssueCode.custom,
-      path: [
-        "scope"
-      ],
-      message: "base_scope_does_not_support_video_only_decision"
-    });
-  }
-  if (value.scope !== "base" && value.decision === "approve" && value.selectedRefKeys) {
-    context.addIssue({
-      code: z3.ZodIssueCode.custom,
-      path: [
-        "selectedRefKeys"
-      ],
-      message: "selected_references_are_only_valid_for_base_preparation"
-    });
-  }
-});
-var ResolveProductReferenceSetResponseSchema = z3.object({
-  success: z3.literal(true),
-  taskId: z3.string().uuid(),
-  resolutionId: z3.string().uuid(),
-  decision: ProductReferenceResolutionDecisionSchema
-});
-var ProductReferenceResolutionSchema = z3.object({
-  scope: ProductReferenceScopeSchema,
-  scopeKey: z3.string().min(1).max(120),
-  expectedScopeHash: z3.string().min(1).max(128),
-  decision: ProductReferenceResolutionDecisionSchema
+var ProductReferenceResolutionSchema = z3.object({
+  scope: ProductReferenceScopeSchema,
+  scopeKey: z3.string().min(1).max(120),
+  expectedScopeHash: z3.string().min(1).max(128),
+  decision: ProductReferenceResolutionDecisionSchema
 });
 var ReferencePreparationPlanSchema = z3.object({
   version: z3.literal(1),
@@ -2900,6 +2609,11 @@ var IngestOptions = z15.object({
   *  scan. Default true preserves the existing flow; users with their own
   *  competitor intel or in privacy-sensitive niches can disable. */
   competitorScanEnabled: z15.boolean().default(true),
+  /** Consent for a replicable competitor winner to override an explicitly
+  *  chosen videoPreset. Default true preserves the 2026-08-04 decision;
+  *  only a deliberate `false` suspends replication. See
+  *  `shouldAskReplicationConsent` for when this is even asked. */
+  replicateWinnerWhenFound: z15.boolean().default(true),
   brandId: z15.string().uuid().optional()
 }).partial().superRefine((data, ctx) => {
   const message = validatePriceInversion(data.price, data.compareAtPrice);
@@ -4542,14 +4256,7 @@ var CostEstimationType = z25.enum([
   "service-creative",
   "actor-grid"
 ]);
-var IngestEstimationOptions = z25.object({
-  /** Number of product references that the extract stage will clean. */
-  productImageCount: z25.number().int().min(1).max(INGEST_MAX_REFERENCE_IMAGES).optional(),
-  videoModel: VideoModel.optional(),
-  videoTier: VideoTier.optional(),
-  multiAngleVideos: z25.boolean().optional(),
-  videoAngleCount: z25.number().int().min(1).max(3).optional(),
-  ugcFormat: VideoFormat.optional(),
+var SharedOutputEstimationFields = {
   generateAdCopy: z25.boolean().optional(),
   landingEnabled: z25.boolean().optional(),
   /** Landing render mode. 'code' (structured config + ~6 1K images) is markedly
@@ -4566,6 +4273,20 @@ var IngestEstimationOptions = z25.object({
   *  ~$0.48 worst case: 20 ads × 1.2¢ + 12 transcripts × 2¢). Default
   *  behavior (undefined / true) keeps the full ceiling. */
   competitorScanEnabled: z25.boolean().optional(),
+  /** Declining the winner replica makes `gap_replication` unreachable, so its
+  *  forced-STANDARD ceiling must not be quoted. See
+  *  `.agent/specs/winner-replication-consent.spec.test.ts`. */
+  replicateWinnerWhenFound: z25.boolean().optional()
+};
+var IngestEstimationOptions = z25.object({
+  /** Number of product references that the extract stage will clean. */
+  productImageCount: z25.number().int().min(1).max(INGEST_MAX_REFERENCE_IMAGES).optional(),
+  videoModel: VideoModel.optional(),
+  videoTier: VideoTier.optional(),
+  multiAngleVideos: z25.boolean().optional(),
+  videoAngleCount: z25.number().int().min(1).max(3).optional(),
+  ugcFormat: VideoFormat.optional(),
+  ...SharedOutputEstimationFields,
   videoStyle: VideoStyle.optional(),
   narrativeStyle: NarrativeStyle.optional(),
   videoPreset: VideoPreset.optional(),
@@ -4587,20 +4308,7 @@ var IngestResumeEstimationOptions = z25.object({
   videoResolution: VideoResolution.optional(),
   selectedAngleIndices: z25.array(z25.number().int().nonnegative()).min(1).max(3).optional(),
   angleVideoOptions: z25.array(AngleVideoOptions).max(3).optional(),
-  generateAdCopy: z25.boolean().optional(),
-  landingEnabled: z25.boolean().optional(),
-  /** Landing render mode. 'code' (~6 1K images) is cheaper than 'classic' (~12 2K
-  *  images). Undefined ⇒ classic (the default render mode). */
-  landingMode: LandingModeSchema.optional(),
-  /** Classic landing strategy. Undefined follows the public classic default; code mode ignores it. */
-  landingStrategy: LandingStrategySchema.optional(),
-  adCreativeEnabled: z25.boolean().optional(),
-  /** When false, skip video generation cost. Multi-output autopilot
-  *  selections (e.g. {landing, image}) set this false. */
-  videoGeneratorEnabled: z25.boolean().optional(),
-  /** When false, drop the Apify + Whisper competitor-spy ceiling (up to ~$0.48
-  *  worst case) from the resume estimate so the chat preview matches what's billed. */
-  competitorScanEnabled: z25.boolean().optional(),
+  ...SharedOutputEstimationFields,
   /** Whether the ingest flow will generate the ad creative image (typically true when angle_0 is included). */
   generateCreative: z25.boolean().optional(),
   generateAiMusic: z25.boolean().optional(),
@@ -4641,6 +4349,7 @@ var VideoCreativeEstimationOptions = z25.object({
   requiresAngles: z25.boolean().optional(),
   /** When false, omit the Meta/Whisper competitor-scan ceiling from the estimate. */
   competitorScanEnabled: z25.boolean().optional(),
+  replicateWinnerWhenFound: z25.boolean().optional(),
   /** Quote the competitor scan even when product extraction is skipped (direct video auto path). */
   requiresCompetitorScan: z25.boolean().optional(),
   generateAiMusic: z25.boolean().optional(),
@@ -9685,64 +9394,754 @@ var ServiceMediaAnalysisSchema = z45.object({
   items: z45.array(ServiceMediaAnalysisItemSchema).max(15)
 });
 
-// ../../packages/types/src/daily-control.ts
-import { z as z46 } from "zod";
-var DailyControlStatusSchema = z46.enum([
-  "ok",
-  /** Shopify no puede leerse: falta scope `read_orders` o la tienda no está conectada. */
-  "sales_unavailable",
-  /** La tienda no expone su zona horaria: sin ella no se puede agrupar por día. */
-  "timezone_unavailable",
-  /** El usuario nunca conectó la plataforma de anuncios (Meta o TikTok). */
-  "ads_not_connected",
-  /**
-  * El proyecto no tiene NINGUNA campaña vinculada (ni Meta ni TikTok). Sin
-  * campaña no hay gasto que leer, y "gasto 0" contra ventas reales produce
-  * un costo por venta de 0 — es decir, todo verde y veredicto `scale` para
-  * un producto del que no sabemos nada. Se degrada en vez de calcular.
-  */
-  "no_campaign_linked",
-  /** La cuenta de anuncios respondió pero no reportó su moneda. Nunca se asume. */
-  "currency_unknown",
-  /** La moneda de la cuenta de anuncios difiere de la del país costeado. No se convierte. */
-  "currency_mismatch",
-  /** El proyecto nunca se costeó: no hay break-even contra el cual comparar. */
-  "no_costing",
-  /** Alguna fuente de gasto publicitario falló (campaña inaccesible o error tras reintentos). */
-  "pauta_pendiente",
-  /**
-  * El producto está en su control pero YA NO existe en la tienda (lo borró o
-  * lo archivó). No es «sin datos»: no hay precio que leer y nunca va a
-  * haberlo, así que la única salida es quitarlo del control. Sin este valor
-  * la fila se degradaba como «falta costeo» y la mandaba a llenar un
-  * formulario que no arregla nada.
-  */
-  "product_missing"
-]);
-var DailyControlLightSchema = z46.enum([
-  "green",
-  "amber",
-  "red",
-  "none"
-]);
-var DailyControlVerdictSchema = z46.enum([
-  "scale",
-  "hold",
-  "kill",
-  "insufficient_sample"
-]);
-var DailyControlSourceSchema = z46.enum([
-  "shopify",
-  "shopify_settling",
-  "user",
-  "estimated"
-]);
-var DailyControlDaySchema = z46.object({
-  date: z46.string(),
-  orders: z46.number(),
-  cancelledOrders: z46.number(),
-  /** Medido por Shopify (`cancelledAt`) o estimado con la tasa del costeo — ver `cancelledSource`. */
-  cancelledSource: DailyControlSourceSchema,
+// ../../packages/types/src/internal/deep-freeze.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object") {
+    for (const nested of Object.values(value)) {
+      deepFreeze(nested);
+    }
+    Object.freeze(value);
+  }
+  return value;
+}
+__name(deepFreeze, "deepFreeze");
+
+// ../../packages/types/src/productmaker-capability-model-guidance.ts
+var CAPABILITY_MODEL_GUIDANCE = {
+  approve_video_script: {
+    summary: "Aprueba el guion del video (con o sin ediciones).",
+    useWhen: [
+      "aprueba el guion del video",
+      "la persona aprueba el guion del video, con o sin cambios"
+    ],
+    avoidWhen: [
+      "la persona quiere regenerar por completo el guion"
+    ],
+    defaults: [
+      "conserva las escenas que la persona no cambi\xF3"
+    ],
+    disclosures: [
+      "la aprobaci\xF3n inicia render pagado y requiere confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  check_meta_media_upload: {
+    summary: "Comprueba si los medios preparados ya est\xE1n disponibles.",
+    useWhen: [
+      "ya termin\xE9 de subir los archivos de Meta",
+      "la persona indica que termin\xF3 de preparar sus medios para Meta"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una preparaci\xF3n de medios en curso"
+    ],
+    defaults: [
+      "si a\xFAn no est\xE1n disponibles, espera sin crear otra preparaci\xF3n"
+    ],
+    disclosures: []
+  },
+  check_media_upload: {
+    summary: "Comprueba si la preparaci\xF3n segura de medios termin\xF3.",
+    useWhen: [
+      "la persona indica que termin\xF3 de preparar sus medios"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una preparaci\xF3n de medios en curso"
+    ],
+    defaults: [
+      "si a\xFAn no est\xE1n disponibles, espera sin crear otra preparaci\xF3n"
+    ],
+    disclosures: []
+  },
+  cost_dropshipping_project: {
+    summary: "Guarda el costeo de un proyecto guiado.",
+    useWhen: [
+      "calcula el margen de mi proyecto dropshipping",
+      "la persona pide calcular el margen de su proyecto de dropshipping"
+    ],
+    avoidWhen: [
+      "la persona s\xF3lo quiere estimar un producto fuera de un proyecto"
+    ],
+    defaults: [
+      "recalcula el resultado can\xF3nico con los datos entregados"
+    ],
+    disclosures: [
+      "modifica el proyecto y requiere confirmaci\xF3n expl\xEDcita",
+      "pide el costo real del proveedor y no lo inventes"
+    ]
+  },
+  cost_product: {
+    summary: "Calcula GRATIS y sin cr\xE9ditos cu\xE1nto cobrar por un producto de dropshipping en cualquiera de los pa\xEDses disponibles en ProductMaker.",
+    useWhen: [
+      "cu\xE1nto cuesta este producto",
+      "la persona pregunta cu\xE1nto cobrar, la rentabilidad o el margen de un producto"
+    ],
+    avoidWhen: [
+      "la persona quiere guardar el costeo de un proyecto guiado"
+    ],
+    defaults: [
+      "usa valores gu\xEDa editables salvo el costo real del proveedor"
+    ],
+    disclosures: [
+      "es una consulta gratuita y no crea tareas"
+    ]
+  },
+  create_creative_variant: {
+    summary: "Crea un video, imagen o secci\xF3n de landing adicional dentro de una tarea existente.",
+    useWhen: [
+      "crea una variante de imagen",
+      "la persona pide una variante creativa de una tarea existente"
+    ],
+    avoidWhen: [
+      "la persona todav\xEDa no tiene una tarea creativa de origen"
+    ],
+    defaults: [
+      "reutiliza el producto y referencias de la tarea de origen"
+    ],
+    disclosures: [
+      "es trabajo pagado; cotiza y espera confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  create_product_task: {
+    summary: "Crea una tarea autopilot combinada.",
+    useWhen: [
+      "crea una landing y un video",
+      "la persona pide expl\xEDcitamente al menos dos entregables entre landing, video e im\xE1genes creativas"
+    ],
+    avoidWhen: [
+      "la persona pide un solo entregable; usa su generador dedicado"
+    ],
+    defaults: [
+      "si la selecci\xF3n de resultados se omite, genera landing, video e im\xE1genes creativas en una misma tarea"
+    ],
+    disclosures: [
+      "debes resumir todos los resultados, cotizar y esperar confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  create_service_video: {
+    summary: "Crea un video para un servicio desde su landing.",
+    useWhen: [
+      "crea un video para mi servicio",
+      "la persona pide un video para promocionar un servicio"
+    ],
+    avoidWhen: [
+      "la persona pide un video de producto o un video libre"
+    ],
+    defaults: [
+      "usa la landing del servicio como contexto principal"
+    ],
+    disclosures: [
+      "es trabajo pagado y requiere confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  edit_image_creative: {
+    summary: "Corrige UNA imagen ya generada de una tarea de creativos, sin regenerar el set completo.",
+    useWhen: [
+      "edita esta imagen creativa",
+      "la persona pide editar una imagen creativa concreta"
+    ],
+    avoidWhen: [
+      "la persona pide regenerar todas las im\xE1genes"
+    ],
+    defaults: [
+      "modifica \xFAnicamente la imagen elegida"
+    ],
+    disclosures: [
+      "es trabajo pagado y requiere confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  edit_task_draft: {
+    summary: "Edita el draft de un angle de marketing antes de la generaci\xF3n.",
+    useWhen: [
+      "edita el borrador del \xE1ngulo creativo",
+      "la persona pide cambiar el borrador de un \xE1ngulo creativo"
+    ],
+    avoidWhen: [
+      "la generaci\xF3n ya termin\xF3"
+    ],
+    defaults: [
+      "conserva los campos que la persona no cambi\xF3"
+    ],
+    disclosures: [
+      "modifica el estado de la tarea y requiere confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  estimate_creative_variant: {
+    summary: "Calcula el costo de crear una variante desde una tarea existente, sin consumir cr\xE9ditos.",
+    useWhen: [
+      "cu\xE1nto cuesta una variante creativa",
+      "la persona pregunta cu\xE1nto cuesta una variante creativa"
+    ],
+    avoidWhen: [
+      "la persona ya confirm\xF3 que quiere crear la variante cotizada"
+    ],
+    defaults: [
+      "estima con la configuraci\xF3n real de la tarea de origen"
+    ],
+    disclosures: [
+      "la cotizaci\xF3n es gratuita y no crea la variante"
+    ]
+  },
+  find_winning_products: {
+    summary: "Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads).",
+    useWhen: [
+      "investiga productos ganadores para dropshipping",
+      "la persona pide investigar productos ganadores para dropshipping"
+    ],
+    avoidWhen: [
+      "ya existe una investigaci\xF3n pagada \xFAtil para el mismo objetivo"
+    ],
+    defaults: [
+      "presenta razones, riesgos y evidencia por producto"
+    ],
+    disclosures: [
+      "cuesta 2000 cr\xE9ditos y requiere aceptaci\xF3n expl\xEDcita"
+    ]
+  },
+  generate_free_video: {
+    summary: "Genera UN video libre con prompt/guion exacto, opcionalmente con imagen de referencia.",
+    useWhen: [
+      "genera un video libre creativo",
+      "la persona pide un video libre con un prompt o guion espec\xEDfico"
+    ],
+    avoidWhen: [
+      "la persona pide un creativo de producto o de servicio"
+    ],
+    defaults: [
+      "respeta el prompt o guion entregado"
+    ],
+    disclosures: [
+      "es trabajo pagado; cotiza y espera confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  generate_image_creatives: {
+    summary: "Genera variantes de imagen creativa.",
+    useWhen: [
+      "genera im\xE1genes creativas del producto",
+      "la persona pide im\xE1genes creativas de un producto"
+    ],
+    avoidWhen: [
+      "la persona pide una sola edici\xF3n sobre una imagen existente"
+    ],
+    defaults: [
+      "genera s\xF3lo im\xE1genes creativas"
+    ],
+    disclosures: [
+      "es trabajo pagado; cotiza y espera confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  generate_landing: {
+    summary: "Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify.",
+    useWhen: [
+      "genera una landing creativa",
+      "quiero crear una landing page",
+      "quiero crear una p\xE1gina de producto",
+      "la persona pide \xFAnicamente una landing o p\xE1gina de producto"
+    ],
+    avoidWhen: [
+      "la persona pide un paquete combinado de dos o m\xE1s entregables"
+    ],
+    defaults: [
+      "genera \xFAnicamente la landing"
+    ],
+    disclosures: [
+      "es trabajo pagado y requiere cotizaci\xF3n y confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  generate_video_creative: {
+    summary: "Genera entre 1 y 3 videos creativos independientes dentro de un mismo task.",
+    useWhen: [
+      "genera un video creativo",
+      "la persona pide un video creativo de producto"
+    ],
+    avoidWhen: [
+      "la persona pide un paquete combinado o un video libre"
+    ],
+    defaults: [
+      "genera \xFAnicamente el video creativo"
+    ],
+    disclosures: [
+      "es trabajo pagado; cotiza y espera confirmaci\xF3n expl\xEDcita"
+    ]
+  },
+  get_meta_campaign_status: {
+    summary: "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada.",
+    useWhen: [
+      "consulta el estado de la campa\xF1a Meta",
+      "la persona pregunta por el estado o rendimiento de una campa\xF1a Meta"
+    ],
+    avoidWhen: [
+      "la campa\xF1a a\xFAn no fue publicada"
+    ],
+    defaults: [
+      "devuelve m\xE9tricas acumuladas sin modificar la campa\xF1a"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  get_daily_control: {
+    summary: "Muestra el control diario de rentabilidad por producto con m\xE9tricas, sem\xE1foro y veredicto.",
+    useWhen: [
+      "revisa la rentabilidad diaria de mis productos",
+      "la persona quiere decidir si escalar, mantener o detener un producto"
+    ],
+    avoidWhen: [
+      "la persona quiere modificar una campa\xF1a publicitaria"
+    ],
+    defaults: [
+      "consulta los \xFAltimos tres d\xEDas cerrados"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura y distingue cifras medidas de estimadas"
+    ]
+  },
+  get_product_research_run: {
+    summary: "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto.",
+    useWhen: [
+      "consulta el estado de la investigaci\xF3n",
+      "la persona pide consultar una investigaci\xF3n existente"
+    ],
+    avoidWhen: [
+      "la persona quiere iniciar una investigaci\xF3n nueva"
+    ],
+    defaults: [
+      "devuelve el reporte completo disponible"
+    ],
+    disclosures: [
+      "es una consulta gratuita y de solo lectura"
+    ]
+  },
+  get_task_status: {
+    summary: "Devuelve estado y entregables.",
+    useWhen: [
+      "consulta el estado de mi tarea",
+      "la persona pide consultar el estado o resultado de una tarea"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una tarea identificable"
+    ],
+    defaults: [
+      "contin\xFAa consultando hasta una revisi\xF3n o estado terminal cuando corresponda"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  get_tiktok_campaign_status: {
+    summary: "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada.",
+    useWhen: [
+      "consulta el estado de la campa\xF1a TikTok",
+      "la persona pregunta por el estado o rendimiento de una campa\xF1a TikTok"
+    ],
+    avoidWhen: [
+      "la campa\xF1a a\xFAn no fue publicada"
+    ],
+    defaults: [
+      "devuelve m\xE9tricas acumuladas sin modificar la campa\xF1a"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  get_video_script: {
+    summary: "Lee el guion del video pendiente de revisi\xF3n.",
+    useWhen: [
+      "consulta el guion del video",
+      "la persona pide consultar el guion de un video en revisi\xF3n"
+    ],
+    avoidWhen: [
+      "la tarea no tiene revisi\xF3n de guion pendiente"
+    ],
+    defaults: [
+      "conserva el contenido del guion sin modificarlo"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  guide_dropshipping_launch: {
+    summary: "Gu\xEDa read-only de un recorrido COMPLETO de dropshipping, desde producto/costeo hasta creativos, tienda y publicidad.",
+    useWhen: [
+      "ay\xFAdame con mi proyecto dropshipping",
+      "la persona pide ayuda para avanzar un proyecto completo de dropshipping"
+    ],
+    avoidWhen: [
+      "la persona pide una operaci\xF3n puntual"
+    ],
+    defaults: [
+      "propone el siguiente paso sin ejecutar cambios"
+    ],
+    disclosures: [
+      "es una gu\xEDa de solo lectura y no activa campa\xF1as"
+    ]
+  },
+  list_actors: {
+    summary: "Lista los personajes guardados del usuario (personas creadas con IA que pueden protagonizar los videos e im\xE1genes).",
+    useWhen: [
+      "lista mis personajes disponibles",
+      "la persona pide ver sus personajes disponibles"
+    ],
+    avoidWhen: [
+      "la persona quiere crear un personaje nuevo"
+    ],
+    defaults: [
+      "muestra \xFAnicamente personajes listos para usar"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  link_campaign_to_project: {
+    summary: "Vincula una campa\xF1a publicitaria existente con un proyecto para incluir su gasto en el control diario.",
+    useWhen: [
+      "vincula esta campa\xF1a con mi proyecto",
+      "la persona quiere medir una campa\xF1a creada fuera de ProductMaker"
+    ],
+    avoidWhen: [
+      "la campa\xF1a ya est\xE1 vinculada al proyecto correcto"
+    ],
+    defaults: [
+      "verifica la propiedad de la campa\xF1a antes de vincularla"
+    ],
+    disclosures: [
+      "modifica el proyecto y requiere confirmaci\xF3n expl\xEDcita; no modifica la campa\xF1a publicitaria"
+    ]
+  },
+  list_meta_ad_accounts: {
+    summary: "Lista las cuentas publicitarias de Meta conectadas.",
+    useWhen: [
+      "lista mis cuentas publicitarias de Meta",
+      "la persona pide ver sus cuentas publicitarias de Meta"
+    ],
+    avoidWhen: [
+      "la persona necesita elegir adem\xE1s portfolio y p\xE1gina"
+    ],
+    defaults: [
+      "muestra \xFAnicamente cuentas conectadas"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  list_meta_destinations: {
+    summary: "Lista los destinos de publicaci\xF3n de Meta del usuario: Business portfolios, cuentas publicitarias dentro de cada portfolio y Facebook Pages disponibles.",
+    useWhen: [
+      "lista mis destinos de Meta",
+      "la persona necesita elegir un destino antes de publicar en Meta"
+    ],
+    avoidWhen: [
+      "la persona s\xF3lo pregunta por el estado de una campa\xF1a"
+    ],
+    defaults: [
+      "presenta las opciones para que la persona elija"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura y no elige silenciosamente"
+    ]
+  },
+  list_product_research_runs: {
+    summary: "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua.",
+    useWhen: [
+      "lista mis investigaciones de productos",
+      "la persona pide ver sus investigaciones de productos"
+    ],
+    avoidWhen: [
+      "la persona ya eligi\xF3 una investigaci\xF3n concreta para consultar"
+    ],
+    defaults: [
+      "ordena de la m\xE1s reciente a la m\xE1s antigua"
+    ],
+    disclosures: [
+      "es una consulta gratuita y de solo lectura"
+    ]
+  },
+  list_shopify_products: {
+    summary: "Busca productos en una tienda Shopify conectada para elegir el target de una republicaci\xF3n.",
+    useWhen: [
+      "lista los productos de mi tienda Shopify",
+      "la persona pide listar productos de su tienda Shopify"
+    ],
+    avoidWhen: [
+      "la persona s\xF3lo necesita listar sus tiendas conectadas"
+    ],
+    defaults: [
+      "no modifica ning\xFAn producto"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  list_shopify_shops: {
+    summary: "Lista las tiendas Shopify conectadas por este usuario.",
+    useWhen: [
+      "lista mis tiendas Shopify conectadas",
+      "la persona pide ver sus tiendas Shopify conectadas"
+    ],
+    avoidWhen: [
+      "la persona ya eligi\xF3 una tienda y busca un producto"
+    ],
+    defaults: [
+      "muestra \xFAnicamente tiendas conectadas"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  list_tasks: {
+    summary: "Lista de forma read-only las tareas recientes del usuario.",
+    useWhen: [
+      "lista mis tareas recientes",
+      "la persona pide listar o buscar sus tareas recientes"
+    ],
+    avoidWhen: [
+      "la persona ya identific\xF3 una tarea y pide su estado"
+    ],
+    defaults: [
+      "muestra las tareas recientes sin modificarlas"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  list_tiktok_advertisers: {
+    summary: "Lista las cuentas de TikTok Ads conectadas.",
+    useWhen: [
+      "lista mis anunciantes TikTok conectados",
+      "la persona pide ver sus anunciantes TikTok conectados"
+    ],
+    avoidWhen: [
+      "la persona s\xF3lo pregunta por el estado de una campa\xF1a"
+    ],
+    defaults: [
+      "muestra \xFAnicamente cuentas conectadas"
+    ],
+    disclosures: [
+      "es una consulta de solo lectura"
+    ]
+  },
+  publish_creatives_to_meta: {
+    summary: "Crea UNA campa\xF1a de Meta Ads PAUSED agrupando hasta 10 creativos.",
+    useWhen: [
+      "publica estos creativos en Meta",
+      "la persona pide publicar varios creativos juntos en Meta"
+    ],
+    avoidWhen: [
+      "la persona quiere publicar creativos de una sola tarea"
+    ],
+    defaults: [
+      "crea la campa\xF1a pausada con los creativos confirmados"
+    ],
+    disclosures: [
+      "requiere destino y confirmaci\xF3n expl\xEDcitos; el gasto publicitario es externo"
+    ]
+  },
+  publish_to_meta: {
+    summary: "Publica tus creativos en Meta sin gastar cr\xE9ditos de ProductMaker.",
+    useWhen: [
+      "publica la campa\xF1a en Meta",
+      "la persona pide publicar en Meta los creativos de una tarea"
+    ],
+    avoidWhen: [
+      "la persona quiere agrupar creativos de varias tareas"
+    ],
+    defaults: [
+      "crea la campa\xF1a pausada"
+    ],
+    disclosures: [
+      "requiere destino y confirmaci\xF3n expl\xEDcitos; el gasto publicitario es externo"
+    ]
+  },
+  publish_to_shopify: {
+    summary: "Publica o actualiza la landing en una tienda Shopify conectada.",
+    useWhen: [
+      "publica el producto en Shopify",
+      "la persona pide publicar un producto o landing en Shopify"
+    ],
+    avoidWhen: [
+      "la tarea todav\xEDa no est\xE1 completa"
+    ],
+    defaults: [
+      "actualiza la publicaci\xF3n existente de esa tarea o crea una nueva"
+    ],
+    disclosures: [
+      "requiere tienda, variantes y confirmaci\xF3n expl\xEDcitas"
+    ]
+  },
+  publish_to_tiktok: {
+    summary: "Crea una campa\xF1a de TikTok Ads desde la tarea.",
+    useWhen: [
+      "publica la campa\xF1a en TikTok",
+      "la persona pide publicar una campa\xF1a en TikTok"
+    ],
+    avoidWhen: [
+      "la tarea todav\xEDa no tiene creativos publicables"
+    ],
+    defaults: [
+      "crea la campa\xF1a pausada"
+    ],
+    disclosures: [
+      "requiere anunciante y confirmaci\xF3n expl\xEDcitos; el gasto publicitario es externo"
+    ]
+  },
+  regenerate_video_script: {
+    summary: "Re-rolea (regenera) el guion del video pendiente de revisi\xF3n.",
+    useWhen: [
+      "regenera el guion del video creativo",
+      "la persona pide regenerar el guion completo del video"
+    ],
+    avoidWhen: [
+      "la persona quiere editar s\xF3lo algunas escenas"
+    ],
+    defaults: [
+      "mantiene la tarea y reemplaza el guion pendiente"
+    ],
+    disclosures: [
+      "consume cr\xE9ditos y requiere confirmaci\xF3n expl\xEDcita salvo recuperaci\xF3n necesaria"
+    ]
+  },
+  report_daily_returns: {
+    summary: "Registra el n\xFAmero real de pedidos devueltos de un producto en un d\xEDa concreto.",
+    useWhen: [
+      "registra las devoluciones reales de ayer",
+      "la persona conoce el n\xFAmero real de devoluciones de un producto"
+    ],
+    avoidWhen: [
+      "la persona no conoce el dato exacto"
+    ],
+    defaults: [
+      "reemplaza la estimaci\xF3n de ese d\xEDa con el dato informado"
+    ],
+    disclosures: [
+      "modifica el control diario y requiere confirmaci\xF3n expl\xEDcita; nunca inventes el n\xFAmero"
+    ]
+  },
+  request_meta_media_upload: {
+    summary: "Prepara im\xE1genes o videos del usuario para una publicaci\xF3n en Meta.",
+    useWhen: [
+      "quiero subir una imagen a Meta",
+      "la persona necesita preparar im\xE1genes o videos para Meta"
+    ],
+    avoidWhen: [
+      "los medios ya est\xE1n disponibles para la publicaci\xF3n"
+    ],
+    defaults: [
+      "prepara s\xF3lo los medios solicitados"
+    ],
+    disclosures: [
+      "no genera creativos ni publica campa\xF1as"
+    ]
+  },
+  request_media_upload: {
+    summary: "Abre el selector universal de ProductMaker para im\xE1genes o videos del usuario.",
+    useWhen: [
+      "la persona necesita preparar im\xE1genes o videos para otra capacidad"
+    ],
+    avoidWhen: [
+      "los medios ya est\xE1n disponibles para la capacidad solicitada"
+    ],
+    defaults: [
+      "prepara s\xF3lo los medios solicitados"
+    ],
+    disclosures: [
+      "no genera creativos, publica ni consume cr\xE9ditos"
+    ]
+  },
+  resolve_pending_action: {
+    summary: "Resuelve la decisi\xF3n pendiente de una tarea usando la respuesta o delegaci\xF3n expl\xEDcita de la persona.",
+    useWhen: [
+      "confirma la acci\xF3n pendiente del video",
+      "la persona responde o delega una decisi\xF3n pendiente"
+    ],
+    avoidWhen: [
+      "todav\xEDa no existe una decisi\xF3n pendiente o la persona no respondi\xF3"
+    ],
+    defaults: [
+      "aplica \xFAnicamente la decisi\xF3n expresada"
+    ],
+    disclosures: [
+      "puede iniciar trabajo pagado y requiere autoridad expl\xEDcita"
+    ]
+  },
+  start_dropshipping_project: {
+    summary: "Inicia o reanuda un proyecto opcional de dropshipping.",
+    useWhen: [
+      "inicia un proyecto dropshipping",
+      "la persona pide iniciar o continuar un proyecto de dropshipping"
+    ],
+    avoidWhen: [
+      "la persona s\xF3lo pide una operaci\xF3n puntual"
+    ],
+    defaults: [
+      "conserva el progreso existente cuando corresponde"
+    ],
+    disclosures: [
+      "modifica el proyecto, no consume cr\xE9ditos y requiere confirmaci\xF3n expl\xEDcita"
+    ]
+  }
+};
+var PRODUCTMAKER_CAPABILITY_MODEL_GUIDANCE = deepFreeze(CAPABILITY_MODEL_GUIDANCE);
+function getProductMakerCapabilityModelGuidance(name) {
+  return PRODUCTMAKER_CAPABILITY_MODEL_GUIDANCE[name];
+}
+__name(getProductMakerCapabilityModelGuidance, "getProductMakerCapabilityModelGuidance");
+
+// ../../packages/types/src/daily-control.ts
+import { z as z46 } from "zod";
+var DailyControlStatusSchema = z46.enum([
+  "ok",
+  /** Shopify no puede leerse: falta scope `read_orders` o la tienda no está conectada. */
+  "sales_unavailable",
+  /** La tienda no expone su zona horaria: sin ella no se puede agrupar por día. */
+  "timezone_unavailable",
+  /** El usuario nunca conectó la plataforma de anuncios (Meta o TikTok). */
+  "ads_not_connected",
+  /**
+  * El proyecto no tiene NINGUNA campaña vinculada (ni Meta ni TikTok). Sin
+  * campaña no hay gasto que leer, y "gasto 0" contra ventas reales produce
+  * un costo por venta de 0 — es decir, todo verde y veredicto `scale` para
+  * un producto del que no sabemos nada. Se degrada en vez de calcular.
+  */
+  "no_campaign_linked",
+  /** La cuenta de anuncios respondió pero no reportó su moneda. Nunca se asume. */
+  "currency_unknown",
+  /** La moneda de la cuenta de anuncios difiere de la del país costeado. No se convierte. */
+  "currency_mismatch",
+  /** El proyecto nunca se costeó: no hay break-even contra el cual comparar. */
+  "no_costing",
+  /** Alguna fuente de gasto publicitario falló (campaña inaccesible o error tras reintentos). */
+  "pauta_pendiente",
+  /**
+  * El producto está en su control pero YA NO existe en la tienda (lo borró o
+  * lo archivó). No es «sin datos»: no hay precio que leer y nunca va a
+  * haberlo, así que la única salida es quitarlo del control. Sin este valor
+  * la fila se degradaba como «falta costeo» y la mandaba a llenar un
+  * formulario que no arregla nada.
+  */
+  "product_missing"
+]);
+var DailyControlLightSchema = z46.enum([
+  "green",
+  "amber",
+  "red",
+  "none"
+]);
+var DailyControlVerdictSchema = z46.enum([
+  "scale",
+  "hold",
+  "kill",
+  "insufficient_sample"
+]);
+var DailyControlSourceSchema = z46.enum([
+  "shopify",
+  "shopify_settling",
+  "user",
+  "estimated"
+]);
+var DailyControlDaySchema = z46.object({
+  date: z46.string(),
+  orders: z46.number(),
+  cancelledOrders: z46.number(),
+  /** Medido por Shopify (`cancelledAt`) o estimado con la tasa del costeo — ver `cancelledSource`. */
+  cancelledSource: DailyControlSourceSchema,
   returnedOrders: z46.number(),
   /** Reportado por el usuario o estimado con la tasa del costeo — ver `returnedSource`. */
   returnedSource: DailyControlSourceSchema,
@@ -10054,6 +10453,7 @@ var WHATSAPP_ONLY_CHANNEL_EXPOSURE = {
 function defineCapability(name, schemaHash, confirmation, routingDomain, effects, inputSlots, consumes, produces, channelExposure = SHARED_CHANNEL_EXPOSURE, conversationInputs) {
   return {
     name,
+    modelGuidance: getProductMakerCapabilityModelGuidance(name),
     schemaHash,
     confirmation,
     routingDomain,
@@ -10094,6 +10494,7 @@ function slot(name, required, mcp2, whatsapp = mcp2, source = "user") {
 __name(slot, "slot");
 var SERVER_SELECTED_OR_ARTIFACT_FIELDS = /* @__PURE__ */ new Set([
   "actionKind",
+  "accountId",
   "actorId",
   "adAccountId",
   "advertiserId",
@@ -10101,6 +10502,7 @@ var SERVER_SELECTED_OR_ARTIFACT_FIELDS = /* @__PURE__ */ new Set([
   "campaignId",
   "projectId",
   "pixelId",
+  "provider",
   "runId",
   "sessionId",
   "shopDomain",
@@ -10116,16 +10518,6 @@ function whatsappFieldAuthority(field, source) {
   return SERVER_SELECTED_OR_ARTIFACT_FIELDS.has(field) ? "server_selected_or_artifact" : "user";
 }
 __name(whatsappFieldAuthority, "whatsappFieldAuthority");
-function deepFreeze(value) {
-  if (value !== null && typeof value === "object") {
-    for (const nested of Object.values(value)) {
-      deepFreeze(nested);
-    }
-    Object.freeze(value);
-  }
-  return value;
-}
-__name(deepFreeze, "deepFreeze");
 var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   defineCapability("approve_video_script", "bab794a9700a8d3f42b97f444a776e7ed4dcd833038c52588f951b50970ff3fa", "credit_consuming", "creative", [
     "credit_consuming",
@@ -10274,7 +10666,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
   ], [
     "creative_variant"
   ]),
-  defineCapability("create_product_task", "1e112848ec1433249e7add9994ca07b5322a743f7444808bd51b8257c3988366", "credit_consuming", "creative", [
+  defineCapability("create_product_task", "ba700dbec8fb6454d55f996ae4567b9280256ae3b62fceb77fd729b9aa21425c", "credit_consuming", "creative", [
     "credit_consuming",
     "state_change"
   ], [
@@ -10325,7 +10717,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "videoResolution",
       "videoAngleCount",
       "angleNarratives",
-      "competitorScanEnabled"
+      "competitorScanEnabled",
+      "replicateWinnerWhenFound"
     ], [
       "videoPreset",
       "durationSeconds",
@@ -10334,7 +10727,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "videoResolution",
       "multiAngleVideos",
       "angleNarratives",
-      "competitorScanEnabled"
+      "competitorScanEnabled",
+      "replicateWinnerWhenFound"
     ]),
     slot("brand_direction", false, [
       "brandId",
@@ -10649,7 +11043,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       fieldCompletion: "all"
     }
   ]),
-  defineCapability("generate_video_creative", "be67eb577c59070d8f77a0b783e4a6e9534ed917dda03d60200fbeb9365db66d", "credit_consuming", "creative", [
+  defineCapability("generate_video_creative", "d99875f4e137c570510e2adac423e5419c3ed135d4505007d9bdfe30ad1b43d5", "credit_consuming", "creative", [
     "credit_consuming",
     "state_change"
   ], [
@@ -10679,7 +11073,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "features",
       "cta",
       "scriptNotes",
-      "competitorScanEnabled"
+      "competitorScanEnabled",
+      "replicateWinnerWhenFound"
     ], [
       "aspectRatio",
       "durationSeconds",
@@ -10691,7 +11086,8 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
       "scriptNotes",
       "pauseForVideoScriptReview",
       "pauseForAngleReview",
-      "competitorScanEnabled"
+      "competitorScanEnabled",
+      "replicateWinnerWhenFound"
     ]),
     slot("commercial_offer", false, [
       "price",
@@ -11133,7 +11529,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "campaign_link"
   ], [
     "daily_control_report"
-  ], MCP_ONLY_CHANNEL_EXPOSURE),
+  ]),
   defineCapability("link_campaign_to_project", "42785a9781412e0ad7cf7095b7188f315dea4003002777d5a4b1b9cc79ea05e0", "state_change", "business", [
     "state_change"
   ], [
@@ -11153,7 +11549,7 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "dropshipping_project"
   ], [
     "campaign_link"
-  ], MCP_ONLY_CHANNEL_EXPOSURE),
+  ]),
   defineCapability("report_daily_returns", "7130d216656cc29a47fc972b4edad5003a6653fca48d95052fbf2b561636e91a", "state_change", "business", [
     "state_change"
   ], [
@@ -11173,170 +11569,459 @@ var PRODUCTMAKER_CAPABILITY_REGISTRY = deepFreeze([
     "dropshipping_project"
   ], [
     "daily_control_report"
-  ], MCP_ONLY_CHANNEL_EXPOSURE)
+  ])
 ]);
 var PRODUCTMAKER_CAPABILITY_NAMES = PRODUCTMAKER_CAPABILITY_REGISTRY.map((capability) => capability.name);
 var PRODUCTMAKER_MCP_CAPABILITY_REGISTRY = PRODUCTMAKER_CAPABILITY_REGISTRY.filter((capability) => capability.channelExposure.mcp === "direct");
 var PRODUCTMAKER_WHATSAPP_CAPABILITY_REGISTRY = PRODUCTMAKER_CAPABILITY_REGISTRY.filter((capability) => capability.channelExposure.whatsapp === "adapted");
 var PRODUCTMAKER_WHATSAPP_CAPABILITY_NAMES = PRODUCTMAKER_WHATSAPP_CAPABILITY_REGISTRY.map((capability) => capability.name);
 
-// ../../packages/types/src/productmaker-chat-capabilities.ts
-function toLegacyCapabilityCatalog(catalog) {
-  return catalog.map(({ name, confirmation, schemaHash }) => ({
-    name,
-    confirmation,
-    schemaHash
-  }));
+// ../../packages/types/src/productmaker-chat-capabilities.ts
+function toLegacyCapabilityCatalog(catalog) {
+  return catalog.map(({ name, confirmation, schemaHash }) => ({
+    name,
+    confirmation,
+    schemaHash
+  }));
+}
+__name(toLegacyCapabilityCatalog, "toLegacyCapabilityCatalog");
+var PRODUCTMAKER_MCP_CAPABILITIES = toLegacyCapabilityCatalog(PRODUCTMAKER_MCP_CAPABILITY_REGISTRY);
+var PRODUCTMAKER_MCP_CAPABILITY_NAMES = PRODUCTMAKER_MCP_CAPABILITY_REGISTRY.map((capability) => capability.name);
+
+// ../../packages/types/src/actor.ts
+import { z as z48 } from "zod";
+var ActorStatusSchema = z48.enum([
+  "draft",
+  "generating",
+  "ready",
+  "failed"
+]);
+var ACTOR_NAME_MAX_CHARS = 60;
+var ACTOR_DESCRIPTION_MAX_CHARS = 600;
+var ACTOR_CANDIDATE_COUNT = 4;
+var ActorGenderSchema = z48.enum([
+  "female",
+  "male",
+  "non_binary"
+]);
+var ActorSchema = z48.object({
+  id: z48.string(),
+  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS),
+  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS),
+  gender: ActorGenderSchema,
+  voiceId: z48.string().nullable().optional(),
+  brandId: z48.string().nullable().optional(),
+  status: ActorStatusSchema,
+  /**
+  * A candidate-grid run is in flight RIGHT NOW.
+  *
+  * Separate from `status` because the two answer different questions:
+  * `status` is the PUBLISHED state (a personaje being regenerated stays
+  * `ready`, so it keeps serving the renders that already reference it), and
+  * this flag is the live one the wizard polls. It is derived from a lock
+  * timestamp with a TTL, so an orphaned run reads as `false` instead of
+  * pinning the personaje forever.
+  */
+  generating: z48.boolean().optional(),
+  photoUrl: z48.string().url().nullable().optional(),
+  avatarUrl: z48.string().url().nullable().optional(),
+  candidateUrls: z48.array(z48.string().url()).optional(),
+  /** Indices of candidateUrls that failed the anatomy check (Task 6). */
+  flaggedCandidateIndices: z48.array(z48.number().int()).optional()
+});
+var CreateActorRequest = z48.object({
+  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS),
+  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS).default(""),
+  gender: ActorGenderSchema,
+  voiceId: z48.string().optional(),
+  brandId: z48.string().optional(),
+  sourcePhotoKey: z48.string().optional()
+}).refine((v) => v.description.trim().length > 0 || !!v.sourcePhotoKey, {
+  message: "Se necesita una descripci\xF3n o una foto"
+});
+var UpdateActorRequest = z48.object({
+  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS).optional(),
+  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS).optional(),
+  gender: ActorGenderSchema.optional(),
+  voiceId: z48.string().nullable().optional(),
+  brandId: z48.string().nullable().optional()
+});
+var ApproveActorRequest = z48.object({
+  candidateIndex: z48.number().int().min(0).max(ACTOR_CANDIDATE_COUNT - 1)
+});
+
+// ../../packages/types/src/referral-dashboard.ts
+import { z as z49 } from "zod";
+var REFERRAL_DASHBOARD_RAW_STATUSES = [
+  "ACTIVE",
+  "PENDING",
+  "GRACE",
+  "CANCELLED",
+  "EXPIRED"
+];
+var REFERRAL_DASHBOARD_STATES = [
+  "active",
+  "pending",
+  "inactive",
+  "no_plan"
+];
+var REFERRAL_DASHBOARD_PLAN_KINDS = [
+  "current",
+  "last",
+  "none"
+];
+var ReferralDashboardRawStatusSchema = z49.enum(REFERRAL_DASHBOARD_RAW_STATUSES);
+var ReferralDashboardStateSchema = z49.enum(REFERRAL_DASHBOARD_STATES);
+var ReferralDashboardPlanKindSchema = z49.enum(REFERRAL_DASHBOARD_PLAN_KINDS);
+var ReferralDashboardStatusSchema = z49.enum([
+  "all",
+  "active",
+  "pending",
+  "inactive"
+]).default("all");
+var ReferralDashboardPlanSchema = z49.string().trim().min(1).max(100).optional();
+var ReferralDashboardFiltersSchema = z49.object({
+  status: ReferralDashboardStatusSchema,
+  plan: ReferralDashboardPlanSchema
+});
+var ReferralDashboardSubscriptionSchema = z49.object({
+  planName: z49.string().nullable(),
+  planKind: ReferralDashboardPlanKindSchema,
+  rawStatus: ReferralDashboardRawStatusSchema.nullable(),
+  state: ReferralDashboardStateSchema,
+  currentPeriodEnd: z49.string().datetime({
+    offset: true
+  }).nullable(),
+  cancelAtPeriodEnd: z49.boolean()
+});
+var ReferralDashboardReferralSchema = z49.object({
+  id: z49.string().min(1),
+  registeredAt: z49.string().datetime({
+    offset: true
+  }),
+  // Kept in the response for compatibility with existing referral API clients.
+  // The referrer dashboard intentionally does not render these legacy fields.
+  expiresAt: z49.string().datetime({
+    offset: true
+  }).nullable().optional(),
+  status: z49.string().min(1).optional(),
+  referredUser: z49.object({
+    email: z49.string().nullable()
+  }),
+  subscription: ReferralDashboardSubscriptionSchema
+});
+var ReferralDashboardReferralsPageSchema = z49.object({
+  referrals: z49.array(ReferralDashboardReferralSchema),
+  total: z49.number().int().nonnegative()
+});
+var ReferralDashboardPlanBreakdownSchema = z49.object({
+  planName: z49.string().nullable(),
+  count: z49.number().int().nonnegative()
+});
+var ReferralDashboardMonthlyRegistrationSchema = z49.object({
+  month: z49.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/),
+  count: z49.number().int().nonnegative()
+});
+var ReferralDashboardOverviewSchema = z49.object({
+  totalReferredUsers: z49.number().int().nonnegative(),
+  activeUsers: z49.number().int().nonnegative(),
+  pendingUsers: z49.number().int().nonnegative(),
+  inactiveUsers: z49.number().int().nonnegative(),
+  noPlanUsers: z49.number().int().nonnegative(),
+  planBreakdown: z49.array(ReferralDashboardPlanBreakdownSchema),
+  monthlyRegistrations: z49.array(ReferralDashboardMonthlyRegistrationSchema).refine((months) => months.length === 6, "Expected six monthly registration buckets")
+});
+
+// src/tools/tasks.ts
+import { z as z51 } from "zod";
+
+// src/resolve-image.ts
+import { lookup as dnsLookup } from "dns/promises";
+import { promises as fs, createReadStream } from "fs";
+import * as path from "path";
+import * as os from "os";
+var MAX_BYTES = 20 * 1024 * 1024;
+var IMAGE_FORMATS = [
+  {
+    mime: "image/jpeg",
+    exts: [
+      ".jpg",
+      ".jpeg"
+    ]
+  },
+  {
+    mime: "image/png",
+    exts: [
+      ".png"
+    ]
+  },
+  {
+    mime: "image/webp",
+    exts: [
+      ".webp"
+    ]
+  }
+];
+var ALLOWED_MIMES = new Set(IMAGE_FORMATS.map((f) => f.mime));
+var ALLOWED_EXTS = new Set(IMAGE_FORMATS.flatMap((f) => f.exts));
+var ResolveImageError = class extends Error {
+  static {
+    __name(this, "ResolveImageError");
+  }
+  code;
+  constructor(code, message) {
+    super(message), this.code = code;
+    this.name = "ResolveImageError";
+  }
+};
+function sniffMime(buf) {
+  if (buf.length < 4) return null;
+  if (buf.readUInt8(0) === 137 && buf.readUInt8(1) === 80 && buf.readUInt8(2) === 78 && buf.readUInt8(3) === 71) return "image/png";
+  if (buf.readUInt8(0) === 255 && buf.readUInt8(1) === 216 && buf.readUInt8(2) === 255) return "image/jpeg";
+  if (buf.length < 12) return null;
+  if (buf.readUInt8(0) === 82 && buf.readUInt8(1) === 73 && buf.readUInt8(2) === 70 && buf.readUInt8(3) === 70 && buf.readUInt8(8) === 87 && buf.readUInt8(9) === 69 && buf.readUInt8(10) === 66 && buf.readUInt8(11) === 80) return "image/webp";
+  return null;
+}
+__name(sniffMime, "sniffMime");
+function isPrivateHost(host) {
+  if (host === "localhost" || host === "0.0.0.0") return true;
+  if (host === "metadata.google.internal" || host === "169.254.169.254") return true;
+  if (/^127\./.test(host)) return true;
+  if (/^10\./.test(host)) return true;
+  if (/^192\.168\./.test(host)) return true;
+  if (/^172\.(1[6-9]|2\d|3[0-1])\./.test(host)) return true;
+  if (host.startsWith("169.254.")) return true;
+  if (host === "[::1]" || host === "::1") return true;
+  if (/^\[?0*:(?:0*:){6}0*1\]?$/i.test(host)) return true;
+  const ipv4Mapped = host.match(/^\[?::ffff:([0-9a-f.:]+)\]?$/i);
+  if (ipv4Mapped && ipv4Mapped[1]) {
+    const inner = ipv4Mapped[1];
+    if (inner.includes(".")) return isPrivateHost(inner);
+    const parts = inner.split(":").map((h) => parseInt(h, 16));
+    if (parts.length === 2 && parts.every((n) => !Number.isNaN(n))) {
+      const bytes = [
+        parts[0] >> 8,
+        parts[0] & 255,
+        parts[1] >> 8,
+        parts[1] & 255
+      ];
+      return isPrivateHost(bytes.join("."));
+    }
+  }
+  if (/^\[?f[cd][0-9a-f]{2}:/i.test(host)) return true;
+  if (/^\[?fe[89ab][0-9a-f]:/i.test(host)) return true;
+  return false;
+}
+__name(isPrivateHost, "isPrivateHost");
+async function assertHostResolvesPublic(hostname) {
+  let records;
+  try {
+    records = await dnsLookup(hostname, {
+      all: true
+    });
+  } catch {
+    if (process.env.NODE_ENV === "test" || process.env.VITEST) return;
+    throw new ResolveImageError("INVALID_INPUT", `imageUrl DNS lookup failed for ${hostname}`);
+  }
+  for (const { address } of records) {
+    if (isPrivateHost(address)) {
+      throw new ResolveImageError("INVALID_INPUT", `imageUrl host resolves to a private address (${address})`);
+    }
+  }
+}
+__name(assertHostResolvesPublic, "assertHostResolvesPublic");
+function expandUserPath(raw) {
+  let s = raw.trim();
+  if (s === "~") return os.homedir();
+  if (s.startsWith("~/") || s.startsWith("~\\")) s = path.join(os.homedir(), s.slice(2));
+  s = s.replace(/^\$HOME(?=$|[/\\])/, os.homedir());
+  s = s.replace(/^%USERPROFILE%(?=$|[/\\])/i, os.homedir());
+  return s;
+}
+__name(expandUserPath, "expandUserPath");
+async function readFileWithCap(absPath, max) {
+  const chunks = [];
+  let total = 0;
+  let exceeded = false;
+  const stream = createReadStream(absPath);
+  try {
+    for await (const chunk of stream) {
+      total += chunk.length;
+      if (total > max) {
+        exceeded = true;
+        break;
+      }
+      chunks.push(chunk);
+    }
+  } catch (e) {
+    const code = e.code;
+    if (code === "ENOENT") throw new ResolveImageError("IMAGE_PATH_NOT_FOUND", "file disappeared during read");
+    if (code === "EACCES" || code === "EPERM") throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `cannot read file (${code})`);
+    throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", e.message);
+  } finally {
+    if (!stream.destroyed) stream.destroy();
+  }
+  if (exceeded) throw new ResolveImageError("IMAGE_TOO_LARGE", `file exceeds ${max} bytes`);
+  return Buffer.concat(chunks, total);
+}
+__name(readFileWithCap, "readFileWithCap");
+async function resolvePath(rawPath) {
+  const expanded = expandUserPath(rawPath);
+  const abs = path.resolve(expanded);
+  const ext = path.extname(abs).toLowerCase();
+  if (!ALLOWED_EXTS.has(ext)) {
+    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `path extension ${ext || "(none)"} is not in the image allowlist (.jpg .jpeg .png .webp)`);
+  }
+  let stat;
+  try {
+    stat = await fs.stat(abs);
+  } catch (e) {
+    const code = e.code;
+    if (code === "ENOENT") {
+      throw new ResolveImageError("IMAGE_PATH_NOT_FOUND", `no such file: ${abs}`);
+    }
+    if (code === "EACCES" || code === "EPERM") {
+      throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `cannot access ${abs} (${code})`);
+    }
+    throw new ResolveImageError("IMAGE_PATH_NOT_READABLE", `stat failed: ${e.message}`);
+  }
+  if (!stat.isFile()) {
+    throw new ResolveImageError("IMAGE_PATH_NOT_A_FILE", `${abs} is not a regular file`);
+  }
+  if (stat.size > MAX_BYTES) {
+    throw new ResolveImageError("IMAGE_TOO_LARGE", `${stat.size} bytes (cap ${MAX_BYTES})`);
+  }
+  const buf = await readFileWithCap(abs, MAX_BYTES);
+  const sniffed = sniffMime(buf);
+  if (!sniffed) {
+    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `magic bytes do not match PNG/JPEG/WEBP for ${abs}`);
+  }
+  return {
+    buffer: buf,
+    mimetype: sniffed
+  };
+}
+__name(resolvePath, "resolvePath");
+async function resolveImageUrl(rawUrl) {
+  let u;
+  try {
+    u = new URL(rawUrl);
+  } catch {
+    throw new ResolveImageError("INVALID_INPUT", "imageUrl is not a valid URL");
+  }
+  if (u.protocol !== "https:") throw new ResolveImageError("INVALID_INPUT", "imageUrl must be HTTPS");
+  if (isPrivateHost(u.hostname)) throw new ResolveImageError("INVALID_INPUT", "imageUrl host not allowed");
+  await assertHostResolvesPublic(u.hostname);
+  let res;
+  try {
+    res = await fetch(rawUrl, {
+      signal: AbortSignal.timeout(3e4),
+      redirect: "error"
+    });
+  } catch (e) {
+    throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", e.message);
+  }
+  if (!res.ok) throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", `HTTP ${res.status}`);
+  const cl = res.headers.get("content-length");
+  if (cl && Number(cl) > MAX_BYTES) {
+    throw new ResolveImageError("IMAGE_TOO_LARGE", `content-length ${cl}`);
+  }
+  const ct = (res.headers.get("content-type") ?? "").split(";")[0]?.trim() ?? "";
+  if (!ALLOWED_MIMES.has(ct)) throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `content-type ${ct}`);
+  let buf;
+  try {
+    buf = Buffer.from(await readResponseBytes(res, MAX_BYTES));
+  } catch (error) {
+    if (error instanceof ResponseBodyTooLargeError) {
+      throw new ResolveImageError("IMAGE_TOO_LARGE", `image URL exceeds ${MAX_BYTES} bytes`);
+    }
+    throw new ResolveImageError("IMAGE_DOWNLOAD_FAILED", "image response could not be read");
+  }
+  const sniffed = sniffMime(buf);
+  if (!sniffed || sniffed !== ct) {
+    throw new ResolveImageError("IMAGE_TYPE_UNSUPPORTED", `magic bytes (${sniffed ?? "unknown"}) do not match content-type (${ct})`);
+  }
+  return {
+    buffer: buf,
+    mimetype: sniffed
+  };
 }
-__name(toLegacyCapabilityCatalog, "toLegacyCapabilityCatalog");
-var PRODUCTMAKER_MCP_CAPABILITIES = toLegacyCapabilityCatalog(PRODUCTMAKER_MCP_CAPABILITY_REGISTRY);
-var PRODUCTMAKER_MCP_CAPABILITY_NAMES = PRODUCTMAKER_MCP_CAPABILITY_REGISTRY.map((capability) => capability.name);
+__name(resolveImageUrl, "resolveImageUrl");
+async function resolveImages(images, opts = {
+  transport: "http"
+}) {
+  if (!images.length) throw new ResolveImageError("INVALID_INPUT", "images: at least one entry required");
+  if (images.length > 5) throw new ResolveImageError("INVALID_INPUT", "images: max 5 per request");
+  return Promise.all(images.map((ref) => resolveOne(ref, opts.transport)));
+}
+__name(resolveImages, "resolveImages");
+async function resolveOne(ref, transport) {
+  const hasUrl = Boolean(ref.url);
+  const hasPath = Boolean(ref.path);
+  if (hasUrl === hasPath) {
+    throw new ResolveImageError("INVALID_INPUT", "each image entry must have exactly one of `url` or `path`");
+  }
+  if (hasPath) {
+    if (transport === "http") {
+      throw new ResolveImageError("PATH_NOT_SUPPORTED_IN_HTTP_MODE", "Local file paths are only available when running the MCP locally (npm). For the hosted endpoint at mcp.productmaker.app, pass a public HTTPS `url` instead, or ask the user to host the photo first.");
+    }
+    return resolvePath(ref.path);
+  }
+  return resolveImageUrl(ref.url);
+}
+__name(resolveOne, "resolveOne");
 
-// ../../packages/types/src/actor.ts
-import { z as z48 } from "zod";
-var ActorStatusSchema = z48.enum([
-  "draft",
-  "generating",
-  "ready",
-  "failed"
-]);
-var ACTOR_NAME_MAX_CHARS = 60;
-var ACTOR_DESCRIPTION_MAX_CHARS = 600;
-var ACTOR_CANDIDATE_COUNT = 4;
-var ActorGenderSchema = z48.enum([
-  "female",
-  "male",
-  "non_binary"
+// src/status-poller.ts
+var TERMINAL = /* @__PURE__ */ new Set([
+  "done",
+  "complete",
+  "error"
 ]);
-var ActorSchema = z48.object({
-  id: z48.string(),
-  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS),
-  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS),
-  gender: ActorGenderSchema,
-  voiceId: z48.string().nullable().optional(),
-  brandId: z48.string().nullable().optional(),
-  status: ActorStatusSchema,
-  /**
-  * A candidate-grid run is in flight RIGHT NOW.
-  *
-  * Separate from `status` because the two answer different questions:
-  * `status` is the PUBLISHED state (a personaje being regenerated stays
-  * `ready`, so it keeps serving the renders that already reference it), and
-  * this flag is the live one the wizard polls. It is derived from a lock
-  * timestamp with a TTL, so an orphaned run reads as `false` instead of
-  * pinning the personaje forever.
-  */
-  generating: z48.boolean().optional(),
-  photoUrl: z48.string().url().nullable().optional(),
-  avatarUrl: z48.string().url().nullable().optional(),
-  candidateUrls: z48.array(z48.string().url()).optional(),
-  /** Indices of candidateUrls that failed the anatomy check (Task 6). */
-  flaggedCandidateIndices: z48.array(z48.number().int()).optional()
-});
-var CreateActorRequest = z48.object({
-  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS),
-  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS).default(""),
-  gender: ActorGenderSchema,
-  voiceId: z48.string().optional(),
-  brandId: z48.string().optional(),
-  sourcePhotoKey: z48.string().optional()
-}).refine((v) => v.description.trim().length > 0 || !!v.sourcePhotoKey, {
-  message: "Se necesita una descripci\xF3n o una foto"
-});
-var UpdateActorRequest = z48.object({
-  name: z48.string().min(1).max(ACTOR_NAME_MAX_CHARS).optional(),
-  description: z48.string().max(ACTOR_DESCRIPTION_MAX_CHARS).optional(),
-  gender: ActorGenderSchema.optional(),
-  voiceId: z48.string().nullable().optional(),
-  brandId: z48.string().nullable().optional()
-});
-var ApproveActorRequest = z48.object({
-  candidateIndex: z48.number().int().min(0).max(ACTOR_CANDIDATE_COUNT - 1)
-});
+async function pollStatus(fetcher, waitSeconds, signal, opts = {}) {
+  const intervalMs = opts.intervalMs ?? 3e3;
+  const maxWait = opts.maxWaitSeconds ?? 120;
+  const effective = Math.min(Math.max(0, waitSeconds), maxWait);
+  let snapshot = await fetcher();
+  if (effective === 0) return snapshot;
+  if (TERMINAL.has(snapshot.status) || snapshot.status === "awaiting_review" || snapshot.pendingUserAction != null) return snapshot;
+  const deadline = Date.now() + effective * 1e3;
+  while (Date.now() < deadline) {
+    if (signal?.aborted) throw new Error("aborted");
+    await sleep(intervalMs, signal);
+    const next = await fetcher();
+    if (next.status !== snapshot.status || next.phase !== snapshot.phase || TERMINAL.has(next.status) || next.status === "awaiting_review" || next.pendingUserAction != null) {
+      return next;
+    }
+    snapshot = next;
+  }
+  return snapshot;
+}
+__name(pollStatus, "pollStatus");
+function sleep(ms, signal) {
+  return new Promise((resolve3, reject) => {
+    const onAbort = /* @__PURE__ */ __name(() => {
+      clearTimeout(t);
+      reject(new Error("aborted"));
+    }, "onAbort");
+    const t = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve3();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, {
+      once: true
+    });
+  });
+}
+__name(sleep, "sleep");
 
-// ../../packages/types/src/referral-dashboard.ts
-import { z as z49 } from "zod";
-var REFERRAL_DASHBOARD_RAW_STATUSES = [
-  "ACTIVE",
-  "PENDING",
-  "GRACE",
-  "CANCELLED",
-  "EXPIRED"
-];
-var REFERRAL_DASHBOARD_STATES = [
-  "active",
-  "pending",
-  "inactive",
-  "no_plan"
-];
-var REFERRAL_DASHBOARD_PLAN_KINDS = [
-  "current",
-  "last",
-  "none"
-];
-var ReferralDashboardRawStatusSchema = z49.enum(REFERRAL_DASHBOARD_RAW_STATUSES);
-var ReferralDashboardStateSchema = z49.enum(REFERRAL_DASHBOARD_STATES);
-var ReferralDashboardPlanKindSchema = z49.enum(REFERRAL_DASHBOARD_PLAN_KINDS);
-var ReferralDashboardStatusSchema = z49.enum([
-  "all",
-  "active",
-  "pending",
-  "inactive"
-]).default("all");
-var ReferralDashboardPlanSchema = z49.string().trim().min(1).max(100).optional();
-var ReferralDashboardFiltersSchema = z49.object({
-  status: ReferralDashboardStatusSchema,
-  plan: ReferralDashboardPlanSchema
-});
-var ReferralDashboardSubscriptionSchema = z49.object({
-  planName: z49.string().nullable(),
-  planKind: ReferralDashboardPlanKindSchema,
-  rawStatus: ReferralDashboardRawStatusSchema.nullable(),
-  state: ReferralDashboardStateSchema,
-  currentPeriodEnd: z49.string().datetime({
-    offset: true
-  }).nullable(),
-  cancelAtPeriodEnd: z49.boolean()
-});
-var ReferralDashboardReferralSchema = z49.object({
-  id: z49.string().min(1),
-  registeredAt: z49.string().datetime({
-    offset: true
-  }),
-  // Kept in the response for compatibility with existing referral API clients.
-  // The referrer dashboard intentionally does not render these legacy fields.
-  expiresAt: z49.string().datetime({
-    offset: true
-  }).nullable().optional(),
-  status: z49.string().min(1).optional(),
-  referredUser: z49.object({
-    email: z49.string().nullable()
-  }),
-  subscription: ReferralDashboardSubscriptionSchema
-});
-var ReferralDashboardReferralsPageSchema = z49.object({
-  referrals: z49.array(ReferralDashboardReferralSchema),
-  total: z49.number().int().nonnegative()
-});
-var ReferralDashboardPlanBreakdownSchema = z49.object({
-  planName: z49.string().nullable(),
-  count: z49.number().int().nonnegative()
-});
-var ReferralDashboardMonthlyRegistrationSchema = z49.object({
-  month: z49.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/),
-  count: z49.number().int().nonnegative()
-});
-var ReferralDashboardOverviewSchema = z49.object({
-  totalReferredUsers: z49.number().int().nonnegative(),
-  activeUsers: z49.number().int().nonnegative(),
-  pendingUsers: z49.number().int().nonnegative(),
-  inactiveUsers: z49.number().int().nonnegative(),
-  noPlanUsers: z49.number().int().nonnegative(),
-  planBreakdown: z49.array(ReferralDashboardPlanBreakdownSchema),
-  monthlyRegistrations: z49.array(ReferralDashboardMonthlyRegistrationSchema).refine((months) => months.length === 6, "Expected six monthly registration buckets")
-});
+// src/errors.ts
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 
 // src/resolve-media.ts
+import { lookup as dnsLookup2 } from "dns/promises";
+import { promises as fs2, createReadStream as createReadStream2 } from "fs";
+import * as os2 from "os";
+import * as path2 from "path";
 var MAX_MEDIA_BYTES = CAMPAIGN_LIMITS.MAX_FILE_SIZE_BYTES;
 var MEDIA_FORMATS = [
   {
@@ -13040,6 +13725,21 @@ ${summary}`,
 __name(requirePaidCreativeConfirmation, "requirePaidCreativeConfirmation");
 
 // src/tools/tasks.ts
+var createProductTaskGuidance = getProductMakerCapabilityModelGuidance("create_product_task");
+function renderCreateProductTaskDefaultForMcp(fragment) {
+  const outputs = fragment.match(/genera (landing), (video) e (imágenes creativas)/u);
+  return outputs ? `Por defecto genera ${outputs[1]} + ${outputs[2]} + im\xE1genes en UN MISMO TASK.` : fragment;
+}
+__name(renderCreateProductTaskDefaultForMcp, "renderCreateProductTaskDefaultForMcp");
+function renderCreateProductTaskAvoidWhenForMcp(fragment) {
+  return /un solo entregable/u.test(fragment) ? "Para 1 solo output, usa generate_landing / generate_video_creative / generate_image_creatives." : fragment;
+}
+__name(renderCreateProductTaskAvoidWhenForMcp, "renderCreateProductTaskAvoidWhenForMcp");
+var createProductTaskDefaultDescription = renderCreateProductTaskDefaultForMcp(createProductTaskGuidance.defaults[0]);
+var createProductTaskSingleOutputDescription = renderCreateProductTaskAvoidWhenForMcp(createProductTaskGuidance.avoidWhen[0]);
+var createServiceVideoGuidance = getProductMakerCapabilityModelGuidance("create_service_video");
+var listTasksGuidance = getProductMakerCapabilityModelGuidance("list_tasks");
+var editTaskDraftGuidance = getProductMakerCapabilityModelGuidance("edit_task_draft");
 var CreateProductTaskInput = z51.object({
   images: ImagesInput.optional().describe("1\u20135 fotos del mismo producto. Omitir \xFAnicamente cuando projectId apunta a un proyecto propio con imagen guardada."),
   projectId: z51.string().uuid().optional().describe("Opcional. Proyecto guiado propio. Permite continuar sin volver a subir la imagen guardada; nunca evita cr\xE9ditos, cuotas ni confirmaciones."),
@@ -13067,8 +13767,9 @@ var CreateProductTaskInput = z51.object({
     "landing",
     "video",
     "image"
-  ])).min(2).max(3).optional().describe('Opcional. Qu\xE9 outputs generar. Default: todos ["landing","video","image"]. Para 2 outputs: ["landing","image"] (sin video), ["video","image"] (sin landing), ["landing","video"] (sin imagen). Para 1 solo output, usa generate_landing / generate_video_creative / generate_image_creatives.'),
+  ])).min(2).max(3).optional().describe(`Opcional. Qu\xE9 outputs generar. Default: todos ["landing","video","image"]. Para 2 outputs: ["landing","image"] (sin video), ["video","image"] (sin landing), ["landing","video"] (sin imagen). ${createProductTaskSingleOutputDescription}`),
   competitorScanEnabled: z51.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
+  replicateWinnerWhenFound: z51.boolean().optional().describe('Opcional. Consentimiento para que, si encontramos un anuncio GANADOR de la competencia que podemos replicar, ese ganador reemplace la narrativa concreta que el usuario eligi\xF3 (videoPreset). Default true: la r\xE9plica del ganador es el formato que mejor convierte y sigue ganando por defecto. P\xE1salo en false SOLO si el usuario dice expl\xEDcitamente que quiere conservar su estilo elegido pase lo que pase (ej. pidi\xF3 Pixar y quiere Pixar aunque haya un ganador live-action). Irrelevante cuando videoPreset es "auto" (no hay elecci\xF3n que respetar) o cuando competitorScanEnabled es false (nunca habr\xE1 ganador).'),
   brandId: z51.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer los outputs generados."),
   actorId: z51.string().trim().min(1).optional().describe("Opcional. ID de un personaje guardado (usa list_actors para verlos). Si lo env\xEDas, su foto y su voz mandan sobre la descripci\xF3n de texto."),
   creativeDirection: z51.string().max(500).optional().describe('Opcional. Direcci\xF3n creativa en texto libre (colores, mood, estilo) que aplica a los outputs de IMAGEN y LANDING (no al video \u2014 el estilo/ambiente del video se dirige con scriptNotes). M\xC1XIMA PRIORIDAD: anula marca, colores y estilo por defecto. Ej. "amarillo y azul, minimalista". M\xE1x 500 caracteres.'),
@@ -13452,7 +14153,11 @@ function resolveServicePanelEdits(panels, editsByBeat, editsByScene, fieldLabel)
 }
 __name(resolveServicePanelEdits, "resolveServicePanelEdits");
 function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http" } = {}) {
-  server.tool("create_product_task", "Crea una tarea autopilot combinada. Por defecto genera landing + video + im\xE1genes en UN MISMO TASK; \xFAsala cuando el usuario pide todo o varios outputs, no creando tareas individuales. Usa images para solicitudes directas. Usa projectId \xFAnicamente si el usuario pidi\xF3 expl\xEDcitamente continuar el proyecto guiado que acaba de costear; nunca busques, infieras ni menciones proyectos previos.\n\nREQUERIDOS: images o projectId expl\xEDcito, language y country. Cuando los outputs incluyen video (tambi\xE9n por default), pregunta SIEMPRE videoAngleCount: 1, 2 o 3; es una decisi\xF3n de costo incluso con aiDecidesAll. Si falta una foto local, llama primero `request_media_upload`. Pregunta price, offer, paymentMethods y compareAtPrice cuando aplique; nunca asumas country/language.\n\nANTES de invocar, resume outputs, cantidad de videos y datos comerciales, explica que inicia trabajo pagado y espera confirmaci\xF3n expl\xEDcita. aiDecidesAll omitido/false pausa para reviews conversacionales; muestra todos los \xE1ngulos candidatos y permite escoger/editar hasta el m\xE1ximo autorizado. Usa aiDecidesAll=true s\xF3lo si el usuario pidi\xF3 \u201Cdecide todo\u201D o \u201Cno me preguntes\u201D.", CreateProductTaskInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("create_product_task", createProductTaskGuidance.summary + ` ${createProductTaskDefaultDescription} \xDAsala cuando el usuario pide todo o varios outputs, no creando tareas individuales. Usa images para solicitudes directas. Usa projectId \xFAnicamente si el usuario pidi\xF3 expl\xEDcitamente continuar el proyecto guiado que acaba de costear; nunca busques, infieras ni menciones proyectos previos.
+
+REQUERIDOS: images o projectId expl\xEDcito, language y country. Cuando los outputs incluyen video (tambi\xE9n por default), pregunta SIEMPRE videoAngleCount: 1, 2 o 3; es una decisi\xF3n de costo incluso con aiDecidesAll. Si falta una foto local, llama primero \`request_media_upload\`. Pregunta price, offer, paymentMethods y compareAtPrice cuando aplique; nunca asumas country/language.
+
+ANTES de invocar, resume outputs, cantidad de videos y datos comerciales, explica que inicia trabajo pagado y espera confirmaci\xF3n expl\xEDcita. aiDecidesAll omitido/false pausa para reviews conversacionales; muestra todos los \xE1ngulos candidatos y permite escoger/editar hasta el m\xE1ximo autorizado. Usa aiDecidesAll=true s\xF3lo si el usuario pidi\xF3 \u201Cdecide todo\u201D o \u201Cno me preguntes\u201D.`, CreateProductTaskInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const selectedOutputs = input.outputs ?? DEFAULT_PRODUCT_TASK_OUTPUTS;
       if (!input.images && !input.projectId) {
@@ -13503,6 +14208,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
           "options.angleNarratives": input.angleNarratives,
           "options.selectedOutputs": input.outputs,
           "options.competitorScanEnabled": input.competitorScanEnabled,
+          "options.replicateWinnerWhenFound": input.replicateWinnerWhenFound,
           "options.brandId": input.brandId,
           "options.actorId": input.actorId,
           "options.creativeDirection": input.creativeDirection,
@@ -13532,7 +14238,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("create_service_video", "Crea un video para un servicio desde su landing. Esta acci\xF3n consume cr\xE9ditos: confirma la intenci\xF3n del usuario antes de llamarla. `automatic` genera directamente; `guided` devuelve conceptos para que el usuario apruebe uno mediante `resolve_pending_action`. La web tambi\xE9n acepta demos y anuncios de referencia; el transporte MCP de video adjunto todav\xEDa falla cerrado hasta poder subir bytes de forma segura.", CreateServiceVideoInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("create_service_video", createServiceVideoGuidance.summary + " Esta acci\xF3n consume cr\xE9ditos: confirma la intenci\xF3n del usuario antes de llamarla. `automatic` genera directamente; `guided` devuelve conceptos para que el usuario apruebe uno mediante `resolve_pending_action`. La web tambi\xE9n acepta demos y anuncios de referencia; el transporte MCP de video adjunto todav\xEDa falla cerrado hasta poder subir bytes de forma segura.", CreateServiceVideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       await requirePaidCreativeConfirmation(server, `Video de servicio en ${input.language}. Modo: ${input.reviewMode === "automatic" ? "la IA decide todo" : "reviews conversacionales"}.`);
       const created = await api.postJson("/v2/ingest", {
@@ -13658,7 +14364,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("list_tasks", "Lista de forma read-only las tareas recientes del usuario. \xDAsala para encontrar una tarea previa por nombre o revisar el historial antes de pedir un taskId. Soporta paginaci\xF3n con limit/offset y filtro de texto. No crea, reanuda ni modifica tareas.", ListTasksInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("list_tasks", listTasksGuidance.summary + " \xDAsala para encontrar una tarea previa por nombre o revisar el historial antes de pedir un taskId. Soporta paginaci\xF3n con limit/offset y filtro de texto. No crea, reanuda ni modifica tareas.", ListTasksInput.shape, READS_INTERNAL, async (input) => {
     try {
       const qs = new URLSearchParams();
       if (input.limit != null) qs.set("limit", String(input.limit));
@@ -13671,7 +14377,7 @@ function registerTaskTools(server, api, { proxyBaseUrl = null, transport = "http
       throw translateError(e);
     }
   });
-  server.tool("edit_task_draft", "Edita el draft de un angle de marketing antes de la generaci\xF3n. Campos editables: angle (texto del angle), buyerPersona, actor (descripci\xF3n del personaje), actorId (ID de un personaje guardado; usa list_actors), gender (female|male), scriptNotes. Use this only before generation completes. Editing already-generated images or videos is not supported.", EditTaskDraftInput.shape, OVERWRITES_INTERNAL, async (input) => {
+  server.tool("edit_task_draft", editTaskDraftGuidance.summary + " Campos editables: angle (texto del angle), buyerPersona, actor (descripci\xF3n del personaje), actorId (ID de un personaje guardado; usa list_actors), gender (female|male), scriptNotes. Use this only before generation completes. Editing already-generated images or videos is not supported.", EditTaskDraftInput.shape, OVERWRITES_INTERNAL, async (input) => {
     try {
       const angle = await api.patchJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/angles/${input.angleIndex}`, input.angle ?? {});
       return asText({
@@ -14055,6 +14761,11 @@ __name(registerTaskTools, "registerTaskTools");
 // src/tools/creatives.ts
 import { randomUUID } from "crypto";
 import { z as z52 } from "zod";
+var generateFreeVideoGuidance = getProductMakerCapabilityModelGuidance("generate_free_video");
+var generateVideoCreativeGuidance = getProductMakerCapabilityModelGuidance("generate_video_creative");
+var generateImageCreativesGuidance = getProductMakerCapabilityModelGuidance("generate_image_creatives");
+var editImageCreativeGuidance = getProductMakerCapabilityModelGuidance("edit_image_creative");
+var generateLandingGuidance = getProductMakerCapabilityModelGuidance("generate_landing");
 var CreativeRefs = {
   images: ImagesInput,
   language: Lang.describe('Idioma del contenido. Ej. "es", "en", "pt". REQUERIDO \u2014 si el usuario no lo dijo, PREG\xDANTALE antes de invocar. NUNCA infieras desde el contexto del chat ni asumas un default.'),
@@ -14066,6 +14777,7 @@ var CreativeRefs = {
   productLabel: z52.string().trim().max(80).optional().describe('Opcional. Nombre o tipo del producto en pocas palabras (ej. "collar de oro", "quita pelusas para ropa"). Es AUTORITATIVO: la IA usa esta identidad y no la reemplaza por otra categor\xEDa. Si lo omites, la IA lo detecta desde la imagen. NO salta la extracci\xF3n.'),
   buyerPersona: z52.string().optional().describe('Opcional. Descripci\xF3n del comprador objetivo. Ej. "Mujeres 35-50, profesionales urbanas". Si se omite, la IA infiere desde el \xE1ngulo y producto.'),
   isCombo: z52.boolean().optional().describe("Opcional. Si true, el creativo presenta el producto como combo/pack. Default false."),
+  replicateWinnerWhenFound: z52.boolean().optional().describe('Opcional. Consentimiento para que, si encontramos un anuncio GANADOR de la competencia que podemos replicar, ese ganador reemplace la narrativa concreta que el usuario eligi\xF3 (videoPreset). Default true: la r\xE9plica del ganador es el formato que mejor convierte y sigue ganando por defecto. P\xE1salo en false SOLO si el usuario dice expl\xEDcitamente que quiere conservar su estilo elegido pase lo que pase (ej. pidi\xF3 Pixar y quiere Pixar aunque haya un ganador live-action). Irrelevante cuando videoPreset es "auto" (no hay elecci\xF3n que respetar) o cuando competitorScanEnabled es false (nunca habr\xE1 ganador).'),
   competitorScanEnabled: z52.boolean().optional().describe("Opcional. Si true (default), el sistema analiza ads de competencia en Meta Ad Library y enriquece los \xE1ngulos generados con hooks y painPoints validados por el mercado (\u2248$0.20-0.48 extra por task \u2014 var\xEDa con cu\xE1ntas transcripciones de video se capturen). Si false, el pipeline genera \xE1ngulos sin esa se\xF1al \u2014 usa esto SOLO si el usuario ya tiene su propia investigaci\xF3n de mercado o quiere ahorrar costos en productos muy nicho sin presencia en Meta. Default true."),
   brandId: z52.string().uuid().optional().describe("Opcional. ID de una marca del usuario; si se env\xEDa, el sistema usa su voz, colores y persona para enriquecer el creativo.")
 };
@@ -14121,6 +14833,7 @@ var VideoInput = z52.object({
   cta: z52.string().optional().describe('Opcional. Call-to-action final del video. Ej. "Compra ahora", "Pide el tuyo hoy", "Link en bio". Si se omite, la IA escribe uno.'),
   scriptNotes: z52.string().optional().describe('Opcional. Notas/restricciones para el guion (la IA las usa al redactar). Ej. "No mencionar la marca X", "Tono divertido, no cl\xEDnico", "Mencionar 2x1". NO es el guion literal: creativeSetup.mode=guided activa siempre la revisi\xF3n palabra-por-palabra con get_video_script / approve_video_script.'),
   competitorScanEnabled: CreativeRefs.competitorScanEnabled,
+  replicateWinnerWhenFound: CreativeRefs.replicateWinnerWhenFound,
   brandId: CreativeRefs.brandId
 }).strict();
 var FreeVideoQualityEnum = z52.enum([
@@ -14334,7 +15047,7 @@ function resolveLandingSetup(setup) {
 }
 __name(resolveLandingSetup, "resolveLandingSetup");
 function registerCreativeTools(server, api, { transport = "http" } = {}) {
-  server.tool("generate_free_video", 'Genera UN video libre con prompt/guion exacto, opcionalmente con imagen de referencia. Si el usuario adjunta o menciona una imagen local, llama primero request_media_upload con mediaKind=image y usa el assetId devuelto; no pidas path ni URL. Devuelve un taskId y procesa el job de forma as\xEDncrona.\n\nREQUERIDOS: rawPrompt, quality, durationSeconds y videoResolution.\n\nCALIDAD: "economical" = Econ\xF3mico y "high_detail" = Alto detalle. La duraci\xF3n debe pertenecer a la lista admitida por la calidad escogida; si el usuario pide otra, preg\xFAntale una duraci\xF3n v\xE1lida.\n\nSUBT\xCDTULOS: si addSubtitles=true, el rawPrompt completo se usa como texto exacto de subt\xEDtulos y debe tener m\xE1ximo 500 caracteres; no existe una pregunta adicional de transcripci\xF3n.\n\nPara videos normales con narrativa/\xE1ngulo usa generate_video_creative. Para tareas combinadas de producto usa create_product_task.', FreeVideoInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("generate_free_video", generateFreeVideoGuidance.summary + ' Si el usuario adjunta o menciona una imagen local, llama primero request_media_upload con mediaKind=image y usa el assetId devuelto; no pidas path ni URL. Devuelve un taskId y procesa el job de forma as\xEDncrona.\n\nREQUERIDOS: rawPrompt, quality, durationSeconds y videoResolution.\n\nCALIDAD: "economical" = Econ\xF3mico y "high_detail" = Alto detalle. La duraci\xF3n debe pertenecer a la lista admitida por la calidad escogida; si el usuario pide otra, preg\xFAntale una duraci\xF3n v\xE1lida.\n\nSUBT\xCDTULOS: si addSubtitles=true, el rawPrompt completo se usa como texto exacto de subt\xEDtulos y debe tener m\xE1ximo 500 caracteres; no existe una pregunta adicional de transcripci\xF3n.\n\nPara videos normales con narrativa/\xE1ngulo usa generate_video_creative. Para tareas combinadas de producto usa create_product_task.', FreeVideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const allowedDurations = FREE_VIDEO_DURATIONS_BY_QUALITY[input.quality];
       if (!allowedDurations.includes(input.durationSeconds)) {
@@ -14365,7 +15078,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("generate_video_creative", "Genera entre 1 y 3 videos creativos independientes dentro de un mismo task. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), title, primaryAngle, language, country, aspectRatio, videoAngleCount y creativeSetup. Pregunta SIEMPRE cu\xE1ntos videos quiere (1, 2 o 3): la cantidad cambia el costo y no forma parte de \u2018la IA decide todo\u2019. Si falta una foto local, llama primero `request_media_upload` y usa los assetId; no pidas path ni URL. PREGUNTA price y offer si faltan; no asumas country/language.\n\nCONFIGURACI\xD3N: salvo que el usuario diga expl\xEDcitamente que la IA decida todo, usa creativeSetup.mode=guided y pregunta narrativa, p\xFAblico comprador, presentador (actor guardado, descripci\xF3n o ninguno) y direcci\xF3n creativa. creativeDirection=null s\xF3lo despu\xE9s de que el usuario delegue esa decisi\xF3n concreta. No inventes valores de setup.\n\nANTES de invocar, muestra un resumen compacto que incluya cantidad, esas cuatro decisiones y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. 15s usa Realista; 30s usa Multiescena y se factura por escena, as\xED que avisa ese mayor costo. Advierte tambi\xE9n que, si luego el usuario confirma que las fotos son de varios productos (combo), el pipeline r\xE1pido actualmente omite la pausa de guion aunque mantiene las dem\xE1s revisiones.\n\nREVIEWS: guided muestra los \xE1ngulos candidatos y permite escoger hasta videoAngleCount, editar cada \xE1ngulo y revisar sus guiones. automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite ambas reviews. scriptNotes agrega restricciones al guion; get_video_script y approve_video_script manejan la review palabra por palabra.", VideoInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("generate_video_creative", generateVideoCreativeGuidance.summary + " Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), title, primaryAngle, language, country, aspectRatio, videoAngleCount y creativeSetup. Pregunta SIEMPRE cu\xE1ntos videos quiere (1, 2 o 3): la cantidad cambia el costo y no forma parte de \u2018la IA decide todo\u2019. Si falta una foto local, llama primero `request_media_upload` y usa los assetId; no pidas path ni URL. PREGUNTA price y offer si faltan; no asumas country/language.\n\nCONFIGURACI\xD3N: salvo que el usuario diga expl\xEDcitamente que la IA decida todo, usa creativeSetup.mode=guided y pregunta narrativa, p\xFAblico comprador, presentador (actor guardado, descripci\xF3n o ninguno) y direcci\xF3n creativa. creativeDirection=null s\xF3lo despu\xE9s de que el usuario delegue esa decisi\xF3n concreta. No inventes valores de setup.\n\nANTES de invocar, muestra un resumen compacto que incluya cantidad, esas cuatro decisiones y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. 15s usa Realista; 30s usa Multiescena y se factura por escena, as\xED que avisa ese mayor costo. Advierte tambi\xE9n que, si luego el usuario confirma que las fotos son de varios productos (combo), el pipeline r\xE1pido actualmente omite la pausa de guion aunque mantiene las dem\xE1s revisiones.\n\nREVIEWS: guided muestra los \xE1ngulos candidatos y permite escoger hasta videoAngleCount, editar cada \xE1ngulo y revisar sus guiones. automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite ambas reviews. scriptNotes agrega restricciones al guion; get_video_script y approve_video_script manejan la review palabra por palabra.", VideoInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       await requirePaidCreativeConfirmation(server, input.creativeSetup.mode === "automatic" ? `${input.videoAngleCount} video${input.videoAngleCount === 1 ? "" : "s"} de ${input.durationSeconds}s para \u201C${input.title}\u201D en ${input.country}. Configuraci\xF3n: la IA decide todo.` : `${input.videoAngleCount} video${input.videoAngleCount === 1 ? "" : "s"} de ${input.durationSeconds}s para \u201C${input.title}\u201D en ${input.country}. Narrativa: ${input.creativeSetup.videoPreset}. P\xFAblico: ${input.creativeSetup.buyerPersona}. Presentador: ${input.creativeSetup.presenter.mode}. Direcci\xF3n: ${input.creativeSetup.creativeDirection ?? "la IA decide"}. Si despu\xE9s confirmas que las fotos son de varios productos (combo), el pipeline r\xE1pido omite actualmente la pausa de revisi\xF3n del guion.`);
       const guidedSetup = input.creativeSetup.mode === "guided" ? input.creativeSetup : null;
@@ -14413,7 +15126,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("generate_image_creatives", "Genera variantes de imagen creativa. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), productTitle, language, country y creativeSetup. Si falta una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language. primaryAngle es opcional: si falta, ProductMaker lo genera y guided lo muestra para revisi\xF3n.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. No hagas un interrogatorio campo por campo: presenta UN checklist compacto con arquetipo, tratamiento visual, formato, cantidad, calidad, mezcla condicional, copy, competencia, contexto, direcci\xF3n, colores y copy exacto; propone los defaults recomendados y permite que el usuario delegue los campos con ai_decides o null donde el schema lo admite. La UI ofrece 1, 2, 3, 4 o 6 variantes: para 2\u20134 pregunta styleMix; para 1 o 6 usa null, y 6 activa autom\xE1ticamente una imagen de cada estilo. Premium 2K no admite 4:5.\n\nANTES de invocar, muestra el resumen de esas decisiones y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.", ImageInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("generate_image_creatives", generateImageCreativesGuidance.summary + " Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), productTitle, language, country y creativeSetup. Si falta una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language. primaryAngle es opcional: si falta, ProductMaker lo genera y guided lo muestra para revisi\xF3n.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. No hagas un interrogatorio campo por campo: presenta UN checklist compacto con arquetipo, tratamiento visual, formato, cantidad, calidad, mezcla condicional, copy, competencia, contexto, direcci\xF3n, colores y copy exacto; propone los defaults recomendados y permite que el usuario delegue los campos con ai_decides o null donde el schema lo admite. La UI ofrece 1, 2, 3, 4 o 6 variantes: para 2\u20134 pregunta styleMix; para 1 o 6 usa null, y 6 activa autom\xE1ticamente una imagen de cada estilo. Premium 2K no admite 4:5.\n\nANTES de invocar, muestra el resumen de esas decisiones y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.", ImageInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const guidedSetup = input.creativeSetup.mode === "guided" ? input.creativeSetup : null;
       const setupFields = guidedSetup ? resolveImageSetup(guidedSetup) : {};
@@ -14438,7 +15151,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("edit_image_creative", "Corrige UNA imagen ya generada de una tarea de creativos, sin regenerar el set completo.\n\nCUESTA CR\xC9DITOS: cobra una sola imagen (sin brief ni extracci\xF3n), mucho menos que volver a generar todo. ANTES de invocar, PREG\xDANTALE al usuario si quiere pagar esa correcci\xF3n.\n\nSolo funciona con la tarea en estado `done` \u2014 si a\xFAn est\xE1 procesando, espera con get_task_status. Una tarea en error terminal no se puede corregir.\n\nUsa variantIndex para elegir cu\xE1l de las im\xE1genes corregir (0 = la primera) e instruction para describir el cambio en lenguaje natural.", EditImageCreativeInput.shape, OVERWRITES_EXTERNAL, async (input) => {
+  server.tool("edit_image_creative", editImageCreativeGuidance.summary + "\n\nCUESTA CR\xC9DITOS: cobra una sola imagen (sin brief ni extracci\xF3n), mucho menos que volver a generar todo. ANTES de invocar, PREG\xDANTALE al usuario si quiere pagar esa correcci\xF3n.\n\nSolo funciona con la tarea en estado `done` \u2014 si a\xFAn est\xE1 procesando, espera con get_task_status. Una tarea en error terminal no se puede corregir.\n\nUsa variantIndex para elegir cu\xE1l de las im\xE1genes corregir (0 = la primera) e instruction para describir el cambio en lenguaje natural.", EditImageCreativeInput.shape, OVERWRITES_EXTERNAL, async (input) => {
     try {
       await requirePaidCreativeConfirmation(server, `Correcci\xF3n pagada de la imagen ${input.variantIndex + 1}.`);
       const r = await api.postJson(`/v1/creatives/images/${encodeURIComponent(input.taskId)}/regenerate`, {
@@ -14450,7 +15163,7 @@ function registerCreativeTools(server, api, { transport = "http" } = {}) {
       throw translateError(e);
     }
   });
-  server.tool("generate_landing", "Genera una landing page cl\xE1sica basada en im\xE1genes, lista para Shopify. No expone landing editable/code mientras siga siendo admin-only. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), language, country y creativeSetup. Ante \u201Ccrea una landing con este producto\u201D y una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. Presenta UN checklist compacto \u2014no preguntas seriales\u2014 con estrategia, formato, competencia, m\xE9todos de pago, contexto, direcci\xF3n creativa y headline/subheadline exactos opcionales. Prop\xF3n defaults recomendados; null significa que el usuario deleg\xF3 esa decisi\xF3n concreta, nunca que el agente la olvid\xF3.\n\nANTES de invocar, muestra el resumen y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.", LandingInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("generate_landing", generateLandingGuidance.summary + " No expone landing editable/code mientras siga siendo admin-only. Devuelve un taskId. Esta solicitud es directa: nunca busques, reutilices ni menciones un DropshippingProject.\n\nREQUERIDOS: images (1-5 fotos), language, country y creativeSetup. Ante \u201Ccrea una landing con este producto\u201D y una foto local, llama primero `request_media_upload` y usa los assetId. Pregunta price, offer y compareAtPrice cuando aplique; no asumas country/language.\n\nCONFIGURACI\xD3N: usa guided salvo delegaci\xF3n total expl\xEDcita. Presenta UN checklist compacto \u2014no preguntas seriales\u2014 con estrategia, formato, competencia, m\xE9todos de pago, contexto, direcci\xF3n creativa y headline/subheadline exactos opcionales. Prop\xF3n defaults recomendados; null significa que el usuario deleg\xF3 esa decisi\xF3n concreta, nunca que el agente la olvid\xF3.\n\nANTES de invocar, muestra el resumen y espera confirmaci\xF3n expl\xEDcita porque inicia trabajo pagado. guided pausa para revisar el \xE1ngulo; automatic equivale al toggle web \u201CDejar que la IA decida todo\u201D y omite la review.", LandingInput.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const guidedSetup = input.creativeSetup.mode === "guided" ? input.creativeSetup : null;
       const setupFields = guidedSetup ? resolveLandingSetup(guidedSetup) : {};
@@ -14480,6 +15193,8 @@ __name(registerCreativeTools, "registerCreativeTools");
 
 // src/tools/creative-variants.ts
 import { z as z53 } from "zod";
+var estimateCreativeVariantGuidance = getProductMakerCapabilityModelGuidance("estimate_creative_variant");
+var createCreativeVariantGuidance = getProductMakerCapabilityModelGuidance("create_creative_variant");
 var LandingSectionKeyEnum = z53.enum([
   "problem_hook",
   "problem_cost",
@@ -14707,7 +15422,7 @@ function estimatePayload(input) {
 }
 __name(estimatePayload, "estimatePayload");
 function registerCreativeVariantTools(server, api) {
-  server.tool("estimate_creative_variant", "Calcula el costo de crear una variante desde una tarea existente, sin consumir cr\xE9ditos. Usa el task origen para resolver el modelo/tier real y devuelve m\xEDnimo, m\xE1ximo, saldo y si alcanza. Para landing env\xEDa las mismas instructions/sectionKey que usar\xE1s al crear: si hay instructions sin sectionKey, el rango incluye la clasificaci\xF3n pagada con IA. Llama esto antes de create_creative_variant y muestra el rango al usuario.", EstimateCreativeVariantInputBase.shape, READS_INTERNAL, async (input) => {
+  server.tool("estimate_creative_variant", estimateCreativeVariantGuidance.summary + " Usa el task origen para resolver el modelo/tier real y devuelve m\xEDnimo, m\xE1ximo, saldo y si alcanza. Para landing env\xEDa las mismas instructions/sectionKey que usar\xE1s al crear: si hay instructions sin sectionKey, el rango incluye la clasificaci\xF3n pagada con IA. Llama esto antes de create_creative_variant y muestra el rango al usuario.", EstimateCreativeVariantInputBase.shape, READS_INTERNAL, async (input) => {
     try {
       const validatedInput = parseVariantInput(EstimateCreativeVariantInput, input);
       const estimate = await api.postJson(`/v1/tasks/${encodeURIComponent(validatedInput.sourceTaskId)}/creative-variants/estimate`, estimatePayload(validatedInput));
@@ -14720,7 +15435,7 @@ function registerCreativeVariantTools(server, api) {
       throw translateError(error);
     }
   });
-  server.tool("create_creative_variant", "Crea un video, imagen o secci\xF3n de landing adicional dentro de una tarea existente. ES UNA ACCI\xD3N DE PAGO: primero llama estimate_creative_variant, muestra el rango de cr\xE9ditos al usuario y solo despu\xE9s invoca este tool con confirm=true. Las recomendaciones IA tambi\xE9n son acciones pagas a 2x del costo real. clientRequestId es obligatorio: genera un UUID por intenci\xF3n y reutiliza el mismo ante timeouts o transporte ambiguo. Si recibes status=error, pide confirmaci\xF3n para un intento nuevo y usa otro UUID. Reutiliza el producto y referencias del task origen; crea un child task independiente y devuelve variantTaskId. Para landing puedes enviar instructions en texto libre y omitir sectionKey: el backend lo clasifica con IA. No expone ni permite cambiar videoModel, videoTier, videoStyle o narrativeStyle; esos valores se heredan del task origen.", CreateCreativeVariantInputBase.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("create_creative_variant", createCreativeVariantGuidance.summary + " ES UNA ACCI\xD3N DE PAGO: primero llama estimate_creative_variant, muestra el rango de cr\xE9ditos al usuario y solo despu\xE9s invoca este tool con confirm=true. Las recomendaciones IA tambi\xE9n son acciones pagas a 2x del costo real. clientRequestId es obligatorio: genera un UUID por intenci\xF3n y reutiliza el mismo ante timeouts o transporte ambiguo. Si recibes status=error, pide confirmaci\xF3n para un intento nuevo y usa otro UUID. Reutiliza el producto y referencias del task origen; crea un child task independiente y devuelve variantTaskId. Para landing puedes enviar instructions en texto libre y omitir sectionKey: el backend lo clasifica con IA. No expone ni permite cambiar videoModel, videoTier, videoStyle o narrativeStyle; esos valores se heredan del task origen.", CreateCreativeVariantInputBase.shape, CREATES_EXTERNAL, async (input) => {
     try {
       const validatedInput = parseVariantInput(CreateCreativeVariantInput, input);
       const estimateInput = EstimateCreativeVariantInput.parse({
@@ -14791,6 +15506,9 @@ __name(registerCreativeVariantTools, "registerCreativeVariantTools");
 
 // src/tools/script-review.ts
 import { z as z54 } from "zod";
+var getVideoScriptGuidance = getProductMakerCapabilityModelGuidance("get_video_script");
+var regenerateVideoScriptGuidance = getProductMakerCapabilityModelGuidance("regenerate_video_script");
+var approveVideoScriptGuidance = getProductMakerCapabilityModelGuidance("approve_video_script");
 var GetVideoScriptInput = z54.object({
   taskId: z54.string().min(1).describe("ID de la tarea (la misma que devolvi\xF3 create_product_task / generate_video_creative)."),
   angleKey: z54.string().min(1).optional().describe('Clave del \xE1ngulo cuyo guion se quiere leer (formato "angle_0", "angle_1", ...). REQUERIDO para tareas multi-angle: si se omite, el backend resuelve a "angle_0" LITERAL (no "el primer pendiente"), as\xED que en multi-angle donde angle_0 ya est\xE9 aprobado/saltado obtendr\xEDas status="approved" y nunca alcanzar\xEDas el \xE1ngulo realmente pendiente. Para single-angle puede omitirse.')
@@ -14814,7 +15532,7 @@ var RegenerateVideoScriptInput = z54.object({
   narrativeStyle: NarrativeStyleEnum.describe('Narrativa para el nuevo guion. Incluye valores hist\xF3ricos porque esta herramienta tambi\xE9n regenera tareas antiguas. REQUERIDO \u2014 el backend NO acepta "mantener la actual"; siempre tienes que elegir una. Si el usuario quiere re-rolear con la misma narrativa, pasa la que ya tiene el \xE1ngulo (la ves en get_video_script o en get_task_status).')
 }).strict();
 function registerScriptReviewTools(server, api) {
-  server.tool("get_video_script", 'Lee el guion del video pendiente de revisi\xF3n. S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 usa `regenerate_video_script` como recuperaci\xF3n.\n\nMULTI-ANGLE: pasa angleKey expl\xEDcito. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.', GetVideoScriptInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("get_video_script", getVideoScriptGuidance.summary + ' S\xF3lo funciona cuando la tarea fue creada con `pauseForVideoScriptReview: true` (via generate_video_creative). Devuelve { status, angleKey, perClipSeconds?, scenes: [{ index, dialogue, maxWords, minWords?, beatId?, persuasiveFunction?, winnerVisual?, expectedVisual? }], error? }. En escenas copiadas de un winner, `persuasiveFunction` explica qu\xE9 logra ese beat, `winnerVisual` conserva la observaci\xF3n fuente y `expectedVisual` describe nuestra adaptaci\xF3n localizada; muestra los tres junto al di\xE1logo para que una edici\xF3n no desaline\xE9 guion y visual. El campo `error` (cuando viene con status="ready") es el motivo legible por el que un intento previo de aprobaci\xF3n fue rechazado; mu\xE9straselo al usuario.\n\nREGLA DURA: status="ready" es un estado terminal de interacci\xF3n. Presenta el guion una sola vez y NO vuelvas a llamar get_video_script ni get_task_status hasta que el usuario responda aprobar, editar o regenerar. La respuesta a\xF1ade interactionState="awaiting_user_review" y nextAction="present_script_and_wait".\n\nCU\xC1NDO LLAMAR: no existe un status top-level "awaiting_script_review" en get_task_status. Si la tarea fue creada con pauseForVideoScriptReview=true, polea get_task_status hasta que `status === "processing"` y llama este tool; su campo `status` es la se\xF1al real:\n- "ready" \u2192 presenta todas las escenas y DETENTE hasta la respuesta del usuario.\n- "not_ready" \u2192 espera 5\u201310s y reintenta este tool.\n- "approved" \u2192 ya fue aprobado; en multi-angle consulta otro angleKey.\n- "skipped" \u2192 el usuario opt\xF3 por no revisar.\n- "error" \u2192 usa `regenerate_video_script` como recuperaci\xF3n.\n\nMULTI-ANGLE: pasa angleKey expl\xEDcito. Cuando uno est\xE9 ready, detente en ese \xE1ngulo y espera la decisi\xF3n antes de consultar otro.', GetVideoScriptInput.shape, READS_INTERNAL, async (input) => {
     try {
       const qs = input.angleKey ? `?angleKey=${encodeURIComponent(input.angleKey)}` : "";
       const r = await api.getJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script${qs}`);
@@ -14846,7 +15564,7 @@ function registerScriptReviewTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("regenerate_video_script", 'Re-rolea (regenera) el guion del video pendiente de revisi\xF3n. \xDAsalo cuando:\n- get_video_script devuelve status="error" (el LLM fall\xF3 al redactar).\n- El usuario rechaza el guion entero y prefiere reintentar (no editar l\xEDnea por l\xEDnea).\n- Quieres probar otra narrativa (pasa `narrativeStyle`).\n\nFlujo: llama este tool \u2192 polea get_video_script hasta que vuelva a status="ready" \u2192 mu\xE9strale el nuevo guion al usuario \u2192 approve_video_script.\n\nIMPORTANTE: regenerar CUESTA cr\xE9ditos de LLM. No lo invoques sin confirmaci\xF3n del usuario salvo que el status sea "error" (sin retry el usuario no tiene salida).\n\nMULTI-ANGLE: pasa el mismo `angleKey` que usaste con get_video_script.', RegenerateVideoScriptInput.shape, OVERWRITES_EXTERNAL, async (input) => {
+  server.tool("regenerate_video_script", regenerateVideoScriptGuidance.summary + ' \xDAsalo cuando:\n- get_video_script devuelve status="error" (el LLM fall\xF3 al redactar).\n- El usuario rechaza el guion entero y prefiere reintentar (no editar l\xEDnea por l\xEDnea).\n- Quieres probar otra narrativa (pasa `narrativeStyle`).\n\nFlujo: llama este tool \u2192 polea get_video_script hasta que vuelva a status="ready" \u2192 mu\xE9strale el nuevo guion al usuario \u2192 approve_video_script.\n\nIMPORTANTE: regenerar CUESTA cr\xE9ditos de LLM. No lo invoques sin confirmaci\xF3n del usuario salvo que el status sea "error" (sin retry el usuario no tiene salida).\n\nMULTI-ANGLE: pasa el mismo `angleKey` que usaste con get_video_script.', RegenerateVideoScriptInput.shape, OVERWRITES_EXTERNAL, async (input) => {
     try {
       await requirePaidCreativeConfirmation(server, `Regeneraci\xF3n pagada del guion con narrativa ${input.narrativeStyle}.`);
       const r = await api.postJson(`/v1/tasks/${encodeURIComponent(input.taskId)}/video-script/regenerate`, {
@@ -14860,7 +15578,7 @@ function registerScriptReviewTools(server, api) {
   });
   server.tool(
     "approve_video_script",
-    'Aprueba el guion del video (con o sin ediciones). Tras llamarlo, el render arranca y consume cr\xE9ditos.\n\nREGLAS DURAS:\n1. INCLUYE EN scenes[] S\xD3LO las escenas que cambian. El backend mergea por `index` \u2014 las escenas no incluidas conservan su di\xE1logo original. scenes vac\xEDo es rechazado con 400, as\xED que si el usuario no quiere editar nada, manda AL MENOS UNA escena con su `dialogue` original (ser\xE1 un no-op sem\xE1ntico pero satisface el min(1)).\n2. Para cada entrada incluida cuyo `dialogue` difiera del original, el backend valida `minWords \u2264 words(dialogue) \u2264 maxWords` (los rangos vienen en get_video_script). Si te sales del rango, rechaza con 400 \u2014 NO recortes en silencio; p\xEDdele al usuario que ajuste.\n3. Escenas con LLM-original ya fuera de rango: el backend NO valida el rango POR-ESCENA si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas).\n4. TOPE GLOBAL: adem\xE1s del rango por-escena, el backend rechaza con 400 ("El guion no cabe en el tiempo del video. Ac\xF3rtalo y vuelve a aprobar.") cuando el TOTAL de palabras de TODO el guion (incluidas las escenas que no editaste) supera el cupo de la voz \u2014 porque ese guion se pasar\xEDa del tope de duraci\xF3n al renderizar. Si lo ves, acorta las escenas m\xE1s largas (la suma de `maxWords` de get_video_script es el techo total) y reintenta; o usa regenerate_video_script. Este 400 es s\xEDncrono y NO consume render.\n5. NUNCA inventes ni reescribas el guion por tu cuenta. Aplica los cambios del usuario al pie de la letra dentro de los l\xEDmites de palabras.\n6. MULTI-ANGLE: pasa el mismo `angleKey` que usaste en get_video_script. Si lo omites, el backend resuelve a "angle_0" literal \u2014 puedes aprobar un \xE1ngulo equivocado.\n\nDevuelve { status }. status="approved" confirma la aprobaci\xF3n; otro valor significa que la pausa sigue activa.',
+    approveVideoScriptGuidance.summary + ' Tras llamarlo, el render arranca y consume cr\xE9ditos.\n\nREGLAS DURAS:\n1. INCLUYE EN scenes[] S\xD3LO las escenas que cambian. El backend mergea por `index` \u2014 las escenas no incluidas conservan su di\xE1logo original. scenes vac\xEDo es rechazado con 400, as\xED que si el usuario no quiere editar nada, manda AL MENOS UNA escena con su `dialogue` original (ser\xE1 un no-op sem\xE1ntico pero satisface el min(1)).\n2. Para cada entrada incluida cuyo `dialogue` difiera del original, el backend valida `minWords \u2264 words(dialogue) \u2264 maxWords` (los rangos vienen en get_video_script). Si te sales del rango, rechaza con 400 \u2014 NO recortes en silencio; p\xEDdele al usuario que ajuste.\n3. Escenas con LLM-original ya fuera de rango: el backend NO valida el rango POR-ESCENA si no las incluyes (la regla #2 s\xF3lo aplica a escenas editadas).\n4. TOPE GLOBAL: adem\xE1s del rango por-escena, el backend rechaza con 400 ("El guion no cabe en el tiempo del video. Ac\xF3rtalo y vuelve a aprobar.") cuando el TOTAL de palabras de TODO el guion (incluidas las escenas que no editaste) supera el cupo de la voz \u2014 porque ese guion se pasar\xEDa del tope de duraci\xF3n al renderizar. Si lo ves, acorta las escenas m\xE1s largas (la suma de `maxWords` de get_video_script es el techo total) y reintenta; o usa regenerate_video_script. Este 400 es s\xEDncrono y NO consume render.\n5. NUNCA inventes ni reescribas el guion por tu cuenta. Aplica los cambios del usuario al pie de la letra dentro de los l\xEDmites de palabras.\n6. MULTI-ANGLE: pasa el mismo `angleKey` que usaste en get_video_script. Si lo omites, el backend resuelve a "angle_0" literal \u2014 puedes aprobar un \xE1ngulo equivocado.\n\nDevuelve { status }. status="approved" confirma la aprobaci\xF3n; otro valor significa que la pausa sigue activa.',
     ApproveVideoScriptInput.shape,
     // Not CREATES_INTERNAL: approving the script is what STARTS the render, so
     // this call dispatches jobs to the video providers and burns credits. Its own
@@ -14887,8 +15605,13 @@ __name(registerScriptReviewTools, "registerScriptReviewTools");
 
 // src/tools/connections.ts
 import { z as z55 } from "zod";
+var listShopifyShopsGuidance = getProductMakerCapabilityModelGuidance("list_shopify_shops");
+var listShopifyProductsGuidance = getProductMakerCapabilityModelGuidance("list_shopify_products");
+var listMetaAdAccountsGuidance = getProductMakerCapabilityModelGuidance("list_meta_ad_accounts");
+var listMetaDestinationsGuidance = getProductMakerCapabilityModelGuidance("list_meta_destinations");
+var listTikTokAdvertisersGuidance = getProductMakerCapabilityModelGuidance("list_tiktok_advertisers");
 function registerConnectionTools(server, api) {
-  server.tool("list_shopify_shops", "Lista las tiendas Shopify conectadas por este usuario. Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z55.object({}).shape, READS_INTERNAL, async () => {
+  server.tool("list_shopify_shops", listShopifyShopsGuidance.summary + " Si la lista est\xE1 vac\xEDa, dile al usuario que conecte una tienda en productmaker.app/integrations antes de intentar publicar.", z55.object({}).shape, READS_INTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/shopify/shops");
       return asText(r);
@@ -14896,7 +15619,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_shopify_products", 'Busca productos en una tienda Shopify conectada para elegir el target de una republicaci\xF3n. Usa el `id` devuelto junto con `publicationMode="existing"` en `publish_to_shopify`. Si `taskId` se proporciona, la respuesta tambi\xE9n indica el producto publicado actualmente para esa tarea y tienda. No modifica Shopify.', z55.object({
+  server.tool("list_shopify_products", listShopifyProductsGuidance.summary + ' Usa el `id` devuelto junto con `publicationMode="existing"` en `publish_to_shopify`. Si `taskId` se proporciona, la respuesta tambi\xE9n indica el producto publicado actualmente para esa tarea y tienda. No modifica Shopify.', z55.object({
     shopDomain: z55.string().min(3).max(120),
     query: z55.string().trim().max(120).optional(),
     taskId: z55.string().uuid().optional()
@@ -14913,7 +15636,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_meta_ad_accounts", "Lista las cuentas publicitarias de Meta conectadas. Para publicar, prefiere `list_meta_destinations`, que tambi\xE9n devuelve el portfolio y las p\xE1ginas disponibles. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z55.object({}).shape, READS_EXTERNAL, async () => {
+  server.tool("list_meta_ad_accounts", listMetaAdAccountsGuidance.summary + " Para publicar, prefiere `list_meta_destinations`, que tambi\xE9n devuelve el portfolio y las p\xE1ginas disponibles. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar Meta en productmaker.app/integrations.", z55.object({}).shape, READS_EXTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/facebook/ad-accounts");
       return asText(r);
@@ -14922,7 +15645,7 @@ function registerConnectionTools(server, api) {
     }
   });
   server.registerTool("list_meta_destinations", {
-    description: "Lista los destinos de publicaci\xF3n de Meta del usuario: Business portfolios, cuentas publicitarias dentro de cada portfolio y Facebook Pages disponibles. Es obligatorio llamar esta herramienta antes de publicar, mostrar las opciones y enviar al publicador el `portfolioId`, `adAccountId` y `pageId` elegidos; nunca elijas silenciosamente la primera p\xE1gina o cuenta. No modifica Meta.",
+    description: listMetaDestinationsGuidance.summary + " Es obligatorio llamar esta herramienta antes de publicar, mostrar las opciones y enviar al publicador el `portfolioId`, `adAccountId` y `pageId` elegidos; nunca elijas silenciosamente la primera p\xE1gina o cuenta. No modifica Meta.",
     inputSchema: z55.object({}).shape,
     annotations: READS_EXTERNAL,
     _meta: {
@@ -14936,7 +15659,7 @@ function registerConnectionTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("list_tiktok_advertisers", "Lista las cuentas de TikTok Ads conectadas. Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z55.object({}).shape, READS_EXTERNAL, async () => {
+  server.tool("list_tiktok_advertisers", listTikTokAdvertisersGuidance.summary + " Si est\xE1 vac\xEDa, ind\xEDcale al usuario conectar TikTok en productmaker.app/integrations.", z55.object({}).shape, READS_EXTERNAL, async () => {
     try {
       const r = await api.getJson("/v1/tiktok/advertisers");
       return asText(r);
@@ -14949,8 +15672,9 @@ __name(registerConnectionTools, "registerConnectionTools");
 
 // src/tools/actors.ts
 import { z as z56 } from "zod";
+var listActorsGuidance = getProductMakerCapabilityModelGuidance("list_actors");
 function registerActorTools(server, api) {
-  server.tool("list_actors", "Lista los personajes guardados del usuario (personas creadas con IA que pueden protagonizar los videos e im\xE1genes). Devuelve id, nombre, descripci\xF3n, g\xE9nero y voz. Usa el `id` como `actorId` al crear o editar una tarea. Solo aparecen los personajes listos para usar; si la lista est\xE1 vac\xEDa, dile al usuario que cree uno en productmaker.app antes de intentar asignarlo. No modifica nada.", z56.object({}).shape, READS_INTERNAL, async () => {
+  server.tool("list_actors", listActorsGuidance.summary + " Devuelve id, nombre, descripci\xF3n, g\xE9nero y voz. Usa el `id` como `actorId` al crear o editar una tarea. Solo aparecen los personajes listos para usar; si la lista est\xE1 vac\xEDa, dile al usuario que cree uno en productmaker.app antes de intentar asignarlo. No modifica nada.", z56.object({}).shape, READS_INTERNAL, async () => {
     try {
       const rows = await api.getJson("/v1/actors");
       const actors = (Array.isArray(rows) ? rows : []).filter((actor) => actor.status === "ready").map(({ id, name, description, gender, voiceId }) => ({
@@ -15023,6 +15747,10 @@ function deriveMetaPublishAttemptId(input) {
 __name(deriveMetaPublishAttemptId, "deriveMetaPublishAttemptId");
 
 // src/tools/publish.ts
+var publishToShopifyGuidance = getProductMakerCapabilityModelGuidance("publish_to_shopify");
+var publishToMetaGuidance = getProductMakerCapabilityModelGuidance("publish_to_meta");
+var publishCreativesToMetaGuidance = getProductMakerCapabilityModelGuidance("publish_creatives_to_meta");
+var publishToTikTokGuidance = getProductMakerCapabilityModelGuidance("publish_to_tiktok");
 var ShopifyInput = z57.object({
   taskId: z57.string().min(1),
   shopDomain: z57.string().min(1),
@@ -15312,7 +16040,7 @@ var TikTokInput = z57.object({
 });
 function registerPublishTools(server, api, opts = {}) {
   const transport = opts.transport ?? "http";
-  server.tool("publish_to_shopify", "Publica o actualiza la landing en una tienda Shopify conectada. Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input) => {
+  server.tool("publish_to_shopify", publishToShopifyGuidance.summary + " Precondici\xF3n: la tarea debe estar en status='complete' \u2014 usa `get_task_status` antes. Por defecto `publicationMode=auto`: si esta tarea ya fue publicada en esa tienda, actualiza ESE MISMO producto y conserva URL, precio, variantes, inventario y SKU; si no, crea uno. Usa `existing` + `targetProductId` cuando el usuario elija otro producto y `new` s\xF3lo si pide crear uno nuevo. ANTES de llamar preg\xFAntale \"\xBFTu producto tiene variantes (talla, color, etc.)?\" y pasa `showVariantPicker: true` si responde que s\xED. Por defecto publica TODAS las im\xE1genes generadas; pasa `numLandingImages` s\xF3lo si el usuario pide menos. La respuesta es markdown con el link a la landing y al producto.", ShopifyInput.shape, OVERWRITES_EXTERNAL, async (input) => {
     try {
       const parsed = parseShopifyInput(input);
       if (parsed.publicationMode === "existing" && !parsed.targetProductId) {
@@ -15350,7 +16078,7 @@ function registerPublishTools(server, api, opts = {}) {
       throw translateError(e);
     }
   });
-  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) => {
+  server.tool("publish_to_meta", publishToMetaGuidance.summary + " 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);
@@ -15387,7 +16115,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. 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) => {
+  server.tool("publish_creatives_to_meta", publishCreativesToMetaGuidance.summary + ' 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);
@@ -15483,7 +16211,7 @@ function registerPublishTools(server, api, opts = {}) {
       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 SIEMPRE en d\xF3lares, ej. 25 \u2014 nunca el n\xFAmero en moneda local), `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, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
+  server.tool("publish_to_tiktok", publishToTikTokGuidance.summary + " 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 SIEMPRE en d\xF3lares, ej. 25 \u2014 nunca el n\xFAmero en moneda local), `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, CREATES_EXTERNAL, async ({ taskId, campaignConfig, primaryText, ...rest }) => {
     try {
       const body = {
         ...rest
@@ -15574,6 +16302,7 @@ __name(toTikTokCampaignConfig, "toTikTokCampaignConfig");
 // src/tools/meta-upload.ts
 import { registerAppTool } from "@modelcontextprotocol/ext-apps/server";
 import { z as z58 } from "zod";
+var requestMediaUploadGuidance = getProductMakerCapabilityModelGuidance("request_media_upload");
 var UploadSessionInputBase = z58.object({
   mediaKind: z58.enum([
     "image",
@@ -15707,7 +16436,7 @@ __name(resolveEndpointForSession, "resolveEndpointForSession");
 function registerMediaUploadTools(server, api) {
   registerAppTool(server, "request_media_upload", {
     title: "Subir archivos",
-    description: "Abre el selector universal de ProductMaker para im\xE1genes o videos del usuario. Cuando la foto o el video sea el siguiente dato faltante, ll\xE1malo en esa misma respuesta: no te limites a pedir que lo adjunte en el chat y esperar otro turno. Ll\xE1malo tambi\xE9n autom\xE1ticamente y antes de preguntar por campos faltantes adicionales cuando una petici\xF3n natural adjunte o mencione un archivo local, por ejemplo \u2018crea una landing con este producto\u2019, \u2018haz creativos con esta foto\u2019 o \u2018sube este video a Meta\u2019; hazlo aunque el usuario diga que todav\xEDa no generes ni publiques, porque esta herramienta solo prepara el archivo y no consume cr\xE9ditos, salvo que proh\xEDba expl\xEDcitamente subir, compartir o almacenar el archivo; no pidas una ruta local ni URL. Es la \xFAnica ruta de carga para create_product_task, generate_image_creatives, generate_video_creative, generate_free_video, generate_landing y publish_creatives_to_meta. Pasa las referencias opcionales de ChatGPT en files; si el host no puede transferirlas, el mismo App muestra el selector inline. Usa uploadPurpose=product_reference para fotos de producto y landings, creative para creativos o anuncios, y generic solo cuando ninguno aplique. Usa mediaKind=image para referencias de producto y landings; mixed solo cuando el consumidor acepte ambos tipos. El App NO te avisa cuando termina: en cuanto el usuario diga que ya subi\xF3 el archivo o que sigas, llama `check_media_upload` con este sessionId para obtener los assetId, y reanuda la intenci\xF3n original usando \xFAnicamente assetId y mediaKind, sin pedir que vuelva a subir ni mostrar datos t\xE9cnicos. El enlace externo es fallback solo si el App inline falla. Esta herramienta no genera, publica ni consume cr\xE9ditos.",
+    description: requestMediaUploadGuidance.summary + " Cuando la foto o el video sea el siguiente dato faltante, ll\xE1malo en esa misma respuesta: no te limites a pedir que lo adjunte en el chat y esperar otro turno. Ll\xE1malo tambi\xE9n autom\xE1ticamente y antes de preguntar por campos faltantes adicionales cuando una petici\xF3n natural adjunte o mencione un archivo local, por ejemplo \u2018crea una landing con este producto\u2019, \u2018haz creativos con esta foto\u2019 o \u2018sube este video a Meta\u2019; hazlo aunque el usuario diga que todav\xEDa no generes ni publiques, porque esta herramienta solo prepara el archivo y no consume cr\xE9ditos, salvo que proh\xEDba expl\xEDcitamente subir, compartir o almacenar el archivo; no pidas una ruta local ni URL. Es la \xFAnica ruta de carga para create_product_task, generate_image_creatives, generate_video_creative, generate_free_video, generate_landing y publish_creatives_to_meta. Pasa las referencias opcionales de ChatGPT en files; si el host no puede transferirlas, el mismo App muestra el selector inline. Usa uploadPurpose=product_reference para fotos de producto y landings, creative para creativos o anuncios, y generic solo cuando ninguno aplique. Usa mediaKind=image para referencias de producto y landings; mixed solo cuando el consumidor acepte ambos tipos. El App NO te avisa cuando termina: en cuanto el usuario diga que ya subi\xF3 el archivo o que sigas, llama `check_media_upload` con este sessionId para obtener los assetId, y reanuda la intenci\xF3n original usando \xFAnicamente assetId y mediaKind, sin pedir que vuelva a subir ni mostrar datos t\xE9cnicos. El enlace externo es fallback solo si el App inline falla. Esta herramienta no genera, publica ni consume cr\xE9ditos.",
     inputSchema: UploadSessionToolInputShape,
     annotations: CREATES_INTERNAL,
     outputSchema: UniversalUploadStructuredResponse.shape,
@@ -15767,6 +16496,8 @@ __name(registerMediaUploadTools, "registerMediaUploadTools");
 
 // src/tools/campaigns.ts
 import { z as z59 } from "zod";
+var getMetaCampaignStatusGuidance = getProductMakerCapabilityModelGuidance("get_meta_campaign_status");
+var getTikTokCampaignStatusGuidance = getProductMakerCapabilityModelGuidance("get_tiktok_campaign_status");
 var MetaStatusInput = z59.object({
   campaignId: z59.string().min(1).describe("Meta campaign ID returned by publish_to_meta.")
 });
@@ -15775,7 +16506,7 @@ var TikTokStatusInput = z59.object({
   advertiserId: z59.string().min(1).describe("The same advertiserId used to publish the campaign.")
 });
 function registerCampaignTools(server, api) {
-  server.tool("get_meta_campaign_status", "Consulta el estado actual + m\xE9tricas lifetime (spend, impressions, clicks, reach) de una campa\xF1a Meta publicada. Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, READS_EXTERNAL, async (input) => {
+  server.tool("get_meta_campaign_status", getMetaCampaignStatusGuidance.summary + " Llama esto DESPU\xC9S de `publish_to_meta` para confirmar que la campa\xF1a se cre\xF3 correctamente y para reportar performance al usuario. Es read-only \u2014 no modifica nada en Meta Ads Manager.", MetaStatusInput.shape, READS_EXTERNAL, async (input) => {
     try {
       const r = await api.getJson(`/v1/facebook/campaigns/${encodeURIComponent(input.campaignId)}`);
       return renderMetaStatusMarkdown(r);
@@ -15783,7 +16514,7 @@ function registerCampaignTools(server, api) {
       throw translateError(e);
     }
   });
-  server.tool("get_tiktok_campaign_status", "Consulta el estado actual + reporte lifetime (spend, impressions, clicks, reach) de una campa\xF1a TikTok publicada. Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, READS_EXTERNAL, async (input) => {
+  server.tool("get_tiktok_campaign_status", getTikTokCampaignStatusGuidance.summary + " Requiere `advertiserId` (el mismo con el que se cre\xF3). Llama esto DESPU\xC9S de `publish_to_tiktok` para confirmar creaci\xF3n correcta y reportar performance. Es read-only.", TikTokStatusInput.shape, READS_EXTERNAL, async (input) => {
     try {
       const r = await api.getJson(`/v1/tiktok/campaigns/${encodeURIComponent(input.campaignId)}?advertiserId=${encodeURIComponent(input.advertiserId)}`);
       return renderTikTokStatusMarkdown(r);
@@ -16219,6 +16950,7 @@ __name(calculateProductCosting, "calculateProductCosting");
 
 // src/tools/product-costing.ts
 import { z as z62 } from "zod";
+var costProductGuidance = getProductMakerCapabilityModelGuidance("cost_product");
 var optionalAmount = /* @__PURE__ */ __name((description) => z62.number().finite().max(Number.MAX_SAFE_INTEGER).nonnegative().optional().describe(description), "optionalAmount");
 var optionalPercent = /* @__PURE__ */ __name((description) => z62.number().finite().min(0).lt(100).optional().describe(description), "optionalPercent");
 var ProductCostingToolInput = z62.object({
@@ -16236,7 +16968,7 @@ var ProductCostingToolInput = z62.object({
   desiredMarginPercent: optionalPercent("Margen de ganancia deseado. Ejemplo: 10 significa 10%. Omite para usar el valor gu\xEDa editable del pa\xEDs.")
 });
 function registerProductCostingTools(server) {
-  server.tool("cost_product", "Calcula GRATIS y sin cr\xE9ditos cu\xE1nto cobrar por un producto de dropshipping en cualquiera de los pa\xEDses disponibles en ProductMaker. Ll\xE1mala siempre que el usuario pida calcular cu\xE1nto cobrar, la rentabilidad o el margen de un producto concreto; no hagas el c\xE1lculo ni reconstruyas la f\xF3rmula por tu cuenta. Es READ-ONLY: no crea tareas ni publica nada. Pide country y el costo real del proveedor; los dem\xE1s campos pueden usar valores gu\xEDa editables del pa\xEDs. Devuelve `price` y `compareAtPrice` listos para `create_product_task`. No inventes un costo de proveedor.", ProductCostingToolInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("cost_product", costProductGuidance.summary + " Ll\xE1mala siempre que el usuario pida calcular cu\xE1nto cobrar, la rentabilidad o el margen de un producto concreto; no hagas el c\xE1lculo ni reconstruyas la f\xF3rmula por tu cuenta. Es READ-ONLY: no crea tareas ni publica nada. Pide country y el costo real del proveedor; los dem\xE1s campos pueden usar valores gu\xEDa editables del pa\xEDs. Devuelve `price` y `compareAtPrice` listos para `create_product_task`. No inventes un costo de proveedor.", ProductCostingToolInput.shape, READS_INTERNAL, async (input) => {
     if (input.country !== void 0 && input.country !== "CO" && [
       input.supplierCostCop,
       input.shippingCostCop,
@@ -16448,6 +17180,9 @@ function renderResearchReport(run) {
 __name(renderResearchReport, "renderResearchReport");
 
 // src/tools/product-research.ts
+var findWinningProductsGuidance = getProductMakerCapabilityModelGuidance("find_winning_products");
+var getProductResearchRunGuidance = getProductMakerCapabilityModelGuidance("get_product_research_run");
+var listProductResearchRunsGuidance = getProductMakerCapabilityModelGuidance("list_product_research_runs");
 var PRICE_CREDITS = 2e3;
 var TERMINAL2 = /* @__PURE__ */ new Set([
   "ready",
@@ -16491,7 +17226,7 @@ async function pollUntilTerminal(api, runId, waitSeconds) {
 }
 __name(pollUntilTerminal, "pollUntilTerminal");
 function registerProductResearchTools(server, api) {
-  server.tool("find_winning_products", `Busca productos ganadores de dropshipping para un pa\xEDs y categor\xEDa, y explica POR QU\xC9 la IA eligi\xF3 cada uno (razones, riesgos y evidencia real de anuncios en Meta Ads). CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, CREATES_EXTERNAL, async (input) => {
+  server.tool("find_winning_products", `${findWinningProductsGuidance.summary} CUESTA ${PRICE_CREDITS} CR\xC9DITOS por ejecuci\xF3n. ANTES de invocar, dile al usuario el costo y espera su aceptaci\xF3n expl\xEDcita; s\xF3lo entonces pasa confirmed: true. Consulta primero list_product_research_runs (GRATIS) \u2014 puede que el usuario ya tenga un reporte pagado para ese pa\xEDs/categor\xEDa y no necesites cobrar de nuevo. Pa\xEDses disponibles: CO, MX, PE, EC, CL. Tarda varios minutos: usa waitSeconds para esperar, y si expira consulta el resultado con get_product_research_run \u2014 el reporte NO se pierde.`, FindInput.shape, CREATES_EXTERNAL, async (input) => {
     const parsed = FindInput.parse(input);
     if (!parsed.confirmed) {
       throw mcp(McpErrorCode.INVALID_INPUT, `This research run costs ${PRICE_CREDITS} credits. Tell the user the cost, get an explicit yes, then call again with confirmed: true.`);
@@ -16525,7 +17260,7 @@ _Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reci
       throw translateError(error);
     }
   });
-  server.tool("get_product_research_run", "Devuelve el reporte completo de una investigaci\xF3n de productos ganadores: score, veredicto, confianza, razones, riesgos y evidencia de Meta Ads por producto. GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("get_product_research_run", getProductResearchRunGuidance.summary + " GRATIS y read-only. \xDAsalo cuando find_winning_products expir\xF3 la espera, o para releer un reporte anterior encontrado con list_product_research_runs.", GetInput.shape, READS_INTERNAL, async (input) => {
     const parsed = GetInput.parse(input);
     try {
       const run = await api.getJson(`/v1/product-research/runs/${parsed.runId}`);
@@ -16545,7 +17280,7 @@ _Esta llamada no cobr\xF3 cr\xE9ditos: se reutiliz\xF3 una investigaci\xF3n reci
       throw translateError(error);
     }
   });
-  server.tool("list_product_research_runs", "Lista las investigaciones de productos ganadores ya pagadas por el usuario, de la m\xE1s reciente a la m\xE1s antigua. GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("list_product_research_runs", listProductResearchRunsGuidance.summary + " GRATIS y read-only. Cons\xFAltalo ANTES de lanzar una nueva: un reporte ya pagado se relee gratis con get_product_research_run.", ListInput.shape, READS_INTERNAL, async (input) => {
     const parsed = ListInput.parse(input);
     try {
       const runs = await api.getJson(`/v1/product-research/runs?limit=${parsed.limit}`);
@@ -16559,6 +17294,9 @@ __name(registerProductResearchTools, "registerProductResearchTools");
 
 // src/tools/dropshipping-projects.ts
 import { z as z64 } from "zod";
+var startDropshippingProjectGuidance = getProductMakerCapabilityModelGuidance("start_dropshipping_project");
+var costDropshippingProjectGuidance = getProductMakerCapabilityModelGuidance("cost_dropshipping_project");
+var guideDropshippingLaunchGuidance = getProductMakerCapabilityModelGuidance("guide_dropshipping_launch");
 var ProjectId = z64.string().uuid();
 var DropshippingProjectStatus = z64.enum([
   "active",
@@ -16788,7 +17526,7 @@ function projectText(raw) {
 }
 __name(projectText, "projectText");
 function registerDropshippingProjectTools(server, api) {
-  server.tool("start_dropshipping_project", "Inicia o reanuda un proyecto opcional de dropshipping. \xDAsalo cuando el usuario quiera seguir un producto hasta publicarlo; para una operaci\xF3n puntual usa el tool directo. La creaci\xF3n es idempotente y no cobra cr\xE9ditos.", StartProjectInput.shape, CREATES_INTERNAL, async (input) => {
+  server.tool("start_dropshipping_project", startDropshippingProjectGuidance.summary + " \xDAsalo cuando el usuario quiera seguir un producto hasta publicarlo; para una operaci\xF3n puntual usa el tool directo. La creaci\xF3n es idempotente y no cobra cr\xE9ditos.", StartProjectInput.shape, CREATES_INTERNAL, async (input) => {
     try {
       return projectText(await api.postJson("/v1/dropshipping-projects", input));
     } catch (error) {
@@ -16797,7 +17535,7 @@ function registerDropshippingProjectTools(server, api) {
   });
   server.tool(
     "cost_dropshipping_project",
-    "Guarda el costeo de un proyecto guiado. Escribe solo inputs; el backend recalcula el resultado can\xF3nico y controla la versi\xF3n. Pide al usuario el costo real del proveedor: nunca lo inventes. No crea tarea ni publica nada.",
+    costDropshippingProjectGuidance.summary + " Escribe solo inputs; el backend recalcula el resultado can\xF3nico y controla la versi\xF3n. Pide al usuario el costo real del proveedor: nunca lo inventes. No crea tarea ni publica nada.",
     CostProjectInput.shape,
     // Overwrites the costing inputs already saved on the project — the same
     // "previous values are gone" case as edit_task_draft, so destructive.
@@ -16819,7 +17557,7 @@ function registerDropshippingProjectTools(server, api) {
       }
     }
   );
-  server.tool("guide_dropshipping_launch", "Gu\xEDa read-only de un recorrido COMPLETO de dropshipping, desde producto/costeo hasta creativos, tienda y publicidad. No uses este tool para subir o publicar un creativo puntual en Meta: llama directamente `request_media_upload`, `list_meta_destinations` y `publish_creatives_to_meta`. Sin projectId explica cu\xE1ndo usar un flujo directo versus uno guiado; con projectId devuelve la fase y la \xFAnica nextAction calculada por ProductMaker. Despu\xE9s de cada mutaci\xF3n vuelve a llamar este tool o lee el proyecto. Nunca activa Meta.", GuideInput.shape, READS_INTERNAL, async (input) => {
+  server.tool("guide_dropshipping_launch", guideDropshippingLaunchGuidance.summary + " No uses este tool para subir o publicar un creativo puntual en Meta: llama directamente `request_media_upload`, `list_meta_destinations` y `publish_creatives_to_meta`. Sin projectId explica cu\xE1ndo usar un flujo directo versus uno guiado; con projectId devuelve la fase y la \xFAnica nextAction calculada por ProductMaker. Despu\xE9s de cada mutaci\xF3n vuelve a llamar este tool o lee el proyecto. Nunca activa Meta.", GuideInput.shape, READS_INTERNAL, async (input) => {
     try {
       if (!input.projectId) {
         return asText({
@@ -16840,6 +17578,9 @@ __name(registerDropshippingProjectTools, "registerDropshippingProjectTools");
 
 // src/tools/daily-control.ts
 import { z as z65 } from "zod";
+var getDailyControlGuidance = getProductMakerCapabilityModelGuidance("get_daily_control");
+var linkCampaignToProjectGuidance = getProductMakerCapabilityModelGuidance("link_campaign_to_project");
+var reportDailyReturnsGuidance = getProductMakerCapabilityModelGuidance("report_daily_returns");
 var ProviderCampaignIdentifier = z65.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
 var DateOnly = z65.string().regex(/^\d{4}-\d{2}-\d{2}$/);
 var DailyControlInput = z65.object({
@@ -16916,7 +17657,7 @@ __name(withWarnings, "withWarnings");
 function registerDailyControlTools(server, api) {
   server.tool(
     "get_daily_control",
-    'Control diario de rentabilidad por producto: compara el costo real por venta contra lo que el producto puede aguantar, con sem\xE1foro (verde/\xE1mbar/rojo/ninguno) y veredicto (escalar, mantener, matar, muestra insuficiente). Es READ-ONLY sobre publicidad: nunca pausa, activa ni modifica ninguna campa\xF1a \u2014 esa decisi\xF3n es siempre del usuario. Si un producto vuelve con `status` distinto de "ok", NO tiene m\xE9tricas (`days` vac\xEDo, `verdict` null): explica el motivo (`statusMessage`) al usuario y no inventes ni estimes n\xFAmeros para reemplazarlo. Cuando un d\xEDa trae `returnedSource: "estimated"`, esa cifra de devoluciones NO fue medida \u2014 asume la tasa de devoluci\xF3n que el usuario configur\xF3 al costear el producto; dilo as\xED y ofrece registrar el dato real con report_daily_returns. `status: "no_campaign_linked"` significa que ese producto no tiene ninguna campa\xF1a vinculada: no hay gasto que leer, as\xED que NO existe costo por venta \u2014 ofrece link_campaign_to_project si el usuario est\xE1 pautando por fuera. Un d\xEDa con `cancelledSource: "shopify_settling"` est\xE1 medido pero todav\xEDa no cerrado (las cancelaciones de contra-entrega llegan d\xEDas despu\xE9s): ese resultado solo puede empeorar, no lo presentes como definitivo. Y `cancelledSource: "estimated"` es lo NORMAL en contra-entrega con fulfillment por fuera: la cancelaci\xF3n ocurre por WhatsApp o en la puerta y Shopify nunca se entera, as\xED que esa cifra asume la tasa de cancelaci\xF3n que el usuario configur\xF3 al costear \u2014 dilo as\xED y no la presentes como medida.',
+    getDailyControlGuidance.summary + ' Compara el costo real por venta contra lo que el producto puede aguantar, con sem\xE1foro (verde/\xE1mbar/rojo/ninguno) y veredicto (escalar, mantener, matar, muestra insuficiente). Es READ-ONLY sobre publicidad: nunca pausa, activa ni modifica ninguna campa\xF1a \u2014 esa decisi\xF3n es siempre del usuario. Si un producto vuelve con `status` distinto de "ok", NO tiene m\xE9tricas (`days` vac\xEDo, `verdict` null): explica el motivo (`statusMessage`) al usuario y no inventes ni estimes n\xFAmeros para reemplazarlo. Cuando un d\xEDa trae `returnedSource: "estimated"`, esa cifra de devoluciones NO fue medida \u2014 asume la tasa de devoluci\xF3n que el usuario configur\xF3 al costear el producto; dilo as\xED y ofrece registrar el dato real con report_daily_returns. `status: "no_campaign_linked"` significa que ese producto no tiene ninguna campa\xF1a vinculada: no hay gasto que leer, as\xED que NO existe costo por venta \u2014 ofrece link_campaign_to_project si el usuario est\xE1 pautando por fuera. Un d\xEDa con `cancelledSource: "shopify_settling"` est\xE1 medido pero todav\xEDa no cerrado (las cancelaciones de contra-entrega llegan d\xEDas despu\xE9s): ese resultado solo puede empeorar, no lo presentes como definitivo. Y `cancelledSource: "estimated"` es lo NORMAL en contra-entrega con fulfillment por fuera: la cancelaci\xF3n ocurre por WhatsApp o en la puerta y Shopify nunca se entera, as\xED que esa cifra asume la tasa de cancelaci\xF3n que el usuario configur\xF3 al costear \u2014 dilo as\xED y no la presentes como medida.',
     DailyControlInput.shape,
     // Reads live spend from Meta/TikTok and orders from Shopify through our API;
     // it cannot modify anything on any of them.
@@ -16938,7 +17679,7 @@ function registerDailyControlTools(server, api) {
   );
   server.tool(
     "link_campaign_to_project",
-    "Ata una campa\xF1a publicitaria que el usuario lanz\xF3 por fuera de ProductMaker a un proyecto de dropshipping, para que su gasto entre al control diario (get_daily_control). Es la \xFAnica acci\xF3n de este grupo que escribe algo, pero solo vincula un identificador \u2014 nunca crea, pausa ni activa ninguna campa\xF1a real en Meta o TikTok. El servidor verifica con el token del usuario que la campa\xF1a vive en una de sus cuentas antes de vincularla; si no la ve, responde 404. Si la campa\xF1a ya est\xE1 vinculada a otro proyecto, responde 409 y no reasigna nada. Para Meta, el servidor deriva la cuenta publicitaria de la campa\xF1a e ignora el `accountId` recibido.",
+    linkCampaignToProjectGuidance.summary + " Es la \xFAnica acci\xF3n de este grupo que escribe algo, pero solo vincula un identificador \u2014 nunca crea, pausa ni activa ninguna campa\xF1a real en Meta o TikTok. El servidor verifica con el token del usuario que la campa\xF1a vive en una de sus cuentas antes de vincularla; si no la ve, responde 404. Si la campa\xF1a ya est\xE1 vinculada a otro proyecto, responde 409 y no reasigna nada. Para Meta, el servidor deriva la cuenta publicitaria de la campa\xF1a e ignora el `accountId` recibido.",
     LinkCampaignInput.shape,
     // Creates one internal link row; never creates/pauses/activates a real
     // campaign, but the server verifies the campaign against the provider.
@@ -16954,7 +17695,7 @@ function registerDailyControlTools(server, api) {
   );
   server.tool(
     "report_daily_returns",
-    'Registra cu\xE1ntos pedidos de un producto se devolvieron en un d\xEDa concreto. Es el \xFAnico dato del control diario que ProductMaker no puede ver por s\xED solo: quien maneja la log\xEDstica de contra-entrega es la transportadora, no la tienda. Sin este reporte, get_daily_control usa la tasa de devoluci\xF3n estimada del costeo (marcada `returnedSource: "estimated"`) en vez de un n\xFAmero medido. P\xEDdele el n\xFAmero exacto al usuario \u2014 nunca lo inventes ni lo deduzcas de otras m\xE9tricas.',
+    reportDailyReturnsGuidance.summary + ' Es el \xFAnico dato del control diario que ProductMaker no puede ver por s\xED solo: quien maneja la log\xEDstica de contra-entrega es la transportadora, no la tienda. Sin este reporte, get_daily_control usa la tasa de devoluci\xF3n estimada del costeo (marcada `returnedSource: "estimated"`) en vez de un n\xFAmero medido. P\xEDdele el n\xFAmero exacto al usuario \u2014 nunca lo inventes ni lo deduzcas de otras m\xE9tricas.',
     ReportReturnsInput.shape,
     // PUT: replaces whatever number was reported for that product-day.
     OVERWRITES_INTERNAL,