@pixeldojo/mcp 0.9.0 → 0.9.1

package/dist/cli.js

@@ -93,7 +93,7 @@ function pollResultToSkillResult(result, successText) {
   }
   return {
     kind: "handoff",
-    text: `Job ${result.jobId} is still running after the 30s sync window. Use pixeldojo:status with this jobId to check completion, or follow ${result.statusUrl}.`,
+    text: `Job ${result.jobId} is still running after the 30s sync window. Use pixeldojo_status with this jobId to check completion, or follow ${result.statusUrl}.`,
     jobId: result.jobId,
     statusUrl: result.statusUrl
   };
@@ -186,6 +186,7 @@ var init_upload_helpers = __esm({
 function getFieldConstraints(apiId, client) {
   const cached = schemaCache.get(apiId);
   if (cached) return cached;
+  if (typeof client?.getModelSchema !== "function") return Promise.resolve(null);
   const pending = Promise.resolve().then(() => client.getModelSchema(apiId)).then(
     (res) => res.schema?.properties ?? {}
   ).catch(() => {
@@ -230,6 +231,46 @@ async function snapAspectRatio(apiId, requested, client, opts = {}) {
   if (!field.enum || field.enum.length === 0) return requested;
   return nearestAspectFromEnum(requested, field.enum);
 }
+async function resolveReferenceField(apiId, client) {
+  const props = await getFieldConstraints(apiId, client);
+  if (props === null) return void 0;
+  for (const name of REFERENCE_FIELD_PRIORITY) {
+    const field = props[name];
+    if (field) return { name, isArray: field.type === "array" };
+  }
+  return null;
+}
+function resolutionHeight(value) {
+  const v = value.trim().toLowerCase();
+  if (v === "4k") return 2160;
+  const n = Number.parseInt(v, 10);
+  return Number.isFinite(n) ? n : null;
+}
+async function snapResolution(apiId, requested, client, opts = {}) {
+  if (!requested) return void 0;
+  const props = await getFieldConstraints(apiId, client);
+  if (props === null) {
+    return opts.onUnknown === "omit" ? void 0 : requested;
+  }
+  const field = props.resolution;
+  if (!field) return void 0;
+  if (!field.enum || field.enum.length === 0) return requested;
+  if (field.enum.includes(requested)) return requested;
+  const target = resolutionHeight(requested);
+  if (target === null) return requested;
+  let best = requested;
+  let bestDiff = Infinity;
+  for (const candidate of field.enum) {
+    const h = resolutionHeight(candidate);
+    if (h === null) continue;
+    const diff = Math.abs(h - target);
+    if (diff < bestDiff) {
+      bestDiff = diff;
+      best = candidate;
+    }
+  }
+  return best;
+}
 async function snapDuration(apiId, requested, client, opts = {}) {
   if (requested === void 0) return void 0;
   const props = await getFieldConstraints(apiId, client);
@@ -268,10 +309,22 @@ async function resolveImageRefs(apiId, urls, client) {
   }
   return { key, value: urls[0], dropped: urls.length - 1 };
 }
-var schemaCache, REF_KEYS;
+var schemaCache, REFERENCE_FIELD_PRIORITY, REF_KEYS;
 var init_schema_snap = __esm({
   "src/skills/schema-snap.ts"() {
     schemaCache = /* @__PURE__ */ new Map();
+    REFERENCE_FIELD_PRIORITY = [
+      "image_url",
+      "start_image_url",
+      "input_image",
+      "image",
+      "reference_images",
+      "reference_urls",
+      "reference_image_urls",
+      "image_urls",
+      "image_input",
+      "images"
+    ];
     REF_KEYS = [
       "image_urls",
       "images",
@@ -284,7 +337,7 @@ var init_schema_snap = __esm({
     ];
   }
 });
-function buildPayload(apiId, input) {
+function buildPayload(apiId, input, refField, referenceUrls = []) {
   const body = { prompt: input.prompt };
   if (input.aspect_ratio) body.aspect_ratio = input.aspect_ratio;
   if (input.preset) body.preset = input.preset;
@@ -302,8 +355,16 @@ function buildPayload(apiId, input) {
       }
       break;
     default:
-      if (input.image_url) body.image_url = input.image_url;
+      if (input.image_url) {
+        const refs = referenceUrls.length > 0 ? referenceUrls : [input.image_url];
+        if (refField) {
+          body[refField.name] = refField.isArray ? refs : refs[0];
+        } else {
+          body.image_url = refs[0];
+        }
+      }
       if (input.duration !== void 0) body.duration = input.duration;
+      if (input.resolution) body.resolution = input.resolution;
       break;
   }
   return body;
@@ -311,39 +372,51 @@ function buildPayload(apiId, input) {
 async function run(input, ctx) {
   const apiId = input.model ?? DEFAULT_MODEL;
   let resolved = input;
-  if (!input.image_url && input.image_path) {
-    try {
-      const uploadedUrl = await uploadLocalFile(input.image_path, ctx.client);
-      resolved = { ...input, image_url: uploadedUrl };
-    } catch (err) {
-      if (err instanceof SkillUploadError) {
-        return { kind: "text", text: `pixeldojo:generate (upload): ${err.userMessage}` };
-      }
-      throw err;
+  let referenceUrls = [];
+  try {
+    const singleUrl = input.image_url ?? (input.image_path ? await uploadLocalFile(input.image_path, ctx.client) : void 0);
+    const manyUrls = [...input.image_urls ?? []];
+    for (const p of input.image_paths ?? []) {
+      manyUrls.push(await uploadLocalFile(p, ctx.client));
+    }
+    referenceUrls = [...singleUrl ? [singleUrl] : [], ...manyUrls].filter(
+      (u, i, all) => all.indexOf(u) === i
+    );
+    if (referenceUrls[0] && referenceUrls[0] !== input.image_url) {
+      resolved = { ...input, image_url: referenceUrls[0] };
     }
+  } catch (err) {
+    if (err instanceof SkillUploadError) {
+      return { kind: "text", text: `pixeldojo_generate (upload): ${err.userMessage}` };
+    }
+    throw err;
   }
   if (apiId === "grok-video-extend") {
     if (!resolved.image_url) {
       return {
         kind: "text",
-        text: 'pixeldojo:generate with model="grok-video-extend" requires image_url (the source video URL to extend, or image_path for a local file).'
+        text: 'pixeldojo_generate with model="grok-video-extend" requires image_url (the source video URL to extend, or image_path for a local file).'
       };
     }
     if (resolved.duration === void 0) {
       return {
         kind: "text",
-        text: 'pixeldojo:generate with model="grok-video-extend" requires duration (extension length in seconds).'
+        text: 'pixeldojo_generate with model="grok-video-extend" requires duration (extension length in seconds).'
       };
     }
   }
+  let refField;
   if (!VIDEO_INPUT_MODELS.has(apiId)) {
-    const [aspect_ratio, duration] = await Promise.all([
+    const [aspect_ratio, duration, resolution, ref] = await Promise.all([
       snapAspectRatio(apiId, resolved.aspect_ratio, ctx.client),
-      snapDuration(apiId, resolved.duration, ctx.client)
+      snapDuration(apiId, resolved.duration, ctx.client),
+      snapResolution(apiId, resolved.resolution, ctx.client),
+      resolved.image_url ? resolveReferenceField(apiId, ctx.client) : Promise.resolve(void 0)
     ]);
-    resolved = { ...resolved, aspect_ratio, duration };
+    resolved = { ...resolved, aspect_ratio, duration, resolution };
+    refField = ref;
   }
-  const body = buildPayload(apiId, resolved);
+  const body = buildPayload(apiId, resolved, refField, referenceUrls);
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -376,9 +449,18 @@ var init_generate = __esm({
       ),
       aspect_ratio: z.string().optional().describe('Aspect ratio supported by the chosen model (e.g. "1:1", "16:9", "9:16").'),
       duration: z.number().int().positive().optional().describe("Video duration in seconds, when applicable."),
+      resolution: z.string().optional().describe(
+        'Output resolution when the model supports it (e.g. "480p", "720p", "1080p", "4k"). Lower tiers cost fewer credits. Omit to use the model default.'
+      ),
       image_url: z.string().url().optional().describe("Reference image URL for image-to-image / image-to-video tools."),
       image_path: z.string().min(1).optional().describe(
         "Absolute local file path to a reference image/video. The skill uploads it to PixelDojo first (24h temp storage) and then dispatches. Prefer this over image_url when the user has the file on disk."
+      ),
+      image_urls: z.array(z.string().url()).optional().describe(
+        "Multiple reference image URLs, for models that accept a reference set (character + wardrobe + location, for example). Models that take only one reference use the first and the rest are ignored."
+      ),
+      image_paths: z.array(z.string().min(1)).optional().describe(
+        "Multiple absolute local file paths. Each is uploaded to PixelDojo (24h temp storage) and used as a reference, same rules as image_urls."
       )
     });
     DEFAULT_MODEL = "google-nano-banana";
@@ -397,7 +479,21 @@ var init_generate = __esm({
         },
         aspect_ratio: { type: "string" },
         duration: { type: "integer" },
+        resolution: {
+          type: "string",
+          description: 'Output resolution when supported (e.g. "480p", "720p", "1080p", "4k"). Lower tiers cost fewer credits.'
+        },
         image_url: { type: "string", format: "uri" },
+        image_urls: {
+          type: "array",
+          items: { type: "string", format: "uri" },
+          description: "Multiple reference image URLs for models that accept a reference set. Single-reference models use the first."
+        },
+        image_paths: {
+          type: "array",
+          items: { type: "string" },
+          description: "Multiple absolute local file paths, each uploaded to 24h temp storage and used as a reference."
+        },
         image_path: {
           type: "string",
           description: "Absolute local file path. The skill uploads it to PixelDojo (24h temp storage) and uses the resulting URL as the reference image. Prefer this over image_url when the user has a local file."
@@ -406,7 +502,7 @@ var init_generate = __esm({
       required: ["prompt"]
     };
     generateSkill = {
-      name: "pixeldojo:generate",
+      name: "pixeldojo_generate",
       description: "Generate any image or video from a prompt. Auto-routes to a sensible default model; pass `model` to pick a specific apiId from the catalog. For reference-image / image-to-video flows: pass `image_url` if you already have a URL, or `image_path` (absolute local path) and the skill uploads it to 24h temp storage automatically.",
       inputZod: InputSchema,
       inputJsonSchema: InputJsonSchema,
@@ -491,14 +587,14 @@ async function run2(input, ctx) {
     }
   } catch (err) {
     if (err instanceof SkillUploadError) {
-      return { kind: "text", text: `pixeldojo:edit (upload): ${err.userMessage}` };
+      return { kind: "text", text: `pixeldojo_edit (upload): ${err.userMessage}` };
     }
     throw err;
   }
   if (!resolved.image_url && (!resolved.image_urls || resolved.image_urls.length === 0)) {
     return {
       kind: "text",
-      text: "pixeldojo:edit requires at least one reference image. Pass image_url / image_urls (hosted URL) or image_path / image_paths (local file)."
+      text: "pixeldojo_edit requires at least one reference image. Pass image_url / image_urls (hosted URL) or image_path / image_paths (local file)."
     };
   }
   const apiId = resolved.model ?? DEFAULT_MODEL2;
@@ -592,7 +688,7 @@ var init_edit = __esm({
       required: ["prompt"]
     };
     editSkill = {
-      name: "pixeldojo:edit",
+      name: "pixeldojo_edit",
       description: "Edit an existing image with a text instruction. Defaults to wan-2.7-image-edit; pass `model` to pick another edit-capable apiId. Supports up to 9 reference images for multi-image composition. For reference images: pass image_url(s) for hosted URLs or image_path(s) for absolute local file paths (skill uploads to 24h temp storage automatically).",
       inputZod: InputSchema2,
       inputJsonSchema: InputJsonSchema2,
@@ -607,14 +703,14 @@ async function run3(input, ctx) {
   if (!ALLOWED.includes(requested)) {
     return {
       kind: "text",
-      text: `Unknown model "${requested}" for pixeldojo:character. Allowed: ${ALLOWED.join(", ")}.`
+      text: `Unknown model "${requested}" for pixeldojo_character. Allowed: ${ALLOWED.join(", ")}.`
     };
   }
   const apiId = requested;
   if (REQUIRES_REFERENCE.has(apiId) && !input.reference_image_url) {
     return {
       kind: "text",
-      text: `pixeldojo:character with model="${apiId}" requires reference_image_url (the source image of the character to edit). For generation from a prompt alone, use model="${DEFAULT_MODEL3}".`
+      text: `pixeldojo_character with model="${apiId}" requires reference_image_url (the source image of the character to edit). For generation from a prompt alone, use model="${DEFAULT_MODEL3}".`
     };
   }
   const body = { prompt: input.prompt };
@@ -676,7 +772,7 @@ var init_character = __esm({
       required: ["prompt"]
     };
     characterSkill = {
-      name: "pixeldojo:character",
+      name: "pixeldojo_character",
       description: "Generate or edit consistent characters across shots. Pass a reference_image_url for identity locking (seedream-5 by default).",
       inputZod: InputSchema3,
       inputJsonSchema: InputJsonSchema3,
@@ -691,7 +787,7 @@ async function run4(input, ctx) {
   if (!ALLOWED2.includes(requested)) {
     return {
       kind: "text",
-      text: `Unknown model "${requested}" for pixeldojo:storyboard. Allowed: ${ALLOWED2.join(", ")}.`
+      text: `Unknown model "${requested}" for pixeldojo_storyboard. Allowed: ${ALLOWED2.join(", ")}.`
     };
   }
   const apiId = requested;
@@ -754,7 +850,7 @@ var init_storyboard = __esm({
       required: ["brief"]
     };
     storyboardSkill = {
-      name: "pixeldojo:storyboard",
+      name: "pixeldojo_storyboard",
       description: "Generate a video storyboard preview from a single brief. v1: single-shot preview; multi-shot orchestration coming.",
       inputZod: InputSchema4,
       inputJsonSchema: InputJsonSchema4,
@@ -769,7 +865,7 @@ async function run5(input, ctx) {
   if (!ALLOWED3.includes(requested)) {
     return {
       kind: "text",
-      text: `Unknown model "${requested}" for pixeldojo:upscale. Allowed: ${ALLOWED3.join(", ")}.`
+      text: `Unknown model "${requested}" for pixeldojo_upscale. Allowed: ${ALLOWED3.join(", ")}.`
     };
   }
   const apiId = requested;
@@ -831,7 +927,7 @@ var init_upscale = __esm({
       required: ["image_url"]
     };
     upscaleSkill = {
-      name: "pixeldojo:upscale",
+      name: "pixeldojo_upscale",
       description: "Enhance an image. Magnific (default) supports configurable scale_factor and creativity; face-enhance for portraits.",
       inputZod: InputSchema5,
       inputJsonSchema: InputJsonSchema5,
@@ -909,14 +1005,14 @@ var InputSchema6, InputJsonSchema6, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
 var init_status = __esm({
   "src/skills/status.ts"() {
     InputSchema6 = z.object({
-      jobId: z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo:* skill handoff.")
+      jobId: z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo_* skill handoff.")
     });
     InputJsonSchema6 = {
       type: "object",
       properties: {
         jobId: {
           type: "string",
-          description: "Job id returned from a prior pixeldojo:* skill handoff."
+          description: "Job id returned from a prior pixeldojo_* skill handoff."
         }
       },
       required: ["jobId"]
@@ -924,7 +1020,7 @@ var init_status = __esm({
     STUCK_HINT_MS = 5 * 60 * 1e3;
     ABANDON_HINT_MS = 12 * 60 * 1e3;
     statusSkill = {
-      name: "pixeldojo:status",
+      name: "pixeldojo_status",
       description: "Check the status of a long-running job after a 30s sync handoff. Returns assets when ready, failure reason if failed, or current state if still running.",
       inputZod: InputSchema6,
       inputJsonSchema: InputJsonSchema6,
@@ -969,8 +1065,8 @@ var init_from_url = __esm({
       required: ["url"]
     };
     fromUrlSkill = {
-      name: "pixeldojo:from_url",
-      description: "Extract product info (name, description, images) from any product page URL. Use this as the first step before pixeldojo:campaign / :ad / :lookbook so the agent has structured product data instead of a free-text description.",
+      name: "pixeldojo_from_url",
+      description: "Extract product info (name, description, images) from any product page URL. Use this as the first step before pixeldojo_campaign / :ad / :lookbook so the agent has structured product data instead of a free-text description.",
       inputZod: InputSchema7,
       inputJsonSchema: InputJsonSchema7,
       // No model dispatch — this skill calls a server-side scrape, not a generation.
@@ -1031,7 +1127,7 @@ async function plan(input, ctx) {
       ...sceneLines,
       "",
       `Nothing has been charged yet. Producing renders every shot (roughly 20-25 credits per shot at default engines, charged as each renders) plus a few credits for the soundtrack.`,
-      `Review or edit at ${ctx.baseUrl}/film-studio/${film.id} \u2014 or call pixeldojo:film with {"film_id": "${film.id}", "action": "produce"} to start production.`
+      `Review or edit at ${ctx.baseUrl}/film-studio/${film.id} \u2014 or call pixeldojo_film with {"film_id": "${film.id}", "action": "produce"} to start production.`
     ].join("\n")
   };
 }
@@ -1046,7 +1142,7 @@ async function produce(filmId, ctx) {
   }
   return {
     kind: "text",
-    text: `Production started on "${data.film.title}": ${fired} frame(s) dispatched (each is a normal frame charge; the server's Frame check reviews every one). Poll pixeldojo:film with {"film_id": "${filmId}", "action": "status"} every ~30 seconds \u2014 each poll advances the pipeline.`
+    text: `Production started on "${data.film.title}": ${fired} frame(s) dispatched (each is a normal frame charge; the server's Frame check reviews every one). Poll pixeldojo_film with {"film_id": "${filmId}", "action": "status"} every ~30 seconds \u2014 each poll advances the pipeline.`
   };
 }
 function buildScorePlanBody(film) {
@@ -1175,13 +1271,13 @@ async function run8(input, ctx) {
 var LOOKS, InputSchema8, InputJsonSchema8, shots, count, LOOK_MUSIC, ARC, filmSkill;
 var init_film = __esm({
   "src/skills/film.ts"() {
-    LOOKS = ["live-action", "anime", "3d-animation", "noir", "horror", "sci-fi", "documentary", "western"];
+    LOOKS = ["live-action", "anime", "3d-animation", "noir", "horror", "sci-fi", "documentary", "western", "romance", "romantic-comedy", "comedy"];
     InputSchema8 = z.object({
       idea: z.string().max(2e3).optional().describe("One-to-three sentence film idea. The studio writes the screenplay (free). Provide idea OR script for planning."),
       script: z.string().max(2e4).optional().describe("A full screenplay to plan instead of an idea (sluglines, action lines, dialogue)."),
       look: z.enum(LOOKS).default("live-action").describe("Visual style carried through frames, clips, and soundtrack."),
       aspect: z.enum(["16:9", "9:16"]).default("16:9"),
-      length: z.enum(["30s", "60s", "2-3min"]).default("60s").describe("Target length; drives the shot count (~6/12/24 shots)."),
+      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."),
       action: z.enum(["plan", "produce", "status"]).default("plan").describe("'plan' creates + storyboards (free). 'produce' starts charged generation. 'status' advances production and reports progress; poll it every ~30s until it returns the finished 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."),
@@ -1194,7 +1290,7 @@ var init_film = __esm({
         script: { type: "string", description: "A full screenplay to plan instead of an idea." },
         look: { type: "string", enum: [...LOOKS], description: "Visual style. Default live-action." },
         aspect: { type: "string", enum: ["16:9", "9:16"], description: "Default 16:9." },
-        length: { type: "string", enum: ["30s", "60s", "2-3min"], description: "Target length (~6/12/24 shots). Default 60s." },
+        length: { type: "string", enum: ["30s", "60s", "2-3min", "5min"], description: "Target length (~6/12/24/60 shots). Default 60s." },
         film_id: { type: "string", description: "Existing film id for produce/status." },
         action: { type: "string", enum: ["plan", "produce", "status"], description: "plan (free) | produce (charged) | status (poll every ~30s)." },
         soundtrack: { type: "string", enum: ["scene-synced", "flat", "none"], description: "Default scene-synced." },
@@ -1211,7 +1307,10 @@ var init_film = __esm({
       horror: "sparse horror underscore, low cello drones, dissonant string swells, creeping heartbeat pulse, unsettling quiet",
       "sci-fi": "atmospheric science-fiction score, analog synth pads, deep sub-bass pulses, shimmering arpeggios, vast and cold",
       documentary: "understated documentary score, felt piano, soft string beds, organic percussion textures, reflective and true",
-      western: "cinematic western score, lonely twangy guitar, dusty strings, distant horns, wide-open desert tension"
+      western: "cinematic western score, lonely twangy guitar, dusty strings, distant horns, wide-open desert tension",
+      romance: "tender romantic score, felt piano and warm strings, soft acoustic guitar, intimate and unhurried, gently swelling",
+      "romantic-comedy": "bright romantic-comedy score, plucky ukulele and handclaps, warm brushed drums, sunny and flirtatious",
+      comedy: "playful comedy score, bouncy pizzicato strings, cheeky woodwinds, light percussion hits punctuating the gags"
     };
     ARC = {
       opening: ["establishing the theme", "restrained", "quiet anticipation"],
@@ -1219,7 +1318,7 @@ var init_film = __esm({
       finale: ["climactic", "full arrangement", "emotional peak resolving to stillness"]
     };
     filmSkill = {
-      name: "pixeldojo:film",
+      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. Phased: plan is free and returns a cost estimate; produce starts charged generation; status advances production (poll every ~30s).",
       inputZod: InputSchema8,
       inputJsonSchema: InputJsonSchema8,
@@ -1358,8 +1457,8 @@ var init_ad = __esm({
       // Zod refine; no root-level oneOf (Grok rejects non-object root unions).
     };
     adSkill = {
-      name: "pixeldojo:ad",
-      description: "Marketing Studio: turn any product into a video ad. Pass a product URL (auto-extracted) or product images, pick an ad style (UGC testimonial, unboxing, try-on, showcase, TV spot, and more via GET /api/v1/marketing/presets), optionally add presenter reference images, a location, a hook, and the exact spoken script. Renders with voiceover; returns the video or a statusUrl handoff to poll via pixeldojo:status. Ideal for automated generate-and-post workflows.",
+      name: "pixeldojo_ad",
+      description: "Marketing Studio: turn any product into a video ad. Pass a product URL (auto-extracted) or product images, pick an ad style (UGC testimonial, unboxing, try-on, showcase, TV spot, and more via GET /api/v1/marketing/presets), optionally add presenter reference images, a location, a hook, and the exact spoken script. Renders with voiceover; returns the video or a statusUrl handoff to poll via pixeldojo_status. Ideal for automated generate-and-post workflows.",
       inputZod: InputSchema9,
       inputJsonSchema: InputJsonSchema9,
       // Composition skill — the server routes to the ad engine internally.
@@ -1391,7 +1490,7 @@ async function run10(input, ctx) {
   }
   return {
     kind: "handoff",
-    text: result.message ?? `Campaign ${result.campaignId} queued. Poll via pixeldojo:campaign_status.`,
+    text: result.message ?? `Campaign ${result.campaignId} queued. Poll via pixeldojo_campaign_status.`,
     jobId: result.campaignId,
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
@@ -1444,8 +1543,8 @@ var init_campaign = __esm({
       oneOf: [{ required: ["productUrl"] }, { required: ["product"] }]
     };
     campaignSkill = {
-      name: "pixeldojo:campaign",
-      description: "Generate a coherent product launch package (hero image + N lifestyle variants + optional vertical video) from one URL or product profile. Composes hero / lifestyle / video models server-side; returns assets in one call or a handoff with campaignId to poll via pixeldojo:campaign_status.",
+      name: "pixeldojo_campaign",
+      description: "Generate a coherent product launch package (hero image + N lifestyle variants + optional vertical video) from one URL or product profile. Composes hero / lifestyle / video models server-side; returns assets in one call or a handoff with campaignId to poll via pixeldojo_campaign_status.",
       inputZod: InputSchema10,
       inputJsonSchema: InputJsonSchema10,
       // Composition skill — internal sub-jobs route to per-tool models, no
@@ -1490,21 +1589,21 @@ var InputSchema11, InputJsonSchema11, campaignStatusSkill;
 var init_campaign_status = __esm({
   "src/skills/campaign-status.ts"() {
     InputSchema11 = z.object({
-      campaignId: z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo:campaign handoff.")
+      campaignId: z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo_campaign handoff.")
     });
     InputJsonSchema11 = {
       type: "object",
       properties: {
         campaignId: {
           type: "string",
-          description: "Campaign id returned from a prior pixeldojo:campaign handoff."
+          description: "Campaign id returned from a prior pixeldojo_campaign handoff."
         }
       },
       required: ["campaignId"]
     };
     campaignStatusSkill = {
-      name: "pixeldojo:campaign_status",
-      description: "Poll a campaign by campaignId returned from pixeldojo:campaign. Returns assets when every sub-job is done, or a handoff describing what is still in flight.",
+      name: "pixeldojo_campaign_status",
+      description: "Poll a campaign by campaignId returned from pixeldojo_campaign. Returns assets when every sub-job is done, or a handoff describing what is still in flight.",
       inputZod: InputSchema11,
       inputJsonSchema: InputJsonSchema11,
       allowedModels: [],
@@ -1519,7 +1618,7 @@ async function run12(input, ctx) {
     url = await uploadLocalFile(input.path, ctx.client);
   } catch (err) {
     if (err instanceof SkillUploadError) {
-      return { kind: "text", text: `pixeldojo:upload: ${err.userMessage}` };
+      return { kind: "text", text: `pixeldojo_upload: ${err.userMessage}` };
     }
     throw err;
   }
@@ -1549,7 +1648,7 @@ var init_upload = __esm({
       required: ["path"]
     };
     uploadSkill = {
-      name: "pixeldojo:upload",
+      name: "pixeldojo_upload",
       description: "Upload a local image or video file and get back a public URL you can pass to :generate or :edit as image_url. Use when the user has a reference image on disk (drag-dropped into Claude Code, screenshot, etc.) and you need a URL. Storage auto-expires after 24 hours.",
       inputZod: InputSchema12,
       inputJsonSchema: InputJsonSchema12,
@@ -1564,7 +1663,7 @@ async function run13(input, ctx) {
   if (!ALLOWED4.includes(requested)) {
     return {
       kind: "text",
-      text: `Unknown model "${requested}" for pixeldojo:audio. Allowed: ${ALLOWED4.join(", ")}.`
+      text: `Unknown model "${requested}" for pixeldojo_audio. Allowed: ${ALLOWED4.join(", ")}.`
     };
   }
   const apiId = requested;
@@ -1575,7 +1674,7 @@ async function run13(input, ctx) {
       audioUrls = [...audioUrls, ...uploaded].slice(0, 3);
     } catch (err) {
       if (err instanceof SkillUploadError) {
-        return { kind: "text", text: `pixeldojo:audio (upload): ${err.userMessage}` };
+        return { kind: "text", text: `pixeldojo_audio (upload): ${err.userMessage}` };
       }
       throw err;
     }
@@ -1641,7 +1740,7 @@ var init_audio = __esm({
       required: ["prompt"]
     };
     audioSkill = {
-      name: "pixeldojo:audio",
+      name: "pixeldojo_audio",
       description: "Generate audio: speech, multi-character dialogue, sound effects, and background music from one prompt (Seed Audio 1.0 by default; plain TTS available).",
       inputZod: InputSchema13,
       inputJsonSchema: InputJsonSchema13,
@@ -1661,7 +1760,7 @@ async function run14(input, ctx) {
   if (res.items.length === 0) {
     return {
       kind: "text",
-      text: input.q ? `No library items match "${input.q}". Try a broader query, or omit q to list recent generations.` : "Your library is empty. Generate something with pixeldojo:generate first."
+      text: input.q ? `No library items match "${input.q}". Try a broader query, or omit q to list recent generations.` : "Your library is empty. Generate something with pixeldojo_generate first."
     };
   }
   const lines = res.items.map((it) => {
@@ -1702,8 +1801,8 @@ var init_library = __esm({
       required: []
     };
     librarySkill = {
-      name: "pixeldojo:library",
-      description: "Search your media library: saved My Media items (permanent) and recent API/MCP generations (expire after 24h), newest first. Returns asset URLs to reuse as reference inputs. Keep a result forever with pixeldojo:save.",
+      name: "pixeldojo_library",
+      description: "Search your media library: saved My Media items (permanent) and recent API/MCP generations (expire after 24h), newest first. Returns asset URLs to reuse as reference inputs. Keep a result forever with pixeldojo_save.",
       inputZod: InputSchema14,
       inputJsonSchema: InputJsonSchema14,
       allowedModels: [],
@@ -1723,7 +1822,7 @@ async function run15(input, ctx) {
   return {
     kind: "text",
     text: `Saved to My Media (permanent): ${res.url}
-It will appear at https://pixeldojo.ai/my-images and in pixeldojo:library searches.`
+It will appear at https://pixeldojo.ai/my-images and in pixeldojo_library searches.`
   };
 }
 var InputSchema15, InputJsonSchema15, saveSkill;
@@ -1748,7 +1847,7 @@ var init_save = __esm({
       required: ["url"]
     };
     saveSkill = {
-      name: "pixeldojo:save",
+      name: "pixeldojo_save",
       description: "Save a generated image or video into the user's My Media library permanently. Generation outputs otherwise expire after 24 hours \u2014 call this when the user wants to keep a result.",
       inputZod: InputSchema15,
       inputJsonSchema: InputJsonSchema15,
@@ -1796,7 +1895,7 @@ async function runSave(input, ctx) {
   });
   return {
     kind: "text",
-    text: res.created ? `Saved workflow "${res.name}" (${res.steps} step${res.steps === 1 ? "" : "s"}). Run it with pixeldojo:run_workflow { name: "${res.name}" }.` : `Overwrote workflow "${res.name}" (${res.steps} step${res.steps === 1 ? "" : "s"}).`
+    text: res.created ? `Saved workflow "${res.name}" (${res.steps} step${res.steps === 1 ? "" : "s"}). Run it with pixeldojo_run_workflow { name: "${res.name}" }.` : `Overwrote workflow "${res.name}" (${res.steps} step${res.steps === 1 ? "" : "s"}).`
   };
 }
 async function runList(_input, ctx) {
@@ -1804,7 +1903,7 @@ async function runList(_input, ctx) {
   if (res.count === 0) {
     return {
       kind: "text",
-      text: "No saved workflows yet. Save one with pixeldojo:save_workflow { name, steps: [{ skill, args }] }."
+      text: "No saved workflows yet. Save one with pixeldojo_save_workflow { name, steps: [{ skill, args }] }."
     };
   }
   const lines = res.workflows.map(
@@ -1873,7 +1972,7 @@ async function runWorkflow(input, ctx) {
     } else if (result.kind === "handoff") {
       return {
         kind: "text",
-        text: `Workflow "${workflow.name}" is still on step ${i + 1} (${step.skill}) after an extended wait. Poll with pixeldojo:status { jobId: "${result.jobId}" }, then re-run the workflow once it completes.`
+        text: `Workflow "${workflow.name}" is still on step ${i + 1} (${step.skill}) after an extended wait. Poll with pixeldojo_status { jobId: "${result.jobId}" }, then re-run the workflow once it completes.`
       };
     } else {
       outputs.push(`step ${i + 1} (${step.skill}): done (no asset URL)`);
@@ -1892,7 +1991,7 @@ var init_workflows = __esm({
     init_types();
     WORKFLOW_STEP_EXTRA_BUDGET_MS = 6e4;
     StepSchema = z.object({
-      skill: z.string().regex(/^pixeldojo:(generate|edit|character|storyboard|upscale|audio|upload|from_url)$/, {
+      skill: z.string().regex(/^pixeldojo[:_](generate|edit|character|storyboard|upscale|audio|upload|from_url)$/, {
         message: "Runnable skills only: generate, edit, character, storyboard, upscale, audio, upload, from_url."
       }),
       args: z.record(z.string(), z.unknown()).optional()
@@ -1918,7 +2017,7 @@ var init_workflows = __esm({
       required: ["skill"]
     };
     saveWorkflowSkill = {
-      name: "pixeldojo:save_workflow",
+      name: "pixeldojo_save_workflow",
       description: "Save a named multi-step skill chain (generate \u2192 edit \u2192 upscale \u2026). String args may contain {{input.<key>}} and {{prev}} placeholders. Saving to an existing name overwrites it.",
       inputZod: SaveInputSchema,
       inputJsonSchema: {
@@ -1935,7 +2034,7 @@ var init_workflows = __esm({
       run: runSave
     };
     runWorkflowSkill = {
-      name: "pixeldojo:run_workflow",
+      name: "pixeldojo_run_workflow",
       description: "Run a saved workflow by name. Pass inputs for its {{input.<key>}} placeholders; each step feeds the next via {{prev}}.",
       inputZod: RunInputSchema,
       inputJsonSchema: {
@@ -1951,7 +2050,7 @@ var init_workflows = __esm({
       run: runWorkflow
     };
     listWorkflowsSkill = {
-      name: "pixeldojo:list_workflows",
+      name: "pixeldojo_list_workflows",
       description: "List your saved workflows with step counts and run totals.",
       inputZod: ListInputSchema,
       inputJsonSchema: { type: "object", properties: {}, required: [] },
@@ -1987,7 +2086,8 @@ __export(skills_exports, {
   upscaleSkill: () => upscaleSkill
 });
 function findSkill(name) {
-  return ALL_SKILLS.find((s) => s.name === name);
+  const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
+  return ALL_SKILLS.find((s) => s.name === wanted);
 }
 var ALL_SKILLS;
 var init_skills = __esm({
@@ -2081,7 +2181,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.9.0" ;
+var PACKAGE_VERSION = "0.9.1" ;
 function buildServer(options) {
   if (!options.apiKey) {
     throw new Error(
@@ -2248,19 +2348,19 @@ function printInit() {
       `# Same shape as above.`,
       ``,
       `# 3. Restart your agent. You'll see these tools:`,
-      `#    pixeldojo:generate       Any prompt \u2192 image or video.`,
-      `#    pixeldojo:edit           Change an image with a text instruction.`,
-      `#    pixeldojo:character      Consistent characters across shots.`,
-      `#    pixeldojo:storyboard     Multi-shot scenes from one brief.`,
-      `#    pixeldojo:upscale        Enhance any image.`,
-      `#    pixeldojo:audio          Voices + effects + music in one clip.`,
-      `#    pixeldojo:library        Search your saved media + generations.`,
-      `#    pixeldojo:save           Keep a result in My Media permanently.`,
-      `#    pixeldojo:*_workflow     Save / run / list multi-step chains.`,
-      `#    pixeldojo:upload         Local file \u2192 temp URL for references.`,
-      `#    pixeldojo:from_url       Product URL \u2192 structured product info.`,
-      `#    pixeldojo:campaign*      Product URL \u2192 full launch pack.`,
-      `#    pixeldojo:status         Poll long-running jobs.`,
+      `#    pixeldojo_generate       Any prompt \u2192 image or video.`,
+      `#    pixeldojo_edit           Change an image with a text instruction.`,
+      `#    pixeldojo_character      Consistent characters across shots.`,
+      `#    pixeldojo_storyboard     Multi-shot scenes from one brief.`,
+      `#    pixeldojo_upscale        Enhance any image.`,
+      `#    pixeldojo_audio          Voices + effects + music in one clip.`,
+      `#    pixeldojo_library        Search your saved media + generations.`,
+      `#    pixeldojo_save           Keep a result in My Media permanently.`,
+      `#    pixeldojo_*_workflow     Save / run / list multi-step chains.`,
+      `#    pixeldojo_upload         Local file \u2192 temp URL for references.`,
+      `#    pixeldojo_from_url       Product URL \u2192 structured product info.`,
+      `#    pixeldojo_campaign*      Product URL \u2192 full launch pack.`,
+      `#    pixeldojo_status         Poll long-running jobs.`,
       ``
     ].join("\n")
   );