batchedits 1.3.1 → 1.5.0

package/README.md

@@ -19,13 +19,14 @@ Needs Node.js 18.17+ and a [BatchEdits](https://batchedits.com) account (7-day f
 | `login` / `logout` / `whoami` | Sign in through your browser; check the connection |
 | `styles` | List your styles |
 | `actions` | List editing actions and their settings |
-| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--crop 9:16] [--zoom] [--clips [n]] [--hook] [--set action.setting=value…]` | Create a style from flags |
+| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--crop 9:16] [--zoom] [--clips [n]] [--hook] [--hook-clip <id or words>] [--broll] [--cta [text]] [--set action.setting=value…]` | Create a style from flags |
+| `hooks [words]` | Find intro clips for a video hook |
 | `style edit <name> [same flags] [--set …] [--remove <action>…] [--name <new>]` | Change a saved style's edits and settings |
 | `upload <files or folders…>` | Upload up to 50 videos, print their ids |
 | `process <ids…> --style <name> [--yes]` | Edit videos (1 credit each, 1 per AI clip) |
 | `status [ids…] [--watch]` | Show status, or wait until done |
 | `download <ids…> [--out dir]` | Save finished videos (and their AI clips) |
-| `run <files or folders…> --style <name> [--out dir] [--hooks file] [--yes]` | All of the above in one go |
+| `run <files or folders…> --style <name> [--out dir] [--hooks file] [--ctas file] [--yes]` | All of the above in one go |
 
 Every command has `--help` with an example, and `--json` for machine-readable output.
 
@@ -35,6 +36,14 @@ Every command has `--help` with an example, and `--json` for machine-readable ou
 
 ### Hooks
 
+`--hook-clip` plays a short intro clip (a video hook) before every video. `--hook-clip ai` lets AI pick a different matching clip for each video. To use one clip for all of them, find it with `batchedits hooks <words>`, then pass its id, or just the words for the best match. With `--hook` too, the text hook is drawn on the clip:
+
+```bash
+batchedits hooks surprise reaction
+batchedits style create "Intro" --captions --hook --hook-clip ai
+batchedits style create "Intro" --captions --hook --hook-clip 727
+```
+
 `--hook` adds a text hook at the start of every video; AI writes each line. To use your own, put one hook per line in a file and pass it with `--hooks` (line 1 → first video, in upload order; a folder uploads its files A-Z):
 
 ```bash
@@ -42,6 +51,19 @@ batchedits style create "Hooks" --captions --silence --hook --set hook.position=
 batchedits run ./raw --style "Hooks" --hooks hooks.txt --out ./edited --yes
 ```
 
+`--broll` cuts away to B-roll while you talk about what it shows. Upload clips in the dashboard's Library and name what each shows ("Me typing on laptop"): AI matches the names to what you say, and stock video from Pexels fills the rest (`--set broll.source=mine` for only yours). AI decides how many cutaways each video needs.
+
+```bash
+batchedits style create "Talking head" --silence --broll --captions
+```
+
+`--cta` adds a call to action over the last 3 seconds of every video ("Follow for more" unless you give your own line). For a different line per video, pass a file with `--ctas`, one per line in upload order. An outro clip played after each video is uploaded once in the dashboard's Call to action settings:
+
+```bash
+batchedits style create "Ends" --captions --cta "Comment GUIDE and I'll send it"
+batchedits run ./raw --style "Ends" --ctas ctas.txt --out ./edited --yes
+```
+
 ```bash
 batchedits style create "Shorts" --crop 9:16 --silence --captions \
   --set captions.position=center --set captions.highlightColor=#FF6B00 --set zoom.zoomPercent=125

package/dist/cli.js

@@ -312,7 +312,7 @@ var BatchEdits = class {
   }
 };
 function creditsHint(message, host) {
-  if (/credit/i.test(message)) return `Start your free trial or upgrade: ${host}/onboarding/pricing`;
+  if (/credit/i.test(message) && !/https?:\/\//.test(message)) return `Start your free trial or upgrade: ${host}/onboarding/pricing?from=cli`;
   return void 0;
 }
 
@@ -355,7 +355,7 @@ async function confirm(flags, question) {
   rl.close();
   if (answer !== "y" && answer !== "yes") throw new CliError("Cancelled. Nothing was processed.", EXIT.ERROR);
 }
-var ACTION_ORDER = ["crop_video", "remove_silence", "remove_repeated_sentences", "add_captions", "punch_zoom", "ai_clips", "hook"];
+var ACTION_ORDER = ["crop_video", "remove_silence", "remove_repeated_sentences", "broll", "add_captions", "punch_zoom", "ai_clips", "hook", "cta"];
 var ACTION_ALIASES = {
   crop: "crop_video",
   silence: "remove_silence",
@@ -363,13 +363,17 @@ var ACTION_ALIASES = {
   captions: "add_captions",
   zoom: "punch_zoom",
   clips: "ai_clips",
-  hook: "hook"
+  hook: "hook",
+  cta: "cta",
+  broll: "broll"
 };
 var SET_HELP = [
   "  --set <action.setting=value>  Any setting from `batchedits actions` (repeatable). Adds the edit if missing.",
   "                  captions.position=top|center|bottom  captions.fontColor=#FFFFFF  captions.highlightColor=#FF6B00",
   "                  captions.fontSize=64  silence.silentThreshold=0.06  zoom.zoomPercent=125  clips.maxSeconds=60",
-  "                  hook.position=top|center|bottom  hook.y=0.3  hook.duration=auto|3  hook.source=ai|manual  hook.animation=fade|pop|none  hook.backgroundColor=#FF6B00"
+  "                  hook.position=top|center|bottom  hook.y=0.3  hook.duration=auto|3  hook.source=ai|manual  hook.animation=fade|pop|none  hook.backgroundColor=#FF6B00",
+  '                  cta.text="Link in bio"  cta.duration=auto|5  cta.position=center|top|bottom  cta.animation=pop|fade|none',
+  "                  broll.seconds=auto|3  broll.source=mine_first|mine|stock"
 ].join("\n");
 var actionName = (raw) => ACTION_ALIASES[raw.trim().toLowerCase()] ?? raw.trim().toLowerCase();
 var list = (v) => Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
@@ -387,7 +391,15 @@ function applyFlagActions(actions, flags) {
   if (flags.captions || flags.emojis) out = upsert(out, "add_captions", flags.emojis ? { emojis: true } : void 0);
   if (flags.zoom) out = upsert(out, "punch_zoom");
   if (flags.clips) out = upsert(out, "ai_clips", typeof flags.clips === "string" ? { maxClips: Number(flags.clips) } : void 0);
-  if (flags.hook) out = upsert(out, "hook");
+  const clip = typeof flags["hook-clip"] === "string" ? flags["hook-clip"].trim() : "";
+  if (clip) {
+    const pick = /^\d+$/.test(clip) ? { video: { libraryId: Number(clip) } } : { videoQuery: clip };
+    out = upsert(out, "hook", { kinds: flags.hook ? ["text", "video"] : ["video"], ...pick });
+  } else if (flags.hook) {
+    out = upsert(out, "hook");
+  }
+  if (flags.broll) out = upsert(out, "broll");
+  if (flags.cta) out = upsert(out, "cta", typeof flags.cta === "string" && flags.cta.trim() ? { text: flags.cta.trim() } : void 0);
   return out;
 }
 function parseValue(raw) {
@@ -419,17 +431,20 @@ function describeActions(actions) {
     return p.length ? `${a.name} (${p.map(([k, v]) => `${k} ${v}`).join(", ")})` : a.name;
   }).join(", ");
 }
-function readHooksFile(file, style, count) {
+function readLinesFile(file, style, count, kind) {
   if (typeof file !== "string" || !file) return [];
-  if (!import_node_fs3.default.existsSync(file)) throw new CliError(`No such file: ${file}`, EXIT.USAGE, "Pass a text file with one hook per line.");
+  const noun = kind === "hook" ? "hook" : "call to action";
+  if (!import_node_fs3.default.existsSync(file)) throw new CliError(`No such file: ${file}`, EXIT.USAGE, `Pass a text file with one ${noun} per line.`);
   const lines = import_node_fs3.default.readFileSync(file, "utf8").split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
-  if (!(style.actions ?? []).some((a) => a.name === "hook")) {
-    info(`Note: "${style.name}" has no hook, so --hooks won't show. Add one with: batchedits style edit "${style.name}" --hook`);
+  if (!(style.actions ?? []).some((a) => a.name === kind)) {
+    info(`Note: "${style.name}" has no ${noun}, so --${kind}s won't show. Add one with: batchedits style edit "${style.name}" --${kind}`);
   }
-  if (lines.length < count) info(`Note: ${lines.length} hook${lines.length === 1 ? "" : "s"} for ${count} videos; the rest get an AI hook (or none, if the style's hook source is manual).`);
-  else if (lines.length > count) info(`Note: ${lines.length - count} extra hook line${lines.length - count === 1 ? "" : "s"} ignored.`);
+  const rest = kind === "hook" ? "the rest get an AI hook (or none, if the style's hook source is manual)" : "the rest get the style's line";
+  if (lines.length < count) info(`Note: ${lines.length} line${lines.length === 1 ? "" : "s"} in ${file} for ${count} videos; ${rest}.`);
+  else if (lines.length > count) info(`Note: ${lines.length - count} extra line${lines.length - count === 1 ? "" : "s"} in ${file} ignored.`);
   return lines.slice(0, count).map((l) => l.slice(0, 120));
 }
+var perVideoText = (hooks, ctas, i) => ({ ...hooks[i] ? { hookText: hooks[i] } : {}, ...ctas[i] ? { ctaText: ctas[i] } : {} });
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function withClips(all, ids) {
   const wanted = new Set(ids);
@@ -536,9 +551,22 @@ var commands = {
       return EXIT.OK;
     }
   },
+  hooks: {
+    summary: "Find intro clips for a video hook",
+    usage: "batchedits hooks [words]",
+    help: 'Searches the transitional hook library (short vertical intro clips). Without words, lists the newest.\nUse an id with: batchedits style create "Intro" --hook-clip <id>\nExample: batchedits hooks surprise reaction',
+    async run({ api, positionals }) {
+      const query = positionals.join(" ").trim();
+      const res = await api.call("search_hook_clips", query ? { query } : {});
+      if (isJson()) printJson({ clips: res.clips });
+      else if (res.clips.length === 0) say(res.message);
+      else table(res.clips.map((c) => ({ id: String(c.id), seconds: `${c.seconds}s`, title: c.title })), ["id", "seconds", "title"]);
+      return EXIT.OK;
+    }
+  },
   "style create": {
     summary: "Create a style from simple flags",
-    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--hook] [--set action.setting=value\u2026]",
+    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--hook] [--broll] [--cta [text]] [--set action.setting=value\u2026]",
     help: [
       "Creates a reusable style. Order of edits: crop, silence, repeats, captions, zoom, AI clips.",
       "  --captions      Auto captions (word-by-word highlight)",
@@ -549,9 +577,16 @@ var commands = {
       "  --zoom          Zoom in on key moments",
       "  --clips [n]     Cut long videos into n short clips (default 10; 1 credit per clip)",
       "  --hook          A text hook at the start of each video (AI writes it, or pass --hooks to run/process)",
+      "  --hook-clip <ai|id|words>  An intro clip before each video: ai (AI picks a matching clip for each video),",
+      "                  or one clip from `batchedits hooks` (an id, or words for the best match).",
+      "                  With --hook too, the text hook is drawn on the clip.",
+      "  --broll         Cut away to your B-roll while you talk about what it shows (name clips in the dashboard's Library)",
+      `  --cta [text]    A call to action in each video's last seconds (default "Follow for more"; pass --ctas to run/process for one per video)`,
       SET_HELP,
       'Example: batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom --set captions.position=center',
-      'Example: batchedits style create "Hooks" --captions --hook --set hook.position=top --set hook.duration=3'
+      'Example: batchedits style create "Hooks" --captions --hook --set hook.position=top --set hook.duration=3',
+      'Example: batchedits style create "Intro" --captions --hook --hook-clip "surprise reaction"',
+      `Example: batchedits style create "Ends" --captions --cta "Comment GUIDE and I'll send it"`
     ].join("\n"),
     async run({ api, positionals, flags }) {
       const name = positionals.join(" ").trim();
@@ -626,18 +661,19 @@ Next: batchedits process ${uploaded.map((v) => v.id).join(" ")} --style "<name>"
   },
   process: {
     summary: "Edit videos with a style (uses credits)",
-    usage: "batchedits process <video ids\u2026> --style <name|id> [--hooks <file>] [--yes]",
-    help: 'Queues each video with the style. Each video uses 1 credit; with AI clips each clip uses 1.\nAsks before spending credits; agents and scripts pass --yes.\n  --hooks <file>  One hook per line, in the same order as the ids (for styles with a hook)\nExample: batchedits process 3f2a\u2026 9c1d\u2026 --style "Shorts" --yes',
+    usage: "batchedits process <video ids\u2026> --style <name|id> [--hooks <file>] [--ctas <file>] [--yes]",
+    help: 'Queues each video with the style. Each video uses 1 credit; with AI clips each clip uses 1.\nAsks before spending credits; agents and scripts pass --yes.\n  --hooks <file>  One hook per line, in the same order as the ids (for styles with a hook)\n  --ctas <file>   One call to action per line, same order (for styles with a cta)\nExample: batchedits process 3f2a\u2026 9c1d\u2026 --style "Shorts" --yes',
     async run({ api, positionals, flags }) {
       if (positionals.length === 0) throw new CliError("Give the video ids to process.", EXIT.USAGE, "Find them with: batchedits status");
       const style = await resolveStyle(api, flags.style);
-      const hooks = readHooksFile(flags.hooks, style, positionals.length);
+      const hooks = readLinesFile(flags.hooks, style, positionals.length, "hook");
+      const ctas = readLinesFile(flags.ctas, style, positionals.length, "cta");
       const clips = (style.actions ?? []).some((a) => a.name === "ai_clips");
       await confirm(flags, `Edit ${positionals.length} video${positionals.length === 1 ? "" : "s"} with "${style.name}"? This uses ${positionals.length} credit${positionals.length === 1 ? "" : "s"}${clips ? ", plus 1 per AI clip" : ""}.`);
       const results = [];
       for (const [i, videoId] of positionals.entries()) {
         try {
-          const r = await api.call("process_video", { videoId, styleId: style.id, ...hooks[i] ? { hookText: hooks[i] } : {} });
+          const r = await api.call("process_video", { videoId, styleId: style.id, ...perVideoText(hooks, ctas, i) });
           results.push({ videoId, status: r.status ?? "queued" });
         } catch (err) {
           if (err instanceof CliError && err.hint && results.length === 0) throw err;
@@ -687,13 +723,14 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
   },
   run: {
     summary: "Upload, edit, wait and download in one go",
-    usage: "batchedits run <files or folders\u2026> --style <name|id> [--out ./edited] [--hooks <file>] [--yes]",
-    help: 'Uploads up to 50 videos, edits them with the style, waits, and downloads the results.\n  --hooks <file>  One hook per line, in upload order (a folder uploads its files A-Z), for styles with a hook\nExample: batchedits run ./raw --style "Shorts" --out ./edited --yes',
+    usage: "batchedits run <files or folders\u2026> --style <name|id> [--out ./edited] [--hooks <file>] [--ctas <file>] [--yes]",
+    help: 'Uploads up to 50 videos, edits them with the style, waits, and downloads the results.\n  --hooks <file>  One hook per line, in upload order (a folder uploads its files A-Z), for styles with a hook\n  --ctas <file>   One call to action per line, same order, for styles with a cta\nExample: batchedits run ./raw --style "Shorts" --out ./edited --yes',
     async run(ctx) {
       const { api, positionals, flags } = ctx;
       const files = expandFiles(positionals);
       const style = await resolveStyle(api, flags.style);
-      const hooks = readHooksFile(flags.hooks, style, files.length);
+      const hooks = readLinesFile(flags.hooks, style, files.length, "hook");
+      const ctas = readLinesFile(flags.ctas, style, files.length, "cta");
       const clips = (style.actions ?? []).some((a) => a.name === "ai_clips");
       await confirm(flags, `Edit ${files.length} video${files.length === 1 ? "" : "s"} with "${style.name}"? This uses ${files.length} credit${files.length === 1 ? "" : "s"}${clips ? ", plus 1 per AI clip" : ""}.`);
       const ids = [];
@@ -701,7 +738,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
         info(`Uploading ${i + 1}/${files.length}: ${import_node_path3.default.basename(files[i])}`);
         ids.push((await api.upload(files[i])).id);
       }
-      for (const [i, videoId] of ids.entries()) await api.call("process_video", { videoId, styleId: style.id, ...hooks[i] ? { hookText: hooks[i] } : {} });
+      for (const [i, videoId] of ids.entries()) await api.call("process_video", { videoId, styleId: style.id, ...perVideoText(hooks, ctas, i) });
       info(`Editing ${ids.length} video${ids.length === 1 ? "" : "s"} with "${style.name}"\u2026`);
       const group = await watch(api, ids, Number(flags.interval) || 10);
       const { saved, notReady } = await downloadAll(api, group, typeof flags.out === "string" ? flags.out : "edited");
@@ -717,7 +754,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.3.1" : "dev";
+var VERSION = true ? "1.5.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -736,7 +773,11 @@ var FLAG_OPTIONS = {
   zoom: { type: "boolean" },
   clips: { type: "string" },
   hook: { type: "boolean" },
+  "hook-clip": { type: "string" },
   hooks: { type: "string" },
+  cta: { type: "string" },
+  broll: { type: "boolean" },
+  ctas: { type: "string" },
   set: { type: "string", multiple: true },
   remove: { type: "string", multiple: true },
   name: { type: "string" }
@@ -765,12 +806,13 @@ function mainHelp() {
   ].join("\n");
 }
 function normalizeArgv(argv) {
-  return argv.flatMap((a, i) => a === "--clips" && (argv[i + 1] === void 0 || argv[i + 1].startsWith("-")) ? ["--clips="] : [a]);
+  return argv.flatMap((a, i) => (a === "--clips" || a === "--cta") && (argv[i + 1] === void 0 || argv[i + 1].startsWith("-")) ? [`${a}=`] : [a]);
 }
 async function main() {
   const { values, positionals } = (0, import_node_util.parseArgs)({ args: normalizeArgv(process.argv.slice(2)), options: FLAG_OPTIONS, allowPositionals: true, strict: true });
   const flags = values;
   if (flags.clips === "") flags.clips = true;
+  if (flags.cta === "") flags.cta = true;
   setJsonMode(Boolean(flags.json));
   if (flags.version) {
     console.log(VERSION);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batchedits",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "BatchEdits CLI, SDK and React widgets: edit up to 50 videos at once from your terminal or AI agent (Claude Code, OpenClaw, Hermes)",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",