@howells/motif-sdk 2.0.0 → 4.0.0

package/dist/index.d.ts

@@ -4,10 +4,11 @@ import { z } from "zod";
 /**
  * Creative direction fields applied to prompts in Motif's canonical order.
  *
- * The order matters when multiple fields are selected because prompt clauses
- * are appended in this sequence for stable dry runs, tests, and history.
+ * A look sets the overall register of the image; a mood sets its light. The
+ * order matters because clauses are appended look first, then mood, for
+ * stable dry runs, tests, and history.
  */
-type CreativeField = "recipe" | "shot" | "lighting" | "genre" | "camera" | "color" | "material" | "motion";
+type CreativeField = "look" | "mood";
 /**
  * Selected creative option ids keyed by direction field.
  *
@@ -17,7 +18,7 @@ type CreativeField = "recipe" | "shot" | "lighting" | "genre" | "camera" | "colo
 type CreativeDirection = Partial<Record<CreativeField, string>>;
 /** A single selectable creative direction option exposed to CLI and MCP schemas. */
 interface CreativeOption {
-  /** Prompt fragment appended when this option is selected. */
+  /** Prompt sentence appended when this option is selected. */
   clause: string;
   /** Human-facing explanation used in schema metadata and generated docs. */
   description: string;
@@ -26,6 +27,26 @@ interface CreativeOption {
   /** Short display label for UIs and schema enum descriptions. */
   label: string;
 }
+/**
+ * A house look: a creative option that also carries the aspect ratio and
+ * model it was tuned for. Callers apply these only when the user named none.
+ */
+interface LookOption extends CreativeOption {
+  /**
+   * Whether a mood may be combined with this look. Flat looks (surfaces,
+   * prints, paintings, studio objects) carry their own light and refuse one.
+   */
+  acceptsMood: boolean;
+  /** Default aspect ratio, e.g. `"3:2"`. */
+  aspect: AspectRatio;
+  /**
+   * Marks a look still being tuned. It works, but its text and defaults may
+   * change more than the others.
+   */
+  experimental?: boolean;
+  /** Default generation Model id, e.g. `"flux2-pro"`. */
+  model: string;
+}
 /** Structured details returned when a creative direction id is not recognized. */
 interface CreativeOptionErrorDetails {
   availableIds: string[];
@@ -44,66 +65,160 @@ export declare class CreativeOptionError extends Error implements CreativeOption
   readonly code = "INVALID_OPTION";
   readonly field: CreativeField;
   readonly value: string;
-  constructor(details: Omit<CreativeOptionErrorDetails, "code">);
+  constructor(details: Omit<CreativeOptionErrorDetails, "code">, message?: string);
 }
 /** Canonical creative field order used for prompt enrichment and schema output. */
-export declare const CREATIVE_FIELDS: readonly ["recipe", "shot", "lighting", "genre", "camera", "color", "material", "motion"];
+export declare const CREATIVE_FIELDS: readonly ["look", "mood"];
 /**
- * Built-in creative direction catalog.
+ * Built-in creative direction catalogue: twelve house looks and six light moods.
  *
- * Each field contains the option ids accepted by `CreativeDirection` and the
- * exact prompt clause that will be appended when selected.
+ * Each option carries the exact prompt sentence appended when it is selected.
+ * Looks also carry the aspect ratio and model they were tuned for.
  */
 export declare const CREATIVE_TAXONOMY: {
-  readonly camera: readonly [{
-    readonly clause: "macro product photography with crisp surface detail";
-    readonly description: "Product-oriented macro camera language for close detail.";
-    readonly id: "macro-product";
-    readonly label: "Macro product";
+  readonly look: readonly [{
+    readonly acceptsMood: true;
+    readonly aspect: "1:1";
+    readonly clause: "Editorial photograph in the register of Atelier Ellis, Aman hotels, Kinfolk magazine and Aesop, pigment-rich mineral colour on named matte surfaces, quiet composition with generous negative space, shallow depth of field, shot on film with fine grain, restrained and materially rich. No text, no logos, no people";
+    readonly description: "Quiet, materially rich editorial photography for brand and mood imagery.";
+    readonly id: "editorial";
+    readonly label: "Quiet editorial";
+    readonly model: "flux2-pro";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "1:1";
+    readonly clause: "Editorial still life on a warm bone plaster ground, chalky unglazed surfaces, a long soft shadow, generous empty space, shot on film with fine grain. No text, no logos, no people";
+    readonly description: "Objects and material samples on a plaster ground, for product and swatch shots.";
+    readonly id: "still-life";
+    readonly label: "Material still life";
+    readonly model: "flux2-pro";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "3:2";
+    readonly clause: "Interior photograph shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, slightly imperfect and lived-in rather than showroom-perfect, photographic realism. No text, no logos, no people";
+    readonly description: "Bright, collected rooms that feel lived in, for interior scenes.";
+    readonly id: "lived-in";
+    readonly label: "Lived-in interior";
+    readonly model: "flux2-pro";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "4:5";
+    readonly clause: "Architectural editorial photograph at full room scale, honest materials meeting precise detailing, one hero element genuinely installed, plausible light and shadow, generous negative space, empty of people. No text, no logos";
+    readonly description: "Whole rooms with one product installed, for showing a material at scale.";
+    readonly id: "architectural";
+    readonly label: "Architectural scale";
+    readonly model: "banana";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "4:3";
+    readonly clause: "Amateur phone photo of a real home taken by the homeowner, slightly wonky framing, unstyled domestic photography, ordinary exposure. No text, no people";
+    readonly description: "Unstyled phone snapshots of real homes, for believable before and after shots.";
+    readonly id: "homeowner";
+    readonly label: "Homeowner snapshot";
+    readonly model: "seedream45";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "1:1";
+    readonly clause: "Stylised architectural illustration of the room, colour laid as flat planes on walls, joinery and trim, fine hand-drawn line with a gentle gouache wash, clearly a drawing of a design decision rather than a photograph. No text, no people";
+    readonly description: "Line and gouache room drawings, for showing a colour scheme as a design idea.";
+    readonly experimental: true;
+    readonly id: "drawing";
+    readonly label: "Palette drawing";
+    readonly model: "gpt2";
+  }, {
+    readonly acceptsMood: false;
+    readonly aspect: "1:1";
+    readonly clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate. No text, no logos";
+    readonly description: "Flat, edge-to-edge surface photographs, for textures and material swatches.";
+    readonly id: "plate";
+    readonly label: "Flat plate";
+    readonly model: "flux2-pro";
+  }, {
+    readonly acceptsMood: false;
+    readonly aspect: "1:1";
+    readonly clause: "Fine hand-engraved botanical plate with delicate hatching and dry brush, grey ink only, reaching near-black at its densest, on matte uncoated stock under flat even light, cropped mid-motif and running past all four edges, never simplified or cartoonish. No text";
+    readonly description: "Grey-ink botanical engravings that run off the edges, for patterns and backgrounds.";
+    readonly id: "engraved";
+    readonly label: "Engraved grey ink";
+    readonly model: "gpt2";
+  }, {
+    readonly acceptsMood: false;
+    readonly aspect: "2:3";
+    readonly clause: "Tightly cropped photograph of a single piece of late-1940s American printed matter, flat and square-on in even light, every pixel paper, letterpress and wood type, sun-faded ink, foxing, soft creases and thumbtack holes, era-correct typography, nothing that looks like a digital photo run through a filter";
+    readonly description: "Aged mid-century printed matter such as posters and cards, where the lettering matters.";
+    readonly id: "ephemera";
+    readonly label: "Period ephemera";
+    readonly model: "ideogram4";
+  }, {
+    readonly acceptsMood: false;
+    readonly aspect: "3:4";
+    readonly clause: "Physical mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse museum reproduction lighting, shown unframed. No text";
+    readonly description: "Loose abstract paintings on linen, for wall art and calm backgrounds.";
+    readonly id: "canvas";
+    readonly label: "Linen abstract";
+    readonly model: "banana";
+  }, {
+    readonly acceptsMood: true;
+    readonly aspect: "1:1";
+    readonly clause: "Editorial documentary portrait, muted warm palette, waist-up, unposed, plain clothing with no logos. No text";
+    readonly description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.";
+    readonly id: "portrait";
+    readonly label: "Documentary portrait";
+    readonly model: "seedream45";
+  }, {
+    readonly acceptsMood: false;
+    readonly aspect: "1:1";
+    readonly clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet, one committed colour. No text, no logos, no people";
+    readonly description: "One object in one colour on a clean ground, for icons and simple product shots.";
+    readonly id: "object";
+    readonly label: "Studio object";
+    readonly model: "flux2-pro";
   }];
-  readonly color: readonly [{
-    readonly clause: "monochrome palette with tonal contrast";
-    readonly description: "Black-and-white or single-channel tonal treatment.";
-    readonly id: "monochrome";
-    readonly label: "Monochrome";
-  }];
-  readonly genre: readonly [{
-    readonly clause: "film noir mood with high contrast shadows";
-    readonly description: "High-contrast cinematic mood with shadow-forward drama.";
-    readonly id: "film-noir";
-    readonly label: "Film noir";
-  }];
-  readonly lighting: readonly [{
-    readonly clause: "rim lighting with defined edge highlights";
-    readonly description: "Back or side light that separates the subject edge.";
-    readonly id: "rim";
-    readonly label: "Rim";
-  }];
-  readonly material: readonly [{
-    readonly clause: "reflective material surfaces with controlled highlights";
-    readonly description: "Emphasizes reflections and highlight control on surfaces.";
-    readonly id: "reflective";
-    readonly label: "Reflective";
-  }];
-  readonly motion: readonly [{
-    readonly clause: "still composition with no motion blur";
-    readonly description: "Freezes the subject without implied movement.";
-    readonly id: "still";
-    readonly label: "Still";
-  }];
-  readonly recipe: readonly [{
-    readonly clause: "cinematic scene";
-    readonly description: "Frames the prompt as a cinematic still or scene.";
-    readonly id: "cinematic";
-    readonly label: "Cinematic";
-  }];
-  readonly shot: readonly [{
-    readonly clause: "close-up composition with controlled depth of field";
-    readonly description: "Tight framing that emphasizes subject detail.";
-    readonly id: "close-up";
-    readonly label: "Close-up";
+  readonly mood: readonly [{
+    readonly clause: "soft natural daylight from a window out of frame, gentle falloff into the corners, low contrast, even diffused light with soft, held highlights";
+    readonly description: "Soft, even daylight from a window. The safe default.";
+    readonly id: "window";
+    readonly label: "Window light";
+  }, {
+    readonly clause: "early morning light through tall glazing, cool and clear";
+    readonly description: "Cool, clear early morning light.";
+    readonly id: "dawn";
+    readonly label: "Dawn";
+  }, {
+    readonly clause: "low raking daylight from the left, long soft shadows that reveal texture";
+    readonly description: "Low side light that brings out surface texture.";
+    readonly id: "raking";
+    readonly label: "Raking light";
+  }, {
+    readonly clause: "overcast afternoon with rain on a tall window, soft even grey light";
+    readonly description: "Soft grey light on a rainy afternoon.";
+    readonly id: "overcast";
+    readonly label: "Overcast";
+  }, {
+    readonly clause: "evening, warm practical lamps around 2400K, candles and a lit fire, cosy and warm, never gloomy";
+    readonly description: "Warm evening light from lamps, candles and a fire.";
+    readonly id: "lamplit";
+    readonly label: "Lamplit evening";
+  }, {
+    readonly clause: "night, one warm low practical light, deep shadow, candlelit";
+    readonly description: "Dark night scene lit by one warm low light.";
+    readonly id: "nocturne";
+    readonly label: "Nocturne";
   }];
 };
+/** Every house look, in catalogue order. */
+export declare const LOOKS: readonly LookOption[];
+/** Stable id of a house look, e.g. `"lived-in"`. */
+type LookId = (typeof CREATIVE_TAXONOMY.look)[number]["id"];
+/** Stable id of a light mood, e.g. `"overcast"`. */
+type MoodId = (typeof CREATIVE_TAXONOMY.mood)[number]["id"];
+/**
+ * Look up a house look by id.
+ *
+ * Returns `undefined` for unknown ids; `enrichPrompt` is the validating path
+ * and throws `CreativeOptionError` for the same input.
+ */
+export declare function getLook(id: string): LookOption | undefined;
 /** Result of applying creative direction to a base prompt. */
 interface CreativePromptResult {
   /** Sanitized user prompt before Motif adds creative clauses. */
@@ -131,10 +246,21 @@ interface EnrichPromptOptions {
  */
 export declare function sanitizePrompt(prompt: string): string;
 /**
- * Append selected creative direction clauses to a prompt.
+ * Validate a creative direction and return its clauses in canonical order.
  *
- * Options are validated against `CREATIVE_TAXONOMY`, applied in
- * `CREATIVE_FIELDS` order, and returned as metadata alongside the final prompt.
+ * Throws `CreativeOptionError` for an unknown id, and for a mood paired with a
+ * look whose `acceptsMood` is false; that error is on field `mood` and its
+ * `availableIds` lists the looks that do accept a mood. A mood with no look is
+ * valid. Empty-string ids are treated as unset.
+ */
+export declare function validateCreativeDirection(creative: CreativeDirection | undefined): CreativePromptResult["creative"];
+/**
+ * Append selected creative direction clauses to a prompt as sentences.
+ *
+ * Options are validated by `validateCreativeDirection` and applied in
+ * `CREATIVE_FIELDS` order (look, then mood). The base prompt comes first; each
+ * part loses any trailing period and gets a capital first letter, then they
+ * are joined with `". "` and closed with a period. With no clauses the sanitized prompt is returned unchanged.
  */
 export declare function enrichPrompt(options: EnrichPromptOptions): CreativePromptResult;
 //#endregion
@@ -142,286 +268,40 @@ export declare function enrichPrompt(options: EnrichPromptOptions): CreativeProm
 /** ─── Model Types ─────────────────────────────────────────────── */
 type AspectRatio = "auto" | "8:1" | "4:1" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16" | "1:4" | "1:8";
 type Resolution = "0.5K" | "1K" | "2K" | "4K";
-type ModelType = "generation" | "utility" | "video";
 type ImageOutputFormat = "jpeg" | "png" | "webp";
-type BackgroundMode = "auto" | "transparent" | "opaque";
-type ImageQuality = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
-type ThinkingLevel = "minimal" | "high";
-type GptImageSize = "auto" | "1024x1024" | "1536x1024" | "1024x1536";
-type FalImageSizePreset = "auto" | "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9";
 interface CustomImageSize {
   height: number;
   width: number;
 }
-type ImageSize = GptImageSize | FalImageSizePreset | CustomImageSize;
-/** How the model accepts image dimensions */
-type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
-type QualityTier = "good" | "better" | "best" | "frontier";
-type SpeedTier = "fast" | "balanced" | "slow" | "very_slow" | "unknown";
-type PriceTier = "budget" | "standard" | "premium" | "ultra" | "variable";
-interface FalPricing {
-  checkedAt: string;
-  currency: "USD";
-  endpointId: string;
-  estimatedCostPerImageUsd?: number;
-  source: "fal-pricing-api";
-  unit: string;
-  unitPrice: number;
-}
-interface LeaderboardMetric {
-  elo: number;
-  rank: number;
-  winRate?: number;
-}
-interface ModelBenchmark {
-  artificialAnalysis?: {
-    editing?: LeaderboardMetric;
-    sourceUrls: string[];
-    snapshotDate: string;
-    textToImage?: LeaderboardMetric;
-  };
-  speed?: {
-    medianSeconds?: number;
-    p95Seconds?: number;
-    source: "artificial-analysis-models";
-  };
-  tiers?: {
-    price: PriceTier;
-    quality: QualityTier;
-    speed: SpeedTier;
-  };
-  useCase?: string;
-}
-interface ModelConfig {
-  benchmark?: ModelBenchmark;
-  editEndpoint?: string;
-  editImagesField?: "image_urls" | "image_url";
-  endpoint: string;
-  falPricing?: FalPricing;
-  maxReferenceImages?: number;
-  name: string;
-  pricing: string;
-  /** Null means token-metered with no per-image estimate. */
-  pricePerImageUsd?: number | null;
-  /** How this model accepts dimensions (default: "aspect_ratio") */
-  sizeMode?: SizeMode;
-  supportsAspect: boolean;
-  supportsBackground?: boolean;
-  supportsEdit: boolean;
-  supportsEnhancePrompt?: boolean;
-  supportsExpandPrompt?: boolean;
-  supportsGuidanceScale?: boolean;
-  supportsGoogleSearch?: boolean;
-  supportsImagePromptStrength?: boolean;
-  supportsInferenceSteps?: boolean;
-  supportsLimitGenerations?: boolean;
-  supportsMaskImage?: boolean;
-  maskImageField?: "mask_image_url" | "mask_url";
-  supportsNegativePrompt?: boolean;
-  supportsNumImages: boolean;
-  supportsOutputFormat?: boolean;
-  supportedOutputFormats?: readonly ImageOutputFormat[];
-  supportsQuality?: boolean;
-  supportedQualities?: readonly ImageQuality[];
-  supportsRaw?: boolean;
-  supportsRenderingSpeed?: boolean;
-  supportsResolution: boolean;
-  supportsSafetyTolerance?: boolean;
-  supportsSafetyChecker?: boolean;
-  supportsSeed?: boolean;
-  supportsStyle?: boolean;
-  supportsSyncMode?: boolean;
-  supportsThinkingLevel?: boolean;
-  supportsWebSearch?: boolean;
-  type: ModelType;
-  /** Use fal queue submit/status/result even for generate() calls. */
-  useQueue?: boolean;
-}
-/** ─── Generation Types ───────────────────────────────────────── */
-interface GenerateOptions {
-  aspect?: AspectRatio;
-  /** GPT background mode where supported */
-  background?: BackgroundMode;
-  /**
-   * Motif prompt enrichment choices applied before fal request construction.
-   *
-   * These options are not sent to fal directly; they append validated creative
-   * clauses to `prompt` and are omitted from the final request body.
-   */
-  creative?: CreativeDirection;
-  editImageUrls?: string[];
-  /** Ask fal not to store IO payloads, and expose request ids for deletion. */
-  ephemeral?: boolean;
-  /** Google-search alias for fal models that expose enable_google_search */
-  enableGoogleSearch?: boolean;
-  /** fal safety checker toggle where supported */
-  enableSafetyChecker?: boolean;
-  /** Enable web search for generative context where supported */
-  enableWebSearch?: boolean;
-  /** Auto-enhance the prompt before generation (flux only) */
-  enhancePrompt?: boolean;
-  /** Enable MagicPrompt expansion (ideogram only) */
-  expandPrompt?: boolean;
-  /** CFG guidance scale — flux-fast: 1–20 */
-  guidanceScale?: number;
-  /** Direct fal image_size override, including custom {width,height} where supported */
-  imageSize?: ImageSize;
-  /** FLUX image prompt/reference strength where supported */
-  imagePromptStrength?: number;
-  inputFidelity?: "low" | "high";
-  /** Nano Banana 2 generation limiting toggle */
-  limitGenerations?: boolean;
-  /** Mask image URL for inpainting/editing where supported */
-  maskImageUrl?: string;
-  model: string;
-  /** What NOT to include in the image (ideogram only) */
-  negativePrompt?: string;
-  numImages?: number;
-  /** Number of diffusion inference steps — flux-fast: 1–12 */
-  numInferenceSteps?: number;
-  /** Output image format (default: model-dependent) */
-  outputFormat?: ImageOutputFormat;
-  prompt: string;
-  /** GPT/OpenAI quality where supported */
-  quality?: ImageQuality;
-  /** Generate less processed, more natural images (flux only) */
-  raw?: boolean;
-  /** Speed vs. quality trade-off (ideogram only) */
-  renderingSpeed?: "TURBO" | "BALANCED" | "QUALITY";
-  resolution?: Resolution;
-  /** Safety tolerance level "1"–"6", where "1" is strictest */
-  safetyTolerance?: string;
-  /** Reproducible generation seed */
-  seed?: number;
-  /** Style preset — recraft: 70+ hierarchical styles; ideogram: "AUTO"|"GENERAL"|"REALISTIC"|"DESIGN" */
-  style?: string;
-  /** Return media as data URI where supported */
-  syncMode?: boolean;
-  /** Nano Banana 2 thinking mode */
-  thinkingLevel?: ThinkingLevel;
-  transparent?: boolean;
-}
-interface UpscaleOptions {
-  creativity?: number;
-  /** CFG guidance scale for upscaling (clarity only, 0–20, default 4) */
-  guidanceScale?: number;
-  imageUrl: string;
-  model?: "clarity" | "crystal";
-  /** What NOT to include in the upscaled result (clarity only) */
-  negativePrompt?: string;
-  /** Number of diffusion steps (clarity only, 4–50, default 18) */
-  numInferenceSteps?: number;
-  /** Prompt to guide the upscaling process (clarity only) */
-  prompt?: string;
-  /** How closely to preserve the original image (clarity only, 0–1, default 0.6) */
-  resemblance?: number;
-  scaleFactor?: number;
-}
-interface RemoveBackgroundOptions {
-  imageUrl: string;
-  model?: "rmbg" | "bria";
-  /** BiRefNet operating resolution (rmbg model only, default "1024x1024") */
-  operatingResolution?: "1024x1024" | "2048x2048";
-  /** Output image format (rmbg model only) */
-  outputFormat?: "png" | "webp" | "gif";
-  /** Return the alpha mask alongside the result (rmbg model only) */
-  outputMask?: boolean;
-  /** Apply foreground edge refinement (rmbg model only, default true) */
-  refineForeground?: boolean;
-  /** BiRefNet model variant (rmbg model only) */
-  variant?: "General Use (Light)" | "General Use (Heavy)" | "Portrait";
-}
-interface VideoOptions {
-  /** CFG guidance scale for video generation (0–1, default 0.5) */
-  cfgScale?: number;
-  /** Duration in seconds (3-15) */
-  duration?: number;
-  /** Optional end frame image URL */
-  endImageUrl?: string;
-  /** Generate audio track (default true, costs more) */
-  generateAudio?: boolean;
-  /** Source image URL */
-  imageUrl: string;
-  /** What NOT to include in the video */
-  negativePrompt?: string;
-  /** Text description of the motion/scene */
-  prompt: string;
-}
-interface VideoResponse {
-  contentType: string;
-  fileName: string;
-  fileSize: number;
-  url: string;
-}
-interface ToolRunOptions {
-  input?: string;
-  inputs?: string[];
-  options?: Record<string, unknown>;
-  tool: string;
-}
-type ToolResponse = Record<string, unknown>;
-/** ─── Response Types ─────────────────────────────────────────── */
-interface MotifImage {
-  content_type?: string;
-  height?: number;
-  url: string;
-  width?: number;
-}
-interface MotifResponse {
-  images: MotifImage[];
-  prompt?: string;
-  requestId?: string;
-  seed?: number;
-}
-/** ─── Queue Types ────────────────────────────────────────────── */
-interface QueuedJob {
-  endpoint: string;
-  estimatedCost: number | null;
-  requestId: string;
-}
-interface JobStatus {
-  error?: string;
-  logs?: {
-    message: string;
-    timestamp: string;
-  }[];
-  queuePosition?: number;
-  status: "queued" | "processing" | "completed" | "failed";
-}
-/**
- * A tool run accepted by the fal queue.
- *
- * Returned by `FalClient.submitTool`, and the handle passed back to
- * `checkToolStatus` / `getToolResult`. The job itself carries no cost: the
- * rate lives on the registry entry as `FalToolConfig.price`, and for a queued
- * endpoint it is usually per-megapixel or metered, so the final cost is only
- * known once the result is in.
- */
-interface QueuedToolJob {
-  endpoint: string;
-  requestId: string;
+/** Limits an endpoint puts on an exact `{ width, height }` image size. */
+interface ImageSizeBounds {
+  /** Largest width or height over smallest, e.g. 3 for 3:1. */
+  maxRatio?: number;
+  maxEdge?: number;
+  maxPixels?: number;
+  minEdge?: number;
+  minPixels?: number;
+  /** Both edges must be multiples of this. Motif uses 16 when absent. */
+  multipleOf?: number;
 }
 /** ─── Configuration ──────────────────────────────────────────── */
-interface FalClientConfig {
-  apiKey: string;
-  /** Max retry attempts for 429/5xx errors (default 3, set 0 to disable) */
-  retries?: number;
-  /** Request timeout in ms (default 120_000) */
-  timeout?: number;
-}
+/** The network seam: a `fetch`-shaped function. */
+type FalFetch = (url: string, init: RequestInit) => Promise<Response>;
 //#endregion
 //#region src/aspects.d.ts
 /** Ordered by popularity: square first, then common ratios */
 export declare const ASPECT_RATIOS: AspectRatio[];
 export declare const RESOLUTIONS: Resolution[];
-/** Map aspect ratio to GPT image_size (GPT doesn't support arbitrary aspects) */
-export declare function aspectToGptSize(aspect: AspectRatio): string;
 /**
- * Map aspect ratio to fal.ai image_size enum.
- * Used by FLUX Schnell, Recraft, Ideogram, and other models that accept
- * named size presets rather than aspect ratio strings.
+ * Thrown by `buildGenerateBody` when a ratio no fal preset holds has no exact
+ * size inside the Model's limits.
  */
-export declare function aspectToFalImageSize(aspect: AspectRatio): string;
+export declare class ImageSizeBoundsError extends Error {
+  readonly code = "INVALID_OPTION";
+  readonly aspect: AspectRatio;
+  readonly bounds: ImageSizeBounds;
+  constructor(model: string, aspect: AspectRatio, bounds: ImageSizeBounds);
+}
 /** Format presets that set aspect + resolution in one click */
 export declare const FORMAT_PRESETS: Record<string, {
   label: string;
@@ -429,76 +309,6 @@ export declare const FORMAT_PRESETS: Record<string, {
   resolution?: Resolution;
 }>;
 //#endregion
-//#region src/cost.d.ts
-/** Estimate cost based on model and settings */
-export declare function estimateCost(model: string, resolution?: Resolution, numImages?: number): number | null;
-/** Estimate cost for video generation */
-export declare function estimateVideoCost(durationSeconds?: number, generateAudio?: boolean): number;
-//#endregion
-//#region src/env.d.ts
-export declare const motifEnvSchema: import("@howells/envy").EnvSchema<{
-  readonly optional: {
-    FAL_KEY: z.ZodString;
-  };
-}>;
-type MotifEnv = ReturnType<typeof motifEnvSchema.parse>;
-export declare function parseMotifEnv(input?: Record<string, unknown>): MotifEnv;
-export declare function getFalKeyFromEnv(input?: Record<string, unknown>): string | undefined;
-//#endregion
-//#region src/generate.d.ts
-/**
- * Build the fal.ai request body for a generation request.
- * Shared between sync generate() (CLI) and queue-based submit (web).
- *
- * Models use different sizing APIs:
- * - `gpt_size`: GPT's fixed dimensions (1024x1024, 1536x1024, etc.)
- * - `aspect_ratio`: string like "16:9" (Gemini, Grok, FLUX Pro Ultra)
- * - `image_size_enum`: named presets like "landscape_4_3" (FLUX.2, Seedream, Recraft, Ideogram, GPT Image 2)
- * - `none`: no size control (video models)
- */
-export declare function buildGenerateBody(options: GenerateOptions): {
-  endpoint: string;
-  body: Record<string, unknown>;
-};
-//#endregion
-//#region src/leaderboards.d.ts
-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;
-  isCurrent?: boolean;
-  model: string;
-  rank: number;
-  routableModelId?: string;
-}
-interface LeaderboardSnapshot {
-  capturedAt: string;
-  entries: LeaderboardEntry[];
-  source: string;
-}
-export declare const IMAGE_TEXT_TO_IMAGE_TOP_20: LeaderboardSnapshot;
-export declare const IMAGE_EDITING_TOP_20: LeaderboardSnapshot;
-export declare const VIDEO_TEXT_TO_VIDEO_TOP_15: LeaderboardSnapshot;
-export declare const VIDEO_IMAGE_TO_VIDEO_TOP_15: LeaderboardSnapshot;
-//#endregion
-//#region src/models.d.ts
-export declare const MODELS: Record<string, ModelConfig>;
-export declare const GENERATION_MODELS: readonly ["flare", "sunburst", "gpt2", "gpt", "banana2", "banana", "gemini", "gemini3", "seedream4", "seedream45", "seedream5", "seedream5-lite", "flux2-max", "flux2-pro", "flux2-flex", "flux2-dev", "flux2-turbo", "flux", "flux-fast", "recraft", "recraft4", "ideogram", "ideogram4", "grok-image", "qwen", "qwen3"];
-/** Models whose fal endpoints support image editing (vary/edit flows). */
-export declare const EDIT_CAPABLE_MODELS: ("banana" | "banana2" | "flare" | "flux" | "flux-fast" | "flux2-dev" | "flux2-flex" | "flux2-max" | "flux2-pro" | "flux2-turbo" | "gemini" | "gemini3" | "gpt" | "gpt2" | "grok-image" | "ideogram" | "ideogram4" | "qwen" | "qwen3" | "recraft" | "recraft4" | "seedream4" | "seedream45" | "seedream5" | "seedream5-lite" | "sunburst")[];
-export declare const UTILITY_MODELS: readonly ["clarity", "crystal", "rmbg", "bria"];
-export declare const VIDEO_MODELS: readonly ["kling"];
-type GenerationModelName = (typeof GENERATION_MODELS)[number];
-/** Recraft v3 style presets. Pass as the `style` field in GenerateOptions. */
-export declare const RECRAFT_STYLES: readonly ["realistic_image", "realistic_image/b_and_w", "realistic_image/enterprise", "realistic_image/hard_flash", "realistic_image/hdr", "realistic_image/motion_blur", "realistic_image/natural_light", "realistic_image/studio_portrait", "realistic_image/long_exposure", "digital_illustration", "digital_illustration/2d_art_poster", "digital_illustration/2d_art_poster_2", "digital_illustration/engraving_color", "digital_illustration/grain", "digital_illustration/hand_drawn", "digital_illustration/hand_drawn_outline", "digital_illustration/handmade_3d", "digital_illustration/infantile_sketch", "digital_illustration/pixel_art", "digital_illustration/psychedelic", "digital_illustration/seamless", "digital_illustration/voxel", "digital_illustration/watercolor", "vector_illustration", "vector_illustration/cartoon", "vector_illustration/doodle_line_art", "vector_illustration/engraving", "vector_illustration/flat_2", "vector_illustration/kawaii", "vector_illustration/line_art", "vector_illustration/line_circuit", "vector_illustration/linocut", "vector_illustration/zentangle"];
-/** Ideogram v3 top-level style categories. Pass as the `style` field in GenerateOptions. */
-export declare const IDEOGRAM_STYLES: readonly ["AUTO", "GENERAL", "REALISTIC", "DESIGN"];
-//#endregion
 //#region src/errors.d.ts
 /**
  * `MotifError` and its coercion helper.
@@ -514,2743 +324,738 @@ export declare class MotifError extends Error {
   /** fal's request-correlation id (from the `x-fal-request-id` header or the
    * error body). Ties a failure back to fal's dashboard/support. */
   readonly requestId?: string;
-  constructor(message: string, status: number, code?: string, requestId?: string);
+  /** Structured context for the failure, e.g. the refused field. */
+  readonly details?: Record<string, unknown>;
+  constructor(message: string, status: number, code?: string, requestId?: string, details?: Record<string, unknown>);
 }
-//#endregion
-//#region src/server.d.ts
+/** Error code for a fal account that is locked, usually for lack of credit. */
+export declare const ACCOUNT_LOCKED = "ACCOUNT_LOCKED";
 /**
- * FalClient — the fal-native client.
- *
- * The low-level, fal-specific client for AI image generation and fal utilities
- * (queue, upload, upscale, rmbg, video, tools, generate). Pairs with the
- * provider-agnostic `createMotifImage` (`@howells/motif-sdk/image`) as the
- * fal-native entry point.
+ * Whether a fal HTTP failure means the account is locked.
  *
- * All async methods return `Result<T, MotifError>` — no thrown exceptions.
+ * fal answers `403 {"detail":"User is locked. Reason: TOP_UP."}` when the
+ * account has run out of credit. Retrying cannot help, and the key is valid.
+ */
+export declare function isFalAccountLocked(status: number, body: string): boolean;
+//#endregion
+//#region src/tasks.d.ts
+/**
+ * The Task registry: every job Motif does, with the Models that can do it
+ * ranked best-first and tagged with the Tier each belongs to.
  *
- * @example
- * ```typescript
- * import { FalClient } from "./fal";
+ * Rankings are data so a default change is visible in a pull request. A Task
+ * ranked from the bench's human comparisons says `rankedFrom: "bench"`; every
+ * other Task is hand-ranked from published quality numbers and fal price, and
+ * says so. Today no Task is bench-ranked: the bench holds two human ratings,
+ * both on one model, which is not an order.
  *
- * const motif = new FalClient(process.env.FAL_KEY!);
- * const result = await motif.generate({ prompt: "a red balloon", model: "banana" });
+ * Model ids are the short aliases `-m` and `TaskInput.model` accept. `resolveTask` in `./resolve` is the only place a Model is
+ * chosen from these lists.
  *
- * if (result.isOk()) {
- *   console.log(result.value.images[0].url);
- * } else {
- *   console.error(result.error.message);
- * }
- * ```
+ * A Task can have modes: a variant of the job a caller names explicitly, such
+ * as erasing text rather than an object. A ranked entry with a `mode` is only
+ * chosen when the request names that mode; an entry without one only when it
+ * names none. A Model can appear once per mode.
  */
-export declare class FalClient {
-  private readonly apiKey;
-  private readonly timeout;
-  private readonly retries;
-  constructor(config: FalClientConfig | string);
-  /** ─── Synchronous Generation ──────────────────────────────── */
-  /** Generate images synchronously (blocks until fal.ai returns). */
-  generate(options: GenerateOptions): Promise<Result$1<MotifResponse, MotifError>>;
-  private generateQueued;
-  /** ─── Queue-Based Generation ──────────────────────────────── */
-  /** Submit a generation to the fal.ai queue (returns immediately). */
-  submitGeneration(options: GenerateOptions): Promise<Result$1<QueuedJob, MotifError>>;
-  /** Check the status of a queued generation. */
-  getJobStatus(endpoint: string, requestId: string): Promise<Result$1<JobStatus, MotifError>>;
-  /** Fetch the completed result from the queue. */
-  getJobResult(endpoint: string, requestId: string): Promise<Result$1<MotifResponse, MotifError>>;
-  /** ─── Processing ──────────────────────────────────────────── */
-  /** Upscale an image using clarity or crystal upscaler. */
-  upscale(options: UpscaleOptions): Promise<Result$1<MotifResponse, MotifError>>;
-  /** Remove the background from an image. */
-  removeBackground(options: RemoveBackgroundOptions): Promise<Result$1<MotifResponse, MotifError>>;
-  /** ─── Video Generation ───────────────────────────────────── */
-  /**
-   * Generate a video from an image using Kling v3 Pro.
-   * This uses the queue API since video generation takes 30-120s.
-   * Returns immediately with a job — poll with getJobStatus/getVideoResult.
-   */
-  submitVideo(options: VideoOptions): Promise<Result$1<QueuedJob, MotifError>>;
-  /** Fetch the completed video result from the queue. */
-  getVideoResult(endpoint: string, requestId: string): Promise<Result$1<VideoResponse, MotifError>>;
-  /** ─── File Upload ─────────────────────────────────────────── */
-  /**
-   * Upload a file to fal.ai CDN storage and return the public URL.
-   * Uses the two-step initiate + PUT flow.
-   */
-  uploadToFalCdn(file: ArrayBuffer | Uint8Array, options: {
-    contentType: string;
-    fileName: string;
-  }): Promise<Result$1<string, MotifError>>;
-  /** ─── Utilities ───────────────────────────────────────────── */
-  /** Run a registered fal utility/tool endpoint. */
-  runTool(options: ToolRunOptions): Promise<Result$1<ToolResponse, MotifError>>;
-  /** ─── Queue-Based Tools ───────────────────────────────────── */
-  /**
-   * Submit a tool run to the fal queue. Returns as soon as fal accepts it.
-   *
-   * The queued counterpart to `runTool`, for endpoints that outrun the
-   * synchronous request timeout. Callers choose the path — neither one falls
-   * back to the other.
-   */
-  submitTool(options: ToolRunOptions): Promise<Result$1<QueuedToolJob, MotifError>>;
-  /** Poll one queued tool run. */
-  checkToolStatus(job: QueuedToolJob): Promise<Result$1<JobStatus, MotifError>>;
-  /** Fetch the finished payload for a queued tool run. */
-  getToolResult(job: QueuedToolJob): Promise<Result$1<ToolResponse, MotifError>>;
-  /**
-   * Submit, poll to completion, and return the result. The convenience path
-   * for tools whose registry entry sets `queued`.
-   */
-  runToolQueued(options: ToolRunOptions, onProgress?: (status: string, queuePosition?: number) => void): Promise<Result$1<ToolResponse, MotifError>>;
-  /**
-   * Delete fal's stored IO payloads for a completed request.
-   *
-   * This removes request input/output payload files exposed by fal's payloads
-   * API. It does not remove billing/account metadata or input files separately
-   * uploaded to fal storage before a request.
-   */
-  deletePayloads(requestId: string): Promise<Result$1<void, MotifError>>;
-  /** Estimate cost for a generation (no API call). */
-  estimateCost(model: string, resolution?: Resolution, numImages?: number): number | null;
-  /** Build the fal.ai request body without sending it. */
-  buildRequestBody(options: GenerateOptions): {
-    endpoint: string;
-    body: Record<string, unknown>;
-  };
-  /** Model registry. */
-  get models(): Record<string, ModelConfig>;
-  /** Generation model keys. */
-  get generationModels(): readonly ["flare", "sunburst", "gpt2", "gpt", "banana2", "banana", "gemini", "gemini3", "seedream4", "seedream45", "seedream5", "seedream5-lite", "flux2-max", "flux2-pro", "flux2-flex", "flux2-dev", "flux2-turbo", "flux", "flux-fast", "recraft", "recraft4", "ideogram", "ideogram4", "grok-image", "qwen", "qwen3"];
-  /** Utility model keys. */
-  get utilityModels(): readonly ["clarity", "crystal", "rmbg", "bria"];
-  /** Registered fal utility/tool endpoints. */
-  get tools(): {
-    readonly "got-ocr": {
-      readonly category: "analysis";
-      readonly description: "Transcribe text from one or more images, optionally as formatted multi-page output.";
-      readonly endpoint: "fal-ai/got-ocr/v2";
-      readonly inputField: "input_image_urls";
-      readonly inputKind: "images";
-      readonly name: "GOT-OCR 2.0";
-      readonly outputKeys: ["outputs"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.05/image";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2";
-      readonly task: "optical character recognition";
-    };
-    readonly "moondream-caption": {
-      readonly category: "analysis";
-      readonly description: "Write a short, normal, or long caption for an image.";
-      readonly endpoint: "fal-ai/moondream3-preview/caption";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Moondream 3 Caption";
-      readonly outputKeys: ["output"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption";
-      readonly task: "image captioning";
-    };
-    readonly "moondream-detect": {
-      readonly category: "analysis";
-      readonly description: "Detect prompted objects and return their bounding boxes, with an optional preview.";
-      readonly endpoint: "fal-ai/moondream3-preview/detect";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Moondream 3 Detect";
-      readonly outputKeys: ["objects", "image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect";
-      readonly task: "object detection";
-    };
-    readonly "moondream-point": {
-      readonly category: "analysis";
-      readonly description: "Return point coordinates for every instance of a prompted subject.";
-      readonly endpoint: "fal-ai/moondream3-preview/point";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Moondream 3 Point";
-      readonly outputKeys: ["points", "image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point";
-      readonly task: "object pointing";
-    };
-    readonly "moondream-query": {
-      readonly category: "analysis";
-      readonly description: "Answer a free-form question about an image, with reasoning.";
-      readonly endpoint: "fal-ai/moondream3-preview/query";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Moondream 3 Query";
-      readonly outputKeys: ["output", "reasoning"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/query";
-      readonly task: "visual question answering";
-    };
-    readonly nsfw: {
-      readonly category: "moderation";
-      readonly description: "Predict whether one or more images contain NSFW concepts.";
-      readonly endpoint: "fal-ai/x-ailab/nsfw";
-      readonly inputField: "image_urls";
-      readonly inputKind: "images";
-      readonly name: "NSFW Checker";
-      readonly outputKeys: ["has_nsfw_concepts"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.001/image";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-      readonly task: "vision moderation";
-    };
-    readonly "hunyuan3d-v3": {
-      readonly category: "3d";
-      readonly description: "Reconstruct a textured 3D mesh from a single image, with optional multi-view inputs.";
-      readonly endpoint: "fal-ai/hunyuan3d-v3/image-to-3d";
-      readonly inputField: "input_image_url";
-      readonly inputKind: "image";
-      readonly name: "Hunyuan3D v3 Image to 3D";
-      readonly outputKeys: ["model_glb", "model_urls", "thumbnail"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.375;
-      };
-      readonly pricing: "$0.375/generation at the default Normal type; $0.45 low poly, $0.225 geometry only, and $0.15 each for PBR, multi-view, or a custom face count";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/hunyuan3d-v3/image-to-3d";
-      readonly task: "single-image 3D reconstruction";
-    };
-    readonly "ideogram-layerize-text": {
-      readonly category: "layers";
-      readonly description: "Split an image into background image layers plus editable HTML text containers.";
-      readonly endpoint: "fal-ai/ideogram/v3/layerize-text";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Ideogram v3 Text Layerize";
-      readonly outputKeys: ["image_layers", "image", "text_html", "text_containers"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.09;
-      };
-      readonly pricing: "$0.09/image";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/layerize-text";
-      readonly task: "text and image layer extraction";
-    };
-    readonly "ideogram-tiling": {
-      readonly category: "material";
-      readonly description: "Generate a seamlessly tiling texture, optionally conditioned on a source image.";
-      readonly endpoint: "ideogram/v4/tiling";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Ideogram v4 Tiling";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.06;
-      };
-      readonly pricing: "$0.06/megapixel at the default BALANCED speed; $0.03 turbo, $0.10 quality";
-      readonly sourceUrl: "https://fal.ai/models/ideogram/v4/tiling";
-      readonly task: "seamless texture generation";
-    };
-    readonly image2svg: {
-      readonly category: "vector";
-      readonly description: "Trace a raster image into layered SVG paths.";
-      readonly endpoint: "fal-ai/image2svg";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Image to SVG";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.005;
-      };
-      readonly pricing: "$0.005/image";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image2svg";
-      readonly task: "raster to vector tracing";
-    };
-    readonly patina: {
-      readonly category: "material";
-      readonly description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.";
-      readonly endpoint: "fal-ai/patina";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Patina PBR Maps";
-      readonly outputKeys: ["images"];
-      readonly outputLabels: {
-        readonly images: {
-          readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
-          readonly fromOption: "maps";
-        };
-      };
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.01 base plus $0.01/megapixel per output map, so all 5 maps on a 1MP image cost $0.06; the listed rate is per map";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/patina";
-      readonly task: "PBR material decomposition";
-    };
-    readonly "patina-extract": {
-      readonly category: "material";
-      readonly description: "Extract a tiling PBR material from a prompted region of a photograph.";
-      readonly endpoint: "fal-ai/patina/material/extract";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Patina Material Extract";
-      readonly outputKeys: ["images"];
-      readonly outputLabels: {
-        readonly images: {
-          readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
-          readonly fromOption: "maps";
-        };
-      };
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.10 base only; add $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract";
-      readonly task: "tiling material extraction";
-    };
-    readonly "qwen-layered": {
-      readonly category: "layers";
-      readonly description: "Split an image into a configurable number of stacked RGBA layers.";
-      readonly endpoint: "fal-ai/qwen-image-layered";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Qwen Image Layered";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.05 per image; fal does not say whether that counts the input image or each of the generated layers, so no estimate is reported";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered";
-      readonly task: "image layer decomposition";
-    };
-    readonly "recraft-vectorize": {
-      readonly category: "vector";
-      readonly description: "Convert a raster image into a clean SVG.";
-      readonly endpoint: "fal-ai/recraft/vectorize";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Recraft Vectorize";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.04;
-      };
-      readonly pricing: "$0.04/image, $0.08 with a vector style";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/recraft/vectorize";
-      readonly task: "raster to vector conversion";
-    };
-    readonly "sam3-3d-align": {
-      readonly category: "3d";
-      readonly description: "Align SAM 3D objects and bodies into a shared scene.";
-      readonly endpoint: "fal-ai/sam-3/3d-align";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3D Align";
-      readonly outputKeys: ["scene_glb", "model_glb", "visualization", "body_mesh_ply", "metadata"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align";
-      readonly task: "3D scene alignment";
-    };
-    readonly "sam3-3d-body": {
-      readonly category: "3d";
-      readonly defaultOptions: {
-        readonly export_meshes: true;
-        readonly include_3d_keypoints: true;
-        readonly include_mhr_params: true;
-      };
-      readonly description: "Reconstruct human body meshes and keypoints from a single image.";
-      readonly endpoint: "fal-ai/sam-3/3d-body";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3D Body";
-      readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body";
-      readonly task: "single-image 3D body reconstruction";
-    };
-    readonly "sam3-3d-objects": {
-      readonly category: "3d";
-      readonly defaultOptions: {
-        readonly prompt: "car";
-      };
-      readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
-      readonly endpoint: "fal-ai/sam-3/3d-objects";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3D Objects";
-      readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.02 per unit; fal does not define a unit, and this endpoint returns one mesh per detected object, so no estimate is reported";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
-      readonly task: "single-image 3D object reconstruction";
-    };
-    readonly "seedream-layerize": {
-      readonly category: "layers";
-      readonly description: "Split an image into editable Seedream layers plus flattened previews.";
-      readonly endpoint: "bytedance/seedream/v5/pro/layerize";
-      readonly inputField: "image_url";
-      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";
-      };
-      readonly pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize";
-      readonly task: "image layer decomposition";
-    };
-    readonly "seedvr-seamless": {
-      readonly category: "material";
-      readonly description: "Upscale a tiling texture while keeping its edges seamless. ";
-      readonly endpoint: "fal-ai/seedvr/upscale/image/seamless";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SeedVR Seamless Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.0025;
-      };
-      readonly pricing: "$0.0025/megapixel";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless";
-      readonly task: "seamless texture upscaling";
-    };
-    readonly "trellis-2": {
-      readonly category: "3d";
-      readonly description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.";
-      readonly endpoint: "fal-ai/trellis-2";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "TRELLIS 2";
-      readonly outputKeys: ["model_glb"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.3;
-      };
-      readonly pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/trellis-2";
-      readonly task: "single-image 3D reconstruction";
-    };
-    readonly "ben-v2": {
-      readonly category: "background";
-      readonly description: "Fast, high-quality background removal for images.";
-      readonly endpoint: "fal-ai/ben/v2/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "BEN v2 Background Removal";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.025;
-      };
-      readonly pricing: "$0.025/megapixel";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image";
-      readonly task: "image background removal";
-    };
-    readonly birefnet: {
-      readonly category: "background";
-      readonly defaultOptions: {
-        readonly model: "General Use (Light)";
-        readonly operating_resolution: "1024x1024";
-        readonly output_format: "png";
-        readonly refine_foreground: true;
-      };
-      readonly description: "High-resolution dichotomous image segmentation and background removal.";
-      readonly endpoint: "fal-ai/birefnet/v2";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "BirefNet Background Removal";
-      readonly outputKeys: ["image", "mask_image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
-      readonly task: "image background removal";
-    };
-    readonly "bria-rmbg": {
-      readonly category: "background";
-      readonly description: "Commercial-safe background removal for images.";
-      readonly endpoint: "fal-ai/bria/background/remove";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Bria RMBG 2.0";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.018;
-      };
-      readonly pricing: "$0.018/generation";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
-      readonly task: "image background removal";
-    };
-    readonly "bria-video-rmbg": {
-      readonly category: "background";
-      readonly defaultOptions: {
-        readonly background_color: "Black";
-        readonly output_container_and_codec: "webm_vp9";
-        readonly preserve_audio: true;
-      };
-      readonly description: "Remove video backgrounds with configurable output container.";
-      readonly endpoint: "bria/video/background-removal";
-      readonly inputField: "video_url";
-      readonly inputKind: "video";
-      readonly name: "Bria Video Background Removal";
-      readonly outputKeys: ["video"];
-      readonly price: {
-        readonly kind: "second";
-        readonly usd: 0.00425;
-      };
-      readonly pricing: "$0.00425/sec";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
-      readonly task: "video background removal";
-    };
-    readonly ddcolor: {
-      readonly category: "restoration";
-      readonly description: "Colourise black-and-white photographs.";
-      readonly endpoint: "fal-ai/ddcolor";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "DDColor Colourisation";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.001;
-      };
-      readonly pricing: "$0.001/megapixel";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/ddcolor";
-      readonly task: "photo colourisation";
-    };
-    readonly rembg: {
-      readonly category: "background";
-      readonly defaultOptions: {
-        readonly crop_to_bbox: false;
-      };
-      readonly description: "Generic image background removal utility.";
-      readonly endpoint: "fal-ai/imageutils/rembg";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Remove Background";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-      readonly task: "image background removal";
-    };
-    readonly "seedvr-upscale": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Diffusion image restoration and upscaling with SeedVR.";
-      readonly endpoint: "fal-ai/seedvr/upscale/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SeedVR Image Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.001;
-      };
-      readonly pricing: "$0.001/megapixel";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image";
-      readonly task: "image restoration and upscaling";
-    };
-    readonly "topaz-adjust": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz exposure, white balance, and colour adjustment.";
-      readonly endpoint: "topaz/adjust/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Adjust";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 per 24 output megapixels";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/adjust/image";
-      readonly task: "tonal adjustment";
-    };
-    readonly "topaz-creative": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz Bloom upscaling, which reimagines detail rather than preserving it.";
-      readonly endpoint: "topaz/upscale/image/creative";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Creative Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.96 per 24 output megapixels";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative";
-      readonly task: "creative image upscaling";
-    };
-    readonly "topaz-denoise": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz noise reduction at source resolution.";
-      readonly endpoint: "topaz/denoise/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Denoise";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/denoise/image";
-      readonly task: "image denoising";
-    };
-    readonly "topaz-generative": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz Wonder upscaling, which synthesises plausible detail as it enlarges.";
-      readonly endpoint: "topaz/upscale/image/generative";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Generative Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative";
-      readonly task: "generative image upscaling";
-    };
-    readonly "topaz-image": {
-      readonly category: "upscale";
-      readonly defaultOptions: {
-        readonly model: "Standard V2";
-        readonly output_format: "jpeg";
-        readonly upscale_factor: 2;
-      };
-      readonly description: "Professional Topaz image enhancement and upscaling.";
-      readonly endpoint: "fal-ai/topaz/upscale/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Image Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-      readonly task: "image enhancement";
-    };
-    readonly "topaz-precision": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz upscaling that preserves the original detail rather than inventing it.";
-      readonly endpoint: "topaz/upscale/image/precision";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Precision Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 per 24 output megapixels, any precision model";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/precision";
-      readonly task: "faithful image upscaling";
-    };
-    readonly "topaz-restore": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz restoration of damaged or degraded photographs at source resolution.";
-      readonly endpoint: "topaz/restore/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Restore";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/restore/image";
-      readonly task: "photo restoration";
-    };
-    readonly "topaz-sharpen": {
-      readonly category: "restoration";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Topaz deblurring and sharpening at source resolution.";
-      readonly endpoint: "topaz/sharpen/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Sharpen";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/sharpen/image";
-      readonly task: "image sharpening";
-    };
-    readonly "topaz-transparent": {
-      readonly category: "restoration";
-      readonly description: "Topaz upscaling that preserves the alpha channel end to end.";
-      readonly endpoint: "topaz/upscale/image/transparent";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Topaz Transparent Upscale";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: number;
-      };
-      readonly pricing: "$0.08 per 24 output megapixels";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/transparent";
-      readonly task: "transparent image upscaling";
-    };
-    readonly "topaz-video": {
-      readonly category: "upscale";
-      readonly defaultOptions: {
-        readonly model: "Proteus";
-        readonly upscale_factor: 2;
-      };
-      readonly description: "Professional Topaz video enhancement and upscaling.";
-      readonly endpoint: "fal-ai/topaz/upscale/video";
-      readonly inputField: "video_url";
-      readonly inputKind: "video";
-      readonly name: "Topaz Video Upscale";
-      readonly outputKeys: ["video"];
-      readonly price: {
-        readonly kind: "second";
-        readonly usd: 0.01;
-      };
-      readonly pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-      readonly task: "video enhancement";
-    };
-    readonly "bria-eraser": {
-      readonly category: "erase";
-      readonly description: "Commercial-safe removal of a masked region, inpainted from surrounding context.";
-      readonly endpoint: "fal-ai/bria/eraser";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Bria Eraser";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.04;
-      };
-      readonly pricing: "$0.04/generation";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/eraser";
-      readonly task: "masked object erasure";
-    };
-    readonly "bria-expand": {
-      readonly category: "reframe";
-      readonly description: "Expand an image onto a larger canvas, generating the new border area.";
-      readonly endpoint: "fal-ai/bria/expand";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Bria Image Expansion";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.04;
-      };
-      readonly pricing: "$0.04/generation";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/expand";
-      readonly task: "image outpainting";
-    };
-    readonly "bria-genfill": {
-      readonly category: "erase";
-      readonly description: "Generative fill of a masked region from a prompt, commercial-safe.";
-      readonly endpoint: "fal-ai/bria/genfill";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Bria GenFill";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.04;
-      };
-      readonly pricing: "$0.04/generation";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/genfill";
-      readonly task: "masked generative fill";
-    };
-    readonly "finegrain-eraser": {
-      readonly category: "erase";
-      readonly description: "Remove a prompted object and its shadows and reflections, filling the gap.";
-      readonly endpoint: "fal-ai/finegrain-eraser";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Finegrain Object Eraser";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.27;
-      };
-      readonly pricing: "$0.27/image at the default standard mode; $0.18 express, $0.36 premium";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/finegrain-eraser";
-      readonly task: "prompted object erasure";
-    };
-    readonly "flux-outpaint": {
-      readonly category: "reframe";
-      readonly description: "Outpaint an image by a per-edge pixel expansion with FLUX.2 pro.";
-      readonly endpoint: "fal-ai/flux-2-pro/outpaint";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "FLUX.2 Pro Outpaint";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.03 for the first output megapixel, then $0.015 per extra megapixel of input and output, rounded up";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/flux-2-pro/outpaint";
-      readonly task: "image outpainting";
-    };
-    readonly "iclight-v2": {
-      readonly category: "relight";
-      readonly description: "Relight a subject from a prompt, harmonising it with a new light direction.";
-      readonly endpoint: "fal-ai/iclight-v2";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "IC-Light v2";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.1;
-      };
-      readonly pricing: "$0.10/megapixel";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/iclight-v2";
-      readonly task: "prompted relighting";
-    };
-    readonly "ideogram-reframe": {
-      readonly category: "reframe";
-      readonly description: "Reframe an image to a new aspect ratio, generating the fill.";
-      readonly endpoint: "fal-ai/ideogram/v3/reframe";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Ideogram v3 Reframe";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.06;
-      };
-      readonly pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/reframe";
-      readonly task: "aspect ratio reframing";
-    };
-    readonly "lighting-restoration": {
-      readonly category: "relight";
-      readonly description: "Restore natural, even lighting across one or more input images.";
-      readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
-      readonly inputField: "image_urls";
-      readonly inputKind: "images";
-      readonly name: "Qwen Lighting Restoration";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.035;
-      };
-      readonly pricing: "$0.035/megapixel";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
-      readonly task: "lighting restoration";
-    };
-    readonly "object-removal": {
-      readonly category: "erase";
-      readonly description: "Remove a prompted object from an image and fill the gap.";
-      readonly endpoint: "fal-ai/object-removal";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Object Removal";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.024;
-      };
-      readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal";
-      readonly task: "prompted object removal";
-    };
-    readonly "object-removal-bbox": {
-      readonly category: "erase";
-      readonly description: "Remove whatever falls inside supplied bounding boxes.";
-      readonly endpoint: "fal-ai/object-removal/bbox";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Object Removal by Box";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.024;
-      };
-      readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox";
-      readonly task: "bounding box object removal";
-    };
-    readonly "object-removal-mask": {
-      readonly category: "erase";
-      readonly description: "Remove the masked region of an image and fill the gap.";
-      readonly endpoint: "fal-ai/object-removal/mask";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Object Removal by Mask";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.024;
-      };
-      readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask";
-      readonly task: "masked object removal";
-    };
-    readonly "remove-lighting": {
-      readonly category: "relight";
-      readonly description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.";
-      readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
-      readonly inputField: "image_urls";
-      readonly inputKind: "images";
-      readonly name: "Qwen Remove Lighting";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "megapixel";
-        readonly usd: 0.035;
-      };
-      readonly pricing: "$0.035/megapixel";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
-      readonly task: "lighting removal";
-    };
-    readonly "smart-resize": {
-      readonly category: "reframe";
-      readonly description: "Resize one image to several target sizes, recomposing rather than cropping.";
-      readonly endpoint: "fal-ai/smart-resize";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Smart Resize";
-      readonly outputKeys: ["images", "results"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/smart-resize";
-      readonly task: "multi-size recomposition";
-    };
-    readonly "text-removal": {
-      readonly category: "erase";
-      readonly defaultOptions: {
-        readonly output_format: "png";
-      };
-      readonly description: "Remove all rendered text from an image, rebuilding what sat behind it.";
-      readonly endpoint: "fal-ai/image-editing/text-removal";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Text Removal";
-      readonly outputKeys: ["images"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.04;
-      };
-      readonly pricing: "$0.04/image";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal";
-      readonly task: "text removal";
-    };
-    readonly "depth-anything": {
-      readonly category: "preprocess";
-      readonly description: "Generate Depth Anything v2 depth maps from input images.";
-      readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Depth Anything v2 Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
-      readonly task: "depth preprocessing";
-    };
-    readonly dwpose: {
-      readonly category: "preprocess";
-      readonly description: "Extract body, hand, and face pose skeletons from an image.";
-      readonly endpoint: "fal-ai/dwpose";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "DWPose Estimation";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "second";
-        readonly usd: 0.0006;
-      };
-      readonly pricing: "$0.0006/compute-second";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/dwpose";
-      readonly task: "pose preprocessing";
-    };
-    readonly hed: {
-      readonly category: "preprocess";
-      readonly description: "Generate HED soft edge maps for ControlNet-style workflows.";
-      readonly endpoint: "fal-ai/image-preprocessors/hed";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "HED Edge Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed";
-      readonly task: "edge preprocessing";
-    };
-    readonly lineart: {
-      readonly category: "preprocess";
-      readonly defaultOptions: {
-        readonly coarse: false;
-      };
-      readonly description: "Generate line art/control-style edges from an input image.";
-      readonly endpoint: "fal-ai/image-preprocessors/lineart";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Line Art Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
-      readonly task: "image preprocessing";
-    };
-    readonly "marigold-depth": {
-      readonly category: "depth";
-      readonly defaultOptions: {
-        readonly ensemble_size: 10;
-        readonly num_inference_steps: 10;
-      };
-      readonly description: "Create depth maps using Marigold depth estimation.";
-      readonly endpoint: "fal-ai/imageutils/marigold-depth";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Marigold Depth Estimation";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-      readonly task: "depth map";
-    };
-    readonly "midas-depth": {
-      readonly category: "depth";
-      readonly defaultOptions: {
-        readonly a: number;
-        readonly bg_th: 0.1;
-      };
-      readonly description: "Create MiDaS depth maps from input images.";
-      readonly endpoint: "fal-ai/imageutils/depth";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "MiDaS Depth Estimation";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-      readonly task: "depth map";
-    };
-    readonly "midas-preprocessor": {
-      readonly category: "preprocess";
-      readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-      readonly endpoint: "fal-ai/image-preprocessors/midas";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "MiDaS Preprocessor";
-      readonly outputKeys: ["depth_map", "normal_map"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas";
-      readonly task: "depth and normal preprocessing";
-    };
-    readonly mlsd: {
-      readonly category: "preprocess";
-      readonly description: "Detect straight line segments for architectural and interior control maps.";
-      readonly endpoint: "fal-ai/image-preprocessors/mlsd";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "M-LSD Line Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd";
-      readonly task: "line segment preprocessing";
-    };
-    readonly pidi: {
-      readonly category: "preprocess";
-      readonly description: "Generate PiDiNet soft edge maps from an input image.";
-      readonly endpoint: "fal-ai/image-preprocessors/pidi";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "PiDiNet Edge Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi";
-      readonly task: "edge preprocessing";
-    };
-    readonly "sam-preprocessor": {
-      readonly category: "preprocess";
-      readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-      readonly endpoint: "fal-ai/image-preprocessors/sam";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
-      readonly task: "segmentation preprocessing";
-    };
-    readonly "sam2-auto": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly min_mask_region_area: 100;
-        readonly output_format: "png";
-        readonly points_per_side: 32;
-        readonly pred_iou_thresh: 0.88;
-        readonly stability_score_thresh: 0.95;
-      };
-      readonly description: "Automatically segment an image into combined and individual masks.";
-      readonly endpoint: "fal-ai/sam2/auto-segment";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 2 Auto Segment";
-      readonly outputKeys: ["combined_mask", "individual_masks"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
-      readonly task: "automatic image segmentation";
-    };
-    readonly "sam3-1-image": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly max_masks: 3;
-        readonly output_format: "png";
-      };
-      readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-      readonly endpoint: "fal-ai/sam-3-1/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3.1 Image";
-      readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.01;
-      };
-      readonly pricing: "$0.01/request";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-      readonly task: "promptable image segmentation";
-    };
-    readonly "sam3-1-video": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly prompt: "person";
-      };
-      readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
-      readonly endpoint: "fal-ai/sam-3-1/video";
-      readonly inputField: "video_url";
-      readonly inputKind: "video";
-      readonly name: "SAM 3.1 Video";
-      readonly outputKeys: ["video", "boundingbox_frames_zip"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.01/16 frames of video input";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
-      readonly task: "multi-object video segmentation";
-    };
-    readonly "sam3-image": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly max_masks: 3;
-        readonly output_format: "png";
-      };
-      readonly description: "Segment image objects with text, point, or box prompts.";
-      readonly endpoint: "fal-ai/sam-3/image";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3 Image";
-      readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.005;
-      };
-      readonly pricing: "$0.005/request";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
-      readonly task: "promptable image segmentation";
-    };
-    readonly "sam3-image-rle": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly max_masks: 3;
-      };
-      readonly description: "Segment image objects and return run-length encoded masks.";
-      readonly endpoint: "fal-ai/sam-3/image-rle";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "SAM 3 Image RLE";
-      readonly outputKeys: ["rle", "scores", "boxes", "metadata"];
-      readonly price: {
-        readonly kind: "call";
-        readonly usd: 0.005;
-      };
-      readonly pricing: "$0.005/request";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle";
-      readonly task: "promptable image segmentation to RLE";
-    };
-    readonly "sam3-video": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly detection_threshold: 0.5;
-        readonly prompt: "person";
-        readonly video_output_type: "X264 (.mp4)";
-      };
-      readonly description: "Segment and track prompted objects across video frames.";
-      readonly endpoint: "fal-ai/sam-3/video";
-      readonly inputField: "video_url";
-      readonly inputKind: "video";
-      readonly name: "SAM 3 Video";
-      readonly outputKeys: ["video", "boundingbox_frames_zip"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.005/16 frames of video input";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
-      readonly task: "promptable video segmentation";
-    };
-    readonly "sam3-video-rle": {
-      readonly category: "segmentation";
-      readonly defaultOptions: {
-        readonly apply_mask: true;
-        readonly detection_threshold: 0.5;
-        readonly prompt: "person";
-      };
-      readonly description: "Track prompted video objects and return RLE mask data.";
-      readonly endpoint: "fal-ai/sam-3/video-rle";
-      readonly inputField: "video_url";
-      readonly inputKind: "video";
-      readonly name: "SAM 3 Video RLE";
-      readonly outputKeys: ["video", "boundingbox_frames_zip"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0.005/16 frames of video";
-      readonly queued: true;
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
-      readonly task: "promptable video segmentation to RLE";
-    };
-    readonly scribble: {
-      readonly category: "preprocess";
-      readonly description: "Turn an image into a scribble-style control map.";
-      readonly endpoint: "fal-ai/image-preprocessors/scribble";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "Scribble Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble";
-      readonly task: "scribble preprocessing";
-    };
-    readonly teed: {
-      readonly category: "preprocess";
-      readonly description: "Generate TEED edge maps from an input image.";
-      readonly endpoint: "fal-ai/image-preprocessors/teed";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "TEED Edge Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed";
-      readonly task: "edge preprocessing";
-    };
-    readonly "zoe-depth": {
-      readonly category: "preprocess";
-      readonly description: "Generate ZoeDepth metric depth maps from an input image.";
-      readonly endpoint: "fal-ai/image-preprocessors/zoe";
-      readonly inputField: "image_url";
-      readonly inputKind: "image";
-      readonly name: "ZoeDepth Preprocessor";
-      readonly outputKeys: ["image"];
-      readonly price: {
-        readonly kind: "metered";
-      };
-      readonly pricing: "$0/compute-second listed by fal";
-      readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
-      readonly task: "depth preprocessing";
-    };
-  };
-  /**
-   * The seam `server-tools.ts` runs against — the client's authenticated fetch
-   * and its queue status parser, exposed without widening the public surface.
-   */
-  private get toolExecutor();
-  /** ─── Private ─────────────────────────────────────────────── */
-  /** Authenticated fetch to fal.ai APIs with retry logic. */
-  private request;
-  private ephemeralHeaders;
-  /**
-   * Normalize fal.ai responses.
-   * Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
-   */
-  private normalizeResponse;
+export declare const TIERS: readonly ["fast", "balanced", "quality"];
+/** How far a Task trades cost and speed for quality. */
+type Tier = (typeof TIERS)[number];
+export declare const DEFAULT_TIER: Tier;
+/** Where a Task's order came from. */
+type RankedFrom = "bench" | "hand";
+/** Something a request needs that not every Model can honour. */
+type Capability = "aspect" | "count" | "image" | "mask" | "negativePrompt" | "outputFormat" | "references" | "resolution" | "rig" | "seed" | "transparency" | "video";
+interface RankedModel {
+  /** A Model id, as accepted by `-m` or `TaskInput.model`. */
+  readonly model: string;
+  /** The Tier this Model is offered at. */
+  readonly tier: Tier;
+  /** The mode this entry serves. Absent for the Task's plain job. */
+  readonly mode?: string;
+  /** Capabilities this Model has for this Task beyond its registry profile. */
+  readonly supports?: readonly Capability[];
+  /** The Model works without a Source, such as a tile made from a prompt. */
+  readonly sourceOptional?: true;
+  /** Inputs the request must supply for this Model to be chosen, e.g. a mask. */
+  readonly requires?: readonly Capability[];
+}
+interface TaskMode {
+  readonly id: string;
+  /** One sentence: what this mode does differently. */
+  readonly summary: string;
+}
+interface TaskDefinition {
+  /** One sentence: the job, in the words a caller would use. */
+  readonly summary: string;
+  /** What to use instead, naming the sibling Task. */
+  readonly notFor: string;
+  readonly rankedFrom: RankedFrom;
+  /** ISO date the order was last set. */
+  readonly rankedAt: string;
+  /** How the order was decided, for the reviewer of the next change. */
+  readonly basis: string;
+  /** Named variants of the job. Every `mode` on a ranked entry is listed here. */
+  readonly modes?: readonly TaskMode[];
+  /** Best first. Order within a Tier is the order tried at that Tier. */
+  readonly models: readonly RankedModel[];
 }
+/** Every Task with a Model. A Task is absent here until it has at least one Model. */
+export declare const TASKS: {
+  readonly animate: {
+    readonly basis: "Hand-ranked. Kling v3 Pro leads with audio, an end frame and a negative prompt at $0.112-$0.168/sec; Kling v3 Turbo Pro is the fast pick at $0.14/sec without them.";
+    readonly models: readonly [{
+      readonly model: "kling";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "kling-turbo";
+      readonly tier: "fast";
+    }];
+    readonly notFor: "A still image (generate), or variations of one (vary).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Turn a still image into a short video clip.";
+  };
+  readonly ask: {
+    readonly basis: "Hand-ranked. Moondream answers questions, captions, detects and points; GOT-OCR transcribes text; the NSFW classifier answers the safety question.";
+    readonly modes: readonly [{
+      readonly id: "caption";
+      readonly summary: "Write a caption for the image.";
+    }, {
+      readonly id: "detect";
+      readonly summary: "Return bounding boxes for a named thing.";
+    }, {
+      readonly id: "point";
+      readonly summary: "Return a point on every instance of a named thing.";
+    }, {
+      readonly id: "read";
+      readonly summary: "Transcribe the text in the image.";
+    }, {
+      readonly id: "safe";
+      readonly summary: "Say whether the image is safe for work.";
+    }];
+    readonly models: readonly [{
+      readonly model: "moondream-query";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "caption";
+      readonly model: "moondream-caption";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "detect";
+      readonly model: "moondream-detect";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "point";
+      readonly model: "moondream-point";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "read";
+      readonly model: "got-ocr";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "safe";
+      readonly model: "nsfw";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Pixel masks of a named thing (segment).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Answer a question about an image, caption it, count or find things in it.";
+  };
+  readonly cutout: {
+    readonly basis: "Hand-ranked from fal price and edge quality: Bria for commercial-safe edges, BEN v2 and BiRefNet as the balanced picks, rembg as the cheap one. For video, Bria's VRMBG 3.0 ($0.05/sec) leads the older Bria remover ($0.14/sec).";
+    readonly models: readonly [{
+      readonly model: "bria-rmbg";
+      readonly tier: "quality";
+    }, {
+      readonly model: "birefnet";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "ben-v2";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "rembg";
+      readonly tier: "fast";
+    }, {
+      readonly model: "bria-video-rmbg-v3";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "bria-video-rmbg";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Cutting one named thing out of a scene, such as the chair in a room (segment), or taking an object out and filling the gap (erase).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Remove the background behind the main subject of an image or video.";
+  };
+  readonly erase: {
+    readonly basis: "Hand-ranked. Finegrain also removes shadows and reflections and costs ten times more, so it leads the quality tier only. With a mask, Bria's eraser leads and fal's mask remover is the balanced pick.";
+    readonly modes: readonly [{
+      readonly id: "boxes";
+      readonly summary: "Remove whatever falls inside the given boxes.";
+    }, {
+      readonly id: "text";
+      readonly summary: "Remove all rendered text.";
+    }, {
+      readonly id: "with";
+      readonly summary: "Fill the masked region with something described in words.";
+    }];
+    readonly models: readonly [{
+      readonly model: "finegrain-eraser";
+      readonly tier: "quality";
+    }, {
+      readonly model: "object-removal";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "bria-eraser";
+      readonly requires: readonly ["mask"];
+      readonly supports: readonly ["mask"];
+      readonly tier: "quality";
+    }, {
+      readonly model: "object-removal-mask";
+      readonly requires: readonly ["mask"];
+      readonly supports: readonly ["mask"];
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "boxes";
+      readonly model: "object-removal-bbox";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "text";
+      readonly model: "text-removal";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "with";
+      readonly model: "bria-genfill";
+      readonly requires: readonly ["mask"];
+      readonly supports: readonly ["mask"];
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "The whole background (cutout), or extending the canvas (reframe).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Remove an object, person, text or clutter from an image and fill the gap.";
+  };
+  readonly generate: {
+    readonly basis: "Hand-ranked. Tiers set by fal price per image (quality ≥ $0.07, balanced $0.02-$0.15 with edit quality, fast ≤ $0.04); order within a tier by Artificial Analysis text-to-image Elo, snapshot 2026-08-23, unranked models last. banana leads balanced because it is the house default the looks are tuned on. Ideogram V3 Transparent follows it but is chosen only for a transparent request, so transparency needs no OpenAI key at balanced; token-metered Nano Banana 2 Lite sits in balanced by its Elo.";
+    readonly models: readonly RankedModel[];
+    readonly notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make an image from a prompt, or change an image you pass as a reference.";
+  };
+  readonly layers: {
+    readonly basis: "Hand-ranked. Qwen gives a set number of stacked RGBA layers; Seedream names and orders object layers; Ideogram separates text from artwork.";
+    readonly modes: readonly [{
+      readonly id: "text";
+      readonly summary: "Separate the text from the artwork as editable text.";
+    }];
+    readonly models: readonly [{
+      readonly model: "seedream-layerize";
+      readonly tier: "quality";
+    }, {
+      readonly model: "qwen-layered";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "text";
+      readonly model: "ideogram-layerize-text";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Masking one named thing (segment), or removing the background (cutout).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Split an image into transparent layers.";
+  };
+  readonly map: {
+    readonly basis: "Hand-ranked. Depth is the plain job: Marigold for quality, Depth Anything v2 balanced, MiDaS fast. The other maps are modes, each with its own Models.";
+    readonly modes: readonly [{
+      readonly id: "edges";
+      readonly summary: "A soft edge map.";
+    }, {
+      readonly id: "lineart";
+      readonly summary: "A line-art map.";
+    }, {
+      readonly id: "lines";
+      readonly summary: "Straight line segments, for architecture and interiors.";
+    }, {
+      readonly id: "metric";
+      readonly summary: "Metric depth, in real distances.";
+    }, {
+      readonly id: "normals";
+      readonly summary: "A surface normal map.";
+    }, {
+      readonly id: "pose";
+      readonly summary: "Body, hand and face pose skeletons.";
+    }, {
+      readonly id: "scribble";
+      readonly summary: "A scribble-style map.";
+    }, {
+      readonly id: "segments";
+      readonly summary: "A segmentation map.";
+    }];
+    readonly models: readonly [{
+      readonly model: "marigold-depth";
+      readonly tier: "quality";
+    }, {
+      readonly model: "depth-anything";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "midas-depth";
+      readonly tier: "fast";
+    }, {
+      readonly mode: "edges";
+      readonly model: "teed";
+      readonly tier: "quality";
+    }, {
+      readonly mode: "edges";
+      readonly model: "hed";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "edges";
+      readonly model: "pidi";
+      readonly tier: "fast";
+    }, {
+      readonly mode: "lineart";
+      readonly model: "lineart";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "lines";
+      readonly model: "mlsd";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "metric";
+      readonly model: "zoe-depth";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "normals";
+      readonly model: "midas-preprocessor";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "pose";
+      readonly model: "dwpose";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "scribble";
+      readonly model: "scribble";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "segments";
+      readonly model: "sam-preprocessor";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Masks of a named thing (segment), or PBR material maps (material).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make a control map of an image: depth, edges, lines, normals or pose.";
+  };
+  readonly material: {
+    readonly basis: "Hand-ranked. Patina is the only PBR decomposition Model; extract works on a region.";
+    readonly modes: readonly [{
+      readonly id: "extract";
+      readonly summary: "Extract a tiling material from a named region.";
+    }];
+    readonly models: readonly [{
+      readonly model: "patina";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "extract";
+      readonly model: "patina-extract";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "A seamless texture without PBR maps (tile), or depth and normals of a scene (map).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Turn a surface photograph into PBR maps: colour, normal, roughness, metalness, height.";
+  };
+  readonly mesh: {
+    readonly basis: "Hand-ranked from fal price and published quality: Meshy v7 leads quality and is the only Model that rigs a mesh; Hunyuan3D v3 is the quality second at under a third of the price; TRELLIS 2 balanced. SAM 3D reconstructs several prompted objects, or a human body.";
+    readonly modes: readonly [{
+      readonly id: "body";
+      readonly summary: "Reconstruct a human body mesh with keypoints.";
+    }, {
+      readonly id: "objects";
+      readonly summary: "Reconstruct a named object from one image.";
+    }];
+    readonly models: readonly [{
+      readonly model: "meshy-v7";
+      readonly tier: "quality";
+    }, {
+      readonly model: "hunyuan3d-v3";
+      readonly tier: "quality";
+    }, {
+      readonly model: "trellis-2";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "body";
+      readonly model: "sam3-3d-body";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "objects";
+      readonly model: "sam3-3d-objects";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "A flat image of an object (generate), or depth of a scene (map).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make a textured 3D mesh from one image.";
+  };
+  readonly reframe: {
+    readonly basis: "Hand-ranked. Ideogram reframes to a ratio and leads; Bria expands to a ratio for less. FLUX outpaints by a per-edge pixel margin. Smart resize makes several sizes at once.";
+    readonly modes: readonly [{
+      readonly id: "margin";
+      readonly summary: "Extend each edge by a set number of pixels.";
+    }, {
+      readonly id: "sizes";
+      readonly summary: "Make several target sizes at once, recomposing each.";
+    }];
+    readonly models: readonly [{
+      readonly model: "ideogram-reframe";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "bria-expand";
+      readonly tier: "fast";
+    }, {
+      readonly mode: "margin";
+      readonly model: "flux-outpaint";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "sizes";
+      readonly model: "smart-resize";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "A new image at a given ratio (generate with a ratio).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Extend or recut an image to a new aspect ratio, generating the new edges.";
+  };
+  readonly relight: {
+    readonly basis: "Hand-ranked. IC-Light relights to a described light or a mood, with or without a mask; the two lighting Models even out or strip baked-in light.";
+    readonly modes: readonly [{
+      readonly id: "even";
+      readonly summary: "Restore natural, even lighting.";
+    }, {
+      readonly id: "flat";
+      readonly summary: "Strip baked-in light and shadow to a neutral surface.";
+    }];
+    readonly models: readonly [{
+      readonly model: "iclight-v2";
+      readonly supports: readonly ["mask"];
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "even";
+      readonly model: "lighting-restoration";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "flat";
+      readonly model: "remove-lighting";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Regenerating the scene in a new light (generate with a mood).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Change the light in a photo without regenerating it.";
+  };
+  readonly restore: {
+    readonly basis: "Hand-ranked. Each mode names what is wrong and has the Model that fixes it; the plain job is Topaz's general restoration. Control Light, a FLUX.2 klein fine-tune at $0.03/MP, brightens dark photos.";
+    readonly modes: readonly [{
+      readonly id: "colour";
+      readonly summary: "Colourise a black-and-white photograph.";
+    }, {
+      readonly id: "dark";
+      readonly summary: "Brighten a dark or underexposed photo.";
+    }, {
+      readonly id: "noise";
+      readonly summary: "Remove noise.";
+    }, {
+      readonly id: "scratches";
+      readonly summary: "Repair scratches, tears and damage.";
+    }, {
+      readonly id: "softness";
+      readonly summary: "Sharpen a soft or blurred image.";
+    }, {
+      readonly id: "tone";
+      readonly summary: "Fix exposure, white balance and colour.";
+    }];
+    readonly models: readonly [{
+      readonly model: "topaz-restore";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "colour";
+      readonly model: "ddcolor";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "dark";
+      readonly model: "control-light";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "noise";
+      readonly model: "topaz-denoise";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "scratches";
+      readonly model: "topaz-restore";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "softness";
+      readonly model: "topaz-sharpen";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "tone";
+      readonly model: "topaz-adjust";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Making an image larger (upscale).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Fix noise, softness, damage, colour or tone without changing the size.";
+  };
+  readonly restyle: {
+    readonly basis: "Hand-ranked. One Model: TeleStyle v2.";
+    readonly models: readonly [{
+      readonly model: "telestyle-v2";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "A house style kept across images (generate with a look).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Redraw an image in the style of a reference image.";
+  };
+  readonly segment: {
+    readonly basis: "Hand-ranked. SAM 3.1 for quality, SAM 3 balanced; SAM 2 segments everything without a prompt. RLE modes return run-length masks.";
+    readonly modes: readonly [{
+      readonly id: "auto";
+      readonly summary: "Segment every region without a prompt.";
+    }, {
+      readonly id: "rle";
+      readonly summary: "Return run-length encoded masks instead of images.";
+    }];
+    readonly models: readonly [{
+      readonly model: "sam3-1-image";
+      readonly tier: "quality";
+    }, {
+      readonly model: "sam3-image";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "sam3-1-video";
+      readonly tier: "quality";
+    }, {
+      readonly model: "sam3-video";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "auto";
+      readonly model: "sam2-auto";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "rle";
+      readonly model: "sam3-image-rle";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "rle";
+      readonly model: "sam3-video-rle";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "The background behind the subject (cutout), or boxes without masks (ask detect).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Mask or cut out a named thing in an image or video.";
+  };
+  readonly tile: {
+    readonly basis: "Hand-ranked. Ideogram makes the tile; SeedVR upscales one while keeping its edges seamless.";
+    readonly modes: readonly [{
+      readonly id: "upscale";
+      readonly summary: "Upscale a tiling texture and keep it seamless.";
+    }];
+    readonly models: readonly [{
+      readonly model: "ideogram-tiling";
+      readonly sourceOptional: true;
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "upscale";
+      readonly model: "seedvr-seamless";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "PBR maps of a surface (material).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make a seamlessly tiling texture.";
+  };
+  readonly "try-on": {
+    readonly basis: "Hand-ranked. One Model: Google's virtual try-on.";
+    readonly models: readonly [{
+      readonly model: "virtual-try-on";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Changing clothes by description (generate with a reference).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Dress a person in a garment from another image.";
+  };
+  readonly upscale: {
+    readonly basis: "Hand-ranked. Topaz Precision and Topaz Image lead quality for fidelity at $0.003/MP; Clarity stays the balanced default it was as --up; Crystal is fast. SeedVR is the balanced second. Topaz Transparent is the only Model that keeps alpha. Generative and creative modes invent detail. Topaz Video upscales video.";
+    readonly modes: readonly [{
+      readonly id: "creative";
+      readonly summary: "Reimagine detail as it enlarges.";
+    }, {
+      readonly id: "generative";
+      readonly summary: "Synthesise plausible detail as it enlarges.";
+    }];
+    readonly models: readonly [{
+      readonly model: "topaz-precision";
+      readonly tier: "quality";
+    }, {
+      readonly model: "topaz-image";
+      readonly tier: "quality";
+    }, {
+      readonly model: "clarity";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "seedvr-upscale";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "crystal";
+      readonly tier: "fast";
+    }, {
+      readonly model: "topaz-transparent";
+      readonly supports: readonly ["transparency"];
+      readonly tier: "balanced";
+    }, {
+      readonly model: "topaz-video";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "creative";
+      readonly model: "topaz-creative";
+      readonly tier: "balanced";
+    }, {
+      readonly mode: "generative";
+      readonly model: "topaz-generative";
+      readonly tier: "balanced";
+    }];
+    readonly notFor: "Fixing noise, softness or colour without changing the size (restore).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make an image or video larger without losing detail.";
+  };
+  readonly vectorize: {
+    readonly basis: "Hand-ranked. Recraft gives a clean SVG with few paths; image2svg traces faithfully with many paths and costs an eighth as much.";
+    readonly models: readonly [{
+      readonly model: "recraft-vectorize";
+      readonly tier: "balanced";
+    }, {
+      readonly model: "image2svg";
+      readonly tier: "fast";
+    }];
+    readonly notFor: "Drawing a new image from a prompt (generate).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Trace a raster image to a clean SVG.";
+  };
+  readonly vary: {
+    readonly basis: "The generate ranking, filtered to Models that can edit. vary reuses the Model of the image it varies while Motif still offers it.";
+    readonly models: RankedModel[];
+    readonly notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).";
+    readonly rankedAt: "2026-09-16";
+    readonly rankedFrom: "hand";
+    readonly summary: "Make variations of an image you already have.";
+  };
+};
+/** A Task that has at least one Model. */
+type TaskId = keyof typeof TASKS;
+export declare const TASK_IDS: readonly TaskId[];
+export declare function isTaskId(value: string): value is TaskId;
 //#endregion
-//#region src/tool-types.d.ts
-type FalToolInputKind = "image" | "images" | "video";
+//#region src/resolve.d.ts
+/** What the request needs. Only the fields that narrow the choice. */
+interface TaskRequest {
+  /** Explicit Model id, e.g. from `--model`. Overrides everything. */
+  readonly model?: string;
+  /** Look id. A Look fixes the Model, so `tier` has no effect with one. */
+  readonly look?: string;
+  readonly tier?: Tier;
+  /** Transparent output wanted. */
+  readonly transparent?: boolean;
+  /** Number of reference images passed in. */
+  readonly references?: number;
+  /** A mask image is passed in. */
+  readonly mask?: boolean;
+  /** An aspect ratio is asked for, e.g. `"3:2"`. */
+  readonly aspect?: string;
+  /** A resolution tier is asked for, e.g. `"1K"`. */
+  readonly resolution?: string;
+  /** Number of outputs wanted. */
+  readonly count?: number;
+  readonly seed?: boolean;
+  readonly negativePrompt?: boolean;
+  readonly outputFormat?: boolean;
+  /** A rigged mesh wanted. */
+  readonly rig?: boolean;
+  /** The kind of Source passed in. Absent for a text-only request. */
+  readonly source?: "image" | "video";
+  /** A named variant of the Task, e.g. `"text"` for erase. */
+  readonly mode?: string;
+}
+interface TaskEnvironment {
+  /** Names of the provider key variables that are set, e.g. `["FAL_KEY"]`. */
+  readonly keys: readonly string[];
+  /** Models pinned per Task in config (`tasks.<task>.model`). */
+  readonly pins?: Readonly<Partial<Record<TaskId, string>>>;
+}
+/** Which rule fixed the Model. */
+type ChosenBy = "look" | "model" | "pin" | "ranking";
+type Blocker = Capability | "key" | "mode" | "unknown-model";
 /**
- * Machine-readable cost, so `--dry-run` can emit a number rather than the
- * prose in `pricing`. Required on every entry: a missing price is what makes
- * an agent unable to budget across a registry spanning $0.001 to $0.48.
+ * What unblocks a refused request: name another Model, set a key, drop an
+ * option the request asked for, or supply an input a Model needs (a mask).
  */
-type FalToolPrice = {
-  kind: "call";
-  usd: number;
-} | {
-  kind: "megapixel";
-  usd: number;
-} | {
-  kind: "second";
-  usd: number;
-} | {
-  kind: "metered";
-};
-interface FalToolConfig {
-  category: "3d" | "analysis" | "background" | "depth" | "erase" | "layers" | "material" | "moderation" | "preprocess" | "reframe" | "relight" | "restoration" | "segmentation" | "upscale" | "vector";
-  defaultOptions?: Record<string, unknown>;
-  description: string;
-  endpoint: string;
-  inputField: "image_url" | "image_urls" | "input_image_url" | "input_image_urls" | "video_url";
-  inputKind: FalToolInputKind;
-  name: string;
-  outputKeys: string[];
-  /**
-   * Names for the positions of an array-valued output. Used to name downloaded
-   * 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.
-   *
-   * 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.
-   *
-   * 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;
-  /**
-   * Endpoint routinely exceeds the 120s sync timeout; callers should use the
-   * queue path.
-   */
-  queued?: true;
-  sourceUrl: string;
-  task: string;
+type Unblocker = "input" | "key" | "model" | "option";
+export declare const NO_MODEL_AVAILABLE = "NO_MODEL_AVAILABLE";
+interface TaskResolved {
+  readonly ok: true;
+  readonly task: TaskId;
+  readonly model: string;
+  readonly tier: Tier;
+  readonly rankedFrom: RankedFrom;
+  readonly chosenBy: ChosenBy;
 }
-interface FalToolRunOptions {
-  input?: string;
-  inputs?: string[];
-  options?: Record<string, unknown>;
-  tool: string;
+interface TaskUnresolved {
+  readonly ok: false;
+  readonly error: typeof NO_MODEL_AVAILABLE;
+  readonly task: TaskId;
+  /** The capability, or missing key, that stopped the best candidate. */
+  readonly blockedBy: Blocker;
+  /** What would unblock it: name a Model, set a key, drop the option. */
+  readonly unblockedBy: readonly Unblocker[];
+  /** The key variable that would unblock a Model, when one would. */
+  readonly missingKey?: string;
+  readonly message: string;
 }
-interface FalToolRequest {
-  body: Record<string, unknown>;
-  endpoint: string;
-  tool: FalToolConfig;
+type TaskResolution = TaskResolved | TaskUnresolved;
+interface ModelProfile {
+  readonly capabilities: ReadonlySet<Capability>;
+  /** Capabilities reachable only when this key variable is set. */
+  readonly keyedCapabilities: ReadonlyMap<Capability, string>;
+  /** Key variables the Model needs for any request. */
+  readonly keys: readonly string[];
+  readonly maxReferences: number;
+  /** Aspect ratios the Model accepts. Absent means any. */
+  readonly aspects?: readonly string[];
+  /** Resolutions the Model accepts. Absent means any. */
+  readonly resolutions?: readonly string[];
 }
-//#endregion
-//#region src/tools.d.ts
-export declare const FAL_TOOLS: {
-  readonly "got-ocr": {
-    readonly category: "analysis";
-    readonly description: "Transcribe text from one or more images, optionally as formatted multi-page output.";
-    readonly endpoint: "fal-ai/got-ocr/v2";
-    readonly inputField: "input_image_urls";
-    readonly inputKind: "images";
-    readonly name: "GOT-OCR 2.0";
-    readonly outputKeys: ["outputs"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.05/image";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2";
-    readonly task: "optical character recognition";
-  };
-  readonly "moondream-caption": {
-    readonly category: "analysis";
-    readonly description: "Write a short, normal, or long caption for an image.";
-    readonly endpoint: "fal-ai/moondream3-preview/caption";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Moondream 3 Caption";
-    readonly outputKeys: ["output"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption";
-    readonly task: "image captioning";
-  };
-  readonly "moondream-detect": {
-    readonly category: "analysis";
-    readonly description: "Detect prompted objects and return their bounding boxes, with an optional preview.";
-    readonly endpoint: "fal-ai/moondream3-preview/detect";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Moondream 3 Detect";
-    readonly outputKeys: ["objects", "image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect";
-    readonly task: "object detection";
-  };
-  readonly "moondream-point": {
-    readonly category: "analysis";
-    readonly description: "Return point coordinates for every instance of a prompted subject.";
-    readonly endpoint: "fal-ai/moondream3-preview/point";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Moondream 3 Point";
-    readonly outputKeys: ["points", "image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point";
-    readonly task: "object pointing";
-  };
-  readonly "moondream-query": {
-    readonly category: "analysis";
-    readonly description: "Answer a free-form question about an image, with reasoning.";
-    readonly endpoint: "fal-ai/moondream3-preview/query";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Moondream 3 Query";
-    readonly outputKeys: ["output", "reasoning"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.40/M input tokens, $3.50/M output tokens";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/query";
-    readonly task: "visual question answering";
-  };
-  readonly nsfw: {
-    readonly category: "moderation";
-    readonly description: "Predict whether one or more images contain NSFW concepts.";
-    readonly endpoint: "fal-ai/x-ailab/nsfw";
-    readonly inputField: "image_urls";
-    readonly inputKind: "images";
-    readonly name: "NSFW Checker";
-    readonly outputKeys: ["has_nsfw_concepts"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.001/image";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-    readonly task: "vision moderation";
-  };
-  readonly "hunyuan3d-v3": {
-    readonly category: "3d";
-    readonly description: "Reconstruct a textured 3D mesh from a single image, with optional multi-view inputs.";
-    readonly endpoint: "fal-ai/hunyuan3d-v3/image-to-3d";
-    readonly inputField: "input_image_url";
-    readonly inputKind: "image";
-    readonly name: "Hunyuan3D v3 Image to 3D";
-    readonly outputKeys: ["model_glb", "model_urls", "thumbnail"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.375;
-    };
-    readonly pricing: "$0.375/generation at the default Normal type; $0.45 low poly, $0.225 geometry only, and $0.15 each for PBR, multi-view, or a custom face count";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/hunyuan3d-v3/image-to-3d";
-    readonly task: "single-image 3D reconstruction";
-  };
-  readonly "ideogram-layerize-text": {
-    readonly category: "layers";
-    readonly description: "Split an image into background image layers plus editable HTML text containers.";
-    readonly endpoint: "fal-ai/ideogram/v3/layerize-text";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Ideogram v3 Text Layerize";
-    readonly outputKeys: ["image_layers", "image", "text_html", "text_containers"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.09;
-    };
-    readonly pricing: "$0.09/image";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/layerize-text";
-    readonly task: "text and image layer extraction";
-  };
-  readonly "ideogram-tiling": {
-    readonly category: "material";
-    readonly description: "Generate a seamlessly tiling texture, optionally conditioned on a source image.";
-    readonly endpoint: "ideogram/v4/tiling";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Ideogram v4 Tiling";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.06;
-    };
-    readonly pricing: "$0.06/megapixel at the default BALANCED speed; $0.03 turbo, $0.10 quality";
-    readonly sourceUrl: "https://fal.ai/models/ideogram/v4/tiling";
-    readonly task: "seamless texture generation";
-  };
-  readonly image2svg: {
-    readonly category: "vector";
-    readonly description: "Trace a raster image into layered SVG paths.";
-    readonly endpoint: "fal-ai/image2svg";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Image to SVG";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.005;
-    };
-    readonly pricing: "$0.005/image";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image2svg";
-    readonly task: "raster to vector tracing";
-  };
-  readonly patina: {
-    readonly category: "material";
-    readonly description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.";
-    readonly endpoint: "fal-ai/patina";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Patina PBR Maps";
-    readonly outputKeys: ["images"];
-    readonly outputLabels: {
-      readonly images: {
-        readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
-        readonly fromOption: "maps";
-      };
-    };
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.01 base plus $0.01/megapixel per output map, so all 5 maps on a 1MP image cost $0.06; the listed rate is per map";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/patina";
-    readonly task: "PBR material decomposition";
-  };
-  readonly "patina-extract": {
-    readonly category: "material";
-    readonly description: "Extract a tiling PBR material from a prompted region of a photograph.";
-    readonly endpoint: "fal-ai/patina/material/extract";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Patina Material Extract";
-    readonly outputKeys: ["images"];
-    readonly outputLabels: {
-      readonly images: {
-        readonly fallback: readonly ["basecolor", "normal", "roughness", "metalness", "height"];
-        readonly fromOption: "maps";
-      };
-    };
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.10 base only; add $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract";
-    readonly task: "tiling material extraction";
-  };
-  readonly "qwen-layered": {
-    readonly category: "layers";
-    readonly description: "Split an image into a configurable number of stacked RGBA layers.";
-    readonly endpoint: "fal-ai/qwen-image-layered";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Qwen Image Layered";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.05 per image; fal does not say whether that counts the input image or each of the generated layers, so no estimate is reported";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered";
-    readonly task: "image layer decomposition";
-  };
-  readonly "recraft-vectorize": {
-    readonly category: "vector";
-    readonly description: "Convert a raster image into a clean SVG.";
-    readonly endpoint: "fal-ai/recraft/vectorize";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Recraft Vectorize";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.04;
-    };
-    readonly pricing: "$0.04/image, $0.08 with a vector style";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/recraft/vectorize";
-    readonly task: "raster to vector conversion";
-  };
-  readonly "sam3-3d-align": {
-    readonly category: "3d";
-    readonly description: "Align SAM 3D objects and bodies into a shared scene.";
-    readonly endpoint: "fal-ai/sam-3/3d-align";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3D Align";
-    readonly outputKeys: ["scene_glb", "model_glb", "visualization", "body_mesh_ply", "metadata"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align";
-    readonly task: "3D scene alignment";
-  };
-  readonly "sam3-3d-body": {
-    readonly category: "3d";
-    readonly defaultOptions: {
-      readonly export_meshes: true;
-      readonly include_3d_keypoints: true;
-      readonly include_mhr_params: true;
-    };
-    readonly description: "Reconstruct human body meshes and keypoints from a single image.";
-    readonly endpoint: "fal-ai/sam-3/3d-body";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3D Body";
-    readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body";
-    readonly task: "single-image 3D body reconstruction";
-  };
-  readonly "sam3-3d-objects": {
-    readonly category: "3d";
-    readonly defaultOptions: {
-      readonly prompt: "car";
-    };
-    readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
-    readonly endpoint: "fal-ai/sam-3/3d-objects";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3D Objects";
-    readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.02 per unit; fal does not define a unit, and this endpoint returns one mesh per detected object, so no estimate is reported";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
-    readonly task: "single-image 3D object reconstruction";
-  };
-  readonly "seedream-layerize": {
-    readonly category: "layers";
-    readonly description: "Split an image into editable Seedream layers plus flattened previews.";
-    readonly endpoint: "bytedance/seedream/v5/pro/layerize";
-    readonly inputField: "image_url";
-    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";
-    };
-    readonly pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize";
-    readonly task: "image layer decomposition";
-  };
-  readonly "seedvr-seamless": {
-    readonly category: "material";
-    readonly description: "Upscale a tiling texture while keeping its edges seamless. ";
-    readonly endpoint: "fal-ai/seedvr/upscale/image/seamless";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SeedVR Seamless Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.0025;
-    };
-    readonly pricing: "$0.0025/megapixel";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless";
-    readonly task: "seamless texture upscaling";
-  };
-  readonly "trellis-2": {
-    readonly category: "3d";
-    readonly description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.";
-    readonly endpoint: "fal-ai/trellis-2";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "TRELLIS 2";
-    readonly outputKeys: ["model_glb"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.3;
-    };
-    readonly pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/trellis-2";
-    readonly task: "single-image 3D reconstruction";
-  };
-  readonly "ben-v2": {
-    readonly category: "background";
-    readonly description: "Fast, high-quality background removal for images.";
-    readonly endpoint: "fal-ai/ben/v2/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "BEN v2 Background Removal";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.025;
-    };
-    readonly pricing: "$0.025/megapixel";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image";
-    readonly task: "image background removal";
-  };
-  readonly birefnet: {
-    readonly category: "background";
-    readonly defaultOptions: {
-      readonly model: "General Use (Light)";
-      readonly operating_resolution: "1024x1024";
-      readonly output_format: "png";
-      readonly refine_foreground: true;
-    };
-    readonly description: "High-resolution dichotomous image segmentation and background removal.";
-    readonly endpoint: "fal-ai/birefnet/v2";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "BirefNet Background Removal";
-    readonly outputKeys: ["image", "mask_image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
-    readonly task: "image background removal";
-  };
-  readonly "bria-rmbg": {
-    readonly category: "background";
-    readonly description: "Commercial-safe background removal for images.";
-    readonly endpoint: "fal-ai/bria/background/remove";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Bria RMBG 2.0";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.018;
-    };
-    readonly pricing: "$0.018/generation";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
-    readonly task: "image background removal";
-  };
-  readonly "bria-video-rmbg": {
-    readonly category: "background";
-    readonly defaultOptions: {
-      readonly background_color: "Black";
-      readonly output_container_and_codec: "webm_vp9";
-      readonly preserve_audio: true;
-    };
-    readonly description: "Remove video backgrounds with configurable output container.";
-    readonly endpoint: "bria/video/background-removal";
-    readonly inputField: "video_url";
-    readonly inputKind: "video";
-    readonly name: "Bria Video Background Removal";
-    readonly outputKeys: ["video"];
-    readonly price: {
-      readonly kind: "second";
-      readonly usd: 0.00425;
-    };
-    readonly pricing: "$0.00425/sec";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
-    readonly task: "video background removal";
-  };
-  readonly ddcolor: {
-    readonly category: "restoration";
-    readonly description: "Colourise black-and-white photographs.";
-    readonly endpoint: "fal-ai/ddcolor";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "DDColor Colourisation";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.001;
-    };
-    readonly pricing: "$0.001/megapixel";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/ddcolor";
-    readonly task: "photo colourisation";
-  };
-  readonly rembg: {
-    readonly category: "background";
-    readonly defaultOptions: {
-      readonly crop_to_bbox: false;
-    };
-    readonly description: "Generic image background removal utility.";
-    readonly endpoint: "fal-ai/imageutils/rembg";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Remove Background";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-    readonly task: "image background removal";
-  };
-  readonly "seedvr-upscale": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Diffusion image restoration and upscaling with SeedVR.";
-    readonly endpoint: "fal-ai/seedvr/upscale/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SeedVR Image Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.001;
-    };
-    readonly pricing: "$0.001/megapixel";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image";
-    readonly task: "image restoration and upscaling";
-  };
-  readonly "topaz-adjust": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz exposure, white balance, and colour adjustment.";
-    readonly endpoint: "topaz/adjust/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Adjust";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 per 24 output megapixels";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/adjust/image";
-    readonly task: "tonal adjustment";
-  };
-  readonly "topaz-creative": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz Bloom upscaling, which reimagines detail rather than preserving it.";
-    readonly endpoint: "topaz/upscale/image/creative";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Creative Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.96 per 24 output megapixels";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative";
-    readonly task: "creative image upscaling";
-  };
-  readonly "topaz-denoise": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz noise reduction at source resolution.";
-    readonly endpoint: "topaz/denoise/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Denoise";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/denoise/image";
-    readonly task: "image denoising";
-  };
-  readonly "topaz-generative": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz Wonder upscaling, which synthesises plausible detail as it enlarges.";
-    readonly endpoint: "topaz/upscale/image/generative";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Generative Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative";
-    readonly task: "generative image upscaling";
-  };
-  readonly "topaz-image": {
-    readonly category: "upscale";
-    readonly defaultOptions: {
-      readonly model: "Standard V2";
-      readonly output_format: "jpeg";
-      readonly upscale_factor: 2;
-    };
-    readonly description: "Professional Topaz image enhancement and upscaling.";
-    readonly endpoint: "fal-ai/topaz/upscale/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Image Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-    readonly task: "image enhancement";
-  };
-  readonly "topaz-precision": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz upscaling that preserves the original detail rather than inventing it.";
-    readonly endpoint: "topaz/upscale/image/precision";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Precision Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 per 24 output megapixels, any precision model";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/precision";
-    readonly task: "faithful image upscaling";
-  };
-  readonly "topaz-restore": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz restoration of damaged or degraded photographs at source resolution.";
-    readonly endpoint: "topaz/restore/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Restore";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/restore/image";
-    readonly task: "photo restoration";
-  };
-  readonly "topaz-sharpen": {
-    readonly category: "restoration";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Topaz deblurring and sharpening at source resolution.";
-    readonly endpoint: "topaz/sharpen/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Sharpen";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/sharpen/image";
-    readonly task: "image sharpening";
-  };
-  readonly "topaz-transparent": {
-    readonly category: "restoration";
-    readonly description: "Topaz upscaling that preserves the alpha channel end to end.";
-    readonly endpoint: "topaz/upscale/image/transparent";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Topaz Transparent Upscale";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: number;
-    };
-    readonly pricing: "$0.08 per 24 output megapixels";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/transparent";
-    readonly task: "transparent image upscaling";
-  };
-  readonly "topaz-video": {
-    readonly category: "upscale";
-    readonly defaultOptions: {
-      readonly model: "Proteus";
-      readonly upscale_factor: 2;
-    };
-    readonly description: "Professional Topaz video enhancement and upscaling.";
-    readonly endpoint: "fal-ai/topaz/upscale/video";
-    readonly inputField: "video_url";
-    readonly inputKind: "video";
-    readonly name: "Topaz Video Upscale";
-    readonly outputKeys: ["video"];
-    readonly price: {
-      readonly kind: "second";
-      readonly usd: 0.01;
-    };
-    readonly pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-    readonly task: "video enhancement";
-  };
-  readonly "bria-eraser": {
-    readonly category: "erase";
-    readonly description: "Commercial-safe removal of a masked region, inpainted from surrounding context.";
-    readonly endpoint: "fal-ai/bria/eraser";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Bria Eraser";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.04;
-    };
-    readonly pricing: "$0.04/generation";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/eraser";
-    readonly task: "masked object erasure";
-  };
-  readonly "bria-expand": {
-    readonly category: "reframe";
-    readonly description: "Expand an image onto a larger canvas, generating the new border area.";
-    readonly endpoint: "fal-ai/bria/expand";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Bria Image Expansion";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.04;
-    };
-    readonly pricing: "$0.04/generation";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/expand";
-    readonly task: "image outpainting";
-  };
-  readonly "bria-genfill": {
-    readonly category: "erase";
-    readonly description: "Generative fill of a masked region from a prompt, commercial-safe.";
-    readonly endpoint: "fal-ai/bria/genfill";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Bria GenFill";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.04;
-    };
-    readonly pricing: "$0.04/generation";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/genfill";
-    readonly task: "masked generative fill";
-  };
-  readonly "finegrain-eraser": {
-    readonly category: "erase";
-    readonly description: "Remove a prompted object and its shadows and reflections, filling the gap.";
-    readonly endpoint: "fal-ai/finegrain-eraser";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Finegrain Object Eraser";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.27;
-    };
-    readonly pricing: "$0.27/image at the default standard mode; $0.18 express, $0.36 premium";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/finegrain-eraser";
-    readonly task: "prompted object erasure";
-  };
-  readonly "flux-outpaint": {
-    readonly category: "reframe";
-    readonly description: "Outpaint an image by a per-edge pixel expansion with FLUX.2 pro.";
-    readonly endpoint: "fal-ai/flux-2-pro/outpaint";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "FLUX.2 Pro Outpaint";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.03 for the first output megapixel, then $0.015 per extra megapixel of input and output, rounded up";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/flux-2-pro/outpaint";
-    readonly task: "image outpainting";
-  };
-  readonly "iclight-v2": {
-    readonly category: "relight";
-    readonly description: "Relight a subject from a prompt, harmonising it with a new light direction.";
-    readonly endpoint: "fal-ai/iclight-v2";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "IC-Light v2";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.1;
-    };
-    readonly pricing: "$0.10/megapixel";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/iclight-v2";
-    readonly task: "prompted relighting";
-  };
-  readonly "ideogram-reframe": {
-    readonly category: "reframe";
-    readonly description: "Reframe an image to a new aspect ratio, generating the fill.";
-    readonly endpoint: "fal-ai/ideogram/v3/reframe";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Ideogram v3 Reframe";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.06;
-    };
-    readonly pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/reframe";
-    readonly task: "aspect ratio reframing";
-  };
-  readonly "lighting-restoration": {
-    readonly category: "relight";
-    readonly description: "Restore natural, even lighting across one or more input images.";
-    readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
-    readonly inputField: "image_urls";
-    readonly inputKind: "images";
-    readonly name: "Qwen Lighting Restoration";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.035;
-    };
-    readonly pricing: "$0.035/megapixel";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration";
-    readonly task: "lighting restoration";
-  };
-  readonly "object-removal": {
-    readonly category: "erase";
-    readonly description: "Remove a prompted object from an image and fill the gap.";
-    readonly endpoint: "fal-ai/object-removal";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Object Removal";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.024;
-    };
-    readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal";
-    readonly task: "prompted object removal";
-  };
-  readonly "object-removal-bbox": {
-    readonly category: "erase";
-    readonly description: "Remove whatever falls inside supplied bounding boxes.";
-    readonly endpoint: "fal-ai/object-removal/bbox";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Object Removal by Box";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.024;
-    };
-    readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox";
-    readonly task: "bounding box object removal";
-  };
-  readonly "object-removal-mask": {
-    readonly category: "erase";
-    readonly description: "Remove the masked region of an image and fill the gap.";
-    readonly endpoint: "fal-ai/object-removal/mask";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Object Removal by Mask";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.024;
-    };
-    readonly pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask";
-    readonly task: "masked object removal";
-  };
-  readonly "remove-lighting": {
-    readonly category: "relight";
-    readonly description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.";
-    readonly endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
-    readonly inputField: "image_urls";
-    readonly inputKind: "images";
-    readonly name: "Qwen Remove Lighting";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "megapixel";
-      readonly usd: 0.035;
-    };
-    readonly pricing: "$0.035/megapixel";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting";
-    readonly task: "lighting removal";
-  };
-  readonly "smart-resize": {
-    readonly category: "reframe";
-    readonly description: "Resize one image to several target sizes, recomposing rather than cropping.";
-    readonly endpoint: "fal-ai/smart-resize";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Smart Resize";
-    readonly outputKeys: ["images", "results"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/smart-resize";
-    readonly task: "multi-size recomposition";
-  };
-  readonly "text-removal": {
-    readonly category: "erase";
-    readonly defaultOptions: {
-      readonly output_format: "png";
-    };
-    readonly description: "Remove all rendered text from an image, rebuilding what sat behind it.";
-    readonly endpoint: "fal-ai/image-editing/text-removal";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Text Removal";
-    readonly outputKeys: ["images"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.04;
-    };
-    readonly pricing: "$0.04/image";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal";
-    readonly task: "text removal";
-  };
-  readonly "depth-anything": {
-    readonly category: "preprocess";
-    readonly description: "Generate Depth Anything v2 depth maps from input images.";
-    readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Depth Anything v2 Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
-    readonly task: "depth preprocessing";
-  };
-  readonly dwpose: {
-    readonly category: "preprocess";
-    readonly description: "Extract body, hand, and face pose skeletons from an image.";
-    readonly endpoint: "fal-ai/dwpose";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "DWPose Estimation";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "second";
-      readonly usd: 0.0006;
-    };
-    readonly pricing: "$0.0006/compute-second";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/dwpose";
-    readonly task: "pose preprocessing";
-  };
-  readonly hed: {
-    readonly category: "preprocess";
-    readonly description: "Generate HED soft edge maps for ControlNet-style workflows.";
-    readonly endpoint: "fal-ai/image-preprocessors/hed";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "HED Edge Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed";
-    readonly task: "edge preprocessing";
-  };
-  readonly lineart: {
-    readonly category: "preprocess";
-    readonly defaultOptions: {
-      readonly coarse: false;
-    };
-    readonly description: "Generate line art/control-style edges from an input image.";
-    readonly endpoint: "fal-ai/image-preprocessors/lineart";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Line Art Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
-    readonly task: "image preprocessing";
-  };
-  readonly "marigold-depth": {
-    readonly category: "depth";
-    readonly defaultOptions: {
-      readonly ensemble_size: 10;
-      readonly num_inference_steps: 10;
-    };
-    readonly description: "Create depth maps using Marigold depth estimation.";
-    readonly endpoint: "fal-ai/imageutils/marigold-depth";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Marigold Depth Estimation";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-    readonly task: "depth map";
-  };
-  readonly "midas-depth": {
-    readonly category: "depth";
-    readonly defaultOptions: {
-      readonly a: number;
-      readonly bg_th: 0.1;
-    };
-    readonly description: "Create MiDaS depth maps from input images.";
-    readonly endpoint: "fal-ai/imageutils/depth";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "MiDaS Depth Estimation";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-    readonly task: "depth map";
-  };
-  readonly "midas-preprocessor": {
-    readonly category: "preprocess";
-    readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-    readonly endpoint: "fal-ai/image-preprocessors/midas";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "MiDaS Preprocessor";
-    readonly outputKeys: ["depth_map", "normal_map"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas";
-    readonly task: "depth and normal preprocessing";
-  };
-  readonly mlsd: {
-    readonly category: "preprocess";
-    readonly description: "Detect straight line segments for architectural and interior control maps.";
-    readonly endpoint: "fal-ai/image-preprocessors/mlsd";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "M-LSD Line Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd";
-    readonly task: "line segment preprocessing";
-  };
-  readonly pidi: {
-    readonly category: "preprocess";
-    readonly description: "Generate PiDiNet soft edge maps from an input image.";
-    readonly endpoint: "fal-ai/image-preprocessors/pidi";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "PiDiNet Edge Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi";
-    readonly task: "edge preprocessing";
-  };
-  readonly "sam-preprocessor": {
-    readonly category: "preprocess";
-    readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-    readonly endpoint: "fal-ai/image-preprocessors/sam";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
-    readonly task: "segmentation preprocessing";
-  };
-  readonly "sam2-auto": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly min_mask_region_area: 100;
-      readonly output_format: "png";
-      readonly points_per_side: 32;
-      readonly pred_iou_thresh: 0.88;
-      readonly stability_score_thresh: 0.95;
-    };
-    readonly description: "Automatically segment an image into combined and individual masks.";
-    readonly endpoint: "fal-ai/sam2/auto-segment";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 2 Auto Segment";
-    readonly outputKeys: ["combined_mask", "individual_masks"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
-    readonly task: "automatic image segmentation";
-  };
-  readonly "sam3-1-image": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly max_masks: 3;
-      readonly output_format: "png";
-    };
-    readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-    readonly endpoint: "fal-ai/sam-3-1/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3.1 Image";
-    readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.01;
-    };
-    readonly pricing: "$0.01/request";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-    readonly task: "promptable image segmentation";
-  };
-  readonly "sam3-1-video": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly prompt: "person";
-    };
-    readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
-    readonly endpoint: "fal-ai/sam-3-1/video";
-    readonly inputField: "video_url";
-    readonly inputKind: "video";
-    readonly name: "SAM 3.1 Video";
-    readonly outputKeys: ["video", "boundingbox_frames_zip"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.01/16 frames of video input";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
-    readonly task: "multi-object video segmentation";
-  };
-  readonly "sam3-image": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly max_masks: 3;
-      readonly output_format: "png";
-    };
-    readonly description: "Segment image objects with text, point, or box prompts.";
-    readonly endpoint: "fal-ai/sam-3/image";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3 Image";
-    readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.005;
-    };
-    readonly pricing: "$0.005/request";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
-    readonly task: "promptable image segmentation";
-  };
-  readonly "sam3-image-rle": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly max_masks: 3;
-    };
-    readonly description: "Segment image objects and return run-length encoded masks.";
-    readonly endpoint: "fal-ai/sam-3/image-rle";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "SAM 3 Image RLE";
-    readonly outputKeys: ["rle", "scores", "boxes", "metadata"];
-    readonly price: {
-      readonly kind: "call";
-      readonly usd: 0.005;
-    };
-    readonly pricing: "$0.005/request";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle";
-    readonly task: "promptable image segmentation to RLE";
-  };
-  readonly "sam3-video": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly detection_threshold: 0.5;
-      readonly prompt: "person";
-      readonly video_output_type: "X264 (.mp4)";
-    };
-    readonly description: "Segment and track prompted objects across video frames.";
-    readonly endpoint: "fal-ai/sam-3/video";
-    readonly inputField: "video_url";
-    readonly inputKind: "video";
-    readonly name: "SAM 3 Video";
-    readonly outputKeys: ["video", "boundingbox_frames_zip"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.005/16 frames of video input";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
-    readonly task: "promptable video segmentation";
-  };
-  readonly "sam3-video-rle": {
-    readonly category: "segmentation";
-    readonly defaultOptions: {
-      readonly apply_mask: true;
-      readonly detection_threshold: 0.5;
-      readonly prompt: "person";
-    };
-    readonly description: "Track prompted video objects and return RLE mask data.";
-    readonly endpoint: "fal-ai/sam-3/video-rle";
-    readonly inputField: "video_url";
-    readonly inputKind: "video";
-    readonly name: "SAM 3 Video RLE";
-    readonly outputKeys: ["video", "boundingbox_frames_zip"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0.005/16 frames of video";
-    readonly queued: true;
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
-    readonly task: "promptable video segmentation to RLE";
-  };
-  readonly scribble: {
-    readonly category: "preprocess";
-    readonly description: "Turn an image into a scribble-style control map.";
-    readonly endpoint: "fal-ai/image-preprocessors/scribble";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "Scribble Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble";
-    readonly task: "scribble preprocessing";
-  };
-  readonly teed: {
-    readonly category: "preprocess";
-    readonly description: "Generate TEED edge maps from an input image.";
-    readonly endpoint: "fal-ai/image-preprocessors/teed";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "TEED Edge Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed";
-    readonly task: "edge preprocessing";
-  };
-  readonly "zoe-depth": {
-    readonly category: "preprocess";
-    readonly description: "Generate ZoeDepth metric depth maps from an input image.";
-    readonly endpoint: "fal-ai/image-preprocessors/zoe";
-    readonly inputField: "image_url";
-    readonly inputKind: "image";
-    readonly name: "ZoeDepth Preprocessor";
-    readonly outputKeys: ["image"];
-    readonly price: {
-      readonly kind: "metered";
-    };
-    readonly pricing: "$0/compute-second listed by fal";
-    readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
-    readonly task: "depth preprocessing";
-  };
-};
-export declare const FAL_TOOLS_CHECKED_AT = "2026-08-23";
-export declare const FAL_TOOL_IDS: (keyof typeof FAL_TOOLS)[];
-type FalToolId = (typeof FAL_TOOL_IDS)[number];
-export declare function isFalToolId(tool: string): tool is FalToolId;
-export declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
+/** The profile for a Model id, or undefined when no registry knows it. */
+export declare function modelProfile(model: string): ModelProfile | undefined;
+/**
+ * Choose the Model for a Task. Pure: no I/O, and the prompt is never read.
+ *
+ * `request.look` must already be a valid Look id; an unknown one is treated as
+ * no Look, because Look validation belongs to the creative layer.
+ */
+export declare function resolveTask(task: TaskId, request: TaskRequest, environment: TaskEnvironment): TaskResolution;
+/**
+ * Whether the Tier changes the Model for this Task and request. False for a
+ * Task with one qualifying Model, so `--describe` can say the Tier changes
+ * nothing there.
+ */
+export declare function tierChangesChoice(task: TaskId, request: Omit<TaskRequest, "tier">, environment: TaskEnvironment): boolean;
 //#endregion
 //#region src/tool-cost.d.ts
 /** Pixel dimensions of one file an endpoint returned. */
@@ -3258,6 +1063,14 @@ interface OutputDimensions {
   height?: number;
   width?: number;
 }
+/** What a caller knows of a source video before a run, read from its header. */
+interface SourceVideo {
+  fps?: number;
+  frames?: number;
+  height?: number;
+  seconds: 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. */
@@ -3269,22 +1082,6 @@ interface ResolvedCost {
    */
   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.
- */
-export 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.
- */
-export 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.
@@ -3302,61 +1099,205 @@ export declare function sumCosts(costs: readonly (number | null)[]): {
   unknown: number;
 };
 //#endregion
-//#region src/tool-parameters.generated.d.ts
-/** One argument an endpoint accepts. */
-interface FalToolParameter {
-  /** Argument name, exactly as fal expects it in the request body. */
+//#region src/task-client.d.ts
+interface MotifClientConfig {
+  /** Falls back to FAL_KEY. */
+  falKey?: string;
+  /** Falls back to OPENAI_API_KEY. Used only by Models routed through OpenAI. */
+  openAiKey?: string;
+  /** Models pinned per Task, as `resolveTask` takes them. */
+  pins?: TaskEnvironment["pins"];
+  /** The one network seam. Defaults to global fetch. Retries and timeouts still apply. */
+  fetch?: FalFetch;
+  timeout?: number;
+  retries?: number;
+}
+interface TaskInput {
+  /** Source image: https URL or data URL. */
+  image?: string;
+  /**
+   * Boxes to act on, in whole pixels of the source image. A Model that takes
+   * fractions gets them converted using the source's size.
+   */
+  boxes?: readonly {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }[];
+  /**
+   * The source image's pixel size, needed to convert `boxes` for a Model that
+   * takes fractions when `image` is an https URL. Read from a data URL itself.
+   */
+  sourceSize?: {
+    width: number;
+    height: number;
+  };
+  /**
+   * The source video's length, frame count, size and frame rate, read from
+   * its header by the caller. Per-second and per-frame Models price from it;
+   * without it their projected cost is unknown.
+   */
+  sourceVideo?: SourceVideo;
+  /** reframe `margin` mode: pixels to add on each edge. */
+  margin?: {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+  };
+  /** Source video: https URL. */
+  video?: string;
+  prompt?: string;
+  /** Mask image: https URL or data URL. */
+  mask?: string;
+  /** Reference images: https URLs or data URLs. restyle and try-on take exactly one. */
+  references?: readonly string[];
+  aspect?: AspectRatio;
+  resolution?: Resolution;
+  count?: number;
+  seed?: number;
+  negativePrompt?: string;
+  outputFormat?: ImageOutputFormat;
+  transparent?: boolean;
+  /** Upscale factor. */
+  scale?: number;
+  /** reframe `sizes` mode: target sizes. */
+  sizes?: readonly CustomImageSize[];
+  /** animate: seconds. */
+  duration?: number;
+  /** mesh: rig the mesh for animation. */
+  rig?: boolean;
+  look?: string;
+  mood?: string;
+  tier?: Tier;
+  model?: string;
+  mode?: string;
+  /** Model-only fal body fields, sent as given. Requires `model`. */
+  params?: Readonly<Record<string, unknown>>;
+  /** Ask fal not to store IO payloads. */
+  ephemeral?: boolean;
+  onProgress?: (status: string, queuePosition?: number) => void;
+}
+interface TaskFile {
+  /** Output key the URL came from, e.g. "image", "masks", "model_glb". */
   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;
+  url: string;
+  /** Semantic name from the registry's outputLabels, when one applies. */
+  label?: string;
 }
-export declare const FAL_TOOL_PARAMETERS: Record<string, readonly FalToolParameter[]>;
-/** Arguments a tool accepts, including ones Motif does not surface as flags. */
-export declare function falToolParameters(tool: string): readonly FalToolParameter[];
-//#endregion
-//#region src/model-output.generated.d.ts
-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;
+interface TaskPlan {
+  task: TaskId;
+  model: string;
+  tier: Tier;
+  chosenBy: ChosenBy;
+  mode?: string;
+  endpoint: string;
+  /** Request body as it will be sent. */
+  body: Record<string, unknown>;
+  /** Prompt after Look and Mood enrichment, when the Task takes one. */
+  prompt?: string;
+  queued: boolean;
+  /** Projected: before the call. */
+  cost: ResolvedCost;
+  /** The provider carrying the request. "openai" only for a transparency route. */
+  provider: "fal" | "openai";
+}
+interface TaskOutput extends Omit<TaskPlan, "body" | "cost" | "queued"> {
+  files: TaskFile[];
+  /** Non-file result fields: answer, reasoning, boxes, scores, points, rle, text... */
+  data: Record<string, unknown>;
+  /** Measured where the rate allows, else projected or unknown. */
+  cost: ResolvedCost;
+  requestId?: string;
+  /** Raw provider response, for callers that need a field we don't lift. */
+  raw: Record<string, unknown>;
 }
-export declare const MODEL_OUTPUT: Record<string, ModelOutputShape>;
+interface PlanOptions {
+  /** Resolve as if FAL_KEY were set, so a dry run can price without a key. */
+  dryRun?: boolean;
+}
+type TaskFunction = (input: TaskInput) => Promise<Result$1<TaskOutput, MotifError>>;
+interface MotifClient {
+  /** Pure: resolve the Model, build the request, price it. No I/O. */
+  plan: (task: TaskId, input: TaskInput, options?: PlanOptions) => Result$1<TaskPlan, MotifError>;
+  run: (task: TaskId, input: TaskInput) => Promise<Result$1<TaskOutput, MotifError>>;
+  animate: TaskFunction;
+  ask: TaskFunction;
+  cutout: TaskFunction;
+  erase: TaskFunction;
+  generate: TaskFunction;
+  layers: TaskFunction;
+  map: TaskFunction;
+  material: TaskFunction;
+  mesh: TaskFunction;
+  reframe: TaskFunction;
+  relight: TaskFunction;
+  restore: TaskFunction;
+  restyle: TaskFunction;
+  segment: TaskFunction;
+  tile: TaskFunction;
+  "try-on": TaskFunction;
+  upscale: TaskFunction;
+  vary: TaskFunction;
+  vectorize: TaskFunction;
+  /** Upload bytes to fal storage; returns the public URL. */
+  upload: (bytes: Uint8Array, contentType: string, fileName?: string) => Promise<Result$1<string, MotifError>>;
+  deletePayloads: (requestId: string) => Promise<Result$1<void, MotifError>>;
+}
+/** Create the Task client. Keys fall back to FAL_KEY and OPENAI_API_KEY. */
+export declare function createMotif(config?: MotifClientConfig): MotifClient;
 //#endregion
-//#region src/model-output.d.ts
-/** 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. */
-export declare function modelOutput(model: string): ModelOutputShape | undefined;
+//#region src/task-plan-shared.d.ts
+export declare const INVALID_OPTION = "INVALID_OPTION";
+//#endregion
+//#region src/prompt-warnings.d.ts
 /**
- * Whether this model can produce a lossless file at all.
+ * Advisory checks on a user-written prompt.
  *
- * The question a caller actually has, answered from the measured default and
- * the accepted arguments together.
+ * These run on the caller's own prompt only, never on look or mood text, and
+ * never block a request. They flag phrasings that image models tend to
+ * misread.
  */
-export declare function losslessAvailability(model: string): LosslessAvailability;
+/** Stable id of a prompt warning rule. */
+type PromptWarningRule = "edit-has-verb" | "negated-object" | "text-bearing-object";
+/** One advisory finding about a prompt. */
+interface PromptWarning {
+  /** The text in the prompt that triggered the rule. */
+  match: string;
+  /** Plain-English advice for the caller. */
+  message: string;
+  rule: PromptWarningRule;
+}
 /**
- * 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"`.
+ * Check a user prompt for phrasings that tend to backfire.
+ *
+ * - `negated-object`: "no <object>" for anything other than text, logos,
+ *   people, faces, watermarks, words or lettering. Naming an object tends to
+ *   draw it into the picture.
+ * - `text-bearing-object`: the prompt asks for no text or no words but also
+ *   names something that usually carries text, such as a sign or a poster.
+ * - `edit-has-verb`: an edit (`context.editing`) whose prompt starts with
+ *   remove, erase, extend or outpaint, jobs the CLI has a verb for.
+ *
+ * Pass the caller's own prompt, not an enriched one, and `editing: true` when
+ * the request carries reference images to edit.
  */
-export declare function describeModelOutput(model: string): string;
+export declare function promptWarnings(prompt: string, context?: {
+  editing?: boolean;
+}): PromptWarning[];
+//#endregion
+//#region src/env.d.ts
+export declare const motifEnvSchema: import("@howells/envy").EnvSchema<{
+  readonly optional: {
+    FAL_KEY: z.ZodString;
+    OPENAI_API_KEY: z.ZodString;
+  };
+}>;
+type MotifEnv = ReturnType<typeof motifEnvSchema.parse>;
+export declare function parseMotifEnv(input?: Record<string, unknown>): MotifEnv;
+export declare function getFalKeyFromEnv(input?: Record<string, unknown>): string | undefined;
+/** The OpenAI key, used by direct OpenAI routes such as gpt2 transparency. */
+export declare function getOpenAiKeyFromEnv(input?: Record<string, unknown>): string | undefined;
 //#endregion
-export { type AspectRatio, type BackgroundMode, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolParameter, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, type GenerateOptions, type GenerationModelName, type GptImageSize, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, type LosslessAvailability, type ModelConfig, type ModelOutputShape, type ModelType, type MotifEnv, type MotifImage, type MotifResponse, type OutputDimensions, type QueuedJob, type QueuedToolJob, type RemoveBackgroundOptions, type Resolution, type ResolvedCost, type Result, type ResultAsync, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, type UpscaleOptions, type VideoOptions, type VideoResponse, err, ok };
+export { type AspectRatio, type Blocker, type Capability, type ChosenBy, type CreativeDirection, type CreativeField, type CreativeOption, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, type EnrichPromptOptions, type FalFetch, type ImageSizeBounds, type LookId, type LookOption, type ModelProfile, type MoodId, type MotifClient, type MotifClientConfig, type MotifEnv, type OutputDimensions, type PlanOptions, type PromptWarning, type PromptWarningRule, type RankedFrom, type RankedModel, type Resolution, type ResolvedCost, type Result, type ResultAsync, type TaskDefinition, type TaskEnvironment, type TaskFile, type TaskFunction, type TaskId, type TaskInput, type TaskMode, type TaskOutput, type TaskPlan, type TaskRequest, type TaskResolution, type TaskResolved, type TaskUnresolved, type Tier, type Unblocker, err, ok };