pixelkiln 0.35.0 → 0.36.0

package/dist/index.d.cts

@@ -12,6 +12,71 @@ declare function detectMediaType(bytes: Buffer): MediaType | null;
 declare function validateMedia(bytes: Buffer, expected?: MediaType): MediaType;
 declare function cacheFileName(hash: string, mediaType?: MediaType): string;
 
+/**
+ * The kinds of failure a caller can act on differently.
+ *
+ * Most errors in this codebase are plain `Error`s with a good message, and
+ * that stays true: the message is for a person. A `code` is for a program.
+ * The gallery turns one into an HTTP status, the CLI into an exit code, and
+ * an integration decides whether to retry, ask, or stop without matching on
+ * message text that may be reworded.
+ *
+ * The set is deliberately small. A new code earns its place when some caller
+ * would branch on it; until then a plain Error is the right type.
+ */
+type ErrorCode = 
+/** Bad flags or arguments. Nothing was read or written. */
+"usage"
+/** The manifest, lockfile, or workspace catalog is missing or invalid. */
+ | "project"
+/** A provider rejected a request or answered with something unusable. */
+ | "provider"
+/** A file on disk differs from what the record expects; nothing was overwritten. */
+ | "refused-overwrite"
+/** The run would spend past a ceiling, or the balance cannot cover it. */
+ | "budget"
+/** The provider recorded for this work does not offer the operation. */
+ | "capability";
+/** Exit codes the CLI maps each kind to. 1 stays the code for anything untyped. */
+declare const EXIT_CODES: Record<ErrorCode, number>;
+interface PixelKilnErrorOptions {
+    /** One line of what to do next, printed under the message by the CLI. */
+    hint?: string;
+    cause?: unknown;
+}
+declare class PixelKilnError extends Error {
+    readonly code: ErrorCode;
+    readonly hint?: string;
+    constructor(message: string, code: ErrorCode, opts?: PixelKilnErrorOptions);
+}
+declare class UsageError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+declare class ProjectError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+declare class ProviderError extends PixelKilnError {
+    /** Registry id of the provider that failed. */
+    readonly provider: string;
+    /** HTTP status when the failure was a response, otherwise undefined. */
+    readonly status?: number;
+    constructor(provider: string, message: string, opts?: PixelKilnErrorOptions & {
+        status?: number;
+    });
+}
+declare class OverwriteRefusedError extends PixelKilnError {
+    /** The file(s) left untouched. */
+    readonly files: string[];
+    constructor(message: string, files: string[], opts?: PixelKilnErrorOptions);
+}
+declare class BudgetError extends PixelKilnError {
+    constructor(message: string, opts?: PixelKilnErrorOptions);
+}
+/** The code of any thrown value, or undefined for an untyped error. */
+declare function errorCode(err: unknown): ErrorCode | undefined;
+/** What a process should exit with after failing on `err`. */
+declare function exitCodeFor(err: unknown): number;
+
 /**
  * Human-readable unit attached to every estimate and recorded charge.
  * Built-ins use generations, USD, free, and compute units. Adapters may report
@@ -230,7 +295,7 @@ interface Provider {
     /** Irreversible. Only reached via `purge`, behind explicit confirmation. */
     delete?(assetId: string): Promise<void>;
 }
-declare class UnsupportedCapabilityError extends Error {
+declare class UnsupportedCapabilityError extends PixelKilnError {
     constructor(providerId: string, capability: string);
 }
 /** Narrowing helpers so call sites fail with a clear message, not `undefined is not a function`. */
@@ -688,8 +753,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -766,8 +831,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -844,8 +909,8 @@ declare const StyleSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -968,8 +1033,8 @@ declare const InheritedStyleSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1008,8 +1073,8 @@ declare const InheritedStyleSchema: z.ZodObject<{
 }, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1264,8 +1329,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1342,8 +1407,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1420,8 +1485,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
     } | undefined;
 }, {
     outDir: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1539,8 +1604,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }, "strict", z.ZodTypeAny, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -1579,8 +1644,8 @@ declare const StyleInputSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodObjec
 }, {
     outDir: string;
     extends: string;
-    palette?: string[] | undefined;
     provider?: string | undefined;
+    palette?: string[] | undefined;
     generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
     size?: number | undefined;
     view?: string | undefined;
@@ -2034,8 +2099,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2112,8 +2177,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2190,8 +2255,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2487,8 +2552,8 @@ declare const ManifestSchema: z.ZodObject<{
 }, {
     styles: Record<string, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2776,8 +2841,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2854,8 +2919,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -2932,8 +2997,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3051,8 +3116,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3091,8 +3156,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     }, {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3362,8 +3427,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     } | {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3428,8 +3493,8 @@ declare const ManifestInputSchema: z.ZodObject<{
 }, {
     styles: Record<string, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3468,8 +3533,8 @@ declare const ManifestInputSchema: z.ZodObject<{
     } | {
         outDir: string;
         extends: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -3877,8 +3942,8 @@ declare const LockEntrySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     width: number;
     height: number;
-    status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
     provider: string;
+    status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
     generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
     tileFeature: string | null;
     prompt: string;
@@ -3959,8 +4024,8 @@ declare const LockEntrySchema: z.ZodObject<{
     specHash: string;
     styleId: string;
     assetId: string;
-    status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
     provider?: string | undefined;
+    status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
     tileFeature?: string | null | undefined;
     revision?: {
         mode: "image-to-image" | "inpaint" | "outpaint";
@@ -4258,8 +4323,8 @@ declare const LockSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         width: number;
         height: number;
-        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         provider: string;
+        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
         tileFeature: string | null;
         prompt: string;
@@ -4340,8 +4405,8 @@ declare const LockSchema: z.ZodObject<{
         specHash: string;
         styleId: string;
         assetId: string;
-        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         provider?: string | undefined;
+        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         tileFeature?: string | null | undefined;
         revision?: {
             mode: "image-to-image" | "inpaint" | "outpaint";
@@ -4414,8 +4479,8 @@ declare const LockSchema: z.ZodObject<{
     entries: Record<string, {
         width: number;
         height: number;
-        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         provider: string;
+        status: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed";
         generator: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames";
         tileFeature: string | null;
         prompt: string;
@@ -4499,8 +4564,8 @@ declare const LockSchema: z.ZodObject<{
         specHash: string;
         styleId: string;
         assetId: string;
-        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         provider?: string | undefined;
+        status?: "processing" | "review" | "failed" | "pending" | "selected" | "downloaded" | "download-failed" | undefined;
         tileFeature?: string | null | undefined;
         revision?: {
             mode: "image-to-image" | "inpaint" | "outpaint";
@@ -4740,8 +4805,7 @@ interface MapObject {
     height: number | null;
     download_url: string | null;
 }
-declare class PixelLabError extends Error {
-    readonly status: number;
+declare class PixelLabError extends ProviderError {
     readonly body: string;
     constructor(message: string, status: number, body: string);
 }
@@ -5789,8 +5853,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -5867,8 +5931,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -5945,8 +6009,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         } | undefined;
     }, {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -6445,8 +6509,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     summary: string;
     style: {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -6687,8 +6751,8 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     summary: string;
     style: {
         outDir: string;
-        palette?: string[] | undefined;
         provider?: string | undefined;
+        palette?: string[] | undefined;
         generator?: "map" | "1dir" | "pixflux" | "tiles" | "animation" | "frames" | undefined;
         size?: number | undefined;
         view?: string | undefined;
@@ -8648,6 +8712,7 @@ declare const CompanionV2Schema: z.ZodObject<{
         basedOn: string | null;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8655,10 +8720,10 @@ declare const CompanionV2Schema: z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8666,7 +8731,6 @@ declare const CompanionV2Schema: z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }>;
@@ -8696,6 +8760,7 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         basedOn: string | null;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8703,10 +8768,10 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8714,7 +8779,6 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }>, z.ZodObject<{
@@ -8726,22 +8790,23 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     savedAt: z.ZodString;
     project: z.ZodNullable<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
 }>]>, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8749,10 +8814,10 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 }, {
+    project: string | null;
     outputs: {
         sha256: string;
         role: string | null;
@@ -8760,14 +8825,13 @@ declare const HandEditCompanionSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     }[];
     version: 2;
     protocol: number;
-    project: string | null;
     editor: string;
     savedAt: string;
 } | {
+    project: string | null;
     sha256: string;
     version: 1;
     protocol: number;
-    project: string | null;
     basedOn: string | null;
     editor: string;
     savedAt: string;
@@ -9125,49 +9189,49 @@ declare const GenerateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     revert: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }>, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }>, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
 }, {
     keys: string[];
+    project?: string | undefined;
     resume?: boolean | undefined;
     force?: boolean | undefined;
-    project?: string | undefined;
     refresh?: boolean | undefined;
     restore?: boolean | undefined;
     revert?: string | undefined;
@@ -9777,4 +9841,4 @@ interface WorkspaceStatusReport {
  */
 declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
 
-export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type PrepareReviewOptions, type Project, type Provider, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };
+export { type AdoptResult, type ApproveQualityOptions, type ApprovedQualityReview, type ArtifactBundleManifest, type ArtifactBundleOptions, type ArtifactBundleResult, type ArtifactFile, type ArtifactProvenance, type ArtifactSource, type ArtifactVerification, type Asset, type AssetAudit, AssetSchema, type AuditEvaluation, type AuditThresholds, type AuditViolation, type Balance, type BalanceChange, type BalanceInfo, BudgetError, type BuildGalleryOptions, type BuildWorkspaceGalleryOptions, type CacheHealthOptions, type CacheHealthReport, type CandidateSelection, type ComfyUIBinding, type ComfyUIBindings, type ComfyUIFramesOptions, type ComfyUIImageInput, type ComfyUIOptions, ComfyUIProvider, type ContentCacheHealth, type ContentCacheIssue, type CostEstimate, type CostUnit, DEFAULT_HISTORY_LIMIT, DEFAULT_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, DEFAULT_TIMEOUT_MS, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, EDITOR_PIN, EDITOR_RELEASE_BASE, EXIT_CODES, EditorInstallError, type EditorInstallOptions, type EditorInstallProgress, type EditorInstallResult, type EditorInstallStatus, type EditorPin, type ErrorCode, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type GalleryBuild, type GalleryEditHandlerOptions, type GalleryEditMeta, type GalleryEditorHandlers, type GalleryEditorOptions, type GalleryEditorStatus, type GalleryGenerateHandlers, type GalleryGeneration, type GalleryItem, type GalleryMedia, type GalleryOutput, type GalleryProject, type GalleryProjectContext, type GalleryQuality, type GalleryServer, type GalleryServerOptions, type GallerySnapshot, type GalleryState, type GalleryStyle, type GenerateHandlerOptions, type GenerateJob, type GeneratePhase, GenerateRequestError, GenerateRequestSchema, type GenerateStatus, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, HAND_EDIT_DIR, HISTORY_ENV, type HandEditCompanion, HandEditCompanionSchema, type HandEditMember, type HandEditSave, type HandEditSaveInput, type HandEditStart, type HandEditStatus, type HistoryPick, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockHistoryEntry, LockHistoryEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_HAND_EDIT_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, ManifestDriftError, type ManifestEdit, ManifestEditError, type ManifestEditResult, ManifestEditSchema, ManifestInputSchema, ManifestSchema, type MapObject, MediaType, type MountPlacement, type MountedSheet, type NormalizedTileRules, type OpenProjectOptions, type Orphan, type OrphanGroups, type OutputSelection, type OutputSource, OverwriteRefusedError, PIXEL_ART_FIXER_REVISION, PIXEL_ART_FIXER_URL, type PackedFrame, type PackedSheet, type PackedSource, type PendingQualityReview, type PickResult, type PixelArtFixerDetection, PixelKilnError, type PixelKilnErrorOptions, PixelLabClient, PixelLabError, type PixelLabObject, PixelLabProvider, type Plan, type PlanItem, type PlanState, type PollContext, type PollOptions, type PollResult, type PrepareReviewOptions, type Project, ProjectError, type Provider, ProviderError, type ProviderFactory, type ProviderInputContext, type ProviderInputScalar, type ProviderInputValue, type ProviderMetadata, type ProviderMode, type ProviderOptionContext, type ProviderSubmission, type QualityBaseline, QualityBaselineSchema, type QualityCheck, type QualityProfile, type QualityProfileInspection, QualityProfileSchema, type QualityProfileState, type QualityRegressionCaseResult, type QualityRegressionReport, type QualitySnapshotResult, QualityToleranceSchema, type QualityTolerances, type RateLimit, type Recipe, type RecipeFileVerification, type RecipeModelVerification, RecipeSchema, type RecipeVerification, type RefineAudit, type RefineFrameSetOptions, type RefineFrameSetResult, type RefineOptions, type RefineQualityProfilesOptions, type RefineQualityProfilesResult, type RefineRecordOptions, type RefineResult, type RemoteAsset, type RemoteHashCacheHealth, type RenderGalleryOptions, type RenderSheetOptions, type ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type RetryInit, type RetryOptions, type RetryingFetch, type RevertOptions, type RevertResult, type ReviewReadyInfo, type ReviewSession, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SessionBudget, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, type SubmissionCheckpoint, type SubmitContext, type SubmitOptions, type SubmitResult, type TilesPro, type TilesetExport, type TilesetExportOptions, type TilesetFormat, UnsupportedCapabilityError, UsageError, type Workspace, type WorkspaceClaims, type WorkspaceDiagnostic, type WorkspaceProject, WorkspaceProjectSchema, type WorkspaceProjectStatus, WorkspaceSchema, type WorkspaceStatusReport, adopt, applyManifestEdit, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildGallerySnapshot, buildManifest, buildPlan, buildWorkspaceGallerySnapshot, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createGalleryEditHandler, createGalleryEditorHandlers, createGenerateHandlers, createProvider, currentEntryOutputPath, currentOutputPath, defaultOpenCommand, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, errorCode, evaluateAudit, exitCodeFor, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, fetchWithRetry, findOrphans, formatCost, galleryMediaId, galleryMediaRoute, generationCost, groupOrphansByStyle, handEditBase, handEditBases, handEditCompanionPath, handEditMembers, handEditPath, handEditProjectPath, hex, historyAfterReplacing, historyLimit, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installEditor, installRecipe, isFrameSetEntry, isMemberSetEntry, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, memberPath, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, openExternal, openInEditor, openProject, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pickHistory, pngSize, poll, portableOutputPath, prepareReview, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readHandEditCompanion, readQualityBaseline, recipeDigest, referencedHashes, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderGallery, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retireGeneration, retryAfterMs, revertGeneration, runPicker, runSalvage, saveHandEdit, saveLock, saveWorkspace, scanAssets, selectEntryOutput, serveGallery, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, sourceIsStem, sourceOutputPath, specHash, spendByUnit, startHandEdit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };