@howells/motif-sdk 5.3.0 → 6.0.0

package/dist/index.cjs

@@ -2,10 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let neverthrow = require("neverthrow");
 let _howells_envy = require("@howells/envy");
 let zod = require("zod");
-let ai = require("ai");
-let _ai_sdk_fal = require("@ai-sdk/fal");
-let _ai_sdk_openai = require("@ai-sdk/openai");
-let _ai_sdk_replicate = require("@ai-sdk/replicate");
 //#region src/aspects.ts
 /** Ordered by popularity: square first, then common ratios */
 const ASPECT_RATIOS = [
@@ -355,7 +351,7 @@ const CREATIVE_TAXONOMY = {
 			experimental: true,
 			id: "illustration",
 			label: "Editorial illustration",
-			model: "gpt2"
+			model: "flare"
 		}
 	],
 	mood: [
@@ -538,7 +534,7 @@ function falHttpError(status, body, requestId) {
 * `CreativeOptionError`'s `"INVALID_OPTION"`) onto the returned error so callers
 * keep structured error metadata. Status `0` marks a non-HTTP local error.
 */
-function toMotifError$1(error) {
+function toMotifError(error) {
 	if (error instanceof MotifError) return error;
 	return new MotifError(error instanceof Error ? error.message : String(error), 0, error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : void 0);
 }
@@ -556,6 +552,7 @@ const CARRIED_FIELDS = [
 	"video",
 	"prompt",
 	"mask",
+	"markup",
 	"references",
 	"boxes",
 	"margin",
@@ -691,20 +688,13 @@ function promptWarnings(prompt, context = {}) {
 }
 //#endregion
 //#region src/env.ts
-const motifEnvSchema = (0, _howells_envy.defineEnv)({ optional: {
-	FAL_KEY: zod.z.string().min(1),
-	OPENAI_API_KEY: zod.z.string().min(1)
-} });
+const motifEnvSchema = (0, _howells_envy.defineEnv)({ optional: { FAL_KEY: zod.z.string().min(1) } });
 function parseMotifEnv(input = process.env) {
 	return motifEnvSchema.parse(input);
 }
 function getFalKeyFromEnv(input = process.env) {
 	return parseMotifEnv(input).FAL_KEY;
 }
-/** The OpenAI key, used by direct OpenAI routes such as gpt2 transparency. */
-function getOpenAiKeyFromEnv(input = process.env) {
-	return parseMotifEnv(input).OPENAI_API_KEY;
-}
 //#endregion
 //#region src/models.ts
 const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-10-07";
@@ -729,7 +719,7 @@ const MODELS = {
 					rank: 2
 				}
 			},
-			useCase: "Frontier generation and editing, evaluated at max quality"
+			useCase: "Frontier generation and editing at max reasoning effort; scored as GPT Image 2.5 until 2.6 is benchmarked"
 		},
 		defaultQuality: "max",
 		customImageSize: {
@@ -739,11 +729,11 @@ const MODELS = {
 			minPixels: 655360,
 			multipleOf: 16
 		},
-		editEndpoint: "openai/gpt-image-2.5/flare/edit",
-		endpoint: "openai/gpt-image-2.5/flare/text-to-image",
+		editEndpoint: "openai/gpt-image-2.6/flare/edit",
+		endpoint: "openai/gpt-image-2.6/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",
+		name: "GPT Image 2.6 Flare",
+		pricing: "Token-based: image $8/M input, $2/M cached, $30/M output; text $5/M input, $1.25/M cached",
 		pricePerImageUsd: null,
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
@@ -751,8 +741,23 @@ const MODELS = {
 		supportsEdit: true,
 		supportsMaskImage: true,
 		maskImageField: "mask_url",
+		supportsMarkupImage: true,
+		autoEditSize: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
+		supportedOutputFormats: [
+			"jpeg",
+			"png",
+			"webp",
+			"gif",
+			"svg"
+		],
+		supportedEditOutputFormats: [
+			"jpeg",
+			"png",
+			"webp",
+			"gif"
+		],
 		supportsQuality: true,
 		supportedQualities: [
 			"auto",
@@ -781,7 +786,7 @@ const MODELS = {
 					rank: 1
 				}
 			},
-			useCase: "Frontier generation and editing, evaluated at max quality"
+			useCase: "Frontier generation and editing at max reasoning effort; scored as GPT Image 2.5 until 2.6 is benchmarked"
 		},
 		defaultQuality: "max",
 		customImageSize: {
@@ -791,11 +796,11 @@ const MODELS = {
 			minPixels: 655360,
 			multipleOf: 16
 		},
-		editEndpoint: "openai/gpt-image-2.5/sunburst/edit",
-		endpoint: "openai/gpt-image-2.5/sunburst/text-to-image",
+		editEndpoint: "openai/gpt-image-2.6/sunburst/edit",
+		endpoint: "openai/gpt-image-2.6/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",
+		name: "GPT Image 2.6 Sunburst",
+		pricing: "Token-based: image $8/M input, $2/M cached, $30/M output; text $5/M input, $1.25/M cached",
 		pricePerImageUsd: null,
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
@@ -803,8 +808,23 @@ const MODELS = {
 		supportsEdit: true,
 		supportsMaskImage: true,
 		maskImageField: "mask_url",
+		supportsMarkupImage: true,
+		autoEditSize: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
+		supportedOutputFormats: [
+			"jpeg",
+			"png",
+			"webp",
+			"gif",
+			"svg"
+		],
+		supportedEditOutputFormats: [
+			"jpeg",
+			"png",
+			"webp",
+			"gif"
+		],
 		supportsQuality: true,
 		supportedQualities: [
 			"auto",
@@ -819,77 +839,6 @@ const MODELS = {
 		type: "generation",
 		useQueue: true
 	},
-	gpt2: {
-		benchmark: {
-			artificialAnalysis: {
-				editing: {
-					elo: 1125,
-					rank: 5
-				},
-				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES,
-				textToImage: {
-					elo: 1172,
-					rank: 3
-				}
-			},
-			speed: {
-				medianSeconds: 200.7,
-				p95Seconds: 232.6,
-				source: "artificial-analysis-models"
-			},
-			tiers: {
-				price: "ultra",
-				quality: "frontier",
-				speed: "very_slow"
-			},
-			useCase: "Established frontier generation and transparent PNGs"
-		},
-		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,
-			currency: "USD",
-			endpointId: "openai/gpt-image-2",
-			estimatedCostPerImageUsd: .211,
-			source: "fal-pricing-api",
-			unit: "units",
-			unitPrice: 1
-		},
-		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
-	},
 	gpt: {
 		benchmark: {
 			artificialAnalysis: {
@@ -2471,7 +2420,6 @@ const MODELS = {
 const GENERATION_MODELS = [
 	"sunburst",
 	"flare",
-	"gpt2",
 	"gpt",
 	"banana21",
 	"banana2",
@@ -2536,7 +2484,6 @@ function estimateCost(model, resolution, numImages = 1, editImages = 0) {
 		return configuredPrice * numImages;
 	}
 	switch (model) {
-		case "gpt2": return .211 * numImages;
 		case "gpt": return .133 * numImages;
 		case "banana":
 		case "gemini3": return (resolution === "4K" ? .3 : .15) * numImages;
@@ -2565,7 +2512,7 @@ function estimateVideoCost(durationSeconds = 5, generateAudio = true, model = "k
 * `Response.json()` yields `any`; these helpers narrow that untyped payload into
 * the SDK's response types with runtime guards instead of unchecked assertions.
 */
-function isRecord$4(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null;
 }
 function asString(value) {
@@ -2575,7 +2522,7 @@ function asNumber(value) {
 	return typeof value === "number" ? value : void 0;
 }
 function toMotifImage(value) {
-	if (isRecord$4(value)) return {
+	if (isRecord$1(value)) return {
 		content_type: asString(value.content_type),
 		height: asNumber(value.height),
 		url: asString(value.url) ?? "",
@@ -2590,7 +2537,7 @@ function parseImages(value) {
 function parseLogs(value) {
 	if (!Array.isArray(value)) return;
 	const entries = [];
-	for (const entry of value) if (isRecord$4(entry)) entries.push({
+	for (const entry of value) if (isRecord$1(entry)) entries.push({
 		message: asString(entry.message) ?? "",
 		timestamp: asString(entry.timestamp) ?? ""
 	});
@@ -2620,7 +2567,7 @@ function queueAppPath(endpoint) {
 	return endpoint.split("/").slice(0, 2).join("/");
 }
 function parseQueueSubmission(data) {
-	if (!isRecord$4(data)) return { requestId: "" };
+	if (!isRecord$1(data)) return { requestId: "" };
 	return {
 		requestId: asString(data.request_id) ?? "",
 		responseUrl: asString(data.response_url)
@@ -2660,7 +2607,7 @@ function requestIdFromBody(text) {
 	} catch {
 		return;
 	}
-	if (!isRecord$4(parsed)) return;
+	if (!isRecord$1(parsed)) return;
 	return asString(parsed.request_id) ?? asString(parsed.requestId) ?? asString(parsed.trace_id);
 }
 //#endregion
@@ -2673,6 +2620,18 @@ function requestIdFromBody(text) {
 * error can name both what a model does support and which models support the
 * option that was refused.
 */
+const DEFAULT_OUTPUT_FORMATS = [
+	"jpeg",
+	"png",
+	"webp"
+];
+/** The output formats a Model returns, for an edit when `editing` is set.
+* A Model that takes no format returns none it can be asked for. */
+function outputFormatsOf(config, editing) {
+	if (config.supportsOutputFormat !== true) return [];
+	const formats = config.supportedOutputFormats ?? DEFAULT_OUTPUT_FORMATS;
+	return editing ? config.supportedEditOutputFormats ?? formats : formats;
+}
 /** Generation options a model can refuse, with the registry test for each. */
 const OPTION_CAPABILITIES = {
 	aspect: (config) => (config.sizeMode ?? "aspect_ratio") !== "none",
@@ -2688,6 +2647,7 @@ const OPTION_CAPABILITIES = {
 	imageSize: (config) => config.sizeMode === "gpt_size" || config.sizeMode === "image_size_enum",
 	inputFidelity: (config) => config.sizeMode === "gpt_size",
 	limitGenerations: (config) => config.supportsLimitGenerations === true,
+	markupImageUrl: (config) => config.supportsMarkupImage === true,
 	maskImageUrl: (config) => config.supportsMaskImage === true,
 	negativePrompt: (config) => config.supportsNegativePrompt === true,
 	numImages: (config) => config.supportsNumImages,
@@ -2737,8 +2697,7 @@ var UnsupportedOptionError = class extends Error {
 	constructor(config, option) {
 		const models = modelsSupporting(option);
 		const supported = supportedOptions(config);
-		const route = config.transparencyRoute !== void 0 && (option === "transparent output" || option === "background") ? ` ${config.name} does produce transparent PNGs through the ${config.transparencyRoute.provider} route (${config.transparencyRoute.apiKeyEnv}).` : "";
-		super(`${config.name} does not support ${option}. Models that do: ${models.length > 0 ? models.join(", ") : "none"}. ${config.name} supports: ${supported.length > 0 ? supported.join(", ") : "none of the optional settings"}.${route}`);
+		super(`${config.name} does not support ${option}. Models that do: ${models.length > 0 ? models.join(", ") : "none"}. ${config.name} supports: ${supported.length > 0 ? supported.join(", ") : "none of the optional settings"}.`);
 		this.name = "UnsupportedOptionError";
 		this.model = config.name;
 		this.modelsSupporting = models;
@@ -2821,6 +2780,9 @@ function validateGenerateOptions(options, config, sizeMode, hasEditImages) {
 	if (options.imagePromptStrength !== void 0 && !hasEditImages) throw new Error("imagePromptStrength requires editImageUrls");
 	if (options.maskImageUrl !== void 0 && config.supportsMaskImage !== true) unsupported(config, "maskImageUrl");
 	if (options.maskImageUrl !== void 0 && !hasEditImages) throw new Error("maskImageUrl requires editImageUrls");
+	if (options.markupImageUrl !== void 0 && config.supportsMarkupImage !== true) unsupported(config, "markupImageUrl");
+	if (options.markupImageUrl !== void 0 && !hasEditImages) throw new Error("markupImageUrl requires editImageUrls");
+	if (options.markupImageUrl !== void 0 && options.maskImageUrl !== void 0) throw new Error("A markup image can't be combined with a mask.");
 	if (options.seed !== void 0 && config.supportsSeed !== true) unsupported(config, "seed");
 	if (options.outputFormat !== void 0 && config.supportsOutputFormat !== true) unsupported(config, "outputFormat");
 	if (options.quality !== void 0 && config.supportsQuality !== true) unsupported(config, "quality");
@@ -2856,11 +2818,11 @@ function validateGenerateOptions(options, config, sizeMode, hasEditImages) {
 * Models use different sizing APIs:
 * - `gpt_size`: GPT's fixed dimensions (1024x1024, 1536x1024, etc.)
 * - `aspect_ratio`: string like "16:9" (Gemini, Grok, FLUX Pro Ultra)
-* - `image_size_enum`: named presets like "landscape_4_3" (FLUX.2, Seedream, Recraft, Ideogram, GPT Image 2)
+* - `image_size_enum`: named presets like "landscape_4_3" (FLUX.2, Seedream, Recraft, Ideogram, GPT Image)
 * - `none`: no size control (video models)
 */
 function buildGenerateBody(options) {
-	const { prompt, model, creative, aspect = "1:1", resolution = "2K", numImages = 1, background, editImageUrls, enableGoogleSearch, enableSafetyChecker, transparent, inputFidelity, imageSize, imagePromptStrength, limitGenerations, maskImageUrl, seed, outputFormat, quality, negativePrompt, style, syncMode, thinkingLevel, renderingSpeed, guidanceScale, numInferenceSteps, raw, enhancePrompt, safetyTolerance, enableWebSearch, expandPrompt } = options;
+	const { prompt, model, creative, aspect = "1:1", resolution = "2K", numImages = 1, background, editImageUrls, enableGoogleSearch, enableSafetyChecker, transparent, inputFidelity, imageSize, imagePromptStrength, limitGenerations, maskImageUrl, markupImageUrl, seed, outputFormat, quality, negativePrompt, style, syncMode, thinkingLevel, renderingSpeed, guidanceScale, numInferenceSteps, raw, enhancePrompt, safetyTolerance, enableWebSearch, expandPrompt } = options;
 	const config = MODELS[model];
 	if (!config) throw new Error(`Unknown model: ${model}`);
 	let { endpoint } = config;
@@ -2879,7 +2841,7 @@ function buildGenerateBody(options) {
 			body.image_size = normalizedImageSize ?? (hasEditImages && !explicitAspect ? "auto" : aspectToGptSize(aspect));
 			break;
 		case "image_size_enum":
-			body.image_size = normalizedImageSize ?? falImageSizeFor(config, aspect, resolution);
+			body.image_size = normalizedImageSize ?? (config.autoEditSize === true && hasEditImages && !explicitAspect ? "auto" : falImageSizeFor(config, aspect, resolution));
 			break;
 		case "aspect_ratio":
 			if (config.supportsAspect) body.aspect_ratio = aspect;
@@ -2892,7 +2854,8 @@ function buildGenerateBody(options) {
 	if (syncMode !== void 0 && config.supportsSyncMode === true) body.sync_mode = syncMode;
 	if (seed !== void 0 && config.supportsSeed === true) body.seed = seed;
 	if (outputFormat && config.supportsOutputFormat === true && transparent !== true) {
-		if (config.supportedOutputFormats && !config.supportedOutputFormats.includes(outputFormat)) throw new Error(`${config.name} supports output formats: ${config.supportedOutputFormats.join(", ")}`);
+		const formats = outputFormatsOf(config, hasEditImages);
+		if (!formats.includes(outputFormat)) throw new Error(`${config.name} ${hasEditImages ? "edits support" : "supports"} output formats: ${formats.join(", ")}`);
 		body.output_format = outputFormat;
 	}
 	if (config.supportsRaw === true && raw !== void 0) body.raw = raw;
@@ -2951,6 +2914,7 @@ function buildGenerateBody(options) {
 		if (inputFidelity) body.input_fidelity = inputFidelity;
 	}
 	if (maskImageUrl !== void 0 && maskImageUrl !== "" && config.supportsMaskImage === true) body[config.maskImageField ?? "mask_image_url"] = maskImageUrl;
+	if (markupImageUrl !== void 0 && config.supportsMarkupImage === true) body.markup_image_url = markupImageUrl;
 	return {
 		body,
 		endpoint
@@ -4508,7 +4472,7 @@ async function runRequest(exec, prepared) {
 	const response = await exec.request(`${FAL_BASE_URL$1}/${prepared.endpoint}`, requestInit(prepared));
 	if (response.isErr()) return (0, neverthrow.err)(response.error);
 	const data = await response.value.json();
-	const record = isRecord$4(data) ? data : {};
+	const record = isRecord$1(data) ? data : {};
 	const requestId = response.value.headers.get("x-fal-request-id") ?? asString(record.request_id);
 	return (0, neverthrow.ok)({
 		data: record,
@@ -4535,14 +4499,19 @@ async function getToolResult(exec, job) {
 	const response = await exec.request(url);
 	if (response.isErr()) return (0, neverthrow.err)(response.error);
 	const data = await response.value.json();
-	return (0, neverthrow.ok)(isRecord$4(data) ? data : {});
+	return (0, neverthrow.ok)(isRecord$1(data) ? data : {});
 }
 /** Poll a submitted job to completion and fetch its result. Submits nothing. */
 async function awaitQueuedRequest(exec, job, onProgress) {
+	let logsSeen = 0;
 	for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt++) {
 		const status = await checkToolStatus(exec, job);
 		if (status.isErr()) return (0, neverthrow.err)(status.error);
-		onProgress?.(status.value.status, status.value.queuePosition);
+		const logs = status.value.logs ?? [];
+		const fresh = logs.slice(logs.length < logsSeen ? 0 : logsSeen);
+		logsSeen = logs.length;
+		if (fresh.length > 0) onProgress?.(status.value.status, status.value.queuePosition, fresh);
+		else onProgress?.(status.value.status, status.value.queuePosition);
 		if (status.value.status === "completed") return (await getToolResult(exec, job)).map((data) => ({
 			data,
 			requestId: job.requestId
@@ -4639,7 +4608,7 @@ var FalClient = class {
 		try {
 			built = buildGenerateBody(options);
 		} catch (error) {
-			return (0, neverthrow.err)(toMotifError$1(error));
+			return (0, neverthrow.err)(toMotifError(error));
 		}
 		const { endpoint, body } = built;
 		const response = await this.request(`${FAL_BASE_URL}/${endpoint}`, {
@@ -4677,7 +4646,7 @@ var FalClient = class {
 		try {
 			built = buildGenerateBody(options);
 		} catch (error) {
-			return (0, neverthrow.err)(toMotifError$1(error));
+			return (0, neverthrow.err)(toMotifError(error));
 		}
 		const { endpoint, body } = built;
 		const response = await this.request(`${FAL_QUEUE_URL}/${endpoint}`, {
@@ -4699,7 +4668,7 @@ var FalClient = class {
 		const response = await this.request(url);
 		if (response.isErr()) return (0, neverthrow.err)(response.error);
 		const data = await response.value.json();
-		const record = isRecord$4(data) ? data : {};
+		const record = isRecord$1(data) ? data : {};
 		const rawStatus = asString(record.status);
 		let status;
 		if (rawStatus === "IN_QUEUE") status = "queued";
@@ -4807,7 +4776,7 @@ var FalClient = class {
 		const response = await this.request(url);
 		if (response.isErr()) return (0, neverthrow.err)(response.error);
 		const data = await response.value.json();
-		const video = isRecord$4(data) && isRecord$4(data.video) ? data.video : void 0;
+		const video = isRecord$1(data) && isRecord$1(data.video) ? data.video : void 0;
 		if (video === void 0) return (0, neverthrow.err)(new MotifError("No video in response", 0));
 		return (0, neverthrow.ok)({
 			contentType: asString(video.content_type) ?? "",
@@ -4831,8 +4800,8 @@ var FalClient = class {
 		});
 		if (initiateResponse.isErr()) return (0, neverthrow.err)(initiateResponse.error);
 		const initiateData = await initiateResponse.value.json();
-		const fileUrl = isRecord$4(initiateData) ? asString(initiateData.file_url) ?? "" : "";
-		const uploadUrl = isRecord$4(initiateData) ? asString(initiateData.upload_url) : void 0;
+		const fileUrl = isRecord$1(initiateData) ? asString(initiateData.file_url) ?? "" : "";
+		const uploadUrl = isRecord$1(initiateData) ? asString(initiateData.upload_url) : void 0;
 		if (uploadUrl === void 0 || uploadUrl === "") return (0, neverthrow.err)(new MotifError("Upload initiate response missing upload_url", 0));
 		let putResponse;
 		try {
@@ -4984,7 +4953,7 @@ var FalClient = class {
 	* Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
 	*/
 	normalizeResponse(data, fallbackRequestId) {
-		if (!isRecord$4(data)) return (0, neverthrow.err)(new MotifError("Unexpected fal response shape", 0, "FAL_ERROR"));
+		if (!isRecord$1(data)) return (0, neverthrow.err)(new MotifError("Unexpected fal response shape", 0, "FAL_ERROR"));
 		const obj = data;
 		const requestId = asString(obj.request_id) ?? asString(obj.requestId) ?? fallbackRequestId;
 		if ("detail" in obj) return (0, neverthrow.err)(new MotifError(asString(obj.detail) ?? "", 0, "FAL_ERROR"));
@@ -5287,6 +5256,188 @@ function sumCosts(costs) {
 	};
 }
 //#endregion
+//#region src/image-benchmarks.ts
+const BOARDS = {
+	"text-to-image": {
+		sunburst: {
+			elo: 1427,
+			rank: 1,
+			uncertainty: 5,
+			evaluatedModel: "GPT-Image-2.5 Sunburst",
+			preliminary: true,
+			votes: 40323
+		},
+		flare: {
+			elo: 1401,
+			rank: 2,
+			uncertainty: 5,
+			evaluatedModel: "GPT-Image-2.5 Flare",
+			preliminary: true,
+			votes: 39218
+		},
+		banana21: {
+			elo: 1325,
+			rank: 5,
+			uncertainty: 9,
+			evaluatedModel: "Nano Banana 2.1",
+			preliminary: true,
+			votes: 5290
+		},
+		"grok-image-2": {
+			elo: 1317,
+			rank: 6,
+			uncertainty: 7,
+			evaluatedModel: "Grok Imagine Image 2.0",
+			preliminary: true,
+			votes: 10902
+		},
+		"muse-image": {
+			elo: 1269,
+			rank: 8,
+			uncertainty: 5,
+			evaluatedModel: "Muse Image (Meta)",
+			votes: 53444
+		},
+		qwen3: {
+			elo: 1254,
+			rank: 9,
+			uncertainty: 6,
+			evaluatedModel: "Qwen-Image-3.0-Pro",
+			votes: 11444
+		},
+		"mai-image-2.5": {
+			elo: 1253,
+			rank: 10,
+			uncertainty: 4,
+			evaluatedModel: "MAI-Image-2.5",
+			votes: 61286
+		},
+		seedream5: {
+			elo: 1250,
+			rank: 11,
+			uncertainty: 4,
+			evaluatedModel: "Seedream 5.0 Pro",
+			votes: 105824
+		},
+		"banana2-lite": {
+			elo: 1249,
+			rank: 12,
+			uncertainty: 6,
+			evaluatedModel: "Nano Banana 2 Lite",
+			votes: 17813
+		},
+		banana: {
+			elo: 1246,
+			rank: 13,
+			uncertainty: 3,
+			evaluatedModel: "Nano Banana Pro (2K)",
+			votes: 188288
+		},
+		gpt: {
+			elo: 1236,
+			rank: 14,
+			uncertainty: 3,
+			evaluatedModel: "GPT-Image-1.5 (High Fidelity)",
+			votes: 174012
+		},
+		ideogram4: {
+			elo: 1200,
+			rank: 15,
+			uncertainty: 4,
+			evaluatedModel: "Ideogram 4.0 (Quality)",
+			votes: 72865
+		},
+		"flux2-flex": {
+			elo: 1156,
+			rank: 17,
+			uncertainty: 3,
+			evaluatedModel: "FLUX.2 [flex]",
+			votes: 156876
+		}
+	},
+	"image-edit-single-image": {
+		sunburst: {
+			elo: 1517,
+			rank: 1,
+			uncertainty: 5,
+			evaluatedModel: "GPT-Image-2.5 Sunburst",
+			preliminary: true
+		},
+		flare: {
+			elo: 1482,
+			rank: 2,
+			uncertainty: 5,
+			evaluatedModel: "GPT-Image-2.5 Flare",
+			preliminary: true
+		},
+		"grok-image-2": {
+			elo: 1439,
+			rank: 5,
+			uncertainty: 6,
+			evaluatedModel: "Grok Imagine Image 2.0",
+			preliminary: true
+		},
+		banana21: {
+			elo: 1427,
+			rank: 7,
+			uncertainty: 6,
+			evaluatedModel: "Nano Banana 2.1",
+			preliminary: true
+		},
+		"mai-image-2.5": {
+			elo: 1400,
+			rank: 9,
+			uncertainty: 4,
+			evaluatedModel: "MAI-Image-2.5"
+		},
+		"muse-image": {
+			elo: 1400,
+			rank: 10,
+			uncertainty: 4,
+			evaluatedModel: "Muse Image (Meta)"
+		},
+		"grok-image-quality": {
+			elo: 1391,
+			rank: 11,
+			uncertainty: 6,
+			evaluatedModel: "Grok Imagine Image (Quality, 20260519)"
+		},
+		seedream5: {
+			elo: 1390,
+			rank: 12,
+			uncertainty: 3,
+			evaluatedModel: "Seedream 5.0 Pro"
+		},
+		banana: {
+			elo: 1390,
+			rank: 13,
+			uncertainty: 3,
+			evaluatedModel: "Nano Banana Pro (2K)"
+		},
+		gpt: {
+			elo: 1368,
+			rank: 14,
+			uncertainty: 3,
+			evaluatedModel: "GPT-Image-1.5 (High Fidelity)"
+		}
+	}
+};
+const SOURCES = {
+	"text-to-image": "https://arena.ai/leaderboard/image/text-to-image",
+	"image-edit-single-image": "https://arena.ai/leaderboard/image/image-edit/single-image"
+};
+/** A published score for this route, or null when no matching score was saved. */
+function imageModelBenchmark(model, task) {
+	const score = BOARDS[task][model];
+	if (score === void 0) return null;
+	return {
+		...score,
+		source: SOURCES[task],
+		snapshotDate: "2026-10-29",
+		task
+	};
+}
+//#endregion
 //#region src/tasks.ts
 /**
 * The Task registry: every job Motif does, with the Models that can do it
@@ -5314,6 +5465,186 @@ const TIERS = [
 const DEFAULT_TIER = "balanced";
 const HAND_RANKED_AT = "2026-09-16";
 const IMAGE_RANKED_AT = "2026-10-29";
+function withImageBenchmarks(models, task) {
+	return models.map((entry) => ({
+		...entry,
+		benchmark: imageModelBenchmark(entry.model, task)
+	}));
+}
+const GENERATION_MODELS_RANKED = withImageBenchmarks([
+	{
+		model: "sunburst",
+		tier: "quality"
+	},
+	{
+		model: "flare",
+		tier: "quality"
+	},
+	{
+		model: "seedream5",
+		tier: "quality"
+	},
+	{
+		model: "gpt",
+		tier: "quality"
+	},
+	{
+		model: "mai-image-2.5-pro",
+		tier: "quality"
+	},
+	{
+		model: "banana21",
+		tier: "balanced"
+	},
+	{
+		model: "grok-image-2",
+		tier: "balanced"
+	},
+	{
+		model: "muse-image",
+		tier: "balanced"
+	},
+	{
+		model: "banana2",
+		tier: "balanced"
+	},
+	{
+		model: "qwen3",
+		tier: "balanced"
+	},
+	{
+		model: "mai-image-2.5",
+		tier: "balanced"
+	},
+	{
+		model: "banana",
+		tier: "balanced"
+	},
+	{
+		model: "ideogram4",
+		tier: "balanced"
+	},
+	{
+		model: "flux2-flex",
+		tier: "balanced"
+	},
+	{
+		model: "recraft41",
+		tier: "balanced"
+	},
+	{
+		model: "flux2-pro",
+		tier: "balanced"
+	},
+	{
+		model: "krea3",
+		tier: "balanced"
+	},
+	{
+		model: "grok-image-quality",
+		tier: "balanced"
+	},
+	{
+		model: "ideogram3-transparent",
+		requires: ["transparency"],
+		supports: ["transparency"],
+		tier: "balanced"
+	},
+	{
+		model: "banana2-lite",
+		tier: "fast"
+	},
+	{
+		model: "grok-image",
+		tier: "fast"
+	},
+	{
+		model: "seedream5-lite",
+		tier: "fast"
+	},
+	{
+		model: "flux2-turbo",
+		tier: "fast"
+	}
+], "text-to-image");
+const EDITING_MODELS_RANKED = withImageBenchmarks([
+	{
+		model: "sunburst",
+		tier: "quality"
+	},
+	{
+		model: "flare",
+		tier: "quality"
+	},
+	{
+		model: "seedream5",
+		tier: "quality"
+	},
+	{
+		model: "gpt",
+		tier: "quality"
+	},
+	{
+		model: "mai-image-2.5-pro",
+		tier: "quality"
+	},
+	{
+		model: "grok-image-2",
+		tier: "balanced"
+	},
+	{
+		model: "banana21",
+		tier: "balanced"
+	},
+	{
+		model: "mai-image-2.5",
+		tier: "balanced"
+	},
+	{
+		model: "muse-image",
+		tier: "balanced"
+	},
+	{
+		model: "grok-image-quality",
+		tier: "balanced"
+	},
+	{
+		model: "banana",
+		tier: "balanced"
+	},
+	{
+		model: "banana2",
+		tier: "balanced"
+	},
+	{
+		model: "krea3",
+		tier: "balanced"
+	},
+	{
+		model: "qwen3",
+		tier: "balanced"
+	},
+	{
+		model: "flux2-pro",
+		tier: "balanced"
+	},
+	{
+		model: "flux2-flex",
+		tier: "balanced"
+	},
+	{
+		model: "grok-image",
+		tier: "fast"
+	},
+	{
+		model: "banana2-lite",
+		tier: "fast"
+	},
+	{
+		model: "seedream5-lite",
+		tier: "fast"
+	}
+], "image-edit-single-image");
 /** Every Task with a Model. A Task is absent here until it has at least one Model. */
 const TASKS = {
 	animate: {
@@ -5485,106 +5816,7 @@ const TASKS = {
 	},
 	generate: {
 		basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29 (MOT-72). Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.",
-		models: [
-			{
-				model: "sunburst",
-				tier: "quality"
-			},
-			{
-				model: "flare",
-				tier: "quality"
-			},
-			{
-				model: "gpt2",
-				tier: "quality"
-			},
-			{
-				model: "seedream5",
-				tier: "quality"
-			},
-			{
-				model: "gpt",
-				tier: "quality"
-			},
-			{
-				model: "mai-image-2.5-pro",
-				tier: "quality"
-			},
-			{
-				model: "banana21",
-				tier: "balanced"
-			},
-			{
-				model: "grok-image-2",
-				tier: "balanced"
-			},
-			{
-				model: "muse-image",
-				tier: "balanced"
-			},
-			{
-				model: "banana2",
-				tier: "balanced"
-			},
-			{
-				model: "qwen3",
-				tier: "balanced"
-			},
-			{
-				model: "mai-image-2.5",
-				tier: "balanced"
-			},
-			{
-				model: "banana",
-				tier: "balanced"
-			},
-			{
-				model: "ideogram4",
-				tier: "balanced"
-			},
-			{
-				model: "flux2-flex",
-				tier: "balanced"
-			},
-			{
-				model: "recraft41",
-				tier: "balanced"
-			},
-			{
-				model: "flux2-pro",
-				tier: "balanced"
-			},
-			{
-				model: "krea3",
-				tier: "balanced"
-			},
-			{
-				model: "grok-image-quality",
-				tier: "balanced"
-			},
-			{
-				model: "ideogram3-transparent",
-				requires: ["transparency"],
-				supports: ["transparency"],
-				tier: "balanced"
-			},
-			{
-				model: "banana2-lite",
-				tier: "fast"
-			},
-			{
-				model: "grok-image",
-				tier: "fast"
-			},
-			{
-				model: "seedream5-lite",
-				tier: "fast"
-			},
-			{
-				model: "flux2-turbo",
-				tier: "fast"
-			}
-		],
+		models: GENERATION_MODELS_RANKED,
 		notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).",
 		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
@@ -6072,88 +6304,7 @@ const TASKS = {
 	},
 	vary: {
 		basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29 (MOT-72). Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.",
-		models: [
-			{
-				model: "sunburst",
-				tier: "quality"
-			},
-			{
-				model: "flare",
-				tier: "quality"
-			},
-			{
-				model: "gpt2",
-				tier: "quality"
-			},
-			{
-				model: "seedream5",
-				tier: "quality"
-			},
-			{
-				model: "gpt",
-				tier: "quality"
-			},
-			{
-				model: "mai-image-2.5-pro",
-				tier: "quality"
-			},
-			{
-				model: "grok-image-2",
-				tier: "balanced"
-			},
-			{
-				model: "banana21",
-				tier: "balanced"
-			},
-			{
-				model: "mai-image-2.5",
-				tier: "balanced"
-			},
-			{
-				model: "muse-image",
-				tier: "balanced"
-			},
-			{
-				model: "grok-image-quality",
-				tier: "balanced"
-			},
-			{
-				model: "banana",
-				tier: "balanced"
-			},
-			{
-				model: "banana2",
-				tier: "balanced"
-			},
-			{
-				model: "krea3",
-				tier: "balanced"
-			},
-			{
-				model: "qwen3",
-				tier: "balanced"
-			},
-			{
-				model: "flux2-pro",
-				tier: "balanced"
-			},
-			{
-				model: "flux2-flex",
-				tier: "balanced"
-			},
-			{
-				model: "grok-image",
-				tier: "fast"
-			},
-			{
-				model: "banana2-lite",
-				tier: "fast"
-			},
-			{
-				model: "seedream5-lite",
-				tier: "fast"
-			}
-		],
+		models: EDITING_MODELS_RANKED,
 		notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).",
 		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
@@ -8347,11 +8498,10 @@ const NO_MODEL_AVAILABLE = "NO_MODEL_AVAILABLE";
 const FAL_KEY = "FAL_KEY";
 function generationProfile(config) {
 	const capabilities = /* @__PURE__ */ new Set(["image"]);
-	const keyed = /* @__PURE__ */ new Map();
 	if (config.supportsBackground === true || config.transparentOutput === true) capabilities.add("transparency");
-	else if (config.transparencyRoute !== void 0) keyed.set("transparency", config.transparencyRoute.apiKeyEnv);
 	if (config.supportsEdit) capabilities.add("references");
 	if (config.supportsMaskImage === true) capabilities.add("mask");
+	if (config.supportsMarkupImage === true) capabilities.add("markup");
 	if ((config.sizeMode ?? "aspect_ratio") !== "none") capabilities.add("aspect");
 	if (config.supportsResolution) capabilities.add("resolution");
 	if (config.supportsNumImages) capabilities.add("count");
@@ -8361,9 +8511,12 @@ function generationProfile(config) {
 	return {
 		aspects: config.supportedAspects,
 		capabilities,
-		keyedCapabilities: keyed,
 		keys: [FAL_KEY],
 		maxReferences: config.supportsEdit ? config.maxReferenceImages ?? 1 : 0,
+		outputFormats: {
+			edit: outputFormatsOf(config, true),
+			text: outputFormatsOf(config, false)
+		},
 		resolutions: config.supportedResolutions
 	};
 }
@@ -8390,7 +8543,6 @@ function toolProfile(tool) {
 	if (takesReference) capabilities.add("references");
 	return {
 		capabilities,
-		keyedCapabilities: /* @__PURE__ */ new Map(),
 		keys: [FAL_KEY],
 		maxReferences: takesReference ? 1 : 0
 	};
@@ -8414,12 +8566,13 @@ function requirements(request) {
 	if (request.transparent === true) needed.push("transparency");
 	if ((request.references ?? 0) > 0) needed.push("references");
 	if (request.mask === true) needed.push("mask");
+	if (request.markup === true) needed.push("markup");
 	if (request.aspect !== void 0) needed.push("aspect");
 	if (request.resolution !== void 0) needed.push("resolution");
 	if ((request.count ?? 1) > 1) needed.push("count");
 	if (request.seed === true) needed.push("seed");
 	if (request.negativePrompt === true) needed.push("negativePrompt");
-	if (request.outputFormat === true) needed.push("outputFormat");
+	if (request.outputFormat !== void 0) needed.push("outputFormat");
 	if (request.rig === true) needed.push("rig");
 	return needed;
 }
@@ -8428,6 +8581,7 @@ function withinLimits(profile, capability, request) {
 	if (capability === "references") return (request.references ?? 0) <= profile.maxReferences;
 	if (capability === "aspect") return accepts(profile.aspects, request.aspect);
 	if (capability === "resolution") return accepts(profile.resolutions, request.resolution);
+	if (capability === "outputFormat") return accepts((request.references ?? 0) > 0 || request.source !== void 0 ? profile.outputFormats?.edit : profile.outputFormats?.text, request.outputFormat);
 	return true;
 }
 function accepts(allowed, value) {
@@ -8444,25 +8598,10 @@ function check(profile, needed, request, keys, requires = []) {
 		missingInput: true,
 		ok: false
 	};
-	for (const capability of needed) {
-		if (profile.capabilities.has(capability)) {
-			if (!withinLimits(profile, capability, request)) return {
-				blockedBy: capability,
-				ok: false
-			};
-			continue;
-		}
-		const key = profile.keyedCapabilities.get(capability);
-		if (key === void 0) return {
-			blockedBy: capability,
-			ok: false
-		};
-		if (!keys.includes(key)) return {
-			blockedBy: "key",
-			missingKey: key,
-			ok: false
-		};
-	}
+	for (const capability of needed) if (!profile.capabilities.has(capability) || !withinLimits(profile, capability, request)) return {
+		blockedBy: capability,
+		ok: false
+	};
 	return { ok: true };
 }
 const TIER_ORDER = {
@@ -8482,7 +8621,11 @@ const TIER_ORDER = {
 		"fast"
 	]
 };
-function describeBlock(blockedBy, missingKey, missingInput) {
+function describeBlock(blockedBy, request, missingKey, missingInput) {
+	if (blockedBy === "outputFormat" && request.outputFormat !== void 0) {
+		const editing = (request.references ?? 0) > 0 || request.source !== void 0;
+		return `cannot return ${request.outputFormat}${editing ? " from an edit" : ""}`;
+	}
 	if (missingInput === true) return `needs a ${blockedBy} input`;
 	if (blockedBy === "key") return `needs ${missingKey ?? "a provider key"}`;
 	if (blockedBy === "unknown-model") return "is not a Model for this Task";
@@ -8551,7 +8694,7 @@ function resolveFixed(task, fixed, request, needed, keys) {
 	if (result.ok) return resolved(task, model, tier, chosenBy);
 	const unblockers = chosenBy === "model" ? [] : ["model"];
 	unblockers.push(unblockerFor(result));
-	return unresolved(task, result.blockedBy, unblockers, `${model} (${chosenBy}) ${describeBlock(result.blockedBy, result.missingKey, result.missingInput)}.`, result.missingKey);
+	return unresolved(task, result.blockedBy, unblockers, `${model} (${chosenBy}) ${describeBlock(result.blockedBy, request, result.missingKey, result.missingInput)}.`, result.missingKey);
 }
 /** Old pins and tuned Looks remain usable without recommending predecessors. */
 function legacyEntry(task, model, mode, tier) {
@@ -8648,730 +8791,6 @@ function tierChangesChoice(task, request, environment) {
 	return chosen.size > 1;
 }
 //#endregion
-//#region src/image/fetch.ts
-function urlOf$1(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$1(input), init ?? {}) };
-}
-//#endregion
-//#region src/image/fal.ts
-/**
-* fal provider adapter.
-*
-* Builds a Vercel AI SDK `ImageModel` from `@ai-sdk/fal`. Building a model
-* performs no network I/O — the request only happens when `generateImage`
-* invokes `model.doGenerate`. This is the lightweight fal *image* adapter; the
-* richer `FalClient` fal client (queue, upload, upscale, rmbg, video, tools)
-* is a separate, later fold (design doc §8, phase 1d).
-*
-* ENDPOINT QUIRK (Phase 0): fal's gpt-image endpoint wants `image_size` as a
-* STRING enum (e.g. "1024x1024"), passed at generate time via
-* `providerOptions.fal.image_size` — NOT the AI SDK's generic `size` object.
-* This adapter does NOT auto-inject it; callers pass `providerOptions` when they
-* need a specific size. Example:
-*   img.generate({
-*     provider: "fal",
-*     model: "fal-ai/gpt-image-1.5",
-*     prompt: "...",
-*     providerOptions: { fal: { image_size: "1024x1024" } },
-*   });
-*/
-/**
-* 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";
-/** 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. 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
-* drifting to a second hand-maintained copy; the `??` fallbacks are the registry
-* values at time of writing, used only if a registry entry loses its optional
-* price. Each key is `MODELS[x].endpoint`; the trailing comment cites the
-* `MODELS` key it comes from. Covers the flux/flux2 family, banana, seedream, and
-* the other priced fal generation endpoints.
-*/
-const FAL_IMAGE_PRICE_USD = {
-	[FAL_FLUX_MODEL]: MODELS.flux?.pricePerImageUsd ?? .06,
-	"fal-ai/flux/schnell": MODELS["flux-fast"]?.pricePerImageUsd ?? .003,
-	"fal-ai/flux-2-max": MODELS["flux2-max"]?.pricePerImageUsd ?? .07,
-	"fal-ai/flux-2-pro": MODELS["flux2-pro"]?.pricePerImageUsd ?? .03,
-	"fal-ai/flux-2-flex": MODELS["flux2-flex"]?.pricePerImageUsd ?? .05,
-	"fal-ai/flux-2": MODELS["flux2-dev"]?.pricePerImageUsd ?? .012,
-	"fal-ai/flux-2/turbo": MODELS["flux2-turbo"]?.pricePerImageUsd ?? .008,
-	[FAL_GPT_IMAGE_MODEL]: MODELS.gpt?.pricePerImageUsd ?? .133,
-	"openai/gpt-image-2": MODELS.gpt2?.pricePerImageUsd ?? .211,
-	"fal-ai/nano-banana-2": MODELS.banana2?.pricePerImageUsd ?? .08,
-	"fal-ai/nano-banana-pro": MODELS.banana?.pricePerImageUsd ?? .15,
-	"fal-ai/gemini-25-flash-image": MODELS.gemini?.pricePerImageUsd ?? .0398,
-	"fal-ai/gemini-3-pro-image-preview": MODELS.gemini3?.pricePerImageUsd ?? .15,
-	"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,
-	"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,
-	"xai/grok-imagine-image/quality/text-to-image": MODELS["grok-image-quality"]?.pricePerImageUsd ?? .05,
-	"meta/muse-image/text-to-image": MODELS["muse-image"]?.pricePerImageUsd ?? .01,
-	"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
-};
-/**
-* Build a fal `ImageModel`. Prefers the passed `apiKey`, else the `FAL_KEY` env
-* var. Throws `MotifError` when neither is present (callers translate this into
-* a `Result.err`).
-*/
-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 (0, _ai_sdk_fal.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",
-	apiKeyEnv: FAL_API_KEY_ENV,
-	resolveModel: resolveModel$3,
-	priceUsdByModel: FAL_IMAGE_PRICE_USD
-};
-//#endregion
-//#region src/image/openai.ts
-/**
-* OpenAI (gpt-image) provider adapter.
-*
-* Builds a Vercel AI SDK `ImageModel` from `@ai-sdk/openai`. Building a model
-* performs no network I/O — the request only happens when `generateImage`
-* invokes `model.doGenerate`.
-*/
-/** Env var read for the OpenAI API key when `apiKey` is not supplied in config. */
-const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
-/**
-* Static OpenAI-direct USD/image, keyed by model id.
-*
-* `gpt-image-1` ≈ $0.042/image at medium quality, 1024×1024. OpenAI bills image
-* output by tokens, so the real figure varies with quality (low/medium/high)
-* 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 — 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.
-* 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 };
-/**
-* Build an OpenAI `ImageModel`. Prefers the passed `apiKey`, else the
-* `OPENAI_API_KEY` env var. Throws `MotifError` when neither is present
-* (callers translate this into a `Result.err`).
-*/
-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 (0, _ai_sdk_openai.createOpenAI)({
-		apiKey: key,
-		...toProviderFetch(fetch)
-	}).image(modelId);
-}
-/** The OpenAI provider adapter registered in the provider registry. */
-const openaiAdapter = {
-	id: "openai",
-	apiKeyEnv: OPENAI_API_KEY_ENV,
-	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$3(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$3(body) && isRecord$3(body.error)) {
-		const { message } = body.error;
-		if (typeof message === "string" && message !== "") return message;
-	}
-	return fallback;
-}
-function parseResponse(body) {
-	if (!isRecord$3(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$3(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$3(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.
-*
-* Builds a Vercel AI SDK `ImageModel` from `@ai-sdk/replicate`. Building a model
-* performs no network I/O — the request only happens when `generateImage`
-* invokes `model.doGenerate`.
-*
-* NOTE: Replicate's SDK names the credential option `apiToken` (not `apiKey`),
-* and reads `REPLICATE_API_TOKEN` from the environment.
-*/
-/** Env var read for the Replicate API token when `apiToken` is not in config. */
-const REPLICATE_API_KEY_ENV = "REPLICATE_API_TOKEN";
-/**
-* Static Replicate USD/image, keyed by model id.
-*
-* `black-forest-labs/flux-1.1-pro-ultra` = $0.06/image (Replicate list price).
-* Source: https://replicate.com/black-forest-labs/flux-1.1-pro-ultra
-* Sanity anchor: fal's `fal-ai/flux-pro/v1.1-ultra` is also $0.06
-* (`MODELS.flux.pricePerImageUsd` in ../models) — same price, both routes.
-*/
-const REPLICATE_IMAGE_PRICE_USD = { "black-forest-labs/flux-1.1-pro-ultra": .06 };
-/**
-* Build a Replicate `ImageModel`. Prefers the passed `apiKey` (the normalized
-* 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, 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 (0, _ai_sdk_replicate.createReplicate)({
-		apiToken: token,
-		...toProviderFetch(fetch)
-	}).image(modelId);
-}
-//#endregion
-//#region src/image/provider.ts
-/**
-* The provider registry. Every id in {@link ImageProviderId}'s closed part maps
-* to its adapter; the open union tail means a lookup can still miss, so access
-* goes through {@link getProviderAdapter}.
-*/
-const PROVIDERS = {
-	openrouter: openrouterAdapter,
-	openai: openaiAdapter,
-	replicate: {
-		id: "replicate",
-		apiKeyEnv: REPLICATE_API_KEY_ENV,
-		resolveModel,
-		priceUsdByModel: REPLICATE_IMAGE_PRICE_USD
-	},
-	fal: falAdapter
-};
-/**
-* Look up an adapter by provider id, throwing a `MotifError` for an unknown
-* provider (callers catch this into a `Result.err`).
-*/
-function getProviderAdapter(provider) {
-	const adapter = PROVIDERS[provider];
-	if (adapter === void 0) throw new MotifError(`Unsupported image provider: ${provider}`, 0);
-	return adapter;
-}
-//#endregion
-//#region src/image/cost.ts
-/**
-* Per-call cost tracking for the image layer.
-*
-* Preference order:
-*   1. A cost surfaced by the provider on `result.providerMetadata` (most image
-*      providers do NOT surface one today, so this is usually absent).
-*   2. A static per-model table, owned per-adapter (`priceUsdByModel`) and read
-*      from the provider registry (see sources in each adapter).
-*   3. Unknown → `{ usd: 0, source: "unknown" }`.
-*/
-function isRecord$2(value) {
-	return typeof value === "object" && value !== null;
-}
-/**
-* Extract a provider-reported total cost from a `generateImage` result's
-* `providerMetadata`, if the provider surfaces a numeric `cost`. The shape is
-* `{ [provider]: { ...; cost?: number } }`. Returns undefined otherwise.
-*/
-function costFromProviderMetadata(providerMetadata) {
-	if (!isRecord$2(providerMetadata)) return;
-	for (const value of Object.values(providerMetadata)) if (isRecord$2(value)) {
-		const cost = value.cost;
-		if (typeof cost === "number" && Number.isFinite(cost)) return cost;
-	}
-}
-function tablePricePerImage(provider, modelId) {
-	const adapter = PROVIDERS[provider];
-	if (adapter === void 0) return;
-	return adapter.priceUsdByModel[modelId];
-}
-function roundUsd(value) {
-	return Number(value.toFixed(6));
-}
-/**
-* 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"
-	};
-	const perImage = tablePricePerImage(provider, modelId);
-	if (perImage !== void 0) return {
-		usd: roundUsd(perImage * Math.max(imageCount, 1)),
-		source: "table"
-	};
-	return {
-		usd: 0,
-		source: "unknown"
-	};
-}
-//#endregion
-//#region src/image/index.ts
-/**
-* `@howells/motif-sdk/image` — provider-agnostic image generation + editing.
-*
-* ESM-only subpath export, built on the Vercel AI SDK image interface
-* (`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: "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_PROVIDER = "openrouter";
-/**
-* Create a provider-agnostic image client.
-*
-* @param config - provider selection + keys (keys fall back to env).
-* @param deps - INTERNAL testing seam. Defaults to the real AI SDK `generateImage`
-*   and the built-in provider adapters; tests inject fakes here to run offline.
-*/
-function createMotifImage(config = {}, deps = {}) {
-	const generateImageFn = deps.generateImage ?? ai.generateImage;
-	const resolveModelFn = deps.resolveModel ?? defaultResolveModel;
-	function resolveProvider(provider) {
-		return provider ?? config.defaultProvider ?? DEFAULT_PROVIDER;
-	}
-	function apiKeyFor(provider) {
-		switch (provider) {
-			case "openrouter": return config.openrouter?.apiKey;
-			case "openai": return config.openai?.apiKey;
-			case "replicate": return config.replicate?.apiToken;
-			case "fal": return config.fal?.apiKey;
-			default: return;
-		}
-	}
-	async function generate(opts) {
-		const provider = resolveProvider(opts.provider);
-		try {
-			const modelId = opts.model;
-			const model = resolveModelFn(provider, modelId, apiKeyFor(provider), config.fetch);
-			const result = await generateImageFn({
-				model,
-				prompt: opts.prompt,
-				...opts.n === void 0 ? {} : { n: opts.n },
-				...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) }
-			});
-			return (0, neverthrow.ok)(toMotifImageResult(result, provider, modelId));
-		} catch (error) {
-			return (0, neverthrow.err)(toMotifError(error));
-		}
-	}
-	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 (0, neverthrow.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 = opts.model;
-			const model = resolveModelFn(provider, modelId, apiKeyFor(provider), config.fetch);
-			const result = await generateImageFn({
-				model,
-				prompt: {
-					images: opts.images,
-					text: opts.instruction,
-					...opts.mask === void 0 ? {} : { mask: opts.mask }
-				},
-				...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 },
-				...providerOptions === void 0 ? {} : { providerOptions: toProviderOptions(providerOptions) }
-			});
-			return (0, neverthrow.ok)(toMotifImageResult(result, provider, modelId));
-		} catch (error) {
-			return (0, neverthrow.err)(toMotifError(error));
-		}
-	}
-	async function bestOfN(opts) {
-		return await runBestOfN(opts, generate, edit);
-	}
-	return {
-		generate,
-		edit,
-		bestOfN
-	};
-}
-/**
-* Fire one best-of-N candidate: reuse `generate`/`edit` (discriminated by the
-* presence of `images`, narrowed inline so TS refines the union). Each candidate
-* makes a single image (`n: 1`) — the outer `n` is the candidate count, not the
-* per-call image count — and takes a distinct `seed` (`seed + index`) when a seed
-* was given, so the N vary. `opts.signal` rides along via the spread, so one
-* cancel aborts every candidate.
-*/
-async function runCandidate(opts, index, generate, edit) {
-	const candidateSeed = opts.seed === void 0 ? void 0 : opts.seed + index;
-	const overrides = {
-		n: 1,
-		...candidateSeed === void 0 ? {} : { seed: candidateSeed }
-	};
-	if ("images" in opts) return await edit({
-		...opts,
-		...overrides
-	});
-	return await generate({
-		...opts,
-		...overrides
-	});
-}
-/** Ask the judge to pick a winner and validate its index; no judge → index 0. */
-async function selectWinner(opts, candidates) {
-	const { judge } = opts;
-	if (judge === void 0) return (0, neverthrow.ok)({ chosenIndex: 0 });
-	const decision = await judge(candidates, "images" in opts ? { instruction: opts.instruction } : { prompt: opts.prompt });
-	if (!Number.isInteger(decision.index) || decision.index < 0 || decision.index >= candidates.length) return (0, neverthrow.err)(new MotifError(`bestOfN judge returned an out-of-range index ${decision.index} (expected 0..${candidates.length - 1})`, 0));
-	return (0, neverthrow.ok)({
-		chosenIndex: decision.index,
-		...decision.reason === void 0 ? {} : { reason: decision.reason }
-	});
-}
-/**
-* Best-of-N: generate `n` candidates in parallel, keep the successes, and pick a
-* winner via the (optional, injectable) judge. Wraps everything so no throw
-* escapes — any failure becomes a `Result.err`.
-*/
-async function runBestOfN(opts, generate, edit) {
-	try {
-		const { n } = opts;
-		if (!Number.isInteger(n) || n < 1) return (0, neverthrow.err)(new MotifError(`bestOfN requires an integer n >= 1 (got ${n})`, 0));
-		const results = await Promise.all(Array.from({ length: n }, (_unused, index) => index).map(async (index) => await runCandidate(opts, index, generate, edit)));
-		const candidates = [];
-		let firstError;
-		for (const result of results) if (result.isOk()) candidates.push(result.value);
-		else firstError ??= result.error;
-		if (candidates.length === 0) return (0, neverthrow.err)(firstError ?? new MotifError(`all ${n} bestOfN candidates failed`, 0));
-		const winner = await selectWinner(opts, candidates);
-		if (winner.isErr()) return (0, neverthrow.err)(winner.error);
-		const { chosenIndex, reason } = winner.value;
-		const best = candidates[chosenIndex];
-		if (best === void 0) return (0, neverthrow.err)(new MotifError("bestOfN failed to resolve a winner", 0));
-		const totalCostUsd = Number(candidates.reduce((sum, candidate) => sum + candidate.cost.usd, 0).toFixed(6));
-		return (0, neverthrow.ok)({
-			best,
-			chosenIndex,
-			...reason === void 0 ? {} : { reason },
-			candidates,
-			totalCostUsd
-		});
-	} catch (error) {
-		return (0, neverthrow.err)(toMotifError(error));
-	}
-}
-/** Default provider dispatch: resolve the model through the provider registry. */
-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) {
-	const images = result.images.map((file) => ({
-		uint8Array: file.uint8Array,
-		base64: file.base64,
-		mediaType: file.mediaType
-	}));
-	const cost = costForCalls(provider, model, result.calls.map((call) => call.providerMetadata), images.length);
-	const requestId = extractRequestId(result);
-	const warnings = result.warnings.map(renderWarning);
-	return {
-		images,
-		cost,
-		provider,
-		model,
-		...requestId === void 0 ? {} : { requestId },
-		...warnings.length === 0 ? {} : { warnings }
-	};
-}
-/** Render an AI SDK `Warning` object into a readable one-line string. */
-function renderWarning(warning) {
-	if (warning.type === "unsupported" || warning.type === "compatibility") {
-		const label = warning.type === "unsupported" ? "unsupported feature" : "compatibility mode for feature";
-		return warning.details === void 0 ? `${label} "${warning.feature}"` : `${label} "${warning.feature}": ${warning.details}`;
-	}
-	if (warning.type === "deprecated") return `deprecated setting "${warning.setting}": ${warning.message}`;
-	return warning.message;
-}
-function isRecord$1(value) {
-	return typeof value === "object" && value !== null;
-}
-/** Look for a provider correlation id in providerMetadata, then response headers. */
-function extractRequestId(result) {
-	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"];
-			if (typeof id === "string" && id !== "") return id;
-		}
-	}
-}
-function requestIdFromMetadata(providerMetadata) {
-	if (!isRecord$1(providerMetadata)) return;
-	for (const value of Object.values(providerMetadata)) if (isRecord$1(value)) {
-		const id = value.requestId ?? value.request_id;
-		if (typeof id === "string" && id !== "") return id;
-	}
-}
-/**
-* Coerce a public `providerOptions` (values typed `unknown`) into the AI SDK's
-* JSON-only `Record<string, Record<string, JSONValue>>`. Fails fast: a
-* non-JSON-representable value (undefined/function/bigint/symbol) throws a
-* `MotifError` naming the offending path rather than silently forwarding a value
-* the caller did not intend.
-*/
-function toProviderOptions(input) {
-	const out = {};
-	for (const [namespace, options] of Object.entries(input)) {
-		const inner = {};
-		for (const [key, value] of Object.entries(options)) inner[key] = toJsonValue(value, `providerOptions.${namespace}.${key}`);
-		out[namespace] = inner;
-	}
-	return out;
-}
-function toJsonValue(value, path) {
-	if (value === null) return null;
-	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-	if (typeof value === "object") {
-		if (Array.isArray(value)) {
-			const arr = [];
-			for (const [index, item] of value.entries()) arr.push(toJsonValue(item, `${path}[${index}]`));
-			return arr;
-		}
-		const obj = {};
-		for (const [key, entry] of Object.entries(value)) obj[key] = toJsonValue(entry, `${path}.${key}`);
-		return obj;
-	}
-	throw new MotifError(`providerOptions value at ${path} is not JSON-representable (type: ${typeof value})`, 0);
-}
-/**
-* Coerce an unknown thrown value into a `MotifError`, mirroring server.ts's
-* mapping: preserve an existing `MotifError`, lift a string `code`, and mark
-* non-HTTP local failures with status `0`.
-*/
-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;
-	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
 //#region src/task-output.ts
 function isPlainRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -9665,14 +9084,14 @@ function projectedOutputs(model, input, body) {
 }
 function outputSize(parameters, input, imageSize) {
 	if (typeof imageSize === "string") return FAL_PRESET_SIZES[imageSize];
-	if (isPixelSize$1(imageSize)) return imageSize;
+	if (isPixelSize(imageSize)) return imageSize;
 	if (imageSize === void 0) {
 		const fallback = parameters.find((parameter) => parameter.key === "image_size")?.fallback;
 		if (fallback === void 0) return sourceSizeOf(input);
 		return typeof fallback === "string" ? FAL_PRESET_SIZES[fallback] : void 0;
 	}
 }
-function isPixelSize$1(value) {
+function isPixelSize(value) {
 	return typeof value === "object" && value !== null && "width" in value && "height" in value && typeof value.width === "number" && typeof value.height === "number";
 }
 /** What the plan knows of the source, for prices that read it. */
@@ -10040,11 +9459,12 @@ function taskRequest(task, input) {
 		aspect: input.aspect,
 		count: input.count,
 		look: task === "generate" || task === "vary" ? input.look : void 0,
+		markup: input.markup !== void 0,
 		mask: input.mask !== void 0,
 		mode: input.mode,
 		model: input.model,
 		negativePrompt: input.negativePrompt !== void 0,
-		outputFormat: input.outputFormat !== void 0,
+		outputFormat: input.outputFormat,
 		references,
 		resolution: (task === "generate" || task === "vary") && input.resolution === "2K" ? void 0 : input.resolution,
 		rig: input.rig,
@@ -10057,7 +9477,6 @@ function taskRequest(task, input) {
 function resolve(task, input, context, options) {
 	const keys = [];
 	if (options.dryRun === true || context.falKey !== void 0) keys.push("FAL_KEY");
-	if (options.dryRun === true || context.openAiKey !== void 0) keys.push("OPENAI_API_KEY");
 	const resolution = resolveTask(task, taskRequest(task, input), {
 		keys,
 		pins: context.pins
@@ -10132,7 +9551,7 @@ function withCode(error, model, task) {
 		field: error.field,
 		task
 	});
-	const motif = toMotifError$1(error);
+	const motif = toMotifError(error);
 	if (motif.code !== void 0) return motif;
 	return new MotifError(motif.message, 0, INVALID_OPTION, void 0, {
 		model,
@@ -10155,6 +9574,7 @@ const GENERATION_FIELDS = /* @__PURE__ */ new Set([
 	"aspect",
 	"count",
 	"look",
+	"markup",
 	"mask",
 	"mood",
 	"negativePrompt",
@@ -10165,11 +9585,23 @@ const GENERATION_FIELDS = /* @__PURE__ */ new Set([
 	"seed",
 	"transparent"
 ]);
+const IMAGE_QUALITIES = [
+	"auto",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+function isImageQuality(value) {
+	return IMAGE_QUALITIES.some((level) => level === value);
+}
 /** The TaskInput field behind each option `buildGenerateBody` can refuse. */
 const FIELD_FOR_OPTION = {
 	aspect: "aspect",
 	background: "transparent",
 	"image editing": "references",
+	markupImageUrl: "markup",
 	maskImageUrl: "mask",
 	negativePrompt: "negativePrompt",
 	numImages: "count",
@@ -10209,23 +9641,34 @@ function generationPlan(task, model, config, input) {
 		task
 	}));
 	const editImageUrls = [...task === "vary" && input.image !== void 0 ? [input.image] : [], ...input.references ?? []];
+	if (input.markup !== void 0 && editImageUrls.length === 0) return (0, neverthrow.err)(invalidOption("Markup applies to the image being edited; pass references.", {
+		field: "markup",
+		requires: "references"
+	}));
 	if (input.mask !== void 0 && editImageUrls.length === 0) return (0, neverthrow.err)(invalidOption("A mask applies to a reference image; pass references.", {
 		field: "mask",
 		requires: "references"
 	}));
-	if (input.transparent === true && config.supportsBackground !== true && config.transparencyRoute !== void 0) return openAiPlan(task, model, config.transparencyRoute, input, editImageUrls);
-	if (input.outputFormat !== void 0 && config.supportedOutputFormats !== void 0 && !config.supportedOutputFormats.includes(input.outputFormat)) return (0, neverthrow.err)(cannotCarry("outputFormat", model, task));
+	if (input.outputFormat !== void 0 && !outputFormatsOf(config, editImageUrls.length > 0).includes(input.outputFormat)) return (0, neverthrow.err)(cannotCarry("outputFormat", model, task));
+	const { quality, ...params } = input.params ?? {};
+	const liftQuality = config.supportsQuality === true && quality !== void 0;
+	if (liftQuality && !isImageQuality(quality)) return (0, neverthrow.err)(invalidOption(`params.quality must be one of ${IMAGE_QUALITIES.join(", ")}.`, {
+		field: "params",
+		key: "quality"
+	}));
 	const options = {
 		aspect: input.aspect,
 		background: input.transparent === true ? "transparent" : void 0,
 		creative: creativeOf(input),
 		editImageUrls: editImageUrls.length > 0 ? editImageUrls : void 0,
+		markupImageUrl: input.markup,
 		maskImageUrl: input.mask,
 		model,
 		negativePrompt: input.negativePrompt,
 		numImages: input.count,
 		outputFormat: input.outputFormat,
 		prompt: task === "vary" && (input.prompt ?? "") === "" ? VARY_PROMPT : input.prompt ?? "",
+		quality: liftQuality && isImageQuality(quality) ? quality : void 0,
 		resolution: input.resolution,
 		seed: input.seed
 	};
@@ -10235,7 +9678,7 @@ function generationPlan(task, model, config, input) {
 	} catch (error) {
 		return (0, neverthrow.err)(generationError(error, model, task));
 	}
-	const merged = mergeParams(built.body, input.params, ownedGenerationKeys(input));
+	const merged = mergeParams(built.body, liftQuality ? params : input.params, ownedGenerationKeys(input));
 	if (merged.isErr()) return (0, neverthrow.err)(merged.error);
 	const badSize = checkParamsImageSize(config, model, task, input.params);
 	if (badSize !== void 0) return (0, neverthrow.err)(badSize);
@@ -10248,55 +9691,6 @@ function generationPlan(task, model, config, input) {
 		queued: config.useQueue === true || input.onProgress !== void 0 || input.onSubmitted !== void 0
 	});
 }
-/**
-* The OpenAI transparency route. Ported from the CLI's generate-openai: the
-* route carries only what gpt-image takes, so everything else is refused.
-*/
-function openAiPlan(task, model, route, input, editImageUrls) {
-	const allowed = /* @__PURE__ */ new Set([
-		"aspect",
-		"count",
-		"look",
-		"mask",
-		"mood",
-		"prompt",
-		"references",
-		"transparent"
-	]);
-	if (task === "vary") allowed.add("image");
-	if (input.outputFormat === "png") allowed.add("outputFormat");
-	const refused = refuseOthers(input, allowed, model, task);
-	if (refused !== void 0) return (0, neverthrow.err)(refused);
-	if (input.params !== void 0) return (0, neverthrow.err)(cannotCarry("params", model, task));
-	const editing = editImageUrls.length > 0;
-	if (editing && !route.supportsEdit) return (0, neverthrow.err)(cannotCarry("references", model, task));
-	let prompt;
-	try {
-		const creative = creativeOf(input);
-		prompt = creative === void 0 ? input.prompt ?? "" : enrichPrompt({
-			creative,
-			prompt: input.prompt ?? ""
-		}).prompt;
-	} catch (error) {
-		return (0, neverthrow.err)(withCode(error, model, task));
-	}
-	return (0, neverthrow.ok)({
-		body: {
-			n: input.count ?? 1,
-			prompt,
-			size: aspectToGptSize(input.aspect ?? "1:1"),
-			...editing && { images: [...editImageUrls] },
-			...input.mask !== void 0 && { mask: input.mask },
-			background: "transparent",
-			outputFormat: "png"
-		},
-		cost: UNKNOWN_COST,
-		endpoint: `${route.provider}:${route.model}`,
-		prompt,
-		provider: "openai",
-		queued: false
-	});
-}
 function flatPrice(pricing) {
 	const match = FLAT_PRICE_REGEX.exec(pricing.trim());
 	return match === null ? null : Number(match[1]);
@@ -10348,7 +9742,7 @@ function parsePayload(text) {
 		if (JSON_START.test(text.trim())) throw error;
 		raw = text;
 	}
-	if (!isRecord$4(raw) || Array.isArray(raw)) return {
+	if (!isRecord$1(raw) || Array.isArray(raw)) return {
 		raw,
 		files: []
 	};
@@ -10621,8 +10015,8 @@ function enforceBufferLimit(length, requestId) {
 /**
 * The Task client: one function per Task. `createMotif()` returns a client
 * whose `generate`, `erase`, `upscale` and the rest resolve the Model through
-* `resolveTask`, build the request that Model needs, run it on fal (or OpenAI
-* for a transparency route) and return the files and fields it produced.
+* `resolveTask`, build the request that Model needs, run it on fal and return
+* the files and fields it produced.
 *
 * @example
 * ```ts
@@ -10632,7 +10026,6 @@ function enforceBufferLimit(length, requestId) {
 * ```
 */
 const MISSING_API_KEY = "MISSING_API_KEY";
-const PIXEL_SIZE_REGEX = /^\d+x\d+$/;
 function presentKey(value) {
 	return value === void 0 || value === "" ? void 0 : value;
 }
@@ -10650,9 +10043,6 @@ function outputKeysFor(model, body) {
 	if (model === "clarity" || model === "crystal") return ["image"];
 	return ["images"];
 }
-function isPixelSize(size) {
-	return PIXEL_SIZE_REGEX.test(size);
-}
 function isRecord(value) {
 	return typeof value === "object" && value !== null;
 }
@@ -10703,106 +10093,6 @@ function falOutput(plan, result) {
 		tier: plan.tier
 	};
 }
-const DEFAULT_TIMEOUT_MS = 12e4;
-/**
-* Remote images as bytes, fetched through the configured seam: the AI SDK
-* would otherwise download them with global fetch. Data URLs pass through.
-*/
-async function localImages(sources, fetch) {
-	const images = [];
-	for (const source of sources) {
-		if (!source.startsWith("https://") && !source.startsWith("http://")) {
-			images.push(source);
-			continue;
-		}
-		try {
-			const response = await fetch(source, { method: "GET" });
-			if (!response.ok) return (0, neverthrow.err)(new MotifError(`Could not download ${source}: ${response.status}`, response.status, "DOWNLOAD_FAILED"));
-			images.push(new Uint8Array(await response.arrayBuffer()));
-		} catch (error) {
-			return (0, neverthrow.err)(new MotifError(`Could not download ${source}: ${error instanceof Error ? error.message : String(error)}`, 0, "DOWNLOAD_FAILED"));
-		}
-	}
-	return (0, neverthrow.ok)(images);
-}
-async function openAiOutput(plan, openAiKey, config) {
-	const fetch = config.fetch ?? (async (url, init) => await globalThis.fetch(url, init));
-	const client = createMotifImage({
-		defaultProvider: "openai",
-		fetch,
-		openai: { apiKey: openAiKey },
-		...config.retries !== void 0 && { maxRetries: config.retries }
-	});
-	const signal = AbortSignal.timeout(config.timeout ?? DEFAULT_TIMEOUT_MS);
-	const { body } = plan;
-	const [provider, model = ""] = plan.endpoint.split(":");
-	const n = typeof body.n === "number" ? body.n : 1;
-	const prompt = typeof body.prompt === "string" ? body.prompt : "";
-	const providerOptions = { openai: {
-		background: "transparent",
-		outputFormat: "png"
-	} };
-	const sources = Array.isArray(body.images) ? body.images.filter((item) => typeof item === "string") : [];
-	const mask = typeof body.mask === "string" ? [body.mask] : [];
-	const downloaded = await localImages([...sources, ...mask], fetch);
-	if (downloaded.isErr()) return (0, neverthrow.err)(downloaded.error);
-	const images = downloaded.value.slice(0, sources.length);
-	const maskImage = downloaded.value[sources.length];
-	const size = typeof body.size === "string" ? body.size : "auto";
-	const common = {
-		model,
-		n,
-		provider,
-		providerOptions,
-		signal
-	};
-	const result = images.length === 0 ? await client.generate({
-		...common,
-		prompt,
-		...isPixelSize(size) && { size }
-	}) : await client.edit({
-		...common,
-		images,
-		instruction: prompt,
-		...maskImage !== void 0 && { mask: maskImage }
-	});
-	if (result.isErr()) return (0, neverthrow.err)(result.error);
-	const value = result.value;
-	let cost = {
-		basis: "unknown",
-		usd: null
-	};
-	if (value.cost.source === "provider-metadata") cost = {
-		basis: "measured",
-		usd: value.cost.usd
-	};
-	else if (value.cost.source === "table") cost = {
-		basis: "projected",
-		usd: value.cost.usd
-	};
-	return (0, neverthrow.ok)({
-		chosenBy: plan.chosenBy,
-		cost,
-		data: {},
-		endpoint: plan.endpoint,
-		files: value.images.map((image) => ({
-			key: "images",
-			url: `data:${image.mediaType};base64,${image.base64}`
-		})),
-		model: plan.model,
-		...plan.mode !== void 0 && { mode: plan.mode },
-		...plan.prompt !== void 0 && { prompt: plan.prompt },
-		provider: plan.provider,
-		raw: {
-			model: value.model,
-			provider: value.provider,
-			...value.warnings !== void 0 && { warnings: value.warnings }
-		},
-		...value.requestId !== void 0 && { requestId: value.requestId },
-		task: plan.task,
-		tier: plan.tier
-	});
-}
 function taskStreamer(config, plan, context) {
 	return async (task, input, options = {}) => {
 		const planned = plan(task, input);
@@ -10813,12 +10103,11 @@ function taskStreamer(config, plan, context) {
 		});
 	};
 }
-/** Create the Task client. Keys fall back to FAL_KEY and OPENAI_API_KEY. */
+/** Create the Task client. The key falls back to FAL_KEY. */
 function createMotif(config = {}) {
 	function context() {
 		return {
 			falKey: presentKey(config.falKey ?? getFalKeyFromEnv()),
-			openAiKey: presentKey(config.openAiKey ?? getOpenAiKeyFromEnv()),
 			pins: config.pins
 		};
 	}
@@ -10841,11 +10130,6 @@ function createMotif(config = {}) {
 		const planned = plan(task, input);
 		if (planned.isErr()) return (0, neverthrow.err)(planned.error);
 		const chosen = planned.value;
-		if (chosen.provider === "openai") {
-			const openAiKey = context().openAiKey;
-			if (openAiKey === void 0) return (0, neverthrow.err)(new MotifError("OPENAI_API_KEY is not set.", 0, MISSING_API_KEY, void 0, { envVar: "OPENAI_API_KEY" }));
-			return await openAiOutput(chosen, openAiKey, config);
-		}
 		const headers = input.ephemeral === true ? { "X-Fal-Store-IO": "0" } : {};
 		const prepared = {
 			body: chosen.body,
@@ -10853,13 +10137,12 @@ function createMotif(config = {}) {
 			headers
 		};
 		const executor = falRequestExecutor(client.value);
-		return (chosen.queued ? await runRequestQueued(executor, prepared, input.onProgress, input.onSubmitted) : await runRequest(executor, prepared)).map((value) => falOutput(chosen, value));
+		return (chosen.queued || input.onSubmitted !== void 0 ? await runRequestQueued(executor, prepared, input.onProgress, input.onSubmitted) : await runRequest(executor, prepared)).map((value) => falOutput(chosen, value));
 	}
 	async function resume(task, input, requestId) {
 		const planned = plan(task, input);
 		if (planned.isErr()) return (0, neverthrow.err)(planned.error);
 		const chosen = planned.value;
-		if (chosen.provider !== "fal") return (0, neverthrow.err)(new MotifError(`Only a fal run can be resumed; ${chosen.model} runs on ${chosen.provider}.`, 0));
 		const client = falClient();
 		if (client.isErr()) return (0, neverthrow.err)(client.error);
 		return (await awaitQueuedRequest(falRequestExecutor(client.value), {
@@ -10932,7 +10215,6 @@ Object.defineProperty(exports, "err", {
 exports.formatCost = formatCost;
 exports.getFalKeyFromEnv = getFalKeyFromEnv;
 exports.getLook = getLook;
-exports.getOpenAiKeyFromEnv = getOpenAiKeyFromEnv;
 exports.isFalAccountLocked = isFalAccountLocked;
 exports.isTaskId = isTaskId;
 exports.modelProfile = modelProfile;