pixelkiln 0.20.0 → 0.20.2

package/dist/index.d.cts

@@ -54,6 +54,20 @@ interface ProviderSubmission {
     /** Authoritative provider details known at submission, such as a live quote. */
     metadata?: ProviderMetadata;
 }
+/** Durable progress recorded after a provider accepts one part of a submission. */
+interface SubmissionCheckpoint extends ProviderSubmission {
+    /** False while more external requests are required for the same asset. */
+    complete: boolean;
+}
+/** Optional state for providers that submit one asset through several requests. */
+interface SubmitContext {
+    /** Persist accepted remote identity before the provider starts its next request. */
+    checkpoint(value: SubmissionCheckpoint): Promise<void>;
+    /** Incomplete checkpoint from an earlier run of this exact resolved spec. */
+    previousJobId?: string;
+    /** Provider-owned details saved with the previous checkpoint. */
+    previousMetadata?: ProviderMetadata;
+}
 interface CandidateSelection {
     objectId: string;
     sourceUrl: string | null;
@@ -191,7 +205,7 @@ interface Provider {
     /** This backend's own submission constraints. Falls back to
      *  `DEFAULT_RATE_LIMIT` when absent — see that constant's doc. */
     rateLimit?(): RateLimit;
-    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): Promise<ProviderSubmission>;
+    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[], context?: SubmitContext): Promise<ProviderSubmission>;
     poll(jobId: string, generator: Generator, context?: PollContext): Promise<JobState>;
     /**
      * Promote one candidate from a review-status job to a standalone asset.
@@ -3530,6 +3544,8 @@ declare const LockEntrySchema: z.ZodObject<{
     }>, "many">>;
     /** Set at submit time, before the request is awaited, so a crash is recoverable. */
     jobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** False only when a provider checkpoint says more requests remain. */
+    submissionComplete: z.ZodOptional<z.ZodBoolean>;
     /** For `1dir`: the multi-candidate parent object awaiting selection. */
     reviewObjectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     /** The chosen candidate's own object id, once selected. */
@@ -3636,6 +3652,7 @@ declare const LockEntrySchema: z.ZodObject<{
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
     }[] | undefined;
+    submissionComplete?: boolean | undefined;
 }, {
     width: number;
     height: number;
@@ -3661,6 +3678,7 @@ declare const LockEntrySchema: z.ZodObject<{
         mediaType?: "image/png" | "image/gif" | undefined;
     }[] | undefined;
     jobId?: string | null | undefined;
+    submissionComplete?: boolean | undefined;
     reviewObjectId?: string | null | undefined;
     objectId?: string | null | undefined;
     candidateIndex?: number | null | undefined;
@@ -3739,6 +3757,8 @@ declare const LockSchema: z.ZodObject<{
         }>, "many">>;
         /** Set at submit time, before the request is awaited, so a crash is recoverable. */
         jobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** False only when a provider checkpoint says more requests remain. */
+        submissionComplete: z.ZodOptional<z.ZodBoolean>;
         /** For `1dir`: the multi-candidate parent object awaiting selection. */
         reviewObjectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         /** The chosen candidate's own object id, once selected. */
@@ -3845,6 +3865,7 @@ declare const LockSchema: z.ZodObject<{
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
+        submissionComplete?: boolean | undefined;
     }, {
         width: number;
         height: number;
@@ -3870,6 +3891,7 @@ declare const LockSchema: z.ZodObject<{
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
+        submissionComplete?: boolean | undefined;
         reviewObjectId?: string | null | undefined;
         objectId?: string | null | undefined;
         candidateIndex?: number | null | undefined;
@@ -3939,6 +3961,7 @@ declare const LockSchema: z.ZodObject<{
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
+        submissionComplete?: boolean | undefined;
     }>;
     version: 2;
 }, {
@@ -3967,6 +3990,7 @@ declare const LockSchema: z.ZodObject<{
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
+        submissionComplete?: boolean | undefined;
         reviewObjectId?: string | null | undefined;
         objectId?: string | null | undefined;
         candidateIndex?: number | null | undefined;
@@ -4526,7 +4550,7 @@ declare class ComfyUIProvider implements Provider {
     estimate(spec: ResolvedSpec): CostEstimate;
     validate(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): void;
     rateLimit(): RateLimit;
-    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): Promise<ProviderSubmission>;
+    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[], context?: SubmitContext): Promise<ProviderSubmission>;
     poll(jobId: string, generator: Generator, context?: PollContext): Promise<JobState>;
     selectCandidate(jobId: string, index: number): Promise<{
         objectId: string;
@@ -7655,4 +7679,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 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_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, 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 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 ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, 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, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildManifest, buildPlan, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createProvider, currentEntryOutputPath, currentOutputPath, detectMediaType, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installRecipe, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, specHash, spendByUnit, 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 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_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, 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 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 ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, 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, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildManifest, buildPlan, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createProvider, currentEntryOutputPath, currentOutputPath, detectMediaType, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installRecipe, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };

package/dist/index.d.ts

@@ -54,6 +54,20 @@ interface ProviderSubmission {
     /** Authoritative provider details known at submission, such as a live quote. */
     metadata?: ProviderMetadata;
 }
+/** Durable progress recorded after a provider accepts one part of a submission. */
+interface SubmissionCheckpoint extends ProviderSubmission {
+    /** False while more external requests are required for the same asset. */
+    complete: boolean;
+}
+/** Optional state for providers that submit one asset through several requests. */
+interface SubmitContext {
+    /** Persist accepted remote identity before the provider starts its next request. */
+    checkpoint(value: SubmissionCheckpoint): Promise<void>;
+    /** Incomplete checkpoint from an earlier run of this exact resolved spec. */
+    previousJobId?: string;
+    /** Provider-owned details saved with the previous checkpoint. */
+    previousMetadata?: ProviderMetadata;
+}
 interface CandidateSelection {
     objectId: string;
     sourceUrl: string | null;
@@ -191,7 +205,7 @@ interface Provider {
     /** This backend's own submission constraints. Falls back to
      *  `DEFAULT_RATE_LIMIT` when absent — see that constant's doc. */
     rateLimit?(): RateLimit;
-    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): Promise<ProviderSubmission>;
+    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[], context?: SubmitContext): Promise<ProviderSubmission>;
     poll(jobId: string, generator: Generator, context?: PollContext): Promise<JobState>;
     /**
      * Promote one candidate from a review-status job to a standalone asset.
@@ -3530,6 +3544,8 @@ declare const LockEntrySchema: z.ZodObject<{
     }>, "many">>;
     /** Set at submit time, before the request is awaited, so a crash is recoverable. */
     jobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** False only when a provider checkpoint says more requests remain. */
+    submissionComplete: z.ZodOptional<z.ZodBoolean>;
     /** For `1dir`: the multi-candidate parent object awaiting selection. */
     reviewObjectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     /** The chosen candidate's own object id, once selected. */
@@ -3636,6 +3652,7 @@ declare const LockEntrySchema: z.ZodObject<{
         role?: string | undefined;
         mediaType?: "image/png" | "image/gif" | undefined;
     }[] | undefined;
+    submissionComplete?: boolean | undefined;
 }, {
     width: number;
     height: number;
@@ -3661,6 +3678,7 @@ declare const LockEntrySchema: z.ZodObject<{
         mediaType?: "image/png" | "image/gif" | undefined;
     }[] | undefined;
     jobId?: string | null | undefined;
+    submissionComplete?: boolean | undefined;
     reviewObjectId?: string | null | undefined;
     objectId?: string | null | undefined;
     candidateIndex?: number | null | undefined;
@@ -3739,6 +3757,8 @@ declare const LockSchema: z.ZodObject<{
         }>, "many">>;
         /** Set at submit time, before the request is awaited, so a crash is recoverable. */
         jobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** False only when a provider checkpoint says more requests remain. */
+        submissionComplete: z.ZodOptional<z.ZodBoolean>;
         /** For `1dir`: the multi-candidate parent object awaiting selection. */
         reviewObjectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         /** The chosen candidate's own object id, once selected. */
@@ -3845,6 +3865,7 @@ declare const LockSchema: z.ZodObject<{
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
+        submissionComplete?: boolean | undefined;
     }, {
         width: number;
         height: number;
@@ -3870,6 +3891,7 @@ declare const LockSchema: z.ZodObject<{
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
+        submissionComplete?: boolean | undefined;
         reviewObjectId?: string | null | undefined;
         objectId?: string | null | undefined;
         candidateIndex?: number | null | undefined;
@@ -3939,6 +3961,7 @@ declare const LockSchema: z.ZodObject<{
             role?: string | undefined;
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
+        submissionComplete?: boolean | undefined;
     }>;
     version: 2;
 }, {
@@ -3967,6 +3990,7 @@ declare const LockSchema: z.ZodObject<{
             mediaType?: "image/png" | "image/gif" | undefined;
         }[] | undefined;
         jobId?: string | null | undefined;
+        submissionComplete?: boolean | undefined;
         reviewObjectId?: string | null | undefined;
         objectId?: string | null | undefined;
         candidateIndex?: number | null | undefined;
@@ -4526,7 +4550,7 @@ declare class ComfyUIProvider implements Provider {
     estimate(spec: ResolvedSpec): CostEstimate;
     validate(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): void;
     rateLimit(): RateLimit;
-    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[]): Promise<ProviderSubmission>;
+    submit(spec: ResolvedSpec, styleImages: ResolvedStyleImage[], context?: SubmitContext): Promise<ProviderSubmission>;
     poll(jobId: string, generator: Generator, context?: PollContext): Promise<JobState>;
     selectCandidate(jobId: string, index: number): Promise<{
         objectId: string;
@@ -7655,4 +7679,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 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_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, 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 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 ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, type SheetGroup, type SiblingManifest, type SpriteInput, type Style, type StyleAudit, type StyleInput, StyleInputSchema, StyleSchema, 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, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildManifest, buildPlan, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createProvider, currentEntryOutputPath, currentOutputPath, detectMediaType, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installRecipe, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, specHash, spendByUnit, 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 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_QUALITY_TOLERANCES, DEFAULT_RATE_LIMIT, type DoctorCheck, type DoctorLevel, type DoctorOptions, type DoctorReport, FAKE_PNG, type FakeOptions, FakeProvider, type FetchResult, type Generator, GeneratorSchema, type GenericTileset, type GridConfidence, GridConfidenceSchema, type ImageQualityMetrics, ImageQualityMetricsSchema, InheritedStyleSchema, type InstallRecipeOptions, type InstallRecipeResult, type JobState, type LoadedManifest, type LoadedRecipe, type Lock, type LockEntry, LockEntrySchema, type LockOutput, LockSchema, MAX_DOWNLOAD_BYTES, MAX_RETRIES, type ManagedArtifactBundleOptions, type Manifest, 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 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 ResolvedOutput, type ResolvedProviderInputs, type ResolvedProviderOptions, type ResolvedQualityInput, type ResolvedQualityProfile, type ResolvedRevision, type ResolvedSpec, type ResolvedStyleImage, type ResumeAction, type ResumeCommand, type RetroDiffusionOptions, RetroDiffusionProvider, type ReviewReadyInfo, type Revision, type RevisionMode, RevisionModeSchema, type RevisionReadiness, RevisionSchema, type SalvageAction, type SalvageResult, type ScannedAsset, type ScenarioOptions, ScenarioProvider, 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, applyTags, approveQualityRecord, auditStyle, availableProviders, backoffMs, buildManifest, buildPlan, bundledRecipeRoot, cacheFileName, candidateCount, checkQualityBaseline, checkQualityRecord, clientFromEnv, colorDistance, countNumberedDescriptions, createArtifactBundleManifest, createProvider, currentEntryOutputPath, currentOutputPath, detectMediaType, doctor, evaluateAudit, expectedOutputPath, exportTileset, fallbackOutputRole, fetchAssets, findOrphans, formatCost, generationCost, groupOrphansByStyle, hex, idFromPrompt, imageMetadata, inspectCaches, inspectQualityProfile, inspectRevisionReadiness, installRecipe, isSensitiveSourceUrl, listBundledRecipes, loadClaims, loadLock, loadManifest, loadSiblingManifests, loadWorkspace, lockKey, matchOrphanStyle, measureBalanceChange, measureDecodedImageQuality, measureImageQuality, mediaExtension, mediaTypeFromExtension, mergePalettes, mountSprites, mountStyle, normalizeLockOutputPaths, normalizeRefinementPalette, normalizeTileRules, outliers, outputId, packSprites, packStyle, paletteDistance, parseLock, parseWorkspace, pngSize, poll, portableOutputPath, primaryOutput, providerCredentialEnvs, providerFactory, pushTags, qualityFrameOutputPath, qualityRecordPath, quantizeToPalette, readArtifactBundleManifest, readQualityBaseline, recipeDigest, refineAsset, refineFrameSet, refineQualityProfiles, registerProvider, remove, renderSalvageSheet, renderSheet, requireApprovedQualitySources, requireBalance, requireDelete, requireList, requireRevisionReady, requireSelectCandidate, resolveEntryOutputs, resolveOutputPath, resolvePackInputs, resolveProject, resolveQualityInputs, resolveRecipe, resolveSpecEntryOutputs, resolveSpecOutputs, resolveSpecs, resolveStyleImages, resolveStyleOutputs, resumeActions, resumeCommandForStatus, retryAfterMs, runPicker, runSalvage, saveLock, saveWorkspace, scanAssets, selectEntryOutput, sha256, sha256File, shouldPersistSourceUrl, shouldRetry, slugify, snapshotQualityBaseline, specHash, spendByUnit, styleImagesBase64, submit, summarize, tagAdopted, tileFeatureOutputCount, tileVariationCount, tilesCost, toPortablePath, totalSpend, upsert, validateCostEstimate, validateMedia, validateWorkspace, verifyArtifactBundle, verifyRecipe, withArtifactManifest, workspaceClaims, workspaceStatus, writeArtifactBundle, writeManagedArtifactBundle };

package/dist/index.js

@@ -349,6 +349,8 @@ var LockEntrySchema = z.object({
   ).optional(),
   /** Set at submit time, before the request is awaited, so a crash is recoverable. */
   jobId: z.string().nullable().default(null),
+  /** False only when a provider checkpoint says more requests remain. */
+  submissionComplete: z.boolean().optional(),
   /** For `1dir`: the multi-candidate parent object awaiting selection. */
   reviewObjectId: z.string().nullable().default(null),
   /** The chosen candidate's own object id, once selected. */
@@ -2781,7 +2783,7 @@ var ComfyUIProvider = class _ComfyUIProvider {
   rateLimit() {
     return { spacingMs: 0, maxInFlight: 1 };
   }
-  async submit(spec, styleImages) {
+  async submit(spec, styleImages, context) {
     this.validate(spec, styleImages);
     const options = resolvedOptions(spec);
     const uploadedImages = /* @__PURE__ */ new Map();
@@ -2823,22 +2825,35 @@ var ComfyUIProvider = class _ComfyUIProvider {
     if (spec.generator === "frames") {
       const frames = options.frames;
       const values = spec.providerInputs[frames.vary];
-      const promptIds = [];
-      for (let index = 0; index < values.length; index++) {
+      let promptIds = [];
+      if (context?.previousJobId) {
+        const previous = decodeFrameSetJob(context.previousJobId);
+        if (previous.outputNodeId !== options.outputNodeId || previous.expectedCount !== values.length) {
+          throw new Error("Saved ComfyUI frame checkpoint does not match the current frame set");
+        }
+        promptIds = [...previous.promptIds];
+      }
+      for (let index = promptIds.length; index < values.length; index++) {
         promptIds.push(await this.client.submit(await buildWorkflow(index)));
+        const frameJob2 = {
+          expectedCount: values.length,
+          promptIds: [...promptIds],
+          outputNodeId: options.outputNodeId
+        };
+        await context?.checkpoint({
+          jobId: encodeFrameSetJob(frameJob2),
+          metadata: comfyFrameSubmissionMetadata(spec, frameJob2),
+          complete: promptIds.length === values.length
+        });
       }
+      const frameJob = {
+        expectedCount: values.length,
+        promptIds,
+        outputNodeId: options.outputNodeId
+      };
       return {
-        jobId: encodeFrameSetJob({ promptIds, outputNodeId: options.outputNodeId }),
-        metadata: {
-          inputs,
-          frameSet: {
-            count: values.length,
-            vary: frames.vary,
-            seedStep: frames.seedStep,
-            fps: spec.quality?.fps ?? 12,
-            promptIds
-          }
-        }
+        jobId: encodeFrameSetJob(frameJob),
+        metadata: comfyFrameSubmissionMetadata(spec, frameJob)
       };
     }
     const workflow = await buildWorkflow();
@@ -2895,6 +2910,9 @@ var ComfyUIProvider = class _ComfyUIProvider {
   async poll(jobId, generator, context) {
     if (generator === "frames") {
       const frameJob = decodeFrameSetJob(jobId);
+      if (frameJob.promptIds.length < frameJob.expectedCount) {
+        return { status: "processing" };
+      }
       const images2 = [];
       for (let index = 0; index < frameJob.promptIds.length; index++) {
         const promptId2 = frameJob.promptIds[index];
@@ -3167,6 +3185,19 @@ function comfyFrameMetadata(spec, job, images, fps) {
     }
   };
 }
+function comfyFrameSubmissionMetadata(spec, job) {
+  const options = resolvedOptions(spec);
+  return {
+    inputs: providerInputProvenance(spec.providerInputs),
+    frameSet: {
+      count: job.expectedCount,
+      vary: options.frames.vary,
+      seedStep: options.frames.seedStep,
+      fps: spec.quality?.fps ?? 12,
+      promptIds: job.promptIds
+    }
+  };
+}
 function isImageBinding(workflow, binding) {
   const node = workflow[binding.nodeId];
   return binding.input === "image" && (node?.class_type === "LoadImage" || node?.class_type === "LoadImageMask");
@@ -3222,10 +3253,18 @@ function decodeFrameSetJob(jobId) {
   } catch {
     throw new Error(`Invalid ComfyUI frame-set job id "${jobId}"`);
   }
-  if (!isObject(value) || typeof value.outputNodeId !== "string" || !value.outputNodeId || !Array.isArray(value.promptIds) || value.promptIds.length < 2 || value.promptIds.length > 64 || !value.promptIds.every((id) => typeof id === "string" && id.length > 0)) {
+  if (!isObject(value) || !Array.isArray(value.promptIds)) {
     throw new Error(`Invalid ComfyUI frame-set job id "${jobId}"`);
   }
-  return { outputNodeId: value.outputNodeId, promptIds: value.promptIds };
+  const expectedCount = value.expectedCount === void 0 ? value.promptIds.length : value.expectedCount;
+  if (typeof value.outputNodeId !== "string" || !value.outputNodeId || typeof expectedCount !== "number" || !Number.isSafeInteger(expectedCount) || expectedCount < 2 || expectedCount > 64 || value.promptIds.length < 1 || value.promptIds.length > expectedCount || !value.promptIds.every((id) => typeof id === "string" && id.length > 0)) {
+    throw new Error(`Invalid ComfyUI frame-set job id "${jobId}"`);
+  }
+  return {
+    expectedCount,
+    outputNodeId: value.outputNodeId,
+    promptIds: value.promptIds
+  };
 }
 function decodeJob(jobId) {
   const split = jobId.lastIndexOf("#");
@@ -6171,6 +6210,7 @@ function resumeActions(specs, lock) {
     const key = lockKey(spec.styleId, spec.assetId);
     const entry = lock.entries[key];
     if (!entry || entry.specHash !== spec.specHash) continue;
+    if (entry.submissionComplete === false) continue;
     const command = resumeCommandForStatus(entry.status);
     if (!command) continue;
     if (command === "poll" && !entry.jobId) continue;
@@ -6221,10 +6261,13 @@ async function buildPlan(specs, lock, opts = {}) {
       reason = `${entry.error ?? "download failed"}; run pixelkiln fetch${force} (no generation cost)`;
     } else if (entry.status === "failed") {
       state = "failed";
-      reason = entry.error ?? "previous attempt failed";
+      reason = entry.jobId && entry.submissionComplete === false ? `${entry.error ?? "submission interrupted"}; saved checkpoint will resume` : entry.error ?? "previous attempt failed";
     } else if (entry.status === "selected") {
       state = "recoverable";
       reason = "provider output is selected; run pixelkiln fetch (no generation cost)";
+    } else if ((entry.status === "pending" || entry.status === "processing") && entry.jobId && entry.submissionComplete === false) {
+      state = "failed";
+      reason = "submission stopped after a saved checkpoint; rerun pixelkiln submit to resume";
     } else if (entry.status === "pending" || entry.status === "processing") {
       state = "in-flight";
       reason = entry.jobId ? "awaiting processing; run pixelkiln poll" : "submission state has no job id; run pixelkiln doctor before retrying";
@@ -7472,6 +7515,11 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
     if (since < spacing) await sleep2(spacing - since);
     await requireRevisionReady(spec, lock);
     const previousEntry = lock.entries[key];
+    const resumesCheckpoint = Boolean(
+      previousEntry?.specHash === spec.specHash && previousEntry.provider === provider.id && previousEntry.generator === spec.generator && previousEntry.submissionComplete === false && previousEntry.jobId
+    );
+    const previousJobId = resumesCheckpoint ? previousEntry.jobId : void 0;
+    const previousMetadata = resumesCheckpoint ? previousEntry.providerMetadata[provider.id] : void 0;
     const supersededOutputs = previousEntry?.outputs.length ? previousEntry.outputs : previousEntry?.supersededOutputs ?? [];
     upsert(lock, key, {
       styleId: spec.styleId,
@@ -7490,7 +7538,8 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
         ...spec.revision.strength == null ? {} : { strength: spec.revision.strength }
       } : null,
       status: "pending",
-      jobId: null,
+      jobId: previousJobId ?? null,
+      ...previousJobId ? { submissionComplete: false } : { submissionComplete: void 0 },
       objectId: null,
       reviewObjectId: null,
       candidateIndex: null,
@@ -7499,10 +7548,10 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
       // Keep the old ownership proof while new bytes are pending. Fetch may
       // replace that file only while its hash still matches this record.
       supersededOutputs,
-      providerMetadata: {},
+      providerMetadata: resumesCheckpoint ? previousEntry.providerMetadata : {},
       sourceUrl: null,
       sourceUrls: [],
-      submittedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      submittedAt: resumesCheckpoint ? previousEntry.submittedAt : (/* @__PURE__ */ new Date()).toISOString(),
       cost: estimate.amount,
       costUnit: estimate.unit,
       // Persist routing before the request starts. If the process stops while
@@ -7515,9 +7564,32 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
     lastSubmitAt = Date.now();
     try {
       const refs = styleImages.get(spec.styleId) ?? [];
-      const { jobId, metadata } = await provider.submit(spec, refs);
+      const { jobId, metadata } = await provider.submit(spec, refs, {
+        ...previousJobId ? { previousJobId } : {},
+        ...previousMetadata ? { previousMetadata } : {},
+        checkpoint: async (checkpoint) => {
+          if (!checkpoint.jobId) throw new Error("Provider checkpoint returned an empty job id");
+          const entry = lock.entries[key];
+          upsert(lock, key, {
+            jobId: checkpoint.jobId,
+            submissionComplete: checkpoint.complete,
+            reviewObjectId: checkpoint.complete && (spec.generator === "frames" || estimate.candidates > 1 && !spec.tileFeature) ? checkpoint.jobId : null,
+            status: checkpoint.complete ? "processing" : "pending",
+            error: null,
+            providerMetadata: checkpoint.metadata ? {
+              ...entry.providerMetadata,
+              [provider.id]: {
+                ...entry.providerMetadata[provider.id],
+                ...checkpoint.metadata
+              }
+            } : entry.providerMetadata
+          });
+          await saveLock(lockPath, lock);
+        }
+      });
       upsert(lock, key, {
         jobId,
+        submissionComplete: true,
         // A multi-candidate generator routes through review; record the parent
         // so `pick` knows where to look.
         reviewObjectId: spec.generator === "frames" || estimate.candidates > 1 && !spec.tileFeature ? jobId : null,
@@ -7531,10 +7603,23 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
         `  ${key} \u2192 ${jobId}  (${spec.width}x${spec.height}` + (estimate.candidates > 1 ? `, ${estimate.candidates} ${spec.tileFeature ? "outputs" : "candidates"}` : "") + `, ${estimate.amount})`
       );
     } catch (err) {
-      failed++;
       const message5 = err instanceof Error ? err.message : String(err);
-      upsert(lock, key, { status: "failed", error: message5, cost: 0 });
-      log(`  FAILED ${key}: ${message5}`);
+      const entry = lock.entries[key];
+      if (entry.jobId && entry.submissionComplete === true) {
+        upsert(lock, key, { status: "processing", error: null });
+        inFlight.set(entry.jobId, spec);
+        submitted++;
+        spent += estimate.amount;
+        log(`  ${key} \u2192 ${entry.jobId}  (recovered from completed checkpoint)`);
+      } else {
+        failed++;
+        upsert(lock, key, {
+          status: "failed",
+          error: message5,
+          cost: entry.jobId ? estimate.amount : 0
+        });
+        log(`  FAILED ${key}: ${message5}`);
+      }
     }
     await saveLock(lockPath, lock);
   }
@@ -7552,12 +7637,19 @@ async function poll(provider, lock, lockPath, opts = {}) {
   const specByKey = new Map((opts.specs ?? []).map((s) => [lockKey(s.styleId, s.assetId), s]));
   const selectedKeys = opts.specs ? new Set(specByKey.keys()) : null;
   const result = { review: 0, completed: 0, failed: 0, stillRunning: 0 };
+  const incompleteSubmissions = Object.entries(lock.entries).filter(
+    ([key, entry]) => entry.provider === provider.id && (!selectedKeys || selectedKeys.has(key)) && entry.jobId && entry.submissionComplete === false && (entry.status === "pending" || entry.status === "processing")
+  );
+  for (const [key] of incompleteSubmissions) {
+    log(`  incomplete submission ${key}; rerun \`pixelkiln submit\` to resume`);
+  }
+  result.stillRunning = incompleteSubmissions.length;
   const pending = () => Object.entries(lock.entries).filter(
-    ([key, e]) => e.provider === provider.id && (!selectedKeys || selectedKeys.has(key)) && e.jobId && (e.status === "pending" || e.status === "processing")
+    ([key, e]) => e.provider === provider.id && (!selectedKeys || selectedKeys.has(key)) && e.jobId && e.submissionComplete !== false && (e.status === "pending" || e.status === "processing")
   );
   while (pending().length > 0) {
     if (Date.now() - started > timeout) {
-      result.stillRunning = pending().length;
+      result.stillRunning += pending().length;
       log(`  timed out with ${result.stillRunning} job(s) still running \u2014 re-run \`poll\` to resume`);
       break;
     }
@@ -8206,7 +8298,10 @@ function renderSheet(groups) {
   .loop { display:flex; align-items:flex-start; gap:12px; margin-bottom:12px; }
   .loop img { image-rendering:pixelated; border:2px solid var(--accent); padding:7px;
     background:var(--panel-deep); max-width:min(var(--preview),calc(100vw - 62px)); height:auto; }
-  .loop-copy { color:var(--dim); font-size:11px; max-width:32ch; }
+  .loop-copy { color:var(--dim); font-size:11px; max-width:32ch; display:flex;
+    flex-direction:column; gap:8px; }
+  .loop-copy p { margin:0; }
+  .loop-copy button { align-self:flex-start; padding:5px 9px; font-size:10.5px; }
   .cand { border:2px solid var(--line-strong); border-radius:0; padding:7px; background:var(--panel-deep);
     cursor:pointer; display:flex; flex:0 0 auto; flex-direction:column; align-items:center; gap:5px;
     position:relative; max-width:100%; }
@@ -8310,15 +8405,49 @@ GROUPS.forEach((g, gi) => {
     preview.alt = 'Animated frame-set preview';
     const copy = document.createElement('div');
     copy.className = 'loop-copy';
-    copy.textContent = g.frameUrls.length + ' ordered frames \xB7 ' + (g.fps || 12) +
+    const copyText = document.createElement('p');
+    copyText.textContent = g.frameUrls.length + ' ordered frames \xB7 ' + (g.fps || 12) +
       ' fps. Accepting keeps every frame; one bad frame means leave the set unchosen.';
+    const playback = document.createElement('button');
+    playback.type = 'button';
+    let userPaused = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    let loopVisible = true;
+    let pageVisible = !document.hidden;
+    let loopTimer = null;
+    let loopIndex = 0;
+    const stopLoop = () => {
+      if (loopTimer !== null) window.clearInterval(loopTimer);
+      loopTimer = null;
+    };
+    const syncLoop = () => {
+      stopLoop();
+      playback.textContent = userPaused ? 'Play preview' : 'Pause preview';
+      playback.setAttribute('aria-pressed', String(userPaused));
+      if (!userPaused && loopVisible && pageVisible) {
+        loopTimer = window.setInterval(() => {
+          loopIndex = (loopIndex + 1) % g.frameUrls.length;
+          preview.src = g.frameUrls[loopIndex];
+        }, Math.max(16, Math.round(1000 / (g.fps || 12))));
+      }
+    };
+    playback.addEventListener('click', () => {
+      userPaused = !userPaused;
+      syncLoop();
+    });
+    copy.append(copyText, playback);
     loop.append(preview, copy);
     review.insertBefore(loop, frames);
-    let loopIndex = 0;
-    setInterval(() => {
-      loopIndex = (loopIndex + 1) % g.frameUrls.length;
-      preview.src = g.frameUrls[loopIndex];
-    }, Math.max(16, Math.round(1000 / (g.fps || 12))));
+    document.addEventListener('visibilitychange', () => {
+      pageVisible = !document.hidden;
+      syncLoop();
+    });
+    syncLoop();
+    if ('IntersectionObserver' in window) {
+      new IntersectionObserver((entries) => {
+        loopVisible = entries[0]?.isIntersecting ?? false;
+        syncLoop();
+      }).observe(loop);
+    }
   }
   g.frameUrls.forEach((url, i) => {
     const c = document.createElement('button');