pixelkiln 0.72.0 → 0.74.0

package/dist/index.d.cts

@@ -18840,177 +18840,9 @@ interface GalleryEditorOptions extends Pick<EditorInstallOptions, "dir" | "baseU
 declare function editorRoute(release: string, name?: string): string;
 declare function createGalleryEditorHandlers(opts?: GalleryEditorOptions): GalleryEditorHandlers;
 
-/**
- * Generation from the gallery is the CLI's `gen`, run as a background job:
- * the same `buildPlan`, the same per-provider budget and balance preflight,
- * the same `submit → poll → fetch` library calls writing the same lockfile.
- * The page adds nothing the terminal cannot do; it only shows the estimate,
- * asks, and reports progress.
- *
- * Two ceilings guard spend. The session budget is passed when the gallery
- * starts (`--budget`, optionally keyed per provider) and every job's estimate
- * is charged against it up front, so the page can never exceed what the
- * person typed. Each submission also carries the remaining ceiling as its
- * own `budget`, the way `gen --budget` does, so a provider estimate that
- * grows between plan and submit is refused rather than paid.
- */
-type GeneratePhase = "queued" | "submitting" | "polling" | "fetching" | "review" | "done" | "failed";
-interface GenerateJob {
-    id: string;
-    project: string | null;
-    keys: string[];
-    /**
-     * `resume` skips submission: poll, review, and fetch existing work at no
-     * cost; `refresh` re-pulls changed objects; `restore` puts the recorded
-     * bytes back on disk from the cache or the provider, as `pixelkiln restore`.
-     */
-    mode: "generate" | "resume" | "refresh" | "restore" | "revert";
-    /** The job may replace a locally modified or untracked file, as `--force` does. */
-    force: boolean;
-    /** For `revert`: which replaced generation, as the request named it. */
-    revert: string | null;
-    phase: GeneratePhase;
-    startedAt: string;
-    finishedAt: string | null;
-    /** Progress lines, exactly what the CLI would have printed. */
-    messages: string[];
-    error: string | null;
-    /** Successful-submission estimates this job charged, by provider. */
-    spent: Record<string, number>;
-    /** Keys still waiting for a human choice. */
-    review: string[];
-    counts: {
-        submitted: number;
-        failed: number;
-        downloaded: number;
-    };
-}
-interface GalleryProjectContext {
-    loaded: LoadedManifest;
-    /** Every spec the project declares, unfiltered. */
-    specs: ResolvedSpec[];
-    lock: Lock;
-    lockPath: string;
-}
-interface SessionBudget {
-    /** Unkeyed ceiling, valid only when a run involves a single provider. */
-    amount?: number;
-    /** Provider-keyed ceilings. */
-    byProvider: Record<string, number>;
-}
-interface GenerateHandlerOptions {
-    /** Load a project fresh from disk; `project` is the workspace id, if any. */
-    loadProject: (project?: string) => Promise<GalleryProjectContext>;
-    /** An online provider for a project; the caller owns env loading and caching. */
-    providerFor: (project: string | undefined, providerId: string) => Provider;
-    budget: SessionBudget;
-    reload: () => Promise<GalleryBuild>;
-    onProgress?: (msg: string) => void;
-    /** Test hooks. */
-    pollIntervalMs?: number;
-    submitSpacingMs?: number;
-    /** Deterministic clock hook. */
-    now?: () => Date;
-}
-interface GenerateStatus {
-    jobs: GenerateJob[];
-    budget: SessionBudget;
-    /** Estimates charged so far this session, by provider. */
-    spent: Record<string, number>;
-    /** Providers whose spend unit is known, for display. */
-    units: Record<string, CostUnit>;
-}
-interface GalleryGenerateHandlers {
-    start(body: unknown): Promise<GenerateJob>;
-    status(): GenerateStatus;
-    /** The embedded review sheet for a job's waiting keys; null when nothing waits. */
-    review(jobId: string, options: RenderSheetOptions & {
-        routePrefix: string;
-    }): Promise<ReviewSession | null>;
-    applyReview(jobId: string, body: unknown): Promise<PickResult>;
-}
-declare const GenerateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
-    project: z.ZodOptional<z.ZodString>;
-    keys: z.ZodArray<z.ZodString, "many">;
-    /**
-     * Regenerate work that is up to date, as `gen --force` does, and let the
-     * fetch replace a locally modified or untracked file. With `restore`, put
-     * the recorded bytes back over a modified file.
-     */
-    force: z.ZodOptional<z.ZodBoolean>;
-    /** Advance in-flight, review, or selected work without submitting anything. */
-    resume: z.ZodOptional<z.ZodBoolean>;
-    /** Re-download downloaded outputs and replace files whose object changed upstream. */
-    refresh: z.ZodOptional<z.ZodBoolean>;
-    /** Put recorded outputs back on disk from the cache or the provider, without generating. */
-    restore: z.ZodOptional<z.ZodBoolean>;
-    /**
-     * Bring a replaced generation back: 1-based position in the record's
-     * history (newest first) or an output hash prefix. One key at a time.
-     */
-    revert: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}>, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}>, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}, {
-    keys: string[];
-    project?: string | undefined;
-    resume?: boolean | undefined;
-    force?: boolean | undefined;
-    refresh?: boolean | undefined;
-    restore?: boolean | undefined;
-    revert?: string | undefined;
-}>;
-declare class GenerateRequestError extends Error {
-    readonly status: number;
-    constructor(message: string, status?: number);
-}
-declare function createGenerateHandlers(opts: GenerateHandlerOptions): GalleryGenerateHandlers;
-
 declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
     action: z.ZodLiteral<"patch-asset">;
-    /** Workspace project id; omitted for a single-project gallery. */
-    project: z.ZodOptional<z.ZodString>;
     assetId: z.ZodString;
-    /** Manifest bytes the page last saw; a mismatch refuses the write. */
-    expectedSha256: z.ZodString;
     patch: z.ZodObject<{
         prompt: z.ZodOptional<z.ZodString>;
         /** Per-style override for the style being viewed; null removes it. */
@@ -19052,6 +18884,11 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             styleId: string;
         } | undefined;
     }>;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
+    expectedSha256: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     assetId: string;
     action: "patch-asset";
@@ -19088,11 +18925,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     project?: string | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"add-asset">;
-    project: z.ZodOptional<z.ZodString>;
     assetId: z.ZodString;
-    expectedSha256: z.ZodString;
     asset: z.ZodEffects<z.ZodEffects<z.ZodObject<{
-        prompt: z.ZodString;
+        /** A portrait, an outfit, or a mirror has none of its own; the loader says where one is needed. */
+        prompt: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodString>;
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
@@ -19182,6 +19018,8 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             direction: z.ZodOptional<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>>;
             frames: z.ZodOptional<z.ZodNumber>;
             fps: z.ZodOptional<z.ZodNumber>;
+            /** One loop per named direction, plus free mirrors; expanded when the manifest loads. */
+            directions: z.ZodOptional<z.ZodArray<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>, "many">>;
             mode: z.ZodOptional<z.ZodEnum<["template", "skeleton-v3", "v3", "pro"]>>;
             /** What is being animated, when the parent's own description would mislead the model (`character` only). */
             subject: z.ZodOptional<z.ZodString>;
@@ -19192,6 +19030,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
@@ -19201,12 +19040,68 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         }>>;
+        /** A bust of an existing character. */
+        portrait: z.ZodOptional<z.ZodObject<{
+            of: z.ZodString;
+            size: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<16>, z.ZodLiteral<32>, z.ZodLiteral<48>, z.ZodLiteral<64>, z.ZodLiteral<128>, z.ZodLiteral<160>]>>;
+        }, "strict", z.ZodTypeAny, {
+            of: string;
+            size: 16 | 32 | 64 | 128 | 48 | 160;
+        }, {
+            of: string;
+            size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+        }>>;
+        /** An existing loop re-clothed from a reference image (uploaded first). */
+        outfit: z.ZodOptional<z.ZodObject<{
+            of: z.ZodString;
+            reference: z.ZodString;
+            additionalInstructions: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        }, {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        }>>;
+        /** Another asset of the same style, flipped; free. */
+        mirror: z.ZodOptional<z.ZodString>;
+        /**
+         * `character`/`objectPro` bases: the subject's own sprite (uploaded
+         * first), or one per direction, which PixelLab rotates instead of drawing.
+         */
+        reference: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>, z.ZodString>]>>;
+        /** `character` pro bases: a concept image that seeds the design. */
+        concept: z.ZodOptional<z.ZodString>;
+        /** `character` pro bases: another character in the style whose look this one follows. */
+        styleCharacter: z.ZodOptional<z.ZodString>;
+        /** `character` standard humanoid bases: this character's proportions, over the style's. */
+        proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
+            headSize: z.ZodOptional<z.ZodNumber>;
+            armsLength: z.ZodOptional<z.ZodNumber>;
+            legsLength: z.ZodOptional<z.ZodNumber>;
+            shoulderWidth: z.ZodOptional<z.ZodNumber>;
+            hipWidth: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        }, {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        }>]>>;
     }, "strict", z.ZodTypeAny, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19215,11 +19110,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19228,7 +19125,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size: 16 | 32 | 64 | 128 | 48 | 160;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19242,9 +19157,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19253,11 +19169,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19266,8 +19184,26 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
-        tags?: string[] | undefined;
-        category?: string | undefined;
+        portrait?: {
+            of: string;
+            size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
+        tags?: string[] | undefined;
+        prompt?: string | undefined;
+        category?: string | undefined;
         revision?: {
             mode: "image-to-image";
             from: string;
@@ -19280,9 +19216,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }>, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19291,11 +19228,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19304,7 +19243,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size: 16 | 32 | 64 | 128 | 48 | 160;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19318,9 +19275,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19329,11 +19287,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19342,7 +19302,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19356,9 +19334,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }>, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19367,11 +19346,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19380,7 +19361,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size: 16 | 32 | 64 | 128 | 48 | 160;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19394,9 +19393,10 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }, {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19405,11 +19405,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19418,7 +19420,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19432,13 +19452,19 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     }>;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
+    expectedSha256: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     assetId: string;
     action: "add-asset";
     asset: {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19447,11 +19473,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19460,7 +19488,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size: 16 | 32 | 64 | 128 | 48 | 160;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19474,6 +19520,8 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     };
     expectedSha256: string;
@@ -19482,7 +19530,6 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     assetId: string;
     action: "add-asset";
     asset: {
-        prompt: string;
         width?: number | undefined;
         height?: number | undefined;
         animation?: {
@@ -19491,11 +19538,13 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             fps?: number | undefined;
             template?: string | undefined;
             direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+            directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
             mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
             subject?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
         size?: number | undefined;
+        reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
             of: string;
             paletteFromReference?: boolean | undefined;
@@ -19504,7 +19553,25 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
                 height: number;
             } | undefined;
         } | undefined;
+        portrait?: {
+            of: string;
+            size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+        } | undefined;
+        outfit?: {
+            of: string;
+            reference: string;
+            additionalInstructions?: string | undefined;
+        } | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        styleCharacter?: string | undefined;
         tags?: string[] | undefined;
+        prompt?: string | undefined;
         category?: string | undefined;
         revision?: {
             mode: "image-to-image";
@@ -19518,17 +19585,22 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
             skeletonTemplate?: string | undefined;
             description?: string | undefined;
         } | undefined;
+        concept?: string | undefined;
+        mirror?: string | undefined;
         styles?: string[] | undefined;
     };
     expectedSha256: string;
     project?: string | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"set-source">;
-    project: z.ZodOptional<z.ZodString>;
     assetId: z.ZodString;
     styleId: z.ZodString;
     /** Manifest-relative path of the art that stands in for this asset in this style. */
     source: z.ZodString;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
     expectedSha256: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     source: string;
@@ -19546,9 +19618,12 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     project?: string | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"clear-source">;
-    project: z.ZodOptional<z.ZodString>;
     assetId: z.ZodString;
     styleId: z.ZodString;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
     expectedSha256: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     styleId: string;
@@ -19564,9 +19639,7 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     project?: string | undefined;
 }>, z.ZodObject<{
     action: z.ZodLiteral<"patch-style">;
-    project: z.ZodOptional<z.ZodString>;
     styleId: z.ZodString;
-    expectedSha256: z.ZodString;
     patch: z.ZodEffects<z.ZodObject<{
         /** Candidates per generation, written to the provider's own option. */
         candidates: z.ZodOptional<z.ZodNumber>;
@@ -19614,6 +19687,11 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
         noBackground?: boolean | null | undefined;
         enforcePalette?: boolean | undefined;
     }>;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
+    expectedSha256: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     styleId: string;
     action: "patch-style";
@@ -19642,80 +19720,1613 @@ declare const ManifestEditSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject
     };
     expectedSha256: string;
     project?: string | undefined;
-}>]>;
-type ManifestEdit = z.infer<typeof ManifestEditSchema>;
-/** The page showed a manifest that has since changed; the write is refused. */
-declare class ManifestDriftError extends Error {
-    readonly status = 409;
-    constructor(manifestPath: string);
-}
-/** A request the schema or the manifest rules reject; nothing was written. */
-declare class ManifestEditError extends Error {
-    readonly status = 400;
-    constructor(message: string);
-}
-interface ManifestEditResult {
-    manifestPath: string;
-    /** Hash of the manifest after the write, for the next edit's `expectedSha256`. */
-    sha256: string;
-    changed: boolean;
-}
-/**
- * Apply one edit to the manifest on disk. The write is refused when the file
- * no longer matches what the page saw, and rolled back when the edited
- * manifest fails to load or resolve; an invalid manifest never lands.
- */
-declare function applyManifestEdit(manifestPath: string, edit: ManifestEdit): Promise<ManifestEditResult>;
-
-interface GalleryEditHandlerOptions {
-    /** Resolves the manifest an edit may rewrite; must never trust a client path. */
-    manifestFor: (project?: string) => string | Promise<string>;
-    /** Rebuilds the gallery after a successful write. */
-    reload: () => Promise<GalleryBuild>;
-    /** Loads a project for hand-edit actions, which need resolved specs and the lock. */
-    loadProject?: (project?: string) => Promise<GalleryProjectContext>;
-    /** Launches the author's editor; defaults to `openInEditor`. */
-    openEditor?: (file: string) => string;
-    onProgress?: (msg: string) => void;
-}
-/** The `edit` callback `serveGallery` expects: validate, apply, rebuild. */
-declare function createGalleryEditHandler(opts: GalleryEditHandlerOptions): (body: unknown) => Promise<GalleryBuild>;
-
-/**
- * Estimates this gallery session has made, against its cap, and what
- * PixelLab reported billing for them, in whatever unit each response named.
- * Kept apart from the generation budget: PixelLab documents this endpoint in
- * dollars, and dollars do not convert to generations.
- */
-interface SkeletonEstimateSession {
-    used: number;
-    limit: number;
-    spent: Record<string, number>;
-}
-interface GallerySkeletonHandlers {
-    estimate(body: unknown): Promise<{
-        set: SkeletonSet;
-        source: string;
-        session: SkeletonEstimateSession;
-    }>;
-    status(): SkeletonEstimateSession;
-}
-
-/**
- * The gallery's HTTP surface. Unlike the review server this is long-lived:
- * three GET routes, bound to loopback, running until the caller closes it
- * (the CLI does so on Ctrl+C). It has no write path unless the caller opts
- * in: `edit` adds one POST route for manifest edits, `generate` adds the
- * routes that start a generation job and host its review sheet, and `editor`
- * adds the routes that install and serve the in-browser pixel editor.
- *
- * Every POST is guarded twice, because a page on localhost is reachable by
- * every other page in the browser: the request's Origin must be this server,
- * and it must carry the session token minted at startup, which only the
- * served page knows. A cross-origin page can neither read the token nor send
- * the custom header without a preflight this server refuses.
- *
- * The snapshot is rebuilt on every page load and every `/api/gallery.json`
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"add-style">;
+    styleId: z.ZodString;
+    style: z.ZodObject<{
+        generator: z.ZodEnum<["character", "objectPro"]>;
+        /** Where the style's art is written, inside the project. */
+        outDir: z.ZodEffects<z.ZodString, string, string>;
+        size: z.ZodOptional<z.ZodNumber>;
+        mode: z.ZodOptional<z.ZodEnum<["standard", "v3", "pro", "pro-flash"]>>;
+        directions: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<4>, z.ZodLiteral<8>]>>;
+        template: z.ZodOptional<z.ZodString>;
+        view: z.ZodOptional<z.ZodString>;
+        proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
+            headSize: z.ZodOptional<z.ZodNumber>;
+            armsLength: z.ZodOptional<z.ZodNumber>;
+            legsLength: z.ZodOptional<z.ZodNumber>;
+            shoulderWidth: z.ZodOptional<z.ZodNumber>;
+            hipWidth: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        }, {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        }>]>>;
+        isometric: z.ZodOptional<z.ZodBoolean>;
+        textGuidanceScale: z.ZodOptional<z.ZodNumber>;
+        enhancePrompt: z.ZodOptional<z.ZodBoolean>;
+        promptPrefix: z.ZodOptional<z.ZodString>;
+        promptSuffix: z.ZodOptional<z.ZodString>;
+        palette: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        outDir: string;
+        generator: "character" | "objectPro";
+        palette?: string[] | undefined;
+        template?: string | undefined;
+        size?: number | undefined;
+        directions?: 4 | 8 | undefined;
+        mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+        enhancePrompt?: boolean | undefined;
+        view?: string | undefined;
+        promptSuffix?: string | undefined;
+        promptPrefix?: string | undefined;
+        isometric?: boolean | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        textGuidanceScale?: number | undefined;
+    }, {
+        outDir: string;
+        generator: "character" | "objectPro";
+        palette?: string[] | undefined;
+        template?: string | undefined;
+        size?: number | undefined;
+        directions?: 4 | 8 | undefined;
+        mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+        enhancePrompt?: boolean | undefined;
+        view?: string | undefined;
+        promptSuffix?: string | undefined;
+        promptPrefix?: string | undefined;
+        isometric?: boolean | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        textGuidanceScale?: number | undefined;
+    }>;
+} & {
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
+    expectedSha256: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    styleId: string;
+    action: "add-style";
+    style: {
+        outDir: string;
+        generator: "character" | "objectPro";
+        palette?: string[] | undefined;
+        template?: string | undefined;
+        size?: number | undefined;
+        directions?: 4 | 8 | undefined;
+        mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+        enhancePrompt?: boolean | undefined;
+        view?: string | undefined;
+        promptSuffix?: string | undefined;
+        promptPrefix?: string | undefined;
+        isometric?: boolean | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        textGuidanceScale?: number | undefined;
+    };
+    expectedSha256: string;
+    project?: string | undefined;
+}, {
+    styleId: string;
+    action: "add-style";
+    style: {
+        outDir: string;
+        generator: "character" | "objectPro";
+        palette?: string[] | undefined;
+        template?: string | undefined;
+        size?: number | undefined;
+        directions?: 4 | 8 | undefined;
+        mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+        enhancePrompt?: boolean | undefined;
+        view?: string | undefined;
+        promptSuffix?: string | undefined;
+        promptPrefix?: string | undefined;
+        isometric?: boolean | undefined;
+        proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+            headSize?: number | undefined;
+            armsLength?: number | undefined;
+            legsLength?: number | undefined;
+            shoulderWidth?: number | undefined;
+            hipWidth?: number | undefined;
+        } | undefined;
+        textGuidanceScale?: number | undefined;
+    };
+    expectedSha256: string;
+    project?: string | undefined;
+}>, z.ZodObject<{
+    edits: z.ZodArray<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+        action: z.ZodLiteral<"patch-asset">;
+        assetId: z.ZodString;
+        patch: z.ZodObject<{
+            prompt: z.ZodOptional<z.ZodString>;
+            /** Per-style override for the style being viewed; null removes it. */
+            promptForStyle: z.ZodOptional<z.ZodObject<{
+                styleId: z.ZodString;
+                prompt: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                prompt: string | null;
+                styleId: string;
+            }, {
+                prompt: string | null;
+                styleId: string;
+            }>>;
+            category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        }, {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        assetId: string;
+        action: "patch-asset";
+        patch: {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        };
+    }, {
+        assetId: string;
+        action: "patch-asset";
+        patch: {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        };
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"add-asset">;
+        assetId: z.ZodString;
+        asset: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            /** A portrait, an outfit, or a mirror has none of its own; the loader says where one is needed. */
+            prompt: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodString>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            size: z.ZodOptional<z.ZodNumber>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** Restrict to these styles; empty or omitted means every style. */
+            styles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * A controlled regeneration of another asset in the same manifest,
+             * instead of a fresh generation. `inpaint` needs a mask upload the
+             * gallery does not offer yet, so only `image-to-image` and
+             * `animate-skeleton` (whose keypoints file the gallery writes first) can
+             * be created here; hand-edit the manifest for the other modes.
+             */
+            revision: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+                mode: z.ZodLiteral<"image-to-image">;
+                /** Asset id of the parent this revises; must already exist. */
+                from: z.ZodString;
+                strength: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            }, {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            }>, z.ZodObject<{
+                mode: z.ZodLiteral<"animate-skeleton">;
+                from: z.ZodString;
+                /** Manifest-relative; checked when the manifest is loaded, like every revision input. */
+                keypointsFile: z.ZodString;
+                direction: z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>;
+                description: z.ZodOptional<z.ZodString>;
+                skeletonTemplate: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            }, {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            }>]>>;
+            /** A pose or outfit of an existing `character`/`objectPro` base or state. */
+            state: z.ZodOptional<z.ZodObject<{
+                /** Asset id of the parent this states; must already exist. */
+                of: z.ZodString;
+                paletteFromReference: z.ZodOptional<z.ZodBoolean>;
+                canvas: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, "strict", z.ZodTypeAny, {
+                    width: number;
+                    height: number;
+                }, {
+                    width: number;
+                    height: number;
+                }>>;
+            }, "strict", z.ZodTypeAny, {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            }, {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            }>>;
+            /** A loop of an existing `character`/`objectPro` base or state. */
+            animation: z.ZodOptional<z.ZodObject<{
+                /** Asset id of the parent this animates; must already exist. */
+                of: z.ZodString;
+                /** A PixelLab template id (`character` only; `objectPro` has no template concept). */
+                template: z.ZodOptional<z.ZodString>;
+                direction: z.ZodOptional<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>>;
+                frames: z.ZodOptional<z.ZodNumber>;
+                fps: z.ZodOptional<z.ZodNumber>;
+                /** One loop per named direction, plus free mirrors; expanded when the manifest loads. */
+                directions: z.ZodOptional<z.ZodArray<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>, "many">>;
+                mode: z.ZodOptional<z.ZodEnum<["template", "skeleton-v3", "v3", "pro"]>>;
+                /** What is being animated, when the parent's own description would mislead the model (`character` only). */
+                subject: z.ZodOptional<z.ZodString>;
+                enhancePrompt: z.ZodOptional<z.ZodBoolean>;
+            }, "strict", z.ZodTypeAny, {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            }, {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            }>>;
+            /** A bust of an existing character. */
+            portrait: z.ZodOptional<z.ZodObject<{
+                of: z.ZodString;
+                size: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<16>, z.ZodLiteral<32>, z.ZodLiteral<48>, z.ZodLiteral<64>, z.ZodLiteral<128>, z.ZodLiteral<160>]>>;
+            }, "strict", z.ZodTypeAny, {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            }, {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            }>>;
+            /** An existing loop re-clothed from a reference image (uploaded first). */
+            outfit: z.ZodOptional<z.ZodObject<{
+                of: z.ZodString;
+                reference: z.ZodString;
+                additionalInstructions: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            }, {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            }>>;
+            /** Another asset of the same style, flipped; free. */
+            mirror: z.ZodOptional<z.ZodString>;
+            /**
+             * `character`/`objectPro` bases: the subject's own sprite (uploaded
+             * first), or one per direction, which PixelLab rotates instead of drawing.
+             */
+            reference: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodEnum<["south", "south-east", "east", "north-east", "north", "north-west", "west", "south-west"]>, z.ZodString>]>>;
+            /** `character` pro bases: a concept image that seeds the design. */
+            concept: z.ZodOptional<z.ZodString>;
+            /** `character` pro bases: another character in the style whose look this one follows. */
+            styleCharacter: z.ZodOptional<z.ZodString>;
+            /** `character` standard humanoid bases: this character's proportions, over the style's. */
+            proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
+                headSize: z.ZodOptional<z.ZodNumber>;
+                armsLength: z.ZodOptional<z.ZodNumber>;
+                legsLength: z.ZodOptional<z.ZodNumber>;
+                shoulderWidth: z.ZodOptional<z.ZodNumber>;
+                hipWidth: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            }, {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            }>]>>;
+        }, "strict", z.ZodTypeAny, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }>, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }>, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }, {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        assetId: string;
+        action: "add-asset";
+        asset: {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        };
+    }, {
+        assetId: string;
+        action: "add-asset";
+        asset: {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        };
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"set-source">;
+        assetId: z.ZodString;
+        styleId: z.ZodString;
+        /** Manifest-relative path of the art that stands in for this asset in this style. */
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        styleId: string;
+        assetId: string;
+        action: "set-source";
+    }, {
+        source: string;
+        styleId: string;
+        assetId: string;
+        action: "set-source";
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"clear-source">;
+        assetId: z.ZodString;
+        styleId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        styleId: string;
+        assetId: string;
+        action: "clear-source";
+    }, {
+        styleId: string;
+        assetId: string;
+        action: "clear-source";
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"patch-style">;
+        styleId: z.ZodString;
+        patch: z.ZodEffects<z.ZodObject<{
+            /** Candidates per generation, written to the provider's own option. */
+            candidates: z.ZodOptional<z.ZodNumber>;
+            /** Empty clears the style's own value (inherit, or the default). */
+            promptPrefix: z.ZodOptional<z.ZodString>;
+            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. */
+            noBackground: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        }, {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        }>, {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        }, {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        styleId: string;
+        action: "patch-style";
+        patch: {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        };
+    }, {
+        styleId: string;
+        action: "patch-style";
+        patch: {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        };
+    }>, z.ZodObject<{
+        action: z.ZodLiteral<"add-style">;
+        styleId: z.ZodString;
+        style: z.ZodObject<{
+            generator: z.ZodEnum<["character", "objectPro"]>;
+            /** Where the style's art is written, inside the project. */
+            outDir: z.ZodEffects<z.ZodString, string, string>;
+            size: z.ZodOptional<z.ZodNumber>;
+            mode: z.ZodOptional<z.ZodEnum<["standard", "v3", "pro", "pro-flash"]>>;
+            directions: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<4>, z.ZodLiteral<8>]>>;
+            template: z.ZodOptional<z.ZodString>;
+            view: z.ZodOptional<z.ZodString>;
+            proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
+                headSize: z.ZodOptional<z.ZodNumber>;
+                armsLength: z.ZodOptional<z.ZodNumber>;
+                legsLength: z.ZodOptional<z.ZodNumber>;
+                shoulderWidth: z.ZodOptional<z.ZodNumber>;
+                hipWidth: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            }, {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            }>]>>;
+            isometric: z.ZodOptional<z.ZodBoolean>;
+            textGuidanceScale: z.ZodOptional<z.ZodNumber>;
+            enhancePrompt: z.ZodOptional<z.ZodBoolean>;
+            promptPrefix: z.ZodOptional<z.ZodString>;
+            promptSuffix: z.ZodOptional<z.ZodString>;
+            palette: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        }, {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        styleId: string;
+        action: "add-style";
+        style: {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        };
+    }, {
+        styleId: string;
+        action: "add-style";
+        style: {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        };
+    }>]>, "many">;
+    /** Workspace project id; omitted for a single-project gallery. */
+    project: z.ZodOptional<z.ZodString>;
+    /** Manifest bytes the page last saw; a mismatch refuses the write. */
+    expectedSha256: z.ZodString;
+    action: z.ZodLiteral<"batch">;
+}, "strict", z.ZodTypeAny, {
+    action: "batch";
+    expectedSha256: string;
+    edits: ({
+        assetId: string;
+        action: "patch-asset";
+        patch: {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        };
+    } | {
+        assetId: string;
+        action: "add-asset";
+        asset: {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size: 16 | 32 | 64 | 128 | 48 | 160;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        };
+    } | {
+        source: string;
+        styleId: string;
+        assetId: string;
+        action: "set-source";
+    } | {
+        styleId: string;
+        assetId: string;
+        action: "clear-source";
+    } | {
+        styleId: string;
+        action: "patch-style";
+        patch: {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        };
+    } | {
+        styleId: string;
+        action: "add-style";
+        style: {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        };
+    })[];
+    project?: string | undefined;
+}, {
+    action: "batch";
+    expectedSha256: string;
+    edits: ({
+        assetId: string;
+        action: "patch-asset";
+        patch: {
+            width?: number | null | undefined;
+            height?: number | null | undefined;
+            size?: number | null | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | null | undefined;
+            promptForStyle?: {
+                prompt: string | null;
+                styleId: string;
+            } | undefined;
+        };
+    } | {
+        assetId: string;
+        action: "add-asset";
+        asset: {
+            width?: number | undefined;
+            height?: number | undefined;
+            animation?: {
+                of: string;
+                frames?: number | undefined;
+                fps?: number | undefined;
+                template?: string | undefined;
+                direction?: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west" | undefined;
+                directions?: ("south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west")[] | undefined;
+                mode?: "v3" | "pro" | "template" | "skeleton-v3" | undefined;
+                subject?: string | undefined;
+                enhancePrompt?: boolean | undefined;
+            } | undefined;
+            size?: number | undefined;
+            reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
+            state?: {
+                of: string;
+                paletteFromReference?: boolean | undefined;
+                canvas?: {
+                    width: number;
+                    height: number;
+                } | undefined;
+            } | undefined;
+            portrait?: {
+                of: string;
+                size?: 16 | 32 | 64 | 128 | 48 | 160 | undefined;
+            } | undefined;
+            outfit?: {
+                of: string;
+                reference: string;
+                additionalInstructions?: string | undefined;
+            } | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            styleCharacter?: string | undefined;
+            tags?: string[] | undefined;
+            prompt?: string | undefined;
+            category?: string | undefined;
+            revision?: {
+                mode: "image-to-image";
+                from: string;
+                strength?: number | undefined;
+            } | {
+                direction: "south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west";
+                mode: "animate-skeleton";
+                from: string;
+                keypointsFile: string;
+                skeletonTemplate?: string | undefined;
+                description?: string | undefined;
+            } | undefined;
+            concept?: string | undefined;
+            mirror?: string | undefined;
+            styles?: string[] | undefined;
+        };
+    } | {
+        source: string;
+        styleId: string;
+        assetId: string;
+        action: "set-source";
+    } | {
+        styleId: string;
+        assetId: string;
+        action: "clear-source";
+    } | {
+        styleId: string;
+        action: "patch-style";
+        patch: {
+            candidates?: number | undefined;
+            palette?: string[] | null | undefined;
+            view?: string | null | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            noBackground?: boolean | null | undefined;
+            enforcePalette?: boolean | undefined;
+        };
+    } | {
+        styleId: string;
+        action: "add-style";
+        style: {
+            outDir: string;
+            generator: "character" | "objectPro";
+            palette?: string[] | undefined;
+            template?: string | undefined;
+            size?: number | undefined;
+            directions?: 4 | 8 | undefined;
+            mode?: "standard" | "v3" | "pro" | "pro-flash" | undefined;
+            enhancePrompt?: boolean | undefined;
+            view?: string | undefined;
+            promptSuffix?: string | undefined;
+            promptPrefix?: string | undefined;
+            isometric?: boolean | undefined;
+            proportions?: "default" | "chibi" | "cartoon" | "stylized" | "realistic_male" | "realistic_female" | "heroic" | {
+                headSize?: number | undefined;
+                armsLength?: number | undefined;
+                legsLength?: number | undefined;
+                shoulderWidth?: number | undefined;
+                hipWidth?: number | undefined;
+            } | undefined;
+            textGuidanceScale?: number | undefined;
+        };
+    })[];
+    project?: string | undefined;
+}>]>;
+type ManifestEdit = z.infer<typeof ManifestEditSchema>;
+/** The page showed a manifest that has since changed; the write is refused. */
+declare class ManifestDriftError extends Error {
+    readonly status = 409;
+    constructor(manifestPath: string);
+}
+/** A request the schema or the manifest rules reject; nothing was written. */
+declare class ManifestEditError extends Error {
+    readonly status = 400;
+    constructor(message: string);
+}
+interface ManifestEditResult {
+    manifestPath: string;
+    /** Hash of the manifest after the write, for the next edit's `expectedSha256`. */
+    sha256: string;
+    changed: boolean;
+}
+/**
+ * Apply one edit to the manifest on disk. The write is refused when the file
+ * no longer matches what the page saw, and rolled back when the edited
+ * manifest fails to load or resolve; an invalid manifest never lands.
+ */
+declare function applyManifestEdit(manifestPath: string, edit: ManifestEdit): Promise<ManifestEditResult>;
+
+/**
+ * Generation from the gallery is the CLI's `gen`, run as a background job:
+ * the same `buildPlan`, the same per-provider budget and balance preflight,
+ * the same `submit → poll → fetch` library calls writing the same lockfile.
+ * The page adds nothing the terminal cannot do; it only shows the estimate,
+ * asks, and reports progress.
+ *
+ * Two ceilings guard spend. The session budget is passed when the gallery
+ * starts (`--budget`, optionally keyed per provider) and every job's estimate
+ * is charged against it up front, so the page can never exceed what the
+ * person typed. Each submission also carries the remaining ceiling as its
+ * own `budget`, the way `gen --budget` does, so a provider estimate that
+ * grows between plan and submit is refused rather than paid.
+ */
+type GeneratePhase = "queued" | "submitting" | "polling" | "fetching" | "review" | "done" | "failed";
+interface GenerateJob {
+    id: string;
+    project: string | null;
+    keys: string[];
+    /**
+     * `resume` skips submission: poll, review, and fetch existing work at no
+     * cost; `refresh` re-pulls changed objects; `restore` puts the recorded
+     * bytes back on disk from the cache or the provider, as `pixelkiln restore`.
+     */
+    mode: "generate" | "resume" | "refresh" | "restore" | "revert";
+    /** The job may replace a locally modified or untracked file, as `--force` does. */
+    force: boolean;
+    /** For `revert`: which replaced generation, as the request named it. */
+    revert: string | null;
+    phase: GeneratePhase;
+    startedAt: string;
+    finishedAt: string | null;
+    /** Progress lines, exactly what the CLI would have printed. */
+    messages: string[];
+    error: string | null;
+    /** Successful-submission estimates this job charged, by provider. */
+    spent: Record<string, number>;
+    /** Keys still waiting for a human choice. */
+    review: string[];
+    counts: {
+        submitted: number;
+        failed: number;
+        downloaded: number;
+    };
+}
+interface GalleryProjectContext {
+    loaded: LoadedManifest;
+    /** Every spec the project declares, unfiltered. */
+    specs: ResolvedSpec[];
+    lock: Lock;
+    lockPath: string;
+}
+interface SessionBudget {
+    /** Unkeyed ceiling, valid only when a run involves a single provider. */
+    amount?: number;
+    /** Provider-keyed ceilings. */
+    byProvider: Record<string, number>;
+}
+interface GenerateHandlerOptions {
+    /** Load a project fresh from disk; `project` is the workspace id, if any. */
+    loadProject: (project?: string) => Promise<GalleryProjectContext>;
+    /** An online provider for a project; the caller owns env loading and caching. */
+    providerFor: (project: string | undefined, providerId: string) => Provider;
+    budget: SessionBudget;
+    reload: () => Promise<GalleryBuild>;
+    onProgress?: (msg: string) => void;
+    /** Test hooks. */
+    pollIntervalMs?: number;
+    submitSpacingMs?: number;
+    /** Deterministic clock hook. */
+    now?: () => Date;
+}
+interface GenerateStatus {
+    jobs: GenerateJob[];
+    budget: SessionBudget;
+    /** Estimates charged so far this session, by provider. */
+    spent: Record<string, number>;
+    /** Providers whose spend unit is known, for display. */
+    units: Record<string, CostUnit>;
+}
+interface GalleryGenerateHandlers {
+    start(body: unknown): Promise<GenerateJob>;
+    status(): GenerateStatus;
+    /** The embedded review sheet for a job's waiting keys; null when nothing waits. */
+    review(jobId: string, options: RenderSheetOptions & {
+        routePrefix: string;
+    }): Promise<ReviewSession | null>;
+    applyReview(jobId: string, body: unknown): Promise<PickResult>;
+}
+declare const GenerateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+    keys: z.ZodArray<z.ZodString, "many">;
+    /**
+     * Regenerate work that is up to date, as `gen --force` does, and let the
+     * fetch replace a locally modified or untracked file. With `restore`, put
+     * the recorded bytes back over a modified file.
+     */
+    force: z.ZodOptional<z.ZodBoolean>;
+    /** Advance in-flight, review, or selected work without submitting anything. */
+    resume: z.ZodOptional<z.ZodBoolean>;
+    /** Re-download downloaded outputs and replace files whose object changed upstream. */
+    refresh: z.ZodOptional<z.ZodBoolean>;
+    /** Put recorded outputs back on disk from the cache or the provider, without generating. */
+    restore: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Bring a replaced generation back: 1-based position in the record's
+     * history (newest first) or an output hash prefix. One key at a time.
+     */
+    revert: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}>, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}>, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}, {
+    keys: string[];
+    project?: string | undefined;
+    resume?: boolean | undefined;
+    force?: boolean | undefined;
+    refresh?: boolean | undefined;
+    restore?: boolean | undefined;
+    revert?: string | undefined;
+}>;
+declare class GenerateRequestError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+declare function createGenerateHandlers(opts: GenerateHandlerOptions): GalleryGenerateHandlers;
+
+interface GalleryEditHandlerOptions {
+    /** Resolves the manifest an edit may rewrite; must never trust a client path. */
+    manifestFor: (project?: string) => string | Promise<string>;
+    /** Rebuilds the gallery after a successful write. */
+    reload: () => Promise<GalleryBuild>;
+    /** Loads a project for hand-edit actions, which need resolved specs and the lock. */
+    loadProject?: (project?: string) => Promise<GalleryProjectContext>;
+    /** Launches the author's editor; defaults to `openInEditor`. */
+    openEditor?: (file: string) => string;
+    onProgress?: (msg: string) => void;
+}
+/** The `edit` callback `serveGallery` expects: validate, apply, rebuild. */
+declare function createGalleryEditHandler(opts: GalleryEditHandlerOptions): (body: unknown) => Promise<GalleryBuild>;
+
+/**
+ * Estimates this gallery session has made, against its cap, and what
+ * PixelLab reported billing for them, in whatever unit each response named.
+ * Kept apart from the generation budget: PixelLab documents this endpoint in
+ * dollars, and dollars do not convert to generations.
+ */
+interface SkeletonEstimateSession {
+    used: number;
+    limit: number;
+    spent: Record<string, number>;
+}
+interface GallerySkeletonHandlers {
+    estimate(body: unknown): Promise<{
+        set: SkeletonSet;
+        source: string;
+        session: SkeletonEstimateSession;
+    }>;
+    status(): SkeletonEstimateSession;
+}
+
+/**
+ * The gallery's HTTP surface. Unlike the review server this is long-lived:
+ * three GET routes, bound to loopback, running until the caller closes it
+ * (the CLI does so on Ctrl+C). It has no write path unless the caller opts
+ * in: `edit` adds one POST route for manifest edits, `generate` adds the
+ * routes that start a generation job and host its review sheet, and `editor`
+ * adds the routes that install and serve the in-browser pixel editor.
+ *
+ * Every POST is guarded twice, because a page on localhost is reachable by
+ * every other page in the browser: the request's Origin must be this server,
+ * and it must carry the session token minted at startup, which only the
+ * served page knows. A cross-origin page can neither read the token nor send
+ * the custom header without a preflight this server refuses.
+ *
+ * The snapshot is rebuilt on every page load and every `/api/gallery.json`
  * request, and the media allowlist is replaced with it, so the page's Refresh
  * button shows a `gen` that finished in another terminal, including files
  * that did not exist when the server started. Only paths the current
@@ -19747,6 +21358,12 @@ interface GalleryServerOptions {
      * `/editor/<release>/<file>` routes that serve the pinned editor build.
      */
     editor?: GalleryEditorHandlers;
+    /**
+     * Enable `POST /api/price`: an unsaved edit priced offline, nothing
+     * written. Follows the write gate because it reads the manifest the way
+     * a save would.
+     */
+    price?: (body: unknown) => Promise<unknown>;
     /** Enable `POST /api/skeleton/estimate` (a direct PixelLab call the page confirms first) and `GET /api/skeleton`, its session count. */
     skeleton?: GallerySkeletonHandlers;
 }