@pixeldojo/mcp 0.22.0 → 0.23.0

package/README.md

@@ -55,7 +55,7 @@ Restart your agent. You'll see 23 new tools.
 | `pixeldojo_episode` | Faceless Studio: a narrated faceless video episode from a topic (script, scenes, voice, music, export). |
 | `pixeldojo_ad` | Marketing Studio: a product video ad from a URL or product images. |
 | `pixeldojo_upscale` | Enhance any image (up to 16×) or video (up to 4K). |
-| `pixeldojo_overlay` | Offer callout ("50% OFF" badge that pops in on cue) and a branded end card with logo, headline, button and web address. Exact text, your brand color. |
+| `pixeldojo_overlay` | Ad text layouts on a video: hook title, lower-third callout, review card, progress bar, offer badge and a branded end card with logo. Exact text, your brand color, clear of the platform UI. |
 | `pixeldojo_caption` | Animated word-by-word captions on a video with speech, placed clear of the TikTok/Reels/Shorts buttons. Pop, Highlighter or Clean, any highlight color. |
 | `pixeldojo_audio` | Full audio scenes: dialogue + effects + music in one clip (Seed Audio 1.0). Reference clips are hosted URLs; local audio files are not accepted. |
 | `pixeldojo_library` | Search your media library: saved Library items + recent generations. |

package/dist/cli.cjs

@@ -1311,14 +1311,29 @@ var init_caption = __esm({
   }
 });
 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 { hook, callout, review, offer, end_card: card } = input;
+  if (!hook && !callout && !review && !input.progress_bar && !offer && !card) {
+    return { kind: "text", text: "pixeldojo_overlay needs at least one of hook, callout, review, progress_bar, offer or end_card." };
   }
-  const { offer, end_card: card } = input;
   const submitted = await ctx.client.run(MODEL2, {
     prompt: "",
     video: input.video_url,
     ...input.color ? { color: input.color } : {},
+    ...hook ? { hook_text: hook.text, hook_duration: hook.duration_sec } : {},
+    ...callout ? {
+      callout_title: callout.title,
+      callout_subtitle: callout.subtitle,
+      callout_start: callout.start_sec,
+      callout_duration: callout.duration_sec
+    } : {},
+    ...review ? {
+      review_quote: review.quote,
+      review_name: review.name,
+      review_stars: review.stars,
+      review_start: review.start_sec,
+      review_duration: review.duration_sec
+    } : {},
+    ...input.progress_bar ? { progress_bar: true } : {},
     ...offer ? {
       offer_text: offer.text,
       offer_subtext: offer.subtext,
@@ -1354,6 +1369,21 @@ var init_overlay = __esm({
     InputSchema7 = zod.z.object({
       video_url: zod.z.string().url(),
       color: zod.z.string().optional(),
+      hook: zod.z.object({ text: zod.z.string().max(60), duration_sec: zod.z.number().min(1).max(6).optional() }).optional(),
+      callout: zod.z.object({
+        title: zod.z.string().max(32),
+        subtitle: zod.z.string().max(40).optional(),
+        start_sec: zod.z.number().min(0).optional(),
+        duration_sec: zod.z.number().min(1).max(10).optional()
+      }).optional(),
+      review: zod.z.object({
+        quote: zod.z.string().max(90),
+        name: zod.z.string().max(30).optional(),
+        stars: zod.z.number().int().min(1).max(5).optional(),
+        start_sec: zod.z.number().min(0).optional(),
+        duration_sec: zod.z.number().min(1).max(10).optional()
+      }).optional(),
+      progress_bar: zod.z.boolean().optional(),
       offer: zod.z.object({
         text: zod.z.string().max(24),
         subtext: zod.z.string().max(40).optional(),
@@ -1375,9 +1405,42 @@ var init_overlay = __esm({
       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." },
+        hook: {
+          type: "object",
+          description: "Hook title over the first seconds, the overlay that decides whether people keep watching. 5-8 words.",
+          required: ["text"],
+          properties: {
+            text: { type: "string", maxLength: 60, description: 'e.g. "Octopuses have THREE hearts?".' },
+            duration_sec: { type: "number", minimum: 1, maximum: 6, description: "Default 2.5." }
+          }
+        },
+        callout: {
+          type: "object",
+          description: 'Lower-third label that slides in from the left: a benefit ("Ships in 24h") or a name and title.',
+          required: ["title"],
+          properties: {
+            title: { type: "string", maxLength: 32, description: "The label." },
+            subtitle: { type: "string", maxLength: 40, description: "Optional second line." },
+            start_sec: { type: "number", description: "Default 3." },
+            duration_sec: { type: "number", minimum: 1, maximum: 10, description: "Default 4." }
+          }
+        },
+        review: {
+          type: "object",
+          description: "Review card: stars, a short quote and a name.",
+          required: ["quote"],
+          properties: {
+            quote: { type: "string", maxLength: 90, description: "The review text, without quote marks." },
+            name: { type: "string", maxLength: 30, description: 'e.g. "Jess, verified buyer".' },
+            stars: { type: "integer", minimum: 1, maximum: 5, description: "Default 5." },
+            start_sec: { type: "number", description: "Default just after the hook." },
+            duration_sec: { type: "number", minimum: 1, maximum: 10, description: "Default 4." }
+          }
+        },
+        progress_bar: { type: "boolean", description: "A thin bar in the brand color across the top that fills as the video plays." },
         offer: {
           type: "object",
-          description: "Offer callout: a badge that pops in on cue.",
+          description: "Offer callout: a badge that pops in on cue (after the hook when there is one).",
           required: ["text"],
           properties: {
             text: { type: "string", maxLength: 24, description: 'e.g. "50% OFF".' },
@@ -1403,7 +1466,7 @@ var init_overlay = __esm({
     };
     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.',
+      description: 'Add short-form ad text layouts to a finished video, exact text in the brand color, clear of the TikTok/Reels/Shorts UI: hook (title over the first seconds), callout (lower-third label), review (stars, quote, name), progress_bar, offer ("50% OFF" badge) and end_card (logo, headline, button, web address over the held last frame). Pass video_url plus any of them; one call does all. 2 credits.',
       inputZod: InputSchema7,
       inputJsonSchema: InputJsonSchema7,
       allowedModels: [MODEL2],
@@ -3892,7 +3955,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.22.0" ;
+var PACKAGE_VERSION = "0.23.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) {