veogent 1.5.0 → 1.5.2

package/README.md

@@ -187,13 +187,15 @@ veogent request --type GENERATE_VIDEO \
 
 | Command | Description |
 |---------|-------------|
-| `request` | Create a single generation job (`GENERATE_IMAGES` / `GENERATE_VIDEO`) |
+| `request` | Create a single generation job (`GENERATE_IMAGES` / `GENERATE_VIDEO` / `VIDEO_UPSCALE`) |
 | `batch-request` | Batch generation for multiple/all scenes (`--all`) |
 | `requests` | List existing generation jobs |
+| `request-status` | Check a specific job by request ID (includes asset URL) |
 | `failed-requests` | List failed requests for a chapter |
 | `wait-images` | Poll until all image jobs finish |
 | `wait-videos` | Poll until all video jobs finish |
 | `queue-status` | Current queue/concurrency status |
+| `download-upscale` | Download 4K upscaled video as `.mp4` (decodes base64 from flow-media) |
 
 ### Monitoring
 
@@ -201,6 +203,7 @@ veogent request --type GENERATE_VIDEO \
 |---------|-------------|
 | `scene-status` | Scene-level image+video status with asset URLs |
 | `workflow-status` | Full snapshot: scenes + requests + assets (best for agents) |
+| `request-status` | Check a specific job by request ID |
 
 ### YouTube
 
@@ -245,6 +248,27 @@ Uses sceneA's image as start frame, sceneB's image as end frame. Both scenes mus
 
 ---
 
+## Video Upscale (4K)
+
+```bash
+# 1. Trigger upscale
+veogent request --type VIDEO_UPSCALE \
+  --project X --chapter Y --scene Z \
+  --orientation VERTICAL --resolution VIDEO_RESOLUTION_4K
+
+# 2. Poll status by request ID
+veogent request-status --id <requestId>
+
+# 3. Download the upscaled video
+veogent download-upscale \
+  --project X --chapter Y --scene Z \
+  --orientation VERTICAL --out ./scene_4k.mp4
+```
+
+> `download-upscale` calls `/app/scene/flow-media`, decodes the base64 `encodedVideo`, and writes a `.mp4` file.
+
+---
+
 ## Concurrency
 
 Maximum **5** concurrent requests. If queue is full (E10071), CLI auto-retries once after 30s.

package/index.js

@@ -747,8 +747,8 @@ program
 // --- Execution Request (Generate Image / Video) ---
 program
     .command('request')
-    .description('Create a job request (GENERATE_IMAGES, GENERATE_VIDEO)')
-    .requiredOption('--type <type>', 'Request type (e.g., GENERATE_IMAGES, GENERATE_VIDEO)')
+    .description('Create a job request (GENERATE_IMAGES, GENERATE_VIDEO, VIDEO_UPSCALE). Use VIDEO_UPSCALE to upscale a rendered video to 4K resolution.')
+    .requiredOption('--type <type>', 'Request type (e.g., GENERATE_IMAGES, GENERATE_VIDEO, VIDEO_UPSCALE)')
     .requiredOption('--project <project>', 'Project ID')
     .requiredOption('--chapter <chapter>', 'Chapter ID')
     .requiredOption('--scene <scene>', 'Scene ID')
@@ -757,6 +757,7 @@ program
     .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')
+    .option('--resolution <resolution>', 'Resolution for VIDEO_UPSCALE (e.g. VIDEO_RESOLUTION_4K)', 'VIDEO_RESOLUTION_4K')
     .option('--wait', 'Wait for request to complete before returning')
     .action(async (options) => {
         try {
@@ -805,7 +806,8 @@ program
                 payload.imageModel = options.imagemodel;
             }
             if (['VIDEO_UPSCALE'].includes(options.type)) {
-                payload.orientation = options.orientation || 'HORIZONTAL'; // Provide fallback
+                payload.orientation = options.orientation || 'VERTICAL'; // Upscale defaults to VERTICAL
+                payload.resolution = options.resolution || 'VIDEO_RESOLUTION_4K';
             }
 
             const data = await api.post('/app/request', payload);
@@ -1055,6 +1057,77 @@ program
         }
     });
 
+program
+    .command('request-status')
+    .description('Get status of a specific request by ID. For GENERATE_VIDEO/GENERATE_IMAGES, falls back to assets endpoint for output URL. VIDEO_UPSCALE output URL is read directly from the request object.')
+    .requiredOption('--id <requestId>', 'Request ID to check')
+    .action(async (options) => {
+        try {
+            const data = await api.get(`/app/standalone/request/${options.id}`);
+            const found = unwrapData(data);
+
+            if (!found) {
+                emitJson({ status: 'error', code: 'REQUEST_NOT_FOUND', message: `No request found with ID: ${options.id}` });
+                return;
+            }
+
+            const requestStatus = String(found?.status || '').toUpperCase();
+            const type = found?.type || null;
+            const projectId = found?.projectId || found?.project_id || null;
+            const chapterId = found?.chapterId || found?.chapter_id || null;
+            const sceneId = found?.sceneId || found?.scene_id || null;
+
+            let imageAsset = { url: found?.imageVerticalUri || found?.imageHorizontalUri || found?.imageUrl || null };
+            // VIDEO_UPSCALE: output URL lives directly on the request object (not in assets endpoint)
+            let videoAsset = { url: found?.videoVerticalUri || found?.videoHorizontalUri || found?.videoUrl || found?.outputUrl || null };
+
+            // For GENERATE_VIDEO only: fallback to assets endpoint if URL not on request object
+            if (type === 'GENERATE_VIDEO' && projectId && chapterId && sceneId && !videoAsset.url) {
+                try {
+                    const assetData = unwrapData(await api.get(`/app/request/assets/${projectId}/${chapterId}/${sceneId}?type=GENERATE_VIDEO`));
+                    const assetItems = Array.isArray(assetData) ? assetData : (assetData?.items || []);
+                    const matched = assetItems.find((a) => a?.id === options.id || a?.requestId === options.id)
+                        || assetItems.find((a) => String(a?.status || '').toUpperCase() === 'COMPLETED');
+                    if (matched) {
+                        videoAsset = { url: matched?.videoVerticalUri || matched?.videoHorizontalUri || matched?.videoUrl || matched?.outputUrl || null };
+                    }
+                } catch { /* asset fetch optional */ }
+            }
+
+            // For image type: fetch asset URL if not present
+            if (type === 'GENERATE_IMAGES' && projectId && chapterId && sceneId && !imageAsset.url) {
+                try {
+                    const assetData = unwrapData(await api.get(`/app/request/assets/${projectId}/${chapterId}/${sceneId}?type=GENERATE_IMAGES`));
+                    const assetItems = Array.isArray(assetData) ? assetData : (assetData?.items || []);
+                    const matched = assetItems.find((a) => a?.id === options.id || a?.requestId === options.id)
+                        || assetItems.find((a) => String(a?.status || '').toUpperCase() === 'COMPLETED');
+                    if (matched) {
+                        imageAsset = { url: matched?.imageVerticalUri || matched?.imageHorizontalUri || matched?.imageUrl || matched?.outputUrl || null };
+                    }
+                } catch { /* asset fetch optional */ }
+            }
+
+            const result = {
+                status: 'success',
+                requestId: found?.id || found?.requestId,
+                type,
+                requestStatus,
+                sceneId,
+                chapterId,
+                projectId,
+                image: imageAsset,
+                video: videoAsset,
+                createdAt: found?.createdAt || found?.created_at || null,
+                completedAt: found?.completedAt || found?.updatedAt || null,
+                raw: found,
+            };
+
+            emitJson(result);
+        } catch (error) {
+            emitJson({ status: 'error', ...formatCliError(error) });
+        }
+    });
+
 program
     .command('queue-status')
     .description('Get current queue/concurrency status for authenticated user')
@@ -1067,6 +1140,41 @@ program
         }
     });
 
+program
+    .command('download-upscale')
+    .description('Download the 4K upscaled video for a scene. Calls /app/scene/flow-media to retrieve the base64-encoded video and saves it as an .mp4 file.')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--scene <scene>', 'Scene ID')
+    .option('--orientation <orientation>', 'Orientation to download (VERTICAL, HORIZONTAL)', 'VERTICAL')
+    .option('--out <path>', 'Output file path (default: ./<sceneId>_upscale.mp4)')
+    .action(async (options) => {
+        try {
+            const orientation = options.orientation.toUpperCase();
+            humanLog(`⏳ Fetching upscaled video from flow-media...`);
+
+            const data = await api.get(`/app/scene/flow-media/${options.project}/${options.chapter}/${options.scene}/${orientation}`);
+            const raw = unwrapData(data);
+
+            // Backend returns { video: { encodedVideo, ... } } or flat { encodedVideo }
+            const encodedVideo = raw?.video?.encodedVideo || raw?.encodedVideo || null;
+
+            if (!encodedVideo) {
+                emitJson({ status: 'error', code: 'NO_VIDEO_DATA', message: 'No encodedVideo in response. The upscale may not be ready yet.', raw });
+                return;
+            }
+
+            const outPath = options.out || `./${options.scene}_upscale.mp4`;
+            const { writeFileSync } = await import('fs');
+            writeFileSync(outPath, Buffer.from(encodedVideo, 'base64'));
+
+            humanLog(`✅ Saved upscaled video to: ${outPath}`);
+            emitJson({ status: 'success', file: outPath, sceneId: options.scene, orientation });
+        } catch (error) {
+            emitJson({ status: 'error', ...formatCliError(error) });
+        }
+    });
+
 program
     .command('failed-requests')
     .description('List failed requests for a project/chapter (agent helper)')

package/package.json

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

package/skills/SKILL.md

@@ -196,6 +196,25 @@ veogent request --type GENERATE_VIDEO --project X --chapter Y --scene sceneA \
 ```
 Uses sceneA image → sceneB image as start/end frames. Both must have successful images. Only `veo_3_1_fast`.
 
+### Video Upscale (4K)
+
+```bash
+# 1. Trigger upscale
+veogent request --type VIDEO_UPSCALE \
+  --project X --chapter Y --scene Z \
+  --orientation VERTICAL --resolution VIDEO_RESOLUTION_4K
+
+# 2. Poll until COMPLETED
+veogent request-status --id <requestId>
+
+# 3. Download the upscaled .mp4 (reads from flow-media, decodes base64)
+veogent download-upscale \
+  --project X --chapter Y --scene Z \
+  --orientation VERTICAL --out ./scene_4k.mp4
+```
+
+> `download-upscale` calls `GET /app/scene/flow-media/{project}/{chapter}/{scene}/{orientation}`, decodes the base64 `encodedVideo` response, and saves it as an `.mp4` file.
+
 ---
 
 ## Monitoring & Status
@@ -205,6 +224,7 @@ Uses sceneA image → sceneB image as start/end frames. Both must have successfu
 | `workflow-status --project X --chapter Y` | Full snapshot: scenes + requests + assets (best for agents) |
 | `scene-status --project X --chapter Y` | Quick image/video status per scene |
 | `requests --project X --limit 10` | Check recent generation jobs |
+| `request-status --id <requestId>` | Check a specific job by request ID (with asset URL) |
 | `failed-requests --project X --chapter Y` | Debug why gen failed |
 | `wait-images --project X --chapter Y --require-success` | Block until all images done |
 | `wait-videos --project X --chapter Y --require-success` | Block until all videos done |
@@ -359,8 +379,9 @@ veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z \
 
 | Command | Description | Key Options |
 |---------|-------------|-------------|
-| `request` | Single generation job | `--type`, `--project`, `--chapter`, `--scene`, `--orientation`, `--speed`, `--endscene`, `--wait` |
+| `request` | Single generation job | `--type` (GENERATE_IMAGES, GENERATE_VIDEO, VIDEO_UPSCALE), `--project`, `--chapter`, `--scene`, `--orientation`, `--speed`, `--endscene`, `--resolution` (upscale), `--wait` |
 | `batch-request` | Batch generation | `--type`, `--project`, `--chapter`, `--all`/`--scenes`, `--orientation`, `--speed`, `--wait` |
+| `download-upscale` | Download 4K upscaled video as .mp4 | `--project`, `--chapter`, `--scene`, `--orientation`, `--out` |
 
 ### Monitoring Commands
 
@@ -369,6 +390,7 @@ veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z \
 | `workflow-status` | Full snapshot (best for agents) | `--project`, `--chapter` |
 | `scene-status` | Per-scene image/video status | `--project`, `--chapter` |
 | `requests` | List generation jobs | `--project`, `--chapter`, `--status`, `--limit` |
+| `request-status` | Check a specific job by ID (with asset URL) | `--id` |
 | `failed-requests` | Failed jobs only | `--project`, `--chapter` |
 | `wait-images` | Poll until images done | `--project`, `--chapter`, `--require-success` |
 | `wait-videos` | Poll until videos done | `--project`, `--chapter`, `--require-success` |