@pixeldojo/mcp 0.20.0 → 0.22.0

package/dist/cli.cjs

@@ -1250,6 +1250,169 @@ var init_upscale = __esm({
   }
 });
 async function run6(input, ctx) {
+  const submitted = await ctx.client.run(MODEL, {
+    prompt: "",
+    video: input.video_url,
+    ...input.style ? { caption_style: input.style } : {},
+    ...input.highlight_color ? { highlight_color: input.highlight_color } : {}
+  });
+  const result = await pollJobUntilDoneOrHandoff(
+    submitted.jobId,
+    (id) => ctx.client.getJob(id),
+    ctx.buildStatusUrl,
+    { now: ctx.pollOverrides?.now, sleep: ctx.pollOverrides?.sleep }
+  );
+  return pollResultToSkillResult(
+    result,
+    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Captioned. Asset: ${urls[0]}`
+  );
+}
+var MODEL, STYLES, InputSchema6, InputJsonSchema6, captionSkill;
+var init_caption = __esm({
+  "src/skills/caption.ts"() {
+    init_poll();
+    init_types();
+    MODEL = "video-autocaption";
+    STYLES = ["pop", "highlighter", "clean"];
+    InputSchema6 = zod.z.object({
+      video_url: zod.z.string().url().describe("URL of the video to caption. It must have speech."),
+      style: zod.z.enum(STYLES).optional(),
+      highlight_color: zod.z.string().optional()
+    });
+    InputJsonSchema6 = {
+      type: "object",
+      required: ["video_url"],
+      properties: {
+        video_url: {
+          type: "string",
+          format: "uri",
+          description: "The video to caption (MP4 or MOV). It must have speech; a silent clip is refused uncharged."
+        },
+        style: {
+          type: "string",
+          enum: STYLES,
+          description: "pop (default): bold caps, the spoken word lit and growing. highlighter: the spoken word on a block of the color. clean: sentence case on a dark box."
+        },
+        highlight_color: {
+          type: "string",
+          description: "The highlight as #RRGGBB (a brand color) or a name like yellow, green, pink. Defaults to yellow."
+        }
+      }
+    };
+    captionSkill = {
+      name: "pixeldojo_caption",
+      description: "Burn animated word-by-word captions onto a video with speech, the short-form look for TikTok, Reels and Shorts: the spoken word lights up, placed above the platform buttons. Pass video_url; optional style (pop, highlighter, clean) and highlight_color (#RRGGBB for a brand color). 5 credits.",
+      inputZod: InputSchema6,
+      inputJsonSchema: InputJsonSchema6,
+      allowedModels: [MODEL],
+      defaultModel: MODEL,
+      run: run6
+    };
+  }
+});
+async function run7(input, ctx) {
+  if (!input.offer && !input.end_card) {
+    return { kind: "text", text: "pixeldojo_overlay needs an offer, an end_card, or both." };
+  }
+  const { offer, end_card: card } = input;
+  const submitted = await ctx.client.run(MODEL2, {
+    prompt: "",
+    video: input.video_url,
+    ...input.color ? { color: input.color } : {},
+    ...offer ? {
+      offer_text: offer.text,
+      offer_subtext: offer.subtext,
+      offer_start: offer.start_sec,
+      offer_duration: offer.duration_sec,
+      offer_position: offer.position
+    } : {},
+    ...card ? {
+      end_headline: card.headline,
+      end_cta: card.cta,
+      end_url: card.url,
+      logo_url: card.logo_url,
+      end_duration: card.duration_sec
+    } : {}
+  });
+  const result = await pollJobUntilDoneOrHandoff(
+    submitted.jobId,
+    (id) => ctx.client.getJob(id),
+    ctx.buildStatusUrl,
+    { now: ctx.pollOverrides?.now, sleep: ctx.pollOverrides?.sleep }
+  );
+  return pollResultToSkillResult(
+    result,
+    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Branded. Asset: ${urls[0]}`
+  );
+}
+var MODEL2, InputSchema7, InputJsonSchema7, overlaySkill;
+var init_overlay = __esm({
+  "src/skills/overlay.ts"() {
+    init_poll();
+    init_types();
+    MODEL2 = "brand-overlay";
+    InputSchema7 = zod.z.object({
+      video_url: zod.z.string().url(),
+      color: zod.z.string().optional(),
+      offer: zod.z.object({
+        text: zod.z.string().max(24),
+        subtext: zod.z.string().max(40).optional(),
+        start_sec: zod.z.number().min(0).optional(),
+        duration_sec: zod.z.number().min(1).max(10).optional(),
+        position: zod.z.enum(["top", "bottom"]).optional()
+      }).optional(),
+      end_card: zod.z.object({
+        headline: zod.z.string().max(40),
+        cta: zod.z.string().max(24).optional(),
+        url: zod.z.string().max(40).optional(),
+        logo_url: zod.z.string().url().optional(),
+        duration_sec: zod.z.number().min(2).max(5).optional()
+      }).optional()
+    });
+    InputJsonSchema7 = {
+      type: "object",
+      required: ["video_url"],
+      properties: {
+        video_url: { type: "string", format: "uri", description: "The video to brand (MP4 or MOV)." },
+        color: { type: "string", description: "Brand color as #RRGGBB: the badge and the button. Defaults to #FFE500." },
+        offer: {
+          type: "object",
+          description: "Offer callout: a badge that pops in on cue.",
+          required: ["text"],
+          properties: {
+            text: { type: "string", maxLength: 24, description: 'e.g. "50% OFF".' },
+            subtext: { type: "string", maxLength: 40, description: 'Small line under it, e.g. "This week only".' },
+            start_sec: { type: "number", description: "Second it appears. Default 0.5." },
+            duration_sec: { type: "number", minimum: 1, maximum: 10, description: "Seconds it stays. Default 3." },
+            position: { type: "string", enum: ["top", "bottom"], description: "Default top." }
+          }
+        },
+        end_card: {
+          type: "object",
+          description: "End card held after the last frame.",
+          required: ["headline"],
+          properties: {
+            headline: { type: "string", maxLength: 40, description: 'e.g. "Your new favorite mug".' },
+            cta: { type: "string", maxLength: 24, description: 'Button text, e.g. "Shop now".' },
+            url: { type: "string", maxLength: 40, description: "Web address shown under the button." },
+            logo_url: { type: "string", format: "uri", description: "PNG (transparent works best) or JPG." },
+            duration_sec: { type: "number", minimum: 2, maximum: 5, description: "Default 3." }
+          }
+        }
+      }
+    };
+    overlaySkill = {
+      name: "pixeldojo_overlay",
+      description: 'Add an offer callout (a badge like "50% OFF" that pops in on cue) and/or a branded end card (the last frame held under a logo, headline, button and web address) to a video. The text renders exactly as written, in the brand color. Pass video_url plus offer and/or end_card. 2 credits.',
+      inputZod: InputSchema7,
+      inputJsonSchema: InputJsonSchema7,
+      allowedModels: [MODEL2],
+      defaultModel: MODEL2,
+      run: run7
+    };
+  }
+});
+async function run8(input, ctx) {
   const job = await ctx.client.getJob(input.jobId);
   if (job.status === "completed") {
     const urls = extractAssetUrls2(job);
@@ -1313,13 +1476,13 @@ function extractAssetUrls2(job) {
   if (output?.video) return [output.video];
   return [];
 }
-var InputSchema6, InputJsonSchema6, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
+var InputSchema8, InputJsonSchema8, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
 var init_status = __esm({
   "src/skills/status.ts"() {
-    InputSchema6 = zod.z.object({
+    InputSchema8 = zod.z.object({
       jobId: zod.z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo_* skill handoff.")
     });
-    InputJsonSchema6 = {
+    InputJsonSchema8 = {
       type: "object",
       properties: {
         jobId: {
@@ -1334,16 +1497,16 @@ var init_status = __esm({
     statusSkill = {
       name: "pixeldojo_status",
       description: 'Check once, without waiting, on a jobId that a generation tool returned instead of an asset after its 30s wait. Free. Returns asset URLs when complete, the failure reason if it failed, or the current state and job age if still running. Campaign ids go to pixeldojo_campaign_status; films report progress through pixeldojo_film with action "status".',
-      inputZod: InputSchema6,
-      inputJsonSchema: InputJsonSchema6,
+      inputZod: InputSchema8,
+      inputJsonSchema: InputJsonSchema8,
       // status is special — it doesn't dispatch to a model
       allowedModels: [],
       defaultModel: "",
-      run: run6
+      run: run8
     };
   }
 });
-async function run7(input, ctx) {
+async function run9(input, ctx) {
   const product = await ctx.client.extractProduct(input.url);
   const summary = [
     `Product: ${product.name}`,
@@ -1360,13 +1523,13 @@ function truncate(input, max) {
   if (input.length <= max) return input;
   return input.slice(0, max - 3) + "...";
 }
-var InputSchema7, InputJsonSchema7, fromUrlSkill;
+var InputSchema9, InputJsonSchema9, fromUrlSkill;
 var init_from_url = __esm({
   "src/skills/from-url.ts"() {
-    InputSchema7 = zod.z.object({
+    InputSchema9 = zod.z.object({
       url: zod.z.string().min(1).max(2048).describe("Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata.")
     });
-    InputJsonSchema7 = {
+    InputJsonSchema9 = {
       type: "object",
       properties: {
         url: {
@@ -1379,12 +1542,12 @@ var init_from_url = __esm({
     fromUrlSkill = {
       name: "pixeldojo_from_url",
       description: "Extract a product profile from a product page URL: name, description, image URLs (the first three are listed), and the extraction method used. Works on Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata. Free. pixeldojo_campaign and pixeldojo_ad accept a product URL and run this extraction themselves; call this directly to check the product data first, or to reuse its images in other tools.",
-      inputZod: InputSchema7,
-      inputJsonSchema: InputJsonSchema7,
+      inputZod: InputSchema9,
+      inputJsonSchema: InputJsonSchema9,
       // No model dispatch — this skill calls a server-side scrape, not a generation.
       allowedModels: [],
       defaultModel: "",
-      run: run7
+      run: run9
     };
   }
 });
@@ -1947,7 +2110,7 @@ async function redoShots(input, ctx) {
     followUp: keepGoing(filmId, 30, { soundtrack: input.soundtrack })
   };
 }
-async function run8(input, ctx) {
+async function run10(input, ctx) {
   const action = input.action === "plan" && input.film_id ? input.cast?.length ? "cast" : "status" : input.action;
   if (action === "plan") return plan(input, ctx);
   if (!input.film_id) return { kind: "text", text: "produce/status/cast/redo need the film_id returned by the plan step." };
@@ -1967,7 +2130,7 @@ async function run8(input, ctx) {
   if (action === "redo") return redoShots(input, ctx);
   return advance(input.film_id, input.soundtrack, input.music_job_id, ctx);
 }
-var STORY_LOOKS, MUSIC_VIDEO_LOOKS, LOOKS, MUSIC_CLIP_ENGINE_ID, InputSchema8, InputJsonSchema8, shots, benignDispatchRefusal, count, frameDone, RETRY_CLEARS, REFUSED, isRefused, PLANNER_POLL_MS, PLANNER_MAX_POLLS, isMusicVideo, needsSlice, stillPlanningText, LOOK_MUSIC, ARC, filmSkill;
+var STORY_LOOKS, MUSIC_VIDEO_LOOKS, LOOKS, MUSIC_CLIP_ENGINE_ID, InputSchema10, InputJsonSchema10, shots, benignDispatchRefusal, count, frameDone, RETRY_CLEARS, REFUSED, isRefused, PLANNER_POLL_MS, PLANNER_MAX_POLLS, isMusicVideo, needsSlice, stillPlanningText, LOOK_MUSIC, ARC, filmSkill;
 var init_film = __esm({
   "src/skills/film.ts"() {
     init_upload_helpers();
@@ -1975,7 +2138,7 @@ var init_film = __esm({
     MUSIC_VIDEO_LOOKS = ["rap-video", "neon-club", "stage-performance", "retro-camcorder", "y2k-pop", "moody-rnb", "rock-grit", "dream-pop", "k-pop"];
     LOOKS = [...STORY_LOOKS, ...MUSIC_VIDEO_LOOKS];
     MUSIC_CLIP_ENGINE_ID = "minimax-h3-reference";
-    InputSchema8 = zod.z.object({
+    InputSchema10 = zod.z.object({
       idea: zod.z.string().max(2e3).optional().describe("One-to-three sentence film idea. The studio writes the screenplay (free). Provide idea OR script for planning."),
       script: zod.z.string().max(2e4).optional().describe("A full screenplay to plan instead of an idea (sluglines, action lines, dialogue)."),
       look: zod.z.enum(LOOKS).optional().describe("Visual style carried through frames, clips, and soundtrack. Default live-action, or rap-video for a music video."),
@@ -2003,7 +2166,7 @@ var init_film = __esm({
       soundtrack: zod.z.enum(["scene-synced", "flat", "none"]).default("scene-synced").describe("scene-synced composes one musical section per scene, pinned to the scene lengths (default). flat is a single cohesive bed. none skips music."),
       music_job_id: zod.z.string().max(80).optional().describe("The music_job_id from the previous status reply while the score is composing, so that score is attached. A status call without it, once all clips are ready and no score is attached, starts and charges for a new score.")
     });
-    InputJsonSchema8 = {
+    InputJsonSchema10 = {
       type: "object",
       properties: {
         idea: { type: "string", description: `Plan step: one-to-three sentence film idea. The studio writes the screenplay (free). Provide idea or script. Keep the user's own words for who each character is, including their gender and pronouns ("she", "he") and species; the writer has nothing else to go on.` },
@@ -2117,11 +2280,11 @@ var init_film = __esm({
       name: "pixeldojo_film",
       description: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_path (a local file) or song_url (your own PixelDojo upload from pixeldojo_upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s); redo renders a new take of chosen shots and status re-exports.",
       hostedDescription: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_url (your own PixelDojo upload made with POST /api/v1/upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s); redo renders a new take of chosen shots and status re-exports.",
-      inputZod: InputSchema8,
-      inputJsonSchema: InputJsonSchema8,
+      inputZod: InputSchema10,
+      inputJsonSchema: InputJsonSchema10,
       allowedModels: [],
       defaultModel: "",
-      run: run8
+      run: run10
     };
   }
 });
@@ -2208,7 +2371,7 @@ function buildVideoPayload(verb, apiId, i) {
       };
   }
 }
-async function run9(input, ctx) {
+async function run11(input, ctx) {
   const paramsGate = paramsWithoutModel(input.params, input.model);
   if (paramsGate) return { kind: "text", text: paramsGate };
   const verb = input.verb;
@@ -2271,7 +2434,7 @@ async function run9(input, ctx) {
     notes.join(" ")
   );
 }
-var VIDEO_STUDIO_ENGINES, VERBS, BACKWARD_ENGINES, clamp, NEEDS_VIDEO_DURATION, NO_IMAGE_ENGINES, InputSchema9, engineList, InputJsonSchema9, BASE_DESCRIPTION, videoSkill;
+var VIDEO_STUDIO_ENGINES, VERBS, BACKWARD_ENGINES, clamp, NEEDS_VIDEO_DURATION, NO_IMAGE_ENGINES, InputSchema11, engineList, InputJsonSchema11, BASE_DESCRIPTION, videoSkill;
 var init_video = __esm({
   "src/skills/video.ts"() {
     init_poll();
@@ -2305,7 +2468,7 @@ var init_video = __esm({
       "wan-video-character-swap"
     ]);
     NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["flux-video-edit", "xai-video-edit"]);
-    InputSchema9 = zod.z.object({
+    InputSchema11 = zod.z.object({
       verb: zod.z.enum(VERBS),
       prompt: zod.z.string().max(8e3).optional(),
       video_url: zod.z.string().url().optional(),
@@ -2320,7 +2483,7 @@ var init_video = __esm({
       params: ParamsInput
     });
     engineList = (verb) => `${verb}: ${VIDEO_STUDIO_ENGINES[verb].join(", ")} (default ${VIDEO_STUDIO_ENGINES[verb][0]})`;
-    InputJsonSchema9 = {
+    InputJsonSchema11 = {
       type: "object",
       properties: {
         verb: {
@@ -2381,11 +2544,11 @@ var init_video = __esm({
       name: "pixeldojo_video",
       description: `${BASE_DESCRIPTION} Local files: video_path / image_path (uploaded to 24h temp storage first).`,
       hostedDescription: `${BASE_DESCRIPTION} Media must be public http(s) URLs.`,
-      inputZod: InputSchema9,
-      inputJsonSchema: InputJsonSchema9,
+      inputZod: InputSchema11,
+      inputJsonSchema: InputJsonSchema11,
       allowedModels: Array.from(new Set(VERBS.flatMap((v) => VIDEO_STUDIO_ENGINES[v]))),
       defaultModel: VIDEO_STUDIO_ENGINES.change[0],
-      run: run9
+      run: run11
     };
   }
 });
@@ -2560,28 +2723,28 @@ async function produce2(id, ctx) {
   const musicNote = ep.musicEnabled && ep.music?.status === "failed" ? " The music bed failed, so this cut has no music." : "";
   return { kind: "text", text: `Export started, free${prior}.${musicNote} ${next(id, "produce", "~60s")}` };
 }
-async function run10(input, ctx) {
+async function run12(input, ctx) {
   const action = input.action === "create" && input.episode_id ? "status" : input.action;
   if (action === "create") return create(input, ctx);
   if (!input.episode_id) return { kind: "text", text: "produce and status need the episode_id returned by the create step." };
   if (action === "produce") return produce2(input.episode_id, ctx);
   return status(input.episode_id, ctx);
 }
-var STYLES, CATEGORIES, ENGINES, MIN_SECONDS, MAX_SECONDS, MAX_IN_FLIGHT, InputSchema10, InputJsonSchema10, call, next, needsRender, PLAN_POLL_MS, PLAN_MAX_POLLS, stillPlanning, episodeSkill;
+var STYLES2, CATEGORIES, ENGINES, MIN_SECONDS, MAX_SECONDS, MAX_IN_FLIGHT, InputSchema12, InputJsonSchema12, call, next, needsRender, PLAN_POLL_MS, PLAN_MAX_POLLS, stillPlanning, episodeSkill;
 var init_episode = __esm({
   "src/skills/episode.ts"() {
-    STYLES = ["editorial-motion", "paper-diorama", "hand-drawn", "storybook", "poster-vector", "soft-3d"];
+    STYLES2 = ["editorial-motion", "paper-diorama", "hand-drawn", "storybook", "poster-vector", "soft-3d"];
     CATEGORIES = ["education", "history", "kids", "storytelling", "custom"];
     ENGINES = ["omni-draft", "omni-final", "still-motion"];
     MIN_SECONDS = 60;
     MAX_SECONDS = 300;
     MAX_IN_FLIGHT = 4;
-    InputSchema10 = zod.z.object({
+    InputSchema12 = zod.z.object({
       action: zod.z.enum(["create", "produce", "status"]).default("create"),
       topic: zod.z.string().min(8).max(400).optional(),
       episode_id: zod.z.string().max(40).optional(),
       category: zod.z.enum(CATEGORIES).default("education"),
-      style: zod.z.enum(STYLES).default("editorial-motion"),
+      style: zod.z.enum(STYLES2).default("editorial-motion"),
       aspect: zod.z.enum(["16:9", "9:16"]).default("16:9"),
       length_seconds: zod.z.number().int().min(MIN_SECONDS).max(MAX_SECONDS).default(120),
       voice: zod.z.string().min(1).max(80).default("Wise_Woman"),
@@ -2589,7 +2752,7 @@ var init_episode = __esm({
       music: zod.z.boolean().default(true),
       title: zod.z.string().max(120).optional()
     });
-    InputJsonSchema10 = {
+    InputJsonSchema12 = {
       type: "object",
       properties: {
         action: {
@@ -2600,7 +2763,7 @@ var init_episode = __esm({
         topic: { type: "string", description: "Create step: what the episode is about, 8 to 400 characters." },
         episode_id: { type: "string", description: "The episode_id from the create step. Required for produce and status." },
         category: { type: "string", enum: [...CATEGORIES], description: "Create step: tone of the script. Default education." },
-        style: { type: "string", enum: [...STYLES], description: "Create step: visual style of every scene. Default editorial-motion." },
+        style: { type: "string", enum: [...STYLES2], description: "Create step: visual style of every scene. Default editorial-motion." },
         aspect: { type: "string", enum: ["16:9", "9:16"], description: "Create step: 16:9 landscape (default) or 9:16 vertical." },
         length_seconds: { type: "integer", minimum: MIN_SECONDS, maximum: MAX_SECONDS, description: "Create step: target length in seconds. Default 120." },
         voice: { type: "string", description: "Create step: narrator voice id from the text-to-speech tool (e.g. Wise_Woman, Deep_Voice_Man, Friendly_Person). Default Wise_Woman." },
@@ -2622,15 +2785,15 @@ var init_episode = __esm({
     episodeSkill = {
       name: "pixeldojo_episode",
       description: "Make a finished narrated faceless video (explainer, history, kids story) from one topic: script, scene visuals, AI narration, music bed, stitched export saved to the Library. Phased: create is free and returns a credit quote; produce is charged and advances one step per call (poll every ~30s until it returns the video URL); status is free.",
-      inputZod: InputSchema10,
-      inputJsonSchema: InputJsonSchema10,
+      inputZod: InputSchema12,
+      inputJsonSchema: InputJsonSchema12,
       allowedModels: [],
       defaultModel: "",
-      run: run10
+      run: run12
     };
   }
 });
-async function run11(input, ctx) {
+async function run13(input, ctx) {
   const productImages = [
     ...input.product_image_urls ?? [],
     ...await Promise.all((input.product_image_paths ?? []).map((p) => uploadLocalFile(p, ctx)))
@@ -2673,13 +2836,13 @@ async function run11(input, ctx) {
     (urls) => urls.length === 0 ? `Ad job ${submitted.jobId} completed but returned no assets.` : `Ad rendered (style: ${styleLabel}${submitted.ad?.product?.name ? `, product: ${submitted.ad.product.name}` : ""}). Video: ${urls[0]}`
   );
 }
-var InputSchema11, InputJsonSchema11, adSkill;
+var InputSchema13, InputJsonSchema13, adSkill;
 var init_ad = __esm({
   "src/skills/ad.ts"() {
     init_types();
     init_poll();
     init_upload_helpers();
-    InputSchema11 = zod.z.object({
+    InputSchema13 = zod.z.object({
       style: zod.z.string().max(80).optional().describe(
         "Ad style slug (default ugc-testimonial). Catalog: GET /api/v1/marketing/presets \u2014 e.g. ugc-testimonial, unboxing-reveal, unboxing-asmr, virtual-try-on, street-style, product-showcase, macro-details, crush-test, hyper-motion, before-after, day-in-the-life, the-gift, tv-spot."
       ),
@@ -2705,7 +2868,7 @@ var init_ad = __esm({
         path: ["product_url"]
       }
     );
-    InputJsonSchema11 = {
+    InputJsonSchema13 = {
       type: "object",
       properties: {
         style: {
@@ -2792,16 +2955,16 @@ var init_ad = __esm({
       name: "pixeldojo_ad",
       description: "Marketing Studio: turn a product into a rendered video ad with voiceover. Requires `product_url` (name, description and images are extracted), or `product_name` plus product_image_urls / product_image_paths. Pick a `style` slug (default ugc-testimonial; full catalog at GET https://pixeldojo.ai/api/v1/marketing/presets), and optionally add presenter reference images, a location, a hook, and the exact spoken script. Returns the video URL, or a jobId to check with pixeldojo_status.",
       hostedDescription: "Marketing Studio: turn a product into a rendered video ad with voiceover. Requires `product_url` (name, description and images are extracted), or `product_name` plus product_image_urls (public http(s) URLs). Pick a `style` slug (default ugc-testimonial; full catalog at GET https://pixeldojo.ai/api/v1/marketing/presets), and optionally add presenter reference images, a location, a hook, and the exact spoken script. Returns the video URL, or a jobId to check with pixeldojo_status.",
-      inputZod: InputSchema11,
-      inputJsonSchema: InputJsonSchema11,
+      inputZod: InputSchema13,
+      inputJsonSchema: InputJsonSchema13,
       // Composition skill — the server routes to the ad engine internally.
       allowedModels: [],
       defaultModel: "",
-      run: run11
+      run: run13
     };
   }
 });
-async function run12(input, ctx) {
+async function run14(input, ctx) {
   const client = ctx.client;
   const result = await client.runCampaign(input);
   if (result.kind === "campaign") {
@@ -2828,10 +2991,10 @@ async function run12(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema12, InputJsonSchema12, campaignSkill;
+var InputSchema14, InputJsonSchema14, campaignSkill;
 var init_campaign = __esm({
   "src/skills/campaign.ts"() {
-    InputSchema12 = zod.z.object({
+    InputSchema14 = zod.z.object({
       productUrl: zod.z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
       product: zod.z.object({
         name: zod.z.string().min(1).max(200),
@@ -2847,7 +3010,7 @@ var init_campaign = __esm({
       message: "productUrl or product is required",
       path: ["productUrl"]
     });
-    InputJsonSchema12 = {
+    InputJsonSchema14 = {
       type: "object",
       properties: {
         productUrl: {
@@ -2898,17 +3061,17 @@ var init_campaign = __esm({
     campaignSkill = {
       name: "pixeldojo_campaign",
       description: "Generate a coherent product launch package (hero image + N lifestyle variants + optional vertical video) from one URL or product profile. Composes hero / lifestyle / video models server-side; returns assets in one call or a handoff with campaignId to poll via pixeldojo_campaign_status.",
-      inputZod: InputSchema12,
-      inputJsonSchema: InputJsonSchema12,
+      inputZod: InputSchema14,
+      inputJsonSchema: InputJsonSchema14,
       // Composition skill — internal sub-jobs route to per-tool models, no
       // single allowed-models list applies here.
       allowedModels: [],
       defaultModel: "",
-      run: run12
+      run: run14
     };
   }
 });
-async function run13(input, ctx) {
+async function run15(input, ctx) {
   const client = ctx.client;
   const result = await client.getCampaign(input.campaignId);
   if (result.kind === "campaign") {
@@ -2938,13 +3101,13 @@ async function run13(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema13, InputJsonSchema13, campaignStatusSkill;
+var InputSchema15, InputJsonSchema15, campaignStatusSkill;
 var init_campaign_status = __esm({
   "src/skills/campaign-status.ts"() {
-    InputSchema13 = zod.z.object({
+    InputSchema15 = zod.z.object({
       campaignId: zod.z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo_campaign handoff.")
     });
-    InputJsonSchema13 = {
+    InputJsonSchema15 = {
       type: "object",
       properties: {
         campaignId: {
@@ -2957,15 +3120,15 @@ var init_campaign_status = __esm({
     campaignStatusSkill = {
       name: "pixeldojo_campaign_status",
       description: "Poll a campaign by campaignId returned from pixeldojo_campaign. Returns assets when every sub-job is done, or a handoff describing what is still in flight.",
-      inputZod: InputSchema13,
-      inputJsonSchema: InputJsonSchema13,
+      inputZod: InputSchema15,
+      inputJsonSchema: InputJsonSchema15,
       allowedModels: [],
       defaultModel: "",
-      run: run13
+      run: run15
     };
   }
 });
-async function run14(input, ctx) {
+async function run16(input, ctx) {
   let url;
   try {
     url = await uploadLocalFile(input.path, ctx);
@@ -2981,16 +3144,16 @@ async function run14(input, ctx) {
 (temp storage; auto-deletes in ~24h. Pass this URL as image_url, video_url for a clip, or song_url on pixeldojo_film for a song, to any pixeldojo tool that takes one.)`
   };
 }
-var InputSchema14, InputJsonSchema14, uploadSkill;
+var InputSchema16, InputJsonSchema16, uploadSkill;
 var init_upload = __esm({
   "src/skills/upload.ts"() {
     init_upload_helpers();
-    InputSchema14 = zod.z.object({
+    InputSchema16 = zod.z.object({
       path: zod.z.string().min(1).max(4096).describe(
         "Absolute local file path to upload. JPEG, PNG, WebP, GIF (\u226450MB), MP4, WebM, MOV (\u2264200MB) or MP3, WAV, M4A, AAC, OGG, FLAC audio (\u226450MB). Returns a public URL on the temp CDN; storage auto-expires after 24 hours."
       )
     });
-    InputJsonSchema14 = {
+    InputJsonSchema16 = {
       type: "object",
       properties: {
         path: {
@@ -3003,15 +3166,15 @@ var init_upload = __esm({
     uploadSkill = {
       name: "pixeldojo_upload",
       description: "Upload a local image, video or audio file (JPEG, PNG, WebP, GIF up to 50MB; MP4, WebM, MOV up to 200MB; MP3, WAV, M4A, AAC, OGG, FLAC up to 50MB) and get back a public URL that expires after 24 hours. Free. Pass an audio URL as song_url to pixeldojo_film for a music video. Pass the URL as image_url (stills) or video_url (clips) to tools that take hosted URLs only, such as pixeldojo_character, pixeldojo_storyboard and pixeldojo_upscale. pixeldojo_generate, pixeldojo_edit and pixeldojo_ad take local paths directly and need no separate upload.",
-      inputZod: InputSchema14,
-      inputJsonSchema: InputJsonSchema14,
+      inputZod: InputSchema16,
+      inputJsonSchema: InputJsonSchema16,
       allowedModels: [],
       defaultModel: "",
-      run: run14
+      run: run16
     };
   }
 });
-async function run15(input, ctx) {
+async function run17(input, ctx) {
   const requested = input.model ?? DEFAULT_MODEL6;
   if (!ALLOWED4.includes(requested)) {
     return {
@@ -3049,14 +3212,14 @@ async function run15(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Audio ready. Asset: ${urls[0]}`
   );
 }
-var ALLOWED4, DEFAULT_MODEL6, InputSchema15, InputJsonSchema15, audioSkill;
+var ALLOWED4, DEFAULT_MODEL6, InputSchema17, InputJsonSchema17, audioSkill;
 var init_audio = __esm({
   "src/skills/audio.ts"() {
     init_poll();
     init_types();
     ALLOWED4 = ["seed-audio", "text-to-speech"];
     DEFAULT_MODEL6 = "seed-audio";
-    InputSchema15 = zod.z.object({
+    InputSchema17 = zod.z.object({
       prompt: zod.z.string().min(1).describe(
         "seed-audio: a script to speak, or a scene description (dialogue, sound effects, music), up to 2048 characters; refer to audio_urls clips in order as @Audio1..@Audio3. text-to-speech: the exact text to speak, up to 10,000 characters."
       ),
@@ -3066,7 +3229,7 @@ var init_audio = __esm({
       output_format: zod.z.string().optional().describe("Output format. seed-audio: mp3 (default), wav, pcm, ogg_opus. text-to-speech: mp3 (default), wav, flac, pcm."),
       speed: zod.z.number().min(0.5).max(2).optional().describe("Speech speed multiplier, 0.5-2 (default 1). Both models.")
     });
-    InputJsonSchema15 = {
+    InputJsonSchema17 = {
       type: "object",
       properties: {
         prompt: {
@@ -3104,15 +3267,15 @@ var init_audio = __esm({
     audioSkill = {
       name: "pixeldojo_audio",
       description: "Generate audio: speech, multi-character dialogue, sound effects, and background music from one prompt (Seed Audio 1.0 by default; plain text-to-speech available). Voice cloning takes hosted reference clip URLs in audio_urls; local audio files are not accepted. Returns an audio URL, or a jobId for pixeldojo_status.",
-      inputZod: InputSchema15,
-      inputJsonSchema: InputJsonSchema15,
+      inputZod: InputSchema17,
+      inputJsonSchema: InputJsonSchema17,
       allowedModels: [...ALLOWED4],
       defaultModel: DEFAULT_MODEL6,
-      run: run15
+      run: run17
     };
   }
 });
-async function run16(input, ctx) {
+async function run18(input, ctx) {
   if (input.source === "characters") {
     const { characters } = await ctx.client.listCharacters({ q: input.q, limit: input.limit ?? 25 });
     if (characters.length === 0) {
@@ -3163,17 +3326,17 @@ ${lines.join("\n")}
 Pass any URL back into pixeldojo_generate, pixeldojo_edit, pixeldojo_character, or pixeldojo_upscale as a reference input.`
   };
 }
-var InputSchema16, InputJsonSchema16, librarySkill;
+var InputSchema18, InputJsonSchema18, librarySkill;
 var init_library = __esm({
   "src/skills/library.ts"() {
-    InputSchema16 = zod.z.object({
+    InputSchema18 = zod.z.object({
       source: zod.z.enum(["media", "characters"]).optional().describe("media (default): saved and recent results. characters: saved Character Studio characters and elements, usable as @Name in prompts."),
       q: zod.z.string().optional().describe("Substring match against the prompt that produced the asset."),
       model: zod.z.string().optional().describe("Restrict to a single model (apiId)."),
       modality: zod.z.enum(["image", "video", "audio"]).optional().describe("Restrict to one output type."),
       limit: zod.z.number().int().min(1).max(50).optional().describe("Max results (default 10).")
     });
-    InputJsonSchema16 = {
+    InputJsonSchema18 = {
       type: "object",
       properties: {
         source: {
@@ -3198,15 +3361,15 @@ var init_library = __esm({
     librarySkill = {
       name: "pixeldojo_library",
       description: "Search your Library, newest first. source=media (default): saved media (permanent) and recent API/MCP generations (deleted 1 hour after they finish), as URLs to reuse as references. source=characters: saved Character Studio characters and elements, each usable as @Name in any prompt.",
-      inputZod: InputSchema16,
-      inputJsonSchema: InputJsonSchema16,
+      inputZod: InputSchema18,
+      inputJsonSchema: InputJsonSchema18,
       allowedModels: [],
       defaultModel: "",
-      run: run16
+      run: run18
     };
   }
 });
-async function run17(input, ctx) {
+async function run19(input, ctx) {
   const res = await ctx.client.saveMedia({
     url: input.url,
     prompt: input.prompt,
@@ -3220,17 +3383,17 @@ async function run17(input, ctx) {
 It will appear at https://pixeldojo.ai/my-images and in pixeldojo_library searches.`
   };
 }
-var InputSchema17, InputJsonSchema17, saveSkill;
+var InputSchema19, InputJsonSchema19, saveSkill;
 var init_save = __esm({
   "src/skills/save.ts"() {
-    InputSchema17 = zod.z.object({
+    InputSchema19 = zod.z.object({
       url: zod.z.string().url().describe("The asset URL to save (image or video)."),
       prompt: zod.z.string().optional().describe("The prompt that produced it \u2014 makes it findable in the library later."),
       tool_name: zod.z.string().optional().describe("Tool/model slug that produced it."),
       modality: zod.z.enum(["image", "video", "audio"]).optional(),
       job_id: zod.z.string().optional().describe("The jobId that produced this asset, when known.")
     });
-    InputJsonSchema17 = {
+    InputJsonSchema19 = {
       type: "object",
       properties: {
         url: { type: "string", format: "uri", description: "The result URL to keep (image or video from a PixelDojo job)." },
@@ -3244,15 +3407,15 @@ var init_save = __esm({
     saveSkill = {
       name: "pixeldojo_save",
       description: `Save a generated image or video into the user's My Media library permanently ("save this", "keep it"). Results otherwise expire 1 hour after they finish. Pass the result URL; it is safety-checked before it is kept.`,
-      inputZod: InputSchema17,
-      inputJsonSchema: InputJsonSchema17,
+      inputZod: InputSchema19,
+      inputJsonSchema: InputJsonSchema19,
       allowedModels: [],
       defaultModel: "",
-      run: run17
+      run: run19
     };
   }
 });
-async function run18(input, ctx) {
+async function run20(input, ctx) {
   const res = await ctx.client.saveCharacter({
     name: input.name,
     kind: input.kind ?? "character",
@@ -3264,17 +3427,17 @@ async function run18(input, ctx) {
     text: `Saved ${res.kind} "${res.name}" to Character Studio (${res.image_urls.length} image${res.image_urls.length === 1 ? "" : "s"}). Use it in any prompt as ${res.mention}, for example "${res.mention} walking on a beach at sunset". It also appears at https://pixeldojo.ai/characters.`
   };
 }
-var KINDS, InputSchema18, InputJsonSchema18, saveCharacterSkill;
+var KINDS, InputSchema20, InputJsonSchema20, saveCharacterSkill;
 var init_save_character = __esm({
   "src/skills/save-character.ts"() {
     KINDS = ["character", "product", "outfit", "location", "object", "style"];
-    InputSchema18 = zod.z.object({
+    InputSchema20 = zod.z.object({
       name: zod.z.string().min(1).max(60).describe("What to call it. Used as @Name in prompts."),
       kind: zod.z.enum(KINDS).optional().describe("Default character."),
       image_urls: zod.z.array(zod.z.string().url()).max(8).optional().describe("3 to 5 photos from different angles works best for a character."),
       description: zod.z.string().max(1500).optional().describe("Appearance notes, or the scene text for an element.")
     });
-    InputJsonSchema18 = {
+    InputJsonSchema20 = {
       type: "object",
       properties: {
         name: { type: "string", description: "What to call it. Used as @Name in prompts afterwards." },
@@ -3292,11 +3455,11 @@ var init_save_character = __esm({
     saveCharacterSkill = {
       name: "pixeldojo_save_character",
       description: "Save a character (a person, from 3-5 photos) or an element (product, outfit, location, prop, style) to the user's Character Studio library. Afterwards write @Name in any prompt to use it. List saved ones with pixeldojo_library source=characters.",
-      inputZod: InputSchema18,
-      inputJsonSchema: InputJsonSchema18,
+      inputZod: InputSchema20,
+      inputJsonSchema: InputJsonSchema20,
       allowedModels: [],
       defaultModel: "",
-      run: run18
+      run: run20
     };
   }
 });
@@ -3545,6 +3708,7 @@ __export(skills_exports, {
   audioSkill: () => audioSkill,
   campaignSkill: () => campaignSkill,
   campaignStatusSkill: () => campaignStatusSkill,
+  captionSkill: () => captionSkill,
   characterSkill: () => characterSkill,
   editSkill: () => editSkill,
   episodeSkill: () => episodeSkill,
@@ -3555,6 +3719,7 @@ __export(skills_exports, {
   generateSkill: () => generateSkill,
   librarySkill: () => librarySkill,
   listWorkflowsSkill: () => listWorkflowsSkill,
+  overlaySkill: () => overlaySkill,
   runWorkflowSkill: () => runWorkflowSkill,
   saveCharacterSkill: () => saveCharacterSkill,
   saveSkill: () => saveSkill,
@@ -3592,6 +3757,8 @@ var init_skills = __esm({
     init_character();
     init_storyboard();
     init_upscale();
+    init_caption();
+    init_overlay();
     init_status();
     init_from_url();
     init_film();
@@ -3612,6 +3779,8 @@ var init_skills = __esm({
       characterSkill,
       storyboardSkill,
       upscaleSkill,
+      captionSkill,
+      overlaySkill,
       audioSkill,
       librarySkill,
       saveSkill,
@@ -3651,6 +3820,8 @@ var init_skills = __esm({
       pixeldojo_character: render("Consistent character image"),
       pixeldojo_storyboard: render("Storyboard preview video"),
       pixeldojo_upscale: render("Upscale image or video"),
+      pixeldojo_caption: render("Caption video"),
+      pixeldojo_overlay: render("Add offer or end card"),
       pixeldojo_audio: render("Generate music, speech or sound"),
       pixeldojo_video: render("Change, animate or extend video"),
       pixeldojo_ad: render("Make video ad"),
@@ -3721,7 +3892,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.20.0" ;
+var PACKAGE_VERSION = "0.22.0" ;
 var SERVER_INSTRUCTIONS = "Pixel Dojo generates images, video, audio and short films from one catalog of AI models, billed in credits from the connected Pixel Dojo account. A job that runs past the 30-second wait returns a jobId to check later; check it rather than submitting again, since every new submission is charged. Generated asset URLs are deleted one hour after they are created: pixeldojo_save keeps one in the user's My Media permanently (after a safety check), and finished films stay in the account library. In any prompt, @Name uses a character, product, outfit, location, prop or style the user saved in Character Studio: its photos are attached automatically. pixeldojo_library source=characters lists them, and pixeldojo_save_character saves a new one from 3 to 5 photos.";
 function buildServer(options) {
   if (!options.apiKey) {
@@ -3893,6 +4064,8 @@ function printInit() {
       `#    pixeldojo_character      Consistent characters across shots.`,
       `#    pixeldojo_storyboard     Multi-shot scenes from one brief.`,
       `#    pixeldojo_upscale        Enhance any image or video.`,
+      `#    pixeldojo_caption        Animated word-by-word captions on a video.`,
+      `#    pixeldojo_overlay        Offer callout and branded end card on a video.`,
       `#    pixeldojo_audio          Voices + effects + music in one clip.`,
       `#    pixeldojo_library        Search your saved media + generations.`,
       `#    pixeldojo_*_workflow     Save / run / list multi-step chains.`,