@remixmate/cli 0.12.9 → 0.13.1

package/skills/gen-script/skill.json

@@ -54,15 +54,20 @@
       },
       "background_preset": {
         "type": "string",
-        "description": "Scene background preset, one of the template's customPayloadSchema.background.preset values. Written to every scene's customPayload.background.preset. **Must** pass when the user picked a background: the replicate card shows `背景样式: 纯色（solid）` → pass `solid`. Without it the scene keeps the template default. Requires template_id; unsupported values are rejected. `image` / `video` need the user's file: pass it as background_asset (which also sets the preset)."
+        "description": "Scene background preset, one of the template's customPayloadSchema.background.preset values. Written to every scene's customPayload.background.preset. **Must** pass when the user picked a background: the replicate card shows `背景样式: <名称>（<id>）` → pass `<id>`. Without it the scene keeps the template default. Requires template_id; unsupported values are rejected. `image` / `video` need the user's file: pass it as background_asset (which also sets the preset)."
       },
       "sequence_preset": {
         "type": "string",
-        "description": "Image-sequence style preset, one of the template's customPayloadSchema.sequence.preset values (image-to-video: vlog / news / poster / cinematic / fast-cut). Written to customPayload.sequence.preset; the preset sets transitions, motion, text layout and pacing (fast-cut shortens every image to 1.5s, and the scene duration follows). **Must** pass when the user picked a style preset: the replicate card shows `风格预设: 快剪（fast-cut）` → pass `fast-cut`; `none` keeps the template defaults. Without it the choice is silently dropped. Only for templates declaring capabilities.payloadDefaults.sequence; unsupported values are rejected."
+        "description": "Style preset for templates declaring capabilities.mediaBinding.options.preset; one of that option's enum in the template's customPayloadSchema. Written next to the template's media list; the preset sets transitions, motion, text layout and pacing, and the scene duration follows. **Must** pass when the user picked a style preset: the replicate card shows `风格预设: <名称>（<id>）` → pass `<id>`; `none` keeps the template defaults. Without it the choice is silently dropped. Rejected on templates without that option; unsupported values are rejected."
       },
       "sequence_fit": {
         "type": "string",
-        "description": "How image-sequence media fill the frame, one of customPayloadSchema.sequence.fit (cover = fill the frame and crop, contain = show the whole picture over a blurred backdrop). Written to customPayload.sequence.fit and beats the preset's own fit. **Must** pass when the user picked it: `显示方式: 完整显示（contain）` → pass `contain`; `auto` keeps the template / preset default. Only for templates declaring capabilities.payloadDefaults.sequence."
+        "description": "Media fill mode for templates declaring capabilities.mediaBinding.options.fit; one of that option's enum in the template's customPayloadSchema (its descriptions explain each value). Beats the preset's own fit. **Must** pass when the user picked it: `显示方式: <名称>（<id>）` → pass `<id>`; `auto` keeps the template / preset default."
+      },
+      "narration": {
+        "type": "string",
+        "enum": ["auto", "on", "off"],
+        "description": "Narration on / off, overriding the template's needsNarration (auto = the template decides). Templates where narration is optional (image sequences, galton-board) default to none — **must** pass `on` when the replicate card says `旁白: <名称>（narrated）`, otherwise the narration you write is dropped without an error and the video comes back silent. `off` drops narration from a narrated template."
       },
       "background_asset": {
         "type": "string",
@@ -73,7 +78,7 @@
         "items": {
           "type": "string"
         },
-        "description": "Template-specific card choices as `KEY=VALUE`, written to every scene's customPayload and locked so the dsl_json you save cannot overwrite them. KEY is a dotted path into the template's customPayloadSchema (e.g. `grade=四年级`, `watermarkText=WorkBuddy 实战课`, `preset=course`, `carousel.fit=cover`, `templateData.revealMode=progressive`, `cardStyle.championFx=false`); VALUE is the id inside the card line's parentheses, or the text verbatim for free-text fields. Booleans take true/false, numbers are range-checked, enums are checked — an undeclared key or value is rejected with the allowed list. **Must** pass every card line that the system prompt maps to a payload key; without it the choice is silently dropped. Requires template_id."
+        "description": "Template-specific card choices as `KEY=VALUE`, written to every scene's customPayload and locked so the dsl_json you save cannot overwrite them. KEY is a dotted path into the template's customPayloadSchema (e.g. `<field>=<value>`, `<object>.<field>=<value>`); VALUE is the id inside the card line's parentheses, or the text verbatim for free-text fields. Booleans take true/false, numbers are range-checked, enums are checked — an undeclared key or value is rejected with the allowed list. **Must** pass every card line that the system prompt maps to a payload key; without it the choice is silently dropped. Requires template_id."
       },
       "motion": {
         "type": "string",
@@ -92,11 +97,11 @@
         "items": {
           "type": "string"
         },
-        "description": "Like payload, but `KEY=VALUE` is written only to the ending scene and locked there (e.g. `recap.cta=关注我，每周更新开源热榜` for github-repo-rank's 片尾引导). On countdown templates (Top-N lists) it also appends the ending scene after #1 — fill that scene's narration (a closing line) and its customPayload.item with the #1 entry. Without it a countdown ends on the #1 card. Requires template_id."
+        "description": "Like payload, but `KEY=VALUE` is written only to the ending scene and locked there (e.g. the replicate card's 片尾引导 line → `<object>.<field>=<closing line>`, key as the card shows it). On countdown templates (Top-N lists) it also appends the ending scene after #1 — fill that scene's narration (a closing line) and its item field with the #1 entry. Without it a countdown ends on the #1 card. Requires template_id."
       },
       "avatar_id": {
         "type": "string",
-        "description": "Digital-human avatar id (`dh_xxx`, the replicate card's 数字人主讲 / 数字人讲师 line) for templates declaring capabilities.digitalHuman (image-slide, ppt-to-video, html-slide, …). Adds one gen-digital-human asset referenced by every scene's visuals.avatar.assetRef: one continuous presenter whose lips follow the narration. Placement stays the template default; adjust with payload `digitalHuman.<field>=…`. Copy the id verbatim, never invent one. Costs digital-human credits, so pass it only when the user picked an avatar. Requires template_id."
+        "description": "Digital-human avatar id (`dh_xxx`, the replicate card's 数字人主讲 / 数字人讲师 line) for templates declaring capabilities.digitalHuman. Adds one gen-digital-human asset referenced by every scene's visuals.avatar.assetRef: one continuous presenter whose lips follow the narration. Placement stays the template default; adjust with payload `digitalHuman.<field>=…`. Copy the id verbatim, never invent one. Costs digital-human credits, so pass it only when the user picked an avatar. Requires template_id."
       },
       "font_id": {
         "type": "string",
@@ -143,7 +148,7 @@
         "items": {
           "type": "string"
         },
-        "description": "Media URLs for the template's image/video carousel. When provided together with a template_id whose capabilities.payloadStyle=carousel-caption, these URLs are placed into customPayload.sequence.items when payloadDefaults.sequence is declared, otherwise customPayload.carousel.items, as existing assets — NO AI image generation is triggered. **Must** pass when the user explicitly provides image/video URLs for such a template. Each element is a full URL string. Image sequences (payloadDefaults.sequence) accept video URLs too (.mp4/.mov/.webm): gen_script probes each clip's real length, marks it type=video and plays it whole and muted; an unreadable video is rejected."
+        "description": "Media URLs for the template's image/video list. When provided together with a template_id whose capabilities.payloadStyle=carousel-caption, these URLs are written as existing assets into the media list the template declares in capabilities.mediaBinding.itemsPath — NO AI image generation is triggered. **Must** pass when the user explicitly provides image/video URLs for such a template. Each element is a full URL string. Video URLs (.mp4/.mov/.webm) are accepted too; when the template declares mediaBinding.videoDurationKey gen_script probes each clip's real length and writes it, and an unreadable video is rejected."
       },
       "scene_images": {
         "type": "array",
@@ -157,7 +162,7 @@
         "items": {
           "type": "string"
         },
-        "description": "On-screen caption lines for templates that declare a caption area (capabilities.payloadDefaults.caption). For image sequences (payloadDefaults.sequence), lines map in order to sequence.items[].caption, with at most one line per image. A replicate asset line's `(… desc: <text>)` suffix is the user's caption for that image: pass it here in the same order (use an empty string for images without one). Otherwise each element is one line. Line-count limits and whether **emphasis** is parsed are declared by the template — read its llmHint, which gen_script prints in full on stderr. **Must** pass when the user explicitly provides bullet-point text / bottom copy. **Also must pass — written by you — when the user did NOT provide any copy but the template is typewriter-driven** (capabilities.durationStrategy=fit-caption): such templates have no narration, so these lines are both the video's content and the thing that decides its duration. Draft them from the material you researched (repo README, page screenshots, the topic). Leaving this empty for a fit-caption template is rejected: nothing auto-generates caption text, and an empty caption renders a titled carousel with no words at all."
+        "description": "On-screen caption lines for carousel-caption templates; capabilities.mediaBinding.captions says where they go — one text block, or one caption per media item in order (at most one line per item). A replicate asset line's `(… desc: <text>)` suffix is the user's caption for that image: pass it here in the same order (use an empty string for images without one). Otherwise each element is one line. Line-count limits and whether **emphasis** is parsed are declared by the template — read its llmHint, which gen_script prints in full on stderr. **Must** pass when the user explicitly provides bullet-point text / bottom copy. **Also must pass — written by you — when the user did NOT provide any copy but the template is typewriter-driven** (capabilities.durationStrategy=fit-caption): such templates have no narration, so these lines are both the video's content and the thing that decides its duration. Draft them from the material you researched (repo README, page screenshots, the topic). Leaving this empty for a fit-caption template is rejected: nothing auto-generates caption text, and an empty caption renders a titled carousel with no words at all."
       },
       "stub_image_url": {
         "type": "string",
@@ -199,6 +204,7 @@
       "background_preset",
       "sequence_preset",
       "sequence_fit",
+      "narration",
       "background_asset",
       "payload",
       "ending_payload",

package/skills/gen-script/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-script",
   "repoName": "agent-skill-media-maker",
   "skillId": "474",
-  "version": "V22",
+  "version": "V23",
   "skillDescription": "Video-script generation skill. Turns a user-supplied topic into a structured Video DSL (JSON) that describes the full video — scene structure, asset requirements, and narrative flow.\n\nUse this skill as soon as the user mentions any of these intents:\n- Write a video script, generate a video script, plan a video, write storyboards\n- Create a short video, plan video content, generate a Video DSL\n- Turn a topic into a video structure / video content plan\n\nEven when the user does not say \"generate the DSL\", use this skill whenever they want to turn a topic into a structured video plan.\n\n⚠️ Stop-and-confirm gate: after this skill returns a DSL, show the full script and wait for the user's explicit confirmation. Never call `prepare_video_assets` in the same turn."
 }

package/skills/render-video/scripts/_video_probe.py

@@ -9,7 +9,6 @@
 
 
 
-
 from __future__ import annotations
 
 import builtins

package/skills/render-video/scripts/remote_renderer_client.py

@@ -248,6 +248,15 @@ def poll_render(
                 timeout=request_timeout,
             )
         except (urllib.error.URLError, OSError, ConnectionError) as exc:
+
+
+            if isinstance(exc, urllib.error.HTTPError) and exc.code < 500:
+                body = ""
+                try:
+                    body = exc.read().decode("utf-8")
+                except Exception:
+                    pass
+                raise RemoteRenderError(f"HTTP {exc.code} {status_path}: {body[:200]}") from exc
             consecutive_errors += 1
             print(
                 f"   ⚠️  polling network error ({consecutive_errors}/{max_consecutive_errors}): {exc}",
@@ -260,13 +269,6 @@ def poll_render(
                 ) from exc
             time.sleep(interval)
             continue
-        except urllib.error.HTTPError as exc:
-            body = ""
-            try:
-                body = exc.read().decode("utf-8")
-            except Exception:
-                pass
-            raise RemoteRenderError(f"HTTP {exc.code} {status_path}: {body[:200]}") from exc
 
         consecutive_errors = 0