@facelessad/cli 2.0.0 → 2.1.1

package/README.md

@@ -9,10 +9,17 @@ facelessad tools                # what can be made
 facelessad create --tool motion-graphics --url https://your-product.com --wait
 ```
 
-Ten commands: `login`, `create`, `status`, `list`, `download`, `estimate`,
-`tools`, `voices`, `brands`, `balance`. Every command accepts `--json` for scripting;
-`create`/`estimate` accept `--dry-run` (print the request body without
-sending) and `--file body.json` (a base body that flags override).
+Commands: `login`, `create`, `status`, `list`, `download`, `estimate`,
+`tools`, `voices`, `brands`, `balance`, `parts`, `regen-part`, `regen`,
+`render`, `cancel`, and `webhooks` / `webhook-add` / `webhook-rm`. Every
+command accepts `--json` for scripting; `create`/`estimate` accept `--dry-run`
+(print the request body without sending) and `--file body.json` (a base body
+that flags override).
+
+A finished video can be fixed part by part: `parts <id>` shows what it is made
+of and `regen-part` redoes one clip, image card, graphics block — or, on
+background-image styles (marked `+bg` in `tools`), one `bg-N` AI photo
+backdrop with `--prompt`. The whole video re-renders automatically.
 
 The key is stored in `~/.facelessad/config.json` with mode 0600. The
 environment variable `FACELESSAD_API_KEY` always wins — that is the way CI
@@ -34,7 +41,7 @@ Three ways to get the file:
 
 ```bash
 facelessad download 103 --out ad.mp4        # saves into the CURRENT directory
-facelessad status 103 --json | jq -r .url   # the raw link, valid ~1 hour
+facelessad status 103 --json | jq -r .url   # the raw link, valid ~24 hours
 ```
 
 The third is the browser: every video made through the CLI also appears in My

package/SKILL.md

@@ -162,8 +162,8 @@ no voice, no script, no music and no SFX.
 
 `--voiceover-text "<script>"` (or `--voiceover-file <path>`) makes the
 narration **word-for-word** — the AI script writer is skipped and not
-charged. The word limit follows the duration: 15 s fits ~40 words, 30 s ~60,
-50 s ~95. Over the limit is a clear error, never a silent trim, so count
+charged. The word limit follows the duration: 15 s fits ~45 words, 30 s ~80,
+50 s ~130. Over the limit is a clear error, never a silent trim, so count
 before sending. Not on music-video (its script is sung) or video-banner.
 
 `--visual-direction` steers the storyboard and `--hook-text` the first frame.
@@ -207,6 +207,11 @@ Which flag a part takes is in its `regenerate_requires`:
   text-animation, video-banner, and the graphics layer of product-showcase):
   a plain-language change such as `"make the headline say Faster onboarding"`.
   The server applies it to the block's current code — you never send code.
+- `--prompt` on a `bg-N` part — background images (styles marked `genBg` in
+  the registry / `+bg` in `facelessad tools`): describe the new AI photo
+  backdrop, e.g. `"warm sunset gradient with soft haze"`. The graphics stay
+  untouched, text/logos/UI are always excluded automatically, and the video
+  re-renders. 6 credits per image.
 
 Product Showcase lists two parts per scene: the product clip (`--prompt`) and
 the graphics over it (`--instruction`). Continuous videos chain their clips
@@ -317,6 +322,7 @@ names the offending field and usually the valid values.
 - `card_needs_image_prompt` — a card needs `--image-prompt`, not `--prompt`.
 - `webhook_limit` / `webhook_not_found` / `invalid_url` — five endpoints per account; no such id; or a URL we cannot reach.
 - `graphics_needs_instruction` / `instruction_not_supported` — graphics blocks take `--instruction`, and only they do.
+- `bg_needs_prompt` — a `bg-N` background image is regenerated with `--prompt` describing the backdrop.
 
 ## Rules for agents
 

package/index.js

@@ -550,7 +550,10 @@ const commands = {
       const t = (d.tools || []).find((x) => x.id === flags.tool);
       if (!t) die('Unknown tool "' + flags.tool + '". Valid: ' + (d.tools || []).map((x) => x.id).join(', '), 'unknown_tool');
       const lines = [bold(t.id) + ' — ' + (t.name || '')];
-      if (t.styles?.length) lines.push('  styles: ' + t.styles.map((s) => s.id).join(', '));
+      // 2.1.0 (§848 genBg): tyylit joilla on AI-generoitu kuvatausta merkitään
+      // +bg-liitteellä — rekisterin genBg-lippu, +6 cr / partti arvioon.
+      if (t.styles?.length) lines.push('  styles: ' + t.styles.map((s) => s.id + (s.genBg ? '+bg' : '')).join(', '));
+      if (t.styles?.some((s) => s.genBg)) lines.push('  ' + dim('+bg = AI photo background, +6 credits per part (regenerable later: facelessad regen-part <id> --part bg-N --prompt "...")'));
       // 1.2.0: rekisteri kertoo rakenteet KOLMESSA muodossa (§698). Ennen tämä
       // tulosti vain adStructures-listan, joka on oletusryhmän pooli — eli
       // animated-adilla 17 rakennetta 46:sta ja motion-graphicsilla 6 sadasta
@@ -753,7 +756,7 @@ const commands = {
 
   async 'regen-part'() {
     const id = positional[0];
-    if (!id) die('Usage: facelessad regen-part <id> --part <uid> [--prompt|--image-prompt|--instruction "..."]', 'missing_id');
+    if (!id) die('Usage: facelessad regen-part <id> --part <uid> [--prompt|--image-prompt|--instruction "..."]\n  scene clip: --prompt (new take) / --image-prompt (new image first)\n  image card: --image-prompt\n  graphics block (gfx-N): --instruction (plain-language edit)\n  background image (bg-N): --prompt (describe the new backdrop — text/logos/UI always excluded)', 'missing_id');
     const uid = flags.part;
     if (!uid || uid === true) die('--part <uid> is required — run: facelessad parts ' + id, 'missing_part');
     const body = {};
@@ -858,7 +861,7 @@ Create flags:
   --video-mode continuous|cuts     (animated-ad and music-video only)
   --voiceover-text "<script>"      (your own narration, spoken word-for-word —
        the AI script writer is skipped and not charged. Word limit follows
-       duration: 15s fits 40 words, 30s fits 60, 50s fits 95. Over the limit
+       duration: 15s fits 45 words, 30s fits 80, 50s fits 130. Over the limit
        is an error, never a silent trim. Not on music-video or video-banner.)
   --voiceover-file <path>          (same, read from a local text file)
   --visual-direction "<...>"       (how the video should LOOK and what happens
@@ -899,6 +902,10 @@ Regenerate flags (regen-part) — the ONLY flags this command takes:
        Animation, banner, and the graphics layer of product-showcase:
        plain-language edit, e.g. "make the headline say Faster onboarding".
        You never send or receive code.)
+  --prompt "<backdrop>"            (bg-N background images — styles marked +bg
+       in facelessad tools: describe the new AI photo backdrop, e.g. "warm
+       sunset gradient with soft haze". Graphics stay untouched; text, logos
+       and UI are always excluded automatically. 6 credits per image.)
 
 Video Banner flags (silent looping banner — no voice, no script):
   --headline "..." --subline "..." --cta-text "..."
@@ -943,7 +950,7 @@ function statusLine(d) {
   let s = 'Video ' + d.id + ': ' + bold(d.status);
   if (d.phase && !done) s += ' ' + dim('(' + d.phase + ')');
   if (d.url) s += '\n' + dim('Download: ') + 'facelessad download ' + d.id + ' --out ad.mp4'
-    + '\n' + dim('(the direct link is in --json output; it expires in ~1 h)');
+    + '\n' + dim('(the direct link is in --json output; it expires in ~24 h)');
   if (d.error) s += '\n' + d.error;
   return s;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facelessad/cli",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Create faceless video ads from your terminal or build scripts \u2014 the FacelessAd command line.",
   "license": "MIT",
   "type": "module",
@@ -23,4 +23,4 @@
     "cli"
   ],
   "homepage": "https://facelessad.com/developers"
-}
+}