batchedits 1.2.0 → 1.3.1

package/README.md

@@ -19,19 +19,28 @@ 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]] [--set action.setting=value…]` | Create a style from flags |
+| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--crop 9:16] [--zoom] [--clips [n]] [--hook] [--set action.setting=value…]` | Create a style from flags |
 | `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] [--yes]` | All of the above in one go |
+| `run <files or folders…> --style <name> [--out dir] [--hooks file] [--yes]` | All of the above in one go |
 
 Every command has `--help` with an example, and `--json` for machine-readable output.
 
 ### Settings
 
-`--set action.setting=value` sets anything `batchedits actions` lists. Short action names: `captions`, `silence`, `crop`, `zoom`, `clips`, `repeats`.
+`--set action.setting=value` sets anything `batchedits actions` lists. Short action names: `captions`, `silence`, `crop`, `zoom`, `clips`, `repeats`, `hook`.
+
+### Hooks
+
+`--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
+batchedits style create "Hooks" --captions --silence --hook --set hook.position=top
+batchedits run ./raw --style "Hooks" --hooks hooks.txt --out ./edited --yes
+```
 
 ```bash
 batchedits style create "Shorts" --crop 9:16 --silence --captions \

package/dist/cli.js

@@ -355,19 +355,21 @@ 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"];
+var ACTION_ORDER = ["crop_video", "remove_silence", "remove_repeated_sentences", "add_captions", "punch_zoom", "ai_clips", "hook"];
 var ACTION_ALIASES = {
   crop: "crop_video",
   silence: "remove_silence",
   repeats: "remove_repeated_sentences",
   captions: "add_captions",
   zoom: "punch_zoom",
-  clips: "ai_clips"
+  clips: "ai_clips",
+  hook: "hook"
 };
 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"
+  "                  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"
 ].join("\n");
 var actionName = (raw) => ACTION_ALIASES[raw.trim().toLowerCase()] ?? raw.trim().toLowerCase();
 var list = (v) => Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
@@ -385,6 +387,7 @@ 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");
   return out;
 }
 function parseValue(raw) {
@@ -416,6 +419,17 @@ function describeActions(actions) {
     return p.length ? `${a.name} (${p.map(([k, v]) => `${k} ${v}`).join(", ")})` : a.name;
   }).join(", ");
 }
+function readHooksFile(file, style, count) {
+  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 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 (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.`);
+  return lines.slice(0, count).map((l) => l.slice(0, 120));
+}
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function withClips(all, ids) {
   const wanted = new Set(ids);
@@ -524,7 +538,7 @@ var commands = {
   },
   "style create": {
     summary: "Create a style from simple flags",
-    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--set action.setting=value\u2026]",
+    usage: "batchedits style create <name> [--captions] [--emojis] [--silence] [--crop 9:16] [--zoom] [--clips [n]] [--repeats] [--hook] [--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)",
@@ -534,8 +548,10 @@ var commands = {
       "  --crop <ratio>  Crop every video, e.g. 9:16, 1:1, 4:5",
       "  --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)",
       SET_HELP,
-      'Example: batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom --set captions.position=center'
+      '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'
     ].join("\n"),
     async run({ api, positionals, flags }) {
       const name = positionals.join(" ").trim();
@@ -610,17 +626,18 @@ 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> [--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.\nExample: batchedits process 3f2a\u2026 9c1d\u2026 --style "Shorts" --yes',
+    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',
     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 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 videoId of positionals) {
+      for (const [i, videoId] of positionals.entries()) {
         try {
-          const r = await api.call("process_video", { videoId, styleId: style.id });
+          const r = await api.call("process_video", { videoId, styleId: style.id, ...hooks[i] ? { hookText: hooks[i] } : {} });
           results.push({ videoId, status: r.status ?? "queued" });
         } catch (err) {
           if (err instanceof CliError && err.hint && results.length === 0) throw err;
@@ -670,12 +687,13 @@ 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] [--yes]",
-    help: 'Uploads up to 50 videos, edits them with the style, waits, and downloads the results.\nExample: batchedits run ./raw --style "Shorts" --out ./edited --yes',
+    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',
     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 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 = [];
@@ -683,7 +701,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 videoId of ids) await api.call("process_video", { videoId, styleId: style.id });
+      for (const [i, videoId] of ids.entries()) await api.call("process_video", { videoId, styleId: style.id, ...hooks[i] ? { hookText: hooks[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");
@@ -699,7 +717,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.2.0" : "dev";
+var VERSION = true ? "1.3.1" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -717,6 +735,8 @@ var FLAG_OPTIONS = {
   crop: { type: "string" },
   zoom: { type: "boolean" },
   clips: { type: "string" },
+  hook: { type: "boolean" },
+  hooks: { type: "string" },
   set: { type: "string", multiple: true },
   remove: { type: "string", multiple: true },
   name: { type: "string" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batchedits",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "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",