pixelkiln 0.34.0 → 0.35.0

package/dist/index.d.ts

@@ -4639,13 +4639,61 @@ interface ResolvedSpec {
     outlineMode?: string;
 }
 
+/**
+ * One retry policy for every provider.
+ *
+ * The policy started life inside the PixelLab client, and its reasoning holds
+ * for every backend PixelKiln talks to: retry only what is safe to retry
+ * (transport failures, 408, 429, 5xx), honour Retry-After, back off with
+ * jitter so parallel workers don't retry in lockstep, and give up after a
+ * bounded number of attempts. POSTs that create work are included on purpose.
+ * A dropped asset in a 65-item run is more common than a duplicate job, and a
+ * duplicate is visible and free to delete whereas a silent gap is neither.
+ *
+ * Every attempt gets its own timeout unless the caller brings a signal. An
+ * abort the caller asked for is never retried; a timeout of our own is.
+ */
 declare const MAX_RETRIES = 4;
-declare const MAX_DOWNLOAD_BYTES: number;
+declare const DEFAULT_TIMEOUT_MS = 120000;
+/**
+ * Throttling, a timed-out request, and the four 5xx codes that describe a
+ * passing condition. 501, 505, 507 and friends describe the server itself
+ * and will not clear in the next sixteen seconds.
+ */
 declare function shouldRetry(status: number): boolean;
 /** Exponential backoff with jitter, so parallel workers don't retry in lockstep. */
 declare function backoffMs(attempt: number): number;
 /** Supports both Retry-After forms: seconds and an HTTP date. */
 declare function retryAfterMs(value: string | null, now?: number): number | null;
+interface RetryOptions {
+    /** Attempts after the first. 0 disables retrying. */
+    retries?: number;
+    /** Per-attempt timeout used when the caller passes no signal. */
+    timeoutMs?: number;
+    /** Replaced in tests so backoff costs no wall-clock time. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Called before each wait; lets a client log or count retries. */
+    onRetry?: (info: {
+        attempt: number;
+        waitMs: number;
+        status?: number;
+        error?: unknown;
+    }) => void;
+}
+/** `fetch` init plus a per-call override of how many times to retry. */
+type RetryInit = RequestInit & {
+    retries?: number;
+};
+type RetryingFetch = (input: string | URL, init?: RetryInit) => Promise<Response>;
+/**
+ * Wrap a `fetch`-shaped function so it retries. When `request` is omitted the
+ * global fetch is looked up per call, so tests that stub it after a client
+ * was built still take effect.
+ */
+declare function fetchWithRetry(request?: typeof fetch, opts?: RetryOptions): RetryingFetch;
+
+declare const MAX_DOWNLOAD_BYTES: number;
+
 interface Balance {
     usd: number;
     generations: number;
@@ -4699,17 +4747,9 @@ declare class PixelLabError extends Error {
 }
 declare class PixelLabClient {
     private readonly apiKey;
-    private readonly timeoutMs;
+    private readonly http;
     constructor(apiKey: string, timeoutMs?: number);
-    /**
-     * Retries only what is safe to retry: transport failures, 429, and 5xx.
-     * A 4xx other than 429 is a bad request and retrying it just wastes time.
-     *
-     * POSTs that create objects are included, which is a deliberate trade: the
-     * failure mode of not retrying (a dropped asset in a 65-item run) is more
-     * common than the failure mode of retrying (a duplicate object), and a
-     * duplicate is visible and free to delete whereas a silent gap is neither.
-     */
+    /** Retries transport failures, 429, and 5xx; see http.ts for the policy. */
     private request;
     balance(): Promise<Balance>;
     /**
@@ -4824,6 +4864,19 @@ declare class PixelLabClient {
 }
 declare function clientFromEnv(): PixelLabClient;
 
+/**
+ * Hand a URL or file to the operating system's default handler. Before this
+ * lived in one place, the gallery and the review sheet only opened a browser
+ * on macOS; on Linux and Windows the server came up and nothing appeared,
+ * with the address printed to a terminal the person may not be watching.
+ *
+ * Returns the command used, for callers that print it. Failure to launch is
+ * deliberately quiet: the URL has already been printed, and that is the part
+ * that matters when there is no desktop to open it on.
+ */
+declare function openExternal(target: string, command?: string[]): string;
+declare function defaultOpenCommand(platform?: NodeJS.Platform): string[];
+
 declare class PixelLabProvider implements Provider {
     private readonly client;
     readonly id = "pixellab";
@@ -4912,11 +4965,13 @@ declare class RetroDiffusionClient {
     private readonly token;
     private readonly baseUrl;
     private readonly request;
-    constructor(token: string | undefined, baseUrl?: string, request?: typeof fetch);
+    constructor(token: string | undefined, baseUrl?: string, request?: typeof fetch, retry?: RetryOptions);
     submit(body: Record<string, unknown>): Promise<string>;
     quote(body: Record<string, unknown>): Promise<number>;
     task(id: string): Promise<TaskResponse>;
     balance(): Promise<number>;
+    /** Result URLs are signed; no token header, and the same retry policy as the API. */
+    download(url: string): Promise<Buffer>;
     private call;
 }
 /** Experimental native pixel-art still, tileset, and animation adapter. */
@@ -4987,12 +5042,13 @@ declare class ScenarioClient {
     private readonly apiSecret;
     private readonly baseUrl;
     private readonly request;
-    constructor(apiKey: string | undefined, apiSecret: string | undefined, baseUrl?: string, request?: typeof fetch);
+    constructor(apiKey: string | undefined, apiSecret: string | undefined, baseUrl?: string, request?: typeof fetch, retry?: RetryOptions);
     quote(modelId: string, body: Record<string, unknown>, projectId?: string): Promise<ScenarioQuote>;
     submit(modelId: string, body: Record<string, unknown>, projectId?: string): Promise<string>;
     job(id: string, projectId?: string): Promise<ScenarioJob>;
     asset(id: string, projectId?: string): Promise<ScenarioAsset>;
     download(url: string): Promise<Buffer>;
+    /** A connectivity check should answer fast, so it does not retry. */
     checkConnection(): Promise<void>;
     private call;
 }
@@ -5072,9 +5128,10 @@ interface ComfyImage {
     type: "output";
 }
 declare class ComfyUIClient {
-    private readonly request;
     readonly baseUrl: string;
-    constructor(baseUrl?: string, request?: typeof fetch);
+    private readonly request;
+    constructor(baseUrl?: string, request?: typeof fetch, retry?: RetryOptions);
+    /** A connectivity check should answer fast, so it does not retry. */
     checkConnection(): Promise<void>;
     submit(workflow: ComfyWorkflow): Promise<string>;
     uploadImage(bytes: Buffer, sha256: string, format: "png" | "jpeg"): Promise<string>;
@@ -5232,6 +5289,141 @@ declare function styleImagesBase64(loaded: LoadedManifest, styleId: string): Pro
 /** Reads dimensions without decoding pixel data. */
 declare function imageMetadata(buf: Buffer): Pick<ResolvedStyleImage, "width" | "height" | "format"> | null;
 
+type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
+interface QualityProfileInspection {
+    key: string;
+    state: QualityProfileState;
+    reason: string;
+    source: string | null;
+    sources?: string[];
+    output: string;
+    outputs?: string[];
+    record: string;
+}
+interface RefineQualityProfilesOptions {
+    fixerPython?: string;
+    force?: boolean;
+    /** @internal Alternate fixer command used by compatibility tests. */
+    fixerCommand?: string;
+    /** @internal Prefix arguments for the alternate fixer command. */
+    fixerArgsPrefix?: string[];
+}
+interface RefineQualityProfilesResult {
+    processed: number;
+    skipped: number;
+    failed: number;
+    items: QualityProfileInspection[];
+}
+/** Inspect one configured quality output without changing files or contacting a provider. */
+declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
+/** Refine every configured, selected asset while preserving current approvals. */
+declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
+/** Return approved derived files for a packaging command, or fail closed. */
+declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
+
+type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
+interface PlanItem {
+    spec: ResolvedSpec;
+    key: string;
+    state: PlanState;
+    reason: string;
+    /** Derived-art state. It never changes provider cost or generation actionability. */
+    quality?: QualityProfileInspection;
+}
+interface Plan {
+    items: PlanItem[];
+    /** Items that would incur provider cost if the plan were executed. */
+    actionable: PlanItem[];
+    /** Provider-scoped totals. Unlike units and accounts are never combined. */
+    groups: PlanGroup[];
+    /** Compatibility projection for a single provider group; null for mixed plans. */
+    cost: number | null;
+    /** Compatibility projection for a single provider group; null for mixed plans. */
+    costUnit: CostUnit | null;
+    candidates: number;
+}
+interface PlanGroup {
+    provider: string;
+    costUnit: CostUnit;
+    cost: number;
+    candidates: number;
+    actionable: PlanItem[];
+}
+type ResumeCommand = "poll" | "pick" | "fetch";
+interface ResumeAction {
+    command: ResumeCommand;
+    keys: string[];
+}
+/** The zero-cost command that advances one settled lock state. */
+declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
+/** Group current selected specs by the command that can resume them safely. */
+declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
+/**
+ * Diffs the manifest against the lockfile and the files on disk. Nothing here
+ * touches the network, so it is safe to run constantly — it is the cheap
+ * "what would this cost me?" question that should precede every real run.
+ */
+declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
+    force?: boolean;
+}): Promise<Plan>;
+declare function summarize(plan: Plan): Record<PlanState, number>;
+
+/**
+ * Opening a project used to be four calls in a fixed order, and the fourth
+ * was the one people forgot: `loadManifest`, `resolveSpecs`, `loadLock`, then
+ * `normalizeLockOutputPaths` so a lockfile written on another machine
+ * resolves against this checkout. The CLI, the gallery, and every example in
+ * LIBRARY.md repeated the sequence. `openProject` is that sequence, once,
+ * with the env files beside the manifest read first the way the CLI reads
+ * them, because the API key belongs with the project rather than the tool.
+ */
+interface OpenProjectOptions {
+    /** Lockfile to read. Defaults to `pixelkiln.lock.json` beside the manifest. */
+    lockPath?: string;
+    /** Keep only these style ids. Empty or omitted keeps every style. */
+    styles?: string[];
+    /** Keep only these asset ids. Empty or omitted keeps every asset. */
+    assets?: string[];
+    /**
+     * Read `.env.local` and `.env` from the manifest's directory, and from the
+     * working directory when that differs, into `process.env` before anything
+     * else. Never overrides a variable already set. On by default because a
+     * provider constructed later needs the key; pass false when the caller
+     * manages credentials itself.
+     */
+    env?: boolean;
+}
+interface Project {
+    /** Absolute path of the manifest. */
+    manifestPath: string;
+    /** Directory the manifest lives in. Every relative path resolves against it. */
+    root: string;
+    /** Absolute path of the lockfile, whether or not it exists yet. */
+    lockPath: string;
+    loaded: LoadedManifest;
+    /** Resolved specs after the style and asset filters. */
+    specs: ResolvedSpec[];
+    /** The lockfile with output paths canonicalised for this checkout. Mutated by pipeline calls; persist with `saveLock`. */
+    lock: Lock;
+    /** Diff manifest, lockfile, and disk. Offline; spends nothing. */
+    plan(opts?: {
+        force?: boolean;
+    }): Promise<Plan>;
+    /** Write `lock` as it stands, atomically. */
+    saveLock(): Promise<void>;
+    /** Read everything again from disk with the same options. */
+    reload(): Promise<Project>;
+    /** Provider ids the selected specs route to, sorted. */
+    providers(): string[];
+    /**
+     * One adapter per id and mode for the life of this object. `online` needs
+     * credentials and can spend; `downloads` only fetches objects the lockfile
+     * already records and needs no key.
+     */
+    provider(id: string, mode?: ProviderMode): Provider;
+}
+declare function openProject(manifestPath?: string, opts?: OpenProjectOptions): Promise<Project>;
+
 /**
  * The lockfile is the record that maps a spec to the provider work that
  * satisfies it and the file on disk that came from it. It is written after
@@ -6122,6 +6314,10 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     };
     styleId: string;
     version: string;
+    integrity: {
+        algorithm: "sha256";
+        digest: string;
+    };
     id: string;
     format: "pixelkiln-recipe";
     files: {
@@ -6177,10 +6373,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             base?: string | undefined;
         } | undefined;
     };
-    integrity: {
-        algorithm: "sha256";
-        digest: string;
-    };
     $schema?: string | undefined;
     workflow?: {
         path: string;
@@ -6243,6 +6435,10 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     };
     styleId: string;
     version: string;
+    integrity: {
+        algorithm: "sha256";
+        digest: string;
+    };
     id: string;
     format: "pixelkiln-recipe";
     schemaVersion: 1;
@@ -6287,10 +6483,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         tags?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     };
-    integrity: {
-        algorithm: "sha256";
-        digest: string;
-    };
     $schema?: string | undefined;
     workflow?: {
         path: string;
@@ -6364,6 +6556,10 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     };
     styleId: string;
     version: string;
+    integrity: {
+        algorithm: "sha256";
+        digest: string;
+    };
     id: string;
     format: "pixelkiln-recipe";
     files: {
@@ -6419,10 +6615,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
             base?: string | undefined;
         } | undefined;
     };
-    integrity: {
-        algorithm: "sha256";
-        digest: string;
-    };
     $schema?: string | undefined;
     workflow?: {
         path: string;
@@ -6485,6 +6677,10 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
     };
     styleId: string;
     version: string;
+    integrity: {
+        algorithm: "sha256";
+        digest: string;
+    };
     id: string;
     format: "pixelkiln-recipe";
     schemaVersion: 1;
@@ -6529,10 +6725,6 @@ declare const RecipeSchema: z.ZodEffects<z.ZodObject<{
         tags?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
     };
-    integrity: {
-        algorithm: "sha256";
-        digest: string;
-    };
     $schema?: string | undefined;
     workflow?: {
         path: string;
@@ -6648,85 +6840,6 @@ declare function verifyRecipe(target: string, options?: {
 }): Promise<RecipeVerification>;
 declare function installRecipe(target: string, options?: InstallRecipeOptions): Promise<InstallRecipeResult>;
 
-type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
-interface QualityProfileInspection {
-    key: string;
-    state: QualityProfileState;
-    reason: string;
-    source: string | null;
-    sources?: string[];
-    output: string;
-    outputs?: string[];
-    record: string;
-}
-interface RefineQualityProfilesOptions {
-    fixerPython?: string;
-    force?: boolean;
-    /** @internal Alternate fixer command used by compatibility tests. */
-    fixerCommand?: string;
-    /** @internal Prefix arguments for the alternate fixer command. */
-    fixerArgsPrefix?: string[];
-}
-interface RefineQualityProfilesResult {
-    processed: number;
-    skipped: number;
-    failed: number;
-    items: QualityProfileInspection[];
-}
-/** Inspect one configured quality output without changing files or contacting a provider. */
-declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
-/** Refine every configured, selected asset while preserving current approvals. */
-declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
-/** Return approved derived files for a packaging command, or fail closed. */
-declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
-
-type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
-interface PlanItem {
-    spec: ResolvedSpec;
-    key: string;
-    state: PlanState;
-    reason: string;
-    /** Derived-art state. It never changes provider cost or generation actionability. */
-    quality?: QualityProfileInspection;
-}
-interface Plan {
-    items: PlanItem[];
-    /** Items that would incur provider cost if the plan were executed. */
-    actionable: PlanItem[];
-    /** Provider-scoped totals. Unlike units and accounts are never combined. */
-    groups: PlanGroup[];
-    /** Compatibility projection for a single provider group; null for mixed plans. */
-    cost: number | null;
-    /** Compatibility projection for a single provider group; null for mixed plans. */
-    costUnit: CostUnit | null;
-    candidates: number;
-}
-interface PlanGroup {
-    provider: string;
-    costUnit: CostUnit;
-    cost: number;
-    candidates: number;
-    actionable: PlanItem[];
-}
-type ResumeCommand = "poll" | "pick" | "fetch";
-interface ResumeAction {
-    command: ResumeCommand;
-    keys: string[];
-}
-/** The zero-cost command that advances one settled lock state. */
-declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
-/** Group current selected specs by the command that can resume them safely. */
-declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
-/**
- * Diffs the manifest against the lockfile and the files on disk. Nothing here
- * touches the network, so it is safe to run constantly — it is the cheap
- * "what would this cost me?" question that should precede every real run.
- */
-declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
-    force?: boolean;
-}): Promise<Plan>;
-declare function summarize(plan: Plan): Record<PlanState, number>;
-
 interface DecodedPng {
     width: number;
     height: number;
@@ -9664,4 +9777,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, 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 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 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 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, detachHandEdit, detectMediaType, doctor, editorBaseUrl, editorDir, editorRoute, editorStatus, editorToolsRoot, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, 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, openInEditor, 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, 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 };