@howells/motif-sdk 7.1.0 → 7.3.0

package/dist/registry.d.ts

@@ -3,154 +3,6 @@
  * resolution, for callers that show or price Models themselves. Most callers
  * want the Task client from the package root instead.
  */
-/** ─── Model Types ─────────────────────────────────────────────── */
-type AspectRatio = "auto" | "8:1" | "4:1" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16" | "1:4" | "1:8";
-type Resolution = "0.5K" | "1K" | "2K" | "4K";
-type ModelType = "generation" | "utility" | "video";
-/** `gif` is an animation and `svg` a vector image, on the Models that make them. */
-type ImageOutputFormat = "jpeg" | "png" | "webp" | "gif" | "svg";
-type ImageQuality = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
-interface CustomImageSize {
-  height: number;
-  width: number;
-}
-/** Limits an endpoint puts on an exact `{ width, height }` image size. */
-interface ImageSizeBounds {
-  /** Largest width or height over smallest, e.g. 3 for 3:1. */
-  maxRatio?: number;
-  maxEdge?: number;
-  maxPixels?: number;
-  minEdge?: number;
-  minPixels?: number;
-  /** Both edges must be multiples of this. Motif uses 16 when absent. */
-  multipleOf?: number;
-}
-/** How the model accepts image dimensions */
-type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
-type QualityTier = "good" | "better" | "best" | "frontier";
-type SpeedTier = "fast" | "balanced" | "slow" | "very_slow" | "unknown";
-type PriceTier = "budget" | "standard" | "premium" | "ultra" | "variable";
-interface FalPricing {
-  checkedAt: string;
-  currency: "USD";
-  endpointId: string;
-  estimatedCostPerImageUsd?: number;
-  source: "fal-pricing-api";
-  unit: string;
-  unitPrice: number;
-}
-interface LeaderboardMetric {
-  elo: number;
-  rank: number;
-  winRate?: number;
-}
-interface ModelBenchmark {
-  artificialAnalysis?: {
-    editing?: LeaderboardMetric;
-    sourceUrls: string[];
-    snapshotDate: string;
-    textToImage?: LeaderboardMetric;
-  };
-  speed?: {
-    medianSeconds?: number;
-    p95Seconds?: number;
-    source: "artificial-analysis-models";
-  };
-  tiers?: {
-    price: PriceTier;
-    quality: QualityTier;
-    speed: SpeedTier;
-  };
-  useCase?: string;
-}
-interface ModelConfig {
-  benchmark?: ModelBenchmark;
-  /**
-   * The fal endpoint's `image_size` also takes an exact `{ width, height }`,
-   * within these limits read from fal's OpenAPI schema. Absent means only the
-   * named presets are sent. Only meaningful with `sizeMode: "image_size_enum"`.
-   */
-  customImageSize?: ImageSizeBounds;
-  /** Explicit fal streaming support for generation and edit routes. */
-  streaming?: {
-    generation: boolean;
-    edit: boolean;
-  };
-  editEndpoint?: string;
-  editImagesField?: "image_urls" | "image_url";
-  endpoint: string;
-  falPricing?: FalPricing;
-  maxReferenceImages?: number;
-  name: string;
-  pricing: string;
-  /** Null means token-metered with no per-image estimate. */
-  pricePerImageUsd?: number | null;
-  /** How this model accepts dimensions (default: "aspect_ratio") */
-  sizeMode?: SizeMode;
-  supportsAspect: boolean;
-  /**
-   * The aspect ratios fal's `aspect_ratio` enum accepts, where it is narrower
-   * than `ASPECT_RATIOS`. Absent means every ratio is accepted.
-   */
-  supportedAspects?: readonly AspectRatio[];
-  /** The resolutions fal's `resolution` enum accepts, where it is narrower than `RESOLUTIONS`. */
-  supportedResolutions?: readonly Resolution[];
-  supportsBackground?: boolean;
-  supportsEdit: boolean;
-  supportsExpandPrompt?: boolean;
-  supportsGuidanceScale?: boolean;
-  supportsGoogleSearch?: boolean;
-  supportsInferenceSteps?: boolean;
-  supportsLimitGenerations?: boolean;
-  supportsMaskImage?: boolean;
-  maskImageField?: "mask_image_url" | "mask_url";
-  /**
-   * Takes `markup_image_url`: a transparent PNG of annotations (circles,
-   * arrows, notes) the size of the first edit image, guiding its edit.
-   */
-  supportsMarkupImage?: boolean;
-  /**
-   * An edit with no aspect asked for sends `image_size: "auto"`, so the
-   * result keeps the edited image's shape. For Models whose fal edit
-   * endpoint takes `auto`.
-   */
-  autoEditSize?: boolean;
-  supportsNegativePrompt?: boolean;
-  supportsNumImages: boolean;
-  supportsOutputFormat?: boolean;
-  /** Formats the Model returns. Absent means jpeg, png and webp. */
-  supportedOutputFormats?: readonly ImageOutputFormat[];
-  /** Formats an edit returns, where they differ from `supportedOutputFormats`. */
-  supportedEditOutputFormats?: readonly ImageOutputFormat[];
-  supportsQuality?: boolean;
-  /** Default matching the quality variant used in this Model's ranking. */
-  defaultQuality?: ImageQuality;
-  supportedQualities?: readonly ImageQuality[];
-  supportsRenderingSpeed?: boolean;
-  supportsResolution: boolean;
-  supportsSafetyTolerance?: boolean;
-  supportsSafetyChecker?: boolean;
-  supportsSeed?: boolean;
-  supportsSyncMode?: boolean;
-  supportsThinkingLevel?: boolean;
-  supportsWebSearch?: boolean;
-  /**
-   * The endpoint only makes transparent images and takes no `background`
-   * parameter (Ideogram V3 Transparent). Every output has an alpha channel.
-   */
-  transparentOutput?: boolean;
-  type: ModelType;
-  /** Use fal queue submit/status/result even for generate() calls. */
-  useQueue?: boolean;
-}
-/** Pixel sizes of fal's named `image_size` presets. `auto` has none. */
-export declare const FAL_PRESET_SIZES: Readonly<Record<string, CustomImageSize>>;
-/**
- * Estimate cost based on model and settings. `editImages` is the number of
- * input images on an edit, for Models whose edits cost more than generation.
- */
-export declare function estimateCost(model: string, resolution?: Resolution, numImages?: number, editImages?: number): number | null;
-export declare const MODELS: Record<string, ModelConfig>;
 type FalToolInputKind = "image" | "images" | "video";
 /**
  * Machine-readable cost, so `--dry-run` can emit a number rather than the
@@ -229,6 +81,15 @@ type FalToolPrice = {
     usd: number;
   }[];
 } |
+/**
+ * Per second of output video, the body's `duration`. `audioUsd` is the rate
+ * while the body's `generate_audio` is not false, for a Model that makes audio.
+ */
+{
+  kind: "output-second";
+  usd: number;
+  audioUsd?: number;
+} |
 /** `usd` for every started `frames` frames of source video. */
 {
   kind: "frames";
@@ -248,13 +109,26 @@ type FalToolPrice = {
 } | {
   kind: "metered";
 };
+/** The upscale factors an endpoint takes, from its fal OpenAPI schema. */
+interface ScaleRange {
+  max: number;
+  min: number;
+}
 interface FalToolConfig {
   category: "3d" | "analysis" | "background" | "depth" | "erase" | "layers" | "material" | "moderation" | "preprocess" | "reframe" | "relight" | "restoration" | "restyle" | "segmentation" | "try-on" | "upscale" | "vector";
   defaultOptions?: Record<string, unknown>;
   description: string;
   endpoint: string;
+  /** Every output is this many times the source's width and height. */
+  fixedScale?: number;
+  /** `box_prompts` take exactly one box, as fractions (0-1) of the image. */
+  fractionBoxes?: true;
   inputField: "content_image_url" | "image_url" | "image_urls" | "input_image_url" | "input_image_urls" | "person_image_url" | "video_url";
   inputKind: FalToolInputKind;
+  /** Keeps the source's alpha channel end to end, so `transparent` asks for nothing. */
+  keepsAlpha?: true;
+  /** Body key for the Task's mask, on a tool that takes one. */
+  maskField?: "mask_image_url" | "mask_url";
   name: string;
   outputKeys: string[];
   /**
@@ -301,14 +175,203 @@ interface FalToolConfig {
    * a restyle copies, the garment in a try-on. Absent on tools that take none.
    */
   referenceField?: "product_image_url" | "style_image_url";
+  /**
+   * Segments nothing useful without a prompt or a box: fal falls back to a
+   * sample prompt ("wheel", "person"), so the request must name its target.
+   */
+  needsTarget?: true;
+  /**
+   * fal falls back to a sample prompt when none is sent, so the request must
+   * carry one. Says what it must name, e.g. "a prompt naming the objects".
+   */
+  requiredPrompt?: string;
   /**
    * Endpoint routinely exceeds the 120s sync timeout; callers should use the
    * queue path.
    */
   queued?: true;
+  /** Upscale factors the endpoint takes; absent where its schema states no range. */
+  scaleRange?: ScaleRange;
   sourceUrl: string;
   task: string;
 }
+/** ─── Model Types ─────────────────────────────────────────────── */
+type AspectRatio = "auto" | "8:1" | "4:1" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16" | "1:4" | "1:8";
+type Resolution = "0.5K" | "1K" | "2K" | "4K";
+type ModelType = "generation" | "utility" | "video";
+/** `gif` is an animation and `svg` a vector image, on the Models that make them. */
+type ImageOutputFormat = "jpeg" | "png" | "webp" | "gif" | "svg";
+type ImageQuality = "auto" | "low" | "medium" | "high" | "xhigh" | "max";
+interface CustomImageSize {
+  height: number;
+  width: number;
+}
+/** Limits an endpoint puts on an exact `{ width, height }` image size. */
+interface ImageSizeBounds {
+  /** Largest width or height over smallest, e.g. 3 for 3:1. */
+  maxRatio?: number;
+  maxEdge?: number;
+  maxPixels?: number;
+  minEdge?: number;
+  minPixels?: number;
+  /** Both edges must be multiples of this. Motif uses 16 when absent. */
+  multipleOf?: number;
+}
+/** How the model accepts image dimensions */
+type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
+type QualityTier = "good" | "better" | "best" | "frontier";
+type SpeedTier = "fast" | "balanced" | "slow" | "very_slow" | "unknown";
+type PriceTier = "budget" | "standard" | "premium" | "ultra" | "variable";
+interface FalPricing {
+  checkedAt: string;
+  currency: "USD";
+  endpointId: string;
+  estimatedCostPerImageUsd?: number;
+  source: "fal-pricing-api";
+  unit: string;
+  unitPrice: number;
+}
+interface LeaderboardMetric {
+  elo: number;
+  rank: number;
+  winRate?: number;
+}
+interface ModelBenchmark {
+  artificialAnalysis?: {
+    editing?: LeaderboardMetric;
+    sourceUrls: string[];
+    snapshotDate: string;
+    textToImage?: LeaderboardMetric;
+  };
+  speed?: {
+    medianSeconds?: number;
+    p95Seconds?: number;
+    source: "artificial-analysis-models";
+  };
+  tiers?: {
+    price: PriceTier;
+    quality: QualityTier;
+    speed: SpeedTier;
+  };
+  useCase?: string;
+}
+interface ModelConfig {
+  benchmark?: ModelBenchmark;
+  /**
+   * The fal endpoint's `image_size` also takes an exact `{ width, height }`,
+   * within these limits read from fal's OpenAPI schema. Absent means only the
+   * named presets are sent. Only meaningful with `sizeMode: "image_size_enum"`.
+   */
+  customImageSize?: ImageSizeBounds;
+  /** Explicit fal streaming support for generation and edit routes. */
+  streaming?: {
+    generation: boolean;
+    edit: boolean;
+  };
+  editEndpoint?: string;
+  editImagesField?: "image_urls" | "image_url";
+  endpoint: string;
+  falPricing?: FalPricing;
+  maxReferenceImages?: number;
+  name: string;
+  pricing: string;
+  /** Upscale factor fal applies when none is sent. */
+  defaultScale?: number;
+  /** Makes audio unless `params: { generate_audio: false }`; priced with it. */
+  generatesAudio?: true;
+  /** Keys of the fal response that hold files, where the Model does not return `images`. */
+  outputKeys?: readonly string[];
+  /** Typed rate for a Model priced outside `pricePerImageUsd`. */
+  price?: FalToolPrice;
+  /** Upscale factors the endpoint takes, from its fal OpenAPI schema. */
+  scaleRange?: ScaleRange;
+  /** Body key for the upscale factor. */
+  scaleField?: "scale_factor" | "upscale_factor";
+  /** Body key the start frame goes under, on a video Model. */
+  startFrameField?: "image_url" | "start_image_url";
+  /** Takes a prompt that steers the result. */
+  supportsPrompt?: true;
+  /** Null means token-metered with no per-image estimate. */
+  pricePerImageUsd?: number | null;
+  /** How this model accepts dimensions (default: "aspect_ratio") */
+  sizeMode?: SizeMode;
+  supportsAspect: boolean;
+  /**
+   * The aspect ratios fal's `aspect_ratio` enum accepts, where it is narrower
+   * than `ASPECT_RATIOS`. Absent means every ratio is accepted.
+   */
+  supportedAspects?: readonly AspectRatio[];
+  /** The resolutions fal's `resolution` enum accepts, where it is narrower than `RESOLUTIONS`. */
+  supportedResolutions?: readonly Resolution[];
+  supportsBackground?: boolean;
+  supportsEdit: boolean;
+  supportsExpandPrompt?: boolean;
+  supportsGuidanceScale?: boolean;
+  supportsGoogleSearch?: boolean;
+  supportsInferenceSteps?: boolean;
+  supportsLimitGenerations?: boolean;
+  supportsMaskImage?: boolean;
+  maskImageField?: "mask_image_url" | "mask_url";
+  /**
+   * Takes `markup_image_url`: a transparent PNG of annotations (circles,
+   * arrows, notes) the size of the first edit image, guiding its edit.
+   */
+  supportsMarkupImage?: boolean;
+  /**
+   * An edit with no aspect asked for sends `image_size: "auto"`, so the
+   * result keeps the edited image's shape. For Models whose fal edit
+   * endpoint takes `auto`.
+   */
+  autoEditSize?: boolean;
+  supportsNegativePrompt?: boolean;
+  /** Most images one request makes, from the endpoint's `num_images` schema. Set wherever `supportsNumImages` is. */
+  maxCount?: number;
+  /** Output formats that make one image whatever `num_images` says. */
+  singleImageFormats?: readonly ImageOutputFormat[];
+  supportsNumImages: boolean;
+  supportsOutputFormat?: boolean;
+  /**
+   * The one format an endpoint with no `output_format` parameter always
+   * returns (Ideogram V3 Transparent: png). Asking for it is accepted, and
+   * nothing is sent.
+   */
+  fixedOutputFormat?: ImageOutputFormat;
+  /** Formats the Model returns. Absent means jpeg, png and webp. */
+  supportedOutputFormats?: readonly ImageOutputFormat[];
+  /** Formats an edit returns, where they differ from `supportedOutputFormats`. */
+  supportedEditOutputFormats?: readonly ImageOutputFormat[];
+  supportsQuality?: boolean;
+  /** Default matching the quality variant used in this Model's ranking. */
+  defaultQuality?: ImageQuality;
+  supportedQualities?: readonly ImageQuality[];
+  supportsRenderingSpeed?: boolean;
+  supportsResolution: boolean;
+  supportsSafetyTolerance?: boolean;
+  supportsSafetyChecker?: boolean;
+  supportsSeed?: boolean;
+  supportsSyncMode?: boolean;
+  supportsThinkingLevel?: boolean;
+  supportsWebSearch?: boolean;
+  /**
+   * The endpoint only makes transparent images and takes no `background`
+   * parameter (Ideogram V3 Transparent). Every output has an alpha channel.
+   */
+  transparentOutput?: boolean;
+  /** fal's `resolution` enum is lower case ("1k"), not Motif's "1K". */
+  lowercaseResolution?: true;
+  type: ModelType;
+  /** Use fal queue submit/status/result even for generate() calls. */
+  useQueue?: boolean;
+}
+/** Pixel sizes of fal's named `image_size` presets. `auto` has none. */
+export declare const FAL_PRESET_SIZES: Readonly<Record<string, CustomImageSize>>;
+/**
+ * Estimate cost based on model and settings. `editImages` is the number of
+ * input images on an edit, for Models whose edits cost more than generation.
+ * Null for a token-metered Model; throws for an id with no per-image price.
+ */
+export declare function estimateCost(model: string, resolution?: Resolution, numImages?: number, editImages?: number): number | null;
+export declare const MODELS: Record<string, ModelConfig>;
 export declare const FAL_TOOLS: {
   readonly "got-ocr": {
     readonly category: "analysis";
@@ -646,6 +709,7 @@ export declare const FAL_TOOLS: {
     };
     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 requiredPrompt: "a prompt naming the objects";
     readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects";
     readonly task: "single-image 3D object reconstruction";
   };
@@ -687,6 +751,10 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.0025/megapixel";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 10;
+      readonly min: 1;
+    };
     readonly sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless";
     readonly task: "seamless texture upscaling";
   };
@@ -728,7 +796,6 @@ export declare const FAL_TOOLS: {
     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.";
@@ -858,9 +925,6 @@ export declare const FAL_TOOLS: {
   };
   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";
@@ -873,14 +937,15 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.001/megapixel";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 10;
+      readonly min: 1;
+    };
     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";
@@ -899,9 +964,6 @@ export declare const FAL_TOOLS: {
   };
   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";
@@ -915,14 +977,15 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.08 per started 2 output megapixels, any Bloom model";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 4;
+      readonly min: 1;
+    };
     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";
@@ -941,9 +1004,6 @@ export declare const FAL_TOOLS: {
   };
   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";
@@ -957,6 +1017,10 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.08 per started 8 output megapixels at the default Wonder 3; per started 4 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 4;
+      readonly min: 1;
+    };
     readonly sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative";
     readonly task: "generative image upscaling";
   };
@@ -964,7 +1028,6 @@ export declare const FAL_TOOLS: {
     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.";
@@ -980,14 +1043,15 @@ export declare const FAL_TOOLS: {
     };
     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 scaleRange: {
+      readonly max: 4;
+      readonly min: 1;
+    };
     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";
@@ -1001,14 +1065,15 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.08 per 24 output megapixels, any precision model";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 4;
+      readonly min: 1;
+    };
     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";
@@ -1027,9 +1092,6 @@ export declare const FAL_TOOLS: {
   };
   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";
@@ -1050,8 +1112,10 @@ export declare const FAL_TOOLS: {
     readonly category: "restoration";
     readonly description: "Topaz upscaling that preserves the alpha channel end to end.";
     readonly endpoint: "topaz/upscale/image/transparent";
+    readonly fixedScale: 4;
     readonly inputField: "image_url";
     readonly inputKind: "image";
+    readonly keepsAlpha: true;
     readonly name: "Topaz Transparent Upscale";
     readonly outputKeys: ["image"];
     readonly price: {
@@ -1092,6 +1156,10 @@ export declare const FAL_TOOLS: {
     };
     readonly pricing: "$0.01/sec up to 720p output; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2";
     readonly queued: true;
+    readonly scaleRange: {
+      readonly max: 4;
+      readonly min: 1;
+    };
     readonly sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video";
     readonly task: "video enhancement";
   };
@@ -1101,6 +1169,7 @@ export declare const FAL_TOOLS: {
     readonly endpoint: "fal-ai/bria/eraser";
     readonly inputField: "image_url";
     readonly inputKind: "image";
+    readonly maskField: "mask_url";
     readonly name: "Bria Eraser";
     readonly outputKeys: ["image"];
     readonly price: {
@@ -1133,6 +1202,7 @@ export declare const FAL_TOOLS: {
     readonly endpoint: "fal-ai/bria/genfill";
     readonly inputField: "image_url";
     readonly inputKind: "image";
+    readonly maskField: "mask_url";
     readonly name: "Bria GenFill";
     readonly outputKeys: ["images"];
     readonly price: {
@@ -1183,6 +1253,7 @@ export declare const FAL_TOOLS: {
     readonly endpoint: "fal-ai/iclight-v2";
     readonly inputField: "image_url";
     readonly inputKind: "image";
+    readonly maskField: "mask_image_url";
     readonly name: "IC-Light v2";
     readonly outputKeys: ["images"];
     readonly price: {
@@ -1246,6 +1317,7 @@ export declare const FAL_TOOLS: {
     readonly category: "erase";
     readonly description: "Remove whatever falls inside supplied bounding boxes.";
     readonly endpoint: "fal-ai/object-removal/bbox";
+    readonly fractionBoxes: true;
     readonly inputField: "image_url";
     readonly inputKind: "image";
     readonly name: "Object Removal by Box";
@@ -1264,6 +1336,7 @@ export declare const FAL_TOOLS: {
     readonly endpoint: "fal-ai/object-removal/mask";
     readonly inputField: "image_url";
     readonly inputKind: "image";
+    readonly maskField: "mask_url";
     readonly name: "Object Removal by Mask";
     readonly outputKeys: ["images"];
     readonly price: {
@@ -1333,9 +1406,6 @@ export declare const FAL_TOOLS: {
   };
   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";
@@ -1544,7 +1614,6 @@ export declare const FAL_TOOLS: {
     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;
@@ -1569,13 +1638,13 @@ export declare const FAL_TOOLS: {
     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 needsTarget: true;
     readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
     readonly price: {
       readonly kind: "call";
@@ -1589,13 +1658,13 @@ export declare const FAL_TOOLS: {
     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 needsTarget: true;
     readonly outputKeys: ["video", "boundingbox_frames_zip"];
     readonly price: {
       readonly frames: 16;
@@ -1612,13 +1681,13 @@ export declare const FAL_TOOLS: {
     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 needsTarget: true;
     readonly outputKeys: ["image", "masks", "metadata", "scores", "boxes"];
     readonly price: {
       readonly kind: "call";
@@ -1639,6 +1708,7 @@ export declare const FAL_TOOLS: {
     readonly inputField: "image_url";
     readonly inputKind: "image";
     readonly name: "SAM 3 Image RLE";
+    readonly needsTarget: true;
     readonly outputKeys: ["rle", "scores", "boxes", "metadata"];
     readonly price: {
       readonly kind: "call";
@@ -1653,7 +1723,6 @@ export declare const FAL_TOOLS: {
     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.";
@@ -1661,6 +1730,7 @@ export declare const FAL_TOOLS: {
     readonly inputField: "video_url";
     readonly inputKind: "video";
     readonly name: "SAM 3 Video";
+    readonly needsTarget: true;
     readonly outputKeys: ["video", "boundingbox_frames_zip"];
     readonly price: {
       readonly frames: 16;
@@ -1677,13 +1747,13 @@ export declare const FAL_TOOLS: {
     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 needsTarget: true;
     readonly outputKeys: ["video", "boundingbox_frames_zip"];
     readonly price: {
       readonly frames: 16;