@howells/motif-sdk 1.3.1 → 4.0.0

package/dist/image.js

@@ -4,12 +4,133 @@ import { createFal } from "@ai-sdk/fal";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { createOpenAI } from "@ai-sdk/openai";
 import { createReplicate } from "@ai-sdk/replicate";
+//#region src/errors.ts
+/**
+* `MotifError` and its coercion helper.
+*
+* Extracted from `server.ts` so `server-tools.ts` can construct errors without
+* importing back into `server.ts` — that import was a dependency cycle. Both
+* `server.ts` and `server-tools.ts` import from here, and `server.ts`
+* re-exports `MotifError` so the package's public surface is unchanged.
+*/
+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;
+	/** Structured context for the failure, e.g. the refused field. */
+	details;
+	constructor(message, status, code, requestId, details) {
+		super(message);
+		this.name = "MotifError";
+		this.status = status;
+		this.code = code;
+		this.requestId = requestId;
+		this.details = details;
+	}
+};
+/** Error code for a fal account that is locked, usually for lack of credit. */
+const ACCOUNT_LOCKED = "ACCOUNT_LOCKED";
+const ACCOUNT_LOCKED_DETAIL = "User is locked";
+/**
+* Whether a fal HTTP failure means the account is locked.
+*
+* fal answers `403 {"detail":"User is locked. Reason: TOP_UP."}` when the
+* account has run out of credit. Retrying cannot help, and the key is valid.
+*/
+function isFalAccountLocked(status, body) {
+	return status === 403 && body.includes(ACCOUNT_LOCKED_DETAIL);
+}
+/**
+* Build the `MotifError` for a non-OK fal response, recognising a locked
+* account as `ACCOUNT_LOCKED`.
+*/
+function falHttpError(status, body, requestId) {
+	if (isFalAccountLocked(status, body)) return new MotifError(`fal account is locked because it is out of credit (fal said: ${body})`, status, ACCOUNT_LOCKED, requestId);
+	return new MotifError(`Request failed: ${status} ${body}`, status, void 0, requestId);
+}
+//#endregion
 //#region src/models.ts
 const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-08-23";
 const AA_IMAGE_SOURCES = ["https://artificialanalysis.ai/image/leaderboard/text-to-image", "https://artificialanalysis.ai/image/leaderboard/editing"];
 const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
+const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
+const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
 const MODELS = {
+	flare: {
+		customImageSize: {
+			maxEdge: 3840,
+			maxPixels: 8294400,
+			maxRatio: 3,
+			minPixels: 655360,
+			multipleOf: 16
+		},
+		editEndpoint: "openai/gpt-image-2.5/flare/edit",
+		endpoint: "openai/gpt-image-2.5/flare/text-to-image",
+		maxReferenceImages: 16,
+		name: "GPT Image 2.5 Flare",
+		pricing: "Token-based: text $5/M input, $1.25/M cached, $10/M output; image $8/M input, $2/M cached, $30/M output",
+		pricePerImageUsd: null,
+		sizeMode: "image_size_enum",
+		supportsAspect: true,
+		supportsBackground: true,
+		supportsEdit: true,
+		supportsMaskImage: true,
+		maskImageField: "mask_url",
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsQuality: true,
+		supportedQualities: [
+			"auto",
+			"low",
+			"medium",
+			"high",
+			"xhigh",
+			"max"
+		],
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation",
+		useQueue: true
+	},
+	sunburst: {
+		customImageSize: {
+			maxEdge: 3840,
+			maxPixels: 8294400,
+			maxRatio: 3,
+			minPixels: 655360,
+			multipleOf: 16
+		},
+		editEndpoint: "openai/gpt-image-2.5/sunburst/edit",
+		endpoint: "openai/gpt-image-2.5/sunburst/text-to-image",
+		maxReferenceImages: 16,
+		name: "GPT Image 2.5 Sunburst",
+		pricing: "Token-based: text $5/M input, $1.25/M cached, $10/M output; image $8/M input, $2/M cached, $30/M output",
+		pricePerImageUsd: null,
+		sizeMode: "image_size_enum",
+		supportsAspect: true,
+		supportsBackground: true,
+		supportsEdit: true,
+		supportsMaskImage: true,
+		maskImageField: "mask_url",
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsQuality: true,
+		supportedQualities: [
+			"auto",
+			"low",
+			"medium",
+			"high",
+			"xhigh",
+			"max"
+		],
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation",
+		useQueue: true
+	},
 	gpt2: {
 		benchmark: {
 			artificialAnalysis: {
@@ -36,7 +157,14 @@ const MODELS = {
 			},
 			useCase: "Highest-ranked text-to-image quality and transparent PNGs"
 		},
-		editEndpoint: "openai/gpt-image-2/image-to-image",
+		customImageSize: {
+			maxEdge: 3840,
+			maxPixels: 8294400,
+			maxRatio: 3,
+			minPixels: 655360,
+			multipleOf: 16
+		},
+		editEndpoint: "openai/gpt-image-2/edit",
 		endpoint: "openai/gpt-image-2",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -55,11 +183,18 @@ const MODELS = {
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsMaskImage: true,
+		maskImageField: "mask_url",
 		supportsNumImages: true,
 		supportsOutputFormat: true,
 		supportsQuality: true,
 		supportsResolution: false,
 		supportsSyncMode: true,
+		transparencyRoute: {
+			apiKeyEnv: "OPENAI_API_KEY",
+			model: "gpt-image-2",
+			provider: "openai",
+			supportsEdit: true
+		},
 		type: "generation",
 		useQueue: true
 	},
@@ -209,6 +344,24 @@ const MODELS = {
 		pricePerImageUsd: .15,
 		pricing: "$0.15",
 		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"21:9",
+			"16:9",
+			"3:2",
+			"4:3",
+			"5:4",
+			"1:1",
+			"4:5",
+			"3:4",
+			"2:3",
+			"9:16"
+		],
+		supportedResolutions: [
+			"1K",
+			"2K",
+			"4K"
+		],
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsGoogleSearch: true,
@@ -247,6 +400,18 @@ const MODELS = {
 		pricePerImageUsd: .0398,
 		pricing: "$0.04",
 		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"21:9",
+			"16:9",
+			"3:2",
+			"4:3",
+			"5:4",
+			"1:1",
+			"4:5",
+			"3:4",
+			"2:3",
+			"9:16"
+		],
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsNumImages: true,
@@ -286,6 +451,24 @@ const MODELS = {
 		pricePerImageUsd: .15,
 		pricing: "$0.15",
 		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"21:9",
+			"16:9",
+			"3:2",
+			"4:3",
+			"5:4",
+			"1:1",
+			"4:5",
+			"3:4",
+			"2:3",
+			"9:16"
+		],
+		supportedResolutions: [
+			"1K",
+			"2K",
+			"4K"
+		],
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsNumImages: true,
@@ -323,6 +506,10 @@ const MODELS = {
 			},
 			useCase: "High-ranked budget generation and large multi-reference edits"
 		},
+		customImageSize: {
+			maxPixels: 16777216,
+			minPixels: 921600
+		},
 		editEndpoint: "fal-ai/bytedance/seedream/v4/edit",
 		endpoint: "fal-ai/bytedance/seedream/v4/text-to-image",
 		falPricing: {
@@ -373,6 +560,10 @@ const MODELS = {
 			},
 			useCase: "Cheap current Seedream model with good animation/art scores"
 		},
+		customImageSize: {
+			maxPixels: 16777216,
+			minPixels: 3686400
+		},
 		editEndpoint: "fal-ai/bytedance/seedream/v4.5/edit",
 		endpoint: "fal-ai/bytedance/seedream/v4.5/text-to-image",
 		falPricing: {
@@ -410,6 +601,11 @@ const MODELS = {
 				rank: 10
 			}
 		} },
+		customImageSize: {
+			maxPixels: 4194304,
+			maxRatio: 16,
+			minPixels: 1048576
+		},
 		name: "Seedream 5.0 Pro",
 		endpoint: "bytedance/seedream/v5/pro/text-to-image",
 		editEndpoint: "bytedance/seedream/v5/pro/edit",
@@ -443,16 +639,20 @@ const MODELS = {
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES
 		} },
+		customImageSize: {
+			maxPixels: 16777216,
+			minPixels: 3686400
+		},
 		name: "Seedream 5.0 Lite",
-		endpoint: "fal-ai/bytedance/seedream/v5/lite/text-to-image",
-		editEndpoint: "fal-ai/bytedance/seedream/v5/lite/edit",
+		endpoint: "bytedance/seedream/v5/lite/text-to-image",
+		editEndpoint: "bytedance/seedream/v5/lite/edit",
 		type: "generation",
 		pricing: "$0.035",
 		pricePerImageUsd: .035,
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_JUL_2026,
 			currency: "USD",
-			endpointId: "fal-ai/bytedance/seedream/v5/lite/text-to-image",
+			endpointId: "bytedance/seedream/v5/lite/text-to-image",
 			estimatedCostPerImageUsd: .035,
 			source: "fal-pricing-api",
 			unit: "images",
@@ -493,6 +693,12 @@ const MODELS = {
 			},
 			useCase: "Best FLUX quality and high-end editing"
 		},
+		customImageSize: {
+			maxEdge: 2560,
+			maxPixels: 4194304,
+			minEdge: 256,
+			multipleOf: 16
+		},
 		editEndpoint: "fal-ai/flux-2-max/edit",
 		endpoint: "fal-ai/flux-2-max",
 		falPricing: {
@@ -546,6 +752,12 @@ const MODELS = {
 			},
 			useCase: "Production FLUX quality at a low per-megapixel price"
 		},
+		customImageSize: {
+			maxEdge: 2560,
+			maxPixels: 4194304,
+			minEdge: 256,
+			multipleOf: 16
+		},
 		editEndpoint: "fal-ai/flux-2-pro/edit",
 		endpoint: "fal-ai/flux-2-pro",
 		falPricing: {
@@ -595,6 +807,12 @@ const MODELS = {
 			},
 			useCase: "FLUX quality with guidance and step controls"
 		},
+		customImageSize: {
+			maxEdge: 2560,
+			maxPixels: 4194304,
+			minEdge: 256,
+			multipleOf: 16
+		},
 		editEndpoint: "fal-ai/flux-2-flex/edit",
 		endpoint: "fal-ai/flux-2-flex",
 		falPricing: {
@@ -643,6 +861,10 @@ const MODELS = {
 			},
 			useCase: "Open FLUX.2 quality with low average cost"
 		},
+		customImageSize: {
+			maxEdge: 2048,
+			minEdge: 512
+		},
 		editEndpoint: "fal-ai/flux-2/edit",
 		endpoint: "fal-ai/flux-2",
 		falPricing: {
@@ -673,6 +895,10 @@ const MODELS = {
 		type: "generation"
 	},
 	"flux2-turbo": {
+		customImageSize: {
+			maxEdge: 2048,
+			minEdge: 512
+		},
 		endpoint: "fal-ai/flux-2/turbo",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -728,6 +954,7 @@ const MODELS = {
 		type: "generation"
 	},
 	"flux-fast": {
+		customImageSize: {},
 		endpoint: "fal-ai/flux/schnell",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -754,11 +981,12 @@ const MODELS = {
 		type: "generation"
 	},
 	recraft: {
-		endpoint: "fal-ai/recraft-v3",
+		customImageSize: {},
+		endpoint: "fal-ai/recraft/v3/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
 			currency: "USD",
-			endpointId: "fal-ai/recraft-v3",
+			endpointId: "fal-ai/recraft/v3/text-to-image",
 			estimatedCostPerImageUsd: .04,
 			source: "fal-pricing-api",
 			unit: "images",
@@ -800,7 +1028,7 @@ const MODELS = {
 		editEndpoint: "fal-ai/reve/edit",
 		endpoint: "fal-ai/reve/text-to-image",
 		falPricing: {
-			checkedAt: "2026-08-23",
+			checkedAt: FAL_PRICING_CHECKED_AUG_2026,
 			currency: "USD",
 			endpointId: "fal-ai/reve/text-to-image",
 			estimatedCostPerImageUsd: .04,
@@ -813,6 +1041,15 @@ const MODELS = {
 		pricePerImageUsd: .04,
 		pricing: "$0.04",
 		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:3",
+			"3:4",
+			"1:1"
+		],
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsNumImages: true,
@@ -831,6 +1068,7 @@ const MODELS = {
 				rank: 25
 			}
 		} },
+		customImageSize: {},
 		endpoint: "fal-ai/recraft/v4/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -849,11 +1087,11 @@ const MODELS = {
 		supportsEdit: false,
 		supportsNumImages: false,
 		supportsResolution: false,
-		supportsStyle: true,
 		supportsSyncMode: true,
 		type: "generation"
 	},
 	ideogram: {
+		customImageSize: {},
 		endpoint: "fal-ai/ideogram/v3",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -889,6 +1127,11 @@ const MODELS = {
 				rank: 19
 			}
 		} },
+		customImageSize: {
+			maxEdge: 3840,
+			minEdge: 512,
+			multipleOf: 16
+		},
 		name: "Ideogram V4",
 		endpoint: "ideogram/v4",
 		type: "generation",
@@ -952,11 +1195,21 @@ const MODELS = {
 			unit: "images",
 			unitPrice: .02
 		},
-		maxReferenceImages: 4,
+		maxReferenceImages: 3,
 		name: "Grok Imagine Image",
 		pricePerImageUsd: .02,
 		pricing: "$0.02",
 		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
 		supportsAspect: true,
 		supportsEdit: true,
 		supportsNumImages: true,
@@ -983,6 +1236,7 @@ const MODELS = {
 			},
 			useCase: "Low-cost open-weight text and design generation"
 		},
+		customImageSize: {},
 		endpoint: "fal-ai/qwen-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -1027,19 +1281,23 @@ const MODELS = {
 			},
 			useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
 		},
-		endpoint: "fal-ai/qwen-image-3/text-to-image",
+		customImageSize: {
+			maxPixels: 4194304,
+			minPixels: 262144
+		},
+		endpoint: "alibaba/qwen-image-3/text-to-image",
 		falPricing: {
-			checkedAt: "2026-08-05",
+			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
 			currency: "USD",
-			endpointId: "fal-ai/qwen-image-3/text-to-image",
-			estimatedCostPerImageUsd: .02,
+			endpointId: "alibaba/qwen-image-3/text-to-image",
+			estimatedCostPerImageUsd: .04,
 			source: "fal-pricing-api",
-			unit: "megapixels",
-			unitPrice: .02
+			unit: "images",
+			unitPrice: .04
 		},
 		name: "Qwen Image 3",
-		pricePerImageUsd: .02,
-		pricing: "$0.02/MP (assumed from qwen v1; fal pricing page bot-gated at check time)",
+		pricePerImageUsd: .04,
+		pricing: "$0.04 (1K) / $0.075 (2K)",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
 		supportsEdit: false,
@@ -1051,6 +1309,179 @@ const MODELS = {
 		supportsSeed: true,
 		type: "generation"
 	},
+	"mai-image-2.5-pro": {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1272,
+					rank: 1
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1293,
+					rank: 7
+				}
+			},
+			useCase: "Highest-ranked image editor, single reference image"
+		},
+		editEndpoint: "microsoft/mai-image-2.5-pro/edit",
+		editImagesField: "image_url",
+		endpoint: "microsoft/mai-image-2.5-pro",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
+			currency: "USD",
+			endpointId: "microsoft/mai-image-2.5-pro",
+			estimatedCostPerImageUsd: .17,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .17
+		},
+		maxReferenceImages: 1,
+		name: "MAI Image 2.5 Pro",
+		pricePerImageUsd: .17,
+		pricing: "~$0.17 (edit ~$0.18-$0.27)",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	"banana2-lite": {
+		benchmark: { artificialAnalysis: {
+			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+			sourceUrls: AA_IMAGE_SOURCES,
+			textToImage: {
+				elo: 1289,
+				rank: 8
+			}
+		} },
+		endpoint: "google/nano-banana-2-lite",
+		name: "Nano Banana 2 Lite",
+		pricing: "Token-based: text $0.3125/M input, $1.875/M output; image $0.3125/M input, $37.50/M output; fixed 1K output (~$0.048)",
+		pricePerImageUsd: .048,
+		sizeMode: "aspect_ratio",
+		supportsAspect: true,
+		supportsEdit: false,
+		supportsLimitGenerations: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSafetyTolerance: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		supportsThinkingLevel: true,
+		type: "generation"
+	},
+	"ideogram3-transparent": {
+		endpoint: "fal-ai/ideogram/v3/generate-transparent",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
+			currency: "USD",
+			endpointId: "fal-ai/ideogram/v3/generate-transparent",
+			estimatedCostPerImageUsd: .06,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .06
+		},
+		name: "Ideogram V3 Transparent",
+		pricePerImageUsd: .06,
+		pricing: "$0.03 TURBO / $0.06 BALANCED / $0.09 QUALITY",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:3",
+			"3:4",
+			"5:4",
+			"4:5",
+			"1:1"
+		],
+		supportsAspect: true,
+		supportsEdit: false,
+		supportsExpandPrompt: true,
+		supportsNegativePrompt: true,
+		supportsNumImages: true,
+		supportsRenderingSpeed: true,
+		supportsResolution: false,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		transparentOutput: true,
+		type: "generation"
+	},
+	recraft41: {
+		customImageSize: {},
+		endpoint: "fal-ai/recraft/v4.1/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
+			currency: "USD",
+			endpointId: "fal-ai/recraft/v4.1/text-to-image",
+			estimatedCostPerImageUsd: .035,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .035
+		},
+		name: "Recraft V4.1",
+		pricePerImageUsd: .035,
+		pricing: "$0.035",
+		sizeMode: "image_size_enum",
+		supportsAspect: true,
+		supportsEdit: false,
+		supportsNumImages: false,
+		supportsResolution: false,
+		supportsSafetyChecker: true,
+		type: "generation"
+	},
+	"grok-image-2": {
+		editEndpoint: "xai/grok-imagine-image/v2.0/edit",
+		endpoint: "xai/grok-imagine-image/v2.0/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
+			currency: "USD",
+			endpointId: "xai/grok-imagine-image/v2.0/text-to-image",
+			estimatedCostPerImageUsd: .06,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .06
+		},
+		maxReferenceImages: 3,
+		name: "Grok Imagine Image 2.0",
+		pricePerImageUsd: .06,
+		pricing: "$0.06 (1K) / $0.08 (2K) at medium quality",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
 	kling: {
 		endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
 		name: "Kling v3 Pro",
@@ -1062,6 +1493,17 @@ const MODELS = {
 		supportsResolution: false,
 		type: "video"
 	},
+	"kling-turbo": {
+		endpoint: "fal-ai/kling-video/v3/turbo/pro/image-to-video",
+		name: "Kling v3 Turbo Pro",
+		pricing: "$0.14/sec",
+		sizeMode: "none",
+		supportsAspect: false,
+		supportsEdit: false,
+		supportsNumImages: false,
+		supportsResolution: false,
+		type: "video"
+	},
 	clarity: {
 		endpoint: "fal-ai/clarity-upscaler",
 		name: "Clarity Upscaler",
@@ -1104,6 +1546,8 @@ const MODELS = {
 	}
 };
 [
+	"flare",
+	"sunburst",
 	"gpt2",
 	"gpt",
 	"banana2",
@@ -1126,33 +1570,202 @@ const MODELS = {
 	"ideogram",
 	"ideogram4",
 	"grok-image",
+	"grok-image-2",
 	"qwen",
-	"qwen3"
+	"qwen3",
+	"mai-image-2.5-pro",
+	"banana2-lite",
+	"ideogram3-transparent",
+	"recraft41"
 ].filter((id) => MODELS[id]?.supportsEdit === true);
 //#endregion
-//#region src/errors.ts
-/**
-* `MotifError` and its coercion helper.
-*
-* Extracted from `server.ts` so `server-tools.ts` can construct errors without
-* importing back into `server.ts` — that import was a dependency cycle. Both
-* `server.ts` and `server-tools.ts` import from here, and `server.ts`
-* re-exports `MotifError` so the package's public surface is unchanged.
-*/
-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;
-	}
+//#region src/capabilities.ts
+/** Generation options a model can refuse, with the registry test for each. */
+const OPTION_CAPABILITIES = {
+	aspect: (config) => (config.sizeMode ?? "aspect_ratio") !== "none",
+	background: (config) => config.supportsBackground === true,
+	enableGoogleSearch: (config) => config.supportsGoogleSearch === true,
+	enableSafetyChecker: (config) => config.supportsSafetyChecker === true,
+	enableWebSearch: (config) => config.supportsWebSearch === true,
+	enhancePrompt: (config) => config.supportsEnhancePrompt === true,
+	expandPrompt: (config) => config.supportsExpandPrompt === true,
+	guidanceScale: (config) => config.supportsGuidanceScale === true,
+	"image editing": (config) => config.supportsEdit,
+	imagePromptStrength: (config) => config.supportsImagePromptStrength === true,
+	imageSize: (config) => config.sizeMode === "gpt_size" || config.sizeMode === "image_size_enum",
+	inputFidelity: (config) => config.sizeMode === "gpt_size",
+	limitGenerations: (config) => config.supportsLimitGenerations === true,
+	maskImageUrl: (config) => config.supportsMaskImage === true,
+	negativePrompt: (config) => config.supportsNegativePrompt === true,
+	numImages: (config) => config.supportsNumImages,
+	numInferenceSteps: (config) => config.supportsInferenceSteps === true,
+	outputFormat: (config) => config.supportsOutputFormat === true,
+	quality: (config) => config.supportsQuality === true,
+	raw: (config) => config.supportsRaw === true,
+	renderingSpeed: (config) => config.supportsRenderingSpeed === true,
+	resolution: (config) => config.supportsResolution,
+	safetyTolerance: (config) => config.supportsSafetyTolerance === true,
+	seed: (config) => config.supportsSeed === true,
+	style: (config) => config.supportsStyle === true,
+	syncMode: (config) => config.supportsSyncMode === true,
+	thinkingLevel: (config) => config.supportsThinkingLevel === true,
+	"transparent output": (config) => config.supportsBackground === true || config.transparentOutput === true
 };
+function isModelOption(key) {
+	return Object.hasOwn(OPTION_CAPABILITIES, key);
+}
+Object.keys(OPTION_CAPABILITIES).filter(isModelOption);
+({
+	look: [
+		{
+			acceptsMood: true,
+			aspect: "1:1",
+			clause: "Editorial photograph in the register of Atelier Ellis, Aman hotels, Kinfolk magazine and Aesop, pigment-rich mineral colour on named matte surfaces, quiet composition with generous negative space, shallow depth of field, shot on film with fine grain, restrained and materially rich. No text, no logos, no people",
+			description: "Quiet, materially rich editorial photography for brand and mood imagery.",
+			id: "editorial",
+			label: "Quiet editorial",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: true,
+			aspect: "1:1",
+			clause: "Editorial still life on a warm bone plaster ground, chalky unglazed surfaces, a long soft shadow, generous empty space, shot on film with fine grain. No text, no logos, no people",
+			description: "Objects and material samples on a plaster ground, for product and swatch shots.",
+			id: "still-life",
+			label: "Material still life",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: true,
+			aspect: "3:2",
+			clause: "Interior photograph shot square-on at eye level on a 35mm lens, warm off-white plaster, wide oak floorboards, linen, brass and a little pattern, light, bright and layered, collected rather than styled, slightly imperfect and lived-in rather than showroom-perfect, photographic realism. No text, no logos, no people",
+			description: "Bright, collected rooms that feel lived in, for interior scenes.",
+			id: "lived-in",
+			label: "Lived-in interior",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: true,
+			aspect: "4:5",
+			clause: "Architectural editorial photograph at full room scale, honest materials meeting precise detailing, one hero element genuinely installed, plausible light and shadow, generous negative space, empty of people. No text, no logos",
+			description: "Whole rooms with one product installed, for showing a material at scale.",
+			id: "architectural",
+			label: "Architectural scale",
+			model: "banana"
+		},
+		{
+			acceptsMood: true,
+			aspect: "4:3",
+			clause: "Amateur phone photo of a real home taken by the homeowner, slightly wonky framing, unstyled domestic photography, ordinary exposure. No text, no people",
+			description: "Unstyled phone snapshots of real homes, for believable before and after shots.",
+			id: "homeowner",
+			label: "Homeowner snapshot",
+			model: "seedream45"
+		},
+		{
+			acceptsMood: true,
+			aspect: "1:1",
+			clause: "Stylised architectural illustration of the room, colour laid as flat planes on walls, joinery and trim, fine hand-drawn line with a gentle gouache wash, clearly a drawing of a design decision rather than a photograph. No text, no people",
+			description: "Line and gouache room drawings, for showing a colour scheme as a design idea.",
+			experimental: true,
+			id: "drawing",
+			label: "Palette drawing",
+			model: "gpt2"
+		},
+		{
+			acceptsMood: false,
+			aspect: "1:1",
+			clause: "Straight-on orthographic photograph of the surface filling the entire frame edge to edge, even shadowless studio light, crisp macro texture, colour-accurate. No text, no logos",
+			description: "Flat, edge-to-edge surface photographs, for textures and material swatches.",
+			id: "plate",
+			label: "Flat plate",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: false,
+			aspect: "1:1",
+			clause: "Fine hand-engraved botanical plate with delicate hatching and dry brush, grey ink only, reaching near-black at its densest, on matte uncoated stock under flat even light, cropped mid-motif and running past all four edges, never simplified or cartoonish. No text",
+			description: "Grey-ink botanical engravings that run off the edges, for patterns and backgrounds.",
+			id: "engraved",
+			label: "Engraved grey ink",
+			model: "gpt2"
+		},
+		{
+			acceptsMood: false,
+			aspect: "2:3",
+			clause: "Tightly cropped photograph of a single piece of late-1940s American printed matter, flat and square-on in even light, every pixel paper, letterpress and wood type, sun-faded ink, foxing, soft creases and thumbtack holes, era-correct typography, nothing that looks like a digital photo run through a filter",
+			description: "Aged mid-century printed matter such as posters and cards, where the lettering matters.",
+			id: "ephemera",
+			label: "Period ephemera",
+			model: "ideogram4"
+		},
+		{
+			acceptsMood: false,
+			aspect: "3:4",
+			clause: "Physical mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse museum reproduction lighting, shown unframed. No text",
+			description: "Loose abstract paintings on linen, for wall art and calm backgrounds.",
+			id: "canvas",
+			label: "Linen abstract",
+			model: "banana"
+		},
+		{
+			acceptsMood: true,
+			aspect: "1:1",
+			clause: "Editorial documentary portrait, muted warm palette, waist-up, unposed, plain clothing with no logos. No text",
+			description: "Natural, unposed documentary portraits of people. Pair with a mood for the light.",
+			id: "portrait",
+			label: "Documentary portrait",
+			model: "seedream45"
+		},
+		{
+			acceptsMood: false,
+			aspect: "1:1",
+			clause: "A single matte object centred with generous empty space, soft diffused studio light, minimal and quiet, one committed colour. No text, no logos, no people",
+			description: "One object in one colour on a clean ground, for icons and simple product shots.",
+			id: "object",
+			label: "Studio object",
+			model: "flux2-pro"
+		}
+	],
+	mood: [
+		{
+			clause: "soft natural daylight from a window out of frame, gentle falloff into the corners, low contrast, even diffused light with soft, held highlights",
+			description: "Soft, even daylight from a window. The safe default.",
+			id: "window",
+			label: "Window light"
+		},
+		{
+			clause: "early morning light through tall glazing, cool and clear",
+			description: "Cool, clear early morning light.",
+			id: "dawn",
+			label: "Dawn"
+		},
+		{
+			clause: "low raking daylight from the left, long soft shadows that reveal texture",
+			description: "Low side light that brings out surface texture.",
+			id: "raking",
+			label: "Raking light"
+		},
+		{
+			clause: "overcast afternoon with rain on a tall window, soft even grey light",
+			description: "Soft grey light on a rainy afternoon.",
+			id: "overcast",
+			label: "Overcast"
+		},
+		{
+			clause: "evening, warm practical lamps around 2400K, candles and a lit fire, cosy and warm, never gloomy",
+			description: "Warm evening light from lamps, candles and a fire.",
+			id: "lamplit",
+			label: "Lamplit evening"
+		},
+		{
+			clause: "night, one warm low practical light, deep shadow, candlelit",
+			description: "Dark night scene lit by one warm low light.",
+			id: "nocturne",
+			label: "Nocturne"
+		}
+	]
+}).look;
 //#endregion
 //#region src/tool-registry/analysis.ts
 const ANALYSIS_TOOLS = {
@@ -1164,7 +1777,11 @@ const ANALYSIS_TOOLS = {
 		inputKind: "images",
 		name: "GOT-OCR 2.0",
 		outputKeys: ["outputs"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			per: ["input_image_urls"],
+			usd: .05
+		},
 		pricing: "$0.05/image",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/got-ocr/v2",
@@ -1178,7 +1795,13 @@ const ANALYSIS_TOOLS = {
 		inputKind: "image",
 		name: "Moondream 3 Caption",
 		outputKeys: ["output"],
-		price: { kind: "metered" },
+		price: {
+			inputPerMillion: .4,
+			inputTokens: 737,
+			kind: "token",
+			outputPerMillion: 3.5,
+			outputTokens: 200
+		},
 		pricing: "$0.40/M input tokens, $3.50/M output tokens",
 		sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/caption",
 		task: "image captioning"
@@ -1191,7 +1814,13 @@ const ANALYSIS_TOOLS = {
 		inputKind: "image",
 		name: "Moondream 3 Detect",
 		outputKeys: ["objects", "image"],
-		price: { kind: "metered" },
+		price: {
+			inputPerMillion: .4,
+			inputTokens: 737,
+			kind: "token",
+			outputPerMillion: 3.5,
+			outputTokens: 100
+		},
 		pricing: "$0.40/M input tokens, $3.50/M output tokens",
 		sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/detect",
 		task: "object detection"
@@ -1204,7 +1833,13 @@ const ANALYSIS_TOOLS = {
 		inputKind: "image",
 		name: "Moondream 3 Point",
 		outputKeys: ["points", "image"],
-		price: { kind: "metered" },
+		price: {
+			inputPerMillion: .4,
+			inputTokens: 737,
+			kind: "token",
+			outputPerMillion: 3.5,
+			outputTokens: 100
+		},
 		pricing: "$0.40/M input tokens, $3.50/M output tokens",
 		sourceUrl: "https://fal.ai/models/fal-ai/moondream3-preview/point",
 		task: "object pointing"
@@ -1217,7 +1852,13 @@ const ANALYSIS_TOOLS = {
 		inputKind: "image",
 		name: "Moondream 3 Query",
 		outputKeys: ["output", "reasoning"],
-		price: { kind: "metered" },
+		price: {
+			inputPerMillion: .4,
+			inputTokens: 737,
+			kind: "token",
+			outputPerMillion: 3.5,
+			outputTokens: 500
+		},
 		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"
@@ -1230,7 +1871,11 @@ const ANALYSIS_TOOLS = {
 		inputKind: "images",
 		name: "NSFW Checker",
 		outputKeys: ["has_nsfw_concepts"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			per: ["image_urls"],
+			usd: .001
+		},
 		pricing: "$0.001/image",
 		sourceUrl: "https://fal.ai/models/fal-ai/x-ailab/nsfw",
 		task: "vision moderation"
@@ -1314,6 +1959,34 @@ const ASSET_TOOLS = {
 		sourceUrl: "https://fal.ai/models/fal-ai/image2svg",
 		task: "raster to vector tracing"
 	},
+	"meshy-v7": {
+		category: "3d",
+		description: "Make a textured 3D mesh from one image, optionally rigged for animation.",
+		endpoint: "meshy/v7/image-to-3d",
+		inputField: "image_url",
+		inputKind: "image",
+		name: "Meshy v7 Image to 3D",
+		outputKeys: [
+			"model_glb",
+			"model_urls",
+			"thumbnail",
+			"rigged_character_glb",
+			"rigged_character_fbx"
+		],
+		price: {
+			extras: {
+				enable_animation: .12,
+				enable_rigging: .2,
+				ultra_mode: .2
+			},
+			kind: "call",
+			usd: 1.2
+		},
+		pricing: "$1.20/generation at the default textured model; $0.80 untextured, $1.40 ultra, plus $0.20 for rigging and $0.12 for animation",
+		queued: true,
+		sourceUrl: "https://fal.ai/models/meshy/v7/image-to-3d",
+		task: "single-image 3D reconstruction"
+	},
 	patina: {
 		category: "material",
 		description: "Decompose a surface photograph into PBR maps: basecolor, normal, roughness, metalness, height.",
@@ -1332,7 +2005,12 @@ const ASSET_TOOLS = {
 			],
 			fromOption: "maps"
 		} },
-		price: { kind: "metered" },
+		price: {
+			base: .01,
+			kind: "maps",
+			perMapMegapixel: .01,
+			perMegapixel: 0
+		},
 		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",
@@ -1356,8 +2034,17 @@ const ASSET_TOOLS = {
 			],
 			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",
+		price: {
+			base: .1,
+			kind: "maps",
+			perMapMegapixel: .01,
+			perMegapixel: .02,
+			upscale: {
+				"2": .004,
+				"4": .016
+			}
+		},
+		pricing: "$0.10 plus $0.02/megapixel plus $0.01/megapixel per map, so 1MP with all 5 maps is $0.17; upscaling adds $0.004 (2x) or $0.016 (4x) per pre-upscale megapixel per map",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/patina/material/extract",
 		task: "tiling material extraction"
@@ -1370,8 +2057,11 @@ const ASSET_TOOLS = {
 		inputKind: "image",
 		name: "Qwen Image Layered",
 		outputKeys: ["images"],
-		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",
+		price: {
+			kind: "call",
+			usd: .05
+		},
+		pricing: "$0.05 per image, one input image a call",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/qwen-image-layered",
 		task: "image layer decomposition"
@@ -1438,7 +2128,6 @@ const ASSET_TOOLS = {
 	},
 	"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",
@@ -1544,7 +2233,10 @@ const BACKGROUND_TOOLS = {
 		inputKind: "image",
 		name: "BirefNet Background Removal",
 		outputKeys: ["image", "mask_image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/birefnet/v2",
 		task: "image background removal"
@@ -1580,13 +2272,51 @@ const BACKGROUND_TOOLS = {
 		outputKeys: ["video"],
 		price: {
 			kind: "second",
-			usd: .00425
+			usd: .14
 		},
-		pricing: "$0.00425/sec",
+		pricing: "$0.14/sec",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/bria/video/background-removal",
 		task: "video background removal"
 	},
+	"bria-video-rmbg-v3": {
+		category: "background",
+		defaultOptions: {
+			background_color: "Black",
+			output_container_and_codec: "webm_vp9",
+			preserve_audio: true
+		},
+		description: "Remove video backgrounds with Bria's VRMBG 3.0, with configurable output container.",
+		endpoint: "bria/video/background-removal/v3",
+		inputField: "video_url",
+		inputKind: "video",
+		name: "Bria Video Background Removal 3.0",
+		outputKeys: ["video"],
+		price: {
+			kind: "second",
+			usd: .05
+		},
+		pricing: "$0.05/sec",
+		queued: true,
+		sourceUrl: "https://fal.ai/models/bria/video/background-removal/v3",
+		task: "video background removal"
+	},
+	"control-light": {
+		category: "restoration",
+		description: "Brighten a dark or underexposed photo, recovering detail while keeping its identity, geometry and colour.",
+		endpoint: "fal-ai/control-light",
+		inputField: "image_url",
+		inputKind: "image",
+		name: "Control Light",
+		outputKeys: ["images"],
+		price: {
+			kind: "megapixel",
+			usd: .03
+		},
+		pricing: "$0.03/megapixel",
+		sourceUrl: "https://fal.ai/models/fal-ai/control-light",
+		task: "low-light enhancement"
+	},
 	ddcolor: {
 		category: "restoration",
 		description: "Colourise black-and-white photographs.",
@@ -1612,7 +2342,10 @@ const BACKGROUND_TOOLS = {
 		inputKind: "image",
 		name: "Remove Background",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/imageutils/rembg",
 		task: "image background removal"
@@ -1645,8 +2378,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Adjust",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 per 24 output megapixels",
 		queued: true,
@@ -1663,10 +2397,11 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Creative Upscale",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .96 / 24
+			kind: "megapixel-step",
+			megapixels: 2,
+			usd: .08
 		},
-		pricing: "$0.96 per 24 output megapixels",
+		pricing: "$0.08 per started 2 output megapixels, any Bloom model",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/topaz/upscale/image/creative",
 		task: "creative image upscaling"
@@ -1681,8 +2416,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Denoise",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 per 24 output megapixels at the default Normal model; $0.16 with Denoise Max",
 		queued: true,
@@ -1699,10 +2435,11 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Generative Upscale",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .24 / 24
+			kind: "megapixel-step",
+			megapixels: 8,
+			usd: .08
 		},
-		pricing: "$0.24 per 24 output megapixels at the default Wonder 3; $0.48 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3",
+		pricing: "$0.08 per started 8 output megapixels at the default Wonder 3; per started 4 with Wonder, Wonder 2, Standard MAX, Redefine or Recover 3",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/topaz/upscale/image/generative",
 		task: "generative image upscaling"
@@ -1721,8 +2458,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Image Upscale",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 for output up to 24MP; $0.16 to 48MP, $0.32 to 96MP, up to $1.36 at 512MP",
 		queued: true,
@@ -1739,8 +2477,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Precision Upscale",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 per 24 output megapixels, any precision model",
 		queued: true,
@@ -1757,8 +2496,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Restore",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .48 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .48
 		},
 		pricing: "$0.48 per 24 output megapixels at the default Recover 3; $0.08 with Dust-Scratch V2",
 		queued: true,
@@ -1775,8 +2515,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Sharpen",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 per 24 output megapixels at the default Standard model; $0.16 with Super Focus",
 		queued: true,
@@ -1792,8 +2533,9 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Transparent Upscale",
 		outputKeys: ["image"],
 		price: {
-			kind: "megapixel",
-			usd: .08 / 24
+			kind: "megapixel-step",
+			megapixels: 24,
+			usd: .08
 		},
 		pricing: "$0.08 per 24 output megapixels",
 		queued: true,
@@ -1813,10 +2555,22 @@ const BACKGROUND_TOOLS = {
 		name: "Topaz Video Upscale",
 		outputKeys: ["video"],
 		price: {
-			kind: "second",
-			usd: .01
+			doubleAtFps: 60,
+			halfWithModel: "Gaia 2",
+			kind: "video-second",
+			tiers: [
+				{
+					upTo: 720,
+					usd: .01
+				},
+				{
+					upTo: 1080,
+					usd: .02
+				},
+				{ usd: .08 }
+			]
 		},
-		pricing: "$0.01/sec up to 720p; $0.02 to 1080p, $0.08 above, doubled at 60fps, halved with Gaia 2",
+		pricing: "$0.01/sec up to 720p output; $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"
@@ -1867,6 +2621,7 @@ const EDITING_TOOLS = {
 		outputKeys: ["images"],
 		price: {
 			kind: "call",
+			perImage: true,
 			usd: .04
 		},
 		pricing: "$0.04/generation",
@@ -1897,7 +2652,11 @@ const EDITING_TOOLS = {
 		inputKind: "image",
 		name: "FLUX.2 Pro Outpaint",
 		outputKeys: ["images"],
-		price: { kind: "metered" },
+		price: {
+			extra: .015,
+			first: .03,
+			kind: "megapixel-first"
+		},
 		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"
@@ -1928,6 +2687,7 @@ const EDITING_TOOLS = {
 		outputKeys: ["images"],
 		price: {
 			kind: "call",
+			perImage: true,
 			usd: .06
 		},
 		pricing: "$0.06/image at the default BALANCED speed; $0.03 turbo, $0.09 quality",
@@ -2022,12 +2782,35 @@ const EDITING_TOOLS = {
 		inputKind: "image",
 		name: "Smart Resize",
 		outputKeys: ["images", "results"],
-		price: { kind: "metered" },
+		price: {
+			fee: .05,
+			kind: "call",
+			multipliers: { resolution: { "4K": 2 } },
+			per: ["target_sizes", "num_images_per_size"],
+			usd: .15
+		},
 		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"
 	},
+	"telestyle-v2": {
+		category: "restyle",
+		description: "Redraw a content image in the style of a second, style image.",
+		endpoint: "fal-ai/telestyle-v2",
+		inputField: "content_image_url",
+		inputKind: "image",
+		name: "TeleStyle v2",
+		outputKeys: ["images"],
+		price: {
+			kind: "megapixel",
+			usd: .035
+		},
+		pricing: "$0.035/megapixel",
+		referenceField: "style_image_url",
+		sourceUrl: "https://fal.ai/models/fal-ai/telestyle-v2",
+		task: "style transfer from a reference image"
+	},
 	"text-removal": {
 		category: "erase",
 		defaultOptions: { output_format: "png" },
@@ -2044,6 +2827,25 @@ const EDITING_TOOLS = {
 		pricing: "$0.04/image",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-editing/text-removal",
 		task: "text removal"
+	},
+	"virtual-try-on": {
+		category: "try-on",
+		description: "Dress the person in one image in the garment shown in another.",
+		endpoint: "google/virtual-try-on",
+		inputField: "person_image_url",
+		inputKind: "image",
+		name: "Google Virtual Try-On",
+		outputKeys: ["images"],
+		price: {
+			kind: "call",
+			perImage: true,
+			usd: .075
+		},
+		pricing: "$0.075/image",
+		queued: true,
+		referenceField: "product_image_url",
+		sourceUrl: "https://fal.ai/models/google/virtual-try-on",
+		task: "virtual garment try-on"
 	}
 };
 //#endregion
@@ -2057,7 +2859,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "Depth Anything v2 Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/depth-anything/v2",
 		task: "depth preprocessing"
@@ -2086,7 +2891,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "HED Edge Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/hed",
 		task: "edge preprocessing"
@@ -2100,7 +2908,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "Line Art Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/lineart",
 		task: "image preprocessing"
@@ -2117,7 +2928,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "Marigold Depth Estimation",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/imageutils/marigold-depth",
 		task: "depth map"
@@ -2134,7 +2948,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "MiDaS Depth Estimation",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/imageutils/depth",
 		task: "depth map"
@@ -2147,7 +2964,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "MiDaS Preprocessor",
 		outputKeys: ["depth_map", "normal_map"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/midas",
 		task: "depth and normal preprocessing"
@@ -2160,7 +2980,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "M-LSD Line Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/mlsd",
 		task: "line segment preprocessing"
@@ -2173,7 +2996,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "PiDiNet Edge Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/pidi",
 		task: "edge preprocessing"
@@ -2186,7 +3012,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "SAM Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/sam",
 		task: "segmentation preprocessing"
@@ -2206,7 +3035,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "SAM 2 Auto Segment",
 		outputKeys: ["combined_mask", "individual_masks"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/sam2/auto-segment",
@@ -2251,7 +3083,11 @@ const STRUCTURE_TOOLS = {
 		inputKind: "video",
 		name: "SAM 3.1 Video",
 		outputKeys: ["video", "boundingbox_frames_zip"],
-		price: { kind: "metered" },
+		price: {
+			frames: 16,
+			kind: "frames",
+			usd: .01
+		},
 		pricing: "$0.01/16 frames of video input",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/sam-3-1/video",
@@ -2323,7 +3159,11 @@ const STRUCTURE_TOOLS = {
 		inputKind: "video",
 		name: "SAM 3 Video",
 		outputKeys: ["video", "boundingbox_frames_zip"],
-		price: { kind: "metered" },
+		price: {
+			frames: 16,
+			kind: "frames",
+			usd: .005
+		},
 		pricing: "$0.005/16 frames of video input",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video",
@@ -2342,7 +3182,11 @@ const STRUCTURE_TOOLS = {
 		inputKind: "video",
 		name: "SAM 3 Video RLE",
 		outputKeys: ["video", "boundingbox_frames_zip"],
-		price: { kind: "metered" },
+		price: {
+			frames: 16,
+			kind: "frames",
+			usd: .005
+		},
 		pricing: "$0.005/16 frames of video",
 		queued: true,
 		sourceUrl: "https://fal.ai/models/fal-ai/sam-3/video-rle",
@@ -2356,7 +3200,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "Scribble Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/scribble",
 		task: "scribble preprocessing"
@@ -2369,7 +3216,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "TEED Edge Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/teed",
 		task: "edge preprocessing"
@@ -2382,7 +3232,10 @@ const STRUCTURE_TOOLS = {
 		inputKind: "image",
 		name: "ZoeDepth Preprocessor",
 		outputKeys: ["image"],
-		price: { kind: "metered" },
+		price: {
+			kind: "call",
+			usd: 0
+		},
 		pricing: "$0/compute-second listed by fal",
 		sourceUrl: "https://fal.ai/models/fal-ai/image-preprocessors/zoe",
 		task: "depth preprocessing"
@@ -2399,6 +3252,17 @@ const FAL_TOOLS = {
 };
 Object.keys(FAL_TOOLS);
 //#endregion
+//#region src/image/fetch.ts
+function urlOf(input) {
+	if (typeof input === "string") return input;
+	return input instanceof URL ? input.href : input.url;
+}
+/** Adapt a configured fetch for a provider factory; undefined keeps global fetch. */
+function toProviderFetch(fetch) {
+	if (fetch === void 0) return {};
+	return { fetch: async (input, init) => await fetch(urlOf(input), init ?? {}) };
+}
+//#endregion
 //#region src/image/fal.ts
 /**
 * fal provider adapter.
@@ -2416,35 +3280,22 @@ Object.keys(FAL_TOOLS);
 * need a specific size. Example:
 *   img.generate({
 *     provider: "fal",
-*     tier: "balanced",
+*     model: "fal-ai/gpt-image-1.5",
 *     prompt: "...",
 *     providerOptions: { fal: { image_size: "1024x1024" } },
 *   });
 */
 /**
-* fal model ids by tier. `fast` uses FLUX Pro Ultra (fast, cheap); the higher
-* tiers use fal's gpt-image endpoint for its edit quality. Both are proven fal
-* endpoints that also exist in the `../models` registry snapshot.
+* fal endpoint ids proven to work with this adapter and priced in
+* {@link FAL_IMAGE_PRICE_USD} below (FLUX Pro Ultra + gpt-image).
 */
 const FAL_FLUX_MODEL = "fal-ai/flux-pro/v1.1-ultra";
 const FAL_GPT_IMAGE_MODEL = "fal-ai/gpt-image-1.5";
-/**
-* Tier → fal model id. For fal, explicit `model:` endpoint ids are the primary
-* path (any fal endpoint resolves via passthrough); this tier map is a
-* convenience covering the two most common (FLUX Pro Ultra + gpt-image).
-*/
-const FAL_TIER_MODELS = {
-	fast: FAL_FLUX_MODEL,
-	balanced: FAL_GPT_IMAGE_MODEL,
-	quality: FAL_GPT_IMAGE_MODEL,
-	hero: FAL_GPT_IMAGE_MODEL
-};
 /** Env var read for the fal key when `apiKey` is not supplied in config. */
 const FAL_API_KEY_ENV = "FAL_KEY";
 /**
-* Static fal USD/image, keyed by the fal ENDPOINT id. Explicit `model:` endpoint
-* ids are fal's primary path (the tier map covers only two), so cost tracking
-* must price the endpoints consumers actually pass — kiln uses
+* Static fal USD/image, keyed by the fal ENDPOINT id. Cost tracking must price
+* the endpoints consumers actually pass — kiln uses
 * `fal-ai/flux/schnell`, `fal-ai/flux-2-pro`, `fal-ai/flux-2-max`. Every price is
 * sourced from the fal registry snapshot in `../models`
 * (`MODELS[...].pricePerImageUsd`) so this table stays in sync rather than
@@ -2471,12 +3322,17 @@ const FAL_IMAGE_PRICE_USD = {
 	"fal-ai/bytedance/seedream/v4/text-to-image": MODELS.seedream4?.pricePerImageUsd ?? .03,
 	"fal-ai/bytedance/seedream/v4.5/text-to-image": MODELS.seedream45?.pricePerImageUsd ?? .04,
 	"bytedance/seedream/v5/pro/text-to-image": MODELS.seedream5?.pricePerImageUsd ?? .0675,
-	"fal-ai/bytedance/seedream/v5/lite/text-to-image": MODELS["seedream5-lite"]?.pricePerImageUsd ?? .035,
-	"fal-ai/recraft-v3": MODELS.recraft?.pricePerImageUsd ?? .04,
+	"bytedance/seedream/v5/lite/text-to-image": MODELS["seedream5-lite"]?.pricePerImageUsd ?? .035,
+	"fal-ai/recraft/v3/text-to-image": MODELS.recraft?.pricePerImageUsd ?? .04,
 	"fal-ai/recraft/v4/text-to-image": MODELS.recraft4?.pricePerImageUsd ?? .04,
+	"fal-ai/recraft/v4.1/text-to-image": MODELS.recraft41?.pricePerImageUsd ?? .035,
 	"fal-ai/ideogram/v3": MODELS.ideogram?.pricePerImageUsd ?? .03,
 	"ideogram/v4": MODELS.ideogram4?.pricePerImageUsd ?? .03,
 	"xai/grok-imagine-image": MODELS["grok-image"]?.pricePerImageUsd ?? .02,
+	"xai/grok-imagine-image/v2.0/text-to-image": MODELS["grok-image-2"]?.pricePerImageUsd ?? .06,
+	"microsoft/mai-image-2.5-pro": MODELS["mai-image-2.5-pro"]?.pricePerImageUsd ?? .17,
+	"fal-ai/ideogram/v3/generate-transparent": MODELS["ideogram3-transparent"]?.pricePerImageUsd ?? .06,
+	"alibaba/qwen-image-3/text-to-image": MODELS.qwen3?.pricePerImageUsd ?? .04,
 	"fal-ai/qwen-image": MODELS.qwen?.pricePerImageUsd ?? .02
 };
 /**
@@ -2484,15 +3340,17 @@ const FAL_IMAGE_PRICE_USD = {
 * var. Throws `MotifError` when neither is present (callers translate this into
 * a `Result.err`).
 */
-function resolveModel$3(modelId, apiKey) {
+function resolveModel$3(modelId, apiKey, fetch) {
 	const key = apiKey ?? process.env["FAL_KEY"];
 	if (key === void 0 || key === "") throw new MotifError(`fal image generation requires an API key (config.fal.apiKey or ${FAL_API_KEY_ENV})`, 0);
-	return createFal({ apiKey: key }).image(modelId);
+	return createFal({
+		apiKey: key,
+		...toProviderFetch(fetch)
+	}).image(modelId);
 }
 /** The fal provider adapter registered in the provider registry. */
 const falAdapter = {
 	id: "fal",
-	tierModels: FAL_TIER_MODELS,
 	apiKeyEnv: FAL_API_KEY_ENV,
 	resolveModel: resolveModel$3,
 	priceUsdByModel: FAL_IMAGE_PRICE_USD
@@ -2508,19 +3366,6 @@ const falAdapter = {
 * multi-image-in → image-out editing (with an optional mask), which is the core
 * operation this layer normalizes.
 */
-/**
-* Tier → Gemini image model id.
-*
-* Seeded from Material Desk's `RENDER_IMAGE_MODEL_BY_QUALITY` (the driving
-* consumer, see the design doc). `gemini-2.5-flash-image` is the proven-reachable
-* floor; the preview ids may require allowlist/tier access.
-*/
-const GOOGLE_TIER_MODELS = {
-	fast: "gemini-2.5-flash-image",
-	balanced: "gemini-3.1-flash-image-preview",
-	quality: "gemini-3-pro-image-preview",
-	hero: "gemini-3-pro-image-preview"
-};
 /** Env var read for the Google API key when `apiKey` is not supplied in config. */
 const GOOGLE_API_KEY_ENV = "GOOGLE_GENERATIVE_AI_API_KEY";
 /**
@@ -2550,15 +3395,17 @@ const GOOGLE_IMAGE_PRICE_USD = {
 * `GOOGLE_GENERATIVE_AI_API_KEY` env var. Throws `MotifError` when neither is
 * present (callers translate this into a `Result.err`).
 */
-function resolveModel$2(modelId, apiKey) {
+function resolveModel$2(modelId, apiKey, fetch) {
 	const key = apiKey ?? process.env["GOOGLE_GENERATIVE_AI_API_KEY"];
 	if (key === void 0 || key === "") throw new MotifError(`Google image generation requires an API key (config.google.apiKey or ${GOOGLE_API_KEY_ENV})`, 0);
-	return createGoogleGenerativeAI({ apiKey: key }).image(modelId);
+	return createGoogleGenerativeAI({
+		apiKey: key,
+		...toProviderFetch(fetch)
+	}).image(modelId);
 }
 /** The Google (Gemini) provider adapter registered in the provider registry. */
 const googleAdapter = {
 	id: "google",
-	tierModels: GOOGLE_TIER_MODELS,
 	apiKeyEnv: GOOGLE_API_KEY_ENV,
 	resolveModel: resolveModel$2,
 	priceUsdByModel: GOOGLE_IMAGE_PRICE_USD
@@ -2572,20 +3419,6 @@ const googleAdapter = {
 * performs no network I/O — the request only happens when `generateImage`
 * invokes `model.doGenerate`.
 */
-/**
-* OpenAI's image API currently exposes a single gpt-image model, so every tier
-* maps to `gpt-image-1`. Tiers will later differ by `quality`
-* (low/medium/high/auto) passed via `providerOptions.openai` (Phase 1c); until
-* then the tier only selects this one model.
-*/
-const OPENAI_MODEL = "gpt-image-1";
-/** Tier → OpenAI image model id (all tiers → the single gpt-image model). */
-const OPENAI_TIER_MODELS = {
-	fast: OPENAI_MODEL,
-	balanced: OPENAI_MODEL,
-	quality: OPENAI_MODEL,
-	hero: OPENAI_MODEL
-};
 /** Env var read for the OpenAI API key when `apiKey` is not supplied in config. */
 const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 /**
@@ -2597,6 +3430,11 @@ const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 * Source: https://platform.openai.com/docs/pricing (image generation)
 * Sanity anchor: the Phase 0 benchmark measured gpt-image direct at $0.042
 * (vs $0.133 via fal — see docs/design/provider-agnostic-image-layer.md §10).
+*
+* GPT Image 2.5 is token-priced, with no published per-image estimate. Leave
+* these models absent so cost remains unknown unless supplied by the provider.
+* https://developers.openai.com/api/docs/models/gpt-image-2.5-flare
+* https://developers.openai.com/api/docs/models/gpt-image-2.5-sunburst
 */
 const OPENAI_IMAGE_PRICE_USD = { "gpt-image-1": .042 };
 /**
@@ -2604,15 +3442,17 @@ const OPENAI_IMAGE_PRICE_USD = { "gpt-image-1": .042 };
 * `OPENAI_API_KEY` env var. Throws `MotifError` when neither is present
 * (callers translate this into a `Result.err`).
 */
-function resolveModel$1(modelId, apiKey) {
+function resolveModel$1(modelId, apiKey, fetch) {
 	const key = apiKey ?? process.env["OPENAI_API_KEY"];
 	if (key === void 0 || key === "") throw new MotifError(`OpenAI image generation requires an API key (config.openai.apiKey or ${OPENAI_API_KEY_ENV})`, 0);
-	return createOpenAI({ apiKey: key }).image(modelId);
+	return createOpenAI({
+		apiKey: key,
+		...toProviderFetch(fetch)
+	}).image(modelId);
 }
 /** The OpenAI provider adapter registered in the provider registry. */
 const openaiAdapter = {
 	id: "openai",
-	tierModels: OPENAI_TIER_MODELS,
 	apiKeyEnv: OPENAI_API_KEY_ENV,
 	resolveModel: resolveModel$1,
 	priceUsdByModel: OPENAI_IMAGE_PRICE_USD
@@ -2629,19 +3469,6 @@ const openaiAdapter = {
 * NOTE: Replicate's SDK names the credential option `apiToken` (not `apiKey`),
 * and reads `REPLICATE_API_TOKEN` from the environment.
 */
-/**
-* Replicate is wired to a single high-quality model for now, so every tier maps
-* to FLUX 1.1 Pro Ultra. (The benchmark found Replicate ~1.45× faster than fal
-* for this model at the same price — see the design doc §10.)
-*/
-const REPLICATE_MODEL = "black-forest-labs/flux-1.1-pro-ultra";
-/** Tier → Replicate model id (all tiers → FLUX 1.1 Pro Ultra for now). */
-const REPLICATE_TIER_MODELS = {
-	fast: REPLICATE_MODEL,
-	balanced: REPLICATE_MODEL,
-	quality: REPLICATE_MODEL,
-	hero: REPLICATE_MODEL
-};
 /** Env var read for the Replicate API token when `apiToken` is not in config. */
 const REPLICATE_API_KEY_ENV = "REPLICATE_API_TOKEN";
 /**
@@ -2658,10 +3485,13 @@ const REPLICATE_IMAGE_PRICE_USD = { "black-forest-labs/flux-1.1-pro-ultra": .06
 * token), else the `REPLICATE_API_TOKEN` env var. Throws `MotifError` when
 * neither is present (callers translate this into a `Result.err`).
 */
-function resolveModel(modelId, apiKey) {
+function resolveModel(modelId, apiKey, fetch) {
 	const token = apiKey ?? process.env["REPLICATE_API_TOKEN"];
 	if (token === void 0 || token === "") throw new MotifError(`Replicate image generation requires an API token (config.replicate.apiToken or ${REPLICATE_API_KEY_ENV})`, 0);
-	return createReplicate({ apiToken: token }).image(modelId);
+	return createReplicate({
+		apiToken: token,
+		...toProviderFetch(fetch)
+	}).image(modelId);
 }
 //#endregion
 //#region src/image/provider.ts
@@ -2675,7 +3505,6 @@ const PROVIDERS = {
 	openai: openaiAdapter,
 	replicate: {
 		id: "replicate",
-		tierModels: REPLICATE_TIER_MODELS,
 		apiKeyEnv: REPLICATE_API_KEY_ENV,
 		resolveModel,
 		priceUsdByModel: REPLICATE_IMAGE_PRICE_USD
@@ -2719,6 +3548,9 @@ function costFromProviderMetadata(providerMetadata) {
 	}
 }
 /** Static per-image USD for a (provider, model), or undefined if unknown. */
+function providerPricePerImageUsd(provider, modelId) {
+	return tablePricePerImage(provider, modelId);
+}
 function tablePricePerImage(provider, modelId) {
 	const adapter = PROVIDERS[provider];
 	if (adapter === void 0) return;
@@ -2753,8 +3585,8 @@ function costForImages(provider, modelId, providerMetadata, imageCount) {
 * `@howells/motif-sdk/image` — provider-agnostic image generation + editing.
 *
 * ESM-only subpath export, built on the Vercel AI SDK image interface
-* (`generateImage`, `@ai-sdk/*`). Additive to the fal-specific `FalClient`
-* surface; reuses the SDK's Result convention (`Result<T, MotifError>` — no
+* (`generateImage`, `@ai-sdk/*`). The caller names the provider and model;
+* reuses the SDK's Result convention (`Result<T, MotifError>` — no
 * thrown exceptions). Google (Gemini) is the only provider in Phase 1a.
 *
 * @example
@@ -2762,11 +3594,10 @@ function costForImages(provider, modelId, providerMetadata, imageCount) {
 * import { createMotifImage } from "@howells/motif-sdk/image";
 *
 * const img = createMotifImage({ defaultProvider: "google" });
-* const r = await img.generate({ tier: "fast", prompt: "a bare concrete wall" });
+* const r = await img.generate({ model: "gemini-2.5-flash-image", prompt: "a bare concrete wall" });
 * if (r.isOk()) console.log(r.value.images[0].mediaType, r.value.cost);
 * ```
 */
-const DEFAULT_TIER = "balanced";
 const DEFAULT_PROVIDER = "google";
 /**
 * Create a provider-agnostic image client.
@@ -2793,8 +3624,8 @@ function createMotifImage(config = {}, deps = {}) {
 	async function generate(opts) {
 		const provider = resolveProvider(opts.provider);
 		try {
-			const modelId = resolveModelId(provider, opts.model, opts.tier);
-			const model = resolveModelFn(provider, modelId, apiKeyFor(provider));
+			const modelId = opts.model;
+			const model = resolveModelFn(provider, modelId, apiKeyFor(provider), config.fetch);
 			const result = await generateImageFn({
 				model,
 				prompt: opts.prompt,
@@ -2802,6 +3633,7 @@ function createMotifImage(config = {}, deps = {}) {
 				...opts.size === void 0 ? {} : { size: opts.size },
 				...opts.aspectRatio === void 0 ? {} : { aspectRatio: opts.aspectRatio },
 				...opts.seed === void 0 ? {} : { seed: opts.seed },
+				...config.maxRetries === void 0 ? {} : { maxRetries: config.maxRetries },
 				...opts.signal === void 0 ? {} : { abortSignal: opts.signal },
 				...opts.headers === void 0 ? {} : { headers: opts.headers },
 				...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
@@ -2814,8 +3646,8 @@ function createMotifImage(config = {}, deps = {}) {
 	async function edit(opts) {
 		const provider = resolveProvider(opts.provider);
 		try {
-			const modelId = resolveModelId(provider, opts.model, opts.tier);
-			const model = resolveModelFn(provider, modelId, apiKeyFor(provider));
+			const modelId = opts.model;
+			const model = resolveModelFn(provider, modelId, apiKeyFor(provider), config.fetch);
 			const result = await generateImageFn({
 				model,
 				prompt: {
@@ -2825,6 +3657,7 @@ function createMotifImage(config = {}, deps = {}) {
 				},
 				...opts.n === void 0 ? {} : { n: opts.n },
 				...opts.seed === void 0 ? {} : { seed: opts.seed },
+				...config.maxRetries === void 0 ? {} : { maxRetries: config.maxRetries },
 				...opts.signal === void 0 ? {} : { abortSignal: opts.signal },
 				...opts.headers === void 0 ? {} : { headers: opts.headers },
 				...opts.providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(opts.providerOptions) }
@@ -2910,14 +3743,8 @@ async function runBestOfN(opts, generate, edit) {
 	}
 }
 /** Default provider dispatch: resolve the model through the provider registry. */
-function defaultResolveModel(provider, modelId, apiKey) {
-	return getProviderAdapter(provider).resolveModel(modelId, apiKey);
-}
-/** Resolve the model id: explicit `model` wins, else the provider's tier map. */
-function resolveModelId(provider, model, tier) {
-	if (model !== void 0 && model !== "") return model;
-	const resolvedTier = tier ?? DEFAULT_TIER;
-	return getProviderAdapter(provider).tierModels[resolvedTier];
+function defaultResolveModel(provider, modelId, apiKey, fetch) {
+	return getProviderAdapter(provider).resolveModel(modelId, apiKey, fetch);
 }
 /** Map the AI SDK result → normalized MotifImageResult (with cost + requestId). */
 function toMotifImageResult(result, provider, model) {
@@ -3009,7 +3836,10 @@ 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, error instanceof Error && "statusCode" in error && typeof error.statusCode === "number" ? error.statusCode : 0, code);
+	const status = error instanceof Error && "statusCode" in error && typeof error.statusCode === "number" ? error.statusCode : 0;
+	const body = error instanceof Error && "responseBody" in error && typeof error.responseBody === "string" ? error.responseBody : message;
+	if (isFalAccountLocked(status, body)) return falHttpError(status, body);
+	return new MotifError(message, status, code);
 }
 //#endregion
-export { FAL_API_KEY_ENV, FAL_TIER_MODELS, GOOGLE_API_KEY_ENV, GOOGLE_TIER_MODELS, OPENAI_API_KEY_ENV, OPENAI_TIER_MODELS, PROVIDERS, REPLICATE_API_KEY_ENV, REPLICATE_TIER_MODELS, costForImages, costFromProviderMetadata, createMotifImage, getProviderAdapter };
+export { FAL_API_KEY_ENV, GOOGLE_API_KEY_ENV, OPENAI_API_KEY_ENV, PROVIDERS, REPLICATE_API_KEY_ENV, costForImages, costFromProviderMetadata, createMotifImage, getProviderAdapter, providerPricePerImageUsd };