pixelkiln 0.58.0 → 0.59.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -666,6 +666,26 @@ declare const CharacterProportionsSchema: z.ZodUnion<[z.ZodEnum<["default", "chi
666
666
  type CharacterProportions = z.infer<typeof CharacterProportionsSchema>;
667
667
  declare const CharacterAnimationModeSchema: z.ZodEnum<["template", "v3", "pro"]>;
668
668
  type CharacterAnimationMode = z.infer<typeof CharacterAnimationModeSchema>;
669
+ /**
670
+ * A member of a `1dir` batch: `/create-1-direction-object`'s
671
+ * `item_descriptions` field asks for several *distinct* described objects
672
+ * in one call instead of several candidates of the same one. The leader is
673
+ * an ordinary `1dir` asset (its own `prompt` is `item_descriptions[0]`);
674
+ * each member names the leader and its 1-based slot in the batch.
675
+ */
676
+ declare const AssetBatchSchema: z.ZodObject<{
677
+ /** The batch leader: another `1dir` asset in the same style. */
678
+ of: z.ZodString;
679
+ /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
680
+ index: z.ZodNumber;
681
+ }, "strict", z.ZodTypeAny, {
682
+ of: string;
683
+ index: number;
684
+ }, {
685
+ of: string;
686
+ index: number;
687
+ }>;
688
+ type AssetBatch = z.infer<typeof AssetBatchSchema>;
669
689
  /** A pose or outfit of an existing character, applied to every direction. */
670
690
  declare const CharacterStateSchema: z.ZodObject<{
671
691
  /** The base character, or another state, in the same style. */
@@ -3664,6 +3684,23 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
3664
3684
  detail?: string | undefined;
3665
3685
  enhancePrompt?: boolean | undefined;
3666
3686
  }>>;
3687
+ /**
3688
+ * `1dir` styles only: this asset rides along on another `1dir` asset's
3689
+ * batch submission instead of generating on its own. See
3690
+ * `AssetBatchSchema`.
3691
+ */
3692
+ batch: z.ZodOptional<z.ZodObject<{
3693
+ /** The batch leader: another `1dir` asset in the same style. */
3694
+ of: z.ZodString;
3695
+ /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
3696
+ index: z.ZodNumber;
3697
+ }, "strict", z.ZodTypeAny, {
3698
+ of: string;
3699
+ index: number;
3700
+ }, {
3701
+ of: string;
3702
+ index: number;
3703
+ }>>;
3667
3704
  /** `character` styles, `standard` humanoid bases: this character's proportions, over the style's. */
3668
3705
  proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
3669
3706
  headSize: z.ZodOptional<z.ZodNumber>;
@@ -3807,6 +3844,10 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
3807
3844
  lastFrame?: string | undefined;
3808
3845
  } | undefined;
3809
3846
  remoteId?: string | undefined;
3847
+ batch?: {
3848
+ of: string;
3849
+ index: number;
3850
+ } | undefined;
3810
3851
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
3811
3852
  concept?: string | undefined;
3812
3853
  mirror?: string | undefined;
@@ -3870,6 +3911,10 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
3870
3911
  lastFrame?: string | undefined;
3871
3912
  } | undefined;
3872
3913
  remoteId?: string | undefined;
3914
+ batch?: {
3915
+ of: string;
3916
+ index: number;
3917
+ } | undefined;
3873
3918
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
3874
3919
  concept?: string | undefined;
3875
3920
  mirror?: string | undefined;
@@ -3939,6 +3984,10 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
3939
3984
  lastFrame?: string | undefined;
3940
3985
  } | undefined;
3941
3986
  remoteId?: string | undefined;
3987
+ batch?: {
3988
+ of: string;
3989
+ index: number;
3990
+ } | undefined;
3942
3991
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
3943
3992
  concept?: string | undefined;
3944
3993
  mirror?: string | undefined;
@@ -4002,6 +4051,10 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
4002
4051
  lastFrame?: string | undefined;
4003
4052
  } | undefined;
4004
4053
  remoteId?: string | undefined;
4054
+ batch?: {
4055
+ of: string;
4056
+ index: number;
4057
+ } | undefined;
4005
4058
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
4006
4059
  concept?: string | undefined;
4007
4060
  mirror?: string | undefined;
@@ -5162,6 +5215,23 @@ declare const ManifestSchema: z.ZodObject<{
5162
5215
  detail?: string | undefined;
5163
5216
  enhancePrompt?: boolean | undefined;
5164
5217
  }>>;
5218
+ /**
5219
+ * `1dir` styles only: this asset rides along on another `1dir` asset's
5220
+ * batch submission instead of generating on its own. See
5221
+ * `AssetBatchSchema`.
5222
+ */
5223
+ batch: z.ZodOptional<z.ZodObject<{
5224
+ /** The batch leader: another `1dir` asset in the same style. */
5225
+ of: z.ZodString;
5226
+ /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
5227
+ index: z.ZodNumber;
5228
+ }, "strict", z.ZodTypeAny, {
5229
+ of: string;
5230
+ index: number;
5231
+ }, {
5232
+ of: string;
5233
+ index: number;
5234
+ }>>;
5165
5235
  /** `character` styles, `standard` humanoid bases: this character's proportions, over the style's. */
5166
5236
  proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
5167
5237
  headSize: z.ZodOptional<z.ZodNumber>;
@@ -5305,6 +5375,10 @@ declare const ManifestSchema: z.ZodObject<{
5305
5375
  lastFrame?: string | undefined;
5306
5376
  } | undefined;
5307
5377
  remoteId?: string | undefined;
5378
+ batch?: {
5379
+ of: string;
5380
+ index: number;
5381
+ } | undefined;
5308
5382
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5309
5383
  concept?: string | undefined;
5310
5384
  mirror?: string | undefined;
@@ -5368,6 +5442,10 @@ declare const ManifestSchema: z.ZodObject<{
5368
5442
  lastFrame?: string | undefined;
5369
5443
  } | undefined;
5370
5444
  remoteId?: string | undefined;
5445
+ batch?: {
5446
+ of: string;
5447
+ index: number;
5448
+ } | undefined;
5371
5449
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5372
5450
  concept?: string | undefined;
5373
5451
  mirror?: string | undefined;
@@ -5437,6 +5515,10 @@ declare const ManifestSchema: z.ZodObject<{
5437
5515
  lastFrame?: string | undefined;
5438
5516
  } | undefined;
5439
5517
  remoteId?: string | undefined;
5518
+ batch?: {
5519
+ of: string;
5520
+ index: number;
5521
+ } | undefined;
5440
5522
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5441
5523
  concept?: string | undefined;
5442
5524
  mirror?: string | undefined;
@@ -5500,6 +5582,10 @@ declare const ManifestSchema: z.ZodObject<{
5500
5582
  lastFrame?: string | undefined;
5501
5583
  } | undefined;
5502
5584
  remoteId?: string | undefined;
5585
+ batch?: {
5586
+ of: string;
5587
+ index: number;
5588
+ } | undefined;
5503
5589
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5504
5590
  concept?: string | undefined;
5505
5591
  mirror?: string | undefined;
@@ -5656,6 +5742,10 @@ declare const ManifestSchema: z.ZodObject<{
5656
5742
  lastFrame?: string | undefined;
5657
5743
  } | undefined;
5658
5744
  remoteId?: string | undefined;
5745
+ batch?: {
5746
+ of: string;
5747
+ index: number;
5748
+ } | undefined;
5659
5749
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5660
5750
  concept?: string | undefined;
5661
5751
  mirror?: string | undefined;
@@ -5807,6 +5897,10 @@ declare const ManifestSchema: z.ZodObject<{
5807
5897
  lastFrame?: string | undefined;
5808
5898
  } | undefined;
5809
5899
  remoteId?: string | undefined;
5900
+ batch?: {
5901
+ of: string;
5902
+ index: number;
5903
+ } | undefined;
5810
5904
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
5811
5905
  concept?: string | undefined;
5812
5906
  mirror?: string | undefined;
@@ -7278,6 +7372,23 @@ declare const ManifestInputSchema: z.ZodObject<{
7278
7372
  detail?: string | undefined;
7279
7373
  enhancePrompt?: boolean | undefined;
7280
7374
  }>>;
7375
+ /**
7376
+ * `1dir` styles only: this asset rides along on another `1dir` asset's
7377
+ * batch submission instead of generating on its own. See
7378
+ * `AssetBatchSchema`.
7379
+ */
7380
+ batch: z.ZodOptional<z.ZodObject<{
7381
+ /** The batch leader: another `1dir` asset in the same style. */
7382
+ of: z.ZodString;
7383
+ /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
7384
+ index: z.ZodNumber;
7385
+ }, "strict", z.ZodTypeAny, {
7386
+ of: string;
7387
+ index: number;
7388
+ }, {
7389
+ of: string;
7390
+ index: number;
7391
+ }>>;
7281
7392
  /** `character` styles, `standard` humanoid bases: this character's proportions, over the style's. */
7282
7393
  proportions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["default", "chibi", "cartoon", "stylized", "realistic_male", "realistic_female", "heroic"]>, z.ZodObject<{
7283
7394
  headSize: z.ZodOptional<z.ZodNumber>;
@@ -7421,6 +7532,10 @@ declare const ManifestInputSchema: z.ZodObject<{
7421
7532
  lastFrame?: string | undefined;
7422
7533
  } | undefined;
7423
7534
  remoteId?: string | undefined;
7535
+ batch?: {
7536
+ of: string;
7537
+ index: number;
7538
+ } | undefined;
7424
7539
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
7425
7540
  concept?: string | undefined;
7426
7541
  mirror?: string | undefined;
@@ -7484,6 +7599,10 @@ declare const ManifestInputSchema: z.ZodObject<{
7484
7599
  lastFrame?: string | undefined;
7485
7600
  } | undefined;
7486
7601
  remoteId?: string | undefined;
7602
+ batch?: {
7603
+ of: string;
7604
+ index: number;
7605
+ } | undefined;
7487
7606
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
7488
7607
  concept?: string | undefined;
7489
7608
  mirror?: string | undefined;
@@ -7553,6 +7672,10 @@ declare const ManifestInputSchema: z.ZodObject<{
7553
7672
  lastFrame?: string | undefined;
7554
7673
  } | undefined;
7555
7674
  remoteId?: string | undefined;
7675
+ batch?: {
7676
+ of: string;
7677
+ index: number;
7678
+ } | undefined;
7556
7679
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
7557
7680
  concept?: string | undefined;
7558
7681
  mirror?: string | undefined;
@@ -7616,6 +7739,10 @@ declare const ManifestInputSchema: z.ZodObject<{
7616
7739
  lastFrame?: string | undefined;
7617
7740
  } | undefined;
7618
7741
  remoteId?: string | undefined;
7742
+ batch?: {
7743
+ of: string;
7744
+ index: number;
7745
+ } | undefined;
7619
7746
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
7620
7747
  concept?: string | undefined;
7621
7748
  mirror?: string | undefined;
@@ -7855,6 +7982,10 @@ declare const ManifestInputSchema: z.ZodObject<{
7855
7982
  lastFrame?: string | undefined;
7856
7983
  } | undefined;
7857
7984
  remoteId?: string | undefined;
7985
+ batch?: {
7986
+ of: string;
7987
+ index: number;
7988
+ } | undefined;
7858
7989
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
7859
7990
  concept?: string | undefined;
7860
7991
  mirror?: string | undefined;
@@ -8089,6 +8220,10 @@ declare const ManifestInputSchema: z.ZodObject<{
8089
8220
  lastFrame?: string | undefined;
8090
8221
  } | undefined;
8091
8222
  remoteId?: string | undefined;
8223
+ batch?: {
8224
+ of: string;
8225
+ index: number;
8226
+ } | undefined;
8092
8227
  reference?: string | Partial<Record<"south" | "south-east" | "east" | "north-east" | "north" | "north-west" | "west" | "south-west", string>> | undefined;
8093
8228
  concept?: string | undefined;
8094
8229
  mirror?: string | undefined;
@@ -8393,6 +8528,20 @@ declare const LockEntrySchema: z.ZodObject<{
8393
8528
  sourceAssetId: string;
8394
8529
  sourceSha256: string;
8395
8530
  }>>>;
8531
+ /** For a `1dir` batch member: which leader and slot it rode along on. */
8532
+ batch: z.ZodDefault<z.ZodNullable<z.ZodObject<{
8533
+ role: z.ZodEnum<["leader", "member"]>;
8534
+ leaderAssetId: z.ZodOptional<z.ZodString>;
8535
+ index: z.ZodOptional<z.ZodNumber>;
8536
+ }, "strict", z.ZodTypeAny, {
8537
+ role: "leader" | "member";
8538
+ index?: number | undefined;
8539
+ leaderAssetId?: string | undefined;
8540
+ }, {
8541
+ role: "leader" | "member";
8542
+ index?: number | undefined;
8543
+ leaderAssetId?: string | undefined;
8544
+ }>>>;
8396
8545
  /**
8397
8546
  * Output hashes owned by the previous generation while its replacement is
8398
8547
  * pending. They authorize replacing only unchanged PixelKiln-owned files.
@@ -8734,6 +8883,11 @@ declare const LockEntrySchema: z.ZodObject<{
8734
8883
  paletteImageSha256?: string | undefined;
8735
8884
  lastFrameSha256?: string | undefined;
8736
8885
  } | null;
8886
+ batch: {
8887
+ role: "leader" | "member";
8888
+ index?: number | undefined;
8889
+ leaderAssetId?: string | undefined;
8890
+ } | null;
8737
8891
  mirror: {
8738
8892
  sourceAssetId: string;
8739
8893
  sourceSha256: string;
@@ -8851,6 +9005,11 @@ declare const LockEntrySchema: z.ZodObject<{
8851
9005
  paletteImageSha256?: string | undefined;
8852
9006
  lastFrameSha256?: string | undefined;
8853
9007
  } | null | undefined;
9008
+ batch?: {
9009
+ role: "leader" | "member";
9010
+ index?: number | undefined;
9011
+ leaderAssetId?: string | undefined;
9012
+ } | null | undefined;
8854
9013
  mirror?: {
8855
9014
  sourceAssetId: string;
8856
9015
  sourceSha256: string;
@@ -9011,6 +9170,20 @@ declare const LockSchema: z.ZodObject<{
9011
9170
  sourceAssetId: string;
9012
9171
  sourceSha256: string;
9013
9172
  }>>>;
9173
+ /** For a `1dir` batch member: which leader and slot it rode along on. */
9174
+ batch: z.ZodDefault<z.ZodNullable<z.ZodObject<{
9175
+ role: z.ZodEnum<["leader", "member"]>;
9176
+ leaderAssetId: z.ZodOptional<z.ZodString>;
9177
+ index: z.ZodOptional<z.ZodNumber>;
9178
+ }, "strict", z.ZodTypeAny, {
9179
+ role: "leader" | "member";
9180
+ index?: number | undefined;
9181
+ leaderAssetId?: string | undefined;
9182
+ }, {
9183
+ role: "leader" | "member";
9184
+ index?: number | undefined;
9185
+ leaderAssetId?: string | undefined;
9186
+ }>>>;
9014
9187
  /**
9015
9188
  * Output hashes owned by the previous generation while its replacement is
9016
9189
  * pending. They authorize replacing only unchanged PixelKiln-owned files.
@@ -9352,6 +9525,11 @@ declare const LockSchema: z.ZodObject<{
9352
9525
  paletteImageSha256?: string | undefined;
9353
9526
  lastFrameSha256?: string | undefined;
9354
9527
  } | null;
9528
+ batch: {
9529
+ role: "leader" | "member";
9530
+ index?: number | undefined;
9531
+ leaderAssetId?: string | undefined;
9532
+ } | null;
9355
9533
  mirror: {
9356
9534
  sourceAssetId: string;
9357
9535
  sourceSha256: string;
@@ -9469,6 +9647,11 @@ declare const LockSchema: z.ZodObject<{
9469
9647
  paletteImageSha256?: string | undefined;
9470
9648
  lastFrameSha256?: string | undefined;
9471
9649
  } | null | undefined;
9650
+ batch?: {
9651
+ role: "leader" | "member";
9652
+ index?: number | undefined;
9653
+ leaderAssetId?: string | undefined;
9654
+ } | null | undefined;
9472
9655
  mirror?: {
9473
9656
  sourceAssetId: string;
9474
9657
  sourceSha256: string;
@@ -9582,6 +9765,11 @@ declare const LockSchema: z.ZodObject<{
9582
9765
  paletteImageSha256?: string | undefined;
9583
9766
  lastFrameSha256?: string | undefined;
9584
9767
  } | null;
9768
+ batch: {
9769
+ role: "leader" | "member";
9770
+ index?: number | undefined;
9771
+ leaderAssetId?: string | undefined;
9772
+ } | null;
9585
9773
  mirror: {
9586
9774
  sourceAssetId: string;
9587
9775
  sourceSha256: string;
@@ -9702,6 +9890,11 @@ declare const LockSchema: z.ZodObject<{
9702
9890
  paletteImageSha256?: string | undefined;
9703
9891
  lastFrameSha256?: string | undefined;
9704
9892
  } | null | undefined;
9893
+ batch?: {
9894
+ role: "leader" | "member";
9895
+ index?: number | undefined;
9896
+ leaderAssetId?: string | undefined;
9897
+ } | null | undefined;
9705
9898
  mirror?: {
9706
9899
  sourceAssetId: string;
9707
9900
  sourceSha256: string;
@@ -9813,6 +10006,26 @@ interface ResolvedMirror {
9813
10006
  sourceAssetId: string;
9814
10007
  sourceSpec: ResolvedSpec;
9815
10008
  }
10009
+ /**
10010
+ * A `1dir` batch, leader or member. `itemDescriptions` is the full ordered
10011
+ * list (the leader's own prompt at index 0, then each member's prompt at
10012
+ * its declared `index`) and is identical across the whole group — every
10013
+ * member's identity depends on the group's full membership, so adding,
10014
+ * removing, or editing any one member's prompt marks every sibling stale
10015
+ * together, matching PixelLab having no way to add an item to an
10016
+ * already-submitted batch.
10017
+ */
10018
+ interface ResolvedBatch {
10019
+ role: "leader" | "member";
10020
+ itemDescriptions: string[];
10021
+ /** Member only: this asset's 1-based slot into `itemDescriptions`. */
10022
+ index?: number;
10023
+ /** Member only: the leader asset id and its full resolved intent. */
10024
+ leaderAssetId?: string;
10025
+ leaderSpec?: ResolvedSpec;
10026
+ /** Leader only: every member's asset id, in `index` order. */
10027
+ memberAssetIds?: string[];
10028
+ }
9816
10029
  /** A manifest entry resolved against its style, everything needed to generate. */
9817
10030
  interface ResolvedSpec {
9818
10031
  /** Absolute directory containing the manifest; excluded from the spec hash. */
@@ -9843,6 +10056,8 @@ interface ResolvedSpec {
9843
10056
  objectPro?: ResolvedObjectPro;
9844
10057
  /** A local left-to-right flip of another asset in this style; costs nothing. */
9845
10058
  mirror?: ResolvedMirror;
10059
+ /** Set for a `1dir` asset that hosts or rides along on a batch submission. */
10060
+ batch?: ResolvedBatch;
9846
10061
  /** Provider-side id declared for adoption; excluded from the spec hash. */
9847
10062
  remoteId?: string;
9848
10063
  /**
@@ -10822,14 +11037,15 @@ declare class PixelLabClient {
10822
11037
  /**
10823
11038
  * `/reduce-colors`, PixelLab's "Cleanup" tier: quantize one image onto a
10824
11039
  * smaller palette, synchronously — no `background_job_id`, the result
10825
- * comes back in this same response, like `createImagePixflux`. Verified
10826
- * against the live OpenAPI schema, not exercised against a live account:
10827
- * the schema's own response example is `usage: {type: "usd", usd: 0.02}`,
10828
- * which — going by this codebase's own repeated experience with PixelLab's
10829
- * documented-vs-billed cost mismatches (`isometricTile`, `objectPro`) —
10830
- * should not be trusted over a real call. `numColors` and `paletteImage`
10831
- * are mutually exclusive upstream; the manifest schema already enforces
10832
- * that before this is ever called.
11040
+ * comes back in this same response, like `createImagePixflux`. The
11041
+ * schema's own response example is dollar-denominated (`usage: {type:
11042
+ * "usd", usd: 0.02}`), which — matching this codebase's repeated
11043
+ * experience with PixelLab's documented-vs-billed cost mismatches
11044
+ * (`isometricTile`, `objectPro`) — did not hold: confirmed live against a
11045
+ * Tier 2 account at exactly 0.1 generations for a 32x32 source
11046
+ * (docs/REVISIONS.md). `numColors` and `paletteImage` are mutually
11047
+ * exclusive upstream; the manifest schema already enforces that before
11048
+ * this is ever called.
10833
11049
  */
10834
11050
  reduceColors(args: {
10835
11051
  image: Base64Image;
@@ -10846,8 +11062,9 @@ declare class PixelLabClient {
10846
11062
  /**
10847
11063
  * `/correct-pixelart`, PixelLab's "Cleanup" tier: sharpen edges and drop
10848
11064
  * stray pixels without resizing, synchronously — same shape as
10849
- * `reduceColors` above, no background job. Cost is likewise unverified
10850
- * against a live account (schema example: `usage: {type: "usd", usd: 0.02}`).
11065
+ * `reduceColors` above, no background job. Cost is likewise confirmed
11066
+ * live at 0.1 generations for a 32x32 source, not the schema's own
11067
+ * dollar-denominated example (`usage: {type: "usd", usd: 0.02}`).
10851
11068
  */
10852
11069
  correctPixelart(args: {
10853
11070
  image: Base64Image;
@@ -14826,6 +15043,14 @@ interface SheetGroup {
14826
15043
  width: number;
14827
15044
  height: number;
14828
15045
  };
15046
+ /**
15047
+ * A batch member's declared slot in the shared candidate set (confirmed
15048
+ * live: `item_descriptions[i]` reliably lands at candidate index `i`; see
15049
+ * docs/GENERATORS.md#1dir). Starts the row already scrolled to and
15050
+ * labelled at that candidate instead of the ordinary index-0 default —
15051
+ * still just a starting point, not an auto-pick.
15052
+ */
15053
+ recommendedIndex?: number;
14829
15054
  }
14830
15055
  /**
14831
15056
  * A contact sheet for choosing among generated candidates.
@@ -16958,4 +17183,4 @@ interface WorkspaceStatusReport {
16958
17183
  */
16959
17184
  declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
16960
17185
 
16961
- export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type 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 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, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, MIRRORED_DIRECTION, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type ObjectAnimationGroup, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, type PixelLabCharacter, type PixelLabCharacterAnimation, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type PixelLabUsage, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Postprocess, PostprocessSchema, type PrepareReviewOptions, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RefreshContext, type RemoteAsset, type RemoteCharacter, type RemoteCharacterDetail, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedCharacter, type ResolvedMirror, type ResolvedObjectPro, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedReferenceImage, type ResolvedRevision, 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, UnsupportedCapabilityError, UsageError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, characterDirections, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, frameSetFps, galleryMediaId, galleryMediaRoute, 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, parseTerrainDescriptions, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, 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, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };
17186
+ 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 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, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, MIRRORED_DIRECTION, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type ObjectAnimationGroup, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, type PixelLabCharacter, type PixelLabCharacterAnimation, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type PixelLabUsage, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type Postprocess, PostprocessSchema, type PrepareReviewOptions, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RefreshContext, type RemoteAsset, type RemoteCharacter, type RemoteCharacterDetail, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedBatch, type ResolvedCharacter, type ResolvedMirror, type ResolvedObjectPro, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedReferenceImage, type ResolvedRevision, 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, UnsupportedCapabilityError, UsageError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, characterDirections, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, frameSetFps, galleryMediaId, galleryMediaRoute, 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, parseTerrainDescriptions, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, 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, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };