pixelkiln 0.63.0 → 0.65.0

package/dist/cli.js

@@ -705,7 +705,16 @@ function specHash(spec, styleImageHashes, providerOptionIdentity = spec.provider
         styleTraits: spec.character.styleTraits,
         reference: spec.character.reference ? Object.fromEntries(Object.entries(spec.character.reference).map(([direction, image]) => [direction, image.sha256])) : void 0,
         concept: spec.character.concept?.sha256,
-        styleAnchor: spec.character.styleAnchor ? { of: spec.character.styleAnchor.assetId, sha256: spec.character.styleAnchor.sha256 } : void 0
+        styleAnchor: spec.character.styleAnchor ? { of: spec.character.styleAnchor.assetId, sha256: spec.character.styleAnchor.sha256 } : void 0,
+        // The parent's own bytes come from its recorded outputs; the plan
+        // compares those directly (like a mirror), so only the choice of
+        // parent, the reference image's bytes, and any extra guidance
+        // are identity here.
+        outfit: spec.character.outfit ? {
+          of: spec.character.parentAssetId,
+          reference: spec.character.outfit.reference.sha256,
+          additionalInstructions: spec.character.outfit.additionalInstructions
+        } : void 0
       } : void 0,
       // An objectPro family: same shape as character above, minus the
       // fields it has none of (mode/template/proportions/isometric/concept/
@@ -949,6 +958,27 @@ var CharacterStateSchema = z.object({
     height: z.number().int().min(16).max(256)
   }).strict().optional()
 }).strict();
+var CharacterPortraitSizeSchema = z.union([
+  z.literal(16),
+  z.literal(32),
+  z.literal(48),
+  z.literal(64),
+  z.literal(128),
+  z.literal(160)
+]);
+var CharacterPortraitSchema = z.object({
+  /** The base or state to portray, in the same style. */
+  of: z.string().min(1),
+  size: CharacterPortraitSizeSchema.default(64)
+}).strict();
+var CharacterOutfitSchema = z.object({
+  /** The loop (a character animation asset) to re-clothe, in the same style. */
+  of: z.string().min(1),
+  /** Manifest-relative image of the outfit to transfer. */
+  reference: z.string().min(1),
+  /** Extra guidance PixelLab passes through as written, e.g. view/direction hints. */
+  additionalInstructions: z.string().max(2e3).optional()
+}).strict();
 var CharacterAnimationSchema = z.object({
   /** The character to animate: a base or a state in the same style. */
   of: z.string().min(1),
@@ -1570,6 +1600,10 @@ var AssetSchema = z.object({
   pieces: z.array(UiPieceSchema).min(1).optional(),
   /** `uiAsset` styles: named, auto-positioned UI element scaffolds. Combine with `pieces`; omit both for a default full-canvas panel. */
   elements: z.array(UiElementSchema).min(1).optional(),
+  /** `character` styles: this asset is a bust portrait of another character asset's south sprite. */
+  portrait: CharacterPortraitSchema.optional(),
+  /** `character` styles: this asset re-clothes an existing loop's frames with a reference outfit. */
+  outfit: CharacterOutfitSchema.optional(),
   /** `character` styles, `standard` humanoid bases: this character's proportions, over the style's. */
   proportions: CharacterProportionsSchema.optional(),
   /**
@@ -1646,7 +1680,7 @@ var AssetSchema = z.object({
       path: ["revision"]
     });
   }
-  const shapes = [asset.revision && "revision", asset.state && "state", asset.animation && "animation", asset.mirror && "mirror", asset.batch && "batch"].filter(Boolean);
+  const shapes = [asset.revision && "revision", asset.state && "state", asset.animation && "animation", asset.mirror && "mirror", asset.batch && "batch", asset.portrait && "portrait", asset.outfit && "outfit"].filter(Boolean);
   if (shapes.length > 1) {
     context.addIssue({
       code: z.ZodIssueCode.custom,
@@ -1661,24 +1695,24 @@ var AssetSchema = z.object({
       path: ["mirror"]
     });
   }
-  if (asset.prompt === void 0 && !asset.mirror) {
+  if (asset.prompt === void 0 && !asset.mirror && !asset.portrait && !asset.outfit) {
     context.addIssue({
       code: z.ZodIssueCode.custom,
       message: "Required",
       path: ["prompt"]
     });
   }
-  if (asset.reference && (asset.state || asset.animation || asset.mirror)) {
+  if (asset.reference && (asset.state || asset.animation || asset.mirror || asset.portrait || asset.outfit)) {
     context.addIssue({
       code: z.ZodIssueCode.custom,
-      message: "a reference sprite belongs on a base; a state, animation, or mirror takes its look from its parent",
+      message: "a reference sprite belongs on a base; a state, animation, mirror, portrait, or outfit takes its look from its parent",
       path: ["reference"]
     });
   }
-  if (asset.concept && (asset.state || asset.animation || asset.mirror)) {
+  if (asset.concept && (asset.state || asset.animation || asset.mirror || asset.portrait || asset.outfit)) {
     context.addIssue({
       code: z.ZodIssueCode.custom,
-      message: "a concept image belongs on a base; a state, animation, or mirror takes its look from its parent",
+      message: "a concept image belongs on a base; a state, animation, mirror, portrait, or outfit takes its look from its parent",
       path: ["concept"]
     });
   }
@@ -1803,6 +1837,17 @@ var LockEntrySchema = z.object({
     leaderAssetId: z.string().min(1).optional(),
     index: z.number().int().min(1).optional()
   }).strict().nullable().default(null),
+  /**
+   * For an outfit: the loop it re-clothed, a hash over that loop's output
+   * hashes when this was made, and the reference image's own hash. Tracked
+   * the way `mirror` is, not through `specHash`: manifest resolution has no
+   * lock to hash the parent's actual current frame bytes against.
+   */
+  outfit: z.object({
+    sourceAssetId: z.string().min(1),
+    sourceSha256: z.string().regex(/^[0-9a-f]{64}$/),
+    referenceSha256: z.string().regex(/^[0-9a-f]{64}$/)
+  }).strict().nullable().default(null),
   /**
    * Output hashes owned by the previous generation while its replacement is
    * pending. They authorize replacing only unchanged PixelKiln-owned files.
@@ -4080,6 +4125,7 @@ import { existsSync as existsSync4 } from "fs";
 import path8 from "path";
 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());
   if (spec.character?.parentSpec) return inspectCharacterParent(spec, lock, /* @__PURE__ */ new Set());
   if (spec.character?.styleAnchor) return inspectStyleAnchor(spec, lock, /* @__PURE__ */ new Set());
   if (spec.objectPro?.parentSpec) return inspectObjectProParent(spec, lock, /* @__PURE__ */ new Set());
@@ -4106,6 +4152,20 @@ async function inspectMirror(spec, lock, seen) {
   const dependency = await inspectParent(source, lock, seen);
   return dependency.ready ? { ready: true, reason: `${label} is current` } : { ready: false, reason: `${label} is not ready: ${dependency.reason}` };
 }
+async function inspectOutfit(spec, lock, seen) {
+  const character = spec.character;
+  const outfit = character.outfit;
+  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 (!existsSync4(outfit.reference.path)) {
+    return { ready: false, reason: `outfit reference is missing: ${outfit.reference.path}` };
+  }
+  if (await sha256File(outfit.reference.path) !== outfit.reference.sha256) {
+    return { ready: false, reason: "outfit reference changed after the manifest was resolved" };
+  }
+  return { ready: true, reason: `${label} is current` };
+}
 async function inspectCharacterParent(spec, lock, seen) {
   const character = spec.character;
   const parentSpec = character.parentSpec;
@@ -4221,7 +4281,10 @@ async function inspectParent(spec, lock, seen) {
     const inputs = await inspectRevision(spec, lock, nextSeen);
     if (!inputs.ready) return inputs;
   }
-  if (spec.character?.parentSpec) {
+  if (spec.character?.kind === "outfit") {
+    const inputs = await inspectOutfit(spec, lock, nextSeen);
+    if (!inputs.ready) return inputs;
+  } else if (spec.character?.parentSpec) {
     const inputs = await inspectCharacterParent(spec, lock, nextSeen);
     if (!inputs.ready) return inputs;
   }
@@ -4344,6 +4407,9 @@ async function buildPlan(specs, lock, opts = {}) {
     } else if (spec.mirror && entry.status === "downloaded" && entry.outputs.some((_output, index) => !existsSync5(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: [] })) {
+      state = "stale";
+      reason = `outfit source ${spec.character.parentAssetId} changed; re-clothe the loop again`;
     } else if (entry.status === "download-failed") {
       state = "recoverable";
       const force = entry.error?.includes("pass --force") ? " --force" : "";
@@ -5760,6 +5826,28 @@ var AnimateObjectSubmitSchema = z2.object({
   submissions: z2.array(DirectionSubmissionSchema),
   usage: UsageSchema
 }).passthrough();
+var PortraitSubmitSchema = z2.object({
+  background_job_id: z2.string().min(1),
+  status: z2.string().default("processing"),
+  usage: UsageSchema
+}).passthrough();
+var PortraitJobSchema = z2.object({
+  status: z2.string(),
+  download_url: z2.string().nullable().optional(),
+  width: z2.number().int().nullable().optional(),
+  height: z2.number().int().nullable().optional()
+}).passthrough();
+var SetPortraitSchema = z2.object({
+  character_id: z2.string().min(1),
+  size: z2.number().int().positive(),
+  url: z2.string().min(1),
+  usage: UsageSchema
+}).passthrough();
+var TransferOutfitSubmitSchema = z2.object({
+  background_job_id: z2.string().min(1),
+  status: z2.string().default("processing"),
+  usage: UsageSchema
+}).passthrough();
 var CharacterAnimationDirectionSchema = z2.object({
   direction: z2.string(),
   frame_count: z2.number().int().min(0),
@@ -6375,6 +6463,69 @@ var PixelLabClient = class {
     });
     return validateResponse(AnimateSubmitSchema, raw, "animate-character");
   }
+  /**
+   * A full-body sprite in, a bust portrait out (or the reverse, unused
+   * today). Job-based like a state or `1dir`, not the couple-generations
+   * "conversion" the name suggests: the smallest `resultSize` (16px) billed
+   * 20 generations live (docs/ENDPOINTS.md, "Characters, measured").
+   */
+  async createPortraitCharacterPro(args) {
+    const raw = await this.request("/portrait-character-pro", {
+      method: "POST",
+      body: JSON.stringify({
+        direction: args.direction,
+        image: { type: "base64", base64: args.image.base64, format: args.image.format },
+        ...args.view ? { view: args.view } : {},
+        ...args.resultSize != null ? { result_size: args.resultSize } : {},
+        ...args.seed != null ? { seed: args.seed } : {}
+      })
+    });
+    return validateResponse(PortraitSubmitSchema, raw, "portrait-character-pro");
+  }
+  /** Throws PixelLabError(423) while the job is still drawing, like tiles and map objects. */
+  async getPortraitCharacterJob(jobId) {
+    const raw = await this.request(`/portrait-character-pro/${encodeURIComponent(jobId)}`);
+    return validateResponse(PortraitJobSchema, raw, "portrait-character-pro/{id}");
+  }
+  /**
+   * Attaches a portrait image to a character record. Synchronous and free
+   * (0 generations, live); PixelLab does not link this to
+   * `createPortraitCharacterPro` automatically, and `GET /characters/{id}`
+   * never grows a portrait field, so this response's `url` is the only place
+   * it appears.
+   */
+  async setCharacterPortrait(characterId, image) {
+    const raw = await this.request(`/characters/${encodeURIComponent(characterId)}/portrait`, {
+      method: "POST",
+      body: JSON.stringify({ image: { type: "base64", base64: image.base64, format: image.format } })
+    });
+    return validateResponse(SetPortraitSchema, raw, "characters/{id}/portrait");
+  }
+  /**
+   * Applies a reference outfit to 2–16 existing frames. Job-based like
+   * everything else here, but the completed job returns the result frames
+   * inline as base64 (`last_response.quantized_images`), not as storage
+   * URLs — the one PixelLab character tool that works this way. A live
+   * 2-frame, 92x92 job billed 20 generations (docs/ENDPOINTS.md).
+   */
+  async transferOutfitV2(args) {
+    const image = (img) => ({
+      image: { type: "base64", base64: img.base64, format: img.format },
+      size: { width: img.width, height: img.height }
+    });
+    const raw = await this.request("/transfer-outfit-v2", {
+      method: "POST",
+      body: JSON.stringify({
+        reference_image: image(args.referenceImage),
+        frames: args.frames.map(image),
+        image_size: args.imageSize,
+        ...args.seed != null ? { seed: args.seed } : {},
+        ...args.noBackground !== void 0 ? { no_background: args.noBackground } : {},
+        ...args.additionalInstructions ? { additional_instructions: args.additionalInstructions } : {}
+      })
+    });
+    return validateResponse(TransferOutfitSubmitSchema, raw, "transfer-outfit-v2");
+  }
   async getCharacter(characterId) {
     const raw = await this.request(`/characters/${encodeURIComponent(characterId)}`);
     return validateResponse(CharacterSchema, raw, "characters/{id}");
@@ -6794,7 +6945,10 @@ function characterCost(spec) {
     if (animation.mode === "v3") return Math.max(1, Math.ceil(px * animation.frames / 65536));
     return generationCost(spec.width, spec.height, "1dir");
   }
-  if (character.kind === "state") return generationCost(spec.width, spec.height, "1dir");
+  if (character.kind === "state" || character.kind === "portrait") return generationCost(spec.width, spec.height, "1dir");
+  if (character.kind === "outfit") {
+    return 20;
+  }
   if (character.mode === "standard") return 1;
   if (character.mode === "v3") return 1 + Math.max(1, Math.ceil(px * 8 / 65536));
   if (character.mode === "pro-flash") {
@@ -6911,15 +7065,18 @@ var PixelLabProvider = class _PixelLabProvider {
     return { spacingMs: 2500, maxInFlight: 8 };
   }
   /**
-   * Where synchronous pixflux results are parked between `submit` and `fetch`.
+   * Where synchronous pixflux results (or an outfit transfer's inline
+   * frames) are parked between `submit`/poll and `fetch`.
    *
-   * pixflux returns the PNG inline rather than a job id, but the pipeline is
-   * built around submit → poll → fetch running as separate commands. Writing
-   * the bytes to a known path keeps that model intact: the "job id" is the
-   * filename, polling is an existence check, and downloading is a file read.
+   * pixflux returns the PNG inline rather than a job id, and an outfit
+   * transfer's completed job returns its frames inline too, but the
+   * pipeline is built around submit → poll → fetch running as separate
+   * commands. Writing the bytes to a known path keeps that model intact:
+   * the id is the filename, polling is an existence check, and downloading
+   * is a file read.
    */
-  static cacheDir() {
-    const dir = path12.join(os.tmpdir(), "pixelkiln-pixflux");
+  static cacheDir(namespace = "pixflux") {
+    const dir = path12.join(os.tmpdir(), `pixelkiln-${namespace}`);
     mkdirSync(dir, { recursive: true });
     return dir;
   }
@@ -7179,6 +7336,12 @@ var PixelLabProvider = class _PixelLabProvider {
     const character = spec.character;
     if (!character) throw new Error(`${spec.styleId}/${spec.assetId} has no character shape`);
     const label = `${spec.styleId}/${spec.assetId}`;
+    if (character.kind === "outfit") {
+      const reference = character.outfit.reference;
+      if (reference.width < 32 || reference.width > 256 || reference.height < 32 || reference.height > 256) {
+        throw new Error(`${label}: outfit reference is ${reference.width}x${reference.height}; PixelLab transfer-outfit-v2 takes 32 to 256px per side`);
+      }
+    }
     if (character.kind === "base" && character.proportions !== void 0) {
       if (character.mode !== "standard") {
         throw new Error(`${label}: proportions apply to standard bases; the ${character.mode} engine has none to set`);
@@ -7190,7 +7353,7 @@ var PixelLabProvider = class _PixelLabProvider {
     if (character.kind === "base" && character.enhancePrompt !== void 0 && character.mode !== "v3") {
       throw new Error(`${label}: enhancePrompt applies to v3 bases; the ${character.mode} engine does not take it`);
     }
-    if (character.animation) {
+    if (character.animation && character.kind !== "outfit") {
       const { startFrame, endFrame } = character.animation;
       for (const [name, image] of [["start frame", startFrame], ["end frame", endFrame]]) {
         if (image && (image.width > 256 || image.height > 256)) {
@@ -7271,9 +7434,11 @@ var PixelLabProvider = class _PixelLabProvider {
     if (character.styleTraits && character.mode !== "pro-flash") {
       throw new Error(`${label}: styleTraits choose what a pro-flash style image lends; the ${character.mode} engine does not take them`);
     }
-    const maxSize = character.mode === "v3" || character.mode === "pro-flash" ? 256 : 128;
-    if (spec.width < 16 || spec.height < 16 || spec.width > maxSize || spec.height > maxSize) {
-      throw new Error(`PixelLab ${character.mode} characters must be between 16 and ${maxSize} pixels`);
+    if (character.kind !== "portrait") {
+      const maxSize = character.mode === "v3" || character.mode === "pro-flash" ? 256 : 128;
+      if (spec.width < 16 || spec.height < 16 || spec.width > maxSize || spec.height > maxSize) {
+        throw new Error(`PixelLab ${character.mode} characters must be between 16 and ${maxSize} pixels`);
+      }
     }
     if (character.mode === "pro-flash" && character.kind === "base" && (spec.width % 4 || spec.height % 4)) {
       throw new Error(`PixelLab pro-flash characters are sized in multiples of 4 pixels; ${spec.width}x${spec.height} is not`);
@@ -7282,9 +7447,11 @@ var PixelLabProvider = class _PixelLabProvider {
     if (!templates.includes(character.template)) {
       throw new Error(`PixelLab ${character.mode} character template must be one of: ${templates.join(", ")}`);
     }
-    const views = character.mode === "standard" ? ["low top-down", "high top-down", "side", "perspective", "oblique"] : ["low top-down", "high top-down", "side"];
+    const views = character.kind === "portrait" ? ["low top-down", "high top-down", "side"] : character.mode === "standard" ? ["low top-down", "high top-down", "side", "perspective", "oblique"] : ["low top-down", "high top-down", "side"];
     if (!views.includes(spec.view)) {
-      throw new Error(`PixelLab ${character.mode} character view must be one of: ${views.join(", ")}`);
+      throw new Error(
+        character.kind === "portrait" ? `PixelLab portrait view must be one of: ${views.join(", ")}` : `PixelLab ${character.mode} character view must be one of: ${views.join(", ")}`
+      );
     }
     if (spec.view === "oblique" && character.directions !== 4) {
       throw new Error("PixelLab oblique characters are 4-direction only");
@@ -7292,7 +7459,7 @@ var PixelLabProvider = class _PixelLabProvider {
     if (character.kind !== "base" && !character.parentAssetId) {
       throw new Error(`${spec.styleId}/${spec.assetId} is a ${character.kind} with no parent`);
     }
-    if (character.animation) {
+    if (character.animation && character.kind !== "outfit") {
       const allowed = character.directions === 4 ? CHARACTER_DIRECTIONS_4 : CHARACTER_DIRECTIONS_8;
       if (!allowed.includes(character.animation.direction)) {
         throw new Error(
@@ -7398,6 +7565,43 @@ var PixelLabProvider = class _PixelLabProvider {
       });
       return { jobId: res2.character_id, metadata: { character: { kind: "base", characterId: res2.character_id, mode: character.mode, directions: character.directions, backgroundJobId: res2.background_job_id } } };
     }
+    if (character.kind === "outfit") {
+      const parentOutputs = context?.parentOutputs ?? [];
+      if (parentOutputs.length < 2) {
+        throw new Error(
+          `${spec.styleId}/${spec.assetId} is an outfit of ${character.parentAssetId}, which has ${parentOutputs.length} downloaded frame(s); PixelLab transfer-outfit-v2 needs 2 to 16`
+        );
+      }
+      const frames = parentOutputs.slice(0, 16).map((output) => {
+        const bytes = readFileSync2(output.path);
+        const dims = imageMetadata(bytes);
+        if (!dims) throw new Error(`${spec.styleId}/${spec.assetId}: outfit source frame is not a readable PNG: ${output.path}`);
+        return { base64: bytes.toString("base64"), format: "png", width: dims.width, height: dims.height };
+      });
+      const outfit = character.outfit;
+      const referenceBytes = readFileSync2(outfit.reference.path);
+      if (sha256(referenceBytes) !== outfit.reference.sha256) {
+        throw new Error(`${spec.styleId}/${spec.assetId}: outfit reference changed after the manifest was resolved: ${outfit.reference.path}`);
+      }
+      const res2 = await this.client.transferOutfitV2({
+        referenceImage: { base64: referenceBytes.toString("base64"), format: "png", width: outfit.reference.width, height: outfit.reference.height },
+        frames,
+        imageSize: { width: spec.width, height: spec.height },
+        seed: spec.seed,
+        noBackground: spec.noBackground,
+        additionalInstructions: outfit.additionalInstructions
+      });
+      return {
+        jobId: res2.background_job_id,
+        metadata: {
+          character: {
+            kind: "outfit",
+            backgroundJobId: res2.background_job_id,
+            frameRoles: parentOutputs.slice(0, 16).map((output) => output.role ?? null)
+          }
+        }
+      };
+    }
     const parentId = context?.parentObjectId;
     if (!parentId) {
       throw new Error(
@@ -7416,6 +7620,24 @@ var PixelLabProvider = class _PixelLabProvider {
       });
       return { jobId: res2.character_id, metadata: { character: { kind: "state", characterId: res2.character_id, parentCharacterId: parentId, mode: character.mode, directions: character.directions, backgroundJobId: res2.background_job_id } } };
     }
+    if (character.kind === "portrait") {
+      const parentFile = character.parentFile;
+      const bytes = readFileSync2(parentFile);
+      if (character.parentSha256 && sha256(bytes) !== character.parentSha256) {
+        throw new Error(`${spec.styleId}/${spec.assetId}: portrait source changed after the manifest was resolved: ${parentFile}`);
+      }
+      const res2 = await this.client.createPortraitCharacterPro({
+        direction: "character_to_portrait",
+        image: { base64: bytes.toString("base64"), format: "png" },
+        view: spec.view,
+        resultSize: character.portrait.size,
+        seed: spec.seed
+      });
+      return {
+        jobId: res2.background_job_id,
+        metadata: { character: { kind: "portrait", parentCharacterId: parentId, backgroundJobId: res2.background_job_id } }
+      };
+    }
     const animation = character.animation;
     const name = characterAnimationName(spec);
     const replaced = context?.replacedMetadata?.character ?? {};
@@ -7529,6 +7751,9 @@ var PixelLabProvider = class _PixelLabProvider {
   async pollCharacter(jobId, context) {
     const animation = decodeAnimationJob(jobId);
     if (animation) return this.pollCharacterAnimation(animation, context);
+    const kind = context?.metadata?.character?.kind ?? context?.spec?.character?.kind;
+    if (kind === "portrait") return this.pollCharacterPortrait(jobId, context);
+    if (kind === "outfit") return this.pollCharacterOutfit(jobId, context);
     const character = await this.client.getCharacter(jobId);
     if (character.status === "failed") return { status: "failed", error: "character generation failed upstream" };
     if (character.status !== "completed" || !character.rotation_urls) return { status: "processing" };
@@ -7554,6 +7779,66 @@ var PixelLabProvider = class _PixelLabProvider {
       billed: await this.billedForJob(backgroundJobId)
     };
   }
+  /**
+   * `jobId` here is `portrait-character-pro`'s own background job id, not a
+   * character id: the endpoint converts an arbitrary image and never touches
+   * the character record. Once the portrait itself is drawn, this also
+   * attaches it to the parent's character record with `SetPortrait` — a
+   * separate, free call PixelLab does not make automatically (docs/PIXELLAB.md).
+   */
+  async pollCharacterPortrait(jobId, context) {
+    const meta = context?.metadata?.character;
+    try {
+      const job = await this.client.getPortraitCharacterJob(jobId);
+      if (job.status === "failed") return { status: "failed", error: "portrait generation failed upstream" };
+      if (job.status !== "completed" || !job.download_url) return { status: "processing" };
+      if (meta?.parentCharacterId) {
+        const bytes = await this.client.download(job.download_url);
+        await this.client.setCharacterPortrait(meta.parentCharacterId, { base64: bytes.toString("base64"), format: "png" });
+      }
+      return {
+        status: "ready",
+        objectId: jobId,
+        sourceUrl: job.download_url,
+        sources: [{ url: job.download_url }],
+        billed: await this.billedForJob(meta?.backgroundJobId)
+      };
+    } catch (err) {
+      if (err instanceof PixelLabError && err.status === 423) return { status: "processing" };
+      throw err;
+    }
+  }
+  /**
+   * No dedicated status endpoint exists for `transfer-outfit-v2`, unlike
+   * portraits and tiles: the background job is the only place to poll. A
+   * completed job returns its frames inline as base64
+   * (`last_response.quantized_images`), not as storage URLs, so they are
+   * cached locally the way a synchronous pixflux result is, and matched back
+   * to the source frames' own roles recorded at submit time.
+   */
+  async pollCharacterOutfit(jobId, context) {
+    const meta = context?.metadata?.character;
+    const job = await this.client.getBackgroundJob(jobId);
+    if (job.status === "failed") return { status: "failed", error: "outfit transfer failed upstream" };
+    if (job.status !== "completed") return { status: "processing" };
+    const images = job.last_response?.quantized_images;
+    if (!images?.length) return { status: "failed", error: "outfit transfer completed with no result frames" };
+    const dir = _PixelLabProvider.cacheDir("outfit");
+    const sources = images.map((image, index) => {
+      if (!image.base64) throw new Error(`outfit transfer frame ${index} has no image data`);
+      const role = meta?.frameRoles?.[index] ?? void 0;
+      const file = path12.join(dir, `${jobId}-${index}.png`);
+      writeFileSync(file, Buffer.from(image.base64, "base64"));
+      return { url: `file://${file}`, ...role ? { role } : {} };
+    });
+    return {
+      status: "ready",
+      objectId: jobId,
+      sourceUrl: sources[0].url,
+      sources,
+      billed: await this.billedForJob(meta?.backgroundJobId)
+    };
+  }
   /**
    * The background job is the authoritative record of one direction: it
    * completes with the frame URLs, the animation id, and the direction, and
@@ -8373,8 +8658,8 @@ var PixelLabProvider = class _PixelLabProvider {
       const sources = [];
       const terrainTiles = [];
       for (const [index, tile] of tileset.tiles.entries()) {
-        const slug = tile.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "tile";
-        const role = `tile-${String(index).padStart(2, "0")}-${slug}`;
+        const slug2 = tile.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "tile";
+        const role = `tile-${String(index).padStart(2, "0")}-${slug2}`;
         const file = path12.join(_PixelLabProvider.cacheDir(), `${tilesetId}-${index}.png`);
         writeFileSync(file, Buffer.from(tile.image.base64, "base64"));
         sources.push({ url: `file://${file}`, role });
@@ -8493,6 +8778,9 @@ var PixelLabProvider = class _PixelLabProvider {
   async delete(assetId) {
     await this.client.deleteObject(assetId);
   }
+  async deleteCharacter(id) {
+    await this.client.deleteCharacter(id);
+  }
   async *listCharacters() {
     for await (const character of this.client.iterateCharacters(100)) {
       yield remoteCharacter(character);
@@ -9748,7 +10036,7 @@ ${unknownReferences.map((i) => `  ${i}`).join("\n")}`);
   return { manifest: parsed.data, root: path13.dirname(abs), path: abs, ...loopFamilies };
 }
 function parentAssetId(asset) {
-  return asset?.revision?.from ?? asset?.state?.of ?? asset?.animation?.of;
+  return asset?.revision?.from ?? asset?.state?.of ?? asset?.animation?.of ?? asset?.portrait?.of ?? asset?.outfit?.of;
 }
 function formatManifestIssues(issues) {
   return issues.flatMap((issue) => {
@@ -9915,9 +10203,9 @@ async function resolveSpecs(loaded, filter) {
         height = styleImageDimensions.length ? Math.max(...styleImageDimensions.map((img) => img.height)) : style.tileSize ?? 32;
         size = Math.max(width, height);
       } else if (generator === "character") {
-        size = asset.state?.canvas ? Math.max(asset.state.canvas.width, asset.state.canvas.height) : asset.size ?? style.size ?? 64;
-        width = asset.state?.canvas?.width ?? size;
-        height = asset.state?.canvas?.height ?? size;
+        size = asset.portrait ? asset.portrait.size : asset.state?.canvas ? Math.max(asset.state.canvas.width, asset.state.canvas.height) : asset.size ?? style.size ?? 64;
+        width = asset.portrait?.size ?? asset.state?.canvas?.width ?? size;
+        height = asset.portrait?.size ?? asset.state?.canvas?.height ?? size;
       } else if (generator === "terrain") {
         size = style.terrainTileSize ?? 16;
         width = size;
@@ -9944,12 +10232,17 @@ async function resolveSpecs(loaded, filter) {
           `assets.${assetId}: ${asset.state ? "state" : "animation"} needs a character or objectPro style; "${styleId}" generates ${generator}`
         );
       }
+      if ((asset.portrait || asset.outfit) && generator !== "character") {
+        throw new Error(
+          `assets.${assetId}: ${asset.portrait ? "portrait" : "outfit"} needs a character style; "${styleId}" generates ${generator}`
+        );
+      }
       if ((asset.pieces || asset.elements) && generator !== "uiAsset") {
         throw new Error(
           `assets.${assetId}: ${asset.pieces ? "pieces" : "elements"} needs a uiAsset style; "${styleId}" generates ${generator}`
         );
       }
-      const characterKind = asset.animation ? "animation" : asset.state ? "state" : "base";
+      const characterKind = asset.animation ? "animation" : asset.state ? "state" : asset.portrait ? "portrait" : "base";
       const subject = asset.promptByStyle[styleId] ?? asset.prompt ?? "";
       let terrainLowerDescription;
       let terrainUpperDescription;
@@ -10041,7 +10334,9 @@ async function resolveSpecs(loaded, filter) {
         // its parent's pixels, not a new character: giving it a base shape
         // would have packing, the gallery, and adoption treat it as one.
         ...generator === "character" && !asset.revision ? { character: await resolveCharacterShape(asset, style, characterKind, { root, load: loadStyleImage }) } : {},
-        ...generator === "objectPro" && !asset.revision ? { objectPro: await resolveObjectProShape(assetId, asset, style, characterKind, { root, load: loadStyleImage }) } : {},
+        // A portrait needs a character style (refused above), so an
+        // objectPro asset is only ever a base, state, or animation.
+        ...generator === "objectPro" && !asset.revision && characterKind !== "portrait" ? { objectPro: await resolveObjectProShape(assetId, asset, style, characterKind, { root, load: loadStyleImage }) } : {},
         cost: generator === "tiles" ? tilesCost(tileSize, tileVariations) : generator === "terrain" ? tilesCost(size, terrainTiles) : generator === "isometricTile" ? isometricTileCost() : generationCost(width, height, generator),
         costUnit: "generations",
         candidates: generator === "tiles" ? tileVariations : generator === "terrain" ? terrainTiles : generator === "1dir" || generator === "imagePro" ? candidateCount(size) : 1
@@ -10152,7 +10447,7 @@ async function resolveSpecs(loaded, filter) {
           styleAnchor: { assetId: anchorId, spec: anchorSpec, file, sha256: existsSync8(file) ? await sha256File(file) : null }
         };
       }
-      const characterParent = asset.state?.of ?? asset.animation?.of;
+      const characterParent = asset.state?.of ?? asset.animation?.of ?? asset.portrait?.of;
       if (resolved.character && characterParent) {
         const parentSpec = await finalize(characterParent);
         const parentDirections = parentSpec.character?.directions ?? 8;
@@ -10185,6 +10480,38 @@ async function resolveSpecs(loaded, filter) {
           directions: resolved.objectPro.kind === "base" ? resolved.objectPro.directions : parentSpec.objectPro.directions
         };
       }
+      if (asset.outfit) {
+        if (asset.outfit.of === assetId) throw new Error(`assets.${assetId}: an asset cannot re-clothe itself`);
+        const sourceSpec = await finalize(asset.outfit.of);
+        if (sourceSpec.character?.kind !== "animation") {
+          throw new Error(`assets.${assetId}: outfit "${asset.outfit.of}" is not a character loop`);
+        }
+        const referenceImage = await loadStyleImage(asset.outfit.reference, "Outfit reference image");
+        resolved.character = {
+          kind: "outfit",
+          mode: sourceSpec.character.mode,
+          directions: sourceSpec.character.directions,
+          template: sourceSpec.character.template,
+          parentAssetId: asset.outfit.of,
+          parentSpec: sourceSpec,
+          animation: sourceSpec.character.animation,
+          outfit: {
+            reference: {
+              path: path13.resolve(root, asset.outfit.reference),
+              sha256: referenceImage.hash,
+              width: referenceImage.width,
+              height: referenceImage.height,
+              format: referenceImage.format
+            },
+            ...asset.outfit.additionalInstructions ? { additionalInstructions: asset.outfit.additionalInstructions } : {}
+          }
+        };
+        resolved.generator = sourceSpec.generator;
+        resolved.width = sourceSpec.width;
+        resolved.height = sourceSpec.height;
+        resolved.size = sourceSpec.size;
+        resolved.prompt = "";
+      }
       if (asset.revision) {
         if (!activeProvider.supportsRevision?.(asset.revision.mode)) {
           throw new Error(
@@ -10455,6 +10782,9 @@ async function resolveCharacterShape(asset, style, kind, files) {
       ...asset.state.canvas ? { canvas: asset.state.canvas } : {}
     };
   }
+  if (asset.portrait) {
+    shape.portrait = { size: asset.portrait.size };
+  }
   if (asset.animation) {
     const animationMode = asset.animation.mode ?? (asset.animation.template ? "template" : "v3");
     const pose = async (rel, what) => {
@@ -11406,6 +11736,9 @@ async function loadClaims(lockPaths, opts = {}) {
       add(entry.objectId);
       add(entry.reviewObjectId);
       add(entry.jobId);
+      for (const id of [entry.objectId, entry.jobId]) {
+        if (id?.includes("#")) add(id.split("#")[0]);
+      }
     }
   }
   return claimed;
@@ -11429,6 +11762,122 @@ async function findOrphans(provider, claimed, opts = {}) {
   })).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
   return { orphans, total: all.length };
 }
+async function findOrphanCharacters(provider, claimed, opts = {}) {
+  const log2 = opts.onProgress ?? (() => {
+  });
+  if (!provider.listCharacters) return { orphans: [], total: 0, partlyClaimed: 0 };
+  const all = [];
+  for await (const character of provider.listCharacters()) all.push(character);
+  log2(`  scanned ${all.length} character(s) on the account`);
+  const isClaimed = (id) => claimed.has(id) || claimed.has(providerClaimId(provider.id, id));
+  const groups = /* @__PURE__ */ new Map();
+  for (const character of all) {
+    const key = character.groupId ?? character.id;
+    groups.set(key, [...groups.get(key) ?? [], character]);
+  }
+  let partlyClaimed = 0;
+  const orphans = [];
+  for (const members of groups.values()) {
+    const unclaimed = members.filter((character) => !isClaimed(character.id));
+    if (!unclaimed.length) continue;
+    if (unclaimed.length < members.length) {
+      partlyClaimed++;
+      continue;
+    }
+    const ordered = [...members].sort((a, b) => Number(isState(a)) - Number(isState(b)) || a.createdAt.localeCompare(b.createdAt));
+    const base = ordered[0];
+    if (base.status !== "completed" || !base.previewUrl) continue;
+    const states = ordered.length - 1;
+    const loops = ordered.reduce((sum, character) => sum + character.animationCount, 0);
+    orphans.push({
+      id: base.id,
+      prompt: base.prompt || base.name || "(no prompt recorded)",
+      width: base.width,
+      height: base.height,
+      createdAt: base.createdAt,
+      previewUrl: base.previewUrl,
+      tags: base.tags ?? [],
+      kind: "character",
+      note: `character \xB7 ${base.directions} directions \xB7 ${states} state${states === 1 ? "" : "s"} \xB7 ${loops} loop${loops === 1 ? "" : "s"}`,
+      members: ordered.map((character) => ({ id: character.id, tags: character.tags ?? [] }))
+    });
+  }
+  orphans.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  return { orphans, total: all.length, partlyClaimed };
+}
+function isState(character) {
+  return Boolean(character.stateName && character.stateName !== "Idle");
+}
+function characterStyleIds(manifest) {
+  return Object.keys(manifest.styles).filter((id) => manifest.styles[id].generator === "character");
+}
+function withoutCharacterStyles(manifest) {
+  const characters = new Set(characterStyleIds(manifest));
+  return {
+    ...manifest,
+    styles: Object.fromEntries(Object.entries(manifest.styles).filter(([id]) => !characters.has(id)))
+  };
+}
+function routeCharacterOrphans(orphans, manifest) {
+  const styleIds = characterStyleIds(manifest);
+  const matched = /* @__PURE__ */ new Map();
+  const unmatched = [];
+  const only = { ...manifest, styles: Object.fromEntries(styleIds.map((id) => [id, manifest.styles[id]])) };
+  for (const orphan of orphans) {
+    const styleId = styleIds.length === 1 ? styleIds[0] : styleIds.length ? matchStyleByPattern(orphan.prompt, only) : null;
+    if (!styleId) {
+      unmatched.push(orphan);
+      continue;
+    }
+    matched.set(styleId, [...matched.get(styleId) ?? [], orphan]);
+  }
+  return { matched, unmatched };
+}
+function characterSalvageAssets(characters, ctx) {
+  const ordered = [...characters].sort((a, b) => Number(isState(a)) - Number(isState(b)) || a.createdAt.localeCompare(b.createdAt));
+  const base = ordered[0];
+  const common = { styles: [ctx.styleId], tags: ["salvaged"] };
+  const assets = {};
+  const skipped = [];
+  const baseId = idFromPrompt(base.name || base.prompt, ctx.taken);
+  const size = base.width === base.height && base.width >= 32 && base.width <= 256 && base.width !== ctx.styleSize ? { size: base.width } : {};
+  assets[baseId] = { prompt: base.prompt || base.name || baseId, remoteId: base.id, ...size, ...common };
+  const assetIdOf = /* @__PURE__ */ new Map([[base.id, baseId]]);
+  for (const state of ordered.slice(1)) {
+    const stateId = uniqueId(`${baseId}_${slug(state.stateName ?? "state")}`, ctx.taken);
+    assetIdOf.set(state.id, stateId);
+    assets[stateId] = { prompt: state.prompt || state.stateName || stateId, state: { of: baseId }, remoteId: state.id, ...common };
+  }
+  for (const character of ordered) {
+    const parentId = assetIdOf.get(character.id);
+    for (const animation of character.animations) {
+      if (!animation.frames.length) continue;
+      const label = animation.name || animation.type;
+      if (!animation.groupId) {
+        skipped.push(`${parentId}: "${label}" ${animation.direction} loop has no animation group id to adopt it by`);
+        continue;
+      }
+      const loopId = uniqueId(`${parentId}.${slug(label)}.${animation.direction}`, ctx.taken);
+      assets[loopId] = {
+        prompt: label,
+        animation: { of: parentId, direction: animation.direction },
+        remoteId: `${character.id}#${animation.groupId}`,
+        ...common
+      };
+    }
+  }
+  return { assets, skipped };
+}
+function slug(text) {
+  return text.toLowerCase().replace(/^pixelkiln:.*\//, "").replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "loop";
+}
+function uniqueId(base, taken) {
+  let id = base;
+  let n = 2;
+  while (taken.has(id)) id = `${base}_${n++}`;
+  taken.add(id);
+  return id;
+}
 var MIN_STYLE_FRAGMENT_LENGTH = 12;
 function matchStyleByPattern(prompt, manifest) {
   const p = prompt.toLowerCase();
@@ -11553,18 +12002,22 @@ async function applyTags(provider, decisions, existing, opts = {}) {
   let tagged = 0;
   let failed = 0;
   for (const { id, action } of decisions) {
-    const current = (existing.get(id) ?? []).filter(
-      (t) => t !== "pixelkiln:keep" && t !== "pixelkiln:discard" && t !== "pixelkiln:imported"
-    );
-    const decisionTag = `pixelkiln:${action === "import" ? "imported" : action}`;
-    const next = [...current.slice(0, 19), decisionTag];
-    if (!provider.setTags) return { tagged, failed };
-    try {
-      await provider.setTags(id, next);
-      tagged++;
-    } catch (err) {
-      failed++;
-      log2(`  tag failed ${id}: ${err instanceof Error ? err.message : String(err)}`);
+    const group = opts.characters?.get(id);
+    const targets = group ?? [{ id, tags: existing.get(id) ?? [] }];
+    for (const target of targets) {
+      const current = target.tags.filter(
+        (t) => t !== "pixelkiln:keep" && t !== "pixelkiln:discard" && t !== "pixelkiln:imported"
+      );
+      const decisionTag = `pixelkiln:${action === "import" ? "imported" : action}`;
+      const next = [...current.slice(0, 19), decisionTag];
+      if (!provider.setTags) return { tagged, failed };
+      try {
+        await provider.setTags(target.id, next, group ? "character" : void 0);
+        tagged++;
+      } catch (err) {
+        failed++;
+        log2(`  tag failed ${target.id}: ${err instanceof Error ? err.message : String(err)}`);
+      }
     }
   }
   return { tagged, failed };
@@ -11710,7 +12163,7 @@ import path19 from "path";
 // src/pick/salvage-sheet.ts
 var escapeHtml = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
 function renderSalvageSheet(orphans, ctx) {
-  const safe = orphans.map((o) => ({ ...o, prompt: escapeHtml(o.prompt) }));
+  const safe = orphans.map((o) => ({ ...o, prompt: escapeHtml(o.prompt), ...o.note ? { note: escapeHtml(o.note) } : {} }));
   const data = JSON.stringify(safe).replace(/<\//g, "<\\/");
   const styleId = ctx ? escapeHtml(ctx.styleId) : null;
   const importDir = ctx ? escapeHtml(ctx.importDir) : null;
@@ -11796,6 +12249,7 @@ ITEMS.forEach((o, i) => {
   el.innerHTML =
     '<div class="thumb"><img src="' + o.previewUrl + '" loading="lazy"></div>' +
     '<div class="meta">' + o.width + '\xD7' + o.height + ' \xB7 ' + o.createdAt.slice(0,10) + '</div>' +
+    (o.note ? '<div class="meta">' + o.note + '</div>' : '') +
     '<div class="prompt">' + o.prompt + '</div>' +
     '<div class="acts">' +
       '<button data-a="import">import</button>' +
@@ -11973,6 +12427,9 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
   });
   const byId = new Map(orphans.map((o) => [o.id, o]));
   const existingTags = new Map(orphans.map((o) => [o.id, o.tags]));
+  const characterMembers = new Map(
+    orphans.flatMap((o) => o.kind === "character" && o.members ? [[o.id, o.members]] : [])
+  );
   return serveReviewPage({
     html,
     port: opts.port,
@@ -11989,10 +12446,34 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
       const result = { imported: 0, kept: 0, discarded: 0, failed: 0 };
       const taken = new Set(Object.keys(ctx.manifest.assets));
       const importedAssetIds = [];
+      const characterAssetIds = [];
       for (const decision of decisions) {
         const orphan = byId.get(decision.id);
         if (!orphan) continue;
-        if (decision.action === "import") {
+        if (decision.action === "import" && orphan.kind === "character") {
+          try {
+            if (!provider.getCharacter) throw new Error(`provider ${provider.id} cannot read characters`);
+            const details = [];
+            for (const member of orphan.members ?? [{ id: orphan.id }]) details.push(await provider.getCharacter(member.id));
+            const style = ctx.manifest.styles[ctx.styleId];
+            const { assets, skipped } = characterSalvageAssets(details, {
+              styleId: ctx.styleId,
+              styleSize: style?.size,
+              taken
+            });
+            for (const [assetId, asset] of Object.entries(assets)) {
+              ctx.manifest.assets[assetId] = asset;
+              importedAssetIds.push(assetId);
+              characterAssetIds.push(assetId);
+            }
+            for (const line of skipped) log2(`  not imported: ${line}`);
+            result.imported++;
+            log2(`  imported character ${orphan.id} as ${Object.keys(assets).length} asset(s)`);
+          } catch (err) {
+            result.failed++;
+            log2(`  import failed ${orphan.id}: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        } else if (decision.action === "import") {
           try {
             const buf = await provider.download(orphan.previewUrl);
             if (!buf.subarray(0, 8).equals(PNG_SIGNATURE2)) throw new Error("not a PNG");
@@ -12056,11 +12537,12 @@ async function runSalvage(provider, orphans, ctx, opts = {}) {
           result.discarded++;
         }
       }
-      await applyTags(provider, decisions, existingTags, { onProgress: log2 });
+      await applyTags(provider, decisions, existingTags, { onProgress: log2, characters: characterMembers });
       const raw = JSON.parse(await readFile14(ctx.manifestPath, "utf8"));
       for (const id of importedAssetIds) raw.assets[id] = ctx.manifest.assets[id];
       await writeFile9(ctx.manifestPath, JSON.stringify(raw, null, 2) + "\n");
       await saveLock(ctx.lockPath, ctx.lock);
+      if (characterAssetIds.length) result.characterAssetIds = characterAssetIds;
       return result;
     }
   });
@@ -12502,7 +12984,18 @@ async function runSalvage2(args) {
   const claimed = await loadClaims(lockPaths, { provider: provider.id });
   const { orphans, total } = await findOrphans(provider, claimed, { onProgress: diag });
   diag(`  ${claimed.size} claimed \xB7 ${orphans.length} unclaimed of ${total}`);
-  if (!orphans.length) {
+  const characterScan = await findOrphanCharacters(provider, claimed, { onProgress: diag });
+  const characterOrphans = characterScan.orphans;
+  if (characterScan.total) {
+    diag(`  ${characterOrphans.length} unclaimed character group(s) of ${characterScan.total} character(s)`);
+  }
+  if (characterScan.partlyClaimed) {
+    diag(
+      `  ${characterScan.partlyClaimed} character group(s) are partly claimed (a base or state some project uses);
+  they are left out here. Declare their other states and run \`pixelkiln adopt\` instead.`
+    );
+  }
+  if (!orphans.length && !characterOrphans.length) {
     if (jsonMode) log("[]");
     else log(`
   nothing to triage`);
@@ -12513,9 +13006,10 @@ async function runSalvage2(args) {
     workspaceProjects.map((p) => resolveProject(workspaceDir, p).manifestPath),
     args.claims
   );
-  const { matched, unmatched, elsewhere } = groupOrphansByStyle(orphans, accountManifest, siblings);
-  const multiStyle = Object.keys(accountManifest.styles).length > 1;
-  if (multiStyle) {
+  const objectManifest = withoutCharacterStyles(accountManifest);
+  const { matched, unmatched, elsewhere } = groupOrphansByStyle(orphans, objectManifest, siblings);
+  const multiStyle = Object.keys(objectManifest.styles).length > 1;
+  if (multiStyle && orphans.length) {
     diag(`
   by style (matched against each style's prompt prefix/suffix):`);
     for (const [id, list] of matched) diag(`    ${id.padEnd(24)} ${list.length}`);
@@ -12536,16 +13030,33 @@ async function runSalvage2(args) {
   out of the sessions below; force them into one style with --style <id>.`
     );
   }
+  const characterRoutes = routeCharacterOrphans(characterOrphans, accountManifest);
+  if (characterOrphans.length && !characterStyleIds(accountManifest).length) {
+    diag(
+      `
+  ${characterOrphans.length} unclaimed character group(s), but this manifest has no character style
+  to import them into. Add a style with "generator": "character" to triage them.`
+    );
+  } else if (characterRoutes.unmatched.length) {
+    diag(
+      `
+  ${characterRoutes.unmatched.length} character group(s) don't match any character style's pattern;
+  force them into one with --style <character style id>.`
+    );
+  }
   if (args.dryRun) {
+    const listed = [...orphans, ...characterOrphans];
     if (args.json) {
-      log(JSON.stringify(orphans, null, 2));
+      log(JSON.stringify(listed, null, 2));
     } else {
-      const shown = args.all ? orphans : orphans.slice(0, 30);
+      const shown = args.all ? listed : listed.slice(0, 30);
       for (const o of shown) {
-        log(`    ${o.id}  ${o.width}x${o.height}  ${o.createdAt.slice(0, 10)}  ${o.prompt.slice(0, 50)}`);
+        log(
+          `    ${o.id}  ${o.width}x${o.height}  ${o.createdAt.slice(0, 10)}  ` + (o.kind === "character" ? `[${o.note}]  ` : "") + o.prompt.slice(0, 50)
+        );
       }
-      if (!args.all && orphans.length > 30) {
-        log(`    \u2026 and ${orphans.length - 30} more (--all for the full list, --json for machine-readable)`);
+      if (!args.all && listed.length > 30) {
+        log(`    \u2026 and ${listed.length - 30} more (--all for the full list, --json for machine-readable)`);
       }
     }
     diag(`
@@ -12566,6 +13077,12 @@ async function runSalvage2(args) {
     await saveLock(args.lock, lock);
     if (n) log(`  baselined ${n} imported asset(s) against the manifest`);
   };
+  const adoptImported = async (assetIds) => {
+    const resolve = async () => (await resolveSpecs(await loadManifest(args.manifest), { assets: assetIds })).filter((spec) => spec.provider === provider.id);
+    const adopted = await adoptCharacters(provider, await resolve(), lock, args.lock, { onProgress: log, resolve });
+    log(`  adopted ${adopted.matched} of ${assetIds.length} imported character asset(s)`);
+    for (const line of adopted.unmatched) log(`    not adopted: ${line}`);
+  };
   const runOne = async (styleId, list) => {
     const style = accountManifest.styles[styleId];
     const res = await runSalvage(
@@ -12585,10 +13102,19 @@ async function runSalvage2(args) {
       `  imported ${res.imported} \xB7 kept ${res.kept} \xB7 tagged-discard ${res.discarded}` + (res.failed ? ` \xB7 failed ${res.failed}` : "")
     );
     if (res.imported > 0) await rebaseline();
+    if (res.characterAssetIds?.length) await adoptImported(res.characterAssetIds);
     return res;
   };
   if (args.styles.length) {
-    const res = await runOne(args.styles[0], orphans);
+    const styleId = args.styles[0];
+    const isCharacterStyle = characterStyleIds(accountManifest).includes(styleId);
+    const list = isCharacterStyle ? characterOrphans : orphans;
+    if (!list.length) {
+      log(`
+  nothing unclaimed to triage into ${styleId}`);
+      return;
+    }
+    const res = await runOne(styleId, list);
     if (res.discarded) {
       log(`
   Nothing was deleted. To actually remove the discarded objects:`);
@@ -12597,17 +13123,18 @@ async function runSalvage2(args) {
     }
     return;
   }
-  if (!matched.size) {
+  const sessions = [...matched, ...characterRoutes.matched];
+  if (!sessions.length) {
     log(`
   nothing matched a known style; nothing to triage`);
     return;
   }
   log(`
-  ${matched.size} session(s), one style at a time:`);
+  ${sessions.length} session(s), one style at a time:`);
   let totalDiscarded = 0;
-  for (const [styleId, list] of matched) {
+  for (const [styleId, list] of sessions) {
     log(`
-  ${styleId} (${list.length})`);
+  ${styleId} (${list.length}${list[0]?.kind === "character" ? " character group(s)" : ""})`);
     const res = await runOne(styleId, list);
     totalDiscarded += res.discarded;
   }
@@ -12625,16 +13152,30 @@ async function runPurge(args) {
   const doomed = [];
   for await (const obj of requireList(provider)()) {
     if (obj.tags.includes("pixelkiln:discard")) {
-      doomed.push({ id: obj.id, prompt: obj.prompt });
+      doomed.push({ id: obj.id, prompt: obj.prompt, kind: "object" });
+    }
+  }
+  if (provider.listCharacters && provider.deleteCharacter) {
+    for await (const character of provider.listCharacters()) {
+      if (character.tags.includes("pixelkiln:discard")) {
+        const label = character.stateName && character.stateName !== "Idle" ? ` (${character.stateName})` : "";
+        doomed.push({ id: character.id, prompt: `${character.prompt || character.name}${label}`, kind: "character" });
+      }
     }
   }
   if (!doomed.length) {
     log(`  nothing tagged pixelkiln:discard; run \`pixelkiln salvage\` first`);
     return;
   }
+  const characters = doomed.filter((d) => d.kind === "character").length;
+  const objects = doomed.length - characters;
+  const counted = [
+    objects ? `${objects} object(s)` : "",
+    characters ? `${characters} character(s)` : ""
+  ].filter(Boolean).join(" and ");
   log(`
-  ${doomed.length} object(s) tagged for discard:`);
-  for (const d of doomed.slice(0, 20)) log(`    ${d.id}  ${d.prompt.slice(0, 60)}`);
+  ${counted} tagged for discard:`);
+  for (const d of doomed.slice(0, 20)) log(`    ${d.id}  ${d.kind === "character" ? "[character] " : ""}${d.prompt.slice(0, 60)}`);
   if (doomed.length > 20) log(`    \u2026 and ${doomed.length - 20} more`);
   if (args.dryRun) {
     log(`
@@ -12645,7 +13186,8 @@ async function runPurge(args) {
   This permanently deletes them from your ${provider.id} account.`);
   log(`  Any local files already downloaded are untouched, but the objects`);
   log(`  and their URLs are gone and cannot be re-downloaded.`);
-  if (!await confirm(`  Delete ${doomed.length} object(s)?`, args.yes)) {
+  if (characters) log(`  A deleted character takes its animations with it.`);
+  if (!await confirm(`  Delete ${counted}?`, args.yes)) {
     log(`  aborted`);
     return;
   }
@@ -12653,7 +13195,8 @@ async function runPurge(args) {
   let failed = 0;
   for (const d of doomed) {
     try {
-      await requireDelete(provider)(d.id);
+      if (d.kind === "character") await provider.deleteCharacter(d.id);
+      else await requireDelete(provider)(d.id);
       deleted++;
     } catch (err) {
       failed++;
@@ -13608,7 +14151,7 @@ function describeCharacter(spec, entry) {
     };
   }
   if (entry?.generator === "character") {
-    const kind = recordedCharacter?.kind === "animation" || entry.outputs.some((o) => o.role?.startsWith("frame-")) ? "animation" : "base";
+    const kind = recordedCharacter?.kind === "portrait" ? "portrait" : recordedCharacter?.kind === "outfit" ? "outfit" : recordedCharacter?.kind === "animation" || entry.outputs.some((o) => o.role?.startsWith("frame-")) ? "animation" : "base";
     return {
       generator: "character",
       kind,
@@ -13969,7 +14512,9 @@ async function buildGallerySnapshot(opts) {
       characters: style?.generator === "character" || style?.generator === "objectPro" ? {
         bases: styleItems.filter((item) => item.character?.kind === "base").length,
         states: styleItems.filter((item) => item.character?.kind === "state").length,
-        animations: styleItems.filter((item) => item.character?.kind === "animation").length
+        animations: styleItems.filter((item) => item.character?.kind === "animation").length,
+        portraits: styleItems.filter((item) => item.character?.kind === "portrait").length,
+        outfits: styleItems.filter((item) => item.character?.kind === "outfit").length
       } : null,
       tags: style?.tags ?? [],
       extends: typeof rawStyle?.extends === "string" ? rawStyle.extends : null,
@@ -14746,6 +15291,7 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
     const supersededOutputs = previousEntry?.outputs.length ? previousEntry.outputs : previousEntry?.supersededOutputs ?? [];
     const submittedAt = resumesCheckpoint ? previousEntry.submittedAt : (/* @__PURE__ */ new Date()).toISOString();
     const history = historyAfterReplacing(previousEntry, historyLimit(loaded.manifest), submittedAt ?? (/* @__PURE__ */ new Date()).toISOString());
+    const outfitParentEntry = spec.character?.kind === "outfit" && spec.character.parentSpec ? lock.entries[lockKey(spec.character.parentSpec.styleId, spec.character.parentSpec.assetId)] : void 0;
     upsert(lock, key, {
       styleId: spec.styleId,
       assetId: spec.assetId,
@@ -14771,6 +15317,11 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
         ...spec.revision.direction ? { direction: spec.revision.direction } : {},
         ...spec.revision.enhancePrompt == null ? {} : { enhancePrompt: spec.revision.enhancePrompt }
       } : null,
+      outfit: spec.character?.kind === "outfit" && outfitParentEntry ? {
+        sourceAssetId: spec.character.parentAssetId,
+        sourceSha256: mirrorSourceHash(outfitParentEntry),
+        referenceSha256: spec.character.outfit.reference.sha256
+      } : null,
       status: "pending",
       jobId: previousJobId ?? null,
       ...previousJobId ? { submissionComplete: false } : { submissionComplete: void 0 },
@@ -14804,10 +15355,15 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
       const anchor = spec.character?.styleAnchor;
       const anchorEntry = anchor ? lock.entries[lockKey(anchor.spec.styleId, anchor.spec.assetId)] : void 0;
       const replacedMetadata = previousEntry?.providerMetadata?.[provider.id];
+      const parentOutputs = spec.character?.kind === "outfit" && parentEntry ? parentEntry.outputs.map((output, index) => ({
+        path: currentEntryOutputPath(parentEntry, spec.character.parentSpec, index),
+        role: output.role
+      })) : void 0;
       const { jobId, metadata } = await provider.submit(spec, refs, {
         ...previousJobId ? { previousJobId } : {},
         ...parentEntry?.objectId ? { parentObjectId: parentEntry.objectId } : {},
         ...anchorEntry?.objectId ? { styleObjectId: anchorEntry.objectId } : {},
+        ...parentOutputs ? { parentOutputs } : {},
         ...replacedMetadata ? { replacedMetadata } : {},
         ...previousMetadata ? { previousMetadata } : {},
         checkpoint: async (checkpoint) => {