zerocut-cli 0.1.0

package/src/skill/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: "zerocut-cli-tools"
+description: "Use ZeroCut CLI media and document tools. Invoke when user needs generate media, run ffmpeg/pandoc, sync resources, or save outputs."
+---
+
+# ZeroCut CLI Tools
+
+## Purpose
+
+This skill provides a single reference for using ZeroCut CLI commands:
+
+- image generation
+- video generation
+- music generation
+- text-to-speech
+- ffmpeg sandbox execution
+- pandoc sandbox execution
+
+## When To Invoke
+
+Invoke this skill when the user asks to:
+
+- generate image, video, music, or speech audio
+- run ffmpeg or ffprobe command in sandbox
+- run pandoc conversion in sandbox
+- sync local/remote resources into sandbox
+- save generated results to local output files
+
+## Required Pre-Check
+
+Before every task, the agent must check configuration first:
+
+```bash
+npx zerocut-cli config list
+```
+
+If `apiKey` is missing or empty, require user to configure via OTT exchange first:
+
+```bash
+npx zerocut-cli config --ott <token> --region <cn|us>
+```
+
+Notes:
+
+- `region` must be `cn` or `us`
+- OTT exchange writes `apiKey` and `region` into config
+- when running `config key` without direct key, region must be `cn|us` and OTT is required
+
+## Command Reference
+
+### image
+
+Default action: `create`
+
+```bash
+npx zerocut-cli image --prompt "a cat on a bike" --output out.png
+npx zerocut-cli image create --prompt "a cat on a bike" --model seedream-5l --aspectRatio 1:1 --resolution 1K --refs ref1.png,ref2.jpg --output out.png
+```
+
+Options:
+
+- `--prompt <prompt>` required
+- `--model <model>`
+- `--aspectRatio <ratio>`
+- `--resolution <resolution>`
+- `--refs <refs>` comma-separated local paths or URLs
+- `--output <file>` save generated file
+
+Validation rules:
+
+- `--prompt` must be non-empty
+- `--model` allowed: `seedream|seedream-pro|seedream-5l|banana|banana2|banana-pro|wan`
+- `--aspectRatio` allowed: `1:1|3:4|4:3|16:9|9:16|2:3|3:2|21:9|1:4|4:1|1:8|8:1`
+- `--resolution` allowed: `1K|2K|4K`
+
+### video
+
+Default action: `create`
+
+```bash
+npx zerocut-cli video --prompt "city night drive" --model vidu --duration 8 --output out.mp4
+npx zerocut-cli video create --prompt "city night drive" --model vidu --aspectRatio 1:1 --refs ref1.png,ref2.png --output out.mp4
+npx zerocut-cli video --prompt "remix this clip" --model vidu --sourceVideo input.mp4 --duration 6 --output edited.mp4
+```
+
+Options:
+
+- `--prompt <prompt>` required
+- `--model <model>`
+- `--duration <seconds>` integer in 1-16
+- `--sourceVideo <video>` base video for edit mode
+- `--seed <seed>`
+- `--firstFrame <image>`
+- `--lastFrame <image>`
+- `--refs <assets>`
+- `--resolution <resolution>`
+- `--aspectRatio <ratio>`
+- `--withAudio`
+- `--optimizeCameraMotion`
+- `--output <file>`
+
+Validation rules:
+
+- `--prompt` must be non-empty
+- `--model` allowed: `zerocut3.0|seedance-1.5-pro|vidu|vidu-pro|viduq3|viduq3-turbo|kling|kling-v3|wan|wan-flash|sora2|sora2-pro|veo3.1|veo3.1-pro`
+- `--duration` must be integer in `1-16`
+- `--aspectRatio` allowed: `9:16|16:9|1:1`
+
+Long video guidance:
+
+- if required duration is over 16s, split into multiple video generations (each 1-16s)
+- then concatenate clips with ffmpeg
+- example:
+
+```bash
+printf "file 'part1.mp4'\nfile 'part2.mp4'\nfile 'part3.mp4'\n" > concat.txt
+npx zerocut-cli ffmpeg --args -f concat -safe 0 -i concat.txt -c copy final.mp4 --resources concat.txt part1.mp4 part2.mp4 part3.mp4
+```
+
+### music
+
+Default action: `create`
+
+```bash
+npx zerocut-cli music --prompt "lofi beat" --output music.mp3
+npx zerocut-cli music create --prompt "lofi beat" --output music.mp3
+```
+
+Options:
+
+- `--prompt <prompt>` required
+- `--output <file>`
+
+Validation rules:
+
+- `--prompt` must be non-empty
+
+### tts
+
+Default action: `create`
+
+```bash
+npx zerocut-cli tts --text "你好，欢迎使用 ZeroCut" --voiceId voice_xxx --output speech.mp3
+npx zerocut-cli tts create --prompt "calm tone" --text "Hello world" --voiceId voice_xxx --output speech.mp3
+```
+
+Options:
+
+- `--prompt <prompt>`
+- `--text <text>` required
+- `--voiceId <voiceId>`
+- `--output <file>`
+
+Validation rules:
+
+- `--text` must be non-empty
+
+### ffmpeg
+
+```bash
+npx zerocut-cli ffmpeg --args -i input.mp4 -vn output.mp3 --resources input.mp4
+npx zerocut-cli ffmpeg --args -i input.mp4 -vf scale=1280:720 output.mp4 --resources input.mp4
+```
+
+Options:
+
+- `--args <args...>` required, arguments appended after `ffmpeg`
+- `--resources <resources...>` optional, files/URLs to sync into sandbox materials
+
+Behavior:
+
+- `--args` must be provided
+- command prefix is fixed as `ffmpeg`
+- for `ffmpeg`, `-y` is auto-injected when absent
+- output file is auto-downloaded from sandbox to local current directory
+
+### pandoc
+
+```bash
+npx zerocut-cli pandoc --args input.md -o output.pdf --resources input.md
+npx zerocut-cli pandoc --args input.md --output=output.docx --resources input.md template.docx
+```
+
+Options:
+
+- `--args <args...>` required, arguments appended after `pandoc`
+- `--resources <resources...>` optional, files/URLs to sync into sandbox materials
+
+Behavior:
+
+- `--args` must be provided
+- command prefix is fixed as `pandoc`
+- output file is auto-downloaded only when args include `-o`, `--output`, or `--output=...`
+
+## Output And Sync Rules
+
+- Media URLs from generation are synced to TOS when available.
+- `--output` saves files to an absolute path resolved from current working directory.
+- Missing parent directories for `--output` are created automatically.
+- File type constraints:
+  - image output uses `.png`
+  - video output uses `.mp4`
+  - audio output (`music`/`tts`) uses `.mp3`
+- If user does not explicitly provide output file name, agent must generate one in current directory:
+  - use 3-digit incremental prefix to avoid collisions, like `001_...`, `002_...`
+  - keep file name meaningful by task content, e.g. `001_city-night-drive.mp4`, `002_lofi-beat.mp3`
+- ffmpeg and pandoc outputs follow the same naming rule:
+  - if output path is not explicitly specified by user, agent should generate a meaningful file name with `NNN_` prefix and correct extension
+  - for pandoc, keep extension aligned with conversion target format

package/src/types/command.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+
+export interface CommandModule {
+  name: string;
+  description?: string;
+  register: (program: Command) => void;
+}

package/src/utils/progress.ts

@@ -0,0 +1,10 @@
+export function createProgressSpinner(label = "inferencing") {
+  const frames = ["|", "/", "-", "\\"];
+  let si = 0;
+  const t0 = Date.now();
+  return () => {
+    const f = frames[si++ % frames.length];
+    const sec = Math.floor((Date.now() - t0) / 1000);
+    process.stdout.write(`\r${f} ${label}... ${sec}s`);
+  };
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "tests"]
+}
+