@gobi-ai/cli 0.9.6 → 0.9.7

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask brains, publish brain documents, create threads, manage sessions, generate images and videos.",
-      "version": "0.9.5",
+      "version": "0.9.7",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "author": {
     "name": "gobi-ai"
   },

package/dist/commands/media.js

@@ -116,7 +116,7 @@ export function registerMediaCommand(program) {
     media
         .command("video-create")
         .description("Create an avatar video generation job.")
-        .requiredOption("--name <name>", "Name for the video")
+        .option("--name <name>", "Name for the video (auto-generated if omitted)")
         .requiredOption("--avatar-id <avatarId>", "Avatar to use")
         .requiredOption("--voice-id <voiceId>", "Voice to use")
         .requiredOption("--script <script>", "Script for the avatar to read")
@@ -125,8 +125,9 @@ export function registerMediaCommand(program) {
         .option("-o, --output <path>", "Download video to this path when done (implies --wait)")
         .action(async (opts) => {
         const shouldWait = opts.wait || !!opts.output;
+        const autoName = opts.name || `video-${new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19)}`;
         const body = {
-            name: opts.name,
+            name: autoName,
             avatarId: opts.avatarId,
             voiceId: opts.voiceId,
             script: opts.script,
@@ -236,9 +237,57 @@ export function registerMediaCommand(program) {
         .command("video-status <id>")
         .description("Poll video generation status.")
         .option("--wait", "Poll until a terminal state is reached")
+        .option("-o, --output <path>", "Download video to this path when complete (implies --wait)")
         .action(async (id, opts) => {
-        if (opts.wait) {
+        const shouldWait = opts.wait || !!opts.output;
+        if (shouldWait) {
             const data = await pollStatus(`/media-gen/videos/${id}/status`, ["inference_complete", "inference_failed"]);
+            // Download if -o specified and completed
+            if (opts.output && data.status === "inference_complete") {
+                const token = await getValidToken();
+                const dlUrl = `${BASE_URL}/media-gen/videos/${id}/download`;
+                const dlRes = await fetch(dlUrl, {
+                    headers: { Authorization: `Bearer ${token}` },
+                    redirect: "follow",
+                });
+                if (dlRes.ok) {
+                    const { writeFile, mkdir } = await import("fs/promises");
+                    const { dirname } = await import("path");
+                    const buffer = Buffer.from(await dlRes.arrayBuffer());
+                    await mkdir(dirname(opts.output), { recursive: true });
+                    await writeFile(opts.output, buffer);
+                    const contentType = dlRes.headers.get("content-type") || "video/mp4";
+                    if (isJsonMode(media)) {
+                        jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Video ${id} — ${data.status}\nSaved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+                // Try manual redirect
+                const dlRes2 = await fetch(dlUrl, {
+                    headers: { Authorization: `Bearer ${token}` },
+                    redirect: "manual",
+                });
+                const location = dlRes2.headers.get("location");
+                if (location) {
+                    const videoRes = await fetch(location);
+                    if (videoRes.ok) {
+                        const { writeFile, mkdir } = await import("fs/promises");
+                        const { dirname } = await import("path");
+                        const buffer = Buffer.from(await videoRes.arrayBuffer());
+                        await mkdir(dirname(opts.output), { recursive: true });
+                        await writeFile(opts.output, buffer);
+                        const contentType = videoRes.headers.get("content-type") || "video/mp4";
+                        if (isJsonMode(media)) {
+                            jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                            return;
+                        }
+                        console.log(`Video ${id} — ${data.status}\nSaved to ${opts.output} (${buffer.length} bytes)`);
+                        return;
+                    }
+                }
+            }
             if (isJsonMode(media)) {
                 jsonOut(data);
                 return;
@@ -256,10 +305,57 @@ export function registerMediaCommand(program) {
     });
     media
         .command("video-download <id>")
-        .description("Get the download URL for a completed video.")
-        .action(async (id) => {
+        .description("Download a completed video (or get its URL).")
+        .option("-o, --output <path>", "Save video to this file path")
+        .action(async (id, opts) => {
         const token = await getValidToken();
         const url = `${BASE_URL}/media-gen/videos/${id}/download`;
+        // If -o specified, download directly to file
+        if (opts.output) {
+            const res = await fetch(url, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "follow",
+            });
+            if (res.ok) {
+                const { writeFile, mkdir } = await import("fs/promises");
+                const { dirname } = await import("path");
+                const buffer = Buffer.from(await res.arrayBuffer());
+                await mkdir(dirname(opts.output), { recursive: true });
+                await writeFile(opts.output, buffer);
+                const contentType = res.headers.get("content-type") || "video/mp4";
+                if (isJsonMode(media)) {
+                    jsonOut({ filename: opts.output, contentType, size: buffer.length });
+                    return;
+                }
+                console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                return;
+            }
+            // If direct follow didn't work, try manual redirect
+            const res2 = await fetch(url, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "manual",
+            });
+            const location = res2.headers.get("location");
+            if (location) {
+                const videoRes = await fetch(location);
+                if (videoRes.ok) {
+                    const { writeFile, mkdir } = await import("fs/promises");
+                    const { dirname } = await import("path");
+                    const buffer = Buffer.from(await videoRes.arrayBuffer());
+                    await mkdir(dirname(opts.output), { recursive: true });
+                    await writeFile(opts.output, buffer);
+                    const contentType = videoRes.headers.get("content-type") || "video/mp4";
+                    if (isJsonMode(media)) {
+                        jsonOut({ filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+            }
+            throw new ApiError(res.status, `/media-gen/videos/${id}/download`, "Failed to download video");
+        }
+        // No -o: just return the URL (existing behavior)
         const res = await fetch(url, {
             headers: { Authorization: `Bearer ${token}` },
             redirect: "manual",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-media/SKILL.md

@@ -57,13 +57,27 @@ Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[me
 Single command — create and download in one step:
 
 ```bash
-gobi --json media video-create --name "<NAME>" --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
+gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
 ```
 
-Replace `<NAME>` with a short descriptive slug. Use `gobi media avatars` and `gobi media voices` to list available IDs.
+`--name` is optional (auto-generated if omitted). Replace `<NAME>` with a short descriptive slug. Use `gobi media avatars` and `gobi media voices` to list available IDs.
 
 The `-o` flag implies `--wait` and downloads the video when done.
 
+**IMPORTANT: Avatars are pre-built system avatars ONLY.** You CANNOT create custom avatars from uploaded images. The `gobi media avatars` list is the complete set of available avatars. Do NOT attempt to upload an image and use its mediaId as an avatarId — it will fail.
+
+To use a custom image (e.g. a generated image) as the **background** of a video, upload it first via `upload-init` / `upload-finalize`, then pass the mediaId as `--background-media-id`:
+
+```bash
+# 1. Upload custom image as background
+gobi --json media upload-init --file-name "bg.png" --content-type "image/png" --file-size <SIZE>
+curl -T "media/bg.png" -H "Content-Type: image/png" "<UPLOAD_URL>"
+gobi --json media upload-finalize --media-id "<MEDIA_ID>"
+
+# 2. Create video with pre-built avatar + custom background
+gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" --background-media-id "<MEDIA_ID>" -o media/<NAME>.mp4
+```
+
 **IMPORTANT: After downloading, show the video using Obsidian wiki-link syntax EXACTLY like this:**
 
 ```
@@ -90,7 +104,7 @@ Do NOT use markdown image/link syntax `![](...)` or `gobi://` URLs. Always use `
 - `gobi media video-list` — List all videos.
 - `gobi media video-get` — Get video metadata.
 - `gobi media video-status` — Poll video generation status.
-- `gobi media video-download` — Get the download URL for a completed video.
+- `gobi media video-download` — Download a completed video (`-o` to save to file).
 
 ### Images
 

package/skills/gobi-media/references/media.md

@@ -17,7 +17,7 @@ Commands:
   video-list                        List all videos.
   video-get <id>                    Get video metadata.
   video-status [options] <id>       Poll video generation status.
-  video-download <id>               Get the download URL for a completed video.
+  video-download [options] <id>     Download a completed video (or get its URL).
   image-generate [options]          Generate an image from a text prompt. Types: image (default), thumbnail (YouTube-optimized), asset (logo/product). Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4
   image-edit [options]              Edit an existing image with a prompt (image-to-image).
   image-inpaint [options]           Inpaint an image region using a mask.
@@ -82,12 +82,13 @@ Usage: gobi media video-create [options]
 Create an avatar video generation job.
 
 Options:
-  --name <name>                              Name for the video
+  --name <name>                              Name for the video (auto-generated if omitted)
   --avatar-id <avatarId>                     Avatar to use
   --voice-id <voiceId>                       Voice to use
   --script <script>                          Script for the avatar to read
   --background-media-id <backgroundMediaId>  Background media ID (from upload)
   --wait                                     Poll until generation completes
+  -o, --output <path>                        Download video to this path when done (implies --wait)
   -h, --help                                 display help for command
 ```
 
@@ -121,8 +122,9 @@ Usage: gobi media video-status [options] <id>
 Poll video generation status.
 
 Options:
-  --wait      Poll until a terminal state is reached
-  -h, --help  display help for command
+  --wait               Poll until a terminal state is reached
+  -o, --output <path>  Download video to this path when complete (implies --wait)
+  -h, --help           display help for command
 ```
 
 ## video-download
@@ -130,10 +132,11 @@ Options:
 ```
 Usage: gobi media video-download [options] <id>
 
-Get the download URL for a completed video.
+Download a completed video (or get its URL).
 
 Options:
-  -h, --help  display help for command
+  -o, --output <path>  Save video to this file path
+  -h, --help           display help for command
 ```
 
 ## image-generate