videodraft 0.1.1 → 0.1.2

package/README.md

@@ -11,10 +11,14 @@ npx videodraft create "30s launch video for our espresso machine" --ar 9:16
 ## Install
 
 ```bash
-npm install -g videodraft     # or: npx videodraft <command>
+npm install -g videodraft     # global: adds the `videodraft` command to your PATH
+videodraft --version          # → confirms it's installed
+
+# …or run without installing — npx fetches and runs the latest each time:
+npx videodraft <command>
 ```
 
-Requires Node ≥ 20.18.1.
+Requires Node ≥ 20.18.1. (Publishing to npm doesn't put `videodraft` on your PATH — `npm i -g` or `npx` does. A Homebrew tap and a `curl | sh` installer are on the way.)
 
 ## Authenticate
 
@@ -81,6 +85,7 @@ Install the VideoDraft skill so your agent knows the workflow:
 npx videodraft skills install                  # zero-install: npx fetches the CLI and installs the skill
 videodraft skills install                      # if the CLI is on PATH — auto-detects your installed agents
 videodraft skills install --agent claude,codex # target specific agents (repeatable/comma; --all for every agent)
+videodraft skills install --project            # into ./.claude/skills for just this repo (else global)
 npx skills add videodraft-ai/cli               # via the vercel-labs skills tool (discovery / 69-agent multiselect)
 ```
 

package/dist/index.js

@@ -1413,6 +1413,43 @@ async function pollExport(client, ref, options = {}) {
   }
 }
 
+// src/core/media.ts
+var IMAGE_EXTS = /* @__PURE__ */ new Set(["png", "jpg", "jpeg", "webp", "gif", "bmp", "heic", "heif", "avif", "svg"]);
+var VIDEO_EXTS = /* @__PURE__ */ new Set(["mp4", "webm", "mov", "m4v"]);
+var AUDIO_EXTS = /* @__PURE__ */ new Set(["mp3", "wav", "m4a", "ogg", "flac", "aac"]);
+function kindOf(url, typeHint) {
+  const t = (typeHint ?? "").toLowerCase();
+  if (t.includes("image")) return "image";
+  if (t.includes("video")) return "video";
+  if (t.includes("audio") || t.includes("music") || t.includes("sound") || t.includes("voice") || t.includes("speech") || t.includes("tts")) {
+    return "audio";
+  }
+  const path5 = url.split(/[?#]/)[0]?.toLowerCase() ?? "";
+  if (path5.includes("/img/")) return "image";
+  if (path5.includes("/vid/")) return "video";
+  if (path5.includes("/aud/")) return "audio";
+  const ext = path5.match(/\.([a-z0-9]+)$/)?.[1];
+  if (ext) {
+    if (IMAGE_EXTS.has(ext)) return "image";
+    if (VIDEO_EXTS.has(ext)) return "video";
+    if (AUDIO_EXTS.has(ext)) return "audio";
+  }
+  return null;
+}
+function buildMediaDescriptors(urls, typeHint) {
+  if (!Array.isArray(urls)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const url of urls) {
+    if (typeof url !== "string" || !/^https?:\/\//i.test(url) || seen.has(url)) continue;
+    const kind = kindOf(url, typeHint);
+    if (!kind) continue;
+    seen.add(url);
+    out.push({ kind, url });
+  }
+  return out;
+}
+
 // src/core/download.ts
 import fs3 from "fs";
 import path2 from "path";
@@ -1615,9 +1652,10 @@ async function handleAsyncJob(ctx, submitted, options) {
     if (options.download && result.outputUrls.length > 0) {
       downloaded = await downloadOutputs(result.outputUrls, options.download, { job_id: jobId });
     }
+    const media = buildMediaDescriptors(result.outputUrls, result.payload?.type);
     emit(
       ctx.out,
-      { job_id: jobId, status: result.status, outputs: result.outputUrls, downloaded_files: downloaded },
+      { job_id: jobId, status: result.status, outputs: result.outputUrls, downloaded_files: downloaded, output_media: media },
       (o) => {
         note(o, fmt.green(o, `Completed \u2014 job ${jobId}`));
         for (const url of result.outputUrls) process.stdout.write(`${url}
@@ -1759,7 +1797,8 @@ function registerGenerateCommands(program) {
     if (opts.download && urls.length > 0) {
       downloaded = await downloadOutputs(urls, opts.download, { name: "voiceover" });
     }
-    emit(ctx.out, { ...result, downloaded_files: downloaded }, (o) => {
+    const media = buildMediaDescriptors(urls, "audio");
+    emit(ctx.out, { ...result, downloaded_files: downloaded, output_media: media }, (o) => {
       for (const url of urls) process.stdout.write(`${url}
 `);
       for (const f of downloaded ?? []) note(o, fmt.dim(o, `saved ${f.path}`));
@@ -1788,7 +1827,8 @@ function registerGenerateCommands(program) {
     if (opts.download && urls.length > 0) {
       downloaded = await downloadOutputs(urls, opts.download, { name: "music" });
     }
-    emit(ctx.out, { ...result, downloaded_files: downloaded }, (o) => {
+    const media = buildMediaDescriptors(urls, "music");
+    emit(ctx.out, { ...result, downloaded_files: downloaded, output_media: media }, (o) => {
       for (const url of urls) process.stdout.write(`${url}
 `);
       for (const f of downloaded ?? []) note(o, fmt.dim(o, `saved ${f.path}`));
@@ -1809,7 +1849,8 @@ function registerGenerateCommands(program) {
     if (opts.download && urls.length > 0) {
       downloaded = await downloadOutputs(urls, opts.download, { name: "upscaled" });
     }
-    emit(ctx.out, { ...result, downloaded_files: downloaded }, (o) => {
+    const media = buildMediaDescriptors(urls, "image");
+    emit(ctx.out, { ...result, downloaded_files: downloaded, output_media: media }, (o) => {
       for (const u of urls) process.stdout.write(`${u}
 `);
       for (const f of downloaded ?? []) note(o, fmt.dim(o, `saved ${f.path}`));
@@ -1948,7 +1989,18 @@ function registerPipelineCommands(program) {
       const failed = results.filter((r) => r.status === "failed").length;
       emit(
         ctx.out,
-        { job_ids: jobIds, results: results.map((r) => ({ status: r.status, outputs: r.outputUrls })) },
+        {
+          job_ids: jobIds,
+          results: jobIds.map((jobId) => {
+            const result = resultMap.get(jobId);
+            return {
+              job_id: jobId,
+              status: result.status,
+              outputs: result.outputUrls,
+              output_media: buildMediaDescriptors(result.outputUrls, result.payload?.type)
+            };
+          })
+        },
         (o) => {
           note(
             o,
@@ -2084,12 +2136,17 @@ function registerPipelineCommands(program) {
           name: "export"
         });
       }
-      emit(ctx.out, { export_id: exportId, video_url: result.videoUrl, downloaded_files: downloaded }, (o) => {
-        note(o, fmt.green(o, "Export finished."));
-        process.stdout.write(`${result.videoUrl}
+      const media = buildMediaDescriptors([result.videoUrl], "video");
+      emit(
+        ctx.out,
+        { export_id: exportId, video_url: result.videoUrl, downloaded_files: downloaded, output_media: media },
+        (o) => {
+          note(o, fmt.green(o, "Export finished."));
+          process.stdout.write(`${result.videoUrl}
 `);
-        for (const f of downloaded ?? []) note(o, fmt.dim(o, `saved ${f.path}`));
-      });
+          for (const f of downloaded ?? []) note(o, fmt.dim(o, `saved ${f.path}`));
+        }
+      );
     } catch (err) {
       spin.stop();
       throw err;
@@ -2106,7 +2163,8 @@ function registerPipelineCommands(program) {
         wait_seconds: opts.wait ? Number(opts.wait) : void 0
       })
     );
-    emit(ctx.out, result);
+    const media = buildMediaDescriptors(extractOutputUrls(result), "video");
+    emit(ctx.out, { ...result, output_media: media });
   });
   program.command("video-prompts <project_id>").description("Generate advisory per-shot motion/video prompts for a project").option("--ar <ratio>", "aspect ratio").option("--instructions <text>", "authoring instructions").option("--has-voiceover", "tell the generator the project has a voiceover track").option("--video-audio", "tell the generator that generated videos may include native audio").option("--has-bgm", "tell the generator the project has background music").action(async function(projectId) {
     const ctx = buildContext(this);
@@ -2135,7 +2193,8 @@ function registerJobCommands(program) {
       "check_generation_status",
       compact({ job_id: jobId, project_id: opts.project, scene_id: opts.sceneId })
     );
-    emit(ctx.out, result, (o) => {
+    const media = buildMediaDescriptors(extractOutputUrls(result), result?.type);
+    emit(ctx.out, { ...result, output_media: media }, (o) => {
       note(o, `${jobId}: ${result?.status ?? "unknown"}`);
       for (const url of extractOutputUrls(result)) process.stdout.write(`${url}
 `);
@@ -2177,6 +2236,7 @@ function registerJobCommands(program) {
           status: result.status,
           outputs: result.outputUrls,
           downloaded_files: downloaded,
+          output_media: buildMediaDescriptors(result.outputUrls, result.payload?.type),
           ...result.status === "failed" ? { error: result.payload?.error } : {}
         });
       }
@@ -2403,7 +2463,8 @@ function registerAvatarCommands(program) {
         target_language: opts.language
       })
     );
-    emit(ctx.out, result, (o) => {
+    const media = buildMediaDescriptors(extractOutputUrls(result), "audio");
+    emit(ctx.out, { ...result, output_media: media }, (o) => {
       note(o, fmt.green(o, `Avatar video ${result?.avatar_video_id ?? "created"}.`));
       note(o, fmt.dim(o, `Render (paid): videodraft avatar render ${result?.avatar_video_id}`));
     });
@@ -2435,7 +2496,8 @@ function registerAvatarCommands(program) {
         spin.update(`Rendering avatar video \u2014 ${exportStatus}`);
         if (exportStatus === "completed") {
           spin.stop();
-          emit(ctx.out, status, (o) => {
+          const media = buildMediaDescriptors(extractOutputUrls(status), "video");
+          emit(ctx.out, { ...status, output_media: media }, (o) => {
             note(o, fmt.green(o, "Avatar render completed."));
             if (status?.video_url) process.stdout.write(`${status.video_url}
 `);
@@ -2463,7 +2525,8 @@ function registerAvatarCommands(program) {
   avatar.command("get <avatar_video_id>").description("Fetch one avatar video (status + video_url when rendered)").action(async function(avatarVideoId) {
     const ctx = buildContext(this);
     const result = await ctx.client.callTool("get_avatar_video", { avatar_video_id: avatarVideoId });
-    emit(ctx.out, result);
+    const media = buildMediaDescriptors(extractOutputUrls(result), "video");
+    emit(ctx.out, { ...result, output_media: media });
   });
   avatar.command("list").description("List your avatar videos").action(async function() {
     const ctx = buildContext(this);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videodraft",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Official VideoDraft CLI — create AI videos, images, voiceovers and music from your terminal. Agent-friendly: --json everywhere, stable exit codes, async job polling.",
   "license": "MIT",
   "type": "module",