veogent 1.1.3 → 1.1.4

package/index.js

@@ -135,8 +135,8 @@ program
 program
     .command('setup-flow')
     .description('Setup Google Flow Key and User Payment Tier (Requires authentication)')
-    .requiredOption('-f, --flowkey <key>', 'The Google access token (ya29...)')
-    .option('-t, --tier <tier>', 'User payment tier', 'PAYGATE_TIER_TWO')
+    .requiredOption('--flowkey <key>', 'The Google access token (ya29...)')
+    .option('--tier <tier>', 'User payment tier', 'PAYGATE_TIER_TWO')
     .action(async (options) => {
         try {
             const payload = {
@@ -239,10 +239,10 @@ program
 program
     .command('create-project-description')
     .description('Generate AI description for a new project based on keywords')
-    .requiredOption('-k, --keyword <keyword>', 'Keywords for the project')
-    .requiredOption('-l, --lang <lang>', 'Story language')
-    .option('-p, --promptId <promptId>', 'Custom Prompt ID from custom-prompts (optional)')
-    .option('-O, --objects <objects...>', 'List of specific objects to include as JSON strings (optional)')
+    .requiredOption('--keyword <keyword>', 'Keywords for the project')
+    .requiredOption('--lang <lang>', 'Story language')
+    .option('--promptId <promptId>', 'Custom Prompt ID from custom-prompts (optional)')
+    .option('--objects <objects...>', 'List of specific objects to include as JSON strings (optional)')
     .action(async (options) => {
         try {
             let parsedObjects = [];
@@ -270,15 +270,15 @@ program
 program
     .command('create-project')
     .description('Create a new project')
-    .requiredOption('-n, --name <name>', 'Project name')
-    .requiredOption('-k, --keyword <keyword>', 'Keyword')
-    .requiredOption('-d, --desc <desc>', 'Description')
-    .requiredOption('-l, --lang <lang>', 'Story language')
-    .option('-s, --sound <sound>', 'Sound effects (true/false)', 'true')
-    .requiredOption('-m, --material <material>', 'Image material')
-    .option('-c, --chapters <count>', 'Number of chapters', '1')
-    .option('-C, --customPromptId <customPromptId>', 'Custom Prompt ID')
-    .option('-O, --objects <objects...>', 'List of specific objects for the project as JSON strings (optional)')
+    .requiredOption('--name <name>', 'Project name')
+    .requiredOption('--keyword <keyword>', 'Keyword')
+    .requiredOption('--desc <desc>', 'Description')
+    .requiredOption('--lang <lang>', 'Story language')
+    .option('--sound <sound>', 'Sound effects (true/false)', 'true')
+    .requiredOption('--material <material>', 'Image material')
+    .option('--chapters <count>', 'Number of chapters', '1')
+    .option('--customPromptId <customPromptId>', 'Custom Prompt ID')
+    .option('--objects <objects...>', 'List of specific objects for the project as JSON strings (optional)')
     .action(async (options) => {
         try {
             let parsedObjects = [];
@@ -325,7 +325,7 @@ program
 program
     .command('recent-chapters')
     .description('Get recently created or updated chapters')
-    .option('-l, --limit <limit>', 'Maximum number of recent chapters to return', '10')
+    .option('--limit <limit>', 'Maximum number of recent chapters to return', '10')
     .action(async (options) => {
         try {
             const data = await api.get(`/app/chapter/recent-chapters?limit=${options.limit}`);
@@ -338,9 +338,9 @@ program
 program
     .command('create-chapter-content')
     .description('Generate content for a specific chapter. This is a synchronous AI generation call — use the returned chapterContent directly.')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .option('-s, --scenes <count>', 'Number of scenes', '1')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .option('--scenes <count>', 'Number of scenes', '1')
     .action(async (options) => {
         try {
             const payload = {
@@ -399,10 +399,10 @@ program
 program
     .command('edit-character')
     .description('Update a character\'s description or edit their generated image directly via AI prompt')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --character <character>', 'Character ID (e.g., drelenavance)')
-    .requiredOption('-u, --userprompt <userprompt>', 'User instruction to modify the character')
-    .option('-e, --editimage', 'Enable direct Image Editing Mode (true). Default is Regenerate Profile Mode (false)', false)
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--character <character>', 'Character ID (e.g., drelenavance)')
+    .requiredOption('--userprompt <userprompt>', 'User instruction to modify the character')
+    .option('--editimage', 'Enable direct Image Editing Mode (true). Default is Regenerate Profile Mode (false)', false)
     .option('--flowkey', 'Enable useFlowKey to sync context via FireBase', true)
     .action(async (options) => {
         try {
@@ -463,8 +463,8 @@ program
 program
     .command('scene-status')
     .description('Get scene status snapshot by chapter (with embedded asset URLs)')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
     .action(async (options) => {
         try {
             const data = await api.get(`/app/scene-status/${options.project}/${options.chapter}`);
@@ -530,8 +530,8 @@ program
 program
     .command('workflow-status')
     .description('Export workflow snapshot for a project/chapter with embedded asset URLs (agent helper)')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
     .action(async (options) => {
         try {
             const data = await api.get(`/app/workflow-status/${options.project}/${options.chapter}`);
@@ -627,8 +627,8 @@ program
 program
     .command('scene-materialization-status')
     .description('Check how many scenes have been materialized for a chapter')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
     .action(async (options) => {
         try {
             // Get chapter data to determine expected scenes
@@ -662,9 +662,9 @@ program
 program
     .command('create-scene')
     .description('Create a new scene from text content')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-C, --content <content...>', 'Array of scene text scripts')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--content <content...>', 'Array of scene text scripts')
     .option('--flowkey', 'Enable useFlowKey to sync context via FireBase', false)
     .action(async (options) => {
         try {
@@ -684,11 +684,11 @@ program
 program
     .command('add-scene')
     .description('Add a new scene to a chapter with a user prompt')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-u, --userprompt <userPrompt>', 'User narrative prompt for the new scene')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--userprompt <userPrompt>', 'User narrative prompt for the new scene')
     .option('--no-regenerate-image', 'Skip automatic image regeneration after creation')
-    .option('-A, --after-scene-id <afterSceneId>', 'Scene ID to insert after (appends to end if omitted)')
+    .option('--after-scene-id <afterSceneId>', 'Scene ID to insert after (appends to end if omitted)')
     .action(async (options) => {
         try {
             const payload = {
@@ -708,12 +708,12 @@ program
 program
     .command('edit-scene')
     .description('Edit an existing scene (image prompt) via AI assistance')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-s, --scene <scene>', 'Scene ID')
-    .requiredOption('-u, --userprompt <userprompt>', 'User narrative prompt to modify the scene')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--scene <scene>', 'Scene ID')
+    .requiredOption('--userprompt <userprompt>', 'User narrative prompt to modify the scene')
     .option('--no-regenerate', 'Tells backend to NOT automatically trigger regenerating the image')
-    .option('-R, --request <request>', 'Target a specific past Request ID to edit its output')
+    .option('--request <request>', 'Target a specific past Request ID to edit its output')
     .action(async (options) => {
         try {
             const payload = {
@@ -736,15 +736,15 @@ program
 program
     .command('request')
     .description('Create a job request (GENERATE_IMAGES, GENERATE_VIDEO)')
-    .requiredOption('-t, --type <type>', 'Request type (e.g., GENERATE_IMAGES, GENERATE_VIDEO)')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-s, --scene <scene>', 'Scene ID')
-    .option('-o, --orientation <orientation>', 'Request orientation (HORIZONTAL, VERTICAL)')
-    .option('-i, --imagemodel <imagemodel>', 'Image Model (imagen3.5)', 'imagen3.5')
-    .option('-v, --videomodel <videomodel>', 'Video Model (veo_3_1_fast, veo_3_1_fast_r2v). Default: veo_3_1_fast', 'veo_3_1_fast')
-    .option('-S, --speed <speed>', 'Video Speed (normal, timelapse, slowmotion)', 'normal')
-    .option('-E, --endscene <endscene>', 'End Scene ID for continuous video generation')
+    .requiredOption('--type <type>', 'Request type (e.g., GENERATE_IMAGES, GENERATE_VIDEO)')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--scene <scene>', 'Scene ID')
+    .option('--orientation <orientation>', 'Request orientation (HORIZONTAL, VERTICAL)')
+    .option('--imagemodel <imagemodel>', 'Image Model (imagen3.5)', 'imagen3.5')
+    .option('--videomodel <videomodel>', 'Video Model (veo_3_1_fast, veo_3_1_fast_r2v). Default: veo_3_1_fast', 'veo_3_1_fast')
+    .option('--speed <speed>', 'Video Speed (normal, timelapse, slowmotion)', 'normal')
+    .option('--endscene <endscene>', 'End Scene ID for continuous video generation')
     .action(async (options) => {
         try {
             const payload = {
@@ -808,10 +808,10 @@ program
 program
     .command('requests')
     .description('Get generation requests/jobs status for the current user')
-    .option('-n, --limit <n>', 'Return only the N most recent requests', null)
-    .option('-p, --project <projectId>', 'Filter by project ID')
-    .option('-c, --chapter <chapterId>', 'Filter by chapter ID')
-    .option('-s, --status <status>', 'Filter by status (e.g. COMPLETED, FAILED, PROCESSING)')
+    .option('--limit <n>', 'Return only the N most recent requests', null)
+    .option('--project <projectId>', 'Filter by project ID')
+    .option('--chapter <chapterId>', 'Filter by chapter ID')
+    .option('--status <status>', 'Filter by status (e.g. COMPLETED, FAILED, PROCESSING)')
     .action(async (options) => {
         try {
             const data = await api.get('/app/requests');
@@ -864,8 +864,8 @@ program
 program
     .command('failed-requests')
     .description('List failed requests for a project/chapter (agent helper)')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .option('-c, --chapter <chapter>', 'Chapter ID')
+    .requiredOption('--project <project>', 'Project ID')
+    .option('--chapter <chapter>', 'Chapter ID')
     .action(async (options) => {
         try {
             const all = unwrapData(await api.get('/app/requests'));
@@ -885,10 +885,10 @@ program
 program
     .command('wait-images')
     .description('Wait until all image requests in a chapter finish')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .option('-i, --interval <sec>', 'Polling interval in seconds', '10')
-    .option('-t, --timeout <sec>', 'Timeout in seconds', '1800')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .option('--interval <sec>', 'Polling interval in seconds', '10')
+    .option('--timeout <sec>', 'Timeout in seconds', '1800')
     .option('--require-success', 'Exit non-zero if any scene lacks a successful image asset')
     .action(async (options) => {
         const intervalMs = Math.max(1, Number(options.interval || 10)) * 1000;
@@ -942,10 +942,10 @@ program
 program
     .command('wait-videos')
     .description('Wait until all video requests in a chapter finish')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .option('-i, --interval <sec>', 'Polling interval in seconds', '10')
-    .option('-t, --timeout <sec>', 'Timeout in seconds', '3600')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .option('--interval <sec>', 'Polling interval in seconds', '10')
+    .option('--timeout <sec>', 'Timeout in seconds', '3600')
     .option('--require-success', 'Exit non-zero if any scene lacks a successful video asset')
     .action(async (options) => {
         const intervalMs = Math.max(1, Number(options.interval || 10)) * 1000;
@@ -1023,11 +1023,11 @@ program
 program
     .command('upscale')
     .description('Upscale video output for a specific scene (shortcut for scene upscale endpoint)')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-s, --scene <scene>', 'Scene ID')
-    .option('-o, --orientation <orientation>', 'Orientation (VERTICAL, HORIZONTAL)', 'VERTICAL')
-    .option('-r, --resolution <resolution>', 'Target resolution (e.g., VIDEO_RESOLUTION_4K)', 'VIDEO_RESOLUTION_4K')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--scene <scene>', 'Scene ID')
+    .option('--orientation <orientation>', 'Orientation (VERTICAL, HORIZONTAL)', 'VERTICAL')
+    .option('--resolution <resolution>', 'Target resolution (e.g., VIDEO_RESOLUTION_4K)', 'VIDEO_RESOLUTION_4K')
     .action(async (options) => {
         try {
             const payload = {
@@ -1042,13 +1042,49 @@ program
         }
     });
 
+program
+    .command('download-upscale')
+    .description('Download upscaled video for a specific scene')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--scene <scene>', 'Scene ID')
+    .option('--orientation <orientation>', 'Orientation (vertical, horizontal)', 'vertical')
+    .option('--out <out>', 'Output file path (default: upscaled_<sceneId>_<orientation>.mp4)')
+    .action(async (options) => {
+        try {
+            const orientation = String(options.orientation || 'vertical').toLowerCase();
+            const data = await api.get(`/app/scene/flow-media/${options.project}/${options.chapter}/${options.scene}/${orientation}`);
+            const flowMedia = unwrapData(data);
+
+            if (!flowMedia?.video?.encodedVideo) {
+                console.log(JSON.stringify({ status: "error", message: "No upscaled video found. Run 'veogent upscale' first." }));
+                return;
+            }
+
+            const fs = await import('fs');
+            const path = await import('path');
+            const outFile = options.out || `upscaled_${options.scene}_${orientation}.mp4`;
+            const videoBuffer = Buffer.from(flowMedia.video.encodedVideo, 'base64');
+            fs.writeFileSync(path.resolve(outFile), videoBuffer);
+
+            console.log(JSON.stringify({
+                status: "success",
+                file: path.resolve(outFile),
+                size: `${(videoBuffer.length / 1024 / 1024).toFixed(1)} MB`,
+                orientation,
+            }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+        }
+    });
+
 // --- YouTube Metadata & Thumbnails ---
 program
     .command('generate-yt-metadata')
     .description('Generate YouTube metadata (Title, Description, Tags) for a chapter')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-l, --lang <lang>', 'Story language')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--lang <lang>', 'Story language')
     .action(async (options) => {
         try {
             const payload = {
@@ -1066,9 +1102,9 @@ program
 program
     .command('generate-yt-thumbnail')
     .description('Triggers a request to generate a YouTube thumbnail for a chapter')
-    .requiredOption('-p, --project <project>', 'Project ID')
-    .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
-    .requiredOption('-l, --lang <lang>', 'Story language')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--lang <lang>', 'Story language')
     .action(async (options) => {
         try {
             const payload = {
@@ -1099,12 +1135,12 @@ program
 program
     .command('gen-image')
     .description('Generate an image from a text prompt (standalone, no project needed). Costs 3 credits. Uses Imagen 3.5.')
-    .requiredOption('-p, --prompt <prompt>', 'Text prompt to generate image from (10-2000 chars)')
-    .option('-n, --negative <negative>', 'Negative prompt — things to avoid')
-    .option('-o, --orientation <orientation>', 'Orientation: HORIZONTAL or VERTICAL', 'HORIZONTAL')
-    .option('-w, --wait', 'Wait for completion (poll until done)', false)
-    .option('-i, --interval <sec>', 'Polling interval in seconds (with --wait)', '5')
-    .option('-t, --timeout <sec>', 'Timeout in seconds (with --wait)', '300')
+    .requiredOption('--prompt <prompt>', 'Text prompt to generate image from (10-2000 chars)')
+    .option('--negative <negative>', 'Negative prompt — things to avoid')
+    .option('--orientation <orientation>', 'Orientation: HORIZONTAL or VERTICAL', 'HORIZONTAL')
+    .option('--wait', 'Wait for completion (poll until done)', false)
+    .option('--interval <sec>', 'Polling interval in seconds (with --wait)', '5')
+    .option('--timeout <sec>', 'Timeout in seconds (with --wait)', '300')
     .action(async (options) => {
         try {
             const payload = {
@@ -1167,13 +1203,13 @@ program
 program
     .command('gen-video')
     .description('Generate a video from a text prompt (standalone, no project needed). Costs 5 credits. Uses Veo 3.1 Fast.')
-    .requiredOption('-p, --prompt <prompt>', 'Text prompt to generate video from (10-2000 chars)')
-    .option('-n, --negative <negative>', 'Negative prompt — things to avoid')
-    .option('-o, --orientation <orientation>', 'Orientation: HORIZONTAL or VERTICAL', 'HORIZONTAL')
-    .option('-r, --reference <imageUri>', 'Reference image URI for image-to-video generation')
-    .option('-w, --wait', 'Wait for completion (poll until done)', false)
-    .option('-i, --interval <sec>', 'Polling interval in seconds (with --wait)', '10')
-    .option('-t, --timeout <sec>', 'Timeout in seconds (with --wait)', '600')
+    .requiredOption('--prompt <prompt>', 'Text prompt to generate video from (10-2000 chars)')
+    .option('--negative <negative>', 'Negative prompt — things to avoid')
+    .option('--orientation <orientation>', 'Orientation: HORIZONTAL or VERTICAL', 'HORIZONTAL')
+    .option('--reference <imageUri>', 'Reference image URI for image-to-video generation')
+    .option('--wait', 'Wait for completion (poll until done)', false)
+    .option('--interval <sec>', 'Polling interval in seconds (with --wait)', '10')
+    .option('--timeout <sec>', 'Timeout in seconds (with --wait)', '600')
     .action(async (options) => {
         try {
             const payload = {
@@ -1237,8 +1273,8 @@ program
 program
     .command('standalone-requests')
     .description('List your standalone image/video generation requests')
-    .option('-n, --limit <n>', 'Return only the N most recent', null)
-    .option('-s, --status <status>', 'Filter by status (PENDING, PROCESSING, COMPLETED, FAILED)')
+    .option('--limit <n>', 'Return only the N most recent', null)
+    .option('--status <status>', 'Filter by status (PENDING, PROCESSING, COMPLETED, FAILED)')
     .action(async (options) => {
         try {
             const data = await api.get('/app/standalone/requests');
@@ -1333,7 +1369,7 @@ program
 program
     .command('flow-credits')
     .description('Fetch plan and credit info from Google AI Sandbox using your Flow key (Bearer token)')
-    .option('-f, --flowkey <flowkey>', 'Flow key (ya29. token). If omitted, uses stored flow key from account.')
+    .option('--flowkey <flowkey>', 'Flow key (ya29. token). If omitted, uses stored flow key from account.')
     .action(async (options) => {
         try {
             // Determine which flow key to use

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veogent",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "The official CLI to interact with the VEOGENT API - AI Video and Image generation platform",
   "main": "index.js",
   "bin": {