batchedits 1.1.0 → 1.2.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]]` | Create a style from flags |
+| `style create <name> [--captions] [--emojis] [--silence] [--repeats] [--crop 9:16] [--zoom] [--clips [n]] [--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 |
@@ -28,6 +29,16 @@ Needs Node.js 18.17+ and a [BatchEdits](https://batchedits.com) account (7-day f
 
 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`.
+
+```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,67 @@ 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_ALIASES = {
+  crop: "crop_video",
+  silence: "remove_silence",
+  repeats: "remove_repeated_sentences",
+  captions: "add_captions",
+  zoom: "punch_zoom",
+  clips: "ai_clips"
+};
+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"
+].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);
+  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(", ");
+}
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function withClips(all, ids) {
   const wanted = new Set(ids);
@@ -463,7 +524,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] [--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 +534,57 @@ 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'
+      SET_HELP,
+      'Example: batchedits style create "Shorts" --crop 9:16 --silence --captions --zoom --set captions.position=center'
     ].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;
     }
   },
@@ -610,7 +699,7 @@ Next: batchedits status ${positionals.join(" ")} --watch`);
 };
 
 // src/cli.ts
-var VERSION = true ? "1.1.0" : "dev";
+var VERSION = true ? "1.2.0" : "dev";
 var FLAG_OPTIONS = {
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" },
@@ -627,7 +716,10 @@ var FLAG_OPTIONS = {
   repeats: { type: "boolean" },
   crop: { type: "string" },
   zoom: { type: "boolean" },
-  clips: { type: "string" }
+  clips: { type: "string" },
+  set: { type: "string", multiple: true },
+  remove: { type: "string", multiple: true },
+  name: { type: "string" }
 };
 function mainHelp() {
   const names = Object.keys(commands);
@@ -646,6 +738,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.2.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",