makefx 1.0.7 → 1.1.0

package/README.md

@@ -176,4 +176,4 @@ Run `makefx --help` or `makefx help <command>` for command-specific options.
 - Media generation guide: https://makefx.app/docs/media-playbooks
 - Source: https://github.com/krasnoperov/inventory
 
-Version: 1.0.7
+Version: 1.1.0

package/makefx.mjs

@@ -844,7 +844,7 @@ function validateProjectConfig(config, configPath) {
 *   makefx spaces inspect-deleted <space_id>  Inspect a soft-deleted space
 *   makefx spaces restore <space_id> Restore a soft-deleted space
 */
-var defaultDeps$10 = {
+var defaultDeps$11 = {
 	loadConfig: loadStoredConfig,
 	resolveBaseUrl,
 	saveProjectConfig,
@@ -859,7 +859,7 @@ async function handleSpaces(parsed) {
 		process$1.exitCode = 1;
 	}
 }
-async function executeSpaces(parsed, deps = defaultDeps$10) {
+async function executeSpaces(parsed, deps = defaultDeps$11) {
 	const env = resolveCommandEnvironment(parsed);
 	const showDetails = parsed.options.details === "true";
 	const spaceId = parsed.options.id;
@@ -5386,7 +5386,7 @@ function isMirrorEntry(value) {
 *   makefx upload <file> --space <id> --name <name>    Upload as new asset
 *   makefx upload <file> --space <id> --name <name> --type <type>
 */
-var defaultDeps$9 = {
+var defaultDeps$10 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -5415,11 +5415,11 @@ async function handleUpload(parsed) {
 		await executeUpload(parsed);
 	} catch (error) {
 		console.error(error instanceof Error ? `Error: ${error.message}` : "Error: Upload failed");
-		if (error instanceof UploadUsageError) printUsage$9();
+		if (error instanceof UploadUsageError) printUsage$10();
 		process$1.exitCode = 1;
 	}
 }
-async function executeUpload(parsed, deps = defaultDeps$9) {
+async function executeUpload(parsed, deps = defaultDeps$10) {
 	const filePath = parsed.positionals[0];
 	if (!filePath) throw new UploadUsageError("File path is required");
 	rejectRetiredUploadOrganizationOptions(parsed);
@@ -5599,7 +5599,7 @@ function parseCsvOption(value, optionName) {
 	if (value === "true") throw new UploadUsageError(`${optionName} requires a value`);
 	return value.split(",").map((entry) => entry.trim()).filter(Boolean);
 }
-function printUsage$9() {
+function printUsage$10() {
 	console.log(`
 Usage:
   makefx upload <file> --asset <id> [--space <id>]     Upload media to existing asset
@@ -6508,6 +6508,7 @@ var WebSocketClient = class WebSocketClient {
 				prompt: params.prompt,
 				count: params.count,
 				model: params.model,
+				aspectRatio: params.aspectRatio,
 				imageSize: params.imageSize,
 				musicProvider: params.musicProvider,
 				generateAudio: params.generateAudio,
@@ -6831,6 +6832,7 @@ var VIDEO_GENERATION_RESOLUTIONS = [
 	"1080p",
 	"4k"
 ];
+var KLING_VIDEO_GENERATION_RESOLUTIONS = ["720p", "1080p"];
 var VIDEO_GENERATION_DURATION_SECONDS = [
 	4,
 	6,
@@ -6841,7 +6843,32 @@ var VIDEO_GENERATION_TIERS = [
 	"fast",
 	"lite"
 ];
-var VIDEO_MODEL_SELECTIONS = ["veo-3.1", "omni-flash"];
+var VIDEO_MODEL_SELECTIONS = [
+	"veo-3.1",
+	"omni-flash",
+	"kling",
+	"fal-seedance"
+];
+var VIDEO_MODEL_SUPPORTED_OPERATIONS = {
+	"veo-3.1": [
+		"generate",
+		"refine",
+		"derive"
+	],
+	"omni-flash": [
+		"generate",
+		"refine",
+		"derive"
+	],
+	kling: [
+		"generate",
+		"refine",
+		"derive"
+	],
+	"fal-seedance": ["generate"]
+};
+var KLING_VIDEO_MODEL = "kling-v3";
+var FAL_VIDEO_MODEL = "fal-ai/bytedance/seedance/v1/pro/text-to-video";
 var GEMINI_OMNI_FLASH_VIDEO_MODEL = "gemini-omni-flash-preview";
 var VIDEO_GENERATION_AUDIO_TOGGLE_MODELS = [];
 var VIDEO_GENERATION_RESOLUTIONS_BY_TIER = {
@@ -6876,7 +6903,10 @@ function getVideoGenerationModelForTier(tier = DEFAULT_VIDEO_GENERATION_TIER) {
 	return VIDEO_GENERATION_TIER_MODELS[tier];
 }
 function getVideoGenerationModelForSelection(selection = DEFAULT_VIDEO_MODEL_SELECTION, tier = DEFAULT_VIDEO_GENERATION_TIER) {
-	return selection === "omni-flash" ? GEMINI_OMNI_FLASH_VIDEO_MODEL : getVideoGenerationModelForTier(tier);
+	if (selection === "omni-flash") return GEMINI_OMNI_FLASH_VIDEO_MODEL;
+	if (selection === "kling") return KLING_VIDEO_MODEL;
+	if (selection === "fal-seedance") return FAL_VIDEO_MODEL;
+	return getVideoGenerationModelForTier(tier);
 }
 function getVideoGenerationResolutionsForTier(tier = DEFAULT_VIDEO_GENERATION_TIER) {
 	return VIDEO_GENERATION_RESOLUTIONS_BY_TIER[tier];
@@ -6884,28 +6914,55 @@ function getVideoGenerationResolutionsForTier(tier = DEFAULT_VIDEO_GENERATION_TI
 function isVideoGenerationResolutionSupportedForTier(resolution, tier = DEFAULT_VIDEO_GENERATION_TIER) {
 	return VIDEO_GENERATION_RESOLUTIONS_BY_TIER[tier].includes(resolution);
 }
+function getVideoGenerationResolutionsForModel(model) {
+	return isKlingVideoGenerationModel(model) || isFalVideoGenerationModel(model) ? KLING_VIDEO_GENERATION_RESOLUTIONS : getVideoGenerationResolutionsForTier(getVideoGenerationTierForModel(model));
+}
+function isVideoGenerationResolutionSupportedForModel(model, resolution) {
+	return getVideoGenerationResolutionsForModel(model).includes(resolution);
+}
 function getVideoGenerationTierForModel(model) {
 	if (typeof model !== "string") return void 0;
 	return VIDEO_GENERATION_TIERS.find((tier) => VIDEO_GENERATION_TIER_MODELS[tier] === model);
 }
+function getVideoModelSelectionForModel(model) {
+	if (model === "gemini-omni-flash-preview") return "omni-flash";
+	if (model === "kling-v3") return "kling";
+	if (model === "fal-ai/bytedance/seedance/v1/pro/text-to-video") return "fal-seedance";
+	return getVideoGenerationTierForModel(model) ? "veo-3.1" : void 0;
+}
 function isVeoVideoGenerationModel(model) {
 	return typeof model === "string" && getVideoGenerationTierForModel(model) !== void 0;
 }
 function isGeminiOmniVideoGenerationModel(model) {
 	return model === GEMINI_OMNI_FLASH_VIDEO_MODEL;
 }
+function isKlingVideoGenerationModel(model) {
+	return model === KLING_VIDEO_MODEL;
+}
+function isFalVideoGenerationModel(model) {
+	return model === FAL_VIDEO_MODEL;
+}
 function isVideoGenerationModel(model) {
-	return isVeoVideoGenerationModel(model) || isGeminiOmniVideoGenerationModel(model);
+	return isVeoVideoGenerationModel(model) || isGeminiOmniVideoGenerationModel(model) || isKlingVideoGenerationModel(model) || isFalVideoGenerationModel(model);
+}
+function isVideoOperationSupportedByModel(model, operation) {
+	const selection = getVideoModelSelectionForModel(model);
+	return selection !== void 0 && VIDEO_MODEL_SUPPORTED_OPERATIONS[selection].includes(operation);
 }
 function doesVideoGenerationModelSupportAudioToggle(model) {
-	return isVeoVideoGenerationModel(model) && VIDEO_GENERATION_AUDIO_TOGGLE_MODELS.includes(model);
+	return isKlingVideoGenerationModel(model) || isVeoVideoGenerationModel(model) && VIDEO_GENERATION_AUDIO_TOGGLE_MODELS.includes(model);
 }
 //#endregion
 //#region src/shared/imageGenerationOptions.ts
-var IMAGE_MODEL_SELECTIONS = ["pro", "flash"];
+var IMAGE_MODEL_SELECTIONS = [
+	"pro",
+	"flash",
+	"flux"
+];
 var IMAGE_MODEL_IDS = {
 	pro: "gemini-3-pro-image",
-	flash: "gemini-3.1-flash-image"
+	flash: "gemini-3.1-flash-image",
+	flux: "fal-ai/flux/dev"
 };
 IMAGE_MODEL_IDS["pro"];
 var IMAGE_ASPECT_RATIOS = [
@@ -6929,6 +6986,13 @@ var IMAGE_MODEL_CAPABILITIES = {
 	pro: {
 		selection: "pro",
 		modelId: IMAGE_MODEL_IDS.pro,
+		label: "Pro",
+		provider: "gemini",
+		supportedOperations: [
+			"generate",
+			"derive",
+			"refine"
+		],
 		maxReferenceImages: 14,
 		supportedImageSizes: [
 			"1K",
@@ -6940,6 +7004,13 @@ var IMAGE_MODEL_CAPABILITIES = {
 	flash: {
 		selection: "flash",
 		modelId: IMAGE_MODEL_IDS.flash,
+		label: "Flash",
+		provider: "gemini",
+		supportedOperations: [
+			"generate",
+			"derive",
+			"refine"
+		],
 		maxReferenceImages: 14,
 		supportedImageSizes: [
 			"1K",
@@ -6947,6 +7018,16 @@ var IMAGE_MODEL_CAPABILITIES = {
 			"4K"
 		],
 		supportedAspectRatios: IMAGE_ASPECT_RATIOS
+	},
+	flux: {
+		selection: "flux",
+		modelId: IMAGE_MODEL_IDS.flux,
+		label: "FLUX.1 Dev",
+		provider: "fal",
+		supportedOperations: ["generate"],
+		maxReferenceImages: 0,
+		supportedImageSizes: ["1K"],
+		supportedAspectRatios: IMAGE_ASPECT_RATIOS
 	}
 };
 function isImageModelSelection(value) {
@@ -6964,7 +7045,9 @@ function normalizeImageSize(value) {
 }
 function getImageModelSelection(value) {
 	if (isImageModelSelection(value)) return value;
-	return value === IMAGE_MODEL_IDS.flash ? "flash" : "pro";
+	if (value === IMAGE_MODEL_IDS.flash) return "flash";
+	if (value === IMAGE_MODEL_IDS.flux) return "flux";
+	return "pro";
 }
 function getImageModelCapabilities(model) {
 	return IMAGE_MODEL_CAPABILITIES[getImageModelSelection(model ?? "pro")];
@@ -6978,6 +7061,9 @@ function isImageAspectRatioSupportedByModel(model, aspectRatio) {
 function getImageModelMaxReferenceImages(model) {
 	return getImageModelCapabilities(model).maxReferenceImages;
 }
+function isImageOperationSupportedByModel(model, operation) {
+	return getImageModelCapabilities(model).supportedOperations.includes(operation);
+}
 //#endregion
 //#region src/shared/mediaOperationMatrix.ts
 var MEDIA_OPERATION_MATRIX = [
@@ -7139,7 +7225,7 @@ function cliGenerationSupportsRefs(namespace) {
 //#endregion
 //#region src/cli/commands/forge.ts
 var CLI_GENERATION_MEDIA_KIND = getCliGenerationMediaKind("top-level");
-var defaultDeps$8 = {
+var defaultDeps$9 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -7213,10 +7299,10 @@ async function handleBatch(parsed) {
 }
 async function handleForgeCommand(command, parsed) {
 	try {
-		await executeForgeCommand(command, parsed, defaultDeps$8);
+		await executeForgeCommand(command, parsed, defaultDeps$9);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		if (shouldPrintUsageForForgeError(error)) printUsage$8(command);
+		if (shouldPrintUsageForForgeError(error)) printUsage$9(command);
 		process$1.exitCode = 1;
 	}
 }
@@ -7225,11 +7311,11 @@ function shouldPrintUsageForForgeError(error) {
 	const message = error.message;
 	return message.startsWith("--") || message.startsWith("Output path is required") || message.startsWith("Output directory is required") || message.startsWith("Pass either prompt text") || message.startsWith("Speech generation requires") || message.startsWith("Dialogue generation requires") || message.startsWith("Prompt is required");
 }
-async function executeForgeCommand(command, parsed, deps = defaultDeps$8, options = {}) {
+async function executeForgeCommand(command, parsed, deps = defaultDeps$9, options = {}) {
 	const mediaKind = options.mediaKind || CLI_GENERATION_MEDIA_KIND;
 	if (parsed.options.follow) {
 		if (command === "batch") throw new Error("--follow is only supported for single-output generation commands");
-		const ctx = await buildContext$5(parsed, deps);
+		const ctx = await buildContext$6(parsed, deps);
 		const client = await deps.createClient(ctx.env, ctx.spaceId);
 		try {
 			await client.connect();
@@ -7239,11 +7325,13 @@ async function executeForgeCommand(command, parsed, deps = defaultDeps$8, option
 		}
 	}
 	const saveBatchManifest = options.saveBatchManifest ?? mediaKind === "image";
-	validateImageCommandReferenceCount(command, parsed, mediaKind, parseImageGenerationOptions(parsed, mediaKind).model);
+	const imageOptions = parseImageGenerationOptions(parsed, mediaKind);
+	validateImageModelOperation(command, mediaKind, imageOptions.model);
+	validateImageCommandReferenceCount(command, parsed, mediaKind, imageOptions.model);
 	validateVideoAudioOptions(parsed, mediaKind);
-	parseVideoGenerationOptions(parsed, mediaKind);
+	validateVideoModelOperation(command, mediaKind, parseVideoGenerationOptions(parsed, mediaKind).model);
 	validateVideoFrameReferenceOptions(command, parsed, mediaKind);
-	const ctx = await buildContext$5(parsed, deps);
+	const ctx = await buildContext$6(parsed, deps);
 	const client = await deps.createClient(ctx.env, ctx.spaceId);
 	try {
 		await client.connect();
@@ -7257,7 +7345,7 @@ async function executeForgeCommand(command, parsed, deps = defaultDeps$8, option
 		client.disconnect();
 	}
 }
-async function executeAudioCommand(command, parsed, deps = defaultDeps$8, options = {}) {
+async function executeAudioCommand(command, parsed, deps = defaultDeps$9, options = {}) {
 	const audioProfile = getCliGenerationProfile("audio");
 	if (!audioProfile.commands.includes(command)) throw new Error(`Audio generation does not support ${command}`);
 	const modeEntry = options.mode ? getMediaOperationEntry(options.mode) : void 0;
@@ -7270,7 +7358,7 @@ async function executeAudioCommand(command, parsed, deps = defaultDeps$8, option
 		audioMode: options.mode
 	});
 }
-async function executeVideoCommand(command, parsed, deps = defaultDeps$8) {
+async function executeVideoCommand(command, parsed, deps = defaultDeps$9) {
 	const videoProfile = getCliGenerationProfile("video");
 	if (!videoProfile.commands.includes(command)) throw new Error(`Video generation does not support ${command}`);
 	return executeForgeCommand(command, parsed, deps, {
@@ -7315,6 +7403,9 @@ async function executeGenerate(parsed, ctx, client, deps, mediaKind, followOptio
 	const audioModelOptions = parseAudioGenerationOptions(parsed, mediaKind);
 	const videoAudioOptions = parseVideoAudioOptions(parsed, mediaKind);
 	const videoOptions = parseVideoGenerationOptions(parsed, mediaKind);
+	const effectiveVideoModel = videoOptions.model ?? getVideoGenerationModelForSelection();
+	if (mediaKind === "video" && isKlingVideoGenerationModel(effectiveVideoModel) && videoFrameRefs.length > 1) throw new Error("--model kling supports at most one image reference");
+	if (mediaKind === "video" && isFalVideoGenerationModel(effectiveVideoModel) && videoFrameRefs.length > 0) throw new Error(`--model ${getVideoModelSelectionForModel(effectiveVideoModel) ?? effectiveVideoModel} does not support image references`);
 	const collectionPlacement = parseCollectionPlacementOptions(parsed);
 	const followCommandOptions = {
 		...followOptions,
@@ -7327,6 +7418,7 @@ async function executeGenerate(parsed, ctx, client, deps, mediaKind, followOptio
 		prompt,
 		count: 1,
 		model: imageOptions.model ?? audioModelOptions.model ?? videoOptions.model,
+		aspectRatio: imageOptions.aspectRatio ?? videoOptions.aspectRatio,
 		imageSize: imageOptions.imageSize,
 		...musicProvider ? { musicProvider } : {},
 		...videoAudioOptions,
@@ -7425,6 +7517,7 @@ async function executeRefine(parsed, ctx, client, deps, mediaKind) {
 		prompt,
 		count: 1,
 		model: imageOptions.model ?? videoOptions.model,
+		aspectRatio: imageOptions.aspectRatio ?? videoOptions.aspectRatio,
 		imageSize: imageOptions.imageSize,
 		...videoAudioOptions,
 		...videoOptions
@@ -7491,6 +7584,9 @@ async function executeDerive(parsed, ctx, client, deps, mediaKind, followOptions
 	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
 	const videoAudioOptions = parseVideoAudioOptions(parsed, mediaKind);
 	const videoOptions = parseVideoGenerationOptions(parsed, mediaKind);
+	const effectiveVideoModel = videoOptions.model ?? getVideoGenerationModelForSelection();
+	if (mediaKind === "video" && isKlingVideoGenerationModel(effectiveVideoModel) && referenceRefs.length > 1) throw new Error("--model kling supports at most one image reference");
+	if (mediaKind === "video" && isFalVideoGenerationModel(effectiveVideoModel) && referenceRefs.length > 0) throw new Error(`--model ${getVideoModelSelectionForModel(effectiveVideoModel) ?? effectiveVideoModel} does not support ${referenceRefs.length} image references`);
 	const collectionPlacement = parseCollectionPlacementOptions(parsed);
 	const followCommandOptions = {
 		...followOptions,
@@ -7503,6 +7599,7 @@ async function executeDerive(parsed, ctx, client, deps, mediaKind, followOptions
 		prompt,
 		count: 1,
 		model: imageOptions.model ?? videoOptions.model,
+		aspectRatio: imageOptions.aspectRatio ?? videoOptions.aspectRatio,
 		imageSize: imageOptions.imageSize,
 		...videoAudioOptions,
 		...videoOptions
@@ -7726,6 +7823,7 @@ async function executeBatch(parsed, ctx, client, deps, mediaKind, saveBatchManif
 		prompt,
 		count,
 		model: imageOptions.model ?? audioModelOptions.model,
+		aspectRatio: imageOptions.aspectRatio,
 		imageSize: imageOptions.imageSize,
 		...musicProvider ? { musicProvider } : {}
 	});
@@ -7905,7 +8003,7 @@ async function createCollectionAssetItem(input) {
 		throw new Error(`Failed to place asset ${input.assetId} in collection ${input.collectionId} (${response.status}): ${errorText || response.statusText}`);
 	}
 }
-async function buildContext$5(parsed, deps) {
+async function buildContext$6(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -8190,7 +8288,7 @@ function validateVideoAudioOptions(parsed, mediaKind) {
 	const videoTier = tierValue === void 0 ? DEFAULT_VIDEO_GENERATION_TIER : normalizeVideoGenerationTier(tierValue);
 	if (!videoTier) throw new Error("--tier must be generate, fast, or lite");
 	const model = parseVideoModelOption(modelValue, videoTier);
-	if (parsed.options.audio !== void 0 && isGeminiOmniVideoGenerationModel(model)) throw new Error("--audio is only supported with --model veo-3.1");
+	if (parsed.options.audio !== void 0 && (isGeminiOmniVideoGenerationModel(model) || isFalVideoGenerationModel(model))) throw new Error("--audio is only supported with --model veo-3.1 or kling");
 	if (parsed.options["no-audio"] !== void 0 || parsed.options.noAudio !== void 0) {
 		if (!doesVideoGenerationModelSupportAudioToggle(model)) throw new Error(`${model} does not support --no-audio. Use the default audio-enabled output or omit the flag.`);
 	}
@@ -8218,7 +8316,9 @@ function parseVideoGenerationOptions(parsed, mediaKind) {
 	if (tierValue !== void 0 && !videoTier) throw new Error("--tier must be generate, fast, or lite");
 	const model = parseVideoModelOption(modelValue, videoTier);
 	if (isGeminiOmniVideoGenerationModel(model) && (resolutionValue !== void 0 || durationValue !== void 0 || tierValue !== void 0)) throw new Error("--resolution, --duration, and --tier are only supported with --model veo-3.1");
+	if ((isKlingVideoGenerationModel(model) || isFalVideoGenerationModel(model)) && tierValue !== void 0) throw new Error("--tier is only supported with --model veo-3.1");
 	if (videoResolution && videoTier && !isVideoGenerationResolutionSupportedForTier(videoResolution, videoTier)) throw new Error("--resolution 4k is not supported with --tier lite");
+	if (videoResolution && (isKlingVideoGenerationModel(model) || isFalVideoGenerationModel(model)) && !isVideoGenerationResolutionSupportedForModel(model, videoResolution)) throw new Error(`--model ${getVideoModelSelectionForModel(model) ?? model} supports only --resolution 720p or 1080p`);
 	const aspectRatio = aspectValue === void 0 ? void 0 : normalizeVideoGenerationAspectRatio(aspectValue);
 	if (aspectValue !== void 0 && !aspectRatio) throw new Error("--aspect must be 16:9 or 9:16");
 	return {
@@ -8245,7 +8345,8 @@ function validateVideoFrameReferenceOptions(command, parsed, mediaKind) {
 	if (parsed.options.refs) throw new Error("--first-frame and --last-frame cannot be combined with --refs");
 	const tierValue = readOptionalOption(parsed, "tier", "tier") ?? readOptionalOption(parsed, "video-tier", "videoTier");
 	const videoTier = tierValue === void 0 ? void 0 : normalizeVideoGenerationTier(tierValue);
-	if (isGeminiOmniVideoGenerationModel(parseVideoModelOption(readOptionalOption(parsed, "model", "model"), videoTier))) throw new Error("--first-frame and --last-frame are only supported with --model veo-3.1");
+	const model = parseVideoModelOption(readOptionalOption(parsed, "model", "model"), videoTier);
+	if (isFalVideoGenerationModel(model) || isGeminiOmniVideoGenerationModel(model) || isKlingVideoGenerationModel(model) && Boolean(lastFrame)) throw new Error("--first-frame and --last-frame are only supported with --model veo-3.1");
 }
 function readVideoFrameOption(parsed, kebabName, camelName) {
 	const value = parsed.options[kebabName] ?? parsed.options[camelName];
@@ -8299,17 +8400,18 @@ function parseVideoModelOption(value, tier) {
 	if (selection) return getVideoGenerationModelForSelection(selection, effectiveTier);
 	if (isVideoGenerationModel(normalized)) {
 		const modelTier = normalizeVideoGenerationTier(tier) ?? void 0;
-		if (modelTier && getVideoGenerationModelForTier(modelTier) !== normalized && !isGeminiOmniVideoGenerationModel(normalized)) throw new Error("--model and --tier select different Veo models");
+		if (modelTier && getVideoGenerationModelForTier(modelTier) !== normalized && !isGeminiOmniVideoGenerationModel(normalized) && !isKlingVideoGenerationModel(normalized) && !isFalVideoGenerationModel(normalized)) throw new Error("--model and --tier select different Veo models");
 		return normalized;
 	}
-	throw new Error("--model must be veo-3.1, omni-flash, or an exact video model ID");
+	throw new Error("--model must be veo-3.1, omni-flash, kling, or an exact video model ID");
 }
 function parseImageModelOption(value) {
 	if (!value) return void 0;
 	if (isImageModelSelection(value)) return value;
 	if (value === IMAGE_MODEL_IDS.pro) return "pro";
 	if (value === IMAGE_MODEL_IDS.flash) return "flash";
-	throw new Error("--model must be pro or flash");
+	if (value === IMAGE_MODEL_IDS.flux) return "flux";
+	throw new Error("--model must be pro, flash, or flux");
 }
 function parseImageSizeOption(value) {
 	if (!value) return void 0;
@@ -8332,9 +8434,23 @@ function validateImageReferenceCount(model, referenceCount) {
 }
 function validateImageCommandReferenceCount(command, parsed, mediaKind, model) {
 	if (mediaKind !== "image") return;
-	if (command !== "derive" && command !== "batch") return;
-	if (!parsed.options.refs) return;
-	validateImageReferenceCount(model, parseRefs(parsed.options.refs).length);
+	if (command === "refine") {
+		validateImageReferenceCount(model, 1);
+		return;
+	}
+	if ((command === "derive" || command === "batch") && parsed.options.refs) validateImageReferenceCount(model, parseRefs(parsed.options.refs).length);
+}
+function validateImageModelOperation(command, mediaKind, model) {
+	if (mediaKind !== "image") return;
+	const operation = command === "batch" ? "generate" : command;
+	if (isImageOperationSupportedByModel(model, operation)) return;
+	throw new Error(`--model ${model ?? "pro"} does not support ${operation}`);
+}
+function validateVideoModelOperation(command, mediaKind, model) {
+	if (mediaKind !== "video" || command === "batch") return;
+	const effectiveModel = model ?? getVideoGenerationModelForSelection();
+	if (isVideoOperationSupportedByModel(effectiveModel, command)) return;
+	throw new Error(`--model ${getVideoModelSelectionForModel(effectiveModel) ?? effectiveModel} does not support video ${command}`);
 }
 function readOptionalOption(parsed, kebabName, camelName) {
 	const value = parsed.options[kebabName] ?? parsed.options[camelName];
@@ -8378,11 +8494,15 @@ function cliImageSizeValues() {
 function cliImageAspectValues() {
 	return cliOptionValues(getImageModelCapabilities().supportedAspectRatios);
 }
-function printUsage$8(command) {
+function cliImageModelValues(command) {
+	const operation = command === "batch" ? "generate" : command;
+	return cliOptionValues(IMAGE_MODEL_SELECTIONS.filter((model) => isImageOperationSupportedByModel(model, operation)));
+}
+function printUsage$9(command) {
 	if (command === "generate") {
 		console.log(`
 Usage:
-  makefx generate "prompt" --name <name> --type <type> -o <file> [--model pro|flash] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
+  makefx generate "prompt" --name <name> --type <type> -o <file> [--model ${cliImageModelValues(command)}] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
   makefx generate --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 `);
 		return;
@@ -8390,7 +8510,7 @@ Usage:
 	if (command === "refine") {
 		console.log(`
 Usage:
-  makefx refine --variant <variant_id> "prompt" -o <file> [--model pro|flash] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
+  makefx refine --variant <variant_id> "prompt" -o <file> [--model ${cliImageModelValues(command)}] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
   makefx refine --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 `);
 		return;
@@ -8398,13 +8518,13 @@ Usage:
 	if (command === "batch") {
 		console.log(`
 Usage:
-  makefx batch "prompt" --name <name> --type <type> --count <2-8> --output-dir <dir> [--model pro|flash] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>]
+  makefx batch "prompt" --name <name> --type <type> --count <2-8> --output-dir <dir> [--model ${cliImageModelValues(command)}] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>]
 `);
 		return;
 	}
 	console.log(`
 Usage:
-  makefx derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model pro|flash] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
+  makefx derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${cliImageModelValues(command)}] [--size ${cliImageSizeValues()}] [--aspect ${cliImageAspectValues()}] [--collection <id>] [--space <id>]
   makefx derive --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 `);
 }
@@ -8419,7 +8539,7 @@ function printBatchResult(result, outputDir, manifestPath, ctx, mediaKind) {
 }
 //#endregion
 //#region src/cli/commands/audio.ts
-var defaultDeps$7 = {
+var defaultDeps$8 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -8432,11 +8552,11 @@ async function handleAudio(parsed) {
 		await executeAudio(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$7();
+		printUsage$8();
 		process$1.exitCode = 1;
 	}
 }
-async function executeAudio(parsed, deps = defaultDeps$7) {
+async function executeAudio(parsed, deps = defaultDeps$8) {
 	const invocation = parseAudioInvocation(parsed.positionals);
 	if (invocation.command === "voices") return executeAudioVoices({
 		...parsed,
@@ -8509,7 +8629,7 @@ function printVoices(response, print) {
 function formatLabels(labels) {
 	return Object.entries(labels).map(([key, value]) => `${key}:${value}`).join(", ");
 }
-function printUsage$7() {
+function printUsage$8() {
 	const modes = AUDIO_FORGE_MEDIA_MODES.join("|");
 	console.log(`
 Usage:
@@ -8538,7 +8658,7 @@ async function handleVideo(parsed) {
 		});
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$6();
+		printUsage$7();
 		process$1.exitCode = 1;
 	}
 }
@@ -8547,28 +8667,28 @@ function parseVideoCommand(value) {
 	if (value && commands.includes(value)) return value;
 	throw new Error("Video command is required: generate, refine, or derive");
 }
-function printUsage$6() {
+function printUsage$7() {
 	const aspectValues = VIDEO_GENERATION_ASPECT_RATIOS.join("|");
 	const resolutionValues = Array.from(new Set(VIDEO_GENERATION_TIERS.flatMap((tier) => getVideoGenerationResolutionsForTier(tier)))).join("|");
 	const durationValues = VIDEO_GENERATION_DURATION_SECONDS.join("|");
 	const tierValues = VIDEO_GENERATION_TIERS.join("|");
-	const modelValues = VIDEO_MODEL_SELECTIONS.join("|");
+	const modelValues = (operation) => VIDEO_MODEL_SELECTIONS.filter((model) => VIDEO_MODEL_SUPPORTED_OPERATIONS[model].includes(operation)).join("|");
 	const resolutionByTier = VIDEO_GENERATION_TIERS.map((tier) => `${tier}: ${getVideoGenerationResolutionsForTier(tier).join(", ")}`).join("; ");
 	console.log(`
 Usage:
-  makefx video generate "prompt" --name <name> --type <type> -o <file> [--model ${modelValues}] [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
+  makefx video generate "prompt" --name <name> --type <type> -o <file> [--model ${modelValues("generate")}] [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
   makefx video generate --follow <variant_id> -o <file> [--space <id>]
-  makefx video refine --variant <variant_id> "prompt" -o <file> [--model ${modelValues}] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
+  makefx video refine --variant <variant_id> "prompt" -o <file> [--model ${modelValues("refine")}] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
   makefx video refine --follow <variant_id> -o <file> [--space <id>]
-  makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${modelValues}] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
+  makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${modelValues("derive")}] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
   makefx video derive --first-frame <variant_or_file> [--last-frame <variant_or_file>] --name <name> --type <type> "prompt" -o <file> [--model veo-3.1] [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
   makefx video derive --follow <variant_id> -o <file> [--space <id>]
 
 Video:
-  --model <value>       Video model: ${modelValues}
+  --model <value>       Generate: ${modelValues("generate")}; refine/derive: ${modelValues("refine")}
   --aspect <ratio>      Video aspect ratio: ${aspectValues}
-  --resolution <value>  Veo-only output resolution (${resolutionByTier})
-  --duration <seconds>  Veo-only output duration: ${durationValues}
+  --resolution <value>  Veo: ${resolutionValues}; Kling/fal Seedance: 720p|1080p (${resolutionByTier})
+  --duration <seconds>  Veo/Kling/fal Seedance output duration: ${durationValues}
   --tier <tier>         Veo-only model tier: ${tierValues}
   --first-frame <ref>   Veo start frame image variant or local image path
   --last-frame <ref>    Veo final frame image variant or local image path
@@ -8586,17 +8706,17 @@ Audio:
 }
 //#endregion
 //#region src/cli/commands/init.ts
-var defaultDeps$6 = { saveProjectConfig };
+var defaultDeps$7 = { saveProjectConfig };
 async function handleInit(parsed) {
 	try {
 		await executeInit(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$5();
+		printUsage$6();
 		process$1.exitCode = 1;
 	}
 }
-async function executeInit(parsed, deps = defaultDeps$6) {
+async function executeInit(parsed, deps = defaultDeps$7) {
 	const environment = resolveCommandEnvironment(parsed);
 	const spaceId = resolveCommandSpace(parsed);
 	if (!spaceId) throw new Error("--space is required");
@@ -8622,7 +8742,7 @@ async function executeInit(parsed, deps = defaultDeps$6) {
 		spaceId
 	};
 }
-function printUsage$5() {
+function printUsage$6() {
 	console.log(`
 Usage:
   makefx init --space <id> [--env production|stage|local]
@@ -8631,7 +8751,7 @@ Usage:
 }
 //#endregion
 //#region src/cli/commands/runs.ts
-var defaultDeps$5 = {
+var defaultDeps$6 = {
 	loadProjectConfig,
 	listRunManifests,
 	readRunManifest,
@@ -8644,11 +8764,11 @@ async function handleRuns(parsed) {
 		await executeRuns(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$4();
+		printUsage$5();
 		process$1.exitCode = 1;
 	}
 }
-async function executeRuns(parsed, deps = defaultDeps$5) {
+async function executeRuns(parsed, deps = defaultDeps$6) {
 	const projectConfig = await deps.loadProjectConfig();
 	if (!projectConfig?.projectRoot) throw new Error("Make Effects project config not found. Run: makefx init --space <id>");
 	requireDebugAcknowledgement(parsed);
@@ -8766,7 +8886,7 @@ function formatCreated(value) {
 	if (Number.isNaN(date.getTime())) return value;
 	return value.replace("T", " ").replace(/\.\d{3}Z$/, "Z").slice(0, 20);
 }
-function printUsage$4() {
+function printUsage$5() {
 	console.log(`
 Usage:
   makefx runs --debug
@@ -8781,7 +8901,7 @@ Local run manifests are debug-only artifacts, not a source of truth.
 }
 //#endregion
 //#region src/cli/commands/assets.ts
-var defaultDeps$4 = {
+var defaultDeps$5 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -8805,15 +8925,15 @@ async function handleAssets(parsed) {
 		await executeAssets(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$3();
+		printUsage$4();
 		process$1.exitCode = 1;
 	}
 }
-async function executeAssets(parsed, deps = defaultDeps$4) {
+async function executeAssets(parsed, deps = defaultDeps$5) {
 	const subcommand = parsed.positionals[0] || "list";
 	if (subcommand === "search") return searchAssets(parsed, deps);
 	if (subcommand === "clone") return cloneAsset(parsed, deps);
-	const ctx = await buildContext$4(parsed, deps);
+	const ctx = await buildContext$5(parsed, deps);
 	if (subcommand === "list") {
 		const assets = await listAssets(ctx, deps);
 		if (parsed.options.json === "true") deps.print(JSON.stringify(assets.map(toAssetJson), null, 2));
@@ -8905,7 +9025,7 @@ async function executeAssets(parsed, deps = defaultDeps$4) {
 function normalizeOption$1(value) {
 	return !value || value === "true" ? void 0 : value;
 }
-async function buildContext$4(parsed, deps) {
+async function buildContext$5(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -9275,7 +9395,7 @@ function formatTimestamp(value) {
 	if (Number.isNaN(date.getTime())) return String(value);
 	return date.toISOString().replace("T", " ").replace(/\.\d{3}Z$/, "Z").slice(0, 20);
 }
-function printUsage$3() {
+function printUsage$4() {
 	console.log(`
 Usage:
   makefx assets
@@ -9292,7 +9412,7 @@ Usage:
 }
 //#endregion
 //#region src/cli/commands/variants.ts
-var defaultDeps$3 = {
+var defaultDeps$4 = {
 	loadConfig: loadStoredConfig,
 	loadProjectConfig,
 	resolveBaseUrl,
@@ -9304,12 +9424,12 @@ async function handleVariants(parsed) {
 		await executeVariants(parsed);
 	} catch (error) {
 		console.error("Error:", error instanceof Error ? error.message : error);
-		printUsage$2();
+		printUsage$3();
 		process$1.exitCode = 1;
 	}
 }
-async function executeVariants(parsed, deps = defaultDeps$3) {
-	const ctx = await buildContext$3(parsed, deps);
+async function executeVariants(parsed, deps = defaultDeps$4) {
+	const ctx = await buildContext$4(parsed, deps);
 	const subcommand = parsed.positionals[0];
 	if (subcommand === "delete") {
 		const variantId = requireVariantId(parsed, "delete");
@@ -9357,7 +9477,7 @@ function requireVariantId(parsed, verb) {
 	if (!variantId) throw new Error(`Variant ID is required: makefx variants ${verb} <variant-id>`);
 	return variantId;
 }
-async function buildContext$3(parsed, deps) {
+async function buildContext$4(parsed, deps) {
 	const projectConfig = await deps.loadProjectConfig();
 	const env = resolveCommandEnvironment(parsed, projectConfig);
 	const spaceId = resolveCommandSpace(parsed, projectConfig);
@@ -9380,7 +9500,7 @@ async function withVariantClient(ctx, deps, run) {
 		client.disconnect();
 	}
 }
-function printUsage$2() {
+function printUsage$3() {
 	console.log(`
 Usage:
   makefx variants delete <variant-id>
@@ -9396,6 +9516,84 @@ Options:
 `);
 }
 //#endregion
+//#region src/cli/commands/recipes.ts
+var defaultDeps$3 = {
+	loadConfig: loadStoredConfig,
+	loadProjectConfig,
+	resolveBaseUrl,
+	fetch,
+	print: console.log
+};
+async function handleRecipes(parsed) {
+	try {
+		await executeRecipes(parsed);
+	} catch (error) {
+		console.error("Error:", error instanceof Error ? error.message : error);
+		printUsage$2();
+		process$1.exitCode = 1;
+	}
+}
+async function executeRecipes(parsed, deps = defaultDeps$3) {
+	const subcommand = parsed.positionals[0];
+	if (subcommand !== "run") throw new Error(`Unknown recipes command: ${subcommand ?? "(none)"}`);
+	const sourceVariantId = parsed.positionals[1];
+	if (!sourceVariantId) throw new Error("Variant ID is required: makefx recipes run <variant-id>");
+	const rerun = await runRecipe(await buildContext$3(parsed, deps), deps, sourceVariantId);
+	if (parsed.options.json === "true") deps.print(JSON.stringify(rerun, null, 2));
+	else {
+		deps.print(`Re-ran recipe from variant ${rerun.sourceVariantId}`);
+		deps.print(`  Variant: ${rerun.variant.id} (status: ${rerun.variant.status})`);
+		deps.print(`  Request: ${rerun.requestId}`);
+		deps.print(`Watch progress with: makefx assets show ${rerun.variant.asset_id}`);
+	}
+	return {
+		type: "run",
+		rerun
+	};
+}
+async function buildContext$3(parsed, deps) {
+	const projectConfig = await deps.loadProjectConfig();
+	const env = resolveCommandEnvironment(parsed, projectConfig);
+	const spaceId = resolveCommandSpace(parsed, projectConfig);
+	if (!spaceId) throw new Error("--space is required, or run: makefx init --space <id>");
+	const config = await deps.loadConfig(env);
+	if (!config) throw new Error(`Not logged in to ${env} environment. Run: ${loginCommandForEnvironment(env)}`);
+	if (config.token.expiresAt < Date.now()) throw new Error(`Token expired for ${env} environment. Run: ${loginCommandForEnvironment(env)}`);
+	if (env === "local") process$1.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+	return {
+		spaceId,
+		baseUrl: deps.resolveBaseUrl(env),
+		accessToken: config.token.accessToken
+	};
+}
+async function runRecipe(ctx, deps, sourceVariantId) {
+	const response = await deps.fetch(`${ctx.baseUrl}/api/spaces/${encodeURIComponent(ctx.spaceId)}/variants/${encodeURIComponent(sourceVariantId)}/rerun`, {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${ctx.accessToken}`,
+			Accept: "application/json"
+		}
+	});
+	if (!response.ok) {
+		const text = await response.text();
+		throw new Error(`Recipe rerun failed (${response.status}): ${text || response.statusText}`);
+	}
+	return response.json();
+}
+function printUsage$2() {
+	console.log(`
+Usage:
+  makefx recipes run <variant-id>
+  makefx recipes run <variant-id> --json
+
+Options:
+  --space <id>      Target space ID; defaults from the initialized project
+  --json            Print machine-readable output
+  --env <env>       Environment (production|stage|local)
+  --local           Shortcut for --env local
+`);
+}
+//#endregion
 //#region src/cli/commands/collections.ts
 var COLLECTION_KINDS = new Set([
 	"cast",
@@ -9941,7 +10139,7 @@ Options:
 }
 //#endregion
 //#region src/cli/index.ts
-var CLI_VERSION = "1.0.7+686298a71cee";
+var CLI_VERSION = "1.1.0+e479be18b9f5";
 async function main() {
 	const argv = process$1.argv.slice(2);
 	if (argv[0] === "--") argv.shift();
@@ -9984,14 +10182,19 @@ function imageSizeValues() {
 function imageAspectValues() {
 	return optionValues(IMAGE_MODEL_CAPABILITIES["pro"].supportedAspectRatios);
 }
-function imageCapabilityHelp() {
+function imageModelValues(operation) {
+	return optionValues(IMAGE_MODEL_SELECTIONS.filter((model) => operation === void 0 || isImageOperationSupportedByModel(model, operation)));
+}
+function imageCapabilityHelp(operation) {
 	const sizeLines = IMAGE_MODEL_SELECTIONS.map((model) => `${model}: ${IMAGE_MODEL_CAPABILITIES[model].supportedImageSizes.join(", ")}`).join("; ");
 	const referenceLines = IMAGE_MODEL_SELECTIONS.map((model) => `${model}: ${IMAGE_MODEL_CAPABILITIES[model].maxReferenceImages}`).join("; ");
+	const operationLines = IMAGE_MODEL_SELECTIONS.map((model) => `${model}: ${IMAGE_MODEL_CAPABILITIES[model].supportedOperations.join(", ")}`).join("; ");
 	return `Image:
-  --model <value>   Image model: ${optionValues(IMAGE_MODEL_SELECTIONS)}
+  --model <value>   Image model: ${imageModelValues(operation)}
   --size <value>    Output size (${sizeLines})
   --aspect <ratio>  Aspect ratio: ${imageAspectValues()}
   --refs <refs>     Reference limit (${referenceLines})
+  Model operations: ${operationLines}
   --follow <id>     Resume/download a variant after a long generation or disconnect
   --collection <id> Place the completed asset in a Space collection`;
 }
@@ -10007,19 +10210,21 @@ function videoDurationValues() {
 function videoTierValues() {
 	return optionValues(VIDEO_GENERATION_TIERS);
 }
-function videoModelValues() {
-	return optionValues(VIDEO_MODEL_SELECTIONS);
+function videoModelValues(operation) {
+	return optionValues(VIDEO_MODEL_SELECTIONS.filter((model) => operation === void 0 || VIDEO_MODEL_SUPPORTED_OPERATIONS[model].includes(operation)));
 }
-function videoCapabilityHelp() {
+function videoCapabilityHelp(operation) {
 	const resolutionLines = VIDEO_GENERATION_TIERS.map((tier) => `${tier}: ${getVideoGenerationResolutionsForTier(tier).join(", ")}`).join("; ");
+	const operationLines = VIDEO_MODEL_SELECTIONS.map((model) => `${model}: ${VIDEO_MODEL_SUPPORTED_OPERATIONS[model].join(", ")}`).join("; ");
 	return `Video:
-  --model <value>       Video model: ${videoModelValues()}
+  --model <value>       Video model: ${videoModelValues(operation)}
   --aspect <ratio>      Video aspect ratio: ${videoAspectValues()}
-  --resolution <value>  Veo-only output resolution (${resolutionLines})
-  --duration <seconds>  Veo-only output duration: ${videoDurationValues()}
+  --resolution <value>  Veo: ${videoResolutionValues()}; Kling/fal Seedance: 720p|1080p (${resolutionLines})
+  --duration <seconds>  Veo/Kling/fal Seedance output duration: ${videoDurationValues()}
   --tier <tier>         Veo-only model tier: ${videoTierValues()}
   --first-frame <ref>   Veo start frame image variant or local image path
   --last-frame <ref>    Veo final frame image variant or local image path
+  Model operations: ${operationLines}
   --follow <id>         Resume/download a variant after a long generation or disconnect
   --collection <id>     Place the completed asset in a Space collection
 
@@ -10102,6 +10307,10 @@ function printCommandHelp(command, positionals) {
 		case "variant":
 			printVariantsHelp();
 			return;
+		case "recipes":
+		case "recipe":
+			printRecipesHelp();
+			return;
 		default:
 			console.error(`Unknown command: ${command}`);
 			printHelp();
@@ -10128,6 +10337,7 @@ Generate:
   video generate "prompt" --name <name> --type animation -o <file>
 
 Continue:
+  recipes run <variant-id>                Re-run a stored recipe as a new sibling variant
   generate --follow <variant_id> -o <file>
   video generate --follow <variant_id> -o <file>
   audio <mode> generate --follow <variant_id> -o <file>
@@ -10281,10 +10491,10 @@ function printForgeHelp(command) {
 	if (command === "generate") {
 		console.log(`
 Usage:
-  makefx generate "prompt" --name <name> --type <type> -o <file> [--model ${optionValues(IMAGE_MODEL_SELECTIONS)}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
+  makefx generate "prompt" --name <name> --type <type> -o <file> [--model ${imageModelValues("generate")}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
   makefx generate --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${imageCapabilityHelp()}
+${imageCapabilityHelp("generate")}
 
 If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
 Rerun the printed --follow command to resume the same variant instead of starting a duplicate.
@@ -10294,10 +10504,10 @@ Rerun the printed --follow command to resume the same variant instead of startin
 	if (command === "refine") {
 		console.log(`
 Usage:
-  makefx refine --variant <variant_id> "prompt" -o <file> [--model ${optionValues(IMAGE_MODEL_SELECTIONS)}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
+  makefx refine --variant <variant_id> "prompt" -o <file> [--model ${imageModelValues("refine")}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
   makefx refine --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${imageCapabilityHelp()}
+${imageCapabilityHelp("refine")}
 
 If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
 Rerun the printed --follow command to resume the same variant instead of starting a duplicate.
@@ -10307,9 +10517,9 @@ Rerun the printed --follow command to resume the same variant instead of startin
 	if (command === "batch") {
 		console.log(`
 Usage:
-  makefx batch "prompt" --name <name> --type <type> --count <2-8> --output-dir <dir> [--model ${optionValues(IMAGE_MODEL_SELECTIONS)}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>]
+  makefx batch "prompt" --name <name> --type <type> --count <2-8> --output-dir <dir> [--model ${imageModelValues("generate")}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>]
 
-${imageCapabilityHelp()}
+${imageCapabilityHelp("generate")}
 
 Batch creates several variants. If waiting stops, inspect the Space or download completed variants with:
   makefx assets download <variant_id> -o <file>
@@ -10318,10 +10528,10 @@ Batch creates several variants. If waiting stops, inspect the Space or download
 	}
 	console.log(`
 Usage:
-  makefx derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${optionValues(IMAGE_MODEL_SELECTIONS)}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
+  makefx derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${imageModelValues("derive")}] [--size ${imageSizeValues()}] [--aspect <ratio>] [--collection <id>] [--space <id>]
   makefx derive --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${imageCapabilityHelp()}
+${imageCapabilityHelp("derive")}
 
 If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
 Rerun the printed --follow command to resume the same variant instead of starting a duplicate.
@@ -10433,13 +10643,14 @@ function printVideoHelp(positionals) {
 	if (subcommand === "generate") {
 		console.log(`
 Usage:
-  makefx video generate "prompt" --name <name> --type <type> -o <file> [--model ${videoModelValues()}] [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
+  makefx video generate "prompt" --name <name> --type <type> -o <file> [--model ${videoModelValues("generate")}] [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
   makefx video generate --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${videoCapabilityHelp()}
+${videoCapabilityHelp("generate")}
 
 Audio:
-  Video defaults to generated audio. Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
+  Veo and Kling default to generated audio. fal Seedance is silent and rejects --audio.
+  Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
 
 Long runs:
   If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
@@ -10450,13 +10661,13 @@ Long runs:
 	if (subcommand === "refine") {
 		console.log(`
 Usage:
-  makefx video refine --variant <variant_id> "prompt" -o <file> [--model ${videoModelValues()}] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
+  makefx video refine --variant <variant_id> "prompt" -o <file> [--model ${videoModelValues("refine")}] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
   makefx video refine --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${videoCapabilityHelp()}
+${videoCapabilityHelp("refine")}
 
 Audio:
-  Video defaults to generated audio. Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
+  Veo and Kling default to generated audio. Current Veo models do not support --no-audio.
 
 Long runs:
   If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
@@ -10467,14 +10678,14 @@ Long runs:
 	if (subcommand === "derive") {
 		console.log(`
 Usage:
-  makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${videoModelValues()}] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
+  makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--model ${videoModelValues("derive")}] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
   makefx video derive --first-frame <variant_or_file> [--last-frame <variant_or_file>] --name <name> --type <type> "prompt" -o <file> [--model veo-3.1] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--collection <id>] [--space <id>]
   makefx video derive --follow <variant_id> -o <file> [--collection <id>] [--space <id>]
 
-${videoCapabilityHelp()}
+${videoCapabilityHelp("derive")}
 
 Audio:
-  Video defaults to generated audio. Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
+  Veo and Kling default to generated audio. Current Veo models do not support --no-audio.
 
 Long runs:
   If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
@@ -10493,7 +10704,8 @@ Usage:
 ${videoCapabilityHelp()}
 
 Audio:
-  Video defaults to generated audio. Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
+  Veo and Kling default to generated audio. fal Seedance is silent and generate-only.
+  Current Veo models do not support --no-audio; the CLI rejects it before creating a job.
 
 Long runs:
   If the CLI stops waiting after a job has started, the job keeps running in Make Effects.
@@ -10532,6 +10744,21 @@ Options:
   --local           Shortcut for --env local
 `);
 }
+function printRecipesHelp() {
+	console.log(`
+Usage:
+  makefx recipes run <variant-id>
+  makefx recipes run <variant-id> --json
+
+Re-runs the stored generation recipe as a new sibling variant of the same asset.
+
+Options:
+  --space <id>      Target space ID; defaults from the initialized project
+  --json            Print machine-readable output
+  --env <env>       Environment (production|stage|local)
+  --local           Shortcut for --env local
+`);
+}
 function printAssetsHelp() {
 	console.log(`
 Usage:
@@ -10663,6 +10890,10 @@ async function dispatchCommand(command, parsed) {
 		case "variant":
 			await handleVariants(parsed);
 			break;
+		case "recipes":
+		case "recipe":
+			await handleRecipes(parsed);
+			break;
 		default:
 			console.error(`Unknown command: ${command}`);
 			printHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "makefx",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Command-line interface for AI-assisted game asset production with Make Effects.",
   "license": "MIT",
   "type": "module",