@hubfluencer/mcp 0.5.0 → 0.6.0

package/dist/index.js

@@ -11982,7 +11982,9 @@ var require_dist = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-import { writeFile as writeFile2 } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { mkdir as mkdir2, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname2 } from "node:path";
 
 // ../../node_modules/@modelcontextprotocol/sdk/node_modules/zod/v3/helpers/util.js
 var util;
@@ -29336,33 +29338,85 @@ function isPrivateOrMetadataHost(hostname) {
   const zone = host.indexOf("%");
   if (zone !== -1)
     host = host.slice(0, zone);
-  const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
-  if (v4) {
-    const o = v4.slice(1).map(Number);
-    if (o.some((n) => n > 255))
-      return false;
-    return isPrivateV4(o[0], o[1]);
-  }
-  if (host.includes(":")) {
-    const mapped = /(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/.exec(host);
-    if (mapped) {
-      const o = mapped[1].split(".").map(Number);
-      if (!o.some((n) => n > 255) && isPrivateV4(o[0], o[1])) {
-        return true;
-      }
-    }
-    if (host === "::1" || host === "::")
-      return true;
-    if (host === "::ffff:0:0")
-      return true;
-    if (/^f[cd]/.test(host))
-      return true;
-    if (/^fe[89ab]/.test(host))
-      return true;
+  const v4 = parseV4Octets(host);
+  if (v4)
+    return isPrivateV4(v4[0], v4[1]);
+  if (!host.includes(":"))
     return false;
+  const v6 = parseIPv6Words(host);
+  if (!v6)
+    return false;
+  const embeddedV4 = embeddedIPv4Octets(v6);
+  if (embeddedV4 && isPrivateV4(embeddedV4[0], embeddedV4[1]))
+    return true;
+  if (v6.every((word) => word === 0))
+    return true;
+  if (v6.slice(0, 7).every((word) => word === 0) && v6[7] === 1) {
+    return true;
   }
+  if ((v6[0] & 65024) === 64512)
+    return true;
+  if ((v6[0] & 65472) === 65152)
+    return true;
   return false;
 }
+function parseV4Octets(host) {
+  const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+  if (!v4)
+    return;
+  const octets = v4.slice(1).map(Number);
+  return octets.some((n) => n > 255) ? undefined : octets;
+}
+function parseIPv6Words(host) {
+  if (host.includes(".")) {
+    const lastColon = host.lastIndexOf(":");
+    if (lastColon === -1)
+      return;
+    const v4 = parseV4Octets(host.slice(lastColon + 1));
+    if (!v4)
+      return;
+    host = `${host.slice(0, lastColon)}:${(v4[0] << 8 | v4[1]).toString(16)}:${(v4[2] << 8 | v4[3]).toString(16)}`;
+  }
+  const halves = host.split("::");
+  if (halves.length > 2)
+    return;
+  const head = splitIPv6Half(halves[0]);
+  const tail = halves.length === 2 ? splitIPv6Half(halves[1]) : [];
+  if (!head || !tail)
+    return;
+  if (halves.length === 1)
+    return head.length === 8 ? head : undefined;
+  const missing = 8 - head.length - tail.length;
+  if (missing < 1)
+    return;
+  return [...head, ...Array(missing).fill(0), ...tail];
+}
+function splitIPv6Half(half) {
+  if (half === "")
+    return [];
+  const words = half.split(":");
+  const parsed = [];
+  for (const word of words) {
+    if (!/^[0-9a-f]{1,4}$/.test(word))
+      return;
+    parsed.push(Number.parseInt(word, 16));
+  }
+  return parsed;
+}
+function embeddedIPv4Octets(v6) {
+  const firstFiveZero = v6.slice(0, 5).every((word) => word === 0);
+  if (firstFiveZero && v6[5] === 65535)
+    return wordsToV4(v6[6], v6[7]);
+  const firstSixZero = v6.slice(0, 6).every((word) => word === 0);
+  if (firstSixZero && (v6[6] !== 0 || v6[7] !== 0)) {
+    return wordsToV4(v6[6], v6[7]);
+  }
+  const isNat64WellKnown = v6[0] === 100 && v6[1] === 65435 && v6.slice(2, 6).every((word) => word === 0);
+  return isNat64WellKnown ? wordsToV4(v6[6], v6[7]) : undefined;
+}
+function wordsToV4(hi, lo) {
+  return [hi >> 8, hi & 255, lo >> 8, lo & 255];
+}
 function isPrivateV4(a, b) {
   if (a === 127)
     return true;
@@ -29397,6 +29451,35 @@ function assertSafeFetchUrl(url, opts = {}) {
     return u;
   throw new Error(`Refusing to use an insecure Hubfluencer URL (${u.protocol}//${host}). ` + "Use an https URL (or localhost for local development).");
 }
+var DEFAULT_RETRY = {
+  attempts: 3,
+  baseMs: 300,
+  maxMs: 2000
+};
+function isRetryableStatus(status) {
+  return status === 429 || status >= 500 && status <= 599;
+}
+function isRetryableNetworkError(err) {
+  if (!(err instanceof Error))
+    return false;
+  if (err.retryable === true)
+    return true;
+  return err.name === "TypeError" || err.name === "TimeoutError" || err.name === "AbortError";
+}
+function backoffDelayMs(attempt, opts, rand = Math.random) {
+  const capped = Math.min(opts.maxMs, opts.baseMs * 2 ** (attempt - 1));
+  return Math.round(capped / 2 + rand() * (capped / 2));
+}
+function formatApiErrorMessage(f) {
+  const base = `API error (HTTP ${f.status}${f.code ? `, ${f.code}` : ""}): ${f.message}`;
+  const body = asRecord(f.body);
+  const req = body.required_credits ?? body.required;
+  const have = body.available_credits ?? body.available;
+  if (req != null || have != null) {
+    return `${base} (needs ${req ?? "?"} credits, have ${have ?? "?"}).`;
+  }
+  return base;
+}
 function asRecord(v) {
   return v && typeof v === "object" ? v : {};
 }
@@ -29416,6 +29499,33 @@ function normalizeStatus(kind, slug, data) {
       error: d.error_message ?? null
     };
   }
+  if (kind === "tracking") {
+    const result = asRecord(d.result);
+    const renderStatus2 = result.status ?? null;
+    const trackingUrl = result.video_url ?? null;
+    const ready2 = renderStatus2 === "completed" && Boolean(trackingUrl);
+    return {
+      kind,
+      slug,
+      stage: renderStatus2 ?? d.status ?? "unknown",
+      terminal: ready2 || renderStatus2 === "failed",
+      ready: ready2,
+      video_url: trackingUrl,
+      error: result.error_message ?? null
+    };
+  }
+  if (kind === "slider") {
+    const stage = d.status ?? "unknown";
+    return {
+      kind,
+      slug,
+      stage,
+      terminal: stage === "completed" || stage === "failed",
+      ready: stage === "completed",
+      video_url: null,
+      error: d.error_message ?? null
+    };
+  }
   const autopilot = d.autopilot_status ?? "unknown";
   const renderStatus = latest.status ?? null;
   const ready = renderStatus === "completed" && Boolean(videoUrl);
@@ -29430,9 +29540,44 @@ function normalizeStatus(kind, slug, data) {
     error: d.autopilot_error_message ?? null
   };
 }
+function startStateDiscriminator(kind, data) {
+  const d = asRecord(data);
+  const latest = asRecord(d.latest_render);
+  const renderSig = `${latest.id ?? ""}:${latest.version ?? ""}`;
+  if (kind === "short") {
+    const stage = d.stage ?? "";
+    if (stage !== "failed")
+      return "start";
+    return `failed:${d.failed_stage ?? ""}:${renderSig}`;
+  }
+  const autopilot = d.autopilot_status ?? "";
+  const renderStatus = latest.status ?? "";
+  const failed = autopilot === "failed" || autopilot === "cancelled" || renderStatus === "failed";
+  if (!failed)
+    return "start";
+  return `failed:${autopilot}:${d.autopilot_error_step ?? ""}:${renderSig}`;
+}
 function idemKey(...parts) {
   return createHash("sha256").update(parts.join("|")).digest("hex").slice(0, 32);
 }
+function makeVideoEditorCreateKey(a) {
+  return idemKey("make-editor", a.prompt, a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.aspect ?? "", a.voice_id ?? "", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "");
+}
+function makeVideoAutopilotKey(slug, a, startState) {
+  return idemKey("autopilot", slug, a.prompt, a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.aspect ?? "", a.voice_id ?? "", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", startState);
+}
+function editorAdCreateKey(a) {
+  return idemKey("create-editor", a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "");
+}
+function editorAdAutopilotKey(slug, a) {
+  return idemKey("autopilot", slug, a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "");
+}
+function sliderCreateKey(a) {
+  return idemKey("create-slider", a.prompt, a.mode ?? "", a.template ?? "", a.slide_count === undefined ? "" : String(a.slide_count), a.aspect_ratio ?? "", a.accent_color ?? "", a.text_position ?? "");
+}
+function addSegmentKey(slug, index, nonce) {
+  return idemKey("add-segment", slug, String(index), nonce);
+}
 function resolveSavePath(savePath) {
   const base = resolve(process.env.HUBFLUENCER_OUTPUT_DIR || process.cwd());
   const target = isAbsolute(savePath) ? resolve(savePath) : resolve(base, savePath);
@@ -29452,6 +29597,499 @@ function inferKind(prompt) {
   const wantsEditor = /\b(ads?|advert|advertisement|commercial|promo|campaign|launch|brand|story|stories|multi[- ]?scene|scenes?|narrat|explainer|chapters?|episodes?|testimonial|showcase|walkthrough|demo|spot)\b/.test(p) || /(pub(licit[ée])?|annonce|campagne|histoire|multi[- ]?sc[eè]ne|sc[eè]nes?|raconte|chapitres?|[eé]pisodes?|explicat|lancement|t[eé]moignage|d[eé]mo|vitrine)/.test(p);
   return wantsEditor ? "editor" : "short";
 }
+function validateLanguage(language) {
+  if (language === undefined)
+    return null;
+  const len = language.trim().length;
+  if (len < 2 || len > 10) {
+    return 'language must be a 2–10 character code (e.g. "en", "fr").';
+  }
+  return null;
+}
+function validateProductPrompt(prompt) {
+  if (prompt === undefined)
+    return null;
+  const len = prompt.trim().length;
+  if (len === 0)
+    return null;
+  if (len < 10 || len > 5000) {
+    return "product_prompt, when provided, must be 10–5000 characters.";
+  }
+  return null;
+}
+function validateKind(kind) {
+  if (kind === undefined || kind === "short" || kind === "editor" || kind === "auto") {
+    return null;
+  }
+  return `kind must be one of: short, editor, auto (got "${kind}"). ` + "Use create_slider for carousels or create_tracking_video for tracking overlays.";
+}
+function decideTrackingPlan(existing, args, freshNonce) {
+  const idemBase = args.slug ? idemKey("tracking", args.slug) : idemKey("tracking", args.video_path ?? "", freshNonce);
+  const hasLiveSource = existing?.source != null && existing.source.status !== "failed";
+  const resultStatus = existing?.result?.status;
+  const configSupplied = args.classes !== undefined || args.color !== undefined;
+  const reRenderCompletedWithNewConfig = resultStatus === "completed" && configSupplied;
+  const shouldRender = !existing?.result || resultStatus === "failed" || reRenderCompletedWithNewConfig;
+  const renderAttempt = resultStatus === "failed" ? `retry:${existing?.result?.id ?? "unknown"}` : reRenderCompletedWithNewConfig ? `rerender:${existing?.result?.id ?? "unknown"}` : "new";
+  const renderKey = idemKey(idemBase, "render", renderAttempt, JSON.stringify(args.classes ?? null), JSON.stringify(args.color ?? null));
+  return {
+    idemBase,
+    hasLiveSource,
+    configSupplied,
+    reRenderCompletedWithNewConfig,
+    shouldRender,
+    renderAttempt,
+    renderKey
+  };
+}
+
+// src/campaign.ts
+function statusOf(e) {
+  const s = e?.status;
+  return typeof s === "number" ? s : undefined;
+}
+var PRODUCT_PROFILE_FIELDS = [
+  "name",
+  "source_url",
+  "description",
+  "benefits",
+  "offer",
+  "proof_points",
+  "audience",
+  "cta",
+  "banned_claims",
+  "brand_tone",
+  "metadata"
+];
+function extractedProductToProfileAttrs(product, sourceUrl) {
+  const p = product ?? {};
+  const attrs = {};
+  const str = (v) => {
+    if (typeof v !== "string")
+      return;
+    const t = v.trim();
+    return t === "" ? undefined : t;
+  };
+  const list = (v) => {
+    if (!Array.isArray(v))
+      return;
+    const arr = v.filter((x) => typeof x === "string" && x.trim() !== "");
+    return arr.length > 0 ? arr : undefined;
+  };
+  const name = str(p.name);
+  if (name !== undefined)
+    attrs.name = name;
+  const description = str(p.description);
+  if (description !== undefined)
+    attrs.description = description;
+  const benefits = list(p.benefits);
+  if (benefits !== undefined)
+    attrs.benefits = benefits;
+  const offer = str(p.offer);
+  if (offer !== undefined)
+    attrs.offer = offer;
+  const proof = list(p.proof_points);
+  if (proof !== undefined)
+    attrs.proof_points = proof;
+  const audience = str(p.audience);
+  if (audience !== undefined)
+    attrs.audience = audience;
+  const cta = str(p.cta);
+  if (cta !== undefined)
+    attrs.cta = cta;
+  const banned = list(p.banned_claims);
+  if (banned !== undefined)
+    attrs.banned_claims = banned;
+  const tone = str(p.brand_tone);
+  if (tone !== undefined)
+    attrs.brand_tone = tone;
+  const src = str(sourceUrl);
+  if (src !== undefined)
+    attrs.source_url = src;
+  return attrs;
+}
+function pickProductProfileFields(args) {
+  const out = {};
+  for (const k of PRODUCT_PROFILE_FIELDS) {
+    if (args[k] !== undefined)
+      out[k] = args[k];
+  }
+  return out;
+}
+var BRAND_PROFILE_FIELDS = [
+  "name",
+  "logo_s3_key",
+  "primary_color",
+  "secondary_color",
+  "font_family",
+  "tone_words",
+  "default_cta",
+  "default_audience",
+  "banned_claims",
+  "preferred_visual_language",
+  "preferred_creative_format",
+  "metadata"
+];
+function pickBrandProfileFields(args) {
+  const out = {};
+  for (const k of BRAND_PROFILE_FIELDS) {
+    if (args[k] !== undefined)
+      out[k] = args[k];
+  }
+  return out;
+}
+function validatePlanSource(productProfileId, product) {
+  const hasProfile = typeof productProfileId === "number" && Number.isInteger(productProfileId) && productProfileId > 0;
+  const hasProduct = product != null && typeof product === "object" && typeof product.name === "string" && product.name.trim() !== "";
+  if (hasProfile || hasProduct)
+    return null;
+  return "Provide either product_profile_id (a saved profile) or a product object with a non-empty name.";
+}
+function buildPlanBody(args) {
+  const body = {};
+  if (args.product_profile_id !== undefined)
+    body.product_profile_id = args.product_profile_id;
+  if (args.product !== undefined)
+    body.product = args.product;
+  const str = (v) => typeof v === "string" && v.trim() !== "" ? v.trim() : undefined;
+  const goal = str(args.goal);
+  if (goal !== undefined)
+    body.goal = goal;
+  const platform = str(args.platform);
+  if (platform !== undefined)
+    body.platform = platform;
+  const language = str(args.language);
+  if (language !== undefined)
+    body.language = language;
+  if (args.brand_profile_id !== undefined)
+    body.brand_profile_id = args.brand_profile_id;
+  if (args.count !== undefined)
+    body.count = args.count;
+  return body;
+}
+var MAX_VARIATIONS_BATCH = 12;
+function validateVariationsBatch(variations) {
+  if (!Array.isArray(variations) || variations.length === 0) {
+    return "Provide at least one variation.";
+  }
+  if (variations.length > MAX_VARIATIONS_BATCH) {
+    return `Provide at most ${MAX_VARIATIONS_BATCH} variations per request (got ${variations.length}).`;
+  }
+  return null;
+}
+function draftRouteFor(kind, slug) {
+  if (slug === null)
+    return null;
+  if (kind === "carousel")
+    return `/slider/${slug}`;
+  if (kind === "short")
+    return `/short/${slug}`;
+  if (kind === "editor_ad")
+    return `/editor/${slug}`;
+  return null;
+}
+function summarizePackItem(item) {
+  const it = asRecord(item);
+  const meta2 = asRecord(it.metadata);
+  const factorySlug = typeof it.video_factory_slug === "string" ? it.video_factory_slug : null;
+  const sliderSlug = typeof it.slider_slug === "string" ? it.slider_slug : null;
+  const draftSlug = factorySlug ?? sliderSlug;
+  return {
+    id: it.id,
+    kind: it.kind,
+    status: it.status,
+    hook: it.hook ?? null,
+    video_factory_slug: factorySlug,
+    slider_slug: sliderSlug,
+    draft_slug: draftSlug,
+    draft_route: draftRouteFor(it.kind, draftSlug),
+    credit_estimate: meta2.credit_estimate ?? null,
+    preview_url: it.preview_url ?? null,
+    video_result_id: it.video_result_id ?? null
+  };
+}
+function summarizePack(pack) {
+  const p = asRecord(pack);
+  const items = Array.isArray(p.items) ? p.items.map(summarizePackItem) : [];
+  return {
+    id: p.id,
+    title: p.title ?? null,
+    status: p.status,
+    source_type: p.source_type ?? null,
+    source_url: p.source_url ?? null,
+    brief: p.brief ?? null,
+    product_profile_id: p.product_profile_id ?? null,
+    brand_profile_id: p.brand_profile_id ?? null,
+    item_count: items.length,
+    items
+  };
+}
+function summarizePackListEntry(pack) {
+  const p = asRecord(pack);
+  return {
+    id: p.id,
+    title: p.title ?? null,
+    status: p.status,
+    source_type: p.source_type ?? null,
+    source_url: p.source_url ?? null,
+    brief: p.brief ?? null,
+    product_profile_id: p.product_profile_id ?? null,
+    brand_profile_id: p.brand_profile_id ?? null
+  };
+}
+var HOOK_MIN = 3;
+var HOOK_MAX = 6;
+async function runCreateCampaign(client, args, log = () => {}) {
+  const steps = [];
+  const record3 = (step, ok, detail) => {
+    steps.push({ step, ok, ...detail ? { detail } : {} });
+    log(`${ok ? "ok" : "skip"}: ${step}${detail ? ` — ${detail}` : ""}`);
+  };
+  let productProfileId = args.product_profile_id ?? null;
+  let extracted = null;
+  const imported = { primary_image: false, logo: false };
+  let extractedProduct;
+  if (productProfileId === null) {
+    if (!args.url) {
+      throw new Error("Provide either url or product_profile_id.");
+    }
+    const res = await client.post("/product-sources/extract", {
+      url: args.url
+    });
+    const data = asRecord(asRecord(res).data);
+    extractedProduct = asRecord(data.product);
+    extracted = {
+      source_url: data.source_url ?? args.url,
+      confidence: data.confidence ?? null,
+      name: extractedProduct.name ?? null
+    };
+    record3("extract_product_page", true, `confidence=${data.confidence ?? "?"}`);
+    const attrs = extractedProductToProfileAttrs(extractedProduct, extracted.source_url ?? args.url);
+    if (typeof attrs.name !== "string" || attrs.name.trim() === "") {
+      attrs.name = fallbackNameFromUrl(args.url);
+    }
+    const created = await client.post("/product-profiles", attrs);
+    productProfileId = asRecord(asRecord(created).data).id;
+    record3("create_product_profile", true, `id=${productProfileId}`);
+    const primaryUrl = firstString(extractedProduct.images);
+    if (primaryUrl) {
+      try {
+        await client.post("/product-sources/import-image", {
+          image_url: primaryUrl,
+          product_profile_id: productProfileId,
+          link_as: "primary_image"
+        });
+        imported.primary_image = true;
+        record3("import_primary_image", true);
+      } catch (e) {
+        record3("import_primary_image", false, describeErr(e));
+      }
+    }
+    const logoUrl = typeof extractedProduct.logo === "string" ? extractedProduct.logo : undefined;
+    if (logoUrl && logoUrl.trim() !== "") {
+      try {
+        await client.post("/product-sources/import-image", {
+          image_url: logoUrl,
+          product_profile_id: productProfileId,
+          link_as: "logo"
+        });
+        imported.logo = true;
+        record3("import_logo", true);
+      } catch (e) {
+        record3("import_logo", false, describeErr(e));
+      }
+    }
+  } else {
+    record3("use_product_profile", true, `id=${productProfileId}`);
+  }
+  let positioning = null;
+  try {
+    const planRes = await client.post("/campaign-packs/plan", buildPlanBody({
+      product_profile_id: productProfileId,
+      goal: args.goal,
+      platform: args.platform,
+      language: args.language
+    }));
+    const planData = asRecord(asRecord(planRes).data);
+    positioning = typeof planData.positioning === "string" ? planData.positioning : null;
+    record3("plan_campaign", true);
+  } catch (e) {
+    if (statusOf(e) === 429) {
+      record3("plan_campaign", false, "ai_assist_quota_exceeded (unlock_ai_assists to add +10, or continue)");
+    } else {
+      record3("plan_campaign", false, describeErr(e));
+    }
+  }
+  const count = clampCount(args.item_count);
+  let variations = [];
+  try {
+    const hookRes = await client.post("/campaign-packs/hook-variations", buildPlanBody({
+      product_profile_id: productProfileId,
+      brand_profile_id: args.brand_profile_id,
+      count,
+      goal: args.goal,
+      platform: args.platform,
+      language: args.language
+    }));
+    const hookData = asRecord(asRecord(hookRes).data);
+    variations = Array.isArray(hookData.variations) ? hookData.variations : [];
+    record3("generate_hook_variations", true, `${variations.length} variations`);
+  } catch (e) {
+    const quota = statusOf(e) === 429;
+    record3("generate_hook_variations", false, quota ? "ai_assist_quota_exceeded" : describeErr(e));
+    return partialResult({
+      productProfileId,
+      campaignPackId: null,
+      brandProfileId: args.brand_profile_id ?? null,
+      extracted,
+      imported,
+      items: [],
+      positioning,
+      steps,
+      next: quota ? `generate_hook_variations({ product_profile_id: ${productProfileId} }) once the daily AI-assist quota resets, or unlock_ai_assists first, then create_campaign_pack + add_pack_variations.` : `generate_hook_variations({ product_profile_id: ${productProfileId} }), then create_campaign_pack + add_pack_variations.`,
+      note: quota ? "Stopped at hook variations: the free daily AI-assist quota is exhausted. The product profile is saved — resume once it resets (or unlock more)." : "Stopped at hook variations. The product profile is saved — resume with the granular tools."
+    });
+  }
+  if (variations.length === 0) {
+    return partialResult({
+      productProfileId,
+      campaignPackId: null,
+      brandProfileId: args.brand_profile_id ?? null,
+      extracted,
+      imported,
+      items: [],
+      positioning,
+      steps,
+      next: `generate_hook_variations({ product_profile_id: ${productProfileId} }) to retry, then create_campaign_pack + add_pack_variations.`,
+      note: "Hook variations came back empty — retry generate_hook_variations, then build the pack."
+    });
+  }
+  const filtered = filterVariationsByFormat(variations, args.formats);
+  const chosen = (filtered.length > 0 ? filtered : variations).slice(0, MAX_VARIATIONS_BATCH);
+  const packBody = {
+    product_profile_id: productProfileId
+  };
+  if (args.brand_profile_id !== undefined)
+    packBody.brand_profile_id = args.brand_profile_id;
+  if (args.language !== undefined && args.language.trim() !== "")
+    packBody.language = args.language;
+  if (extracted?.source_url) {
+    packBody.source_type = "url";
+    packBody.source_url = extracted.source_url;
+  }
+  if (typeof extractedProduct?.name === "string")
+    packBody.title = extractedProduct.name;
+  const packRes = await client.post("/campaign-packs", packBody);
+  const campaignPackId = asRecord(asRecord(packRes).data).id;
+  record3("create_campaign_pack", true, `id=${campaignPackId}`);
+  let items = [];
+  let summary = { created: 0, materialized: 0, planned: 0 };
+  try {
+    const varRes = await client.post(`/campaign-packs/${campaignPackId}/variations`, { variations: chosen, materialize: true });
+    const varData = asRecord(asRecord(varRes).data);
+    items = Array.isArray(varData.items) ? varData.items.map(summarizePackItem) : [];
+    const s = asRecord(varData.summary);
+    summary = {
+      created: numberOr(s.created, items.length),
+      materialized: numberOr(s.materialized, 0),
+      planned: numberOr(s.planned, 0)
+    };
+    record3("add_pack_variations", true, `${summary.materialized}/${summary.created} materialized`);
+  } catch (e) {
+    record3("add_pack_variations", false, describeErr(e));
+    return partialResult({
+      productProfileId,
+      campaignPackId,
+      brandProfileId: args.brand_profile_id ?? null,
+      extracted,
+      imported,
+      items: [],
+      positioning,
+      steps,
+      next: `add_pack_variations({ pack_id: ${campaignPackId}, variations: [...], materialize: true }) to populate the pack (up to ${MAX_VARIATIONS_BATCH} per call), or get_campaign_pack({ id: ${campaignPackId} }) to inspect it.`,
+      note: "The pack was created but adding its variations failed — resume with add_pack_variations."
+    });
+  }
+  const draftable = summary.materialized;
+  return {
+    product_profile_id: productProfileId,
+    campaign_pack_id: campaignPackId,
+    brand_profile_id: args.brand_profile_id ?? null,
+    extracted,
+    imported,
+    items,
+    summary,
+    steps,
+    next: `get_campaign_pack({ id: ${campaignPackId} }) to review the drafts; then, for EACH draft you want to publish, generate it EXPLICITLY (a SEPARATE, PAID step): editor_ad/short → start_autopilot({ slug }) or the granular generate/render tools; carousel → generate_slider({ slug }).`,
+    note: `Campaign pack ${campaignPackId} created with ${summary.created} item(s), ${draftable} materialized into editable DRAFTS. ` + (positioning ? `Positioning: ${positioning}. ` : "") + "$0 so far (free AI-assist quota + 0-credit drafts). Generation/render is a separate, explicit, PAID step per draft — nothing was generated."
+  };
+}
+function partialResult(p) {
+  const materialized = p.items.filter((i) => i.draft_slug !== null).length;
+  return {
+    product_profile_id: p.productProfileId,
+    campaign_pack_id: p.campaignPackId,
+    brand_profile_id: p.brandProfileId,
+    extracted: p.extracted,
+    imported: p.imported,
+    items: p.items,
+    summary: {
+      created: p.items.length,
+      materialized,
+      planned: p.items.length - materialized
+    },
+    steps: p.steps,
+    next: p.next,
+    note: p.note
+  };
+}
+function clampCount(n) {
+  if (typeof n !== "number" || !Number.isFinite(n))
+    return HOOK_MAX;
+  return Math.min(HOOK_MAX, Math.max(HOOK_MIN, Math.round(n)));
+}
+function filterVariationsByFormat(variations, formats) {
+  if (!Array.isArray(formats) || formats.length === 0)
+    return variations;
+  const wanted = new Set(formats.map(normalizeFormat));
+  return variations.filter((v) => wanted.has(normalizeFormat(asRecord(v).suggested_format)));
+}
+function normalizeFormat(v) {
+  if (typeof v !== "string")
+    return "";
+  return v.trim().toLowerCase().replace(/[\s-]+/g, "_");
+}
+function firstString(arr) {
+  if (!Array.isArray(arr))
+    return;
+  for (const v of arr) {
+    if (typeof v === "string" && v.trim() !== "")
+      return v;
+  }
+  return;
+}
+function numberOr(v, fallback) {
+  return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function describeErr(e) {
+  const code = e?.code;
+  if (typeof code === "string" && code !== "")
+    return code;
+  const status = statusOf(e);
+  if (e instanceof Error && e.message)
+    return status ? `HTTP ${status}: ${e.message}` : e.message;
+  return status ? `HTTP ${status}` : "failed";
+}
+function fallbackNameFromUrl(url) {
+  if (typeof url !== "string" || url.trim() === "")
+    return "Imported product";
+  try {
+    const host = new URL(url).hostname.replace(/^www\./, "");
+    return host || "Imported product";
+  } catch {
+    return "Imported product";
+  }
+}
 
 // src/credentials.ts
 import { readFileSync, statSync } from "node:fs";
@@ -29479,8 +30117,85 @@ function readStoredCredentials() {
     return {};
   }
 }
+// package.json
+var package_default = {
+  name: "@hubfluencer/mcp",
+  version: "0.6.0",
+  description: "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
+  license: "MIT",
+  author: "Monocursive <contact@monocursive.com>",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/monocursive/monohub.git",
+    directory: "packages/mcp"
+  },
+  homepage: "https://github.com/monocursive/monohub/tree/master/packages/mcp#readme",
+  bugs: "https://github.com/monocursive/monohub/issues",
+  private: false,
+  type: "module",
+  bin: {
+    "hubfluencer-mcp": "./dist/index.js"
+  },
+  main: "./dist/index.js",
+  files: [
+    "dist",
+    "src",
+    "tsconfig.json",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    dev: "bun run src/index.ts",
+    build: "rm -rf dist && bun build src/index.ts --target node --outdir dist",
+    prepublishOnly: "bun run build",
+    start: "node dist/index.js",
+    test: "bun test",
+    typecheck: "tsc -p tsconfig.json --noEmit",
+    lint: "biome check src",
+    release: "bun run typecheck && bun run lint && bun test && npm publish --access public"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    zod: "^3.23.8"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^2.3.8",
+    "@types/node": "^22.10.0",
+    typescript: "^5.9.3"
+  },
+  engines: {
+    node: ">=18"
+  },
+  keywords: [
+    "mcp",
+    "model-context-protocol",
+    "hubfluencer",
+    "ai",
+    "video",
+    "ads",
+    "claude"
+  ]
+};
+
+// src/version.ts
+var VERSION = package_default.version;
+var USER_AGENT = `hubfluencer-mcp/${VERSION}`;
 
 // src/client.ts
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var deadlinePassed = (deadline) => deadline !== undefined && Date.now() >= deadline;
+function composeChangesetMessage(errors4) {
+  const parts = [];
+  for (const field of Object.keys(errors4).sort()) {
+    const val = errors4[field];
+    const msgs = Array.isArray(val) ? val.map((m) => String(m)).filter((m) => m.length > 0) : val !== undefined && val !== null && String(val).length > 0 ? [String(val)] : [];
+    if (msgs.length > 0)
+      parts.push(`${field}: ${msgs.join(", ")}`);
+  }
+  if (parts.length === 0)
+    return null;
+  return `validation failed — ${parts.join("; ")}`;
+}
 function makeError(status, body) {
   let message = `Hubfluencer API error (HTTP ${status})`;
   let code;
@@ -29500,6 +30215,12 @@ function makeError(status, body) {
       message = e.message || message;
     } else if (typeof b.message === "string") {
       message = b.message;
+    } else if (b.errors && typeof b.errors === "object") {
+      const composed = composeChangesetMessage(b.errors);
+      if (composed) {
+        message = composed;
+        code = "validation_failed";
+      }
     }
   }
   const err = new Error(message);
@@ -29511,6 +30232,8 @@ function makeError(status, body) {
 function assertSafeBaseUrl(baseUrl) {
   assertSafeFetchUrl(baseUrl, { allowLoopback: true });
 }
+var MIN_ATTEMPT_TIMEOUT_MS = 1000;
+var DEFAULT_ATTEMPT_TIMEOUT_MS = 60000;
 
 class HubfluencerClient {
   baseUrl;
@@ -29531,43 +30254,63 @@ class HubfluencerClient {
     }
     const headers = {
       authorization: `Bearer ${this.token}`,
-      accept: "application/json"
+      accept: "application/json",
+      "user-agent": USER_AGENT
     };
     if (opts.body !== undefined)
       headers["content-type"] = "application/json";
     if (opts.idempotencyKey)
       headers["idempotency-key"] = opts.idempotencyKey;
-    let res;
-    try {
-      res = await fetch(url, {
-        method,
-        headers,
-        body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
-        signal: AbortSignal.timeout(60000)
-      });
-    } catch (e) {
-      if (e instanceof Error && (e.name === "TimeoutError" || e.name === "AbortError")) {
-        throw new Error(`Request to ${method} ${path} timed out after 60s.`);
-      }
-      throw e instanceof Error ? new Error(`Network error on ${method} ${path}: ${e.message}`) : e;
-    }
-    if (res.status === 204)
-      return;
-    const text = await res.text();
-    let parsed;
-    if (text) {
+    const canRetry = method === "GET";
+    const attempts = canRetry ? DEFAULT_RETRY.attempts : 1;
+    const deadline = canRetry ? opts.deadline : undefined;
+    for (let attempt = 1;; attempt++) {
+      let attemptTimeoutMs = DEFAULT_ATTEMPT_TIMEOUT_MS;
+      if (deadline !== undefined) {
+        const remaining = deadline - Date.now();
+        attemptTimeoutMs = Math.max(MIN_ATTEMPT_TIMEOUT_MS, Math.min(DEFAULT_ATTEMPT_TIMEOUT_MS, remaining));
+      }
+      let res;
       try {
-        parsed = JSON.parse(text);
-      } catch {
-        parsed = text;
+        res = await fetch(url, {
+          method,
+          headers,
+          body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+          signal: AbortSignal.timeout(attemptTimeoutMs)
+        });
+      } catch (e) {
+        if (attempt < attempts && isRetryableNetworkError(e) && !deadlinePassed(deadline)) {
+          await sleep(backoffDelayMs(attempt, DEFAULT_RETRY));
+          continue;
+        }
+        if (e instanceof Error && (e.name === "TimeoutError" || e.name === "AbortError")) {
+          throw new Error(`Request to ${method} ${path} timed out after ${attemptTimeoutMs}ms.`);
+        }
+        throw e instanceof Error ? new Error(`Network error on ${method} ${path}: ${e.message}`) : e;
+      }
+      if (attempt < attempts && isRetryableStatus(res.status) && !deadlinePassed(deadline)) {
+        await res.text().catch(() => {});
+        await sleep(backoffDelayMs(attempt, DEFAULT_RETRY));
+        continue;
       }
+      if (res.status === 204)
+        return;
+      const text = await res.text();
+      let parsed;
+      if (text) {
+        try {
+          parsed = JSON.parse(text);
+        } catch {
+          parsed = text;
+        }
+      }
+      if (!res.ok)
+        throw makeError(res.status, parsed);
+      return parsed;
     }
-    if (!res.ok)
-      throw makeError(res.status, parsed);
-    return parsed;
   }
-  get(path, query) {
-    return this.request("GET", path, { query });
+  get(path, query, deadline) {
+    return this.request("GET", path, { query, deadline });
   }
   post(path, body, idempotencyKey) {
     return this.request("POST", path, { body, idempotencyKey });
@@ -29581,14 +30324,22 @@ class HubfluencerClient {
   del(path) {
     return this.request("DELETE", path);
   }
+  get origin() {
+    return this.baseUrl;
+  }
 }
 function clientFromEnv() {
   const stored = readStoredCredentials();
-  const token = process.env.HUBFLUENCER_API_TOKEN || stored.token;
-  const baseUrl = process.env.HUBFLUENCER_BASE_URL || stored.base_url || "https://hubfluencer.com";
+  const envToken = process.env.HUBFLUENCER_API_TOKEN;
+  const envBaseUrl = process.env.HUBFLUENCER_BASE_URL;
+  const token = envToken || stored.token;
+  const baseUrl = envBaseUrl || stored.base_url || "https://hubfluencer.com";
   if (!token) {
     throw new Error("Not connected to Hubfluencer. Run `npx -y @hubfluencer/mcp login` to connect, or set " + "HUBFLUENCER_API_TOKEN (create one in the app: Settings → Access tokens).");
   }
+  if (envToken && !envBaseUrl && stored.base_url) {
+    console.error(`Warning: using HUBFLUENCER_API_TOKEN from the environment but base URL ${stored.base_url} ` + "from the stored credentials file. Set HUBFLUENCER_BASE_URL to override.");
+  }
   return new HubfluencerClient(baseUrl, token);
 }
 
@@ -29596,7 +30347,7 @@ function clientFromEnv() {
 import { chmod, mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
 var MAX_POLLS = 120;
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function runLogin(clientName = "Claude Code") {
   const BASE = (process.env.HUBFLUENCER_BASE_URL || "https://hubfluencer.com").replace(/\/+$/, "").replace(/\/api$/, "");
   assertSafeBaseUrl(BASE);
@@ -29625,7 +30376,7 @@ Connect this agent to Hubfluencer:
   let intervalMs = Math.max(2, start.interval ?? 5) * 1000;
   const MAX_INTERVAL_MS = 30000;
   for (let i = 0;i < MAX_POLLS; i++) {
-    await sleep(intervalMs);
+    await sleep2(intervalMs);
     const pollRes = await fetch(`${BASE}/api/agent-link/poll`, {
       method: "POST",
       headers: {
@@ -29669,14 +30420,557 @@ async function storeToken(token, base) {
   } catch {}
 }
 
+// src/output-schemas.ts
+var urlish = exports_external.unknown().optional();
+var getStatusOutput = exports_external.object({
+  kind: exports_external.string().optional(),
+  slug: exports_external.string().optional(),
+  stage: exports_external.string().optional(),
+  terminal: exports_external.boolean().optional(),
+  ready: exports_external.boolean().optional(),
+  video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional()
+}).passthrough();
+var waitForCompletionOutput = exports_external.object({
+  kind: exports_external.string().optional(),
+  slug: exports_external.string().optional(),
+  stage: exports_external.string().optional(),
+  terminal: exports_external.boolean().optional(),
+  ready: exports_external.boolean().optional(),
+  video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  saved_to: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  timed_out: exports_external.boolean().optional()
+}).passthrough();
+var getCreditsOutput = exports_external.object({
+  credits: exports_external.unknown().optional(),
+  spendable_credits: exports_external.unknown().optional(),
+  reserved_credits: exports_external.unknown().optional(),
+  remaining_reserved_credits: exports_external.unknown().optional(),
+  message: exports_external.unknown().optional()
+}).passthrough();
+var downloadResultOutput = exports_external.object({
+  video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  saved_to: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  bytes: exports_external.number().optional(),
+  note: exports_external.string().optional()
+}).passthrough();
+var sliderSlide = exports_external.object({
+  position: exports_external.unknown().optional(),
+  image_url: urlish,
+  headline: exports_external.unknown().optional(),
+  body: exports_external.unknown().optional(),
+  kicker: exports_external.unknown().optional(),
+  status: exports_external.unknown().optional()
+}).passthrough();
+var getSliderOutput = exports_external.object({
+  slug: exports_external.string().optional(),
+  kind: exports_external.string().optional(),
+  status: exports_external.string().optional(),
+  stage: exports_external.string().optional(),
+  terminal: exports_external.boolean().optional(),
+  completed: exports_external.boolean().optional(),
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  caption: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  hashtags: exports_external.array(exports_external.unknown()).optional(),
+  slides: exports_external.array(sliderSlide).optional()
+}).passthrough();
+var projectRow = exports_external.object({
+  kind: exports_external.string().optional(),
+  slug: exports_external.string().optional(),
+  stage: exports_external.string().optional(),
+  terminal: exports_external.boolean().optional(),
+  ready: exports_external.boolean().optional(),
+  video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional()
+}).passthrough();
+var listProjectsOutput = exports_external.object({
+  shorts: exports_external.array(projectRow).optional(),
+  projects: exports_external.array(projectRow).optional(),
+  note: exports_external.string().optional()
+}).passthrough();
+var createDraftOutput = exports_external.object({
+  slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  kind: exports_external.string().optional(),
+  next: exports_external.string().optional()
+}).passthrough();
+var createEditorOutput = exports_external.object({
+  slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  kind: exports_external.string().optional(),
+  status: projectRow.optional(),
+  next: exports_external.string().optional()
+}).passthrough();
+var makeVideoOutput = exports_external.object({
+  slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  kind: exports_external.string().optional(),
+  kind_inferred: exports_external.boolean().optional(),
+  stage: exports_external.string().optional(),
+  terminal: exports_external.boolean().optional(),
+  ready: exports_external.boolean().optional(),
+  video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  estimated_credits: exports_external.unknown().optional(),
+  available_credits: exports_external.unknown().optional(),
+  affordable: exports_external.boolean().optional(),
+  charged: exports_external.boolean().optional(),
+  saved_to: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  timed_out: exports_external.boolean().optional(),
+  note: exports_external.string().optional()
+}).passthrough();
+var packItem = exports_external.object({
+  id: exports_external.unknown().optional(),
+  kind: exports_external.unknown().optional(),
+  status: exports_external.unknown().optional(),
+  hook: exports_external.unknown().optional(),
+  video_factory_slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  slider_slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  draft_slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  draft_route: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  credit_estimate: exports_external.unknown().optional(),
+  preview_url: exports_external.unknown().optional(),
+  video_result_id: exports_external.unknown().optional()
+}).passthrough();
+var getCampaignPackOutput = exports_external.object({
+  id: exports_external.unknown().optional(),
+  title: exports_external.unknown().optional(),
+  status: exports_external.unknown().optional(),
+  source_type: exports_external.unknown().optional(),
+  source_url: exports_external.unknown().optional(),
+  brief: exports_external.unknown().optional(),
+  product_profile_id: exports_external.unknown().optional(),
+  brand_profile_id: exports_external.unknown().optional(),
+  item_count: exports_external.number().optional(),
+  items: exports_external.array(packItem).optional()
+}).passthrough();
+var createCampaignOutput = exports_external.object({
+  product_profile_id: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
+  campaign_pack_id: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
+  brand_profile_id: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
+  extracted: exports_external.union([
+    exports_external.object({
+      source_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+      confidence: exports_external.unknown().optional(),
+      name: exports_external.unknown().optional()
+    }).passthrough(),
+    exports_external.null()
+  ]).optional(),
+  imported: exports_external.object({
+    primary_image: exports_external.boolean().optional(),
+    logo: exports_external.boolean().optional()
+  }).passthrough().optional(),
+  items: exports_external.array(packItem).optional(),
+  summary: exports_external.object({
+    created: exports_external.number().optional(),
+    materialized: exports_external.number().optional(),
+    planned: exports_external.number().optional()
+  }).passthrough().optional(),
+  steps: exports_external.array(exports_external.object({
+    step: exports_external.string().optional(),
+    ok: exports_external.boolean().optional(),
+    detail: exports_external.string().optional()
+  }).passthrough()).optional(),
+  next: exports_external.string().optional(),
+  note: exports_external.string().optional()
+}).passthrough();
+var episodeRow = exports_external.object({
+  id: exports_external.unknown().optional(),
+  status: exports_external.unknown().optional(),
+  draft_slug: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  draft_route: exports_external.union([exports_external.string(), exports_external.null()]).optional()
+}).passthrough();
+var getSeriesDashboardOutput = exports_external.object({
+  series: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  upcoming: exports_external.array(episodeRow).optional(),
+  drafted: exports_external.array(episodeRow).optional(),
+  published: exports_external.array(episodeRow).optional(),
+  performance_notes: exports_external.array(exports_external.unknown()).optional()
+}).passthrough();
+var scheduledPost = exports_external.object({
+  id: exports_external.unknown().optional(),
+  platform: exports_external.unknown().optional(),
+  status: exports_external.unknown().optional(),
+  video_result_id: exports_external.unknown().optional(),
+  video_url: exports_external.unknown().optional(),
+  video_factory_kind: exports_external.unknown().optional(),
+  campaign_pack_item_id: exports_external.unknown().optional(),
+  caption: exports_external.unknown().optional(),
+  hashtags: exports_external.unknown().optional(),
+  scheduled_at: exports_external.unknown().optional(),
+  timezone: exports_external.unknown().optional(),
+  posted_at: exports_external.unknown().optional(),
+  published_at: exports_external.unknown().optional(),
+  error_message: exports_external.unknown().optional()
+}).passthrough();
+var listScheduledPostsOutput = exports_external.object({
+  posts: exports_external.array(scheduledPost).optional()
+}).passthrough();
+var getRecommendationsOutput = exports_external.object({
+  confidence: exports_external.unknown().optional(),
+  note: exports_external.unknown().optional()
+}).passthrough();
+
+// src/perf-review-assets.ts
+var PERFORMANCE_PLATFORMS = ["tiktok", "instagram", "other"];
+var PERFORMANCE_SOURCES = [
+  "manual",
+  "tiktok_api",
+  "instagram_api"
+];
+var PERFORMANCE_COUNT_FIELDS = [
+  "views",
+  "likes",
+  "comments",
+  "shares",
+  "clicks",
+  "conversions",
+  "watch_time_seconds"
+];
+var MAX_PERFORMANCE_REVENUE = 999999999999.99;
+function validatePerformanceMetrics(args) {
+  for (const field of PERFORMANCE_COUNT_FIELDS) {
+    const v = args[field];
+    if (v === undefined)
+      continue;
+    if (!Number.isFinite(v) || !Number.isInteger(v) || v < 0) {
+      return `${field} must be a non-negative integer.`;
+    }
+  }
+  if (args.revenue !== undefined) {
+    if (!Number.isFinite(args.revenue) || args.revenue < 0) {
+      return "revenue must be a non-negative number.";
+    }
+    if (args.revenue > MAX_PERFORMANCE_REVENUE) {
+      return `revenue must be at most ${MAX_PERFORMANCE_REVENUE}.`;
+    }
+  }
+  return null;
+}
+function buildPerformanceBody(args, now = () => new Date) {
+  const body = { platform: args.platform };
+  for (const field of PERFORMANCE_COUNT_FIELDS) {
+    if (args[field] !== undefined)
+      body[field] = args[field];
+  }
+  if (args.revenue !== undefined)
+    body.revenue = args.revenue;
+  if (typeof args.source === "string" && args.source.trim() !== "")
+    body.source = args.source;
+  body.captured_at = typeof args.captured_at === "string" && args.captured_at.trim() !== "" ? args.captured_at : now().toISOString();
+  if (args.metadata !== undefined)
+    body.metadata = args.metadata;
+  return body;
+}
+function summarizePerformance(snapshot) {
+  const s = asRecord(snapshot);
+  return {
+    id: s.id,
+    campaign_pack_item_id: s.campaign_pack_item_id,
+    platform: s.platform,
+    views: s.views ?? null,
+    likes: s.likes ?? null,
+    comments: s.comments ?? null,
+    shares: s.shares ?? null,
+    clicks: s.clicks ?? null,
+    conversions: s.conversions ?? null,
+    revenue: s.revenue ?? null,
+    watch_time_seconds: s.watch_time_seconds ?? null,
+    source: s.source ?? null,
+    captured_at: s.captured_at ?? null
+  };
+}
+var CREATIVE_ATTRIBUTE_FIELDS = [
+  "hook_type",
+  "creative_format",
+  "visual_language",
+  "product_category",
+  "cta",
+  "length",
+  "caption_style",
+  "metadata"
+];
+function pickCreativeAttributeFields(args) {
+  const out = {};
+  for (const k of CREATIVE_ATTRIBUTE_FIELDS) {
+    if (args[k] !== undefined)
+      out[k] = args[k];
+  }
+  return out;
+}
+var REVIEW_LINK_MIN_EXPIRES_IN_HOURS = 1;
+var REVIEW_LINK_MAX_EXPIRES_IN_HOURS = 720;
+function validateReviewOutput(videoResultId, sliderId) {
+  const hasVideo = typeof videoResultId === "number";
+  const hasSlider = typeof sliderId === "number";
+  if (hasVideo && hasSlider) {
+    return "Provide exactly one of video_result_id or slider_id, not both.";
+  }
+  if (!hasVideo && !hasSlider) {
+    return "Provide exactly one of video_result_id (a completed render) or slider_id (a completed carousel).";
+  }
+  return null;
+}
+function buildReviewLinkBody(args) {
+  const body = {};
+  if (args.video_result_id !== undefined)
+    body.video_result_id = args.video_result_id;
+  if (args.slider_id !== undefined)
+    body.slider_id = args.slider_id;
+  if (args.campaign_pack_id !== undefined)
+    body.campaign_pack_id = args.campaign_pack_id;
+  if (args.expires_in_hours !== undefined)
+    body.expires_in_hours = args.expires_in_hours;
+  if (args.download_enabled !== undefined)
+    body.download_enabled = args.download_enabled;
+  if (typeof args.version_label === "string" && args.version_label.trim() !== "")
+    body.version_label = args.version_label;
+  return body;
+}
+function summarizeReviewLink(link) {
+  const l = asRecord(link);
+  return {
+    id: l.id,
+    status: l.status,
+    output_kind: l.output_kind ?? null,
+    video_result_id: l.video_result_id ?? null,
+    slider_id: l.slider_id ?? null,
+    campaign_pack_id: l.campaign_pack_id ?? null,
+    expires_at: l.expires_at ?? null,
+    download_enabled: l.download_enabled ?? null,
+    version_label: l.version_label ?? null,
+    view_count: l.view_count ?? null,
+    viewed_at: l.viewed_at ?? null,
+    comment_count: l.comment_count ?? null
+  };
+}
+var DEFAULT_WEB_APP_ORIGIN = "https://app.hubfluencer.com";
+function reviewWebOrigin(env = process.env) {
+  const configured = env.HUBFLUENCER_WEB_URL;
+  if (typeof configured === "string" && configured.trim() !== "") {
+    return configured.trim().replace(/\/+$/, "");
+  }
+  return DEFAULT_WEB_APP_ORIGIN;
+}
+function shapeCreateReviewLink(data, webOrigin) {
+  const d = asRecord(data);
+  const token = d.token ?? null;
+  const reviewPath = typeof d.review_path === "string" ? d.review_path : null;
+  const reviewUrl = absoluteReviewUrl(reviewPath, webOrigin);
+  return {
+    review_link: summarizeReviewLink(d.review_link),
+    token,
+    review_path: reviewPath,
+    review_url: reviewUrl,
+    important: "SAVE THE TOKEN NOW — it is shown only ONCE and is NOT retrievable again. " + "Only its hash is stored server-side; list_review_links and revoke_review_link never return it. " + `Share the review URL${reviewUrl ? ` (${reviewUrl})` : ""} with your reviewer — they open it with no account.`,
+    next: "list_review_links to track approval/comment activity; revoke_review_link({ id }) to disable the URL."
+  };
+}
+function absoluteReviewUrl(reviewPath, webOrigin) {
+  if (!reviewPath)
+    return null;
+  if (typeof webOrigin !== "string" || webOrigin.trim() === "")
+    return reviewPath;
+  try {
+    return new URL(reviewPath, webOrigin).toString();
+  } catch {
+    return reviewPath;
+  }
+}
+function summarizeCatalogAsset(asset) {
+  const a = asRecord(asset);
+  return {
+    id: a.id,
+    filename: a.filename ?? null,
+    media_type: a.media_type ?? null,
+    mime_type: a.mime_type ?? null,
+    size_bytes: a.size_bytes ?? null,
+    description: a.description ?? null,
+    status: a.status ?? null,
+    asset_url: a.asset_url ?? null,
+    inserted_at: a.inserted_at ?? null
+  };
+}
+function summarizeAssetQuota(quota) {
+  const q = asRecord(quota);
+  return {
+    limit_bytes: q.limit_bytes ?? null,
+    used_bytes: q.used_bytes ?? null,
+    pending_bytes: q.pending_bytes ?? null,
+    reserved_bytes: q.reserved_bytes ?? null,
+    remaining_bytes: q.remaining_bytes ?? null
+  };
+}
+function assetSubscriptionErrorText(status, code, message) {
+  if (status !== 402 || code !== "subscription_required")
+    return message;
+  return `${message} The reusable asset catalog requires an ACTIVE SUBSCRIPTION; ` + "this is a billing gate, not a scope or credit issue, so retrying won't help — " + "subscribe in the app first. (Generating videos/carousels does not require this.)";
+}
+
+// src/series-calendar.ts
+var SERIES_FIELDS = [
+  "brand_profile_id",
+  "product_profile_id",
+  "name",
+  "template",
+  "cadence",
+  "tone",
+  "default_format",
+  "status",
+  "metadata"
+];
+function pickSeriesFields(args) {
+  const out = {};
+  for (const k of SERIES_FIELDS) {
+    if (args[k] !== undefined)
+      out[k] = args[k];
+  }
+  return out;
+}
+function episodeDraftRoute(format, factorySlug, sliderSlug) {
+  if (format === "carousel")
+    return sliderSlug ? `/slider/${sliderSlug}` : null;
+  if (format === "short")
+    return factorySlug ? `/short/${factorySlug}` : null;
+  if (format === "editor_ad")
+    return factorySlug ? `/editor/${factorySlug}` : null;
+  return null;
+}
+function summarizeEpisode(episode) {
+  const e = asRecord(episode);
+  const factorySlug = typeof e.video_factory_slug === "string" ? e.video_factory_slug : null;
+  const sliderSlug = typeof e.slider_slug === "string" ? e.slider_slug : null;
+  const draftSlug = factorySlug ?? sliderSlug;
+  return {
+    id: e.id,
+    series_id: e.series_id,
+    position: e.position,
+    status: e.status,
+    hook: e.hook ?? null,
+    brief: e.brief ?? null,
+    caption: e.caption ?? null,
+    suggested_format: e.suggested_format ?? null,
+    hashtags: e.hashtags ?? [],
+    posted_at: e.posted_at ?? null,
+    campaign_pack_item_id: e.campaign_pack_item_id ?? null,
+    video_factory_slug: factorySlug,
+    slider_slug: sliderSlug,
+    draft_slug: draftSlug,
+    draft_route: episodeDraftRoute(e.suggested_format, factorySlug, sliderSlug)
+  };
+}
+function summarizeSeries(series) {
+  const s = asRecord(series);
+  return {
+    id: s.id,
+    name: s.name ?? null,
+    template: s.template ?? null,
+    cadence: s.cadence ?? null,
+    tone: s.tone ?? null,
+    default_format: s.default_format ?? null,
+    status: s.status ?? null,
+    brand_profile_id: s.brand_profile_id ?? null,
+    product_profile_id: s.product_profile_id ?? null,
+    campaign_pack_id: s.campaign_pack_id ?? null
+  };
+}
+function summarizeDashboard(dashboard) {
+  const d = asRecord(dashboard);
+  const lane = (v) => Array.isArray(v) ? v.map(summarizeEpisode) : [];
+  return {
+    series: summarizeSeries(d.series),
+    upcoming: lane(d.upcoming),
+    drafted: lane(d.drafted),
+    published: lane(d.published),
+    performance_notes: Array.isArray(d.performance_notes) ? d.performance_notes : []
+  };
+}
+var SCHEDULED_POST_STATUSES = [
+  "scheduled",
+  "reminded",
+  "posted",
+  "publishing",
+  "published",
+  "failed",
+  "canceled"
+];
+var SCHEDULED_POST_PLATFORMS = [
+  "tiktok",
+  "instagram",
+  "other"
+];
+var MAX_CAPTION_LENGTH = 5000;
+var MAX_HASHTAGS = 30;
+var MAX_HASHTAG_LENGTH = 100;
+var MAX_PENDING_SCHEDULED_POSTS = 500;
+function validateScheduledPostCopy(args) {
+  if (typeof args.caption === "string" && args.caption.length > MAX_CAPTION_LENGTH) {
+    return `caption must be at most ${MAX_CAPTION_LENGTH} characters.`;
+  }
+  if (args.hashtags !== undefined) {
+    if (args.hashtags.length > MAX_HASHTAGS) {
+      return `Provide at most ${MAX_HASHTAGS} hashtags (got ${args.hashtags.length}).`;
+    }
+    const tooLong = args.hashtags.find((h) => h.length > MAX_HASHTAG_LENGTH);
+    if (tooLong !== undefined) {
+      return `each hashtag must be at most ${MAX_HASHTAG_LENGTH} characters.`;
+    }
+  }
+  return null;
+}
+function buildScheduledPostBody(args) {
+  const body = {
+    video_result_id: args.video_result_id,
+    platform: args.platform,
+    scheduled_at: args.scheduled_at
+  };
+  const str = (v) => typeof v === "string" && v.trim() !== "" ? v : undefined;
+  const caption = str(args.caption);
+  if (caption !== undefined)
+    body.caption = caption;
+  if (args.hashtags !== undefined)
+    body.hashtags = args.hashtags;
+  const timezone = str(args.timezone);
+  if (timezone !== undefined)
+    body.timezone = timezone;
+  if (args.campaign_pack_item_id !== undefined)
+    body.campaign_pack_item_id = args.campaign_pack_item_id;
+  return body;
+}
+function summarizeScheduledPost(post) {
+  const p = asRecord(post);
+  return {
+    id: p.id,
+    platform: p.platform,
+    status: p.status,
+    video_result_id: p.video_result_id ?? null,
+    video_url: p.video_url ?? null,
+    video_factory_kind: p.video_factory_kind ?? null,
+    campaign_pack_item_id: p.campaign_pack_item_id ?? null,
+    caption: p.caption ?? null,
+    hashtags: p.hashtags ?? [],
+    scheduled_at: p.scheduled_at ?? null,
+    timezone: p.timezone ?? null,
+    posted_at: p.posted_at ?? null,
+    published_at: p.published_at ?? null,
+    error_message: p.error_message ?? null
+  };
+}
+function calendarScopeErrorText(status, code, message) {
+  if (status !== 403 || code !== "insufficient_scope")
+    return message;
+  return `${message} This calendar tool only creates manual-posting REMINDERS and never attaches a social ` + "account, so this scope refusal means either the targeted post already references a social account " + "(an app-only auto-publish that needs account:admin) or the token predates the reminder-calendar " + "permission. Publishing stays in the app; reschedule/cancel/mark a reminder-only post instead.";
+}
+
 // src/uploads.ts
+import { createReadStream } from "node:fs";
 import { open, readFile, stat } from "node:fs/promises";
 import { basename, extname, isAbsolute as isAbsolute2, resolve as resolve2, sep as sep2 } from "node:path";
+var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+var PART_RETRIES = 2;
 var ALLOW_LOOPBACK_FETCH = /^http:\/\/(localhost|127\.0\.0\.1|\[?::1\]?)/.test(process.env.HUBFLUENCER_BASE_URL || "");
 var MAX_VIDEO_BYTES = 500000000;
 var MAX_IMAGE_BYTES = 20 * 1024 * 1024;
-var MAX_LOGO_BYTES = 20 * 1024 * 1024;
 var MULTIPART_THRESHOLD = 50 * 1024 * 1024;
+var MAX_CATALOG_VIDEO_DURATION_SECONDS = 60;
 var VIDEO_EXT_MIME = {
   mp4: "video/mp4",
   mov: "video/quicktime",
@@ -29690,6 +30984,14 @@ var IMAGE_EXT_MIME = {
 };
 var VIDEO_EXTS = Object.keys(VIDEO_EXT_MIME);
 var IMAGE_EXTS = Object.keys(IMAGE_EXT_MIME);
+var CATALOG_EXT_MIME = {
+  ...IMAGE_EXT_MIME,
+  ...VIDEO_EXT_MIME
+};
+var CATALOG_ASSET_EXTS = Object.keys(CATALOG_EXT_MIME);
+function catalogMaxBytes(mime) {
+  return mime.startsWith("video/") ? MAX_VIDEO_BYTES : MAX_IMAGE_BYTES;
+}
 function planMultipartParts(size, partSize) {
   if (!Number.isFinite(size) || size <= 0) {
     throw new Error(`size must be a positive number, got ${size}.`);
@@ -29707,6 +31009,11 @@ function planMultipartParts(size, partSize) {
   }
   return parts;
 }
+function assertFullRead(bytesRead, len, partNumber, offset) {
+  if (bytesRead !== len) {
+    throw new Error(`Short read on part ${partNumber}: got ${bytesRead} of ${len} bytes at offset ${offset} (file changed under us?).`);
+  }
+}
 async function resolveReadPath(filePath, extToMime, maxBytes) {
   if (!filePath || typeof filePath !== "string") {
     throw new Error("file_path is required.");
@@ -29738,25 +31045,40 @@ async function resolveReadPath(filePath, extToMime, maxBytes) {
   }
   return { path: target, ext, mime, size };
 }
-async function putToPresignedUrl(url, body, contentType, timeoutMs = 300000) {
+async function resolveVideoReadPath(filePath) {
+  return resolveReadPath(filePath, VIDEO_EXT_MIME, MAX_VIDEO_BYTES);
+}
+async function putToPresignedUrl(url, body, contentType, timeoutMs = 300000, contentLength) {
   assertSafeFetchUrl(url, { allowLoopback: ALLOW_LOOPBACK_FETCH });
-  const headers = {};
+  const headers = { "user-agent": USER_AGENT };
   if (contentType)
     headers["content-type"] = contentType;
-  const ab = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
-  let resp;
-  try {
-    resp = await fetch(url, {
+  let fetchBody;
+  let fetchInit;
+  let stream;
+  if (Buffer.isBuffer(body)) {
+    fetchBody = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
+    fetchInit = { method: "PUT", headers, body: fetchBody };
+  } else {
+    stream = createReadStream(body.filePath);
+    headers["content-length"] = String(contentLength ?? body.size);
+    fetchInit = {
       method: "PUT",
       headers,
-      body: ab,
-      signal: AbortSignal.timeout(timeoutMs)
-    });
+      body: stream,
+      duplex: "half"
+    };
+  }
+  fetchInit.signal = AbortSignal.timeout(timeoutMs);
+  let resp;
+  try {
+    resp = await fetch(url, fetchInit);
   } catch (e) {
+    stream?.destroy();
     if (e instanceof Error && (e.name === "TimeoutError" || e.name === "AbortError")) {
-      throw new Error(`Upload PUT timed out after ${timeoutMs / 1000}s.`);
+      throw markRetryable(`Upload PUT timed out after ${timeoutMs / 1000}s.`);
     }
-    throw e instanceof Error ? new Error(`Upload PUT failed: ${e.message}`) : e;
+    throw e instanceof Error ? markRetryable(`Upload PUT failed: ${e.message}`) : e;
   }
   if (!resp.ok) {
     const text = await resp.text().catch(() => "");
@@ -29764,6 +31086,9 @@ async function putToPresignedUrl(url, body, contentType, timeoutMs = 300000) {
   }
   return resp.headers.get("etag") ?? undefined;
 }
+function markRetryable(message) {
+  return Object.assign(new Error(message), { retryable: true });
+}
 async function uploadVideoFile(client, slug, filePath, opts = {}) {
   const file = await resolveReadPath(filePath, VIDEO_EXT_MIME, MAX_VIDEO_BYTES);
   const filename = basename(file.path);
@@ -29774,7 +31099,7 @@ async function uploadVideoFile(client, slug, filePath, opts = {}) {
       filename,
       fit_mode,
       product_description
-    });
+    }, opts.onProgress);
   }
   const presign = await client.post(`/editor/${slug}/uploads/presign`, {
     filename,
@@ -29785,11 +31110,35 @@ async function uploadVideoFile(client, slug, filePath, opts = {}) {
   });
   const { upload_id, presigned_url } = presign.data;
   const buf = await readFile(file.path);
+  await opts.onProgress?.(0, 1, `uploading ${filename}`);
   await putToPresignedUrl(presigned_url, buf, file.mime);
+  await opts.onProgress?.(1, 1, `uploaded ${filename}, confirming`);
   const confirmed = await client.post(`/editor/${slug}/uploads/${upload_id}/confirm`);
   return { upload_id, status: confirmed.data?.status ?? "processing" };
 }
-async function uploadVideoMultipart(client, slug, file, meta2) {
+async function uploadPartWithRetry(client, slug, ids, part_number, chunk) {
+  for (let attempt = 1;; attempt++) {
+    try {
+      const sign = await client.post(`/editor/${slug}/uploads/multipart/sign-part`, {
+        upload_id: ids.upload_id,
+        s3_upload_id: ids.s3_upload_id,
+        part_number
+      });
+      const etag = await putToPresignedUrl(sign.data.presigned_url, chunk, undefined);
+      if (!etag) {
+        throw new Error(`Part ${part_number} returned no ETag from S3.`);
+      }
+      return etag;
+    } catch (e) {
+      if (attempt <= PART_RETRIES && isRetryableNetworkError(e)) {
+        await sleep3(backoffDelayMs(attempt, DEFAULT_RETRY));
+        continue;
+      }
+      throw e;
+    }
+  }
+}
+async function uploadVideoMultipart(client, slug, file, meta2, onProgress) {
   const init = await client.post(`/editor/${slug}/uploads/multipart/init`, {
     filename: meta2.filename,
     mime_type: file.mime,
@@ -29802,18 +31151,17 @@ async function uploadVideoMultipart(client, slug, file, meta2) {
   if (plan.length !== parts_count) {
     throw new Error(`Multipart plan mismatch: server expects ${parts_count} parts, computed ${plan.length} for ${file.size} bytes at ${part_size}/part.`);
   }
+  await onProgress?.(0, plan.length, `uploading ${meta2.filename} in ${plan.length} parts`);
   const fh = await open(file.path, "r");
   const parts = [];
   try {
     for (const { part_number, offset, len } of plan) {
       const chunk = Buffer.alloc(len);
-      await fh.read(chunk, 0, len, offset);
-      const sign = await client.post(`/editor/${slug}/uploads/multipart/sign-part`, { upload_id, s3_upload_id, part_number });
-      const etag = await putToPresignedUrl(sign.data.presigned_url, chunk, undefined);
-      if (!etag) {
-        throw new Error(`Part ${part_number} returned no ETag from S3.`);
-      }
+      const { bytesRead } = await fh.read(chunk, 0, len, offset);
+      assertFullRead(bytesRead, len, part_number, offset);
+      const etag = await uploadPartWithRetry(client, slug, { upload_id, s3_upload_id }, part_number, chunk);
       parts.push({ part_number, etag });
+      await onProgress?.(part_number, plan.length, `uploaded part ${part_number}/${plan.length}`);
     }
     const done = await client.post(`/editor/${slug}/uploads/multipart/complete`, { upload_id, s3_upload_id, parts });
     return { upload_id, status: done.data?.status ?? "processing" };
@@ -29848,19 +31196,97 @@ async function uploadShortPoster(client, slug, filePath) {
   await putToPresignedUrl(upload_url, buf, file.mime);
   return { s3_key };
 }
+async function uploadCatalogAsset(client, filePath, opts = {}) {
+  const file = await resolveReadPath(filePath, CATALOG_EXT_MIME, MAX_VIDEO_BYTES);
+  const cap = catalogMaxBytes(file.mime);
+  if (file.size > cap) {
+    throw new Error(`${file.path} is ${file.size} bytes — over the ${cap}-byte cap for ${file.mime} catalog uploads.`);
+  }
+  if (file.mime.startsWith("video/")) {
+    const duration3 = opts.durationSeconds;
+    if (typeof duration3 !== "number" || !Number.isFinite(duration3) || duration3 <= 0 || duration3 > MAX_CATALOG_VIDEO_DURATION_SECONDS) {
+      throw new Error(`Catalog video uploads require durationSeconds to be greater than 0 and no more than ${MAX_CATALOG_VIDEO_DURATION_SECONDS} seconds.`);
+    }
+  }
+  const filename = basename(file.path);
+  const presign = await client.post("/assets/presign", {
+    filename,
+    mime_type: file.mime,
+    size_bytes: file.size
+  });
+  const { asset_id, presigned_url } = presign.data;
+  if (file.size >= MULTIPART_THRESHOLD) {
+    await putToPresignedUrl(presigned_url, { filePath: file.path, size: file.size }, file.mime, 300000, file.size);
+  } else {
+    const buf = await readFile(file.path);
+    await putToPresignedUrl(presigned_url, buf, file.mime);
+  }
+  const confirmBody = {};
+  if (typeof opts.description === "string" && opts.description.trim() !== "")
+    confirmBody.description = opts.description;
+  if (typeof opts.width === "number")
+    confirmBody.width = opts.width;
+  if (typeof opts.height === "number")
+    confirmBody.height = opts.height;
+  if (typeof opts.durationSeconds === "number")
+    confirmBody.duration_seconds = opts.durationSeconds;
+  const confirmed = await client.post(`/assets/${asset_id}/confirm`, confirmBody);
+  const data = confirmed.data ?? {};
+  return {
+    asset_id,
+    status: typeof data.status === "string" ? data.status : "ready",
+    media_type: typeof data.media_type === "string" ? data.media_type : "",
+    mime_type: typeof data.mime_type === "string" ? data.mime_type : file.mime,
+    filename: typeof data.filename === "string" ? data.filename : filename,
+    size_bytes: typeof data.size_bytes === "number" ? data.size_bytes : file.size
+  };
+}
 
 // src/index.ts
-async function fetchStatus(client, kind, slug) {
-  const path = kind === "short" ? `/shorts/${slug}` : `/editor/${slug}`;
-  const res = await client.get(path);
+async function fetchStatus(client, kind, slug, deadline) {
+  const path = kind === "short" ? `/shorts/${slug}` : kind === "tracking" ? `/tracking/${slug}` : kind === "slider" ? `/sliders/${slug}` : `/editor/${slug}`;
+  const res = await client.get(path, undefined, deadline);
   return normalizeStatus(kind, slug, asRecord(res).data);
 }
+function isRecompositeInProgressConflict(e) {
+  const err = e;
+  if (err?.status !== 409)
+    return false;
+  const texts = [];
+  if (typeof err.code === "string")
+    texts.push(err.code);
+  if (typeof err.message === "string")
+    texts.push(err.message);
+  const body = err.body;
+  if (body && typeof body === "object") {
+    const record3 = body;
+    if (typeof record3.error === "string")
+      texts.push(record3.error);
+    if (typeof record3.message === "string")
+      texts.push(record3.message);
+    const nested = record3.error;
+    if (nested && typeof nested === "object") {
+      const nestedRecord = nested;
+      if (typeof nestedRecord.code === "string")
+        texts.push(nestedRecord.code);
+      if (typeof nestedRecord.message === "string")
+        texts.push(nestedRecord.message);
+    }
+  }
+  return texts.some((text) => {
+    const normalized = text.toLowerCase();
+    return normalized === "recomposite_in_progress" || /\bre-?composit(?:e|ing|ion)\b.*\balready\b.*\b(progress|running)\b/.test(normalized) || /\bcarousel\b.*\bre-?render\b.*\balready\b.*\bprogress\b/.test(normalized);
+  });
+}
 var ALLOW_LOOPBACK_FETCH2 = /^http:\/\/(localhost|127\.0\.0\.1|\[?::1\]?)/.test(process.env.HUBFLUENCER_BASE_URL || "");
 async function downloadTo(videoUrl, savePath) {
   const target = resolveSavePath(savePath);
   assertSafeFetchUrl(videoUrl, { allowLoopback: ALLOW_LOOPBACK_FETCH2 });
   const MAX_BYTES = 1024 * 1024 * 1024;
-  const resp = await fetch(videoUrl, { signal: AbortSignal.timeout(120000) });
+  const resp = await fetch(videoUrl, {
+    headers: { "user-agent": USER_AGENT },
+    signal: AbortSignal.timeout(120000)
+  });
   if (!resp.ok)
     throw new Error(`Failed to download video (HTTP ${resp.status}).`);
   const declared = Number(resp.headers.get("content-length") ?? "");
@@ -29889,6 +31315,7 @@ async function downloadTo(videoUrl, savePath) {
     await reader.cancel().catch(() => {});
   }
   const buf = Buffer.concat(chunks, total);
+  await mkdir2(dirname2(target), { recursive: true });
   await writeFile2(target, buf);
   return { saved_to: target, bytes: buf.length };
 }
@@ -29918,14 +31345,12 @@ function fail(message) {
 function errMessage(e) {
   const he = e;
   if (he && typeof he.status === "number") {
-    const base = `API error (HTTP ${he.status}${he.code ? `, ${he.code}` : ""}): ${he.message}`;
-    const body = he.body;
-    if (body && (body.required_credits != null || body.available_credits != null)) {
-      const req = body.required_credits;
-      const have = body.available_credits;
-      return `${base} (needs ${req ?? "?"} credits, have ${have ?? "?"}).`;
-    }
-    return base;
+    return formatApiErrorMessage({
+      status: he.status,
+      code: he.code,
+      message: he.message,
+      body: he.body
+    });
   }
   return e instanceof Error ? e.message : String(e);
 }
@@ -29986,8 +31411,8 @@ function tool(fn) {
     }
   };
 }
-var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
-var kindSchema = exports_external.enum(["short", "editor"]).describe("Project kind");
+var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
+var kindSchema = exports_external.enum(["short", "editor", "tracking", "slider"]).describe("Project kind");
 var CREATIVE_FORMATS = [
   "problem_solution",
   "mistake_fix",
@@ -30010,16 +31435,45 @@ var WRITE = {
   destructiveHint: false,
   openWorldHint: true
 };
-var server = new McpServer({ name: "hubfluencer", version: "0.5.0" });
+var SERVER_INSTRUCTIONS = `Hubfluencer turns a prompt — or a whole product page — into finished, post-ready vertical videos and image carousels, and can run the surrounding content operation (plan → draft → review → schedule → measure → repeat).
+
+MAKE ONE ASSET (simplest)
+- make_video({ prompt }) creates, generates, and returns a finished MP4 — it picks a single-clip short or a multi-scene editor ad from the prompt (override with kind:"short"|"editor"). create_short / create_editor_ad are the per-product one-shots; create_slider makes an image carousel; create_tracking_video burns a CV overlay onto a local clip.
+- Granular (full control): create a draft, then drive the pipeline step by step (create_editor_draft → generate_scenario → set_scene_count → set_segment_prompt → generate_segment(s) → generate_voice + generate_music → render). Poll with get_status / wait_for_completion; fetch with download_result (a slider has no MP4 — read its slides with get_slider).
+
+DELEGATE THE CONTENT OPERATION (the full loop — steps 1-3 are $0)
+1. ONBOARD a product: extract_product_page(url) pulls facts + imagery (SSRF-hardened, 0cr); import_product_image saves its picture/logo. Persist identity once with create_product_profile + create_brand_profile so every later draft inherits it instead of re-describing the brand.
+2. PLAN ($0, free quota — not credits): plan_campaign proposes angles/formats + a per-item credit estimate; generate_hook_variations writes hook options. create_campaign(url | product_profile_id) does 1-2 end-to-end and returns a pack of editable DRAFTS.
+3. PACK & MATERIALIZE ($0): create_campaign_pack / add_pack_variations assemble items; materialize_pack_item turns each into a 0-credit draft (editor_ad/short → a video project, carousel → a slider). list_campaign_packs lists packs; get_campaign_pack({ id }) shows every item's draft slug + credit estimate.
+4. GENERATE per draft (CREDITS — a separate, explicit step): run start_autopilot/generate_short/generate_slider on each draft slug. Nothing above this line spends video credits.
+5. REVIEW: create_review_link mints a no-login page where a human approves/comments (list_review_links / revoke_review_link manage them). Gate spend or posting on approval.
+6. CALENDAR (reminder-only): schedule_post / list_scheduled_posts / reschedule_post / cancel_scheduled_post stage a calendar that pushes REMINDERS to the user — it does NOT auto-publish (posting to TikTok/IG stays a human step in the app). After the user posts the presigned export, call mark_scheduled_posted.
+7. MEASURE → DOUBLE DOWN: record_performance logs views/engagement (tag creatives via set_item_attributes); get_recommendations gives a CAUTIOUS, non-causal read of your own best hook/format (present its confidence + note as-is, never upgrade them); make_more_like_winner spins fresh hooks from a proven item — feed a winner back into add_pack_variations → step 4.
+8. RECURRING: create_series + plan_series_episodes → materialize_episode drafts each episode; get_series_dashboard shows upcoming/drafted/published lanes; mark_episode_posted closes a recurring show's loop.
+
+CREDITS (spent server-side; each tool prices before charging — see its description)
+- Free (0 credits): every draft create/edit, reorder, all slider re-composites, and the whole onboard/plan/pack/materialize path (steps 1-3). get_credits shows the balance.
+- Charged: short render 15; editor AI scene 5 (4 in a batch of ≥3); voice 3; music 5; editor render 0 (auto-charges ungenerated scenes); slider 1/slide; tracking render 1 (refunded on failure). make_video/create_* report the estimate first — pass dry_run to preview, max_credits to cap.
+- AI ASSISTS (all generate_*/enhance/suggest/plan/hook tools) draw a FREE daily quota (20/day), NOT credits. On 429, set auto_unlock:true to spend 1 credit for +10 assists (retried once), or write the copy yourself and use the set_* tools.
+
+WAITING & RESUMING
+- Renders run async and can take minutes. wait_for_completion polls a budget capped at 280s; if it returns terminal=false / timed_out, just CALL IT AGAIN with the same slug. make_video returns the slug + a resume hint on timeout.
+- Creates and charged actions are idempotency-keyed: a transport retry is safe; a genuine re-run after a terminal FAILURE restarts rather than replaying the dead attempt.
+
+LOCAL FILES (sandboxed)
+- Reads (upload_video / product / logo / closing / poster) are confined to HUBFLUENCER_INPUT_DIR (default: cwd); writes (save_path on wait_for_completion / download_result) are confined to HUBFLUENCER_OUTPUT_DIR (default: cwd), .mp4 only. Paths outside the base are refused.
+
+AUTH: set HUBFLUENCER_API_TOKEN (Settings → Access tokens) or run \`npx -y @hubfluencer/mcp login\`. HUBFLUENCER_BASE_URL overrides the API host; HUBFLUENCER_CREDENTIALS overrides the device-link credentials path.`;
+var server = new McpServer({ name: "hubfluencer", version: VERSION }, { instructions: SERVER_INSTRUCTIONS });
 var registerTool = server.registerTool.bind(server);
 async function pollToTerminal(client, kind, slug, extra, budgetMs, intervalMs) {
   const deadline = Date.now() + budgetMs;
-  let status = await fetchStatus(client, kind, slug);
+  let status = await fetchStatus(client, kind, slug, deadline);
   let n = 0;
   while (!status.terminal && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `stage: ${status.stage}`);
-    await sleep2(intervalMs);
-    status = await fetchStatus(client, kind, slug);
+    await sleep4(intervalMs);
+    status = await fetchStatus(client, kind, slug, deadline);
   }
   return status;
 }
@@ -30027,7 +31481,7 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
   const deadline = Date.now() + budgetMs;
   const sid = String(segmentId);
   const read = async () => {
-    const res = await client.get(`/editor/${slug}`);
+    const res = await client.get(`/editor/${slug}`, undefined, deadline);
     const data = asRecord(asRecord(res).data);
     const segments = Array.isArray(data.segments) ? data.segments : [];
     const seg = segments.find((s) => String(s.id) === sid);
@@ -30040,7 +31494,7 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
   let { status, error: error2 } = await read();
   while (status !== "completed" && status !== "failed" && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `segment ${sid}: ${status}`);
-    await sleep2(intervalMs);
+    await sleep4(intervalMs);
     ({ status, error: error2 } = await read());
   }
   return {
@@ -30055,7 +31509,9 @@ registerTool("make_video", {
   inputSchema: {
     prompt: exports_external.string().describe("What the ad/video should be about (min 10 chars)"),
     kind: exports_external.string().optional().describe("'short' (fast, 1 clip), 'editor' (multi-scene), or 'auto' (default — inferred)"),
-    language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
+    product_subject: exports_external.string().max(300).optional().describe('EDITOR only: the concrete product / main subject the video must be about (e.g. "Bordeaux red ' + 'wine, dark green bottle"). Hard-grounds the AI so it cannot invent an unrelated product. ' + "Recommended for ads."),
+    project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("EDITOR only: social_ad for promotional content (product focus + CTA) or creative_story (default)."),
+    language: exports_external.string().optional().describe('Language code, e.g. "en" (default), "fr". Drives scenario, narration, voice, and captions.'),
     aspect: exports_external.string().optional().describe("Aspect ratio for editor: 9:16 (default), 16:9, or 1:1"),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id for editor ads (see list_voices); shorts have no voiceover"),
     headline: exports_external.string().optional().describe("SHORTS only: the on-screen TITLE overlay (≤160). Set this so the short isn't bare."),
@@ -30088,15 +31544,34 @@ registerTool("make_video", {
     dry_run: exports_external.boolean().optional().describe("Preview only: create a free draft, price it, and STOP before spending credits. " + "Returns {estimated_credits, available_credits, slug}. Resume with generate_short / start_autopilot."),
     max_credits: exports_external.number().optional().describe("Spend cap: refuse to start (no charge) if the priced estimate exceeds this. Returns the estimate.")
   },
+  outputSchema: makeVideoOutput,
   annotations: { title: "Make a video", ...WRITE, idempotentHint: false }
 }, tool(async (args, client, extra) => {
-  if (!args.prompt || args.prompt.trim().length < 10) {
-    return fail("prompt must be at least 10 characters.");
-  }
+  const promptLen = args.prompt?.trim().length ?? 0;
+  if (promptLen < 10 || promptLen > 5000) {
+    return fail("prompt must be 10–5000 characters.");
+  }
+  const langErr = validateLanguage(args.language);
+  if (langErr)
+    return fail(langErr);
+  const kindErr = validateKind(args.kind);
+  if (kindErr)
+    return fail(kindErr);
   const requestedKind = args.kind === "short" || args.kind === "editor" ? args.kind : undefined;
   const kind = requestedKind ?? inferKind(args.prompt);
   const waitSeconds = Math.min(280, Math.max(10, args.max_wait_seconds ?? 240));
   const budgetMs = waitSeconds * 1000;
+  if (args.star_rating !== undefined && (args.star_rating < 0 || args.star_rating > 5)) {
+    return fail("star_rating must be between 0 and 5.");
+  }
+  if (args.text_beats !== undefined) {
+    if (args.text_beats.length > 8) {
+      return fail("text_beats must have at most 8 entries.");
+    }
+    if (args.text_beats.some((b) => b.length > 120)) {
+      return fail("each text_beats entry must be at most 120 characters.");
+    }
+  }
   if (args.save_path)
     resolveSavePath(args.save_path);
   let slug;
@@ -30127,12 +31602,14 @@ registerTool("make_video", {
     const created = await client.post("/editor", {
       language: args.language ?? "en",
       product_prompt: args.prompt,
+      product_subject: args.product_subject,
+      project_intent: args.project_intent,
       export_aspect_ratio: args.aspect,
       voice_id: args.voice_id,
       creative_format: args.creative_format,
       visual_language: args.visual_language,
       theme: args.theme
-    }, idemKey("make-editor", args.prompt, args.language ?? "en", args.aspect ?? "", args.voice_id ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
+    }, makeVideoEditorCreateKey(args));
     slug = created.data.slug;
   }
   const costPath = kind === "short" ? `/shorts/${slug}/cost` : `/editor/${slug}/autopilot/cost`;
@@ -30159,10 +31636,15 @@ registerTool("make_video", {
       note
     });
   }
+  let startState = "start";
+  try {
+    const cur = await client.get(kind === "short" ? `/shorts/${slug}` : `/editor/${slug}`);
+    startState = startStateDiscriminator(kind, asRecord(cur).data);
+  } catch {}
   if (kind === "short") {
-    await client.post(`/shorts/${slug}/generate`, undefined, `gen-short:${slug}`);
+    await client.post(`/shorts/${slug}/generate`, undefined, `gen-short:${slug}:${startState}`);
   } else {
-    await client.post(`/editor/${slug}/autopilot`, undefined, `autopilot:${slug}`);
+    await client.post(`/editor/${slug}/autopilot`, undefined, makeVideoAutopilotKey(slug, args, startState));
   }
   await reportProgress(extra, 0, `started ${kind} ${slug}`);
   const status = await pollToTerminal(client, kind, slug, extra, budgetMs, 15000);
@@ -30183,13 +31665,14 @@ registerTool("make_video", {
   const links = status.ready && status.video_url ? [mp4Link(status.video_url, slug)] : [];
   return ok({
     ...result,
-    note: status.ready ? "Done. Presigned ~24h URL — download promptly." : status.terminal ? `Terminal (${status.stage}). ${status.error ?? ""}`.trim() : `Still rendering — call wait_for_completion(${resumeArgs}).`
+    note: status.ready ? "Done. Presigned ~24h URL — download promptly." : status.terminal ? `Terminal (${status.stage}). ${status.error ?? ""}`.trim() + ` To restart, fix the cause (often credits) then re-run make_video, or resume with ${resume}.` : `Still rendering — call wait_for_completion(${resumeArgs}).`
   }, links);
 }));
 registerTool("get_credits", {
   title: "Get credit balance",
   description: "Returns the authenticated account's credit balance. A short costs 15 credits.",
   inputSchema: {},
+  outputSchema: getCreditsOutput,
   annotations: { title: "Get credits", ...RO }
 }, tool(async (_args, client) => {
   const res = await client.get("/studio/credits");
@@ -30215,6 +31698,7 @@ registerTool("list_projects", {
     include_completed: exports_external.boolean().optional().describe("Also include completed shorts (default false)"),
     limit: exports_external.number().optional().describe("Max items per kind (default 25, capped at 100)")
   },
+  outputSchema: listProjectsOutput,
   annotations: { title: "List projects", ...RO }
 }, tool(async (args, client) => {
   const cap = Math.min(100, Math.max(1, args.limit ?? 25));
@@ -30272,6 +31756,7 @@ registerTool("create_short", {
     star_rating: exports_external.number().min(0).max(5).optional().describe("Optional 0..5 star rating under the subheadline"),
     text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Optional caption beats shown sequentially instead of the static subheadline.")
   },
+  outputSchema: createDraftOutput,
   annotations: { title: "Create short", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
   const body = {
@@ -30322,11 +31807,147 @@ registerTool("create_short", {
     next: "set_short_product / set_short_poster (optional branding), then generate_short"
   });
 }));
+async function getTracking(client, slug, deadline) {
+  const res = await client.get(`/tracking/${slug}`, undefined, deadline);
+  return res.data;
+}
+async function waitForTrackingSource(client, slug, extra, budgetMs = 120000, intervalMs = 3000) {
+  const deadline = Date.now() + budgetMs;
+  let n = 0;
+  while (Date.now() + intervalMs <= deadline) {
+    const t = await getTracking(client, slug, deadline);
+    if (t.source?.status === "ready")
+      return "ready";
+    if (t.source?.status === "failed")
+      return "failed";
+    await reportProgress(extra, ++n, "processing source clip");
+    await sleep4(intervalMs);
+  }
+  return "timeout";
+}
+async function pollTrackingComplete(client, slug, extra, budgetMs = 900000, intervalMs = 4000) {
+  const deadline = Date.now() + budgetMs;
+  let n = 0;
+  let t = await getTracking(client, slug, deadline);
+  while (t.result?.status !== "completed" && t.result?.status !== "failed" && Date.now() + intervalMs <= deadline) {
+    await reportProgress(extra, ++n, "applying tracking overlay");
+    await sleep4(intervalMs);
+    t = await getTracking(client, slug, deadline);
+  }
+  return t;
+}
+registerTool("create_tracking_video", {
+  title: "Create a tracking-overlay video",
+  description: "One-shot: upload a local video and burn the computer-vision 'object tracking' overlay on top " + "(white convex-hull polygons hugging each moving subject, HUD corner brackets, a centroid crosshair, " + "and per-subject telemetry), then download the result. Costs 1 credit on render. The source clip must " + "be ≤60s and ≤1080p. This creates the project, uploads the clip, waits for it to be ready, renders, " + "polls to completion, and (when save_path is given) downloads the finished MP4. " + "RESUMING: if the call returns terminal=false (slow upload or a render still cold-starting on the GPU), " + "call this tool AGAIN with the returned slug to resume — it reuses the in-flight upload (it only (re)uploads " + "when no source exists yet or the prior upload failed) and never re-charges (a render in flight is reported, " + "not duplicated). Resuming a slug whose render already COMPLETED just returns the finished video: a " + "completed project is FINAL. The source clip is deleted on successful completion, so you cannot re-render it " + "with a different overlay: for a variant (different classes/color) start a NEW project (omit slug, pass " + "video_path). Re-uploading even the identical clip charges a fresh 1-credit render (the dedup keys on the new " + "upload). Once the project " + "exists you can also poll/download it with get_status / download_result / wait_for_completion using " + 'kind:"tracking" and that slug.',
+  inputSchema: {
+    video_path: exports_external.string().optional().describe("Local path to the source video (mp4/mov/webm/mkv), inside HUBFLUENCER_INPUT_DIR or cwd. " + "Required on a fresh call; optional when resuming with slug (the clip is already uploaded)."),
+    slug: exports_external.string().optional().describe("Resume an existing tracking project (from a prior timeout/partial-failure payload): skips create " + "and reuses the in-flight upload (only re-uploads when no source exists yet or the prior upload failed). " + "Resuming a project whose render already COMPLETED just returns the finished video: a completed project " + "is final (its source clip was deleted on completion), so you cannot re-render it with a different overlay. " + "For a variant, start a fresh project (omit slug, pass video_path). Pass this back to continue an in-flight " + "project rather than forking a new one; omit it to start a fresh project."),
+    classes: exports_external.array(exports_external.number().int().min(0).max(79)).optional().describe("COCO-80 class ids (0-79) to track (e.g. [0]=person, [16]=dog). Omit to track all subjects."),
+    color: exports_external.array(exports_external.number().int().min(0).max(255)).min(3).max(4).optional().describe("Optional overlay color as RGB [r,g,b] or RGBA [r,g,b,a] (each 0–255). Omit for the default white overlay."),
+    save_path: exports_external.string().optional().describe("Optional .mp4 path to download the finished video to (inside HUBFLUENCER_OUTPUT_DIR or cwd).")
+  },
+  annotations: {
+    title: "Create tracking video",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client, extra) => {
+  if (args.save_path)
+    resolveSavePath(args.save_path);
+  const existing = args.slug ? await getTracking(client, args.slug) : null;
+  const plan = decideTrackingPlan(existing, args, randomUUID());
+  let slug;
+  if (args.slug) {
+    slug = args.slug;
+  } else {
+    if (!args.video_path) {
+      return fail("video_path is required to start a new tracking video.");
+    }
+    await resolveVideoReadPath(args.video_path);
+    const created = await client.post("/tracking", {}, plan.idemBase);
+    slug = created.data.slug;
+  }
+  if (existing?.result?.status === "completed") {
+    const videoUrl2 = existing.result.video_url ?? null;
+    let saved_to2;
+    if (videoUrl2 && args.save_path) {
+      saved_to2 = (await downloadTo(videoUrl2, args.save_path)).saved_to;
+    }
+    const variantNote = plan.configSupplied ? " A different overlay needs a NEW tracking project (omit slug, pass video_path): the finished project's source clip was deleted on completion, so re-running can't re-render it, and re-uploading even the same clip charges a fresh 1-credit render." : "";
+    return ok({
+      slug,
+      kind: "tracking",
+      status: "completed",
+      terminal: true,
+      video_url: videoUrl2,
+      ...saved_to2 ? { saved_to: saved_to2 } : {},
+      note: `Already completed — the project is final. Presigned ~24h URL, download promptly.${variantNote}`
+    }, videoUrl2 ? [mp4Link(videoUrl2, slug)] : []);
+  }
+  if (!plan.hasLiveSource) {
+    if (!args.video_path) {
+      return fail(`Source for ${slug} is not uploaded yet (or the prior upload failed) and no ` + "video_path was given to (re)upload. Pass video_path to upload, or wait and " + "resume with the slug if an upload is already in flight.");
+    }
+    await uploadVideoFile(client, slug, args.video_path, {
+      onProgress: (completed, total, message) => reportProgress(extra, completed, message, total)
+    });
+  }
+  const sourceState = await waitForTrackingSource(client, slug, extra);
+  if (sourceState === "failed") {
+    return ok({
+      slug,
+      kind: "tracking",
+      status: "failed",
+      terminal: true,
+      note: `Source upload failed for ${slug} — re-run create_tracking_video with slug:"${slug}" and video_path to re-upload the clip.`
+    });
+  }
+  if (sourceState === "timeout") {
+    return ok({
+      slug,
+      kind: "tracking",
+      status: "processing",
+      terminal: false,
+      note: `Source still processing — call create_tracking_video again with slug:"${slug}" to resume (no re-upload, no re-charge).`
+    });
+  }
+  if (plan.shouldRender) {
+    const body = {};
+    if (args.classes !== undefined)
+      body.classes = args.classes;
+    if (args.color !== undefined)
+      body.color = args.color;
+    try {
+      await client.post(`/tracking/${slug}/render`, body, plan.renderKey);
+    } catch (e) {
+      if (e.status !== 409)
+        throw e;
+    }
+  }
+  const final = await pollTrackingComplete(client, slug, extra);
+  const status = final.result?.status ?? final.status;
+  const videoUrl = final.result?.video_url ?? null;
+  const terminal = status === "completed" || status === "failed";
+  let saved_to;
+  if (videoUrl && args.save_path) {
+    saved_to = (await downloadTo(videoUrl, args.save_path)).saved_to;
+  }
+  const note = status === "completed" ? "Done. Presigned ~24h URL — download promptly." : status === "failed" ? "Render failed — the 1 credit was refunded. Retry with the same slug." : `Still rendering — resume with create_tracking_video({ slug: "${slug}"${args.save_path ? `, save_path: "${args.save_path}"` : ""} }), or poll wait_for_completion({ slug: "${slug}", kind: "tracking" }). It may still fail+refund.`;
+  return ok({
+    slug,
+    kind: "tracking",
+    status,
+    terminal,
+    video_url: videoUrl,
+    ...saved_to ? { saved_to } : {},
+    note
+  }, videoUrl ? [mp4Link(videoUrl, slug)] : []);
+}));
 registerTool("generate_short", {
   title: "Generate (render) a short",
   description: "Deducts 15 credits and starts the render pipeline for an existing short. Safe to call again: a " + "duplicate while a render is in flight is reported as in-progress (no double charge), and a failed " + "short can be re-generated. Then poll with get_status or wait_for_completion (kind=short).",
   inputSchema: { slug: exports_external.string().describe("Short slug from create_short") },
-  annotations: { title: "Generate short", ...WRITE, idempotentHint: true }
+  annotations: { title: "Generate short", ...WRITE }
 }, tool(async (args, client) => {
   try {
     const res = await client.post(`/shorts/${args.slug}/generate`);
@@ -30382,6 +32003,7 @@ registerTool("create_slider", {
     accent_color: exports_external.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("Brand accent: must start with #, exactly 6 hex digits, e.g. #09EFBE"),
     text_position: exports_external.enum(["top", "middle", "bottom"]).optional().describe("Vertical placement of the on-image copy across all slides. Omit for the template's natural placement.")
   },
+  outputSchema: createDraftOutput,
   annotations: { title: "Create slider", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
   if (args.slide_count !== undefined) {
@@ -30402,7 +32024,7 @@ registerTool("create_slider", {
     body.accent_color = args.accent_color;
   if (args.text_position !== undefined)
     body.text_position = args.text_position;
-  const res = await client.post("/sliders", body, idemKey("create-slider", args.prompt, args.mode ?? "", args.template ?? ""));
+  const res = await client.post("/sliders", body, sliderCreateKey(args));
   return ok({
     slug: res.data.slug,
     kind: "slider",
@@ -30415,7 +32037,7 @@ registerTool("generate_slider", {
   inputSchema: {
     slug: exports_external.string().describe("Slider slug from create_slider")
   },
-  annotations: { title: "Generate slider", ...WRITE, idempotentHint: true }
+  annotations: { title: "Generate slider", ...WRITE }
 }, tool(async (args, client) => {
   try {
     const res = await client.post(`/sliders/${args.slug}/generate`);
@@ -30436,6 +32058,7 @@ registerTool("get_slider", {
   title: "Get carousel status + deliverable",
   description: "Returns the carousel's status and, when completed, the per-slide image URLs (download these), the " + "per-slide headline/body/kicker, the caption, and the hashtags. status flows draft → processing → " + "completed | failed. completed:true means every slide image_url is ready to save. Once completed you " + "can restyle_slider (new template/accent) or edit_slider_slide (one slide's text) for free.",
   inputSchema: { slug: exports_external.string().describe("Slider slug") },
+  outputSchema: getSliderOutput,
   annotations: { title: "Get slider", ...RO }
 }, tool(async (args, client) => {
   const res = await client.get(`/sliders/${args.slug}`);
@@ -30497,7 +32120,7 @@ registerTool("restyle_slider", {
       next: "poll get_slider until status is 'completed' (free re-composite, 0 credits)"
     });
   } catch (e) {
-    if (e.status === 409) {
+    if (isRecompositeInProgressConflict(e)) {
       return ok({ slug: args.slug, kind: "slider", status: "processing" });
     }
     throw e;
@@ -30537,7 +32160,7 @@ registerTool("edit_slider_slide", {
       next: "poll get_slider until the slide's status is 'completed' (free re-composite, 0 credits)"
     });
   } catch (e) {
-    if (e.status === 409) {
+    if (isRecompositeInProgressConflict(e)) {
       return ok({
         slug: args.slug,
         kind: "slider",
@@ -30553,39 +32176,69 @@ registerTool("create_editor_ad", {
   description: "Creates an editor project from a product prompt and starts autopilot (server-orchestrated " + "scenario → segments → narration → voice → music → render). Each AI-generated scene is a fixed 8 seconds. " + "Returns the slug. Costs credits. Then poll with get_status / wait_for_completion (kind=editor). Prefer " + "make_video for the one-shot path. " + "BRANDING: to attach the user's own product image, brand logo, or closing card, create the draft with " + "create_editor_draft first, call set_product / set_logo / set_closing_image (all 0 credits), then " + "start_autopilot — autopilot weaves them in. (Editor ads carry their copy in-scene/narration, not as a " + "title overlay; for an on-screen title/subtitle use a short with headline/subheadline instead.)",
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("Brief for the ad (min 10 chars)"),
-    language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
+    product_subject: exports_external.string().max(300).optional().describe('The concrete product or main subject the video must be about (e.g. "Bordeaux red wine, dark green ' + 'bottle with a gold label"). Distinct from the freeform brief: hard-grounds the AI scenario + narration ' + "so it cannot invent an unrelated product. Strongly recommended for ads."),
+    project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("social_ad for promotional/ad content (product focus + CTA), creative_story for brand narratives " + "(default)."),
+    language: exports_external.string().optional().describe('Language code, e.g. "en" (default), "fr", "es". Drives the WHOLE video: scenario, narration script, ' + "narration voice, and captions. Ask the user / infer from their locale."),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Narrative arc / segment structure. Omit for Auto/generic."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual style direction and render look. Good default: kinetic_creator. When set it drives the look and a theme of 'none' is ignored."),
     theme: exports_external.string().optional().describe('Visual theme / genre overlay (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id (see list_voices); omit for the default voice"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")')
   },
+  outputSchema: createEditorOutput,
   annotations: { title: "Create editor ad", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
+  const langErr = validateLanguage(args.language);
+  if (langErr)
+    return fail(langErr);
+  const promptErr = validateProductPrompt(args.product_prompt);
+  if (promptErr)
+    return fail(promptErr);
   const created = await client.post("/editor", {
     language: args.language ?? "en",
     product_prompt: args.product_prompt,
+    product_subject: args.product_subject,
+    project_intent: args.project_intent,
     creative_format: args.creative_format,
     visual_language: args.visual_language,
     theme: args.theme,
     voice_id: args.voice_id,
     export_aspect_ratio: args.export_aspect_ratio
-  }, idemKey("create-editor", String(args.product_prompt ?? ""), String(args.language ?? "en"), String(args.creative_format ?? ""), String(args.visual_language ?? ""), String(args.theme ?? ""), String(args.voice_id ?? ""), String(args.export_aspect_ratio ?? "")));
+  }, editorAdCreateKey(args));
   const slug = created.data.slug;
-  const started = await client.post(`/editor/${slug}/autopilot`, undefined, `autopilot:${slug}`);
+  const started = await client.post(`/editor/${slug}/autopilot`, undefined, editorAdAutopilotKey(slug, args));
   const status = normalizeStatus("editor", slug, asRecord(started).data);
   return ok({ slug, kind: "editor", status, next: "wait_for_completion" });
 }));
 registerTool("start_autopilot", {
   title: "Start autopilot on an existing editor draft",
-  description: "Starts server-orchestrated autopilot (scenario → segments → narration → voice → music → render) on an " + "EXISTING editor project/draft. Spends credits — preview the estimate first with the autopilot/cost endpoint " + "or make_video({ dry_run:true }). Idempotent per slug (safe to retry). Use this to run a draft created by " + "make_video dry_run, or to resume after topping up / raising your spend cap. Then poll with " + 'wait_for_completion({ slug, kind: "editor" }).',
-  inputSchema: { slug: exports_external.string().describe("Editor project slug") },
-  annotations: { title: "Start autopilot", ...WRITE, idempotentHint: true }
+  description: "Starts server-orchestrated autopilot (scenario → segments → narration → voice → music → render) on an " + "EXISTING editor project/draft. Spends credits — preview the estimate first with the autopilot/cost endpoint " + "or make_video({ dry_run:true }). Each call is a genuine start attempt (like tapping Launch in the app): " + "if a run is already in progress for this slug the server returns already_running — it never double-starts " + "or double-charges. Once finished, failed, or cancelled, calling again relaunches it (resume after a top-up, raising your spend cap, or a mid-pipeline failure). Then poll with " + 'wait_for_completion({ slug, kind: "editor" }).',
+  inputSchema: {
+    slug: exports_external.string().describe("Editor project slug"),
+    language: exports_external.string().optional().describe('Optional language override applied before launch (ISO 639-1, e.g. "fr"). Drives scenario, ' + "narration, voice, and captions."),
+    product_subject: exports_external.string().max(300).optional().describe("Optional locked product / main subject applied before launch so the AI cannot invent an " + "unrelated product."),
+    product_prompt: exports_external.string().optional().describe("Optional freeform brief to set/replace before launch.")
+  },
+  annotations: { title: "Start autopilot", ...WRITE, idempotentHint: false }
 }, tool(async (args, client) => {
-  const started = await client.post(`/editor/${args.slug}/autopilot`, undefined, `autopilot:${args.slug}`);
-  const status = normalizeStatus("editor", args.slug, asRecord(started).data);
+  const langErr = validateLanguage(args.language);
+  if (langErr)
+    return fail(langErr);
+  const promptErr = validateProductPrompt(args.product_prompt);
+  if (promptErr)
+    return fail(promptErr);
+  const slug = args.slug;
+  const overrides = {};
+  if (args.language !== undefined)
+    overrides.language = args.language;
+  if (args.product_subject !== undefined)
+    overrides.product_subject = args.product_subject;
+  if (args.product_prompt !== undefined)
+    overrides.product_prompt = args.product_prompt;
+  const started = await client.post(`/editor/${slug}/autopilot`, Object.keys(overrides).length > 0 ? overrides : undefined, idemKey("autopilot", slug, randomUUID()));
+  const status = normalizeStatus("editor", slug, asRecord(started).data);
   return ok({
-    slug: args.slug,
+    slug,
     kind: "editor",
     status,
     next: "wait_for_completion"
@@ -30612,14 +32265,16 @@ registerTool("create_editor_draft", {
   description: "Creates an editor project from a product prompt and stops (NO autopilot). Costs 0 credits. Returns the " + "slug. Use this to drive the pipeline step by step (vs create_editor_ad which runs autopilot end to end). " + "Each AI-generated scene renders to a fixed 8 seconds (uploaded clips keep their own length). " + "product_prompt is optional content: send 10–5000 chars, or omit it entirely (empty is treated as omit).",
   inputSchema: {
     product_prompt: exports_external.string().min(10).max(5000).optional().describe("Brief for the ad — 10–5000 chars, or omit entirely"),
-    language: exports_external.string().min(2).max(10).optional().describe('Language code, e.g. "en" (default)'),
+    product_subject: exports_external.string().max(300).optional().describe("The concrete product / main subject the video must be about. Hard-grounds the AI so it cannot " + "invent an unrelated product. Recommended for ads."),
+    language: exports_external.string().min(2).max(10).optional().describe('Language code, e.g. "en" (default). Drives scenario, narration, voice, and captions.'),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Narrative arc / segment structure. Omit for Auto/generic."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual style direction and render look. Good default: kinetic_creator. When set it drives the look and a theme of 'none' is ignored."),
     theme: exports_external.string().optional().describe('Visual theme / genre overlay (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),
     voice_id: exports_external.string().regex(/^[A-Za-z0-9_-]+$/).max(64).optional().describe("Preferred narration voice id (see list_voices); ≤64 chars, [A-Za-z0-9_-] only"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")'),
-    project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("Project intent (optional)")
+    project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("social_ad for promotional/ad content (product focus + CTA), creative_story for brand " + "narratives (default).")
   },
+  outputSchema: createEditorOutput,
   annotations: {
     title: "Create editor draft",
     ...WRITE,
@@ -30629,6 +32284,7 @@ registerTool("create_editor_draft", {
   const prompt = args.product_prompt?.trim();
   const body = {
     language: args.language ?? "en",
+    product_subject: args.product_subject,
     creative_format: args.creative_format,
     visual_language: args.visual_language,
     theme: args.theme,
@@ -30638,7 +32294,7 @@ registerTool("create_editor_draft", {
   };
   if (prompt)
     body.product_prompt = prompt;
-  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.language ?? "en", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
+  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.product_subject ?? "", args.project_intent ?? "", args.language ?? "en", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.voice_id ?? "", args.export_aspect_ratio ?? ""));
   return ok({
     slug: created.data.slug,
     kind: "editor",
@@ -30697,7 +32353,7 @@ registerTool("generate_scenario", {
 }));
 registerTool("set_scene_count", {
   title: "Set the number of scenes",
-  description: "Adjusts the editor to exactly `count` scenes (1–20) by adding pending segments to grow, or deleting " + "only TRAILING un-generated (pending) segments to shrink. Never deletes completed/processing segments — " + "if a shrink would require that, it stops and reports. Free (no credits, no assist). Each AI-generated " + "scene is a fixed 8 seconds, so `count` scenes ≈ count×8s of AI footage (uploaded clips keep their own length).",
+  description: "Adjusts the editor to exactly `count` scenes (1–20) by adding pending segments to grow, or deleting " + "only TRAILING un-generated (pending or failed) segments to shrink. Never deletes completed/processing segments — " + "if a shrink would require that, it stops and reports. Free (no credits, no assist). Each AI-generated " + "scene is a fixed 8 seconds, so `count` scenes ≈ count×8s of AI footage (uploaded clips keep their own length).",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     count: exports_external.number().int().min(1).max(20).describe("Target scene count (1–20)")
@@ -30710,8 +32366,9 @@ registerTool("set_scene_count", {
   const current = segments.length;
   const target = args.count;
   if (target > current) {
+    const growNonce = randomUUID();
     for (let i = current;i < target; i++) {
-      await client.post(`/editor/${args.slug}/segments`, {}, idemKey("add-segment", args.slug, String(i)));
+      await client.post(`/editor/${args.slug}/segments`, {}, addSegmentKey(args.slug, i, growNonce));
     }
   } else if (target < current) {
     const isPending = (s) => {
@@ -30725,7 +32382,7 @@ registerTool("set_scene_count", {
       removable++;
     }
     if (current - removable > target) {
-      return fail(`Cannot shrink to ${target} scenes: only ${removable} trailing pending segment(s) are safe to ` + `delete (the rest are completed/processing). Currently ${current} scenes.`);
+      return fail(`Cannot shrink to ${target} scenes: only ${removable} trailing un-generated (pending/failed) segment(s) are safe ` + `to delete (the rest are completed/processing). Currently ${current} scenes.`);
     }
     for (let i = segments.length - 1;i >= target; i--) {
       const seg = segments[i];
@@ -30773,7 +32430,7 @@ registerTool("generate_segment", {
 }));
 registerTool("generate_all_segments", {
   title: "Generate all pending segments (sequential)",
-  description: "Generates every not-yet-completed scene (pending or previously failed) in position order, waiting for each to finish before starting" + "the next (preserves visual continuity). Each AI-generated scene is a fixed 8 seconds, so N scenes ≈ N×8s of footage. Costs 5 credits per segment generated. Stops and reports what " + "completed if a scene errors on submit (e.g. 402 credits_insufficient) or fails while rendering; if a " + "scene is still rendering past the budget it returns timed_out so you can re-run to continue (completed " + "scenes are skipped). Tip: to generate everything at lowest cost, skip this and just call render — it auto-generates any ungenerated scenes at the batch rate (4 credits/scene for ≥3); use this tool when you want to review or stop per scene. May take several minutes.",
+  description: "Generates every not-yet-completed scene (pending or previously failed) in position order, waiting for each to finish before starting" + "the next (preserves visual continuity). Each AI-generated scene is a fixed 8 seconds, so N scenes ≈ N×8s of footage. Costs 5 credits per segment generated. Stops and reports what " + "completed if a scene errors on submit (e.g. 402 credits_insufficient) or fails while rendering; if a " + "scene is still rendering past the budget it returns timed_out so you can re-run to continue (completed " + "scenes are skipped). The whole call is capped at ~280s: on a project with many scenes it processes as " + "many as fit, returns timed_out, and you re-run to continue (it picks up the remaining pending scenes). " + "Tip: to generate everything at lowest cost, skip this and just call render — it auto-generates any ungenerated scenes at the batch rate (4 credits/scene for ≥3); use this tool when you want to review or stop per scene. May take several minutes.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: {
     title: "Generate all segments",
@@ -30788,6 +32445,8 @@ registerTool("generate_all_segments", {
     const st = s.status ?? s.generation_status;
     return st === undefined || st === "pending" || st === "draft" || st === "failed";
   });
+  const overallDeadline = Date.now() + 280000;
+  const PER_SEGMENT_MAX_MS = 6 * 60 * 1000;
   const generated = [];
   let n = 0;
   for (const seg of pending) {
@@ -30795,6 +32454,15 @@ registerTool("generate_all_segments", {
     if (id === undefined)
       continue;
     const sid = id;
+    const remainingMs = overallDeadline - Date.now();
+    if (remainingMs <= 0) {
+      return ok({
+        slug: args.slug,
+        generated,
+        timed_out: true,
+        note: "Wall-clock budget reached — stopped before the next scene. Re-run generate_all_segments to continue (it retries failed/pending scenes and skips completed ones)."
+      });
+    }
     await reportProgress(extra, ++n, `generating segment ${String(sid)} (${n}/${pending.length})`, pending.length);
     try {
       await client.post(`/editor/${args.slug}/segments/${String(sid)}/generate`, undefined, undefined);
@@ -30807,7 +32475,7 @@ registerTool("generate_all_segments", {
         note: "Stopped on first error — fix the cause (often credits) and re-run; completed scenes are skipped, failed/pending are retried."
       });
     }
-    const seg_result = await pollSegmentToTerminal(client, args.slug, sid, extra, 6 * 60 * 1000, 15000);
+    const seg_result = await pollSegmentToTerminal(client, args.slug, sid, extra, Math.min(PER_SEGMENT_MAX_MS, remainingMs), 15000);
     if (seg_result.status === "failed") {
       return ok({
         slug: args.slug,
@@ -31009,7 +32677,7 @@ async function pollUploadToReady(client, slug, uploadId, extra, budgetMs, interv
   let { status, error: error2 } = await read();
   while (status !== "ready" && status !== "failed" && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `upload ${uid}: ${status}`);
-    await sleep2(intervalMs);
+    await sleep4(intervalMs);
     ({ status, error: error2 } = await read());
   }
   return {
@@ -31031,7 +32699,8 @@ registerTool("upload_video", {
   annotations: { title: "Upload video", ...WRITE, idempotentHint: false }
 }, tool(async (args, client, extra) => {
   const uploaded = await uploadVideoFile(client, args.slug, args.file_path, {
-    fitMode: args.fit_mode
+    fitMode: args.fit_mode,
+    onProgress: (completed, total, message) => reportProgress(extra, completed, message, total)
   });
   await reportProgress(extra, 0, `uploaded ${uploaded.upload_id}, processing…`);
   const waitSeconds = Math.min(280, Math.max(10, args.max_wait_seconds ?? 240));
@@ -31231,8 +32900,9 @@ registerTool("set_short_poster", {
 }));
 registerTool("get_status", {
   title: "Get generation status",
-  description: "Returns a normalized status {stage, terminal, ready, video_url, error} for a short or editor " + "project. ready:true means the post-ready MP4 is at video_url.",
+  description: "Returns a normalized status {stage, terminal, ready, video_url, error} for a short, editor, " + "tracking, or slider project. ready:true means the post-ready MP4 is at video_url — except for a " + "slider (a carousel of stills, not a video): its video_url is always null, ready:true means every " + "slide is composited, and you read the per-slide image URLs with get_slider.",
   inputSchema: { slug: exports_external.string(), kind: kindSchema },
+  outputSchema: getStatusOutput,
   annotations: { title: "Get status", ...RO }
 }, tool(async (args, client) => {
   const status = await fetchStatus(client, args.kind, args.slug);
@@ -31240,7 +32910,7 @@ registerTool("get_status", {
 }));
 registerTool("wait_for_completion", {
   title: "Wait for a render to finish",
-  description: "Polls status (emitting progress) until terminal (ready/failed) or the wait budget is exhausted. " + "Generation can take several minutes; if it returns terminal=false, call again to keep waiting. " + "Pass save_path to download the finished MP4 when it's ready (e.g. to resume a make_video that timed out mid-render).",
+  description: "Polls status (emitting progress) until terminal (ready/failed) or the wait budget is exhausted. " + "Generation can take several minutes; if it returns terminal=false, call again to keep waiting. " + "Pass save_path to download the finished MP4 when it's ready (e.g. to resume a make_video that timed out mid-render). " + 'Works for kind:"slider" too, but a carousel has no MP4 — it just goes terminal when composited; read the slide ' + "images with get_slider (save_path is ignored for sliders).",
   inputSchema: {
     slug: exports_external.string(),
     kind: kindSchema,
@@ -31248,7 +32918,12 @@ registerTool("wait_for_completion", {
     poll_interval_seconds: exports_external.number().int().min(5).max(60).optional().describe("Default 15"),
     save_path: exports_external.string().optional().describe("Optional .mp4 path to download to when ready (confined to HUBFLUENCER_OUTPUT_DIR or cwd)")
   },
-  annotations: { title: "Wait for completion", ...RO }
+  outputSchema: waitForCompletionOutput,
+  annotations: {
+    title: "Wait for completion",
+    ...WRITE,
+    idempotentHint: true
+  }
 }, tool(async (args, client, extra) => {
   if (args.save_path)
     resolveSavePath(args.save_path);
@@ -31265,14 +32940,18 @@ registerTool("wait_for_completion", {
 }));
 registerTool("download_result", {
   title: "Get / download the finished video",
-  description: "Returns the post-ready MP4 URL for a completed project (presigned, ~24h TTL — use promptly). " + "If save_path is given (confined to HUBFLUENCER_OUTPUT_DIR or cwd), the file is downloaded there.",
+  description: "Returns the post-ready MP4 URL for a completed project (presigned, ~24h TTL — use promptly). " + "If save_path is given (confined to HUBFLUENCER_OUTPUT_DIR or cwd), the file is downloaded there. " + "Not for sliders — a carousel has no MP4; use get_slider for its slide images.",
   inputSchema: {
     slug: exports_external.string(),
     kind: kindSchema,
     save_path: exports_external.string().optional().describe("Optional .mp4 path inside the output base")
   },
-  annotations: { title: "Download result", ...RO }
+  outputSchema: downloadResultOutput,
+  annotations: { title: "Download result", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
+  if (args.kind === "slider") {
+    return fail("A slider (carousel) has no MP4 to download. Use get_slider to read the per-slide image URLs.");
+  }
   const status = await fetchStatus(client, args.kind, args.slug);
   if (!status.ready || !status.video_url) {
     return fail(`Not ready to download (stage=${status.stage}, ready=${status.ready}). Wait for completion first.`);
@@ -31287,6 +32966,900 @@ registerTool("download_result", {
     note: "Presigned ~24h URL — download promptly."
   }, link);
 }));
+registerTool("extract_product_page", {
+  title: "Extract product facts from a URL",
+  description: "Fetches a public product page SERVER-SIDE (SSRF-guarded, HTML-only, no redirects to internal ranges) " + "and returns parsed product facts: name, description, benefits, price, brand, plus candidate product " + "image URLs and a site/brand logo URL (URLs only — images are NOT downloaded here). Stateless: writes " + "nothing and spends 0 credits. Scope: video:generate. Rate limit: 30/min. " + "Next: create_product_profile from these facts, then import_product_image to pull the primary image + logo " + "into the profile — or just call create_campaign to do all of that end to end.",
+  inputSchema: {
+    url: exports_external.string().max(2048).describe("Absolute http(s) URL of a product page (≤2048 chars)")
+  },
+  annotations: {
+    title: "Extract product page",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const url = args.url?.trim();
+  if (!url)
+    return fail("url is required.");
+  const res = await client.post("/product-sources/extract", { url });
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("import_product_image", {
+  title: "Import a product image URL into a profile",
+  description: "Fetches an image at a public URL SERVER-SIDE (SSRF-guarded, JPEG/PNG only — verified by magic bytes, not " + "just the Content-Type — size-capped) and stores it as a ready catalog asset, linking it to a product " + "profile. link_as 'primary_image' (default) sets the profile's product image; 'logo' sets its logo. " + "Spends 0 credits. Scope: video:generate. Rate limit: 30/min. Use the image/logo URLs from " + "extract_product_page. 404 if the product profile isn't yours; 422 if the URL isn't a safe JPG/PNG.",
+  inputSchema: {
+    product_profile_id: exports_external.number().int().describe("Id of one of YOUR product profiles to link the image to"),
+    url: exports_external.string().max(2048).describe("Absolute http(s) URL of a JPG/PNG image (≤2048 chars)"),
+    link_as: exports_external.enum(["primary_image", "logo"]).optional().describe("Which profile field to set: 'primary_image' (default) or 'logo'")
+  },
+  annotations: {
+    title: "Import product image",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const url = args.url?.trim();
+  if (!url)
+    return fail("url is required.");
+  const body = {
+    image_url: url,
+    product_profile_id: args.product_profile_id
+  };
+  if (args.link_as !== undefined)
+    body.link_as = args.link_as;
+  const res = await client.post("/product-sources/import-image", body);
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("list_product_profiles", {
+  title: "List your product profiles",
+  description: "Lists your saved product fact sheets (name, benefits, offer, audience, CTA, compliance constraints, " + "imported image/logo keys), newest first. Read-only, 0 credits. Scope: video:read. Pass an id to plan_campaign / " + "generate_hook_variations / create_campaign_pack so a campaign is planned from a saved source of truth.",
+  inputSchema: {},
+  annotations: { title: "List product profiles", ...RO }
+}, tool(async (_args, client) => ok(await client.get("/product-profiles"))));
+registerTool("create_product_profile", {
+  title: "Create a product profile",
+  description: "Saves a reusable product fact sheet. Only `name` is required; the rest (description, benefits[], offer, " + "proof_points[], audience, cta, banned_claims[], brand_tone) ground the AI when planning/generating. " + "0 credits. Scope: video:generate. Tip: seed it from extract_product_page's facts. To attach imagery, call " + "import_product_image afterwards (sets primary_image/logo).",
+  inputSchema: {
+    name: exports_external.string().min(1).max(300).describe("Product name (required)"),
+    description: exports_external.string().max(4000).optional().describe("What the product is / does"),
+    benefits: exports_external.array(exports_external.string()).optional().describe("Key benefit statements"),
+    offer: exports_external.string().max(500).optional().describe("Headline offer / price / promotion"),
+    proof_points: exports_external.array(exports_external.string()).optional().describe("Ratings, review counts, other proof points"),
+    audience: exports_external.string().max(500).optional().describe("Target audience"),
+    cta: exports_external.string().max(300).optional().describe("Preferred call to action"),
+    banned_claims: exports_external.array(exports_external.string()).optional().describe("Claims the product must never make"),
+    brand_tone: exports_external.string().max(500).optional().describe("Tone of voice for generated copy"),
+    source_url: exports_external.string().max(2048).optional().describe("Product page URL the facts came from")
+  },
+  annotations: {
+    title: "Create product profile",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await client.post("/product-profiles", pickProductProfileFields(args));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("update_product_profile", {
+  title: "Update a product profile",
+  description: "Patches a saved product profile — only the fields you pass change. 0 credits. Scope: video:generate. " + "404 for an unknown/foreign id.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Product profile id"),
+    name: exports_external.string().min(1).max(300).optional().describe("Product name"),
+    description: exports_external.string().max(4000).optional(),
+    benefits: exports_external.array(exports_external.string()).optional(),
+    offer: exports_external.string().max(500).optional(),
+    proof_points: exports_external.array(exports_external.string()).optional(),
+    audience: exports_external.string().max(500).optional(),
+    cta: exports_external.string().max(300).optional(),
+    banned_claims: exports_external.array(exports_external.string()).optional(),
+    brand_tone: exports_external.string().max(500).optional(),
+    source_url: exports_external.string().max(2048).optional()
+  },
+  annotations: {
+    title: "Update product profile",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.patch(`/product-profiles/${args.id}`, pickProductProfileFields(args));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("list_brand_profiles", {
+  title: "List your brand profiles",
+  description: "Lists your saved brand identities (name, logo key, colors, font, tone words, default CTA/audience, " + "preferred visual_language/creative_format, and linked assets), newest first. Read-only, 0 credits. " + "Scope: video:read. Pass an id as brand_profile_id to generate_hook_variations / create_campaign_pack / " + "create_campaign to steer tone/format and inherit the logo into materialized drafts.",
+  inputSchema: {},
+  annotations: { title: "List brand profiles", ...RO }
+}, tool(async (_args, client) => ok(await client.get("/brand-profiles"))));
+registerTool("create_brand_profile", {
+  title: "Create a brand profile",
+  description: "Saves a reusable brand identity. Only `name` is required. primary_color/secondary_color are hex " + "(e.g. #09EFBE); preferred_visual_language and preferred_creative_format take the same values as the " + "editor/short tools; tone_words[]/default_cta/default_audience/banned_claims[] steer generated copy. " + "0 credits. Scope: video:generate. Attach a logo/product asset from your catalog with " + "update_brand_profile (attach_catalog_asset_id).",
+  inputSchema: {
+    name: exports_external.string().min(1).max(300).describe("Brand name (required)"),
+    logo_s3_key: exports_external.string().optional().describe("S3 key of the brand logo (from an import/upload)"),
+    primary_color: exports_external.string().optional().describe("Hex color, e.g. #ffffff"),
+    secondary_color: exports_external.string().optional().describe("Hex color, e.g. #ffffff"),
+    font_family: exports_external.string().optional().describe("Brand typography (a supported Shorts overlay font)"),
+    tone_words: exports_external.array(exports_external.string()).optional().describe("Tone descriptors, e.g. ['bold','warm']"),
+    default_cta: exports_external.string().max(300).optional(),
+    default_audience: exports_external.string().max(500).optional(),
+    banned_claims: exports_external.array(exports_external.string()).optional(),
+    preferred_visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Default visual language for generated videos"),
+    preferred_creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Default creative format for generated videos")
+  },
+  annotations: {
+    title: "Create brand profile",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await client.post("/brand-profiles", pickBrandProfileFields(args));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("update_brand_profile", {
+  title: "Update a brand profile (+ attach/detach assets)",
+  description: "Patches a saved brand profile — only the fields you pass change. 0 credits. Scope: video:generate. " + "You can ALSO manage its catalog-asset links in the same call: attach_catalog_asset_id links one of your " + "catalog assets (role required: 'logo' | 'product_image' | 'other'); detach_asset_id removes an existing " + "link by its LINK id (from the profile's assets[].id, not the catalog_asset_id). 404 for an unknown/foreign " + "profile; 422 if the catalog asset isn't yours. Returns the updated profile with its assets.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Brand profile id"),
+    name: exports_external.string().min(1).max(300).optional(),
+    logo_s3_key: exports_external.string().optional(),
+    primary_color: exports_external.string().optional().describe("Hex color, e.g. #ffffff"),
+    secondary_color: exports_external.string().optional().describe("Hex color"),
+    font_family: exports_external.string().optional(),
+    tone_words: exports_external.array(exports_external.string()).optional(),
+    default_cta: exports_external.string().max(300).optional(),
+    default_audience: exports_external.string().max(500).optional(),
+    banned_claims: exports_external.array(exports_external.string()).optional(),
+    preferred_visual_language: exports_external.enum(VISUAL_LANGUAGES).optional(),
+    preferred_creative_format: exports_external.enum(CREATIVE_FORMATS).optional(),
+    attach_catalog_asset_id: exports_external.number().int().optional().describe("Link this catalog asset id to the profile (requires asset_role)"),
+    asset_role: exports_external.enum(["logo", "product_image", "other"]).optional().describe("Role for attach_catalog_asset_id (required when attaching)"),
+    detach_asset_id: exports_external.number().int().optional().describe("Remove this asset LINK id (assets[].id) from the profile")
+  },
+  annotations: {
+    title: "Update brand profile",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  if (args.attach_catalog_asset_id !== undefined && args.asset_role === undefined) {
+    return fail("asset_role is required when attach_catalog_asset_id is set ('logo' | 'product_image' | 'other').");
+  }
+  const fields = pickBrandProfileFields(args);
+  if (Object.keys(fields).length > 0) {
+    await client.patch(`/brand-profiles/${args.id}`, fields);
+  }
+  if (args.attach_catalog_asset_id !== undefined) {
+    await client.post(`/brand-profiles/${args.id}/assets`, {
+      catalog_asset_id: args.attach_catalog_asset_id,
+      role: args.asset_role
+    });
+  }
+  if (args.detach_asset_id !== undefined) {
+    await client.del(`/brand-profiles/${args.id}/assets/${args.detach_asset_id}`);
+  }
+  const res = await client.get(`/brand-profiles/${args.id}`);
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("plan_campaign", {
+  title: "Plan a campaign from product facts",
+  description: "Turns product facts (a saved product_profile_id OR an inline product with a name) into a campaign PLAN: " + "ad hooks, recommended output formats, a one-line positioning statement, and a transparent credit ESTIMATE " + "for the proposed paid outputs. Generates no media and persists nothing. Spends $0 — it consumes the FREE " + "daily AI-assist quota (NOT credits). Scope: video:generate. Rate limit: 30/min. On 429 the quota is " + "exhausted: set auto_unlock:true to spend 1 credit for +10 assists (retried once) or call unlock_ai_assists. " + "Next: generate_hook_variations for draftable variations, then create_campaign_pack.",
+  inputSchema: {
+    product_profile_id: exports_external.number().int().optional().describe("Id of a saved product profile (OR pass product)"),
+    product: exports_external.object({
+      name: exports_external.string(),
+      description: exports_external.string().optional(),
+      benefits: exports_external.array(exports_external.string()).optional(),
+      offer: exports_external.string().optional(),
+      proof_points: exports_external.array(exports_external.string()).optional(),
+      audience: exports_external.string().optional(),
+      cta: exports_external.string().optional(),
+      banned_claims: exports_external.array(exports_external.string()).optional()
+    }).optional().describe("Inline product facts (name required) if you have no profile"),
+    goal: exports_external.string().optional().describe("Campaign goal, e.g. awareness or conversion"),
+    platform: exports_external.string().optional().describe("Target platform, e.g. tiktok, instagram, reels, shorts"),
+    language: exports_external.string().optional().describe('Viewer-facing language code, e.g. "en" (default)'),
+    auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
+  },
+  annotations: {
+    title: "Plan campaign",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const srcErr = validatePlanSource(args.product_profile_id, args.product);
+  if (srcErr)
+    return fail(srcErr);
+  const body = buildPlanBody(args);
+  const res = await withAssist(client, args.auto_unlock ?? false, () => client.post("/campaign-packs/plan", body));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("generate_hook_variations", {
+  title: "Generate a hook variations board",
+  description: "Turns product facts (a saved product_profile_id OR an inline product with a name) and an OPTIONAL " + "brand_profile_id into 3-6 distinct hook variations — each with a hook, angle, suggested output format " + "(editor_ad/short/carousel), a draft script, a ready-to-post caption, hashtags, and a per-variation credit " + "ESTIMATE. Generates no media and persists nothing. Spends $0 — it consumes the FREE daily AI-assist quota " + "(NOT credits). Scope: video:generate. Rate limit: 30/min. On 429 set auto_unlock:true (1 credit → +10 " + "assists, retried once) or call unlock_ai_assists. Next: create_campaign_pack, then add_pack_variations to " + "persist + materialize the ones you pick as DRAFTS.",
+  inputSchema: {
+    product_profile_id: exports_external.number().int().optional().describe("Id of a saved product profile (OR pass product)"),
+    product: exports_external.object({
+      name: exports_external.string(),
+      description: exports_external.string().optional(),
+      benefits: exports_external.array(exports_external.string()).optional(),
+      offer: exports_external.string().optional(),
+      proof_points: exports_external.array(exports_external.string()).optional(),
+      audience: exports_external.string().optional(),
+      cta: exports_external.string().optional(),
+      banned_claims: exports_external.array(exports_external.string()).optional()
+    }).optional().describe("Inline product facts (name required) if you have no profile"),
+    brand_profile_id: exports_external.number().int().optional().describe("Optional saved brand profile to steer tone/format/banned claims"),
+    count: exports_external.number().int().optional().describe("Desired number of variations, clamped to 3-6 (default 4)"),
+    goal: exports_external.string().optional().describe("Campaign goal"),
+    platform: exports_external.string().optional().describe("Target platform, e.g. tiktok, instagram"),
+    language: exports_external.string().optional().describe('Viewer-facing language code, e.g. "en" (default)'),
+    auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
+  },
+  annotations: {
+    title: "Generate hook variations",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const srcErr = validatePlanSource(args.product_profile_id, args.product);
+  if (srcErr)
+    return fail(srcErr);
+  const body = buildPlanBody(args);
+  const res = await withAssist(client, args.auto_unlock ?? false, () => client.post("/campaign-packs/hook-variations", body));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("create_campaign_pack", {
+  title: "Persist a campaign pack",
+  description: "Stores a campaign pack (the planning container) plus any inline TEXT items (hook/caption copy). editor_ad/" + "short/carousel items are NOT created here — persist them via add_pack_variations (which also materializes " + "them into drafts). Spends 0 credits. Scope: video:generate. Link a product_profile_id and/or brand_profile_id " + "so materialized drafts inherit the product image + brand logo. Returns the pack id + items. Next: " + "add_pack_variations to fill it with draftable outputs.",
+  inputSchema: {
+    title: exports_external.string().max(300).optional().describe("Human-friendly pack name"),
+    product_profile_id: exports_external.number().int().optional().describe("Saved product profile to ground the pack (422 if not yours)"),
+    brand_profile_id: exports_external.number().int().optional().describe("Saved brand profile applied to the pack + materialized drafts"),
+    brief: exports_external.string().max(4000).optional().describe("Freeform brief for the campaign"),
+    source_type: exports_external.enum(["url", "image", "brief", "asset"]).optional().describe("Where the pack originated"),
+    source_url: exports_external.string().max(2048).optional().describe("Origin URL when source_type is 'url'"),
+    language: exports_external.string().optional().describe("Language stored on the pack + used for materialized draft copy"),
+    items: exports_external.array(exports_external.object({
+      kind: exports_external.enum(["hook", "caption"]).describe("Only hook/caption text items persist here"),
+      hook: exports_external.string().optional(),
+      caption: exports_external.string().optional(),
+      hashtags: exports_external.array(exports_external.string()).optional()
+    })).optional().describe("Optional inline hook/caption copy items")
+  },
+  annotations: {
+    title: "Create campaign pack",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const body = {};
+  if (args.title !== undefined)
+    body.title = args.title;
+  if (args.product_profile_id !== undefined)
+    body.product_profile_id = args.product_profile_id;
+  if (args.brand_profile_id !== undefined)
+    body.brand_profile_id = args.brand_profile_id;
+  if (args.brief !== undefined)
+    body.brief = args.brief;
+  if (args.source_type !== undefined)
+    body.source_type = args.source_type;
+  if (args.source_url !== undefined)
+    body.source_url = args.source_url;
+  if (args.language !== undefined)
+    body.language = args.language;
+  if (args.items !== undefined)
+    body.items = args.items;
+  const res = await client.post("/campaign-packs", body);
+  return ok(summarizePack(asRecord(res).data));
+}));
+registerTool("list_campaign_packs", {
+  title: "List your campaign packs",
+  description: "Lists your campaign packs (newest first) at the PACK level only: id, title, status, source, and linked " + "product/brand profile. It does NOT include per-item detail — the list endpoint doesn't load items, so " + "per-item kind/status/draft slug/deep-link route/credit estimate come from get_campaign_pack({ id }). " + "Read-only, 0 credits. Scope: video:read.",
+  inputSchema: {},
+  annotations: { title: "List campaign packs", ...RO }
+}, tool(async (_args, client) => {
+  const res = await client.get("/campaign-packs");
+  const data = asRecord(res).data;
+  const packs = Array.isArray(data) ? data.map(summarizePackListEntry) : [];
+  return ok({ packs });
+}));
+registerTool("get_campaign_pack", {
+  title: "Get one campaign pack with its items",
+  description: "Returns a campaign pack and its items. Per item you get: kind, status (planned → draft → generating → " + "completed | failed), the materialized DRAFT slug + deep-link route (editor_ad/short → the video project, " + "carousel → the slider), the per-item credit ESTIMATE, and — once an item has been generated — its " + "preview_url/video_result_id. Read-only, 0 credits. Scope: video:read. Use the draft slugs to generate each " + "output EXPLICITLY (a separate, PAID step): start_autopilot/generate for videos, generate_slider for carousels.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Campaign pack id")
+  },
+  outputSchema: getCampaignPackOutput,
+  annotations: { title: "Get campaign pack", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/campaign-packs/${args.id}`);
+  return ok(summarizePack(asRecord(res).data));
+}));
+registerTool("add_pack_variations", {
+  title: "Add + materialize hook variations to a pack",
+  description: "Persists a batch of selected hook variations (from generate_hook_variations) as items under a pack and, by " + "default (materialize:true), turns each into an editable DRAFT (a video project or image slider). Spends 0 " + "credits — nothing is generated/rendered (that's a separate PAID step). Scope: video:generate. Caps: at most " + "12 variations per call; rate-limited to 15/min. Per-variation BEST-EFFORT: a variation that can't be " + "materialized (e.g. you hit a draft limit) stays a 'planned' item with a recorded reason while the rest still " + "materialize — the response summary lists created/materialized/planned + skipped_reasons. Pass the variation " + "objects verbatim from the board (each needs at least suggested_format). Next: get_campaign_pack to review, " + "then generate each draft explicitly.",
+  inputSchema: {
+    pack_id: exports_external.number().int().describe("Campaign pack id (from create_campaign_pack)"),
+    variations: exports_external.array(exports_external.object({
+      suggested_format: exports_external.enum(["editor_ad", "short", "carousel"]).describe("Output kind for this variation"),
+      hook: exports_external.string().optional(),
+      angle: exports_external.string().optional(),
+      draft_script: exports_external.string().optional(),
+      caption: exports_external.string().optional(),
+      hashtags: exports_external.array(exports_external.string()).optional(),
+      credit_estimate: exports_external.record(exports_external.unknown()).optional()
+    })).describe("1-12 variations to persist (echo them from the board)"),
+    materialize: exports_external.boolean().optional().describe("Materialize each into a draft (default true); false keeps them planned")
+  },
+  annotations: {
+    title: "Add pack variations",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const err = validateVariationsBatch(args.variations);
+  if (err)
+    return fail(err);
+  const body = { variations: args.variations };
+  if (args.materialize !== undefined)
+    body.materialize = args.materialize;
+  const res = await client.post(`/campaign-packs/${args.pack_id}/variations`, body);
+  const data = asRecord(asRecord(res).data);
+  const items = Array.isArray(data.items) ? data.items.map(summarizePackItem) : [];
+  return ok({
+    campaign_pack_id: data.campaign_pack_id ?? args.pack_id,
+    items,
+    summary: data.summary ?? null,
+    next: "get_campaign_pack to review the drafts; generation/render is a separate, explicit, PAID step per draft."
+  });
+}));
+registerTool("materialize_pack_item", {
+  title: "Materialize one planned pack item into a draft",
+  description: "Turns a single PLANNED editor_ad/short/carousel item into an editable DRAFT (a video project or image " + "slider) and links it back to the item. Spends 0 credits — generation/render is a separate PAID step. " + "Scope: video:generate. Rate limit: 60/min. Safe to retry: NO duplicate draft is ever created (a concurrent " + "race loser converges on the same draft under a row lock). A SEQUENTIAL re-call of an already-materialized " + "item returns 422 ('already materialized') — that 422 means the draft already exists; read it via " + "get_campaign_pack. 422 also for hook/caption items or when you hit a draft limit. Prefer add_pack_variations " + "to materialize a batch at once; use this to (re)try one item.",
+  inputSchema: {
+    pack_id: exports_external.number().int().describe("Campaign pack id"),
+    item_id: exports_external.number().int().describe("Campaign pack item id (from get_campaign_pack)")
+  },
+  annotations: {
+    title: "Materialize pack item",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/campaign-packs/${args.pack_id}/items/${args.item_id}/materialize`);
+  return ok(summarizePackItem(asRecord(res).data));
+}));
+registerTool("create_campaign", {
+  title: "Create a whole campaign from a product (one shot)",
+  description: "The high-level path (like make_video, but for a content CAMPAIGN): give a product URL (or a saved " + "product_profile_id) and get back a persisted campaign pack full of editable DRAFTS. It runs the whole " + "pipeline — extract the page (if a url) → save a product profile → best-effort import the primary image + " + "logo → plan → generate hook variations → create the pack → add the variations as materialized DRAFTS. " + "Spends $0 end to end: it only ever touches the FREE daily AI-assist quota (plan + hook variations) and " + "creates 0-credit drafts. It NEVER starts autopilot/generation/render — that stays a SEPARATE, explicit, " + "PAID step you trigger per draft afterwards. Scope: video:generate. On a partial failure it returns " + "everything achieved so far (profile id, pack id, per-item status) plus precise resume guidance naming the " + "granular tool to continue with. The result lists each draft's slug + kind + per-item credit estimate.",
+  inputSchema: {
+    url: exports_external.string().max(2048).optional().describe("Product page URL to ingest (required unless product_profile_id is given)"),
+    product_profile_id: exports_external.number().int().optional().describe("Use a saved product profile instead of extracting a URL"),
+    brand_profile_id: exports_external.number().int().optional().describe("Optional saved brand profile — steers hooks and gives drafts your logo/brand"),
+    item_count: exports_external.number().int().optional().describe("How many variations to aim for, clamped to 3-6 (default 6)"),
+    formats: exports_external.array(exports_external.enum(["editor_ad", "short", "carousel"])).optional().describe("Restrict to these output formats (default: whatever the board recommends)"),
+    language: exports_external.string().optional().describe('Viewer-facing language code, e.g. "en" (default)'),
+    goal: exports_external.string().optional().describe("Campaign goal, e.g. conversion"),
+    platform: exports_external.string().optional().describe("Target platform, e.g. tiktok, instagram")
+  },
+  annotations: {
+    title: "Create campaign",
+    ...WRITE,
+    idempotentHint: false
+  },
+  outputSchema: createCampaignOutput
+}, tool(async (args, client) => {
+  if (!args.url && args.product_profile_id === undefined) {
+    return fail("Provide either url or product_profile_id.");
+  }
+  const result = await runCreateCampaign(client, args, (msg) => console.error(`[create_campaign] ${msg}`));
+  return ok(result);
+}));
+registerTool("create_series", {
+  title: "Create a recurring-content series",
+  description: "Creates a reusable recurring-content SHOW template (e.g. 'Myth vs Fact', 'Founder Tip') bound to an " + "optional brand + product profile — the durable format the episode planner draws upcoming ideas from. " + "name and template are required. Spends 0 credits. Scope: video:generate. A supplied " + "brand_profile_id/product_profile_id must be one of your own (422 invalid_brand_profile/" + "invalid_product_profile otherwise). Next: plan_series_episodes to draft idea episodes.",
+  inputSchema: {
+    name: exports_external.string().max(300).describe("Show name, e.g. 'Myth vs Fact' (required)"),
+    template: exports_external.enum([
+      "founder_tip",
+      "myth_vs_fact",
+      "before_after",
+      "customer_question",
+      "build_in_public",
+      "product_demo_of_the_week",
+      "mistake_to_avoid"
+    ]).describe("The recurring format/template (required). One of: founder_tip, myth_vs_fact, " + "before_after, customer_question, build_in_public, product_demo_of_the_week, mistake_to_avoid"),
+    brand_profile_id: exports_external.number().int().optional().describe("Optional saved brand profile the series (and its drafts) inherit"),
+    product_profile_id: exports_external.number().int().optional().describe("Optional saved product profile grounding episode ideas"),
+    cadence: exports_external.enum(["weekly", "biweekly", "monthly"]).optional().describe("Posting cadence: weekly, biweekly, or monthly (steers the ideas)"),
+    tone: exports_external.string().optional().describe("Editorial tone, e.g. playful, expert"),
+    default_format: exports_external.enum(["editor_ad", "short", "carousel"]).optional().describe("Default output format for materialized episodes"),
+    status: exports_external.enum(["active", "paused", "archived"]).optional().describe("Series status (default active)")
+  },
+  annotations: {
+    title: "Create series",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await client.post("/series", pickSeriesFields(args));
+  return ok(summarizeSeries(asRecord(res).data));
+}));
+registerTool("list_series", {
+  title: "List your series",
+  description: "Lists your recurring-content series (newest first), each summarized with its status, template, cadence, " + "tone, default format, and linked brand/product profile + rolling campaign pack ids. Read-only, 0 credits. " + "Scope: video:read. Use get_series_dashboard for one series' episodes grouped by lane.",
+  inputSchema: {},
+  annotations: { title: "List series", ...RO }
+}, tool(async (_args, client) => {
+  const res = await client.get("/series");
+  const data = asRecord(res).data;
+  const series = Array.isArray(data) ? data.map(summarizeSeries) : [];
+  return ok({ series });
+}));
+registerTool("update_series", {
+  title: "Update a series",
+  description: "Patches one of your series; only the fields you pass change. Toggle status among active/paused/archived " + "(a paused series stops surfacing for new ideas). A changed brand_profile_id/product_profile_id is " + "re-verified against your own profiles (422 otherwise). Spends 0 credits. Scope: video:generate. " + "404 for an unknown/foreign series.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Series id"),
+    name: exports_external.string().max(300).optional().describe("Show name"),
+    template: exports_external.enum([
+      "founder_tip",
+      "myth_vs_fact",
+      "before_after",
+      "customer_question",
+      "build_in_public",
+      "product_demo_of_the_week",
+      "mistake_to_avoid"
+    ]).optional().describe("Recurring format/template. One of: founder_tip, myth_vs_fact, before_after, " + "customer_question, build_in_public, product_demo_of_the_week, mistake_to_avoid"),
+    brand_profile_id: exports_external.number().int().optional().describe("Saved brand profile to bind (422 if not yours)"),
+    product_profile_id: exports_external.number().int().optional().describe("Saved product profile to bind (422 if not yours)"),
+    cadence: exports_external.enum(["weekly", "biweekly", "monthly"]).optional().describe("Posting cadence: weekly, biweekly, or monthly"),
+    tone: exports_external.string().optional().describe("Editorial tone"),
+    default_format: exports_external.enum(["editor_ad", "short", "carousel"]).optional().describe("Default output format for materialized episodes"),
+    status: exports_external.enum(["active", "paused", "archived"]).optional().describe("Series status")
+  },
+  annotations: { title: "Update series", ...WRITE, idempotentHint: false }
+}, tool(async (args, client) => {
+  const res = await client.patch(`/series/${args.id}`, pickSeriesFields(args));
+  return ok(summarizeSeries(asRecord(res).data));
+}));
+registerTool("plan_series_episodes", {
+  title: "Plan upcoming episode ideas for a series",
+  description: "Drafts 3-5 distinct upcoming EPISODE ideas (status 'idea') for one of your series, grounded on its " + "product profile (or name) and steered by its brand/tone/cadence, and persists them as episodes. " + "Generates no media and spends $0 — it consumes the FREE daily AI-assist quota (NOT credits). " + "Scope: video:generate. Rate limit: 30/min. On 429 the quota is exhausted: set auto_unlock:true to spend " + "1 credit for +10 assists (retried once) or call unlock_ai_assists. 404 for an unknown/foreign series. " + "Next: materialize_episode to turn a chosen idea into a 0-credit draft.",
+  inputSchema: {
+    series_id: exports_external.number().int().describe("Series id"),
+    count: exports_external.number().int().optional().describe("Desired number of ideas, clamped to 3-5 (default 4)"),
+    language: exports_external.string().optional().describe('Viewer-facing language code, e.g. "en" (default)'),
+    auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
+  },
+  annotations: {
+    title: "Plan series episodes",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const body = {};
+  if (args.count !== undefined)
+    body.count = args.count;
+  if (args.language !== undefined && args.language.trim() !== "")
+    body.language = args.language;
+  const res = await withAssist(client, args.auto_unlock ?? false, () => client.post(`/series/${args.series_id}/episodes/plan`, body));
+  const data = asRecord(asRecord(res).data);
+  const episodes = Array.isArray(data.episodes) ? data.episodes.map(summarizeEpisode) : [];
+  return ok({
+    series_id: args.series_id,
+    episodes,
+    ai_assist_quota: data.ai_assist_quota ?? null,
+    next: "materialize_episode({ series_id, episode_id }) to turn an idea into a 0-credit draft."
+  });
+}));
+registerTool("list_series_episodes", {
+  title: "List a series' episodes",
+  description: "Lists a series' episodes (position ascending), each summarized with its status (idea → drafted → " + "published), hook/brief/caption, suggested format, and — once materialized — the draft slug + deep-link " + "route (editor_ad/short → the video project, carousel → the slider). Optionally filter by status. " + "Read-only, 0 credits. Scope: video:read. 404 for an unknown/foreign series.",
+  inputSchema: {
+    series_id: exports_external.number().int().describe("Series id"),
+    status: exports_external.enum(["idea", "drafted", "published", "archived"]).optional().describe("Filter to one status")
+  },
+  annotations: { title: "List series episodes", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/series/${args.series_id}/episodes`, args.status ? { status: args.status } : undefined);
+  const data = asRecord(asRecord(res).data);
+  const episodes = Array.isArray(data.episodes) ? data.episodes.map(summarizeEpisode) : [];
+  return ok({ series_id: args.series_id, episodes });
+}));
+registerTool("materialize_episode", {
+  title: "Materialize an episode idea into a draft",
+  description: "Turns an 'idea' episode into an editable 0-credit DRAFT (a video project or image slider) grouped under " + "the series' rolling campaign pack and inheriting the series' brand. Spends 0 credits — generation/render " + "is a SEPARATE, explicit, PAID step. Scope: video:generate. Rate limit: 60/min. Safe to retry: NO duplicate " + "draft is ever created (a concurrent race loser converges on the same draft under a row lock). A SEQUENTIAL " + "re-call of an already-materialized episode returns 422 ('already materialized') — that 422 means the draft " + "already exists; find it via list_series_episodes / get_series_dashboard. 422 also for a non-idea episode or " + "when you hit a draft limit. Returns the drafted episode with its draft slug + kind; generate it explicitly " + "next (start_autopilot/generate for videos, generate_slider for carousels).",
+  inputSchema: {
+    series_id: exports_external.number().int().describe("Series id"),
+    episode_id: exports_external.number().int().describe("Episode id (from plan_series_episodes / list_series_episodes)")
+  },
+  annotations: {
+    title: "Materialize episode",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/series/${args.series_id}/episodes/${args.episode_id}/materialize`);
+  const episode = summarizeEpisode(asRecord(res).data);
+  return ok({
+    ...episode,
+    next: episode.draft_slug ? "Generate this draft EXPLICITLY (a separate, PAID step): editor_ad/short → start_autopilot({ slug }); carousel → generate_slider({ slug })." : "Draft created — review it with list_series_episodes."
+  });
+}));
+registerTool("get_series_dashboard", {
+  title: "Get a series dashboard",
+  description: "Returns a read-only overview of one series: the series plus its episodes grouped into lanes — upcoming " + "(ideas), drafted, and published — with per-item performance notes for episodes linked to a campaign-pack " + "item. Each drafted/published episode carries its draft slug + deep-link route. Read-only, 0 credits. " + "Scope: video:read. 404 for an unknown/foreign series.",
+  inputSchema: {
+    series_id: exports_external.number().int().describe("Series id")
+  },
+  outputSchema: getSeriesDashboardOutput,
+  annotations: { title: "Get series dashboard", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/series/${args.series_id}/dashboard`);
+  return ok(summarizeDashboard(asRecord(res).data));
+}));
+registerTool("mark_episode_posted", {
+  title: "Mark a drafted episode as posted",
+  description: "Records that you posted a DRAFTED episode MANUALLY (there is no platform posting API): flips the episode " + "'drafted' → 'published' (labelled 'Posted' in the app) and stamps posted_at, making the dashboard's " + "published lane reachable. Spends 0 credits. Scope: video:generate. Atomic — only a drafted episode " + "transitions; an idea or archived episode returns 422 invalid_status (materialize it into a draft first). " + "IDEMPOTENT on replay: re-marking an already-published episode returns 200 with the original posted_at " + "untouched. 404 for an unknown/foreign series or episode.",
+  inputSchema: {
+    series_id: exports_external.number().int().describe("Series id"),
+    episode_id: exports_external.number().int().describe("Episode id (must be a drafted episode)")
+  },
+  annotations: {
+    title: "Mark episode posted",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/series/${args.series_id}/episodes/${args.episode_id}/mark-posted`);
+  return ok(summarizeEpisode(asRecord(res).data));
+}));
+function calendarWrite(fn) {
+  return tool(async (args, client, extra) => {
+    try {
+      return await fn(args, client, extra);
+    } catch (e) {
+      const he = e;
+      if (he && he.status === 403) {
+        return fail(calendarScopeErrorText(he.status, he.code, errMessage(e)));
+      }
+      throw e;
+    }
+  });
+}
+registerTool("schedule_post", {
+  title: "Schedule a posting reminder for a finished video",
+  description: "Schedules one of your own COMPLETED video results for a FUTURE UTC instant as a manual-posting REMINDER: " + "a push notification fires to YOU at the scheduled time and you confirm the manual post with " + "mark_scheduled_posted. This tool is reminder-only — it never attaches a social account, so publishing " + "stays in your hands (auto-publish is app-only). Spends 0 credits. Scope: video:generate. Get the " + "video_result_id from a completed project's result (get_status/download_result) or list_scheduled_posts. " + `platform is your posting INTENT (${SCHEDULED_POST_PLATFORMS.join("/")}); "other" for anywhere else. ` + `Caption ≤${5000} chars; ≤${30} hashtags (each ≤${100}). At most ${MAX_PENDING_SCHEDULED_POSTS} pending ` + "reminders per account (422 scheduled_post_limit_reached beyond that — cancel or mark some posted first). " + "422 for a non-completed/foreign video result or a non-future instant.",
+  inputSchema: {
+    video_result_id: exports_external.number().int().describe("Id of one of your own COMPLETED video results (the render to post)"),
+    platform: exports_external.enum(SCHEDULED_POST_PLATFORMS).describe('Where you intend to post: tiktok, instagram, or "other"'),
+    scheduled_at: exports_external.string().describe("The UTC instant to be reminded, ISO-8601 (must be in the future)"),
+    caption: exports_external.string().optional().describe("Optional post caption to stage with the reminder (≤5000 chars)"),
+    hashtags: exports_external.array(exports_external.string()).optional().describe("Optional hashtags to stage (≤30, each ≤100 chars)"),
+    timezone: exports_external.string().optional().describe("Your chosen timezone (display only), e.g. Europe/Paris"),
+    campaign_pack_item_id: exports_external.number().int().optional().describe("Optional id of one of your own campaign pack items to group under")
+  },
+  annotations: {
+    title: "Schedule post reminder",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, calendarWrite(async (args, client) => {
+  const copyErr = validateScheduledPostCopy(args);
+  if (copyErr)
+    return fail(copyErr);
+  const res = await client.post("/scheduled-posts", buildScheduledPostBody(args));
+  return ok(summarizeScheduledPost(asRecord(res).data));
+}));
+registerTool("list_scheduled_posts", {
+  title: "List your scheduled posts (calendar)",
+  description: "Lists your scheduled posts (calendar) ordered by scheduled_at ascending, each summarized with its " + "platform, status, the staged caption/hashtags, the presigned export video_url (post it manually), and the " + "owning video's kind. Optionally narrow the window with from/to (ISO-8601 UTC) and/or filter by status " + `(${SCHEDULED_POST_STATUSES.join("/")}). Read-only, 0 credits. Scope: video:read. Account bindings are ` + "intentionally omitted (this surface is reminder-only).",
+  inputSchema: {
+    from: exports_external.string().optional().describe("Lower bound (inclusive) on scheduled_at, ISO-8601 UTC"),
+    to: exports_external.string().optional().describe("Upper bound (inclusive) on scheduled_at, ISO-8601 UTC"),
+    status: exports_external.enum(SCHEDULED_POST_STATUSES).optional().describe("Filter to one status")
+  },
+  outputSchema: listScheduledPostsOutput,
+  annotations: { title: "List scheduled posts", ...RO }
+}, tool(async (args, client) => {
+  const query = {};
+  if (args.from !== undefined)
+    query.from = args.from;
+  if (args.to !== undefined)
+    query.to = args.to;
+  if (args.status !== undefined)
+    query.status = args.status;
+  const res = await client.get("/scheduled-posts", Object.keys(query).length > 0 ? query : undefined);
+  const data = asRecord(res).data;
+  const posts = Array.isArray(data) ? data.map(summarizeScheduledPost) : [];
+  return ok({ posts });
+}));
+registerTool("reschedule_post", {
+  title: "Reschedule a scheduled post",
+  description: "Moves a still-'scheduled' or 'reminded' post to a new FUTURE instant (a reminded post is re-armed back to " + "'scheduled' — 'remind me later'). Spends 0 credits. Scope: video:generate. 422 not_reschedulable for a " + "post already posted/publishing/published/failed/canceled, or scheduled_in_past for a non-future/ malformed " + "instant. 404 for unknown/foreign ids. A 403 insufficient_scope means the targeted post carries a social " + "account (app-only) — reminder-only posts are reschedulable with video:generate.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Scheduled post id"),
+    scheduled_at: exports_external.string().describe("The new UTC instant, ISO-8601 (must be in the future)")
+  },
+  annotations: { title: "Reschedule post", ...WRITE, idempotentHint: false }
+}, calendarWrite(async (args, client) => {
+  const res = await client.patch(`/scheduled-posts/${args.id}`, { scheduled_at: args.scheduled_at });
+  return ok(summarizeScheduledPost(asRecord(res).data));
+}));
+registerTool("cancel_scheduled_post", {
+  title: "Cancel a scheduled post",
+  description: "Cancels a 'scheduled', 'reminded', or 'failed' post (status → 'canceled'); it will no longer fire. Spends " + "0 credits. Scope: video:generate. 422 not_cancelable for a post already posted/publishing/published/" + "canceled. 404 for unknown/foreign ids. A 403 insufficient_scope means the targeted post carries a social " + "account (app-only) — reminder-only posts are cancelable with video:generate.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Scheduled post id")
+  },
+  annotations: {
+    title: "Cancel scheduled post",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: false
+  }
+}, calendarWrite(async (args, client) => {
+  const res = await client.del(`/scheduled-posts/${args.id}`);
+  return ok(summarizeScheduledPost(asRecord(res).data));
+}));
+registerTool("mark_scheduled_posted", {
+  title: "Mark a scheduled post as posted (manual posting)",
+  description: "Records that you posted this content MANUALLY: transitions a 'scheduled' or 'reminded' post to 'posted' " + "and stamps posted_at. Spends 0 credits. Scope: video:generate (closing the manual-posting loop is allowed " + "for agent tokens). Atomic — a post in any other status (including an already-posted one, so a SECOND call) " + "returns 422 not_markable; this is NOT a replayable no-op. 404 for unknown/foreign ids. Touches no platform API.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Scheduled post id (a scheduled or reminded post)")
+  },
+  annotations: {
+    title: "Mark scheduled post posted",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/scheduled-posts/${args.id}/mark-posted`);
+  return ok(summarizeScheduledPost(asRecord(res).data));
+}));
+registerTool("record_performance", {
+  title: "Record a performance snapshot for a campaign-pack item",
+  description: "Attaches one performance snapshot (platform + engagement/conversion counts + optional revenue/watch " + "time) to one of your own campaign-pack items (item_id from get_campaign_pack). Many snapshots per item " + "are allowed — captured_at (defaults to now if omitted) distinguishes them, so you can log a trend over " + "time. Spends 0 credits. Scope: video:generate. Rate limit: 30/min. 404 for a foreign/unknown item; 422 " + "for invalid metrics. NOT idempotency-keyed — a transport retry records a DUPLICATE snapshot, so don't " + "blindly retry a success.",
+  inputSchema: {
+    item_id: exports_external.number().int().describe("Campaign-pack item id (from get_campaign_pack)"),
+    platform: exports_external.enum(PERFORMANCE_PLATFORMS).describe('Where it ran: tiktok, instagram, or "other"'),
+    views: exports_external.number().int().optional().describe("View count (≥0)"),
+    likes: exports_external.number().int().optional().describe("Like count (≥0)"),
+    comments: exports_external.number().int().optional().describe("Comment count (≥0)"),
+    shares: exports_external.number().int().optional().describe("Share count (≥0)"),
+    clicks: exports_external.number().int().optional().describe("Click count (≥0)"),
+    conversions: exports_external.number().int().optional().describe("Conversion count (≥0)"),
+    revenue: exports_external.number().optional().describe("Attributed revenue (≥0, ≤~1 trillion)"),
+    watch_time_seconds: exports_external.number().int().optional().describe("Total watch time in seconds (≥0)"),
+    source: exports_external.enum(PERFORMANCE_SOURCES).optional().describe("How the metrics were gathered (default manual)"),
+    captured_at: exports_external.string().optional().describe("When measured, ISO-8601 UTC (defaults to now; not future)"),
+    metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Optional provenance blob (≤16 KiB JSON)")
+  },
+  annotations: {
+    title: "Record performance",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const err = validatePerformanceMetrics(args);
+  if (err)
+    return fail(err);
+  const res = await client.post(`/campaign-pack-items/${args.item_id}/performance`, buildPerformanceBody(args));
+  return ok({
+    ...summarizePerformance(asRecord(res).data),
+    next: "set_item_attributes to tag this item's creative, then get_recommendations once a few items have both."
+  });
+}));
+registerTool("list_performance", {
+  title: "List a campaign-pack item's performance snapshots",
+  description: "Returns one of your own campaign-pack items' performance snapshots (newest first) plus a small summary " + "(latest snapshot + count). Read-only, 0 credits. Scope: video:read. 404 for a foreign/unknown item.",
+  inputSchema: {
+    item_id: exports_external.number().int().describe("Campaign-pack item id")
+  },
+  annotations: { title: "List performance", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/campaign-pack-items/${args.item_id}/performance`);
+  const data = asRecord(asRecord(res).data);
+  const performance = Array.isArray(data.performance) ? data.performance.map(summarizePerformance) : [];
+  return ok({
+    item_id: args.item_id,
+    performance,
+    summary: data.summary ?? null
+  });
+}));
+registerTool("set_item_attributes", {
+  title: "Set the creative attributes for a campaign-pack item",
+  description: "Inserts-or-updates the SINGLE creative-attributes row (hook_type, creative_format, visual_language, " + "product_category, cta, length, caption_style) for one of your own campaign-pack items — the tags the " + "recommendation loop correlates with performance. Calling it again UPDATES the same row (atomic upsert). " + "Spends 0 credits. Scope: video:generate. 404 for a foreign/unknown item; 422 for invalid attributes.",
+  inputSchema: {
+    item_id: exports_external.number().int().describe("Campaign-pack item id"),
+    hook_type: exports_external.string().optional().describe('The hook style, e.g. "question", "bold_claim"'),
+    creative_format: exports_external.string().optional().describe('Narrative format, e.g. "problem_solution"'),
+    visual_language: exports_external.string().optional().describe('Production treatment, e.g. "ugc_realism"'),
+    product_category: exports_external.string().optional().describe("Product category tag"),
+    cta: exports_external.string().optional().describe("Call-to-action used"),
+    length: exports_external.string().optional().describe('Length bucket, e.g. "short"'),
+    caption_style: exports_external.string().optional().describe("Caption style tag"),
+    metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Optional extra classifiers")
+  },
+  annotations: {
+    title: "Set item attributes",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.put(`/campaign-pack-items/${args.item_id}/attributes`, pickCreativeAttributeFields(args));
+  return ok(asRecord(res).data);
+}));
+registerTool("get_item_attributes", {
+  title: "Fetch the creative attributes for a campaign-pack item",
+  description: "Returns the single creative-attributes row for one of your own campaign-pack items, or null if none has " + "been set. Read-only, 0 credits. Scope: video:read. 404 for a foreign/unknown item.",
+  inputSchema: {
+    item_id: exports_external.number().int().describe("Campaign-pack item id")
+  },
+  annotations: { title: "Get item attributes", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/campaign-pack-items/${args.item_id}/attributes`);
+  return ok(asRecord(res).data ?? null);
+}));
+registerTool("get_recommendations", {
+  title: "Cautious creative recommendation from your own performance",
+  description: "Aggregates your own campaign-pack items that have BOTH creative attributes AND at least one performance " + "snapshot into a CAUTIOUS recommendation: the top-performing hook_type / creative_format / visual_language " + "by average views, your best items, and an HONEST confidence level. Confidence is a function of sample size " + 'and is returned as "none" (no data yet), "low", or "moderate" — it is NEVER overstated, and the result ' + "NEVER claims causation, ROAS, or attribution: these are correlations in YOUR OWN data, a hint to test, not " + "proof. Present the server's `note` and `confidence` as-is; do not upgrade them. Read-only; NO LLM; NO " + "video credits; NO quota. Scope: video:read.",
+  inputSchema: {},
+  outputSchema: getRecommendationsOutput,
+  annotations: { title: "Get recommendations", ...RO }
+}, tool(async (_args, client) => {
+  const res = await client.get("/performance/recommendations");
+  return ok(asRecord(res).data);
+}));
+registerTool("make_more_like_winner", {
+  title: "Make more hook variations like a winning item",
+  description: "Generates 3 follow-up hook variations from one of your own campaign-pack items, threading that item's " + "winning angle/format/hook into the generator while keeping its brand + product profile — the way to " + "double down on a proven creative. Generates no media, persists nothing, and spends NO video credits: it " + "consumes the FREE daily AI-assist quota instead (429 when exhausted; set auto_unlock:true to spend 1 credit " + "for +10 assists, retried once, or call unlock_ai_assists). Scope: video:generate. Rate limit: 30/min. 404 " + "for a foreign/unknown item; 422 when the item has no usable product context. These are new IDEAS — feed a " + "chosen one into add_pack_variations / create_campaign_pack to turn it into a draft.",
+  inputSchema: {
+    item_id: exports_external.number().int().describe("Campaign-pack item id of the winning creative"),
+    auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
+  },
+  annotations: {
+    title: "Make more like winner",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await withAssist(client, args.auto_unlock ?? false, () => client.post(`/campaign-pack-items/${args.item_id}/make-more`));
+  const data = asRecord(asRecord(res).data);
+  return ok({
+    item_id: args.item_id,
+    variations: Array.isArray(data.variations) ? data.variations : [],
+    ai_assist_quota: data.ai_assist_quota ?? null,
+    next: "Feed a chosen variation into add_pack_variations({ pack_id, variations, materialize: true }) to draft it."
+  });
+}));
+registerTool("create_review_link", {
+  title: "Create a no-login review link for one completed output",
+  description: "Mints an expiring, hashed-token review link for EXACTLY ONE of your own COMPLETED outputs — a video " + "result (video_result_id) OR a carousel/slider (slider_id), never both — optionally grouped under one of " + "your campaign packs. The reviewer opens the returned URL with NO account. Spends 0 credits. Scope: " + "video:generate. IMPORTANT: the plaintext token + review URL are returned ONCE and CANNOT be retrieved " + "again (only the hash is stored) — surface them to the user immediately. expires_in_hours defaults to 168 " + `(7 days) and is clamped to ${REVIEW_LINK_MIN_EXPIRES_IN_HOURS}..${REVIEW_LINK_MAX_EXPIRES_IN_HOURS}. ` + "422 for a not-completed/foreign output or a foreign campaign pack.",
+  inputSchema: {
+    video_result_id: exports_external.number().int().optional().describe("Id of one of your own COMPLETED video results (mutually exclusive with slider_id)"),
+    slider_id: exports_external.number().int().optional().describe("Id of one of your own COMPLETED sliders/carousels (mutually exclusive with video_result_id)"),
+    campaign_pack_id: exports_external.number().int().optional().describe("Optional id of one of your own campaign packs to group under"),
+    expires_in_hours: exports_external.number().int().optional().describe(`How long the link stays valid; clamped ${REVIEW_LINK_MIN_EXPIRES_IN_HOURS}..${REVIEW_LINK_MAX_EXPIRES_IN_HOURS} (default 168 = 7 days)`),
+    download_enabled: exports_external.boolean().optional().describe("Whether the reviewer may download the output (default false)"),
+    version_label: exports_external.string().optional().describe("Optional human label for this review version (≤120 chars)")
+  },
+  annotations: {
+    title: "Create review link",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const err = validateReviewOutput(args.video_result_id, args.slider_id);
+  if (err)
+    return fail(err);
+  const res = await client.post("/review-links", buildReviewLinkBody(args));
+  const result = shapeCreateReviewLink(asRecord(res).data, reviewWebOrigin());
+  return ok(result);
+}));
+registerTool("list_review_links", {
+  title: "List your review links",
+  description: "Lists your review links, newest first, each summarized with its status (pending → viewed → approved / " + "changes_requested / revoked), the output it points at, expiry, and its visible comment_count — so you can " + "see review + approval activity at a glance. NEVER returns the token (only shown once at creation). " + "Read-only, 0 credits. Scope: video:read.",
+  inputSchema: {},
+  annotations: { title: "List review links", ...RO }
+}, tool(async (_args, client) => {
+  const res = await client.get("/review-links");
+  const data = asRecord(res).data;
+  const links = Array.isArray(data) ? data.map(summarizeReviewLink) : [];
+  return ok({ review_links: links });
+}));
+registerTool("revoke_review_link", {
+  title: "Revoke a review link",
+  description: "Revokes one of your own review links (status → 'revoked'); the no-login URL immediately stops working. " + "Returns the revoked link. Spends 0 credits. Scope: video:generate. 404 for an unknown/foreign id.",
+  inputSchema: {
+    id: exports_external.number().int().describe("Review link id (from list_review_links)")
+  },
+  annotations: {
+    title: "Revoke review link",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await client.del(`/review-links/${args.id}`);
+  return ok(summarizeReviewLink(asRecord(res).data));
+}));
+function assetCatalog(fn) {
+  return tool(async (args, client, extra) => {
+    try {
+      return await fn(args, client, extra);
+    } catch (e) {
+      const he = e;
+      if (he && he.status === 402) {
+        return fail(assetSubscriptionErrorText(he.status, he.code, errMessage(e)));
+      }
+      throw e;
+    }
+  });
+}
+registerTool("list_assets", {
+  title: "List your reusable asset catalog",
+  description: "Lists your reusable asset catalog (images + videos), newest first, each with its media type, mime, size, " + "description, status, and a presigned asset_url — plus your storage quota. Optionally page with limit/offset " + "(offset = page * limit). Read-only, 0 credits. Scope: video:read. Requires an ACTIVE SUBSCRIPTION (402 " + "subscription_required otherwise).",
+  inputSchema: {
+    limit: exports_external.number().int().optional().describe("Max assets to return (a positive integer)"),
+    offset: exports_external.number().int().optional().describe("How many to skip (offset = page * limit)")
+  },
+  annotations: { title: "List assets", ...RO }
+}, assetCatalog(async (args, client) => {
+  const query = {};
+  if (args.limit !== undefined)
+    query.limit = args.limit;
+  if (args.offset !== undefined)
+    query.offset = args.offset;
+  const res = await client.get("/assets", Object.keys(query).length > 0 ? query : undefined);
+  const data = asRecord(res).data;
+  const assets = Array.isArray(data) ? data.map(summarizeCatalogAsset) : [];
+  const quota = asRecord(asRecord(res).meta).quota;
+  return ok({
+    assets,
+    quota: quota ? summarizeAssetQuota(quota) : null
+  });
+}));
+registerTool("get_asset_quota", {
+  title: "Get your asset-catalog storage quota",
+  description: "Returns your asset-catalog storage quota (limit / used / pending / reserved / remaining bytes). Read-only, " + "0 credits. Scope: video:read. Requires an ACTIVE SUBSCRIPTION (402 subscription_required otherwise).",
+  inputSchema: {},
+  annotations: { title: "Get asset quota", ...RO }
+}, assetCatalog(async (_args, client) => {
+  const res = await client.get("/assets/quota");
+  return ok(summarizeAssetQuota(asRecord(res).data));
+}));
+registerTool("upload_asset", {
+  title: "Upload a local file to your reusable asset catalog",
+  description: "Uploads a local IMAGE or VIDEO into your reusable asset catalog so it can be reused across projects. " + `Allowed types: ${CATALOG_ASSET_EXTS.map((e) => `.${e}`).join(", ")} — images ≤20 MiB, videos ≤500 MB. ` + "Runs presign → PUT → confirm; the confirm HEADs the object and validates size/type, so a mismatch 422s. " + "For a VIDEO you MUST pass duration_seconds (≤60; the server rejects a video with no/over-long duration). " + "Spends 0 credits. Scope: video:generate. Rate limit: 30/min. Requires an ACTIVE SUBSCRIPTION (402 " + "subscription_required otherwise). The local path is confined to HUBFLUENCER_INPUT_DIR (default: cwd). " + "Returns the confirmed asset id + media type + status.",
+  inputSchema: {
+    file_path: exports_external.string().describe("Path to a local image/video, inside HUBFLUENCER_INPUT_DIR (default: cwd)"),
+    description: exports_external.string().optional().describe("Optional description stored with the asset"),
+    duration_seconds: exports_external.number().optional().describe("Video duration in seconds (REQUIRED for a video, ≤60)"),
+    width: exports_external.number().int().optional().describe("Optional pixel width"),
+    height: exports_external.number().int().optional().describe("Optional pixel height")
+  },
+  annotations: {
+    title: "Upload asset",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, assetCatalog(async (args, client) => {
+  const asset = await uploadCatalogAsset(client, args.file_path, {
+    description: args.description,
+    durationSeconds: args.duration_seconds,
+    width: args.width,
+    height: args.height
+  });
+  return ok({
+    ...asset,
+    next: "list_assets to see it; reuse it across projects from the app's asset picker."
+  });
+}));
 async function main() {
   if (process.argv[2] === "login") {
     await runLogin(process.argv[3]);