@remixmate/cli 0.13.7 → 0.13.8

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.13.7",
-  "generatedAt": "2026-10-30T09:41:49.930Z",
+  "version": "0.13.8",
+  "generatedAt": "2026-10-31T00:45:42.523Z",
   "skills": [
     {
       "id": "doc-parse",
@@ -614,7 +614,7 @@
               "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."
+            "description": "Narration on / off, overriding the template's needsNarration (auto = the template decides). Templates declaring narration optional 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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.13.7",
+  "version": "0.13.8",
   "description": "AI media generation skills for Claude Code / Codex — 12 skills covering image, video, voice, digital human, web screenshot, web recording, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",

package/skills/gen-script/SKILL.md

@@ -491,7 +491,7 @@ python3 <SkillDir>/scripts/gen_script.py \
 | `--payload KEY=VALUE` | Template-specific card choice, repeatable. `KEY` is a dotted path in `customPayloadSchema` (or `capabilities.frameLevelKeys`), e.g. `<field>=<value>`, `<object>.<field>=<value>`. Value is converted to the declared type (true/false, numbers) and checked against enum / range; undeclared keys are rejected. Written to every scene with sibling keys kept, applied before fit-caption duration estimation. | template default |
 | `--ending-payload KEY=VALUE` | Same as `--payload`, but written only to the ending scene, e.g. `<object>.<field>=<closing line>`. On countdown templates it also appends an ending scene after #1 (it carries the #1 index; fill its narration and the item field `capabilities.countdown.itemProp` names). Errors when the script has no ending scene. | none |
 | `--avatar-id` | Digital-human avatar id (`dh_xxx`) for templates declaring `capabilities.digitalHuman`. Adds asset `asset-avatar` (`type: avatar`, `source: gen-digital-human`, `payload.avatarId`) and sets `visuals.avatar.assetRef` on every scene whose slot reads it — one continuous presenter driven by the narration. Placement: template default, or `--payload digitalHuman.<field>=…` (a photo-only presenter is `--payload digitalHuman.posterUrl=<url>` without this flag). | none |
-| `--motion` | Camera motion for every scene (`animationHints.motion`): `static` / `kenburns-in` / `kenburns-out` / `pan-left` / `pan-right` / `float`. `auto` removes the motion from every scene so the template picks (image-slide rotates push / pan / pull / pan); nothing is locked then. | skeleton alternates in / out |
+| `--motion` | Camera motion for every scene (`animationHints.motion`): `static` / `kenburns-in` / `kenburns-out` / `pan-left` / `pan-right` / `float`. `auto` removes the motion from every scene so the template picks its own motion; nothing is locked then. | skeleton alternates in / out |
 | `--font-id` | Font library key (`font.uniq_id`), written to `global.font.fontId`; ab-render resolves and installs the real font at render time. Pass it whenever the user picked a font — the replicate card shows it as `名字（id）`, e.g. `字体: <名字>（<uniqId>）`; pass the id in the parentheses. Never pass a CSS family or the display name: an unknown key falls back to the template font with no error. | template font |
 | `--font-name` | Display name of the picked font → `global.font.fontName` (display only, never used for rendering). Pass it with `--font-id`. | — |
 | `--list-fonts` | Print the live font library (`/font/page`: id, name, lang, category, license) and exit; no script is generated and `--topic` is not needed. The ids it prints are the only valid `--font-id` values — use it when the user asks which fonts exist or names a font without its id. | — |
@@ -510,7 +510,7 @@ python3 <SkillDir>/scripts/gen_script.py \
 
 Values written by `--background-preset`, `--background-asset`, `--payload`, `--ending-payload`, `--avatar-id` and `--motion` are listed in `meta.lockedScenePaths` (scene-relative paths such as `customPayload.<object>.<field>`, `animationHints.motion`). When the agent later saves its own `dsl_json` in merge mode, ab-agent restores those paths from this skeleton after merging, so a model-written `customPayload` object cannot wipe a card choice. Do not hand-write these keys in `dsl_json`; pass the flag. Templates that author their own scenes (`meta.authoredScenes`) are not merged: there ab-agent writes each locked value that the skeleton holds on every scene (with one value) onto every submitted scene, and adds the skeleton assets those values reference (`asset-background`, `asset-avatar`) when the submitted `assets` lacks them.
 
-For image-to-video replicate cards, map **转场效果 / Transition effect** to both `--payload sequence.defaultEffect=<id>` and `--payload sequence.overrideItemEffects=true`. Use the id in parentheses (`fade`, `wipe-left`, `slide-left`, `none`), preserving the chosen preset and all typography. **跟随样片 / Follow example (`follow`)** omits both overrides; `follow` is not a valid effect. Map **转场时长 / Transition duration** to `--payload sequence.transitionMs=<milliseconds>` (e.g. `0.6 秒（600）` → `600`); omit when following the sample or using `none`. These payload keys are locked into every generated scene, so do not re-author them in a saved DSL.
+For replicate cards exposing transition effects or duration, read the template's `customPayloadSchema` and `llmHint` for the exact field paths, units, allowed values and any paired override switch. Pass each explicit selection through `--payload <declared-path>=<value>`, preserving the chosen preset and typography; following the sample omits the overrides. These payload keys are locked into every generated scene, so do not re-author them in a saved DSL.
 
 ## DSL generation principles
 

package/skills/gen-script/scripts/gen_script.py

@@ -643,6 +643,8 @@ def _template_needs_image(template_config: dict | None) -> bool:
 
 
 
+
+
 
 
 
@@ -707,6 +709,7 @@ def _resolve_contract(template_config: dict | None) -> dict:
         "duration_strategy": duration_strategy,
         "duration_model": caps.get("durationModel"),
         "payload_defaults": payload_defaults,
+        "media_binding": caps.get("mediaBinding"),
         "primary_visual_type": primary_visual_type,
         "background_strategy": "shared" if caps.get("backgroundStrategy") == "shared" else "per-scene",
         "default_layout": caps.get("defaultLayout"),
@@ -1275,6 +1278,8 @@ def _media_option_choice(option_schema: dict, value: str | None, flag: str,
 
 
 
+
+
 
 _MEDIA_OPTION_FLAGS = {"preset": "--sequence-preset", "fit": "--sequence-fit"}
 _LEGACY_MEDIA_BINDINGS = {
@@ -2493,7 +2498,7 @@ def _attach_narration(scene: dict, narration_text: str, narration_asset_id: str
 def _visual_scene(
         ctx: _SkeletonContext, idx: int, scene_id: str, plan: dict, visual_asset_id: str,
 ) -> dict:
-    return {
+    scene = {
         "id": scene_id,
         "purpose": plan["purpose"],
         "duration": plan["duration"],
@@ -2507,6 +2512,24 @@ def _visual_scene(
     }
 
 
+
+    binding = ctx.contract.get("media_binding")
+    if isinstance(binding, dict) and "assetRefKey" in binding:
+        path = binding.get("itemsPath")
+        ref_key = binding.get("assetRefKey")
+        if not isinstance(path, str) or not all(path.split(".")) or not isinstance(ref_key, str) or not ref_key:
+            raise ValueError("mediaBinding needs non-empty itemsPath and assetRefKey")
+        item = deepcopy(binding.get("item", {}))
+        if not isinstance(item, dict):
+            raise ValueError("mediaBinding.item must be an object")
+        item[ref_key] = visual_asset_id
+        payload = _build_custom_payload(ctx.template_config)
+        _write_payload(payload, [(path.split("."), [item])])
+        scene["customPayload"] = payload
+        del scene["visuals"]
+    return scene
+
+
 def _payload_scene(ctx: _SkeletonContext, scene_id: str, plan: dict) -> dict:
 
 
@@ -2979,7 +3002,7 @@ Examples:
         "--motion", default=None,
         help="Camera motion for every scene (animationHints.motion): static / kenburns-in / kenburns-out / "
              "pan-left / pan-right / float. Replaces the skeleton's alternating default. `auto` removes the "
-             "motion from every scene so the template picks (image-slide rotates push / pan / pull / pan).",
+             "motion from every scene so the template picks its own motion.",
     )
     parser.add_argument("--allow-digital-human", action="store_true", help="Allow digital-human assets")
     parser.add_argument("--avatar-id", default=None, help="Digital-human avatar id (dh_xxx) for templates declaring capabilities.digitalHuman: adds one gen-digital-human asset referenced by every scene's visuals.avatar.assetRef (one continuous presenter driven by the narration). Placement stays the template default unless set with --payload digitalHuman.<field>=...")

package/skills/gen-script/skill.json

@@ -67,7 +67,7 @@
       "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."
+        "description": "Narration on / off, overriding the template's needsNarration (auto = the template decides). Templates declaring narration optional 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",

package/skills/gen-script/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-script",
   "repoName": "agent-skill-media-maker",
   "skillId": "474",
-  "version": "V25",
+  "version": "V26",
   "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/template-registry/version.json

@@ -2,6 +2,6 @@
   "skillName": "template-registry",
   "repoName": "agent-skill-media-maker",
   "skillId": "475",
-  "version": "V31",
+  "version": "V32",
   "skillDescription": "Video-template registry skill. Stores every video-template definition and lists the available templates (templateId / name / aspect ratio / style tags).\n\nUse this skill as soon as the user mentions any of these intents:\n- View available templates / list every template\n\nNote: DSL→TemplateBinding is no longer a separate exposed step — once prepare_video_assets receives a template_id it builds the binding internally."
 }

package/skills/template-registry/video_dsl/runtime/dsl_validator.py

@@ -1273,6 +1273,44 @@ def _check_narration_language_strict(dsl: dict) -> list[ValidationError]:
 _TEXT_LAYER_SKELETON_PREFIXES = ("[骨架待填充]", "[skeleton placeholder]")
 
 
+def _check_presenter_visibility(dsl: dict) -> list[ValidationError]:
+
+
+
+
+    tpl = _get_template_cfg(_pick_template_id(dsl)) or {}
+    caps = tpl.get("capabilities")
+    caps = caps if isinstance(caps, dict) else {}
+    spec = caps.get("digitalHuman") or {}
+    if not isinstance(spec, dict) or spec.get("backgroundOccludes") is not True:
+        return []
+    presenter_scenes = []
+    for scene in dsl.get("scenes") or []:
+        if not isinstance(scene, dict):
+            continue
+        visuals = scene.get("visuals") or {}
+        if not isinstance(visuals, dict):
+            continue
+        if not isinstance(visuals.get("avatar"), dict):
+            continue
+        if (visuals.get("avatar") or {}).get("assetRef"):
+            presenter_scenes.append(scene)
+    if not presenter_scenes or not all(
+        isinstance(scene["visuals"].get("background"), dict)
+        and scene["visuals"]["background"].get("assetRef")
+        for scene in presenter_scenes
+    ):
+        return []
+    binding = caps.get("mediaBinding") or {}
+    path = binding.get("itemsPath") if isinstance(binding, dict) else None
+    hint = f" Use timed media items in customPayload.{path} instead." if path else " Leave presenter scenes without full-scene backgrounds."
+    return [ValidationError(
+        "scenes[].visuals.background.assetRef",
+        "Full-scene backgrounds cover every presenter scene; the presenter would never be visible."
+        + hint,
+    )]
+
+
 def _check_text_layer_rules(dsl: dict) -> list[ValidationError]:
 
 
@@ -1398,6 +1436,7 @@ def validate_integrity(dsl: dict) -> list[ValidationError]:
     errors += _check_step_narration_alignment(dsl)
     errors += _check_slide_cross_field(dsl)
     errors += _check_text_layer_rules(dsl)
+    errors += _check_presenter_visibility(dsl)
 
     errors += _check_duration_estimate(dsl)
     return errors
@@ -1435,6 +1474,7 @@ def validate_dsl(dsl: dict) -> list[ValidationError]:
     errors += _check_step_narration_alignment(dsl)
     errors += _check_slide_cross_field(dsl)
     errors += _check_text_layer_rules(dsl)
+    errors += _check_presenter_visibility(dsl)
 
     errors += _check_duration_estimate(dsl)
     return errors