@fungi.computer/darkroom 0.0.0-stage → 0.0.1

package/dist/model-catalog.d.ts

@@ -0,0 +1,456 @@
+import * as z from "zod";
+/** An explicitly requested image encoding; video is outside this contract. */
+export declare const mediaRequestedImageFormatSchema: z.ZodEnum<{
+    /** PNG image encoding. */
+    readonly png: "png";
+    /** JPEG image encoding. */
+    readonly jpeg: "jpeg";
+    /** WebP image encoding. */
+    readonly webp: "webp";
+}>;
+/**
+ * Agent-facing selection tier: cheap/fast draft work, the balanced default,
+ * premium for art the user will see, and max for the most expensive models.
+ * One value per model; never a price.
+ */
+export declare const mediaModelTierSchema: z.ZodEnum<{
+    /** Cheap, fast draft model. */
+    readonly draft: "draft";
+    /** Balanced model selection. */
+    readonly balanced: "balanced";
+    /** Premium model selection. */
+    readonly premium: "premium";
+    /** Most expensive model selection. */
+    readonly max: "max";
+}>;
+/** A model selection tier, independent of billing price. */
+export type MediaModelTier = z.output<typeof mediaModelTierSchema>;
+/** Media's provider catalog: Workers AI images plus gateway image and video models. */
+export declare const mediaModelInputSchema: z.ZodReadonly<z.ZodObject<{
+    transport: z.ZodEnum<{
+        /** JSON provider input. */
+        readonly json: "json";
+        /** Multipart provider input. */
+        readonly multipart: "multipart";
+    }>;
+    dimensions: z.ZodEnum<{
+        /** Provider chooses its own dimensions. */
+        readonly none: "none";
+        /** Provider accepts the requested dimensions. */
+        readonly own: "own";
+    }>;
+    maxDimension: z.ZodNullable<z.ZodNumber>;
+    defaultWidth: z.ZodNumber;
+    defaultHeight: z.ZodNumber;
+    steps: z.ZodEnum<{
+        /** Provider reads the steps field. */
+        readonly steps: "steps";
+        /** Provider reads the num_steps field. */
+        readonly num_steps: "num_steps";
+        /** Provider uses fixed inference steps. */
+        readonly fixed: "fixed";
+    }>;
+    maxSteps: z.ZodNullable<z.ZodNumber>;
+    defaultSteps: z.ZodNullable<z.ZodNumber>;
+    referenceField: z.ZodNullable<z.ZodString>;
+    maxReferences: z.ZodNumber;
+}, z.core.$strict>>;
+/** Verified Unified AI video identifiers; no inferred family aliases. */
+export declare const mediaVideoModelIdSchema: z.ZodEnum<{
+    /** Seedance 2.0. */
+    readonly seedance: "bytedance/seedance-2.0";
+    /** Seedance 2.0 Fast. */
+    readonly seedanceFast: "bytedance/seedance-2.0-fast";
+    /** Seedance 2.0 Mini. */
+    readonly seedanceMini: "bytedance/seedance-2.0-mini";
+    /** Veo 3.1. */
+    readonly veo: "google/veo-3.1";
+    /** Veo 3.1 Fast. */
+    readonly veoFast: "google/veo-3.1-fast";
+    /** MiniMax H3 Max. */
+    readonly minimaxH3Max: "minimax/h3-max";
+}>;
+/** Verified video model identifier. */
+export type MediaVideoModelId = z.output<typeof mediaVideoModelIdSchema>;
+/** Provider resolution selectors, refined against the selected catalog entry. */
+export declare const mediaVideoResolutionSchema: z.ZodEnum<{
+    /** 480p. */
+    readonly p480: "480p";
+    /** 720p. */
+    readonly p720: "720p";
+    /** 768p, admitted only by MiniMax H3 Max. */
+    readonly p768: "768p";
+    /** 1080p. */
+    readonly p1080: "1080p";
+    /** 4k, admitted only by Seedance 2.0. */
+    readonly p4k: "4k";
+}>;
+/** A video resolution selector. */
+export type MediaVideoResolution = z.output<typeof mediaVideoResolutionSchema>;
+/** Documented video aspect selectors, refined per model. */
+export declare const mediaVideoAspectRatioSchema: z.ZodEnum<{
+    /** Landscape widescreen. */
+    readonly wide: "16:9";
+    /** Landscape standard. */
+    readonly landscape: "4:3";
+    /** Square. */
+    readonly square: "1:1";
+    /** Portrait standard. */
+    readonly portrait: "3:4";
+    /** Portrait widescreen. */
+    readonly tall: "9:16";
+    /** Landscape ultrawide. */
+    readonly ultrawide: "21:9";
+    /** Portrait ultrawide. */
+    readonly ultratall: "9:21";
+}>;
+/** A video aspect selector. */
+export type MediaVideoAspectRatio = z.output<typeof mediaVideoAspectRatioSchema>;
+/** Explicit reference meaning; frame mode and reference mode are exclusive. */
+export declare const mediaVideoReferenceRoleSchema: z.ZodEnum<{
+    /** First frame; required when a last frame is supplied. */
+    readonly first: "first-frame";
+    /** Last frame, supported by Seedance only. */
+    readonly last: "last-frame";
+    /** One image in Seedance reference-image mode. */
+    readonly reference: "reference";
+}>;
+/** The role of a selected reference image in a video request. */
+export type MediaVideoReferenceRole = z.output<typeof mediaVideoReferenceRoleSchema>;
+/** One nominal size used to select provider resolution and aspect. */
+export declare const mediaVideoFormatSchema: z.ZodReadonly<z.ZodObject<{
+    resolution: z.ZodEnum<{
+        /** 480p. */
+        readonly p480: "480p";
+        /** 720p. */
+        readonly p720: "720p";
+        /** 768p, admitted only by MiniMax H3 Max. */
+        readonly p768: "768p";
+        /** 1080p. */
+        readonly p1080: "1080p";
+        /** 4k, admitted only by Seedance 2.0. */
+        readonly p4k: "4k";
+    }>;
+    aspectRatio: z.ZodEnum<{
+        /** Landscape widescreen. */
+        readonly wide: "16:9";
+        /** Landscape standard. */
+        readonly landscape: "4:3";
+        /** Square. */
+        readonly square: "1:1";
+        /** Portrait standard. */
+        readonly portrait: "3:4";
+        /** Portrait widescreen. */
+        readonly tall: "9:16";
+        /** Landscape ultrawide. */
+        readonly ultrawide: "21:9";
+        /** Portrait ultrawide. */
+        readonly ultratall: "9:21";
+    }>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>>;
+/** One immutable nominal video format. */
+export type MediaVideoFormat = z.output<typeof mediaVideoFormatSchema>;
+/** Verified video parameters and provider costs, checked 2026-10-11. */
+export declare const mediaVideoSchema: z.ZodReadonly<z.ZodObject<{
+    minSeconds: z.ZodNumber;
+    maxSeconds: z.ZodNumber;
+    defaultSeconds: z.ZodNumber;
+    durations: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+    provider: z.ZodEnum<{
+        /** Seedance integer duration and data-URI image fields. */
+        readonly seedance: "seedance";
+        /** Veo duration string and base64 image_input. */
+        readonly veo: "veo";
+        /** MiniMax multimodal `content[]` array and uppercase resolution. */
+        readonly minimax: "minimax";
+    }>;
+    formats: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        resolution: z.ZodEnum<{
+            /** 480p. */
+            readonly p480: "480p";
+            /** 720p. */
+            readonly p720: "720p";
+            /** 768p, admitted only by MiniMax H3 Max. */
+            readonly p768: "768p";
+            /** 1080p. */
+            readonly p1080: "1080p";
+            /** 4k, admitted only by Seedance 2.0. */
+            readonly p4k: "4k";
+        }>;
+        aspectRatio: z.ZodEnum<{
+            /** Landscape widescreen. */
+            readonly wide: "16:9";
+            /** Landscape standard. */
+            readonly landscape: "4:3";
+            /** Square. */
+            readonly square: "1:1";
+            /** Portrait standard. */
+            readonly portrait: "3:4";
+            /** Portrait widescreen. */
+            readonly tall: "9:16";
+            /** Landscape ultrawide. */
+            readonly ultrawide: "21:9";
+            /** Portrait ultrawide. */
+            readonly ultratall: "9:21";
+        }>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>>>;
+    defaultResolution: z.ZodEnum<{
+        /** 480p. */
+        readonly p480: "480p";
+        /** 720p. */
+        readonly p720: "720p";
+        /** 768p, admitted only by MiniMax H3 Max. */
+        readonly p768: "768p";
+        /** 1080p. */
+        readonly p1080: "1080p";
+        /** 4k, admitted only by Seedance 2.0. */
+        readonly p4k: "4k";
+    }>;
+    defaultAspectRatio: z.ZodEnum<{
+        /** Landscape widescreen. */
+        readonly wide: "16:9";
+        /** Landscape standard. */
+        readonly landscape: "4:3";
+        /** Square. */
+        readonly square: "1:1";
+        /** Portrait standard. */
+        readonly portrait: "3:4";
+        /** Portrait widescreen. */
+        readonly tall: "9:16";
+        /** Landscape ultrawide. */
+        readonly ultrawide: "21:9";
+        /** Portrait ultrawide. */
+        readonly ultratall: "9:21";
+    }>;
+    defaultGenerateAudio: z.ZodNullable<z.ZodBoolean>;
+    maxPromptLength: z.ZodNumber;
+    referenceRoles: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        /** First frame; required when a last frame is supplied. */
+        readonly first: "first-frame";
+        /** Last frame, supported by Seedance only. */
+        readonly last: "last-frame";
+        /** One image in Seedance reference-image mode. */
+        readonly reference: "reference";
+    }>>>;
+    maxReferenceImages: z.ZodNumber;
+    referenceResolutions: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        /** 480p. */
+        readonly p480: "480p";
+        /** 720p. */
+        readonly p720: "720p";
+        /** 768p, admitted only by MiniMax H3 Max. */
+        readonly p768: "768p";
+        /** 1080p. */
+        readonly p1080: "1080p";
+        /** 4k, admitted only by Seedance 2.0. */
+        readonly p4k: "4k";
+    }>>>;
+    prices: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        resolution: z.ZodEnum<{
+            /** 480p. */
+            readonly p480: "480p";
+            /** 720p. */
+            readonly p720: "720p";
+            /** 768p, admitted only by MiniMax H3 Max. */
+            readonly p768: "768p";
+            /** 1080p. */
+            readonly p1080: "1080p";
+            /** 4k, admitted only by Seedance 2.0. */
+            readonly p4k: "4k";
+        }>;
+        silentMilliunitsPerSecond: z.ZodNumber;
+        audioMilliunitsPerSecond: z.ZodNumber;
+    }, z.core.$strict>>>>;
+}, z.core.$strict>>;
+/** Immutable video capability and price metadata. */
+export type MediaVideoModel = z.output<typeof mediaVideoSchema>;
+/** Public wire grammar for a catalog entry returned by the Media owner. */
+export declare const mediaModelSchema: z.ZodReadonly<z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    kind: z.ZodEnum<{
+        /** Still-image generation. */
+        readonly image: "image";
+        /** Video generation. */
+        readonly video: "video";
+    }>;
+    tier: z.ZodEnum<{
+        /** Cheap, fast draft model. */
+        readonly draft: "draft";
+        /** Balanced model selection. */
+        readonly balanced: "balanced";
+        /** Premium model selection. */
+        readonly premium: "premium";
+        /** Most expensive model selection. */
+        readonly max: "max";
+    }>;
+    outputFormats: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        /** PNG image encoding. */
+        readonly png: "png";
+        /** JPEG image encoding. */
+        readonly jpeg: "jpeg";
+        /** WebP image encoding. */
+        readonly webp: "webp";
+    }>>>;
+    input: z.ZodReadonly<z.ZodObject<{
+        transport: z.ZodEnum<{
+            /** JSON provider input. */
+            readonly json: "json";
+            /** Multipart provider input. */
+            readonly multipart: "multipart";
+        }>;
+        dimensions: z.ZodEnum<{
+            /** Provider chooses its own dimensions. */
+            readonly none: "none";
+            /** Provider accepts the requested dimensions. */
+            readonly own: "own";
+        }>;
+        maxDimension: z.ZodNullable<z.ZodNumber>;
+        defaultWidth: z.ZodNumber;
+        defaultHeight: z.ZodNumber;
+        steps: z.ZodEnum<{
+            /** Provider reads the steps field. */
+            readonly steps: "steps";
+            /** Provider reads the num_steps field. */
+            readonly num_steps: "num_steps";
+            /** Provider uses fixed inference steps. */
+            readonly fixed: "fixed";
+        }>;
+        maxSteps: z.ZodNullable<z.ZodNumber>;
+        defaultSteps: z.ZodNullable<z.ZodNumber>;
+        referenceField: z.ZodNullable<z.ZodString>;
+        maxReferences: z.ZodNumber;
+    }, z.core.$strict>>;
+    sizes: z.ZodNullable<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+    video: z.ZodNullable<z.ZodReadonly<z.ZodObject<{
+        minSeconds: z.ZodNumber;
+        maxSeconds: z.ZodNumber;
+        defaultSeconds: z.ZodNumber;
+        durations: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        provider: z.ZodEnum<{
+            /** Seedance integer duration and data-URI image fields. */
+            readonly seedance: "seedance";
+            /** Veo duration string and base64 image_input. */
+            readonly veo: "veo";
+            /** MiniMax multimodal `content[]` array and uppercase resolution. */
+            readonly minimax: "minimax";
+        }>;
+        formats: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                /** 480p. */
+                readonly p480: "480p";
+                /** 720p. */
+                readonly p720: "720p";
+                /** 768p, admitted only by MiniMax H3 Max. */
+                readonly p768: "768p";
+                /** 1080p. */
+                readonly p1080: "1080p";
+                /** 4k, admitted only by Seedance 2.0. */
+                readonly p4k: "4k";
+            }>;
+            aspectRatio: z.ZodEnum<{
+                /** Landscape widescreen. */
+                readonly wide: "16:9";
+                /** Landscape standard. */
+                readonly landscape: "4:3";
+                /** Square. */
+                readonly square: "1:1";
+                /** Portrait standard. */
+                readonly portrait: "3:4";
+                /** Portrait widescreen. */
+                readonly tall: "9:16";
+                /** Landscape ultrawide. */
+                readonly ultrawide: "21:9";
+                /** Portrait ultrawide. */
+                readonly ultratall: "9:21";
+            }>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>>>;
+        defaultResolution: z.ZodEnum<{
+            /** 480p. */
+            readonly p480: "480p";
+            /** 720p. */
+            readonly p720: "720p";
+            /** 768p, admitted only by MiniMax H3 Max. */
+            readonly p768: "768p";
+            /** 1080p. */
+            readonly p1080: "1080p";
+            /** 4k, admitted only by Seedance 2.0. */
+            readonly p4k: "4k";
+        }>;
+        defaultAspectRatio: z.ZodEnum<{
+            /** Landscape widescreen. */
+            readonly wide: "16:9";
+            /** Landscape standard. */
+            readonly landscape: "4:3";
+            /** Square. */
+            readonly square: "1:1";
+            /** Portrait standard. */
+            readonly portrait: "3:4";
+            /** Portrait widescreen. */
+            readonly tall: "9:16";
+            /** Landscape ultrawide. */
+            readonly ultrawide: "21:9";
+            /** Portrait ultrawide. */
+            readonly ultratall: "9:21";
+        }>;
+        defaultGenerateAudio: z.ZodNullable<z.ZodBoolean>;
+        maxPromptLength: z.ZodNumber;
+        referenceRoles: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            /** First frame; required when a last frame is supplied. */
+            readonly first: "first-frame";
+            /** Last frame, supported by Seedance only. */
+            readonly last: "last-frame";
+            /** One image in Seedance reference-image mode. */
+            readonly reference: "reference";
+        }>>>;
+        maxReferenceImages: z.ZodNumber;
+        referenceResolutions: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+            /** 480p. */
+            readonly p480: "480p";
+            /** 720p. */
+            readonly p720: "720p";
+            /** 768p, admitted only by MiniMax H3 Max. */
+            readonly p768: "768p";
+            /** 1080p. */
+            readonly p1080: "1080p";
+            /** 4k, admitted only by Seedance 2.0. */
+            readonly p4k: "4k";
+        }>>>;
+        prices: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+            resolution: z.ZodEnum<{
+                /** 480p. */
+                readonly p480: "480p";
+                /** 720p. */
+                readonly p720: "720p";
+                /** 768p, admitted only by MiniMax H3 Max. */
+                readonly p768: "768p";
+                /** 1080p. */
+                readonly p1080: "1080p";
+                /** 4k, admitted only by Seedance 2.0. */
+                readonly p4k: "4k";
+            }>;
+            silentMilliunitsPerSecond: z.ZodNumber;
+            audioMilliunitsPerSecond: z.ZodNumber;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+/** Model-specific dimensions, steps, transport and reference limits. */
+export type MediaModelInput = z.output<typeof mediaModelInputSchema>;
+/** One immutable provider catalog entry. */
+export type MediaModel = z.output<typeof mediaModelSchema>;
+/** The immutable image and video model catalog. */
+export declare const mediaModels: readonly MediaModel[];
+/** List all image and video models in catalog order. */
+export declare const listMediaModels: () => readonly MediaModel[];
+/** Find a model by provider identifier, returning undefined when it is absent. */
+export declare const getMediaModel: (id: string) => MediaModel | undefined;
+/** Invalid generation settings or unsupported model parameters. */
+export declare class MediaSettingsError extends Error {
+    constructor(message: string);
+}