@conceptcraft/mindframes 0.3.24 → 0.3.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/bin/postinstall.js +4 -4
- package/dist/index.js +342 -328
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { createRequire } from 'module'; const require = createRequire(import.meta.url);
|
|
3
|
-
var g={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"CLI tool for Mindframes presentation generation",commands:["mf","mindframes"],apiUrl:"https://www.mindframes.app",docsUrl:"https://docs.mindframes.ai",packageName:"@conceptcraft/mindframes",configDir:".mindframes",apiKeyEnvVar:"MINDFRAMES_API_KEY",apiUrlEnvVar:"MINDFRAMES_API_URL",codexSelfConnectorAppId:"asdk_app_6a2b9629c1608191970dcb3ab374ac55"};import B from"chalk";import{Command as Tx}from"commander";import Kt from"chalk";import{Command as gu}from"commander";function zi(t={}){let e=(c,p)=>{let f=t[c];return f&&f.trim().length>0?f.trim():p},n=e("NEXT_PUBLIC_PRODUCT_SHORT_NAME","ConceptCraft"),r=e("NEXT_PUBLIC_CLI_COMMAND","ccr"),o=e("NEXT_PUBLIC_CLI_COMMAND_FULL","conceptcraft"),i=e("NEXT_PUBLIC_CLI_CONFIG_DIR",`.${o}`),s=n.toUpperCase().replace(/[^A-Z0-9]/g,"_");return{id:o,name:i.replace(/^\./,""),displayName:n,description:`CLI tool for ${n} presentation generation`,commands:[r,o],apiUrl:e("NEXT_PUBLIC_API_URL","http://localhost:3000"),docsUrl:e("NEXT_PUBLIC_DOCS_URL",`https://docs.${n.toLowerCase()}.ai`),packageName:e("NEXT_PUBLIC_CLI_PACKAGE_NAME","@conceptcraft/cli"),configDir:i,apiKeyEnvVar:`${s}_API_KEY`,apiUrlEnvVar:`${s}_API_URL`,codexSelfConnectorAppId:t.NEXT_PUBLIC_CODEX_SELF_CONNECTOR_APP_ID?.trim()||void 0}}var u=typeof g<"u"&&g?g:zi(process.env);import U from"chalk";import Mr from"cli-table3";import _m from"conf";import Hi from"path";var Yi=u.apiUrl,Lm={apiKey:{type:"string"},apiUrl:{type:"string",default:Yi},defaultTeamId:{type:"string"},accessToken:{type:"string"},refreshToken:{type:"string"},tokenExpiresAt:{type:"number"},clientId:{type:"string"},clientSecret:{type:"string"}};function Um(t=u.apiKeyEnvVar){return t.endsWith("_API_KEY")?`${t.slice(0,-8)}_CONFIG_DIR`:`${t}_CONFIG_DIR`}function jm(t=process.env){let e=Um(),n=t[e]?.trim()||t.CC_SLIDES_CONFIG_DIR?.trim();if(n){if(!Hi.isAbsolute(n))throw new Error(`${e} must be an absolute directory path`);return Hi.normalize(n)}}var Xi=jm(),L=new _m({projectName:u.name,schema:Lm,...Xi?{configFileMode:384,cwd:Xi}:{}});function Qi(){return{apiKey:Se(),apiUrl:W(),defaultTeamId:L.get("defaultTeamId"),accessToken:L.get("accessToken"),refreshToken:L.get("refreshToken"),tokenExpiresAt:L.get("tokenExpiresAt"),clientId:L.get("clientId"),clientSecret:L.get("clientSecret")}}function Se(){let t=process.env[u.apiKeyEnvVar]??process.env.CC_SLIDES_API_KEY;return t||L.get("apiKey")}function qr(t){L.set("apiKey",t)}function W(){let t=process.env[u.apiUrlEnvVar]??process.env.CC_SLIDES_API_URL;return t||(L.get("apiUrl")??Yi)}function Vr(t){L.set("apiUrl",t)}function ee(){return L.get("defaultTeamId")}function ot(t){L.set("defaultTeamId",t)}function kn(){L.clear()}function Ft(){return L.path}function it(){return!!Se()}function Zi(){return L.get("accessToken")}function ea(){return L.get("refreshToken")}function Rn(t,e,n){L.set("accessToken",t),L.set("refreshToken",e),L.set("tokenExpiresAt",Date.now()+(n-60)*1e3)}function Cn(){L.delete("accessToken"),L.delete("refreshToken"),L.delete("tokenExpiresAt")}function ta(){let t=L.get("tokenExpiresAt");return t?Date.now()>=t:!0}function Ke(){return!!L.get("accessToken")&&!!L.get("refreshToken")}function na(){return L.get("clientId")}function ra(){return L.get("clientSecret")}function oa(t,e){L.set("clientId",t),L.set("clientSecret",e)}function k(t,e="human"){e!=="quiet"&&e!=="json"&&console.log(U.green("\u2713"),t)}function a(t,e="human"){if(e!=="quiet"){if(e==="json"){console.error(JSON.stringify({error:t}));return}console.error(U.red("\u2717"),t)}}function _(t,e="human"){e!=="quiet"&&e!=="json"&&console.warn(U.yellow("\u26A0"),t)}function ia(t,e="human"){e==="quiet"||e==="json"||console.error(U.cyan("\u2192"),t)}function w(t,e="human"){e!=="quiet"&&e!=="json"&&console.log(U.blue("\u2139"),t)}function at(t,e="en"){return t?`${W()}/${e}/view/presentations/${t}`:"N/A"}function aa(t,e={}){let{showLinks:n=!1,language:r="en"}=e,o=(c,p)=>c.length>p?`${c.slice(0,p-1)}\u2026`:c,i=c=>{if(!c)return"-";try{return new Date(c).toLocaleString("en-US",{month:"short",day:"numeric",hour:"numeric",minute:"2-digit",hour12:!0}).replace(" at ",", ")}catch{return"-"}};if(n){let c=new Mr({head:[U.cyan("Slug"),U.cyan("Title"),U.cyan("Slides"),U.cyan("Created"),U.cyan("URL")]});for(let p of t)c.push([o(p.slug||p.id.slice(0,8),30),o(p.title||"Untitled",22),String(p.numberOfSlides||"-"),i(p.createdAt),at(p.slug,r)]);return c.toString()}let s=new Mr({head:[U.cyan("Slug"),U.cyan("Title"),U.cyan("Slides"),U.cyan("Mode"),U.cyan("Created")],colWidths:[32,28,8,11,18]});for(let c of t)s.push([c.slug||c.id.slice(0,8),c.title||"Untitled",String(c.numberOfSlides||"-"),c.mode||"-",i(c.createdAt)]);return s.toString()}function sa(t){let e=[...t].sort((o,i)=>{if(o.isDefault&&!i.isDefault)return-1;if(!o.isDefault&&i.isDefault)return 1;let s=o.createdAt?new Date(o.createdAt).getTime():0;return(i.createdAt?new Date(i.createdAt).getTime():0)-s}),n=o=>{if(!o)return"-";try{return new URL(o).href}catch{return o.startsWith("http")?o:`https://${o}`}},r=new Mr({head:[U.cyan("Name"),U.cyan("Source"),U.cyan("Color"),U.cyan("Logo"),U.cyan("Default"),U.cyan("ID")]});for(let o of e){let i=o.primaryColor?`${U.bgHex(o.primaryColor)(" ")} ${o.primaryColor}`:"-";r.push([o.name,n(o.sourceUrl),i,o.logoUrl?U.green("\u2713"):U.gray("\u2717"),o.isDefault?U.green("\u2605"):"",o.id])}return r.toString()}function Fr(t){try{return new Date(t).toLocaleString()}catch{return t}}function ge(t){console.log(),console.log(U.bold(t)),console.log(U.gray("\u2500".repeat(t.length)))}function C(t,e){console.log(` ${U.gray(`${t}:`)} ${e??"-"}`)}function qm(t){return JSON.stringify(t,null,2)}function l(t){console.log(qm(t))}import{createHash as Jr,randomUUID as st}from"crypto";import{readFileSync as ba,statSync as wa}from"fs";import{basename as Hr}from"path";import{spawnSync as Vm}from"child_process";import{existsSync as Mm,mkdtempSync as Fm,rmSync as Bm,writeFileSync as Gm}from"fs";import{tmpdir as Wm}from"os";import{join as da}from"path";import Br from"ffmpeg-static";var Km=/Duration:\s*(\d+):(\d+):(\d+(?:\.\d+)?)/;function Jm(t){let e=Km.exec(t);if(!e)return;let n=Number(e[1])*3600+Number(e[2])*60+Number(e[3]);return Number.isFinite(n)&&n>0?n:void 0}function ca(t,e="audio"){if(t.length===0)return;let n=Br&&Mm(Br)?Br:"ffmpeg",r=/^[a-z0-9]+$/i.test(e)?e:"audio",o=Fm(da(Wm(),"mf-tts-duration-")),i=da(o,`speech.${r}`);try{Gm(i,t);let s=Vm(n,["-hide_banner","-i",i],{encoding:"utf8"});return s.error?void 0:Jm(s.stderr??"")}finally{Bm(o,{force:!0,recursive:!0})}}import Sn from"chalk";var d={SUCCESS:0,GENERAL_ERROR:1,AUTH_ERROR:2,NOT_FOUND:3,RATE_LIMIT:4,NETWORK_ERROR:5,INVALID_INPUT:6};async function zm(){let t=ea(),e=na(),n=W();if(!t||!e)return null;try{let r=await fetch(`${n}/.well-known/oauth-authorization-server`);if(!r.ok)return null;let o=await r.json(),i=new URLSearchParams({grant_type:"refresh_token",refresh_token:t,client_id:e}),s=ra();s&&i.set("client_secret",s);let c=await fetch(o.token_endpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:i.toString()});if(!c.ok)return Cn(),null;let p=await c.json();return Rn(p.access_token,p.refresh_token,p.expires_in),p.access_token}catch{return null}}async function la(){return Ke()?ta()?zm():Zi()||null:null}function Ee(){return Ke()||it()}async function y(){if(!Ee()){let t=u.commands[0],e=u.apiKeyEnvVar;console.error(Sn.red("\u2717 Not authenticated.")),console.error(),console.error(Sn.bold("To authenticate, run:")),console.error(Sn.cyan(` ${t} login`)),console.error(),console.error(Sn.gray(`Or set ${e} environment variable.`)),process.exit(d.AUTH_ERROR)}}function Hm(t){return t.length<=14?"****":`${t.slice(0,10)}...${t.slice(-4)}`}function ma(){let t=Se();if(t)return Hm(t)}function Gr(t){return["cc_slides_","mcp_","cc_sk_","sk_"].some(n=>t.startsWith(n))}import{mkdirSync as Xm,readFileSync as Ym,writeFileSync as Qm}from"fs";import{homedir as Zm}from"os";import{join as ua}from"path";import eu from"ajv/dist/2020.js";var Wr=new Map;function pa(){return ua(Zm(),".conceptcraft","schemas")}function ga(t){return ua(pa(),`${t}.json`)}function tu(t){try{let e=JSON.parse(Ym(ga(t),"utf8"));return typeof e?.catalogVersion=="number"&&e.schema?e:null}catch{return null}}function nu(t,e){try{Xm(pa(),{recursive:!0}),Qm(ga(t),JSON.stringify(e))}catch{}}async function ru(t){let e=Wr.get(t);if(e!==void 0)return e;try{let n=await fa(t),r={catalogVersion:n.catalogVersion,schema:n.operationSchema??n.schema};return nu(t,r),Wr.set(t,r),r}catch{let n=tu(t);return Wr.set(t,n),n}}function ou(t){let e=t.instancePath.replace(/^\//,"").replace(/\//g,"."),n=e.length>0?e:"(root)",r=t.keyword==="additionalProperties"?`: unknown field "${t.params.additionalProperty}"`:`: ${t.message??"invalid value"}`;return`${n}${r}`}async function En(t,e){let n=await ru(t);if(!n)return;let r;try{r=new eu({allErrors:!0,strict:!1}).compile(n.schema)}catch{return}if(r(e))return;let o=(r.errors??[]).slice(0,10).map(ou);throw new Error(`Request does not match the ${t} contract \u2014 ${o.join("; ")}`)}function fe(t,e){let n=t instanceof Error?t.message:"Unknown error";return!e||n.includes(e)?n:`${n} Request ID: ${e}. Resume with the matching status command; do not start a duplicate run.`}function se(t,e={}){let n=t?.code?.trim()||e.defaultCode?.trim()||"",r=t?.message?.trim()||"The run failed without a reported reason.";return n?`[${n}] ${r}`:r}function Kr(t){let e=t.status?.trim().toLowerCase()??"";return!!t.error||e==="failed"||e==="errored"||e==="cancelled"?`${t.runId?.trim()?`Run ${t.runId.trim()}`:"Run"} ${e||"failed"}: ${se(t.error)}`:null}function ha(t){let e=t.projectId??"<project-id>";return/Narration is still missing for \d+ slides?\./.test(t.message)?["Narration is captured from speaker notes when the video project is prepared, so 'presentation video refresh' will not backfill it.",`Fill each empty scene with: ${t.binary} presentation video-narration ${e} --slide-id <slide-id> (scene ids: ${t.binary} presentation video inspect ${e})`].join(`
|
|
4
|
-
`):/Every scene is excluded from the video\./.test(t.message)?`Include a scene again with: ${t.binary} presentation video edit ${e} --edit '{"type":"patch_scene","scene":1,"excluded":false}'`:null}async function $e(){let t=await la();if(t)return{Authorization:`Bearer ${t}`};let e=Se();return e?{"x-api-key":e}:{}}var D=class extends Error{constructor(n,r,o=1,i="operation_failed",s=!1){super(n);this.statusCode=r;this.exitCode=o;this.errorCode=i;this.retryable=s;this.name="ApiError"}statusCode;exitCode;errorCode;retryable},Xr="Idempotency-Key";function iu(t){return t&&t!=="GET"?{[Xr]:st()}:{}}async function he(t,e={}){let n=W();if(!Ee()&&!e.allowUnauthenticated)throw new D(`Not authenticated. Run '${u.commands[0]} login' or set ${u.apiKeyEnvVar} environment variable.`,401,2,"authentication_required");let r=await $e(),o=`${n}${t}`,i={...r,...iu(e.method),...e.headers};e.body&&!e.stream&&(i["Content-Type"]="application/json");let s={method:e.method??"GET",headers:i};e.body&&(s.body=JSON.stringify(e.body));let c;try{c=await fetch(o,s)}catch(f){throw new D(`Network error: ${f instanceof Error?f.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!c.ok){let f=await c.text().catch(()=>""),h=su(f,c.status),v=1;switch(c.status){case 401:v=2;break;case 403:v=2;break;case 404:v=3;break;case 429:v=4;break;case 500:v=1;break}let x=`[${h.code}] ${h.message}`;throw new D(x,c.status,v,h.code,h.retryable)}return e.stream?c:c.headers.get("content-type")?.includes("application/json")?c.json():c.text()}function au(t){switch(t){case 400:return"invalid_input";case 401:return"authentication_required";case 402:return"insufficient_credits";case 403:return"access_denied";case 404:return"not_found";case 429:return"rate_limited";case 503:return"service_unavailable";default:return"operation_failed"}}function su(t,e){let n=au(e),r=t.trim()||`HTTP ${e}: The request could not be completed.`;try{let o=JSON.parse(t),i=typeof o.error=="object"&&o.error!==null?o.error:void 0;if(o.ok===!1&&typeof i?.code=="string"&&typeof i.message=="string")return{code:i.code,message:i.message,retryable:i.retryable===!0};if(typeof o.error=="string")return{code:/^[a-z][a-z0-9_]+$/.test(o.error)?o.error:n,message:typeof o.message=="string"?o.message:o.error,retryable:e===429||e>=500}}catch{}return{code:n,message:r,retryable:e===429||e>=500}}async function fa(t){return he(`/api/cli/tools/${encodeURIComponent(t)}/schema`)}async function va(){return he("/api/cli/capabilities",{allowUnauthenticated:!0})}async function I(t,e,n){let r=await Yr(n),o=`?teamId=${encodeURIComponent(r)}`;return he(`/api/cli/tool-runs/${encodeURIComponent(t)}/${encodeURIComponent(e)}${o}`)}async function m(t,e,n){let r=await Yr(e.teamId);return he(`/api/cli/tools/${encodeURIComponent(t)}`,{body:{...e,teamId:r},headers:n?{[Xr]:n}:void 0,method:"POST"})}function J(t){return Yr(t)}async function Yr(t){let e=typeof t=="string"&&t.trim()?t.trim():ee()?.trim();if(e)return e;let n=await xe();if(n.currentTeam?.id)return n.currentTeam.id;throw new D("Team ID required. Select a workspace with `mf config set team-id <id>` or pass --team-id.",400,void 0,"invalid_input")}async function Ia(t){return he("/api/llm-connections/profiles",{body:t,method:"POST"})}async function Ie(t,e,n,r=120){let o=0;for(let i=0;r===null||i<r;i++){let s;try{s=await I(t,e,n),o=0}catch(c){if(c instanceof D&&c.retryable&&o<2){o+=1,await new Promise(p=>setTimeout(p,2e3));continue}throw c instanceof D?new D(`${c.message} Request ID: ${e}.`,c.statusCode,c.exitCode,c.errorCode,c.retryable):new D(`${c instanceof Error?c.message:"Unknown error"} Request ID: ${e}.`,0,5,"poll_failed",!0)}if(s.done){if(s.error)throw new D(`${se(s.error,{defaultCode:"operation_failed"})} Request ID: ${e}.`,500,1,s.error.code??"operation_failed",s.error.retryable);return s}await new Promise(c=>setTimeout(c,(s.nextPollAfterSeconds??2)*1e3))}throw new D(`[operation_timed_out] The background operation timed out. Request ID: ${e}.`,408,1,"operation_timed_out",!0)}function $n(t){return t.error||t.status==="failed"||t.status==="errored"||t.status==="cancelled"?"failed":t.done||t.status==="completed"?"completed":t.status==="in_progress"?"processing":"pending"}function du(t){try{let n=new URL(t).pathname.split("/").pop()?.split(".").pop()?.toLowerCase();return n&&/^[a-z0-9]+$/.test(n)?n:void 0}catch{return}}function Tn(t){let e=t.toLowerCase().split(".").pop();return{pdf:"application/pdf",docx:"application/vnd.openxmlformats-officedocument.wordprocessingml.document",xlsx:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",pptx:"application/vnd.openxmlformats-officedocument.presentationml.presentation",jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",gif:"image/gif",webp:"image/webp",mp4:"video/mp4",mov:"video/quicktime",mpeg:"video/mpeg",mpg:"video/mpeg",webm:"video/webm",aac:"audio/aac",m4a:"audio/mp4",mp3:"audio/mpeg",oga:"audio/ogg",ogg:"audio/ogg",wav:"audio/wav",txt:"text/plain",md:"text/markdown",csv:"text/csv",json:"application/json",html:"text/html",css:"text/css",js:"application/javascript",ts:"text/x-typescript",py:"text/x-python"}[e||""]||"application/octet-stream"}function Bt(t){let e=wa(t);return{fileName:Hr(t),fileSize:e.size,fileType:Tn(t)}}async function Gt(t,e){let n=Bt(t),r=ba(t),o=new FormData;for(let[s,c]of Object.entries(e.fields))o.append(s,c);o.append("file",new Blob([r],{type:n.fileType}),n.fileName);let i=await fetch(e.uploadUrl,{method:"POST",body:o});if(!i.ok)throw new D("Failed to upload file to storage",i.status,1);return{id:e.fileId??st(),name:n.fileName,s3Key:e.s3Key,url:e.fileUrl,size:n.fileSize,type:n.fileType,selected:!0}}async function de(t,e={}){let n=W();if(!Ee())throw new D(`Not authenticated. Run '${u.commands[0]} login' or set ${u.apiKeyEnvVar} environment variable.`,401,2);let r=await $e(),o=wa(t),i=Hr(t),s=Tn(t),c=ba(t),p=Jr("sha256").update(c).digest("hex"),f=await fetch(`${n}/api/cli/files/upload`,{method:"POST",headers:{"Content-Type":"application/json",...r},body:JSON.stringify({fileMetadata:{lastModified:o.mtimeMs,name:i,type:s,size:o.size},...e.storagePrefix?{storagePrefix:e.storagePrefix}:{},...e.idempotencyKey?{uploadIdentity:{contentSha256:p,idempotencyKey:e.idempotencyKey}}:{}})});if(!f.ok){let v=await f.text();throw new D(v||"Failed to get upload URL",f.status,1)}let h=await f.json();return Gt(t,{...e.idempotencyKey?{fileId:`file-${Jr("sha256").update(JSON.stringify({contentSha256:p,fileName:i,idempotencyKey:e.idempotencyKey})).digest("hex")}`}:{},fields:h.fields||{},fileUrl:h.fileUrl,s3Key:h.uploadKey,uploadUrl:h.url})}async function xa(t,e,n={}){let r=[];for(let o=0;o<t.length;o++){let i=t[o],s=Hr(i);e?.(o,t.length,s);let c=await de(i,{idempotencyKey:n.idempotencyKey});r.push(c)}return e?.(t.length,t.length,""),r}async function ka(t,e,n){let r={};for(let[o,i]of Object.entries(t))i!==void 0&&(r[o]=i);return r.brandingId===void 0&&typeof r.brandId=="string"&&(r.brandingId=r.brandId),delete r.brandId,m("createSlides",{...r,...n?{approvalReceipt:n}:{}},e)}async function Ra(t,e=20,n=0,r="updated"){return(await m("listPresentations",{limit:e,offset:n,sort:r,teamId:t})).presentations}async function dt(t,e){let n=e?.includeSlides!==!1,r=await m("getPresentation",{includeSlides:n,presentationId:t,teamId:e?.teamId});return n?{...r.presentation,slides:r.slides}:r.presentation}async function Ca(t,e,n,r){return he(`/api/cli/presentation/${encodeURIComponent(t)}/speaker-notes?teamId=${encodeURIComponent(r)}`,{body:e,headers:{[Xr]:n},method:"POST"})}async function An(t){let e=W(),n=await fetch(`${e}/api/durable-runs/${encodeURIComponent(t)}/events`,{headers:await $e()});if(!n.ok)throw new D(await n.text(),n.status);return n}async function Sa(t,e={}){await m("deletePresentation",{approvalReceipt:e.approvalReceipt,presentationId:t,teamId:e.teamId},e.idempotencyKey??`cli:presentation:delete:${Jr("sha256").update(JSON.stringify({slugOrId:t,teamId:e.teamId??null})).digest("hex")}`)}async function Ea(t,e){return m("updatePresentationVisibility",{presentationId:t,teamId:e.teamId,visibility:e.visibility},e.idempotencyKey??`cli:presentation:visibility:${st()}`)}async function $a(t,e,n){return m("exportPresentation",{format:e,presentationId:t,teamId:n?.teamId})}async function Ta(t){let e;try{e=await fetch(t)}catch(n){throw new D(`Network error while downloading the export: ${n instanceof Error?n.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!e.ok)throw new D(`[fetch_failed] The export download link returned ${e.status}. Signed links expire after one hour \u2014 re-run the export.`,e.status,1,"fetch_failed",!0);return e.arrayBuffer()}async function Aa(t,e,n={}){let r=W();if(!Ee())throw new D(`Not authenticated. Run '${u.commands[0]} login' or set ${u.apiKeyEnvVar} environment variable.`,401,2);let o=await $e(),i=new FormData,s=new Blob([t],{type:"application/zip"});i.append("file",s,e),i.append("options",JSON.stringify({dryRun:n.dryRun??!1,remapIds:!0}));let c=await fetch(`${r}/api/presentations/import`,{method:"POST",headers:o,body:i}),p=await c.json();if(!c.ok)throw new D(p.errors?.[0]?.message??"Import failed",c.status,1);return p}async function Pa(t,e=25){return m("listSlideTemplates",{limit:e,search:t})}async function Oa(t,e,n,r,o){return m("extractBranding",{approvalReceipt:n,skipExistingBrandingLookup:r,teamId:e,url:t},o)}async function xe(){return he("/api/cli/whoami")}async function Da(){return he("/api/cli/features")}async function Na(t,e,n={}){let r=W();if(!Ee())throw new D(`Not authenticated. Run '${u.commands[0]} login' or set ${u.apiKeyEnvVar} environment variable.`,401,2);let o=await $e(),i=await fetch(`${r}/api/presentations/${t}/generate-blog`,{method:"POST",headers:{"Content-Type":"application/json",...o},body:JSON.stringify({documentCreatedAt:e,targetWordCount:n.targetWordCount??300,tone:n.tone??"professional",language:n.language??"en",targetAudience:n.targetAudience??"General Audience",blogFormat:n.blogFormat??"narrative",customInstructions:n.customInstructions??"",includeImages:n.includeImages??!0,includeTableOfContents:n.includeTableOfContents??!1})});if(!i.ok)throw new D(await i.text(),i.status,i.status===404?3:1);return i}async function Qr(t){return m("getGenerationLimits",{teamId:t})}async function _a(t,e,n){let r=await Qr(n);if(!r.canGenerate[t]){let o=r.remaining[t]??0,i=r.limits[t]??0;throw i===0?new D(`The "${t}" mode is not available on your ${r.planName} plan. Available modes: ${r.availableModes.join(", ")||"none"}`,403,2):new D(`You have reached your ${t} generation limit for this billing cycle (${r.usage[t]??0}/${i} used). Try a different mode: ${r.availableModes.join(", ")||"none available"}`,403,4)}if(r.maxSlidesPerPresentation!==-1&&e>r.maxSlidesPerPresentation)throw new D(`Maximum ${r.maxSlidesPerPresentation} slides allowed on your ${r.planName} plan (requested: ${e}). Try a different mode: ${r.availableModes.join(", ")||"none available"}`,403,6);return r}function cu(t){return t.replace(/[\u2014\u2013]/g,"-").replace(/[\u201C\u201D]/g,'"').replace(/[\u2018\u2019]/g,"'").replace(/\u2026/g,"...").replace(/\u00A0/g," ").replace(/[\u2010-\u2015]/g,"-").replace(/[\u2032\u2033]/g,"'")}async function La(t){let e={...t,text:cu(t.text)};await En("generateSpeech",e);let n=await m("generateSpeech",{approvalReceipt:"cli:tts-generate",...e}),r=await Ie("generateSpeech",n.runId),o=r.entity?.url;if(!o)throw new D(`Speech completed without an audio URL. Request ID: ${n.runId}.`,500);let i;try{i=await fetch(o)}catch(v){throw new D(`${v instanceof Error?v.message:"Failed to download speech audio"} Request ID: ${n.runId}.`,0,5,"download_failed",!0)}if(!i.ok)throw new D(`Failed to download speech audio. Request ID: ${n.runId}.`,i.status,5,"download_failed",i.status===429||i.status>=500);let s=r.output??{},c=t.options??{},p=ve(s.format)??du(o)??"mp3",f=Buffer.from(await i.arrayBuffer()),h=Ua(s.durationSec,s.duration,s.duration_s)??ca(f,p);if(h===void 0)throw new D(`Speech completed without a measurable duration. Request ID: ${n.runId}.`,500,1,"invalid_audio_metadata");return{audioData:f,audioUrl:o,duration:h,provider:ve(s.provider)??c.provider??"gemini",format:p,requestId:n.runId,voiceId:ve(s.voice_id)??ve(s.voiceId),voice:ve(s.voice),model:ve(s.model),speed:zr(s.speed)??c.speed,language:ve(s.lang)??ve(s.language)??c.language,langApplied:ya(s.langApplied)??ya(s.lang_applied),timestamps:lu(s.timestamps),wordTimings:mu(s.timestamps??s.timings)}}function Ua(...t){for(let e of t){let n=typeof e=="number"?e:typeof e=="string"&&e.trim()?Number(e):Number.NaN;if(Number.isFinite(n)&&n>0)return n}}function lu(t){if(!t||typeof t!="object"||Array.isArray(t))return;let e=t,n=e.characters,r=e.characterStartTimesSeconds??e.character_start_times_seconds,o=e.characterEndTimesSeconds??e.character_end_times_seconds;if(!(!Array.isArray(n)||!Array.isArray(r)||!Array.isArray(o))&&!(n.length===0||n.length!==r.length||n.length!==o.length||!n.every(i=>typeof i=="string")||!r.every(i=>typeof i=="number"&&Number.isFinite(i))||!o.every(i=>typeof i=="number"&&Number.isFinite(i))))return{characters:n,characterStartTimesSeconds:r,characterEndTimesSeconds:o}}function mu(t){if(!Array.isArray(t))return;let e=t.flatMap(n=>{if(!n||typeof n!="object"||Array.isArray(n))return[];let r=n,o=ve(r.text)??ve(r.word),i=zr(r.start),s=zr(r.end);return o&&i!==void 0&&s!==void 0&&s>=i?[{text:o,start:i,end:s}]:[]});return e.length>0?e:void 0}function ve(t){return typeof t=="string"&&t.trim()?t.trim():void 0}function zr(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function ya(t){return typeof t=="boolean"?t:void 0}async function ja(t){let e=t?`/api/cli/tts?provider=${t}`:"/api/cli/tts";return he(e)}async function qa(t){let e={...t},n=typeof e.idempotency_key=="string"?e.idempotency_key:void 0;return delete e.idempotency_key,await En("generateMusic",e),{requestId:(await m("generateMusic",{...e,approvalReceipt:"cli:music-generate"},n)).runId,status:"pending"}}async function Zr(t){let e=await I("generateMusic",t);return{requestId:t,status:$n(e),audioUrl:e.entity?.url,duration:Ua(e.output?.durationSec,e.output?.duration,e.output?.duration_s),error:e.error?.message}}async function Va(t){return{requestId:(await m("mixAudio",{...t,approvalReceipt:"cli:mix-create"})).runId,status:"pending"}}async function eo(t){let e=await I("mixAudio",t);return{requestId:t,status:$n(e),outputUrl:e.entity?.url,error:e.error?.message}}async function Ma(t){return he("/api/cli/images/search",{method:"POST",body:t})}async function Fa(t){return he("/api/cli/videos/search",{method:"POST",body:t})}async function ce(t,e=60,n=2e3){let r=0;for(let o=0;o<e;o++){let i;try{i=await t(),r=0}catch(s){if(s instanceof D&&s.retryable&&r<2){r+=1,await new Promise(c=>setTimeout(c,n));continue}throw s}if(i.status==="completed"||i.status==="failed")return i;await new Promise(s=>setTimeout(s,n))}throw new D("Operation timed out",408,1)}async function Ba(t,e,n){return m("getYoutubeTranscript",{...n?{language:n}:{},teamId:e,url:t})}async function Ga(t,e){let n=await m("scrape",{teamId:e,url:t});return{data:{content:n.content,metadata:{description:"",format:"markdown",tokenUsage:Math.ceil(n.content.length/4)},title:n.title??"",url:n.url},success:!0}}async function Wa(t){let e={...t},n=typeof e.idempotency_key=="string"?e.idempotency_key:void 0;delete e.idempotency_key,await En("generateSfx",e);let r=await m("generateSfx",{...e,approvalReceipt:"cli:sfx-generate"},n);return{id:r.runId,requestId:r.runId,status:"pending"}}async function to(t){let e=await I("generateSfx",t);return{id:e.entity?.id??t,requestId:t,status:$n(e),audioUrl:e.entity?.url,error:e.error?.message}}async function Ka(t){return m("listPresenterOptions",{...t?{voiceLanguage:t}:{}})}async function Ja(t){return{requestId:(await m("generateAvatarVideo",{...t,approvalReceipt:"cli:avatar-generate"})).runId,status:"pending"}}async function no(t){let e=await I("generateAvatarVideo",t);return{durationSec:typeof e.output?.durationSec=="number"?e.output.durationSec:null,error:e.error?.message,requestId:t,status:$n(e),videoUrl:e.entity?.url}}async function za(t){return m("lipsyncVideo",{...t,approvalReceipt:"cli:video-lipsync"})}async function Ha(){return(await m("listTranslationLanguages",{})).languages}async function Xa(t){return m("translateVideo",{...t,approvalReceipt:"cli:video-translate"})}async function Ya(t,e,n){return m("createVideo",{...t,approvalReceipt:e},n)}async function Qa(t){let{idempotencyKey:e,...n}=t;return m("analyzeVideoReference",n,e)}async function Za(t,e){return Ie("analyzeVideoReference",t,e)}async function es(t,e){return Ie("selectPresentationVideoStockMusic",t,e)}async function ts(t,e){return Ie("preparePresentationVideoPreviews",t,e,null)}async function ns(t,e){return Ie("generateBrandVariations",t,e)}async function rs(t,e){return Ie("extractBrandProducts",t,e)}async function os(t,e){return Ie("buildBrandVoice",t,e)}async function is(t,e){return Ie("generateBrandGuardrails",t,e)}async function as(t,e){return Ie("repairBrandQuality",t,e)}async function ss(t,e){return Ie("syncBrandToPresentations",t,e)}async function ds(t){return m("listCastPresets",t)}async function cs(t){return m("createCastPreset",t,st())}async function ls(t){return m("updateCastPreset",t,st())}async function ms(t){return m("deleteCastPreset",{presetId:t},st())}var us=[{billing:"free",category:"branding",description:"Attach a social handle to an accessible brand profile.",id:"addBrandSocialHandle",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding social add",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Add a competitor to an accessible brand profile.",id:"addCompetitor",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding competitor add",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"delegated",category:"media",description:"Transcribe an uploaded recording and publish the transcript for generation.",id:"analyzeMediaAsset",lifecycle:{mode:"background",status:{cliCommand:"media analyze status",pollAfterSeconds:10}},milestone:"M8",name:"media analyze",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Analyze an uploaded video before using it as a source, motion, blocking, or pacing reference in a video storyboard. The completed status output includes the analysisId required by the storyboard's source-video binding.",id:"analyzeVideoReference",lifecycle:{mode:"background",status:{cliCommand:"video reference status",pollAfterSeconds:10}},milestone:"M8",name:"video reference analyze",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Branch an immutable footage version into a new project.",id:"branchFootageProjectVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage branch",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"artifacts",description:"Generate and persist an ad variation set.",id:"createAdSet",lifecycle:{mode:"background",status:{cliCommand:"ad-set status",pollAfterSeconds:10}},milestone:"M6",name:"ad-set create",operation:"generation",scopes:["ad-sets:write"],state:"available"},{billing:"free",category:"agents",description:"Create a scheduled agent from a validated configuration.",id:"createAgent",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent create",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"media",description:"Save one way a cast member appears: a personal presenter (pp_* id), a backdrop, and optionally a voice, under a name unique to that person.",id:"createCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Save a markdown, CSV or plain-text document into the Library.",id:"createDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document create",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"media",description:"Create a transcript-native, versioned footage edit project.",id:"createFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"fixed",category:"media",description:"Generate and persist an image.",id:"createImage",lifecycle:{mode:"background",status:{cliCommand:"image status",pollAfterSeconds:10}},milestone:"M5",name:"image generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Create a Library folder, optionally inside another.",id:"createLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders create",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"dynamic",category:"artifacts",description:"Generate and persist a microsite.",id:"createMicrosite",lifecycle:{mode:"background",status:{cliCommand:"microsite status",pollAfterSeconds:10}},milestone:"M6",name:"microsite create",operation:"generation",scopes:["microsites:write"],state:"available"},{billing:"free",category:"artifacts",description:"Create a standalone poll.",id:"createPoll",lifecycle:{mode:"bounded"},milestone:"M3",name:"poll create",operation:"mutation",scopes:["polls:write"],state:"available"},{billing:"delegated",category:"presentations",description:"Create an MP4 video from a finished presentation, or render an existing presentation-video project.",id:"createPresentationVideo",lifecycle:{mode:"background",status:{cliCommand:"presentation video status",pollAfterSeconds:10}},milestone:"M4",name:"presentation video",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"fixed",category:"presentations",description:"Generate a presentation and persist the resulting deck.",id:"createSlides",lifecycle:{mode:"background",status:{cliCommand:"presentation status",pollAfterSeconds:20}},milestone:"M4",name:"create",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate one video from the opaque text and explicit metadata stored in a pinned storyboard revision.",id:"createVideo",lifecycle:{mode:"background",status:{cliCommand:"video status",pollAfterSeconds:20}},milestone:"M8",name:"video create",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Create a versioned Markdown video storyboard.",id:"createVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"fixed",category:"artifacts",description:"Generate a persisted standalone visual abstract.",id:"createVisualAbstract",lifecycle:{mode:"background",status:{cliCommand:"visual-abstract status",pollAfterSeconds:10}},milestone:"M5",name:"visual-abstract create",operation:"generation",scopes:["visual-abstracts:write"],state:"available"},{billing:"free",category:"media",description:"Retire a saved cast preset. Existing videos keep working; the preset stops being offered.",id:"deleteCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset delete",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Remove a document from the Library.",id:"deleteDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document delete",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"knowledge",description:"Delete a Library folder and its subfolders. Items inside are unfiled, never deleted.",id:"deleteLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders delete",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"presentations",description:"Permanently delete an owned presentation, all of its versions, and its publications.",id:"deletePresentation",lifecycle:{mode:"bounded"},milestone:"M8",name:"presentation delete",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"artifacts",description:"Edit a standalone poll.",id:"editPoll",lifecycle:{mode:"bounded"},milestone:"M3",name:"poll edit",operation:"mutation",scopes:["polls:write"],state:"available"},{billing:"free",category:"presentations",description:"Apply one atomic edit to a presentation-video draft.",id:"editPresentationVideoDraft",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video edit",operation:"mutation",scopes:["presentations:write","media:read"],state:"available"},{billing:"dynamic",category:"presentations",description:"Generate the narration a presentation-video project is still missing.",id:"ensurePresentationVideoNarration",lifecycle:{mode:"background",status:{cliCommand:"presentation video narrate status",pollAfterSeconds:5}},milestone:"M4",name:"presentation video narrate",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Render an owned presentation to HTML/PDF/PPTX and return a short-lived signed download URL.",id:"exportPresentation",lifecycle:{mode:"bounded"},milestone:"M1",name:"export",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"quota",category:"branding",description:"Extract and persist a reusable brand profile from a URL.",id:"extractBranding",lifecycle:{mode:"background",status:{cliCommand:"branding status",pollAfterSeconds:10}},milestone:"M2",name:"branding extract",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"dynamic",category:"research",description:"Extract normalized text from uploaded or remote content.",id:"extractContent",lifecycle:{mode:"bounded"},milestone:"M1",name:"content extract",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"knowledge",description:"File an artifact into a Library folder, or unfile it.",id:"fileArtifactIntoFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library file",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"agents",description:"Erase every stored version of a scheduled agent's memory. Irreversible.",id:"forgetAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory forget",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate one reusable avatar/presenter clip for composition into a video. Accepts a stock avatar id or a personal presenter's pp_* id (from listPresenterOptions' `personal` group) as avatarId.",id:"generateAvatarVideo",lifecycle:{mode:"background",status:{cliCommand:"avatar status",pollAfterSeconds:10}},milestone:"M8",name:"avatar generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate music from final video facts or a trusted direct prompt.",id:"generateMusic",lifecycle:{mode:"background",status:{cliCommand:"music status",pollAfterSeconds:10}},milestone:"M7",name:"music generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate an additional look for an existing personal presenter while preserving the same Cast identity.",id:"generatePresenterLook",lifecycle:{mode:"background",status:{cliCommand:"avatar look status",pollAfterSeconds:10}},milestone:"M8",name:"avatar look generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate SFX from final video facts or a trusted direct prompt.",id:"generateSfx",lifecycle:{mode:"background",status:{cliCommand:"sfx status",pollAfterSeconds:10}},milestone:"M7",name:"sfx generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"presentations",description:"Generate persisted speaker notes for a presentation version.",id:"generateSpeakerNotes",lifecycle:{mode:"background",status:{cliCommand:"presentation speaker-notes-status",pollAfterSeconds:5}},milestone:"M4",name:"presentation speaker-notes",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate speech audio from text.",id:"generateSpeech",lifecycle:{mode:"background",status:{cliCommand:"tts status",pollAfterSeconds:10}},milestone:"M7",name:"tts generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"Read what a scheduled agent has recorded about its own work: learned facts, standing instructions, things it never does, entities it tracks, and freeform notes.",id:"getAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory show",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"branding",description:"List competitors saved for an accessible brand profile.",id:"getBrandCompetitors",lifecycle:{mode:"bounded"},milestone:"M1",name:"branding competitor list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read a brand's design tokens, the keys it is missing, or its design.md document.",id:"getBrandProfile",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding profile",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"media",description:"Read an owned footage project and its append-only versions.",id:"getFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage show",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"knowledge",description:"Read a bounded workspace Knowledge Hub bundle.",id:"getKnowledgeBundle",lifecycle:{mode:"bounded"},milestone:"M1",name:"knowledge bundle",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search recent news sources.",id:"getNews",lifecycle:{mode:"bounded"},milestone:"M1",name:"search news",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"presentations",description:"Read a presentation and its slides.",id:"getPresentation",lifecycle:{mode:"bounded"},milestone:"M1",name:"get",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read an owned presentation-video project and its ordered scene timeline.",id:"getPresentationVideoProject",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video inspect",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"dynamic",category:"research",description:"Fetch a YouTube video's timestamped transcript with its title, channel, and duration.",id:"getYoutubeTranscript",lifecycle:{mode:"bounded"},milestone:"M1",name:"transcript",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"media",description:"Import a recording from a connected account into the media library.",id:"importConnectorRecording",lifecycle:{mode:"background",status:{cliCommand:"media import status",pollAfterSeconds:5}},milestone:"M8",name:"media import",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Import every completed provider-assisted take, preserving explicit source traceability when proven.",id:"importFootageProviderTakes",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage import-takes",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"presentations",description:"Import an attached PowerPoint as an auditable, review-gated Mindframes presentation.",id:"importPowerPoint",lifecycle:{mode:"background",status:{cliCommand:"presentation import status",pollAfterSeconds:5}},milestone:"M4",name:"presentation import",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"media",description:"Create proxy, filmstrip, and waveform evidence for one footage range.",id:"inspectFootageRange",lifecycle:{mode:"background",status:{cliCommand:"footage inspection-status",pollAfterSeconds:2}},milestone:"M8",name:"footage inspect",operation:"generation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Re-voice a ready video with new audio via provider lip-sync (one sibling re-voiced video artifact).",id:"lipsyncVideo",lifecycle:{mode:"background",status:{cliCommand:"video lipsync status",pollAfterSeconds:20}},milestone:"M8",name:"video lipsync",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"List the user's secret-free Claude Code or Codex connection profiles and current selection.",id:"listAiConnectionProfiles",lifecycle:{mode:"bounded"},milestone:"M8",name:"ai-connections list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"media",description:"List saved ways a cast member appears \u2014 a trained presenter, a backdrop, and optionally a voice, under one name. Filtered to what the caller may actually use.",id:"listCastPresets",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset list",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"knowledge",description:"List the workspace's documents, newest first.",id:"listDocuments",lifecycle:{mode:"bounded"},milestone:"M8",name:"document list",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"List a document's append-only version history.",id:"listDocumentVersions",lifecycle:{mode:"bounded"},milestone:"M8",name:"document versions",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"List the workspace Library folder tree.",id:"listLibraryFolders",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders list",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"presentations",description:"List saved presentation-video draft versions.",id:"listPresentationVideoVersions",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video versions",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"media",description:"List provider-neutral presenter avatars, voices, and voice languages, plus the workspace's trained personal presenters (`personal` roster group, pp_* ids).",id:"listPresenterOptions",lifecycle:{mode:"bounded"},milestone:"M8",name:"avatar options",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"media",description:"List ready generated clips and uploaded MediaAssets while excluding final presentation-to-MP4 renders.",id:"listReusableVideoClips",lifecycle:{mode:"bounded"},milestone:"M8",name:"video library list",operation:"query",scopes:["media:read","presentations:read"],state:"available"},{billing:"free",category:"media",description:"List provider-neutral target languages for video translation.",id:"listTranslationLanguages",lifecycle:{mode:"bounded"},milestone:"M8",name:"video translate-languages",operation:"query",scopes:["media:read"],state:"available"},{billing:"dynamic",category:"media",description:"Mix voice, music, and sound-effect tracks.",id:"mixAudio",lifecycle:{mode:"background",status:{cliCommand:"mix status",pollAfterSeconds:10}},milestone:"M7",name:"mix create",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Move a Library folder under a new parent, or to the top level.",id:"moveLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders move",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"presentations",description:"Create or reuse a presentation-video project for a finished presentation.",id:"preparePresentationVideo",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video prepare",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"knowledge",description:"Read one document's full body and metadata.",id:"readDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document read",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"media",description:"Read a video storyboard and its immutable revision history.",id:"readVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard show",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"knowledge",description:"Set or clear the colour of a Library folder.",id:"recolorLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders recolor",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"agents",description:"Create a reviewable scheduled-agent recommendation.",id:"recommendAgent",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent recommend",operation:"generation",scopes:["agents:write"],state:"available"},{billing:"free",category:"presentations",description:"Refresh deck-backed video scenes from the latest presentation version.",id:"refreshPresentationVideoSlides",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video refresh",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"dynamic",category:"presentations",description:"Regenerate one narration override in a presentation video draft.",id:"regeneratePresentationVideoNarration",lifecycle:{mode:"background",status:{cliCommand:"presentation video-narration-status",pollAfterSeconds:5}},milestone:"M4",name:"presentation video-narration",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"knowledge",description:"Rename a Library folder.",id:"renameLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders rename",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"delegated",category:"media",description:"Render selected outputs from one exact, strategy-approved footage draft version.",id:"renderFootageProject",lifecycle:{mode:"background",status:{cliCommand:"footage render-status",pollAfterSeconds:5}},milestone:"M8",name:"footage render",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Restore an earlier version by appending it as the current one.",id:"restoreDocumentVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"document restore",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"media",description:"Restore an immutable footage version as a new project head.",id:"restoreFootageProjectVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage restore",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"presentations",description:"Restore a saved presentation-video draft version as a new version.",id:"restorePresentationVideoVersion",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video restore",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"media",description:"Append a semantic revision to a footage edit project.",id:"reviseFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage revise",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Create a new presenter Look by editing an existing Look without changing its source.",id:"revisePresenterLook",lifecycle:{mode:"background",status:{cliCommand:"avatar look revision-status",pollAfterSeconds:10}},milestone:"M8",name:"avatar look revise",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Create a new immutable revision of a Markdown video storyboard.",id:"reviseVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard revise",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"research",description:"Read and normalize content from a public URL.",id:"scrape",lifecycle:{mode:"bounded"},milestone:"M1",name:"scrape",operation:"query",scopes:["research:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search licensed image providers.",id:"searchImages",lifecycle:{mode:"bounded"},milestone:"M1",name:"search images",operation:"query",scopes:["research:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search the public web for current sources.",id:"searchInternet",lifecycle:{mode:"bounded"},milestone:"M1",name:"search web",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"knowledge",description:"Search workspace Knowledge Hub entries.",id:"searchKnowledge",lifecycle:{mode:"bounded"},milestone:"M1",name:"knowledge search",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"dynamic",category:"media",description:"Find videos: licensed stock clips to download, or web videos to embed.",id:"searchStockVideo",lifecycle:{mode:"bounded"},milestone:"M1",name:"search video",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"agents",description:"Select a Claude Code or Codex connection profile, or restore the native provider route.",id:"selectAiConnectionProfile",lifecycle:{mode:"bounded"},milestone:"M8",name:"ai-connections select",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"branding",description:"Point a brand at an already-uploaded logo, dark-background logo variant, or favicon.",id:"setBrandLogo",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding logo set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"presentations",description:"Set one presentation-video scene to a specific avatar/look or saved preset, including the preset voice by default, or restore inheritance from the project default.",id:"setPresentationVideoScenePresenter",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video presenter",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Transform an uploaded PowerPoint source into an auditable presentation review.",id:"transformPresentationImport",lifecycle:{mode:"background",status:{cliCommand:"presentation import status",pollAfterSeconds:5}},milestone:"M4",name:"presentation import transform",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Translate a ready video into sibling language versions (one video per target language).",id:"translateVideo",lifecycle:{mode:"background",status:{cliCommand:"video translate status",pollAfterSeconds:20}},milestone:"M8",name:"video translate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"Add to or remove from what a scheduled agent remembers. Owner or workspace admin only.",id:"updateAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory set",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"branding",description:"Write a brand's design tokens from a key patch or a whole design.md document.",id:"updateBrandTokens",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Change a saved cast preset's name, presenter, backdrop, or voice. Sends the complete preset, not a patch.",id:"updateCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset update",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Edit a document's body, title or summary under an optimistic lock.",id:"updateDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document update",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"presentations",description:"Update avatar, voice, music, captions, format, and renderer settings for a presentation-video project.",id:"updatePresentationVideoSettings",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video settings",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"agents",description:"Read one safe Agent roster card without private configuration.",id:"getRosterAgent",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent roster get",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"Read one owned Agent and its complete configuration.",id:"getAgent",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent get",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"List the caller's roster: owned Agents plus same-workspace Agents shared with the team.",id:"listAgentRoster",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent roster list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"List the caller's scheduled Agents with stable cursor pagination.",id:"listAgents",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"Pause an owned Agent's schedule without changing its configuration.",id:"pauseAgentSchedule",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent pause",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"agents",description:"Resume an owned Agent's saved schedule without changing its configuration.",id:"resumeAgentSchedule",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent resume",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"agents",description:"Share an owned Agent with the workspace or return it to private visibility.",id:"setAgentVisibility",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent visibility set",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"agents",description:"Update an owned Agent's schedule, sources, outputs, delivery, review, runtime, or blueprint configuration.",id:"updateAgentConfiguration",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent configure",operation:"mutation",scopes:["agents:write"],state:"available"}];function Pn(t){return{capabilities:us,catalogVersion:1,reason:t,source:"snapshot"}}async function Wt(t=va){try{let{capabilities:e,catalogVersion:n}=await t();return!Array.isArray(e)||e.length===0?Pn("the live catalog returned no capabilities"):{capabilities:e,catalogVersion:n,source:"live"}}catch(e){let n=e instanceof Error?e.message:String(e);return Pn(n)}}import{InvalidArgumentError as pu}from"commander";function b(t,e){return n=>{if(e.includes(n))return n;throw new pu(`Expected one of: ${e.join(", ")}. Run the command with --help to see what ${t} accepts.`)}}var ps=["presentations","media","branding","knowledge","research","artifacts","agents","support"],fu=80,hu=30;function yu(t){return t.billing!==void 0&&t.billing!=="free"&&t.billing!=="quota"}function bu(t){return t.lifecycle?.mode==="background"}function wu(t,e){if(e<=0)return[t];let n=[],r="";for(let o of t.split(/\s+/).filter(Boolean))r===""?r=o:r.length+1+o.length<=e?r=`${r} ${o}`:(n.push(r),r=o);return r!==""&&n.push(r),n.length>0?n:[""]}function gs(t){let e=ps.indexOf(t);return e===-1?ps.length:e}function vu(t,e){let n=e.search?.trim().toLowerCase(),r=e.category?.trim().toLowerCase();return t.filter(o=>r&&(o.category??"").toLowerCase()!==r?!1:n?`${o.name} ${o.description??""}`.toLowerCase().includes(n):!0)}function Iu(t){let e=new Map;for(let i of t){let s=i.category??"other",c=e.get(s);c?c.push(i):e.set(s,[i])}let n=[...e.entries()].sort(([i],[s])=>{let c=gs(i)-gs(s);return c!==0?c:i.localeCompare(s)}),r=Math.min(hu,Math.max(...t.map(i=>i.name.length))),o=[];for(let[i,s]of n){s.sort((c,p)=>c.name.localeCompare(p.name)),o.length>0&&o.push(""),o.push(Kt.bold(`${i} (${s.length})`));for(let c of s){let p=`${yu(c)?"$":" "}${bu(c)?"*":" "}`,f=c.name.padEnd(r),h=2+r+1+p.length+1,v=Math.max(24,fu-h),x=wu(c.description??"",v);o.push(` ${Kt.cyan(f)} ${Kt.yellow(p)} ${x[0]??""}`.trimEnd());for(let $ of x.slice(1))o.push(`${" ".repeat(h)}${$}`)}}return o}function xu(t){return t.map(e=>`${e.name} ${e.state} ${e.milestone}`)}function ku(t,e={filtered:!1}){if(t.length===0)return[e.filtered?"No capabilities match that filter.":"No capabilities available."];if(!t.some(i=>i.description||i.category))return xu(t);let r=u.commands[0],o=Iu(t);return o.push(""),o.push(Kt.dim(`${t.length} capabilities \xB7 $ = paid \xB7 * = background (returns a run id)`)),o.push(Kt.dim(`Filter with: ${r} capabilities --search <query>`)),o}var fs=new gu("capabilities").description("Index of everything this CLI can do \u2014 every command, grouped and described").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").option("-s, --search <query>","Only show capabilities matching a query").option("--category <name>","Only show one category").action(async t=>{try{let e=await Wt(),n=vu(e.capabilities,t),r=!!(t.search||t.category);if(t.format==="json"){l({capabilities:n,catalogVersion:e.catalogVersion,source:e.source,...e.reason?{sourceReason:e.reason}:{}});return}if(t.format==="quiet"){for(let o of n)console.log(o.name);return}e.source==="snapshot"&&_(`Showing the capability list baked into this CLI build (${e.reason}); the deployed catalog may have moved on.`);for(let o of ku(n,{filtered:r}))console.log(o)}catch(e){a(e instanceof Error?e.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});import{mkdirSync as Eu,writeFileSync as $u}from"fs";import{dirname as ws,join as Tu}from"path";import{Command as De}from"commander";import Jt from"chalk";import{input as Au,password as Pu,confirm as vs,select as Ou}from"@inquirer/prompts";import Dn from"ora";import Ru from"conf";var On=new Ru({projectName:"conceptcraft",configName:"feature-cache"}),Cu=3600*1e3,Su=1440*60*1e3;function hs(t){let e=0;for(let n=0;n<t.length;n++){let r=t.charCodeAt(n);e=(e<<5)-e+r,e=e&e}return e.toString(16)}function ys(){if(!it())return null;let t=On.get("featureFlags");if(!t)return null;let e=hs(Se());if(t.apiKeyHash&&t.apiKeyHash!==e)return ze(),null;let n=Date.now()-t.fetchedAt;return n>Su?null:(n>Cu&&ro(),t.flags)}function ro(){Je().catch(()=>{})}async function Je(){let t=await Da(),e=Se();return On.set("featureFlags",{flags:t,fetchedAt:Date.now(),apiKeyHash:e?hs(e):void 0}),t}function ze(){On.delete("featureFlags")}function bs(){return On.path}var Is=new De("config").description("Manage CLI configuration: account settings, and the cached feature flags that decide which commands appear").addCommand(new De("init").description("Initialize configuration interactively").action(async()=>{console.log(),console.log(Jt.bold(`${u.displayName} CLI Configuration`)),console.log(Jt.gray("\u2500".repeat(35))),console.log();try{let t=await Pu({message:"Enter your API key:",mask:"*",validate:r=>!r||r.trim().length===0?"API key is required":Gr(r.trim())?!0:"Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"});if(qr(t.trim()),await vs({message:`Use a custom API URL? (default: ${u.apiUrl.replace("https://","")})`,default:!1})){let r=await Au({message:"Enter API URL:",default:W(),validate:o=>{try{return new URL(o),!0}catch{return"Invalid URL format"}}});Vr(r)}console.log();let n=Dn("Verifying API key...").start();try{let r=await xe();if(n.succeed("API key verified!"),console.log(),w(`Logged in as: ${r.user.email}`),r.teams.length===0)_("No teams found for this user.");else if(r.teams.length===1){let o=r.teams[0];ot(o.id),w(`Team: ${o.name} (${o.planName})`)}else{console.log(),w(`You have access to ${r.teams.length} teams.`);let o=await Ou({message:"Select your default team:",choices:r.teams.map(s=>({name:`${s.name} (${s.planName}) - ${s.role}${s.isCurrent?" [current]":""}`,value:s.id})),default:r.currentTeam?.id});ot(o);let i=r.teams.find(s=>s.id===o);k(`Selected team: ${i?.name}`)}try{await Je()}catch{}}catch(r){n.fail("Failed to verify API key"),_(`Could not verify API key: ${r instanceof Error?r.message:String(r)}`),_(`You may need to set the team ID manually: ${u.commands[0]} config set team-id <id>`)}console.log(),k("Configuration saved!"),w(`Config file: ${Ft()}`),console.log()}catch(t){if(t.name==="ExitPromptError"){console.log(),w("Configuration cancelled.");return}throw t}})).addCommand(new De("show").description("Show current configuration").option("--verify","Verify API key and show team details").action(async t=>{let e=Qi();if(ge("Current Configuration"),console.log(),C("API Key",ma()??Jt.red("Not set")),C("API URL",e.apiUrl),C("Default Team ID",e.defaultTeamId??Jt.gray("Not set")),console.log(),C("Config file",Ft()),t.verify&&e.apiKey){console.log();let n=Dn("Verifying...").start();try{let r=await xe();n.succeed("Verified"),console.log(),C("User",r.user.email),r.currentTeam&&C("Current Team",`${r.currentTeam.name} (${r.currentTeam.planName})`),r.teams.length>1&&C("Total Teams",String(r.teams.length))}catch(r){n.fail("Verification failed"),_(r instanceof Error?r.message:String(r))}}console.log()})).addCommand(new De("set").description("Set a configuration value").argument("<key>","Configuration key (api-key, api-url, team-id)").argument("<value>","Value to set").action(async(t,e)=>{switch(t){case"api-key":Gr(e)||(a("Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"),process.exit(6)),qr(e),ze(),k("API key updated"),Je().catch(()=>{});break;case"api-url":try{new URL(e),Vr(e),k(`API URL set to: ${e}`)}catch{a("Invalid URL format"),process.exit(6)}break;case"team-id":ot(e),k(`Default team ID set to: ${e}`);break;default:a(`Unknown config key: ${t}`),console.log(Jt.gray("Valid keys: api-key, api-url, team-id")),process.exit(6)}})).addCommand(new De("clear").description("Clear all configuration").action(async()=>{try{await vs({message:"Are you sure you want to clear all configuration?",default:!1})?(kn(),ze(),k("Configuration cleared")):w("Cancelled")}catch{w("Cancelled")}})).addCommand(new De("refresh").description("Refresh cached feature flags").action(async()=>{let t=Dn("Refreshing feature flags...").start();try{await Je(),t.succeed("Feature flags refreshed"),w(`Run '${u.commands[0]} --help' to see updated commands`)}catch(e){t.fail("Failed to refresh"),a(e instanceof Error?e.message:String(e)),process.exit(1)}})).addCommand(new De("path").description("Show configuration file path").option("--cache","Show feature cache file path").action(t=>{t.cache?console.log(bs()):console.log(Ft())})).addCommand(new De("pull").description("Pull your account settings (memory, brand, prefs) into a local config.toml").action(async()=>{let t=Dn("Pulling settings...").start();try{let e=await $e(),n=await fetch(`${W()}/api/cli/settings`,{headers:e});if(!n.ok)throw new Error(`Request failed (HTTP ${n.status})`);let r=await n.text(),o=Tu(ws(Ft()),"settings.toml");Eu(ws(o),{recursive:!0}),$u(o,r,"utf8"),t.succeed("Settings pulled"),w(`Written to ${o}`)}catch(e){t.fail("Failed to pull settings"),a(e instanceof Error?e.message:String(e)),process.exit(1)}}));import{Command as Nu}from"commander";import{confirm as _u}from"@inquirer/prompts";import{createHash as Du}from"crypto";function z(t){let e=Du("sha256").update(JSON.stringify({command:t.command,payload:oo(t.payload),workspaceId:t.workspaceId})).digest("hex");return`cli:${t.command.trim().toLowerCase().replace(/[^a-z0-9._:-]+/g,"-").replace(/^-+|-+$/g,"")||"command"}:${e}`}function oo(t){return Array.isArray(t)?t.map(oo):!t||typeof t!="object"?t:Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0).sort(([e],[n])=>e.localeCompare(n)).map(([e,n])=>[e,oo(n)]))}var xs=new Nu("delete").description("Delete a presentation").argument("<slug>","Presentation slug (e.g., my-presentation-v1-abc123)").option("-y, --yes","Confirm permanent deletion without prompting").option("-f, --force","Deprecated alias for --yes").option("--team-id <id>","Workspace ID (uses configured default)").option("--idempotency-key <key>","Stable key to safely retry this deletion").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("-q, --quiet","Suppress output").action(async(t,e)=>{if(await y(),!e.yes&&!e.force)try{if(!await _u({message:`Are you sure you want to delete presentation "${t}"?`,default:!1})){e.quiet||_("Deletion cancelled");return}}catch{e.quiet||_("Deletion cancelled");return}let n=e.teamId??ee(),r=e.idempotencyKey??z({command:"presentation:delete",payload:{slug:t},workspaceId:n??"configured-default"});try{await Sa(t,{approvalReceipt:e.approvalReceipt,idempotencyKey:r,teamId:n}),e.quiet||k(`Presentation "${t}" deleted`)}catch(o){o.errorCode==="approval_required"&&_(`Retry with --idempotency-key ${r}`),a(o instanceof Error?o.message:String(o)),process.exit(o.exitCode??1)}});import{Command as ct}from"commander";import Rs from"chalk";import Lu from"ora";import{createParser as AR}from"eventsource-parser";import OR from"chalk";import NR from"ora";async function ks(t,e={}){let n=t.body?.getReader();if(!n)throw new Error("Response body is not readable");let r=new TextDecoder,o="",i=!1;for(;!i;){let s=await n.read();if(i=s.done,s.value){let c=r.decode(s.value,{stream:!0});o+=c,e.quiet||process.stdout.write(c)}}return e.quiet||console.log(),o}function Uu(){return new ct("blog").description("Generate a blog post from a presentation").argument("<slug>","Presentation slug").option("--words <count>","Target word count (50-2000)","300").option("--tone <tone>","Writing tone (professional, casual, educational)","professional").option("--audience <text>","Target audience description").option("-f, --format <format>","Output format (human, json, markdown)",b("--format",["human","json","markdown"]),"human").option("--instructions <text>","Custom instructions for the blog").option("--no-images","Exclude image references").option("--toc","Include table of contents").action(async(t,e)=>{await y();let n=parseInt(e.words,10);(Number.isNaN(n)||n<50||n>2e3)&&(a("Word count must be between 50 and 2000"),process.exit(6));let r=["professional","casual","educational"];r.includes(e.tone)||(a(`Invalid tone. Valid options: ${r.join(", ")}`),process.exit(6));let o=Lu("Fetching presentation...").start();try{let i=await dt(t);o.text="Generating blog post...";let s=await Na(i.id,i.documentCreatedAt||i.createdAt,{targetWordCount:n,tone:e.tone,targetAudience:e.audience??"General Audience",customInstructions:e.instructions??"",includeImages:!e.noImages,includeTableOfContents:e.toc??!1}),c=await ks(s,{quiet:!0});o.succeed("Blog generated"),e.format==="json"?console.log(JSON.stringify({presentationId:t,title:i.title,wordCount:n,tone:e.tone,content:c},null,2)):e.format==="markdown"?console.log(c):(console.log(),console.log(Rs.bold(`Blog: ${i.title}`)),console.log(Rs.gray("\u2500".repeat(40))),console.log(),console.log(c),console.log())}catch(i){o.fail("Generation failed"),a(i instanceof Error?i.message:String(i)),process.exit(i.exitCode??1)}})}function ju(){return new ct("tweets").description("Generate tweets from a presentation").argument("<slug>","Presentation slug").option("--count <n>","Number of tweets to generate","5").option("-f, --format <format>","Output format (human, json)",b("--format",["human","json"]),"human").action(async(t,e)=>{await y(),w("Tweet generation coming soon.")})}function qu(){return new ct("linkedin").description("Generate a LinkedIn carousel from a presentation").argument("<slug>","Presentation slug").option("-f, --format <format>","Output format (human, json)",b("--format",["human","json"]),"human").action(async t=>{await y(),w("LinkedIn carousel generation coming soon.")})}function Vu(){return new ct("questions").description("Generate questions for a presentation").argument("<slug>","Presentation slug").option("--count <n>","Number of questions","10").option("-f, --format <format>","Output format (human, json)",b("--format",["human","json"]),"human").action(async(t,e)=>{await y(),w("Question generation coming soon.")})}function Mu(){return new ct("cheatsheet").description("Generate a presenter cheat sheet").argument("<slug>","Presentation slug").option("--mode <mode>","Cheat sheet mode (qa-prep, talking-points)","qa-prep").option("-f, --format <format>","Output format (human, json, markdown)",b("--format",["human","json","markdown"]),"human").action(async(t,e)=>{await y(),w("Cheat sheet generation coming soon.")})}function Cs(){let t=new ct("derive").description("Generate derivative content from a presentation"),e=ys();return e&&(e.deckToBlog&&t.addCommand(Uu()),e.deckToTweets&&t.addCommand(ju()),e.linkedInCarousel&&t.addCommand(qu()),e.redTeamQuestions&&t.addCommand(Vu()),e.presenterCheatSheet&&t.addCommand(Mu())),t}import{Command as Fu}from"commander";import io from"chalk";var Ss=new Fu("ideas").description("Generate presentation topic ideas").option("--context <text>","Custom context for idea generation").option("--count <n>","Number of ideas to generate","5").option("-f, --format <format>","Output format (human, json)",b("--format",["human","json"]),"human").action(async t=>{await y(),w("Idea generation is available in the web dashboard."),console.log(),console.log(io.gray("The CLI will support idea generation in a future release.")),console.log(),console.log("For now, try these approaches:"),console.log(io.gray("` 1. Visit the ${brand.displayName} dashboard and use the idea generator`")),console.log(io.gray(" 2. Create a presentation with a broad topic and refine it")),console.log()});import{Command as Bu}from"commander";import{readFile as Gu}from"fs/promises";import{resolve as Wu,basename as Ku}from"path";import Ju from"ora";var Es=new Bu("import").description("Import a presentation from ZIP (admin only)").argument("<file>","Path to ZIP file");Es._hidden=!0;var $s=Es.option("--dry-run","Validate without importing").option("--overwrite","Overwrite existing presentations").option("--remap-ids","Generate new IDs (default: true)",!0).action(async(t,e)=>{await y();try{(await xe()).user.role!=="admin"&&(a("This command is only available to administrators"),process.exit(2))}catch{a("Failed to verify permissions"),process.exit(2)}let n=Wu(t),r=Ku(n);r.endsWith(".zip")||(a("File must be a ZIP archive"),process.exit(6));let o=Ju("Reading file...").start();try{let i=await Gu(n);e.dryRun?o.text="Validating...":o.text="Importing presentation...";let s=await Aa(i,r,{dryRun:e.dryRun});if(s.success){if(e.dryRun)o.succeed("Validation passed!"),console.log(),w("The file is valid and can be imported."),s.statistics&&(console.log(),C("Slides",String(s.statistics.slidesImported)),C("Images",String(s.statistics.imagesUploaded)));else if(o.succeed("Import complete!"),console.log(),C("Presentation ID",s.presentationId??"N/A"),C("Document ID",s.documentId??"N/A"),s.statistics&&(C("Slides imported",String(s.statistics.slidesImported)),C("Images uploaded",String(s.statistics.imagesUploaded)),C("Time",`${s.statistics.totalTimeMs}ms`)),s.presentationId){let c=W();C("View URL",`${c}/p/${s.presentationId}`)}if(s.warnings&&s.warnings.length>0){console.log();for(let c of s.warnings)_(c)}console.log()}else{if(o.fail("Import failed"),console.log(),s.errors)for(let c of s.errors)a(`${c.type}: ${c.message}`);process.exit(1)}}catch(i){o.fail("Import failed"),i.code==="ENOENT"&&(a(`File not found: ${n}`),process.exit(3)),a(i instanceof Error?i.message:String(i)),process.exit(i.exitCode??1)}});import{Command as zu}from"commander";var Nn=new zu("list").description("List presentations").option("-n, --limit <count>","Number of results to return","20").option("--offset <count>","Zero-based result offset","0").option("--sort <field>","Sort by field (updated, created, title)",b("--sort",["updated","created","title"]),"updated").option("--team-id <id>","Team ID (uses default if not specified)").option("--json","Output machine-readable JSON").action(async t=>{await y();let e=parseInt(t.limit,10);(Number.isNaN(e)||e<1||e>50)&&(a("Invalid limit value (expected 1-50)"),process.exit(6));let n=parseInt(t.offset,10);(Number.isNaN(n)||n<0||n>1e4)&&(a("Invalid offset value (expected 0-10000)"),process.exit(6));let r=t.teamId??ee();r||(a("Team ID required. Set a default with 'mf config set team-id <id>' or use --team-id"),process.exit(6));try{let o=await Ra(r,e,n,t.sort);if(o.length===0){t.json?console.log(JSON.stringify([])):w("No presentations found");return}console.log(t.json?JSON.stringify(o,null,2):aa(o))}catch(o){a(o instanceof Error?o.message:String(o));let i=typeof o=="object"&&o!==null&&"exitCode"in o&&typeof o.exitCode=="number"?o.exitCode:1;process.exit(i)}});import{createHash as Hu,randomBytes as Ps}from"crypto";import Os from"http";import Ts from"chalk";import{Command as Xu}from"commander";import Yu from"open";import As from"ora";var Qu=`${u.displayName} CLI`,Zu=8765,ep=8775,tp=["presentations:read","presentations:write","brands:read","brands:write","media:read","media:write"];function np(){return Ps(32).toString("base64url")}function rp(t){return Hu("sha256").update(t).digest("base64url")}function op(){return Ps(16).toString("hex")}async function ip(t,e){for(let n=t;n<=e;n++)try{return await new Promise((r,o)=>{let i=Os.createServer();i.listen(n,()=>{i.close(()=>r())}),i.on("error",o)}),n}catch{}throw new Error(`No available port found between ${t} and ${e}`)}async function ap(t){let e=await fetch(`${t}/.well-known/oauth-authorization-server`);if(!e.ok)throw new Error(`Failed to fetch OAuth metadata: ${e.status}`);return e.json()}function sp(t){let e=t.scopes_supported?.filter(n=>typeof n=="string"&&n.trim().length>0);return(e?.length?e:tp).join(" ")}function dp(t,e){if(!e?.trim())return sp(t);let n=e.split(",").map(o=>o.trim()).filter(Boolean);if(n.length===0)throw new Error("--scopes must include at least one OAuth scope");let r=t.scopes_supported?.filter(o=>typeof o=="string"&&o.trim().length>0);if(r?.length){let o=n.filter(i=>!r.includes(i));if(o.length>0)throw new Error(`Unsupported OAuth scope${o.length===1?"":"s"}: ${o.join(", ")}`)}return n.join(" ")}async function cp(t,e,n){let r=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({client_name:Qu,redirect_uris:[e],grant_types:["authorization_code","refresh_token"],response_types:["code"],token_endpoint_auth_method:"none",scope:n})});if(!r.ok){let o=await r.text();throw new Error(`Client registration failed: ${o}`)}return r.json()}async function lp(t,e,n,r,o){let i=new URLSearchParams({grant_type:"authorization_code",code:e,redirect_uri:r,client_id:o,code_verifier:n}),s=await fetch(t,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:i.toString()});if(!s.ok){let c=await s.text();throw new Error(`Token exchange failed: ${c}`)}return s.json()}function mp(t,e){return new Promise((n,r)=>{let o,i=!1,s=()=>{i||(i=!0,clearTimeout(o),process.off("SIGINT",c),process.off("SIGTERM",c),p.close())},c=()=>{s(),r(new Error("Login cancelled"))},p=Os.createServer((f,h)=>{let v=new URL(f.url||"",`http://localhost:${t}`);if(v.pathname!=="/callback"){h.writeHead(404),h.end("Not found");return}let x=v.searchParams.get("code"),$=v.searchParams.get("state"),A=v.searchParams.get("error"),S=v.searchParams.get("error_description");if(h.writeHead(200,{"Content-Type":"text/html"}),A){h.end(`
|
|
3
|
+
var f={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"CLI tool for Mindframes presentation generation",commands:["mf","mindframes"],apiUrl:"https://www.mindframes.app",docsUrl:"https://docs.mindframes.ai",packageName:"@conceptcraft/mindframes",configDir:".mindframes",apiKeyEnvVar:"MINDFRAMES_API_KEY",apiUrlEnvVar:"MINDFRAMES_API_URL",codexSelfConnectorAppId:"asdk_app_6a2b9629c1608191970dcb3ab374ac55"};import G from"chalk";import{Command as bR}from"commander";import tn from"chalk";import{Command as ep}from"commander";function la(e={}){let t=(d,u)=>{let g=e[d];return g&&g.trim().length>0?g.trim():u},n=t("NEXT_PUBLIC_PRODUCT_SHORT_NAME","ConceptCraft"),r=t("NEXT_PUBLIC_CLI_COMMAND","ccr"),o=t("NEXT_PUBLIC_CLI_COMMAND_FULL","conceptcraft"),i=t("NEXT_PUBLIC_CLI_CONFIG_DIR",`.${o}`),c=n.toUpperCase().replace(/[^A-Z0-9]/g,"_");return{id:o,name:i.replace(/^\./,""),displayName:n,description:`CLI tool for ${n} presentation generation`,commands:[r,o],apiUrl:t("NEXT_PUBLIC_API_URL","http://localhost:3000"),docsUrl:t("NEXT_PUBLIC_DOCS_URL",`https://docs.${n.toLowerCase()}.ai`),packageName:t("NEXT_PUBLIC_CLI_PACKAGE_NAME","@conceptcraft/cli"),configDir:i,apiKeyEnvVar:`${c}_API_KEY`,apiUrlEnvVar:`${c}_API_URL`,codexSelfConnectorAppId:e.NEXT_PUBLIC_CODEX_SELF_CONNECTOR_APP_ID?.trim()||void 0}}var p=typeof f<"u"&&f?f:la(process.env);import _ from"chalk";import Zr from"cli-table3";import Iu from"conf";import ma from"path";var pa=p.apiUrl,ku={apiKey:{type:"string"},apiUrl:{type:"string",default:pa},defaultTeamId:{type:"string"},accessToken:{type:"string"},refreshToken:{type:"string"},tokenExpiresAt:{type:"number"},clientId:{type:"string"},clientSecret:{type:"string"}};function xu(e=p.apiKeyEnvVar){return e.endsWith("_API_KEY")?`${e.slice(0,-8)}_CONFIG_DIR`:`${e}_CONFIG_DIR`}function Ru(e=process.env){let t=xu(),n=e[t]?.trim()||e.CC_SLIDES_CONFIG_DIR?.trim();if(n){if(!ma.isAbsolute(n))throw new Error(`${t} must be an absolute directory path`);return ma.normalize(n)}}var ua=Ru(),U=new Iu({projectName:p.name,schema:ku,...ua?{configFileMode:384,cwd:ua}:{}});function ga(){return{apiKey:Pe(),apiUrl:B(),defaultTeamId:U.get("defaultTeamId"),accessToken:U.get("accessToken"),refreshToken:U.get("refreshToken"),tokenExpiresAt:U.get("tokenExpiresAt"),clientId:U.get("clientId"),clientSecret:U.get("clientSecret")}}function Pe(){let e=process.env[p.apiKeyEnvVar]??process.env.CC_SLIDES_API_KEY;return e||U.get("apiKey")}function Yr(e){U.set("apiKey",e)}function B(){let e=process.env[p.apiUrlEnvVar]??process.env.CC_SLIDES_API_URL;return e||(U.get("apiUrl")??pa)}function Qr(e){U.set("apiUrl",e)}function te(){return U.get("defaultTeamId")}function gt(e){U.set("defaultTeamId",e)}function On(){U.clear()}function Zt(){return U.path}function ft(){return!!Pe()}function fa(){return U.get("accessToken")}function ha(){return U.get("refreshToken")}function Dn(e,t,n){U.set("accessToken",e),U.set("refreshToken",t),U.set("tokenExpiresAt",Date.now()+(n-60)*1e3)}function Nn(){U.delete("accessToken"),U.delete("refreshToken"),U.delete("tokenExpiresAt")}function ya(){let e=U.get("tokenExpiresAt");return e?Date.now()>=e:!0}function Qe(){return!!U.get("accessToken")&&!!U.get("refreshToken")}function ba(){return U.get("clientId")}function wa(){return U.get("clientSecret")}function va(e,t){U.set("clientId",e),U.set("clientSecret",t)}function k(e,t="human"){t!=="quiet"&&t!=="json"&&console.log(_.green("\u2713"),e)}function a(e,t="human"){if(t!=="quiet"){if(t==="json"){console.error(JSON.stringify({error:e}));return}console.error(_.red("\u2717"),e)}}function L(e,t="human"){t!=="quiet"&&t!=="json"&&console.warn(_.yellow("\u26A0"),e)}function Ia(e,t="human"){t==="quiet"||t==="json"||console.error(_.cyan("\u2192"),e)}function b(e,t="human"){t!=="quiet"&&t!=="json"&&console.log(_.blue("\u2139"),e)}function ht(e,t="en"){return e?`${B()}/${t}/view/presentations/${e}`:"N/A"}function ka(e,t={}){let{showLinks:n=!1,language:r="en"}=t,o=(d,u)=>d.length>u?`${d.slice(0,u-1)}\u2026`:d,i=d=>{if(!d)return"-";try{return new Date(d).toLocaleString("en-US",{month:"short",day:"numeric",hour:"numeric",minute:"2-digit",hour12:!0}).replace(" at ",", ")}catch{return"-"}};if(n){let d=new Zr({head:[_.cyan("Slug"),_.cyan("Title"),_.cyan("Slides"),_.cyan("Created"),_.cyan("URL")]});for(let u of e)d.push([o(u.slug||u.id.slice(0,8),30),o(u.title||"Untitled",22),String(u.numberOfSlides||"-"),i(u.createdAt),ht(u.slug,r)]);return d.toString()}let c=new Zr({head:[_.cyan("Slug"),_.cyan("Title"),_.cyan("Slides"),_.cyan("Mode"),_.cyan("Created")],colWidths:[32,28,8,11,18]});for(let d of e)c.push([d.slug||d.id.slice(0,8),d.title||"Untitled",String(d.numberOfSlides||"-"),d.mode||"-",i(d.createdAt)]);return c.toString()}function xa(e){let t=[...e].sort((o,i)=>{if(o.isDefault&&!i.isDefault)return-1;if(!o.isDefault&&i.isDefault)return 1;let c=o.createdAt?new Date(o.createdAt).getTime():0;return(i.createdAt?new Date(i.createdAt).getTime():0)-c}),n=o=>{if(!o)return"-";try{return new URL(o).href}catch{return o.startsWith("http")?o:`https://${o}`}},r=new Zr({head:[_.cyan("Name"),_.cyan("Source"),_.cyan("Color"),_.cyan("Logo"),_.cyan("Default"),_.cyan("ID")]});for(let o of t){let i=o.primaryColor?`${_.bgHex(o.primaryColor)(" ")} ${o.primaryColor}`:"-";r.push([o.name,n(o.sourceUrl),i,o.logoUrl?_.green("\u2713"):_.gray("\u2717"),o.isDefault?_.green("\u2605"):"",o.id])}return r.toString()}function eo(e){try{return new Date(e).toLocaleString()}catch{return e}}function ve(e){console.log(),console.log(_.bold(e)),console.log(_.gray("\u2500".repeat(e.length)))}function C(e,t){console.log(` ${_.gray(`${e}:`)} ${t??"-"}`)}function Cu(e){return JSON.stringify(e,null,2)}function l(e){console.log(Cu(e))}import{createHash as io,randomUUID as re}from"crypto";import{readFileSync as Na,statSync as La}from"fs";import{basename as so}from"path";import{spawnSync as Su}from"child_process";import{existsSync as Eu,mkdtempSync as Tu,rmSync as $u,writeFileSync as Au}from"fs";import{tmpdir as Pu}from"os";import{join as Ra}from"path";import to from"ffmpeg-static";var Ou=/Duration:\s*(\d+):(\d+):(\d+(?:\.\d+)?)/;function Du(e){let t=Ou.exec(e);if(!t)return;let n=Number(t[1])*3600+Number(t[2])*60+Number(t[3]);return Number.isFinite(n)&&n>0?n:void 0}function Ca(e,t="audio"){if(e.length===0)return;let n=to&&Eu(to)?to:"ffmpeg",r=/^[a-z0-9]+$/i.test(t)?t:"audio",o=Tu(Ra(Pu(),"mf-tts-duration-")),i=Ra(o,`speech.${r}`);try{Au(i,e);let c=Su(n,["-hide_banner","-i",i],{encoding:"utf8"});return c.error?void 0:Du(c.stderr??"")}finally{$u(o,{force:!0,recursive:!0})}}import Ln from"chalk";var s={SUCCESS:0,GENERAL_ERROR:1,AUTH_ERROR:2,NOT_FOUND:3,RATE_LIMIT:4,NETWORK_ERROR:5,INVALID_INPUT:6};async function Nu(){let e=ha(),t=ba(),n=B();if(!e||!t)return null;try{let r=await fetch(`${n}/.well-known/oauth-authorization-server`);if(!r.ok)return null;let o=await r.json(),i=new URLSearchParams({grant_type:"refresh_token",refresh_token:e,client_id:t}),c=wa();c&&i.set("client_secret",c);let d=await fetch(o.token_endpoint,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:i.toString()});if(!d.ok)return Nn(),null;let u=await d.json();return Dn(u.access_token,u.refresh_token,u.expires_in),u.access_token}catch{return null}}async function Sa(){return Qe()?ya()?Nu():fa()||null:null}function Oe(){return Qe()||ft()}async function h(){if(!Oe()){let e=p.commands[0],t=p.apiKeyEnvVar;console.error(Ln.red("\u2717 Not authenticated.")),console.error(),console.error(Ln.bold("To authenticate, run:")),console.error(Ln.cyan(` ${e} login`)),console.error(),console.error(Ln.gray(`Or set ${t} environment variable.`)),process.exit(s.AUTH_ERROR)}}function Lu(e){return e.length<=14?"****":`${e.slice(0,10)}...${e.slice(-4)}`}function Ea(){let e=Pe();if(e)return Lu(e)}function no(e){return["cc_slides_","mcp_","cc_sk_","sk_"].some(n=>e.startsWith(n))}import{mkdirSync as Uu,readFileSync as _u,writeFileSync as qu}from"fs";import{homedir as ju}from"os";import{join as Ta}from"path";import Vu from"ajv/dist/2020.js";var ro=new Map;function $a(){return Ta(ju(),".conceptcraft","schemas")}function Aa(e){return Ta($a(),`${e}.json`)}function Mu(e){try{let t=JSON.parse(_u(Aa(e),"utf8"));return typeof t?.catalogVersion=="number"&&t.schema?t:null}catch{return null}}function Bu(e,t){try{Uu($a(),{recursive:!0}),qu(Aa(e),JSON.stringify(t))}catch{}}async function Fu(e){let t=ro.get(e);if(t!==void 0)return t;try{let n=await Pa(e),r={catalogVersion:n.catalogVersion,schema:n.operationSchema??n.schema};return Bu(e,r),ro.set(e,r),r}catch{let n=Mu(e);return ro.set(e,n),n}}function Gu(e){let t=e.instancePath.replace(/^\//,"").replace(/\//g,"."),n=t.length>0?t:"(root)",r=e.keyword==="additionalProperties"?`: unknown field "${e.params.additionalProperty}"`:`: ${e.message??"invalid value"}`;return`${n}${r}`}async function Un(e,t){let n=await Fu(e);if(!n)return;let r;try{r=new Vu({allErrors:!0,strict:!1}).compile(n.schema)}catch{return}if(r(t))return;let o=(r.errors??[]).slice(0,10).map(Gu);throw new Error(`Request does not match the ${e} contract \u2014 ${o.join("; ")}`)}function ne(e,t){let n=e instanceof Error?e.message:"Unknown error";return!t||n.includes(t)?n:`${n} Request ID: ${t}. Resume with the matching status command; do not start a duplicate run.`}function ue(e,t={}){let n=e?.code?.trim()||t.defaultCode?.trim()||"",r=e?.message?.trim()||"The run failed without a reported reason.";return n?`[${n}] ${r}`:r}function oo(e){let t=e.status?.trim().toLowerCase()??"";return!!e.error||t==="failed"||t==="errored"||t==="cancelled"?`${e.runId?.trim()?`Run ${e.runId.trim()}`:"Run"} ${t||"failed"}: ${ue(e.error)}`:null}function Oa(e){let t=e.projectId??"<project-id>";return/Narration is still missing for \d+ slides?\./.test(e.message)?["Narration is captured from speaker notes when the video project is prepared, so 'presentation video refresh' will not backfill it.",`Fill each empty scene with: ${e.binary} presentation video-narration ${t} --slide-id <slide-id> (scene ids: ${e.binary} presentation video inspect ${t})`].join(`
|
|
4
|
+
`):/Every scene is excluded from the video\./.test(e.message)?`Include a scene again with: ${e.binary} presentation video edit ${t} --edit '{"type":"patch_scene","scene":1,"excluded":false}'`:null}async function Ie(){let e=await Sa();if(e)return{Authorization:`Bearer ${e}`};let t=Pe();return t?{"x-api-key":t}:{}}var D=class extends Error{constructor(n,r,o=1,i="operation_failed",c=!1){super(n);this.statusCode=r;this.exitCode=o;this.errorCode=i;this.retryable=c;this.name="ApiError"}statusCode;exitCode;errorCode;retryable},Ua="Idempotency-Key";function Ku(e){return e&&e!=="GET"?{[Ua]:re()}:{}}async function Se(e,t={}){let n=B();if(!Oe()&&!t.allowUnauthenticated)throw new D(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2,"authentication_required");let r=await Ie(),o=`${n}${e}`,i={...r,...Ku(t.method),...t.headers};t.body&&!t.stream&&(i["Content-Type"]="application/json");let c={method:t.method??"GET",headers:i};t.body&&(c.body=JSON.stringify(t.body));let d;try{d=await fetch(o,c)}catch(g){throw new D(`Network error: ${g instanceof Error?g.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!d.ok){let g=await d.text().catch(()=>""),w=Ju(g,d.status),v=1;switch(d.status){case 401:v=2;break;case 403:v=2;break;case 404:v=3;break;case 429:v=4;break;case 500:v=1;break}let x=`[${w.code}] ${w.message}`;throw new D(x,d.status,v,w.code,w.retryable)}return t.stream?d:d.headers.get("content-type")?.includes("application/json")?d.json():d.text()}function Wu(e){switch(e){case 400:return"invalid_input";case 401:return"authentication_required";case 402:return"insufficient_credits";case 403:return"access_denied";case 404:return"not_found";case 429:return"rate_limited";case 503:return"service_unavailable";default:return"operation_failed"}}function Ju(e,t){let n=Wu(t),r=e.trim()||`HTTP ${t}: The request could not be completed.`;try{let o=JSON.parse(e),i=typeof o.error=="object"&&o.error!==null?o.error:void 0;if(o.ok===!1&&typeof i?.code=="string"&&typeof i.message=="string")return{code:i.code,message:i.message,retryable:i.retryable===!0};if(typeof o.error=="string")return{code:/^[a-z][a-z0-9_]+$/.test(o.error)?o.error:n,message:typeof o.message=="string"?o.message:o.error,retryable:t===429||t>=500}}catch{}return{code:n,message:r,retryable:t===429||t>=500}}async function Pa(e){return Se(`/api/cli/tools/${encodeURIComponent(e)}/schema`)}async function _a(){return Se("/api/cli/capabilities",{allowUnauthenticated:!0})}async function I(e,t,n){let r=await co(n),o=`?teamId=${encodeURIComponent(r)}`;return Se(`/api/cli/tool-runs/${encodeURIComponent(e)}/${encodeURIComponent(t)}${o}`)}async function m(e,t,n){let r=await co(t.teamId);return Se(`/api/cli/tools/${encodeURIComponent(e)}`,{body:{...t,teamId:r},headers:n?{[Ua]:n}:void 0,method:"POST"})}function W(e){return co(e)}async function co(e){let t=typeof e=="string"&&e.trim()?e.trim():te()?.trim();if(t)return t;let n=await Ee();if(n.currentTeam?.id)return n.currentTeam.id;throw new D("Team ID required. Select a workspace with `mf config set team-id <id>` or pass --team-id.",400,void 0,"invalid_input")}async function qa(e){return Se("/api/llm-connections/profiles",{body:e,method:"POST"})}async function de(e,t,n,r=120){let o=0;for(let i=0;r===null||i<r;i++){let c;try{c=await I(e,t,n),o=0}catch(d){if(d instanceof D&&d.retryable&&o<2){o+=1,await new Promise(u=>setTimeout(u,2e3));continue}throw d instanceof D?new D(`${d.message} Request ID: ${t}.`,d.statusCode,d.exitCode,d.errorCode,d.retryable):new D(`${d instanceof Error?d.message:"Unknown error"} Request ID: ${t}.`,0,5,"poll_failed",!0)}if(c.done){if(c.error)throw new D(`${ue(c.error,{defaultCode:"operation_failed"})} Request ID: ${t}.`,500,1,c.error.code??"operation_failed",c.error.retryable);return c}await new Promise(d=>setTimeout(d,(c.nextPollAfterSeconds??2)*1e3))}throw new D(`[operation_timed_out] The background operation timed out. Request ID: ${t}.`,408,1,"operation_timed_out",!0)}function _n(e){return e.error||e.status==="failed"||e.status==="errored"||e.status==="cancelled"?"failed":e.done||e.status==="completed"?"completed":e.status==="in_progress"?"processing":"pending"}function zu(e){try{let n=new URL(e).pathname.split("/").pop()?.split(".").pop()?.toLowerCase();return n&&/^[a-z0-9]+$/.test(n)?n:void 0}catch{return}}function yt(e){let t=e.toLowerCase().split(".").pop();return{pdf:"application/pdf",docx:"application/vnd.openxmlformats-officedocument.wordprocessingml.document",xlsx:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",pptx:"application/vnd.openxmlformats-officedocument.presentationml.presentation",jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",gif:"image/gif",webp:"image/webp",mp4:"video/mp4",mov:"video/quicktime",mpeg:"video/mpeg",mpg:"video/mpeg",webm:"video/webm",aac:"audio/aac",m4a:"audio/mp4",mp3:"audio/mpeg",oga:"audio/ogg",ogg:"audio/ogg",wav:"audio/wav",txt:"text/plain",md:"text/markdown",csv:"text/csv",json:"application/json",html:"text/html",css:"text/css",js:"application/javascript",ts:"text/x-typescript",py:"text/x-python"}[t||""]||"application/octet-stream"}function Ze(e){let t=La(e);return{fileName:so(e),fileSize:t.size,fileType:yt(e)}}async function et(e,t){let n=Ze(e),r=Na(e),o=new FormData;for(let[c,d]of Object.entries(t.fields))o.append(c,d);o.append("file",new Blob([r],{type:n.fileType}),n.fileName);let i=await fetch(t.uploadUrl,{method:"POST",body:o});if(!i.ok)throw new D("Failed to upload file to storage",i.status,1);return{id:t.fileId??re(),name:n.fileName,s3Key:t.s3Key,url:t.fileUrl,size:n.fileSize,type:n.fileType,selected:!0}}async function Q(e,t={}){let n=B();if(!Oe())throw new D(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let r=await Ie(),o=La(e),i=so(e),c=yt(e),d=Na(e),u=io("sha256").update(d).digest("hex"),g=await fetch(`${n}/api/cli/files/upload`,{method:"POST",headers:{"Content-Type":"application/json",...r},body:JSON.stringify({fileMetadata:{lastModified:o.mtimeMs,name:i,type:c,size:o.size},...t.storagePrefix?{storagePrefix:t.storagePrefix}:{},...t.idempotencyKey?{uploadIdentity:{contentSha256:u,idempotencyKey:t.idempotencyKey}}:{}})});if(!g.ok){let v=await g.text();throw new D(v||"Failed to get upload URL",g.status,1)}let w=await g.json();return et(e,{...t.idempotencyKey?{fileId:`file-${io("sha256").update(JSON.stringify({contentSha256:u,fileName:i,idempotencyKey:t.idempotencyKey})).digest("hex")}`}:{},fields:w.fields||{},fileUrl:w.fileUrl,s3Key:w.uploadKey,uploadUrl:w.url})}async function ja(e,t,n={}){let r=[];for(let o=0;o<e.length;o++){let i=e[o],c=so(i);t?.(o,e.length,c);let d=await Q(i,{idempotencyKey:n.idempotencyKey});r.push(d)}return t?.(e.length,e.length,""),r}async function Va(e,t,n){let r={};for(let[o,i]of Object.entries(e))i!==void 0&&(r[o]=i);return r.brandingId===void 0&&typeof r.brandId=="string"&&(r.brandingId=r.brandId),delete r.brandId,m("createSlides",{...r,...n?{approvalReceipt:n}:{}},t)}async function Ma(e,t=20,n=0,r="updated"){return(await m("listPresentations",{limit:t,offset:n,sort:r,teamId:e})).presentations}async function bt(e,t){let n=t?.includeSlides!==!1,r=await m("getPresentation",{includeSlides:n,presentationId:e,teamId:t?.teamId});return n?{...r.presentation,slides:r.slides}:r.presentation}async function Ba(e,t,n,r){return m("generateSpeakerNotes",{...t,presentationId:e,teamId:r},n)}async function qn(e){let t=B(),n=await fetch(`${t}/api/durable-runs/${encodeURIComponent(e)}/events`,{headers:await Ie()});if(!n.ok)throw new D(await n.text(),n.status);return n}async function Fa(e,t={}){await m("deletePresentation",{approvalReceipt:t.approvalReceipt,presentationId:e,teamId:t.teamId},t.idempotencyKey??`cli:presentation:delete:${io("sha256").update(JSON.stringify({slugOrId:e,teamId:t.teamId??null})).digest("hex")}`)}async function Ga(e,t){return m("updatePresentationVisibility",{presentationId:e,teamId:t.teamId,visibility:t.visibility},t.idempotencyKey??`cli:presentation:visibility:${re()}`)}async function Ka(e,t,n){return m("exportPresentation",{format:t,presentationId:e,teamId:n?.teamId})}async function Wa(e){let t;try{t=await fetch(e)}catch(n){throw new D(`Network error while downloading the export: ${n instanceof Error?n.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!t.ok)throw new D(`[fetch_failed] The export download link returned ${t.status}. Signed links expire after one hour \u2014 re-run the export.`,t.status,1,"fetch_failed",!0);return t.arrayBuffer()}async function Ja(e,t,n={}){let r=B();if(!Oe())throw new D(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let o=await Ie(),i=new FormData,c=new Blob([e],{type:"application/zip"});i.append("file",c,t),i.append("options",JSON.stringify({dryRun:n.dryRun??!1,remapIds:!0}));let d=await fetch(`${r}/api/presentations/import`,{method:"POST",headers:o,body:i}),u=await d.json();if(!d.ok)throw new D(u.errors?.[0]?.message??"Import failed",d.status,1);return u}async function za(e,t=25){return m("listSlideTemplates",{limit:t,search:e})}async function Ha(e,t,n,r,o){return m("extractBranding",{approvalReceipt:n,skipExistingBrandingLookup:r,teamId:t,url:e},o)}async function Ee(){return Se("/api/cli/whoami")}async function Xa(){return Se("/api/cli/features")}async function Ya(e,t,n={}){let r=B();if(!Oe())throw new D(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let o=await Ie(),i=await fetch(`${r}/api/presentations/${e}/generate-blog`,{method:"POST",headers:{"Content-Type":"application/json",...o},body:JSON.stringify({documentCreatedAt:t,targetWordCount:n.targetWordCount??300,tone:n.tone??"professional",language:n.language??"en",targetAudience:n.targetAudience??"General Audience",blogFormat:n.blogFormat??"narrative",customInstructions:n.customInstructions??"",includeImages:n.includeImages??!0,includeTableOfContents:n.includeTableOfContents??!1})});if(!i.ok)throw new D(await i.text(),i.status,i.status===404?3:1);return i}async function lo(e){return m("getGenerationLimits",{teamId:e})}async function Qa(e,t,n){let r=await lo(n);if(!r.canGenerate[e]){let o=r.remaining[e]??0,i=r.limits[e]??0;throw i===0?new D(`The "${e}" mode is not available on your ${r.planName} plan. Available modes: ${r.availableModes.join(", ")||"none"}`,403,2):new D(`You have reached your ${e} generation limit for this billing cycle (${r.usage[e]??0}/${i} used). Try a different mode: ${r.availableModes.join(", ")||"none available"}`,403,4)}if(r.maxSlidesPerPresentation!==-1&&t>r.maxSlidesPerPresentation)throw new D(`Maximum ${r.maxSlidesPerPresentation} slides allowed on your ${r.planName} plan (requested: ${t}). Try a different mode: ${r.availableModes.join(", ")||"none available"}`,403,6);return r}function Hu(e){return e.replace(/[\u2014\u2013]/g,"-").replace(/[\u201C\u201D]/g,'"').replace(/[\u2018\u2019]/g,"'").replace(/\u2026/g,"...").replace(/\u00A0/g," ").replace(/[\u2010-\u2015]/g,"-").replace(/[\u2032\u2033]/g,"'")}async function Za(e,t){let n={...e,text:Hu(e.text)};await Un("generateSpeech",n);let r=await m("generateSpeech",{approvalReceipt:t?.approvalReceipt,...n},t?.idempotencyKey),o=await de("generateSpeech",r.runId),i=o.entity?.url;if(!i)throw new D(`Speech completed without an audio URL. Request ID: ${r.runId}.`,500);let c;try{c=await fetch(i)}catch(x){throw new D(`${x instanceof Error?x.message:"Failed to download speech audio"} Request ID: ${r.runId}.`,0,5,"download_failed",!0)}if(!c.ok)throw new D(`Failed to download speech audio. Request ID: ${r.runId}.`,c.status,5,"download_failed",c.status===429||c.status>=500);let d=o.output??{},u=e.options??{},g=Ce(d.format)??zu(i)??"mp3",w=Buffer.from(await c.arrayBuffer()),v=es(d.durationSec,d.duration,d.duration_s)??Ca(w,g);if(v===void 0)throw new D(`Speech completed without a measurable duration. Request ID: ${r.runId}.`,500,1,"invalid_audio_metadata");return{audioData:w,audioUrl:i,duration:v,provider:Ce(d.provider)??u.provider??"gemini",format:g,requestId:r.runId,voiceId:Ce(d.voice_id)??Ce(d.voiceId),voice:Ce(d.voice),model:Ce(d.model),speed:ao(d.speed)??u.speed,language:Ce(d.lang)??Ce(d.language)??u.language,langApplied:Da(d.langApplied)??Da(d.lang_applied),timestamps:Xu(d.timestamps),wordTimings:Yu(d.timestamps??d.timings)}}function es(...e){for(let t of e){let n=typeof t=="number"?t:typeof t=="string"&&t.trim()?Number(t):Number.NaN;if(Number.isFinite(n)&&n>0)return n}}function Xu(e){if(!e||typeof e!="object"||Array.isArray(e))return;let t=e,n=t.characters,r=t.characterStartTimesSeconds??t.character_start_times_seconds,o=t.characterEndTimesSeconds??t.character_end_times_seconds;if(!(!Array.isArray(n)||!Array.isArray(r)||!Array.isArray(o))&&!(n.length===0||n.length!==r.length||n.length!==o.length||!n.every(i=>typeof i=="string")||!r.every(i=>typeof i=="number"&&Number.isFinite(i))||!o.every(i=>typeof i=="number"&&Number.isFinite(i))))return{characters:n,characterStartTimesSeconds:r,characterEndTimesSeconds:o}}function Yu(e){if(!Array.isArray(e))return;let t=e.flatMap(n=>{if(!n||typeof n!="object"||Array.isArray(n))return[];let r=n,o=Ce(r.text)??Ce(r.word),i=ao(r.start),c=ao(r.end);return o&&i!==void 0&&c!==void 0&&c>=i?[{text:o,start:i,end:c}]:[]});return t.length>0?t:void 0}function Ce(e){return typeof e=="string"&&e.trim()?e.trim():void 0}function ao(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function Da(e){return typeof e=="boolean"?e:void 0}async function ts(e){let t=e?`/api/cli/tts?provider=${e}`:"/api/cli/tts";return Se(t)}async function ns(e,t){let n={...e},r=t?.idempotencyKey??(typeof n.idempotency_key=="string"?n.idempotency_key:void 0);return delete n.idempotency_key,await Un("generateMusic",n),{requestId:(await m("generateMusic",{...n,approvalReceipt:t?.approvalReceipt},r)).runId,status:"pending"}}async function mo(e){let t=await I("generateMusic",e);return{requestId:e,status:_n(t),audioUrl:t.entity?.url,duration:es(t.output?.durationSec,t.output?.duration,t.output?.duration_s),error:t.error?.message}}async function rs(e,t){return{requestId:(await m("mixAudio",{...e,approvalReceipt:t?.approvalReceipt},t?.idempotencyKey)).runId,status:"pending"}}async function uo(e){let t=await I("mixAudio",e);return{requestId:e,status:_n(t),outputUrl:t.entity?.url,error:t.error?.message}}async function os(e){return Se("/api/cli/images/search",{method:"POST",body:e})}async function is(e){return Se("/api/cli/videos/search",{method:"POST",body:e})}async function pe(e,t=60,n=2e3){let r=0;for(let o=0;o<t;o++){let i;try{i=await e(),r=0}catch(c){if(c instanceof D&&c.retryable&&r<2){r+=1,await new Promise(d=>setTimeout(d,n));continue}throw c}if(i.status==="completed"||i.status==="failed")return i;await new Promise(c=>setTimeout(c,n))}throw new D("Operation timed out",408,1)}async function as(e,t){let n={...e},r=t?.idempotencyKey??(typeof n.idempotency_key=="string"?n.idempotency_key:void 0);delete n.idempotency_key,await Un("generateSfx",n);let o=await m("generateSfx",{...n,approvalReceipt:t?.approvalReceipt},r);return{id:o.runId,requestId:o.runId,status:"pending"}}async function po(e){let t=await I("generateSfx",e);return{id:t.entity?.id??e,requestId:e,status:_n(t),audioUrl:t.entity?.url,error:t.error?.message}}async function ss(e,t){return m("listPresenterOptions",{...e?{voiceLanguage:e}:{},...t?{teamId:t}:{}})}async function ds(e,t){return{requestId:(await m("generateAvatarVideo",e,t)).runId,status:"pending"}}async function go(e){let t=await I("generateAvatarVideo",e);return{durationSec:typeof t.output?.durationSec=="number"?t.output.durationSec:null,error:t.error?.message,requestId:e,status:_n(t),videoUrl:t.entity?.url}}async function cs(e,t){return m("lipsyncVideo",e,t??re())}async function ls(e,t){return m("clipVideo",e,t??re())}async function ms(){return(await m("listTranslationLanguages",{})).languages}async function us(e,t){return m("translateVideo",e,t??re())}async function ps(e,t,n){return m("createVideo",{...e,approvalReceipt:t},n)}async function gs(e){let{idempotencyKey:t,...n}=e;return m("analyzeVideoReference",n,t)}async function fs(e,t){return de("analyzeVideoReference",e,t)}async function hs(e,t){return de("selectPresentationVideoStockMusic",e,t)}async function ys(e,t){return de("preparePresentationVideoPreviews",e,t,null)}async function bs(e,t){return de("generateBrandVariations",e,t)}async function ws(e,t){return de("extractBrandProducts",e,t)}async function vs(e,t){return de("buildBrandVoice",e,t)}async function Is(e,t){return de("generateBrandGuardrails",e,t)}async function ks(e,t){return de("repairBrandQuality",e,t)}async function xs(e,t){return de("syncBrandToPresentations",e,t)}async function Rs(e,t){return de("syncBrandFoundation",e,t)}async function Cs(e){return m("listVoices",e)}async function Ss(e){return m("adoptLibraryVoice",e,re())}async function Es(e){return m("setVoiceFavorite",e,re())}async function Ts(e){return m("designVoice",e,re())}async function $s(e){return m("saveDesignedVoice",e,re())}async function As(e){return m("retireVoice",e,re())}async function Ps(e){return m("listCastPresets",e)}async function Os(e){return m("createCastPreset",e,re())}async function Ds(e){return m("updateCastPreset",e,re())}async function Ns(e,t){return m("deleteCastPreset",{presetId:e,...t?{teamId:t}:{}},re())}var Ls=[{billing:"free",category:"branding",description:"Attach a social handle to an accessible brand profile.",id:"addBrandSocialHandle",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding social add",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Add a competitor to an accessible brand profile.",id:"addCompetitor",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding competitor add",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"knowledge",description:"File an uploaded file on this workspace's Library shelf; a .zip is expanded into the files it holds.",id:"addLibraryFile",lifecycle:{mode:"bounded"},milestone:"M8",name:"file save",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"media",description:"Add a voice from the shared library to this workspace, so it can be used like one of your own.",id:"adoptLibraryVoice",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice add",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Transcribe an uploaded recording and publish the transcript for generation.",id:"analyzeMediaAsset",lifecycle:{mode:"background",status:{cliCommand:"media analyze status",pollAfterSeconds:10}},milestone:"M8",name:"media analyze",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Analyze an uploaded video before using it as a source, motion, blocking, or pacing reference in a video storyboard. The completed status output includes the analysisId required by the storyboard's source-video binding.",id:"analyzeVideoReference",lifecycle:{mode:"background",status:{cliCommand:"video reference status",pollAfterSeconds:10}},milestone:"M8",name:"video reference analyze",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Version a presentation with changes from its already-linked brand.",id:"applyPresentationBrandChanges",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding presentation apply-changes",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Approve a private or team brand for use.",id:"approveBrand",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding approve",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Branch an immutable footage version into a new project.",id:"branchFootageProjectVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage branch",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Draft a brand's Voice and Context document from source material.",id:"buildBrandVoice",lifecycle:{mode:"background",status:{cliCommand:"branding voice build-status",pollAfterSeconds:3}},milestone:"M2",name:"branding voice build",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Cancel an active linked-presentation brand sync.",id:"cancelBrandPresentationSync",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding sync-cancel",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"presentations",description:"Request cancellation of an in-flight presentation MP4 render.",id:"cancelPresentationVideoRender",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video cancel",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Turn a ready video into short clips with virality scores (one clip-set artifact).",id:"clipVideo",lifecycle:{mode:"background",status:{cliCommand:"video clips status",pollAfterSeconds:20}},milestone:"M8",name:"video clips",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Mark a brand's onboarding review complete.",id:"completeBrandOnboarding",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding onboarding complete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"delegated",category:"artifacts",description:"Generate and persist an ad variation set.",id:"createAdSet",lifecycle:{mode:"background",status:{cliCommand:"ad-set status",pollAfterSeconds:10}},milestone:"M6",name:"ad-set create",operation:"generation",scopes:["ad-sets:write"],state:"available"},{billing:"free",category:"agents",description:"Activate an exact reviewed scheduled-agent draft.",id:"createAgent",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent create",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"quota",category:"branding",description:"Create an empty brand in the workspace.",id:"createBrand",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding create",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Mint a brand- and actor-scoped storage upload target for one private or team brand.",id:"createBrandAssetUploadUrl",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding asset upload-url",operation:"query",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Save one way a cast member appears: a personal presenter (pp_* id), a backdrop, and optionally a voice, under a name unique to that person.",id:"createCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Save a markdown, CSV or plain-text document into the Library.",id:"createDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document create",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"media",description:"Create a transcript-native, versioned footage edit project.",id:"createFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"fixed",category:"media",description:"Generate and persist an image.",id:"createImage",lifecycle:{mode:"background",status:{cliCommand:"image status",pollAfterSeconds:10}},milestone:"M5",name:"image generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Mint an upload target for a file this caller will file in the Library.",id:"createLibraryFileUploadUrl",lifecycle:{mode:"bounded"},milestone:"M8",name:"file upload-url",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"knowledge",description:"Create a Library folder, optionally inside another folder.",id:"createLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders create",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"dynamic",category:"artifacts",description:"Generate and persist a microsite.",id:"createMicrosite",lifecycle:{mode:"background",status:{cliCommand:"microsite status",pollAfterSeconds:10}},milestone:"M6",name:"microsite create",operation:"generation",scopes:["microsites:write"],state:"available"},{billing:"free",category:"artifacts",description:"Create a standalone poll.",id:"createPoll",lifecycle:{mode:"bounded"},milestone:"M3",name:"poll create",operation:"mutation",scopes:["polls:write"],state:"available"},{billing:"delegated",category:"presentations",description:"Create an MP4 video from a finished presentation, or render an existing presentation-video project.",id:"createPresentationVideo",lifecycle:{mode:"background",status:{cliCommand:"presentation video status",pollAfterSeconds:10}},milestone:"M4",name:"presentation video",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Mint a deterministic, owned-project-scoped upload target for custom presentation-video music.",id:"createPresentationVideoMusicUploadUrl",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video music upload-url",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Create a reusable personal presenter from approved footage, a headshot, or a synthetic-persona prompt.",id:"createPresenter",lifecycle:{mode:"background",status:{cliCommand:"avatar presenter status",pollAfterSeconds:10}},milestone:"M8",name:"avatar presenter create",operation:"generation",scopes:["media:write"],state:"available"},{billing:"fixed",category:"presentations",description:"Generate a presentation and persist the resulting deck.",id:"createSlides",lifecycle:{mode:"background",status:{cliCommand:"presentation status",pollAfterSeconds:20}},milestone:"M4",name:"create",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate one video from the opaque text and explicit metadata stored in a pinned storyboard revision.",id:"createVideo",lifecycle:{mode:"background",status:{cliCommand:"video status",pollAfterSeconds:20}},milestone:"M8",name:"video create",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Create a versioned Markdown video storyboard.",id:"createVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard create",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"fixed",category:"artifacts",description:"Generate a persisted standalone visual abstract.",id:"createVisualAbstract",lifecycle:{mode:"background",status:{cliCommand:"visual-abstract status",pollAfterSeconds:10}},milestone:"M5",name:"visual-abstract create",operation:"generation",scopes:["visual-abstracts:write"],state:"available"},{billing:"free",category:"branding",description:"Remove a brand from the library.",id:"deleteBrand",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one asset record from a private or team brand's visible library.",id:"deleteBrandAsset",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding asset delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one competitor from an accessible brand.",id:"deleteBrandCompetitor",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding competitor delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one custom Foundation colour role.",id:"deleteBrandCustomColor",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding foundation color delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one of a brand's guardrail rules.",id:"deleteBrandGuardrail",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding guardrails delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one product from a brand.",id:"deleteBrandProduct",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding product delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one social account from an accessible brand.",id:"deleteBrandSocialHandle",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding social delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one per-channel brand design variant.",id:"deleteBrandVariant",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding variant delete",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Retire a saved cast preset. Existing videos keep working; the preset stops being offered.",id:"deleteCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset delete",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Remove a document from the Library.",id:"deleteDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document delete",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"knowledge",description:"Delete a Library folder and its descendants while returning their items to Unfiled.",id:"deleteLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders delete",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"presentations",description:"Permanently delete an owned presentation, all of its versions, and its publications.",id:"deletePresentation",lifecycle:{mode:"bounded"},milestone:"M8",name:"presentation delete",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"fixed",category:"media",description:"Generate candidate voices from a written description, or vary one you already heard.",id:"designVoice",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice design",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Compare two points in a brand's version history.",id:"diffBrandVersions",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding version diff",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Create a replay-safe draft copy of one brand product with its assets and provenance.",id:"duplicateBrandProduct",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding product duplicate",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"artifacts",description:"Edit a standalone poll.",id:"editPoll",lifecycle:{mode:"bounded"},milestone:"M3",name:"poll edit",operation:"mutation",scopes:["polls:write"],state:"available"},{billing:"free",category:"presentations",description:"Apply one atomic edit to a presentation-video draft. add_scene inserts an empty title scene after the reference; duplicate_scene inserts an independent copy of its visual, narration, voice, presenter and scene settings; replace_video_scene swaps the addressed scene for an owned reusable video while preserving its timeline identity. patch_scene with excluded toggles inclusion without deleting the scene.",id:"editPresentationVideoDraft",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video edit",operation:"mutation",scopes:["presentations:write","media:read"],state:"available"},{billing:"dynamic",category:"presentations",description:"Generate narration for the planned or explicitly selected presentation-video slides.",id:"ensurePresentationVideoNarration",lifecycle:{mode:"background",status:{cliCommand:"presentation video narrate status",pollAfterSeconds:5}},milestone:"M4",name:"presentation video narrate",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Render a presentation you can edit to HTML/PDF/PPTX and return a short-lived signed download URL.",id:"exportPresentation",lifecycle:{mode:"bounded"},milestone:"M1",name:"export",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"quota",category:"branding",description:"Extract and persist a reusable brand profile from a URL.",id:"extractBranding",lifecycle:{mode:"background",status:{cliCommand:"branding status",pollAfterSeconds:10}},milestone:"M2",name:"branding extract",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Discover a brand's products by crawling its site.",id:"extractBrandProducts",lifecycle:{mode:"background",status:{cliCommand:"branding product extract-status",pollAfterSeconds:3}},milestone:"M2",name:"branding product extract",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"dynamic",category:"research",description:"Extract bounded text and metadata from a source.",id:"extractContent",lifecycle:{mode:"bounded"},milestone:"M1",name:"content extract",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"knowledge",description:"File an artifact into a Library folder, or return it to Unfiled.",id:"fileArtifactIntoFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library file",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"agents",description:"Permanently erase every stored version of a scheduled Agent memory.",id:"forgetAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory forget",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate one reusable avatar/presenter clip for composition into a video. Accepts a stock avatar id or a personal presenter's pp_* id as avatarId.",id:"generateAvatarVideo",lifecycle:{mode:"background",status:{cliCommand:"avatar status",pollAfterSeconds:10}},milestone:"M8",name:"avatar generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Draft guardrail rule proposals for a brand.",id:"generateBrandGuardrails",lifecycle:{mode:"background",status:{cliCommand:"branding guardrails generate-status",pollAfterSeconds:3}},milestone:"M2",name:"branding guardrails generate",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Generate a brand's per-channel design variants and gradients.",id:"generateBrandVariations",lifecycle:{mode:"background",status:{cliCommand:"branding variations status",pollAfterSeconds:3}},milestone:"M2",name:"branding variations generate",operation:"generation",scopes:["brands:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate music from a direct brief or final video facts as an approved, recoverable run.",id:"generateMusic",lifecycle:{mode:"background",status:{cliCommand:"music status",pollAfterSeconds:10}},milestone:"M7",name:"music generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"presentations",description:"Generate a right-way or wrong-way scene clip from a picture and attach it as a layer to one or more scenes of a presentation video.",id:"generatePresentationVideoSceneClip",lifecycle:{mode:"background",status:{cliCommand:"presentation video scene-clip status",pollAfterSeconds:10}},milestone:"M8",name:"presentation video scene-clip generate",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Generate an additional look for an existing personal presenter while preserving the same Cast identity.",id:"generatePresenterLook",lifecycle:{mode:"background",status:{cliCommand:"avatar look status",pollAfterSeconds:10}},milestone:"M8",name:"avatar look generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate one sound-effect cue from a direct brief or final video facts as an approved, recoverable run.",id:"generateSfx",lifecycle:{mode:"background",status:{cliCommand:"sfx status",pollAfterSeconds:10}},milestone:"M7",name:"sfx generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"presentations",description:"Generate persisted speaker notes for a presentation version.",id:"generateSpeakerNotes",lifecycle:{mode:"background",status:{cliCommand:"presentation speaker-notes-status",pollAfterSeconds:5}},milestone:"M4",name:"presentation speaker-notes",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"dynamic",category:"media",description:"Generate speech audio from text as an approved, recoverable run.",id:"generateSpeech",lifecycle:{mode:"background",status:{cliCommand:"tts status",pollAfterSeconds:10}},milestone:"M7",name:"tts generate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"Read one owned Agent and its complete configuration.",id:"getAgent",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent get",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"Read what a scheduled Agent remembers. Memory is context recorded from its runs; it grants no permission and overrides no instruction.",id:"getAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory show",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"branding",description:"List competitors saved for an accessible brand profile.",id:"getBrandCompetitors",lifecycle:{mode:"bounded"},milestone:"M1",name:"branding competitor list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read the complete current brand footer settings.",id:"getBrandFooter",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding footer get",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read a brand's guardrail rules.",id:"getBrandGuardrails",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding guardrails get",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read a brand's design tokens, the keys it is missing, or its design.md document.",id:"getBrandProfile",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding profile",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read which decks have drifted from a brand.",id:"getBrandQuality",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding quality get",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"Read a brand's Voice and Context document.",id:"getBrandVoice",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding voice get",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"billing",description:"List every credit charge inside one activity group, with the run that made it.",id:"getCreditActivityGroup",lifecycle:{mode:"bounded"},milestone:"M8",name:"credits trace",operation:"query",scopes:["billing:read"],state:"available"},{billing:"free",category:"media",description:"Read an owned footage project and its append-only versions.",id:"getFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage show",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"presentations",description:"Read the workspace's per-mode generation limits, usage, remaining quota, plan and storage allowance.",id:"getGenerationLimits",lifecycle:{mode:"bounded"},milestone:"M1",name:"presentation limits",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"knowledge",description:"Return a bounded Open Knowledge Format workspace bundle.",id:"getKnowledgeBundle",lifecycle:{mode:"bounded"},milestone:"M1",name:"knowledge bundle",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search recent news sources.",id:"getNews",lifecycle:{mode:"bounded"},milestone:"M1",name:"search news",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"presentations",description:"Read an owned presentation and optionally its ordered slides.",id:"getPresentation",lifecycle:{mode:"bounded"},milestone:"M1",name:"get",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"branding",description:"Read changes in a presentation's already-linked brand.",id:"getPresentationBrandDrift",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding presentation drift",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"presentations",description:"Read presentation ownership, access, and eligible team members.",id:"getPresentationSharing",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation sharing get",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read one owned presentation-video Studio chat with safe attachment and scene-marker context.",id:"getPresentationVideoChatThread",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video chat",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read whether a presentation-video draft is behind its source deck without changing it.",id:"getPresentationVideoFreshness",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video freshness",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read preview run status and prepared image metadata for every video scene.",id:"getPresentationVideoPreviews",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video previews inspect",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read an owned presentation-video project and its ordered scene timeline.",id:"getPresentationVideoProject",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video inspect",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read one MP4 render attempt with its exact snapshot and download metadata.",id:"getPresentationVideoRender",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video render",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"Read one saved presentation-video draft snapshot without restoring it.",id:"getPresentationVideoVersion",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video version",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"agents",description:"Read one roster-visible Agent without exposing its private configuration.",id:"getRosterAgent",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent roster get",operation:"query",scopes:["agents:read"],state:"available"},{billing:"dynamic",category:"research",description:"Fetch a YouTube video's timestamped transcript, title, channel, and duration.",id:"getYoutubeTranscript",lifecycle:{mode:"bounded"},milestone:"M1",name:"transcript",operation:"query",scopes:["research:read"],state:"available"},{billing:"quota",category:"branding",description:"Import a reusable brand from DESIGN.md and optionally merge URL evidence.",id:"importBrandDesignMd",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding import",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Import a recording from a connected account into the media library.",id:"importConnectorRecording",lifecycle:{mode:"background",status:{cliCommand:"media import status",pollAfterSeconds:5}},milestone:"M8",name:"media import",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Import every completed provider-assisted take, preserving explicit source traceability when proven.",id:"importFootageProviderTakes",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage import-takes",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"presentations",description:"Import an attached PowerPoint as an auditable, review-gated Mindframes presentation.",id:"importPowerPoint",lifecycle:{mode:"background",status:{cliCommand:"presentation import status",pollAfterSeconds:5}},milestone:"M4",name:"presentation import",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"media",description:"Create proxy, filmstrip, and waveform evidence for one footage range.",id:"inspectFootageRange",lifecycle:{mode:"background",status:{cliCommand:"footage inspection-status",pollAfterSeconds:2}},milestone:"M8",name:"footage inspect",operation:"generation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Re-voice a ready video with new audio via provider lip-sync (one sibling re-voiced video artifact).",id:"lipsyncVideo",lifecycle:{mode:"background",status:{cliCommand:"video lipsync status",pollAfterSeconds:20}},milestone:"M8",name:"video lipsync",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"List the caller's roster: owned Agents plus same-workspace Agents shared with the team.",id:"listAgentRoster",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent roster list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"List the caller's scheduled Agents with stable cursor pagination.",id:"listAgents",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"agents",description:"List the user's secret-free Claude Code or Codex connection profiles and current selection.",id:"listAiConnectionProfiles",lifecycle:{mode:"bounded"},milestone:"M8",name:"ai-connections list",operation:"query",scopes:["agents:read"],state:"available"},{billing:"free",category:"branding",description:"Read a filtered, cursor-paginated activity feed for one brand.",id:"listBrandActivity",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding activity",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List uploaded assets attached to one private or team brand, optionally by kind.",id:"listBrandAssets",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding asset list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List available workspace brand profiles, optionally filtered by name or domain.",id:"listBrandings",lifecycle:{mode:"bounded"},milestone:"M1",name:"branding list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List the safe, owned job history for one brand.",id:"listBrandJobs",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding jobs list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List stable logo candidates and identify the active one.",id:"listBrandLogos",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding logo list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List workspace members that a brand permission administrator can address.",id:"listBrandPermissionCandidates",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding permission candidates",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List explicit member access overrides for one team brand.",id:"listBrandPermissions",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding permission list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List presentations already linked to a brand.",id:"listBrandPresentations",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding presentations list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List the products a brand sells.",id:"listBrandProducts",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding product list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List the social accounts recorded as belonging to one accessible brand.",id:"listBrandSocialHandles",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding social list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List a brand's per-channel design variants.",id:"listBrandVariants",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding variant list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"branding",description:"List a brand's published versions.",id:"listBrandVersions",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding version list",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"media",description:"List saved ways a cast member appears \u2014 a trained presenter, a backdrop, and optionally a voice, under one name. Filtered to what the caller may actually use.",id:"listCastPresets",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset list",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"billing",description:"List a workspace's credit spend grouped by the artifact it was spent on.",id:"listCreditActivity",lifecycle:{mode:"bounded"},milestone:"M8",name:"credits activity",operation:"query",scopes:["billing:read"],state:"available"},{billing:"free",category:"knowledge",description:"List the workspace's documents, newest first.",id:"listDocuments",lifecycle:{mode:"bounded"},milestone:"M8",name:"document list",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"List a document's append-only version history.",id:"listDocumentVersions",lifecycle:{mode:"bounded"},milestone:"M8",name:"document versions",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"List the files this workspace filed in its Library.",id:"listLibraryFiles",lifecycle:{mode:"bounded"},milestone:"M8",name:"file list",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"List the workspace Library folder tree in display order, optionally with item counts.",id:"listLibraryFolders",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders list",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"presentations",description:"List presentations visible to the caller in one explicitly selected workspace.",id:"listPresentations",lifecycle:{mode:"bounded"},milestone:"M1",name:"presentation list",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"List the owned Studio chat threads for a presentation video.",id:"listPresentationVideoChatThreads",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video chats",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"List every presentation-video draft for a source deck with stage and staleness.",id:"listPresentationVideoProjects",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video drafts",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"List every MP4 render attempt for a presentation-video project.",id:"listPresentationVideoRenders",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video renders",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"List saved presentation-video draft versions.",id:"listPresentationVideoVersions",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video versions",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"media",description:"List the personal-presenter engines, supported source kinds, customer-credit prices, and exact localized consent statement available to this workspace.",id:"listPresenterCreationOptions",lifecycle:{mode:"bounded"},milestone:"M8",name:"avatar presenter options",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"media",description:"List provider-neutral presenter avatars, voices, and voice languages, plus the workspace's trained personal presenters (`personal` roster group, pp_* ids).",id:"listPresenterOptions",lifecycle:{mode:"bounded"},milestone:"M8",name:"avatar options",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"media",description:"List ready generated clips and uploaded MediaAssets while excluding final presentation-to-MP4 renders.",id:"listReusableVideoClips",lifecycle:{mode:"bounded"},milestone:"M8",name:"video library list",operation:"query",scopes:["media:read","presentations:read"],state:"available"},{billing:"free",category:"presentations",description:"List the slide design templates available to the workspace, plus system templates.",id:"listSlideTemplates",lifecycle:{mode:"bounded"},milestone:"M1",name:"templates",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"free",category:"support",description:"List this workspace's support requests and their status; --mine narrows to the reports you filed.",id:"listSupportRequests",lifecycle:{mode:"bounded"},milestone:"M8",name:"support list",operation:"query",scopes:["support:read"],state:"available"},{billing:"free",category:"media",description:"List provider-neutral target languages for video translation.",id:"listTranslationLanguages",lifecycle:{mode:"bounded"},milestone:"M8",name:"video translate-languages",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"media",description:"List the voices this workspace can narrate with, filtered by the labels the provider states.",id:"listVoices",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice list",operation:"query",scopes:["media:read"],state:"available"},{billing:"dynamic",category:"media",description:"Mix voice, music, and sound-effect tracks as an approved, recoverable run.",id:"mixAudio",lifecycle:{mode:"background",status:{cliCommand:"mix status",pollAfterSeconds:10}},milestone:"M7",name:"mix create",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Move a Library folder under a new parent or to the top level.",id:"moveLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders move",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"agents",description:"Pause an owned Agent's schedule without changing its configuration.",id:"pauseAgentSchedule",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent pause",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"presentations",description:"Create or reuse a presentation-video project for a finished presentation.",id:"preparePresentationVideo",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video prepare",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Start or resume slide-preview preparation for a presentation-video draft.",id:"preparePresentationVideoPreviews",lifecycle:{mode:"background",status:{cliCommand:"presentation video previews status",pollAfterSeconds:2}},milestone:"M4",name:"presentation video previews prepare",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"branding",description:"Publish the brand's working draft as a new live version.",id:"publishBrandVersion",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding version publish",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"knowledge",description:"Read the full content of an artifact this workspace owns: a presentation's slides, a video's request, narration and scenes, a narrated-video project's scene timeline, a microsite's or article's blocks, or a Library document.",id:"readArtifact",lifecycle:{mode:"bounded"},milestone:"M1",name:"artifact read",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"knowledge",description:"Read one document's full body and metadata.",id:"readDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document read",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"media",description:"Read a video storyboard and its immutable revision history.",id:"readVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard show",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"knowledge",description:"Set or clear a Library folder's colour.",id:"recolorLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders recolor",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"agents",description:"Create a private inactive scheduled-agent draft for review.",id:"recommendAgent",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent recommend",operation:"generation",scopes:["agents:write"],state:"available"},{billing:"free",category:"presentations",description:"Refresh deck-backed video scenes from the latest presentation version.",id:"refreshPresentationVideoSlides",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video refresh",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"dynamic",category:"presentations",description:"Regenerate one narration override in a presentation-video draft.",id:"regeneratePresentationVideoNarration",lifecycle:{mode:"background",status:{cliCommand:"presentation video-narration-status",pollAfterSeconds:5}},milestone:"M4",name:"presentation video-narration",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"branding",description:"Register an already-uploaded file in one private or team brand's asset library.",id:"registerBrandAsset",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding asset register",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove an exact logo candidate and select its deterministic fallback when active.",id:"removeBrandLogo",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding logo remove",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Remove one member's explicit access override from a team brand.",id:"removeBrandPermission",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding permission remove",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"knowledge",description:"Take a file off this workspace's Library shelf and delete its stored bytes.",id:"removeLibraryFile",lifecycle:{mode:"bounded"},milestone:"M8",name:"file remove",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"branding",description:"Rename one asset in a private or team brand's library.",id:"renameBrandAsset",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding asset rename",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"knowledge",description:"Rename a Library folder.",id:"renameLibraryFolder",lifecycle:{mode:"bounded"},milestone:"M1",name:"library folders rename",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"delegated",category:"media",description:"Render selected outputs from one exact, strategy-approved footage draft version.",id:"renderFootageProject",lifecycle:{mode:"background",status:{cliCommand:"footage render-status",pollAfterSeconds:5}},milestone:"M8",name:"footage render",operation:"generation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"presentations",description:"Render one scene of a presentation video to its own reusable MP4 segment and cache it for the final render.",id:"renderPresentationVideoScene",lifecycle:{mode:"background",status:{cliCommand:"presentation video scene status",pollAfterSeconds:10}},milestone:"M8",name:"presentation video scene render",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"branding",description:"Repair decks that have visually drifted from a brand.",id:"repairBrandQuality",lifecycle:{mode:"background",status:{cliCommand:"branding quality repair-status",pollAfterSeconds:5}},milestone:"M2",name:"branding quality repair",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Resolve a brand's current draft design for an artifact context, including ordered node trace and conflicts.",id:"resolveBrandDesign",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding design resolve",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"knowledge",description:"Restore an earlier version by appending it as the current one.",id:"restoreDocumentVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"document restore",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"media",description:"Restore an immutable footage version as a new project head.",id:"restoreFootageProjectVersion",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage restore",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"presentations",description:"Restore a saved presentation-video draft version as a new version, optionally only when both the current version and non-coalescing project revision still match expected values.",id:"restorePresentationVideoVersion",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video restore",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"agents",description:"Resume an owned Agent's saved schedule without changing its configuration.",id:"resumeAgentSchedule",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent resume",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"media",description:"Remove one of your own workspace voices and release the slot it holds.",id:"retireVoice",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice remove",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"presentations",description:"Retry the failed or cancelled slide-preview run attached to a video draft.",id:"retryPresentationVideoPreviews",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video previews retry",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"media",description:"Append a semantic revision to a footage edit project.",id:"reviseFootageProject",lifecycle:{mode:"bounded"},milestone:"M8",name:"footage revise",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"delegated",category:"media",description:"Create a new presenter Look by editing an existing Look without changing its source.",id:"revisePresenterLook",lifecycle:{mode:"background",status:{cliCommand:"avatar look revision-status",pollAfterSeconds:10}},milestone:"M8",name:"avatar look revise",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Create a new immutable revision of a Markdown video storyboard.",id:"reviseVideoStoryboard",lifecycle:{mode:"bounded"},milestone:"M8",name:"video storyboard revise",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"branding",description:"Create or update one of a brand's products.",id:"saveBrandProduct",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding product set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Keep one of the candidates from designVoice as a reusable workspace voice.",id:"saveDesignedVoice",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice save",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"dynamic",category:"research",description:"Read and normalize bounded content from a public URL.",id:"scrape",lifecycle:{mode:"bounded"},milestone:"M1",name:"scrape",operation:"query",scopes:["research:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search licensed image catalogs.",id:"searchImages",lifecycle:{mode:"bounded"},milestone:"M1",name:"search images",operation:"query",scopes:["research:read"],state:"available"},{billing:"dynamic",category:"research",description:"Search current public web sources.",id:"searchInternet",lifecycle:{mode:"bounded"},milestone:"M1",name:"search web",operation:"query",scopes:["research:read"],state:"available"},{billing:"free",category:"knowledge",description:"Search the workspace Knowledge Hub across presentations, artifacts, context, and agents.",id:"searchKnowledge",lifecycle:{mode:"bounded"},milestone:"M1",name:"knowledge search",operation:"query",scopes:["knowledge:read"],state:"available"},{billing:"free",category:"presentations",description:"Search the presentation-video stock-music catalog and return preview metadata plus opaque selection tokens.",id:"searchPresentationVideoStockMusic",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video music stock search",operation:"query",scopes:["presentations:read"],state:"available"},{billing:"dynamic",category:"media",description:"Search web and licensed stock-video catalogs with provider-neutral attribution.",id:"searchStockVideo",lifecycle:{mode:"bounded"},milestone:"M1",name:"search video",operation:"query",scopes:["media:read"],state:"available"},{billing:"free",category:"agents",description:"Select a Claude Code or Codex connection profile, or restore the native provider route.",id:"selectAiConnectionProfile",lifecycle:{mode:"bounded"},milestone:"M8",name:"ai-connections select",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"delegated",category:"presentations",description:"Materialize a searched stock track, or auto-select from saved deck context, and persist it on a presentation-video project.",id:"selectPresentationVideoStockMusic",lifecycle:{mode:"background",status:{cliCommand:"presentation video music stock status",pollAfterSeconds:3}},milestone:"M4",name:"presentation video music stock select",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"agents",description:"Share an owned Agent with the workspace or return it to private visibility.",id:"setAgentVisibility",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent visibility set",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"branding",description:"Create or update one custom Foundation colour role atomically.",id:"setBrandCustomColor",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding foundation color set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Change one or more brand footer settings without guessing the rest.",id:"setBrandFooter",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding footer set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Replace a brand's gradient library and its role pointers.",id:"setBrandGradients",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding gradient set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Create or update one of a brand's guardrail rules.",id:"setBrandGuardrail",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding guardrails set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Point a brand at an already-uploaded logo, dark-background logo variant, or favicon.",id:"setBrandLogo",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding logo set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Set one team member's explicit access role for a team brand.",id:"setBrandPermission",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding permission set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Atomically set approved and draft state for a bounded set of brand products.",id:"setBrandProductSelection",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding product select",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Star or unstar a brand in your own library.",id:"setBrandStar",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding star",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Create or update one per-channel brand design variant.",id:"setBrandVariant",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding variant set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Write a brand's Voice and Context document.",id:"setBrandVoice",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding voice set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Make one brand the default for this workspace or for you.",id:"setDefaultBrand",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding set-default",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"presentations",description:"Set a presentation-video scene, or an exact slideIds batch atomically, to a specific avatar/look or saved preset, including the preset voice by default, or restore inheritance from the project default. A batch creates one saved version and does not render media.",id:"setPresentationVideoScenePresenter",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video presenter",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"media",description:"Set the poster image of a finished video.",id:"setVideoThumbnail",lifecycle:{mode:"bounded"},milestone:"M8",name:"video thumbnail set",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"media",description:"Star a voice so it stays at the top of your list, or remove the star. A star is a shortcut, never a permission.",id:"setVoiceFavorite",lifecycle:{mode:"bounded"},milestone:"M8",name:"voice star",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"support",description:"File a bug, question, feature request or billing issue against Mindframes.",id:"submitSupportRequest",lifecycle:{mode:"bounded"},milestone:"M8",name:"support report",operation:"mutation",scopes:["support:write"],state:"available"},{billing:"free",category:"branding",description:"Mirror a brand's current flat data into its resolved DAG and active snapshot.",id:"syncBrandFoundation",lifecycle:{mode:"background",status:{cliCommand:"branding foundation sync-status",pollAfterSeconds:3}},milestone:"M2",name:"branding foundation sync",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Apply a brand to every presentation linked to it.",id:"syncBrandToPresentations",lifecycle:{mode:"background",status:{cliCommand:"branding sync-status",pollAfterSeconds:5}},milestone:"M2",name:"branding sync",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Evaluate a brand's guardrail rules against content.",id:"testBrandGuardrails",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding guardrails test",operation:"query",scopes:["brands:read"],state:"available"},{billing:"free",category:"presentations",description:"Transfer a complete presentation and all saved versions to an active team editor or admin.",id:"transferPresentationOwnership",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation transfer",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Transform an uploaded PowerPoint source into an auditable presentation review.",id:"transformPresentationImport",lifecycle:{mode:"background",status:{cliCommand:"presentation import transform-status",pollAfterSeconds:5}},milestone:"M4",name:"presentation import transform",operation:"generation",scopes:["presentations:write"],state:"available"},{billing:"delegated",category:"media",description:"Translate a ready video into sibling language versions (one video per target language).",id:"translateVideo",lifecycle:{mode:"background",status:{cliCommand:"video translate status",pollAfterSeconds:20}},milestone:"M8",name:"video translate",operation:"generation",scopes:["media:write"],state:"available"},{billing:"free",category:"agents",description:"Update an owned Agent's schedule, sources, outputs, delivery, review, runtime, or blueprint configuration.",id:"updateAgentConfiguration",lifecycle:{mode:"bounded"},milestone:"M8",name:"agent configure",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"agents",description:"Add to or remove from what a scheduled Agent remembers.",id:"updateAgentMemory",lifecycle:{mode:"bounded"},milestone:"M3",name:"agent memory set",operation:"mutation",scopes:["agents:write"],state:"available"},{billing:"free",category:"branding",description:"Rename a brand or change which brand it sits under.",id:"updateBrand",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding update",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"branding",description:"Write a brand's design tokens from a key patch or a whole design.md document.",id:"updateBrandTokens",lifecycle:{mode:"bounded"},milestone:"M2",name:"branding set",operation:"mutation",scopes:["brands:write"],state:"available"},{billing:"free",category:"media",description:"Change a saved cast preset's name, presenter, backdrop, or voice. Sends the complete preset, not a patch.",id:"updateCastPreset",lifecycle:{mode:"bounded"},milestone:"M8",name:"cast preset update",operation:"mutation",scopes:["media:write"],state:"available"},{billing:"free",category:"knowledge",description:"Edit a document's body, title or summary under an optimistic lock.",id:"updateDocument",lifecycle:{mode:"bounded"},milestone:"M8",name:"document update",operation:"mutation",scopes:["knowledge:write"],state:"available"},{billing:"free",category:"presentations",description:"Manage presentation collaborators and team access.",id:"updatePresentationSharing",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation sharing update",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Update avatar, presenter layout/background/scene visibility, voice, music, captions, format, and renderer settings for a presentation-video project. settings.sceneVoiceIds atomically merges exact scene voice overrides without changing omitted scenes or the default voice; settings changes do not render media.",id:"updatePresentationVideoSettings",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation video settings",operation:"mutation",scopes:["presentations:write"],state:"available"},{billing:"free",category:"presentations",description:"Set who can open a presentation: public, team, or private.",id:"updatePresentationVisibility",lifecycle:{mode:"bounded"},milestone:"M4",name:"presentation visibility",operation:"mutation",scopes:["presentations:write"],state:"available"}];function jn(e){return{capabilities:Ls,catalogVersion:1,reason:e,source:"snapshot"}}async function en(e=_a){try{let{capabilities:t,catalogVersion:n}=await e();return!Array.isArray(t)||t.length===0?jn("the live catalog returned no capabilities"):{capabilities:t,catalogVersion:n,source:"live"}}catch(t){let n=t instanceof Error?t.message:String(t);return jn(n)}}import{InvalidArgumentError as Zu}from"commander";function y(e,t){return n=>{if(t.includes(n))return n;throw new Zu(`Expected one of: ${t.join(", ")}. Run the command with --help to see what ${e} accepts.`)}}var Us=["presentations","media","branding","knowledge","research","artifacts","agents","support"],tp=80,np=30;function rp(e){return e.billing!==void 0&&e.billing!=="free"&&e.billing!=="quota"}function op(e){return e.lifecycle?.mode==="background"}function ip(e,t){if(t<=0)return[e];let n=[],r="";for(let o of e.split(/\s+/).filter(Boolean))r===""?r=o:r.length+1+o.length<=t?r=`${r} ${o}`:(n.push(r),r=o);return r!==""&&n.push(r),n.length>0?n:[""]}function _s(e){let t=Us.indexOf(e);return t===-1?Us.length:t}function ap(e,t){let n=t.search?.trim().toLowerCase(),r=t.category?.trim().toLowerCase();return e.filter(o=>r&&(o.category??"").toLowerCase()!==r?!1:n?`${o.name} ${o.description??""}`.toLowerCase().includes(n):!0)}function sp(e){let t=new Map;for(let i of e){let c=i.category??"other",d=t.get(c);d?d.push(i):t.set(c,[i])}let n=[...t.entries()].sort(([i],[c])=>{let d=_s(i)-_s(c);return d!==0?d:i.localeCompare(c)}),r=Math.min(np,Math.max(...e.map(i=>i.name.length))),o=[];for(let[i,c]of n){c.sort((d,u)=>d.name.localeCompare(u.name)),o.length>0&&o.push(""),o.push(tn.bold(`${i} (${c.length})`));for(let d of c){let u=`${rp(d)?"$":" "}${op(d)?"*":" "}`,g=d.name.padEnd(r),w=2+r+1+u.length+1,v=Math.max(24,tp-w),x=ip(d.description??"",v);o.push(` ${tn.cyan(g)} ${tn.yellow(u)} ${x[0]??""}`.trimEnd());for(let T of x.slice(1))o.push(`${" ".repeat(w)}${T}`)}}return o}function dp(e){return e.map(t=>`${t.name} ${t.state} ${t.milestone}`)}function cp(e,t={filtered:!1}){if(e.length===0)return[t.filtered?"No capabilities match that filter.":"No capabilities available."];if(!e.some(i=>i.description||i.category))return dp(e);let r=p.commands[0],o=sp(e);return o.push(""),o.push(tn.dim(`${e.length} capabilities \xB7 $ = paid \xB7 * = background (returns a run id)`)),o.push(tn.dim(`Filter with: ${r} capabilities --search <query>`)),o}var qs=new ep("capabilities").description("Index of everything this CLI can do \u2014 every command, grouped and described").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").option("-s, --search <query>","Only show capabilities matching a query").option("--category <name>","Only show one category").action(async e=>{try{let t=await en(),n=ap(t.capabilities,e),r=!!(e.search||e.category);if(e.format==="json"){l({capabilities:n,catalogVersion:t.catalogVersion,source:t.source,...t.reason?{sourceReason:t.reason}:{}});return}if(e.format==="quiet"){for(let o of n)console.log(o.name);return}t.source==="snapshot"&&L(`Showing the capability list baked into this CLI build (${t.reason}); the deployed catalog may have moved on.`);for(let o of cp(n,{filtered:r}))console.log(o)}catch(t){a(t instanceof Error?t.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}});import{mkdirSync as pp,writeFileSync as gp}from"fs";import{dirname as Bs,join as fp}from"path";import{Command as qe}from"commander";import nn from"chalk";import{input as hp,password as yp,confirm as Fs,select as bp}from"@inquirer/prompts";import Mn from"ora";import lp from"conf";var Vn=new lp({projectName:"conceptcraft",configName:"feature-cache"}),mp=3600*1e3,up=1440*60*1e3;function js(e){let t=0;for(let n=0;n<e.length;n++){let r=e.charCodeAt(n);t=(t<<5)-t+r,t=t&t}return t.toString(16)}function Vs(){if(!ft())return null;let e=Vn.get("featureFlags");if(!e)return null;let t=js(Pe());if(e.apiKeyHash&&e.apiKeyHash!==t)return nt(),null;let n=Date.now()-e.fetchedAt;return n>up?null:(n>mp&&fo(),e.flags)}function fo(){tt().catch(()=>{})}async function tt(){let e=await Xa(),t=Pe();return Vn.set("featureFlags",{flags:e,fetchedAt:Date.now(),apiKeyHash:t?js(t):void 0}),e}function nt(){Vn.delete("featureFlags")}function Ms(){return Vn.path}var Gs=new qe("config").description("Manage CLI configuration: account settings, and the cached feature flags that decide which commands appear").addCommand(new qe("init").description("Initialize configuration interactively").action(async()=>{console.log(),console.log(nn.bold(`${p.displayName} CLI Configuration`)),console.log(nn.gray("\u2500".repeat(35))),console.log();try{let e=await yp({message:"Enter your API key:",mask:"*",validate:r=>!r||r.trim().length===0?"API key is required":no(r.trim())?!0:"Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"});if(Yr(e.trim()),await Fs({message:`Use a custom API URL? (default: ${p.apiUrl.replace("https://","")})`,default:!1})){let r=await hp({message:"Enter API URL:",default:B(),validate:o=>{try{return new URL(o),!0}catch{return"Invalid URL format"}}});Qr(r)}console.log();let n=Mn("Verifying API key...").start();try{let r=await Ee();if(n.succeed("API key verified!"),console.log(),b(`Logged in as: ${r.user.email}`),r.teams.length===0)L("No teams found for this user.");else if(r.teams.length===1){let o=r.teams[0];gt(o.id),b(`Team: ${o.name} (${o.planName})`)}else{console.log(),b(`You have access to ${r.teams.length} teams.`);let o=await bp({message:"Select your default team:",choices:r.teams.map(c=>({name:`${c.name} (${c.planName}) - ${c.role}${c.isCurrent?" [current]":""}`,value:c.id})),default:r.currentTeam?.id});gt(o);let i=r.teams.find(c=>c.id===o);k(`Selected team: ${i?.name}`)}try{await tt()}catch{}}catch(r){n.fail("Failed to verify API key"),L(`Could not verify API key: ${r instanceof Error?r.message:String(r)}`),L(`You may need to set the team ID manually: ${p.commands[0]} config set team-id <id>`)}console.log(),k("Configuration saved!"),b(`Config file: ${Zt()}`),console.log()}catch(e){if(e.name==="ExitPromptError"){console.log(),b("Configuration cancelled.");return}throw e}})).addCommand(new qe("show").description("Show current configuration").option("--verify","Verify API key and show team details").action(async e=>{let t=ga();if(ve("Current Configuration"),console.log(),C("API Key",Ea()??nn.red("Not set")),C("API URL",t.apiUrl),C("Default Team ID",t.defaultTeamId??nn.gray("Not set")),console.log(),C("Config file",Zt()),e.verify&&t.apiKey){console.log();let n=Mn("Verifying...").start();try{let r=await Ee();n.succeed("Verified"),console.log(),C("User",r.user.email),r.currentTeam&&C("Current Team",`${r.currentTeam.name} (${r.currentTeam.planName})`),r.teams.length>1&&C("Total Teams",String(r.teams.length))}catch(r){n.fail("Verification failed"),L(r instanceof Error?r.message:String(r))}}console.log()})).addCommand(new qe("set").description("Set a configuration value").argument("<key>","Configuration key (api-key, api-url, team-id)").argument("<value>","Value to set").action(async(e,t)=>{switch(e){case"api-key":no(t)||(a("Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"),process.exit(6)),Yr(t),nt(),k("API key updated"),tt().catch(()=>{});break;case"api-url":try{new URL(t),Qr(t),k(`API URL set to: ${t}`)}catch{a("Invalid URL format"),process.exit(6)}break;case"team-id":gt(t),k(`Default team ID set to: ${t}`);break;default:a(`Unknown config key: ${e}`),console.log(nn.gray("Valid keys: api-key, api-url, team-id")),process.exit(6)}})).addCommand(new qe("clear").description("Clear all configuration").action(async()=>{try{await Fs({message:"Are you sure you want to clear all configuration?",default:!1})?(On(),nt(),k("Configuration cleared")):b("Cancelled")}catch{b("Cancelled")}})).addCommand(new qe("refresh").description("Refresh cached feature flags").action(async()=>{let e=Mn("Refreshing feature flags...").start();try{await tt(),e.succeed("Feature flags refreshed"),b(`Run '${p.commands[0]} --help' to see updated commands`)}catch(t){e.fail("Failed to refresh"),a(t instanceof Error?t.message:String(t)),process.exit(1)}})).addCommand(new qe("path").description("Show configuration file path").option("--cache","Show feature cache file path").action(e=>{e.cache?console.log(Ms()):console.log(Zt())})).addCommand(new qe("pull").description("Pull your account settings (memory, brand, prefs) into a local config.toml").action(async()=>{let e=Mn("Pulling settings...").start();try{let t=await Ie(),n=await fetch(`${B()}/api/cli/settings`,{headers:t});if(!n.ok)throw new Error(`Request failed (HTTP ${n.status})`);let r=await n.text(),o=fp(Bs(Zt()),"settings.toml");pp(Bs(o),{recursive:!0}),gp(o,r,"utf8"),e.succeed("Settings pulled"),b(`Written to ${o}`)}catch(t){e.fail("Failed to pull settings"),a(t instanceof Error?t.message:String(t)),process.exit(1)}}));import{Command as vp}from"commander";import{confirm as Ip}from"@inquirer/prompts";import{createHash as wp}from"crypto";function z(e){let t=wp("sha256").update(JSON.stringify({command:e.command,payload:ho(e.payload),workspaceId:e.workspaceId})).digest("hex");return`cli:${e.command.trim().toLowerCase().replace(/[^a-z0-9._:-]+/g,"-").replace(/^-+|-+$/g,"")||"command"}:${t}`}function ho(e){return Array.isArray(e)?e.map(ho):!e||typeof e!="object"?e:Object.fromEntries(Object.entries(e).filter(([,t])=>t!==void 0).sort(([t],[n])=>t.localeCompare(n)).map(([t,n])=>[t,ho(n)]))}var Ks=new vp("delete").description("Delete a presentation").argument("<slug>","Presentation slug (e.g., my-presentation-v1-abc123)").option("-y, --yes","Confirm permanent deletion without prompting").option("-f, --force","Deprecated alias for --yes").option("--team-id <id>","Workspace ID (uses configured default)").option("--idempotency-key <key>","Stable key to safely retry this deletion").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("-q, --quiet","Suppress output").action(async(e,t)=>{if(await h(),!t.yes&&!t.force)try{if(!await Ip({message:`Are you sure you want to delete presentation "${e}"?`,default:!1})){t.quiet||L("Deletion cancelled");return}}catch{t.quiet||L("Deletion cancelled");return}let n=t.teamId??te(),r=t.idempotencyKey??z({command:"presentation:delete",payload:{slug:e},workspaceId:n??"configured-default"});try{await Fa(e,{approvalReceipt:t.approvalReceipt,idempotencyKey:r,teamId:n}),t.quiet||k(`Presentation "${e}" deleted`)}catch(o){o.errorCode==="approval_required"&&L(`Retry with --idempotency-key ${r}`),a(o instanceof Error?o.message:String(o)),process.exit(o.exitCode??1)}});import{Command as wt}from"commander";import Js from"chalk";import kp from"ora";import{createParser as wS}from"eventsource-parser";import IS from"chalk";import xS from"ora";async function Ws(e,t={}){let n=e.body?.getReader();if(!n)throw new Error("Response body is not readable");let r=new TextDecoder,o="",i=!1;for(;!i;){let c=await n.read();if(i=c.done,c.value){let d=r.decode(c.value,{stream:!0});o+=d,t.quiet||process.stdout.write(d)}}return t.quiet||console.log(),o}function xp(){return new wt("blog").description("Generate a blog post from a presentation").argument("<slug>","Presentation slug").option("--words <count>","Target word count (50-2000)","300").option("--tone <tone>","Writing tone (professional, casual, educational)","professional").option("--audience <text>","Target audience description").option("-f, --format <format>","Output format (human, json, markdown)",y("--format",["human","json","markdown"]),"human").option("--instructions <text>","Custom instructions for the blog").option("--no-images","Exclude image references").option("--toc","Include table of contents").action(async(e,t)=>{await h();let n=parseInt(t.words,10);(Number.isNaN(n)||n<50||n>2e3)&&(a("Word count must be between 50 and 2000"),process.exit(6));let r=["professional","casual","educational"];r.includes(t.tone)||(a(`Invalid tone. Valid options: ${r.join(", ")}`),process.exit(6));let o=kp("Fetching presentation...").start();try{let i=await bt(e);o.text="Generating blog post...";let c=await Ya(i.id,i.documentCreatedAt||i.createdAt,{targetWordCount:n,tone:t.tone,targetAudience:t.audience??"General Audience",customInstructions:t.instructions??"",includeImages:!t.noImages,includeTableOfContents:t.toc??!1}),d=await Ws(c,{quiet:!0});o.succeed("Blog generated"),t.format==="json"?console.log(JSON.stringify({presentationId:e,title:i.title,wordCount:n,tone:t.tone,content:d},null,2)):t.format==="markdown"?console.log(d):(console.log(),console.log(Js.bold(`Blog: ${i.title}`)),console.log(Js.gray("\u2500".repeat(40))),console.log(),console.log(d),console.log())}catch(i){o.fail("Generation failed"),a(i instanceof Error?i.message:String(i)),process.exit(i.exitCode??1)}})}function Rp(){return new wt("tweets").description("Generate tweets from a presentation").argument("<slug>","Presentation slug").option("--count <n>","Number of tweets to generate","5").option("-f, --format <format>","Output format (human, json)",y("--format",["human","json"]),"human").action(async(e,t)=>{await h(),b("Tweet generation coming soon.")})}function Cp(){return new wt("linkedin").description("Generate a LinkedIn carousel from a presentation").argument("<slug>","Presentation slug").option("-f, --format <format>","Output format (human, json)",y("--format",["human","json"]),"human").action(async e=>{await h(),b("LinkedIn carousel generation coming soon.")})}function Sp(){return new wt("questions").description("Generate questions for a presentation").argument("<slug>","Presentation slug").option("--count <n>","Number of questions","10").option("-f, --format <format>","Output format (human, json)",y("--format",["human","json"]),"human").action(async(e,t)=>{await h(),b("Question generation coming soon.")})}function Ep(){return new wt("cheatsheet").description("Generate a presenter cheat sheet").argument("<slug>","Presentation slug").option("--mode <mode>","Cheat sheet mode (qa-prep, talking-points)","qa-prep").option("-f, --format <format>","Output format (human, json, markdown)",y("--format",["human","json","markdown"]),"human").action(async(e,t)=>{await h(),b("Cheat sheet generation coming soon.")})}function zs(){let e=new wt("derive").description("Generate derivative content from a presentation"),t=Vs();return t&&(t.deckToBlog&&e.addCommand(xp()),t.deckToTweets&&e.addCommand(Rp()),t.linkedInCarousel&&e.addCommand(Cp()),t.redTeamQuestions&&e.addCommand(Sp()),t.presenterCheatSheet&&e.addCommand(Ep())),e}import{Command as Tp}from"commander";import yo from"chalk";var Hs=new Tp("ideas").description("Generate presentation topic ideas").option("--context <text>","Custom context for idea generation").option("--count <n>","Number of ideas to generate","5").option("-f, --format <format>","Output format (human, json)",y("--format",["human","json"]),"human").action(async e=>{await h(),b("Idea generation is available in the web dashboard."),console.log(),console.log(yo.gray("The CLI will support idea generation in a future release.")),console.log(),console.log("For now, try these approaches:"),console.log(yo.gray("` 1. Visit the ${brand.displayName} dashboard and use the idea generator`")),console.log(yo.gray(" 2. Create a presentation with a broad topic and refine it")),console.log()});import{Command as $p}from"commander";import{readFile as Ap}from"fs/promises";import{resolve as Pp,basename as Op}from"path";import Dp from"ora";var Xs=new $p("import").description("Import a presentation from ZIP (admin only)").argument("<file>","Path to ZIP file");Xs._hidden=!0;var Ys=Xs.option("--dry-run","Validate without importing").option("--overwrite","Overwrite existing presentations").option("--remap-ids","Generate new IDs (default: true)",!0).action(async(e,t)=>{await h();try{(await Ee()).user.role!=="admin"&&(a("This command is only available to administrators"),process.exit(2))}catch{a("Failed to verify permissions"),process.exit(2)}let n=Pp(e),r=Op(n);r.endsWith(".zip")||(a("File must be a ZIP archive"),process.exit(6));let o=Dp("Reading file...").start();try{let i=await Ap(n);t.dryRun?o.text="Validating...":o.text="Importing presentation...";let c=await Ja(i,r,{dryRun:t.dryRun});if(c.success){if(t.dryRun)o.succeed("Validation passed!"),console.log(),b("The file is valid and can be imported."),c.statistics&&(console.log(),C("Slides",String(c.statistics.slidesImported)),C("Images",String(c.statistics.imagesUploaded)));else if(o.succeed("Import complete!"),console.log(),C("Presentation ID",c.presentationId??"N/A"),C("Document ID",c.documentId??"N/A"),c.statistics&&(C("Slides imported",String(c.statistics.slidesImported)),C("Images uploaded",String(c.statistics.imagesUploaded)),C("Time",`${c.statistics.totalTimeMs}ms`)),c.presentationId){let d=B();C("View URL",`${d}/p/${c.presentationId}`)}if(c.warnings&&c.warnings.length>0){console.log();for(let d of c.warnings)L(d)}console.log()}else{if(o.fail("Import failed"),console.log(),c.errors)for(let d of c.errors)a(`${d.type}: ${d.message}`);process.exit(1)}}catch(i){o.fail("Import failed"),i.code==="ENOENT"&&(a(`File not found: ${n}`),process.exit(3)),a(i instanceof Error?i.message:String(i)),process.exit(i.exitCode??1)}});import{Command as Np}from"commander";function bo(){return new Np("list").description("List presentations").option("-n, --limit <count>","Number of results to return","20").option("--offset <count>","Zero-based result offset","0").option("--sort <field>","Sort by field (updated, created, title)",y("--sort",["updated","created","title"]),"updated").option("--team-id <id>","Team ID (uses default if not specified)").option("--json","Output machine-readable JSON").action(async e=>{await h();let t=parseInt(e.limit,10);(Number.isNaN(t)||t<1||t>50)&&(a("Invalid limit value (expected 1-50)"),process.exit(6));let n=parseInt(e.offset,10);(Number.isNaN(n)||n<0||n>1e4)&&(a("Invalid offset value (expected 0-10000)"),process.exit(6));let r=e.teamId??te();r||(a("Team ID required. Set a default with 'mf config set team-id <id>' or use --team-id"),process.exit(6));try{let o=await Ma(r,t,n,e.sort);if(o.length===0){e.json?console.log(JSON.stringify([])):b("No presentations found");return}console.log(e.json?JSON.stringify(o,null,2):ka(o))}catch(o){a(o instanceof Error?o.message:String(o));let i=typeof o=="object"&&o!==null&&"exitCode"in o&&typeof o.exitCode=="number"?o.exitCode:1;process.exit(i)}})}var Qs=bo();import{createHash as Lp,randomBytes as td}from"crypto";import nd from"http";import Zs from"chalk";import{Command as Up}from"commander";import _p from"open";import ed from"ora";var qp=`${p.displayName} CLI`,jp=8765,Vp=8775,Mp=["presentations:read","presentations:write","brands:read","brands:write","media:read","media:write"];function Bp(){return td(32).toString("base64url")}function Fp(e){return Lp("sha256").update(e).digest("base64url")}function Gp(){return td(16).toString("hex")}async function Kp(e,t){for(let n=e;n<=t;n++)try{return await new Promise((r,o)=>{let i=nd.createServer();i.listen(n,()=>{i.close(()=>r())}),i.on("error",o)}),n}catch{}throw new Error(`No available port found between ${e} and ${t}`)}async function Wp(e){let t=await fetch(`${e}/.well-known/oauth-authorization-server`);if(!t.ok)throw new Error(`Failed to fetch OAuth metadata: ${t.status}`);return t.json()}function Jp(e){let t=e.scopes_supported?.filter(n=>typeof n=="string"&&n.trim().length>0);return(t?.length?t:Mp).join(" ")}function zp(e,t){if(!t?.trim())return Jp(e);let n=t.split(",").map(o=>o.trim()).filter(Boolean);if(n.length===0)throw new Error("--scopes must include at least one OAuth scope");let r=e.scopes_supported?.filter(o=>typeof o=="string"&&o.trim().length>0);if(r?.length){let o=n.filter(i=>!r.includes(i));if(o.length>0)throw new Error(`Unsupported OAuth scope${o.length===1?"":"s"}: ${o.join(", ")}`)}return n.join(" ")}async function Hp(e,t,n){let r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({client_name:qp,redirect_uris:[t],grant_types:["authorization_code","refresh_token"],response_types:["code"],token_endpoint_auth_method:"none",scope:n})});if(!r.ok){let o=await r.text();throw new Error(`Client registration failed: ${o}`)}return r.json()}async function Xp(e,t,n,r,o){let i=new URLSearchParams({grant_type:"authorization_code",code:t,redirect_uri:r,client_id:o,code_verifier:n}),c=await fetch(e,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:i.toString()});if(!c.ok){let d=await c.text();throw new Error(`Token exchange failed: ${d}`)}return c.json()}function Yp(e,t){return new Promise((n,r)=>{let o,i=!1,c=()=>{i||(i=!0,clearTimeout(o),process.off("SIGINT",d),process.off("SIGTERM",d),u.close())},d=()=>{c(),r(new Error("Login cancelled"))},u=nd.createServer((g,w)=>{let v=new URL(g.url||"",`http://localhost:${e}`);if(v.pathname!=="/callback"){w.writeHead(404),w.end("Not found");return}let x=v.searchParams.get("code"),T=v.searchParams.get("state"),A=v.searchParams.get("error"),S=v.searchParams.get("error_description");if(w.writeHead(200,{"Content-Type":"text/html"}),A){w.end(`
|
|
5
5
|
<!DOCTYPE html>
|
|
6
6
|
<html>
|
|
7
7
|
<head><title>Login Failed</title></head>
|
|
@@ -11,7 +11,7 @@ var g={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"C
|
|
|
11
11
|
<p>You can close this window.</p>
|
|
12
12
|
</body>
|
|
13
13
|
</html>
|
|
14
|
-
`),
|
|
14
|
+
`),c(),r(new Error(S||A));return}if(!x||!T){w.end(`
|
|
15
15
|
<!DOCTYPE html>
|
|
16
16
|
<html>
|
|
17
17
|
<head><title>Login Failed</title></head>
|
|
@@ -21,7 +21,7 @@ var g={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"C
|
|
|
21
21
|
<p>You can close this window.</p>
|
|
22
22
|
</body>
|
|
23
23
|
</html>
|
|
24
|
-
`),
|
|
24
|
+
`),c(),r(new Error("Missing authorization code or state"));return}if(T!==t){w.end(`
|
|
25
25
|
<!DOCTYPE html>
|
|
26
26
|
<html>
|
|
27
27
|
<head><title>Login Failed</title></head>
|
|
@@ -31,7 +31,7 @@ var g={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"C
|
|
|
31
31
|
<p>You can close this window.</p>
|
|
32
32
|
</body>
|
|
33
33
|
</html>
|
|
34
|
-
`),
|
|
34
|
+
`),c(),r(new Error("State mismatch"));return}w.end(`
|
|
35
35
|
<!DOCTYPE html>
|
|
36
36
|
<html>
|
|
37
37
|
<head><title>Login Successful</title></head>
|
|
@@ -40,175 +40,189 @@ var g={id:"mindframes",name:"mindframes",displayName:"Mindframes",description:"C
|
|
|
40
40
|
<p>You can close this window and return to the terminal.</p>
|
|
41
41
|
</body>
|
|
42
42
|
</html>
|
|
43
|
-
`),
|
|
44
|
-
`)[0]??"";n(
|
|
43
|
+
`),c(),n({code:x,state:T})});u.listen(e),process.once("SIGINT",d),process.once("SIGTERM",d),o=setTimeout(()=>{c(),r(new Error("Login timed out - no callback received within 5 minutes"))},300*1e3)})}async function Qp(e,t){let n=await fetch(`${e}/api/cli/whoami`,{headers:{Authorization:`Bearer ${t}`}});if(!n.ok)throw new Error(`Failed to fetch user info: ${n.status}`);return n.json()}async function Zp(e){let t=B(),n=ed("Discovering OAuth server...").start();try{let r=await Wp(t),o=zp(r,e.scopes);n.succeed(`Connecting to ${t}`);let i=await Kp(jp,Vp),c=`http://localhost:${i}/callback`;console.log(`Redirect URI: ${c}`),console.log(`Authorization endpoint: ${r.authorization_endpoint}`),console.log(`Token endpoint: ${r.token_endpoint}`),console.log(`Registration endpoint: ${r.registration_endpoint}`);let d=await Hp(r.registration_endpoint,c,o),u=d.client_id;va(u,d.client_secret);let g=Bp(),w=Fp(g),v=Gp(),x=new URLSearchParams({client_id:u,redirect_uri:c,response_type:"code",scope:o,state:v,code_challenge:w,code_challenge_method:"S256"}),T=`${r.authorization_endpoint}?${x}`;console.log(`Authorization URL: ${T}`),e.browser?(b("Opening browser..."),await _p(T)):(console.log(Zs.bold("Open this URL in your browser:")),console.log(Zs.cyan(T)));let A=Yp(i,v),{code:S}=await A;n=ed("Completing login...").start();let $=await Xp(r.token_endpoint,S,g,c,u);Dn($.access_token,$.refresh_token,$.expires_in);let E=await Qp(t,$.access_token);n.succeed("Logged in!"),console.log(),C("Logged in as",E.user.email),E.currentTeam&&(gt(E.currentTeam.id),C("Team",`${E.currentTeam.name} (${E.currentTeam.planName})`));try{await tt()}catch{}console.log(),k("You're all set!"),console.log()}catch(r){throw n.fail("Login failed"),a(r instanceof Error?r.message:String(r)),r}}var rd=new Up("login").description(`Authenticate with ${p.displayName} (opens browser)`).option("--no-browser","Print URL instead of opening browser").option("--scopes <scopes>","Comma-separated OAuth scopes to request (defaults to all server-supported scopes)").action(async e=>{console.log(),Qe()&&(L("You are already logged in."),b(`Run '${p.commands[0]} logout' to log out first, or continue to re-authenticate.`),console.log());try{await Zp(e),process.exit(0)}catch{process.exit(1)}});import{Command as eg}from"commander";import{confirm as tg}from"@inquirer/prompts";var od=new eg("logout").description("Log out and clear authentication").option("--all","Clear all config including API key").action(async e=>{console.log();let t=Qe(),n=ft();if(!t&&!n){L("You are not logged in."),console.log();return}if(e.all)try{await tg({message:"Clear all configuration including API key?",default:!1})?(On(),nt(),k("All configuration cleared.")):b("Cancelled.")}catch{b("Cancelled.")}else Nn(),nt(),k("Logged out successfully."),n&&b("Note: Your API key is still configured. Use --all to clear everything.");console.log()});import{homedir as Vg}from"os";import{join as Mg}from"path";import ke from"chalk";import{Command as Bg}from"commander";import{spawn as ng}from"child_process";import{existsSync as rg,readdirSync as og}from"fs";import{homedir as sd}from"os";import{delimiter as id}from"path";import{query as ig}from"@anthropic-ai/claude-agent-sdk";function ge(e){if(e===void 0)return null;if(typeof e=="string")return e.length>12e3?`${e.slice(0,12e3)}\u2026`:e;try{let t=JSON.stringify(e);return t.length<=12e3?e:{preview:`${t.slice(0,12e3)}\u2026`,truncated:!0}}catch{return String(e).slice(0,12e3)}}function Bn(e){let t=typeof e=="string"?e:String(e??"");return t.length>12e3?`${t.slice(0,12e3)}\u2026`:t}function fe(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:{}}function q(e){return typeof e=="string"?e:""}function ad(e,t){let n=e.replace(/[/.]/g,"-");return`${sd()}/.claude/projects/${n}/${t}.jsonl`}function ag(e){try{return og(`${e}/.nvm/versions/node`).map(t=>`${e}/.nvm/versions/node/${t}/bin`).sort().reverse()}catch{return[]}}function Fn(){let e=sd(),t=[`${e}/.local/bin`,`${e}/.claude/local`,`${e}/.bun/bin`,`${e}/bin`,"/opt/homebrew/bin","/usr/local/bin",...ag(e)],r=(process.env.PATH??"").split(id);for(let o of t)r.includes(o)||r.push(o);return r.join(id)}async function Gn(e){let t=e??"claude";return new Promise(n=>{let r=ng(t,["--version"],{env:{...process.env,PATH:Fn()},stdio:["ignore","pipe","ignore"]}),o="";r.stdout.on("data",i=>{o+=i.toString("utf8")}),r.on("error",()=>n(null)),r.on("close",i=>{if(i!==0)return n(null);let c=o.trim().split(`
|
|
44
|
+
`)[0]??"";n(c?{bin:t,version:c}:null)})})}var sg=new Set(["","default","best"]);function wo(e){let t=e.filter(i=>i.text.trim());if(t.length===0)return"";let n=t[t.length-1],r=t.slice(0,-1);return r.length===0?n.text:`<conversation-history>
|
|
45
45
|
${r.map(i=>`${i.role==="assistant"?"Assistant":"User"}: ${i.text}`).join(`
|
|
46
46
|
|
|
47
47
|
`)}
|
|
48
48
|
</conversation-history>
|
|
49
49
|
|
|
50
|
-
${n.text}`}function
|
|
51
|
-
`)[0]??"";
|
|
52
|
-
`)}catch{return[]}let n=new Set,r=new Map,o=null;for(let i of
|
|
53
|
-
`);return
|
|
54
|
-
`):
|
|
55
|
-
`):""}function
|
|
56
|
-
|
|
57
|
-
`),usage:
|
|
58
|
-
`,"utf8")}catch{}}function
|
|
59
|
-
`,"utf8")}catch{}}var
|
|
60
|
-
Stopping runner\u2026`)),e.abort()};process.on("SIGINT",n),process.on("SIGTERM",n);try{await Qs({claudeBin:t.claudeBin,codexBin:t.codexBin,log:r=>console.log(ye.gray(`[runner] ${r}`)),once:t.once,signal:e.signal,version:"0.3.24",workspaceRoot:t.workspace??rg()})}catch(r){console.error(ye.red(r instanceof Error?r.message:String(r))),process.exit(1)}});import Z from"chalk";import{Command as Cx}from"commander";import{Command as ho}from"commander";function og(t,e){return[...e,t]}var ig=new ho("create").description("Start durable ad-set generation").argument("<title>","Ad-set title").requiredOption("--brief <brief>","Campaign brief").option("--hook <text>","Opening hook (repeat)",og,[]).option("--style <style>","ugc, clean, cinematic, or testimonial","ugc").option("--branding-id <id>","Branding ID").option("--team-id <id>","Workspace ID").option("--yes","Approve generation").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to approve generation");try{l(await m("createAdSet",{approvalReceipt:"cli:--yes",brandingId:e.brandingId,brief:e.brief,hooks:e.hook.length?e.hook:[e.brief],style:e.style,teamId:e.teamId,title:t}))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(d.GENERAL_ERROR)}}),ag=new ho("status").description("Read ad-set generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await I("createAdSet",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Zs=new ho("ad-set").description("Generate a set of ad creatives (hooks, copy, visuals) from a campaign brief").addCommand(ig).addCommand(ag);import{randomUUID as rd}from"crypto";import{readFileSync as od}from"fs";import{readFile as mg}from"fs/promises";import{Command as be}from"commander";import{randomUUID as sg}from"crypto";function Te(t,e){a(t instanceof Error?t.message:e),process.exit(t instanceof D?t.exitCode:d.GENERAL_ERROR)}function zt(t){return`cli:agent-management:${t}:${sg()}`}function ut(t,e){let n=Number(t);if(!Number.isInteger(n)||n<=0)throw new Error(`${e} must be a positive integer`);return n}import{Command as Ht}from"commander";var dg=new Ht("list").description("List one roster page: your Agents plus teammates' team-visible Agents").option("--cursor <cursor>","Continue from a previous nextCursor").option("--page-size <n>","Roster rows to return (1-100)","50").option("--team-id <id>","Workspace ID").action(async t=>{try{l(await m("listAgentRoster",{cursor:t.cursor,pageSize:ut(t.pageSize,"--page-size"),teamId:t.teamId}))}catch(e){Te(e,"Could not list the Agent roster")}}),cg=new Ht("get").description("Read one roster-visible Agent card without private configuration").argument("<agent-id>","Roster-visible Agent UUID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("getRosterAgent",{agentId:t,teamId:e.teamId}))}catch(n){Te(n,"Could not read the roster Agent")}}),ed=new Ht("roster").description("Discover Agents shared inside the current workspace; never cross-workspace").addCommand(dg).addCommand(cg),lg=new Ht("set").description("Share an owned Agent with the workspace or make it private").argument("<agent-id>","Owned scheduled Agent UUID").argument("<visibility>","Desired visibility: private or team",b("visibility",["private","team"])).requiredOption("--expected-visibility <visibility>","Current value from agent roster get: private, team, or legacy public",b("--expected-visibility",["private","team","public"])).option("--idempotency-key <key>","Reuse only for an exact retry of this visibility change").option("--team-id <id>","Workspace ID").action(async(t,e,n)=>{try{l(await m("setAgentVisibility",{agentId:t,expectedVisibility:n.expectedVisibility,teamId:n.teamId,visibility:e},n.idempotencyKey?.trim()||zt("visibility")))}catch(r){Te(r,"Could not change Agent visibility")}}),td=new Ht("visibility").description("Control whether an owned Agent is private or team-visible").addCommand(lg);function pt(t,e){return[...e,t]}function ug(t){let e=Number(t);if(!Number.isInteger(e)||e<1)throw new Error("Expected a positive integer.");return e}async function Fn(t,e){let n=e.trim(),r=n.startsWith("{")?n:await mg(n,"utf8"),o=JSON.parse(r);if(!o||typeof o!="object"||Array.isArray(o))throw new Error(`${t} must contain one JSON object.`);return o}var pg=new be("create").description("Activate a reviewed Agent draft; get browser approval, then retry with the same key and receipt.").argument("<draft-id>","Reviewed agent draft UUID").requiredOption("--expected-version <number>","Exact draft version shown during review",ug).requiredOption("--idempotency-key <key>","Stable key bound into the approval receipt and reused on retry").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL").option("--yes","Confirm activation intent; this never substitutes for the approval receipt").option("--team-id <id>","Workspace ID").action(async(t,e)=>{e.yes||(a("Pass --yes to request activation. A server-issued approval receipt is still required."),process.exit(d.INVALID_INPUT)),await id("Agent activation failed",()=>m("createAgent",{approvalReceipt:e.approvalReceipt,draftId:t,expectedVersion:e.expectedVersion,teamId:e.teamId},e.idempotencyKey))}),gg=new be("recommend").description("Save a private inactive scheduled-agent draft for review; this command never activates or runs it.").argument("<name>","Agent name").requiredOption("--instructions <markdown>","Standing agent instructions").option("--description <text>","Agent description","").option("--goal <text>","User-visible recurring objective").option("--rationale <text>","Why this draft is being recommended").option("--schedule <frequency>","manual, daily, weekdays, weekly, or monthly").option("--schedule-r-rule <rrule>","Precise recurrence rule").option("--schedule-time <hh:mm>","Local run time").option("--timezone <zone>","IANA timezone").option("--schedule-config <json-or-path>","Full schedule configuration as inline JSON or a JSON file").option("--source <connector>","Source connector (repeatable)",pt,[]).option("--x-handle-target <handle>","Target for the x_handle source").option("--x-search-target <query>","Query for the x_search source").option("--primary-output <adapter>","Legacy primary output fallback").option("--output <adapter>","Output adapter (repeatable)",pt,[]).option("--output-config <json-or-path>","Full output slot configuration (repeatable)",pt,[]).option("--delivery-adapter <adapter>","Delivery adapter").option("--delivery-config <json-or-path>","Full delivery configuration as inline JSON or a JSON file").option("--review-policy <policy>","manual_review, auto_send, or draft_only","manual_review").option("--runtime <json-or-path>","Scheduled runtime configuration as inline JSON or a JSON file").option("--sandbox-blueprint-id <id>","Sandbox blueprint UUID").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await id("Agent recommendation failed",async()=>m("recommendAgent",{deliveryAdapter:e.deliveryAdapter,deliveryConfig:e.deliveryConfig?await Fn("--delivery-config",e.deliveryConfig):void 0,description:e.description,goal:e.goal,instructionsMarkdown:e.instructions,name:t,outputAdapter:e.primaryOutput,outputAdapters:e.output.length?e.output:void 0,outputConfigs:e.outputConfig.length?await Promise.all(e.outputConfig.map(n=>Fn("--output-config",n))):void 0,rationale:e.rationale,reviewPolicy:e.reviewPolicy,runtime:e.runtime?await Fn("--runtime",e.runtime):void 0,sandboxBlueprintId:e.sandboxBlueprintId,schedule:e.schedule,scheduleConfig:e.scheduleConfig?await Fn("--schedule-config",e.scheduleConfig):void 0,scheduleRRule:e.scheduleRRule,scheduleTime:e.scheduleTime,sourceConnectors:e.source.length?e.source:void 0,teamId:e.teamId,timezone:e.timezone,xHandleTarget:e.xHandleTarget,xSearchTarget:e.xSearchTarget},e.idempotencyKey??rd()))});async function id(t,e){try{l(await e())}catch(n){if(n instanceof D){let r=`[${n.errorCode}] `;console.error(JSON.stringify({error:{code:n.errorCode,message:n.message.startsWith(r)?n.message.slice(r.length):n.message,retryable:n.retryable},ok:!1})),process.exit(n.exitCode)}console.error(JSON.stringify({error:{code:"operation_failed",message:n instanceof Error?n.message:t,retryable:!1},ok:!1})),process.exit(d.GENERAL_ERROR)}}function fg(t,e){return t==="none"?null:ut(t,e)}function hg(t){return t==="none"?null:t}function He(t,e){let n;try{n=od(t,"utf8")}catch(r){throw new Error(`${e} could not read ${t}: ${r instanceof Error?r.message:"unknown file error"}`)}try{return JSON.parse(n)}catch(r){throw new Error(`${e} must point to valid JSON: ${r instanceof Error?r.message:"invalid JSON"}`)}}function yg(t,e){try{return od(t,"utf8")}catch(n){throw new Error(`${e} could not read ${t}: ${n instanceof Error?n.message:"unknown file error"}`)}}var bg=new be("list").description("List all owned Agents, following cursor pages to closure").option("--cursor <cursor>","Resume from a previous nextCursor").option("--page-size <n>","Rows fetched per page","50").option("--team-id <id>","Workspace ID").action(async t=>{try{let e=[],n=t.cursor;for(;;){let r=await m("listAgents",{cursor:n,pageSize:ut(t.pageSize,"--page-size"),teamId:t.teamId});if(e.push(...r.agents),!r.hasMore||!r.nextCursor)break;n=r.nextCursor}l({agents:e,total:e.length})}catch(e){Te(e,"Could not list Agents")}}),wg=new be("get").description("Read one owned Agent and its complete configuration").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("getAgent",{agentId:t,teamId:e.teamId}))}catch(n){Te(n,"Could not read the Agent")}}),vg=new be("configure").description("Update Agent configuration; enable automatic external delivery in the browser").argument("<agent-id>","Scheduled Agent UUID").requiredOption("--expected-version <n>","Version returned by agent get").option("--name <text>","Agent name").option("--description <text>","Agent description").option("--goal <text>","Recurring objective").option("--instructions-file <path>","UTF-8 Markdown instructions").option("--schedule-file <path>","Typed schedule JSON document").option("--sources-file <path>","Typed source array JSON document").option("--output-file <path>","Typed primary output JSON document").option("--outputs-file <path>","Typed output array JSON document").option("--delivery-file <path>","Typed delivery JSON document").option("--review-policy <policy>","manual_review, auto_send, or draft_only").option("--runtime-file <path>","Typed runtime JSON document").option("--sandbox-blueprint-id <id|none>","Subscription sandbox blueprint, or none").option("--per-run-credit-cap <credits|none>","Positive credit ceiling, or none").option("--files-file <path>","Typed attached-file array JSON document").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("updateAgentConfiguration",{additionalFiles:e.filesFile?He(e.filesFile,"--files-file"):void 0,agentId:t,delivery:e.deliveryFile?He(e.deliveryFile,"--delivery-file"):void 0,description:e.description,expectedVersion:ut(e.expectedVersion,"--expected-version"),goal:e.goal,instructionsMarkdown:e.instructionsFile?yg(e.instructionsFile,"--instructions-file"):void 0,name:e.name,output:e.outputFile?He(e.outputFile,"--output-file"):void 0,outputs:e.outputsFile?He(e.outputsFile,"--outputs-file"):void 0,perRunCreditCap:e.perRunCreditCap===void 0?void 0:fg(e.perRunCreditCap,"--per-run-credit-cap"),reviewPolicy:e.reviewPolicy,runtime:e.runtimeFile?He(e.runtimeFile,"--runtime-file"):void 0,sandboxBlueprintId:e.sandboxBlueprintId===void 0?void 0:hg(e.sandboxBlueprintId),schedule:e.scheduleFile?He(e.scheduleFile,"--schedule-file"):void 0,sources:e.sourcesFile?He(e.sourcesFile,"--sources-file"):void 0,teamId:e.teamId},zt("configure")))}catch(n){Te(n,"Could not update the Agent")}});function nd(t){return new be(t).description(`${t==="pause"?"Pause":"Resume"} an Agent schedule`).argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").action(async(e,n)=>{try{l(await m(t==="pause"?"pauseAgentSchedule":"resumeAgentSchedule",{agentId:e,teamId:n.teamId},zt(t)))}catch(r){Te(r,`Could not ${t} the Agent schedule`)}})}function yo(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}function ad(t){return`cli:agent-memory:${t}:${rd()}`}function Ig(t,e){let n=t.indexOf("="),r=n===-1?t:t.slice(0,n),o=n===-1?"":t.slice(n+1);return[...e,{name:r.trim(),note:o.trim()}]}var xg=new be("show").description("Show what a scheduled agent remembers").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("getAgentMemory",{agentId:t,teamId:e.teamId}))}catch(n){yo(n,"Could not read the agent's memory")}}),kg=new be("set").description("Add to or remove from what an agent remembers. Owner or workspace admin only.").argument("<agent-id>","Scheduled Agent UUID").option("--learned <text>","Durable fact to add (repeatable)",pt,[]).option("--always <text>","Standing instruction to add (repeatable)",pt,[]).option("--never <text>","Thing it must not do, to add (repeatable)",pt,[]).option("--track <name=note>","Entity to track, as name=note (repeatable)",Ig,[]).option("--notes <text>","Replace the freeform notes").option("--remove <field>","Remove instead of add: learned, recurringInstructions, negativePreferences, entities, or notes").option("--value <text>","Item to remove; not needed when removing notes").option("--expected-version <n>","Refuse the write unless the stored memory is still at this version").option("--team-id <id>","Workspace ID").action(async(t,e)=>{let n=typeof e.remove=="string";try{l(await m("updateAgentMemory",{agentId:t,entities:e.track.length?e.track:void 0,expectedVersion:e.expectedVersion===void 0?void 0:Number.parseInt(e.expectedVersion,10),learned:e.learned.length?e.learned:void 0,negativePreferences:e.never.length?e.never:void 0,notes:e.notes,operation:n?"remove":"add",recurringInstructions:e.always.length?e.always:void 0,removeField:e.remove,removeValue:e.value,teamId:e.teamId},ad(n?"remove":"add")))}catch(r){yo(r,"Could not update the agent's memory")}}),Rg=new be("forget").description("Erase every stored version of an agent's memory. This cannot be undone.").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").option("--yes","Confirm the erase").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to erase this agent's memory");try{l(await m("forgetAgentMemory",{agentId:t,teamId:e.teamId},ad("forget")))}catch(n){yo(n,"Could not erase the agent's memory")}}),Cg=new be("memory").description("Read, edit, and erase what a scheduled agent remembers").addCommand(xg).addCommand(kg).addCommand(Rg),sd=new be("agent").description("Recommend, activate, configure, and manage scheduled Agents").addCommand(bg).addCommand(wg).addCommand(ed).addCommand(td).addCommand(vg).addCommand(nd("pause")).addCommand(nd("resume")).addCommand(pg).addCommand(gg).addCommand(Cg);import{Command as dd}from"commander";var bo=["article","document","microsite","presentation","presentationVideo","video"];function Sg(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}function Eg(t){if(t===void 0)return;let e=/^\s*(\d+)\s*(?:-\s*(\d+)\s*)?$/.exec(t);e||(a(`--slides expects N or N-M, got "${t}"`),process.exit(d.GENERAL_ERROR));let n=Number(e[1]),r=e[2]===void 0?n:Number(e[2]);return(n<1||r<n)&&(a(`--slides range must start at 1 and end no earlier than it starts, got "${t}"`),process.exit(d.GENERAL_ERROR)),{from:n,to:r}}var $g=new dd("read").description("Read an owned artifact's full content").argument("<kind>",`Artifact kind: ${bo.join(", ")}`).argument("<artifact-id>","Artifact id, or slug where the kind has one").option("--slides <range>","Presentations only: N or N-M. Omit to read every slide.").option("--team-id <id>","Workspace to read from").action(async(t,e,n)=>{bo.includes(t)||(a(`Unknown artifact kind "${t}". Expected one of: ${bo.join(", ")}`),process.exit(d.GENERAL_ERROR));try{let r=await m("readArtifact",{artifactId:e,kind:t,slides:Eg(n.slides),teamId:n.teamId});l(r)}catch(r){Sg(r,"Could not read the artifact")}}),cd=new dd("artifact").description("Read artifacts this workspace owns").addCommand($g);import{randomUUID as Tg}from"crypto";import{password as Ag}from"@inquirer/prompts";import{Command as Bn}from"commander";function wo(t){if(t==="claude-code"||t==="codex")return t;throw new Error("--runtime must be claude-code or codex")}function Pg(t,e){let n=t;if(e==="claude-code"&&(n==="zai-claude"||n==="anthropic-compatible")||e==="codex"&&n==="openai-responses-compatible")return n;throw new Error(e==="claude-code"?"--provider must be zai-claude or anthropic-compatible for Claude":"--provider must be openai-responses-compatible for Codex")}async function Og(){let t="";for await(let e of process.stdin)if(t+=String(e),t.length>65536)throw new Error("Credential input is too large");return t.trim()}var Dg=new Bn("add").description("Enroll a provider credential without exposing it in arguments").requiredOption("--runtime <runtime>","claude-code or codex").requiredOption("--provider <provider>","zai-claude, anthropic-compatible, or openai-responses-compatible").requiredOption("--label <name>","Profile name shown in Mindframes").requiredOption("--model <model-id>","Provider model id").option("--base-url <url>","Public HTTPS provider base URL").option("--api-key-stdin","Read the provider key from stdin instead of a hidden prompt").option("--use","Select the new profile immediately").action(async t=>{try{let e=wo(t.runtime),n=Pg(t.provider,e);if(!t.apiKeyStdin&&!process.stdin.isTTY)throw new Error("Non-interactive enrollment requires --api-key-stdin. Never pass provider keys as command arguments.");let r=t.apiKeyStdin?await Og():(await Ag({mask:"*",message:"Provider API key:"})).trim();if(!r)throw new Error("Provider API key is required");let o=await Ia({apiKey:r,...t.baseUrl?{baseUrl:t.baseUrl}:{},label:t.label,makeDefault:t.use??!1,modelId:t.model,provider:n,runtime:e});k(`Saved connection profile ${o.label} (${o.id})`)}catch(e){a(e instanceof Error?e.message:"Profile enrollment failed"),process.exit(d.GENERAL_ERROR)}}),Ng=new Bn("list").description("List secret-free Claude Code or Codex connection profiles").requiredOption("--runtime <runtime>","claude-code or codex").action(async t=>{try{let e=wo(t.runtime);l(await m("listAiConnectionProfiles",{runtime:e}))}catch(e){a(e instanceof Error?e.message:"Profile list failed"),process.exit(d.GENERAL_ERROR)}}),_g=new Bn("select").description("Select a profile UUID, or 'native' for the first-party route").requiredOption("--runtime <runtime>","claude-code or codex").requiredOption("--profile-id <id>","Profile UUID or native").option("--yes","Confirm changing the active inference route").action(async t=>{t.yes||(a("Pass --yes to confirm changing the active connection profile."),process.exit(d.INVALID_INPUT));try{let e=wo(t.runtime),n=await m("selectAiConnectionProfile",{profileId:t.profileId,runtime:e},Tg());k(n.selectedProfileId?`Selected connection profile ${n.selectedProfileId}`:"Selected the native provider route")}catch(e){a(e instanceof Error?e.message:"Profile selection failed"),process.exit(d.GENERAL_ERROR)}}),ld=new Bn("ai-connections").description("Manage Claude Code and Codex inference routes").addCommand(Dg).addCommand(Ng).addCommand(_g);import{randomUUID as pd}from"crypto";import Xt from"chalk";import{Command as Ae}from"commander";import Bg from"ora";import{existsSync as md}from"fs";import{resolve as Lg}from"path";var Ug=/^([A-Za-z][A-Za-z0-9_-]*)=(.+)$/;function jg(t){let e=t.trim();if(!e)throw new Error("A reference image value cannot be empty.");if(md(e))return{source:e};let n=Ug.exec(e);return n?{label:n[1],source:n[2]}:{source:e}}function qg(t,e,n){if(!t.startsWith("image/")&&t!=="application/octet-stream")throw new Error(`Reference image ${e} (${n}) is ${t}, not an image. A reference must be an image; pass an image file or a public image URL.`)}function Vg(t,e){let n;try{n=new URL(t)}catch(r){throw new Error(`Reference image ${e} (${t}) must be an existing local file or an HTTP(S) URL.`,{cause:r})}if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error(`Reference image ${e} (${t}) must use an HTTP(S) URL.`);return n}async function Gn(t,e){if(t?.length){if(e.maxCount!==void 0&&t.length>e.maxCount)throw new Error(`${e.maxCountSubject??"This command"} accepts at most ${e.maxCount} reference images; ${t.length} were provided.`);return Promise.all(t.map(async(n,r)=>{let o=r+1,{label:i,source:s}=jg(n);if(md(s)){let p=Lg(s),f=Tn(p);e.rejectNonImageFiles&&qg(f,o,s);let h=await de(p,{idempotencyKey:`${e.idempotencyKey}:reference:${o}`}),v=h.type||f;return{...i?{label:i}:{},...v.startsWith("image/")?{mediaType:v}:{},url:h.url}}let c=Vg(s,o);return{...i?{label:i}:{},url:c.toString()}}))}}import{mkdir as Mg,writeFile as ud}from"fs/promises";import{dirname as Fg}from"path";async function te(t,e){if(await Mg(Fg(e),{recursive:!0}),t.startsWith("data:")){let o=t.match(/^data:[^;]+;base64,(.+)$/);if(!o)throw new Error("Invalid data URL format");let i=Buffer.from(o[1],"base64");if(i.length===0)throw new Error("Downloaded media was empty");await ud(e,i);return}let n=await fetch(t);if(!n.ok)throw new Error(`Failed to download media: ${n.status}`);let r=Buffer.from(await n.arrayBuffer());if(r.length===0)throw new Error("Downloaded media was empty");await ud(e,r)}var Gg=15e3,Wg=40,Kg=3;async function gd(t,e){return(await Gn(t,{idempotencyKey:e,maxCount:Kg,maxCountSubject:"A presenter Look"}))?.map(r=>({url:r.url}))}function vo(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.videoUrl??t.requestId);return}w(`Request ID: ${t.requestId}`),w(`Status: ${t.status}`),t.durationSec!=null&&w(`Duration: ${t.durationSec}s`),t.videoUrl&&k(`Video URL: ${t.videoUrl}`),t.error&&a(`Error: ${t.error}`)}var Jg=new Ae("options").description("List available presenter avatars and voices").option("--language <language>","Filter voices by language").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{try{let e=await Ka(t.language);if(t.format==="json"){l(e);return}let n=e.personal??[];if(t.format==="quiet"){for(let r of n)console.log(r.id);for(let r of e.avatars)console.log(r.id);for(let r of e.voices)console.log(r.id);return}if(n.length>0){w("Your presenters:");for(let r of n)console.log(` ${r.id} ${r.name}`)}w("Avatars:");for(let r of e.avatars){let o=r.renderTiers?.length?` [${r.renderTiers.join(", ")}]`:"";console.log(` ${r.id} ${r.name}${o}`)}w("Voices:");for(let r of e.voices)console.log(` ${r.id} ${r.name}${r.language?` (${r.language})`:""}`)}catch(e){a(e instanceof Error?e.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),zg=new Ae("generate").description("Generate a reusable presenter clip").option("--avatar-id <id>","Avatar id from 'avatar options'; sandbox runs use the host presenter policy").option("--audio-url <url>","Public narration audio URL for avatar lip sync").option("--voice-id <id>","Voice id from 'avatar options'").option("--script <text>","Exact words for the presenter to speak").requiredOption("-o, --output <path>","Local output path").option("--aspect <aspect>","Aspect: 1:1, 9:16, 16:9","9:16").option("--duration <seconds>","Maximum requested duration (1-300)").option("--transparent","Render a transparent-background WebM presenter clip").option("--background-color <hex>","Solid presenter background color, for example #0F172A").option("--background-image-url <url>","Public image URL used as the presenter background").option("--fit <mode>","Background image fit: contain or cover").option("--output-format <container>","Container: mp4 (default) or webm \u2014 webm renders a transparent-background clip (single scene) for compositing").option("--render-tier <tier>","Render cost/quality: basic, standard, premium","basic").option("--title <title>","Clip title","Presenter clip").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.transparent?"webm":t.outputFormat;!!t.audioUrl==!!t.script&&(a("Provide exactly one avatar speech input: --audio-url or --script"),process.exit(d.INVALID_INPUT)),["1:1","9:16","16:9"].includes(t.aspect)||(a("Aspect must be one of 1:1, 9:16, or 16:9"),process.exit(d.INVALID_INPUT)),t.outputFormat!==void 0&&!["mp4","webm"].includes(t.outputFormat)&&(a("Output format must be mp4 or webm"),process.exit(d.INVALID_INPUT)),t.backgroundColor!==void 0&&!/^#[0-9a-fA-F]{6}$/.test(t.backgroundColor)&&(a("Background color must be a six-digit hex value"),process.exit(d.INVALID_INPUT)),t.backgroundColor&&t.backgroundImageUrl&&(a("Provide only one presenter background"),process.exit(d.INVALID_INPUT)),t.fit!==void 0&&!["contain","cover"].includes(t.fit)&&(a("Fit must be contain or cover"),process.exit(d.INVALID_INPUT)),t.fit&&!t.backgroundImageUrl&&(a("Fit requires --background-image-url"),process.exit(d.INVALID_INPUT)),t.transparent&&t.outputFormat==="mp4"&&(a("--transparent cannot be combined with --output-format mp4"),process.exit(d.INVALID_INPUT)),e==="webm"&&(t.backgroundColor||t.backgroundImageUrl)&&(a("Transparent WebM output cannot be combined with a background"),process.exit(d.INVALID_INPUT)),["basic","standard","premium"].includes(t.renderTier)||(a("Render tier must be basic, standard, or premium"),process.exit(d.INVALID_INPUT));let n=t.duration?Number.parseInt(t.duration,10):void 0;n!==void 0&&(!Number.isFinite(n)||n<1||n>300)&&(a("Duration must be between 1 and 300 seconds"),process.exit(d.INVALID_INPUT));let r=t.format==="human"?Bg("Generating presenter clip...").start():null;try{let o=t.audioUrl?{audioUrl:t.audioUrl}:{script:t.script??"",...t.voiceId?{voiceId:t.voiceId}:{}},i=await Ja({...o,aspect:t.aspect,...t.avatarId?{avatarId:t.avatarId}:{},...t.backgroundColor?{backgroundHex:t.backgroundColor}:{},...t.backgroundImageUrl?{backgroundImageUrl:t.backgroundImageUrl}:{},...n!==void 0?{durationSec:n}:{},...t.fit?{fit:t.fit}:{},...e?{outputFormat:e}:{},renderTier:t.renderTier,title:t.title});if(!t.wait){r?.stop(),vo(i,t.format);return}let s=await ce(()=>no(i.requestId),Wg,Gg);if(s.status==="failed")throw new Error(s.error||"Presenter generation failed");if(!s.videoUrl)throw new Error("Presenter generation completed without a video URL");r&&(r.text="Downloading presenter clip..."),await te(s.videoUrl,t.output),r?.stop(),vo(s,t.format),t.format==="human"&&k(`Saved to: ${t.output}`)}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Hg=new Ae("status").description("Check a presenter clip generation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{vo(await no(t),e.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Xg=new Ae("generate").description("Generate another look for an existing personal presenter").argument("<base-profile-id>","Base personal presenter id (pp_*)").requiredOption("--name <name>","Look name").requiredOption("--description <description>","Short look description").requiredOption("--prompt <prompt>","Exact appearance generation prompt").requiredOption("--look-id <id>","Stable template/look id").option("--reference-image <path-or-url...>","Up to three local images or URLs for location, outfit, or style guidance").option("--idempotency-key <key>","Stable retry key for this look request").action(async(t,e)=>{try{let n=e.idempotencyKey??pd(),r=await gd(e.referenceImage,n),o=await m("generatePresenterLook",{baseProfileId:t,description:e.description,id:e.lookId,prompt:e.prompt,...r?{referenceImages:r}:{},title:e.name},n);l(o)}catch(n){a(n instanceof Error?n.message:"Look generation failed"),process.exit(d.GENERAL_ERROR)}}),Yg=new Ae("status").description("Read presenter look generation status").argument("<run-id>","Durable run ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("generatePresenterLook",t);if(e.format==="json")return l(n);if(e.format==="quiet")return console.log(n.status);w(`Run ID: ${t}`),w(`Status: ${n.status}`),n.error?.message&&a(n.error.message)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Qg=new Ae("revise").description("Create a new Look by editing an existing presenter Look").argument("<look-id>","Ready presenter Look id (pp_*)").requiredOption("--instruction <instruction>","What to add, remove, or change").option("--reference-image <path-or-url...>","Up to three local images or URLs for location, outfit, or style guidance").option("--idempotency-key <key>","Stable retry key for this revision").action(async(t,e)=>{try{let n=e.idempotencyKey??pd(),r=await gd(e.referenceImage,n),o=await m("revisePresenterLook",{instruction:e.instruction,...r?{referenceImages:r}:{},sourceLookId:t},n);l(o)}catch(n){a(n instanceof Error?n.message:"Look revision failed"),process.exit(d.GENERAL_ERROR)}}),Zg=new Ae("revision-status").description("Read presenter Look revision status").argument("<run-id>","Durable run ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("revisePresenterLook",t);if(e.format==="json")return l(n);if(e.format==="quiet")return console.log(n.status);w(`Run ID: ${t}`),w(`Status: ${n.status}`),n.error?.message&&a(n.error.message)}catch(n){a(n instanceof Error?n.message:"Revision status failed"),process.exit(d.GENERAL_ERROR)}}),ef=new Ae("look").description("Manage looks under an existing personal presenter").addCommand(Xg).addCommand(Qg).addCommand(Zg).addCommand(Yg),Io=new Ae("avatar").description("Generate presenter clips and looks; avatar options lists the voices and looks used by presentation video presenter and cast preset").addCommand(Jg).addCommand(zg).addCommand(ef).addCommand(Hg);Io.addHelpText("after",`
|
|
61
|
-
${Xt.bold("Examples:")}
|
|
62
|
-
|
|
63
|
-
$
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
$
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
$
|
|
71
|
-
`);import{randomUUID as Oy}from"crypto";import{readFileSync as Dy}from"fs";import{writeFile as Ny}from"fs/promises";import F from"chalk";import{Command as vt,InvalidArgumentError as wc}from"commander";import _y from"ora";import{createHash as bf}from"crypto";import{Command as en,InvalidArgumentError as Zt}from"commander";import{createHash as sf}from"crypto";import{existsSync as df,readFileSync as cf}from"fs";import{basename as lf}from"path";import{Command as mf,InvalidArgumentError as Yt}from"commander";import uf from"ora";import{createHash as tf}from"crypto";import{Command as nf,InvalidArgumentError as fd}from"commander";var rf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function of(t){if(!rf.test(t))throw new fd("brand-id expects a UUID from `mf branding list`.");return t}function af(t){let e=Number(t);if(!Number.isInteger(e)||e<1)throw new fd("--file-size expects the exact positive whole-number byte size.");return e}async function ko(t){let{idempotencyKey:e,...n}=t;return m("createBrandAssetUploadUrl",n,e)}function xo(t){if(t===void 0)return"";if(t===null||typeof t!="object")return JSON.stringify(t);if(Array.isArray(t))return`[${t.map(xo).join(",")}]`;let e=t;return`{${Object.keys(e).filter(n=>e[n]!==void 0).sort().map(n=>`${JSON.stringify(n)}:${xo(e[n])}`).join(",")}}`}function Ro(t){return tf("sha256").update(`createBrandAssetUploadUrl:${xo(t)}`).digest("hex").slice(0,32)}var hd=new nf("upload-url").description("Mint a short-lived brand-scoped storage POST; this does not upload bytes").argument("<brand-id>","Brand UUID you may manage",of).requiredOption("--file-name <name>","Original filename used in storage content disposition").requiredOption("--file-type <mime>","Exact MIME type that the storage POST will send").requiredOption("--file-size <bytes>","Exact byte size, 1-104857600",af).option("--idempotency-key <key>","Stable retry key; defaults to a hash of brand and complete file metadata").option("--team-id <id>","Workspace ID; defaults to the selected workspace").addHelpText("after","\nNext: POST every returned field plus the file to uploadUrl, then run `mf branding asset register` with fileUrl, MIME type, and size.\n").action(async(t,e)=>{await y();try{l(await ko({brandId:t,...e,idempotencyKey:e.idempotencyKey??Ro({brandId:t,fileName:e.fileName,fileSize:e.fileSize,fileType:e.fileType})}))}catch(n){a(n instanceof Error?n.message:"Brand asset upload URL creation failed"),process.exit(d.GENERAL_ERROR)}});var pf=["footage","image","before_after","logo","audio"],gf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ff(t){if(!gf.test(t))throw new Yt("brand-id expects a UUID from `mf branding list`.");return t}function yd(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<0)throw new Yt(`${t} expects a whole number of 0 or more.`);return n}}function hf(t){let e=Number(t);if(!Number.isFinite(e)||e<0)throw new Yt("--duration-sec expects a number of 0 or more.");return e}function yf(t){let e;try{e=JSON.parse(t)}catch{throw new Yt("--metadata expects valid JSON.")}if(!e||typeof e!="object"||Array.isArray(e))throw new Yt("--metadata expects a JSON object.");return e}var bd=new mf("upload").description("Upload one local file, register it on a brand, and print the asset JSON").argument("<brand-id>","Brand UUID",ff).requiredOption("--file <path>","Local file to upload through Mindframes storage").requiredOption("--kind <kind>","Asset kind: footage | image | before_after | logo | audio",b("--kind",pf)).option("--label <text>","Display label; defaults to the local filename").option("--width <px>","Image or video width in pixels",yd("--width")).option("--height <px>","Image or video height in pixels",yd("--height")).option("--duration-sec <n>","Audio or video duration in seconds",hf).option("--set-key <key>","Pair key; required when --kind before_after").option("--role <role>","Pair role: before | after; required when --kind before_after",b("--role",["before","after"])).option("--metadata <json>",'Optional metadata JSON: {"pairLabel":"Summer","source":"upload"}',yf).option("--idempotency-key <key>","Retry key; defaults to a hash of file bytes and complete registration input").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y(),df(e.file)||(a(`File not found: ${e.file}`),process.exit(d.INVALID_INPUT)),e.kind==="before_after"&&(!e.role||!e.setKey)&&(a("--kind before_after requires both --role and --set-key."),process.exit(d.INVALID_INPUT)),e.kind!=="before_after"&&(e.role||e.setKey)&&(a("--role and --set-key are only valid with --kind before_after."),process.exit(d.INVALID_INPUT));let n=sf("sha256").update(cf(e.file)).digest("hex"),r=Bt(e.file),o={brandId:t,contentHash:n,durationSec:e.durationSec,fileName:r.fileName,fileSize:r.fileSize,fileType:r.fileType,height:e.height,kind:e.kind,label:e.label===void 0?r.fileName:e.label.trim(),metadata:e.metadata,role:e.role,setKey:e.setKey,width:e.width},i=e.idempotencyKey??Ro(o),s=uf({text:`Uploading ${lf(e.file)}...`,stream:process.stderr}).start();try{let c=await ko({brandId:t,...r,idempotencyKey:i,teamId:e.teamId}),p=await Gt(e.file,c);s.succeed("Uploaded"),l(await m("registerBrandAsset",{brandId:t,durationSec:e.durationSec,height:e.height,kind:e.kind,label:o.label,metadata:e.metadata,mimeType:p.type,role:e.role,s3Key:p.s3Key,setKey:e.setKey,sizeBytes:p.size,teamId:e.teamId,url:p.url,width:e.width},i))}catch(c){s.fail("Asset upload failed"),a(c instanceof Error?c.message:"Asset upload failed"),process.exit(d.GENERAL_ERROR)}});var wd=["footage","image","before_after","logo","audio"],wf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function gt(t){return e=>{if(!wf.test(e))throw new Zt(`${t} expects a UUID from \`mf branding list\` or \`mf branding asset list\`.`);return e}}function Qt(t,e){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<e)throw new Zt(`${t} expects a whole number from ${e} upward.`);return r}}function vf(t){return e=>{let n=Number(e);if(!Number.isFinite(n)||n<0)throw new Zt(`${t} expects a number of 0 or more.`);return n}}function If(t){let e;try{e=JSON.parse(t)}catch(n){throw new Zt(`--metadata expects JSON: ${n instanceof Error?n.message:String(n)}`)}if(!e||typeof e!="object"||Array.isArray(e))throw new Zt("--metadata expects a JSON object.");return e}function Co(t){return bf("sha256").update(t).digest("hex").slice(0,32)}function Wn(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var xf=new en("list").description("List one brand's uploaded assets and print stable asset IDs").argument("<brand-id>","Brand UUID",gt("brand-id")).option("--kind <kind>","Filter: footage | image | before_after | logo | audio",b("--kind",wd)).option("--limit <count>","Caller-selected page size; omit to return every matching asset",Qt("--limit",1)).option("--offset <count>","Matching assets to skip before returning results (default: 0)",Qt("--offset",0)).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("listBrandAssets",{brandId:t,...e.kind?{kind:e.kind}:{},...e.limit?{limit:e.limit}:{},...e.offset!==void 0?{offset:e.offset}:{},teamId:e.teamId}))}catch(n){Wn(n,"Asset list failed")}}),kf=new en("register").description("Register one app-owned upload from its exact URL, key, MIME, and metadata").argument("<brand-id>","Brand UUID",gt("brand-id")).requiredOption("--url <url>","Final app-owned file URL returned by the upload step").requiredOption("--kind <kind>","Asset kind: footage | image | before_after | logo | audio",b("--kind",wd)).option("--label <text>","Optional display label, up to 160 characters").requiredOption("--mime-type <type>","Exact MIME type returned by the upload step; verified against storage").option("--s3-key <key>","Optional storage key; when set it must match the URL and upload owner").option("--size-bytes <n>","Expected byte size; when set it must match storage",Qt("--size-bytes",0)).option("--width <px>","Image or video width in pixels",Qt("--width",0)).option("--height <px>","Image or video height in pixels",Qt("--height",0)).option("--duration-sec <n>","Audio or video duration in seconds",vf("--duration-sec")).option("--set-key <key>","Pair key; required when --kind before_after").option("--role <role>","Pair role: before | after; required when --kind before_after",b("--role",["before","after"])).option("--metadata <json>",'Optional metadata JSON: {"pairLabel":"Summer","source":"upload"}',If).option("--idempotency-key <key>","Retry key; defaults to a hash of the complete registration input").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y(),e.kind==="before_after"&&(!e.role||!e.setKey)&&(a("--kind before_after requires both --role and --set-key."),process.exit(d.INVALID_INPUT)),e.kind!=="before_after"&&(e.role||e.setKey)&&(a("--role and --set-key are only valid with --kind before_after."),process.exit(d.INVALID_INPUT));let n={brandId:t,durationSec:e.durationSec,height:e.height,kind:e.kind,label:e.label,metadata:e.metadata,mimeType:e.mimeType,role:e.role,s3Key:e.s3Key,setKey:e.setKey,sizeBytes:e.sizeBytes,teamId:e.teamId,url:e.url,width:e.width},r=e.idempotencyKey??Co(`registerBrandAsset:${JSON.stringify(n)}`);try{l(await m("registerBrandAsset",n,r))}catch(o){Wn(o,"Asset registration failed")}}),Rf=new en("rename").description("Rename one asset, then print its stored label and metadata").argument("<asset-id>","Asset UUID from `mf branding asset list`",gt("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",gt("--brand")).requiredOption("--label <text>","New non-empty label, up to 160 characters").option("--idempotency-key <key>","Retry key; defaults to a hash of asset ID and label").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();let n=e.label.trim();n||(a("--label cannot be empty."),process.exit(d.INVALID_INPUT));try{l(await m("renameBrandAsset",{assetId:t,brandId:e.brand,label:n,teamId:e.teamId},e.idempotencyKey??Co(`renameBrandAsset:${t}:${n}`)))}catch(r){Wn(r,"Asset rename failed")}}),Cf=new en("delete").description("Remove one asset record from the brand while keeping its uploaded file").argument("<asset-id>","Asset UUID from `mf branding asset list`",gt("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",gt("--brand")).option("--yes","Confirm removal from the brand library without an interactive prompt").option("--idempotency-key <key>","Retry key; defaults to a stable hash of the asset ID").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y(),e.yes||(a("Refusing removal from the brand library without --yes."),process.exit(d.INVALID_INPUT));try{l(await m("deleteBrandAsset",{assetId:t,brandId:e.brand,teamId:e.teamId},e.idempotencyKey??Co(`deleteBrandAsset:${t}`)))}catch(n){Wn(n,"Asset deletion failed")}}),vd=new en("asset").description("List, upload, rename, and remove a brand's private asset library").addCommand(xf).addCommand(kf).addCommand(hd).addCommand(bd).addCommand(Rf).addCommand(Cf);import{createHash as Sf}from"crypto";import{Command as Xe,InvalidArgumentError as Id}from"commander";var Ef=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Kn(t){if(!Ef.test(t))throw new Id("Expected a brand UUID from `mf branding list`.");return t}function $f(t){if(t==="true")return!0;if(t==="false")return!1;throw new Id("--show expects true or false.")}function So(t,e){return Sf("sha256").update(JSON.stringify([t,e])).digest("hex").slice(0,32)}function Jn(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Tf=new Xe("set").description("Create or update one custom colour role and print the committed snapshot").argument("<brand-id>","Brand UUID",Kn).argument("<role>","Custom role without the color. prefix").argument("<hex>","Three- or six-digit hex colour, for example #114b97").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from the complete change when omitted").action(async(t,e,n,r)=>{await y();let o={brandId:t,hex:n,role:e,teamId:r.teamId};try{l(await m("setBrandCustomColor",o,r.idempotencyKey??So("setBrandCustomColor",o)))}catch(i){Jn(i,"Custom colour update failed")}}),Af=new Xe("delete").description("Remove one custom colour role and print the committed snapshot").argument("<brand-id>","Brand UUID",Kn).argument("<role>","Custom role without the color. prefix").option("--yes","Confirm removal without an interactive prompt").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from brand and role when omitted").action(async(t,e,n)=>{await y(),n.yes||(a("Refusing to remove a custom colour without --yes."),process.exit(d.INVALID_INPUT));let r={brandId:t,role:e,teamId:n.teamId};try{l(await m("deleteBrandCustomColor",r,n.idempotencyKey??So("deleteBrandCustomColor",r)))}catch(o){Jn(o,"Custom colour removal failed")}}),xd=new Xe("foundation").description("Manage atomic Foundation settings backed by the brand DAG").addCommand(new Xe("color").description("Manage custom colour roles").addCommand(Tf).addCommand(Af)),Pf=new Xe("get").description("Read the complete current footer and its source").argument("<brand-id>","Brand UUID",Kn).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("getBrandFooter",{brandId:t,teamId:e.teamId}))}catch(n){Jn(n,"Footer read failed")}}),Of=new Xe("set").description("Patch footer text, visibility, or alignment atomically").argument("<brand-id>","Brand UUID",Kn).option("--text <text>","Complete footer text; pass an empty string to clear it").option("--show <boolean>","Whether artifacts show the footer: true | false",$f).option("--alignment <value>","Footer alignment: left | center | right",b("--alignment",["left","center","right"])).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from the complete patch when omitted").action(async(t,e)=>{await y(),e.alignment===void 0&&e.show===void 0&&e.text===void 0&&(a("Pass at least one of --text, --show, or --alignment."),process.exit(d.INVALID_INPUT));let n={alignment:e.alignment,brandId:t,show:e.show,teamId:e.teamId,text:e.text};try{l(await m("setBrandFooter",n,e.idempotencyKey??So("setBrandFooter",n)))}catch(r){Jn(r,"Footer update failed")}}),kd=new Xe("footer").description("Read or update the brand footer").addCommand(Pf).addCommand(Of);import{createHash as Df}from"crypto";import{Command as Rd}from"commander";var Nf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function _f(t){Nf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Lf(t){return Df("sha256").update(t).digest("hex").slice(0,32)}function Cd(t,e){try{return JSON.parse(e)}catch(n){a(`${t} is not valid JSON: ${n instanceof Error?n.message:String(n)}`),process.exit(d.INVALID_INPUT)}}function Uf(t,e){let n=Cd(t,e);return Array.isArray(n)||(a(`${t} must be a JSON array of gradients, e.g. '[{"id":"dawn","type":"linear","stops":[{"color":"#155DAC","position":0},{"color":"#0B2C52","position":100}]}]'.`),process.exit(d.INVALID_INPUT)),n}function jf(t,e){let n=Cd(t,e);return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${t} must be a JSON object.`),process.exit(d.INVALID_INPUT)),n}var qf=new Rd("set").description("Replace a brand's gradient library (whole-set: omitted gradients are deleted)").argument("<brand-id>","Brand profile ID").requiredOption("--gradients <json>",`The complete gradient list as JSON, e.g. '[{"id":"dawn","name":"Dawn","type":"linear","angle":135,"stops":[{"color":"#155DAC","position":0},{"color":"#0B2C52","position":100}]}]'. Gradients you omit are DELETED.`).option("--roles <json>",`Role pointers by gradient id, e.g. '{"primary":"dawn"}'. Omit to leave the brand's current roles alone.`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_f(t);let n={brandId:t,gradients:Uf("--gradients",e.gradients),teamId:e.teamId};e.roles!==void 0&&(n.gradientRoles=jf("--roles",e.roles));try{l(await m("setBrandGradients",n,Lf(`setBrandGradients:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(d.GENERAL_ERROR)}}),Sd=new Rd("gradient").description("Brand gradient library commands").addCommand(qf);import{createHash as Vf}from"crypto";import{Command as Ye}from"commander";var Mf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function tn(t){Mf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Ff(t,e=[]){return[...e,t]}function $o(t){return Vf("sha256").update(t).digest("hex").slice(0,32)}function Eo(t,e){if(e==="true")return!0;if(e==="false")return!1;a(`${t} must be true or false; got "${e}".`),process.exit(d.INVALID_INPUT)}function Ed(t,e){try{return JSON.parse(e)}catch{a(`${t} must be valid JSON.`),process.exit(d.INVALID_INPUT)}}var Bf=new Ye("get").description("Read a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),tn(t);try{l(await m("getBrandGuardrails",{brandId:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(d.GENERAL_ERROR)}}),Gf=new Ye("test").description("Check content against a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--content <text>","The content to check").option("--channel <channel>","Channel the content is for, e.g. deck-16-9").option("--market <market>","Market the content is for, e.g. US").option("--artifact-type <type>","Artifact type, e.g. presentation").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),tn(t),e.content===void 0&&(a("Pass --content with the text to check."),process.exit(d.INVALID_INPUT));let n={brandId:t,content:e.content,teamId:e.teamId};e.channel!==void 0&&(n.channel=e.channel),e.market!==void 0&&(n.market=e.market),e.artifactType!==void 0&&(n.artifactType=e.artifactType);try{let r=await m("testBrandGuardrails",n);l(r),r.passed===!1&&process.exit(d.GENERAL_ERROR)}catch(r){a(r instanceof Error?r.message:"Test failed"),process.exit(d.GENERAL_ERROR)}}),Wf=new Ye("set").description("Create or update one of a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--name <text>","Rule name").option("--category <category>","language | compliance | channel-requirements | accessibility | asset-usage").option("--severity <severity>","shadow | warn | block").option("--require <json>",`What the rule demands, as JSON, e.g. '{"component":"banned-phrase","text":"cheap"}'`).option("--conditions <json>",`When the rule applies, as JSON, e.g. '{"op":"AND","clauses":[{"field":"channel","op":"is","values":["deck-16-9"]}]}'`).option("--enabled <bool>","true or false; defaults to true").option("--node-key <key>","Existing rule node key to UPDATE, from `guardrails get`. Omit to create.").option("--notes <text>","Notes about the rule").option("--slug <slug>","Explicit kebab-case slug for a new rule").option("--publish <bool>","Publish a brand snapshot after the write; defaults to true").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),tn(t),(!e.name||!e.category||!e.severity)&&(a("Pass --name, --category and --severity."),process.exit(d.INVALID_INPUT)),e.require===void 0&&(a(`Pass --require, e.g. '{"component":"banned-phrase"}'.`),process.exit(d.INVALID_INPUT));let n={brandId:t,category:e.category,name:e.name,require:Ed("--require",e.require),severity:e.severity,teamId:e.teamId};e.conditions!==void 0&&(n.conditions=Ed("--conditions",e.conditions)),e.enabled!==void 0&&(n.enabled=Eo("--enabled",e.enabled)),e.nodeKey!==void 0&&(n.nodeKey=e.nodeKey),e.notes!==void 0&&(n.notes=e.notes),e.slug!==void 0&&(n.slug=e.slug),e.publish!==void 0&&(n.publish=Eo("--publish",e.publish));try{l(await m("setBrandGuardrail",n,$o(`setBrandGuardrail:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(d.GENERAL_ERROR)}}),Kf=new Ye("delete").description("Remove one of a brand's guardrail rules").argument("<brand-id>","Brand profile ID").argument("<node-key>","Rule node key from `guardrails get`").option("--publish <bool>","Publish a brand snapshot after the removal; defaults to true").option("--team-id <id>","Workspace ID").action(async(t,e,n)=>{await y(),tn(t);let r={brandId:t,nodeKey:e,teamId:n.teamId};n.publish!==void 0&&(r.publish=Eo("--publish",n.publish));try{l(await m("deleteBrandGuardrail",r,$o(`deleteBrandGuardrail:${t}:${e}`)))}catch(o){a(o instanceof Error?o.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),Jf=new Ye("generate").description("Draft guardrail rule proposals for a brand").argument("<brand-id>","Brand profile ID").option("--brand-name <name>","Brand name to draft rules for").option("--channel <channel>","Channel the brand publishes to; repeat for several. At least one is required.",Ff).option("--brand-description <text>","What the brand does").option("--brand-voice <text>","How the brand sounds").option("--industry <text>","Industry the brand operates in").option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),tn(t),e.brandName||(a("Pass --brand-name."),process.exit(d.INVALID_INPUT)),e.channel?.length||(a("Pass at least one --channel to scope the proposed rules."),process.exit(d.INVALID_INPUT));let n={activeChannels:e.channel,brandId:t,brandName:e.brandName,teamId:e.teamId};e.brandDescription!==void 0&&(n.brandDescription=e.brandDescription),e.brandVoice!==void 0&&(n.brandVoice=e.brandVoice),e.industry!==void 0&&(n.industry=e.industry);try{let r=await m("generateBrandGuardrails",n,$o(`generateBrandGuardrails:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await is(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(d.GENERAL_ERROR)}}),zf=new Ye("generate-status").description("Read a brand guardrails generation run").argument("<run-id>","Run ID from `branding guardrails generate --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("generateBrandGuardrails",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),$d=new Ye("guardrails").description("Brand guardrail rule commands").addCommand(Bf).addCommand(Gf).addCommand(Wf).addCommand(Kf).addCommand(Jf).addCommand(zf);import{randomUUID as Hf}from"crypto";import{readFile as Td}from"fs/promises";import{Command as Xf}from"commander";var Ad=new Xf("import").description("Import a workspace brand from a DESIGN.md file").argument("<design-md-file>","Path to the DESIGN.md file").option("--name <name>","Override the brand name in the document").option("--url <url>","Associate a source URL with the imported brand").option("--url-evidence <json-file>","Merge a saved raw URL-extraction JSON response").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable key for retrying the same import without creating another brand").action(async(t,e)=>{await y();try{let n=await Td(t,"utf8"),r=e.urlEvidence?JSON.parse(await Td(e.urlEvidence,"utf8")):void 0,o=e.idempotencyKey??Hf();l(await m("importBrandDesignMd",{designMd:n,name:e.name,teamId:e.teamId,url:e.url,urlExtractedRaw:r},o))}catch(n){a(n instanceof Error?n.message:"Import failed"),process.exit(d.GENERAL_ERROR)}});import{createHash as Yf}from"crypto";import{Command as Ne}from"commander";var Qf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function _e(t){Qf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function ft(t){return Yf("sha256").update(t).digest("hex").slice(0,32)}var Pd=new Ne("create").description("Create an empty workspace brand and print its JSON").argument("<name>","Name for the new brand").option("--parent <brand-id>","File the new brand under this parent").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),e.parent&&_e(e.parent);try{l(await m("createBrand",{name:t,parentBrandingId:e.parent,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Create failed"),process.exit(d.GENERAL_ERROR)}}),Od=new Ne("star").description("Add a library star, or remove it with --off, and print the result").argument("<brand-id>","Brand profile ID").option("--off","Remove the star instead of adding it").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_e(t);let n=!e.off;try{l(await m("setBrandStar",{brandId:t,starred:n,teamId:e.teamId},ft(`setBrandStar:${t}:${n}`)))}catch(r){a(r instanceof Error?r.message:"Star failed"),process.exit(d.GENERAL_ERROR)}});async function Zf(t,e){let n=await m("getBrandProfile",{brandId:t,teamId:e.teamId});return typeof n.name=="string"?n.name:t}var Dd=new Ne("delete").description("Soft-delete a brand after confirmation and print the result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").option("--yes","Confirm soft deletion without an interactive prompt").action(async(t,e)=>{if(await y(),_e(t),!e.yes&&process.stdin.isTTY){let n;try{n=await Zf(t,e)}catch(r){a(r instanceof Error?r.message:"Could not read the brand"),process.exit(d.GENERAL_ERROR)}a(`Refusing to delete "${n}" (${t}) without confirmation. Re-run with --yes to remove this brand from the library.`),process.exit(d.GENERAL_ERROR)}try{l(await m("deleteBrand",{brandId:t,teamId:e.teamId},ft(`deleteBrand:${t}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),To="none",Nd=new Ne("update").description("Rename with --name or move with --parent; print the updated JSON").argument("<brand-id>","Brand profile ID").option("--name <name>","New name for the brand").option("--parent <brand-id>",`File the brand under this parent, or "${To}" to detach it`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_e(t);let n=e.parent?.toLowerCase()===To;e.parent!==void 0&&!n&&_e(e.parent),e.name===void 0&&e.parent===void 0&&(a(`Nothing to update. Pass --name to rename this brand, or --parent <brand-id> to move it (--parent ${To} detaches it).`),process.exit(d.INVALID_INPUT));let r={brandId:t,teamId:e.teamId};e.name!==void 0&&(r.name=e.name),e.parent!==void 0&&(r.parentBrandingId=n?null:e.parent);try{l(await m("updateBrand",r,ft(`updateBrand:${t}:${e.name??""}:${e.parent??""}`)))}catch(o){a(o instanceof Error?o.message:"Update failed"),process.exit(d.GENERAL_ERROR)}}),_d=new Ne("set-default").description("Use this brand by default for new artifacts and print the result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_e(t);try{l(await m("setDefaultBrand",{brandId:t,teamId:e.teamId},ft(`setDefaultBrand:${t}`)))}catch(n){a(n instanceof Error?n.message:"Set default failed"),process.exit(d.GENERAL_ERROR)}}),Ld=new Ne("approve").description("Approve a reviewed brand for use and print the persisted result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_e(t);try{let n=await J(e.teamId);l(await m("approveBrand",{brandId:t,teamId:n},ft(`approveBrand:${n}:${t}`)))}catch(n){a(n instanceof Error?n.message:"Approve failed"),process.exit(d.GENERAL_ERROR)}}),Ud=new Ne("onboarding").description("Manage the brand onboarding review state").addCommand(new Ne("complete").description("Mark onboarding review complete without approving the brand").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),_e(t);try{let n=await J(e.teamId);l(await m("completeBrandOnboarding",{brandId:t,teamId:n},ft(`completeBrandOnboarding:${n}:${t}`)))}catch(n){a(n instanceof Error?n.message:"Complete onboarding failed"),process.exit(d.GENERAL_ERROR)}}));import{createHash as Ao}from"crypto";import{existsSync as eh,readFileSync as th}from"fs";import{basename as nh}from"path";import{Command as zn}from"commander";import rh from"ora";function oh(t,e,n){return Ao("sha256").update(JSON.stringify([t,e,n??null])).digest("hex").slice(0,32)}var jd=new zn("logo").description("Upload primary, dark-background, and favicon logo files").addCommand(new zn("list").description("List exact logo candidates and identify the active one").argument("<brand-id>","Brand UUID from `mf branding list`").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("listBrandLogos",{brandId:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Logo list failed"),process.exit(d.GENERAL_ERROR)}})).addCommand(new zn("remove").description("Remove one exact candidate URL and select its deterministic fallback").argument("<brand-id>","Brand UUID from `mf branding list`").argument("<logo-url>","Exact URL returned by `mf branding logo list`").option("--yes","Confirm exact candidate removal without an interactive prompt").option("--idempotency-key <key>","Stable retry key; derived from brand and URL when omitted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e,n)=>{await y(),n.yes||(a("Refusing to remove a logo candidate without --yes."),process.exit(d.INVALID_INPUT));try{l(await m("removeBrandLogo",{brandId:t,logoUrl:e,teamId:n.teamId},n.idempotencyKey??oh("removeBrandLogo",t,e)))}catch(r){a(r instanceof Error?r.message:"Logo removal failed"),process.exit(d.GENERAL_ERROR)}})).addCommand(new zn("set").description("Upload one logo variant and print the updated brand JSON").argument("[brand-id]","Brand ID (defaults to this workspace's default brand)").requiredOption("--file <path>","Local image file to upload and use").option("--variant <variant>","primary | dark | favicon. 'dark' is the reversed lock-up for dark backgrounds","primary").option("--idempotency-key <key>","Stable retry key; deterministically derived from workspace, brand, variant, and file bytes when omitted").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();let n=e.variant??"primary";["primary","dark","favicon"].includes(n)||(a(`--variant must be primary, dark, or favicon (got "${n}")`),process.exit(d.INVALID_INPUT)),eh(e.file)||(a(`File not found: ${e.file}`),process.exit(d.INVALID_INPUT));let r=Ao("sha256").update(th(e.file)).digest("hex"),o=e.idempotencyKey??Ao("sha256").update(`setBrandLogo:${e.teamId??"current"}:${t??"default"}:${n}:${r}`).digest("hex").slice(0,32),i=rh({text:`Uploading ${nh(e.file)}...`,stream:process.stderr}).start(),s;try{s=(await de(e.file,{idempotencyKey:`${o}:upload`,storagePrefix:"brand-logos"})).url,i.succeed("Uploaded")}catch(c){i.fail("Upload failed"),a(c instanceof Error?c.message:String(c)),process.exit(d.GENERAL_ERROR)}try{l(await m("setBrandLogo",{brandId:t,fileUrl:s,teamId:e.teamId,variant:n},o))}catch(c){a(c instanceof Error?c.message:"Write failed"),process.exit(d.GENERAL_ERROR)}}));import{createHash as ih,randomUUID as ah}from"crypto";import{Command as ht,InvalidArgumentError as Hn}from"commander";var sh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,dh=["admin","editor","viewer"],qd=["cancelled","completed","failed","info","queued","running"],Vd=["activity","brand-extraction-request","brand-resolution","brand-sync-job"];function Qe(t){return e=>{if(!sh.test(e))throw new Hn(`${t} expects a UUID from \`mf branding list\` or the workspace member list.`);return e}}function Fd(t){let e=Number(t);if(!Number.isInteger(e)||e<1||e>200)throw new Hn("--limit expects a whole number from 1 to 200.");return e}function Md(t,e){return n=>{let r=n.split(",").map(i=>i.trim()).filter(Boolean);if(r.find(i=>!e.includes(i))||r.length===0)throw new Hn(`${t} expects comma-separated values from: ${e.join(", ")}.`);return r}}function Bd(t,e){return ih("sha256").update(JSON.stringify([t,e,ah()])).digest("hex").slice(0,32)}function nn(t,e){a(t instanceof Error?t.message:e),process.exit(typeof t=="object"&&t!==null&&"exitCode"in t&&typeof t.exitCode=="number"?t.exitCode:d.GENERAL_ERROR)}var ch=new ht("list").description("List explicit member access overrides for one team brand").argument("<brand-id>","Team brand UUID",Qe("brand-id")).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("listBrandPermissions",{brandId:t,teamId:e.teamId}))}catch(n){nn(n,"Brand permission list failed")}}),lh=new ht("candidates").description("List member IDs eligible for one team brand's access overrides").argument("<brand-id>","Team brand UUID",Qe("brand-id")).option("--query <text>","Search member name, username, or email").option("--limit <count>","Maximum members, 1-200 (default: 50)",Fd).option("--offset <count>","Members to skip (default: 0)",t=>{let e=Number(t);if(!Number.isInteger(e)||e<0)throw new Hn("--offset expects a whole number of 0 or more.");return e}).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("listBrandPermissionCandidates",{brandId:t,limit:e.limit,offset:e.offset,query:e.query,teamId:e.teamId}))}catch(n){nn(n,"Brand permission candidate list failed")}}),mh=new ht("set").description("Set one team member's explicit role for a team brand").argument("<brand-id>","Team brand UUID",Qe("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",Qe("--user")).requiredOption("--role <role>","Desired override: admin | editor | viewer",b("--role",dh)).option("--idempotency-key <key>","Explicit retry identity; otherwise a new payload-bound key is minted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("setBrandPermission",{brandId:t,role:e.role,teamId:e.teamId,userId:e.user},e.idempotencyKey??Bd("setBrandPermission",{brandId:t,role:e.role,teamId:e.teamId??null,userId:e.user})))}catch(n){nn(n,"Brand permission update failed")}}),uh=new ht("remove").description("Remove one member override so the team role applies again").argument("<brand-id>","Team brand UUID",Qe("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",Qe("--user")).option("--yes","Confirm this access change without an interactive prompt").option("--idempotency-key <key>","Explicit retry identity; otherwise a new payload-bound key is minted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y(),e.yes||(a("Refusing to remove a brand access override without --yes."),process.exit(d.INVALID_INPUT));try{l(await m("removeBrandPermission",{brandId:t,teamId:e.teamId,userId:e.user},e.idempotencyKey??Bd("removeBrandPermission",{brandId:t,teamId:e.teamId??null,userId:e.user})))}catch(n){nn(n,"Brand permission removal failed")}}),Gd=new ht("permission").description("Administer explicit member access overrides for a team brand").addCommand(lh).addCommand(ch).addCommand(mh).addCommand(uh),Wd=new ht("activity").description("Read a brand's filtered, cursor-paginated activity feed").argument("<brand-id>","Brand UUID",Qe("brand-id")).option("--query <text>","Search action, summary, detail, entity, and metadata").option("--status <statuses>",`Comma-separated statuses: ${qd.join(" | ")}`,Md("--status",qd)).option("--source-type <types>",`Comma-separated sources: ${Vd.join(" | ")}`,Md("--source-type",Vd)).option("--from <iso-time>","Inclusive ISO-8601 lower time bound").option("--to <iso-time>","Inclusive ISO-8601 upper time bound").option("--limit <count>","Maximum rows, 1-200 (default: 80)",Fd).option("--cursor <cursor>","Opaque nextCursor from the preceding page").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e)=>{await y();try{l(await m("listBrandActivity",{brandId:t,cursor:e.cursor,from:e.from,limit:e.limit,query:e.query,sourceTypes:e.sourceType,statuses:e.status,teamId:e.teamId,to:e.to}))}catch(n){nn(n,"Brand activity read failed")}});import{createHash as ph}from"crypto";import{Command as yt,InvalidArgumentError as Oo}from"commander";var gh=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function Po(t,e){if(gh.test(t))return t;throw new Oo(`${e} must be a UUID.`)}function fh(t){let e=Number(t);if(Number.isInteger(e)&&e>=1&&e<=50)return e;throw new Oo("limit must be a whole number from 1 to 50.")}function hh(t){let e=Number(t);if(Number.isInteger(e)&&e>=0)return e;throw new Oo("offset must be a whole number of 0 or more.")}function yh(t){return ph("sha256").update(t).digest("hex").slice(0,32)}async function Xn(t,e){await y();try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(d.GENERAL_ERROR)}}var Kd=new yt("presentations").description("Inspect presentations already linked to a brand").addCommand(new yt("list").description("List linked decks with preview, version, stale, and last-sync state").argument("<brand-id>","Brand UUID from `branding list`").option("--limit <n>","Rows to return (1-50; default 50)",fh,50).option("--offset <n>","Zero-based offset (default 0)",hh,0).option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(t,e)=>{let n=Po(t,"brand-id");await Xn(()=>m("listBrandPresentations",{brandId:n,limit:e.limit,offset:e.offset,teamId:e.teamId}),"Could not list linked presentations")})),Jd=new yt("presentation").description("Inspect or update one deck from its already-linked brand").addCommand(new yt("drift").description("Read current, drifted, unknown, or not-linked status and exact changes").argument("<presentation>","Presentation UUID, document UUID, or slug").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(t,e)=>{await Xn(()=>m("getPresentationBrandDrift",{presentationId:t,teamId:e.teamId}),"Could not read presentation brand drift")})).addCommand(new yt("apply-changes").description("Create a new deck version using its linked brand's current colors, fonts, and logo").argument("<presentation>","Presentation UUID, document UUID, or slug").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").requiredOption("--idempotency-key <key>","Stable key; reuse it for an exact retry, change it for a later brand update").action(async(t,e)=>{await Xn(()=>m("applyPresentationBrandChanges",{presentationId:t,teamId:e.teamId},e.idempotencyKey),"Could not apply linked-brand changes")})),zd=new yt("sync-cancel").description("Cancel an active bulk linked-deck sync through its durable run; retries are safe").argument("<brand-id>","Brand UUID used to start the sync").argument("<run-id>","Active run UUID from `branding sync --no-wait`").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(t,e,n)=>{let r=Po(t,"brand-id"),o=Po(e,"run-id");await Xn(()=>m("cancelBrandPresentationSync",{brandId:r,runId:o,teamId:n.teamId},yh(`cancelBrandPresentationSync:${r}:${o}`)),"Could not cancel brand sync")});import{createHash as bh,randomUUID as Qd}from"crypto";import{Command as Le}from"commander";var wh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Hd=["product","service","platform","solution"],Yn=["candidate","draft","approved"],Xd=["brand-site","brand-site-scan","brand-site-extract","product-url"];function bt(t){wh.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Qn(t,e,n){if(n.includes(e))return e;a(`${t} must be one of: ${n.join(", ")}.`),process.exit(d.INVALID_INPUT)}function vh(t,e){let n=Number(e);if(Number.isInteger(n)&&n>0)return n;a(`${t} must be a whole number greater than zero.`),process.exit(d.INVALID_INPUT)}function Do(t){return bh("sha256").update(t).digest("hex").slice(0,32)}var Ih=new Le("list").description("List the products a brand sells").argument("<brand-id>","Brand profile ID").option("--status <status>",`Only products in this state. One of: ${Yn.join(", ")}. Omit for the saved catalogue.`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),bt(t),e.status!==void 0&&Qn("--status",e.status,Yn);let n={brandId:t,teamId:e.teamId};e.status!==void 0&&(n.status=e.status);try{l(await m("listBrandProducts",n))}catch(r){a(r instanceof Error?r.message:"List failed"),process.exit(d.GENERAL_ERROR)}}),xh=new Le("set").description("Create or update one of a brand's products").argument("<brand-id>","Brand profile ID").option("--product <id>","Existing product to update. Omit to create, or to update the product this brand already has at the same --url.").option("--name <name>","Product name (required when creating)").option("--type <type>",`One of: ${Hd.join(", ")}`).option("--description <text>","What the product is, in full").option("--summary <text>","Short form of the description").option("--url <url>","The product's page. Also its identity: a url this brand already has updates that product.").option("--status <status>",`One of: ${Yn.join(", ")}`).option("--logo-url <url>","Product logo URL").option("--inherits-brand <true|false>","Whether the product presents in the parent brand's design").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),bt(t),e.type!==void 0&&Qn("--type",e.type,Hd),e.status!==void 0&&Qn("--status",e.status,Yn),e.inheritsBrand!==void 0&&e.inheritsBrand!=="true"&&e.inheritsBrand!=="false"&&(a("--inherits-brand must be true or false."),process.exit(d.INVALID_INPUT));let n={brandId:t,teamId:e.teamId};e.product!==void 0&&(n.productId=e.product),e.name!==void 0&&(n.name=e.name),e.type!==void 0&&(n.type=e.type),e.description!==void 0&&(n.description=e.description),e.summary!==void 0&&(n.summary=e.summary),e.url!==void 0&&(n.url=e.url),e.status!==void 0&&(n.status=e.status),e.logoUrl!==void 0&&(n.logoUrl=e.logoUrl),e.inheritsBrand!==void 0&&(n.inheritsBrand=e.inheritsBrand==="true");try{l(await m("saveBrandProduct",n,Do(`saveBrandProduct:${t}:${e.product??e.url??e.name??"new"}`)))}catch(r){a(r instanceof Error?r.message:"Save failed"),process.exit(d.GENERAL_ERROR)}}),Yd=(t,e=[])=>[...e,t],kh=new Le("select").description("Atomically set approved products in a bounded product set").argument("<brand-id>","Brand profile ID").option("--product <id>","Product whose state to set; repeat for every product in the bounded set.",Yd).option("--approve <id>","Product from --product that should finish approved; repeat as needed. Others finish draft.",Yd).option("--idempotency-key <key>","Stable retry key for this selection").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),bt(t),e.product?.length||(a("Pass at least one --product <id> to set product approval."),process.exit(d.INVALID_INPUT));let n={approvedProductIds:e.approve??[],brandId:t,productIds:e.product,teamId:e.teamId};try{l(await m("setBrandProductSelection",n,e.idempotencyKey??Qd()))}catch(r){a(r instanceof Error?r.message:"Selection failed"),process.exit(d.GENERAL_ERROR)}}),Rh=new Le("duplicate").description("Create an independent draft copy of one product").argument("<brand-id>","Brand profile ID").requiredOption("--product <id>","Product ID to duplicate").option("--name <name>","Name for the copy").option("--idempotency-key <key>","Stable retry key for this duplication").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),bt(t);let n={brandId:t,productId:e.product,teamId:e.teamId};e.name!==void 0&&(n.name=e.name);try{l(await m("duplicateBrandProduct",n,e.idempotencyKey??Qd()))}catch(r){a(r instanceof Error?r.message:"Duplicate failed"),process.exit(d.GENERAL_ERROR)}}),Ch=new Le("delete").description("Remove one product from a brand").argument("<brand-id>","Brand profile ID").option("--product <id>","Product ID to remove").option("--team-id <id>","Workspace ID").option("--yes","Skip the confirmation prompt").action(async(t,e)=>{await y(),bt(t),e.product===void 0&&(a("Pass --product <id> to name the product to remove. `branding product list <brand-id>` prints the ids."),process.exit(d.INVALID_INPUT)),!e.yes&&process.stdin.isTTY&&(a(`Refusing to delete product "${e.product}" without confirmation. Re-run with --yes.`),process.exit(d.GENERAL_ERROR));try{l(await m("deleteBrandProduct",{brandId:t,productId:e.product,teamId:e.teamId},Do(`deleteBrandProduct:${t}:${e.product}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),Sh=new Le("extract").description("Discover a brand's products by crawling its site").argument("<brand-id>","Brand profile ID").option("--mode <mode>",`One of: ${Xd.join(", ")}`).option("--url <url>","Page to extract (product-url), or the site to scan instead of the brand's own recorded URL").option("--max-products <count>","How many pages to take from the scan (max 30)").option("--product <id>","Candidate product to extract; repeat for several. Required for brand-site-extract.",(t,e=[])=>[...e,t]).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),bt(t),e.mode!==void 0&&Qn("--mode",e.mode,Xd);let n={brandId:t,teamId:e.teamId};e.mode!==void 0&&(n.mode=e.mode),e.url!==void 0&&(n.url=e.url),e.maxProducts!==void 0&&(n.maxProducts=vh("--max-products",e.maxProducts)),e.product?.length&&(n.productIds=e.product);try{let r=await m("extractBrandProducts",n,Do(`extractBrandProducts:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await rs(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Extract failed"),process.exit(d.GENERAL_ERROR)}}),Eh=new Le("extract-status").description("Read a brand product extraction run").argument("<run-id>","Run ID from `branding product extract --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("extractBrandProducts",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Zd=new Le("product").description("Brand product catalogue commands").addCommand(Ih).addCommand(xh).addCommand(kh).addCommand(Rh).addCommand(Ch).addCommand(Sh).addCommand(Eh);import{createHash as $h}from"crypto";import{Command as Zn}from"commander";var Th=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ec(t){Th.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Ah(t,e=[]){return[...e,t]}function Ph(t){return $h("sha256").update(t).digest("hex").slice(0,32)}var Oh=new Zn("get").description("Read which decks have drifted from a brand").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),ec(t);try{l(await m("getBrandQuality",{brandId:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(d.GENERAL_ERROR)}}),Dh=new Zn("repair").description("Repair decks that have visually drifted from a brand").argument("<brand-id>","Brand profile ID").option("--scope <scope>","selected (repair only --deck ids) or all_eligible (repair every drifted deck). Required.").option("--deck <presentation-id>","Deck to repair; repeat for several. Only used with --scope selected.",Ah).option("--confirm-partial","Also repair decks whose guidance changed too; they stay flagged as guidance-outdated afterwards.").option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),ec(t),e.scope!=="selected"&&e.scope!=="all_eligible"&&(a("Pass --scope selected or --scope all_eligible. There is no default: 'selected' repairs only the decks you name, 'all_eligible' repairs every drifted deck on the brand."),process.exit(d.INVALID_INPUT)),e.scope==="selected"&&!e.deck?.length&&(a("--scope selected needs at least one --deck."),process.exit(d.INVALID_INPUT));let n={brandId:t,scope:e.scope,teamId:e.teamId};e.deck?.length&&(n.presentationIds=e.deck),e.confirmPartial===!0&&(n.confirmedPartialRepair=!0);try{let r=await m("repairBrandQuality",n,Ph(`repairBrandQuality:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await as(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Repair failed"),process.exit(d.GENERAL_ERROR)}}),Nh=new Zn("repair-status").description("Read a brand quality repair run").argument("<run-id>","Run ID from `branding quality repair --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("repairBrandQuality",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),tc=new Zn("quality").description("Brand deck quality commands").addCommand(Oh).addCommand(Dh).addCommand(Nh);function No(t){return Array.isArray(t.items)}function Pe(t){return typeof t=="string"&&t.length>0?t:void 0}function _o(t){return Pe(t.resolvedTokens?.logoUrl)??Pe(t.brandData?.assets?.logo)??Pe(t.brandData?.assets?.logoUrl)??Pe(t.brandData?.logoUrl)}function Lo(t){return Pe(t.resolvedTokens?.colors?.primary)??Pe(t.brandData?.colors?.primary)??Pe(t.brandData?.enhancedColors?.palette?.[0]?.hex)}function nc(t){let e=t.brandData?.enhancedColors?.palette??t.brandData?.colors?.palette;if(!Array.isArray(e))return[];let n=[];for(let r of e){if(typeof r=="string"){n.push({hex:r});continue}if(r&&typeof r=="object"&&"hex"in r){let{hex:o,role:i}=r;typeof o=="string"&&n.push({hex:o,...typeof i=="string"?{role:i}:{}})}}return n}function _h(t){return{id:t.id,isDefault:t.isDefault,name:t.name,...t.domain?{sourceUrl:t.domain}:{},...t.logoUrl?{logoUrl:t.logoUrl}:{},...t.primaryColor?{primaryColor:t.primaryColor}:{}}}function Lh(t){let e=Pe(t.extractedFrom)??Pe(t.normalizedUrl),n=_o(t),r=Lo(t);return{id:t.id,isDefault:t.isDefault,name:t.name,...e?{sourceUrl:e}:{},...n?{logoUrl:n}:{},...r?{primaryColor:r}:{},...t.createdAt?{createdAt:t.createdAt}:{}}}function rc(t){return No(t)?t.items.map(Lh):t.brandings.map(_h)}import{createHash as Uh}from"crypto";import{Command as je,InvalidArgumentError as jh}from"commander";var qh=["x","instagram","facebook","linkedin","tiktok","youtube"],Vh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Ue(t){if(!Vh.test(t))throw new jh("Expected a UUID returned by the corresponding list command.");return t}function er(t,e){return Uh("sha256").update(JSON.stringify([t,...e])).digest("hex")}function wt(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Mh=new je("list").description("List one brand's competitors with stable IDs, websites, X accounts, and avatars").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async t=>{await y();try{l(await m("getBrandCompetitors",{brandingId:t.brandingId,teamId:t.teamId}))}catch(e){wt(e,"Competitor list failed")}}),Fh=new je("add").description("Add or update one competitor by name and print its stable saved row").argument("<name>","Competitor company or product name").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--website <url>","Competitor website as a full URL").option("--x-handle <handle>","Competitor X handle, with or without @").option("--x-avatar-url <url>","Avatar URL for the selected X account").option("--no-resolve-handle","Do not search X when --x-handle is omitted").action(async(t,e)=>{await y();let n={brandingId:e.brandingId,name:t,resolveHandle:e.resolveHandle,teamId:e.teamId,website:e.website,xAvatarUrl:e.xAvatarUrl,xHandle:e.xHandle};try{l(await m("addCompetitor",n,er("addCompetitor",[e.brandingId??"default",t.trim(),e.website??null,e.xHandle??null,e.xAvatarUrl??null,e.resolveHandle])))}catch(r){wt(r,"Competitor write failed")}}),Bh=new je("delete").description("Remove one competitor by the stable ID from competitor list").argument("<competitor-id>","Competitor UUID",Ue).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--yes","Confirm removal without an interactive prompt").action(async(t,e)=>{await y(),e.yes||(a("Refusing to remove a competitor without --yes."),process.exit(d.INVALID_INPUT));try{l(await m("deleteBrandCompetitor",{brandingId:e.brandingId,competitorId:t,teamId:e.teamId},er("deleteBrandCompetitor",[e.brandingId??"default",t])))}catch(n){wt(n,"Competitor removal failed")}}),oc=new je("competitor").description("List, add, update, or remove a brand's competitor watch rows").addCommand(Mh).addCommand(Fh).addCommand(Bh),Gh=new je("list").description("List one brand's social accounts with stable IDs, platforms, sources, and URLs").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async t=>{await y();try{l(await m("listBrandSocialHandles",{brandingId:t.brandingId,teamId:t.teamId}))}catch(e){wt(e,"Social-account list failed")}}),Wh=new je("add").description("Record one social account and print its stable saved row").argument("<platform>","Social network: x | instagram | facebook | linkedin | tiktok | youtube",b("platform",qh)).argument("<handle>","Account handle on that social network").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(t,e,n)=>{await y();try{l(await m("addBrandSocialHandle",{brandingId:n.brandingId,handle:e,platform:t,teamId:n.teamId},er("addBrandSocialHandle",[n.brandingId??"default",t,e.replace(/^@/,"")])))}catch(r){wt(r,"Social-account write failed")}}),Kh=new je("delete").description("Remove one social account by the stable ID from social list").argument("<handle-id>","Social-handle UUID",Ue).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",Ue).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--yes","Confirm removal without an interactive prompt").action(async(t,e)=>{await y(),e.yes||(a("Refusing to remove a social account without --yes."),process.exit(d.INVALID_INPUT));try{l(await m("deleteBrandSocialHandle",{brandingId:e.brandingId,handleId:t,teamId:e.teamId},er("deleteBrandSocialHandle",[e.brandingId??"default",t])))}catch(n){wt(n,"Social-account removal failed")}}),ic=new je("social").description("List, record, or remove the social accounts owned by a brand").addCommand(Gh).addCommand(Wh).addCommand(Kh);import{createHash as Jh}from"crypto";import{Command as ac}from"commander";var zh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Hh(t){zh.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Xh(t){return Jh("sha256").update(t).digest("hex").slice(0,32)}var sc=new ac("sync").description("Update linked decks from their brand; waits by default, versions decks, and prints JSON").argument("<brand-id>","Brand profile ID").option("--no-wait","Return a run ID; resume with `branding sync-status <run-id>`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Hh(t);let n={brandId:t,teamId:e.teamId};try{let r=await m("syncBrandToPresentations",n,Xh(`syncBrandToPresentations:${t}`));if(e.wait===!1){l(r);return}l(await ss(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Sync failed"),process.exit(d.GENERAL_ERROR)}}),dc=new ac("sync-status").description("Print linked-deck sync progress, terminal result, or error").argument("<run-id>","Run ID from `branding sync --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("syncBrandToPresentations",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});import{readFile as Yh}from"fs/promises";import{randomUUID as Qh}from"crypto";import{Command as cc}from"commander";var Zh=["color.primary","color.background","color.text","color.secondary","color.accent","color.surface","color.link","typography.primary","typography.secondary","typography.h1","typography.h2","typography.h3","typography.h4","typography.h5","typography.h6","typography.paragraph","typography.button","typography.small","typography.label","typography.caption","asset.logo","asset.logo.dark","asset.favicon"];function ey(t){let e=t.split(".").filter(Boolean);for(let n=e.length;n>=2;n--){let r=e.slice(0,n).join(".");if(Zh.includes(r))return{fieldPath:e.slice(n),nodeKey:r}}return{fieldPath:e.slice(2),nodeKey:e.slice(0,2).join(".")}}function ty(t){let e={};for(let n of t){let r=n.indexOf("=");if(r<=0)throw new Error(`"${n}" is not a token assignment. Use key=value, e.g. color.primary=#114b97`);let o=n.slice(0,r).trim(),i=n.slice(r+1);if(o.split(".").filter(Boolean).length<2)throw new Error(`"${o}" is not a brand token key. Expected something like color.primary or typography.h1.size`);let{fieldPath:c,nodeKey:p}=ey(o),f=ny(i);if(c.length===0){e[p]=f;continue}let h=e[p],v=h&&typeof h=="object"&&!Array.isArray(h)?h:{},x=v;for(let $ of c.slice(0,-1)){let A=x[$],S=A&&typeof A=="object"&&!Array.isArray(A)?A:{};x[$]=S,x=S}x[c[c.length-1]]=f,e[p]=v}return e}function ny(t){return t==="true"?!0:t==="false"?!1:/^-?\d+(?:\.\d+)?$/.test(t)?Number(t):t}function ry(t,e){return t===void 0?{assignments:[...e]}:t.includes("=")?{assignments:[t,...e]}:{assignments:[...e],brandId:t}}var lc=new cc("profile").description("Read a brand's design tokens, the keys it is missing, or its design.md").argument("[brand-id]","Brand ID (defaults to this workspace's brand)").option("--format <format>","tokens (default) or md").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{let n=await m("getBrandProfile",{brandId:t,format:e.format,teamId:e.teamId});if(e.format==="md"&&typeof n.designMd=="string"){console.log(n.designMd);return}l(n)}catch(n){a(n instanceof Error?n.message:"Profile read failed"),process.exit(d.GENERAL_ERROR)}}),mc=new cc("set").description("Write brand design tokens (key=value pairs or a design.md)").argument("[brand-id]","Brand ID (defaults to this workspace's brand)").argument("[tokens...]","Token assignments, e.g. color.primary=#114b97 typography.h1.size=32px").option("--design-md <path>","Apply a whole design.md file instead").option("--no-publish","Stage the change without publishing a new active brand version").option("--team-id <id>","Workspace ID").option("--yes","Confirm writing brand data").action(async(t,e,n)=>{n.yes||(a("Pass --yes to confirm writing brand tokens."),process.exit(d.INVALID_INPUT));let{assignments:r,brandId:o}=ry(t,e),i;try{i=r.length>0?ty(r):void 0}catch(c){a(c instanceof Error?c.message:"Invalid token pair"),process.exit(d.INVALID_INPUT)}let s;if(n.designMd)try{s=await Yh(n.designMd,"utf8")}catch(c){a(`Could not read ${n.designMd}: ${c instanceof Error?c.message:String(c)}`),process.exit(d.INVALID_INPUT)}!i&&!s&&(a("Nothing to write. Pass token assignments (color.primary=#114b97) or --design-md <file>."),process.exit(d.INVALID_INPUT));try{l(await m("updateBrandTokens",{brandId:o,designMd:s,publish:n.publish===!1?!1:void 0,teamId:n.teamId,tokens:i},Qh()))}catch(c){a(c instanceof Error?c.message:"Write failed"),process.exit(d.GENERAL_ERROR)}});import{createHash as oy}from"crypto";import{Command as rr}from"commander";var iy=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,nr=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function jo(t){iy.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function uc(t){return oy("sha256").update(t).digest("hex").slice(0,32)}function pc(t){if(nr.includes(t))return t;a(`"${t}" is not a channel. Pass one of: ${nr.join(", ")}.`),process.exit(d.INVALID_INPUT)}function tr(t){return t===""?null:t}function Uo(t,e){if(e==="")return null;let n;try{n=JSON.parse(e)}catch(r){a(`${t} is not valid JSON: ${r instanceof Error?r.message:String(r)}`),process.exit(d.INVALID_INPUT)}return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${t} must be a JSON object.`),process.exit(d.INVALID_INPUT)),n}function ay(t,e){if(e==="true")return!0;if(e==="false")return!1;a(`${t} takes "true" or "false", not "${e}".`),process.exit(d.INVALID_INPUT)}function sy(t){if(t==="")return null;let e=Number(t);return Number.isInteger(e)||(a(`--max-seconds takes a whole number of seconds, not "${t}".`),process.exit(d.INVALID_INPUT)),e}var dy=new rr("list").description("List a brand's per-channel design variants").argument("<brand-id>","Brand profile ID").option("--channel <key>",`One of: ${nr.join(", ")}`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),jo(t),e.channel!==void 0&&pc(e.channel);try{l(await m("listBrandVariants",{brandId:t,channelKey:e.channel,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"List failed"),process.exit(d.GENERAL_ERROR)}}),cy=new rr("set").description("Create or update one per-channel brand design variant").argument("<brand-id>","Brand profile ID").option("--variant <slug>","Variant slug; omit to create one with a new slug").option("--channel <key>",`One of: ${nr.join(", ")}`).option("--name <name>","Display name for the variant").option("--default <true|false>","Make this the channel's default, or drop the role").option("--colors <json>",`Palette as JSON, e.g. '{"primary":"#155DAC","background":"#FFFFFF","text":"#111111"}'`).option("--logo-treatment <json>",'Logo backdrop as JSON; pass "" to clear').option("--background-gradient <json>",'Gradient document as JSON; pass "" to clear').option("--aspect <ratio>",'Aspect ratio, e.g. 16:9; pass "" to clear').option("--max-seconds <seconds>",'Longest runtime in seconds; pass "" to clear').option("--voice-tone <tone>",'Voice tone override; pass "" to clear').option("--opening-style <style>",'Opening style; pass "" to clear').option("--logo-position <position>",'Logo position; pass "" to clear').option("--constraints <text>",'Generator constraints; pass "" to clear').option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),jo(t),e.channel!==void 0&&pc(e.channel);let n={brandId:t,teamId:e.teamId};e.variant!==void 0&&(n.variantId=e.variant),e.channel!==void 0&&(n.channelKey=e.channel),e.name!==void 0&&(n.name=e.name),e.default!==void 0&&(n.isDefault=ay("--default",e.default)),e.colors!==void 0&&(n.colors=Uo("--colors",e.colors)),e.logoTreatment!==void 0&&(n.logoTreatment=Uo("--logo-treatment",e.logoTreatment)),e.backgroundGradient!==void 0&&(n.backgroundGradient=Uo("--background-gradient",e.backgroundGradient)),e.aspect!==void 0&&(n.aspect=tr(e.aspect)),e.maxSeconds!==void 0&&(n.maxSeconds=sy(e.maxSeconds)),e.voiceTone!==void 0&&(n.voiceOverride=e.voiceTone===""?null:{tone:e.voiceTone}),e.openingStyle!==void 0&&(n.openingStyle=tr(e.openingStyle)),e.logoPosition!==void 0&&(n.logoPosition=tr(e.logoPosition)),e.constraints!==void 0&&(n.constraints=tr(e.constraints));try{l(await m("setBrandVariant",n,e.variant===void 0?void 0:uc(`setBrandVariant:${t}:${e.variant}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(d.GENERAL_ERROR)}}),ly=new rr("delete").description("Remove one per-channel brand design variant").argument("<brand-id>","Brand profile ID").option("--variant <slug>","Variant slug to remove").option("--team-id <id>","Workspace ID").option("--yes","Skip the confirmation prompt").action(async(t,e)=>{await y(),jo(t),e.variant===void 0&&(a("Pass --variant <slug> to name the variant to remove. `branding variant list <brand-id>` prints the slugs."),process.exit(d.INVALID_INPUT)),!e.yes&&process.stdin.isTTY&&(a(`Refusing to delete variant "${e.variant}" without confirmation. This delete is permanent \u2014 re-run with --yes.`),process.exit(d.GENERAL_ERROR));try{l(await m("deleteBrandVariant",{brandId:t,teamId:e.teamId,variantId:e.variant},uc(`deleteBrandVariant:${t}:${e.variant}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),gc=new rr("variant").description("Per-channel brand design variant commands").addCommand(dy).addCommand(cy).addCommand(ly);import{createHash as my}from"crypto";import{Command as Vo}from"commander";var uy=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,qo=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function py(t){uy.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function gy(t){if(qo.includes(t))return t;a(`"${t}" is not a channel. Pass one of: ${qo.join(", ")}.`),process.exit(d.INVALID_INPUT)}function fy(t,e){let n;try{n=JSON.parse(e)}catch(r){a(`${t} is not valid JSON: ${r instanceof Error?r.message:String(r)}`),process.exit(d.INVALID_INPUT)}return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${t} must be a JSON object.`),process.exit(d.INVALID_INPUT)),n}function hy(t){return my("sha256").update(t).digest("hex").slice(0,32)}var yy=new Vo("generate").description("Generate a brand's per-channel design variants and gradients (replaces the previously generated set for the channel)").argument("[brand-id]","Brand profile ID; omit to generate a preview that is not saved").option("--channel <key>",`One of: ${qo.join(", ")}`).option("--name <name>","Brand name to generate against").option("--description <text>","What the brand is, as generator context").option("--tone <tone>","Tone hint, e.g. 'warm, confident'").option("--style <style>","Visual style hint, e.g. 'editorial, high contrast'").option("--colors <json>",`Palette as JSON, e.g. '{"primary":"#155DAC","background":"#FFFFFF","text":"#111111"}'. Required when no brand id is given.`).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),t!==void 0&&py(t),e.channel!==void 0&&gy(e.channel);let n={teamId:e.teamId};t!==void 0&&(n.brandId=t),e.channel!==void 0&&(n.channelKey=e.channel),e.name!==void 0&&(n.brandName=e.name),e.description!==void 0&&(n.brandDescription=e.description),e.tone!==void 0&&(n.brandTone=e.tone),e.style!==void 0&&(n.brandStyle=e.style),e.colors!==void 0&&(n.sourceColors=fy("--colors",e.colors));try{let r=await m("generateBrandVariations",n,hy(`generateBrandVariations:${t??"preview"}:${e.channel??"deck-16-9"}`));if(e.wait===!1){l(r);return}l(await ns(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(d.GENERAL_ERROR)}}),by=new Vo("status").description("Read a brand variations generation run").argument("<run-id>","Run ID from `branding variations generate --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("generateBrandVariations",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),fc=new Vo("variations").description("Generated brand design variations").addCommand(yy).addCommand(by);import{createHash as wy}from"crypto";import{Command as or}from"commander";var Mo=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Fo(t){Mo.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function vy(t,e){if(e==="head"||Mo.test(e))return e;a(`${t} must be a version id or "head".`),process.exit(d.INVALID_INPUT)}function Iy(t,e){if(Mo.test(e))return e;a(`${t} must be a version id from \`branding version list\`.`),process.exit(d.INVALID_INPUT)}function xy(t){return wy("sha256").update(t).digest("hex").slice(0,32)}var ky=new or("list").description("List a brand's published versions, newest first").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Fo(t);try{l(await m("listBrandVersions",{brandId:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"List failed"),process.exit(d.GENERAL_ERROR)}}),Ry=new or("diff").description("Compare two points in a brand's version history").argument("<brand-id>","Brand profile ID").option("--from <version-id>","Baseline version to compare against. Defaults to the brand's live version.").option("--to <version-id|head>","Version to compare. Defaults to head, the unpublished working draft.").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Fo(t);let n={brandId:t,teamId:e.teamId};e.from!==void 0&&(n.from=Iy("--from",e.from)),e.to!==void 0&&(n.to=vy("--to",e.to));try{l(await m("diffBrandVersions",n))}catch(r){a(r instanceof Error?r.message:"Diff failed"),process.exit(d.GENERAL_ERROR)}}),Cy=new or("publish").description("Publish the brand's working draft as a new live version").argument("<brand-id>","Brand profile ID").option("--label <text>","Short name for this version, unique within the brand (max 64 characters)").option("--notes <text>","What changed. Defaults to a changelog derived from the diff.").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Fo(t);let n={brandId:t,teamId:e.teamId};e.label!==void 0&&(n.label=e.label),e.notes!==void 0&&(n.notes=e.notes);try{l(await m("publishBrandVersion",n,xy(`publishBrandVersion:${t}:${e.label??"auto"}`)))}catch(r){a(r instanceof Error?r.message:"Publish failed"),process.exit(d.GENERAL_ERROR)}}),hc=new or("version").description("Brand version history commands").addCommand(ky).addCommand(Ry).addCommand(Cy);import{createHash as Sy}from"crypto";import{Command as rn}from"commander";var Ey=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Go(t){Ey.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Bo(t,e=[]){return[...e,t]}function yc(t){return Sy("sha256").update(t).digest("hex").slice(0,32)}var $y=new rn("get").description("Read a brand's Voice & Context document").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Go(t);try{l(await m("getBrandVoice",{brandId:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(d.GENERAL_ERROR)}}),Ty=new rn("set").description("Write a brand's Voice & Context document").argument("<brand-id>","Brand profile ID").option("--positioning <text>","Positioning and promise").option("--voice-tone <text>","How the brand sounds").option("--authoritative-facts <text>","Facts generated content must never contradict").option("--approved-language <text>","Wording the brand endorses").option("--guardrails <text>","What the brand must never say or do").option("--sources <json>",`Provenance as JSON, e.g. '[{"kind":"url","name":"About page"}]'. Omitting this clears the recorded provenance.`).option("--replace","Acknowledge that this replaces the WHOLE document: sections you omit are removed. Required when the payload would drop a section the brand has.").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Go(t);let n={brandId:t,teamId:e.teamId};if(e.positioning!==void 0&&(n.positioning=e.positioning),e.voiceTone!==void 0&&(n.voiceTone=e.voiceTone),e.authoritativeFacts!==void 0&&(n.authoritativeFacts=e.authoritativeFacts),e.approvedLanguage!==void 0&&(n.approvedLanguage=e.approvedLanguage),e.guardrails!==void 0&&(n.guardrails=e.guardrails),e.replace===!0&&(n.replace=!0),e.sources!==void 0)try{n.sources=JSON.parse(e.sources)}catch{a("--sources must be valid JSON (an array of source objects)."),process.exit(d.INVALID_INPUT)}try{l(await m("setBrandVoice",n,yc(`setBrandVoice:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(d.GENERAL_ERROR)}}),Ay=new rn("build").description("Draft a brand's Voice & Context document from source material").argument("<brand-id>","Brand profile ID").option("--url <url>","Page to read; repeat for several",Bo).option("--text <text>","Pasted source material; repeat for several",Bo).option("--file <name:source>","Document to read, as name:source; repeat for several",Bo).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Go(t);let n={brandId:t,teamId:e.teamId};e.url?.length&&(n.urls=e.url),e.text?.length&&(n.text=e.text),e.file?.length&&(n.files=e.file.map(r=>{let o=r.indexOf(":");return(o<=0||o===r.length-1)&&(a(`--file must be name:source; got "${r}".`),process.exit(d.INVALID_INPUT)),{name:r.slice(0,o),source:r.slice(o+1)}})),!e.url?.length&&!e.text?.length&&!e.file?.length&&(a("Pass at least one --url, --text or --file to draft from."),process.exit(d.INVALID_INPUT));try{let r=await m("buildBrandVoice",n,yc(`buildBrandVoice:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await os(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Build failed"),process.exit(d.GENERAL_ERROR)}}),Py=new rn("build-status").description("Read a brand voice build run").argument("<run-id>","Run ID from `branding voice build --no-wait`").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{l(await I("buildBrandVoice",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),bc=new rn("voice").description("Brand voice and context commands").addCommand($y).addCommand(Ty).addCommand(Ay).addCommand(Py);function Ly(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<0)throw new wc(`${t} expects a whole number of 0 or more.`);return n}}function Uy(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<1)throw new wc(`${t} expects a whole number of 1+.`);return n}}var jy=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,qy=50;function Vy(t){let e=t.extractedFrom??t.normalizedUrl??null,n=Lo(t),r=nc(t),o=_o(t);if(ge("Brand Profile"),console.log(),C("ID",t.id),C("Name",t.name),C("Source URL",e??F.gray("None")),C("Default",t.isDefault?F.green("Yes"):"No"),t.createdAt&&C("Created",new Date(t.createdAt).toLocaleString()),console.log(),n||r.length>0){if(console.log(F.bold(" Colors")),n&&console.log(` Primary: ${F.bgHex(n)(" ")} ${n}`),r.length>0){console.log(" Palette:");for(let h of r.slice(0,10)){let v=h.role?F.gray(` (${h.role})`):"";console.log(` ${F.bgHex(h.hex)(" ")} ${h.hex}${v}`)}}console.log()}o&&(console.log(F.bold(" Logo")),console.log(` ${o}`),console.log());let i=t.brandData?.typography,s=t.resolvedTokens?.headingFont??i?.primary??i?.headings,c=t.resolvedTokens?.bodyFont??i?.secondary??i?.body;(s||c)&&(console.log(F.bold(" Typography")),console.log(` Headings: ${s??"-"}`),console.log(` Body: ${c??"-"}`),console.log());let p=t.brandData?.confidence,f=t.brandData?.extractionMethod;(typeof p=="number"||typeof f=="string")&&(console.log(F.bold(" Extraction")),typeof p=="number"&&console.log(` Confidence: ${Math.round(p*100)}%`),typeof f=="string"&&console.log(` Method: ${f}`),console.log()),console.log(F.gray(" Use --format json for full details")),console.log()}var vc=new vt("branding").description("Read and manage workspace brands, design rules, assets, permissions, and social presence").addCommand(lc).addCommand(mc).addCommand(vd).addCommand(Gd).addCommand(Wd).addCommand(new vt("list").description("List accessible brands as a table or paged JSON").option("--search <text>","Filter by brand name or website/domain; an exact brand id also matches").option("--filter <filter>","Which slice to return (all, mine, team)",b("--filter",["all","mine","team"])).option("--sort <sort>","Sort key (created, name, updated)",b("--sort",["created","name","updated"])).option("--shape <shape>","Result shape: list (paged rows, default) or chat (compact matches)",b("--shape",["chat","list"])).option("--limit <n>","Page size (server default: 12 for the list shape, 50 for chat)",Uy("--limit")).option("--offset <n>","Brands to skip before the page",Ly("--offset")).option("--team-id <id>","Workspace ID").option("--json","Print the complete JSON response instead of a table").action(async t=>{await y();try{let e=t.shape??"list",n=await m("listBrandings",{filter:t.filter,limit:t.limit,offset:t.offset,search:t.search,shape:e,sort:t.sort,teamId:t.teamId});if(t.json){l(n);return}let r=rc(n);if(r.length===0){w("No brand profiles found"),console.log(),console.log(F.gray(`Create one with: ${u.commands[0]} branding extract <url>`));return}console.log(sa(r));let o=t.offset??0;No(n)?n.hasMore&&console.log(F.gray(` ${o+r.length} of ${n.total}. Next page: --offset ${o+r.length}`)):r.length>=(t.limit??qy)&&console.log(F.gray(` Showing ${r.length} from --offset ${o}; there may be more. Next page: --offset ${o+r.length}`))}catch(e){a(e instanceof Error?e.message:String(e)),process.exit(e.exitCode??1)}})).addCommand(new vt("get").description("Read one brand as a summary or complete JSON").argument("<id>","Brand profile ID").option("-f, --format <format>","Output format (summary, json)",b("--format",["summary","json"]),"summary").option("-o, --output <path>","Save JSON to file").option("--team-id <id>","Workspace ID").action(async(t,e)=>{if(await y(),!jy.test(t)){a(`"${t}" is not a brand id. Pass the UUID from \`${u.commands[0]} branding list\`, or search by name with \`${u.commands[0]} branding find <query>\`.`),process.exit(d.INVALID_INPUT);return}try{let r=(await m("listBrandings",{limit:1,search:t,shape:"list",teamId:e.teamId})).items?.[0];if(!r){a(`No brand profile with id ${t} is accessible.`),process.exit(d.NOT_FOUND);return}if(e.output){await Ny(e.output,JSON.stringify(r,null,2)),k(`Brand profile saved to ${e.output}`);return}if(e.format==="json"){console.log(JSON.stringify(r,null,2));return}Vy(r)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}})).addCommand(new vt("find").description("Print matching brand IDs for an exact name, domain, or website URL").argument("<query>","Brand name or website URL to search for").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y();try{let r=(await m("listBrandings",{search:t,shape:"chat",teamId:e.teamId})).brandings;if(r.length===0){w(`No brand profiles matching "${t}"`),console.log(F.gray(` Extract one with: ${u.commands[0]} branding extract <url>`));return}console.log(`Found ${r.length} brand${r.length>1?"s":""}:
|
|
72
|
-
`);for(let o of r){let i=o.primaryColor?`${F.bgHex(o.primaryColor)(" ")} ${o.primaryColor}`:"";console.log(` ${F.bold(o.name)} ${F.gray(o.id)}`),o.domain&&console.log(` ${F.gray(o.domain)}`),i&&console.log(` ${i}`),console.log()}console.log(F.gray(` Export with: ${u.commands[0]} branding get <id> -o branding.json`))}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}})).addCommand(new vt("extract").description("Start paid website extraction and print a run ID for `branding status`").argument("<url>","Website URL to extract branding from").option("--team-id <id>","Workspace ID; defaults to your configured workspace").option("--yes","Confirm you intend to start a paid extraction. Intent only: approval still requires --approval-receipt").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL; omit on the first call to be given that URL").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin so it is not exposed in process arguments").option("--idempotency-key <key>","Stable key bound into the approval receipt; pass the same one when retrying with the receipt").option("--skip-existing-lookup","Extract this exact URL even when the workspace already has related brands").action(async(t,e)=>{await y(),e.yes||(a("Pass --yes to confirm brand extraction."),process.exit(d.INVALID_INPUT));try{new URL(t.startsWith("http")?t:`https://${t}`)}catch{a("Invalid URL format"),process.exit(6)}let n=t.startsWith("http")?t:`https://${t}`,r=e.teamId??ee(),o=e.idempotencyKey??Oy();e.approvalReceipt&&e.approvalReceiptStdin&&(a("Pass only one approval receipt input mode."),process.exit(d.INVALID_INPUT));let i=e.approvalReceiptStdin?Dy(0,"utf8").trim():e.approvalReceipt;e.approvalReceiptStdin&&!i&&(a("No approval receipt was provided on stdin."),process.exit(d.INVALID_INPUT));let s=_y({text:`Extracting branding from ${n}...`,stream:process.stdout}).start(),c;try{let p=await Oa(n,r,i,e.skipExistingLookup,o);if(p.status==="needs_choice"){s.stop(),w(`This workspace already has ${p.matches.length} related brand${p.matches.length===1?"":"s"} for ${n}. Nothing was extracted and nothing was charged.`),console.log();for(let f of p.matches)console.log(` ${F.bold(f.name??"Untitled")}`),console.log(` ${F.gray(f.id)}`),f.extractedFrom&&console.log(` ${F.gray(f.extractedFrom)}`);console.log(),w(`Use one of the above, or re-run with --skip-existing-lookup to extract ${n} anyway.`),c=d.INVALID_INPUT}else s.succeed("Brand extraction started"),console.log(JSON.stringify(p,null,2)),w(`Check progress with: ${u.commands[0]} branding status ${p.runId}`),console.log()}catch(p){let f=p instanceof Error?p.message:String(p);f.includes("approval")&&(s.stop(),a(f),console.log(),w(`Retry with the receipt and the same key: --approval-receipt <receipt> --idempotency-key ${o}`),process.exit(d.INVALID_INPUT)),s.fail("Extraction failed"),a(f),process.exit(p.exitCode??1)}c!==void 0&&process.exit(c)})).addCommand(new vt("status").description("Print a brand extraction run's current state, error, or result").argument("<run-id>","Run ID returned by branding extract").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await I("extractBranding",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}})).addCommand(Pd).addCommand(Ad).addCommand(Nd).addCommand(Od).addCommand(_d).addCommand(Ld).addCommand(Ud).addCommand(Dd).addCommand(oc).addCommand(jd).addCommand(xd).addCommand(kd).addCommand(Sd).addCommand(Zd).addCommand(gc).addCommand(fc).addCommand(hc).addCommand(bc).addCommand($d).addCommand(tc).addCommand(Kd).addCommand(Jd).addCommand(sc).addCommand(dc).addCommand(zd).addCommand(ic);import on from"chalk";import{Command as It}from"commander";function My(t){switch(t.background){case"color":{if(!t.backgroundColor)throw new Error("--background color needs --background-color <hex>, e.g. #1d4ed8");return{hex:t.backgroundColor,kind:"color"}}case"image":{if(!t.backgroundImage)throw new Error("--background image needs --background-image <url>");return{fit:t.fit,kind:"image",url:t.backgroundImage}}default:return{kind:t.background}}}function Ic(t,e){return{background:My(e),name:t,presenterProfileId:e.presenter,...e.voiceId?{voiceId:e.voiceId}:{}}}function ir(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.id);return}k(`${t.name} (${t.id})`),w(` Presenter: ${t.presenterProfileId}`),w(` Backdrop: ${Fy(t.background)}`),t.voiceId&&w(` Voice: ${t.voiceId}`)}function Fy(t){switch(t.kind){case"color":return`color ${t.hex}`;case"image":return`image ${t.url} (${t.fit})`;default:return t.kind}}function xc(t){return t.requiredOption("--presenter <profileId>",`Trained personal presenter id (pp_*), from \`${u.commands[0]} avatar options\``).option("--background <kind>","Backdrop: original, transparent, color, or image","original").option("--background-color <hex>","Backdrop color, e.g. #1d4ed8").option("--background-image <url>","Backdrop image URL").option("--fit <fit>","How an image backdrop fills the frame","cover").option("--voice-id <voiceId>","Workspace voice to save with this preset").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human")}var By=new It("list").description("List saved cast presets you can use").option("--cast-member-id <castMemberId>","Only this person's presets").option("--branding-id <brandingId>","Narrow to one brand").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{try{let e=await ds({...t.brandingId?{brandingId:t.brandingId}:{},...t.castMemberId?{castMemberId:t.castMemberId}:{}});if(t.format==="json"){l(e);return}if(t.format==="quiet"){for(let n of e.presets)console.log(n.id);return}if(e.presets.length===0){w("No presets saved yet.");return}for(let n of e.presets)ir(n,"human")}catch(e){a(e instanceof Error?e.message:String(e)),process.exit(d.API_ERROR)}}),Gy=xc(new It("create").description("Save one way a cast member appears").argument("<name>",'What to call this preset, e.g. "In the cafe"').requiredOption("--cast-member-id <castMemberId>","The person this preset is a way of showing")).action(async(t,e)=>{try{let n=await cs({castMemberId:e.castMemberId,...Ic(t,e)});ir(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),Wy=xc(new It("update").description("Change a saved preset (sends the complete preset)").argument("<presetId>","The preset to change").requiredOption("--name <name>","What to call it")).action(async(t,e)=>{try{let n=await ls({presetId:t,...Ic(e.name,e)});ir(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),Ky=new It("delete").description("Retire a saved preset. Existing videos keep working.").argument("<presetId>","The preset to retire").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await ms(t);if(e.format==="human"){k(`Retired "${n.preset.name}".`);return}ir(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),Jy=new It("preset").description("Saved ways a cast member appears").addCommand(By).addCommand(Gy).addCommand(Wy).addCommand(Ky),Wo=new It("cast").description("The faces and voices your videos can use").addCommand(Jy);Wo.addHelpText("after",`
|
|
73
|
-
${on.bold("
|
|
74
|
-
|
|
75
|
-
$
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
$
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
$
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
${
|
|
89
|
-
|
|
90
|
-
$
|
|
91
|
-
|
|
92
|
-
${
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
$
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
$
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
${
|
|
107
|
-
$ ${
|
|
108
|
-
`);import{Command as
|
|
109
|
-
|
|
110
|
-
`)}var Nc=new Ab("get").description("Get presentation details").argument("<slug>","Presentation slug (e.g., my-presentation-v1-abc123)").option("-f, --format <format>","Output format (summary, full, json)",b("--format",["summary","full","json"]),"summary").option("--include <fields>","Legacy fields list (comma-separated: slides,styling)").option("--include-slides","Include ordered slide content",!0).option("--no-include-slides","Omit slide content for a smaller response").option("-l, --language <lang>","Language for view URL","en").option("--team-id <id>","Workspace ID (uses configured default)").action(async function(t,e){await y();try{let n=this.getOptionValueSource("includeSlides")==="cli"?e.includeSlides:this.getOptionValueSource("include")==="cli"?Pb(e.include).has("slides"):!0,r=e.teamId??ee();if(!r)throw new Error("Team ID required. Set one with 'mf config set team-id <id>' or pass --team-id.");let o=await dt(t,{includeSlides:n,teamId:r});if(e.format==="json"){console.log(JSON.stringify(o,null,2));return}let i=at(o.slug,e.language);ge("Presentation Details"),console.log(),C("Slug",o.slug),C("Title",o.title||"Untitled"),C("Description",o.description||et.gray("None")),C("Slides",String(o.numberOfSlides||"-")),C("Mode",o.mode||"-"),C("Created",Fr(o.createdAt)),o.updatedAt&&C("Updated",Fr(o.updatedAt)),console.log(),i!=="N/A"&&console.log(et.bold(" Open: ")+et.cyan.underline(i)),console.log(),n&&Ob(o.slides)}catch(n){a(n instanceof Error?n.message:String(n));let r=n&&typeof n=="object"&&"exitCode"in n&&typeof n.exitCode=="number"?n.exitCode:1;process.exit(r)}});import{randomUUID as Db}from"crypto";import{Command as cr}from"commander";import Nb from"ora";function _b(t){let e=t?.trim().toLowerCase();if(!(!e||e==="any"||e==="all"))return e==="web"||e==="stock"?[e]:void 0}function Lb(t){let e=t.assetType??"image";if(e!=="image"&&e!=="icon")throw new Error("Asset type must be image or icon");let n;if(t.maxResults&&(n=Number.parseInt(t.maxResults,10),Number.isNaN(n)||n<1))throw new Error("Max results must be a positive number");return{query:e==="icon"?`${t.query.trim()} transparent icon isolated symbol`:t.query.trim(),options:{maxResults:n||10,size:t.size,safeSearch:t.safeSearch,assetType:e,sources:_b(t.source),transparentBackground:e==="icon"}}}function Ub(t){let e=t.url||t.imageUrl;if(!e)throw new Error("Image search returned a result without a URL");return e}function jb(t){return t.transparent??t.isTransparent??t.metadata?.transparent??t.metadata?.isTransparent}function qb(t){let e=[],n=t.reduce((r,o)=>Math.max(r,o.length),0);for(let r=0;r<n;r+=1)for(let o of t){let i=o[r];i!==void 0&&e.push(i)}return e}function Vb(t,e){let n=t.data.results.map(r=>r.results.map(o=>{let i=o,s=jb(i);if(e==="icon"&&s!==!0)throw new Error("Icon search returned a result without a verified transparent background");return{...i,url:Ub(i),provider:r.providerName,assetType:e,...s!==void 0?{transparent:s}:{}}}));return qb(n)}function Mb(t){return t.error||t.status==="failed"||t.status==="errored"||t.status==="cancelled"?"failed":t.done||t.status==="completed"?"completed":t.status==="in_progress"?"processing":"pending"}function dr(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function Fb(t){return{requestId:t.runId,status:Mb(t),...t.entity?.url?{url:t.entity.url}:{},...t.error?{error:se(t.error)}:{},...dr(t.output?.width)!==void 0?{width:dr(t.output?.width)}:{},...dr(t.output?.height)!==void 0?{height:dr(t.output?.height)}:{}}}async function _c(t,e){return Fb(await I("createImage",t,e))}function Qo(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.output??t.url??t.requestId);return}w(`Request ID: ${t.requestId}`),w(`Status: ${t.status}`),t.url&&k(`Image URL: ${t.url}`),t.output&&k(`Saved to: ${t.output}`),t.error&&a(`Error: ${t.error}`)}var Bb=new cr("search").description("Search images across the web and licensed stock").requiredOption("-q, --query <query>","Search query").option("-n, --max-results <number>","Maximum number of results (default: 10)").option("-s, --size <size>","Image size: small, medium, large, any","large").option("--asset-type <type>","Asset intent: image or transparent icon","image").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("--safe-search","Enable safe search (default: true)",!0).option("--no-safe-search","Disable safe search").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.format,n=e==="human"?Nb("Searching for images...").start():null,r;try{r=Lb(t)}catch(o){n?.stop(),a(o instanceof Error?o.message:"Invalid image search request"),process.exit(d.INVALID_INPUT);return}try{let o=await Ma(r);n?.stop(),o.success||(a("Search failed"),process.exit(d.GENERAL_ERROR));let i=r.options?.assetType??"image",s=Vb(o,i);if(e==="json"){l({success:!0,query:t.query,assetType:i,totalResults:s.length,images:s});return}if(e==="quiet"){for(let c of s)console.log(c.url);return}if(s.length===0){w("No images found");return}k(`Found ${s.length} images for "${t.query}"`),console.log();for(let c=0;c<s.length;c++){let p=s[c];console.log(`[${c+1}] ${p.title||"Untitled"}`),console.log(` URL: ${p.url}`),console.log(` Size: ${p.width}x${p.height}`),p.author&&console.log(` Author: ${p.author}`),console.log(` Provider: ${p.provider}`),console.log()}}catch(o){n?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Gb=new cr("generate").description("Generate an image and optionally save it locally").argument("[prompt]","Image prompt").option("-p, --prompt <text>","Image prompt (named compatibility form)").option("--provider <provider>","Provider override").option("--model <model>","Model override").option("--purpose <purpose>","Explicit image intent: general, draft, infographic, brand-max, or vector; omitted means general",b("--purpose",["general","draft","infographic","brand-max","vector"])).option("--width <pixels>","Width").option("--height <pixels>","Height").option("--team-id <id>","Workspace ID").option("--reference-image <label=path-or-url...>","Image the generation must follow: a local file (uploaded for you, never resized) or a public HTTP(S) URL. Repeatable. Prefix an optional label, e.g. identity=./face.jpg, style=https://\u2026/mood.png. Fidelity depends on the routed model: the auto-routed one returns a similar-looking subject, while --provider google-ai --model gemini-3-pro-image returns the same person \u2014 but that pin takes effect only on workspaces holding the internal image-model-override flag").option("--idempotency-key <key>","Stable retry key for this generation and its reference uploads").option("-o, --output <path>","Local output path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").option("--yes","Approve generation").action(async(t,e)=>{let n,r=t??e.prompt;r?.trim()||(a("Provide an image prompt as an argument or with --prompt"),process.exit(d.INVALID_INPUT)),e.yes||(a("Pass --yes to approve image generation"),process.exit(d.INVALID_INPUT)),!e.wait&&e.output&&(a("--output requires waiting for completion; remove --no-wait"),process.exit(d.INVALID_INPUT)),(e.provider||e.model)&&_("--provider/--model are honoured only for workspaces holding the internal image-model-override flag. Without it the server drops them and routes the request itself.",e.format),e.referenceImage?.length&&!e.model&&_("Reference images without --model route to a light model that returns a similar-looking, not identical, subject. A recognisable likeness needs --provider google-ai --model gemini-3-pro-image on a workspace with the image-model-override flag.",e.format);let o=e.idempotencyKey??Db();try{let i=await Gn(e.referenceImage,{idempotencyKey:o,rejectNonImageFiles:!0}),s=await m("createImage",{approvalReceipt:"cli:--yes",height:e.height?Number.parseInt(e.height,10):void 0,model:e.model,prompt:r.trim(),provider:e.provider,...e.purpose?{purpose:e.purpose}:{},...i?{referenceImages:i}:{},teamId:e.teamId,width:e.width?Number.parseInt(e.width,10):void 0},o);if(n=s.runId,!e.wait){Qo({requestId:s.runId,status:"pending"},e.format);return}let c=await ce(()=>_c(s.runId,e.teamId),180,2e3);if(c.status==="failed")throw new Error(c.error||"Image generation failed");if(!c.url)throw new Error("Image generation completed without an image URL");let p=e.output?{...c,output:e.output}:c;e.output&&await te(c.url,e.output),Qo(p,e.format)}catch(i){a(fe(i,n),e.format),process.exit(d.GENERAL_ERROR)}}),Wb=new cr("status").description("Read image generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").option("-o, --output <path>","Download a completed image").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await _c(t,e.teamId);if(e.output){if(n.status!=="completed"||!n.url)throw new Error("Image generation is not complete");await te(n.url,e.output),n.output=e.output}Qo(n,e.format)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Lc=new cr("image").description("Image search and generation commands").addCommand(Bb).addCommand(Gb).addCommand(Wb);import{Command as Zo}from"commander";var Kb=new Zo("search").description("Search the workspace Knowledge Hub").argument("[query]","Optional search query").option("--team-id <id>","Workspace ID").option("--kind <kind>","Knowledge kind").option("--limit <count>","Maximum results","10").action(async(t,e)=>{try{l(await m("searchKnowledge",{kind:e.kind,limit:Number.parseInt(e.limit,10),query:t,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Knowledge search failed"),process.exit(d.GENERAL_ERROR)}}),Jb=new Zo("bundle").description("Read a bounded Open Knowledge Format bundle").option("--team-id <id>","Workspace ID").option("--kind <kind>","Knowledge kind").action(async t=>{try{l(await m("getKnowledgeBundle",{kind:t.kind,teamId:t.teamId}))}catch(e){a(e instanceof Error?e.message:"Knowledge bundle failed"),process.exit(d.GENERAL_ERROR)}}),Uc=new Zo("knowledge").description("Search the workspace Knowledge Hub and read bounded knowledge bundles").addCommand(Kb).addCommand(Jb);import{randomUUID as zb}from"crypto";import lr from"chalk";import{Command as Oe}from"commander";function ei(t){if(t!==void 0)return t==="root"?null:t}function xt(t){return`cli:library:${t}:${zb()}`}function tt(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Hb=new Oe("list").description("List the Library folder tree").option("--team-id <id>","Workspace ID").option("--counts","Include how many items are in each folder").action(async t=>{try{l(await m("listLibraryFolders",{includeEntryCounts:!!t.counts,teamId:t.teamId}))}catch(e){tt(e,"Could not list folders")}}),Xb=new Oe("create").description("Create a Library folder").argument("<name>","Folder name").option("--team-id <id>","Workspace ID").option("--parent <id>","Parent folder id; omit for a top-level folder").option("--color <color>","Colour token (slate, blue, green, amber, red, violet)").action(async(t,e)=>{try{l(await m("createLibraryFolder",{color:e.color,name:t,parentId:ei(e.parent),teamId:e.teamId},xt("create")))}catch(n){tt(n,"Could not create the folder")}}),Yb=new Oe("rename").description("Rename a Library folder").argument("<folder-id>","Folder id").argument("<name>","New name").option("--team-id <id>","Workspace ID").action(async(t,e,n)=>{try{l(await m("renameLibraryFolder",{folderId:t,name:e,teamId:n.teamId},xt("rename")))}catch(r){tt(r,"Could not rename the folder")}}),Qb=new Oe("recolor").description("Set or clear a Library folder's colour").argument("<folder-id>","Folder id").requiredOption("--color <color>","Colour token (slate, blue, green, amber, red, violet), or 'none' to clear").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("recolorLibraryFolder",{color:e.color==="none"?null:e.color,folderId:t,teamId:e.teamId},xt("recolor")))}catch(n){tt(n,"Could not recolour the folder")}}),Zb=new Oe("move").description("Move a Library folder under a new parent").argument("<folder-id>","Folder id").requiredOption("--to <id>","New parent folder id, or 'root' for top level").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("moveLibraryFolder",{folderId:t,newParentId:ei(e.to),teamId:e.teamId},xt("move")))}catch(n){tt(n,"Could not move the folder")}}),ew=new Oe("delete").description("Delete a folder and its subfolders; items inside are unfiled").argument("<folder-id>","Folder id").requiredOption("--yes","Confirm deletion").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("deleteLibraryFolder",{folderId:t,teamId:e.teamId},xt("delete")))}catch(n){tt(n,"Could not delete the folder")}}),tw=new Oe("folders").description("Manage Library folders").addCommand(Hb).addCommand(Xb).addCommand(Yb).addCommand(Qb).addCommand(Zb).addCommand(ew),nw=new Oe("file").description("File an artifact into a Library folder").argument("<kind>","Artifact kind, e.g. presentation or microsite").argument("<target-id>","Id of the artifact itself").requiredOption("--folder <id>","Destination folder id, or 'root' to unfile the artifact").option("--team-id <id>","Workspace ID").action(async(t,e,n)=>{try{l(await m("fileArtifactIntoFolder",{folderId:ei(n.folder),kind:t,targetId:e,teamId:n.teamId},xt("file")))}catch(r){tt(r,"Could not file that item")}}),ti=new Oe("library").description("Library folders and filing").addCommand(tw).addCommand(nw);ti.addHelpText("after",`
|
|
111
|
-
${
|
|
112
|
-
${
|
|
113
|
-
$ ${
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
${
|
|
117
|
-
${
|
|
118
|
-
|
|
119
|
-
`);import{Command as cn}from"commander";function R(t,e){let n={...e},r=t.parent,o=!1;for(;r;){let i=r.opts?.();if(i){o=!0;for(let[s,c]of Object.entries(i))n[s]===void 0&&c!==void 0&&(n[s]=c)}r=r.parent}return o?n:e}var jc=new cn("analyze").description("Transcribe an uploaded recording and publish it for generation").argument("<asset-id>","Recording ID").option("--language <code>","BCP-47 language hint for the spoken audio").option("--no-diarize","Skip speaker attribution (cheaper, but a multi-speaker recording becomes much weaker as generation input)").option("--team-id <id>","Workspace ID").option("--yes","Confirm the charge \u2014 billed per source-minute").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to confirm. Analysis is billed per minute of source audio.");try{l(await m("analyzeMediaAsset",{assetId:t,diarize:e.diarize,language:e.language,teamId:e.teamId}))}catch(n){a(n instanceof Error?n.message:"Analysis failed"),process.exit(d.GENERAL_ERROR)}}),rw=new cn("status").description("Read an analysis run's status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async function(t,e){let n=R(this,e);try{l(await I("analyzeMediaAsset",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});jc.addCommand(rw);var qc=new cn("import").description("Import a recording from a connected account").argument("<remote-file-id>","The provider's own ID for the recording").requiredOption("--provider <id>","Provider id of the connected account, e.g. google").requiredOption("--connector <id>","Connected account ID to read from").option("--title <title>","Name for the imported recording").option("--chat <id>","Chat this import was requested from").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("importConnectorRecording",{connectorId:e.connector,providerId:e.provider,remoteFileId:t,sourceChatId:e.chat,teamId:e.teamId,title:e.title}))}catch(n){a(n instanceof Error?n.message:"Import failed"),process.exit(d.GENERAL_ERROR)}}),ow=new cn("status").description("Read an import run's status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async function(t,e){let n=R(this,e);try{l(await I("importConnectorRecording",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});qc.addCommand(ow);var Vc=new cn("media").description("Ingest and transcribe recordings you already own").addCommand(jc).addCommand(qc);import{Command as ni}from"commander";var iw=new ni("create").description("Start background microsite generation").argument("<title>","Microsite title").requiredOption("--description <brief>","Microsite brief").option("--audience <audience>","Target audience").option("--tone <tone>","Tone").option("--language <language>","Content language","en").option("--branding-id <id>","Branding ID").option("--team-id <id>","Workspace ID").option("--yes","Approve generation").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to approve generation");try{l(await m("createMicrosite",{approvalReceipt:"cli:--yes",audience:e.audience,brandingId:e.brandingId,description:e.description,language:e.language,teamId:e.teamId,title:t,tone:e.tone}))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(d.GENERAL_ERROR)}}),aw=new ni("status").description("Read microsite generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await I("createMicrosite",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Mc=new ni("microsite").description("Generate a shareable multi-section web microsite from a brief").addCommand(iw).addCommand(aw);import{Command as ii}from"commander";import ri from"ora";function oi(t,e){if(e==="json"){l(t);return}if(e==="quiet"){t.outputUrl?console.log(t.outputUrl):console.log(t.requestId);return}w(`Request ID: ${t.requestId}`),w(`Status: ${t.status}`),t.duration&&w(`Duration: ${t.duration}s`),t.outputUrl&&k(`Output URL: ${t.outputUrl}`),t.error&&a(`Error: ${t.error}`)}var sw=new ii("create").description("Mix audio tracks into a video (music will loop to match video duration)").requiredOption("--video <url>","Input video file/URL").option("--music <url>","Background music file/URL (will loop if shorter than video)").option("--voice <url>","Voiceover file/URL").option("--music-volume <percent>","Music volume 0-100 (default: 30, recommended for mix with voice)","30").option("--voice-volume <percent>","Voice volume 0-100","100").option("-o, --output <path>","Output file path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{!t.music&&!t.voice&&(a("At least one of --music or --voice must be provided"),process.exit(d.INVALID_INPUT));let e=parseInt(t.musicVolume,10)/100,n=parseInt(t.voiceVolume,10)/100;(Number.isNaN(e)||e<0||e>1)&&(a("Music volume must be between 0 and 100"),process.exit(d.INVALID_INPUT)),(Number.isNaN(n)||n<0||n>2)&&(a("Voice volume must be between 0 and 200"),process.exit(d.INVALID_INPUT));let r=t.format,o=r==="human"?ri("Mixing audio...").start():null,i=[{url:t.video,role:"video"}];t.music&&i.push({url:t.music,role:"background",volume:e*5}),t.voice&&i.push({url:t.voice,role:"voice",volume:n*2});try{let s=await Va({operation:"add-to-video",inputs:i,options:{musicVolume:e,voiceVolume:n}});if(!t.wait){o?.stop(),oi(s,r);return}o&&(o.text=`Processing (ID: ${s.requestId})...`);let c=await ce(()=>eo(s.requestId),120,3e3);if(o?.stop(),c.status==="failed"&&(a(c.error||"Audio mixing failed"),process.exit(d.GENERAL_ERROR)),oi(c,r),t.output){if(!c.outputUrl)throw new Error("Audio mix completed without an output URL");let p=r==="human"?ri("Downloading...").start():null;await te(c.outputUrl,t.output),p?.stop(),r==="human"&&k(`Saved to: ${t.output}`)}}catch(s){o?.stop(),a(s instanceof Error?s.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),dw=new ii("status").description("Check status of an audio mix request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{let n=e.format==="human"?ri("Checking status...").start():null;try{let r=await eo(t);n?.stop(),oi(r,e.format)}catch(r){n?.stop(),a(r instanceof Error?r.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Fc=new ii("mix").description("Audio mixing commands").addCommand(sw).addCommand(dw);import{Command as si}from"commander";import fw from"ora";import{readFileSync as cw}from"fs";var Bc=500,Gc=1e4,mr=100,Wc=1e4,Kc=1e3,zc=["duration_s","idempotency_key","narration","schema_version","video_description"],lw=["end_s","id","start_s","text","words"],mw=["end","id","start","text"],uw=["description","end_s","id","start_s"];function Hc(t){let e=Yc(t);if(Qc(e),ln(e,zc,""),e.duration_s<3)throw new Error("Music request duration_s must be between 3 and 600");return e}function Xc(t){let e=Yc(t);Qc(e),ln(e,[...zc,"visual_event"],"");let n=e.visual_event;if(!ur(n))throw new Error("SFX request visual_event is required");if(ln(n,uw,"visual_event"),!Me(n.description))throw new Error("SFX request visual_event.description is required");if(!Me(n.id)||!Fe(n.start_s))throw new Error("SFX request visual_event requires id and start_s");if(n.end_s!==void 0&&(!Fe(n.end_s)||n.end_s<n.start_s))throw new Error("SFX request visual_event.end_s must be after start_s");return e}function Yc(t){try{let e=JSON.parse(cw(t,"utf8"));if(!ur(e))throw new Error("request must be a JSON object");return e}catch(e){throw new Error(`Cannot read audio request ${t}: ${e instanceof Error?e.message:String(e)}`)}}function Qc(t){if(t.schema_version!==1)throw new Error("Audio request schema_version must be 1");if(!Me(t.video_description))throw new Error("Audio request video_description is required");if(!Fe(t.duration_s)||t.duration_s<.5||t.duration_s>600)throw new Error("Audio request duration_s must be between 0.5 and 600");if(!Array.isArray(t.narration))throw new Error("Audio request narration must be an array");if(t.narration.length>Bc)throw new Error(`Audio request narration holds at most ${Bc} lines`);if(t.narration.forEach(pw),t.idempotency_key!==void 0&&!Me(t.idempotency_key))throw new Error("Audio request idempotency_key must be a non-empty string")}function pw(t,e){let n=`narration.${e}`;if(!ur(t))throw new Error(`Audio request ${n} must be an object`);if(ln(t,lw,n),!Me(t.id)||t.id.length>mr)throw new Error(`Audio request ${n}.id is required (1-${mr} characters)`);if(!Me(t.text)||t.text.trim().length>Wc)throw new Error(`Audio request ${n}.text is required (1-${Wc} characters)`);if(Jc(t.start_s,`${n}.start_s`),Jc(t.end_s,`${n}.end_s`),Fe(t.start_s)&&Fe(t.end_s)&&t.end_s<t.start_s)throw new Error(`Audio request ${n}.end_s must be greater than or equal to ${n}.start_s`);if(t.words!==void 0){if(!Array.isArray(t.words)||t.words.length>Gc)throw new Error(`Audio request ${n}.words must be an array of at most ${Gc} entries`);t.words.forEach((r,o)=>{gw(r,`${n}.words.${o}`)})}}function gw(t,e){if(!ur(t))throw new Error(`Audio request ${e} must be an object`);if(ln(t,mw,e),!Me(t.text)||t.text.trim().length>Kc)throw new Error(`Audio request ${e}.text is required (1-${Kc} characters)`);if(!Fe(t.start)||!Fe(t.end))throw new Error(`Audio request ${e} requires numeric start and end seconds`);if(t.end<t.start)throw new Error(`Audio request ${e}.end must be greater than or equal to ${e}.start`);if(t.id!==void 0&&(!Me(t.id)||t.id.length>mr))throw new Error(`Audio request ${e}.id must be 1-${mr} characters`)}function Jc(t,e){if(t!==void 0&&!Fe(t))throw new Error(`Audio request ${e} must be a non-negative number`)}function ln(t,e,n){let r=Object.keys(t).filter(i=>!e.includes(i));if(r.length===0)return;let o=n?`${n} `:"";throw new Error(`Audio request ${o}has unknown field(s): ${r.join(", ")}. Allowed: ${e.join(", ")}`)}function ur(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function Me(t){return typeof t=="string"&&t.trim().length>0}function Fe(t){return typeof t=="number"&&Number.isFinite(t)&&t>=0}function ai(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.audioUrl??t.requestId);return}w(`Request ID: ${t.requestId}`),w(`Status: ${t.status}`),t.duration&&w(`Duration: ${t.duration}s`),t.audioUrl&&k(`Audio URL: ${t.audioUrl}`),t.error&&a(`Error: ${t.error}`)}var hw=new si("generate").description("Generate music that follows a video's narration and final timing").requiredOption("--request <path>","JSON file with video description, narration, and final timing").option("-o, --output <path>","Output file path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{!t.wait&&t.output&&(a("--output requires waiting for completion; remove --no-wait"),process.exit(d.INVALID_INPUT));let e;try{e=Hc(t.request)}catch(i){a(i instanceof Error?i.message:String(i)),process.exit(d.INVALID_INPUT)}let n=t.format,r=n==="human"?fw("Generating music for video...").start():null,o;try{let i=await qa(e);if(o=i.requestId,!t.wait){r?.stop(),ai(i,n);return}r&&(r.text=`Processing (ID: ${i.requestId})...`);let s=i.status==="completed"||i.status==="failed"?i:await ce(()=>Zr(i.requestId),180,2e3);if(r?.stop(),s.status==="failed"&&(a(s.error||"Music generation failed"),process.exit(d.GENERAL_ERROR)),t.output){if(!s.audioUrl)throw new Error("Music completed without an audio URL");await te(s.audioUrl,t.output),n==="human"&&k(`Saved to: ${t.output}`),s.output=t.output}ai(s,n)}catch(i){r?.stop(),a(fe(i,o),n),process.exit(d.GENERAL_ERROR)}}),yw=new si("status").description("Check status of a music generation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{ai(await Zr(t),e.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Zc=new si("music").description("Video-aware music generation commands").addCommand(hw).addCommand(yw);import{Command as di}from"commander";function el(t,e){return[...e,t]}var bw=new di("create").description("Create a standalone poll").argument("<question>","Poll question").option("--option <text>","Choice (repeat 2-10 times)",el,[]).option("--type <type>","single, multiple, or word-cloud","single").option("--title <title>","Poll title").option("--team-id <id>","Workspace ID").option("--yes","Approve creation").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to approve poll creation");try{l(await m("createPoll",{approvalReceipt:"cli:--yes",options:e.option.map(n=>({text:n})),pollType:e.type,question:t,teamId:e.teamId,title:e.title}))}catch(n){a(n instanceof Error?n.message:"Poll creation failed"),process.exit(d.GENERAL_ERROR)}}),ww=new di("edit").description("Edit a standalone poll").argument("<poll-id>","Poll UUID").option("--question <question>","New question").option("--option <text>","Replacement choice (repeat)",el).option("--type <type>","single, multiple, or word-cloud").option("--title <title>","Poll title").option("--team-id <id>","Workspace ID").option("--yes","Approve update").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to approve poll update");try{l(await m("editPoll",{approvalReceipt:"cli:--yes",options:e.option?.map(n=>({text:n})),pollId:t,pollType:e.type,question:e.question,teamId:e.teamId,title:e.title}))}catch(n){a(n instanceof Error?n.message:"Poll update failed"),process.exit(d.GENERAL_ERROR)}}),tl=new di("poll").description("Standalone poll commands").addCommand(bw).addCommand(ww);import{randomUUID as Ir}from"crypto";import{readFile as jl}from"fs/promises";import V from"chalk";import{Command as G,InvalidArgumentError as Ii}from"commander";import{randomUUID as li}from"crypto";import{readFile as vw}from"fs/promises";import{Command as pr}from"commander";var nl=new pr("edit").description("Apply one atomic draft edit: narration, scene patch/move/remove, composition, or intro/outro card").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--edit <json-or-path>","Edit object as inline JSON or a JSON file path").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e){let n=R(this,e);await gr("Draft edit failed",async()=>m("editPresentationVideoDraft",{edit:await Iw(n.edit),projectId:t,teamId:n.teamId},n.idempotencyKey??li()))}),rl=new pr("versions").description("List saved presentation-video draft versions").argument("<project-id>","Presentation-video project UUID or editor slug").option("--before-version <number>","Continue below this version number",ci(1)).option("--limit <number>","Maximum versions",ci(1,100)).option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);await gr("Version list failed",()=>m("listPresentationVideoVersions",{beforeVersion:n.beforeVersion,limit:n.limit,projectId:t,teamId:n.teamId}))}),ol=new pr("restore").description("Restore a saved draft version as a new version").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<version-number>","Version number",ci(1)).option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e,n){let r=R(this,n);await gr("Version restore failed",()=>m("restorePresentationVideoVersion",{projectId:t,teamId:r.teamId,versionNumber:e},r.idempotencyKey??li()))}),il=new pr("refresh").description("Refresh deck-backed scenes from the latest presentation version").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e){let n=R(this,e);await gr("Slide refresh failed",()=>m("refreshPresentationVideoSlides",{projectId:t,teamId:n.teamId},n.idempotencyKey??li()))});async function Iw(t){let e=t.trim(),n=e.startsWith("{")?e:await vw(e,"utf8"),r=JSON.parse(n);if(!r||typeof r!="object"||Array.isArray(r))throw new Error("--edit must contain one JSON object.");return r}function ci(t,e=Number.MAX_SAFE_INTEGER){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<t||r>e)throw new Error(`Expected an integer between ${t} and ${e}.`);return r}}async function gr(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}import{createHash as xw}from"crypto";import{Command as kt,InvalidArgumentError as kw}from"commander";var al=new kt("drafts").description("List every video draft for one presentation with stage and staleness").argument("<presentation-id>","Source presentation ID, document ID, or slug").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);await Rt("Draft list failed",()=>m("listPresentationVideoProjects",{presentationId:t,teamId:n.teamId}))}),sl=new kt("freshness").description("Check whether a video draft is behind its source deck without changing it").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);await Rt("Freshness read failed",()=>m("getPresentationVideoFreshness",{projectId:t,teamId:n.teamId}))}),dl=new kt("version").description("Read one saved draft snapshot without restoring it").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<version-number>","Saved version number",ul(1)).option("--team-id <id>","Workspace ID override").action(async function(t,e,n){let r=R(this,n);await Rt("Version read failed",()=>m("getPresentationVideoVersion",{projectId:t,teamId:r.teamId,versionNumber:e}))}),cl=new kt("renders").description("List MP4 render attempts newest first, including failures").argument("<project-id>","Presentation-video project UUID or editor slug").option("--limit <number>","Maximum render attempts; omit to return the complete history",ul(1)).option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);await Rt("Render history failed",()=>m("listPresentationVideoRenders",{limit:n.limit,projectId:t,teamId:n.teamId}))}),ll=new kt("render").description("Read one render's exact snapshot, status, progress, and MP4 URL").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<render-id>","Render attempt UUID from `presentation video renders`").option("--team-id <id>","Workspace ID override").action(async function(t,e,n){let r=R(this,n);await Rt("Render read failed",()=>m("getPresentationVideoRender",{projectId:t,renderId:e,teamId:r.teamId}))}),ml=new kt("cancel").description("Request cancellation of one in-flight MP4 DurableRun").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<render-id>","In-flight render attempt UUID").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; deterministically derived from both IDs when omitted").action(async function(t,e,n){let r=R(this,n);await Rt("Render cancellation failed",()=>m("cancelPresentationVideoRender",{projectId:t,renderId:e,teamId:r.teamId},r.idempotencyKey??Rw(t,e)))});function ul(t,e=Number.MAX_SAFE_INTEGER){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<t||r>e)throw new kw(`Expected an integer between ${t} and ${e}.`);return r}}function Rw(t,e){return`presentation-video-cancel:${xw("sha256").update(`${t}\0${e}`).digest("hex")}`}async function Rt(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}import{randomUUID as Sw}from"crypto";import{Command as un}from"commander";import{existsSync as Cw}from"fs";var pl=["bottom-left","bottom-right","top-left","top-right","left-half","right-half","left-overlay","right-overlay","full"];function Ct(t){let[e,n]=t.split(":");if(e==="background")return{kind:"background"};if(e==="full")return{kind:"full"};if(e==="split"){if(n!=="left"&&n!=="right")throw new Error("--placement split needs a side: split:left or split:right.");return{kind:"split",side:n}}if(e==="box"){if(!n||!pl.includes(n))throw new Error(`--placement box needs an anchor: box:${pl.join(" | box:")}.`);return{kind:"box",placement:{anchor:n}}}throw new Error("--placement must be background, split:left, split:right, full, or box:<anchor>.")}function fr(t){if(t.wholeScene&&t.duration!==void 0)throw new Error("--whole-scene and --duration ask for opposite things; pass only one.");let e=t.duration!==void 0||t.start!==void 0||t.wholeScene===!0;if(t.startWord!==void 0){if(e)throw new Error("--start-word replaces --start, --duration and --whole-scene; pass words or seconds, not both.");if(t.clearAnchor)throw new Error("--start-word and --clear-anchor ask for opposites.");if(t.endWord!==void 0&&t.endWord<t.startWord)throw new Error("--end-word must not come before --start-word.");return{anchor:{...t.endWord!==void 0?{endWord:t.endWord}:{},startWord:t.startWord}}}if(t.endWord!==void 0)throw new Error("--end-word needs --start-word.");if(!(!e&&!t.clearAnchor))return{...t.clearAnchor?{anchor:null}:{},...t.wholeScene?{durationSec:null}:t.duration!==void 0?{durationSec:t.duration}:{},...t.start!==void 0?{startSec:t.start}:{}}}function nt(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<0)throw new Error(`${t} must be a 0-based narration word index (0, 1, 2, \u2026).`);return n}}function mn(t){let e=t.split(",").map(n=>n.trim()).filter(Boolean);if(e.length===0)throw new Error("Provide at least one scene id.");return e}function ke(t){return e=>{let n=Number(e);if(!Number.isFinite(n)||n<0)throw new Error(`${t} must be a number of seconds.`);return n}}async function hr(t,e={}){if(t.startsWith("https://"))return{url:t};if(t.startsWith("http://"))throw new Error("A layer image URL must use https.");if(Cw(t))return{uploadKey:(await de(t,{idempotencyKey:e.idempotencyKey,storagePrefix:"scene-layers"})).s3Key};if(yl(t))return{mediaAssetId:t};throw new Error("--image must be a local file path, an https image URL, or a media-library asset UUID.")}var yr=["brand","alert"],mi="::",gl=";;";function gi(t){if([t.textTitle,t.textCallout,t.textList].filter(r=>r!==void 0).length>1)throw new Error("Pass only one of --text-title, --text-callout or --text-list; each one is a whole card.");let n=pi(t.tone);if(t.textTitle!==void 0)return{heading:ui(t.textTitle,"--text-title"),tone:n,variant:"title"};if(t.textCallout!==void 0){let[r,o]=fl(t.textCallout,mi);return{...o?.trim()?{body:o.trim()}:{},heading:ui(r,"--text-callout"),tone:n,variant:"callout"}}if(t.textList!==void 0){let[r,o]=fl(t.textList,mi),i=(o??"").split(gl).map(s=>s.trim()).filter(Boolean);if(i.length===0)throw new Error(`--text-list needs a heading and its points: --text-list "Heading${mi}first${gl}second".`);return{heading:ui(r,"--text-list"),items:i,tone:n,variant:"list"}}if(t.tone!==void 0)throw new Error("--tone describes a text layer; pass it with --text-title, --text-callout or --text-list.")}function hl(t){let e=gi({...t,tone:void 0});return e?{body:e.body??null,heading:e.heading,items:e.items??null,...t.tone!==void 0?{tone:pi(t.tone)}:{},variant:e.variant}:t.tone===void 0?void 0:{tone:pi(t.tone)}}function pi(t){if(t===void 0)return"brand";if(t!=="alert"&&t!=="brand")throw new Error(`--tone must be ${yr.join(" or ")}.`);return t}function ui(t,e){let n=(t??"").trim();if(!n)throw new Error(`${e} needs the text to show.`);return n}function fl(t,e){let n=t.indexOf(e);return n<0?[t,void 0]:[t.slice(0,n),t.slice(n+e.length)]}function yl(t){return/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(t)}function fi(t){try{return fr(t)}catch(e){a(e instanceof Error?e.message:"Invalid layer timing."),process.exit(d.INVALID_INPUT)}}function bl(t){try{return t()}catch(e){a(e instanceof Error?e.message:"Invalid layer text."),process.exit(d.INVALID_INPUT)}}async function br(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}function wr(t,e,n){return m("editPresentationVideoDraft",{edit:n,projectId:t,teamId:e.teamId},e.idempotencyKey??Sw())}var Ew=new un("add").description("Add one timed layer to one or more scenes").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--scenes <ids>","Comma-separated composition scene ids").option("--video <id>","Reusable library video id").option("--media <id>","Media-library asset id (image or video)").option("--image <file-or-url>","Local image file to upload, or an https image URL").option("--slide <scene-id>","Reuse the image already on that deck scene").option("--text-title <line>","Words on a brand card: one loud line").option("--text-callout <heading::body>",'Words on a brand card: a heading over a paragraph, e.g. "Lockout first::Isolate the source."').option("--text-list <heading::a;;b;;c>","Words on a brand card: a heading over up to three points").option("--tone <tone>",`Text card colour: ${yr.join(" | ")}`).option("--placement <placement>","background | split:left | split:right | full | box:<anchor> (default background; required for a text layer, which cannot use background)").option("--start <seconds>","Seconds from the scene's first frame",ke("--start")).option("--duration <seconds>","Seconds shown; omit for the whole scene",ke("--duration")).option("--start-word <index>","Start on this narration word (0-based); replaces --start/--duration",nt("--start-word")).option("--end-word <index>","Last narration word shown (inclusive); omit for the whole scene",nt("--end-word")).option("--label <text>",'Studio label, e.g. "Right way"').option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e){let n=R(this,e),r=bl(()=>gi(n));[n.video,n.media,n.image,n.slide,r].filter(s=>s!==void 0).length!==1&&(a("Pass exactly one of --video, --media, --image, --slide, --text-title, --text-callout or --text-list."),process.exit(d.INVALID_INPUT)),r&&n.placement===void 0&&(a("A text layer needs --placement: split:left, split:right, full, or box:<anchor>. It cannot use background, where words paint under the scrim."),process.exit(d.INVALID_INPUT));let i=fi(n);await br("Layer add failed",async()=>{let s=r?{text:r}:n.video?{videoId:n.video}:n.media?{mediaAssetId:n.media}:n.slide?{slideId:n.slide}:await hr(n.image,{idempotencyKey:n.idempotencyKey});return wr(t,n,{...n.label?{label:n.label}:{},placement:Ct(n.placement??"background"),sceneIds:mn(n.scenes),source:s,...i?{timing:i}:{},type:"add_scene_layer"})})}),$w=new un("update").description("Move, retime, relabel or retype one layer. A picture or a clip is not editable \u2014 add a new layer instead \u2014 but a text layer's words are, because nothing was resolved to produce them").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id").argument("<layer-id>","Layer id from the project read").option("--placement <placement>","background | split:left | split:right | full | box:<anchor>").option("--start <seconds>","Seconds from the scene's first frame",ke("--start")).option("--duration <seconds>","Seconds shown",ke("--duration")).option("--start-word <index>","Start on this narration word (0-based); replaces the seconds flags",nt("--start-word")).option("--end-word <index>","Last narration word shown (inclusive)",nt("--end-word")).option("--clear-anchor","Drop the word anchor and put the layer back on seconds").option("--whole-scene","Clear the length so the layer shows until the scene ends").option("--text-title <line>","Retype a text layer as one loud line").option("--text-callout <heading::body>","Retype a text layer as a heading over a paragraph").option("--text-list <heading::a;;b;;c>","Retype a text layer as a heading over up to three points").option("--tone <tone>",`Text card colour: ${yr.join(" | ")}`).option("--label <text>","Studio label").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e,n,r){let o=R(this,r),i=fi(o),s=bl(()=>hl(o));o.placement===void 0&&i===void 0&&s===void 0&&o.label===void 0&&(a("Provide at least one of --placement, --start, --duration, --whole-scene, --start-word, --clear-anchor, --text-title, --text-callout, --text-list, --tone or --label."),process.exit(d.INVALID_INPUT)),await br("Layer update failed",()=>wr(t,o,{...o.label!==void 0?{label:o.label}:{},layerId:n,...o.placement!==void 0?{placement:Ct(o.placement)}:{},sceneId:e,...s?{text:s}:{},...i?{timing:i}:{},type:"update_scene_layer"}))}),Tw=new un("remove").description("Remove one layer from one scene").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id").argument("<layer-id>","Layer id from the project read").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e,n,r){let o=R(this,r);await br("Layer remove failed",()=>wr(t,o,{layerId:n,sceneId:e,type:"remove_scene_layer"}))}),Aw=new un("copy").description("Copy one layer onto other scenes, optionally with a different placement").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id the layer sits on").argument("<layer-id>","Layer id from the project read").requiredOption("--to <ids>","Comma-separated target scene ids").option("--placement <placement>","background | split:left | split:right | full | box:<anchor>").option("--start <seconds>","Retime the copies: seconds from each scene's first frame",ke("--start")).option("--duration <seconds>","Retime the copies: seconds shown",ke("--duration")).option("--start-word <index>","Retime the copies on each TARGET scene's narration words (0-based)",nt("--start-word")).option("--end-word <index>","Last narration word shown on each target (inclusive)",nt("--end-word")).option("--clear-anchor","Drop the source layer's word anchor on the copies").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e,n,r){let o=R(this,r),i=fi(o);await br("Layer copy failed",()=>wr(t,o,{layerId:n,...o.placement!==void 0?{placement:Ct(o.placement)}:{},sceneId:e,...i?{timing:i}:{},toSceneIds:mn(o.to),type:"copy_scene_layer"}))}),wl=new un("layer").description("Add, move, remove or copy the timed layers on a scene").addCommand(Ew).addCommand($w).addCommand(Tw).addCommand(Aw).addHelpText("after",`
|
|
50
|
+
${n.text}`}function vo(e,t){return t?e.messages.filter(r=>r.text.trim()).at(-1)?.text??"":wo(e.messages)}function dg({abortController:e,input:t,resumeSessionId:n,workspace:r}){let o=(t.modelId??"").trim(),i=t.thinking??null,c={abortController:e,allowedTools:["WebSearch","WebFetch"],cwd:r,env:{...process.env,PATH:Fn()},includePartialMessages:!0,maxTurns:16,permissionMode:"dontAsk"};return sg.has(o)||(c.model=o),t.effort&&(c.effort=t.effort),i&&i!=="disabled"&&(c.thinking={display:"summarized",type:i==="enabled"?"enabled":"adaptive"}),n?c.resume=n:t.system?.trim()&&(c.systemPrompt=t.system),c}async function dd(e){let t=vo(e.input,e.resumeSessionId);if(!t)throw new Error("Chat turn has no user text to send.");let n=new AbortController,r=()=>n.abort();e.signal?.addEventListener("abort",r,{once:!0});let o=null,i=null,c=null,d=null,u=null,g=0,w=new Set;try{let T=ig({prompt:t,options:dg({abortController:n,input:e.input,resumeSessionId:e.resumeSessionId,workspace:e.workspace})});for await(let A of T){let S=A;if(S.type==="system"&&S.subtype==="init"){typeof S.session_id=="string"&&(i=S.session_id,e.onEvent({eventType:"chat.session",payload:{sessionId:i,sessionPath:ad(e.workspace,i)}})),typeof S.model=="string"&&(o=S.model,e.onEvent({eventType:"chat.model",payload:{modelId:S.model}}));continue}if(S.type==="stream_event"){let $=S.event;if($?.type!=="content_block_delta")continue;let E=$.delta;if(!E)continue;E.type==="text_delta"&&typeof E.text=="string"?(g+=E.text.length,e.onEvent({eventType:"chat.text.delta",payload:{text:E.text}})):E.type==="thinking_delta"&&typeof E.thinking=="string"&&e.onEvent({eventType:"chat.reasoning.delta",payload:{text:E.thinking}});continue}if(S.type==="assistant"){let $=fe(S.message),E=Array.isArray($.content)?$.content:[];for(let M of E){let N=fe(M);if(N.type!=="tool_use")continue;let O=q(N.id),Y=q(N.name);!O||!Y||w.has(O)||(w.add(O),e.onEvent({eventType:"chat.tool.started",payload:{input:ge(N.input),toolCallId:O,toolName:Y}}))}continue}if(S.type==="user"){let $=fe(S.message),E=Array.isArray($.content)?$.content:[];for(let M of E){let N=fe(M);if(N.type!=="tool_result")continue;let O=q(N.tool_use_id);O&&e.onEvent({eventType:"chat.tool.completed",payload:{...N.is_error===!0?{errorText:typeof N.content=="string"?Bn(N.content):"Claude tool call failed."}:{},output:ge(N.content),toolCallId:O}})}continue}S.type==="result"&&(typeof S.result=="string"&&(d=S.result),S.usage&&typeof S.usage=="object"&&(c=S.usage),typeof S.session_id=="string"&&(i=S.session_id),(S.is_error===!0||S.subtype!=="success")&&(u=typeof S.result=="string"&&S.result||`Claude turn failed (${String(S.subtype)}).`,e.onEvent({eventType:"chat.error",message:u,payload:{message:u}})))}}finally{e.signal?.removeEventListener("abort",r)}if(e.signal?.aborted)throw new Error("Chat turn cancelled.");if(u)throw new Error(u);let v=d??"";g===0&&v&&e.onEvent({eventType:"chat.text.delta",payload:{text:v}});let x=i?ad(e.workspace,i):null;return{modelId:o,sessionId:i,sessionPath:x&&rg(x)?x:null,text:v,usage:c}}import{spawn as cg}from"child_process";import{closeSync as lg,fstatSync as mg,openSync as ug,readdirSync as pg,readSync as gg}from"fs";import{homedir as fg}from"os";import{join as cd}from"path";import{Codex as hg}from"@openai/codex-sdk";var yg=["/Applications/Codex.app/Contents/Resources/codex"];async function Kn(e){let t=e?[e]:["codex",...yg];for(let n of t){let r=await bg(n);if(r)return{bin:n,version:r}}return null}function bg(e){return new Promise(t=>{let n=cg(e,["--version"],{env:{...process.env,PATH:Fn()},stdio:["ignore","pipe","ignore"]}),r="";n.stdout.on("data",o=>{r+=o.toString("utf8")}),n.on("error",()=>t(null)),n.on("close",o=>{if(o!==0)return t(null);let i=r.trim().split(`
|
|
51
|
+
`)[0]??"";t(i||null)})})}var wg=24,vg=4*1024*1024,ud=new Set(["custom_tool_call","custom_tool_call_output","dynamic_tool_call","function_call"]);function Ig(e){let t;try{t=kg(e).split(`
|
|
52
|
+
`)}catch{return[]}let n=new Set,r=new Map,o=null;for(let i of t){if(!i.trim())continue;let c;try{c=JSON.parse(i)}catch{continue}let d=fe(c.payload);if(c.type==="response_item"&&d.type==="custom_tool_call"){let u=q(d.call_id),g=q(d.input);u&&d.name==="exec"&&/\btools\.web__run\s*\(/.test(g)&&(n.add(u),o=u);continue}if(c.type==="event_msg"&&d.type==="web_search_end"){let u=q(d.call_id);if(!u||!o)continue;let g=q(d.query),w=fe(d.action),x={action:{...w,...g&&!q(w.query)?{query:g}:{}},query:g,sources:ld(d.results),toolCallId:u},T=r.get(o)??[];T.push(x),r.set(o,T);continue}if(c.type==="response_item"&&d.type==="custom_tool_call_output"){let u=q(d.call_id);if(!u||!n.has(u))continue;let g=ld(d.output);for(let w of r.get(u)??[])w.sources.length===0&&(w.sources=g);o===u&&(o=null)}}return Array.from(r.values()).flat()}function kg(e){let t=ug(e,"r");try{let n=mg(t).size,r=Math.max(0,n-vg),o=Buffer.alloc(n-r);gg(t,o,0,o.length,r);let i=o.toString("utf8");if(r===0)return i;let c=i.indexOf(`
|
|
53
|
+
`);return c===-1?"":i.slice(c+1)}finally{lg(t)}}function ld(e){let n=xo(e).match(/https?:\/\/[^\s<>"'()[\]{}\\]+/g)??[],r=new Set,o=[];for(let i of n){let c=i.replace(/[.,;:!?]+$/,"");try{let d=new URL(c);if(d.protocol!=="http:"&&d.protocol!=="https:"||r.has(d.href))continue;if(r.add(d.href),o.push({type:"url",url:d.href}),o.length>=wg)break}catch{}}return o}function xo(e){return typeof e=="string"?e:Array.isArray(e)?e.map(xo).join(`
|
|
54
|
+
`):e&&typeof e=="object"?Object.values(e).map(xo).join(`
|
|
55
|
+
`):""}function Io(e,t){let n=fe(e),r=q(n.type),o=q(n.id),i=q(n.call_id)||q(n.tool_call_id),c=ud.has(r)?i||o:o||i;if(!c)return null;if(r==="command_execution"){let d=q(n.command),u=q(n.status),g={exitCode:typeof n.exit_code=="number"?n.exit_code:null,output:ge(n.aggregated_output)};return{...t&&u==="failed"?{errorText:Bn(n.aggregated_output)||"Command failed."}:{},input:{command:d},...t?{output:g}:{},toolCallId:c,toolName:"Bash"}}if(r==="mcp_tool_call"){let d=fe(n.error);return{...t&&q(d.message)?{errorText:q(d.message)}:{},input:ge(n.arguments),...t?{output:ge(n.result??{status:n.status??"completed"})}:{},toolCallId:c,toolName:q(n.tool)||q(n.name)||"Codex tool"}}if(r==="web_search"){let d=q(n.query);return{input:{query:d},...t?{output:{query:d}}:{},toolCallId:c,toolName:"web_search"}}if(r==="file_change"){let d=q(n.status);return{...t&&d==="failed"?{errorText:"Codex could not apply the file changes."}:{},input:{changes:ge(n.changes)},...t?{output:{changes:ge(n.changes),status:d}}:{},toolCallId:c,toolName:"ApplyPatch"}}if(r==="custom_tool_call_output")return{input:{},...t?{output:ge(n.output)}:{},toolCallId:c,toolName:"Codex tool"};if(r==="custom_tool_call"||r==="dynamic_tool_call"||r==="function_call"){let d=q(n.name)||q(n.tool)||"Codex tool",u=n.input??n.arguments??{};return{input:d==="exec"&&typeof u=="string"?{command:u}:ge(u),...t?{output:ge(n.output??n.result??{status:n.status??"completed"})}:{},toolCallId:c,toolName:d}}return null}function ko(e,t=cd(fg(),".codex","sessions")){try{let r=pg(t,{recursive:!0}).find(o=>typeof o=="string"&&o.endsWith(`${e}.jsonl`));return r?cd(t,r):null}catch{return null}}function xg(e,t){return t?vo(e,t):wo(e.messages)}function Rg(e,t,n=p.codexSelfConnectorAppId){let r=t.system?.trim(),o={...r?{developer_instructions:r}:{},...n?{apps:{[n]:{enabled:!1}}}:{}};return{codexPathOverride:e,...Object.keys(o).length>0?{config:o}:{}}}var Cg=new Set(["minimal","low","medium","high","xhigh"]);function Sg(e,t){let n={networkAccessEnabled:!0,sandboxMode:"workspace-write",skipGitRepoCheck:!0,webSearchEnabled:!0,workingDirectory:t},r=(e.modelId??"").trim();return r&&r!=="default"&&(n.model=r),e.effort&&Cg.has(e.effort)&&(n.modelReasoningEffort=e.effort),n}async function pd(e){let t=xg(e.input,e.resumeSessionId);if(!t)throw new Error("Chat turn has no user text to send.");let n=new hg(Rg(e.bin,e.input)),r=Sg(e.input,e.workspace),o=e.resumeSessionId?n.resumeThread(e.resumeSessionId,r):n.startThread(r),i=e.resumeSessionId??null,c=null,d=null,u=[],g=new Set,w=new Set,v=null,x=S=>{v??=ko(S,e.sessionsRoot),e.onEvent({eventType:"chat.session",payload:{sessionId:S,sessionPath:v}})},T=S=>{i&&(v??=ko(i,e.sessionsRoot));let $=v?Ig(v):[],E=q(fe(S.input).query),M=md(E),N=$.find(O=>!g.has(O.toolCallId)&&md(O.query)===M)??$.find(O=>!g.has(O.toolCallId));N&&g.add(N.toolCallId),e.onEvent({eventType:"chat.tool.completed",payload:{...S,output:N?{action:N.action,query:N.query,sources:N.sources}:{action:{query:E,type:"search"},sourceListUnavailable:!0,sources:[]}}})},{events:A}=await o.runStreamed(t);i&&x(i);for await(let S of A){if(e.signal?.aborted)throw await A.return?.(void 0),new Error("Chat turn cancelled.");let $=S;if($.type==="thread.started"){typeof $.thread_id=="string"&&(i=$.thread_id,x($.thread_id));continue}if($.type==="item.started"){let E=Io($.item,!1);if(E){e.onEvent({eventType:"chat.tool.started",payload:E});let M=fe($.item);if(ud.has(q(M.type))&&q(M.status)==="completed"){let N=Io(M,!0);N&&(w.add(N.toolCallId),e.onEvent({eventType:"chat.tool.completed",payload:N}))}}continue}if($.type==="item.completed"){let E=$.item;if(!E)continue;if(E.type==="agent_message"&&typeof E.text=="string")u.push(E.text),e.onEvent({eventType:"chat.text.delta",payload:{text:E.text}});else if(E.type==="reasoning"&&typeof E.text=="string")e.onEvent({eventType:"chat.reasoning.delta",payload:{text:E.text}});else{let M=Io(E,!0);M&&(E.type==="web_search"?T(M):E.type==="custom_tool_call"&&w.has(M.toolCallId)||e.onEvent({eventType:"chat.tool.completed",payload:M}))}continue}if($.type==="turn.completed"){$.usage&&typeof $.usage=="object"&&(c=$.usage);continue}if($.type==="turn.failed"){let E=$.error;d=typeof E?.message=="string"&&E.message||"Codex turn failed.",e.onEvent({eventType:"chat.error",message:d,payload:{message:d}})}}if(d)throw new Error(d);return i=o.id??i,i&&(v??=ko(i,e.sessionsRoot)),{modelId:e.input.modelId??null,sessionId:i,sessionPath:v,text:u.join(`
|
|
56
|
+
|
|
57
|
+
`),usage:c}}function md(e){return e.trim().replace(/\s+/g," ").toLocaleLowerCase()}import{randomUUID as Pg}from"crypto";import{mkdir as Og}from"fs/promises";import{hostname as Jn,platform as Dg}from"os";import{join as Ng}from"path";var vt=class extends Error{constructor(n,r,o=!1){super(n);this.statusCode=r;this.reRegister=o;this.name="RunnerApiError"}statusCode;reRegister};async function It(e,t={}){let n=await Ie();t.body!==void 0&&(n["Content-Type"]="application/json");let r=new AbortController,o=setTimeout(()=>r.abort(),t.timeoutMs??3e4),i=()=>r.abort();t.signal?.addEventListener("abort",i,{once:!0});try{let c=await fetch(`${B()}${e}`,{body:t.body!==void 0?JSON.stringify(t.body):void 0,headers:n,method:t.method??"GET",signal:r.signal}),d=await c.text(),u={};try{u=d?JSON.parse(d):{}}catch{u={error:d.slice(0,300)}}if(!c.ok)throw new vt(typeof u.error=="string"?u.error:`Runner API returned ${c.status}`,c.status,u.reRegister===!0);return u}finally{clearTimeout(o),t.signal?.removeEventListener("abort",i)}}async function gd(e){await It("/api/runner/register",{body:e,method:"POST",timeoutMs:15e3})}async function fd(e,t){return(await It(`/api/runner/work?runnerId=${encodeURIComponent(e)}`,{signal:t,timeoutMs:28e3})).job??null}async function hd(e){await It("/api/runner/heartbeat",{body:{runnerId:e},method:"POST",timeoutMs:1e4})}async function yd(e,t){return{cancelRequested:(await It(`/api/runner/jobs/${encodeURIComponent(e)}/events`,{body:{events:t},method:"POST",timeoutMs:15e3})).cancelRequested===!0}}async function Ro(e,t,n){await It(`/api/runner/jobs/${encodeURIComponent(e)}/complete`,{body:{result:n,runnerId:t},method:"POST",timeoutMs:15e3})}async function Wn(e,t,n,r=!0){await It(`/api/runner/jobs/${encodeURIComponent(e)}/fail`,{body:{message:n,retryable:r,runnerId:t},method:"POST",timeoutMs:15e3})}import{mkdirSync as Eg,readFileSync as Tg,writeFileSync as bd}from"fs";import{dirname as $g,join as Ag}from"path";function Co(e){return Ag(e,"sessions.json")}function So(e){try{let t=Tg(Co(e),"utf8"),n=JSON.parse(t);if(n&&typeof n=="object"&&!Array.isArray(n))return n}catch{}return{}}function wd(e,t,n){return t?So(e)[t]?.[n]??null:null}function vd(e,t,n,r){if(!(!t||!r))try{let o=Co(e);Eg($g(o),{recursive:!0});let i=So(e);i[t]={...i[t],[n]:r},bd(o,`${JSON.stringify(i,null," ")}
|
|
58
|
+
`,"utf8")}catch{}}function Id(e,t,n){if(t)try{let r=So(e);if(!r[t])return;delete r[t][n],bd(Co(e),`${JSON.stringify(r,null," ")}
|
|
59
|
+
`,"utf8")}catch{}}var Lg=300,Ug=3e4;async function kd(e){let[t,n]=await Promise.all([Gn(e.claudeBin),Kn(e.codexBin)]);if(!t&&!n)throw new Error("Neither Claude Code nor Codex was found on this machine. Install one and log in, then retry.");t?e.log(`Claude Code detected: ${t.version} (${t.bin})`):e.log("Claude Code not found \u2014 Claude turns will be declined."),n?e.log(`Codex detected: ${n.version} (${n.bin})`):e.log("Codex not found \u2014 Codex turns will be declined.");let r=[...t?["claude-code"]:[],...n?["codex"]:[]],o=`${Jn().split(".")[0]}-${Pg().slice(0,8)}`,i=()=>gd({capabilities:["chat_turn","proof"],claudeCodeVersion:t?.version??null,cliVersion:e.version,codexVersion:n?.version??null,hostname:Jn(),platform:Dg(),runnerId:o,runtimes:r});for(await i(),e.log(`Registered as ${o} (runtimes: ${r.join(", ")}). Waiting for work\u2026`);!e.signal?.aborted;){let c=null;try{c=await fd(o,e.signal)}catch(d){if(e.signal?.aborted)break;if(d instanceof vt&&d.reRegister){e.log("Server asked for re-registration."),await i().catch(()=>{});continue}e.log(`Work poll failed (${d instanceof Error?d.message:"unknown"}); retrying\u2026`),await jg(e.pollBackoffMs??5e3,e.signal);continue}if(!c){if(e.once)continue;continue}if(e.log(`Claimed ${c.jobType} job ${c.runId}.`),await _g({claude:t,codex:n,job:c,options:e,runnerId:o}),e.once)break}}async function _g({claude:e,codex:t,job:n,options:r,runnerId:o}){let i=new AbortController,c=()=>i.abort();r.signal?.addEventListener("abort",c,{once:!0});let d=setInterval(()=>{hd(o).catch(()=>{})},Ug),u=[],g=!1,w=async()=>{if(g||u.length===0)return;g=!0;let T=u.splice(0,100);try{let{cancelRequested:A}=await yd(n.runId,T);A&&i.abort()}catch(A){A instanceof vt&&A.statusCode===409&&i.abort()}finally{g=!1}},v=setInterval(()=>{w()},Lg),x=T=>{u.push(T)};try{if(n.jobType==="runner.proof"){let T=typeof n.input.message=="string"?n.input.message:"proof";x({eventType:"proof.echo",payload:{message:T}}),await Eo(w,u),await Ro(n.runId,o,{echo:T}),r.log(`Proof job ${n.runId} completed.`);return}if(n.jobType==="runner.chat_turn"){let T=n.input.runtime==="codex"?"codex":"claude-code",A=T==="codex"?t&&{detection:t,run:pd}:e&&{detection:e,run:dd};if(!A){await Wn(n.runId,o,T==="codex"?"Codex is not available on this machine. Install the Codex app or CLI and log in, then retry.":"Claude Code is not available on this machine. Install it and log in, then retry.",!1);return}let S=typeof n.input.chatId=="string"&&n.input.chatId?n.input.chatId:null,$=Ng(r.workspaceRoot,"chats",S??n.runId);await Og($,{recursive:!0});let E=qg(n.input),M=Y=>x({eventType:Y.eventType,message:Y.message??null,payload:Y.eventType==="chat.session"?{host:Jn(),runtime:T,runtimeVersion:A.detection.version,...Y.payload??{}}:Y.payload??{}}),N=wd(r.workspaceRoot,S,T),O;try{O=await A.run({bin:A.detection.bin,input:E,onEvent:M,resumeSessionId:N,signal:i.signal,workspace:$})}catch(Y){if(!N||i.signal.aborted)throw Y;r.log(`Resume of ${T} session failed (${Y instanceof Error?Y.message:"unknown"}); retrying fresh.`),Id(r.workspaceRoot,S,T),O=await A.run({bin:A.detection.bin,input:E,onEvent:M,resumeSessionId:null,signal:i.signal,workspace:$})}vd(r.workspaceRoot,S,T,O.sessionId),x({eventType:"chat.session",payload:{host:Jn(),runtime:T,runtimeVersion:A.detection.version,sessionId:O.sessionId,sessionPath:O.sessionPath}}),await Eo(w,u),await Ro(n.runId,o,{modelId:O.modelId,runtime:T,runtimeVersion:A.detection.version,sessionId:O.sessionId,sessionPath:O.sessionPath,text:O.text,usage:O.usage??{}}),r.log(`Chat turn ${n.runId} (${T}) completed.`);return}await Wn(n.runId,o,`This runner does not support ${n.jobType} jobs. Update the desktop app / CLI.`,!1)}catch(T){let A=T instanceof Error?T.message:"Local runner job crashed.";r.log(`Job ${n.runId} failed: ${A}`),await Eo(w,u).catch(()=>{}),await Wn(n.runId,o,A).catch(()=>{})}finally{clearInterval(v),clearInterval(d),r.signal?.removeEventListener("abort",c)}}function qg(e){let t=Array.isArray(e.messages)?e.messages.map(n=>{if(!n||typeof n!="object")return null;let r=n;return{role:typeof r.role=="string"?r.role:"user",text:typeof r.text=="string"?r.text:""}}).filter(n=>!!n):[];return{effort:typeof e.effort=="string"?e.effort:null,messages:t,modelId:typeof e.modelId=="string"?e.modelId:null,system:typeof e.system=="string"?e.system:null,thinking:typeof e.thinking=="string"?e.thinking:null}}async function Eo(e,t){for(;t.length>0;)await e(),t.length>0&&await new Promise(n=>setTimeout(n,25))}function jg(e,t){return e<=0||t?.aborted?Promise.resolve():new Promise(n=>{let r=setTimeout(o,e);function o(){clearTimeout(r),t?.removeEventListener("abort",o),n()}t?.addEventListener("abort",o,{once:!0})})}function Fg(){return Mg(Vg(),`.${p.commands[0]}-runner`,"runs")}var zn=new Bg("runner").description("Run agent work locally with your own Claude Code / Codex login (desktop lane)");zn.command("status").description("Check local Claude Code / Codex detection and account auth").action(async()=>{let[e,t]=await Promise.all([Gn(),Kn()]);if(console.log(e?ke.green(`\u2713 Claude Code ${e.version}`):ke.red("\u2717 Claude Code not found on PATH")),console.log(t?ke.green(`\u2713 Codex ${t.version} (${t.bin})`):ke.red("\u2717 Codex not found (PATH or Codex.app)")),!Oe()){console.log(ke.red(`\u2717 Not logged in. Run '${p.commands[0]} login' first.`)),process.exitCode=2;return}try{let n=await Ee();console.log(ke.green(`\u2713 Logged in as ${n.user.email}`))}catch(n){console.log(ke.red(`\u2717 Auth check failed: ${n instanceof Error?n.message:"unknown"}`)),process.exitCode=2}});zn.command("start").description("Start the local runner (register + wait for work)").option("--once","Execute a single job, then exit").option("--workspace <dir>","Workspace root for job scratch directories").option("--claude-bin <path>","Path to the claude binary").option("--codex-bin <path>","Path to the codex binary").action(async e=>{Oe()||(console.error(ke.red(`Not authenticated. Run '${p.commands[0]} login' first.`)),process.exit(2));let t=new AbortController,n=()=>{console.log(ke.gray(`
|
|
60
|
+
Stopping runner\u2026`)),t.abort()};process.on("SIGINT",n),process.on("SIGTERM",n);try{await kd({claudeBin:e.claudeBin,codexBin:e.codexBin,log:r=>console.log(ke.gray(`[runner] ${r}`)),once:e.once,signal:t.signal,version:"0.3.25",workspaceRoot:e.workspace??Fg()})}catch(r){console.error(ke.red(r instanceof Error?r.message:String(r))),process.exit(1)}});import ee from"chalk";import{Command as gR}from"commander";import{Command as To}from"commander";function Gg(e,t){return[...t,e]}var Kg=new To("create").description("Start durable ad-set generation").argument("<title>","Ad-set title").requiredOption("--brief <brief>","Campaign brief").option("--hook <text>","Opening hook (repeat)",Gg,[]).option("--style <style>","ugc, clean, cinematic, or testimonial","ugc").option("--branding-id <id>","Branding ID").option("--team-id <id>","Workspace ID").option("--yes","Approve generation").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to approve generation");try{l(await m("createAdSet",{approvalReceipt:"cli:--yes",brandingId:t.brandingId,brief:t.brief,hooks:t.hook.length?t.hook:[t.brief],style:t.style,teamId:t.teamId,title:e}))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(s.GENERAL_ERROR)}}),Wg=new To("status").description("Read ad-set generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await I("createAdSet",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),xd=new To("ad-set").description("Generate a set of ad creatives (hooks, copy, visuals) from a campaign brief").addCommand(Kg).addCommand(Wg);import{randomUUID as Ed}from"crypto";import{readFileSync as Td}from"fs";import{readFile as Qg}from"fs/promises";import{Command as xe}from"commander";import{readFileSync as Jg}from"fs";function he(e,t=()=>Jg(0,"utf8")){if(e.approvalReceipt&&e.approvalReceiptStdin)throw new Error("Pass only one approval receipt input mode.");let n=e.approvalReceiptStdin?t().trim():e.approvalReceipt;if(e.approvalReceiptStdin&&!n)throw new Error("No approval receipt was provided on stdin.");return n}import{randomUUID as zg}from"crypto";function De(e,t){a(e instanceof Error?e.message:t),process.exit(e instanceof D?e.exitCode:s.GENERAL_ERROR)}function rn(e){return`cli:agent-management:${e}:${zg()}`}function kt(e,t){let n=Number(e);if(!Number.isInteger(n)||n<=0)throw new Error(`${t} must be a positive integer`);return n}import{Command as on}from"commander";var Hg=new on("list").description("List one roster page: your Agents plus teammates' team-visible Agents").option("--cursor <cursor>","Continue from a previous nextCursor").option("--page-size <n>","Roster rows to return (1-100)","50").option("--team-id <id>","Workspace ID").action(async e=>{try{l(await m("listAgentRoster",{cursor:e.cursor,pageSize:kt(e.pageSize,"--page-size"),teamId:e.teamId}))}catch(t){De(t,"Could not list the Agent roster")}}),Xg=new on("get").description("Read one roster-visible Agent card without private configuration").argument("<agent-id>","Roster-visible Agent UUID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("getRosterAgent",{agentId:e,teamId:t.teamId}))}catch(n){De(n,"Could not read the roster Agent")}}),Rd=new on("roster").description("Discover Agents shared inside the current workspace; never cross-workspace").addCommand(Hg).addCommand(Xg),Yg=new on("set").description("Share an owned Agent with the workspace or make it private").argument("<agent-id>","Owned scheduled Agent UUID").argument("<visibility>","Desired visibility: private or team",y("visibility",["private","team"])).requiredOption("--expected-visibility <visibility>","Current value from agent roster get: private, team, or legacy public",y("--expected-visibility",["private","team","public"])).option("--idempotency-key <key>","Reuse only for an exact retry of this visibility change").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{try{l(await m("setAgentVisibility",{agentId:e,expectedVisibility:n.expectedVisibility,teamId:n.teamId,visibility:t},n.idempotencyKey?.trim()||rn("visibility")))}catch(r){De(r,"Could not change Agent visibility")}}),Cd=new on("visibility").description("Control whether an owned Agent is private or team-visible").addCommand(Yg);function xt(e,t){return[...t,e]}function Zg(e){let t=Number(e);if(!Number.isInteger(t)||t<1)throw new Error("Expected a positive integer.");return t}async function Hn(e,t){let n=t.trim(),r=n.startsWith("{")?n:await Qg(n,"utf8"),o=JSON.parse(r);if(!o||typeof o!="object"||Array.isArray(o))throw new Error(`${e} must contain one JSON object.`);return o}var ef=new xe("create").description("Activate a reviewed Agent draft; get browser approval, then retry with the same key and receipt.").argument("<draft-id>","Reviewed agent draft UUID").requiredOption("--expected-version <number>","Exact draft version shown during review",Zg).requiredOption("--idempotency-key <key>","Stable key bound into the approval receipt and reused on retry").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL").option("--yes","Confirm activation intent; this never substitutes for the approval receipt").option("--team-id <id>","Workspace ID").action(async(e,t)=>{t.yes||(a("Pass --yes to request activation. A server-issued approval receipt is still required."),process.exit(s.INVALID_INPUT)),await $d("Agent activation failed",()=>m("createAgent",{approvalReceipt:t.approvalReceipt,draftId:e,expectedVersion:t.expectedVersion,teamId:t.teamId},t.idempotencyKey))}),tf=new xe("recommend").description("Save a private inactive scheduled-agent draft for review; this command never activates or runs it.").argument("<name>","Agent name").requiredOption("--instructions <markdown>","Standing agent instructions").option("--description <text>","Agent description","").option("--goal <text>","User-visible recurring objective").option("--rationale <text>","Why this draft is being recommended").option("--schedule <frequency>","manual, daily, weekdays, weekly, or monthly").option("--schedule-r-rule <rrule>","Precise recurrence rule").option("--schedule-time <hh:mm>","Local run time").option("--timezone <zone>","IANA timezone").option("--schedule-config <json-or-path>","Full schedule configuration as inline JSON or a JSON file").option("--source <connector>","Source connector (repeatable)",xt,[]).option("--x-handle-target <handle>","Target for the x_handle source").option("--x-search-target <query>","Query for the x_search source").option("--primary-output <adapter>","Legacy primary output fallback").option("--output <adapter>","Output adapter (repeatable)",xt,[]).option("--output-config <json-or-path>","Full output slot configuration (repeatable)",xt,[]).option("--delivery-adapter <adapter>","Delivery adapter").option("--delivery-config <json-or-path>","Full delivery configuration as inline JSON or a JSON file").option("--review-policy <policy>","manual_review, auto_send, or draft_only","manual_review").option("--runtime <json-or-path>","Scheduled runtime configuration as inline JSON or a JSON file").option("--sandbox-blueprint-id <id>","Sandbox blueprint UUID").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await $d("Agent recommendation failed",async()=>m("recommendAgent",{deliveryAdapter:t.deliveryAdapter,deliveryConfig:t.deliveryConfig?await Hn("--delivery-config",t.deliveryConfig):void 0,description:t.description,goal:t.goal,instructionsMarkdown:t.instructions,name:e,outputAdapter:t.primaryOutput,outputAdapters:t.output.length?t.output:void 0,outputConfigs:t.outputConfig.length?await Promise.all(t.outputConfig.map(n=>Hn("--output-config",n))):void 0,rationale:t.rationale,reviewPolicy:t.reviewPolicy,runtime:t.runtime?await Hn("--runtime",t.runtime):void 0,sandboxBlueprintId:t.sandboxBlueprintId,schedule:t.schedule,scheduleConfig:t.scheduleConfig?await Hn("--schedule-config",t.scheduleConfig):void 0,scheduleRRule:t.scheduleRRule,scheduleTime:t.scheduleTime,sourceConnectors:t.source.length?t.source:void 0,teamId:t.teamId,timezone:t.timezone,xHandleTarget:t.xHandleTarget,xSearchTarget:t.xSearchTarget},t.idempotencyKey??Ed()))});async function $d(e,t){try{l(await t())}catch(n){if(n instanceof D){let r=`[${n.errorCode}] `;console.error(JSON.stringify({error:{code:n.errorCode,message:n.message.startsWith(r)?n.message.slice(r.length):n.message,retryable:n.retryable},ok:!1})),process.exit(n.exitCode)}console.error(JSON.stringify({error:{code:"operation_failed",message:n instanceof Error?n.message:e,retryable:!1},ok:!1})),process.exit(s.GENERAL_ERROR)}}function nf(e,t){return e==="none"?null:kt(e,t)}function rf(e){return e==="none"?null:e}function rt(e,t){let n;try{n=Td(e,"utf8")}catch(r){throw new Error(`${t} could not read ${e}: ${r instanceof Error?r.message:"unknown file error"}`)}try{return JSON.parse(n)}catch(r){throw new Error(`${t} must point to valid JSON: ${r instanceof Error?r.message:"invalid JSON"}`)}}function of(e,t){try{return Td(e,"utf8")}catch(n){throw new Error(`${t} could not read ${e}: ${n instanceof Error?n.message:"unknown file error"}`)}}var af=new xe("list").description("List all owned Agents, following cursor pages to closure").option("--cursor <cursor>","Resume from a previous nextCursor").option("--page-size <n>","Rows fetched per page","50").option("--team-id <id>","Workspace ID").action(async e=>{try{let t=[],n=e.cursor;for(;;){let r=await m("listAgents",{cursor:n,pageSize:kt(e.pageSize,"--page-size"),teamId:e.teamId});if(t.push(...r.agents),!r.hasMore||!r.nextCursor)break;n=r.nextCursor}l({agents:t,total:t.length})}catch(t){De(t,"Could not list Agents")}}),sf=new xe("get").description("Read one owned Agent and its complete configuration").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("getAgent",{agentId:e,teamId:t.teamId}))}catch(n){De(n,"Could not read the Agent")}}),df=new xe("configure").description("Update Agent configuration; enable automatic external delivery in the browser").argument("<agent-id>","Scheduled Agent UUID").requiredOption("--expected-version <n>","Version returned by agent get").option("--name <text>","Agent name").option("--description <text>","Agent description").option("--goal <text>","Recurring objective").option("--instructions-file <path>","UTF-8 Markdown instructions").option("--schedule-file <path>","Typed schedule JSON document").option("--sources-file <path>","Typed source array JSON document").option("--output-file <path>","Typed primary output JSON document").option("--outputs-file <path>","Typed output array JSON document").option("--delivery-file <path>","Typed delivery JSON document").option("--review-policy <policy>","manual_review, auto_send, or draft_only").option("--runtime-file <path>","Typed runtime JSON document").option("--sandbox-blueprint-id <id|none>","Subscription sandbox blueprint, or none").option("--per-run-credit-cap <credits|none>","Positive credit ceiling, or none").option("--files-file <path>","Typed attached-file array JSON document").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("updateAgentConfiguration",{additionalFiles:t.filesFile?rt(t.filesFile,"--files-file"):void 0,agentId:e,delivery:t.deliveryFile?rt(t.deliveryFile,"--delivery-file"):void 0,description:t.description,expectedVersion:kt(t.expectedVersion,"--expected-version"),goal:t.goal,instructionsMarkdown:t.instructionsFile?of(t.instructionsFile,"--instructions-file"):void 0,name:t.name,output:t.outputFile?rt(t.outputFile,"--output-file"):void 0,outputs:t.outputsFile?rt(t.outputsFile,"--outputs-file"):void 0,perRunCreditCap:t.perRunCreditCap===void 0?void 0:nf(t.perRunCreditCap,"--per-run-credit-cap"),reviewPolicy:t.reviewPolicy,runtime:t.runtimeFile?rt(t.runtimeFile,"--runtime-file"):void 0,sandboxBlueprintId:t.sandboxBlueprintId===void 0?void 0:rf(t.sandboxBlueprintId),schedule:t.scheduleFile?rt(t.scheduleFile,"--schedule-file"):void 0,sources:t.sourcesFile?rt(t.sourcesFile,"--sources-file"):void 0,teamId:t.teamId},t.idempotencyKey??rn("configure")))}catch(n){De(n,"Could not update the Agent")}});function Sd(e){return new xe(e).description(`${e==="pause"?"Pause":"Resume"} an Agent schedule`).argument("<agent-id>","Scheduled Agent UUID").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--team-id <id>","Workspace ID").action(async(t,n)=>{try{l(await m(e==="pause"?"pauseAgentSchedule":"resumeAgentSchedule",{agentId:t,teamId:n.teamId},n.idempotencyKey??rn(e)))}catch(r){De(r,`Could not ${e} the Agent schedule`)}})}function $o(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}function cf(e){return`cli:agent-memory:${e}:${Ed()}`}function lf(e,t){let n=e.indexOf("="),r=n===-1?e:e.slice(0,n),o=n===-1?"":e.slice(n+1);return[...t,{name:r.trim(),note:o.trim()}]}var mf=new xe("show").description("Show what a scheduled agent remembers").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("getAgentMemory",{agentId:e,teamId:t.teamId}))}catch(n){$o(n,"Could not read the agent's memory")}}),uf=new xe("set").description("Add to or remove from what an agent remembers. Owner or workspace admin only.").argument("<agent-id>","Scheduled Agent UUID").option("--learned <text>","Durable fact to add (repeatable)",xt,[]).option("--always <text>","Standing instruction to add (repeatable)",xt,[]).option("--never <text>","Thing it must not do, to add (repeatable)",xt,[]).option("--track <name=note>","Entity to track, as name=note (repeatable)",lf,[]).option("--notes <text>","Replace the freeform notes").option("--operation <operation>","Mutation operation: add or remove","add").option("--remove-field <field>","Field to remove from: learned, recurringInstructions, negativePreferences, entities, or notes").option("--remove-value <text>","Item to remove; not needed when removing notes").option("--remove <field>","Deprecated alias for --remove-field").option("--value <text>","Deprecated alias for --remove-value").option("--expected-version <n>","Refuse the write unless the stored memory is still at this version").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--team-id <id>","Workspace ID").action(async(e,t)=>{let n=t.removeField??t.remove,r=t.removeValue??t.value,o=t.operation==="remove"||!!n;try{l(await m("updateAgentMemory",{agentId:e,entities:t.track.length?t.track:void 0,expectedVersion:t.expectedVersion===void 0?void 0:Number.parseInt(t.expectedVersion,10),learned:t.learned.length?t.learned:void 0,negativePreferences:t.never.length?t.never:void 0,notes:t.notes,operation:o?"remove":"add",recurringInstructions:t.always.length?t.always:void 0,removeField:n,removeValue:r,teamId:t.teamId},t.idempotencyKey??cf(o?"remove":"add")))}catch(i){$o(i,"Could not update the agent's memory")}}),pf=new xe("forget").description("Erase every stored version of an agent's memory. This cannot be undone.").argument("<agent-id>","Scheduled Agent UUID").option("--team-id <id>","Workspace ID").requiredOption("--idempotency-key <key>","Stable key bound into the approval receipt and reused on retry").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").option("--yes","Confirm erasure intent; this never substitutes for an approval receipt").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to request erasure. A browser-issued approval receipt is still required.");try{let n=he(t);l(await m("forgetAgentMemory",{approvalReceipt:n,agentId:e,teamId:t.teamId},t.idempotencyKey))}catch(n){$o(n,"Could not erase the agent's memory")}}),gf=new xe("memory").description("Read, edit, and erase what a scheduled agent remembers").addCommand(mf).addCommand(uf).addCommand(pf),Ad=new xe("agent").description("Recommend, activate, configure, and manage scheduled Agents").addCommand(af).addCommand(sf).addCommand(Rd).addCommand(Cd).addCommand(df).addCommand(Sd("pause")).addCommand(Sd("resume")).addCommand(ef).addCommand(tf).addCommand(gf);import{Command as Pd}from"commander";var Ao=["article","document","microsite","presentation","presentationVideo","video"];function ff(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}function hf(e){if(e===void 0)return;let t=/^\s*(\d+)\s*(?:-\s*(\d+)\s*)?$/.exec(e);t||(a(`--slides expects N or N-M, got "${e}"`),process.exit(s.GENERAL_ERROR));let n=Number(t[1]),r=t[2]===void 0?n:Number(t[2]);return(n<1||r<n)&&(a(`--slides range must start at 1 and end no earlier than it starts, got "${e}"`),process.exit(s.GENERAL_ERROR)),{from:n,to:r}}var yf=new Pd("read").description("Read an owned artifact's full content").argument("<kind>",`Artifact kind: ${Ao.join(", ")}`).argument("<artifact-id>","Artifact id, or slug where the kind has one").option("--slides <range>","Presentations only: N or N-M. Omit to read every slide.").option("--team-id <id>","Workspace to read from").action(async(e,t,n)=>{Ao.includes(e)||(a(`Unknown artifact kind "${e}". Expected one of: ${Ao.join(", ")}`),process.exit(s.GENERAL_ERROR));try{let r=await m("readArtifact",{artifactId:t,kind:e,slides:hf(n.slides),teamId:n.teamId});l(r)}catch(r){ff(r,"Could not read the artifact")}}),Od=new Pd("artifact").description("Read artifacts this workspace owns").addCommand(yf);import{randomUUID as bf}from"crypto";import{password as wf}from"@inquirer/prompts";import{Command as Xn}from"commander";function Po(e){if(e==="claude-code"||e==="codex")return e;throw new Error("--runtime must be claude-code or codex")}function vf(e,t){let n=e;if(t==="claude-code"&&(n==="zai-claude"||n==="anthropic-compatible")||t==="codex"&&n==="openai-responses-compatible")return n;throw new Error(t==="claude-code"?"--provider must be zai-claude or anthropic-compatible for Claude":"--provider must be openai-responses-compatible for Codex")}async function If(){let e="";for await(let t of process.stdin)if(e+=String(t),e.length>65536)throw new Error("Credential input is too large");return e.trim()}var kf=new Xn("add").description("Enroll a provider credential without exposing it in arguments").requiredOption("--runtime <runtime>","claude-code or codex").requiredOption("--provider <provider>","zai-claude, anthropic-compatible, or openai-responses-compatible").requiredOption("--label <name>","Profile name shown in Mindframes").requiredOption("--model <model-id>","Provider model id").option("--base-url <url>","Public HTTPS provider base URL").option("--api-key-stdin","Read the provider key from stdin instead of a hidden prompt").option("--use","Select the new profile immediately").action(async e=>{try{let t=Po(e.runtime),n=vf(e.provider,t);if(!e.apiKeyStdin&&!process.stdin.isTTY)throw new Error("Non-interactive enrollment requires --api-key-stdin. Never pass provider keys as command arguments.");let r=e.apiKeyStdin?await If():(await wf({mask:"*",message:"Provider API key:"})).trim();if(!r)throw new Error("Provider API key is required");let o=await qa({apiKey:r,...e.baseUrl?{baseUrl:e.baseUrl}:{},label:e.label,makeDefault:e.use??!1,modelId:e.model,provider:n,runtime:t});k(`Saved connection profile ${o.label} (${o.id})`)}catch(t){a(t instanceof Error?t.message:"Profile enrollment failed"),process.exit(s.GENERAL_ERROR)}}),xf=new Xn("list").description("List secret-free Claude Code or Codex connection profiles").requiredOption("--runtime <runtime>","claude-code or codex").action(async e=>{try{let t=Po(e.runtime);l(await m("listAiConnectionProfiles",{runtime:t}))}catch(t){a(t instanceof Error?t.message:"Profile list failed"),process.exit(s.GENERAL_ERROR)}}),Rf=new Xn("select").description("Select a profile UUID, or 'native' for the first-party route").requiredOption("--runtime <runtime>","claude-code or codex").requiredOption("--profile-id <id>","Profile UUID or native").option("--idempotency-key <key>","Reuse only for an exact retry of this profile selection").option("--yes","Confirm changing the active inference route").action(async e=>{e.yes||(a("Pass --yes to confirm changing the active connection profile."),process.exit(s.INVALID_INPUT));try{let t=Po(e.runtime),n=await m("selectAiConnectionProfile",{profileId:e.profileId,runtime:t},e.idempotencyKey?.trim()||bf());k(n.selectedProfileId?`Selected connection profile ${n.selectedProfileId}`:"Selected the native provider route")}catch(t){a(t instanceof Error?t.message:"Profile selection failed"),process.exit(s.GENERAL_ERROR)}}),Dd=new Xn("ai-connections").description("Manage Claude Code and Codex inference routes").addCommand(kf).addCommand(xf).addCommand(Rf);import{randomUUID as Qn}from"crypto";import{readFileSync as Of}from"fs";import{readFile as Df}from"fs/promises";import ot from"chalk";import{Command as ce}from"commander";import Nf from"ora";import{mkdir as Cf,writeFile as Nd}from"fs/promises";import{dirname as Sf}from"path";async function oe(e,t){if(await Cf(Sf(t),{recursive:!0}),e.startsWith("data:")){let o=e.match(/^data:[^;]+;base64,(.+)$/);if(!o)throw new Error("Invalid data URL format");let i=Buffer.from(o[1],"base64");if(i.length===0)throw new Error("Downloaded media was empty");await Nd(t,i);return}let n=await fetch(e);if(!n.ok)throw new Error(`Failed to download media: ${n.status}`);let r=Buffer.from(await n.arrayBuffer());if(r.length===0)throw new Error("Downloaded media was empty");await Nd(t,r)}import{existsSync as Ld}from"fs";import{resolve as Ef}from"path";var Tf=/^([A-Za-z][A-Za-z0-9_-]*)=(.+)$/;function $f(e){let t=e.trim();if(!t)throw new Error("A reference image value cannot be empty.");if(Ld(t))return{source:t};let n=Tf.exec(t);return n?{label:n[1],source:n[2]}:{source:t}}function Af(e,t,n){if(!e.startsWith("image/")&&e!=="application/octet-stream")throw new Error(`Reference image ${t} (${n}) is ${e}, not an image. A reference must be an image; pass an image file or a public image URL.`)}function Pf(e,t){let n;try{n=new URL(e)}catch(r){throw new Error(`Reference image ${t} (${e}) must be an existing local file or an HTTP(S) URL.`,{cause:r})}if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error(`Reference image ${t} (${e}) must use an HTTP(S) URL.`);return n}async function Yn(e,t){if(e?.length){if(t.maxCount!==void 0&&e.length>t.maxCount)throw new Error(`${t.maxCountSubject??"This command"} accepts at most ${t.maxCount} reference images; ${e.length} were provided.`);return Promise.all(e.map(async(n,r)=>{let o=r+1,{label:i,source:c}=$f(n);if(Ld(c)){let u=Ef(c),g=yt(u);t.rejectNonImageFiles&&Af(g,o,c);let w=await Q(u,{idempotencyKey:`${t.idempotencyKey}:reference:${o}`}),v=w.type||g;return{...i?{label:i}:{},...v.startsWith("image/")?{mediaType:v}:{},url:w.url}}let d=Pf(c,o);return{...i?{label:i}:{},url:d.toString()}}))}}var Lf=15e3,Uf=40,_f=3;function qf(e,t){return[...t,e]}async function jf(e){let t=e.trim(),n=t.startsWith("[")?t:await Df(t,"utf8"),r=JSON.parse(n);if(!Array.isArray(r)||r.some(o=>!o||typeof o!="object"||Array.isArray(o)))throw new Error("--starter-looks-json must contain one JSON array of objects.");return r}async function Ud(e,t){return(await Yn(e,{idempotencyKey:t,maxCount:_f,maxCountSubject:"A presenter Look"}))?.map(r=>({url:r.url}))}function Oo(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.videoUrl??e.requestId);return}b(`Request ID: ${e.requestId}`),b(`Status: ${e.status}`),e.durationSec!=null&&b(`Duration: ${e.durationSec}s`),e.videoUrl&&k(`Video URL: ${e.videoUrl}`),e.error&&a(`Error: ${e.error}`)}var Vf=new ce("options").description("List available presenter avatars and voices").option("--language <language>","Filter voices by language").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{try{let t=await ss(e.language,e.teamId);if(e.format==="json"){l(t);return}let n=t.personal??[];if(e.format==="quiet"){for(let r of n)console.log(r.id);for(let r of t.avatars)console.log(r.id);for(let r of t.voices)console.log(r.id);return}if(n.length>0){b("Your presenters:");for(let r of n)console.log(` ${r.id} ${r.name}`)}b("Avatars:");for(let r of t.avatars){let o=r.renderTiers?.length?` [${r.renderTiers.join(", ")}]`:"";console.log(` ${r.id} ${r.name}${o}`)}b("Voices:");for(let r of t.voices)console.log(` ${r.id} ${r.name}${r.language?` (${r.language})`:""}`)}catch(t){a(t instanceof Error?t.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Mf=new ce("options").description("List personal-presenter engines, prices, supported sources, and exact consent wording").option("--locale <locale>","Consent locale: en, es, hi, ru, or zh","en").option("--team-id <id>","Workspace ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{try{let t=await m("listPresenterCreationOptions",{locale:e.locale,teamId:e.teamId});if(e.format==="json")return l(t);if(e.format==="quiet"){for(let n of t.options)console.log(n.id);return}b(t.canCreate?"Presenter creation is enabled.":"Presenter creation is not enabled for this account.");for(let n of t.options)console.log(`
|
|
61
|
+
${ot.bold(n.label)} ${ot.gray(n.id)}`),console.log(` ${n.description}`),console.log(` Sources: ${n.supportedKinds.join(", ")}`),console.log(` Credits: ${Object.entries(n.creationCredits).map(([r,o])=>`${r}=${o}`).join(", ")}`),console.log(` Consent: ${n.consentCopyText}`)}catch(t){a(t instanceof Error?t.message:"Options failed"),process.exit(s.GENERAL_ERROR)}}),Bf=new ce("create").description("Create a personal presenter after browser-confirmed likeness consent").requiredOption("--name <name>","Presenter name").requiredOption("--engine <id>","Engine id from 'avatar presenter options'").requiredOption("--kind <kind>","Source kind: footage, photo, or prompt").requiredOption("--consent-statement <text>","Exact consent text from 'avatar presenter options'").option("--locale <locale>","Consent locale","en").option("--source <path>","Local footage or headshot file").option("--prompt <text>","Synthetic-persona description").option("--reference-image <path...>","Up to three local prompt reference images",qf,[]).option("--starter-looks-json <json-or-path>","Optional starter-look array as inline JSON or a JSON file").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable key bound into the approval receipt and upload retries").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL").option("--approval-receipt-stdin","Read the browser-issued receipt from stdin").option("--yes","Confirm creation intent; this never substitutes for likeness consent").option("--no-wait","Return after the presenter creation run is accepted").action(async e=>{e.yes||(a("Pass --yes to confirm presenter creation intent. Browser-issued likeness approval is still required."),process.exit(s.INVALID_INPUT)),["footage","photo","prompt"].includes(e.kind)||(a("--kind must be footage, photo, or prompt."),process.exit(s.INVALID_INPUT)),e.approvalReceipt&&e.approvalReceiptStdin&&(a("Pass only one approval receipt input mode."),process.exit(s.INVALID_INPUT));let t=e.approvalReceiptStdin?Of(0,"utf8").trim():e.approvalReceipt;e.approvalReceiptStdin&&!t&&(a("No approval receipt was provided on stdin."),process.exit(s.INVALID_INPUT));let n=e.idempotencyKey??Qn();try{if(e.kind==="prompt"&&!e.prompt?.trim())throw new Error("--prompt is required for prompt presenters.");if(e.kind!=="prompt"&&!e.source)throw new Error("--source is required for footage and photo presenters.");if(e.referenceImage.length>3)throw new Error("At most three --reference-image values are allowed.");let r=e.source?await Q(e.source,{idempotencyKey:`${n}:source`,storagePrefix:"presenters"}):void 0,o=await Promise.all(e.referenceImage.map((d,u)=>Q(d,{idempotencyKey:`${n}:reference:${u}`,storagePrefix:"presenters"}))),i=e.starterLooksJson?await jf(e.starterLooksJson):[],c=await m("createPresenter",{approvalReceipt:t,consentCopyLocale:e.locale,consentCopyText:e.consentStatement,engineId:e.engine,kind:e.kind,name:e.name,...e.prompt?{prompt:e.prompt}:{},...o.length?{referenceImageS3Keys:o.map(d=>d.s3Key)}:{},...r?{s3Key:r.s3Key}:{},starterLooks:i,teamId:e.teamId},n);if(!e.wait){l(c),b(`Check progress with: ${p.commands[0]} avatar presenter status ${c.runId}`);return}l(await de("createPresenter",c.runId,e.teamId,null))}catch(r){let o=r instanceof Error?r.message:String(r);a(o),o.includes("approval")&&b(`Retry with the receipt and the same key: --approval-receipt <receipt> --idempotency-key ${n}`),process.exit(s.GENERAL_ERROR)}}),Ff=new ce("status").description("Read personal-presenter creation status").argument("<run-id>","Durable run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await I("createPresenter",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Gf=new ce("presenter").description("Discover and create reusable personal presenters").addCommand(Mf).addCommand(Bf).addCommand(Ff),Kf=new ce("generate").description("Generate a reusable presenter clip").option("--avatar-id <id>","Avatar id from 'avatar options'; sandbox runs use the host presenter policy").option("--audio-url <url>","Public narration audio URL for avatar lip sync").option("--voice-id <id>","Voice id from 'avatar options'").option("--script <text>","Exact words for the presenter to speak").requiredOption("-o, --output <path>","Local output path").option("--aspect <aspect>","Aspect: 1:1, 9:16, 16:9","9:16").option("--duration <seconds>","Maximum requested duration (1-300)").option("--transparent","Render a transparent-background WebM presenter clip").option("--background-color <hex>","Solid presenter background color, for example #0F172A").option("--background-image-url <url>","Public image URL used as the presenter background").option("--branding-id <id>","Workspace brand applied to the presenter clip").option("--cast-preset-id <id>","Saved cast preset supplying presenter, backdrop, and voice").option("--captions","Burn provider-generated captions into the clip").option("--fit <mode>","Background image fit: contain or cover").option("--output-format <container>","Container: mp4 (default) or webm \u2014 webm renders a transparent-background clip (single scene) for compositing").option("--render-tier <tier>","Render cost/quality: basic, standard, premium; defaults to the presenter's lowest supported tier").option("--title <title>","Clip title","Presenter clip").option("--strict-branding","Fail when the selected brand cannot be applied completely").option("--idempotency-key <key>","Stable retry key for this presenter clip").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.transparent?"webm":e.outputFormat;!!e.audioUrl==!!e.script&&(a("Provide exactly one avatar speech input: --audio-url or --script"),process.exit(s.INVALID_INPUT)),["1:1","9:16","16:9"].includes(e.aspect)||(a("Aspect must be one of 1:1, 9:16, or 16:9"),process.exit(s.INVALID_INPUT)),e.outputFormat!==void 0&&!["mp4","webm"].includes(e.outputFormat)&&(a("Output format must be mp4 or webm"),process.exit(s.INVALID_INPUT)),e.backgroundColor!==void 0&&!/^#[0-9a-fA-F]{6}$/.test(e.backgroundColor)&&(a("Background color must be a six-digit hex value"),process.exit(s.INVALID_INPUT)),e.backgroundColor&&e.backgroundImageUrl&&(a("Provide only one presenter background"),process.exit(s.INVALID_INPUT)),e.fit!==void 0&&!["contain","cover"].includes(e.fit)&&(a("Fit must be contain or cover"),process.exit(s.INVALID_INPUT)),e.fit&&!e.backgroundImageUrl&&(a("Fit requires --background-image-url"),process.exit(s.INVALID_INPUT)),e.transparent&&e.outputFormat==="mp4"&&(a("--transparent cannot be combined with --output-format mp4"),process.exit(s.INVALID_INPUT)),t==="webm"&&(e.backgroundColor||e.backgroundImageUrl)&&(a("Transparent WebM output cannot be combined with a background"),process.exit(s.INVALID_INPUT)),e.renderTier!==void 0&&!["basic","standard","premium"].includes(e.renderTier)&&(a("Render tier must be basic, standard, or premium"),process.exit(s.INVALID_INPUT));let n=e.duration?Number.parseInt(e.duration,10):void 0;n!==void 0&&(!Number.isFinite(n)||n<1||n>300)&&(a("Duration must be between 1 and 300 seconds"),process.exit(s.INVALID_INPUT));let r=e.format==="human"?Nf("Generating presenter clip...").start():null;try{let o=e.idempotencyKey??Qn(),i=e.audioUrl?{audioUrl:e.audioUrl}:{script:e.script??"",...e.voiceId?{voiceId:e.voiceId}:{}},c=await ds({...i,aspect:e.aspect,...e.avatarId?{avatarId:e.avatarId}:{},...e.backgroundColor?{backgroundHex:e.backgroundColor}:{},...e.backgroundImageUrl?{backgroundImageUrl:e.backgroundImageUrl}:{},...e.brandingId?{brandingId:e.brandingId}:{},...e.castPresetId?{castPresetId:e.castPresetId}:{},...e.captions?{captions:!0}:{},...n!==void 0?{durationSec:n}:{},...e.fit?{fit:e.fit}:{},...t?{outputFormat:t}:{},...e.renderTier?{renderTier:e.renderTier}:{},...e.strictBranding?{strictBranding:!0}:{},title:e.title},o);if(!e.wait){r?.stop(),Oo(c,e.format);return}let d=await pe(()=>go(c.requestId),Uf,Lf);if(d.status==="failed")throw new Error(d.error||"Presenter generation failed");if(!d.videoUrl)throw new Error("Presenter generation completed without a video URL");r&&(r.text="Downloading presenter clip..."),await oe(d.videoUrl,e.output),r?.stop(),Oo(d,e.format),e.format==="human"&&k(`Saved to: ${e.output}`)}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Wf=new ce("status").description("Check a presenter clip generation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{Oo(await go(e),t.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Jf=new ce("generate").description("Generate another look for an existing personal presenter").argument("<base-profile-id>","Base personal presenter id (pp_*)").requiredOption("--name <name>","Look name").requiredOption("--description <description>","Short look description").requiredOption("--prompt <prompt>","Exact appearance generation prompt").requiredOption("--look-id <id>","Stable template/look id").option("--reference-image <path-or-url...>","Up to three local images or URLs for location, outfit, or style guidance").option("--idempotency-key <key>","Stable retry key for this look request").action(async(e,t)=>{try{let n=t.idempotencyKey??Qn(),r=await Ud(t.referenceImage,n),o=await m("generatePresenterLook",{baseProfileId:e,description:t.description,id:t.lookId,prompt:t.prompt,...r?{referenceImages:r}:{},title:t.name},n);l(o)}catch(n){a(n instanceof Error?n.message:"Look generation failed"),process.exit(s.GENERAL_ERROR)}}),zf=new ce("status").description("Read presenter look generation status").argument("<run-id>","Durable run ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await I("generatePresenterLook",e);if(t.format==="json")return l(n);if(t.format==="quiet")return console.log(n.status);b(`Run ID: ${e}`),b(`Status: ${n.status}`),n.error?.message&&a(n.error.message)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Hf=new ce("revise").description("Create a new Look by editing an existing presenter Look").argument("<look-id>","Ready presenter Look id (pp_*)").requiredOption("--instruction <instruction>","What to add, remove, or change").option("--reference-image <path-or-url...>","Up to three local images or URLs for location, outfit, or style guidance").option("--idempotency-key <key>","Stable retry key for this revision").action(async(e,t)=>{try{let n=t.idempotencyKey??Qn(),r=await Ud(t.referenceImage,n),o=await m("revisePresenterLook",{instruction:t.instruction,...r?{referenceImages:r}:{},sourceLookId:e},n);l(o)}catch(n){a(n instanceof Error?n.message:"Look revision failed"),process.exit(s.GENERAL_ERROR)}}),Xf=new ce("revision-status").description("Read presenter Look revision status").argument("<run-id>","Durable run ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await I("revisePresenterLook",e);if(t.format==="json")return l(n);if(t.format==="quiet")return console.log(n.status);b(`Run ID: ${e}`),b(`Status: ${n.status}`),n.error?.message&&a(n.error.message)}catch(n){a(n instanceof Error?n.message:"Revision status failed"),process.exit(s.GENERAL_ERROR)}}),Yf=new ce("look").description("Manage looks under an existing personal presenter").addCommand(Jf).addCommand(Hf).addCommand(Xf).addCommand(zf),Do=new ce("avatar").description("Generate presenter clips and looks; avatar options lists the voices and looks used by presentation video presenter and cast preset").addCommand(Vf).addCommand(Gf).addCommand(Kf).addCommand(Yf).addCommand(Wf);Do.addHelpText("after",`
|
|
62
|
+
${ot.bold("Examples:")}
|
|
63
|
+
${ot.gray("# Discover the presenter avatars and voices you can use")}
|
|
64
|
+
$ ${p.commands[0]} avatar options
|
|
65
|
+
|
|
66
|
+
${ot.bold("See also:")}
|
|
67
|
+
${ot.gray("# Save a presenter + backdrop + voice combination under a name")}
|
|
68
|
+
$ ${p.commands[0]} cast preset --help
|
|
69
|
+
|
|
70
|
+
${ot.gray("# Apply an avatar, look, or preset to one presentation-video scene")}
|
|
71
|
+
$ ${p.commands[0]} presentation video presenter <project-id>
|
|
72
|
+
`);import{randomUUID as Vb}from"crypto";import{readFileSync as Mb}from"fs";import{writeFile as Bb}from"fs/promises";import F from"chalk";import{Command as Pt,InvalidArgumentError as Wc}from"commander";import Fb from"ora";import{createHash as gh}from"crypto";import{Command as cn,InvalidArgumentError as dn}from"commander";import{createHash as rh}from"crypto";import{existsSync as oh,readFileSync as ih}from"fs";import{basename as ah}from"path";import{Command as sh,InvalidArgumentError as an}from"commander";import dh from"ora";import{createHash as Qf}from"crypto";import{Command as Zf,InvalidArgumentError as _d}from"commander";var eh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function th(e){if(!eh.test(e))throw new _d("brand-id expects a UUID from `mf branding list`.");return e}function nh(e){let t=Number(e);if(!Number.isInteger(t)||t<1)throw new _d("--file-size expects the exact positive whole-number byte size.");return t}async function Lo(e){let{idempotencyKey:t,...n}=e;return m("createBrandAssetUploadUrl",n,t)}function No(e){if(e===void 0)return"";if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(No).join(",")}]`;let t=e;return`{${Object.keys(t).filter(n=>t[n]!==void 0).sort().map(n=>`${JSON.stringify(n)}:${No(t[n])}`).join(",")}}`}function Uo(e){return Qf("sha256").update(`createBrandAssetUploadUrl:${No(e)}`).digest("hex").slice(0,32)}var qd=new Zf("upload-url").description("Mint a short-lived brand-scoped storage POST; this does not upload bytes").argument("<brand-id>","Brand UUID you may manage",th).requiredOption("--file-name <name>","Original filename used in storage content disposition").requiredOption("--file-type <mime>","Exact MIME type that the storage POST will send").requiredOption("--file-size <bytes>","Exact byte size, 1-104857600",nh).option("--idempotency-key <key>","Stable retry key; defaults to a hash of brand and complete file metadata").option("--team-id <id>","Workspace ID; defaults to the selected workspace").addHelpText("after","\nNext: POST every returned field plus the file to uploadUrl, then run `mf branding asset register` with fileUrl, MIME type, and size.\n").action(async(e,t)=>{await h();try{l(await Lo({brandId:e,...t,idempotencyKey:t.idempotencyKey??Uo({brandId:e,fileName:t.fileName,fileSize:t.fileSize,fileType:t.fileType})}))}catch(n){a(n instanceof Error?n.message:"Brand asset upload URL creation failed"),process.exit(s.GENERAL_ERROR)}});var ch=["footage","image","before_after","logo","audio"],lh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function mh(e){if(!lh.test(e))throw new an("brand-id expects a UUID from `mf branding list`.");return e}function jd(e){return t=>{let n=Number(t);if(!Number.isInteger(n)||n<0)throw new an(`${e} expects a whole number of 0 or more.`);return n}}function uh(e){let t=Number(e);if(!Number.isFinite(t)||t<0)throw new an("--duration-sec expects a number of 0 or more.");return t}function ph(e){let t;try{t=JSON.parse(e)}catch{throw new an("--metadata expects valid JSON.")}if(!t||typeof t!="object"||Array.isArray(t))throw new an("--metadata expects a JSON object.");return t}var Vd=new sh("upload").description("Upload one local file, register it on a brand, and print the asset JSON").argument("<brand-id>","Brand UUID",mh).requiredOption("--file <path>","Local file to upload through Mindframes storage").requiredOption("--kind <kind>","Asset kind: footage | image | before_after | logo | audio",y("--kind",ch)).option("--label <text>","Display label; defaults to the local filename").option("--width <px>","Image or video width in pixels",jd("--width")).option("--height <px>","Image or video height in pixels",jd("--height")).option("--duration-sec <n>","Audio or video duration in seconds",uh).option("--set-key <key>","Pair key; required when --kind before_after").option("--role <role>","Pair role: before | after; required when --kind before_after",y("--role",["before","after"])).option("--metadata <json>",'Optional metadata JSON: {"pairLabel":"Summer","source":"upload"}',ph).option("--idempotency-key <key>","Retry key; defaults to a hash of file bytes and complete registration input").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h(),oh(t.file)||(a(`File not found: ${t.file}`),process.exit(s.INVALID_INPUT)),t.kind==="before_after"&&(!t.role||!t.setKey)&&(a("--kind before_after requires both --role and --set-key."),process.exit(s.INVALID_INPUT)),t.kind!=="before_after"&&(t.role||t.setKey)&&(a("--role and --set-key are only valid with --kind before_after."),process.exit(s.INVALID_INPUT));let n=rh("sha256").update(ih(t.file)).digest("hex"),r=Ze(t.file),o={brandId:e,contentHash:n,durationSec:t.durationSec,fileName:r.fileName,fileSize:r.fileSize,fileType:r.fileType,height:t.height,kind:t.kind,label:t.label===void 0?r.fileName:t.label.trim(),metadata:t.metadata,role:t.role,setKey:t.setKey,width:t.width},i=t.idempotencyKey??Uo(o),c=dh({text:`Uploading ${ah(t.file)}...`,stream:process.stderr}).start();try{let d=await Lo({brandId:e,...r,idempotencyKey:i,teamId:t.teamId}),u=await et(t.file,d);c.succeed("Uploaded"),l(await m("registerBrandAsset",{brandId:e,durationSec:t.durationSec,height:t.height,kind:t.kind,label:o.label,metadata:t.metadata,mimeType:u.type,role:t.role,s3Key:u.s3Key,setKey:t.setKey,sizeBytes:u.size,teamId:t.teamId,url:u.url,width:t.width},i))}catch(d){c.fail("Asset upload failed"),a(d instanceof Error?d.message:"Asset upload failed"),process.exit(s.GENERAL_ERROR)}});var Md=["footage","image","before_after","logo","audio"],fh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Rt(e){return t=>{if(!fh.test(t))throw new dn(`${e} expects a UUID from \`mf branding list\` or \`mf branding asset list\`.`);return t}}function sn(e,t){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<t)throw new dn(`${e} expects a whole number from ${t} upward.`);return r}}function hh(e){return t=>{let n=Number(t);if(!Number.isFinite(n)||n<0)throw new dn(`${e} expects a number of 0 or more.`);return n}}function yh(e){let t;try{t=JSON.parse(e)}catch(n){throw new dn(`--metadata expects JSON: ${n instanceof Error?n.message:String(n)}`)}if(!t||typeof t!="object"||Array.isArray(t))throw new dn("--metadata expects a JSON object.");return t}function _o(e){return gh("sha256").update(e).digest("hex").slice(0,32)}function Zn(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var bh=new cn("list").description("List one brand's uploaded assets and print stable asset IDs").argument("<brand-id>","Brand UUID",Rt("brand-id")).option("--kind <kind>","Filter: footage | image | before_after | logo | audio",y("--kind",Md)).option("--limit <count>","Caller-selected page size; omit to return every matching asset",sn("--limit",1)).option("--offset <count>","Matching assets to skip before returning results (default: 0)",sn("--offset",0)).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandAssets",{brandId:e,...t.kind?{kind:t.kind}:{},...t.limit?{limit:t.limit}:{},...t.offset!==void 0?{offset:t.offset}:{},teamId:t.teamId}))}catch(n){Zn(n,"Asset list failed")}}),wh=new cn("register").description("Register one app-owned upload from its exact URL, key, MIME, and metadata").argument("<brand-id>","Brand UUID",Rt("brand-id")).requiredOption("--url <url>","Final app-owned file URL returned by the upload step").requiredOption("--kind <kind>","Asset kind: footage | image | before_after | logo | audio",y("--kind",Md)).option("--label <text>","Optional display label, up to 160 characters").requiredOption("--mime-type <type>","Exact MIME type returned by the upload step; verified against storage").option("--s3-key <key>","Optional storage key; when set it must match the URL and upload owner").option("--size-bytes <n>","Expected byte size; when set it must match storage",sn("--size-bytes",0)).option("--width <px>","Image or video width in pixels",sn("--width",0)).option("--height <px>","Image or video height in pixels",sn("--height",0)).option("--duration-sec <n>","Audio or video duration in seconds",hh("--duration-sec")).option("--set-key <key>","Pair key; required when --kind before_after").option("--role <role>","Pair role: before | after; required when --kind before_after",y("--role",["before","after"])).option("--metadata <json>",'Optional metadata JSON: {"pairLabel":"Summer","source":"upload"}',yh).option("--idempotency-key <key>","Retry key; defaults to a hash of the complete registration input").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h(),t.kind==="before_after"&&(!t.role||!t.setKey)&&(a("--kind before_after requires both --role and --set-key."),process.exit(s.INVALID_INPUT)),t.kind!=="before_after"&&(t.role||t.setKey)&&(a("--role and --set-key are only valid with --kind before_after."),process.exit(s.INVALID_INPUT));let n={brandId:e,durationSec:t.durationSec,height:t.height,kind:t.kind,label:t.label,metadata:t.metadata,mimeType:t.mimeType,role:t.role,s3Key:t.s3Key,setKey:t.setKey,sizeBytes:t.sizeBytes,teamId:t.teamId,url:t.url,width:t.width},r=t.idempotencyKey??_o(`registerBrandAsset:${JSON.stringify(n)}`);try{l(await m("registerBrandAsset",n,r))}catch(o){Zn(o,"Asset registration failed")}}),vh=new cn("rename").description("Rename one asset, then print its stored label and metadata").argument("<asset-id>","Asset UUID from `mf branding asset list`",Rt("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",Rt("--brand")).requiredOption("--label <text>","New non-empty label, up to 160 characters").option("--idempotency-key <key>","Retry key; defaults to a hash of asset ID and label").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();let n=t.label.trim();n||(a("--label cannot be empty."),process.exit(s.INVALID_INPUT));try{l(await m("renameBrandAsset",{assetId:e,brandId:t.brand,label:n,teamId:t.teamId},t.idempotencyKey??_o(`renameBrandAsset:${e}:${n}`)))}catch(r){Zn(r,"Asset rename failed")}}),Ih=new cn("delete").description("Remove one asset record from the brand while keeping its uploaded file").argument("<asset-id>","Asset UUID from `mf branding asset list`",Rt("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",Rt("--brand")).option("--yes","Confirm removal from the brand library without an interactive prompt").option("--idempotency-key <key>","Retry key; defaults to a stable hash of the asset ID").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h(),t.yes||(a("Refusing removal from the brand library without --yes."),process.exit(s.INVALID_INPUT));try{l(await m("deleteBrandAsset",{assetId:e,brandId:t.brand,teamId:t.teamId},t.idempotencyKey??_o(`deleteBrandAsset:${e}`)))}catch(n){Zn(n,"Asset deletion failed")}}),Bd=new cn("asset").description("List, upload, rename, and remove a brand's private asset library").addCommand(bh).addCommand(wh).addCommand(qd).addCommand(Vd).addCommand(vh).addCommand(Ih);import{Command as Fd,InvalidArgumentError as kh}from"commander";var xh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Rh=["presentation","reel","story","video","walkthrough","slide","microsite","article"];function Ch(e){if(!xh.test(e))throw new kh("Expected a brand UUID from `mf branding list`.");return e}var Sh=new Fd("resolve").description("Resolve design tokens, node trace, rules, and conflicts").argument("<brand-id>","Brand UUID",Ch).requiredOption("--artifact <type>","Artifact type",y("--artifact",[...Rh])).option("--channel <name>","Channel condition").option("--audience <name>","Audience condition").option("--product <name>","Product condition").option("--locale <name>","Locale condition").option("--market <name>","Market condition").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();let n={artifactType:t.artifact,brandId:e,teamId:t.teamId};for(let r of["audience","channel","locale","market","product"])t[r]!==void 0&&(n[r]=t[r]);try{l(await m("resolveBrandDesign",n))}catch(r){a(r instanceof Error?r.message:"Brand design resolve failed"),process.exit(s.GENERAL_ERROR)}}),Gd=new Fd("design").description("Inspect resolved brand design state").addCommand(Sh);import{createHash as Eh,randomUUID as Th}from"crypto";import{Command as Ne,InvalidArgumentError as Kd}from"commander";var $h=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ln(e){if(!$h.test(e))throw new Kd("Expected a brand UUID from `mf branding list`.");return e}function Ah(e){if(e==="true")return!0;if(e==="false")return!1;throw new Kd("--show expects true or false.")}function er(e,t){return Eh("sha256").update(JSON.stringify([e,t])).digest("hex").slice(0,32)}function Ct(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var Ph=new Ne("set").description("Create or update one custom colour role and print the committed snapshot").argument("<brand-id>","Brand UUID",ln).argument("<role>","Custom role without the color. prefix").argument("<hex>","Three- or six-digit hex colour, for example #114b97").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from the complete change when omitted").action(async(e,t,n,r)=>{await h();let o={brandId:e,hex:n,role:t,teamId:r.teamId};try{l(await m("setBrandCustomColor",o,r.idempotencyKey??er("setBrandCustomColor",o)))}catch(i){Ct(i,"Custom colour update failed")}}),Oh=new Ne("delete").description("Remove one custom colour role and print the committed snapshot").argument("<brand-id>","Brand UUID",ln).argument("<role>","Custom role without the color. prefix").option("--yes","Confirm removal without an interactive prompt").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from brand and role when omitted").action(async(e,t,n)=>{await h(),n.yes||(a("Refusing to remove a custom colour without --yes."),process.exit(s.INVALID_INPUT));let r={brandId:e,role:t,teamId:n.teamId};try{l(await m("deleteBrandCustomColor",r,n.idempotencyKey??er("deleteBrandCustomColor",r)))}catch(o){Ct(o,"Custom colour removal failed")}}),Dh=new Ne("sync").description("Synchronize current brand data into the canonical brand graph").argument("<brand-id>","Brand UUID",ln).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; a new one is minted when omitted").action(async(e,t)=>{await h();let n={brandId:e,teamId:t.teamId};try{let r=await m("syncBrandFoundation",n,t.idempotencyKey??er("syncBrandFoundation",[n,Th()]));l(t.wait===!1?r:await Rs(r.runId,t.teamId))}catch(r){Ct(r,"Brand foundation sync failed")}}),Nh=new Ne("sync-status").description("Read a brand foundation sync run").argument("<run-id>","Run ID from `branding foundation sync --no-wait`").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await I("syncBrandFoundation",e,t.teamId))}catch(n){Ct(n,"Brand foundation sync status failed")}}),Wd=new Ne("foundation").description("Manage atomic Foundation settings backed by the brand DAG").addCommand(new Ne("color").description("Manage custom colour roles").addCommand(Ph).addCommand(Oh)).addCommand(Dh).addCommand(Nh),Lh=new Ne("get").description("Read the complete current footer and its source").argument("<brand-id>","Brand UUID",ln).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("getBrandFooter",{brandId:e,teamId:t.teamId}))}catch(n){Ct(n,"Footer read failed")}}),Uh=new Ne("set").description("Patch footer text, visibility, or alignment atomically").argument("<brand-id>","Brand UUID",ln).option("--text <text>","Complete footer text; pass an empty string to clear it").option("--show <boolean>","Whether artifacts show the footer: true | false",Ah).option("--alignment <value>","Footer alignment: left | center | right",y("--alignment",["left","center","right"])).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--idempotency-key <key>","Stable retry key; derived from the complete patch when omitted").action(async(e,t)=>{await h(),t.alignment===void 0&&t.show===void 0&&t.text===void 0&&(a("Pass at least one of --text, --show, or --alignment."),process.exit(s.INVALID_INPUT));let n={alignment:t.alignment,brandId:e,show:t.show,teamId:t.teamId,text:t.text};try{l(await m("setBrandFooter",n,t.idempotencyKey??er("setBrandFooter",n)))}catch(r){Ct(r,"Footer update failed")}}),Jd=new Ne("footer").description("Read or update the brand footer").addCommand(Lh).addCommand(Uh);import{createHash as _h}from"crypto";import{Command as zd}from"commander";var qh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function jh(e){qh.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function Vh(e){return _h("sha256").update(e).digest("hex").slice(0,32)}function Hd(e,t){try{return JSON.parse(t)}catch(n){a(`${e} is not valid JSON: ${n instanceof Error?n.message:String(n)}`),process.exit(s.INVALID_INPUT)}}function Mh(e,t){let n=Hd(e,t);return Array.isArray(n)||(a(`${e} must be a JSON array of gradients, e.g. '[{"id":"dawn","type":"linear","stops":[{"color":"#155DAC","position":0},{"color":"#0B2C52","position":100}]}]'.`),process.exit(s.INVALID_INPUT)),n}function Bh(e,t){let n=Hd(e,t);return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${e} must be a JSON object.`),process.exit(s.INVALID_INPUT)),n}var Fh=new zd("set").description("Replace a brand's gradient library (whole-set: omitted gradients are deleted)").argument("<brand-id>","Brand profile ID").requiredOption("--gradients <json>",`The complete gradient list as JSON, e.g. '[{"id":"dawn","name":"Dawn","type":"linear","angle":135,"stops":[{"color":"#155DAC","position":0},{"color":"#0B2C52","position":100}]}]'. Gradients you omit are DELETED.`).option("--roles <json>",`Role pointers by gradient id, e.g. '{"primary":"dawn"}'. Omit to leave the brand's current roles alone.`).option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),jh(e);let n={brandId:e,gradients:Mh("--gradients",t.gradients),teamId:t.teamId};t.roles!==void 0&&(n.gradientRoles=Bh("--roles",t.roles));try{l(await m("setBrandGradients",n,Vh(`setBrandGradients:${e}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(s.GENERAL_ERROR)}}),Xd=new zd("gradient").description("Brand gradient library commands").addCommand(Fh);import{createHash as Gh}from"crypto";import{Command as it}from"commander";var Kh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function mn(e){Kh.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function Wh(e,t=[]){return[...t,e]}function jo(e){return Gh("sha256").update(e).digest("hex").slice(0,32)}function qo(e,t){if(t==="true")return!0;if(t==="false")return!1;a(`${e} must be true or false; got "${t}".`),process.exit(s.INVALID_INPUT)}function Yd(e,t){try{return JSON.parse(t)}catch{a(`${e} must be valid JSON.`),process.exit(s.INVALID_INPUT)}}var Jh=new it("get").description("Read a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),mn(e);try{l(await m("getBrandGuardrails",{brandId:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(s.GENERAL_ERROR)}}),zh=new it("test").description("Check content against a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--content <text>","The content to check").option("--channel <channel>","Channel the content is for, e.g. deck-16-9").option("--market <market>","Market the content is for, e.g. US").option("--artifact-type <type>","Artifact type, e.g. presentation").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),mn(e),t.content===void 0&&(a("Pass --content with the text to check."),process.exit(s.INVALID_INPUT));let n={brandId:e,content:t.content,teamId:t.teamId};t.channel!==void 0&&(n.channel=t.channel),t.market!==void 0&&(n.market=t.market),t.artifactType!==void 0&&(n.artifactType=t.artifactType);try{let r=await m("testBrandGuardrails",n);l(r),r.passed===!1&&process.exit(s.GENERAL_ERROR)}catch(r){a(r instanceof Error?r.message:"Test failed"),process.exit(s.GENERAL_ERROR)}}),Hh=new it("set").description("Create or update one of a brand's guardrail rules").argument("<brand-id>","Brand profile ID").option("--name <text>","Human-readable name for the rule").option("--category <category>","language | compliance | channel-requirements | accessibility | asset-usage").option("--severity <severity>","shadow | warn | block").option("--require <json>",`What the rule demands, as JSON, e.g. '{"component":"banned-phrase","text":"cheap"}'`).option("--conditions <json>",`When the rule applies, as JSON, e.g. '{"op":"AND","clauses":[{"field":"channel","op":"is","values":["deck-16-9"]}]}'`).option("--enabled <bool>","true or false; defaults to true").option("--node-key <key>","Key of an existing rule to UPDATE, as `guardrails get` lists it. Omit to create.").option("--notes <text>","Notes about the rule").option("--slug <slug>","Explicit kebab-case slug for a new rule").option("--publish <bool>","Publish a brand snapshot after the write; defaults to true").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),mn(e),(!t.name||!t.category||!t.severity)&&(a("Pass --name, --category and --severity."),process.exit(s.INVALID_INPUT)),t.require===void 0&&(a(`Pass --require, e.g. '{"component":"banned-phrase"}'.`),process.exit(s.INVALID_INPUT));let n={brandId:e,category:t.category,name:t.name,require:Yd("--require",t.require),severity:t.severity,teamId:t.teamId};t.conditions!==void 0&&(n.conditions=Yd("--conditions",t.conditions)),t.enabled!==void 0&&(n.enabled=qo("--enabled",t.enabled)),t.nodeKey!==void 0&&(n.nodeKey=t.nodeKey),t.notes!==void 0&&(n.notes=t.notes),t.slug!==void 0&&(n.slug=t.slug),t.publish!==void 0&&(n.publish=qo("--publish",t.publish));try{l(await m("setBrandGuardrail",n,jo(`setBrandGuardrail:${e}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(s.GENERAL_ERROR)}}),Xh=new it("delete").description("Remove one of a brand's guardrail rules").argument("<brand-id>","Brand profile ID").argument("<node-key>","Key of the rule, as `guardrails get` lists it").option("--publish <bool>","Publish a brand snapshot after the removal; defaults to true").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{await h(),mn(e);let r={brandId:e,nodeKey:t,teamId:n.teamId};n.publish!==void 0&&(r.publish=qo("--publish",n.publish));try{l(await m("deleteBrandGuardrail",r,jo(`deleteBrandGuardrail:${e}:${t}`)))}catch(o){a(o instanceof Error?o.message:"Delete failed"),process.exit(s.GENERAL_ERROR)}}),Yh=new it("generate").description("Draft guardrail rule proposals for a brand").argument("<brand-id>","Brand profile ID").option("--brand-name <name>","Brand name to draft rules for").option("--channel <channel>","Channel the brand publishes to; repeat for several. At least one is required.",Wh).option("--brand-description <text>","What the brand does").option("--brand-voice <text>","How the brand sounds").option("--industry <text>","Industry the brand operates in").option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),mn(e),t.brandName||(a("Pass --brand-name."),process.exit(s.INVALID_INPUT)),t.channel?.length||(a("Pass at least one --channel to scope the proposed rules."),process.exit(s.INVALID_INPUT));let n={activeChannels:t.channel,brandId:e,brandName:t.brandName,teamId:t.teamId};t.brandDescription!==void 0&&(n.brandDescription=t.brandDescription),t.brandVoice!==void 0&&(n.brandVoice=t.brandVoice),t.industry!==void 0&&(n.industry=t.industry);try{let r=await m("generateBrandGuardrails",n,jo(`generateBrandGuardrails:${JSON.stringify(n)}`));if(t.wait===!1){l(r);return}l(await Is(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(s.GENERAL_ERROR)}}),Qh=new it("generate-status").description("Read a brand guardrails generation run").argument("<run-id>","Run ID from `branding guardrails generate --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("generateBrandGuardrails",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Qd=new it("guardrails").description("Brand guardrail rule commands").addCommand(Jh).addCommand(zh).addCommand(Hh).addCommand(Xh).addCommand(Yh).addCommand(Qh);import{randomUUID as Zh}from"crypto";import{readFile as Zd}from"fs/promises";import{Command as ey}from"commander";var ec=new ey("import").description("Import a workspace brand from a DESIGN.md file").argument("<design-md-file>","Path to the DESIGN.md file").option("--name <name>","Override the brand name in the document").option("--url <url>","Associate a source URL with the imported brand").option("--url-evidence <json-file>","Merge a saved raw URL-extraction JSON response").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable key for retrying the same import without creating another brand").action(async(e,t)=>{await h();try{let n=await Zd(e,"utf8"),r=t.urlEvidence?JSON.parse(await Zd(t.urlEvidence,"utf8")):void 0,o=t.idempotencyKey??Zh();l(await m("importBrandDesignMd",{designMd:n,name:t.name,teamId:t.teamId,url:t.url,urlExtractedRaw:r},o))}catch(n){a(n instanceof Error?n.message:"Import failed"),process.exit(s.GENERAL_ERROR)}});import{Command as tc,InvalidArgumentError as nc}from"commander";var ty=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ny(e){if(!ty.test(e))throw new nc("Expected a brand UUID from `mf branding list`.");return e}function ry(e){let t=Number(e);if(!Number.isInteger(t)||t<1||t>50)throw new nc("--limit expects a whole number from 1 to 50.");return t}var oy=new tc("list").description("List recent safe job summaries for one brand").argument("<brand-id>","Brand UUID",ny).option("--limit <count>","Newest jobs to return, 1-50 (default: 20)",ry).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandJobs",{brandId:e,limit:t.limit,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Brand job history failed"),process.exit(s.GENERAL_ERROR)}}),rc=new tc("jobs").description("Inspect brand background activity").addCommand(oy);import{createHash as iy}from"crypto";import{Command as je}from"commander";var ay=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Ve(e){ay.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function St(e){return iy("sha256").update(e).digest("hex").slice(0,32)}var oc=new je("create").description("Create an empty workspace brand and print its JSON").argument("<name>","Name for the new brand").option("--parent <brand-id>","File the new brand under this parent").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),t.parent&&Ve(t.parent);try{l(await m("createBrand",{name:e,parentBrandingId:t.parent,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Create failed"),process.exit(s.GENERAL_ERROR)}}),ic=new je("star").description("Add a library star, or remove it with --off, and print the result").argument("<brand-id>","Brand profile ID").option("--off","Remove the star instead of adding it").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ve(e);let n=!t.off;try{l(await m("setBrandStar",{brandId:e,starred:n,teamId:t.teamId},St(`setBrandStar:${e}:${n}`)))}catch(r){a(r instanceof Error?r.message:"Star failed"),process.exit(s.GENERAL_ERROR)}});async function sy(e,t){let n=await m("getBrandProfile",{brandId:e,teamId:t.teamId});return typeof n.name=="string"?n.name:e}var ac=new je("delete").description("Soft-delete a brand after confirmation and print the result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").option("--yes","Confirm soft deletion without an interactive prompt").action(async(e,t)=>{if(await h(),Ve(e),!t.yes&&process.stdin.isTTY){let n;try{n=await sy(e,t)}catch(r){a(r instanceof Error?r.message:"Could not read the brand"),process.exit(s.GENERAL_ERROR)}a(`Refusing to delete "${n}" (${e}) without confirmation. Re-run with --yes to remove this brand from the library.`),process.exit(s.GENERAL_ERROR)}try{l(await m("deleteBrand",{brandId:e,teamId:t.teamId},St(`deleteBrand:${e}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(s.GENERAL_ERROR)}}),Vo="none",sc=new je("update").description("Rename with --name or move with --parent; print the updated JSON").argument("<brand-id>","Brand profile ID").option("--name <name>","New name for the brand").option("--parent <brand-id>",`File the brand under this parent, or "${Vo}" to detach it`).option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ve(e);let n=t.parent?.toLowerCase()===Vo;t.parent!==void 0&&!n&&Ve(t.parent),t.name===void 0&&t.parent===void 0&&(a(`Nothing to update. Pass --name to rename this brand, or --parent <brand-id> to move it (--parent ${Vo} detaches it).`),process.exit(s.INVALID_INPUT));let r={brandId:e,teamId:t.teamId};t.name!==void 0&&(r.name=t.name),t.parent!==void 0&&(r.parentBrandingId=n?null:t.parent);try{l(await m("updateBrand",r,St(`updateBrand:${e}:${t.name??""}:${t.parent??""}`)))}catch(o){a(o instanceof Error?o.message:"Update failed"),process.exit(s.GENERAL_ERROR)}}),dc=new je("set-default").description("Use this brand by default for new artifacts and print the result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ve(e);try{l(await m("setDefaultBrand",{brandId:e,teamId:t.teamId},St(`setDefaultBrand:${e}`)))}catch(n){a(n instanceof Error?n.message:"Set default failed"),process.exit(s.GENERAL_ERROR)}}),cc=new je("approve").description("Approve a reviewed brand for use and print the persisted result").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ve(e);try{let n=await W(t.teamId);l(await m("approveBrand",{brandId:e,teamId:n},St(`approveBrand:${n}:${e}`)))}catch(n){a(n instanceof Error?n.message:"Approve failed"),process.exit(s.GENERAL_ERROR)}}),lc=new je("onboarding").description("Manage the brand onboarding review state").addCommand(new je("complete").description("Mark onboarding review complete without approving the brand").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ve(e);try{let n=await W(t.teamId);l(await m("completeBrandOnboarding",{brandId:e,teamId:n},St(`completeBrandOnboarding:${n}:${e}`)))}catch(n){a(n instanceof Error?n.message:"Complete onboarding failed"),process.exit(s.GENERAL_ERROR)}}));import{createHash as Mo}from"crypto";import{existsSync as dy,readFileSync as cy}from"fs";import{basename as ly}from"path";import{Command as tr}from"commander";import my from"ora";function uy(e,t,n){return Mo("sha256").update(JSON.stringify([e,t,n??null])).digest("hex").slice(0,32)}var mc=new tr("logo").description("Upload primary, dark-background, and favicon logo files").addCommand(new tr("list").description("List exact logo candidates and identify the active one").argument("<brand-id>","Brand UUID from `mf branding list`").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandLogos",{brandId:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Logo list failed"),process.exit(s.GENERAL_ERROR)}})).addCommand(new tr("remove").description("Remove one exact candidate URL and select its deterministic fallback").argument("<brand-id>","Brand UUID from `mf branding list`").argument("<logo-url>","Exact URL returned by `mf branding logo list`").option("--yes","Confirm exact candidate removal without an interactive prompt").option("--idempotency-key <key>","Stable retry key; derived from brand and URL when omitted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t,n)=>{await h(),n.yes||(a("Refusing to remove a logo candidate without --yes."),process.exit(s.INVALID_INPUT));try{l(await m("removeBrandLogo",{brandId:e,logoUrl:t,teamId:n.teamId},n.idempotencyKey??uy("removeBrandLogo",e,t)))}catch(r){a(r instanceof Error?r.message:"Logo removal failed"),process.exit(s.GENERAL_ERROR)}})).addCommand(new tr("set").description("Upload one logo variant and print the updated brand JSON").argument("[brand-id]","Brand ID (defaults to this workspace's default brand)").requiredOption("--file <path>","Local image file to upload and use").option("--variant <variant>","primary | dark | favicon. 'dark' is the reversed lock-up for dark backgrounds","primary").option("--idempotency-key <key>","Stable retry key; deterministically derived from workspace, brand, variant, and file bytes when omitted").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();let n=t.variant??"primary";["primary","dark","favicon"].includes(n)||(a(`--variant must be primary, dark, or favicon (got "${n}")`),process.exit(s.INVALID_INPUT)),dy(t.file)||(a(`File not found: ${t.file}`),process.exit(s.INVALID_INPUT));let r=Mo("sha256").update(cy(t.file)).digest("hex"),o=t.idempotencyKey??Mo("sha256").update(`setBrandLogo:${t.teamId??"current"}:${e??"default"}:${n}:${r}`).digest("hex").slice(0,32),i=my({text:`Uploading ${ly(t.file)}...`,stream:process.stderr}).start(),c;try{c=(await Q(t.file,{idempotencyKey:`${o}:upload`,storagePrefix:"brand-logos"})).url,i.succeed("Uploaded")}catch(d){i.fail("Upload failed"),a(d instanceof Error?d.message:String(d)),process.exit(s.GENERAL_ERROR)}try{l(await m("setBrandLogo",{brandId:e,fileUrl:c,teamId:t.teamId,variant:n},o))}catch(d){a(d instanceof Error?d.message:"Write failed"),process.exit(s.GENERAL_ERROR)}}));import{createHash as py,randomUUID as gy}from"crypto";import{Command as Et,InvalidArgumentError as nr}from"commander";var fy=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,hy=["admin","editor","viewer"],uc=["cancelled","completed","failed","info","queued","running"],pc=["activity","brand-extraction-request","brand-resolution","brand-sync-job"];function at(e){return t=>{if(!fy.test(t))throw new nr(`${e} expects a UUID from \`mf branding list\` or the workspace member list.`);return t}}function fc(e){let t=Number(e);if(!Number.isInteger(t)||t<1||t>200)throw new nr("--limit expects a whole number from 1 to 200.");return t}function gc(e,t){return n=>{let r=n.split(",").map(i=>i.trim()).filter(Boolean);if(r.find(i=>!t.includes(i))||r.length===0)throw new nr(`${e} expects comma-separated values from: ${t.join(", ")}.`);return r}}function hc(e,t){return py("sha256").update(JSON.stringify([e,t,gy()])).digest("hex").slice(0,32)}function un(e,t){a(e instanceof Error?e.message:t),process.exit(typeof e=="object"&&e!==null&&"exitCode"in e&&typeof e.exitCode=="number"?e.exitCode:s.GENERAL_ERROR)}var yy=new Et("list").description("List explicit member access overrides for one team brand").argument("<brand-id>","Team brand UUID",at("brand-id")).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandPermissions",{brandId:e,teamId:t.teamId}))}catch(n){un(n,"Brand permission list failed")}}),by=new Et("candidates").description("List member IDs eligible for one team brand's access overrides").argument("<brand-id>","Team brand UUID",at("brand-id")).option("--query <text>","Search member name, username, or email").option("--limit <count>","Maximum members, 1-200 (default: 50)",fc).option("--offset <count>","Members to skip (default: 0)",e=>{let t=Number(e);if(!Number.isInteger(t)||t<0)throw new nr("--offset expects a whole number of 0 or more.");return t}).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandPermissionCandidates",{brandId:e,limit:t.limit,offset:t.offset,query:t.query,teamId:t.teamId}))}catch(n){un(n,"Brand permission candidate list failed")}}),wy=new Et("set").description("Set one team member's explicit role for a team brand").argument("<brand-id>","Team brand UUID",at("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",at("--user")).requiredOption("--role <role>","Desired override: admin | editor | viewer",y("--role",hy)).option("--idempotency-key <key>","Explicit retry identity; otherwise a new payload-bound key is minted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("setBrandPermission",{brandId:e,role:t.role,teamId:t.teamId,userId:t.user},t.idempotencyKey??hc("setBrandPermission",{brandId:e,role:t.role,teamId:t.teamId??null,userId:t.user})))}catch(n){un(n,"Brand permission update failed")}}),vy=new Et("remove").description("Remove one member override so the team role applies again").argument("<brand-id>","Team brand UUID",at("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",at("--user")).option("--yes","Confirm this access change without an interactive prompt").option("--idempotency-key <key>","Explicit retry identity; otherwise a new payload-bound key is minted").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h(),t.yes||(a("Refusing to remove a brand access override without --yes."),process.exit(s.INVALID_INPUT));try{l(await m("removeBrandPermission",{brandId:e,teamId:t.teamId,userId:t.user},t.idempotencyKey??hc("removeBrandPermission",{brandId:e,teamId:t.teamId??null,userId:t.user})))}catch(n){un(n,"Brand permission removal failed")}}),yc=new Et("permission").description("Administer explicit member access overrides for a team brand").addCommand(by).addCommand(yy).addCommand(wy).addCommand(vy),bc=new Et("activity").description("Read a brand's filtered, cursor-paginated activity feed").argument("<brand-id>","Brand UUID",at("brand-id")).option("--query <text>","Search action, summary, detail, entity, and metadata").option("--status <statuses>",`Comma-separated statuses: ${uc.join(" | ")}`,gc("--status",uc)).option("--source-type <types>",`Comma-separated sources: ${pc.join(" | ")}`,gc("--source-type",pc)).option("--from <iso-time>","Inclusive ISO-8601 lower time bound").option("--to <iso-time>","Inclusive ISO-8601 upper time bound").option("--limit <count>","Maximum rows, 1-200 (default: 80)",fc).option("--cursor <cursor>","Opaque nextCursor from the preceding page").option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t)=>{await h();try{l(await m("listBrandActivity",{brandId:e,cursor:t.cursor,from:t.from,limit:t.limit,query:t.query,sourceTypes:t.sourceType,statuses:t.status,teamId:t.teamId,to:t.to}))}catch(n){un(n,"Brand activity read failed")}});import{createHash as Iy}from"crypto";import{Command as Tt,InvalidArgumentError as Fo}from"commander";var ky=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function Bo(e,t){if(ky.test(e))return e;throw new Fo(`${t} must be a UUID.`)}function xy(e){let t=Number(e);if(Number.isInteger(t)&&t>=1&&t<=50)return t;throw new Fo("limit must be a whole number from 1 to 50.")}function Ry(e){let t=Number(e);if(Number.isInteger(t)&&t>=0)return t;throw new Fo("offset must be a whole number of 0 or more.")}function Cy(e){return Iy("sha256").update(e).digest("hex").slice(0,32)}async function rr(e,t){await h();try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(s.GENERAL_ERROR)}}var wc=new Tt("presentations").description("Inspect presentations already linked to a brand").addCommand(new Tt("list").description("List linked decks with preview, version, stale, and last-sync state").argument("<brand-id>","Brand UUID from `branding list`").option("--limit <n>","Rows to return (1-50; default 50)",xy,50).option("--offset <n>","Zero-based offset (default 0)",Ry,0).option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(e,t)=>{let n=Bo(e,"brand-id");await rr(()=>m("listBrandPresentations",{brandId:n,limit:t.limit,offset:t.offset,teamId:t.teamId}),"Could not list linked presentations")})),vc=new Tt("presentation").description("Inspect or update one deck from its already-linked brand").addCommand(new Tt("drift").description("Read current, drifted, unknown, or not-linked status and exact changes").argument("<presentation>","Presentation UUID, document UUID, or slug").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(e,t)=>{await rr(()=>m("getPresentationBrandDrift",{presentationId:e,teamId:t.teamId}),"Could not read presentation brand drift")})).addCommand(new Tt("apply-changes").description("Create a new deck version using its linked brand's current colors, fonts, and logo").argument("<presentation>","Presentation UUID, document UUID, or slug").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").requiredOption("--idempotency-key <key>","Stable key; reuse it for an exact retry, change it for a later brand update").action(async(e,t)=>{await rr(()=>m("applyPresentationBrandChanges",{presentationId:e,teamId:t.teamId},t.idempotencyKey),"Could not apply linked-brand changes")})),Ic=new Tt("sync-cancel").description("Cancel an active bulk linked-deck sync through its durable run; retries are safe").argument("<brand-id>","Brand UUID used to start the sync").argument("<run-id>","Active run UUID from `branding sync --no-wait`").option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(e,t,n)=>{let r=Bo(e,"brand-id"),o=Bo(t,"run-id");await rr(()=>m("cancelBrandPresentationSync",{brandId:r,runId:o,teamId:n.teamId},Cy(`cancelBrandPresentationSync:${r}:${o}`)),"Could not cancel brand sync")});import{createHash as Sy,randomUUID as Cc}from"crypto";import{Command as Me}from"commander";var Ey=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,kc=["product","service","platform","solution"],or=["candidate","draft","approved"],xc=["brand-site","brand-site-scan","brand-site-extract","product-url"];function $t(e){Ey.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function ir(e,t,n){if(n.includes(t))return t;a(`${e} must be one of: ${n.join(", ")}.`),process.exit(s.INVALID_INPUT)}function Ty(e,t){let n=Number(t);if(Number.isInteger(n)&&n>0)return n;a(`${e} must be a whole number greater than zero.`),process.exit(s.INVALID_INPUT)}function Go(e){return Sy("sha256").update(e).digest("hex").slice(0,32)}var $y=new Me("list").description("List the products a brand sells").argument("<brand-id>","Brand profile ID").option("--status <status>",`Only products in this state. One of: ${or.join(", ")}. Omit for the saved catalogue.`).option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),$t(e),t.status!==void 0&&ir("--status",t.status,or);let n={brandId:e,teamId:t.teamId};t.status!==void 0&&(n.status=t.status);try{l(await m("listBrandProducts",n))}catch(r){a(r instanceof Error?r.message:"List failed"),process.exit(s.GENERAL_ERROR)}}),Ay=new Me("set").description("Create or update one of a brand's products").argument("<brand-id>","Brand profile ID").option("--product <id>","Existing product to update. Omit to create, or to update the product this brand already has at the same --url.").option("--name <name>","Product name (required when creating)").option("--type <type>",`One of: ${kc.join(", ")}`).option("--description <text>","What the product is, in full").option("--summary <text>","Short form of the description").option("--url <url>","The product's page. Also its identity: a url this brand already has updates that product.").option("--status <status>",`One of: ${or.join(", ")}`).option("--logo-url <url>","Product logo URL").option("--inherits-brand <true|false>","Whether the product presents in the parent brand's design").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),$t(e),t.type!==void 0&&ir("--type",t.type,kc),t.status!==void 0&&ir("--status",t.status,or),t.inheritsBrand!==void 0&&t.inheritsBrand!=="true"&&t.inheritsBrand!=="false"&&(a("--inherits-brand must be true or false."),process.exit(s.INVALID_INPUT));let n={brandId:e,teamId:t.teamId};t.product!==void 0&&(n.productId=t.product),t.name!==void 0&&(n.name=t.name),t.type!==void 0&&(n.type=t.type),t.description!==void 0&&(n.description=t.description),t.summary!==void 0&&(n.summary=t.summary),t.url!==void 0&&(n.url=t.url),t.status!==void 0&&(n.status=t.status),t.logoUrl!==void 0&&(n.logoUrl=t.logoUrl),t.inheritsBrand!==void 0&&(n.inheritsBrand=t.inheritsBrand==="true");try{l(await m("saveBrandProduct",n,Go(`saveBrandProduct:${e}:${t.product??t.url??t.name??"new"}`)))}catch(r){a(r instanceof Error?r.message:"Save failed"),process.exit(s.GENERAL_ERROR)}}),Rc=(e,t=[])=>[...t,e],Py=new Me("select").description("Atomically set approved products in a bounded product set").argument("<brand-id>","Brand profile ID").option("--product <id>","Product whose state to set; repeat for every product in the bounded set.",Rc).option("--approve <id>","Product from --product that should finish approved; repeat as needed. Others finish draft.",Rc).option("--idempotency-key <key>","Stable retry key for this selection").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),$t(e),t.product?.length||(a("Pass at least one --product <id> to set product approval."),process.exit(s.INVALID_INPUT));let n={approvedProductIds:t.approve??[],brandId:e,productIds:t.product,teamId:t.teamId};try{l(await m("setBrandProductSelection",n,t.idempotencyKey??Cc()))}catch(r){a(r instanceof Error?r.message:"Selection failed"),process.exit(s.GENERAL_ERROR)}}),Oy=new Me("duplicate").description("Create an independent draft copy of one product").argument("<brand-id>","Brand profile ID").requiredOption("--product <id>","Product ID to duplicate").option("--name <name>","Name for the copy").option("--idempotency-key <key>","Stable retry key for this duplication").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),$t(e);let n={brandId:e,productId:t.product,teamId:t.teamId};t.name!==void 0&&(n.name=t.name);try{l(await m("duplicateBrandProduct",n,t.idempotencyKey??Cc()))}catch(r){a(r instanceof Error?r.message:"Duplicate failed"),process.exit(s.GENERAL_ERROR)}}),Dy=new Me("delete").description("Remove one product from a brand").argument("<brand-id>","Brand profile ID").option("--product <id>","Product ID to remove").option("--team-id <id>","Workspace ID").option("--yes","Skip the confirmation prompt").action(async(e,t)=>{await h(),$t(e),t.product===void 0&&(a("Pass --product <id> to name the product to remove. `branding product list <brand-id>` prints the ids."),process.exit(s.INVALID_INPUT)),!t.yes&&process.stdin.isTTY&&(a(`Refusing to delete product "${t.product}" without confirmation. Re-run with --yes.`),process.exit(s.GENERAL_ERROR));try{l(await m("deleteBrandProduct",{brandId:e,productId:t.product,teamId:t.teamId},Go(`deleteBrandProduct:${e}:${t.product}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(s.GENERAL_ERROR)}}),Ny=new Me("extract").description("Discover a brand's products by crawling its site").argument("<brand-id>","Brand profile ID").option("--mode <mode>",`One of: ${xc.join(", ")}`).option("--url <url>","Page to extract (product-url), or the site to scan instead of the brand's own recorded URL").option("--max-products <count>","How many pages to take from the scan (max 30)").option("--product <id>","Candidate product to extract; repeat for several. Required for brand-site-extract.",(e,t=[])=>[...t,e]).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),$t(e),t.mode!==void 0&&ir("--mode",t.mode,xc);let n={brandId:e,teamId:t.teamId};t.mode!==void 0&&(n.mode=t.mode),t.url!==void 0&&(n.url=t.url),t.maxProducts!==void 0&&(n.maxProducts=Ty("--max-products",t.maxProducts)),t.product?.length&&(n.productIds=t.product);try{let r=await m("extractBrandProducts",n,Go(`extractBrandProducts:${JSON.stringify(n)}`));if(t.wait===!1){l(r);return}l(await ws(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Extract failed"),process.exit(s.GENERAL_ERROR)}}),Ly=new Me("extract-status").description("Read a brand product extraction run").argument("<run-id>","Run ID from `branding product extract --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("extractBrandProducts",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Sc=new Me("product").description("Brand product catalogue commands").addCommand($y).addCommand(Ay).addCommand(Py).addCommand(Oy).addCommand(Dy).addCommand(Ny).addCommand(Ly);import{createHash as Uy}from"crypto";import{Command as ar}from"commander";var _y=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Ec(e){_y.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function qy(e,t=[]){return[...t,e]}function jy(e){return Uy("sha256").update(e).digest("hex").slice(0,32)}var Vy=new ar("get").description("Read which decks have drifted from a brand").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ec(e);try{l(await m("getBrandQuality",{brandId:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(s.GENERAL_ERROR)}}),My=new ar("repair").description("Repair decks that have visually drifted from a brand").argument("<brand-id>","Brand profile ID").option("--scope <scope>","selected (repair only --deck ids) or all_eligible (repair every drifted deck). Required.").option("--deck <presentation-id>","Deck to repair; repeat for several. Only used with --scope selected.",qy).option("--confirm-partial","Also repair decks whose guidance changed too; they stay flagged as guidance-outdated afterwards.").option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ec(e),t.scope!=="selected"&&t.scope!=="all_eligible"&&(a("Pass --scope selected or --scope all_eligible. There is no default: 'selected' repairs only the decks you name, 'all_eligible' repairs every drifted deck on the brand."),process.exit(s.INVALID_INPUT)),t.scope==="selected"&&!t.deck?.length&&(a("--scope selected needs at least one --deck."),process.exit(s.INVALID_INPUT));let n={brandId:e,scope:t.scope,teamId:t.teamId};t.deck?.length&&(n.presentationIds=t.deck),t.confirmPartial===!0&&(n.confirmedPartialRepair=!0);try{let r=await m("repairBrandQuality",n,jy(`repairBrandQuality:${JSON.stringify(n)}`));if(t.wait===!1){l(r);return}l(await ks(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Repair failed"),process.exit(s.GENERAL_ERROR)}}),By=new ar("repair-status").description("Read a brand quality repair run").argument("<run-id>","Run ID from `branding quality repair --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("repairBrandQuality",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Tc=new ar("quality").description("Brand deck quality commands").addCommand(Vy).addCommand(My).addCommand(By);function Ko(e){return Array.isArray(e.items)}function Le(e){return typeof e=="string"&&e.length>0?e:void 0}function Wo(e){return Le(e.resolvedTokens?.logoUrl)??Le(e.brandData?.assets?.logo)??Le(e.brandData?.assets?.logoUrl)??Le(e.brandData?.logoUrl)}function Jo(e){return Le(e.resolvedTokens?.colors?.primary)??Le(e.brandData?.colors?.primary)??Le(e.brandData?.enhancedColors?.palette?.[0]?.hex)}function $c(e){let t=e.brandData?.enhancedColors?.palette??e.brandData?.colors?.palette;if(!Array.isArray(t))return[];let n=[];for(let r of t){if(typeof r=="string"){n.push({hex:r});continue}if(r&&typeof r=="object"&&"hex"in r){let{hex:o,role:i}=r;typeof o=="string"&&n.push({hex:o,...typeof i=="string"?{role:i}:{}})}}return n}function Fy(e){return{id:e.id,isDefault:e.isDefault,name:e.name,...e.domain?{sourceUrl:e.domain}:{},...e.logoUrl?{logoUrl:e.logoUrl}:{},...e.primaryColor?{primaryColor:e.primaryColor}:{}}}function Gy(e){let t=Le(e.extractedFrom)??Le(e.normalizedUrl),n=Wo(e),r=Jo(e);return{id:e.id,isDefault:e.isDefault,name:e.name,...t?{sourceUrl:t}:{},...n?{logoUrl:n}:{},...r?{primaryColor:r}:{},...e.createdAt?{createdAt:e.createdAt}:{}}}function Ac(e){return Ko(e)?e.items.map(Gy):e.brandings.map(Fy)}import{createHash as Ky}from"crypto";import{Command as Fe,InvalidArgumentError as Wy}from"commander";var Jy=["x","instagram","facebook","linkedin","tiktok","youtube"],zy=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Be(e){if(!zy.test(e))throw new Wy("Expected a UUID returned by the corresponding list command.");return e}function sr(e,t){return Ky("sha256").update(JSON.stringify([e,...t])).digest("hex")}function At(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var Hy=new Fe("list").description("List one brand's competitors with stable IDs, websites, X accounts, and avatars").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async e=>{await h();try{l(await m("getBrandCompetitors",{brandingId:e.brandingId,teamId:e.teamId}))}catch(t){At(t,"Competitor list failed")}}),Xy=new Fe("add").description("Add or update one competitor by name and print its stable saved row").argument("<name>","Competitor company or product name").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--website <url>","Competitor website as a full URL").option("--x-handle <handle>","Competitor X handle, with or without @").option("--x-avatar-url <url>","Avatar URL for the selected X account").option("--no-resolve-handle","Do not search X when --x-handle is omitted").action(async(e,t)=>{await h();let n={brandingId:t.brandingId,name:e,resolveHandle:t.resolveHandle,teamId:t.teamId,website:t.website,xAvatarUrl:t.xAvatarUrl,xHandle:t.xHandle};try{l(await m("addCompetitor",n,sr("addCompetitor",[t.brandingId??"default",e.trim(),t.website??null,t.xHandle??null,t.xAvatarUrl??null,t.resolveHandle])))}catch(r){At(r,"Competitor write failed")}}),Yy=new Fe("delete").description("Remove one competitor by the stable ID from competitor list").argument("<competitor-id>","Competitor UUID",Be).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--yes","Confirm removal without an interactive prompt").action(async(e,t)=>{await h(),t.yes||(a("Refusing to remove a competitor without --yes."),process.exit(s.INVALID_INPUT));try{l(await m("deleteBrandCompetitor",{brandingId:t.brandingId,competitorId:e,teamId:t.teamId},sr("deleteBrandCompetitor",[t.brandingId??"default",e])))}catch(n){At(n,"Competitor removal failed")}}),Pc=new Fe("competitor").description("List, add, update, or remove a brand's competitor watch rows").addCommand(Hy).addCommand(Xy).addCommand(Yy),Qy=new Fe("list").description("List one brand's social accounts with stable IDs, platforms, sources, and URLs").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async e=>{await h();try{l(await m("listBrandSocialHandles",{brandingId:e.brandingId,teamId:e.teamId}))}catch(t){At(t,"Social-account list failed")}}),Zy=new Fe("add").description("Record one social account and print its stable saved row").argument("<platform>","Social network: x | instagram | facebook | linkedin | tiktok | youtube",y("platform",Jy)).argument("<handle>","Account handle on that social network").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").action(async(e,t,n)=>{await h();try{l(await m("addBrandSocialHandle",{brandingId:n.brandingId,handle:t,platform:e,teamId:n.teamId},sr("addBrandSocialHandle",[n.brandingId??"default",e,t.replace(/^@/,"")])))}catch(r){At(r,"Social-account write failed")}}),eb=new Fe("delete").description("Remove one social account by the stable ID from social list").argument("<handle-id>","Social-handle UUID",Be).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",Be).option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("--yes","Confirm removal without an interactive prompt").action(async(e,t)=>{await h(),t.yes||(a("Refusing to remove a social account without --yes."),process.exit(s.INVALID_INPUT));try{l(await m("deleteBrandSocialHandle",{brandingId:t.brandingId,handleId:e,teamId:t.teamId},sr("deleteBrandSocialHandle",[t.brandingId??"default",e])))}catch(n){At(n,"Social-account removal failed")}}),Oc=new Fe("social").description("List, record, or remove the social accounts owned by a brand").addCommand(Qy).addCommand(Zy).addCommand(eb);import{createHash as tb}from"crypto";import{Command as Dc}from"commander";var nb=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function rb(e){nb.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function ob(e){return tb("sha256").update(e).digest("hex").slice(0,32)}var Nc=new Dc("sync").description("Update linked decks from their brand; waits by default, versions decks, and prints JSON").argument("<brand-id>","Brand profile ID").option("--no-wait","Return a run ID; resume with `branding sync-status <run-id>`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),rb(e);let n={brandId:e,teamId:t.teamId};try{let r=await m("syncBrandToPresentations",n,ob(`syncBrandToPresentations:${e}`));if(t.wait===!1){l(r);return}l(await xs(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Sync failed"),process.exit(s.GENERAL_ERROR)}}),Lc=new Dc("sync-status").description("Print linked-deck sync progress, terminal result, or error").argument("<run-id>","Run ID from `branding sync --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("syncBrandToPresentations",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}});import{readFile as ib}from"fs/promises";import{randomUUID as ab}from"crypto";import{Command as Uc}from"commander";var sb=["color.primary","color.background","color.text","color.secondary","color.accent","color.surface","color.link","typography.primary","typography.secondary","typography.h1","typography.h2","typography.h3","typography.h4","typography.h5","typography.h6","typography.paragraph","typography.button","typography.small","typography.label","typography.caption","asset.logo","asset.logo.dark","asset.favicon"];function db(e){let t=e.split(".").filter(Boolean);for(let n=t.length;n>=2;n--){let r=t.slice(0,n).join(".");if(sb.includes(r))return{fieldPath:t.slice(n),nodeKey:r}}return{fieldPath:t.slice(2),nodeKey:t.slice(0,2).join(".")}}function cb(e){let t={};for(let n of e){let r=n.indexOf("=");if(r<=0)throw new Error(`"${n}" is not a token assignment. Use key=value, e.g. color.primary=#114b97`);let o=n.slice(0,r).trim(),i=n.slice(r+1);if(o.split(".").filter(Boolean).length<2)throw new Error(`"${o}" is not a brand token key. Expected something like color.primary or typography.h1.size`);let{fieldPath:d,nodeKey:u}=db(o),g=lb(i);if(d.length===0){t[u]=g;continue}let w=t[u],v=w&&typeof w=="object"&&!Array.isArray(w)?w:{},x=v;for(let T of d.slice(0,-1)){let A=x[T],S=A&&typeof A=="object"&&!Array.isArray(A)?A:{};x[T]=S,x=S}x[d[d.length-1]]=g,t[u]=v}return t}function lb(e){return e==="true"?!0:e==="false"?!1:/^-?\d+(?:\.\d+)?$/.test(e)?Number(e):e}function mb(e,t){return e===void 0?{assignments:[...t]}:e.includes("=")?{assignments:[e,...t]}:{assignments:[...t],brandId:e}}var _c=new Uc("profile").description("Read a brand's design tokens, the keys it is missing, or its design.md").argument("[brand-id]","Brand ID (defaults to this workspace's brand)").option("--format <format>","tokens (default) or md").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{let n=await m("getBrandProfile",{brandId:e,format:t.format,teamId:t.teamId});if(t.format==="md"&&typeof n.designMd=="string"){console.log(n.designMd);return}l(n)}catch(n){a(n instanceof Error?n.message:"Profile read failed"),process.exit(s.GENERAL_ERROR)}}),qc=new Uc("set").description("Write brand design tokens (key=value pairs or a design.md)").argument("[brand-id]","Brand ID (defaults to this workspace's brand)").argument("[tokens...]","Token assignments, e.g. color.primary=#114b97 typography.h1.size=32px").option("--design-md <path>","Apply a whole design.md file instead").option("--no-publish","Stage the change without publishing a new active brand version").option("--team-id <id>","Workspace ID").option("--yes","Confirm writing brand data").action(async(e,t,n)=>{n.yes||(a("Pass --yes to confirm writing brand tokens."),process.exit(s.INVALID_INPUT));let{assignments:r,brandId:o}=mb(e,t),i;try{i=r.length>0?cb(r):void 0}catch(d){a(d instanceof Error?d.message:"Invalid token pair"),process.exit(s.INVALID_INPUT)}let c;if(n.designMd)try{c=await ib(n.designMd,"utf8")}catch(d){a(`Could not read ${n.designMd}: ${d instanceof Error?d.message:String(d)}`),process.exit(s.INVALID_INPUT)}!i&&!c&&(a("Nothing to write. Pass token assignments (color.primary=#114b97) or --design-md <file>."),process.exit(s.INVALID_INPUT));try{l(await m("updateBrandTokens",{brandId:o,designMd:c,publish:n.publish===!1?!1:void 0,teamId:n.teamId,tokens:i},ab()))}catch(d){a(d instanceof Error?d.message:"Write failed"),process.exit(s.GENERAL_ERROR)}});import{createHash as ub}from"crypto";import{Command as lr}from"commander";var pb=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,cr=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function Ho(e){pb.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function jc(e){return ub("sha256").update(e).digest("hex").slice(0,32)}function Vc(e){if(cr.includes(e))return e;a(`"${e}" is not a channel. Pass one of: ${cr.join(", ")}.`),process.exit(s.INVALID_INPUT)}function dr(e){return e===""?null:e}function zo(e,t){if(t==="")return null;let n;try{n=JSON.parse(t)}catch(r){a(`${e} is not valid JSON: ${r instanceof Error?r.message:String(r)}`),process.exit(s.INVALID_INPUT)}return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${e} must be a JSON object.`),process.exit(s.INVALID_INPUT)),n}function gb(e,t){if(t==="true")return!0;if(t==="false")return!1;a(`${e} takes "true" or "false", not "${t}".`),process.exit(s.INVALID_INPUT)}function fb(e){if(e==="")return null;let t=Number(e);return Number.isInteger(t)||(a(`--max-seconds takes a whole number of seconds, not "${e}".`),process.exit(s.INVALID_INPUT)),t}var hb=new lr("list").description("List a brand's per-channel design variants").argument("<brand-id>","Brand profile ID").option("--channel <key>",`One of: ${cr.join(", ")}`).option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ho(e),t.channel!==void 0&&Vc(t.channel);try{l(await m("listBrandVariants",{brandId:e,channelKey:t.channel,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"List failed"),process.exit(s.GENERAL_ERROR)}}),yb=new lr("set").description("Create or update one per-channel brand design variant").argument("<brand-id>","Brand profile ID").option("--variant <slug>","Variant slug; omit to create one with a new slug").option("--channel <key>",`One of: ${cr.join(", ")}`).option("--name <name>","Display name for the variant").option("--default <true|false>","Make this the channel's default, or drop the role").option("--colors <json>",`Palette as JSON, e.g. '{"primary":"#155DAC","background":"#FFFFFF","text":"#111111"}'`).option("--logo-treatment <json>",'Logo backdrop as JSON; pass "" to clear').option("--background-gradient <json>",'Gradient document as JSON; pass "" to clear').option("--aspect <ratio>",'Aspect ratio, e.g. 16:9; pass "" to clear').option("--max-seconds <seconds>",'Longest runtime in seconds; pass "" to clear').option("--voice-tone <tone>",'Voice tone override; pass "" to clear').option("--opening-style <style>",'Opening style; pass "" to clear').option("--logo-position <position>",'Logo position; pass "" to clear').option("--constraints <text>",'Generator constraints; pass "" to clear').option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Ho(e),t.channel!==void 0&&Vc(t.channel);let n={brandId:e,teamId:t.teamId};t.variant!==void 0&&(n.variantId=t.variant),t.channel!==void 0&&(n.channelKey=t.channel),t.name!==void 0&&(n.name=t.name),t.default!==void 0&&(n.isDefault=gb("--default",t.default)),t.colors!==void 0&&(n.colors=zo("--colors",t.colors)),t.logoTreatment!==void 0&&(n.logoTreatment=zo("--logo-treatment",t.logoTreatment)),t.backgroundGradient!==void 0&&(n.backgroundGradient=zo("--background-gradient",t.backgroundGradient)),t.aspect!==void 0&&(n.aspect=dr(t.aspect)),t.maxSeconds!==void 0&&(n.maxSeconds=fb(t.maxSeconds)),t.voiceTone!==void 0&&(n.voiceOverride=t.voiceTone===""?null:{tone:t.voiceTone}),t.openingStyle!==void 0&&(n.openingStyle=dr(t.openingStyle)),t.logoPosition!==void 0&&(n.logoPosition=dr(t.logoPosition)),t.constraints!==void 0&&(n.constraints=dr(t.constraints));try{l(await m("setBrandVariant",n,t.variant===void 0?void 0:jc(`setBrandVariant:${e}:${t.variant}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(s.GENERAL_ERROR)}}),bb=new lr("delete").description("Remove one per-channel brand design variant").argument("<brand-id>","Brand profile ID").option("--variant <slug>","Variant slug to remove").option("--team-id <id>","Workspace ID").option("--yes","Skip the confirmation prompt").action(async(e,t)=>{await h(),Ho(e),t.variant===void 0&&(a("Pass --variant <slug> to name the variant to remove. `branding variant list <brand-id>` prints the slugs."),process.exit(s.INVALID_INPUT)),!t.yes&&process.stdin.isTTY&&(a(`Refusing to delete variant "${t.variant}" without confirmation. This delete is permanent \u2014 re-run with --yes.`),process.exit(s.GENERAL_ERROR));try{l(await m("deleteBrandVariant",{brandId:e,teamId:t.teamId,variantId:t.variant},jc(`deleteBrandVariant:${e}:${t.variant}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(s.GENERAL_ERROR)}}),Mc=new lr("variant").description("Per-channel brand design variant commands").addCommand(hb).addCommand(yb).addCommand(bb);import{createHash as wb}from"crypto";import{Command as Yo}from"commander";var vb=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Xo=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function Ib(e){vb.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function kb(e){if(Xo.includes(e))return e;a(`"${e}" is not a channel. Pass one of: ${Xo.join(", ")}.`),process.exit(s.INVALID_INPUT)}function xb(e,t){let n;try{n=JSON.parse(t)}catch(r){a(`${e} is not valid JSON: ${r instanceof Error?r.message:String(r)}`),process.exit(s.INVALID_INPUT)}return(typeof n!="object"||n===null||Array.isArray(n))&&(a(`${e} must be a JSON object.`),process.exit(s.INVALID_INPUT)),n}function Rb(e){return wb("sha256").update(e).digest("hex").slice(0,32)}var Cb=new Yo("generate").description("Generate a brand's per-channel design variants and gradients, replacing the channel's previous set").argument("[brand-id]","Brand profile ID; omit to generate a preview that is not saved").option("--channel <key>",`One of: ${Xo.join(", ")}`).option("--name <name>","Brand name to generate against").option("--description <text>","What the brand is, as generator context").option("--tone <tone>","Tone hint, e.g. 'warm, confident'").option("--style <style>","Visual style hint, e.g. 'editorial, high contrast'").option("--colors <json>",`Palette as JSON, e.g. '{"primary":"#155DAC","background":"#FFFFFF","text":"#111111"}'. Required when no brand id is given.`).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),e!==void 0&&Ib(e),t.channel!==void 0&&kb(t.channel);let n={teamId:t.teamId};e!==void 0&&(n.brandId=e),t.channel!==void 0&&(n.channelKey=t.channel),t.name!==void 0&&(n.brandName=t.name),t.description!==void 0&&(n.brandDescription=t.description),t.tone!==void 0&&(n.brandTone=t.tone),t.style!==void 0&&(n.brandStyle=t.style),t.colors!==void 0&&(n.sourceColors=xb("--colors",t.colors));try{let r=await m("generateBrandVariations",n,Rb(`generateBrandVariations:${e??"preview"}:${t.channel??"deck-16-9"}`));if(t.wait===!1){l(r);return}l(await bs(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(s.GENERAL_ERROR)}}),Sb=new Yo("status").description("Read a brand variations generation run").argument("<run-id>","Run ID from `branding variations generate --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("generateBrandVariations",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Bc=new Yo("variations").description("Generated brand design variations").addCommand(Cb).addCommand(Sb);import{createHash as Eb}from"crypto";import{Command as mr}from"commander";var Qo=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Zo(e){Qo.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function Tb(e,t){if(t==="head"||Qo.test(t))return t;a(`${e} must be a version id or "head".`),process.exit(s.INVALID_INPUT)}function $b(e,t){if(Qo.test(t))return t;a(`${e} must be a version id from \`branding version list\`.`),process.exit(s.INVALID_INPUT)}function Ab(e){return Eb("sha256").update(e).digest("hex").slice(0,32)}var Pb=new mr("list").description("List a brand's published versions, newest first").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Zo(e);try{l(await m("listBrandVersions",{brandId:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"List failed"),process.exit(s.GENERAL_ERROR)}}),Ob=new mr("diff").description("Compare two points in a brand's version history").argument("<brand-id>","Brand profile ID").option("--from <version-id>","Baseline version to compare against. Defaults to the brand's live version.").option("--to <version-id|head>","Version to compare. Defaults to head, the unpublished working draft.").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Zo(e);let n={brandId:e,teamId:t.teamId};t.from!==void 0&&(n.from=$b("--from",t.from)),t.to!==void 0&&(n.to=Tb("--to",t.to));try{l(await m("diffBrandVersions",n))}catch(r){a(r instanceof Error?r.message:"Diff failed"),process.exit(s.GENERAL_ERROR)}}),Db=new mr("publish").description("Publish the brand's working draft as a new live version").argument("<brand-id>","Brand profile ID").option("--label <text>","Short name for this version, unique within the brand (max 64 characters)").option("--notes <text>","What changed. Defaults to a changelog derived from the diff.").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Zo(e);let n={brandId:e,teamId:t.teamId};t.label!==void 0&&(n.label=t.label),t.notes!==void 0&&(n.notes=t.notes);try{l(await m("publishBrandVersion",n,Ab(`publishBrandVersion:${e}:${t.label??"auto"}`)))}catch(r){a(r instanceof Error?r.message:"Publish failed"),process.exit(s.GENERAL_ERROR)}}),Fc=new mr("version").description("Brand version history commands").addCommand(Pb).addCommand(Ob).addCommand(Db);import{createHash as Nb}from"crypto";import{Command as pn}from"commander";var Lb=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ti(e){Lb.test(e)||(a(`"${e}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(s.INVALID_INPUT))}function ei(e,t=[]){return[...t,e]}function Gc(e){return Nb("sha256").update(e).digest("hex").slice(0,32)}var Ub=new pn("get").description("Read a brand's Voice & Context document").argument("<brand-id>","Brand profile ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),ti(e);try{l(await m("getBrandVoice",{brandId:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Read failed"),process.exit(s.GENERAL_ERROR)}}),_b=new pn("set").description("Write a brand's Voice & Context document").argument("<brand-id>","Brand profile ID").option("--positioning <text>","Positioning and promise").option("--voice-tone <text>","How the brand sounds").option("--authoritative-facts <text>","Facts generated content must never contradict").option("--approved-language <text>","Wording the brand endorses").option("--guardrails <text>","What the brand must never say or do").option("--sources <json>",`Provenance as JSON, e.g. '[{"kind":"url","name":"About page"}]'. Omitting this clears the recorded provenance.`).option("--replace","Acknowledge that this replaces the WHOLE document: sections you omit are removed. Required when the payload would drop a section the brand has.").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),ti(e);let n={brandId:e,teamId:t.teamId};if(t.positioning!==void 0&&(n.positioning=t.positioning),t.voiceTone!==void 0&&(n.voiceTone=t.voiceTone),t.authoritativeFacts!==void 0&&(n.authoritativeFacts=t.authoritativeFacts),t.approvedLanguage!==void 0&&(n.approvedLanguage=t.approvedLanguage),t.guardrails!==void 0&&(n.guardrails=t.guardrails),t.replace===!0&&(n.replace=!0),t.sources!==void 0)try{n.sources=JSON.parse(t.sources)}catch{a("--sources must be valid JSON (an array of source objects)."),process.exit(s.INVALID_INPUT)}try{l(await m("setBrandVoice",n,Gc(`setBrandVoice:${e}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(s.GENERAL_ERROR)}}),qb=new pn("build").description("Draft a brand's Voice & Context document from source material").argument("<brand-id>","Brand profile ID").option("--url <url>","Page to read; repeat for several",ei).option("--text <text>","Pasted source material; repeat for several",ei).option("--file <name:source>","Document to read, as name:source; repeat for several",ei).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),ti(e);let n={brandId:e,teamId:t.teamId};t.url?.length&&(n.urls=t.url),t.text?.length&&(n.text=t.text),t.file?.length&&(n.files=t.file.map(r=>{let o=r.indexOf(":");return(o<=0||o===r.length-1)&&(a(`--file must be name:source; got "${r}".`),process.exit(s.INVALID_INPUT)),{name:r.slice(0,o),source:r.slice(o+1)}})),!t.url?.length&&!t.text?.length&&!t.file?.length&&(a("Pass at least one --url, --text or --file to draft from."),process.exit(s.INVALID_INPUT));try{let r=await m("buildBrandVoice",n,Gc(`buildBrandVoice:${JSON.stringify(n)}`));if(t.wait===!1){l(r);return}l(await vs(r.runId,t.teamId))}catch(r){a(r instanceof Error?r.message:"Build failed"),process.exit(s.GENERAL_ERROR)}}),jb=new pn("build-status").description("Read a brand voice build run").argument("<run-id>","Run ID from `branding voice build --no-wait`").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await I("buildBrandVoice",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Kc=new pn("voice").description("Brand voice and context commands").addCommand(Ub).addCommand(_b).addCommand(qb).addCommand(jb);function Gb(e){return t=>{let n=Number(t);if(!Number.isInteger(n)||n<0)throw new Wc(`${e} expects a whole number of 0 or more.`);return n}}function Kb(e){return t=>{let n=Number(t);if(!Number.isInteger(n)||n<1)throw new Wc(`${e} expects a whole number of 1+.`);return n}}var Wb=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Jb=50;function zb(e){let t=e.extractedFrom??e.normalizedUrl??null,n=Jo(e),r=$c(e),o=Wo(e);if(ve("Brand Profile"),console.log(),C("ID",e.id),C("Name",e.name),C("Source URL",t??F.gray("None")),C("Default",e.isDefault?F.green("Yes"):"No"),e.createdAt&&C("Created",new Date(e.createdAt).toLocaleString()),console.log(),n||r.length>0){if(console.log(F.bold(" Colors")),n&&console.log(` Primary: ${F.bgHex(n)(" ")} ${n}`),r.length>0){console.log(" Palette:");for(let w of r.slice(0,10)){let v=w.role?F.gray(` (${w.role})`):"";console.log(` ${F.bgHex(w.hex)(" ")} ${w.hex}${v}`)}}console.log()}o&&(console.log(F.bold(" Logo")),console.log(` ${o}`),console.log());let i=e.brandData?.typography,c=e.resolvedTokens?.headingFont??i?.primary??i?.headings,d=e.resolvedTokens?.bodyFont??i?.secondary??i?.body;(c||d)&&(console.log(F.bold(" Typography")),console.log(` Headings: ${c??"-"}`),console.log(` Body: ${d??"-"}`),console.log());let u=e.brandData?.confidence,g=e.brandData?.extractionMethod;(typeof u=="number"||typeof g=="string")&&(console.log(F.bold(" Extraction")),typeof u=="number"&&console.log(` Confidence: ${Math.round(u*100)}%`),typeof g=="string"&&console.log(` Method: ${g}`),console.log()),console.log(F.gray(" Use --format json for full details")),console.log()}var Jc=new Pt("branding").description("Read and manage workspace brands, design rules, assets, permissions, and social presence").addCommand(_c).addCommand(qc).addCommand(Bd).addCommand(Gd).addCommand(yc).addCommand(bc).addCommand(rc).addCommand(new Pt("list").description("List accessible brands as a table or paged JSON").option("--search <text>","Filter by brand name or website/domain; an exact brand id also matches").option("--filter <filter>","Which slice to return (all, mine, team)",y("--filter",["all","mine","team"])).option("--sort <sort>","Sort key (created, name, updated)",y("--sort",["created","name","updated"])).option("--shape <shape>","Result shape: list (paged rows, default) or chat (compact matches)",y("--shape",["chat","list"])).option("--limit <n>","Page size (server default: 12 for the list shape, 50 for chat)",Kb("--limit")).option("--offset <n>","Brands to skip before the page",Gb("--offset")).option("--team-id <id>","Workspace ID").option("--json","Print the complete JSON response instead of a table").action(async e=>{await h();try{let t=e.shape??"list",n=await m("listBrandings",{filter:e.filter,limit:e.limit,offset:e.offset,search:e.search,shape:t,sort:e.sort,teamId:e.teamId});if(e.json){l(n);return}let r=Ac(n);if(r.length===0){b("No brand profiles found"),console.log(),console.log(F.gray(`Create one with: ${p.commands[0]} branding extract <url>`));return}console.log(xa(r));let o=e.offset??0;Ko(n)?n.hasMore&&console.log(F.gray(` ${o+r.length} of ${n.total}. Next page: --offset ${o+r.length}`)):r.length>=(e.limit??Jb)&&console.log(F.gray(` Showing ${r.length} from --offset ${o}; there may be more. Next page: --offset ${o+r.length}`))}catch(t){a(t instanceof Error?t.message:String(t)),process.exit(t.exitCode??1)}})).addCommand(new Pt("get").description("Read one brand as a summary or complete JSON").argument("<id>","Brand profile ID").option("-f, --format <format>","Output format (summary, json)",y("--format",["summary","json"]),"summary").option("-o, --output <path>","Save JSON to file").option("--team-id <id>","Workspace ID").action(async(e,t)=>{if(await h(),!Wb.test(e)){a(`"${e}" is not a brand id. Pass the UUID from \`${p.commands[0]} branding list\`, or search by name with \`${p.commands[0]} branding find <query>\`.`),process.exit(s.INVALID_INPUT);return}try{let r=(await m("listBrandings",{limit:1,search:e,shape:"list",teamId:t.teamId})).items?.[0];if(!r){a(`No brand profile with id ${e} is accessible.`),process.exit(s.NOT_FOUND);return}if(t.output){await Bb(t.output,JSON.stringify(r,null,2)),k(`Brand profile saved to ${t.output}`);return}if(t.format==="json"){console.log(JSON.stringify(r,null,2));return}zb(r)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}})).addCommand(new Pt("find").description("Print matching brand IDs for an exact name, domain, or website URL").argument("<query>","Brand name or website URL to search for").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{let r=(await m("listBrandings",{search:e,shape:"chat",teamId:t.teamId})).brandings;if(r.length===0){b(`No brand profiles matching "${e}"`),console.log(F.gray(` Extract one with: ${p.commands[0]} branding extract <url>`));return}console.log(`Found ${r.length} brand${r.length>1?"s":""}:
|
|
73
|
+
`);for(let o of r){let i=o.primaryColor?`${F.bgHex(o.primaryColor)(" ")} ${o.primaryColor}`:"";console.log(` ${F.bold(o.name)} ${F.gray(o.id)}`),o.domain&&console.log(` ${F.gray(o.domain)}`),i&&console.log(` ${i}`),console.log()}console.log(F.gray(` Export with: ${p.commands[0]} branding get <id> -o branding.json`))}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}})).addCommand(new Pt("extract").description("Start paid website extraction and print a run ID for `branding status`").argument("<url>","Website URL to extract branding from").option("--team-id <id>","Workspace ID; defaults to your configured workspace").option("--yes","Confirm you intend to start a paid extraction. Intent only: approval still requires --approval-receipt").option("--approval-receipt <receipt>","Receipt from the browser confirmation URL; omit on the first call to be given that URL").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin so it is not exposed in process arguments").option("--idempotency-key <key>","Stable key bound into the approval receipt; pass the same one when retrying with the receipt").option("--skip-existing-lookup","Extract this exact URL even when the workspace already has related brands").action(async(e,t)=>{await h(),t.yes||(a("Pass --yes to confirm brand extraction."),process.exit(s.INVALID_INPUT));try{new URL(e.startsWith("http")?e:`https://${e}`)}catch{a("Invalid URL format"),process.exit(6)}let n=e.startsWith("http")?e:`https://${e}`,r=t.teamId??te(),o=t.idempotencyKey??Vb();t.approvalReceipt&&t.approvalReceiptStdin&&(a("Pass only one approval receipt input mode."),process.exit(s.INVALID_INPUT));let i=t.approvalReceiptStdin?Mb(0,"utf8").trim():t.approvalReceipt;t.approvalReceiptStdin&&!i&&(a("No approval receipt was provided on stdin."),process.exit(s.INVALID_INPUT));let c=Fb({text:`Extracting branding from ${n}...`,stream:process.stdout}).start(),d;try{let u=await Ha(n,r,i,t.skipExistingLookup,o);if(u.status==="needs_choice"){c.stop(),b(`This workspace already has ${u.matches.length} related brand${u.matches.length===1?"":"s"} for ${n}. Nothing was extracted and nothing was charged.`),console.log();for(let g of u.matches)console.log(` ${F.bold(g.name??"Untitled")}`),console.log(` ${F.gray(g.id)}`),g.extractedFrom&&console.log(` ${F.gray(g.extractedFrom)}`);console.log(),b(`Use one of the above, or re-run with --skip-existing-lookup to extract ${n} anyway.`),d=s.INVALID_INPUT}else c.succeed("Brand extraction started"),console.log(JSON.stringify(u,null,2)),b(`Check progress with: ${p.commands[0]} branding status ${u.runId}`),console.log()}catch(u){let g=u instanceof Error?u.message:String(u);g.includes("approval")&&(c.stop(),a(g),console.log(),b(`Retry with the receipt and the same key: --approval-receipt <receipt> --idempotency-key ${o}`),process.exit(s.INVALID_INPUT)),c.fail("Extraction failed"),a(g),process.exit(u.exitCode??1)}d!==void 0&&process.exit(d)})).addCommand(new Pt("status").description("Print a brand extraction run's current state, error, or result").argument("<run-id>","Run ID returned by branding extract").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await I("extractBranding",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}})).addCommand(oc).addCommand(ec).addCommand(sc).addCommand(ic).addCommand(dc).addCommand(cc).addCommand(lc).addCommand(ac).addCommand(Pc).addCommand(mc).addCommand(Wd).addCommand(Jd).addCommand(Xd).addCommand(Sc).addCommand(Mc).addCommand(Bc).addCommand(Fc).addCommand(Kc).addCommand(Qd).addCommand(Tc).addCommand(wc).addCommand(vc).addCommand(Nc).addCommand(Lc).addCommand(Ic).addCommand(Oc);import gn from"chalk";import{Command as Ot}from"commander";function Hb(e){switch(e.background){case"color":{if(!e.backgroundColor)throw new Error("--background color needs --background-color <hex>, e.g. #1d4ed8");return{hex:e.backgroundColor,kind:"color"}}case"image":{if(!e.backgroundImage)throw new Error("--background image needs --background-image <url>");return{fit:e.fit,kind:"image",url:e.backgroundImage}}default:return{kind:e.background}}}function zc(e,t){return{background:Hb(t),name:e,presenterProfileId:t.presenter,...t.voiceId?{voiceId:t.voiceId}:{}}}function ur(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.id);return}k(`${e.name} (${e.id})`),b(` Presenter: ${e.presenterProfileId}`),b(` Backdrop: ${Xb(e.background)}`),e.voiceId&&b(` Voice: ${e.voiceId}`)}function Xb(e){switch(e.kind){case"color":return`color ${e.hex}`;case"image":return`image ${e.url} (${e.fit})`;default:return e.kind}}function Hc(e){return e.requiredOption("--presenter <profileId>",`Trained personal presenter id (pp_*), from \`${p.commands[0]} avatar options\``).option("--background <kind>","Backdrop: original, transparent, color, or image","original").option("--background-color <hex>","Backdrop color, e.g. #1d4ed8").option("--background-image <url>","Backdrop image URL").option("--fit <fit>","How an image backdrop fills the frame","cover").option("--voice-id <voiceId>","Workspace voice to save with this preset").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human")}var Yb=new Ot("list").description("List saved cast presets you can use").option("--cast-member-id <castMemberId>","Only this person's presets").option("--branding-id <brandingId>","Narrow to one brand").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{try{let t=await Ps({...e.brandingId?{brandingId:e.brandingId}:{},...e.castMemberId?{castMemberId:e.castMemberId}:{},...e.teamId?{teamId:e.teamId}:{}});if(e.format==="json"){l(t);return}if(e.format==="quiet"){for(let n of t.presets)console.log(n.id);return}if(t.presets.length===0){b("No presets saved yet.");return}for(let n of t.presets)ur(n,"human")}catch(t){a(t instanceof Error?t.message:String(t)),process.exit(s.API_ERROR)}}),Qb=Hc(new Ot("create").description("Save one way a cast member appears").argument("<name>",'What to call this preset, e.g. "In the cafe"').requiredOption("--cast-member-id <castMemberId>","The person this preset is a way of showing")).action(async(e,t)=>{try{let n=await Os({castMemberId:t.castMemberId,...zc(e,t),...t.teamId?{teamId:t.teamId}:{}});ur(n.preset,t.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.API_ERROR)}}),Zb=Hc(new Ot("update").description("Change a saved preset (sends the complete preset)").argument("<preset-id>","The preset to change").requiredOption("--name <name>","What to call it")).action(async(e,t)=>{try{let n=await Ds({presetId:e,...zc(t.name,t),...t.teamId?{teamId:t.teamId}:{}});ur(n.preset,t.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.API_ERROR)}}),ew=new Ot("delete").description("Retire a saved preset. Existing videos keep working.").argument("<preset-id>","The preset to retire").option("--team-id <id>","Workspace ID; defaults to the selected workspace").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await Ns(e,t.teamId);if(t.format==="human"){k(`Retired "${n.preset.name}".`);return}ur(n.preset,t.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.API_ERROR)}}),tw=new Ot("preset").description("Saved ways a cast member appears").addCommand(Yb).addCommand(Qb).addCommand(Zb).addCommand(ew),ni=new Ot("cast").description("The faces and voices your videos can use").addCommand(tw);ni.addHelpText("after",`
|
|
74
|
+
${gn.bold("Examples:")}
|
|
75
|
+
${gn.gray("# List the saved presenter/backdrop/voice combinations")}
|
|
76
|
+
$ ${p.commands[0]} cast preset list
|
|
77
|
+
|
|
78
|
+
${gn.bold("See also:")}
|
|
79
|
+
${gn.gray("# The presenter avatars, looks, and voices a preset is built from")}
|
|
80
|
+
$ ${p.commands[0]} avatar options
|
|
81
|
+
|
|
82
|
+
${gn.gray("# Use a preset on one presentation-video scene")}
|
|
83
|
+
$ ${p.commands[0]} presentation video presenter <project-id>
|
|
84
|
+
`);import ye from"chalk";import{Command as st}from"commander";var Xc=["male","female"],Yc=["young","middle_aged","old"];function ri(e){let t=[e.gender,e.age,e.accent,e.useCase].filter(Boolean).join(" \xB7 "),n=e.description?ye.gray(` \u2014 ${e.description}`):"",r=e.ready?"":ye.yellow(" (not ready)");return`${ye.bold(e.name)}${r} ${ye.gray(e.id)}
|
|
85
|
+
${t||ye.gray("no stated labels")}${n}`}var nw=new st("list").description("The voices this workspace can narrate with").option("--gender <gender>","male or female",y("--gender",Xc)).option("--age <age>","young, middle_aged or old",y("--age",Yc)).option("--accent <accent>",'Stated accent, e.g. "american"').option("--use-case <useCase>",'Stated use case, e.g. "conversational"').option("--query <text>","Match the name or the character note").option("--language <language>",'Language code, e.g. "en" or "hi"').option("--page <n>","Which page of the shared library to read").option("--page-size <n>","How many library voices per page (max 100)").option("--format <format>","text or json","text").action(async e=>{try{let t=await Cs({...e.accent?{accent:e.accent}:{},...e.age?{age:e.age}:{},...e.gender?{gender:e.gender}:{},...e.language?{language:e.language}:{},...e.page?{page:Number(e.page)}:{},...e.pageSize?{pageSize:Number(e.pageSize)}:{},...e.query?{query:e.query}:{},...e.useCase?{useCase:e.useCase}:{}});if(e.format==="json"){l(t);return}if(t.catalogUnavailable&&b("Built-in voices are temporarily unavailable; showing yours only."),t.voices.length===0){b("No voices match those filters.");return}for(let n of t.voices)console.log(ri(n));if(t.library.length>0){b(t.curated?`From the shared library \u2014 ${t.totalMatching} more behind these:`:`From the shared library \u2014 ${t.totalMatching} match:`);for(let n of t.library)console.log(ri(n));b(`Add one with ${p.commands[0]} voice add <voice-id>`)}t.libraryUnavailable&&b("The shared library could not be searched; showing yours only."),t.canDesignVoice&&b(`Nothing fits? ${p.commands[0]} voice design "<description>"`)}catch(t){a(t instanceof Error?t.message:String(t)),process.exit(s.GENERAL_ERROR)}}),rw=new st("design").description("Generate candidate voices from a written description").argument("<description>","The voice in words").option("--text <text>","What the candidates should say (100-1000 chars)").option("--include-audio","Return the candidate audio inline; large, so off by default").option("--remix-of <candidateId>","Vary a candidate from an earlier round").option("--round-id <id>","Your own id, so retrying it is not charged twice").option("--seed <n>","Make the round reproducible").option("--format <format>","text or json","text").action(async(e,t)=>{try{let n=await Ts({description:e,...t.includeAudio?{includeAudio:!0}:{},...t.remixOf?{remixOf:t.remixOf}:{},...t.roundId?{roundId:t.roundId}:{},...t.seed?{seed:Number(t.seed)}:{},...t.text?{text:t.text}:{}});if(t.format==="json"){l(n);return}k(`${n.candidates.length} candidates \xB7 ${n.creditsCharged} credits`);for(let r of n.candidates){let o=r.durationSeconds?` (${r.durationSeconds.toFixed(1)}s)`:"";console.log(` ${ye.gray(r.id)}${o}`)}b(t.includeAudio?"Audio is in --format json. Keep one with:":"Add --include-audio --format json to hear them. Keep one with:"),b(` ${p.commands[0]} voice save <candidate-id> --name "<name>" --description "${e.slice(0,40)}\u2026"`)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.GENERAL_ERROR)}}),ow=new st("save").description("Keep a candidate as a reusable workspace voice").argument("<candidate-id>","A candidate handle from voice design").requiredOption("--name <name>","What the workspace will call it").requiredOption("--description <text>","The description that produced it").option("--gender <gender>","male or female",y("--gender",Xc)).option("--age <age>","young, middle_aged or old",y("--age",Yc)).option("--accent <accent>",'e.g. "american"').option("--use-case <useCase>",'e.g. "conversational"').option("--passed-over <ids>","Comma-separated candidates you auditioned and did not keep").option("--format <format>","text or json","text").action(async(e,t)=>{try{let n={...t.accent?{accent:t.accent}:{},...t.age?{age:t.age}:{},...t.gender?{gender:t.gender}:{},...t.useCase?{useCase:t.useCase}:{}},r=await $s({candidateId:e,description:t.description,...n,name:t.name,...t.passedOver?{passedOver:t.passedOver.split(",").map(o=>o.trim()).filter(Boolean)}:{}});if(t.format==="json"){l(r);return}k(`Saved ${r.voice.name}`),console.log(ri(r.voice)),Object.keys(n).length||b("No labels given, so this voice matches no gender/age/accent filter.")}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.GENERAL_ERROR)}}),iw=new st("remove").description("Remove one of your own voices and release the slot it holds").argument("<voice-id>","A workspace voice id from voice list").option("--format <format>","text or json","text").action(async(e,t)=>{try{let n=await As({voiceId:e});if(t.format==="json"){l(n);return}k("Voice removed."),n.heldProviderSlot&&!n.providerSlotReleased&&b("The voice slot was not released and is still held.")}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.GENERAL_ERROR)}}),aw=new st("add").description("Add a voice from the shared library to this workspace").argument("<voice-id>","A library voice handle from voice list").option("--name <name>","What this workspace will call it").option("--format <format>","text or json","text").action(async(e,t)=>{try{let n=await Ss({...t.name?{name:t.name}:{},voiceId:e});if(t.format==="json"){l(n);return}k(`${n.voice.name} is now one of your voices.`),b(` ${ye.gray(n.voice.id)}`),b(`Use it with ${p.commands[0]} presentation video narration <project-id>`)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.GENERAL_ERROR)}}),sw=new st("star").description("Keep a voice at the top of your list, or remove the star").argument("<voice-id>","A workspace voice id, or a library handle").option("--favorite <favorite>","true to star, false to unstar",y("--favorite",["true","false"]),"true").option("--format <format>","text or json","text").action(async(e,t)=>{try{let n=t.favorite==="true",r=await Es({favorite:n,voiceId:e});if(t.format==="json"){l(r);return}k(n?`${r.voice.name} is starred.`:`${r.voice.name} is no longer starred.`)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(s.GENERAL_ERROR)}}),oi=new st("voice").description("The voices your narration can use").addCommand(nw).addCommand(rw).addCommand(ow).addCommand(aw).addCommand(sw).addCommand(iw);oi.addHelpText("after",`
|
|
86
|
+
${ye.bold("Examples:")}
|
|
87
|
+
${ye.gray("# The request a fixed catalog cannot answer")}
|
|
88
|
+
$ ${p.commands[0]} voice list --gender male --age middle_aged --accent american --use-case conversational
|
|
89
|
+
|
|
90
|
+
${ye.gray("# Or describe one that does not exist yet, then keep it")}
|
|
91
|
+
$ ${p.commands[0]} voice design "Native American English. Male, early thirties. Calm, confident, conversational; medium-low pitch, moderate pace."
|
|
92
|
+
$ ${p.commands[0]} voice save <candidate-id> --name "Floor lead" --description "\u2026" --gender male --age middle_aged
|
|
93
|
+
|
|
94
|
+
${ye.bold("See also:")}
|
|
95
|
+
${ye.gray("# Narrate a presentation video with the voice you chose")}
|
|
96
|
+
$ ${p.commands[0]} presentation video narration <project-id>
|
|
97
|
+
`);import{randomUUID as dw}from"crypto";import{readFile as cw}from"fs/promises";import fn from"chalk";import{Command as Qc}from"commander";var lw=new Qc("extract").description("Extract normalized text from a URL or local file").argument("<source>","URL, encoded source, or local file path").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--filename <name>","Source filename metadata").option("--mime-type <type>","Source MIME type").option("--max-length <count>","Maximum output characters","30000").option("--reason <text>","Reason for this extraction").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=e,r;e.includes("://")||(n=await cw(e,"utf8"),r=e);let o=await m("extractContent",{filename:t.filename??r,maxLength:Number.parseInt(t.maxLength,10),mimeType:t.mimeType,reason:t.reason,source:n,teamId:t.teamId},t.idempotencyKey??dw());t.format!=="quiet"&&l(o)}catch(n){a(n instanceof Error?n.message:"Extraction failed"),process.exit(s.GENERAL_ERROR)}}),ii=new Qc("content").description("Extract normalized text from a URL, a local file, or an encoded document").addCommand(lw);ii.addHelpText("after",`
|
|
98
|
+
${fn.bold("Examples:")}
|
|
99
|
+
${fn.gray("# Normalized text from a local document")}
|
|
100
|
+
$ ${p.commands[0]} content extract ./paper.pdf
|
|
101
|
+
|
|
102
|
+
${fn.bold("See also:")}
|
|
103
|
+
${fn.gray("# Web pages, with page metadata and cost reporting")}
|
|
104
|
+
$ ${p.commands[0]} scrape https://example.com/post
|
|
105
|
+
|
|
106
|
+
${fn.gray("# Spoken words out of audio or video")}
|
|
107
|
+
$ ${p.commands[0]} transcript --help
|
|
108
|
+
`);import Z from"chalk";import{Command as mw}from"commander";import{existsSync as uw,readFileSync as pw}from"fs";import gw,{resolve as Zc}from"path";function ai(e,t){if(t)try{let n=JSON.parse(t);if(!n||typeof n!="object"||Array.isArray(n))throw new Error("expected an object");return n}catch(n){throw new Error(`${e} must be a valid JSON object.`,{cause:n})}}function fw(e,t,n){if(e!=="as-is"||t)return t;let r=n.filter(o=>o.name.toLowerCase().endsWith(".pptx"));if(r.length!==1)throw new Error("--source-mode as-is requires exactly one uploaded .pptx file (or --source-presentation JSON).");return{filename:r[0].name,sourceUrl:r[0].url}}var el=new mw("create").description("Create a new presentation").argument("<topic>","The topic or title for the presentation").option("-n, --slides <count>","Number of slides (1-20)").option("-m, --mode <mode>","Generation quality (best, balanced, fast, ultrafast, instant, image-min, image, image-max) \u2014 default: fast. image-min/image/image-max render each slide as a full-bleed AI image (text not editable); slower + pricier, require image-mode access, and cap at 25 slides. image-min is cheapest (brand colors only, no exact fonts).").option("--image-tier <tier>","Embedded-image quality for HTML modes. Each tier is a per-image credit ceiling as well as its price: quick (+20/slide), smart (default, +60/slide), balanced (+250/slide), best (+500/slide, slow). Ignored for image-*/instant modes.").option("-t, --tone <tone>","Tone (creative, professional, educational, formal, casual)").option("--amount <amount>","Content density (minimal, concise, detailed, extensive)").option("--audience <text>","Target audience description").option("--additional-context <text>","Additional generation instructions").option("--conversation-context <text>","Prior conversation context").option("-l, --language <lang>","Output language").option("--branding-id <id>","Branding ID (from `ccr branding list` or `ccr branding extract`)").option("--brand-domain <url>","Brand the deck by website/domain (e.g. https://www.pfizer.com). Errors if no matching saved brand exists.").option("--brand-enforcement <json>","Brand enforcement JSON object").option("--brand-variant-id <id>","Saved brand variant ID").option("--design-brand-reference <text>","Design brand reference").option("--family <family>","Layout family (minimal, editorial, bold, dashboard)",y("--family",["minimal","editorial","bold","dashboard"])).option("--generation-request-id <id>","Generation funnel correlation ID").option("--image-policy <policy>","Image policy (auto, none)",y("--image-policy",["auto","none"])).option("--content-sources <json>","Canonical content-sources JSON object").option("--source-mode <mode>","Attached deck mode (reference, as-is)",y("--source-mode",["reference","as-is"])).option("--source-presentation <json>","Attached PowerPoint JSON object with filename and sourceUrl").option("--widget-session-id <id>","Stable widget session ID").option("--template <id>","Slide template ID to style the deck after (from `ccr templates`). A default template is applied automatically when omitted.").option("-c, --context <text>","Inline text context (research notes, key facts)").option("--context-file <path>","Path to a context file (text, markdown, JSON)").option("--stdin","Read context from stdin").option("-f, --file <paths...>","Files to upload (PDF, PPTX, DOCX, images)").option("-g, --goal <type>","Goal (inform, persuade, train, learn, entertain, report)").option("--styling <mode>","Styling mode (freeform, brand-only, brand-plus-style, style-only, no-styling)").option("--reference-url <url>","Image URL to use as visual style reference").option("--thinking-depth <depth>","AI thinking depth (quick, moderate, deep, profound)").option("--theme <preset>","[instant mode only] Color theme preset (blue, violet, rose, orange, green)").option("--primary-color <hex>","[instant mode only] Primary color (e.g., #0066CC)").option("--secondary-color <hex>","[instant mode only] Secondary color").option("--accent-color <hex>","[instant mode only] Accent color").option("--background-color <hex>","[instant mode only] Background color").option("--foreground-color <hex>","[instant mode only] Foreground/text color").option("--decorations <style>","[instant mode only] Background decoration (none, waves-bottom-left, waves-top-right, blob-corners, minimal)").option("--team-id <id>","Team ID (switch teams)").option("--format <format>","Output format (human, json, quiet)",y("--format",["human","json","quiet"])).option("-o, --output <format>","Output format (human, json, quiet) \u2014 short form of --format",y("--output",["human","json","quiet"])).option("--no-stream","Wait for completion without streaming progress").option("--wait","Poll until generation completes").option("--idempotency-key <key>","Stable retry key").option("--approval-receipt <receipt>","Server-issued approval receipt for this exact generation request").option("--debug","Enable debug logging").option("--open","Open in browser after creation").option("--id <uuid>","Use a specific UUID for the presentation").option("--studio","Studio mode: use current directory name as presentation ID (auto-links to Studio preview)").action(async(e,t)=>{t.output=t.format??t.output,await h();let n=t.idempotencyKey??z({command:"presentation:create",payload:{...t,approvalReceipt:void 0,idempotencyKey:void 0,topic:e},workspaceId:t.teamId??"configured-default"}),r;t.slides!==void 0&&(r=parseInt(t.slides,10),(Number.isNaN(r)||r<1||r>20)&&(a("Slide count must be between 1 and 20"),process.exit(6)));let o=["best","balanced","fast","ultrafast","instant","image-min","image","image-max"];t.mode&&!o.includes(t.mode)&&(a(`Invalid mode: ${t.mode}. Valid: ${o.join(", ")}`),process.exit(6));let i=["smart","fast","balanced","best"];t.imageTier&&!i.includes(t.imageTier)&&(a(`Invalid image tier: ${t.imageTier}. Valid: ${i.join(", ")}`),process.exit(6));let c=["creative","professional","educational","formal","casual"];t.tone&&!c.includes(t.tone)&&(a(`Invalid tone: ${t.tone}. Valid: ${c.join(", ")}`),process.exit(6));let d=["minimal","concise","detailed","extensive"];t.amount&&!d.includes(t.amount)&&(a(`Invalid amount: ${t.amount}. Valid: ${d.join(", ")}`),process.exit(6));let u=["freeform","brand-only","brand-plus-style","style-only","no-styling"];t.styling&&!u.includes(t.styling)&&(a(`Invalid styling: ${t.styling}. Valid: ${u.join(", ")}`),process.exit(6));let g=["quick","moderate","deep","profound"];t.thinkingDepth&&!g.includes(t.thinkingDepth)&&(a(`Invalid thinking-depth: ${t.thinkingDepth}. Valid: ${g.join(", ")}`),process.exit(6));let w=["inform","persuade","train","learn","entertain","report"];t.goal&&!w.includes(t.goal)&&(a(`Invalid goal: ${t.goal}. Valid: ${w.join(", ")}`),process.exit(6));let v=["blue","violet","rose","orange","green"];t.theme&&!v.includes(t.theme)&&(a(`Invalid theme: ${t.theme}. Valid: ${v.join(", ")}`),process.exit(6));let x=["none","waves-bottom-left","waves-top-right","blob-corners","minimal"];t.decorations&&!x.includes(t.decorations)&&(a(`Invalid decorations: ${t.decorations}. Valid: ${x.join(", ")}`),process.exit(6));let T=t.theme||t.primaryColor||t.secondaryColor||t.accentColor||t.backgroundColor||t.foregroundColor||t.decorations;T&&t.mode&&t.mode!=="instant"&&(a("--theme, --primary-color, --decorations and other color options are only supported with --mode instant"),process.exit(6));let A=t.mode??(T?"instant":"fast"),S=/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;for(let[P,be]of[["primary-color",t.primaryColor],["secondary-color",t.secondaryColor],["accent-color",t.accentColor],["background-color",t.backgroundColor],["foreground-color",t.foregroundColor]])be&&!S.test(be)&&(a(`Invalid ${P}: ${be}. Must be hex (e.g., #0066CC)`),process.exit(6));try{t.output!=="json"&&t.output!=="quiet"&&process.stdout.write(Z.gray("Checking generation limits... "));let P=await Qa(A,r??10,t.teamId);if(t.output!=="json"&&t.output!=="quiet"){console.log(Z.green("\u2713"));let be=P.remaining[A],me=P.limits[A],we=be===void 0||me===void 0?"":` | ${A}: ${be}/${me} remaining`;console.log(Z.gray(` Plan: ${P.planName}${we}`))}}catch(P){t.output==="json"?console.log(JSON.stringify({success:!1,error:P instanceof Error?P.message:String(P)})):(console.log(Z.red("\u2717")),a(P instanceof Error?P.message:String(P))),process.exit(P.exitCode??1)}let $=[];if(t.file&&t.file.length>0){for(let P of t.file)uw(Zc(P))||(a(`File not found: ${P}`),process.exit(6));t.output!=="json"&&t.output!=="quiet"&&console.log(Z.gray(`
|
|
109
|
+
Uploading ${t.file.length} file(s)...`));try{$=await ja(t.file.map(P=>Zc(P)),(P,be,me)=>{t.output!=="json"&&t.output!=="quiet"&&me&&process.stdout.write(`\r ${Z.cyan("\u2B06")} Uploading: ${me} (${P+1}/${be})`)},{idempotencyKey:n}),t.output!=="json"&&t.output!=="quiet"&&console.log(`\r ${Z.green("\u2713")} Uploaded ${$.length} file(s) `)}catch(P){a(`Failed to upload files: ${P instanceof Error?P.message:String(P)}`),process.exit(1)}}let E;(t.stdin||!process.stdin.isTTY)&&(E=await hw(),t.stdin&&!E&&(a("No content received from stdin"),process.exit(6)));let M=t.context;if(t.contextFile)try{M=pw(t.contextFile,"utf-8"),M.trim()||(a(`Context file is empty: ${t.contextFile}`),process.exit(6))}catch{a(`Failed to read context file: ${t.contextFile}`),process.exit(6)}!E&&!M&&!t.additionalContext&&!t.contentSources&&!t.sourcePresentation&&$.length===0&&(a("Context is required to create a presentation."),console.log(),console.log(Z.gray(" -f, --file <paths...> Upload files (PDF, PPTX, images)")),console.log(Z.gray(" -c, --context <text> Inline text context")),console.log(Z.gray(" --context-file <path> Read from a file")),console.log(Z.gray(` cat file | ${p.commands[0]} Pipe content`)),process.exit(6));let N=[...$];E&&N.push({id:`stdin-${n}`,content:E,title:"Piped Content",mime:"text/plain",selected:!0}),M&&N.push({id:`context-${n}`,content:M,title:"Context",mime:"text/plain",selected:!0});let O,Y=t.primaryColor||t.secondaryColor||t.accentColor||t.backgroundColor||t.foregroundColor;(t.theme||Y||t.decorations)&&(O={},t.theme&&(O.preset=t.theme),Y&&(O.custom={},t.primaryColor&&(O.custom.primary=t.primaryColor),t.secondaryColor&&(O.custom.secondary=t.secondaryColor),t.accentColor&&(O.custom.accent=t.accentColor),t.backgroundColor&&(O.custom.background=t.backgroundColor),t.foregroundColor&&(O.custom.foreground=t.foregroundColor)),t.decorations&&(O.decorations=t.decorations));try{let P=ai("--content-sources",t.contentSources),be=fw(t.sourceMode,ai("--source-presentation",t.sourcePresentation),$),me=await Va({topic:e,...t.additionalContext&&{additionalContext:t.additionalContext},...r!==void 0&&{slideCount:r},mode:A,...t.imageTier&&{imageTier:t.imageTier},...t.tone&&{tone:t.tone},...t.amount&&{amount:t.amount},...t.audience&&{audience:t.audience},...t.language&&{language:t.language},...t.brandingId&&{brandingId:t.brandingId},...t.brandDomain&&{brandDomain:t.brandDomain},...t.brandEnforcement&&{brandEnforcement:ai("--brand-enforcement",t.brandEnforcement)},...t.brandVariantId&&{brandVariantId:t.brandVariantId},...t.conversationContext&&{conversationContext:t.conversationContext},...t.designBrandReference&&{designBrandReference:t.designBrandReference},...t.family&&{family:t.family},...t.generationRequestId&&{generationRequestId:t.generationRequestId},...t.imagePolicy&&{imagePolicy:t.imagePolicy},...t.template&&{templateId:t.template},...t.styling&&{stylingMode:t.styling},...t.referenceUrl&&{referenceUrl:t.referenceUrl},...t.thinkingDepth&&{thinkingDepth:t.thinkingDepth},...t.goal&&{goal:t.goal},...t.teamId&&{teamId:t.teamId},...t.sourceMode&&{sourceMode:t.sourceMode},...be&&{sourcePresentation:be},...t.widgetSessionId&&{widgetSessionId:t.widgetSessionId},...O&&{theme:O},...t.studio?{documentId:gw.basename(process.cwd())}:t.id?{documentId:t.id}:{},...P?{contentSources:P}:N.length>0&&{contentSources:{uploadedFiles:N,contextFiles:[]}}},n,t.approvalReceipt);if(!t.wait){t.output==="json"?console.log(JSON.stringify({success:!0,run:me},null,2)):t.output!=="quiet"&&(k("Presentation generation queued"),C("Run ID",me.runId),C("Status",me.status),console.log(Z.gray(` Check later with presentation status ${me.runId}`)));return}let we=await I("createSlides",me.runId,t.teamId);for(;!we.done;)t.output!=="json"&&t.output!=="quiet"&&console.log(Z.gray(` ${we.message}`)),await new Promise(Qt=>setTimeout(Qt,(we.nextPollAfterSeconds??5)*1e3)),we=await I("createSlides",me.runId,t.teamId);if(we.error)throw new Error(ue(we.error));let Ye=we.entity?await bt(we.entity.id):void 0;if(t.output==="json")console.log(JSON.stringify({success:!0,presentation:Ye,run:we,viewUrl:Ye?ht(Ye.slug,t.language??"en"):void 0},null,2));else{console.log(),k("Presentation created successfully"),console.log(),C("Title",Ye?.title??e),C("Slides",String(Ye?.numberOfSlides??r??"\u2014")),console.log();let Qt=Ye?ht(Ye.slug,t.language??"en"):"N/A";Qt!=="N/A"&&(console.log(Z.bold(" Open: ")+Z.cyan.underline(Qt)),t.open&&await(await import("open")).default(Qt)),console.log()}}catch(P){t.output==="json"?console.log(JSON.stringify({success:!1,error:P instanceof Error?P.message:String(P),...P.errorCode==="approval_required"?{idempotencyKey:n}:{}})):(P.errorCode==="approval_required"&&C("Idempotency key",n),a(P instanceof Error?P.message:String(P))),process.exit(P.exitCode??1)}});async function hw(){return new Promise(e=>{let t="";if(process.stdin.setEncoding("utf8"),process.stdin.isTTY){e("");return}process.stdin.on("data",n=>{t+=n}),process.stdin.on("end",()=>{e(t.trim())}),setTimeout(()=>{e(t.trim())},100)})}import{Command as di}from"commander";function si(e,t){let n=Number(e);return(!Number.isInteger(n)||n<0)&&(a(`${t} must be a whole number`),process.exit(s.GENERAL_ERROR)),n}var yw=new di("activity").description("List credit spend grouped by the artifact it was spent on").option("--limit <count>","How many groups to return (default 20)").option("--offset <count>","How many groups to skip").option("--team-id <id>","Workspace ID").action(async e=>{try{l(await m("listCreditActivity",{limit:e.limit===void 0?void 0:si(e.limit,"--limit"),offset:e.offset===void 0?void 0:si(e.offset,"--offset"),teamId:e.teamId}))}catch(t){a(t instanceof Error?t.message:"Reading credit activity failed"),process.exit(s.GENERAL_ERROR)}}),bw=new di("trace").description("List every credit charge inside one activity group").argument("[group-id]","Artifact or chat ID the group is keyed on; omit only with --group-type ungrouped").option("--group-type <type>","artifact (default), chat, or ungrouped").option("--limit <count>","How many charges to return (default 100)").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("getCreditActivityGroup",{groupId:e,groupType:t.groupType,limit:t.limit===void 0?void 0:si(t.limit,"--limit"),teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Reading the credit activity group failed"),process.exit(s.GENERAL_ERROR)}}),tl=new di("credits").description("Credit spend reporting").addCommand(yw).addCommand(bw);import{randomUUID as ww}from"crypto";import{readFile as vw}from"fs/promises";import{Command as Ge}from"commander";var ci=["text/markdown","text/csv","text/plain"];async function nl(e){let t=e.content;if(t!==void 0&&t!=="-"&&!t.startsWith("@"))return t;if(t?.startsWith("@"))return vw(t.slice(1),"utf8");if(t==="-"||!process.stdin.isTTY)return Iw();a("No document body. Pass --content <text>, --content @<path>, or pipe it on stdin."),process.exit(s.GENERAL_ERROR)}async function Iw(){let e=[];for await(let t of process.stdin)e.push(Buffer.from(t));return Buffer.concat(e).toString("utf8")}function pr(e){return`cli:document:${e}:${ww()}`}function dt(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}function kw(e){if(!e)return;let t=e.split(".").pop()?.toLowerCase();if(t==="md"||t==="markdown")return"text/markdown";if(t==="csv")return"text/csv";if(t==="txt")return"text/plain"}var xw=new Ge("create").description("Save a document into the Library").argument("<title>","Document title").option("--team-id <id>","Workspace ID").option("--content <text>","Document body: literal text, @<path> to read a file, or '-' for stdin").option("--media-type <type>",`One of ${ci.join(", ")}; inferred from an @<path> body when omitted`).option("--summary <text>","One line for the Library card").action(async(e,t)=>{try{let n=t.mediaType??kw(t.content?.startsWith("@")?t.content.slice(1):void 0);n||(a(`Cannot tell what this document is. Pass --media-type (${ci.join(", ")}).`),process.exit(s.GENERAL_ERROR)),l(await m("createDocument",{content:await nl(t),mediaType:n,summary:t.summary,teamId:t.teamId,title:e},pr("create")))}catch(n){dt(n,"Could not save the document")}}),Rw=new Ge("list").description("List the workspace's documents, newest first").option("--team-id <id>","Workspace ID").option("--media-type <type>",`Filter to one of ${ci.join(", ")}`).option("--limit <n>","Maximum documents to return (default 50)").action(async e=>{try{l(await m("listDocuments",{limit:e.limit?Number(e.limit):void 0,mediaType:e.mediaType,teamId:e.teamId}))}catch(t){dt(t,"Could not list documents")}}),Cw=new Ge("read").description("Print a document's body").argument("<document-id>","Document id").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{let n=await m("readDocument",{documentId:e,teamId:t.teamId}),{document:r}=n;process.stderr.write(`${r.title} \xB7 ${r.mediaType} \xB7 v${r.version} \xB7 ${r.byteLength} bytes
|
|
110
|
+
`),process.stdout.write(r.content)}catch(n){dt(n,"Could not read the document")}}),Sw=new Ge("update").description("Edit a document under an optimistic lock").argument("<document-id>","Document id").requiredOption("--expected-version <n>","The version you last read; the edit is rejected if it has moved on").option("--team-id <id>","Workspace ID").option("--content <text>","New body: literal text, @<path> to read a file, or '-' for stdin").option("--title <text>","New title").option("--summary <text>","New Library-card summary").option("--change-summary <text>","What changed, recorded on the version").action(async(e,t)=>{try{let n=t.content!==void 0;l(await m("updateDocument",{changeSummary:t.changeSummary,content:n?await nl(t):void 0,documentId:e,expectedVersion:Number(t.expectedVersion),summary:t.summary,teamId:t.teamId,title:t.title},pr("update")))}catch(n){dt(n,"Could not update the document")}}),Ew=new Ge("delete").description("Remove a document from the Library").argument("<document-id>","Document id").option("--team-id <id>","Workspace ID").option("--yes","Skip the confirmation prompt").action(async(e,t)=>{try{!t.yes&&process.stdin.isTTY&&(a("Refusing to delete without confirmation. Re-run with --yes to remove this document."),process.exit(s.GENERAL_ERROR)),l(await m("deleteDocument",{documentId:e,teamId:t.teamId},pr("delete")))}catch(n){dt(n,"Could not delete the document")}}),Tw=new Ge("versions").description("List a document's version history").argument("<document-id>","Document id").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("listDocumentVersions",{documentId:e,teamId:t.teamId}))}catch(n){dt(n,"Could not list versions")}}),$w=new Ge("restore").description("Restore an earlier version by appending it as the current one").argument("<document-id>","Document id").requiredOption("--version-number <n>","The historical version to restore").requiredOption("--expected-version <n>","The version you last read; the restore is rejected if it has moved on").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("restoreDocumentVersion",{documentId:e,expectedVersion:Number(t.expectedVersion),teamId:t.teamId,versionNumber:Number(t.versionNumber)},pr("restore")))}catch(n){dt(n,"Could not restore the version")}}),rl=new Ge("document").description("Create, read and edit Library documents").addCommand(xw).addCommand(Rw).addCommand(Cw).addCommand(Sw).addCommand(Ew).addCommand(Tw).addCommand($w);import hn from"chalk";import{Command as Aw}from"commander";import{writeFile as Pw}from"fs/promises";import{resolve as ol}from"path";import Ow from"ora";var Dw=["html","pdf","pptx"],li=new Aw("export").description("Export a presentation to a local HTML, PDF or PPTX file").argument("<id-or-slug>","Presentation slug, presentation ID or document ID").option("-o, --output <path>","Output file path").option("-f, --format <format>","Export format: html, pdf, pptx",y("--format",Dw),"html").option("--team-id <id>","Workspace ID (uses configured default)").action(async(e,t)=>{await h();let n=Ow("Exporting presentation...").start();try{let r=t.teamId??te();if(!r)throw new Error("Team ID required. Set one with 'mf config set team-id <id>' or pass --team-id.");let o=await Ka(e,t.format,{teamId:r}),i=t.output?ol(t.output):ol(process.cwd(),o.fileName);n.text="Downloading...";let c=await Wa(o.downloadUrl);await Pw(i,Buffer.from(c)),n.succeed("Export complete!"),console.log(),b(`File saved: ${i}`),b(`Format: ${o.format}`),b(`Slides: ${o.slideCount}`),b(`Size: ${Nw(c.byteLength)}`),console.log()}catch(r){n.fail("Export failed"),a(r instanceof Error?r.message:String(r)),process.exit(r.exitCode??1)}});function Nw(e){return e<1024?`${e} B`:e<1024*1024?`${(e/1024).toFixed(1)} KB`:`${(e/(1024*1024)).toFixed(1)} MB`}li.addHelpText("after",`
|
|
111
|
+
${hn.bold("Examples:")}
|
|
112
|
+
${hn.gray("# Self-contained interactive HTML (default)")}
|
|
113
|
+
$ ${p.commands[0]} export <id-or-slug> -o deck.html
|
|
114
|
+
|
|
115
|
+
${hn.gray("# PDF or PowerPoint")}
|
|
116
|
+
$ ${p.commands[0]} export <id-or-slug> -f pdf -o deck.pdf
|
|
117
|
+
$ ${p.commands[0]} export <id-or-slug> -f pptx -o deck.pptx
|
|
118
|
+
|
|
119
|
+
${hn.bold("See also:")}
|
|
120
|
+
${hn.gray("# For an MP4 instead")}
|
|
121
|
+
$ ${p.commands[0]} presentation video <id-or-slug>
|
|
122
|
+
`);import{randomUUID as Lw}from"crypto";import{existsSync as Uw}from"fs";import{Command as Dt,InvalidArgumentError as il}from"commander";var _w=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function qw(e){if(!_w.test(e))throw new il("file-id expects a UUID from `mf file list`.");return e}function mi(e){return t=>{let n=Number(t);if(!Number.isInteger(n)||n<1)throw new il(`${e} expects a whole number above 0.`);return n}}function gr(e){return`cli:file:${e}:${Lw()}`}function yn(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var jw=new Dt("add").description("Put a local file on the Library shelf; a .zip is expanded into the files it holds").argument("<path>","Path to the local file").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h(),Uw(e)||(a(`File not found: ${e}`),process.exit(s.INVALID_INPUT));try{let n=Ze(e),r=gr("add"),o=await m("createLibraryFileUploadUrl",{...n,teamId:t.teamId},`${r}:upload`),i=await et(e,o);l(await m("addLibraryFile",{mediaType:i.type,name:i.name,size:i.size,teamId:t.teamId,uploadKey:i.s3Key,url:i.url},r))}catch(n){yn(n,"Could not add that file to the Library")}}),Vw=new Dt("upload-url").description("Mint an upload target for a file you will add to the Library").requiredOption("--file-name <name>","Name of the file being uploaded").requiredOption("--file-size <bytes>","Exact byte size of the file",mi("--file-size")).requiredOption("--file-type <mime>","Media type of the file").option("--team-id <id>","Workspace ID").action(async e=>{await h();try{l(await m("createLibraryFileUploadUrl",{fileName:e.fileName,fileSize:e.fileSize,fileType:e.fileType,teamId:e.teamId},gr("upload-url")))}catch(t){yn(t,"Could not mint an upload target")}}),Mw=new Dt("list").description("List the workspace's Library files, newest first").option("--team-id <id>","Workspace ID").option("--limit <n>","Maximum files to return (default 50)",mi("--limit")).action(async e=>{await h();try{l(await m("listLibraryFiles",{limit:e.limit,teamId:e.teamId}))}catch(t){yn(t,"Could not list Library files")}}),Bw=new Dt("remove").description("Take a file off the shelf and delete its stored bytes").argument("<file-id>","File id from `mf file list`",qw).option("--team-id <id>","Workspace ID").action(async(e,t)=>{await h();try{l(await m("removeLibraryFile",{fileId:e,teamId:t.teamId},gr("remove")))}catch(n){yn(n,"Could not remove that file")}}),Fw=new Dt("save").description("File an object you already uploaded onto the Library shelf").requiredOption("--media-type <type>","Media type of the uploaded object").requiredOption("--name <name>","File name to show on the shelf").requiredOption("--size <bytes>","Byte size of the uploaded object",mi("--size")).requiredOption("--upload-key <key>","Storage key from `mf file upload-url`").requiredOption("--url <url>","App-owned file URL from `mf file upload-url`").option("--team-id <id>","Workspace ID").action(async e=>{await h();try{l(await m("addLibraryFile",{mediaType:e.mediaType,name:e.name,size:e.size,teamId:e.teamId,uploadKey:e.uploadKey,url:e.url},gr("save")))}catch(t){yn(t,"Could not file that object")}}),al=new Dt("file").description("Library files you can mention in chat with @").addCommand(jw).addCommand(Fw).addCommand(Mw).addCommand(Bw).addCommand(Vw);import{Command as Re}from"commander";var Gw=new Re("create").description("Create a transcript-native footage edit project").requiredOption("--title <title>","Project title").requiredOption("--source <asset-ids...>","Analyzed source recording IDs").requiredOption("--strategy <json>","Editorial strategy JSON object").requiredOption("--ranges <json>","Selected ranges JSON array").requiredOption("--outputs <json>","Output variants JSON array").option("--overlays <json>","Overlay JSON array","[]").option("--music-asset-id <id>","Music media asset ID").option("--source-chat-id <id>","Source chat ID").requiredOption("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async e=>{await Ke("createFootageProject",{input:{musicAssetId:e.musicAssetId??null,outputs:bn(e.outputs,"outputs"),overlays:bn(e.overlays,"overlays"),ranges:bn(e.ranges,"ranges"),sourceAssetIds:e.source,sourceChatId:e.sourceChatId,strategy:bn(e.strategy,"strategy"),teamId:e.teamId,title:e.title},idempotencyKey:e.idempotencyKey})}),Kw=new Re("show").description("Read a footage project and its append-only versions").argument("<project-id>","Project ID or slug").option("--version-id <id>","Historical version ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await Ke("getFootageProject",{input:{projectId:e,teamId:t.teamId,versionId:t.versionId}})}),Ww=new Re("revise").description("Append a semantic footage draft revision").argument("<project-id>","Project ID or slug").requiredOption("--base-version-id <id>","Current version ID").requiredOption("--change-summary <text>","Human-readable change summary").option("--title <title>","Replacement title").option("--strategy <json>","Replacement strategy JSON object").option("--ranges <json>","Replacement ranges JSON array").option("--outputs <json>","Replacement outputs JSON array").option("--overlays <json>","Replacement overlays JSON array").option("--music-asset-id <id-or-null>","Replacement music asset ID or null").requiredOption("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await Ke("reviseFootageProject",{input:cl({baseVersionId:t.baseVersionId,changeSummary:t.changeSummary,musicAssetId:t.musicAssetId==="null"?null:t.musicAssetId,outputs:fr(t.outputs,"outputs"),overlays:fr(t.overlays,"overlays"),projectId:e,ranges:fr(t.ranges,"ranges"),strategy:fr(t.strategy,"strategy"),teamId:t.teamId,title:t.title}),idempotencyKey:t.idempotencyKey})}),Jw=new Re("restore").description("Restore a historical footage version as a new head").argument("<project-id>","Project ID or slug").argument("<version-id>","Historical version ID").option("--change-summary <text>","Change summary","Restored version").requiredOption("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{await Ke("restoreFootageProjectVersion",{input:{changeSummary:n.changeSummary,projectId:e,teamId:n.teamId,versionId:t},idempotencyKey:n.idempotencyKey})}),zw=new Re("branch").description("Branch a historical footage version into a new project").argument("<project-id>","Source project ID or slug").argument("<version-id>","Historical version ID").requiredOption("--title <title>","New project title").requiredOption("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{await Ke("branchFootageProjectVersion",{input:{projectId:e,teamId:n.teamId,title:n.title,versionId:t},idempotencyKey:n.idempotencyKey})}),Hw=new Re("inspect").description("Create proxy, filmstrip, and waveform evidence for one range").argument("<project-id>","Project ID or slug").argument("<range-id>","Stable range ID").requiredOption("--version-id <id>","Exact version ID").requiredOption("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{await Ke("inspectFootageRange",{input:{projectId:e,rangeId:t,teamId:n.teamId,versionId:n.versionId},idempotencyKey:n.idempotencyKey})}),Xw=new Re("inspection-status").description("Read a footage range inspection run").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await dl("inspectFootageRange",e,t.teamId)}),Yw=new Re("render").description("Render an exact approved footage draft version").argument("<project-id>","Project ID or slug").requiredOption("--version-id <id>","Exact version ID").option("--output <ids...>","Output IDs; omit to render every output").option("--approval-receipt <receipt>","Browser-issued approval receipt; omit on the first call to get the confirmation URL").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").requiredOption("--idempotency-key <key>","Key bound into the receipt").option("--team-id <id>","Workspace ID").action(async(e,t)=>{let n=he(t);await Ke("renderFootageProject",{input:cl({approvalReceipt:n,outputIds:t.output,projectId:e,teamId:t.teamId,versionId:t.versionId}),idempotencyKey:t.idempotencyKey})}),Qw=new Re("render-status").description("Read a Footage Studio render run").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await dl("renderFootageProject",e,t.teamId)}),Zw=new Re("import-takes").description("Import all completed takes from a clipping invocation").argument("<project-id>","Project ID or slug").requiredOption("--invocation-id <id>","cc-services clipping invocation ID").requiredOption("--idempotency-key <key>","Stable import retry key").option("--team-id <id>","Workspace ID").action(async(e,t)=>{await Ke("importFootageProviderTakes",{input:{invocationId:t.invocationId,projectId:e,teamId:t.teamId},idempotencyKey:t.idempotencyKey})}),sl=new Re("footage").description("Create, inspect, revise, and render transcript-native footage edits").addCommand(Gw).addCommand(Kw).addCommand(Ww).addCommand(Jw).addCommand(zw).addCommand(Hw).addCommand(Xw).addCommand(Yw).addCommand(Qw).addCommand(Zw);async function Ke(e,t){try{l(await m(e,t.input,t.idempotencyKey))}catch(n){a(n instanceof Error?n.message:"Footage operation failed"),process.exit(s.GENERAL_ERROR)}}async function dl(e,t,n){try{l(await I(e,t,n))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}function bn(e,t){try{return JSON.parse(e)}catch{throw new Error(`${t} must be valid JSON.`)}}function fr(e,t){return typeof e=="string"?bn(e,t):void 0}function cl(e){return Object.fromEntries(Object.entries(e).filter(([,t])=>t!==void 0))}import{Command as ev}from"commander";import ct from"chalk";function tv(e){return new Set((e??"").split(",").map(t=>t.trim().toLowerCase()).filter(Boolean))}function nv(e){if(!e)throw new Error("Slides were requested but the server returned none. Retry, or read the deck in the browser.");ve("Slides"),console.log();for(let t of e){console.log(ct.bold(` ${t.number}. ${t.title||"Untitled"}`));let n=t.text?.trim();console.log(n?ll(n):ct.gray(" (no text on this slide \u2014 image or empty)"));let r=t.speakerNotes?.trim();r&&(console.log(ct.gray(" Narration/notes:")),console.log(ct.gray(ll(r)))),console.log()}}function ll(e){return e.split(`
|
|
123
|
+
`).map(t=>` ${t}`).join(`
|
|
124
|
+
`)}var ml=new ev("get").description("Get presentation details").argument("<slug>","Presentation slug (e.g., my-presentation-v1-abc123)").option("-f, --format <format>","Output format (summary, full, json)",y("--format",["summary","full","json"]),"summary").option("--include <fields>","Legacy fields list (comma-separated: slides,styling)").option("--include-slides","Include ordered slide content",!0).option("--no-include-slides","Omit slide content for a smaller response").option("-l, --language <lang>","Language for view URL","en").option("--team-id <id>","Workspace ID (uses configured default)").action(async function(e,t){await h();try{let n=this.getOptionValueSource("includeSlides")==="cli"?t.includeSlides:this.getOptionValueSource("include")==="cli"?tv(t.include).has("slides"):!0,r=t.teamId??te();if(!r)throw new Error("Team ID required. Set one with 'mf config set team-id <id>' or pass --team-id.");let o=await bt(e,{includeSlides:n,teamId:r});if(t.format==="json"){console.log(JSON.stringify(o,null,2));return}let i=ht(o.slug,t.language);ve("Presentation Details"),console.log(),C("Slug",o.slug),C("Title",o.title||"Untitled"),C("Description",o.description||ct.gray("None")),C("Slides",String(o.numberOfSlides||"-")),C("Mode",o.mode||"-"),C("Created",eo(o.createdAt)),o.updatedAt&&C("Updated",eo(o.updatedAt)),console.log(),i!=="N/A"&&console.log(ct.bold(" Open: ")+ct.cyan.underline(i)),console.log(),n&&nv(o.slides)}catch(n){a(n instanceof Error?n.message:String(n));let r=n&&typeof n=="object"&&"exitCode"in n&&typeof n.exitCode=="number"?n.exitCode:1;process.exit(r)}});import{randomUUID as rv}from"crypto";import{Command as yr}from"commander";import ov from"ora";function iv(e){let t=e?.trim().toLowerCase();if(!(!t||t==="any"||t==="all"))return t==="web"||t==="stock"?[t]:void 0}function av(e){let t=e.assetType??"image";if(t!=="image"&&t!=="icon")throw new Error("Asset type must be image or icon");let n;if(e.maxResults&&(n=Number.parseInt(e.maxResults,10),Number.isNaN(n)||n<1))throw new Error("Max results must be a positive number");return{query:t==="icon"?`${e.query.trim()} transparent icon isolated symbol`:e.query.trim(),options:{maxResults:n||10,size:e.size,safeSearch:e.safeSearch,assetType:t,sources:iv(e.source),transparentBackground:t==="icon"}}}function sv(e){let t=e.url||e.imageUrl;if(!t)throw new Error("Image search returned a result without a URL");return t}function dv(e){return e.transparent??e.isTransparent??e.metadata?.transparent??e.metadata?.isTransparent}function cv(e){let t=[],n=e.reduce((r,o)=>Math.max(r,o.length),0);for(let r=0;r<n;r+=1)for(let o of e){let i=o[r];i!==void 0&&t.push(i)}return t}function lv(e,t){let n=e.data.results.map(r=>r.results.map(o=>{let i=o,c=dv(i);if(t==="icon"&&c!==!0)throw new Error("Icon search returned a result without a verified transparent background");return{...i,url:sv(i),provider:r.providerName,assetType:t,...c!==void 0?{transparent:c}:{}}}));return cv(n)}function mv(e){return e.error||e.status==="failed"||e.status==="errored"||e.status==="cancelled"?"failed":e.done||e.status==="completed"?"completed":e.status==="in_progress"?"processing":"pending"}function hr(e){return typeof e=="number"&&Number.isFinite(e)?e:void 0}function uv(e){return{requestId:e.runId,status:mv(e),...e.entity?.url?{url:e.entity.url}:{},...e.error?{error:ue(e.error)}:{},...hr(e.output?.width)!==void 0?{width:hr(e.output?.width)}:{},...hr(e.output?.height)!==void 0?{height:hr(e.output?.height)}:{}}}async function ul(e,t){return uv(await I("createImage",e,t))}function ui(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.output??e.url??e.requestId);return}b(`Request ID: ${e.requestId}`),b(`Status: ${e.status}`),e.url&&k(`Image URL: ${e.url}`),e.output&&k(`Saved to: ${e.output}`),e.error&&a(`Error: ${e.error}`)}var pv=new yr("search").description("Search images across the web and licensed stock").requiredOption("-q, --query <query>","Search query").option("-n, --max-results <number>","Maximum number of results (default: 10)").option("-s, --size <size>","Image size: small, medium, large, any","large").option("--asset-type <type>","Asset intent: image or transparent icon","image").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("--safe-search","Enable safe search (default: true)",!0).option("--no-safe-search","Disable safe search").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.format,n=t==="human"?ov("Searching for images...").start():null,r;try{r=av(e)}catch(o){n?.stop(),a(o instanceof Error?o.message:"Invalid image search request"),process.exit(s.INVALID_INPUT);return}try{let o=await os(r);n?.stop(),o.success||(a("Search failed"),process.exit(s.GENERAL_ERROR));let i=r.options?.assetType??"image",c=lv(o,i);if(t==="json"){l({success:!0,query:e.query,assetType:i,totalResults:c.length,images:c});return}if(t==="quiet"){for(let d of c)console.log(d.url);return}if(c.length===0){b("No images found");return}k(`Found ${c.length} images for "${e.query}"`),console.log();for(let d=0;d<c.length;d++){let u=c[d];console.log(`[${d+1}] ${u.title||"Untitled"}`),console.log(` URL: ${u.url}`),console.log(` Size: ${u.width}x${u.height}`),u.author&&console.log(` Author: ${u.author}`),console.log(` Provider: ${u.provider}`),console.log()}}catch(o){n?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),gv=new yr("generate").description("Generate an image and optionally save it locally").argument("[prompt]","Image prompt").option("-p, --prompt <text>","Image prompt (named compatibility form)").option("--provider <provider>","Provider override").option("--model <model>","Model override").option("--aspect-ratio <ratio>","Output aspect ratio: square, wide, or tall",y("--aspect-ratio",["square","wide","tall"])).option("--number-of-images <count>","Number of images (1-4)").option("--purpose <purpose>","Explicit image intent: general, draft, infographic, brand-max, or vector; omitted means general",y("--purpose",["general","draft","infographic","brand-max","vector"])).option("--width <pixels>","Width").option("--height <pixels>","Height").option("--reason <text>","Optional generation reason").option("--team-id <id>","Workspace ID").option("--reference-image <label=path-or-url...>","Image the generation must follow: a local file (uploaded for you, never resized) or a public HTTP(S) URL. Repeatable. Prefix an optional label, e.g. identity=./face.jpg, style=https://\u2026/mood.png. Fidelity depends on the routed model: the auto-routed one returns a similar-looking subject, while --provider google-ai --model gemini-3-pro-image returns the same person \u2014 but that pin takes effect only on workspaces holding the internal image-model-override flag").option("--idempotency-key <key>","Stable retry key for this generation and its reference uploads").option("-o, --output <path>","Local output path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").option("--yes","Approve generation").action(async(e,t)=>{let n,r=e??t.prompt;r?.trim()||(a("Provide an image prompt as an argument or with --prompt"),process.exit(s.INVALID_INPUT)),t.yes||(a("Pass --yes to approve image generation"),process.exit(s.INVALID_INPUT)),!t.wait&&t.output&&(a("--output requires waiting for completion; remove --no-wait"),process.exit(s.INVALID_INPUT)),(t.provider||t.model)&&L("--provider/--model are honoured only for workspaces holding the internal image-model-override flag. Without it the server drops them and routes the request itself.",t.format),t.referenceImage?.length&&!t.model&&L("Reference images without --model route to a light model that returns a similar-looking, not identical, subject. A recognisable likeness needs --provider google-ai --model gemini-3-pro-image on a workspace with the image-model-override flag.",t.format);let o=t.idempotencyKey??rv();try{let i=await Yn(t.referenceImage,{idempotencyKey:o,rejectNonImageFiles:!0}),c=await m("createImage",{aspectRatio:t.aspectRatio,confirmed:!0,height:t.height?Number.parseInt(t.height,10):void 0,model:t.model,numberOfImages:t.numberOfImages?Number.parseInt(t.numberOfImages,10):void 0,prompt:r.trim(),provider:t.provider,...t.purpose?{purpose:t.purpose}:{},...i?{referenceImages:i}:{},reason:t.reason,teamId:t.teamId,width:t.width?Number.parseInt(t.width,10):void 0},o);if(n=c.runId,!t.wait){ui({requestId:c.runId,status:"pending"},t.format);return}let d=await pe(()=>ul(c.runId,t.teamId),180,2e3);if(d.status==="failed")throw new Error(d.error||"Image generation failed");if(!d.url)throw new Error("Image generation completed without an image URL");let u=t.output?{...d,output:t.output}:d;t.output&&await oe(d.url,t.output),ui(u,t.format)}catch(i){a(ne(i,n),t.format),process.exit(s.GENERAL_ERROR)}}),fv=new yr("status").description("Read image generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").option("-o, --output <path>","Download a completed image").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await ul(e,t.teamId);if(t.output){if(n.status!=="completed"||!n.url)throw new Error("Image generation is not complete");await oe(n.url,t.output),n.output=t.output}ui(n,t.format)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),pl=new yr("image").description("Image search and generation commands").addCommand(pv).addCommand(gv).addCommand(fv);import{Command as pi}from"commander";var hv=new pi("search").description("Search the workspace Knowledge Hub").argument("[query]","Optional search query").option("--team-id <id>","Workspace ID").option("--kind <kind>","Knowledge kind").option("--limit <count>","Maximum results","10").option("--provenance <source>","Filter by human or agent provenance").action(async(e,t)=>{try{l(await m("searchKnowledge",{kind:t.kind,limit:Number.parseInt(t.limit,10),provenance:t.provenance,query:e,teamId:t.teamId}))}catch(n){a(n instanceof Error?n.message:"Knowledge search failed"),process.exit(s.GENERAL_ERROR)}}),yv=new pi("bundle").description("Read a bounded Open Knowledge Format bundle").option("--team-id <id>","Workspace ID").option("--kind <kind>","Knowledge kind").action(async e=>{try{l(await m("getKnowledgeBundle",{kind:e.kind,teamId:e.teamId}))}catch(t){a(t instanceof Error?t.message:"Knowledge bundle failed"),process.exit(s.GENERAL_ERROR)}}),gl=new pi("knowledge").description("Search the workspace Knowledge Hub and read bounded knowledge bundles").addCommand(hv).addCommand(yv);import{randomUUID as bv}from"crypto";import br from"chalk";import{Command as Ue}from"commander";function gi(e){if(e!==void 0)return e==="root"?null:e}function Nt(e){return`cli:library:${e}:${bv()}`}function lt(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var wv=new Ue("list").description("List the Library folder tree").option("--team-id <id>","Workspace ID").option("--counts","Include how many items are in each folder").action(async e=>{try{l(await m("listLibraryFolders",{includeEntryCounts:!!e.counts,teamId:e.teamId}))}catch(t){lt(t,"Could not list folders")}}),vv=new Ue("create").description("Create a Library folder").argument("<name>","Folder name").option("--team-id <id>","Workspace ID").option("--parent <id>","Parent folder id; omit for a top-level folder").option("--color <color>","Colour token (slate, blue, green, amber, red, violet)").action(async(e,t)=>{try{l(await m("createLibraryFolder",{color:t.color,name:e,parentId:gi(t.parent),teamId:t.teamId},Nt("create")))}catch(n){lt(n,"Could not create the folder")}}),Iv=new Ue("rename").description("Rename a Library folder").argument("<folder-id>","Folder id").argument("<name>","New name").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{try{l(await m("renameLibraryFolder",{folderId:e,name:t,teamId:n.teamId},Nt("rename")))}catch(r){lt(r,"Could not rename the folder")}}),kv=new Ue("recolor").description("Set or clear a Library folder's colour").argument("<folder-id>","Folder id").requiredOption("--color <color>","Colour token (slate, blue, green, amber, red, violet), or 'none' to clear").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("recolorLibraryFolder",{color:t.color==="none"?null:t.color,folderId:e,teamId:t.teamId},Nt("recolor")))}catch(n){lt(n,"Could not recolour the folder")}}),xv=new Ue("move").description("Move a Library folder under a new parent").argument("<folder-id>","Folder id").requiredOption("--to <id>","New parent folder id, or 'root' for top level").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("moveLibraryFolder",{folderId:e,newParentId:gi(t.to),teamId:t.teamId},Nt("move")))}catch(n){lt(n,"Could not move the folder")}}),Rv=new Ue("delete").description("Delete a folder and its subfolders; items inside are unfiled").argument("<folder-id>","Folder id").requiredOption("--yes","Confirm deletion").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("deleteLibraryFolder",{folderId:e,teamId:t.teamId},Nt("delete")))}catch(n){lt(n,"Could not delete the folder")}}),Cv=new Ue("folders").description("Manage Library folders").addCommand(wv).addCommand(vv).addCommand(Iv).addCommand(kv).addCommand(xv).addCommand(Rv),Sv=new Ue("file").description("File an artifact into a Library folder").argument("<kind>","Artifact kind, e.g. presentation or microsite").argument("<target-id>","Id of the artifact itself").requiredOption("--folder <id>","Destination folder id, or 'root' to unfile the artifact").option("--team-id <id>","Workspace ID").action(async(e,t,n)=>{try{l(await m("fileArtifactIntoFolder",{folderId:gi(n.folder),kind:e,targetId:t,teamId:n.teamId},Nt("file")))}catch(r){lt(r,"Could not file that item")}}),fi=new Ue("library").description("Library folders and filing").addCommand(Cv).addCommand(Sv);fi.addHelpText("after",`
|
|
125
|
+
${br.bold("Examples:")}
|
|
126
|
+
${br.gray("# Browse the folder tree and file an artifact into a folder")}
|
|
127
|
+
$ ${p.commands[0]} library folders list
|
|
128
|
+
$ ${p.commands[0]} library file presentation <id> --folder <folder-id>
|
|
129
|
+
|
|
130
|
+
${br.bold("See also:")}
|
|
131
|
+
${br.gray("# A different thing: reusable video clips, not Library folders")}
|
|
132
|
+
$ ${p.commands[0]} video library --help
|
|
133
|
+
`);import{randomUUID as Ev}from"crypto";import{Command as wn}from"commander";function R(e,t){let n={...t},r=e.parent,o=!1;for(;r;){let i=r.opts?.();if(i){o=!0;for(let[c,d]of Object.entries(i))n[c]===void 0&&d!==void 0&&(n[c]=d)}r=r.parent}return o?n:t}var fl=new wn("analyze").description("Transcribe an uploaded recording and publish it for generation").argument("<asset-id>","Recording ID").option("--language <code>","BCP-47 language hint for the spoken audio").option("--no-diarize","Skip speaker attribution (cheaper, but a multi-speaker recording becomes much weaker as generation input)").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable recovery key").option("--yes","Confirm the charge \u2014 billed per source-minute").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to confirm. Analysis is billed per minute of source audio.");let n=t.idempotencyKey??Ev();try{l(await m("analyzeMediaAsset",{assetId:e,diarize:t.diarize,language:t.language,teamId:t.teamId},n))}catch(r){a(`${r instanceof Error?r.message:"Analysis failed"} Retry with --idempotency-key ${n}.`),process.exit(s.GENERAL_ERROR)}}),Tv=new wn("status").description("Read an analysis run's status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async function(e,t){let n=R(this,t);try{l(await I("analyzeMediaAsset",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}});fl.addCommand(Tv);var hl=new wn("import").description("Import a recording from a connected account").argument("<remote-file-id>","The provider's own ID for the recording").requiredOption("--provider <id>","Provider id of the connected account, e.g. google").requiredOption("--connector <id>","Connected account ID to read from").option("--title <title>","Name for the imported recording").option("--chat <id>","Chat this import was requested from").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("importConnectorRecording",{connectorId:t.connector,providerId:t.provider,remoteFileId:e,sourceChatId:t.chat,teamId:t.teamId,title:t.title}))}catch(n){a(n instanceof Error?n.message:"Import failed"),process.exit(s.GENERAL_ERROR)}}),$v=new wn("status").description("Read an import run's status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async function(e,t){let n=R(this,t);try{l(await I("importConnectorRecording",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}});hl.addCommand($v);var yl=new wn("media").description("Ingest and transcribe recordings you already own").addCommand(fl).addCommand(hl);import{Command as hi}from"commander";var Av=new hi("create").description("Start background microsite generation").argument("<title>","Microsite title").requiredOption("--description <brief>","Microsite brief").option("--audience <audience>","Target audience").option("--tone <tone>","Tone").option("--language <language>","Content language","en").option("--branding-id <id>","Branding ID").option("--team-id <id>","Workspace ID").option("--yes","Approve generation").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to approve generation");try{l(await m("createMicrosite",{approvalReceipt:"cli:--yes",audience:t.audience,brandingId:t.brandingId,description:t.description,language:t.language,teamId:t.teamId,title:e,tone:t.tone}))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(s.GENERAL_ERROR)}}),Pv=new hi("status").description("Read microsite generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await I("createMicrosite",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),bl=new hi("microsite").description("Generate a shareable multi-section web microsite from a brief").addCommand(Av).addCommand(Pv);import{randomUUID as Ov}from"crypto";import{Command as wi}from"commander";import yi from"ora";function bi(e,t){if(t==="json"){l(e);return}if(t==="quiet"){e.outputUrl?console.log(e.outputUrl):console.log(e.requestId);return}b(`Request ID: ${e.requestId}`),b(`Status: ${e.status}`),e.duration&&b(`Duration: ${e.duration}s`),e.outputUrl&&k(`Output URL: ${e.outputUrl}`),e.error&&a(`Error: ${e.error}`)}var Dv=new wi("create").description("Mix audio tracks into a video (music will loop to match video duration)").option("--video <url>","Input video file/URL").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").option("--idempotency-key <key>","Stable recovery key").option("--inputs-json <json>","Canonical audio input array").option("--operation <operation>","Canonical mix operation","add-to-video").option("--options-json <json>","Canonical mix options JSON").option("--music <url>","Background music file/URL (will loop if shorter than video)").option("--voice <url>","Voiceover file/URL").option("--music-volume <percent>","Music volume 0-100 (default: 30, recommended for mix with voice)","30").option("--voice-volume <percent>","Voice volume 0-100","100").option("-o, --output <path>","Output file path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t;try{t=he(e)}catch(g){a(g instanceof Error?g.message:String(g)),process.exit(s.INVALID_INPUT)}!e.inputsJson&&(!e.video||!e.music&&!e.voice)&&(a("At least one of --music or --voice must be provided"),process.exit(s.INVALID_INPUT));let n=parseInt(e.musicVolume,10)/100,r=parseInt(e.voiceVolume,10)/100;(Number.isNaN(n)||n<0||n>1)&&(a("Music volume must be between 0 and 100"),process.exit(s.INVALID_INPUT)),(Number.isNaN(r)||r<0||r>2)&&(a("Voice volume must be between 0 and 200"),process.exit(s.INVALID_INPUT));let o=e.format,i=o==="human"?yi("Mixing audio...").start():null,c=e.inputsJson?Nv("--inputs-json",e.inputsJson):[{url:e.video,role:"video"}];!e.inputsJson&&e.music&&c.push({url:e.music,role:"background",volume:n*5}),!e.inputsJson&&e.voice&&c.push({url:e.voice,role:"voice",volume:r*2});let d,u=e.idempotencyKey??Ov();try{let g=e.optionsJson?Lv("--options-json",e.optionsJson):{},w=await rs({operation:e.operation,inputs:c,options:e.inputsJson?g:{...g,musicVolume:n,voiceVolume:r}},{approvalReceipt:t,idempotencyKey:u});if(d=w.requestId,!e.wait){i?.stop(),bi(w,o);return}i&&(i.text=`Processing (ID: ${w.requestId})...`);let v=await pe(()=>uo(w.requestId),120,3e3);if(i?.stop(),v.status==="failed"&&(a(v.error||"Audio mixing failed"),process.exit(s.GENERAL_ERROR)),bi(v,o),e.output){if(!v.outputUrl)throw new Error("Audio mix completed without an output URL");let x=o==="human"?yi("Downloading...").start():null;await oe(v.outputUrl,e.output),x?.stop(),o==="human"&&k(`Saved to: ${e.output}`)}}catch(g){i?.stop(),a(`${ne(g,d)} Retry with --idempotency-key ${u}.`,o),process.exit(s.GENERAL_ERROR)}});function Nv(e,t){try{let n=JSON.parse(t);if(!Array.isArray(n))throw new Error;return n}catch{throw new Error(`${e} must be a JSON array`)}}function Lv(e,t){try{let n=JSON.parse(t);if(!n||typeof n!="object"||Array.isArray(n))throw new Error;return n}catch{throw new Error(`${e} must be a JSON object`)}}var Uv=new wi("status").description("Check status of an audio mix request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{let n=t.format==="human"?yi("Checking status...").start():null;try{let r=await uo(e);n?.stop(),bi(r,t.format)}catch(r){n?.stop(),a(r instanceof Error?r.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),wl=new wi("mix").description("Audio mixing commands").addCommand(Dv).addCommand(Uv);import{randomUUID as Fv}from"crypto";import{Command as Ii}from"commander";import Gv from"ora";import{readFileSync as _v}from"fs";var vl=500,Il=1e4,wr=100,kl=1e4,xl=1e3,Cl=["duration_s","idempotency_key","narration","schema_version","video_description"],qv=["end_s","id","start_s","text","words"],jv=["end","id","start","text"],Vv=["description","end_s","id","start_s"];function Sl(e){let t=Tl(e);if($l(t),vn(t,Cl,""),t.duration_s<3)throw new Error("Music request duration_s must be between 3 and 600");return t}function El(e){let t=Tl(e);$l(t),vn(t,[...Cl,"visual_event"],"");let n=t.visual_event;if(!vr(n))throw new Error("SFX request visual_event is required");if(vn(n,Vv,"visual_event"),!We(n.description))throw new Error("SFX request visual_event.description is required");if(!We(n.id)||!Je(n.start_s))throw new Error("SFX request visual_event requires id and start_s");if(n.end_s!==void 0&&(!Je(n.end_s)||n.end_s<n.start_s))throw new Error("SFX request visual_event.end_s must be after start_s");return t}function Tl(e){try{let t=JSON.parse(_v(e,"utf8"));if(!vr(t))throw new Error("request must be a JSON object");return t}catch(t){throw new Error(`Cannot read audio request ${e}: ${t instanceof Error?t.message:String(t)}`)}}function $l(e){if(e.schema_version!==1)throw new Error("Audio request schema_version must be 1");if(!We(e.video_description))throw new Error("Audio request video_description is required");if(!Je(e.duration_s)||e.duration_s<.5||e.duration_s>600)throw new Error("Audio request duration_s must be between 0.5 and 600");if(!Array.isArray(e.narration))throw new Error("Audio request narration must be an array");if(e.narration.length>vl)throw new Error(`Audio request narration holds at most ${vl} lines`);if(e.narration.forEach(Mv),e.idempotency_key!==void 0&&!We(e.idempotency_key))throw new Error("Audio request idempotency_key must be a non-empty string")}function Mv(e,t){let n=`narration.${t}`;if(!vr(e))throw new Error(`Audio request ${n} must be an object`);if(vn(e,qv,n),!We(e.id)||e.id.length>wr)throw new Error(`Audio request ${n}.id is required (1-${wr} characters)`);if(!We(e.text)||e.text.trim().length>kl)throw new Error(`Audio request ${n}.text is required (1-${kl} characters)`);if(Rl(e.start_s,`${n}.start_s`),Rl(e.end_s,`${n}.end_s`),Je(e.start_s)&&Je(e.end_s)&&e.end_s<e.start_s)throw new Error(`Audio request ${n}.end_s must be greater than or equal to ${n}.start_s`);if(e.words!==void 0){if(!Array.isArray(e.words)||e.words.length>Il)throw new Error(`Audio request ${n}.words must be an array of at most ${Il} entries`);e.words.forEach((r,o)=>{Bv(r,`${n}.words.${o}`)})}}function Bv(e,t){if(!vr(e))throw new Error(`Audio request ${t} must be an object`);if(vn(e,jv,t),!We(e.text)||e.text.trim().length>xl)throw new Error(`Audio request ${t}.text is required (1-${xl} characters)`);if(!Je(e.start)||!Je(e.end))throw new Error(`Audio request ${t} requires numeric start and end seconds`);if(e.end<e.start)throw new Error(`Audio request ${t}.end must be greater than or equal to ${t}.start`);if(e.id!==void 0&&(!We(e.id)||e.id.length>wr))throw new Error(`Audio request ${t}.id must be 1-${wr} characters`)}function Rl(e,t){if(e!==void 0&&!Je(e))throw new Error(`Audio request ${t} must be a non-negative number`)}function vn(e,t,n){let r=Object.keys(e).filter(i=>!t.includes(i));if(r.length===0)return;let o=n?`${n} `:"";throw new Error(`Audio request ${o}has unknown field(s): ${r.join(", ")}. Allowed: ${t.join(", ")}`)}function vr(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function We(e){return typeof e=="string"&&e.trim().length>0}function Je(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0}function vi(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.audioUrl??e.requestId);return}b(`Request ID: ${e.requestId}`),b(`Status: ${e.status}`),e.duration&&b(`Duration: ${e.duration}s`),e.audioUrl&&k(`Audio URL: ${e.audioUrl}`),e.error&&a(`Error: ${e.error}`)}var Kv=new Ii("generate").description("Generate music that follows a video's narration and final timing").option("--request <path>","JSON file with video description, narration, and final timing").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").option("--idempotency-key <key>","Stable recovery key").option("--duration <seconds>","Direct music duration").option("--duration-seconds <seconds>","Final video duration").option("--narration-json <json>","Final narration timing array").option("--options-json <json>","Canonical music options JSON").option("--prompt <text>","Direct music brief").option("--schema-version <version>","Video facts schema version").option("--video-description <text>","Final video description").option("-o, --output <path>","Output file path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t;try{t=he(e)}catch(d){a(d instanceof Error?d.message:String(d)),process.exit(s.INVALID_INPUT)}!e.wait&&e.output&&(a("--output requires waiting for completion; remove --no-wait"),process.exit(s.INVALID_INPUT));let n;try{n=e.request?Sl(e.request):{...e.duration?{duration:Number(e.duration)}:{},...e.durationSeconds?{duration_s:Number(e.durationSeconds)}:{},...e.narrationJson?{narration:Al("--narration-json",e.narrationJson)}:{},...e.optionsJson?{options:Al("--options-json",e.optionsJson)}:{},...e.prompt?{prompt:e.prompt}:{},...e.schemaVersion?{schema_version:Number(e.schemaVersion)}:{},...e.videoDescription?{video_description:e.videoDescription}:{}}}catch(d){a(d instanceof Error?d.message:String(d)),process.exit(s.INVALID_INPUT)}let r=e.format,o=r==="human"?Gv("Generating music for video...").start():null,i,c=e.idempotencyKey??n.idempotency_key??Fv();try{let d=await ns(n,{approvalReceipt:t,idempotencyKey:c});if(i=d.requestId,!e.wait){o?.stop(),vi(d,r);return}o&&(o.text=`Processing (ID: ${d.requestId})...`);let u=d.status==="completed"||d.status==="failed"?d:await pe(()=>mo(d.requestId),180,2e3);if(o?.stop(),u.status==="failed"&&(a(u.error||"Music generation failed"),process.exit(s.GENERAL_ERROR)),e.output){if(!u.audioUrl)throw new Error("Music completed without an audio URL");await oe(u.audioUrl,e.output),r==="human"&&k(`Saved to: ${e.output}`),u.output=e.output}vi(u,r)}catch(d){o?.stop(),a(`${ne(d,i)} Retry with --idempotency-key ${c}.`,r),process.exit(s.GENERAL_ERROR)}});function Al(e,t){try{return JSON.parse(t)}catch{throw new Error(`${e} must be valid JSON`)}}var Wv=new Ii("status").description("Check status of a music generation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{vi(await mo(e),t.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Pl=new Ii("music").description("Video-aware music generation commands").addCommand(Kv).addCommand(Wv);import{Command as ki}from"commander";function Ol(e,t){return[...t,e]}var Jv=new ki("create").description("Create a standalone poll").argument("<question>","Poll question").option("--option <text>","Choice (repeat 2-10 times)",Ol,[]).option("--type <type>","single, multiple, or word-cloud","single").option("--title <title>","Poll title").option("--team-id <id>","Workspace ID").option("--yes","Approve creation").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to approve poll creation");try{l(await m("createPoll",{approvalReceipt:"cli:--yes",options:t.option.map(n=>({text:n})),pollType:t.type,question:e,teamId:t.teamId,title:t.title}))}catch(n){a(n instanceof Error?n.message:"Poll creation failed"),process.exit(s.GENERAL_ERROR)}}),zv=new ki("edit").description("Edit a standalone poll").argument("<poll-id>","Poll UUID").option("--question <question>","New question").option("--option <text>","Replacement choice (repeat)",Ol).option("--type <type>","single, multiple, or word-cloud").option("--title <title>","Poll title").option("--team-id <id>","Workspace ID").option("--yes","Approve update").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to approve poll update");try{l(await m("editPoll",{approvalReceipt:"cli:--yes",options:t.option?.map(n=>({text:n})),pollId:e,pollType:t.type,question:t.question,teamId:t.teamId,title:t.title}))}catch(n){a(n instanceof Error?n.message:"Poll update failed"),process.exit(s.GENERAL_ERROR)}}),Dl=new ki("poll").description("Standalone poll commands").addCommand(Jv).addCommand(zv);import{randomUUID as Ar}from"crypto";import{readFile as Im}from"fs/promises";import V from"chalk";import{Command as K,InvalidArgumentError as Ni}from"commander";import{Command as Nl,InvalidArgumentError as Hv}from"commander";var Ll=new Nl("chats").description("List Studio chat threads for an owned presentation video").argument("<project-id>","Presentation-video project UUID or editor slug").option("--limit <number>","Maximum threads (1-100)",_l(1,100)).option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await ql("Chat thread list failed",()=>m("listPresentationVideoChatThreads",{limit:n.limit,projectId:e,teamId:n.teamId}))}),Ul=new Nl("chat").description("Read one Studio chat with safe attachment and scene-marker context").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<chat-id>","Thread UUID from presentation video chats").option("--before <timestamp>","Return messages older than this ISO timestamp").option("--limit <number>","Maximum messages (1-50)",_l(1,50)).option("--team-id <id>","Workspace ID override").action(async function(e,t,n){let r=R(this,n);await ql("Chat thread read failed",()=>m("getPresentationVideoChatThread",{before:r.before,chatId:t,limit:r.limit,projectId:e,teamId:r.teamId}))});function _l(e,t){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<e||r>t)throw new Hv(`Expected an integer between ${e} and ${t}.`);return r}}async function ql(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}import{randomUUID as xi}from"crypto";import{readFile as Xv}from"fs/promises";import{Command as kr}from"commander";var jl=new kr("edit").description("Apply one atomic draft edit: narration, scene patch/move/remove, composition, or intro/outro card").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--edit <json-or-path>","Edit object as inline JSON or a JSON file path").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t){let n=R(this,t);await xr("Draft edit failed",async()=>m("editPresentationVideoDraft",{edit:await Yv(n.edit),projectId:e,teamId:n.teamId},n.idempotencyKey??xi()))}),Vl=new kr("versions").description("List saved presentation-video draft versions").argument("<project-id>","Presentation-video project UUID or editor slug").option("--before-version <number>","Continue below this version number",Ir(1)).option("--limit <number>","Maximum versions",Ir(1,100)).option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await xr("Version list failed",()=>m("listPresentationVideoVersions",{beforeVersion:n.beforeVersion,limit:n.limit,projectId:e,teamId:n.teamId}))}),Ml=new kr("restore").description("Restore a saved draft version as a new version").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<version-number>","Version number",Ir(1)).option("--expected-current-version <number>","Refuse to restore if a newer draft version exists",Ir(1)).option("--expected-project-updated-at <timestamp>","Non-coalescing project revision paired with --expected-current-version").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t,n){let r=R(this,n);await xr("Version restore failed",()=>m("restorePresentationVideoVersion",{expectedCurrentVersion:r.expectedCurrentVersion,expectedProjectUpdatedAt:r.expectedProjectUpdatedAt,projectId:e,teamId:r.teamId,versionNumber:t},r.idempotencyKey??xi()))}),Bl=new kr("refresh").description("Refresh deck-backed scenes from the latest presentation version").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t){let n=R(this,t);await xr("Slide refresh failed",()=>m("refreshPresentationVideoSlides",{projectId:e,teamId:n.teamId},n.idempotencyKey??xi()))});async function Yv(e){let t=e.trim(),n=t.startsWith("{")?t:await Xv(t,"utf8"),r=JSON.parse(n);if(!r||typeof r!="object"||Array.isArray(r))throw new Error("--edit must contain one JSON object.");return r}function Ir(e,t=Number.MAX_SAFE_INTEGER){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<e||r>t)throw new Error(`Expected an integer between ${e} and ${t}.`);return r}}async function xr(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}import{createHash as Qv}from"crypto";import{Command as Lt,InvalidArgumentError as Zv}from"commander";var Fl=new Lt("drafts").description("List every video draft for one presentation with stage and staleness").argument("<presentation-id>","Source presentation ID, document ID, or slug").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await Ut("Draft list failed",()=>m("listPresentationVideoProjects",{presentationId:e,teamId:n.teamId}))}),Gl=new Lt("freshness").description("Check whether a video draft is behind its source deck without changing it").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await Ut("Freshness read failed",()=>m("getPresentationVideoFreshness",{projectId:e,teamId:n.teamId}))}),Kl=new Lt("version").description("Read one saved draft snapshot without restoring it").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<version-number>","Saved version number",Hl(1)).option("--team-id <id>","Workspace ID override").action(async function(e,t,n){let r=R(this,n);await Ut("Version read failed",()=>m("getPresentationVideoVersion",{projectId:e,teamId:r.teamId,versionNumber:t}))}),Wl=new Lt("renders").description("List MP4 render attempts newest first, including failures").argument("<project-id>","Presentation-video project UUID or editor slug").option("--limit <number>","Maximum render attempts; omit to return the complete history",Hl(1)).option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await Ut("Render history failed",()=>m("listPresentationVideoRenders",{limit:n.limit,projectId:e,teamId:n.teamId}))}),Jl=new Lt("render").description("Read one render's exact snapshot, asset progress, ordered events, and MP4 URL").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<render-id>","Render attempt UUID from `presentation video renders`").option("--team-id <id>","Workspace ID override").action(async function(e,t,n){let r=R(this,n);await Ut("Render read failed",()=>m("getPresentationVideoRender",{projectId:e,renderId:t,teamId:r.teamId}))}),zl=new Lt("cancel").description("Request cancellation of one in-flight MP4 DurableRun").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<render-id>","In-flight render attempt UUID").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; deterministically derived from both IDs when omitted").action(async function(e,t,n){let r=R(this,n);await Ut("Render cancellation failed",()=>m("cancelPresentationVideoRender",{projectId:e,renderId:t,teamId:r.teamId},r.idempotencyKey??eI(e,t)))});function Hl(e,t=Number.MAX_SAFE_INTEGER){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<e||r>t)throw new Zv(`Expected an integer between ${e} and ${t}.`);return r}}function eI(e,t){return`presentation-video-cancel:${Qv("sha256").update(`${e}\0${t}`).digest("hex")}`}async function Ut(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}import{randomUUID as nI}from"crypto";import{Command as kn}from"commander";import{existsSync as tI}from"fs";var Xl=["bottom-left","bottom-right","top-left","top-right","left-half","right-half","left-overlay","right-overlay","full"];function _t(e){let[t,n]=e.split(":");if(t==="background")return{kind:"background"};if(t==="full")return{kind:"full"};if(t==="split"){if(n!=="left"&&n!=="right")throw new Error("--placement split needs a side: split:left or split:right.");return{kind:"split",side:n}}if(t==="box"){if(!n||!Xl.includes(n))throw new Error(`--placement box needs an anchor: box:${Xl.join(" | box:")}.`);return{kind:"box",placement:{anchor:n}}}throw new Error("--placement must be background, split:left, split:right, full, or box:<anchor>.")}function Rr(e){if(e.wholeScene&&e.duration!==void 0)throw new Error("--whole-scene and --duration ask for opposite things; pass only one.");let t=e.duration!==void 0||e.start!==void 0||e.wholeScene===!0;if(e.startWord!==void 0){if(t)throw new Error("--start-word replaces --start, --duration and --whole-scene; pass words or seconds, not both.");if(e.clearAnchor)throw new Error("--start-word and --clear-anchor ask for opposites.");if(e.endWord!==void 0&&e.endWord<e.startWord)throw new Error("--end-word must not come before --start-word.");return{anchor:{...e.endWord!==void 0?{endWord:e.endWord}:{},startWord:e.startWord}}}if(e.endWord!==void 0)throw new Error("--end-word needs --start-word.");if(!(!t&&!e.clearAnchor))return{...e.clearAnchor?{anchor:null}:{},...e.wholeScene?{durationSec:null}:e.duration!==void 0?{durationSec:e.duration}:{},...e.start!==void 0?{startSec:e.start}:{}}}function mt(e){return t=>{let n=Number(t);if(!Number.isInteger(n)||n<0)throw new Error(`${e} must be a 0-based narration word index (0, 1, 2, \u2026).`);return n}}function In(e){let t=e.split(",").map(n=>n.trim()).filter(Boolean);if(t.length===0)throw new Error("Provide at least one scene id.");return t}function Te(e){return t=>{let n=Number(t);if(!Number.isFinite(n)||n<0)throw new Error(`${e} must be a number of seconds.`);return n}}async function Cr(e,t={}){if(e.startsWith("https://"))return{url:e};if(e.startsWith("http://"))throw new Error("A layer image URL must use https.");if(tI(e))return{uploadKey:(await Q(e,{idempotencyKey:t.idempotencyKey,storagePrefix:"scene-layers"})).s3Key};if(em(e))return{mediaAssetId:e};throw new Error("--image must be a local file path, an https image URL, or a media-library asset UUID.")}var Sr=["brand","alert"],Ri="::",Yl=";;";function Ei(e){if([e.textTitle,e.textCallout,e.textList].filter(r=>r!==void 0).length>1)throw new Error("Pass only one of --text-title, --text-callout or --text-list; each one is a whole card.");let n=Si(e.tone);if(e.textTitle!==void 0)return{heading:Ci(e.textTitle,"--text-title"),tone:n,variant:"title"};if(e.textCallout!==void 0){let[r,o]=Ql(e.textCallout,Ri);return{...o?.trim()?{body:o.trim()}:{},heading:Ci(r,"--text-callout"),tone:n,variant:"callout"}}if(e.textList!==void 0){let[r,o]=Ql(e.textList,Ri),i=(o??"").split(Yl).map(c=>c.trim()).filter(Boolean);if(i.length===0)throw new Error(`--text-list needs a heading and its points: --text-list "Heading${Ri}first${Yl}second".`);return{heading:Ci(r,"--text-list"),items:i,tone:n,variant:"list"}}if(e.tone!==void 0)throw new Error("--tone describes a text layer; pass it with --text-title, --text-callout or --text-list.")}function Zl(e){let t=Ei({...e,tone:void 0});return t?{body:t.body??null,heading:t.heading,items:t.items??null,...e.tone!==void 0?{tone:Si(e.tone)}:{},variant:t.variant}:e.tone===void 0?void 0:{tone:Si(e.tone)}}function Si(e){if(e===void 0)return"brand";if(e!=="alert"&&e!=="brand")throw new Error(`--tone must be ${Sr.join(" or ")}.`);return e}function Ci(e,t){let n=(e??"").trim();if(!n)throw new Error(`${t} needs the text to show.`);return n}function Ql(e,t){let n=e.indexOf(t);return n<0?[e,void 0]:[e.slice(0,n),e.slice(n+t.length)]}function em(e){return/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(e)}function Ti(e){try{return Rr(e)}catch(t){a(t instanceof Error?t.message:"Invalid layer timing."),process.exit(s.INVALID_INPUT)}}function tm(e){try{return e()}catch(t){a(t instanceof Error?t.message:"Invalid layer text."),process.exit(s.INVALID_INPUT)}}async function Er(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}function Tr(e,t,n){return m("editPresentationVideoDraft",{edit:n,projectId:e,teamId:t.teamId},t.idempotencyKey??nI())}var rI=new kn("add").description("Add one timed layer to one or more scenes").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--scenes <ids>","Comma-separated composition scene ids").option("--video <id>","Reusable library video id").option("--media <id>","Media-library asset id (image or video)").option("--image <file-or-url>","Local image file to upload, or an https image URL").option("--slide <scene-id>","Reuse the image already on that deck scene").option("--text-title <line>","Words on a brand card: one loud line").option("--text-callout <heading::body>",'Words on a brand card: a heading over a paragraph, e.g. "Lockout first::Isolate the source."').option("--text-list <heading::a;;b;;c>","Words on a brand card: a heading over up to three points").option("--tone <tone>",`Text card colour: ${Sr.join(" | ")}`).option("--placement <placement>","background | split:left | split:right | full | box:<anchor> (default background; required for a text layer, which cannot use background)").option("--start <seconds>","Seconds from the scene's first frame",Te("--start")).option("--duration <seconds>","Seconds shown; omit for the whole scene",Te("--duration")).option("--start-word <index>","Start on this narration word (0-based); replaces --start/--duration",mt("--start-word")).option("--end-word <index>","Last narration word shown (inclusive); omit for the whole scene",mt("--end-word")).option("--label <text>",'Studio label, e.g. "Right way"').option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t){let n=R(this,t),r=tm(()=>Ei(n));[n.video,n.media,n.image,n.slide,r].filter(c=>c!==void 0).length!==1&&(a("Pass exactly one of --video, --media, --image, --slide, --text-title, --text-callout or --text-list."),process.exit(s.INVALID_INPUT)),r&&n.placement===void 0&&(a("A text layer needs --placement: split:left, split:right, full, or box:<anchor>. It cannot use background, where words paint under the scrim."),process.exit(s.INVALID_INPUT));let i=Ti(n);await Er("Layer add failed",async()=>{let c=r?{text:r}:n.video?{videoId:n.video}:n.media?{mediaAssetId:n.media}:n.slide?{slideId:n.slide}:await Cr(n.image,{idempotencyKey:n.idempotencyKey});return Tr(e,n,{...n.label?{label:n.label}:{},placement:_t(n.placement??"background"),sceneIds:In(n.scenes),source:c,...i?{timing:i}:{},type:"add_scene_layer"})})}),oI=new kn("update").description("Move, retime, relabel or retype one layer. A picture or a clip is not editable \u2014 add a new layer instead \u2014 but a text layer's words are, because nothing was resolved to produce them").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id").argument("<layer-id>","Layer id from the project read").option("--placement <placement>","background | split:left | split:right | full | box:<anchor>").option("--start <seconds>","Seconds from the scene's first frame",Te("--start")).option("--duration <seconds>","Seconds shown",Te("--duration")).option("--start-word <index>","Start on this narration word (0-based); replaces the seconds flags",mt("--start-word")).option("--end-word <index>","Last narration word shown (inclusive)",mt("--end-word")).option("--clear-anchor","Drop the word anchor and put the layer back on seconds").option("--whole-scene","Clear the length so the layer shows until the scene ends").option("--text-title <line>","Retype a text layer as one loud line").option("--text-callout <heading::body>","Retype a text layer as a heading over a paragraph").option("--text-list <heading::a;;b;;c>","Retype a text layer as a heading over up to three points").option("--tone <tone>",`Text card colour: ${Sr.join(" | ")}`).option("--label <text>","Studio label").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t,n,r){let o=R(this,r),i=Ti(o),c=tm(()=>Zl(o));o.placement===void 0&&i===void 0&&c===void 0&&o.label===void 0&&(a("Provide at least one of --placement, --start, --duration, --whole-scene, --start-word, --clear-anchor, --text-title, --text-callout, --text-list, --tone or --label."),process.exit(s.INVALID_INPUT)),await Er("Layer update failed",()=>Tr(e,o,{...o.label!==void 0?{label:o.label}:{},layerId:n,...o.placement!==void 0?{placement:_t(o.placement)}:{},sceneId:t,...c?{text:c}:{},...i?{timing:i}:{},type:"update_scene_layer"}))}),iI=new kn("remove").description("Remove one layer from one scene").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id").argument("<layer-id>","Layer id from the project read").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t,n,r){let o=R(this,r);await Er("Layer remove failed",()=>Tr(e,o,{layerId:n,sceneId:t,type:"remove_scene_layer"}))}),aI=new kn("copy").description("Copy one layer onto other scenes, optionally with a different placement").argument("<project-id>","Presentation-video project UUID or editor slug").argument("<scene-id>","Composition scene id the layer sits on").argument("<layer-id>","Layer id from the project read").requiredOption("--to <ids>","Comma-separated target scene ids").option("--placement <placement>","background | split:left | split:right | full | box:<anchor>").option("--start <seconds>","Retime the copies: seconds from each scene's first frame",Te("--start")).option("--duration <seconds>","Retime the copies: seconds shown",Te("--duration")).option("--start-word <index>","Retime the copies on each TARGET scene's narration words (0-based)",mt("--start-word")).option("--end-word <index>","Last narration word shown on each target (inclusive)",mt("--end-word")).option("--clear-anchor","Drop the source layer's word anchor on the copies").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(e,t,n,r){let o=R(this,r),i=Ti(o);await Er("Layer copy failed",()=>Tr(e,o,{layerId:n,...o.placement!==void 0?{placement:_t(o.placement)}:{},sceneId:t,...i?{timing:i}:{},toSceneIds:In(o.to),type:"copy_scene_layer"}))}),nm=new kn("layer").description("Add, move, remove or copy the timed layers on a scene").addCommand(rI).addCommand(oI).addCommand(iI).addCommand(aI).addHelpText("after",`
|
|
120
134
|
Examples:
|
|
121
|
-
${
|
|
122
|
-
${
|
|
123
|
-
${
|
|
124
|
-
${
|
|
125
|
-
${
|
|
126
|
-
${
|
|
127
|
-
${
|
|
128
|
-
${
|
|
129
|
-
${
|
|
130
|
-
${
|
|
131
|
-
${
|
|
132
|
-
${
|
|
133
|
-
`);import{randomUUID as
|
|
135
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-1,slide-3 --image ./floor.jpg --placement background --label "Right way"
|
|
136
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-2 --video <video-id> --placement split:left --start 2 --duration 5
|
|
137
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-2 --video <video-id> --placement box:top-right --start-word 12 --end-word 18
|
|
138
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-3 --text-title "Lockout before you service it" --tone alert --placement full
|
|
139
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-2 --text-callout "Lockout/tagout::Isolate the energy source, apply your own lock, and keep the key on you." --placement split:right
|
|
140
|
+
${p.commands[0]} presentation video layer add <project-id> --scenes slide-4 --text-list "Before you start::Isolate;;Lock;;Verify" --placement box:top-right --start-word 4 --end-word 11
|
|
141
|
+
${p.commands[0]} presentation video layer update <project-id> slide-2 layer-abc --text-callout "Lockout/tagout::Isolate, lock, and verify before any service." --tone alert
|
|
142
|
+
${p.commands[0]} presentation video layer update <project-id> slide-1 layer-abc --placement box:top-right
|
|
143
|
+
${p.commands[0]} presentation video layer update <project-id> slide-1 layer-abc --whole-scene
|
|
144
|
+
${p.commands[0]} presentation video layer update <project-id> slide-1 layer-abc --clear-anchor --start 2 --duration 5
|
|
145
|
+
${p.commands[0]} presentation video layer copy <project-id> slide-1 layer-abc --to slide-4,slide-5 --placement full
|
|
146
|
+
${p.commands[0]} presentation video layer remove <project-id> slide-1 layer-abc
|
|
147
|
+
`);import{randomUUID as sI}from"crypto";import{Command as dI}from"commander";var cI=["basic","standard","premium"],rm=new dI("presenter").description("Set one scene to a different avatar/look or preset, or restore the project default").argument("<project-id>","Presentation video project ID").argument("<slide-id>","Slide or intro/outro scene ID").option("--avatar-id <id>","Exact avatar/look ID from presenter list").option("--slide-ids <ids...>","Exact scene IDs to apply atomically; include the slide-id argument").option("--cast-preset-id <id>","Saved cast preset ID").option("--no-apply-preset-voice","Preserve this scene's current voice instead of applying the preset voice").option("--inherit","Remove the override and inherit the project default").option("--render-tier <tier>","Avatar render tier: basic, standard, or premium").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this update").action(async function(e,t,n){let r=R(this,n);try{if(+!!r.avatarId+ +!!r.castPresetId+ +(r.inherit===!0)!==1)throw new Error("Pass exactly one of --avatar-id, --cast-preset-id, or --inherit.");if(r.renderTier&&!r.avatarId)throw new Error("--render-tier can only be used with --avatar-id.");if(r.renderTier&&!cI.includes(r.renderTier))throw new Error("--render-tier must be basic, standard, or premium.");l(await m("setPresentationVideoScenePresenter",{applyPresetVoice:r.castPresetId?r.applyPresetVoice:void 0,avatarId:r.avatarId,castPresetId:r.castPresetId,inherit:r.inherit,projectId:e,renderTier:r.renderTier,slideId:t,slideIds:r.slideIds,teamId:r.teamId},lI(r.idempotencyKey)))}catch(o){a(o instanceof Error?o.message:"Scene presenter update failed"),process.exit(s.GENERAL_ERROR)}});function lI(e){return e||sI()}import{createHash as mI}from"crypto";import{Command as xn}from"commander";var uI=new xn("prepare").description("Start or resume free slide-preview preparation; waits by default for completion").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--no-wait","Return the run ID; recover with presentation video previews status <run-id>").action(async function(e,t){let n=R(this,t);await $r("Preview preparation failed",async()=>{let r=await W(n.teamId),o=await m("preparePresentationVideoPreviews",{projectId:e,teamId:r},n.idempotencyKey??im("prepare",e,r));return n.wait===!1?o:ys(o.runId,r)})}).addHelpText("after",`
|
|
134
148
|
What happens:
|
|
135
149
|
Reuses the draft's checkpointed preview run and prepares only missing deck-slide images.
|
|
136
150
|
Card and reusable-video scenes report not_required. This command is free and does not render MP4.
|
|
137
151
|
|
|
138
152
|
Recovery:
|
|
139
|
-
$ ${
|
|
140
|
-
$ ${
|
|
141
|
-
$ ${
|
|
142
|
-
`),
|
|
153
|
+
$ ${p.commands[0]} presentation video previews status <run-id>
|
|
154
|
+
$ ${p.commands[0]} presentation video previews inspect <project-id>
|
|
155
|
+
$ ${p.commands[0]} presentation video previews retry <project-id> # only after failed/cancelled
|
|
156
|
+
`),pI=new xn("inspect").description("Read preview run progress and horizontal/vertical image metadata for every scene").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await $r("Preview status read failed",()=>m("getPresentationVideoPreviews",{projectId:e,teamId:n.teamId}))}).addHelpText("after",`
|
|
143
157
|
Output:
|
|
144
158
|
summary.status is idle, preparing, ready, failed, or not_required.
|
|
145
159
|
scenes[] reports ready, missing, or not_required plus stored horizontalUrl/verticalUrl.
|
|
146
160
|
run contains the durable run ID, phase, progress, status, and typed public error.
|
|
147
|
-
`),
|
|
161
|
+
`),gI=new xn("retry").description("Retry the attached failed or cancelled preview run from its saved checkpoints").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; generated when omitted").action(async function(e,t){let n=R(this,t);await $r("Preview retry failed",async()=>{let r=await W(n.teamId);return m("retryPresentationVideoPreviews",{projectId:e,teamId:r},n.idempotencyKey??im("retry",e,r))})}).addHelpText("after",`
|
|
148
162
|
Rules:
|
|
149
163
|
Only failed or cancelled preview runs can be retried. Active and completed runs are refused.
|
|
150
164
|
Retry resumes unfinished scenes; it does not rebuild images already stored on the draft.
|
|
151
165
|
|
|
152
166
|
Next:
|
|
153
|
-
$ ${
|
|
154
|
-
`),
|
|
167
|
+
$ ${p.commands[0]} presentation video previews inspect <project-id>
|
|
168
|
+
`),fI=new xn("status").description("Read one preview DurableRun's progress, result, or typed error").argument("<run-id>","Run ID returned by presentation video previews prepare").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await $r("Preview run status failed",()=>I("preparePresentationVideoPreviews",e,n.teamId))}),om=new xn("previews").description("Prepare, inspect, or retry the slide images used by presentation-to-MP4").addCommand(uI).addCommand(pI).addCommand(gI).addCommand(fI);function im(e,t,n){return`presentation-video-previews:${e}:${mI("sha256").update(`${n}\0${t}`).digest("hex")}`}async function $r(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}import{Command as $i}from"commander";var am=new $i("inspect").description("Read a presentation-video project and its ordered scene timeline").argument("<project-id>","Presentation-video project UUID or editor slug").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await m("getPresentationVideoProject",{projectId:e,teamId:n.teamId}))}catch(r){a(r instanceof Error?r.message:"Project read failed"),process.exit(s.GENERAL_ERROR)}}),hI=new $i("list").description("List generated clips and uploaded recordings usable in a presentation video").argument("<project-id>","Target presentation-video project UUID or slug").option("--cursor <cursor>","Opaque cursor from the previous page").option("--limit <number>","Maximum clips to return",yI).option("--query <text>","Filter clips by title").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await m("listReusableVideoClips",{cursor:n.cursor,limit:n.limit,projectId:e,query:n.query,teamId:n.teamId}))}catch(r){a(r instanceof Error?r.message:"Clip list failed"),process.exit(s.GENERAL_ERROR)}}),sm=new $i("library").description("Reusable generated clips and uploaded recordings").addCommand(hI);function yI(e){let t=Number(e);if(!Number.isInteger(t)||t<1||t>100)throw new Error("--limit must be an integer between 1 and 100.");return t}import{randomUUID as bI}from"crypto";import{Command as Ai}from"commander";var wI=["right-way","wrong-way"],vI=new Ai("status").description("Read a presentation-video scene clip run").argument("<run-id>","Run ID returned by presentation video scene-clip generate").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await I("generatePresentationVideoSceneClip",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),II=new Ai("generate").description("Generate a right-way or wrong-way scene clip from a picture and attach it as a layer").argument("<project-id>","Presentation video project ID or slug").requiredOption("--image <file-or-url-or-id>","Local image file to upload, an https image URL, or a media-library asset UUID").requiredOption("--scenes <ids>","Comma-separated composition scene ids the finished clip is attached to").option("--preset <preset>","right-way (correct procedure) or wrong-way (unsafe act, needs --no-real-person). Default right-way").option("--no-real-person","Declare that no real, identifiable person appears in the picture. Required by --preset wrong-way").option("--placement <placement>","background | split:left | split:right | full | box:<anchor> (default background)").option("--start <seconds>","Seconds from the scene's first frame",Te("--start")).option("--layer-duration <seconds>","Seconds the layer is on screen; omit for the whole scene",Te("--layer-duration")).option("--label <text>",'Studio label, e.g. "Right way"').option("--duration-seconds <n>","Clip length, 5 to 15 seconds (default 6)",e=>Number.parseInt(e,10)).option("--prompt <text>","Replace the derived scene description").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this clip request").option("--yes","Confirm the scene-clip charge").action(async function(e,t){let n=R(this,t);if(!n.yes)return a("Pass --yes to confirm generating a paid scene clip.");let r=n.preset??"right-way";wI.includes(r)||(a("--preset must be right-way or wrong-way."),process.exit(s.INVALID_INPUT));let o=n.realPerson===!1;r==="wrong-way"&&!o&&(a("A wrong-way clip stages an unsafe act on whoever is in the picture, so it must never be a real person. Pass --no-real-person to declare the picture people-free."),process.exit(s.INVALID_INPUT)),r!=="wrong-way"&&o&&(a("--no-real-person only applies to --preset wrong-way."),process.exit(s.INVALID_INPUT)),n.durationSeconds!==void 0&&!Number.isInteger(n.durationSeconds)&&(a("--duration-seconds must be a whole number of seconds."),process.exit(s.INVALID_INPUT));try{let i=await Cr(n.image,{idempotencyKey:n.idempotencyKey}),c=Rr({duration:n.layerDuration,start:n.start});l(await m("generatePresentationVideoSceneClip",{destination:{...n.label?{label:n.label}:{},placement:_t(n.placement??"background"),sceneIds:In(n.scenes),...c?{timing:c}:{}},durationSeconds:n.durationSeconds,image:i,preset:r,projectId:e,prompt:n.prompt,teamId:n.teamId,...o?{wrongWay:{noRealPersonInImage:!0}}:{}},n.idempotencyKey??bI()))}catch(i){a(i instanceof Error?i.message:"Scene clip failed"),process.exit(s.GENERAL_ERROR)}}),dm=new Ai("scene-clip").description("Generate scene-clip footage and attach it as a scene layer").addCommand(II).addCommand(vI).addHelpText("after",`
|
|
155
169
|
A wrong-way clip is refused unless you declare the picture people-free with
|
|
156
170
|
--no-real-person. Layers already in the project are managed with
|
|
157
|
-
${
|
|
171
|
+
${p.commands[0]} presentation video layer.
|
|
158
172
|
|
|
159
173
|
Examples:
|
|
160
|
-
${
|
|
161
|
-
${
|
|
162
|
-
${
|
|
163
|
-
`);import{randomUUID as
|
|
174
|
+
${p.commands[0]} presentation video scene-clip generate <project-id> --image ./lathe.jpg --scenes slide-3 --yes
|
|
175
|
+
${p.commands[0]} presentation video scene-clip generate <project-id> --image ./machine.jpg --scenes slide-3,slide-4 --preset wrong-way --no-real-person --placement split:right --yes
|
|
176
|
+
${p.commands[0]} presentation video scene-clip status <run-id>
|
|
177
|
+
`);import{randomUUID as kI}from"crypto";import{Command as Pi}from"commander";var xI=new Pi("render").description("Render one scene of a presentation video to its own MP4").argument("<project-id>","Presentation video project ID or slug").argument("<scene-id>","Composition scene ID to render").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this scene render request").option("--yes","Confirm the scene render charge").action(async function(e,t,n){let r=R(this,n);if(!r.yes)return a("Pass --yes to confirm rendering a paid scene preview. A scene already cached at its current state is free and still needs --yes only when it must be rendered.");try{l(await m("renderPresentationVideoScene",{projectId:e,sceneId:t,teamId:r.teamId},r.idempotencyKey??kI()))}catch(o){a(o instanceof Error?o.message:"Scene render failed"),process.exit(s.GENERAL_ERROR)}}),RI=new Pi("status").description("Read a presentation-video scene render run").argument("<run-id>","Run ID returned by presentation video scene render").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await I("renderPresentationVideoScene",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),cm=new Pi("scene").description("Render and inspect one scene of a presentation video").addCommand(xI).addCommand(RI).addHelpText("after",`
|
|
164
178
|
A scene render produces the same frames the final video uses, so rendering the
|
|
165
179
|
whole video afterwards is not charged for the scenes it reuses. Editing a scene
|
|
166
180
|
invalidates its segment; render it again to see the change.
|
|
167
181
|
|
|
168
182
|
Examples:
|
|
169
|
-
${
|
|
170
|
-
${
|
|
171
|
-
`);import{Command as
|
|
183
|
+
${p.commands[0]} presentation video scene render <project-id> slide-3 --yes
|
|
184
|
+
${p.commands[0]} presentation video scene status <run-id>
|
|
185
|
+
`);import{Command as TI}from"commander";import{readFile as CI}from"fs/promises";import{InvalidArgumentError as lm}from"commander";async function SI(e){let t=e.trim(),n=t.startsWith("{")?t:await CI(t,"utf-8"),r=JSON.parse(n);if(!r||typeof r!="object"||Array.isArray(r))throw new Error("--settings must be a JSON object.");return r}async function mm(e){let t=e.settings?await SI(e.settings):{},n=[e.captionHeight,e.captionWidth,e.captionX,e.captionY].some(i=>i!==void 0),r=[e.captionBackgroundColor,e.captionFontFamily,e.captionFontSize,e.captionHighlightColor,e.captionTextColor].some(i=>i!==void 0),o=[e.presenterAnchor,e.presenterApplyToAll,e.presenterBackground,e.presenterBackgroundFit,e.presenterBackgroundHex,e.presenterBackgroundUrl,e.presenterBorderRadius,e.presenterFramingX,e.presenterFramingY,e.presenterFramingZoom,e.presenterHeight,e.presenterOffsetX,e.presenterOffsetY,e.presenterSize,e.presenterUseDefault,e.presenterVisible,e.presenterX,e.presenterY].some(i=>i!==void 0);if(n&&t.captionPlacement!==void 0)throw new Error("Pass caption placement either as typed flags or inside --settings, not both.");if(r&&t.captionStyle!==void 0)throw new Error("Pass caption style either as typed flags or inside --settings, not both.");if(o&&t.presenter!==void 0)throw new Error("Pass presenter layout either as typed flags or as settings.presenter, not both.");return EI({captionBackgroundColor:e.captionBackgroundColor,captionFontFamily:e.captionFontFamily,captionFontSize:e.captionFontSize,captionHeight:e.captionHeight,captionHighlightColor:e.captionHighlightColor,captionTextColor:e.captionTextColor,captionWidth:e.captionWidth,captionX:e.captionX,captionY:e.captionY,presenterAnchor:e.presenterAnchor,presenterApplyToAll:e.presenterApplyToAll||void 0,presenterBackgroundFit:e.presenterBackgroundFit,presenterBackgroundHex:e.presenterBackgroundHex,presenterBackgroundKind:e.presenterBackground,presenterBackgroundUrl:e.presenterBackgroundUrl,presenterBorderRadius:e.presenterBorderRadius,presenterFramingX:e.presenterFramingX,presenterFramingY:e.presenterFramingY,presenterFramingZoom:e.presenterFramingZoom,presenterHeight:e.presenterHeight,presenterOffsetX:e.presenterOffsetX,presenterOffsetY:e.presenterOffsetY,presenterSize:e.presenterSize,presenterSlideId:e.presenterSlideId,presenterUseDefault:e.presenterUseDefault||void 0,presenterVisible:e.presenterVisible,presenterX:e.presenterX,presenterY:e.presenterY,settings:e.settings?t:void 0})}function H(e,t,n,r=!1){return o=>{let i=Number(o);if(!Number.isFinite(i)||i<t||i>n||r&&!Number.isInteger(i))throw new lm(`${e} must be ${r?"an integer":"a number"} from ${t} to ${n}.`);return i}}function um(e){return t=>{if(t==="true")return!0;if(t==="false")return!1;throw new lm(`${e} must be true or false.`)}}function EI(e){return Object.fromEntries(Object.entries(e).filter(t=>t[1]!==void 0))}var pm=new TI("settings").description("Update saved presentation-video voice, presenter, caption, format, or renderer settings").argument("<project-id>","Presentation video project ID").option("--settings <json-or-path>","Advanced settings patch as JSON or a path to a JSON file").option("--caption-x <ratio>","Caption box center on the horizontal axis, from 0 to 1",H("--caption-x",0,1)).option("--caption-y <ratio>","Caption box center on the vertical axis, from 0 to 1",H("--caption-y",0,1)).option("--caption-width <ratio>","Caption box width as a frame fraction, from 0.18 to 0.95",H("--caption-width",.18,.95)).option("--caption-height <ratio>","Caption box height as a frame fraction, from 0.05 to 0.5",H("--caption-height",.05,.5)).option("--caption-font-family <css-list>","Caption CSS font-family list").option("--caption-font-size <pixels>","Caption font size in pixels, from 20 to 96",H("--caption-font-size",20,96,!0)).option("--caption-text-color <color>","Caption text color: hex, rgb, hsl, transparent, or var()").option("--caption-highlight-color <color>","Current-word highlight color: hex, rgb, hsl, transparent, or var()").option("--caption-background-color <color>","Caption box color: hex, rgb, hsl, transparent, or var()").option("--presenter-slide-id <id>","Target one scene; omit to update the project presenter default").option("--presenter-anchor <anchor>","Presenter anchor: bottom-left, bottom-right, top-left, top-right, left-half, right-half, left-overlay, right-overlay, full, or free",y("--presenter-anchor",["bottom-left","bottom-right","top-left","top-right","left-half","right-half","left-overlay","right-overlay","full","free"])).option("--presenter-size <ratio>","Presenter box width as a frame fraction, from 0.08 to 0.9",H("--presenter-size",.08,.9)).option("--presenter-height <ratio>","Explicit presenter box height as a frame fraction, from 0.05 to 1",H("--presenter-height",.05,1)).option("--presenter-x <ratio>","Horizontal center from 0 to 1; use with --presenter-anchor free",H("--presenter-x",0,1)).option("--presenter-y <ratio>","Vertical center from 0 to 1; use with --presenter-anchor free",H("--presenter-y",0,1)).option("--presenter-offset-x <ratio>","Horizontal edge offset for anchored placement, from 0 to 0.35",H("--presenter-offset-x",0,.35)).option("--presenter-offset-y <ratio>","Vertical edge offset for anchored placement, from 0 to 0.35",H("--presenter-offset-y",0,.35)).option("--presenter-border-radius <ratio>","Corner radius from 0 (square) to 0.5 (circle or pill)",H("--presenter-border-radius",0,.5)).option("--presenter-framing-x <ratio>","Horizontal crop focus inside the presenter box, from 0 to 1",H("--presenter-framing-x",0,1)).option("--presenter-framing-y <ratio>","Vertical crop focus inside the presenter box, from 0 to 1",H("--presenter-framing-y",0,1)).option("--presenter-framing-zoom <ratio>","Crop zoom inside the presenter box, from 1 to 2",H("--presenter-framing-zoom",1,2)).option("--presenter-background <kind>","Background: original, transparent, color, or image",y("--presenter-background",["original","transparent","color","image"])).option("--presenter-background-hex <hex>","Six-digit #RRGGBB value required with --presenter-background color").option("--presenter-background-url <url>","HTTP(S) image required with --presenter-background image").option("--presenter-background-fit <fit>","Image background fit: cover or contain",y("--presenter-background-fit",["cover","contain"])).option("--presenter-visible <true|false>","Show or hide the presenter on --presenter-slide-id",um("--presenter-visible")).option("--presenter-apply-to-all","Make the targeted scene placement the project default and clear placement overrides").option("--presenter-use-default","Remove the targeted scene placement override and use the project default").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this settings update").option("--yes","Confirm updating presentation video settings").action(async function(e,t){let n=R(this,t),r;try{r=await mm(n)}catch(o){a(o instanceof Error?o.message:"Invalid settings patch"),process.exit(s.INVALID_INPUT)}if(Object.keys(r).length===0&&(a("Pass a caption or presenter flag, or --settings <json-or-path>, with the patch to apply."),process.exit(s.INVALID_INPUT)),!n.yes)return a("Pass --yes to confirm updating presentation video settings.");try{let o=await W(n.teamId),i={projectId:e,...r,teamId:o};l(await m("updatePresentationVideoSettings",i,n.idempotencyKey??z({command:"presentation video settings",payload:i,workspaceId:o})))}catch(o){a(o instanceof Error?o.message:"Settings update failed"),process.exit(s.GENERAL_ERROR)}}).addHelpText("after",`
|
|
172
186
|
Caption geometry uses frame-relative values. x/y are the box center; width/height are its size.
|
|
173
187
|
Omitted caption fields keep their saved values. Run presentation video inspect <project-id> to verify them.
|
|
174
188
|
Presenter geometry also uses frame-relative values. Omit --presenter-slide-id to edit the default; pass it for one scene.
|
|
175
189
|
Free placement requires --presenter-anchor free plus both --presenter-x and --presenter-y.
|
|
176
190
|
|
|
177
191
|
Examples:
|
|
178
|
-
${
|
|
179
|
-
${
|
|
180
|
-
${
|
|
181
|
-
${
|
|
182
|
-
${
|
|
183
|
-
`);import{Command as
|
|
192
|
+
${p.commands[0]} presentation video settings <project-id> --caption-y 0.82 --caption-width 0.72 --yes
|
|
193
|
+
${p.commands[0]} presentation video settings <project-id> --caption-font-size 44 --caption-highlight-color '#14c8ff' --yes
|
|
194
|
+
${p.commands[0]} presentation video settings <project-id> --presenter-slide-id <slide-id> --presenter-anchor free --presenter-x 0.7 --presenter-y 0.4 --presenter-size 0.28 --yes
|
|
195
|
+
${p.commands[0]} presentation video settings <project-id> --presenter-slide-id <slide-id> --presenter-apply-to-all --yes
|
|
196
|
+
${p.commands[0]} presentation video settings <project-id> --presenter-background color --presenter-background-hex '#14213d' --yes
|
|
197
|
+
`);import{Command as Rn,InvalidArgumentError as NI}from"commander";import{createHash as $I}from"crypto";import{existsSync as AI,readFileSync as PI}from"fs";import{Command as gm,InvalidArgumentError as fm}from"commander";function OI(e){let t=Number(e);if(!Number.isFinite(t)||t<0||t>1)throw new fm("--volume must be a number from 0 to 1.");return t}function DI(e){let t=Number(e);if(!Number.isInteger(t)||t<1)throw new fm("--file-size must be a positive whole number.");return t}async function hm(e){let{idempotencyKey:t,teamId:n,...r}=e;return m("createPresentationVideoMusicUploadUrl",{...r,teamId:n},t)}var ym=new gm("upload-url").description("Mint a project-scoped audio storage POST; this does not upload bytes or change settings").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--file-name <name>","Original audio filename").requiredOption("--file-type <mime>","Exact audio MIME type").requiredOption("--file-size <bytes>","Exact positive byte size; maximum 104857600",DI).option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; derived from workspace, project, and exact file metadata when omitted").action(async function(e,t){let n=R(this,t);await h();try{let r=await W(n.teamId),o={fileName:n.fileName,fileSize:n.fileSize,fileType:n.fileType,projectId:e};l(await hm({...o,idempotencyKey:n.idempotencyKey??z({command:"presentation video music upload-url",payload:o,workspaceId:r}),teamId:r}))}catch(r){a(r instanceof Error?r.message:"Custom music upload URL creation failed"),process.exit(s.GENERAL_ERROR)}}),bm=new gm("upload").description("Upload local audio, save it as this video's custom music, and verify the draft").argument("<project-id>","Presentation-video project UUID or editor slug").requiredOption("--file <path>","Local audio file to upload").option("--volume <level>","Saved mix level from 0 to 1; default 0.12",OI,.12).option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; derived from workspace, project, exact bytes, MIME, and level when omitted").addHelpText("after",`
|
|
184
198
|
Postcondition: mode=upload, filename, and volume are read back from the saved project. This command never downloads an arbitrary URL.
|
|
185
|
-
`).action(async function(t
|
|
199
|
+
`).action(async function(e,t){let n=R(this,t);await h(),AI(n.file)||(a(`File not found: ${n.file}`),process.exit(s.INVALID_INPUT));try{let r=await W(n.teamId),o=Ze(n.file),i=$I("sha256").update(PI(n.file)).digest("hex"),c={contentSha256:i,...o,projectId:e,volume:n.volume},d=n.idempotencyKey??z({command:"presentation video music upload",payload:c,workspaceId:r}),u=await hm({...o,idempotencyKey:`${d}:upload`,projectId:e,teamId:r}),g=await et(n.file,u),w=await m("updatePresentationVideoSettings",{projectId:u.projectId,settings:{music:{audioUrl:g.url,fileName:g.name,mode:"upload",volume:n.volume}},teamId:r},`${d}:settings`),x=(await m("getPresentationVideoProject",{projectId:u.projectId,teamId:r})).renderSettings.music;if(x.mode!=="upload"||x.uploadedFileName!==o.fileName||x.volume!==n.volume)throw new Error("Custom music upload completed but the saved project did not match it.");l({contentSha256:i,fileName:o.fileName,fileSize:o.fileSize,fileType:o.fileType,music:x,projectId:w.projectId,s3Key:u.s3Key,settings:w.settings.music})}catch(r){a(r instanceof Error?r.message:"Custom music upload failed"),process.exit(s.GENERAL_ERROR)}});function LI(e){let t=Number(e);if(!Number.isInteger(t)||t<1||t>24)throw new NI("--limit must be an integer from 1 to 24.");return t}var UI=new Rn("search").description("Search stock music and return preview URLs plus opaque selection tokens").argument("<query>","Mood, genre, instrument, or other search terms").option("--limit <count>","Return 1 to 24 tracks; default 12",LI).option("--token <token>","Opaque nextToken from the previous page").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await Di("Stock-music search failed",()=>m("searchPresentationVideoStockMusic",{limit:n.limit,query:e,teamId:n.teamId,token:n.token}))}).addHelpText("after",`
|
|
186
200
|
Output:
|
|
187
201
|
tracks[].previewUrl is for audition only. tracks[].selectionToken is opaque and short-lived.
|
|
188
202
|
To save one result, pass its id, name, and selectionToken to stock select.
|
|
189
203
|
|
|
190
204
|
Example:
|
|
191
|
-
$ ${
|
|
192
|
-
`),
|
|
205
|
+
$ ${p.commands[0]} presentation video music stock search "calm ambient" --limit 8
|
|
206
|
+
`),_I=new Rn("select").description("Select one paid stock track; waits by default, saves it, and returns a recovery run ID").argument("<project-id>","Presentation-video project UUID or editor slug").option("--mode <mode>","Selection mode: manual or auto","manual").option("--selection-token <token>","Opaque selectionToken from stock search; manual mode only").option("--track-id <id>","Track id from stock search; manual mode only").option("--track-name <name>","Track name from stock search; manual mode only").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; deterministically derived from workspace and exact selection when omitted").option("--no-wait","Return the run ID; recover with presentation video music stock status <run-id>").action(async function(e,t){let n=R(this,t);if(n.mode!=="manual"&&n.mode!=="auto")return Oi("--mode must be manual or auto.");if(n.mode==="manual"&&(!n.selectionToken||!n.trackId||!n.trackName))return Oi("Manual mode requires --selection-token, --track-id, and --track-name from stock search.");if(n.mode==="auto"&&(n.selectionToken||n.trackId||n.trackName))return Oi("Auto mode derives the choice from the saved deck; omit manual track flags.");await Di("Stock-music selection failed",async()=>{let r=await W(n.teamId),o={mode:n.mode,projectId:e,selectionToken:n.selectionToken,teamId:r,trackId:n.trackId,trackName:n.trackName},i=await m("selectPresentationVideoStockMusic",o,n.idempotencyKey??z({command:"presentation-video-stock-music-select",payload:o,workspaceId:r}));return n.wait===!1?i:hs(i.runId,r)})}).addHelpText("after",`
|
|
193
207
|
Postcondition:
|
|
194
208
|
The completed run persists mode=stock, the durable audio URL, duration, track identity,
|
|
195
209
|
and a new project draft version. It does not render an MP4.
|
|
196
210
|
|
|
197
211
|
Manual:
|
|
198
|
-
$ ${
|
|
212
|
+
$ ${p.commands[0]} presentation video music stock select <project-id> --selection-token <token> --track-id <id> --track-name "Warm Horizon"
|
|
199
213
|
|
|
200
214
|
Auto from saved slide titles and narration:
|
|
201
|
-
$ ${
|
|
202
|
-
`),dv=new gn("status").description("Read stock-music run status/progress, billing, persisted result, or typed failure").argument("<run-id>","Run ID returned by stock select --no-wait").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);await vi("Stock-music status failed",()=>I("selectPresentationVideoStockMusic",t,n.teamId))}),Ll=new gn("music").description("Search and select music sources for an existing video project").addCommand(_l).addCommand(Nl).addCommand(new gn("stock").description("Preview catalog tracks and save a manual or deck-aware automatic selection").addCommand(av).addCommand(sv).addCommand(dv));async function vi(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}function wi(t){a(t),process.exit(d.INVALID_INPUT)}import{readFile as cv}from"fs/promises";async function Ul(t){if(!t)return;let e=t.trim().startsWith("{")?t:await cv(t,"utf8"),n=JSON.parse(e);if(!n||Array.isArray(n)||typeof n!="object")throw new Error("--slide-instructions must be a JSON object or file path");let r={};for(let[o,i]of Object.entries(n)){if(!o.trim()||typeof i!="string")throw new Error("--slide-instructions must map non-empty slide IDs to text");r[o]=i}return r}var lv=new G("status").description("Check a presentation generation run").argument("<run-id>","Run ID returned by presentation generation").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("createSlides",t,e.teamId);if(e.format==="json"){l(n);return}if(e.format==="quiet"){console.log(n.status);return}w(`Status: ${n.status}`),w(n.message),n.progress!==null&&w(`Progress: ${n.progress}%`),n.error&&a(se(n.error))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),mv=new G("delete").description("Permanently delete an owned presentation and its publications").argument("<presentation-id>","Presentation id or slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--yes","Confirm permanent deletion").action(async(t,e)=>{e.yes||(a("Refusing to permanently delete without confirmation. Re-run with --yes."),process.exit(d.GENERAL_ERROR));let n=e.idempotencyKey??z({command:"presentation:delete",payload:{presentationId:t},workspaceId:e.teamId??"configured-default"});try{l(await m("deletePresentation",{approvalReceipt:e.approvalReceipt,presentationId:t,teamId:e.teamId},n))}catch(r){r.errorCode==="approval_required"&&_(`Retry with --idempotency-key ${n}`),a(r instanceof Error?r.message:"Could not delete the presentation"),process.exit(d.GENERAL_ERROR)}}),uv=new G("limits").description("Show the selected workspace's presentation generation limits").option("--team-id <id>","Workspace ID (uses configured default)").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{await y();let e=t.teamId??ee();e||(a("Team ID required. Set one with `mf config set team-id <id>` or pass --team-id."),process.exit(d.GENERAL_ERROR));try{let n=await Qr(e);if(t.format==="json")return l(n);if(t.format==="quiet")return console.log(n.planName);w(`Plan: ${n.planName}`),w(`Available modes: ${n.availableModes.join(", ")||"none"}`),w(`Maximum slides: ${n.maxSlidesPerPresentation}`)}catch(n){a(n instanceof Error?n.message:"Could not read generation limits"),process.exit(d.GENERAL_ERROR)}}),pv=new G("visibility").description("Set an owned presentation's visibility to private, team, or public").argument("<presentation-id>","Presentation ID or slug").argument("<visibility>","private, team, or public",b("visibility",["private","team","public"])).option("--team-id <id>","Workspace ID (uses configured default)").option("--idempotency-key <key>","Stable retry key").action(async(t,e,n)=>{await y();try{l(await Ea(t,{idempotencyKey:n.idempotencyKey,teamId:n.teamId,visibility:e}))}catch(r){a(r instanceof Error?r.message:"Could not update presentation visibility"),process.exit(d.GENERAL_ERROR)}});function ql(t){let e=Number(t);if(!Number.isInteger(e)||e<0)throw new Ii("Expected a non-negative integer.");return e}async function gv(t){let e=t.trim(),n=e.startsWith("[")?e:await jl(e,"utf-8"),r=JSON.parse(n);if(!Array.isArray(r))throw new Ii("--grants must be a JSON array.");for(let o of r)if(!o||typeof o!="object"||typeof o.userId!="string"||!["view","edit"].includes(o.permission))throw new Ii('Every grant must be {"userId":"\u2026","permission":"view|edit"}.');return r}var fv=new G("get").description("Read presentation ownership and team access").requiredOption("--document-id <id>","Presentation document ID").option("--team-id <id>","Workspace ID override").action(async t=>{try{l(await m("getPresentationSharing",{documentId:t.documentId,teamId:t.teamId}))}catch(e){a(e instanceof Error?e.message:"Could not read presentation sharing"),process.exit(d.GENERAL_ERROR)}}),hv=new G("update").description("Replace presentation collaborators and team access").requiredOption("--document-id <id>","Presentation document ID").requiredOption("--expected-revision <number>","Revision returned by presentation sharing get",ql).requiredOption("--team-access <access>","restricted, view, or edit",b("--team-access",["restricted","view","edit"])).requiredOption("--grants <json-or-path>","Complete JSON grant array; use [] to remove all collaborators").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID override").action(async t=>{try{let e=await J(t.teamId),n=await gv(t.grants),r=t.idempotencyKey??z({command:"presentation:sharing:update",payload:{documentId:t.documentId,expectedRevision:t.expectedRevision,grants:n,teamAccess:t.teamAccess},workspaceId:e});l(await m("updatePresentationSharing",{documentId:t.documentId,expectedRevision:t.expectedRevision,grants:n,teamAccess:t.teamAccess,teamId:e},r))}catch(e){a(e instanceof Error?e.message:"Could not update presentation sharing"),process.exit(d.GENERAL_ERROR)}}),yv=new G("sharing").description("Read or update presentation team access").addCommand(fv).addCommand(hv),bv=new G("transfer").description("Transfer a presentation and every saved version").requiredOption("--document-id <id>","Presentation document ID").requiredOption("--to-user-id <id>","Active team editor or admin").requiredOption("--expected-revision <number>","Revision returned by presentation sharing get",ql).option("--previous-owner-access <access>","Keep edit access or remove access",b("--previous-owner-access",["edit","remove"]),"edit").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID override").action(async t=>{try{let e=await J(t.teamId),n=t.idempotencyKey??z({command:"presentation:transfer",payload:{documentId:t.documentId,expectedRevision:t.expectedRevision,previousOwnerAccess:t.previousOwnerAccess,toUserId:t.toUserId},workspaceId:e});l(await m("transferPresentationOwnership",{documentId:t.documentId,expectedRevision:t.expectedRevision,previousOwnerAccess:t.previousOwnerAccess,teamId:e,toUserId:t.toUserId},n))}catch(e){a(e instanceof Error?e.message:"Could not transfer presentation ownership"),process.exit(d.GENERAL_ERROR)}}),wv=new G("transform").description("Transform an uploaded PowerPoint import for review").argument("<import-id>","PowerPoint import ID returned by Mindframes").option("--idempotency-key <key>","Stable retry key").action(async function(t,e){let n=R(this,e);try{let r=await m("transformPresentationImport",{importId:t},n.idempotencyKey);l(r)}catch(r){a(r instanceof Error?r.message:"Transform failed"),process.exit(d.GENERAL_ERROR)}}),vv=new G("status").description("Read a PowerPoint import run").argument("<run-id>","Run ID returned by PowerPoint import").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("importPowerPoint",t,e.teamId);e.format==="json"?l(n):e.format==="quiet"?console.log(n.status):(w(`Status: ${n.status}`),w(n.message),n.error&&a(se(n.error)))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Vl=new G("import").description("Import a PowerPoint through the review-gated reconstruction pipeline").option("--file <path>","Path to the .pptx to import").option("--filename <name>","Override the uploaded filename").option("--mode <mode>","Import mode: preserve or rebrand","preserve").option("--branding-id <id>","Saved brand ID (required for rebrand mode)").option("--source-chat-id <id>","Associate the import with an existing chat").option("--title <title>","Presentation title").option("--idempotency-key <key>","Stable retry key").action(async t=>{if(!t.file){Vl.help();return}t.file.toLowerCase().endsWith(".pptx")||(a("PowerPoint import requires a .pptx file."),process.exit(d.INVALID_INPUT));try{let e=await de(t.file),n=await m("importPowerPoint",{brandingId:t.brandingId,filename:t.filename??e.name,mode:t.mode,sourceChatId:t.sourceChatId,sourceUrl:e.url,title:t.title},t.idempotencyKey??Ir());l(n)}catch(e){a(e instanceof Error?e.message:"Import failed"),process.exit(d.GENERAL_ERROR)}}).addCommand(wv).addCommand(vv),Iv=new G("speaker-notes-status").description("Check a speaker-notes generation run").argument("<run-id>","Run ID returned by speaker-notes generation").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("generateSpeakerNotes",t,e.teamId);e.format==="json"?l(n):e.format==="quiet"?console.log(n.status):(w(`Status: ${n.status}`),w(n.message))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),xv=new G("video-narration-status").description("Check a presentation-video narration regeneration run").argument("<run-id>","Run ID returned by video-narration").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await I("regeneratePresentationVideoNarration",t,e.teamId);e.format==="json"?l(n):e.format==="quiet"?console.log(n.status):(w(`Status: ${n.status}`),w(n.message))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),kv=new G("status").description("Read a presentation-video MP4 render run").argument("<run-id>","Run ID returned by presentation video").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);try{l(await I("createPresentationVideo",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Rv=new G("prepare").description("Create or reuse a presentation-video project for a presentation").argument("<presentation-id>","Presentation ID, document ID, or slug").option("--force-new","Create a fresh video project even if the current presentation version already has one").option("--narrate","Also generate the narration the project is missing (costs credits; requires --yes)").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this prepare request").option("--yes","Confirm the narration charge when --narrate is used").action(async function(t,e){let n=R(this,e);if(n.narrate&&!n.yes)return a("Pass --yes to confirm. --narrate generates speaker notes and costs credits.");try{l(await m("preparePresentationVideo",{forceNew:n.forceNew,narrate:n.narrate,presentationId:t,teamId:n.teamId},n.idempotencyKey??Ir()))}catch(r){a(r instanceof Error?r.message:"Prepare failed"),process.exit(d.GENERAL_ERROR)}}),Cv=new G("status").description("Read a presentation-video narration run").argument("<run-id>","Run ID returned by presentation video narrate").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=R(this,e);try{l(await I("ensurePresentationVideoNarration",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Sv=new G("narrate").description("Generate the narration a presentation-video project is still missing").argument("<project-id>","Presentation video project ID").option("--no-wait","Return immediately with the durable run ID").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this narration request").option("--yes","Confirm the narration charge").action(async function(t,e){let n=R(this,e);if(!n.yes)return a("Pass --yes to confirm. Generating narration costs credits.");try{let r=await m("ensurePresentationVideoNarration",{projectId:t,teamId:n.teamId},n.idempotencyKey??Ir());if(n.wait===!1||r.runStatus==="completed"){l(r);return}l(r),await xi(r.runId,"presentation video narrate status",()=>An(r.runId))}catch(r){a(r instanceof Error?r.message:"Narration failed"),process.exit(d.GENERAL_ERROR)}}).addCommand(Cv),Ev=new G("video").description("Create an MP4 video from a presentation").argument("[presentation-id]","Presentation ID, document ID, or slug").option("--project-id <id>","Advanced: render an already-configured presentation video project").option("--settings <json-or-path>","Settings patch as JSON or a path to a JSON file; only valid with presentation-id").option("--force-new","Create a fresh video project even if the current presentation version already has one").option("--force-rerender","Start a new MP4 render even when the current project fingerprint has a completed render").option("--render-engine <engine>","Renderer for this MP4 only: remotion (Standard) or hyperframes (Premium)").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this render request").option("--yes","Confirm starting the MP4 render").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to confirm presentation video rendering.");try{if(!t&&!e.projectId)throw new Error("Pass a presentation id or --project-id.");if(t&&e.projectId)throw new Error("Pass either presentation id or --project-id, not both.");if(e.projectId&&(e.settings||e.forceNew))throw new Error("--settings and --force-new require a presentation id, not --project-id.");if(e.renderEngine&&e.renderEngine!=="remotion"&&e.renderEngine!=="hyperframes")throw new Error("--render-engine must be remotion or hyperframes.");l(await m("createPresentationVideo",{forceNew:e.forceNew,forceRerender:e.forceRerender,presentationId:t,projectId:e.projectId,renderEngine:e.renderEngine,settings:e.settings?await $v(e.settings):void 0,teamId:e.teamId},e.idempotencyKey))}catch(n){let r=n instanceof Error?n.message:"Render failed";a(r);let o=ha({binary:u.commands[0],message:r,projectId:e.projectId});o&&ia(o),process.exit(d.GENERAL_ERROR)}}).addCommand(Rv).addCommand(Sv).addCommand(kl).addCommand(nl).addCommand(Ll).addCommand(al).addCommand(sl).addCommand(vl).addCommand(Il).addCommand(il).addCommand(ol).addCommand(Al).addCommand(wl).addCommand(Cl).addCommand(Sl).addCommand(kv).addCommand(ll).addCommand(cl).addCommand(ml).addCommand(dl).addCommand(rl);async function $v(t){let e=t.trim(),n=e.startsWith("{")?e:await jl(e,"utf-8"),r=JSON.parse(n);if(!r||typeof r!="object"||Array.isArray(r))throw new Error("--settings must be a JSON object.");return r}function Tv(t,e){return[...e,t]}var Av=new G("speaker-notes").description("Generate paid speaker notes; waits by default and requires --yes").argument("<presentation-id>","Presentation ID or slug").option("--mode <mode>","ensure or regenerate","ensure").option("--style <style>","concise or detailed","concise").option("--density <density>","Narration density: brief, balanced, or deep").option("--instructions <text>","Instructions for every selected slide").option("--language <language>","Output language").option("--slide-id <id>","Target one slide (repeatable)",Tv,[]).option("--slide-instructions <json-or-path>","Per-slide instructions as a JSON object or JSON file path").option("--no-follow","Return the run ID; recover with presentation speaker-notes-status <run-id>").option("--yes","Confirm the speaker-notes generation charge").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this speaker-notes request").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{if(!e.yes)throw new Error("Pass --yes to confirm. Generating speaker notes costs credits.");if(!["ensure","regenerate"].includes(e.mode))throw new Error("--mode must be ensure or regenerate");if(!["concise","detailed"].includes(e.style))throw new Error("--style must be concise or detailed");if(e.density&&!["brief","balanced","deep"].includes(e.density))throw new Error("--density must be brief, balanced, or deep");let n=await J(e.teamId),r={density:e.density??(e.style==="detailed"?"deep":"balanced"),instructions:e.instructions,language:e.language,mode:e.mode,slideIds:e.slideId.length?e.slideId:void 0,slideInstructions:await Ul(e.slideInstructions)},o=await Ca(t,r,e.idempotencyKey??z({command:"presentation speaker-notes",payload:r,workspaceId:n}),n);if(e.format==="json"||!e.follow){l(o);return}w(`Speaker notes run: ${o.runId}`),await xi(o.runId,"presentation speaker-notes-status",()=>An(o.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Pv=new G("video-narration").description("Regenerate one slide narration in a presentation video draft").argument("<project-id>","Presentation video project ID").requiredOption("--slide-id <id>","Slide ID in the video draft").option("--instructions <text>","Optional regeneration instructions").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--no-follow","Return immediately with the durable run ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async function(t,e){try{let n=R(this,e),r=await J(n.teamId),o={instructions:e.instructions,projectId:t,slideId:e.slideId,teamId:r},i=await m("regeneratePresentationVideoNarration",o,n.idempotencyKey??Ir());if(e.format==="json"||!e.follow){l(i);return}w(`Narration run: ${i.runId}`),await xi(i.runId,"presentation video-narration-status",()=>An(i.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});async function xi(t,e,n){let r=null;try{r=await Dv(await n())}catch(o){let i=o instanceof Error&&o.message.trim()?o.message.trim():"the event stream ended unexpectedly";_(`Stopped following run ${t}: ${i}. The run is unaffected \u2014 check it with '${u.commands[0]} ${e} ${t}'.`);return}if(r)throw new Error(`Run ${t} ${r.status}: ${r.message} Inspect it with '${u.commands[0]} ${e} ${t}'.`)}function Ov(t){let e=t.eventType;if(e==="run.completed"||e==="durable_run.completed")return"completed";let n=e==="run.failed"||e==="durable_run.failed"?"failed":e==="run.cancelled"||e==="durable_run.cancelled"?"cancelled":null;return n?{message:t.payload?.message?.trim()||t.message?.trim()||"the run reported no error message",status:n}:null}async function Dv(t){let e=t.body?.getReader();if(!e)throw new Error("Speaker notes event stream is unavailable");let n=new TextDecoder,r="",o=null;for(;;){let{done:i,value:s}=await e.read();r+=n.decode(s,{stream:!i});let c=r.split(`
|
|
215
|
+
$ ${p.commands[0]} presentation video music stock select <project-id> --mode auto
|
|
216
|
+
`),qI=new Rn("status").description("Read stock-music run status/progress, billing, persisted result, or typed failure").argument("<run-id>","Run ID returned by stock select --no-wait").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);await Di("Stock-music status failed",()=>I("selectPresentationVideoStockMusic",e,n.teamId))}),wm=new Rn("music").description("Search and select music sources for an existing video project").addCommand(bm).addCommand(ym).addCommand(new Rn("stock").description("Preview catalog tracks and save a manual or deck-aware automatic selection").addCommand(UI).addCommand(_I).addCommand(qI));async function Di(e,t){try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(s.GENERAL_ERROR)}}function Oi(e){a(e),process.exit(s.INVALID_INPUT)}import{readFile as jI}from"fs/promises";async function vm(e){if(!e)return;let t=e.trim().startsWith("{")?e:await jI(e,"utf8"),n=JSON.parse(t);if(!n||Array.isArray(n)||typeof n!="object")throw new Error("--slide-instructions must be a JSON object or file path");let r={};for(let[o,i]of Object.entries(n)){if(!o.trim()||typeof i!="string")throw new Error("--slide-instructions must map non-empty slide IDs to text");r[o]=i}return r}var VI=new K("status").description("Check a presentation generation run").argument("<run-id>","Run ID returned by presentation generation").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await I("createSlides",e,t.teamId);if(t.format==="json"){l(n);return}if(t.format==="quiet"){console.log(n.status);return}b(`Status: ${n.status}`),b(n.message),n.progress!==null&&b(`Progress: ${n.progress}%`),n.error&&a(ue(n.error))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),MI=new K("delete").description("Permanently delete an owned presentation and its publications").argument("<presentation-id>","Presentation id or slug").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--yes","Confirm permanent deletion").action(async(e,t)=>{t.yes||(a("Refusing to permanently delete without confirmation. Re-run with --yes."),process.exit(s.GENERAL_ERROR));let n=t.idempotencyKey??z({command:"presentation:delete",payload:{presentationId:e},workspaceId:t.teamId??"configured-default"});try{l(await m("deletePresentation",{approvalReceipt:t.approvalReceipt,presentationId:e,teamId:t.teamId},n))}catch(r){r.errorCode==="approval_required"&&L(`Retry with --idempotency-key ${n}`),a(r instanceof Error?r.message:"Could not delete the presentation"),process.exit(s.GENERAL_ERROR)}}),BI=new K("limits").description("Show the selected workspace's presentation generation limits").option("--team-id <id>","Workspace ID (uses configured default)").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{await h();let t=e.teamId??te();t||(a("Team ID required. Set one with `mf config set team-id <id>` or pass --team-id."),process.exit(s.GENERAL_ERROR));try{let n=await lo(t);if(e.format==="json")return l(n);if(e.format==="quiet")return console.log(n.planName);b(`Plan: ${n.planName}`),b(`Available modes: ${n.availableModes.join(", ")||"none"}`),b(`Maximum slides: ${n.maxSlidesPerPresentation}`)}catch(n){a(n instanceof Error?n.message:"Could not read generation limits"),process.exit(s.GENERAL_ERROR)}}),FI=new K("visibility").description("Set an owned presentation's visibility to private, team, or public").argument("<presentation-id>","Presentation ID or slug").argument("<visibility>","private, team, or public",y("visibility",["private","team","public"])).option("--team-id <id>","Workspace ID (uses configured default)").option("--idempotency-key <key>","Stable retry key").action(async(e,t,n)=>{await h();try{l(await Ga(e,{idempotencyKey:n.idempotencyKey,teamId:n.teamId,visibility:t}))}catch(r){a(r instanceof Error?r.message:"Could not update presentation visibility"),process.exit(s.GENERAL_ERROR)}});function km(e){let t=Number(e);if(!Number.isInteger(t)||t<0)throw new Ni("Expected a non-negative integer.");return t}async function GI(e){let t=e.trim(),n=t.startsWith("[")?t:await Im(t,"utf-8"),r=JSON.parse(n);if(!Array.isArray(r))throw new Ni("--grants must be a JSON array.");for(let o of r)if(!o||typeof o!="object"||typeof o.userId!="string"||!["view","edit"].includes(o.permission))throw new Ni('Every grant must be {"userId":"\u2026","permission":"view|edit"}.');return r}var KI=new K("get").description("Read presentation ownership and team access").requiredOption("--document-id <id>","Presentation document ID").option("--team-id <id>","Workspace ID override").action(async e=>{try{l(await m("getPresentationSharing",{documentId:e.documentId,teamId:e.teamId}))}catch(t){a(t instanceof Error?t.message:"Could not read presentation sharing"),process.exit(s.GENERAL_ERROR)}}),WI=new K("update").description("Replace presentation collaborators and team access").requiredOption("--document-id <id>","Presentation document ID").requiredOption("--expected-revision <number>","Revision returned by presentation sharing get",km).requiredOption("--team-access <access>","restricted, view, or edit",y("--team-access",["restricted","view","edit"])).requiredOption("--grants <json-or-path>","Complete JSON grant array; use [] to remove all collaborators").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID override").action(async e=>{try{let t=await W(e.teamId),n=await GI(e.grants),r=e.idempotencyKey??z({command:"presentation:sharing:update",payload:{documentId:e.documentId,expectedRevision:e.expectedRevision,grants:n,teamAccess:e.teamAccess},workspaceId:t});l(await m("updatePresentationSharing",{documentId:e.documentId,expectedRevision:e.expectedRevision,grants:n,teamAccess:e.teamAccess,teamId:t},r))}catch(t){a(t instanceof Error?t.message:"Could not update presentation sharing"),process.exit(s.GENERAL_ERROR)}}),JI=new K("sharing").description("Read or update presentation team access").addCommand(KI).addCommand(WI),zI=new K("transfer").description("Transfer a presentation and every saved version").requiredOption("--document-id <id>","Presentation document ID").requiredOption("--to-user-id <id>","Active team editor or admin").requiredOption("--expected-revision <number>","Revision returned by presentation sharing get",km).option("--previous-owner-access <access>","Keep edit access or remove access",y("--previous-owner-access",["edit","remove"]),"edit").option("--idempotency-key <key>","Stable retry key").option("--team-id <id>","Workspace ID override").action(async e=>{try{let t=await W(e.teamId),n=e.idempotencyKey??z({command:"presentation:transfer",payload:{documentId:e.documentId,expectedRevision:e.expectedRevision,previousOwnerAccess:e.previousOwnerAccess,toUserId:e.toUserId},workspaceId:t});l(await m("transferPresentationOwnership",{documentId:e.documentId,expectedRevision:e.expectedRevision,previousOwnerAccess:e.previousOwnerAccess,teamId:t,toUserId:e.toUserId},n))}catch(t){a(t instanceof Error?t.message:"Could not transfer presentation ownership"),process.exit(s.GENERAL_ERROR)}}),HI=new K("transform").description("Transform an uploaded PowerPoint import for review").argument("<import-id>","PowerPoint import ID returned by Mindframes").option("--idempotency-key <key>","Stable retry key").action(async function(e,t){let n=R(this,t);try{let r=await m("transformPresentationImport",{importId:e},n.idempotencyKey);l(r)}catch(r){a(r instanceof Error?r.message:"Transform failed"),process.exit(s.GENERAL_ERROR)}});function xm(e){return new K(e.name).description(e.description).argument("<run-id>","Run ID returned by PowerPoint import").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(t,n)=>{try{let r=await I(e.capabilityId,t,n.teamId);n.format==="json"?l(r):n.format==="quiet"?console.log(r.status):(b(`Status: ${r.status}`),b(r.message),r.error&&a(ue(r.error)))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}})}var XI=xm({capabilityId:"importPowerPoint",description:"Read a PowerPoint import run",name:"status"}),YI=xm({capabilityId:"transformPresentationImport",description:"Read a PowerPoint transform run",name:"transform-status"}),Rm=new K("import").description("Import a PowerPoint through the review-gated reconstruction pipeline").option("--file <path>","Path to the .pptx to import").option("--filename <name>","Override the uploaded filename").option("--mode <mode>","Import mode: preserve or rebrand","preserve").option("--branding-id <id>","Saved brand ID (required for rebrand mode)").option("--source-chat-id <id>","Associate the import with an existing chat").option("--title <title>","Presentation title").option("--idempotency-key <key>","Stable retry key").action(async e=>{if(!e.file){Rm.help();return}e.file.toLowerCase().endsWith(".pptx")||(a("PowerPoint import requires a .pptx file."),process.exit(s.INVALID_INPUT));try{let t=await Q(e.file,{idempotencyKey:e.idempotencyKey}),n=await m("importPowerPoint",{brandingId:e.brandingId,filename:e.filename??t.name,mode:e.mode,sourceChatId:e.sourceChatId,sourceUrl:t.url,title:e.title},e.idempotencyKey??Ar());l(n)}catch(t){a(t instanceof Error?t.message:"Import failed"),process.exit(s.GENERAL_ERROR)}}).addCommand(HI).addCommand(XI).addCommand(YI),QI=new K("speaker-notes-status").description("Check a speaker-notes generation run").argument("<run-id>","Run ID returned by speaker-notes generation").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await I("generateSpeakerNotes",e,t.teamId);t.format==="json"?l(n):t.format==="quiet"?console.log(n.status):(b(`Status: ${n.status}`),b(n.message))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),ZI=new K("video-narration-status").description("Check a presentation-video narration regeneration run").argument("<run-id>","Run ID returned by video-narration").option("--team-id <id>","Workspace ID override").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await I("regeneratePresentationVideoNarration",e,t.teamId);t.format==="json"?l(n):t.format==="quiet"?console.log(n.status):(b(`Status: ${n.status}`),b(n.message))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),ek=new K("status").description("Read a presentation-video MP4 render run").argument("<run-id>","Run ID returned by presentation video").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await I("createPresentationVideo",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),tk=new K("prepare").description("Create or reuse a presentation-video project for a presentation").argument("<presentation-id>","Presentation ID, document ID, or slug").option("--force-new","Create a fresh video project even if the current presentation version already has one").option("--narrate","Also generate the narration the project is missing (costs credits; requires --yes)").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this prepare request").option("--yes","Confirm the narration charge when --narrate is used").action(async function(e,t){let n=R(this,t);if(n.narrate&&!n.yes)return a("Pass --yes to confirm. --narrate generates speaker notes and costs credits.");try{l(await m("preparePresentationVideo",{forceNew:n.forceNew,narrate:n.narrate,presentationId:e,teamId:n.teamId},n.idempotencyKey??Ar()))}catch(r){a(r instanceof Error?r.message:"Prepare failed"),process.exit(s.GENERAL_ERROR)}}),nk=new K("status").description("Read a presentation-video narration run").argument("<run-id>","Run ID returned by presentation video narrate").option("--team-id <id>","Workspace ID override").action(async function(e,t){let n=R(this,t);try{l(await I("ensurePresentationVideoNarration",e,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),rk=new K("narrate").description("Generate the narration a presentation-video project is still missing").argument("<project-id>","Presentation video project ID").option("--no-wait","Return immediately with the durable run ID").option("--slide-id <id>","Regenerate one changed or new slide; repeat for more",Cm,[]).option("--keep-current","Keep all current narration and generate no slide text").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this narration request").option("--yes","Confirm the narration charge").action(async function(e,t){let n=R(this,t);if(n.keepCurrent&&n.slideId?.length)return a("Use either --keep-current or --slide-id, not both.");if(!n.yes&&!n.keepCurrent)return a("Pass --yes to confirm. Generating narration costs credits.");try{let r=await m("ensurePresentationVideoNarration",{projectId:e,...n.keepCurrent?{slideIds:[]}:n.slideId?.length?{slideIds:n.slideId}:{},teamId:n.teamId},n.idempotencyKey??Ar());if(n.wait===!1||r.runStatus==="completed"){l(r);return}l(r),await Li(r.runId,"presentation video narrate status",()=>qn(r.runId))}catch(r){a(r instanceof Error?r.message:"Narration failed"),process.exit(s.GENERAL_ERROR)}}).addCommand(nk),ok=new K("video").description("Create an MP4 video from a presentation").argument("[presentation-id]","Presentation ID, document ID, or slug").option("--project-id <id>","Advanced: render an already-configured presentation video project").option("--settings <json-or-path>","Settings patch as JSON or a path to a JSON file; only valid with presentation-id").option("--force-new","Create a fresh video project even if the current presentation version already has one").option("--force-rerender","Start a new MP4 render even when the current project fingerprint has a completed render").option("--render-engine <engine>","Renderer for this MP4 only: remotion (Standard) or hyperframes (Premium)").option("--no-slide-animations","Premium renderer only: render every slide fully composed from its first frame instead of building it in as it is narrated").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this render request").option("--yes","Confirm starting the MP4 render").action(async(e,t)=>{if(!t.yes)return a("Pass --yes to confirm presentation video rendering.");try{if(!e&&!t.projectId)throw new Error("Pass a presentation id or --project-id.");if(e&&t.projectId)throw new Error("Pass either presentation id or --project-id, not both.");if(t.projectId&&(t.settings||t.forceNew))throw new Error("--settings and --force-new require a presentation id, not --project-id.");if(t.renderEngine&&t.renderEngine!=="remotion"&&t.renderEngine!=="hyperframes")throw new Error("--render-engine must be remotion or hyperframes.");l(await m("createPresentationVideo",{forceNew:t.forceNew,forceRerender:t.forceRerender,presentationId:e,projectId:t.projectId,renderEngine:t.renderEngine,settings:t.settings?await ik(t.settings):void 0,slideAnimations:t.slideAnimations===!1?!1:void 0,teamId:t.teamId},t.idempotencyKey))}catch(n){let r=n instanceof Error?n.message:"Render failed";a(r);let o=Oa({binary:p.commands[0],message:r,projectId:t.projectId});o&&Ia(o),process.exit(s.GENERAL_ERROR)}}).addCommand(tk).addCommand(rk).addCommand(am).addCommand(jl).addCommand(wm).addCommand(Ll).addCommand(Ul).addCommand(Fl).addCommand(Gl).addCommand(rm).addCommand(om).addCommand(Bl).addCommand(Ml).addCommand(pm).addCommand(nm).addCommand(dm).addCommand(cm).addCommand(ek).addCommand(Jl).addCommand(Wl).addCommand(zl).addCommand(Kl).addCommand(Vl);async function ik(e){let t=e.trim(),n=t.startsWith("{")?t:await Im(t,"utf-8"),r=JSON.parse(n);if(!r||typeof r!="object"||Array.isArray(r))throw new Error("--settings must be a JSON object.");return r}function Cm(e,t){return[...t,e]}var ak=new K("speaker-notes").description("Generate paid speaker notes; waits by default and requires --yes").argument("<presentation-id>","Presentation ID or slug").option("--mode <mode>","ensure or regenerate","ensure").option("--style <style>","concise or detailed","concise").option("--density <density>","Narration density: brief, balanced, or deep").option("--instructions <text>","Instructions for every selected slide").option("--language <language>","Output language").option("--slide-id <id>","Target one slide (repeatable)",Cm,[]).option("--slide-instructions <json-or-path>","Per-slide instructions as a JSON object or JSON file path").option("--no-follow","Return the run ID; recover with presentation speaker-notes-status <run-id>").option("--yes","Confirm the speaker-notes generation charge").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key for this speaker-notes request").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{if(!t.yes)throw new Error("Pass --yes to confirm. Generating speaker notes costs credits.");if(!["ensure","regenerate"].includes(t.mode))throw new Error("--mode must be ensure or regenerate");if(!["concise","detailed"].includes(t.style))throw new Error("--style must be concise or detailed");if(t.density&&!["brief","balanced","deep"].includes(t.density))throw new Error("--density must be brief, balanced, or deep");let n=await W(t.teamId),r={density:t.density??(t.style==="detailed"?"deep":"balanced"),instructions:t.instructions,language:t.language,mode:t.mode,slideIds:t.slideId.length?t.slideId:void 0,slideInstructions:await vm(t.slideInstructions)},o=await Ba(e,r,t.idempotencyKey??z({command:"presentation speaker-notes",payload:r,workspaceId:n}),n);if(t.format==="json"||!t.follow){l(o);return}b(`Speaker notes run: ${o.runId}`),await Li(o.runId,"presentation speaker-notes-status",()=>qn(o.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),sk=new K("video-narration").description("Regenerate one scene or an exact scene batch in a presentation video draft").argument("<project-id>","Presentation video project ID").option("--slide-id <id>","One slide ID in the video draft").option("--slide-ids <ids...>","Exact scene IDs for one durable batch").option("--instructions <text>","Optional regeneration instructions").option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--no-follow","Return immediately with the durable run ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async function(e,t){try{let n=R(this,t),r=await W(n.teamId),o={instructions:t.instructions,projectId:e,slideId:t.slideId,slideIds:t.slideIds,teamId:r},i=await m("regeneratePresentationVideoNarration",o,n.idempotencyKey??Ar());if(t.format==="json"||!t.follow){l(i);return}b(`Narration run: ${i.runId}`),await Li(i.runId,"presentation video-narration-status",()=>qn(i.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}});async function Li(e,t,n){let r=null;try{r=await ck(await n())}catch(o){let i=o instanceof Error&&o.message.trim()?o.message.trim():"the event stream ended unexpectedly";L(`Stopped following run ${e}: ${i}. The run is unaffected \u2014 check it with '${p.commands[0]} ${t} ${e}'.`);return}if(r)throw new Error(`Run ${e} ${r.status}: ${r.message} Inspect it with '${p.commands[0]} ${t} ${e}'.`)}function dk(e){let t=e.eventType;if(t==="run.completed"||t==="durable_run.completed")return"completed";let n=t==="run.failed"||t==="durable_run.failed"?"failed":t==="run.cancelled"||t==="durable_run.cancelled"?"cancelled":null;return n?{message:e.payload?.message?.trim()||e.message?.trim()||"the run reported no error message",status:n}:null}async function ck(e){let t=e.body?.getReader();if(!t)throw new Error("Speaker notes event stream is unavailable");let n=new TextDecoder,r="",o=null;for(;;){let{done:i,value:c}=await t.read();r+=n.decode(c,{stream:!i});let d=r.split(`
|
|
203
217
|
|
|
204
|
-
`);r=
|
|
205
|
-
`).find(x=>x.startsWith("data:"))?.slice(5).trim();if(!
|
|
218
|
+
`);r=d.pop()??"";for(let u of d){let g=u.split(`
|
|
219
|
+
`).find(x=>x.startsWith("data:"))?.slice(5).trim();if(!g)continue;let w=JSON.parse(g);w.eventType?.startsWith("slide.")&&b(`${w.eventType}${w.payload?.slideId?` \xB7 ${w.payload.slideId}`:""}`);let v=dk(w);v==="completed"?o=null:v&&(o=v)}if(i)return o}}var Ui=new K("presentation").description("Create an MP4 video from a finished presentation, plus speaker notes, PowerPoint import, and run status").addCommand(VI).addCommand(bo()).addCommand(BI).addCommand(FI).addCommand(JI).addCommand(zI).addCommand(MI).addCommand(Rm).addCommand(ak).addCommand(QI).addCommand(ok).addCommand(sk).addCommand(ZI);Ui.addHelpText("after",`
|
|
206
220
|
${V.bold("Deck to MP4:")}
|
|
207
|
-
$ ${
|
|
208
|
-
$ ${
|
|
209
|
-
$ ${
|
|
210
|
-
$ ${
|
|
211
|
-
$ ${
|
|
221
|
+
$ ${p.commands[0]} presentation video prepare <slug> ${V.gray("# create/reuse the video project (free)")}
|
|
222
|
+
$ ${p.commands[0]} presentation video narrate <project-id> --yes ${V.gray("# fill in missing narration")}
|
|
223
|
+
$ ${p.commands[0]} presentation video inspect <project-id> ${V.gray("# review the scene timeline")}
|
|
224
|
+
$ ${p.commands[0]} presentation video <slug> --yes ${V.gray("# start the MP4 render")}
|
|
225
|
+
$ ${p.commands[0]} presentation video status <run-id> ${V.gray("# follow the render")}
|
|
212
226
|
|
|
213
227
|
${V.bold("Voice and avatar defaults:")}
|
|
214
228
|
${V.gray("# prepare picks the narration voice for you \u2014 the one this user last")}
|
|
@@ -219,9 +233,9 @@ ${V.bold("Voice and avatar defaults:")}
|
|
|
219
233
|
${V.gray('# No avatar is chosen, on purpose: "slides with a voiceover" is the')}
|
|
220
234
|
${V.gray("# normal outcome, so presenter: null is finished, not misconfigured.")}
|
|
221
235
|
${V.gray("# Ask whether they want a presenter; do not assume either way.")}
|
|
222
|
-
$ ${
|
|
223
|
-
$ ${
|
|
224
|
-
$ ${
|
|
236
|
+
$ ${p.commands[0]} avatar options ${V.gray("# real voice and avatar ids + previews")}
|
|
237
|
+
$ ${p.commands[0]} presentation video settings <project-id> --yes --settings '{"voiceId":"<id>"}'
|
|
238
|
+
$ ${p.commands[0]} presentation video settings <project-id> --yes --settings '{"avatarId":"<id>"}'
|
|
225
239
|
|
|
226
240
|
${V.bold("Before rendering:")}
|
|
227
241
|
${V.gray("# Approve the content, then approve the spend \u2014 two questions. Read the")}
|
|
@@ -230,62 +244,62 @@ ${V.bold("Before rendering:")}
|
|
|
230
244
|
${V.gray("# none), music, format and captions, before the render. Reworking one")}
|
|
231
245
|
${V.gray("# scene is the cheap loop; the MP4 is not. --yes is your intent, not")}
|
|
232
246
|
${V.gray("# the user's consent.")}
|
|
233
|
-
$ ${
|
|
234
|
-
$ ${
|
|
247
|
+
$ ${p.commands[0]} presentation video inspect <project-id> ${V.gray("# narration text + settings to show")}
|
|
248
|
+
$ ${p.commands[0]} presentation video-narration <project-id> --slide-id <id> --instructions "shorter, warmer"
|
|
235
249
|
|
|
236
250
|
${V.bold("See also:")}
|
|
237
251
|
${V.gray("# Building a video from scratch instead of from a deck")}
|
|
238
|
-
$ ${
|
|
239
|
-
`);import{writeFile as
|
|
240
|
-
${
|
|
241
|
-
${
|
|
242
|
-
$ ${
|
|
243
|
-
|
|
244
|
-
${
|
|
245
|
-
${
|
|
246
|
-
$ ${
|
|
247
|
-
|
|
248
|
-
${
|
|
249
|
-
$ ${
|
|
250
|
-
`);import
|
|
251
|
-
${
|
|
252
|
-
$ ${
|
|
253
|
-
$ ${
|
|
254
|
-
|
|
255
|
-
${
|
|
256
|
-
${
|
|
257
|
-
$ ${
|
|
258
|
-
$ ${
|
|
259
|
-
`);import{Command as
|
|
260
|
-
${
|
|
261
|
-
`):o.cues.map(
|
|
262
|
-
`);if(e.output&&(await Zv(e.output,i,"utf-8"),n==="human"&&k(`Transcript saved to: ${e.output}`)),n==="json"){l(o);return}if(n==="quiet"){console.log(i);return}console.log(),console.log(`Title: ${o.title}`),o.channelName&&console.log(`Channel: ${o.channelName}`),o.durationFormatted&&console.log(`Duration: ${o.durationFormatted}`),console.log(`Language: ${o.language??"unknown"}${o.isAutoGenerated?" (auto-generated)":""}`),console.log(`Words: ${o.wordCount.toLocaleString()}`),console.log(`URL: ${o.url}`),o.truncated&&_("Transcript was truncated to fit the response budget."),e.output||(console.log(),console.log("--- Transcript ---"),console.log(i))}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});import{mkdir as nI,writeFile as Jl}from"fs/promises";import{dirname as rI}from"path";import{Command as kr}from"commander";import Xl from"ora";var zl="en-US-Neural2-C",Hl="gemini",oI=new kr("generate").description("Generate speech from text").requiredOption("-t, --text <text>","Text to convert to speech").requiredOption("-o, --output <path>","Output file path").option("--voice-id <voiceId>","Voice ID (e.g., ElevenLabs: 21m00Tcm4TlvDq8ikWAM)").option("--voice <voice>",`Voice name (default: ${zl})`).option("-p, --provider <provider>",`Provider: gemini, elevenlabs, openai (default: ${Hl})`).option("-m, --model <model>","Model (provider-specific)").option("-s, --speed <speed>","Speech speed 0.1-4.0 (default: 1.0)").option("-l, --lang <lang>","Language or locale hint (for example en-US)").option("--speakers <json>",`Multi-speaker (Gemini, max 2): '[{"name":"Joe","voice":"Kore"},{"name":"Jane","voice":"Puck"}]'`).option("-i, --instructions <text>","Style prompt (OpenAI gpt-4o-mini-tts): tone, accent, speed, emotion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.format,n=e==="human"?Xl("Generating speech...").start():null,r;t.speed&&(r=parseFloat(t.speed),(Number.isNaN(r)||r<.1||r>4)&&(n?.stop(),a("Speed must be between 0.1 and 4.0"),process.exit(d.INVALID_INPUT)));let o;if(t.speakers)try{o=JSON.parse(t.speakers),(!Array.isArray(o)||o.length===0||o.length>2||o.some(s=>!s||typeof s!="object"||typeof s.name!="string"||!s.name.trim()||typeof s.voice!="string"||!s.voice.trim()))&&(n?.stop(),a("Speakers must be an array with 1-2 name/voice items"),process.exit(d.INVALID_INPUT))}catch{n?.stop(),a(`Invalid --speakers JSON. Example: '[{"name":"Joe","voice":"Kore"}]'`),process.exit(d.INVALID_INPUT)}let i;try{let s=t.voiceId,c=t.voice||zl,p=t.provider||Hl,f={};o&&(f.gemini={speakers:o}),t.instructions&&(f.openai={instructions:t.instructions});let h=await La({text:t.text,options:{language:t.lang,provider:p,voiceId:s,voice:c,model:t.model,speed:r,providerOptions:Object.keys(f).length>0?f:void 0}});i=h.requestId,n?.stop();let v=t.output.endsWith(`.${h.format}`)?t.output:`${t.output}.${h.format}`;await nI(rI(v),{recursive:!0}),await Jl(v,h.audioData);let x=v.replace(/\.[^.]+$/,".txt");if(await Jl(x,t.text,"utf-8"),e==="json"){l({status:"completed",output:v,audioUrl:h.audioUrl,duration:h.duration,provider:h.provider,format:h.format,voice_id:h.voiceId??null,voice:h.voice??c,model:h.model??t.model??null,speed:h.speed??r??1,lang:h.language??t.lang??null,langApplied:h.langApplied??!1,timestamps:h.timestamps??null,words:h.wordTimings??null});return}if(e==="quiet"){console.log(v);return}k(`Saved to: ${v}`),w(`Duration: ${h.duration.toFixed(2)}s`),w(`Provider: ${h.provider}`)}catch(s){n?.stop(),a(fe(s,i),e),process.exit(d.GENERAL_ERROR)}}),iI=new kr("voices").description("List available voices").option("-p, --provider <provider>","Filter by provider: gemini, elevenlabs, openai").option("-f, --format <format>","Output format: human, json",b("--format",["human","json"]),"human").action(async t=>{let e=t.format==="human"?Xl("Fetching voices...").start():null;try{let n=await ja(t.provider);if(e?.stop(),t.format==="json"){l(n.voices);return}if(Array.isArray(n.voices)){let r=t.provider?.toUpperCase()||"VOICES";console.log(),console.log(`${r} Voices:`),console.log("-".repeat(50));for(let o of n.voices)console.log(` ${o.name} (${o.id})`),console.log(` ${o.description}`)}else for(let[r,o]of Object.entries(n.voices))if(!(!o||o.length===0)){console.log(),console.log(`${r.toUpperCase()} Voices:`),console.log("-".repeat(50));for(let i of o)console.log(` ${i.name} (${i.id})`),console.log(` ${i.description}`)}}catch(n){e?.stop(),a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),aI=new kr("status").description("Read speech generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").option("-f, --format <format>","Output format: json",b("--format",["json"]),"json").action(async(t,e)=>{try{l(await I("generateSpeech",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Yl=new kr("tts").description("Text-to-speech commands").addCommand(oI).addCommand(iI).addCommand(aI);import{execSync as Rr,spawnSync as xI}from"child_process";import{access as Pi,readFile as kI,rm as am}from"fs/promises";import{resolve as wn}from"path";import ne from"chalk";import{Command as ie}from"commander";import RI from"ffmpeg-static";import sm from"ora";import{mkdir as sI}from"fs/promises";import{join as dI}from"path";import{Command as bn}from"commander";import Zl from"ora";var cI=5e3,lI=120,Ql=5;function mI(t,e){return[...e,t]}function uI(t,e){try{let n=new URL(t);if(n.protocol!=="https:"&&n.protocol!=="http:")throw new Error;return n.toString()}catch{throw new Error(`${e} must be a public HTTP(S) URL`)}}function em(t){if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t))throw new Error("Source video id must be a UUID");return t}function pI(t){if(t.mode&&!["speed","precision"].includes(t.mode))throw new Error("Lip-sync mode must be speed or precision");return{audioUrl:uI(t.audioUrl,"Audio URL"),...t.mode?{mode:t.mode}:{},sourceVideoId:em(t.sourceVideoId)}}function gI(t){let e=[],n=new Set;for(let o of t.targetLanguage){let i=o.trim(),s=i.toLocaleLowerCase("en-US");!i||n.has(s)||(n.add(s),e.push(i))}if(e.length===0)throw new Error("Provide at least one target language");if(e.length>Ql)throw new Error(`Provide at most ${Ql} target languages`);if(e.find(o=>o.length<2||o.length>40))throw new Error("Target languages must be between 2 and 40 characters");return{...t.captions?{captions:!0}:{},sourceVideoId:em(t.sourceVideoId),targetLanguages:e}}function fI(t){return t.error||t.status==="failed"||t.status==="cancelled"?"failed":t.done||t.status==="completed"?"completed":t.status==="in_progress"||t.status==="processing"?"processing":"pending"}function Ai(t){return{requestId:t.runId,status:fI(t),...t.entity?.url?{videoUrl:t.entity.url}:{},...t.output?{output:t.output}:{},...t.error?{error:se(t.error)}:{}}}function tm(t){return{requestId:t.runId,status:"pending"}}async function nm(t,e){return ce(async()=>Ai(await I(t,e)),lI,cI)}function St(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.videoUrl??t.requestId);return}w(`Request ID: ${t.requestId}`),w(`Status: ${t.status}`),t.videoUrl&&k(`Video URL: ${t.videoUrl}`),t.error&&a(`Error: ${t.error}`)}function hI(t){return Array.isArray(t?.languages)?t.languages.filter(e=>{if(!e||typeof e!="object"||Array.isArray(e))return!1;let n=e;return typeof n.language=="string"&&(n.status==="completed"||n.status==="failed")&&typeof n.videoId=="string"&&(n.videoUrl===null||typeof n.videoUrl=="string")}):[]}function yI(t){return`${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")||"translation"}.mp4`}function bI(t,e){let n=yI(t);if(!e.has(n))return e.add(n),n;let r=n.slice(0,-4),o=2;for(;e.has(`${r}-${o}.mp4`);)o+=1;let i=`${r}-${o}.mp4`;return e.add(i),i}async function wI(t,e){let n=hI(t.output).filter(i=>i.status==="completed"&&!!i.videoUrl);if(n.length===0)throw new Error("Video translation completed without downloadable results");await sI(e,{recursive:!0});let r=[],o=new Set;for(let i of n){let s=dI(e,bI(i.language,o));await te(i.videoUrl,s),r.push({language:i.language,path:s})}return r}var vI=new bn("status").description("Check a video lip-sync request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"])).action(async function(t,e){let r=R(this,e).format??"human";try{St(Ai(await I("lipsyncVideo",t)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),rm=new bn("lipsync").description("Re-voice a ready workspace video with a public audio URL").requiredOption("--source-video-id <uuid>","READY workspace video UUID").requiredOption("--audio-url <url>","Public replacement voice audio URL").option("--mode <mode>","Quality mode: speed or precision","speed").requiredOption("-o, --output <path>","Local output video path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.format==="human"?Zl("Starting video lip-sync...").start():null,n;try{let r=await za(pI(t));if(n=r.runId,!t.wait){e?.stop(),St(tm(r),t.format);return}e&&(e.text="Waiting for video lip-sync...");let o=await nm("lipsyncVideo",r.runId);if(o.status==="failed")throw new Error(o.error??"Video lip-sync failed");if(!o.videoUrl)throw new Error("Video lip-sync completed without a video URL");e&&(e.text="Downloading lip-synced video..."),await te(o.videoUrl,t.output),e?.stop(),St(o,t.format),t.format==="human"&&k(`Saved to: ${t.output}`)}catch(r){e?.stop(),a(fe(r,n),t.format),process.exit(d.GENERAL_ERROR)}}).addCommand(vI),om=new bn("translate-languages").description("List supported video translation target languages").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{try{let e=await Ha();if(t.format==="json")l({languages:e});else for(let n of e)console.log(n)}catch(e){a(e instanceof Error?e.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),II=new bn("status").description("Check a video translation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"])).action(async function(t,e){let r=R(this,e).format??"human";try{St(Ai(await I("translateVideo",t)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),im=new bn("translate").description("Translate a ready workspace video into one or more languages").requiredOption("--source-video-id <uuid>","READY workspace video UUID").option("--target-language <language>","Target language (repeatable)",mI,[]).option("--captions","Burn provider-generated captions into translated videos").requiredOption("--output-dir <path>","Directory for translated videos").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.format==="human"?Zl("Starting video translation...").start():null,n;try{let r=await Xa(gI(t));if(n=r.runId,!t.wait){e?.stop(),St(tm(r),t.format);return}e&&(e.text="Waiting for video translations...");let o=await nm("translateVideo",r.runId);if(o.status==="failed")throw new Error(o.error??"Video translation failed");e&&(e.text="Downloading translated videos...");let i=await wI(o,t.outputDir);if(e?.stop(),t.format==="json")l({...o,downloads:i});else if(t.format==="quiet")for(let s of i)console.log(s.path);else{St(o,t.format);for(let s of i)k(`${s.language}: ${s.path}`)}}catch(r){e?.stop(),a(fe(r,n),t.format),process.exit(d.GENERAL_ERROR)}}).addCommand(II);async function CI(){return process.stdin.isTTY?null:new Promise(t=>{let e="",n=!1;process.stdin.setEncoding("utf-8"),process.stdin.on("data",r=>{e+=r}),process.stdin.on("end",()=>{n||(n=!0,t(e.trim()||null))}),process.stdin.on("error",()=>{n||(n=!0,t(null))}),setTimeout(()=>{!n&&!e&&(n=!0,t(null))},500)})}function SI(t){let e=t?.trim().toLowerCase();if(!(!e||e==="any"||e==="all"))return e==="web"||e==="stock"?[e]:void 0}var EI=new ie("find").description("Find video clips across the web and licensed stock").argument("<query>","Search query").option("-n, --max-results <count>","Maximum number of results","10").option("-o, --orientation <type>","Video orientation: landscape, portrait, square, any","any").option("-l, --license <type>","License type: free, premium, any","free").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{let{maxResults:n,orientation:r,license:o,format:i}=e,s=i==="human"?sm("Finding videos...").start():null;try{let c=await Fa({query:t,options:{maxResults:parseInt(n,10),orientation:r,license:o,sources:SI(e.source)}});s?.stop();let p=c.data.results.flatMap(f=>f.results);if(i==="json"){l(c);return}if(i==="quiet"){p.forEach(f=>{console.log(f.embedUrl||f.previewUrl||f.thumbnailUrl)});return}if(p.length===0){w("No videos found");return}k(`Found ${p.length} videos for "${t}"`),console.log(),p.forEach((f,h)=>{let v=f.kind==="embed";console.log(`[${h+1}] ${f.title}`),console.log(` ${v?"Embed":"URL"}: ${f.embedUrl||f.previewUrl||f.thumbnailUrl}`),console.log(v?` Duration: ${f.duration}s | Embed only \u2014 plays in the host player, do not download`:` Duration: ${f.duration}s | Size: ${f.width}x${f.height}`),console.log(` Provider: ${f.provider}`),console.log()})}catch(c){s?.stop(),a(c instanceof Error?c.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),$I=new ie("create").description("Generate one video from a pinned storyboard revision").requiredOption("--storyboard-revision <id>","Immutable storyboard revision UUID").option("--source-video <id>","Ready video from an earlier create call to use as base footage").option("--release","Render at 720p for release. Costs more; drafts are 480p by default").option("--team-id <id>","Workspace ID").option("--approval-receipt <receipt>","Receipt returned by the browser confirmation URL; omit on the first call to get that URL").requiredOption("--idempotency-key <key>","Stable invocation key bound into the approval receipt").option("--yes","Approve paid video generation").action(async t=>{if(!t.yes)return a("Pass --yes to approve video generation");try{l(await Ya({quality:t.release?"release":void 0,sourceVideoId:t.sourceVideo,storyboardRevisionId:t.storyboardRevision,teamId:t.teamId},t.approvalReceipt,t.idempotencyKey))}catch(e){a(e instanceof Error?e.message:"Generation failed"),process.exit(d.GENERAL_ERROR)}});async function dm(t){let e=t==="-"?await CI():await kI(t,"utf-8");if(!e?.trim())throw new Error(t==="-"?"No storyboard Markdown was received on stdin":`Storyboard file is empty: ${t}`);return e}async function cm(t,e={}){if(t)return t.length===1&&t[0]==="none"?[]:Promise.all(t.map(async n=>{let r;try{let x=JSON.parse(n);if(!x||typeof x!="object"||Array.isArray(x))throw new Error("Media binding must be a JSON object");r=x}catch(x){throw new Error(`Invalid --media binding. Pass one JSON object per binding, for example '{"handle":"actress-photo","path":"./actress.jpg","purpose":"identity"}'.`,{cause:x})}let o=Re(r.handle),i=Re(r.path),s=Re(r.fileUrl)??Re(r.url),c=Re(r.purpose),p=Re(r.videoRole),f=Re(r.analysisId)??Re(r.analysis);if(!o||!i&&!s||!c)throw new Error("Invalid --media binding. handle, purpose, and either path or url are required strings.");if(i&&s)throw new Error("A media binding cannot contain both path and url.");if(i&&c==="source"&&f)throw new Error("A source analysis is bound to the original uploaded URL. Reuse the url/name/mime/size binding printed by 'video reference analyze' instead of uploading path again.");if(i&&!e.uploadIdempotencyKey)throw new Error("Local storyboard media requires the command idempotency key.");let h=i?await de(wn(i),{idempotencyKey:`${e.uploadIdempotencyKey}:media:${o}`}):{name:Re(r.name),size:Number(r.size),type:Re(r.mime),url:s};if(!h.name||!h.type||!h.url||!Number.isSafeInteger(h.size)||h.size<=0)throw new Error(`URL media binding "${n}" requires name, mime, and positive integer size.`);let v=h.type.startsWith("video/")?"video":h.type.startsWith("audio/")?"audio":h.type.startsWith("image/")?"image":null;if(!v)throw new Error(`Unsupported media type for ${i??s}: ${h.type}`);if(!["source","style","identity","required"].includes(c))throw new Error(`Invalid media purpose: ${c}`);if(p&&!["reference","first-frame","last-frame"].includes(p))throw new Error(`Invalid videoRole: ${p}`);if(p&&v!=="image")throw new Error("videoRole is supported only for image bindings.");return{...f?{analysisId:f}:{},fileUrl:h.url,handle:o,kind:v,mime:h.type,name:h.name,purpose:c,size:h.size,...p?{videoRole:p}:{}}}))}function Re(t){return typeof t=="string"&&t.length>0?t:void 0}var TI=new ie("create").description("Create a versioned Markdown video storyboard").requiredOption("--file <path>","Markdown file path, or - for stdin").requiredOption("--duration <seconds>","Exact total duration in seconds").requiredOption("--aspect <ratio>","Output aspect: 9:16, 16:9, or 1:1").option("--title <text>","Artifact label").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact create").option("--media <binding...>",'One JSON binding per asset: {"handle":"actress-photo","path":"./actress.jpg","purpose":"identity"}').option("--team-id <id>","Workspace ID").action(async t=>{try{l(await m("createVideoStoryboard",{aspectRatio:t.aspect,durationSec:Number(t.duration),mediaBindings:await cm(t.media,{uploadIdempotencyKey:t.idempotencyKey}),storyboardMarkdown:await dm(t.file),teamId:t.teamId,title:t.title},t.idempotencyKey))}catch(e){a(e instanceof Error?e.message:"Storyboard creation failed"),process.exit(d.GENERAL_ERROR)}}),AI=new ie("revise").description("Append an immutable revision to a video storyboard").argument("<storyboard-id>","Storyboard UUID").requiredOption("--base-revision <id>","Revision UUID that was edited").requiredOption("--file <path>","Complete Markdown file path, or - for stdin").requiredOption("--duration <seconds>","Exact total duration in seconds").requiredOption("--aspect <ratio>","Output aspect: 9:16, 16:9, or 1:1").option("--title <text>","Replacement artifact label").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact revision").option("--change-summary <text>","Short description of this revision").option("--media <binding...>",'Replace media bindings with one JSON object per asset; use the JSON printed by "video reference analyze" for analyzed source video').option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("reviseVideoStoryboard",{aspectRatio:e.aspect,baseRevisionId:e.baseRevision,changeSummary:e.changeSummary,durationSec:Number(e.duration),mediaBindings:await cm(e.media,{uploadIdempotencyKey:e.idempotencyKey}),storyboardId:t,storyboardMarkdown:await dm(e.file),teamId:e.teamId,title:e.title},e.idempotencyKey))}catch(n){a(n instanceof Error?n.message:"Storyboard revision failed"),process.exit(d.GENERAL_ERROR)}}),PI=new ie("show").description("Read a storyboard; print Markdown unless --json is used").argument("<storyboard-id>","Storyboard UUID").option("--revision <id>","Read one immutable revision UUID").option("--team-id <id>","Workspace ID").option("--json","Print the complete structured response").action(async(t,e)=>{try{let n=await m("readVideoStoryboard",{revisionId:e.revision,storyboardId:t,teamId:e.teamId});if(e.json){l(n);return}console.error(`${n.storyboard.title} \xB7 revision ${n.storyboard.revision.versionNumber} (${n.storyboard.revision.id})`),console.log(n.storyboard.revision.storyboardMarkdown)}catch(n){a(n instanceof Error?n.message:"Storyboard read failed"),process.exit(d.GENERAL_ERROR)}}),OI=new ie("storyboard").description("Create, revise, and read Markdown video storyboards").addCommand(TI).addCommand(AI).addCommand(PI),lm=new ie("analyze").description("Upload and analyze a reference video; its analysisId is the only analysis video generation consumes").requiredOption("--file <path>","Local reference video").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact analysis").option("--user-request <text>","What the analysis should focus on").option("--team-id <id>","Workspace ID").option("--no-wait","Return the durable run immediately").option("--json","Print the complete structured result").action(async t=>{try{let e=await de(wn(t.file),{idempotencyKey:`video-reference-analysis:${t.idempotencyKey}:source`});if(!e.type.startsWith("video/"))throw new Error(`Reference analysis requires a video, got ${e.type}`);let n=await Qa({idempotencyKey:t.idempotencyKey,sourceUrl:e.url,teamId:t.teamId,userRequest:t.userRequest}),r={analysisId:n.runId,fileUrl:e.url,handle:"source-video",kind:"video",mime:e.type,name:e.name,purpose:"source",size:e.size};if(t.wait===!1){l({...n,binding:r,source:e});return}let o=await Za(n.runId,t.teamId);if(t.json){l({...o,binding:r,source:e});return}let i=o.output?.analysis??{};console.log(typeof i.promptContext=="string"?i.promptContext:JSON.stringify(o.output,null,2)),console.error(`Analysis run: ${n.runId}`),console.error(`Storyboard media JSON: ${JSON.stringify(r)}`)}catch(e){a(e instanceof Error?e.message:"Reference analysis failed"),process.exit(d.GENERAL_ERROR)}});lm.addHelpText("after",`
|
|
263
|
-
${
|
|
264
|
-
${
|
|
265
|
-
${
|
|
266
|
-
`);var
|
|
267
|
-
${
|
|
268
|
-
${
|
|
269
|
-
$ ${
|
|
270
|
-
|
|
271
|
-
${
|
|
272
|
-
$ ${
|
|
273
|
-
|
|
274
|
-
${
|
|
275
|
-
${
|
|
276
|
-
${
|
|
277
|
-
${
|
|
278
|
-
${
|
|
279
|
-
${
|
|
280
|
-
$ ${
|
|
281
|
-
$ ${
|
|
282
|
-
|
|
283
|
-
${
|
|
284
|
-
${
|
|
285
|
-
$ ${
|
|
286
|
-
`);import{Command as
|
|
287
|
-
`)}function
|
|
288
|
-
`)}var
|
|
252
|
+
$ ${p.commands[0]} video --help
|
|
253
|
+
`);import{randomUUID as lk}from"crypto";import{writeFile as mk}from"fs/promises";import Cn from"chalk";import{Command as uk}from"commander";import pk from"ora";var _i=new uk("scrape").description("Extract content from a URL").argument("<url>","URL to scrape").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--provider <name>","Scraping provider preference").option("--reason <text>","Reason for scraping this URL").option("--response-format <format>","Response format: markdown, html, text, content").option("-o, --output <path>","Save content to file").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{let n=t.format,r=n==="human"?pk("Scraping URL...").start():null;try{let o=await m("scrape",{provider:t.provider,reason:t.reason,responseFormat:t.responseFormat,teamId:t.teamId,url:e},t.idempotencyKey??lk());r?.stop();let i={content:o.content,metadata:{description:"",format:o.format??"unknown",tokenUsage:Math.ceil(o.content.length/4)},title:o.title??"",mode:o.mode,url:o.url};if(t.output&&(await mk(t.output,i.content,"utf-8"),n==="human"&&k(`Content saved to: ${t.output}`)),n==="json"){l(i);return}if(n==="quiet"){console.log(i.content);return}i.title&&(console.log(),console.log(`Title: ${i.title}`)),i.metadata?.description&&console.log(`Description: ${i.metadata.description}`),console.log(`URL: ${i.url}`),console.log(`Tokens: ~${i.metadata?.tokenUsage?.toLocaleString()||"unknown"}`),i.warning&&L(i.warning),t.output||(console.log(),console.log("--- Content ---"),console.log(i.content))}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}});_i.addHelpText("after",`
|
|
254
|
+
${Cn.bold("Examples:")}
|
|
255
|
+
${Cn.gray("# Pull the readable content of a web page")}
|
|
256
|
+
$ ${p.commands[0]} scrape https://example.com/post
|
|
257
|
+
|
|
258
|
+
${Cn.bold("See also:")}
|
|
259
|
+
${Cn.gray("# Local files and documents, not just URLs")}
|
|
260
|
+
$ ${p.commands[0]} content extract ./paper.pdf
|
|
261
|
+
|
|
262
|
+
${Cn.gray("# Spoken words out of audio or video")}
|
|
263
|
+
$ ${p.commands[0]} transcript --help
|
|
264
|
+
`);import{randomUUID as Pr}from"crypto";import qi from"chalk";import{Command as Sn}from"commander";function Or(e,t){t!=="quiet"&&l(e)}var gk=new Sn("web").description("Search current public web sources").argument("<query>","Search query").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--max-results <count>","Maximum results","5").option("--country <code>","Two-letter search country code").option("--language <code>","Search language code").option("--queries <queries...>","Additional search queries").option("--reason <text>","Reason for this search").option("--recency <value>","Recency: all, h, d, w, m, y").option("--timeframe <value>","Timeframe: all, hour, day, week, month, year").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=[e,...t.queries??[]],r=await m("searchInternet",{gl:t.country,hl:t.language,maxResults:Number.parseInt(t.maxResults,10),queries:n,reason:t.reason,teamId:t.teamId,tbs:t.recency,timeframe:t.timeframe},t.idempotencyKey??Pr());Or(r,t.format)}catch(n){a(n instanceof Error?n.message:"Search failed"),process.exit(s.GENERAL_ERROR)}}),fk=new Sn("news").description("Search recent news").argument("<topic>","News topic").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--timeframe <value>","Timeframe hint").option("--max-results <count>","Maximum results","6").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await m("getNews",{maxResults:Number.parseInt(t.maxResults,10),teamId:t.teamId,timeframe:t.timeframe,topic:e},t.idempotencyKey??Pr());Or(n,t.format)}catch(n){a(n instanceof Error?n.message:"News search failed"),process.exit(s.GENERAL_ERROR)}});function Sm(e){let t=e?.trim().toLowerCase();if(!(!t||t==="any"||t==="all"))return t==="web"||t==="stock"?[t]:void 0}function hk(e){if(!e?.length)return;let t=[...new Set(e.map(n=>n.toLowerCase()))];if(t.some(n=>n!=="embed"&&n!=="file"))throw new Error("Video kind must be embed or file");return t}var yk=new Sn("images").description("Search images across the web and licensed stock").argument("<query>","Image search query").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--max-results <count>","Maximum results","10").option("--aspect <aspect>","Aspect: any, square, wide, tall","any").option("--queries <queries...>","Additional image queries").option("--reason <text>","Reason for this search").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=[e,...t.queries??[]],r=await m("searchImages",{aspect:t.aspect,maxResults:Number.parseInt(t.maxResults,10),queries:n,reason:t.reason,sources:Sm(t.source),teamId:t.teamId},t.idempotencyKey??Pr());Or(r,t.format)}catch(n){a(n instanceof Error?n.message:"Image search failed"),process.exit(s.GENERAL_ERROR)}}),bk=new Sn("video").description("Search video across the web and licensed stock").argument("<query>","Video search query").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--max-results <count>","Maximum results","10").option("--kind <kind...>","Usable result kind: embed, file, or both (default: both)").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("--orientation <value>","Orientation: landscape, portrait, square, any","any").option("--license <value>","License: free, premium, any","any").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{let n=await m("searchStockVideo",{kinds:hk(t.kind),license:t.license,maxResults:Number.parseInt(t.maxResults,10),orientation:t.orientation,query:e,sources:Sm(t.source),teamId:t.teamId},t.idempotencyKey??Pr());Or(n,t.format)}catch(n){a(n instanceof Error?n.message:"Video search failed"),process.exit(s.GENERAL_ERROR)}}),ji=new Sn("search").description("Web, news, image, and stock-video search").addCommand(gk).addCommand(fk).addCommand(yk).addCommand(bk);ji.addHelpText("after",`
|
|
265
|
+
${qi.bold("Examples:")}
|
|
266
|
+
$ ${p.commands[0]} search web "state of AI video 2026"
|
|
267
|
+
$ ${p.commands[0]} search news "vaccine approvals"
|
|
268
|
+
|
|
269
|
+
${qi.bold("See also:")}
|
|
270
|
+
${qi.gray("# `search images` and `search video` overlap with these")}
|
|
271
|
+
$ ${p.commands[0]} image search --help
|
|
272
|
+
$ ${p.commands[0]} video find --help
|
|
273
|
+
`);import{randomUUID as wk}from"crypto";import{Command as Bi}from"commander";import vk from"ora";function Mi(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.audioUrl??e.requestId??e.id);return}b(`Request ID: ${e.requestId||e.id}`),b(`Status: ${e.status}`),e.duration&&b(`Duration: ${e.duration}s`),e.audioUrl&&k(`Audio URL: ${e.audioUrl}`),e.error&&a(`Error: ${e.error}`)}var Ik=new Bi("generate").description("Generate one SFX cue from a video's final facts and visual event").option("--request <path>","JSON file with video description, narration timings, and visual_event").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").option("--idempotency-key <key>","Stable recovery key").option("--duration <seconds>","Direct cue duration").option("--duration-seconds <seconds>","Final video duration").option("--narration-json <json>","Final narration timing array").option("--options-json <json>","Canonical sound-effect options JSON").option("--schema-version <version>","Video facts schema version").option("--text <text>","Direct sound-effect brief").option("--video-description <text>","Final video description").option("--visual-event-json <json>","Final visual event JSON").option("-o, --output <path>","Output file path").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t;try{t=he(e)}catch(d){a(d instanceof Error?d.message:String(d)),process.exit(s.INVALID_INPUT)}!e.wait&&e.output&&(a("--output requires waiting for completion; remove --no-wait"),process.exit(s.INVALID_INPUT));let n;try{n=e.request?El(e.request):{...e.duration?{duration:Number(e.duration)}:{},...e.durationSeconds?{duration_s:Number(e.durationSeconds)}:{},...e.narrationJson?{narration:Vi("--narration-json",e.narrationJson)}:{},...e.optionsJson?{options:Vi("--options-json",e.optionsJson)}:{},...e.schemaVersion?{schema_version:Number(e.schemaVersion)}:{},...e.text?{text:e.text}:{},...e.videoDescription?{video_description:e.videoDescription}:{},...e.visualEventJson?{visual_event:Vi("--visual-event-json",e.visualEventJson)}:{}}}catch(d){a(d instanceof Error?d.message:String(d)),process.exit(s.INVALID_INPUT)}let r=e.format,o=r==="human"?vk("Generating sound effect for video...").start():null,i,c=e.idempotencyKey??n.idempotency_key??wk();try{let d=await as(n,{approvalReceipt:t,idempotencyKey:c});if(i=d.requestId||d.id,!e.wait){o?.stop(),Mi(d,r);return}let u=d.requestId||d.id;o&&(o.text=`Processing (ID: ${u})...`);let g=d.status==="completed"||d.status==="failed"?d:await pe(()=>po(u),60,2e3);if(o?.stop(),g.status==="failed"&&(a(g.error||"Sound effects generation failed"),process.exit(s.GENERAL_ERROR)),e.output){if(!g.audioUrl)throw new Error("Sound effect completed without an audio URL");await oe(g.audioUrl,e.output),r==="human"&&k(`Saved to: ${e.output}`)}Mi(g,r)}catch(d){o?.stop(),a(`${ne(d,i)} Retry with --idempotency-key ${c}.`,r),process.exit(s.GENERAL_ERROR)}});function Vi(e,t){try{return JSON.parse(t)}catch{throw new Error(`${e} must be valid JSON`)}}var kk=new Bi("status").description("Check status of a sound effects generation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{try{Mi(await po(e),t.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Em=new Bi("sfx").description("Video-aware sound effects generation commands").addCommand(Ik).addCommand(kk);import{randomUUID as Am}from"crypto";import{readFile as Ek}from"fs/promises";import{Command as Fi}from"commander";import{existsSync as xk,readFileSync as Rk,statSync as Ck}from"fs";import{basename as Sk}from"path";var ze=class extends Error{constructor(n,r){super(n);this.code=r;this.name="SupportAttachmentError"}code};async function Tm(e,t){let n=await fetch(`${B()}${e}`,{body:JSON.stringify(t),headers:{"Content-Type":"application/json",...await Ie()},method:"POST"}),r=await n.json().catch(()=>null);if(!n.ok)throw new ze(r?.error??`Request to ${e} failed (${n.status})`,r?.code??"support_attachment_failed");return r}async function $m(e,t){if(!xk(e))throw new ze(`No such file: ${e}`,"support_attachment_missing_file");let n=Ck(e);if(!n.isFile()||n.size<=0)throw new ze(`Not a readable file with content: ${e}`,"support_attachment_missing_file");let r=Sk(e),o=await Tm("/api/support/attachments/presign",{fileName:r,mediaType:yt(e),requestUuid:t.requestUuid,size:n.size,...t.teamId?{teamId:t.teamId}:{}}),i=new FormData;for(let[u,g]of Object.entries(o.upload.fields))i.append(u,g);i.append("file",new Blob([Rk(e)],{type:o.mediaType}),r);let c=await fetch(o.upload.url,{body:i,method:"POST"});if(!c.ok)throw new ze(`Storage refused the upload of ${r} (${c.status}).`,"support_attachment_upload_failed");let d=await Tm("/api/support/attachments/confirm",{key:o.attachmentKey,originalName:r,...t.teamId?{teamId:t.teamId}:{}});return{bytes:d.attachment.bytes,key:d.attachmentKey,mediaType:d.attachment.mediaType,name:d.attachment.name}}var Tk=["received","looking_into_it","planned","in_progress","fixed_awaiting_release","shipped","not_planned","needs_input","resolved"];async function $k(e){if(e!==void 0&&e!=="-"&&!e.startsWith("@"))return e;if(e?.startsWith("@"))return Ek(e.slice(1),"utf8");if(e==="-"||!process.stdin.isTTY)return Ak();a("Nothing to report. Pass the text as an argument, @<path> to read a file, or pipe it on stdin."),process.exit(s.GENERAL_ERROR)}async function Ak(){let e=[];for await(let t of process.stdin)e.push(Buffer.from(t));return Buffer.concat(e).toString("utf8")}function Pk(e){if(e===void 0)return{};let t;try{t=JSON.parse(e)}catch(n){a(`--context must be a JSON object: ${n instanceof Error?n.message:String(n)}`),process.exit(s.GENERAL_ERROR)}return(t===null||typeof t!="object"||Array.isArray(t))&&(a("--context must be a JSON object."),process.exit(s.GENERAL_ERROR)),t}function Ok(e,t){return[...t,e]}async function Dk(e,t){let n=[];for(let r of e)try{let o=await $m(r,t);n.push(o.key)}catch(o){throw o instanceof ze&&(a(`${r}: ${o.message}`),process.exit(s.GENERAL_ERROR)),o}return n}function Pm(e,t){a(e instanceof Error?e.message:t),process.exit(s.GENERAL_ERROR)}var Nk=new Fi("report").description("File a bug, question, feature request or billing issue").argument("[text]","What happened, in your own words: literal text, @<path> to read a file, or '-' for stdin").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key; generated when omitted").option("--attach <file>","Attach a local file to the report; repeatable, up to 5 files (25 MiB each, 200 MiB for video)",Ok,[]).option("--screenshot-url <key>","Object key returned by the support screenshot upload (support-requests/<teamId>/<uuid>/screenshot.<ext>)").option("--source <source>","Where the report comes from; defaults to cli").option("--context <json>",`JSON object of extra context, e.g. '{"kind":"bug"}' for your own guess at bug | confusing | feature | billing | other (triage decides), route, errorReference, chatId, artifactId`).action(async(e,t)=>{try{let n=Pk(t.context),r=Am(),o=await Dk(t.attach??[],{requestUuid:r,teamId:t.teamId});l(await m("submitSupportRequest",{attachmentKeys:o.length>0?o:void 0,context:Object.keys(n).length>0?n:void 0,screenshotUrl:t.screenshotUrl,source:t.source,teamId:t.teamId,text:await $k(e)},t.idempotencyKey??`cli:support:report:${Am()}`))}catch(n){Pm(n,"Could not file the report")}}),Lk=new Fi("list").description("List the workspace's support requests and their status, newest first").option("--team-id <id>","Workspace ID").option("--mine","Only the reports you filed yourself").option("--status <status>",`Only items in one of ${Tk.join(", ")}`).option("--limit <n>","Maximum items to return (default 50)").action(async e=>{try{l(await m("listSupportRequests",{limit:e.limit?Number(e.limit):void 0,mine:e.mine?!0:void 0,status:e.status,teamId:e.teamId}))}catch(t){Pm(t,"Could not list support requests")}}),Om=new Fi("support").description("File a report and follow what became of it").addCommand(Nk).addCommand(Lk);import{Command as Uk}from"commander";import En from"chalk";var Dm=new Uk("templates").description("List slide design templates (use with `create --template <id>`)").argument("[search]","Filter templates by name, description, or category").option("-f, --format <format>","Output format (table, json)",y("--format",["table","json"]),"table").option("--limit <n>","Maximum templates to list","25").action(async(e,t)=>{await h();try{let n=Number.parseInt(t.limit??"25",10),{templates:r}=await za(e,Number.isFinite(n)?n:25);if(r.length===0){t.format==="json"?console.log(JSON.stringify([])):b("No templates found");return}if(t.format==="json"){console.log(JSON.stringify(r,null,2));return}for(let o of r){let i=[o.isDefault?En.green("default"):null,o.category??null,o.recommendedModes?.length?`modes: ${o.recommendedModes.join("/")}`:null].filter(Boolean).join(" \xB7 ");console.log(`${En.bold(o.name)} ${En.gray(o.id)}${i?`
|
|
274
|
+
${En.gray(i)}`:""}`)}console.log(),console.log(En.gray(`Use one with: ${p.commands[0]} create "<topic>" --template <id>`))}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}});import{randomUUID as _k}from"crypto";import{writeFile as qk}from"fs/promises";import{Command as jk}from"commander";import Vk from"ora";var Nm=new jk("transcript").description("Fetch a YouTube video's transcript").argument("<url>","YouTube URL or 11-character video id").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Stable retry key").option("--language <codes>","Comma-separated language priority list, e.g. 'en,de' or 'asr-en'").option("--reason <text>","Reason for retrieving the transcript").option("--no-timestamps","Print plain text without [m:ss] prefixes").option("-o, --output <path>","Save the transcript to a file").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{let n=t.format,r=n==="human"?Vk("Fetching transcript...").start():null;try{let o=await m("getYoutubeTranscript",{language:t.language,reason:t.reason,teamId:t.teamId,url:e},t.idempotencyKey??_k());r?.stop();let i=t.timestamps?o.cues.map(c=>`[${c.timestamp}] ${c.text}`).join(`
|
|
275
|
+
`):o.cues.map(c=>c.text).join(`
|
|
276
|
+
`);if(t.output&&(await qk(t.output,i,"utf-8"),n==="human"&&k(`Transcript saved to: ${t.output}`)),n==="json"){l(o);return}if(n==="quiet"){console.log(i);return}console.log(),console.log(`Title: ${o.title}`),o.channelName&&console.log(`Channel: ${o.channelName}`),o.durationFormatted&&console.log(`Duration: ${o.durationFormatted}`),console.log(`Language: ${o.language??"unknown"}${o.isAutoGenerated?" (auto-generated)":""}`),console.log(`Words: ${o.wordCount.toLocaleString()}`),console.log(`URL: ${o.url}`),o.truncated&&L("Transcript was truncated to fit the response budget."),t.output||(console.log(),console.log("--- Transcript ---"),console.log(i))}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}});import{randomUUID as Mk}from"crypto";import{mkdir as Bk,writeFile as Lm}from"fs/promises";import{dirname as Fk}from"path";import{Command as Dr}from"commander";import Um from"ora";var Gk=new Dr("generate").description("Generate speech from text").requiredOption("-t, --text <text>","Text to convert to speech").requiredOption("-o, --output <path>","Output file path").option("--approval-receipt <receipt>","Browser-issued approval receipt").option("--approval-receipt-stdin","Read the browser-issued approval receipt from stdin").option("--idempotency-key <key>","Stable recovery key").option("--options-json <json>","Canonical speech options JSON").option("--voice-id <voiceId>","Opaque Mindframes voice ID").option("-s, --speed <speed>","Speech speed 0.1-4.0 (default: 1.0)").option("-l, --lang <lang>","Language or locale hint (for example en-US)").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.idempotencyKey??Mk(),n;try{n=he(e)}catch(d){a(d instanceof Error?d.message:String(d)),process.exit(s.INVALID_INPUT)}let r=e.format,o=r==="human"?Um("Generating speech...").start():null,i;e.speed&&(i=parseFloat(e.speed),(Number.isNaN(i)||i<.1||i>4)&&(o?.stop(),a("Speed must be between 0.1 and 4.0"),process.exit(s.INVALID_INPUT)));let c;try{let d=e.optionsJson?Kk("--options-json",e.optionsJson):{},u=await Za({text:e.text,options:{...d,language:e.lang,voiceId:e.voiceId,speed:i}},{approvalReceipt:n,idempotencyKey:t});c=u.requestId,o?.stop();let g=e.output.endsWith(`.${u.format}`)?e.output:`${e.output}.${u.format}`;await Bk(Fk(g),{recursive:!0}),await Lm(g,u.audioData);let w=g.replace(/\.[^.]+$/,".txt");if(await Lm(w,e.text,"utf-8"),r==="json"){l({status:"completed",requestId:u.requestId,output:g,audioUrl:u.audioUrl,duration:u.duration,format:u.format,speed:u.speed??i??1,lang:u.language??e.lang??null,langApplied:u.langApplied??!1,timestamps:u.timestamps??null,words:u.wordTimings??null});return}if(r==="quiet"){console.log(g);return}k(`Saved to: ${g}`),b(`Duration: ${u.duration.toFixed(2)}s`)}catch(d){o?.stop(),a(`${ne(d,c)} Retry with --idempotency-key ${t}.`,r),process.exit(s.GENERAL_ERROR)}});function Kk(e,t){try{let n=JSON.parse(t);if(!n||typeof n!="object"||Array.isArray(n))throw new Error;return n}catch{throw new Error(`${e} must be a JSON object`)}}var Wk=new Dr("voices").description("List available voices").option("-p, --provider <provider>","Filter by provider: gemini, elevenlabs, openai").option("-f, --format <format>","Output format: human, json",y("--format",["human","json"]),"human").action(async e=>{let t=e.format==="human"?Um("Fetching voices...").start():null;try{let n=await ts(e.provider);if(t?.stop(),e.format==="json"){l(n.voices);return}if(Array.isArray(n.voices)){let r=e.provider?.toUpperCase()||"VOICES";console.log(),console.log(`${r} Voices:`),console.log("-".repeat(50));for(let o of n.voices)console.log(` ${o.name} (${o.id})`),console.log(` ${o.description}`)}else for(let[r,o]of Object.entries(n.voices))if(!(!o||o.length===0)){console.log(),console.log(`${r.toUpperCase()} Voices:`),console.log("-".repeat(50));for(let i of o)console.log(` ${i.name} (${i.id})`),console.log(` ${i.description}`)}}catch(n){t?.stop(),a(n instanceof Error?n.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Jk=new Dr("status").description("Read speech generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").option("-f, --format <format>","Output format: json",y("--format",["json"]),"json").action(async(e,t)=>{try{l(await I("generateSpeech",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),_m=new Dr("tts").description("Text-to-speech commands").addCommand(Gk).addCommand(Wk).addCommand(Jk);import{execSync as Ur,spawnSync as mx}from"child_process";import{access as Ji,readFile as ux,rm as Wm}from"fs/promises";import{resolve as Tn}from"path";import ie from"chalk";import{Command as le}from"commander";import px from"ffmpeg-static";import Jm from"ora";import{Command as zk}from"commander";var qm=new zk("set").description("Set the poster of a finished video").argument("<video-id>","Finished video whose poster is being set").option("--at-seconds <seconds>","Moment of the video to cut the poster from").option("--image-url <url>","Existing https image to use as the poster").option("--upload-key <key>","Key of an image you uploaded").option("--team-id <id>","Workspace to act in").action(async(e,t)=>{[t.atSeconds,t.imageUrl,t.uploadKey].filter(o=>o!==void 0).length>1&&(a("Name at most one poster source: --at-seconds, --image-url or --upload-key. Name none to restore the automatic one."),process.exit(s.INVALID_INPUT));let r={videoId:e};if(t.atSeconds!==void 0){let o=Number(t.atSeconds);(!Number.isFinite(o)||o<0)&&(a("--at-seconds must be a number of seconds, zero or more."),process.exit(s.INVALID_INPUT)),r.atSeconds=o}t.imageUrl!==void 0&&(r.imageUrl=t.imageUrl),t.uploadKey!==void 0&&(r.uploadKey=t.uploadKey),t.teamId!==void 0&&(r.teamId=t.teamId);try{let o=await W(t.teamId),i=await m("setVideoThumbnail",r,z({command:"video thumbnail set",payload:r,workspaceId:o}));l(i),k(`Poster set from ${i.source}.`)}catch(o){a(o instanceof Error?o.message:"Setting the poster failed"),process.exit(s.GENERAL_ERROR)}});import{randomUUID as Gi}from"crypto";import{mkdir as Hk}from"fs/promises";import{join as Xk}from"path";import{Command as ut}from"commander";import Vm from"ora";var Yk=5e3,Qk=120,jm=5;function Mm(e,t){return[...t,e]}function Zk(e,t){try{let n=new URL(e);if(n.protocol!=="https:"&&n.protocol!=="http:")throw new Error;return n.toString()}catch{throw new Error(`${t} must be a public HTTP(S) URL`)}}function Nr(e){if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(e))throw new Error("Source video id must be a UUID");return e}function ex(e){if(e.mode&&!["speed","precision"].includes(e.mode))throw new Error("Lip-sync mode must be speed or precision");return{audioUrl:Zk(e.audioUrl,"Audio URL"),...e.mode?{mode:e.mode}:{},sourceVideoId:Nr(e.sourceVideoId)}}function tx(e){let t=[],n=new Set;for(let o of e.targetLanguage){let i=o.trim(),c=i.toLocaleLowerCase("en-US");!i||n.has(c)||(n.add(c),t.push(i))}if(t.length===0)throw new Error("Provide at least one target language");if(t.length>jm)throw new Error(`Provide at most ${jm} target languages`);if(t.find(o=>o.length<2||o.length>40))throw new Error("Target languages must be between 2 and 40 characters");return{...e.captions?{captions:!0}:{},sourceVideoId:Nr(e.sourceVideoId),targetLanguages:t}}function nx(e){if(e.aspect&&!["9:16","16:9","1:1"].includes(e.aspect))throw new Error("Clip aspect must be 9:16, 16:9, or 1:1");let t=e.duration.filter(r=>["30","60","180","long"].includes(r));if(t.length!==e.duration.length)throw new Error("Clip duration must be 30, 60, 180, or long");let n=e.maxClips?Number.parseInt(e.maxClips,10):void 0;if(n!==void 0&&(!Number.isInteger(n)||n<1||n>10))throw new Error("Max clips must be between 1 and 10");return{...e.aspect?{aspect:e.aspect}:{},...e.brandingId?{brandingId:Nr(e.brandingId)}:{},...e.captionStyle?{captionStyle:e.captionStyle}:{},...e.captions?{captions:!0}:{},...t.length?{durationTypes:t}:{},...e.inputLanguage?{inputLanguage:e.inputLanguage}:{},...n!==void 0?{maxClips:n}:{},...e.prompt?{prompt:e.prompt}:{},sourceVideoId:Nr(e.sourceVideoId),...e.title?{title:e.title}:{}}}function rx(e){return e.error||e.status==="failed"||e.status==="cancelled"?"failed":e.done||e.status==="completed"?"completed":e.status==="in_progress"||e.status==="processing"?"processing":"pending"}function Lr(e){return{requestId:e.runId,status:rx(e),...e.entity?.url?{videoUrl:e.entity.url}:{},...e.output?{output:e.output}:{},...e.error?{error:ue(e.error)}:{}}}function Ki(e){return{requestId:e.runId,status:"pending"}}async function Wi(e,t){return pe(async()=>Lr(await I(e,t)),Qk,Yk)}function _e(e,t){if(t==="json"){l(e);return}if(t==="quiet"){console.log(e.videoUrl??e.requestId);return}b(`Request ID: ${e.requestId}`),b(`Status: ${e.status}`),e.videoUrl&&k(`Video URL: ${e.videoUrl}`),e.error&&a(`Error: ${e.error}`)}function ox(e){return Array.isArray(e?.languages)?e.languages.filter(t=>{if(!t||typeof t!="object"||Array.isArray(t))return!1;let n=t;return typeof n.language=="string"&&(n.status==="completed"||n.status==="failed")&&typeof n.videoId=="string"&&(n.videoUrl===null||typeof n.videoUrl=="string")}):[]}function ix(e){return`${e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")||"translation"}.mp4`}function ax(e,t){let n=ix(e);if(!t.has(n))return t.add(n),n;let r=n.slice(0,-4),o=2;for(;t.has(`${r}-${o}.mp4`);)o+=1;let i=`${r}-${o}.mp4`;return t.add(i),i}async function sx(e,t){let n=ox(e.output).filter(i=>i.status==="completed"&&!!i.videoUrl);if(n.length===0)throw new Error("Video translation completed without downloadable results");await Hk(t,{recursive:!0});let r=[],o=new Set;for(let i of n){let c=Xk(t,ax(i.language,o));await oe(i.videoUrl,c),r.push({language:i.language,path:c})}return r}var dx=new ut("status").description("Check a video lip-sync request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"])).action(async function(e,t){let r=R(this,t).format??"human";try{_e(Lr(await I("lipsyncVideo",e)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Bm=new ut("lipsync").description("Re-voice a ready workspace video with a public audio URL").requiredOption("--source-video-id <uuid>","READY workspace video UUID").requiredOption("--audio-url <url>","Public replacement voice audio URL").option("--mode <mode>","Quality mode: speed or precision","speed").requiredOption("-o, --output <path>","Local output video path").option("--idempotency-key <key>","Stable retry key").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.format==="human"?Vm("Starting video lip-sync...").start():null,n;try{let r=await cs(ex(e),e.idempotencyKey??Gi());if(n=r.runId,!e.wait){t?.stop(),_e(Ki(r),e.format);return}t&&(t.text="Waiting for video lip-sync...");let o=await Wi("lipsyncVideo",r.runId);if(o.status==="failed")throw new Error(o.error??"Video lip-sync failed");if(!o.videoUrl)throw new Error("Video lip-sync completed without a video URL");t&&(t.text="Downloading lip-synced video..."),await oe(o.videoUrl,e.output),t?.stop(),_e(o,e.format),e.format==="human"&&k(`Saved to: ${e.output}`)}catch(r){t?.stop(),a(ne(r,n),e.format),process.exit(s.GENERAL_ERROR)}}).addCommand(dx),Fm=new ut("translate-languages").description("List supported video translation target languages").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{try{let t=await ms();if(e.format==="json")l({languages:t});else for(let n of t)console.log(n)}catch(t){a(t instanceof Error?t.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),cx=new ut("status").description("Check a video translation request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"])).action(async function(e,t){let r=R(this,t).format??"human";try{_e(Lr(await I("translateVideo",e)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Gm=new ut("translate").description("Translate a ready workspace video into one or more languages").requiredOption("--source-video-id <uuid>","READY workspace video UUID").option("--target-language <language>","Target language (repeatable)",Mm,[]).option("--captions","Burn provider-generated captions into translated videos").requiredOption("--output-dir <path>","Directory for translated videos").option("--idempotency-key <key>","Stable retry key").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.format==="human"?Vm("Starting video translation...").start():null,n;try{let r=await us(tx(e),e.idempotencyKey??Gi());if(n=r.runId,!e.wait){t?.stop(),_e(Ki(r),e.format);return}t&&(t.text="Waiting for video translations...");let o=await Wi("translateVideo",r.runId);if(o.status==="failed")throw new Error(o.error??"Video translation failed");t&&(t.text="Downloading translated videos...");let i=await sx(o,e.outputDir);if(t?.stop(),e.format==="json")l({...o,downloads:i});else if(e.format==="quiet")for(let c of i)console.log(c.path);else{_e(o,e.format);for(let c of i)k(`${c.language}: ${c.path}`)}}catch(r){t?.stop(),a(ne(r,n),e.format),process.exit(s.GENERAL_ERROR)}}).addCommand(cx),lx=new ut("status").description("Check a video clipping request").argument("<id>","Request ID").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"])).action(async function(e,t){let n=R(this,t);try{_e(Lr(await I("clipVideo",e)),n.format??"human")}catch(r){a(r instanceof Error?r.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Km=new ut("clips").description("Turn a ready workspace video into short clips").requiredOption("--source-video-id <uuid>","READY workspace video UUID").option("--aspect <ratio>","Output aspect: 9:16, 16:9, or 1:1").option("--branding-id <uuid>","Workspace brand UUID").option("--caption-style <style>","Provider caption style").option("--captions","Burn provider-generated captions into clips").option("--duration <bucket>","Duration bucket: 30, 60, 180, or long",Mm,[]).option("--input-language <language>","Source language").option("--max-clips <count>","Maximum displayed clips (1-10)").option("--prompt <text>","Editorial clipping guidance").option("--title <text>","Provider job title").option("--idempotency-key <key>","Stable retry key").option("--no-wait","Do not wait for completion").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t;try{let n=await ls(nx(e),e.idempotencyKey??Gi());if(t=n.runId,!e.wait)return _e(Ki(n),e.format);let r=await Wi("clipVideo",n.runId);if(r.status==="failed")throw new Error(r.error??"Video clipping failed");_e(r,e.format)}catch(n){a(ne(n,t),e.format),process.exit(s.GENERAL_ERROR)}}).addCommand(lx);async function gx(){return process.stdin.isTTY?null:new Promise(e=>{let t="",n=!1;process.stdin.setEncoding("utf-8"),process.stdin.on("data",r=>{t+=r}),process.stdin.on("end",()=>{n||(n=!0,e(t.trim()?t:null))}),process.stdin.on("error",()=>{n||(n=!0,e(null))}),setTimeout(()=>{!n&&!t&&(n=!0,e(null))},500)})}function fx(e){let t=e?.trim().toLowerCase();if(!(!t||t==="any"||t==="all"))return t==="web"||t==="stock"?[t]:void 0}var hx=new le("find").description("Find video clips across the web and licensed stock").argument("<query>","Search query").option("-n, --max-results <count>","Maximum number of results","10").option("-o, --orientation <type>","Video orientation: landscape, portrait, square, any","any").option("-l, --license <type>","License type: free, premium, any","free").option("--source <source>","Catalog: web, stock, or any (default: any)","any").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async(e,t)=>{let{maxResults:n,orientation:r,license:o,format:i}=t,c=i==="human"?Jm("Finding videos...").start():null;try{let d=await is({query:e,options:{maxResults:parseInt(n,10),orientation:r,license:o,sources:fx(t.source)}});c?.stop();let u=d.data.results.flatMap(g=>g.results);if(i==="json"){l(d);return}if(i==="quiet"){u.forEach(g=>{console.log(g.embedUrl||g.previewUrl||g.thumbnailUrl)});return}if(u.length===0){b("No videos found");return}k(`Found ${u.length} videos for "${e}"`),console.log(),u.forEach((g,w)=>{let v=g.kind==="embed";console.log(`[${w+1}] ${g.title}`),console.log(` ${v?"Embed":"URL"}: ${g.embedUrl||g.previewUrl||g.thumbnailUrl}`),console.log(v?` Duration: ${g.duration}s | Embed only \u2014 plays in the host player, do not download`:` Duration: ${g.duration}s | Size: ${g.width}x${g.height}`),console.log(` Provider: ${g.provider}`),console.log()})}catch(d){c?.stop(),a(d instanceof Error?d.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),yx=new le("create").description("Generate one video from a pinned storyboard revision").requiredOption("--storyboard-revision <id>","Immutable storyboard revision UUID").option("--source-video <id>","Ready video from an earlier create call to use as base footage").option("--release","Render at 720p for release. Costs more; drafts are 480p by default").option("--team-id <id>","Workspace ID").option("--approval-receipt <receipt>","Receipt returned by the browser confirmation URL; omit on the first call to get that URL").requiredOption("--idempotency-key <key>","Stable invocation key bound into the approval receipt").option("--yes","Approve paid video generation").action(async e=>{if(!e.yes)return a("Pass --yes to approve video generation");try{l(await ps({quality:e.release?"release":void 0,sourceVideoId:e.sourceVideo,storyboardRevisionId:e.storyboardRevision,teamId:e.teamId},e.approvalReceipt,e.idempotencyKey))}catch(t){a(t instanceof Error?t.message:"Generation failed"),process.exit(s.GENERAL_ERROR)}});async function zm(e){let t=e==="-"?await gx():await ux(e,"utf-8");if(!t?.trim())throw new Error(e==="-"?"No storyboard Markdown was received on stdin":`Storyboard file is empty: ${e}`);return t}async function Hm(e,t={}){if(e)return e.length===1&&e[0]==="none"?[]:Promise.all(e.map(async n=>{let r;try{let x=JSON.parse(n);if(!x||typeof x!="object"||Array.isArray(x))throw new Error("Media binding must be a JSON object");r=x}catch(x){throw new Error(`Invalid --media binding. Pass one JSON object per binding, for example '{"handle":"actress-photo","path":"./actress.jpg","purpose":"identity"}'.`,{cause:x})}let o=$e(r.handle),i=$e(r.path),c=$e(r.fileUrl)??$e(r.url),d=$e(r.purpose),u=$e(r.videoRole),g=$e(r.analysisId)??$e(r.analysis);if(!o||!i&&!c||!d)throw new Error("Invalid --media binding. handle, purpose, and either path or url are required strings.");if(i&&c)throw new Error("A media binding cannot contain both path and url.");if(i&&d==="source"&&g)throw new Error("A source analysis is bound to the original uploaded URL. Reuse the url/name/mime/size binding printed by 'video reference analyze' instead of uploading path again.");if(i&&!t.uploadIdempotencyKey)throw new Error("Local storyboard media requires the command idempotency key.");let w=i?await Q(Tn(i),{idempotencyKey:`${t.uploadIdempotencyKey}:media:${o}`}):{name:$e(r.name),size:Number(r.size),type:$e(r.mime),url:c};if(!w.name||!w.type||!w.url||!Number.isSafeInteger(w.size)||w.size<=0)throw new Error(`URL media binding "${n}" requires name, mime, and positive integer size.`);let v=w.type.startsWith("video/")?"video":w.type.startsWith("audio/")?"audio":w.type.startsWith("image/")?"image":null;if(!v)throw new Error(`Unsupported media type for ${i??c}: ${w.type}`);if(!["source","style","identity","required"].includes(d))throw new Error(`Invalid media purpose: ${d}`);if(u&&!["reference","first-frame","last-frame"].includes(u))throw new Error(`Invalid videoRole: ${u}`);if(u&&v!=="image")throw new Error("videoRole is supported only for image bindings.");return{...g?{analysisId:g}:{},fileUrl:w.url,handle:o,kind:v,mime:w.type,name:w.name,purpose:d,size:w.size,...u?{videoRole:u}:{}}}))}function $e(e){return typeof e=="string"&&e.length>0?e:void 0}var bx=new le("create").description("Create a versioned Markdown video storyboard").requiredOption("--file <path>","Markdown file path, or - for stdin").requiredOption("--duration <seconds>","Exact total duration in seconds").requiredOption("--aspect <ratio>","Output aspect: 9:16, 16:9, or 1:1").option("--title <text>","Artifact label").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact create").option("--media <binding...>",'One JSON binding per asset: {"handle":"actress-photo","path":"./actress.jpg","purpose":"identity"}').option("--team-id <id>","Workspace ID").action(async e=>{try{l(await m("createVideoStoryboard",{aspectRatio:e.aspect,durationSec:Number(e.duration),mediaBindings:await Hm(e.media,{uploadIdempotencyKey:e.idempotencyKey}),storyboardMarkdown:await zm(e.file),teamId:e.teamId,title:e.title},e.idempotencyKey))}catch(t){a(t instanceof Error?t.message:"Storyboard creation failed"),process.exit(s.GENERAL_ERROR)}}),wx=new le("revise").description("Append an immutable revision to a video storyboard").argument("<storyboard-id>","Storyboard UUID").requiredOption("--base-revision <id>","Revision UUID that was edited").requiredOption("--file <path>","Complete Markdown file path, or - for stdin").requiredOption("--duration <seconds>","Exact total duration in seconds").requiredOption("--aspect <ratio>","Output aspect: 9:16, 16:9, or 1:1").option("--title <text>","Replacement artifact label").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact revision").option("--change-summary <text>","Short description of this revision").option("--media <binding...>",'Replace media bindings with one JSON object per asset; use the JSON printed by "video reference analyze" for analyzed source video').option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await m("reviseVideoStoryboard",{aspectRatio:t.aspect,baseRevisionId:t.baseRevision,changeSummary:t.changeSummary,durationSec:Number(t.duration),mediaBindings:await Hm(t.media,{uploadIdempotencyKey:t.idempotencyKey}),storyboardId:e,storyboardMarkdown:await zm(t.file),teamId:t.teamId,title:t.title},t.idempotencyKey))}catch(n){a(n instanceof Error?n.message:"Storyboard revision failed"),process.exit(s.GENERAL_ERROR)}}),vx=new le("show").description("Read a storyboard; print Markdown unless --json is used").argument("<storyboard-id>","Storyboard UUID").option("--revision <id>","Read one immutable revision UUID").option("--team-id <id>","Workspace ID").option("--json","Print the complete structured response").action(async(e,t)=>{try{let n=await m("readVideoStoryboard",{revisionId:t.revision,storyboardId:e,teamId:t.teamId});if(t.json){l(n);return}console.error(`${n.storyboard.title} \xB7 revision ${n.storyboard.revision.versionNumber} (${n.storyboard.revision.id})`),console.log(n.storyboard.revision.storyboardMarkdown)}catch(n){a(n instanceof Error?n.message:"Storyboard read failed"),process.exit(s.GENERAL_ERROR)}}),Ix=new le("storyboard").description("Create, revise, and read Markdown video storyboards").addCommand(bx).addCommand(wx).addCommand(vx),Xm=new le("analyze").description("Upload and analyze a reference video; its analysisId is the only analysis video generation consumes").requiredOption("--file <path>","Local reference video").requiredOption("--idempotency-key <key>","Stable key to reuse when retrying this exact analysis").option("--user-request <text>","What the analysis should focus on").option("--team-id <id>","Workspace ID").option("--no-wait","Return the durable run immediately").option("--json","Print the complete structured result").action(async e=>{try{let t=await Q(Tn(e.file),{idempotencyKey:`video-reference-analysis:${e.idempotencyKey}:source`});if(!t.type.startsWith("video/"))throw new Error(`Reference analysis requires a video, got ${t.type}`);let n=await gs({idempotencyKey:e.idempotencyKey,sourceUrl:t.url,teamId:e.teamId,userRequest:e.userRequest}),r={analysisId:n.runId,fileUrl:t.url,handle:"source-video",kind:"video",mime:t.type,name:t.name,purpose:"source",size:t.size};if(e.wait===!1){l({...n,binding:r,source:t});return}let o=await fs(n.runId,e.teamId);if(e.json){l({...o,binding:r,source:t});return}let i=o.output?.analysis??{};console.log(typeof i.promptContext=="string"?i.promptContext:JSON.stringify(o.output,null,2)),console.error(`Analysis run: ${n.runId}`),console.error(`Storyboard media JSON: ${JSON.stringify(r)}`)}catch(t){a(t instanceof Error?t.message:"Reference analysis failed"),process.exit(s.GENERAL_ERROR)}});Xm.addHelpText("after",`
|
|
277
|
+
${ie.gray("# Prints an analysisId plus a ready storyboard media binding. Pass that")}
|
|
278
|
+
${ie.gray("# binding to video storyboard create/revise --media; generation reads the")}
|
|
279
|
+
${ie.gray("# analysis from the analysisId, never from local files.")}
|
|
280
|
+
`);var kx=new le("status").description("Read a video-reference analysis run").argument("<run-id>","Analysis run UUID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{let n=await I("analyzeVideoReference",e,t.teamId);l(n);let r=oo(n);if(r)throw new Error(r)}catch(n){a(n instanceof Error?n.message:"Status read failed"),process.exit(s.GENERAL_ERROR)}}),xx=new le("reference").description("Upload and inspect reusable video references").addCommand(Xm).addCommand(kx),Rx=new le("status").description("Read video background status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{let n=await I("createVideo",e,t.teamId);l(n);let r=oo(n);if(r)throw new Error(r)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Cx=new le("inject").description("Inject thumbnail into video (first frame + file icon)").requiredOption("-i, --video <path>","Input video file").requiredOption("-t, --thumbnail <path>","Thumbnail image").option("-o, --output <path>","Output video (default: video-with-thumb.mp4)").option("-f, --format <format>","Output format: human, json, quiet",y("--format",["human","json","quiet"]),"human").action(async e=>{let t=e.format,n=t==="human"?Jm("Injecting thumbnail...").start():null;try{let r=Tn(e.video),o=Tn(e.thumbnail),i=e.output?Tn(e.output):r.replace(/\.mp4$/,"-with-thumb.mp4");await Ji(r),await Ji(o);let c=px;if(c)try{await Ji(c)}catch{c=null}if(!c)try{c=Ur("which ffmpeg",{encoding:"utf8"}).trim()}catch{throw new Error("ffmpeg not found. Install ffmpeg or ffmpeg-static.")}let d=mx(c,["-i",r],{encoding:"utf8"});if(d.error)throw new Error(`Failed to probe video: ${d.error.message}`);let u=(d.stderr??"").match(/(\d{2,5})x(\d{2,5})/);if(!u)throw new Error("Could not detect video dimensions");let[,g,w]=u;n&&(n.text="Creating thumbnail frame...");let v="/tmp/cc-thumb-frame.mp4";Ur(`${c} -y -loop 1 -i "${o}" -vf "scale=${g}:${w}:force_original_aspect_ratio=decrease,pad=${g}:${w}:(ow-iw)/2:(oh-ih)/2,setsar=1" -t 0.033 -r 30 -c:v libx264 -pix_fmt yuv420p "${v}"`,{stdio:"pipe"}),n&&(n.text="Concatenating with video...");let x="/tmp/cc-concat-video.mp4";if(Ur(`${c} -y -i "${v}" -i "${r}" -filter_complex "[0:v][1:v]concat=n=2:v=1:a=0[v]" -map "[v]" -map 1:a -c:v libx264 -preset ultrafast -crf 18 -c:a copy "${x}"`,{stdio:"pipe"}),n&&(n.text="Adding file icon thumbnail..."),Ur(`${c} -y -i "${x}" -i "${o}" -map 0 -map 1 -c copy -c:v:1 png -disposition:v:1 attached_pic "${i}"`,{stdio:"pipe"}),await Wm(v,{force:!0}),await Wm(x,{force:!0}),n?.stop(),t==="json"){l({success:!0,output:i});return}if(t==="quiet"){console.log(i);return}k(`Thumbnail injected: ${i}`)}catch(r){n?.stop(),a(r instanceof Error?r.message:"Unknown error"),process.exit(s.GENERAL_ERROR)}}),Sx=new le("thumbnail").description("Thumbnail operations").addCommand(Cx).addCommand(qm),_r=new le("video").description("Build a video from scratch \u2014 brief or storyboard to stock and generated footage, translation, lipsync, analysis (for a finished deck, use presentation video)").addCommand(hx).addCommand(Sx).addCommand(Km).addCommand(Bm).addCommand(Fm).addCommand(Gm).addCommand(sm);_r.addCommand(yx).addCommand(Ix).addCommand(xx).addCommand(Rx);_r.addHelpText("after",`
|
|
281
|
+
${ie.bold("Examples:")}
|
|
282
|
+
${ie.gray("# Storyboard-first video from a brief")}
|
|
283
|
+
$ ${p.commands[0]} video storyboard create --file brief.md --duration 60 --aspect 16:9 --idempotency-key launch-1
|
|
284
|
+
|
|
285
|
+
${ie.gray("# Find licensed stock footage")}
|
|
286
|
+
$ ${p.commands[0]} video find "city timelapse"
|
|
287
|
+
|
|
288
|
+
${ie.bold("Before generating:")}
|
|
289
|
+
${ie.gray("# Approve the content, then approve the spend \u2014 two questions. Paste the")}
|
|
290
|
+
${ie.gray("# storyboard text into your reply and get a yes on it BEFORE pinning a")}
|
|
291
|
+
${ie.gray("# revision; revising is free and append-only, a pinned revision is not.")}
|
|
292
|
+
${ie.gray("# The browser confirmation video create requires is about cost and")}
|
|
293
|
+
${ie.gray("# destination, not the user reading the script. --yes is neither.")}
|
|
294
|
+
$ ${p.commands[0]} video storyboard show <storyboard-id>
|
|
295
|
+
$ ${p.commands[0]} video storyboard revise <storyboard-id> --base-revision <revision-id> --file brief-v2.md --idempotency-key launch-2
|
|
296
|
+
|
|
297
|
+
${ie.bold("See also:")}
|
|
298
|
+
${ie.gray("# Already have a deck? Render it to MP4 (narration, avatar, captions)")}
|
|
299
|
+
$ ${p.commands[0]} presentation video <slug>
|
|
300
|
+
`);import{Command as zi}from"commander";var Ex=new zi("create").description("Start background visual-abstract generation").argument("<brief>","Dense source brief").option("--title <title>","Artifact title").option("--aspect <ratio>","1:1, 16:9, 9:16, 4:3, or 3:4","1:1").option("--quality <tier>","fast, best, or enterprise","best").option("--preset <preset>","Output preset","executive-one-pager").option("--output <type>","raster or vector","raster").option("--branding-id <id>","Branding ID").option("--reference-url <url...>","Up to three image URLs to use as visual references").option("--team-id <id>","Workspace ID").option("--idempotency-key <key>","Reuse this key to retrieve the same generation on retry").option("--yes","Confirm generation using workspace credits").action(async(e,t)=>{t.yes||(a("Pass --yes to confirm visual-abstract generation"),process.exit(s.INVALID_INPUT));try{let n=Array.isArray(t.referenceUrl)?t.referenceUrl.map((r,o)=>({label:`visual-reference-${o+1}`,url:r})):void 0;l(await m("createVisualAbstract",{confirmed:!0,aspectRatio:t.aspect,brandingId:t.brandingId,brief:e,outputPreset:t.preset,outputType:t.output,qualityTier:t.quality,referenceImages:n,teamId:t.teamId,title:t.title},t.idempotencyKey))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(s.GENERAL_ERROR)}}),Tx=new zi("status").description("Read visual-abstract generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(e,t)=>{try{l(await I("createVisualAbstract",e,t.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(s.GENERAL_ERROR)}}),Ym=new zi("visual-abstract").description("Generate a one-page visual abstract graphic (raster or vector) from a dense brief").addCommand(Ex).addCommand(Tx);var Hi=[el,ml,Od,Jc,_m,Pl,wl,pl,_r,_i,Nm,Em,Ui,ji,ii,gl,fi,Dl,Ad,Dd,Ym,bl,xd,Do,yl,ni,oi,rl,al,sl,li,tl,Om,Dm];function Qm(e){for(let t of Hi)e.addCommand(t)}function Zm(e,t,n){let r=t?`${t} ${e.name()}`:e.name();n.set(r,{arguments:e.registeredArguments.filter(o=>o.required).map(o=>`<${o.name()}>`),requiredOptions:e.options.filter(o=>o.mandatory).map(o=>o.long).filter(o=>!!o)});for(let o of e.commands)Zm(o,r,n)}var qr;function $x(){if(!qr){qr=new Map;for(let e of Hi)Zm(e,"",qr)}return qr}function eu(e){let t=$x().get(e);return t?[...t.arguments,...t.requiredOptions.map(n=>`${n} \u2026`)].join(" "):""}var tu=["presentations","media","branding","knowledge","research","artifacts","agents","support"],Xi={agents:"Scheduled agents and agent memory",artifacts:"Polls, microsites, ad sets and visual abstracts",branding:"Brand profiles, tokens, logos and competitors",knowledge:"Library documents, folders and the Knowledge Hub",media:"Voiceover, music, SFX, images, stock footage, avatars and video",presentations:"Decks, PowerPoint import, speaker notes and deck\u2192MP4",research:"Scraping, transcripts, web/news/image search and extraction",support:"Filing and following bug reports, questions and feature requests"},Ax="other";function Px(e){let t=e.category?.trim();return t&&t.length>0?t:Ax}function nu(e){let t=tu.indexOf(e);return t===-1?tu.length:t}function $n(e){let t=new Map;for(let n of e){let r=Px(n),o=t.get(r);o?o.push(n):t.set(r,[n])}return[...t.entries()].sort(([n],[r])=>nu(n)-nu(r)||n.localeCompare(r)).map(([n,r])=>({capabilities:[...r].sort((o,i)=>o.name.localeCompare(i.name)),category:n}))}function Yi(e){return e.lifecycle?.mode==="background"}function Qi(e,t){let n=e.lifecycle?.status?.cliCommand?.trim();if(!(!Yi(e)||!n))return`${t} ${n} <run-id>`}function Ox(e){switch(e.billing){case"free":return"free";case"quota":return"plan quota";case"fixed":return"credits (fixed)";case"dynamic":return"credits (usage-based)";case"delegated":return"credits (on completion)";default:return"unknown \u2014 check `capabilities`"}}function jr(e){return e.replace(/\|/g,"\\|").replace(/\r?\n/g," ").trim()}function Dx(e,t){let n=Qi(e,t);return n?`run id \u2014 poll \`${n}\``:`immediate (${e.operation??"call"})`}function He(e,t){let n=["| Command | What it does | Takes | Returns | Cost | Scopes |","|---|---|---|---|---|---|"],r=e.map(o=>{let i=eu(o.name),c=o.scopes?.length?o.scopes.map(d=>`\`${d}\``).join(", "):"\u2014";return`| \`${t} ${jr(o.name)}\` | ${jr(o.description??"")} | ${i?`\`${jr(i)}\``:"\u2014"} | ${Dx(o,t)} | ${Ox(o)} | ${c} |`});return[...n,...r].join(`
|
|
301
|
+
`)}function ae(e,t){if(e.source==="live")return`<!-- Generated from the live ${t.name} capability catalog (v${e.catalogVersion}, ${e.capabilities.length} capabilities) at install time. Re-run \`${t.cmd} skill install\` to refresh. -->`;let n=e.reason?` Reason: ${jr(e.reason).replace(/\.+$/,"")}.`:"";return`<!-- STALE-RISK: the live catalog could not be read at install time, so this was rendered from the snapshot baked into the installed CLI (v${e.catalogVersion}, ${e.capabilities.length} capabilities).${n} Run \`${t.cmd} login\` then \`${t.cmd} skill install --force\` to regenerate from the live catalog, and treat \`${t.cmd} capabilities\` as authoritative over this file. -->`}function ru(e){return e.map(t=>`- [${t}](#${t.toLowerCase().replace(/[^a-z0-9 -]/g,"").replace(/ /g,"-")})`).join(`
|
|
302
|
+
`)}var Nx=["get","presentation video prepare","presentation video inspect","presentation video settings","presentation video edit","presentation video presenter","presentation video","presentation video versions","presentation video restore","presentation video refresh","presentation video-narration","presentation speaker-notes","video library list","avatar options"];function Lx(e){let t=new Map(e.map(n=>[n.name,n]));return Nx.map(n=>t.get(n)).filter(n=>n!==void 0)}function qt(e,t){let{cmd:n}=e,r=Lx(t.capabilities),o=t.capabilities.find(c=>c.name==="presentation video"),i=o?Qi(o,n)??`${n} presentation video status <run-id>`:`${n} presentation video status <run-id>`;return`${ae(t,e)}
|
|
289
303
|
|
|
290
304
|
# Deck \u2192 MP4 (\`${n} presentation video\`)
|
|
291
305
|
|
|
@@ -520,11 +534,11 @@ not maintain a second copy.
|
|
|
520
534
|
|
|
521
535
|
## Every capability in this flow
|
|
522
536
|
|
|
523
|
-
${
|
|
537
|
+
${He(r,n)}
|
|
524
538
|
|
|
525
539
|
If something you need is not in this table, do not conclude it is missing \u2014
|
|
526
540
|
run \`${n} capabilities --search video\`.
|
|
527
|
-
`}var
|
|
541
|
+
`}var Ux=["video reference analyze","video storyboard create","video storyboard revise","video storyboard show","video create","search video","video translate-languages","video translate","video lipsync","media analyze","media import","video library list"];function Zi(e){let t=new Map(e.map(n=>[n.name,n]));return Ux.map(n=>t.get(n)).filter(n=>n!==void 0)}function Vr(e,t){let{cmd:n}=e,r=Zi(t.capabilities);return`${ae(t,e)}
|
|
528
542
|
|
|
529
543
|
# Video from scratch (\`${n} video\`)
|
|
530
544
|
|
|
@@ -694,63 +708,63 @@ ${n} video library list <project-id> # reusable clips and rec
|
|
|
694
708
|
|
|
695
709
|
## Every capability in this flow
|
|
696
710
|
|
|
697
|
-
${
|
|
711
|
+
${He(r,n)}
|
|
698
712
|
|
|
699
713
|
If something you need is not in this table, do not conclude it is missing \u2014
|
|
700
714
|
run \`${n} capabilities --search video\`.
|
|
701
|
-
`}var
|
|
715
|
+
`}var _x=12,qx={media:"video.md",presentations:"deck-to-video.md"};function jx(e,t,n,r){let{cmd:o}=e,i=Xi[n]??n,c=r.filter(Yi),d=r.filter(w=>w.billing!==void 0&&w.billing!=="free"),u=qx[n],g=["Every capability",...c.length>0?["Background operations"]:[]];return`${ae(t,e)}
|
|
702
716
|
|
|
703
717
|
# ${n} \u2014 ${i}
|
|
704
718
|
|
|
705
|
-
${r.length} capabilit${r.length===1?"y":"ies"} in this category${
|
|
719
|
+
${r.length} capabilit${r.length===1?"y":"ies"} in this category${d.length>0?`, ${d.length} of which ${d.length===1?"costs":"cost"} credits or ${d.length===1?"counts":"count"} against a plan quota`:", all free"}.${u?`
|
|
706
720
|
|
|
707
|
-
Step-by-step flow: [${
|
|
708
|
-
${r.length>
|
|
721
|
+
Step-by-step flow: [${u}](${u}).`:""}
|
|
722
|
+
${r.length>_x?`
|
|
709
723
|
## Contents
|
|
710
724
|
|
|
711
|
-
${
|
|
725
|
+
${ru(g)}
|
|
712
726
|
`:""}
|
|
713
727
|
## Every capability
|
|
714
728
|
|
|
715
|
-
${
|
|
716
|
-
${
|
|
729
|
+
${He(r,o)}
|
|
730
|
+
${c.length>0?`
|
|
717
731
|
## Background operations
|
|
718
732
|
|
|
719
733
|
These return a run id immediately and keep working. Poll the status command
|
|
720
734
|
until it reports done \u2014 do not assume success from the accept response.
|
|
721
735
|
|
|
722
|
-
${
|
|
736
|
+
${c.map(w=>`- \`${o} ${w.name}\` \u2192 \`${o} ${w.lifecycle?.status?.cliCommand??""} <run-id>\`${w.lifecycle?.status?.pollAfterSeconds?` (first poll after ~${w.lifecycle.status.pollAfterSeconds}s)`:""}`).join(`
|
|
723
737
|
`)}
|
|
724
738
|
`:""}
|
|
725
739
|
Anything missing here? Run \`${o} capabilities --category ${n}\` \u2014 the
|
|
726
740
|
catalog is authoritative and always current; this file is a snapshot of it.
|
|
727
|
-
`}function
|
|
741
|
+
`}function ou(e,t,n={}){let r=[{content:qt(e,t),name:"deck-to-video"},{content:Vr(e,t),name:"video"}];for(let{capabilities:o,category:i}of $n(t.capabilities)){let c=n[i];r.push({content:jx(e,t,i,o)+(c?`
|
|
728
742
|
---
|
|
729
743
|
|
|
730
|
-
${
|
|
744
|
+
${c}`:""),name:i})}return r}function iu(e){let t=[{file:"deck-to-video.md",when:"An existing deck must become an MP4 \u2014 narration, voice, avatar, music, captions."},{file:"video.md",when:"A video is being built from a brief or storyboard, with no deck involved."}];for(let{capabilities:n,category:r}of $n(e.capabilities))t.push({file:`${r}.md`,when:`${Xi[r]??r} (${n.length} commands).`});return t}function An(e){return[...new Set(e.flatMap(t=>[t.name,...t.lifecycle.status?.cliCommand?[t.lifecycle.status.cliCommand]:[]]))]}function se(e,t,n,r="direct-operation-smoke"){let o=r==="ui-e2e"?"Browser/product E2E only; it does not execute the built CLI through the HTTP adapter.":"Canonical-operation smoke with adapter assertions; it does not execute a built CLI through the HTTP adapter.";return{level:"partial",boundary:r,kind:"smoke",source:`scripts/lib/deployment-smoke-catalog.ts#${t}`,case:t,run:`pnpm smoke -- run ${e} --url <non-production-deployment>`,claim:`${o} ${n}`}}function Mr(e,t,n){return{level:"partial",boundary:"mocked-adapter-integration",kind:"integration",source:e,case:t,run:`pnpm exec vitest run ${e}`,claim:`In-memory adapter integration with mocked canonical operations; no real HTTP operation or fixture postcondition is reached. ${n}`}}function ea(e,t,n){return{level:"full",boundary:"real-cli-http-journey",kind:"smoke",source:`scripts/lib/deployment-smoke-catalog.ts#${t}`,case:t,run:`pnpm smoke:${e} -- --url http://localhost:3000`,claim:`Built CLI subprocess through the real HTTP adapter, governance, and canonical operation, with a controlled fixture and independently verified postcondition. ${n}`}}var au="tests/integration/tool-surface/presentations.integration.test.ts",Vx="tests/integration/tool-surface/branding.integration.test.ts";function su(e){switch(e){case"create":return[Mr(au,"normalizes MCP and CLI starts into the same durable job input","MCP and CLI normalize the same generation input."),se("presentation","presentation.create","A real deck is generated and persisted.","ui-e2e")];case"export":return[se("presentation","presentation.export","Real PDF, PPTX, HTML, and PNG exports are validated.","ui-e2e")];case"presentation import":case"presentation import transform":return[se("presentation-import","presentation.import-powerpoint","A PowerPoint is imported, reviewed, and reopened.","ui-e2e")];case"presentation speaker-notes":case"presentation speaker-notes-status":return[se("presentation","presentation.speaker-notes","Persisted speaker notes are ready after reload.","ui-e2e")];default:return[]}}function Mx(e){return["presentation video inspect","video library list"].includes(e)?[se("presentation-video-agent-reads","video.presentation.agent-read-surfaces","Canonical agent surfaces share one owned project/source result.")]:["presentation video edit","presentation video refresh","presentation video restore","presentation video versions","presentation video-narration","presentation video-narration-status"].includes(e)?[se("presentation-video-agent-edits","video.presentation.agent-edit-surfaces","Draft edits and restores persist through canonical agent operations.")]:e==="presentation video presenter"?[se("presentation-video-scene-presenter","video.presentation.scene-presenter-agent-surfaces","A per-scene presenter override persists across agent surfaces.")]:["presentation video prepare","presentation video settings","presentation video status"].includes(e)?[Mr(au,`generated MCP and CLI ${e}`,"The integration suite compares matching MCP and CLI adapter results.")]:e==="get"||e.startsWith("presentation speaker-notes")?su(e):[]}function Bx(e){if(["branding list","branding profile","branding competitor list"].includes(e))return[se("branding","branding.agent-read-surfaces","Brand reads resolve the same controlled brand across agent surfaces.")];if(e==="branding extract")return[se("branding","branding.extraction-approval-refusal","Only the approval refusal and no-charge boundary is proven.")];if(e==="branding create")return[se("branding","branding.create","Creation, idempotency, and plan-limit refusal reach the canonical operation.")];let t=[["branding product","branding.products","Product lifecycle behavior is exercised."],["branding variant","branding.variants","Variant lifecycle behavior is exercised."],["branding version","branding.versions","Version lifecycle behavior is exercised."],["branding voice","branding.voice","Voice document behavior is exercised."],["branding gradient","branding.gradients","Gradient replacement behavior is exercised."],["branding variations","branding.gradients","Variation generation is declared; provider-backed CLI success is not proven."],["branding guardrail","branding.guardrails","Guardrail lifecycle behavior is exercised."],["branding quality","branding.quality","Quality reads and repair refusal are exercised."],["branding sync","branding.sync","A durable linked-deck sync completes."]];for(let[n,r,o]of t)if(e.startsWith(n))return[se("branding",r,o)];return["branding star","branding default","branding delete"].some(n=>e.startsWith(n))?[se("branding","branding.lifecycle-pointers","Star, default, and deletion pointers reach canonical operations.")]:e==="branding update"?[se("branding","branding.record-fields","Rename and parent moves reach updateBrand.")]:e==="branding set"?[Mr(Vx,"runs the free brand write on both lanes without an approval receipt","MCP and CLI invoke the same free brand write in memory.")]:[]}function Fx(e){return["agent roster list","agent roster get","agent visibility set"].includes(e)?[ea("agent-roster-visibility","agent.roster-visibility","Owner and teammate roster projections, visibility CAS, replay, conflicts, and database postconditions are verified.")]:["agent list","agent get","agent configure","agent pause","agent resume"].includes(e)?[ea("agent-management","agent.management-primitives","Owned-Agent reads, configuration CAS, schedule transitions, replay, conflicts, and database postconditions are verified.")]:[]}function Gx(e,t){return e==="presentation"?su(t):e==="presentation-video"?Mx(t):e==="agents"?Fx(t):Bx(t)}function ta(e,t){return An(t).map(n=>{let r=Gx(e,n),o=r.length===0?"missing":r.some(i=>i.level==="full")?"full":"partial";return{command:n,evidence:r,level:o}})}function du(e){return e==="presentation video"||e.startsWith("presentation video ")||e.startsWith("presentation video-")}function na(e,t){let n=new Set(t.capabilities.map(r=>r.name));return e.flow.filter(r=>n.has(r))}function Kx(e,t){let n=new Set(t.capabilities.map(o=>o.name)),r=(o,i)=>n.has(o)?`- \`${e.cmd} ${o}\` \u2014 ${i}`:void 0;return`# Presentation workflow
|
|
731
745
|
|
|
732
746
|
Use this flow for decks, not MP4 production or brand-library maintenance.
|
|
733
747
|
|
|
734
748
|
1. Run \`../scripts/check-auth.sh\`, then \`../scripts/check-flow.sh\`.
|
|
735
|
-
2. Inspect exact flags with \`${
|
|
749
|
+
2. Inspect exact flags with \`${e.cmd} <command> --help\`; never infer a flag from another surface.
|
|
736
750
|
3. Gather source material before generation and pass only user-provided or verified context.
|
|
737
751
|
4. If the user chose a saved brand, pass its id during creation. Do not claim a brand can be attached to an arbitrary existing deck.
|
|
738
752
|
5. Retain a background run id and poll the catalog-named status command.
|
|
739
|
-
6. Resolve the final deck with \`${
|
|
753
|
+
6. Resolve the final deck with \`${e.cmd} get\`; export only when requested.
|
|
740
754
|
|
|
741
755
|
## Useful operations present in this catalog
|
|
742
756
|
|
|
743
757
|
${[r("create","create a deck from a topic and context"),r("presentation import","import a PowerPoint into a new deck"),r("get","read the resulting presentation"),r("export","export a deck to a supported format"),r("presentation delete","delete only after explicit user intent")].filter(Boolean).join(`
|
|
744
758
|
`)}
|
|
745
759
|
|
|
746
|
-
For narration, scenes, presenters, captions, or MP4 output, load \`${
|
|
747
|
-
`}function
|
|
760
|
+
For narration, scenes, presenters, captions, or MP4 output, load \`${e.name}-presentation-video\`.
|
|
761
|
+
`}function Wx(e,t){let n=na(jt.branding,t).map(r=>`- \`${e.cmd} ${r}\``).join(`
|
|
748
762
|
`);return`# Branding workflow
|
|
749
763
|
|
|
750
764
|
Branding owns saved private and team brand profiles. It does not edit arbitrary deck HTML.
|
|
751
765
|
|
|
752
766
|
1. Run \`../scripts/check-auth.sh\`, then discover the live surface with \`../scripts/discover-capabilities.sh\`.
|
|
753
|
-
For least privilege, authenticate with \`${
|
|
767
|
+
For least privilege, authenticate with \`${e.cmd} login --scopes brands:read,brands:write\`.
|
|
754
768
|
2. Resolve the workspace or team explicitly when requested.
|
|
755
769
|
3. List or inspect before mutating. Use the returned brand id; never guess from a name or URL.
|
|
756
770
|
4. Select a brand during presentation creation. A later sync may propagate changed tokens only to decks already linked to that brand.
|
|
@@ -761,13 +775,13 @@ Branding owns saved private and team brand profiles. It does not edit arbitrary
|
|
|
761
775
|
${n||"No common anchors are present in this snapshot; run discovery before acting."}
|
|
762
776
|
|
|
763
777
|
Read [commands.md](commands.md) for every available brand operation and its scopes.
|
|
764
|
-
`}function
|
|
778
|
+
`}function Jx(e,t){let n=na(jt.agents,t).map(r=>`- \`${e.cmd} ${r}\``).join(`
|
|
765
779
|
`);return`# Agents workflow
|
|
766
780
|
|
|
767
781
|
This skill owns scheduled Mindframes Agents. It is not a guide for software-development agents.
|
|
768
782
|
|
|
769
783
|
1. Run \`../scripts/check-auth.sh\`, then discover the deployed Agents surface with \`../scripts/discover-capabilities.sh\`.
|
|
770
|
-
Use \`${
|
|
784
|
+
Use \`${e.cmd} login --scopes agents:read,agents:write\` only when a visibility mutation is required.
|
|
771
785
|
2. Use \`agent list\` and \`agent get\` for Agents owned by the caller. Use \`agent roster list\` and \`agent roster get\` for the safe team-visible roster projection.
|
|
772
786
|
3. Never infer global or cross-team discovery. Legacy \`public\` visibility is readable only under the existing same-team roster policy and cannot be newly selected.
|
|
773
787
|
4. Before changing visibility, read the owned Agent's current visibility. Pass it as \`--expected-visibility\` to \`agent visibility set\`; choose only \`private\` or \`team\`.
|
|
@@ -778,25 +792,25 @@ This skill owns scheduled Mindframes Agents. It is not a guide for software-deve
|
|
|
778
792
|
${n||"No common anchors are present in this snapshot; run discovery before acting."}
|
|
779
793
|
|
|
780
794
|
Read [commands.md](commands.md) for current inputs, outputs, scopes, and exact CLI help.
|
|
781
|
-
`}var
|
|
795
|
+
`}var zx=[{id:1,prompt:"Create a ten-slide investor presentation from my supplied metrics using team brand br_42, then give me the final deck link.",expected_output:"A create-and-verify plan that applies the saved brand only during deck creation.",expectations:["Runs the auth and flow checks before a product operation.","Inspects create help instead of inventing flags.","Passes the chosen brand id during presentation creation.","Polls a background run and resolves the final deck with get."]},{id:2,prompt:"Import ./board-update.pptx and export the resulting presentation as PDF.",expected_output:"An import, verification, and export flow using only real presentation commands.",expectations:["Uses presentation import and reads its help.","Does not route through standalone video or presentation-video commands.","Verifies the imported presentation before export."]},{id:3,prompt:"Turn presentation pr_123 into a narrated vertical MP4 with captions.",expected_output:"A handoff to the presentation-video skill rather than deck creation.",expectations:["Routes to the presentation-video skill.","Does not use the from-scratch video pipeline."]}],Hx=[{id:1,prompt:"Make presentation pr_123 a 9:16 MP4 with concise narration and captions, and let me approve before rendering.",expected_output:"A prepare, inspect, settings, render, and status flow with a human spend gate.",expectations:["Runs auth and flow checks before product work.","Prepares and inspects before rendering.","Separates editable preparation from paid render approval.","Polls the exact render status command and verifies the MP4 result."]},{id:2,prompt:"For presentation-video project pv_9, rewrite only slide s_4 narration to be warmer and shorter, then show me the updated draft.",expected_output:"A targeted narration edit and project inspection without starting a render.",expectations:["Uses the named slide narration operation.","Does not start a paid render without a separate request and approval.","Reads the updated project after the edit completes."]},{id:3,prompt:"Create a 30-second product promo from this script; there is no presentation.",expected_output:"A handoff to the standalone video skill.",expectations:["Routes to the standalone video skill because no deck exists.","Does not create a presentation-video project."]}],Xx=[{id:1,prompt:"Our team brand logo and fonts changed. Update br_42 and propagate the changes to presentations already linked to it.",expected_output:"A read, update, verify, and linked-deck sync flow over the existing brand.",expectations:["Reads br_42 before mutation.","Verifies the saved brand profile.","Uses sync semantics only for already-linked presentations.","Does not invent arbitrary brand attachment."]},{id:2,prompt:"Find our saved Acme team brand, then create a new quarterly deck using it.",expected_output:"A brand lookup followed by presentation creation with the resolved id.",expectations:["Lists or gets the brand instead of guessing an id.","Hands deck creation to the presentation skill.","Uses the brand id during deck creation."]},{id:3,prompt:"Move slide 4 after slide 7 and replace its hero image.",expected_output:"A handoff to presentation editing, not a branding mutation.",expectations:["Does not trigger brand profile writes.","Routes to presentation editing capabilities."]}],Yx=[{id:1,prompt:"Share my private Agent ag_42 with this workspace, but do not make it globally public.",expected_output:"An owner read, compare-and-set visibility mutation to team, and owner plus roster verification flow.",expectations:["Reads the owned Agent before mutation and uses its returned visibility as expectedVisibility.","Selects team rather than inventing public exposure.","Verifies the owner record and team roster after the mutation."]},{id:2,prompt:"Show me the Agents my teammates have shared with our workspace.",expected_output:"A paginated roster list followed by safe roster detail reads when needed.",expectations:["Uses agent roster list rather than owner-only agent list.","Does not claim cross-team or global public search.","Does not expose instructions, credentials, or private configuration."]},{id:3,prompt:"Turn presentation pr_123 into a narrated MP4.",expected_output:"A handoff to the presentation-video skill.",expectations:["Routes to the presentation-video skill, not scheduled Agents.","Does not create or configure an Agent."]}],jt={presentation:{type:"presentation",title:"Presentation",description:e=>`Use whenever the user wants to create, import, inspect, export, organize, share, delete, or edit a ${e} presentation, deck, slides, pitch deck, or PowerPoint. Do not use for turning an existing deck into an MP4 (use ${e}-presentation-video), video from scratch (use ${e}-video), or maintaining saved brands (use ${e}-branding).`,discoveryQuery:"presentation",select:e=>e.category==="presentations"&&!du(e.name),flow:["create","presentation status","get","export"],workflow:Kx,evals:zx},"presentation-video":{type:"presentation-video",title:"Presentation to MP4",description:e=>`Use whenever an existing ${e} presentation or deck must become a narrated video or MP4, or when its narration, scenes, presenter, music, captions, draft versions, or render status must be managed. Do not use for video from a brief with no deck (use ${e}-video), ordinary slide editing (use ${e}-presentation), or brand maintenance (use ${e}-branding).`,discoveryQuery:"presentation video",select:e=>du(e.name)||e.name==="presentation speaker-notes"||e.name==="get"||e.name==="avatar options"||e.name==="video library list",flow:["presentation video prepare","presentation video inspect","presentation video settings","presentation video","presentation video status"],workflow:qt,evals:Hx},branding:{type:"branding",title:"Branding",description:e=>`Use whenever the user wants to discover, create, inspect, or maintain private or team ${e} brand profiles, tokens, logos, fonts, voice, guardrails, products, versions, quality, or linked-presentation updates. Trigger for "use our brand" when a saved brand must first be resolved. Do not use for arbitrary slide edits or presentation-to-MP4 work.`,discoveryQuery:"branding",select:e=>e.category==="branding",flow:["branding list","branding profile","branding set","branding sync"],workflow:Wx,evals:Xx},agents:{type:"agents",title:"Agents",description:e=>`Use for scheduled ${e} Agents: owned-Agent management, workspace roster discovery, and owner-authorized private/team visibility changes. Do not trigger for generic coding agents, presentation-to-MP4 work, or global/public Agent search.`,discoveryQuery:"agent",select:e=>e.category==="agents",flow:["agent list","agent roster list","agent roster get","agent visibility set"],workflow:Jx,evals:Yx}};function Br(e,t){return t.capabilities.filter(jt[e].select).sort((n,r)=>n.name.localeCompare(r.name))}function Qx(e,t,n){let r=Br(n.type,t),o=new Set(r.map(c=>c.name)),i=An(r).filter(c=>!o.has(c));return`${ae(t,e)}
|
|
782
796
|
|
|
783
797
|
# ${n.title} commands
|
|
784
798
|
|
|
785
|
-
Generated from the capability catalog. It describes ${r.length} callable operations; run \`${
|
|
799
|
+
Generated from the capability catalog. It describes ${r.length} callable operations; run \`${e.cmd} capabilities --search "${n.discoveryQuery}"\` for the deployed surface.
|
|
786
800
|
|
|
787
|
-
${
|
|
801
|
+
${He(r,e.cmd)}
|
|
788
802
|
${i.length?`## Recovery commands
|
|
789
803
|
|
|
790
|
-
${i.map(
|
|
804
|
+
${i.map(c=>`- \`${e.cmd} ${c}\``).join(`
|
|
791
805
|
`)}
|
|
792
806
|
`:""}
|
|
793
|
-
`}function
|
|
807
|
+
`}function Zx(e,t,n){let r=ta(n.type,Br(n.type,t)),o=r.map(g=>{let w=g.evidence.length?g.evidence.map(x=>`**${x.kind}** ${x.source} \u2014 ${x.case}`).join("<br>"):"No non-unit evidence registered.",v=g.evidence.length?g.evidence.map(x=>x.claim).join(" "):"Do not claim integration or smoke coverage for this command.";return`| \`${e.cmd} ${g.command}\` | **${g.level.toUpperCase()}** | ${w} | ${v} |`}),i=[...new Set(r.flatMap(g=>g.evidence.map(w=>w.run)))],c=r.filter(g=>g.level==="full").length,d=r.filter(g=>g.level==="partial").length,u=r.length-c-d;return`${ae(t,e)}
|
|
794
808
|
|
|
795
809
|
# ${n.title} non-unit evidence
|
|
796
810
|
|
|
797
811
|
Capability registration and unit tests are not command parity evidence. **FULL** requires built CLI \u2192 real HTTP adapter \u2192 governance \u2192 canonical operation \u2192 controlled fixture/provider \u2192 independently verified postcondition. **PARTIAL** names a narrower boundary. **MISSING** has no registered non-unit evidence.
|
|
798
812
|
|
|
799
|
-
Summary: ${
|
|
813
|
+
Summary: ${c} full, ${d} partial, ${u} missing.
|
|
800
814
|
|
|
801
815
|
| Command | Coverage | Executable evidence | Proven claim |
|
|
802
816
|
|---|---|---|---|
|
|
@@ -811,23 +825,23 @@ Smoke runs require an approved non-production target and their catalog prerequis
|
|
|
811
825
|
${i.length?i.join(`
|
|
812
826
|
`):"# No non-unit evidence registered."}
|
|
813
827
|
\`\`\`
|
|
814
|
-
`}function
|
|
815
|
-
`),
|
|
816
|
-
`),
|
|
828
|
+
`}function cu(e){return`'${e.replace(/'/g,`'"'"'`)}'`}function eR(e,t,n){let r=Br(n.type,t),o=An(r),i=ta(n.type,r),c=i.filter(g=>g.level==="missing").map(g=>g.command).join(`
|
|
829
|
+
`),d=i.filter(g=>g.level==="partial").map(g=>g.command).join(`
|
|
830
|
+
`),u=cu(e.cmd);return[{path:"scripts/check-auth.sh",executable:!0,content:`#!/usr/bin/env sh
|
|
817
831
|
set -eu
|
|
818
|
-
CLI=${
|
|
832
|
+
CLI=${u}
|
|
819
833
|
command -v "$CLI" >/dev/null 2>&1 || { echo "$CLI is not installed" >&2; exit 127; }
|
|
820
834
|
"$CLI" whoami
|
|
821
835
|
"$CLI" config refresh >/dev/null
|
|
822
836
|
printf '%s\\n' "Authentication and feature catalog are ready."
|
|
823
837
|
`},{path:"scripts/discover-capabilities.sh",executable:!0,content:`#!/usr/bin/env sh
|
|
824
838
|
set -eu
|
|
825
|
-
CLI=${
|
|
826
|
-
QUERY=\${1:-${
|
|
839
|
+
CLI=${u}
|
|
840
|
+
QUERY=\${1:-${cu(n.discoveryQuery)}}
|
|
827
841
|
"$CLI" capabilities --search "$QUERY" --format json
|
|
828
842
|
`},{path:"scripts/verify-help.sh",executable:!0,content:`#!/usr/bin/env sh
|
|
829
843
|
set -eu
|
|
830
|
-
CLI=${
|
|
844
|
+
CLI=${u}
|
|
831
845
|
while IFS= read -r COMMAND_PATH; do
|
|
832
846
|
[ -z "$COMMAND_PATH" ] && continue
|
|
833
847
|
set -- $COMMAND_PATH
|
|
@@ -839,24 +853,24 @@ COMMANDS
|
|
|
839
853
|
printf '%s\\n' "Verified help for ${o.length} ${n.type} commands."
|
|
840
854
|
`},{path:"scripts/check-flow.sh",executable:!0,content:`#!/usr/bin/env sh
|
|
841
855
|
set -eu
|
|
842
|
-
CLI=${
|
|
856
|
+
CLI=${u}
|
|
843
857
|
AVAILABLE=$("$CLI" capabilities --format quiet)
|
|
844
858
|
while IFS= read -r REQUIRED; do
|
|
845
859
|
[ -z "$REQUIRED" ] && continue
|
|
846
860
|
printf '%s\\n' "$AVAILABLE" | grep -Fqx "$REQUIRED" || { echo "Missing required capability: $REQUIRED" >&2; exit 1; }
|
|
847
861
|
done <<'COMMANDS'
|
|
848
|
-
${
|
|
862
|
+
${na(n,t).join(`
|
|
849
863
|
`)}
|
|
850
864
|
COMMANDS
|
|
851
865
|
printf '%s\\n' "${n.title} flow anchors are available."
|
|
852
866
|
`},{path:"scripts/check-coverage.sh",executable:!0,content:`#!/usr/bin/env sh
|
|
853
867
|
set -eu
|
|
854
868
|
PARTIAL=$(cat <<'COMMANDS'
|
|
855
|
-
${
|
|
869
|
+
${d}
|
|
856
870
|
COMMANDS
|
|
857
871
|
)
|
|
858
872
|
MISSING=$(cat <<'COMMANDS'
|
|
859
|
-
${
|
|
873
|
+
${c}
|
|
860
874
|
COMMANDS
|
|
861
875
|
)
|
|
862
876
|
[ -z "$PARTIAL" ] || printf 'PARTIAL command evidence (not parity):\\n%s\\n' "$PARTIAL" >&2
|
|
@@ -866,14 +880,14 @@ if [ -n "$PARTIAL" ] || [ -n "$MISSING" ]; then
|
|
|
866
880
|
exit 1
|
|
867
881
|
fi
|
|
868
882
|
printf '%s\\n' 'Every documented command has full real-CLI journey evidence.'
|
|
869
|
-
`}]}function
|
|
870
|
-
`}}function
|
|
883
|
+
`}]}function tR(e,t){return{path:"evals/evals.json",content:`${JSON.stringify({skill_name:e,evals:t.map(n=>({...n,files:[],expectations:[...n.expectations,"Consults references/coverage.md and never reports PARTIAL or MISSING as full command parity."]}))},null,2)}
|
|
884
|
+
`}}function Ae(e,t,n){let r=jt[n],o=`${e.name}-${n}`,i=Br(n,t).length;return`---
|
|
871
885
|
name: ${o}
|
|
872
886
|
description: >-
|
|
873
|
-
${r.description(
|
|
887
|
+
${r.description(e.name)}
|
|
874
888
|
---
|
|
875
889
|
|
|
876
|
-
${
|
|
890
|
+
${ae(t,e)}
|
|
877
891
|
|
|
878
892
|
# ${r.title}
|
|
879
893
|
|
|
@@ -885,7 +899,7 @@ Use this narrow workflow. Do not infer command names or reuse flags from UI, API
|
|
|
885
899
|
2. Run \`scripts/check-flow.sh\` or \`scripts/discover-capabilities.sh [query]\`.
|
|
886
900
|
3. Read [references/coverage.md](references/coverage.md); MISSING is not covered.
|
|
887
901
|
4. Read [references/workflow.md](references/workflow.md).
|
|
888
|
-
5. Read [references/commands.md](references/commands.md) only for the needed operation, then run \`${
|
|
902
|
+
5. Read [references/commands.md](references/commands.md) only for the needed operation, then run \`${e.cmd} <command> --help\`.
|
|
889
903
|
6. Verify returned state; an accepted background run is not completion.
|
|
890
904
|
|
|
891
905
|
## Bundled resources
|
|
@@ -899,9 +913,9 @@ Use this narrow workflow. Do not infer command names or reuse flags from UI, API
|
|
|
899
913
|
- \`scripts/check-flow.sh\` \u2014 verify minimum flow anchors exist.
|
|
900
914
|
- \`scripts/check-coverage.sh\` \u2014 fail unless every documented command has full real-CLI evidence.
|
|
901
915
|
- \`evals/evals.json\` \u2014 realistic trigger and workflow evaluations.
|
|
902
|
-
`}function
|
|
903
|
-
`),
|
|
904
|
-
`),
|
|
916
|
+
`}function Vt(e,t,n){let r=jt[n];return[{name:"commands",content:Qx(e,t,r)},{name:"coverage",content:Zx(e,t,r)},{name:"workflow",content:r.workflow(e,t)}]}function Mt(e,t,n){let r=jt[n];return[...eR(e,t,r),tR(`${e.name}-${n}`,r.evals)]}var nR=[{capability:"create",intent:'"Make me a presentation / deck / slides about X"',reference:"presentations.md",suffix:' "Topic" --context "\u2026"'},{capability:"presentation video prepare",intent:'"Turn my deck into a video / MP4 / narrated video"',reference:"deck-to-video.md",suffix:" <presentation-id> --yes"},{capability:"video storyboard create",intent:'"Make me a video about X" (no deck exists)',reference:"video.md",suffix:" --file ./storyboard.md \u2026"},{capability:"presentation import",intent:'"Import this PowerPoint / .pptx"',reference:"presentations.md",suffix:" --file deck.pptx --mode preserve"},{capability:"presentation speaker-notes",intent:'"Write speaker notes for this deck"',reference:"deck-to-video.md",suffix:" <presentation-id>"},{capability:"presentation video-narration",intent:'"Rewrite the narration on one slide"',reference:"deck-to-video.md",suffix:" <project-id> --slide-id <id>"},{capability:"tts generate",intent:'"Voiceover / narration / read this aloud / TTS"',reference:"media.md",suffix:' -t "Text" -o out.mp3'},{capability:"music generate",intent:'"Background music / a soundtrack"',reference:"media.md"},{capability:"sfx generate",intent:'"Sound effects"',reference:"media.md"},{capability:"mix create",intent:'"Mix this voiceover and music into the video"',reference:"media.md"},{capability:"image generate",intent:'"Generate an image"',reference:"media.md"},{capability:"image generate",intent:'"An image of this person / product / logo" (keep a real likeness)',reference:"image.md",suffix:' -p "\u2026" --reference-image identity=./photo.jpg --yes'},{capability:"search images",intent:'"Find a stock photo"',reference:"research.md",suffix:' -q "\u2026"'},{capability:"search video",intent:'"Find stock footage / b-roll"',reference:"video.md",suffix:' "ocean waves"'},{capability:"avatar options",intent:'"Which avatars / presenters / voices can I use?"',reference:"media.md"},{capability:"avatar generate",intent:'"Make a talking-head / avatar clip"',reference:"media.md"},{capability:"video translate",intent:'"Dub / translate this video"',reference:"video.md"},{capability:"video lipsync",intent:'"Re-sync the lips to this new audio"',reference:"video.md"},{capability:"branding extract",intent:'"Match my brand" / "pull branding from this site"',reference:"branding.md",suffix:" <url>"},{capability:"scrape",intent:'"Read this web page"',reference:"research.md",suffix:" https://example.com"},{capability:"transcript",intent:'"Get the transcript of this YouTube video"',reference:"research.md",suffix:" <url>"},{capability:"search web",intent:'"Search the web / find news about X"',reference:"research.md",suffix:' "query"'},{capability:"knowledge search",intent:'"What do we already have on X?"',reference:"knowledge.md"},{capability:"document create",intent:'"Save this as a document" / library filing',reference:"knowledge.md"},{capability:"file add",intent:'"Put this deck/PDF in the Library so I can @ it in chat"',reference:"knowledge.md"},{capability:"microsite create",intent:'"Build a landing page / microsite"',reference:"artifacts.md"},{capability:"poll create",intent:'"Make a poll"',reference:"artifacts.md"},{capability:"visual-abstract create",intent:'"One-page visual summary"',reference:"artifacts.md"},{capability:"ad-set create",intent:'"Ad creatives for this campaign"',reference:"artifacts.md"},{capability:"agent create",intent:'"Schedule this to run every week"',reference:"agents.md"},{capability:"support report",intent:'"Something broke / how do I / I wish it could" \u2014 file it, then `support list`',reference:"support.md"}],rR=["ai-connections","capabilities","config","delete","derive","export","footage","ideas","import","list","login","logout","runner","skill","templates","whoami"];function Fr(e,t=jn("rendered without a catalog fetch")){let{name:n,cmd:r,pkg:o}=e,i=new Map(t.capabilities.map(v=>[v.name,v])),c=nR.filter(v=>i.has(v.capability)).map(v=>`| ${v.intent} | \`${r} ${v.capability}${v.suffix??""}\` | [${v.reference}](references/${v.reference}) |`).join(`
|
|
917
|
+
`),u=$n(t.capabilities).map(({capabilities:v,category:x})=>`${x} (${v.length})`).join(", "),g=iu(t).map(({file:v,when:x})=>`| [references/${v}](references/${v}) | ${x} |`).join(`
|
|
918
|
+
`),w=[...new Set([...t.capabilities.map(v=>v.name.split(" ")[0]),...rR])].sort().map(v=>`\`${v}\``).join(", ");return`---
|
|
905
919
|
name: ${n}
|
|
906
920
|
description: >-
|
|
907
921
|
Route any ${n} CLI task to the smallest installed domain skill. Trigger for
|
|
@@ -910,7 +924,7 @@ description: >-
|
|
|
910
924
|
detailed workflows live in domain skills and catalog-generated references.
|
|
911
925
|
---
|
|
912
926
|
|
|
913
|
-
${
|
|
927
|
+
${ae(t,e)}
|
|
914
928
|
|
|
915
929
|
# ${n} CLI router
|
|
916
930
|
|
|
@@ -937,7 +951,7 @@ Something broke, a question, or a feature request \u2192 the \`support\` group:
|
|
|
937
951
|
|
|
938
952
|
| The user asks for\u2026 | Start here | Catalog detail |
|
|
939
953
|
|---|---|---|
|
|
940
|
-
${
|
|
954
|
+
${c}
|
|
941
955
|
|
|
942
956
|
## Composing commands
|
|
943
957
|
|
|
@@ -953,27 +967,27 @@ ${r} <group> --help
|
|
|
953
967
|
\`\`\`
|
|
954
968
|
|
|
955
969
|
The live catalog is authoritative; an installed skill can be older. Categories:
|
|
956
|
-
${
|
|
970
|
+
${u}.
|
|
957
971
|
|
|
958
972
|
## Reference index
|
|
959
973
|
|
|
960
974
|
| File | Read it when |
|
|
961
975
|
|---|---|
|
|
962
|
-
${
|
|
976
|
+
${g}
|
|
963
977
|
|
|
964
978
|
## Every command group
|
|
965
979
|
|
|
966
980
|
Run \`${r} <group> --help\` for any of these:
|
|
967
981
|
|
|
968
|
-
${
|
|
969
|
-
`}function
|
|
970
|
-
name: ${
|
|
982
|
+
${w}
|
|
983
|
+
`}function Gr(e){let{name:t,cmd:n}=e;return`---
|
|
984
|
+
name: ${t}-presentation-edit
|
|
971
985
|
description: >
|
|
972
986
|
Use ONLY when editing an already-created presentation that has real slides:
|
|
973
987
|
changing slide text, colors, fonts, images, charts, layout, or adding/removing slides.
|
|
974
988
|
Triggers: "change", "edit", "update", "fix", "modify", "add a slide", "make it X".
|
|
975
989
|
Do NOT load for creation requests \u2014 "create a presentation", "make slides",
|
|
976
|
-
"build a deck", "3-slide pitch", "new presentation" \u2192 use ${
|
|
990
|
+
"build a deck", "3-slide pitch", "new presentation" \u2192 use ${t}-presentation.
|
|
977
991
|
---
|
|
978
992
|
|
|
979
993
|
# Presentation Editor \u2014 In-App Guide
|
|
@@ -1251,8 +1265,8 @@ Do NOT render or export the presentation \u2014 that's handled by the app.
|
|
|
1251
1265
|
| Create brand-new presentation (5+ slides, new topic) | \`${n} create ...\` via CLI |
|
|
1252
1266
|
| Redesign the whole deck | \`${n} create ...\` via CLI, then sync |
|
|
1253
1267
|
| User provides a URL to base the presentation on | \`${n} scrape <url>\` \u2192 \`${n} create ...\` |
|
|
1254
|
-
`}function
|
|
1255
|
-
`),
|
|
1268
|
+
`}function Kr(e,t){return Ae(e,t,"presentation")}var oR=[{capability:"video reference analyze",when:"Optional \u2014 match the style of a reference video."},{capability:"video storyboard create",when:"Write the storyboard. Markdown in, immutable revision out."},{capability:"video storyboard revise",when:"Iterate. Each revision is appended, never rewritten."},{capability:"video create",when:"Render a pinned revision. Paid, approval-gated, background."}];function Wr(e,t){let{cmd:n,name:r,pkg:o}=e,i=new Set(t.capabilities.map(u=>u.name)),c=oR.filter(u=>i.has(u.capability)).map((u,g)=>`${g+1}. \`${n} ${u.capability}\` \u2014 ${u.when}`).join(`
|
|
1269
|
+
`),d=Zi(t.capabilities).length;return`---
|
|
1256
1270
|
name: ${r}-video
|
|
1257
1271
|
description: >-
|
|
1258
1272
|
Use when a video must be built from scratch \u2014 a brief, a script, a storyboard,
|
|
@@ -1260,10 +1274,10 @@ description: >-
|
|
|
1260
1274
|
involved. Trigger it even when the user never names the product: "make me a
|
|
1261
1275
|
video about X", "turn this script into a video", "I need a 30s promo".
|
|
1262
1276
|
For turning an EXISTING presentation into an MP4, use the ${r} skill's
|
|
1263
|
-
deck\u2192MP4 flow instead. ${
|
|
1277
|
+
deck\u2192MP4 flow instead. ${d} CLI capabilities, listed in references/video.md.
|
|
1264
1278
|
---
|
|
1265
1279
|
|
|
1266
|
-
${
|
|
1280
|
+
${ae(t,e)}
|
|
1267
1281
|
|
|
1268
1282
|
# ${r} video
|
|
1269
1283
|
|
|
@@ -1277,7 +1291,7 @@ one wastes a paid render. There is no \`video export\` subcommand.
|
|
|
1277
1291
|
|
|
1278
1292
|
## The flow
|
|
1279
1293
|
|
|
1280
|
-
${
|
|
1294
|
+
${c}
|
|
1281
1295
|
|
|
1282
1296
|
Then poll \`${n} video status <run-id>\` until it reports done.
|
|
1283
1297
|
|
|
@@ -1317,17 +1331,17 @@ ${n} video <sub> --help
|
|
|
1317
1331
|
\`\`\`
|
|
1318
1332
|
|
|
1319
1333
|
The catalog is authoritative and always current; this file is a snapshot of it.
|
|
1320
|
-
`}function
|
|
1334
|
+
`}function lu(e,t){return[{content:Vr(e,t),name:"video"},{content:qt(e,t),name:"deck-to-video"}]}import{chmodSync as iR,existsSync as ia,mkdirSync as ra,rmSync as aR,writeFileSync as oa}from"fs";import{homedir as pu}from"os";import{basename as sR,dirname as dR,join as Xe,relative as cR,resolve as Pn}from"path";var pt=[{name:"Claude Code",dir:".claude",provider:"claude"},{name:"GitHub Copilot",dir:".github",agentSuffix:".agent.md",provider:"copilot"},{name:"Cursor",dir:".cursor"},{name:"Codex",dir:".codex",agentSuffix:".toml",provider:"codex"},{name:"OpenCode",dir:".opencode"},{name:"Windsurf",dir:".windsurf"},{name:"Agent",dir:".agent"}];var lR={sonnet:"claude-sonnet-4.6",haiku:"claude-haiku-4.5",opus:"claude-opus-4.6"},mR=["permissionMode","skills","subagentType"];function uR(e,t){if(t!=="copilot")return e;let n=e.match(/^---\n([\s\S]*?)\n---\n/);if(!n)return mu(e);let r=n[1],o=e.slice((n.index??0)+n[0].length);r=r.replace(/^(model:\s*)(\S+)([ \t]*)$/m,(c,d,u,g)=>`${d}${lR[u]??u}${g}`);for(let c of mR)r=r.replace(new RegExp(`^${c}:[^
|
|
1321
1335
|
]*
|
|
1322
|
-
?`,"m"),"");r=r.replace(/\n+$/,"");let i=
|
|
1336
|
+
?`,"m"),"");r=r.replace(/\n+$/,"");let i=mu(o);return`---
|
|
1323
1337
|
${r}
|
|
1324
1338
|
---
|
|
1325
|
-
${i}`}function
|
|
1326
|
-
name: ${
|
|
1339
|
+
${i}`}function mu(e){return e.replace(/\bAskUserQuestion\b/g,"ask the user directly in your response").replace(/\*\*Construct the Task prompt:\*\*/g,"**Construct the Task prompt (must be fully self-contained \u2014 sub-agents cannot read this conversation's history):**").replace(/\*\*Wait for all agents to complete\*\*/g,"**Wait for all agents to complete** (monitor with `/tasks` in Copilot CLI)").replace("**Launch ALL scene agents in parallel**","**Launch ALL scene agents in parallel** \u2014 each agent must write to its own `Scene[NN][Name].tsx` file. Two agents writing to the same file will silently overwrite each other (no error). Verify unique filenames before spawning.")}function gu(e,t){let n=Pn(e),r=Pn(e,t);if(cR(n,r).startsWith("..")||Pn(r)!==r.replace(/\.\./g,""))throw new Error(`Invalid path: "${t}" would escape base directory`);return r}function uu(e,t,n,r,o){let i=Xe(e,"SKILL.md");if(ra(e,{recursive:!0}),oa(i,uR(t,r),"utf-8"),n&&n.length>0){let c=Xe(e,"references");ra(c,{recursive:!0});for(let d of n){let u=Xe(c,`${d.name}.md`);oa(u,d.content,"utf-8")}}for(let c of o??[]){let d=gu(e,c.path);ra(dR(d),{recursive:!0}),oa(d,c.content,"utf-8"),c.executable&&iR(d,493)}}function Jr(e,t,n={},r,o){let i={installed:[],skipped:[],errors:[]},c=n.local?process.cwd():pu();if(n.dir){let d=sR(Pn(n.dir)),u=pt.find(g=>g.dir===d)?.provider;try{let g=Pn(n.dir),w=gu(g,Xe("skills",e));uu(w,t,r,u,o),i.installed.push(n.dir)}catch(g){i.errors.push(`${n.dir}: ${g instanceof Error?g.message:String(g)}`)}}else for(let d of pt){let u=Xe(c,d.dir),g=Xe(u,"skills",e),w=Xe(g,"SKILL.md");if(ia(u)){if(ia(w)&&!n.force){i.skipped.push(d.name);continue}try{uu(g,t,r,d.provider,o),i.installed.push(d.name)}catch(v){i.errors.push(`${d.name}: ${v instanceof Error?v.message:String(v)}`)}}}return i}function zr(e,t={}){let n={removed:[],errors:[]},r=t.local?process.cwd():pu();for(let o of pt){let i=Xe(r,o.dir,"skills",e);if(ia(i))try{aR(i,{recursive:!0}),n.removed.push(o.name)}catch(c){n.errors.push(`${o.name}: ${c instanceof Error?c.message:String(c)}`)}}return n}function fu(){return pt.map(e=>e.name)}function Bt(e){let{name:t,cmd:n}=e;return`---
|
|
1340
|
+
name: ${t}-tts
|
|
1327
1341
|
description: Text-to-speech generation. Convert text to natural speech with multiple providers (Gemini, ElevenLabs, OpenAI) and voices. Use for voiceovers, narration, accessibility.
|
|
1328
1342
|
---
|
|
1329
1343
|
|
|
1330
|
-
# ${
|
|
1344
|
+
# ${t} TTS (Text-to-Speech)
|
|
1331
1345
|
|
|
1332
1346
|
Convert text to natural speech with multiple providers and voices.
|
|
1333
1347
|
|
|
@@ -1522,12 +1536,12 @@ ${n} tts generate \\
|
|
|
1522
1536
|
2. **Voice matching** - Match voice style to content: Puck for upbeat, Charon for serious
|
|
1523
1537
|
3. **Speed adjustment** - Use 0.9-0.95 for narration, 1.0-1.1 for casual
|
|
1524
1538
|
4. **Multiple voiceovers** - Run \`${n} tts generate\` once per line and poll each run with \`${n} tts status <run-id>\`
|
|
1525
|
-
`}function
|
|
1526
|
-
name: ${
|
|
1539
|
+
`}function Ft(e){let{name:t,cmd:n}=e;return`---
|
|
1540
|
+
name: ${t}-music
|
|
1527
1541
|
description: Generate music that follows a video's narration and final timing. Gemini plans the provider prompt on the backend.
|
|
1528
1542
|
---
|
|
1529
1543
|
|
|
1530
|
-
# ${
|
|
1544
|
+
# ${t} Video Music
|
|
1531
1545
|
|
|
1532
1546
|
Generate TTS first and finalize the storyboard/timeline. Then write a factual request; do not write a music prompt, music plan, style list, or provider options.
|
|
1533
1547
|
|
|
@@ -1548,12 +1562,12 @@ ${n} music status <request-id>
|
|
|
1548
1562
|
\`\`\`
|
|
1549
1563
|
|
|
1550
1564
|
The backend sends these facts to Gemini, receives the provider-ready musical direction, and makes the paid music-provider request. Retrying the same unchanged request is idempotent.
|
|
1551
|
-
`}function
|
|
1552
|
-
name: ${
|
|
1565
|
+
`}function Gt(e){let{name:t,cmd:n}=e;return`---
|
|
1566
|
+
name: ${t}-sfx
|
|
1553
1567
|
description: Generate one sound effect aligned with a final visual event and narration. Gemini plans the provider prompt on the backend.
|
|
1554
1568
|
---
|
|
1555
1569
|
|
|
1556
|
-
# ${
|
|
1570
|
+
# ${t} Video Sound Effects
|
|
1557
1571
|
|
|
1558
1572
|
Generate TTS first and finalize timing. For each meaningful sound cue, send the video's facts plus exactly one factual \`visual_event\`. Include word timings when TTS provides them. Do not author an SFX prompt or provider settings.
|
|
1559
1573
|
|
|
@@ -1586,12 +1600,12 @@ ${n} sfx status <request-id>
|
|
|
1586
1600
|
\`\`\`
|
|
1587
1601
|
|
|
1588
1602
|
The backend sends these facts to Gemini, receives one provider-ready SFX description, and makes the paid SFX-provider request. Retrying the same unchanged request is idempotent.
|
|
1589
|
-
`}function
|
|
1590
|
-
name: ${
|
|
1603
|
+
`}function Kt(e){let{name:t,cmd:n}=e;return`---
|
|
1604
|
+
name: ${t}-mix
|
|
1591
1605
|
description: Audio mixing for video production. Combine video with voiceover and background music. Supports volume control, fade effects, and multiple audio tracks.
|
|
1592
1606
|
---
|
|
1593
1607
|
|
|
1594
|
-
# ${
|
|
1608
|
+
# ${t} Audio Mixing
|
|
1595
1609
|
|
|
1596
1610
|
Mix video with voiceover and background music.
|
|
1597
1611
|
|
|
@@ -1736,12 +1750,12 @@ ${n} mix status <request-id>
|
|
|
1736
1750
|
2. **Music selection** - Choose music that doesn't compete with voice frequency.
|
|
1737
1751
|
3. **Consistent levels** - Keep voice at 100%, adjust music only.
|
|
1738
1752
|
4. **File sizes** - Use \`--no-wait\` for large files to avoid timeout.
|
|
1739
|
-
`}function
|
|
1740
|
-
name: ${
|
|
1753
|
+
`}function Wt(e){let{name:t,cmd:n}=e;return`---
|
|
1754
|
+
name: ${t}-image
|
|
1741
1755
|
description: Image search across the web and licensed stock, plus AI image generation with reference images. Find licensed photos to publish, web images for specific real-world subjects, generate a custom image, or generate one that keeps a real person's face, a product or a logo by passing a local photo or URL as a reference. For videos, presentations, marketing.
|
|
1742
1756
|
---
|
|
1743
1757
|
|
|
1744
|
-
# ${
|
|
1758
|
+
# ${t} Image Commands
|
|
1745
1759
|
|
|
1746
1760
|
Search images (web + licensed stock) and generate AI images.
|
|
1747
1761
|
|
|
@@ -2129,12 +2143,12 @@ things you wrote on their behalf.
|
|
|
2129
2143
|
likeness additionally needs \`--provider google-ai --model gemini-3-pro-image\`
|
|
2130
2144
|
**and** the \`image-model-override\` flag on the workspace; without the flag
|
|
2131
2145
|
the server drops the pin and the likeness is close, not exact.
|
|
2132
|
-
`}function
|
|
2133
|
-
name: ${
|
|
2146
|
+
`}function Jt(e){let{name:t,cmd:n}=e;return`---
|
|
2147
|
+
name: ${t}-video-search
|
|
2134
2148
|
description: Video search across the web and licensed stock. Find downloadable stock clips for b-roll and backgrounds, or web videos (YouTube, Vimeo) to embed in a slide or microsite.
|
|
2135
2149
|
---
|
|
2136
2150
|
|
|
2137
|
-
# ${
|
|
2151
|
+
# ${t} Video Search
|
|
2138
2152
|
|
|
2139
2153
|
Find video: licensed clips you can download, or web videos you can embed.
|
|
2140
2154
|
|
|
@@ -2326,12 +2340,12 @@ ${n} video find "city timelapse" --orientation landscape -n 10
|
|
|
2326
2340
|
3. **Preview first** - Use preview URLs to check quality
|
|
2327
2341
|
4. **License** - Verify license for commercial use
|
|
2328
2342
|
5. **JSON export** - Save searches for batch processing
|
|
2329
|
-
`}function
|
|
2330
|
-
name: ${
|
|
2343
|
+
`}function zt(e){let{name:t,cmd:n}=e;return`---
|
|
2344
|
+
name: ${t}-scrape
|
|
2331
2345
|
description: Scrape any URL the user provides. Use when user says "check this site", "look at this URL", "use this website", "here's the link", or shares any URL for context. Supports websites, YouTube, Twitter/X.
|
|
2332
2346
|
---
|
|
2333
2347
|
|
|
2334
|
-
# ${
|
|
2348
|
+
# ${t} URL Scraping
|
|
2335
2349
|
|
|
2336
2350
|
Extract content from URLs for analysis and context.
|
|
2337
2351
|
|
|
@@ -2516,12 +2530,12 @@ ${n} scrape https://blog.example.com -f quiet | ${n} create "Blog Summary"
|
|
|
2516
2530
|
3. **Use JSON** - For programmatic processing of results
|
|
2517
2531
|
4. **Combine sources** - Scrape multiple URLs for comprehensive context
|
|
2518
2532
|
5. **Token count** - Check token usage for large documents
|
|
2519
|
-
`}function
|
|
2520
|
-
name: ${
|
|
2533
|
+
`}function Hr(e){let{name:t,cmd:n}=e;return`---
|
|
2534
|
+
name: ${t}-branding
|
|
2521
2535
|
description: Brand profile management. Extract branding from websites, manage saved brands, apply consistent styling to presentations.
|
|
2522
2536
|
---
|
|
2523
2537
|
|
|
2524
|
-
# ${
|
|
2538
|
+
# ${t} Branding Management
|
|
2525
2539
|
|
|
2526
2540
|
Manage brand profiles for consistent styling across presentations.
|
|
2527
2541
|
|
|
@@ -2626,12 +2640,12 @@ ${n} branding set-default abc123
|
|
|
2626
2640
|
2. **If extraction fails** \u2014 Proceed without branding. Do not manually create brand assets.
|
|
2627
2641
|
3. **Set default** \u2014 If you mostly work with one brand, set it as default.
|
|
2628
2642
|
4. **Override** \u2014 Use \`--brand\` flag to override default for specific presentations.
|
|
2629
|
-
`}function
|
|
2630
|
-
name: ${
|
|
2643
|
+
`}function Ht(e){let{name:t,cmd:n}=e,r=t.toUpperCase().replace(/[^A-Z0-9]/g,"_");return`---
|
|
2644
|
+
name: ${t}-config
|
|
2631
2645
|
description: CLI configuration management. Set API keys, team IDs, custom API URLs. Verify authentication status.
|
|
2632
2646
|
---
|
|
2633
2647
|
|
|
2634
|
-
# ${
|
|
2648
|
+
# ${t} Configuration
|
|
2635
2649
|
|
|
2636
2650
|
Manage CLI settings and authentication.
|
|
2637
2651
|
|
|
@@ -2787,70 +2801,70 @@ ${n} config show --verify # Test API key
|
|
|
2787
2801
|
\`\`\`bash
|
|
2788
2802
|
${n} config set team-id <correct-team-id>
|
|
2789
2803
|
\`\`\`
|
|
2790
|
-
`}var
|
|
2791
|
-
${
|
|
2792
|
-
${
|
|
2793
|
-
${
|
|
2794
|
-
${
|
|
2795
|
-
${
|
|
2796
|
-
${
|
|
2797
|
-
${
|
|
2798
|
-
${
|
|
2799
|
-
|
|
2800
|
-
${
|
|
2801
|
-
|
|
2802
|
-
${
|
|
2803
|
-
$ ${
|
|
2804
|
-
$ ${
|
|
2805
|
-
$ ${
|
|
2806
|
-
$ ${
|
|
2807
|
-
$ ${
|
|
2808
|
-
`);
|
|
2809
|
-
`)),n(
|
|
2810
|
-
`))}});for(let
|
|
2811
|
-
${
|
|
2812
|
-
$ ${
|
|
2813
|
-
$ ${
|
|
2814
|
-
|
|
2815
|
-
${
|
|
2816
|
-
${
|
|
2817
|
-
$ ${
|
|
2818
|
-
${
|
|
2819
|
-
$ ${
|
|
2820
|
-
${
|
|
2821
|
-
$ ${
|
|
2822
|
-
${
|
|
2823
|
-
$ ${
|
|
2824
|
-
${
|
|
2825
|
-
$ ${
|
|
2826
|
-
${
|
|
2827
|
-
$ ${
|
|
2828
|
-
${
|
|
2829
|
-
$ ${
|
|
2830
|
-
${
|
|
2831
|
-
$ ${
|
|
2832
|
-
${
|
|
2833
|
-
$ ${
|
|
2834
|
-
${
|
|
2835
|
-
$ ${
|
|
2836
|
-
${
|
|
2837
|
-
$ ${
|
|
2838
|
-
|
|
2839
|
-
${
|
|
2840
|
-
'${
|
|
2841
|
-
'${
|
|
2804
|
+
`}var pR=["main","video","presentation","presentation-video","presentation-edit","branding","agents"];function X(e,t){return e===void 0||e==="main"?pR.some(n=>n===t):e===t}var Xt=["main","video","presentation","presentation-video","presentation-edit","tts","music","sfx","mix","image","video-search","scrape","branding","agents","config"],Xr=["standalone","studio"],hu={cmd:p.commands[0],pkg:p.packageName,url:p.apiUrl,name:p.name},Yt=new gR("skill").description(`Manage ${p.displayName} skills for AI coding assistants`).addHelpText("after",`
|
|
2805
|
+
${ee.bold("Skill Types:")}
|
|
2806
|
+
${ee.cyan("main")} Intent router and capability index
|
|
2807
|
+
${ee.cyan("presentation")} Create, import, inspect, and export decks
|
|
2808
|
+
${ee.cyan("presentation-video")} Turn an existing deck into an MP4
|
|
2809
|
+
${ee.cyan("branding")} Manage private and team brand profiles
|
|
2810
|
+
${ee.cyan("agents")} Manage scheduled Agents and team roster visibility
|
|
2811
|
+
${ee.cyan("video")} Build a video from scratch (no deck)
|
|
2812
|
+
${ee.cyan("presentation-edit")} Legacy Studio editing guide
|
|
2813
|
+
|
|
2814
|
+
${ee.bold("Reference-only types:")} tts, music, sfx, mix, image, video-search, scrape, config
|
|
2815
|
+
|
|
2816
|
+
${ee.bold("Examples:")}
|
|
2817
|
+
$ ${p.commands[0]} skill install ${ee.gray("# core suite")}
|
|
2818
|
+
$ ${p.commands[0]} skill install presentation-video
|
|
2819
|
+
$ ${p.commands[0]} skill install branding --dir ~/.claude
|
|
2820
|
+
$ ${p.commands[0]} skill install agents
|
|
2821
|
+
$ ${p.commands[0]} skill show presentation
|
|
2822
|
+
`);Yt.command("install").description(`Install ${p.displayName} skills for AI coding assistants`).argument("[type]","Skill type, or omit to install the core skill suite").option("-d, --dir <path>","Install to specific directory").option("-g, --global","Install globally (to home directory)",!0).option("-l, --local","Install locally (to current directory)").option("-f, --force","Overwrite existing skill files").option("-m, --mode <mode>","Skill mode: standalone (render to file) or studio (Studio Preview)","standalone").action(async(e,t)=>{t.mode&&!Xr.includes(t.mode)&&(a(`Invalid mode: ${t.mode}. Must be one of: ${Xr.join(", ")}`),process.exit(1));let n={...hu,mode:t.mode},r=[];e&&!Xt.includes(e)&&(a(`Invalid skill type: ${e}. Must be one of: ${Xt.join(", ")}`),process.exit(1));let o=await en();o.source==="snapshot"&&(L(`Live capability catalog unavailable (${o.reason??"unknown reason"}) \u2014 generating from the snapshot baked into this CLI.`),console.log(ee.gray(` Run \`${p.commands[0]} login\` then re-run with --force to regenerate from the live catalog.`)));let i=[...ou(n,o,{branding:Hr(n)}),{name:"tts",content:Bt(n)},{name:"music",content:Ft(n)},{name:"sfx",content:Gt(n)},{name:"mix",content:Kt(n)},{name:"image",content:Wt(n)},{name:"video-search",content:Jt(n)},{name:"scrape",content:zt(n)},{name:"config",content:Ht(n)}];X(e,"main")&&r.push({name:p.name,content:Fr(n,o),references:i}),X(e,"video")&&r.push({content:Wr(n,o),name:`${p.name}-video`,references:lu(n,o)}),X(e,"presentation")&&r.push({name:`${p.name}-presentation`,content:Kr(n,o),references:Vt(n,o,"presentation"),files:Mt(n,o,"presentation")}),X(e,"presentation-video")&&r.push({name:`${p.name}-presentation-video`,content:Ae(n,o,"presentation-video"),references:Vt(n,o,"presentation-video"),files:Mt(n,o,"presentation-video")}),X(e,"presentation-edit")&&r.push({name:`${p.name}-presentation-edit`,content:Gr(n)}),X(e,"branding")&&r.push({name:`${p.name}-branding`,content:Ae(n,o,"branding"),references:Vt(n,o,"branding"),files:Mt(n,o,"branding")}),X(e,"agents")&&r.push({name:`${p.name}-agents`,content:Ae(n,o,"agents"),references:Vt(n,o,"agents"),files:Mt(n,o,"agents")}),X(e,"tts")&&r.push({name:`${p.name}-tts`,content:Bt(n)}),X(e,"music")&&r.push({name:`${p.name}-music`,content:Ft(n)}),X(e,"sfx")&&r.push({name:`${p.name}-sfx`,content:Gt(n)}),X(e,"mix")&&r.push({name:`${p.name}-mix`,content:Kt(n)}),X(e,"image")&&r.push({name:`${p.name}-image`,content:Wt(n)}),X(e,"video-search")&&r.push({name:`${p.name}-video-search`,content:Jt(n)}),X(e,"scrape")&&r.push({name:`${p.name}-scrape`,content:zt(n)}),X(e,"config")&&r.push({name:`${p.name}-config`,content:Ht(n)}),console.log();for(let c of r){b(`Installing ${c.name}...`);let d=Jr(c.name,c.content,{dir:t.dir,local:t.local,force:t.force},c.references,c.files);if(d.installed.length>0&&(k(`${c.name} installed successfully`),C(" Installed to",d.installed.join(", "))),d.skipped.length>0&&(b(` Skipped (already exists): ${d.skipped.join(", ")}`),console.log(ee.gray(" Use --force to overwrite"))),d.errors.length>0)for(let u of d.errors)a(` ${u}`);d.installed.length===0&&d.skipped.length===0&&d.errors.length===0&&(b(" No supported AI coding assistants detected"),console.log(ee.gray(` Supported editors: ${fu().join(", ")}`)),console.log(ee.gray(" Use --dir <path> to install to a specific directory"))),console.log()}});Yt.command("show").description("Display skill content").argument("[type]","Skill type (default: main)").option("-m, --mode <mode>","Skill mode: standalone or studio","standalone").action(async(e="main",t)=>{t.mode&&!Xr.includes(t.mode)&&(a(`Invalid mode: ${t.mode}. Must be one of: ${Xr.join(", ")}`),process.exit(1));let n={...hu,mode:t.mode},r=await en(),i={main:()=>Fr(n,r),video:()=>Wr(n,r),presentation:()=>Kr(n,r),"presentation-video":()=>Ae(n,r,"presentation-video"),"presentation-edit":()=>Gr(n),tts:()=>Bt(n),music:()=>Ft(n),sfx:()=>Gt(n),mix:()=>Kt(n),image:()=>Wt(n),"video-search":()=>Jt(n),scrape:()=>zt(n),branding:()=>Ae(n,r,"branding"),agents:()=>Ae(n,r,"agents"),config:()=>Ht(n)}[e];i?console.log(i()):(a(`Invalid skill type: ${e}. Must be one of: ${Xt.join(", ")}`),process.exit(1))});Yt.command("uninstall").description(`Remove ${p.displayName} skills from AI coding assistants`).argument("[type]","Skill type, or omit to remove installed skills").option("-g, --global","Uninstall globally (from home directory)",!0).option("-l, --local","Uninstall locally (from current directory)").action(async(e,t)=>{let n=[];e&&!Xt.includes(e)&&(a(`Invalid skill type: ${e}. Must be one of: ${Xt.join(", ")}`),process.exit(1)),(!e||e==="main")&&n.push(p.name),(!e||e==="video")&&n.push(`${p.name}-video`),(!e||e==="presentation")&&n.push(`${p.name}-presentation`),(!e||e==="presentation-video")&&n.push(`${p.name}-presentation-video`),(!e||e==="presentation-edit")&&n.push(`${p.name}-presentation-edit`),(!e||e==="tts")&&n.push(`${p.name}-tts`),(!e||e==="music")&&n.push(`${p.name}-music`),(!e||e==="sfx")&&n.push(`${p.name}-sfx`),(!e||e==="mix")&&n.push(`${p.name}-mix`),(!e||e==="image")&&n.push(`${p.name}-image`),(!e||e==="video-search")&&n.push(`${p.name}-video-search`),(!e||e==="scrape")&&n.push(`${p.name}-scrape`),(!e||e==="branding")&&n.push(`${p.name}-branding`),(!e||e==="agents")&&n.push(`${p.name}-agents`),(!e||e==="config")&&n.push(`${p.name}-config`),console.log();for(let r of n){let o=zr(r,{local:t.local});if(o.removed.length>0?(k(`${r} uninstalled`),C(" Removed from",o.removed.join(", "))):b(` ${r} not found`),o.errors.length>0)for(let i of o.errors)L(` Failed to remove: ${i}`)}console.log()});import{Command as fR}from"commander";import aa from"chalk";var yu=new fR("whoami").description("Show current user and team information").option("-f, --format <format>","Output format (human, json)",y("--format",["human","json"]),"human").action(async e=>{await h();try{let t=await Ee();if(fo(),e.format==="json"){console.log(JSON.stringify(t,null,2));return}ve("User"),console.log(),C("Email",t.user.email),t.user.username&&C("Username",t.user.username),(t.user.firstName||t.user.lastName)&&C("Name",[t.user.firstName,t.user.lastName].filter(Boolean).join(" "));let n=t.authType==="apiKey"?"API Key":t.authType==="oauth"?"OAuth":"Session";if(C("Auth Type",n),t.currentTeam&&(console.log(),ve("Current Team"),console.log(),C("ID",t.currentTeam.id),C("Name",t.currentTeam.name),C("Plan",t.currentTeam.planName),C("Role",t.currentTeam.isOwner?"Owner":"Member")),t.teams.length>1){console.log(),ve("All Teams"),console.log();for(let r of t.teams){let o=r.isCurrent?aa.green(" (current)"):"";console.log(` ${aa.bold(r.name)}${o}`),console.log(aa.gray(` ID: ${r.id} | Plan: ${r.planName} | Role: ${r.role}`))}}console.log()}catch(t){a(t instanceof Error?t.message:String(t)),process.exit(t.exitCode??1)}});function bu(e){return e[0]==="--"?e.slice(1):e}import sa from"chalk";function da(e){e.configureOutput({outputError:(t,n)=>{n(sa.red(t));let r=/unknown option '(-{1,2}[^'\s=]+)/.exec(t);if(!r)return;let o=yR(e,r[1]);o&&n(sa.yellow(`Did you mean '${o}'?
|
|
2823
|
+
`)),n(sa.gray(`Run '${hR(e)} --help' to see the accepted options.
|
|
2824
|
+
`))}});for(let t of e.commands)da(t)}function hR(e){let t=[],n=e;for(;n;)t.unshift(n.name()),n=n.parent;return t.join(" ")}function yR(e,t){let n,r=Number.POSITIVE_INFINITY;for(let i of e.options)if(!i.hidden)for(let c of[i.short,i.long]){if(!c)continue;let d=ca(t,c);d<r&&(r=d,n=i.flags)}let o=t.startsWith("--")?2:1;return n!==void 0&&r<=o?n:void 0}function ca(e,t){if(e===t)return 0;if(e.length===0)return t.length;if(t.length===0)return e.length;let n=Array.from({length:t.length+1},(r,o)=>o);for(let r=1;r<=e.length;r++){let o=[r];for(let i=1;i<=t.length;i++){let c=e[r-1]===t[i-1]?0:1;o[i]=Math.min(o[i-1]+1,n[i]+1,n[i-1]+c)}n=o}return n[t.length]}var wR="0.3.25",J=new bR,j=p.commands[0];J.name(j).description(`${p.displayName} CLI \u2014 presentations, videos, avatars, audio, branding, media and research`).version(wR,"-v, --version","Show version number").option("--debug","Enable debug logging").option("--no-color","Disable colored output");J.addCommand(qs);Qm(J);J.addCommand(Qs);J.addCommand(Ys);J.addCommand(Hs);J.addCommand(Ks);J.addCommand(yu);J.addCommand(rd);J.addCommand(od);J.addCommand(Gs);J.addCommand(Yt);J.addCommand(zn);var wu=zs();wu.commands.length>0&&J.addCommand(wu);function vR(e){let t=e.toLowerCase(),n=t.length<=4?1:2,r,o=Number.POSITIVE_INFINITY;for(let i of J.commands)for(let c of[i.name(),...i.aliases()]){let d=ca(t,c.toLowerCase());d<o&&(o=d,r=i.name())}return r!==void 0&&o<=n?r:void 0}J.on("command:*",e=>{let t=String(e[0]);console.error(G.red(`Error: Unknown command '${t}'`)),console.error();let n=vR(t);n&&console.error(`Did you mean '${n}'?`),console.error(`Run '${j} --help' to see available commands.`),console.error(`Run '${j} capabilities' for the full list of callable capabilities.`),process.exit(1)});J.addHelpText("after",`
|
|
2825
|
+
${G.bold("Start here:")}
|
|
2826
|
+
$ ${j} capabilities ${G.gray("# every capability + its exact command path")}
|
|
2827
|
+
$ ${j} <group> --help ${G.gray("# drill into any command group above")}
|
|
2828
|
+
|
|
2829
|
+
${G.bold("Common tasks:")}
|
|
2830
|
+
${G.gray("Make a presentation")}
|
|
2831
|
+
$ ${j} create "<topic>" --context "..."
|
|
2832
|
+
${G.gray("Turn a finished presentation into an MP4 (narration + avatar)")}
|
|
2833
|
+
$ ${j} presentation video <slug>
|
|
2834
|
+
${G.gray("Export a presentation to HTML, PDF or PPTX")}
|
|
2835
|
+
$ ${j} export <id-or-slug> -o deck.html
|
|
2836
|
+
${G.gray("Make a video from scratch (no deck)")}
|
|
2837
|
+
$ ${j} video storyboard create ${G.gray("then")} $ ${j} video create
|
|
2838
|
+
${G.gray("Regenerate one slide's narration in a video draft")}
|
|
2839
|
+
$ ${j} presentation video-narration <project-id>
|
|
2840
|
+
${G.gray("Generate speaker notes")}
|
|
2841
|
+
$ ${j} presentation speaker-notes <presentation-id>
|
|
2842
|
+
${G.gray("Import a PowerPoint")}
|
|
2843
|
+
$ ${j} presentation import
|
|
2844
|
+
${G.gray("Extract a brand identity from a URL")}
|
|
2845
|
+
$ ${j} branding extract <url>
|
|
2846
|
+
${G.gray("Voiceover, music, sound effects")}
|
|
2847
|
+
$ ${j} tts generate | ${j} music generate | ${j} sfx generate
|
|
2848
|
+
${G.gray("Find stock footage / images")}
|
|
2849
|
+
$ ${j} video find | ${j} image search
|
|
2850
|
+
${G.gray("Read a web page or a YouTube transcript")}
|
|
2851
|
+
$ ${j} scrape <url> | ${j} transcript <url>
|
|
2852
|
+
|
|
2853
|
+
${G.bold("Two different video pipelines:")}
|
|
2854
|
+
'${j} presentation video ...' renders an EXISTING deck to MP4.
|
|
2855
|
+
'${j} video ...' builds a video from a storyboard or brief with stock
|
|
2842
2856
|
and generated footage \u2014 no deck involved.
|
|
2843
2857
|
|
|
2844
|
-
${
|
|
2845
|
-
Run '${
|
|
2858
|
+
${G.bold("Authentication:")}
|
|
2859
|
+
Run '${j} login' to authenticate (recommended).
|
|
2846
2860
|
Or set CC_SLIDES_API_KEY environment variable for API key auth.
|
|
2847
2861
|
|
|
2848
|
-
${
|
|
2862
|
+
${G.bold("Note:")}
|
|
2849
2863
|
The command list above is not always complete: feature-flag-gated commands
|
|
2850
|
-
(the '${
|
|
2851
|
-
and '${
|
|
2852
|
-
'${
|
|
2864
|
+
(the '${j} derive' subcommands) appear only after '${j} login'
|
|
2865
|
+
and '${j} config refresh' have cached your feature access. Run
|
|
2866
|
+
'${j} capabilities' for the authoritative list.
|
|
2853
2867
|
|
|
2854
|
-
${
|
|
2855
|
-
${
|
|
2856
|
-
`);
|
|
2868
|
+
${G.bold("More Info:")}
|
|
2869
|
+
${G.blue(p.docsUrl)}
|
|
2870
|
+
`);da(J);J.parse(bu(process.argv.slice(2)),{from:"user"});
|