veogent 1.1.0 → 1.1.2

package/README.md

@@ -61,7 +61,7 @@ veogent projects
 veogent image-materials
 
 # Create a brand new AI Story Project using your prompt
-veogent create-project -n "Cyberpunk T-Rex" -k "T-rex, Neon, Sci-fi" -d "A massive T-rex walking inside Tokyo" -l "English" -m "CINEMATIC" -c 5
+veogent create-project -n "Cyberpunk T-Rex" -k "T-rex, Neon, Sci-fi" -d "A massive T-rex walking inside Tokyo" -l "English" -m "CINEMATIC" -c 5 -O '{"name":"Hero","entityType":"character","description":"brave knight"}'
 ```
 
 ### 📖 Storyboard, Chapters & Scenes

package/index.js

@@ -242,12 +242,22 @@ program
     .requiredOption('-k, --keyword <keyword>', 'Keywords for the project')
     .requiredOption('-l, --lang <lang>', 'Story language')
     .option('-p, --promptId <promptId>', 'Custom Prompt ID from custom-prompts (optional)')
+    .option('-O, --objects <objects...>', 'List of specific objects to include as JSON strings (optional)')
     .action(async (options) => {
         try {
+            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\":\"brave knight\"}'");
+                }
+            }
+
             const payload = {
                 keywords: options.keyword,
                 language: options.lang,
-                objects: []
+                objects: parsedObjects
             };
             if (options.promptId) payload.customPromptId = options.promptId;
             const data = await api.post('/app/description', payload);
@@ -268,8 +278,18 @@ program
     .requiredOption('-m, --material <material>', 'Image material')
     .option('-c, --chapters <count>', 'Number of chapters', '1')
     .option('-C, --customPromptId <customPromptId>', 'Custom Prompt ID')
+    .option('-O, --objects <objects...>', 'List of specific objects for the project as JSON strings (optional)')
     .action(async (options) => {
         try {
+            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,...\"}'");
+                }
+            }
+
             const payload = {
                 projectName: options.name,
                 keyword: options.keyword,
@@ -278,6 +298,7 @@ program
                 soundEffects: options.sound === 'true' || options.sound === true,
                 imageMaterial: options.material,
                 numberChapters: parseInt(options.chapters),
+                objects: parsedObjects
             };
             if (options.customPromptId) payload.customPromptId = options.customPromptId;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veogent",
-  "version": "1.1.0",
+  "version": "1.1.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

@@ -164,9 +164,15 @@ The `veogent` command-line interface interacts with the **VEOGENT API** for mana
   | `-k, --keyword <keyword>` | ✅ | Keywords for the project |
   | `-l, --lang <lang>` | ✅ | Story language (e.g., `English`, `Vietnamese`) |
   | `-p, --promptId <promptId>` | ❌ | Custom Prompt ID from `custom-prompts` (optional) |
+  | `-O, --objects <objects...>`| ❌ | List of specific objects to include formatted as JSON strings (optional) |
+
+> ℹ️ **Object Structure (`--objects`):**  
+> `[{"name": "Hero", "entityType": "character", "description": "brave knight"}]`
+
 - **Example:**
   ```bash
-  veogent create-project-description -k "T-rex, Neon, Tokyo" -l "English" -p "promptId123"
+  veogent create-project-description -k "T-rex, Neon, Tokyo" -l "English" -p "promptId123" \
+    -O '{"name":"Hero","entityType":"character","description":"brave knight"}'
   ```
 
 ### Skill: `create-project`
@@ -182,11 +188,18 @@ The `veogent` command-line interface interacts with the **VEOGENT API** for mana
   | `-m, --material <material>` | ✅ | Image material (from `image-materials`) | — |
   | `-c, --chapters <count>` | ❌ | Number of chapters | `1` |
   | `-C, --customPromptId <id>` | ❌ | Custom Prompt ID | — |
+  | `-O, --objects <objects...>`| ❌ | List of specific objects for the project formatted as JSON strings | `[]` |
+
+> ℹ️ **Object Structure (`--objects`):**  
+> `[{"name": "Hero", "entityType": "character", "description": "desc", "file": "data:image/jpeg;base64,..."}]`  
+> *(Note: `file` is optional but useful for providing a reference image)*
+
 - **Example:**
   ```bash
   veogent create-project -n "Cyberpunk T-Rex" -k "T-rex, Neon, Sci-fi" \
     -d "A massive T-rex walking inside Tokyo at night..." \
-    -l "English" -m "CINEMATIC" -c 5
+    -l "English" -m "CINEMATIC" -c 5 \
+    -O '{"name":"Hero","entityType":"character","description":"desc","file":"data:image/jpeg;base64,..."}'
   ```
 
 ---
@@ -420,6 +433,8 @@ Beside the main visual description, you **CAN** include minor action description
 - **Description:** Create a generation job request. Supports `GENERATE_IMAGES`, `GENERATE_VIDEO`, and `VIDEO_UPSCALE`.
 - **Guidelines:**
   > ⚠️ **CRITICAL VALIDATION RULES (Strict DTO):** Do not pass unsupported flags for a specific type, or the server will return a `400 Bad Request` or `Validation Error`. The CLI also performs client-side model validation — unsupported models throw `E_IMAGE_MODEL_UNSUPPORTED` / `E_VIDEO_MODEL_UNSUPPORTED`.
+- **Options:**
+  > ℹ️ When `--orientation` include: `HORIZONTAL`, `VERTICAL`
 
 #### 1. Generate Images (`GENERATE_IMAGES`)
 
@@ -430,11 +445,12 @@ Beside the main visual description, you **CAN** include minor action description
 | `-c, --chapter` | ✅ | Chapter ID | — |
 | `-s, --scene` | ✅ | Scene ID | — |
 | `-i, --imagemodel` | ❌ | Image model | `imagen3.5` |
+| `-o, --orientation` | ❌ | Orientation | `HORIZONTAL` |
 
-> 🚫 **Prohibited flags:** Do NOT pass `-o` (orientation), `-v` (videomodel), or `-S` (speed).
+> 🚫 **Prohibited flags:** Do NOT pass `-v` (videomodel), or `-S` (speed).
 
 ```bash
-veogent request -t "GENERATE_IMAGES" -p "projID" -c "chapID" -s "sceneID" -i "imagen3.5"
+veogent request -t "GENERATE_IMAGES" -p "projID" -c "chapID" -s "sceneID" -i "imagen3.5" -o "HORIZONTAL"
 ```
 
 #### 2. Generate Video (`GENERATE_VIDEO`)
@@ -454,6 +470,7 @@ veogent request -t "GENERATE_IMAGES" -p "projID" -c "chapID" -s "sceneID" -i "im
 > ℹ️ `useFlowKey` is **locked natively to `true`** — you must have a valid Flow Key.
 > ℹ️ Only run `GENERATE_VIDEO` **after** the scene already has a successful matching-orientation image.
 > ℹ️ When `-E` (endscene) is set, the response includes `generationMode: "CHAINED_VIDEO"`.
+> ℹ️ When `--speed` include: `normal`, `slowmotion`, `timelapse`
 
 ```bash
 veogent request -t "GENERATE_VIDEO" -p "projID" -c "chapID" -s "sceneA" \