@howells/motif-sdk 1.1.0 → 1.3.0

package/dist/image.js

@@ -1,27 +1,28 @@
 // src/image/index.ts
 import { generateImage } from "ai";
-import { err as err2, ok as ok2 } from "neverthrow";
+import { err as err3, ok as ok3 } from "neverthrow";
 
 // src/server.ts
-import { err, ok } from "neverthrow";
+import { err as err2, ok as ok2 } from "neverthrow";
 
 // src/models.ts
-var AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-05-12";
+var AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-08-23";
 var AA_IMAGE_SOURCES = [
   "https://artificialanalysis.ai/image/leaderboard/text-to-image",
   "https://artificialanalysis.ai/image/leaderboard/editing"
 ];
 var FAL_PRICING_CHECKED_AT = "2026-05-12";
 var FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
+var FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 var MODELS = {
   // ─── Generation Models ────────────────────────────────────────
   gpt2: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1249, pricePer1k: 211, rank: 3, winRate: 0.66 },
+        editing: { elo: 1256, rank: 3 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1337, pricePer1k: 211, rank: 1, winRate: 0.8 }
+        textToImage: { elo: 1369, rank: 1 }
       },
       speed: {
         medianSeconds: 200.7,
@@ -61,10 +62,10 @@ var MODELS = {
   gpt: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1262, pricePer1k: 133, rank: 2, winRate: 0.69 },
+        editing: { elo: 1250, rank: 5 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1268, pricePer1k: 133, rank: 2, winRate: 0.73 }
+        textToImage: { elo: 1310, rank: 4 }
       },
       speed: {
         medianSeconds: 34.6,
@@ -104,10 +105,10 @@ var MODELS = {
   banana2: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1231, pricePer1k: 67, rank: 5, winRate: 0.63 },
+        editing: { elo: 1249, rank: 7 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1263, pricePer1k: 67, rank: 3, winRate: 0.71 }
+        textToImage: { elo: 1320, rank: 3 }
       },
       tiers: { price: "premium", quality: "frontier", speed: "unknown" },
       useCase: "Best balance of quality, edit support, web search, and cost"
@@ -145,10 +146,10 @@ var MODELS = {
   banana: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1241, pricePer1k: 134, rank: 4, winRate: 0.65 },
+        editing: { elo: 1245, rank: 9 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1220, pricePer1k: 134, rank: 5, winRate: 0.66 }
+        textToImage: { elo: 1297, rank: 6 }
       },
       speed: {
         medianSeconds: 19.2,
@@ -188,6 +189,13 @@ var MODELS = {
     type: "generation"
   },
   gemini: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1180, rank: 29 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES
+      }
+    },
     editEndpoint: "fal-ai/gemini-25-flash-image/edit",
     endpoint: "fal-ai/gemini-25-flash-image",
     falPricing: {
@@ -215,6 +223,14 @@ var MODELS = {
     type: "generation"
   },
   gemini3: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1245, rank: 9 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1297, rank: 6 }
+      }
+    },
     editEndpoint: "fal-ai/gemini-3-pro-image-preview/edit",
     endpoint: "fal-ai/gemini-3-pro-image-preview",
     falPricing: {
@@ -245,10 +261,10 @@ var MODELS = {
   seedream4: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 30, rank: 16, winRate: 0.61 },
+        editing: { elo: 1185, rank: 28 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1198, pricePer1k: 30, rank: 6, winRate: 0.59 }
+        textToImage: { elo: 1226, rank: 16 }
       },
       speed: {
         medianSeconds: 14.3,
@@ -285,10 +301,10 @@ var MODELS = {
   seedream45: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 40, rank: 17, winRate: 0.58 },
+        editing: { elo: 1186, rank: 26 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1167, pricePer1k: 40, rank: 17, winRate: 0.63 }
+        textToImage: { elo: 1203, rank: 32 }
       },
       speed: {
         medianSeconds: 18.2,
@@ -323,6 +339,14 @@ var MODELS = {
     type: "generation"
   },
   seedream5: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1248, rank: 8 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1279, rank: 10 }
+      }
+    },
     name: "Seedream 5.0 Pro",
     endpoint: "bytedance/seedream/v5/pro/text-to-image",
     editEndpoint: "bytedance/seedream/v5/pro/edit",
@@ -349,6 +373,13 @@ var MODELS = {
     maxReferenceImages: 10
   },
   "seedream5-lite": {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1169, rank: 32 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES
+      }
+    },
     name: "Seedream 5.0 Lite",
     endpoint: "fal-ai/bytedance/seedream/v5/lite/text-to-image",
     editEndpoint: "fal-ai/bytedance/seedream/v5/lite/edit",
@@ -377,10 +408,10 @@ var MODELS = {
   "flux2-max": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1206, pricePer1k: 140, rank: 10, winRate: 0.6 },
+        editing: { elo: 1201, rank: 19 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1197, pricePer1k: 70, rank: 8, winRate: 0.67 }
+        textToImage: { elo: 1225, rank: 17 }
       },
       speed: {
         medianSeconds: 31.6,
@@ -420,10 +451,10 @@ var MODELS = {
   "flux2-pro": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1170, pricePer1k: 30, rank: 21 },
+        editing: { elo: 1170, rank: 31 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1186, pricePer1k: 30, rank: 10, winRate: 0.62 }
+        textToImage: { elo: 1207, rank: 30 }
       },
       speed: {
         medianSeconds: 16.1,
@@ -463,10 +494,9 @@ var MODELS = {
   "flux2-flex": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1161, pricePer1k: 60, rank: 22 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1182, pricePer1k: 60, rank: 13, winRate: 0.61 }
+        textToImage: { elo: 1223, rank: 18 }
       },
       speed: {
         medianSeconds: 15.3,
@@ -510,8 +540,7 @@ var MODELS = {
     benchmark: {
       artificialAnalysis: {
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-        sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1160, pricePer1k: 12, rank: 19, winRate: 0.57 }
+        sourceUrls: AA_IMAGE_SOURCES
       },
       speed: {
         medianSeconds: 4.6,
@@ -654,7 +683,55 @@ var MODELS = {
     supportsSyncMode: true,
     type: "generation"
   },
+  reve: {
+    benchmark: {
+      artificialAnalysis: {
+        // #2 on BOTH boards, which almost nothing else manages - the top text-to-image model
+        // (GPT Image 2) drops to 3rd for editing, and the top editor (MAI-Image-2.5-Pro) is not
+        // on fal at all. Reve is the best editor motif can actually reach.
+        editing: { elo: 1263, rank: 2 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1322, rank: 2 }
+      },
+      tiers: { price: "premium", quality: "frontier", speed: "unknown" },
+      useCase: "Highest-ranked editor reachable on fal; strong prompt adherence and text rendering"
+    },
+    editEndpoint: "fal-ai/reve/edit",
+    endpoint: "fal-ai/reve/text-to-image",
+    falPricing: {
+      checkedAt: FAL_PRICING_CHECKED_AUG_2026,
+      currency: "USD",
+      endpointId: "fal-ai/reve/text-to-image",
+      estimatedCostPerImageUsd: 0.04,
+      source: "fal-pricing-api",
+      unit: "images",
+      unitPrice: 0.04
+    },
+    maxReferenceImages: 1,
+    name: "Reve 2.1",
+    pricePerImageUsd: 0.04,
+    pricing: "$0.04",
+    // fal's schema takes aspect_ratio from a fixed set and has no width/height or resolution
+    // parameter, so aspect is supported and resolution is not.
+    sizeMode: "aspect_ratio",
+    supportsAspect: true,
+    supportsEdit: true,
+    supportsNumImages: true,
+    supportsOutputFormat: true,
+    supportsResolution: false,
+    supportsSeed: false,
+    supportsSyncMode: true,
+    type: "generation"
+  },
   recraft4: {
+    benchmark: {
+      artificialAnalysis: {
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1215, rank: 25 }
+      }
+    },
     endpoint: "fal-ai/recraft/v4/text-to-image",
     falPricing: {
       checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -705,6 +782,13 @@ var MODELS = {
     type: "generation"
   },
   ideogram4: {
+    benchmark: {
+      artificialAnalysis: {
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1220, rank: 19 }
+      }
+    },
     name: "Ideogram V4",
     endpoint: "ideogram/v4",
     type: "generation",
@@ -737,10 +821,10 @@ var MODELS = {
   "grok-image": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1213, pricePer1k: 20, rank: 7, winRate: 0.6 },
+        editing: { elo: 1214, rank: 16 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1182, pricePer1k: 20, rank: 12, winRate: 0.6 }
+        textToImage: { elo: 1216, rank: 23 }
       },
       speed: {
         medianSeconds: 5.1,
@@ -778,8 +862,7 @@ var MODELS = {
     benchmark: {
       artificialAnalysis: {
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-        sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1158, pricePer1k: 20, rank: 20, winRate: 0.6 }
+        sourceUrls: AA_IMAGE_SOURCES
       },
       speed: {
         medianSeconds: 23.3,
@@ -814,8 +897,14 @@ var MODELS = {
   },
   qwen3: {
     benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1218, rank: 15 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1272, rank: 11 }
+      },
       tiers: { price: "budget", quality: "better", speed: "unknown" },
-      useCase: "Qwen Image 3 - successor to qwen; no leaderboard data yet"
+      useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
     },
     endpoint: "fal-ai/qwen-image-3/text-to-image",
     falPricing: {
@@ -925,8 +1014,385 @@ var EDIT_CAPABLE_MODELS = GENERATION_MODELS.filter(
   (id) => MODELS[id]?.supportsEdit === true
 );
 
-// src/tools.ts
-var FAL_TOOLS = {
+// src/errors.ts
+var MotifError = class extends Error {
+  status;
+  code;
+  /** 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. */
+  requestId;
+  constructor(message, status, code, requestId) {
+    super(message);
+    this.name = "MotifError";
+    this.status = status;
+    this.code = code;
+    this.requestId = requestId;
+  }
+};
+
+// src/server-tools.ts
+import { err, ok } from "neverthrow";
+
+// src/tool-registry/analysis.ts
+var ANALYSIS_TOOLS = {
+  "got-ocr": {
+    category: "analysis",
+    description: "Transcribe text from one or more images, optionally as formatted multi-page output.",
+    endpoint: "fal-ai/got-ocr/v2",
+    inputField: "input_image_urls",
+    inputKind: "images",
+    name: "GOT-OCR 2.0",
+    outputKeys: ["outputs"],
+    price: { kind: "metered" },
+    pricing: "$0.05/image",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2",
+    task: "optical character recognition"
+  },
+  "moondream-caption": {
+    category: "analysis",
+    description: "Write a short, normal, or long caption for an image.",
+    endpoint: "fal-ai/moondream3-preview/caption",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Moondream 3 Caption",
+    outputKeys: ["output"],
+    price: { kind: "metered" },
+    pricing: "$0.40/M input tokens, $3.50/M output tokens",
+    sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption",
+    task: "image captioning"
+  },
+  "moondream-detect": {
+    category: "analysis",
+    description: "Detect prompted objects and return their bounding boxes, with an optional preview.",
+    endpoint: "fal-ai/moondream3-preview/detect",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Moondream 3 Detect",
+    outputKeys: ["objects", "image"],
+    price: { kind: "metered" },
+    pricing: "$0.40/M input tokens, $3.50/M output tokens",
+    sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect",
+    task: "object detection"
+  },
+  "moondream-point": {
+    category: "analysis",
+    description: "Return point coordinates for every instance of a prompted subject.",
+    endpoint: "fal-ai/moondream3-preview/point",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Moondream 3 Point",
+    outputKeys: ["points", "image"],
+    price: { kind: "metered" },
+    pricing: "$0.40/M input tokens, $3.50/M output tokens",
+    sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point",
+    task: "object pointing"
+  },
+  "moondream-query": {
+    category: "analysis",
+    description: "Answer a free-form question about an image, with reasoning.",
+    endpoint: "fal-ai/moondream3-preview/query",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Moondream 3 Query",
+    outputKeys: ["output", "reasoning"],
+    price: { kind: "metered" },
+    pricing: "$0.40/M input tokens, $3.50/M output tokens",
+    sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/query",
+    task: "visual question answering"
+  },
+  nsfw: {
+    category: "moderation",
+    description: "Predict whether one or more images contain NSFW concepts.",
+    endpoint: "fal-ai/x-ailab/nsfw",
+    inputField: "image_urls",
+    inputKind: "images",
+    name: "NSFW Checker",
+    outputKeys: ["has_nsfw_concepts"],
+    price: { kind: "metered" },
+    pricing: "$0.001/image",
+    sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw",
+    task: "vision moderation"
+  }
+};
+
+// src/tool-registry/assets.ts
+var ASSET_TOOLS = {
+  "hunyuan3d-v3": {
+    category: "3d",
+    description: "Reconstruct a textured 3D mesh from a single image, with optional multi-view inputs.",
+    endpoint: "fal-ai/hunyuan3d-v3/image-to-3d",
+    inputField: "input_image_url",
+    inputKind: "image",
+    name: "Hunyuan3D v3 Image to 3D",
+    outputKeys: ["model_glb", "model_urls", "thumbnail"],
+    price: { kind: "call", usd: 0.375 },
+    pricing: "$0.375/generation at the default Normal type; $0.45 low poly, $0.225 geometry only, and $0.15 each for PBR, multi-view, or a custom face count",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/hunyuan3d-v3/image-to-3d",
+    task: "single-image 3D reconstruction"
+  },
+  "ideogram-layerize-text": {
+    category: "layers",
+    description: "Split an image into background image layers plus editable HTML text containers.",
+    endpoint: "fal-ai/ideogram/v3/layerize-text",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Ideogram v3 Text Layerize",
+    outputKeys: ["image_layers", "image", "text_html", "text_containers"],
+    price: { kind: "call", usd: 0.09 },
+    pricing: "$0.09/image",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/layerize-text",
+    task: "text and image layer extraction"
+  },
+  "ideogram-tiling": {
+    category: "material",
+    description: "Generate a seamlessly tiling texture, optionally conditioned on a source image.",
+    endpoint: "ideogram/v4/tiling",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Ideogram v4 Tiling",
+    outputKeys: ["images"],
+    price: { kind: "megapixel", usd: 0.06 },
+    pricing: "$0.06/megapixel at the default BALANCED speed; $0.03 turbo, $0.10 quality",
+    sourceUrl: "https://fal.ai/models/ideogram/v4/tiling",
+    task: "seamless texture generation"
+  },
+  image2svg: {
+    category: "vector",
+    description: "Trace a raster image into layered SVG paths.",
+    endpoint: "fal-ai/image2svg",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Image to SVG",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 5e-3 },
+    pricing: "$0.005/image",
+    sourceUrl: "https://fal.ai/models/fal-ai/image2svg",
+    task: "raster to vector tracing"
+  },
+  patina: {
+    category: "material",
+    description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.",
+    endpoint: "fal-ai/patina",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Patina PBR Maps",
+    outputKeys: ["images"],
+    // Output order follows the request's `maps` array, so read that first;
+    // the fallback is the endpoint's own schema default.
+    outputLabels: {
+      images: {
+        fallback: ["basecolor", "normal", "roughness", "metalness", "height"],
+        fromOption: "maps"
+      }
+    },
+    price: { kind: "metered" },
+    pricing: "$0.01 base plus $0.01/megapixel per output map, so all 5 maps on a 1MP image cost $0.06; the listed rate is per map",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/patina",
+    task: "PBR material decomposition"
+  },
+  "patina-extract": {
+    category: "material",
+    description: "Extract a tiling PBR material from a prompted region of a photograph.",
+    endpoint: "fal-ai/patina/material/extract",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Patina Material Extract",
+    outputKeys: ["images"],
+    // Same `maps` option and schema default as fal-ai/patina, both verified.
+    // `num_images` above 1 multiplies the array and breaks the mapping, which
+    // the count check catches.
+    outputLabels: {
+      images: {
+        fallback: ["basecolor", "normal", "roughness", "metalness", "height"],
+        fromOption: "maps"
+      }
+    },
+    price: { kind: "metered" },
+    pricing: "$0.10 base only; add $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract",
+    task: "tiling material extraction"
+  },
+  "qwen-layered": {
+    category: "layers",
+    description: "Split an image into a configurable number of stacked RGBA layers.",
+    endpoint: "fal-ai/qwen-image-layered",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Qwen Image Layered",
+    outputKeys: ["images"],
+    // fal publishes a figure but not what it counts. Encoding it as `call`
+    // would assert a per-request price we cannot support, and this endpoint
+    // returns several outputs — the same shape that made `seedream-layerize`
+    // under-report by a factor of its layer count. `metered` reports null
+    // rather than a number that is right only on one reading.
+    price: { kind: "metered" },
+    pricing: "$0.05 per image; fal does not say whether that counts the input image or each of the generated layers, so no estimate is reported",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered",
+    task: "image layer decomposition"
+  },
+  "recraft-vectorize": {
+    category: "vector",
+    description: "Convert a raster image into a clean SVG.",
+    endpoint: "fal-ai/recraft/vectorize",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Recraft Vectorize",
+    outputKeys: ["image"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/image, $0.08 with a vector style",
+    sourceUrl: "https://fal.ai/models/fal-ai/recraft/vectorize",
+    task: "raster to vector conversion"
+  },
+  "sam3-3d-align": {
+    category: "3d",
+    description: "Align SAM 3D objects and bodies into a shared scene.",
+    endpoint: "fal-ai/sam-3/3d-align",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SAM 3D Align",
+    outputKeys: [
+      "scene_glb",
+      "model_glb",
+      "visualization",
+      "body_mesh_ply",
+      "metadata"
+    ],
+    // fal publishes a figure but not what it counts. Encoding it as `call`
+    // would assert a per-request price we cannot support, and this endpoint
+    // returns several outputs — the same shape that made `seedream-layerize`
+    // under-report by a factor of its layer count. `metered` reports null
+    // rather than a number that is right only on one reading.
+    price: { kind: "metered" },
+    pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align",
+    task: "3D scene alignment"
+  },
+  "sam3-3d-body": {
+    category: "3d",
+    defaultOptions: {
+      export_meshes: true,
+      include_3d_keypoints: true,
+      include_mhr_params: true
+    },
+    description: "Reconstruct human body meshes and keypoints from a single image.",
+    endpoint: "fal-ai/sam-3/3d-body",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SAM 3D Body",
+    outputKeys: ["model_glb", "visualization", "meshes", "metadata"],
+    // fal publishes a figure but not what it counts. Encoding it as `call`
+    // would assert a per-request price we cannot support, and this endpoint
+    // returns several outputs — the same shape that made `seedream-layerize`
+    // under-report by a factor of its layer count. `metered` reports null
+    // rather than a number that is right only on one reading.
+    price: { kind: "metered" },
+    pricing: "$0.02 per unit; fal does not define a unit, so no estimate is reported",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body",
+    task: "single-image 3D body reconstruction"
+  },
+  "sam3-3d-objects": {
+    category: "3d",
+    defaultOptions: {
+      prompt: "car"
+    },
+    description: "Reconstruct one or more 3D objects from an image and prompts.",
+    endpoint: "fal-ai/sam-3/3d-objects",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SAM 3D Objects",
+    outputKeys: [
+      "gaussian_splat",
+      "model_glb",
+      "metadata",
+      "individual_splats",
+      "individual_glbs",
+      "artifacts_zip"
+    ],
+    // fal publishes a figure but not what it counts. Encoding it as `call`
+    // would assert a per-request price we cannot support, and this endpoint
+    // returns several outputs — the same shape that made `seedream-layerize`
+    // under-report by a factor of its layer count. `metered` reports null
+    // rather than a number that is right only on one reading.
+    price: { kind: "metered" },
+    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",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects",
+    task: "single-image 3D object reconstruction"
+  },
+  "seedream-layerize": {
+    category: "layers",
+    description: "Split an image into editable Seedream layers plus flattened previews.",
+    endpoint: "bytedance/seedream/v5/pro/layerize",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Seedream v5 Pro Layerize",
+    outputKeys: ["layers", "images"],
+    // Every element of `layers` carries its own `name` ("Left amber glass
+    // bottle") and a `z_index` that orders the stack, verified live. Without
+    // this the stack lands as layers.png … layers-5.png and the only way to
+    // tell the reconstructed background plate from an object is to open them.
+    outputLabels: {
+      layers: { fromItem: { nameField: "name", orderField: "z_index" } }
+    },
+    price: { kind: "metered" },
+    pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize",
+    task: "image layer decomposition"
+  },
+  "seedvr-seamless": {
+    category: "material",
+    description: "Upscale a tiling texture while keeping its edges seamless. ",
+    endpoint: "fal-ai/seedvr/upscale/image/seamless",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SeedVR Seamless Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 25e-4 },
+    pricing: "$0.0025/megapixel",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless",
+    task: "seamless texture upscaling"
+  },
+  "trellis-2": {
+    category: "3d",
+    description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.",
+    endpoint: "fal-ai/trellis-2",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "TRELLIS 2",
+    outputKeys: ["model_glb"],
+    price: { kind: "call", usd: 0.3 },
+    pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/trellis-2",
+    task: "single-image 3D reconstruction"
+  }
+};
+
+// src/tool-registry/background.ts
+var BACKGROUND_TOOLS = {
+  "ben-v2": {
+    category: "background",
+    description: "Fast, high-quality background removal for images.",
+    endpoint: "fal-ai/ben/v2/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "BEN v2 Background Removal",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.025 },
+    pricing: "$0.025/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image",
+    task: "image background removal"
+  },
   birefnet: {
     category: "background",
     defaultOptions: {
@@ -941,6 +1407,7 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "BirefNet Background Removal",
     outputKeys: ["image", "mask_image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
     sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2",
     task: "image background removal"
@@ -953,7 +1420,8 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "Bria RMBG 2.0",
     outputKeys: ["image"],
-    pricing: "$0.02/image",
+    price: { kind: "call", usd: 0.018 },
+    pricing: "$0.018/generation",
     sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove",
     task: "image background removal"
   },
@@ -970,65 +1438,507 @@ var FAL_TOOLS = {
     inputKind: "video",
     name: "Bria Video Background Removal",
     outputKeys: ["video"],
-    pricing: "$0.14/sec",
+    price: { kind: "second", usd: 425e-5 },
+    pricing: "$0.00425/sec",
+    queued: true,
     sourceUrl: "https://fal.ai/models/bria/video/background-removal",
     task: "video background removal"
   },
-  "depth-anything": {
-    category: "preprocess",
-    description: "Generate Depth Anything v2 depth maps from input images.",
-    endpoint: "fal-ai/image-preprocessors/depth-anything/v2",
+  ddcolor: {
+    category: "restoration",
+    description: "Colourise black-and-white photographs.",
+    endpoint: "fal-ai/ddcolor",
     inputField: "image_url",
     inputKind: "image",
-    name: "Depth Anything v2 Preprocessor",
+    name: "DDColor Colourisation",
     outputKeys: ["image"],
-    pricing: "$0/compute-second listed by fal",
-    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2",
-    task: "depth preprocessing"
+    price: { kind: "megapixel", usd: 1e-3 },
+    pricing: "$0.001/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/ddcolor",
+    task: "photo colourisation"
   },
-  lineart: {
-    category: "preprocess",
+  rembg: {
+    category: "background",
     defaultOptions: {
-      coarse: false
+      crop_to_bbox: false
     },
-    description: "Generate line art/control-style edges from an input image.",
-    endpoint: "fal-ai/image-preprocessors/lineart",
+    description: "Generic image background removal utility.",
+    endpoint: "fal-ai/imageutils/rembg",
     inputField: "image_url",
     inputKind: "image",
-    name: "Line Art Preprocessor",
+    name: "Remove Background",
     outputKeys: ["image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
-    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart",
-    task: "image preprocessing"
+    sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg",
+    task: "image background removal"
   },
-  "marigold-depth": {
-    category: "depth",
+  "seedvr-upscale": {
+    category: "restoration",
     defaultOptions: {
-      ensemble_size: 10,
-      num_inference_steps: 10
+      output_format: "png"
     },
-    description: "Create depth maps using Marigold depth estimation.",
-    endpoint: "fal-ai/imageutils/marigold-depth",
+    description: "Diffusion image restoration and upscaling with SeedVR.",
+    endpoint: "fal-ai/seedvr/upscale/image",
     inputField: "image_url",
     inputKind: "image",
-    name: "Marigold Depth Estimation",
+    name: "SeedVR Image Upscale",
     outputKeys: ["image"],
-    pricing: "$0/compute-second listed by fal",
-    sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth",
-    task: "depth map"
+    price: { kind: "megapixel", usd: 1e-3 },
+    pricing: "$0.001/megapixel",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image",
+    task: "image restoration and upscaling"
   },
-  "midas-depth": {
-    category: "depth",
+  "topaz-adjust": {
+    category: "restoration",
     defaultOptions: {
-      a: Math.PI * 2,
-      bg_th: 0.1
+      output_format: "png"
     },
-    description: "Create MiDaS depth maps from input images.",
+    description: "Topaz exposure, white balance, and colour adjustment.",
+    endpoint: "topaz/adjust/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Adjust",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 per 24 output megapixels",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/adjust/image",
+    task: "tonal adjustment"
+  },
+  "topaz-creative": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz Bloom upscaling, which reimagines detail rather than preserving it.",
+    endpoint: "topaz/upscale/image/creative",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Creative Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.96 / 24 },
+    pricing: "$0.96 per 24 output megapixels",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative",
+    task: "creative image upscaling"
+  },
+  "topaz-denoise": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz noise reduction at source resolution.",
+    endpoint: "topaz/denoise/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Denoise",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/denoise/image",
+    task: "image denoising"
+  },
+  "topaz-generative": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz Wonder upscaling, which synthesises plausible detail as it enlarges.",
+    endpoint: "topaz/upscale/image/generative",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Generative Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.24 / 24 },
+    pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative",
+    task: "generative image upscaling"
+  },
+  "topaz-image": {
+    category: "upscale",
+    defaultOptions: {
+      model: "Standard V2",
+      output_format: "jpeg",
+      upscale_factor: 2
+    },
+    description: "Professional Topaz image enhancement and upscaling.",
+    endpoint: "fal-ai/topaz/upscale/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Image Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image",
+    task: "image enhancement"
+  },
+  "topaz-precision": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz upscaling that preserves the original detail rather than inventing it.",
+    endpoint: "topaz/upscale/image/precision",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Precision Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 per 24 output megapixels, any precision model",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/upscale/image/precision",
+    task: "faithful image upscaling"
+  },
+  "topaz-restore": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz restoration of damaged or degraded photographs at source resolution.",
+    endpoint: "topaz/restore/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Restore",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.48 / 24 },
+    pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/restore/image",
+    task: "photo restoration"
+  },
+  "topaz-sharpen": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Topaz deblurring and sharpening at source resolution.",
+    endpoint: "topaz/sharpen/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Sharpen",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/sharpen/image",
+    task: "image sharpening"
+  },
+  "topaz-transparent": {
+    category: "restoration",
+    description: "Topaz upscaling that preserves the alpha channel end to end.",
+    endpoint: "topaz/upscale/image/transparent",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Topaz Transparent Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.08 / 24 },
+    pricing: "$0.08 per 24 output megapixels",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/topaz/upscale/image/transparent",
+    task: "transparent image upscaling"
+  },
+  "topaz-video": {
+    category: "upscale",
+    defaultOptions: {
+      model: "Proteus",
+      upscale_factor: 2
+    },
+    description: "Professional Topaz video enhancement and upscaling.",
+    endpoint: "fal-ai/topaz/upscale/video",
+    inputField: "video_url",
+    inputKind: "video",
+    name: "Topaz Video Upscale",
+    outputKeys: ["video"],
+    price: { kind: "second", usd: 0.01 },
+    pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video",
+    task: "video enhancement"
+  }
+};
+
+// src/tool-registry/editing.ts
+var EDITING_TOOLS = {
+  "bria-eraser": {
+    category: "erase",
+    description: "Commercial-safe removal of a masked region, inpainted from surrounding context.",
+    endpoint: "fal-ai/bria/eraser",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Bria Eraser",
+    outputKeys: ["image"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/generation",
+    sourceUrl: "https://fal.ai/models/fal-ai/bria/eraser",
+    task: "masked object erasure"
+  },
+  "bria-expand": {
+    category: "reframe",
+    description: "Expand an image onto a larger canvas, generating the new border area.",
+    endpoint: "fal-ai/bria/expand",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Bria Image Expansion",
+    outputKeys: ["image"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/generation",
+    sourceUrl: "https://fal.ai/models/fal-ai/bria/expand",
+    task: "image outpainting"
+  },
+  "bria-genfill": {
+    category: "erase",
+    description: "Generative fill of a masked region from a prompt, commercial-safe.",
+    endpoint: "fal-ai/bria/genfill",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Bria GenFill",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/generation",
+    sourceUrl: "https://fal.ai/models/fal-ai/bria/genfill",
+    task: "masked generative fill"
+  },
+  "finegrain-eraser": {
+    category: "erase",
+    description: "Remove a prompted object and its shadows and reflections, filling the gap.",
+    endpoint: "fal-ai/finegrain-eraser",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Finegrain Object Eraser",
+    outputKeys: ["image"],
+    price: { kind: "call", usd: 0.27 },
+    pricing: "$0.27/image at the default standard mode; $0.18 express, $0.36 premium",
+    sourceUrl: "https://fal.ai/models/fal-ai/finegrain-eraser",
+    task: "prompted object erasure"
+  },
+  "flux-outpaint": {
+    category: "reframe",
+    description: "Outpaint an image by a per-edge pixel expansion with FLUX.2 pro.",
+    endpoint: "fal-ai/flux-2-pro/outpaint",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "FLUX.2 Pro Outpaint",
+    outputKeys: ["images"],
+    price: { kind: "metered" },
+    pricing: "$0.03 for the first output megapixel, then $0.015 per extra megapixel of input and output, rounded up",
+    sourceUrl: "https://fal.ai/models/fal-ai/flux-2-pro/outpaint",
+    task: "image outpainting"
+  },
+  "iclight-v2": {
+    category: "relight",
+    description: "Relight a subject from a prompt, harmonising it with a new light direction.",
+    endpoint: "fal-ai/iclight-v2",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "IC-Light v2",
+    outputKeys: ["images"],
+    price: { kind: "megapixel", usd: 0.1 },
+    pricing: "$0.10/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/iclight-v2",
+    task: "prompted relighting"
+  },
+  "ideogram-reframe": {
+    category: "reframe",
+    description: "Reframe an image to a new aspect ratio, generating the fill.",
+    endpoint: "fal-ai/ideogram/v3/reframe",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Ideogram v3 Reframe",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.06 },
+    pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality",
+    sourceUrl: "https://fal.ai/models/fal-ai/ideogram/v3/reframe",
+    task: "aspect ratio reframing"
+  },
+  "lighting-restoration": {
+    category: "relight",
+    description: "Restore natural, even lighting across one or more input images.",
+    endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration",
+    inputField: "image_urls",
+    inputKind: "images",
+    name: "Qwen Lighting Restoration",
+    outputKeys: ["images"],
+    price: { kind: "megapixel", usd: 0.035 },
+    pricing: "$0.035/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/lighting-restoration",
+    task: "lighting restoration"
+  },
+  "object-removal": {
+    category: "erase",
+    description: "Remove a prompted object from an image and fill the gap.",
+    endpoint: "fal-ai/object-removal",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Object Removal",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.024 },
+    pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high",
+    sourceUrl: "https://fal.ai/models/fal-ai/object-removal",
+    task: "prompted object removal"
+  },
+  "object-removal-bbox": {
+    category: "erase",
+    description: "Remove whatever falls inside supplied bounding boxes.",
+    endpoint: "fal-ai/object-removal/bbox",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Object Removal by Box",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.024 },
+    pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high",
+    sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox",
+    task: "bounding box object removal"
+  },
+  "object-removal-mask": {
+    category: "erase",
+    description: "Remove the masked region of an image and fill the gap.",
+    endpoint: "fal-ai/object-removal/mask",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Object Removal by Mask",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.024 },
+    pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high",
+    sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask",
+    task: "masked object removal"
+  },
+  "remove-lighting": {
+    category: "relight",
+    description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.",
+    endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting",
+    inputField: "image_urls",
+    inputKind: "images",
+    name: "Qwen Remove Lighting",
+    outputKeys: ["images"],
+    price: { kind: "megapixel", usd: 0.035 },
+    pricing: "$0.035/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting",
+    task: "lighting removal"
+  },
+  "smart-resize": {
+    category: "reframe",
+    description: "Resize one image to several target sizes, recomposing rather than cropping.",
+    endpoint: "fal-ai/smart-resize",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Smart Resize",
+    outputKeys: ["images", "results"],
+    price: { kind: "metered" },
+    pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/smart-resize",
+    task: "multi-size recomposition"
+  },
+  "text-removal": {
+    category: "erase",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Remove all rendered text from an image, rebuilding what sat behind it.",
+    endpoint: "fal-ai/image-editing/text-removal",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Text Removal",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/image",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal",
+    task: "text removal"
+  }
+};
+
+// src/tool-registry/structure.ts
+var STRUCTURE_TOOLS = {
+  "depth-anything": {
+    category: "preprocess",
+    description: "Generate Depth Anything v2 depth maps from input images.",
+    endpoint: "fal-ai/image-preprocessors/depth-anything/v2",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Depth Anything v2 Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2",
+    task: "depth preprocessing"
+  },
+  dwpose: {
+    category: "preprocess",
+    description: "Extract body, hand, and face pose skeletons from an image.",
+    endpoint: "fal-ai/dwpose",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "DWPose Estimation",
+    outputKeys: ["image"],
+    price: { kind: "second", usd: 6e-4 },
+    pricing: "$0.0006/compute-second",
+    sourceUrl: "https://fal.ai/models/fal-ai/dwpose",
+    task: "pose preprocessing"
+  },
+  hed: {
+    category: "preprocess",
+    description: "Generate HED soft edge maps for ControlNet-style workflows.",
+    endpoint: "fal-ai/image-preprocessors/hed",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "HED Edge Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed",
+    task: "edge preprocessing"
+  },
+  lineart: {
+    category: "preprocess",
+    defaultOptions: {
+      coarse: false
+    },
+    description: "Generate line art/control-style edges from an input image.",
+    endpoint: "fal-ai/image-preprocessors/lineart",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Line Art Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart",
+    task: "image preprocessing"
+  },
+  "marigold-depth": {
+    category: "depth",
+    defaultOptions: {
+      ensemble_size: 10,
+      num_inference_steps: 10
+    },
+    description: "Create depth maps using Marigold depth estimation.",
+    endpoint: "fal-ai/imageutils/marigold-depth",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Marigold Depth Estimation",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth",
+    task: "depth map"
+  },
+  "midas-depth": {
+    category: "depth",
+    defaultOptions: {
+      a: Math.PI * 2,
+      bg_th: 0.1
+    },
+    description: "Create MiDaS depth maps from input images.",
     endpoint: "fal-ai/imageutils/depth",
     inputField: "image_url",
     inputKind: "image",
     name: "MiDaS Depth Estimation",
     outputKeys: ["image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
     sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth",
     task: "depth map"
@@ -1041,36 +1951,36 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "MiDaS Preprocessor",
     outputKeys: ["depth_map", "normal_map"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
     sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas",
     task: "depth and normal preprocessing"
   },
-  nsfw: {
-    category: "moderation",
-    description: "Predict whether one or more images contain NSFW concepts.",
-    endpoint: "fal-ai/x-ailab/nsfw",
-    inputField: "image_urls",
-    inputKind: "images",
-    name: "NSFW Checker",
-    outputKeys: ["has_nsfw_concepts"],
-    pricing: "$0.001/image",
-    sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw",
-    task: "vision moderation"
+  mlsd: {
+    category: "preprocess",
+    description: "Detect straight line segments for architectural and interior control maps.",
+    endpoint: "fal-ai/image-preprocessors/mlsd",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "M-LSD Line Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd",
+    task: "line segment preprocessing"
   },
-  rembg: {
-    category: "background",
-    defaultOptions: {
-      crop_to_bbox: false
-    },
-    description: "Generic image background removal utility.",
-    endpoint: "fal-ai/imageutils/rembg",
+  pidi: {
+    category: "preprocess",
+    description: "Generate PiDiNet soft edge maps from an input image.",
+    endpoint: "fal-ai/image-preprocessors/pidi",
     inputField: "image_url",
     inputKind: "image",
-    name: "Remove Background",
+    name: "PiDiNet Edge Preprocessor",
     outputKeys: ["image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
-    sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg",
-    task: "image background removal"
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi",
+    task: "edge preprocessing"
   },
   "sam-preprocessor": {
     category: "preprocess",
@@ -1080,6 +1990,7 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "SAM Preprocessor",
     outputKeys: ["image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
     sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam",
     task: "segmentation preprocessing"
@@ -1099,7 +2010,9 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "SAM 2 Auto Segment",
     outputKeys: ["combined_mask", "individual_masks"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
+    queued: true,
     sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment",
     task: "automatic image segmentation"
   },
@@ -1116,7 +2029,8 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "SAM 3.1 Image",
     outputKeys: ["image", "masks", "metadata", "scores", "boxes"],
-    pricing: "$0.005/request",
+    price: { kind: "call", usd: 0.01 },
+    pricing: "$0.01/request",
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/image",
     task: "promptable image segmentation"
   },
@@ -1132,61 +2046,12 @@ var FAL_TOOLS = {
     inputKind: "video",
     name: "SAM 3.1 Video",
     outputKeys: ["video", "boundingbox_frames_zip"],
-    pricing: "fal pricing varies by frame count",
+    price: { kind: "metered" },
+    pricing: "$0.01/16 frames of video input",
+    queued: true,
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video",
     task: "multi-object video segmentation"
   },
-  "sam3-3d-align": {
-    category: "3d",
-    description: "Align SAM 3D objects and bodies into a shared scene.",
-    endpoint: "fal-ai/sam-3/3d-align",
-    inputField: "image_url",
-    inputKind: "image",
-    name: "SAM 3D Align",
-    outputKeys: ["scene_glb", "metadata", "artifacts_zip"],
-    pricing: "fal pricing varies by scene",
-    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-align",
-    task: "3D scene alignment"
-  },
-  "sam3-3d-body": {
-    category: "3d",
-    defaultOptions: {
-      export_meshes: true,
-      include_3d_keypoints: true,
-      include_mhr_params: true
-    },
-    description: "Reconstruct human body meshes and keypoints from a single image.",
-    endpoint: "fal-ai/sam-3/3d-body",
-    inputField: "image_url",
-    inputKind: "image",
-    name: "SAM 3D Body",
-    outputKeys: ["model_glb", "visualization", "meshes", "metadata"],
-    pricing: "$0.015/inference",
-    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-body",
-    task: "single-image 3D body reconstruction"
-  },
-  "sam3-3d-objects": {
-    category: "3d",
-    defaultOptions: {
-      prompt: "car"
-    },
-    description: "Reconstruct one or more 3D objects from an image and prompts.",
-    endpoint: "fal-ai/sam-3/3d-objects",
-    inputField: "image_url",
-    inputKind: "image",
-    name: "SAM 3D Objects",
-    outputKeys: [
-      "gaussian_splat",
-      "model_glb",
-      "metadata",
-      "individual_splats",
-      "individual_glbs",
-      "artifacts_zip"
-    ],
-    pricing: "$0.02/generation",
-    sourceUrl: "https://fal.ai/models/fal-ai/sam-3/3d-objects",
-    task: "single-image 3D object reconstruction"
-  },
   "sam3-image": {
     category: "segmentation",
     defaultOptions: {
@@ -1200,6 +2065,7 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "SAM 3 Image",
     outputKeys: ["image", "masks", "metadata", "scores", "boxes"],
+    price: { kind: "call", usd: 5e-3 },
     pricing: "$0.005/request",
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image",
     task: "promptable image segmentation"
@@ -1215,7 +2081,8 @@ var FAL_TOOLS = {
     inputField: "image_url",
     inputKind: "image",
     name: "SAM 3 Image RLE",
-    outputKeys: ["rle_masks", "metadata", "scores", "boxes"],
+    outputKeys: ["rle", "scores", "boxes", "metadata"],
+    price: { kind: "call", usd: 5e-3 },
     pricing: "$0.005/request",
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3/image-rle",
     task: "promptable image segmentation to RLE"
@@ -1234,7 +2101,9 @@ var FAL_TOOLS = {
     inputKind: "video",
     name: "SAM 3 Video",
     outputKeys: ["video", "boundingbox_frames_zip"],
-    pricing: "$0.005/16 frames",
+    price: { kind: "metered" },
+    pricing: "$0.005/16 frames of video input",
+    queued: true,
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video",
     task: "promptable video segmentation"
   },
@@ -1250,65 +2119,68 @@ var FAL_TOOLS = {
     inputField: "video_url",
     inputKind: "video",
     name: "SAM 3 Video RLE",
-    outputKeys: ["rle_masks", "metadata"],
-    pricing: "$0.005/16 frames",
+    // fal's video-rle endpoint no longer returns RLE data: its Output schema is
+    // now identical to sam3-video's, so this entry differs only by endpoint.
+    outputKeys: ["video", "boundingbox_frames_zip"],
+    price: { kind: "metered" },
+    pricing: "$0.005/16 frames of video",
+    queued: true,
     sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle",
     task: "promptable video segmentation to RLE"
   },
-  "topaz-image": {
-    category: "upscale",
-    defaultOptions: {
-      model: "Standard V2",
-      output_format: "jpeg",
-      upscale_factor: 2
-    },
-    description: "Professional Topaz image enhancement and upscaling.",
-    endpoint: "fal-ai/topaz/upscale/image",
+  scribble: {
+    category: "preprocess",
+    description: "Turn an image into a scribble-style control map.",
+    endpoint: "fal-ai/image-preprocessors/scribble",
     inputField: "image_url",
     inputKind: "image",
-    name: "Topaz Image Upscale",
+    name: "Scribble Preprocessor",
     outputKeys: ["image"],
-    pricing: "$0.08+ by output megapixels",
-    sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/image",
-    task: "image enhancement"
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble",
+    task: "scribble preprocessing"
   },
-  "topaz-video": {
-    category: "upscale",
-    defaultOptions: {
-      model: "Proteus",
-      upscale_factor: 2
-    },
-    description: "Professional Topaz video enhancement and upscaling.",
-    endpoint: "fal-ai/topaz/upscale/video",
-    inputField: "video_url",
-    inputKind: "video",
-    name: "Topaz Video Upscale",
-    outputKeys: ["video"],
-    pricing: "$0.01-$0.08/sec by output resolution",
-    sourceUrl: "https://fal.ai/models/fal-ai/topaz/upscale/video",
-    task: "video enhancement"
+  teed: {
+    category: "preprocess",
+    description: "Generate TEED edge maps from an input image.",
+    endpoint: "fal-ai/image-preprocessors/teed",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "TEED Edge Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed",
+    task: "edge preprocessing"
+  },
+  "zoe-depth": {
+    category: "preprocess",
+    description: "Generate ZoeDepth metric depth maps from an input image.",
+    endpoint: "fal-ai/image-preprocessors/zoe",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "ZoeDepth Preprocessor",
+    outputKeys: ["image"],
+    price: { kind: "metered" },
+    pricing: "$0/compute-second listed by fal",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe",
+    task: "depth preprocessing"
   }
 };
+
+// src/tools.ts
+var FAL_TOOLS = {
+  ...ANALYSIS_TOOLS,
+  ...ASSET_TOOLS,
+  ...BACKGROUND_TOOLS,
+  ...EDITING_TOOLS,
+  ...STRUCTURE_TOOLS
+};
 var FAL_TOOL_IDS = Object.keys(
   FAL_TOOLS
 );
 
-// src/server.ts
-var MotifError = class extends Error {
-  status;
-  code;
-  /** 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. */
-  requestId;
-  constructor(message, status, code, requestId) {
-    super(message);
-    this.name = "MotifError";
-    this.status = status;
-    this.code = code;
-    this.requestId = requestId;
-  }
-};
-
 // src/image/fal.ts
 import { createFal } from "@ai-sdk/fal";
 var FAL_FLUX_MODEL = "fal-ai/flux-pro/v1.1-ultra";
@@ -1588,9 +2460,9 @@ function createMotifImage(config = {}, deps = {}) {
         ...opts.headers === void 0 ? {} : { headers: opts.headers },
         ...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
       });
-      return ok2(toMotifImageResult(result, provider, modelId));
+      return ok3(toMotifImageResult(result, provider, modelId));
     } catch (error) {
-      return err2(toMotifError(error));
+      return err3(toMotifError2(error));
     }
   }
   async function edit(opts) {
@@ -1611,9 +2483,9 @@ function createMotifImage(config = {}, deps = {}) {
         ...opts.headers === void 0 ? {} : { headers: opts.headers },
         ...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
       });
-      return ok2(toMotifImageResult(result, provider, modelId));
+      return ok3(toMotifImageResult(result, provider, modelId));
     } catch (error) {
-      return err2(toMotifError(error));
+      return err3(toMotifError2(error));
     }
   }
   async function bestOfN(opts) {
@@ -1635,19 +2507,19 @@ async function runCandidate(opts, index, generate, edit) {
 async function selectWinner(opts, candidates) {
   const { judge } = opts;
   if (judge === void 0) {
-    return ok2({ chosenIndex: 0 });
+    return ok3({ chosenIndex: 0 });
   }
   const context = "images" in opts ? { instruction: opts.instruction } : { prompt: opts.prompt };
   const decision = await judge(candidates, context);
   if (!Number.isInteger(decision.index) || decision.index < 0 || decision.index >= candidates.length) {
-    return err2(
+    return err3(
       new MotifError(
         `bestOfN judge returned an out-of-range index ${decision.index} (expected 0..${candidates.length - 1})`,
         0
       )
     );
   }
-  return ok2({
+  return ok3({
     chosenIndex: decision.index,
     ...decision.reason === void 0 ? {} : { reason: decision.reason }
   });
@@ -1656,7 +2528,7 @@ async function runBestOfN(opts, generate, edit) {
   try {
     const { n } = opts;
     if (!Number.isInteger(n) || n < 1) {
-      return err2(
+      return err3(
         new MotifError(`bestOfN requires an integer n >= 1 (got ${n})`, 0)
       );
     }
@@ -1675,23 +2547,23 @@ async function runBestOfN(opts, generate, edit) {
       }
     }
     if (candidates.length === 0) {
-      return err2(
+      return err3(
         firstError ?? new MotifError(`all ${n} bestOfN candidates failed`, 0)
       );
     }
     const winner = await selectWinner(opts, candidates);
     if (winner.isErr()) {
-      return err2(winner.error);
+      return err3(winner.error);
     }
     const { chosenIndex, reason } = winner.value;
     const best = candidates[chosenIndex];
     if (best === void 0) {
-      return err2(new MotifError("bestOfN failed to resolve a winner", 0));
+      return err3(new MotifError("bestOfN failed to resolve a winner", 0));
     }
     const totalCostUsd = Number(
       candidates.reduce((sum, candidate) => sum + candidate.cost.usd, 0).toFixed(6)
     );
-    return ok2({
+    return ok3({
       best,
       chosenIndex,
       ...reason === void 0 ? {} : { reason },
@@ -1699,7 +2571,7 @@ async function runBestOfN(opts, generate, edit) {
       totalCostUsd
     });
   } catch (error) {
-    return err2(toMotifError(error));
+    return err3(toMotifError2(error));
   }
 }
 function defaultResolveModel(provider, modelId, apiKey) {
@@ -1815,7 +2687,7 @@ function toJsonValue(value, path) {
     0
   );
 }
-function toMotifError(error) {
+function toMotifError2(error) {
   if (error instanceof MotifError) {
     return error;
   }