batchedits 1.3.0 → 1.4.0

package/README.md

@@ -19,7 +19,8 @@ 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>] [--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) |
@@ -35,6 +36,13 @@ 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. Find one 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 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

package/dist/cli.js

@@ -369,7 +369,7 @@ 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.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"
 ].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 +387,13 @@ 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");
+  }
   return out;
 }
 function parseValue(raw) {
@@ -536,6 +542,19 @@ 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]",
@@ -549,9 +568,12 @@ 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 <id|words>  An intro clip before each video, from `batchedits hooks` (an id, or words for the best match).",
+      "                  With --hook too, the text hook is drawn on the clip.",
       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"'
     ].join("\n"),
     async run({ api, positionals, flags }) {
       const name = positionals.join(" ").trim();
@@ -717,7 +739,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.3.0" : "dev";
+var VERSION = true ? "1.4.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -736,6 +758,7 @@ var FLAG_OPTIONS = {
   zoom: { type: "boolean" },
   clips: { type: "string" },
   hook: { type: "boolean" },
+  "hook-clip": { type: "string" },
   hooks: { type: "string" },
   set: { type: "string", multiple: true },
   remove: { type: "string", multiple: true },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "batchedits",
-  "version": "1.3.0",
+  "version": "1.4.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",