veogent 1.0.4 → 1.0.8

package/index.js

@@ -176,6 +176,19 @@ program
         } catch (error) {}
     });
 
+program
+    .command('recent-chapters')
+    .description('Get recently created or updated chapters')
+    .option('-l, --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}`);
+            console.log(JSON.stringify(data.data || data, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", message: error.message }));
+        }
+    });
+
 program
     .command('create-chapter-content')
     .description('Generate content for a specific chapter')
@@ -231,6 +244,18 @@ program
             console.log(JSON.stringify({ status: "error", message: error.response?.data?.message || error.message }));
         }
     });
+program
+    .command('scenes <projectId> <chapterId>')
+    .description('Get all scenes for a specific chapter')
+    .action(async (projectId, chapterId) => {
+        try {
+            const data = await api.get(`/app/scenes/${projectId}/${chapterId}`);
+            console.log(JSON.stringify(data.data || data, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", message: error.message }));
+        }
+    });
+
 program
     .command('create-scene')
     .description('Create a new scene from text content')
@@ -349,6 +374,59 @@ program
         }
     });
 
+// --- 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')
+    .action(async (options) => {
+        try {
+            const payload = {
+                projectId: options.project,
+                chapterId: options.chapter,
+                storyLanguage: options.lang
+            };
+            const data = await api.post('/app/youtube/metadata/generate', payload);
+            console.log(JSON.stringify({ status: "success", metadata: data.data || data }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", message: error.response?.data?.message || error.message }));
+        }
+    });
+
+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')
+    .action(async (options) => {
+        try {
+            const payload = {
+                projectId: options.project,
+                chapterId: options.chapter,
+                storyLanguage: options.lang
+            };
+            const data = await api.post('/app/youtube/thumbnails/generate', payload);
+            console.log(JSON.stringify({ status: "success", request: data.data || data }, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", message: error.response?.data?.message || error.message }));
+        }
+    });
+
+program
+    .command('yt-thumbnails <projectId> <chapterId>')
+    .description('Get generated YouTube thumbnails for a chapter')
+    .action(async (projectId, chapterId) => {
+        try {
+            const data = await api.get(`/app/youtube/projects/${projectId}/chapters/${chapterId}/thumbnails`);
+            console.log(JSON.stringify(data.data || data, null, 2));
+        } catch (error) {
+            console.log(JSON.stringify({ status: "error", message: error.message }));
+        }
+    });
+
 // --- System ---
 program
     .command('skill')
@@ -374,6 +452,8 @@ Agents **CANNOT** authenticate automatically because \`veogent login\` opens a l
 
 ## 📖 Chapters & Scenes
 *   **List Chapters for a Project:** \`veogent chapters <projectId>\`
+*   **List Recent Chapters globally:** \`veogent recent-chapters -l 5\`
+*   **List Scenes for a Chapter:** \`veogent scenes <projectId> <chapterId>\`
 *   **Create Chapter Content:** \`veogent create-chapter-content -p <projectId> -c <chapterId> -s 5\` (Generates text/story content for 5 scenes)
 *   **Create Scene:** \`veogent create-scene -p <projectId> -c <chapterId> -C <sceneId1> <sceneId2>\`
 
@@ -425,10 +505,20 @@ If a generated image prompt needs adjustment by the AI, use \`veogent edit-scene
 
 *   **List All Generation Requests/Jobs Status:** \`veogent requests\` 
 
-## 💡 Best Practices for AI Agents
-1. **Data Chaining Workflow:** Always use the ID strings from \`veogent projects\` -> pass to \`veogent chapters\` -> extract \`sceneId\` -> pass to \`veogent request <...args>\`.
-2. **Error Handling:** The CLI returns JSON like \`{"status": "error", "message": "..."}\`. Check this before proceeding with the next logic block.
-3. If an API request returns \`400 Bad Request\`, review your flags. You might be sending forbidden options for the requested DTO \`RequestType\`.`;
+## 💡 Best Practices for AI Agents (The VEOGENT Pipeline)
+1. **Step 1: Description First.** Run \`veogent create-project-description\` to flesh out the lore, then use that payload for \`veogent create-project\`.
+2. **Step 2: Chapter & Scene Content.** Run \`veogent create-chapter-content\` to ask the AI for a scene breakdown array. IMMEDIATELY supply that script array to \`veogent create-scene\` (use \`--flowkey\` so Firebase syncs it up).
+3. **Step 3: Await Casting (CRITICAL).** The system will auto-generate characters. Do NOT rush to generate scenes. Use \`veogent characters <projectId>\` repeatedly (polling) until you observe EVERY character object contains an \`imageUri\`. 
+   *(Alternatively, query \`veogent project <projectId>\` and check the \`"progress"\` object. It tracks the status of character generations. If a character hits FAILED, PROCESSING, or PENDING do not spam requests. Wait).*
+4. **Step 4: Generate Images.** Start requesting \`GENERATE_IMAGES\` for the individual scenes in your desired orientation. 
+   *(Anti-Spam Check: Use \`veogent assets <projId> <chapId> <sceneId> <type>\` to check history. IF there is an existing job with \`"status": "PROCESSING"\` or \`"PENDING"\`, YOU MUST WAIT. Do NOT fire another request).*
+    *(Concurrency Limit: The system only allows a maximum of 5 running/processing generation requests at a time globally. If the API responds with a "maximum reached" error, do NOT treat it as a task failure. Simply WAIT and poll until older requests complete).*
+5. **Step 5: Art Directing & QA.** Download/view the generated image/video. If it’s glitched, bad quality, or misaligned with the script: STOP. Use \`veogent edit-scene\` to inject camera angles (Tilt, Wide, Close-up) and text adjustments to fix the prompt, then regenerate it.
+6. **Step 6: Animate.** Once the frame is director-approved, proceed to \`GENERATE_VIDEO\`. 
+   *(CRITICAL RULE: Do NOT generate a video for a scene unless that scene ALREADY has a successfully generated Image in the matching orientation. Ex: To generate a VERTICAL video, a VERTICAL image must exist first).*
+7. **Step 7: YouTube Publishing Assets.** Wrap up the movie by generating metadata (Title, Description, Tags) using \`veogent generate-yt-metadata\` and triggering a thumbnail request via \`veogent generate-yt-thumbnail\`. To retrieve the final Thumbnail image, call \`veogent yt-thumbnails <proj> <chap>\`.
+
+**Error Handling:** The CLI returns JSON like \`{"status": "error", "message": "..."}\`. Check this before proceeding with the next logic block. If an API request returns \`400 Bad Request\`, review your flags.`;
         console.log(skillContent);
     });
 

package/package.json

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