pixelkiln 0.34.1 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -5289,6 +5289,141 @@ declare function styleImagesBase64(loaded: LoadedManifest, styleId: string): Pro
5289
5289
  /** Reads dimensions without decoding pixel data. */
5290
5290
  declare function imageMetadata(buf: Buffer): Pick<ResolvedStyleImage, "width" | "height" | "format"> | null;
5291
5291
 
5292
+ type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
5293
+ interface QualityProfileInspection {
5294
+ key: string;
5295
+ state: QualityProfileState;
5296
+ reason: string;
5297
+ source: string | null;
5298
+ sources?: string[];
5299
+ output: string;
5300
+ outputs?: string[];
5301
+ record: string;
5302
+ }
5303
+ interface RefineQualityProfilesOptions {
5304
+ fixerPython?: string;
5305
+ force?: boolean;
5306
+ /** @internal Alternate fixer command used by compatibility tests. */
5307
+ fixerCommand?: string;
5308
+ /** @internal Prefix arguments for the alternate fixer command. */
5309
+ fixerArgsPrefix?: string[];
5310
+ }
5311
+ interface RefineQualityProfilesResult {
5312
+ processed: number;
5313
+ skipped: number;
5314
+ failed: number;
5315
+ items: QualityProfileInspection[];
5316
+ }
5317
+ /** Inspect one configured quality output without changing files or contacting a provider. */
5318
+ declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
5319
+ /** Refine every configured, selected asset while preserving current approvals. */
5320
+ declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
5321
+ /** Return approved derived files for a packaging command, or fail closed. */
5322
+ declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
5323
+
5324
+ type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
5325
+ interface PlanItem {
5326
+ spec: ResolvedSpec;
5327
+ key: string;
5328
+ state: PlanState;
5329
+ reason: string;
5330
+ /** Derived-art state. It never changes provider cost or generation actionability. */
5331
+ quality?: QualityProfileInspection;
5332
+ }
5333
+ interface Plan {
5334
+ items: PlanItem[];
5335
+ /** Items that would incur provider cost if the plan were executed. */
5336
+ actionable: PlanItem[];
5337
+ /** Provider-scoped totals. Unlike units and accounts are never combined. */
5338
+ groups: PlanGroup[];
5339
+ /** Compatibility projection for a single provider group; null for mixed plans. */
5340
+ cost: number | null;
5341
+ /** Compatibility projection for a single provider group; null for mixed plans. */
5342
+ costUnit: CostUnit | null;
5343
+ candidates: number;
5344
+ }
5345
+ interface PlanGroup {
5346
+ provider: string;
5347
+ costUnit: CostUnit;
5348
+ cost: number;
5349
+ candidates: number;
5350
+ actionable: PlanItem[];
5351
+ }
5352
+ type ResumeCommand = "poll" | "pick" | "fetch";
5353
+ interface ResumeAction {
5354
+ command: ResumeCommand;
5355
+ keys: string[];
5356
+ }
5357
+ /** The zero-cost command that advances one settled lock state. */
5358
+ declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
5359
+ /** Group current selected specs by the command that can resume them safely. */
5360
+ declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
5361
+ /**
5362
+ * Diffs the manifest against the lockfile and the files on disk. Nothing here
5363
+ * touches the network, so it is safe to run constantly — it is the cheap
5364
+ * "what would this cost me?" question that should precede every real run.
5365
+ */
5366
+ declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
5367
+ force?: boolean;
5368
+ }): Promise<Plan>;
5369
+ declare function summarize(plan: Plan): Record<PlanState, number>;
5370
+
5371
+ /**
5372
+ * Opening a project used to be four calls in a fixed order, and the fourth
5373
+ * was the one people forgot: `loadManifest`, `resolveSpecs`, `loadLock`, then
5374
+ * `normalizeLockOutputPaths` so a lockfile written on another machine
5375
+ * resolves against this checkout. The CLI, the gallery, and every example in
5376
+ * LIBRARY.md repeated the sequence. `openProject` is that sequence, once,
5377
+ * with the env files beside the manifest read first the way the CLI reads
5378
+ * them, because the API key belongs with the project rather than the tool.
5379
+ */
5380
+ interface OpenProjectOptions {
5381
+ /** Lockfile to read. Defaults to `pixelkiln.lock.json` beside the manifest. */
5382
+ lockPath?: string;
5383
+ /** Keep only these style ids. Empty or omitted keeps every style. */
5384
+ styles?: string[];
5385
+ /** Keep only these asset ids. Empty or omitted keeps every asset. */
5386
+ assets?: string[];
5387
+ /**
5388
+ * Read `.env.local` and `.env` from the manifest's directory, and from the
5389
+ * working directory when that differs, into `process.env` before anything
5390
+ * else. Never overrides a variable already set. On by default because a
5391
+ * provider constructed later needs the key; pass false when the caller
5392
+ * manages credentials itself.
5393
+ */
5394
+ env?: boolean;
5395
+ }
5396
+ interface Project {
5397
+ /** Absolute path of the manifest. */
5398
+ manifestPath: string;
5399
+ /** Directory the manifest lives in. Every relative path resolves against it. */
5400
+ root: string;
5401
+ /** Absolute path of the lockfile, whether or not it exists yet. */
5402
+ lockPath: string;
5403
+ loaded: LoadedManifest;
5404
+ /** Resolved specs after the style and asset filters. */
5405
+ specs: ResolvedSpec[];
5406
+ /** The lockfile with output paths canonicalised for this checkout. Mutated by pipeline calls; persist with `saveLock`. */
5407
+ lock: Lock;
5408
+ /** Diff manifest, lockfile, and disk. Offline; spends nothing. */
5409
+ plan(opts?: {
5410
+ force?: boolean;
5411
+ }): Promise<Plan>;
5412
+ /** Write `lock` as it stands, atomically. */
5413
+ saveLock(): Promise<void>;
5414
+ /** Read everything again from disk with the same options. */
5415
+ reload(): Promise<Project>;
5416
+ /** Provider ids the selected specs route to, sorted. */
5417
+ providers(): string[];
5418
+ /**
5419
+ * One adapter per id and mode for the life of this object. `online` needs
5420
+ * credentials and can spend; `downloads` only fetches objects the lockfile
5421
+ * already records and needs no key.
5422
+ */
5423
+ provider(id: string, mode?: ProviderMode): Provider;
5424
+ }
5425
+ declare function openProject(manifestPath?: string, opts?: OpenProjectOptions): Promise<Project>;
5426
+
5292
5427
  /**
5293
5428
  * The lockfile is the record that maps a spec to the provider work that
5294
5429
  * satisfies it and the file on disk that came from it. It is written after
@@ -6705,85 +6840,6 @@ declare function verifyRecipe(target: string, options?: {
6705
6840
  }): Promise<RecipeVerification>;
6706
6841
  declare function installRecipe(target: string, options?: InstallRecipeOptions): Promise<InstallRecipeResult>;
6707
6842
 
6708
- type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
6709
- interface QualityProfileInspection {
6710
- key: string;
6711
- state: QualityProfileState;
6712
- reason: string;
6713
- source: string | null;
6714
- sources?: string[];
6715
- output: string;
6716
- outputs?: string[];
6717
- record: string;
6718
- }
6719
- interface RefineQualityProfilesOptions {
6720
- fixerPython?: string;
6721
- force?: boolean;
6722
- /** @internal Alternate fixer command used by compatibility tests. */
6723
- fixerCommand?: string;
6724
- /** @internal Prefix arguments for the alternate fixer command. */
6725
- fixerArgsPrefix?: string[];
6726
- }
6727
- interface RefineQualityProfilesResult {
6728
- processed: number;
6729
- skipped: number;
6730
- failed: number;
6731
- items: QualityProfileInspection[];
6732
- }
6733
- /** Inspect one configured quality output without changing files or contacting a provider. */
6734
- declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
6735
- /** Refine every configured, selected asset while preserving current approvals. */
6736
- declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
6737
- /** Return approved derived files for a packaging command, or fail closed. */
6738
- declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
6739
-
6740
- type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
6741
- interface PlanItem {
6742
- spec: ResolvedSpec;
6743
- key: string;
6744
- state: PlanState;
6745
- reason: string;
6746
- /** Derived-art state. It never changes provider cost or generation actionability. */
6747
- quality?: QualityProfileInspection;
6748
- }
6749
- interface Plan {
6750
- items: PlanItem[];
6751
- /** Items that would incur provider cost if the plan were executed. */
6752
- actionable: PlanItem[];
6753
- /** Provider-scoped totals. Unlike units and accounts are never combined. */
6754
- groups: PlanGroup[];
6755
- /** Compatibility projection for a single provider group; null for mixed plans. */
6756
- cost: number | null;
6757
- /** Compatibility projection for a single provider group; null for mixed plans. */
6758
- costUnit: CostUnit | null;
6759
- candidates: number;
6760
- }
6761
- interface PlanGroup {
6762
- provider: string;
6763
- costUnit: CostUnit;
6764
- cost: number;
6765
- candidates: number;
6766
- actionable: PlanItem[];
6767
- }
6768
- type ResumeCommand = "poll" | "pick" | "fetch";
6769
- interface ResumeAction {
6770
- command: ResumeCommand;
6771
- keys: string[];
6772
- }
6773
- /** The zero-cost command that advances one settled lock state. */
6774
- declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
6775
- /** Group current selected specs by the command that can resume them safely. */
6776
- declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
6777
- /**
6778
- * Diffs the manifest against the lockfile and the files on disk. Nothing here
6779
- * touches the network, so it is safe to run constantly — it is the cheap
6780
- * "what would this cost me?" question that should precede every real run.
6781
- */
6782
- declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
6783
- force?: boolean;
6784
- }): Promise<Plan>;
6785
- declare function summarize(plan: Plan): Record<PlanState, number>;
6786
-
6787
6843
  interface DecodedPng {
6788
6844
  width: number;
6789
6845
  height: number;
@@ -9721,4 +9777,4 @@ interface WorkspaceStatusReport {
9721
9777
  */
9722
9778
  declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
9723
9779
 
9724
- 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 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 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, 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 };
9780
+ 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 };
package/dist/index.d.ts CHANGED
@@ -5289,6 +5289,141 @@ declare function styleImagesBase64(loaded: LoadedManifest, styleId: string): Pro
5289
5289
  /** Reads dimensions without decoding pixel data. */
5290
5290
  declare function imageMetadata(buf: Buffer): Pick<ResolvedStyleImage, "width" | "height" | "format"> | null;
5291
5291
 
5292
+ type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
5293
+ interface QualityProfileInspection {
5294
+ key: string;
5295
+ state: QualityProfileState;
5296
+ reason: string;
5297
+ source: string | null;
5298
+ sources?: string[];
5299
+ output: string;
5300
+ outputs?: string[];
5301
+ record: string;
5302
+ }
5303
+ interface RefineQualityProfilesOptions {
5304
+ fixerPython?: string;
5305
+ force?: boolean;
5306
+ /** @internal Alternate fixer command used by compatibility tests. */
5307
+ fixerCommand?: string;
5308
+ /** @internal Prefix arguments for the alternate fixer command. */
5309
+ fixerArgsPrefix?: string[];
5310
+ }
5311
+ interface RefineQualityProfilesResult {
5312
+ processed: number;
5313
+ skipped: number;
5314
+ failed: number;
5315
+ items: QualityProfileInspection[];
5316
+ }
5317
+ /** Inspect one configured quality output without changing files or contacting a provider. */
5318
+ declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
5319
+ /** Refine every configured, selected asset while preserving current approvals. */
5320
+ declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
5321
+ /** Return approved derived files for a packaging command, or fail closed. */
5322
+ declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
5323
+
5324
+ type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
5325
+ interface PlanItem {
5326
+ spec: ResolvedSpec;
5327
+ key: string;
5328
+ state: PlanState;
5329
+ reason: string;
5330
+ /** Derived-art state. It never changes provider cost or generation actionability. */
5331
+ quality?: QualityProfileInspection;
5332
+ }
5333
+ interface Plan {
5334
+ items: PlanItem[];
5335
+ /** Items that would incur provider cost if the plan were executed. */
5336
+ actionable: PlanItem[];
5337
+ /** Provider-scoped totals. Unlike units and accounts are never combined. */
5338
+ groups: PlanGroup[];
5339
+ /** Compatibility projection for a single provider group; null for mixed plans. */
5340
+ cost: number | null;
5341
+ /** Compatibility projection for a single provider group; null for mixed plans. */
5342
+ costUnit: CostUnit | null;
5343
+ candidates: number;
5344
+ }
5345
+ interface PlanGroup {
5346
+ provider: string;
5347
+ costUnit: CostUnit;
5348
+ cost: number;
5349
+ candidates: number;
5350
+ actionable: PlanItem[];
5351
+ }
5352
+ type ResumeCommand = "poll" | "pick" | "fetch";
5353
+ interface ResumeAction {
5354
+ command: ResumeCommand;
5355
+ keys: string[];
5356
+ }
5357
+ /** The zero-cost command that advances one settled lock state. */
5358
+ declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
5359
+ /** Group current selected specs by the command that can resume them safely. */
5360
+ declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
5361
+ /**
5362
+ * Diffs the manifest against the lockfile and the files on disk. Nothing here
5363
+ * touches the network, so it is safe to run constantly — it is the cheap
5364
+ * "what would this cost me?" question that should precede every real run.
5365
+ */
5366
+ declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
5367
+ force?: boolean;
5368
+ }): Promise<Plan>;
5369
+ declare function summarize(plan: Plan): Record<PlanState, number>;
5370
+
5371
+ /**
5372
+ * Opening a project used to be four calls in a fixed order, and the fourth
5373
+ * was the one people forgot: `loadManifest`, `resolveSpecs`, `loadLock`, then
5374
+ * `normalizeLockOutputPaths` so a lockfile written on another machine
5375
+ * resolves against this checkout. The CLI, the gallery, and every example in
5376
+ * LIBRARY.md repeated the sequence. `openProject` is that sequence, once,
5377
+ * with the env files beside the manifest read first the way the CLI reads
5378
+ * them, because the API key belongs with the project rather than the tool.
5379
+ */
5380
+ interface OpenProjectOptions {
5381
+ /** Lockfile to read. Defaults to `pixelkiln.lock.json` beside the manifest. */
5382
+ lockPath?: string;
5383
+ /** Keep only these style ids. Empty or omitted keeps every style. */
5384
+ styles?: string[];
5385
+ /** Keep only these asset ids. Empty or omitted keeps every asset. */
5386
+ assets?: string[];
5387
+ /**
5388
+ * Read `.env.local` and `.env` from the manifest's directory, and from the
5389
+ * working directory when that differs, into `process.env` before anything
5390
+ * else. Never overrides a variable already set. On by default because a
5391
+ * provider constructed later needs the key; pass false when the caller
5392
+ * manages credentials itself.
5393
+ */
5394
+ env?: boolean;
5395
+ }
5396
+ interface Project {
5397
+ /** Absolute path of the manifest. */
5398
+ manifestPath: string;
5399
+ /** Directory the manifest lives in. Every relative path resolves against it. */
5400
+ root: string;
5401
+ /** Absolute path of the lockfile, whether or not it exists yet. */
5402
+ lockPath: string;
5403
+ loaded: LoadedManifest;
5404
+ /** Resolved specs after the style and asset filters. */
5405
+ specs: ResolvedSpec[];
5406
+ /** The lockfile with output paths canonicalised for this checkout. Mutated by pipeline calls; persist with `saveLock`. */
5407
+ lock: Lock;
5408
+ /** Diff manifest, lockfile, and disk. Offline; spends nothing. */
5409
+ plan(opts?: {
5410
+ force?: boolean;
5411
+ }): Promise<Plan>;
5412
+ /** Write `lock` as it stands, atomically. */
5413
+ saveLock(): Promise<void>;
5414
+ /** Read everything again from disk with the same options. */
5415
+ reload(): Promise<Project>;
5416
+ /** Provider ids the selected specs route to, sorted. */
5417
+ providers(): string[];
5418
+ /**
5419
+ * One adapter per id and mode for the life of this object. `online` needs
5420
+ * credentials and can spend; `downloads` only fetches objects the lockfile
5421
+ * already records and needs no key.
5422
+ */
5423
+ provider(id: string, mode?: ProviderMode): Provider;
5424
+ }
5425
+ declare function openProject(manifestPath?: string, opts?: OpenProjectOptions): Promise<Project>;
5426
+
5292
5427
  /**
5293
5428
  * The lockfile is the record that maps a spec to the provider work that
5294
5429
  * satisfies it and the file on disk that came from it. It is written after
@@ -6705,85 +6840,6 @@ declare function verifyRecipe(target: string, options?: {
6705
6840
  }): Promise<RecipeVerification>;
6706
6841
  declare function installRecipe(target: string, options?: InstallRecipeOptions): Promise<InstallRecipeResult>;
6707
6842
 
6708
- type QualityProfileState = "blocked" | "needs-refinement" | "needs-approval" | "approved";
6709
- interface QualityProfileInspection {
6710
- key: string;
6711
- state: QualityProfileState;
6712
- reason: string;
6713
- source: string | null;
6714
- sources?: string[];
6715
- output: string;
6716
- outputs?: string[];
6717
- record: string;
6718
- }
6719
- interface RefineQualityProfilesOptions {
6720
- fixerPython?: string;
6721
- force?: boolean;
6722
- /** @internal Alternate fixer command used by compatibility tests. */
6723
- fixerCommand?: string;
6724
- /** @internal Prefix arguments for the alternate fixer command. */
6725
- fixerArgsPrefix?: string[];
6726
- }
6727
- interface RefineQualityProfilesResult {
6728
- processed: number;
6729
- skipped: number;
6730
- failed: number;
6731
- items: QualityProfileInspection[];
6732
- }
6733
- /** Inspect one configured quality output without changing files or contacting a provider. */
6734
- declare function inspectQualityProfile(spec: ResolvedSpec, lock: Lock): Promise<QualityProfileInspection | null>;
6735
- /** Refine every configured, selected asset while preserving current approvals. */
6736
- declare function refineQualityProfiles(specs: ResolvedSpec[], lock: Lock, options?: RefineQualityProfilesOptions): Promise<RefineQualityProfilesResult>;
6737
- /** Return approved derived files for a packaging command, or fail closed. */
6738
- declare function requireApprovedQualitySources(specs: ResolvedSpec[], lock: Lock, assetIds?: ReadonlySet<string>, outputRoles?: Readonly<Record<string, string>>): Promise<Record<string, string> | undefined>;
6739
-
6740
- type PlanState = "ok" | "missing" | "untracked" | "stale" | "orphaned" | "in-flight" | "recoverable" | "blocked" | "failed";
6741
- interface PlanItem {
6742
- spec: ResolvedSpec;
6743
- key: string;
6744
- state: PlanState;
6745
- reason: string;
6746
- /** Derived-art state. It never changes provider cost or generation actionability. */
6747
- quality?: QualityProfileInspection;
6748
- }
6749
- interface Plan {
6750
- items: PlanItem[];
6751
- /** Items that would incur provider cost if the plan were executed. */
6752
- actionable: PlanItem[];
6753
- /** Provider-scoped totals. Unlike units and accounts are never combined. */
6754
- groups: PlanGroup[];
6755
- /** Compatibility projection for a single provider group; null for mixed plans. */
6756
- cost: number | null;
6757
- /** Compatibility projection for a single provider group; null for mixed plans. */
6758
- costUnit: CostUnit | null;
6759
- candidates: number;
6760
- }
6761
- interface PlanGroup {
6762
- provider: string;
6763
- costUnit: CostUnit;
6764
- cost: number;
6765
- candidates: number;
6766
- actionable: PlanItem[];
6767
- }
6768
- type ResumeCommand = "poll" | "pick" | "fetch";
6769
- interface ResumeAction {
6770
- command: ResumeCommand;
6771
- keys: string[];
6772
- }
6773
- /** The zero-cost command that advances one settled lock state. */
6774
- declare function resumeCommandForStatus(status: LockEntry["status"]): ResumeCommand | null;
6775
- /** Group current selected specs by the command that can resume them safely. */
6776
- declare function resumeActions(specs: ResolvedSpec[], lock: Lock): ResumeAction[];
6777
- /**
6778
- * Diffs the manifest against the lockfile and the files on disk. Nothing here
6779
- * touches the network, so it is safe to run constantly — it is the cheap
6780
- * "what would this cost me?" question that should precede every real run.
6781
- */
6782
- declare function buildPlan(specs: ResolvedSpec[], lock: Lock, opts?: {
6783
- force?: boolean;
6784
- }): Promise<Plan>;
6785
- declare function summarize(plan: Plan): Record<PlanState, number>;
6786
-
6787
6843
  interface DecodedPng {
6788
6844
  width: number;
6789
6845
  height: number;
@@ -9721,4 +9777,4 @@ interface WorkspaceStatusReport {
9721
9777
  */
9722
9778
  declare function workspaceStatus(ws: Workspace, dir: string): Promise<WorkspaceStatusReport>;
9723
9779
 
9724
- 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 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 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, 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 };
9780
+ 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 };