@pixeldojo/mcp 0.2.1 → 0.4.0

package/dist/index.cjs

@@ -1,31 +1,24 @@
 'use strict';
 
+var promises = require('fs/promises');
+var path = require('path');
+var zod = require('zod');
 var index_js = require('@modelcontextprotocol/sdk/server/index.js');
 var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
 var types_js = require('@modelcontextprotocol/sdk/types.js');
 var sdk = require('@pixeldojo/sdk');
-var zod = require('zod');
 
-// src/server.ts
-function makeAttributedClient(options) {
-  const { mcpVersion, skillName, baseFetch, ...sdkOptions } = options;
-  const real = baseFetch ?? globalThis.fetch.bind(globalThis);
-  const wrappedFetch = (input, init) => {
-    const headers = new Headers(init?.headers);
-    headers.set("x-pixeldojo-source", `mcp/${mcpVersion}`);
-    if (skillName) headers.set("x-pixeldojo-skill", skillName);
-    return real(input, { ...init, headers });
-  };
-  return new sdk.PixelDojoClient({
-    ...sdkOptions,
-    fetch: wrappedFetch
-  });
-}
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/poll.ts
-var DEFAULT_BACKOFF = [1e3, 2e3, 4e3, 8e3];
-var DEFAULT_MAX_INTERVAL = 8e3;
-var DEFAULT_SYNC_BUDGET_MS = 3e4;
 function defaultSleep(ms, signal) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) {
@@ -74,6 +67,14 @@ async function pollJobUntilDoneOrHandoff(jobId, fetchJob, buildStatusUrl, option
     attempt++;
   }
 }
+var DEFAULT_BACKOFF, DEFAULT_MAX_INTERVAL, DEFAULT_SYNC_BUDGET_MS;
+var init_poll = __esm({
+  "src/poll.ts"() {
+    DEFAULT_BACKOFF = [1e3, 2e3, 4e3, 8e3];
+    DEFAULT_MAX_INTERVAL = 8e3;
+    DEFAULT_SYNC_BUDGET_MS = 3e4;
+  }
+});
 
 // src/skills/types.ts
 function pollResultToSkillResult(result, successText) {
@@ -108,46 +109,133 @@ function extractAssetUrls(job) {
   if (output?.video) return [output.video];
   return [];
 }
-
-// src/skills/generate.ts
-var InputSchema = zod.z.object({
-  prompt: zod.z.string().min(1).max(8e3).describe("Prompt describing what to generate."),
-  model: zod.z.string().optional().describe(
-    'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
-  ),
-  preset: zod.z.string().optional().describe(
-    'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean", "magazine-cover-text"). Browse the catalog at https://pixeldojo.ai/presets. Explicit fields override preset values.'
-  ),
-  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."),
-  image_url: zod.z.string().url().optional().describe("Reference image URL for image-to-image / image-to-video tools.")
+var init_types = __esm({
+  "src/skills/types.ts"() {
+  }
 });
-var DEFAULT_MODEL = "google-nano-banana";
-var InputJsonSchema = {
-  type: "object",
-  properties: {
-    prompt: { type: "string", description: "Prompt describing what to generate." },
-    model: {
-      type: "string",
-      description: 'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
-    },
-    preset: {
-      type: "string",
-      description: 'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean"). Explicit fields override preset values.'
-    },
-    aspect_ratio: { type: "string" },
-    duration: { type: "integer" },
-    image_url: { type: "string", format: "uri" }
-  },
-  required: ["prompt"]
-};
-async function run(input, ctx) {
-  const apiId = input.model ?? DEFAULT_MODEL;
+async function uploadLocalFile(path$1, client) {
+  const ext = path.extname(path$1).toLowerCase();
+  const mime = EXT_TO_MIME[ext];
+  if (!mime) {
+    throw new SkillUploadError(
+      `Unsupported file extension "${ext || "(none)"}" for "${path$1}". Allowed: ${Object.keys(EXT_TO_MIME).join(", ")}.`
+    );
+  }
+  let size;
+  try {
+    const info = await promises.stat(path$1);
+    if (!info.isFile()) {
+      throw new SkillUploadError(`"${path$1}" is not a file.`);
+    }
+    size = info.size;
+  } catch (err) {
+    if (err instanceof SkillUploadError) throw err;
+    const code = err?.code;
+    if (code === "ENOENT") {
+      throw new SkillUploadError(
+        `File not found at "${path$1}". Pass an absolute path.`
+      );
+    }
+    throw new SkillUploadError(
+      `Cannot read "${path$1}": ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const isImage = mime.startsWith("image/");
+  const limit = isImage ? MAX_IMAGE_BYTES : MAX_VIDEO_BYTES;
+  if (size > limit) {
+    const gotMB = (size / 1024 / 1024).toFixed(1);
+    const limitMB = (limit / 1024 / 1024).toFixed(0);
+    throw new SkillUploadError(
+      `"${path.basename(path$1)}" is ${gotMB}MB; limit for ${isImage ? "images" : "videos"} is ${limitMB}MB. Downscale or re-encode and try again.`
+    );
+  }
+  const buffer = await promises.readFile(path$1);
+  const blob = new Blob([new Uint8Array(buffer)], { type: mime });
+  const filename = path.basename(path$1);
+  const response = await client.uploadImage(blob, filename);
+  return response.url;
+}
+async function uploadLocalFiles(paths, client) {
+  return Promise.all(paths.map((p) => uploadLocalFile(p, client)));
+}
+var MAX_IMAGE_BYTES, MAX_VIDEO_BYTES, EXT_TO_MIME, SkillUploadError;
+var init_upload_helpers = __esm({
+  "src/skills/upload-helpers.ts"() {
+    MAX_IMAGE_BYTES = 50 * 1024 * 1024;
+    MAX_VIDEO_BYTES = 200 * 1024 * 1024;
+    EXT_TO_MIME = {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".webp": "image/webp",
+      ".gif": "image/gif",
+      ".mp4": "video/mp4",
+      ".webm": "video/webm",
+      ".mov": "video/quicktime"
+    };
+    SkillUploadError = class extends Error {
+      constructor(userMessage) {
+        super(userMessage);
+        this.userMessage = userMessage;
+        this.name = "SkillUploadError";
+      }
+      userMessage;
+    };
+  }
+});
+function buildPayload(apiId, input) {
   const body = { prompt: input.prompt };
   if (input.aspect_ratio) body.aspect_ratio = input.aspect_ratio;
-  if (input.duration !== void 0) body.duration = input.duration;
-  if (input.image_url) body.image_url = input.image_url;
   if (input.preset) body.preset = input.preset;
+  switch (apiId) {
+    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 (input.duration !== void 0) {
+        body.video_duration = input.duration;
+        body.duration = input.duration;
+      }
+      break;
+    default:
+      if (input.image_url) body.image_url = input.image_url;
+      if (input.duration !== void 0) body.duration = input.duration;
+      break;
+  }
+  return body;
+}
+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;
+    }
+  }
+  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).'
+      };
+    }
+    if (resolved.duration === void 0) {
+      return {
+        kind: "text",
+        text: 'pixeldojo:generate with model="grok-video-extend" requires duration (extension length in seconds).'
+      };
+    }
+  }
+  const body = buildPayload(apiId, resolved);
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -163,41 +251,221 @@ async function run(input, ctx) {
     (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(", ")}`
   );
 }
-var 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.",
-  inputZod: InputSchema,
-  inputJsonSchema: InputJsonSchema,
-  allowedModels: null,
-  defaultModel: DEFAULT_MODEL,
-  run
-};
-var ALLOWED = ["ideogram-character", "flux-edit", "gpt-image-2-edit"];
-var DEFAULT_MODEL2 = "ideogram-character";
-var InputSchema2 = zod.z.object({
-  prompt: zod.z.string().min(1).max(8e3),
-  model: zod.z.string().optional().describe(`One of: ${ALLOWED.join(", ")}. Defaults to ${DEFAULT_MODEL2}.`),
-  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 ideogram-character."
-  ),
-  aspect_ratio: zod.z.string().optional()
+var InputSchema, DEFAULT_MODEL, InputJsonSchema, generateSkill;
+var init_generate = __esm({
+  "src/skills/generate.ts"() {
+    init_poll();
+    init_types();
+    init_upload_helpers();
+    InputSchema = zod.z.object({
+      prompt: zod.z.string().min(1).max(8e3).describe("Prompt describing what to generate."),
+      model: zod.z.string().optional().describe(
+        'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
+      ),
+      preset: zod.z.string().optional().describe(
+        'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean", "magazine-cover-text"). Browse the catalog at https://pixeldojo.ai/presets. Explicit fields override preset values.'
+      ),
+      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."),
+      image_url: zod.z.string().url().optional().describe("Reference image URL for image-to-image / image-to-video tools."),
+      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."
+      )
+    });
+    DEFAULT_MODEL = "google-nano-banana";
+    InputJsonSchema = {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Prompt describing what to generate." },
+        model: {
+          type: "string",
+          description: 'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
+        },
+        preset: {
+          type: "string",
+          description: 'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean"). Explicit fields override preset values.'
+        },
+        aspect_ratio: { type: "string" },
+        duration: { type: "integer" },
+        image_url: { type: "string", format: "uri" },
+        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."
+        }
+      },
+      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.",
+      inputZod: InputSchema,
+      inputJsonSchema: InputJsonSchema,
+      allowedModels: null,
+      defaultModel: DEFAULT_MODEL,
+      run
+    };
+  }
 });
-var InputJsonSchema2 = {
-  type: "object",
-  properties: {
-    prompt: { type: "string" },
-    model: {
-      type: "string",
-      enum: ALLOWED,
-      description: `One of: ${ALLOWED.join(", ")}. Defaults to ${DEFAULT_MODEL2}.`
-    },
-    reference_image_url: { type: "string", format: "uri" },
-    aspect_ratio: { type: "string" }
-  },
-  required: ["prompt"]
-};
+function buildPayload2(apiId, input) {
+  const urls = input.image_urls && input.image_urls.length > 0 ? input.image_urls : input.image_url ? [input.image_url] : [];
+  switch (apiId) {
+    case "wan-2.7-image-edit":
+    case "wan-2.6-image-edit":
+      return {
+        prompt: input.prompt,
+        image_urls: urls
+        // wan-edit uses `size` not aspect_ratio. Default 2K, let model defaults handle it otherwise.
+      };
+    case "p-image-edit":
+      return {
+        prompt: input.prompt,
+        images: urls.slice(0, 5),
+        ...input.aspect_ratio ? { aspect_ratio: input.aspect_ratio } : {}
+      };
+    case "flux-edit":
+    case "xai-image-edit":
+    case "gpt-image-2-edit":
+      return {
+        prompt: input.prompt,
+        image_url: urls[0],
+        ...urls.length > 1 ? { image_urls: urls } : {},
+        ...input.aspect_ratio ? { aspect_ratio: input.aspect_ratio } : {}
+      };
+    case "google-nano-banana":
+      return {
+        prompt: input.prompt,
+        image_input: urls,
+        ...input.aspect_ratio ? { aspect_ratio: input.aspect_ratio } : {}
+      };
+    default:
+      return {
+        prompt: input.prompt,
+        image_url: urls[0]
+      };
+  }
+}
 async function run2(input, ctx) {
-  const requested = input.model ?? DEFAULT_MODEL2;
+  let resolved = input;
+  try {
+    if (input.image_paths && input.image_paths.length > 0) {
+      const urls = await uploadLocalFiles(input.image_paths, ctx.client);
+      resolved = {
+        ...input,
+        image_urls: [...input.image_urls ?? [], ...urls]
+      };
+    } else if (input.image_path && !input.image_url) {
+      const url = await uploadLocalFile(input.image_path, ctx.client);
+      resolved = { ...input, image_url: url };
+    }
+  } catch (err) {
+    if (err instanceof SkillUploadError) {
+      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)."
+    };
+  }
+  const apiId = resolved.model ?? DEFAULT_MODEL2;
+  const body = buildPayload2(apiId, resolved);
+  const submitted = await ctx.client.run(apiId, body);
+  const result = await pollJobUntilDoneOrHandoff(
+    submitted.jobId,
+    (id) => ctx.client.getJob(id),
+    ctx.buildStatusUrl,
+    {
+      now: ctx.pollOverrides?.now,
+      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. Asset: ${urls[0]}` : `Edit produced ${urls.length} assets. URLs: ${urls.join(", ")}`
+  );
+}
+var DEFAULT_MODEL2, ALLOWED_MODELS, InputSchema2, InputJsonSchema2, editSkill;
+var init_edit = __esm({
+  "src/skills/edit.ts"() {
+    init_poll();
+    init_types();
+    init_upload_helpers();
+    DEFAULT_MODEL2 = "wan-2.7-image-edit";
+    ALLOWED_MODELS = [
+      "wan-2.7-image-edit",
+      "wan-2.6-image-edit",
+      "flux-edit",
+      "xai-image-edit",
+      "p-image-edit",
+      "gpt-image-2-edit",
+      "google-nano-banana"
+    ];
+    InputSchema2 = zod.z.object({
+      prompt: zod.z.string().min(1).max(5e3).describe("Edit instruction."),
+      image_url: zod.z.string().url().optional().describe("Single reference image to edit. Pass image_urls for multi-image edits."),
+      image_urls: zod.z.array(zod.z.string().url()).min(1).max(9).optional().describe("Multiple reference images (1-9). Used for composition/multi-ref edits."),
+      image_path: zod.z.string().min(1).optional().describe(
+        "Absolute local file path. Skill uploads it (24h temp storage) and edits it. Prefer over image_url when the user has the file on disk."
+      ),
+      image_paths: zod.z.array(zod.z.string().min(1)).min(1).max(9).optional().describe(
+        "Multiple absolute local file paths (1-9) for multi-image edits. Each uploaded to 24h temp storage before dispatch."
+      ),
+      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").')
+    });
+    InputJsonSchema2 = {
+      type: "object",
+      properties: {
+        prompt: { type: "string", description: "Edit instruction." },
+        image_url: {
+          type: "string",
+          format: "uri",
+          description: "Single reference image. Pass image_urls for multi-image edits."
+        },
+        image_urls: {
+          type: "array",
+          items: { type: "string", format: "uri" },
+          minItems: 1,
+          maxItems: 9,
+          description: "Multiple reference images (1-9)."
+        },
+        image_path: {
+          type: "string",
+          description: "Absolute local file path. Skill uploads it (24h temp storage) and edits the resulting URL. Prefer over image_url when the user has a local file."
+        },
+        image_paths: {
+          type: "array",
+          items: { type: "string" },
+          minItems: 1,
+          maxItems: 9,
+          description: "Multiple absolute local file paths (1-9). Each uploaded before dispatch."
+        },
+        model: {
+          type: "string",
+          enum: [...ALLOWED_MODELS],
+          description: "Override edit model. Default: wan-2.7-image-edit."
+        },
+        aspect_ratio: { type: "string" }
+      },
+      required: ["prompt"]
+    };
+    editSkill = {
+      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,
+      allowedModels: [...ALLOWED_MODELS],
+      defaultModel: DEFAULT_MODEL2,
+      run: run2
+    };
+  }
+});
+async function run3(input, ctx) {
+  const requested = input.model ?? DEFAULT_MODEL3;
   if (!ALLOWED.includes(requested)) {
     return {
       kind: "text",
@@ -205,6 +473,12 @@ async function run2(input, ctx) {
     };
   }
   const apiId = requested;
+  if ((apiId === "flux-edit" || apiId === "gpt-image-2-edit") && !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="ideogram-character".`
+    };
+  }
   const body = { prompt: input.prompt };
   if (input.aspect_ratio) body.aspect_ratio = input.aspect_ratio;
   if (input.reference_image_url) {
@@ -226,42 +500,48 @@ async function run2(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Character shot ready. Asset: ${urls[0]}`
   );
 }
-var characterSkill = {
-  name: "pixeldojo:character",
-  description: "Generate or edit consistent characters across shots. Pass a reference_image_url for edit-style models.",
-  inputZod: InputSchema2,
-  inputJsonSchema: InputJsonSchema2,
-  allowedModels: [...ALLOWED],
-  defaultModel: DEFAULT_MODEL2,
-  run: run2
-};
-var ALLOWED2 = ["veo-3.1", "kling-video", "seedance-2"];
-var DEFAULT_MODEL3 = "veo-3.1";
-var InputSchema3 = 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_MODEL3}.`),
-  aspect_ratio: zod.z.string().optional(),
-  duration: zod.z.number().int().positive().optional()
+var ALLOWED, DEFAULT_MODEL3, InputSchema3, InputJsonSchema3, characterSkill;
+var init_character = __esm({
+  "src/skills/character.ts"() {
+    init_poll();
+    init_types();
+    ALLOWED = ["ideogram-character", "flux-edit", "gpt-image-2-edit"];
+    DEFAULT_MODEL3 = "ideogram-character";
+    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 ideogram-character."
+      ),
+      aspect_ratio: zod.z.string().optional()
+    });
+    InputJsonSchema3 = {
+      type: "object",
+      properties: {
+        prompt: { type: "string" },
+        model: {
+          type: "string",
+          enum: ALLOWED,
+          description: `One of: ${ALLOWED.join(", ")}. Defaults to ${DEFAULT_MODEL3}.`
+        },
+        reference_image_url: { type: "string", format: "uri" },
+        aspect_ratio: { type: "string" }
+      },
+      required: ["prompt"]
+    };
+    characterSkill = {
+      name: "pixeldojo:character",
+      description: "Generate or edit consistent characters across shots. Pass a reference_image_url for edit-style models.",
+      inputZod: InputSchema3,
+      inputJsonSchema: InputJsonSchema3,
+      allowedModels: [...ALLOWED],
+      defaultModel: DEFAULT_MODEL3,
+      run: run3
+    };
+  }
 });
-var InputJsonSchema3 = {
-  type: "object",
-  properties: {
-    brief: {
-      type: "string",
-      description: "Storyboard brief: scene, shots, mood, action."
-    },
-    model: {
-      type: "string",
-      enum: ALLOWED2,
-      description: `One of: ${ALLOWED2.join(", ")}. Defaults to ${DEFAULT_MODEL3}.`
-    },
-    aspect_ratio: { type: "string" },
-    duration: { type: "integer" }
-  },
-  required: ["brief"]
-};
-async function run3(input, ctx) {
-  const requested = input.model ?? DEFAULT_MODEL3;
+async function run4(input, ctx) {
+  const requested = input.model ?? DEFAULT_MODEL4;
   if (!ALLOWED2.includes(requested)) {
     return {
       kind: "text",
@@ -287,35 +567,49 @@ async function run3(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Storyboard preview ready. Asset: ${urls[0]}`
   );
 }
-var storyboardSkill = {
-  name: "pixeldojo:storyboard",
-  description: "Generate a video storyboard preview from a single brief. v1: single-shot preview; multi-shot orchestration coming.",
-  inputZod: InputSchema3,
-  inputJsonSchema: InputJsonSchema3,
-  allowedModels: [...ALLOWED2],
-  defaultModel: DEFAULT_MODEL3,
-  run: run3
-};
-var ALLOWED3 = ["magnific-upscaler", "creative-upscale", "face-enhance"];
-var DEFAULT_MODEL4 = "magnific-upscaler";
-var InputSchema4 = zod.z.object({
-  image_url: zod.z.string().url().describe("URL of the source image to upscale."),
-  model: zod.z.string().optional().describe(`One of: ${ALLOWED3.join(", ")}. Defaults to ${DEFAULT_MODEL4}.`),
-  scale_factor: zod.z.number().int().min(1).max(4).optional().describe("Magnific only: 1, 2, or 4. Defaults to 2."),
-  creativity: zod.z.number().min(0).max(1).optional().describe("Magnific only: 0 (preserve) \u2192 1 (creative). Defaults to 0.")
+var ALLOWED2, DEFAULT_MODEL4, InputSchema4, InputJsonSchema4, storyboardSkill;
+var init_storyboard = __esm({
+  "src/skills/storyboard.ts"() {
+    init_poll();
+    init_types();
+    ALLOWED2 = ["veo-3.1", "kling-video", "seedance-2"];
+    DEFAULT_MODEL4 = "veo-3.1";
+    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()
+    });
+    InputJsonSchema4 = {
+      type: "object",
+      properties: {
+        brief: {
+          type: "string",
+          description: "Storyboard brief: scene, shots, mood, action."
+        },
+        model: {
+          type: "string",
+          enum: ALLOWED2,
+          description: `One of: ${ALLOWED2.join(", ")}. Defaults to ${DEFAULT_MODEL4}.`
+        },
+        aspect_ratio: { type: "string" },
+        duration: { type: "integer" }
+      },
+      required: ["brief"]
+    };
+    storyboardSkill = {
+      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,
+      allowedModels: [...ALLOWED2],
+      defaultModel: DEFAULT_MODEL4,
+      run: run4
+    };
+  }
 });
-var InputJsonSchema4 = {
-  type: "object",
-  properties: {
-    image_url: { type: "string", format: "uri" },
-    model: { type: "string", enum: ALLOWED3 },
-    scale_factor: { type: "integer", minimum: 1, maximum: 4 },
-    creativity: { type: "number", minimum: 0, maximum: 1 }
-  },
-  required: ["image_url"]
-};
-async function run4(input, ctx) {
-  const requested = input.model ?? DEFAULT_MODEL4;
+async function run5(input, ctx) {
+  const requested = input.model ?? DEFAULT_MODEL5;
   if (!ALLOWED3.includes(requested)) {
     return {
       kind: "text",
@@ -346,31 +640,41 @@ async function run4(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Upscaled. Asset: ${urls[0]}`
   );
 }
-var upscaleSkill = {
-  name: "pixeldojo:upscale",
-  description: "Enhance an image. Magnific (default) supports configurable scale_factor and creativity; face-enhance for portraits.",
-  inputZod: InputSchema4,
-  inputJsonSchema: InputJsonSchema4,
-  allowedModels: [...ALLOWED3],
-  defaultModel: DEFAULT_MODEL4,
-  run: run4
-};
-var InputSchema5 = zod.z.object({
-  jobId: zod.z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo:* skill handoff.")
+var ALLOWED3, DEFAULT_MODEL5, InputSchema5, InputJsonSchema5, upscaleSkill;
+var init_upscale = __esm({
+  "src/skills/upscale.ts"() {
+    init_poll();
+    init_types();
+    ALLOWED3 = ["magnific-upscaler", "creative-upscale", "face-enhance"];
+    DEFAULT_MODEL5 = "magnific-upscaler";
+    InputSchema5 = zod.z.object({
+      image_url: zod.z.string().url().describe("URL of the source image to upscale."),
+      model: zod.z.string().optional().describe(`One of: ${ALLOWED3.join(", ")}. Defaults to ${DEFAULT_MODEL5}.`),
+      scale_factor: zod.z.number().int().min(1).max(4).optional().describe("Magnific only: 1, 2, or 4. Defaults to 2."),
+      creativity: zod.z.number().min(0).max(1).optional().describe("Magnific only: 0 (preserve) \u2192 1 (creative). Defaults to 0.")
+    });
+    InputJsonSchema5 = {
+      type: "object",
+      properties: {
+        image_url: { type: "string", format: "uri" },
+        model: { type: "string", enum: ALLOWED3 },
+        scale_factor: { type: "integer", minimum: 1, maximum: 4 },
+        creativity: { type: "number", minimum: 0, maximum: 1 }
+      },
+      required: ["image_url"]
+    };
+    upscaleSkill = {
+      name: "pixeldojo:upscale",
+      description: "Enhance an image. Magnific (default) supports configurable scale_factor and creativity; face-enhance for portraits.",
+      inputZod: InputSchema5,
+      inputJsonSchema: InputJsonSchema5,
+      allowedModels: [...ALLOWED3],
+      defaultModel: DEFAULT_MODEL5,
+      run: run5
+    };
+  }
 });
-var InputJsonSchema5 = {
-  type: "object",
-  properties: {
-    jobId: {
-      type: "string",
-      description: "Job id returned from a prior pixeldojo:* skill handoff."
-    }
-  },
-  required: ["jobId"]
-};
-var STUCK_HINT_MS = 5 * 60 * 1e3;
-var ABANDON_HINT_MS = 12 * 60 * 1e3;
-async function run5(input, ctx) {
+async function run6(input, ctx) {
   const job = await ctx.client.getJob(input.jobId);
   if (job.status === "completed") {
     const urls = extractAssetUrls2(job);
@@ -434,30 +738,37 @@ function extractAssetUrls2(job) {
   if (output?.video) return [output.video];
   return [];
 }
-var statusSkill = {
-  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: InputSchema5,
-  inputJsonSchema: InputJsonSchema5,
-  // status is special — it doesn't dispatch to a model
-  allowedModels: [],
-  defaultModel: "",
-  run: run5
-};
-var InputSchema6 = zod.z.object({
-  url: zod.z.string().min(1).max(2048).describe("Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata.")
+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.")
+    });
+    InputJsonSchema6 = {
+      type: "object",
+      properties: {
+        jobId: {
+          type: "string",
+          description: "Job id returned from a prior pixeldojo:* skill handoff."
+        }
+      },
+      required: ["jobId"]
+    };
+    STUCK_HINT_MS = 5 * 60 * 1e3;
+    ABANDON_HINT_MS = 12 * 60 * 1e3;
+    statusSkill = {
+      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,
+      // status is special — it doesn't dispatch to a model
+      allowedModels: [],
+      defaultModel: "",
+      run: run6
+    };
+  }
 });
-var InputJsonSchema6 = {
-  type: "object",
-  properties: {
-    url: {
-      type: "string",
-      description: "Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata."
-    }
-  },
-  required: ["url"]
-};
-async function run6(input, ctx) {
+async function run7(input, ctx) {
   const product = await ctx.client.extractProduct(input.url);
   const summary = [
     `Product: ${product.name}`,
@@ -474,61 +785,35 @@ function truncate(input, max) {
   if (input.length <= max) return input;
   return input.slice(0, max - 3) + "...";
 }
-var 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.",
-  inputZod: InputSchema6,
-  inputJsonSchema: InputJsonSchema6,
-  // No model dispatch — this skill calls a server-side scrape, not a generation.
-  allowedModels: [],
-  defaultModel: "",
-  run: run6
-};
-var InputSchema7 = zod.z.object({
-  productUrl: zod.z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
-  product: zod.z.object({
-    name: zod.z.string().min(1).max(200),
-    description: zod.z.string().max(2e3).optional(),
-    images: zod.z.array(zod.z.string().url()).max(5).optional()
-  }).optional().describe("Manual product fields, used when productUrl is omitted."),
-  tone: zod.z.string().max(120).optional().describe('Optional creative direction ("premium minimalist", "playful Y2K"). Threaded through every prompt.'),
-  variants: zod.z.number().int().min(1).max(8).optional().describe("Lifestyle shots in addition to the hero (default 4, max 8)."),
-  includeVideo: zod.z.boolean().optional().describe("Whether to also generate a vertical launch video (default true)."),
-  videoAspectRatio: zod.z.enum(["9:16", "16:9", "1:1"]).optional().describe("Aspect ratio of the launch video (default 9:16 for Reels/TikTok)."),
-  videoMode: zod.z.enum(["lifestyle", "cgi", "ugc", "skip"]).optional().describe("Video styling \u2014 lifestyle (default), cgi, ugc, or skip to omit video.")
-}).refine((v) => v.productUrl || v.product, {
-  message: "productUrl or product is required",
-  path: ["productUrl"]
-});
-var InputJsonSchema7 = {
-  type: "object",
-  properties: {
-    productUrl: {
-      type: "string",
-      format: "uri",
-      description: "Product page URL. We extract name + description + images automatically."
-    },
-    product: {
+var InputSchema7, InputJsonSchema7, fromUrlSkill;
+var init_from_url = __esm({
+  "src/skills/from-url.ts"() {
+    InputSchema7 = zod.z.object({
+      url: zod.z.string().min(1).max(2048).describe("Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata.")
+    });
+    InputJsonSchema7 = {
       type: "object",
       properties: {
-        name: { type: "string" },
-        description: { type: "string" },
-        images: { type: "array", items: { type: "string", format: "uri" } }
+        url: {
+          type: "string",
+          description: "Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata."
+        }
       },
-      required: ["name"]
-    },
-    tone: {
-      type: "string",
-      description: "Creative direction threaded through every prompt."
-    },
-    variants: { type: "integer", minimum: 1, maximum: 8 },
-    includeVideo: { type: "boolean" },
-    videoAspectRatio: { type: "string", enum: ["9:16", "16:9", "1:1"] },
-    videoMode: { type: "string", enum: ["lifestyle", "cgi", "ugc", "skip"] }
-  },
-  oneOf: [{ required: ["productUrl"] }, { required: ["product"] }]
-};
-async function run7(input, ctx) {
+      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.",
+      inputZod: InputSchema7,
+      inputJsonSchema: InputJsonSchema7,
+      // No model dispatch — this skill calls a server-side scrape, not a generation.
+      allowedModels: [],
+      defaultModel: "",
+      run: run7
+    };
+  }
+});
+async function run8(input, ctx) {
   const client = ctx.client;
   const result = await client.runCampaign(input);
   if (result.kind === "campaign") {
@@ -555,31 +840,67 @@ async function run7(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var 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.",
-  inputZod: InputSchema7,
-  inputJsonSchema: InputJsonSchema7,
-  // Composition skill — internal sub-jobs route to per-tool models, no
-  // single allowed-models list applies here.
-  allowedModels: [],
-  defaultModel: "",
-  run: run7
-};
-var InputSchema8 = zod.z.object({
-  campaignId: zod.z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo:campaign handoff.")
+var InputSchema8, InputJsonSchema8, campaignSkill;
+var init_campaign = __esm({
+  "src/skills/campaign.ts"() {
+    InputSchema8 = zod.z.object({
+      productUrl: zod.z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
+      product: zod.z.object({
+        name: zod.z.string().min(1).max(200),
+        description: zod.z.string().max(2e3).optional(),
+        images: zod.z.array(zod.z.string().url()).max(5).optional()
+      }).optional().describe("Manual product fields, used when productUrl is omitted."),
+      tone: zod.z.string().max(120).optional().describe('Optional creative direction ("premium minimalist", "playful Y2K"). Threaded through every prompt.'),
+      variants: zod.z.number().int().min(1).max(8).optional().describe("Lifestyle shots in addition to the hero (default 4, max 8)."),
+      includeVideo: zod.z.boolean().optional().describe("Whether to also generate a vertical launch video (default true)."),
+      videoAspectRatio: zod.z.enum(["9:16", "16:9", "1:1"]).optional().describe("Aspect ratio of the launch video (default 9:16 for Reels/TikTok)."),
+      videoMode: zod.z.enum(["lifestyle", "cgi", "ugc", "skip"]).optional().describe("Video styling \u2014 lifestyle (default), cgi, ugc, or skip to omit video.")
+    }).refine((v) => v.productUrl || v.product, {
+      message: "productUrl or product is required",
+      path: ["productUrl"]
+    });
+    InputJsonSchema8 = {
+      type: "object",
+      properties: {
+        productUrl: {
+          type: "string",
+          format: "uri",
+          description: "Product page URL. We extract name + description + images automatically."
+        },
+        product: {
+          type: "object",
+          properties: {
+            name: { type: "string" },
+            description: { type: "string" },
+            images: { type: "array", items: { type: "string", format: "uri" } }
+          },
+          required: ["name"]
+        },
+        tone: {
+          type: "string",
+          description: "Creative direction threaded through every prompt."
+        },
+        variants: { type: "integer", minimum: 1, maximum: 8 },
+        includeVideo: { type: "boolean" },
+        videoAspectRatio: { type: "string", enum: ["9:16", "16:9", "1:1"] },
+        videoMode: { type: "string", enum: ["lifestyle", "cgi", "ugc", "skip"] }
+      },
+      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.",
+      inputZod: InputSchema8,
+      inputJsonSchema: InputJsonSchema8,
+      // Composition skill — internal sub-jobs route to per-tool models, no
+      // single allowed-models list applies here.
+      allowedModels: [],
+      defaultModel: "",
+      run: run8
+    };
+  }
 });
-var InputJsonSchema8 = {
-  type: "object",
-  properties: {
-    campaignId: {
-      type: "string",
-      description: "Campaign id returned from a prior pixeldojo:campaign handoff."
-    }
-  },
-  required: ["campaignId"]
-};
-async function run8(input, ctx) {
+async function run9(input, ctx) {
   const client = ctx.client;
   const result = await client.getCampaign(input.campaignId);
   if (result.kind === "campaign") {
@@ -609,31 +930,488 @@ async function run8(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var 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.",
-  inputZod: InputSchema8,
-  inputJsonSchema: InputJsonSchema8,
-  allowedModels: [],
-  defaultModel: "",
-  run: run8
-};
+var InputSchema9, InputJsonSchema9, campaignStatusSkill;
+var init_campaign_status = __esm({
+  "src/skills/campaign-status.ts"() {
+    InputSchema9 = zod.z.object({
+      campaignId: zod.z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo:campaign handoff.")
+    });
+    InputJsonSchema9 = {
+      type: "object",
+      properties: {
+        campaignId: {
+          type: "string",
+          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.",
+      inputZod: InputSchema9,
+      inputJsonSchema: InputJsonSchema9,
+      allowedModels: [],
+      defaultModel: "",
+      run: run9
+    };
+  }
+});
+async function run10(input, ctx) {
+  let url;
+  try {
+    url = await uploadLocalFile(input.path, ctx.client);
+  } catch (err) {
+    if (err instanceof SkillUploadError) {
+      return { kind: "text", text: `pixeldojo:upload: ${err.userMessage}` };
+    }
+    throw err;
+  }
+  return {
+    kind: "text",
+    text: `Uploaded ${path.basename(input.path)} \u2192 ${url}
+(temp storage; auto-deletes in ~24h \u2014 pass this URL as image_url to :generate or :edit)`
+  };
+}
+var InputSchema10, InputJsonSchema10, uploadSkill;
+var init_upload = __esm({
+  "src/skills/upload.ts"() {
+    init_upload_helpers();
+    InputSchema10 = zod.z.object({
+      path: zod.z.string().min(1).max(4096).describe(
+        "Absolute local file path to upload. JPEG, PNG, WebP, GIF (\u226450MB) or MP4, WebM, MOV (\u2264200MB). Returns a public URL on the temp CDN; storage auto-expires after 24 hours."
+      )
+    });
+    InputJsonSchema10 = {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Absolute local file path. Allowed: JPEG, PNG, WebP, GIF (\u226450MB) or MP4, WebM, MOV (\u2264200MB). Returns a public URL on the temp CDN; auto-expires after 24h."
+        }
+      },
+      required: ["path"]
+    };
+    uploadSkill = {
+      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: InputSchema10,
+      inputJsonSchema: InputJsonSchema10,
+      allowedModels: [],
+      defaultModel: "",
+      run: run10
+    };
+  }
+});
+async function run11(input, ctx) {
+  const requested = input.model ?? DEFAULT_MODEL6;
+  if (!ALLOWED4.includes(requested)) {
+    return {
+      kind: "text",
+      text: `Unknown model "${requested}" for pixeldojo:audio. Allowed: ${ALLOWED4.join(", ")}.`
+    };
+  }
+  const apiId = requested;
+  let audioUrls = input.audio_urls ?? [];
+  if (input.audio_paths?.length) {
+    try {
+      const uploaded = await uploadLocalFiles(input.audio_paths, ctx.client);
+      audioUrls = [...audioUrls, ...uploaded].slice(0, 3);
+    } catch (err) {
+      if (err instanceof SkillUploadError) {
+        return { kind: "text", text: `pixeldojo:audio (upload): ${err.userMessage}` };
+      }
+      throw err;
+    }
+  }
+  const body = { prompt: input.prompt };
+  if (apiId === "seed-audio") {
+    if (input.voice) body.voice = input.voice;
+    if (audioUrls.length) body.audio_urls = audioUrls;
+    if (input.output_format) body.output_format = input.output_format;
+    if (input.speed !== void 0) body.speed = input.speed;
+  } else {
+    body.text = input.prompt;
+    delete body.prompt;
+    if (input.voice) body.voice_id = input.voice;
+    if (input.output_format) body.audio_format = input.output_format;
+    if (input.speed !== void 0) body.speed = input.speed;
+  }
+  const submitted = await ctx.client.run(apiId, body);
+  const result = await pollJobUntilDoneOrHandoff(
+    submitted.jobId,
+    (id) => ctx.client.getJob(id),
+    ctx.buildStatusUrl,
+    {
+      now: ctx.pollOverrides?.now,
+      sleep: ctx.pollOverrides?.sleep
+    }
+  );
+  return pollResultToSkillResult(
+    result,
+    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Audio ready. Asset: ${urls[0]}`
+  );
+}
+var ALLOWED4, DEFAULT_MODEL6, InputSchema11, InputJsonSchema11, audioSkill;
+var init_audio = __esm({
+  "src/skills/audio.ts"() {
+    init_poll();
+    init_upload_helpers();
+    init_types();
+    ALLOWED4 = ["seed-audio", "text-to-speech"];
+    DEFAULT_MODEL6 = "seed-audio";
+    InputSchema11 = zod.z.object({
+      prompt: zod.z.string().min(1).describe(
+        "A script for speech, or a scene description for cinematic audio (dialogue + effects + music). Reference uploaded clips as @Audio1..@Audio3."
+      ),
+      model: zod.z.string().optional().describe(`One of: ${ALLOWED4.join(", ")}. Defaults to ${DEFAULT_MODEL6}.`),
+      voice: zod.z.string().optional().describe("Optional voice preset name or cloned-voice id (seed-audio) / voice_id (text-to-speech)."),
+      audio_urls: zod.z.array(zod.z.string().url()).max(3).optional().describe("seed-audio only: up to 3 reference audio URLs (30s / 10MB max each)."),
+      audio_paths: zod.z.array(zod.z.string()).max(3).optional().describe("seed-audio only: absolute local paths to reference clips; uploaded automatically (24h temp storage)."),
+      output_format: zod.z.string().optional().describe("seed-audio: mp3 (default), wav, pcm, ogg_opus. text-to-speech: mp3, wav, flac, pcm."),
+      speed: zod.z.number().min(0.5).max(2).optional().describe("Speech speed multiplier (0.5\u20132).")
+    });
+    InputJsonSchema11 = {
+      type: "object",
+      properties: {
+        prompt: { type: "string" },
+        model: { type: "string", enum: ALLOWED4 },
+        voice: { type: "string" },
+        audio_urls: { type: "array", items: { type: "string", format: "uri" }, maxItems: 3 },
+        audio_paths: { type: "array", items: { type: "string" }, maxItems: 3 },
+        output_format: { type: "string" },
+        speed: { type: "number", minimum: 0.5, maximum: 2 }
+      },
+      required: ["prompt"]
+    };
+    audioSkill = {
+      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: InputSchema11,
+      inputJsonSchema: InputJsonSchema11,
+      allowedModels: [...ALLOWED4],
+      defaultModel: DEFAULT_MODEL6,
+      run: run11
+    };
+  }
+});
+async function run12(input, ctx) {
+  const res = await ctx.client.listLibrary({
+    q: input.q,
+    model: input.model,
+    modality: input.modality,
+    limit: input.limit ?? 10
+  });
+  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."
+    };
+  }
+  const lines = res.items.map((it) => {
+    const parts = [
+      `- ${it.url}`,
+      it.modality ? `[${it.modality}]` : null,
+      it.model ? `model=${it.model}` : null,
+      `(${it.source}, ${it.createdAt.slice(0, 10)})`,
+      it.prompt ? `"${it.prompt.slice(0, 90)}${it.prompt.length > 90 ? "\u2026" : ""}"` : null
+    ].filter(Boolean);
+    return parts.join(" ");
+  });
+  return {
+    kind: "text",
+    text: `${res.items.length} library item(s):
+${lines.join("\n")}
+
+Pass any URL back into :generate, :edit, :character, or :upscale as a reference input.`
+  };
+}
+var InputSchema12, InputJsonSchema12, librarySkill;
+var init_library = __esm({
+  "src/skills/library.ts"() {
+    InputSchema12 = zod.z.object({
+      q: zod.z.string().optional().describe("Substring match against the prompt that produced the asset."),
+      model: zod.z.string().optional().describe("Restrict to a single model (apiId)."),
+      modality: zod.z.enum(["image", "video", "audio"]).optional().describe("Restrict to one output type."),
+      limit: zod.z.number().int().min(1).max(50).optional().describe("Max results (default 10).")
+    });
+    InputJsonSchema12 = {
+      type: "object",
+      properties: {
+        q: { type: "string" },
+        model: { type: "string" },
+        modality: { type: "string", enum: ["image", "video", "audio"] },
+        limit: { type: "integer", minimum: 1, maximum: 50 }
+      },
+      required: []
+    };
+    librarySkill = {
+      name: "pixeldojo:library",
+      description: "Search your own generation history (API/MCP outputs + results kept in the web app). Returns asset URLs to reuse as reference inputs.",
+      inputZod: InputSchema12,
+      inputJsonSchema: InputJsonSchema12,
+      allowedModels: [],
+      defaultModel: "",
+      run: run12
+    };
+  }
+});
+function substitutePlaceholders(args, inputs, prevUrl) {
+  const missing = [];
+  const fill = (value) => {
+    if (typeof value === "string") {
+      return value.replace(/\{\{(prev|input\.[a-zA-Z0-9_-]+)\}\}/g, (_, token) => {
+        if (token === "prev") {
+          if (!prevUrl) missing.push("{{prev}}");
+          return prevUrl ?? "";
+        }
+        const key = token.slice("input.".length);
+        if (!(key in inputs)) missing.push(`{{${token}}}`);
+        return inputs[key] ?? "";
+      });
+    }
+    if (Array.isArray(value)) return value.map(fill);
+    if (value && typeof value === "object") {
+      return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v)]));
+    }
+    return value;
+  };
+  return { resolved: fill(args), missing };
+}
+function firstUrl(result) {
+  if (result.kind === "assets" && result.assetUrls.length > 0) return result.assetUrls[0];
+  if (result.kind === "text") {
+    const m = result.text.match(/https?:\/\/\S+/);
+    return m?.[0].replace(/[).,]+$/, "");
+  }
+  return void 0;
+}
+async function runSave(input, ctx) {
+  const res = await ctx.client.saveWorkflow({
+    name: input.name,
+    description: input.description,
+    steps: input.steps.map((s) => ({ skill: s.skill, args: s.args ?? {} }))
+  });
+  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"}).`
+  };
+}
+async function runList(_input, ctx) {
+  const res = await ctx.client.listWorkflows();
+  if (res.count === 0) {
+    return {
+      kind: "text",
+      text: "No saved workflows yet. Save one with pixeldojo:save_workflow { name, steps: [{ skill, args }] }."
+    };
+  }
+  const lines = res.workflows.map(
+    (w) => `- ${w.name} (${w.steps.length} steps, ${w.runs} runs)${w.description ? `: ${w.description}` : ""}`
+  );
+  return { kind: "text", text: `${res.count} saved workflow(s):
+${lines.join("\n")}` };
+}
+async function runWorkflow(input, ctx) {
+  const workflow = await ctx.client.getWorkflow(input.name.toLowerCase(), { countRun: true });
+  const { findSkill: findSkill2 } = await Promise.resolve().then(() => (init_skills(), skills_exports));
+  const inputs = input.inputs ?? {};
+  const outputs = [];
+  let prevUrl;
+  for (let i = 0; i < workflow.steps.length; i++) {
+    const step = workflow.steps[i];
+    const skill = findSkill2(step.skill);
+    if (!skill) {
+      return {
+        kind: "text",
+        text: `Step ${i + 1} names unknown skill "${step.skill}". Re-save the workflow.`
+      };
+    }
+    const { resolved, missing } = substitutePlaceholders(step.args, inputs, prevUrl);
+    if (missing.length > 0) {
+      return {
+        kind: "text",
+        text: `Step ${i + 1} (${step.skill}) is missing ${Array.from(new Set(missing)).join(", ")}. ${missing.some((m) => m.includes("input.")) ? "Pass the value via run_workflow inputs." : "A previous step produced no asset URL."}`
+      };
+    }
+    const parsed = skill.inputZod.safeParse(resolved);
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      return {
+        kind: "text",
+        text: `Step ${i + 1} (${step.skill}) has invalid args: ${issue?.path.join(".") || "input"} ${issue?.message || "invalid"}.`
+      };
+    }
+    const result = await skill.run(parsed.data, ctx);
+    const url = firstUrl(result);
+    if (url) {
+      prevUrl = url;
+      outputs.push(`step ${i + 1} (${step.skill}): ${url}`);
+    } else if (result.kind === "text" && /fail|error|invalid|unknown/i.test(result.text)) {
+      return {
+        kind: "text",
+        text: `Workflow "${workflow.name}" stopped at step ${i + 1} (${step.skill}): ${result.text}`
+      };
+    } else {
+      outputs.push(`step ${i + 1} (${step.skill}): done (no asset URL)`);
+    }
+  }
+  return {
+    kind: "text",
+    text: `Workflow "${workflow.name}" completed ${workflow.steps.length} step(s):
+${outputs.join("\n")}`
+  };
+}
+var StepSchema, SaveInputSchema, RunInputSchema, ListInputSchema, stepJson, saveWorkflowSkill, runWorkflowSkill, listWorkflowsSkill;
+var init_workflows = __esm({
+  "src/skills/workflows.ts"() {
+    StepSchema = zod.z.object({
+      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()
+    });
+    SaveInputSchema = zod.z.object({
+      name: zod.z.string().regex(/^[a-z0-9][a-z0-9-]{1,40}$/, {
+        message: 'Kebab-case, 2-41 chars, e.g. "product-launch-pack".'
+      }).describe("Workflow handle. Saving to an existing name overwrites it."),
+      description: zod.z.string().max(500).optional(),
+      steps: zod.z.array(StepSchema).min(1).max(8)
+    });
+    RunInputSchema = zod.z.object({
+      name: zod.z.string().describe("Saved workflow name."),
+      inputs: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Values for {{input.<key>}} placeholders in the workflow steps.")
+    });
+    ListInputSchema = zod.z.object({});
+    stepJson = {
+      type: "object",
+      properties: {
+        skill: { type: "string" },
+        args: { type: "object" }
+      },
+      required: ["skill"]
+    };
+    saveWorkflowSkill = {
+      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: {
+        type: "object",
+        properties: {
+          name: { type: "string", pattern: "^[a-z0-9][a-z0-9-]{1,40}$" },
+          description: { type: "string" },
+          steps: { type: "array", items: stepJson, minItems: 1, maxItems: 8 }
+        },
+        required: ["name", "steps"]
+      },
+      allowedModels: [],
+      defaultModel: "",
+      run: runSave
+    };
+    runWorkflowSkill = {
+      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: {
+        type: "object",
+        properties: {
+          name: { type: "string" },
+          inputs: { type: "object", additionalProperties: { type: "string" } }
+        },
+        required: ["name"]
+      },
+      allowedModels: [],
+      defaultModel: "",
+      run: runWorkflow
+    };
+    listWorkflowsSkill = {
+      name: "pixeldojo:list_workflows",
+      description: "List your saved workflows with step counts and run totals.",
+      inputZod: ListInputSchema,
+      inputJsonSchema: { type: "object", properties: {}, required: [] },
+      allowedModels: [],
+      defaultModel: "",
+      run: runList
+    };
+  }
+});
 
 // src/skills/index.ts
-var ALL_SKILLS = [
-  generateSkill,
-  characterSkill,
-  storyboardSkill,
-  upscaleSkill,
-  statusSkill,
-  fromUrlSkill,
-  campaignSkill,
-  campaignStatusSkill
-];
+var skills_exports = {};
+__export(skills_exports, {
+  ALL_SKILLS: () => exports.ALL_SKILLS,
+  audioSkill: () => audioSkill,
+  campaignSkill: () => campaignSkill,
+  campaignStatusSkill: () => campaignStatusSkill,
+  characterSkill: () => characterSkill,
+  editSkill: () => editSkill,
+  findSkill: () => findSkill,
+  fromUrlSkill: () => fromUrlSkill,
+  generateSkill: () => generateSkill,
+  librarySkill: () => librarySkill,
+  listWorkflowsSkill: () => listWorkflowsSkill,
+  runWorkflowSkill: () => runWorkflowSkill,
+  saveWorkflowSkill: () => saveWorkflowSkill,
+  statusSkill: () => statusSkill,
+  storyboardSkill: () => storyboardSkill,
+  uploadSkill: () => uploadSkill,
+  upscaleSkill: () => upscaleSkill
+});
 function findSkill(name) {
-  return ALL_SKILLS.find((s) => s.name === name);
+  return exports.ALL_SKILLS.find((s) => s.name === name);
+}
+exports.ALL_SKILLS = void 0;
+var init_skills = __esm({
+  "src/skills/index.ts"() {
+    init_generate();
+    init_edit();
+    init_character();
+    init_storyboard();
+    init_upscale();
+    init_status();
+    init_from_url();
+    init_campaign();
+    init_campaign_status();
+    init_upload();
+    init_audio();
+    init_library();
+    init_workflows();
+    exports.ALL_SKILLS = [
+      generateSkill,
+      editSkill,
+      characterSkill,
+      storyboardSkill,
+      upscaleSkill,
+      audioSkill,
+      librarySkill,
+      saveWorkflowSkill,
+      runWorkflowSkill,
+      listWorkflowsSkill,
+      statusSkill,
+      fromUrlSkill,
+      uploadSkill,
+      campaignSkill,
+      campaignStatusSkill
+    ];
+  }
+});
+function makeAttributedClient(options) {
+  const { mcpVersion, skillName, baseFetch, ...sdkOptions } = options;
+  const real = baseFetch ?? globalThis.fetch.bind(globalThis);
+  const wrappedFetch = (input, init) => {
+    const headers = new Headers(init?.headers);
+    headers.set("x-pixeldojo-source", `mcp/${mcpVersion}`);
+    if (skillName) headers.set("x-pixeldojo-skill", skillName);
+    return real(input, { ...init, headers });
+  };
+  return new sdk.PixelDojoClient({
+    ...sdkOptions,
+    fetch: wrappedFetch
+  });
 }
 
+// src/server.ts
+init_skills();
+
 // src/redact.ts
 var PD_KEY_RE = /pd_[A-Za-z0-9_-]{8,}/g;
 var REDACTED = "[redacted]";
@@ -690,7 +1468,7 @@ function buildServer(options) {
   );
   server.setRequestHandler(types_js.ListToolsRequestSchema, async () => {
     return {
-      tools: ALL_SKILLS.map((skill) => ({
+      tools: exports.ALL_SKILLS.map((skill) => ({
         name: skill.name,
         description: skill.description,
         inputSchema: skill.inputJsonSchema
@@ -701,7 +1479,7 @@ function buildServer(options) {
     const skillName = req.params.name;
     const skill = findSkill(skillName);
     if (!skill) {
-      const available = ALL_SKILLS.map((s) => s.name).join(", ");
+      const available = exports.ALL_SKILLS.map((s) => s.name).join(", ");
       return {
         isError: true,
         content: [
@@ -802,9 +1580,13 @@ async function runStdio(options) {
   await server.connect(transport);
 }
 
-exports.ALL_SKILLS = ALL_SKILLS;
+// src/index.ts
+init_skills();
+init_poll();
+
 exports.PACKAGE_VERSION = PACKAGE_VERSION;
 exports.buildServer = buildServer;
+exports.errorToActionableMessage = errorToActionableMessage;
 exports.findSkill = findSkill;
 exports.makeAttributedClient = makeAttributedClient;
 exports.makeRedactedLogger = makeRedactedLogger;
@@ -812,5 +1594,6 @@ exports.pollJobUntilDoneOrHandoff = pollJobUntilDoneOrHandoff;
 exports.redactKeys = redactKeys;
 exports.redactValue = redactValue;
 exports.runStdio = runStdio;
+exports.skillResultToMcpResponse = skillResultToMcpResponse;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map