pixcli 0.1.1 → 0.2.2

package/README.md

@@ -0,0 +1,170 @@
+# pixcli
+
+The creative toolkit for AI agents — generate images, videos, voiceover, music, and sound effects from the command line.
+
+## Install
+
+```bash
+npm install -g pixcli
+```
+
+Or run without installing:
+
+```bash
+npx pixcli image "a red fox in a forest"
+```
+
+## Auth
+
+```bash
+export PIXCLI_API_KEY="px_live_..."
+```
+
+Get your key at [pixcli.shellbot.sh](https://pixcli.shellbot.sh).
+
+## Commands
+
+### `pixcli image <prompt>` — Generate images
+
+```bash
+pixcli image "Studio product shot of wireless earbuds, soft lighting" -r 16:9 -q high -o earbuds.png
+pixcli image "Abstract pattern, dark blue and cyan" -n 4
+pixcli image "Red sneaker, centered, clean edges" -t -o sneaker.png
+pixcli image "Same product, warm background" --from product.png -o warm.png
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-r, --ratio` | `1:1` | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3` |
+| `-q, --quality` | `standard` | `draft`, `standard`, `high` |
+| `-t, --transparent` | `false` | Transparent background (PNG) |
+| `-n, --count` | `1` | Number of images (1-4) |
+| `--from` | — | Source image for I2I |
+| `-m, --model` | auto | Model ID (bypasses auto-classification) |
+| `-o, --output` | auto | Output path |
+| `--json` | `false` | JSON output |
+
+### `pixcli edit <prompt>` — Edit images
+
+```bash
+pixcli edit "Remove the background" -i photo.jpg -o photo-nobg.png
+pixcli edit "Upscale to max resolution" -i hero.png -q high -o hero-4k.png
+pixcli edit "Apply the style from the reference" -i photo.jpg -i style-ref.jpg
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-i, --image` | **required** | Source image (repeatable) |
+| `-q, --quality` | `standard` | `draft`, `standard`, `high` |
+| `-m, --model` | auto | Model ID |
+| `-o, --output` | auto | Output path |
+| `--json` | `false` | JSON output |
+
+### `pixcli video <prompt>` — Generate video
+
+```bash
+pixcli video "Slow orbit around the product" --from product.png -d 5 -o reveal.mp4
+pixcli video "A cat walking through a garden" -o cat.mp4
+pixcli video "The cat jumps over a fence" --from cat.mp4 --extend -o extended.mp4
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--from` | — | Source image (I2V) or video (extend) |
+| `-d, --duration` | `5` | Duration in seconds (2-10) |
+| `-r, --ratio` | `16:9` | `16:9`, `9:16`, `1:1`, `4:3`, `3:4` |
+| `-q, --quality` | `standard` | `draft`, `standard`, `high` |
+| `-m, --model` | auto | Model ID |
+| `-o, --output` | auto | Output path |
+| `--extend` | `false` | Extend source video |
+| `--json` | `false` | JSON output |
+
+### `pixcli voice <text>` — Text-to-speech
+
+```bash
+pixcli voice "Welcome to the future of productivity." -o voiceover.mp3
+pixcli voice "Bienvenidos." --voice Sarah --language spa -o vo-es.mp3
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--voice` | `Rachel` | Voice preset (Rachel, Aria, Roger, Sarah, Laura, Charlie, George, etc.) |
+| `--language` | auto | ISO 639-1 code (eng, spa, fra, deu, jpn, ...) |
+| `-o, --output` | auto | Output path (.mp3) |
+| `--json` | `false` | JSON output |
+
+### `pixcli music <prompt>` — Generate music
+
+```bash
+pixcli music "Ambient electronic, minimal beats, corporate feel" -d 45 -o bg.mp3
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-d, --duration` | `30` | Duration in seconds (3-120) |
+| `-o, --output` | auto | Output path (.mp3) |
+| `--json` | `false` | JSON output |
+
+### `pixcli sfx <prompt>` — Generate sound effects
+
+```bash
+pixcli sfx "Smooth cinematic whoosh" -d 1.5 -o whoosh.mp3
+pixcli sfx "Soft digital click" -d 0.5 -o click.mp3
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-d, --duration` | `5` | Duration in seconds (0.5-22) |
+| `-o, --output` | auto | Output path (.mp3) |
+| `--json` | `false` | JSON output |
+
+## Global options
+
+| Option | Description |
+|--------|-------------|
+| `--key <key>` | Override `PIXCLI_API_KEY` |
+| `--api-url <url>` | Override API URL (default: `https://pixcli.shellbot.sh`) |
+| `--version` | Show version |
+| `--help` | Show help |
+
+## JSON mode
+
+All commands support `--json` for machine-readable output:
+
+```bash
+pixcli image "hero shot" --json | jq '.files[0].path'
+```
+
+```json
+{
+  "job_id": "abc123",
+  "status": "completed",
+  "files": [{ "path": "hero-shot.png", "width": 1024, "height": 1024, "mime_type": "image/png" }],
+  "model": "flux-pro",
+  "cost": 100000,
+  "elapsed_ms": 12340
+}
+```
+
+## Models
+
+### Image generation
+`flux-pro`, `flux-dev`, `seedream-v5`, `nano-banana-pro`, `nano-banana-2`, `imagen-4`, `imagen-4-fast`, `gpt-image-1`
+
+### Image editing
+`seedream-v5-edit`, `phota-enhance`, `rembg`, `recraft-upscale`, `aura-sr`
+
+### Video
+`kling-v3-pro-i2v`, `veo3-i2v`, `wan-v2-i2v`, `minimax-i2v`, `ltx-t2v`, `veo3-t2v`, `grok-extend-video`
+
+### Audio
+`elevenlabs-tts-v3`, `elevenlabs-music`, `elevenlabs-sfx`
+
+## Requirements
+
+- Node.js 18+
+- `PIXCLI_API_KEY` environment variable
+
+## License
+
+MIT

package/dist/commands/music.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const musicCommand: Command;

package/dist/commands/music.js

@@ -0,0 +1,90 @@
+import { Command } from "commander";
+import { PixClient } from "../lib/client.js";
+import { resolveApiKey, resolveBaseUrl } from "../lib/config.js";
+import { pollJob, getJobResult } from "../lib/poller.js";
+import { downloadAssets } from "../lib/download.js";
+import { setJsonMode, isJsonMode, startSpinner, updateSpinner, succeedSpinner, failSpinner, printSuccess, printInfo, printJson, printError, } from "../lib/output.js";
+import { ApiError } from "../lib/client.js";
+export const musicCommand = new Command("music")
+    .description("Generate background music from a text prompt")
+    .argument("<prompt>", "Description of the music to generate")
+    .option("-d, --duration <seconds>", "Duration in seconds (3-120)", "30")
+    .option("-o, --output <path>", "Output file path (.mp3)")
+    .option("--json", "Output machine-readable JSON", false)
+    .action(async (prompt, opts) => {
+    const globalOpts = musicCommand.parent?.opts();
+    if (opts.json)
+        setJsonMode(true);
+    let client;
+    try {
+        const apiKey = resolveApiKey(globalOpts);
+        const baseUrl = resolveBaseUrl(globalOpts);
+        client = new PixClient(baseUrl, apiKey);
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+    const start = Date.now();
+    try {
+        startSpinner("Generating music...");
+        const response = await client.post("/api/v1/audio/music", {
+            prompt,
+            duration: parseInt(opts.duration, 10),
+        });
+        if (!isJsonMode()) {
+            printInfo(`Job ${response.job_id} submitted (model: ${response.model || "auto"})`);
+        }
+        updateSpinner("Processing...");
+        const finalStatus = await pollJob(client, response.job_id, {
+            timeoutMs: 180_000, // 3 min for music
+            onStatus: () => { },
+        });
+        if (finalStatus.status !== "completed") {
+            failSpinner(`Job failed: ${finalStatus.error || "unknown error"}`);
+            if (isJsonMode()) {
+                printJson({ job_id: response.job_id, status: finalStatus.status, error: finalStatus.error, elapsed_ms: Date.now() - start });
+            }
+            process.exit(1);
+        }
+        const result = await getJobResult(client, response.job_id);
+        if (result.assets.length === 0) {
+            failSpinner("No assets returned");
+            process.exit(1);
+        }
+        updateSpinner("Downloading...");
+        const files = await downloadAssets(client, result.assets, prompt, opts.output);
+        const elapsed = Date.now() - start;
+        succeedSpinner("Done!");
+        if (isJsonMode()) {
+            printJson({
+                job_id: response.job_id,
+                status: "completed",
+                files: files.map((f) => ({ path: f.path, mime_type: f.mime_type })),
+                model: response.model,
+                cost: finalStatus.cost,
+                elapsed_ms: elapsed,
+            });
+        }
+        else {
+            for (const f of files)
+                printSuccess(`Created ${f.path}`);
+            printInfo(`${files.length} file(s) · ${(elapsed / 1000).toFixed(1)}s · cost: ${finalStatus.cost ?? "n/a"}`);
+        }
+    }
+    catch (err) {
+        failSpinner("Failed");
+        if (err instanceof ApiError) {
+            printError(`API error (${err.status}): ${err.message}`);
+            if (isJsonMode())
+                printJson({ error: err.message, status: err.status, elapsed_ms: Date.now() - start });
+        }
+        else {
+            printError(err.message);
+            if (isJsonMode())
+                printJson({ error: err.message, elapsed_ms: Date.now() - start });
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=music.js.map

package/dist/commands/music.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music.js","sourceRoot":"","sources":["../../src/commands/music.ts"],"names":[],"mappings":"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"}

package/dist/commands/sfx.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const sfxCommand: Command;

package/dist/commands/sfx.js

@@ -0,0 +1,89 @@
+import { Command } from "commander";
+import { PixClient } from "../lib/client.js";
+import { resolveApiKey, resolveBaseUrl } from "../lib/config.js";
+import { pollJob, getJobResult } from "../lib/poller.js";
+import { downloadAssets } from "../lib/download.js";
+import { setJsonMode, isJsonMode, startSpinner, updateSpinner, succeedSpinner, failSpinner, printSuccess, printInfo, printJson, printError, } from "../lib/output.js";
+import { ApiError } from "../lib/client.js";
+export const sfxCommand = new Command("sfx")
+    .description("Generate a sound effect from a text description")
+    .argument("<prompt>", "Description of the sound effect to generate")
+    .option("-d, --duration <seconds>", "Duration in seconds (0.5-22)", "5")
+    .option("-o, --output <path>", "Output file path (.mp3)")
+    .option("--json", "Output machine-readable JSON", false)
+    .action(async (prompt, opts) => {
+    const globalOpts = sfxCommand.parent?.opts();
+    if (opts.json)
+        setJsonMode(true);
+    let client;
+    try {
+        const apiKey = resolveApiKey(globalOpts);
+        const baseUrl = resolveBaseUrl(globalOpts);
+        client = new PixClient(baseUrl, apiKey);
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+    const start = Date.now();
+    try {
+        startSpinner("Generating sound effect...");
+        const response = await client.post("/api/v1/audio/sfx", {
+            prompt,
+            duration: parseFloat(opts.duration),
+        });
+        if (!isJsonMode()) {
+            printInfo(`Job ${response.job_id} submitted (model: ${response.model || "auto"})`);
+        }
+        updateSpinner("Processing...");
+        const finalStatus = await pollJob(client, response.job_id, {
+            onStatus: () => { },
+        });
+        if (finalStatus.status !== "completed") {
+            failSpinner(`Job failed: ${finalStatus.error || "unknown error"}`);
+            if (isJsonMode()) {
+                printJson({ job_id: response.job_id, status: finalStatus.status, error: finalStatus.error, elapsed_ms: Date.now() - start });
+            }
+            process.exit(1);
+        }
+        const result = await getJobResult(client, response.job_id);
+        if (result.assets.length === 0) {
+            failSpinner("No assets returned");
+            process.exit(1);
+        }
+        updateSpinner("Downloading...");
+        const files = await downloadAssets(client, result.assets, prompt, opts.output);
+        const elapsed = Date.now() - start;
+        succeedSpinner("Done!");
+        if (isJsonMode()) {
+            printJson({
+                job_id: response.job_id,
+                status: "completed",
+                files: files.map((f) => ({ path: f.path, mime_type: f.mime_type })),
+                model: response.model,
+                cost: finalStatus.cost,
+                elapsed_ms: elapsed,
+            });
+        }
+        else {
+            for (const f of files)
+                printSuccess(`Created ${f.path}`);
+            printInfo(`${files.length} file(s) · ${(elapsed / 1000).toFixed(1)}s · cost: ${finalStatus.cost ?? "n/a"}`);
+        }
+    }
+    catch (err) {
+        failSpinner("Failed");
+        if (err instanceof ApiError) {
+            printError(`API error (${err.status}): ${err.message}`);
+            if (isJsonMode())
+                printJson({ error: err.message, status: err.status, elapsed_ms: Date.now() - start });
+        }
+        else {
+            printError(err.message);
+            if (isJsonMode())
+                printJson({ error: err.message, elapsed_ms: Date.now() - start });
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=sfx.js.map

package/dist/commands/sfx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfx.js","sourceRoot":"","sources":["../../src/commands/sfx.ts"],"names":[],"mappings":"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"}

package/dist/commands/video.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const videoCommand: Command;

package/dist/commands/video.js

@@ -0,0 +1,161 @@
+import { Command } from "commander";
+import { PixClient } from "../lib/client.js";
+import { resolveApiKey, resolveBaseUrl } from "../lib/config.js";
+import { pollJob, getJobResult } from "../lib/poller.js";
+import { downloadAssets } from "../lib/download.js";
+import { setJsonMode, isJsonMode, startSpinner, updateSpinner, succeedSpinner, failSpinner, printSuccess, printInfo, printJson, printError, } from "../lib/output.js";
+import { ApiError } from "../lib/client.js";
+import { resolveImageArg, resolveVideoArg } from "../lib/upload.js";
+export const videoCommand = new Command("video")
+    .description("Generate a video from a text prompt and optional source image")
+    .argument("<prompt>", "Text description of the video to generate")
+    .option("--from <path-or-url>", "Source image (I2V) or video (extend) — local file or URL")
+    .option("-d, --duration <seconds>", "Duration in seconds (2-10)", "5")
+    .option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:3, 3:4)", "16:9")
+    .option("-q, --quality <level>", "Quality level (draft, standard, high)", "standard")
+    .option("-m, --model <model>", "Specific model ID (uses advanced endpoint)")
+    .option("-o, --output <path>", "Output file or directory path")
+    .option("--json", "Output machine-readable JSON", false)
+    .option("--no-enrich", "Skip prompt enrichment (advanced mode only)")
+    .option("--extend", "Extend the source video instead of generating from image", false)
+    .action(async (prompt, opts) => {
+    const globalOpts = videoCommand.parent?.opts();
+    if (opts.json)
+        setJsonMode(true);
+    let client;
+    try {
+        const apiKey = resolveApiKey(globalOpts);
+        const baseUrl = resolveBaseUrl(globalOpts);
+        client = new PixClient(baseUrl, apiKey);
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+    const start = Date.now();
+    try {
+        let fromUrl;
+        if (opts.from) {
+            startSpinner("Preparing...");
+            if (opts.extend) {
+                fromUrl = await resolveVideoArg(client, opts.from, () => {
+                    updateSpinner("Uploading source video...");
+                });
+            }
+            else {
+                fromUrl = await resolveImageArg(client, opts.from, () => {
+                    updateSpinner("Uploading source image...");
+                });
+            }
+        }
+        let response;
+        const duration = parseInt(opts.duration, 10);
+        if (opts.extend) {
+            if (!fromUrl) {
+                printError("--extend requires --from <video>");
+                process.exit(1);
+            }
+            startSpinner("Extending video...");
+            response = await client.post("/api/v1/video/extend", {
+                prompt,
+                video: fromUrl,
+                duration,
+            });
+        }
+        else if (opts.model) {
+            startSpinner(`Generating video with ${opts.model}...`);
+            response = await client.post("/api/v1/video/advanced", {
+                prompt,
+                model: opts.model,
+                image: fromUrl,
+                enrich_prompt: opts.enrich !== false ? true : false,
+                params: {
+                    duration,
+                    aspect_ratio: opts.ratio,
+                },
+            });
+        }
+        else {
+            startSpinner("Generating video...");
+            response = await client.post("/api/v1/video", {
+                prompt,
+                image: fromUrl,
+                duration,
+                aspect_ratio: opts.ratio,
+                quality: opts.quality,
+            });
+        }
+        if (!isJsonMode()) {
+            printInfo(`Job ${response.job_id} submitted (model: ${response.model || "auto"})`);
+        }
+        updateSpinner("Processing...");
+        const finalStatus = await pollJob(client, response.job_id, {
+            timeoutMs: 300_000, // 5 min for video
+            onStatus: (s) => {
+                if (s.total_steps > 1) {
+                    updateSpinner(`Processing step ${s.current_step}/${s.total_steps}...`);
+                }
+            },
+        });
+        if (finalStatus.status !== "completed") {
+            failSpinner(`Job failed: ${finalStatus.error || "unknown error"}`);
+            if (isJsonMode()) {
+                printJson({
+                    job_id: response.job_id,
+                    status: finalStatus.status,
+                    error: finalStatus.error,
+                    elapsed_ms: Date.now() - start,
+                });
+            }
+            process.exit(1);
+        }
+        const result = await getJobResult(client, response.job_id);
+        if (result.assets.length === 0) {
+            failSpinner("No assets returned");
+            process.exit(1);
+        }
+        updateSpinner("Downloading...");
+        const files = await downloadAssets(client, result.assets, prompt, opts.output);
+        const elapsed = Date.now() - start;
+        succeedSpinner("Done!");
+        if (isJsonMode()) {
+            printJson({
+                job_id: response.job_id,
+                status: "completed",
+                files: files.map((f) => ({
+                    path: f.path,
+                    width: f.width,
+                    height: f.height,
+                    mime_type: f.mime_type,
+                })),
+                model: response.model,
+                cost: finalStatus.cost,
+                elapsed_ms: elapsed,
+            });
+        }
+        else {
+            for (const f of files) {
+                const dims = f.width && f.height ? ` (${f.width}x${f.height})` : "";
+                printSuccess(`Created ${f.path}${dims}`);
+            }
+            printInfo(`${files.length} file(s) · ${(elapsed / 1000).toFixed(1)}s · cost: ${finalStatus.cost ?? "n/a"}`);
+        }
+    }
+    catch (err) {
+        failSpinner("Failed");
+        if (err instanceof ApiError) {
+            printError(`API error (${err.status}): ${err.message}`);
+            if (isJsonMode()) {
+                printJson({ error: err.message, status: err.status, elapsed_ms: Date.now() - start });
+            }
+        }
+        else {
+            printError(err.message);
+            if (isJsonMode()) {
+                printJson({ error: err.message, elapsed_ms: Date.now() - start });
+            }
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=video.js.map

package/dist/commands/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/commands/video.ts"],"names":[],"mappings":"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"}

package/dist/commands/voice.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const voiceCommand: Command;

package/dist/commands/voice.js

@@ -0,0 +1,91 @@
+import { Command } from "commander";
+import { PixClient } from "../lib/client.js";
+import { resolveApiKey, resolveBaseUrl } from "../lib/config.js";
+import { pollJob, getJobResult } from "../lib/poller.js";
+import { downloadAssets } from "../lib/download.js";
+import { setJsonMode, isJsonMode, startSpinner, updateSpinner, succeedSpinner, failSpinner, printSuccess, printInfo, printJson, printError, } from "../lib/output.js";
+import { ApiError } from "../lib/client.js";
+export const voiceCommand = new Command("voice")
+    .description("Generate speech from text (text-to-speech)")
+    .argument("<text>", "Text to convert to speech")
+    .option("--voice <name>", "Voice preset (Rachel, Aria, Roger, Sarah, Laura, Charlie, George, etc.)", "Rachel")
+    .option("--language <code>", "Language code (eng, spa, fra, deu, jpn, etc.)")
+    .option("-o, --output <path>", "Output file path (.mp3)")
+    .option("--json", "Output machine-readable JSON", false)
+    .action(async (text, opts) => {
+    const globalOpts = voiceCommand.parent?.opts();
+    if (opts.json)
+        setJsonMode(true);
+    let client;
+    try {
+        const apiKey = resolveApiKey(globalOpts);
+        const baseUrl = resolveBaseUrl(globalOpts);
+        client = new PixClient(baseUrl, apiKey);
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+    const start = Date.now();
+    try {
+        startSpinner("Generating speech...");
+        const response = await client.post("/api/v1/audio/voice", {
+            text,
+            voice: opts.voice,
+            language: opts.language,
+        });
+        if (!isJsonMode()) {
+            printInfo(`Job ${response.job_id} submitted (model: ${response.model || "auto"})`);
+        }
+        updateSpinner("Processing...");
+        const finalStatus = await pollJob(client, response.job_id, {
+            onStatus: () => { },
+        });
+        if (finalStatus.status !== "completed") {
+            failSpinner(`Job failed: ${finalStatus.error || "unknown error"}`);
+            if (isJsonMode()) {
+                printJson({ job_id: response.job_id, status: finalStatus.status, error: finalStatus.error, elapsed_ms: Date.now() - start });
+            }
+            process.exit(1);
+        }
+        const result = await getJobResult(client, response.job_id);
+        if (result.assets.length === 0) {
+            failSpinner("No assets returned");
+            process.exit(1);
+        }
+        updateSpinner("Downloading...");
+        const files = await downloadAssets(client, result.assets, text, opts.output);
+        const elapsed = Date.now() - start;
+        succeedSpinner("Done!");
+        if (isJsonMode()) {
+            printJson({
+                job_id: response.job_id,
+                status: "completed",
+                files: files.map((f) => ({ path: f.path, mime_type: f.mime_type })),
+                model: response.model,
+                cost: finalStatus.cost,
+                elapsed_ms: elapsed,
+            });
+        }
+        else {
+            for (const f of files)
+                printSuccess(`Created ${f.path}`);
+            printInfo(`${files.length} file(s) · ${(elapsed / 1000).toFixed(1)}s · cost: ${finalStatus.cost ?? "n/a"}`);
+        }
+    }
+    catch (err) {
+        failSpinner("Failed");
+        if (err instanceof ApiError) {
+            printError(`API error (${err.status}): ${err.message}`);
+            if (isJsonMode())
+                printJson({ error: err.message, status: err.status, elapsed_ms: Date.now() - start });
+        }
+        else {
+            printError(err.message);
+            if (isJsonMode())
+                printJson({ error: err.message, elapsed_ms: Date.now() - start });
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=voice.js.map

package/dist/commands/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/commands/voice.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,14 +2,22 @@
 import { Command } from "commander";
 import { imageCommand } from "./commands/image.js";
 import { editCommand } from "./commands/edit.js";
+import { videoCommand } from "./commands/video.js";
+import { voiceCommand } from "./commands/voice.js";
+import { musicCommand } from "./commands/music.js";
+import { sfxCommand } from "./commands/sfx.js";
 const program = new Command();
 program
     .name("pixcli")
-    .description("The creative toolkit for AI agents — generate and edit images from the command line.")
-    .version("0.1.0")
+    .description("The creative toolkit for AI agents — generate images, videos, and audio from the command line.")
+    .version("0.2.0")
     .option("--key <api_key>", "API key (overrides PIXCLI_API_KEY env var)")
     .option("--api-url <url>", "Base API URL (overrides PIXCLI_API_URL env var)");
 program.addCommand(imageCommand);
 program.addCommand(editCommand);
+program.addCommand(videoCommand);
+program.addCommand(voiceCommand);
+program.addCommand(musicCommand);
+program.addCommand(sfxCommand);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,sFAAsF,CAAC;KACnG,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,4CAA4C,CAAC;KACvE,MAAM,CAAC,iBAAiB,EAAE,iDAAiD,CAAC,CAAC;AAE/E,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,gGAAgG,CAAC;KAC7G,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,4CAA4C,CAAC;KACvE,MAAM,CAAC,iBAAiB,EAAE,iDAAiD,CAAC,CAAC;AAE/E,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/download.js

@@ -8,6 +8,10 @@ const MIME_TO_EXT = {
     "image/svg+xml": ".svg",
     "video/mp4": ".mp4",
     "video/webm": ".webm",
+    "audio/mpeg": ".mp3",
+    "audio/wav": ".wav",
+    "audio/mp4": ".m4a",
+    "audio/ogg": ".ogg",
 };
 function slugify(text) {
     return text

package/dist/lib/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/lib/download.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/lib/download.ts"],"names":[],"mappings":"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"}

package/dist/lib/upload.d.ts

@@ -4,6 +4,11 @@ import type { PixClient } from "./client.js";
  * If it's already a URL, returns it as-is.
  */
 export declare function resolveImageArg(client: PixClient, value: string, onUploadStart?: () => void): Promise<string>;
+/**
+ * If the value is a local video file, uploads it and returns the remote URL.
+ * If it's already a URL, returns it as-is.
+ */
+export declare function resolveVideoArg(client: PixClient, value: string, onUploadStart?: () => void): Promise<string>;
 /**
  * Resolve an array of image arguments (local files or URLs) to remote URLs.
  */

package/dist/lib/upload.js

@@ -8,6 +8,13 @@ const EXT_TO_MIME = {
     ".webp": "image/webp",
     ".gif": "image/gif",
     ".avif": "image/avif",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".mov": "video/quicktime",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".m4a": "audio/mp4",
+    ".ogg": "audio/ogg",
 };
 function isLocalPath(value) {
     if (value.startsWith("http://") || value.startsWith("https://"))
@@ -16,7 +23,7 @@ function isLocalPath(value) {
 }
 function mimeFromPath(filePath) {
     const ext = filePath.toLowerCase().match(/\.\w+$/)?.[0] || "";
-    return EXT_TO_MIME[ext] || "image/png";
+    return EXT_TO_MIME[ext] || "application/octet-stream";
 }
 /**
  * If the value is a local file path, uploads it and returns the remote URL.
@@ -38,6 +45,13 @@ export async function resolveImageArg(client, value, onUploadStart) {
     const result = await client.upload("/api/v1/uploads", formData);
     return result.url;
 }
+/**
+ * If the value is a local video file, uploads it and returns the remote URL.
+ * If it's already a URL, returns it as-is.
+ */
+export async function resolveVideoArg(client, value, onUploadStart) {
+    return resolveImageArg(client, value, onUploadStart);
+}
 /**
  * Resolve an array of image arguments (local files or URLs) to remote URLs.
  */

package/dist/lib/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/lib/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,WAAW,GAA2B;IAC3C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACrB,CAAC;AAEF,SAAS,WAAW,CAAC,KAAa;IACjC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,MAAiB,EACjB,KAAa,EACb,aAA0B;IAE1B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa,EAAE,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAiB,EACjB,MAAgB,EAChB,aAAsD;IAEtD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,eAAe,CAChC,MAAM,EACN,MAAM,CAAC,CAAC,CAAC,EACT,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAC3C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC"}
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/lib/upload.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pixcli",
-	"version": "0.1.1",
+	"version": "0.2.2",
 	"description": "The creative toolkit for AI agents — generate images, edit visuals, and more from the command line.",
 	"type": "module",
 	"bin": {