veogent 1.0.21 → 1.0.22

package/index.js

@@ -170,9 +170,9 @@ program
         try {
             const data = await api.get('/app/capabilities');
             const caps = unwrapData(data);
-            emitJson({ data: caps?.imageModels || IMAGE_MODELS });
+            emitJson({ status: 'success', models: caps?.imageModels || IMAGE_MODELS });
         } catch {
-            emitJson({ data: IMAGE_MODELS });
+            emitJson({ status: 'success', models: IMAGE_MODELS });
         }
     });
 
@@ -183,9 +183,9 @@ program
         try {
             const data = await api.get('/app/capabilities');
             const caps = unwrapData(data);
-            emitJson({ data: caps?.videoModels || VIDEO_MODELS });
+            emitJson({ status: 'success', models: caps?.videoModels || VIDEO_MODELS });
         } catch {
-            emitJson({ data: VIDEO_MODELS });
+            emitJson({ status: 'success', models: VIDEO_MODELS });
         }
     });
 
@@ -316,7 +316,7 @@ program
 
 program
     .command('create-chapter-content')
-    .description('Generate content for a specific chapter')
+    .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')
@@ -328,9 +328,15 @@ program
                 numberScene: parseInt(options.scenes),
             };
             const data = await api.post('/app/chapter/content', payload);
-            console.log(JSON.stringify({ status: "success", chapterContent: unwrapData(data) }, null, 2));
+            const raw = unwrapData(data);
+            // Normalize: always return chapterContent as array of strings
+            let chapterContent = raw;
+            if (raw?.chapterContent) chapterContent = raw.chapterContent;
+            else if (raw?.content) chapterContent = raw.content;
+            if (!Array.isArray(chapterContent)) chapterContent = [chapterContent];
+            emitJson({ status: "success", chapterContent });
         } catch (error) {
-            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+            emitJson({ status: "error", ...formatCliError(error) });
         }
     });
 
@@ -338,13 +344,34 @@ program
 // --- Characters ---
 program
     .command('characters <projectId>')
-    .description('Get all characters for a specific project')
+    .description('Get all characters for a specific project (includes readiness info)')
     .action(async (projectId) => {
         try {
             const data = await api.get(`/app/characters/${projectId}`);
-            console.log(JSON.stringify(unwrapData(data), null, 2));
+            const raw = unwrapData(data);
+            const chars = Array.isArray(raw) ? raw : (raw?.characters || raw?.items || []);
+
+            const characters = chars.map((ch) => ({
+                id: ch?.id || ch?.characterId || null,
+                name: ch?.name || ch?.characterName || null,
+                imageUri: ch?.imageUri || ch?.imageUrl || ch?.image || null,
+                ready: !!(ch?.imageUri || ch?.imageUrl || ch?.image),
+                ...ch,
+            }));
+
+            const readyCount = characters.filter((c) => c.ready).length;
+            const result = {
+                status: 'success',
+                characters,
+                characterReadiness: {
+                    total: characters.length,
+                    ready: readyCount,
+                    allReady: characters.length > 0 && readyCount === characters.length,
+                },
+            };
+            emitJson(result);
         } catch (error) {
-            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+            emitJson({ status: "error", ...formatCliError(error) });
         }
     });
 
@@ -414,13 +441,66 @@ program
 
 program
     .command('scene-status')
-    .description('Get scene status snapshot by chapter')
+    .description('Get scene status snapshot by chapter (with embedded asset URLs)')
     .requiredOption('-p, --project <project>', 'Project ID')
     .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
     .action(async (options) => {
         try {
             const data = await api.get(`/app/scene-status/${options.project}/${options.chapter}`);
-            emitJson({ status: 'success', data: unwrapData(data) });
+            const rawData = unwrapData(data);
+
+            // Try to enrich each scene with asset URLs
+            const scenes = Array.isArray(rawData) ? rawData : (rawData?.scenes || rawData?.items || [rawData]);
+            const enriched = await Promise.all(scenes.map(async (scene) => {
+                const sceneId = scene?.id || scene?.sceneId;
+                if (!sceneId) return scene;
+
+                let imageAsset = { status: scene?.imageStatus || null, url: scene?.imageUrl || scene?.imageVerticalUri || scene?.imageHorizontalUri || null };
+                let videoAsset = { status: scene?.videoStatus || null, url: scene?.videoUrl || scene?.videoVerticalUri || scene?.videoHorizontalUri || null };
+
+                // Fetch assets if URLs not already present
+                try {
+                    if (!imageAsset.url) {
+                        const imgData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_IMAGES`));
+                        const imgItems = Array.isArray(imgData) ? imgData : (imgData?.items || []);
+                        const completed = imgItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            imageAsset = {
+                                status: 'COMPLETED',
+                                url: completed?.imageVerticalUri || completed?.imageHorizontalUri || completed?.imageUrl || completed?.outputUrl || null,
+                                createdAt: completed?.createdAt || null,
+                                completedAt: completed?.completedAt || completed?.updatedAt || null,
+                            };
+                        }
+                    }
+                } catch { /* asset fetch optional */ }
+
+                try {
+                    if (!videoAsset.url) {
+                        const vidData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_VIDEO`));
+                        const vidItems = Array.isArray(vidData) ? vidData : (vidData?.items || []);
+                        const completed = vidItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            videoAsset = {
+                                status: 'COMPLETED',
+                                url: completed?.videoVerticalUri || completed?.videoHorizontalUri || completed?.videoUrl || completed?.outputUrl || null,
+                                createdAt: completed?.createdAt || null,
+                                completedAt: completed?.completedAt || completed?.updatedAt || null,
+                            };
+                        }
+                    }
+                } catch { /* asset fetch optional */ }
+
+                return {
+                    sceneId,
+                    displayOrder: scene?.displayOrder ?? null,
+                    image: imageAsset,
+                    video: videoAsset,
+                    raw: scene,
+                };
+            }));
+
+            emitJson({ status: 'success', data: enriched });
         } catch (error) {
             emitJson({ status: 'error', ...formatCliError(error) });
         }
@@ -428,13 +508,49 @@ program
 
 program
     .command('workflow-status')
-    .description('Export workflow snapshot for a project/chapter (agent helper)')
+    .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')
     .action(async (options) => {
         try {
             const data = await api.get(`/app/workflow-status/${options.project}/${options.chapter}`);
-            emitJson({ status: 'success', data: unwrapData(data) });
+            const rawData = unwrapData(data);
+
+            // Enrich scenes with asset URLs
+            const scenes = Array.isArray(rawData?.scenes) ? rawData.scenes : (Array.isArray(rawData) ? rawData : []);
+            const enrichedScenes = await Promise.all(scenes.map(async (scene) => {
+                const sceneId = scene?.id || scene?.sceneId;
+                if (!sceneId) return scene;
+
+                let imageAsset = { status: scene?.imageStatus || null, url: scene?.imageUrl || scene?.imageVerticalUri || scene?.imageHorizontalUri || null };
+                let videoAsset = { status: scene?.videoStatus || null, url: scene?.videoUrl || scene?.videoVerticalUri || scene?.videoHorizontalUri || null };
+
+                try {
+                    if (!imageAsset.url) {
+                        const imgData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_IMAGES`));
+                        const imgItems = Array.isArray(imgData) ? imgData : (imgData?.items || []);
+                        const completed = imgItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            imageAsset = { status: 'COMPLETED', url: completed?.imageVerticalUri || completed?.imageHorizontalUri || completed?.imageUrl || completed?.outputUrl || null };
+                        }
+                    }
+                } catch { /* optional */ }
+
+                try {
+                    if (!videoAsset.url) {
+                        const vidData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_VIDEO`));
+                        const vidItems = Array.isArray(vidData) ? vidData : (vidData?.items || []);
+                        const completed = vidItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            videoAsset = { status: 'COMPLETED', url: completed?.videoVerticalUri || completed?.videoHorizontalUri || completed?.videoUrl || completed?.outputUrl || null };
+                        }
+                    }
+                } catch { /* optional */ }
+
+                return { sceneId, image: imageAsset, video: videoAsset, raw: scene };
+            }));
+
+            emitJson({ status: 'success', data: { ...rawData, scenes: enrichedScenes } });
         } catch (error) {
             // Backward-compatible fallback for old backend
             try {
@@ -451,13 +567,77 @@ program
                     (r?.chapter_id === options.chapter || r?.chapterId === options.chapter)
                 );
 
-                emitJson({ status: 'success', data: { projectId: options.project, chapterId: options.chapter, scenes, requests: chapterRequests } });
+                // Enrich fallback scenes too
+                const enrichedFallback = await Promise.all(scenes.map(async (scene) => {
+                    const sceneId = scene?.id || scene?.sceneId;
+                    if (!sceneId) return scene;
+
+                    let imageAsset = { status: null, url: null };
+                    let videoAsset = { status: null, url: null };
+
+                    try {
+                        const imgData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_IMAGES`));
+                        const imgItems = Array.isArray(imgData) ? imgData : (imgData?.items || []);
+                        const completed = imgItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            imageAsset = { status: 'COMPLETED', url: completed?.imageVerticalUri || completed?.imageHorizontalUri || completed?.imageUrl || null };
+                        }
+                    } catch { /* optional */ }
+
+                    try {
+                        const vidData = unwrapData(await api.get(`/app/request/assets/${options.project}/${options.chapter}/${sceneId}?type=GENERATE_VIDEO`));
+                        const vidItems = Array.isArray(vidData) ? vidData : (vidData?.items || []);
+                        const completed = vidItems.find((r) => String(r?.status || '').toUpperCase() === 'COMPLETED');
+                        if (completed) {
+                            videoAsset = { status: 'COMPLETED', url: completed?.videoVerticalUri || completed?.videoHorizontalUri || completed?.videoUrl || null };
+                        }
+                    } catch { /* optional */ }
+
+                    return { sceneId, image: imageAsset, video: videoAsset, raw: scene };
+                }));
+
+                emitJson({ status: 'success', data: { projectId: options.project, chapterId: options.chapter, scenes: enrichedFallback, requests: chapterRequests } });
             } catch (fallbackError) {
                 emitJson({ status: 'error', ...formatCliError(fallbackError) });
             }
         }
     });
 
+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')
+    .action(async (options) => {
+        try {
+            // Get chapter data to determine expected scenes
+            let expectedScenes = 0;
+            try {
+                const chapterData = unwrapData(await api.get(`/app/chapters/${options.project}`));
+                const chapters = Array.isArray(chapterData) ? chapterData : (chapterData?.chapters || chapterData?.items || []);
+                const chapter = chapters.find((ch) => (ch?.id || ch?.chapterId) === options.chapter);
+                expectedScenes = chapter?.numberScene || chapter?.sceneCount || chapter?.expectedScenes || 0;
+            } catch { /* fallback: expectedScenes stays 0 */ }
+
+            // Get actual scenes
+            const scenesRaw = unwrapData(await api.get(`/app/scenes/${options.project}/${options.chapter}`));
+            const scenes = Array.isArray(scenesRaw) ? scenesRaw : (scenesRaw?.scenes || scenesRaw?.items || []);
+            const materializedScenes = scenes.length;
+
+            // If we couldn't get expectedScenes from chapter, use materialized as fallback
+            if (expectedScenes === 0) expectedScenes = materializedScenes;
+
+            let status;
+            if (materializedScenes === 0) status = 'EMPTY';
+            else if (materializedScenes >= expectedScenes) status = 'READY';
+            else status = 'PROCESSING';
+
+            emitJson({ status: 'success', expectedScenes, materializedScenes, materialization: status });
+        } catch (error) {
+            emitJson({ status: 'error', ...formatCliError(error) });
+        }
+    });
+
 program
     .command('create-scene')
     .description('Create a new scene from text content')
@@ -564,7 +744,13 @@ program
             }
 
             const data = await api.post('/app/request', payload);
-            console.log(JSON.stringify({ status: "success", request: unwrapData(data) }, null, 2));
+            const requestResult = unwrapData(data);
+            // P2-7: Persist endScene metadata when chained video generation
+            if (options.endscene) {
+                requestResult.end_scene_id = options.endscene;
+                requestResult.generationMode = 'CHAINED_VIDEO';
+            }
+            console.log(JSON.stringify({ status: "success", request: requestResult }, null, 2));
         } catch (error) {
             console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
         }
@@ -622,6 +808,7 @@ program
     .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
     .option('-i, --interval <sec>', 'Polling interval in seconds', '10')
     .option('-t, --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;
         const timeoutMs = Math.max(30, Number(options.timeout || 1800)) * 1000;
@@ -640,6 +827,24 @@ program
 
                 const pending = filtered.filter((r) => ['PENDING', 'PROCESSING', 'RUNNING'].includes(String(r?.status || '').toUpperCase()));
                 if (pending.length === 0) {
+                    // --require-success: verify each scene has at least one COMPLETED request with asset URL
+                    if (options.requireSuccess) {
+                        const sceneIds = [...new Set(filtered.map((r) => r?.scene || r?.sceneId).filter(Boolean))];
+                        const failedScenes = [];
+                        for (const sid of sceneIds) {
+                            const sceneReqs = filtered.filter((r) => (r?.scene === sid || r?.sceneId === sid));
+                            const hasSuccess = sceneReqs.some((r) => {
+                                const st = String(r?.status || '').toUpperCase();
+                                const hasUrl = !!(r?.imageVerticalUri || r?.imageHorizontalUri || r?.imageUrl || r?.outputUrl);
+                                return st === 'COMPLETED' && hasUrl;
+                            });
+                            if (!hasSuccess) failedScenes.push(sid);
+                        }
+                        if (failedScenes.length > 0) {
+                            console.log(JSON.stringify({ status: 'error', code: 'ASSETS_NOT_SUCCESS', message: 'Some scenes did not produce successful assets', failedScenes }, null, 2));
+                            process.exit(1);
+                        }
+                    }
                     console.log(JSON.stringify({ status: 'success', data: filtered, message: 'All image requests finished' }, null, 2));
                     return;
                 }
@@ -660,6 +865,7 @@ program
     .requiredOption('-c, --chapter <chapter>', 'Chapter ID')
     .option('-i, --interval <sec>', 'Polling interval in seconds', '10')
     .option('-t, --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;
         const timeoutMs = Math.max(30, Number(options.timeout || 3600)) * 1000;
@@ -678,6 +884,24 @@ program
 
                 const pending = filtered.filter((r) => ['PENDING', 'PROCESSING', 'RUNNING'].includes(String(r?.status || '').toUpperCase()));
                 if (pending.length === 0) {
+                    // --require-success: verify each scene has at least one COMPLETED request with asset URL
+                    if (options.requireSuccess) {
+                        const sceneIds = [...new Set(filtered.map((r) => r?.scene || r?.sceneId).filter(Boolean))];
+                        const failedScenes = [];
+                        for (const sid of sceneIds) {
+                            const sceneReqs = filtered.filter((r) => (r?.scene === sid || r?.sceneId === sid));
+                            const hasSuccess = sceneReqs.some((r) => {
+                                const st = String(r?.status || '').toUpperCase();
+                                const hasUrl = !!(r?.videoVerticalUri || r?.videoHorizontalUri || r?.videoUrl || r?.outputUrl);
+                                return st === 'COMPLETED' && hasUrl;
+                            });
+                            if (!hasSuccess) failedScenes.push(sid);
+                        }
+                        if (failedScenes.length > 0) {
+                            console.log(JSON.stringify({ status: 'error', code: 'ASSETS_NOT_SUCCESS', message: 'Some scenes did not produce successful assets', failedScenes }, null, 2));
+                            process.exit(1);
+                        }
+                    }
                     console.log(JSON.stringify({ status: 'success', data: filtered, message: 'All video requests finished' }, null, 2));
                     return;
                 }
@@ -697,9 +921,21 @@ program
     .action(async (projectId, chapterId, sceneId, type) => {
         try {
             const data = await api.get(`/app/request/assets/${projectId}/${chapterId}/${sceneId}?type=${type}`);
-            console.log(JSON.stringify(unwrapData(data), null, 2));
+            const raw = unwrapData(data);
+            // Enrich with lifecycle metadata
+            const items = Array.isArray(raw) ? raw : (raw?.items || [raw]);
+            const enriched = items.map((r) => ({
+                ...r,
+                createdAt: r?.createdAt || null,
+                startedAt: r?.startedAt || null,
+                updatedAt: r?.updatedAt || null,
+                completedAt: r?.completedAt || null,
+                deducted: r?.deducted ?? null,
+                retryable: typeof r?.retryable === 'boolean' ? r.retryable : (r?.status && ['FAILED', 'ERROR'].includes(String(r.status).toUpperCase())),
+            }));
+            emitJson({ status: 'success', data: enriched });
         } catch (error) {
-            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+            emitJson({ status: "error", ...formatCliError(error) });
         }
     });
 

package/package.json

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