pixelkiln 0.87.0 → 0.88.0

package/dist/index.d.cts

@@ -172,6 +172,12 @@ interface SubmitContext {
      * PixelLab would otherwise skip) reads its ids from here.
      */
     replacedMetadata?: ProviderMetadata;
+    /**
+     * Provider-owned details of this asset's newest downloaded generation,
+     * current or retired to history. Unlike `replacedMetadata` it survives a
+     * failed attempt in between, which leaves the entry it replaces empty.
+     */
+    lastGenerationMetadata?: ProviderMetadata;
 }
 interface CandidateSelection {
     objectId: string;
@@ -578,7 +584,7 @@ type SkeletonSet = z.infer<typeof SkeletonSetSchema>;
  *   parameter on /map-objects returns a 500, so the palette lock is
  *   pixflux-only. Its rendering is flatter than 1dir's.
  */
-declare const GeneratorSchema: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+declare const GeneratorSchema: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
 type Generator = z.infer<typeof GeneratorSchema>;
 declare const GridConfidenceSchema: z.ZodEnum<["low", "medium", "high"]>;
 type GridConfidence = z.infer<typeof GridConfidenceSchema>;
@@ -1110,6 +1116,74 @@ declare const MapSceneSchema: z.ZodObject<{
     } | undefined;
 }>;
 type MapScene = z.infer<typeof MapSceneSchema>;
+/** One part added to a `vfx` effect: the part's name plus its placement and slider options, sent as given. */
+declare const VfxPartSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    name: z.ZodString;
+}, z.ZodUnknown, "strip">>;
+/**
+ * `vfx` assets only: an animated effect rendered by PixelLab's VFX workbench.
+ * Start from a whole-effect `preset` or a `recipe` file (a bare recipe or a
+ * `.vfx.json` record from `pixelkiln vfx`), not both, and add `parts` on
+ * top; parts alone also start an effect. `sprite` is the character the
+ * effect is built around: a manifest-relative PNG or JPEG (any earlier
+ * asset's output file works) or a PixelLab reference. `name` is the effect's
+ * name in the account's My effects and is not part of its identity.
+ */
+declare const AssetVfxSchema: z.ZodEffects<z.ZodObject<{
+    preset: z.ZodOptional<z.ZodString>;
+    recipe: z.ZodOptional<z.ZodString>;
+    parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">>, "many">>;
+    sprite: z.ZodOptional<z.ZodString>;
+    fps: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    fps?: number | undefined;
+    name?: string | undefined;
+    preset?: string | undefined;
+    recipe?: string | undefined;
+    parts?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    sprite?: string | undefined;
+}, {
+    fps?: number | undefined;
+    name?: string | undefined;
+    preset?: string | undefined;
+    recipe?: string | undefined;
+    parts?: z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    sprite?: string | undefined;
+}>, {
+    fps?: number | undefined;
+    name?: string | undefined;
+    preset?: string | undefined;
+    recipe?: string | undefined;
+    parts?: z.objectOutputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    sprite?: string | undefined;
+}, {
+    fps?: number | undefined;
+    name?: string | undefined;
+    preset?: string | undefined;
+    recipe?: string | undefined;
+    parts?: z.objectInputType<{
+        name: z.ZodString;
+    }, z.ZodUnknown, "strip">[] | undefined;
+    sprite?: string | undefined;
+}>;
+type AssetVfx = z.infer<typeof AssetVfxSchema>;
 /** Applies a reference outfit to an existing loop's frames (PixelLab's `transfer-outfit-v2`). */
 declare const CharacterOutfitSchema: z.ZodObject<{
     /** The loop (a character animation asset) to re-clothe, in the same style. */
@@ -1632,7 +1706,7 @@ interface ResolvedRevision {
 declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     /** Generation backend for this style. Omit to inherit the manifest default. */
     provider: z.ZodOptional<z.ZodString>;
-    generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>;
+    generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>;
     /** Square edge length. The active provider owns its exact limit. */
     size: z.ZodOptional<z.ZodNumber>;
     view: z.ZodOptional<z.ZodString>;
@@ -2003,7 +2077,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -2095,7 +2169,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -2169,7 +2243,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
 }>, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -2261,7 +2335,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -2335,7 +2409,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
 }>, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -2427,7 +2501,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -2505,7 +2579,7 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
  */
 declare const InheritedStyleSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-    generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>>;
+    generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>>;
     size: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     view: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     promptSuffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
@@ -2661,7 +2735,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -2745,7 +2819,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -2820,7 +2894,7 @@ declare const InheritedStyleSchema: z.ZodObject<{
 declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObject<{
     /** Generation backend for this style. Omit to inherit the manifest default. */
     provider: z.ZodOptional<z.ZodString>;
-    generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>;
+    generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>;
     /** Square edge length. The active provider owns its exact limit. */
     size: z.ZodOptional<z.ZodNumber>;
     view: z.ZodOptional<z.ZodString>;
@@ -3191,7 +3265,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -3283,7 +3357,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -3357,7 +3431,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }>, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -3449,7 +3523,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -3523,7 +3597,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }>, {
     outDir: string;
     palette: string[];
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     promptSuffix: string;
     promptPrefix: string;
     styleImages: {
@@ -3615,7 +3689,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -3688,7 +3762,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     providerOptions?: Record<string, Record<string, unknown>> | undefined;
 }>, z.ZodObject<{
     provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-    generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>>;
+    generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>>;
     size: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     view: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     promptSuffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
@@ -3844,7 +3918,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -3928,7 +4002,7 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     shading?: string | undefined;
     detail?: string | undefined;
     enhancePrompt?: boolean | undefined;
-    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+    generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
     view?: string | undefined;
     promptSuffix?: string | undefined;
     promptPrefix?: string | undefined;
@@ -4566,6 +4640,57 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
             mask: string;
         } | undefined;
     }>>;
+    /** `vfx` styles only: the effect to render. See `AssetVfxSchema`. */
+    vfx: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodString>;
+        recipe: z.ZodOptional<z.ZodString>;
+        parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+        }, "strip", z.ZodUnknown, z.objectOutputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">, z.objectInputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">>, "many">>;
+        sprite: z.ZodOptional<z.ZodString>;
+        fps: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectOutputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    }, {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectInputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    }>, {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectOutputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    }, {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectInputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    }>>;
     /** `character` styles, `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>;
@@ -4672,6 +4797,16 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
     } | undefined;
+    vfx?: {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectOutputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    } | undefined;
     size?: number | undefined;
     reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
     state?: {
@@ -4793,6 +4928,16 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
     } | undefined;
+    vfx?: {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectInputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    } | undefined;
     size?: number | undefined;
     reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
     state?: {
@@ -4924,6 +5069,16 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
     } | undefined;
+    vfx?: {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectOutputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    } | undefined;
     size?: number | undefined;
     reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
     state?: {
@@ -5045,6 +5200,16 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
     } | undefined;
+    vfx?: {
+        fps?: number | undefined;
+        name?: string | undefined;
+        preset?: string | undefined;
+        recipe?: string | undefined;
+        parts?: z.objectInputType<{
+            name: z.ZodString;
+        }, z.ZodUnknown, "strip">[] | undefined;
+        sprite?: string | undefined;
+    } | undefined;
     size?: number | undefined;
     reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
     state?: {
@@ -5164,7 +5329,7 @@ declare const ManifestSchema: z.ZodObject<{
     styles: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodEffects<z.ZodObject<{
         /** Generation backend for this style. Omit to inherit the manifest default. */
         provider: z.ZodOptional<z.ZodString>;
-        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>;
+        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>;
         /** Square edge length. The active provider owns its exact limit. */
         size: z.ZodOptional<z.ZodNumber>;
         view: z.ZodOptional<z.ZodString>;
@@ -5535,7 +5700,7 @@ declare const ManifestSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -5627,7 +5792,7 @@ declare const ManifestSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -5701,7 +5866,7 @@ declare const ManifestSchema: z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -5793,7 +5958,7 @@ declare const ManifestSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -5867,7 +6032,7 @@ declare const ManifestSchema: z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -5959,7 +6124,7 @@ declare const ManifestSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -6596,6 +6761,57 @@ declare const ManifestSchema: z.ZodObject<{
                 mask: string;
             } | undefined;
         }>>;
+        /** `vfx` styles only: the effect to render. See `AssetVfxSchema`. */
+        vfx: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            preset: z.ZodOptional<z.ZodString>;
+            recipe: z.ZodOptional<z.ZodString>;
+            parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+            }, "strip", z.ZodUnknown, z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">, z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">>, "many">>;
+            sprite: z.ZodOptional<z.ZodString>;
+            fps: z.ZodOptional<z.ZodNumber>;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }>, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }>>;
         /** `character` styles, `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>;
@@ -6702,6 +6918,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -6823,6 +7049,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -6954,6 +7190,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -7075,6 +7321,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -7184,10 +7440,11 @@ declare const ManifestSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     provider: string;
+    name: string;
     styles: Record<string, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -7268,7 +7525,6 @@ declare const ManifestSchema: z.ZodObject<{
             base?: string | undefined;
         } | undefined;
     }>;
-    name: string;
     assets: Record<string, {
         tags: string[];
         sourceByStyle: Record<string, string>;
@@ -7294,6 +7550,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -7399,6 +7665,7 @@ declare const ManifestSchema: z.ZodObject<{
     $schema?: string | undefined;
     history?: number | undefined;
 }, {
+    name: string;
     styles: Record<string, {
         outDir: string;
         provider?: string | undefined;
@@ -7411,7 +7678,7 @@ declare const ManifestSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -7483,7 +7750,6 @@ declare const ManifestSchema: z.ZodObject<{
         tags?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     }>;
-    name: string;
     assets: Record<string, {
         width?: number | undefined;
         height?: number | undefined;
@@ -7504,6 +7770,16 @@ declare const ManifestSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -7624,7 +7900,7 @@ declare const ManifestInputSchema: z.ZodObject<{
     styles: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObject<{
         /** Generation backend for this style. Omit to inherit the manifest default. */
         provider: z.ZodOptional<z.ZodString>;
-        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>;
+        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>;
         /** Square edge length. The active provider owns its exact limit. */
         size: z.ZodOptional<z.ZodNumber>;
         view: z.ZodOptional<z.ZodString>;
@@ -7995,7 +8271,7 @@ declare const ManifestInputSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -8087,7 +8363,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -8161,7 +8437,7 @@ declare const ManifestInputSchema: z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -8253,7 +8529,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -8327,7 +8603,7 @@ declare const ManifestInputSchema: z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -8419,7 +8695,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -8492,7 +8768,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     }>, z.ZodObject<{
         provider: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>>;
+        generator: z.ZodOptional<z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>>;
         size: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         view: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         promptSuffix: z.ZodOptional<z.ZodDefault<z.ZodString>>;
@@ -8648,7 +8924,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -8732,7 +9008,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -9369,6 +9645,57 @@ declare const ManifestInputSchema: z.ZodObject<{
                 mask: string;
             } | undefined;
         }>>;
+        /** `vfx` styles only: the effect to render. See `AssetVfxSchema`. */
+        vfx: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            preset: z.ZodOptional<z.ZodString>;
+            recipe: z.ZodOptional<z.ZodString>;
+            parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+            }, "strip", z.ZodUnknown, z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">, z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">>, "many">>;
+            sprite: z.ZodOptional<z.ZodString>;
+            fps: z.ZodOptional<z.ZodNumber>;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }>, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }, {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        }>>;
         /** `character` styles, `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>;
@@ -9475,6 +9802,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -9596,6 +9933,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -9727,6 +10074,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -9848,6 +10205,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -9957,10 +10324,11 @@ declare const ManifestInputSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     provider: string;
+    name: string;
     styles: Record<string, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -10053,7 +10421,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -10125,7 +10493,6 @@ declare const ManifestInputSchema: z.ZodObject<{
         tags?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     }>;
-    name: string;
     assets: Record<string, {
         tags: string[];
         sourceByStyle: Record<string, string>;
@@ -10151,6 +10518,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectOutputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -10256,6 +10633,7 @@ declare const ManifestInputSchema: z.ZodObject<{
     $schema?: string | undefined;
     history?: number | undefined;
 }, {
+    name: string;
     styles: Record<string, {
         outDir: string;
         provider?: string | undefined;
@@ -10268,7 +10646,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -10352,7 +10730,7 @@ declare const ManifestInputSchema: z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -10424,7 +10802,6 @@ declare const ManifestInputSchema: z.ZodObject<{
         tags?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     }>;
-    name: string;
     assets: Record<string, {
         width?: number | undefined;
         height?: number | undefined;
@@ -10445,6 +10822,16 @@ declare const ManifestInputSchema: z.ZodObject<{
             detail?: string | undefined;
             enhancePrompt?: boolean | undefined;
         } | undefined;
+        vfx?: {
+            fps?: number | undefined;
+            name?: string | undefined;
+            preset?: string | undefined;
+            recipe?: string | undefined;
+            parts?: z.objectInputType<{
+                name: z.ZodString;
+            }, z.ZodUnknown, "strip">[] | undefined;
+            sprite?: string | undefined;
+        } | undefined;
         size?: number | undefined;
         reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
         state?: {
@@ -10602,7 +10989,7 @@ type Postprocess = z.infer<typeof PostprocessSchema>;
  */
 declare const LockHistoryEntrySchema: z.ZodObject<{
     specHash: z.ZodString;
-    generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+    generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
     tileFeature: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     prompt: z.ZodString;
     width: z.ZodNumber;
@@ -10699,7 +11086,7 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
     width: number;
     height: number;
     provider: string;
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     tileFeature: string | null;
     prompt: string;
     specHash: string;
@@ -10739,7 +11126,7 @@ declare const LockHistoryEntrySchema: z.ZodObject<{
 }, {
     width: number;
     height: number;
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     prompt: string;
     specHash: string;
     retiredAt: string;
@@ -10783,7 +11170,7 @@ declare const LockEntrySchema: z.ZodObject<{
     assetId: z.ZodString;
     /** sha256 of the resolved spec. Changing a prompt/size/style invalidates it. */
     specHash: z.ZodString;
-    generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+    generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
     /** Connectable tiles must remain multi-output even when polling is resumed later. */
     tileFeature: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     /** The resolved prompt actually sent, kept for auditing and for adopt matching. */
@@ -11020,7 +11407,7 @@ declare const LockEntrySchema: z.ZodObject<{
     /** Generations this entry replaced, newest first; see LockHistoryEntrySchema. */
     history: z.ZodOptional<z.ZodArray<z.ZodObject<{
         specHash: z.ZodString;
-        generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+        generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
         tileFeature: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         prompt: z.ZodString;
         width: z.ZodNumber;
@@ -11117,7 +11504,7 @@ declare const LockEntrySchema: z.ZodObject<{
         width: number;
         height: number;
         provider: string;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         tileFeature: string | null;
         prompt: string;
         specHash: string;
@@ -11157,7 +11544,7 @@ declare const LockEntrySchema: z.ZodObject<{
     }, {
         width: number;
         height: number;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         prompt: string;
         specHash: string;
         retiredAt: string;
@@ -11235,7 +11622,7 @@ declare const LockEntrySchema: z.ZodObject<{
         sourceSha256: string;
         referenceSha256: string;
     } | null;
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     tileFeature: string | null;
     prompt: string;
     revision: {
@@ -11306,7 +11693,7 @@ declare const LockEntrySchema: z.ZodObject<{
         width: number;
         height: number;
         provider: string;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         tileFeature: string | null;
         prompt: string;
         specHash: string;
@@ -11361,7 +11748,7 @@ declare const LockEntrySchema: z.ZodObject<{
 }, {
     width: number;
     height: number;
-    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+    generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
     prompt: string;
     specHash: string;
     styleId: string;
@@ -11411,7 +11798,7 @@ declare const LockEntrySchema: z.ZodObject<{
     history?: {
         width: number;
         height: number;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         prompt: string;
         specHash: string;
         retiredAt: string;
@@ -11499,7 +11886,7 @@ declare const LockSchema: z.ZodObject<{
         assetId: z.ZodString;
         /** sha256 of the resolved spec. Changing a prompt/size/style invalidates it. */
         specHash: z.ZodString;
-        generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+        generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
         /** Connectable tiles must remain multi-output even when polling is resumed later. */
         tileFeature: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         /** The resolved prompt actually sent, kept for auditing and for adopt matching. */
@@ -11736,7 +12123,7 @@ declare const LockSchema: z.ZodObject<{
         /** Generations this entry replaced, newest first; see LockHistoryEntrySchema. */
         history: z.ZodOptional<z.ZodArray<z.ZodObject<{
             specHash: z.ZodString;
-            generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>;
+            generator: z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>;
             tileFeature: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             prompt: z.ZodString;
             width: z.ZodNumber;
@@ -11833,7 +12220,7 @@ declare const LockSchema: z.ZodObject<{
             width: number;
             height: number;
             provider: string;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             tileFeature: string | null;
             prompt: string;
             specHash: string;
@@ -11873,7 +12260,7 @@ declare const LockSchema: z.ZodObject<{
         }, {
             width: number;
             height: number;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             prompt: string;
             specHash: string;
             retiredAt: string;
@@ -11951,7 +12338,7 @@ declare const LockSchema: z.ZodObject<{
             sourceSha256: string;
             referenceSha256: string;
         } | null;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         tileFeature: string | null;
         prompt: string;
         revision: {
@@ -12022,7 +12409,7 @@ declare const LockSchema: z.ZodObject<{
             width: number;
             height: number;
             provider: string;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             tileFeature: string | null;
             prompt: string;
             specHash: string;
@@ -12077,7 +12464,7 @@ declare const LockSchema: z.ZodObject<{
     }, {
         width: number;
         height: number;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         prompt: string;
         specHash: string;
         styleId: string;
@@ -12127,7 +12514,7 @@ declare const LockSchema: z.ZodObject<{
         history?: {
             width: number;
             height: number;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             prompt: string;
             specHash: string;
             retiredAt: string;
@@ -12219,7 +12606,7 @@ declare const LockSchema: z.ZodObject<{
             sourceSha256: string;
             referenceSha256: string;
         } | null;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         tileFeature: string | null;
         prompt: string;
         revision: {
@@ -12290,7 +12677,7 @@ declare const LockSchema: z.ZodObject<{
             width: number;
             height: number;
             provider: string;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             tileFeature: string | null;
             prompt: string;
             specHash: string;
@@ -12348,7 +12735,7 @@ declare const LockSchema: z.ZodObject<{
     entries: Record<string, {
         width: number;
         height: number;
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         prompt: string;
         specHash: string;
         styleId: string;
@@ -12398,7 +12785,7 @@ declare const LockSchema: z.ZodObject<{
         history?: {
             width: number;
             height: number;
-            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+            generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
             prompt: string;
             specHash: string;
             retiredAt: string;
@@ -12519,6 +12906,36 @@ interface ResolvedMapScene {
         height: number | null;
     };
 }
+/**
+ * A `vfx` effect as resolved for hashing and submission. The recipe is
+ * read and content-hashed; a local sprite carries its content hash, null
+ * until the file exists (it may be another asset's output), the way a
+ * scene's does.
+ */
+interface ResolvedVfx {
+    preset?: string;
+    recipe?: {
+        file: string;
+        sha256: string;
+        recipe: Record<string, unknown>;
+    };
+    parts?: Array<{
+        name: string;
+        [option: string]: unknown;
+    }>;
+    sprite?: {
+        file: string;
+        sha256: string | null;
+        width: number | null;
+        height: number | null;
+        format: "png" | "jpeg" | null;
+    } | {
+        reference: string;
+    };
+    fps?: number;
+    /** The name saved to My effects; not part of identity. */
+    name: string;
+}
 interface ResolvedMirror {
     sourceAssetId: string;
     sourceSpec: ResolvedSpec;
@@ -12577,6 +12994,8 @@ interface ResolvedSpec {
     batch?: ResolvedBatch;
     /** `map` only: the scene this object is drawn into, in that scene's style. */
     scene?: ResolvedMapScene;
+    /** `vfx` only: the effect to render. */
+    vfx?: ResolvedVfx;
     /** Provider-side id declared for adoption; excluded from the spec hash. */
     remoteId?: string;
     /**
@@ -13819,8 +14238,8 @@ declare class PixelLabClient {
     /**
      * `/image-to-pixelart-pro-flash`: a photo, painting, or render in, pixel
      * art out, with no size to pass: PixelLab detects the native pixel scale
-     * and picks the output size (a 256x256 render came back 108x109, on a
-     * transparent background). A flat 6 generations, billed exactly that live
+     * and picks the output size (a 256x256 render came back 108x109). The
+     * result is opaque, on a near-white background. A flat 6 generations, billed exactly that live
      * in October 2026. Sources over 2048px on the longer side are scaled down
      * upstream. The finished job carries the image at `last_response.images[0]`.
      */
@@ -14138,10 +14557,59 @@ declare function clientFromEnv(): PixelLabClient;
 declare function openExternal(target: string, command?: string[]): string;
 declare function defaultOpenCommand(platform?: NodeJS.Platform): string[];
 
+declare const PIXELLAB_MCP_URL = "https://api.pixellab.ai/mcp";
+interface McpImage {
+    mimeType: string;
+    /** Base64, as the server sends it. */
+    data: string;
+}
+interface McpToolResult {
+    /** Every text block of the reply, joined by newlines. */
+    text: string;
+    images: McpImage[];
+}
+/** The JSON-RPC message in a reply body, whether it came as plain JSON or as an SSE stream. */
+declare function parseMcpBody(body: string): Record<string, unknown>;
+/**
+ * A tool reply asking to be retried shortly. The VFX workbench answers
+ * "the pixel tools are busy. retry in a few seconds." while another render
+ * on the account is still running (seen live with two effects in one `gen`).
+ */
+declare function isBusyReply(text: string): boolean;
+declare class PixelLabMcpClient {
+    private readonly apiKey;
+    private readonly http;
+    private readonly url;
+    private readonly busyRetries;
+    private readonly sleep;
+    private nextId;
+    constructor(apiKey: string, opts?: {
+        url?: string;
+        timeoutMs?: number;
+        fetch?: typeof fetch;
+        busyRetries?: number;
+        sleep?: (ms: number) => Promise<void>;
+    });
+    /**
+     * Call one tool and return its text and images. A tool-level error
+     * (`isError`) throws with the tool's own message, after a few spaced
+     * retries when the tool only said it was busy.
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpToolResult>;
+    private callOnce;
+}
+declare function mcpClientFromEnv(): PixelLabMcpClient;
+
 declare class PixelLabProvider implements Provider {
     private readonly client;
+    private readonly mcp?;
     readonly id = "pixellab";
-    constructor(client: PixelLabClient);
+    /**
+     * `mcp` reaches the tools PixelLab offers only over MCP (the VFX
+     * workbench). Offline and download-only providers have none, and a `vfx`
+     * submission through one says so.
+     */
+    constructor(client: PixelLabClient, mcp?: Pick<PixelLabMcpClient, "callTool"> | undefined);
     static fromEnv(): PixelLabProvider;
     /** Public storage URLs and the local content cache do not require API auth. */
     static forDownloads(): PixelLabProvider;
@@ -14280,6 +14748,21 @@ declare class PixelLabProvider implements Provider {
      * background job to ask afterwards the way `billedForJob` does for async
      * work.
      */
+    /**
+     * Render a `vfx` asset with the VFX workbench, which is synchronous and
+     * free. The frames are cut from the exported sheet and parked in the
+     * cache like pixflux's bytes; the export's download folder is recorded so
+     * `poll` can cut them again if the cache is cleared.
+     *
+     * A regeneration exports over the effect this asset rendered last time, so
+     * My effects keeps one entry per asset, unless that effect has changed on
+     * pixellab.ai since (someone moved its sliders) or is gone. Then a new
+     * effect is saved and the edited one is left alone.
+     */
+    private submitVfx;
+    /** Cut an export's sheet into frames, with a sidecar `poll` reads without any lock metadata. */
+    private cacheVfxFrames;
+    private pollVfx;
     private pollCachedRevision;
     /**
      * `animate`/`animate-pixminimax` revisions: a plain background job, like
@@ -14783,6 +15266,14 @@ interface LoadedManifest {
     loopFamilies?: Record<string, string[]>;
 }
 declare function loadManifest(manifestPath: string): Promise<LoadedManifest>;
+/**
+ * Whether a style renders an asset. An asset that names its styles is in
+ * exactly those. One that names none joins every style of its own kind: a
+ * `vfx` style takes the assets that declare an effect, every other style the
+ * assets that do not, so a plain prompt never lands in an effects style and
+ * an effect never lands in an image style.
+ */
+declare function assetInStyle(asset: Pick<Asset, "styles" | "vfx">, styleId: string, style: Pick<Style, "generator"> | undefined): boolean;
 /** The asset this one is generated from, whichever shape declares it. */
 declare function parentAssetId(asset: Asset | undefined): string | undefined;
 /**
@@ -15070,6 +15561,11 @@ declare function resolveSpecOutputs(spec: ResolvedSpec, lock: Lock | undefined,
  * entry is not a frame set or recorded no rate.
  */
 declare function frameSetFps(entry: Pick<LockEntry, "provider" | "providerMetadata">): number | null;
+/**
+ * False when a frame-set entry recorded that it plays once (a one-shot
+ * effect); null when it recorded nothing, which every loop so far means.
+ */
+declare function frameSetLoop(entry: Pick<LockEntry, "provider" | "providerMetadata">): boolean | null;
 
 interface ArtifactFile {
     path: string;
@@ -15187,7 +15683,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     styleId: z.ZodString;
     style: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
-        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash"]>>;
+        generator: z.ZodDefault<z.ZodEnum<["1dir", "map", "pixflux", "tiles", "animation", "frames", "character", "terrain", "imagePro", "isometricTile", "objectPro", "uiAsset", "uiElement", "imageProFlash", "vfx"]>>;
         size: z.ZodOptional<z.ZodNumber>;
         view: z.ZodOptional<z.ZodString>;
         promptSuffix: z.ZodDefault<z.ZodString>;
@@ -15339,7 +15835,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -15431,7 +15927,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -15505,7 +16001,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -15597,7 +16093,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -15671,7 +16167,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     }>, {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -15763,7 +16259,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -16100,6 +16596,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         checks: z.ZodArray<z.ZodEnum<["prompt-coverage", "native-grid", "final-palette", "alpha-edge", "human-1x"]>, "many">;
         notes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
+        notes: string[];
         stage: "composition-source" | "production-candidate";
         workingCanvas: {
             width: number;
@@ -16115,7 +16612,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         };
         background: "opaque" | "transparent" | "full-bleed";
         checks: ("prompt-coverage" | "native-grid" | "final-palette" | "alpha-edge" | "human-1x")[];
-        notes: string[];
     }, {
         stage: "composition-source" | "production-candidate";
         workingCanvas: {
@@ -16149,6 +16645,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     provider: string;
     id: string;
     quality: {
+        notes: string[];
         stage: "composition-source" | "production-candidate";
         workingCanvas: {
             width: number;
@@ -16164,7 +16661,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         };
         background: "opaque" | "transparent" | "full-bleed";
         checks: ("prompt-coverage" | "native-grid" | "final-palette" | "alpha-edge" | "human-1x")[];
-        notes: string[];
     };
     styleId: string;
     version: string;
@@ -16188,7 +16684,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     style: {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -16351,7 +16847,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -16424,6 +16920,11 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     };
     $schema?: string | undefined;
+    files?: {
+        path: string;
+        sha256: string;
+        role: "reference" | "workflow";
+    }[] | undefined;
     workflow?: {
         path: string;
         outputNodeId: string;
@@ -16463,11 +16964,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         };
     } | undefined;
-    files?: {
-        path: string;
-        sha256: string;
-        role: "reference" | "workflow";
-    }[] | undefined;
     models?: {
         path: string;
         source: string;
@@ -16479,6 +16975,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     provider: string;
     id: string;
     quality: {
+        notes: string[];
         stage: "composition-source" | "production-candidate";
         workingCanvas: {
             width: number;
@@ -16494,7 +16991,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         };
         background: "opaque" | "transparent" | "full-bleed";
         checks: ("prompt-coverage" | "native-grid" | "final-palette" | "alpha-edge" | "human-1x")[];
-        notes: string[];
     };
     styleId: string;
     version: string;
@@ -16518,7 +17014,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     style: {
         outDir: string;
         palette: string[];
-        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash";
+        generator: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx";
         promptSuffix: string;
         promptPrefix: string;
         styleImages: {
@@ -16681,7 +17177,7 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         shading?: string | undefined;
         detail?: string | undefined;
         enhancePrompt?: boolean | undefined;
-        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | undefined;
+        generator?: "map" | "frames" | "1dir" | "pixflux" | "tiles" | "animation" | "character" | "terrain" | "imagePro" | "isometricTile" | "objectPro" | "uiAsset" | "uiElement" | "imageProFlash" | "vfx" | undefined;
         view?: string | undefined;
         promptSuffix?: string | undefined;
         promptPrefix?: string | undefined;
@@ -16754,6 +17250,11 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     };
     $schema?: string | undefined;
+    files?: {
+        path: string;
+        sha256: string;
+        role: "reference" | "workflow";
+    }[] | undefined;
     workflow?: {
         path: string;
         outputNodeId: string;
@@ -16793,11 +17294,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             } | undefined;
         };
     } | undefined;
-    files?: {
-        path: string;
-        sha256: string;
-        role: "reference" | "workflow";
-    }[] | undefined;
     models?: {
         path: string;
         source: string;
@@ -17273,12 +17769,199 @@ declare function defaultPixelateOut(input: string): string;
  * Convert a photo, painting, or render into pixel art with PixelLab's Image
  * to Pixel Art Pro Flash, wait for it, and write the PNG. PixelLab picks the
  * output size itself from the source's detected pixel scale, so there is no
- * size option; the result keeps a transparent background where the model
- * finds one. For art that is already pixel art and merely upscaled, use
+ * size option. The result is opaque, on a near-white background (measured
+ * on both live outputs; transparent source areas become white as well), so
+ * a cut-out sprite needs its background removed afterwards. For art that is
+ * already pixel art and merely upscaled, use
  * `unzoomFile` instead: it recovers the grid rather than redrawing.
  */
 declare function pixelateFile(client: Pick<PixelLabClient, "imageToPixelartProFlash" | "getBackgroundJob">, input: string, opts?: PixelateOptions): Promise<PixelateResult>;
 
+declare const VFX_TOOL = "vfx_workbench";
+/** Arguments for one `add_part`; `name` is the part (see `describeVfx("parts")`), the rest its placement and sliders. */
+interface VfxPart {
+    name: string;
+    [option: string]: unknown;
+}
+interface VfxExport {
+    effectId: string;
+    editUrl: string | null;
+    width: number;
+    height: number;
+    frames: number;
+    fps: number;
+    loop: boolean;
+    anchor: {
+        x: number;
+        y: number;
+    } | null;
+    /** The folder every file below is served from, with a trailing slash. */
+    downloadBase: string;
+    files: string[];
+    imageId: string | null;
+}
+/** The step id a workbench reply hands back; every call that changes the effect returns a new one. */
+declare function parseVfxStep(text: string): string;
+/** The working recipe `start` prints (from a preset or a saved effect), or null when it printed none. */
+declare function parseVfxRecipe(text: string): Record<string, unknown> | null;
+/** Reads an `export` reply. The shape is plain text; every field read here was seen on a live export in October 2026. */
+declare function parseVfxExport(text: string): VfxExport;
+/** The workbench's own guide to a topic: `presets`, `parts`, `start`, `recipe`, `edits`, and so on. Free. */
+declare function describeVfx(client: Pick<PixelLabMcpClient, "callTool">, topic: string): Promise<string>;
+/** `<out>.png`, `.gif`, `.json`, `.vfx.json`, and `-game.zip`, with a trailing extension on `out` treated as the base's own. */
+declare function vfxOutputPaths(out: string): {
+    sheet: string;
+    gif: string;
+    atlas: string;
+    provenance: string;
+    gamePack: string;
+};
+/** A PixelLab reference or a URL, as opposed to a local file. */
+declare function isVfxReference(sprite: string): boolean;
+/**
+ * A `--sprite` value as the workbench takes it. PixelLab references
+ * (`character:<id>:<direction>`, `object:<id>`, `gallery:<id>`) and URLs pass
+ * through; anything else is read as a local PNG or JPEG and sent inline.
+ */
+declare function resolveVfxSprite(sprite: string): Promise<string>;
+/**
+ * A recipe file: either a bare recipe or the `.vfx.json` record `makeVfx`
+ * writes. From a record, the sprite it was built around comes back too: a
+ * recipe stores only where the sprite stands (`subject`), not its pixels,
+ * so it has to be sent again to render the same effect.
+ */
+declare function readVfxRecipe(file: string): Promise<{
+    recipe: Record<string, unknown>;
+    sprite?: string;
+}>;
+interface MakeVfxOptions {
+    /** Start from one of PixelLab's whole-effect presets (`describeVfx("presets")`). */
+    preset?: string;
+    /** Start from a full recipe, e.g. one a previous run saved. Rendered exactly as given. */
+    recipe?: Record<string, unknown>;
+    /** Start from an effect saved in the account's My effects, with any slider changes made on pixellab.ai. Exported over itself. */
+    effect?: string;
+    /** Parts added on top of whatever the effect started from; alone, the first one starts the effect. */
+    parts?: VfxPart[];
+    /** The character the effect is built around: a local image, a URL, or a PixelLab reference. */
+    sprite?: string;
+    fps?: number;
+    /**
+     * The name saved to My effects. Defaults to the saved effect's own name
+     * when starting from one (so exporting over it does not rename it), or the
+     * recipe's, then the preset, then the output's file name.
+     */
+    name?: string;
+    /** Output base; see `vfxOutputPaths`. */
+    out: string;
+    /** Also export a ZIP with every piece as its own clip plus a manifest, for a game engine. */
+    gamePack?: boolean;
+    /** A My effects id to overwrite instead of saving a new effect. Defaults to `effect` when starting from one. */
+    replace?: string;
+    force?: boolean;
+    onProgress?: (message: string) => void;
+    /** Replaced in tests. Defaults to a size-limited, retrying fetch. */
+    download?: (url: string) => Promise<Buffer>;
+}
+interface VfxProvenance {
+    version: 1;
+    provider: "pixellab";
+    tool: typeof VFX_TOOL;
+    name: string;
+    effectId: string;
+    editUrl: string | null;
+    source: {
+        preset?: string;
+        effect?: string;
+        recipeFile?: boolean;
+        parts?: VfxPart[];
+        sprite?: string;
+    };
+    width: number;
+    height: number;
+    frames: number;
+    fps: number;
+    loop: boolean;
+    anchor: {
+        x: number;
+        y: number;
+    } | null;
+    files: {
+        sheet: string;
+        gif: string;
+        atlas: string;
+        gamePack?: string;
+    };
+    exportedAt: string;
+    /** The effect's recipe as PixelLab saved it; feed this file back as `--recipe` to render it again. */
+    recipe: Record<string, unknown> | null;
+}
+interface MakeVfxResult extends VfxExport {
+    paths: {
+        sheet: string;
+        gif: string;
+        atlas: string;
+        provenance: string;
+        gamePack?: string;
+    };
+    recipe: Record<string, unknown> | null;
+}
+interface VfxWorkbenchOptions {
+    preset?: string;
+    recipe?: Record<string, unknown>;
+    effect?: string;
+    parts?: VfxPart[];
+    /** Already in the form the workbench takes: see `resolveVfxSprite`. */
+    sprite?: string;
+    fps?: number;
+    /** The My effects name; defaults to the saved effect's or recipe's own, then `defaultName`. */
+    name?: string;
+    defaultName: string;
+    /** A My effects id to export over instead of saving a new effect. */
+    replace?: string;
+    gamePack?: boolean;
+    /** Stored with each step by PixelLab, to improve its tools. */
+    notes?: string;
+    onProgress?: (message: string) => void;
+    /** Called as soon as the export lands, before the recipe is read back, so a caller can checkpoint it. */
+    onExported?: (exported: VfxExport, name: string) => void | Promise<void>;
+}
+/**
+ * The workbench calls for one effect: start, render a recipe, add parts,
+ * set fps, export, then read the saved effect's recipe back (the export reply
+ * carries none). Downloads nothing.
+ */
+declare function runVfxWorkbench(client: Pick<PixelLabMcpClient, "callTool">, opts: VfxWorkbenchOptions): Promise<{
+    exported: VfxExport;
+    recipe: Record<string, unknown> | null;
+    name: string;
+}>;
+/** The saved effect's recipe, or null when the account no longer has it (PixelLab: "No saved effect … in your library"). */
+declare function readSavedVfxRecipe(client: Pick<PixelLabMcpClient, "callTool">, effectId: string): Promise<Record<string, unknown> | null>;
+/**
+ * A recipe's identity: what renders, not what it is called. `name` and
+ * `notes` change with an export's name and never reach a pixel, so two
+ * recipes that differ only there hash the same.
+ */
+declare function vfxRecipeSha256(recipe: Record<string, unknown>): string;
+/**
+ * Cut an exported spritesheet into its frames. The atlas's frame rectangles
+ * are used when it lists one per frame; otherwise the sheet is read as a
+ * row-major grid of `width`x`height` cells, which is how PixelLab lays it out.
+ */
+declare function sliceVfxSheet(sheet: Buffer, facts: {
+    width: number;
+    height: number;
+    frames: number;
+}, atlas?: unknown): Buffer[];
+/**
+ * Build, export, and download one effect: start (preset, saved effect,
+ * recipe, or nothing), add parts, export to My effects, download the files,
+ * then read the saved effect's final recipe back and write it with the
+ * export's facts to `<out>.vfx.json`.
+ */
+declare function makeVfx(client: Pick<PixelLabMcpClient, "callTool">, opts: MakeVfxOptions): Promise<MakeVfxResult>;
+
 interface RevisionReadiness {
     ready: boolean;
     reason: string;
@@ -17756,6 +18439,8 @@ interface AtlasSet {
     kind: "frames" | "members";
     /** Playback rate for `frames`; absent for structural sets. */
     fps?: number;
+    /** False for a `frames` set that plays once (a one-shot effect); absent means it loops. */
+    loop?: boolean;
     /** Frame ids in play order. */
     frames: string[];
 }
@@ -23107,4 +23792,4 @@ interface WorkspaceStatusReport {
  */
 declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
 
-export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, type AssetBatch, AssetBatchSchema, AssetSchema, type AtlasSet, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type Base64Image, type BilledAmount, BudgetError, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, CHARACTER_DIRECTIONS_4, CHARACTER_DIRECTIONS_8, CHARACTER_PROPORTION_PRESETS, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type CharacterAnimation, type CharacterAnimationMode, CharacterAnimationModeSchema, CharacterAnimationSchema$1 as CharacterAnimationSchema, type CharacterDirection, CharacterDirectionSchema, type CharacterMode, CharacterModeSchema, type CharacterOutfit, CharacterOutfitSchema, type CharacterPortrait, CharacterPortraitSchema, type CharacterPortraitSize, CharacterPortraitSizeSchema, type CharacterProportions, CharacterProportionsSchema, type CharacterState, CharacterStateSchema, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EXIT_CODES, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, type ErrorCode, FAKE_PNG, FONT_COST_GENERATIONS, FONT_GLYPH_SIZES, FONT_WEIGHTS, FRAME_SET_REVISION_MODES, type FakeOptions, FakeProvider, type FetchResult, type FontGlyphSize, type FontWeight, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateFontOptions, type GenerateFontResult, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, MEMBER_SET_REVISION_MODES, MIRRORED_DIRECTION, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, type MapScene, type MapScenePlacement, MapScenePlacementSchema, MapSceneSchema, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type ObjectAnimationGroup, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXELATE_COST_GENERATIONS, PIXELATE_MAX_SIDE, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, PRO_TIER_PRICES, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, type PixelLabCharacter, type PixelLabCharacterAnimation, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type PixelLabUsage, type PixelateOptions, type PixelateResult, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Postprocess, PostprocessSchema, type PrepareReviewOptions, type ProFlashCostOperation, type ProFlashQuote, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RefreshContext, type RemoteAsset, type RemoteCharacter, type RemoteCharacterDetail, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedBatch, type ResolvedCharacter, type ResolvedMapScene, type ResolvedMirror, type ResolvedObjectPro, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedReferenceImage, type ResolvedRevision, type ResolvedRevisionMember, type ResolvedSpec, type ResolvedStyleAnchor, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionDithering, RevisionDitheringSchema, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, SHEET_FORMATS, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetAtlas, type SheetFormat, type SheetFormatOptions, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type Tileset, type TilesetExport, type TilesetExportOptions, type TilesetFormat, type TilesetTile, UNZOOM_MAX_AREA, UNZOOM_MIN_SIDE, type UiElement, UiElementSchema, type UiPiece, UiPieceSchema, UnsupportedCapabilityError, type UnzoomFileResult, UsageError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, characterDirections, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, defaultPixelateOut, defaultUnzoomOut, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, fontOutputPaths, formatCost, frameSetFps, galleryContentSecurityPolicy, galleryMediaId, galleryMediaRoute, generateFont, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, isometricTileCost, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTerrainTiles, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parentAssetId, parseLock, parseProFlashQuote, parseTerrainDescriptions, parseWorkspace, pickHistory, pixelateFile, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, proTierCost, proportionsPayload, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderAsepriteSheet, renderGallery, renderGodotSpriteFrames, renderSalvageSheet, renderSheet, renderSheetDocument, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, terrainTileCount, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, unzoomFile, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };
+export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, type AssetBatch, AssetBatchSchema, AssetSchema, type AssetVfx, AssetVfxSchema, type AtlasSet, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type Base64Image, type BilledAmount, BudgetError, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, CHARACTER_DIRECTIONS_4, CHARACTER_DIRECTIONS_8, CHARACTER_PROPORTION_PRESETS, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type CharacterAnimation, type CharacterAnimationMode, CharacterAnimationModeSchema, CharacterAnimationSchema$1 as CharacterAnimationSchema, type CharacterDirection, CharacterDirectionSchema, type CharacterMode, CharacterModeSchema, type CharacterOutfit, CharacterOutfitSchema, type CharacterPortrait, CharacterPortraitSchema, type CharacterPortraitSize, CharacterPortraitSizeSchema, type CharacterProportions, CharacterProportionsSchema, type CharacterState, CharacterStateSchema, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EXIT_CODES, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, type ErrorCode, FAKE_PNG, FONT_COST_GENERATIONS, FONT_GLYPH_SIZES, FONT_WEIGHTS, FRAME_SET_REVISION_MODES, type FakeOptions, FakeProvider, type FetchResult, type FontGlyphSize, type FontWeight, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateFontOptions, type GenerateFontResult, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, MEMBER_SET_REVISION_MODES, MIRRORED_DIRECTION, type MakeVfxOptions, type MakeVfxResult, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, type MapScene, type MapScenePlacement, MapScenePlacementSchema, MapSceneSchema, type McpImage, type McpToolResult, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type ObjectAnimationGroup, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXELATE_COST_GENERATIONS, PIXELATE_MAX_SIDE, PIXELLAB_MCP_URL, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, PRO_TIER_PRICES, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, type PixelLabCharacter, type PixelLabCharacterAnimation, PixelLabClient, PixelLabError, PixelLabMcpClient, type PixelLabObject, PixelLabProvider, type PixelLabUsage, type PixelateOptions, type PixelateResult, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Postprocess, PostprocessSchema, type PrepareReviewOptions, type ProFlashCostOperation, type ProFlashQuote, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RefreshContext, type RemoteAsset, type RemoteCharacter, type RemoteCharacterDetail, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedBatch, type ResolvedCharacter, type ResolvedMapScene, type ResolvedMirror, type ResolvedObjectPro, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedReferenceImage, type ResolvedRevision, type ResolvedRevisionMember, type ResolvedSpec, type ResolvedStyleAnchor, type ResolvedStyleImage, type ResolvedVfx, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionDithering, RevisionDitheringSchema, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, SHEET_FORMATS, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetAtlas, type SheetFormat, type SheetFormatOptions, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type Tileset, type TilesetExport, type TilesetExportOptions, type TilesetFormat, type TilesetTile, UNZOOM_MAX_AREA, UNZOOM_MIN_SIDE, type UiElement, UiElementSchema, type UiPiece, UiPieceSchema, UnsupportedCapabilityError, type UnzoomFileResult, UsageError, VFX_TOOL, type VfxExport, type VfxPart, VfxPartSchema, type VfxProvenance, type VfxWorkbenchOptions, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, assetInStyle, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, characterDirections, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, defaultPixelateOut, defaultUnzoomOut, describeVfx, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, fontOutputPaths, formatCost, frameSetFps, frameSetLoop, galleryContentSecurityPolicy, galleryMediaId, galleryMediaRoute, generateFont, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isBusyReply, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, isVfxReference, isometricTileCost, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, makeVfx, matchOrphanStyle, mcpClientFromEnv, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTerrainTiles, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parentAssetId, parseLock, parseMcpBody, parseProFlashQuote, parseTerrainDescriptions, parseVfxExport, parseVfxRecipe, parseVfxStep, parseWorkspace, pickHistory, pixelateFile, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, proTierCost, proportionsPayload, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, readSavedVfxRecipe, readVfxRecipe, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderAsepriteSheet, renderGallery, renderGodotSpriteFrames, renderSalvageSheet, renderSheet, renderSheetDocument, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resolveVfxSprite, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, runVfxWorkbench, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, sliceVfxSheet, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, terrainTileCount, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, unzoomFile, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, vfxOutputPaths, vfxRecipeSha256, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };