pixelkiln 0.83.0 → 0.85.0

package/dist/index.cjs

@@ -334,6 +334,7 @@ var RevisionModeSchema = import_zod.z.enum([
   "outpaint",
   "reduce-colors",
   "correct-pixelart",
+  "remove-background",
   "animate",
   "animate-pixminimax",
   "animate-skeleton",
@@ -665,7 +666,22 @@ var RevisionSchema = import_zod.z.object({
    * `interpolate`: required, the ending keyframe; the parent is the start.
    */
   lastFrame: import_zod.z.string().min(1).optional(),
-  /** `animate-pixminimax` only: facing direction, used only alongside `enhancePrompt` to hold the sprite's facing. */
+  /**
+   * `animate`/`animate-pixminimax` only: colour de-flicker sensitivity.
+   * Frames whose foreground drifts from the first frame beyond this are
+   * corrected toward it; 0 corrects every frame and higher values correct
+   * fewer. Omit for PixelLab's default.
+   */
+  driftThreshold: import_zod.z.number().min(0).optional(),
+  /**
+   * `animate-pixminimax` only: one noun phrase for what the parent shows.
+   * PixelLab reads it off the image when omitted, and can decline some
+   * images, failing the job until it is sent.
+   */
+  subjectDescription: import_zod.z.string().min(1).max(300).optional(),
+  /** `animate-pixminimax` only: the pose the parent is in, read off the image by PixelLab when omitted. */
+  initialPose: import_zod.z.string().min(1).max(300).optional(),
+  /** `animate-pixminimax` only: facing direction, one of the model's caption fields, so it also holds the sprite's facing. */
   direction: CharacterDirectionSchema.optional(),
   /** `animate`/`animate-pixminimax` only: let PixelLab expand the action into a fuller motion description first. */
   enhancePrompt: import_zod.z.boolean().optional(),
@@ -685,12 +701,15 @@ var RevisionSchema = import_zod.z.object({
    * same `mannequin`/`bear`/`cat`/`dog`/`horse`/`lion` vocabulary.
    */
   skeletonTemplate: import_zod.z.string().min(1).optional(),
+  /** `remove-background` only: `simple` is faster and suits flat backgrounds; `complex` handles detailed edges. PixelLab defaults to `simple`. */
+  removalTask: import_zod.z.enum(["simple", "complex"]).optional(),
   /**
-   * `animate-skeleton` only: what the character *looks like*, a noun
+   * `animate-skeleton`: what the character *looks like*, a noun
    * phrase (colours, clothing, held items) — distinct from the asset's
    * own `prompt`, which this mode sends as the motion's short label
    * (PixelLab's `action`), the same `prompt`-as-motion convention
-   * `animate`/`animate-pixminimax` already use.
+   * `animate`/`animate-pixminimax` already use. `remove-background`: a
+   * short description of the foreground, which PixelLab uses as a hint.
    */
   description: import_zod.z.string().min(1).optional(),
   /**
@@ -807,7 +826,44 @@ var RevisionSchema = import_zod.z.object({
       path: ["keypointsFile"]
     });
   }
-  for (const field of ["keypointsFile", "skeletonTemplate", "description"]) {
+  if (revision.driftThreshold !== void 0 && revision.mode !== "animate" && revision.mode !== "animate-pixminimax") {
+    context.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      message: "driftThreshold applies to animate/animate-pixminimax revisions only",
+      path: ["driftThreshold"]
+    });
+  }
+  for (const field of ["subjectDescription", "initialPose"]) {
+    if (revision[field] !== void 0 && revision.mode !== "animate-pixminimax") {
+      context.addIssue({
+        code: import_zod.z.ZodIssueCode.custom,
+        message: `${field} applies to animate-pixminimax revisions only`,
+        path: [field]
+      });
+    }
+  }
+  if (revision.removalTask !== void 0 && revision.mode !== "remove-background") {
+    context.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      message: "removalTask applies to remove-background revisions only",
+      path: ["removalTask"]
+    });
+  }
+  if (revision.strength !== void 0 && revision.mode === "remove-background") {
+    context.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      message: "remove-background revisions do not take a strength",
+      path: ["strength"]
+    });
+  }
+  if (revision.description !== void 0 && revision.mode !== "animate-skeleton" && revision.mode !== "remove-background") {
+    context.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      message: "description applies to animate-skeleton/remove-background revisions only",
+      path: ["description"]
+    });
+  }
+  for (const field of ["keypointsFile", "skeletonTemplate"]) {
     if (revision[field] !== void 0 && revision.mode !== "animate-skeleton") {
       context.addIssue({
         code: import_zod.z.ZodIssueCode.custom,
@@ -1461,6 +1517,10 @@ var LockEntrySchema = import_zod.z.object({
     keypointsSha256: import_zod.z.string().regex(/^[0-9a-f]{64}$/).optional(),
     skeletonTemplate: import_zod.z.string().min(1).optional(),
     description: import_zod.z.string().min(1).optional(),
+    removalTask: import_zod.z.enum(["simple", "complex"]).optional(),
+    driftThreshold: import_zod.z.number().min(0).optional(),
+    subjectDescription: import_zod.z.string().min(1).max(300).optional(),
+    initialPose: import_zod.z.string().min(1).max(300).optional(),
     engine: import_zod.z.enum(["pro-flash"]).optional()
   }).strict().nullable().default(null),
   /** For a mirror: the asset it flips and a hash over that asset's output hashes when this was made. */
@@ -1889,6 +1949,7 @@ var CorrectPixelartResponseSchema = import_zod3.z.object({
   images: import_zod3.z.array(import_zod3.z.object({ base64: import_zod3.z.string().min(1) }).passthrough()).min(1),
   usage: import_zod3.z.unknown().optional()
 }).passthrough();
+var RemoveBackgroundResponseSchema = import_zod3.z.object({ image: import_zod3.z.object({ base64: import_zod3.z.string().min(1) }).passthrough(), usage: import_zod3.z.unknown().optional() }).passthrough();
 var ProFlashImageSubmitSchema = import_zod3.z.object({
   background_job_id: import_zod3.z.string().min(1),
   image_id: import_zod3.z.string().min(1),
@@ -2080,9 +2141,9 @@ var PixelLabClient = class {
   apiKey;
   http;
   /** Retries transport failures, 429, and 5xx; see http.ts for the policy. */
-  async request(path36, init) {
+  async request(path38, init) {
     const auth = this.apiKey.startsWith("Bearer ") ? this.apiKey : `Bearer ${this.apiKey}`;
-    const res = await this.http(`${BASE}${path36}`, {
+    const res = await this.http(`${BASE}${path38}`, {
       ...init,
       headers: {
         Authorization: auth,
@@ -2092,13 +2153,13 @@ var PixelLabClient = class {
     });
     const text = await res.text();
     if (!res.ok) {
-      throw new PixelLabError(`${init?.method ?? "GET"} ${path36} \u2192 ${res.status}`, res.status, text);
+      throw new PixelLabError(`${init?.method ?? "GET"} ${path38} \u2192 ${res.status}`, res.status, text);
     }
     if (!text) return {};
     try {
       return JSON.parse(text);
     } catch {
-      throw new Error(`${init?.method ?? "GET"} ${path36} returned invalid JSON`);
+      throw new Error(`${init?.method ?? "GET"} ${path38} returned invalid JSON`);
     }
   }
   async balance() {
@@ -2503,10 +2564,10 @@ var PixelLabClient = class {
     const palette = args.paletteSwatchBase64 ? { color_image: { type: "base64", base64: args.paletteSwatchBase64, format: "png" }, force_colors: true } : {};
     const encode = (image) => ({ type: "base64", base64: image.base64, format: image.format });
     const south = args.reference?.south;
-    let path36;
+    let path38;
     let body;
     if (args.mode === "v3") {
-      path36 = "/create-character-v3";
+      path38 = "/create-character-v3";
       body = {
         description: args.description,
         image_size: imageSize,
@@ -2520,7 +2581,7 @@ var PixelLabClient = class {
         ...args.enhancePrompt ? { enhance_prompt: true } : {}
       };
     } else if (args.mode === "pro-flash") {
-      path36 = "/create-character-pro-flash";
+      path38 = "/create-character-pro-flash";
       const traits = args.styleTraits;
       body = {
         description: args.description,
@@ -2544,7 +2605,7 @@ var PixelLabClient = class {
         } : {}
       };
     } else if (args.mode === "pro") {
-      path36 = "/create-character-pro";
+      path38 = "/create-character-pro";
       body = {
         description: args.description,
         image_size: imageSize,
@@ -2558,7 +2619,7 @@ var PixelLabClient = class {
         ...!south && args.styleCharacterId ? { style_character_id: args.styleCharacterId } : {}
       };
     } else {
-      path36 = args.directions === 4 ? "/create-character-with-4-directions" : "/create-character-with-8-directions";
+      path38 = args.directions === 4 ? "/create-character-with-4-directions" : "/create-character-with-8-directions";
       body = {
         description: args.description,
         image_size: imageSize,
@@ -2575,8 +2636,8 @@ var PixelLabClient = class {
         ...palette
       };
     }
-    const raw = await this.request(path36, { method: "POST", body: JSON.stringify(body) });
-    return validateResponse(CharacterSubmitSchema, raw, path36.slice(1));
+    const raw = await this.request(path38, { method: "POST", body: JSON.stringify(body) });
+    return validateResponse(CharacterSubmitSchema, raw, path38.slice(1));
   }
   /** A text edit of an existing character, applied to every direction and stored as a sibling. */
   async createCharacterState(args) {
@@ -2953,6 +3014,27 @@ var PixelLabClient = class {
     const pngs = cleanupResults(res.images, images.length, "correct-pixelart");
     return { png: pngs[0], pngs, usage: res.usage };
   }
+  /**
+   * `/remove-background`: a transparent PNG from one pixel-art image,
+   * synchronously, like the rest of the Cleanup tier. The API takes at most
+   * 400x400 worth of area, one image per call. `simple` is faster and suits
+   * flat backgrounds; `complex` is slower and handles detailed edges. The
+   * schema's response example is dollar-denominated (`usd: 0.01`); the
+   * subscription cost measured 1 generation (docs/ENDPOINTS.md), and the
+   * default `simple` task is the one measured.
+   */
+  async removeBackground(args) {
+    const body = { image: args.image, image_size: { width: args.width, height: args.height } };
+    if (args.task) body.background_removal_task = args.task === "complex" ? "remove_complex_background" : "remove_simple_background";
+    if (args.text) body.text = args.text;
+    if (args.seed != null) body.seed = args.seed;
+    const res = validateResponse(
+      RemoveBackgroundResponseSchema,
+      await this.request("/remove-background", { method: "POST", body: JSON.stringify(body) }),
+      "remove-background"
+    );
+    return { png: Buffer.from(res.image.base64, "base64"), usage: res.usage };
+  }
   /**
    * `/unzoom`: recover native-resolution pixel art from an upscaled image (a
    * 32x32 sprite saved at 512x512). Synchronous like the Cleanup tier.
@@ -3061,6 +3143,7 @@ var PixelLabClient = class {
    */
   async animateWithTextV3(args) {
     const body = { first_frame: args.firstFrame, action: args.action };
+    if (args.driftThreshold != null) body.drift_threshold = args.driftThreshold;
     if (args.lastFrame) body.last_frame = args.lastFrame;
     if (args.frameCount != null) body.frame_count = args.frameCount;
     if (args.seed != null) body.seed = args.seed;
@@ -3080,6 +3163,10 @@ var PixelLabClient = class {
    */
   async animatePixminimax(args) {
     const body = { first_frame: args.firstFrame, description: args.description };
+    if (args.view) body.view = args.view;
+    if (args.subjectDescription) body.subject_description = args.subjectDescription;
+    if (args.initialPose) body.initial_pose = args.initialPose;
+    if (args.driftThreshold != null) body.drift_threshold = args.driftThreshold;
     if (args.lastFrame) body.last_frame = args.lastFrame;
     if (args.frameCount != null) body.frame_count = args.frameCount;
     if (args.seed != null) body.seed = args.seed;
@@ -3115,6 +3202,7 @@ var PixelLabClient = class {
       keypoints: args.keypoints,
       direction: args.direction
     };
+    if (args.view) body.view = args.view;
     if (args.templateId) body.template_id = args.templateId;
     if (args.action) body.action = args.action;
     if (args.description) body.description = args.description;
@@ -3762,10 +3850,10 @@ var import_node_fs = require("fs");
 function sha256(data) {
   return (0, import_node_crypto.createHash)("sha256").update(data).digest("hex");
 }
-async function sha256File(path36) {
+async function sha256File(path38) {
   return new Promise((resolve, reject) => {
     const hash = (0, import_node_crypto.createHash)("sha256");
-    const stream = (0, import_node_fs.createReadStream)(path36);
+    const stream = (0, import_node_fs.createReadStream)(path38);
     stream.on("data", (chunk2) => hash.update(chunk2));
     stream.on("error", reject);
     stream.on("end", () => resolve(hash.digest("hex")));
@@ -3889,6 +3977,10 @@ function specHash(spec, styleImageHashes, providerOptionIdentity = spec.provider
         keypointsSha256: spec.revision.keypointsSha256,
         skeletonTemplate: spec.revision.skeletonTemplate,
         description: spec.revision.description,
+        removalTask: spec.revision.removalTask,
+        driftThreshold: spec.revision.driftThreshold,
+        subjectDescription: spec.revision.subjectDescription,
+        initialPose: spec.revision.initialPose,
         engine: spec.revision.engine
       } : void 0
     })
@@ -4064,7 +4156,7 @@ var PixelLabProvider = class _PixelLabProvider {
    * outpaint path yet.
    */
   supportsRevision(mode2) {
-    return mode2 === "inpaint" || mode2 === "image-to-image" || mode2 === "reduce-colors" || mode2 === "correct-pixelart" || mode2 === "animate" || mode2 === "animate-pixminimax" || mode2 === "animate-skeleton" || mode2 === "interpolate" || mode2 === "edit-animation";
+    return mode2 === "inpaint" || mode2 === "image-to-image" || mode2 === "reduce-colors" || mode2 === "correct-pixelart" || mode2 === "remove-background" || mode2 === "animate" || mode2 === "animate-pixminimax" || mode2 === "animate-skeleton" || mode2 === "interpolate" || mode2 === "edit-animation";
   }
   /** PixelLab's own constraints: submissions must be >2s apart, and
    *  background jobs in flight are capped by subscription tier (Tier 1=8,
@@ -4092,6 +4184,9 @@ var PixelLabProvider = class _PixelLabProvider {
     if (spec.batch?.role === "member") {
       return { unit: "generations", amount: 0, candidates: 1 };
     }
+    if (spec.revision?.mode === "remove-background") {
+      return { unit: "generations", amount: 1, candidates: 1 };
+    }
     if (spec.revision?.mode === "reduce-colors" || spec.revision?.mode === "correct-pixelart") {
       return { unit: "generations", amount: 0.1, candidates: 1 };
     }
@@ -4180,6 +4275,12 @@ var PixelLabProvider = class _PixelLabProvider {
         throw new Error(`PixelLab correct-pixelart source is ${width}x${height}; the API takes at most 1024 pixels per side`);
       }
     }
+    if (spec.revision?.mode === "remove-background") {
+      const { sourceWidth: width, sourceHeight: height } = spec.revision;
+      if (width != null && height != null && (width > 400 || height > 400)) {
+        throw new Error(`PixelLab remove-background source is ${width}x${height}; the API takes at most 400x400`);
+      }
+    }
     if (spec.revision?.mode === "animate-skeleton") {
       const { sourceWidth: width, sourceHeight: height, frames, skeletonTemplate } = spec.revision;
       if (width != null && height != null && (width > 256 || height > 256)) {
@@ -4200,6 +4301,9 @@ var PixelLabProvider = class _PixelLabProvider {
       if (mode2 === "animate" && frames != null && frames > 16) {
         throw new Error(`PixelLab animate takes 4 to 16 frames; ${frames} is too many (use animate-pixminimax for up to 40)`);
       }
+      if (mode2 === "animate-pixminimax" && frames != null && frames % 4 !== 0) {
+        throw new Error(`PixelLab animate-pixminimax takes a multiple of 4 frames (4 to 40); ${frames} is not one`);
+      }
       if (lastFrameWidth != null && lastFrameHeight != null && width != null && height != null && (lastFrameWidth !== width || lastFrameHeight !== height)) {
         throw new Error(
           `PixelLab ${mode2} lastFrame is ${lastFrameWidth}x${lastFrameHeight}; source is ${width}x${height} \u2014 they must match`
@@ -5291,6 +5395,18 @@ var PixelLabProvider = class _PixelLabProvider {
       const res2 = await this.client.correctPixelart({ images, strength: revision.strength });
       return this.cacheCleanupResult(res2.pngs, res2.usage, roles, revision.sourceFps);
     }
+    if (revision.mode === "remove-background") {
+      if (width == null || height == null) throw new Error(`${spec.styleId}/${spec.assetId}: remove-background needs the source's size`);
+      const res2 = await this.client.removeBackground({
+        image,
+        width,
+        height,
+        task: revision.removalTask,
+        text: revision.description,
+        seed: spec.seed
+      });
+      return this.cacheCleanupResult([res2.png], res2.usage, roles, revision.sourceFps);
+    }
     if (revision.mode === "interpolate") {
       const lastFrame = this.readLastFrame(spec);
       if (!lastFrame) throw new Error(`${spec.styleId}/${spec.assetId}: interpolate needs lastFrame, the ending keyframe`);
@@ -5326,7 +5442,8 @@ var PixelLabProvider = class _PixelLabProvider {
           frameCount: revision.frames,
           seed: spec.seed,
           noBackground: spec.noBackground,
-          enhancePrompt: revision.enhancePrompt
+          enhancePrompt: revision.enhancePrompt,
+          driftThreshold: revision.driftThreshold
         });
         return { jobId: res3.background_job_id };
       }
@@ -5338,7 +5455,11 @@ var PixelLabProvider = class _PixelLabProvider {
         seed: spec.seed,
         noBackground: spec.noBackground,
         enhancePrompt: revision.enhancePrompt,
-        direction: revision.direction
+        direction: revision.direction,
+        ...spec.view === "side" || spec.view === "low top-down" || spec.view === "high top-down" ? { view: spec.view } : {},
+        subjectDescription: revision.subjectDescription,
+        initialPose: revision.initialPose,
+        driftThreshold: revision.driftThreshold
       });
       return { jobId: res2.background_job_id };
     }
@@ -5355,6 +5476,9 @@ var PixelLabProvider = class _PixelLabProvider {
         firstFrameKeypoints: revision.skeleton.firstFrameKeypoints,
         keypoints: revision.skeleton.frames,
         direction: revision.direction,
+        // The style's camera, when it is one this endpoint knows; its enum is
+        // narrower than a style's free-string `view`.
+        ...spec.view === "side" || spec.view === "low top-down" || spec.view === "high top-down" ? { view: spec.view } : {},
         templateId: revision.skeletonTemplate,
         action: spec.prompt,
         description: revision.description,
@@ -5425,7 +5549,7 @@ var PixelLabProvider = class _PixelLabProvider {
   }
   async poll(jobId, generator, context) {
     const revisionMode = context?.spec?.revision?.mode;
-    if (revisionMode === "reduce-colors" || revisionMode === "correct-pixelart") {
+    if (revisionMode === "reduce-colors" || revisionMode === "correct-pixelart" || revisionMode === "remove-background") {
       return this.pollCachedRevision(jobId, context);
     }
     if (revisionMode === "animate" || revisionMode === "animate-pixminimax" || revisionMode === "animate-skeleton" || revisionMode === "interpolate" || revisionMode === "edit-animation") {
@@ -6133,9 +6257,9 @@ var RetroDiffusionClient = class {
     if (!response.ok) throw new ProviderError("retrodiffusion", `Retro Diffusion download failed (${response.status})`, { status: response.status });
     return Buffer.from(await response.arrayBuffer());
   }
-  async call(path36, init = {}) {
+  async call(path38, init = {}) {
     if (!this.token) throw new Error("RD_API_KEY is not set");
-    const response = await this.request(`${this.baseUrl}${path36}`, {
+    const response = await this.request(`${this.baseUrl}${path38}`, {
       ...init,
       headers: {
         "Content-Type": "application/json",
@@ -6444,8 +6568,13 @@ function retroError(value) {
 }
 
 // src/providers/scenario.ts
+var import_node_crypto3 = require("crypto");
+var import_node_fs3 = require("fs");
+var import_node_os2 = __toESM(require("os"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
 var DEFAULT_BASE_URL2 = "https://api.cloud.scenario.com/v1";
 var SOURCE_PROTOCOL2 = "scenario:";
+var SUBMIT_RETRIES = 8;
 var PROTECTED_PARAMETERS = /* @__PURE__ */ new Set([
   "dryRun",
   "height",
@@ -6492,7 +6621,11 @@ var ScenarioClient = class {
   async submit(modelId, body, projectId) {
     const response = await this.call(
       `/generate/custom/${encodeURIComponent(modelId)}`,
-      { method: "POST", body: JSON.stringify(body) },
+      // A 429 here means this account's concurrent-job limit refused the
+      // request, so nothing was accepted or billed; wait it out instead of
+      // failing the asset. The default four retries give up after about half
+      // a minute, before a running job has finished.
+      { method: "POST", body: JSON.stringify(body), retries: SUBMIT_RETRIES },
       { projectId }
     );
     const job = response?.job;
@@ -6500,6 +6633,29 @@ var ScenarioClient = class {
     if (!jobId) throw new Error("Scenario did not return an async job id");
     return jobId;
   }
+  /**
+   * Uploads one image (POST /assets) and returns its asset id, which a model's
+   * reference input takes. Free, and idempotent per image: the id is kept by
+   * content hash so a rerun does not upload the same bytes again.
+   */
+  async uploadImage(image, projectId) {
+    const bytes = Buffer.from(image.base64, "base64");
+    const digest2 = sha256(bytes);
+    const cached = readUploadCache()[uploadCacheKey(this.baseUrl, projectId, digest2)];
+    if (cached) return cached;
+    const response = await this.call(
+      "/assets",
+      {
+        method: "POST",
+        body: JSON.stringify({ image: image.base64, name: `pixelkiln-${digest2.slice(0, 12)}.${image.format === "png" ? "png" : "jpg"}` })
+      },
+      { projectId }
+    );
+    const id = response?.asset?.id;
+    if (typeof id !== "string" || !id) throw new Error("Scenario did not return an uploaded asset id");
+    writeUploadCache(uploadCacheKey(this.baseUrl, projectId, digest2), id);
+    return id;
+  }
   async job(id, projectId) {
     const response = await this.call(`/jobs/${encodeURIComponent(id)}`, {}, { projectId });
     const raw = response?.job;
@@ -6626,6 +6782,14 @@ var ScenarioProvider = class _ScenarioProvider {
   supports(generator) {
     return generator === "map";
   }
+  /**
+   * An edit is a generation with the parent as a reference image, which the
+   * editing models (GPT Image, Gemini, FLUX) take. Masked inpainting and the
+   * PixelLab-specific modes have no common Scenario input.
+   */
+  supportsRevision(mode2) {
+    return mode2 === "image-to-image";
+  }
   estimate(spec) {
     const options = scenarioOptions(spec);
     return {
@@ -6646,11 +6810,31 @@ var ScenarioProvider = class _ScenarioProvider {
     if (!Number.isInteger(count) || count < 1 || count > 4) {
       throw new Error("Scenario numOutputs must be a whole number from 1 to 4");
     }
-    if (spec.width < 128 || spec.width > 2048 || spec.width % 16 !== 0 || spec.height < 128 || spec.height > 2048 || spec.height % 16 !== 0) {
-      throw new Error("Scenario width and height must be multiples of 16 from 128 to 2048");
+    if (!Number.isInteger(spec.width) || spec.width < 16 || spec.width > 4096 || !Number.isInteger(spec.height) || spec.height < 16 || spec.height > 4096) {
+      throw new Error("Scenario width and height must be whole numbers from 16 to 4096");
     }
-    if (styleImages.length) {
-      throw new Error("Scenario styleImages are not supported yet; use a reusable Scenario model");
+    const revision = spec.revision;
+    if (revision) {
+      if (revision.sourceMembers?.length) {
+        throw new Error(
+          `Scenario edits one image; ${revision.sourceAssetId} is a ${revision.sourceMembers.length}-member set`
+        );
+      }
+      if (revision.strength != null) {
+        throw new Error("Scenario image-to-image takes no strength; use the model's own parameters");
+      }
+    }
+    const parameter = referenceParameter(options);
+    if ((styleImages.length || revision) && Object.hasOwn(options.parameters ?? {}, parameter)) {
+      throw new Error(
+        `Scenario parameters.${parameter} is the reference-image input and is filled from styleImages and revisions`
+      );
+    }
+    if (styleImages.length + (revision ? 1 : 0) > 1 && options.referenceArray === false) {
+      throw new Error(`Scenario ${parameter} takes one image; use one style image or a revision, not both`);
+    }
+    if (options.referenceParameter != null && (typeof options.referenceParameter !== "string" || !options.referenceParameter.trim())) {
+      throw new Error("Scenario referenceParameter must be a non-empty string");
     }
     if (options.projectId != null && (typeof options.projectId !== "string" || !options.projectId.trim())) {
       throw new Error("Scenario projectId must be a non-empty string");
@@ -6663,7 +6847,12 @@ var ScenarioProvider = class _ScenarioProvider {
   async submit(spec, styleImages) {
     this.validate(spec, styleImages);
     const options = scenarioOptions(spec);
-    const body = requestBody(spec, options);
+    const references = [];
+    if (spec.revision) references.push(readRevisionSource(spec));
+    for (const image of styleImages) references.push({ base64: image.base64, format: image.format });
+    const referenceAssetIds = [];
+    for (const image of references) referenceAssetIds.push(await this.client.uploadImage(image, options.projectId));
+    const body = requestBody(spec, options, referenceAssetIds);
     const quote = await this.client.quote(options.modelId, body, options.projectId);
     if (quote.total > options.maxComputeUnits + Number.EPSILON) {
       throw new Error(
@@ -6680,7 +6869,8 @@ var ScenarioProvider = class _ScenarioProvider {
         quotedComputeUnits: quote.total,
         creativeUnitsCost: quote.creativeUnitsCost,
         costDetails: quote.costDetails,
-        ipDetectionCost: quote.ipDetectionCost
+        ipDetectionCost: quote.ipDetectionCost,
+        ...referenceAssetIds.length ? { referenceAssetIds } : {}
       }
     };
   }
@@ -6702,7 +6892,13 @@ var ScenarioProvider = class _ScenarioProvider {
     }
     const assetIds = scenarioAssetIds(job);
     if (!assetIds.length) return { status: "failed", error: "Scenario job returned no asset IDs" };
-    const assets = await this.assets(assetIds, reference.projectId);
+    let assets;
+    try {
+      assets = await this.assets(assetIds, reference.projectId);
+    } catch (error) {
+      if (error instanceof UnsupportedScenarioOutput) return { status: "failed", error: error.message };
+      throw error;
+    }
     if (assets.length > 1) {
       return {
         status: "review",
@@ -6757,6 +6953,32 @@ var ScenarioProvider = class _ScenarioProvider {
     return assets.sort((left, right) => left.outputIndex - right.outputIndex || (jobOrder.get(left.id) ?? Number.MAX_SAFE_INTEGER) - (jobOrder.get(right.id) ?? Number.MAX_SAFE_INTEGER) || left.id.localeCompare(right.id));
   }
 };
+function uploadCachePath() {
+  return process.env.SCENARIO_UPLOAD_CACHE ?? import_node_path2.default.join(import_node_os2.default.tmpdir(), "pixelkiln-scenario", "uploads.json");
+}
+function uploadCacheKey(baseUrl, projectId, digest2) {
+  return (0, import_node_crypto3.createHash)("sha256").update(`${baseUrl}
+${projectId ?? ""}
+${digest2}`).digest("hex");
+}
+function readUploadCache() {
+  try {
+    const value = JSON.parse((0, import_node_fs3.readFileSync)(uploadCachePath(), "utf8"));
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  } catch {
+    return {};
+  }
+}
+function writeUploadCache(key, assetId) {
+  try {
+    const file = uploadCachePath();
+    (0, import_node_fs3.mkdirSync)(import_node_path2.default.dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    (0, import_node_fs3.writeFileSync)(tmp, JSON.stringify({ ...readUploadCache(), [key]: assetId }));
+    (0, import_node_fs3.renameSync)(tmp, file);
+  } catch {
+  }
+}
 function scenarioOptions(spec) {
   return spec.providerOptions;
 }
@@ -6772,9 +6994,25 @@ function scenarioBaseUrl(value) {
   }
   return url.href.replace(/\/$/, "");
 }
-function requestBody(spec, options) {
+function referenceParameter(options) {
+  return options.referenceParameter?.trim() || "referenceImages";
+}
+function readRevisionSource(spec) {
+  const revision = spec.revision;
+  if (!revision.sourceFile || !revision.sourceSha256 || !revision.sourceFormat) {
+    throw new Error(`${spec.styleId}/${spec.assetId}: revision source is not ready`);
+  }
+  const bytes = (0, import_node_fs3.readFileSync)(revision.sourceFile);
+  if (sha256(bytes) !== revision.sourceSha256) {
+    throw new Error(`${spec.styleId}/${spec.assetId}: revision source changed after the manifest was resolved`);
+  }
+  return { base64: bytes.toString("base64"), format: revision.sourceFormat };
+}
+function requestBody(spec, options, referenceAssetIds = []) {
+  const parameter = referenceParameter(options);
   return {
     ...options.parameters ?? {},
+    ...referenceAssetIds.length ? { [parameter]: options.referenceArray === false ? referenceAssetIds[0] : referenceAssetIds } : {},
     prompt: spec.prompt,
     width: spec.width,
     height: spec.height,
@@ -6864,9 +7102,11 @@ function scenarioAssetIds(job) {
 function assetDownloadUrl(asset) {
   return asset.originalFileUrl || asset.url;
 }
+var UnsupportedScenarioOutput = class extends Error {
+};
 function assertPngAsset(asset) {
   if (asset.originalMimeType && asset.originalMimeType !== MediaType.PNG) {
-    throw new Error(
+    throw new UnsupportedScenarioOutput(
       `Scenario asset ${asset.id} is ${asset.originalMimeType}; PixelKiln's Scenario MVP requires PNG output`
     );
   }
@@ -6931,9 +7171,9 @@ function redactScenarioError(value, secrets) {
 }
 
 // src/providers/comfyui.ts
-var import_node_crypto3 = require("crypto");
+var import_node_crypto4 = require("crypto");
 var import_promises = require("fs/promises");
-var import_node_path2 = __toESM(require("path"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
 var DEFAULT_BASE_URL3 = "http://127.0.0.1:8188";
 var BUILTIN_BINDINGS = /* @__PURE__ */ new Set([
   "prompt",
@@ -6960,7 +7200,7 @@ var ComfyUIClient = class {
   async submit(workflow) {
     const value = await this.json("prompt", {
       method: "POST",
-      body: JSON.stringify({ prompt: workflow, client_id: (0, import_node_crypto3.randomUUID)() })
+      body: JSON.stringify({ prompt: workflow, client_id: (0, import_node_crypto4.randomUUID)() })
     });
     if (!isObject(value)) throw new Error("ComfyUI returned an invalid queue response");
     const promptId = value.prompt_id;
@@ -7070,7 +7310,7 @@ var ComfyUIProvider = class _ComfyUIProvider {
   }
   async resolveOptions(value, context) {
     const options = parseOptions(value);
-    const workflowPath = import_node_path2.default.resolve(context.root, options.workflowFile);
+    const workflowPath = import_node_path3.default.resolve(context.root, options.workflowFile);
     let raw;
     try {
       raw = await (0, import_promises.readFile)(workflowPath, "utf8");
@@ -7125,7 +7365,7 @@ var ComfyUIProvider = class _ComfyUIProvider {
           if (typeof item !== "string") {
             throw new Error(`ComfyUI ${label} must be a manifest-relative PNG or JPEG path`);
           }
-          const file = import_node_path2.default.resolve(context.root, item);
+          const file = import_node_path3.default.resolve(context.root, item);
           let bytes;
           try {
             bytes = await (0, import_promises.readFile)(file);
@@ -7837,7 +8077,7 @@ function canonical(value) {
 }
 
 // src/providers/fake.ts
-var import_node_crypto4 = require("crypto");
+var import_node_crypto5 = require("crypto");
 var FAKE_PNG = Buffer.from(
   "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
   "base64"
@@ -7939,7 +8179,7 @@ var FakeProvider = class {
   }
   async download(url) {
     if (!url.startsWith("fake://")) throw new Error(`fake provider cannot download ${url}`);
-    const salt = (0, import_node_crypto4.createHash)("sha256").update(url).digest();
+    const salt = (0, import_node_crypto5.createHash)("sha256").update(url).digest();
     return Buffer.concat([FAKE_PNG, salt.subarray(0, 4)]);
   }
   async balance() {
@@ -8087,8 +8327,8 @@ registerProvider({
 
 // src/manifest.ts
 var import_promises3 = require("fs/promises");
-var import_node_fs5 = require("fs");
-var import_node_path5 = __toESM(require("path"), 1);
+var import_node_fs6 = require("fs");
+var import_node_path6 = __toESM(require("path"), 1);
 
 // src/loop-directions.ts
 var SINGLE_OUTPUT_FIELDS = ["file", "cell", "remoteId", "source", "sourceByStyle", "outputRole"];
@@ -8176,15 +8416,15 @@ function isObject2(value) {
 }
 
 // src/outputs.ts
-var import_node_fs4 = require("fs");
-var import_node_path4 = __toESM(require("path"), 1);
+var import_node_fs5 = require("fs");
+var import_node_path5 = __toESM(require("path"), 1);
 
 // src/lock.ts
 var import_promises2 = require("fs/promises");
-var import_node_fs3 = require("fs");
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_fs4 = require("fs");
+var import_node_path4 = __toESM(require("path"), 1);
 async function loadLock(lockPath) {
-  if (!(0, import_node_fs3.existsSync)(lockPath)) return { version: 2, entries: {} };
+  if (!(0, import_node_fs4.existsSync)(lockPath)) return { version: 2, entries: {} };
   try {
     return parseLock(JSON.parse(await (0, import_promises2.readFile)(lockPath, "utf8")));
   } catch (err) {
@@ -8199,7 +8439,7 @@ var saveQueues = /* @__PURE__ */ new Map();
 var dirtyPatches = /* @__PURE__ */ new WeakMap();
 var dirtyDeletes = /* @__PURE__ */ new WeakMap();
 function saveLock(lockPath, lock) {
-  const queueKey = import_node_path3.default.resolve(lockPath);
+  const queueKey = import_node_path4.default.resolve(lockPath);
   const previous = saveQueues.get(queueKey) ?? Promise.resolve();
   const next = previous.catch(() => {
   }).then(() => writeLockNow(lockPath, lock));
@@ -8211,7 +8451,7 @@ function saveLock(lockPath, lock) {
   return next;
 }
 async function writeLockNow(lockPath, lock) {
-  await (0, import_promises2.mkdir)(import_node_path3.default.dirname(import_node_path3.default.resolve(lockPath)), { recursive: true });
+  await (0, import_promises2.mkdir)(import_node_path4.default.dirname(import_node_path4.default.resolve(lockPath)), { recursive: true });
   const release = await acquireFileLock(lockPath);
   try {
     await writeLockWhileHeld(lockPath, lock);
@@ -8221,7 +8461,7 @@ async function writeLockNow(lockPath, lock) {
 }
 async function writeLockWhileHeld(file, lock) {
   let disk = { version: 2, entries: {} };
-  if ((0, import_node_fs3.existsSync)(file)) {
+  if ((0, import_node_fs4.existsSync)(file)) {
     try {
       disk = parseLock(JSON.parse(await (0, import_promises2.readFile)(file, "utf8")));
     } catch (err) {
@@ -8356,22 +8596,22 @@ function totalSpend(lock, unit = "generations") {
 
 // src/outputs.ts
 function portableOutputPath(file, manifestDir) {
-  const root = import_node_path4.default.resolve(manifestDir);
-  const absolute = import_node_path4.default.isAbsolute(file) ? import_node_path4.default.normalize(file) : import_node_path4.default.resolve(root, file);
-  const relative = import_node_path4.default.relative(root, absolute);
-  const value = import_node_path4.default.isAbsolute(relative) ? absolute : relative;
-  return value.split(import_node_path4.default.sep).join("/");
+  const root = import_node_path5.default.resolve(manifestDir);
+  const absolute = import_node_path5.default.isAbsolute(file) ? import_node_path5.default.normalize(file) : import_node_path5.default.resolve(root, file);
+  const relative = import_node_path5.default.relative(root, absolute);
+  const value = import_node_path5.default.isAbsolute(relative) ? absolute : relative;
+  return value.split(import_node_path5.default.sep).join("/");
 }
 function resolveOutputPath(recordedPath, manifestDir) {
-  if (import_node_path4.default.isAbsolute(recordedPath)) return import_node_path4.default.normalize(recordedPath);
-  if (import_node_path4.default.win32.isAbsolute(recordedPath)) return recordedPath;
-  return import_node_path4.default.resolve(manifestDir, recordedPath.split(/[\\/]/).join(import_node_path4.default.sep));
+  if (import_node_path5.default.isAbsolute(recordedPath)) return import_node_path5.default.normalize(recordedPath);
+  if (import_node_path5.default.win32.isAbsolute(recordedPath)) return recordedPath;
+  return import_node_path5.default.resolve(manifestDir, recordedPath.split(/[\\/]/).join(import_node_path5.default.sep));
 }
 function expectedOutputPath(spec, role, index, total, mediaType) {
   return memberPath(spec.outFile, role, index, total, mediaType);
 }
 function memberPath(file, role, index, total, mediaType) {
-  const originalExt = import_node_path4.default.extname(file);
+  const originalExt = import_node_path5.default.extname(file);
   const ext = mediaType ? mediaExtension(mediaType) : originalExt || ".png";
   const stem = originalExt ? file.slice(0, -originalExt.length) : file;
   if (total === 1) return `${stem}${ext}`;
@@ -8385,10 +8625,10 @@ function isFrameSetEntry(entry) {
   return entry.generator === "frames" && isMemberSetEntry(entry);
 }
 function sourceIsStem(source, entry, manifestDir) {
-  return isMemberSetEntry(entry) && !(0, import_node_fs4.existsSync)(import_node_path4.default.resolve(manifestDir, source));
+  return isMemberSetEntry(entry) && !(0, import_node_fs5.existsSync)(import_node_path5.default.resolve(manifestDir, source));
 }
 function sourceOutputPath(source, entry, index, manifestDir) {
-  const absolute = import_node_path4.default.resolve(manifestDir, source);
+  const absolute = import_node_path5.default.resolve(manifestDir, source);
   if (!sourceIsStem(source, entry, manifestDir)) return absolute;
   const output = entry.outputs[index];
   return memberPath(absolute, output.role, index, entry.outputs.length, output.mediaType);
@@ -8475,7 +8715,7 @@ function resolveSpecOutputs(spec, lock, manifestDir) {
     id: spec.assetId,
     index: 0,
     path: spec.outFile,
-    absolutePath: import_node_path4.default.resolve(spec.outFile),
+    absolutePath: import_node_path5.default.resolve(spec.outFile),
     sha256: ""
   }];
 }
@@ -8491,8 +8731,8 @@ function frameSetFps(entry) {
 
 // src/manifest.ts
 async function loadManifest(manifestPath) {
-  const abs = import_node_path5.default.resolve(manifestPath);
-  if (!(0, import_node_fs5.existsSync)(abs)) throw new ProjectError(`No manifest at ${abs}`);
+  const abs = import_node_path6.default.resolve(manifestPath);
+  if (!(0, import_node_fs6.existsSync)(abs)) throw new ProjectError(`No manifest at ${abs}`);
   const expansion = expandLoopDirections(JSON.parse(await (0, import_promises3.readFile)(abs, "utf8")));
   if (expansion.issues.length) {
     throw new ProjectError(`Manifest at ${abs} is invalid:
@@ -8584,7 +8824,7 @@ ${issues}`);
 ${unknownReferences.map((i) => `  ${i}`).join("\n")}`);
   }
   const loopFamilies = Object.keys(expansion.families).length ? { loopFamilies: expansion.families } : {};
-  return { manifest: parsed.data, root: import_node_path5.default.dirname(abs), path: abs, ...loopFamilies };
+  return { manifest: parsed.data, root: import_node_path6.default.dirname(abs), path: abs, ...loopFamilies };
 }
 function parentAssetId(asset) {
   return asset?.revision?.from ?? asset?.state?.of ?? asset?.animation?.of ?? asset?.portrait?.of ?? asset?.outfit?.of;
@@ -8685,10 +8925,10 @@ async function resolveSpecs(loaded, filter) {
   }
   const styleImageCache = /* @__PURE__ */ new Map();
   async function loadStyleImage(rel, what = "Style image") {
-    const abs = import_node_path5.default.resolve(root, rel);
+    const abs = import_node_path6.default.resolve(root, rel);
     let hit = styleImageCache.get(abs);
     if (!hit) {
-      if (!(0, import_node_fs5.existsSync)(abs)) throw new Error(`${what} not found: ${abs}`);
+      if (!(0, import_node_fs6.existsSync)(abs)) throw new Error(`${what} not found: ${abs}`);
       const buf = await (0, import_promises3.readFile)(abs);
       const metadata = imageMetadata(buf);
       if (!metadata) throw new Error(`${what} is not a readable PNG or JPEG: ${abs}`);
@@ -8715,7 +8955,7 @@ async function resolveSpecs(loaded, filter) {
       styleImageDimensions.push(loadedImage);
     }
     const resolvedImages = style.styleImages.map((image) => {
-      const hit = styleImageCache.get(import_node_path5.default.resolve(root, image.path));
+      const hit = styleImageCache.get(import_node_path6.default.resolve(root, image.path));
       return { base64: hit.base64, width: hit.width, height: hit.height, format: hit.format };
     });
     const styleSpecs = /* @__PURE__ */ new Map();
@@ -8816,9 +9056,9 @@ async function resolveSpecs(loaded, filter) {
       } else {
         prompt = [style.promptPrefix, subject, style.promptSuffix].map((p) => p.trim()).filter(Boolean).join(", ");
       }
-      const relFile = asset.file ?? import_node_path5.default.join(asset.category ?? "", `${assetId}.png`);
-      const outFile = import_node_path5.default.resolve(root, style.outDir, relFile);
-      const qualityOutFile = style.quality ? import_node_path5.default.resolve(root, style.quality.outDir, pngPath(relFile)) : void 0;
+      const relFile = asset.file ?? import_node_path6.default.join(asset.category ?? "", `${assetId}.png`);
+      const outFile = import_node_path6.default.resolve(root, style.outDir, relFile);
+      const qualityOutFile = style.quality ? import_node_path6.default.resolve(root, style.quality.outDir, pngPath(relFile)) : void 0;
       const tileSize = generator === "tiles" ? size : style.tileSize ?? 32;
       const tileVariations = tileFeatureOutputCount(generator === "tiles" ? style.tileFeature : void 0) ?? tileVariationCount(countNumberedDescriptions(prompt));
       const terrainTiles = generator === "terrain" ? terrainTileCount(style.terrainTransitionSize) : 0;
@@ -8913,7 +9153,7 @@ async function resolveSpecs(loaded, filter) {
             minGridConfidence: style.quality.minGridConfidence,
             ...style.quality.minTransparency == null ? {} : { minTransparency: style.quality.minTransparency },
             ...style.quality.fixerRevision ? { fixerRevision: style.quality.fixerRevision } : {},
-            ...style.quality.fixerPython ? { fixerPython: import_node_path5.default.resolve(root, style.quality.fixerPython) } : {},
+            ...style.quality.fixerPython ? { fixerPython: import_node_path6.default.resolve(root, style.quality.fixerPython) } : {},
             ...style.quality.fps == null ? {} : { fps: style.quality.fps }
           }
         } : {},
@@ -8996,7 +9236,7 @@ async function resolveSpecs(loaded, filter) {
         const file = memberPath(anchorSpec.outFile, "south", 0, anchorSpec.character.directions, MediaType.PNG);
         resolved.character = {
           ...resolved.character,
-          styleAnchor: { assetId: anchorId, spec: anchorSpec, file, sha256: (0, import_node_fs5.existsSync)(file) ? await sha256File(file) : null }
+          styleAnchor: { assetId: anchorId, spec: anchorSpec, file, sha256: (0, import_node_fs6.existsSync)(file) ? await sha256File(file) : null }
         };
       }
       const characterParent = asset.state?.of ?? asset.animation?.of ?? asset.portrait?.of;
@@ -9009,7 +9249,7 @@ async function resolveSpecs(loaded, filter) {
           parentAssetId: characterParent,
           parentSpec,
           parentFile,
-          parentSha256: (0, import_node_fs5.existsSync)(parentFile) ? await sha256File(parentFile) : null,
+          parentSha256: (0, import_node_fs6.existsSync)(parentFile) ? await sha256File(parentFile) : null,
           // A state and its animations keep the engine and rotations of the base.
           mode: resolved.character.kind === "base" ? resolved.character.mode : parentSpec.character?.mode ?? resolved.character.mode,
           directions: resolved.character.kind === "base" ? resolved.character.directions : parentSpec.character?.directions ?? resolved.character.directions
@@ -9027,7 +9267,7 @@ async function resolveSpecs(loaded, filter) {
           parentAssetId: characterParent,
           parentSpec,
           parentFile,
-          parentSha256: (0, import_node_fs5.existsSync)(parentFile) ? await sha256File(parentFile) : null,
+          parentSha256: (0, import_node_fs6.existsSync)(parentFile) ? await sha256File(parentFile) : null,
           // A state and its animations keep the base's own rotation count.
           directions: resolved.objectPro.kind === "base" ? resolved.objectPro.directions : parentSpec.objectPro.directions
         };
@@ -9049,7 +9289,7 @@ async function resolveSpecs(loaded, filter) {
           animation: sourceSpec.character.animation,
           outfit: {
             reference: {
-              path: import_node_path5.default.resolve(root, asset.outfit.reference),
+              path: import_node_path6.default.resolve(root, asset.outfit.reference),
               sha256: referenceImage.hash,
               width: referenceImage.width,
               height: referenceImage.height,
@@ -9071,23 +9311,23 @@ async function resolveSpecs(loaded, filter) {
           );
         }
         const sourceSpec = await finalize(asset.revision.from);
-        const sourceStem = sourceSpec.quality?.outFile ?? (sourceSpec.source ? import_node_path5.default.resolve(root, sourceSpec.source) : sourceSpec.outFile);
+        const sourceStem = sourceSpec.quality?.outFile ?? (sourceSpec.source ? import_node_path6.default.resolve(root, sourceSpec.source) : sourceSpec.outFile);
         const sourceMembers = await revisionSourceMembers(sourceStem, `revision source ${asset.revision.from}`);
         const sourceFile = sourceMembers?.[0]?.file ?? sourceStem;
         const sourceImage = sourceMembers ? { ...sourceMembers[0], hash: sha256(JSON.stringify(sourceMembers.map((member) => member.sha256))) } : await optionalRevisionImage(sourceFile, "revision source");
         const sourceFps = sourceSpec.character?.animation?.fps ?? sourceSpec.objectPro?.animation?.fps ?? sourceSpec.revision?.fps ?? sourceSpec.revision?.sourceFps;
-        const maskFile = asset.revision.mask ? import_node_path5.default.resolve(root, asset.revision.mask) : void 0;
+        const maskFile = asset.revision.mask ? import_node_path6.default.resolve(root, asset.revision.mask) : void 0;
         const maskImage = maskFile ? await optionalRevisionImage(maskFile, "revision mask", "png") : null;
         if (sourceImage && maskImage && (sourceImage.width !== maskImage.width || sourceImage.height !== maskImage.height)) {
           throw new Error(
             `Revision mask for ${styleId}/${assetId} is ${maskImage.width}x${maskImage.height}; source ${asset.revision.from} is ${sourceImage.width}x${sourceImage.height}`
           );
         }
-        const paletteImageFile = asset.revision.paletteImage ? import_node_path5.default.resolve(root, asset.revision.paletteImage) : void 0;
+        const paletteImageFile = asset.revision.paletteImage ? import_node_path6.default.resolve(root, asset.revision.paletteImage) : void 0;
         const paletteImage = paletteImageFile ? await optionalRevisionImage(paletteImageFile, "revision palette image", "png") : null;
-        const lastFrameFile = asset.revision.lastFrame ? import_node_path5.default.resolve(root, asset.revision.lastFrame) : void 0;
+        const lastFrameFile = asset.revision.lastFrame ? import_node_path6.default.resolve(root, asset.revision.lastFrame) : void 0;
         const lastFrame = lastFrameFile ? await optionalRevisionImage(lastFrameFile, "revision last frame") : null;
-        const keypointsFile = asset.revision.keypointsFile ? import_node_path5.default.resolve(root, asset.revision.keypointsFile) : void 0;
+        const keypointsFile = asset.revision.keypointsFile ? import_node_path6.default.resolve(root, asset.revision.keypointsFile) : void 0;
         const keypoints = keypointsFile ? await optionalSkeletonSet(keypointsFile) : null;
         resolved.revision = {
           mode: asset.revision.mode,
@@ -9141,6 +9381,10 @@ async function resolveSpecs(loaded, filter) {
           } : {},
           ...asset.revision.skeletonTemplate ? { skeletonTemplate: asset.revision.skeletonTemplate } : {},
           ...asset.revision.description ? { description: asset.revision.description } : {},
+          ...asset.revision.removalTask ? { removalTask: asset.revision.removalTask } : {},
+          ...asset.revision.driftThreshold == null ? {} : { driftThreshold: asset.revision.driftThreshold },
+          ...asset.revision.subjectDescription ? { subjectDescription: asset.revision.subjectDescription } : {},
+          ...asset.revision.initialPose ? { initialPose: asset.revision.initialPose } : {},
           ...asset.revision.engine ? { engine: asset.revision.engine } : {}
         };
       }
@@ -9250,7 +9494,7 @@ async function resolveSpecs(loaded, filter) {
   return specs;
 }
 function pngPath(file) {
-  const extension = import_node_path5.default.extname(file);
+  const extension = import_node_path6.default.extname(file);
   return extension ? `${file.slice(0, -extension.length)}.png` : `${file}.png`;
 }
 async function resolveMapScene(root, styleId, assetId, generator, scene, provider) {
@@ -9260,12 +9504,12 @@ async function resolveMapScene(root, styleId, assetId, generator, scene, provide
   if (!provider.supportsMapScene) {
     throw new Error(`assets.${assetId}.scene: provider "${provider.id}" cannot draw into a scene; PixelLab's /map-objects can`);
   }
-  const file = import_node_path5.default.resolve(root, scene.image);
+  const file = import_node_path6.default.resolve(root, scene.image);
   const image = await optionalRevisionImage(file, "scene image", "png");
   const base = { file, sha256: image?.hash ?? null, width: image?.width ?? null, height: image?.height ?? null };
   const placement = scene.placement;
   if ("mask" in placement) {
-    const maskFile = import_node_path5.default.resolve(root, placement.mask);
+    const maskFile = import_node_path6.default.resolve(root, placement.mask);
     const mask = await optionalRevisionImage(maskFile, "scene mask", "png");
     if (image && mask && (image.width !== mask.width || image.height !== mask.height)) {
       throw new Error(
@@ -9280,7 +9524,7 @@ async function resolveMapScene(root, styleId, assetId, generator, scene, provide
   return "oval" in placement ? { ...base, placement: { type: "oval", fraction: placement.oval } } : { ...base, placement: { type: "rectangle", fraction: placement.rectangle } };
 }
 async function optionalRevisionImage(file, label, requiredFormat) {
-  if (!(0, import_node_fs5.existsSync)(file)) return null;
+  if (!(0, import_node_fs6.existsSync)(file)) return null;
   const bytes = await (0, import_promises3.readFile)(file);
   const metadata = imageMetadata(bytes);
   if (!metadata) throw new Error(`${label} is not a readable PNG or JPEG: ${file}`);
@@ -9290,7 +9534,7 @@ async function optionalRevisionImage(file, label, requiredFormat) {
   return { hash: sha256(bytes), ...metadata };
 }
 async function optionalSkeletonSet(file) {
-  if (!(0, import_node_fs5.existsSync)(file)) return null;
+  if (!(0, import_node_fs6.existsSync)(file)) return null;
   const bytes = await (0, import_promises3.readFile)(file);
   let json;
   try {
@@ -9301,17 +9545,17 @@ async function optionalSkeletonSet(file) {
   return { hash: sha256(bytes), skeleton: parseSkeletonSet(json, file) };
 }
 async function revisionSourceMembers(stem, label) {
-  if ((0, import_node_fs5.existsSync)(stem)) return null;
+  if ((0, import_node_fs6.existsSync)(stem)) return null;
   const at = (role) => memberPath(stem, role, 0, 2, MediaType.PNG);
   let roles = [];
   for (const set of [CHARACTER_DIRECTIONS_8, CHARACTER_DIRECTIONS_4]) {
-    if (set.every((direction) => (0, import_node_fs5.existsSync)(at(direction)))) {
+    if (set.every((direction) => (0, import_node_fs6.existsSync)(at(direction)))) {
       roles = [...set];
       break;
     }
   }
   if (!roles.length) {
-    for (let index = 0; (0, import_node_fs5.existsSync)(at(`frame-${String(index).padStart(2, "0")}`)); index++) {
+    for (let index = 0; (0, import_node_fs6.existsSync)(at(`frame-${String(index).padStart(2, "0")}`)); index++) {
       roles.push(`frame-${String(index).padStart(2, "0")}`);
     }
   }
@@ -9337,7 +9581,7 @@ async function resolveStyleImages(loaded, styleId) {
   if (!style) throw new Error(`Unknown style "${styleId}"`);
   const out = [];
   for (const img of style.styleImages) {
-    const file = import_node_path5.default.resolve(loaded.root, img.path);
+    const file = import_node_path6.default.resolve(loaded.root, img.path);
     const buf = await (0, import_promises3.readFile)(file);
     const metadata = imageMetadata(buf);
     if (!metadata) throw new Error(`Style image is not a readable PNG or JPEG: ${file}`);
@@ -9368,7 +9612,7 @@ async function resolveCharacterShape(asset, style, kind, files) {
   };
   if (asset.concept) {
     const image = await files.load(asset.concept, "Concept image");
-    shape.concept = { path: import_node_path5.default.resolve(files.root, asset.concept), sha256: image.hash, width: image.width, height: image.height, format: image.format };
+    shape.concept = { path: import_node_path6.default.resolve(files.root, asset.concept), sha256: image.hash, width: image.width, height: image.height, format: image.format };
   }
   if (asset.reference) {
     const byDirection = typeof asset.reference === "string" ? { south: asset.reference } : asset.reference;
@@ -9376,7 +9620,7 @@ async function resolveCharacterShape(asset, style, kind, files) {
     for (const [direction, rel] of Object.entries(byDirection)) {
       const image = await files.load(rel, `Reference sprite (${direction})`);
       shape.reference[direction] = {
-        path: import_node_path5.default.resolve(files.root, rel),
+        path: import_node_path6.default.resolve(files.root, rel),
         sha256: image.hash,
         width: image.width,
         height: image.height,
@@ -9397,7 +9641,7 @@ async function resolveCharacterShape(asset, style, kind, files) {
     const animationMode = asset.animation.mode ?? (asset.animation.template ? "template" : "v3");
     const pose = async (rel, what) => {
       const image = await files.load(rel, what);
-      return { path: import_node_path5.default.resolve(files.root, rel), sha256: image.hash, width: image.width, height: image.height, format: image.format };
+      return { path: import_node_path6.default.resolve(files.root, rel), sha256: image.hash, width: image.width, height: image.height, format: image.format };
     };
     shape.animation = {
       mode: animationMode,
@@ -9428,7 +9672,7 @@ async function resolveObjectProShape(assetId, asset, style, kind, files) {
     const south = typeof asset.reference === "string" ? asset.reference : asset.reference.south;
     if (south) {
       const image = await files.load(south, "Reference sprite");
-      shape.reference = { path: import_node_path5.default.resolve(files.root, south), sha256: image.hash, width: image.width, height: image.height, format: image.format };
+      shape.reference = { path: import_node_path6.default.resolve(files.root, south), sha256: image.hash, width: image.width, height: image.height, format: image.format };
     }
   }
   if (asset.state) {
@@ -9456,7 +9700,7 @@ async function resolveObjectProShape(assetId, asset, style, kind, files) {
     }
     const pose = async (rel, what) => {
       const image = await files.load(rel, what);
-      return { path: import_node_path5.default.resolve(files.root, rel), sha256: image.hash, width: image.width, height: image.height, format: image.format };
+      return { path: import_node_path6.default.resolve(files.root, rel), sha256: image.hash, width: image.width, height: image.height, format: image.format };
     };
     shape.animation = {
       mode: asset.animation.mode ?? "v3",
@@ -9476,11 +9720,11 @@ function characterDirections(directions) {
 }
 
 // src/project.ts
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 
 // src/env.ts
-var import_node_fs6 = require("fs");
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_fs7 = require("fs");
+var import_node_path7 = __toESM(require("path"), 1);
 function loadEnvFiles(dir) {
   const loaded = [];
   for (const [file, vars] of envFiles(dir)) {
@@ -9494,10 +9738,10 @@ function loadEnvFiles(dir) {
 function envFiles(dir) {
   const out = [];
   for (const name of [".env.local", ".env"]) {
-    const file = import_node_path6.default.join(dir, name);
-    if (!(0, import_node_fs6.existsSync)(file)) continue;
+    const file = import_node_path7.default.join(dir, name);
+    if (!(0, import_node_fs7.existsSync)(file)) continue;
     try {
-      out.push([file, parseEnv((0, import_node_fs6.readFileSync)(file, "utf8"))]);
+      out.push([file, parseEnv((0, import_node_fs7.readFileSync)(file, "utf8"))]);
     } catch {
     }
   }
@@ -9523,12 +9767,12 @@ function parseEnv(contents) {
 }
 
 // src/pipeline/plan.ts
-var import_node_fs9 = require("fs");
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_fs10 = require("fs");
+var import_node_path13 = __toESM(require("path"), 1);
 
 // src/pipeline/mirror.ts
 var import_promises4 = require("fs/promises");
-var import_node_path7 = __toESM(require("path"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 
 // src/palette.ts
 function normalizePalette(values) {
@@ -9667,7 +9911,7 @@ async function deriveMirror(spec, lock, lockPath, opts = {}) {
   for (const [index, member] of members.entries()) {
     const bytes = flipHorizontal(await (0, import_promises4.readFile)(member.file));
     const target = expectedOutputPath(spec, member.role, index, members.length, MediaType.PNG);
-    await (0, import_promises4.mkdir)(import_node_path7.default.dirname(target), { recursive: true });
+    await (0, import_promises4.mkdir)(import_node_path8.default.dirname(target), { recursive: true });
     const tmp = `${target}.pixelkiln.tmp`;
     await (0, import_promises4.writeFile)(tmp, bytes);
     await (0, import_promises4.rename)(tmp, target);
@@ -9729,29 +9973,29 @@ async function deriveMirror(spec, lock, lockPath, opts = {}) {
 }
 
 // src/pipeline/quality-profile.ts
-var import_node_fs7 = require("fs");
-var import_node_path10 = __toESM(require("path"), 1);
+var import_node_fs8 = require("fs");
+var import_node_path11 = __toESM(require("path"), 1);
 
 // src/pipeline/refine.ts
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 var import_node_child_process2 = require("child_process");
 var import_promises6 = require("fs/promises");
-var import_node_os2 = require("os");
+var import_node_os3 = require("os");
 var import_node_util = require("util");
 
 // src/artifacts.ts
-var import_node_path8 = __toESM(require("path"), 1);
-var import_node_crypto5 = require("crypto");
+var import_node_path9 = __toESM(require("path"), 1);
+var import_node_crypto6 = require("crypto");
 var import_promises5 = require("fs/promises");
 var activeTransactions = /* @__PURE__ */ new Set();
 function message(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function digest(data) {
-  return (0, import_node_crypto5.createHash)("sha256").update(data).digest("hex");
+  return (0, import_node_crypto6.createHash)("sha256").update(data).digest("hex");
 }
 function portableRelative(from, to) {
-  return import_node_path8.default.relative(from, import_node_path8.default.resolve(to)).split(import_node_path8.default.sep).join("/") || ".";
+  return import_node_path9.default.relative(from, import_node_path9.default.resolve(to)).split(import_node_path9.default.sep).join("/") || ".";
 }
 function canonical2(value) {
   if (value === null || typeof value === "string" || typeof value === "boolean") return value;
@@ -9801,7 +10045,7 @@ function parseArtifactManifest(absolute, data) {
   return raw;
 }
 async function readArtifactBundleManifest(manifestPath) {
-  const absolute = import_node_path8.default.resolve(manifestPath);
+  const absolute = import_node_path9.default.resolve(manifestPath);
   return parseArtifactManifest(absolute, await (0, import_promises5.readFile)(absolute, "utf8"));
 }
 async function readOptional(file) {
@@ -9825,8 +10069,8 @@ function processIsAlive(pid) {
   }
 }
 function validTemporaryPath(candidate, destination, type) {
-  return import_node_path8.default.dirname(candidate) === import_node_path8.default.dirname(destination) && import_node_path8.default.basename(candidate).startsWith(
-    `.${import_node_path8.default.basename(destination)}.pixelkiln-${type}-`
+  return import_node_path9.default.dirname(candidate) === import_node_path9.default.dirname(destination) && import_node_path9.default.basename(candidate).startsWith(
+    `.${import_node_path9.default.basename(destination)}.pixelkiln-${type}-`
   );
 }
 function parseTransaction(journal, data) {
@@ -9846,7 +10090,7 @@ async function removeTransactionFiles(journal) {
   await (0, import_promises5.rm)(transactionMarker(journal), { force: true });
 }
 async function recoverArtifactTransaction(recoveryFile, allowedDestinations) {
-  const journal = import_node_path8.default.resolve(recoveryFile);
+  const journal = import_node_path9.default.resolve(recoveryFile);
   const bytes = await readOptional(journal);
   if (!bytes) {
     await (0, import_promises5.rm)(transactionMarker(journal), { force: true });
@@ -9862,7 +10106,7 @@ async function recoverArtifactTransaction(recoveryFile, allowedDestinations) {
     );
   }
   for (const entry of transaction.entries) {
-    if (typeof entry.destination !== "string" || typeof entry.stage !== "string" || typeof entry.sha256 !== "string" || entry.backup !== void 0 && typeof entry.backup !== "string" || !allowedDestinations.has(import_node_path8.default.resolve(entry.destination)) || !validTemporaryPath(entry.stage, entry.destination, "stage") || entry.backup !== void 0 && !validTemporaryPath(entry.backup, entry.destination, "backup")) {
+    if (typeof entry.destination !== "string" || typeof entry.stage !== "string" || typeof entry.sha256 !== "string" || entry.backup !== void 0 && typeof entry.backup !== "string" || !allowedDestinations.has(import_node_path9.default.resolve(entry.destination)) || !validTemporaryPath(entry.stage, entry.destination, "stage") || entry.backup !== void 0 && !validTemporaryPath(entry.backup, entry.destination, "backup")) {
       throw new Error(
         `Refusing unsafe artifact recovery from ${journal}; its destinations or temporary paths do not match the current bundle.`
       );
@@ -9908,7 +10152,7 @@ async function recoverArtifactTransaction(recoveryFile, allowedDestinations) {
   await removeTransactionFiles(journal);
 }
 function createArtifactBundleManifest(manifestPath, outputs, provenance) {
-  const root = import_node_path8.default.dirname(import_node_path8.default.resolve(manifestPath));
+  const root = import_node_path9.default.dirname(import_node_path9.default.resolve(manifestPath));
   const sources = provenance.sources.map((source) => ({
     ...source,
     path: portableRelative(root, source.path)
@@ -9938,11 +10182,11 @@ function withArtifactManifest(manifestPath, outputs, provenance) {
   ];
 }
 async function writeManagedArtifactBundle(manifestPath, outputs, provenance, options = {}) {
-  const absoluteManifest = import_node_path8.default.resolve(manifestPath);
+  const absoluteManifest = import_node_path9.default.resolve(manifestPath);
   const recoveryFile = `${absoluteManifest}.transaction`;
   const allowedDestinations = /* @__PURE__ */ new Set([
     absoluteManifest,
-    ...outputs.map((output) => import_node_path8.default.resolve(output.path))
+    ...outputs.map((output) => import_node_path9.default.resolve(output.path))
   ]);
   await recoverArtifactTransaction(recoveryFile, allowedDestinations);
   const existingManifestBytes = await readOptional(absoluteManifest);
@@ -9960,13 +10204,13 @@ async function writeManagedArtifactBundle(manifestPath, outputs, provenance, opt
     }
   }
   if (!options.force) {
-    const root = import_node_path8.default.dirname(absoluteManifest);
+    const root = import_node_path9.default.dirname(absoluteManifest);
     const recorded = new Map(
-      previous?.outputs.map((output) => [import_node_path8.default.resolve(root, output.path), output.sha256]) ?? []
+      previous?.outputs.map((output) => [import_node_path9.default.resolve(root, output.path), output.sha256]) ?? []
     );
     const conflicts = [];
     for (const output of outputs) {
-      const destination = import_node_path8.default.resolve(output.path);
+      const destination = import_node_path9.default.resolve(output.path);
       const current = await readOptional(destination);
       if (!current || digest(current) === digest(output.data)) continue;
       const expected = recorded.get(destination);
@@ -9988,15 +10232,15 @@ Pass { force: true } (CLI: --force) to take ownership and replace the complete b
   );
 }
 async function verifyArtifactBundle(manifestPath) {
-  const absolute = import_node_path8.default.resolve(manifestPath);
+  const absolute = import_node_path9.default.resolve(manifestPath);
   const raw = await readArtifactBundleManifest(absolute);
-  const root = import_node_path8.default.dirname(absolute);
+  const root = import_node_path9.default.dirname(absolute);
   const changedSources = [];
   const changedOutputs = [];
   for (const source of raw.sources) {
     let actual = null;
     try {
-      actual = digest(await (0, import_promises5.readFile)(import_node_path8.default.resolve(root, source.path)));
+      actual = digest(await (0, import_promises5.readFile)(import_node_path9.default.resolve(root, source.path)));
     } catch (error) {
       if (!isCode(error, "ENOENT")) throw error;
     }
@@ -10004,7 +10248,7 @@ async function verifyArtifactBundle(manifestPath) {
   }
   for (const output of raw.outputs) {
     try {
-      if (digest(await (0, import_promises5.readFile)(import_node_path8.default.resolve(root, output.path))) !== output.sha256) {
+      if (digest(await (0, import_promises5.readFile)(import_node_path9.default.resolve(root, output.path))) !== output.sha256) {
         changedOutputs.push(output.path);
       }
     } catch (error) {
@@ -10060,7 +10304,7 @@ async function writeArtifactBundle(files, options = {}) {
   if (!files.length) throw new Error("An artifact bundle must contain at least one file.");
   const normalized = files.map((file) => {
     if (!file.path.trim()) throw new Error("Artifact paths cannot be empty.");
-    return { destination: import_node_path8.default.resolve(file.path), data: Buffer.from(file.data) };
+    return { destination: import_node_path9.default.resolve(file.path), data: Buffer.from(file.data) };
   });
   const destinations = /* @__PURE__ */ new Set();
   for (const artifact of normalized) {
@@ -10088,23 +10332,23 @@ async function writeArtifactBundle(files, options = {}) {
     }
   }
   if (!changed.length) return { changed: [], unchanged };
-  const token = (0, import_node_crypto5.randomUUID)();
+  const token = (0, import_node_crypto6.randomUUID)();
   for (const [index, artifact] of changed.entries()) {
-    const basename = import_node_path8.default.basename(artifact.destination);
-    artifact.stage = import_node_path8.default.join(
-      import_node_path8.default.dirname(artifact.destination),
+    const basename = import_node_path9.default.basename(artifact.destination);
+    artifact.stage = import_node_path9.default.join(
+      import_node_path9.default.dirname(artifact.destination),
       `.${basename}.pixelkiln-stage-${token}-${index}`
     );
     if (artifact.existed) {
-      artifact.backup = import_node_path8.default.join(
-        import_node_path8.default.dirname(artifact.destination),
+      artifact.backup = import_node_path9.default.join(
+        import_node_path9.default.dirname(artifact.destination),
         `.${basename}.pixelkiln-backup-${token}-${index}`
       );
     }
   }
-  const journal = options.recoveryFile ? import_node_path8.default.resolve(options.recoveryFile) : null;
+  const journal = options.recoveryFile ? import_node_path9.default.resolve(options.recoveryFile) : null;
   if (journal) {
-    await (0, import_promises5.mkdir)(import_node_path8.default.dirname(journal), { recursive: true });
+    await (0, import_promises5.mkdir)(import_node_path9.default.dirname(journal), { recursive: true });
     const transaction = {
       format: "pixelkiln-artifact-transaction",
       version: 1,
@@ -10129,7 +10373,7 @@ async function writeArtifactBundle(files, options = {}) {
   }
   try {
     for (const [index, artifact] of changed.entries()) {
-      await (0, import_promises5.mkdir)(import_node_path8.default.dirname(artifact.destination), { recursive: true });
+      await (0, import_promises5.mkdir)(import_node_path9.default.dirname(artifact.destination), { recursive: true });
       await options.beforeStage?.(artifact.destination, index);
       await (0, import_promises5.writeFile)(artifact.stage, artifact.data, { flag: "wx" });
     }
@@ -10395,10 +10639,10 @@ function sameFrameGrid(first, next) {
   return next.detection.stepX === first.detection.stepX && next.detection.stepY === first.detection.stepY && next.detection.columns === first.detection.columns && next.detection.rows === first.detection.rows && phaseMatches(next.detection.phaseX, first.detection.phaseX, first.detection.stepX) && phaseMatches(next.detection.phaseY, first.detection.phaseY, first.detection.stepY) && next.audit.width === first.audit.width && next.audit.height === first.audit.height && next.sourceWidth === first.sourceWidth && next.sourceHeight === first.sourceHeight;
 }
 async function refineAsset(options) {
-  const source = import_node_path9.default.resolve(options.source);
-  const output = import_node_path9.default.resolve(options.output);
+  const source = import_node_path10.default.resolve(options.source);
+  const output = import_node_path10.default.resolve(options.output);
   if (source === output) throw new Error("Refinement source and output must be different files.");
-  const record = import_node_path9.default.resolve(qualityRecordPath(output));
+  const record = import_node_path10.default.resolve(qualityRecordPath(output));
   const palette = normalizePalette(options.palette).map((color) => color.hex);
   const minGridConfidence = requireConfidence(options.minGridConfidence ?? "high");
   if (options.minTransparency !== void 0 && (!Number.isFinite(options.minTransparency) || options.minTransparency < 0 || options.minTransparency > 1)) throw new Error("minTransparency must be between 0 and 1.");
@@ -10421,8 +10665,8 @@ async function refineAsset(options) {
       );
     }
   }
-  const temp = await (0, import_promises6.mkdtemp)(import_node_path9.default.join((0, import_node_os2.tmpdir)(), "pixelkiln-refine-"));
-  const recovered = import_node_path9.default.join(temp, "native.png");
+  const temp = await (0, import_promises6.mkdtemp)(import_node_path10.default.join((0, import_node_os3.tmpdir)(), "pixelkiln-refine-"));
+  const recovered = import_node_path10.default.join(temp, "native.png");
   const fixerCommand = compatibilityCommand ?? options.fixerPython ?? process.env.PIXELKILN_PIXEL_FIXER_PYTHON ?? "python3";
   const args = compatibilityCommand ? [...options.fixerArgsPrefix ?? [], source, "--extract", recovered] : ["-c", PYTHON_FIXER_BRIDGE, source, recovered];
   try {
@@ -10507,18 +10751,18 @@ async function refineFrameSet(options) {
   if (roles.some((role) => !role.trim()) || new Set(roles).size !== roles.length) {
     throw new Error("Frame-set roles must be non-empty and unique.");
   }
-  const output = import_node_path9.default.resolve(options.output);
-  const record = import_node_path9.default.resolve(qualityRecordPath(output));
+  const output = import_node_path10.default.resolve(options.output);
+  const record = import_node_path10.default.resolve(qualityRecordPath(output));
   const palette = normalizeRefinementPalette(options.palette);
   const finalOutputs = options.sources.map((source, index) => qualityFrameOutputPath(output, source.role, index));
   if (new Set(finalOutputs).size !== finalOutputs.length) {
     throw new Error("Frame-set roles resolve to duplicate output filenames.");
   }
-  const sourceSet = new Set(options.sources.map((source) => import_node_path9.default.resolve(source.path)));
+  const sourceSet = new Set(options.sources.map((source) => import_node_path10.default.resolve(source.path)));
   if (finalOutputs.some((file) => sourceSet.has(file))) {
     throw new Error("Frame-set refinement sources and outputs must be different files.");
   }
-  const temp = await (0, import_promises6.mkdtemp)(import_node_path9.default.join((0, import_node_os2.tmpdir)(), "pixelkiln-refine-frames-"));
+  const temp = await (0, import_promises6.mkdtemp)(import_node_path10.default.join((0, import_node_os3.tmpdir)(), "pixelkiln-refine-frames-"));
   try {
     const frames = [];
     const outputs = [];
@@ -10526,8 +10770,8 @@ async function refineFrameSet(options) {
     const sourcePaths = [];
     let firstOptions = null;
     for (const [index, sourceEntry] of options.sources.entries()) {
-      const source = import_node_path9.default.resolve(sourceEntry.path);
-      const temporaryOutput = import_node_path9.default.join(temp, `${String(index).padStart(2, "0")}.png`);
+      const source = import_node_path10.default.resolve(sourceEntry.path);
+      const temporaryOutput = import_node_path10.default.join(temp, `${String(index).padStart(2, "0")}.png`);
       const refined = await refineAsset({
         source,
         output: temporaryOutput,
@@ -10602,7 +10846,7 @@ async function refineFrameSet(options) {
     );
     return {
       sources: sourcePaths,
-      outputs: outputs.map((item) => import_node_path9.default.resolve(item.path)),
+      outputs: outputs.map((item) => import_node_path10.default.resolve(item.path)),
       record,
       frames,
       palette,
@@ -10613,12 +10857,12 @@ async function refineFrameSet(options) {
   }
 }
 async function checkQualityRecord(recordPath) {
-  const record = import_node_path9.default.resolve(recordPath);
+  const record = import_node_path10.default.resolve(recordPath);
   const manifest = await readArtifactBundleManifest(record);
   const options = parseRecordOptions(manifest, record);
   const verification = await verifyArtifactBundle(record);
-  const sources = manifest.sources.map((source2) => import_node_path9.default.resolve(import_node_path9.default.dirname(record), source2.path));
-  const outputs = manifest.outputs.map((output2) => import_node_path9.default.resolve(import_node_path9.default.dirname(record), output2.path));
+  const sources = manifest.sources.map((source2) => import_node_path10.default.resolve(import_node_path10.default.dirname(record), source2.path));
+  const outputs = manifest.outputs.map((output2) => import_node_path10.default.resolve(import_node_path10.default.dirname(record), output2.path));
   const source = sources[0] ?? "";
   const output = outputs[0] ?? "";
   const expectedCount = options.frameSet?.count ?? 1;
@@ -10651,7 +10895,7 @@ async function checkQualityRecord(recordPath) {
 async function approveQualityRecord(recordPath, approval) {
   const reviewer = approval.reviewer.trim();
   if (!reviewer) throw new Error("A human reviewer name is required.");
-  const record = import_node_path9.default.resolve(recordPath);
+  const record = import_node_path10.default.resolve(recordPath);
   const manifest = await readArtifactBundleManifest(record);
   const options = parseRecordOptions(manifest, record);
   const verification = await verifyArtifactBundle(record);
@@ -10672,14 +10916,14 @@ async function approveQualityRecord(recordPath, approval) {
       `A refinement record must contain exactly ${expectedCount} source(s) and output(s).`
     );
   }
-  const root = import_node_path9.default.dirname(record);
+  const root = import_node_path10.default.dirname(record);
   const outputs = await Promise.all(manifest.outputs.map(async (entry) => {
-    const outputPath = import_node_path9.default.resolve(root, entry.path);
+    const outputPath = import_node_path10.default.resolve(root, entry.path);
     return { path: outputPath, data: await (0, import_promises6.readFile)(outputPath) };
   }));
   const sources = manifest.sources.map((source) => ({
     ...source,
-    path: import_node_path9.default.resolve(root, source.path)
+    path: import_node_path10.default.resolve(root, source.path)
   }));
   const approved = {
     ...options,
@@ -10711,8 +10955,8 @@ async function qualitySource(spec, lock) {
     if (spec.generator === "frames") {
       return { items: null, reason: "frame-set quality requires ordered downloaded provider outputs" };
     }
-    const source = import_node_path10.default.resolve(spec.root, spec.source);
-    return (0, import_node_fs7.existsSync)(source) ? { items: [{ role: "source", path: source }] } : { items: null, reason: `declared source is missing: ${spec.source}` };
+    const source = import_node_path11.default.resolve(spec.root, spec.source);
+    return (0, import_node_fs8.existsSync)(source) ? { items: [{ role: "source", path: source }] } : { items: null, reason: `declared source is missing: ${spec.source}` };
   }
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
   if (!entry) return { items: null, reason: "raw provider output is not in the lockfile" };
@@ -10741,7 +10985,7 @@ async function qualitySource(spec, lock) {
     }
     if (role) roles.add(role);
     const source = currentEntryOutputPath(entry, spec, index);
-    if (!(0, import_node_fs7.existsSync)(source)) return { items: null, reason: `raw provider output is missing: ${source}` };
+    if (!(0, import_node_fs8.existsSync)(source)) return { items: null, reason: `raw provider output is missing: ${source}` };
     if (await sha256File(source) !== output.sha256) {
       return { items: null, reason: "raw provider output was modified after download" };
     }
@@ -10760,7 +11004,7 @@ async function inspectQualityProfile(spec, lock) {
   }
   const sourcePaths = source.items.map((item) => item.path);
   const expectedOutputs = spec.generator === "frames" ? source.items.map((item, index) => qualityFrameOutputPath(output, item.role, index)) : [output];
-  if (!(0, import_node_fs7.existsSync)(record)) {
+  if (!(0, import_node_fs8.existsSync)(record)) {
     return {
       key,
       state: "needs-refinement",
@@ -10778,7 +11022,7 @@ async function inspectQualityProfile(spec, lock) {
     const expectedRevision = spec.quality.fixerRevision ?? PIXEL_ART_FIXER_REVISION;
     const expectedTransparency = spec.quality.minTransparency ?? null;
     const expectedFrameSet = spec.generator === "frames" ? { fps: spec.quality.fps ?? 12, count: source.items.length, roles: source.items.map((item) => item.role) } : null;
-    const contractChanged = JSON.stringify(check.sources.map((item) => import_node_path10.default.resolve(item))) !== JSON.stringify(sourcePaths.map((item) => import_node_path10.default.resolve(item))) || JSON.stringify(check.outputs.map((item) => import_node_path10.default.resolve(item))) !== JSON.stringify(expectedOutputs.map((item) => import_node_path10.default.resolve(item))) || JSON.stringify(check.options.palette.colors) !== JSON.stringify(expectedPalette) || check.options.nativeGrid.revision !== expectedRevision || check.options.audit.thresholds.minGridConfidence !== spec.quality.minGridConfidence || check.options.audit.thresholds.minTransparency !== expectedTransparency || (expectedFrameSet ? !check.options.frameSet || check.options.frameSet.fps !== expectedFrameSet.fps || check.options.frameSet.count !== expectedFrameSet.count || JSON.stringify(check.options.frameSet.roles) !== JSON.stringify(expectedFrameSet.roles) : check.options.frameSet !== void 0);
+    const contractChanged = JSON.stringify(check.sources.map((item) => import_node_path11.default.resolve(item))) !== JSON.stringify(sourcePaths.map((item) => import_node_path11.default.resolve(item))) || JSON.stringify(check.outputs.map((item) => import_node_path11.default.resolve(item))) !== JSON.stringify(expectedOutputs.map((item) => import_node_path11.default.resolve(item))) || JSON.stringify(check.options.palette.colors) !== JSON.stringify(expectedPalette) || check.options.nativeGrid.revision !== expectedRevision || check.options.audit.thresholds.minGridConfidence !== spec.quality.minGridConfidence || check.options.audit.thresholds.minTransparency !== expectedTransparency || (expectedFrameSet ? !check.options.frameSet || check.options.frameSet.fps !== expectedFrameSet.fps || check.options.frameSet.count !== expectedFrameSet.count || JSON.stringify(check.options.frameSet.roles) !== JSON.stringify(expectedFrameSet.roles) : check.options.frameSet !== void 0);
     if (contractChanged) {
       return {
         key,
@@ -10941,8 +11185,8 @@ async function requireApprovedQualitySources(specs, lock, assetIds, outputRoles)
 }
 
 // src/pipeline/revision.ts
-var import_node_fs8 = require("fs");
-var import_node_path11 = __toESM(require("path"), 1);
+var import_node_fs9 = require("fs");
+var import_node_path12 = __toESM(require("path"), 1);
 async function inspectRevisionReadiness(spec, lock) {
   if (spec.mirror) return inspectMirror(spec, lock, /* @__PURE__ */ new Set());
   if (spec.character?.kind === "outfit") return inspectOutfit(spec, lock, /* @__PURE__ */ new Set());
@@ -10958,7 +11202,7 @@ async function inspectStyleAnchor(spec, lock, seen) {
   const label = `style anchor ${spec.styleId}/${anchor.assetId}`;
   const dependency = await inspectParent(anchor.spec, lock, seen);
   if (!dependency.ready) return { ready: false, reason: `${label} is not ready: ${dependency.reason}` };
-  if (!anchor.sha256 || !(0, import_node_fs8.existsSync)(anchor.file)) return { ready: false, reason: `${label} has no generated south-facing file yet` };
+  if (!anchor.sha256 || !(0, import_node_fs9.existsSync)(anchor.file)) return { ready: false, reason: `${label} has no generated south-facing file yet` };
   if (await sha256File(anchor.file) !== anchor.sha256) {
     return { ready: false, reason: `${label} changed after the manifest was resolved` };
   }
@@ -10972,7 +11216,7 @@ async function inspectScene(spec) {
   const files = [{ label: "scene image", file: scene.file, sha256: scene.sha256 }];
   if (scene.placement.type === "mask") files.push({ label: "scene mask", file: scene.placement.file, sha256: scene.placement.sha256 });
   for (const { label, file, sha256: sha2562 } of files) {
-    if (!sha2562 || !(0, import_node_fs8.existsSync)(file)) return { ready: false, reason: `${label} does not exist yet: ${file}` };
+    if (!sha2562 || !(0, import_node_fs9.existsSync)(file)) return { ready: false, reason: `${label} does not exist yet: ${file}` };
     if (await sha256File(file) !== sha2562) return { ready: false, reason: `${label} changed after the manifest was resolved` };
   }
   return { ready: true, reason: "scene is current" };
@@ -10989,7 +11233,7 @@ async function inspectOutfit(spec, lock, seen) {
   const label = `outfit source ${spec.styleId}/${character.parentAssetId}`;
   const dependency = await inspectParent(character.parentSpec, lock, seen);
   if (!dependency.ready) return { ready: false, reason: `${label} is not ready: ${dependency.reason}` };
-  if (!(0, import_node_fs8.existsSync)(outfit.reference.path)) {
+  if (!(0, import_node_fs9.existsSync)(outfit.reference.path)) {
     return { ready: false, reason: `outfit reference is missing: ${outfit.reference.path}` };
   }
   if (await sha256File(outfit.reference.path) !== outfit.reference.sha256) {
@@ -11003,7 +11247,7 @@ async function inspectCharacterParent(spec, lock, seen) {
   const label = `${character.kind} parent ${spec.styleId}/${character.parentAssetId}`;
   const dependency = await inspectParent(parentSpec, lock, seen);
   if (!dependency.ready) return { ready: false, reason: `${label} is not ready: ${dependency.reason}` };
-  if (!character.parentSha256 || !character.parentFile || !(0, import_node_fs8.existsSync)(character.parentFile)) {
+  if (!character.parentSha256 || !character.parentFile || !(0, import_node_fs9.existsSync)(character.parentFile)) {
     return { ready: false, reason: `${label} has no generated south-facing file yet` };
   }
   if (await sha256File(character.parentFile) !== character.parentSha256) {
@@ -11021,7 +11265,7 @@ async function inspectObjectProParent(spec, lock, seen) {
   const label = `${object.kind} parent ${spec.styleId}/${object.parentAssetId}`;
   const dependency = await inspectParent(parentSpec, lock, seen);
   if (!dependency.ready) return { ready: false, reason: `${label} is not ready: ${dependency.reason}` };
-  if (!object.parentSha256 || !object.parentFile || !(0, import_node_fs8.existsSync)(object.parentFile)) {
+  if (!object.parentSha256 || !object.parentFile || !(0, import_node_fs9.existsSync)(object.parentFile)) {
     return { ready: false, reason: `${label} has no generated south-facing file yet` };
   }
   if (await sha256File(object.parentFile) !== object.parentSha256) {
@@ -11047,7 +11291,7 @@ async function inspectRevision(spec, lock, seen) {
     const members = await inspectSourceMembers(spec, lock);
     if (!members.ready) return members;
   } else {
-    if (!revision.sourceSha256 || !(0, import_node_fs8.existsSync)(revision.sourceFile)) {
+    if (!revision.sourceSha256 || !(0, import_node_fs9.existsSync)(revision.sourceFile)) {
       return { ready: false, reason: `revision source is missing: ${revision.sourceFile}` };
     }
     if (await sha256File(revision.sourceFile) !== revision.sourceSha256) {
@@ -11055,7 +11299,7 @@ async function inspectRevision(spec, lock, seen) {
     }
   }
   if (revision.maskFile) {
-    if (!revision.maskSha256 || !(0, import_node_fs8.existsSync)(revision.maskFile)) {
+    if (!revision.maskSha256 || !(0, import_node_fs9.existsSync)(revision.maskFile)) {
       return { ready: false, reason: `revision mask is missing: ${revision.maskFile}` };
     }
     if (await sha256File(revision.maskFile) !== revision.maskSha256) {
@@ -11063,7 +11307,7 @@ async function inspectRevision(spec, lock, seen) {
     }
   }
   if (revision.lastFrameFile) {
-    if (!revision.lastFrameSha256 || !(0, import_node_fs8.existsSync)(revision.lastFrameFile)) {
+    if (!revision.lastFrameSha256 || !(0, import_node_fs9.existsSync)(revision.lastFrameFile)) {
       return { ready: false, reason: `revision last frame is missing: ${revision.lastFrameFile}` };
     }
     if (await sha256File(revision.lastFrameFile) !== revision.lastFrameSha256) {
@@ -11076,7 +11320,7 @@ async function inspectSourceMembers(spec, lock) {
   const revision = spec.revision;
   const members = revision.sourceMembers;
   for (const member of members) {
-    if (!(0, import_node_fs8.existsSync)(member.file)) return { ready: false, reason: `revision source member is missing: ${member.file}` };
+    if (!(0, import_node_fs9.existsSync)(member.file)) return { ready: false, reason: `revision source member is missing: ${member.file}` };
     if (await sha256File(member.file) !== member.sha256) {
       return { ready: false, reason: `revision source member changed after the manifest was resolved: ${member.file}` };
     }
@@ -11085,8 +11329,8 @@ async function inspectSourceMembers(spec, lock) {
   if (parent.source) return { ready: true, reason: "declared source set is present" };
   const entry = lock.entries[lockKey(parent.styleId, parent.assetId)];
   if (!entry) return { ready: false, reason: "revision source is not in the lockfile" };
-  const recorded = entry.outputs.map((_, index) => import_node_path11.default.resolve(currentEntryOutputPath(entry, parent, index))).sort();
-  const found = members.map((member) => import_node_path11.default.resolve(member.file)).sort();
+  const recorded = entry.outputs.map((_, index) => import_node_path12.default.resolve(currentEntryOutputPath(entry, parent, index))).sort();
+  const found = members.map((member) => import_node_path12.default.resolve(member.file)).sort();
   if (recorded.length !== found.length || recorded.some((file, index) => file !== found[index])) {
     return {
       ready: false,
@@ -11135,8 +11379,8 @@ async function inspectParent(spec, lock, seen) {
     };
   }
   if (spec.source) {
-    const source = import_node_path11.default.resolve(spec.root, spec.source);
-    return (0, import_node_fs8.existsSync)(source) ? { ready: true, reason: "declared source is present" } : { ready: false, reason: `declared source is missing: ${spec.source}` };
+    const source = import_node_path12.default.resolve(spec.root, spec.source);
+    return (0, import_node_fs9.existsSync)(source) ? { ready: true, reason: "declared source is present" } : { ready: false, reason: `declared source is missing: ${spec.source}` };
   }
   const entry = lock.entries[key];
   if (!entry) return { ready: false, reason: "parent is not in the lockfile" };
@@ -11150,7 +11394,7 @@ async function inspectParent(spec, lock, seen) {
   for (let index = 0; index < entry.outputs.length; index++) {
     const output = entry.outputs[index];
     const file = currentEntryOutputPath(entry, spec, index);
-    if (!(0, import_node_fs8.existsSync)(file)) return { ready: false, reason: `parent output is missing: ${file}` };
+    if (!(0, import_node_fs9.existsSync)(file)) return { ready: false, reason: `parent output is missing: ${file}` };
     if (await sha256File(file) !== output.sha256) {
       return { ready: false, reason: `parent output was modified: ${file}` };
     }
@@ -11214,7 +11458,7 @@ async function buildPlan(specs, lock, opts = {}) {
       state = "missing";
       reason = "--force";
     } else if (!entry && spec.source && spec.generator !== "frames") {
-      if ((0, import_node_fs9.existsSync)(import_node_path12.default.resolve(spec.root, spec.source))) {
+      if ((0, import_node_fs10.existsSync)(import_node_path13.default.resolve(spec.root, spec.source))) {
         state = "ok";
         reason = `placed from ${spec.source}; not generated`;
       } else {
@@ -11222,7 +11466,7 @@ async function buildPlan(specs, lock, opts = {}) {
         reason = `declared source is missing: ${spec.source}`;
       }
     } else if (!entry) {
-      if ((0, import_node_fs9.existsSync)(spec.outFile)) {
+      if ((0, import_node_fs10.existsSync)(spec.outFile)) {
         state = "untracked";
         reason = "file on disk, no provenance recorded";
       } else {
@@ -11235,7 +11479,7 @@ async function buildPlan(specs, lock, opts = {}) {
     } else if (spec.mirror && !mirrorCurrent(entry, lock.entries[lockKey(spec.styleId, spec.mirror.sourceAssetId)])) {
       state = "stale";
       reason = `mirror source ${spec.mirror.sourceAssetId} changed; flip it again (no generation cost)`;
-    } else if (spec.mirror && entry.status === "downloaded" && entry.outputs.some((_output, index) => !(0, import_node_fs9.existsSync)(currentEntryOutputPath(entry, spec, index)))) {
+    } else if (spec.mirror && entry.status === "downloaded" && entry.outputs.some((_output, index) => !(0, import_node_fs10.existsSync)(currentEntryOutputPath(entry, spec, index)))) {
       state = "stale";
       reason = "mirror output missing on disk; flip it again (no generation cost)";
     } else if (spec.character?.kind === "outfit" && entry.outfit?.sourceSha256 !== mirrorSourceHash(lock.entries[lockKey(spec.styleId, spec.character.parentAssetId)] ?? { outputs: [] })) {
@@ -11263,9 +11507,9 @@ async function buildPlan(specs, lock, opts = {}) {
     } else if (entry.status !== "downloaded") {
       state = "in-flight";
       reason = `awaiting ${entry.status}`;
-    } else if (entry.outputs.length === 0 || entry.outputs.some((_output, index) => !(0, import_node_fs9.existsSync)(currentEntryOutputPath(entry, spec, index)))) {
+    } else if (entry.outputs.length === 0 || entry.outputs.some((_output, index) => !(0, import_node_fs10.existsSync)(currentEntryOutputPath(entry, spec, index)))) {
       state = "orphaned";
-      reason = entry.outputs.length === 0 ? "no recorded output files" : `missing on disk: ${entry.outputs.filter((_output, index) => !(0, import_node_fs9.existsSync)(currentEntryOutputPath(entry, spec, index))).map((o) => o.role ?? "asset").join(", ")}`;
+      reason = entry.outputs.length === 0 ? "no recorded output files" : `missing on disk: ${entry.outputs.filter((_output, index) => !(0, import_node_fs10.existsSync)(currentEntryOutputPath(entry, spec, index))).map((o) => o.role ?? "asset").join(", ")}`;
     } else if (await anyOutputModified(entry, spec)) {
       state = "orphaned";
       reason = "output modified since download";
@@ -11356,13 +11600,13 @@ function summarize(plan) {
 
 // src/project.ts
 async function openProject(manifestPath = "pixelkiln.manifest.json", opts = {}) {
-  const absolute = import_node_path13.default.resolve(manifestPath);
-  const root = import_node_path13.default.dirname(absolute);
+  const absolute = import_node_path14.default.resolve(manifestPath);
+  const root = import_node_path14.default.dirname(absolute);
   if (opts.env !== false) {
     loadEnvFiles(root);
-    if (import_node_path13.default.resolve(process.cwd()) !== root) loadEnvFiles(process.cwd());
+    if (import_node_path14.default.resolve(process.cwd()) !== root) loadEnvFiles(process.cwd());
   }
-  const lockPath = import_node_path13.default.resolve(opts.lockPath ?? import_node_path13.default.join(root, "pixelkiln.lock.json"));
+  const lockPath = import_node_path14.default.resolve(opts.lockPath ?? import_node_path14.default.join(root, "pixelkiln.lock.json"));
   const loaded = await loadManifest(absolute);
   const specs = await resolveSpecs(loaded, { styles: opts.styles ?? [], assets: opts.assets ?? [] });
   const lock = await loadLock(lockPath);
@@ -11429,8 +11673,8 @@ function shouldPersistSourceUrl(value) {
 }
 
 // src/recipes.ts
-var import_node_path14 = __toESM(require("path"), 1);
-var import_node_fs10 = require("fs");
+var import_node_path15 = __toESM(require("path"), 1);
+var import_node_fs11 = require("fs");
 var import_promises7 = require("fs/promises");
 var import_node_url = require("url");
 var import_zod4 = require("zod");
@@ -11440,7 +11684,7 @@ var VERSION_RE = /^\d+\.\d+\.\d+$/;
 var RECIPE_FILE = "pixelkiln.recipe.json";
 var RECIPE_DIR_TOKEN = "{{recipeDir}}";
 var PortablePathSchema = import_zod4.z.string().min(1).refine((value) => {
-  if (value.includes("\\") || import_node_path14.default.posix.isAbsolute(value)) return false;
+  if (value.includes("\\") || import_node_path15.default.posix.isAbsolute(value)) return false;
   const parts = value.split("/");
   return !parts.includes("") && !parts.includes(".") && !parts.includes("..");
 }, "expected a portable relative path without '.', '..', or backslashes");
@@ -11616,7 +11860,7 @@ function message3(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function readRecipeFile(recipePath, bundled) {
-  const absolute = import_node_path14.default.resolve(recipePath);
+  const absolute = import_node_path15.default.resolve(recipePath);
   let raw;
   try {
     raw = JSON.parse(await (0, import_promises7.readFile)(absolute, "utf8"));
@@ -11630,13 +11874,13 @@ async function readRecipeFile(recipePath, bundled) {
 ` + parsed.error.issues.map((issue) => `  ${issue.path.join(".") || "$"}: ${issue.message}`).join("\n")
     );
   }
-  return { recipe: parsed.data, authored: raw, path: absolute, dir: import_node_path14.default.dirname(absolute), bundled };
+  return { recipe: parsed.data, authored: raw, path: absolute, dir: import_node_path15.default.dirname(absolute), bundled };
 }
 async function walkRecipeFiles(root) {
-  if (!(0, import_node_fs10.existsSync)(root)) return [];
+  if (!(0, import_node_fs11.existsSync)(root)) return [];
   const out = [];
   for (const entry of await (0, import_promises7.readdir)(root, { withFileTypes: true })) {
-    const resolved = import_node_path14.default.join(root, entry.name);
+    const resolved = import_node_path15.default.join(root, entry.name);
     if (entry.isDirectory()) out.push(...await walkRecipeFiles(resolved));
     else if (entry.isFile() && entry.name === RECIPE_FILE) out.push(resolved);
   }
@@ -11647,7 +11891,7 @@ function bundledRecipeRoot() {
 }
 async function listBundledRecipes(root = bundledRecipeRoot()) {
   const recipes = await Promise.all(
-    (await walkRecipeFiles(import_node_path14.default.resolve(root))).map((file) => readRecipeFile(file, true))
+    (await walkRecipeFiles(import_node_path15.default.resolve(root))).map((file) => readRecipeFile(file, true))
   );
   return recipes.sort(
     (a, b) => a.recipe.id.localeCompare(b.recipe.id) || compareVersions(b.recipe.version, a.recipe.version)
@@ -11670,9 +11914,9 @@ function parseSelector(selector) {
   return { id: match[1], version: match[2] };
 }
 async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
-  const local = import_node_path14.default.resolve(target);
-  if ((0, import_node_fs10.existsSync)(local)) {
-    const recipePath = import_node_path14.default.basename(local) === RECIPE_FILE ? local : import_node_path14.default.join(local, RECIPE_FILE);
+  const local = import_node_path15.default.resolve(target);
+  if ((0, import_node_fs11.existsSync)(local)) {
+    const recipePath = import_node_path15.default.basename(local) === RECIPE_FILE ? local : import_node_path15.default.join(local, RECIPE_FILE);
     return readRecipeFile(recipePath, false);
   }
   if (target.startsWith(".") || target.startsWith("/") || target.includes("\\")) {
@@ -11686,8 +11930,8 @@ async function resolveRecipe(target, bundledRoot = bundledRecipeRoot()) {
   return matches[0];
 }
 async function verifyFile(root, file) {
-  const absolute = import_node_path14.default.resolve(root, ...file.path.split("/"));
-  if (!(0, import_node_fs10.existsSync)(absolute)) {
+  const absolute = import_node_path15.default.resolve(root, ...file.path.split("/"));
+  if (!(0, import_node_fs11.existsSync)(absolute)) {
     return { path: file.path, expectedSha256: file.sha256, actualSha256: null, status: "missing" };
   }
   const actualSha256 = await sha256File(absolute);
@@ -11702,7 +11946,7 @@ async function verifyRecipe(target, options = {}) {
   const loaded = await resolveRecipe(target, options.bundledRoot);
   const actualIntegrity = recipeDigest(loaded.authored);
   const files = await Promise.all(loaded.recipe.files.map((file) => verifyFile(loaded.dir, file)));
-  const modelRoot = options.modelRoot ? import_node_path14.default.resolve(options.modelRoot) : null;
+  const modelRoot = options.modelRoot ? import_node_path15.default.resolve(options.modelRoot) : null;
   const models = modelRoot ? await Promise.all(loaded.recipe.models.map(async (model) => ({
     ...await verifyFile(modelRoot, model),
     source: model.source,
@@ -11736,7 +11980,7 @@ async function verifyRecipe(target, options = {}) {
   };
 }
 function renderStyle(style, destination, cwd) {
-  const portableDir = import_node_path14.default.relative(cwd, destination).split(import_node_path14.default.sep).join("/") || ".";
+  const portableDir = import_node_path15.default.relative(cwd, destination).split(import_node_path15.default.sep).join("/") || ".";
   const replace = (value) => {
     if (typeof value === "string") return value.replaceAll(RECIPE_DIR_TOKEN, portableDir);
     if (Array.isArray(value)) return value.map(replace);
@@ -11748,24 +11992,24 @@ function renderStyle(style, destination, cwd) {
   return replace(style);
 }
 async function installRecipe(target, options = {}) {
-  const cwd = import_node_path14.default.resolve(options.cwd ?? process.cwd());
+  const cwd = import_node_path15.default.resolve(options.cwd ?? process.cwd());
   const loaded = await resolveRecipe(target, options.bundledRoot);
   const verification = await verifyRecipe(loaded.path);
   if (!verification.ok) {
     throw new Error(`Recipe ${loaded.recipe.id}@${loaded.recipe.version} failed integrity verification.`);
   }
-  const destination = options.out ? import_node_path14.default.resolve(cwd, options.out) : import_node_path14.default.join(cwd, "pixelkiln-recipes", ...loaded.recipe.id.split("/"), loaded.recipe.version);
+  const destination = options.out ? import_node_path15.default.resolve(cwd, options.out) : import_node_path15.default.join(cwd, "pixelkiln-recipes", ...loaded.recipe.id.split("/"), loaded.recipe.version);
   const sources = [
     { path: RECIPE_FILE, source: loaded.path },
-    ...loaded.recipe.files.map((file) => ({ path: file.path, source: import_node_path14.default.join(loaded.dir, ...file.path.split("/")) }))
+    ...loaded.recipe.files.map((file) => ({ path: file.path, source: import_node_path15.default.join(loaded.dir, ...file.path.split("/")) }))
   ];
   const files = await Promise.all(sources.map(async (file) => ({
-    path: import_node_path14.default.join(destination, ...file.path.split("/")),
+    path: import_node_path15.default.join(destination, ...file.path.split("/")),
     data: await (0, import_promises7.readFile)(file.source)
   })));
   if (!options.force) {
     for (const file of files) {
-      if (!(0, import_node_fs10.existsSync)(file.path)) continue;
+      if (!(0, import_node_fs11.existsSync)(file.path)) continue;
       const current = await (0, import_promises7.readFile)(file.path);
       if (!current.equals(file.data)) {
         throw new OverwriteRefusedError(
@@ -11791,8 +12035,8 @@ async function installRecipe(target, options = {}) {
 
 // src/pipeline/audit.ts
 var import_promises8 = require("fs/promises");
-var import_node_fs11 = require("fs");
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_fs12 = require("fs");
+var import_node_path16 = __toESM(require("path"), 1);
 function paletteDistance(asset, reference) {
   if (!asset.length || !reference.length) return 0;
   let total = 0;
@@ -11828,7 +12072,7 @@ async function auditStyle(loaded, specs, styleId, lock) {
   const unreadable = [];
   for (const spec of mine) {
     for (const output of resolveSpecOutputs(spec, lock, loaded.root)) {
-      if (!(0, import_node_fs11.existsSync)(output.absolutePath)) {
+      if (!(0, import_node_fs12.existsSync)(output.absolutePath)) {
         missing.push(output.id);
         continue;
       }
@@ -11857,8 +12101,8 @@ async function auditStyle(loaded, specs, styleId, lock) {
   let referenceFromStyleImages = false;
   const refPalettes = [];
   for (const img of style.styleImages) {
-    const abs = import_node_path15.default.resolve(loaded.root, img.path);
-    if (!(0, import_node_fs11.existsSync)(abs)) continue;
+    const abs = import_node_path16.default.resolve(loaded.root, img.path);
+    if (!(0, import_node_fs12.existsSync)(abs)) continue;
     try {
       refPalettes.push(extractPalette(decodePng(await (0, import_promises8.readFile)(abs)), 12));
     } catch {
@@ -11936,19 +12180,19 @@ function hex(c) {
 }
 
 // src/pixellab-utils.ts
-var import_node_fs12 = require("fs");
+var import_node_fs13 = require("fs");
 var import_promises9 = require("fs/promises");
-var import_node_path16 = __toESM(require("path"), 1);
+var import_node_path17 = __toESM(require("path"), 1);
 var UNZOOM_MIN_SIDE = 256;
 var UNZOOM_MAX_AREA = 2048 * 2048;
 function defaultUnzoomOut(input) {
-  const ext = import_node_path16.default.extname(input);
+  const ext = import_node_path17.default.extname(input);
   return `${ext ? input.slice(0, -ext.length) : input}.unzoomed.png`;
 }
 async function unzoomFile(client2, input, opts = {}) {
-  const out = import_node_path16.default.resolve(opts.out ?? defaultUnzoomOut(input));
-  if (import_node_path16.default.resolve(input) === out) throw new Error("unzoom will not overwrite its own input; pass a different --out");
-  if ((0, import_node_fs12.existsSync)(out) && !opts.force) throw new Error(`${out} already exists; pass --force to replace it`);
+  const out = import_node_path17.default.resolve(opts.out ?? defaultUnzoomOut(input));
+  if (import_node_path17.default.resolve(input) === out) throw new Error("unzoom will not overwrite its own input; pass a different --out");
+  if ((0, import_node_fs13.existsSync)(out) && !opts.force) throw new Error(`${out} already exists; pass --force to replace it`);
   const bytes = await (0, import_promises9.readFile)(input);
   const metadata = imageMetadata(bytes);
   if (!metadata) throw new Error(`${input} is not a readable PNG or JPEG`);
@@ -11962,7 +12206,7 @@ async function unzoomFile(client2, input, opts = {}) {
     throw new Error(`${input} is ${width}x${height}; PixelLab's unzoom takes at most 2048x2048 worth of pixels`);
   }
   const res = await client2.unzoom({ image: { base64: bytes.toString("base64"), format }, quantize: opts.quantize });
-  await (0, import_promises9.mkdir)(import_node_path16.default.dirname(out), { recursive: true });
+  await (0, import_promises9.mkdir)(import_node_path17.default.dirname(out), { recursive: true });
   await (0, import_promises9.writeFile)(out, res.png);
   return { out, original: res.originalSize, unzoomed: res.unzoomedSize, zoomFactor: res.zoomFactor, usage: res.usage };
 }
@@ -11970,14 +12214,14 @@ var FONT_WEIGHTS = ["Bold", "Regular"];
 var FONT_GLYPH_SIZES = [8, 16, 32, 64];
 var FONT_COST_GENERATIONS = 25;
 function fontOutputPaths(out) {
-  const base = import_node_path16.default.resolve(out.replace(/\.(ttf|png)$/i, ""));
+  const base = import_node_path17.default.resolve(out.replace(/\.(ttf|png)$/i, ""));
   return { ttf: `${base}.ttf`, atlas: `${base}.png` };
 }
 async function generateFont(client2, opts) {
   const { ttf, atlas } = fontOutputPaths(opts.out);
   if (!opts.force) {
     for (const file of [ttf, atlas]) {
-      if ((0, import_node_fs12.existsSync)(file)) throw new Error(`${file} already exists; pass --force to replace it`);
+      if ((0, import_node_fs13.existsSync)(file)) throw new Error(`${file} already exists; pass --force to replace it`);
     }
   }
   const sleep3 = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
@@ -12004,7 +12248,7 @@ async function generateFont(client2, opts) {
         client2.download(job.download_ttf_url),
         client2.download(job.download_atlas_url)
       ]);
-      await (0, import_promises9.mkdir)(import_node_path16.default.dirname(ttf), { recursive: true });
+      await (0, import_promises9.mkdir)(import_node_path17.default.dirname(ttf), { recursive: true });
       await (0, import_promises9.writeFile)(ttf, ttfBytes);
       await (0, import_promises9.writeFile)(atlas, atlasBytes);
       return { jobId, ttf, atlas, glyphPx: job.glyph_px ?? null, usage: job.usage };
@@ -12019,15 +12263,15 @@ async function generateFont(client2, opts) {
 }
 
 // src/pipeline/quality-regression.ts
-var import_node_path17 = __toESM(require("path"), 1);
-var import_node_fs13 = require("fs");
+var import_node_path18 = __toESM(require("path"), 1);
+var import_node_fs14 = require("fs");
 var import_promises10 = require("fs/promises");
 var import_zod5 = require("zod");
 var SHA256_RE2 = /^[0-9a-f]{64}$/;
 var HEX_RE = /^#[0-9a-f]{6}$/;
 var MAX_REDMEAN_DISTANCE = 765;
 var QualityPathSchema = import_zod5.z.string().min(1).refine(
-  (value) => !import_node_path17.default.posix.isAbsolute(value) && !value.includes("\\"),
+  (value) => !import_node_path18.default.posix.isAbsolute(value) && !value.includes("\\"),
   "expected a portable relative path"
 );
 var DEFAULT_QUALITY_TOLERANCES = {
@@ -12174,7 +12418,7 @@ function measureDecodedImageQuality(png, digest2) {
   };
 }
 async function measureImageQuality(file) {
-  const absolute = import_node_path17.default.resolve(file);
+  const absolute = import_node_path18.default.resolve(file);
   let bytes;
   try {
     bytes = await (0, import_promises10.readFile)(absolute);
@@ -12196,11 +12440,11 @@ function resolveQualityInputs(raw, inputsFilePath) {
   }
   const ids = parsed.data.map((entry) => entry.id);
   if (new Set(ids).size !== ids.length) throw new Error("--inputs contains a duplicate quality case id.");
-  const root = import_node_path17.default.dirname(import_node_path17.default.resolve(inputsFilePath));
+  const root = import_node_path18.default.dirname(import_node_path18.default.resolve(inputsFilePath));
   return parsed.data.map((entry) => ({
     id: entry.id,
-    file: import_node_path17.default.resolve(root, entry.path),
-    ...entry.record ? { record: import_node_path17.default.resolve(root, entry.record) } : {},
+    file: import_node_path18.default.resolve(root, entry.path),
+    ...entry.record ? { record: import_node_path18.default.resolve(root, entry.record) } : {},
     tolerances: QualityToleranceSchema.parse({
       ...DEFAULT_QUALITY_TOLERANCES,
       ...entry.tolerances
@@ -12208,7 +12452,7 @@ function resolveQualityInputs(raw, inputsFilePath) {
   }));
 }
 function portableRelative2(from, to) {
-  return import_node_path17.default.relative(from, import_node_path17.default.resolve(to)).split(import_node_path17.default.sep).join("/") || ".";
+  return import_node_path18.default.relative(from, import_node_path18.default.resolve(to)).split(import_node_path18.default.sep).join("/") || ".";
 }
 async function verifyRecordForImage(recordPath, imagePath) {
   const verification = await verifyArtifactBundle(recordPath);
@@ -12223,20 +12467,20 @@ async function verifyRecordForImage(recordPath, imagePath) {
   if (record.kind !== "refine" || options === null || typeof options !== "object" || options.schema !== "pixelkiln-quality") {
     throw new Error(`Quality record ${recordPath} is not a PixelKiln refinement record.`);
   }
-  const outputs = record.outputs.map((output) => import_node_path17.default.resolve(import_node_path17.default.dirname(recordPath), output.path));
-  if (!outputs.includes(import_node_path17.default.resolve(imagePath))) {
+  const outputs = record.outputs.map((output) => import_node_path18.default.resolve(import_node_path18.default.dirname(recordPath), output.path));
+  if (!outputs.includes(import_node_path18.default.resolve(imagePath))) {
     throw new Error(`Quality record ${recordPath} does not own ${imagePath}.`);
   }
 }
 async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   if (!inputs.length) throw new Error("Cannot snapshot an empty quality baseline.");
-  const absolute = import_node_path17.default.resolve(baselinePath);
+  const absolute = import_node_path18.default.resolve(baselinePath);
   for (const input of inputs) {
-    if (import_node_path17.default.resolve(input.file) === absolute || input.record && import_node_path17.default.resolve(input.record) === absolute) {
+    if (import_node_path18.default.resolve(input.file) === absolute || input.record && import_node_path18.default.resolve(input.record) === absolute) {
       throw new Error(`Quality baseline output would overwrite an input: ${absolute}.`);
     }
   }
-  const root = import_node_path17.default.dirname(absolute);
+  const root = import_node_path18.default.dirname(absolute);
   const cases = [];
   for (const input of [...inputs].sort((a, b) => a.id.localeCompare(b.id))) {
     const expected = await measureImageQuality(input.file);
@@ -12263,7 +12507,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
     cases
   });
   const data = Buffer.from(JSON.stringify(baseline, null, 2) + "\n");
-  if ((0, import_node_fs13.existsSync)(absolute) && !options.force) {
+  if ((0, import_node_fs14.existsSync)(absolute) && !options.force) {
     const current = await (0, import_promises10.readFile)(absolute);
     if (!current.equals(data)) {
       throw new OverwriteRefusedError(
@@ -12276,7 +12520,7 @@ async function snapshotQualityBaseline(inputs, baselinePath, options = {}) {
   return { baseline, path: absolute, changed: result.changed.length > 0 };
 }
 async function readQualityBaseline(baselinePath) {
-  const absolute = import_node_path17.default.resolve(baselinePath);
+  const absolute = import_node_path18.default.resolve(baselinePath);
   let raw;
   try {
     raw = JSON.parse(await (0, import_promises10.readFile)(absolute, "utf8"));
@@ -12349,12 +12593,12 @@ function regressionViolations(expected, actual, tolerances) {
   return { violations, warnings };
 }
 async function checkQualityBaseline(baselinePath) {
-  const absolute = import_node_path17.default.resolve(baselinePath);
+  const absolute = import_node_path18.default.resolve(baselinePath);
   const baseline = await readQualityBaseline(absolute);
-  const root = import_node_path17.default.dirname(absolute);
+  const root = import_node_path18.default.dirname(absolute);
   const cases = [];
   for (const entry of baseline.cases) {
-    const file = import_node_path17.default.resolve(root, entry.file);
+    const file = import_node_path18.default.resolve(root, entry.file);
     let actual = null;
     const violations = [];
     const warnings = [];
@@ -12367,7 +12611,7 @@ async function checkQualityBaseline(baselinePath) {
       violations.push(message4(error));
     }
     if (entry.record) {
-      const recordPath = import_node_path17.default.resolve(root, entry.record.path);
+      const recordPath = import_node_path18.default.resolve(root, entry.record.path);
       try {
         const recordHash = await sha256File(recordPath);
         if (recordHash !== entry.record.sha256) violations.push("quality record hash changed");
@@ -12403,14 +12647,14 @@ async function checkQualityBaseline(baselinePath) {
 }
 
 // src/pipeline/cache-health.ts
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var import_promises13 = require("fs/promises");
-var import_node_path21 = __toESM(require("path"), 1);
+var import_node_path22 = __toESM(require("path"), 1);
 
 // src/cache.ts
 var import_promises11 = require("fs/promises");
-var import_node_fs14 = require("fs");
-var import_node_path18 = __toESM(require("path"), 1);
+var import_node_fs15 = require("fs");
+var import_node_path19 = __toESM(require("path"), 1);
 var import_zod6 = require("zod");
 var HashCacheSchema = import_zod6.z.object({
   version: import_zod6.z.literal(1),
@@ -12424,10 +12668,10 @@ function isSha256Hash(value) {
 function parseCache(value) {
   return HashCacheSchema.parse(value);
 }
-async function loadCache(path36) {
-  if (!(0, import_node_fs14.existsSync)(path36)) return { version: 1, hashes: {} };
+async function loadCache(path38) {
+  if (!(0, import_node_fs15.existsSync)(path38)) return { version: 1, hashes: {} };
   try {
-    const parsed = HashCacheSchema.safeParse(JSON.parse(await (0, import_promises11.readFile)(path36, "utf8")));
+    const parsed = HashCacheSchema.safeParse(JSON.parse(await (0, import_promises11.readFile)(path38, "utf8")));
     if (!parsed.success) return { version: 1, hashes: {} };
     return {
       version: 1,
@@ -12439,18 +12683,18 @@ async function loadCache(path36) {
     return { version: 1, hashes: {} };
   }
 }
-async function saveCache(path36, cache) {
+async function saveCache(path38, cache) {
   const sorted = {};
   for (const key of Object.keys(cache.hashes).sort()) {
     const hash = cache.hashes[key];
     if (!isSha256Hash(hash)) throw new Error(`Refusing to cache invalid SHA-256 for ${key}`);
     sorted[key] = hash;
   }
-  await (0, import_promises11.mkdir)(import_node_path18.default.dirname(import_node_path18.default.resolve(path36)), { recursive: true });
-  const tmp = `${path36}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+  await (0, import_promises11.mkdir)(import_node_path19.default.dirname(import_node_path19.default.resolve(path38)), { recursive: true });
+  const tmp = `${path38}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
   try {
     await (0, import_promises11.writeFile)(tmp, JSON.stringify({ version: 1, hashes: sorted }, null, 2) + "\n");
-    await (0, import_promises11.rename)(tmp, path36);
+    await (0, import_promises11.rename)(tmp, path38);
   } finally {
     await (0, import_promises11.rm)(tmp, { force: true });
   }
@@ -12474,20 +12718,20 @@ function cachePathFor(lockPath) {
 }
 
 // src/pipeline/history.ts
-var import_node_fs16 = require("fs");
-var import_node_path20 = __toESM(require("path"), 1);
+var import_node_fs17 = require("fs");
+var import_node_path21 = __toESM(require("path"), 1);
 
 // src/pipeline/fetch.ts
-var import_node_fs15 = require("fs");
+var import_node_fs16 = require("fs");
 var import_promises12 = require("fs/promises");
-var import_node_path19 = __toESM(require("path"), 1);
+var import_node_path20 = __toESM(require("path"), 1);
 async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
   const log = opts.onProgress ?? (() => {
   });
   const result = { downloaded: 0, skipped: 0, failed: 0, ...opts.refresh ? { unchanged: 0 } : {} };
   const specByKey = new Map(specs.map((s) => [lockKey(s.styleId, s.assetId), s]));
   normalizeLockOutputPaths(lock, specs);
-  const cacheDir = opts.cacheDir === false ? null : import_node_path19.default.resolve(opts.cacheDir ?? import_node_path19.default.join(import_node_path19.default.dirname(lockPath), ".pixelkiln", "cache"));
+  const cacheDir = opts.cacheDir === false ? null : import_node_path20.default.resolve(opts.cacheDir ?? import_node_path20.default.join(import_node_path20.default.dirname(lockPath), ".pixelkiln", "cache"));
   const pending = Object.entries(lock.entries).filter(([key, e]) => {
     if (e.provider !== provider.id || !specByKey.has(key)) return false;
     if (specByKey.get(key)?.mirror) return false;
@@ -12498,15 +12742,15 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
     if (spec && e.specHash === spec.specHash && e.outputs.length && !postprocessCurrent(e, spec)) {
       return Boolean(opts.force) || e.outputs.every((output) => {
         const file = resolveOutputPath(output.path, spec.root);
-        return (0, import_node_fs15.existsSync)(file) && sha256((0, import_node_fs15.readFileSync)(file)) === output.sha256;
+        return (0, import_node_fs16.existsSync)(file) && sha256((0, import_node_fs16.readFileSync)(file)) === output.sha256;
       });
     }
     if (!opts.repair) return false;
     if (e.outputs.length === 0 || !spec) return true;
     return e.outputs.some((output) => {
       const file = resolveOutputPath(output.path, spec.root);
-      if (!(0, import_node_fs15.existsSync)(file)) return true;
-      const current = sha256((0, import_node_fs15.readFileSync)(file));
+      if (!(0, import_node_fs16.existsSync)(file)) return true;
+      const current = sha256((0, import_node_fs16.readFileSync)(file));
       if (current === output.sha256) return false;
       return Boolean(opts.force) || (e.supersededOutputs ?? []).some((old) => old.sha256 === current);
     });
@@ -12589,14 +12833,14 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
             if (!source.url) throw new Error(`no durable source URL to refresh ${source.role ?? "asset"} from`);
             fresh = await provider.download(source.url);
             if (recorded && sha256(fresh) === recordedRaw && !reapply) {
-              log(`  current ${import_node_path19.default.relative(process.cwd(), target)}`);
+              log(`  current ${import_node_path20.default.relative(process.cwd(), target)}`);
               outputs.push({ ...recorded, path: portableOutputPath(target, spec.root) });
               continue;
             }
           }
           let raw = null;
           let final = null;
-          if ((0, import_node_fs15.existsSync)(target)) {
+          if ((0, import_node_fs16.existsSync)(target)) {
             const currentHash = await sha256File(target);
             if (recorded && currentHash === recorded.sha256) {
               if (!fresh && !reapply) {
@@ -12613,9 +12857,9 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
               }
               if (reapply && !fresh) {
                 if (!recorded.raw) raw = await (0, import_promises12.readFile)(target);
-                log(`  reapply ${import_node_path19.default.relative(process.cwd(), target)}`);
+                log(`  reapply ${import_node_path20.default.relative(process.cwd(), target)}`);
               } else {
-                log(`  changed ${import_node_path19.default.relative(process.cwd(), target)} (upstream)`);
+                log(`  changed ${import_node_path20.default.relative(process.cwd(), target)} (upstream)`);
               }
             } else {
               const superseded = (entry.supersededOutputs ?? []).find(
@@ -12643,7 +12887,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
                 }
               }
               log(
-                `  replace ${import_node_path19.default.relative(process.cwd(), target)}` + (opts.force ? " (--force)" : " (previous tracked generation)")
+                `  replace ${import_node_path20.default.relative(process.cwd(), target)}` + (opts.force ? " (--force)" : " (previous tracked generation)")
               );
             }
           }
@@ -12652,7 +12896,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
           } else if (!raw && recorded && cacheDir) {
             if (!reapply) final = await readCachedMedia(cacheDir, recorded.sha256, expectedMediaType);
             if (!final && recordedRaw) raw = await readCachedMedia(cacheDir, recordedRaw, expectedMediaType);
-            if (final || raw) log(`  cached  ${import_node_path19.default.relative(process.cwd(), target)}`);
+            if (final || raw) log(`  cached  ${import_node_path20.default.relative(process.cwd(), target)}`);
           }
           if (!final && !raw) {
             if (!source.url) {
@@ -12679,11 +12923,11 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
             buf = processed.bytes;
             if (processed.changed) {
               rawHash = sha256(raw);
-              log(`  snapped ${import_node_path19.default.relative(process.cwd(), target)} to ${wanted.palette.colors.length} colours`);
+              log(`  snapped ${import_node_path20.default.relative(process.cwd(), target)} to ${wanted.palette.colors.length} colours`);
             }
           }
           if (cacheDir) await cacheMedia(cacheDir, buf, mediaType);
-          await (0, import_promises12.mkdir)(import_node_path19.default.dirname(target), { recursive: true });
+          await (0, import_promises12.mkdir)(import_node_path20.default.dirname(target), { recursive: true });
           const tmp = `${target}.pixelkiln.tmp`;
           await (0, import_promises12.writeFile)(tmp, buf);
           outputs.push({
@@ -12697,7 +12941,7 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
           await saveLock(lockPath, lock);
           await (0, import_promises12.rename)(tmp, target);
           wrote = true;
-          log(`  wrote   ${import_node_path19.default.relative(process.cwd(), target)}`);
+          log(`  wrote   ${import_node_path20.default.relative(process.cwd(), target)}`);
         }
         if (opts.refresh && !wrote) {
           if (rotated) {
@@ -12741,8 +12985,8 @@ async function fetchAssets(provider, specs, lock, lockPath, opts = {}) {
   return result;
 }
 async function readCachedMedia(cacheDir, hash, mediaType) {
-  const file = import_node_path19.default.join(cacheDir, cacheFileName(hash, mediaType));
-  if (!(0, import_node_fs15.existsSync)(file)) return null;
+  const file = import_node_path20.default.join(cacheDir, cacheFileName(hash, mediaType));
+  if (!(0, import_node_fs16.existsSync)(file)) return null;
   try {
     const buf = await (0, import_promises12.readFile)(file);
     if (sha256(buf) !== hash) return null;
@@ -12755,7 +12999,7 @@ async function readCachedMedia(cacheDir, hash, mediaType) {
 async function cacheMedia(cacheDir, buf, mediaType, knownHash) {
   const hash = knownHash ?? sha256(buf);
   validateMedia(buf, mediaType);
-  const file = import_node_path19.default.join(cacheDir, cacheFileName(hash, mediaType));
+  const file = import_node_path20.default.join(cacheDir, cacheFileName(hash, mediaType));
   if (await readCachedMedia(cacheDir, hash, mediaType)) return;
   await (0, import_promises12.mkdir)(cacheDir, { recursive: true });
   const tmp = `${file}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
@@ -12763,7 +13007,7 @@ async function cacheMedia(cacheDir, buf, mediaType, knownHash) {
   try {
     await (0, import_promises12.rename)(tmp, file);
   } catch (err) {
-    if (!(0, import_node_fs15.existsSync)(file)) throw err;
+    if (!(0, import_node_fs16.existsSync)(file)) throw err;
   } finally {
     await (0, import_promises12.rm)(tmp, { force: true });
   }
@@ -12882,10 +13126,10 @@ async function revertGeneration(provider, spec, lock, lockPath, opts) {
   }
   for (let i = 0; i < entry.outputs.length; i++) {
     const file = currentEntryOutputPath(entry, spec, i);
-    if (!(0, import_node_fs16.existsSync)(file)) continue;
+    if (!(0, import_node_fs17.existsSync)(file)) continue;
     if (await sha256File(file) !== entry.outputs[i].sha256 && !opts.force) {
       throw new OverwriteRefusedError(
-        `${import_node_path20.default.relative(process.cwd(), file)} was changed after download; keep it with pixelkiln edit, or pass --force to replace it`,
+        `${import_node_path21.default.relative(process.cwd(), file)} was changed after download; keep it with pixelkiln edit, or pass --force to replace it`,
         [file]
       );
     }
@@ -12937,11 +13181,11 @@ async function revertGeneration(provider, spec, lock, lockPath, opts) {
 
 // src/pipeline/cache-health.ts
 async function inspectCaches(lock, lockPath, options = {}) {
-  if (options.prune && !(0, import_node_fs17.existsSync)(lockPath)) {
-    throw new Error(`Refusing to prune without an existing lockfile at ${import_node_path21.default.resolve(lockPath)}`);
+  if (options.prune && !(0, import_node_fs18.existsSync)(lockPath)) {
+    throw new Error(`Refusing to prune without an existing lockfile at ${import_node_path22.default.resolve(lockPath)}`);
   }
-  const contentDir = import_node_path21.default.resolve(import_node_path21.default.dirname(lockPath), ".pixelkiln", "cache");
-  const remotePath = import_node_path21.default.resolve(cachePathFor(lockPath));
+  const contentDir = import_node_path22.default.resolve(import_node_path22.default.dirname(lockPath), ".pixelkiln", "cache");
+  const remotePath = import_node_path22.default.resolve(cachePathFor(lockPath));
   const referenced = referencedHashes(lock);
   let content = await inspectContentCache(contentDir, referenced);
   let remoteHashes = await inspectRemoteHashCache(remotePath);
@@ -12953,7 +13197,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
     ]);
     for (const name of names) {
       try {
-        await (0, import_promises13.rm)(import_node_path21.default.join(contentDir, name), { force: true });
+        await (0, import_promises13.rm)(import_node_path22.default.join(contentDir, name), { force: true });
         removed.contentFiles++;
       } catch {
       }
@@ -12980,7 +13224,7 @@ async function inspectCaches(lock, lockPath, options = {}) {
 async function inspectContentCache(contentDir, referenced) {
   const report = {
     path: contentDir,
-    exists: (0, import_node_fs17.existsSync)(contentDir),
+    exists: (0, import_node_fs18.existsSync)(contentDir),
     files: 0,
     bytes: 0,
     valid: 0,
@@ -13001,7 +13245,7 @@ async function inspectContentCache(contentDir, referenced) {
       continue;
     }
     report.files++;
-    const file = import_node_path21.default.join(contentDir, entry.name);
+    const file = import_node_path22.default.join(contentDir, entry.name);
     const mediaType = mediaTypeFromExtension(entry.name);
     const expected = mediaType ? entry.name.slice(0, -4) : "";
     let bytes;
@@ -13044,7 +13288,7 @@ async function inspectContentCache(contentDir, referenced) {
 async function inspectRemoteHashCache(remotePath) {
   const report = {
     path: remotePath,
-    exists: (0, import_node_fs17.existsSync)(remotePath),
+    exists: (0, import_node_fs18.existsSync)(remotePath),
     entries: 0,
     valid: 0,
     invalidIds: [],
@@ -13068,20 +13312,20 @@ async function inspectRemoteHashCache(remotePath) {
 }
 
 // src/pipeline/pack.ts
-var import_node_fs18 = require("fs");
-var import_node_path22 = __toESM(require("path"), 1);
+var import_node_fs19 = require("fs");
+var import_node_path23 = __toESM(require("path"), 1);
 var DEFAULT_FRAME_SET_FPS = 12;
 function resolvePackInputs(raw, inputsFilePath) {
   if (!Array.isArray(raw) || !raw.length) {
     throw new Error("--inputs must be a non-empty JSON array of { id, path }");
   }
-  const baseDir = import_node_path22.default.dirname(import_node_path22.default.resolve(inputsFilePath));
+  const baseDir = import_node_path23.default.dirname(import_node_path23.default.resolve(inputsFilePath));
   return raw.map((entry, i) => {
     const e = entry;
     if (typeof e.id !== "string" || typeof e.path !== "string") {
       throw new Error(`--inputs[${i}] needs string "id" and "path"`);
     }
-    return { id: e.id, path: import_node_path22.default.resolve(baseDir, e.path) };
+    return { id: e.id, path: import_node_path23.default.resolve(baseDir, e.path) };
   });
 }
 function packSprites(inputs, options = {}) {
@@ -13102,7 +13346,7 @@ function packSprites(inputs, options = {}) {
   for (const input of ordered) {
     let sourceHash = null;
     try {
-      const bytes = (0, import_node_fs18.readFileSync)(input.path);
+      const bytes = (0, import_node_fs19.readFileSync)(input.path);
       sourceHash = sha256(bytes);
       const png = decodePng(bytes);
       sprites.push({ id: input.id, width: png.width, height: png.height, pixels: png.pixels });
@@ -13165,7 +13409,7 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
     }
     const inputs2 = Object.entries(options.sourceOverrides).map(([id, source]) => ({
       id,
-      path: import_node_path22.default.resolve(source)
+      path: import_node_path23.default.resolve(source)
     }));
     if (!inputs2.length) throw new Error(`No approved quality outputs for style "${styleId}".`);
     const packed2 = packSprites(inputs2, options);
@@ -13189,7 +13433,7 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
     let outputs = resolveEntryOutputs(entry, id, manifestDir);
     const source = sources[id];
     if (source && outputs.length <= 1) {
-      inputs.push({ id, path: import_node_path22.default.resolve(manifestDir, source) });
+      inputs.push({ id, path: import_node_path23.default.resolve(manifestDir, source) });
       continue;
     }
     if (source && sourceIsStem(source, entry, manifestDir)) {
@@ -13223,7 +13467,7 @@ function packStyle(lock, styleId, manifestDir, options = {}) {
     }
   }
   for (const [id, source] of Object.entries(sources)) {
-    if (!locked.has(id)) inputs.push({ id, path: import_node_path22.default.resolve(manifestDir, source) });
+    if (!locked.has(id)) inputs.push({ id, path: import_node_path23.default.resolve(manifestDir, source) });
   }
   if (!inputs.length) {
     throw new Error(`No readable sprites for style "${styleId}"; ${noOutput.length} skipped.`);
@@ -13260,7 +13504,7 @@ function mountSprites(placements, options) {
   for (const p of placements) {
     let sourceHash = null;
     try {
-      const bytes = (0, import_node_fs18.readFileSync)(p.path);
+      const bytes = (0, import_node_fs19.readFileSync)(p.path);
       sourceHash = sha256(bytes);
       const png = decodePng(bytes);
       if (png.width > cellWidth || png.height > cellHeight) {
@@ -13331,7 +13575,7 @@ function mountStyle(lock, styleId, manifestDir, mount, cells, sources = {}, outp
     const source = sources[id];
     const entry = lock.entries[`${styleId}/${id}`];
     if (source && !(entry && sourceIsStem(source, entry, manifestDir))) {
-      placements.push({ id, path: import_node_path22.default.resolve(manifestDir, source), cell });
+      placements.push({ id, path: import_node_path23.default.resolve(manifestDir, source), cell });
       continue;
     }
     if (source && entry) {
@@ -13364,7 +13608,7 @@ function mountStyle(lock, styleId, manifestDir, mount, cells, sources = {}, outp
       `Nothing to mount for style "${styleId}": ${ids.length} asset(s) declare a cell, but none has generated output or a \`source\`. Run \`pixelkiln gen --style ${styleId}\`, or point each at a file.${detail}`
     );
   }
-  const basePng = mount.base ? (0, import_node_fs18.readFileSync)(import_node_path22.default.resolve(manifestDir, mount.base)) : void 0;
+  const basePng = mount.base ? (0, import_node_fs19.readFileSync)(import_node_path23.default.resolve(manifestDir, mount.base)) : void 0;
   const mounted = mountSprites(placements, {
     cellWidth: mount.cellWidth,
     cellHeight: mount.cellHeight,
@@ -13374,7 +13618,7 @@ function mountStyle(lock, styleId, manifestDir, mount, cells, sources = {}, outp
     ...mounted,
     sources: mount.base ? [{
       id: "$base",
-      path: import_node_path22.default.resolve(manifestDir, mount.base),
+      path: import_node_path23.default.resolve(manifestDir, mount.base),
       sha256: sha256(basePng),
       included: true
     }, ...mounted.sources] : mounted.sources,
@@ -13966,6 +14210,10 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
         ...spec.revision.keypointsSha256 ? { keypointsSha256: spec.revision.keypointsSha256 } : {},
         ...spec.revision.skeletonTemplate ? { skeletonTemplate: spec.revision.skeletonTemplate } : {},
         ...spec.revision.description ? { description: spec.revision.description } : {},
+        ...spec.revision.removalTask ? { removalTask: spec.revision.removalTask } : {},
+        ...spec.revision.driftThreshold == null ? {} : { driftThreshold: spec.revision.driftThreshold },
+        ...spec.revision.subjectDescription ? { subjectDescription: spec.revision.subjectDescription } : {},
+        ...spec.revision.initialPose ? { initialPose: spec.revision.initialPose } : {},
         ...spec.revision.engine ? { engine: spec.revision.engine } : {}
       } : null,
       outfit: spec.character?.kind === "outfit" && outfitParentEntry ? {
@@ -14180,9 +14428,9 @@ async function poll(provider, lock, lockPath, opts = {}) {
 }
 
 // src/pipeline/doctor.ts
-var import_node_fs19 = require("fs");
+var import_node_fs20 = require("fs");
 var import_promises14 = require("fs/promises");
-var import_node_path23 = __toESM(require("path"), 1);
+var import_node_path24 = __toESM(require("path"), 1);
 async function doctor(loaded, specs, lock, lockPath, opts = {}) {
   const checks = [];
   const add = (id, level, message6) => checks.push({ id, level, message: message6 });
@@ -14193,14 +14441,14 @@ async function doctor(loaded, specs, lock, lockPath, opts = {}) {
   );
   add("lock", "ok", `${Object.keys(lock.entries).length} valid v2 lock entr(ies)`);
   const dirs = [...new Set(specs.flatMap((spec) => [
-    import_node_path23.default.dirname(spec.outFile),
-    ...spec.quality ? [import_node_path23.default.dirname(spec.quality.outFile)] : []
+    import_node_path24.default.dirname(spec.outFile),
+    ...spec.quality ? [import_node_path24.default.dirname(spec.quality.outFile)] : []
   ]))];
   const unwritable = [];
   for (const dir of dirs) {
     const ancestor = await nearestExistingDirectory(dir);
     try {
-      await (0, import_promises14.access)(ancestor, import_node_fs19.constants.W_OK);
+      await (0, import_promises14.access)(ancestor, import_node_fs20.constants.W_OK);
     } catch {
       unwritable.push(dir);
     }
@@ -14217,7 +14465,7 @@ async function doctor(loaded, specs, lock, lockPath, opts = {}) {
     for (let index = 0; index < entry.outputs.length; index++) {
       const output = entry.outputs[index];
       const spec = specByKey.get(key);
-      const absolute = spec ? currentEntryOutputPath(entry, spec, index) : resolveOutputPath(output.path, import_node_path23.default.dirname(lockPath));
+      const absolute = spec ? currentEntryOutputPath(entry, spec, index) : resolveOutputPath(output.path, import_node_path24.default.dirname(lockPath));
       const owner = outputOwners.get(absolute);
       if (owner && owner !== key) duplicateOutputs.push(`${output.path} (${owner}, ${key})`);
       outputOwners.set(absolute, key);
@@ -14232,7 +14480,7 @@ async function doctor(loaded, specs, lock, lockPath, opts = {}) {
   } else {
     add("lock-outputs", "ok", `${outputOwners.size} recorded output path(s) are uniquely owned`);
   }
-  const cacheDir = import_node_path23.default.join(import_node_path23.default.dirname(lockPath), ".pixelkiln", "cache");
+  const cacheDir = import_node_path24.default.join(import_node_path24.default.dirname(lockPath), ".pixelkiln", "cache");
   const stranded = [];
   const invalidState = [];
   const staleMapUrls = [];
@@ -14248,11 +14496,11 @@ async function doctor(loaded, specs, lock, lockPath, opts = {}) {
     const hasSource = Boolean(entry.sourceUrl || entry.sourceUrls?.length);
     let hasCache = false;
     for (const output of entry.outputs) {
-      const cached = import_node_path23.default.join(
+      const cached = import_node_path24.default.join(
         cacheDir,
         cacheFileName(output.sha256, output.mediaType ?? MediaType.PNG)
       );
-      if ((0, import_node_fs19.existsSync)(cached) && await sha256File(cached) === output.sha256) {
+      if ((0, import_node_fs20.existsSync)(cached) && await sha256File(cached) === output.sha256) {
         hasCache = true;
         break;
       }
@@ -14348,16 +14596,16 @@ async function nearestExistingDirectory(start) {
       if ((await (0, import_promises14.stat)(current)).isDirectory()) return current;
     } catch {
     }
-    const parent = import_node_path23.default.dirname(current);
+    const parent = import_node_path24.default.dirname(current);
     if (parent === current) return current;
     current = parent;
   }
 }
 
 // src/pipeline/adopt.ts
-var import_node_fs20 = require("fs");
+var import_node_fs21 = require("fs");
 var import_promises15 = require("fs/promises");
-var import_node_path24 = __toESM(require("path"), 1);
+var import_node_path25 = __toESM(require("path"), 1);
 async function adopt(provider, specs, lock, lockPath, opts = {}) {
   const log = opts.onProgress ?? (() => {
   });
@@ -14368,7 +14616,7 @@ async function adopt(provider, specs, lock, lockPath, opts = {}) {
   const localByHash = /* @__PURE__ */ new Map();
   const unmatchedLocal = [];
   for (const spec of specs) {
-    if (!(0, import_node_fs20.existsSync)(spec.outFile)) {
+    if (!(0, import_node_fs21.existsSync)(spec.outFile)) {
       unmatchedLocal.push(`${spec.styleId}/${spec.assetId} (no file at ${spec.outFile})`);
       continue;
     }
@@ -14490,13 +14738,13 @@ async function tagAdopted(provider, specs, lock, opts = {}) {
 }
 
 // src/pick/server.ts
-var import_node_fs22 = require("fs");
+var import_node_fs23 = require("fs");
 var import_promises18 = require("fs/promises");
 
 // src/pipeline/init.ts
 var import_promises16 = require("fs/promises");
-var import_node_fs21 = require("fs");
-var import_node_path25 = __toESM(require("path"), 1);
+var import_node_fs22 = require("fs");
+var import_node_path26 = __toESM(require("path"), 1);
 function pngSize(buf) {
   if (buf.length < 24) return null;
   const isPng = buf.readUInt32BE(0) === 2303741511 && buf.readUInt32BE(4) === 218765834;
@@ -14510,7 +14758,7 @@ function slugify(value) {
 async function walk(dir, exclude) {
   const out = [];
   for (const entry of await (0, import_promises16.readdir)(dir, { withFileTypes: true })) {
-    const full = import_node_path25.default.join(dir, entry.name);
+    const full = import_node_path26.default.join(dir, entry.name);
     if (exclude.some((x) => full.includes(x))) continue;
     if (entry.isDirectory()) out.push(...await walk(full, exclude));
     else if (entry.name.toLowerCase().endsWith(".png")) out.push(full);
@@ -14529,9 +14777,9 @@ async function scanAssets(root, opts = {}) {
       skipped.push(`${file} (not a readable PNG)`);
       continue;
     }
-    const rel = import_node_path25.default.relative(root, file);
-    const category = import_node_path25.default.dirname(rel) === "." ? "" : import_node_path25.default.dirname(rel);
-    let id = slugify(import_node_path25.default.basename(rel));
+    const rel = import_node_path26.default.relative(root, file);
+    const category = import_node_path26.default.dirname(rel) === "." ? "" : import_node_path26.default.dirname(rel);
+    let id = slugify(import_node_path26.default.basename(rel));
     if (seen.has(id)) {
       const n = seen.get(id) + 1;
       seen.set(id, n);
@@ -15080,7 +15328,7 @@ async function currentArt(entry, spec) {
   const previous = primaryOutput({ ...entry, outputs: entry.supersededOutputs });
   if (!previous) return null;
   const file = resolveOutputPath(previous.path, spec.root);
-  if (!(0, import_node_fs22.existsSync)(file)) return null;
+  if (!(0, import_node_fs23.existsSync)(file)) return null;
   const contentType = previous.mediaType ?? mediaTypeFromExtension(file);
   if (!contentType) return null;
   let width = entry.width;
@@ -15254,15 +15502,15 @@ async function runPicker(provider, lock, lockPath, opts = {}) {
 }
 
 // src/gallery/snapshot.ts
-var import_node_crypto6 = require("crypto");
-var import_node_fs27 = require("fs");
-var import_promises25 = require("fs/promises");
-var import_node_path32 = __toESM(require("path"), 1);
+var import_node_crypto7 = require("crypto");
+var import_node_fs29 = require("fs");
+var import_promises26 = require("fs/promises");
+var import_node_path34 = __toESM(require("path"), 1);
 
 // src/workspace.ts
 var import_promises19 = require("fs/promises");
-var import_node_fs23 = require("fs");
-var import_node_path26 = __toESM(require("path"), 1);
+var import_node_fs24 = require("fs");
+var import_node_path27 = __toESM(require("path"), 1);
 var import_zod7 = require("zod");
 var WorkspaceProjectSchema = import_zod7.z.object({
   id: import_zod7.z.string().min(1),
@@ -15287,7 +15535,7 @@ ${parsed.error.issues.slice(0, 5).map((i) => `  ${i.path.join(".")}: ${i.message
   );
 }
 async function loadWorkspace(workspacePath) {
-  if (!(0, import_node_fs23.existsSync)(workspacePath)) return { version: 1, projects: [] };
+  if (!(0, import_node_fs24.existsSync)(workspacePath)) return { version: 1, projects: [] };
   let raw;
   try {
     raw = JSON.parse(await (0, import_promises19.readFile)(workspacePath, "utf8"));
@@ -15304,7 +15552,7 @@ async function saveWorkspace(workspacePath, ws) {
     version: 1,
     projects: [...ws.projects].sort((a, b) => a.id.localeCompare(b.id))
   };
-  await (0, import_promises19.mkdir)(import_node_path26.default.dirname(import_node_path26.default.resolve(workspacePath)), { recursive: true });
+  await (0, import_promises19.mkdir)(import_node_path27.default.dirname(import_node_path27.default.resolve(workspacePath)), { recursive: true });
   const tmp = `${workspacePath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
   try {
     await (0, import_promises19.writeFile)(tmp, JSON.stringify(sorted, null, 2) + "\n");
@@ -15314,12 +15562,12 @@ async function saveWorkspace(workspacePath, ws) {
   }
 }
 function toPortablePath(dir, absolute) {
-  return import_node_path26.default.relative(dir, absolute).split(import_node_path26.default.sep).join("/");
+  return import_node_path27.default.relative(dir, absolute).split(import_node_path27.default.sep).join("/");
 }
 function resolveProject(dir, project) {
   return {
-    manifestPath: import_node_path26.default.resolve(dir, project.manifest.split("/").join(import_node_path26.default.sep)),
-    lockPath: import_node_path26.default.resolve(dir, project.lock.split("/").join(import_node_path26.default.sep))
+    manifestPath: import_node_path27.default.resolve(dir, project.manifest.split("/").join(import_node_path27.default.sep)),
+    lockPath: import_node_path27.default.resolve(dir, project.lock.split("/").join(import_node_path27.default.sep))
   };
 }
 function validateWorkspace(ws, dir) {
@@ -15332,21 +15580,21 @@ function validateWorkspace(ws, dir) {
     const { manifestPath, lockPath } = resolveProject(dir, project);
     lockOwners.set(lockPath, [...lockOwners.get(lockPath) ?? [], project.id]);
     manifestOwners.set(manifestPath, [...manifestOwners.get(manifestPath) ?? [], project.id]);
-    if (import_node_path26.default.isAbsolute(project.manifest) || import_node_path26.default.isAbsolute(project.lock)) {
+    if (import_node_path27.default.isAbsolute(project.manifest) || import_node_path27.default.isAbsolute(project.lock)) {
       diagnostics.push({
         id: "absolute-path",
         level: "warning",
         message: `project "${project.id}" stores an absolute path; the catalog will not resolve correctly if this tree is cloned or moved elsewhere`
       });
     }
-    if (!(0, import_node_fs23.existsSync)(manifestPath)) {
+    if (!(0, import_node_fs24.existsSync)(manifestPath)) {
       diagnostics.push({
         id: "missing-manifest",
         level: "error",
         message: `project "${project.id}" manifest not found: ${manifestPath}`
       });
     }
-    if (!(0, import_node_fs23.existsSync)(lockPath)) {
+    if (!(0, import_node_fs24.existsSync)(lockPath)) {
       diagnostics.push({
         id: "missing-lock",
         level: "error",
@@ -15393,15 +15641,16 @@ function validateWorkspace(ws, dir) {
 }
 
 // src/gallery/edit.ts
-var import_promises24 = require("fs/promises");
-var import_node_path31 = __toESM(require("path"), 1);
-var import_zod12 = require("zod");
+var import_promises25 = require("fs/promises");
+var import_node_path33 = __toESM(require("path"), 1);
+var import_zod13 = require("zod");
 
 // src/manifest-edit.ts
 var import_promises20 = require("fs/promises");
-var import_node_path27 = __toESM(require("path"), 1);
+var import_node_path28 = __toESM(require("path"), 1);
 var import_zod8 = require("zod");
 var HexSha = import_zod8.z.string().regex(/^[0-9a-f]{64}$/);
+var ProjectFileSchema = import_zod8.z.string().min(1).refine((file) => !import_node_path28.default.isAbsolute(file) && !file.split(/[\\/]/).includes(".."), "must be a path inside the project");
 var AssetPatchSchema = import_zod8.z.object({
   prompt: import_zod8.z.string().optional(),
   /** Per-style override for the style being viewed; null removes it. */
@@ -15450,10 +15699,11 @@ var NewAssetSchema = import_zod8.z.object({
   styles: import_zod8.z.array(import_zod8.z.string().min(1)).optional(),
   /**
    * A controlled regeneration of another asset in the same manifest,
-   * instead of a fresh generation. `inpaint` needs a mask upload and
-   * `interpolate` an ending-keyframe image the gallery does not offer, so
-   * those two are hand-edited; every other mode can be created here
-   * (`animate-skeleton` after the gallery writes its keypoints file).
+   * instead of a fresh generation. Every mode but `outpaint` can be
+   * created here: `inpaint` names a mask file the gallery's mask editor
+   * wrote first, `interpolate` names an existing image as its ending
+   * keyframe, and `animate-skeleton` names the keypoints file the gallery
+   * wrote first.
    */
   revision: import_zod8.z.discriminatedUnion("mode", [
     import_zod8.z.object({
@@ -15470,15 +15720,38 @@ var NewAssetSchema = import_zod8.z.object({
       dithering: RevisionDitheringSchema.optional(),
       ditheringStrength: import_zod8.z.number().min(0).max(10).optional()
     }).strict(),
+    import_zod8.z.object({
+      mode: import_zod8.z.literal("inpaint"),
+      from: import_zod8.z.string().min(1),
+      /** Black-and-white PNG the same size as the parent; white is repainted. */
+      mask: ProjectFileSchema
+    }).strict(),
+    import_zod8.z.object({
+      mode: import_zod8.z.literal("interpolate"),
+      from: import_zod8.z.string().min(1),
+      /** The ending keyframe: an image already in the project, the parent's size. */
+      lastFrame: ProjectFileSchema,
+      fps: import_zod8.z.number().int().min(1).max(60).optional()
+    }).strict(),
     import_zod8.z.object({ mode: import_zod8.z.literal("correct-pixelart"), from: import_zod8.z.string().min(1), strength: import_zod8.z.number().min(0).max(1).optional() }).strict(),
+    import_zod8.z.object({
+      mode: import_zod8.z.literal("remove-background"),
+      from: import_zod8.z.string().min(1),
+      removalTask: import_zod8.z.enum(["simple", "complex"]).optional(),
+      /** A short description of the foreground, sent as PixelLab's text hint. */
+      description: import_zod8.z.string().min(1).optional()
+    }).strict(),
     import_zod8.z.object({
       mode: import_zod8.z.enum(["animate", "animate-pixminimax"]),
       from: import_zod8.z.string().min(1),
       frames: import_zod8.z.number().int().min(4).max(40).refine((n) => n % 2 === 0, "frames must be even").optional(),
       fps: import_zod8.z.number().int().min(1).max(60).optional(),
       enhancePrompt: import_zod8.z.boolean().optional(),
-      /** `animate-pixminimax` only; the loader refuses it on `animate`. */
-      direction: CharacterDirectionSchema.optional()
+      driftThreshold: import_zod8.z.number().min(0).optional(),
+      /** `animate-pixminimax` only; the loader refuses these on `animate`. */
+      direction: CharacterDirectionSchema.optional(),
+      subjectDescription: import_zod8.z.string().min(1).max(300).optional(),
+      initialPose: import_zod8.z.string().min(1).max(300).optional()
     }).strict(),
     import_zod8.z.object({
       mode: import_zod8.z.literal("edit-animation"),
@@ -15796,7 +16069,7 @@ function applyEdit(raw, edit) {
   }
 }
 async function withCandidate(manifestPath, edit, use, unchanged) {
-  const absolute = import_node_path27.default.resolve(manifestPath);
+  const absolute = import_node_path28.default.resolve(manifestPath);
   const original = await (0, import_promises20.readFile)(absolute, "utf8");
   if (sha256(original) !== edit.expectedSha256) throw new ManifestDriftError(absolute);
   let raw;
@@ -15810,9 +16083,9 @@ async function withCandidate(manifestPath, edit, use, unchanged) {
   applyEdit(raw, edit);
   const next = serializeLike(original, raw);
   if (next === original) return unchanged(absolute, original);
-  const tmp = import_node_path27.default.join(
-    import_node_path27.default.dirname(absolute),
-    `.${import_node_path27.default.basename(absolute)}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`
+  const tmp = import_node_path28.default.join(
+    import_node_path28.default.dirname(absolute),
+    `.${import_node_path28.default.basename(absolute)}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`
   );
   try {
     await (0, import_promises20.writeFile)(tmp, next);
@@ -15841,18 +16114,18 @@ async function applyManifestEdit(manifestPath, edit) {
 }
 
 // src/pipeline/hand-edit.ts
-var import_node_fs24 = require("fs");
+var import_node_fs25 = require("fs");
 var import_promises21 = require("fs/promises");
-var import_node_path28 = __toESM(require("path"), 1);
+var import_node_path29 = __toESM(require("path"), 1);
 var import_zod9 = require("zod");
 var HAND_EDIT_DIR = "edits";
 function handEditPath(loaded, spec) {
   const style = loaded.manifest.styles[spec.styleId];
-  const outDir = import_node_path28.default.resolve(loaded.root, style?.outDir ?? ".");
-  const relative = import_node_path28.default.relative(outDir, spec.outFile);
-  const inside = relative && !relative.startsWith("..") && !import_node_path28.default.isAbsolute(relative);
-  const file = inside ? relative : import_node_path28.default.basename(spec.outFile);
-  return import_node_path28.default.join(outDir, HAND_EDIT_DIR, file.replace(/\.gif$/i, ".png"));
+  const outDir = import_node_path29.default.resolve(loaded.root, style?.outDir ?? ".");
+  const relative = import_node_path29.default.relative(outDir, spec.outFile);
+  const inside = relative && !relative.startsWith("..") && !import_node_path29.default.isAbsolute(relative);
+  const file = inside ? relative : import_node_path29.default.basename(spec.outFile);
+  return import_node_path29.default.join(outDir, HAND_EDIT_DIR, file.replace(/\.gif$/i, ".png"));
 }
 function handEditBases(spec, lock) {
   const entry = lock.entries[lockKey(spec.styleId, spec.assetId)];
@@ -15865,10 +16138,10 @@ function handEditBases(spec, lock) {
     }));
     if (members.some((member) => member.mediaType && member.mediaType !== "image/png")) return null;
     if (entry.outputs.length === 1 && !primaryOutput(entry)) return null;
-    if (!members.every((member) => (0, import_node_fs24.existsSync)(member.path))) return null;
+    if (!members.every((member) => (0, import_node_fs25.existsSync)(member.path))) return null;
     return members.map(({ role, path: file }) => ({ role, path: file }));
   }
-  return (0, import_node_fs24.existsSync)(spec.outFile) ? [{ role: null, path: spec.outFile }] : null;
+  return (0, import_node_fs25.existsSync)(spec.outFile) ? [{ role: null, path: spec.outFile }] : null;
 }
 function handEditBase(spec, lock) {
   const bases = handEditBases(spec, lock);
@@ -15898,18 +16171,18 @@ async function startHandEdit(loaded, lock, spec, opts = {}) {
       `${spec.styleId}/${spec.assetId} declares ${spec.source}, one committed file placed for the whole set; clear that source (pixelkiln edit detach) to hand-edit the members one by one`
     );
   }
-  const existing = spec.source ? import_node_path28.default.resolve(loaded.root, spec.source) : null;
+  const existing = spec.source ? import_node_path29.default.resolve(loaded.root, spec.source) : null;
   const editPath = existing ?? handEditPath(loaded, spec);
   const members = handEditMembers(loaded, spec, lock, editPath);
   let created = false;
   for (const member of members) {
-    if ((0, import_node_fs24.existsSync)(member.path)) continue;
+    if ((0, import_node_fs25.existsSync)(member.path)) continue;
     if (!member.base) {
       throw new ManifestEditError(
         `${spec.styleId}/${spec.assetId} has no generated PNG on disk to start from; generate or restore it first`
       );
     }
-    await (0, import_promises21.mkdir)(import_node_path28.default.dirname(member.path), { recursive: true });
+    await (0, import_promises21.mkdir)(import_node_path29.default.dirname(member.path), { recursive: true });
     await (0, import_promises21.copyFile)(member.base, member.path);
     created = true;
   }
@@ -16047,7 +16320,7 @@ async function saveHandEdit(loaded, lock, spec, input) {
     editor: input.editor,
     protocol: input.protocol,
     savedAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
-    project: projectPath ? import_node_path28.default.basename(projectPath) : null,
+    project: projectPath ? import_node_path29.default.basename(projectPath) : null,
     outputs: incoming.map((frame, index) => ({
       role: frame.role,
       basedOn: basedOnHash(entry, index),
@@ -16089,9 +16362,9 @@ function openInEditor(file, editor = process.env.PIXELKILN_EDITOR) {
 }
 
 // src/gallery/upload.ts
-var import_node_fs25 = require("fs");
+var import_node_fs26 = require("fs");
 var import_promises22 = require("fs/promises");
-var import_node_path29 = __toESM(require("path"), 1);
+var import_node_path30 = __toESM(require("path"), 1);
 var import_zod10 = require("zod");
 var MAX_UPLOAD_BYTES = 8 * 1024 * 1024;
 var UploadImageSchema = import_zod10.z.object({
@@ -16104,12 +16377,12 @@ var UploadImageSchema = import_zod10.z.object({
   overwrite: import_zod10.z.boolean().optional()
 }).strict();
 async function saveProjectImage(root, request) {
-  const file = import_node_path29.default.resolve(root, request.path);
-  const relative = import_node_path29.default.relative(root, file);
-  if (relative.startsWith("..") || import_node_path29.default.isAbsolute(relative)) {
+  const file = import_node_path30.default.resolve(root, request.path);
+  const relative = import_node_path30.default.relative(root, file);
+  if (relative.startsWith("..") || import_node_path30.default.isAbsolute(relative)) {
     throw new ManifestEditError("an upload must stay inside the project");
   }
-  const extension = import_node_path29.default.extname(file).toLowerCase();
+  const extension = import_node_path30.default.extname(file).toLowerCase();
   const expected = extension === ".png" ? "png" : extension === ".jpg" || extension === ".jpeg" ? "jpeg" : null;
   if (!expected) throw new ManifestEditError("an upload must be a .png, .jpg, or .jpeg path");
   const bytes = Buffer.from(request.base64, "base64");
@@ -16121,70 +16394,126 @@ async function saveProjectImage(root, request) {
   if (metadata.format !== expected) {
     throw new ManifestEditError(`the upload is a ${metadata.format.toUpperCase()}; name it ${metadata.format === "png" ? ".png" : ".jpg"}`);
   }
-  if ((0, import_node_fs25.existsSync)(file) && !request.overwrite) {
-    throw new ManifestEditError(`${relative.split(import_node_path29.default.sep).join("/")} already exists; choose another name, or replace it`);
+  if ((0, import_node_fs26.existsSync)(file) && !request.overwrite) {
+    throw new ManifestEditError(`${relative.split(import_node_path30.default.sep).join("/")} already exists; choose another name, or replace it`);
   }
-  await (0, import_promises22.mkdir)(import_node_path29.default.dirname(file), { recursive: true });
+  await (0, import_promises22.mkdir)(import_node_path30.default.dirname(file), { recursive: true });
   await (0, import_promises22.writeFile)(file, bytes);
-  return relative.split(import_node_path29.default.sep).join("/");
+  return relative.split(import_node_path30.default.sep).join("/");
 }
 
-// src/gallery/skeleton.ts
-var import_node_fs26 = require("fs");
+// src/gallery/image-revision.ts
+var import_node_fs27 = require("fs");
 var import_promises23 = require("fs/promises");
-var import_node_path30 = __toESM(require("path"), 1);
+var import_node_path31 = __toESM(require("path"), 1);
 var import_zod11 = require("zod");
-var SkeletonEstimateRequestSchema = import_zod11.z.object({
-  project: import_zod11.z.string().min(1).optional(),
-  styleId: import_zod11.z.string().min(1),
-  assetId: import_zod11.z.string().min(1),
-  frames: import_zod11.z.number().int().min(3).max(15).optional()
-}).strict();
-var SkeletonAnimationRequestSchema = import_zod11.z.object({
-  action: import_zod11.z.literal("create-skeleton-animation"),
+var InpaintRevisionRequestSchema = import_zod11.z.object({
+  action: import_zod11.z.literal("create-inpaint-revision"),
   project: import_zod11.z.string().min(1).optional(),
   expectedSha256: import_zod11.z.string().regex(/^[0-9a-f]{64}$/),
   styleId: import_zod11.z.string().min(1),
-  /** The sprite the animation poses. */
+  /** The sprite being repainted. */
   from: import_zod11.z.string().min(1),
   assetId: import_zod11.z.string().min(1).regex(/^[^/\\]+$/, "asset ids cannot contain slashes"),
-  /** The motion, sent as PixelLab's `action`. */
+  /** What to paint into the masked area. */
   prompt: import_zod11.z.string().min(1),
+  /** Manifest-relative `.png` destination for the mask. */
+  maskPath: import_zod11.z.string().min(1),
+  maskBase64: import_zod11.z.string().regex(/^[A-Za-z0-9+/]*={0,2}$/),
+  /** Replace a file already at `maskPath`. */
+  overwrite: import_zod11.z.boolean().optional()
+}).strict();
+async function createInpaintRevision(manifestPath, request) {
+  const root = import_node_path31.default.dirname(import_node_path31.default.resolve(manifestPath));
+  if (import_node_path31.default.extname(request.maskPath).toLowerCase() !== ".png") {
+    throw new ManifestEditError("the mask must be a .png path inside the project");
+  }
+  const bytes = Buffer.from(request.maskBase64, "base64");
+  const metadata = imageMetadata(bytes);
+  if (!metadata || metadata.format !== "png") throw new ManifestEditError("the mask is not a readable PNG");
+  const file = import_node_path31.default.resolve(root, request.maskPath);
+  const previous = (0, import_node_fs27.existsSync)(file) ? await (0, import_promises23.readFile)(file) : null;
+  const mask = await saveProjectImage(root, {
+    action: "upload-image",
+    path: request.maskPath,
+    base64: request.maskBase64,
+    ...request.overwrite ? { overwrite: true } : {}
+  });
+  try {
+    await applyManifestEdit(manifestPath, {
+      action: "add-asset",
+      assetId: request.assetId,
+      expectedSha256: request.expectedSha256,
+      asset: {
+        prompt: request.prompt,
+        styles: [request.styleId],
+        revision: { mode: "inpaint", from: request.from, mask }
+      }
+    });
+  } catch (error) {
+    if (previous) await (0, import_promises23.writeFile)(file, previous);
+    else await (0, import_promises23.rm)(file, { force: true });
+    throw error;
+  }
+  return mask;
+}
+
+// src/gallery/skeleton.ts
+var import_node_fs28 = require("fs");
+var import_promises24 = require("fs/promises");
+var import_node_path32 = __toESM(require("path"), 1);
+var import_zod12 = require("zod");
+var SkeletonEstimateRequestSchema = import_zod12.z.object({
+  project: import_zod12.z.string().min(1).optional(),
+  styleId: import_zod12.z.string().min(1),
+  assetId: import_zod12.z.string().min(1),
+  frames: import_zod12.z.number().int().min(3).max(15).optional()
+}).strict();
+var SkeletonAnimationRequestSchema = import_zod12.z.object({
+  action: import_zod12.z.literal("create-skeleton-animation"),
+  project: import_zod12.z.string().min(1).optional(),
+  expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/),
+  styleId: import_zod12.z.string().min(1),
+  /** The sprite the animation poses. */
+  from: import_zod12.z.string().min(1),
+  assetId: import_zod12.z.string().min(1).regex(/^[^/\\]+$/, "asset ids cannot contain slashes"),
+  /** The motion, sent as PixelLab's `action`. */
+  prompt: import_zod12.z.string().min(1),
   direction: CharacterDirectionSchema,
-  description: import_zod11.z.string().min(1).optional(),
-  skeletonTemplate: import_zod11.z.string().min(1).optional(),
+  description: import_zod12.z.string().min(1).optional(),
+  skeletonTemplate: import_zod12.z.string().min(1).optional(),
   /** Manifest-relative JSON path inside the project. */
-  keypointsFile: import_zod11.z.string().min(1),
+  keypointsFile: import_zod12.z.string().min(1),
   /** Poses to write to `keypointsFile`; omitted to use a file that already exists. */
   set: SkeletonSetSchema.optional(),
   /** Replace an existing `keypointsFile` with `set`. */
-  overwrite: import_zod11.z.boolean().optional()
+  overwrite: import_zod12.z.boolean().optional()
 }).strict();
-var SkeletonKeypointsUpdateSchema = import_zod11.z.object({
-  action: import_zod11.z.literal("update-skeleton-keypoints"),
-  project: import_zod11.z.string().min(1).optional(),
-  styleId: import_zod11.z.string().min(1),
-  assetId: import_zod11.z.string().min(1),
+var SkeletonKeypointsUpdateSchema = import_zod12.z.object({
+  action: import_zod12.z.literal("update-skeleton-keypoints"),
+  project: import_zod12.z.string().min(1).optional(),
+  styleId: import_zod12.z.string().min(1),
+  assetId: import_zod12.z.string().min(1),
   /** The file's SHA-256 when the page loaded it; anything else on disk is a concurrent edit. */
-  expectedSha256: import_zod11.z.string().regex(/^[0-9a-f]{64}$/),
+  expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/),
   set: SkeletonSetSchema
 }).strict();
 async function createSkeletonAnimation(manifestPath, request) {
-  const root = import_node_path30.default.dirname(import_node_path30.default.resolve(manifestPath));
-  const file = import_node_path30.default.resolve(root, request.keypointsFile);
-  const relative = import_node_path30.default.relative(root, file);
-  if (!request.keypointsFile.endsWith(".json") || relative.startsWith("..") || import_node_path30.default.isAbsolute(relative)) {
+  const root = import_node_path32.default.dirname(import_node_path32.default.resolve(manifestPath));
+  const file = import_node_path32.default.resolve(root, request.keypointsFile);
+  const relative = import_node_path32.default.relative(root, file);
+  if (!request.keypointsFile.endsWith(".json") || relative.startsWith("..") || import_node_path32.default.isAbsolute(relative)) {
     throw new ManifestEditError("the keypoints file must be a .json path inside the project");
   }
-  const existed = (0, import_node_fs26.existsSync)(file);
+  const existed = (0, import_node_fs28.existsSync)(file);
   let previous = null;
   if (request.set) {
     if (existed && !request.overwrite) {
       throw new ManifestEditError(`${request.keypointsFile} already exists; choose another path, or replace it`);
     }
-    if (existed) previous = await (0, import_promises23.readFile)(file);
-    await (0, import_promises23.mkdir)(import_node_path30.default.dirname(file), { recursive: true });
-    await (0, import_promises23.writeFile)(file, JSON.stringify(request.set, null, 2) + "\n");
+    if (existed) previous = await (0, import_promises24.readFile)(file);
+    await (0, import_promises24.mkdir)(import_node_path32.default.dirname(file), { recursive: true });
+    await (0, import_promises24.writeFile)(file, JSON.stringify(request.set, null, 2) + "\n");
   } else if (!existed) {
     throw new ManifestEditError(`${request.keypointsFile} does not exist; paste poses or estimate them from the sprite`);
   }
@@ -16199,7 +16528,7 @@ async function createSkeletonAnimation(manifestPath, request) {
         revision: {
           mode: "animate-skeleton",
           from: request.from,
-          keypointsFile: relative.split(import_node_path30.default.sep).join("/"),
+          keypointsFile: relative.split(import_node_path32.default.sep).join("/"),
           direction: request.direction,
           ...request.description ? { description: request.description } : {},
           ...request.skeletonTemplate ? { skeletonTemplate: request.skeletonTemplate } : {}
@@ -16208,8 +16537,8 @@ async function createSkeletonAnimation(manifestPath, request) {
     });
   } catch (error) {
     if (request.set) {
-      if (previous) await (0, import_promises23.writeFile)(file, previous);
-      else await (0, import_promises23.rm)(file, { force: true });
+      if (previous) await (0, import_promises24.writeFile)(file, previous);
+      else await (0, import_promises24.rm)(file, { force: true });
     }
     throw error;
   }
@@ -16220,64 +16549,64 @@ async function updateSkeletonKeypoints(ctx, request) {
   if (!spec) throw new ManifestEditError(`"${key}" is not declared by the manifest`);
   const file = spec.revision?.mode === "animate-skeleton" ? spec.revision.keypointsFile : void 0;
   if (!file) throw new ManifestEditError(`${key} is not an animate-skeleton revision`);
-  const relative = import_node_path30.default.relative(ctx.loaded.root, file);
-  if (relative.startsWith("..") || import_node_path30.default.isAbsolute(relative)) {
+  const relative = import_node_path32.default.relative(ctx.loaded.root, file);
+  if (relative.startsWith("..") || import_node_path32.default.isAbsolute(relative)) {
     throw new ManifestEditError(`${key}'s keypoints file is outside the project; edit it by hand`);
   }
-  const current = (0, import_node_fs26.existsSync)(file) ? sha256(await (0, import_promises23.readFile)(file)) : null;
+  const current = (0, import_node_fs28.existsSync)(file) ? sha256(await (0, import_promises24.readFile)(file)) : null;
   if (current !== request.expectedSha256) {
     throw Object.assign(
-      new Error(`${relative.split(import_node_path30.default.sep).join("/")} changed on disk since this page loaded it; press Refresh and edit again`),
+      new Error(`${relative.split(import_node_path32.default.sep).join("/")} changed on disk since this page loaded it; press Refresh and edit again`),
       { status: 409 }
     );
   }
-  await (0, import_promises23.writeFile)(file, JSON.stringify(request.set, null, 2) + "\n");
-  return relative.split(import_node_path30.default.sep).join("/");
+  await (0, import_promises24.writeFile)(file, JSON.stringify(request.set, null, 2) + "\n");
+  return relative.split(import_node_path32.default.sep).join("/");
 }
 
 // src/gallery/edit.ts
-var Base64 = import_zod12.z.string().regex(/^[A-Za-z0-9+/]*={0,2}$/).max(Math.ceil(MAX_HAND_EDIT_BYTES / 3) * 4);
-var HandEditRequestSchema = import_zod12.z.discriminatedUnion("action", [
-  import_zod12.z.object({
-    action: import_zod12.z.literal("start-edit"),
-    project: import_zod12.z.string().min(1).optional(),
-    assetId: import_zod12.z.string().min(1),
-    styleId: import_zod12.z.string().min(1),
-    expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/),
+var Base64 = import_zod13.z.string().regex(/^[A-Za-z0-9+/]*={0,2}$/).max(Math.ceil(MAX_HAND_EDIT_BYTES / 3) * 4);
+var HandEditRequestSchema = import_zod13.z.discriminatedUnion("action", [
+  import_zod13.z.object({
+    action: import_zod13.z.literal("start-edit"),
+    project: import_zod13.z.string().min(1).optional(),
+    assetId: import_zod13.z.string().min(1),
+    styleId: import_zod13.z.string().min(1),
+    expectedSha256: import_zod13.z.string().regex(/^[0-9a-f]{64}$/),
     /** Also launch the author's editor on the file. */
-    open: import_zod12.z.boolean().optional()
+    open: import_zod13.z.boolean().optional()
   }).strict(),
-  import_zod12.z.object({
-    action: import_zod12.z.literal("detach-edit"),
-    project: import_zod12.z.string().min(1).optional(),
-    assetId: import_zod12.z.string().min(1),
-    styleId: import_zod12.z.string().min(1),
-    expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/)
+  import_zod13.z.object({
+    action: import_zod13.z.literal("detach-edit"),
+    project: import_zod13.z.string().min(1).optional(),
+    assetId: import_zod13.z.string().min(1),
+    styleId: import_zod13.z.string().min(1),
+    expectedSha256: import_zod13.z.string().regex(/^[0-9a-f]{64}$/)
   }).strict(),
   /** From the in-browser editor: the page holds the bytes, the server validates and writes. */
-  import_zod12.z.object({
-    action: import_zod12.z.literal("save-edit"),
-    project: import_zod12.z.string().min(1).optional(),
-    assetId: import_zod12.z.string().min(1),
-    styleId: import_zod12.z.string().min(1),
-    expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/),
+  import_zod13.z.object({
+    action: import_zod13.z.literal("save-edit"),
+    project: import_zod13.z.string().min(1).optional(),
+    assetId: import_zod13.z.string().min(1),
+    styleId: import_zod13.z.string().min(1),
+    expectedSha256: import_zod13.z.string().regex(/^[0-9a-f]{64}$/),
     /** The flattened image; for a frame set, `frames` instead. */
     png: Base64.min(1).optional(),
     /** Every frame of a set, tagged with the role it was opened under (null for one added in the editor). */
-    frames: import_zod12.z.array(import_zod12.z.object({ role: import_zod12.z.string().min(1).nullable(), png: Base64.min(1) }).strict()).min(1).max(256).optional(),
+    frames: import_zod13.z.array(import_zod13.z.object({ role: import_zod13.z.string().min(1).nullable(), png: Base64.min(1) }).strict()).min(1).max(256).optional(),
     /** The editor's layered project file, kept beside the edit. */
     pxo: Base64.optional(),
     /** Editor identity from the bridge's ready message. */
-    editor: import_zod12.z.string().min(1).max(200),
-    protocol: import_zod12.z.number().int().positive()
+    editor: import_zod13.z.string().min(1).max(200),
+    protocol: import_zod13.z.number().int().positive()
   }).strict()
 ]);
 var UNDO_DEPTH = 20;
-var UndoRequestSchema = import_zod12.z.object({
-  action: import_zod12.z.literal("undo-edit"),
-  project: import_zod12.z.string().min(1).optional(),
+var UndoRequestSchema = import_zod13.z.object({
+  action: import_zod13.z.literal("undo-edit"),
+  project: import_zod13.z.string().min(1).optional(),
   /** The manifest as the page last saw it; undo refuses a manifest someone else has changed since. */
-  expectedSha256: import_zod12.z.string().regex(/^[0-9a-f]{64}$/)
+  expectedSha256: import_zod13.z.string().regex(/^[0-9a-f]{64}$/)
 }).strict();
 function createGalleryEditHandler(opts) {
   const log = opts.onProgress ?? (() => {
@@ -16286,7 +16615,7 @@ function createGalleryEditHandler(opts) {
   const history = /* @__PURE__ */ new Map();
   const manifestOf = async (project) => {
     try {
-      return import_node_path31.default.resolve(await opts.manifestFor(typeof project === "string" ? project : void 0));
+      return import_node_path33.default.resolve(await opts.manifestFor(typeof project === "string" ? project : void 0));
     } catch {
       return null;
     }
@@ -16296,7 +16625,7 @@ function createGalleryEditHandler(opts) {
     if (undo.success) {
       const manifestPath2 = await manifestOf(undo.data.project);
       if (!manifestPath2) throw new ManifestEditError("no manifest to undo an edit in");
-      const current = await (0, import_promises24.readFile)(manifestPath2, "utf8");
+      const current = await (0, import_promises25.readFile)(manifestPath2, "utf8");
       if (sha256(current) !== undo.data.expectedSha256) throw new ManifestDriftError(manifestPath2);
       const stack = history.get(manifestPath2) ?? [];
       const last = stack[stack.length - 1];
@@ -16306,17 +16635,17 @@ function createGalleryEditHandler(opts) {
         throw Object.assign(new Error("the manifest changed outside the gallery since its last edit; undo would discard that change"), { status: 409 });
       }
       const tmp = manifestPath2 + ".pixelkiln-undo";
-      await (0, import_promises24.writeFile)(tmp, last.before);
-      await (0, import_promises24.rename)(tmp, manifestPath2);
+      await (0, import_promises25.writeFile)(tmp, last.before);
+      await (0, import_promises25.rename)(tmp, manifestPath2);
       stack.pop();
-      log(`  manifest edit undone in ${import_node_path31.default.relative(process.cwd(), manifestPath2) || manifestPath2}`);
+      log(`  manifest edit undone in ${import_node_path33.default.relative(process.cwd(), manifestPath2) || manifestPath2}`);
       return opts.reload();
     }
     const manifestPath = await manifestOf(body?.project);
-    const before = manifestPath ? await (0, import_promises24.readFile)(manifestPath, "utf8").catch(() => null) : null;
+    const before = manifestPath ? await (0, import_promises25.readFile)(manifestPath, "utf8").catch(() => null) : null;
     const build = await apply(body);
     if (manifestPath && before !== null) {
-      const after = await (0, import_promises24.readFile)(manifestPath, "utf8").catch(() => null);
+      const after = await (0, import_promises25.readFile)(manifestPath, "utf8").catch(() => null);
       if (after !== null && after !== before) {
         const stack = history.get(manifestPath) ?? [];
         stack.push({ before, afterSha: sha256(after) });
@@ -16371,7 +16700,7 @@ function createEditApplier(opts, log) {
       } catch (error) {
         throw new ManifestEditError(error instanceof Error ? error.message : String(error));
       }
-      const written = await saveProjectImage(import_node_path31.default.dirname(import_node_path31.default.resolve(manifestPath2)), upload.data);
+      const written = await saveProjectImage(import_node_path33.default.dirname(import_node_path33.default.resolve(manifestPath2)), upload.data);
       log(`  image added: ${written}`);
       return opts.reload();
     }
@@ -16407,6 +16736,23 @@ function createEditApplier(opts, log) {
         "invalid skeleton animation: " + skeleton.error.issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
       );
     }
+    const inpaint = InpaintRevisionRequestSchema.safeParse(body);
+    if (inpaint.success) {
+      let manifestPath2;
+      try {
+        manifestPath2 = await opts.manifestFor(inpaint.data.project);
+      } catch (error) {
+        throw new ManifestEditError(error instanceof Error ? error.message : String(error));
+      }
+      const mask = await createInpaintRevision(manifestPath2, inpaint.data);
+      log(`  manifest edited: added inpaint revision ${inpaint.data.assetId} (mask ${mask})`);
+      return opts.reload();
+    }
+    if (body?.action === "create-inpaint-revision") {
+      throw new ManifestEditError(
+        "invalid inpaint revision: " + inpaint.error.issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
+      );
+    }
     const parsed = ManifestEditSchema.safeParse(body);
     if (!parsed.success) {
       throw new ManifestEditError(
@@ -16421,7 +16767,7 @@ function createEditApplier(opts, log) {
     }
     const result = await applyManifestEdit(manifestPath, parsed.data);
     if (result.changed) {
-      const relative = import_node_path31.default.relative(process.cwd(), result.manifestPath);
+      const relative = import_node_path33.default.relative(process.cwd(), result.manifestPath);
       const shown = !relative || relative.startsWith("..") ? result.manifestPath : relative;
       log(`  manifest edited: ${describeEdit(parsed.data)} in ${shown}`);
     }
@@ -16449,7 +16795,7 @@ function describeEdit(edit) {
 // src/gallery/snapshot.ts
 var PROJECT_FILE_TYPE = "application/octet-stream";
 function galleryMediaId(absolutePath) {
-  return (0, import_node_crypto6.createHash)("sha256").update(import_node_path32.default.resolve(absolutePath)).digest("hex").slice(0, 24);
+  return (0, import_node_crypto7.createHash)("sha256").update(import_node_path34.default.resolve(absolutePath)).digest("hex").slice(0, 24);
 }
 function galleryMediaRoute(id) {
   return `/media/${id}`;
@@ -16468,9 +16814,9 @@ function describeHistory(media, entry, cacheDir) {
   return (entry.history ?? []).map((generation, i) => {
     const outputs = generation.outputs.map((output) => {
       const mediaType = output.mediaType ?? MediaType.PNG;
-      const file = import_node_path32.default.join(cacheDir, cacheFileName(output.sha256, mediaType));
+      const file = import_node_path34.default.join(cacheDir, cacheFileName(output.sha256, mediaType));
       let url = null;
-      if ((0, import_node_fs27.existsSync)(file)) {
+      if ((0, import_node_fs29.existsSync)(file)) {
         const id = galleryMediaId(file);
         media.set(id, { path: file, contentType: mediaType });
         url = `${galleryMediaRoute(id)}?v=${output.sha256.slice(0, 24)}`;
@@ -16502,7 +16848,7 @@ function describeHistory(media, entry, cacheDir) {
 var MAX_COMPARED_BYTES = 8 * 1024 * 1024;
 async function samePixels(a, b) {
   try {
-    const [left, right] = await Promise.all([(0, import_promises25.readFile)(a), (0, import_promises25.readFile)(b)]);
+    const [left, right] = await Promise.all([(0, import_promises26.readFile)(a), (0, import_promises26.readFile)(b)]);
     if (left.length > MAX_COMPARED_BYTES || right.length > MAX_COMPARED_BYTES) return false;
     const x = decodePng(left);
     const y = decodePng(right);
@@ -16568,7 +16914,7 @@ function describeCharacter(spec, entry) {
 }
 async function fileInfo(absolutePath) {
   try {
-    const info = await (0, import_promises25.stat)(absolutePath);
+    const info = await (0, import_promises26.stat)(absolutePath);
     return info.isFile() ? { bytes: info.size, modifiedAt: info.mtime.toISOString() } : null;
   } catch {
     return null;
@@ -16600,10 +16946,10 @@ async function describeOutput(media, root, absolutePath, recorded = {}) {
 async function describeQuality(media, root, inspection) {
   const outputPaths = inspection.outputs ?? [inspection.output];
   const outputs = await Promise.all(
-    outputPaths.map((file) => describeOutput(media, root, import_node_path32.default.resolve(root, file)))
+    outputPaths.map((file) => describeOutput(media, root, import_node_path34.default.resolve(root, file)))
   );
-  const recordPath = import_node_path32.default.resolve(root, inspection.record);
-  const recordExists = (0, import_node_fs27.existsSync)(recordPath);
+  const recordPath = import_node_path34.default.resolve(root, inspection.record);
+  const recordExists = (0, import_node_fs29.existsSync)(recordPath);
   let options = null;
   let check = null;
   if (recordExists) {
@@ -16622,7 +16968,7 @@ async function describeQuality(media, root, inspection) {
   return {
     state: inspection.state,
     reason: inspection.reason,
-    output: portableOutputPath(import_node_path32.default.resolve(root, inspection.output), root),
+    output: portableOutputPath(import_node_path34.default.resolve(root, inspection.output), root),
     record: portableOutputPath(recordPath, root),
     recordExists,
     outputs,
@@ -16660,9 +17006,9 @@ async function buildGallerySnapshot(opts) {
   const media = /* @__PURE__ */ new Map();
   const plan = await buildPlan(specs, lock);
   const items = [];
-  const manifestText = await (0, import_promises25.readFile)(loaded.path, "utf8");
+  const manifestText = await (0, import_promises26.readFile)(loaded.path, "utf8");
   const manifestSha256 = sha256(manifestText);
-  const cacheDir = import_node_path32.default.resolve(import_node_path32.default.dirname(opts.lockPath), ".pixelkiln", "cache");
+  const cacheDir = import_node_path34.default.resolve(import_node_path34.default.dirname(opts.lockPath), ".pixelkiln", "cache");
   let rawStyles = {};
   try {
     const raw = JSON.parse(manifestText);
@@ -16686,12 +17032,12 @@ async function buildGallerySnapshot(opts) {
         )
       );
       if (spec.source) {
-        const editPath = import_node_path32.default.resolve(root, spec.source);
+        const editPath = import_node_path34.default.resolve(root, spec.source);
         const memberCount = sourceIsStem(spec.source, entry, root) ? entry.outputs.length : 1;
         const editShas = await Promise.all(
           Array.from({ length: memberCount }, async (_, index) => {
             const file = sourceOutputPath(spec.source, entry, index, root);
-            return { file, sha256: (0, import_node_fs27.existsSync)(file) ? await sha256File(file) : null };
+            return { file, sha256: (0, import_node_fs29.existsSync)(file) ? await sha256File(file) : null };
           })
         );
         edits = await Promise.all(editShas.map(({ file, sha256: editSha }) => describeOutput(media, root, file, { sha256: editSha })));
@@ -16699,7 +17045,7 @@ async function buildGallerySnapshot(opts) {
         const companion = await readHandEditCompanion(editPath);
         if (companion) {
           const projectPath = handEditProjectPath(editPath);
-          const project = companion.project && (0, import_node_fs27.existsSync)(projectPath) ? await fileInfo(projectPath) : null;
+          const project = companion.project && (0, import_node_fs29.existsSync)(projectPath) ? await fileInfo(projectPath) : null;
           let projectUrl = null;
           if (project) {
             const id = galleryMediaId(projectPath);
@@ -16735,8 +17081,8 @@ async function buildGallerySnapshot(opts) {
         editStatus = edits.some((member) => !member.exists) ? "missing" : editChanged.every((changed) => !changed) ? "same" : regenerated ? "regenerated-since" : "edited";
       }
     } else if (spec.source) {
-      outputs = [await describeOutput(media, root, import_node_path32.default.resolve(root, spec.source))];
-    } else if (!entry && (0, import_node_fs27.existsSync)(spec.outFile)) {
+      outputs = [await describeOutput(media, root, import_node_path34.default.resolve(root, spec.source))];
+    } else if (!entry && (0, import_node_fs29.existsSync)(spec.outFile)) {
       outputs = [await describeOutput(media, root, spec.outFile)];
     } else {
       outputs = [];
@@ -16939,7 +17285,7 @@ async function buildGallerySnapshot(opts) {
       id: loaded.manifest.name,
       name: loaded.manifest.name,
       manifest: loaded.path,
-      lock: import_node_path32.default.resolve(opts.lockPath),
+      lock: import_node_path34.default.resolve(opts.lockPath),
       root,
       provider: loaded.manifest.provider,
       account: null,
@@ -16965,7 +17311,7 @@ async function buildGallerySnapshot(opts) {
   return { snapshot, media };
 }
 async function buildWorkspaceGallerySnapshot(opts) {
-  const dir = import_node_path32.default.dirname(import_node_path32.default.resolve(opts.workspacePath));
+  const dir = import_node_path34.default.dirname(import_node_path34.default.resolve(opts.workspacePath));
   const media = /* @__PURE__ */ new Map();
   const projects = [];
   const items = [];
@@ -17008,11 +17354,11 @@ async function buildWorkspaceGallerySnapshot(opts) {
         id: project.id,
         name: loaded.manifest.name,
         manifest: manifestPath,
-        lock: import_node_path32.default.resolve(lockPath),
+        lock: import_node_path34.default.resolve(lockPath),
         root: loaded.root,
         provider: loaded.manifest.provider,
         account: project.account ?? null,
-        manifestSha256: manifestSha256 ?? sha256(await (0, import_promises25.readFile)(manifestPath, "utf8")),
+        manifestSha256: manifestSha256 ?? sha256(await (0, import_promises26.readFile)(manifestPath, "utf8")),
         historyLimit: historyLimit(loaded.manifest),
         entries: Object.keys(lock.entries).length,
         items: projectItems.length,
@@ -17024,8 +17370,8 @@ async function buildWorkspaceGallerySnapshot(opts) {
         id: project.id,
         name: project.id,
         manifest: manifestPath,
-        lock: import_node_path32.default.resolve(lockPath),
-        root: import_node_path32.default.dirname(manifestPath),
+        lock: import_node_path34.default.resolve(lockPath),
+        root: import_node_path34.default.dirname(manifestPath),
         provider: project.provider,
         account: project.account ?? null,
         manifestSha256: null,
@@ -17052,7 +17398,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
       version: 1,
       generatedAt: (opts.now ?? (() => /* @__PURE__ */ new Date()))().toISOString(),
       project: null,
-      workspace: { path: import_node_path32.default.resolve(opts.workspacePath), dir, projects },
+      workspace: { path: import_node_path34.default.resolve(opts.workspacePath), dir, projects },
       filter,
       totals: {
         entries: projects.reduce((sum, project) => sum + project.entries, 0),
@@ -17069,7 +17415,7 @@ async function buildWorkspaceGallerySnapshot(opts) {
 }
 
 // src/gallery/page.ts
-var import_node_fs28 = require("fs");
+var import_node_fs30 = require("fs");
 
 // src/gallery/client-bundle.ts
 var import_node_module = require("module");
@@ -17109,8 +17455,8 @@ var client;
 function clientAssets() {
   const prebuilt = new URL("gallery.js", CLIENT_DIR);
   client ??= {
-    css: (0, import_node_fs28.readFileSync)(new URL("gallery.css", CLIENT_DIR), "utf8"),
-    js: (0, import_node_fs28.existsSync)(prebuilt) ? (0, import_node_fs28.readFileSync)(prebuilt, "utf8") : bundleGalleryClient()
+    css: (0, import_node_fs30.readFileSync)(new URL("gallery.css", CLIENT_DIR), "utf8"),
+    js: (0, import_node_fs30.existsSync)(prebuilt) ? (0, import_node_fs30.readFileSync)(prebuilt, "utf8") : bundleGalleryClient()
   };
   return client;
 }
@@ -17252,11 +17598,11 @@ var EDITOR_PIN = pin_default;
 var EDITOR_RELEASE_BASE = "https://github.com/gfargo/pixelkiln/releases/download";
 
 // src/editor/install.ts
-var import_node_crypto7 = require("crypto");
-var import_node_fs29 = require("fs");
-var import_promises26 = require("fs/promises");
-var import_node_os3 = __toESM(require("os"), 1);
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_crypto8 = require("crypto");
+var import_node_fs31 = require("fs");
+var import_promises27 = require("fs/promises");
+var import_node_os4 = __toESM(require("os"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 var EditorInstallError = class extends Error {
   constructor(message6, file) {
     super(message6);
@@ -17267,15 +17613,15 @@ var EditorInstallError = class extends Error {
 };
 function editorToolsRoot() {
   const override = process.env.PIXELKILN_TOOLS_DIR?.trim();
-  if (override) return import_node_path33.default.resolve(override);
-  if (process.platform === "darwin") return import_node_path33.default.join(import_node_os3.default.homedir(), "Library", "Caches", "pixelkiln", "tools");
+  if (override) return import_node_path35.default.resolve(override);
+  if (process.platform === "darwin") return import_node_path35.default.join(import_node_os4.default.homedir(), "Library", "Caches", "pixelkiln", "tools");
   if (process.platform === "win32") {
-    return import_node_path33.default.join(process.env.LOCALAPPDATA ?? import_node_path33.default.join(import_node_os3.default.homedir(), "AppData", "Local"), "pixelkiln", "tools");
+    return import_node_path35.default.join(process.env.LOCALAPPDATA ?? import_node_path35.default.join(import_node_os4.default.homedir(), "AppData", "Local"), "pixelkiln", "tools");
   }
-  return import_node_path33.default.join(process.env.XDG_CACHE_HOME ?? import_node_path33.default.join(import_node_os3.default.homedir(), ".cache"), "pixelkiln", "tools");
+  return import_node_path35.default.join(process.env.XDG_CACHE_HOME ?? import_node_path35.default.join(import_node_os4.default.homedir(), ".cache"), "pixelkiln", "tools");
 }
 function editorDir(pin = EDITOR_PIN, root = editorToolsRoot()) {
-  return import_node_path33.default.join(root, "pixelorama", pin.release ?? "unpublished");
+  return import_node_path35.default.join(root, "pixelorama", pin.release ?? "unpublished");
 }
 function editorBaseUrl(pin = EDITOR_PIN) {
   const override = process.env.PIXELKILN_EDITOR_URL?.trim();
@@ -17285,7 +17631,7 @@ function editorBaseUrl(pin = EDITOR_PIN) {
 }
 async function sha256Of(file) {
   try {
-    return (0, import_node_crypto7.createHash)("sha256").update(await (0, import_promises26.readFile)(file)).digest("hex");
+    return (0, import_node_crypto8.createHash)("sha256").update(await (0, import_promises27.readFile)(file)).digest("hex");
   } catch {
     return null;
   }
@@ -17298,8 +17644,8 @@ async function editorStatus(opts = {}) {
   let totalBytes = 0;
   for (const [name, expected] of Object.entries(pin.files)) {
     totalBytes += expected.bytes;
-    const file = import_node_path33.default.join(dir, name);
-    const info = (0, import_node_fs29.existsSync)(file) ? await (0, import_promises26.stat)(file).catch(() => null) : null;
+    const file = import_node_path35.default.join(dir, name);
+    const info = (0, import_node_fs31.existsSync)(file) ? await (0, import_promises27.stat)(file).catch(() => null) : null;
     if (info && info.size === expected.bytes && await sha256Of(file) === expected.sha256) {
       installedBytes += expected.bytes;
     } else {
@@ -17328,7 +17674,7 @@ async function installEditor(opts = {}) {
     );
   }
   if (!baseUrl) throw new EditorInstallError("no download location for the editor build");
-  await (0, import_promises26.mkdir)(dir, { recursive: true });
+  await (0, import_promises27.mkdir)(dir, { recursive: true });
   const downloaded = [];
   const skipped = Object.keys(pin.files).filter((name) => !before.missing.includes(name));
   let fetchedBytes = before.installedBytes;
@@ -17352,17 +17698,17 @@ async function installEditor(opts = {}) {
     if (bytes.length !== expected.bytes) {
       throw new EditorInstallError(`${name}: expected ${expected.bytes} bytes, got ${bytes.length}`, name);
     }
-    const digest2 = (0, import_node_crypto7.createHash)("sha256").update(bytes).digest("hex");
+    const digest2 = (0, import_node_crypto8.createHash)("sha256").update(bytes).digest("hex");
     if (digest2 !== expected.sha256) {
       throw new EditorInstallError(`${name}: sha256 ${digest2.slice(0, 12)}\u2026 does not match the pinned ${expected.sha256.slice(0, 12)}\u2026`, name);
     }
-    const final = import_node_path33.default.join(dir, name);
+    const final = import_node_path35.default.join(dir, name);
     const tmp = `${final}.${process.pid}.part`;
     try {
-      await (0, import_promises26.writeFile)(tmp, bytes);
-      await (0, import_promises26.rename)(tmp, final);
+      await (0, import_promises27.writeFile)(tmp, bytes);
+      await (0, import_promises27.rename)(tmp, final);
     } finally {
-      await (0, import_promises26.rm)(tmp, { force: true });
+      await (0, import_promises27.rm)(tmp, { force: true });
     }
     fetchedBytes += bytes.length;
     downloaded.push(name);
@@ -17402,12 +17748,12 @@ var EDITOR_CONTENT_TYPES = {
   ".json": "application/json; charset=utf-8"
 };
 function editorContentType(name) {
-  return EDITOR_CONTENT_TYPES[import_node_path33.default.extname(name).toLowerCase()] ?? null;
+  return EDITOR_CONTENT_TYPES[import_node_path35.default.extname(name).toLowerCase()] ?? null;
 }
 
 // src/gallery/editor.ts
-var import_promises27 = require("fs/promises");
-var import_node_path34 = __toESM(require("path"), 1);
+var import_promises28 = require("fs/promises");
+var import_node_path36 = __toESM(require("path"), 1);
 function editorRoute(release, name = "index.html") {
   return `/editor/${encodeURIComponent(release)}/${encodeURIComponent(name)}`;
 }
@@ -17480,7 +17826,7 @@ function createGalleryEditorHandlers(opts = {}) {
       if (!status.installed) return null;
       let bytes;
       try {
-        bytes = await (0, import_promises27.readFile)(import_node_path34.default.join(dir, name));
+        bytes = await (0, import_promises28.readFile)(import_node_path36.default.join(dir, name));
       } catch {
         verified = null;
         return null;
@@ -17495,9 +17841,9 @@ function createGalleryEditorHandlers(opts = {}) {
 }
 
 // src/gallery/server.ts
-var import_node_crypto8 = require("crypto");
+var import_node_crypto9 = require("crypto");
 var import_node_http2 = require("http");
-var import_promises28 = require("fs/promises");
+var import_promises29 = require("fs/promises");
 var MAX_EDIT_BYTES = 48 * 1024 * 1024;
 var EDITOR_CSP = [
   "default-src 'self'",
@@ -17525,7 +17871,7 @@ async function readJsonBody(req) {
 async function serveGallery(opts) {
   const log = opts.onProgress ?? (() => {
   });
-  const session = opts.edit || opts.generate || opts.editor || opts.skeleton || opts.price ? (0, import_node_crypto8.randomBytes)(16).toString("hex") : null;
+  const session = opts.edit || opts.generate || opts.editor || opts.skeleton || opts.price ? (0, import_node_crypto9.randomBytes)(16).toString("hex") : null;
   let media = /* @__PURE__ */ new Map();
   let loading = null;
   const reviewAssets = /* @__PURE__ */ new Map();
@@ -17678,7 +18024,7 @@ async function serveGallery(opts) {
         const asset = reviewAssets.get(jobId)?.get(url2.pathname);
         if (!asset) return fail(404, "no such review asset");
         try {
-          const bytes = await (0, import_promises28.readFile)(asset.path);
+          const bytes = await (0, import_promises29.readFile)(asset.path);
           res.writeHead(200, {
             "Content-Type": asset.contentType,
             "Cache-Control": "no-store",
@@ -17729,7 +18075,7 @@ async function serveGallery(opts) {
     try {
       if (url2.pathname === "/") {
         const { snapshot } = await load();
-        const nonce = (0, import_node_crypto8.randomBytes)(16).toString("base64");
+        const nonce = (0, import_node_crypto9.randomBytes)(16).toString("base64");
         res.writeHead(200, {
           "Content-Type": "text/html; charset=utf-8",
           "Cache-Control": "no-store",
@@ -17761,7 +18107,7 @@ async function serveGallery(opts) {
         if (!asset) return fail(404, "no such gallery media");
         let bytes;
         try {
-          bytes = await (0, import_promises28.readFile)(asset.path);
+          bytes = await (0, import_promises29.readFile)(asset.path);
         } catch {
           return fail(404, "gallery media is no longer on disk; refresh the page");
         }
@@ -17804,28 +18150,28 @@ async function serveGallery(opts) {
 }
 
 // src/gallery/generate.ts
-var import_node_crypto9 = require("crypto");
-var import_zod13 = require("zod");
-var GenerateRequestSchema = import_zod13.z.object({
-  project: import_zod13.z.string().min(1).optional(),
-  keys: import_zod13.z.array(import_zod13.z.string().min(1)).min(1).max(500),
+var import_node_crypto10 = require("crypto");
+var import_zod14 = require("zod");
+var GenerateRequestSchema = import_zod14.z.object({
+  project: import_zod14.z.string().min(1).optional(),
+  keys: import_zod14.z.array(import_zod14.z.string().min(1)).min(1).max(500),
   /**
    * Regenerate work that is up to date, as `gen --force` does, and let the
    * fetch replace a locally modified or untracked file. With `restore`, put
    * the recorded bytes back over a modified file.
    */
-  force: import_zod13.z.boolean().optional(),
+  force: import_zod14.z.boolean().optional(),
   /** Advance in-flight, review, or selected work without submitting anything. */
-  resume: import_zod13.z.boolean().optional(),
+  resume: import_zod14.z.boolean().optional(),
   /** Re-download downloaded outputs and replace files whose object changed upstream. */
-  refresh: import_zod13.z.boolean().optional(),
+  refresh: import_zod14.z.boolean().optional(),
   /** Put recorded outputs back on disk from the cache or the provider, without generating. */
-  restore: import_zod13.z.boolean().optional(),
+  restore: import_zod14.z.boolean().optional(),
   /**
    * Bring a replaced generation back: 1-based position in the record's
    * history (newest first) or an output hash prefix. One key at a time.
    */
-  revert: import_zod13.z.string().min(1).max(64).optional()
+  revert: import_zod14.z.string().min(1).max(64).optional()
 }).strict().refine((request) => [request.resume, request.refresh, request.restore, request.revert !== void 0].filter(Boolean).length <= 1, {
   message: "resume, refresh, restore, and revert are exclusive"
 }).refine((request) => request.revert === void 0 || request.keys.length === 1, { message: "revert takes one key" });
@@ -18104,7 +18450,7 @@ function createGenerateHandlers(opts) {
         }
       }
       const job = {
-        id: (0, import_node_crypto9.randomBytes)(8).toString("hex"),
+        id: (0, import_node_crypto10.randomBytes)(8).toString("hex"),
         project: request.project ?? null,
         keys: request.keys,
         mode: request.refresh ? "refresh" : request.resume ? "resume" : request.restore ? "restore" : request.revert !== void 0 ? "revert" : "generate",
@@ -18171,19 +18517,19 @@ function createGenerateHandlers(opts) {
 }
 
 // src/pipeline/salvage.ts
-var import_promises29 = require("fs/promises");
-var import_node_fs30 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_promises30 = require("fs/promises");
+var import_node_fs32 = require("fs");
+var import_node_path37 = __toESM(require("path"), 1);
 function providerClaimId(provider, objectId) {
   return `${encodeURIComponent(provider)}:${encodeURIComponent(objectId)}`;
 }
 async function loadClaims(lockPaths, opts = {}) {
   const claimed = /* @__PURE__ */ new Set();
   for (const p of lockPaths) {
-    if (!(0, import_node_fs30.existsSync)(p)) throw new Error(`Claim lockfile not found: ${p}`);
+    if (!(0, import_node_fs32.existsSync)(p)) throw new Error(`Claim lockfile not found: ${p}`);
     let parsed;
     try {
-      parsed = parseLock(JSON.parse(await (0, import_promises29.readFile)(p, "utf8")));
+      parsed = parseLock(JSON.parse(await (0, import_promises30.readFile)(p, "utf8")));
     } catch {
       throw new Error(`Claim lockfile is malformed: ${p}`);
     }
@@ -18287,20 +18633,20 @@ function matchOrphanStyle(prompt, manifest) {
   return matchStyleByPattern(prompt, manifest);
 }
 async function loadSiblingManifests(ownManifestPath, workspaceManifestPaths, claimPaths) {
-  const own = import_node_path35.default.resolve(ownManifestPath);
+  const own = import_node_path37.default.resolve(ownManifestPath);
   const siblingManifestPaths = [
     .../* @__PURE__ */ new Set([
       ...workspaceManifestPaths,
-      ...claimPaths.map((c) => import_node_path35.default.join(import_node_path35.default.dirname(import_node_path35.default.resolve(c)), "pixelkiln.manifest.json"))
+      ...claimPaths.map((c) => import_node_path37.default.join(import_node_path37.default.dirname(import_node_path37.default.resolve(c)), "pixelkiln.manifest.json"))
     ])
   ];
   const siblings = [];
   for (const siblingManifestPath of siblingManifestPaths) {
-    if (import_node_path35.default.resolve(siblingManifestPath) === own) continue;
-    if (!(0, import_node_fs30.existsSync)(siblingManifestPath)) continue;
+    if (import_node_path37.default.resolve(siblingManifestPath) === own) continue;
+    if (!(0, import_node_fs32.existsSync)(siblingManifestPath)) continue;
     try {
       const { manifest } = await loadManifest(siblingManifestPath);
-      siblings.push({ label: import_node_path35.default.basename(import_node_path35.default.dirname(siblingManifestPath)), manifest });
+      siblings.push({ label: import_node_path37.default.basename(import_node_path37.default.dirname(siblingManifestPath)), manifest });
     } catch {
     }
   }
@@ -18420,8 +18766,8 @@ async function applyTags(provider, decisions, existing, opts = {}) {
 }
 
 // src/pick/salvage-server.ts
-var import_promises30 = require("fs/promises");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_promises31 = require("fs/promises");
+var import_node_path38 = __toESM(require("path"), 1);
 
 // src/pick/salvage-sheet.ts
 var escapeHtml3 = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
@@ -18587,7 +18933,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
   });
   const html = renderSalvageSheet(orphans, {
     styleId: ctx.styleId,
-    importDir: import_node_path36.default.relative(process.cwd(), ctx.importDir) || "."
+    importDir: import_node_path38.default.relative(process.cwd(), ctx.importDir) || "."
   });
   const byId = new Map(orphans.map((o) => [o.id, o]));
   const existingTags = new Map(orphans.map((o) => [o.id, o.tags]));
@@ -18643,10 +18989,10 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
             if (!buf.subarray(0, 8).equals(PNG_SIGNATURE2)) throw new Error("not a PNG");
             decodePng(buf);
             const assetId = idFromPrompt(orphan.prompt, taken);
-            const rel = import_node_path36.default.join("_salvaged", `${assetId}.png`);
-            const outFile = import_node_path36.default.resolve(ctx.importDir, rel);
-            await (0, import_promises30.mkdir)(import_node_path36.default.dirname(outFile), { recursive: true });
-            await (0, import_promises30.writeFile)(outFile, buf);
+            const rel = import_node_path38.default.join("_salvaged", `${assetId}.png`);
+            const outFile = import_node_path38.default.resolve(ctx.importDir, rel);
+            await (0, import_promises31.mkdir)(import_node_path38.default.dirname(outFile), { recursive: true });
+            await (0, import_promises31.writeFile)(outFile, buf);
             ctx.manifest.assets[assetId] = {
               prompt: orphan.prompt,
               promptByStyle: {},
@@ -18678,7 +19024,7 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
               sourceUrl: durableSource,
               sourceUrls: durableSource ? [{ url: durableSource }] : [],
               outputs: [{
-                path: portableOutputPath(outFile, import_node_path36.default.dirname(ctx.manifestPath)),
+                path: portableOutputPath(outFile, import_node_path38.default.dirname(ctx.manifestPath)),
                 sha256: sha256(buf)
               }],
               submittedAt: orphan.createdAt,
@@ -18702,9 +19048,9 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
         }
       }
       await applyTags(provider, decisions, existingTags, { onProgress: log, characters: characterMembers });
-      const raw = JSON.parse(await (0, import_promises30.readFile)(ctx.manifestPath, "utf8"));
+      const raw = JSON.parse(await (0, import_promises31.readFile)(ctx.manifestPath, "utf8"));
       for (const id of importedAssetIds) raw.assets[id] = ctx.manifest.assets[id];
-      await (0, import_promises30.writeFile)(ctx.manifestPath, JSON.stringify(raw, null, 2) + "\n");
+      await (0, import_promises31.writeFile)(ctx.manifestPath, JSON.stringify(raw, null, 2) + "\n");
       await saveLock(ctx.lockPath, ctx.lock);
       if (characterAssetIds.length) result.characterAssetIds = characterAssetIds;
       return result;