zerocut-cli 0.1.1 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerocut-cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "ZeroCut CLI: AI assistant CLI for creating and editing images/audio/video",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/commands/video.ts

@@ -7,7 +7,27 @@ import { createProgressSpinner } from "../utils/progress";
 export const name = "video";
 export const description = "Video command: create video";
 
+function resolveResultUrl(result: unknown): string | undefined {
+  if (!result || typeof result !== "object") {
+    return undefined;
+  }
+  const record = result as Record<string, unknown>;
+  if (typeof record.url === "string" && record.url.length > 0) {
+    return record.url;
+  }
+  const data = record.data;
+  if (data && typeof data === "object") {
+    const dataRecord = data as Record<string, unknown>;
+    if (typeof dataRecord.url === "string" && dataRecord.url.length > 0) {
+      return dataRecord.url;
+    }
+  }
+  return undefined;
+}
+
 export function register(program: Command): void {
+  const avatarModels = ["zerocut-avatar-1.0", "zerocut-avatar-1.5"] as const;
+  const mvModels = ["zerocut-mv-1.0"] as const;
   const parent = program.command("video").description("Create a new video; requires --prompt");
 
   const allowedTypes = [
@@ -25,6 +45,8 @@ export function register(program: Command): void {
     "sora2-pro",
     "veo3.1",
     "veo3.1-pro",
+    ...avatarModels,
+    ...mvModels,
   ] as const;
 
   async function videoCreateAction(
@@ -68,10 +90,21 @@ export function register(program: Command): void {
     const durationStr = typeof opts.duration === "string" ? opts.duration.trim() : undefined;
     const sourceVideo = typeof opts.sourceVideo === "string" ? opts.sourceVideo.trim() : undefined;
     let duration: number = 0;
+    const durationRange = ((): { min: number; max: number } => {
+      if ((avatarModels as readonly string[]).includes(model)) {
+        return { min: 5, max: 240 };
+      }
+      if ((mvModels as readonly string[]).includes(model)) {
+        return { min: 1, max: 240 };
+      }
+      return { min: 1, max: 16 };
+    })();
     if (durationStr) {
       const n = Number.parseInt(durationStr, 10);
-      if (!Number.isFinite(n) || n < 1 || n > 16) {
-        process.stderr.write("Invalid value for --duration: must be integer 1-16\n");
+      if (!Number.isFinite(n) || n < durationRange.min || n > durationRange.max) {
+        process.stderr.write(
+          `Invalid value for --duration: model ${model} supports integer ${durationRange.min}-${durationRange.max}\n`
+        );
         process.exitCode = 1;
         return;
       }
@@ -119,7 +152,7 @@ export function register(program: Command): void {
     }
     const res = await session.ai.generateVideo({
       prompt,
-      model: model as (typeof allowedTypes)[number],
+      model: model as unknown as Parameters<typeof session.ai.generateVideo>[0]["model"],
       duration: duration || undefined,
       resolution: opts.resolution,
       aspect_ratio: aspectRatio,
@@ -137,11 +170,12 @@ export function register(program: Command): void {
         : undefined,
       onProgress: createProgressSpinner("inferencing"),
     });
+    const initialUrl = resolveResultUrl(res);
     try {
-      if (res?.url) {
-        const tosUrl = await syncToTOS(res.url as string);
+      if (initialUrl) {
+        const tosUrl = await syncToTOS(initialUrl);
         if (tosUrl) {
-          res.url = tosUrl;
+          (res as Record<string, unknown>).url = tosUrl;
         }
       }
     } catch {}
@@ -149,7 +183,15 @@ export function register(program: Command): void {
     const output = typeof opts.output === "string" ? opts.output : undefined;
     if (output) {
       const dir = process.cwd();
-      const url = res.url;
+      const url = resolveResultUrl(res);
+      if (!url) {
+        process.stderr.write(
+          "Cannot save --output because no video URL was returned. Please retry later or run without --output to inspect raw response.\n"
+        );
+        process.exitCode = 1;
+        console.log(res);
+        return;
+      }
       const response = await fetch(url);
       const buffer = Buffer.from(await response.arrayBuffer());
       const filePath = path.resolve(dir, output);
@@ -165,7 +207,10 @@ export function register(program: Command): void {
   // default action on `zerocut video`
   parent
     .option("--prompt <prompt>", "Text prompt for video generation (required)")
-    .option("--duration <duration>", "Video duration in seconds (1-16)")
+    .option(
+      "--duration <duration>",
+      "Video duration in seconds (default models: 1-16, avatar: 5-240, mv: 1-240)"
+    )
     .option("--model <model>", `Video model: ${allowedTypes.join("|")} (default: vidu)`)
     .option("--sourceVideo <video>", "Base video path/url for edit mode (requires --duration 3-10)")
     .option("--seed <seed>", "Random seed")
@@ -184,7 +229,10 @@ export function register(program: Command): void {
     .command("create")
     .description("Create a new video; requires --prompt")
     .option("--prompt <prompt>", "Text prompt for video generation (required)")
-    .option("--duration <duration>", "Video duration in seconds (1-16)")
+    .option(
+      "--duration <duration>",
+      "Video duration in seconds (default models: 1-16, avatar: 5-240, mv: 1-240)"
+    )
     .option("--model <model>", `Video model: ${allowedTypes.join("|")} (default: vidu)`)
     .option("--sourceVideo <video>", "Base video path/url for edit mode (requires --duration 3-10)")
     .option("--seed <seed>", "Random seed")

package/src/skill/SKILL.md

@@ -1,6 +1,11 @@
 ---
 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."
+homepage: "https://github.com/liubei-ai/zerocut-cli"
+source: "https://github.com/liubei-ai/zerocut-cli"
+requires_binaries:
+  - "zerocut-cli"
+  - "npx"
 ---
 
 # ZeroCut CLI Tools
@@ -26,6 +31,32 @@ Invoke this skill when the user asks to:
 - sync local/remote resources into sandbox
 - save generated results to local output files
 
+## Runtime Requirements
+
+- Runtime expects `zerocut-cli` to be available in current environment.
+- If `zerocut-cli` is unavailable, use one of:
+  - `pnpm dlx zerocut-cli help`
+  - `pnpm add -g zerocut-cli && zerocut-cli help`
+  - `npx zerocut-cli help`
+- This skill is instruction-only and relies on the installed CLI binary for actual enforcement.
+
+## Safety Boundaries
+
+- Only sync files or URLs that user explicitly requests for the current task.
+- Never auto-discover, crawl, or fetch unrelated remote URLs.
+- Treat remote resources as untrusted input and pass through CLI validation.
+- Never sync secrets, key files, token files, or unrelated private directories.
+- Keep all output writes in user-requested path or current working directory naming rules.
+- Do not bypass CLI command guards; ffmpeg/pandoc restrictions are enforced by the CLI implementation.
+
+## Credentials And Data Transfer
+
+- Required credential is `apiKey` in local ZeroCut config.
+- If `apiKey` is missing, stop immediately and request OTT token exchange.
+- `TOS` in this document means object storage used by ZeroCut backend for media URLs.
+- No extra credential beyond ZeroCut config is required for normal media sync/download flows.
+- Do not send data to any external service other than endpoints used by configured ZeroCut session.
+
 ## Required Pre-Check
 
 Before every task, the agent must check configuration first:
@@ -73,7 +104,9 @@ 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`
+- unless user specifies aspect ratio, default to `16:9`
 - `--resolution` allowed: `1K|2K|4K`
+- unless user specifies resolution, default to `1K`
 
 ### video
 
@@ -89,7 +122,7 @@ Options:
 
 - `--prompt <prompt>` required
 - `--model <model>`
-- `--duration <seconds>` integer in 1-16
+- `--duration <seconds>` model-dependent integer
 - `--sourceVideo <video>` base video for edit mode
 - `--seed <seed>`
 - `--firstFrame <image>`
@@ -104,13 +137,18 @@ Options:
 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`
+- `--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|zerocut-avatar-1.0|zerocut-avatar-1.5|zerocut-mv-1.0`
+- `--duration` must follow model range:
+  - default models: `1-16`
+  - `zerocut-avatar-1.0` / `zerocut-avatar-1.5`: `5-240`
+  - `zerocut-mv-1.0`: `1-240`
 - `--aspectRatio` allowed: `9:16|16:9|1:1`
+- unless user specifies aspect ratio, default to `16:9`
+- unless user specifies resolution, default to `720p`
 
 Long video guidance:
 
-- if required duration is over 16s, split into multiple video generations (each 1-16s)
+- for default models, if required duration is over 16s, split into multiple generations (each 1-16s)
 - then concatenate clips with ffmpeg
 - example: