@howells/motif-sdk 5.2.0 → 5.3.0

package/README.md

@@ -34,12 +34,12 @@ Every Task function returns `Result<TaskOutput, MotifError>` from `neverthrow` a
 
 ## Curated Models and Tiers
 
-The Task client curates 21 generation Models, with separate rankings for generation and editing. `TASKS.generate` and `TASKS.vary` expose the current choices, Tiers and evidence in `basis` and `rankedAt`. A generation with `references` uses the editing ranking.
+The Task client curates 24 generation Models, with separate rankings for generation and editing. Both follow Arena, read 29 October 2026. `TASKS.generate` and `TASKS.vary` expose the current choices, Tiers and evidence in `basis` and `rankedAt`. A generation with `references` uses the editing ranking.
 
 | Tier                 | Generation default | Editing default   |
 | -------------------- | ------------------ | ----------------- |
 | `quality`            | Sunburst at `max`  | Sunburst at `max` |
-| `balanced` (default) | Nano Banana 2.1    | Nano Banana 2.1   |
+| `balanced` (default) | Nano Banana 2.1    | Grok Image 2      |
 | `fast`               | Nano Banana 2 Lite | Grok              |
 
 These are the first choices when the request's capabilities and available keys permit them. Explicit Models, Looks and pins take precedence. Selected specialists remain for typography, transparency, control and inexpensive drafts. Archived predecessors remain available through explicit Models, pins and existing Looks, including `flux2-dev` for streaming.

package/dist/image.js

@@ -57,6 +57,7 @@ const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
 const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
+const FAL_PRICING_CHECKED_OCT_2026 = "2026-10-29";
 const MODELS = {
 	flare: {
 		benchmark: {
@@ -1413,6 +1414,7 @@ const MODELS = {
 			maxPixels: 4194304,
 			minPixels: 262144
 		},
+		editEndpoint: "alibaba/qwen-image-3/edit",
 		endpoint: "alibaba/qwen-image-3/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
@@ -1423,12 +1425,13 @@ const MODELS = {
 			unit: "images",
 			unitPrice: .04
 		},
+		maxReferenceImages: 3,
 		name: "Qwen Image 3",
 		pricePerImageUsd: .04,
 		pricing: "$0.04 (1K) / $0.075 (2K)",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsNegativePrompt: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -1631,6 +1634,120 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
+	"muse-image": {
+		benchmark: { useCase: "Low-cost generation and multi-reference editing; Arena #8 generation / #10 editing, 2026-10-29" },
+		editEndpoint: "meta/muse-image/edit",
+		endpoint: "meta/muse-image/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "meta/muse-image/text-to-image",
+			estimatedCostPerImageUsd: .01,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .01
+		},
+		maxReferenceImages: 10,
+		name: "Meta Muse Image",
+		pricePerImageUsd: .01,
+		pricing: "$0.01",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:5",
+			"5:4",
+			"21:9",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	krea3: {
+		benchmark: { useCase: "Reference editing with prompt planning. Motif sends fal's defaults (berry, medium reasoning), which Arena has not scored; Arena's 1411 editing score (2026-10-29) is for Ultra, available with --param reasoning_level=ultra" },
+		customImageSize: {
+			maxEdge: 3200,
+			maxPixels: 4220160,
+			minEdge: 256,
+			multipleOf: 16
+		},
+		editEndpoint: "krea/v3/edit",
+		endpoint: "krea/v3/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "krea/v3/text-to-image",
+			estimatedCostPerImageUsd: .025,
+			source: "fal-pricing-api",
+			unit: "megapixels",
+			unitPrice: .025
+		},
+		maxReferenceImages: 8,
+		name: "Krea 3",
+		pricePerImageUsd: .025,
+		pricing: "$0.025/MP (edits also bill each reference)",
+		sizeMode: "image_size_enum",
+		supportedOutputFormats: ["png", "jpeg"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNegativePrompt: true,
+		supportsNumImages: false,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSafetyChecker: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	"grok-image-quality": {
+		benchmark: { useCase: "Detailed generation and editing with stronger text rendering; Arena #11 editing, 2026-10-29" },
+		editEndpoint: "xai/grok-imagine-image/quality/edit",
+		endpoint: "xai/grok-imagine-image/quality/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "xai/grok-imagine-image/quality/text-to-image",
+			estimatedCostPerImageUsd: .05,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .05
+		},
+		maxReferenceImages: 3,
+		name: "Grok Imagine Image Quality",
+		pricePerImageUsd: .05,
+		pricing: "$0.05 (1K) / $0.07 (2K)",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
 	kling: {
 		endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
 		name: "Kling v3 Pro",
@@ -1708,7 +1825,10 @@ const MODELS = {
 	"qwen3",
 	"banana2-lite",
 	"grok-image-2",
+	"grok-image-quality",
 	"grok-image",
+	"muse-image",
+	"krea3",
 	"flux2-flex",
 	"flux2-pro",
 	"flux2-turbo",
@@ -3442,6 +3562,8 @@ const FAL_IMAGE_PRICE_USD = {
 	"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,

package/dist/index.cjs

@@ -713,6 +713,7 @@ const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
 const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
+const FAL_PRICING_CHECKED_OCT_2026 = "2026-10-29";
 const MODELS = {
 	flare: {
 		benchmark: {
@@ -2069,6 +2070,7 @@ const MODELS = {
 			maxPixels: 4194304,
 			minPixels: 262144
 		},
+		editEndpoint: "alibaba/qwen-image-3/edit",
 		endpoint: "alibaba/qwen-image-3/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
@@ -2079,12 +2081,13 @@ const MODELS = {
 			unit: "images",
 			unitPrice: .04
 		},
+		maxReferenceImages: 3,
 		name: "Qwen Image 3",
 		pricePerImageUsd: .04,
 		pricing: "$0.04 (1K) / $0.075 (2K)",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsNegativePrompt: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -2287,6 +2290,120 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
+	"muse-image": {
+		benchmark: { useCase: "Low-cost generation and multi-reference editing; Arena #8 generation / #10 editing, 2026-10-29" },
+		editEndpoint: "meta/muse-image/edit",
+		endpoint: "meta/muse-image/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "meta/muse-image/text-to-image",
+			estimatedCostPerImageUsd: .01,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .01
+		},
+		maxReferenceImages: 10,
+		name: "Meta Muse Image",
+		pricePerImageUsd: .01,
+		pricing: "$0.01",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:5",
+			"5:4",
+			"21:9",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	krea3: {
+		benchmark: { useCase: "Reference editing with prompt planning. Motif sends fal's defaults (berry, medium reasoning), which Arena has not scored; Arena's 1411 editing score (2026-10-29) is for Ultra, available with --param reasoning_level=ultra" },
+		customImageSize: {
+			maxEdge: 3200,
+			maxPixels: 4220160,
+			minEdge: 256,
+			multipleOf: 16
+		},
+		editEndpoint: "krea/v3/edit",
+		endpoint: "krea/v3/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "krea/v3/text-to-image",
+			estimatedCostPerImageUsd: .025,
+			source: "fal-pricing-api",
+			unit: "megapixels",
+			unitPrice: .025
+		},
+		maxReferenceImages: 8,
+		name: "Krea 3",
+		pricePerImageUsd: .025,
+		pricing: "$0.025/MP (edits also bill each reference)",
+		sizeMode: "image_size_enum",
+		supportedOutputFormats: ["png", "jpeg"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNegativePrompt: true,
+		supportsNumImages: false,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSafetyChecker: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	"grok-image-quality": {
+		benchmark: { useCase: "Detailed generation and editing with stronger text rendering; Arena #11 editing, 2026-10-29" },
+		editEndpoint: "xai/grok-imagine-image/quality/edit",
+		endpoint: "xai/grok-imagine-image/quality/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "xai/grok-imagine-image/quality/text-to-image",
+			estimatedCostPerImageUsd: .05,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .05
+		},
+		maxReferenceImages: 3,
+		name: "Grok Imagine Image Quality",
+		pricePerImageUsd: .05,
+		pricing: "$0.05 (1K) / $0.07 (2K)",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
 	kling: {
 		endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
 		name: "Kling v3 Pro",
@@ -2365,7 +2482,10 @@ const GENERATION_MODELS = [
 	"qwen3",
 	"banana2-lite",
 	"grok-image-2",
+	"grok-image-quality",
 	"grok-image",
+	"muse-image",
+	"krea3",
 	"flux2-flex",
 	"flux2-pro",
 	"flux2-turbo",
@@ -2407,6 +2527,7 @@ function estimateCost(model, resolution, numImages = 1, editImages = 0) {
 	if (configuredPrice === null) return null;
 	if (model === "mai-image-2.5-pro" && editImages > 0) return .27 * numImages;
 	if (model === "grok-image-2" && editImages > 0) return (resolution === "2K" || resolution === "4K" ? .08 : .06) * numImages + .01 * editImages;
+	if (model === "grok-image-quality") return (resolution === "2K" || resolution === "4K" ? .07 : .05) * numImages + .01 * editImages;
 	if (configuredPrice !== void 0) {
 		if ((model === "banana" || model === "gemini3") && resolution === "4K") return configuredPrice * 2 * numImages;
 		if (model === "seedream5" && (resolution === "2K" || resolution === "4K")) return configuredPrice * 2 * numImages;
@@ -2762,7 +2883,7 @@ function buildGenerateBody(options) {
 			break;
 		case "aspect_ratio":
 			if (config.supportsAspect) body.aspect_ratio = aspect;
-			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" ? resolution.toLowerCase() : resolution;
+			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" || model === "grok-image-quality" ? resolution.toLowerCase() : resolution;
 	}
 	if (config.supportsQuality === true) body.quality = quality ?? config.defaultQuality ?? "high";
 	if (config.supportsBackground === true && background) body.background = background;
@@ -5192,7 +5313,7 @@ const TIERS = [
 ];
 const DEFAULT_TIER = "balanced";
 const HAND_RANKED_AT = "2026-09-16";
-const IMAGE_RANKED_AT = "2026-10-07";
+const IMAGE_RANKED_AT = "2026-10-29";
 /** Every Task with a Model. A Task is absent here until it has at least one Model. */
 const TASKS = {
 	animate: {
@@ -5363,7 +5484,7 @@ const TASKS = {
 		summary: "Remove an object, person, text or clutter from an image and fill the gap."
 	},
 	generate: {
-		basis: "Curated from Artificial Analysis v2, captured 2026-10-07, and Arena 2026-10-06. Sunburst and Flare lead quality at the benchmarked max setting. Nano Banana 2.1 leads balanced on preliminary Arena evidence and lower representative cost; Grok Image 2 and MAI 2.5 are established alternatives. 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.",
+		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",
@@ -5378,15 +5499,15 @@ const TASKS = {
 				tier: "quality"
 			},
 			{
-				model: "gpt",
+				model: "seedream5",
 				tier: "quality"
 			},
 			{
-				model: "mai-image-2.5-pro",
+				model: "gpt",
 				tier: "quality"
 			},
 			{
-				model: "seedream5",
+				model: "mai-image-2.5-pro",
 				tier: "quality"
 			},
 			{
@@ -5397,10 +5518,18 @@ const TASKS = {
 				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"
@@ -5410,23 +5539,27 @@ const TASKS = {
 				tier: "balanced"
 			},
 			{
-				model: "qwen3",
+				model: "ideogram4",
 				tier: "balanced"
 			},
 			{
 				model: "flux2-flex",
 				tier: "balanced"
 			},
+			{
+				model: "recraft41",
+				tier: "balanced"
+			},
 			{
 				model: "flux2-pro",
 				tier: "balanced"
 			},
 			{
-				model: "ideogram4",
+				model: "krea3",
 				tier: "balanced"
 			},
 			{
-				model: "recraft41",
+				model: "grok-image-quality",
 				tier: "balanced"
 			},
 			{
@@ -5938,7 +6071,7 @@ const TASKS = {
 		summary: "Trace a raster image to a clean SVG."
 	},
 	vary: {
-		basis: "Curated from Artificial Analysis v2 editing, captured 2026-10-07, and preliminary Arena 2026-10-06 evidence for Nano Banana 2.1. Editing order differs from generation: MAI 2.5 outranks Grok Image 2, and Seedream 5 Pro outranks GPT Image 1.5. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.",
+		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",
@@ -5953,17 +6086,21 @@ const TASKS = {
 				tier: "quality"
 			},
 			{
-				model: "mai-image-2.5-pro",
+				model: "seedream5",
 				tier: "quality"
 			},
 			{
-				model: "seedream5",
+				model: "gpt",
 				tier: "quality"
 			},
 			{
-				model: "gpt",
+				model: "mai-image-2.5-pro",
 				tier: "quality"
 			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
 			{
 				model: "banana21",
 				tier: "balanced"
@@ -5973,17 +6110,29 @@ const TASKS = {
 				tier: "balanced"
 			},
 			{
-				model: "grok-image-2",
+				model: "muse-image",
 				tier: "balanced"
 			},
 			{
-				model: "banana2",
+				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"
@@ -5997,11 +6146,11 @@ const TASKS = {
 				tier: "fast"
 			},
 			{
-				model: "seedream5-lite",
+				model: "banana2-lite",
 				tier: "fast"
 			},
 			{
-				model: "banana2-lite",
+				model: "seedream5-lite",
 				tier: "fast"
 			}
 		],
@@ -8577,6 +8726,8 @@ const FAL_IMAGE_PRICE_USD = {
 	"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,

package/dist/index.d.cts

@@ -524,10 +524,10 @@ export declare const TASKS: {
     readonly summary: "Remove an object, person, text or clutter from an image and fill the gap.";
   };
   readonly generate: {
-    readonly basis: "Curated from Artificial Analysis v2, captured 2026-10-07, and Arena 2026-10-06. Sunburst and Flare lead quality at the benchmarked max setting. Nano Banana 2.1 leads balanced on preliminary Arena evidence and lower representative cost; Grok Image 2 and MAI 2.5 are established alternatives. 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.";
+    readonly 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.";
     readonly models: readonly RankedModel[];
     readonly notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).";
-    readonly rankedAt: "2026-10-07";
+    readonly rankedAt: "2026-10-29";
     readonly rankedFrom: "hand";
     readonly summary: "Make an image from a prompt, or change an image you pass as a reference.";
   };
@@ -937,10 +937,10 @@ export declare const TASKS: {
     readonly summary: "Trace a raster image to a clean SVG.";
   };
   readonly vary: {
-    readonly basis: "Curated from Artificial Analysis v2 editing, captured 2026-10-07, and preliminary Arena 2026-10-06 evidence for Nano Banana 2.1. Editing order differs from generation: MAI 2.5 outranks Grok Image 2, and Seedream 5 Pro outranks GPT Image 1.5. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
+    readonly 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.";
     readonly models: readonly RankedModel[];
     readonly 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).";
-    readonly rankedAt: "2026-10-07";
+    readonly rankedAt: "2026-10-29";
     readonly rankedFrom: "hand";
     readonly summary: "Make variations of an image you already have.";
   };

package/dist/index.d.ts

@@ -524,10 +524,10 @@ export declare const TASKS: {
     readonly summary: "Remove an object, person, text or clutter from an image and fill the gap.";
   };
   readonly generate: {
-    readonly basis: "Curated from Artificial Analysis v2, captured 2026-10-07, and Arena 2026-10-06. Sunburst and Flare lead quality at the benchmarked max setting. Nano Banana 2.1 leads balanced on preliminary Arena evidence and lower representative cost; Grok Image 2 and MAI 2.5 are established alternatives. 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.";
+    readonly 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.";
     readonly models: readonly RankedModel[];
     readonly notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).";
-    readonly rankedAt: "2026-10-07";
+    readonly rankedAt: "2026-10-29";
     readonly rankedFrom: "hand";
     readonly summary: "Make an image from a prompt, or change an image you pass as a reference.";
   };
@@ -937,10 +937,10 @@ export declare const TASKS: {
     readonly summary: "Trace a raster image to a clean SVG.";
   };
   readonly vary: {
-    readonly basis: "Curated from Artificial Analysis v2 editing, captured 2026-10-07, and preliminary Arena 2026-10-06 evidence for Nano Banana 2.1. Editing order differs from generation: MAI 2.5 outranks Grok Image 2, and Seedream 5 Pro outranks GPT Image 1.5. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.";
+    readonly 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.";
     readonly models: readonly RankedModel[];
     readonly 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).";
-    readonly rankedAt: "2026-10-07";
+    readonly rankedAt: "2026-10-29";
     readonly rankedFrom: "hand";
     readonly summary: "Make variations of an image you already have.";
   };

package/dist/index.js

@@ -712,6 +712,7 @@ const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
 const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
+const FAL_PRICING_CHECKED_OCT_2026 = "2026-10-29";
 const MODELS = {
 	flare: {
 		benchmark: {
@@ -2068,6 +2069,7 @@ const MODELS = {
 			maxPixels: 4194304,
 			minPixels: 262144
 		},
+		editEndpoint: "alibaba/qwen-image-3/edit",
 		endpoint: "alibaba/qwen-image-3/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
@@ -2078,12 +2080,13 @@ const MODELS = {
 			unit: "images",
 			unitPrice: .04
 		},
+		maxReferenceImages: 3,
 		name: "Qwen Image 3",
 		pricePerImageUsd: .04,
 		pricing: "$0.04 (1K) / $0.075 (2K)",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsNegativePrompt: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -2286,6 +2289,120 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
+	"muse-image": {
+		benchmark: { useCase: "Low-cost generation and multi-reference editing; Arena #8 generation / #10 editing, 2026-10-29" },
+		editEndpoint: "meta/muse-image/edit",
+		endpoint: "meta/muse-image/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "meta/muse-image/text-to-image",
+			estimatedCostPerImageUsd: .01,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .01
+		},
+		maxReferenceImages: 10,
+		name: "Meta Muse Image",
+		pricePerImageUsd: .01,
+		pricing: "$0.01",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:5",
+			"5:4",
+			"21:9",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	krea3: {
+		benchmark: { useCase: "Reference editing with prompt planning. Motif sends fal's defaults (berry, medium reasoning), which Arena has not scored; Arena's 1411 editing score (2026-10-29) is for Ultra, available with --param reasoning_level=ultra" },
+		customImageSize: {
+			maxEdge: 3200,
+			maxPixels: 4220160,
+			minEdge: 256,
+			multipleOf: 16
+		},
+		editEndpoint: "krea/v3/edit",
+		endpoint: "krea/v3/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "krea/v3/text-to-image",
+			estimatedCostPerImageUsd: .025,
+			source: "fal-pricing-api",
+			unit: "megapixels",
+			unitPrice: .025
+		},
+		maxReferenceImages: 8,
+		name: "Krea 3",
+		pricePerImageUsd: .025,
+		pricing: "$0.025/MP (edits also bill each reference)",
+		sizeMode: "image_size_enum",
+		supportedOutputFormats: ["png", "jpeg"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNegativePrompt: true,
+		supportsNumImages: false,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSafetyChecker: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	"grok-image-quality": {
+		benchmark: { useCase: "Detailed generation and editing with stronger text rendering; Arena #11 editing, 2026-10-29" },
+		editEndpoint: "xai/grok-imagine-image/quality/edit",
+		endpoint: "xai/grok-imagine-image/quality/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "xai/grok-imagine-image/quality/text-to-image",
+			estimatedCostPerImageUsd: .05,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .05
+		},
+		maxReferenceImages: 3,
+		name: "Grok Imagine Image Quality",
+		pricePerImageUsd: .05,
+		pricing: "$0.05 (1K) / $0.07 (2K)",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
 	kling: {
 		endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
 		name: "Kling v3 Pro",
@@ -2364,7 +2481,10 @@ const GENERATION_MODELS = [
 	"qwen3",
 	"banana2-lite",
 	"grok-image-2",
+	"grok-image-quality",
 	"grok-image",
+	"muse-image",
+	"krea3",
 	"flux2-flex",
 	"flux2-pro",
 	"flux2-turbo",
@@ -2406,6 +2526,7 @@ function estimateCost(model, resolution, numImages = 1, editImages = 0) {
 	if (configuredPrice === null) return null;
 	if (model === "mai-image-2.5-pro" && editImages > 0) return .27 * numImages;
 	if (model === "grok-image-2" && editImages > 0) return (resolution === "2K" || resolution === "4K" ? .08 : .06) * numImages + .01 * editImages;
+	if (model === "grok-image-quality") return (resolution === "2K" || resolution === "4K" ? .07 : .05) * numImages + .01 * editImages;
 	if (configuredPrice !== void 0) {
 		if ((model === "banana" || model === "gemini3") && resolution === "4K") return configuredPrice * 2 * numImages;
 		if (model === "seedream5" && (resolution === "2K" || resolution === "4K")) return configuredPrice * 2 * numImages;
@@ -2761,7 +2882,7 @@ function buildGenerateBody(options) {
 			break;
 		case "aspect_ratio":
 			if (config.supportsAspect) body.aspect_ratio = aspect;
-			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" ? resolution.toLowerCase() : resolution;
+			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" || model === "grok-image-quality" ? resolution.toLowerCase() : resolution;
 	}
 	if (config.supportsQuality === true) body.quality = quality ?? config.defaultQuality ?? "high";
 	if (config.supportsBackground === true && background) body.background = background;
@@ -5191,7 +5312,7 @@ const TIERS = [
 ];
 const DEFAULT_TIER = "balanced";
 const HAND_RANKED_AT = "2026-09-16";
-const IMAGE_RANKED_AT = "2026-10-07";
+const IMAGE_RANKED_AT = "2026-10-29";
 /** Every Task with a Model. A Task is absent here until it has at least one Model. */
 const TASKS = {
 	animate: {
@@ -5362,7 +5483,7 @@ const TASKS = {
 		summary: "Remove an object, person, text or clutter from an image and fill the gap."
 	},
 	generate: {
-		basis: "Curated from Artificial Analysis v2, captured 2026-10-07, and Arena 2026-10-06. Sunburst and Flare lead quality at the benchmarked max setting. Nano Banana 2.1 leads balanced on preliminary Arena evidence and lower representative cost; Grok Image 2 and MAI 2.5 are established alternatives. 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.",
+		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",
@@ -5377,15 +5498,15 @@ const TASKS = {
 				tier: "quality"
 			},
 			{
-				model: "gpt",
+				model: "seedream5",
 				tier: "quality"
 			},
 			{
-				model: "mai-image-2.5-pro",
+				model: "gpt",
 				tier: "quality"
 			},
 			{
-				model: "seedream5",
+				model: "mai-image-2.5-pro",
 				tier: "quality"
 			},
 			{
@@ -5396,10 +5517,18 @@ const TASKS = {
 				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"
@@ -5409,23 +5538,27 @@ const TASKS = {
 				tier: "balanced"
 			},
 			{
-				model: "qwen3",
+				model: "ideogram4",
 				tier: "balanced"
 			},
 			{
 				model: "flux2-flex",
 				tier: "balanced"
 			},
+			{
+				model: "recraft41",
+				tier: "balanced"
+			},
 			{
 				model: "flux2-pro",
 				tier: "balanced"
 			},
 			{
-				model: "ideogram4",
+				model: "krea3",
 				tier: "balanced"
 			},
 			{
-				model: "recraft41",
+				model: "grok-image-quality",
 				tier: "balanced"
 			},
 			{
@@ -5937,7 +6070,7 @@ const TASKS = {
 		summary: "Trace a raster image to a clean SVG."
 	},
 	vary: {
-		basis: "Curated from Artificial Analysis v2 editing, captured 2026-10-07, and preliminary Arena 2026-10-06 evidence for Nano Banana 2.1. Editing order differs from generation: MAI 2.5 outranks Grok Image 2, and Seedream 5 Pro outranks GPT Image 1.5. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.",
+		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",
@@ -5952,17 +6085,21 @@ const TASKS = {
 				tier: "quality"
 			},
 			{
-				model: "mai-image-2.5-pro",
+				model: "seedream5",
 				tier: "quality"
 			},
 			{
-				model: "seedream5",
+				model: "gpt",
 				tier: "quality"
 			},
 			{
-				model: "gpt",
+				model: "mai-image-2.5-pro",
 				tier: "quality"
 			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
 			{
 				model: "banana21",
 				tier: "balanced"
@@ -5972,17 +6109,29 @@ const TASKS = {
 				tier: "balanced"
 			},
 			{
-				model: "grok-image-2",
+				model: "muse-image",
 				tier: "balanced"
 			},
 			{
-				model: "banana2",
+				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"
@@ -5996,11 +6145,11 @@ const TASKS = {
 				tier: "fast"
 			},
 			{
-				model: "seedream5-lite",
+				model: "banana2-lite",
 				tier: "fast"
 			},
 			{
-				model: "banana2-lite",
+				model: "seedream5-lite",
 				tier: "fast"
 			}
 		],
@@ -8576,6 +8725,8 @@ const FAL_IMAGE_PRICE_USD = {
 	"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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@howells/motif-sdk",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "description": "Node SDK for Motif: image, video and 3D Tasks on fal.ai, with Motif choosing the Model.",
   "keywords": [
     "fal",
@@ -52,7 +52,7 @@
   },
   "devDependencies": {
     "@howells/lint": "^3.5.1",
-    "@howells/typescript-config": "^0.1.6",
+    "@howells/typescript-config": "^0.1.8",
     "@types/node": "^26.6.2",
     "@vitest/coverage-v8": "^5.0.1",
     "tsdown": "^0.23.0",