blitzreels 0.1.22 → 0.1.24

package/README.md

@@ -36,7 +36,7 @@ npx blitzreels auth login
 Local repo development:
 
 ```bash
-pnpm --filter blitzreels dev auth login --base-url http://localhost:3000/api/v1
+pnpm --filter blitzreels dev auth login --base-url http://localhost:3100/api/v1
 ```
 
 ## Auth
@@ -80,235 +80,18 @@ For generation jobs, use `GET /generation-jobs/{job_id}` through `client.generat
 An in-progress finalization is protected from concurrent retries; a stale attempt can be reclaimed after five minutes.
 Use the same generation idempotency key only with the original request.
 
-## Commands
+## Choose a workflow
 
-```bash
-blitzreels workspace settings get --json
-blitzreels workspace settings update --name "Creator Studio" --protected-words "Brand,Product"
-
-blitzreels onboarding scan start --website-url "https://example.com" --json
-blitzreels onboarding scan get --run-id RUN_ID --json
-blitzreels onboarding profile get --json
-blitzreels onboarding profile update --brand-name "Creator Studio" --protected-words "Brand,Product"
-blitzreels onboarding logo import --profile-id PROFILE_ID --replace-existing false
-blitzreels onboarding complete --brand-name "Creator Studio" --platforms tiktok,linkedin --save-workspace-icon true --json
-
-blitzreels projects list --status active --json
-blitzreels projects create --name "Launch short" --aspect-ratio 9:16
-blitzreels projects get --project-id PROJECT_ID --json
-blitzreels projects rename --project-id PROJECT_ID --name "New title"
-blitzreels projects update --project-id PROJECT_ID --description "New description"
-blitzreels projects delete --project-id PROJECT_ID --confirm-delete
-
-blitzreels media list --asset-type video --json
-blitzreels media get --asset-id ASSET_ID --json
-blitzreels media verify --asset-id ASSET_ID --json
-blitzreels media download --asset-id ASSET_ID --output ./source.mp4
-blitzreels media delete --asset-id ASSET_ID --confirm-delete \
-  --reason "Remove duplicate upload" --idempotency-key media-delete:ASSET_ID:v1
-blitzreels media delete --search "old upload" --confirm-delete \
-  --reason "Remove obsolete imports" --idempotency-key media-delete:old-upload:v1 \
-  --delete-generated-clips true --delete-linked-projects true
-blitzreels media upload --file ./video.mp4 --timeout-ms 300000 --auto-transcribe true
-blitzreels media import-youtube --url "https://www.youtube.com/watch?v=..."
-blitzreels media rename --asset-id ASSET_ID --name "New media name"
-blitzreels media update --asset-id ASSET_ID --description "B-roll" --folder-id FOLDER_ID
-blitzreels media move --asset-id ASSET_ID --target-folder-id FOLDER_ID
-blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --duration 4
-blitzreels media attach --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --duration 4 \
-  --placement-intent overlay --volume 0.4
-blitzreels media overlay update --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --mute true
-blitzreels media attach --project-id PROJECT_ID --asset-id IMAGE_ID --at 6 --duration 1.6 --position-preset center --position-y -230 --width-px 561 --height-px 212 --animation-preset popIn
-blitzreels media reframe apply --asset-id ASSET_ID --project-id PROJECT_ID \
-  --expected-revision 7 \
-  --replace-timeline-item-id TIMELINE_ITEM_ID \
-  --aspect-ratio 9:16 --content-type-hint podcast --layout-strategy split \
-  --idempotency-key reframe:PROJECT_ID:v1
-blitzreels media reframe status --asset-id ASSET_ID --json
-blitzreels media reframe analyze --asset-id ASSET_ID \
-  --idempotency-key reframe-analysis:ASSET_ID:v1 --json
-blitzreels media reframe get --project-id PROJECT_ID --reframe-id REFRAME_ID --json
-blitzreels media reframe source-update --project-id PROJECT_ID \
-  --reframe-id REFRAME_ID --source-asset-id SOURCE_ASSET_ID \
-  --source-crop-json '{"x":0,"y":0,"width":0.5,"height":1}' \
-  --idempotency-key reframe-source:REFRAME_ID:SOURCE_ASSET_ID:v1 --json
-blitzreels media folders list --json
-blitzreels media folders create --name "B-roll" --icon-type video
-blitzreels media folders rename --folder-id FOLDER_ID --name "New folder name"
-blitzreels media folders update --folder-id FOLDER_ID --parent-folder-id root
-blitzreels media folders delete --folder-id FOLDER_ID --confirm-delete
-
-blitzreels publishing connections list --json
-blitzreels publishing video schedule --video ./launch.mp4 \
-  --targets instagram:INSTAGRAM_CONNECTION_ID,tiktok:TIKTOK_CONNECTION_ID,facebook:FACEBOOK_CONNECTION_ID \
-  --caption "Launch day" --scheduled-for 2030-08-31T22:45:00Z \
-  --tiktok-publish-mode draft
-blitzreels publishing video schedule --media-asset-id VIDEO_ASSET_ID \
-  --targets youtube:YOUTUBE_CONNECTION_ID --title "Launch day" \
-  --scheduled-for 2030-08-31T22:45:00Z --contains-synthetic-media
-blitzreels publishing tiktok schedule --project-id PROJECT_ID --export-id EXPORT_ID \
-  --connection-id TIKTOK_CONNECTION_ID --scheduled-for 2030-08-31T22:45:00Z \
-  --privacy-level SELF_ONLY --consent-accepted
-blitzreels publishing tiktok schedule --images ./01.jpg,./02.webp,./03.jpg \
-  --project-name "Ancient facts slideshow" --connection-id TIKTOK_CONNECTION_ID \
-  --caption "Three facts from the ancient world" --scheduled-for 2030-08-31T22:45:00Z \
-  --privacy-level SELF_ONLY --photo-cover-index 1 --auto-add-music --consent-accepted
-blitzreels publishing tiktok schedule --images ./01.jpg,./02.webp \
-  --connection-id TIKTOK_CONNECTION_ID --scheduled-for 2030-08-31T22:45:00Z \
-  --publish-mode draft
-
-# Uploaded video publishing accepts MP4, MOV, and WebM. Every selected provider
-# is validated atomically before scheduling. A target without a connection ID is
-# resolved automatically when exactly one active account exists.
-# TikTok direct posts require --privacy-level; drafts do not.
-
-# Upload output includes processing_run_id and accepted follow_up intent.
-
-blitzreels clips create --asset-id ASSET_ID --output ./clips
-blitzreels clips create --asset-id ASSET_ID --logo-asset-id LOGO_ASSET_ID --output ./clips --count 5
-blitzreels clips create --asset-id ASSET_ID --layout-mode people_first --content-type-hint podcast
-blitzreels clips create --asset-id ASSET_ID --studio-sound --output ./clips
-blitzreels clips create --youtube-url "https://www.youtube.com/watch?v=..." --name "MKBHD hero loop"
-blitzreels clips get --clip-id CLIP_ID --json
-blitzreels clips wait --clip-id CLIP_ID --json
-blitzreels clips reselect --clip-id CLIP_ID --start-seconds 52 --end-seconds 64 --idempotency-key reselect:CLIP_ID:v1
-blitzreels clips reselect --clip-id CLIP_ID --suggestion-id SUGGESTION_ID
-blitzreels clips reselect --clip-id CLIP_ID --suggestion-id SUGGESTION_ID \
-  --layout-mode people_first --content-type-hint podcast --caption-style-id cinematic-film \
-  --caption-word-reveal-animation fade --caption-max-lines 2 \
-  --caption-words-per-line 8 --caption-page-combine-ms 3000
-blitzreels clips reject --clip-id CLIP_ID --reason "Main speaker cropped out" --idempotency-key review:CLIP_ID:v1
-blitzreels clips repair --clip-id CLIP_ID
-blitzreels clips export --clip-id CLIP_ID
-blitzreels clips attach-export --asset-id ASSET_ID --project-id PROJECT_ID \
-  --export-id EXPORT_ID --confirm-visual-qa --idempotency-key attach:EXPORT_ID:v1
-blitzreels clips promote-export --clip-id CLIP_ID --export-id EXPORT_ID \
-  --confirm-visual-qa --idempotency-key promote:CLIP_ID:EXPORT_ID:v1
-blitzreels clip-batches recover --batch-id BATCH_ID --target-count 10 \
-  --idempotency-key clip-recovery:BATCH_ID:v1
-blitzreels clip-batches get --batch-id BATCH_ID --json
-blitzreels clip-batches wait --batch-id BATCH_ID --json
-blitzreels clip-share-pages publish --asset-id ASSET_ID \
-  --allow-downloads true --idempotency-key clip-share:ASSET_ID:publish:v1
-blitzreels clip-share-pages set-clip-visibility --asset-id ASSET_ID --clip-id CLIP_ID \
-  --visibility hidden --idempotency-key clip-share:CLIP_ID:hidden:v1
-blitzreels clip-share-pages get --asset-id ASSET_ID --json
-
-blitzreels recording-sets create --name "Product demo" --idempotency-key recording-set:create:v1 --json
-blitzreels recording-sets list --status ready --json
-blitzreels recording-sets tracks attach --recording-set-id SET_ID --asset-id CAMERA_ASSET_ID \
-  --role camera --primary --idempotency-key recording-set:camera:v1
-blitzreels recording-sets tracks attach --recording-set-id SET_ID --asset-id SCREEN_ASSET_ID \
-  --role screen --idempotency-key recording-set:screen:v1
-blitzreels recording-sets finalize --recording-set-id SET_ID --idempotency-key recording-set:finalize:v1
-blitzreels recording-sets get --recording-set-id SET_ID --json
-blitzreels recording-sets delete --recording-set-id EMPTY_SET_ID --confirm-delete \
-  --idempotency-key recording-set:delete:v1
-blitzreels recording-sets clips create --recording-set-id SET_ID --max-clip-count 5 \
-  --max-duration 60 \
-  --layout-mode prefer_focus --content-type-hint podcast --caption-theme-id hormozi \
-  --studio-sound \
-  --idempotency-key recording-set:clips:v1
-
-# `clips get|list --json` exposes `layout.segments` with time ranges, panel assets,
-# crops, canvas geometry, and split-only caption placement.
-
-blitzreels characters create --name "Virgile" \
-  --reference-asset-ids CHARACTER_SHEET_ASSET_ID \
-  --primary-reference-asset-id CHARACTER_SHEET_ASSET_ID \
-  --idempotency-key character:virgile:v1
-blitzreels characters list --json
-blitzreels faceless plans create --project-id PROJECT_ID --script-file ./script.txt \
-  --character-ids CHARACTER_ID --video-model seedance-2.0-ref2v \
-  --idempotency-key faceless:PROJECT_ID:v1
-
-blitzreels project inspect --project-id PROJECT_ID --json
-blitzreels project timeline --project-id PROJECT_ID --json
-blitzreels project snapshot --project-id PROJECT_ID --at 00:03
-blitzreels project snapshots --project-id PROJECT_ID --at 00:01,00:03
-
-blitzreels timeline transform --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --position-x 0 --position-y -230 --width-px 561 --height-px 212 --keep-aspect-ratio true
-blitzreels timeline move --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --at 00:06 --layer-index 2
-blitzreels timeline delete --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --auto-pack false
-
-blitzreels effects zoom add --project-id PROJECT_ID --at 9.8 --duration 1.8 --scale-start 1 --scale-end 1.1 --easing easeInOut
-blitzreels effects zoom update --project-id PROJECT_ID --timeline-item-id EFFECT_TIMELINE_ITEM_ID --scale-end 1.1 --easing easeInOut --duration 1.8
-blitzreels effects mask add --project-id PROJECT_ID --settings-json '{"shape":"rounded","size":{"width":0.8,"height":0.8}}'
-blitzreels effects colorgrade update --project-id PROJECT_ID --timeline-item-id EFFECT_TIMELINE_ITEM_ID --settings-json '{"brightness":1.1,"vignetteEnabled":true}'
-
-blitzreels text add --project-id PROJECT_ID --text "Hook" --at 0 --duration 4
-blitzreels text add --project-id PROJECT_ID --text "SERVEURS MCP" --at 24.33 --duration 2.8 --font-family Pacifico --font-size 82 --color "#17FFA6" --background-color "rgba(3,7,18,0.82)" --top "24%"
-blitzreels text list --project-id PROJECT_ID --json
-blitzreels text update --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID --text "New hook" --font-family Inter --font-size 64 --color "#FFFFFF"
-blitzreels text remove --project-id PROJECT_ID --content-item-id CONTENT_ITEM_ID
-
-blitzreels audio search --query "ambient riser" --license cc0 --json
-blitzreels audio import --provider openverse --external-id AUDIO_ID --project-id PROJECT_ID --at 0 --duration 12 --volume 0.03
-blitzreels audio add --project-id PROJECT_ID --asset-id ASSET_ID --at 0 --volume 0.03
-
-blitzreels captions words list --project-id PROJECT_ID --match-text "Supabase" --json
-blitzreels captions words text --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
-blitzreels captions words update --project-id PROJECT_ID --word-id WORD_ID --text "Supabase"
-blitzreels captions words batch-text --project-id PROJECT_ID --updates-json '[{"word_id":"WORD_ID","new_text":"Supabase"}]'
-blitzreels captions words batch-text --project-id PROJECT_ID --updates-file caption-updates.json
-blitzreels captions words style --project-id PROJECT_ID --word-id WORD_ID --font-family Pacifico --color "#17FFA6" --scale 1.45
-blitzreels captions words style --project-id PROJECT_ID --all --style-file caption-word-style.json
-blitzreels captions words emphasis --project-id PROJECT_ID --match-text "MCP" --emphasis true
-blitzreels captions words delete --project-id PROJECT_ID --word-id WORD_ID
-blitzreels captions words merge --project-id PROJECT_ID --word-ids WORD_ID_1,WORD_ID_2 --text "serveurs MCP"
-blitzreels captions words split --project-id PROJECT_ID --word-id WORD_ID --words "serveurs,MCP"
-
-blitzreels silence plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --json
-blitzreels silence plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID \
-  --strategy audio --json > silence-plan.json
-blitzreels silence apply --project-id PROJECT_ID --confirm-preview \
-  --plan-json "$(cat silence-plan.json)"
-blitzreels silence apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --confirm-preview
-
-blitzreels mistakes plan --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --json
-blitzreels mistakes apply --project-id PROJECT_ID --timeline-item-id TIMELINE_ITEM_ID --confirm-preview
-
-blitzreels captions looks list --json
-blitzreels captions look set --project-id PROJECT_ID --look-id editor-premium-lime
-blitzreels captions style update --project-id PROJECT_ID --look-id paper-karaoke --text-stroke-enabled false
-
-blitzreels exports start --project-id PROJECT_ID --cover-frame-seconds 1
-blitzreels exports wait --export-id EXPORT_ID
-blitzreels exports download --export-id EXPORT_ID --output ./short.mp4
-
-blitzreels formats run --format video-model-benchmark \
-  --prompt "A red figure walks toward a circular platform under a deep blue night sky" \
-  --left-model wan-2.1 --right-model krea-wan-14b-t2v --confirm-cost
-blitzreels credits pricing --kind video --json
-blitzreels generate videos --options --json
-blitzreels jobs get --job-id JOB_ID --json
-
-`generate videos --options` is the live model catalog. `seedance-2.5` I2V
-`input_notes` warn that BytePlus rejects human-face stills on `source_image`
-and image references. Character-sheet I2V uses `seedance-2.0-ref2v`. Killing
-the local process does not cancel the remote job; `jobs get` is the status
-surface (SDK `generation.cancel` exists, no `jobs cancel` CLI yet).
-
-blitzreels api docs
-blitzreels api spec
-```
-
-Use `--json` for script and AI-agent workflows.
-Quoted `--prompt` values preserve line breaks.
-Use `credits pricing --kind KIND --json` to load current AI Studio models,
-limits, and credit rates.
-Use `--fields id,name` with `--json` to trim large responses.
-Export status responses include `thumbnail_url`, `thumbnail.frame_seconds`, `thumbnail.rationale`, and first-pass `platform_metadata` suggestions for YouTube, TikTok, and Instagram.
-Onboarding scan responses include `run_id`, `status`, optional `profile`, and `next_actions`; poll the run before completing onboarding. Mutating onboarding commands support `--dry-run`.
+Use `blitzreels <command> --help` or the one-command contract below for exact flags.
+The [generated CLI guide](https://blitzreels.com/cli.md) owns the full command catalog.
 
-Media deletion is a batch operation even for one asset.
-It requires a reason and stable idempotency key, returns impact and partial-failure receipts, and only cascades when requested.
+- Inspect/edit: `projects`, `project`, `timeline`, `captions`, `text`, `audio`, `silence` and `mistakes`.
+- Sources and finished clips: `media`, `clips`, `clip-batches` and `exports`.
+- Generation and continuity: `generate`, `characters` and `story-kits`.
+- Workspace setup: `workspace settings` and `onboarding`.
 
-`media wait --json` reports `skipped_for` when a requested stage does not apply to the asset.
-`project timeline --json` returns normalized top-level `items` in snake_case while retaining legacy `data.items`.
-
-Caption style receipts include `verified`, `effective_settings`, `warnings`, and `cleared_word_overrides`.
-Overlay attach and update accept `volume`; `--mute true` sets it to zero.
+The stored API key selects one workspace; `auth whoami` identifies it.
+Workspace membership listing and account-level switching are not implied by `auth login`.
 
 ## Machine-Readable Contract
 
@@ -341,6 +124,10 @@ blitzreels exports start --project-id PROJECT_ID --idempotency-key export:PROJEC
 
 Reuse a key only with identical inputs. A changed request returns a conflict.
 
+`clips create` selects the source's qualifying clips automatically when `--count` is omitted.
+`--count 1..30` caps created clips; suggestion discovery still scans the source independently of that export cap.
+`--output` downloads every rendered result in automatic mode.
+
 `--dry-run` is available on mutating commands and prints the API request that
 would be made without making the write request. Destructive dry-runs still require
 the same explicit confirmation flags as real destructive commands.
@@ -365,25 +152,7 @@ Set `BLITZREELS_NO_UPDATE_NOTIFIER=1` to disable passive update notices.
 The CLI validates commands and flags before making API calls. Faulty commands
 print the closest known command or flag, then the command-specific usage.
 
-```bash
-blitzreels caption words list --project-id PROJECT_ID
-# Unknown command: caption words list
-# Did you mean?
-#   blitzreels captions words list --project-id ID ...
-```
-
-With `--json`, errors are structured on stderr:
-
-```json
-{
-  "error": {
-    "code": "unknown_flag",
-    "message": "Unknown flag --poject-id for `projects get`.",
-    "suggestions": ["--project-id"],
-    "usage": "blitzreels projects get --project-id ID [--json]"
-  }
-}
-```
+With `--json`, errors are structured on stderr with their code, message, suggestions and usage.
 
 Plan-limit failures use `upgrade_required`, exit code `3`, and include an
 `upgrade_url`. Human output prints the same billing link after the error.
@@ -394,8 +163,6 @@ auth.
 ## Source, releases, and license
 
 The npm package is publicly installable, but its canonical source is private and proprietary.
-Workspace `0.1.18` adds the current generation model catalog and prompt controls.
-It includes the `0.1.12` reusable character commands and faceless-generation character selection.
 
 Admin recovery and other internal operator commands are not part of the public CLI artifact.
 
@@ -403,45 +170,23 @@ Published behavior depends on the installed version; inspect it with `blitzreels
 See `LICENSE` for the package terms.
 
 
-### Generation resolution
+## Generation inputs
 
-REST uses `resolution`; SDK and MCP use `resolution`; CLI uses `--resolution`.
-Omit it (or send null through REST/MCP) to retain the model default.
-`generate images --options --json` and `generate videos --options --json` report
-`parameters.resolution` with `supported`, `values`, `default`, and an unavailable reason.
-`parameters.quality` reports that a separate quality tier is unavailable.
-Unsupported explicit settings return validation errors before generation is queued.
+Discover current models, resolution values/costs and reference limits with:
 
-```sh
-blitzreels generate images --prompt "A futuristic loft" --model fal-ai/nano-banana-pro --resolution 4k
-blitzreels generate videos --prompt "A slow camera pan" --model minimax-h3-max-t2v --resolution 768p
-blitzreels exports start --project-id PROJECT_ID --expected-revision 0 --resolution 4k
+```bash
+blitzreels generate images --options --json
+blitzreels generate videos --options --json
+blitzreels generate voiceovers --options --json
 ```
 
-Nano Banana Pro supports `1k`, `2k`, `4k`; Nano Banana 2 also supports `0.5k`.
-Image options include `credit_cost_by_resolution`; 4k costs twice the model's base credits.
-Seedance 2.5 supports `480p`/`720p`, H3 Max supports `480p`/`768p`, and Kling O3 4K has fixed `4k` output.
-Other video models retain configured provider output and reject explicit resolution selection.
-Project exports support `720p`, `1080p`, and `4k`; clip exports remain `720p`/`1080p`.
-Export resolution changes the output canvas, not the native detail of generated sources.
-
-Generation references use model-specific limits from `generate images --options` and `generate videos --options`.
-Nano Banana 2 and Pro accept 14 images; Seedance 2.0 ref2v accepts 9 images, 3 videos, and 3 audio files
-(12 total); Seedance 2.5 accepts 30 images, 10 videos, and 10 audio files (50 total) through BytePlus.
-A source image counts as the first reference in reference mode. Reference order is preserved; missing,
-wrong-type, duplicate, or excess assets fail instead of being dropped.
-
-Use `--reference-video-asset-id` and `--reference-audio-asset-id` with processed library assets
-(repeatable or comma-separated). Video references guide motion/camera; audio guides speech, sound, or rhythm.
-Seedance 2.0 audio references require an image or video. Seedance 2.5 permits audio-only references.
-Use `--end-frame FILE` or `--end-frame-asset-id ID` alongside a source image for supported first/last-frame models.
-End frames cannot be mixed with reference arrays. Reference images do not lock the exact opening frame.
-
-Omit `--generate-audio` for model behavior; use `--generate-audio` or `--no-generate-audio` for an explicit request.
-Unsupported audio toggles, seeds, negative prompts, and provider overrides fail with model-specific errors.
-`--enhance-prompt` uses BlitzReels model grammar, input roles, bounded image previews, duration, and audio intent.
-Video/audio contents are not inspected by the enhancer. Voice IDs come from `generate voiceovers --options`,
-which includes the provider, names, and previews. Custom voice IDs are not supported by this catalog API.
+- Omitted `--resolution` uses the model default; unsupported explicit settings fail validation.
+- Reference order is preserved. Missing, duplicate, wrong-type or excess assets are rejected.
+- First/last-frame input requires a source image and cannot mix an end frame with reference arrays.
+- Omit `--generate-audio` for model behavior; use its positive/negative form for an explicit choice.
+- `--enhance-prompt` uses model grammar and bounded image previews, not video/audio content inspection.
+- Choose voice IDs from the options catalog, including its provider and preview fields.
+- Export resolution controls output canvas size; it does not add native detail to generated media.
 
 ## Recovery contracts
 

package/dist/command-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+BzD,eAAO,MAAM,aAAa,EAAE,WAAW,EA8BtC,CAAC"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAgCzD,eAAO,MAAM,aAAa,EAAE,WAAW,EA+BtC,CAAC"}

package/dist/command-registry.js

@@ -21,6 +21,7 @@ import { PROJECT_READ_COMMAND_SPECS } from "./commands/project-read.js";
 import { PROJECTS_COMMAND_SPECS } from "./commands/projects.js";
 import { PUBLISHING_COMMAND_SPECS } from "./commands/publishing.js";
 import { RECORDING_SET_COMMAND_SPECS } from "./commands/recording-sets.js";
+import { SERIES_COMMAND_SPECS } from "./commands/series.js";
 import { STOCK_LIBRARY_COMMAND_SPECS } from "./commands/stock-library.js";
 import { STORY_KIT_COMMAND_SPECS } from "./commands/story-kits.js";
 import { SYSTEM_COMMAND_SPECS } from "./commands/system.js";
@@ -50,6 +51,7 @@ export const COMMAND_SPECS = [
     ...EXPORTS_COMMAND_SPECS,
     ...FACELESS_COMMAND_SPECS,
     ...STORY_KIT_COMMAND_SPECS,
+    ...SERIES_COMMAND_SPECS,
     ...FORMATS_COMMAND_SPECS,
     ...GENERATION_COMMAND_SPECS,
     ...JOBS_COMMAND_SPECS,

package/dist/command-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,GAAG,oBAAoB;IACvB,GAAG,kBAAkB;IACrB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,GAAG,sBAAsB;IACzB,GAAG,2BAA2B;IAC9B,GAAG,yBAAyB;IAC5B,GAAG,2BAA2B;IAC9B,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,0BAA0B;IAC7B,GAAG,mBAAmB;IACtB,GAAG,qBAAqB;IACxB,GAAG,2BAA2B;IAC9B,GAAG,8BAA8B;IACjC,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,wBAAwB;IAC3B,GAAG,kBAAkB;IACrB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,iBAAiB;IACpB,GAAG,wBAAwB;CAC5B,CAAC"}
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,GAAG,oBAAoB;IACvB,GAAG,kBAAkB;IACrB,GAAG,wBAAwB;IAC3B,GAAG,uBAAuB;IAC1B,GAAG,sBAAsB;IACzB,GAAG,2BAA2B;IAC9B,GAAG,yBAAyB;IAC5B,GAAG,2BAA2B;IAC9B,GAAG,mBAAmB;IACtB,GAAG,oBAAoB;IACvB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,0BAA0B;IAC7B,GAAG,mBAAmB;IACtB,GAAG,qBAAqB;IACxB,GAAG,2BAA2B;IAC9B,GAAG,8BAA8B;IACjC,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,uBAAuB;IAC1B,GAAG,oBAAoB;IACvB,GAAG,qBAAqB;IACxB,GAAG,wBAAwB;IAC3B,GAAG,kBAAkB;IACrB,GAAG,uBAAuB;IAC1B,GAAG,qBAAqB;IACxB,GAAG,iBAAiB;IACpB,GAAG,wBAAwB;CAC5B,CAAC"}

package/dist/commands/clips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../../src/commands/clips.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../../src/commands/clips.ts"],"names":[],"mappings":"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"}

package/dist/commands/clips.js

@@ -178,8 +178,7 @@ export const CLIPS_COMMAND_SPECS = [
             {
                 name: "count",
                 type: "number",
-                default: 5,
-                description: "Maximum clips created by the batch.",
+                description: "Maximum clips created, 1–30. Omit for automatic selection.",
             },
             {
                 name: "preset",
@@ -206,6 +205,7 @@ export const CLIPS_COMMAND_SPECS = [
                 description: "Maximum complete clip duration in seconds (1–180); no mid-sentence truncation.",
             },
             { name: "caption-theme-id" },
+            { name: "series-id" },
             {
                 name: "studio-sound",
                 type: "boolean",
@@ -1065,6 +1065,7 @@ function buildClipsDryRun({ context, spec, helpers, }) {
                 min_duration_seconds: options.minDurationSeconds,
                 max_duration_seconds: options.maxDurationSeconds,
                 caption_theme_id: options.captionThemeId,
+                series_id: options.seriesId,
                 studio_sound: options.studioSound,
                 create_flow_options: buildClipWorkflowCreateFlowOptions({ options }),
                 branding_options: buildClipWorkflowBrandingOptions({
@@ -1084,7 +1085,9 @@ function buildClipsDryRun({ context, spec, helpers, }) {
             notes: [
                 options.outputDir === null
                     ? "Queues clips through the web app batch pipeline."
-                    : `Downloads up to ${options.count} rendered clips from the web app batch pipeline.`,
+                    : options.count === null
+                        ? "Downloads every rendered clip from the web app batch pipeline."
+                        : `Downloads up to ${options.count} rendered clips from the web app batch pipeline.`,
                 "Caption themes, AI edit, exports, and batch status follow /dashboard/clip defaults.",
             ],
         });
@@ -1225,9 +1228,9 @@ function parseClipWorkflowOptions({ flags, helpers, }) {
         maxDurationSeconds !== null &&
         minDurationSeconds > maxDurationSeconds)
         throw new Error("--min-duration must not exceed --max-duration.");
-    const count = helpers.getNumberFlag({ flags, name: "count" }) ?? 5;
-    if (!Number.isInteger(count) || count < 1 || count > 10) {
-        throw new Error("--count must be an integer between 1 and 10.");
+    const count = helpers.getNumberFlag({ flags, name: "count" }) ?? null;
+    if (count !== null && (!Number.isInteger(count) || count < 1 || count > 30)) {
+        throw new Error("--count must be an integer between 1 and 30.");
     }
     const assetId = helpers.getStringFlag({ flags, name: "asset-id" }) ?? null;
     const youtubeUrl = helpers.getStringFlag({ flags, name: "youtube-url" }) ?? null;
@@ -1241,6 +1244,9 @@ function parseClipWorkflowOptions({ flags, helpers, }) {
         throw new Error("--no-captions is not supported. Clip batches use captions like /dashboard/clip.");
     }
     return {
+        seriesId: parseNullableWorkflowString({
+            value: helpers.getStringFlag({ flags, name: "series-id" }),
+        }),
         source: assetId !== null
             ? {
                 sourceType: "asset",
@@ -1252,7 +1258,9 @@ function parseClipWorkflowOptions({ flags, helpers, }) {
                 assetId: null,
                 youtubeUrl: youtubeUrl ?? "",
             },
-        logoAssetId: helpers.getStringFlag({ flags, name: "logo-asset-id" }) ?? null,
+        logoAssetId: parseNullableWorkflowString({
+            value: helpers.getStringFlag({ flags, name: "logo-asset-id" }),
+        }),
         outputDir: helpers.getStringFlag({ flags, name: "output" }) ?? null,
         count,
         minDurationSeconds,
@@ -1287,7 +1295,9 @@ function normalizeClipPresetId({ value }) {
     throw new Error("--clip-preset-id must be default, formation-clipperz, high-retention, or demo-focus.");
 }
 function parseNullableWorkflowString({ value, }) {
-    if (value === undefined || value === "null") {
+    if (value === undefined)
+        return undefined;
+    if (value === "null") {
         return null;
     }
     const trimmed = value.trim();
@@ -1310,6 +1320,7 @@ async function createClipWorkflow({ context, helpers, }) {
         minDurationSeconds: options.minDurationSeconds,
         maxDurationSeconds: options.maxDurationSeconds,
         captionThemeId: options.captionThemeId,
+        seriesId: options.seriesId,
         studioSound: options.studioSound,
         createFlowOptions: buildClipWorkflowCreateFlowOptions({ options }),
         brandingOptions: buildClipWorkflowBrandingOptions({
@@ -1323,10 +1334,10 @@ async function createClipWorkflow({ context, helpers, }) {
             batch_id: created.batch.batch_id,
             status: created.batch.status,
             preset: options.clipPresetId,
-            caption_theme_id: options.captionThemeId,
+            caption_theme_id: options.captionThemeId ?? null,
             output_dir: null,
             summary: {
-                requested: options.count,
+                requested: options.count ?? created.batch.estimated_clip_count,
                 completed: created.batch.rendered_count,
             },
             clips: [],
@@ -1341,7 +1352,7 @@ async function createClipWorkflow({ context, helpers, }) {
     });
     const renderedClips = readyBatch.batch.clips
         .filter((clip) => clip.status === "rendered" && clip.download_url !== null)
-        .slice(0, options.count);
+        .slice(0, options.count ?? readyBatch.batch.clips.length);
     if (renderedClips.length === 0) {
         throw new Error("Clip batch completed without rendered clips to download.");
     }
@@ -1371,10 +1382,10 @@ async function createClipWorkflow({ context, helpers, }) {
         batch_id: readyBatch.batch.batch_id,
         status: readyBatch.batch.status,
         preset: options.clipPresetId,
-        caption_theme_id: options.captionThemeId,
+        caption_theme_id: options.captionThemeId ?? null,
         output_dir: outputDir,
         summary: {
-            requested: options.count,
+            requested: options.count ?? readyBatch.batch.estimated_clip_count,
             completed: receipts.length,
         },
         clips: receipts,
@@ -1402,6 +1413,8 @@ async function waitForClipBatchEnvelope({ context, helpers, batchId, }) {
     }
 }
 function buildClipWorkflowBrandingOptions({ logoAssetId, }) {
+    if (logoAssetId === undefined)
+        return {};
     return {
         logoOverlayEnabled: logoAssetId !== null,
         logoMediaAssetId: logoAssetId,