@howells/motif-sdk 2.0.0 → 5.0.0

package/dist/image.js

@@ -1,16 +1,71 @@
 import { generateImage } from "ai";
 import { err, ok } from "neverthrow";
 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,
@@ -40,6 +95,13 @@ const MODELS = {
 		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,
@@ -94,7 +156,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,
@@ -105,19 +174,30 @@ const MODELS = {
 			unit: "units",
 			unitPrice: 1
 		},
-		maxReferenceImages: 4,
+		maxReferenceImages: 16,
 		name: "GPT Image 2",
 		pricePerImageUsd: .211,
 		pricing: "$0.211",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
+		streaming: {
+			generation: true,
+			edit: 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
 	},
@@ -165,6 +245,10 @@ const MODELS = {
 		sizeMode: "gpt_size",
 		supportsAspect: false,
 		supportsBackground: true,
+		streaming: {
+			generation: true,
+			edit: true
+		},
 		supportsEdit: true,
 		supportsMaskImage: true,
 		supportsNumImages: true,
@@ -267,6 +351,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,
@@ -305,6 +407,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,
@@ -344,6 +458,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,
@@ -381,6 +513,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: {
@@ -431,6 +567,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: {
@@ -468,6 +608,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",
@@ -501,16 +646,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",
@@ -551,6 +700,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: {
@@ -604,6 +759,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: {
@@ -653,6 +814,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: {
@@ -701,6 +868,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: {
@@ -712,12 +883,16 @@ const MODELS = {
 			unit: "compute seconds",
 			unitPrice: .00167
 		},
-		maxReferenceImages: 10,
+		maxReferenceImages: 4,
 		name: "FLUX.2 [dev]",
 		pricePerImageUsd: .012,
 		pricing: "$0.00167/sec",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
+		streaming: {
+			generation: true,
+			edit: true
+		},
 		supportsEdit: true,
 		supportsGuidanceScale: true,
 		supportsInferenceSteps: true,
@@ -731,6 +906,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,
@@ -786,6 +965,7 @@ const MODELS = {
 		type: "generation"
 	},
 	"flux-fast": {
+		customImageSize: {},
 		endpoint: "fal-ai/flux/schnell",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -812,11 +992,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",
@@ -858,7 +1039,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,
@@ -871,6 +1052,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,
@@ -889,6 +1079,7 @@ const MODELS = {
 				rank: 25
 			}
 		} },
+		customImageSize: {},
 		endpoint: "fal-ai/recraft/v4/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_JUL_2026,
@@ -907,11 +1098,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,
@@ -947,6 +1138,11 @@ const MODELS = {
 				rank: 19
 			}
 		} },
+		customImageSize: {
+			maxEdge: 3840,
+			minEdge: 512,
+			multipleOf: 16
+		},
 		name: "Ideogram V4",
 		endpoint: "ideogram/v4",
 		type: "generation",
@@ -1010,11 +1206,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,
@@ -1041,6 +1247,7 @@ const MODELS = {
 			},
 			useCase: "Low-cost open-weight text and design generation"
 		},
+		customImageSize: {},
 		endpoint: "fal-ai/qwen-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_AT,
@@ -1085,19 +1292,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,
@@ -1109,6 +1320,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",
@@ -1120,6 +1504,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",
@@ -1186,33 +1581,175 @@ 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 in the register of Aesop and Kinfolk, on a warm bone plaster ground, chalky unglazed surfaces in muted mineral colour, a long soft shadow, generous empty space, shot on film with fine grain, restrained and materially rich. No text, no logos, no people",
+			description: "Objects and products on a plaster ground, for product and editorial still life.",
+			id: "still-life",
+			label: "Editorial still life",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: true,
+			aspect: "3:2",
+			clause: "Interior photograph in the register of House & Garden and Kinfolk, 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, lived-in rather than showroom-perfect, soft natural daylight, shot on film with fine grain. No text, no logos, no people",
+			description: "Bright, collected rooms that feel lived in, for interior scenes.",
+			id: "interior",
+			label: "Interior",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: true,
+			aspect: "4:5",
+			clause: "Architectural photograph in the register of House & Garden and Kinfolk, a considered house seen from outside at editorial distance with its garden and setting, pale render, stone or timber meeting precise detailing, clipped planting, soft warm daylight and long shadow, generous negative space, immaculate and calm, shot on film with fine grain. No text, no logos, no people",
+			description: "Buildings and their settings from outside, for architecture, property and place.",
+			id: "architectural",
+			label: "Architectural exterior",
+			model: "banana"
+		},
+		{
+			acceptsMood: true,
+			aspect: "1:1",
+			clause: "Editorial documentary portrait in the register of Kinfolk, muted warm palette, waist-up and unposed against a plain plaster or linen ground, plain clothing with no logos, soft natural light, shot on film with fine grain. 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 in the register of Aesop, one committed muted mineral colour on a plain ground. 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"
+		},
+		{
+			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 and quietly material. No text, no logos",
+			description: "Flat, edge-to-edge surface photographs, for textures, backgrounds and material swatches.",
+			id: "surface",
+			label: "Flat surface",
+			model: "flux2-pro"
+		},
+		{
+			acceptsMood: false,
+			aspect: "3:2",
+			clause: "Painted abstraction filling the frame edge to edge, mineral pigment and chalk gesso on coarse natural linen, two or three confident gestures, warm ivory, oatmeal, putty and soft charcoal, flat diffuse reproduction light. No text",
+			description: "Painted abstraction edge to edge, for wall art, heroes and calm backgrounds.",
+			id: "abstract",
+			label: "Painted abstract",
+			model: "banana"
+		},
+		{
+			acceptsMood: false,
+			aspect: "1:1",
+			clause: "Stylised editorial illustration in the register of Kinfolk, colour laid as flat planes in a warm muted palette of ivory, putty, sage and charcoal, fine hand-drawn line with a gentle gouache wash, generous empty space, clearly a drawing rather than a photograph. No text, no logos",
+			description: "Line and gouache illustration of any subject, for drawn editorial imagery.",
+			experimental: true,
+			id: "illustration",
+			label: "Editorial illustration",
+			model: "gpt2"
+		}
+	],
+	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 = {
@@ -1224,7 +1761,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",
@@ -1238,7 +1779,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"
@@ -1251,7 +1798,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"
@@ -1264,7 +1817,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"
@@ -1277,7 +1836,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"
@@ -1290,7 +1855,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"
@@ -1374,6 +1943,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.",
@@ -1392,7 +1989,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",
@@ -1416,8 +2018,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"
@@ -1430,8 +2041,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"
@@ -1498,7 +2112,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",
@@ -1604,7 +2217,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"
@@ -1640,13 +2256,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.",
@@ -1672,7 +2326,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"
@@ -1705,8 +2362,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,
@@ -1723,10 +2381,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"
@@ -1741,8 +2400,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,
@@ -1759,10 +2419,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"
@@ -1781,8 +2442,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,
@@ -1799,8 +2461,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,
@@ -1817,8 +2480,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,
@@ -1835,8 +2499,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,
@@ -1852,8 +2517,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,
@@ -1873,10 +2539,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"
@@ -1927,6 +2605,7 @@ const EDITING_TOOLS = {
 		outputKeys: ["images"],
 		price: {
 			kind: "call",
+			perImage: true,
 			usd: .04
 		},
 		pricing: "$0.04/generation",
@@ -1957,7 +2636,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"
@@ -1988,6 +2671,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",
@@ -2082,12 +2766,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" },
@@ -2104,6 +2811,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
@@ -2117,7 +2843,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"
@@ -2146,7 +2875,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"
@@ -2160,7 +2892,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"
@@ -2177,7 +2912,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"
@@ -2194,7 +2932,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"
@@ -2207,7 +2948,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"
@@ -2220,7 +2964,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"
@@ -2233,7 +2980,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"
@@ -2246,7 +2996,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"
@@ -2266,7 +3019,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",
@@ -2311,7 +3067,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",
@@ -2383,7 +3143,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",
@@ -2402,7 +3166,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",
@@ -2416,7 +3184,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"
@@ -2429,7 +3200,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"
@@ -2442,7 +3216,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"
@@ -2459,6 +3236,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.
@@ -2476,35 +3264,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
@@ -2531,12 +3306,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
 };
 /**
@@ -2544,86 +3324,33 @@ 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);
+}
+/**
+* How a registered fal edit endpoint takes its input images, from the
+* registry's `editImagesField` (default `image_urls`). `@ai-sdk/fal` sends only
+* the first image as `image_url` unless told otherwise, which list-only
+* endpoints reject and which silently drops every reference after the first.
+* Undefined for an endpoint the registry does not list as an edit route.
+*/
+function falEditImagesField(modelId) {
+	const config = Object.values(MODELS).find((entry) => entry.editEndpoint === modelId);
+	return config === void 0 ? void 0 : config.editImagesField ?? "image_urls";
 }
 /** 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
 };
 //#endregion
-//#region src/image/google.ts
-/**
-* Google (Gemini) provider adapter.
-*
-* Builds a Vercel AI SDK `ImageModel` from `@ai-sdk/google`. Building a model
-* performs no network I/O — the request only happens when `generateImage`
-* invokes `model.doGenerate`. Gemini supports both text→image generation and
-* 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";
-/**
-* Static Google-direct USD/image, keyed by model id.
-*
-* Sources (Google direct, not fal-hosted):
-*   - `gemini-2.5-flash-image` ("nano banana"): image output billed at 1290
-*     output tokens/image at $30 / 1M output tokens ≈ $0.039/image.
-*     Source: https://ai.google.dev/gemini-api/docs/pricing
-*     Sanity anchor: fal-hosted `fal-ai/gemini-25-flash-image` is $0.0398
-*     (`MODELS.gemini.pricePerImageUsd` in ../models) — same ballpark.
-*   - `gemini-3-pro-image-preview` ("nano banana pro"): standard 1K/2K image
-*     output ≈ $0.134/image (higher tiers/4K cost more).
-*     Source: https://ai.google.dev/gemini-api/docs/pricing
-*     Sanity anchor: fal-hosted `fal-ai/gemini-3-pro-image-preview` is $0.15
-*     (`MODELS.gemini3`/`MODELS.banana` in ../models) — fal adds overhead.
-*   - `gemini-3.1-flash-image-preview`: flash-tier image output; priced with the
-*     2.5 flash-image line (≈ $0.039/image) pending a distinct published rate.
-*/
-const GOOGLE_IMAGE_PRICE_USD = {
-	"gemini-2.5-flash-image": .039,
-	"gemini-3.1-flash-image-preview": .039,
-	"gemini-3-pro-image-preview": .134
-};
-/**
-* Build a Google Gemini `ImageModel`. Prefers the passed `apiKey`, else the
-* `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) {
-	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);
-}
-/** 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
-};
-//#endregion
 //#region src/image/openai.ts
 /**
 * OpenAI (gpt-image) provider adapter.
@@ -2632,16 +3359,6 @@ const googleAdapter = {
 * performs no network I/O — the request only happens when `generateImage`
 * invokes `model.doGenerate`.
 */
-/**
-* Flare favors speed for everyday generation; Sunburst favors editing precision.
-* Explicit model ids still override tiers, including older GPT Image models.
-*/
-const OPENAI_TIER_MODELS = {
-	fast: "gpt-image-2.5-flare",
-	balanced: "gpt-image-2.5-flare",
-	quality: "gpt-image-2.5-sunburst",
-	hero: "gpt-image-2.5-sunburst"
-};
 /** Env var read for the OpenAI API key when `apiKey` is not supplied in config. */
 const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 /**
@@ -2652,7 +3369,7 @@ const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
 * and size — this is a documented approximation for the common case.
 * 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).
+* (vs $0.133 via fal — full data and methodology on Linear MOT-23).
 *
 * 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.
@@ -2665,20 +3382,186 @@ 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$2(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,
+	resolveModel: resolveModel$2,
 	priceUsdByModel: OPENAI_IMAGE_PRICE_USD
 };
 //#endregion
+//#region src/image/openrouter.ts
+/** Env var read for the OpenRouter API key when `apiKey` is not supplied in config. */
+const OPENROUTER_API_KEY_ENV = "OPENROUTER_API_KEY";
+const OPENROUTER_IMAGES_URL = "https://openrouter.ai/api/v1/images";
+/** Key under which this adapter's metadata sits on `providerMetadata`. */
+const METADATA_KEY = "openrouter";
+/**
+* The Gemini image models Motif exposes, by their bare Google names, mapped to
+* the OpenRouter slug that serves them. All six are listed by
+* `GET https://openrouter.ai/api/v1/images/models`.
+*/
+const OPENROUTER_GEMINI_IMAGE_MODELS = {
+	"gemini-2.5-flash-image": "google/gemini-2.5-flash-image",
+	"gemini-3.1-flash-image-preview": "google/gemini-3.1-flash-image-preview",
+	"gemini-3-pro-image-preview": "google/gemini-3-pro-image-preview",
+	"gemini-3.1-flash-image": "google/gemini-3.1-flash-image",
+	"gemini-3-pro-image": "google/gemini-3-pro-image",
+	"gemini-3.1-flash-lite-image": "google/gemini-3.1-flash-lite-image"
+};
+/**
+* Static USD/image estimate, keyed by the bare model name. Used only when a
+* response carries no `usage.cost`; OpenRouter normally reports the real figure.
+*
+*   - `gemini-2.5-flash-image`: 1290 output tokens at $30 / 1M ≈ $0.039.
+*   - `gemini-3-pro-image-preview`, `gemini-3-pro-image`: ≈ $0.134 at 1K/2K.
+*   - `gemini-3.1-flash-image-preview`: priced with the 2.5 flash-image line
+*     pending a distinct published rate.
+*   - `gemini-3.1-flash-image`: $0.067 at 1K.
+*   - `gemini-3.1-flash-lite-image`: ≈ $0.0336 at 1K.
+* Source: https://ai.google.dev/gemini-api/docs/pricing
+*/
+const OPENROUTER_IMAGE_PRICE_USD = {
+	"gemini-2.5-flash-image": .039,
+	"gemini-3.1-flash-image-preview": .039,
+	"gemini-3-pro-image-preview": .134,
+	"gemini-3.1-flash-image": .067,
+	"gemini-3-pro-image": .134,
+	"gemini-3.1-flash-lite-image": .0336
+};
+/**
+* Resolve a Motif model name to an OpenRouter slug. A bare Gemini name maps to
+* its `google/<id>` slug; a name already containing `/` is an OpenRouter slug
+* and passes through. Anything else is unknown and throws.
+*/
+function openRouterModelSlug(modelId) {
+	if (modelId.includes("/")) return modelId;
+	const slug = OPENROUTER_GEMINI_IMAGE_MODELS[modelId];
+	if (slug === void 0) throw new MotifError(`No OpenRouter image model for "${modelId}". Known: ${Object.keys(OPENROUTER_GEMINI_IMAGE_MODELS).join(", ")}; or pass an OpenRouter slug such as google/gemini-3.1-flash-image.`, 0);
+	return slug;
+}
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null;
+}
+function toDataUrl(mediaType, data) {
+	return `data:${mediaType};base64,${typeof data === "string" ? data : Buffer.from(data).toString("base64")}`;
+}
+/** One `input_references` entry for an input file: a URL as-is, bytes as a data URL. */
+function toInputReference(file) {
+	return {
+		type: "image_url",
+		image_url: { url: file.type === "url" ? file.url : toDataUrl(file.mediaType, file.data) }
+	};
+}
+function buildBody(slug, options) {
+	if (options.mask !== void 0) throw new MotifError("OpenRouter's Image API takes no mask; describe the region in the instruction instead.", 0);
+	return {
+		...options.providerOptions[METADATA_KEY] ?? {},
+		model: slug,
+		prompt: options.prompt,
+		n: options.n,
+		...options.aspectRatio === void 0 ? {} : { aspect_ratio: options.aspectRatio },
+		...options.files === void 0 || options.files.length === 0 ? {} : { input_references: options.files.map(toInputReference) }
+	};
+}
+function errorMessage(body, fallback) {
+	if (isRecord$2(body) && isRecord$2(body.error)) {
+		const { message } = body.error;
+		if (typeof message === "string" && message !== "") return message;
+	}
+	return fallback;
+}
+function parseResponse(body) {
+	if (!isRecord$2(body) || !Array.isArray(body.data)) throw new MotifError("OpenRouter image response had no data array", 502);
+	const images = [];
+	for (const entry of body.data) if (isRecord$2(entry) && typeof entry.b64_json === "string") images.push(entry.b64_json);
+	if (images.length === 0) throw new MotifError("OpenRouter returned no images", 502);
+	return {
+		images,
+		cost: isRecord$2(body.usage) && typeof body.usage.cost === "number" ? body.usage.cost : void 0
+	};
+}
+function buildModel(modelId, apiKey, doFetch) {
+	const slug = openRouterModelSlug(modelId);
+	return {
+		specificationVersion: "v4",
+		provider: METADATA_KEY,
+		modelId: slug,
+		maxImagesPerCall: 10,
+		async doGenerate(options) {
+			const warnings = [];
+			if (options.seed !== void 0) warnings.push({
+				type: "unsupported",
+				feature: "seed"
+			});
+			if (options.size !== void 0) warnings.push({
+				type: "unsupported",
+				feature: "size",
+				details: "Gemini on OpenRouter takes aspectRatio, not pixel sizes."
+			});
+			const timestamp = /* @__PURE__ */ new Date();
+			const response = await doFetch(OPENROUTER_IMAGES_URL, {
+				method: "POST",
+				headers: {
+					...options.headers,
+					Authorization: `Bearer ${apiKey}`,
+					"Content-Type": "application/json"
+				},
+				body: JSON.stringify(buildBody(slug, options)),
+				...options.abortSignal === void 0 ? {} : { signal: options.abortSignal }
+			});
+			const text = await response.text();
+			let body;
+			try {
+				body = JSON.parse(text);
+			} catch {
+				body = void 0;
+			}
+			if (!response.ok) throw new MotifError(errorMessage(body, `OpenRouter ${response.status}: ${text}`), response.status);
+			const { images, cost } = parseResponse(body);
+			return {
+				images,
+				warnings,
+				providerMetadata: { [METADATA_KEY]: {
+					images: images.map(() => ({})),
+					...cost === void 0 ? {} : { cost }
+				} },
+				response: {
+					timestamp,
+					modelId: slug,
+					headers: Object.fromEntries(response.headers.entries())
+				}
+			};
+		}
+	};
+}
+/**
+* Build an OpenRouter `ImageModel`. Prefers the passed `apiKey`, else the
+* `OPENROUTER_API_KEY` env var. Throws `MotifError` when neither is present or
+* the model name is unknown (callers translate this into a `Result.err`).
+*/
+function resolveModel$1(modelId, apiKey, fetch) {
+	const key = apiKey ?? process.env["OPENROUTER_API_KEY"];
+	if (key === void 0 || key === "") throw new MotifError(`OpenRouter image generation requires an API key (config.openrouter.apiKey or ${OPENROUTER_API_KEY_ENV})`, 0);
+	const configured = toProviderFetch(fetch);
+	return buildModel(modelId, key, "fetch" in configured ? configured.fetch : globalThis.fetch);
+}
+/** The OpenRouter provider adapter registered in the provider registry. */
+const openrouterAdapter = {
+	id: "openrouter",
+	apiKeyEnv: OPENROUTER_API_KEY_ENV,
+	resolveModel: resolveModel$1,
+	priceUsdByModel: OPENROUTER_IMAGE_PRICE_USD
+};
+//#endregion
 //#region src/image/replicate.ts
 /**
 * Replicate provider adapter.
@@ -2690,19 +3573,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";
 /**
@@ -2719,10 +3589,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
@@ -2732,11 +3605,10 @@ function resolveModel(modelId, apiKey) {
 * goes through {@link getProviderAdapter}.
 */
 const PROVIDERS = {
-	google: googleAdapter,
+	openrouter: openrouterAdapter,
 	openai: openaiAdapter,
 	replicate: {
 		id: "replicate",
-		tierModels: REPLICATE_TIER_MODELS,
 		apiKeyEnv: REPLICATE_API_KEY_ENV,
 		resolveModel,
 		priceUsdByModel: REPLICATE_IMAGE_PRICE_USD
@@ -2780,6 +3652,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;
@@ -2793,7 +3668,19 @@ function roundUsd(value) {
 * then the static table (× image count), then unknown.
 */
 function costForImages(provider, modelId, providerMetadata, imageCount) {
-	const metaCost = costFromProviderMetadata(providerMetadata);
+	return costForCalls(provider, modelId, [providerMetadata], imageCount);
+}
+/**
+* Cost across every underlying model call of one generation. Provider-metadata
+* costs from the calls that report one are summed; otherwise the static table
+* (× image count), then unknown.
+*/
+function costForCalls(provider, modelId, callMetadata, imageCount) {
+	let metaCost;
+	for (const providerMetadata of callMetadata) {
+		const callCost = costFromProviderMetadata(providerMetadata);
+		if (callCost !== void 0) metaCost = (metaCost ?? 0) + callCost;
+	}
 	if (metaCost !== void 0) return {
 		usd: roundUsd(metaCost),
 		source: "provider-metadata"
@@ -2814,21 +3701,20 @@ 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
-* thrown exceptions). Google (Gemini) is the only provider in Phase 1a.
+* (`generateImage`, `@ai-sdk/*`). The caller names the provider and model;
+* reuses the SDK's Result convention (`Result<T, MotifError>` — no
+* thrown exceptions). Gemini is reached through OpenRouter.
 *
 * @example
 * ```ts
 * 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 img = createMotifImage({ defaultProvider: "openrouter" });
+* const r = await img.generate({ model: "gemini-3.1-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";
+const DEFAULT_PROVIDER = "openrouter";
 /**
 * Create a provider-agnostic image client.
 *
@@ -2844,7 +3730,7 @@ function createMotifImage(config = {}, deps = {}) {
 	}
 	function apiKeyFor(provider) {
 		switch (provider) {
-			case "google": return config.google?.apiKey;
+			case "openrouter": return config.openrouter?.apiKey;
 			case "openai": return config.openai?.apiKey;
 			case "replicate": return config.replicate?.apiToken;
 			case "fal": return config.fal?.apiKey;
@@ -2854,8 +3740,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,
@@ -2863,6 +3749,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) }
@@ -2874,9 +3761,18 @@ function createMotifImage(config = {}, deps = {}) {
 	}
 	async function edit(opts) {
 		const provider = resolveProvider(opts.provider);
+		const imagesField = provider === "fal" ? falEditImagesField(opts.model) : void 0;
+		if (imagesField === "image_url" && opts.images.length > 1) return err(new MotifError(`${opts.model} takes one input image; ${opts.images.length} were given`, 0));
+		const providerOptions = imagesField === "image_urls" && opts.providerOptions?.fal?.useMultipleImages === void 0 ? {
+			...opts.providerOptions,
+			fal: {
+				...opts.providerOptions?.fal,
+				useMultipleImages: true
+			}
+		} : opts.providerOptions;
 		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: {
@@ -2886,9 +3782,10 @@ 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) }
+				...providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(providerOptions) }
 			});
 			return ok(toMotifImageResult(result, provider, modelId));
 		} catch (error) {
@@ -2971,14 +3868,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) {
@@ -2987,7 +3878,7 @@ function toMotifImageResult(result, provider, model) {
 		base64: file.base64,
 		mediaType: file.mediaType
 	}));
-	const cost = costForImages(provider, model, result.providerMetadata, images.length);
+	const cost = costForCalls(provider, model, result.calls.map((call) => call.providerMetadata), images.length);
 	const requestId = extractRequestId(result);
 	const warnings = result.warnings.map(renderWarning);
 	return {
@@ -3013,9 +3904,11 @@ function isRecord(value) {
 }
 /** Look for a provider correlation id in providerMetadata, then response headers. */
 function extractRequestId(result) {
-	const fromMetadata = requestIdFromMetadata(result.providerMetadata);
-	if (fromMetadata !== void 0) return fromMetadata;
-	for (const response of result.responses) {
+	for (const call of result.calls) {
+		const fromMetadata = requestIdFromMetadata(call.providerMetadata);
+		if (fromMetadata !== void 0) return fromMetadata;
+	}
+	for (const { response } of result.calls) {
 		const { headers } = response;
 		if (headers) {
 			const id = headers["x-request-id"] ?? headers["x-goog-request-id"] ?? headers["x-fal-request-id"];
@@ -3070,7 +3963,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, OPENAI_API_KEY_ENV, OPENROUTER_API_KEY_ENV, PROVIDERS, REPLICATE_API_KEY_ENV, costForImages, costFromProviderMetadata, createMotifImage, getProviderAdapter, providerPricePerImageUsd };