@howells/motif-sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1128 @@
+import { Result } from 'neverthrow';
+export { Result, ResultAsync, err, ok } from 'neverthrow';
+import * as _howells_envy from '@howells/envy';
+import { z } from 'zod';
+
+/** ─── Model Types ─────────────────────────────────────────────── */
+type AspectRatio = "auto" | "8:1" | "4:1" | "21:9" | "16:9" | "3:2" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "2:3" | "9:16" | "1:4" | "1:8";
+type Resolution = "0.5K" | "1K" | "2K" | "4K";
+type ModelType = "generation" | "utility" | "video";
+type ImageOutputFormat = "jpeg" | "png" | "webp";
+type BackgroundMode = "auto" | "transparent" | "opaque";
+type ImageQuality = "auto" | "low" | "medium" | "high";
+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 = {
+    height: number;
+    width: number;
+};
+type ImageSize = GptImageSize | FalImageSizePreset | CustomImageSize;
+/** How the model accepts image dimensions */
+type SizeMode = "aspect_ratio" | "image_size_enum" | "gpt_size" | "none";
+type QualityTier = "good" | "better" | "best" | "frontier";
+type SpeedTier = "fast" | "balanced" | "slow" | "very_slow" | "unknown";
+type PriceTier = "budget" | "standard" | "premium" | "ultra" | "variable";
+interface FalPricing {
+    checkedAt: string;
+    currency: "USD";
+    endpointId: string;
+    estimatedCostPerImageUsd?: number;
+    source: "fal-pricing-api";
+    unit: string;
+    unitPrice: number;
+}
+interface LeaderboardMetric {
+    elo: number;
+    pricePer1k?: number | null;
+    rank: number;
+    winRate?: number;
+}
+interface ModelBenchmark {
+    artificialAnalysis?: {
+        editing?: LeaderboardMetric;
+        sourceUrls: string[];
+        snapshotDate: string;
+        textToImage?: LeaderboardMetric;
+    };
+    speed?: {
+        medianSeconds?: number;
+        p95Seconds?: number;
+        source: "artificial-analysis-models";
+    };
+    tiers?: {
+        price: PriceTier;
+        quality: QualityTier;
+        speed: SpeedTier;
+    };
+    useCase?: string;
+}
+interface ModelConfig {
+    benchmark?: ModelBenchmark;
+    editEndpoint?: string;
+    editImagesField?: "image_urls" | "image_url";
+    endpoint: string;
+    falPricing?: FalPricing;
+    maxReferenceImages?: number;
+    name: string;
+    pricing: string;
+    pricePerImageUsd?: number;
+    /** How this model accepts dimensions (default: "aspect_ratio") */
+    sizeMode?: SizeMode;
+    supportsAspect: boolean;
+    supportsBackground?: boolean;
+    supportsEdit: boolean;
+    supportsEnhancePrompt?: boolean;
+    supportsExpandPrompt?: boolean;
+    supportsGuidanceScale?: boolean;
+    supportsGoogleSearch?: boolean;
+    supportsImagePromptStrength?: boolean;
+    supportsInferenceSteps?: boolean;
+    supportsLimitGenerations?: boolean;
+    supportsMaskImage?: boolean;
+    supportsNegativePrompt?: boolean;
+    supportsNumImages: boolean;
+    supportsOutputFormat?: boolean;
+    supportedOutputFormats?: readonly ImageOutputFormat[];
+    supportsQuality?: boolean;
+    supportsRaw?: boolean;
+    supportsRenderingSpeed?: boolean;
+    supportsResolution: boolean;
+    supportsSafetyTolerance?: boolean;
+    supportsSafetyChecker?: boolean;
+    supportsSeed?: boolean;
+    supportsStyle?: boolean;
+    supportsSyncMode?: boolean;
+    supportsThinkingLevel?: boolean;
+    supportsWebSearch?: boolean;
+    type: ModelType;
+    /** Use fal queue submit/status/result even for generate() calls. */
+    useQueue?: boolean;
+}
+/** ─── Generation Types ───────────────────────────────────────── */
+interface GenerateOptions {
+    aspect?: AspectRatio;
+    /** GPT background mode where supported */
+    background?: BackgroundMode;
+    editImageUrls?: string[];
+    /** Google-search alias for fal models that expose enable_google_search */
+    enableGoogleSearch?: boolean;
+    /** fal safety checker toggle where supported */
+    enableSafetyChecker?: boolean;
+    /** Enable web search for generative context where supported */
+    enableWebSearch?: boolean;
+    /** Auto-enhance the prompt before generation (flux only) */
+    enhancePrompt?: boolean;
+    /** Enable MagicPrompt expansion (ideogram only) */
+    expandPrompt?: boolean;
+    /** CFG guidance scale — flux-fast: 1–20 */
+    guidanceScale?: number;
+    /** Direct fal image_size override, including custom {width,height} where supported */
+    imageSize?: ImageSize;
+    /** FLUX image prompt/reference strength where supported */
+    imagePromptStrength?: number;
+    inputFidelity?: "low" | "high";
+    /** Nano Banana 2 generation limiting toggle */
+    limitGenerations?: boolean;
+    /** Mask image URL for inpainting/editing where supported */
+    maskImageUrl?: string;
+    model: string;
+    /** What NOT to include in the image (ideogram only) */
+    negativePrompt?: string;
+    numImages?: number;
+    /** Number of diffusion inference steps — flux-fast: 1–12 */
+    numInferenceSteps?: number;
+    /** Output image format (default: model-dependent) */
+    outputFormat?: ImageOutputFormat;
+    prompt: string;
+    /** GPT/OpenAI quality where supported */
+    quality?: ImageQuality;
+    /** Generate less processed, more natural images (flux only) */
+    raw?: boolean;
+    /** Speed vs. quality trade-off (ideogram only) */
+    renderingSpeed?: "TURBO" | "BALANCED" | "QUALITY";
+    resolution?: Resolution;
+    /** Safety tolerance level "1"–"6", where "1" is strictest */
+    safetyTolerance?: string;
+    /** Reproducible generation seed */
+    seed?: number;
+    /** Style preset — recraft: 70+ hierarchical styles; ideogram: "AUTO"|"GENERAL"|"REALISTIC"|"DESIGN" */
+    style?: string;
+    /** Return media as data URI where supported */
+    syncMode?: boolean;
+    /** Nano Banana 2 thinking mode */
+    thinkingLevel?: ThinkingLevel;
+    transparent?: boolean;
+}
+interface UpscaleOptions {
+    creativity?: number;
+    /** CFG guidance scale for upscaling (clarity only, 0–20, default 4) */
+    guidanceScale?: number;
+    imageUrl: string;
+    model?: "clarity" | "crystal";
+    /** What NOT to include in the upscaled result (clarity only) */
+    negativePrompt?: string;
+    /** Number of diffusion steps (clarity only, 4–50, default 18) */
+    numInferenceSteps?: number;
+    /** Prompt to guide the upscaling process (clarity only) */
+    prompt?: string;
+    /** How closely to preserve the original image (clarity only, 0–1, default 0.6) */
+    resemblance?: number;
+    scaleFactor?: number;
+}
+interface RemoveBackgroundOptions {
+    imageUrl: string;
+    model?: "rmbg" | "bria";
+    /** BiRefNet operating resolution (rmbg model only, default "1024x1024") */
+    operatingResolution?: "1024x1024" | "2048x2048";
+    /** Output image format (rmbg model only) */
+    outputFormat?: "png" | "webp" | "gif";
+    /** Return the alpha mask alongside the result (rmbg model only) */
+    outputMask?: boolean;
+    /** Apply foreground edge refinement (rmbg model only, default true) */
+    refineForeground?: boolean;
+    /** BiRefNet model variant (rmbg model only) */
+    variant?: "General Use (Light)" | "General Use (Heavy)" | "Portrait";
+}
+interface VideoOptions {
+    /** CFG guidance scale for video generation (0–1, default 0.5) */
+    cfgScale?: number;
+    /** Duration in seconds (3-15) */
+    duration?: number;
+    /** Optional end frame image URL */
+    endImageUrl?: string;
+    /** Generate audio track (default true, costs more) */
+    generateAudio?: boolean;
+    /** Source image URL */
+    imageUrl: string;
+    /** What NOT to include in the video */
+    negativePrompt?: string;
+    /** Text description of the motion/scene */
+    prompt: string;
+}
+interface VideoResponse {
+    contentType: string;
+    fileName: string;
+    fileSize: number;
+    url: string;
+}
+interface ToolRunOptions {
+    input?: string;
+    inputs?: string[];
+    options?: Record<string, unknown>;
+    tool: string;
+}
+type ToolResponse = Record<string, unknown>;
+/** ─── Response Types ─────────────────────────────────────────── */
+interface MotifImage {
+    content_type?: string;
+    height?: number;
+    url: string;
+    width?: number;
+}
+interface MotifResponse {
+    images: MotifImage[];
+    prompt?: string;
+    seed?: number;
+}
+/** ─── Queue Types ────────────────────────────────────────────── */
+interface QueuedJob {
+    endpoint: string;
+    estimatedCost: number;
+    requestId: string;
+}
+interface JobStatus {
+    error?: string;
+    logs?: Array<{
+        message: string;
+        timestamp: string;
+    }>;
+    queuePosition?: number;
+    status: "queued" | "processing" | "completed" | "failed";
+}
+/** ─── Configuration ──────────────────────────────────────────── */
+interface MotifServerConfig {
+    apiKey: string;
+    /** Max retry attempts for 429/5xx errors (default 3, set 0 to disable) */
+    retries?: number;
+    /** Request timeout in ms (default 120_000) */
+    timeout?: number;
+}
+
+/** Ordered by popularity: square first, then common ratios */
+declare const ASPECT_RATIOS: AspectRatio[];
+declare const RESOLUTIONS: Resolution[];
+/** Map aspect ratio to GPT image_size (GPT doesn't support arbitrary aspects) */
+declare function aspectToGptSize(aspect: AspectRatio): string;
+/**
+ * Map aspect ratio to fal.ai image_size enum.
+ * Used by FLUX Schnell, Recraft, Ideogram, and other models that accept
+ * named size presets rather than aspect ratio strings.
+ */
+declare function aspectToFalImageSize(aspect: AspectRatio): string;
+/** Format presets that set aspect + resolution in one click */
+declare const FORMAT_PRESETS: Record<string, {
+    label: string;
+    aspect: AspectRatio;
+    resolution?: Resolution;
+}>;
+
+/** Estimate cost based on model and settings */
+declare function estimateCost(model: string, resolution?: Resolution, numImages?: number): number;
+/** Estimate cost for video generation */
+declare function estimateVideoCost(durationSeconds?: number, generateAudio?: boolean): number;
+
+declare const motifEnvSchema: _howells_envy.EnvSchema<{
+    readonly optional: {
+        readonly FAL_KEY: z.ZodString;
+    };
+}>;
+type MotifEnv = ReturnType<typeof motifEnvSchema.parse>;
+declare function parseMotifEnv(input?: Record<string, unknown>): MotifEnv;
+declare function getFalKeyFromEnv(input?: Record<string, unknown>): string | undefined;
+
+/**
+ * Build the fal.ai request body for a generation request.
+ * Shared between sync generate() (CLI) and queue-based submit (web).
+ *
+ * Models use different sizing APIs:
+ * - `gpt_size`: GPT's fixed dimensions (1024x1024, 1536x1024, etc.)
+ * - `aspect_ratio`: string like "16:9" (Gemini, Grok, FLUX Pro Ultra)
+ * - `image_size_enum`: named presets like "landscape_4_3" (FLUX.2, Seedream, Recraft, Ideogram, GPT Image 2)
+ * - `none`: no size control (video models)
+ */
+declare function buildGenerateBody(options: GenerateOptions): {
+    endpoint: string;
+    body: Record<string, unknown>;
+};
+
+interface LeaderboardEntry {
+    apiPricing?: string;
+    creator: string;
+    elo: number;
+    isCurrent?: boolean;
+    model: string;
+    rank: number;
+    routableModelId?: string;
+}
+interface LeaderboardSnapshot {
+    capturedAt: string;
+    entries: LeaderboardEntry[];
+    source: string;
+}
+declare const IMAGE_TEXT_TO_IMAGE_TOP_20: LeaderboardSnapshot;
+declare const IMAGE_EDITING_TOP_20: LeaderboardSnapshot;
+declare const VIDEO_TEXT_TO_VIDEO_TOP_15: LeaderboardSnapshot;
+declare const VIDEO_IMAGE_TO_VIDEO_TOP_15: LeaderboardSnapshot;
+
+declare const MODELS: Record<string, ModelConfig>;
+declare const GENERATION_MODELS: readonly ["gpt2", "gpt", "banana2", "banana", "gemini", "gemini3", "seedream4", "seedream45", "flux2-max", "flux2-pro", "flux2-flex", "flux2-dev", "flux", "flux-fast", "recraft", "ideogram", "grok-image", "qwen"];
+declare const UTILITY_MODELS: readonly ["clarity", "crystal", "rmbg", "bria"];
+declare const VIDEO_MODELS: readonly ["kling"];
+type GenerationModelName = (typeof GENERATION_MODELS)[number];
+/** Recraft v3 style presets. Pass as the `style` field in GenerateOptions. */
+declare const RECRAFT_STYLES: readonly ["realistic_image", "realistic_image/b_and_w", "realistic_image/enterprise", "realistic_image/hard_flash", "realistic_image/hdr", "realistic_image/motion_blur", "realistic_image/natural_light", "realistic_image/studio_portrait", "realistic_image/long_exposure", "digital_illustration", "digital_illustration/2d_art_poster", "digital_illustration/2d_art_poster_2", "digital_illustration/engraving_color", "digital_illustration/grain", "digital_illustration/hand_drawn", "digital_illustration/hand_drawn_outline", "digital_illustration/handmade_3d", "digital_illustration/infantile_sketch", "digital_illustration/pixel_art", "digital_illustration/psychedelic", "digital_illustration/seamless", "digital_illustration/voxel", "digital_illustration/watercolor", "vector_illustration", "vector_illustration/cartoon", "vector_illustration/doodle_line_art", "vector_illustration/engraving", "vector_illustration/flat_2", "vector_illustration/kawaii", "vector_illustration/line_art", "vector_illustration/line_circuit", "vector_illustration/linocut", "vector_illustration/zentangle"];
+/** Ideogram v3 top-level style categories. Pass as the `style` field in GenerateOptions. */
+declare const IDEOGRAM_STYLES: readonly ["AUTO", "GENERAL", "REALISTIC", "DESIGN"];
+
+/**
+ * Motif Server SDK
+ *
+ * Server-side SDK for AI image generation via fal.ai.
+ * All async methods return `Result<T, MotifError>` — no thrown exceptions.
+ *
+ * @example
+ * ```typescript
+ * import { MotifServer } from "./fal";
+ *
+ * const motif = new MotifServer(process.env.FAL_KEY!);
+ * const result = await motif.generate({ prompt: "a red balloon", model: "banana" });
+ *
+ * if (result.isOk()) {
+ *   console.log(result.value.images[0].url);
+ * } else {
+ *   console.error(result.error.message);
+ * }
+ * ```
+ */
+declare class MotifServer {
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly retries;
+    constructor(config: MotifServerConfig | string);
+    /** ─── Synchronous Generation ──────────────────────────────── */
+    /** Generate images synchronously (blocks until fal.ai returns). */
+    generate(options: GenerateOptions): Promise<Result<MotifResponse, MotifError>>;
+    private generateQueued;
+    /** ─── Queue-Based Generation ──────────────────────────────── */
+    /** Submit a generation to the fal.ai queue (returns immediately). */
+    submitGeneration(options: GenerateOptions): Promise<Result<QueuedJob, MotifError>>;
+    /** Check the status of a queued generation. */
+    getJobStatus(endpoint: string, requestId: string): Promise<Result<JobStatus, MotifError>>;
+    /** Fetch the completed result from the queue. */
+    getJobResult(endpoint: string, requestId: string): Promise<Result<MotifResponse, MotifError>>;
+    /** ─── Processing ──────────────────────────────────────────── */
+    /** Upscale an image using clarity or crystal upscaler. */
+    upscale(options: UpscaleOptions): Promise<Result<MotifResponse, MotifError>>;
+    /** Remove the background from an image. */
+    removeBackground(options: RemoveBackgroundOptions): Promise<Result<MotifResponse, MotifError>>;
+    /** ─── Video Generation ───────────────────────────────────── */
+    /**
+     * Generate a video from an image using Kling v3 Pro.
+     * This uses the queue API since video generation takes 30-120s.
+     * Returns immediately with a job — poll with getJobStatus/getVideoResult.
+     */
+    submitVideo(options: VideoOptions): Promise<Result<QueuedJob, MotifError>>;
+    /** Fetch the completed video result from the queue. */
+    getVideoResult(endpoint: string, requestId: string): Promise<Result<VideoResponse, MotifError>>;
+    /** ─── File Upload ─────────────────────────────────────────── */
+    /**
+     * Upload a file to fal.ai CDN storage and return the public URL.
+     * Uses the two-step initiate + PUT flow.
+     */
+    uploadToFalCdn(file: ArrayBuffer | Uint8Array, options: {
+        contentType: string;
+        fileName: string;
+    }): Promise<Result<string, MotifError>>;
+    /** ─── Utilities ───────────────────────────────────────────── */
+    /** Run a registered fal utility/tool endpoint. */
+    runTool(options: ToolRunOptions): Promise<Result<ToolResponse, MotifError>>;
+    /** Estimate cost for a generation (no API call). */
+    estimateCost(model: string, resolution?: Resolution, numImages?: number): number;
+    /** Build the fal.ai request body without sending it. */
+    buildRequestBody(options: GenerateOptions): {
+        endpoint: string;
+        body: Record<string, unknown>;
+    };
+    /** Model registry. */
+    get models(): Record<string, ModelConfig>;
+    /** Generation model keys. */
+    get generationModels(): readonly ["gpt2", "gpt", "banana2", "banana", "gemini", "gemini3", "seedream4", "seedream45", "flux2-max", "flux2-pro", "flux2-flex", "flux2-dev", "flux", "flux-fast", "recraft", "ideogram", "grok-image", "qwen"];
+    /** Utility model keys. */
+    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 task: "image background removal";
+            readonly category: "background";
+            readonly description: "Generic image background removal utility.";
+            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/rembg";
+            readonly defaultOptions: {
+                readonly crop_to_bbox: false;
+            };
+        };
+        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 lineart: {
+            readonly name: "Line Art Preprocessor";
+            readonly endpoint: "fal-ai/image-preprocessors/lineart";
+            readonly task: "image preprocessing";
+            readonly category: "preprocess";
+            readonly description: "Generate line art/control-style edges from an input image.";
+            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/image-preprocessors/lineart";
+            readonly defaultOptions: {
+                readonly coarse: false;
+            };
+        };
+        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 inputField: "image_url";
+            readonly outputKeys: ["image"];
+            readonly pricing: "$0/compute-second listed by fal";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+        };
+        readonly "midas-depth": {
+            readonly name: "MiDaS Depth Estimation";
+            readonly endpoint: "fal-ai/imageutils/depth";
+            readonly task: "depth map";
+            readonly category: "depth";
+            readonly description: "Create MiDaS depth maps from input images.";
+            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/depth";
+            readonly defaultOptions: {
+                readonly a: number;
+                readonly bg_th: 0.1;
+            };
+        };
+        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 inputField: "image_url";
+            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 "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 "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 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/image-preprocessors/depth-anything/v2";
+        };
+        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";
+                readonly points_per_side: 32;
+                readonly pred_iou_thresh: 0.88;
+                readonly stability_score_thresh: 0.95;
+            };
+        };
+        readonly "sam3-image": {
+            readonly name: "SAM 3 Image";
+            readonly endpoint: "fal-ai/sam-3/image";
+            readonly task: "promptable image segmentation";
+            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-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 description: "Segment image objects and return run-length encoded masks.";
+            readonly inputKind: "image";
+            readonly inputField: "image_url";
+            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 "sam3-video": {
+            readonly name: "SAM 3 Video";
+            readonly endpoint: "fal-ai/sam-3/video";
+            readonly task: "promptable video segmentation";
+            readonly category: "segmentation";
+            readonly description: "Segment and track prompted objects across video frames.";
+            readonly inputKind: "video";
+            readonly inputField: "video_url";
+            readonly outputKeys: ["video", "boundingbox_frames_zip"];
+            readonly pricing: "$0.005/16 frames";
+            readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
+            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 inputField: "video_url";
+            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 "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 defaultOptions: {
+                readonly apply_mask: true;
+                readonly prompt: "person";
+            };
+        };
+        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 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 defaultOptions: {
+                readonly export_meshes: true;
+                readonly include_3d_keypoints: true;
+                readonly include_mhr_params: true;
+            };
+        };
+        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";
+        };
+    };
+    /** ─── Private ─────────────────────────────────────────────── */
+    /** Authenticated fetch to fal.ai APIs with retry logic. */
+    private request;
+    /**
+     * Normalize fal.ai responses.
+     * Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
+     */
+    private normalizeResponse;
+}
+declare class MotifError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+
+type FalToolInputKind = "image" | "images" | "video";
+interface FalToolConfig {
+    category: "3d" | "background" | "depth" | "moderation" | "preprocess" | "segmentation" | "upscale";
+    defaultOptions?: Record<string, unknown>;
+    description: string;
+    endpoint: string;
+    inputField: "image_url" | "image_urls" | "video_url";
+    inputKind: FalToolInputKind;
+    name: string;
+    outputKeys: string[];
+    pricing: string;
+    sourceUrl: string;
+    task: string;
+}
+interface FalToolRunOptions {
+    input?: string;
+    inputs?: string[];
+    options?: Record<string, unknown>;
+    tool: string;
+}
+interface FalToolRequest {
+    body: Record<string, unknown>;
+    endpoint: string;
+    tool: FalToolConfig;
+}
+declare const FAL_TOOLS: {
+    readonly 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 task: "image background removal";
+        readonly category: "background";
+        readonly description: "Generic image background removal utility.";
+        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/rembg";
+        readonly defaultOptions: {
+            readonly crop_to_bbox: false;
+        };
+    };
+    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 lineart: {
+        readonly name: "Line Art Preprocessor";
+        readonly endpoint: "fal-ai/image-preprocessors/lineart";
+        readonly task: "image preprocessing";
+        readonly category: "preprocess";
+        readonly description: "Generate line art/control-style edges from an input image.";
+        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/image-preprocessors/lineart";
+        readonly defaultOptions: {
+            readonly coarse: false;
+        };
+    };
+    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 inputField: "image_url";
+        readonly outputKeys: ["image"];
+        readonly pricing: "$0/compute-second listed by fal";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam";
+    };
+    readonly "midas-depth": {
+        readonly name: "MiDaS Depth Estimation";
+        readonly endpoint: "fal-ai/imageutils/depth";
+        readonly task: "depth map";
+        readonly category: "depth";
+        readonly description: "Create MiDaS depth maps from input images.";
+        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/depth";
+        readonly defaultOptions: {
+            readonly a: number;
+            readonly bg_th: 0.1;
+        };
+    };
+    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 inputField: "image_url";
+        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 "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 "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 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/image-preprocessors/depth-anything/v2";
+    };
+    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";
+            readonly points_per_side: 32;
+            readonly pred_iou_thresh: 0.88;
+            readonly stability_score_thresh: 0.95;
+        };
+    };
+    readonly "sam3-image": {
+        readonly name: "SAM 3 Image";
+        readonly endpoint: "fal-ai/sam-3/image";
+        readonly task: "promptable image segmentation";
+        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-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 description: "Segment image objects and return run-length encoded masks.";
+        readonly inputKind: "image";
+        readonly inputField: "image_url";
+        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 "sam3-video": {
+        readonly name: "SAM 3 Video";
+        readonly endpoint: "fal-ai/sam-3/video";
+        readonly task: "promptable video segmentation";
+        readonly category: "segmentation";
+        readonly description: "Segment and track prompted objects across video frames.";
+        readonly inputKind: "video";
+        readonly inputField: "video_url";
+        readonly outputKeys: ["video", "boundingbox_frames_zip"];
+        readonly pricing: "$0.005/16 frames";
+        readonly sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video";
+        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 inputField: "video_url";
+        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 "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 defaultOptions: {
+            readonly apply_mask: true;
+            readonly prompt: "person";
+        };
+    };
+    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 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 defaultOptions: {
+            readonly export_meshes: true;
+            readonly include_3d_keypoints: true;
+            readonly include_mhr_params: true;
+        };
+    };
+    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";
+    };
+};
+declare const FAL_TOOLS_CHECKED_AT = "2026-05-12";
+declare const FAL_TOOL_IDS: Array<keyof typeof FAL_TOOLS>;
+type FalToolId = (typeof FAL_TOOL_IDS)[number];
+declare function isFalToolId(tool: string): tool is FalToolId;
+declare function buildFalToolRequest(options: FalToolRunOptions): FalToolRequest;
+
+export { ASPECT_RATIOS, type AspectRatio, type BackgroundMode, type CustomImageSize, FAL_TOOLS, FAL_TOOLS_CHECKED_AT, FAL_TOOL_IDS, FORMAT_PRESETS, type FalImageSizePreset, type FalToolConfig, type FalToolId, type FalToolInputKind, type FalToolRequest, type FalToolRunOptions, GENERATION_MODELS, type GenerateOptions, type GenerationModelName, type GptImageSize, IDEOGRAM_STYLES, IMAGE_EDITING_TOP_20, IMAGE_TEXT_TO_IMAGE_TOP_20, type ImageOutputFormat, type ImageQuality, type ImageSize, type JobStatus, type LeaderboardEntry, type LeaderboardSnapshot, MODELS, type ModelConfig, type ModelType, type MotifEnv, MotifError, type MotifImage, type MotifResponse, MotifServer, type MotifServerConfig, type QueuedJob, RECRAFT_STYLES, RESOLUTIONS, type RemoveBackgroundOptions, type Resolution, type SizeMode, type ThinkingLevel, type ToolResponse, type ToolRunOptions, UTILITY_MODELS, type UpscaleOptions, VIDEO_IMAGE_TO_VIDEO_TOP_15, VIDEO_MODELS, VIDEO_TEXT_TO_VIDEO_TOP_15, type VideoOptions, type VideoResponse, aspectToFalImageSize, aspectToGptSize, buildFalToolRequest, buildGenerateBody, estimateCost, estimateVideoCost, getFalKeyFromEnv, isFalToolId, motifEnvSchema, parseMotifEnv };