@pixeldojo/mcp 0.30.0 → 0.34.1

package/dist/cli.js

@@ -246,6 +246,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;
@@ -504,20 +512,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);
@@ -549,7 +561,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 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: 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 +600,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 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",
@@ -636,8 +648,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, 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,
@@ -923,7 +935,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;
@@ -935,7 +948,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 = z.object({
       prompt: z.string().min(1).max(8e3),
@@ -1051,6 +1065,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
@@ -1677,7 +1693,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) } : {}
   });
@@ -2006,7 +2022,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();
@@ -2436,17 +2452,47 @@ 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":
         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 } };
     }
   }
   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 } };
     }
@@ -2568,30 +2614,31 @@ 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",
         "seedance-video-edit",
         "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"
+      "wan-video-character-swap",
+      "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"]);
+    NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["xai-video-edit", "minimax-h3-turbo"]);
     InputSchema11 = z.object({
       verb: z.enum(VERBS),
       prompt: z.string().max(8e3).optional(),
@@ -2617,7 +2664,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",
@@ -2683,7 +2730,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) } : {}
   });
@@ -2924,7 +2971,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) } : {}
   });
@@ -2938,14 +2985,23 @@ 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")
     };
   }
+  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);
@@ -2953,17 +3009,17 @@ function describeDrama(v, o = DRAMA_OPTS) {
       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}: ${b.note}${b.redo_films ? ` The redo films: ${b.redo_films}` : ""}`),
-        other.length ? `Also noted, no redo needed: ${other.map((b) => `${o.unit} ${b.beat}: ${b.note}`).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 these notes (${o.tool} with {"${o.idField}": "${id}", "action": "redo", "beats": [${flagged.map((b) => b.beat).join(", ")}], "notes": [the notes, same order]}, each at its own price), or cut it as it is (action "cut", free). Nothing more is filmed until they choose.`
+        `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 ?? `did not say ${b.missing_lines.map((l) => `"${l}"`).join(", ")}`}${b.redo_films ? ` The redo films: ${b.redo_films}` : ""}`);
-    const other = v.beats.filter((b) => b.note && b.needs_redo === false).map((b) => `${o.unit} ${b.beat}: ${b.note}`);
+    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: [
@@ -2979,7 +3035,7 @@ function describeDrama(v, o = DRAMA_OPTS) {
   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.missing_lines.length ? ` (it dropped the line "${b.missing_lines[0]}")` : b.note ? ` (the review asked: ${b.note.split(/(?<=\.) /)[0]})` : ""}`);
+  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.`,
@@ -3015,9 +3071,11 @@ var init_drama = __esm({
       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(),
+      cast: z.array(z.object({ name: z.string().min(1).max(40), image_url: z.string().url(), outfit_image_url: z.string().url().optional() })).max(5).optional(),
+      length_sec: z.number().int().min(24).max(180).multipleOf(6).optional(),
       scenes: z.number().int().min(1).max(15).optional(),
       score: z.boolean().optional(),
+      engine: z.enum(["seedance-2-5", "wan-3-0-video", "kling-4-0"]).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()
@@ -3028,7 +3086,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." },
@@ -3036,7 +3094,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: {
@@ -3056,13 +3114,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." },
@@ -3079,7 +3140,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"],
@@ -3094,7 +3155,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]])
@@ -3123,7 +3186,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) } : {}
   });
@@ -3252,7 +3315,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) } : {}
   });
@@ -3331,7 +3394,7 @@ var init_kata = __esm({
         },
         photos: {
           type: "array",
-          items: { type: "object", properties: { url: { type: "string" }, note: { type: "string", description: 'What it is (e.g. "the product").' } }, required: ["url"] },
+          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." },
@@ -3416,7 +3479,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);
@@ -3461,7 +3524,8 @@ var init_ad = __esm({
       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(),
       reference_video_url: z.string().url().optional(),
-      brand_kit: z.boolean().optional()
+      brand_kit: z.boolean().optional(),
+      brand_kit_id: z.string().max(80).optional()
     }).refine(
       (v) => v.product_url || (v.product_image_urls?.length || v.product_image_paths?.length) && v.product_name,
       {
@@ -3555,7 +3619,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
@@ -3896,7 +3964,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",
@@ -4119,7 +4188,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,
@@ -4251,7 +4321,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();
@@ -4297,7 +4375,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}` };
@@ -4367,7 +4445,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}` };
@@ -4422,11 +4500,11 @@ var init_marketing = __esm({
           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" },
-          tagline: { type: "string" },
+          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 },
+          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." }
         }
@@ -4464,7 +4542,8 @@ var init_marketing = __esm({
       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()
+      brand_kit: z.boolean().optional(),
+      brand_kit_id: z.string().max(80).optional()
     });
     props = {
       action: {
@@ -4479,8 +4558,8 @@ var init_marketing = __esm({
         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" },
-      product_description: { type: "string" },
+      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." },
@@ -4500,7 +4579,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",
@@ -5028,7 +5108,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"),
@@ -5043,22 +5123,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"),
@@ -5117,7 +5197,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.30.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) {
@@ -5235,7 +5315,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.";