@pixeldojo/mcp 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -95,7 +95,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
   };
@@ -185,18 +185,23 @@ var init_upload_helpers = __esm({
 });
 
 // src/skills/schema-snap.ts
-function getFieldConstraints(apiId, client) {
+function getModelInfo(apiId, client) {
   const cached = schemaCache.get(apiId);
   if (cached) return cached;
-  const pending = Promise.resolve().then(() => client.getModelSchema(apiId)).then(
-    (res) => res.schema?.properties ?? {}
-  ).catch(() => {
+  if (typeof client?.getModelSchema !== "function") return Promise.resolve(null);
+  const pending = Promise.resolve().then(() => client.getModelSchema(apiId)).then((res) => {
+    const body = res;
+    return { props: body.schema?.properties ?? {}, media: body.media };
+  }).catch(() => {
     schemaCache.delete(apiId);
     return null;
   });
   schemaCache.set(apiId, pending);
   return pending;
 }
+async function getFieldConstraints(apiId, client) {
+  return (await getModelInfo(apiId, client))?.props ?? null;
+}
 function parseAspectRatio(ar) {
   const m = /^\s*(\d+)\s*:\s*(\d+)\s*$/.exec(ar);
   if (!m) return null;
@@ -232,6 +237,55 @@ async function snapAspectRatio(apiId, requested, client, opts = {}) {
   if (!field.enum || field.enum.length === 0) return requested;
   return nearestAspectFromEnum(requested, field.enum);
 }
+async function resolveMediaSlot(apiId, kind, client) {
+  const info = await getModelInfo(apiId, client);
+  if (info === null) return void 0;
+  const declared = info.media?.[kind];
+  if (declared) {
+    return {
+      name: declared.key,
+      isArray: info.props[declared.key]?.type === "array",
+      also: declared.also
+    };
+  }
+  if (info.media && kind !== "audio") return null;
+  for (const name of FALLBACK_KEYS[kind]) {
+    const field = info.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);
@@ -256,24 +310,49 @@ async function snapDuration(apiId, requested, client, opts = {}) {
   }
   return requested;
 }
+function isVideoUrl(url) {
+  return /\.(mp4|mov|webm|m4v)(?:[?#]|$)/i.test(url);
+}
+function isAudioUrl(url) {
+  return /\.(mp3|wav|m4a|aac|ogg|flac)(?:[?#]|$)/i.test(url);
+}
 async function resolveImageRefs(apiId, urls, client) {
   if (urls.length === 0) return null;
-  const props = await getFieldConstraints(apiId, client);
-  if (props === null) return null;
-  const key = REF_KEYS.find((k) => props[k] !== void 0);
+  const info = await getModelInfo(apiId, client);
+  if (info === null) return null;
+  const props = info.props;
+  const key = info.media ? info.media.image?.key : REF_KEYS.find((k) => props[k] !== void 0);
   if (!key) return null;
-  const field = props[key];
+  const also = info.media?.image?.also;
+  const field = props[key] ?? {};
   if (field.type === "array") {
     const cap = typeof field.maxItems === "number" ? field.maxItems : urls.length;
     const kept = urls.slice(0, Math.max(1, cap));
-    return { key, value: kept, dropped: urls.length - kept.length };
+    return { key, value: kept, dropped: urls.length - kept.length, also };
   }
-  return { key, value: urls[0], dropped: urls.length - 1 };
+  return { key, value: urls[0], dropped: urls.length - 1, also };
 }
-var schemaCache, REF_KEYS;
+var schemaCache, REFERENCE_FIELD_PRIORITY, FALLBACK_KEYS, 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"
+    ];
+    FALLBACK_KEYS = {
+      image: REFERENCE_FIELD_PRIORITY,
+      video: ["reference_videos"],
+      audio: ["reference_audios", "audio_url"]
+    };
     REF_KEYS = [
       "image_urls",
       "images",
@@ -286,7 +365,51 @@ var init_schema_snap = __esm({
     ];
   }
 });
-function buildPayload(apiId, input) {
+function paramsWithoutModel(params, model) {
+  if (!params || Object.keys(params).length === 0) return null;
+  if (model) return null;
+  return "Those settings are model-specific. Tell me which model to use and I will apply them.";
+}
+function applyParams(body, params, paramsModel, apiId) {
+  if (!params || Object.keys(params).length === 0) return void 0;
+  if (paramsModel !== apiId) {
+    return `This ran on ${apiId}, so I left those settings off: they are ${paramsModel}'s fields. Ask again naming ${apiId} if you want them applied.`;
+  }
+  const rest = { ...params };
+  delete rest.prompt;
+  Object.assign(body, rest);
+  return "prompt" in params ? "I kept the prompt from the skill call and ignored the one in params." : void 0;
+}
+function prefixNote(result, note) {
+  if (!note) return result;
+  return { ...result, text: `${note} ${result.text}`.trim() };
+}
+var ParamsInput, PARAMS_JSON_SCHEMA;
+var init_params = __esm({
+  "src/skills/params.ts"() {
+    ParamsInput = zod.z.record(zod.z.unknown()).optional();
+    PARAMS_JSON_SCHEMA = {
+      type: "object",
+      additionalProperties: true,
+      description: 'Advanced settings for the model that runs this, named exactly as that model documents them (e.g. {"resolution": "1080p", "seed": 42}). Set `model` in the same call: field names differ per model, so params without one are refused. Applied last, so these override anything derived from the other inputs. An invalid field comes back named with its allowed values and nothing is charged, so fix it and call again.'
+    };
+  }
+});
+function fallbackSlot(apiId, kind) {
+  return apiId === VIDEO_REFERENCE_MODEL ? VIDEO_REFERENCE_SLOTS[kind] : void 0;
+}
+function sourceMedia(videoUrl, referenceUrls) {
+  const clip = videoUrl && !isAudioUrl(videoUrl) ? videoUrl : void 0;
+  const stills = referenceUrls.filter((u) => !isAudioUrl(u));
+  const url = clip ?? stills[0];
+  return {
+    url,
+    isClip: Boolean(clip) || !!url && isVideoUrl(url),
+    audioUrl: [videoUrl, ...referenceUrls].find((u) => u && isAudioUrl(u)),
+    stills
+  };
+}
+function buildPayload(apiId, input, src, slot, audioSlot) {
   const body = { prompt: input.prompt };
   if (input.aspect_ratio) body.aspect_ratio = input.aspect_ratio;
   if (input.preset) body.preset = input.preset;
@@ -294,9 +417,9 @@ function buildPayload(apiId, input) {
     case "grok-video-extend":
     case "wan-video-edit":
     case "seedance-video-edit":
-      if (input.image_url) {
-        body.video_url = input.image_url;
-        body.image_url = input.image_url;
+      if (src.url) {
+        body.video_url = src.url;
+        body.image_url = src.url;
       }
       if (input.duration !== void 0) {
         body.video_duration = input.duration;
@@ -304,48 +427,90 @@ function buildPayload(apiId, input) {
       }
       break;
     default:
-      if (input.image_url) body.image_url = input.image_url;
+      if (src.url) {
+        const refs = src.isClip ? [src.url] : src.stills.length > 0 ? src.stills : [src.url];
+        if (slot) {
+          body[slot.name] = slot.isArray ? refs : refs[0];
+          if (slot.also) Object.assign(body, slot.also);
+        } else {
+          body.image_url = refs[0];
+        }
+      }
+      if (src.audioUrl && audioSlot) {
+        body[audioSlot.name] = audioSlot.isArray ? [src.audioUrl] : src.audioUrl;
+        if (audioSlot.also) Object.assign(body, audioSlot.also);
+      }
       if (input.duration !== void 0) body.duration = input.duration;
+      if (input.resolution) body.resolution = input.resolution;
       break;
   }
   return body;
 }
 async function run(input, ctx) {
-  const apiId = input.model ?? DEFAULT_MODEL;
+  const paramsGate = paramsWithoutModel(input.params, input.model);
+  if (paramsGate) return { kind: "text", text: paramsGate };
   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;
+  }
+  const src = sourceMedia(input.video_url, referenceUrls);
+  let apiId = input.model ?? DEFAULT_MODEL;
+  let routeNote;
+  if ((src.isClip || src.audioUrl) && !VIDEO_INPUT_MODELS.has(apiId)) {
+    if (!input.model) {
+      apiId = VIDEO_REFERENCE_MODEL;
+    } else if (src.isClip && await resolveMediaSlot(input.model, "video", ctx.client) === null) {
+      apiId = VIDEO_REFERENCE_MODEL;
+      routeNote = `${input.model} can't work from a video clip, so I used ${VIDEO_REFERENCE_MODEL} instead.`;
     }
   }
   if (apiId === "grok-video-extend") {
-    if (!resolved.image_url) {
+    if (!src.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 video_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;
+  let audioSlot;
   if (!VIDEO_INPUT_MODELS.has(apiId)) {
-    const [aspect_ratio, duration] = await Promise.all([
+    const [aspect_ratio, duration, resolution, ref, audio] = 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),
+      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 };
+    resolved = { ...resolved, aspect_ratio, duration, resolution };
+    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);
+  const body = buildPayload(apiId, resolved, src, refField, audioSlot);
+  const paramsNote = applyParams(body, input.params, input.model, apiId);
+  const note = [routeNote, paramsNote].filter(Boolean).join(" ");
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -356,18 +521,22 @@ async function run(input, ctx) {
       sleep: ctx.pollOverrides?.sleep
     }
   );
-  return pollResultToSkillResult(
-    result,
-    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : urls.length === 1 ? `Generated. Asset: ${urls[0]}` : `Generated ${urls.length} assets. URLs: ${urls.join(", ")}`
+  return prefixNote(
+    pollResultToSkillResult(
+      result,
+      (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : urls.length === 1 ? `Generated. Asset: ${urls[0]}` : `Generated ${urls.length} assets. URLs: ${urls.join(", ")}`
+    ),
+    note
   );
 }
-var InputSchema, DEFAULT_MODEL, VIDEO_INPUT_MODELS, InputJsonSchema, generateSkill;
+var InputSchema, DEFAULT_MODEL, VIDEO_REFERENCE_MODEL, VIDEO_REFERENCE_SLOTS, VIDEO_INPUT_MODELS, InputJsonSchema, generateSkill;
 var init_generate = __esm({
   "src/skills/generate.ts"() {
     init_poll();
     init_types();
     init_upload_helpers();
     init_schema_snap();
+    init_params();
     InputSchema = zod.z.object({
       prompt: zod.z.string().min(1).max(8e3).describe("Prompt describing what to generate."),
       model: zod.z.string().optional().describe(
@@ -378,12 +547,31 @@ var init_generate = __esm({
       ),
       aspect_ratio: zod.z.string().optional().describe('Aspect ratio supported by the chosen model (e.g. "1:1", "16:9", "9:16").'),
       duration: zod.z.number().int().positive().optional().describe("Video duration in seconds, when applicable."),
+      resolution: zod.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: zod.z.string().url().optional().describe("Reference image URL for image-to-image / image-to-video tools."),
+      video_url: zod.z.string().url().optional().describe(
+        "Source video clip to animate / restyle / extend. Use this for videos; image_url is for still frames. A clip routes to a model that can actually read one."
+      ),
+      params: ParamsInput,
       image_path: zod.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: zod.z.array(zod.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: zod.z.array(zod.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";
+    VIDEO_REFERENCE_MODEL = "seedance-2-reference";
+    VIDEO_REFERENCE_SLOTS = {
+      image: { name: "reference_images", isArray: true },
+      video: { name: "reference_videos", isArray: true },
+      audio: { name: "reference_audios", isArray: true }
+    };
     VIDEO_INPUT_MODELS = /* @__PURE__ */ new Set(["grok-video-extend", "wan-video-edit", "seedance-video-edit"]);
     InputJsonSchema = {
       type: "object",
@@ -399,7 +587,27 @@ 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" },
+        video_url: {
+          type: "string",
+          format: "uri",
+          description: "Source video clip to animate / restyle / extend. Use this for videos; image_url is for still frames."
+        },
+        params: PARAMS_JSON_SCHEMA,
+        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."
@@ -408,8 +616,8 @@ var init_generate = __esm({
       required: ["prompt"]
     };
     generateSkill = {
-      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.",
+      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 flows: pass `image_url` for a still, `video_url` for a source clip, or `image_path` (absolute local path) and the skill uploads it to 24h temp storage automatically. A clip or an audio reference routes to an engine that can read one. Model-specific settings go in `params` alongside an explicit `model`.",
       inputZod: InputSchema,
       inputJsonSchema: InputJsonSchema,
       allowedModels: null,
@@ -476,9 +684,12 @@ async function buildBody(apiId, input, ctx) {
   }
   body.prompt = input.prompt;
   body[refs.key] = refs.value;
+  if (refs.also) Object.assign(body, refs.also);
   return { body, dropped: refs.dropped };
 }
 async function run2(input, ctx) {
+  const paramsGate = paramsWithoutModel(input.params, input.model);
+  if (paramsGate) return { kind: "text", text: paramsGate };
   let resolved = input;
   try {
     if (input.image_paths && input.image_paths.length > 0) {
@@ -493,14 +704,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;
@@ -510,6 +721,7 @@ async function run2(input, ctx) {
   };
   const { body, dropped } = await buildBody(apiId, resolved, ctx);
   const droppedNote = dropped > 0 ? ` (${dropped} reference${dropped === 1 ? "" : "s"} dropped \u2014 ${apiId} accepts fewer)` : "";
+  const paramsNote = applyParams(body, input.params, input.model, apiId);
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -520,9 +732,12 @@ async function run2(input, ctx) {
       sleep: ctx.pollOverrides?.sleep
     }
   );
-  return pollResultToSkillResult(
-    result,
-    (urls) => urls.length === 0 ? `Edit job ${submitted.jobId} completed but returned no assets.` : urls.length === 1 ? `Edit complete${droppedNote}. Asset: ${urls[0]}` : `Edit produced ${urls.length} assets${droppedNote}. URLs: ${urls.join(", ")}`
+  return prefixNote(
+    pollResultToSkillResult(
+      result,
+      (urls) => urls.length === 0 ? `Edit job ${submitted.jobId} completed but returned no assets.` : urls.length === 1 ? `Edit complete${droppedNote}. Asset: ${urls[0]}` : `Edit produced ${urls.length} assets${droppedNote}. URLs: ${urls.join(", ")}`
+    ),
+    paramsNote
   );
 }
 var DEFAULT_MODEL2, ALLOWED_MODELS, InputSchema2, InputJsonSchema2, editSkill;
@@ -532,6 +747,7 @@ var init_edit = __esm({
     init_types();
     init_upload_helpers();
     init_schema_snap();
+    init_params();
     DEFAULT_MODEL2 = "wan-2.7-image-edit";
     ALLOWED_MODELS = [
       "wan-2.7-image-edit",
@@ -555,7 +771,8 @@ var init_edit = __esm({
       model: zod.z.enum(ALLOWED_MODELS).optional().describe(
         "Override the default edit model. Defaults to wan-2.7-image-edit (most popular)."
       ),
-      aspect_ratio: zod.z.string().optional().describe('Aspect ratio when supported (e.g. "1:1", "16:9", "match_input_image").')
+      aspect_ratio: zod.z.string().optional().describe('Aspect ratio when supported (e.g. "1:1", "16:9", "match_input_image").'),
+      params: ParamsInput
     });
     InputJsonSchema2 = {
       type: "object",
@@ -589,12 +806,13 @@ var init_edit = __esm({
           enum: [...ALLOWED_MODELS],
           description: "Override edit model. Default: wan-2.7-image-edit."
         },
-        aspect_ratio: { type: "string" }
+        aspect_ratio: { type: "string" },
+        params: PARAMS_JSON_SCHEMA
       },
       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,
@@ -605,32 +823,50 @@ var init_edit = __esm({
   }
 });
 async function run3(input, ctx) {
+  const paramsGate = paramsWithoutModel(input.params, input.model);
+  if (paramsGate) return { kind: "text", text: paramsGate };
   const requested = input.model ?? DEFAULT_MODEL3;
   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) {
+  const refUrls = (input.reference_image_urls && input.reference_image_urls.length > 0 ? input.reference_image_urls : input.reference_image_url ? [input.reference_image_url] : []).filter((u, i, all) => all.indexOf(u) === i);
+  const wrongKind = refUrls.find((u) => isVideoUrl(u) || isAudioUrl(u));
+  if (wrongKind) {
+    return {
+      kind: "text",
+      text: `pixeldojo_character works on still images, and ${wrongKind} is not one. Use pixeldojo_generate or pixeldojo_storyboard with video_url to work from a clip (or image_url for an audio track \u2014 they route to the reference engine). For this treatment, give me a still frame.`
+    };
+  }
+  if (REQUIRES_REFERENCE.has(apiId) && refUrls.length === 0) {
     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 a reference image (reference_image_url / reference_image_urls \u2014 the source image of the character to edit). For generation from a prompt alone, use model="${DEFAULT_MODEL3}".`
     };
   }
   const body = { prompt: input.prompt };
-  if (input.reference_image_url) {
-    if (apiId === "flux-edit") {
-      body.input_image = input.reference_image_url;
+  let dropped = 0;
+  if (refUrls.length > 0) {
+    const refs = await resolveImageRefs(apiId, refUrls, ctx.client);
+    if (refs) {
+      body[refs.key] = refs.value;
+      if (refs.also) Object.assign(body, refs.also);
+      dropped = refs.dropped;
     } else {
-      body.image_urls = [input.reference_image_url];
+      body[FALLBACK_REF_KEY[apiId]] = refUrls;
     }
   }
   const snappedAspect = await snapAspectRatio(apiId, input.aspect_ratio, ctx.client, {
     onUnknown: "omit"
   });
   if (snappedAspect !== void 0) body.aspect_ratio = snappedAspect;
+  const note = [
+    dropped > 0 ? `${dropped} reference${dropped === 1 ? "" : "s"} dropped \u2014 ${apiId} accepts fewer.` : void 0,
+    applyParams(body, input.params, input.model, apiId)
+  ].filter(Boolean).join(" ");
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -641,27 +877,49 @@ async function run3(input, ctx) {
       sleep: ctx.pollOverrides?.sleep
     }
   );
-  return pollResultToSkillResult(
-    result,
-    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Character shot ready. Asset: ${urls[0]}`
+  return prefixNote(
+    pollResultToSkillResult(
+      result,
+      (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Character shot ready. Asset: ${urls[0]}`
+    ),
+    note
   );
 }
-var ALLOWED, DEFAULT_MODEL3, REQUIRES_REFERENCE, InputSchema3, InputJsonSchema3, characterSkill;
+var ALLOWED, DEFAULT_MODEL3, MAX_REFERENCES, REQUIRES_REFERENCE, FALLBACK_REF_KEY, InputSchema3, InputJsonSchema3, characterSkill;
 var init_character = __esm({
   "src/skills/character.ts"() {
     init_poll();
     init_types();
     init_schema_snap();
-    ALLOWED = ["seedream-5", "seedream-4", "flux-edit", "gpt-image-2-edit"];
+    init_params();
+    ALLOWED = [
+      "seedream-5",
+      "seedream-4",
+      "google-nano-banana",
+      "wan-2.7-image-edit",
+      "qwen-image-2.0-pro"
+    ];
     DEFAULT_MODEL3 = "seedream-5";
-    REQUIRES_REFERENCE = /* @__PURE__ */ new Set(["flux-edit", "gpt-image-2-edit"]);
+    MAX_REFERENCES = 9;
+    REQUIRES_REFERENCE = /* @__PURE__ */ new Set(["wan-2.7-image-edit"]);
+    FALLBACK_REF_KEY = {
+      "seedream-5": "image_urls",
+      "seedream-4": "image_urls",
+      "google-nano-banana": "image_input",
+      "wan-2.7-image-edit": "image_urls",
+      "qwen-image-2.0-pro": "reference_images"
+    };
     InputSchema3 = zod.z.object({
       prompt: zod.z.string().min(1).max(8e3),
       model: zod.z.string().optional().describe(`One of: ${ALLOWED.join(", ")}. Defaults to ${DEFAULT_MODEL3}.`),
       reference_image_url: zod.z.string().url().optional().describe(
-        "Reference image of the character. Required by flux-edit and gpt-image-2-edit; optional for seedream-5/seedream-4."
+        "Single reference image of the character. Prefer reference_image_urls \u2014 more angles lock the face better."
       ),
-      aspect_ratio: zod.z.string().optional().describe('Only honored for model="flux-edit".')
+      reference_image_urls: zod.z.array(zod.z.string().url()).min(1).max(MAX_REFERENCES).optional().describe(
+        `All references for this shot (1-${MAX_REFERENCES}), most important first. Multiple angles of the same person lock the face far better than one photo. Models that take fewer are clamped to their own cap.`
+      ),
+      aspect_ratio: zod.z.string().optional().describe("Honored where the model declares the field."),
+      params: ParamsInput
     });
     InputJsonSchema3 = {
       type: "object",
@@ -672,14 +930,26 @@ var init_character = __esm({
           enum: ALLOWED,
           description: `One of: ${ALLOWED.join(", ")}. Defaults to ${DEFAULT_MODEL3}.`
         },
-        reference_image_url: { type: "string", format: "uri" },
-        aspect_ratio: { type: "string" }
+        reference_image_url: {
+          type: "string",
+          format: "uri",
+          description: "Single reference. Prefer reference_image_urls."
+        },
+        reference_image_urls: {
+          type: "array",
+          items: { type: "string", format: "uri" },
+          minItems: 1,
+          maxItems: MAX_REFERENCES,
+          description: "All references for this shot, most important first. Multiple angles of the same person lock the face far better than one photo."
+        },
+        aspect_ratio: { type: "string" },
+        params: PARAMS_JSON_SCHEMA
       },
       required: ["prompt"]
     };
     characterSkill = {
-      name: "pixeldojo:character",
-      description: "Generate or edit consistent characters across shots. Pass a reference_image_url for identity locking (seedream-5 by default).",
+      name: "pixeldojo_character",
+      description: "Generate or edit consistent characters across shots. Pass reference_image_urls (up to 9) to lock identity \u2014 send every photo of the person you have, since more angles hold the face far better than one. Defaults to seedream-5.",
       inputZod: InputSchema3,
       inputJsonSchema: InputJsonSchema3,
       allowedModels: [...ALLOWED],
@@ -689,13 +959,29 @@ var init_character = __esm({
   }
 });
 async function run4(input, ctx) {
+  const paramsGate = paramsWithoutModel(input.params, input.model);
+  if (paramsGate) return { kind: "text", text: paramsGate };
   const requested = input.model ?? DEFAULT_MODEL4;
   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(", ")}.`
     };
   }
+  if (input.image_url || input.video_url) {
+    return generateSkill.run(
+      {
+        prompt: input.brief,
+        model: input.model ?? VIDEO_REFERENCE_MODEL,
+        image_url: input.image_url,
+        video_url: input.video_url,
+        aspect_ratio: input.aspect_ratio,
+        duration: input.duration,
+        params: input.params
+      },
+      ctx
+    );
+  }
   const apiId = requested;
   const [snappedAspect, snappedDuration] = await Promise.all([
     snapAspectRatio(apiId, input.aspect_ratio, ctx.client),
@@ -704,6 +990,7 @@ async function run4(input, ctx) {
   const body = { prompt: input.brief };
   if (snappedAspect !== void 0) body.aspect_ratio = snappedAspect;
   if (snappedDuration !== void 0) body.duration = snappedDuration;
+  const note = applyParams(body, input.params, input.model, apiId);
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -714,9 +1001,12 @@ async function run4(input, ctx) {
       sleep: ctx.pollOverrides?.sleep
     }
   );
-  return pollResultToSkillResult(
-    result,
-    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Storyboard preview ready. Asset: ${urls[0]}`
+  return prefixNote(
+    pollResultToSkillResult(
+      result,
+      (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Storyboard preview ready. Asset: ${urls[0]}`
+    ),
+    note
   );
 }
 var ALLOWED2, DEFAULT_MODEL4, InputSchema4, InputJsonSchema4, storyboardSkill;
@@ -725,18 +1015,24 @@ var init_storyboard = __esm({
     init_poll();
     init_types();
     init_schema_snap();
+    init_generate();
+    init_params();
     ALLOWED2 = [
       "veo-3.1-fast",
       "veo-3.1-standard",
       "kling-video-v3-standard-text",
-      "seedance-2-high"
+      "seedance-2-high",
+      VIDEO_REFERENCE_MODEL
     ];
     DEFAULT_MODEL4 = "veo-3.1-fast";
     InputSchema4 = zod.z.object({
       brief: zod.z.string().min(1).max(8e3).describe("Storyboard brief: scene, shots, mood, action."),
       model: zod.z.string().optional().describe(`One of: ${ALLOWED2.join(", ")}. Defaults to ${DEFAULT_MODEL4}.`),
       aspect_ratio: zod.z.string().optional(),
-      duration: zod.z.number().int().positive().optional()
+      duration: zod.z.number().int().positive().optional(),
+      image_url: zod.z.string().url().optional().describe("Reference still to build the shot from (character, product, location)."),
+      video_url: zod.z.string().url().optional().describe("Source clip to work from. Use this for videos; image_url is for still frames."),
+      params: ParamsInput
     });
     InputJsonSchema4 = {
       type: "object",
@@ -751,13 +1047,24 @@ var init_storyboard = __esm({
           description: `One of: ${ALLOWED2.join(", ")}. Defaults to ${DEFAULT_MODEL4}.`
         },
         aspect_ratio: { type: "string" },
-        duration: { type: "integer" }
+        duration: { type: "integer" },
+        image_url: {
+          type: "string",
+          format: "uri",
+          description: "Reference still to build the shot from."
+        },
+        video_url: {
+          type: "string",
+          format: "uri",
+          description: "Source clip to work from. Use this for videos; image_url is for stills."
+        },
+        params: PARAMS_JSON_SCHEMA
       },
       required: ["brief"]
     };
     storyboardSkill = {
-      name: "pixeldojo:storyboard",
-      description: "Generate a video storyboard preview from a single brief. v1: single-shot preview; multi-shot orchestration coming.",
+      name: "pixeldojo_storyboard",
+      description: "Generate a video storyboard preview from a single brief. Pass image_url for a reference still or video_url for a source clip. v1: single-shot preview; multi-shot orchestration coming.",
       inputZod: InputSchema4,
       inputJsonSchema: InputJsonSchema4,
       allowedModels: [...ALLOWED2],
@@ -771,7 +1078,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;
@@ -833,7 +1140,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,
@@ -911,14 +1218,14 @@ var InputSchema6, InputJsonSchema6, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
 var init_status = __esm({
   "src/skills/status.ts"() {
     InputSchema6 = zod.z.object({
-      jobId: zod.z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo:* skill handoff.")
+      jobId: zod.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"]
@@ -926,7 +1233,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,
@@ -971,8 +1278,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.
@@ -1033,7 +1340,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")
   };
 }
@@ -1048,7 +1355,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) {
@@ -1177,13 +1484,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 = zod.z.object({
       idea: zod.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: zod.z.string().max(2e4).optional().describe("A full screenplay to plan instead of an idea (sluglines, action lines, dialogue)."),
       look: zod.z.enum(LOOKS).default("live-action").describe("Visual style carried through frames, clips, and soundtrack."),
       aspect: zod.z.enum(["16:9", "9:16"]).default("16:9"),
-      length: zod.z.enum(["30s", "60s", "2-3min"]).default("60s").describe("Target length; drives the shot count (~6/12/24 shots)."),
+      length: zod.z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length; drives the shot count (~6/12/24/60 shots)."),
       film_id: zod.z.string().max(40).optional().describe("Existing film id (from a previous call) for produce/status."),
       action: zod.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: zod.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."),
@@ -1196,7 +1503,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." },
@@ -1213,7 +1520,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"],
@@ -1221,7 +1531,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,
@@ -1360,8 +1670,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.
@@ -1393,7 +1703,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)
   };
@@ -1446,8 +1756,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
@@ -1492,21 +1802,21 @@ var InputSchema11, InputJsonSchema11, campaignStatusSkill;
 var init_campaign_status = __esm({
   "src/skills/campaign-status.ts"() {
     InputSchema11 = zod.z.object({
-      campaignId: zod.z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo:campaign handoff.")
+      campaignId: zod.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: [],
@@ -1521,7 +1831,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;
   }
@@ -1551,7 +1861,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,
@@ -1566,7 +1876,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;
@@ -1577,7 +1887,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;
     }
@@ -1643,7 +1953,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,
@@ -1663,7 +1973,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) => {
@@ -1704,8 +2014,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: [],
@@ -1725,7 +2035,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;
@@ -1750,7 +2060,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,
@@ -1798,7 +2108,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) {
@@ -1806,7 +2116,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(
@@ -1875,7 +2185,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)`);
@@ -1894,7 +2204,7 @@ var init_workflows = __esm({
     init_types();
     WORKFLOW_STEP_EXTRA_BUDGET_MS = 6e4;
     StepSchema = zod.z.object({
-      skill: zod.z.string().regex(/^pixeldojo:(generate|edit|character|storyboard|upscale|audio|upload|from_url)$/, {
+      skill: zod.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: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
@@ -1920,7 +2230,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: {
@@ -1937,7 +2247,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: {
@@ -1953,7 +2263,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: [] },
@@ -1989,7 +2299,8 @@ __export(skills_exports, {
   upscaleSkill: () => upscaleSkill
 });
 function findSkill(name) {
-  return exports.ALL_SKILLS.find((s) => s.name === name);
+  const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
+  return exports.ALL_SKILLS.find((s) => s.name === wanted);
 }
 exports.ALL_SKILLS = void 0;
 var init_skills = __esm({
@@ -2083,7 +2394,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.9.0" ;
+var PACKAGE_VERSION = "0.10.0" ;
 function buildServer(options) {
   if (!options.apiKey) {
     throw new Error(