@howells/motif-sdk 1.1.0 → 1.3.0

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(src_exports, {
   FAL_TOOLS: () => FAL_TOOLS,
   FAL_TOOLS_CHECKED_AT: () => FAL_TOOLS_CHECKED_AT,
   FAL_TOOL_IDS: () => FAL_TOOL_IDS,
+  FAL_TOOL_PARAMETERS: () => FAL_TOOL_PARAMETERS,
   FORMAT_PRESETS: () => FORMAT_PRESETS,
   FalClient: () => FalClient,
   GENERATION_MODELS: () => GENERATION_MODELS,
@@ -35,6 +36,7 @@ __export(src_exports, {
   IMAGE_EDITING_TOP_20: () => IMAGE_EDITING_TOP_20,
   IMAGE_TEXT_TO_IMAGE_TOP_20: () => IMAGE_TEXT_TO_IMAGE_TOP_20,
   MODELS: () => MODELS,
+  MODEL_OUTPUT: () => MODEL_OUTPUT,
   MotifError: () => MotifError,
   RECRAFT_STYLES: () => RECRAFT_STYLES,
   RESOLUTIONS: () => RESOLUTIONS,
@@ -46,19 +48,27 @@ __export(src_exports, {
   aspectToGptSize: () => aspectToGptSize,
   buildFalToolRequest: () => buildFalToolRequest,
   buildGenerateBody: () => buildGenerateBody,
+  describeModelOutput: () => describeModelOutput,
   enrichPrompt: () => enrichPrompt,
-  err: () => import_neverthrow2.err,
+  err: () => import_neverthrow3.err,
   estimateCost: () => estimateCost,
   estimateVideoCost: () => estimateVideoCost,
+  falToolParameters: () => falToolParameters,
+  formatCost: () => formatCost,
   getFalKeyFromEnv: () => getFalKeyFromEnv,
   isFalToolId: () => isFalToolId,
+  losslessAvailability: () => losslessAvailability,
+  measuredToolCost: () => measuredToolCost,
+  modelOutput: () => modelOutput,
   motifEnvSchema: () => motifEnvSchema,
-  ok: () => import_neverthrow2.ok,
+  ok: () => import_neverthrow3.ok,
   parseMotifEnv: () => parseMotifEnv,
-  sanitizePrompt: () => sanitizePrompt
+  projectedToolCost: () => projectedToolCost,
+  sanitizePrompt: () => sanitizePrompt,
+  sumCosts: () => sumCosts
 });
 module.exports = __toCommonJS(src_exports);
-var import_neverthrow2 = require("neverthrow");
+var import_neverthrow3 = require("neverthrow");
 
 // src/aspects.ts
 var ASPECT_RATIOS = [
@@ -158,22 +168,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, rank: 3 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1337, pricePer1k: 211, rank: 1, winRate: 0.8 }
+        textToImage: { elo: 1369, rank: 1 }
       },
       speed: {
         medianSeconds: 200.7,
@@ -213,10 +224,10 @@ var MODELS = {
   gpt: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1262, pricePer1k: 133, rank: 2, winRate: 0.69 },
+        editing: { elo: 1250, rank: 5 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1268, pricePer1k: 133, rank: 2, winRate: 0.73 }
+        textToImage: { elo: 1310, rank: 4 }
       },
       speed: {
         medianSeconds: 34.6,
@@ -256,10 +267,10 @@ var MODELS = {
   banana2: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1231, pricePer1k: 67, rank: 5, winRate: 0.63 },
+        editing: { elo: 1249, rank: 7 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1263, pricePer1k: 67, rank: 3, winRate: 0.71 }
+        textToImage: { elo: 1320, rank: 3 }
       },
       tiers: { price: "premium", quality: "frontier", speed: "unknown" },
       useCase: "Best balance of quality, edit support, web search, and cost"
@@ -297,10 +308,10 @@ var MODELS = {
   banana: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1241, pricePer1k: 134, rank: 4, winRate: 0.65 },
+        editing: { elo: 1245, rank: 9 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1220, pricePer1k: 134, rank: 5, winRate: 0.66 }
+        textToImage: { elo: 1297, rank: 6 }
       },
       speed: {
         medianSeconds: 19.2,
@@ -340,6 +351,13 @@ var MODELS = {
     type: "generation"
   },
   gemini: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1180, rank: 29 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES
+      }
+    },
     editEndpoint: "fal-ai/gemini-25-flash-image/edit",
     endpoint: "fal-ai/gemini-25-flash-image",
     falPricing: {
@@ -367,6 +385,14 @@ var MODELS = {
     type: "generation"
   },
   gemini3: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1245, rank: 9 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1297, rank: 6 }
+      }
+    },
     editEndpoint: "fal-ai/gemini-3-pro-image-preview/edit",
     endpoint: "fal-ai/gemini-3-pro-image-preview",
     falPricing: {
@@ -397,10 +423,10 @@ var MODELS = {
   seedream4: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 30, rank: 16, winRate: 0.61 },
+        editing: { elo: 1185, rank: 28 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1198, pricePer1k: 30, rank: 6, winRate: 0.59 }
+        textToImage: { elo: 1226, rank: 16 }
       },
       speed: {
         medianSeconds: 14.3,
@@ -437,10 +463,10 @@ var MODELS = {
   seedream45: {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1184, pricePer1k: 40, rank: 17, winRate: 0.58 },
+        editing: { elo: 1186, rank: 26 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1167, pricePer1k: 40, rank: 17, winRate: 0.63 }
+        textToImage: { elo: 1203, rank: 32 }
       },
       speed: {
         medianSeconds: 18.2,
@@ -475,6 +501,14 @@ var MODELS = {
     type: "generation"
   },
   seedream5: {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1248, rank: 8 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1279, rank: 10 }
+      }
+    },
     name: "Seedream 5.0 Pro",
     endpoint: "bytedance/seedream/v5/pro/text-to-image",
     editEndpoint: "bytedance/seedream/v5/pro/edit",
@@ -501,6 +535,13 @@ var MODELS = {
     maxReferenceImages: 10
   },
   "seedream5-lite": {
+    benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1169, rank: 32 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES
+      }
+    },
     name: "Seedream 5.0 Lite",
     endpoint: "fal-ai/bytedance/seedream/v5/lite/text-to-image",
     editEndpoint: "fal-ai/bytedance/seedream/v5/lite/edit",
@@ -529,10 +570,10 @@ var MODELS = {
   "flux2-max": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1206, pricePer1k: 140, rank: 10, winRate: 0.6 },
+        editing: { elo: 1201, rank: 19 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1197, pricePer1k: 70, rank: 8, winRate: 0.67 }
+        textToImage: { elo: 1225, rank: 17 }
       },
       speed: {
         medianSeconds: 31.6,
@@ -572,10 +613,10 @@ var MODELS = {
   "flux2-pro": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1170, pricePer1k: 30, rank: 21 },
+        editing: { elo: 1170, rank: 31 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1186, pricePer1k: 30, rank: 10, winRate: 0.62 }
+        textToImage: { elo: 1207, rank: 30 }
       },
       speed: {
         medianSeconds: 16.1,
@@ -615,10 +656,9 @@ var MODELS = {
   "flux2-flex": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1161, pricePer1k: 60, rank: 22 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1182, pricePer1k: 60, rank: 13, winRate: 0.61 }
+        textToImage: { elo: 1223, rank: 18 }
       },
       speed: {
         medianSeconds: 15.3,
@@ -662,8 +702,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 +845,55 @@ var MODELS = {
     supportsSyncMode: true,
     type: "generation"
   },
+  reve: {
+    benchmark: {
+      artificialAnalysis: {
+        // #2 on BOTH boards, which almost nothing else manages - the top text-to-image model
+        // (GPT Image 2) drops to 3rd for editing, and the top editor (MAI-Image-2.5-Pro) is not
+        // on fal at all. Reve is the best editor motif can actually reach.
+        editing: { elo: 1263, rank: 2 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1322, rank: 2 }
+      },
+      tiers: { price: "premium", quality: "frontier", speed: "unknown" },
+      useCase: "Highest-ranked editor reachable on fal; strong prompt adherence and text rendering"
+    },
+    editEndpoint: "fal-ai/reve/edit",
+    endpoint: "fal-ai/reve/text-to-image",
+    falPricing: {
+      checkedAt: FAL_PRICING_CHECKED_AUG_2026,
+      currency: "USD",
+      endpointId: "fal-ai/reve/text-to-image",
+      estimatedCostPerImageUsd: 0.04,
+      source: "fal-pricing-api",
+      unit: "images",
+      unitPrice: 0.04
+    },
+    maxReferenceImages: 1,
+    name: "Reve 2.1",
+    pricePerImageUsd: 0.04,
+    pricing: "$0.04",
+    // fal's schema takes aspect_ratio from a fixed set and has no width/height or resolution
+    // parameter, so aspect is supported and resolution is not.
+    sizeMode: "aspect_ratio",
+    supportsAspect: true,
+    supportsEdit: true,
+    supportsNumImages: true,
+    supportsOutputFormat: true,
+    supportsResolution: false,
+    supportsSeed: false,
+    supportsSyncMode: true,
+    type: "generation"
+  },
   recraft4: {
+    benchmark: {
+      artificialAnalysis: {
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1215, rank: 25 }
+      }
+    },
     endpoint: "fal-ai/recraft/v4/text-to-image",
     falPricing: {
       checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -857,6 +944,13 @@ var MODELS = {
     type: "generation"
   },
   ideogram4: {
+    benchmark: {
+      artificialAnalysis: {
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1220, rank: 19 }
+      }
+    },
     name: "Ideogram V4",
     endpoint: "ideogram/v4",
     type: "generation",
@@ -889,10 +983,10 @@ var MODELS = {
   "grok-image": {
     benchmark: {
       artificialAnalysis: {
-        editing: { elo: 1213, pricePer1k: 20, rank: 7, winRate: 0.6 },
+        editing: { elo: 1214, rank: 16 },
         snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
         sourceUrls: AA_IMAGE_SOURCES,
-        textToImage: { elo: 1182, pricePer1k: 20, rank: 12, winRate: 0.6 }
+        textToImage: { elo: 1216, rank: 23 }
       },
       speed: {
         medianSeconds: 5.1,
@@ -930,8 +1024,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,
@@ -966,8 +1059,14 @@ var MODELS = {
   },
   qwen3: {
     benchmark: {
+      artificialAnalysis: {
+        editing: { elo: 1218, rank: 15 },
+        snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+        sourceUrls: AA_IMAGE_SOURCES,
+        textToImage: { elo: 1272, rank: 11 }
+      },
       tiers: { price: "budget", quality: "better", speed: "unknown" },
-      useCase: "Qwen Image 3 - successor to qwen; no leaderboard data yet"
+      useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
     },
     endpoint: "fal-ai/qwen-image-3/text-to-image",
     falPricing: {
@@ -1392,7 +1491,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) {
@@ -1674,353 +1773,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,
+      apiPricing: "$20/1k images",
+      creator: "SpaceXAI",
+      elo: 1214,
       isCurrent: true,
-      model: "Seedream 4.0",
+      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
     }
   ],
@@ -2250,7 +2347,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) {
@@ -2348,9 +2469,369 @@ 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"],
+    // Every element of `layers` carries its own `name` ("Left amber glass
+    // bottle") and a `z_index` that orders the stack, verified live. Without
+    // this the stack lands as layers.png … layers-5.png and the only way to
+    // tell the reconstructed background plate from an object is to open them.
+    outputLabels: {
+      layers: { fromItem: { nameField: "name", orderField: "z_index" } }
+    },
+    price: { kind: "metered" },
+    pricing: "$0.03375 per generated layer below 1536x1536 total area, $0.0675 per layer above; the listed rate is per layer, not per call",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/bytedance/seedream/v5/pro/layerize",
+    task: "image layer decomposition"
+  },
+  "seedvr-seamless": {
+    category: "material",
+    description: "Upscale a tiling texture while keeping its edges seamless. ",
+    endpoint: "fal-ai/seedvr/upscale/image/seamless",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "SeedVR Seamless Upscale",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 25e-4 },
+    pricing: "$0.0025/megapixel",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/seedvr/upscale/image/seamless",
+    task: "seamless texture upscaling"
+  },
+  "trellis-2": {
+    category: "3d",
+    description: "Reconstruct a textured 3D mesh from a single image, with UV unwrapping.",
+    endpoint: "fal-ai/trellis-2",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "TRELLIS 2",
+    outputKeys: ["model_glb"],
+    price: { kind: "call", usd: 0.3 },
+    pricing: "$0.30 at the default 1024p; $0.25 at 512p, $0.35 at 1536p",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/trellis-2",
+    task: "single-image 3D reconstruction"
+  }
+};
+
+// src/tool-registry/background.ts
+var BACKGROUND_TOOLS = {
+  "ben-v2": {
+    category: "background",
+    description: "Fast, high-quality background removal for images.",
+    endpoint: "fal-ai/ben/v2/image",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "BEN v2 Background Removal",
+    outputKeys: ["image"],
+    price: { kind: "megapixel", usd: 0.025 },
+    pricing: "$0.025/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/ben/v2/image",
+    task: "image background removal"
+  },
   birefnet: {
     category: "background",
     defaultOptions: {
@@ -2365,6 +2846,7 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "BirefNet Background Removal",
     outputKeys: ["image", "mask_image"],
+    price: { kind: "metered" },
     pricing: "$0/compute-second listed by fal",
     sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2",
     task: "image background removal"
@@ -2377,7 +2859,8 @@ var FAL_TOOLS = {
     inputKind: "image",
     name: "Bria RMBG 2.0",
     outputKeys: ["image"],
-    pricing: "$0.02/image",
+    price: { kind: "call", usd: 0.018 },
+    pricing: "$0.018/generation",
     sourceUrl: "https://fal.ai/models/fal-ai/bria/background/remove",
     task: "image background removal"
   },
@@ -2394,10 +2877,422 @@ var FAL_TOOLS = {
     inputKind: "video",
     name: "Bria Video Background Removal",
     outputKeys: ["video"],
-    pricing: "$0.14/sec",
+    price: { kind: "second", usd: 425e-5 },
+    pricing: "$0.00425/sec",
+    queued: true,
     sourceUrl: "https://fal.ai/models/bria/video/background-removal",
     task: "video background removal"
   },
+  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"
+  },
+  "object-removal-bbox": {
+    category: "erase",
+    description: "Remove whatever falls inside supplied bounding boxes.",
+    endpoint: "fal-ai/object-removal/bbox",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Object Removal by Box",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.024 },
+    pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high",
+    sourceUrl: "https://fal.ai/models/fal-ai/object-removal/bbox",
+    task: "bounding box object removal"
+  },
+  "object-removal-mask": {
+    category: "erase",
+    description: "Remove the masked region of an image and fill the gap.",
+    endpoint: "fal-ai/object-removal/mask",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Object Removal by Mask",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.024 },
+    pricing: "$0.024/image at the default best quality; $0.006 low, $0.012 medium, $0.018 high",
+    sourceUrl: "https://fal.ai/models/fal-ai/object-removal/mask",
+    task: "masked object removal"
+  },
+  "remove-lighting": {
+    category: "relight",
+    description: "Strip baked-in lighting and shadows to leave a flat, neutral surface.",
+    endpoint: "fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting",
+    inputField: "image_urls",
+    inputKind: "images",
+    name: "Qwen Remove Lighting",
+    outputKeys: ["images"],
+    price: { kind: "megapixel", usd: 0.035 },
+    pricing: "$0.035/megapixel",
+    sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-edit-plus-lora-gallery/remove-lighting",
+    task: "lighting removal"
+  },
+  "smart-resize": {
+    category: "reframe",
+    description: "Resize one image to several target sizes, recomposing rather than cropping.",
+    endpoint: "fal-ai/smart-resize",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Smart Resize",
+    outputKeys: ["images", "results"],
+    price: { kind: "metered" },
+    pricing: "$0.15 per output image, doubled at 4K, plus a $0.05 vision analysis fee per request",
+    queued: true,
+    sourceUrl: "https://fal.ai/models/fal-ai/smart-resize",
+    task: "multi-size recomposition"
+  },
+  "text-removal": {
+    category: "erase",
+    defaultOptions: {
+      output_format: "png"
+    },
+    description: "Remove all rendered text from an image, rebuilding what sat behind it.",
+    endpoint: "fal-ai/image-editing/text-removal",
+    inputField: "image_url",
+    inputKind: "image",
+    name: "Text Removal",
+    outputKeys: ["images"],
+    price: { kind: "call", usd: 0.04 },
+    pricing: "$0.04/image",
+    sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal",
+    task: "text removal"
+  }
+};
+
+// src/tool-registry/structure.ts
+var STRUCTURE_TOOLS = {
   "depth-anything": {
     category: "preprocess",
     description: "Generate Depth Anything v2 depth maps from input images.",
@@ -2406,10 +3301,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: {
@@ -2421,6 +3343,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"
@@ -2437,6 +3360,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"
@@ -2453,6 +3377,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"
@@ -2465,36 +3390,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",
@@ -2504,6 +3429,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"
@@ -2523,7 +3449,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"
   },
@@ -2540,7 +3468,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"
   },
@@ -2556,61 +3485,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: {
@@ -2624,6 +3504,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"
@@ -2639,7 +3520,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"
@@ -2658,7 +3540,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"
   },
@@ -2674,45 +3558,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
@@ -2739,9 +3643,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 {
@@ -2773,16 +3778,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);
@@ -2790,7 +3795,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;
@@ -2800,20 +3805,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). */
@@ -2822,20 +3827,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,
@@ -2847,10 +3852,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 : {};
@@ -2865,9 +3870,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),
@@ -2876,10 +3881,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);
@@ -2900,7 +3905,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") {
@@ -2933,12 +3938,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);
@@ -2956,7 +3961,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)
       );
     }
@@ -2978,12 +3983,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);
@@ -3006,7 +4011,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),
@@ -3023,16 +4028,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
@@ -3040,17 +4045,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,
@@ -3074,13 +4079,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)
       );
     }
@@ -3095,7 +4100,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
@@ -3103,38 +4108,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.
@@ -3149,9 +4161,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) {
@@ -3177,6 +4189,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 = {}) {
@@ -3208,15 +4230,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),
@@ -3230,7 +4252,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" } : {};
@@ -3241,24 +4263,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,
@@ -3266,27 +4288,632 @@ 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;
+
+// src/tool-cost.ts
+var UNKNOWN = { basis: "unknown", usd: null };
+function totalMegapixels(outputs) {
+  let pixels = 0;
+  let measured = 0;
+  for (const output of outputs) {
+    if (output.width !== void 0 && output.height !== void 0) {
+      pixels += output.width * output.height;
+      measured += 1;
+    }
+  }
+  return measured === 0 ? null : pixels / 1e6;
+}
+function projectedToolCost(price) {
+  return price.kind === "call" ? { basis: "projected", usd: price.usd } : UNKNOWN;
+}
+function measuredToolCost(price, outputs) {
+  if (price.kind === "call") {
+    return { basis: "measured", usd: price.usd };
+  }
+  if (price.kind === "megapixel") {
+    const megapixels = totalMegapixels(outputs);
+    return megapixels === null ? UNKNOWN : { basis: "measured", usd: price.usd * megapixels };
+  }
+  return UNKNOWN;
+}
+function formatCost(usd) {
+  return usd === null ? "metered" : `$${usd.toFixed(3)}`;
+}
+function sumCosts(costs) {
+  let known = 0;
+  let unknown = 0;
+  for (const cost of costs) {
+    if (cost === null) {
+      unknown += 1;
+    } else {
+      known += cost;
+    }
   }
+  return { known, unknown };
+}
+
+// src/tool-parameters.generated.ts
+var FAL_TOOL_PARAMETERS = {
+  "ben-v2": [
+    { key: "seed", type: "integer" }
+  ],
+  "birefnet": [
+    { key: "mask_only", type: "boolean", fallback: false },
+    { key: "model", type: "enum(General Use (Light)|General Use (Light 2K)|General Use (Heavy)|Matting|Portrait|General Use (Dynamic))", fallback: "General Use (Light)" },
+    { key: "operating_resolution", type: "enum(1024x1024|2048x2048|2304x2304)", fallback: "1024x1024" },
+    { key: "output_format", type: "enum(webp|png|gif)", fallback: "png" },
+    { key: "output_mask", type: "boolean", fallback: false },
+    { key: "refine_foreground", type: "boolean", fallback: true }
+  ],
+  "bria-eraser": [
+    { key: "mask_type", type: "enum(manual|automatic)", fallback: "manual" },
+    { key: "preserve_alpha", type: "boolean", fallback: false }
+  ],
+  "bria-expand": [
+    { key: "aspect_ratio", type: "enum(1:1|2:3|3:2|3:4|4:3|4:5|5:4|9:16|16:9)" },
+    { key: "canvas_size", type: "list[integer]", required: true },
+    { key: "negative_prompt", type: "string", fallback: "" },
+    { key: "original_image_location", type: "list[integer]" },
+    { key: "original_image_size", type: "list[integer]" },
+    { key: "prompt", type: "string", fallback: "" },
+    { key: "seed", type: "integer" }
+  ],
+  "bria-genfill": [
+    { key: "negative_prompt", type: "string", fallback: "" },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "prompt", type: "string", required: true },
+    { key: "seed", type: "integer" }
+  ],
+  "bria-rmbg": [],
+  "bria-video-rmbg": [
+    { key: "background_color", type: "enum(Transparent|Black|White|Gray|Red|Green|Blue|Yellow|Cyan|Magenta|Orange)", fallback: "Black" },
+    { key: "output_container_and_codec", type: "enum(mp4_h265|mp4_h264|webm_vp9|mov_h265|mov_proresks|mkv_h265|mkv_h264|mkv_vp9|gif)", fallback: "webm_vp9" },
+    { key: "preserve_audio", type: "boolean", fallback: true }
+  ],
+  "ddcolor": [
+    { key: "seed", type: "integer" }
+  ],
+  "depth-anything": [],
+  "dwpose": [
+    { key: "draw_mode", type: "enum(full-pose|body-pose|face-pose|hand-pose|face-hand-mask|face-mask|hand-mask)", fallback: "body-pose" }
+  ],
+  "finegrain-eraser": [
+    { key: "mode", type: "enum(express|standard|premium)", fallback: "standard" },
+    { key: "prompt", type: "string", required: true },
+    { key: "seed", type: "integer" }
+  ],
+  "flux-outpaint": [
+    { key: "auto_crop", type: "boolean", fallback: false },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "expand_bottom", type: "integer", fallback: 0 },
+    { key: "expand_left", type: "integer", fallback: 0 },
+    { key: "expand_right", type: "integer", fallback: 0 },
+    { key: "expand_top", type: "integer", fallback: 0 },
+    { key: "mode", type: "enum(high|fast)", fallback: "high" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" }
+  ],
+  "got-ocr": [
+    { key: "do_format", type: "boolean", fallback: false },
+    { key: "multi_page", type: "boolean", fallback: false }
+  ],
+  "hed": [
+    { key: "safe", type: "boolean", fallback: false },
+    { key: "scribble", type: "boolean", fallback: false }
+  ],
+  "hunyuan3d-v3": [
+    { key: "back_image_url", type: "string" },
+    { key: "enable_pbr", type: "boolean", fallback: false },
+    { key: "face_count", type: "integer", fallback: 5e5 },
+    { key: "generate_type", type: "enum(Normal|LowPoly|Geometry)", fallback: "Normal" },
+    { key: "left_image_url", type: "string" },
+    { key: "polygon_type", type: "enum(triangle|quadrilateral)", fallback: "triangle" },
+    { key: "right_image_url", type: "string" }
+  ],
+  "iclight-v2": [
+    { key: "background_threshold", type: "number", fallback: 0.67 },
+    { key: "cfg", type: "number", fallback: 1 },
+    { key: "enable_hr_fix", type: "boolean", fallback: false },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "guidance_scale", type: "number", fallback: 5 },
+    { key: "highres_denoise", type: "number", fallback: 0.95 },
+    { key: "hr_downscale", type: "number", fallback: 0.5 },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)" },
+    { key: "initial_latent", type: "enum(None|Left|Right|Top|Bottom)", fallback: "None" },
+    { key: "lowres_denoise", type: "number", fallback: 0.98 },
+    { key: "mask_image_url", type: "string" },
+    { key: "negative_prompt", type: "string", fallback: "" },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "num_inference_steps", type: "integer", fallback: 28 },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "prompt", type: "string", required: true },
+    { key: "seed", type: "integer" }
+  ],
+  "ideogram-layerize-text": [
+    { key: "font_file_body_url", type: "string" },
+    { key: "font_file_h1_url", type: "string" },
+    { key: "font_file_h2_url", type: "string" },
+    { key: "font_file_small_url", type: "string" },
+    { key: "font_name_body", type: "string" },
+    { key: "font_name_h1", type: "string" },
+    { key: "font_name_h2", type: "string" },
+    { key: "font_name_small", type: "string" },
+    { key: "prompt", type: "string" },
+    { key: "seed", type: "integer" }
+  ],
+  "ideogram-reframe": [
+    { key: "color_palette", type: "object" },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)", required: true },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "rendering_speed", type: "enum(TURBO|BALANCED|QUALITY)", fallback: "BALANCED" },
+    { key: "seed", type: "integer" },
+    { key: "style", type: "enum(AUTO|GENERAL|REALISTIC|DESIGN)" },
+    { key: "style_codes", type: "list[string]" },
+    { key: "style_preset", type: "enum(80S_ILLUSTRATION|90S_NOSTALGIA|ABSTRACT_ORGANIC|ANALOG_NOSTALGIA|ART_BRUT|ART_DECO|ART_POSTER|AURA|AVANT_GARDE|BAUHAUS|BLUEPRINT|BLURRY_MOTION|BRIGHT_ART|C4D_CARTOON|CHILDRENS_BOOK|COLLAGE|COLORING_BOOK_I|COLORING_BOOK_II|CUBISM|DARK_AURA|DOODLE|DOUBLE_EXPOSURE|DRAMATIC_CINEMA|EDITORIAL|EMOTIONAL_MINIMAL|ETHEREAL_PARTY|EXPIRED_FILM|FLAT_ART|FLAT_VECTOR|FOREST_REVERIE|GEO_MINIMALIST|GLASS_PRISM|GOLDEN_HOUR|GRAFFITI_I|GRAFFITI_II|HALFTONE_PRINT|HIGH_CONTRAST|HIPPIE_ERA|ICONIC|JAPANDI_FUSION|JAZZY|LONG_EXPOSURE|MAGAZINE_EDITORIAL|MINIMAL_ILLUSTRATION|MIXED_MEDIA|MONOCHROME|NIGHTLIFE|OIL_PAINTING|OLD_CARTOONS|PAINT_GESTURE|POP_ART|RETRO_ETCHING|RIVIERA_POP|SPOTLIGHT_80S|STYLIZED_RED|SURREAL_COLLAGE|TRAVEL_POSTER|VINTAGE_GEO|VINTAGE_POSTER|WATERCOLOR|WEIRD|WOODBLOCK_PRINT)" }
+  ],
+  "ideogram-tiling": [
+    { key: "acceleration", type: "enum(none|low|regular|high)", fallback: "none" },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "expansion_model", type: "enum(None|Medium|Large)", fallback: "Medium" },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)", fallback: "square_hd" },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "prompt", type: "string", required: true },
+    { key: "rendering_speed", type: "enum(TURBO|BALANCED|QUALITY)", fallback: "BALANCED" },
+    { key: "seed", type: "integer" },
+    { key: "strength", type: "number", fallback: 0.8 },
+    { key: "tiling_mode", type: "enum(both|horizontal|vertical)", fallback: "both" }
+  ],
+  "image2svg": [
+    { key: "color_precision", type: "integer", fallback: 6 },
+    { key: "colormode", type: "enum(color|binary)", fallback: "color" },
+    { key: "corner_threshold", type: "integer", fallback: 60 },
+    { key: "filter_speckle", type: "integer", fallback: 4 },
+    { key: "hierarchical", type: "enum(stacked|cutout)", fallback: "stacked" },
+    { key: "layer_difference", type: "integer", fallback: 16 },
+    { key: "length_threshold", type: "number", fallback: 4 },
+    { key: "max_iterations", type: "integer", fallback: 10 },
+    { key: "mode", type: "enum(spline|polygon)", fallback: "spline" },
+    { key: "path_precision", type: "integer", fallback: 3 },
+    { key: "splice_threshold", type: "integer", fallback: 45 }
+  ],
+  "lighting-restoration": [
+    { key: "acceleration", type: "enum(none|regular)", fallback: "regular" },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "guidance_scale", type: "number", fallback: 1 },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)" },
+    { key: "negative_prompt", type: "string", fallback: " " },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "num_inference_steps", type: "integer", fallback: 6 },
+    { key: "output_format", type: "enum(png|jpeg|webp)", fallback: "png" },
+    { key: "seed", type: "integer" }
+  ],
+  "lineart": [
+    { key: "coarse", type: "boolean", fallback: false }
+  ],
+  "marigold-depth": [
+    { key: "ensemble_size", type: "integer", fallback: 10 },
+    { key: "num_inference_steps", type: "integer", fallback: 10 },
+    { key: "processing_res", type: "integer", fallback: 0 }
+  ],
+  "midas-depth": [
+    { key: "a", type: "number", fallback: 6.283185307179586 },
+    { key: "bg_th", type: "number", fallback: 0.1 },
+    { key: "depth_and_normal", type: "boolean", fallback: false }
+  ],
+  "midas-preprocessor": [
+    { key: "a", type: "number", fallback: 6.283185307179586 },
+    { key: "background_threshold", type: "number", fallback: 0.1 }
+  ],
+  "mlsd": [
+    { key: "distance_threshold", type: "number", fallback: 0.1 },
+    { key: "score_threshold", type: "number", fallback: 0.1 }
+  ],
+  "moondream-caption": [
+    { key: "length", type: "enum(short|normal|long)", fallback: "normal" },
+    { key: "temperature", type: "number" },
+    { key: "top_p", type: "number" }
+  ],
+  "moondream-detect": [
+    { key: "preview", type: "boolean", fallback: false },
+    { key: "prompt", type: "string", required: true }
+  ],
+  "moondream-point": [
+    { key: "preview", type: "boolean", fallback: false },
+    { key: "prompt", type: "string", required: true }
+  ],
+  "moondream-query": [
+    { key: "prompt", type: "string", required: true },
+    { key: "reasoning", type: "boolean", fallback: true },
+    { key: "temperature", type: "number" },
+    { key: "top_p", type: "number" }
+  ],
+  "nsfw": [],
+  "object-removal": [
+    { key: "mask_expansion", type: "integer", fallback: 15 },
+    { key: "model", type: "enum(low_quality|medium_quality|high_quality|best_quality)", fallback: "best_quality" },
+    { key: "prompt", type: "string", required: true }
+  ],
+  "object-removal-bbox": [
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "mask_expansion", type: "integer", fallback: 15 },
+    { key: "model", type: "enum(low_quality|medium_quality|high_quality|best_quality)", fallback: "best_quality" }
+  ],
+  "object-removal-mask": [
+    { key: "mask_expansion", type: "integer", fallback: 15 },
+    { key: "model", type: "enum(low_quality|medium_quality|high_quality|best_quality)", fallback: "best_quality" }
+  ],
+  "patina": [
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "maps", type: "list[enum(basecolor|normal|roughness|metalness|height)]", fallback: ["basecolor", "normal", "roughness", "metalness", "height"] },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "seed", type: "integer" }
+  ],
+  "patina-extract": [
+    { key: "enable_prompt_expansion", type: "boolean", fallback: true },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)", fallback: "square_hd" },
+    { key: "maps", type: "list[enum(basecolor|normal|roughness|metalness|height)]", fallback: ["basecolor", "normal", "roughness", "metalness", "height"] },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "num_inference_steps", type: "integer", fallback: 8 },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "prompt", type: "string", required: true },
+    { key: "seed", type: "integer" },
+    { key: "strength", type: "number", fallback: 0.6 },
+    { key: "tile_size", type: "integer", fallback: 128 },
+    { key: "tile_stride", type: "integer", fallback: 64 },
+    { key: "tiling_mode", type: "enum(both|horizontal|vertical)", fallback: "both" },
+    { key: "upscale_factor", type: "enum(0|2|4)", fallback: 0 }
+  ],
+  "pidi": [
+    { key: "apply_filter", type: "boolean", fallback: false },
+    { key: "safe", type: "boolean", fallback: false },
+    { key: "scribble", type: "boolean", fallback: false }
+  ],
+  "qwen-layered": [
+    { key: "acceleration", type: "enum(none|regular|high)", fallback: "regular" },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "guidance_scale", type: "number", fallback: 5 },
+    { key: "negative_prompt", type: "string", fallback: "" },
+    { key: "num_inference_steps", type: "integer", fallback: 28 },
+    { key: "num_layers", type: "integer", fallback: 4 },
+    { key: "output_format", type: "enum(png|webp)", fallback: "png" },
+    { key: "prompt", type: "string" },
+    { key: "seed", type: "integer" }
+  ],
+  "recraft-vectorize": [],
+  "rembg": [
+    { key: "crop_to_bbox", type: "boolean", fallback: false }
+  ],
+  "remove-lighting": [
+    { key: "acceleration", type: "enum(none|regular)", fallback: "regular" },
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "guidance_scale", type: "number", fallback: 1 },
+    { key: "image_size", type: "object|enum(square_hd|square|portrait_4_3|portrait_16_9|landscape_4_3|landscape_16_9)" },
+    { key: "negative_prompt", type: "string", fallback: " " },
+    { key: "num_images", type: "integer", fallback: 1 },
+    { key: "num_inference_steps", type: "integer", fallback: 6 },
+    { key: "output_format", type: "enum(png|jpeg|webp)", fallback: "png" },
+    { key: "seed", type: "integer" }
+  ],
+  "sam-preprocessor": [],
+  "sam2-auto": [
+    { key: "min_mask_region_area", type: "integer", fallback: 100 },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "png" },
+    { key: "points_per_side", type: "integer", fallback: 32 },
+    { key: "pred_iou_thresh", type: "number", fallback: 0.88 },
+    { key: "stability_score_thresh", type: "number", fallback: 0.95 }
+  ],
+  "sam3-1-image": [
+    { key: "apply_mask", type: "boolean", fallback: true },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "include_boxes", type: "boolean", fallback: false },
+    { key: "include_scores", type: "boolean", fallback: false },
+    { key: "max_masks", type: "integer", fallback: 3 },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "wheel" },
+    { key: "return_multiple_masks", type: "boolean", fallback: false }
+  ],
+  "sam3-1-video": [
+    { key: "apply_mask", type: "boolean", fallback: true },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "detection_threshold", type: "number", fallback: 0.5 },
+    { key: "max_num_objects", type: "integer", fallback: 16 },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "" },
+    { key: "video_output_type", type: "enum(X264 (.mp4)|VP9 (.webm))", fallback: "X264 (.mp4)" }
+  ],
+  "sam3-3d-align": [
+    { key: "body_mask_url", type: "string" },
+    { key: "body_mesh_url", type: "string", required: true },
+    { key: "focal_length", type: "number" },
+    { key: "object_mesh_url", type: "string" }
+  ],
+  "sam3-3d-body": [
+    { key: "export_meshes", type: "boolean", fallback: true },
+    { key: "include_3d_keypoints", type: "boolean", fallback: true },
+    { key: "include_mhr_params", type: "boolean", fallback: true }
+  ],
+  "sam3-3d-objects": [
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "detection_threshold", type: "number" },
+    { key: "export_textured_glb", type: "boolean", fallback: false },
+    { key: "mask_urls", type: "list[string]" },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "pointmap_url", type: "string" },
+    { key: "prompt", type: "string", fallback: "car" },
+    { key: "seed", type: "integer" }
+  ],
+  "sam3-image": [
+    { key: "apply_mask", type: "boolean", fallback: true },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "include_boxes", type: "boolean", fallback: false },
+    { key: "include_scores", type: "boolean", fallback: false },
+    { key: "max_masks", type: "integer", fallback: 3 },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "wheel" },
+    { key: "return_multiple_masks", type: "boolean", fallback: false },
+    { key: "text_prompt", type: "string" }
+  ],
+  "sam3-image-rle": [
+    { key: "apply_mask", type: "boolean", fallback: true },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "include_boxes", type: "boolean", fallback: false },
+    { key: "include_scores", type: "boolean", fallback: false },
+    { key: "max_masks", type: "integer", fallback: 3 },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "wheel" },
+    { key: "return_multiple_masks", type: "boolean", fallback: false },
+    { key: "text_prompt", type: "string" }
+  ],
+  "sam3-video": [
+    { key: "apply_mask", type: "boolean", fallback: true },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "detection_threshold", type: "number", fallback: 0.5 },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "" },
+    { key: "text_prompt", type: "string" },
+    { key: "video_output_type", type: "enum(X264 (.mp4)|VP9 (.webm))", fallback: "X264 (.mp4)" }
+  ],
+  "sam3-video-rle": [
+    { key: "apply_mask", type: "boolean", fallback: false },
+    { key: "boundingbox_zip", type: "boolean", fallback: false },
+    { key: "box_prompts", type: "list[object]", fallback: [] },
+    { key: "detection_threshold", type: "number", fallback: 0.5 },
+    { key: "frame_index", type: "integer", fallback: 0 },
+    { key: "point_prompts", type: "list[object]", fallback: [] },
+    { key: "prompt", type: "string", fallback: "" }
+  ],
+  "scribble": [
+    { key: "model", type: "enum(HED|PiDi)", fallback: "HED" },
+    { key: "safe", type: "boolean", fallback: false }
+  ],
+  "seedream-layerize": [
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "enhance_prompt_mode", type: "enum(standard|fast)", fallback: "standard" },
+    { key: "image_size", type: "enum(auto|auto_1K|auto_1.5K|auto_2K)", fallback: "auto" },
+    { key: "prompt", type: "string", fallback: "" }
+  ],
+  "seedvr-seamless": [
+    { key: "enable_safety_checker", type: "boolean", fallback: true },
+    { key: "noise_scale", type: "number", fallback: 0.1 },
+    { key: "output_format", type: "enum(png|jpeg|webp)", fallback: "png" },
+    { key: "seed", type: "integer" },
+    { key: "target_resolution", type: "enum(720p|1080p|1440p|2160p)", fallback: "1080p" },
+    { key: "upscale_factor", type: "number", fallback: 2 },
+    { key: "upscale_mode", type: "enum(target|factor)", fallback: "factor" }
+  ],
+  "seedvr-upscale": [
+    { key: "noise_scale", type: "number", fallback: 0.1 },
+    { key: "output_format", type: "enum(png|jpg|webp)", fallback: "jpg" },
+    { key: "seed", type: "integer" },
+    { key: "target_resolution", type: "enum(720p|1080p|1440p|2160p)", fallback: "1080p" },
+    { key: "upscale_factor", type: "number", fallback: 2 },
+    { key: "upscale_mode", type: "enum(target|factor)", fallback: "factor" }
+  ],
+  "smart-resize": [
+    { key: "num_images_per_size", type: "integer", fallback: 1 },
+    { key: "output_format", type: "enum(jpeg|png|webp)", fallback: "png" },
+    { key: "prompt", type: "string", fallback: "" },
+    { key: "resolution", type: "enum(1K|2K|4K)", fallback: "1K" },
+    { key: "safety_tolerance", type: "enum(1|2|3|4|5|6)", fallback: "4" },
+    { key: "seed", type: "integer" },
+    { key: "target_sizes", type: "list[string]", required: true }
+  ],
+  "teed": [],
+  "text-removal": [
+    { key: "aspect_ratio", type: "enum(21:9|16:9|4:3|3:2|1:1|2:3|3:4|9:16|9:21)" },
+    { key: "guidance_scale", type: "number", fallback: 3.5 },
+    { key: "num_inference_steps", type: "integer", fallback: 30 },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "safety_tolerance", type: "enum(1|2|3|4|5|6)", fallback: "2" },
+    { key: "seed", type: "integer" }
+  ],
+  "topaz-adjust": [
+    { key: "model", type: "enum(Adjust V2|White Balance|Colorize)", fallback: "Adjust V2" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" }
+  ],
+  "topaz-creative": [
+    { key: "autoprompt", type: "boolean" },
+    { key: "color_preservation", type: "boolean" },
+    { key: "creativity", type: "integer" },
+    { key: "crop_to_fill", type: "boolean", fallback: false },
+    { key: "model", type: "enum(Bloom 2|Bloom|Bloom Realism)", fallback: "Bloom 2" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "topaz-denoise": [
+    { key: "model", type: "enum(Normal|Strong|Extreme|Denoise Max)", fallback: "Normal" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" }
+  ],
+  "topaz-generative": [
+    { key: "autoprompt", type: "boolean" },
+    { key: "creativity", type: "integer" },
+    { key: "crop_to_fill", type: "boolean", fallback: false },
+    { key: "denoise", type: "number" },
+    { key: "detail", type: "number" },
+    { key: "enhancement_strength", type: "enum(low|medium|high)" },
+    { key: "face_enhancement", type: "boolean", fallback: true },
+    { key: "face_enhancement_creativity", type: "number", fallback: 0 },
+    { key: "face_enhancement_strength", type: "number", fallback: 0.8 },
+    { key: "model", type: "enum(Wonder 3.5|Wonder 3|Wonder 2|Wonder|Recover 3|Standard MAX|Redefine|Recovery V2|Recovery)", fallback: "Wonder 3" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "prompt", type: "string" },
+    { key: "sharpen", type: "number" },
+    { key: "subject_detection", type: "enum(All|Foreground|Background)", fallback: "All" },
+    { key: "texture", type: "integer" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "topaz-image": [
+    { key: "autoprompt", type: "boolean" },
+    { key: "creativity", type: "integer" },
+    { key: "crop_to_fill", type: "boolean", fallback: false },
+    { key: "denoise", type: "number" },
+    { key: "detail", type: "number" },
+    { key: "enhancement_strength", type: "enum(low|medium|high)" },
+    { key: "face_enhancement", type: "boolean", fallback: true },
+    { key: "face_enhancement_creativity", type: "number", fallback: 0 },
+    { key: "face_enhancement_strength", type: "number", fallback: 0.8 },
+    { key: "fix_compression", type: "number" },
+    { key: "model", type: "enum(Standard V2|High Fidelity V2|Low Resolution V2|CGI|Text Refine|Wonder 3|Wonder|Standard MAX|Redefine|Recovery V2|Recovery)", fallback: "Standard V2" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "prompt", type: "string" },
+    { key: "sharpen", type: "number" },
+    { key: "strength", type: "number" },
+    { key: "subject_detection", type: "enum(All|Foreground|Background)", fallback: "All" },
+    { key: "texture", type: "integer" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "topaz-precision": [
+    { key: "crop_to_fill", type: "boolean", fallback: false },
+    { key: "denoise", type: "number" },
+    { key: "face_enhancement", type: "boolean", fallback: true },
+    { key: "face_enhancement_creativity", type: "number", fallback: 0 },
+    { key: "face_enhancement_strength", type: "number", fallback: 0.8 },
+    { key: "fix_compression", type: "number" },
+    { key: "model", type: "enum(Standard V2|High Fidelity V3|High Fidelity V2|Low Resolution V2|CGI|Text Refine)", fallback: "Standard V2" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" },
+    { key: "sharpen", type: "number" },
+    { key: "strength", type: "number" },
+    { key: "subject_detection", type: "enum(All|Foreground|Background)", fallback: "All" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "topaz-restore": [
+    { key: "model", type: "enum(Recover 3|Dust-Scratch V2)", fallback: "Recover 3" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" }
+  ],
+  "topaz-sharpen": [
+    { key: "model", type: "enum(Standard|Strong|Lens Blur V2|Motion Blur|Natural|Refocus|Wildlife|Portrait|Auto Sharpen|Super Focus V3|Super Focus V2)", fallback: "Standard" },
+    { key: "output_format", type: "enum(jpeg|png)", fallback: "jpeg" }
+  ],
+  "topaz-transparent": [
+    { key: "output_format", type: "string", fallback: "png" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "topaz-video": [
+    { key: "compression", type: "number" },
+    { key: "grain", type: "number" },
+    { key: "H264_output", type: "boolean", fallback: false },
+    { key: "halo", type: "number" },
+    { key: "model", type: "enum(Proteus|Artemis HQ|Artemis MQ|Artemis LQ|Gaia HQ|Gaia CG|Gaia 2|Nyx|Nyx Fast|Nyx XL|Nyx HF|Starlight Precise 2.5|Starlight HQ|Starlight Mini|Starlight Sharp|Starlight Fast 2|Starlight Precise 1|Starlight Precise 2|Starlight Fast 1)", fallback: "Proteus" },
+    { key: "noise", type: "number" },
+    { key: "recover_detail", type: "number" },
+    { key: "target_fps", type: "integer" },
+    { key: "upscale_factor", type: "number", fallback: 2 }
+  ],
+  "trellis-2": [
+    { key: "decimation_target", type: "integer", fallback: 5e5 },
+    { key: "remesh", type: "boolean", fallback: true },
+    { key: "remesh_band", type: "number", fallback: 1 },
+    { key: "remesh_project", type: "number", fallback: 0 },
+    { key: "resolution", type: "enum(512|1024|1536)", fallback: 1024 },
+    { key: "seed", type: "integer" },
+    { key: "shape_slat_guidance_interval_end", type: "number", fallback: 1 },
+    { key: "shape_slat_guidance_interval_start", type: "number", fallback: 0.6 },
+    { key: "shape_slat_guidance_rescale", type: "number", fallback: 0.5 },
+    { key: "shape_slat_guidance_strength", type: "number", fallback: 7.5 },
+    { key: "shape_slat_rescale_t", type: "number", fallback: 3 },
+    { key: "shape_slat_sampling_steps", type: "integer", fallback: 12 },
+    { key: "ss_guidance_interval_end", type: "number", fallback: 1 },
+    { key: "ss_guidance_interval_start", type: "number", fallback: 0.6 },
+    { key: "ss_guidance_rescale", type: "number", fallback: 0.7 },
+    { key: "ss_guidance_strength", type: "number", fallback: 7.5 },
+    { key: "ss_rescale_t", type: "number", fallback: 5 },
+    { key: "ss_sampling_steps", type: "integer", fallback: 12 },
+    { key: "tex_slat_guidance_interval_end", type: "number", fallback: 0.9 },
+    { key: "tex_slat_guidance_interval_start", type: "number", fallback: 0.6 },
+    { key: "tex_slat_guidance_rescale", type: "number", fallback: 0 },
+    { key: "tex_slat_guidance_strength", type: "number", fallback: 1 },
+    { key: "tex_slat_rescale_t", type: "number", fallback: 3 },
+    { key: "tex_slat_sampling_steps", type: "integer", fallback: 12 },
+    { key: "texture_size", type: "enum(1024|2048|4096)", fallback: 2048 },
+    { key: "uv_unwrap_angle_threshold_deg", type: "number", fallback: 90 },
+    { key: "uv_unwrap_global_iterations", type: "integer", fallback: 1 },
+    { key: "uv_unwrap_refine_iterations", type: "integer", fallback: 0 },
+    { key: "uv_unwrap_smooth_strength", type: "number", fallback: 1 }
+  ],
+  "zoe-depth": []
 };
-function toMotifError(error) {
-  if (error instanceof MotifError) {
-    return error;
+function falToolParameters(tool) {
+  return FAL_TOOL_PARAMETERS[tool] ?? [];
+}
+
+// src/model-output.generated.ts
+var MODEL_OUTPUT = {
+  "banana": { container: "png", lossless: true, bitDepth: 8 },
+  "banana2": { container: "png", lossless: true, bitDepth: 8 },
+  "flux": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "flux-fast": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "flux2-dev": { container: "png", lossless: true, bitDepth: 8 },
+  "flux2-flex": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "flux2-max": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "flux2-pro": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "flux2-turbo": { container: "png", lossless: true, bitDepth: 8 },
+  "gemini": { container: "png", lossless: true, bitDepth: 8 },
+  "gemini3": { container: "png", lossless: true, bitDepth: 8 },
+  "gpt": { container: "png", lossless: true, bitDepth: 8 },
+  "gpt2": { container: "png", lossless: true, bitDepth: 8 },
+  "grok-image": { container: "png", lossless: true, bitDepth: 8 },
+  "ideogram": { container: "png", lossless: true, bitDepth: 8 },
+  "ideogram4": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "qwen": { container: "png", lossless: true, bitDepth: 8 },
+  "qwen3": { container: "png", lossless: true, bitDepth: 8 },
+  "recraft": { container: "webp (lossless)", lossless: true, hasAlpha: true, bitDepth: 8 },
+  "recraft4": { container: "webp (lossless)", lossless: true, hasAlpha: true, bitDepth: 8 },
+  "seedream4": { container: "jpeg", subsampling: "4:4:4", lossless: false, bitDepth: 8 },
+  "seedream45": { container: "jpeg", subsampling: "4:2:0", lossless: false, bitDepth: 8 },
+  "seedream5": { container: "jpeg", subsampling: "4:2:0", lossless: false, bitDepth: 8 },
+  "seedream5-lite": { container: "jpeg", subsampling: "4:2:0", lossless: false, bitDepth: 8 }
+};
+
+// src/model-output.ts
+function modelOutput(model) {
+  return MODEL_OUTPUT[model];
+}
+function losslessAvailability(model) {
+  const shape = MODEL_OUTPUT[model];
+  if (shape === void 0) {
+    return "unknown";
   }
-  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);
+  if (shape.lossless) {
+    return "default";
+  }
+  return MODELS[model]?.supportsOutputFormat === true ? "on-request" : "unavailable";
+}
+function describeModelOutput(model) {
+  const shape = MODEL_OUTPUT[model];
+  if (shape === void 0) {
+    return "not measured";
+  }
+  const base = shape.subsampling === void 0 || shape.subsampling === "" ? shape.container : `${shape.container} ${shape.subsampling}`;
+  const suffix = {
+    default: "lossless",
+    "on-request": "lossless on request",
+    unavailable: "no lossless route",
+    unknown: "lossless route not measured"
+  };
+  return `${base}, ${suffix[losslessAvailability(model)]}`;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -3298,6 +4925,7 @@ function toMotifError(error) {
   FAL_TOOLS,
   FAL_TOOLS_CHECKED_AT,
   FAL_TOOL_IDS,
+  FAL_TOOL_PARAMETERS,
   FORMAT_PRESETS,
   FalClient,
   GENERATION_MODELS,
@@ -3305,6 +4933,7 @@ function toMotifError(error) {
   IMAGE_EDITING_TOP_20,
   IMAGE_TEXT_TO_IMAGE_TOP_20,
   MODELS,
+  MODEL_OUTPUT,
   MotifError,
   RECRAFT_STYLES,
   RESOLUTIONS,
@@ -3316,14 +4945,22 @@ function toMotifError(error) {
   aspectToGptSize,
   buildFalToolRequest,
   buildGenerateBody,
+  describeModelOutput,
   enrichPrompt,
   err,
   estimateCost,
   estimateVideoCost,
+  falToolParameters,
+  formatCost,
   getFalKeyFromEnv,
   isFalToolId,
+  losslessAvailability,
+  measuredToolCost,
+  modelOutput,
   motifEnvSchema,
   ok,
   parseMotifEnv,
-  sanitizePrompt
+  projectedToolCost,
+  sanitizePrompt,
+  sumCosts
 });