veogent 1.1.4 → 1.3.0

package/README.md

@@ -68,19 +68,18 @@ veogent setup-flow --flowkey "ya29.a0AW..." --tier "PAYGATE_TIER_TWO"
 
 | Command | Description |
 |---------|-------------|
-| `capabilities` | Get backend capabilities (models, orientations, speed modes, queue) |
-| `image-models` | List supported image generation models |
-| `video-models` | List supported video generation models |
 | `image-materials` | Get all available Image Material styles (e.g., `CINEMATIC`, `PIXAR_3D`) |
 | `custom-prompts` | Get custom prompt templates and story directives |
 
+> **Removed in v1.3.0:** `capabilities`, `image-models`, `video-models` — hardcoded values are: imagen3.5, veo_3_1_fast/veo_3_1_fast_r2v, HORIZONTAL/VERTICAL
+
 ### Project Management
 
 | Command | Description |
 |---------|-------------|
 | `projects` | List all your available projects |
 | `project <id>` | Get details for a specific project |
-| `create-project-description` | Generate AI description for a new project based on keywords |
+| ~~`create-project-description`~~ | Removed — use `quick-project` instead |
 | `create-project` | Create a new project with name, keywords, material, chapters, objects |
 
 ### Chapters
@@ -104,30 +103,31 @@ veogent setup-flow --flowkey "ya29.a0AW..." --tier "PAYGATE_TIER_TWO"
 |---------|-------------|
 | `scenes <projectId> <chapterId>` | Get all scenes for a chapter |
 | `create-scene` | Create new scene(s) from text content |
-| `add-scene` | Add a single scene to a chapter with a user prompt |
 | `edit-scene` | Edit scene image prompt via AI assistance |
 
+### Compound Commands (v1.3.0+)
+
+| Command | Description |
+|---------|-------------|
+| `quick-project` | Create a full project in one command: description → project → chapter content → scenes → wait materialization + characters |
+| `batch-request` | Create generation jobs for multiple/all scenes at once with `--all` or `--scenes id1,id2,...` |
+
+> **`--wait` flag:** Available on `request`, `batch-request`, `edit-scene`, and `quick-project`. Blocks until the operation completes, so you don't need separate `wait-images`/`wait-videos` calls.
+
 ### Generation Requests (Project-scoped)
 
 > **Clarification:** `request` (singular) = **CREATE** a new job. `requests` (plural) = **LIST** existing jobs.
 
 | Command | Description |
 |---------|-------------|
-| `request` | Create a generation job: `GENERATE_IMAGES`, `GENERATE_VIDEO`, or `VIDEO_UPSCALE` |
+| `request` | Create a generation job: `GENERATE_IMAGES`, `GENERATE_VIDEO`, or `VIDEO_UPSCALE`. Supports `--wait` |
+| `batch-request` | Batch generation for multiple scenes. Supports `--all`, `--wait`, `--concurrency` |
 | `requests` | List generation requests (filterable by project, chapter, status) |
-| `upscale` | Upscale video output for a scene (shortcut for `request --type VIDEO_UPSCALE`) |
-| `assets <projectId> <chapterId> <sceneId> <type>` | Check generated assets history/status for a scene |
 
-### Standalone Generation (No Project Needed)
+### ~~Standalone Generation~~ (Removed in v1.3.0)
 
-> These commands generate images/videos without a project. Ideal for quick one-off generations.
-
-| Command | Description |
-|---------|-------------|
-| `gen-image` | Generate image from text prompt (standalone, 3 credits, Imagen 3.5) |
-| `gen-video` | Generate video from text prompt (standalone, 5 credits, Veo 3.1 Fast) |
-| `standalone-requests` | List your standalone generation requests |
-| `standalone-request <requestId>` | Get details of a specific standalone request |
+> Standalone commands (`gen-image`, `gen-video`, `standalone-requests`, `standalone-request`) have been removed.
+> Use project-scoped workflows for all generation. For quick starts, use `quick-project --wait`.
 
 ### Monitoring & Status
 
@@ -135,7 +135,6 @@ veogent setup-flow --flowkey "ya29.a0AW..." --tier "PAYGATE_TIER_TWO"
 |---------|-------------|
 | `scene-status` | Scene-level status with embedded asset URLs (image + video per scene) |
 | `workflow-status` | Full workflow snapshot: scenes + requests + assets (agent helper) |
-| `scene-materialization-status` | Check how many scenes have materialized for a chapter |
 | `failed-requests` | List failed/error/rejected requests for a project/chapter (agent helper) |
 | `wait-images` | Poll until all image requests in a chapter finish |
 | `wait-videos` | Poll until all video requests in a chapter finish |
@@ -233,18 +232,12 @@ veogent request --type "GENERATE_VIDEO" --project <projectId> --chapter <chapter
 veogent upscale --project <projectId> --chapter <chapterId> --scene <sceneId> --orientation "VERTICAL" --resolution "VIDEO_RESOLUTION_4K"
 ```
 
-### Standalone Generation (No Project)
+### Quick Project (replaces standalone)
 
 ```bash
-# Quick image generation (3 credits)
-veogent gen-image --prompt "A futuristic city at sunset" --orientation "HORIZONTAL"
-
-# Quick video generation (5 credits)
-veogent gen-video --prompt "A cat playing piano" --orientation "HORIZONTAL"
-
-# Check standalone request status
-veogent standalone-requests
-veogent standalone-request <requestId>
+# Create full project + scenes in one command
+veogent quick-project --keyword "A cat playing piano" --lang English \
+  --material CINEMATIC --scenes 1 --wait
 ```
 
 ### Monitoring & Status
@@ -307,14 +300,15 @@ For robust automation:
 - **`request`** — Creates a new generation job (POST). Requires `--type` flag.
 - **`requests`** — Lists existing jobs (GET). Filterable with `--project`, `--chapter`, `--status`, `--limit`.
 
-### Project-scoped vs Standalone Generation
+### Generation Commands
 
-| | Project-scoped | Standalone |
-|---|---|---|
-| **Image** | `request --type GENERATE_IMAGES --project ... --chapter ... --scene ...` | `gen-image --prompt "prompt"` |
-| **Video** | `request --type GENERATE_VIDEO --project ... --chapter ... --scene ...` | `gen-video --prompt "prompt"` |
-| **List** | `requests` | `standalone-requests` |
-| **Detail** | `requests` with filters | `standalone-request <id>` |
+| Task | Command |
+|------|---------|
+| **Single image** | `request --type GENERATE_IMAGES --project ... --chapter ... --scene ... --wait` |
+| **Single video** | `request --type GENERATE_VIDEO --project ... --chapter ... --scene ... --wait` |
+| **All images** | `batch-request --type GENERATE_IMAGES --project ... --chapter ... --all --wait` |
+| **All videos** | `batch-request --type GENERATE_VIDEO --project ... --chapter ... --all --wait` |
+| **Full project** | `quick-project --keyword "..." --lang ... --material ... --scenes 5 --wait` |
 
 ### Status Commands: When to Use Which
 
@@ -328,12 +322,86 @@ For robust automation:
 
 ---
 
+## Video Speed Modes
+
+VEOGENT supports three video speed modes via `--speed` on `request` and `batch-request`:
+
+| Mode | Description | Use case |
+|------|-------------|----------|
+| `normal` | Standard playback speed (default) | Most scenes, dialogue, actions |
+| `timelapse` | Accelerated time compression | Sunrise/sunset, city traffic, cooking montage, cloud movement |
+| `slowmotion` | Slow-motion playback | Impact moments, water splash, dramatic reveal, emotional beats |
+
+```bash
+# Normal speed (default)
+veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z --speed normal
+
+# Timelapse
+veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z --speed timelapse
+
+# Slow motion for dramatic effect
+veogent request --type GENERATE_VIDEO --project X --chapter Y --scene Z --speed slowmotion
+```
+
+> **Tip:** Speed mode affects Veo's generation. Timelapse tends to produce more camera movement and environmental change. Slowmotion emphasizes subject detail and motion blur.
+
+---
+
+## Chained Video Generation (endScene)
+
+Generate continuous video that transitions smoothly from one scene to the next using `--endscene`:
+
+```bash
+veogent request --type GENERATE_VIDEO --project X --chapter Y --scene sceneA \
+  --endscene sceneB --orientation VERTICAL --videomodel veo_3_1_fast
+```
+
+### How it works
+1. Veo uses **sceneA's image** as the starting frame
+2. Veo uses **sceneB's image** as the ending frame
+3. The generated video transitions smoothly between both scenes
+4. Response includes `generationMode: "CHAINED_VIDEO"` and `end_scene_id`
+
+### When to use
+- Scene transitions that need visual continuity (character walks from location A to B)
+- Smooth camera movements between setups
+- Story beats that connect two distinct moments
+
+### Requirements
+- Both sceneA and sceneB must have successful images (matching orientation)
+- Uses the same Flow Key / credit system as regular video generation
+
+---
+
 ## 🤖 For AI Agents
 
 Veogent CLI ships with a comprehensive **[`skills/SKILL.md`](./skills/SKILL.md)** guide optimized for LLM/Coding Agents context processing. It defines exact DTO validations, model enumerations, camera prompting techniques, the full production pipeline, and error handling — everything an agent needs to orchestrate complete projects without hitting `400 Bad Request`.
 
 ### Recommended Agent Workflow (Production)
 
+**Option A: Quick Start (v1.3.0+ compound commands)**
+```bash
+# 1. Create full project in one command (steps 1-6 combined)
+veogent quick-project --keyword "shiba night market" --lang Vietnamese \
+  --material CINEMATIC --scenes 5 --wait
+
+# 2. Generate all images at once
+veogent batch-request --type GENERATE_IMAGES --project X --chapter Y \
+  --all --orientation VERTICAL --wait
+
+# 3. QA images → fix with edit-scene
+veogent edit-scene --project X --chapter Y --scene Z \
+  --userprompt "Mochi walks through the market gate" --wait
+
+# 4. Generate all videos at once
+veogent batch-request --type GENERATE_VIDEO --project X --chapter Y \
+  --all --orientation VERTICAL --wait
+
+# 5. QA videos → fix and regenerate
+```
+
+**Option B: Step-by-step (full control)**
+
 1. Resolve optional IDs first (if missing):
    - `veogent custom-prompts`
    - `veogent image-materials` (default fallback: `CINEMATIC`)
@@ -351,13 +419,12 @@ Veogent CLI ships with a comprehensive **[`skills/SKILL.md`](./skills/SKILL.md)*
    - `veogent scene-materialization-status --project <projectId> --chapter <chapterId>` — verify `status: "READY"`
    - If missing/fail: inspect `veogent requests --limit 20`, recover via `veogent edit-character`.
 8. Generate scene images:
-   - `veogent request --type "GENERATE_IMAGES" ...`
-   - If image is reported wrong, decode image to Base64 and send to AI reviewer for evaluation.
-   - If mismatch persists, fix via:
-     - `veogent edit-scene --userprompt "..."` (prompt refinement), or
-     - `veogent edit-scene --request <requestId> ...` (direct edit on prior generated image)
+   - `veogent request --type "GENERATE_IMAGES" ... --wait`
+   - If image is reported wrong, fix via:
+     - `veogent edit-scene --userprompt "..." --wait` (prompt refinement), or
+     - `veogent edit-scene --request <requestId> ... --wait` (direct edit on prior generated image)
 9. Generate video only after matching-orientation image exists successfully:
-   - `veogent request --type "GENERATE_VIDEO" ...`
+   - `veogent request --type "GENERATE_VIDEO" ... --wait`
 
 > 📖 For the full detailed guide with all commands, options tables, and examples, see **[`skills/SKILL.md`](./skills/SKILL.md)**.