batchedits 1.1.0 → 1.3.0

package/README.md

@@ -19,15 +19,35 @@ 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]]` | 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`, `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 \
+  --set captions.position=center --set captions.highlightColor=#FF6B00 --set zoom.zoomPercent=125
+batchedits style edit "Shorts" --set captions.fontColor=#FFFF00 --remove zoom
+```
+
 ## Sign in
 
 - `batchedits login` opens BatchEdits in your browser to approve the CLI, then stores the login in `~/.config/batchedits`. The token is never printed, so agents can run commands without seeing it.

package/dist/cli.js

@@ -355,6 +355,81 @@ 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_ALIASES = {
+  crop: "crop_video",
+  silence: "remove_silence",
+  repeats: "remove_repeated_sentences",
+  captions: "add_captions",
+  zoom: "punch_zoom",
+  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",
+  "                  hook.position=top|center|bottom  hook.y=0.3  hook.duration=auto|3  hook.source=ai|manual  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] : [];
+var sortActions = (a) => [...a].sort((x, y) => (ACTION_ORDER.indexOf(x.name) + 1 || 99) - (ACTION_ORDER.indexOf(y.name) + 1 || 99));
+function upsert(actions, name, params) {
+  const existing = actions.find((a) => a.name === name);
+  if (!existing) return sortActions([...actions, { name, ...params ? { customParams: params } : {} }]);
+  return actions.map((a) => a.name === name && params ? { ...a, customParams: { ...a.customParams ?? {}, ...params } } : a);
+}
+function applyFlagActions(actions, flags) {
+  let out = actions;
+  if (typeof flags.crop === "string") out = upsert(out, "crop_video", { aspectRatio: flags.crop });
+  if (flags.silence) out = upsert(out, "remove_silence");
+  if (flags.repeats) out = upsert(out, "remove_repeated_sentences");
+  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) {
+  if (raw === "true" || raw === "false") return raw === "true";
+  if (raw.trim() !== "" && !Number.isNaN(Number(raw))) return Number(raw);
+  return raw;
+}
+function applySets(actions, sets) {
+  let out = actions;
+  for (const entry of list(sets)) {
+    const m = entry.match(/^([\w-]+)\.([\w-]+)=(.*)$/s);
+    if (!m) throw new CliError(`Can't read --set ${entry}.`, EXIT.USAGE, "Use action.setting=value, e.g. --set captions.position=center");
+    out = upsert(out, actionName(m[1]), { [m[2]]: parseValue(m[3]) });
+  }
+  return out;
+}
+async function actionIds(api) {
+  const { actions } = await api.call("list_actions");
+  return new Map(actions.map((a) => [a.name, a.id]));
+}
+function toToolActions(actions, ids) {
+  const unknown = actions.filter((a) => !ids.has(a.name)).map((a) => a.name);
+  if (unknown.length) throw new CliError(`Unknown edit: ${unknown.join(", ")}.`, EXIT.USAGE, `Use one of: ${Object.keys(ACTION_ALIASES).join(", ")} (or a name from: batchedits actions).`);
+  return actions.map((a) => ({ id: ids.get(a.name), ...a.customParams ? { customParams: a.customParams } : {} }));
+}
+function describeActions(actions) {
+  return actions.map((a) => {
+    const p = Object.entries(a.customParams ?? {}).filter(([k]) => !["focusX", "focusY", "fitToVideo"].includes(k));
+    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);
@@ -463,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]",
+    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)",
@@ -473,29 +548,59 @@ 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)",
-      'Example: batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom'
+      "  --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 "Hooks" --captions --hook --set hook.position=top --set hook.duration=3'
     ].join("\n"),
     async run({ api, positionals, flags }) {
       const name = positionals.join(" ").trim();
       if (!name) throw new CliError("Give the style a name.", EXIT.USAGE, 'Example: batchedits style create "Shorts" --captions --silence');
-      const { actions } = await api.call("list_actions");
-      const byName = new Map(actions.map((a) => [a.name, a.id]));
-      const wanted = [];
-      if (typeof flags.crop === "string") wanted.push({ name: "crop_video", customParams: { aspectRatio: flags.crop } });
-      if (flags.silence) wanted.push({ name: "remove_silence" });
-      if (flags.repeats) wanted.push({ name: "remove_repeated_sentences" });
-      if (flags.captions || flags.emojis) wanted.push({ name: "add_captions", customParams: flags.emojis ? { emojis: true } : void 0 });
-      if (flags.zoom) wanted.push({ name: "punch_zoom" });
-      if (flags.clips) wanted.push({ name: "ai_clips", customParams: typeof flags.clips === "string" ? { maxClips: Number(flags.clips) } : void 0 });
+      const ids = await actionIds(api);
+      const wanted = applySets(applyFlagActions([], flags), flags.set);
       if (wanted.length === 0) throw new CliError("Pick at least one edit.", EXIT.USAGE, "See: batchedits style create --help");
-      const missing = wanted.filter((w) => !byName.has(w.name)).map((w) => w.name);
-      if (missing.length) throw new CliError(`This server doesn't support: ${missing.join(", ")}.`);
-      const res = await api.call("create_style", {
-        name,
-        actions: wanted.map((w) => ({ id: byName.get(w.name), ...w.customParams ? { customParams: w.customParams } : {} }))
-      });
-      if (isJson()) printJson({ styleId: res.styleId, name });
-      else say(`Created style "${name}" (${res.styleId}). Use it with: --style "${name}"`);
+      const res = await api.call("create_style", { name, actions: toToolActions(wanted, ids) });
+      if (isJson()) printJson({ styleId: res.styleId, name, actions: wanted });
+      else say(`Created style "${name}" (${res.styleId}): ${describeActions(wanted)}.
+Use it with: --style "${name}"`);
+      return EXIT.OK;
+    }
+  },
+  "style edit": {
+    summary: "Change a style's edits and settings",
+    usage: "batchedits style edit <name|id> [same flags as style create] [--set action.setting=value\u2026] [--remove <action>\u2026] [--name <new name>]",
+    help: [
+      "Changes a saved style in place. Flags add an edit (or update it, e.g. --crop 1:1); other edits stay as they are.",
+      "  --remove <action>  Remove an edit, e.g. --remove zoom (repeatable)",
+      "  --name <name>      Rename the style",
+      SET_HELP,
+      "Videos already edited keep their look; the next ones use the new settings.",
+      'Example: batchedits style edit "Shorts" --set captions.fontColor=#FFFF00 --remove zoom'
+    ].join("\n"),
+    async run({ api, positionals, flags }) {
+      const ref = positionals.join(" ").trim();
+      if (!ref) throw new CliError("Give the style to edit.", EXIT.USAGE, 'Example: batchedits style edit "Shorts" --set captions.position=center');
+      const style = await resolveStyle(api, ref);
+      const ids = await actionIds(api);
+      let actions = (style.actions ?? []).map((a) => ({ name: a.name, ...a.customParams ? { customParams: { ...a.customParams } } : {} }));
+      const removes = list(flags.remove).map(actionName);
+      const missing = removes.filter((r) => !actions.some((a) => a.name === r));
+      if (missing.length) throw new CliError(`"${style.name}" has no ${missing.join(", ")} to remove.`, EXIT.USAGE, `It has: ${describeActions(actions) || "no edits"}.`);
+      actions = actions.filter((a) => !removes.includes(a.name));
+      actions = applySets(applyFlagActions(actions, flags), flags.set);
+      const newName = typeof flags.name === "string" ? flags.name.trim() : void 0;
+      if (actions.length === 0) throw new CliError("A style needs at least one edit.", EXIT.USAGE, "Remove fewer edits, or add one with a flag like --captions.");
+      await api.call("edit_style", { styleId: style.id, ...newName ? { name: newName } : {}, actions: toToolActions(actions, ids) });
+      const saved = (await api.styles()).find((s) => s.id === style.id);
+      const savedNames = (saved?.actions ?? []).map((a) => a.name).join(",");
+      const setKeys = list(flags.set).map((e) => e.split("=")[0].split(".")).map(([a, k]) => [actionName(a), k]);
+      const keysSaved = setKeys.every(([a, k]) => saved?.actions?.find((x) => x.name === a)?.customParams?.[k] !== void 0);
+      if (savedNames !== actions.map((a) => a.name).join(",") || !keysSaved) {
+        throw new CliError("The server didn't save the new edits.", EXIT.ERROR, "It may not support editing styles yet. Create a new style with: batchedits style create");
+      }
+      const finalName = newName || style.name;
+      if (isJson()) printJson({ styleId: style.id, name: finalName, actions });
+      else say(`Updated style "${finalName}": ${describeActions(actions)}.`);
       return EXIT.OK;
     }
   },
@@ -521,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;
@@ -581,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 = [];
@@ -594,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");
@@ -610,7 +717,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.1.0" : "dev";
+var VERSION = true ? "1.3.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -627,7 +734,12 @@ var FLAG_OPTIONS = {
   repeats: { type: "boolean" },
   crop: { type: "string" },
   zoom: { type: "boolean" },
-  clips: { type: "string" }
+  clips: { type: "string" },
+  hook: { type: "boolean" },
+  hooks: { type: "string" },
+  set: { type: "string", multiple: true },
+  remove: { type: "string", multiple: true },
+  name: { type: "string" }
 };
 function mainHelp() {
   const names = Object.keys(commands);
@@ -646,6 +758,7 @@ function mainHelp() {
     "Quick start:",
     "  batchedits login",
     '  batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom',
+    '  batchedits style edit "Shorts" --set captions.position=center',
     '  batchedits run ./raw --style "Shorts" --out ./edited',
     "",
     "Exit codes: 0 ok \xB7 1 error \xB7 2 usage \xB7 3 sign in needed \xB7 4 some videos failed \xB7 5 needs --yes"

package/package.json

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