pixelkiln 0.35.0 → 0.37.0

package/dist/index.d.cts

@@ -12,6 +12,71 @@ declare function detectMediaType(bytes: Buffer): MediaType | null;
 declare function validateMedia(bytes: Buffer, expected?: MediaType): MediaType;
 declare function cacheFileName(hash: string, mediaType?: MediaType): string;
 
+/**
+ * The kinds of failure a caller can act on differently.
+ *
+ * Most errors in this codebase are plain `Error`s with a good message, and
+ * that stays true: the message is for a person. A `code` is for a program.
+ * The gallery turns one into an HTTP status, the CLI into an exit code, and
+ * an integration decides whether to retry, ask, or stop without matching on
+ * message text that may be reworded.
+ *
+ * The set is deliberately small. A new code earns its place when some caller
+ * would branch on it; until then a plain Error is the right type.
+ */
+type ErrorCode = 
+/** Bad flags or arguments. Nothing was read or written. */
+"usage"
+/** The manifest, lockfile, or workspace catalog is missing or invalid. */
+ | "project"
+/** A provider rejected a request or answered with something unusable. */
+ | "provider"
+/** A file on disk differs from what the record expects; nothing was overwritten. */
+ | "refused-overwrite"
+/** The run would spend past a ceiling, or the balance cannot cover it. */
+ | "budget"
+/** The provider recorded for this work does not offer the operation. */
+ | "capability";
+/** Exit codes the CLI maps each kind to. 1 stays the code for anything untyped. */
+declare const EXIT_CODES: Record<ErrorCode, number>;
+interface PixelKilnErrorOptions {
+    /** One line of what to do next, printed under the message by the CLI. */
+    hint?: string;
+    cause?: unknown;
+}
+declare class PixelKilnError extends Error {
+    readonly code: ErrorCode;
+    readonly hint?: string;
+    constructor(message: string, code: ErrorCode, opts?: PixelKilnErrorOptions);
+}
+declare class UsageError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+declare class ProjectError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+declare class ProviderError extends PixelKilnError {
+    /** Registry id of the provider that failed. */
+    readonly provider: string;
+    /** HTTP status when the failure was a response, otherwise undefined. */
+    readonly status?: number;
+    constructor(provider: string, message: string, opts?: PixelKilnErrorOptions & {
+        status?: number;
+    });
+}
+declare class OverwriteRefusedError extends PixelKilnError {
+    /** The file(s) left untouched. */
+    readonly files: string[];
+    constructor(message: string, files: string[], opts?: PixelKilnErrorOptions);
+}
+declare class BudgetError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+/** The code of any thrown value, or undefined for an untyped error. */
+declare function errorCode(err: unknown): ErrorCode | undefined;
+/** What a process should exit with after failing on `err`. */
+declare function exitCodeFor(err: unknown): number;
+
 /**
  * Human-readable unit attached to every estimate and recorded charge.
  * Built-ins use generations, USD, free, and compute units. Adapters may report
@@ -230,7 +295,7 @@ interface Provider {
     /** Irreversible. Only reached via `purge`, behind explicit confirmation. */
     delete?(assetId: string): Promise<void>;
 }
-declare class UnsupportedCapabilityError extends Error {
+declare class UnsupportedCapabilityError extends PixelKilnError {
     constructor(providerId: string, capability: string);
 }
 /** Narrowing helpers so call sites fail with a clear message, not `undefined is not a function`. */
@@ -561,6 +626,18 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
      * chocolate bar.
      */
     palette: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Snap every visible pixel of the downloaded art to the nearest `palette`
+     * colour, without dithering. The palette is sent to providers that take
+     * one, and most honour it most of the time; this makes it a guarantee
+     * for every generator, including the ones with no palette parameter.
+     * Applied by `fetch` as the file is written and recorded on the lock
+     * entry, so a restore reproduces the same bytes. Turning it on or off
+     * does not change the spec hash: `plan` reports the entry as recoverable
+     * and the next `fetch` or `restore` re-applies it from the art already
+     * on disk or in the cache, spending nothing.
+     */
+    enforcePalette: z.ZodDefault<z.ZodBoolean>;
     /** Fail-closed native-grid, palette, and human-approval policy for derived art. */
     quality: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         /** Output root for approved refined art, relative to the manifest. */
@@ -657,6 +734,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -688,8 +766,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -708,6 +786,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -735,6 +814,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -766,8 +846,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -786,6 +866,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -813,6 +894,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -844,8 +926,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -864,6 +946,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -912,6 +995,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
     noBackground: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     seed: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     palette: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    enforcePalette: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     mount: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         /**
          * Existing sheet to composite into, relative to the manifest. Every
@@ -968,8 +1052,8 @@ declare const InheritedStyleSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -988,6 +1072,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir?: string | undefined;
         palette?: string[] | undefined;
@@ -1008,8 +1093,8 @@ declare const InheritedStyleSchema: z.ZodObject<{
 }, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1028,6 +1113,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir?: string | undefined;
         palette?: string[] | undefined;
@@ -1137,6 +1223,18 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
      * chocolate bar.
      */
     palette: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Snap every visible pixel of the downloaded art to the nearest `palette`
+     * colour, without dithering. The palette is sent to providers that take
+     * one, and most honour it most of the time; this makes it a guarantee
+     * for every generator, including the ones with no palette parameter.
+     * Applied by `fetch` as the file is written and recorded on the lock
+     * entry, so a restore reproduces the same bytes. Turning it on or off
+     * does not change the spec hash: `plan` reports the entry as recoverable
+     * and the next `fetch` or `restore` re-applies it from the art already
+     * on disk or in the cache, spending nothing.
+     */
+    enforcePalette: z.ZodDefault<z.ZodBoolean>;
     /** Fail-closed native-grid, palette, and human-approval policy for derived art. */
     quality: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         /** Output root for approved refined art, relative to the manifest. */
@@ -1233,6 +1331,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -1264,8 +1363,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1284,6 +1383,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -1311,6 +1411,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -1342,8 +1443,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1362,6 +1463,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -1389,6 +1491,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
         path: string;
     }[];
     noBackground: boolean;
+    enforcePalette: boolean;
     tags: string[];
     providerOptions: Record<string, Record<string, unknown>>;
     provider?: string | undefined;
@@ -1420,8 +1523,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1440,6 +1543,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir: string;
         palette: string[];
@@ -1483,6 +1587,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     noBackground: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     seed: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     palette: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    enforcePalette: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     mount: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         /**
          * Existing sheet to composite into, relative to the manifest. Every
@@ -1539,8 +1644,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1559,6 +1664,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir?: string | undefined;
         palette?: string[] | undefined;
@@ -1579,8 +1685,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1599,6 +1705,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     outlineMode?: "outline" | "segmentation" | undefined;
     noBackground?: boolean | undefined;
     seed?: number | undefined;
+    enforcePalette?: boolean | undefined;
     quality?: {
         outDir?: string | undefined;
         palette?: string[] | undefined;
@@ -1907,6 +2014,18 @@ declare const ManifestSchema: z.ZodObject<{
          * chocolate bar.
          */
         palette: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Snap every visible pixel of the downloaded art to the nearest `palette`
+         * colour, without dithering. The palette is sent to providers that take
+         * one, and most honour it most of the time; this makes it a guarantee
+         * for every generator, including the ones with no palette parameter.
+         * Applied by `fetch` as the file is written and recorded on the lock
+         * entry, so a restore reproduces the same bytes. Turning it on or off
+         * does not change the spec hash: `plan` reports the entry as recoverable
+         * and the next `fetch` or `restore` re-applies it from the art already
+         * on disk or in the cache, spending nothing.
+         */
+        enforcePalette: z.ZodDefault<z.ZodBoolean>;
         /** Fail-closed native-grid, palette, and human-approval policy for derived art. */
         quality: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             /** Output root for approved refined art, relative to the manifest. */
@@ -2003,6 +2122,7 @@ declare const ManifestSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2034,8 +2154,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2054,6 +2174,7 @@ declare const ManifestSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2081,6 +2202,7 @@ declare const ManifestSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2112,8 +2234,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2132,6 +2254,7 @@ declare const ManifestSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2159,6 +2282,7 @@ declare const ManifestSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2190,8 +2314,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2210,6 +2334,7 @@ declare const ManifestSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2429,6 +2554,7 @@ declare const ManifestSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2487,8 +2613,8 @@ declare const ManifestSchema: z.ZodObject<{
 }, {
     styles: Record<string, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2507,6 +2633,7 @@ declare const ManifestSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2649,6 +2776,18 @@ declare const ManifestInputSchema: z.ZodObject<{
          * chocolate bar.
          */
         palette: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Snap every visible pixel of the downloaded art to the nearest `palette`
+         * colour, without dithering. The palette is sent to providers that take
+         * one, and most honour it most of the time; this makes it a guarantee
+         * for every generator, including the ones with no palette parameter.
+         * Applied by `fetch` as the file is written and recorded on the lock
+         * entry, so a restore reproduces the same bytes. Turning it on or off
+         * does not change the spec hash: `plan` reports the entry as recoverable
+         * and the next `fetch` or `restore` re-applies it from the art already
+         * on disk or in the cache, spending nothing.
+         */
+        enforcePalette: z.ZodDefault<z.ZodBoolean>;
         /** Fail-closed native-grid, palette, and human-approval policy for derived art. */
         quality: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             /** Output root for approved refined art, relative to the manifest. */
@@ -2745,6 +2884,7 @@ declare const ManifestInputSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2776,8 +2916,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2796,6 +2936,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2823,6 +2964,7 @@ declare const ManifestInputSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2854,8 +2996,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2874,6 +3016,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2901,6 +3044,7 @@ declare const ManifestInputSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -2932,8 +3076,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2952,6 +3096,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -2995,6 +3140,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         noBackground: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         seed: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         palette: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+        enforcePalette: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         mount: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             /**
              * Existing sheet to composite into, relative to the manifest. Every
@@ -3051,8 +3197,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3071,6 +3217,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir?: string | undefined;
             palette?: string[] | undefined;
@@ -3091,8 +3238,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     }, {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3111,6 +3258,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir?: string | undefined;
             palette?: string[] | undefined;
@@ -3330,6 +3478,7 @@ declare const ManifestInputSchema: z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -3362,8 +3511,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     } | {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3382,6 +3531,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir?: string | undefined;
             palette?: string[] | undefined;
@@ -3428,8 +3578,8 @@ declare const ManifestInputSchema: z.ZodObject<{
 }, {
     styles: Record<string, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3448,6 +3598,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -3468,8 +3619,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     } | {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3488,6 +3639,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir?: string | undefined;
             palette?: string[] | undefined;
@@ -3536,6 +3688,40 @@ declare const ManifestInputSchema: z.ZodObject<{
 type Manifest = z.infer<typeof ManifestSchema>;
 type Style = z.infer<typeof StyleSchema>;
 type Asset = z.infer<typeof AssetSchema>;
+/**
+ * What `fetch` did to the provider's bytes before writing them. Recorded on
+ * the entry so `plan` can tell when the manifest asks for something else
+ * and `restore` can reproduce the recorded hash from the raw bytes.
+ */
+declare const PostprocessSchema: z.ZodObject<{
+    palette: z.ZodOptional<z.ZodObject<{
+        /** Canonical lowercase `#rrggbb` values, in manifest order. */
+        colors: z.ZodArray<z.ZodString, "many">;
+        dither: z.ZodLiteral<"none">;
+        distance: z.ZodLiteral<"redmean">;
+    }, "strip", z.ZodTypeAny, {
+        colors: string[];
+        dither: "none";
+        distance: "redmean";
+    }, {
+        colors: string[];
+        dither: "none";
+        distance: "redmean";
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    palette?: {
+        colors: string[];
+        dither: "none";
+        distance: "redmean";
+    } | undefined;
+}, {
+    palette?: {
+        colors: string[];
+        dither: "none";
+        distance: "redmean";
+    } | undefined;
+}>;
+type Postprocess = z.infer<typeof PostprocessSchema>;
 /**
  * A generation this entry replaced, kept so it can be brought back. It is the
  * retired entry's identity — object, sources, output hashes, prompt, cost —
@@ -3572,16 +3758,24 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
         sha256: z.ZodString;
         role: z.ZodOptional<z.ZodString>;
         mediaType: z.ZodOptional<z.ZodEnum<["image/png", "image/gif"]>>;
+        /**
+         * Hash of the provider's bytes before post-processing changed them, when
+         * it did. The content cache keeps both, so the post-processing can be
+         * undone or redone without contacting the provider.
+         */
+        raw: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }, {
         path: string;
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }>, "many">>;
     providerMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     submittedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -3589,6 +3783,34 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
     cost: z.ZodDefault<z.ZodNumber>;
     costUnit: z.ZodDefault<z.ZodString>;
     provider: z.ZodDefault<z.ZodString>;
+    postprocess: z.ZodOptional<z.ZodObject<{
+        palette: z.ZodOptional<z.ZodObject<{
+            /** Canonical lowercase `#rrggbb` values, in manifest order. */
+            colors: z.ZodArray<z.ZodString, "many">;
+            dither: z.ZodLiteral<"none">;
+            distance: z.ZodLiteral<"redmean">;
+        }, "strip", z.ZodTypeAny, {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        }, {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    }, {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    }>>;
     /** When the replacement was submitted. */
     retiredAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -3613,6 +3835,7 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }[];
     providerMetadata: Record<string, Record<string, unknown>>;
     submittedAt: string | null;
@@ -3620,6 +3843,13 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
     cost: number;
     costUnit: string;
     retiredAt: string;
+    postprocess?: {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    } | undefined;
 }, {
     width: number;
     height: number;
@@ -3643,12 +3873,20 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }[] | undefined;
     providerMetadata?: Record<string, Record<string, unknown>> | undefined;
     submittedAt?: string | null | undefined;
     downloadedAt?: string | null | undefined;
     cost?: number | undefined;
     costUnit?: string | undefined;
+    postprocess?: {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    } | undefined;
 }>;
 declare const LockEntrySchema: z.ZodObject<{
     styleId: z.ZodString;
@@ -3741,16 +3979,24 @@ declare const LockEntrySchema: z.ZodObject<{
         sha256: z.ZodString;
         role: z.ZodOptional<z.ZodString>;
         mediaType: z.ZodOptional<z.ZodEnum<["image/png", "image/gif"]>>;
+        /**
+         * Hash of the provider's bytes before post-processing changed them, when
+         * it did. The content cache keeps both, so the post-processing can be
+         * undone or redone without contacting the provider.
+         */
+        raw: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }, {
         path: string;
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }>, "many">>;
     /**
      * Provider-owned data retained for downstream consumers, namespaced by
@@ -3796,16 +4042,24 @@ declare const LockEntrySchema: z.ZodObject<{
             sha256: z.ZodString;
             role: z.ZodOptional<z.ZodString>;
             mediaType: z.ZodOptional<z.ZodEnum<["image/png", "image/gif"]>>;
+            /**
+             * Hash of the provider's bytes before post-processing changed them, when
+             * it did. The content cache keeps both, so the post-processing can be
+             * undone or redone without contacting the provider.
+             */
+            raw: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             path: string;
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }, {
             path: string;
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }>, "many">>;
         providerMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         submittedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -3813,6 +4067,34 @@ declare const LockEntrySchema: z.ZodObject<{
         cost: z.ZodDefault<z.ZodNumber>;
         costUnit: z.ZodDefault<z.ZodString>;
         provider: z.ZodDefault<z.ZodString>;
+        postprocess: z.ZodOptional<z.ZodObject<{
+            palette: z.ZodOptional<z.ZodObject<{
+                /** Canonical lowercase `#rrggbb` values, in manifest order. */
+                colors: z.ZodArray<z.ZodString, "many">;
+                dither: z.ZodLiteral<"none">;
+                distance: z.ZodLiteral<"redmean">;
+            }, "strip", z.ZodTypeAny, {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            }, {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        }, {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        }>>;
         /** When the replacement was submitted. */
         retiredAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
@@ -3837,6 +4119,7 @@ declare const LockEntrySchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[];
         providerMetadata: Record<string, Record<string, unknown>>;
         submittedAt: string | null;
@@ -3844,6 +4127,13 @@ declare const LockEntrySchema: z.ZodObject<{
         cost: number;
         costUnit: string;
         retiredAt: string;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
     }, {
         width: number;
         height: number;
@@ -3867,18 +4157,55 @@ declare const LockEntrySchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[] | undefined;
         providerMetadata?: Record<string, Record<string, unknown>> | undefined;
         submittedAt?: string | null | undefined;
         downloadedAt?: string | null | undefined;
         cost?: number | undefined;
         costUnit?: string | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
     }>, "many">>;
+    /** Post-processing applied to the recorded outputs; absent when the bytes are the provider's. */
+    postprocess: z.ZodOptional<z.ZodObject<{
+        palette: z.ZodOptional<z.ZodObject<{
+            /** Canonical lowercase `#rrggbb` values, in manifest order. */
+            colors: z.ZodArray<z.ZodString, "many">;
+            dither: z.ZodLiteral<"none">;
+            distance: z.ZodLiteral<"redmean">;
+        }, "strip", z.ZodTypeAny, {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        }, {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    }, {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     width: number;
     height: number;
-    status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
     provider: string;
+    status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
     generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
     tileFeature: string | null;
     prompt: string;
@@ -3904,6 +4231,7 @@ declare const LockEntrySchema: z.ZodObject<{
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }[];
     providerMetadata: Record<string, Record<string, unknown>>;
     submittedAt: string | null;
@@ -3936,6 +4264,7 @@ declare const LockEntrySchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[];
         providerMetadata: Record<string, Record<string, unknown>>;
         submittedAt: string | null;
@@ -3943,7 +4272,21 @@ declare const LockEntrySchema: z.ZodObject<{
         cost: number;
         costUnit: string;
         retiredAt: string;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
     }[] | undefined;
+    postprocess?: {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    } | undefined;
     supersededOutputs?: {
         path: string;
         sha256: string;
@@ -3959,8 +4302,8 @@ declare const LockEntrySchema: z.ZodObject<{
     specHash: string;
     styleId: string;
     assetId: string;
-    status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
     provider?: string | undefined;
+    status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
     tileFeature?: string | null | undefined;
     revision?: {
         mode: "image-to-image" | "inpaint" | "outpaint";
@@ -3992,12 +4335,20 @@ declare const LockEntrySchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[] | undefined;
         providerMetadata?: Record<string, Record<string, unknown>> | undefined;
         submittedAt?: string | null | undefined;
         downloadedAt?: string | null | undefined;
         cost?: number | undefined;
         costUnit?: string | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
     }[] | undefined;
     jobId?: string | null | undefined;
     objectId?: string | null | undefined;
@@ -4013,12 +4364,20 @@ declare const LockEntrySchema: z.ZodObject<{
         sha256: string;
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
+        raw?: string | undefined;
     }[] | undefined;
     providerMetadata?: Record<string, Record<string, unknown>> | undefined;
     submittedAt?: string | null | undefined;
     downloadedAt?: string | null | undefined;
     cost?: number | undefined;
     costUnit?: string | undefined;
+    postprocess?: {
+        palette?: {
+            colors: string[];
+            dither: "none";
+            distance: "redmean";
+        } | undefined;
+    } | undefined;
     supersededOutputs?: {
         path: string;
         sha256: string;
@@ -4122,16 +4481,24 @@ declare const LockSchema: z.ZodObject<{
             sha256: z.ZodString;
             role: z.ZodOptional<z.ZodString>;
             mediaType: z.ZodOptional<z.ZodEnum<["image/png", "image/gif"]>>;
+            /**
+             * Hash of the provider's bytes before post-processing changed them, when
+             * it did. The content cache keeps both, so the post-processing can be
+             * undone or redone without contacting the provider.
+             */
+            raw: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             path: string;
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }, {
             path: string;
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }>, "many">>;
         /**
          * Provider-owned data retained for downstream consumers, namespaced by
@@ -4177,16 +4544,24 @@ declare const LockSchema: z.ZodObject<{
                 sha256: z.ZodString;
                 role: z.ZodOptional<z.ZodString>;
                 mediaType: z.ZodOptional<z.ZodEnum<["image/png", "image/gif"]>>;
+                /**
+                 * Hash of the provider's bytes before post-processing changed them, when
+                 * it did. The content cache keeps both, so the post-processing can be
+                 * undone or redone without contacting the provider.
+                 */
+                raw: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 path: string;
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }, {
                 path: string;
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }>, "many">>;
             providerMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             submittedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
@@ -4194,6 +4569,34 @@ declare const LockSchema: z.ZodObject<{
             cost: z.ZodDefault<z.ZodNumber>;
             costUnit: z.ZodDefault<z.ZodString>;
             provider: z.ZodDefault<z.ZodString>;
+            postprocess: z.ZodOptional<z.ZodObject<{
+                palette: z.ZodOptional<z.ZodObject<{
+                    /** Canonical lowercase `#rrggbb` values, in manifest order. */
+                    colors: z.ZodArray<z.ZodString, "many">;
+                    dither: z.ZodLiteral<"none">;
+                    distance: z.ZodLiteral<"redmean">;
+                }, "strip", z.ZodTypeAny, {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                }, {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            }, {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            }>>;
             /** When the replacement was submitted. */
             retiredAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
@@ -4218,6 +4621,7 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[];
             providerMetadata: Record<string, Record<string, unknown>>;
             submittedAt: string | null;
@@ -4225,6 +4629,13 @@ declare const LockSchema: z.ZodObject<{
             cost: number;
             costUnit: string;
             retiredAt: string;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }, {
             width: number;
             height: number;
@@ -4248,18 +4659,55 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[] | undefined;
             providerMetadata?: Record<string, Record<string, unknown>> | undefined;
             submittedAt?: string | null | undefined;
             downloadedAt?: string | null | undefined;
             cost?: number | undefined;
             costUnit?: string | undefined;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }>, "many">>;
+        /** Post-processing applied to the recorded outputs; absent when the bytes are the provider's. */
+        postprocess: z.ZodOptional<z.ZodObject<{
+            palette: z.ZodOptional<z.ZodObject<{
+                /** Canonical lowercase `#rrggbb` values, in manifest order. */
+                colors: z.ZodArray<z.ZodString, "many">;
+                dither: z.ZodLiteral<"none">;
+                distance: z.ZodLiteral<"redmean">;
+            }, "strip", z.ZodTypeAny, {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            }, {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        }, {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         width: number;
         height: number;
-        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         provider: string;
+        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
         tileFeature: string | null;
         prompt: string;
@@ -4285,6 +4733,7 @@ declare const LockSchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[];
         providerMetadata: Record<string, Record<string, unknown>>;
         submittedAt: string | null;
@@ -4317,6 +4766,7 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[];
             providerMetadata: Record<string, Record<string, unknown>>;
             submittedAt: string | null;
@@ -4324,7 +4774,21 @@ declare const LockSchema: z.ZodObject<{
             cost: number;
             costUnit: string;
             retiredAt: string;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }[] | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
         supersededOutputs?: {
             path: string;
             sha256: string;
@@ -4340,8 +4804,8 @@ declare const LockSchema: z.ZodObject<{
         specHash: string;
         styleId: string;
         assetId: string;
-        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         provider?: string | undefined;
+        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         tileFeature?: string | null | undefined;
         revision?: {
             mode: "image-to-image" | "inpaint" | "outpaint";
@@ -4373,12 +4837,20 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[] | undefined;
             providerMetadata?: Record<string, Record<string, unknown>> | undefined;
             submittedAt?: string | null | undefined;
             downloadedAt?: string | null | undefined;
             cost?: number | undefined;
             costUnit?: string | undefined;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
         objectId?: string | null | undefined;
@@ -4394,12 +4866,20 @@ declare const LockSchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[] | undefined;
         providerMetadata?: Record<string, Record<string, unknown>> | undefined;
         submittedAt?: string | null | undefined;
         downloadedAt?: string | null | undefined;
         cost?: number | undefined;
         costUnit?: string | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
         supersededOutputs?: {
             path: string;
             sha256: string;
@@ -4414,8 +4894,8 @@ declare const LockSchema: z.ZodObject<{
     entries: Record<string, {
         width: number;
         height: number;
-        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         provider: string;
+        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
         tileFeature: string | null;
         prompt: string;
@@ -4441,6 +4921,7 @@ declare const LockSchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[];
         providerMetadata: Record<string, Record<string, unknown>>;
         submittedAt: string | null;
@@ -4473,6 +4954,7 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[];
             providerMetadata: Record<string, Record<string, unknown>>;
             submittedAt: string | null;
@@ -4480,7 +4962,21 @@ declare const LockSchema: z.ZodObject<{
             cost: number;
             costUnit: string;
             retiredAt: string;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }[] | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
         supersededOutputs?: {
             path: string;
             sha256: string;
@@ -4499,8 +4995,8 @@ declare const LockSchema: z.ZodObject<{
         specHash: string;
         styleId: string;
         assetId: string;
-        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         provider?: string | undefined;
+        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         tileFeature?: string | null | undefined;
         revision?: {
             mode: "image-to-image" | "inpaint" | "outpaint";
@@ -4532,12 +5028,20 @@ declare const LockSchema: z.ZodObject<{
                 sha256: string;
                 role?: string | undefined;
                 mediaType?: "image/png" | "image/gif" | undefined;
+                raw?: string | undefined;
             }[] | undefined;
             providerMetadata?: Record<string, Record<string, unknown>> | undefined;
             submittedAt?: string | null | undefined;
             downloadedAt?: string | null | undefined;
             cost?: number | undefined;
             costUnit?: string | undefined;
+            postprocess?: {
+                palette?: {
+                    colors: string[];
+                    dither: "none";
+                    distance: "redmean";
+                } | undefined;
+            } | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
         objectId?: string | null | undefined;
@@ -4553,12 +5057,20 @@ declare const LockSchema: z.ZodObject<{
             sha256: string;
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
+            raw?: string | undefined;
         }[] | undefined;
         providerMetadata?: Record<string, Record<string, unknown>> | undefined;
         submittedAt?: string | null | undefined;
         downloadedAt?: string | null | undefined;
         cost?: number | undefined;
         costUnit?: string | undefined;
+        postprocess?: {
+            palette?: {
+                colors: string[];
+                dither: "none";
+                distance: "redmean";
+            } | undefined;
+        } | undefined;
         supersededOutputs?: {
             path: string;
             sha256: string;
@@ -4629,6 +5141,8 @@ interface ResolvedSpec {
     seed?: number;
     /** Forced palette hex values; empty unless the style sets one. */
     palette: string[];
+    /** Snap downloaded art to `palette`; excluded from the spec hash. */
+    enforcePalette: boolean;
     /** `pixflux` only — strip the generated background. Defaults to true. */
     noBackground: boolean;
     /** `tiles` generator only — see StyleSchema for what each one means. */
@@ -4740,8 +5254,7 @@ interface MapObject {
     height: number | null;
     download_url: string | null;
 }
-declare class PixelLabError extends Error {
-    readonly status: number;
+declare class PixelLabError extends ProviderError {
     readonly body: string;
     constructor(message: string, status: number, body: string);
 }
@@ -5689,6 +6202,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         noBackground: z.ZodDefault<z.ZodBoolean>;
         seed: z.ZodOptional<z.ZodNumber>;
         palette: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        enforcePalette: z.ZodDefault<z.ZodBoolean>;
         quality: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             outDir: z.ZodString;
             palette: z.ZodArray<z.ZodString, "many">;
@@ -5758,6 +6272,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -5789,8 +6304,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -5809,6 +6324,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -5836,6 +6352,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -5867,8 +6384,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -5887,6 +6404,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -5914,6 +6432,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -5945,8 +6464,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -5965,6 +6484,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -6343,6 +6863,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -6445,8 +6966,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     summary: string;
     style: {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -6465,6 +6986,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -6585,6 +7107,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             path: string;
         }[];
         noBackground: boolean;
+        enforcePalette: boolean;
         tags: string[];
         providerOptions: Record<string, Record<string, unknown>>;
         provider?: string | undefined;
@@ -6687,8 +7210,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     summary: string;
     style: {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -6707,6 +7230,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         outlineMode?: "outline" | "segmentation" | undefined;
         noBackground?: boolean | undefined;
         seed?: number | undefined;
+        enforcePalette?: boolean | undefined;
         quality?: {
             outDir: string;
             palette: string[];
@@ -6780,6 +7304,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
 type Recipe = z.infer<typeof RecipeSchema>;
 interface LoadedRecipe {
     recipe: Recipe;
+    /** The file's JSON as written, before schema defaults; what the digest covers. */
+    authored: Record<string, unknown>;
     path: string;
     dir: string;
     bundled: boolean;
@@ -6830,7 +7356,14 @@ interface InstallRecipeResult {
     styleId: string;
     style: Style;
 }
-declare function recipeDigest(recipe: Recipe): string;
+/**
+ * The digest covers the recipe as its author wrote it, minus `integrity`.
+ * It used to cover the parsed form, which meant every schema default added
+ * to a style changed the digest of every recipe ever published; the
+ * `enforcePalette` default was the first to trip it. What the author
+ * signed is what the file says, so that is what is hashed.
+ */
+declare function recipeDigest(recipe: Recipe | Record<string, unknown>): string;
 declare function bundledRecipeRoot(): string;
 declare function listBundledRecipes(root?: string): Promise<LoadedRecipe[]>;
 declare function resolveRecipe(target: string, bundledRoot?: string): Promise<LoadedRecipe>;
@@ -6855,11 +7388,9 @@ interface PaletteEntry {
 }
 
 /**
- * Perceptual-ish distance between two colours, 0-255ish.
- *
- * "Redmean" — a cheap weighting that tracks human perception far better than
- * raw RGB euclidean and needs no colour-space conversion or dependency. Good
- * enough to rank outliers, which is all this is for; it is not colourimetry.
+ * Perceptual-ish RGB distance that weights channels by where the colour sits
+ * (Riemersma's redmean). Cheap and good enough to pick a swatch; not a
+ * colour-management tool.
  */
 declare function colorDistance(a: {
     r: number;
@@ -6870,6 +7401,9 @@ declare function colorDistance(a: {
     g: number;
     b: number;
 }): number;
+/** `quantize` for callers that only want the picture. */
+declare function quantizeToPalette(png: DecodedPng, palette: string[]): DecodedPng;
+
 /**
  * How far an asset's palette sits from a reference palette.
  *
@@ -7113,8 +7647,7 @@ interface ApproveQualityOptions {
 declare function qualityRecordPath(output: string): string;
 /** Canonical lowercase palette identity shared by manifest quality profiles. */
 declare function normalizeRefinementPalette(values: string[]): string[];
-/** Map every visible pixel to the nearest explicit color, without dithering. */
-declare function quantizeToPalette(png: DecodedPng, palette: string[]): DecodedPng;
+
 /** Derive a stable frame PNG beside a quality profile's virtual output stem. */
 declare function qualityFrameOutputPath(output: string, role: string, index: number): string;
 /** Recover an image's native grid, enforce its final palette, and write an auditable bundle. */
@@ -7194,9 +7727,9 @@ declare const ImageQualityMetricsSchema: z.ZodObject<{
     width: number;
     height: number;
     sha256: string;
+    colors: string[];
     colorCount: number;
     transparency: number;
-    colors: string[];
     partialAlpha: number;
     edgeDensity: number;
     meanEdgeContrast: number;
@@ -7205,9 +7738,9 @@ declare const ImageQualityMetricsSchema: z.ZodObject<{
     width: number;
     height: number;
     sha256: string;
+    colors: string[];
     colorCount: number;
     transparency: number;
-    colors: string[];
     partialAlpha: number;
     edgeDensity: number;
     meanEdgeContrast: number;
@@ -7246,9 +7779,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7257,9 +7790,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7298,9 +7831,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7327,9 +7860,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7360,9 +7893,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7394,9 +7927,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7428,9 +7961,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -7462,9 +7995,9 @@ declare const QualityBaselineSchema: z.ZodEffects<z.ZodObject<{
             width: number;
             height: number;
             sha256: string;
+            colors: string[];
             colorCount: number;
             transparency: number;
-            colors: string[];
             partialAlpha: number;
             edgeDensity: number;
             meanEdgeContrast: number;
@@ -8312,6 +8845,8 @@ interface GalleryItem {
     outputs: GalleryOutput[];
     quality: GalleryQuality | null;
     providerMetadata: Record<string, unknown>;
+    /** Post-processing recorded on the entry: the palette its files were snapped to, if any. */
+    postprocess: Postprocess | null;
     /** Manifest asset as declared, for the "intent" side of the record. */
     asset: Asset | null;
     /** Manifest-relative committed art placed instead of generated output. */
@@ -8357,6 +8892,8 @@ interface GalleryStyle {
     promptPrefix: string;
     promptSuffix: string;
     palette: string[];
+    /** Downloaded art is snapped to `palette` by fetch. */
+    enforcePalette: boolean;
     /** Provider view name, when the style sets one. */
     view: string | null;
     /** Strip the generated background (sent for pixflux and non-PixelLab providers). */
@@ -8648,6 +9185,7 @@ declare const CompanionV2Schema: z.ZodObject<{
         basedOn: string | null;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8655,10 +9193,10 @@ declare const CompanionV2Schema: z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8666,7 +9204,6 @@ declare const CompanionV2Schema: z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }>;
@@ -8696,6 +9233,7 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         basedOn: string | null;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8703,10 +9241,10 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8714,7 +9252,6 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }>, z.ZodObject<{
@@ -8726,22 +9263,23 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     savedAt: z.ZodString;
     project: z.ZodNullable<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
 }>]>, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8749,10 +9287,10 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8760,14 +9298,13 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 } | {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
@@ -8844,7 +9381,7 @@ declare function retireGeneration(entry: LockEntry, retiredAt: string): LockHist
  * no bytes to come back to.
  */
 declare function historyAfterReplacing(previous: LockEntry | undefined, limit: number, retiredAt: string): LockHistoryEntry[] | undefined;
-/** Output hashes every generation in the lockfile, current or retired, still refers to. */
+/** Hashes every generation in the lockfile, current or retired, still refers to: outputs and the raw bytes behind them. */
 declare function referencedHashes(lock: Lock): Set<string>;
 interface HistoryPick {
     /** 1 is the most recently replaced generation. */
@@ -9125,49 +9662,49 @@ declare const GenerateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     revert: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }>, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }>, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
@@ -9372,6 +9909,8 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix: z.ZodOptional<z.ZodString>;
         /** `#rrggbb` values; null or empty clears the style's own palette. */
         palette: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        /** Snap downloaded art to the palette; false clears the style's own value. */
+        enforcePalette: z.ZodOptional<z.ZodBoolean>;
         /** Provider view name (PixelLab: low top-down, high top-down, side); empty clears. */
         view: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         /** pixflux only; null clears the style's own value. */
@@ -9383,6 +9922,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
@@ -9390,6 +9930,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     }>, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
@@ -9397,6 +9938,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     }, {
         candidates?: number | undefined;
         palette?: string[] | null | undefined;
@@ -9404,6 +9946,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
     styleId: string;
@@ -9414,6 +9957,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     };
     expectedSha256: string;
     action: "patch-style";
@@ -9427,6 +9971,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
         noBackground?: boolean | null | undefined;
+        enforcePalette?: boolean | undefined;
     };
     expectedSha256: string;
     action: "patch-style";
@@ -9777,4 +10322,4 @@ interface WorkspaceStatusReport {
  */
 declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
 
-export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type PrepareReviewOptions, type Project, type Provider, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };
+export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, BudgetError, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EXIT_CODES, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, type ErrorCode, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Postprocess, PostprocessSchema, type PrepareReviewOptions, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, UsageError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };