@howells/motif-sdk 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -171,7 +171,6 @@ interface FalPricing {
 }
 interface LeaderboardMetric {
     elo: number;
-    pricePer1k?: number | null;
     rank: number;
     winRate?: number;
 }
@@ -457,6 +456,11 @@ declare function buildGenerateBody(options: GenerateOptions): {
 };
 
 interface LeaderboardEntry {
+    /**
+     * What the model's own vendor charges to run it through their API, as Artificial Analysis
+     * quoted it. Not what fal charges us - fal resells several of these for a fraction of the
+     * price. For our cost, read `falPricing` on the model in `models.ts`.
+     */
     apiPricing?: string;
     creator: string;
     elo: number;
@@ -1727,6 +1731,14 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "Seedream v5 Pro Layerize";
             readonly outputKeys: ["layers", "images"];
+            readonly outputLabels: {
+                readonly layers: {
+                    readonly fromItem: {
+                        readonly nameField: "name";
+                        readonly orderField: "z_index";
+                    };
+                };
+            };
             readonly price: {
                 readonly kind: "metered";
             };
@@ -1909,19 +1921,37 @@ interface FalToolConfig {
      * files: without it a PBR set lands as images-2.png, images-3.png and the
      * caller cannot tell a roughness map from a normal map.
      *
-     * `fromOption` names the request option that actually determines the order —
-     * read the resolved request body first and use its value when present, since
-     * a caller may reorder or subset it. `fallback` is the endpoint's schema
-     * default, used when the option is absent. Whichever is used, check the label
-     * count against the URL count before applying it: a mislabelled map is worse
-     * than a positional one, because it reads as authoritative.
+     * Two rule shapes, because the names come from two different places.
+     *
+     * Request-driven: `fromOption` names the request option that actually
+     * determines the order — read the resolved request body first and use its
+     * value when present, since a caller may reorder or subset it. `fallback` is
+     * the endpoint's schema default, used when the option is absent.
+     *
+     * Response-driven: `fromItem` reads the name off each element of the output
+     * array itself, for endpoints that label what they produced (seedream's
+     * layer stack names every layer). `nameField` holds the name and
+     * `orderField`, when set, holds a non-negative integer that prefixes it so
+     * the files sort in stack order. These strings come from a model, so the
+     * consumer slugifies them into a filename and keeps positional naming when
+     * nothing usable survives.
      *
-     * Only set this where the order is actually determined — by a request option
-     * or by the schema. Leave genuinely unordered arrays unlabelled.
+     * Whichever is used, check the label count against the URL count before
+     * applying it: a mislabelled map is worse than a positional one, because it
+     * reads as authoritative.
+     *
+     * Only set this where the order or the naming is actually determined — by a
+     * request option, by the schema, or by the response. Leave genuinely
+     * unordered, unnamed arrays unlabelled.
      */
     outputLabels?: Record<string, {
         fallback: readonly string[];
         fromOption?: string;
+    } | {
+        fromItem: {
+            nameField: string;
+            orderField?: string;
+        };
     }>;
     price: FalToolPrice;
     pricing: string;
@@ -3062,6 +3092,14 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "Seedream v5 Pro Layerize";
         readonly outputKeys: ["layers", "images"];
+        readonly outputLabels: {
+            readonly layers: {
+                readonly fromItem: {
+                    readonly nameField: "name";
+                    readonly orderField: "z_index";
+                };
+            };
+        };
         readonly price: {
             readonly kind: "metered";
         };
@@ -3202,4 +3240,147 @@ type FalToolId = (typeof FAL_TOOL_IDS)[number];
 declare function isFalToolId(tool: string): tool is FalToolId;
 declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
 
-export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, enrichPrompt, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv, sanitizePrompt };
+/**
+ * What a tool run costs, before it happens and after.
+ *
+ * The registry's `price` is a rate, not a total. Turning a rate into a figure
+ * needs something only one of the two moments has:
+ *
+ *   - Before the call, a `call` price is the whole answer and nothing else is.
+ *     A per-megapixel rate depends on an output that does not exist yet.
+ *   - After the call, the output exists and has been measured, so a
+ *     per-megapixel rate resolves exactly. Most of the restoration suite is
+ *     priced this way, which means most of what looked unknowable at dry-run
+ *     time is knowable by the time it reaches history.
+ *
+ * Both functions return `null` rather than `0` where the figure is genuinely
+ * unavailable. Zero is a claim that something was free, and every price defect
+ * found in this registry has been a confident wrong number rather than an
+ * absent one.
+ */
+
+/** Pixel dimensions of one file an endpoint returned. */
+interface OutputDimensions {
+    height?: number;
+    width?: number;
+}
+/** A cost, and enough context for a caller to say why it is what it is. */
+interface ResolvedCost {
+    /** USD, or null when the rate cannot be resolved against what we know. */
+    usd: number | null;
+    /**
+     * Whether `usd` was measured from real output or projected from the rate
+     * alone. Callers that display a figure should say which; an estimate and a
+     * bill are not the same claim.
+     */
+    basis: "measured" | "projected" | "unknown";
+}
+/**
+ * The figure to show before a run, from the rate alone.
+ *
+ * Only a flat per-call price survives this: everything else depends on an
+ * output that does not exist yet, and guessing its size is how a dry run comes
+ * to promise a number the invoice contradicts.
+ */
+declare function projectedToolCost(price: FalToolPrice): ResolvedCost;
+/**
+ * The figure to record after a run, from the rate and the output it produced.
+ *
+ * A per-megapixel rate becomes exact here, because the files have been written
+ * and measured. Per-second rates need a duration nothing in the image path
+ * carries, and metered endpoints publish no rate at all, so both stay unknown.
+ */
+declare function measuredToolCost(price: FalToolPrice, outputs: readonly OutputDimensions[]): ResolvedCost;
+/**
+ * Render a cost for a human. `null` never becomes "$0.000" - it says what it
+ * means, which is that nobody knows.
+ */
+declare function formatCost(usd: number | null): string;
+/**
+ * Sum costs that are known, and count the ones that are not.
+ *
+ * A running total that silently drops unknown runs reads as complete. Callers
+ * are expected to show both halves: "$1.23 plus 4 metered runs" is honest where
+ * "$1.23" is not.
+ */
+declare function sumCosts(costs: readonly (number | null)[]): {
+    known: number;
+    unknown: number;
+};
+
+/** One argument an endpoint accepts. */
+interface FalToolParameter {
+    /** Argument name, exactly as fal expects it in the request body. */
+    key: string;
+    /** fal's own default when the caller sends nothing. */
+    fallback?: boolean | number | string | readonly unknown[];
+    /** Whether fal rejects the request without it. */
+    required?: true;
+    /** Compact rendering of fal's declared type, e.g. `enum(a|b)`, `list[string]`. */
+    type: string;
+}
+declare const FAL_TOOL_PARAMETERS: Record<string, readonly FalToolParameter[]>;
+/** Arguments a tool accepts, including ones Motif does not surface as flags. */
+declare function falToolParameters(tool: string): readonly FalToolParameter[];
+
+interface ModelOutputShape {
+    /** File container the endpoint returns. */
+    container: string;
+    /** Whether the encoding preserves every pixel exactly. */
+    lossless: boolean;
+    /** Bits per channel. */
+    bitDepth?: number;
+    /** Whether the returned file carries an alpha channel. */
+    hasAlpha?: boolean;
+    /** JPEG chroma subsampling, e.g. "4:4:4" or "4:2:0". Absent for lossless containers. */
+    subsampling?: string;
+}
+declare const MODEL_OUTPUT: Record<string, ModelOutputShape>;
+
+/**
+ * What a model returns, and whether you can get something lossless out of it.
+ *
+ * Two facts live in different places and neither is useful alone:
+ *
+ *   - `MODEL_OUTPUT` (generated, measured from real bytes) says what arrives
+ *     when you ask for nothing.
+ *   - `supportsOutputFormat` on the model says whether you are allowed to ask
+ *     for something else.
+ *
+ * A caller who reads only the first concludes `flux2-pro` is lossy; it defaults
+ * to JPEG but returns PNG on request. A caller who reads only the second
+ * concludes `seedream5` is fine; the flag is false, and what that actually
+ * means is 4:2:0 chroma - averaged over 2x2 blocks, invisible in a photograph
+ * and destructive to anything dividing by alpha at a soft edge.
+ *
+ * So the answer is derived from both at read time rather than written down a
+ * third time. Every price and output-key defect in this registry came from one
+ * fact stored twice.
+ */
+
+/** Whether a lossless file can be obtained, and what it costs to ask. */
+type LosslessAvailability = 
+/** Lossless by default; ask for nothing. */
+"default"
+/** Lossy by default, lossless when `outputFormat` is set. */
+ | "on-request"
+/** No lossless route: the endpoint returns a lossy container and rejects the argument. */
+ | "unavailable"
+/** Not probed. Absence of evidence, not evidence of a limitation. */
+ | "unknown";
+/** Measured shape of what a model returns by default, if it has been probed. */
+declare function modelOutput(model: string): ModelOutputShape | undefined;
+/**
+ * Whether this model can produce a lossless file at all.
+ *
+ * The question a caller actually has, answered from the measured default and
+ * the accepted arguments together.
+ */
+declare function losslessAvailability(model: string): LosslessAvailability;
+/**
+ * One line a human or an agent can act on, e.g.
+ * `"jpeg 4:2:0, no lossless route"` or `"jpeg 4:4:4, PNG on request"`.
+ */
+declare function describeModelOutput(model: string): string;
+
+export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FAL_TOOL_PARAMETERS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolParameter, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, type LosslessAvailability, MODELS, MODEL_OUTPUT, type ModelConfig, type ModelOutputShape, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type OutputDimensions, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type ResolvedCost, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, describeModelOutput, enrichPrompt, estimateCost, estimateVideoCost, falToolParameters, formatCost, getFalKeyFromEnv, isFalToolId, losslessAvailability, measuredToolCost, modelOutput, motifEnvSchema, parseMotifEnv, projectedToolCost, sanitizePrompt, sumCosts };

package/dist/index.d.ts

@@ -171,7 +171,6 @@ interface FalPricing {
 }
 interface LeaderboardMetric {
     elo: number;
-    pricePer1k?: number | null;
     rank: number;
     winRate?: number;
 }
@@ -457,6 +456,11 @@ declare function buildGenerateBody(options: GenerateOptions): {
 };
 
 interface LeaderboardEntry {
+    /**
+     * What the model's own vendor charges to run it through their API, as Artificial Analysis
+     * quoted it. Not what fal charges us - fal resells several of these for a fraction of the
+     * price. For our cost, read `falPricing` on the model in `models.ts`.
+     */
     apiPricing?: string;
     creator: string;
     elo: number;
@@ -1727,6 +1731,14 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "Seedream v5 Pro Layerize";
             readonly outputKeys: ["layers", "images"];
+            readonly outputLabels: {
+                readonly layers: {
+                    readonly fromItem: {
+                        readonly nameField: "name";
+                        readonly orderField: "z_index";
+                    };
+                };
+            };
             readonly price: {
                 readonly kind: "metered";
             };
@@ -1909,19 +1921,37 @@ interface FalToolConfig {
      * files: without it a PBR set lands as images-2.png, images-3.png and the
      * caller cannot tell a roughness map from a normal map.
      *
-     * `fromOption` names the request option that actually determines the order —
-     * read the resolved request body first and use its value when present, since
-     * a caller may reorder or subset it. `fallback` is the endpoint's schema
-     * default, used when the option is absent. Whichever is used, check the label
-     * count against the URL count before applying it: a mislabelled map is worse
-     * than a positional one, because it reads as authoritative.
+     * Two rule shapes, because the names come from two different places.
+     *
+     * Request-driven: `fromOption` names the request option that actually
+     * determines the order — read the resolved request body first and use its
+     * value when present, since a caller may reorder or subset it. `fallback` is
+     * the endpoint's schema default, used when the option is absent.
+     *
+     * Response-driven: `fromItem` reads the name off each element of the output
+     * array itself, for endpoints that label what they produced (seedream's
+     * layer stack names every layer). `nameField` holds the name and
+     * `orderField`, when set, holds a non-negative integer that prefixes it so
+     * the files sort in stack order. These strings come from a model, so the
+     * consumer slugifies them into a filename and keeps positional naming when
+     * nothing usable survives.
      *
-     * Only set this where the order is actually determined — by a request option
-     * or by the schema. Leave genuinely unordered arrays unlabelled.
+     * Whichever is used, check the label count against the URL count before
+     * applying it: a mislabelled map is worse than a positional one, because it
+     * reads as authoritative.
+     *
+     * Only set this where the order or the naming is actually determined — by a
+     * request option, by the schema, or by the response. Leave genuinely
+     * unordered, unnamed arrays unlabelled.
      */
     outputLabels?: Record<string, {
         fallback: readonly string[];
         fromOption?: string;
+    } | {
+        fromItem: {
+            nameField: string;
+            orderField?: string;
+        };
     }>;
     price: FalToolPrice;
     pricing: string;
@@ -3062,6 +3092,14 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "Seedream v5 Pro Layerize";
         readonly outputKeys: ["layers", "images"];
+        readonly outputLabels: {
+            readonly layers: {
+                readonly fromItem: {
+                    readonly nameField: "name";
+                    readonly orderField: "z_index";
+                };
+            };
+        };
         readonly price: {
             readonly kind: "metered";
         };
@@ -3202,4 +3240,147 @@ type FalToolId = (typeof FAL_TOOL_IDS)[number];
 declare function isFalToolId(tool: string): tool is FalToolId;
 declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
 
-export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, enrichPrompt, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv, sanitizePrompt };
+/**
+ * What a tool run costs, before it happens and after.
+ *
+ * The registry's `price` is a rate, not a total. Turning a rate into a figure
+ * needs something only one of the two moments has:
+ *
+ *   - Before the call, a `call` price is the whole answer and nothing else is.
+ *     A per-megapixel rate depends on an output that does not exist yet.
+ *   - After the call, the output exists and has been measured, so a
+ *     per-megapixel rate resolves exactly. Most of the restoration suite is
+ *     priced this way, which means most of what looked unknowable at dry-run
+ *     time is knowable by the time it reaches history.
+ *
+ * Both functions return `null` rather than `0` where the figure is genuinely
+ * unavailable. Zero is a claim that something was free, and every price defect
+ * found in this registry has been a confident wrong number rather than an
+ * absent one.
+ */
+
+/** Pixel dimensions of one file an endpoint returned. */
+interface OutputDimensions {
+    height?: number;
+    width?: number;
+}
+/** A cost, and enough context for a caller to say why it is what it is. */
+interface ResolvedCost {
+    /** USD, or null when the rate cannot be resolved against what we know. */
+    usd: number | null;
+    /**
+     * Whether `usd` was measured from real output or projected from the rate
+     * alone. Callers that display a figure should say which; an estimate and a
+     * bill are not the same claim.
+     */
+    basis: "measured" | "projected" | "unknown";
+}
+/**
+ * The figure to show before a run, from the rate alone.
+ *
+ * Only a flat per-call price survives this: everything else depends on an
+ * output that does not exist yet, and guessing its size is how a dry run comes
+ * to promise a number the invoice contradicts.
+ */
+declare function projectedToolCost(price: FalToolPrice): ResolvedCost;
+/**
+ * The figure to record after a run, from the rate and the output it produced.
+ *
+ * A per-megapixel rate becomes exact here, because the files have been written
+ * and measured. Per-second rates need a duration nothing in the image path
+ * carries, and metered endpoints publish no rate at all, so both stay unknown.
+ */
+declare function measuredToolCost(price: FalToolPrice, outputs: readonly OutputDimensions[]): ResolvedCost;
+/**
+ * Render a cost for a human. `null` never becomes "$0.000" - it says what it
+ * means, which is that nobody knows.
+ */
+declare function formatCost(usd: number | null): string;
+/**
+ * Sum costs that are known, and count the ones that are not.
+ *
+ * A running total that silently drops unknown runs reads as complete. Callers
+ * are expected to show both halves: "$1.23 plus 4 metered runs" is honest where
+ * "$1.23" is not.
+ */
+declare function sumCosts(costs: readonly (number | null)[]): {
+    known: number;
+    unknown: number;
+};
+
+/** One argument an endpoint accepts. */
+interface FalToolParameter {
+    /** Argument name, exactly as fal expects it in the request body. */
+    key: string;
+    /** fal's own default when the caller sends nothing. */
+    fallback?: boolean | number | string | readonly unknown[];
+    /** Whether fal rejects the request without it. */
+    required?: true;
+    /** Compact rendering of fal's declared type, e.g. `enum(a|b)`, `list[string]`. */
+    type: string;
+}
+declare const FAL_TOOL_PARAMETERS: Record<string, readonly FalToolParameter[]>;
+/** Arguments a tool accepts, including ones Motif does not surface as flags. */
+declare function falToolParameters(tool: string): readonly FalToolParameter[];
+
+interface ModelOutputShape {
+    /** File container the endpoint returns. */
+    container: string;
+    /** Whether the encoding preserves every pixel exactly. */
+    lossless: boolean;
+    /** Bits per channel. */
+    bitDepth?: number;
+    /** Whether the returned file carries an alpha channel. */
+    hasAlpha?: boolean;
+    /** JPEG chroma subsampling, e.g. "4:4:4" or "4:2:0". Absent for lossless containers. */
+    subsampling?: string;
+}
+declare const MODEL_OUTPUT: Record<string, ModelOutputShape>;
+
+/**
+ * What a model returns, and whether you can get something lossless out of it.
+ *
+ * Two facts live in different places and neither is useful alone:
+ *
+ *   - `MODEL_OUTPUT` (generated, measured from real bytes) says what arrives
+ *     when you ask for nothing.
+ *   - `supportsOutputFormat` on the model says whether you are allowed to ask
+ *     for something else.
+ *
+ * A caller who reads only the first concludes `flux2-pro` is lossy; it defaults
+ * to JPEG but returns PNG on request. A caller who reads only the second
+ * concludes `seedream5` is fine; the flag is false, and what that actually
+ * means is 4:2:0 chroma - averaged over 2x2 blocks, invisible in a photograph
+ * and destructive to anything dividing by alpha at a soft edge.
+ *
+ * So the answer is derived from both at read time rather than written down a
+ * third time. Every price and output-key defect in this registry came from one
+ * fact stored twice.
+ */
+
+/** Whether a lossless file can be obtained, and what it costs to ask. */
+type LosslessAvailability = 
+/** Lossless by default; ask for nothing. */
+"default"
+/** Lossy by default, lossless when `outputFormat` is set. */
+ | "on-request"
+/** No lossless route: the endpoint returns a lossy container and rejects the argument. */
+ | "unavailable"
+/** Not probed. Absence of evidence, not evidence of a limitation. */
+ | "unknown";
+/** Measured shape of what a model returns by default, if it has been probed. */
+declare function modelOutput(model: string): ModelOutputShape | undefined;
+/**
+ * Whether this model can produce a lossless file at all.
+ *
+ * The question a caller actually has, answered from the measured default and
+ * the accepted arguments together.
+ */
+declare function losslessAvailability(model: string): LosslessAvailability;
+/**
+ * One line a human or an agent can act on, e.g.
+ * `"jpeg 4:2:0, no lossless route"` or `"jpeg 4:4:4, PNG on request"`.
+ */
+declare function describeModelOutput(model: string): string;
+
+export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FAL_TOOL_PARAMETERS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolParameter, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, type LosslessAvailability, MODELS, MODEL_OUTPUT, type ModelConfig, type ModelOutputShape, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type OutputDimensions, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type ResolvedCost, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, describeModelOutput, enrichPrompt, estimateCost, estimateVideoCost, falToolParameters, formatCost, getFalKeyFromEnv, isFalToolId, losslessAvailability, measuredToolCost, modelOutput, motifEnvSchema, parseMotifEnv, projectedToolCost, sanitizePrompt, sumCosts };