@pixeldojo/mcp 0.17.0 → 0.18.0

package/dist/index.js

@@ -1464,13 +1464,23 @@ async function applyCast(ctx, filmId, cast) {
         role: c.name,
         ...c.character_id ? { characterId: c.character_id } : {},
         ...c.image_urls ? { imageUrls: c.image_urls } : {},
-        ...c.prompt ? { prompt: c.prompt } : {}
+        ...c.prompt ? { prompt: c.prompt } : {},
+        ...c.replace ? { replace: true } : {},
+        ...c.remove ? { remove: true } : {}
       }
     );
-    if (r.status === 200 && r.data.creditCost) charged = true;
-    if (r.status !== 200) return `Could not cast ${c.name}: ${r.data.error ?? r.status}`;
-    if (r.data.alreadyCast) return `${c.name} was already cast; nothing changed.`;
-    return `Cast ${c.name}${r.data.creditCost ? ` (portrait, ${r.data.creditCost} credits)` : ""}${r.data.boundShots ? `, in ${r.data.boundShots} shot(s)` : ""}.`;
+    if (r.data.creditCost) charged = true;
+    if (r.status !== 200) {
+      const where2 = r.data.code === "cast-rendered" ? ` Storyboard: ${ctx.baseUrl}/film-studio/${filmId}` : "";
+      return `Could not ${c.remove ? "remove" : c.replace ? "replace" : "cast"} ${c.name}: ${r.data.error ?? r.status}${where2}`;
+    }
+    if (r.data.removed) return `Removed ${c.name} from the film and every shot.`;
+    if (r.data.alreadyCast) {
+      return c.replace ? `${c.name} is already played by that character; nothing changed.` : `${c.name} is already cast; nothing changed. To swap who plays ${c.name}, send the entry again with replace: true.`;
+    }
+    const cost = r.data.creditCost ? ` (portrait, ${r.data.creditCost} credits)` : "";
+    const where = r.data.boundShots ? `, in ${r.data.boundShots} shot(s)` : "";
+    return r.data.replaced ? `Replaced ${r.data.replaced.name} with ${r.data.character?.name ?? "the new cast member"}${r.data.character?.id ? ` (character_id ${r.data.character.id})` : ""} as ${c.name}${cost}${where}.` : `Cast ${c.name}${cost}${where}.`;
   }));
   return { lines, charged };
 }
@@ -1773,7 +1783,7 @@ async function run8(input, ctx) {
   if (action === "plan") return plan(input, ctx);
   if (!input.film_id) return { kind: "text", text: "produce/status/cast need the film_id returned by the plan step." };
   if (action === "cast") {
-    if (!input.cast?.length) return { kind: "text", text: "Pass cast: [{ name, prompt | image_urls | character_id }] to cast characters." };
+    if (!input.cast?.length) return { kind: "text", text: "Pass cast: [{ name, prompt | image_urls | character_id }] to cast characters (add replace: true to swap someone already cast, or remove: true to take them off)." };
     const { lines } = await applyCast(ctx, input.film_id, input.cast);
     const uncast = await uncastRolesOf(ctx, input.film_id);
     return {
@@ -1806,15 +1816,17 @@ var init_film = __esm({
       aspect: z.enum(["16:9", "9:16"]).default("16:9"),
       length: z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length; drives the shot count (~6/12/24/60 shots)."),
       film_id: z.string().max(40).optional().describe("Existing film id (from a previous call) for produce/status/cast."),
-      action: z.enum(["plan", "produce", "status", "cast"]).default("plan").describe("'plan' creates + storyboards (free). 'cast' casts characters on an existing film. 'produce' starts charged generation. 'status' advances production and reports progress; poll it every ~30s until it returns the finished film."),
+      action: z.enum(["plan", "produce", "status", "cast"]).default("plan").describe("'plan' creates + storyboards (free). 'cast' casts, replaces or removes characters on an existing film. 'produce' starts charged generation. 'status' advances production and reports progress; poll it every ~30s until it returns the finished film."),
       cast: z.array(
         z.object({
           name: z.string().trim().min(1).max(60),
           image_urls: z.array(z.string().url().startsWith("https://").max(2048)).min(1).max(8).optional(),
           prompt: z.string().trim().min(1).max(600).optional(),
-          character_id: z.string().max(40).optional()
+          character_id: z.string().max(40).optional(),
+          replace: z.boolean().optional(),
+          remove: z.boolean().optional()
         })
-      ).max(8).optional().describe("Cast members, one per named character. Each gives image_urls (your own photos), a prompt (a portrait is generated, charged), or a character_id (a Character Studio character); with none of these the Character Studio character of that name is used."),
+      ).max(8).optional().describe("Cast members, one per named character. Each gives image_urls (your own photos), a prompt (a portrait is generated, charged), or a character_id (a Character Studio character); with none of these the Character Studio character of that name is used. replace: true swaps out whoever already plays that name; remove: true takes them off the film."),
       soundtrack: z.enum(["scene-synced", "flat", "none"]).default("scene-synced").describe("scene-synced composes one musical section per scene, pinned to the scene lengths (default). flat is a single cohesive bed. none skips music."),
       music_job_id: z.string().max(80).optional().describe("The music_job_id from the previous status reply while the score is composing, so that score is attached. A status call without it, once all clips are ready and no score is attached, starts and charges for a new score.")
     });
@@ -1843,12 +1855,12 @@ var init_film = __esm({
         action: {
           type: "string",
           enum: ["plan", "produce", "status", "cast"],
-          description: "plan (default, free): writes the script and plans shots, returns film_id, a cost estimate, and any characters still to cast. cast: casts characters on an existing film (pass film_id and cast). produce (charged): starts rendering frames; refused until every named character is cast. status: advances production one step and reports progress; call it every ~30s until it returns the finished film URL."
+          description: "plan (default, free): writes the script and plans shots, returns film_id, a cost estimate, and any characters still to cast. cast: casts, replaces or removes characters on an existing film (pass film_id and cast). produce (charged): starts rendering frames; refused until every named character is cast. status: advances production one step and reports progress; call it every ~30s until it returns the finished film URL."
         },
         cast: {
           type: "array",
           maxItems: 8,
-          description: 'Cast members, one per named character. Every named character must be cast before frames render, so faces, ages and species hold in every shot. Pass them on the plan call (the script then stars them by name) or later with action "cast" using the names the plan reports. Each entry: name, plus ONE of image_urls (your own photos of an adult, made into a character), prompt (a portrait is generated from it, charged like any image), or character_id (a Character Studio character). An entry with only a name uses your Character Studio character of that name.',
+          description: 'Cast members, one per named character. Every named character must be cast before frames render, so faces, ages and species hold in every shot. Pass them on the plan call (the script then stars them by name) or later with action "cast" using the names the plan reports. Each entry: name, plus ONE of image_urls (your own photos of an adult, made into a character), prompt (a portrait is generated from it, charged like any image), or character_id (a Character Studio character). An entry with only a name uses your Character Studio character of that name. A name that is already cast is left alone unless the entry sets replace: true, which hands that part (every shot, outfit and voice) to the new cast member. remove: true with only the name takes that cast member off the film; the part then needs a new cast member before frames render. replace and remove work until the shots of that cast member are rendered; after that, recast on the storyboard, where the frames that show them can be redone.',
           items: {
             type: "object",
             properties: {
@@ -1858,7 +1870,15 @@ var init_film = __esm({
                 type: "string",
                 description: 'A description to generate the portrait from: species if not human, gender, adult age, look and outfit (e.g. "man in his late 50s, grey mustache, sunburnt, red windbreaker").'
               },
-              character_id: { type: "string", description: "A Character Studio character id." }
+              character_id: { type: "string", description: "A Character Studio character id." },
+              replace: {
+                type: "boolean",
+                description: "Swap out whoever already plays this name for the image_urls, prompt or character_id given here, before their shots are rendered. Without it, an already-cast name is left unchanged."
+              },
+              remove: {
+                type: "boolean",
+                description: "Take whoever plays this name off the film and every shot (free), before their shots are rendered. Give only the name."
+              }
             },
             required: ["name"]
           }
@@ -1905,8 +1925,8 @@ var init_film = __esm({
     };
     filmSkill = {
       name: "pixeldojo_film",
-      description: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_path (a local file) or song_url (your own PixelDojo upload from pixeldojo_upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s).",
-      hostedDescription: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_url (your own PixelDojo upload made with POST /api/v1/upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s).",
+      description: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_path (a local file) or song_url (your own PixelDojo upload from pixeldojo_upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s).",
+      hostedDescription: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_url (your own PixelDojo upload made with POST /api/v1/upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s).",
       inputZod: InputSchema8,
       inputJsonSchema: InputJsonSchema8,
       allowedModels: [],
@@ -3383,7 +3403,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.17.0" ;
+var PACKAGE_VERSION = "0.18.0" ;
 var SERVER_INSTRUCTIONS = "PixelDojo generates images, video, audio and short films across 100+ models, billed in credits from the connected PixelDojo 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, so download anything the user wants to keep. Finished films are the exception and stay in the account library.";
 function buildServer(options) {
   if (!options.apiKey) {