@pixeldojo/mcp 0.31.0 → 0.36.0

package/README.md

@@ -40,13 +40,13 @@ Add to your editor's MCP config (e.g. `~/.config/claude-code/mcp.json`):
 }
 ```
 
-Restart your agent. You'll see 23 new tools.
+Restart your agent. You'll see 32 new tools.
 
 ## Named skills
 
 | Skill | What it does |
 |---|---|
-| `pixeldojo_generate` | Any prompt → image or video. Defaults to seedream-5 (stills); pass any apiId, e.g. seedance-2-5 for video. The recommended models are the ones PixelDojo's studios use. |
+| `pixeldojo_generate` | Any prompt → image or video. Defaults to seedream-5-5 (stills); pass any apiId, e.g. seedance-2-5-flash for video (seedance-2-5 for 1080p). The recommended models are the ones PixelDojo's studios use. |
 | `pixeldojo_edit` | Change an existing image with a text instruction (multi-image capable). |
 | `pixeldojo_character` | Consistent characters across shots. |
 | `pixeldojo_storyboard` | One video shot from a scene brief (use `pixeldojo_film` for multi-shot). |
@@ -54,6 +54,13 @@ Restart your agent. You'll see 23 new tools.
 | `pixeldojo_video` | Video Studio verbs on an existing clip: `change` (restyle/edit), `move` (motion transfer or character swap), `extend`. Uses each verb's studio engine. |
 | `pixeldojo_episode` | Faceless Studio: a narrated faceless video episode from a topic (script, scenes, voice, music, export). |
 | `pixeldojo_ad` | Marketing Studio: a product video ad from a URL or product images. |
+| `pixeldojo_drama` | A micro-drama episode, short film or trailer from an idea (free plan and quote first, then produce). |
+| `pixeldojo_music_video` | Up to 60 s of your song as a music video with the cast lip-syncing to it. |
+| `pixeldojo_kata` | Recreate a reference edit with your own cast and products: same cuts, transitions and caption style. |
+| `pixeldojo_brand_kit` | Your Marketing Studio brand kit: import from a website, get, update. Free. |
+| `pixeldojo_marketing` | Marketing Studio templates: image ads, motion graphics and the brand end card. |
+| `pixeldojo_save` | Keep a result in My Media permanently after a safety check (outputs are deleted after one hour). |
+| `pixeldojo_save_character` | Save a character, product or element from 3 to 5 photos so `@Name` works in any prompt. |
 | `pixeldojo_upscale` | Enhance any image (up to 16×) or video (up to 4K). |
 | `pixeldojo_overlay` | Ad text layouts on a video: hook title, lower-third callout, review card, progress bar, countdown timer, price tag, offer badge and a branded end card with logo. Exact text, your brand color, clear of the platform UI. |
 | `pixeldojo_caption` | Animated word-by-word captions on a video with speech, placed clear of the TikTok/Reels/Shorts buttons. Pop, Highlighter or Clean, any highlight color. |

package/dist/cli.cjs

@@ -248,6 +248,14 @@ async function snapAspectRatio(apiId, requested, client, opts = {}) {
   if (!field.enum || field.enum.length === 0) return requested;
   return nearestAspectFromEnum(requested, field.enum);
 }
+async function snapImageSizePreset(apiId, requested, client) {
+  if (!requested) return void 0;
+  const props2 = await getFieldConstraints(apiId, client);
+  const values = props2?.image_size?.enum;
+  if (!values || props2?.aspect_ratio) return void 0;
+  const key = requested.trim().replace(":", "_");
+  return values.find((v) => String(v).endsWith(`_${key}`));
+}
 async function resolveMediaSlot(apiId, kind, client) {
   const info = await getModelInfo(apiId, client);
   if (info === null) return void 0;
@@ -506,20 +514,24 @@ async function run(input, ctx) {
     }
   }
   let refField;
+  let imageSizePreset;
   let audioSlot;
   if (!VIDEO_INPUT_MODELS.has(apiId)) {
-    const [aspect_ratio, duration, resolution, ref, audio] = await Promise.all([
+    const [aspect_ratio, imageSize, duration, resolution, ref, audio] = await Promise.all([
       snapAspectRatio(apiId, resolved.aspect_ratio, ctx.client),
+      snapImageSizePreset(apiId, resolved.aspect_ratio, ctx.client),
       snapDuration(apiId, resolved.duration, ctx.client),
       snapResolution(apiId, resolved.resolution, ctx.client),
       src.url ? resolveMediaSlot(apiId, src.isClip ? "video" : "image", ctx.client) : Promise.resolve(void 0),
       src.audioUrl ? resolveMediaSlot(apiId, "audio", ctx.client) : Promise.resolve(void 0)
     ]);
     resolved = { ...resolved, aspect_ratio, duration, resolution };
+    imageSizePreset = imageSize;
     refField = ref === void 0 && src.url ? fallbackSlot(apiId, src.isClip ? "video" : "image") : ref;
     audioSlot = audio === void 0 && src.audioUrl ? fallbackSlot(apiId, "audio") : audio;
   }
   const body = buildPayload(apiId, resolved, src, refField, audioSlot);
+  if (imageSizePreset) body.image_size = imageSizePreset;
   const paramsNote = applyParams(body, input.params, input.model, apiId);
   const note = [routeNote, paramsNote].filter(Boolean).join(" ");
   const submitted = await ctx.client.run(apiId, body);
@@ -551,7 +563,7 @@ var init_generate = __esm({
     InputSchema = zod.z.object({
       prompt: zod.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: zod.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), "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.`
+        `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5-5" for images (the default), "seedance-2-5-flash" for video (prompt only or a starting image, 480p or 720p), "seedance-2-5" for 1080p video, "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 prompt alone, a photo or up to 9 reference images, "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-5, which makes still images only; name a video model to get a video.`
       ),
       preset: zod.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."
@@ -576,7 +588,7 @@ var init_generate = __esm({
         "Multiple absolute local file paths. Each is uploaded to PixelDojo (24h temp storage) and used as a reference, same rules as image_urls."
       )
     });
-    DEFAULT_MODEL = "seedream-5";
+    DEFAULT_MODEL = "seedream-5-5";
     VIDEO_REFERENCE_MODEL = "seedance-2-reference";
     VIDEO_REFERENCE_SLOTS = {
       image: { name: "reference_images", isArray: true },
@@ -590,7 +602,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), "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.`
+          description: `Model apiId. Recommended (the models the PixelDojo studios use): "seedream-5-5" for images (the default), "seedance-2-5-flash" for video (prompt only or a starting image, 480p or 720p), "seedance-2-5" for 1080p video, "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 prompt alone, a photo or up to 9 reference images, "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-5, which makes still images only; name a video model to get a video.`
         },
         preset: {
           type: "string",
@@ -638,8 +650,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; 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.",
+      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-5, which makes still images only. For a video, name seedance-2-5-flash, which works from a prompt alone or a starting image at 480p or 720p; seedance-2-5 for 1080p; kling-4-0 for a multi-shot scene up to 30 s with dialogue; minimax-h3-turbo for the lowest price, from a prompt alone, a photo or reference images. 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-5, which makes still images only. For a video, name seedance-2-5-flash, which works from a prompt alone or a starting image at 480p or 720p; seedance-2-5 for 1080p; kling-4-0 for a multi-shot scene up to 30 s with dialogue; minimax-h3-turbo for the lowest price, from a prompt alone, a photo or reference images. 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,
@@ -919,25 +931,31 @@ var init_character = __esm({
     init_schema_snap();
     init_params();
     ALLOWED = [
+      "seedream-5-5",
       "seedream-5",
       "seedream-4",
       "seedream-5-flash",
       "google-nano-banana",
       "wan-2.7-image-edit",
       "qwen-3-pro",
-      "qwen-image-2.0-pro"
+      "qwen-image-2.0-pro",
+      "p-h3-image",
+      "minimax-h3-image"
     ];
-    DEFAULT_MODEL3 = "seedream-5";
+    DEFAULT_MODEL3 = "seedream-5-5";
     MAX_REFERENCES = 9;
     REQUIRES_REFERENCE = /* @__PURE__ */ new Set(["wan-2.7-image-edit"]);
     FALLBACK_REF_KEY = {
       "seedream-5": "image_urls",
+      "seedream-5-5": "image_urls",
       "seedream-4": "image_urls",
       "seedream-5-flash": "image_urls",
       "google-nano-banana": "image_input",
       "wan-2.7-image-edit": "image_urls",
       "qwen-3-pro": "image",
-      "qwen-image-2.0-pro": "reference_images"
+      "qwen-image-2.0-pro": "reference_images",
+      "p-h3-image": "reference_images",
+      "minimax-h3-image": "reference_images"
     };
     InputSchema3 = zod.z.object({
       prompt: zod.z.string().min(1).max(8e3),
@@ -974,7 +992,7 @@ var init_character = __esm({
         },
         aspect_ratio: {
           type: "string",
-          description: 'e.g. "1:1", "16:9", "9:16". Snapped to the nearest ratio the model supports, and dropped for models with no aspect_ratio field (including the default seedream-5, which sizes by image_size: set that in params with an explicit model).'
+          description: 'e.g. "1:1", "16:9", "9:16". Snapped to the nearest ratio the model supports, and dropped for models with no aspect_ratio field (including the default seedream-5-5, which sizes by image_size: set that in params with an explicit model).'
         },
         params: PARAMS_JSON_SCHEMA
       },
@@ -982,7 +1000,7 @@ var init_character = __esm({
     };
     characterSkill = {
       name: "pixeldojo_character",
-      description: "Generate or edit consistent characters across shots. Pass reference_image_urls (up to 9) to lock identity \u2014 send every photo of the person you have, since more angles hold the face far better than one. Defaults to seedream-5.",
+      description: "Generate or edit consistent characters across shots. Pass reference_image_urls (up to 9) to lock identity \u2014 send every photo of the person you have, since more angles hold the face far better than one. Defaults to seedream-5-5.",
       inputZod: InputSchema3,
       inputJsonSchema: InputJsonSchema3,
       allowedModels: [...ALLOWED],
@@ -1681,7 +1699,7 @@ async function filmApi(ctx, method, path, body) {
       Authorization: `Bearer ${ctx.apiKey}`,
       "Content-Type": "application/json",
       "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
-      "x-pixeldojo-skill": "film"
+      "x-pixeldojo-skill": "pixeldojo_film"
     },
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
@@ -2010,7 +2028,7 @@ It is saved in the Library folder "Film: ${film.title}".`,
   }
   const startExport = async () => {
     const r = await filmApi(ctx, "POST", `/api/films/${filmId}/export`, {});
-    return r.status === 200 || r.status === 409 ? null : r.data.error ?? `HTTP ${r.status}`;
+    return r.status === 200 || r.status === 409 && r.data.code === "export-running" ? null : r.data.error ?? `HTTP ${r.status}`;
   };
   if (film.exportError && all.length > 0 && all.every((sh) => sh.status === "clip-ready")) {
     const again = await startExport();
@@ -2440,8 +2458,6 @@ function buildVideoPayload(verb, apiId, i) {
             ...vd !== void 0 ? { source_duration_seconds: vd } : {}
           }
         };
-      case "flux-video-edit":
-        return { body: { prompt, video: i.videoUrl, video_duration: Math.ceil(vd) }, note: droppedImages };
       case "xai-video-edit":
         return { body: { prompt, video_url: i.videoUrl, video_duration: vd }, note: droppedImages };
       case "happyhorse-1.0-video-edit":
@@ -2472,6 +2488,17 @@ function buildVideoPayload(verb, apiId, i) {
     }
   }
   if (verb === "move") {
+    if (apiId === "p-video-2-pro-replace") {
+      return {
+        body: {
+          prompt: "",
+          video: i.videoUrl,
+          images: i.images.slice(0, 2),
+          video_duration: vd,
+          ...prompt ? { instruction_prompt: prompt } : {}
+        }
+      };
+    }
     if (apiId === "wan-video-character-swap") {
       return { body: { prompt: "", image_url: i.images[0], video_url: i.videoUrl, video_duration: vd } };
     }
@@ -2593,8 +2620,6 @@ var init_video = __esm({
     VIDEO_STUDIO_ENGINES = {
       change: [
         "seedance-2-5-video-edit",
-        "flux-video-edit",
-        "kling-video-edit",
         "kling-4-0",
         "minimax-h3-turbo",
         "wan-video-edit",
@@ -2602,24 +2627,24 @@ var init_video = __esm({
         "happyhorse-1.0-video-edit",
         "xai-video-edit"
       ],
-      move: ["kling-motion-control", "wan-video-character-swap"],
+      move: ["p-video-2-pro-replace", "kling-motion-control", "wan-video-character-swap"],
       extend: ["seedance-2-5-video-edit", "wan-2.7-i2v", "grok-video-extend"]
     };
     VERBS = ["change", "move", "extend"];
     BACKWARD_ENGINES = /* @__PURE__ */ new Set(["seedance-2-5-video-edit"]);
     clamp = (n, min, max) => Math.min(max, Math.max(min, Math.round(n)));
     NEEDS_VIDEO_DURATION = /* @__PURE__ */ new Set([
-      "flux-video-edit",
-      "kling-video-edit",
       "wan-video-edit",
       "seedance-video-edit",
       "happyhorse-1.0-video-edit",
       "xai-video-edit",
       "kling-motion-control",
       "wan-video-character-swap",
-      "kling-4-0"
+      "kling-4-0",
+      // Its schema defaults the length, but the price is per second: a missing length would under-charge.
+      "p-video-2-pro-replace"
     ]);
-    NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["flux-video-edit", "xai-video-edit", "minimax-h3-turbo"]);
+    NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["xai-video-edit", "minimax-h3-turbo"]);
     InputSchema11 = zod.z.object({
       verb: zod.z.enum(VERBS),
       prompt: zod.z.string().max(8e3).optional(),
@@ -2645,7 +2670,7 @@ var init_video = __esm({
         },
         prompt: {
           type: "string",
-          description: "What to change, how the character should move, or what happens next. Required for change and extend. Optional for move (wan-video-character-swap ignores it). @Name uses a character or element the user saved in Character Studio (photos attached automatically)."
+          description: "What to change, how the character should move, or what happens next. Required for change and extend. Optional for move (p-video-2-pro-replace reads it as who becomes whom; wan-video-character-swap ignores it). @Name uses a character or element the user saved in Character Studio (photos attached automatically)."
         },
         video_url: {
           type: "string",
@@ -2711,7 +2736,7 @@ async function episodeApi(ctx, method, path, body) {
       Authorization: `Bearer ${ctx.apiKey}`,
       "Content-Type": "application/json",
       "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
-      "x-pixeldojo-skill": "episode"
+      "x-pixeldojo-skill": "pixeldojo_episode"
     },
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
@@ -2952,7 +2977,7 @@ async function dramaApi(ctx, method, path, body) {
       Authorization: `Bearer ${ctx.apiKey}`,
       "Content-Type": "application/json",
       "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
-      "x-pixeldojo-skill": "drama"
+      "x-pixeldojo-skill": "pixeldojo_drama"
     },
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
@@ -2966,9 +2991,10 @@ function describeDrama(v, o = DRAMA_OPTS) {
   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" && v.error?.startsWith("Prohibited content")) return { kind: "text", text: `${v.error} Tell the user this idea is prohibited content; do not rewrite it to get around the refusal.` };
   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).`;
+    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, scenes of up to 30 seconds with ${v.dialogue === false ? "their own sound and no dialogue" : "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")
@@ -3051,9 +3077,12 @@ var init_drama = __esm({
       end_text: zod.z.string().max(60).optional(),
       brand_color: zod.z.string().regex(/^#[0-9a-fA-F]{6}$/).optional(),
       logo_url: zod.z.string().url().optional(),
-      cast: zod.z.array(zod.z.object({ name: zod.z.string().min(1).max(40), image_url: zod.z.string().url() })).max(5).optional(),
+      cast: zod.z.array(zod.z.object({ name: zod.z.string().min(1).max(40), image_url: zod.z.string().url(), outfit_image_url: zod.z.string().url().optional() })).max(5).optional(),
+      length_sec: zod.z.number().int().min(24).max(180).multipleOf(6).optional(),
       scenes: zod.z.number().int().min(1).max(15).optional(),
       score: zod.z.boolean().optional(),
+      dialogue: zod.z.boolean().optional(),
+      engine: zod.z.enum(["seedance-2-5", "seedance-2-5-flash", "wan-3-0-video", "kling-4-0"]).optional(),
       drama_id: zod.z.string().max(60).optional(),
       beats: zod.z.array(zod.z.number().int().min(1).max(15)).min(1).max(15).optional(),
       notes: zod.z.array(zod.z.string().max(300)).max(15).optional()
@@ -3064,7 +3093,7 @@ var init_drama = __esm({
         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."
+          description: "create (default, free): writes the plan (30 seconds unless length_sec 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." },
@@ -3072,7 +3101,7 @@ var init_drama = __esm({
         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)."
+          description: "Create: micro-drama (default: episode one with a hook and a cliffhanger), short-film (a complete 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: {
@@ -3092,14 +3121,18 @@ var init_drama = __esm({
             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." }
+              image_url: { type: "string", description: `A clear front-facing portrait on the PixelDojo CDN (a saved character's first "for video" picture when it has one).` },
+              outfit_image_url: { type: "string", description: `Optional: the saved character's outfit picture (the second "for video" picture from pixeldojo_library). The scenes then keep their clothes closer.` }
             },
             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."
+          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; pass its "for video" face and outfit pictures when it lists them). 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)." },
+        length_sec: { type: "integer", minimum: 24, maximum: 180, multipleOf: 6, description: "Create (optional): the film's length in seconds, 24 to 180 in steps of 6. Default 30. If the user has not said how long, ask (30 seconds, 1, 2 or 3 minutes; the price grows with the length) or leave it out for 30 seconds. The writer splits the length into scenes of up to 30 s, one per place and cast." },
+        scenes: { type: "integer", minimum: 1, maximum: 15, description: "Create (optional, older): the length in 12-second units (5 = 60 s). Prefer length_sec." },
+        engine: { type: "string", enum: ["seedance-2-5", "seedance-2-5-flash", "wan-3-0-video", "kling-4-0"], description: "Create (optional): the video model every scene films on, from the cast pictures. seedance-2-5 (default), seedance-2-5-flash (the same model family, faster and about a third cheaper, 720p), wan-3-0-video (about a third of the price), kling-4-0. Pass it only when the user names one. Adult work always runs on wan-3-0-video." },
         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)." },
+        dialogue: { type: "boolean", description: "Create (optional): pass false for a film with no dialogue, where nobody speaks and the story is told in pictures, sound and the score. Use it when the user asks for no dialogue, a silent or wordless film, or visuals with music only; otherwise leave it out (characters speak)." },
         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." }
@@ -3115,10 +3148,10 @@ var init_drama = __esm({
     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).",
+      description: "Make a micro-drama episode (30 seconds by default, up to 3 minutes with length_sec; 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). Scenes of up to 30 seconds (one per place and cast), each filmed in one pass with several cuts, on Seedance 2.5, WAN 3 or Kling 4, the cast's faces kept from portraits and every line spoken and lip-synced (or no dialogue at all with dialogue: false), 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 190 credits for a regular 30 second film, about 380 for a minute; less on the wan-3-0-video engine and 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"],
+      allowedModels: ["seedance-2-5", "seedance-2-5-flash", "seedream-4"],
       defaultModel: "seedance-2-5",
       async run(input, ctx) {
         if (input.action === "create") {
@@ -3130,8 +3163,11 @@ var init_drama = __esm({
             ...input.mature ? { mature: true } : {},
             ...input.look ? { look: input.look } : {},
             ...input.story_type ? { story_type: input.story_type } : {},
+            ...input.length_sec ? { length_sec: input.length_sec } : {},
             ...input.scenes ? { scenes: input.scenes } : {},
+            ...input.engine ? { engine: input.engine } : {},
             ...input.score === false ? { score: false } : {},
+            ...input.dialogue === false ? { dialogue: 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]])
             ),
@@ -3159,7 +3195,7 @@ async function api(ctx, method, path, body) {
       Authorization: `Bearer ${ctx.apiKey}`,
       "Content-Type": "application/json",
       "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
-      "x-pixeldojo-skill": "music_video"
+      "x-pixeldojo-skill": "pixeldojo_music_video"
     },
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
@@ -3288,7 +3324,7 @@ async function kataApi(ctx, method, path, body) {
       Authorization: `Bearer ${ctx.apiKey}`,
       "Content-Type": "application/json",
       "x-pixeldojo-source": `mcp/${ctx.mcpVersion}`,
-      "x-pixeldojo-skill": "kata"
+      "x-pixeldojo-skill": "pixeldojo_kata"
     },
     ...body !== void 0 ? { body: JSON.stringify(body) } : {}
   });
@@ -3340,6 +3376,7 @@ var init_kata = __esm({
       photos: zod.z.array(zod.z.object({ url: zod.z.string().url(), note: zod.z.string().max(80).optional() })).max(4).optional(),
       instructions: zod.z.string().max(1500).optional(),
       look: zod.z.string().max(80).optional(),
+      engine: zod.z.enum(["seedance-2-5", "seedance-2-5-flash"]).optional(),
       kata_id: zod.z.string().max(60).optional()
     });
     InputJsonSchema15 = {
@@ -3372,6 +3409,7 @@ var init_kata = __esm({
         },
         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".' },
+        engine: { type: "string", enum: ["seedance-2-5", "seedance-2-5-flash"], description: "Create (optional): the video model the new clips film on. seedance-2-5 (default) or seedance-2-5-flash (faster, about a third cheaper). Pass it only when the user asks." },
         kata_id: { type: "string", description: "From create. Required for produce and status." }
       }
     };
@@ -3393,7 +3431,7 @@ var init_kata = __esm({
       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"],
+      allowedModels: ["seedance-2-5", "seedance-2-5-flash", "google-nano-banana", "kling-motion-control"],
       defaultModel: "seedance-2-5",
       async run(input, ctx) {
         if (input.action === "presets") {
@@ -3412,7 +3450,8 @@ var init_kata = __esm({
             ...input.cast?.length ? { cast: input.cast } : {},
             ...input.photos?.length ? { photos: input.photos } : {},
             ...input.instructions ? { instructions: input.instructions } : {},
-            ...input.look ? { look: input.look } : {}
+            ...input.look ? { look: input.look } : {},
+            ...input.engine ? { engine: input.engine } : {}
           });
           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);
@@ -3452,7 +3491,7 @@ async function run13(input, ctx) {
     aspect_ratio: input.aspect_ratio,
     duration: input.duration,
     reference_video_url: input.reference_video_url,
-    brand_kit: input.brand_kit
+    brand_kit: input.brand_kit === false ? false : input.brand_kit_id ?? input.brand_kit
   };
   const client = ctx.client;
   const submitted = await client.runAd(body);
@@ -3497,7 +3536,8 @@ var init_ad = __esm({
       aspect_ratio: zod.z.enum(["16:9", "4:3", "1:1", "3:4", "9:16", "21:9"]).optional(),
       duration: zod.z.number().int().min(4).max(15).optional(),
       reference_video_url: zod.z.string().url().optional(),
-      brand_kit: zod.z.boolean().optional()
+      brand_kit: zod.z.boolean().optional(),
+      brand_kit_id: zod.z.string().max(80).optional()
     }).refine(
       (v) => v.product_url || (v.product_image_urls?.length || v.product_image_paths?.length) && v.product_name,
       {
@@ -3591,7 +3631,11 @@ var init_ad = __esm({
         },
         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."
+          description: "The account's default brand kit (palette, voice, selling points; see pixeldojo_brand_kit) rides on every ad. false skips it."
+        },
+        brand_kit_id: {
+          type: "string",
+          description: "Use this saved brand kit instead of the default (ids listed by pixeldojo_brand_kit)."
         }
       }
       // "product_url OR product_name+images" is enforced by the server and the
@@ -3932,7 +3976,8 @@ async function run18(input, ctx) {
     }
     const lines2 = characters.map(
       (c) => `- ${c.mention} (${c.kind})${c.description ? `: ${c.description.slice(0, 100)}` : ""}
-  images: ${c.image_urls.slice(0, 4).join(" ")}`
+  images: ${c.image_urls.slice(0, 4).join(" ")}${c.video_pair && c.video_image_urls?.length === 2 ? `
+  for video (face, outfit; pass both to pixeldojo_drama cast as image_url + outfit_image_url): ${c.video_image_urls.join(" ")}` : ""}`
     );
     return {
       kind: "text",
@@ -4155,7 +4200,8 @@ async function effectRun(input, ctx) {
   });
   const data = await res.json().catch(() => ({}));
   if (!res.ok || !data.jobId) {
-    return { kind: "text", text: `Effect not started (nothing charged): ${data.error ?? `HTTP ${res.status}`}` };
+    const err = typeof data.error === "string" ? data.error : data.error?.message;
+    return { kind: "text", text: `Effect not started (nothing charged): ${err ?? `HTTP ${res.status}`}` };
   }
   const result = await pollJobUntilDoneOrHandoff(data.jobId, (id) => ctx.client.getJob(id), ctx.buildStatusUrl, {
     now: ctx.pollOverrides?.now,
@@ -4287,7 +4333,15 @@ ${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) };
+  const all = r.data.brand_kits ?? [];
+  const others = all.filter((k) => !k.isDefault);
+  return {
+    kind: "text",
+    text: [
+      describeKit(r.data.brand_kit ?? null),
+      ...others.length ? [`Other brand kits (pass brand_kit_id on a run to use one): ${others.map((k) => `${k.name || "(no name)"} (id ${k.id})`).join("; ")}`] : []
+    ].join("\n")
+  };
 }
 async function templatesRun(input, ctx) {
   const q = new URLSearchParams();
@@ -4333,7 +4387,7 @@ async function imageRun(input, ctx) {
       engine: input.engine,
       count: input.count,
       reference_ad_url: input.reference_ad_url,
-      brand_kit: input.brand_kit
+      brand_kit: input.brand_kit === false ? false : input.brand_kit_id ?? input.brand_kit
     }
   });
   if (!r.ok) return { kind: "text", text: `Images not started: ${r.error}` };
@@ -4403,7 +4457,7 @@ async function motionRun(input, ctx) {
       video_url: input.video_url,
       brand_name: input.brand_name,
       colors: input.colors?.map((c) => c.trim().toLowerCase()),
-      brand_kit: input.brand_kit
+      brand_kit: input.brand_kit === false ? false : input.brand_kit_id ?? input.brand_kit
     }
   });
   if (!r.ok) return { kind: "text", text: `Not started: ${r.error}` };
@@ -4500,7 +4554,8 @@ var init_marketing = __esm({
       motion_id: zod.z.string().max(80).optional(),
       brand_name: zod.z.string().max(60).optional(),
       colors: zod.z.array(zod.z.string()).max(5).optional(),
-      brand_kit: zod.z.boolean().optional()
+      brand_kit: zod.z.boolean().optional(),
+      brand_kit_id: zod.z.string().max(80).optional()
     });
     props = {
       action: {
@@ -4536,7 +4591,8 @@ var init_marketing = __esm({
       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." }
+      brand_kit: { type: "boolean", description: "false skips the brand kit for this call." },
+      brand_kit_id: { type: "string", description: "Use this saved brand kit instead of the default (ids listed by pixeldojo_brand_kit)." }
     };
     marketingSkill = {
       name: "pixeldojo_marketing",
@@ -5064,7 +5120,7 @@ var init_skills = __esm({
         }
       };
     });
-    render = (title) => ({ title, readOnlyHint: false, destructiveHint: false, openWorldHint: false });
+    render = (title) => ({ title, readOnlyHint: false, destructiveHint: false, openWorldHint: true });
     read = (title) => ({ title, readOnlyHint: true, destructiveHint: false, openWorldHint: false });
     TOOL_ANNOTATIONS = {
       pixeldojo_generate: render("Generate image or video"),
@@ -5079,22 +5135,22 @@ 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_brand_kit: { ...render("Brand kit from website"), destructiveHint: true },
       pixeldojo_marketing: render("Image ads, motion graphics and templates"),
       pixeldojo_campaign: render("Make product launch campaign"),
-      pixeldojo_film: render("Make short film"),
+      pixeldojo_film: { ...render("Make short film"), destructiveHint: true },
       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 },
+      pixeldojo_save_workflow: { ...render("Save workflow"), destructiveHint: true, openWorldHint: false },
       pixeldojo_status: read("Check job status"),
       pixeldojo_campaign_status: read("Check campaign status"),
       pixeldojo_library: read("Search media library"),
-      pixeldojo_save: render("Save to My Media"),
-      pixeldojo_save_character: render("Save character or element"),
+      pixeldojo_save: { ...render("Save to My Media"), openWorldHint: false },
+      pixeldojo_save_character: { ...render("Save character or element"), openWorldHint: false },
       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"),
@@ -5153,7 +5209,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.31.0" ;
+var PACKAGE_VERSION = "0.36.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) {
@@ -5271,7 +5327,10 @@ function errorToActionableMessage(err) {
     return "Authentication failed. Check PIXELDOJO_API_KEY. Get a key at https://pixeldojo.ai/api-platform/api-keys.";
   }
   if (e.status === 402 || e.code === "insufficient_credits") {
-    return "Insufficient credits. Top up at https://pixeldojo.ai/api-platform/buy-credits.";
+    return (
+      // ponytail: no checkout link, ChatGPT's plugin review bans linking to a purchase page.
+      "Not enough credits for this. Add credits in your Pixel Dojo account, then try again."
+    );
   }
   if (e.status === 429 || e.code === "rate_limit") {
     return "Rate limit hit. Try again in a few seconds.";