Merge pull request #65 from muxinc/add-robots-api

feat: add Mux Robots API commands

Author: dylanjha

README.md

@@ -19,6 +19,7 @@ A command-line interface for interacting with the Mux API, designed to provide a
   - [Transcription Vocabularies](#transcription-vocabularies)
   - [Delivery Usage](#delivery-usage)
   - [DRM Configurations](#drm-configurations)
+  - [Robots](#robots)
   - [Mux Data](#mux-data)
   - [Authentication & Environment Management](#authentication--environment-management)
 - [Configuration](#configuration)
@@ -821,6 +822,115 @@ mux drm-configurations get <drm-configuration-id>
 
 </details>
 
+<details>
+<summary><h3>Robots</h3></summary>
+
+Run AI-powered workflows on your video assets using [Mux Robots](https://docs.mux.com/guides/robots). Requires accepting the Robots terms of service in the [Mux Dashboard](https://dashboard.mux.com) and a token with `robots:read` and `robots:write` permissions.
+
+#### Job Management
+
+```bash
+# List all jobs (with optional filters)
+mux robots list [--workflow summarize] [--status completed] [--asset-id <id>]
+
+# Get full details about a specific job
+mux robots get <job-id> --workflow <type>
+
+# Cancel a running job
+mux robots cancel <job-id>
+```
+
+**List options:** `--workflow`, `--status`, `--asset-id`, `--limit`, `--page`, `--compact`
+
+#### `mux robots summarize <asset-id>`
+
+Generate a title, description, and tags for a video.
+
+**Options:**
+- `--tone <tone>` - `neutral`, `playful`, or `professional`
+- `--language-code <code>` - BCP 47 code of the caption track to analyze
+- `--output-language-code <code>` - BCP 47 code for the generated output
+- `--title-length <n>` - Maximum title length in words
+- `--description-length <n>` - Maximum description length in words
+- `--tag-count <n>` - Maximum number of tags (default: 10)
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots summarize abc123 --tone playful
+```
+
+#### `mux robots moderate <asset-id>`
+
+Analyze video content for policy violations.
+
+**Options:**
+- `--language-code <code>` - BCP 47 code for transcript analysis (audio-only assets)
+- `--sampling-interval <seconds>` - Interval between sampled thumbnails (min 5)
+- `--max-samples <n>` - Maximum number of thumbnails to sample
+- `--threshold-sexual <n>` - Score threshold (0.0-1.0) for sexual content (default: 0.7)
+- `--threshold-violence <n>` - Score threshold (0.0-1.0) for violent content (default: 0.8)
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots moderate abc123 --threshold-sexual 0.5 --threshold-violence 0.9
+```
+
+#### `mux robots generate-chapters <asset-id>`
+
+Automatically generate chapters for a video.
+
+**Options:**
+- `--language-code <code>` - BCP 47 code of the caption track to analyze
+- `--output-language-code <code>` - BCP 47 code for output chapter titles
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots generate-chapters abc123
+```
+
+#### `mux robots ask-questions <asset-id>`
+
+Ask questions about a video and get answers.
+
+**Options:**
+- `--question <question>` - Question to ask (required, repeatable)
+- `--language-code <code>` - BCP 47 code of the caption track to analyze
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots ask-questions abc123 --question "What is this video about?" --question "Are there children?"
+```
+
+#### `mux robots find-key-moments <asset-id>`
+
+Find key moments and highlights in a video.
+
+**Options:**
+- `--max-moments <n>` - Maximum number of key moments to extract (default: 5)
+- `--target-duration-min-ms <ms>` - Preferred minimum highlight duration in milliseconds (must be paired with max)
+- `--target-duration-max-ms <ms>` - Preferred maximum highlight duration in milliseconds (must be paired with min)
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots find-key-moments abc123 --max-moments 3 --target-duration-min-ms 15000 --target-duration-max-ms 45000
+```
+
+#### `mux robots translate-captions <asset-id>`
+
+Translate captions on a video to another language.
+
+**Options:**
+- `--track-id <id>` - Source caption track ID to translate (required)
+- `--to-language-code <code>` - BCP 47 code for translated output (required)
+- `--no-upload` - Do not upload the translated VTT to Mux
+- `--passthrough <string>` - Arbitrary metadata (max 255 chars)
+
+```bash
+mux robots translate-captions abc123 --track-id track456 --to-language-code es
+```
+
+</details>
+
 <details>
 <summary><h3>Mux Data</h3></summary>
 
@@ -1043,6 +1153,7 @@ src/
 │   ├── transcription-vocabularies/   # Transcription vocabulary management
 │   ├── delivery-usage/               # Delivery usage reports
 │   ├── drm-configurations/          # DRM configuration management
+│   ├── robots/                       # Mux Robots AI workflows
 │   ├── signing-keys/                 # Signing key management
 │   ├── video-views/                  # Mux Data: video view analytics
 │   ├── metrics/                      # Mux Data: metric analytics

package.json

@@ -52,7 +52,7 @@
     "@cliffy/ansi": "jsr:1.0.0-rc.8",
     "@cliffy/command": "jsr:1.0.0-rc.8",
     "@cliffy/prompt": "npm:@jsr/cliffy__prompt@1.0.0-rc.8",
-    "@mux/mux-node": "^12.8.1",
+    "@mux/mux-node": "^14.0.0",
     "@opentui/core": "^0.1.50",
     "@opentui/react": "^0.1.50",
     "@std/path": "npm:@jsr/std__path@^1.1.3",