@usenaive-sdk/cli 0.12.2 → 0.13.0

package/dist/commands/video.js

@@ -1,28 +1,45 @@
-import { Command } from "commander";
+import { Command, Option } from "commander";
 import { apiRequest, handleApiError } from "../client.js";
-import { agentOutput } from "../output.js";
+import { agentOutput, creditCostHint, creditEstimateHint } from "../output.js";
+import { parseDurationArg } from "../lib/duration.js";
+import { REFRAME_FEE_CREDITS } from "../lib/pricing.js";
+// Validate --duration (pure check in lib/duration.ts) and fail fast with a clear,
+// structured message rather than forwarding a bad value that would 422 at fal.
+function durationOrExit(raw) {
+    const parsed = parseDurationArg(raw);
+    if (!parsed.ok) {
+        console.error(JSON.stringify({
+            success: false,
+            action: "video.generate",
+            error: { code: "invalid_argument", message: parsed.message },
+            recovery_steps: [
+                { command: 'naive video generate "your prompt" --model <model> --duration 5', description: "Pass a numeric duration a Kling model accepts" },
+                { command: "naive video models", description: "List models (note: some, e.g. minimax-video, have a fixed length)" },
+            ],
+        }, null, 2));
+        process.exit(1);
+    }
+    return parsed.value;
+}
 export const videoCmd = new Command("video")
-    .description("Generate AI videos, extract clips, and edit videos with captions/effects")
+    .description("Generate AI videos and extract short-form clips")
     .addHelpText("after", `
 Subcommands:
-  naive video generate <prompt>          Generate a video from text or image
-  naive video status <job_id>            Check video generation status
-  naive video models                     List available video models
-  naive video clip <youtube_url>         Extract short-form clips from a YouTube video
-  naive video clip-status <job_id>       Check clip extraction or editing status
-  naive video clip-edit <video_url>      Add captions, effects, and B-roll to a video
+  naive video generate <prompt>   Generate a video from text or image
+  naive video status <job_id>     Check video generation status
+  naive video models              List available video models
+  naive video clip <video_url>    Auto-clip a long video into short clips
+  naive video clip-status <id>    Check clipping job status
 
 Examples:
   $ naive video generate "a rocket launching into space" --model fal-ai/kling-video/v3/pro/text-to-video
-  $ naive video clip "https://youtube.com/watch?v=..." --title "My Clips"
-  $ naive video clip-edit "https://example.com/video.mp4" --title "Edited Video" --magic-zooms --magic-brolls
+  $ naive video clip "https://example.com/video.mp4" --aspect-ratio 9:16
   $ naive video clip-status job-uuid-123
   $ naive video models
 
 Cost:
-  - Video generation: dynamic, model/duration-dependent (use GET /v1/video/pricing to preview)
-  - Video clipping: 4 credits per YouTube video
-  - Video editing: 3 credits per video
+  - Video generation: dynamic, model/duration-dependent (run 'naive video pricing --model <id>' to preview)
+  - Video clipping: metered per input minute
   - Credits deducted only on successful completion
 `);
 videoCmd
@@ -30,7 +47,7 @@ videoCmd
     .description("Generate a video using AI models (async — returns job ID)")
     .requiredOption("--model <model>", "Video model ID (required)")
     .option("--input <json>", "Full input parameters as JSON (overrides other options)")
-    .option("--duration <seconds>", "Video duration in seconds (model-dependent, e.g., 5 or 10)")
+    .option("--duration <seconds>", "Video length in seconds — Kling models only (e.g. 5 or 10); some models have a fixed length and reject it")
     .option("--image-url <url>", "Source image URL for image-to-video models")
     .option("--wait", "Wait for job to complete (polls until done)")
     .addHelpText("after", `
@@ -39,6 +56,12 @@ Examples:
   $ naive video generate "product showcase" --model fal-ai/kling-video/v3/pro/text-to-video --duration 10 --wait
   $ naive video generate --model fal-ai/kling-video/v3/pro/image-to-video --image-url https://example.com/img.jpg --input '{"prompt":"zoom in slowly"}'
 
+Duration:
+  --duration is accepted by Kling models (e.g. fal-ai/kling-video/v3/pro/*), which
+  is why the example above pairs it with one. Fixed-length models such as
+  fal-ai/minimax-video/video-01-live reject --duration — pass a numeric value only
+  with a model that supports it, or omit it to use the model's default length.
+
 What this does:
   1. Submits a video generation request
   2. Returns a job ID (async processing, typically 30-120s)
@@ -60,15 +83,21 @@ Available models (use 'naive video models' for full list):
 
 Parameters (via --input JSON):
   prompt          Text description of the video
-  duration        Duration in seconds: "5" or "10" (model-dependent)
+  duration        Length in seconds (Kling models only): "5" or "10". Fixed-length
+                  models (e.g. minimax-video) reject it — see the Duration note above.
   image_url       Source image for image-to-video
   aspect_ratio    "16:9", "9:16", "1:1" (model-dependent)
   negative_prompt Text describing what to avoid
   cfg_scale       Guidance scale 0-1 (higher = more literal, default 0.5)
   generate_audio  Enable native audio generation (boolean, default true for Kling v3)
 
-Cost: dynamic — based on model pricing ($0.50/credit)
-      Use 'GET /v1/video/pricing?model=<id>&duration=<s>' to preview cost.
+Reading the result (after completion, via 'naive video status <id>'):
+  Submit returns the job under 'id' (job_id is a deprecated alias).
+  The output URL is at result.media[0].url — a flat, model-independent path.
+  (result.result.video.url is the raw provider payload; media[] is preferred.)
+
+Cost: dynamic — based on model pricing ($0.05/credit)
+      Run 'naive video pricing --model <id> --duration <s>' to preview cost before generating.
       Credits deducted only on successful completion. Failed jobs are free.
 `)
     .action(async (prompt, opts) => {
@@ -79,14 +108,14 @@ Cost: dynamic — based on model pricing ($0.50/credit)
     else if (prompt) {
         input = { prompt };
         if (opts.duration)
-            input.duration = opts.duration;
+            input.duration = durationOrExit(opts.duration);
         if (opts.imageUrl)
             input.image_url = opts.imageUrl;
     }
     else if (opts.imageUrl) {
         input = { image_url: opts.imageUrl };
         if (opts.duration)
-            input.duration = opts.duration;
+            input.duration = durationOrExit(opts.duration);
     }
     else {
         console.error(JSON.stringify({
@@ -111,23 +140,28 @@ Cost: dynamic — based on model pricing ($0.50/credit)
         if (opts.wait) {
             agentOutput({
                 action: "video.generate.submitted",
-                result: { job_id: data.job_id, status: "polling", model: opts.model },
+                // Surface the estimate at submit so spend is visible before the wait (N6).
+                result: { job_id: data.job_id, status: "polling", model: opts.model, estimated_credits: data.estimated_credits ?? null },
                 next_steps: [],
-                hints: ["Waiting for video generation to complete (typically 30-120s)..."],
+                hints: [
+                    "Waiting for video generation to complete (typically 30-120s)...",
+                    ...(creditEstimateHint(resp.data) ? [creditEstimateHint(resp.data)] : []),
+                ],
             });
             await pollJob(data.job_id);
         }
         else {
             agentOutput({
                 action: "video.generate.submitted",
-                result: { job_id: data.job_id, status: "queued", model: opts.model },
+                result: { job_id: data.job_id, status: "queued", model: opts.model, estimated_credits: data.estimated_credits ?? null },
                 next_steps: [
                     { command: `naive video status ${data.job_id}`, description: "Check generation progress" },
                     { command: `naive jobs get ${data.job_id}`, description: "Get full job details" },
                 ],
                 hints: [
                     `Video generation submitted (model: ${opts.model})`,
-                    "Credits deducted only on successful completion",
+                    // Echoes the API's pre-flight estimate (same source that bills at completion) — N6.
+                    ...(creditEstimateHint(resp.data) ? [creditEstimateHint(resp.data)] : ["Credits deducted only on successful completion"]),
                     "Typical time: 30-120 seconds depending on model and duration",
                 ],
                 related_commands: ["naive video status", "naive jobs get", "naive jobs"],
@@ -146,6 +180,83 @@ Cost: dynamic — based on model pricing ($0.50/credit)
         });
     }
 });
+videoCmd
+    .command("clip <video_url>")
+    .description("Auto-clip a long video into short clips (async — returns job ID)")
+    // Strict enum via commander's Option.choices — rejects anything outside
+    // the two supported aspect ratios at parse time, so the API never sees a
+    // typo'd value. Default "9:16" matches the REST POST handler's default
+    // (vertical-first social baseline). "16:9" preserves the source aspect.
+    .addOption(new Option("--aspect <ratio>", "Output aspect ratio for generated clips")
+    .choices(["9:16", "16:9"])
+    .default("9:16"))
+    .addHelpText("after", `
+Examples:
+  $ naive video clip https://example.com/podcast.mp4
+  $ naive video clip https://example.com/podcast.mp4 --aspect 16:9
+
+What this does:
+  1. Submits a long video for AI auto-clipping
+  2. Returns a job ID (async processing)
+  3. Check progress with 'naive video clip-status <job_id>'
+
+Input:
+  A public https URL to a video no longer than 90 minutes.
+
+Options:
+  --aspect <ratio>    "9:16" (default, vertical via SAM-3 smart-crop) or "16:9" (preserve source)
+
+Cost: per input minute — credits deducted only on successful completion.
+      9:16 reframe adds a flat ${REFRAME_FEE_CREDITS}-credit face-tracking fee per job.
+`)
+    .action(async (videoUrl, opts) => {
+    const resp = await apiRequest("POST", "/v1/video/clip", {
+        video_url: videoUrl,
+        aspect_ratio: opts.aspect ?? "9:16",
+    });
+    handleApiError("video.clip", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "video.clip.submitted",
+        result: { job_id: data.job_id, status: data.status },
+        next_steps: [
+            { command: `naive video clip-status ${data.job_id}`, description: "Check clipping progress" },
+            { command: `naive jobs get ${data.job_id}`, description: "Get full job details" },
+        ],
+        hints: [
+            "Clip job submitted",
+            "Input must be a public https URL to a video 90 minutes or shorter",
+            "Credits deducted only on successful completion",
+        ],
+        related_commands: ["naive video clip-status", "naive jobs"],
+    });
+});
+videoCmd
+    .command("clip-status <job_id>")
+    .description("Check the status of a video clipping job")
+    .addHelpText("after", `
+Examples:
+  $ naive video clip-status 550e8400-e29b-41d4-a716-446655440000
+
+When completed, the result includes the generated clip URLs.
+`)
+    .action(async (jobId) => {
+    const resp = await apiRequest("GET", `/v1/video/clip/${jobId}`);
+    handleApiError("video.clip-status", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "video.clip-status",
+        result: resp.data,
+        next_steps: [
+            ...(data.status === "queued" || data.status === "processing"
+                ? [{ command: `naive video clip-status ${jobId}`, description: "Check again in 20-30 seconds" }]
+                : []),
+            { command: "naive video clip <video_url>", description: "Clip another video" },
+        ],
+        hints: [`Job status: ${data.status}`],
+        related_commands: ["naive video clip", "naive jobs"],
+    });
+});
 videoCmd
     .command("status <job_id>")
     .description("Check the status of a video generation job")
@@ -166,12 +277,15 @@ When completed, the result includes a video URL.
     const resp = await apiRequest("GET", `/v1/video/${jobId}`);
     handleApiError("video.status", resp);
     const data = resp.data;
+    // N12: prefer the flat, model-independent media[] path; fall back to the raw
+    // provider nesting for older API responses that predate media[].
+    const videoUrl = data.media?.[0]?.url ?? data.result?.video?.url;
     agentOutput({
         action: "video.status",
         result: resp.data,
         next_steps: [
-            ...(data.status === "completed" && data.result?.video
-                ? [{ command: `# Download: curl -o video.mp4 "${data.result.video.url}"`, description: "Download the generated video" }]
+            ...(data.status === "completed" && videoUrl
+                ? [{ command: `# Download: curl -o video.mp4 "${videoUrl}"`, description: "Download the generated video (result.media[0].url)" }]
                 : []),
             ...(data.status === "queued" || data.status === "processing"
                 ? [{ command: `naive video status ${jobId}`, description: "Check again in 10-30 seconds" }]
@@ -181,6 +295,10 @@ When completed, the result includes a video URL.
         hints: [
             `Job status: ${data.status}`,
             ...(data.status === "processing" ? ["Video generation typically takes 30-120 seconds"] : []),
+            // Post-hoc: on completion the job carries the ACTUAL credits_used — same
+            // single source as the pre-flight estimate, so before/at/after agree (N6).
+            ...(creditCostHint(resp.data) ? [creditCostHint(resp.data)] : []),
+            ...(data.status === "failed" ? [`Failed (no credits deducted). Reason: ${data.error || "unknown"}`] : []),
         ],
         related_commands: ["naive video generate", "naive jobs"],
     });
@@ -212,282 +330,84 @@ What this does:
         hints: [
             "Use the model 'id' field as the --model parameter in 'naive video generate'",
             "Text-to-video models accept a text prompt; image-to-video models require --image-url",
+            "Each model includes credits_estimate (~5s clip; null when pricing is unavailable)",
+            "For an exact quote at a given length: naive video pricing --model <id> --duration <s>",
         ],
-        related_commands: ["naive video generate", "naive video status"],
+        related_commands: ["naive video generate", "naive video pricing", "naive video status"],
     });
 });
-// ── Video Clipping ──────────────────────────────────────────────────────
 videoCmd
-    .command("clip <youtube_url>")
-    .description("Extract short-form clips from a YouTube video (async — 5-10 min)")
-    .requiredOption("--title <title>", "Project title for the clipping job")
-    .option("--language <lang>", "Video language code (default: en)")
-    .option("--template <name>", "Caption template name")
-    .option("--min-length <seconds>", "Minimum clip length in seconds (15-300, default: 15)")
-    .option("--max-length <seconds>", "Maximum clip length in seconds (15-300, default: 60)")
-    .option("--wait", "Wait for job to complete (polls until done)")
+    .command("pricing")
+    .description("Preview the estimated credit cost of a video model before generating")
+    .requiredOption("--model <model>", "Video model ID (get IDs from 'naive video models')")
+    .option("--duration <seconds>", "Clip length in seconds to price (default: 5)", "5")
     .addHelpText("after", `
 Examples:
-  $ naive video clip "https://youtube.com/watch?v=abc123" --title "Podcast Highlights"
-  $ naive video clip "https://youtu.be/abc123" --title "Best Moments" --min-length 30 --max-length 90 --wait
+  $ naive video pricing --model fal-ai/kling-video/v3/pro/text-to-video
+  $ naive video pricing --model fal-ai/kling-video/v3/pro/text-to-video --duration 10
 
 What this does:
-  1. Submits a YouTube video for AI clip extraction
-  2. Returns a job ID (async processing, typically 5-10 minutes)
-  3. When complete, returns multiple clips ranked by virality score
-  4. Use --wait to block until done, or check with 'naive video clip-status'
-
-Virality scores (0-100):
-  80+   Strong — prioritize for distribution
-  60-79 Decent — usable content
-  <60   Weak — skip unless no alternatives
+  Returns the ESTIMATED credit cost for one generation, derived from the model's
+  live fal.ai price — the same source that bills the job on completion, so the
+  estimate tracks the real charge. Nothing is spent by this command.
 
-Cost: 4 credits per clipping job. Credits deducted only on completion.
+Cost: free (this is a price preview; generation itself is charged on completion)
 `)
-    .action(async (youtubeUrl, opts) => {
-    const body = {
-        youtube_url: youtubeUrl,
-        title: opts.title,
-    };
-    if (opts.language)
-        body.language = opts.language;
-    if (opts.template)
-        body.template = opts.template;
-    if (opts.minLength)
-        body.min_clip_length = parseInt(opts.minLength);
-    if (opts.maxLength)
-        body.max_clip_length = parseInt(opts.maxLength);
-    const resp = await apiRequest("POST", "/v1/video/clips", body);
-    handleApiError("video.clip", resp);
-    const data = resp.data;
-    if (opts.wait) {
-        agentOutput({
-            action: "video.clip.submitted",
-            result: { job_id: data.job_id, status: "polling" },
-            next_steps: [],
-            hints: ["Waiting for clip extraction to complete (typically 5-10 minutes)..."],
-        });
-        await pollClipJob(data.job_id);
-    }
-    else {
-        agentOutput({
-            action: "video.clip.submitted",
-            result: { job_id: data.job_id, status: "queued" },
-            next_steps: [
-                { command: `naive video clip-status ${data.job_id}`, description: "Check clipping progress" },
-                { command: `naive jobs get ${data.job_id}`, description: "Get full job details" },
-            ],
-            hints: [
-                "Clip extraction submitted — typically takes 5-10 minutes",
-                "Credits deducted only on successful completion (4 credits)",
-                "When complete, clips are ranked by AI virality score (0-100)",
+    .action(async (opts) => {
+    const duration = parseInt(opts.duration ?? "5", 10);
+    if (!Number.isFinite(duration) || duration <= 0) {
+        console.error(JSON.stringify({
+            success: false,
+            action: "video.pricing",
+            error: { code: "invalid_argument", message: "--duration must be a positive number of seconds" },
+            recovery_steps: [
+                { command: `naive video pricing --model ${opts.model} --duration 5`, description: "Price a 5-second clip" },
             ],
-            related_commands: ["naive video clip-status", "naive jobs get", "naive social post"],
-        });
+        }, null, 2));
+        process.exit(1);
     }
-});
-videoCmd
-    .command("clip-status <job_id>")
-    .description("Check the status of a clip extraction or video editing job")
-    .addHelpText("after", `
-Examples:
-  $ naive video clip-status 550e8400-e29b-41d4-a716-446655440000
-
-What this does:
-  Returns the current status of a clipping/editing job:
-  - queued: submitted, processing typically takes 5-10 minutes
-  - completed: clips or edited video ready
-  - failed: processing failed (no credits deducted)
-
-When completed, clip jobs include multiple clips with virality scores.
-Edit jobs include the download URL for the processed video.
-`)
-    .action(async (jobId) => {
-    const resp = await apiRequest("GET", `/v1/video/clips/${jobId}`);
-    handleApiError("video.clip-status", resp);
+    const params = new URLSearchParams({ model: opts.model, duration: String(duration) });
+    const resp = await apiRequest("GET", `/v1/video/pricing?${params}`);
+    handleApiError("video.pricing", resp);
     const data = resp.data;
-    const clips = data.result?.clips ?? [];
-    const topClips = clips.filter((c) => (c.virality_score?.total ?? 0) >= 75);
     agentOutput({
-        action: "video.clip-status",
+        action: "video.pricing",
         result: resp.data,
         next_steps: [
-            ...(data.status === "completed" && clips.length > 0
-                ? [
-                    ...topClips.slice(0, 3).map((c, i) => ({
-                        command: `naive social post "${c.title ?? `Clip ${i + 1}`}" --platforms youtube --youtube-type SHORT --media-url "${c.direct_url}" --publish`,
-                        description: `Post clip ${i + 1} (score: ${c.virality_score?.total ?? "N/A"}) as YouTube Short`,
-                    })),
-                    { command: `# Download top clip: curl -o clip.mp4 "${topClips[0]?.direct_url ?? clips[0]?.direct_url}"`, description: "Download the top-ranked clip" },
-                ]
-                : []),
-            ...(data.status === "completed" && data.result?.video_url
-                ? [{ command: `# Download: curl -o edited.mp4 "${data.result.video_url}"`, description: "Download the edited video" }]
-                : []),
-            ...(data.status === "queued"
-                ? [{ command: `naive video clip-status ${jobId}`, description: "Check again in 30-60 seconds" }]
-                : []),
-            { command: `naive video clip "https://youtube.com/watch?v=..." --title "New Clips"`, description: "Start another clipping job" },
+            { command: `naive video generate "your prompt" --model ${opts.model}${duration ? ` --duration ${duration}` : ""}`, description: "Generate a video with this model" },
+            { command: "naive video models", description: "Compare estimates across all models" },
         ],
         hints: [
-            `Job status: ${data.status}`,
-            ...(data.status === "queued" ? ["Clip extraction typically takes 5-10 minutes"] : []),
-            ...(data.status === "completed" && clips.length > 0
-                ? [
-                    `${clips.length} clips extracted`,
-                    "Scores 80+ are strong candidates for social media distribution",
-                    "Use 'naive social post' to publish top clips directly",
-                ]
-                : []),
+            typeof data.estimated_credits === "number"
+                ? `Estimated cost: ${data.estimated_credits} credits for a ${data.duration_seconds ?? duration}s clip (charged only on successful completion)`
+                : "Pricing unavailable for this model",
+            "This is an estimate; the exact charge is metered from the delivered video's duration",
         ],
-        related_commands: ["naive video clip", "naive video clip-edit", "naive social post", "naive jobs"],
+        related_commands: ["naive video generate", "naive video models"],
     });
 });
-videoCmd
-    .command("clip-edit <video_url>")
-    .description("Add captions, effects, zooms, and B-roll to a video (async — 5-10 min)")
-    .requiredOption("--title <title>", "Project title for the editing job")
-    .option("--language <lang>", "Video language code (default: en)")
-    .option("--template <name>", "Caption template name")
-    .option("--magic-zooms", "Enable AI-powered zooms")
-    .option("--magic-brolls", "Enable AI-generated B-roll")
-    .option("--brolls-percentage <n>", "B-roll percentage (0-100)")
-    .option("--wait", "Wait for job to complete (polls until done)")
-    .addHelpText("after", `
-Examples:
-  $ naive video clip-edit "https://example.com/video.mp4" --title "Edited Podcast"
-  $ naive video clip-edit "https://example.com/video.mp4" --title "Enhanced" --magic-zooms --magic-brolls --wait
-
-What this does:
-  1. Submits a video for AI-powered editing (captions, zooms, B-roll)
-  2. Returns a job ID (async processing, typically 5-10 minutes)
-  3. When complete, returns a download URL for the edited video
-
-Input requirements:
-  - Public URL to an MP4 or MOV file
-  - Maximum file size: 2GB, maximum duration: 2 hours
-
-Cost: 3 credits per edit. Credits deducted only on completion.
-`)
-    .action(async (videoUrl, opts) => {
-    const body = {
-        video_url: videoUrl,
-        title: opts.title,
-    };
-    if (opts.language)
-        body.language = opts.language;
-    if (opts.template)
-        body.template = opts.template;
-    if (opts.magicZooms)
-        body.magic_zooms = true;
-    if (opts.magicBrolls)
-        body.magic_brolls = true;
-    if (opts.brollsPercentage)
-        body.magic_brolls_percentage = parseInt(opts.brollsPercentage);
-    const resp = await apiRequest("POST", "/v1/video/clips/edit", body);
-    handleApiError("video.clip-edit", resp);
-    const data = resp.data;
-    if (opts.wait) {
-        agentOutput({
-            action: "video.clip-edit.submitted",
-            result: { job_id: data.job_id, status: "polling" },
-            next_steps: [],
-            hints: ["Waiting for video editing to complete (typically 5-10 minutes)..."],
-        });
-        await pollClipJob(data.job_id);
-    }
-    else {
-        agentOutput({
-            action: "video.clip-edit.submitted",
-            result: { job_id: data.job_id, status: "queued" },
-            next_steps: [
-                { command: `naive video clip-status ${data.job_id}`, description: "Check editing progress" },
-                { command: `naive jobs get ${data.job_id}`, description: "Get full job details" },
-            ],
-            hints: [
-                "Video edit submitted — typically takes 5-10 minutes",
-                "Credits deducted only on successful completion (3 credits)",
-            ],
-            related_commands: ["naive video clip-status", "naive jobs get"],
-        });
-    }
-});
-async function pollClipJob(jobId) {
-    while (true) {
-        await new Promise((r) => setTimeout(r, 15000));
-        const resp = await apiRequest("GET", `/v1/jobs/${jobId}`);
-        const data = resp.data;
-        if (data.status === "completed" || data.status === "failed") {
-            const clips = data.result?.clips ?? [];
-            const topClips = clips.filter((c) => (c.virality_score?.total ?? 0) >= 75);
-            agentOutput({
-                action: data.type === "video_clip_edit" ? "video.clip-edit.completed" : "video.clip.completed",
-                result: resp.data,
-                next_steps: [
-                    ...(data.status === "completed" && clips.length > 0
-                        ? topClips.slice(0, 2).map((c, i) => ({
-                            command: `naive social post "Your caption" --platforms youtube --youtube-type SHORT --media-url "${c.direct_url}" --publish`,
-                            description: `Post top clip ${i + 1} (score: ${c.virality_score?.total}) as YouTube Short`,
-                        }))
-                        : []),
-                    ...(data.status === "completed" && data.result?.video_url
-                        ? [{ command: `# Download: curl -o edited.mp4 "${data.result.video_url}"`, description: "Download edited video" }]
-                        : []),
-                    { command: `naive video clip "https://youtube.com/watch?v=..." --title "New Clips"`, description: "Start another job" },
-                ],
-                hints: [
-                    data.status === "completed"
-                        ? clips.length > 0
-                            ? `${data.result?.clip_count ?? clips.length} clips ready (top score: ${data.result?.top_virality_score ?? "N/A"})`
-                            : "Video editing complete — download URL available"
-                        : "Job failed — no credits deducted",
-                    ...(data.status === "completed" && clips.length > 0
-                        ? [
-                            "Tip: Use 'naive social post' to publish top clips to YouTube, TikTok, Instagram",
-                            "Tip: Clips are auto-ingested to Media Assets. Use 'naive media list --source video_clipping' to find them.",
-                        ]
-                        : []),
-                    ...(data.status === "completed" && clips.length === 0
-                        ? ["Tip: Edited video is auto-ingested to Media Assets. Use 'naive media list --source video_clipping' to find it."]
-                        : []),
-                ],
-                related_commands: ["naive video clip", "naive video clip-edit", "naive social post", "naive jobs"],
-            });
-            return;
-        }
-        process.stderr.write(`  Status: ${data.status} (clipping typically takes 5-10 minutes)\n`);
-    }
-}
+// Polls a job to completion for `video generate --wait`. Local helper mirroring
+// images.ts/search.ts; the prior copy lived in main's Submagic clip block that
+// was removed during the main->branch merge.
 async function pollJob(jobId) {
     while (true) {
-        await new Promise((r) => setTimeout(r, 5000));
+        await new Promise((r) => setTimeout(r, 2000));
         const resp = await apiRequest("GET", `/v1/jobs/${jobId}`);
+        handleApiError("video.generate.poll", resp);
         const data = resp.data;
         if (data.status === "completed" || data.status === "failed") {
             agentOutput({
                 action: "video.generate.completed",
                 result: resp.data,
-                next_steps: [
-                    ...(data.status === "completed" && data.result?.video
-                        ? [
-                            { command: `# Download: curl -o video.mp4 "${data.result.video.url}"`, description: "Download the generated video" },
-                            { command: `naive social post "Your caption here" --platforms youtube --youtube-type SHORT --media-url "${data.result.video.url}" --publish`, description: "Post as YouTube Short" },
-                            { command: `naive social post "Your caption here" --platforms tiktok --media-url "${data.result.video.url}" --publish`, description: "Post to TikTok" },
-                            { command: `naive social post "Your caption here" --platforms instagram --media-url "${data.result.video.url}" --publish`, description: "Post as Instagram Reel" },
-                        ]
-                        : []),
-                    { command: 'naive video generate "another prompt" --model <model>', description: "Generate another video" },
-                ],
+                next_steps: [{ command: `naive jobs get ${jobId}`, description: "Get full job details" }],
                 hints: [
                     data.status === "completed"
-                        ? "Video generation complete — download URL available. Auto-ingested to Media Assets."
-                        : "Video generation failed — no credits deducted",
-                    ...(data.status === "completed" ? [
-                        "Tip: Use 'naive social post' to publish directly to YouTube, TikTok, Instagram, etc.",
-                        "Tip: Use 'naive media list --source video_generation' to find this video in your asset library.",
-                    ] : []),
+                        ? "Video generation complete"
+                        : `Generation failed — no credits deducted. Reason: ${data.error || "unknown"}`,
+                    // Actual charge, derived from the completed job's credits_used (N6/N7).
+                    ...(creditCostHint(resp.data) ? [creditCostHint(resp.data)] : []),
                 ],
-                related_commands: ["naive video generate", "naive video models", "naive social post", "naive jobs"],
+                related_commands: ["naive video generate", "naive video status", "naive jobs"],
             });
             return;
         }