@howells/motif-sdk 1.0.0 → 1.2.0

package/dist/index.d.cts

@@ -387,6 +387,19 @@ interface JobStatus {
     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;
+}
 /** ─── Configuration ──────────────────────────────────────────── */
 interface FalClientConfig {
     apiKey: string;
@@ -463,9 +476,9 @@ declare const VIDEO_TEXT_TO_VIDEO_TOP_15: LeaderboardSnapshot;
 declare const VIDEO_IMAGE_TO_VIDEO_TOP_15: LeaderboardSnapshot;
 
 declare const MODELS: Record<string, ModelConfig>;
-declare const GENERATION_MODELS: readonly ["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"];
+declare const GENERATION_MODELS: readonly ["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). */
-declare const EDIT_CAPABLE_MODELS: ("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")[];
+declare const EDIT_CAPABLE_MODELS: ("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")[];
 declare const UTILITY_MODELS: readonly ["clarity", "crystal", "rmbg", "bria"];
 declare const VIDEO_MODELS: readonly ["kling"];
 type GenerationModelName = (typeof GENERATION_MODELS)[number];
@@ -474,6 +487,23 @@ declare const RECRAFT_STYLES: readonly ["realistic_image", "realistic_image/b_an
 /** Ideogram v3 top-level style categories. Pass as the `style` field in GenerateOptions. */
 declare const IDEOGRAM_STYLES: readonly ["AUTO", "GENERAL", "REALISTIC", "DESIGN"];
 
+/**
+ * `MotifError` and its coercion helper.
+ *
+ * Extracted from `server.ts` so `server-tools.ts` can construct errors without
+ * importing back into `server.ts` — that import was a dependency cycle. Both
+ * `server.ts` and `server-tools.ts` import from here, and `server.ts`
+ * re-exports `MotifError` so the package's public surface is unchanged.
+ */
+declare class MotifError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    /** 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);
+}
+
 /**
  * FalClient — the fal-native client.
  *
@@ -540,6 +570,24 @@ declare class FalClient {
     /** ─── Utilities ───────────────────────────────────────────── */
     /** Run a registered fal utility/tool endpoint. */
     runTool(options: ToolRunOptions): Promise<Result<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<QueuedToolJob, MotifError>>;
+    /** Poll one queued tool run. */
+    checkToolStatus(job: QueuedToolJob): Promise<Result<JobStatus, MotifError>>;
+    /** Fetch the finished payload for a queued tool run. */
+    getToolResult(job: QueuedToolJob): Promise<Result<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<ToolResponse, MotifError>>;
     /**
      * Delete fal's stored IO payloads for a completed request.
      *
@@ -558,69 +606,56 @@ declare class FalClient {
     /** Model registry. */
     get models(): Record<string, ModelConfig>;
     /** Generation model keys. */
-    get generationModels(): readonly ["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"];
+    get generationModels(): readonly ["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 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 "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: "BirefNet Background Removal";
-            readonly outputKeys: ["image", "mask_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/birefnet/v2";
-            readonly task: "image background removal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
+            readonly task: "depth preprocessing";
         };
-        readonly "bria-rmbg": {
-            readonly category: "background";
-            readonly description: "Commercial-safe background removal for images.";
-            readonly endpoint: "fal-ai/bria/background/remove";
+        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: "Bria RMBG 2.0";
+            readonly name: "DWPose Estimation";
             readonly outputKeys: ["image"];
-            readonly pricing: "$0.02/image";
-            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 price: {
+                readonly kind: "second";
+                readonly usd: 0.0006;
             };
-            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 pricing: "$0.14/sec";
-            readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
-            readonly task: "video background removal";
+            readonly pricing: "$0.0006/compute-second";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/dwpose";
+            readonly task: "pose preprocessing";
         };
-        readonly "depth-anything": {
+        readonly hed: {
             readonly category: "preprocess";
-            readonly description: "Generate Depth Anything v2 depth maps from input images.";
-            readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
+            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: "Depth Anything v2 Preprocessor";
+            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/depth-anything/v2";
-            readonly task: "depth preprocessing";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed";
+            readonly task: "edge preprocessing";
         };
         readonly lineart: {
             readonly category: "preprocess";
@@ -633,6 +668,9 @@ declare class FalClient {
             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";
@@ -649,6 +687,9 @@ declare class FalClient {
             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";
@@ -665,6 +706,9 @@ declare class FalClient {
             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";
@@ -677,36 +721,42 @@ declare class FalClient {
             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 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 pricing: "$0.001/image";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-            readonly task: "vision moderation";
-        };
-        readonly rembg: {
-            readonly category: "background";
-            readonly defaultOptions: {
-                readonly crop_to_bbox: false;
+        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 description: "Generic image background removal utility.";
-            readonly endpoint: "fal-ai/imageutils/rembg";
+            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: "Remove Background";
+            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/imageutils/rembg";
-            readonly task: "image background removal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi";
+            readonly task: "edge preprocessing";
         };
         readonly "sam-preprocessor": {
             readonly category: "preprocess";
@@ -716,6 +766,9 @@ declare class FalClient {
             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";
@@ -735,7 +788,11 @@ declare class FalClient {
             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";
         };
@@ -752,7 +809,11 @@ declare class FalClient {
             readonly inputKind: "image";
             readonly name: "SAM 3.1 Image";
             readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-            readonly pricing: "$0.005/request";
+            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";
         };
@@ -768,54 +829,14 @@ declare class FalClient {
             readonly inputKind: "video";
             readonly name: "SAM 3.1 Video";
             readonly outputKeys: ["video", "boundingbox_frames_zip"];
-            readonly pricing: "fal pricing varies by frame count";
+            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-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", "metadata", "artifacts_zip"];
-            readonly pricing: "fal pricing varies by scene";
-            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 pricing: "$0.015/inference";
-            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 pricing: "$0.02/generation";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
-            readonly task: "single-image 3D object reconstruction";
-        };
         readonly "sam3-image": {
             readonly category: "segmentation";
             readonly defaultOptions: {
@@ -829,6 +850,10 @@ declare class FalClient {
             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";
@@ -844,7 +869,11 @@ declare class FalClient {
             readonly inputField: "image_url";
             readonly inputKind: "image";
             readonly name: "SAM 3 Image RLE";
-            readonly outputKeys: ["rle_masks", "metadata", "scores", "boxes"];
+            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";
@@ -863,7 +892,11 @@ declare class FalClient {
             readonly inputKind: "video";
             readonly name: "SAM 3 Video";
             readonly outputKeys: ["video", "boundingbox_frames_zip"];
-            readonly pricing: "$0.005/16 frames";
+            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";
         };
@@ -879,104 +912,1654 @@ declare class FalClient {
             readonly inputField: "video_url";
             readonly inputKind: "video";
             readonly name: "SAM 3 Video RLE";
-            readonly outputKeys: ["rle_masks", "metadata"];
-            readonly pricing: "$0.005/16 frames";
+            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 "topaz-image": {
-            readonly category: "upscale";
-            readonly defaultOptions: {
-                readonly model: "Standard V2";
-                readonly output_format: "jpeg";
-                readonly upscale_factor: 2;
+        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 description: "Professional Topaz image enhancement and upscaling.";
-            readonly endpoint: "fal-ai/topaz/upscale/image";
+            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: "Topaz Image Upscale";
+            readonly name: "TEED Edge Preprocessor";
             readonly outputKeys: ["image"];
-            readonly pricing: "$0.08+ by output megapixels";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-            readonly task: "image enhancement";
+            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 "topaz-video": {
-            readonly category: "upscale";
-            readonly defaultOptions: {
-                readonly model: "Proteus";
-                readonly upscale_factor: 2;
+        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 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 pricing: "$0.01-$0.08/sec by output resolution";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-            readonly task: "video enhancement";
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe";
+            readonly task: "depth preprocessing";
         };
-    };
-    /** ─── 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;
-}
-declare class MotifError extends Error {
-    readonly status: number;
-    readonly code?: string;
-    /** 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);
-}
-
-type FalToolInputKind = "image" | "images" | "video";
-interface FalToolConfig {
-    category: "3d" | "background" | "depth" | "moderation" | "preprocess" | "segmentation" | "upscale";
-    defaultOptions?: Record<string, unknown>;
-    description: string;
-    endpoint: string;
-    inputField: "image_url" | "image_urls" | "video_url";
-    inputKind: FalToolInputKind;
-    name: string;
-    outputKeys: string[];
-    pricing: string;
-    sourceUrl: string;
-    task: string;
-}
-interface FalToolRunOptions {
-    input?: string;
-    inputs?: string[];
-    options?: Record<string, unknown>;
-    tool: string;
-}
-interface FalToolRequest {
-    body: Record<string, unknown>;
-    endpoint: string;
-    tool: FalToolConfig;
-}
-declare const FAL_TOOLS: {
-    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 "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 description: "High-resolution dichotomous image segmentation and background removal.";
-        readonly endpoint: "fal-ai/birefnet/v2";
-        readonly inputField: "image_url";
+        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 "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 "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 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 "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";
+        };
+    };
+    /**
+     * 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;
+}
+
+type FalToolInputKind = "image" | "images" | "video";
+/**
+ * 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.
+ */
+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.
+     *
+     * `fromOption` names the request option that actually determines the order —
+     * read the resolved request body first and use its value when present, since
+     * a caller may reorder or subset it. `fallback` is the endpoint's schema
+     * default, used when the option is absent. Whichever is used, check the label
+     * count against the URL count before applying it: a mislabelled map is worse
+     * than a positional one, because it reads as authoritative.
+     *
+     * Only set this where the order is actually determined — by a request option
+     * or by the schema. Leave genuinely unordered arrays unlabelled.
+     */
+    outputLabels?: Record<string, {
+        fallback: readonly string[];
+        fromOption?: string;
+    }>;
+    price: FalToolPrice;
+    pricing: string;
+    /**
+     * Endpoint routinely exceeds the 120s sync timeout; callers should use the
+     * queue path.
+     */
+    queued?: true;
+    sourceUrl: string;
+    task: string;
+}
+interface FalToolRunOptions {
+    input?: string;
+    inputs?: string[];
+    options?: Record<string, unknown>;
+    tool: string;
+}
+interface FalToolRequest {
+    body: Record<string, unknown>;
+    endpoint: string;
+    tool: FalToolConfig;
+}
+
+declare const FAL_TOOLS: {
+    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";
+    };
+    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 "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";
@@ -989,7 +2572,11 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "Bria RMBG 2.0";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0.02/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";
     };
@@ -1006,171 +2593,410 @@ declare const FAL_TOOLS: {
         readonly inputKind: "video";
         readonly name: "Bria Video Background Removal";
         readonly outputKeys: ["video"];
-        readonly pricing: "$0.14/sec";
+        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 "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 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: "Depth Anything v2 Preprocessor";
+        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/image-preprocessors/depth-anything/v2";
-        readonly task: "depth preprocessing";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
+        readonly task: "image background removal";
     };
-    readonly lineart: {
-        readonly category: "preprocess";
+    readonly "seedvr-upscale": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly coarse: false;
+            readonly output_format: "png";
         };
-        readonly description: "Generate line art/control-style edges from an input image.";
-        readonly endpoint: "fal-ai/image-preprocessors/lineart";
+        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: "Line Art Preprocessor";
+        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 pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart";
-        readonly task: "image preprocessing";
+        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 "marigold-depth": {
-        readonly category: "depth";
+    readonly "topaz-restore": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly ensemble_size: 10;
-            readonly num_inference_steps: 10;
+            readonly output_format: "png";
         };
-        readonly description: "Create depth maps using Marigold depth estimation.";
-        readonly endpoint: "fal-ai/imageutils/marigold-depth";
+        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: "Marigold Depth Estimation";
+        readonly name: "Topaz Restore";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-        readonly task: "depth map";
+        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 "midas-depth": {
-        readonly category: "depth";
+    readonly "topaz-sharpen": {
+        readonly category: "restoration";
         readonly defaultOptions: {
-            readonly a: number;
-            readonly bg_th: 0.1;
+            readonly output_format: "png";
         };
-        readonly description: "Create MiDaS depth maps from input images.";
-        readonly endpoint: "fal-ai/imageutils/depth";
+        readonly description: "Topaz deblurring and sharpening at source resolution.";
+        readonly endpoint: "topaz/sharpen/image";
         readonly inputField: "image_url";
         readonly inputKind: "image";
-        readonly name: "MiDaS Depth Estimation";
+        readonly name: "Topaz Sharpen";
         readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-        readonly task: "depth map";
+        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 "midas-preprocessor": {
-        readonly category: "preprocess";
-        readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-        readonly endpoint: "fal-ai/image-preprocessors/midas";
+    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: "MiDaS Preprocessor";
-        readonly outputKeys: ["depth_map", "normal_map"];
-        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 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 pricing: "$0.001/image";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-        readonly task: "vision moderation";
+        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 rembg: {
-        readonly category: "background";
+    readonly "topaz-video": {
+        readonly category: "upscale";
         readonly defaultOptions: {
-            readonly crop_to_bbox: false;
+            readonly model: "Proteus";
+            readonly upscale_factor: 2;
         };
-        readonly description: "Generic image background removal utility.";
-        readonly endpoint: "fal-ai/imageutils/rembg";
+        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 "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: "Remove Background";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-        readonly task: "image background removal";
+        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 "sam-preprocessor": {
-        readonly category: "preprocess";
-        readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-        readonly endpoint: "fal-ai/image-preprocessors/sam";
+    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: "SAM Preprocessor";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
-        readonly task: "segmentation preprocessing";
+        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 "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 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 description: "Automatically segment an image into combined and individual masks.";
-        readonly endpoint: "fal-ai/sam2/auto-segment";
+        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: "SAM 2 Auto Segment";
-        readonly outputKeys: ["combined_mask", "individual_masks"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
-        readonly task: "automatic image segmentation";
+        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 "sam3-1-image": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-            readonly output_format: "png";
+    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 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 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: "SAM 3.1 Image";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image";
-        readonly task: "promptable image segmentation";
+        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 "sam3-1-video": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly prompt: "person";
+    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 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 pricing: "fal pricing varies by frame count";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video";
-        readonly task: "multi-object video segmentation";
+        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";
@@ -1179,8 +3005,12 @@ declare const FAL_TOOLS: {
         readonly inputField: "image_url";
         readonly inputKind: "image";
         readonly name: "SAM 3D Align";
-        readonly outputKeys: ["scene_glb", "metadata", "artifacts_zip"];
-        readonly pricing: "fal pricing varies by scene";
+        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";
     };
@@ -1197,7 +3027,11 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "SAM 3D Body";
         readonly outputKeys: ["model_glb", "visualization", "meshes", "metadata"];
-        readonly pricing: "$0.015/inference";
+        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";
     };
@@ -1212,116 +3046,160 @@ declare const FAL_TOOLS: {
         readonly inputKind: "image";
         readonly name: "SAM 3D Objects";
         readonly outputKeys: ["gaussian_splat", "model_glb", "metadata", "individual_splats", "individual_glbs", "artifacts_zip"];
-        readonly pricing: "$0.02/generation";
+        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 "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 "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: "SAM 3 Image";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
-        readonly task: "promptable image segmentation";
+        readonly name: "Seedream v5 Pro Layerize";
+        readonly outputKeys: ["layers", "images"];
+        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 "sam3-image-rle": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
+    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 description: "Segment image objects and return run-length encoded masks.";
-        readonly endpoint: "fal-ai/sam-3/image-rle";
+        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: "SAM 3 Image RLE";
-        readonly outputKeys: ["rle_masks", "metadata", "scores", "boxes"];
-        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 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 "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 "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 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 pricing: "$0.005/16 frames";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
-        readonly task: "promptable video segmentation";
+        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 "sam3-video-rle": {
-        readonly category: "segmentation";
-        readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly detection_threshold: 0.5;
-            readonly prompt: "person";
+    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 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: ["rle_masks", "metadata"];
-        readonly pricing: "$0.005/16 frames";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle";
-        readonly task: "promptable video segmentation to RLE";
+        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 "topaz-image": {
-        readonly category: "upscale";
-        readonly defaultOptions: {
-            readonly model: "Standard V2";
-            readonly output_format: "jpeg";
-            readonly upscale_factor: 2;
+    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 description: "Professional Topaz image enhancement and upscaling.";
-        readonly endpoint: "fal-ai/topaz/upscale/image";
+        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: "Topaz Image Upscale";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0.08+ by output megapixels";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-        readonly task: "image enhancement";
+        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 "topaz-video": {
-        readonly category: "upscale";
-        readonly defaultOptions: {
-            readonly model: "Proteus";
-            readonly upscale_factor: 2;
+    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 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 pricing: "$0.01-$0.08/sec by output resolution";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
-        readonly task: "video enhancement";
+        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";
     };
 };
-declare const FAL_TOOLS_CHECKED_AT = "2026-05-12";
+declare const FAL_TOOLS_CHECKED_AT = "2026-08-23";
 declare const FAL_TOOL_IDS: (keyof typeof FAL_TOOLS)[];
 type FalToolId = (typeof FAL_TOOL_IDS)[number];
 declare function isFalToolId(tool: string): tool is FalToolId;
 declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
 
-export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type QueuedJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, enrichPrompt, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv, sanitizePrompt };
+export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, CREATIVE_FIELDS, CREATIVE_TAXONOMY, type CreativeDirection, type CreativeField, type CreativeOption, CreativeOptionError, type CreativeOptionErrorDetails, type CreativePromptResult, type CustomImageSize, EDIT_CAPABLE_MODELS, type EnrichPromptOptions, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, FalClient, type FalClientConfig, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolPrice, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, type QueuedJob, type QueuedToolJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, enrichPrompt, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv, sanitizePrompt };