@remixmate/cli 0.13.8 → 0.13.10

package/dist/handlers/gen-digital-human.js

@@ -1,39 +1,39 @@
-var k=Object.defineProperty;var f=(t,e)=>k(t,"name",{value:e,configurable:!0});import{mmPost as p,pollUntil as y,resolveHttpContext as U,SkillError as i}from"../http.js";import{getCapabilities as b}from"../capabilities.js";import{emitProgress as m}from"../progress.js";import{isTrue as w,toNumber as M}from"./shared.js";const E=["video","image"],S="hifly";function l(t){return t==null?"":String(t).trim()}f(l,"toId");async function N(t,e){const r=w(e.mine),a=!r&&w(e.all),n=!r&&!a,s={current:1,pageSize:100};n?s.featured=!0:s.source=S,r&&(s.mine=!0),e.gender&&(s.gender=String(e.gender)),e.name&&(s.name=String(e.name));const g=await p(t,"/digital-human/avatar/page",s,{timeoutMs:3e4}),o=g.list??[];if(w(e.json_output)){process.stdout.write(JSON.stringify({avatars:o})+`
-`);return}if(o.length===0){process.stdout.write(n?`⚠️  No curated public avatars match. Try --all for the full inventory, or --mine for your own.
+var b=Object.defineProperty;var u=(t,e)=>b(t,"name",{value:e,configurable:!0});import{mmPost as p,pollUntil as S,resolveHttpContext as M,SkillError as i}from"../http.js";import{getCapabilities as N}from"../capabilities.js";import{emitProgress as v}from"../progress.js";import{isTrue as g,toNumber as I}from"./shared.js";const E=["video","image"],k=["hifly","heygen"],y="hifly";function c(t){return t==null?"":String(t).trim()}u(c,"toId");async function O(t,e){const r=g(e.mine),a=!r&&g(e.all),n=!r&&!a,o={current:1,pageSize:100};n?o.featured=!0:a&&(o.source=c(e.source)||y),r&&(o.mine=!0),e.gender&&(o.gender=String(e.gender)),e.name&&(o.name=String(e.name));const f=await p(t,"/digital-human/avatar/page",o,{timeoutMs:3e4}),l=f.list??[];if(g(e.json_output)){process.stdout.write(JSON.stringify({avatars:l})+`
+`);return}if(l.length===0){process.stdout.write(n?`⚠️  No curated public avatars match. Try --all for the full inventory, or --mine for your own.
 `:`⚠️  No avatars available
 `);return}if(n){process.stdout.write(`
 ${"ID".padEnd(24)} ${"Name".padEnd(16)} ${"Gender".padEnd(8)} ${"Ratio".padEnd(6)} ${"Scenes".padEnd(22)} Voice
 `),process.stdout.write(`${"-".repeat(24)} ${"-".repeat(16)} ${"-".repeat(8)} ${"-".repeat(6)} ${"-".repeat(22)} ${"-".repeat(12)}
-`);for(const d of o)process.stdout.write(`${l(d.id).padEnd(24)} ${String(d.name??"").padEnd(16)} ${String(d.gender??"").padEnd(8)} ${String(d.aspectRatio??"").padEnd(6)} ${(d.tags??[]).join(",").padEnd(22)} ${d.defaultVoiceId||"-"}
+`);for(const d of l)process.stdout.write(`${c(d.id).padEnd(24)} ${String(d.name??"").padEnd(16)} ${String(d.gender??"").padEnd(8)} ${String(d.aspectRatio??"").padEnd(6)} ${(d.tags??[]).join(",").padEnd(22)} ${d.defaultVoiceId||"-"}
 `)}else{process.stdout.write(`
 ${"ID".padEnd(24)} ${"Name".padEnd(16)} ${"Source".padEnd(14)} ${"Gender".padEnd(8)} ${"Ratio".padEnd(6)} Clone
 `),process.stdout.write(`${"-".repeat(24)} ${"-".repeat(16)} ${"-".repeat(14)} ${"-".repeat(8)} ${"-".repeat(6)} ${"-".repeat(8)}
-`);for(const d of o)process.stdout.write(`${l(d.id).padEnd(24)} ${String(d.name??"").padEnd(16)} ${String(d.source??"").padEnd(14)} ${String(d.gender??"").padEnd(8)} ${String(d.aspectRatio??"").padEnd(6)} ${d.cloneStatus||"-"}
-`)}const u=g.pager?.total??o.length;process.stdout.write(`
-${o.length} avatar(s) shown${u>o.length?` of ${u}; narrow with --name`:""}
+`);for(const d of l)process.stdout.write(`${c(d.id).padEnd(24)} ${String(d.name??"").padEnd(16)} ${String(d.source??"").padEnd(14)} ${String(d.gender??"").padEnd(8)} ${String(d.aspectRatio??"").padEnd(6)} ${d.cloneStatus||"-"}
+`)}const s=f.pager?.total??l.length;process.stdout.write(`
+${l.length} avatar(s) shown${s>l.length?` of ${s}; narrow with --name`:""}
 `),process.stdout.write(n?`💡 Use --avatar-id <ID> to pick an avatar; pass its Voice as --voice-id for a matching voice
 `:`💡 Use --avatar-id <ID> to pick an avatar for generation
-`)}f(N,"listAvatars");async function I(t,e){return((await p(t,"/digital-human/avatar/page",{current:1,pageSize:100,mine:!0,source:S},{timeoutMs:3e4})).list??[]).find(n=>l(n.id)===e)??{id:e,source:S}}f(I,"fetchAvatarInfo");function O(t,e){const r=(t.source??"").trim()||S;if(!e.includes(r))throw new i(`❌ avatar uses provider "${r}", which is not available (supported: ${e.join("/")}). Pick another avatar from --list-avatars.`);return r}f(O,"resolveSource");async function T(t,e){const r=l(e.clone_url);if(!/^https?:\/\//i.test(r))throw new i("❌ --clone needs --clone-url <public http(s) URL of a video or portrait image> (local files are not uploaded)");const a=l(e.name);if(!a)throw new i("❌ --clone needs --name <avatar name>");const n=l(e.clone_type)||"video";if(!E.includes(n))throw new i(`❌ --clone-type must be one of ${E.join(" / ")}, received: ${n}`);const s={name:a,sourceType:n,fileUrl:r};e.thumbnail_url&&(s.thumbnailUrl=l(e.thumbnail_url)),e.gender&&(s.gender=l(e.gender)),m({phase:"gen-digital-human:clone-request",sourceType:n});const g=await p(t,"/digital-human/avatar/clone",s,{timeoutMs:6e4}),o=l(g.id);if(!o)throw new i(`❌ could not parse the new avatar id; API returned: ${JSON.stringify(g)}`);m({phase:"gen-digital-human:clone-async",avatarId:o});const u=w(e.json_output);if(e.wait!==void 0&&!w(e.wait)){if(u){process.stdout.write(JSON.stringify({avatarId:o,cloneStatus:g.cloneStatus??"cloning"})+`
+`)}u(O,"listAvatars");async function R(t,e){for(const r of[{mine:!0},{featured:!0}]){const n=((await p(t,"/digital-human/avatar/page",{current:1,pageSize:100,...r},{timeoutMs:3e4})).list??[]).find(o=>c(o.id)===e);if(n)return n}return{id:e,source:y}}u(R,"fetchAvatarInfo");function L(t,e){const r=(t.source??"").trim()||y;if(!e.includes(r))throw new i(`❌ avatar uses provider "${r}", which is not available (supported: ${e.join("/")}). Pick another avatar from --list-avatars.`);return r}u(L,"resolveSource");async function T(t,e){const r=c(e.clone_url);if(!/^https?:\/\//i.test(r))throw new i("❌ --clone needs --clone-url <public http(s) URL of a video or portrait image> (local files are not uploaded)");const a=c(e.name);if(!a)throw new i("❌ --clone needs --name <avatar name>");const n=c(e.clone_type)||"video";if(!E.includes(n))throw new i(`❌ --clone-type must be one of ${E.join(" / ")}, received: ${n}`);const o=c(e.clone_provider)||y;if(!k.includes(o))throw new i(`❌ --clone-provider must be one of ${k.join(" / ")}, received: ${o}`);if(o==="heygen"&&n!=="image")throw new i("❌ HeyGen avatars are created from a photo only; add --clone-type image");const f={name:a,sourceType:n,fileUrl:r};o!==y&&(f.provider=o),e.thumbnail_url&&(f.thumbnailUrl=c(e.thumbnail_url)),e.gender&&(f.gender=c(e.gender)),v({phase:"gen-digital-human:clone-request",sourceType:n,provider:o});const l=await p(t,"/digital-human/avatar/clone",f,{timeoutMs:6e4}),s=c(l.id);if(!s)throw new i(`❌ could not parse the new avatar id; API returned: ${JSON.stringify(l)}`);v({phase:"gen-digital-human:clone-async",avatarId:s});const d=g(e.json_output);if(e.wait!==void 0&&!g(e.wait)){if(d){process.stdout.write(JSON.stringify({avatarId:s,cloneStatus:l.cloneStatus??"cloning"})+`
 `);return}process.stdout.write(`
-🧬 Clone submitted, avatar id: ${o}
-`),process.stdout.write(`💡 Check progress with --clone-status --avatar-id ${o}
-`);return}let d;try{d=await y(async()=>{const c=await p(t,"/digital-human/avatar/clone-status",{id:o},{timeoutMs:3e4}),h=c.cloneStatus??"unknown";if(m({phase:"gen-digital-human:clone-poll",avatarId:o,status:h}),h==="done")return c;if(h==="failed")throw new i(`❌ avatar clone failed: ${c.cloneError||"unknown error"}`);return null},{intervalMs:1e4,timeoutMs:20*6e4})}catch(c){throw c instanceof i&&/polling timed out/.test(c.message)?new i(`❌ avatar ${o} is still cloning; rerun --clone-status --avatar-id ${o} later`):c}if(u){process.stdout.write(JSON.stringify({avatarId:o,cloneStatus:d.cloneStatus})+`
+🧬 Clone submitted, avatar id: ${s}
+`),process.stdout.write(`💡 Check progress with --clone-status --avatar-id ${s}
+`);return}let m;try{m=await S(async()=>{const w=await p(t,"/digital-human/avatar/clone-status",{id:s},{timeoutMs:3e4}),$=w.cloneStatus??"unknown";if(v({phase:"gen-digital-human:clone-poll",avatarId:s,status:$}),$==="done")return w;if($==="failed")throw new i(`❌ avatar clone failed: ${w.cloneError||"unknown error"}`);return null},{intervalMs:1e4,timeoutMs:20*6e4})}catch(w){throw w instanceof i&&/polling timed out/.test(w.message)?new i(`❌ avatar ${s} is still cloning; rerun --clone-status --avatar-id ${s} later`):w}if(d){process.stdout.write(JSON.stringify({avatarId:s,cloneStatus:m.cloneStatus})+`
 `);return}process.stdout.write(`
-✅ Avatar cloned, id: ${o}
-`),process.stdout.write(`💡 Generate with --avatar-id ${o} --text "..."
-`)}f(T,"cloneAvatar");async function R(t,e,r){const a=await p(t,"/digital-human/avatar/clone-status",{id:e},{timeoutMs:3e4}),n=a.cloneStatus||"unknown";if(r){process.stdout.write(JSON.stringify({avatarId:e,cloneStatus:n,error:a.cloneError||null})+`
+✅ Avatar cloned, id: ${s}
+`),process.stdout.write(`💡 Generate with --avatar-id ${s} --text "..."
+`)}u(T,"cloneAvatar");async function j(t,e,r){const a=await p(t,"/digital-human/avatar/clone-status",{id:e},{timeoutMs:3e4}),n=a.cloneStatus||"unknown";if(r){process.stdout.write(JSON.stringify({avatarId:e,cloneStatus:n,error:a.cloneError||null})+`
 `);return}process.stdout.write(`
 clone status: ${n}
 `),n==="failed"&&process.stdout.write(`   failure reason: ${a.cloneError||"unknown error"}
-`)}f(R,"checkCloneStatus");async function C(t,e,r){const a=await p(t,"/digital-human/video/status",{generationId:e},{timeoutMs:3e4}),n=a.status??"unknown";if(r){process.stdout.write(JSON.stringify({status:n,url:a.videoUrl??null,generationId:e})+`
+`)}u(j,"checkCloneStatus");async function C(t,e,r){const a=await p(t,"/digital-human/video/status",{generationId:e},{timeoutMs:3e4}),n=a.status??"unknown";if(r){process.stdout.write(JSON.stringify({status:n,url:a.videoUrl??null,generationId:e})+`
 `);return}if(process.stdout.write(`
 task status: ${n}
 `),a.videoUrl&&process.stdout.write(`   video URL: ${a.videoUrl}
-`),n==="failed"){const s=a.errorMessage??a.error??a.message??"unknown error";process.stdout.write(`   failure reason: ${s}
-`)}}f(C,"checkStatus");const j=30*6e4;async function J(t,e){return await y(async()=>{const a=await p(t,"/digital-human/video/status",{generationId:e},{timeoutMs:3e4}),n=a.status??"unknown";if(m({phase:"gen-digital-human:poll",generationId:e,status:n}),n==="completed")return a.videoUrl??"";if(n==="failed"){const s=a.errorMessage??a.error??a.message??"unknown error";throw new i(`❌ video generation failed: ${s}`)}return null},{intervalMs:5e3,timeoutMs:j}).catch(a=>{throw a instanceof i&&/polling timed out/.test(a.message)?new i(`${a.message}; still generating on the server — resume with --check-status --generation-id ${e}`):a})}f(J,"pollVideoStatus");async function x(t,e){const r=await U(e.skillName,{apiBaseUrl:t.api_base_url,privateToken:t.priv_token,preflightToken:e.auth?.token}),a=w(t.json_output);if(w(t.list_avatars))return N(r,t);if(w(t.clone))return T(r,t);if(w(t.clone_status)){const $=l(t.avatar_id);if(!$)throw new i("❌ clone-status mode requires --avatar-id");return R(r,$,a)}if(w(t.check_status)){const $=M(t.generation_id,"generation_id");if($===void 0)throw new i("❌ check-status mode requires --generation-id");return C(r,$,a)}const n=l(t.avatar_id);if(!n)throw new i("❌ provide --avatar-id to pick the avatar (use --list-avatars to see available avatars)");const s=(t.audio_url??"").trim(),g=t.text??"";if(s&&!/^https?:\/\//i.test(s))throw new i(`❌ --audio-url needs a public http(s) URL (local files are not uploaded), received: ${s}`);if(!s&&!g.trim())throw new i("❌ in TTS mode provide --text, or use --audio-url for audio-driven mode");const o=(await b(t.api_base_url)).digitalHuman;m({phase:"gen-digital-human:resolve-avatar",avatarId:n});const u=await I(r,n);if(u.cloneStatus==="cloning")throw new i(`❌ avatar ${n} is still cloning; check with --clone-status --avatar-id ${n}`);if(u.cloneStatus==="failed")throw new i(`❌ avatar ${n} failed to clone (${u.cloneError||"unknown error"}); clone it again`);const d=O(u,o.sources),c={avatarId:n,source:d};s?c.audioUrl=s:(c.text=g,c.voiceId=t.voice_id??o.defaultVoiceId,t.voice_name&&(c.voiceName=String(t.voice_name))),m({phase:"gen-digital-human:request",avatarId:n,source:d,mode:s?"audio":"tts"});const h=await p(r,"/digital-human/video/generate",c,{timeoutMs:6e4}),v=h.generationId;if(!v)throw new i(`❌ could not parse generationId; API returned: ${JSON.stringify(h)}`);m({phase:"gen-digital-human:async",generationId:v});const _=await J(r,v);if(!_)throw new i(`❌ video generated but no URL was returned; rerun --check-status --generation-id ${v} later`);if(a){process.stdout.write(JSON.stringify({url:_,generationId:v})+`
+`),n==="failed"){const o=a.errorMessage??a.error??a.message??"unknown error";process.stdout.write(`   failure reason: ${o}
+`)}}u(C,"checkStatus");const D=30*6e4;async function J(t,e){return await S(async()=>{const a=await p(t,"/digital-human/video/status",{generationId:e},{timeoutMs:3e4}),n=a.status??"unknown";if(v({phase:"gen-digital-human:poll",generationId:e,status:n}),n==="completed")return a.videoUrl??"";if(n==="failed"){const o=a.errorMessage??a.error??a.message??"unknown error";throw new i(`❌ video generation failed: ${o}`)}return null},{intervalMs:5e3,timeoutMs:D}).catch(a=>{throw a instanceof i&&/polling timed out/.test(a.message)?new i(`${a.message}; still generating on the server — resume with --check-status --generation-id ${e}`):a})}u(J,"pollVideoStatus");function P(t){const e=String(t.video_url??"").trim(),r=String(t.audio_url??"").trim(),a=String(t.lipsync_mode??"speed");for(const[n,o]of[["--video-url",e],["--audio-url",r]])if(!/^https?:\/\//i.test(o))throw new i(`❌ lip-sync needs a public http(s) URL for ${n}, received: ${o}`);if(a!=="speed"&&a!=="precision")throw new i(`❌ --lipsync-mode must be speed or precision, received: ${a}`);return{videoUrl:e,audioUrl:r,mode:a}}u(P,"buildLipsyncRequest");async function H(t,e){const r=await M(e.skillName,{apiBaseUrl:t.api_base_url,privateToken:t.priv_token,preflightToken:e.auth?.token}),a=g(t.json_output);if(g(t.list_avatars))return O(r,t);if(g(t.clone))return T(r,t);if(g(t.clone_status)){const h=c(t.avatar_id);if(!h)throw new i("❌ clone-status mode requires --avatar-id");return j(r,h,a)}if(g(t.check_status)){const h=I(t.generation_id,"generation_id");if(h===void 0)throw new i("❌ check-status mode requires --generation-id");return C(r,h,a)}if(t.video_url){const h=P(t);v({phase:"gen-digital-human:request",mode:"lipsync",lipsyncMode:h.mode});const _=await p(r,"/digital-human/lipsync/generate",h,{timeoutMs:6e4});if(!_.generationId)throw new i(`❌ could not parse generationId; API returned: ${JSON.stringify(_)}`);return U(r,_.generationId,a)}const n=c(t.avatar_id);if(!n)throw new i("❌ provide --avatar-id to pick the avatar (use --list-avatars to see available avatars)");const o=(t.audio_url??"").trim(),f=t.text??"";if(o&&!/^https?:\/\//i.test(o))throw new i(`❌ --audio-url needs a public http(s) URL (local files are not uploaded), received: ${o}`);if(!o&&!f.trim())throw new i("❌ in TTS mode provide --text, or use --audio-url for audio-driven mode");const l=(await N(t.api_base_url)).digitalHuman;v({phase:"gen-digital-human:resolve-avatar",avatarId:n});const s=await R(r,n);if(s.cloneStatus==="cloning")throw new i(`❌ avatar ${n} is still cloning; check with --clone-status --avatar-id ${n}`);if(s.cloneStatus==="failed")throw new i(`❌ avatar ${n} failed to clone (${s.cloneError||"unknown error"}); clone it again`);const d=L(s,l.sources),m={avatarId:n,source:d};o?m.audioUrl=o:(m.text=f,m.voiceId=c(t.voice_id)||c(s.defaultVoiceId)||l.defaultVoiceId,t.voice_name&&(m.voiceName=String(t.voice_name))),v({phase:"gen-digital-human:request",avatarId:n,source:d,mode:o?"audio":"tts"});const w=await p(r,"/digital-human/video/generate",m,{timeoutMs:6e4}),$=w.generationId;if(!$)throw new i(`❌ could not parse generationId; API returned: ${JSON.stringify(w)}`);return U(r,$,a)}u(H,"genDigitalHuman");async function U(t,e,r){v({phase:"gen-digital-human:async",generationId:e});const a=await J(t,e);if(!a)throw new i(`❌ video generated but no URL was returned; rerun --check-status --generation-id ${e} later`);if(r){process.stdout.write(JSON.stringify({url:a,generationId:e})+`
 `);return}process.stdout.write(`
 🔗 Video URL (renders directly, no download needed):
-${_}
+${a}
 `),process.stdout.write(`
 🎉 Digital-human video generation done!
-`)}f(x,"genDigitalHuman");export{x as genDigitalHuman};
+`)}u(U,"finishGeneration");export{P as buildLipsyncRequest,H as genDigitalHuman};

package/dist/handlers/gen-voice.js

@@ -1,19 +1,23 @@
-var w=Object.defineProperty;var d=(e,i)=>w(e,"name",{value:i,configurable:!0});import{mmPost as m,resolveHttpContext as v,SkillError as c}from"../http.js";import{getCapabilities as y}from"../capabilities.js";import{emitProgress as x}from"../progress.js";import{isTrue as u,toNumber as _}from"./shared.js";const b=[{id:"Chinese (Mandarin)_Male_Announcer",language:"zh",name:"Mandarin Male Announcer (legacy default)"},{id:"english-male-friendly-01",language:"en",name:"Friendly Male (English, TBD)"}];async function $(e){const o=(await m(e,"/voice/page",{current:1,pageSize:100},{timeoutMs:3e4})).list??[];if(o.length===0){process.stdout.write(`⚠️  No voices available
-`);return}process.stdout.write(`
-${"Voice ID".padEnd(30)} Name
-`),process.stdout.write(`${"-".repeat(30)} ${"-".repeat(20)}
-`);for(const s of o)process.stdout.write(`${(s.uniqId??"").padEnd(30)} ${s.name??""}
-`);process.stdout.write(`
-${o.length} voice(s) available
-`),process.stdout.write(`💡 Use --voice-id <id> to select a voice for synthesis
-`)}d($,"listVoicesRemote");function k(){process.stderr.write(`⚠️  --local prints a hardcoded 2-entry fallback list, NOT the available voices. Drop --local to query the live catalog.
-`);for(const e of b)process.stdout.write(`${e.id}	${e.language}	${e.name}
-`)}d(k,"listVoicesLocal");async function L(e,i){if(u(e.list_voices)){if(u(e.local))return k();const t=await v(i.skillName,{apiBaseUrl:e.api_base_url,privateToken:e.priv_token,preflightToken:i.auth?.token});return $(t)}const o=e.text;if(!o||typeof o!="string"||!o.trim())throw new c("❌ Please provide --text to specify the text to synthesize");const s=e.api_base_url,n=(await y(s)).voice,p=e.voice_id??n.defaultVoiceId,r=_(e.speed,"speed")??1;if(r<n.speedMin||r>n.speedMax)throw new c(`❌ speed must be in the range ${n.speedMin}~${n.speedMax}`);const g=e.language_boost?.trim()||void 0,h=await v(i.skillName,{apiBaseUrl:s,privateToken:e.priv_token,preflightToken:i.auth?.token});x({phase:"gen-voice:request",voiceId:p,speed:r});const a=await m(h,"/tool/tts",{provider:n.provider,text:o,voiceSetting:{voiceId:p,speed:r},outputFormat:"url",...g?{languageBoost:g}:{}},{timeoutMs:12e4}),l=a.audio;if(!l)throw new c(`❌ API response did not contain an audio URL: ${JSON.stringify(a)}`);if(u(e.json_output)){process.stdout.write(JSON.stringify({url:l,audio_length_ms:a.extraInfo?.audioLength??null,subtitles:(a.subtitles??[]).map(t=>({text:t.text??"",timeBegin:t.timeBegin??0,timeEnd:t.timeEnd??0,...typeof t.textBegin=="number"&&typeof t.textEnd=="number"?{textBegin:t.textBegin,textEnd:t.textEnd}:{}}))})+`
-`);return}const f=a.extraInfo?.audioLength;typeof f=="number"&&process.stdout.write(`
-🕐 Audio length: ${(f/1e3).toFixed(1)} s
+var T=Object.defineProperty;var l=(e,o)=>T(e,"name",{value:o,configurable:!0});import{mmPost as w,resolveHttpContext as $,SkillError as h}from"../http.js";import{getCapabilities as b}from"../capabilities.js";import{emitProgress as A}from"../progress.js";import{isTrue as m,toNumber as y}from"./shared.js";const L=[{id:"Chinese (Mandarin)_Male_Announcer",language:"zh",name:"Mandarin Male Announcer (legacy default)"},{id:"english-male-friendly-01",language:"en",name:"Friendly Male (English, TBD)"}],E=100,_=1,x=3,M={male:"男",m:"男",man:"男",female:"女",f:"女",woman:"女"};function f(e){if(e==null)return;const o=String(e).trim();return o||void 0}l(f,"optString");function v(e,o){return(e.tagItems??[]).filter(t=>t.category===o&&t.name).map(t=>t.name).join("/")}l(v,"tagsOf");function N(e){const o=y(e.page,"page")??1;if(!Number.isInteger(o)||o<1)throw new h(`❌ page must be a positive integer, received: ${e.page}`);const t={current:o,pageSize:E},p=f(e.name);p&&(t.name=p);const r=f(e.language);r&&(t.language=r);const i=f(e.gender);if(i&&(t.gender=M[i.toLowerCase()]??i),m(e.mine))return{path:"/voice/collect/myPage",body:t};const s=f(e.provider)?.toLowerCase();s&&(t.provider=s);const a=f(e.voice_type)?.toLowerCase();return a&&(t.voiceType=a),{path:"/voice/page",body:t}}l(N,"buildVoiceListRequest");async function k(e,o){const{path:t,body:p}=N(o),r=await w(e,t,p,{timeoutMs:3e4}),i=r.list??[],s=t!=="/voice/page",a=Number(p.current),g=r.pager?.total??i.length;if(m(o.json_output)){process.stdout.write(JSON.stringify({page:a,total:g,voices:i.map(n=>({id:n.uniqId??"",name:n.name??"",provider:n.provider??"",type:n.voiceType??"",gender:v(n,x),language:v(n,_)}))})+`
+`);return}if(i.length===0){process.stdout.write(a>1?`⚠️  No voices on page ${a} (total ${g})
+`:s?`⚠️  You have no cloned voices
+`:`⚠️  No voices match these filters
+`);return}const d=Math.min(48,Math.max(30,...i.map(n=>(n.uniqId??"").length)));process.stdout.write(`
+${"Voice ID".padEnd(d)} ${"Provider".padEnd(10)} ${"Type".padEnd(6)} ${"Gender".padEnd(6)} ${"Language".padEnd(12)} Name
+`),process.stdout.write(`${"-".repeat(d)} ${"-".repeat(10)} ${"-".repeat(6)} ${"-".repeat(6)} ${"-".repeat(12)} ${"-".repeat(20)}
+`);for(const n of i)process.stdout.write(`${(n.uniqId??"").padEnd(d)} ${(n.provider??"").padEnd(10)} ${(n.voiceType??"").padEnd(6)} ${v(n,x).padEnd(6)} ${v(n,_).padEnd(12)} ${n.name??""}
+`);const u=(a-1)*E+i.length;process.stdout.write(`
+${i.length} voice(s) on page ${a}, ${g} in total
+`),g>u&&process.stdout.write(`💡 More voices: add --page ${a+1}, or narrow with --provider / --gender / --language / --name
+`),process.stdout.write(`💡 Use --voice-id <id> to select a voice; the provider is picked from the voice automatically
+`)}l(k,"listVoicesRemote");function C(){process.stderr.write(`⚠️  --local prints a hardcoded 2-entry fallback list, NOT the available voices. Drop --local to query the live catalog.
+`);for(const e of L)process.stdout.write(`${e.id}	${e.language}	${e.name}
+`)}l(C,"listVoicesLocal");async function R(e,o){if(m(e.list_voices)){if(m(e.local))return C();const c=await $(o.skillName,{apiBaseUrl:e.api_base_url,privateToken:e.priv_token,preflightToken:o.auth?.token});return k(c,e)}const t=e.text;if(!t||typeof t!="string"||!t.trim())throw new h("❌ Please provide --text to specify the text to synthesize");const p=e.api_base_url,r=(await b(p)).voice,i=e.voice_id??r.defaultVoiceId,s=y(e.speed,"speed")??1;if(s<r.speedMin||s>r.speedMax)throw new h(`❌ speed must be in the range ${r.speedMin}~${r.speedMax}`);const a=e.language_boost?.trim()||void 0,g=await $(o.skillName,{apiBaseUrl:p,privateToken:e.priv_token,preflightToken:o.auth?.token});A({phase:"gen-voice:request",voiceId:i,speed:s});const d=await w(g,"/tool/tts",{provider:r.provider,text:t,voiceSetting:{voiceId:i,speed:s},outputFormat:"url",...a?{languageBoost:a}:{}},{timeoutMs:12e4}),u=d.audio;if(!u)throw new h(`❌ API response did not contain an audio URL: ${JSON.stringify(d)}`);if(m(e.json_output)){process.stdout.write(JSON.stringify({url:u,audio_length_ms:d.extraInfo?.audioLength??null,subtitles:(d.subtitles??[]).map(c=>({text:c.text??"",timeBegin:c.timeBegin??0,timeEnd:c.timeEnd??0,...typeof c.textBegin=="number"&&typeof c.textEnd=="number"?{textBegin:c.textBegin,textEnd:c.textEnd}:{}}))})+`
+`);return}const n=d.extraInfo?.audioLength;typeof n=="number"&&process.stdout.write(`
+🕐 Audio length: ${(n/1e3).toFixed(1)} s
 `),process.stdout.write(`
 🔗 Audio URL (plays directly, no download needed):
-${l}
+${u}
 `),process.stdout.write(`
 🎉 TTS synthesis done!
-`)}d(L,"genVoice");export{L as genVoice};
+`)}l(R,"genVoice");export{N as buildVoiceListRequest,R as genVoice};

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.13.8",
-  "generatedAt": "2026-10-31T00:45:42.523Z",
+  "version": "0.13.10",
+  "generatedAt": "2026-11-05T14:34:43.632Z",
   "skills": [
     {
       "id": "doc-parse",
@@ -203,7 +203,15 @@
           },
           "all": {
             "type": "boolean",
-            "description": "With list_avatars=true: list the full public HiFly inventory (500+, mostly uncurated, no scene tags) instead of the curated public avatars. Only for when the curated set has nothing suitable."
+            "description": "With list_avatars=true: list one provider's full public inventory (HiFly by default, 500+, mostly uncurated, no scene tags) instead of the curated public avatars. Only for when the curated set has nothing suitable."
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "hifly",
+              "heygen"
+            ],
+            "description": "With list_avatars=true and all=true: which provider's full public inventory to list. Defaults to hifly. heygen is only available when the capabilities catalog lists it."
           },
           "name": {
             "type": "string",
@@ -223,7 +231,7 @@
           },
           "clone": {
             "type": "boolean",
-            "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."
+            "description": "Clone mode: create a custom avatar (HiFly by default, or HeyGen with clone_provider=heygen) 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",
@@ -237,6 +245,14 @@
             ],
             "description": "With clone=true: source type. Defaults to video."
           },
+          "clone_provider": {
+            "type": "string",
+            "enum": [
+              "hifly",
+              "heygen"
+            ],
+            "description": "With clone=true: where to create the avatar. hifly (default) accepts a video or a photo; heygen accepts a photo only (clone_type=image, jpg/png ≤ 32MB) and gives more natural lip-sync for non-Chinese speech at a higher per-second price. Only use heygen when the capabilities catalog lists it."
+          },
           "thumbnail_url": {
             "type": "string",
             "description": "With clone=true: optional cover image URL shown in avatar lists (image clones default to the image itself). The output aspect ratio always follows the cloned source; it cannot be chosen at generation time."
@@ -253,13 +269,25 @@
             "type": "string",
             "description": "Narration text (TTS mode, ≤ 10000 chars). Synthesized with voice_id, then drives the avatar; the speech must last at least 5 s. Ignored when audio_url is given."
           },
+          "video_url": {
+            "type": "string",
+            "description": "Lip-sync mode: public http(s) URL of the video to re-voice. Needs audio_url. Replaces avatar_id."
+          },
+          "lipsync_mode": {
+            "type": "string",
+            "enum": [
+              "speed",
+              "precision"
+            ],
+            "description": "Lip-sync quality, default speed. precision costs about 4x as much."
+          },
           "audio_url": {
             "type": "string",
             "description": "Audio-driven mode: public http(s) URL of mp3 / m4a / wav, 5 s – 30 min, ≤ 100 MB. Takes precedence over text / voice_id."
           },
           "voice_id": {
             "type": "string",
-            "description": "Voice id (TTS mode). Shares the catalog with gen-voice (including cloned voices) — call gen_voice with list_voices=true to see available ids rather than inventing one."
+            "description": "Voice id (TTS mode). Optional: defaults to the avatar's own voice (a curated avatar's suggested voice, or a HeyGen digital twin's cloned voice), else the service default. Shares the catalog with gen-voice (any provider, including cloned voices) — call gen_voice with list_voices=true to see available ids rather than inventing one."
           },
           "voice_name": {
             "type": "string",
@@ -285,7 +313,9 @@
           "avatar_id",
           "text",
           "voice_id",
-          "audio_url"
+          "audio_url",
+          "video_url",
+          "lipsync_mode"
         ],
         "advanced": [],
         "hidden": [
@@ -294,11 +324,13 @@
           "clone",
           "clone_url",
           "clone_type",
+          "clone_provider",
           "thumbnail_url",
           "wait",
           "clone_status",
           "mine",
           "all",
+          "source",
           "name",
           "gender",
           "check_status",
@@ -607,6 +639,43 @@
             "type": "string",
             "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."
           },
+          "source": {
+            "type": "string",
+            "description": "Presenter source, for templates that declare capabilities.sources: digital-human, lip-sync or real-footage. Omit to use the template's default."
+          },
+          "template_style": {
+            "type": "string",
+            "description": "Visual style for templates that ship several, e.g. talking-head-studio: douyin-bold, news-anchor, live-ecommerce."
+          },
+          "presenter_video": {
+            "type": "string",
+            "description": "URL of the user's talking-head video. Required with source real-footage or lip-sync."
+          },
+          "lipsync_mode": {
+            "type": "string",
+            "enum": [
+              "speed",
+              "precision"
+            ],
+            "description": "Lip-sync quality for source lip-sync, default speed. precision costs about 4x as much."
+          },
+          "broll_asset": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "URLs of images or videos the user picked as b-roll from their asset library (the replicate card's 空镜素材 asset lines), on any source. Not scene_images: scene_images treats every entry as an image."
+          },
+          "broll_mode": {
+            "type": "string",
+            "enum": [
+              "auto",
+              "ai-image",
+              "ai-video",
+              "none"
+            ],
+            "description": "Scenes without a broll_asset (the replicate card's 其余画面): auto (the visual style's default), ai-image, ai-video (at most 3 scenes, the rest stay images) or none."
+          },
           "narration": {
             "type": "string",
             "enum": [
@@ -752,6 +821,10 @@
           "background_preset",
           "sequence_preset",
           "sequence_fit",
+          "source",
+          "template_style",
+          "presenter_video",
+          "lipsync_mode",
           "narration",
           "background_asset",
           "payload",
@@ -769,6 +842,8 @@
           "subheadline",
           "carousel_items",
           "scene_images",
+          "broll_asset",
+          "broll_mode",
           "caption_lines",
           "stub_image_url",
           "stub_video_url",
@@ -925,11 +1000,11 @@
       "toolName": "gen_voice",
       "tier": "atomic",
       "category": "asset",
-      "title": "Text-to-Speech (Minimax)",
-      "summary": "Text-to-speech (TTS): synthesize narration audio from text via the Minimax TTS model. Returns the persisted audio URL — no download needed.",
+      "title": "Text-to-Speech",
+      "summary": "Text-to-speech (TTS): synthesize narration audio from text. The voice catalog spans several providers (MiniMax, 豆包/Volcengine, HeyGen, and the caller's own cloned voices); the provider is picked from the voice id automatically. Returns the persisted audio URL — no download needed.",
       "triggers": [
         "AI voice-over, TTS, text-to-speech, generate narration audio",
-        "Use Minimax for speech synthesis",
+        "Use MiniMax / 豆包 (Doubao) / HeyGen voices for speech synthesis",
         "Read a piece of text aloud / produce an audio file from text"
       ],
       "entry": {
@@ -951,15 +1026,57 @@
           },
           "voice_id": {
             "type": "string",
-            "description": "Voice id. Default 'Chinese (Mandarin)_Male_Announcer'. When unsure, call with list_voices=true first to see what's available — do not invent ids, and do not declare a voice unavailable unless it is missing from that list."
+            "description": "Voice id from list_voices (any provider; synthesis routes to the voice's own provider). Default 'Chinese (Mandarin)_Male_Announcer'. When unsure, call with list_voices=true first — do not invent ids, and do not declare a voice unavailable unless it is missing from the filtered list."
           },
           "speed": {
             "type": "number",
-            "description": "Speech rate, 0.5-2.0"
+            "description": "Speech rate, 0.5-2.0. Some HeyGen cloned voices ignore it."
           },
           "list_voices": {
             "type": "boolean",
-            "description": "List the available voices and exit. This queries the live voice service and is the authoritative catalog — one call is enough, and its absence from this list is the only evidence that a voice id is invalid."
+            "description": "List voices and exit (one page of up to 100, with provider / type / gender / language columns and the total). This queries the live voice service and is the authoritative catalog. The public catalog has a few hundred voices, so narrow it with provider / gender / language / name, or page through with page; mine=true lists the caller's own cloned voices instead."
+          },
+          "mine": {
+            "type": "boolean",
+            "description": "With list_voices=true: list the caller's own cloned voices instead of the public catalog (provider / voice_type do not apply)."
+          },
+          "provider": {
+            "type": "string",
+            "enum": [
+              "minimax",
+              "volcengine",
+              "heygen"
+            ],
+            "description": "With list_voices=true: only voices from this provider (volcengine = 豆包). Not needed for synthesis."
+          },
+          "voice_type": {
+            "type": "string",
+            "enum": [
+              "system",
+              "clone"
+            ],
+            "description": "With list_voices=true: system (stock) or clone voices."
+          },
+          "gender": {
+            "type": "string",
+            "enum": [
+              "male",
+              "female"
+            ],
+            "description": "With list_voices=true: filter by gender."
+          },
+          "language": {
+            "type": "string",
+            "description": "With list_voices=true: filter by language tag, exact tag as shown in the Language column (e.g. 中文-普通话, 中文-粤语, 英语, 日语)."
+          },
+          "name": {
+            "type": "string",
+            "description": "With list_voices=true: fuzzy-filter by voice name."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "With list_voices=true: page number (100 per page). Default 1."
           },
           "json_output": {
             "type": "boolean",
@@ -978,7 +1095,14 @@
         ],
         "hidden": [
           "json_output",
-          "list_voices"
+          "list_voices",
+          "mine",
+          "provider",
+          "voice_type",
+          "gender",
+          "language",
+          "name",
+          "page"
         ]
       }
     },
@@ -1104,6 +1228,10 @@
             "minimum": 1,
             "description": "Render job id (positive integer, e.g. 8). This is the integer N parsed from prepare_video_assets's stdout line '📦 render job jobId: N' (also tolerated: legacy zh '📦 渲染任务 jobId: N'). Never pass 0, a placeholder string, or descriptive text."
           },
+          "restyle": {
+            "type": "string",
+            "description": "Render the same video again in another visual style (a template_style id). Reuses the script, assets and timing, so nothing is regenerated. Only for templates with visual styles such as talking-head-studio."
+          },
           "save_job": {
             "type": "boolean",
             "description": "Persist the render Manifest back to the database under the same jobId (default true). Auto-degrades to false when PRIV_TOKEN is missing. Pass false to opt out explicitly."
@@ -1138,6 +1266,7 @@
           "job_id"
         ],
         "advanced": [
+          "restyle",
           "save_job",
           "upload_title",
           "no_upload",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.13.8",
+  "version": "0.13.10",
   "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-digital-human/SKILL.md

@@ -19,7 +19,7 @@ triggers:
 
 # Digital-Human Skill
 
-Wraps ab-api's digital-human endpoints (the same ones the web studio uses), authenticated with the **Tianyan privateToken**. The provider is **HiFly**: avatars are cloned from a video or photo, then driven by audio. Generation is async — the handler submits the task and polls `/digital-human/video/status` until completion.
+Wraps ab-api's digital-human endpoints (the same ones the web studio uses), authenticated with the **Tianyan privateToken**. Providers are **HiFly** (default) and, when the capabilities catalog lists it, **HeyGen**: avatars are cloned from a video or photo (HeyGen: photo only), then driven by audio. Each avatar belongs to one provider and always renders there — you never pick the provider at generation time. HeyGen costs more per second (the curated list and the studio picker mark HeyGen avatars); prefer it only for non-Chinese speech or when the user asks. Generation is async — the handler submits the task and polls `/digital-human/video/status` until completion.
 
 ## Capabilities
 
@@ -57,6 +57,7 @@ remixmate gen-digital-human --list-avatars                    # curated public a
 remixmate gen-digital-human --list-avatars --gender female    # curated, filtered by gender
 remixmate gen-digital-human --list-avatars --mine             # your cloned avatars
 remixmate gen-digital-human --list-avatars --all --name "教师" # full HiFly inventory (500+; always narrow with --name)
+remixmate gen-digital-human --list-avatars --all --source heygen --name "Anna" # full HeyGen public inventory
 ```
 
 The default list is the **curated public library**: avatars an admin picked, with a cover, scene tags (`education` / `medical` / `news` / `business` / `culture` / `outdoor` / `lifestyle` / `festival` / `ecommerce`) and usually a suggested voice. Prefer it — pick the avatar whose scenes match the script, and pass its `Voice` column as `--voice-id` unless the user chose a voice. Fall back to `--all` only when nothing curated fits; those entries have no tags or suggested voice.
@@ -94,6 +95,9 @@ remixmate gen-digital-human --clone --name "My presenter" --clone-url "https://e
 # Portrait photo clone (charged per clone)
 remixmate gen-digital-human --clone --clone-type image --name "My presenter" --clone-url "https://example.com/me.jpg"
 
+# HeyGen photo avatar (photo only, jpg/png ≤ 32MB; more natural lip-sync for English and other languages)
+remixmate gen-digital-human --clone --clone-type image --clone-provider heygen --name "My presenter" --clone-url "https://example.com/me.jpg"
+
 # Submit without waiting, then poll
 remixmate gen-digital-human --clone --wait false --name "My presenter" --clone-url "https://example.com/me.mp4"
 remixmate gen-digital-human --clone-status --avatar-id dh_xxx
@@ -109,12 +113,16 @@ remixmate gen-digital-human --clone-status --avatar-id dh_xxx
 | `--name` | list / clone | Fuzzy filter; with `--clone` the new avatar's name (required) | — |
 | `--avatar-id` | generate / clone-status | Avatar id (required) | — |
 | `-t` / `--text` | generate | Script (text-driven) | — |
-| `--voice-id` | generate | Voice id (text-driven) | `male-qn-qingse` |
+| `--voice-id` | generate | Voice id (text-driven) | the avatar's own voice (curated suggestion / HeyGen twin's cloned voice), else the service default |
 | `--voice-name` | generate | Voice display name (recordkeeping only) | none |
 | `--audio-url` | generate | Audio URL (audio-driven) | none |
+| `--video-url` | generate | Lip-sync an existing video instead of an avatar; needs `--audio-url` | none |
+| `--lipsync-mode` | generate | `speed` or `precision` (about 4x the price) | `speed` |
 | `--check-status` / `--generation-id` | status | Poll a generation job | — |
 | `--clone` / `--clone-url` | clone | Clone mode and source URL (required) | — |
 | `--clone-type` | clone | `video` / `image` | `video` |
+| `--clone-provider` | clone | `hifly` / `heygen` (heygen needs `--clone-type image`) | `hifly` |
+| `--source` | list with `--all` | Which provider's full inventory: `hifly` / `heygen` | `hifly` |
 | `--thumbnail-url` | clone | Cover shown in lists | image itself / none |
 | `--wait` | clone | `false` to return right after submission | wait |
 | `--clone-status` | clone-status | Report clone status of `--avatar-id` | — |

package/skills/gen-digital-human/skill.json

@@ -29,7 +29,15 @@
       },
       "all": {
         "type": "boolean",
-        "description": "With list_avatars=true: list the full public HiFly inventory (500+, mostly uncurated, no scene tags) instead of the curated public avatars. Only for when the curated set has nothing suitable."
+        "description": "With list_avatars=true: list one provider's full public inventory (HiFly by default, 500+, mostly uncurated, no scene tags) instead of the curated public avatars. Only for when the curated set has nothing suitable."
+      },
+      "source": {
+        "type": "string",
+        "enum": [
+          "hifly",
+          "heygen"
+        ],
+        "description": "With list_avatars=true and all=true: which provider's full public inventory to list. Defaults to hifly. heygen is only available when the capabilities catalog lists it."
       },
       "name": {
         "type": "string",
@@ -49,7 +57,7 @@
       },
       "clone": {
         "type": "boolean",
-        "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."
+        "description": "Clone mode: create a custom avatar (HiFly by default, or HeyGen with clone_provider=heygen) 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",
@@ -63,6 +71,14 @@
         ],
         "description": "With clone=true: source type. Defaults to video."
       },
+      "clone_provider": {
+        "type": "string",
+        "enum": [
+          "hifly",
+          "heygen"
+        ],
+        "description": "With clone=true: where to create the avatar. hifly (default) accepts a video or a photo; heygen accepts a photo only (clone_type=image, jpg/png ≤ 32MB) and gives more natural lip-sync for non-Chinese speech at a higher per-second price. Only use heygen when the capabilities catalog lists it."
+      },
       "thumbnail_url": {
         "type": "string",
         "description": "With clone=true: optional cover image URL shown in avatar lists (image clones default to the image itself). The output aspect ratio always follows the cloned source; it cannot be chosen at generation time."
@@ -79,13 +95,22 @@
         "type": "string",
         "description": "Narration text (TTS mode, ≤ 10000 chars). Synthesized with voice_id, then drives the avatar; the speech must last at least 5 s. Ignored when audio_url is given."
       },
+      "video_url": {
+        "type": "string",
+        "description": "Lip-sync mode: public http(s) URL of the video to re-voice. Needs audio_url. Replaces avatar_id."
+      },
+      "lipsync_mode": {
+        "type": "string",
+        "enum": ["speed", "precision"],
+        "description": "Lip-sync quality, default speed. precision costs about 4x as much."
+      },
       "audio_url": {
         "type": "string",
         "description": "Audio-driven mode: public http(s) URL of mp3 / m4a / wav, 5 s – 30 min, ≤ 100 MB. Takes precedence over text / voice_id."
       },
       "voice_id": {
         "type": "string",
-        "description": "Voice id (TTS mode). Shares the catalog with gen-voice (including cloned voices) — call gen_voice with list_voices=true to see available ids rather than inventing one."
+        "description": "Voice id (TTS mode). Optional: defaults to the avatar's own voice (a curated avatar's suggested voice, or a HeyGen digital twin's cloned voice), else the service default. Shares the catalog with gen-voice (any provider, including cloned voices) — call gen_voice with list_voices=true to see available ids rather than inventing one."
       },
       "voice_name": {
         "type": "string",
@@ -111,7 +136,9 @@
       "avatar_id",
       "text",
       "voice_id",
-      "audio_url"
+      "audio_url",
+      "video_url",
+      "lipsync_mode"
     ],
     "advanced": [],
     "hidden": [
@@ -120,11 +147,13 @@
       "clone",
       "clone_url",
       "clone_type",
+      "clone_provider",
       "thumbnail_url",
       "wait",
       "clone_status",
       "mine",
       "all",
+      "source",
       "name",
       "gender",
       "check_status",

package/skills/gen-script/SKILL.md

@@ -487,6 +487,12 @@ python3 <SkillDir>/scripts/gen_script.py \
 | `--sequence-preset` | Style preset for templates declaring `capabilities.mediaBinding.options.preset`; one of that option's enum in the template's `customPayloadSchema` (`none` keeps the template defaults). Written next to the 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 on the replicate card (pass the id in parentheses, e.g. `风格预设: <名称>（<id>）` → `<id>`); otherwise the choice is silently dropped. Rejected on templates without that option. |
 | `--sequence-fit` | Fill mode for templates declaring `capabilities.mediaBinding.options.fit`; one of that option's enum (`auto` keeps the template / preset default). Beats the preset's own fit. **Must** pass when the user picked it on the replicate card (`显示方式: <名称>（<id>）` → `<id>`). |
 | `--narration` | `auto` (the template's `capabilities.needsNarration` decides), `on` or `off`. Templates where narration is optional default to none; **must** pass `on` when the user picked narration on the replicate card (`旁白: <名称>（narrated）`), otherwise the narration written later is dropped without an error. `on` adds the narration slot, a `gen-voice` asset and subtitles; on `fit-images` templates that declare `customPayload.minDurationSec` it also writes the media's natural length there, so a short narration does not compress the media (a longer one stretches the scene). |
+| `--template-style` | Visual style for templates that ship several (`talking-head-studio`: `douyin-bold`, `news-anchor`, `live-ecommerce`, `minimal-talk`, `interview-serif`, `gold-quote`, `lecture`, `soft-glow`, `cinema-talk`). |
+| `--presenter-video` | URL of the user's talking-head video, with `--source real-footage` (used as is, no cutting) or `--source lip-sync` (re-voiced with the script). |
+| `--broll-asset` | Repeatable. URL of an image or video the user picked as b-roll from their asset library (replicate card field `空镜素材`). Works on every `--source`. Use the description on the asset line to anchor it to the sentence it matches with `atText`; if one fits nowhere, remove it and tell the user which. |
+| `--broll-mode` | Scenes with no `--broll-asset`: `auto` (the visual style's default), `ai-image`, `ai-video` (at most 3 scenes, the rest stay images) or `none`. Pass the replicate card field `其余画面`. |
+| `--lipsync-mode` | `speed` (default) or `precision` (about 4x the price), with `--source lip-sync`. |
+| `--source` | Presenter source for templates that declare `capabilities.sources`: `digital-human`, `lip-sync` or `real-footage`. Omit to use the template's default. Writes `global.presenter.source` and `global.configLock`; capabilities, `llmHint` and the payload schema then follow that source. |
 | `--background-asset` | URL of the user's background image or video (`.mp4/.mov/.webm/.m4v` → video). Added as existing asset `asset-background`; every scene's `customPayload.background` gets `preset: image` + `assetRef`, or `preset: video` + `videoAssetRef`. Conflicts with a different `--background-preset`; rejected when the template's background enum lacks that kind. | none |
 | `--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 |