veogent 1.5.2 → 1.6.0

package/README.md

@@ -98,20 +98,23 @@ veogent create-scene --project <projectId> --chapter <chapterId> \
   --lang English --material CINEMATIC --scenes 5 --wait
 ```
 
-#### Phase 3: Generate Images + Videos
+#### Phase 3: Generate Images + Videos (Async Polling)
 
 ```bash
-# Generate all images
+# 1. Trigger generation (without --wait) to avoid locking your terminal
 veogent batch-request --type GENERATE_IMAGES \
-  --project <projectId> --chapter <chapterId> --all \
-  --orientation VERTICAL --wait
+  --project <projectId> --chapter <chapterId> --all --orientation VERTICAL
 
-# Generate all videos
-veogent batch-request --type GENERATE_VIDEO \
-  --project <projectId> --chapter <chapterId> --all \
-  --orientation VERTICAL --wait
+# 2. Extract `requestId` from the output
+# 3. Poll status asynchronously:
+veogent request-status --id <requestId>
+# ... loop until requestStatus === "COMPLETED"
+
+# Repeat for GENERATE_VIDEO once images are ready
 ```
 
+> **Tip for Agents:** While the `--wait` flag exists, using `request-status` is recommended so you don't lock your main process for the 5-10 minutes it takes to render a video.
+
 #### Phase 4: QA + Fix Loop
 
 ```bash
@@ -187,7 +190,7 @@ veogent request --type GENERATE_VIDEO \
 
 | Command | Description |
 |---------|-------------|
-| `request` | Create a single generation job (`GENERATE_IMAGES` / `GENERATE_VIDEO` / `VIDEO_UPSCALE`) |
+| `request` | Create a single generation job (`GENERATE_IMAGES` / `GENERATE_VIDEO` / `UPSCALE_VIDEO`) |
 | `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) |
@@ -252,7 +255,7 @@ Uses sceneA's image as start frame, sceneB's image as end frame. Both scenes mus
 
 ```bash
 # 1. Trigger upscale
-veogent request --type VIDEO_UPSCALE \
+veogent request --type UPSCALE_VIDEO \
   --project X --chapter Y --scene Z \
   --orientation VERTICAL --resolution VIDEO_RESOLUTION_4K
 

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, 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)')
+    .description('Create a job request (GENERATE_IMAGES, GENERATE_VIDEO, UPSCALE_VIDEO). Use UPSCALE_VIDEO to upscale a rendered video to 4K resolution.')
+    .requiredOption('--type <type>', 'Request type (e.g., GENERATE_IMAGES, GENERATE_VIDEO, UPSCALE_VIDEO)')
     .requiredOption('--project <project>', 'Project ID')
     .requiredOption('--chapter <chapter>', 'Chapter ID')
     .requiredOption('--scene <scene>', 'Scene ID')
@@ -757,7 +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('--resolution <resolution>', 'Resolution for UPSCALE_VIDEO (e.g. VIDEO_RESOLUTION_4K)', 'VIDEO_RESOLUTION_4K')
     .option('--wait', 'Wait for request to complete before returning')
     .action(async (options) => {
         try {
@@ -805,7 +805,7 @@ program
                 payload.orientation = options.orientation || 'HORIZONTAL';
                 payload.imageModel = options.imagemodel;
             }
-            if (['VIDEO_UPSCALE'].includes(options.type)) {
+            if (['UPSCALE_VIDEO'].includes(options.type)) {
                 payload.orientation = options.orientation || 'VERTICAL'; // Upscale defaults to VERTICAL
                 payload.resolution = options.resolution || 'VIDEO_RESOLUTION_4K';
             }
@@ -1059,7 +1059,7 @@ 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.')
+    .description('Get status of a specific request by ID. For GENERATE_VIDEO/GENERATE_IMAGES, falls back to assets endpoint for output URL. UPSCALE_VIDEO output URL is read directly from the request object.')
     .requiredOption('--id <requestId>', 'Request ID to check')
     .action(async (options) => {
         try {
@@ -1078,7 +1078,7 @@ program
             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)
+            // UPSCALE_VIDEO: 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
@@ -1150,7 +1150,7 @@ program
     .option('--out <path>', 'Output file path (default: ./<sceneId>_upscale.mp4)')
     .action(async (options) => {
         try {
-            const orientation = options.orientation.toUpperCase();
+            const orientation = options.orientation.toLowerCase(); // Backend expects lowercase (e.g. 'vertical')
             humanLog(`⏳ Fetching upscaled video from flow-media...`);
 
             const data = await api.get(`/app/scene/flow-media/${options.project}/${options.chapter}/${options.scene}/${orientation}`);

package/package.json

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

package/skills/SKILL.md

@@ -57,15 +57,20 @@ veogent characters <projectId>   # poll until allReady === true
 
 NEVER skip `create-chapter-content` — always let VEOGENT AI generate the storyboard.
 
-### Phase 3: Generate Images + Videos
+### Phase 3: Generate Images + Videos (Async)
 
 ```bash
-veogent batch-request --type GENERATE_IMAGES \
-  --project X --chapter Y --all --orientation VERTICAL --wait
-veogent batch-request --type GENERATE_VIDEO \
-  --project X --chapter Y --all --orientation VERTICAL --wait
+# 1. Trigger batch generation (without --wait)
+veogent batch-request --type GENERATE_IMAGES --project X --chapter Y --all --orientation VERTICAL
+
+# 2. Extract the request IDs from the output
+# 3. Poll their status asynchronously without blocking your main process
+veogent request-status --id <requestId>
+# ... loop until requestStatus === "COMPLETED"
 ```
 
+*Note: You CAN use the `--wait` flag to make the CLI block until finished, but using `request-status` is better for true asynchronous agent pipelines so you don't lock your process.*
+
 ### Phase 4: QA + Fix Loop
 
 ```bash
@@ -200,7 +205,7 @@ Uses sceneA image → sceneB image as start/end frames. Both must have successfu
 
 ```bash
 # 1. Trigger upscale
-veogent request --type VIDEO_UPSCALE \
+veogent request --type UPSCALE_VIDEO \
   --project X --chapter Y --scene Z \
   --orientation VERTICAL --resolution VIDEO_RESOLUTION_4K
 
@@ -237,7 +242,7 @@ veogent download-upscale \
 
 1. Verify auth before any command (`veogent status`).
 2. Wait for character readiness (`allReady`) before requesting images.
-3. Use `--wait` flag on `request`/`batch-request`/`edit-scene` to block until completion.
+3. **Polling vs Blocking:** For true asynchronous workflows, trigger jobs *without* `--wait`, capture the `requestId`, and poll `request-status --id <requestId>`. Only use `--wait` if you are okay with the CLI locking the process for 5-10 minutes.
 4. Use `workflow-status` as the main status view.
 5. Respect queue limits (max 5 concurrent). `queue-status` to check.
 6. **QA image BEFORE video** — bad image = bad video. Each video gen costs 8-10 min.
@@ -379,7 +384,7 @@ veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z \
 
 | Command | Description | Key Options |
 |---------|-------------|-------------|
-| `request` | Single generation job | `--type` (GENERATE_IMAGES, GENERATE_VIDEO, VIDEO_UPSCALE), `--project`, `--chapter`, `--scene`, `--orientation`, `--speed`, `--endscene`, `--resolution` (upscale), `--wait` |
+| `request` | Single generation job | `--type` (GENERATE_IMAGES, GENERATE_VIDEO, UPSCALE_VIDEO), `--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` |