@pixeldojo/mcp 0.26.0 → 0.31.0

package/dist/cli.js

@@ -237,11 +237,11 @@ function nearestAspectFromEnum(requested, allowed) {
 }
 async function snapAspectRatio(apiId, requested, client, opts = {}) {
   if (!requested) return void 0;
-  const props = await getFieldConstraints(apiId, client);
-  if (props === null) {
+  const props2 = await getFieldConstraints(apiId, client);
+  if (props2 === null) {
     return opts.onUnknown === "omit" ? void 0 : requested;
   }
-  const field = props.aspect_ratio;
+  const field = props2.aspect_ratio;
   if (!field) return void 0;
   if (!field.enum || field.enum.length === 0) return requested;
   return nearestAspectFromEnum(requested, field.enum);
@@ -272,11 +272,11 @@ function resolutionHeight(value) {
 }
 async function snapResolution(apiId, requested, client, opts = {}) {
   if (!requested) return void 0;
-  const props = await getFieldConstraints(apiId, client);
-  if (props === null) {
+  const props2 = await getFieldConstraints(apiId, client);
+  if (props2 === null) {
     return opts.onUnknown === "omit" ? void 0 : requested;
   }
-  const field = props.resolution;
+  const field = props2.resolution;
   if (!field) return void 0;
   if (!field.enum || field.enum.length === 0) return requested;
   if (field.enum.includes(requested)) return requested;
@@ -297,11 +297,11 @@ async function snapResolution(apiId, requested, client, opts = {}) {
 }
 async function snapDuration(apiId, requested, client, opts = {}) {
   if (requested === void 0) return void 0;
-  const props = await getFieldConstraints(apiId, client);
-  if (props === null) {
+  const props2 = await getFieldConstraints(apiId, client);
+  if (props2 === null) {
     return opts.onUnknown === "omit" ? void 0 : requested;
   }
-  const field = props.duration;
+  const field = props2.duration;
   if (!field) return void 0;
   if (field.enum && field.enum.length > 0) {
     const allowed = field.enum.map(Number).filter((n) => Number.isFinite(n));
@@ -329,11 +329,11 @@ async function resolveImageRefs(apiId, urls, client) {
   if (urls.length === 0) return null;
   const info = await getModelInfo(apiId, client);
   if (info === null) return null;
-  const props = info.props;
-  const key = info.media ? info.media.image?.key : REF_KEYS.find((k) => props[k] !== void 0);
+  const props2 = info.props;
+  const key = info.media ? info.media.image?.key : REF_KEYS.find((k) => props2[k] !== void 0);
   if (!key) return null;
   const also = info.media?.image?.also;
-  const field = props[key] ?? {};
+  const field = props2[key] ?? {};
   if (field.type === "array") {
     const cap = typeof field.maxItems === "number" ? field.maxItems : urls.length;
     const kept = urls.slice(0, Math.max(1, cap));
@@ -549,7 +549,7 @@ var init_generate = __esm({
     InputSchema = z.object({
       prompt: z.string().min(1).max(8e3).describe('Prompt describing what to generate. Write @Name to use a character or element the user saved in Character Studio ("@Mara on a beach"): its photos are attached automatically on models that take reference images. pixeldojo_library source=characters lists them.'),
       model: z.string().optional().describe(
-        `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5" for images (the default), "seedance-2-5" for video (prompt only or a starting image), "wan-3-0-video" for video the others refuse. Use another model only when the user names one. Full catalog: https://pixeldojo.ai/api/v1/models; one model's fields: https://pixeldojo.ai/llm/{apiId}.txt. Omit for seedream-5, which makes still images only; name a video model to get a video.`
+        `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5" for images (the default), "seedance-2-5" for video (prompt only or a starting image), "kling-4-0" for a whole scene up to 30 s written as a shot list (dialogue in quotes, exact on-screen text), "minimax-h3-turbo" for the cheapest video from a photo or up to 9 reference images (it needs at least one picture), "wan-3-0-video" for video the others refuse. Use another model only when the user names one. Full catalog: https://pixeldojo.ai/api/v1/models; one model's fields: https://pixeldojo.ai/llm/{apiId}.txt. Omit for seedream-5, which makes still images only; name a video model to get a video.`
       ),
       preset: z.string().optional().describe(
         "Preset slug that seeds the running model's settings; explicit fields and params override it. Each preset belongs to one model (browse them by model at https://pixeldojo.ai/presets), so set `model` to that preset's model: a slug the running model has no preset for is rejected with a 400 before any charge."
@@ -588,7 +588,7 @@ var init_generate = __esm({
         prompt: { type: "string", description: 'Prompt describing what to generate. Write @Name to use a character or element the user saved in Character Studio ("@Mara on a beach"): its photos are attached automatically on models that take reference images. pixeldojo_library source=characters lists them.' },
         model: {
           type: "string",
-          description: `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5" for images (the default), "seedance-2-5" for video (prompt only or a starting image), "wan-3-0-video" for video the others refuse. Use another model only when the user names one. Full catalog: https://pixeldojo.ai/api/v1/models; one model's fields: https://pixeldojo.ai/llm/{apiId}.txt. Omit for seedream-5, which makes still images only; name a video model to get a video.`
+          description: `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5" for images (the default), "seedance-2-5" for video (prompt only or a starting image), "kling-4-0" for a whole scene up to 30 s written as a shot list (dialogue in quotes, exact on-screen text), "minimax-h3-turbo" for the cheapest video from a photo or up to 9 reference images (it needs at least one picture), "wan-3-0-video" for video the others refuse. Use another model only when the user names one. Full catalog: https://pixeldojo.ai/api/v1/models; one model's fields: https://pixeldojo.ai/llm/{apiId}.txt. Omit for seedream-5, which makes still images only; name a video model to get a video.`
         },
         preset: {
           type: "string",
@@ -636,8 +636,8 @@ var init_generate = __esm({
     };
     generateSkill = {
       name: "pixeldojo_generate",
-      description: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills, `video_url` for a source clip, `image_path`/`image_paths` for absolute local files (uploaded to 24h temp storage first). A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
-      hostedDescription: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills and `video_url` for a source clip, all public http(s) URLs. A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
+      description: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image; kling-4-0 for a multi-shot scene up to 30 s with dialogue; minimax-h3-turbo for the lowest price when you have a photo or reference images (it refuses a prompt alone). If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills, `video_url` for a source clip, `image_path`/`image_paths` for absolute local files (uploaded to 24h temp storage first). A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
+      hostedDescription: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image; kling-4-0 for a multi-shot scene up to 30 s with dialogue; minimax-h3-turbo for the lowest price when you have a photo or reference images (it refuses a prompt alone). If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills and `video_url` for a source clip, all public http(s) URLs. A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
       inputZod: InputSchema,
       inputJsonSchema: InputJsonSchema,
       allowedModels: null,
@@ -1051,6 +1051,8 @@ var init_storyboard = __esm({
     ALLOWED2 = [
       "veo-3.1-fast",
       "veo-3.1-standard",
+      // Kling 4.0 (2026-10-24): a brief written as a shot list renders as one clip, up to 30 s.
+      "kling-4-0",
       "kling-video-v3-standard-text",
       "seedance-2-high",
       VIDEO_REFERENCE_MODEL
@@ -1671,7 +1673,7 @@ function needsSave(url) {
   return Boolean(url && url.startsWith("https://temp.pixeldojo.ai/"));
 }
 async function filmApi(ctx, method, path, body) {
-  const res = await fetch(`${ctx.baseUrl}${path}`, {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}${path}`, {
     method,
     headers: {
       Authorization: `Bearer ${ctx.apiKey}`,
@@ -2253,7 +2255,7 @@ var STORY_LOOKS, MUSIC_VIDEO_LOOKS, LOOKS, InputSchema10, InputJsonSchema10, sho
 var init_film = __esm({
   "src/skills/film.ts"() {
     init_upload_helpers();
-    STORY_LOOKS = ["live-action", "anime", "3d-animation", "noir", "horror", "sci-fi", "documentary", "western", "romance", "romantic-comedy", "comedy"];
+    STORY_LOOKS = ["live-action", "action", "anime", "3d-animation", "noir", "horror", "sci-fi", "documentary", "western", "romance", "romantic-comedy", "comedy"];
     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];
     InputSchema10 = z.object({
@@ -2442,6 +2444,27 @@ function buildVideoPayload(verb, apiId, i) {
         return { body: { prompt, video_url: i.videoUrl, video_duration: vd }, note: droppedImages };
       case "happyhorse-1.0-video-edit":
         return { body: { prompt, video_url: i.videoUrl, video_duration: vd, reference_urls: i.images } };
+      case "kling-4-0":
+        return {
+          body: {
+            prompt: /@video\s*1/i.test(prompt) ? prompt : `Edit @Video1: ${prompt}`,
+            video: i.videoUrl,
+            reference_images: i.images,
+            duration: clamp(Math.ceil(vd), 3, 30),
+            resolution: "1080p"
+          }
+        };
+      case "minimax-h3-turbo":
+        return {
+          body: {
+            prompt: `Recreate <Video 1> exactly: the same people, the same motion and timing, the same camera move and framing, with one change: ${prompt}`,
+            reference_videos: [i.videoUrl],
+            reference_video_audio: true,
+            resolution: "720p",
+            duration: clamp(Math.ceil(vd ?? 5), 5, 15)
+          },
+          note: droppedImages
+        };
       default:
         return { body: { prompt, video_url: i.videoUrl, video_duration: vd, image_urls: i.images } };
     }
@@ -2570,6 +2593,8 @@ var init_video = __esm({
         "seedance-2-5-video-edit",
         "flux-video-edit",
         "kling-video-edit",
+        "kling-4-0",
+        "minimax-h3-turbo",
         "wan-video-edit",
         "seedance-video-edit",
         "happyhorse-1.0-video-edit",
@@ -2589,9 +2614,10 @@ var init_video = __esm({
       "happyhorse-1.0-video-edit",
       "xai-video-edit",
       "kling-motion-control",
-      "wan-video-character-swap"
+      "wan-video-character-swap",
+      "kling-4-0"
     ]);
-    NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["flux-video-edit", "xai-video-edit"]);
+    NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["flux-video-edit", "xai-video-edit", "minimax-h3-turbo"]);
     InputSchema11 = z.object({
       verb: z.enum(VERBS),
       prompt: z.string().max(8e3).optional(),
@@ -2677,7 +2703,7 @@ var init_video = __esm({
   }
 });
 async function episodeApi(ctx, method, path, body) {
-  const res = await fetch(`${ctx.baseUrl}/api/faceless-studio/episodes${path}`, {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}/api/faceless-studio/episodes${path}`, {
     method,
     headers: {
       Authorization: `Bearer ${ctx.apiKey}`,
@@ -2917,6 +2943,487 @@ var init_episode = __esm({
     };
   }
 });
+async function dramaApi(ctx, method, path, body) {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}/api/v1/drama${path}`, {
+    method,
+    headers: {
+      Authorization: `Bearer ${ctx.apiKey}`,
+      "Content-Type": "application/json",
+      "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
+      "x-pixeldojo-skill": "drama"
+    },
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, data };
+}
+function describeDrama(v, o = DRAMA_OPTS) {
+  const id = v.id;
+  const stubborn = Array.from(new Set(v.retaken.filter((b, i, all) => all.indexOf(b) !== i)));
+  const simplify = stubborn.length ? `${o.unit[0].toUpperCase()}${o.unit.slice(1)}s ${stubborn.join(", ")} have been filmed three times: suggest simplifying them (drop an action, split a busy shot, change the angle) rather than rewording the note.` : "";
+  const next2 = (action) => `${o.tool} with {"${o.idField}": "${id}", "action": "${action}"}`;
+  const music = o.unit === "section";
+  const what = music ? "music video" : "episode";
+  if (v.status === "failed") return { kind: "text", text: `The ${what} stopped: ${v.error ?? "unknown error"}. Each render that failed was refunded.${v.beats.some((b) => b.url) ? ` Re-film ${o.unit}s with action "redo".` : ""}` };
+  if (v.status === "quote") {
+    const cost = music ? `Filming costs about ${v.estimate_credits} credits (cast portraits and ${v.sections?.length ?? "several"} sections lip-synced to the song).` : `Filming costs about ${v.estimate_credits} credits (cast portraits, 12-second scenes with their dialogue and sound${v.score === false ? ", no music" : ", and one score over the finished edit"}); every scene is checked, and a scene that drops a line or shows a clear fault waits for the user's OK before it is filmed again, at the scene's own price (a render that fails is tried again free).`;
+    return {
+      kind: "text",
+      text: [`Planned (${o.idField}: ${id}), ${v.format === "9:16" ? "vertical 9:16" : "widescreen 16:9"} (to switch, create it again in the other format before producing):`, v.plan ?? "", "", `Nothing has been charged yet. ${cost} Show this to the user and, once they agree, call ${next2("produce")}. (In Sensei: put it in pixeldojo_plan as ONE step with skill "${music ? "music_video" : "drama"}" and params {"${o.idField}": "${id}"}, which prices it from this quote.)`].join("\n")
+    };
+  }
+  const gist = (note) => {
+    const first = note.split(/(?<=\.) /)[0];
+    return first.length > 160 ? `${first.slice(0, 157).trimEnd()}...` : first;
+  };
+  const rewrites = (b) => {
+    const shots2 = Array.from(new Set(Array.from((b.redo_films ?? "").matchAll(/Shot (\d+) \(/g), (m) => m[1])));
+    return shots2.length ? ` (the redo rewrites shot${shots2.length > 1 ? "s" : ""} ${shots2.join(", ")})` : "";
+  };
+  if (v.status === "notes") {
+    const flagged = v.beats.filter((b) => b.note && (b.needs_redo ?? true));
+    const other = v.beats.filter((b) => b.note && b.needs_redo === false);
+    return {
+      kind: "text",
+      text: [
+        `Every ${o.unit} is filmed. Before the cut, the review flagged ${o.unit}s ${flagged.map((b) => b.beat).join(", ")}:`,
+        ...flagged.map((b) => `- ${o.unit} ${b.beat}: ${gist(b.note)}${rewrites(b)}`),
+        other.length ? `Also noted, no redo needed: ${other.map((b) => `${o.unit} ${b.beat}: ${gist(b.note)}`).join(" ")}` : "",
+        simplify,
+        `Show these to the user and ask which they want: redo those ${o.unit}s with the review's fixes (${o.tool} with {"${o.idField}": "${id}", "action": "redo", "beats": [${flagged.map((b) => b.beat).join(", ")}]}, no notes needed, each at its own price; add notes only for the user's own changes), or cut it as it is (action "cut", free). Nothing more is filmed until they choose.`
+      ].filter(Boolean).join("\n")
+    };
+  }
+  if (v.status === "done" && v.final_url) {
+    const redo = v.beats.filter((b) => (b.note || b.missing_lines.length) && (b.needs_redo ?? true));
+    const notes = redo.map((b) => `${o.unit} ${b.beat}: ${b.note ? gist(b.note) : `did not say ${b.missing_lines.map((l) => `"${l}"`).join(", ")}`}`);
+    const other = v.beats.filter((b) => b.note && b.needs_redo === false).map((b) => `${o.unit} ${b.beat}: ${gist(b.note)}`);
+    return {
+      kind: "assets",
+      text: [
+        `"${v.title}" is finished and saved to the Library: ${v.final_url}`,
+        v.retaken.length ? `Filmed again: ${o.unit} ${v.retaken.join(", ")}.` : "",
+        notes.length ? `Review notes: ${notes.join("; ")}. Offer a redo of those ${o.unit}s (action "redo" with beats and notes).` : "",
+        other.length ? `Also noted, no redo needed: ${other.join("; ")}.` : "",
+        simplify
+      ].filter(Boolean).join("\n"),
+      assetUrls: [v.final_url]
+    };
+  }
+  const doing = music ? { scripting: "listening to the song and writing the plan", shots: "filming the sections", cutting: "cutting it to the song" }[v.status] ?? STEP[v.status] ?? v.status : STEP[v.status] ?? v.status;
+  const ready = v.beats.filter((b) => b.url).length;
+  const total = v.beats.length || (music ? v.sections?.length ?? 0 : 5);
+  const again = v.rendering.map((n) => v.beats.find((b) => b.beat === n)).filter((b) => Boolean(b?.url)).map((b) => `${o.unit} ${b.beat} is being filmed again${b.filming_note ? ` (your note: ${gist(b.filming_note)})` : b.missing_lines.length ? ` (it dropped the line "${b.missing_lines[0]}")` : b.note ? ` (the review asked: ${gist(b.note)})` : ""}`);
+  return {
+    kind: "text",
+    text: `Still ${doing}${v.status === "shots" ? ` (${ready} of ${total} ${o.unit}s ready${v.rendering.length ? `, filming ${o.unit} ${v.rendering.join(", ")}` : ""})` : ""}.${again.length ? ` ${again.join("; ")}.` : ""} It takes about 10 to 15 minutes in all. Call ${next2("status")} in about a minute.`,
+    followUp: { input: { action: "status", [o.idField]: id }, afterSec: v.status === "scripting" ? 20 : 45 }
+  };
+}
+async function waitForPlan2(ctx, id) {
+  const sleep = ctx.pollOverrides?.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  let last = await dramaApi(ctx, "GET", `/${id}`);
+  for (let i = 0; i < 8 && last.data.status === "scripting"; i += 1) {
+    await sleep(3e3);
+    last = await dramaApi(ctx, "GET", `/${id}`);
+  }
+  return last;
+}
+var KINDS, LOOKS2, STORY_TYPES, InputSchema13, InputJsonSchema13, errorText, STEP, DRAMA_OPTS, dramaSkill;
+var init_drama = __esm({
+  "src/skills/drama.ts"() {
+    KINDS = ["micro-drama", "short-film", "trailer"];
+    LOOKS2 = ["live-action", "action", "anime", "3d-animation", "noir", "horror", "sci-fi", "documentary", "western", "romance", "romantic-comedy", "comedy"];
+    STORY_TYPES = ["billionaire", "werewolf", "mafia", "revenge", "secret-identity", "vampire", "second-chance"];
+    InputSchema13 = z.object({
+      action: z.enum(["create", "produce", "status", "redo", "cut"]).default("create"),
+      idea: z.string().min(8).max(1500).optional(),
+      format: z.enum(["9:16", "16:9"]).default("9:16"),
+      mature: z.boolean().optional(),
+      kind: z.enum(KINDS).default("micro-drama"),
+      look: z.enum(LOOKS2).optional(),
+      story_type: z.enum(STORY_TYPES).optional(),
+      title_card: z.boolean().optional(),
+      name_tags: z.boolean().optional(),
+      end_screen: z.boolean().optional(),
+      end_text: z.string().max(60).optional(),
+      brand_color: z.string().regex(/^#[0-9a-fA-F]{6}$/).optional(),
+      logo_url: z.string().url().optional(),
+      cast: z.array(z.object({ name: z.string().min(1).max(40), image_url: z.string().url() })).max(5).optional(),
+      scenes: z.number().int().min(1).max(15).optional(),
+      score: z.boolean().optional(),
+      drama_id: z.string().max(60).optional(),
+      beats: z.array(z.number().int().min(1).max(15)).min(1).max(15).optional(),
+      notes: z.array(z.string().max(300)).max(15).optional()
+    });
+    InputJsonSchema13 = {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["create", "produce", "status", "redo", "cut"],
+          description: "create (default, free): writes the episode plan (5 scenes unless scenes says, cast, lines) and returns drama_id and the price. Show the plan and price to the user and wait for their OK. produce (charged): films it. status (free): progress; call every ~60s until it returns the episode. redo (charged): re-film chosen beats of a finished episode or one waiting at the review, then it cuts again. cut (free): when the review flagged beats and the user wants it as it is, cut it now."
+        },
+        idea: { type: "string", description: "Create: the story in a line or two (who, the conflict, the twist)." },
+        format: { type: "string", enum: ["9:16", "16:9"], description: "Create: vertical 9:16 (default) or widescreen 16:9." },
+        mature: { type: "boolean", description: "Create: true for adult work (the server also detects it from the idea). Runs on the less-restricted engines." },
+        kind: {
+          type: "string",
+          enum: [...KINDS],
+          description: "Create: micro-drama (default: episode one with a hook and a cliffhanger), short-film (a complete 60 s story) or trailer (sells a film that does not exist, never shows the ending)."
+        },
+        look: { type: "string", enum: [...LOOKS2], description: "Create (optional): the visual style and genre. Default live-action (a micro-drama story type brings its own)." },
+        story_type: {
+          type: "string",
+          enum: [...STORY_TYPES],
+          description: "Create (optional, micro-drama only): the genre, which sets its promises (a hidden heir, a fated mate, a debt of blood...). Pick the one the idea fits; omit for anything else."
+        },
+        title_card: { type: "boolean", description: "Create: the episode title over the opening hook. Default on." },
+        name_tags: { type: "boolean", description: "Create: a name and role tag the first time each character speaks. Default on." },
+        end_screen: { type: "boolean", description: 'Create: a 3.5-second "To be continued" end screen after the last line. Default on.' },
+        end_text: { type: "string", description: `Create: the end screen's line, up to 60 characters. Default "Episode 2 coming soon".` },
+        brand_color: { type: "string", description: "Create: accent colour for the graphics, #RRGGBB. Default a warm gold." },
+        logo_url: { type: "string", description: "Create: a logo on the PixelDojo CDN for the end screen." },
+        cast: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "The character's name as the story uses it." },
+              image_url: { type: "string", description: "A clear front-facing portrait on the PixelDojo CDN." }
+            },
+            required: ["name", "image_url"]
+          },
+          description: "Create (optional): up to 5 characters to star (people, animals or creatures), each with a portrait on the PixelDojo CDN (a saved character from pixeldojo_library). Others get a portrait made for them."
+        },
+        scenes: { type: "integer", minimum: 1, maximum: 15, description: "Create (optional): how many 12-second scenes, default 5. Pass it when the user names a count or a length (about 12 s a scene)." },
+        score: { type: "boolean", description: "Create (optional): one score laid over the finished edit, on by default and included in the price. Pass false only when the user wants no music (dialogue and ambience only)." },
+        drama_id: { type: "string", description: "From create. Required for produce, status and redo." },
+        beats: { type: "array", items: { type: "integer", minimum: 1, maximum: 15 }, description: "Redo: the beat numbers to film again." },
+        notes: { type: "array", items: { type: "string" }, description: "Redo (optional): what to fix in each of those beats, in the same order." }
+      }
+    };
+    errorText = (d, status2) => (typeof d.error === "string" ? d.error : d.error?.message) ?? `HTTP ${status2}`;
+    STEP = {
+      scripting: "writing the episode",
+      keyframes: "making the cast portraits and the location",
+      shots: "filming the beats",
+      cutting: "cutting the episode"
+    };
+    DRAMA_OPTS = { tool: "pixeldojo_drama", idField: "drama_id", unit: "beat" };
+    dramaSkill = {
+      name: "pixeldojo_drama",
+      description: "Make a 60-second micro-drama episode (hook, twist, cliffhanger; optionally a classic genre such as billionaire, werewolf or mafia), short film (a complete story) or movie trailer from an idea, vertical 9:16 or 16:9, in any of Film Studio's looks (live-action, anime, 3D animation, noir, horror, sci-fi, western, romance, comedy and more). Five 12-second scenes, each filmed in one pass with several cuts, the cast's faces kept from portraits and every line spoken and lip-synced, cut together with their own sound and one score over the finished edit, with free motion graphics (title card, name tags, end screen; each can be turned off), and saved to the Library. Not for music videos (pixeldojo_music_video) create is free and returns the plan and the exact price (about 380 credits for a regular episode, about 160 for mature work); produce films it; then call status until it is finished (10-15 minutes).",
+      inputZod: InputSchema13,
+      inputJsonSchema: InputJsonSchema13,
+      allowedModels: ["seedance-2-5", "seedream-4"],
+      defaultModel: "seedance-2-5",
+      async run(input, ctx) {
+        if (input.action === "create") {
+          if (!input.idea?.trim()) return { kind: "text", text: "Provide an `idea` (a line or two) to plan an episode." };
+          const created = await dramaApi(ctx, "POST", "", {
+            idea: input.idea.trim(),
+            format: input.format,
+            kind: input.kind,
+            ...input.mature ? { mature: true } : {},
+            ...input.look ? { look: input.look } : {},
+            ...input.story_type ? { story_type: input.story_type } : {},
+            ...input.scenes ? { scenes: input.scenes } : {},
+            ...input.score === false ? { score: false } : {},
+            ...Object.fromEntries(
+              ["title_card", "name_tags", "end_screen", "end_text", "brand_color", "logo_url"].filter((k) => input[k] !== void 0).map((k) => [k, input[k]])
+            ),
+            ...input.cast?.length ? { cast: input.cast } : {},
+            // Stop before the cut when the review flags a scene: the user decides, not the agent.
+            review: true
+          });
+          if (!created.data.id) return { kind: "text", text: `Could not start the episode: ${errorText(created.data, created.status)}` };
+          const planned = await waitForPlan2(ctx, created.data.id);
+          return describeDrama(planned.data);
+        }
+        if (!input.drama_id) return { kind: "text", text: `${input.action} needs drama_id (from create).` };
+        const res = input.action === "status" ? await dramaApi(ctx, "GET", `/${input.drama_id}`) : input.action === "produce" || input.action === "cut" ? await dramaApi(ctx, "POST", `/${input.drama_id}`, { action: input.action }) : input.beats?.length ? await dramaApi(ctx, "POST", `/${input.drama_id}`, { action: "redo", beats: input.beats, ...input.notes?.length ? { notes: input.notes } : {} }) : null;
+        if (!res) return { kind: "text", text: "redo needs beats (the beat numbers to film again)." };
+        if (!res.data.id) return { kind: "text", text: errorText(res.data, res.status) };
+        return describeDrama(res.data);
+      }
+    };
+  }
+});
+async function api(ctx, method, path, body) {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}/api/v1/music-video${path}`, {
+    method,
+    headers: {
+      Authorization: `Bearer ${ctx.apiKey}`,
+      "Content-Type": "application/json",
+      "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
+      "x-pixeldojo-skill": "music_video"
+    },
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  return { status: res.status, data: await res.json().catch(() => ({})) };
+}
+var MUSIC_LOOKS, InputSchema14, InputJsonSchema14, errorText2, describe, musicVideoSkill;
+var init_music_video = __esm({
+  "src/skills/music-video.ts"() {
+    init_drama();
+    MUSIC_LOOKS = [
+      "live-action",
+      "action",
+      "anime",
+      "3d-animation",
+      "noir",
+      "horror",
+      "sci-fi",
+      "documentary",
+      "western",
+      "romance",
+      "romantic-comedy",
+      "comedy",
+      "rap-video",
+      "neon-club",
+      "stage-performance",
+      "retro-camcorder",
+      "y2k-pop",
+      "moody-rnb",
+      "rock-grit",
+      "dream-pop",
+      "k-pop"
+    ];
+    InputSchema14 = z.object({
+      action: z.enum(["create", "produce", "status", "redo"]).default("create"),
+      song_url: z.string().url().optional(),
+      idea: z.string().min(8).max(1500).optional(),
+      format: z.enum(["9:16", "16:9"]).default("9:16"),
+      mature: z.boolean().optional(),
+      look: z.enum(MUSIC_LOOKS).optional(),
+      start_sec: z.number().min(0).optional(),
+      length_sec: z.number().int().min(10).max(60).optional(),
+      artist: z.string().max(60).optional(),
+      song_title: z.string().max(80).optional(),
+      title_card: z.boolean().optional(),
+      end_screen: z.boolean().optional(),
+      end_text: z.string().max(60).optional(),
+      cast: z.array(z.object({ name: z.string().min(1).max(40), image_url: z.string().url() })).max(3).optional(),
+      music_video_id: z.string().max(60).optional(),
+      beats: z.array(z.number().int().min(1).max(12)).min(1).max(12).optional(),
+      notes: z.array(z.string().max(300)).max(12).optional()
+    });
+    InputJsonSchema14 = {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["create", "produce", "status", "redo"],
+          description: "create (default, free): hears the song, splits it into sections and writes the plan; returns music_video_id and the price. Show both and wait for the user's OK. produce (charged): films it. status (free): progress; call every ~60s until it returns the video. redo (charged): re-film chosen sections, then it cuts again."
+        },
+        song_url: { type: "string", description: "Create: the song on the PixelDojo CDN (attach or upload it first)." },
+        idea: { type: "string", description: "Create: the story or performance concept in a line or two." },
+        format: { type: "string", enum: ["9:16", "16:9"], description: "Create: vertical 9:16 (default) or widescreen 16:9." },
+        mature: { type: "boolean", description: "Create: true for adult work (the server also detects it from the idea). Runs on the less-restricted engines." },
+        look: { type: "string", enum: [...MUSIC_LOOKS], description: "Create (optional): the visual style, e.g. neon-club, rap-video, stage-performance, retro-camcorder, k-pop." },
+        start_sec: { type: "number", description: "Create (optional): where in the song to start, in seconds. Default 0." },
+        length_sec: { type: "integer", minimum: 10, maximum: 60, description: "Create (optional): seconds of the song to film, 10 to 60. Default 60 or the rest of the song." },
+        artist: { type: "string", description: "Create (optional): the artist name for the title card." },
+        song_title: { type: "string", description: "Create (optional): the song title for the title card." },
+        title_card: { type: "boolean", description: "Create: the song title over the opening. Default on." },
+        end_screen: { type: "boolean", description: "Create: an end screen after the song. Default off." },
+        end_text: { type: "string", description: "Create: the end screen's line, up to 60 characters." },
+        cast: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "The character's name; the first one is the performer." },
+              image_url: { type: "string", description: "A clear front-facing portrait on the PixelDojo CDN." }
+            },
+            required: ["name", "image_url"]
+          },
+          description: "Create (optional): up to 3 characters, the performer first, each with a portrait on the PixelDojo CDN."
+        },
+        music_video_id: { type: "string", description: "From create. Required for produce, status and redo." },
+        beats: { type: "array", items: { type: "integer", minimum: 1 }, description: "Redo: the section numbers to film again." },
+        notes: { type: "array", items: { type: "string" }, description: "Redo (optional): what to fix in each of those sections, in the same order." }
+      }
+    };
+    errorText2 = (d, status2) => (typeof d.error === "string" ? d.error : d.error?.message) ?? `HTTP ${status2}`;
+    describe = (v) => describeDrama(v, { tool: "pixeldojo_music_video", idField: "music_video_id", unit: "section" });
+    musicVideoSkill = {
+      name: "pixeldojo_music_video",
+      description: "Make a music video for the user's song (up to 60 seconds of it), vertical 9:16 or 16:9, in any Film Studio look (neon club, rap video, stage performance, retro camcorder, k-pop, anime and more). The song is split into sections at lyric gaps and each section is filmed in one pass to its own slice of the song, so the performer's lips follow every word, with the cast's faces kept from portraits; then it is cut under the original song with a title card and saved to the Library. create is free and returns the plan and price (about 1.25 credits per second of song plus portraits); produce films it; then call status until it is finished (10-15 minutes).",
+      inputZod: InputSchema14,
+      inputJsonSchema: InputJsonSchema14,
+      allowedModels: ["p-video-2-pro-reference", "seedream-4"],
+      defaultModel: "p-video-2-pro-reference",
+      async run(input, ctx) {
+        if (input.action === "create") {
+          if (!input.song_url || !input.idea?.trim()) return { kind: "text", text: "Provide `song_url` (the song on the PixelDojo CDN) and an `idea` to plan a music video." };
+          const { action: _a, music_video_id: _m, beats: _b, notes: _n, ...rest } = input;
+          const created = await api(ctx, "POST", "", { ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)), idea: input.idea.trim() });
+          if (!created.data.id) return { kind: "text", text: `Could not start the music video: ${errorText2(created.data, created.status)}` };
+          const sleep = ctx.pollOverrides?.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+          let last = await api(ctx, "GET", `/${created.data.id}`);
+          for (let i = 0; i < 8 && last.data.status === "scripting"; i += 1) {
+            await sleep(3e3);
+            last = await api(ctx, "GET", `/${created.data.id}`);
+          }
+          return describe(last.data);
+        }
+        if (!input.music_video_id) return { kind: "text", text: `${input.action} needs music_video_id (from create).` };
+        const id = input.music_video_id;
+        const res = input.action === "status" ? await api(ctx, "GET", `/${id}`) : input.action === "produce" ? await api(ctx, "POST", `/${id}`, { action: "produce" }) : input.beats?.length ? await api(ctx, "POST", `/${id}`, { action: "redo", beats: input.beats, ...input.notes?.length ? { notes: input.notes } : {} }) : null;
+        if (!res) return { kind: "text", text: "redo needs beats (the section numbers to film again)." };
+        if (!res.data.id) return { kind: "text", text: errorText2(res.data, res.status) };
+        return describe(res.data);
+      }
+    };
+  }
+});
+async function kataApi(ctx, method, path, body) {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}/api/v1/kata${path}`, {
+    method,
+    headers: {
+      Authorization: `Bearer ${ctx.apiKey}`,
+      "Content-Type": "application/json",
+      "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
+      "x-pixeldojo-skill": "kata"
+    },
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, data };
+}
+function describeKata(v) {
+  const next2 = (action) => `pixeldojo_kata with {"kata_id": "${v.id}", "action": "${action}"}`;
+  if (v.status === "failed") return { kind: "text", text: `The Kata stopped: ${v.error ?? "unknown error"}. Anything that failed was refunded.` };
+  if (v.status === "quote") {
+    const scenes = v.scenes.map((s, i) => `${i + 1}. ${KIND[s.kind] ?? s.kind}${s.cast.length ? ` with ${s.cast.join(" and ")}` : ""}${s.prompt ? `: ${s.prompt.slice(0, 140)}` : ""}`);
+    const words = v.shots.filter((s) => s.text).map((s) => `${s.from.toFixed(1)}s "${s.text}"`);
+    return {
+      kind: "text",
+      text: [
+        `Planned "${v.title}" (kata_id: ${v.id}): ${v.duration_sec}s, ${v.format}, ${v.shots.length} cuts kept to the frame, ${v.scenes.length} setups:`,
+        ...scenes,
+        words.length ? `On screen: ${words.join(", ")}.` : "",
+        `Price: about ${v.estimate_credits} credits (${(v.quote ?? []).map((l) => `${l.label} ${l.credits}`).join(", ")}); up to ${v.max_credits_with_retakes} if bad takes are made again. Nothing has been charged yet. Show this to the user and, once they agree, call ${next2("produce")}. (In Sensei: put it in pixeldojo_plan as ONE step with skill "kata" and params {"kata_id": "${v.id}"}, which prices it from this quote.)`
+      ].filter(Boolean).join("\n")
+    };
+  }
+  if (v.status === "done" && v.final_url) {
+    return { kind: "assets", text: `"${v.title}" is finished and saved to the Library: ${v.final_url}`, assetUrls: [v.final_url] };
+  }
+  return {
+    kind: "text",
+    text: `Still ${STEP2[v.status] ?? v.status}. It takes about 5 to 15 minutes in all. Call ${next2("status")} in about a minute.`,
+    followUp: { input: { action: "status", kata_id: v.id }, afterSec: v.status === "analyzing" || v.status === "scripting" ? 20 : 45 }
+  };
+}
+async function waitForPlan3(ctx, id) {
+  const sleep = ctx.pollOverrides?.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  let last = await kataApi(ctx, "GET", `/${id}`);
+  for (let i = 0; i < 10 && (last.data.status === "analyzing" || last.data.status === "scripting"); i += 1) {
+    await sleep(4e3);
+    last = await kataApi(ctx, "GET", `/${id}`);
+  }
+  return last;
+}
+var InputSchema15, InputJsonSchema15, errorText3, STEP2, KIND, kataSkill;
+var init_kata = __esm({
+  "src/skills/kata.ts"() {
+    InputSchema15 = z.object({
+      action: z.enum(["create", "produce", "status", "presets"]).default("create"),
+      reference_url: z.string().url().optional(),
+      preset: z.string().max(80).optional(),
+      cast: z.array(z.object({ name: z.string().min(1).max(40), image_url: z.string().url().optional(), description: z.string().max(200).optional() })).max(3).optional(),
+      photos: z.array(z.object({ url: z.string().url(), note: z.string().max(80).optional() })).max(4).optional(),
+      instructions: z.string().max(1500).optional(),
+      look: z.string().max(80).optional(),
+      kata_id: z.string().max(60).optional()
+    });
+    InputJsonSchema15 = {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["create", "produce", "status", "presets"],
+          description: "create (default, free): reads the reference edit and plans the remake; returns kata_id and the price. Show the plan and price and wait for the user's OK. produce (charged): makes it. status (free): progress; call every ~60s until it returns the edit. presets (free): the Kata library, ready-made edits to recreate."
+        },
+        reference_url: { type: "string", description: "Create: the 4 to 60 second edit to recreate: an upload on the PixelDojo CDN or a direct link to the video file. TikTok, Instagram, YouTube and X posts cannot be fetched: ask the user to save the video from the app and upload it. Or give preset instead." },
+        preset: { type: "string", description: 'Create: a Kata library preset slug (from action "presets") instead of a reference.' },
+        cast: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "Their name. Without image_url, the saved Character Studio character of that name." },
+              image_url: { type: "string", description: "A clear photo of them on the PixelDojo CDN." },
+              description: { type: "string", description: "Optional: who they are, in a few words." }
+            },
+            required: ["name"]
+          },
+          description: 'Create: up to 3 people who replace the people in the edit. Use saved characters by name (pixeldojo_library source "characters").'
+        },
+        photos: {
+          type: "array",
+          items: { type: "object", properties: { url: { type: "string", description: "Public URL of the photo." }, note: { type: "string", description: 'What it is (e.g. "the product").' } }, required: ["url"] },
+          description: "Create: up to 4 products or photos to put in the edit, on the PixelDojo CDN."
+        },
+        instructions: { type: "string", description: "Create (optional): what to change, e.g. the setting, the words on screen, where the product goes." },
+        look: { type: "string", description: 'Create (optional): style transfer, one look for every new shot, e.g. "hand-drawn anime".' },
+        kata_id: { type: "string", description: "From create. Required for produce and status." }
+      }
+    };
+    errorText3 = (d, status2) => d.message ?? (typeof d.error === "string" ? d.error : d.error?.message) ?? `HTTP ${status2}`;
+    STEP2 = {
+      analyzing: "reading the edit cut by cut",
+      scripting: "planning the remake",
+      music: "scoring a new track on the same tempo",
+      beats: "finding the beat",
+      keyframes: "making the keyframes",
+      animating: "filming the shots",
+      cutting: "cutting it where the reference cuts",
+      rendering: "setting the words and transitions",
+      reviewing: "checking the final cut"
+    };
+    KIND = { clip: "new shot", still: "still", swap: "motion transfer", photo: "your photo" };
+    kataSkill = {
+      name: "pixeldojo_kata",
+      description: `Kata: recreate a reference edit (a viral short, an ad, a montage, a trailer, 4 to 60 s) with the user's own characters, products and photos. It keeps the same pacing and cut points to the frame, the transitions, the camera moves, the caption style and the music feel (an original score on the same tempo, never the reference's audio); dance moves come across by motion transfer, and a look can restyle every shot. Start from a reference_url or a Kata library preset (action "presets"). create is free and returns the plan and the price; produce makes it; then call status until it is finished. Saved to the Library.`,
+      inputZod: InputSchema15,
+      inputJsonSchema: InputJsonSchema15,
+      allowedModels: ["seedance-2-5", "google-nano-banana", "kling-motion-control"],
+      defaultModel: "seedance-2-5",
+      async run(input, ctx) {
+        if (input.action === "presets") {
+          const res2 = await kataApi(ctx, "GET", "/presets");
+          const list = res2.data.presets ?? [];
+          if (!list.length) return { kind: "text", text: "The Kata library is empty right now. Recreate any edit with a reference_url." };
+          return {
+            kind: "text",
+            text: ["Kata library (pass the slug as preset):", ...list.map((p) => `- ${p.slug}: ${p.title} (${p.category}, ${Math.round(p.durationSec)}s, ${p.shots} cuts). ${p.blurb}`)].join("\n")
+          };
+        }
+        if (input.action === "create") {
+          if (!input.reference_url && !input.preset) return { kind: "text", text: 'Give a reference_url (the edit to recreate, on the PixelDojo CDN) or a preset from action "presets".' };
+          const created = await kataApi(ctx, "POST", "", {
+            ...input.preset ? { preset: input.preset } : { reference_url: input.reference_url },
+            ...input.cast?.length ? { cast: input.cast } : {},
+            ...input.photos?.length ? { photos: input.photos } : {},
+            ...input.instructions ? { instructions: input.instructions } : {},
+            ...input.look ? { look: input.look } : {}
+          });
+          if (!created.data.id) return { kind: "text", text: `Could not start the Kata: ${errorText3(created.data, created.status)}` };
+          const planned = await waitForPlan3(ctx, created.data.id);
+          return describeKata(planned.data);
+        }
+        if (!input.kata_id) return { kind: "text", text: `${input.action} needs kata_id (from create).` };
+        const res = input.action === "status" ? await kataApi(ctx, "GET", `/${input.kata_id}`) : await kataApi(ctx, "POST", `/${input.kata_id}`, { action: "produce" });
+        if (!res.data.id) return { kind: "text", text: errorText3(res.data, res.status) };
+        return describeKata(res.data);
+      }
+    };
+  }
+});
 async function run13(input, ctx) {
   const productImages = [
     ...input.product_image_urls ?? [],
@@ -2941,7 +3448,9 @@ async function run13(input, ctx) {
     quality: input.quality,
     resolution: input.resolution,
     aspect_ratio: input.aspect_ratio,
-    duration: input.duration
+    duration: input.duration,
+    reference_video_url: input.reference_video_url,
+    brand_kit: input.brand_kit
   };
   const client = ctx.client;
   const submitted = await client.runAd(body);
@@ -2957,16 +3466,16 @@ async function run13(input, ctx) {
   const styleLabel = submitted.ad?.style ?? input.style ?? "ugc-testimonial";
   return pollResultToSkillResult(
     result,
-    (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]}`
+    (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]} Add the brand end card (logo, tagline, button) with pixeldojo_marketing action end_card and this video_url.`
   );
 }
-var InputSchema13, InputJsonSchema13, adSkill;
+var InputSchema16, InputJsonSchema16, adSkill;
 var init_ad = __esm({
   "src/skills/ad.ts"() {
     init_types();
     init_poll();
     init_upload_helpers();
-    InputSchema13 = z.object({
+    InputSchema16 = z.object({
       style: 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."
       ),
@@ -2984,7 +3493,9 @@ var init_ad = __esm({
       quality: z.enum(["mini", "fast", "high"]).optional(),
       resolution: z.enum(["480p", "720p", "1080p", "4k"]).optional().describe('1080p/4k require quality "high".'),
       aspect_ratio: z.enum(["16:9", "4:3", "1:1", "3:4", "9:16", "21:9"]).optional(),
-      duration: z.number().int().min(4).max(15).optional()
+      duration: z.number().int().min(4).max(15).optional(),
+      reference_video_url: z.string().url().optional(),
+      brand_kit: z.boolean().optional()
     }).refine(
       (v) => v.product_url || (v.product_image_urls?.length || v.product_image_paths?.length) && v.product_name,
       {
@@ -2992,7 +3503,7 @@ var init_ad = __esm({
         path: ["product_url"]
       }
     );
-    InputJsonSchema13 = {
+    InputJsonSchema16 = {
       type: "object",
       properties: {
         style: {
@@ -3070,6 +3581,15 @@ var init_ad = __esm({
           minimum: 4,
           maximum: 15,
           description: "Ad length in seconds. Defaults to the style's length; clamped to what the engine allows."
+        },
+        reference_video_url: {
+          type: "string",
+          format: "uri",
+          description: "Ad multiplier: an ad that already works (https mp4, up to 30 s). The new ad copies its hook, pacing and camera moves with this product and presenter, never its product, people or text."
+        },
+        brand_kit: {
+          type: "boolean",
+          description: "The account's brand kit (palette, voice, selling points; see pixeldojo_brand_kit) rides on every ad. false skips it."
         }
       }
       // "product_url OR product_name+images" is enforced by the server and the
@@ -3079,8 +3599,8 @@ 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: InputSchema13,
-      inputJsonSchema: InputJsonSchema13,
+      inputZod: InputSchema16,
+      inputJsonSchema: InputJsonSchema16,
       // Composition skill — the server routes to the ad engine internally.
       allowedModels: [],
       defaultModel: "",
@@ -3115,10 +3635,10 @@ async function run14(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema14, InputJsonSchema14, campaignSkill;
+var InputSchema17, InputJsonSchema17, campaignSkill;
 var init_campaign = __esm({
   "src/skills/campaign.ts"() {
-    InputSchema14 = z.object({
+    InputSchema17 = z.object({
       productUrl: z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
       product: z.object({
         name: z.string().min(1).max(200),
@@ -3134,7 +3654,7 @@ var init_campaign = __esm({
       message: "productUrl or product is required",
       path: ["productUrl"]
     });
-    InputJsonSchema14 = {
+    InputJsonSchema17 = {
       type: "object",
       properties: {
         productUrl: {
@@ -3185,8 +3705,8 @@ 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: InputSchema14,
-      inputJsonSchema: InputJsonSchema14,
+      inputZod: InputSchema17,
+      inputJsonSchema: InputJsonSchema17,
       // Composition skill — internal sub-jobs route to per-tool models, no
       // single allowed-models list applies here.
       allowedModels: [],
@@ -3225,13 +3745,13 @@ async function run15(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema15, InputJsonSchema15, campaignStatusSkill;
+var InputSchema18, InputJsonSchema18, campaignStatusSkill;
 var init_campaign_status = __esm({
   "src/skills/campaign-status.ts"() {
-    InputSchema15 = z.object({
+    InputSchema18 = z.object({
       campaignId: z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo_campaign handoff.")
     });
-    InputJsonSchema15 = {
+    InputJsonSchema18 = {
       type: "object",
       properties: {
         campaignId: {
@@ -3244,8 +3764,8 @@ 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: InputSchema15,
-      inputJsonSchema: InputJsonSchema15,
+      inputZod: InputSchema18,
+      inputJsonSchema: InputJsonSchema18,
       allowedModels: [],
       defaultModel: "",
       run: run15
@@ -3268,16 +3788,16 @@ async function run16(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 InputSchema16, InputJsonSchema16, uploadSkill;
+var InputSchema19, InputJsonSchema19, uploadSkill;
 var init_upload = __esm({
   "src/skills/upload.ts"() {
     init_upload_helpers();
-    InputSchema16 = z.object({
+    InputSchema19 = z.object({
       path: 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."
       )
     });
-    InputJsonSchema16 = {
+    InputJsonSchema19 = {
       type: "object",
       properties: {
         path: {
@@ -3290,8 +3810,8 @@ 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: InputSchema16,
-      inputJsonSchema: InputJsonSchema16,
+      inputZod: InputSchema19,
+      inputJsonSchema: InputJsonSchema19,
       allowedModels: [],
       defaultModel: "",
       run: run16
@@ -3336,14 +3856,14 @@ async function run17(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Audio ready. Asset: ${urls[0]}`
   );
 }
-var ALLOWED4, DEFAULT_MODEL6, InputSchema17, InputJsonSchema17, audioSkill;
+var ALLOWED4, DEFAULT_MODEL6, InputSchema20, InputJsonSchema20, audioSkill;
 var init_audio = __esm({
   "src/skills/audio.ts"() {
     init_poll();
     init_types();
     ALLOWED4 = ["seed-audio", "text-to-speech"];
     DEFAULT_MODEL6 = "seed-audio";
-    InputSchema17 = z.object({
+    InputSchema20 = z.object({
       prompt: 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."
       ),
@@ -3353,7 +3873,7 @@ var init_audio = __esm({
       output_format: z.string().optional().describe("Output format. seed-audio: mp3 (default), wav, pcm, ogg_opus. text-to-speech: mp3 (default), wav, flac, pcm."),
       speed: z.number().min(0.5).max(2).optional().describe("Speech speed multiplier, 0.5-2 (default 1). Both models.")
     });
-    InputJsonSchema17 = {
+    InputJsonSchema20 = {
       type: "object",
       properties: {
         prompt: {
@@ -3391,8 +3911,8 @@ 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: InputSchema17,
-      inputJsonSchema: InputJsonSchema17,
+      inputZod: InputSchema20,
+      inputJsonSchema: InputJsonSchema20,
       allowedModels: [...ALLOWED4],
       defaultModel: DEFAULT_MODEL6,
       run: run17
@@ -3450,17 +3970,17 @@ ${lines.join("\n")}
 Pass any URL back into pixeldojo_generate, pixeldojo_edit, pixeldojo_character, or pixeldojo_upscale as a reference input.`
   };
 }
-var InputSchema18, InputJsonSchema18, librarySkill;
+var InputSchema21, InputJsonSchema21, librarySkill;
 var init_library = __esm({
   "src/skills/library.ts"() {
-    InputSchema18 = z.object({
+    InputSchema21 = z.object({
       source: 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: z.string().optional().describe("Substring match against the prompt that produced the asset."),
       model: z.string().optional().describe("Restrict to a single model (apiId)."),
       modality: z.enum(["image", "video", "audio"]).optional().describe("Restrict to one output type."),
       limit: z.number().int().min(1).max(50).optional().describe("Max results (default 10).")
     });
-    InputJsonSchema18 = {
+    InputJsonSchema21 = {
       type: "object",
       properties: {
         source: {
@@ -3485,8 +4005,8 @@ 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: InputSchema18,
-      inputJsonSchema: InputJsonSchema18,
+      inputZod: InputSchema21,
+      inputJsonSchema: InputJsonSchema21,
       allowedModels: [],
       defaultModel: "",
       run: run18
@@ -3507,17 +4027,17 @@ async function run19(input, ctx) {
 It will appear at https://pixeldojo.ai/my-images and in pixeldojo_library searches.`
   };
 }
-var InputSchema19, InputJsonSchema19, saveSkill;
+var InputSchema22, InputJsonSchema22, saveSkill;
 var init_save = __esm({
   "src/skills/save.ts"() {
-    InputSchema19 = z.object({
+    InputSchema22 = z.object({
       url: z.string().url().describe("The asset URL to save (image or video)."),
       prompt: z.string().optional().describe("The prompt that produced it \u2014 makes it findable in the library later."),
       tool_name: z.string().optional().describe("Tool/model slug that produced it."),
       modality: z.enum(["image", "video", "audio"]).optional(),
       job_id: z.string().optional().describe("The jobId that produced this asset, when known.")
     });
-    InputJsonSchema19 = {
+    InputJsonSchema22 = {
       type: "object",
       properties: {
         url: { type: "string", format: "uri", description: "The result URL to keep (image or video from a PixelDojo job)." },
@@ -3531,8 +4051,8 @@ 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: InputSchema19,
-      inputJsonSchema: InputJsonSchema19,
+      inputZod: InputSchema22,
+      inputJsonSchema: InputJsonSchema22,
       allowedModels: [],
       defaultModel: "",
       run: run19
@@ -3551,21 +4071,21 @@ async function run20(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, InputSchema20, InputJsonSchema20, saveCharacterSkill;
+var KINDS2, InputSchema23, InputJsonSchema23, saveCharacterSkill;
 var init_save_character = __esm({
   "src/skills/save-character.ts"() {
-    KINDS = ["character", "product", "outfit", "location", "object", "style"];
-    InputSchema20 = z.object({
+    KINDS2 = ["character", "product", "outfit", "location", "object", "style"];
+    InputSchema23 = z.object({
       name: z.string().min(1).max(60).describe("What to call it. Used as @Name in prompts."),
-      kind: z.enum(KINDS).optional().describe("Default character."),
+      kind: z.enum(KINDS2).optional().describe("Default character."),
       image_urls: z.array(z.string().url()).max(8).optional().describe("3 to 5 photos from different angles works best for a character."),
       description: z.string().max(1500).optional().describe("Appearance notes, or the scene text for an element.")
     });
-    InputJsonSchema20 = {
+    InputJsonSchema23 = {
       type: "object",
       properties: {
         name: { type: "string", description: "What to call it. Used as @Name in prompts afterwards." },
-        kind: { type: "string", enum: KINDS, description: "character (default), product, outfit, location, object (a prop) or style." },
+        kind: { type: "string", enum: KINDS2, description: "character (default), product, outfit, location, object (a prop) or style." },
         image_urls: {
           type: "array",
           items: { type: "string", format: "uri" },
@@ -3579,8 +4099,8 @@ 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: InputSchema20,
-      inputJsonSchema: InputJsonSchema20,
+      inputZod: InputSchema23,
+      inputJsonSchema: InputJsonSchema23,
       allowedModels: [],
       defaultModel: "",
       run: run20
@@ -3605,7 +4125,7 @@ async function listRun(input, ctx) {
   }
   const lines = effects.map((e) => {
     const ins = e.inputs.map(
-      (i) => i.kind === "image" ? `photo "${i.label}"` : `text "${i.label}"${i.options ? ` [${i.options.join(" | ")}]` : ""}${i.optional ? " (optional)" : ""}`
+      (i) => i.kind === "image" ? `photo "${i.label}"${i.optional ? " (optional)" : ""}` : `text "${i.label}"${i.options ? ` [${i.options.join(" | ")}]` : ""}${i.optional ? " (optional)" : ""}`
     );
     return `- ${e.slug} (${e.family}, ${e.output}, ${priceOf(e)}): ${e.title}. ${e.tagline} Inputs: ${ins.join(", ")}.`;
   });
@@ -3729,6 +4249,446 @@ var init_effects = __esm({
     };
   }
 });
+async function call2(ctx, skill, path, init = {}) {
+  const res = await (ctx.fetch ?? fetch)(`${ctx.baseUrl}${path}`, {
+    method: init.method ?? "GET",
+    headers: headers2(ctx, skill),
+    ...init.body !== void 0 ? { body: JSON.stringify(init.body) } : {}
+  });
+  const data = await res.json().catch(() => ({}));
+  const err = data.error;
+  return { ok: res.ok, data, error: typeof err === "string" ? err : err?.message ?? `HTTP ${res.status}` };
+}
+async function kitRun(input, ctx) {
+  const path = "/api/v1/marketing/brand-kit";
+  if (input.action === "import") {
+    if (!input.url) return { kind: "text", text: "Pass url: the brand's website, like yourbrand.com." };
+    const r2 = await call2(ctx, "pixeldojo_brand_kit", path, { method: "POST", body: { url: input.url, save: input.save } });
+    if (!r2.ok) return { kind: "text", text: `Brand kit not imported: ${r2.error}` };
+    return { kind: "text", text: `${r2.data.saved === false ? "Imported (not saved)." : "Imported and saved."}
+${describeKit(r2.data.brand_kit)}` };
+  }
+  if (input.action === "update") {
+    const patch = {
+      ...input.name !== void 0 ? { name: input.name } : {},
+      ...input.tagline !== void 0 ? { tagline: input.tagline } : {},
+      ...input.voice !== void 0 ? { voice: input.voice } : {},
+      ...input.colors ? { colors: input.colors.map((c) => c.trim().toLowerCase()) } : {},
+      ...input.fonts ? { fonts: input.fonts } : {},
+      ...input.selling_points ? { sellingPoints: input.selling_points } : {},
+      ...input.logo_url ? { logoUrl: input.logo_url } : {}
+    };
+    const r2 = await call2(ctx, "pixeldojo_brand_kit", path, { method: "PATCH", body: patch });
+    if (!r2.ok) return { kind: "text", text: `Brand kit not updated: ${r2.error}` };
+    return { kind: "text", text: `Updated.
+${describeKit(r2.data.brand_kit)}` };
+  }
+  const r = await call2(ctx, "pixeldojo_brand_kit", path);
+  if (!r.ok) return { kind: "text", text: `Could not read the brand kit: ${r.error}` };
+  return { kind: "text", text: describeKit(r.data.brand_kit ?? null) };
+}
+async function templatesRun(input, ctx) {
+  const q = new URLSearchParams();
+  if (input.kind) q.set("kind", input.kind);
+  if (input.category) q.set("category", input.category);
+  const r = await call2(ctx, "pixeldojo_marketing", `/api/v1/marketing/templates?${q}`);
+  if (!r.ok) return { kind: "text", text: `Could not list templates: ${r.error}` };
+  const rows = r.data.templates ?? [];
+  const lines = rows.map((t) => {
+    const how = t.kind === "image" ? "action image" : t.kind === "motion" ? `action motion, fields ${t.fields?.join(", ")}, ${t.credits} credits` : "pixeldojo_ad style";
+    return `- ${t.id} (${t.label}, ${t.category}): ${t.name}. ${how}. Example: ${t.preview ?? "none"}`;
+  });
+  const engines = r.data.image_engines ?? [];
+  return {
+    kind: "text",
+    text: [
+      `${rows.length} templates. Image templates run with action image (template = id), motion templates with action motion, video ad styles with pixeldojo_ad (style = id).`,
+      ...lines,
+      "",
+      `Image engines: ${engines.map((e) => `${e.id} ${e.credits_per_image} credits per image (${e.note})`).join("; ")}.`,
+      ...r.data.notes ?? []
+    ].join("\n")
+  };
+}
+async function imageRun(input, ctx) {
+  const local = input.product_image_paths?.length ? await uploadLocalFiles(input.product_image_paths, ctx) : [];
+  const images = [...input.product_image_urls ?? [], ...local];
+  if (!input.product_url && !(input.product_name && images.length)) {
+    return { kind: "text", text: "Pass product_url, or product_name plus product_image_urls (or product_image_paths)." };
+  }
+  const r = await call2(ctx, "pixeldojo_marketing", "/api/v1/marketing/image", {
+    method: "POST",
+    body: {
+      template: input.template,
+      product_url: input.product_url,
+      ...!input.product_url ? { product: { name: input.product_name, description: input.product_description, images } } : {},
+      character_images: input.character_image_urls,
+      headline: input.headline,
+      points: input.points,
+      cta: input.cta,
+      direction: input.direction,
+      aspect_ratio: input.aspect_ratio,
+      engine: input.engine,
+      count: input.count,
+      reference_ad_url: input.reference_ad_url,
+      brand_kit: input.brand_kit
+    }
+  });
+  if (!r.ok) return { kind: "text", text: `Images not started: ${r.error}` };
+  const jobs = r.data.jobs ?? [];
+  const polled = await Promise.all(
+    jobs.map(
+      (j) => pollJobUntilDoneOrHandoff(j.jobId, (id) => ctx.client.getJob(id), ctx.buildStatusUrl, {
+        now: ctx.pollOverrides?.now,
+        sleep: ctx.pollOverrides?.sleep
+      })
+    )
+  );
+  const urls = polled.flatMap((p) => p.kind === "completed" ? extractAssetUrls(p.job) : []);
+  const pending = polled.filter((p) => p.kind === "handoff").map((p) => p.jobId);
+  const failed = polled.filter((p) => p.kind === "failed").length;
+  const credits = jobs.reduce((n, j) => n + (j.creditCost ?? 0), 0);
+  const head = `${r.data.template} on ${r.data.engine}: ${urls.length} ready${pending.length ? `, ${pending.length} still rendering` : ""}${failed ? `, ${failed} failed (refunded)` : ""}${credits ? `, ${credits} credits` : ""}.`;
+  if (pending.length === 1 && !urls.length) {
+    return { kind: "handoff", text: `${head} Check it with pixeldojo_status.`, jobId: pending[0], statusUrl: ctx.buildStatusUrl(pending[0]) };
+  }
+  const tail = pending.length ? ` Still rendering: ${pending.join(", ")} (check each with pixeldojo_status).` : "";
+  if (urls.length) return { kind: "assets", text: `${head}${tail}`, assetUrls: urls };
+  return { kind: "text", text: `${head}${tail}` };
+}
+async function settleMotion(view, ctx) {
+  const now = ctx.pollOverrides?.now ?? Date.now;
+  const sleep = ctx.pollOverrides?.sleep ?? ((ms) => new Promise((res) => setTimeout(res, ms)));
+  const until = now() + 7e4;
+  let v = view;
+  while (v.status === "processing" && now() < until) {
+    await sleep(5e3);
+    const r = await call2(ctx, "pixeldojo_marketing", `/api/v1/marketing/motion/${encodeURIComponent(v.id)}`);
+    if (r.ok) v = r.data;
+  }
+  if (v.status === "completed" && v.video_url) {
+    return { kind: "assets", text: `${v.template === "end-card" ? "End card added" : "Motion graphic rendered"} (${v.credits ?? "?"} credits). Video: ${v.video_url}`, assetUrls: [v.video_url] };
+  }
+  if (v.status === "failed") return { kind: "text", text: `Render failed, nothing charged: ${v.error}` };
+  return {
+    kind: "text",
+    text: `Still rendering (${v.step}). Check it with pixeldojo_marketing action status motion_id ${v.id} in about 15 seconds.`,
+    followUp: { input: { action: "status", motion_id: v.id }, afterSec: 15 }
+  };
+}
+async function motionRun(input, ctx) {
+  if (input.action === "status") {
+    if (!input.motion_id) return { kind: "text", text: "Pass motion_id." };
+    const r2 = await call2(ctx, "pixeldojo_marketing", `/api/v1/marketing/motion/${encodeURIComponent(input.motion_id)}`);
+    if (!r2.ok) return { kind: "text", text: `Could not read that render: ${r2.error}` };
+    return settleMotion(r2.data, ctx);
+  }
+  const endCard = input.action === "end_card";
+  const product = input.product_image_urls?.[0] ?? (input.product_image_paths?.length ? (await uploadLocalFiles(input.product_image_paths.slice(0, 1), ctx))[0] : void 0);
+  const r = await call2(ctx, "pixeldojo_marketing", "/api/v1/marketing/motion", {
+    method: "POST",
+    body: {
+      template: endCard ? "end-card" : input.template,
+      aspect_ratio: input.aspect_ratio === "4:5" ? "9:16" : input.aspect_ratio,
+      headline: input.headline,
+      points: input.points,
+      cta: input.cta,
+      stat: input.stat,
+      stat_label: input.stat_label,
+      price_was: input.price_was,
+      price_now: input.price_now,
+      product_image_url: product,
+      video_url: input.video_url,
+      brand_name: input.brand_name,
+      colors: input.colors?.map((c) => c.trim().toLowerCase()),
+      brand_kit: input.brand_kit
+    }
+  });
+  if (!r.ok) return { kind: "text", text: `Not started: ${r.error}` };
+  return settleMotion(r.data, ctx);
+}
+async function marketingRun(input, ctx) {
+  if (input.action === "templates") return templatesRun(input, ctx);
+  if (input.action === "image") return imageRun(input, ctx);
+  return motionRun(input, ctx);
+}
+var headers2, KitSchema, describeKit, brandKitSkill, ACTIONS, MOTION, MarketingSchema, props, marketingSkill;
+var init_marketing = __esm({
+  "src/skills/marketing.ts"() {
+    init_poll();
+    init_upload_helpers();
+    init_types();
+    headers2 = (ctx, skill) => ({
+      Authorization: `Bearer ${ctx.apiKey}`,
+      "Content-Type": "application/json",
+      "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
+      "x-pixeldojo-skill": skill
+    });
+    KitSchema = z.object({
+      action: z.enum(["get", "import", "update"]).optional(),
+      url: z.string().max(2048).optional(),
+      save: z.boolean().optional(),
+      name: z.string().max(60).optional(),
+      tagline: z.string().max(80).optional(),
+      voice: z.string().max(240).optional(),
+      colors: z.array(z.string()).max(5).optional(),
+      fonts: z.array(z.string()).max(2).optional(),
+      selling_points: z.array(z.string()).max(5).optional(),
+      logo_url: z.string().url().optional()
+    });
+    describeKit = (k) => !k ? "No brand kit yet. Import one from the website with action import and url." : [
+      `Brand kit: ${k.name || "(no name)"}${k.url ? ` (${k.url})` : ""}`,
+      `Logo: ${k.logoUrl ?? "none (add logo_url, a PixelDojo upload)"}`,
+      `Colors: ${k.colors.join(" ") || "none"}`,
+      `Fonts: ${k.fonts.join(", ") || "none"}`,
+      `Tagline: ${k.tagline || "none"}`,
+      `Voice: ${k.voice || "none"}`,
+      `Selling points: ${k.sellingPoints.join("; ") || "none"}`,
+      "Every ad, campaign, image and motion template uses it unless that call passes brand_kit: false."
+    ].join("\n");
+    brandKitSkill = {
+      name: "pixeldojo_brand_kit",
+      description: "The account's brand kit for Marketing Studio: logo, colors, fonts, voice, tagline and selling points. action import + url reads them from the brand's website (logo, palette and fonts from the page, the voice and claims from its words) and saves it; get shows it; update changes fields (colors as #RRGGBB, logo_url must be a PixelDojo upload). Free. Once set, every pixeldojo_ad, pixeldojo_campaign and pixeldojo_marketing call applies it automatically.",
+      inputZod: KitSchema,
+      inputJsonSchema: {
+        type: "object",
+        properties: {
+          action: { type: "string", enum: ["get", "import", "update"], description: "Default get." },
+          url: { type: "string", description: "import: the brand website, e.g. yourbrand.com." },
+          save: { type: "boolean", description: "import: false returns the kit without saving it. Default true." },
+          name: { type: "string", description: "Brand name." },
+          tagline: { type: "string", description: "Short brand tagline." },
+          voice: { type: "string", description: "How the brand talks, one or two sentences." },
+          colors: { type: "array", items: { type: "string" }, maxItems: 5, description: "#RRGGBB, lead color first." },
+          fonts: { type: "array", items: { type: "string" }, maxItems: 2, description: "Up to two brand font names." },
+          selling_points: { type: "array", items: { type: "string" }, maxItems: 5, description: "Short product claims, 2-7 words each." },
+          logo_url: { type: "string", format: "uri", description: "A logo on PixelDojo (upload it first); PNG with transparency is best." }
+        }
+      },
+      allowedModels: [],
+      defaultModel: "",
+      run: kitRun
+    };
+    ACTIONS = ["templates", "image", "motion", "end_card", "status"];
+    MOTION = ["kinetic-headline", "feature-callouts", "count-up", "price-drop", "logo-sting"];
+    MarketingSchema = z.object({
+      action: z.enum(ACTIONS),
+      kind: z.enum(["image", "motion", "video"]).optional(),
+      category: z.string().max(40).optional(),
+      template: z.string().max(60).optional(),
+      product_url: z.string().url().optional(),
+      product_name: z.string().max(200).optional(),
+      product_description: z.string().max(2e3).optional(),
+      product_image_urls: z.array(z.string().url()).max(5).optional(),
+      product_image_paths: z.array(z.string()).max(5).optional(),
+      character_image_urls: z.array(z.string().url()).max(2).optional(),
+      headline: z.string().max(80).optional(),
+      points: z.array(z.string().max(70)).max(3).optional(),
+      cta: z.string().max(30).optional(),
+      direction: z.string().max(1500).optional(),
+      aspect_ratio: z.enum(["1:1", "4:5", "9:16", "16:9"]).optional(),
+      engine: z.enum(["nano-banana-pro", "nano-banana-2-1", "ideogram-4-5"]).optional(),
+      count: z.number().int().min(1).max(8).optional(),
+      reference_ad_url: z.string().url().optional(),
+      stat: z.string().max(16).optional(),
+      stat_label: z.string().max(40).optional(),
+      price_was: z.string().max(16).optional(),
+      price_now: z.string().max(16).optional(),
+      video_url: z.string().url().optional(),
+      motion_id: z.string().max(80).optional(),
+      brand_name: z.string().max(60).optional(),
+      colors: z.array(z.string()).max(5).optional(),
+      brand_kit: z.boolean().optional()
+    });
+    props = {
+      action: {
+        type: "string",
+        enum: ACTIONS,
+        description: "templates = free list (filter by kind, category). image = image template on a product. motion = code-rendered motion graphic. end_card = brand end card after a finished ad (video_url). status = check a motion render (motion_id)."
+      },
+      kind: { type: "string", enum: ["image", "motion", "video"], description: "templates: filter." },
+      category: { type: "string", description: "templates: product-shot, motion, ugc, tiktok, ads, posters or marketplace." },
+      template: {
+        type: "string",
+        description: `image: an image template id from templates (e.g. stacked-shout, pure-white, ice-float). motion: ${MOTION.join(", ")}.`
+      },
+      product_url: { type: "string", format: "uri", description: "image: product page; name, description and photos are read from it." },
+      product_name: { type: "string", description: "Product name when there is no product_url (with product_image_urls)." },
+      product_description: { type: "string", description: "Short product description when there is no product_url." },
+      product_image_urls: { type: "array", items: { type: "string", format: "uri" }, maxItems: 5, description: "Product photos. motion uses the first, cut out automatically." },
+      product_image_paths: { type: "array", items: { type: "string" }, maxItems: 5, description: "Local product photos instead of URLs; uploaded first." },
+      character_image_urls: { type: "array", items: { type: "string", format: "uri" }, maxItems: 2, description: "image: your own character (e.g. from pixeldojo_library source characters) for templates with a person." },
+      headline: { type: "string", description: "Exact words on the ad. Blank uses the brand kit tagline." },
+      points: { type: "array", items: { type: "string" }, maxItems: 3, description: "Selling points on the ad. Blank uses the brand kit." },
+      cta: { type: "string", description: 'Button text. Default "Shop now".' },
+      direction: { type: "string", description: "image: extra art direction added to the template." },
+      aspect_ratio: { type: "string", enum: ["1:1", "4:5", "9:16", "16:9"], description: "Default: the template's own (motion 9:16; 4:5 renders 9:16 there)." },
+      engine: { type: "string", enum: ["nano-banana-pro", "nano-banana-2-1", "ideogram-4-5"], description: "image: default nano-banana-pro (4.5 credits); nano-banana-2-1 is 1.5; ideogram-4-5 2 for poster type." },
+      count: { type: "integer", minimum: 1, maximum: 8, description: "image: how many (each charged)." },
+      reference_ad_url: { type: "string", format: "uri", description: "image ad multiplier: an image ad to rebuild with this product and your words. For a video ad use pixeldojo_ad reference_video_url." },
+      stat: { type: "string", description: 'count-up: the number, e.g. "10,000+", "4.9", "98%".' },
+      stat_label: { type: "string", description: "count-up: what it counts." },
+      price_was: { type: "string", description: 'price-drop: old price, e.g. "$140".' },
+      price_now: { type: "string", description: 'price-drop: new price, e.g. "$98".' },
+      video_url: { type: "string", format: "uri", description: "end_card: the finished ad (a PixelDojo result)." },
+      motion_id: { type: "string", description: "status: the id a motion or end_card call returned." },
+      brand_name: { type: "string", description: "motion: the brand shown when there is no logo. Default: the brand kit." },
+      colors: { type: "array", items: { type: "string" }, maxItems: 5, description: "motion: #RRGGBB, lead color first. Default: the brand kit." },
+      brand_kit: { type: "boolean", description: "false skips the brand kit for this call." }
+    };
+    marketingSkill = {
+      name: "pixeldojo_marketing",
+      description: "Marketing Studio templates beyond video ads. templates lists them free with real example outputs. image applies an image template to a product: static ads, product shots, posters, marketplace listings (pure white for Amazon/Shopify), UGC photos, headline spelled exactly, 1-8 at a time at the engine price; with reference_ad_url it rebuilds an existing ad with this product (ad multiplier). motion renders code-built motion graphics with exact words, brand colors and logo: kinetic-headline, feature-callouts, count-up, price-drop, logo-sting (2 credits each). end_card adds the brand logo, tagline and button after a finished video ad (1 credit per 30 s). The brand kit (pixeldojo_brand_kit) fills colors, logo, headline and selling points unless brand_kit: false.",
+      inputZod: MarketingSchema,
+      inputJsonSchema: { type: "object", required: ["action"], properties: props },
+      allowedModels: [],
+      defaultModel: "",
+      run: marketingRun
+    };
+  }
+});
+async function pollToResult(jobId, ctx, successText) {
+  const result = await pollJobUntilDoneOrHandoff(jobId, (id) => ctx.client.getJob(id), ctx.buildStatusUrl, {
+    now: ctx.pollOverrides?.now,
+    sleep: ctx.pollOverrides?.sleep
+  });
+  return pollResultToSkillResult(result, (urls) => urls.length === 0 ? `Job ${jobId} completed but returned no assets.` : successText(urls));
+}
+async function buildRun(input, ctx) {
+  const doFetch = ctx.fetch ?? fetch;
+  if (input.action === "traits") {
+    const res2 = await doFetch(`${ctx.baseUrl}/api/v1/characters/build`, { headers: headers3(ctx, "pixeldojo_build_character") });
+    const data2 = await res2.json().catch(() => ({}));
+    if (!res2.ok || !data2.traits) return { kind: "text", text: `Could not list traits: ${data2.error ?? `HTTP ${res2.status}`}` };
+    return {
+      kind: "text",
+      text: [
+        `Build a character: pass picks as {"trait id": "option id"} (an array for traits you can pick several of), or randomize: true to fill the rest. ${data2.takes ?? 4} takes cost ${data2.credits ?? "?"} credits. Free to list.`,
+        ...data2.traits.map(
+          (t) => `${t.id} (${t.label}${t.pick_up_to ? `, pick up to ${t.pick_up_to}` : ""}${t.people_only ? ", people only" : ""}): ${t.options.map((o) => o.id).join(", ")}`
+        )
+      ].join("\n")
+    };
+  }
+  const res = await doFetch(`${ctx.baseUrl}/api/v1/characters/build`, {
+    method: "POST",
+    headers: headers3(ctx, "pixeldojo_build_character"),
+    body: JSON.stringify({
+      ...input.picks ? { picks: input.picks } : {},
+      ...input.randomize ? { randomize: true } : {},
+      ...input.details ? { details: input.details } : {},
+      ...input.takes ? { takes: input.takes } : {}
+    })
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok || !data.jobId) {
+    const err = typeof data.error === "string" ? data.error : data.error?.message;
+    return { kind: "text", text: `Character not built (nothing charged): ${err ?? `HTTP ${res.status}`}` };
+  }
+  return pollToResult(
+    data.jobId,
+    ctx,
+    (urls) => [
+      `${urls.length} take${urls.length === 1 ? "" : "s"} of ${data.summary ?? "the character"} (${data.creditCost ?? "?"} credits):`,
+      ...urls.map((u, i) => `${i + 1}. ${u}`),
+      `Show them to the user. To keep one, call pixeldojo_save_character with a name, image_urls: [that take] and description: "${data.summary ?? ""}" within the hour (outputs expire). It then works as @Name in any prompt and can perform with pixeldojo_perform.`
+    ].join("\n")
+  );
+}
+async function performRun(input, ctx) {
+  const doFetch = ctx.fetch ?? fetch;
+  if (input.action === "list") {
+    const res2 = await doFetch(`${ctx.baseUrl}/api/v1/characters/perform`, { headers: headers3(ctx, "pixeldojo_perform") });
+    const data2 = await res2.json().catch(() => ({}));
+    if (!res2.ok || !data2.presets) return { kind: "text", text: `Could not list presets: ${data2.error ?? `HTTP ${res2.status}`}` };
+    return {
+      kind: "text",
+      text: [
+        'Perform presets (a 5 s video of a saved character doing it). Run one with action "run", character and preset:',
+        ...data2.presets.map((p) => `- ${p.slug} (${p.group}, ${p.credits} credits): ${p.title}. ${p.tagline}`)
+      ].join("\n")
+    };
+  }
+  if (!input.character || !input.preset) {
+    return { kind: "text", text: `Pass character (a saved character's name or @Name) and preset (from action "list").` };
+  }
+  const res = await doFetch(`${ctx.baseUrl}/api/v1/characters/perform`, {
+    method: "POST",
+    headers: headers3(ctx, "pixeldojo_perform"),
+    body: JSON.stringify({ character: input.character, preset: input.preset })
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok || !data.jobId) {
+    const err = typeof data.error === "string" ? data.error : data.error?.message;
+    return { kind: "text", text: `Not started (nothing charged): ${err ?? `HTTP ${res.status}`}` };
+  }
+  return pollToResult(data.jobId, ctx, (urls) => `${input.character} performed ${input.preset} (${data.creditCost ?? "?"} credits). Asset: ${urls[0]}`);
+}
+var headers3, BuildSchema, buildCharacterSkill, PerformSchema, performSkill;
+var init_character_builder = __esm({
+  "src/skills/character-builder.ts"() {
+    init_poll();
+    init_types();
+    headers3 = (ctx, skill) => ({
+      Authorization: `Bearer ${ctx.apiKey}`,
+      "Content-Type": "application/json",
+      "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
+      "x-pixeldojo-skill": skill
+    });
+    BuildSchema = z.object({
+      action: z.enum(["traits", "build"]),
+      picks: z.record(z.union([z.string(), z.array(z.string())])).optional(),
+      randomize: z.boolean().optional(),
+      details: z.string().max(200).optional(),
+      takes: z.number().int().min(1).max(4).optional()
+    });
+    buildCharacterSkill = {
+      name: "pixeldojo_build_character",
+      description: `Build an original AI character or influencer from traits instead of photos, like Character Studio's builder: type (realistic, bold or extreme caricature, anime, 3D, cat, dog, fox, frog, insect, robot...), gender, age (adults only), body, height, wild proportions (egg body, long limbs, tiny waist), head shape (gigachad, mega jaw), hair, face features, style and accessories. action "traits" (free) lists every trait and option id; action "build" renders up to 4 takes from picks (and/or randomize). Keep one with pixeldojo_save_character.`,
+      inputZod: BuildSchema,
+      inputJsonSchema: {
+        type: "object",
+        required: ["action"],
+        properties: {
+          action: { type: "string", enum: ["traits", "build"], description: "traits = list trait and option ids (free). build = render the takes (paid)." },
+          picks: {
+            type: "object",
+            additionalProperties: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+            description: 'build: {"trait id": "option id"}, e.g. {"type": "frog", "hair": "mullet", "hairColor": "blonde", "distinctive": ["gold-grill"], "style": "retro"}. Ids from action "traits"; labels work too.'
+          },
+          randomize: { type: "boolean", description: "build: fill every trait not in picks at random." },
+          details: { type: "string", description: 'build: up to 200 characters of extra look, e.g. "freckles, gold hoops, a vintage denim jacket".' },
+          takes: { type: "integer", minimum: 1, maximum: 4, description: "build: how many takes (default 4)." }
+        }
+      },
+      allowedModels: [],
+      defaultModel: "",
+      run: buildRun
+    };
+    PerformSchema = z.object({
+      action: z.enum(["list", "run"]),
+      character: z.string().max(100).optional(),
+      preset: z.string().max(80).optional()
+    });
+    performSkill = {
+      name: "pixeldojo_perform",
+      description: 'Make a saved Character Studio character perform: a dance, a trend or a star moment (AI Dance, Sassy Dance, Shoulder Shimmy, Hair Flip, Catwalk, Peace Wink, Red Carpet, Award Win...) as a share-ready 5 s video. action "list" (free) gives the presets and prices; action "run" takes character (name or @Name) and preset. Usually handed off; poll with pixeldojo_status.',
+      inputZod: PerformSchema,
+      inputJsonSchema: {
+        type: "object",
+        required: ["action"],
+        properties: {
+          action: { type: "string", enum: ["list", "run"], description: "list = presets with prices (free). run = make the video (paid)." },
+          character: { type: "string", description: "run: the saved character's name or @Name (pixeldojo_library source=characters lists them)." },
+          preset: { type: "string", description: 'run: a preset slug from action "list", e.g. "ai-dance", "shoulder-shimmy", "red-carpet".' }
+        }
+      },
+      allowedModels: [],
+      defaultModel: "",
+      run: performRun
+    };
+  }
+});
 function substitutePlaceholders(args, inputs, prevUrl) {
   const missing = [];
   const fill = (value) => {
@@ -3972,10 +4932,13 @@ __export(skills_exports, {
   TOOL_ANNOTATIONS: () => TOOL_ANNOTATIONS,
   adSkill: () => adSkill,
   audioSkill: () => audioSkill,
+  brandKitSkill: () => brandKitSkill,
+  buildCharacterSkill: () => buildCharacterSkill,
   campaignSkill: () => campaignSkill,
   campaignStatusSkill: () => campaignStatusSkill,
   captionSkill: () => captionSkill,
   characterSkill: () => characterSkill,
+  dramaSkill: () => dramaSkill,
   editSkill: () => editSkill,
   effectRunSkill: () => effectRunSkill,
   effectsListSkill: () => effectsListSkill,
@@ -3985,9 +4948,13 @@ __export(skills_exports, {
   findSkill: () => findSkill,
   fromUrlSkill: () => fromUrlSkill,
   generateSkill: () => generateSkill,
+  kataSkill: () => kataSkill,
   librarySkill: () => librarySkill,
   listWorkflowsSkill: () => listWorkflowsSkill,
+  marketingSkill: () => marketingSkill,
+  musicVideoSkill: () => musicVideoSkill,
   overlaySkill: () => overlaySkill,
+  performSkill: () => performSkill,
   runWorkflowSkill: () => runWorkflowSkill,
   saveCharacterSkill: () => saveCharacterSkill,
   saveSkill: () => saveSkill,
@@ -4032,6 +4999,9 @@ var init_skills = __esm({
     init_film();
     init_video();
     init_episode();
+    init_drama();
+    init_music_video();
+    init_kata();
     init_ad();
     init_campaign();
     init_campaign_status();
@@ -4041,6 +5011,8 @@ var init_skills = __esm({
     init_save();
     init_save_character();
     init_effects();
+    init_marketing();
+    init_character_builder();
     init_workflows();
     ALL_SKILLS = [
       generateSkill,
@@ -4056,6 +5028,8 @@ var init_skills = __esm({
       librarySkill,
       saveSkill,
       saveCharacterSkill,
+      buildCharacterSkill,
+      performSkill,
       saveWorkflowSkill,
       runWorkflowSkill,
       listWorkflowsSkill,
@@ -4063,23 +5037,28 @@ var init_skills = __esm({
       fromUrlSkill,
       uploadSkill,
       adSkill,
+      brandKitSkill,
+      marketingSkill,
       campaignSkill,
       campaignStatusSkill,
       filmSkill,
       videoSkill,
-      episodeSkill
+      episodeSkill,
+      dramaSkill,
+      musicVideoSkill,
+      kataSkill
     ];
     isLocalPathField = (key) => /_paths?$/.test(key);
     HOSTED_SKILLS = ALL_SKILLS.filter(
       (s) => s.name !== uploadSkill.name
     ).map((s) => {
-      const props = s.inputJsonSchema.properties ?? {};
+      const props2 = s.inputJsonSchema.properties ?? {};
       return {
         ...s,
         description: s.hostedDescription ?? s.description,
         inputJsonSchema: {
           ...s.inputJsonSchema,
-          properties: Object.fromEntries(Object.entries(props).filter(([k]) => !isLocalPathField(k)))
+          properties: Object.fromEntries(Object.entries(props2).filter(([k]) => !isLocalPathField(k)))
         }
       };
     });
@@ -4098,9 +5077,14 @@ var init_skills = __esm({
       pixeldojo_effect: render("Run one-click effect"),
       pixeldojo_video: render("Change, animate or extend video"),
       pixeldojo_ad: render("Make video ad"),
+      pixeldojo_brand_kit: render("Brand kit from website"),
+      pixeldojo_marketing: render("Image ads, motion graphics and templates"),
       pixeldojo_campaign: render("Make product launch campaign"),
       pixeldojo_film: render("Make short film"),
       pixeldojo_episode: render("Make faceless video"),
+      pixeldojo_drama: render("Make micro-drama, short film or trailer"),
+      pixeldojo_music_video: render("Make music video for a song"),
+      pixeldojo_kata: render("Recreate an edit with your cast"),
       pixeldojo_run_workflow: render("Run saved workflow"),
       pixeldojo_upload: render("Upload local file"),
       pixeldojo_save_workflow: { ...render("Save workflow"), destructiveHint: true },
@@ -4109,6 +5093,8 @@ var init_skills = __esm({
       pixeldojo_library: read("Search media library"),
       pixeldojo_save: render("Save to My Media"),
       pixeldojo_save_character: render("Save character or element"),
+      pixeldojo_build_character: render("Build AI character from traits"),
+      pixeldojo_perform: render("Make character dance or do a trend"),
       pixeldojo_list_workflows: read("List saved workflows"),
       pixeldojo_from_url: { ...read("Read product page"), openWorldHint: true }
     };
@@ -4118,10 +5104,10 @@ function makeAttributedClient(options) {
   const { mcpVersion, skillName, baseFetch, ...sdkOptions } = options;
   const real = baseFetch ?? globalThis.fetch.bind(globalThis);
   const wrappedFetch = (input, init) => {
-    const headers2 = new Headers(init?.headers);
-    headers2.set("x-pixeldojo-source", `mcp/${mcpVersion}`);
-    if (skillName) headers2.set("x-pixeldojo-skill", skillName);
-    return real(input, { ...init, headers: headers2 });
+    const headers4 = new Headers(init?.headers);
+    headers4.set("x-pixeldojo-source", `mcp/${mcpVersion}`);
+    if (skillName) headers4.set("x-pixeldojo-skill", skillName);
+    return real(input, { ...init, headers: headers4 });
   };
   return new PixelDojoClient({
     ...sdkOptions,
@@ -4165,7 +5151,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.26.0" ;
+var PACKAGE_VERSION = "0.31.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) {