@pixeldojo/mcp 0.15.0 → 0.16.0

package/dist/cli.cjs

@@ -1410,13 +1410,13 @@ function progressLine(f) {
   const rendering = all.filter((sh) => sh.status === "clip-generating").length;
   return `frames ${frames}/${all.length}, clips ${clips}/${all.length}${rendering > 0 ? ` (${rendering} rendering)` : ""}`;
 }
-async function runPlanner(ctx, filmId, path, body) {
+async function runPlanner(ctx, filmId, path, body, maxPolls = PLANNER_MAX_POLLS) {
   const submit = await filmApi(ctx, "POST", path, body);
   if (submit.data.film) return { film: submit.data.film };
   const jobId = submit.data.jobId;
   if (!jobId) return { error: submit.data.error ?? `HTTP ${submit.status}` };
   const sleep = ctx.pollOverrides?.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
-  for (let i = 0; i < PLANNER_MAX_POLLS; i += 1) {
+  for (let i = 0; i < maxPolls; i += 1) {
     await sleep(PLANNER_POLL_MS);
     const { data } = await filmApi(ctx, "GET", `/api/films/${filmId}`);
     const job = data.film?.llmJob;
@@ -1485,7 +1485,7 @@ ${input.lyrics.trim()}` : ""].filter(Boolean).join("\n\n");
     let script = input.script?.trim() ?? "";
     if (!script) {
       const wrote = await runPlanner(ctx, id, `/api/films/${id}/script`, { idea: input.idea.trim() });
-      if ("pending" in wrote) return { kind: "text", text: stillPlanningText(id) };
+      if ("pending" in wrote) return { kind: "text", text: stillPlanningText(id, "script") };
       if ("error" in wrote) return { kind: "text", text: `Script writing failed: ${wrote.error}` };
       script = wrote.film.script ?? "";
       if (!script) return { kind: "text", text: "Script writing failed: the studio returned an empty script." };
@@ -1505,12 +1505,14 @@ ${err} Call action "status" to retry the cut.` };
 }
 async function resumePlanning(film, ctx) {
   if (film.scenes.length > 0 && film.llmJob?.status !== "running") return null;
-  if (film.llmJob?.status === "running") return { kind: "text", text: stillPlanningText(film.id) };
+  if (film.llmJob?.status === "running") {
+    return { kind: "text", text: stillPlanningText(film.id, film.llmJob.kind === "script" ? "script" : "plan") };
+  }
   const prior = film.llmJob?.status === "error" ? `The last planning run failed (${film.llmJob.error ?? "unknown"}). ` : "";
   if (!film.script?.trim()) {
     return { kind: "text", text: `${prior}This film has nothing to plan from. Start a new one with action "plan".` };
   }
-  const planned = await runPlanner(ctx, film.id, `/api/films/${film.id}/plan`, { script: film.script });
+  const planned = await runPlanner(ctx, film.id, `/api/films/${film.id}/plan`, { script: film.script }, 0);
   if ("pending" in planned) return { kind: "text", text: `${prior}${stillPlanningText(film.id)}` };
   if ("error" in planned) return { kind: "text", text: `Shot planning failed: ${planned.error} Call action "status" to retry.` };
   if (needsSlice(planned.film)) {
@@ -1596,6 +1598,9 @@ It is saved in the Library folder "Film: ${film.title}".`
     if (err) return { kind: "text", text: `${err} Poll again with action "status" to retry.` };
     return { kind: "text", text: `Song cut into one slice per shot. Poll again with {"film_id": "${filmId}", "action": "status"} to keep production moving.` };
   }
+  if (shots(film).length > 0 && shots(film).every((sh) => sh.status === "idle")) {
+    return { kind: "text", text: plannedText(film, ctx) };
+  }
   const idleFrames = all.filter((sh) => sh.status === "idle");
   for (const sh of idleFrames.slice(0, 6)) {
     await filmApi(ctx, "POST", `/api/films/${filmId}/shots/${sh.id}/generate`, { kind: "frame" });
@@ -1721,7 +1726,7 @@ var init_film = __esm({
     PLANNER_MAX_POLLS = 8;
     isMusicVideo = (f) => f.musicVideoMode === true;
     needsSlice = (f) => isMusicVideo(f) && shots(f).length > 0 && !shots(f).some((sh) => sh.musicChunkUrl);
-    stillPlanningText = (filmId) => `Planning is still running (film_id: ${filmId}). Nothing has been charged. Call pixeldojo_film with {"film_id": "${filmId}", "action": "status"} in ~30s; it returns the plan once it is ready.`;
+    stillPlanningText = (filmId, stage = "plan") => `${stage === "script" ? "Still writing the script" : "Still planning the shots"} for film_id ${filmId}. Nothing has been charged. Call pixeldojo_film with {"film_id": "${filmId}", "action": "status"} in ~30s; it returns the plan once it is ready.`;
     LOOK_MUSIC = {
       "live-action": "modern cinematic underscore, warm strings and soft felt piano, subtle rhythmic pulse, slow emotional build",
       anime: "sweeping anime film score, lush strings and piano, taiko drum accents, soaring heartfelt theme",
@@ -3047,6 +3052,7 @@ var skills_exports = {};
 __export(skills_exports, {
   ALL_SKILLS: () => ALL_SKILLS,
   HOSTED_SKILLS: () => HOSTED_SKILLS,
+  TOOL_ANNOTATIONS: () => TOOL_ANNOTATIONS,
   adSkill: () => adSkill,
   audioSkill: () => audioSkill,
   campaignSkill: () => campaignSkill,
@@ -3065,10 +3071,21 @@ __export(skills_exports, {
   saveWorkflowSkill: () => saveWorkflowSkill,
   statusSkill: () => statusSkill,
   storyboardSkill: () => storyboardSkill,
+  toolListing: () => toolListing,
   uploadSkill: () => uploadSkill,
   upscaleSkill: () => upscaleSkill,
   videoSkill: () => videoSkill
 });
+function toolListing(skill) {
+  const { title, ...hints } = TOOL_ANNOTATIONS[skill.name];
+  return {
+    name: skill.name,
+    title,
+    description: skill.description,
+    inputSchema: skill.inputJsonSchema,
+    annotations: { title, ...hints }
+  };
+}
 function findHostedSkill(name) {
   const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
   return HOSTED_SKILLS.find((s) => s.name === wanted);
@@ -3077,7 +3094,7 @@ function findSkill(name) {
   const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
   return ALL_SKILLS.find((s) => s.name === wanted);
 }
-var ALL_SKILLS, isLocalPathField, HOSTED_SKILLS;
+var ALL_SKILLS, isLocalPathField, HOSTED_SKILLS, render, read, TOOL_ANNOTATIONS;
 var init_skills = __esm({
   "src/skills/index.ts"() {
     init_generate();
@@ -3132,6 +3149,29 @@ var init_skills = __esm({
         }
       };
     });
+    render = (title) => ({ title, readOnlyHint: false, destructiveHint: false, openWorldHint: false });
+    read = (title) => ({ title, readOnlyHint: true, destructiveHint: false, openWorldHint: false });
+    TOOL_ANNOTATIONS = {
+      pixeldojo_generate: render("Generate image or video"),
+      pixeldojo_edit: render("Edit image"),
+      pixeldojo_character: render("Consistent character image"),
+      pixeldojo_storyboard: render("Storyboard preview video"),
+      pixeldojo_upscale: render("Upscale image or video"),
+      pixeldojo_audio: render("Generate music, speech or sound"),
+      pixeldojo_video: render("Change, animate or extend video"),
+      pixeldojo_ad: render("Make video ad"),
+      pixeldojo_campaign: render("Make product launch campaign"),
+      pixeldojo_film: render("Make short film"),
+      pixeldojo_episode: render("Make faceless video"),
+      pixeldojo_run_workflow: render("Run saved workflow"),
+      pixeldojo_upload: render("Upload local file"),
+      pixeldojo_save_workflow: { ...render("Save workflow"), destructiveHint: true },
+      pixeldojo_status: read("Check job status"),
+      pixeldojo_campaign_status: read("Check campaign status"),
+      pixeldojo_library: read("Search media library"),
+      pixeldojo_list_workflows: read("List saved workflows"),
+      pixeldojo_from_url: { ...read("Read product page"), openWorldHint: true }
+    };
   }
 });
 function makeAttributedClient(options) {
@@ -3185,7 +3225,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.14.0" ;
+var PACKAGE_VERSION = "0.16.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) {
@@ -3210,11 +3250,7 @@ function buildServer(options) {
   );
   server.setRequestHandler(types_js.ListToolsRequestSchema, async () => {
     return {
-      tools: ALL_SKILLS.map((skill) => ({
-        name: skill.name,
-        description: skill.description,
-        inputSchema: skill.inputJsonSchema
-      }))
+      tools: ALL_SKILLS.map(toolListing)
     };
   });
   server.setRequestHandler(types_js.CallToolRequestSchema, async (req) => {