@howells/motif-sdk 1.0.0 → 1.2.0

package/dist/index.cjs

@@ -47,18 +47,18 @@ __export(src_exports, {
   buildFalToolRequest: () => buildFalToolRequest,
   buildGenerateBody: () => buildGenerateBody,
   enrichPrompt: () => enrichPrompt,
-  err: () => import_neverthrow2.err,
+  err: () => import_neverthrow3.err,
   estimateCost: () => estimateCost,
   estimateVideoCost: () => estimateVideoCost,
   getFalKeyFromEnv: () => getFalKeyFromEnv,
   isFalToolId: () => isFalToolId,
   motifEnvSchema: () => motifEnvSchema,
-  ok: () => import_neverthrow2.ok,
+  ok: () => import_neverthrow3.ok,
   parseMotifEnv: () => parseMotifEnv,
   sanitizePrompt: () => sanitizePrompt
 });
 module.exports = __toCommonJS(src_exports);
-var import_neverthrow2 = require("neverthrow");
+var import_neverthrow3 = require("neverthrow");
 
 // src/aspects.ts
 var ASPECT_RATIOS = [
@@ -158,22 +158,23 @@ var FORMAT_PRESETS = {
 };
 
 // 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, pricePer1k: 211, rank: 3 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1337, pricePer1k: 211, rank: 1, winRate: 0.8 }
+        textToImage: { elo: 1369, pricePer1k: 211, rank: 1 }
       },
       speed: {
         medianSeconds: 200.7,
@@ -213,10 +214,10 @@ var MODELS = {
   gpt: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1262, pricePer1k: 133, rank: 2, winRate: 0.69 },
+        editing: { elo: 1250, pricePer1k: 133, rank: 5 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1268, pricePer1k: 133, rank: 2, winRate: 0.73 }
+        textToImage: { elo: 1310, pricePer1k: 133, rank: 4 }
       },
       speed: {
         medianSeconds: 34.6,
@@ -256,10 +257,10 @@ var MODELS = {
   banana2: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1231, pricePer1k: 67, rank: 5, winRate: 0.63 },
+        editing: { elo: 1249, pricePer1k: 67, rank: 7 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1263, pricePer1k: 67, rank: 3, winRate: 0.71 }
+        textToImage: { elo: 1320, pricePer1k: 67, rank: 3 }
       },
       tiers: { price: "premium", quality: "frontier", speed: "unknown" },
       useCase: "Best balance of quality, edit support, web search, and cost"
@@ -297,10 +298,10 @@ var MODELS = {
   banana: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1241, pricePer1k: 134, rank: 4, winRate: 0.65 },
+        editing: { elo: 1245, pricePer1k: 134, rank: 9 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1220, pricePer1k: 134, rank: 5, winRate: 0.66 }
+        textToImage: { elo: 1297, pricePer1k: 134, rank: 6 }
       },
       speed: {
         medianSeconds: 19.2,
@@ -340,6 +341,13 @@ var MODELS = {
     type: "generation"
   },
   gemini: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1180, pricePer1k: 39, 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: {
@@ -367,6 +375,14 @@ var MODELS = {
     type: "generation"
   },
   gemini3: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1245, pricePer1k: 134, rank: 9 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1297, pricePer1k: 134, rank: 6 }
+      }
+    },
     editEndpoint: "fal-ai/gemini-3-pro-image-preview/edit",
     endpoint: "fal-ai/gemini-3-pro-image-preview",
     falPricing: {
@@ -397,10 +413,10 @@ var MODELS = {
   seedream4: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 30, rank: 16, winRate: 0.61 },
+        editing: { elo: 1185, pricePer1k: 30, rank: 28 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1198, pricePer1k: 30, rank: 6, winRate: 0.59 }
+        textToImage: { elo: 1226, pricePer1k: 30, rank: 16 }
       },
       speed: {
         medianSeconds: 14.3,
@@ -437,10 +453,10 @@ var MODELS = {
   seedream45: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 40, rank: 17, winRate: 0.58 },
+        editing: { elo: 1186, pricePer1k: 40, rank: 26 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1167, pricePer1k: 40, rank: 17, winRate: 0.63 }
+        textToImage: { elo: 1203, pricePer1k: 40, rank: 32 }
       },
       speed: {
         medianSeconds: 18.2,
@@ -475,6 +491,14 @@ var MODELS = {
     type: "generation"
   },
   seedream5: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1248, pricePer1k: 90, rank: 8 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1279, pricePer1k: 90, rank: 10 }
+      }
+    },
     name: "Seedream 5.0 Pro",
     endpoint: "bytedance/seedream/v5/pro/text-to-image",
     editEndpoint: "bytedance/seedream/v5/pro/edit",
@@ -501,6 +525,13 @@ var MODELS = {
     maxReferenceImages: 10
   },
   "seedream5-lite": {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1169, pricePer1k: 35, 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",
@@ -529,10 +560,10 @@ var MODELS = {
   "flux2-max": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1206, pricePer1k: 140, rank: 10, winRate: 0.6 },
+        editing: { elo: 1201, pricePer1k: 140, rank: 19 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1197, pricePer1k: 70, rank: 8, winRate: 0.67 }
+        textToImage: { elo: 1225, pricePer1k: 70, rank: 17 }
       },
       speed: {
         medianSeconds: 31.6,
@@ -572,10 +603,10 @@ var MODELS = {
   "flux2-pro": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1170, pricePer1k: 30, rank: 21 },
+        editing: { elo: 1170, pricePer1k: 45, rank: 31 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1186, pricePer1k: 30, rank: 10, winRate: 0.62 }
+        textToImage: { elo: 1207, pricePer1k: 30, rank: 30 }
       },
       speed: {
         medianSeconds: 16.1,
@@ -615,10 +646,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, pricePer1k: 60, rank: 18 }
       },
       speed: {
         medianSeconds: 15.3,
@@ -662,8 +692,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,
@@ -806,7 +835,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, pricePer1k: 200, rank: 2 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1322, pricePer1k: 200, 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, pricePer1k: 35, rank: 25 }
+      }
+    },
     endpoint: "fal-ai/recraft/v4/text-to-image",
     falPricing: {
       checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -857,6 +934,13 @@ var MODELS = {
     type: "generation"
   },
   ideogram4: {
+    benchmark: {
+      artificialAnalysis: {
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1220, pricePer1k: 60, rank: 19 }
+      }
+    },
     name: "Ideogram V4",
     endpoint: "ideogram/v4",
     type: "generation",
@@ -889,10 +973,10 @@ var MODELS = {
   "grok-image": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1213, pricePer1k: 20, rank: 7, winRate: 0.6 },
+        editing: { elo: 1214, pricePer1k: 20, rank: 16 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1182, pricePer1k: 20, rank: 12, winRate: 0.6 }
+        textToImage: { elo: 1216, pricePer1k: 20, rank: 23 }
       },
       speed: {
         medianSeconds: 5.1,
@@ -930,8 +1014,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,
@@ -964,6 +1047,41 @@ var MODELS = {
     supportsSyncMode: true,
     type: "generation"
   },
+  qwen3: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1218, pricePer1k: 33, rank: 15 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1272, pricePer1k: 30, rank: 11 }
+      },
+      tiers: { price: "budget", quality: "better", speed: "unknown" },
+      useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
+    },
+    endpoint: "fal-ai/qwen-image-3/text-to-image",
+    falPricing: {
+      checkedAt: "2026-08-05",
+      currency: "USD",
+      endpointId: "fal-ai/qwen-image-3/text-to-image",
+      estimatedCostPerImageUsd: 0.02,
+      source: "fal-pricing-api",
+      unit: "megapixels",
+      unitPrice: 0.02
+    },
+    name: "Qwen Image 3",
+    pricePerImageUsd: 0.02,
+    pricing: "$0.02/MP (assumed from qwen v1; fal pricing page bot-gated at check time)",
+    sizeMode: "image_size_enum",
+    supportsAspect: true,
+    supportsEdit: false,
+    supportsNegativePrompt: true,
+    supportsNumImages: true,
+    supportsOutputFormat: true,
+    supportsResolution: false,
+    supportsSafetyChecker: true,
+    supportsSeed: true,
+    type: "generation"
+  },
   // ─── Video Models ─────────────────────────────────────────────
   kling: {
     endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
@@ -1041,7 +1159,8 @@ var GENERATION_MODELS = [
   "ideogram",
   "ideogram4",
   "grok-image",
-  "qwen"
+  "qwen",
+  "qwen3"
 ];
 var EDIT_CAPABLE_MODELS = GENERATION_MODELS.filter(
   (id) => MODELS[id]?.supportsEdit === true
@@ -1362,7 +1481,7 @@ function validateGenerateOptions(options, config, sizeMode, hasEditImages) {
   if (options.background !== void 0 && config.supportsBackground !== true) {
     unsupported(config, "background");
   }
-  if (options.transparent === true && !(config.supportsBackground === true || config.supportsOutputFormat === true)) {
+  if (options.transparent === true && config.supportsBackground !== true) {
     unsupported(config, "transparent output");
   }
   if (options.inputFidelity !== void 0) {
@@ -1644,353 +1763,351 @@ function buildGenerateBody(options) {
 
 // src/leaderboards.ts
 var IMAGE_TEXT_TO_IMAGE_TOP_20 = {
-  capturedAt: "2026-05-12",
+  capturedAt: "2026-08-23",
   entries: [
     {
       apiPricing: "$211/1k images",
       creator: "OpenAI",
-      elo: 1337,
+      elo: 1369,
       isCurrent: true,
       model: "GPT Image 2 (high)",
       rank: 1,
       routableModelId: "gpt2"
     },
     {
-      apiPricing: "$133/1k images",
-      creator: "OpenAI",
-      elo: 1268,
+      apiPricing: "$200/1k images",
+      creator: "Reve",
+      elo: 1322,
       isCurrent: true,
-      model: "GPT Image 1.5 (high)",
+      model: "Reve 2.1",
       rank: 2,
-      routableModelId: "gpt"
+      routableModelId: "reve"
     },
     {
       apiPricing: "$67/1k images",
       creator: "Google",
-      elo: 1263,
+      elo: 1320,
       isCurrent: true,
       model: "Nano Banana 2 (Gemini 3.1 Flash Image Preview)",
       rank: 3,
       routableModelId: "banana2"
     },
     {
-      apiPricing: "$150/1k images",
-      creator: "Sourceful",
-      elo: 1256,
+      apiPricing: "$133/1k images",
+      creator: "OpenAI",
+      elo: 1310,
       isCurrent: true,
-      model: "Riverflow 2.0",
-      rank: 4
+      model: "GPT Image 1.5 (high)",
+      rank: 4,
+      routableModelId: "gpt"
     },
     {
-      apiPricing: "$134/1k images",
-      creator: "Google",
-      elo: 1220,
+      apiPricing: "$48/1k images",
+      creator: "Microsoft AI",
+      elo: 1305,
       isCurrent: true,
-      model: "Nano Banana Pro (Gemini 3 Pro Image)",
-      rank: 5,
-      routableModelId: "banana"
+      model: "MAI-Image-2.5",
+      rank: 5
     },
     {
-      apiPricing: "$30/1k images",
-      creator: "ByteDance Seed",
-      elo: 1198,
+      apiPricing: "$134/1k images",
+      creator: "Google",
+      elo: 1297,
       isCurrent: true,
-      model: "Seedream 4.0",
+      model: "Nano Banana Pro (Gemini 3 Pro Image)",
       rank: 6,
-      routableModelId: "seedream4"
+      routableModelId: "banana"
     },
     {
-      apiPricing: "$50/1k images",
-      creator: "Microsoft",
-      elo: 1198,
+      apiPricing: "$109/1k images",
+      creator: "Microsoft AI",
+      elo: 1293,
       isCurrent: true,
-      model: "MAI-Image-2",
+      model: "MAI-Image-2.5-Pro",
       rank: 7
     },
     {
-      apiPricing: "$70/1k images",
-      creator: "Black Forest Labs",
-      elo: 1197,
+      apiPricing: "$34/1k images",
+      creator: "Google",
+      elo: 1289,
       isCurrent: true,
-      model: "FLUX.2 [max]",
-      rank: 8,
-      routableModelId: "flux2-max"
+      model: "Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)",
+      rank: 8
     },
     {
-      apiPricing: "Unavailable",
-      creator: "Peanut",
-      elo: 1187,
+      apiPricing: "$43/1k images",
+      creator: "Alibaba",
+      elo: 1282,
       isCurrent: true,
-      model: "Peanut (Open Weights Coming Soon)",
+      model: "Qwen-Image-3.0-Pro",
       rank: 9
     },
     {
-      apiPricing: "$30/1k images",
-      creator: "Black Forest Labs",
-      elo: 1186,
+      apiPricing: "$90/1k images",
+      creator: "Bytedance",
+      elo: 1279,
       isCurrent: true,
-      model: "FLUX.2 [pro]",
+      model: "Seedream 5.0 Pro",
       rank: 10,
-      routableModelId: "flux2-pro"
+      routableModelId: "seedream5"
     },
     {
-      apiPricing: "$60/1k images",
-      creator: "Google",
-      elo: 1184,
-      isCurrent: false,
-      model: "Imagen 4 Ultra Preview 0606",
-      rank: 11
+      apiPricing: "$30/1k images",
+      creator: "Alibaba",
+      elo: 1272,
+      isCurrent: true,
+      model: "Qwen-Image-3.0",
+      rank: 11,
+      routableModelId: "qwen3"
     },
     {
-      apiPricing: "$20/1k images",
-      creator: "xAI",
-      elo: 1182,
+      apiPricing: "$75/1k images",
+      creator: "Alibaba",
+      elo: 1237,
       isCurrent: true,
-      model: "grok-imagine-image",
-      rank: 12,
-      routableModelId: "grok-image"
+      model: "Qwen Image 2.0 Pro",
+      rank: 12
     },
     {
-      apiPricing: "$60/1k images",
-      creator: "Black Forest Labs",
-      elo: 1182,
+      apiPricing: "$50/1k images",
+      creator: "SpaceXAI",
+      elo: 1234,
       isCurrent: true,
-      model: "FLUX.2 [flex]",
-      rank: 13,
-      routableModelId: "flux2-flex"
+      model: "grok-imagine-image-quality",
+      rank: 13
     },
     {
-      apiPricing: "$30/1k images",
-      creator: "ImagineArt",
-      elo: 1181,
+      apiPricing: "$20/1k images",
+      creator: "Microsoft AI",
+      elo: 1228,
       isCurrent: true,
-      model: "ImagineArt 2.0",
+      model: "MAI-Image-2.5-Flash",
       rank: 14
     },
     {
-      apiPricing: "$60/1k images",
-      creator: "Google",
-      elo: 1171,
+      apiPricing: "$80/1k images",
+      creator: "HiDream",
+      elo: 1228,
       isCurrent: true,
-      model: "Imagen 4 Ultra",
+      model: "HiDream-O1-Image-1.5",
       rank: 15
     },
     {
-      apiPricing: "$40/1k images",
-      creator: "Google",
-      elo: 1169,
-      isCurrent: false,
-      model: "Imagen 4 Preview 0606",
-      rank: 16
+      apiPricing: "$30/1k images",
+      creator: "ByteDance Seed",
+      elo: 1226,
+      isCurrent: true,
+      model: "Seedream 4.0",
+      rank: 16,
+      routableModelId: "seedream4"
     },
     {
-      apiPricing: "$40/1k images",
-      creator: "ByteDance Seed",
-      elo: 1167,
+      apiPricing: "$70/1k images",
+      creator: "Black Forest Labs",
+      elo: 1225,
       isCurrent: true,
-      model: "Seedream 4.5",
+      model: "FLUX.2 [max]",
       rank: 17,
-      routableModelId: "seedream45"
+      routableModelId: "flux2-max"
     },
     {
-      apiPricing: "$8/1k images",
-      creator: "Fal",
-      elo: 1161,
+      apiPricing: "$60/1k images",
+      creator: "Black Forest Labs",
+      elo: 1223,
       isCurrent: true,
-      model: "FLUX.2 [dev] Turbo",
-      rank: 18
+      model: "FLUX.2 [flex]",
+      rank: 18,
+      routableModelId: "flux2-flex"
     },
     {
-      apiPricing: "$12/1k images",
-      creator: "Black Forest Labs",
-      elo: 1160,
+      apiPricing: "$60/1k images",
+      creator: "Ideogram",
+      elo: 1220,
       isCurrent: true,
-      model: "FLUX.2 [dev]",
+      model: "Ideogram 4.0",
       rank: 19,
-      routableModelId: "flux2-dev"
+      routableModelId: "ideogram4"
     },
     {
-      apiPricing: "$20/1k images",
-      creator: "Alibaba",
-      elo: 1158,
+      apiPricing: "$60/1k images",
+      creator: "Krea",
+      elo: 1220,
       isCurrent: true,
-      model: "Qwen Image Max 2512",
-      rank: 20,
-      routableModelId: "qwen"
+      model: "Krea 2 Large",
+      rank: 20
     }
   ],
   source: "https://artificialanalysis.ai/image/leaderboard/text-to-image"
 };
 var IMAGE_EDITING_TOP_20 = {
-  capturedAt: "2026-05-12",
+  capturedAt: "2026-08-23",
   entries: [
     {
-      apiPricing: "$150/1k images",
-      creator: "Sourceful",
-      elo: 1286,
+      apiPricing: "$109/1k images",
+      creator: "Microsoft AI",
+      elo: 1272,
       isCurrent: true,
-      model: "Riverflow 2.0",
+      model: "MAI-Image-2.5-Pro",
       rank: 1
     },
     {
-      apiPricing: "$133/1k images",
-      creator: "OpenAI",
-      elo: 1262,
+      apiPricing: "$200/1k images",
+      creator: "Reve",
+      elo: 1263,
       isCurrent: true,
-      model: "GPT Image 1.5 (high)",
+      model: "Reve 2.1",
       rank: 2,
-      routableModelId: "gpt"
+      routableModelId: "reve"
     },
     {
       apiPricing: "$211/1k images",
       creator: "OpenAI",
-      elo: 1249,
+      elo: 1256,
       isCurrent: true,
       model: "GPT Image 2 (high)",
       rank: 3,
       routableModelId: "gpt2"
     },
     {
-      apiPricing: "$134/1k images",
-      creator: "Google",
-      elo: 1241,
+      apiPricing: "$48/1k images",
+      creator: "Microsoft AI",
+      elo: 1256,
       isCurrent: true,
-      model: "Nano Banana Pro (Gemini 3 Pro Image)",
-      rank: 4,
-      routableModelId: "banana"
+      model: "MAI-Image-2.5",
+      rank: 4
     },
     {
-      apiPricing: "$67/1k images",
-      creator: "Google",
-      elo: 1231,
+      apiPricing: "$133/1k images",
+      creator: "OpenAI",
+      elo: 1250,
       isCurrent: true,
-      model: "Nano Banana 2 (Gemini 3.1 Flash Image Preview)",
+      model: "GPT Image 1.5 (high)",
       rank: 5,
-      routableModelId: "banana2"
+      routableModelId: "gpt"
     },
     {
-      apiPricing: "$90/1k images",
-      creator: "Tencent",
-      elo: 1222,
+      apiPricing: "$43/1k images",
+      creator: "Alibaba",
+      elo: 1250,
       isCurrent: true,
-      model: "HunyuanImage 3.0 Instruct (Fal)",
+      model: "Qwen-Image-3.0-Pro",
       rank: 6
     },
     {
-      apiPricing: "$20/1k images",
-      creator: "xAI",
-      elo: 1213,
+      apiPricing: "$67/1k images",
+      creator: "Google",
+      elo: 1249,
       isCurrent: true,
-      model: "grok-imagine-image",
+      model: "Nano Banana 2 (Gemini 3.1 Flash Image Preview)",
       rank: 7,
-      routableModelId: "grok-image"
+      routableModelId: "banana2"
     },
     {
-      apiPricing: "$70/1k images",
-      creator: "xAI",
-      elo: 1212,
+      apiPricing: "$90/1k images",
+      creator: "Bytedance",
+      elo: 1248,
       isCurrent: true,
-      model: "grok-imagine-image-pro",
-      rank: 8
+      model: "Seedream 5.0 Pro",
+      rank: 8,
+      routableModelId: "seedream5"
     },
     {
-      apiPricing: "Unavailable",
-      creator: "KlingAI",
-      elo: 1207,
+      apiPricing: "$134/1k images",
+      creator: "Google",
+      elo: 1245,
       isCurrent: true,
-      model: "Kling Image 3.0 Omni",
-      rank: 9
+      model: "Nano Banana Pro (Gemini 3 Pro Image)",
+      rank: 9,
+      routableModelId: "banana"
     },
     {
-      apiPricing: "$140/1k images",
-      creator: "Black Forest Labs",
-      elo: 1206,
+      apiPricing: "$20/1k images",
+      creator: "Microsoft AI",
+      elo: 1236,
       isCurrent: true,
-      model: "FLUX.2 [max]",
-      rank: 10,
-      routableModelId: "flux2-max"
+      model: "MAI-Image-2.5-Flash",
+      rank: 10
     },
     {
-      apiPricing: "Unavailable",
-      creator: "Alibaba",
-      elo: 1200,
+      apiPricing: "$50/1k images",
+      creator: "SpaceXAI",
+      elo: 1226,
       isCurrent: true,
-      model: "Wan 2.7 Pro",
+      model: "grok-imagine-image-quality",
       rank: 11
     },
     {
-      apiPricing: "$28/1k images",
-      creator: "KlingAI",
-      elo: 1196,
+      apiPricing: "$90/1k images",
+      creator: "Tencent",
+      elo: 1222,
       isCurrent: true,
-      model: "Kling Image 3.0",
+      model: "HunyuanImage 3.0 Instruct",
       rank: 12
     },
     {
-      apiPricing: "$28/1k images",
-      creator: "KlingAI",
-      elo: 1193,
+      apiPricing: "$80/1k images",
+      creator: "Newport AI",
+      elo: 1220,
       isCurrent: true,
-      model: "Kling Image O1",
+      model: "DreamImage 2.0",
       rank: 13
     },
     {
-      apiPricing: "$30/1k images",
-      creator: "Alibaba",
-      elo: 1188,
+      apiPricing: "$100/1k images",
+      creator: "Luma Labs",
+      elo: 1219,
       isCurrent: true,
-      model: "Wan 2.6 Image",
+      model: "Luma UNI 1 Max",
       rank: 14
     },
     {
-      apiPricing: "$66/1k images",
-      creator: "Sourceful",
-      elo: 1184,
+      apiPricing: "$33/1k images",
+      creator: "Alibaba",
+      elo: 1218,
       isCurrent: true,
-      model: "Riverflow 1",
-      rank: 15
+      model: "Qwen-Image-3.0",
+      rank: 15,
+      routableModelId: "qwen3"
     },
     {
-      apiPricing: "$30/1k images",
-      creator: "ByteDance Seed",
-      elo: 1184,
-      isCurrent: true,
-      model: "Seedream 4.0",
+      apiPricing: "$20/1k images",
+      creator: "SpaceXAI",
+      elo: 1214,
+      isCurrent: true,
+      model: "grok-imagine-image",
       rank: 16,
-      routableModelId: "seedream4"
+      routableModelId: "grok-image"
     },
     {
-      apiPricing: "$40/1k images",
-      creator: "ByteDance Seed",
-      elo: 1184,
+      apiPricing: "$28/1k images",
+      creator: "KlingAI",
+      elo: 1208,
       isCurrent: true,
-      model: "Seedream 4.5",
-      rank: 17,
-      routableModelId: "seedream45"
+      model: "Kling Image 3.0 Omni",
+      rank: 17
     },
     {
-      apiPricing: "$26/1k images",
-      creator: "Alibaba",
-      elo: 1181,
+      apiPricing: "$34/1k images",
+      creator: "Google",
+      elo: 1202,
       isCurrent: true,
-      model: "Wan 2.7",
+      model: "Nano Banana 2 Lite",
       rank: 18
     },
     {
-      apiPricing: "$39/1k images",
-      creator: "Google",
-      elo: 1173,
+      apiPricing: "$140/1k images",
+      creator: "Black Forest Labs",
+      elo: 1201,
       isCurrent: true,
-      model: "Nano Banana (Gemini 2.5 Flash Image)",
+      model: "FLUX.2 [max]",
       rank: 19,
-      routableModelId: "gemini"
+      routableModelId: "flux2-max"
     },
     {
-      apiPricing: "$40/1k images",
-      creator: "Reve",
-      elo: 1172,
+      creator: "Alibaba",
+      elo: 1200,
       isCurrent: true,
-      model: "Reve V1 (December)",
+      model: "Wan 2.7 Pro",
       rank: 20
     }
   ],
@@ -2220,7 +2337,31 @@ var VIDEO_IMAGE_TO_VIDEO_TOP_15 = {
 };
 
 // src/server.ts
-var import_neverthrow = require("neverthrow");
+var import_neverthrow2 = require("neverthrow");
+
+// 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;
+  }
+};
+function toMotifError(error) {
+  if (error instanceof MotifError) {
+    return error;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
+  return new MotifError(message, 0, code);
+}
 
 // src/fal-parse.ts
 function isRecord(value) {
@@ -2318,9 +2459,362 @@ function requestIdFromBody(text) {
   return asString(parsed.request_id) ?? asString(parsed.requestId) ?? asString(parsed.trace_id);
 }
 
-// src/tools.ts
-var FAL_EXPLORE_CHECKED_AT = "2026-05-12";
-var FAL_TOOLS = {
+// src/server-tools.ts
+var import_neverthrow = require("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"],
+    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: {
@@ -2333,41 +2827,455 @@ var FAL_TOOLS = {
     endpoint: "fal-ai/birefnet/v2",
     inputField: "image_url",
     inputKind: "image",
-    name: "BirefNet Background Removal",
-    outputKeys: ["image", "mask_image"],
-    pricing: "$0/compute-second listed by fal",
-    sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2",
-    task: "image background removal"
+    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"
+  },
+  "bria-rmbg": {
+    category: "background",
+    description: "Commercial-safe background removal for images.",
+    endpoint: "fal-ai/bria/background/remove",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Bria RMBG 2.0",
+    outputKeys: ["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"
+  },
+  "bria-video-rmbg": {
+    category: "background",
+    defaultOptions: {
+      background_color: "Black",
+      output_container_and_codec: "webm_vp9",
+      preserve_audio: true
+    },
+    description: "Remove video backgrounds with configurable output container.",
+    endpoint: "bria/video/background-removal",
+    inputField: "video_url",
+    inputKind: "video",
+    name: "Bria Video Background Removal",
+    outputKeys: ["video"],
+    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"
+  },
+  ddcolor: {
+    category: "restoration",
+    description: "Colourise black-and-white photographs.",
+    endpoint: "fal-ai/ddcolor",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "DDColor Colourisation",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 1e-3 },
+    pricing: "$0.001/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/ddcolor",
+    task: "photo colourisation"
+  },
+  rembg: {
+    category: "background",
+    defaultOptions: {
+      crop_to_bbox: false
+    },
+    description: "Generic image background removal utility.",
+    endpoint: "fal-ai/imageutils/rembg",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Remove Background",
+    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"
+  },
+  "seedvr-upscale": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Diffusion image restoration and upscaling with SeedVR.",
+    endpoint: "fal-ai/seedvr/upscale/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SeedVR Image Upscale",
+    outputKeys: ["image"],
+    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"
+  },
+  "topaz-adjust": {
+    category: "restoration",
+    defaultOptions: {
+      output_format: "png"
+    },
+    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"
   },
-  "bria-rmbg": {
-    category: "background",
-    description: "Commercial-safe background removal for images.",
-    endpoint: "fal-ai/bria/background/remove",
+  "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: "Bria RMBG 2.0",
-    outputKeys: ["image"],
-    pricing: "$0.02/image",
-    sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove",
-    task: "image background removal"
+    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"
   },
-  "bria-video-rmbg": {
-    category: "background",
+  "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: {
-      background_color: "Black",
-      output_container_and_codec: "webm_vp9",
-      preserve_audio: true
+      output_format: "png"
     },
-    description: "Remove video backgrounds with configurable output container.",
-    endpoint: "bria/video/background-removal",
-    inputField: "video_url",
-    inputKind: "video",
-    name: "Bria Video Background Removal",
-    outputKeys: ["video"],
-    pricing: "$0.14/sec",
-    sourceUrl: "https://fal.ai/models/bria/video/background-removal",
-    task: "video background removal"
-  },
+    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.",
@@ -2376,10 +3284,37 @@ var FAL_TOOLS = {
     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: {
@@ -2391,6 +3326,7 @@ var FAL_TOOLS = {
     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"
@@ -2407,6 +3343,7 @@ var FAL_TOOLS = {
     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"
@@ -2423,6 +3360,7 @@ var FAL_TOOLS = {
     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"
@@ -2435,36 +3373,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",
@@ -2474,6 +3412,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"
@@ -2493,7 +3432,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"
   },
@@ -2510,7 +3451,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"
   },
@@ -2526,61 +3468,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: {
@@ -2594,6 +3487,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"
@@ -2609,7 +3503,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"
@@ -2628,7 +3523,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"
   },
@@ -2644,45 +3541,65 @@ 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_EXPLORE_CHECKED_AT = "2026-08-23";
+var FAL_TOOLS = {
+  ...ANALYSIS_TOOLS,
+  ...ASSET_TOOLS,
+  ...BACKGROUND_TOOLS,
+  ...EDITING_TOOLS,
+  ...STRUCTURE_TOOLS
+};
 var FAL_TOOLS_CHECKED_AT = FAL_EXPLORE_CHECKED_AT;
 var FAL_TOOL_IDS = Object.keys(
   FAL_TOOLS
@@ -2709,9 +3626,110 @@ function buildFalToolRequest(options) {
   return { body, endpoint: tool.endpoint, tool };
 }
 
-// src/server.ts
+// src/server-tools.ts
 var FAL_BASE_URL = "https://fal.run";
 var FAL_QUEUE_URL = "https://queue.fal.run";
+var POLL_INTERVAL_MS = 3e3;
+var MAX_POLL_ATTEMPTS = 160;
+function buildToolRequest(options) {
+  try {
+    return (0, import_neverthrow.ok)(buildFalToolRequest(options));
+  } catch (error) {
+    return (0, import_neverthrow.err)(
+      new MotifError(error instanceof Error ? error.message : String(error), 0)
+    );
+  }
+}
+async function runTool(exec, options) {
+  const request = buildToolRequest(options);
+  if (request.isErr()) {
+    return (0, import_neverthrow.err)(request.error);
+  }
+  const response = await exec.request(
+    `${FAL_BASE_URL}/${request.value.endpoint}`,
+    {
+      body: JSON.stringify(request.value.body),
+      method: "POST"
+    }
+  );
+  if (response.isErr()) {
+    return (0, import_neverthrow.err)(response.error);
+  }
+  const data = await response.value.json();
+  return (0, import_neverthrow.ok)(isRecord(data) ? data : {});
+}
+async function submitTool(exec, options) {
+  const request = buildToolRequest(options);
+  if (request.isErr()) {
+    return (0, import_neverthrow.err)(request.error);
+  }
+  const response = await exec.request(
+    `${FAL_QUEUE_URL}/${request.value.endpoint}`,
+    {
+      body: JSON.stringify(request.value.body),
+      method: "POST"
+    }
+  );
+  if (response.isErr()) {
+    return (0, import_neverthrow.err)(response.error);
+  }
+  const data = await response.value.json();
+  const submission = parseQueueSubmission(data);
+  return (0, import_neverthrow.ok)({
+    endpoint: endpointFromQueueUrl(
+      submission.responseUrl,
+      request.value.endpoint
+    ),
+    requestId: submission.requestId
+  });
+}
+async function checkToolStatus(exec, job) {
+  return await exec.getJobStatus(job.endpoint, job.requestId);
+}
+async function getToolResult(exec, job) {
+  const url = `${FAL_QUEUE_URL}/${job.endpoint}/requests/${job.requestId}`;
+  const response = await exec.request(url);
+  if (response.isErr()) {
+    return (0, import_neverthrow.err)(response.error);
+  }
+  const data = await response.value.json();
+  return (0, import_neverthrow.ok)(isRecord(data) ? data : {});
+}
+async function runToolQueued(exec, options, onProgress) {
+  const job = await submitTool(exec, options);
+  if (job.isErr()) {
+    return (0, import_neverthrow.err)(job.error);
+  }
+  for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt++) {
+    const status = await checkToolStatus(exec, job.value);
+    if (status.isErr()) {
+      return (0, import_neverthrow.err)(status.error);
+    }
+    onProgress?.(status.value.status, status.value.queuePosition);
+    if (status.value.status === "completed") {
+      return await getToolResult(exec, job.value);
+    }
+    if (status.value.status === "failed") {
+      const message = status.value.error ?? "Queued tool run failed";
+      return (0, import_neverthrow.err)(new MotifError(message, 0, void 0, job.value.requestId));
+    }
+    await new Promise((resolve) => {
+      setTimeout(resolve, POLL_INTERVAL_MS);
+    });
+  }
+  return (0, import_neverthrow.err)(
+    new MotifError(
+      "Queued tool run timed out",
+      0,
+      void 0,
+      job.value.requestId
+    )
+  );
+}
+
+// src/server.ts
+var FAL_BASE_URL2 = "https://fal.run";
+var FAL_QUEUE_URL2 = "https://queue.fal.run";
 var FAL_API_URL = "https://api.fal.ai";
 var FAL_REST_URL = "https://rest.alpha.fal.ai";
 var FalClient = class {
@@ -2743,16 +3761,16 @@ var FalClient = class {
     try {
       built = buildGenerateBody(options);
     } catch (error) {
-      return (0, import_neverthrow.err)(toMotifError(error));
+      return (0, import_neverthrow2.err)(toMotifError(error));
     }
     const { endpoint, body } = built;
-    const response = await this.request(`${FAL_BASE_URL}/${endpoint}`, {
+    const response = await this.request(`${FAL_BASE_URL2}/${endpoint}`, {
       body: JSON.stringify(body),
       headers: this.ephemeralHeaders(options),
       method: "POST"
     });
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     return this.normalizeResponse(data);
@@ -2760,7 +3778,7 @@ var FalClient = class {
   async generateQueued(options) {
     const job = await this.submitGeneration(options);
     if (job.isErr()) {
-      return (0, import_neverthrow.err)(job.error);
+      return (0, import_neverthrow2.err)(job.error);
     }
     const pollIntervalMs = 3e3;
     const maxAttempts = 160;
@@ -2770,20 +3788,20 @@ var FalClient = class {
         job.value.requestId
       );
       if (status.isErr()) {
-        return (0, import_neverthrow.err)(status.error);
+        return (0, import_neverthrow2.err)(status.error);
       }
       if (status.value.status === "completed") {
         return await this.getJobResult(job.value.endpoint, job.value.requestId);
       }
       if (status.value.status === "failed") {
         const message = status.value.error ?? "Queued generation failed";
-        return (0, import_neverthrow.err)(new MotifError(message, 0, void 0, job.value.requestId));
+        return (0, import_neverthrow2.err)(new MotifError(message, 0, void 0, job.value.requestId));
       }
       await new Promise((resolve) => {
         setTimeout(resolve, pollIntervalMs);
       });
     }
-    return (0, import_neverthrow.err)(new MotifError("Queued generation timed out", 0));
+    return (0, import_neverthrow2.err)(new MotifError("Queued generation timed out", 0));
   }
   /** ─── Queue-Based Generation ──────────────────────────────── */
   /** Submit a generation to the fal.ai queue (returns immediately). */
@@ -2792,20 +3810,20 @@ var FalClient = class {
     try {
       built = buildGenerateBody(options);
     } catch (error) {
-      return (0, import_neverthrow.err)(toMotifError(error));
+      return (0, import_neverthrow2.err)(toMotifError(error));
     }
     const { endpoint, body } = built;
-    const response = await this.request(`${FAL_QUEUE_URL}/${endpoint}`, {
+    const response = await this.request(`${FAL_QUEUE_URL2}/${endpoint}`, {
       body: JSON.stringify(body),
       headers: this.ephemeralHeaders(options),
       method: "POST"
     });
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     const submission = parseQueueSubmission(data);
-    return (0, import_neverthrow.ok)({
+    return (0, import_neverthrow2.ok)({
       endpoint: endpointFromQueueUrl(submission.responseUrl, endpoint),
       estimatedCost: estimateCost(
         options.model,
@@ -2817,10 +3835,10 @@ var FalClient = class {
   }
   /** Check the status of a queued generation. */
   async getJobStatus(endpoint, requestId) {
-    const url = `${FAL_QUEUE_URL}/${endpoint}/requests/${requestId}/status?logs=1`;
+    const url = `${FAL_QUEUE_URL2}/${endpoint}/requests/${requestId}/status?logs=1`;
     const response = await this.request(url);
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     const record = isRecord(data) ? data : {};
@@ -2835,9 +3853,9 @@ var FalClient = class {
     } else if (rawStatus === "FAILED" || rawStatus === "ERROR" || rawStatus === "CANCELED") {
       status = "failed";
     } else {
-      return (0, import_neverthrow.err)(new MotifError(`Unknown job status: ${rawStatus}`, 0));
+      return (0, import_neverthrow2.err)(new MotifError(`Unknown job status: ${rawStatus}`, 0));
     }
-    return (0, import_neverthrow.ok)({
+    return (0, import_neverthrow2.ok)({
       error: asString(record.error) ?? asString(record.detail),
       logs: parseLogs(record.logs),
       queuePosition: asNumber(record.queue_position),
@@ -2846,10 +3864,10 @@ var FalClient = class {
   }
   /** Fetch the completed result from the queue. */
   async getJobResult(endpoint, requestId) {
-    const url = `${FAL_QUEUE_URL}/${endpoint}/requests/${requestId}`;
+    const url = `${FAL_QUEUE_URL2}/${endpoint}/requests/${requestId}`;
     const response = await this.request(url);
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     return this.normalizeResponse(data, requestId);
@@ -2870,7 +3888,7 @@ var FalClient = class {
     } = options;
     const config = MODELS[model];
     if (!config || config.type !== "utility") {
-      return (0, import_neverthrow.err)(new MotifError(`Invalid upscale model: ${model}`, 0));
+      return (0, import_neverthrow2.err)(new MotifError(`Invalid upscale model: ${model}`, 0));
     }
     const body = { image_url: imageUrl };
     if (model === "crystal") {
@@ -2903,12 +3921,12 @@ var FalClient = class {
         body.guidance_scale = guidanceScale;
       }
     }
-    const response = await this.request(`${FAL_BASE_URL}/${config.endpoint}`, {
+    const response = await this.request(`${FAL_BASE_URL2}/${config.endpoint}`, {
       body: JSON.stringify(body),
       method: "POST"
     });
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     return this.normalizeResponse(data);
@@ -2926,7 +3944,7 @@ var FalClient = class {
     } = options;
     const config = MODELS[model];
     if (!config) {
-      return (0, import_neverthrow.err)(
+      return (0, import_neverthrow2.err)(
         new MotifError(`Invalid background removal model: ${model}`, 0)
       );
     }
@@ -2948,12 +3966,12 @@ var FalClient = class {
         rbBody.output_mask = outputMask;
       }
     }
-    const response = await this.request(`${FAL_BASE_URL}/${config.endpoint}`, {
+    const response = await this.request(`${FAL_BASE_URL2}/${config.endpoint}`, {
       body: JSON.stringify(rbBody),
       method: "POST"
     });
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     return this.normalizeResponse(data);
@@ -2976,7 +3994,7 @@ var FalClient = class {
     } = options;
     const config = MODELS.kling;
     if (!config) {
-      return (0, import_neverthrow.err)(new MotifError("Kling video model not found", 0));
+      return (0, import_neverthrow2.err)(new MotifError("Kling video model not found", 0));
     }
     const body = {
       duration: String(duration),
@@ -2993,16 +4011,16 @@ var FalClient = class {
     if (cfgScale !== void 0) {
       body.cfg_scale = cfgScale;
     }
-    const response = await this.request(`${FAL_QUEUE_URL}/${config.endpoint}`, {
+    const response = await this.request(`${FAL_QUEUE_URL2}/${config.endpoint}`, {
       body: JSON.stringify(body),
       method: "POST"
     });
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     const submission = parseQueueSubmission(data);
-    return (0, import_neverthrow.ok)({
+    return (0, import_neverthrow2.ok)({
       endpoint: endpointFromQueueUrl(submission.responseUrl, config.endpoint),
       estimatedCost: estimateVideoCost(duration, generateAudio),
       requestId: submission.requestId
@@ -3010,17 +4028,17 @@ var FalClient = class {
   }
   /** Fetch the completed video result from the queue. */
   async getVideoResult(endpoint, requestId) {
-    const url = `${FAL_QUEUE_URL}/${endpoint}/requests/${requestId}`;
+    const url = `${FAL_QUEUE_URL2}/${endpoint}/requests/${requestId}`;
     const response = await this.request(url);
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
     const data = await response.value.json();
     const video = isRecord(data) && isRecord(data.video) ? data.video : void 0;
     if (video === void 0) {
-      return (0, import_neverthrow.err)(new MotifError("No video in response", 0));
+      return (0, import_neverthrow2.err)(new MotifError("No video in response", 0));
     }
-    return (0, import_neverthrow.ok)({
+    return (0, import_neverthrow2.ok)({
       contentType: asString(video.content_type) ?? "",
       fileName: asString(video.file_name) ?? "",
       fileSize: asNumber(video.file_size) ?? 0,
@@ -3044,13 +4062,13 @@ var FalClient = class {
       }
     );
     if (initiateResponse.isErr()) {
-      return (0, import_neverthrow.err)(initiateResponse.error);
+      return (0, import_neverthrow2.err)(initiateResponse.error);
     }
     const initiateData = await initiateResponse.value.json();
     const fileUrl = isRecord(initiateData) ? asString(initiateData.file_url) ?? "" : "";
     const uploadUrl = isRecord(initiateData) ? asString(initiateData.upload_url) : void 0;
     if (uploadUrl === void 0 || uploadUrl === "") {
-      return (0, import_neverthrow.err)(
+      return (0, import_neverthrow2.err)(
         new MotifError("Upload initiate response missing upload_url", 0)
       );
     }
@@ -3065,7 +4083,7 @@ var FalClient = class {
         method: "PUT"
       });
     } catch (error) {
-      return (0, import_neverthrow.err)(
+      return (0, import_neverthrow2.err)(
         new MotifError(
           `Upload PUT failed: ${error instanceof Error ? error.message : String(error)}`,
           0
@@ -3073,38 +4091,45 @@ var FalClient = class {
       );
     }
     if (!putResponse.ok) {
-      return (0, import_neverthrow.err)(
+      return (0, import_neverthrow2.err)(
         new MotifError(
           `Upload PUT failed: ${putResponse.status}`,
           putResponse.status
         )
       );
     }
-    return (0, import_neverthrow.ok)(fileUrl);
+    return (0, import_neverthrow2.ok)(fileUrl);
   }
   /** ─── Utilities ───────────────────────────────────────────── */
   /** Run a registered fal utility/tool endpoint. */
   async runTool(options) {
-    let request;
-    try {
-      request = buildFalToolRequest(options);
-    } catch (error) {
-      return (0, import_neverthrow.err)(
-        new MotifError(
-          error instanceof Error ? error.message : String(error),
-          0
-        )
-      );
-    }
-    const response = await this.request(`${FAL_BASE_URL}/${request.endpoint}`, {
-      body: JSON.stringify(request.body),
-      method: "POST"
-    });
-    if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
-    }
-    const data = await response.value.json();
-    return (0, import_neverthrow.ok)(isRecord(data) ? data : {});
+    return await runTool(this.toolExecutor, options);
+  }
+  /** ─── Queue-Based Tools ───────────────────────────────────── */
+  /**
+   * Submit a tool run to the fal queue. Returns as soon as fal accepts it.
+   *
+   * The queued counterpart to `runTool`, for endpoints that outrun the
+   * synchronous request timeout. Callers choose the path — neither one falls
+   * back to the other.
+   */
+  async submitTool(options) {
+    return await submitTool(this.toolExecutor, options);
+  }
+  /** Poll one queued tool run. */
+  async checkToolStatus(job) {
+    return await checkToolStatus(this.toolExecutor, job);
+  }
+  /** Fetch the finished payload for a queued tool run. */
+  async getToolResult(job) {
+    return await getToolResult(this.toolExecutor, job);
+  }
+  /**
+   * Submit, poll to completion, and return the result. The convenience path
+   * for tools whose registry entry sets `queued`.
+   */
+  async runToolQueued(options, onProgress) {
+    return await runToolQueued(this.toolExecutor, options, onProgress);
   }
   /**
    * Delete fal's stored IO payloads for a completed request.
@@ -3119,9 +4144,9 @@ var FalClient = class {
       { method: "DELETE" }
     );
     if (response.isErr()) {
-      return (0, import_neverthrow.err)(response.error);
+      return (0, import_neverthrow2.err)(response.error);
     }
-    return (0, import_neverthrow.ok)();
+    return (0, import_neverthrow2.ok)();
   }
   /** Estimate cost for a generation (no API call). */
   estimateCost(model, resolution, numImages) {
@@ -3147,6 +4172,16 @@ var FalClient = class {
   get tools() {
     return FAL_TOOLS;
   }
+  /**
+   * The seam `server-tools.ts` runs against — the client's authenticated fetch
+   * and its queue status parser, exposed without widening the public surface.
+   */
+  get toolExecutor() {
+    return {
+      getJobStatus: async (endpoint, requestId) => await this.getJobStatus(endpoint, requestId),
+      request: async (url, init) => await this.request(url, init)
+    };
+  }
   /** ─── Private ─────────────────────────────────────────────── */
   /** Authenticated fetch to fal.ai APIs with retry logic. */
   async request(url, options = {}) {
@@ -3178,15 +4213,15 @@ var FalClient = class {
           const text = await response.text();
           const message = `Request failed: ${response.status} ${text}`;
           const requestId = response.headers.get("x-fal-request-id") ?? requestIdFromBody(text);
-          return (0, import_neverthrow.err)(
+          return (0, import_neverthrow2.err)(
             new MotifError(message, response.status, void 0, requestId)
           );
         }
-        return (0, import_neverthrow.ok)(response);
+        return (0, import_neverthrow2.ok)(response);
       } catch (error) {
         clearTimeout(timeoutId);
         if (error instanceof MotifError) {
-          return (0, import_neverthrow.err)(error);
+          return (0, import_neverthrow2.err)(error);
         }
         lastError = new MotifError(
           error instanceof Error ? error.message : String(error),
@@ -3200,7 +4235,7 @@ var FalClient = class {
         }
       }
     }
-    return (0, import_neverthrow.err)(lastError ?? new MotifError("Request failed after retries", 0));
+    return (0, import_neverthrow2.err)(lastError ?? new MotifError("Request failed after retries", 0));
   }
   ephemeralHeaders(options) {
     return options.ephemeral === true ? { "X-Fal-Store-IO": "0" } : {};
@@ -3211,24 +4246,24 @@ var FalClient = class {
    */
   normalizeResponse(data, fallbackRequestId) {
     if (!isRecord(data)) {
-      return (0, import_neverthrow.err)(
+      return (0, import_neverthrow2.err)(
         new MotifError("Unexpected fal response shape", 0, "FAL_ERROR")
       );
     }
     const obj = data;
     const requestId = asString(obj.request_id) ?? asString(obj.requestId) ?? fallbackRequestId;
     if ("detail" in obj) {
-      return (0, import_neverthrow.err)(new MotifError(asString(obj.detail) ?? "", 0, "FAL_ERROR"));
+      return (0, import_neverthrow2.err)(new MotifError(asString(obj.detail) ?? "", 0, "FAL_ERROR"));
     }
     if ("image" in obj && !("images" in obj)) {
-      return (0, import_neverthrow.ok)({
+      return (0, import_neverthrow2.ok)({
         images: [toMotifImage(obj.image)],
         prompt: asString(obj.prompt),
         requestId,
         seed: asNumber(obj.seed)
       });
     }
-    return (0, import_neverthrow.ok)({
+    return (0, import_neverthrow2.ok)({
       images: parseImages(obj.images),
       prompt: asString(obj.prompt),
       requestId,
@@ -3236,28 +4271,6 @@ var FalClient = class {
     });
   }
 };
-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;
-  }
-};
-function toMotifError(error) {
-  if (error instanceof MotifError) {
-    return error;
-  }
-  const message = error instanceof Error ? error.message : String(error);
-  const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0;
-  return new MotifError(message, 0, code);
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ASPECT_RATIOS,