@howells/motif-sdk 5.4.0 → 6.0.0

package/dist/index.js

@@ -1,10 +1,6 @@
 import { err, err as err$1, ok, ok as ok$1 } from "neverthrow";
 import { defineEnv } from "@howells/envy";
 import { z } from "zod";
-import { generateImage } from "ai";
-import { createFal } from "@ai-sdk/fal";
-import { createOpenAI } from "@ai-sdk/openai";
-import { createReplicate } from "@ai-sdk/replicate";
 //#region src/aspects.ts
 /** Ordered by popularity: square first, then common ratios */
 const ASPECT_RATIOS = [
@@ -354,7 +350,7 @@ const CREATIVE_TAXONOMY = {
 			experimental: true,
 			id: "illustration",
 			label: "Editorial illustration",
-			model: "gpt2"
+			model: "flare"
 		}
 	],
 	mood: [
@@ -537,7 +533,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);
 }
@@ -691,20 +687,13 @@ function promptWarnings(prompt, context = {}) {
 }
 //#endregion
 //#region src/env.ts
-const motifEnvSchema = defineEnv({ optional: {
-	FAL_KEY: z.string().min(1),
-	OPENAI_API_KEY: z.string().min(1)
-} });
+const motifEnvSchema = defineEnv({ optional: { FAL_KEY: 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";
@@ -849,77 +838,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: {
@@ -2501,7 +2419,6 @@ const MODELS = {
 const GENERATION_MODELS = [
 	"sunburst",
 	"flare",
-	"gpt2",
 	"gpt",
 	"banana21",
 	"banana2",
@@ -2566,7 +2483,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;
@@ -2595,7 +2511,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) {
@@ -2605,7 +2521,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) ?? "",
@@ -2620,7 +2536,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) ?? ""
 	});
@@ -2650,7 +2566,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)
@@ -2690,7 +2606,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
@@ -2780,8 +2696,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;
@@ -2902,7 +2817,7 @@ 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) {
@@ -4556,7 +4471,7 @@ async function runRequest(exec, prepared) {
 	const response = await exec.request(`${FAL_BASE_URL$1}/${prepared.endpoint}`, requestInit(prepared));
 	if (response.isErr()) return err$1(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 ok$1({
 		data: record,
@@ -4583,7 +4498,7 @@ async function getToolResult(exec, job) {
 	const response = await exec.request(url);
 	if (response.isErr()) return err$1(response.error);
 	const data = await response.value.json();
-	return ok$1(isRecord$4(data) ? data : {});
+	return ok$1(isRecord$1(data) ? data : {});
 }
 /** Poll a submitted job to completion and fetch its result. Submits nothing. */
 async function awaitQueuedRequest(exec, job, onProgress) {
@@ -4692,7 +4607,7 @@ var FalClient = class {
 		try {
 			built = buildGenerateBody(options);
 		} catch (error) {
-			return err$1(toMotifError$1(error));
+			return err$1(toMotifError(error));
 		}
 		const { endpoint, body } = built;
 		const response = await this.request(`${FAL_BASE_URL}/${endpoint}`, {
@@ -4730,7 +4645,7 @@ var FalClient = class {
 		try {
 			built = buildGenerateBody(options);
 		} catch (error) {
-			return err$1(toMotifError$1(error));
+			return err$1(toMotifError(error));
 		}
 		const { endpoint, body } = built;
 		const response = await this.request(`${FAL_QUEUE_URL}/${endpoint}`, {
@@ -4752,7 +4667,7 @@ var FalClient = class {
 		const response = await this.request(url);
 		if (response.isErr()) return err$1(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";
@@ -4860,7 +4775,7 @@ var FalClient = class {
 		const response = await this.request(url);
 		if (response.isErr()) return err$1(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 err$1(new MotifError("No video in response", 0));
 		return ok$1({
 			contentType: asString(video.content_type) ?? "",
@@ -4884,8 +4799,8 @@ var FalClient = class {
 		});
 		if (initiateResponse.isErr()) return err$1(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 err$1(new MotifError("Upload initiate response missing upload_url", 0));
 		let putResponse;
 		try {
@@ -5037,7 +4952,7 @@ var FalClient = class {
 	* Some APIs return `{ image: {...} }` instead of `{ images: [...] }`.
 	*/
 	normalizeResponse(data, fallbackRequestId) {
-		if (!isRecord$4(data)) return err$1(new MotifError("Unexpected fal response shape", 0, "FAL_ERROR"));
+		if (!isRecord$1(data)) return err$1(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 err$1(new MotifError(asString(obj.detail) ?? "", 0, "FAL_ERROR"));
@@ -5359,13 +5274,6 @@ const BOARDS = {
 			preliminary: true,
 			votes: 39218
 		},
-		gpt2: {
-			elo: 1381,
-			rank: 3,
-			uncertainty: 4,
-			evaluatedModel: "GPT-Image-2 (Medium)",
-			votes: 103385
-		},
 		banana21: {
 			elo: 1325,
 			rank: 5,
@@ -5461,12 +5369,6 @@ const BOARDS = {
 			evaluatedModel: "GPT-Image-2.5 Flare",
 			preliminary: true
 		},
-		gpt2: {
-			elo: 1460,
-			rank: 4,
-			uncertainty: 3,
-			evaluatedModel: "GPT-Image-2 (Medium)"
-		},
 		"grok-image-2": {
 			elo: 1439,
 			rank: 5,
@@ -5577,10 +5479,6 @@ const GENERATION_MODELS_RANKED = withImageBenchmarks([
 		model: "flare",
 		tier: "quality"
 	},
-	{
-		model: "gpt2",
-		tier: "quality"
-	},
 	{
 		model: "seedream5",
 		tier: "quality"
@@ -5677,10 +5575,6 @@ const EDITING_MODELS_RANKED = withImageBenchmarks([
 		model: "flare",
 		tier: "quality"
 	},
-	{
-		model: "gpt2",
-		tier: "quality"
-	},
 	{
 		model: "seedream5",
 		tier: "quality"
@@ -8603,9 +8497,7 @@ 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");
@@ -8618,7 +8510,6 @@ function generationProfile(config) {
 	return {
 		aspects: config.supportedAspects,
 		capabilities,
-		keyedCapabilities: keyed,
 		keys: [FAL_KEY],
 		maxReferences: config.supportsEdit ? config.maxReferenceImages ?? 1 : 0,
 		outputFormats: {
@@ -8651,7 +8542,6 @@ function toolProfile(tool) {
 	if (takesReference) capabilities.add("references");
 	return {
 		capabilities,
-		keyedCapabilities: /* @__PURE__ */ new Map(),
 		keys: [FAL_KEY],
 		maxReferences: takesReference ? 1 : 0
 	};
@@ -8707,25 +8597,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 = {
@@ -8915,730 +8790,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 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.6 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.6-flare
-* https://developers.openai.com/api/docs/models/gpt-image-2.6-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 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 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 ?? 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 ok$1(toMotifImageResult(result, provider, modelId));
-		} catch (error) {
-			return err$1(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 err$1(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 ok$1(toMotifImageResult(result, provider, modelId));
-		} catch (error) {
-			return err$1(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 ok$1({ 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 err$1(new MotifError(`bestOfN judge returned an out-of-range index ${decision.index} (expected 0..${candidates.length - 1})`, 0));
-	return ok$1({
-		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 err$1(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 err$1(firstError ?? new MotifError(`all ${n} bestOfN candidates failed`, 0));
-		const winner = await selectWinner(opts, candidates);
-		if (winner.isErr()) return err$1(winner.error);
-		const { chosenIndex, reason } = winner.value;
-		const best = candidates[chosenIndex];
-		if (best === void 0) return err$1(new MotifError("bestOfN failed to resolve a winner", 0));
-		const totalCostUsd = Number(candidates.reduce((sum, candidate) => sum + candidate.cost.usd, 0).toFixed(6));
-		return ok$1({
-			best,
-			chosenIndex,
-			...reason === void 0 ? {} : { reason },
-			candidates,
-			totalCostUsd
-		});
-	} catch (error) {
-		return err$1(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);
@@ -9932,14 +9083,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. */
@@ -10325,7 +9476,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
@@ -10400,7 +9550,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,
@@ -10498,7 +9648,6 @@ function generationPlan(task, model, config, input) {
 		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 && !outputFormatsOf(config, editImageUrls.length > 0).includes(input.outputFormat)) return err$1(cannotCarry("outputFormat", model, task));
 	const { quality, ...params } = input.params ?? {};
 	const liftQuality = config.supportsQuality === true && quality !== void 0;
@@ -10541,55 +9690,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 err$1(refused);
-	if (input.params !== void 0) return err$1(cannotCarry("params", model, task));
-	const editing = editImageUrls.length > 0;
-	if (editing && !route.supportsEdit) return err$1(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 err$1(withCode(error, model, task));
-	}
-	return ok$1({
-		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]);
@@ -10641,7 +9741,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: []
 	};
@@ -10914,8 +10014,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
@@ -10925,7 +10025,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;
 }
@@ -10943,9 +10042,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;
 }
@@ -10996,106 +10092,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 err$1(new MotifError(`Could not download ${source}: ${response.status}`, response.status, "DOWNLOAD_FAILED"));
-			images.push(new Uint8Array(await response.arrayBuffer()));
-		} catch (error) {
-			return err$1(new MotifError(`Could not download ${source}: ${error instanceof Error ? error.message : String(error)}`, 0, "DOWNLOAD_FAILED"));
-		}
-	}
-	return ok$1(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 err$1(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 err$1(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 ok$1({
-		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);
@@ -11106,12 +10102,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
 		};
 	}
@@ -11134,11 +10129,6 @@ function createMotif(config = {}) {
 		const planned = plan(task, input);
 		if (planned.isErr()) return err$1(planned.error);
 		const chosen = planned.value;
-		if (chosen.provider === "openai") {
-			const openAiKey = context().openAiKey;
-			if (openAiKey === void 0) return err$1(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,
@@ -11152,7 +10142,6 @@ function createMotif(config = {}) {
 		const planned = plan(task, input);
 		if (planned.isErr()) return err$1(planned.error);
 		const chosen = planned.value;
-		if (chosen.provider !== "fal") return err$1(new MotifError(`Only a fal run can be resumed; ${chosen.model} runs on ${chosen.provider}.`, 0));
 		const client = falClient();
 		if (client.isErr()) return err$1(client.error);
 		return (await awaitQueuedRequest(falRequestExecutor(client.value), {
@@ -11198,4 +10187,4 @@ function createMotif(config = {}) {
 	};
 }
 //#endregion
-export { ACCOUNT_LOCKED, ASPECT_RATIOS, CREATIVE_FIELDS, CREATIVE_TAXONOMY, CreativeOptionError, DEFAULT_TIER, FORMAT_PRESETS, INVALID_OPTION, ImageSizeBoundsError, LOOKS, MotifError, NO_MODEL_AVAILABLE, RESOLUTIONS, TASKS, TASK_IDS, TIERS, createMotif, enrichPrompt, err, formatCost, getFalKeyFromEnv, getLook, getOpenAiKeyFromEnv, isFalAccountLocked, isTaskId, modelProfile, motifEnvSchema, ok, parseMotifEnv, promptWarnings, resolveTask, sanitizePrompt, sumCosts, tierChangesChoice, validateCreativeDirection };
+export { ACCOUNT_LOCKED, ASPECT_RATIOS, CREATIVE_FIELDS, CREATIVE_TAXONOMY, CreativeOptionError, DEFAULT_TIER, FORMAT_PRESETS, INVALID_OPTION, ImageSizeBoundsError, LOOKS, MotifError, NO_MODEL_AVAILABLE, RESOLUTIONS, TASKS, TASK_IDS, TIERS, createMotif, enrichPrompt, err, formatCost, getFalKeyFromEnv, getLook, isFalAccountLocked, isTaskId, modelProfile, motifEnvSchema, ok, parseMotifEnv, promptWarnings, resolveTask, sanitizePrompt, sumCosts, tierChangesChoice, validateCreativeDirection };