@howells/motif-sdk 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -57,30 +57,6 @@ declare const CREATIVE_FIELDS: readonly ["recipe", "shot", "lighting", "genre",
  * exact prompt clause that will be appended when selected.
  */
 declare const CREATIVE_TAXONOMY: {
-    readonly recipe: readonly [{
-        readonly clause: "cinematic scene";
-        readonly description: "Frames the prompt as a cinematic still or scene.";
-        readonly id: "cinematic";
-        readonly label: "Cinematic";
-    }];
-    readonly shot: readonly [{
-        readonly clause: "close-up composition with controlled depth of field";
-        readonly description: "Tight framing that emphasizes subject detail.";
-        readonly id: "close-up";
-        readonly label: "Close-up";
-    }];
-    readonly lighting: readonly [{
-        readonly clause: "rim lighting with defined edge highlights";
-        readonly description: "Back or side light that separates the subject edge.";
-        readonly id: "rim";
-        readonly label: "Rim";
-    }];
-    readonly genre: readonly [{
-        readonly clause: "film noir mood with high contrast shadows";
-        readonly description: "High-contrast cinematic mood with shadow-forward drama.";
-        readonly id: "film-noir";
-        readonly label: "Film noir";
-    }];
     readonly camera: readonly [{
         readonly clause: "macro product photography with crisp surface detail";
         readonly description: "Product-oriented macro camera language for close detail.";
@@ -93,6 +69,18 @@ declare const CREATIVE_TAXONOMY: {
         readonly id: "monochrome";
         readonly label: "Monochrome";
     }];
+    readonly genre: readonly [{
+        readonly clause: "film noir mood with high contrast shadows";
+        readonly description: "High-contrast cinematic mood with shadow-forward drama.";
+        readonly id: "film-noir";
+        readonly label: "Film noir";
+    }];
+    readonly lighting: readonly [{
+        readonly clause: "rim lighting with defined edge highlights";
+        readonly description: "Back or side light that separates the subject edge.";
+        readonly id: "rim";
+        readonly label: "Rim";
+    }];
     readonly material: readonly [{
         readonly clause: "reflective material surfaces with controlled highlights";
         readonly description: "Emphasizes reflections and highlight control on surfaces.";
@@ -105,6 +93,18 @@ declare const CREATIVE_TAXONOMY: {
         readonly id: "still";
         readonly label: "Still";
     }];
+    readonly recipe: readonly [{
+        readonly clause: "cinematic scene";
+        readonly description: "Frames the prompt as a cinematic still or scene.";
+        readonly id: "cinematic";
+        readonly label: "Cinematic";
+    }];
+    readonly shot: readonly [{
+        readonly clause: "close-up composition with controlled depth of field";
+        readonly description: "Tight framing that emphasizes subject detail.";
+        readonly id: "close-up";
+        readonly label: "Close-up";
+    }];
 };
 /** Result of applying creative direction to a base prompt. */
 interface CreativePromptResult {
@@ -150,10 +150,10 @@ type ImageQuality = "auto" | "low" | "medium" | "high";
 type ThinkingLevel = "minimal" | "high";
 type GptImageSize = "auto" | "1024x1024" | "1536x1024" | "1024x1536";
 type FalImageSizePreset = "auto" | "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9";
-type CustomImageSize = {
+interface CustomImageSize {
     height: number;
     width: number;
-};
+}
 type ImageSize = GptImageSize | FalImageSizePreset | CustomImageSize;
 /** How the model accepts image dimensions */
 type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
@@ -380,10 +380,10 @@ interface QueuedJob {
 }
 interface JobStatus {
     error?: string;
-    logs?: Array<{
+    logs?: {
         message: string;
         timestamp: string;
-    }>;
+    }[];
     queuePosition?: number;
     status: "queued" | "processing" | "completed" | "failed";
 }
@@ -559,207 +559,165 @@ declare class MotifServer {
     get utilityModels(): readonly ["clarity", "crystal", "rmbg", "bria"];
     /** Registered fal utility/tool endpoints. */
     get tools(): {
-        readonly nsfw: {
-            readonly name: "NSFW Checker";
-            readonly endpoint: "fal-ai/x-ailab/nsfw";
-            readonly task: "vision moderation";
-            readonly category: "moderation";
-            readonly description: "Predict whether one or more images contain NSFW concepts.";
-            readonly inputKind: "images";
-            readonly inputField: "image_urls";
-            readonly outputKeys: ["has_nsfw_concepts"];
-            readonly pricing: "$0.001/image";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-        };
-        readonly "topaz-image": {
-            readonly name: "Topaz Image Upscale";
-            readonly endpoint: "fal-ai/topaz/upscale/image";
-            readonly task: "image enhancement";
-            readonly category: "upscale";
-            readonly description: "Professional Topaz image enhancement and upscaling.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image"];
-            readonly pricing: "$0.08+ by output megapixels";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-            readonly defaultOptions: {
-                readonly model: "Standard V2";
-                readonly output_format: "jpeg";
-                readonly upscale_factor: 2;
-            };
-        };
-        readonly "topaz-video": {
-            readonly name: "Topaz Video Upscale";
-            readonly endpoint: "fal-ai/topaz/upscale/video";
-            readonly task: "video enhancement";
-            readonly category: "upscale";
-            readonly description: "Professional Topaz video enhancement and upscaling.";
-            readonly inputKind: "video";
-            readonly inputField: "video_url";
-            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 defaultOptions: {
-                readonly model: "Proteus";
-                readonly upscale_factor: 2;
-            };
-        };
-        readonly "bria-rmbg": {
-            readonly name: "Bria RMBG 2.0";
-            readonly endpoint: "fal-ai/bria/background/remove";
-            readonly task: "image background removal";
-            readonly category: "background";
-            readonly description: "Commercial-safe background removal for images.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image"];
-            readonly pricing: "$0.02/image";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
-        };
         readonly birefnet: {
-            readonly name: "BirefNet Background Removal";
-            readonly endpoint: "fal-ai/birefnet/v2";
-            readonly task: "image background removal";
             readonly category: "background";
-            readonly description: "High-resolution dichotomous image segmentation and background removal.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image", "mask_image"];
-            readonly pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
             readonly defaultOptions: {
                 readonly model: "General Use (Light)";
                 readonly operating_resolution: "1024x1024";
                 readonly output_format: "png";
                 readonly refine_foreground: true;
             };
-        };
-        readonly rembg: {
-            readonly name: "Remove Background";
-            readonly endpoint: "fal-ai/imageutils/rembg";
+            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 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: "Generic image background removal utility.";
-            readonly inputKind: "image";
+            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 pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-            readonly defaultOptions: {
-                readonly crop_to_bbox: false;
-            };
+            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 name: "Bria Video Background Removal";
-            readonly endpoint: "bria/video/background-removal";
-            readonly task: "video background removal";
             readonly category: "background";
-            readonly description: "Remove video backgrounds with configurable output container.";
-            readonly inputKind: "video";
-            readonly inputField: "video_url";
-            readonly outputKeys: ["video"];
-            readonly pricing: "$0.14/sec";
-            readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
             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 pricing: "$0.14/sec";
+            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 inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Depth Anything v2 Preprocessor";
+            readonly outputKeys: ["image"];
+            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 lineart: {
-            readonly name: "Line Art Preprocessor";
-            readonly endpoint: "fal-ai/image-preprocessors/lineart";
-            readonly task: "image preprocessing";
             readonly category: "preprocess";
+            readonly defaultOptions: {
+                readonly coarse: false;
+            };
             readonly description: "Generate line art/control-style edges from an input image.";
-            readonly inputKind: "image";
+            readonly endpoint: "fal-ai/image-preprocessors/lineart";
             readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "Line Art Preprocessor";
             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 "marigold-depth": {
+            readonly category: "depth";
             readonly defaultOptions: {
-                readonly coarse: false;
+                readonly ensemble_size: 10;
+                readonly num_inference_steps: 10;
             };
-        };
-        readonly "sam-preprocessor": {
-            readonly name: "SAM Preprocessor";
-            readonly endpoint: "fal-ai/image-preprocessors/sam";
-            readonly task: "segmentation preprocessing";
-            readonly category: "preprocess";
-            readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-            readonly inputKind: "image";
+            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 pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
+            readonly task: "depth map";
         };
         readonly "midas-depth": {
-            readonly name: "MiDaS Depth Estimation";
-            readonly endpoint: "fal-ai/imageutils/depth";
-            readonly task: "depth map";
             readonly category: "depth";
+            readonly defaultOptions: {
+                readonly a: number;
+                readonly bg_th: 0.1;
+            };
             readonly description: "Create MiDaS depth maps from input images.";
-            readonly inputKind: "image";
+            readonly endpoint: "fal-ai/imageutils/depth";
             readonly inputField: "image_url";
+            readonly inputKind: "image";
+            readonly name: "MiDaS Depth Estimation";
             readonly outputKeys: ["image"];
             readonly pricing: "$0/compute-second listed by fal";
             readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-            readonly defaultOptions: {
-                readonly a: number;
-                readonly bg_th: 0.1;
-            };
+            readonly task: "depth map";
         };
         readonly "midas-preprocessor": {
-            readonly name: "MiDaS Preprocessor";
-            readonly endpoint: "fal-ai/image-preprocessors/midas";
-            readonly task: "depth and normal preprocessing";
             readonly category: "preprocess";
             readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-            readonly inputKind: "image";
+            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 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 "marigold-depth": {
-            readonly name: "Marigold Depth Estimation";
-            readonly endpoint: "fal-ai/imageutils/marigold-depth";
-            readonly task: "depth map";
-            readonly category: "depth";
-            readonly description: "Create depth maps using Marigold depth estimation.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image"];
-            readonly pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-            readonly defaultOptions: {
-                readonly ensemble_size: 10;
-                readonly num_inference_steps: 10;
-            };
+        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 "depth-anything": {
-            readonly name: "Depth Anything v2 Preprocessor";
-            readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
-            readonly task: "depth preprocessing";
-            readonly category: "preprocess";
-            readonly description: "Generate Depth Anything v2 depth maps from input images.";
+        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 pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
+            readonly task: "image background removal";
+        };
+        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 pricing: "$0/compute-second listed by fal";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+            readonly task: "segmentation preprocessing";
         };
         readonly "sam2-auto": {
-            readonly name: "SAM 2 Auto Segment";
-            readonly endpoint: "fal-ai/sam2/auto-segment";
-            readonly task: "automatic image segmentation";
             readonly category: "segmentation";
-            readonly description: "Automatically segment an image into combined and individual masks.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            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 defaultOptions: {
                 readonly min_mask_region_area: 100;
                 readonly output_format: "png";
@@ -767,151 +725,193 @@ declare class MotifServer {
                 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 pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
+            readonly task: "automatic image segmentation";
         };
-        readonly "sam3-image": {
-            readonly name: "SAM 3 Image";
-            readonly endpoint: "fal-ai/sam-3/image";
-            readonly task: "promptable image segmentation";
+        readonly "sam3-1-image": {
             readonly category: "segmentation";
-            readonly description: "Segment image objects with text, point, or box prompts.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-            readonly pricing: "$0.005/request";
-            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
             readonly defaultOptions: {
                 readonly apply_mask: true;
                 readonly max_masks: 3;
                 readonly output_format: "png";
             };
-        };
-        readonly "sam3-1-image": {
-            readonly name: "SAM 3.1 Image";
-            readonly endpoint: "fal-ai/sam-3-1/image";
-            readonly task: "promptable image segmentation";
-            readonly category: "segmentation";
             readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-            readonly inputKind: "image";
+            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 pricing: "$0.005/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 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 "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: {
                 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 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 name: "SAM 3 Image RLE";
-            readonly endpoint: "fal-ai/sam-3/image-rle";
-            readonly task: "promptable image segmentation to 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 inputKind: "image";
+            readonly endpoint: "fal-ai/sam-3/image-rle";
             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 defaultOptions: {
-                readonly apply_mask: true;
-                readonly max_masks: 3;
-            };
+            readonly task: "promptable image segmentation to RLE";
         };
         readonly "sam3-video": {
-            readonly name: "SAM 3 Video";
-            readonly endpoint: "fal-ai/sam-3/video";
-            readonly task: "promptable video segmentation";
             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 inputKind: "video";
+            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 "sam3-video-rle": {
+            readonly category: "segmentation";
             readonly defaultOptions: {
                 readonly apply_mask: true;
                 readonly detection_threshold: 0.5;
                 readonly prompt: "person";
-                readonly video_output_type: "X264 (.mp4)";
             };
-        };
-        readonly "sam3-video-rle": {
-            readonly name: "SAM 3 Video RLE";
-            readonly endpoint: "fal-ai/sam-3/video-rle";
-            readonly task: "promptable video segmentation to RLE";
-            readonly category: "segmentation";
             readonly description: "Track prompted video objects and return RLE mask data.";
-            readonly inputKind: "video";
+            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 defaultOptions: {
-                readonly apply_mask: true;
-                readonly detection_threshold: 0.5;
-                readonly prompt: "person";
-            };
+            readonly task: "promptable video segmentation to RLE";
         };
-        readonly "sam3-1-video": {
-            readonly name: "SAM 3.1 Video";
-            readonly endpoint: "fal-ai/sam-3-1/video";
-            readonly task: "multi-object video segmentation";
-            readonly category: "segmentation";
-            readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
-            readonly inputKind: "video";
-            readonly inputField: "video_url";
-            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 "topaz-image": {
+            readonly category: "upscale";
             readonly defaultOptions: {
-                readonly apply_mask: true;
-                readonly prompt: "person";
+                readonly model: "Standard V2";
+                readonly output_format: "jpeg";
+                readonly upscale_factor: 2;
             };
-        };
-        readonly "sam3-3d-objects": {
-            readonly name: "SAM 3D Objects";
-            readonly endpoint: "fal-ai/sam-3/3d-objects";
-            readonly task: "single-image 3D object reconstruction";
-            readonly category: "3d";
-            readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
-            readonly inputKind: "image";
+            readonly description: "Professional Topaz image enhancement and upscaling.";
+            readonly endpoint: "fal-ai/topaz/upscale/image";
             readonly inputField: "image_url";
-            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 defaultOptions: {
-                readonly prompt: "car";
-            };
-        };
-        readonly "sam3-3d-body": {
-            readonly name: "SAM 3D Body";
-            readonly endpoint: "fal-ai/sam-3/3d-body";
-            readonly task: "single-image 3D body reconstruction";
-            readonly category: "3d";
-            readonly description: "Reconstruct human body meshes and keypoints from a single image.";
             readonly inputKind: "image";
-            readonly inputField: "image_url";
-            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 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 "topaz-video": {
+            readonly category: "upscale";
             readonly defaultOptions: {
-                readonly export_meshes: true;
-                readonly include_3d_keypoints: true;
-                readonly include_mhr_params: true;
+                readonly model: "Proteus";
+                readonly upscale_factor: 2;
             };
-        };
-        readonly "sam3-3d-align": {
-            readonly name: "SAM 3D Align";
-            readonly endpoint: "fal-ai/sam-3/3d-align";
-            readonly task: "3D scene alignment";
-            readonly category: "3d";
-            readonly description: "Align SAM 3D objects and bodies into a shared scene.";
-            readonly inputKind: "image";
-            readonly inputField: "image_url";
-            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 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";
         };
     };
     /** ─── Private ─────────────────────────────────────────────── */
@@ -927,7 +927,10 @@ declare class MotifServer {
 declare class MotifError extends Error {
     readonly status: number;
     readonly code?: string;
-    constructor(message: string, status: number, 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";
@@ -956,207 +959,165 @@ interface FalToolRequest {
     tool: FalToolConfig;
 }
 declare const FAL_TOOLS: {
-    readonly nsfw: {
-        readonly name: "NSFW Checker";
-        readonly endpoint: "fal-ai/x-ailab/nsfw";
-        readonly task: "vision moderation";
-        readonly category: "moderation";
-        readonly description: "Predict whether one or more images contain NSFW concepts.";
-        readonly inputKind: "images";
-        readonly inputField: "image_urls";
-        readonly outputKeys: ["has_nsfw_concepts"];
-        readonly pricing: "$0.001/image";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw";
-    };
-    readonly "topaz-image": {
-        readonly name: "Topaz Image Upscale";
-        readonly endpoint: "fal-ai/topaz/upscale/image";
-        readonly task: "image enhancement";
-        readonly category: "upscale";
-        readonly description: "Professional Topaz image enhancement and upscaling.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0.08+ by output megapixels";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image";
-        readonly defaultOptions: {
-            readonly model: "Standard V2";
-            readonly output_format: "jpeg";
-            readonly upscale_factor: 2;
-        };
-    };
-    readonly "topaz-video": {
-        readonly name: "Topaz Video Upscale";
-        readonly endpoint: "fal-ai/topaz/upscale/video";
-        readonly task: "video enhancement";
-        readonly category: "upscale";
-        readonly description: "Professional Topaz video enhancement and upscaling.";
-        readonly inputKind: "video";
-        readonly inputField: "video_url";
-        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 defaultOptions: {
-            readonly model: "Proteus";
-            readonly upscale_factor: 2;
-        };
-    };
-    readonly "bria-rmbg": {
-        readonly name: "Bria RMBG 2.0";
-        readonly endpoint: "fal-ai/bria/background/remove";
-        readonly task: "image background removal";
-        readonly category: "background";
-        readonly description: "Commercial-safe background removal for images.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image"];
-        readonly pricing: "$0.02/image";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove";
-    };
     readonly birefnet: {
-        readonly name: "BirefNet Background Removal";
-        readonly endpoint: "fal-ai/birefnet/v2";
-        readonly task: "image background removal";
         readonly category: "background";
-        readonly description: "High-resolution dichotomous image segmentation and background removal.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image", "mask_image"];
-        readonly pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2";
         readonly defaultOptions: {
             readonly model: "General Use (Light)";
             readonly operating_resolution: "1024x1024";
             readonly output_format: "png";
             readonly refine_foreground: true;
         };
-    };
-    readonly rembg: {
-        readonly name: "Remove Background";
-        readonly endpoint: "fal-ai/imageutils/rembg";
+        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 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: "Generic image background removal utility.";
-        readonly inputKind: "image";
+        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 pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
-        readonly defaultOptions: {
-            readonly crop_to_bbox: false;
-        };
+        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 name: "Bria Video Background Removal";
-        readonly endpoint: "bria/video/background-removal";
-        readonly task: "video background removal";
         readonly category: "background";
-        readonly description: "Remove video backgrounds with configurable output container.";
-        readonly inputKind: "video";
-        readonly inputField: "video_url";
-        readonly outputKeys: ["video"];
-        readonly pricing: "$0.14/sec";
-        readonly sourceUrl: "https://fal.ai/models/bria/video/background-removal";
         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 pricing: "$0.14/sec";
+        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 inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Depth Anything v2 Preprocessor";
+        readonly outputKeys: ["image"];
+        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 lineart: {
-        readonly name: "Line Art Preprocessor";
-        readonly endpoint: "fal-ai/image-preprocessors/lineart";
-        readonly task: "image preprocessing";
         readonly category: "preprocess";
+        readonly defaultOptions: {
+            readonly coarse: false;
+        };
         readonly description: "Generate line art/control-style edges from an input image.";
-        readonly inputKind: "image";
+        readonly endpoint: "fal-ai/image-preprocessors/lineart";
         readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "Line Art Preprocessor";
         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 "marigold-depth": {
+        readonly category: "depth";
         readonly defaultOptions: {
-            readonly coarse: false;
+            readonly ensemble_size: 10;
+            readonly num_inference_steps: 10;
         };
-    };
-    readonly "sam-preprocessor": {
-        readonly name: "SAM Preprocessor";
-        readonly endpoint: "fal-ai/image-preprocessors/sam";
-        readonly task: "segmentation preprocessing";
-        readonly category: "preprocess";
-        readonly description: "Generate a SAM segmentation map for ControlNet-style workflows.";
-        readonly inputKind: "image";
+        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 pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
+        readonly task: "depth map";
     };
     readonly "midas-depth": {
-        readonly name: "MiDaS Depth Estimation";
-        readonly endpoint: "fal-ai/imageutils/depth";
-        readonly task: "depth map";
         readonly category: "depth";
+        readonly defaultOptions: {
+            readonly a: number;
+            readonly bg_th: 0.1;
+        };
         readonly description: "Create MiDaS depth maps from input images.";
-        readonly inputKind: "image";
+        readonly endpoint: "fal-ai/imageutils/depth";
         readonly inputField: "image_url";
+        readonly inputKind: "image";
+        readonly name: "MiDaS Depth Estimation";
         readonly outputKeys: ["image"];
         readonly pricing: "$0/compute-second listed by fal";
         readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth";
-        readonly defaultOptions: {
-            readonly a: number;
-            readonly bg_th: 0.1;
-        };
+        readonly task: "depth map";
     };
     readonly "midas-preprocessor": {
-        readonly name: "MiDaS Preprocessor";
-        readonly endpoint: "fal-ai/image-preprocessors/midas";
-        readonly task: "depth and normal preprocessing";
         readonly category: "preprocess";
         readonly description: "Generate MiDaS depth and normal maps for image workflows.";
-        readonly inputKind: "image";
+        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 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 "marigold-depth": {
-        readonly name: "Marigold Depth Estimation";
-        readonly endpoint: "fal-ai/imageutils/marigold-depth";
-        readonly task: "depth map";
-        readonly category: "depth";
-        readonly description: "Create depth maps using Marigold depth estimation.";
-        readonly inputKind: "image";
+    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 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 pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth";
-        readonly defaultOptions: {
-            readonly ensemble_size: 10;
-            readonly num_inference_steps: 10;
-        };
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg";
+        readonly task: "image background removal";
     };
-    readonly "depth-anything": {
-        readonly name: "Depth Anything v2 Preprocessor";
-        readonly endpoint: "fal-ai/image-preprocessors/depth-anything/v2";
-        readonly task: "depth preprocessing";
+    readonly "sam-preprocessor": {
         readonly category: "preprocess";
-        readonly description: "Generate Depth Anything v2 depth maps from input images.";
-        readonly inputKind: "image";
+        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 pricing: "$0/compute-second listed by fal";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+        readonly task: "segmentation preprocessing";
     };
     readonly "sam2-auto": {
-        readonly name: "SAM 2 Auto Segment";
-        readonly endpoint: "fal-ai/sam2/auto-segment";
-        readonly task: "automatic image segmentation";
         readonly category: "segmentation";
-        readonly description: "Automatically segment an image into combined and individual masks.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        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 defaultOptions: {
             readonly min_mask_region_area: 100;
             readonly output_format: "png";
@@ -1164,155 +1125,197 @@ declare const FAL_TOOLS: {
             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 pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment";
+        readonly task: "automatic image segmentation";
     };
-    readonly "sam3-image": {
-        readonly name: "SAM 3 Image";
-        readonly endpoint: "fal-ai/sam-3/image";
-        readonly task: "promptable image segmentation";
+    readonly "sam3-1-image": {
         readonly category: "segmentation";
-        readonly description: "Segment image objects with text, point, or box prompts.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
-        readonly pricing: "$0.005/request";
-        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image";
         readonly defaultOptions: {
             readonly apply_mask: true;
             readonly max_masks: 3;
             readonly output_format: "png";
         };
-    };
-    readonly "sam3-1-image": {
-        readonly name: "SAM 3.1 Image";
-        readonly endpoint: "fal-ai/sam-3-1/image";
-        readonly task: "promptable image segmentation";
-        readonly category: "segmentation";
         readonly description: "Segment image objects with text, point, or box prompts. SAM 3.1 adds Object Multiplex for faster multi-object tracking.";
-        readonly inputKind: "image";
+        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 pricing: "$0.005/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 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 "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: {
             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 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 name: "SAM 3 Image RLE";
-        readonly endpoint: "fal-ai/sam-3/image-rle";
-        readonly task: "promptable image segmentation to 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 inputKind: "image";
+        readonly endpoint: "fal-ai/sam-3/image-rle";
         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 defaultOptions: {
-            readonly apply_mask: true;
-            readonly max_masks: 3;
-        };
+        readonly task: "promptable image segmentation to RLE";
     };
     readonly "sam3-video": {
-        readonly name: "SAM 3 Video";
-        readonly endpoint: "fal-ai/sam-3/video";
-        readonly task: "promptable video segmentation";
         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 inputKind: "video";
+        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 "sam3-video-rle": {
+        readonly category: "segmentation";
         readonly defaultOptions: {
             readonly apply_mask: true;
             readonly detection_threshold: 0.5;
             readonly prompt: "person";
-            readonly video_output_type: "X264 (.mp4)";
         };
-    };
-    readonly "sam3-video-rle": {
-        readonly name: "SAM 3 Video RLE";
-        readonly endpoint: "fal-ai/sam-3/video-rle";
-        readonly task: "promptable video segmentation to RLE";
-        readonly category: "segmentation";
         readonly description: "Track prompted video objects and return RLE mask data.";
-        readonly inputKind: "video";
+        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 defaultOptions: {
-            readonly apply_mask: true;
-            readonly detection_threshold: 0.5;
-            readonly prompt: "person";
-        };
+        readonly task: "promptable video segmentation to RLE";
     };
-    readonly "sam3-1-video": {
-        readonly name: "SAM 3.1 Video";
-        readonly endpoint: "fal-ai/sam-3-1/video";
-        readonly task: "multi-object video segmentation";
-        readonly category: "segmentation";
-        readonly description: "SAM 3.1 video segmentation with Object Multiplex tracking for multiple objects.";
-        readonly inputKind: "video";
-        readonly inputField: "video_url";
-        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 "topaz-image": {
+        readonly category: "upscale";
         readonly defaultOptions: {
-            readonly apply_mask: true;
-            readonly prompt: "person";
+            readonly model: "Standard V2";
+            readonly output_format: "jpeg";
+            readonly upscale_factor: 2;
         };
-    };
-    readonly "sam3-3d-objects": {
-        readonly name: "SAM 3D Objects";
-        readonly endpoint: "fal-ai/sam-3/3d-objects";
-        readonly task: "single-image 3D object reconstruction";
-        readonly category: "3d";
-        readonly description: "Reconstruct one or more 3D objects from an image and prompts.";
-        readonly inputKind: "image";
+        readonly description: "Professional Topaz image enhancement and upscaling.";
+        readonly endpoint: "fal-ai/topaz/upscale/image";
         readonly inputField: "image_url";
-        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 defaultOptions: {
-            readonly prompt: "car";
-        };
-    };
-    readonly "sam3-3d-body": {
-        readonly name: "SAM 3D Body";
-        readonly endpoint: "fal-ai/sam-3/3d-body";
-        readonly task: "single-image 3D body reconstruction";
-        readonly category: "3d";
-        readonly description: "Reconstruct human body meshes and keypoints from a single image.";
         readonly inputKind: "image";
-        readonly inputField: "image_url";
-        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 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 "topaz-video": {
+        readonly category: "upscale";
         readonly defaultOptions: {
-            readonly export_meshes: true;
-            readonly include_3d_keypoints: true;
-            readonly include_mhr_params: true;
+            readonly model: "Proteus";
+            readonly upscale_factor: 2;
         };
-    };
-    readonly "sam3-3d-align": {
-        readonly name: "SAM 3D Align";
-        readonly endpoint: "fal-ai/sam-3/3d-align";
-        readonly task: "3D scene alignment";
-        readonly category: "3d";
-        readonly description: "Align SAM 3D objects and bodies into a shared scene.";
-        readonly inputKind: "image";
-        readonly inputField: "image_url";
-        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 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";
     };
 };
 declare const FAL_TOOLS_CHECKED_AT = "2026-05-12";
-declare const FAL_TOOL_IDS: Array<keyof typeof FAL_TOOLS>;
+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;