@scenerok/cli 2.11.0 → 2.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenerok/cli",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "SceneRok CLI - Create videos from your terminal and agent workflows",
   "type": "module",
   "bin": {

package/skills/scenerok/references/animations-catalog.md

@@ -13,9 +13,9 @@ import animations from "@scenerok/animations"
 | `blend_caption` | lower-third | yes | 5s | positional: `text` · named: `text, color` |
 | `blue_sweater_intro_video` | other | yes | 12s | positional: `creatorName` · named: `headline, creatorName, creatorHandle, creatorBio, avatarUrl` |
 | `code_3d_extrude` | code-anim | yes | 8s | positional: `code` · named: `code, lang, theme, filename` |
-| `code_diff` | code-anim | yes | 6s | positional: `from, to` · named: `from, to, lang, theme` |
+| `code_diff` | code-anim | yes | 6s | positional: `from, to` · named: `from, to, lang, theme, filename, label, keep_removed` |
 | `code_highlight` | code-anim | yes | 5s | positional: `code` · named: `code, lang, theme, filename` |
-| `code_morph` | code-anim | yes | 7s | positional: `from, to` · named: `from, to, lang, theme` |
+| `code_morph` | code-anim | yes | 7s | positional: `from, to` · named: `from, to, lang, theme, filename, label, keep_removed` |
 | `code_particle_assemble` | code-anim | yes | 8s | positional: `code` · named: `code, lang, theme, filename` |
 | `code_scroll` | code-anim | yes | 6s | positional: `code` · named: `code, lang, theme, filename` |
 | `code_shader_dissolve` | code-anim | yes | 7s | positional: `code` · named: `code, lang, theme, filename` |

package/skills/scenerok/references/catalog-index.json

@@ -1,6 +1,6 @@
 {
   "schema": "https://scenerok.com/catalog-index/v1",
-  "generatedAt": "2026-10-23T04:21:13.537Z",
+  "generatedAt": "2026-10-25T06:13:24.500Z",
   "cdnBase": "https://assets-public.scenerok.com/catalog",
   "categories": [
     {

package/skills/scenerok/references/plugins.md

@@ -23,7 +23,8 @@ match, and prefer a plugin whenever the user pasted structured source data.
 4. **Draft** — for anything a person will look at before it renders:
    `scenerok_draft_plugin` with the **pinned integer ref**
    (`scenerok://plugin/<slug>@<int>`), the inputs object, `maxTokens` and an
-   `idempotencyKey`. It runs the plugin, fills the template, charges the
+   `idempotencyKey` (one per attempt — the tool generates one when you omit it
+   and echoes it back, so reuse that value on a retry). It runs the plugin, fills the template, charges the
    provider calls plus the plugin fee, and returns `{ draftId, vidscript,
    preview, estimate }` with **no render**. Show the user the preview and the
    script; then `scenerok_render_draft` (`{ draftId }`, or `{ draftId,
@@ -75,7 +76,9 @@ estimate → draft (providers + plugin fee) → preview + edit → render (rende
 
 **MCP**
 
-1. `scenerok_draft_plugin` — `{ ref, inputs, maxTokens, idempotencyKey }`.
+1. `scenerok_draft_plugin` — `{ ref, inputs, maxTokens, idempotencyKey }`
+   (`idempotencyKey` is generated per call when omitted and returned, so a retry
+   can replay the same draft instead of paying again).
    Returns `vidscript`, `preview` (the compiled timeline the web player uses,
    plus a summary) and an `estimate` that splits **what was just charged**
    (`estimate.draft`) from **what a render will cost** (`estimate.render`).

package/skills/scenerok/references/vidscript-guide.md

@@ -489,6 +489,7 @@ Audio sources can be MP3 inputs, audio plugin results, or the embedded audio str
 | `pan` | number | -1 (left) to 1 (right) |
 | `duck_under` | name | Lower this track while the named track plays |
 | `loudness` | string | `"ebu-r128"` normalizes an imported file |
+| `enabled` | boolean | `false` skips the placement entirely — for a sound whose url is empty when the step that makes it was skipped |
 | `animate` | object | `{ type: "volume", from: { volume: 0 }, to: { volume: 1 } }` automates the level |
 
 Mixing recipes (J- and L-cuts, ducking, automation): `editing-actions.md` → Sound.