veogent 1.3.0 → 1.4.0

package/index.js

@@ -201,13 +201,12 @@ program
         }
     });
 
-// [REMOVED v1.3.0] create-project-description — use docs or compound commands instead
 program
     .command('create-project')
-    .description('Create a new project')
+    .description('Create a new project (auto-generates rich description from idea)')
     .requiredOption('--name <name>', 'Project name')
-    .requiredOption('--keyword <keyword>', 'Keyword')
-    .requiredOption('--desc <desc>', 'Description')
+    .requiredOption('--idea <idea>', 'Story idea')
+    .option('--desc <desc>', 'Description (if omitted, auto-generated from idea via AI)')
     .requiredOption('--lang <lang>', 'Story language')
     .option('--sound <sound>', 'Sound effects (true/false)', 'true')
     .requiredOption('--material <material>', 'Image material')
@@ -216,19 +215,32 @@ program
     .option('--objects <objects...>', 'List of specific objects for the project as JSON strings (optional)')
     .action(async (options) => {
         try {
+            // Step 1: Generate rich description from keyword if not provided
+            let description = options.desc;
+            if (!description) {
+                humanLog('📝 Generating description from idea...');
+                const descData = unwrapData(await api.post('/app/description', {
+                    keyword: options.idea,
+                    language: options.lang,
+                }));
+                description = descData?.description || descData?.text || String(descData);
+                humanLog(`✅ Description generated (${description.length} chars)`);
+            }
+
+            // Step 2: Create project with rich description
             let parsedObjects = [];
             if (options.objects && options.objects.length > 0) {
                 try {
                     parsedObjects = options.objects.map(objStr => typeof objStr === 'string' ? JSON.parse(objStr) : objStr);
                 } catch (e) {
-                    throw new Error("Invalid JSON format for --objects. Example: -O '{\"name\":\"Hero\",\"entityType\":\"character\",\"description\":\"desc\",\"file\":\"data:image/jpeg;base64,...\"}'");
+                    throw new Error("Invalid JSON format for --objects.");
                 }
             }
 
             const payload = {
                 projectName: options.name,
-                keyword: options.keyword,
-                description: options.desc,
+                keyword: options.idea,
+                description,
                 storyLanguage: options.lang,
                 soundEffects: options.sound === 'true' || options.sound === true,
                 imageMaterial: options.material,
@@ -238,149 +250,12 @@ program
             if (options.customPromptId) payload.customPromptId = options.customPromptId;
 
             const data = await api.post('/app/project', payload);
-            console.log(JSON.stringify({ status: "success", project: unwrapData(data) }, null, 2));
+            console.log(JSON.stringify({ status: "success", description, project: unwrapData(data) }, null, 2));
         } catch (error) {
             console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
         }
     });
 
-// --- Quick Project (compound: create project + chapter content + scenes + wait) ---
-program
-    .command('quick-project')
-    .description('Create a full project with scenes in one command (create-project → create-chapter-content → create-scene → wait materialization)')
-    .requiredOption('--keyword <keyword>', 'Story keyword/brief')
-    .requiredOption('--lang <lang>', 'Story language (e.g. "Vietnamese", "English")')
-    .requiredOption('--material <material>', 'Image material (e.g. CINEMATIC, PIXAR_3D)')
-    .option('--name <name>', 'Project name (auto-generated from keyword if omitted)')
-    .option('--scenes <count>', 'Number of scenes per chapter', '5')
-    .option('--chapters <count>', 'Number of chapters', '1')
-    .option('--customPromptId <customPromptId>', 'Custom Prompt ID')
-    .option('--objects <objects...>', 'Character objects as JSON strings')
-    .option('--wait', 'Wait for materialization + characters to be ready')
-    .action(async (options) => {
-        try {
-            const results = { steps: [] };
-
-            // Step 1: Generate description
-            humanLog('📝 Step 1/4: Generating project description...');
-            const descData = unwrapData(await api.post('/app/description', {
-                keyword: options.keyword,
-                language: options.lang,
-            }));
-            const description = descData?.description || descData?.text || String(descData);
-            results.steps.push({ step: 'description', status: 'success' });
-
-            // Step 2: Create project
-            humanLog('🎬 Step 2/4: Creating project...');
-            let parsedObjects = [];
-            if (options.objects?.length > 0) {
-                parsedObjects = options.objects.map(o => typeof o === 'string' ? JSON.parse(o) : o);
-            }
-            const projectPayload = {
-                projectName: options.name || options.keyword.slice(0, 50),
-                keyword: options.keyword,
-                description,
-                storyLanguage: options.lang,
-                soundEffects: true,
-                imageMaterial: options.material,
-                numberChapters: parseInt(options.chapters),
-                objects: parsedObjects,
-            };
-            if (options.customPromptId) projectPayload.customPromptId = options.customPromptId;
-
-            const projectData = unwrapData(await api.post('/app/project', projectPayload));
-            const projectId = projectData?.id || projectData?.projectId;
-            if (!projectId) throw new Error('Failed to create project — no ID returned');
-            results.projectId = projectId;
-            results.steps.push({ step: 'create-project', status: 'success', projectId });
-
-            // Get chapter ID
-            const chaptersData = unwrapData(await api.get(`/app/chapters/${projectId}`));
-            const chapters = Array.isArray(chaptersData) ? chaptersData : (chaptersData?.chapters || []);
-            const chapterId = chapters[0]?.id || chapters[0]?.chapterId;
-            if (!chapterId) throw new Error('No chapter found after project creation');
-            results.chapterId = chapterId;
-
-            // Step 3: Create chapter content + scenes
-            humanLog('✍️ Step 3/4: Generating chapter content + creating scenes...');
-            const contentData = unwrapData(await api.post('/app/chapter/content', {
-                project: projectId,
-                chapter: chapterId,
-                numberScene: parseInt(options.scenes),
-            }));
-            let chapterContent = contentData?.chapterContent || contentData?.content || contentData;
-            if (!Array.isArray(chapterContent)) chapterContent = [chapterContent];
-            results.steps.push({ step: 'chapter-content', status: 'success', scenes: chapterContent.length });
-
-            // Create scenes
-            const scenePayload = {
-                project: projectId,
-                chapter: chapterId,
-                chapterContent,
-                useFlowKey: true,
-            };
-            const sceneData = unwrapData(await api.post('/app/scene', scenePayload));
-            results.steps.push({ step: 'create-scenes', status: 'success' });
-
-            // Step 4: Wait for materialization + characters (optional)
-            if (options.wait) {
-                humanLog('⏳ Step 4/4: Waiting for materialization + characters...');
-
-                // Wait materialization
-                const matStart = Date.now();
-                const matTimeout = 600000; // 10 min
-                while (Date.now() - matStart < matTimeout) {
-                    try {
-                        const matData = unwrapData(await api.get(
-                            `/app/scene/materialization-status?projectId=${projectId}&chapterId=${chapterId}`
-                        ));
-                        if (matData?.materialization === 'READY') {
-                            results.steps.push({ step: 'materialization', status: 'success' });
-                            break;
-                        }
-                    } catch { /* retry */ }
-                    await new Promise(r => setTimeout(r, 30000));
-                }
-
-                // Wait characters
-                const charStart = Date.now();
-                const charTimeout = 900000; // 15 min
-                while (Date.now() - charStart < charTimeout) {
-                    try {
-                        const charRaw = unwrapData(await api.get(`/app/characters/${projectId}`));
-                        const chars = Array.isArray(charRaw) ? charRaw : (charRaw?.characters || []);
-                        const allReady = chars.length > 0 && chars.every(c => c?.imageUri || c?.imageUrl || c?.image);
-                        if (allReady) {
-                            results.characters = chars.map(c => ({
-                                id: c?.id, name: c?.name,
-                                imageUri: c?.imageUri || c?.imageUrl || c?.image,
-                            }));
-                            results.steps.push({ step: 'characters', status: 'success', count: chars.length });
-                            break;
-                        }
-                    } catch { /* retry */ }
-                    await new Promise(r => setTimeout(r, 30000));
-                }
-            }
-
-            // Fetch final scene list
-            const finalScenes = unwrapData(await api.get(`/app/scenes/${projectId}/${chapterId}`));
-            const sceneList = (Array.isArray(finalScenes) ? finalScenes : (finalScenes?.scenes || finalScenes?.items || []))
-                .map((s, i) => ({
-                    id: s?.id || s?.sceneId,
-                    displayOrder: s?.displayOrder ?? i,
-                    scriptSegment: s?.scriptSegment || s?.content,
-                    characterNames: (s?.imagePromptJson?.character_names) || [],
-                }));
-            results.scenes = sceneList;
-            results.status = 'success';
-
-            emitJson(results);
-        } catch (error) {
-            emitJson({ status: "error", ...formatCliError(error) });
-        }
-    });
-
 // --- Chapters ---
 program
     .command('chapters <projectId>')
@@ -468,20 +343,57 @@ program
         }
     });
 
+program
+    .command('add-character')
+    .description('Add a new character to a project (does NOT generate image — use generate-character after)')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--name <name>', 'Character name')
+    .option('--type <type>', 'Entity type: character, creature, location, visual_asset, faction, generic_troop', 'character')
+    .action(async (options) => {
+        try {
+            const payload = {
+                name: options.name,
+                entityType: options.type,
+            };
+            const data = await api.post(`/app/character/${options.project}`, payload);
+            console.log(JSON.stringify({ status: "success", character: unwrapData(data) }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+        }
+    });
+
+program
+    .command('generate-character')
+    .description('Generate reference image for a character (first time — no existing image)')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--character <character>', 'Character ID')
+    .requiredOption('--prompt <prompt>', 'Description of the character for image generation')
+    .action(async (options) => {
+        try {
+            const payload = {
+                userPrompt: options.prompt,
+                useFlowKey: true,
+                editImageMode: false,  // false = generate new image (no existing image)
+            };
+            const data = await api.post(`/app/character/${options.project}/${options.character}/update-by-prompt`, payload);
+            console.log(JSON.stringify({ status: "success", character: unwrapData(data) }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+        }
+    });
+
 program
     .command('edit-character')
-    .description('Update a character\'s description or edit their generated image directly via AI prompt')
+    .description('Edit an existing character reference image directly via AI prompt')
     .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)
+    .requiredOption('--character <character>', 'Character ID')
+    .requiredOption('--prompt <prompt>', 'Edit instruction (what to change in the existing image)')
     .action(async (options) => {
         try {
             const payload = {
-                userPrompt: options.userprompt,
-                useFlowKey: options.flowkey === true || options.flowkey === 'true',
-                editImageMode: options.editimage === true,
+                userPrompt: options.prompt,
+                useFlowKey: true,
+                editImageMode: true,  // true = edit existing image directly
             };
             const data = await api.post(`/app/character/${options.project}/${options.character}/update-by-prompt`, payload);
             console.log(JSON.stringify({ status: "success", character: unwrapData(data) }, null, 2));
@@ -740,33 +652,80 @@ program
         }
     });
 
-// [REMOVED v1.3.0] add-scene — use docs or compound commands instead
+program
+    .command('delete-project')
+    .description('⚠️ DANGER: Permanently delete a project and all its data. Requires explicit confirmation.')
+    .requiredOption('--project <project>', 'Project ID to delete')
+    .option('--confirm', 'Skip confirmation prompt (required for agent-safe mode)')
+    .action(async (options) => {
+        try {
+            if (!options.confirm) {
+                // In agent-safe mode, require --confirm flag
+                console.log(JSON.stringify({
+                    status: "error",
+                    code: "CONFIRMATION_REQUIRED",
+                    message: "⚠️ This will PERMANENTLY DELETE the project and all its scenes, characters, images, and videos. Re-run with --confirm to proceed."
+                }));
+                return;
+            }
+            const data = await api.delete(`/app/project/${options.project}`);
+            console.log(JSON.stringify({ status: "success", deleted: options.project, data: unwrapData(data) }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+        }
+    });
+
+program
+    .command('insert-scene')
+    .description('Insert a new scene into an existing chapter (after a specific scene)')
+    .requiredOption('--project <project>', 'Project ID')
+    .requiredOption('--chapter <chapter>', 'Chapter ID')
+    .requiredOption('--prompt <prompt>', 'Scene narrative/script text')
+    .option('--after <sceneId>', 'Insert after this scene ID (appends to end if omitted)')
+    .action(async (options) => {
+        try {
+            const payload = {
+                projectId: options.project,
+                chapterId: options.chapter,
+                userPrompt: options.prompt,
+            };
+            if (options.after) {
+                payload.afterSceneId = options.after;
+            }
+            const data = await api.post('/app/scene', payload);
+            console.log(JSON.stringify({ status: "success", scene: unwrapData(data) }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", ...formatCliError(error) }));
+        }
+    });
+
 program
     .command('edit-scene')
-    .description('Edit an existing scene (image prompt) via AI assistance')
+    .description('Edit scene storyboard/image prompt, or regenerate image with a request ID')
     .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('--request <request>', 'Target a specific past Request ID to edit its output')
-    .option('--wait', 'Wait for image regeneration to complete (only if regenerate is enabled)')
+    .requiredOption('--prompt <prompt>', 'Edit instruction or new scene prompt')
+    .option('--request <requestId>', 'Target a request ID — VEOGENT AI regenerates the scene image')
+    .option('--wait', 'Wait for image regeneration to complete (only with --request)')
     .action(async (options) => {
         try {
+            // Auto-derive regenerate: with --request → regenerate (direct image edit), without → no regenerate (prompt update only)
+            const hasRequest = !!options.request;
             const payload = {
-                userPrompt: options.userprompt,
-                regenerateImage: options.regenerate !== false, 
+                userPrompt: options.prompt,
+                regenerateImage: hasRequest,
             };
 
-            if (options.request) {
+            if (hasRequest) {
                 payload.requestId = options.request;
             }
 
             const data = await api.patch(`/app/scene/script-segment/${options.project}/${options.chapter}/${options.scene}`, payload);
             const result = { status: "success", scene: unwrapData(data) };
 
-            // Wait for image regen if requested
-            if (options.wait && options.regenerate !== false) {
+            // Wait for image regen if requested (only when regenerating via --request)
+            if (options.wait && hasRequest) {
                 humanLog('⏳ Waiting for image regeneration...');
                 const waitResult = await waitForAssets(api, options.project, options.chapter, 'GENERATE_IMAGES', [options.scene]);
                 result.waitResult = waitResult;
@@ -1296,7 +1255,6 @@ program
 // --- System ---
 // NOTE: Standalone commands (gen-image, gen-video, standalone-requests, standalone-request)
 // have been removed in v1.3.0. Use project-scoped workflows instead.
-// For quick generation, use: quick-project --keyword "..." --wait
 
 // --- System ---
 program

package/package.json

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