makefx 0.2.6 → 0.2.8

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: 0.2.6
+Version: 0.2.8

package/makefx.mjs

@@ -19831,6 +19831,19 @@ var SpaceRoleSchema = _enum([
 	"editor",
 	"viewer"
 ]);
+var SpaceAccessRoleSchema = _enum(["editor", "viewer"]);
+var SpaceAccessRequestStatusSchema = _enum([
+	"pending",
+	"approved",
+	"rejected",
+	"canceled"
+]);
+var SpaceInvitationStatusSchema = _enum([
+	"pending",
+	"accepted",
+	"revoked",
+	"expired"
+]);
 var SpaceSchema = object({
 	id: string$1(),
 	name: string$1(),
@@ -19861,6 +19874,98 @@ var SpaceIdParamsSchema = object({ id: string$1().openapi({ param: {
 	name: "id",
 	in: "path"
 } }) });
+var SpaceAccessRequestParamsSchema = SpaceIdParamsSchema.extend({ requestId: string$1().openapi({ param: {
+	name: "requestId",
+	in: "path"
+} }) });
+var SpaceInvitationParamsSchema = SpaceIdParamsSchema.extend({ invitationId: string$1().openapi({ param: {
+	name: "invitationId",
+	in: "path"
+} }) });
+var SpaceSharingUserSchema = object({
+	id: string$1(),
+	email: string$1(),
+	name: string$1().nullable()
+}).openapi("SpaceSharingUser");
+var SpaceSharingMemberSchema = object({
+	user_id: string$1(),
+	role: SpaceRoleSchema,
+	joined_at: number$1(),
+	user: SpaceSharingUserSchema
+}).openapi("SpaceSharingMember");
+var SpaceAccessRequestSchema = object({
+	id: string$1(),
+	space_id: string$1(),
+	requester_user_id: string$1(),
+	requested_role: SpaceAccessRoleSchema,
+	status: SpaceAccessRequestStatusSchema,
+	message: string$1().nullable(),
+	created_at: string$1(),
+	updated_at: string$1(),
+	resolved_at: string$1().nullable(),
+	resolved_by_user_id: string$1().nullable()
+}).openapi("SpaceAccessRequest");
+var SpaceAccessRequestWithRequesterSchema = SpaceAccessRequestSchema.extend({ requester: SpaceSharingUserSchema }).openapi("SpaceAccessRequestWithRequester");
+var SpaceInvitationSchema = object({
+	id: string$1(),
+	space_id: string$1(),
+	email: string$1(),
+	normalized_email: string$1(),
+	role: SpaceAccessRoleSchema,
+	status: SpaceInvitationStatusSchema,
+	invited_by_user_id: string$1(),
+	accepted_by_user_id: string$1().nullable(),
+	created_at: string$1(),
+	updated_at: string$1(),
+	expires_at: string$1().nullable(),
+	resolved_at: string$1().nullable()
+}).openapi("SpaceInvitation");
+var SpaceInvitationWithUsersSchema = SpaceInvitationSchema.extend({
+	invitedBy: SpaceSharingUserSchema.nullable(),
+	acceptedBy: SpaceSharingUserSchema.nullable()
+}).openapi("SpaceInvitationWithUsers");
+var SpaceAccessStateSchema = object({
+	status: _enum([
+		"member",
+		"pending_request",
+		"pending_invitation",
+		"none"
+	]),
+	member: SpaceSharingMemberSchema.nullable(),
+	pendingRequest: SpaceAccessRequestSchema.nullable(),
+	pendingInvitation: SpaceInvitationSchema.nullable()
+}).openapi("SpaceAccessState");
+var GetSpaceAccessResponseSchema = object({
+	success: literal(true),
+	access: SpaceAccessStateSchema
+}).openapi("GetSpaceAccessResponse");
+var CreateSpaceAccessRequestRequestSchema = object({
+	requestedRole: SpaceAccessRoleSchema.default("viewer").optional(),
+	message: string$1().nullable().optional()
+}).openapi("CreateSpaceAccessRequestRequest");
+var SpaceAccessRequestResponseSchema = object({
+	success: literal(true),
+	request: SpaceAccessRequestSchema
+}).openapi("SpaceAccessRequestResponse");
+var ApproveSpaceAccessRequestRequestSchema = object({ role: SpaceAccessRoleSchema.optional() }).openapi("ApproveSpaceAccessRequestRequest");
+var CancelSpaceAccessRequestResponseSchema = object({
+	success: literal(true),
+	request: SpaceAccessRequestSchema.nullable()
+}).openapi("CancelSpaceAccessRequestResponse");
+var SpaceSharingResponseSchema = object({
+	success: literal(true),
+	members: array(SpaceSharingMemberSchema),
+	pendingAccessRequests: array(SpaceAccessRequestWithRequesterSchema),
+	pendingInvitations: array(SpaceInvitationWithUsersSchema)
+}).openapi("SpaceSharingResponse");
+var CreateSpaceInvitationRequestSchema = object({
+	email: string$1().trim().email(),
+	role: SpaceAccessRoleSchema
+}).openapi("CreateSpaceInvitationRequest");
+var SpaceInvitationResponseSchema = object({
+	success: literal(true),
+	invitation: SpaceInvitationSchema
+}).openapi("SpaceInvitationResponse");
 var ProductionIdParamsSchema = SpaceIdParamsSchema.extend({ productionId: string$1().openapi({ param: {
 	name: "productionId",
 	in: "path"
@@ -20692,6 +20797,63 @@ var apiEndpoints = {
 		paramsSchema: SpaceIdParamsSchema,
 		responseSchema: GetSpaceResponseSchema
 	},
+	"GET /api/spaces/:id/access": {
+		method: "GET",
+		path: "/api/spaces/:id/access",
+		paramsSchema: SpaceIdParamsSchema,
+		responseSchema: GetSpaceAccessResponseSchema
+	},
+	"POST /api/spaces/:id/access-requests": {
+		method: "POST",
+		path: "/api/spaces/:id/access-requests",
+		paramsSchema: SpaceIdParamsSchema,
+		jsonSchema: CreateSpaceAccessRequestRequestSchema,
+		responseSchema: SpaceAccessRequestResponseSchema
+	},
+	"DELETE /api/spaces/:id/access-requests/me": {
+		method: "DELETE",
+		path: "/api/spaces/:id/access-requests/me",
+		paramsSchema: SpaceIdParamsSchema,
+		responseSchema: CancelSpaceAccessRequestResponseSchema
+	},
+	"GET /api/spaces/:id/sharing": {
+		method: "GET",
+		path: "/api/spaces/:id/sharing",
+		paramsSchema: SpaceIdParamsSchema,
+		responseSchema: SpaceSharingResponseSchema
+	},
+	"POST /api/spaces/:id/invitations": {
+		method: "POST",
+		path: "/api/spaces/:id/invitations",
+		paramsSchema: SpaceIdParamsSchema,
+		jsonSchema: CreateSpaceInvitationRequestSchema,
+		responseSchema: SpaceInvitationResponseSchema
+	},
+	"POST /api/spaces/:id/access-requests/:requestId/approve": {
+		method: "POST",
+		path: "/api/spaces/:id/access-requests/:requestId/approve",
+		paramsSchema: SpaceAccessRequestParamsSchema,
+		jsonSchema: ApproveSpaceAccessRequestRequestSchema.optional(),
+		responseSchema: SpaceAccessRequestResponseSchema
+	},
+	"POST /api/spaces/:id/access-requests/:requestId/reject": {
+		method: "POST",
+		path: "/api/spaces/:id/access-requests/:requestId/reject",
+		paramsSchema: SpaceAccessRequestParamsSchema,
+		responseSchema: SpaceAccessRequestResponseSchema
+	},
+	"POST /api/spaces/:id/invitations/:invitationId/revoke": {
+		method: "POST",
+		path: "/api/spaces/:id/invitations/:invitationId/revoke",
+		paramsSchema: SpaceInvitationParamsSchema,
+		responseSchema: SpaceInvitationResponseSchema
+	},
+	"POST /api/spaces/:id/invitations/:invitationId/accept": {
+		method: "POST",
+		path: "/api/spaces/:id/invitations/:invitationId/accept",
+		paramsSchema: SpaceInvitationParamsSchema,
+		responseSchema: SpaceInvitationResponseSchema
+	},
 	"GET /api/support/spaces/:id": {
 		method: "GET",
 		path: "/api/support/spaces/:id",
@@ -23181,6 +23343,7 @@ async function executeForgeCommand(command, parsed, deps = defaultDeps$10, optio
 	validateImageCommandReferenceCount(command, parsed, mediaKind, parseImageGenerationOptions(parsed, mediaKind).model);
 	validateVideoAudioOptions(parsed, mediaKind);
 	parseVideoGenerationOptions(parsed, mediaKind);
+	validateVideoFrameReferenceOptions(command, parsed, mediaKind);
 	if (command !== "batch") validateProductionMetadataOptions(parsed);
 	const ctx = await buildContext$7(parsed, deps);
 	const client = await deps.createClient(ctx.env, ctx.spaceId);
@@ -23222,6 +23385,7 @@ async function prepareAudioParsedArgs(parsed, mode) {
 	const positionals = [...parsed.positionals];
 	const effectiveMode = mode ?? getAudioModeFromType(options.type);
 	validateAudioProviderOption(options.provider, effectiveMode);
+	validateAudioModelOption(options.model, effectiveMode);
 	if (mode) options.type = getMediaOperationEntry(mode).assetType;
 	validateAudioVoiceOptions(options);
 	if (options.input) {
@@ -23246,23 +23410,28 @@ async function executeGenerate(parsed, ctx, client, deps, mediaKind, followOptio
 	const assetType = requireOption(parsed, "type");
 	const musicProvider = parseMusicProviderOption(parsed, mediaKind, assetType);
 	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const videoFrameRefs = parseVideoFrameReferenceOptions(parsed, "generate", mediaKind).refs;
+	const state = videoFrameRefs.length > 0 ? await requestSpaceState(client) : void 0;
+	const referenceVariantIds = videoFrameRefs.length > 0 ? await resolveReferenceVariantIds(videoFrameRefs, ctx, deps, state?.variants, CLI_GENERATION_MEDIA_KIND) : [];
 	const scene = parseSceneMetadata(parsed, {
 		prompt,
-		refs: [],
-		referenceVariantIds: [],
+		refs: videoFrameRefs,
+		referenceVariantIds,
 		mediaKind
 	});
 	const imageOptions = parseImageGenerationOptions(parsed, mediaKind);
+	const audioModelOptions = parseAudioGenerationOptions(parsed, mediaKind);
 	const videoAudioOptions = parseVideoAudioOptions(parsed, mediaKind);
 	const videoOptions = parseVideoGenerationOptions(parsed, mediaKind);
 	const styleSelection = await resolveStyleSelection(parsed, ctx, deps);
+	const disableStyle = parsed.options["no-style"] === "true" || videoFrameRefs.length > 0;
 	await printPreflightEstimate(client, {
 		operation: "generate",
 		assetType,
 		mediaKind,
 		prompt,
 		count: 1,
-		model: imageOptions.model,
+		model: imageOptions.model ?? audioModelOptions.model,
 		imageSize: imageOptions.imageSize,
 		...musicProvider ? { musicProvider } : {},
 		...videoAudioOptions,
@@ -23275,9 +23444,11 @@ async function executeGenerate(parsed, ctx, client, deps, mediaKind, followOptio
 		name,
 		assetType,
 		prompt,
+		...referenceVariantIds.length > 0 ? { referenceVariantIds } : {},
 		...imageOptions,
+		...audioModelOptions,
 		aspectRatio: imageOptions.aspectRatio ?? videoOptions.aspectRatio,
-		disableStyle: parsed.options["no-style"] === "true",
+		disableStyle,
 		...styleSelection.stylePresetId ? { stylePresetId: styleSelection.stylePresetId } : {},
 		mediaKind,
 		...audioVoiceOptions,
@@ -23305,8 +23476,8 @@ async function executeGenerate(parsed, ctx, client, deps, mediaKind, followOptio
 		name,
 		assetType,
 		startedAt,
-		refs: [],
-		referenceVariantIds: [],
+		refs: videoFrameRefs,
+		referenceVariantIds,
 		scene
 	});
 	await downloadResult(result, outputPath, ctx, deps);
@@ -23321,6 +23492,10 @@ function validateAudioProviderOption(value, mode) {
 	if (mode !== "music") throw new Error("--provider is only supported for audio music");
 	if (value !== "elevenlabs" && value !== "lyria") throw new Error("--provider must be elevenlabs or lyria");
 }
+function validateAudioModelOption(value, mode) {
+	if (!value) return;
+	if (mode !== "speech" && mode !== "dialogue") throw new Error("--model is only supported for speech and dialogue audio");
+}
 function parseMusicProviderOption(parsed, mediaKind, assetType) {
 	const value = parsed.options.provider;
 	if (!value) return void 0;
@@ -23406,20 +23581,24 @@ async function executeDerive(parsed, ctx, client, deps, mediaKind, followOptions
 	const outputPath = getOutputPath$1(parsed);
 	const name = requireOption(parsed, "name");
 	const assetType = requireOption(parsed, "type");
-	const refs = parseRefs(requireOption(parsed, "refs"));
+	const videoFrameRefs = parseVideoFrameReferenceOptions(parsed, "derive", mediaKind).refs;
+	const refs = parsed.options.refs ? parseRefs(requireOption(parsed, "refs")) : [];
+	const referenceRefs = videoFrameRefs.length > 0 ? videoFrameRefs : refs;
+	if (referenceRefs.length === 0) throw new Error("--refs is required");
 	const imageOptions = parseImageGenerationOptions(parsed, mediaKind);
-	if (mediaKind === "image") validateImageReferenceCount(imageOptions.model, refs.length);
-	const referenceVariantIds = await resolveReferenceVariantIds(refs, ctx, deps, (await requestSpaceState(client)).variants, mediaKind);
+	if (mediaKind === "image") validateImageReferenceCount(imageOptions.model, referenceRefs.length);
+	const referenceVariantIds = await resolveReferenceVariantIds(referenceRefs, ctx, deps, (await requestSpaceState(client)).variants, videoFrameRefs.length > 0 ? CLI_GENERATION_MEDIA_KIND : mediaKind);
 	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
 	const scene = parseSceneMetadata(parsed, {
 		prompt,
-		refs,
+		refs: referenceRefs,
 		referenceVariantIds,
 		mediaKind
 	});
 	const videoAudioOptions = parseVideoAudioOptions(parsed, mediaKind);
 	const videoOptions = parseVideoGenerationOptions(parsed, mediaKind);
 	const styleSelection = await resolveStyleSelection(parsed, ctx, deps);
+	const disableStyle = parsed.options["no-style"] === "true" || videoFrameRefs.length > 0;
 	await printPreflightEstimate(client, {
 		operation: "derive",
 		assetType,
@@ -23440,7 +23619,7 @@ async function executeDerive(parsed, ctx, client, deps, mediaKind, followOptions
 		referenceVariantIds,
 		...imageOptions,
 		aspectRatio: imageOptions.aspectRatio ?? videoOptions.aspectRatio,
-		disableStyle: parsed.options["no-style"] === "true",
+		disableStyle,
 		...styleSelection.stylePresetId ? { stylePresetId: styleSelection.stylePresetId } : {},
 		mediaKind,
 		...videoAudioOptions,
@@ -23466,7 +23645,7 @@ async function executeDerive(parsed, ctx, client, deps, mediaKind, followOptions
 		name,
 		assetType,
 		startedAt,
-		refs,
+		refs: referenceRefs,
 		referenceVariantIds,
 		scene
 	});
@@ -23631,6 +23810,7 @@ async function executeBatch(parsed, ctx, client, deps, mediaKind, saveBatchManif
 	const mode = parseBatchMode(parsed.options.mode || "explore");
 	const refs = parsed.options.refs ? parseRefs(parsed.options.refs) : [];
 	const imageOptions = parseImageGenerationOptions(parsed, mediaKind);
+	const audioModelOptions = parseAudioGenerationOptions(parsed, mediaKind);
 	if (mediaKind === "image") validateImageReferenceCount(imageOptions.model, refs.length);
 	const state = await requestSpaceState(client);
 	const referenceVariantIds = refs.length > 0 ? await resolveReferenceVariantIds(refs, ctx, deps, state.variants, mediaKind) : void 0;
@@ -23643,7 +23823,7 @@ async function executeBatch(parsed, ctx, client, deps, mediaKind, saveBatchManif
 		mediaKind,
 		prompt,
 		count,
-		model: imageOptions.model,
+		model: imageOptions.model ?? audioModelOptions.model,
 		imageSize: imageOptions.imageSize,
 		...musicProvider ? { musicProvider } : {}
 	});
@@ -23659,6 +23839,7 @@ async function executeBatch(parsed, ctx, client, deps, mediaKind, saveBatchManif
 		mode,
 		referenceVariantIds,
 		...imageOptions,
+		...audioModelOptions,
 		aspectRatio: imageOptions.aspectRatio,
 		disableStyle: parsed.options["no-style"] === "true",
 		...styleSelection.stylePresetId ? { stylePresetId: styleSelection.stylePresetId } : {},
@@ -24101,6 +24282,31 @@ function parseVideoGenerationOptions(parsed, mediaKind) {
 		...videoTier ? { videoTier } : {}
 	};
 }
+function parseVideoFrameReferenceOptions(parsed, command, mediaKind) {
+	validateVideoFrameReferenceOptions(command, parsed, mediaKind);
+	const firstFrame = readVideoFrameOption(parsed, "first-frame", "firstFrame");
+	const lastFrame = readVideoFrameOption(parsed, "last-frame", "lastFrame");
+	return { refs: [...firstFrame ? [firstFrame] : [], ...lastFrame ? [lastFrame] : []] };
+}
+function validateVideoFrameReferenceOptions(command, parsed, mediaKind) {
+	const firstFrame = readVideoFrameOption(parsed, "first-frame", "firstFrame");
+	const lastFrame = readVideoFrameOption(parsed, "last-frame", "lastFrame");
+	if (!firstFrame && !lastFrame) return;
+	if (mediaKind !== "video") throw new Error("--first-frame and --last-frame are only supported for video generation");
+	if (command !== "generate" && command !== "derive") throw new Error("--first-frame and --last-frame are only supported for video generate and video derive");
+	if (lastFrame && !firstFrame) throw new Error("--last-frame requires --first-frame");
+	if (parsed.options.refs) throw new Error("--first-frame and --last-frame cannot be combined with --refs");
+	if (readStylePresetOption(parsed)) throw new Error("--first-frame and --last-frame cannot be combined with --style-preset");
+}
+function readVideoFrameOption(parsed, kebabName, camelName) {
+	const value = parsed.options[kebabName] ?? parsed.options[camelName];
+	if (value === void 0) return void 0;
+	const flag = `--${kebabName}`;
+	if (value === "true") throw new Error(`${flag} requires a variant ID or local image path`);
+	const trimmed = value.trim();
+	if (!trimmed) throw new Error(`${flag} requires a variant ID or local image path`);
+	return trimmed;
+}
 function parseDialogueVoiceIds(value) {
 	const normalized = normalizeCliOption(value);
 	if (!normalized) return void 0;
@@ -24112,6 +24318,11 @@ function normalizeCliOption(value) {
 	if (value === void 0 || value === "true") return void 0;
 	return value.trim() || void 0;
 }
+function parseAudioGenerationOptions(parsed, mediaKind) {
+	if (mediaKind !== "audio") return {};
+	const model = normalizeCliOption(readOptionalOption(parsed, "model", "model"));
+	return model ? { model } : {};
+}
 function parseImageGenerationOptions(parsed, mediaKind) {
 	if (mediaKind !== "image") return {};
 	const model = parseImageModelOption(readOptionalOption(parsed, "model", "model"));
@@ -24427,11 +24638,12 @@ function printUsage$8() {
 	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> [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
+  makefx video generate "prompt" --name <name> --type <type> -o <file> [--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> [--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> [--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> [--aspect ${aspectValues}] [--resolution ${resolutionValues}] [--duration ${durationValues}] [--tier ${tierValues}] [--audio] [--space <id>]
   makefx video derive --follow <variant_id> -o <file> [--space <id>]
 
 Video:
@@ -24439,6 +24651,15 @@ Video:
   --resolution <value>  Veo output resolution (${resolutionByTier})
   --duration <seconds>  Veo output duration: ${durationValues}
   --tier <tier>         Veo 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
+
+Veo 3.1 frames:
+  --first-frame resolves to the first referenceVariantId and becomes the Veo top-level image input.
+  --last-frame resolves to the second referenceVariantId and becomes Veo config.lastFrame.
+  Use both flags together for first/last-frame generation; --last-frame requires --first-frame.
+  Frame flags disable style injection so style refs cannot be prepended ahead of the start/end frames.
+  Do not combine frame flags with --refs or --style-preset. Use --refs when you want generic Veo reference images instead of first/last-frame inputs.
 
 Audio:
   --audio       Request native synchronized Veo audio (default)
@@ -26552,7 +26773,7 @@ Options:
 }
 //#endregion
 //#region src/cli/index.ts
-var CLI_VERSION = "0.2.6+be63b9dd565a";
+var CLI_VERSION = "0.2.8+62a28e206c2a";
 async function main() {
 	const argv = process$1.argv.slice(2);
 	if (argv[0] === "--") argv.shift();
@@ -26622,7 +26843,16 @@ function videoCapabilityHelp() {
   --aspect <ratio>      Veo aspect ratio: ${videoAspectValues()}
   --resolution <value>  Veo output resolution (${resolutionLines})
   --duration <seconds>  Veo output duration: ${videoDurationValues()}
-  --tier <tier>         Veo model tier: ${videoTierValues()}`;
+  --tier <tier>         Veo 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
+
+Veo 3.1 frames:
+  --first-frame resolves to the first referenceVariantId and becomes the Veo top-level image input.
+  --last-frame resolves to the second referenceVariantId and becomes Veo config.lastFrame.
+  Use both flags together for first/last-frame generation; --last-frame requires --first-frame.
+  Frame flags disable style injection so style refs cannot be prepended ahead of the start/end frames.
+  Do not combine frame flags with --refs or --style-preset. Use --refs when you want generic Veo reference images instead of first/last-frame inputs.`;
 }
 function configureLocalTls(args) {
 	if (args.includes("--local") || args.includes("--env") && args[args.indexOf("--env") + 1] === "local") process$1.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
@@ -26806,10 +27036,10 @@ Audio:
   audio sfx generate "prompt" --name <name> -o <file>
 
 Video:
-  video generate "prompt" --name <name> --type <type> -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio]
+  video generate "prompt" --name <name> --type <type> -o <file> [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio]
   video generate --follow <variant_id> -o <file>
   video refine --variant <variant_id> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio]
-  video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio]
+  video derive (--refs <variant_or_file,variant_or_file> | --first-frame <variant_or_file> [--last-frame <variant_or_file>]) --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio]
 
 Options:
   --env <environment>          Target environment (production|stage|local), default: production
@@ -26830,6 +27060,7 @@ Examples:
   makefx batch "Three Russafa market keyframes" --name "Market Keyframe" --type scene --count 3 --output-dir keyframes
   makefx audio sfx generate "A short brass victory sting" --name "Victory Sting" -o victory.wav
   makefx video generate "A looping idle animation" --name "Idle Animation" --type animation --duration 6 --resolution 1080p --tier fast -o idle.mp4
+  makefx video derive --first-frame keyframes/start.png --last-frame keyframes/end.png --name "Camera Move" --type animation "slow dolly from start to end" -o move.mp4
   makefx productions export --production-id s01e01-a2
   makefx upload hero.png --name "Hero" --collection collection_cast
   makefx upload hero.png --name "Hero" --collection-name "Cast" --json
@@ -27037,6 +27268,7 @@ Usage:
   makefx audio ${first} generate --follow <variant_id> -o <file> [--space <id>]
 ${first === "music" ? "  makefx audio music generate \"prompt\" --provider lyria --name <name> -o <file> [--space <id>]\n" : ""}
 ${first === "music" ? "Provider selection:\n  --provider <elevenlabs|lyria>        Music provider (default: server default)\n" : ""}
+${first === "speech" || first === "dialogue" ? "Model selection:\n  --model <model_id>                   ElevenLabs model (default: eleven_v3)\n" : ""}
 ${first === "speech" || first === "dialogue" ? "Voice selection:\n  --voice <voice_id>                    Speech voice, or dialogue fallback voice\n  --dialogue-voices <id,id,...>         Dialogue voices ordered by first speaker appearance\n" : ""}
 `);
 			return;
@@ -27047,6 +27279,8 @@ Usage:
   makefx audio ${first} batch "prompt" --name <name> --count <2-8> --output-dir <dir> [--space <id>]
 ${first === "music" ? "  makefx audio music batch \"prompt\" --provider lyria --name <name> --count <2-8> --output-dir <dir> [--space <id>]\n" : ""}
 ${first === "music" ? "Provider selection:\n  --provider <elevenlabs|lyria>        Music provider (default: server default)\n" : ""}
+${first === "speech" || first === "dialogue" ? "Model selection:\n  --model <model_id>                   ElevenLabs model (default: eleven_v3)\n" : ""}
+${first === "speech" || first === "dialogue" ? "Voice selection:\n  --voice <voice_id>                    Speech voice, or dialogue fallback voice\n  --dialogue-voices <id,id,...>         Dialogue voices ordered by first speaker appearance\n" : ""}
 `);
 			return;
 		}
@@ -27055,6 +27289,7 @@ Usage:
   makefx audio ${first} generate "prompt" --name <name> -o <file> [--space <id>]
   makefx audio ${first} batch "prompt" --name <name> --count <2-8> --output-dir <dir> [--space <id>]
 ${first === "music" ? "\nProvider selection:\n  --provider <elevenlabs|lyria>        Music provider (default: server default)\n" : ""}
+${first === "speech" || first === "dialogue" ? "\nModel selection:\n  --model <model_id>                   ElevenLabs model (default: eleven_v3)\n" : ""}
 ${first === "speech" || first === "dialogue" ? "\nVoice selection:\n  --voice <voice_id>                    Speech voice, or dialogue fallback voice\n  --dialogue-voices <id,id,...>         Dialogue voices ordered by first speaker appearance\n" : ""}
 `);
 		return;
@@ -27098,6 +27333,9 @@ Voice selection:
   --voice <voice_id>                    Speech voice, or dialogue fallback voice
   --dialogue-voices <id,id,...>         Dialogue voices ordered by first speaker appearance
 
+Model selection:
+  --model <model_id>                   ElevenLabs speech/dialogue model (default: eleven_v3)
+
 Low-level compatibility:
   makefx audio generate "prompt" --name <name> --type <type> -o <file> [--space <id>]
   makefx audio batch "prompt" --name <name> --type <type> --count <2-8> --output-dir <dir> [--space <id>]
@@ -27108,7 +27346,7 @@ function printVideoHelp(positionals) {
 	if (subcommand === "generate") {
 		console.log(`
 Usage:
-  makefx video generate "prompt" --name <name> --type <type> -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
+  makefx video generate "prompt" --name <name> --type <type> -o <file> [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
   makefx video generate --follow <variant_id> -o <file> [--space <id>]
 
 ${videoCapabilityHelp()}
@@ -27143,6 +27381,7 @@ Production metadata:
 		console.log(`
 Usage:
   makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
+  makefx video derive --first-frame <variant_or_file> [--last-frame <variant_or_file>] --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
   makefx video derive --follow <variant_id> -o <file> [--space <id>]
 
 ${videoCapabilityHelp()}
@@ -27158,10 +27397,11 @@ Production metadata:
 	}
 	console.log(`
 Usage:
-  makefx video generate "prompt" --name <name> --type <type> -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
+  makefx video generate "prompt" --name <name> --type <type> -o <file> [--first-frame <variant_or_file>] [--last-frame <variant_or_file>] [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
   makefx video generate --follow <variant_id> -o <file> [--space <id>]
   makefx video refine --variant <variant_id> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
   makefx video derive --refs <variant_or_file,variant_or_file> --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
+  makefx video derive --first-frame <variant_or_file> [--last-frame <variant_or_file>] --name <name> --type <type> "prompt" -o <file> [--aspect ${videoAspectValues()}] [--resolution ${videoResolutionValues()}] [--duration ${videoDurationValues()}] [--tier ${videoTierValues()}] [--audio] [--space <id>]
 
 ${videoCapabilityHelp()}
 

package/package.json

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