@remixmate/cli 0.9.57 → 0.9.59

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.57",
-  "generatedAt": "2026-09-29T07:05:55.130Z",
+  "version": "0.9.59",
+  "generatedAt": "2026-09-29T12:43:37.496Z",
   "skills": [
     {
       "id": "doc-parse",
@@ -82,7 +82,7 @@
       "tier": "orchestration",
       "category": "consuming",
       "title": "Jianying (CapCut) Draft Export",
-      "summary": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. Supports automatic conversion from a RenderPlan.",
+      "summary": "Jianying (CapCut) draft export: package asset URLs into a draft ZIP that Jianying can import. By default exports the latest prepared render job of the current conversation (no scenes needed).",
       "triggers": [
         "Export to Jianying, Jianying draft, package for Jianying, import into Jianying",
         "Export materials to the Jianying format, generate a Jianying project",
@@ -102,13 +102,17 @@
       "parameters": {
         "type": "object",
         "properties": {
+          "from_job_id": {
+            "type": "number",
+            "description": "Render job id to export (the `jobId` printed by prepare_video_assets). Omit it together with scenes to export the latest prepared job of the current conversation — preferred, because asset URLs copied from chat history go stale after re-renders"
+          },
           "from_render_plan": {
             "type": "string",
-            "description": "Build the draft from a RenderPlan JSON (replaces --scenes)"
+            "description": "Build the draft from a local RenderPlan JSON file (local debugging only)"
           },
           "scenes": {
             "type": "string",
-            "description": "Scene array as JSON (inline string or file path)"
+            "description": "Hand-written scene array as JSON — only for assets that never went through prepare_video_assets. Fields per scene: imageUrl | videoUrl (one required), duration (seconds, required), audioUrl, audioDuration, subtitleText, textLayers, width, height. Any other field (text, image, audio…) is rejected"
           },
           "title": {
             "type": "string",
@@ -128,15 +132,15 @@
               "mac",
               "windows"
             ],
-            "description": "Draft-root preset"
+            "description": "OS of the computer that will open the draft"
           },
           "draft_root_path": {
             "type": "string",
-            "description": "Explicit Jianying draft root path (overrides --system)"
+            "description": "Absolute Jianying draft root on the user's computer (Jianying → Settings → Draft location), e.g. /Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft or C:/Users/<username>/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft. Required when the agent runs on a server; never guess the username, ask the user"
           },
           "no_download": {
             "type": "boolean",
-            "description": "Do not download the ZIP; print the URL only"
+            "description": "Do not keep a local copy of the ZIP; print the download URL only"
           },
           "output": {
             "type": "string",
@@ -147,18 +151,18 @@
       },
       "ui": {
         "primary": [
-          "title"
-        ],
-        "advanced": [
           "system",
-          "width",
-          "height",
-          "output"
+          "draft_root_path"
         ],
+        "advanced": [],
         "hidden": [
+          "title",
+          "width",
+          "height",
+          "output",
+          "from_job_id",
           "from_render_plan",
           "scenes",
-          "draft_root_path",
           "no_download"
         ]
       }
@@ -169,7 +173,7 @@
       "tier": "atomic",
       "category": "asset",
       "title": "Digital-Human Talking-Head",
-      "summary": "Digital-human video (HiFly): list or clone avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL. Aspect ratio follows the avatar's cloned source and cannot be chosen.",
+      "summary": "Digital-human video (HiFly): list or clone avatars; produce a talking-head video from text via TTS, or drive an avatar from an existing audio URL. Aspect ratio follows the avatar's cloned source and cannot be chosen. Talking-head videos cost credits per second of output (5 s minimum); fails with insufficient_credits when the balance is too low.",
       "triggers": [
         "Digital human, talking-head video, AI presenter, virtual host",
         "Make a talking-head video out of this script / this audio file",
@@ -215,7 +219,7 @@
           },
           "clone": {
             "type": "boolean",
-            "description": "Clone mode: create a custom HiFly avatar from a video (free) or a portrait image (costs HiFly credits). Requires clone_url and name. Waits until cloning finishes unless wait=false."
+            "description": "Clone mode: create a custom HiFly avatar from a video (free) or a portrait image (costs credits per clone, refunded automatically if cloning fails; see the pricing page). Requires clone_url and name. Waits until cloning finishes unless wait=false."
           },
           "clone_url": {
             "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.9.57",
+  "version": "0.9.59",
   "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/export-jianying/SKILL.md

@@ -44,24 +44,37 @@ There is no dedicated env file; the **process environment** variables of the cal
 
 1. **Script path**: read the system-injected `Base directory for this skill: <path>` as `<SkillDir>`. Every command below uses `<SkillDir>/scripts/gen_jianying_draft.py`; never hard-code paths.
 2. **Pick the input form**:
-   - **Form A (recommended)**: `--from-job-id` — load the RenderPlan from the database without passing a file path (safe for multi-user concurrent flows).
-   - **Form B (fallback, single-user / local debugging)**: `--from-render-plan` — read a local `render-plan.json`.
-3. **Draft root**: by default the `--system mac` preset resolves the target Jianying draft directory; switch with `--system windows`, or override with `--draft-root-path`. This path is sent to the API as `draftRootPath` and embedded in the draft files.
-4. **By default download the ZIP** locally (`--output` sets the path); pass `--no-download` if you only need the download URL (this flag is ignored when scenes contain `textLayers` / `subtitleText`).
+   - **Default (recommended)**: pass **no** `--scenes` / `--from-job-id`. When `CONVERSATION_ID` is set (always true inside the agent), the script exports the latest render job of this conversation that has prepared assets — i.e. whatever the user last re-rendered, including voices or images they changed in the editor.
+   - **`--from-job-id <jobId>`**: export a specific earlier job.
+   - **`--scenes`**: only for assets that never went through `prepare_video_assets`. **Never** rebuild scenes from URLs in the chat history: earlier tables go stale after every re-render, and you cannot see previous tool results.
+   - `--from-render-plan`: local debugging only.
+3. **Draft root**: pass the user's real Jianying draft directory via `--draft-root-path` (an absolute path on **the user's computer**). It is sent to the API as `draftRootPath` and embedded in the draft files, so a wrong path makes Jianying lose the media. If the user already gave a path (e.g. a `草稿目录` / `Draft folder` line in their message), use it verbatim. Otherwise ask for it — never guess the username. The path is only optional when this script runs on the user's own computer of the `--system` OS; anywhere else (e.g. a server-side agent) the script exits with an error asking for it.
+4. **Download URL**: pass `--no-download` in the agent (no local copy is kept). When subtitles / textLayers need styling the script still fetches the ZIP to a temp file, styles it, uploads it back and prints the URL of the **styled** ZIP. The printed `download URL:` is a signed link that expires after 7 days — give it to the user exactly as printed, including the whole `?Expires=…&Signature=…` query; never strip or re-encode it.
 5. **Async job**: draft generation is async (assets must be downloaded and packaged); the script polls until completion.
+6. **Report what is actually in the draft**: repeat the `📦 Draft contents` block (scene count, narration audio N/N, subtitles N/N, draft root). Don't claim subtitles or a particular voice version the block doesn't show.
 
-### Load the RenderPlan from the database (recommended, multi-user safe)
+### Export the latest prepared job of this conversation (default)
 
-When `prepare_video_assets` was invoked with `--save-job` (default) and persisted the RenderPlan, load it directly via `--from-job-id` — no file path required:
+```bash
+python3 <SkillDir>/scripts/gen_jianying_draft.py \
+  --system mac \
+  --draft-root-path "/Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft" \
+  --no-download
+```
+
+- Requires `PRIV_TOKEN` and `CONVERSATION_ID` (both injected by the agent). The title defaults to the plan's title.
+- Fails with a clear message if the conversation has no prepared job yet — run `prepare_video_assets` first.
+
+### Load a specific job from the database
 
 ```bash
 python3 <SkillDir>/scripts/gen_jianying_draft.py \
   --from-job-id <jobId> \
-  --title "My Video"
+  --system mac \
+  --draft-root-path "/Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft"
 ```
 
 - `<jobId>` is the task id printed by `prepare_video_assets` (the line `📦 render job jobId: N`).
-- Requires the `PRIV_TOKEN` and `MM_BACKEND_API_URL` env vars.
 
 ### Read from a RenderPlan file (fallback, single-user / local debugging)
 
@@ -145,23 +158,26 @@ python3 <SkillDir>/scripts/gen_jianying_draft.py \
 
 ### Specify the Jianying draft root
 
-Default is `--system mac`. Switch to the Windows preset:
+macOS:
 
 ```bash
 python3 <SkillDir>/scripts/gen_jianying_draft.py \
-  --title "Win draft" --system windows \
+  --title "Mac draft" --system mac \
+  --draft-root-path "/Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft" \
   --scenes '[{"videoUrl":"https://example.com/v.mp4","duration":5}]'
 ```
 
-Explicitly specify a path (overrides `--system`):
+Windows:
 
 ```bash
 python3 <SkillDir>/scripts/gen_jianying_draft.py \
-  --title "Custom path" \
-  --draft-root-path "/Users/yourname/Movies/JianyingPro/User Data/Projects/com.lveditor.draft" \
+  --title "Win draft" --system windows \
+  --draft-root-path "C:/Users/<username>/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft" \
   --scenes '[{"videoUrl":"https://example.com/v.mp4","duration":5}]'
 ```
 
+`<username>` is a placeholder for the user's real value — the script rejects paths that still contain `<...>`, start with `~`, contain `%VAR%` / `$VAR`, or are not absolute. Users who moved their draft folder can copy the exact path from Jianying → Settings → Draft location.
+
 ### Only print the download URL (no file write)
 
 ```bash
@@ -170,7 +186,7 @@ python3 <SkillDir>/scripts/gen_jianying_draft.py \
   --scenes '[{"videoUrl":"https://example.com/v.mp4","duration":5}]'
 ```
 
-6. **Show the result**: by default the script prints the download URL and saves the ZIP to `--output`. At the end it prints "extract into the draft root → restart Jianying" to import. With `--no-download`, only the download URL is printed.
+**Show the result**: the script prints `📦 Draft contents`, the signed `download URL:` and the import steps. Without `--no-download` it also keeps the ZIP at `--output`.
 
 See every option: `python3 <SkillDir>/scripts/gen_jianying_draft.py --help`.
 
@@ -178,31 +194,31 @@ See every option: `python3 <SkillDir>/scripts/gen_jianying_draft.py --help`.
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--from-render-plan` | Convert from a RenderPlan JSON automatically (replaces `--scenes`). | — |
-| `--from-job-id` | Load the RenderPlan from the database (pass a jobId, replaces `--from-render-plan`). | — |
-| `--scenes` | Scenes JSON (inline string or file path). | required (unless using `--from-render-plan` or `--from-job-id`) |
-| `--title` | Draft title. | required (optional when using `--from-render-plan`) |
+| `--from-job-id` | Load the RenderPlan of a specific job from the database. | latest prepared job of `CONVERSATION_ID` when no source is given |
+| `--from-render-plan` | Convert a local RenderPlan JSON (local debugging). | — |
+| `--scenes` | Hand-written scenes JSON (inline string or file path); unknown fields are rejected. | — |
+| `--title` | Draft title. | plan title (required with `--scenes`) |
 | `--width` | Canvas width in pixels. | `1080` |
 | `--height` | Canvas height in pixels. | `1920` |
 | `--draft-name` | Jianying draft name. | same as title |
-| `--system` | Draft-root preset: `mac` / `windows`. | `mac` |
-| `--draft-root-path` | Explicit Jianying draft root path (overrides `--system`). | resolved from `--system` |
-| `--no-download` | Skip the ZIP download; print only the URL (ignored when textLayers / subtitleText is present). | off |
+| `--system` | OS of the computer that will open the draft: `mac` / `windows`. | `mac` |
+| `--draft-root-path` | Absolute Jianying draft root on the user's computer. | required unless the script runs on that computer |
+| `--no-download` | Keep no local copy; print only the (post-processed, signed) URL. | off |
 | `-o` / `--output` | Download path. | `jianying_draft.zip` |
 | `--poll-interval` | Polling interval (seconds). | `5` |
 | `--max-wait` | Maximum wait time (seconds). | `300` |
 | `--private-token` | Override the token. | see table above |
 
-### Draft-root presets
+### Default draft roots
 
-| `--system` | Resolved path |
-|------------|---------------|
-| `mac` | `~/Movies/JianyingPro/User Data/Projects/com.lveditor.draft` (`~` expands on the runner machine). |
-| `windows` | `%LOCALAPPDATA%/JianyingPro/User Data/Projects/com.lveditor.draft` (literal, not expanded — the target Windows machine resolves it). |
+| `--system` | Jianying default (replace `<username>`) | Derived automatically only when |
+|------------|------------------------------------------|---------------------------------|
+| `mac` | `/Users/<username>/Movies/JianyingPro/User Data/Projects/com.lveditor.draft` | the script runs on macOS |
+| `windows` | `C:/Users/<username>/AppData/Local/JianyingPro/User Data/Projects/com.lveditor.draft` | the script runs on Windows with `LOCALAPPDATA` set |
 
 ## Scene JSON shape
 
-Fields supported per scene:
+Fields supported per scene (anything else — e.g. `text`, `image`, `audio` — makes the script exit with the correct field name; `id` is ignored):
 
 | Field | Type | Description |
 |-------|------|-------------|
@@ -240,11 +256,8 @@ When `textLayers` is present the script downloads the ZIP and post-processes `dr
 
 ## How to import into Jianying
 
-1. By default the draft ZIP is saved to `--output` (default `jianying_draft.zip`).
-2. Extract the ZIP into the "draft root" the script prints — i.e. the `draftRootPath` passed to the API:
-   - mac default: `~/Movies/JianyingPro/User Data/Projects/com.lveditor.draft/`
-   - windows default: `%LOCALAPPDATA%/JianyingPro/User Data/Projects/com.lveditor.draft/`
-   - custom: the path passed via `--draft-root-path`
+1. Download the ZIP from the printed `download URL:` (or use the local `--output` file).
+2. Extract the ZIP into exactly the draft root that was passed as `--draft-root-path` (the script prints it as `draft root:`). Tell the user that path verbatim — not a generic `~/...` one.
 3. Start (or restart) Jianying; the draft appears in the project list.
 
 > The backend embeds `draftRootPath` into `draft_content.json` / `draft_meta_info.json`. As long as the extraction directory matches the path that was passed in, Jianying resolves the material paths correctly without extra rewrites.
@@ -253,5 +266,8 @@ When `textLayers` is present the script downloads the ZIP and post-processes `dr
 
 - **401** / **token missing** (non-OpenClaw): check or set the token via the Feishu link above.
 - **Business `code != 0`**: read the `msg` printed on stderr.
+- **`unsupported field(s)`**: rename the field as the message says — or better, drop `--scenes` and export the latest job.
+- **`no render job with a saved RenderPlan`**: the conversation has no prepared assets yet; run `prepare_video_assets` first.
+- **`--draft-root-path is required` / `invalid --draft-root-path`**: ask the user for the real path; don't retry with a guessed one.
 - **Generation timeout**: increase `--max-wait` or retry later.
 - **Network**: check connectivity and `MM_API_BASE_URL`.