zerocut-cli 0.1.0

package/src/commands/music.ts

@@ -0,0 +1,78 @@
+import type { Command } from "commander";
+import { getSessionFromCommand, syncToTOS } from "../services/cerevox";
+import { createProgressSpinner } from "../utils/progress";
+import fs from "node:fs";
+import path from "node:path";
+
+export const name = "music";
+export const description = "Music command: create music";
+
+export function register(program: Command): void {
+  const parent = program.command("music").description("Create a new music; requires --prompt");
+
+  async function musicCreateAction(
+    this: Command,
+    opts: {
+      prompt?: string;
+      output?: string;
+    }
+  ) {
+    const session = getSessionFromCommand(this as unknown as Record<symbol, unknown>);
+    if (!session) {
+      process.stderr.write("No active session\n");
+      return;
+    }
+    const prompt = typeof opts.prompt === "string" ? opts.prompt : undefined;
+    if (!prompt || prompt.trim().length === 0) {
+      process.stderr.write("Missing required option: --prompt\n");
+      process.exitCode = 1;
+      return;
+    }
+    const res = await session.ai.generateMusic({
+      prompt,
+      onProgress: createProgressSpinner("inferencing"),
+    });
+    process.stdout.write("\n");
+    try {
+      if (res?.url) {
+        const tosUrl = await syncToTOS(res.url as string);
+        if (tosUrl) {
+          res.url = tosUrl;
+        }
+      }
+    } catch (ex: unknown) {
+      console.log((ex as Error).message);
+    }
+    const output = typeof opts.output === "string" ? opts.output : undefined;
+    if (output) {
+      const dir = process.cwd();
+      const url = res.url;
+      const response = await fetch(url);
+      const buffer = Buffer.from(await response.arrayBuffer());
+      const filePath = path.resolve(dir, output);
+      if (!fs.existsSync(path.dirname(filePath))) {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+      }
+      fs.writeFileSync(filePath, buffer);
+      res.output = filePath;
+    }
+    console.log({
+      url: res.url,
+      duration: res.duration,
+      usage: res.usage,
+      output: res.output,
+    });
+  }
+
+  parent
+    .option("--prompt <prompt>", "Text prompt for music generation (required)")
+    .option("--output <file>", "Output file path")
+    .action(musicCreateAction);
+
+  parent
+    .command("create")
+    .description("Create a new music; requires --prompt")
+    .option("--prompt <prompt>", "Text prompt for music generation (required)")
+    .option("--output <file>", "Output file path")
+    .action(musicCreateAction);
+}

package/src/commands/pandoc.ts

@@ -0,0 +1,37 @@
+import type { Command } from "commander";
+import { getSessionFromCommand, runPandocCommand } from "../services/cerevox";
+
+export const name = "pandoc";
+export const description = "Run pandoc in sandbox";
+
+export function register(program: Command): void {
+  program
+    .command("pandoc")
+    .description("Run pandoc command in sandbox")
+    .allowUnknownOption(true)
+    .option("--args <args...>", "Arguments passed to pandoc")
+    .option("--resources <resources...>", "Resource files/urls to sync into sandbox")
+    .action(async function (
+      this: Command,
+      opts: {
+        args?: string[];
+        resources?: string[];
+      }
+    ) {
+      const session = getSessionFromCommand(this as unknown as Record<symbol, unknown>);
+      if (!session) {
+        process.stderr.write("No active session\n");
+        return;
+      }
+      const args = Array.isArray(opts.args) ? opts.args : [];
+      if (args.length === 0) {
+        process.stderr.write("Missing required option: --args\n");
+        process.exitCode = 1;
+        return;
+      }
+      const command = `pandoc ${args.join(" ")}`;
+      const resources = Array.isArray(opts.resources) ? opts.resources : [];
+      const res = await runPandocCommand(session, command, resources);
+      console.log(res);
+    });
+}

package/src/commands/skill.ts

@@ -0,0 +1,20 @@
+import type { Command } from "commander";
+import fs from "node:fs";
+import path from "node:path";
+
+export const name = "skill";
+export const description = "Print built-in SKILL.md content";
+
+export function register(program: Command): void {
+  program
+    .command("skill")
+    .description("Print built-in skill markdown")
+    .action(() => {
+      const filePath = path.resolve(__dirname, "../skill/SKILL.md");
+      const content = fs.readFileSync(filePath, "utf8");
+      process.stdout.write(content);
+      if (!content.endsWith("\n")) {
+        process.stdout.write("\n");
+      }
+    });
+}

package/src/commands/tts.ts

@@ -0,0 +1,80 @@
+import type { Command } from "commander";
+import { getSessionFromCommand, syncToTOS } from "../services/cerevox";
+import fs from "node:fs";
+import path from "node:path";
+
+export const name = "tts";
+export const description = "TTS command: create speech audio";
+
+export function register(program: Command): void {
+  const parent = program.command("tts").description("Create speech audio; requires --text");
+
+  async function ttsCreateAction(
+    this: Command,
+    opts: {
+      prompt?: string;
+      text?: string;
+      voiceId?: string;
+      output?: string;
+    }
+  ) {
+    const session = getSessionFromCommand(this as unknown as Record<symbol, unknown>);
+    if (!session) {
+      process.stderr.write("No active session\n");
+      return;
+    }
+    const text = typeof opts.text === "string" ? opts.text : undefined;
+    if (!text || text.trim().length === 0) {
+      process.stderr.write("Missing required option: --text\n");
+      process.exitCode = 1;
+      return;
+    }
+    const prompt = typeof opts.prompt === "string" ? opts.prompt : undefined;
+    const voiceId = typeof opts.voiceId === "string" ? opts.voiceId : undefined;
+    const res = await session.ai.textToSpeech({
+      prompt,
+      text,
+      voiceId,
+    });
+    try {
+      if (res?.url) {
+        const tosUrl = await syncToTOS(res.url as string);
+        if (tosUrl) {
+          res.url = tosUrl;
+        }
+      }
+    } catch (ex: unknown) {
+      console.log((ex as Error).message);
+    }
+    const output = typeof opts.output === "string" ? opts.output : undefined;
+    if (output) {
+      const dir = process.cwd();
+      const url = res.url;
+      const response = await fetch(url);
+      const buffer = Buffer.from(await response.arrayBuffer());
+      const filePath = path.resolve(dir, output);
+      if (!fs.existsSync(path.dirname(filePath))) {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+      }
+      fs.writeFileSync(filePath, buffer);
+      res.output = filePath;
+    }
+    console.log(res);
+  }
+
+  parent
+    .option("--prompt <prompt>", "Prompt for speech style/context")
+    .option("--text <text>", "Text to synthesize (required)")
+    .option("--voiceId <voiceId>", "Voice ID")
+    .option("--output <file>", "Output file path")
+    .action(ttsCreateAction);
+
+  parent
+    .command("create")
+    .description("Create speech audio; requires --text")
+    .option("--prompt <prompt>", "Prompt for speech style/context")
+    .option("--text <text>", "Text to synthesize (required)")
+    .option("--voiceId <voiceId>", "Voice ID")
+    .option("--output <file>", "Output file path")
+    .action(ttsCreateAction);
+}

package/src/commands/video.ts

@@ -0,0 +1,202 @@
+import type { Command } from "commander";
+import { getMaterialUri, getSessionFromCommand, syncToTOS } from "../services/cerevox";
+import fs from "node:fs";
+import path from "node:path";
+import { createProgressSpinner } from "../utils/progress";
+
+export const name = "video";
+export const description = "Video command: create video";
+
+export function register(program: Command): void {
+  const parent = program.command("video").description("Create a new video; requires --prompt");
+
+  const allowedTypes = [
+    "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",
+  ] as const;
+
+  async function videoCreateAction(
+    this: Command,
+    opts: {
+      prompt?: string;
+      duration?: string;
+      model?: string;
+      sourceVideo?: string;
+      seed?: string;
+      firstFrame?: string;
+      lastFrame?: string;
+      refs?: string;
+      resolution?: "720p" | "1080p";
+      aspectRatio?: "9:16" | "16:9" | "1:1";
+      withAudio?: boolean;
+      optimizeCameraMotion?: boolean;
+      output?: string;
+    }
+  ) {
+    const session = getSessionFromCommand(this as unknown as Record<symbol, unknown>);
+    if (!session) {
+      process.stderr.write("No active session\n");
+      return;
+    }
+    const prompt = typeof opts.prompt === "string" ? opts.prompt : undefined;
+    if (!prompt || prompt.trim().length === 0) {
+      process.stderr.write("Missing required option: --prompt\n");
+      process.exitCode = 1;
+      return;
+    }
+    let model = typeof opts.model === "string" ? opts.model.trim() : undefined;
+    if (model && !(allowedTypes as readonly string[]).includes(model)) {
+      process.stderr.write(
+        `Invalid value for --model: ${model}. Allowed: ${allowedTypes.join("|")}\n`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    if (!model) model = "vidu";
+    const durationStr = typeof opts.duration === "string" ? opts.duration.trim() : undefined;
+    const sourceVideo = typeof opts.sourceVideo === "string" ? opts.sourceVideo.trim() : undefined;
+    let duration: number = 0;
+    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");
+        process.exitCode = 1;
+        return;
+      }
+      duration = n;
+    }
+    const allowedAspectRatios = ["9:16", "16:9", "1:1"] as const;
+    const ar = typeof opts.aspectRatio === "string" ? opts.aspectRatio : undefined;
+    if (ar && !(allowedAspectRatios as readonly string[]).includes(ar)) {
+      process.stderr.write(
+        `Invalid value for --aspectRatio: ${ar}. Allowed: ${allowedAspectRatios.join("|")}\n`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    const aspectRatio = ar as (typeof allowedAspectRatios)[number] | undefined;
+    const images: {
+      type: "first_frame" | "last_frame" | "reference" | "storyboard";
+      url: string;
+      name?: string;
+    }[] = [];
+    if (opts.firstFrame) {
+      images.push({
+        type: "first_frame",
+        url: await getMaterialUri(session, opts.firstFrame),
+      });
+    }
+    if (opts.lastFrame) {
+      images.push({
+        type: "last_frame",
+        url: await getMaterialUri(session, opts.lastFrame),
+      });
+    }
+    const refsList =
+      typeof opts.refs === "string" && opts.refs.length > 0
+        ? opts.refs
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0)
+        : [];
+    for (const ref of refsList) {
+      images.push({
+        type: "reference",
+        url: await getMaterialUri(session, ref),
+      });
+    }
+    const res = await session.ai.generateVideo({
+      prompt,
+      model: model as (typeof allowedTypes)[number],
+      duration: duration || undefined,
+      resolution: opts.resolution,
+      aspect_ratio: aspectRatio,
+      mute: !(opts.withAudio ?? true),
+      optimize_camera: opts.optimizeCameraMotion,
+      seed: opts.seed ? Number.parseInt(opts.seed, 10) : undefined,
+      images: images.length > 0 ? images : undefined,
+      videos: sourceVideo
+        ? [
+            {
+              type: "base",
+              url: await getMaterialUri(session, sourceVideo),
+            },
+          ]
+        : undefined,
+      onProgress: createProgressSpinner("inferencing"),
+    });
+    try {
+      if (res?.url) {
+        const tosUrl = await syncToTOS(res.url as string);
+        if (tosUrl) {
+          res.url = tosUrl;
+        }
+      }
+    } catch {}
+    process.stdout.write("\n");
+    const output = typeof opts.output === "string" ? opts.output : undefined;
+    if (output) {
+      const dir = process.cwd();
+      const url = res.url;
+      const response = await fetch(url);
+      const buffer = Buffer.from(await response.arrayBuffer());
+      const filePath = path.resolve(dir, output);
+      if (!fs.existsSync(path.dirname(filePath))) {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+      }
+      fs.writeFileSync(filePath, buffer);
+      res.output = filePath;
+    }
+    console.log(res);
+  }
+
+  // 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("--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")
+    .option("--firstFrame <image>", "First frame image path/url")
+    .option("--lastFrame <image>", "Last frame image path/url")
+    .option("--refs <refs>", "Comma-separated reference image/video paths/urls")
+    .option("--resolution <resolution>", "Resolution, e.g., 720p")
+    .option("--aspectRatio <ratio>", "Aspect ratio: 9:16|16:9|1:1")
+    .option("--withAudio", "Include audio track")
+    .option("--optimizeCameraMotion", "Optimize camera motion")
+    .option("--output <file>", "Output file path")
+    .action(videoCreateAction);
+
+  // keep `video create` for compatibility
+  parent
+    .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("--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")
+    .option("--firstFrame <image>", "First frame image path/url")
+    .option("--lastFrame <image>", "Last frame image path/url")
+    .option("--refs <refs>", "Comma-separated reference image/video paths/urls")
+    .option("--resolution <resolution>", "Resolution, e.g., 720p")
+    .option("--aspectRatio <ratio>", "Aspect ratio: 9:16|16:9|1:1")
+    .option("--withAudio", "Include audio track")
+    .option("--optimizeCameraMotion", "Optimize camera motion")
+    .option("--output <file>", "Output file path")
+    .action(videoCreateAction);
+
+  // removed `video edit`
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { run, createProgram } from "./cli";