@pixeldojo/mcp 0.31.0 → 0.34.1

package/README.md

@@ -40,7 +40,7 @@ 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
 
@@ -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" 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 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, 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."
@@ -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" 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 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, 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, 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, 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, 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, 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,
@@ -925,7 +937,8 @@ var init_character = __esm({
       "google-nano-banana",
       "wan-2.7-image-edit",
       "qwen-3-pro",
-      "qwen-image-2.0-pro"
+      "qwen-image-2.0-pro",
+      "p-h3-image"
     ];
     DEFAULT_MODEL3 = "seedream-5";
     MAX_REFERENCES = 9;
@@ -937,7 +950,8 @@ var init_character = __esm({
       "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"
     };
     InputSchema3 = zod.z.object({
       prompt: zod.z.string().min(1).max(8e3),
@@ -1681,7 +1695,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 +2024,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 +2454,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 +2484,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 +2616,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 +2623,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 +2666,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 +2732,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 +2973,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 +2987,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 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 +3073,11 @@ 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(),
+      engine: zod.z.enum(["seedance-2-5", "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 +3088,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 +3096,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,13 +3116,16 @@ 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", "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), 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)." },
         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." },
@@ -3115,7 +3142,7 @@ 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, 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"],
@@ -3130,7 +3157,9 @@ 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 } : {},
             ...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 +3188,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 +3317,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) } : {}
   });
@@ -3452,7 +3481,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 +3526,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 +3621,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 +3966,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 +4190,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 +4323,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 +4377,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 +4447,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 +4544,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 +4581,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 +5110,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 +5125,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 +5199,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.31.0" ;
+var PACKAGE_VERSION = "0.34.1" ;
 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 +5317,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.";