@howells/motif-sdk 5.1.1 → 5.2.0

package/dist/index.cjs

@@ -707,7 +707,7 @@ function getOpenAiKeyFromEnv(input = process.env) {
 }
 //#endregion
 //#region src/models.ts
-const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-08-23";
+const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-10-07";
 const AA_IMAGE_SOURCES = ["https://artificialanalysis.ai/image/leaderboard/text-to-image", "https://artificialanalysis.ai/image/leaderboard/editing"];
 const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
@@ -715,6 +715,22 @@ const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
 const MODELS = {
 	flare: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1163,
+					rank: 2
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1191,
+					rank: 2
+				}
+			},
+			useCase: "Frontier generation and editing, evaluated at max quality"
+		},
+		defaultQuality: "max",
 		customImageSize: {
 			maxEdge: 3840,
 			maxPixels: 8294400,
@@ -751,6 +767,22 @@ const MODELS = {
 		useQueue: true
 	},
 	sunburst: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1183,
+					rank: 1
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1198,
+					rank: 1
+				}
+			},
+			useCase: "Frontier generation and editing, evaluated at max quality"
+		},
+		defaultQuality: "max",
 		customImageSize: {
 			maxEdge: 3840,
 			maxPixels: 8294400,
@@ -790,14 +822,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1256,
-					rank: 3
+					elo: 1125,
+					rank: 5
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1369,
-					rank: 1
+					elo: 1172,
+					rank: 3
 				}
 			},
 			speed: {
@@ -810,7 +842,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "very_slow"
 			},
-			useCase: "Highest-ranked text-to-image quality and transparent PNGs"
+			useCase: "Established frontier generation and transparent PNGs"
 		},
 		customImageSize: {
 			maxEdge: 3840,
@@ -861,14 +893,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1250,
-					rank: 5
+					elo: 1103,
+					rank: 12
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1310,
-					rank: 4
+					elo: 1107,
+					rank: 8
 				}
 			},
 			speed: {
@@ -881,7 +913,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "slow"
 			},
-			useCase: "Best OpenAI edit quality with transparent PNG support"
+			useCase: "Established OpenAI editor with transparent PNG support"
 		},
 		editEndpoint: "fal-ai/gpt-image-1.5/edit",
 		endpoint: "fal-ai/gpt-image-1.5",
@@ -914,18 +946,103 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
-	banana2: {
+	banana21: {
+		benchmark: { useCase: "Efficient generation and reference editing; Arena #5 generation / #6 editing, preliminary 2026-10-06" },
+		editEndpoint: "google/nano-banana-2.1/edit",
+		endpoint: "google/nano-banana-2.1",
+		maxReferenceImages: 14,
+		name: "Nano Banana 2.1",
+		pricePerImageUsd: null,
+		pricing: "Token-based: input $1.764/M, text/thinking output $8.823/M, image output $35.294/M; ~ $0.040 / $0.059 / $0.134 at 1K / 2K / 4K plus variable usage",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"21:9",
+			"16:9",
+			"3:2",
+			"4:3",
+			"5:4",
+			"1:1",
+			"4:5",
+			"3:4",
+			"2:3",
+			"9:16",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportedResolutions: [
+			"1K",
+			"2K",
+			"4K"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsLimitGenerations: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSafetyTolerance: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		supportsThinkingLevel: true,
+		supportsWebSearch: true,
+		type: "generation"
+	},
+	"mai-image-2.5": {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1249,
+					elo: 1114,
 					rank: 7
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1320,
-					rank: 3
+					elo: 1104,
+					rank: 10
+				}
+			},
+			useCase: "Strong single-reference editing at a lower price than MAI 2.5 Pro"
+		},
+		editEndpoint: "microsoft/mai-image-2.5/edit",
+		endpoint: "microsoft/mai-image-2.5",
+		maxReferenceImages: 1,
+		name: "MAI Image 2.5",
+		pricePerImageUsd: null,
+		pricing: "Token-based: text input $5/M, image input $8/M; ~$0.05 image output plus input",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	banana2: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1110,
+					rank: 9
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1126,
+					rank: 6
 				}
 			},
 			tiers: {
@@ -933,7 +1050,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "unknown"
 			},
-			useCase: "Best balance of quality, edit support, web search, and cost"
+			useCase: "Previous-generation Gemini workhorse; retains 0.5K output"
 		},
 		editEndpoint: "fal-ai/nano-banana-2/edit",
 		endpoint: "fal-ai/nano-banana-2",
@@ -969,14 +1086,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1245,
-					rank: 9
+					elo: 1101,
+					rank: 13
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1297,
-					rank: 6
+					elo: 1102,
+					rank: 11
 				}
 			},
 			speed: {
@@ -1041,11 +1158,15 @@ const MODELS = {
 	gemini: {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1180,
-				rank: 29
+				elo: 987,
+				rank: 50
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES
+			sourceUrls: AA_IMAGE_SOURCES,
+			textToImage: {
+				elo: 985,
+				rank: 60
+			}
 		} },
 		editEndpoint: "fal-ai/gemini-25-flash-image/edit",
 		endpoint: "fal-ai/gemini-25-flash-image",
@@ -1086,18 +1207,6 @@ const MODELS = {
 		type: "generation"
 	},
 	gemini3: {
-		benchmark: { artificialAnalysis: {
-			editing: {
-				elo: 1245,
-				rank: 9
-			},
-			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES,
-			textToImage: {
-				elo: 1297,
-				rank: 6
-			}
-		} },
 		editEndpoint: "fal-ai/gemini-3-pro-image-preview/edit",
 		endpoint: "fal-ai/gemini-3-pro-image-preview",
 		falPricing: {
@@ -1147,14 +1256,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1185,
-					rank: 28
+					elo: 1015,
+					rank: 36
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1226,
-					rank: 16
+					elo: 1030,
+					rank: 21
 				}
 			},
 			speed: {
@@ -1167,7 +1276,7 @@ const MODELS = {
 				quality: "best",
 				speed: "balanced"
 			},
-			useCase: "High-ranked budget generation and large multi-reference edits"
+			useCase: "Legacy budget generation and large multi-reference edits"
 		},
 		customImageSize: {
 			maxPixels: 16777216,
@@ -1201,14 +1310,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1186,
-					rank: 26
+					elo: 1037,
+					rank: 32
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1203,
-					rank: 32
+					elo: 1022,
+					rank: 26
 				}
 			},
 			speed: {
@@ -1254,14 +1363,14 @@ const MODELS = {
 	seedream5: {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1248,
-				rank: 8
+				elo: 1108,
+				rank: 11
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1279,
-				rank: 10
+				elo: 1081,
+				rank: 15
 			}
 		} },
 		customImageSize: {
@@ -1296,11 +1405,15 @@ const MODELS = {
 	"seedream5-lite": {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1169,
-				rank: 32
+				elo: 1057,
+				rank: 24
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES
+			sourceUrls: AA_IMAGE_SOURCES,
+			textToImage: {
+				elo: 1012,
+				rank: 36
+			}
 		} },
 		customImageSize: {
 			maxPixels: 16777216,
@@ -1334,14 +1447,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1201,
-					rank: 19
+					elo: 997,
+					rank: 49
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1225,
-					rank: 17
+					elo: 1020,
+					rank: 28
 				}
 			},
 			speed: {
@@ -1393,14 +1506,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1170,
-					rank: 31
+					elo: 1007,
+					rank: 41
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1207,
-					rank: 30
+					elo: 1004,
+					rank: 41
 				}
 			},
 			speed: {
@@ -1451,11 +1564,15 @@ const MODELS = {
 	"flux2-flex": {
 		benchmark: {
 			artificialAnalysis: {
+				editing: {
+					elo: 1007,
+					rank: 42
+				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1223,
-					rank: 18
+					elo: 1027,
+					rank: 22
 				}
 			},
 			speed: {
@@ -1509,8 +1626,16 @@ const MODELS = {
 	"flux2-dev": {
 		benchmark: {
 			artificialAnalysis: {
+				editing: {
+					elo: 1e3,
+					rank: 45
+				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1e3,
+					rank: 42
+				}
 			},
 			speed: {
 				medianSeconds: 4.6,
@@ -1673,24 +1798,12 @@ const MODELS = {
 	},
 	reve: {
 		benchmark: {
-			artificialAnalysis: {
-				editing: {
-					elo: 1263,
-					rank: 2
-				},
-				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES,
-				textToImage: {
-					elo: 1322,
-					rank: 2
-				}
-			},
 			tiers: {
 				price: "premium",
 				quality: "frontier",
 				speed: "unknown"
 			},
-			useCase: "Highest-ranked editor reachable on fal; strong prompt adherence and text rendering"
+			useCase: "Historical Reve route; not currently verified on fal"
 		},
 		editEndpoint: "fal-ai/reve/edit",
 		endpoint: "fal-ai/reve/text-to-image",
@@ -1731,8 +1844,8 @@ const MODELS = {
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1215,
-				rank: 25
+				elo: 984,
+				rank: 62
 			}
 		} },
 		customImageSize: {},
@@ -1790,8 +1903,8 @@ const MODELS = {
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1220,
-				rank: 19
+				elo: 1004,
+				rank: 40
 			}
 		} },
 		customImageSize: {
@@ -1829,14 +1942,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1214,
-					rank: 16
+					elo: 1073,
+					rank: 19
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1216,
-					rank: 23
+					elo: 1019,
+					rank: 30
 				}
 			},
 			speed: {
@@ -1889,7 +2002,11 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 890,
+					rank: 106
+				}
 			},
 			speed: {
 				medianSeconds: 23.3,
@@ -1931,14 +2048,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1218,
-					rank: 15
+					elo: 1056,
+					rank: 25
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1272,
-					rank: 11
+					elo: 1075,
+					rank: 16
 				}
 			},
 			tiers: {
@@ -1946,7 +2063,7 @@ const MODELS = {
 				quality: "better",
 				speed: "unknown"
 			},
-			useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
+			useCase: "Strong generation with negative-prompt and seed controls"
 		},
 		customImageSize: {
 			maxPixels: 4194304,
@@ -1980,17 +2097,17 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1272,
-					rank: 1
+					elo: 1110,
+					rank: 10
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1293,
-					rank: 7
+					elo: 1100,
+					rank: 12
 				}
 			},
-			useCase: "Highest-ranked image editor, single reference image"
+			useCase: "Strong single-reference editor; MAI 2.5 ranks higher on the current editing board"
 		},
 		editEndpoint: "microsoft/mai-image-2.5-pro/edit",
 		editImagesField: "image_url",
@@ -2029,20 +2146,26 @@ const MODELS = {
 	},
 	"banana2-lite": {
 		benchmark: { artificialAnalysis: {
+			editing: {
+				elo: 1046,
+				rank: 26
+			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1289,
-				rank: 8
+				elo: 1095,
+				rank: 13
 			}
 		} },
+		editEndpoint: "google/nano-banana-2-lite/edit",
+		maxReferenceImages: 14,
 		endpoint: "google/nano-banana-2-lite",
 		name: "Nano Banana 2 Lite",
-		pricing: "Token-based: text $0.3125/M input, $1.875/M output; image $0.3125/M input, $37.50/M output; fixed 1K output (~$0.048)",
-		pricePerImageUsd: .048,
+		pricing: "Token-based: text $0.3125/M input, $1.875/M output; image $0.3125/M input, $37.50/M output; fixed 1K output (~$0.042 image output, plus input/thinking)",
+		pricePerImageUsd: null,
 		sizeMode: "aspect_ratio",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsLimitGenerations: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -2115,6 +2238,21 @@ const MODELS = {
 		type: "generation"
 	},
 	"grok-image-2": {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1110,
+					rank: 8
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1156,
+					rank: 4
+				}
+			},
+			useCase: "Strong generation and editing with predictable per-image billing"
+		},
 		editEndpoint: "xai/grok-imagine-image/v2.0/edit",
 		endpoint: "xai/grok-imagine-image/v2.0/text-to-image",
 		falPricing: {
@@ -2212,38 +2350,44 @@ const MODELS = {
 		type: "utility"
 	}
 };
+/** Curated generation choices; predecessor routes are explicit-only. */
 const GENERATION_MODELS = [
-	"flare",
 	"sunburst",
+	"flare",
 	"gpt2",
 	"gpt",
+	"banana21",
 	"banana2",
 	"banana",
+	"mai-image-2.5",
+	"mai-image-2.5-pro",
+	"seedream5",
+	"qwen3",
+	"banana2-lite",
+	"grok-image-2",
+	"grok-image",
+	"flux2-flex",
+	"flux2-pro",
+	"flux2-turbo",
+	"seedream5-lite",
+	"ideogram4",
+	"ideogram3-transparent",
+	"recraft41"
+];
+/** Retained for old pins, explicit overrides and tuned Looks, never auto-selected. */
+const LEGACY_GENERATION_MODELS = [
 	"gemini",
 	"gemini3",
 	"seedream4",
 	"seedream45",
-	"seedream5",
-	"seedream5-lite",
 	"flux2-max",
-	"flux2-pro",
-	"flux2-flex",
 	"flux2-dev",
-	"flux2-turbo",
 	"flux",
 	"flux-fast",
 	"recraft",
 	"recraft4",
 	"ideogram",
-	"ideogram4",
-	"grok-image",
-	"grok-image-2",
-	"qwen",
-	"qwen3",
-	"mai-image-2.5-pro",
-	"banana2-lite",
-	"ideogram3-transparent",
-	"recraft41"
+	"qwen"
 ];
 GENERATION_MODELS.filter((id) => MODELS[id]?.supportsEdit === true);
 const UTILITY_MODELS = [
@@ -2620,7 +2764,7 @@ function buildGenerateBody(options) {
 			if (config.supportsAspect) body.aspect_ratio = aspect;
 			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" ? resolution.toLowerCase() : resolution;
 	}
-	if (config.supportsQuality === true) body.quality = quality ?? "high";
+	if (config.supportsQuality === true) body.quality = quality ?? config.defaultQuality ?? "high";
 	if (config.supportsBackground === true && background) body.background = background;
 	if (config.supportsBackground === true && transparent === true) body.background = "transparent";
 	if (transparent === true && config.supportsOutputFormat === true) body.output_format = "png";
@@ -5048,134 +5192,7 @@ const TIERS = [
 ];
 const DEFAULT_TIER = "balanced";
 const HAND_RANKED_AT = "2026-09-16";
-const GENERATION_MODELS_RANKED = [
-	{
-		model: "gpt2",
-		tier: "quality"
-	},
-	{
-		model: "banana2",
-		tier: "quality"
-	},
-	{
-		model: "gpt",
-		tier: "quality"
-	},
-	{
-		model: "sunburst",
-		tier: "quality"
-	},
-	{
-		model: "gemini3",
-		tier: "quality"
-	},
-	{
-		model: "mai-image-2.5-pro",
-		tier: "quality"
-	},
-	{
-		model: "seedream5",
-		tier: "quality"
-	},
-	{
-		model: "flux2-max",
-		tier: "quality"
-	},
-	{
-		model: "banana",
-		tier: "balanced"
-	},
-	{
-		model: "ideogram3-transparent",
-		requires: ["transparency"],
-		supports: ["transparency"],
-		tier: "balanced"
-	},
-	{
-		model: "flare",
-		tier: "balanced"
-	},
-	{
-		model: "banana2-lite",
-		tier: "balanced"
-	},
-	{
-		model: "qwen3",
-		tier: "balanced"
-	},
-	{
-		model: "seedream4",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-flex",
-		tier: "balanced"
-	},
-	{
-		model: "ideogram4",
-		tier: "balanced"
-	},
-	{
-		model: "grok-image",
-		tier: "balanced"
-	},
-	{
-		model: "recraft4",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-pro",
-		tier: "balanced"
-	},
-	{
-		model: "seedream45",
-		tier: "balanced"
-	},
-	{
-		model: "grok-image-2",
-		tier: "balanced"
-	},
-	{
-		model: "recraft41",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-turbo",
-		tier: "fast"
-	},
-	{
-		model: "flux2-dev",
-		tier: "fast"
-	},
-	{
-		model: "flux-fast",
-		tier: "fast"
-	},
-	{
-		model: "seedream5-lite",
-		tier: "fast"
-	},
-	{
-		model: "gemini",
-		tier: "fast"
-	},
-	{
-		model: "qwen",
-		tier: "fast"
-	},
-	{
-		model: "ideogram",
-		tier: "fast"
-	},
-	{
-		model: "recraft",
-		tier: "fast"
-	},
-	{
-		model: "flux",
-		tier: "fast"
-	}
-];
+const IMAGE_RANKED_AT = "2026-10-07";
 /** Every Task with a Model. A Task is absent here until it has at least one Model. */
 const TASKS = {
 	animate: {
@@ -5346,10 +5363,97 @@ const TASKS = {
 		summary: "Remove an object, person, text or clutter from an image and fill the gap."
 	},
 	generate: {
-		basis: "Hand-ranked. Tiers set by fal price per image (quality ≥ $0.07, balanced $0.02-$0.15 with edit quality, fast ≤ $0.04); order within a tier by Artificial Analysis text-to-image Elo, snapshot 2026-08-23, unranked models last. banana leads balanced because it is the house default the looks are tuned on. Ideogram V3 Transparent follows it but is chosen only for a transparent request, so transparency needs no OpenAI key at balanced; token-metered Nano Banana 2 Lite sits in balanced by its Elo.",
-		models: GENERATION_MODELS_RANKED,
+		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.",
+		models: [
+			{
+				model: "sunburst",
+				tier: "quality"
+			},
+			{
+				model: "flare",
+				tier: "quality"
+			},
+			{
+				model: "gpt2",
+				tier: "quality"
+			},
+			{
+				model: "gpt",
+				tier: "quality"
+			},
+			{
+				model: "mai-image-2.5-pro",
+				tier: "quality"
+			},
+			{
+				model: "seedream5",
+				tier: "quality"
+			},
+			{
+				model: "banana21",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
+			{
+				model: "banana2",
+				tier: "balanced"
+			},
+			{
+				model: "mai-image-2.5",
+				tier: "balanced"
+			},
+			{
+				model: "banana",
+				tier: "balanced"
+			},
+			{
+				model: "qwen3",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-flex",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-pro",
+				tier: "balanced"
+			},
+			{
+				model: "ideogram4",
+				tier: "balanced"
+			},
+			{
+				model: "recraft41",
+				tier: "balanced"
+			},
+			{
+				model: "ideogram3-transparent",
+				requires: ["transparency"],
+				supports: ["transparency"],
+				tier: "balanced"
+			},
+			{
+				model: "banana2-lite",
+				tier: "fast"
+			},
+			{
+				model: "grok-image",
+				tier: "fast"
+			},
+			{
+				model: "seedream5-lite",
+				tier: "fast"
+			},
+			{
+				model: "flux2-turbo",
+				tier: "fast"
+			}
+		],
 		notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).",
-		rankedAt: HAND_RANKED_AT,
+		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
 		summary: "Make an image from a prompt, or change an image you pass as a reference."
 	},
@@ -5834,10 +5938,75 @@ const TASKS = {
 		summary: "Trace a raster image to a clean SVG."
 	},
 	vary: {
-		basis: "The generate ranking, filtered to Models that can edit. vary reuses the Model of the image it varies while Motif still offers it.",
-		models: GENERATION_MODELS_RANKED.filter(({ model }) => MODELS[model]?.supportsEdit === true),
+		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.",
+		models: [
+			{
+				model: "sunburst",
+				tier: "quality"
+			},
+			{
+				model: "flare",
+				tier: "quality"
+			},
+			{
+				model: "gpt2",
+				tier: "quality"
+			},
+			{
+				model: "mai-image-2.5-pro",
+				tier: "quality"
+			},
+			{
+				model: "seedream5",
+				tier: "quality"
+			},
+			{
+				model: "gpt",
+				tier: "quality"
+			},
+			{
+				model: "banana21",
+				tier: "balanced"
+			},
+			{
+				model: "mai-image-2.5",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
+			{
+				model: "banana2",
+				tier: "balanced"
+			},
+			{
+				model: "banana",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-pro",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-flex",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image",
+				tier: "fast"
+			},
+			{
+				model: "seedream5-lite",
+				tier: "fast"
+			},
+			{
+				model: "banana2-lite",
+				tier: "fast"
+			}
+		],
 		notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).",
-		rankedAt: HAND_RANKED_AT,
+		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
 		summary: "Make variations of an image you already have."
 	}
@@ -8222,7 +8391,7 @@ function resolveFixed(task, fixed, request, needed, keys) {
 	const { chosenBy, model } = fixed;
 	const tier = request.tier ?? "balanced";
 	const entries = TASKS[task].models;
-	const entry = entries.find((candidate) => candidate.model === model && candidate.mode === request.mode);
+	const entry = entries.find((candidate) => candidate.model === model && candidate.mode === request.mode) ?? legacyEntry(task, model, request.mode, tier);
 	const profile = modelProfile(model);
 	if (entry === void 0 || profile === void 0) {
 		const servesTask = entries.some((candidate) => candidate.model === model);
@@ -8235,6 +8404,14 @@ function resolveFixed(task, fixed, request, needed, keys) {
 	unblockers.push(unblockerFor(result));
 	return unresolved(task, result.blockedBy, unblockers, `${model} (${chosenBy}) ${describeBlock(result.blockedBy, result.missingKey, result.missingInput)}.`, result.missingKey);
 }
+/** Old pins and tuned Looks remain usable without recommending predecessors. */
+function legacyEntry(task, model, mode, tier) {
+	if (mode !== void 0 || task !== "generate" && task !== "vary" || !LEGACY_GENERATION_MODELS.some((id) => id === model) || task === "vary" && MODELS[model]?.supportsEdit !== true) return;
+	return {
+		model,
+		tier
+	};
+}
 function unknownForMode(task, model, mode, entries) {
 	const otherModes = entries.filter((candidate) => candidate.model === model).map((candidate) => candidate.mode ?? "no mode");
 	const inMode = [...new Set(entries.filter((candidate) => candidate.mode === mode).map((candidate) => candidate.model))];
@@ -8251,7 +8428,7 @@ function resolveRanked(task, request, needed, keys) {
 	const qualifying = /* @__PURE__ */ new Map();
 	let firstBlock;
 	let keyBlock;
-	const definition = TASKS[task];
+	const definition = task === "generate" && (request.references ?? 0) > 0 ? TASKS.vary : TASKS[task];
 	for (const entry of definition.models) {
 		if (entry.mode !== request.mode) continue;
 		const { model, tier: modelTier } = entry;