agent-media-cli 1.8.1 → 1.8.3

package/dist/commands/character-video.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCharacterVideoCommand(program: Command): void;
+//# sourceMappingURL=character-video.d.ts.map

package/dist/commands/character-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-video.d.ts","sourceRoot":"","sources":["../../src/commands/character-video.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuGzC,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiPpE"}

package/dist/commands/character-video.js

@@ -0,0 +1,320 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * `agent-media character-video` command.
+ *
+ * Runs the 3-step Content Machine pipeline end-to-end:
+ *   1. POST /v1/character/sheet-generate     → character_sheet_url
+ *   2. POST /v1/character/storyboard-generate → storyboard_url
+ *   3. POST /v1/generate/character_video     → final 720p MP4
+ *
+ * The user supplies one character source (--description / --actor /
+ * --reference-image), then either --beats or --script for the
+ * storyboard, then duration + aspect ratio for the video. A single
+ * --session-id ties the three steps together so api-v2 can backstop
+ * action_prompt from the storyboard's script/beats.
+ */
+import { randomUUID } from 'node:crypto';
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { extname, basename } from 'node:path';
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner, } from '../lib/output.js';
+import { getApiKey, resolveProfileName } from '../lib/credentials.js';
+import { AgentMediaAPI } from '../lib/api.js';
+import { CLIError, handleError } from '../lib/errors.js';
+const POLL_INTERVAL_MS = 5_000;
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'canceled']);
+const SUPABASE_PUBLIC_BASE = 'https://ppwvarkmpffljlqxkjux.supabase.co/storage/v1/object/public/generation-inputs';
+const IMAGE_MIME = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+const MAX_REFERENCE_IMAGE_BYTES = 5 * 1024 * 1024;
+const VALID_DURATIONS = new Set([5, 10]);
+const VALID_RATIOS = new Set(['9:16', '16:9', '1:1']);
+function isUrl(s) {
+    return /^https?:\/\//i.test(s);
+}
+async function uploadLocalImage(api, filePath, mode) {
+    if (!existsSync(filePath)) {
+        throw new CLIError(`File not found: ${filePath}`, { code: 'FILE_NOT_FOUND' });
+    }
+    const stats = statSync(filePath);
+    if (stats.size > MAX_REFERENCE_IMAGE_BYTES) {
+        throw new CLIError(`Reference image too large: ${(stats.size / 1024 / 1024).toFixed(1)} MB (max 5 MB)`, { code: 'FILE_TOO_LARGE', suggestion: 'Use a smaller image or compress (jpeg/webp).' });
+    }
+    const ext = extname(filePath).toLowerCase();
+    const contentType = IMAGE_MIME[ext];
+    if (!contentType) {
+        throw new CLIError(`Unsupported reference image type: ${ext}. Allowed: ${Object.keys(IMAGE_MIME).join(', ')}`, { code: 'UNSUPPORTED_FILE_TYPE' });
+    }
+    const filename = basename(filePath);
+    const sp = createSpinner(`Uploading ${filename}...`);
+    if (mode === 'human')
+        sp.start();
+    const { upload_url, storage_path } = await api.getUploadUrl(filename, contentType);
+    const buf = readFileSync(filePath);
+    const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+    await api.uploadFile(upload_url, ab, contentType);
+    if (mode === 'human')
+        sp.succeed(`Uploaded ${filename}`);
+    return `${SUPABASE_PUBLIC_BASE}/${storage_path}`;
+}
+async function pollUntilDone(api, jobId, label, expectedSeconds, mode) {
+    const start = Date.now();
+    const spinner = createSpinner(`${label} (~${expectedSeconds}s)...`);
+    if (mode === 'human')
+        spinner.start();
+    let onSigint = null;
+    try {
+        onSigint = () => {
+            if (mode === 'human')
+                spinner.fail(`Aborted while waiting on ${label.toLowerCase()}`);
+            process.exit(130);
+        };
+        process.on('SIGINT', onSigint);
+        while (true) {
+            const job = await api.getJob(jobId);
+            if (TERMINAL_STATUSES.has(job.status)) {
+                const elapsed = Math.round((Date.now() - start) / 1000);
+                if (mode === 'human') {
+                    if (job.status === 'completed')
+                        spinner.succeed(`${label} complete (${elapsed}s)`);
+                    else
+                        spinner.fail(`${label} ${job.status}: ${job.error_message ?? 'unknown error'}`);
+                }
+                return job;
+            }
+            if (mode === 'human') {
+                const elapsed = Math.round((Date.now() - start) / 1000);
+                spinner.text = `${label} ${chalk.dim(`(${elapsed}s)`)}`;
+            }
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+        }
+    }
+    finally {
+        if (onSigint)
+            process.removeListener('SIGINT', onSigint);
+    }
+}
+export function registerCharacterVideoCommand(program) {
+    program
+        .command('character-video')
+        .description('Content Machine: character sheet → storyboard → 720p video, in three orchestrated calls.\n\n' +
+        'Examples:\n' +
+        '  $ agent-media character-video \\\n' +
+        '      --description "Marco, 35yo Italian chef, white uniform, curly black hair" \\\n' +
+        '      --script "Marco walks into his sunlit Brooklyn kitchen, takes a bite of fresh bread, smiles." \\\n' +
+        '      --duration 10 --aspect 9:16 --sync\n\n' +
+        '  $ agent-media character-video \\\n' +
+        '      --actor mei \\\n' +
+        '      --beats "waves hello,holds up product,thumbs up" \\\n' +
+        '      --duration 5 --sync\n\n' +
+        '  $ agent-media character-video \\\n' +
+        '      --reference-image ./photo.png \\\n' +
+        '      --script "..." \\\n' +
+        '      --sync\n\n' +
+        'Provide ONE of --description / --actor / --reference-image, and ONE of --beats / --script.')
+        .option('--description <text>', 'Free-text character description (3-400 chars)')
+        .option('--actor <slug>', 'Actor slug from the agent-media library')
+        .option('--reference-image <pathOrUrl>', 'Local PNG/JPEG/WebP file or public HTTPS URL of a portrait (max 5 MB)')
+        .option('--beats <comma-separated>', 'Comma-separated list of 3-10 beat descriptions for the storyboard')
+        .option('--script <text>', 'Free-text script (10-1500 chars); the model splits it into 4-6 panels')
+        .option('--duration <seconds>', 'Video duration: 5 or 10', '10')
+        .option('--aspect <ratio>', 'Aspect ratio: 9:16, 16:9, or 1:1', '9:16')
+        .option('--no-audio', 'Disable Seedance audio synthesis')
+        .option('--action-prompt <text>', 'Optional explicit scene/location prompt for Seedance (otherwise derived from script/beats)')
+        .option('--webhook-url <url>', 'Webhook to call on completion of the final video step')
+        .option('-s, --sync', 'Wait for each step to complete (default: only sync on the video step)')
+        .action(async (cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        // ── Validate flags BEFORE the auth check so bad args fail fast
+        // without requiring a login round-trip. (Same UX rationale: a user
+        // with the wrong --duration shouldn't see "Not logged in" first.)
+        // Character source — exactly one of description / actor / reference
+        const sources = [cmdOpts.description, cmdOpts.actor, cmdOpts.referenceImage].filter(Boolean).length;
+        if (sources === 0) {
+            throw new CLIError('Provide one of --description, --actor, or --reference-image', {
+                code: 'VALIDATION_ERROR',
+            });
+        }
+        if (cmdOpts.actor && cmdOpts.referenceImage) {
+            throw new CLIError('--actor and --reference-image are mutually exclusive', {
+                code: 'VALIDATION_ERROR',
+            });
+        }
+        // Storyboard source — exactly one of beats / script
+        if (Boolean(cmdOpts.beats) === Boolean(cmdOpts.script)) {
+            throw new CLIError('Provide exactly one of --beats or --script', { code: 'VALIDATION_ERROR' });
+        }
+        const duration = Number(cmdOpts.duration);
+        if (!VALID_DURATIONS.has(duration)) {
+            throw new CLIError(`Invalid --duration: ${cmdOpts.duration}`, {
+                code: 'VALIDATION_ERROR', suggestion: 'Use 5 or 10.',
+            });
+        }
+        if (!VALID_RATIOS.has(cmdOpts.aspect)) {
+            throw new CLIError(`Invalid --aspect: ${cmdOpts.aspect}`, {
+                code: 'VALIDATION_ERROR', suggestion: 'Use 9:16, 16:9, or 1:1.',
+            });
+        }
+        const beats = cmdOpts.beats
+            ? cmdOpts.beats.split(',').map((b) => b.trim()).filter((b) => b.length >= 3)
+            : undefined;
+        if (beats && (beats.length < 3 || beats.length > 10)) {
+            throw new CLIError(`--beats must be 3-10 entries (≥3 chars each); got ${beats.length}`, {
+                code: 'VALIDATION_ERROR',
+            });
+        }
+        // Auth check after validation
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = getApiKey(profileName);
+        if (!apiKey) {
+            throw new CLIError('Not logged in.', {
+                code: 'NOT_AUTHENTICATED',
+                suggestion: "Run 'agent-media login' to authenticate.",
+            });
+        }
+        const sessionId = randomUUID();
+        try {
+            const api = new AgentMediaAPI(apiKey);
+            // ── Resolve reference image (upload local files) ────────────────
+            let referenceImageUrl;
+            if (cmdOpts.referenceImage) {
+                referenceImageUrl = isUrl(cmdOpts.referenceImage)
+                    ? cmdOpts.referenceImage
+                    : await uploadLocalImage(api, cmdOpts.referenceImage, mode);
+            }
+            // ── Step 1: Character sheet ────────────────────────────────────
+            if (mode === 'human') {
+                console.log();
+                console.log(chalk.bold('1/3 · Character sheet'));
+            }
+            const sheetSubmit = await api.characterSheetGenerate({
+                description: cmdOpts.description,
+                actor_slug: cmdOpts.actor,
+                reference_image_url: referenceImageUrl,
+                session_id: sessionId,
+            });
+            if (mode === 'human') {
+                console.log(chalk.dim(`  Job ${sheetSubmit.job_id} · ${sheetSubmit.credits_deducted} credits`));
+            }
+            const sheetJob = await pollUntilDone(api, sheetSubmit.job_id, 'Sheet', sheetSubmit.expected_seconds ?? 180, mode);
+            if (sheetJob.status !== 'completed' || !sheetJob.output_media_url) {
+                throw new CLIError(`Character sheet failed: ${sheetJob.error_message ?? 'no output URL'}`, {
+                    code: 'SHEET_FAILED',
+                });
+            }
+            const characterSheetUrl = sheetJob.output_media_url;
+            if (mode === 'human')
+                console.log(chalk.dim(`  → ${characterSheetUrl}`));
+            // ── Step 2: Storyboard ─────────────────────────────────────────
+            if (mode === 'human') {
+                console.log();
+                console.log(chalk.bold('2/3 · Storyboard'));
+            }
+            const sbSubmit = await api.characterStoryboardGenerate({
+                character_sheet_url: characterSheetUrl,
+                beats,
+                script: cmdOpts.script,
+                ratio: cmdOpts.aspect,
+                session_id: sessionId,
+            });
+            if (mode === 'human') {
+                console.log(chalk.dim(`  Job ${sbSubmit.job_id} · ${sbSubmit.credits_deducted} credits`));
+            }
+            const sbJob = await pollUntilDone(api, sbSubmit.job_id, 'Storyboard', sbSubmit.expected_seconds ?? 180, mode);
+            if (sbJob.status !== 'completed' || !sbJob.output_media_url) {
+                throw new CLIError(`Storyboard failed: ${sbJob.error_message ?? 'no output URL'}`, {
+                    code: 'STORYBOARD_FAILED',
+                });
+            }
+            const storyboardUrl = sbJob.output_media_url;
+            if (mode === 'human')
+                console.log(chalk.dim(`  → ${storyboardUrl}`));
+            // ── Step 3: Video ──────────────────────────────────────────────
+            if (mode === 'human') {
+                console.log();
+                console.log(chalk.bold('3/3 · Video'));
+            }
+            const videoSubmit = await api.characterVideoGenerate({
+                character_sheet_url: characterSheetUrl,
+                storyboard_url: storyboardUrl,
+                action_prompt: cmdOpts.actionPrompt,
+                duration: duration,
+                aspect_ratio: cmdOpts.aspect,
+                generate_audio: cmdOpts.audio,
+                session_id: sessionId,
+                webhook_url: cmdOpts.webhookUrl,
+            });
+            if (mode === 'human') {
+                console.log(chalk.dim(`  Job ${videoSubmit.job_id} · ${videoSubmit.credits_deducted} credits`));
+            }
+            if (!cmdOpts.sync) {
+                // Caller doesn't want to wait on the final video; print what we have so far.
+                switch (mode) {
+                    case 'json':
+                        printJson({
+                            session_id: sessionId,
+                            character_sheet_url: characterSheetUrl,
+                            storyboard_url: storyboardUrl,
+                            video_job_id: videoSubmit.job_id,
+                            video_status: videoSubmit.status,
+                            credits_deducted: videoSubmit.credits_deducted,
+                        });
+                        break;
+                    case 'quiet':
+                        printQuiet(videoSubmit.job_id);
+                        break;
+                    default:
+                        console.log();
+                        console.log(chalk.dim(`  Run 'agent-media status ${videoSubmit.job_id}' to follow the video render`));
+                        console.log();
+                }
+                return;
+            }
+            const videoJob = await pollUntilDone(api, videoSubmit.job_id, 'Video', 180, mode);
+            if (mode === 'json') {
+                const payload = {
+                    session_id: sessionId,
+                    character_sheet_url: characterSheetUrl,
+                    storyboard_url: storyboardUrl,
+                    video_job_id: videoJob.id,
+                    status: videoJob.status,
+                    credits_deducted: videoSubmit.credits_deducted,
+                };
+                if (videoJob.status === 'failed') {
+                    payload['error'] = videoJob.error_message ?? 'Unknown error';
+                    if (videoJob.error_code)
+                        payload['error_code'] = videoJob.error_code;
+                }
+                if (videoJob.output_media_url)
+                    payload['video_url'] = videoJob.output_media_url;
+                printJson(payload);
+                return;
+            }
+            if (mode === 'quiet') {
+                printQuiet(videoJob.output_media_url ?? videoJob.id);
+                return;
+            }
+            if (videoJob.status === 'completed' && videoJob.output_media_url) {
+                console.log();
+                console.log(`  ${chalk.bold('Sheet:')}      ${chalk.cyan(characterSheetUrl)}`);
+                console.log(`  ${chalk.bold('Storyboard:')} ${chalk.cyan(storyboardUrl)}`);
+                console.log(`  ${chalk.bold('Video:')}      ${chalk.cyan(videoJob.output_media_url)}`);
+                console.log();
+            }
+            else if (videoJob.status !== 'completed') {
+                console.log();
+                console.log(chalk.yellow('  Video did not complete successfully.'));
+                console.log();
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=character-video.js.map

package/dist/commands/character-video.js.map

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

package/dist/commands/text-to-video.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerTextToVideoCommand(program: Command): void;
+//# sourceMappingURL=text-to-video.d.ts.map

package/dist/commands/text-to-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-to-video.d.ts","sourceRoot":"","sources":["../../src/commands/text-to-video.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyDzC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqGjE"}

package/dist/commands/text-to-video.js

@@ -0,0 +1,148 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * `agent-media text-to-video` command.
+ *
+ * Pure-prompt video generation via Seedance 2.0 text-to-video at 720p.
+ * No character sheet, no storyboard. The prompt IS the entire creative —
+ * style, subject, mood, composition, lighting. Best for stylistic content
+ * where you want the model to invent everything from the prompt text.
+ *
+ * Cost: 350 / 700 / 1050 credits for 5 / 10 / 15s.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner, } from '../lib/output.js';
+import { getApiKey, resolveProfileName } from '../lib/credentials.js';
+import { AgentMediaAPI } from '../lib/api.js';
+import { CLIError, handleError } from '../lib/errors.js';
+const POLL_INTERVAL_MS = 5_000;
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'canceled']);
+const VALID_DURATIONS = new Set([5, 10, 15]);
+const VALID_RATIOS = new Set(['9:16', '16:9', '1:1']);
+async function pollUntilDone(api, jobId, expectedSeconds, mode) {
+    const start = Date.now();
+    const spinner = createSpinner(`Rendering (~${expectedSeconds}s)...`);
+    if (mode === 'human')
+        spinner.start();
+    let onSigint = null;
+    try {
+        onSigint = () => {
+            if (mode === 'human')
+                spinner.fail('Aborted while waiting');
+            process.exit(130);
+        };
+        process.on('SIGINT', onSigint);
+        while (true) {
+            const job = await api.getJob(jobId);
+            if (TERMINAL_STATUSES.has(job.status)) {
+                const elapsed = Math.round((Date.now() - start) / 1000);
+                if (mode === 'human') {
+                    if (job.status === 'completed')
+                        spinner.succeed(`Done (${elapsed}s)`);
+                    else
+                        spinner.fail(`${job.status}: ${job.error_message ?? 'unknown error'}`);
+                }
+                return job;
+            }
+            if (mode === 'human') {
+                const elapsed = Math.round((Date.now() - start) / 1000);
+                spinner.text = `Rendering ${chalk.dim(`(${elapsed}s)`)}`;
+            }
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+        }
+    }
+    finally {
+        if (onSigint)
+            process.removeListener('SIGINT', onSigint);
+    }
+}
+export function registerTextToVideoCommand(program) {
+    program
+        .command('text-to-video')
+        .description('Pure-prompt text-to-video via Seedance 2.0 — no character, no storyboard. The prompt is the entire creative.\n\n' +
+        'Examples:\n' +
+        '  $ agent-media text-to-video \\\n' +
+        '      --prompt "Handcrafted stop-motion. Miniature practical sets, animation on 2s, warm magical lighting." \\\n' +
+        '      --duration 5 --aspect 9:16 --wait\n\n' +
+        '  $ agent-media text-to-video --prompt-file ./prompts/stop-motion.txt --duration 10 --wait\n\n' +
+        'Use --wait to block until the video is rendered and print the R2 URL; without --wait the command prints the job_id and exits.')
+        .option('--prompt <text>', 'Full video prompt (20–1000 chars). Style + subject + mood + composition all in one string.')
+        .option('--prompt-file <path>', 'Read the prompt from a local file instead of --prompt.')
+        .option('--duration <seconds>', 'Video duration: 5, 10, or 15', '10')
+        .option('--aspect <ratio>', 'Aspect ratio: 9:16, 16:9, or 1:1', '9:16')
+        .option('--no-audio', 'Disable Seedance audio synthesis')
+        .option('--webhook-url <url>', 'HTTPS URL to receive a callback on completion')
+        .option('-w, --wait', 'Block until the job completes and print the video URL')
+        .action(async (cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        try {
+            // Resolve prompt: --prompt wins; otherwise --prompt-file.
+            let promptText = cmdOpts.prompt;
+            if (!promptText && cmdOpts.promptFile) {
+                if (!existsSync(cmdOpts.promptFile)) {
+                    throw new CLIError(`Prompt file not found: ${cmdOpts.promptFile}`, { code: 'FILE_NOT_FOUND' });
+                }
+                promptText = readFileSync(cmdOpts.promptFile, 'utf8').trim();
+            }
+            if (!promptText || promptText.trim().length < 20 || promptText.length > 1000) {
+                throw new CLIError('--prompt (or --prompt-file) is required (20–1000 chars).', { code: 'VALIDATION_ERROR' });
+            }
+            const duration = Number.parseInt(cmdOpts.duration, 10);
+            if (!VALID_DURATIONS.has(duration)) {
+                throw new CLIError(`--duration must be 5, 10, or 15 (got ${cmdOpts.duration})`, { code: 'VALIDATION_ERROR' });
+            }
+            if (!VALID_RATIOS.has(cmdOpts.aspect)) {
+                throw new CLIError(`--aspect must be 9:16, 16:9, or 1:1 (got ${cmdOpts.aspect})`, { code: 'VALIDATION_ERROR' });
+            }
+            const profile = await resolveProfileName(globalOpts.profile);
+            const apiKey = await getApiKey(profile);
+            const api = new AgentMediaAPI(apiKey ?? undefined);
+            const submit = await api.textToVideoGenerate({
+                prompt: promptText.trim(),
+                duration: duration,
+                aspect_ratio: cmdOpts.aspect,
+                generate_audio: cmdOpts.audio,
+                ...(cmdOpts.webhookUrl ? { webhook_url: cmdOpts.webhookUrl } : {}),
+            });
+            if (!cmdOpts.wait) {
+                if (mode === 'json')
+                    printJson({ job_id: submit.job_id, status: submit.status, credits_deducted: submit.credits_deducted });
+                else if (mode === 'quiet')
+                    printQuiet(submit.job_id);
+                else {
+                    console.log(chalk.green(`✔ Submitted job ${submit.job_id} (${submit.credits_deducted} cr deducted).`));
+                    console.log(`  Poll with: ${chalk.cyan(`agent-media inspect ${submit.job_id}`)}`);
+                }
+                return;
+            }
+            const job = await pollUntilDone(api, submit.job_id, duration * 30, mode);
+            if (job.status !== 'completed') {
+                throw new CLIError(`Job ${job.status}: ${job.error_message ?? 'unknown error'}`, { code: 'GENERATION_FAILED' });
+            }
+            const videoUrl = job.output_media_url;
+            if (!videoUrl) {
+                throw new CLIError(`Job completed without an output URL (id ${submit.job_id})`, { code: 'GENERATION_FAILED' });
+            }
+            if (mode === 'json') {
+                printJson({
+                    job_id: submit.job_id,
+                    video_url: videoUrl,
+                    duration: submit.duration,
+                    aspect_ratio: submit.aspect_ratio,
+                });
+            }
+            else if (mode === 'quiet') {
+                printQuiet(videoUrl);
+            }
+            else {
+                console.log(chalk.green(`\n✔ Done.`));
+                console.log(`  ${chalk.cyan(videoUrl)}`);
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=text-to-video.js.map

package/dist/commands/text-to-video.js.map

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

package/dist/commands/ugc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ugc.d.ts","sourceRoot":"","sources":["../../src/commands/ugc.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4JzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4kBzD"}
+{"version":3,"file":"ugc.d.ts","sourceRoot":"","sources":["../../src/commands/ugc.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgNzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAulBzD"}

package/dist/commands/ugc.js

@@ -18,8 +18,28 @@ import { AgentMediaAPI, } from '../lib/api.js';
 import { CLIError, handleError } from '../lib/errors.js';
 /** Poll interval for --sync mode, in milliseconds. */
 const POLL_INTERVAL_MS = 5_000;
+/** Max consecutive poll failures before we give up. ~3 minutes at 30 s back-off. */
+const POLL_MAX_CONSECUTIVE_FAILURES = 6;
 /** Terminal job statuses that end the polling loop. */
 const TERMINAL_STATUSES = new Set(['completed', 'failed', 'canceled']);
+/**
+ * Poll the API once, tolerating transient network and 5xx failures.
+ *
+ * Returns `null` when the call fails — the caller should keep looping and
+ * try again on the next tick. The CLI used to crash on any fetch error
+ * (e.g. a Railway 502 during an autoscale) even though the job kept
+ * running server-side. Now we just log a dim warning, count consecutive
+ * failures, and bail only after {@link POLL_MAX_CONSECUTIVE_FAILURES}
+ * in a row.
+ */
+async function pollOnce(api, jobId) {
+    try {
+        return await api.pollProvider(jobId);
+    }
+    catch {
+        return null;
+    }
+}
 /** Status labels with color coding. */
 const STATUS_COLORS = {
     pending: chalk.yellow,
@@ -62,10 +82,31 @@ async function waitForJob(api, jobId, mode) {
     const spinner = createSpinner('Producing UGC video...');
     if (mode === 'human')
         spinner.start();
+    let consecutiveFailures = 0;
     try {
         while (!interrupted) {
-            const poll = await api.pollProvider(jobId);
+            const poll = await pollOnce(api, jobId);
             const elapsed = Math.floor((Date.now() - startTime) / 1000);
+            if (!poll) {
+                consecutiveFailures += 1;
+                if (consecutiveFailures >= POLL_MAX_CONSECUTIVE_FAILURES) {
+                    if (mode === 'human') {
+                        spinner.fail(`Lost connection to the API after ${formatElapsed(elapsed)}. ` +
+                            `Job ${jobId} may still be processing — re-run with ` +
+                            `\`agent-media status ${jobId}\` to check.`);
+                    }
+                    throw new CLIError(`Lost connection to the API. Job ${jobId} may still be processing.`, {
+                        code: 'POLL_ABORTED',
+                        suggestion: `Re-run with: agent-media status ${jobId}`,
+                    });
+                }
+                if (mode === 'human') {
+                    spinner.text = `${chalk.yellow('reconnecting')}  elapsed ${formatElapsed(elapsed)}  (attempt ${consecutiveFailures}/${POLL_MAX_CONSECUTIVE_FAILURES})`;
+                }
+                await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+                continue;
+            }
+            consecutiveFailures = 0;
             const status = poll.status;
             if (mode === 'human') {
                 // Show granular progress stage when available
@@ -175,7 +216,11 @@ export function registerUGCCommand(program) {
         .option('--pip-animation <anim>', 'PIP overlay animation: slide-up (default), slide-left, slide-right, fade, scale')
         .option('--pip-style <style>', 'PIP overlay frame style: none (default), rounded, shadow')
         .option('-s, --sync', 'Wait for completion and print the output URL')
-        .action(async (scriptOrFile, cmdOpts) => {
+        .action(async (scriptOrFile, cmdOpts, command) => {
+        // Detect whether --style was passed explicitly vs falling through to the
+        // default 'hormozi'. Without this distinction we'd randomize subtitle
+        // style even when the user typed `--style hormozi` on the command line.
+        const styleWasExplicit = command.getOptionValueSource('style') === 'cli';
         const globalOpts = program.opts();
         const mode = detectOutputMode(globalOpts);
         const profileName = resolveProfileName(globalOpts.profile);
@@ -352,8 +397,13 @@ export function registerUGCCommand(program) {
                     }
                 }
             }
-            // ── Auto-select random style if default (hormozi) ─────────────
-            if (cmdOpts.style === 'hormozi') {
+            // ── Auto-select random style only when --style was NOT passed ───
+            // Commander reports the source as 'cli' for explicit flags and
+            // 'default' when the value came from the .option(default) argument.
+            // Previously we compared the value to 'hormozi' which conflated the
+            // two — so users got randomized styles even when they explicitly
+            // asked for hormozi.
+            if (!styleWasExplicit) {
                 const ALL_STYLES = [
                     'hormozi', 'tiktok', 'minimal', 'clean', 'bold', 'impact', 'fire',
                     'pop', 'spotlight', 'aesthetic', 'pastel', 'glow', 'neon',
@@ -366,6 +416,9 @@ export function registerUGCCommand(program) {
                     console.log(chalk.dim(`  Tip: pick a specific style with --style <name>`));
                 }
             }
+            else if (mode === 'human') {
+                console.log(`  Style:   ${chalk.cyan(cmdOpts.style)}`);
+            }
             if (cmdOpts.brollImages) {
                 const raw = cmdOpts.brollImages.split(',').map((u) => u.trim()).filter(Boolean);
                 if (raw.length === 0) {