@conceptcraft/mindframes 0.3.23 → 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/dist/index.js CHANGED
@@ -1,17 +1,17 @@
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 Kv}from"commander";import Mt from"chalk";import{Command as bm}from"commander";function wi(t={}){let e=(c,u)=>{let f=t[c];return f&&f.trim().length>0?f.trim():u},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 p=typeof g<"u"&&g?g:wi(process.env);import _ from"chalk";import $r from"cli-table3";import Vl from"conf";var vi=p.apiUrl,Ml={apiKey:{type:"string"},apiUrl:{type:"string",default:vi},defaultTeamId:{type:"string"},accessToken:{type:"string"},refreshToken:{type:"string"},tokenExpiresAt:{type:"number"},clientId:{type:"string"},clientSecret:{type:"string"}},N=new Vl({projectName:p.name,schema:Ml});function Ii(){return{apiKey:ke(),apiUrl:G(),defaultTeamId:N.get("defaultTeamId"),accessToken:N.get("accessToken"),refreshToken:N.get("refreshToken"),tokenExpiresAt:N.get("tokenExpiresAt"),clientId:N.get("clientId"),clientSecret:N.get("clientSecret")}}function ke(){let t=process.env[p.apiKeyEnvVar]??process.env.CC_SLIDES_API_KEY;return t||N.get("apiKey")}function Sr(t){N.set("apiKey",t)}function G(){let t=process.env[p.apiUrlEnvVar]??process.env.CC_SLIDES_API_URL;return t||(N.get("apiUrl")??vi)}function Er(t){N.set("apiUrl",t)}function ee(){return N.get("defaultTeamId")}function et(t){N.set("defaultTeamId",t)}function hn(){N.clear()}function _t(){return N.path}function tt(){return!!ke()}function ki(){return N.get("accessToken")}function xi(){return N.get("refreshToken")}function yn(t,e,n){N.set("accessToken",t),N.set("refreshToken",e),N.set("tokenExpiresAt",Date.now()+(n-60)*1e3)}function bn(){N.delete("accessToken"),N.delete("refreshToken"),N.delete("tokenExpiresAt")}function Ci(){let t=N.get("tokenExpiresAt");return t?Date.now()>=t:!0}function Fe(){return!!N.get("accessToken")&&!!N.get("refreshToken")}function Ri(){return N.get("clientId")}function Si(){return N.get("clientSecret")}function Ei(t,e){N.set("clientId",t),N.set("clientSecret",e)}function x(t,e="human"){e!=="quiet"&&e!=="json"&&console.log(_.green("\u2713"),t)}function a(t,e="human"){if(e!=="quiet"){if(e==="json"){console.error(JSON.stringify({error:t}));return}console.error(_.red("\u2717"),t)}}function V(t,e="human"){e!=="quiet"&&e!=="json"&&console.warn(_.yellow("\u26A0"),t)}function $i(t,e="human"){e==="quiet"||e==="json"||console.error(_.cyan("\u2192"),t)}function w(t,e="human"){e!=="quiet"&&e!=="json"&&console.log(_.blue("\u2139"),t)}function nt(t,e="en"){return t?`${G()}/${e}/view/presentations/${t}`:"N/A"}function Ti(t,e={}){let{showLinks:n=!1,language:r="en"}=e,o=(c,u)=>c.length>u?`${c.slice(0,u-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 $r({head:[_.cyan("Slug"),_.cyan("Title"),_.cyan("Slides"),_.cyan("Created"),_.cyan("URL")]});for(let u of t)c.push([o(u.slug||u.id.slice(0,8),30),o(u.title||"Untitled",22),String(u.numberOfSlides||"-"),i(u.createdAt),nt(u.slug,r)]);return c.toString()}let s=new $r({head:[_.cyan("Slug"),_.cyan("Title"),_.cyan("Slides"),_.cyan("Mode"),_.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 Ai(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 $r({head:[_.cyan("Name"),_.cyan("Source"),_.cyan("Color"),_.cyan("Logo"),_.cyan("Default"),_.cyan("ID")]});for(let o of e){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 Tr(t){try{return new Date(t).toLocaleString()}catch{return t}}function me(t){console.log(),console.log(_.bold(t)),console.log(_.gray("\u2500".repeat(t.length)))}function S(t,e){console.log(` ${_.gray(`${t}:`)} ${e??"-"}`)}function Fl(t){return JSON.stringify(t,null,2)}function l(t){console.log(Fl(t))}import{createHash as dm,randomUUID as Be}from"crypto";import{readFileSync as Mi,statSync as Fi}from"fs";import{basename as _r}from"path";import{spawnSync as Bl}from"child_process";import{existsSync as Gl,mkdtempSync as Wl,rmSync as Kl,writeFileSync as Jl}from"fs";import{tmpdir as zl}from"os";import{join as Pi}from"path";import Ar from"ffmpeg-static";var Hl=/Duration:\s*(\d+):(\d+):(\d+(?:\.\d+)?)/;function Xl(t){let e=Hl.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 Oi(t,e="audio"){if(t.length===0)return;let n=Ar&&Gl(Ar)?Ar:"ffmpeg",r=/^[a-z0-9]+$/i.test(e)?e:"audio",o=Wl(Pi(zl(),"mf-tts-duration-")),i=Pi(o,`speech.${r}`);try{Jl(i,t);let s=Bl(n,["-hide_banner","-i",i],{encoding:"utf8"});return s.error?void 0:Xl(s.stderr??"")}finally{Kl(o,{force:!0,recursive:!0})}}import wn 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 Yl(){let t=xi(),e=Ri(),n=G();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=Si();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 bn(),null;let u=await c.json();return yn(u.access_token,u.refresh_token,u.expires_in),u.access_token}catch{return null}}async function Di(){return Fe()?Ci()?Yl():ki()||null:null}function xe(){return Fe()||tt()}async function y(){if(!xe()){let t=p.commands[0],e=p.apiKeyEnvVar;console.error(wn.red("\u2717 Not authenticated.")),console.error(),console.error(wn.bold("To authenticate, run:")),console.error(wn.cyan(` ${t} login`)),console.error(),console.error(wn.gray(`Or set ${e} environment variable.`)),process.exit(d.AUTH_ERROR)}}function Ql(t){return t.length<=14?"****":`${t.slice(0,10)}...${t.slice(-4)}`}function Ni(){let t=ke();if(t)return Ql(t)}function Pr(t){return["cc_slides_","mcp_","cc_sk_","sk_"].some(n=>t.startsWith(n))}import{mkdirSync as Zl,readFileSync as em,writeFileSync as tm}from"fs";import{homedir as nm}from"os";import{join as _i}from"path";import rm from"ajv/dist/2020.js";var Or=new Map;function Ui(){return _i(nm(),".conceptcraft","schemas")}function Li(t){return _i(Ui(),`${t}.json`)}function om(t){try{let e=JSON.parse(em(Li(t),"utf8"));return typeof e?.catalogVersion=="number"&&e.schema?e:null}catch{return null}}function im(t,e){try{Zl(Ui(),{recursive:!0}),tm(Li(t),JSON.stringify(e))}catch{}}async function am(t){let e=Or.get(t);if(e!==void 0)return e;try{let n=await qi(t),r={catalogVersion:n.catalogVersion,schema:n.operationSchema??n.schema};return im(t,r),Or.set(t,r),r}catch{let n=om(t);return Or.set(t,n),n}}function sm(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 vn(t,e){let n=await am(t);if(!n)return;let r;try{r=new rm({allErrors:!0,strict:!1}).compile(n.schema)}catch{return}if(r(e))return;let o=(r.errors??[]).slice(0,10).map(sm);throw new Error(`Request does not match the ${t} contract \u2014 ${o.join("; ")}`)}function ue(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 Dr(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 ji(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 Ce(){let t=await Di();if(t)return{Authorization:`Bearer ${t}`};let e=ke();return e?{"x-api-key":e}:{}}var O=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},Ut="Idempotency-Key";function cm(t){return t&&t!=="GET"?{[Ut]:Be()}:{}}async function J(t,e={}){let n=G();if(!xe()&&!e.allowUnauthenticated)throw new O(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2,"authentication_required");let r=await Ce(),o=`${n}${t}`,i={...r,...cm(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 O(`Network error: ${f instanceof Error?f.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!c.ok){let f=await c.text().catch(()=>""),h=mm(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 I=`[${h.code}] ${h.message}`;throw new O(I,c.status,v,h.code,h.retryable)}return e.stream?c:c.headers.get("content-type")?.includes("application/json")?c.json():c.text()}function lm(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 mm(t,e){let n=lm(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 qi(t){return J(`/api/cli/tools/${encodeURIComponent(t)}/schema`)}async function Bi(){return J("/api/cli/capabilities",{allowUnauthenticated:!0})}async function k(t,e,n){let r=await Lt(n),o=`?teamId=${encodeURIComponent(r)}`;return J(`/api/cli/tool-runs/${encodeURIComponent(t)}/${encodeURIComponent(e)}${o}`)}async function m(t,e,n){let r=await Lt(e.teamId);return J(`/api/cli/tools/${encodeURIComponent(t)}`,{body:{...e,teamId:r},headers:n?{[Ut]:n}:void 0,method:"POST"})}function Y(t){return Lt(t)}async function Lt(t){let e=typeof t=="string"&&t.trim()?t.trim():ee()?.trim();if(e)return e;let n=await we();if(n.currentTeam?.id)return n.currentTeam.id;throw new O("Team ID required. Select a workspace with `mf config set team-id <id>` or pass --team-id.",400,void 0,"invalid_input")}async function Gi(t){return J("/api/llm-connections/profiles",{body:t,method:"POST"})}async function ye(t,e,n,r=120){let o=0;for(let i=0;r===null||i<r;i++){let s;try{s=await k(t,e,n),o=0}catch(c){if(c instanceof O&&c.retryable&&o<2){o+=1,await new Promise(u=>setTimeout(u,2e3));continue}throw c instanceof O?new O(`${c.message} Request ID: ${e}.`,c.statusCode,c.exitCode,c.errorCode,c.retryable):new O(`${c instanceof Error?c.message:"Unknown error"} Request ID: ${e}.`,0,5,"poll_failed",!0)}if(s.done){if(s.error)throw new O(`${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 O(`[operation_timed_out] The background operation timed out. Request ID: ${e}.`,408,1,"operation_timed_out",!0)}function In(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 um(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 Wi(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 qt(t){let e=Fi(t);return{fileName:_r(t),fileSize:e.size,fileType:Wi(t)}}async function jt(t,e){let n=qt(t),r=Mi(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 O("Failed to upload file to storage",i.status,1);return{id:Be(),name:n.fileName,s3Key:e.s3Key,url:e.fileUrl,size:n.fileSize,type:n.fileType,selected:!0}}async function be(t,e={}){let n=G();if(!xe())throw new O(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let r=await Ce(),o=Fi(t),i=_r(t),s=Wi(t),c=Mi(t),u=dm("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:u,idempotencyKey:e.idempotencyKey}}:{}})});if(!f.ok){let v=await f.text();throw new O(v||"Failed to get upload URL",f.status,1)}let h=await f.json();return jt(t,{fields:h.fields||{},fileUrl:h.fileUrl,s3Key:h.uploadKey,uploadUrl:h.url})}async function Ki(t,e){let n=[];for(let r=0;r<t.length;r++){let o=t[r],i=_r(o);e?.(r,t.length,i);let s=await be(o);n.push(s)}return e?.(t.length,t.length,""),n}async function Ji(t){let e={};for(let[n,r]of Object.entries(t))r!==void 0&&(e[n]=r);return e.brandingId===void 0&&typeof e.brandId=="string"&&(e.brandingId=e.brandId),delete e.brandId,m("createSlides",{...e,approvalReceipt:"cli:create"})}async function zi(t,e=20,n=0,r="updated"){return(await m("listPresentations",{limit:e,offset:n,sort:r,teamId:t})).presentations}async function rt(t,e){let n=e?.includeSlides!==!1,r=new URLSearchParams({includeSlides:String(n)});return e?.teamId&&r.set("teamId",e.teamId),J(`/api/cli/presentation/${encodeURIComponent(t)}?${r}`)}async function Hi(t,e,n,r){return J(`/api/cli/presentation/${encodeURIComponent(t)}/speaker-notes?teamId=${encodeURIComponent(r)}`,{body:e,headers:{[Ut]:n},method:"POST"})}async function Xi(t,e){return J(`/api/cli/presentation-video/${encodeURIComponent(t)}/narration`,{body:e,method:"POST"})}async function kn(t){let e=G(),n=await fetch(`${e}/api/durable-runs/${encodeURIComponent(t)}/events`,{headers:await Ce()});if(!n.ok)throw new O(await n.text(),n.status);return n}async function Yi(t,e={}){let n=await Lt(e.teamId);await J(`/api/cli/presentation/${encodeURIComponent(t)}?teamId=${encodeURIComponent(n)}&confirmed=true`,{headers:{[Ut]:e.idempotencyKey??`cli:presentation:delete:${Be()}`},method:"DELETE"})}async function Qi(t,e){let n=await Lt(e.teamId);return J(`/api/cli/presentation/${encodeURIComponent(t)}/visibility?teamId=${encodeURIComponent(n)}`,{body:{visibility:e.visibility},headers:{[Ut]:e.idempotencyKey??`cli:presentation:visibility:${Be()}`},method:"PATCH"})}async function Zi(t,e,n){let r=new URLSearchParams;n?.teamId&&r.set("teamId",n.teamId);let o=r.size>0?`?${r}`:"";return J(`/api/cli/presentation/${encodeURIComponent(t)}/export${o}`,{body:{format:e},method:"POST"})}async function ea(t){let e;try{e=await fetch(t)}catch(n){throw new O(`Network error while downloading the export: ${n instanceof Error?n.message:"Unknown error"}`,0,5,"service_unavailable",!0)}if(!e.ok)throw new O(`[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 ta(t,e,n={}){let r=G();if(!xe())throw new O(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let o=await Ce(),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}),u=await c.json();if(!c.ok)throw new O(u.errors?.[0]?.message??"Import failed",c.status,1);return u}async function na(t,e=25){let n=new URLSearchParams;return n.set("limit",String(e)),t&&n.set("search",t),J(`/api/cli/templates?${n}`)}async function ra(t,e,n,r,o){return m("extractBranding",{approvalReceipt:n,skipExistingBrandingLookup:r,teamId:e,url:t},o)}async function we(){return J("/api/cli/whoami")}async function oa(){return J("/api/cli/features")}async function ia(t,e,n={}){let r=G();if(!xe())throw new O(`Not authenticated. Run '${p.commands[0]} login' or set ${p.apiKeyEnvVar} environment variable.`,401,2);let o=await Ce(),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 O(await i.text(),i.status,i.status===404?3:1);return i}async function Ur(t){let e=new URLSearchParams;t&&e.set("teamId",t);let n=e.toString();return J(`/api/cli/limits${n?`?${n}`:""}`)}async function aa(t,e,n){let r=await Ur(n);if(!r.canGenerate[t]){let o=r.remaining[t]??0,i=r.limits[t]??0;throw i===0?new O(`The "${t}" mode is not available on your ${r.planName} plan. Available modes: ${r.availableModes.join(", ")||"none"}`,403,2):new O(`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 O(`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 pm(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 sa(t){let e={...t,text:pm(t.text)};await vn("generateSpeech",e);let n=await m("generateSpeech",{approvalReceipt:"cli:tts-generate",...e}),r=await ye("generateSpeech",n.runId),o=r.entity?.url;if(!o)throw new O(`Speech completed without an audio URL. Request ID: ${n.runId}.`,500);let i;try{i=await fetch(o)}catch(v){throw new O(`${v instanceof Error?v.message:"Failed to download speech audio"} Request ID: ${n.runId}.`,0,5,"download_failed",!0)}if(!i.ok)throw new O(`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??{},u=he(s.format)??um(o)??"mp3",f=Buffer.from(await i.arrayBuffer()),h=da(s.durationSec,s.duration,s.duration_s)??Oi(f,u);if(h===void 0)throw new O(`Speech completed without a measurable duration. Request ID: ${n.runId}.`,500,1,"invalid_audio_metadata");return{audioData:f,audioUrl:o,duration:h,provider:he(s.provider)??c.provider??"gemini",format:u,requestId:n.runId,voiceId:he(s.voice_id)??he(s.voiceId),voice:he(s.voice),model:he(s.model),speed:Nr(s.speed)??c.speed,language:he(s.lang)??he(s.language)??c.language,langApplied:Vi(s.langApplied)??Vi(s.lang_applied),timestamps:gm(s.timestamps),wordTimings:fm(s.timestamps??s.timings)}}function da(...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 gm(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 fm(t){if(!Array.isArray(t))return;let e=t.flatMap(n=>{if(!n||typeof n!="object"||Array.isArray(n))return[];let r=n,o=he(r.text)??he(r.word),i=Nr(r.start),s=Nr(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 he(t){return typeof t=="string"&&t.trim()?t.trim():void 0}function Nr(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function Vi(t){return typeof t=="boolean"?t:void 0}async function ca(t){let e=t?`/api/cli/tts?provider=${t}`:"/api/cli/tts";return J(e)}async function la(t){let e={...t},n=typeof e.idempotency_key=="string"?e.idempotency_key:void 0;return delete e.idempotency_key,await vn("generateMusic",e),{requestId:(await m("generateMusic",{...e,approvalReceipt:"cli:music-generate"},n)).runId,status:"pending"}}async function Lr(t){let e=await k("generateMusic",t);return{requestId:t,status:In(e),audioUrl:e.entity?.url,duration:da(e.output?.durationSec,e.output?.duration,e.output?.duration_s),error:e.error?.message}}async function ma(t){return{requestId:(await m("mixAudio",{...t,approvalReceipt:"cli:mix-create"})).runId,status:"pending"}}async function qr(t){let e=await k("mixAudio",t);return{requestId:t,status:In(e),outputUrl:e.entity?.url,error:e.error?.message}}async function ua(t){return J("/api/cli/images/search",{method:"POST",body:t})}async function pa(t){return J("/api/cli/videos/search",{method:"POST",body:t})}async function de(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 O&&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 O("Operation timed out",408,1)}async function ga(t,e,n){return m("getYoutubeTranscript",{...n?{language:n}:{},teamId:e,url:t})}async function fa(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 ha(t){let e={...t},n=typeof e.idempotency_key=="string"?e.idempotency_key:void 0;delete e.idempotency_key,await vn("generateSfx",e);let r=await m("generateSfx",{...e,approvalReceipt:"cli:sfx-generate"},n);return{id:r.runId,requestId:r.runId,status:"pending"}}async function jr(t){let e=await k("generateSfx",t);return{id:e.entity?.id??t,requestId:t,status:In(e),audioUrl:e.entity?.url,error:e.error?.message}}async function ya(t){return m("listPresenterOptions",{...t?{voiceLanguage:t}:{}})}async function ba(t){return{requestId:(await m("generateAvatarVideo",{...t,approvalReceipt:"cli:avatar-generate"})).runId,status:"pending"}}async function Vr(t){let e=await k("generateAvatarVideo",t);return{durationSec:typeof e.output?.durationSec=="number"?e.output.durationSec:null,error:e.error?.message,requestId:t,status:In(e),videoUrl:e.entity?.url}}async function wa(t){return m("lipsyncVideo",{...t,approvalReceipt:"cli:video-lipsync"})}async function va(){return(await m("listTranslationLanguages",{})).languages}async function Ia(t){return m("translateVideo",{...t,approvalReceipt:"cli:video-translate"})}async function ka(t,e,n){return m("createVideo",{...t,approvalReceipt:e},n)}async function xa(t){let{idempotencyKey:e,...n}=t;return m("analyzeVideoReference",n,e)}async function Ca(t,e){return ye("analyzeVideoReference",t,e)}async function Ra(t,e){return ye("selectPresentationVideoStockMusic",t,e)}async function Sa(t,e){return ye("preparePresentationVideoPreviews",t,e,null)}async function Ea(t,e){return ye("generateBrandVariations",t,e)}async function $a(t,e){return ye("extractBrandProducts",t,e)}async function Ta(t,e){return ye("buildBrandVoice",t,e)}async function Aa(t,e){return ye("generateBrandGuardrails",t,e)}async function Pa(t,e){return ye("repairBrandQuality",t,e)}async function Oa(t,e){return ye("syncBrandToPresentations",t,e)}async function Da(t){return m("listCastPresets",t)}async function Na(t){return m("createCastPreset",t,Be())}async function _a(t){return m("updateCastPreset",t,Be())}async function Ua(t){return m("deleteCastPreset",{presetId:t},Be())}var La=[{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 xn(t){return{capabilities:La,catalogVersion:1,reason:t,source:"snapshot"}}async function Vt(t=Bi){try{let{capabilities:e,catalogVersion:n}=await t();return!Array.isArray(e)||e.length===0?xn("the live catalog returned no capabilities"):{capabilities:e,catalogVersion:n,source:"live"}}catch(e){let n=e instanceof Error?e.message:String(e);return xn(n)}}import{InvalidArgumentError as ym}from"commander";function b(t,e){return n=>{if(e.includes(n))return n;throw new ym(`Expected one of: ${e.join(", ")}. Run the command with --help to see what ${t} accepts.`)}}var qa=["presentations","media","branding","knowledge","research","artifacts","agents"],wm=80,vm=30;function Im(t){return t.billing!==void 0&&t.billing!=="free"&&t.billing!=="quota"}function km(t){return t.lifecycle?.mode==="background"}function xm(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 ja(t){let e=qa.indexOf(t);return e===-1?qa.length:e}function Cm(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 Rm(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=ja(i)-ja(s);return c!==0?c:i.localeCompare(s)}),r=Math.min(vm,Math.max(...t.map(i=>i.name.length))),o=[];for(let[i,s]of n){s.sort((c,u)=>c.name.localeCompare(u.name)),o.length>0&&o.push(""),o.push(Mt.bold(`${i} (${s.length})`));for(let c of s){let u=`${Im(c)?"$":" "}${km(c)?"*":" "}`,f=c.name.padEnd(r),h=2+r+1+u.length+1,v=Math.max(24,wm-h),I=xm(c.description??"",v);o.push(` ${Mt.cyan(f)} ${Mt.yellow(u)} ${I[0]??""}`.trimEnd());for(let $ of I.slice(1))o.push(`${" ".repeat(h)}${$}`)}}return o}function Sm(t){return t.map(e=>`${e.name} ${e.state} ${e.milestone}`)}function Em(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 Sm(t);let r=p.commands[0],o=Rm(t);return o.push(""),o.push(Mt.dim(`${t.length} capabilities \xB7 $ = paid \xB7 * = background (returns a run id)`)),o.push(Mt.dim(`Filter with: ${r} capabilities --search <query>`)),o}var Va=new bm("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 Vt(),n=Cm(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"&&V(`Showing the capability list baked into this CLI build (${e.reason}); the deployed catalog may have moved on.`);for(let o of Em(n,{filtered:r}))console.log(o)}catch(e){a(e instanceof Error?e.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});import{mkdirSync as Pm,writeFileSync as Om}from"fs";import{dirname as Ga,join as Dm}from"path";import{Command as Ae}from"commander";import Ft from"chalk";import{input as Nm,password as _m,confirm as Wa,select as Um}from"@inquirer/prompts";import Rn from"ora";import $m from"conf";var Cn=new $m({projectName:"conceptcraft",configName:"feature-cache"}),Tm=3600*1e3,Am=1440*60*1e3;function Ma(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 Fa(){if(!tt())return null;let t=Cn.get("featureFlags");if(!t)return null;let e=Ma(ke());if(t.apiKeyHash&&t.apiKeyHash!==e)return We(),null;let n=Date.now()-t.fetchedAt;return n>Am?null:(n>Tm&&Mr(),t.flags)}function Mr(){Ge().catch(()=>{})}async function Ge(){let t=await oa(),e=ke();return Cn.set("featureFlags",{flags:t,fetchedAt:Date.now(),apiKeyHash:e?Ma(e):void 0}),t}function We(){Cn.delete("featureFlags")}function Ba(){return Cn.path}var Ka=new Ae("config").description("Manage CLI configuration: account settings, and the cached feature flags that decide which commands appear").addCommand(new Ae("init").description("Initialize configuration interactively").action(async()=>{console.log(),console.log(Ft.bold(`${p.displayName} CLI Configuration`)),console.log(Ft.gray("\u2500".repeat(35))),console.log();try{let t=await _m({message:"Enter your API key:",mask:"*",validate:r=>!r||r.trim().length===0?"API key is required":Pr(r.trim())?!0:"Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"});if(Sr(t.trim()),await Wa({message:`Use a custom API URL? (default: ${p.apiUrl.replace("https://","")})`,default:!1})){let r=await Nm({message:"Enter API URL:",default:G(),validate:o=>{try{return new URL(o),!0}catch{return"Invalid URL format"}}});Er(r)}console.log();let n=Rn("Verifying API key...").start();try{let r=await we();if(n.succeed("API key verified!"),console.log(),w(`Logged in as: ${r.user.email}`),r.teams.length===0)V("No teams found for this user.");else if(r.teams.length===1){let o=r.teams[0];et(o.id),w(`Team: ${o.name} (${o.planName})`)}else{console.log(),w(`You have access to ${r.teams.length} teams.`);let o=await Um({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});et(o);let i=r.teams.find(s=>s.id===o);x(`Selected team: ${i?.name}`)}try{await Ge()}catch{}}catch(r){n.fail("Failed to verify API key"),V(`Could not verify API key: ${r instanceof Error?r.message:String(r)}`),V(`You may need to set the team ID manually: ${p.commands[0]} config set team-id <id>`)}console.log(),x("Configuration saved!"),w(`Config file: ${_t()}`),console.log()}catch(t){if(t.name==="ExitPromptError"){console.log(),w("Configuration cancelled.");return}throw t}})).addCommand(new Ae("show").description("Show current configuration").option("--verify","Verify API key and show team details").action(async t=>{let e=Ii();if(me("Current Configuration"),console.log(),S("API Key",Ni()??Ft.red("Not set")),S("API URL",e.apiUrl),S("Default Team ID",e.defaultTeamId??Ft.gray("Not set")),console.log(),S("Config file",_t()),t.verify&&e.apiKey){console.log();let n=Rn("Verifying...").start();try{let r=await we();n.succeed("Verified"),console.log(),S("User",r.user.email),r.currentTeam&&S("Current Team",`${r.currentTeam.name} (${r.currentTeam.planName})`),r.teams.length>1&&S("Total Teams",String(r.teams.length))}catch(r){n.fail("Verification failed"),V(r instanceof Error?r.message:String(r))}}console.log()})).addCommand(new Ae("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":Pr(e)||(a("Invalid API key format. Keys should start with 'cc_slides_' or 'mcp_'"),process.exit(6)),Sr(e),We(),x("API key updated"),Ge().catch(()=>{});break;case"api-url":try{new URL(e),Er(e),x(`API URL set to: ${e}`)}catch{a("Invalid URL format"),process.exit(6)}break;case"team-id":et(e),x(`Default team ID set to: ${e}`);break;default:a(`Unknown config key: ${t}`),console.log(Ft.gray("Valid keys: api-key, api-url, team-id")),process.exit(6)}})).addCommand(new Ae("clear").description("Clear all configuration").action(async()=>{try{await Wa({message:"Are you sure you want to clear all configuration?",default:!1})?(hn(),We(),x("Configuration cleared")):w("Cancelled")}catch{w("Cancelled")}})).addCommand(new Ae("refresh").description("Refresh cached feature flags").action(async()=>{let t=Rn("Refreshing feature flags...").start();try{await Ge(),t.succeed("Feature flags refreshed"),w(`Run '${p.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 Ae("path").description("Show configuration file path").option("--cache","Show feature cache file path").action(t=>{t.cache?console.log(Ba()):console.log(_t())})).addCommand(new Ae("pull").description("Pull your account settings (memory, brand, prefs) into a local config.toml").action(async()=>{let t=Rn("Pulling settings...").start();try{let e=await Ce(),n=await fetch(`${G()}/api/cli/settings`,{headers:e});if(!n.ok)throw new Error(`Request failed (HTTP ${n.status})`);let r=await n.text(),o=Dm(Ga(_t()),"settings.toml");Pm(Ga(o),{recursive:!0}),Om(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 Lm}from"commander";import{confirm as qm}from"@inquirer/prompts";var Ja=new Lm("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("-q, --quiet","Suppress output").action(async(t,e)=>{if(await y(),!e.yes&&!e.force)try{if(!await qm({message:`Are you sure you want to delete presentation "${t}"?`,default:!1})){e.quiet||V("Deletion cancelled");return}}catch{e.quiet||V("Deletion cancelled");return}try{await Yi(t,{idempotencyKey:e.idempotencyKey,teamId:e.teamId??ee()}),e.quiet||x(`Presentation "${t}" deleted`)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}});import{Command as ot}from"commander";import Ha from"chalk";import jm from"ora";import{createParser as Fk}from"eventsource-parser";import Gk from"chalk";import Kk from"ora";async function za(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 Vm(){return new ot("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=jm("Fetching presentation...").start();try{let i=await rt(t);o.text="Generating blog post...";let s=await ia(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 za(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(Ha.bold(`Blog: ${i.title}`)),console.log(Ha.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 Mm(){return new ot("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 Fm(){return new ot("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 Bm(){return new ot("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 Gm(){return new ot("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 Xa(){let t=new ot("derive").description("Generate derivative content from a presentation"),e=Fa();return e&&(e.deckToBlog&&t.addCommand(Vm()),e.deckToTweets&&t.addCommand(Mm()),e.linkedInCarousel&&t.addCommand(Fm()),e.redTeamQuestions&&t.addCommand(Bm()),e.presenterCheatSheet&&t.addCommand(Gm())),t}import{Command as Wm}from"commander";import Fr from"chalk";var Ya=new Wm("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(Fr.gray("The CLI will support idea generation in a future release.")),console.log(),console.log("For now, try these approaches:"),console.log(Fr.gray("` 1. Visit the ${brand.displayName} dashboard and use the idea generator`")),console.log(Fr.gray(" 2. Create a presentation with a broad topic and refine it")),console.log()});import{Command as Km}from"commander";import{readFile as Jm}from"fs/promises";import{resolve as zm,basename as Hm}from"path";import Xm from"ora";var Qa=new Km("import").description("Import a presentation from ZIP (admin only)").argument("<file>","Path to ZIP file");Qa._hidden=!0;var Za=Qa.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 we()).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=zm(t),r=Hm(n);r.endsWith(".zip")||(a("File must be a ZIP archive"),process.exit(6));let o=Xm("Reading file...").start();try{let i=await Jm(n);e.dryRun?o.text="Validating...":o.text="Importing presentation...";let s=await ta(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(),S("Slides",String(s.statistics.slidesImported)),S("Images",String(s.statistics.imagesUploaded)));else if(o.succeed("Import complete!"),console.log(),S("Presentation ID",s.presentationId??"N/A"),S("Document ID",s.documentId??"N/A"),s.statistics&&(S("Slides imported",String(s.statistics.slidesImported)),S("Images uploaded",String(s.statistics.imagesUploaded)),S("Time",`${s.statistics.totalTimeMs}ms`)),s.presentationId){let c=G();S("View URL",`${c}/p/${s.presentationId}`)}if(s.warnings&&s.warnings.length>0){console.log();for(let c of s.warnings)V(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 Ym}from"commander";var Sn=new Ym("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 zi(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):Ti(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 Qm,randomBytes as ns}from"crypto";import rs from"http";import es from"chalk";import{Command as Zm}from"commander";import eu from"open";import ts from"ora";var tu=`${p.displayName} CLI`,nu=8765,ru=8775,ou=["presentations:read","presentations:write","brands:read","brands:write","media:read","media:write"];function iu(){return ns(32).toString("base64url")}function au(t){return Qm("sha256").update(t).digest("base64url")}function su(){return ns(16).toString("hex")}async function du(t,e){for(let n=t;n<=e;n++)try{return await new Promise((r,o)=>{let i=rs.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 cu(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 lu(t){let e=t.scopes_supported?.filter(n=>typeof n=="string"&&n.trim().length>0);return(e?.length?e:ou).join(" ")}function mu(t,e){if(!e?.trim())return lu(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 uu(t,e,n){let r=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({client_name:tu,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 pu(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 gu(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),u.close())},c=()=>{s(),r(new Error("Login cancelled"))},u=rs.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 I=v.searchParams.get("code"),$=v.searchParams.get("state"),D=v.searchParams.get("error"),C=v.searchParams.get("error_description");if(h.writeHead(200,{"Content-Type":"text/html"}),D){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>
8
8
  <body style="font-family: system-ui; text-align: center; padding: 50px;">
9
9
  <h1 style="color: #dc2626;">Login Failed</h1>
10
- <p>${C||D}</p>
10
+ <p>${S||A}</p>
11
11
  <p>You can close this window.</p>
12
12
  </body>
13
13
  </html>
14
- `),s(),r(new Error(C||D));return}if(!I||!$){h.end(`
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
- `),s(),r(new Error("Missing authorization code or state"));return}if($!==e){h.end(`
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
- `),s(),r(new Error("State mismatch"));return}h.end(`
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,83 +40,111 @@ 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
- `),s(),n({code:I,state:$})});u.listen(t),process.once("SIGINT",c),process.once("SIGTERM",c),o=setTimeout(()=>{s(),r(new Error("Login timed out - no callback received within 5 minutes"))},300*1e3)})}async function fu(t,e){let n=await fetch(`${t}/api/cli/whoami`,{headers:{Authorization:`Bearer ${e}`}});if(!n.ok)throw new Error(`Failed to fetch user info: ${n.status}`);return n.json()}async function hu(t){let e=G(),n=ts("Discovering OAuth server...").start();try{let r=await cu(e),o=mu(r,t.scopes);n.succeed(`Connecting to ${e}`);let i=await du(nu,ru),s=`http://localhost:${i}/callback`;console.log(`Redirect URI: ${s}`),console.log(`Authorization endpoint: ${r.authorization_endpoint}`),console.log(`Token endpoint: ${r.token_endpoint}`),console.log(`Registration endpoint: ${r.registration_endpoint}`);let c=await uu(r.registration_endpoint,s,o),u=c.client_id;Ei(u,c.client_secret);let f=iu(),h=au(f),v=su(),I=new URLSearchParams({client_id:u,redirect_uri:s,response_type:"code",scope:o,state:v,code_challenge:h,code_challenge_method:"S256"}),$=`${r.authorization_endpoint}?${I}`;console.log(`Authorization URL: ${$}`),t.browser?(w("Opening browser..."),await eu($)):(console.log(es.bold("Open this URL in your browser:")),console.log(es.cyan($)));let D=gu(i,v),{code:C}=await D;n=ts("Completing login...").start();let A=await pu(r.token_endpoint,C,f,s,u);yn(A.access_token,A.refresh_token,A.expires_in);let E=await fu(e,A.access_token);n.succeed("Logged in!"),console.log(),S("Logged in as",E.user.email),E.currentTeam&&(et(E.currentTeam.id),S("Team",`${E.currentTeam.name} (${E.currentTeam.planName})`));try{await Ge()}catch{}console.log(),x("You're all set!"),console.log()}catch(r){throw n.fail("Login failed"),a(r instanceof Error?r.message:String(r)),r}}var os=new Zm("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 t=>{console.log(),Fe()&&(V("You are already logged in."),w(`Run '${p.commands[0]} logout' to log out first, or continue to re-authenticate.`),console.log());try{await hu(t),process.exit(0)}catch{process.exit(1)}});import{Command as yu}from"commander";import{confirm as bu}from"@inquirer/prompts";var is=new yu("logout").description("Log out and clear authentication").option("--all","Clear all config including API key").action(async t=>{console.log();let e=Fe(),n=tt();if(!e&&!n){V("You are not logged in."),console.log();return}if(t.all)try{await bu({message:"Clear all configuration including API key?",default:!1})?(hn(),We(),x("All configuration cleared.")):w("Cancelled.")}catch{w("Cancelled.")}else bn(),We(),x("Logged out successfully."),n&&w("Note: Your API key is still configured. Use --all to clear everything.");console.log()});import{homedir as rp}from"os";import{join as op}from"path";import pe from"chalk";import{Command as ip}from"commander";import{spawn as wu}from"child_process";import{existsSync as vu,readdirSync as Iu}from"fs";import{homedir as ds}from"os";import{delimiter as as}from"path";import{query as ku}from"@anthropic-ai/claude-agent-sdk";function ce(t){if(t===void 0)return null;if(typeof t=="string")return t.length>12e3?`${t.slice(0,12e3)}\u2026`:t;try{let e=JSON.stringify(t);return e.length<=12e3?t:{preview:`${e.slice(0,12e3)}\u2026`,truncated:!0}}catch{return String(t).slice(0,12e3)}}function En(t){let e=typeof t=="string"?t:String(t??"");return e.length>12e3?`${e.slice(0,12e3)}\u2026`:e}function le(t){return t&&typeof t=="object"&&!Array.isArray(t)?t:{}}function U(t){return typeof t=="string"?t:""}function ss(t,e){let n=t.replace(/[/.]/g,"-");return`${ds()}/.claude/projects/${n}/${e}.jsonl`}function xu(t){try{return Iu(`${t}/.nvm/versions/node`).map(e=>`${t}/.nvm/versions/node/${e}/bin`).sort().reverse()}catch{return[]}}function $n(){let t=ds(),e=[`${t}/.local/bin`,`${t}/.claude/local`,`${t}/.bun/bin`,`${t}/bin`,"/opt/homebrew/bin","/usr/local/bin",...xu(t)],r=(process.env.PATH??"").split(as);for(let o of e)r.includes(o)||r.push(o);return r.join(as)}async function Tn(t){let e=t??"claude";return new Promise(n=>{let r=wu(e,["--version"],{env:{...process.env,PATH:$n()},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 s=o.trim().split(`
44
- `)[0]??"";n(s?{bin:e,version:s}:null)})})}var Cu=new Set(["","default","best"]);function Br(t){let e=t.filter(i=>i.text.trim());if(e.length===0)return"";let n=e[e.length-1],r=e.slice(0,-1);return r.length===0?n.text:`<conversation-history>
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 Gr(t,e){return e?t.messages.filter(r=>r.text.trim()).at(-1)?.text??"":Br(t.messages)}function Ru({abortController:t,input:e,resumeSessionId:n,workspace:r}){let o=(e.modelId??"").trim(),i=e.thinking??null,s={abortController:t,allowedTools:["WebSearch","WebFetch"],cwd:r,env:{...process.env,PATH:$n()},includePartialMessages:!0,maxTurns:16,permissionMode:"dontAsk"};return Cu.has(o)||(s.model=o),e.effort&&(s.effort=e.effort),i&&i!=="disabled"&&(s.thinking={display:"summarized",type:i==="enabled"?"enabled":"adaptive"}),n?s.resume=n:e.system?.trim()&&(s.systemPrompt=e.system),s}async function cs(t){let e=Gr(t.input,t.resumeSessionId);if(!e)throw new Error("Chat turn has no user text to send.");let n=new AbortController,r=()=>n.abort();t.signal?.addEventListener("abort",r,{once:!0});let o=null,i=null,s=null,c=null,u=null,f=0,h=new Set;try{let $=ku({prompt:e,options:Ru({abortController:n,input:t.input,resumeSessionId:t.resumeSessionId,workspace:t.workspace})});for await(let D of $){let C=D;if(C.type==="system"&&C.subtype==="init"){typeof C.session_id=="string"&&(i=C.session_id,t.onEvent({eventType:"chat.session",payload:{sessionId:i,sessionPath:ss(t.workspace,i)}})),typeof C.model=="string"&&(o=C.model,t.onEvent({eventType:"chat.model",payload:{modelId:C.model}}));continue}if(C.type==="stream_event"){let A=C.event;if(A?.type!=="content_block_delta")continue;let E=A.delta;if(!E)continue;E.type==="text_delta"&&typeof E.text=="string"?(f+=E.text.length,t.onEvent({eventType:"chat.text.delta",payload:{text:E.text}})):E.type==="thinking_delta"&&typeof E.thinking=="string"&&t.onEvent({eventType:"chat.reasoning.delta",payload:{text:E.thinking}});continue}if(C.type==="assistant"){let A=le(C.message),E=Array.isArray(A.content)?A.content:[];for(let M of E){let P=le(M);if(P.type!=="tool_use")continue;let q=U(P.id),R=U(P.name);!q||!R||h.has(q)||(h.add(q),t.onEvent({eventType:"chat.tool.started",payload:{input:ce(P.input),toolCallId:q,toolName:R}}))}continue}if(C.type==="user"){let A=le(C.message),E=Array.isArray(A.content)?A.content:[];for(let M of E){let P=le(M);if(P.type!=="tool_result")continue;let q=U(P.tool_use_id);q&&t.onEvent({eventType:"chat.tool.completed",payload:{...P.is_error===!0?{errorText:typeof P.content=="string"?En(P.content):"Claude tool call failed."}:{},output:ce(P.content),toolCallId:q}})}continue}C.type==="result"&&(typeof C.result=="string"&&(c=C.result),C.usage&&typeof C.usage=="object"&&(s=C.usage),typeof C.session_id=="string"&&(i=C.session_id),(C.is_error===!0||C.subtype!=="success")&&(u=typeof C.result=="string"&&C.result||`Claude turn failed (${String(C.subtype)}).`,t.onEvent({eventType:"chat.error",message:u,payload:{message:u}})))}}finally{t.signal?.removeEventListener("abort",r)}if(t.signal?.aborted)throw new Error("Chat turn cancelled.");if(u)throw new Error(u);let v=c??"";f===0&&v&&t.onEvent({eventType:"chat.text.delta",payload:{text:v}});let I=i?ss(t.workspace,i):null;return{modelId:o,sessionId:i,sessionPath:I&&vu(I)?I:null,text:v,usage:s}}import{spawn as Su}from"child_process";import{closeSync as Eu,fstatSync as $u,openSync as Tu,readdirSync as Au,readSync as Pu}from"fs";import{homedir as Ou}from"os";import{join as ls}from"path";import{Codex as Du}from"@openai/codex-sdk";var Nu=["/Applications/Codex.app/Contents/Resources/codex"];async function An(t){let e=t?[t]:["codex",...Nu];for(let n of e){let r=await _u(n);if(r)return{bin:n,version:r}}return null}function _u(t){return new Promise(e=>{let n=Su(t,["--version"],{env:{...process.env,PATH:$n()},stdio:["ignore","pipe","ignore"]}),r="";n.stdout.on("data",o=>{r+=o.toString("utf8")}),n.on("error",()=>e(null)),n.on("close",o=>{if(o!==0)return e(null);let i=r.trim().split(`
51
- `)[0]??"";e(i||null)})})}var Uu=24,Lu=4*1024*1024,ps=new Set(["custom_tool_call","custom_tool_call_output","dynamic_tool_call","function_call"]);function qu(t){let e;try{e=ju(t).split(`
52
- `)}catch{return[]}let n=new Set,r=new Map,o=null;for(let i of e){if(!i.trim())continue;let s;try{s=JSON.parse(i)}catch{continue}let c=le(s.payload);if(s.type==="response_item"&&c.type==="custom_tool_call"){let u=U(c.call_id),f=U(c.input);u&&c.name==="exec"&&/\btools\.web__run\s*\(/.test(f)&&(n.add(u),o=u);continue}if(s.type==="event_msg"&&c.type==="web_search_end"){let u=U(c.call_id);if(!u||!o)continue;let f=U(c.query),h=le(c.action),I={action:{...h,...f&&!U(h.query)?{query:f}:{}},query:f,sources:ms(c.results),toolCallId:u},$=r.get(o)??[];$.push(I),r.set(o,$);continue}if(s.type==="response_item"&&c.type==="custom_tool_call_output"){let u=U(c.call_id);if(!u||!n.has(u))continue;let f=ms(c.output);for(let h of r.get(u)??[])h.sources.length===0&&(h.sources=f);o===u&&(o=null)}}return Array.from(r.values()).flat()}function ju(t){let e=Tu(t,"r");try{let n=$u(e).size,r=Math.max(0,n-Lu),o=Buffer.alloc(n-r);Pu(e,o,0,o.length,r);let i=o.toString("utf8");if(r===0)return i;let s=i.indexOf(`
53
- `);return s===-1?"":i.slice(s+1)}finally{Eu(e)}}function ms(t){let n=Jr(t).match(/https?:\/\/[^\s<>"'()[\]{}\\]+/g)??[],r=new Set,o=[];for(let i of n){let s=i.replace(/[.,;:!?]+$/,"");try{let c=new URL(s);if(c.protocol!=="http:"&&c.protocol!=="https:"||r.has(c.href))continue;if(r.add(c.href),o.push({type:"url",url:c.href}),o.length>=Uu)break}catch{}}return o}function Jr(t){return typeof t=="string"?t:Array.isArray(t)?t.map(Jr).join(`
54
- `):t&&typeof t=="object"?Object.values(t).map(Jr).join(`
55
- `):""}function Wr(t,e){let n=le(t),r=U(n.type),o=U(n.id),i=U(n.call_id)||U(n.tool_call_id),s=ps.has(r)?i||o:o||i;if(!s)return null;if(r==="command_execution"){let c=U(n.command),u=U(n.status),f={exitCode:typeof n.exit_code=="number"?n.exit_code:null,output:ce(n.aggregated_output)};return{...e&&u==="failed"?{errorText:En(n.aggregated_output)||"Command failed."}:{},input:{command:c},...e?{output:f}:{},toolCallId:s,toolName:"Bash"}}if(r==="mcp_tool_call"){let c=le(n.error);return{...e&&U(c.message)?{errorText:U(c.message)}:{},input:ce(n.arguments),...e?{output:ce(n.result??{status:n.status??"completed"})}:{},toolCallId:s,toolName:U(n.tool)||U(n.name)||"Codex tool"}}if(r==="web_search"){let c=U(n.query);return{input:{query:c},...e?{output:{query:c}}:{},toolCallId:s,toolName:"web_search"}}if(r==="file_change"){let c=U(n.status);return{...e&&c==="failed"?{errorText:"Codex could not apply the file changes."}:{},input:{changes:ce(n.changes)},...e?{output:{changes:ce(n.changes),status:c}}:{},toolCallId:s,toolName:"ApplyPatch"}}if(r==="custom_tool_call_output")return{input:{},...e?{output:ce(n.output)}:{},toolCallId:s,toolName:"Codex tool"};if(r==="custom_tool_call"||r==="dynamic_tool_call"||r==="function_call"){let c=U(n.name)||U(n.tool)||"Codex tool",u=n.input??n.arguments??{};return{input:c==="exec"&&typeof u=="string"?{command:u}:ce(u),...e?{output:ce(n.output??n.result??{status:n.status??"completed"})}:{},toolCallId:s,toolName:c}}return null}function Kr(t,e=ls(Ou(),".codex","sessions")){try{let r=Au(e,{recursive:!0}).find(o=>typeof o=="string"&&o.endsWith(`${t}.jsonl`));return r?ls(e,r):null}catch{return null}}function Vu(t,e){return e?Gr(t,e):Br(t.messages)}function Mu(t,e,n=p.codexSelfConnectorAppId){let r=e.system?.trim(),o={...r?{developer_instructions:r}:{},...n?{apps:{[n]:{enabled:!1}}}:{}};return{codexPathOverride:t,...Object.keys(o).length>0?{config:o}:{}}}var Fu=new Set(["minimal","low","medium","high","xhigh"]);function Bu(t,e){let n={networkAccessEnabled:!0,sandboxMode:"workspace-write",skipGitRepoCheck:!0,webSearchEnabled:!0,workingDirectory:e},r=(t.modelId??"").trim();return r&&r!=="default"&&(n.model=r),t.effort&&Fu.has(t.effort)&&(n.modelReasoningEffort=t.effort),n}async function gs(t){let e=Vu(t.input,t.resumeSessionId);if(!e)throw new Error("Chat turn has no user text to send.");let n=new Du(Mu(t.bin,t.input)),r=Bu(t.input,t.workspace),o=t.resumeSessionId?n.resumeThread(t.resumeSessionId,r):n.startThread(r),i=t.resumeSessionId??null,s=null,c=null,u=[],f=new Set,h=new Set,v=null,I=C=>{v??=Kr(C,t.sessionsRoot),t.onEvent({eventType:"chat.session",payload:{sessionId:C,sessionPath:v}})},$=C=>{i&&(v??=Kr(i,t.sessionsRoot));let A=v?qu(v):[],E=U(le(C.input).query),M=us(E),P=A.find(q=>!f.has(q.toolCallId)&&us(q.query)===M)??A.find(q=>!f.has(q.toolCallId));P&&f.add(P.toolCallId),t.onEvent({eventType:"chat.tool.completed",payload:{...C,output:P?{action:P.action,query:P.query,sources:P.sources}:{action:{query:E,type:"search"},sourceListUnavailable:!0,sources:[]}}})},{events:D}=await o.runStreamed(e);i&&I(i);for await(let C of D){if(t.signal?.aborted)throw await D.return?.(void 0),new Error("Chat turn cancelled.");let A=C;if(A.type==="thread.started"){typeof A.thread_id=="string"&&(i=A.thread_id,I(A.thread_id));continue}if(A.type==="item.started"){let E=Wr(A.item,!1);if(E){t.onEvent({eventType:"chat.tool.started",payload:E});let M=le(A.item);if(ps.has(U(M.type))&&U(M.status)==="completed"){let P=Wr(M,!0);P&&(h.add(P.toolCallId),t.onEvent({eventType:"chat.tool.completed",payload:P}))}}continue}if(A.type==="item.completed"){let E=A.item;if(!E)continue;if(E.type==="agent_message"&&typeof E.text=="string")u.push(E.text),t.onEvent({eventType:"chat.text.delta",payload:{text:E.text}});else if(E.type==="reasoning"&&typeof E.text=="string")t.onEvent({eventType:"chat.reasoning.delta",payload:{text:E.text}});else{let M=Wr(E,!0);M&&(E.type==="web_search"?$(M):E.type==="custom_tool_call"&&h.has(M.toolCallId)||t.onEvent({eventType:"chat.tool.completed",payload:M}))}continue}if(A.type==="turn.completed"){A.usage&&typeof A.usage=="object"&&(s=A.usage);continue}if(A.type==="turn.failed"){let E=A.error;c=typeof E?.message=="string"&&E.message||"Codex turn failed.",t.onEvent({eventType:"chat.error",message:c,payload:{message:c}})}}if(c)throw new Error(c);return i=o.id??i,i&&(v??=Kr(i,t.sessionsRoot)),{modelId:t.input.modelId??null,sessionId:i,sessionPath:v,text:u.join(`
56
-
57
- `),usage:s}}function us(t){return t.trim().replace(/\s+/g," ").toLocaleLowerCase()}import{randomUUID as zu}from"crypto";import{mkdir as Hu}from"fs/promises";import{hostname as On,platform as Xu}from"os";import{join as Yu}from"path";var it=class extends Error{constructor(n,r,o=!1){super(n);this.statusCode=r;this.reRegister=o;this.name="RunnerApiError"}statusCode;reRegister};async function at(t,e={}){let n=await Ce();e.body!==void 0&&(n["Content-Type"]="application/json");let r=new AbortController,o=setTimeout(()=>r.abort(),e.timeoutMs??3e4),i=()=>r.abort();e.signal?.addEventListener("abort",i,{once:!0});try{let s=await fetch(`${G()}${t}`,{body:e.body!==void 0?JSON.stringify(e.body):void 0,headers:n,method:e.method??"GET",signal:r.signal}),c=await s.text(),u={};try{u=c?JSON.parse(c):{}}catch{u={error:c.slice(0,300)}}if(!s.ok)throw new it(typeof u.error=="string"?u.error:`Runner API returned ${s.status}`,s.status,u.reRegister===!0);return u}finally{clearTimeout(o),e.signal?.removeEventListener("abort",i)}}async function fs(t){await at("/api/runner/register",{body:t,method:"POST",timeoutMs:15e3})}async function hs(t,e){return(await at(`/api/runner/work?runnerId=${encodeURIComponent(t)}`,{signal:e,timeoutMs:28e3})).job??null}async function ys(t){await at("/api/runner/heartbeat",{body:{runnerId:t},method:"POST",timeoutMs:1e4})}async function bs(t,e){return{cancelRequested:(await at(`/api/runner/jobs/${encodeURIComponent(t)}/events`,{body:{events:e},method:"POST",timeoutMs:15e3})).cancelRequested===!0}}async function zr(t,e,n){await at(`/api/runner/jobs/${encodeURIComponent(t)}/complete`,{body:{result:n,runnerId:e},method:"POST",timeoutMs:15e3})}async function Pn(t,e,n,r=!0){await at(`/api/runner/jobs/${encodeURIComponent(t)}/fail`,{body:{message:n,retryable:r,runnerId:e},method:"POST",timeoutMs:15e3})}import{mkdirSync as Gu,readFileSync as Wu,writeFileSync as ws}from"fs";import{dirname as Ku,join as Ju}from"path";function Hr(t){return Ju(t,"sessions.json")}function Xr(t){try{let e=Wu(Hr(t),"utf8"),n=JSON.parse(e);if(n&&typeof n=="object"&&!Array.isArray(n))return n}catch{}return{}}function vs(t,e,n){return e?Xr(t)[e]?.[n]??null:null}function Is(t,e,n,r){if(!(!e||!r))try{let o=Hr(t);Gu(Ku(o),{recursive:!0});let i=Xr(t);i[e]={...i[e],[n]:r},ws(o,`${JSON.stringify(i,null," ")}
58
- `,"utf8")}catch{}}function ks(t,e,n){if(e)try{let r=Xr(t);if(!r[e])return;delete r[e][n],ws(Hr(t),`${JSON.stringify(r,null," ")}
59
- `,"utf8")}catch{}}var Qu=300,Zu=3e4;async function xs(t){let[e,n]=await Promise.all([Tn(t.claudeBin),An(t.codexBin)]);if(!e&&!n)throw new Error("Neither Claude Code nor Codex was found on this machine. Install one and log in, then retry.");e?t.log(`Claude Code detected: ${e.version} (${e.bin})`):t.log("Claude Code not found \u2014 Claude turns will be declined."),n?t.log(`Codex detected: ${n.version} (${n.bin})`):t.log("Codex not found \u2014 Codex turns will be declined.");let r=[...e?["claude-code"]:[],...n?["codex"]:[]],o=`${On().split(".")[0]}-${zu().slice(0,8)}`,i=()=>fs({capabilities:["chat_turn","proof"],claudeCodeVersion:e?.version??null,cliVersion:t.version,codexVersion:n?.version??null,hostname:On(),platform:Xu(),runnerId:o,runtimes:r});for(await i(),t.log(`Registered as ${o} (runtimes: ${r.join(", ")}). Waiting for work\u2026`);!t.signal?.aborted;){let s=null;try{s=await hs(o,t.signal)}catch(c){if(t.signal?.aborted)break;if(c instanceof it&&c.reRegister){t.log("Server asked for re-registration."),await i().catch(()=>{});continue}t.log(`Work poll failed (${c instanceof Error?c.message:"unknown"}); retrying\u2026`),await np(t.pollBackoffMs??5e3,t.signal);continue}if(!s){if(t.once)continue;continue}if(t.log(`Claimed ${s.jobType} job ${s.runId}.`),await ep({claude:e,codex:n,job:s,options:t,runnerId:o}),t.once)break}}async function ep({claude:t,codex:e,job:n,options:r,runnerId:o}){let i=new AbortController,s=()=>i.abort();r.signal?.addEventListener("abort",s,{once:!0});let c=setInterval(()=>{ys(o).catch(()=>{})},Zu),u=[],f=!1,h=async()=>{if(f||u.length===0)return;f=!0;let $=u.splice(0,100);try{let{cancelRequested:D}=await bs(n.runId,$);D&&i.abort()}catch(D){D instanceof it&&D.statusCode===409&&i.abort()}finally{f=!1}},v=setInterval(()=>{h()},Qu),I=$=>{u.push($)};try{if(n.jobType==="runner.proof"){let $=typeof n.input.message=="string"?n.input.message:"proof";I({eventType:"proof.echo",payload:{message:$}}),await Yr(h,u),await zr(n.runId,o,{echo:$}),r.log(`Proof job ${n.runId} completed.`);return}if(n.jobType==="runner.chat_turn"){let $=n.input.runtime==="codex"?"codex":"claude-code",D=$==="codex"?e&&{detection:e,run:gs}:t&&{detection:t,run:cs};if(!D){await Pn(n.runId,o,$==="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 C=typeof n.input.chatId=="string"&&n.input.chatId?n.input.chatId:null,A=Yu(r.workspaceRoot,"chats",C??n.runId);await Hu(A,{recursive:!0});let E=tp(n.input),M=R=>I({eventType:R.eventType,message:R.message??null,payload:R.eventType==="chat.session"?{host:On(),runtime:$,runtimeVersion:D.detection.version,...R.payload??{}}:R.payload??{}}),P=vs(r.workspaceRoot,C,$),q;try{q=await D.run({bin:D.detection.bin,input:E,onEvent:M,resumeSessionId:P,signal:i.signal,workspace:A})}catch(R){if(!P||i.signal.aborted)throw R;r.log(`Resume of ${$} session failed (${R instanceof Error?R.message:"unknown"}); retrying fresh.`),ks(r.workspaceRoot,C,$),q=await D.run({bin:D.detection.bin,input:E,onEvent:M,resumeSessionId:null,signal:i.signal,workspace:A})}Is(r.workspaceRoot,C,$,q.sessionId),I({eventType:"chat.session",payload:{host:On(),runtime:$,runtimeVersion:D.detection.version,sessionId:q.sessionId,sessionPath:q.sessionPath}}),await Yr(h,u),await zr(n.runId,o,{modelId:q.modelId,runtime:$,runtimeVersion:D.detection.version,sessionId:q.sessionId,sessionPath:q.sessionPath,text:q.text,usage:q.usage??{}}),r.log(`Chat turn ${n.runId} (${$}) completed.`);return}await Pn(n.runId,o,`This runner does not support ${n.jobType} jobs. Update the desktop app / CLI.`,!1)}catch($){let D=$ instanceof Error?$.message:"Local runner job crashed.";r.log(`Job ${n.runId} failed: ${D}`),await Yr(h,u).catch(()=>{}),await Pn(n.runId,o,D).catch(()=>{})}finally{clearInterval(v),clearInterval(c),r.signal?.removeEventListener("abort",s)}}function tp(t){let e=Array.isArray(t.messages)?t.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 t.effort=="string"?t.effort:null,messages:e,modelId:typeof t.modelId=="string"?t.modelId:null,system:typeof t.system=="string"?t.system:null,thinking:typeof t.thinking=="string"?t.thinking:null}}async function Yr(t,e){for(;e.length>0;)await t(),e.length>0&&await new Promise(n=>setTimeout(n,25))}function np(t,e){return t<=0||e?.aborted?Promise.resolve():new Promise(n=>{let r=setTimeout(o,t);function o(){clearTimeout(r),e?.removeEventListener("abort",o),n()}e?.addEventListener("abort",o,{once:!0})})}function ap(){return op(rp(),`.${p.commands[0]}-runner`,"runs")}var Dn=new ip("runner").description("Run agent work locally with your own Claude Code / Codex login (desktop lane)");Dn.command("status").description("Check local Claude Code / Codex detection and account auth").action(async()=>{let[t,e]=await Promise.all([Tn(),An()]);if(console.log(t?pe.green(`\u2713 Claude Code ${t.version}`):pe.red("\u2717 Claude Code not found on PATH")),console.log(e?pe.green(`\u2713 Codex ${e.version} (${e.bin})`):pe.red("\u2717 Codex not found (PATH or Codex.app)")),!xe()){console.log(pe.red(`\u2717 Not logged in. Run '${p.commands[0]} login' first.`)),process.exitCode=2;return}try{let n=await we();console.log(pe.green(`\u2713 Logged in as ${n.user.email}`))}catch(n){console.log(pe.red(`\u2717 Auth check failed: ${n instanceof Error?n.message:"unknown"}`)),process.exitCode=2}});Dn.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 t=>{xe()||(console.error(pe.red(`Not authenticated. Run '${p.commands[0]} login' first.`)),process.exit(2));let e=new AbortController,n=()=>{console.log(pe.gray(`
60
- Stopping runner\u2026`)),e.abort()};process.on("SIGINT",n),process.on("SIGTERM",n);try{await xs({claudeBin:t.claudeBin,codexBin:t.codexBin,log:r=>console.log(pe.gray(`[runner] ${r}`)),once:t.once,signal:e.signal,version:"0.3.23",workspaceRoot:t.workspace??ap()})}catch(r){console.error(pe.red(r instanceof Error?r.message:String(r))),process.exit(1)}});import Z from"chalk";import{Command as Mv}from"commander";import{Command as Qr}from"commander";function sp(t,e){return[...e,t]}var dp=new Qr("create").description("Start durable ad-set generation").argument("<title>","Ad-set title").requiredOption("--brief <brief>","Campaign brief").option("--hook <text>","Opening hook (repeat)",sp,[]).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)}}),cp=new Qr("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 k("createAdSet",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Cs=new Qr("ad-set").description("Generate a set of ad creatives (hooks, copy, visuals) from a campaign brief").addCommand(dp).addCommand(cp);import{randomUUID as $s}from"crypto";import{readFileSync as Ts}from"fs";import{readFile as gp}from"fs/promises";import{Command as ge}from"commander";import{randomUUID as lp}from"crypto";function Re(t,e){a(t instanceof Error?t.message:e),process.exit(t instanceof O?t.exitCode:d.GENERAL_ERROR)}function Bt(t){return`cli:agent-management:${t}:${lp()}`}function st(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 Gt}from"commander";var mp=new Gt("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:st(t.pageSize,"--page-size"),teamId:t.teamId}))}catch(e){Re(e,"Could not list the Agent roster")}}),up=new Gt("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){Re(n,"Could not read the roster Agent")}}),Rs=new Gt("roster").description("Discover Agents shared inside the current workspace; never cross-workspace").addCommand(mp).addCommand(up),pp=new Gt("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()||Bt("visibility")))}catch(r){Re(r,"Could not change Agent visibility")}}),Ss=new Gt("visibility").description("Control whether an owned Agent is private or team-visible").addCommand(pp);function dt(t,e){return[...e,t]}function fp(t){let e=Number(t);if(!Number.isInteger(e)||e<1)throw new Error("Expected a positive integer.");return e}async function Nn(t,e){let n=e.trim(),r=n.startsWith("{")?n:await gp(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 hp=new ge("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",fp).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 As("Agent activation failed",()=>m("createAgent",{approvalReceipt:e.approvalReceipt,draftId:t,expectedVersion:e.expectedVersion,teamId:e.teamId},e.idempotencyKey))}),yp=new ge("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)",dt,[]).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)",dt,[]).option("--output-config <json-or-path>","Full output slot configuration (repeatable)",dt,[]).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 As("Agent recommendation failed",async()=>m("recommendAgent",{deliveryAdapter:e.deliveryAdapter,deliveryConfig:e.deliveryConfig?await Nn("--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=>Nn("--output-config",n))):void 0,rationale:e.rationale,reviewPolicy:e.reviewPolicy,runtime:e.runtime?await Nn("--runtime",e.runtime):void 0,sandboxBlueprintId:e.sandboxBlueprintId,schedule:e.schedule,scheduleConfig:e.scheduleConfig?await Nn("--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??$s()))});async function As(t,e){try{l(await e())}catch(n){if(n instanceof O){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 bp(t,e){return t==="none"?null:st(t,e)}function wp(t){return t==="none"?null:t}function Ke(t,e){let n;try{n=Ts(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 vp(t,e){try{return Ts(t,"utf8")}catch(n){throw new Error(`${e} could not read ${t}: ${n instanceof Error?n.message:"unknown file error"}`)}}var Ip=new ge("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:st(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){Re(e,"Could not list Agents")}}),kp=new ge("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){Re(n,"Could not read the Agent")}}),xp=new ge("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?Ke(e.filesFile,"--files-file"):void 0,agentId:t,delivery:e.deliveryFile?Ke(e.deliveryFile,"--delivery-file"):void 0,description:e.description,expectedVersion:st(e.expectedVersion,"--expected-version"),goal:e.goal,instructionsMarkdown:e.instructionsFile?vp(e.instructionsFile,"--instructions-file"):void 0,name:e.name,output:e.outputFile?Ke(e.outputFile,"--output-file"):void 0,outputs:e.outputsFile?Ke(e.outputsFile,"--outputs-file"):void 0,perRunCreditCap:e.perRunCreditCap===void 0?void 0:bp(e.perRunCreditCap,"--per-run-credit-cap"),reviewPolicy:e.reviewPolicy,runtime:e.runtimeFile?Ke(e.runtimeFile,"--runtime-file"):void 0,sandboxBlueprintId:e.sandboxBlueprintId===void 0?void 0:wp(e.sandboxBlueprintId),schedule:e.scheduleFile?Ke(e.scheduleFile,"--schedule-file"):void 0,sources:e.sourcesFile?Ke(e.sourcesFile,"--sources-file"):void 0,teamId:e.teamId},Bt("configure")))}catch(n){Re(n,"Could not update the Agent")}});function Es(t){return new ge(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},Bt(t)))}catch(r){Re(r,`Could not ${t} the Agent schedule`)}})}function Zr(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}function Ps(t){return`cli:agent-memory:${t}:${$s()}`}function Cp(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 Rp=new ge("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){Zr(n,"Could not read the agent's memory")}}),Sp=new ge("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)",dt,[]).option("--always <text>","Standing instruction to add (repeatable)",dt,[]).option("--never <text>","Thing it must not do, to add (repeatable)",dt,[]).option("--track <name=note>","Entity to track, as name=note (repeatable)",Cp,[]).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},Ps(n?"remove":"add")))}catch(r){Zr(r,"Could not update the agent's memory")}}),Ep=new ge("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},Ps("forget")))}catch(n){Zr(n,"Could not erase the agent's memory")}}),$p=new ge("memory").description("Read, edit, and erase what a scheduled agent remembers").addCommand(Rp).addCommand(Sp).addCommand(Ep),Os=new ge("agent").description("Recommend, activate, configure, and manage scheduled Agents").addCommand(Ip).addCommand(kp).addCommand(Rs).addCommand(Ss).addCommand(xp).addCommand(Es("pause")).addCommand(Es("resume")).addCommand(hp).addCommand(yp).addCommand($p);import{randomUUID as Tp}from"crypto";import{password as Ap}from"@inquirer/prompts";import{Command as _n}from"commander";function eo(t){if(t==="claude-code"||t==="codex")return t;throw new Error("--runtime must be claude-code or codex")}function Pp(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 Op(){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 Dp=new _n("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=eo(t.runtime),n=Pp(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 Op():(await Ap({mask:"*",message:"Provider API key:"})).trim();if(!r)throw new Error("Provider API key is required");let o=await Gi({apiKey:r,...t.baseUrl?{baseUrl:t.baseUrl}:{},label:t.label,makeDefault:t.use??!1,modelId:t.model,provider:n,runtime:e});x(`Saved connection profile ${o.label} (${o.id})`)}catch(e){a(e instanceof Error?e.message:"Profile enrollment failed"),process.exit(d.GENERAL_ERROR)}}),Np=new _n("list").description("List secret-free Claude Code or Codex connection profiles").requiredOption("--runtime <runtime>","claude-code or codex").action(async t=>{try{let e=eo(t.runtime);l(await m("listAiConnectionProfiles",{runtime:e}))}catch(e){a(e instanceof Error?e.message:"Profile list failed"),process.exit(d.GENERAL_ERROR)}}),_p=new _n("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=eo(t.runtime),n=await m("selectAiConnectionProfile",{profileId:t.profileId,runtime:e},Tp());x(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)}}),Ds=new _n("ai-connections").description("Manage Claude Code and Codex inference routes").addCommand(Dp).addCommand(Np).addCommand(_p);import{randomUUID as Us}from"crypto";import{existsSync as qp}from"fs";import{resolve as jp}from"path";import Wt from"chalk";import{Command as Se}from"commander";import Vp from"ora";import{mkdir as Up,writeFile as Ns}from"fs/promises";import{dirname as Lp}from"path";async function te(t,e){if(await Up(Lp(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 Ns(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 Ns(e,r)}var Mp=15e3,Fp=40,_s=3;async function Ls(t,e){if(t?.length){if(t.length>_s)throw new Error(`A presenter Look accepts at most ${_s} reference images`);return Promise.all(t.map(async(n,r)=>{if(qp(n))return{url:(await be(jp(n),{idempotencyKey:`${e}:reference:${r+1}`})).url};let o;try{o=new URL(n)}catch(i){throw new Error(`Reference image ${r+1} must be an existing local file or an HTTP(S) URL.`,{cause:i})}if(o.protocol!=="http:"&&o.protocol!=="https:")throw new Error(`Reference image ${r+1} must use an HTTP(S) URL.`);return{url:o.toString()}}))}}function to(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&&x(`Video URL: ${t.videoUrl}`),t.error&&a(`Error: ${t.error}`)}var Bp=new Se("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 ya(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)}}),Gp=new Se("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"?Vp("Generating presenter clip...").start():null;try{let o=t.audioUrl?{audioUrl:t.audioUrl}:{script:t.script??"",...t.voiceId?{voiceId:t.voiceId}:{}},i=await ba({...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(),to(i,t.format);return}let s=await de(()=>Vr(i.requestId),Fp,Mp);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(),to(s,t.format),t.format==="human"&&x(`Saved to: ${t.output}`)}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Wp=new Se("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{to(await Vr(t),e.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Kp=new Se("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??Us(),r=await Ls(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)}}),Jp=new Se("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 k("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)}}),zp=new Se("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??Us(),r=await Ls(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)}}),Hp=new Se("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 k("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)}}),Xp=new Se("look").description("Manage looks under an existing personal presenter").addCommand(Kp).addCommand(zp).addCommand(Hp).addCommand(Jp),no=new Se("avatar").description("Generate presenter clips and looks; avatar options lists the voices and looks used by presentation video presenter and cast preset").addCommand(Bp).addCommand(Gp).addCommand(Xp).addCommand(Wp);no.addHelpText("after",`
61
- ${Wt.bold("Examples:")}
62
- ${Wt.gray("# Discover the presenter avatars and voices you can use")}
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")}
63
64
  $ ${p.commands[0]} avatar options
64
65
 
65
- ${Wt.bold("See also:")}
66
- ${Wt.gray("# Save a presenter + backdrop + voice combination under a name")}
66
+ ${ot.bold("See also:")}
67
+ ${ot.gray("# Save a presenter + backdrop + voice combination under a name")}
67
68
  $ ${p.commands[0]} cast preset --help
68
69
 
69
- ${Wt.gray("# Apply an avatar, look, or preset to one presentation-video scene")}
70
+ ${ot.gray("# Apply an avatar, look, or preset to one presentation-video scene")}
70
71
  $ ${p.commands[0]} presentation video presenter <project-id>
71
- `);import{randomUUID as Ch}from"crypto";import{writeFile as Rh}from"fs/promises";import F from"chalk";import{Command as ft,InvalidArgumentError as qd}from"commander";import Sh from"ora";import{createHash as pg}from"crypto";import{Command as Ht,InvalidArgumentError as zt}from"commander";import{createHash as ng}from"crypto";import{existsSync as rg,readFileSync as og}from"fs";import{basename as ig}from"path";import{Command as ag,InvalidArgumentError as Kt}from"commander";import sg from"ora";import{createHash as Yp}from"crypto";import{Command as Qp,InvalidArgumentError as qs}from"commander";var Zp=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function eg(t){if(!Zp.test(t))throw new qs("brand-id expects a UUID from `mf branding list`.");return t}function tg(t){let e=Number(t);if(!Number.isInteger(e)||e<1)throw new qs("--file-size expects the exact positive whole-number byte size.");return e}async function oo(t){let{idempotencyKey:e,...n}=t;return m("createBrandAssetUploadUrl",n,e)}function ro(t){if(t===void 0)return"";if(t===null||typeof t!="object")return JSON.stringify(t);if(Array.isArray(t))return`[${t.map(ro).join(",")}]`;let e=t;return`{${Object.keys(e).filter(n=>e[n]!==void 0).sort().map(n=>`${JSON.stringify(n)}:${ro(e[n])}`).join(",")}}`}function io(t){return Yp("sha256").update(`createBrandAssetUploadUrl:${ro(t)}`).digest("hex").slice(0,32)}var js=new Qp("upload-url").description("Mint a short-lived brand-scoped storage POST; this does not upload bytes").argument("<brand-id>","Brand UUID you may manage",eg).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",tg).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 oo({brandId:t,...e,idempotencyKey:e.idempotencyKey??io({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 dg=["footage","image","before_after","logo","audio"],cg=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function lg(t){if(!cg.test(t))throw new Kt("brand-id expects a UUID from `mf branding list`.");return t}function Vs(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<0)throw new Kt(`${t} expects a whole number of 0 or more.`);return n}}function mg(t){let e=Number(t);if(!Number.isFinite(e)||e<0)throw new Kt("--duration-sec expects a number of 0 or more.");return e}function ug(t){let e;try{e=JSON.parse(t)}catch{throw new Kt("--metadata expects valid JSON.")}if(!e||typeof e!="object"||Array.isArray(e))throw new Kt("--metadata expects a JSON object.");return e}var Ms=new ag("upload").description("Upload one local file, register it on a brand, and print the asset JSON").argument("<brand-id>","Brand UUID",lg).requiredOption("--file <path>","Local file to upload through Mindframes storage").requiredOption("--kind <kind>","Asset kind: footage | image | before_after | logo | audio",b("--kind",dg)).option("--label <text>","Display label; defaults to the local filename").option("--width <px>","Image or video width in pixels",Vs("--width")).option("--height <px>","Image or video height in pixels",Vs("--height")).option("--duration-sec <n>","Audio or video duration in seconds",mg).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"}',ug).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(),rg(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=ng("sha256").update(og(e.file)).digest("hex"),r=qt(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??io(o),s=sg({text:`Uploading ${ig(e.file)}...`,stream:process.stderr}).start();try{let c=await oo({brandId:t,...r,idempotencyKey:i,teamId:e.teamId}),u=await jt(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:u.type,role:e.role,s3Key:u.s3Key,setKey:e.setKey,sizeBytes:u.size,teamId:e.teamId,url:u.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 Fs=["footage","image","before_after","logo","audio"],gg=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function ct(t){return e=>{if(!gg.test(e))throw new zt(`${t} expects a UUID from \`mf branding list\` or \`mf branding asset list\`.`);return e}}function Jt(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 fg(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 hg(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 ao(t){return pg("sha256").update(t).digest("hex").slice(0,32)}function Un(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var yg=new Ht("list").description("List one brand's uploaded assets and print stable asset IDs").argument("<brand-id>","Brand UUID",ct("brand-id")).option("--kind <kind>","Filter: footage | image | before_after | logo | audio",b("--kind",Fs)).option("--limit <count>","Caller-selected page size; omit to return every matching asset",Jt("--limit",1)).option("--offset <count>","Matching assets to skip before returning results (default: 0)",Jt("--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){Un(n,"Asset list failed")}}),bg=new Ht("register").description("Register one app-owned upload from its exact URL, key, MIME, and metadata").argument("<brand-id>","Brand UUID",ct("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",Fs)).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",Jt("--size-bytes",0)).option("--width <px>","Image or video width in pixels",Jt("--width",0)).option("--height <px>","Image or video height in pixels",Jt("--height",0)).option("--duration-sec <n>","Audio or video duration in seconds",fg("--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"}',hg).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??ao(`registerBrandAsset:${JSON.stringify(n)}`);try{l(await m("registerBrandAsset",n,r))}catch(o){Un(o,"Asset registration failed")}}),wg=new Ht("rename").description("Rename one asset, then print its stored label and metadata").argument("<asset-id>","Asset UUID from `mf branding asset list`",ct("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",ct("--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??ao(`renameBrandAsset:${t}:${n}`)))}catch(r){Un(r,"Asset rename failed")}}),vg=new Ht("delete").description("Remove one asset record from the brand while keeping its uploaded file").argument("<asset-id>","Asset UUID from `mf branding asset list`",ct("asset-id")).requiredOption("--brand <brand-id>","Owning brand UUID",ct("--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??ao(`deleteBrandAsset:${t}`)))}catch(n){Un(n,"Asset deletion failed")}}),Bs=new Ht("asset").description("List, upload, rename, and remove a brand's private asset library").addCommand(yg).addCommand(bg).addCommand(js).addCommand(Ms).addCommand(wg).addCommand(vg);import{createHash as Ig}from"crypto";import{Command as Gs}from"commander";var kg=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function xg(t){kg.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Cg(t){return Ig("sha256").update(t).digest("hex").slice(0,32)}function Ws(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 Rg(t,e){let n=Ws(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 Sg(t,e){let n=Ws(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 Eg=new Gs("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(),xg(t);let n={brandId:t,gradients:Rg("--gradients",e.gradients),teamId:e.teamId};e.roles!==void 0&&(n.gradientRoles=Sg("--roles",e.roles));try{l(await m("setBrandGradients",n,Cg(`setBrandGradients:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(d.GENERAL_ERROR)}}),Ks=new Gs("gradient").description("Brand gradient library commands").addCommand(Eg);import{createHash as $g}from"crypto";import{Command as Je,InvalidArgumentError as Js}from"commander";var Tg=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Ln(t){if(!Tg.test(t))throw new Js("Expected a brand UUID from `mf branding list`.");return t}function Ag(t){if(t==="true")return!0;if(t==="false")return!1;throw new Js("--show expects true or false.")}function so(t,e){return $g("sha256").update(JSON.stringify([t,e])).digest("hex").slice(0,32)}function qn(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Pg=new Je("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(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){qn(i,"Custom colour update failed")}}),Og=new Je("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(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){qn(o,"Custom colour removal failed")}}),zs=new Je("foundation").description("Manage atomic Foundation settings backed by the brand DAG").addCommand(new Je("color").description("Manage custom colour roles").addCommand(Pg).addCommand(Og)),Dg=new Je("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(t,e)=>{await y();try{l(await m("getBrandFooter",{brandId:t,teamId:e.teamId}))}catch(n){qn(n,"Footer read failed")}}),Ng=new Je("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",Ag).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){qn(r,"Footer update failed")}}),Hs=new Je("footer").description("Read or update the brand footer").addCommand(Dg).addCommand(Ng);import{createHash as _g}from"crypto";import{Command as ze}from"commander";var Ug=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Xt(t){Ug.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Lg(t,e=[]){return[...e,t]}function lo(t){return _g("sha256").update(t).digest("hex").slice(0,32)}function co(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 Xs(t,e){try{return JSON.parse(e)}catch{a(`${t} must be valid JSON.`),process.exit(d.INVALID_INPUT)}}var qg=new ze("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(),Xt(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)}}),jg=new ze("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(),Xt(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)}}),Vg=new ze("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(),Xt(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:Xs("--require",e.require),severity:e.severity,teamId:e.teamId};e.conditions!==void 0&&(n.conditions=Xs("--conditions",e.conditions)),e.enabled!==void 0&&(n.enabled=co("--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=co("--publish",e.publish));try{l(await m("setBrandGuardrail",n,lo(`setBrandGuardrail:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(d.GENERAL_ERROR)}}),Mg=new ze("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(),Xt(t);let r={brandId:t,nodeKey:e,teamId:n.teamId};n.publish!==void 0&&(r.publish=co("--publish",n.publish));try{l(await m("deleteBrandGuardrail",r,lo(`deleteBrandGuardrail:${t}:${e}`)))}catch(o){a(o instanceof Error?o.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),Fg=new ze("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.",Lg).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(),Xt(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,lo(`generateBrandGuardrails:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await Aa(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(d.GENERAL_ERROR)}}),Bg=new ze("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 k("generateBrandGuardrails",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Ys=new ze("guardrails").description("Brand guardrail rule commands").addCommand(qg).addCommand(jg).addCommand(Vg).addCommand(Mg).addCommand(Fg).addCommand(Bg);import{createHash as Gg}from"crypto";import{Command as Pe}from"commander";var Wg=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Oe(t){Wg.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function lt(t){return Gg("sha256").update(t).digest("hex").slice(0,32)}var Qs=new Pe("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&&Oe(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)}}),Zs=new Pe("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(),Oe(t);let n=!e.off;try{l(await m("setBrandStar",{brandId:t,starred:n,teamId:e.teamId},lt(`setBrandStar:${t}:${n}`)))}catch(r){a(r instanceof Error?r.message:"Star failed"),process.exit(d.GENERAL_ERROR)}});async function Kg(t,e){let n=await m("getBrandProfile",{brandId:t,teamId:e.teamId});return typeof n.name=="string"?n.name:t}var ed=new Pe("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(),Oe(t),!e.yes&&process.stdin.isTTY){let n;try{n=await Kg(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},lt(`deleteBrand:${t}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),mo="none",td=new Pe("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 "${mo}" to detach it`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Oe(t);let n=e.parent?.toLowerCase()===mo;e.parent!==void 0&&!n&&Oe(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 ${mo} 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,lt(`updateBrand:${t}:${e.name??""}:${e.parent??""}`)))}catch(o){a(o instanceof Error?o.message:"Update failed"),process.exit(d.GENERAL_ERROR)}}),nd=new Pe("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(),Oe(t);try{l(await m("setDefaultBrand",{brandId:t,teamId:e.teamId},lt(`setDefaultBrand:${t}`)))}catch(n){a(n instanceof Error?n.message:"Set default failed"),process.exit(d.GENERAL_ERROR)}}),rd=new Pe("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(),Oe(t);try{let n=await Y(e.teamId);l(await m("approveBrand",{brandId:t,teamId:n},lt(`approveBrand:${n}:${t}`)))}catch(n){a(n instanceof Error?n.message:"Approve failed"),process.exit(d.GENERAL_ERROR)}}),od=new Pe("onboarding").description("Manage the brand onboarding review state").addCommand(new Pe("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(),Oe(t);try{let n=await Y(e.teamId);l(await m("completeBrandOnboarding",{brandId:t,teamId:n},lt(`completeBrandOnboarding:${n}:${t}`)))}catch(n){a(n instanceof Error?n.message:"Complete onboarding failed"),process.exit(d.GENERAL_ERROR)}}));import{createHash as uo}from"crypto";import{existsSync as Jg,readFileSync as zg}from"fs";import{basename as Hg}from"path";import{Command as jn}from"commander";import Xg from"ora";function Yg(t,e,n){return uo("sha256").update(JSON.stringify([t,e,n??null])).digest("hex").slice(0,32)}var id=new jn("logo").description("Upload primary, dark-background, and favicon logo files").addCommand(new jn("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 jn("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??Yg("removeBrandLogo",t,e)))}catch(r){a(r instanceof Error?r.message:"Logo removal failed"),process.exit(d.GENERAL_ERROR)}})).addCommand(new jn("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)),Jg(e.file)||(a(`File not found: ${e.file}`),process.exit(d.INVALID_INPUT));let r=uo("sha256").update(zg(e.file)).digest("hex"),o=e.idempotencyKey??uo("sha256").update(`setBrandLogo:${e.teamId??"current"}:${t??"default"}:${n}:${r}`).digest("hex").slice(0,32),i=Xg({text:`Uploading ${Hg(e.file)}...`,stream:process.stderr}).start(),s;try{s=(await be(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 Qg,randomUUID as Zg}from"crypto";import{Command as mt,InvalidArgumentError as Vn}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,tf=["admin","editor","viewer"],ad=["cancelled","completed","failed","info","queued","running"],sd=["activity","brand-extraction-request","brand-resolution","brand-sync-job"];function He(t){return e=>{if(!ef.test(e))throw new Vn(`${t} expects a UUID from \`mf branding list\` or the workspace member list.`);return e}}function cd(t){let e=Number(t);if(!Number.isInteger(e)||e<1||e>200)throw new Vn("--limit expects a whole number from 1 to 200.");return e}function dd(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 Vn(`${t} expects comma-separated values from: ${e.join(", ")}.`);return r}}function ld(t,e){return Qg("sha256").update(JSON.stringify([t,e,Zg()])).digest("hex").slice(0,32)}function Yt(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 nf=new mt("list").description("List explicit member access overrides for one team brand").argument("<brand-id>","Team brand UUID",He("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){Yt(n,"Brand permission list failed")}}),rf=new mt("candidates").description("List member IDs eligible for one team brand's access overrides").argument("<brand-id>","Team brand UUID",He("brand-id")).option("--query <text>","Search member name, username, or email").option("--limit <count>","Maximum members, 1-200 (default: 50)",cd).option("--offset <count>","Members to skip (default: 0)",t=>{let e=Number(t);if(!Number.isInteger(e)||e<0)throw new Vn("--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){Yt(n,"Brand permission candidate list failed")}}),of=new mt("set").description("Set one team member's explicit role for a team brand").argument("<brand-id>","Team brand UUID",He("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",He("--user")).requiredOption("--role <role>","Desired override: admin | editor | viewer",b("--role",tf)).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??ld("setBrandPermission",{brandId:t,role:e.role,teamId:e.teamId??null,userId:e.user})))}catch(n){Yt(n,"Brand permission update failed")}}),af=new mt("remove").description("Remove one member override so the team role applies again").argument("<brand-id>","Team brand UUID",He("brand-id")).requiredOption("--user <user-id>","Target workspace member UUID",He("--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??ld("removeBrandPermission",{brandId:t,teamId:e.teamId??null,userId:e.user})))}catch(n){Yt(n,"Brand permission removal failed")}}),md=new mt("permission").description("Administer explicit member access overrides for a team brand").addCommand(rf).addCommand(nf).addCommand(of).addCommand(af),ud=new mt("activity").description("Read a brand's filtered, cursor-paginated activity feed").argument("<brand-id>","Brand UUID",He("brand-id")).option("--query <text>","Search action, summary, detail, entity, and metadata").option("--status <statuses>",`Comma-separated statuses: ${ad.join(" | ")}`,dd("--status",ad)).option("--source-type <types>",`Comma-separated sources: ${sd.join(" | ")}`,dd("--source-type",sd)).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)",cd).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){Yt(n,"Brand activity read failed")}});import{createHash as sf}from"crypto";import{Command as ut,InvalidArgumentError as go}from"commander";var df=/^[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(df.test(t))return t;throw new go(`${e} must be a UUID.`)}function cf(t){let e=Number(t);if(Number.isInteger(e)&&e>=1&&e<=50)return e;throw new go("limit must be a whole number from 1 to 50.")}function lf(t){let e=Number(t);if(Number.isInteger(e)&&e>=0)return e;throw new go("offset must be a whole number of 0 or more.")}function mf(t){return sf("sha256").update(t).digest("hex").slice(0,32)}async function Mn(t,e){await y();try{l(await t())}catch(n){a(n instanceof Error?n.message:e),process.exit(d.GENERAL_ERROR)}}var pd=new ut("presentations").description("Inspect presentations already linked to a brand").addCommand(new ut("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)",cf,50).option("--offset <n>","Zero-based offset (default 0)",lf,0).option("--team-id <id>","Workspace UUID; defaults to the selected workspace").action(async(t,e)=>{let n=po(t,"brand-id");await Mn(()=>m("listBrandPresentations",{brandId:n,limit:e.limit,offset:e.offset,teamId:e.teamId}),"Could not list linked presentations")})),gd=new ut("presentation").description("Inspect or update one deck from its already-linked brand").addCommand(new ut("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 Mn(()=>m("getPresentationBrandDrift",{presentationId:t,teamId:e.teamId}),"Could not read presentation brand drift")})).addCommand(new ut("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 Mn(()=>m("applyPresentationBrandChanges",{presentationId:t,teamId:e.teamId},e.idempotencyKey),"Could not apply linked-brand changes")})),fd=new ut("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 Mn(()=>m("cancelBrandPresentationSync",{brandId:r,runId:o,teamId:n.teamId},mf(`cancelBrandPresentationSync:${r}:${o}`)),"Could not cancel brand sync")});import{createHash as uf}from"crypto";import{Command as pt}from"commander";var pf=/^[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"],Fn=["candidate","draft","approved"],yd=["brand-site","brand-site-scan","brand-site-extract","product-url"];function Gn(t){pf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Bn(t,e,n){if(n.includes(e))return e;a(`${t} must be one of: ${n.join(", ")}.`),process.exit(d.INVALID_INPUT)}function gf(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 fo(t){return uf("sha256").update(t).digest("hex").slice(0,32)}var ff=new pt("list").description("List the products a brand sells").argument("<brand-id>","Brand profile ID").option("--status <status>",`Only products in this state. One of: ${Fn.join(", ")}. Omit for the saved catalogue.`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),Gn(t),e.status!==void 0&&Bn("--status",e.status,Fn);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)}}),hf=new pt("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: ${Fn.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(),Gn(t),e.type!==void 0&&Bn("--type",e.type,hd),e.status!==void 0&&Bn("--status",e.status,Fn),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,fo(`saveBrandProduct:${t}:${e.product??e.url??e.name??"new"}`)))}catch(r){a(r instanceof Error?r.message:"Save failed"),process.exit(d.GENERAL_ERROR)}}),yf=new pt("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(),Gn(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},fo(`deleteBrandProduct:${t}:${e.product}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),bf=new pt("extract").description("Discover a brand's products by crawling its site").argument("<brand-id>","Brand profile ID").option("--mode <mode>",`One of: ${yd.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(),Gn(t),e.mode!==void 0&&Bn("--mode",e.mode,yd);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=gf("--max-products",e.maxProducts)),e.product?.length&&(n.productIds=e.product);try{let r=await m("extractBrandProducts",n,fo(`extractBrandProducts:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await $a(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Extract failed"),process.exit(d.GENERAL_ERROR)}}),wf=new pt("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 k("extractBrandProducts",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),bd=new pt("product").description("Brand product catalogue commands").addCommand(ff).addCommand(hf).addCommand(yf).addCommand(bf).addCommand(wf);import{createHash as vf}from"crypto";import{Command as Wn}from"commander";var If=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function wd(t){If.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function kf(t,e=[]){return[...e,t]}function xf(t){return vf("sha256").update(t).digest("hex").slice(0,32)}var Cf=new Wn("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(),wd(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)}}),Rf=new Wn("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.",kf).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(),wd(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,xf(`repairBrandQuality:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await Pa(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Repair failed"),process.exit(d.GENERAL_ERROR)}}),Sf=new Wn("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 k("repairBrandQuality",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),vd=new Wn("quality").description("Brand deck quality commands").addCommand(Cf).addCommand(Rf).addCommand(Sf);function ho(t){return Array.isArray(t.items)}function Ee(t){return typeof t=="string"&&t.length>0?t:void 0}function yo(t){return Ee(t.resolvedTokens?.logoUrl)??Ee(t.brandData?.assets?.logo)??Ee(t.brandData?.assets?.logoUrl)??Ee(t.brandData?.logoUrl)}function bo(t){return Ee(t.resolvedTokens?.colors?.primary)??Ee(t.brandData?.colors?.primary)??Ee(t.brandData?.enhancedColors?.palette?.[0]?.hex)}function Id(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 Ef(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 $f(t){let e=Ee(t.extractedFrom)??Ee(t.normalizedUrl),n=yo(t),r=bo(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 kd(t){return ho(t)?t.items.map($f):t.brandings.map(Ef)}import{createHash as Tf}from"crypto";import{Command as Ne,InvalidArgumentError as Af}from"commander";var Pf=["x","instagram","facebook","linkedin","tiktok","youtube"],Of=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function De(t){if(!Of.test(t))throw new Af("Expected a UUID returned by the corresponding list command.");return t}function Kn(t,e){return Tf("sha256").update(JSON.stringify([t,...e])).digest("hex")}function gt(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Df=new Ne("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",De).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){gt(e,"Competitor list failed")}}),Nf=new Ne("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",De).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,Kn("addCompetitor",[e.brandingId??"default",t.trim(),e.website??null,e.xHandle??null,e.xAvatarUrl??null,e.resolveHandle])))}catch(r){gt(r,"Competitor write failed")}}),_f=new Ne("delete").description("Remove one competitor by the stable ID from competitor list").argument("<competitor-id>","Competitor UUID",De).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",De).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},Kn("deleteBrandCompetitor",[e.brandingId??"default",t])))}catch(n){gt(n,"Competitor removal failed")}}),xd=new Ne("competitor").description("List, add, update, or remove a brand's competitor watch rows").addCommand(Df).addCommand(Nf).addCommand(_f),Uf=new Ne("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",De).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){gt(e,"Social-account list failed")}}),Lf=new Ne("add").description("Record one social account and print its stable saved row").argument("<platform>","Social network: x | instagram | facebook | linkedin | tiktok | youtube",b("platform",Pf)).argument("<handle>","Account handle on that social network").option("--branding-id <id>","Brand UUID; defaults to the workspace brand",De).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},Kn("addBrandSocialHandle",[n.brandingId??"default",t,e.replace(/^@/,"")])))}catch(r){gt(r,"Social-account write failed")}}),qf=new Ne("delete").description("Remove one social account by the stable ID from social list").argument("<handle-id>","Social-handle UUID",De).option("--branding-id <id>","Owning brand UUID; defaults to the workspace brand",De).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},Kn("deleteBrandSocialHandle",[e.brandingId??"default",t])))}catch(n){gt(n,"Social-account removal failed")}}),Cd=new Ne("social").description("List, record, or remove the social accounts owned by a brand").addCommand(Uf).addCommand(Lf).addCommand(qf);import{createHash as jf}from"crypto";import{Command as Rd}from"commander";var Vf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Mf(t){Vf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Ff(t){return jf("sha256").update(t).digest("hex").slice(0,32)}var Sd=new Rd("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(),Mf(t);let n={brandId:t,teamId:e.teamId};try{let r=await m("syncBrandToPresentations",n,Ff(`syncBrandToPresentations:${t}`));if(e.wait===!1){l(r);return}l(await Oa(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Sync failed"),process.exit(d.GENERAL_ERROR)}}),Ed=new Rd("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 k("syncBrandToPresentations",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});import{readFile as Bf}from"fs/promises";import{randomUUID as Gf}from"crypto";import{Command as $d}from"commander";var Wf=["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 Kf(t){let e=t.split(".").filter(Boolean);for(let n=e.length;n>=2;n--){let r=e.slice(0,n).join(".");if(Wf.includes(r))return{fieldPath:e.slice(n),nodeKey:r}}return{fieldPath:e.slice(2),nodeKey:e.slice(0,2).join(".")}}function Jf(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:u}=Kf(o),f=zf(i);if(c.length===0){e[u]=f;continue}let h=e[u],v=h&&typeof h=="object"&&!Array.isArray(h)?h:{},I=v;for(let $ of c.slice(0,-1)){let D=I[$],C=D&&typeof D=="object"&&!Array.isArray(D)?D:{};I[$]=C,I=C}I[c[c.length-1]]=f,e[u]=v}return e}function zf(t){return t==="true"?!0:t==="false"?!1:/^-?\d+(?:\.\d+)?$/.test(t)?Number(t):t}function Hf(t,e){return t===void 0?{assignments:[...e]}:t.includes("=")?{assignments:[t,...e]}:{assignments:[...e],brandId:t}}var Td=new $d("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)}}),Ad=new $d("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}=Hf(t,e),i;try{i=r.length>0?Jf(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 Bf(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},Gf()))}catch(c){a(c instanceof Error?c.message:"Write failed"),process.exit(d.GENERAL_ERROR)}});import{createHash as Xf}from"crypto";import{Command as Hn}from"commander";var Yf=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,zn=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function vo(t){Yf.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Pd(t){return Xf("sha256").update(t).digest("hex").slice(0,32)}function Od(t){if(zn.includes(t))return t;a(`"${t}" is not a channel. Pass one of: ${zn.join(", ")}.`),process.exit(d.INVALID_INPUT)}function Jn(t){return t===""?null:t}function wo(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 Qf(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 Zf(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 eh=new Hn("list").description("List a brand's per-channel design variants").argument("<brand-id>","Brand profile ID").option("--channel <key>",`One of: ${zn.join(", ")}`).option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),vo(t),e.channel!==void 0&&Od(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)}}),th=new Hn("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: ${zn.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(),vo(t),e.channel!==void 0&&Od(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=Qf("--default",e.default)),e.colors!==void 0&&(n.colors=wo("--colors",e.colors)),e.logoTreatment!==void 0&&(n.logoTreatment=wo("--logo-treatment",e.logoTreatment)),e.backgroundGradient!==void 0&&(n.backgroundGradient=wo("--background-gradient",e.backgroundGradient)),e.aspect!==void 0&&(n.aspect=Jn(e.aspect)),e.maxSeconds!==void 0&&(n.maxSeconds=Zf(e.maxSeconds)),e.voiceTone!==void 0&&(n.voiceOverride=e.voiceTone===""?null:{tone:e.voiceTone}),e.openingStyle!==void 0&&(n.openingStyle=Jn(e.openingStyle)),e.logoPosition!==void 0&&(n.logoPosition=Jn(e.logoPosition)),e.constraints!==void 0&&(n.constraints=Jn(e.constraints));try{l(await m("setBrandVariant",n,e.variant===void 0?void 0:Pd(`setBrandVariant:${t}:${e.variant}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Set failed"),process.exit(d.GENERAL_ERROR)}}),nh=new Hn("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(),vo(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},Pd(`deleteBrandVariant:${t}:${e.variant}`)))}catch(n){a(n instanceof Error?n.message:"Delete failed"),process.exit(d.GENERAL_ERROR)}}),Dd=new Hn("variant").description("Per-channel brand design variant commands").addCommand(eh).addCommand(th).addCommand(nh);import{createHash as rh}from"crypto";import{Command as ko}from"commander";var oh=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Io=["deck-16-9","reel-9-16","story-9-16","walkthrough-16-9"];function ih(t){oh.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function ah(t){if(Io.includes(t))return t;a(`"${t}" is not a channel. Pass one of: ${Io.join(", ")}.`),process.exit(d.INVALID_INPUT)}function sh(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 dh(t){return rh("sha256").update(t).digest("hex").slice(0,32)}var ch=new ko("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: ${Io.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&&ih(t),e.channel!==void 0&&ah(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=sh("--colors",e.colors));try{let r=await m("generateBrandVariations",n,dh(`generateBrandVariations:${t??"preview"}:${e.channel??"deck-16-9"}`));if(e.wait===!1){l(r);return}l(await Ea(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Generate failed"),process.exit(d.GENERAL_ERROR)}}),lh=new ko("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 k("generateBrandVariations",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Nd=new ko("variations").description("Generated brand design variations").addCommand(ch).addCommand(lh);import{createHash as mh}from"crypto";import{Command as Xn}from"commander";var xo=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function Co(t){xo.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function uh(t,e){if(e==="head"||xo.test(e))return e;a(`${t} must be a version id or "head".`),process.exit(d.INVALID_INPUT)}function ph(t,e){if(xo.test(e))return e;a(`${t} must be a version id from \`branding version list\`.`),process.exit(d.INVALID_INPUT)}function gh(t){return mh("sha256").update(t).digest("hex").slice(0,32)}var fh=new Xn("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(),Co(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)}}),hh=new Xn("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(),Co(t);let n={brandId:t,teamId:e.teamId};e.from!==void 0&&(n.from=ph("--from",e.from)),e.to!==void 0&&(n.to=uh("--to",e.to));try{l(await m("diffBrandVersions",n))}catch(r){a(r instanceof Error?r.message:"Diff failed"),process.exit(d.GENERAL_ERROR)}}),yh=new Xn("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(),Co(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,gh(`publishBrandVersion:${t}:${e.label??"auto"}`)))}catch(r){a(r instanceof Error?r.message:"Publish failed"),process.exit(d.GENERAL_ERROR)}}),_d=new Xn("version").description("Brand version history commands").addCommand(fh).addCommand(hh).addCommand(yh);import{createHash as bh}from"crypto";import{Command as Qt}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;function So(t){wh.test(t)||(a(`"${t}" is not a brand id. Pass the UUID from \`branding list\`.`),process.exit(d.INVALID_INPUT))}function Ro(t,e=[]){return[...e,t]}function Ud(t){return bh("sha256").update(t).digest("hex").slice(0,32)}var vh=new Qt("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(),So(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)}}),Ih=new Qt("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(),So(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,Ud(`setBrandVoice:${t}:${JSON.stringify(n)}`)))}catch(r){a(r instanceof Error?r.message:"Write failed"),process.exit(d.GENERAL_ERROR)}}),kh=new Qt("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",Ro).option("--text <text>","Pasted source material; repeat for several",Ro).option("--file <name:source>","Document to read, as name:source; repeat for several",Ro).option("--no-wait","Return the run id immediately instead of waiting").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await y(),So(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,Ud(`buildBrandVoice:${JSON.stringify(n)}`));if(e.wait===!1){l(r);return}l(await Ta(r.runId,e.teamId))}catch(r){a(r instanceof Error?r.message:"Build failed"),process.exit(d.GENERAL_ERROR)}}),xh=new Qt("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 k("buildBrandVoice",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Ld=new Qt("voice").description("Brand voice and context commands").addCommand(vh).addCommand(Ih).addCommand(kh).addCommand(xh);function Eh(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<0)throw new qd(`${t} expects a whole number of 0 or more.`);return n}}function $h(t){return e=>{let n=Number(e);if(!Number.isInteger(n)||n<1)throw new qd(`${t} expects a whole number of 1+.`);return n}}var Th=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Ah=50;function Ph(t){let e=t.extractedFrom??t.normalizedUrl??null,n=bo(t),r=Id(t),o=yo(t);if(me("Brand Profile"),console.log(),S("ID",t.id),S("Name",t.name),S("Source URL",e??F.gray("None")),S("Default",t.isDefault?F.green("Yes"):"No"),t.createdAt&&S("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 u=t.brandData?.confidence,f=t.brandData?.extractionMethod;(typeof u=="number"||typeof f=="string")&&(console.log(F.bold(" Extraction")),typeof u=="number"&&console.log(` Confidence: ${Math.round(u*100)}%`),typeof f=="string"&&console.log(` Method: ${f}`),console.log()),console.log(F.gray(" Use --format json for full details")),console.log()}var jd=new ft("branding").description("Read and manage workspace brands, design rules, assets, permissions, and social presence").addCommand(Td).addCommand(Ad).addCommand(Bs).addCommand(md).addCommand(ud).addCommand(new ft("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)",$h("--limit")).option("--offset <n>","Brands to skip before the page",Eh("--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=kd(n);if(r.length===0){w("No brand profiles found"),console.log(),console.log(F.gray(`Create one with: ${p.commands[0]} branding extract <url>`));return}console.log(Ai(r));let o=t.offset??0;ho(n)?n.hasMore&&console.log(F.gray(` ${o+r.length} of ${n.total}. Next page: --offset ${o+r.length}`)):r.length>=(t.limit??Ah)&&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 ft("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(),!Th.test(t)){a(`"${t}" 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(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 Rh(e.output,JSON.stringify(r,null,2)),x(`Brand profile saved to ${e.output}`);return}if(e.format==="json"){console.log(JSON.stringify(r,null,2));return}Ph(r)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(n.exitCode??1)}})).addCommand(new ft("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: ${p.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: ${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 ft("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("--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??Ch(),i=Sh({text:`Extracting branding from ${n}...`,stream:process.stdout}).start(),s;try{let c=await ra(n,r,e.approvalReceipt,e.skipExistingLookup,o);if(c.status==="needs_choice"){i.stop(),w(`This workspace already has ${c.matches.length} related brand${c.matches.length===1?"":"s"} for ${n}. Nothing was extracted and nothing was charged.`),console.log();for(let u of c.matches)console.log(` ${F.bold(u.name??"Untitled")}`),console.log(` ${F.gray(u.id)}`),u.extractedFrom&&console.log(` ${F.gray(u.extractedFrom)}`);console.log(),w(`Use one of the above, or re-run with --skip-existing-lookup to extract ${n} anyway.`),s=d.INVALID_INPUT}else i.succeed("Brand extraction started"),console.log(JSON.stringify(c,null,2)),w(`Check progress with: ${p.commands[0]} branding status ${c.runId}`),console.log()}catch(c){let u=c instanceof Error?c.message:String(c);u.includes("approval")&&(i.stop(),a(u),console.log(),w(`Retry with the receipt and the same key: --approval-receipt <receipt> --idempotency-key ${o}`),process.exit(d.INVALID_INPUT)),i.fail("Extraction failed"),a(u),process.exit(c.exitCode??1)}s!==void 0&&process.exit(s)})).addCommand(new ft("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 k("extractBranding",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}})).addCommand(Qs).addCommand(td).addCommand(Zs).addCommand(nd).addCommand(rd).addCommand(od).addCommand(ed).addCommand(xd).addCommand(id).addCommand(zs).addCommand(Hs).addCommand(Ks).addCommand(bd).addCommand(Dd).addCommand(Nd).addCommand(_d).addCommand(Ld).addCommand(Ys).addCommand(vd).addCommand(pd).addCommand(gd).addCommand(Sd).addCommand(Ed).addCommand(fd).addCommand(Cd);import Zt from"chalk";import{Command as ht}from"commander";function Oh(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 Vd(t,e){return{background:Oh(e),name:t,presenterProfileId:e.presenter,...e.voiceId?{voiceId:e.voiceId}:{}}}function Yn(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.id);return}x(`${t.name} (${t.id})`),w(` Presenter: ${t.presenterProfileId}`),w(` Backdrop: ${Dh(t.background)}`),t.voiceId&&w(` Voice: ${t.voiceId}`)}function Dh(t){switch(t.kind){case"color":return`color ${t.hex}`;case"image":return`image ${t.url} (${t.fit})`;default:return t.kind}}function Md(t){return t.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("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human")}var Nh=new ht("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 Da({...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)Yn(n,"human")}catch(e){a(e instanceof Error?e.message:String(e)),process.exit(d.API_ERROR)}}),_h=Md(new ht("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 Na({castMemberId:e.castMemberId,...Vd(t,e)});Yn(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),Uh=Md(new ht("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 _a({presetId:t,...Vd(e.name,e)});Yn(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),Lh=new ht("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 Ua(t);if(e.format==="human"){x(`Retired "${n.preset.name}".`);return}Yn(n.preset,e.format)}catch(n){a(n instanceof Error?n.message:String(n)),process.exit(d.API_ERROR)}}),qh=new ht("preset").description("Saved ways a cast member appears").addCommand(Nh).addCommand(_h).addCommand(Uh).addCommand(Lh),Eo=new ht("cast").description("The faces and voices your videos can use").addCommand(qh);Eo.addHelpText("after",`
73
- ${Zt.bold("Examples:")}
74
- ${Zt.gray("# List the saved presenter/backdrop/voice combinations")}
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")}
75
76
  $ ${p.commands[0]} cast preset list
76
77
 
77
- ${Zt.bold("See also:")}
78
- ${Zt.gray("# The presenter avatars, looks, and voices a preset is built from")}
78
+ ${gn.bold("See also:")}
79
+ ${gn.gray("# The presenter avatars, looks, and voices a preset is built from")}
79
80
  $ ${p.commands[0]} avatar options
80
81
 
81
- ${Zt.gray("# Use a preset on one presentation-video scene")}
82
+ ${gn.gray("# Use a preset on one presentation-video scene")}
82
83
  $ ${p.commands[0]} presentation video presenter <project-id>
83
- `);import{readFile as jh}from"fs/promises";import en from"chalk";import{Command as Fd}from"commander";var Vh=new Fd("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("--mime-type <type>","Source MIME type").option("--max-length <count>","Maximum output characters","30000").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=t,r;t.includes("://")||(n=await jh(t,"utf8"),r=t);let o=await m("extractContent",{filename:r,maxLength:Number.parseInt(e.maxLength,10),mimeType:e.mimeType,source:n,teamId:e.teamId});e.format!=="quiet"&&l(o)}catch(n){a(n instanceof Error?n.message:"Extraction failed"),process.exit(d.GENERAL_ERROR)}}),$o=new Fd("content").description("Extract normalized text from a URL, a local file, or an encoded document").addCommand(Vh);$o.addHelpText("after",`
84
- ${en.bold("Examples:")}
85
- ${en.gray("# Normalized text from a local document")}
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")}
86
100
  $ ${p.commands[0]} content extract ./paper.pdf
87
101
 
88
- ${en.bold("See also:")}
89
- ${en.gray("# Web pages, with page metadata and cost reporting")}
102
+ ${fn.bold("See also:")}
103
+ ${fn.gray("# Web pages, with page metadata and cost reporting")}
90
104
  $ ${p.commands[0]} scrape https://example.com/post
91
105
 
92
- ${en.gray("# Spoken words out of audio or video")}
106
+ ${fn.gray("# Spoken words out of audio or video")}
93
107
  $ ${p.commands[0]} transcript --help
94
- `);import Q from"chalk";import{Command as Mh}from"commander";import{existsSync as Fh,readFileSync as Bh}from"fs";import Gh,{resolve as Bd}from"path";var Gd=new Mh("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("-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("--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)",b("--format",["human","json","quiet"])).option("-o, --output <format>","Output format (human, json, quiet) \u2014 short form of --format",b("--output",["human","json","quiet"])).option("--no-stream","Wait for completion without streaming progress").option("--wait","Poll until generation completes").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(t,e)=>{e.output=e.format??e.output,await y();let n;e.slides!==void 0&&(n=parseInt(e.slides,10),(Number.isNaN(n)||n<1||n>20)&&(a("Slide count must be between 1 and 20"),process.exit(6)));let r=["best","balanced","fast","ultrafast","instant","image-min","image","image-max"];e.mode&&!r.includes(e.mode)&&(a(`Invalid mode: ${e.mode}. Valid: ${r.join(", ")}`),process.exit(6));let o=["smart","fast","balanced","best"];e.imageTier&&!o.includes(e.imageTier)&&(a(`Invalid image tier: ${e.imageTier}. Valid: ${o.join(", ")}`),process.exit(6));let i=["creative","professional","educational","formal","casual"];e.tone&&!i.includes(e.tone)&&(a(`Invalid tone: ${e.tone}. Valid: ${i.join(", ")}`),process.exit(6));let s=["minimal","concise","detailed","extensive"];e.amount&&!s.includes(e.amount)&&(a(`Invalid amount: ${e.amount}. Valid: ${s.join(", ")}`),process.exit(6));let c=["freeform","brand-only","brand-plus-style","style-only","no-styling"];e.styling&&!c.includes(e.styling)&&(a(`Invalid styling: ${e.styling}. Valid: ${c.join(", ")}`),process.exit(6));let u=["quick","moderate","deep","profound"];e.thinkingDepth&&!u.includes(e.thinkingDepth)&&(a(`Invalid thinking-depth: ${e.thinkingDepth}. Valid: ${u.join(", ")}`),process.exit(6));let f=["inform","persuade","train","learn","entertain","report"];e.goal&&!f.includes(e.goal)&&(a(`Invalid goal: ${e.goal}. Valid: ${f.join(", ")}`),process.exit(6));let h=["blue","violet","rose","orange","green"];e.theme&&!h.includes(e.theme)&&(a(`Invalid theme: ${e.theme}. Valid: ${h.join(", ")}`),process.exit(6));let v=["none","waves-bottom-left","waves-top-right","blob-corners","minimal"];e.decorations&&!v.includes(e.decorations)&&(a(`Invalid decorations: ${e.decorations}. Valid: ${v.join(", ")}`),process.exit(6));let I=e.theme||e.primaryColor||e.secondaryColor||e.accentColor||e.backgroundColor||e.foregroundColor||e.decorations;I&&e.mode&&e.mode!=="instant"&&(a("--theme, --primary-color, --decorations and other color options are only supported with --mode instant"),process.exit(6));let $=e.mode??(I?"instant":"fast"),D=/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;for(let[R,K]of[["primary-color",e.primaryColor],["secondary-color",e.secondaryColor],["accent-color",e.accentColor],["background-color",e.backgroundColor],["foreground-color",e.foregroundColor]])K&&!D.test(K)&&(a(`Invalid ${R}: ${K}. Must be hex (e.g., #0066CC)`),process.exit(6));try{e.output!=="json"&&e.output!=="quiet"&&process.stdout.write(Q.gray("Checking generation limits... "));let R=await aa($,n??10,e.teamId);if(e.output!=="json"&&e.output!=="quiet"){console.log(Q.green("\u2713"));let K=R.remaining[$],ie=R.limits[$],Me=K===void 0||ie===void 0?"":` | ${$}: ${K}/${ie} remaining`;console.log(Q.gray(` Plan: ${R.planName}${Me}`))}}catch(R){e.output==="json"?console.log(JSON.stringify({success:!1,error:R instanceof Error?R.message:String(R)})):(console.log(Q.red("\u2717")),a(R instanceof Error?R.message:String(R))),process.exit(R.exitCode??1)}let C=[];if(e.file&&e.file.length>0){for(let R of e.file)Fh(Bd(R))||(a(`File not found: ${R}`),process.exit(6));e.output!=="json"&&e.output!=="quiet"&&console.log(Q.gray(`
95
- Uploading ${e.file.length} file(s)...`));try{C=await Ki(e.file.map(R=>Bd(R)),(R,K,ie)=>{e.output!=="json"&&e.output!=="quiet"&&ie&&process.stdout.write(`\r ${Q.cyan("\u2B06")} Uploading: ${ie} (${R+1}/${K})`)}),e.output!=="json"&&e.output!=="quiet"&&console.log(`\r ${Q.green("\u2713")} Uploaded ${C.length} file(s) `)}catch(R){a(`Failed to upload files: ${R instanceof Error?R.message:String(R)}`),process.exit(1)}}let A;(e.stdin||!process.stdin.isTTY)&&(A=await Wh(),e.stdin&&!A&&(a("No content received from stdin"),process.exit(6)));let E=e.context;if(e.contextFile)try{E=Bh(e.contextFile,"utf-8"),E.trim()||(a(`Context file is empty: ${e.contextFile}`),process.exit(6))}catch{a(`Failed to read context file: ${e.contextFile}`),process.exit(6)}!A&&!E&&C.length===0&&(a("Context is required to create a presentation."),console.log(),console.log(Q.gray(" -f, --file <paths...> Upload files (PDF, PPTX, images)")),console.log(Q.gray(" -c, --context <text> Inline text context")),console.log(Q.gray(" --context-file <path> Read from a file")),console.log(Q.gray(` cat file | ${p.commands[0]} Pipe content`)),process.exit(6));let M=[...C];A&&M.push({id:`stdin-${Date.now()}`,content:A,title:"Piped Content",mime:"text/plain",selected:!0}),E&&M.push({id:`context-${Date.now()}`,content:E,title:"Context",mime:"text/plain",selected:!0});let P,q=e.primaryColor||e.secondaryColor||e.accentColor||e.backgroundColor||e.foregroundColor;(e.theme||q||e.decorations)&&(P={},e.theme&&(P.preset=e.theme),q&&(P.custom={},e.primaryColor&&(P.custom.primary=e.primaryColor),e.secondaryColor&&(P.custom.secondary=e.secondaryColor),e.accentColor&&(P.custom.accent=e.accentColor),e.backgroundColor&&(P.custom.background=e.backgroundColor),e.foregroundColor&&(P.custom.foreground=e.foregroundColor)),e.decorations&&(P.decorations=e.decorations));try{let R=await Ji({topic:t,...n!==void 0&&{slideCount:n},mode:$,...e.imageTier&&{imageTier:e.imageTier},...e.tone&&{tone:e.tone},...e.amount&&{amount:e.amount},...e.audience&&{audience:e.audience},...e.language&&{language:e.language},...e.brandingId&&{brandingId:e.brandingId},...e.brandDomain&&{brandDomain:e.brandDomain},...e.template&&{templateId:e.template},...e.styling&&{stylingMode:e.styling},...e.referenceUrl&&{referenceUrl:e.referenceUrl},...e.thinkingDepth&&{thinkingDepth:e.thinkingDepth},...e.goal&&{goal:e.goal},...e.teamId&&{teamId:e.teamId},...P&&{theme:P},...e.studio?{documentId:Gh.basename(process.cwd())}:e.id?{documentId:e.id}:{},...M.length>0&&{contentSources:{uploadedFiles:M,contextFiles:[]}}});if(!e.wait){e.output==="json"?console.log(JSON.stringify({success:!0,run:R},null,2)):e.output!=="quiet"&&(x("Presentation generation queued"),S("Run ID",R.runId),S("Status",R.status),console.log(Q.gray(` Check later with presentation status ${R.runId}`)));return}let K=await k("createSlides",R.runId,e.teamId);for(;!K.done;)e.output!=="json"&&e.output!=="quiet"&&console.log(Q.gray(` ${K.message}`)),await new Promise(Me=>setTimeout(Me,(K.nextPollAfterSeconds??5)*1e3)),K=await k("createSlides",R.runId,e.teamId);if(K.error)throw new Error(se(K.error));let ie=K.entity?await rt(K.entity.id):void 0;if(e.output==="json")console.log(JSON.stringify({success:!0,presentation:ie,run:K,viewUrl:ie?nt(ie.slug,e.language??"en"):void 0},null,2));else{console.log(),x("Presentation created successfully"),console.log(),S("Title",ie?.title??t),S("Slides",String(ie?.numberOfSlides??n??"\u2014")),console.log();let Me=ie?nt(ie.slug,e.language??"en"):"N/A";Me!=="N/A"&&(console.log(Q.bold(" Open: ")+Q.cyan.underline(Me)),e.open&&await(await import("open")).default(Me)),console.log()}}catch(R){e.output==="json"?console.log(JSON.stringify({success:!1,error:R instanceof Error?R.message:String(R)})):a(R instanceof Error?R.message:String(R)),process.exit(R.exitCode??1)}});async function Wh(){return new Promise(t=>{let e="";if(process.stdin.setEncoding("utf8"),process.stdin.isTTY){t("");return}process.stdin.on("data",n=>{e+=n}),process.stdin.on("end",()=>{t(e.trim())}),setTimeout(()=>{t(e.trim())},100)})}import{randomUUID as Kh}from"crypto";import{readFile as Jh}from"fs/promises";import{Command as _e}from"commander";var To=["text/markdown","text/csv","text/plain"];async function Wd(t){let e=t.content;if(e!==void 0&&e!=="-"&&!e.startsWith("@"))return e;if(e?.startsWith("@"))return Jh(e.slice(1),"utf8");if(e==="-"||!process.stdin.isTTY)return zh();a("No document body. Pass --content <text>, --content @<path>, or pipe it on stdin."),process.exit(d.GENERAL_ERROR)}async function zh(){let t=[];for await(let e of process.stdin)t.push(Buffer.from(e));return Buffer.concat(t).toString("utf8")}function Qn(t){return`cli:document:${t}:${Kh()}`}function Xe(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}function Hh(t){if(!t)return;let e=t.split(".").pop()?.toLowerCase();if(e==="md"||e==="markdown")return"text/markdown";if(e==="csv")return"text/csv";if(e==="txt")return"text/plain"}var Xh=new _e("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 ${To.join(", ")}; inferred from an @<path> body when omitted`).option("--summary <text>","One line for the Library card").action(async(t,e)=>{try{let n=e.mediaType??Hh(e.content?.startsWith("@")?e.content.slice(1):void 0);n||(a(`Cannot tell what this document is. Pass --media-type (${To.join(", ")}).`),process.exit(d.GENERAL_ERROR)),l(await m("createDocument",{content:await Wd(e),mediaType:n,summary:e.summary,teamId:e.teamId,title:t},Qn("create")))}catch(n){Xe(n,"Could not save the document")}}),Yh=new _e("list").description("List the workspace's documents, newest first").option("--team-id <id>","Workspace ID").option("--media-type <type>",`Filter to one of ${To.join(", ")}`).option("--limit <n>","Maximum documents to return (default 50)").action(async t=>{try{l(await m("listDocuments",{limit:t.limit?Number(t.limit):void 0,mediaType:t.mediaType,teamId:t.teamId}))}catch(e){Xe(e,"Could not list documents")}}),Qh=new _e("read").description("Print a document's body").argument("<document-id>","Document id").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{let n=await m("readDocument",{documentId:t,teamId:e.teamId}),{document:r}=n;process.stderr.write(`${r.title} \xB7 ${r.mediaType} \xB7 v${r.version} \xB7 ${r.byteLength} bytes
96
- `),process.stdout.write(r.content)}catch(n){Xe(n,"Could not read the document")}}),Zh=new _e("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(t,e)=>{try{let n=e.content!==void 0;l(await m("updateDocument",{changeSummary:e.changeSummary,content:n?await Wd(e):void 0,documentId:t,expectedVersion:Number(e.expectedVersion),summary:e.summary,teamId:e.teamId,title:e.title},Qn("update")))}catch(n){Xe(n,"Could not update the document")}}),ey=new _e("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(t,e)=>{try{!e.yes&&process.stdin.isTTY&&(a("Refusing to delete without confirmation. Re-run with --yes to remove this document."),process.exit(d.GENERAL_ERROR)),l(await m("deleteDocument",{documentId:t,teamId:e.teamId},Qn("delete")))}catch(n){Xe(n,"Could not delete the document")}}),ty=new _e("versions").description("List a document's version history").argument("<document-id>","Document id").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await m("listDocumentVersions",{documentId:t,teamId:e.teamId}))}catch(n){Xe(n,"Could not list versions")}}),ny=new _e("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(t,e)=>{try{l(await m("restoreDocumentVersion",{documentId:t,expectedVersion:Number(e.expectedVersion),teamId:e.teamId,versionNumber:Number(e.versionNumber)},Qn("restore")))}catch(n){Xe(n,"Could not restore the version")}}),Kd=new _e("document").description("Create, read and edit Library documents").addCommand(Xh).addCommand(Yh).addCommand(Qh).addCommand(Zh).addCommand(ey).addCommand(ty).addCommand(ny);import tn from"chalk";import{Command as ry}from"commander";import{writeFile as oy}from"fs/promises";import{resolve as Jd}from"path";import iy from"ora";var ay=["html","pdf","pptx"],Ao=new ry("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",b("--format",ay),"html").option("--team-id <id>","Workspace ID (uses configured default)").action(async(t,e)=>{await y();let n=iy("Exporting presentation...").start();try{let 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 Zi(t,e.format,{teamId:r}),i=e.output?Jd(e.output):Jd(process.cwd(),o.fileName);n.text="Downloading...";let s=await ea(o.downloadUrl);await oy(i,Buffer.from(s)),n.succeed("Export complete!"),console.log(),w(`File saved: ${i}`),w(`Format: ${o.format}`),w(`Slides: ${o.slideCount}`),w(`Size: ${sy(s.byteLength)}`),console.log()}catch(r){n.fail("Export failed"),a(r instanceof Error?r.message:String(r)),process.exit(r.exitCode??1)}});function sy(t){return t<1024?`${t} B`:t<1024*1024?`${(t/1024).toFixed(1)} KB`:`${(t/(1024*1024)).toFixed(1)} MB`}Ao.addHelpText("after",`
97
- ${tn.bold("Examples:")}
98
- ${tn.gray("# Self-contained interactive HTML (default)")}
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)")}
99
113
  $ ${p.commands[0]} export <id-or-slug> -o deck.html
100
114
 
101
- ${tn.gray("# PDF or PowerPoint")}
115
+ ${hn.gray("# PDF or PowerPoint")}
102
116
  $ ${p.commands[0]} export <id-or-slug> -f pdf -o deck.pdf
103
117
  $ ${p.commands[0]} export <id-or-slug> -f pptx -o deck.pptx
104
118
 
105
- ${tn.bold("See also:")}
106
- ${tn.gray("# For an MP4 instead")}
119
+ ${hn.bold("See also:")}
120
+ ${hn.gray("# For an MP4 instead")}
107
121
  $ ${p.commands[0]} presentation video <id-or-slug>
108
- `);import{Command as fe}from"commander";var dy=new fe("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 t=>{await Ue("createFootageProject",{input:{musicAssetId:t.musicAssetId??null,outputs:nn(t.outputs,"outputs"),overlays:nn(t.overlays,"overlays"),ranges:nn(t.ranges,"ranges"),sourceAssetIds:t.source,sourceChatId:t.sourceChatId,strategy:nn(t.strategy,"strategy"),teamId:t.teamId,title:t.title},idempotencyKey:t.idempotencyKey})}),cy=new fe("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(t,e)=>{await Ue("getFootageProject",{input:{projectId:t,teamId:e.teamId,versionId:e.versionId}})}),ly=new fe("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(t,e)=>{await Ue("reviseFootageProject",{input:Xd({baseVersionId:e.baseVersionId,changeSummary:e.changeSummary,musicAssetId:e.musicAssetId==="null"?null:e.musicAssetId,outputs:Zn(e.outputs,"outputs"),overlays:Zn(e.overlays,"overlays"),projectId:t,ranges:Zn(e.ranges,"ranges"),strategy:Zn(e.strategy,"strategy"),teamId:e.teamId,title:e.title}),idempotencyKey:e.idempotencyKey})}),my=new fe("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(t,e,n)=>{await Ue("restoreFootageProjectVersion",{input:{changeSummary:n.changeSummary,projectId:t,teamId:n.teamId,versionId:e},idempotencyKey:n.idempotencyKey})}),uy=new fe("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(t,e,n)=>{await Ue("branchFootageProjectVersion",{input:{projectId:t,teamId:n.teamId,title:n.title,versionId:e},idempotencyKey:n.idempotencyKey})}),py=new fe("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(t,e,n)=>{await Ue("inspectFootageRange",{input:{projectId:t,rangeId:e,teamId:n.teamId,versionId:n.versionId},idempotencyKey:n.idempotencyKey})}),gy=new fe("inspection-status").description("Read a footage range inspection run").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await Hd("inspectFootageRange",t,e.teamId)}),fy=new fe("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").requiredOption("--approval-receipt <receipt>","Browser-issued approval receipt").requiredOption("--idempotency-key <key>","Key bound into the receipt").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await Ue("renderFootageProject",{input:Xd({approvalReceipt:e.approvalReceipt,outputIds:e.output,projectId:t,teamId:e.teamId,versionId:e.versionId}),idempotencyKey:e.idempotencyKey})}),hy=new fe("render-status").description("Read a Footage Studio render run").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await Hd("renderFootageProject",t,e.teamId)}),yy=new fe("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").option("--team-id <id>","Workspace ID").action(async(t,e)=>{await Ue("importFootageProviderTakes",{input:{invocationId:e.invocationId,projectId:t,teamId:e.teamId}})}),zd=new fe("footage").description("Create, inspect, revise, and render transcript-native footage edits").addCommand(dy).addCommand(cy).addCommand(ly).addCommand(my).addCommand(uy).addCommand(py).addCommand(gy).addCommand(fy).addCommand(hy).addCommand(yy);async function Ue(t,e){try{l(await m(t,e.input,e.idempotencyKey))}catch(n){a(n instanceof Error?n.message:"Footage operation failed"),process.exit(d.GENERAL_ERROR)}}async function Hd(t,e,n){try{l(await k(t,e,n))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}function nn(t,e){try{return JSON.parse(t)}catch{throw new Error(`${e} must be valid JSON.`)}}function Zn(t,e){return typeof t=="string"?nn(t,e):void 0}function Xd(t){return Object.fromEntries(Object.entries(t).filter(([,e])=>e!==void 0))}import{Command as by}from"commander";import Ye from"chalk";function wy(t){return new Set((t??"").split(",").map(e=>e.trim().toLowerCase()).filter(Boolean))}function vy(t){if(!t)throw new Error("Slides were requested but the server returned none. Retry, or read the deck in the browser.");me("Slides"),console.log();for(let e of t){console.log(Ye.bold(` ${e.number}. ${e.title||"Untitled"}`));let n=e.text?.trim();console.log(n?Yd(n):Ye.gray(" (no text on this slide \u2014 image or empty)"));let r=e.speakerNotes?.trim();r&&(console.log(Ye.gray(" Narration/notes:")),console.log(Ye.gray(Yd(r)))),console.log()}}function Yd(t){return t.split(`
109
- `).map(e=>` ${e}`).join(`
110
- `)}var Qd=new by("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"?wy(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 rt(t,{includeSlides:n,teamId:r});if(e.format==="json"){console.log(JSON.stringify(o,null,2));return}let i=nt(o.slug,e.language);me("Presentation Details"),console.log(),S("Slug",o.slug),S("Title",o.title||"Untitled"),S("Description",o.description||Ye.gray("None")),S("Slides",String(o.numberOfSlides||"-")),S("Mode",o.mode||"-"),S("Created",Tr(o.createdAt)),o.updatedAt&&S("Updated",Tr(o.updatedAt)),console.log(),i!=="N/A"&&console.log(Ye.bold(" Open: ")+Ye.cyan.underline(i)),console.log(),n&&vy(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{Command as tr}from"commander";import Iy from"ora";function ky(t){let e=t?.trim().toLowerCase();if(!(!e||e==="any"||e==="all"))return e==="web"||e==="stock"?[e]:void 0}function xy(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:ky(t.source),transparentBackground:e==="icon"}}}function Cy(t){let e=t.url||t.imageUrl;if(!e)throw new Error("Image search returned a result without a URL");return e}function Ry(t){return t.transparent??t.isTransparent??t.metadata?.transparent??t.metadata?.isTransparent}function Sy(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 Ey(t,e){let n=t.data.results.map(r=>r.results.map(o=>{let i=o,s=Ry(i);if(e==="icon"&&s!==!0)throw new Error("Icon search returned a result without a verified transparent background");return{...i,url:Cy(i),provider:r.providerName,assetType:e,...s!==void 0?{transparent:s}:{}}}));return Sy(n)}function $y(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 er(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function Ty(t){return{requestId:t.runId,status:$y(t),...t.entity?.url?{url:t.entity.url}:{},...t.error?{error:se(t.error)}:{},...er(t.output?.width)!==void 0?{width:er(t.output?.width)}:{},...er(t.output?.height)!==void 0?{height:er(t.output?.height)}:{}}}async function Zd(t,e){return Ty(await k("createImage",t,e))}function Po(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&&x(`Image URL: ${t.url}`),t.output&&x(`Saved to: ${t.output}`),t.error&&a(`Error: ${t.error}`)}var Ay=new tr("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"?Iy("Searching for images...").start():null,r;try{r=xy(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 ua(r);n?.stop(),o.success||(a("Search failed"),process.exit(d.GENERAL_ERROR));let i=r.options?.assetType??"image",s=Ey(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}x(`Found ${s.length} images for "${t.query}"`),console.log();for(let c=0;c<s.length;c++){let u=s[c];console.log(`[${c+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(d.GENERAL_ERROR)}}),Py=new tr("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("--width <pixels>","Width").option("--height <pixels>","Height").option("--team-id <id>","Workspace ID").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));try{let o=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,teamId:e.teamId,width:e.width?Number.parseInt(e.width,10):void 0});if(n=o.runId,!e.wait){Po({requestId:o.runId,status:"pending"},e.format);return}let i=await de(()=>Zd(o.runId,e.teamId),180,2e3);if(i.status==="failed")throw new Error(i.error||"Image generation failed");if(!i.url)throw new Error("Image generation completed without an image URL");let s=e.output?{...i,output:e.output}:i;e.output&&await te(i.url,e.output),Po(s,e.format)}catch(o){a(ue(o,n),e.format),process.exit(d.GENERAL_ERROR)}}),Oy=new tr("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 Zd(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}Po(n,e.format)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),ec=new tr("image").description("Image search and generation commands").addCommand(Ay).addCommand(Py).addCommand(Oy);import{Command as Oo}from"commander";var Dy=new Oo("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)}}),Ny=new Oo("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)}}),tc=new Oo("knowledge").description("Search the workspace Knowledge Hub and read bounded knowledge bundles").addCommand(Dy).addCommand(Ny);import{randomUUID as _y}from"crypto";import nr from"chalk";import{Command as $e}from"commander";function Do(t){if(t!==void 0)return t==="root"?null:t}function yt(t){return`cli:library:${t}:${_y()}`}function Qe(t,e){a(t instanceof Error?t.message:e),process.exit(d.GENERAL_ERROR)}var Uy=new $e("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){Qe(e,"Could not list folders")}}),Ly=new $e("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:Do(e.parent),teamId:e.teamId},yt("create")))}catch(n){Qe(n,"Could not create the folder")}}),qy=new $e("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},yt("rename")))}catch(r){Qe(r,"Could not rename the folder")}}),jy=new $e("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},yt("recolor")))}catch(n){Qe(n,"Could not recolour the folder")}}),Vy=new $e("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:Do(e.to),teamId:e.teamId},yt("move")))}catch(n){Qe(n,"Could not move the folder")}}),My=new $e("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},yt("delete")))}catch(n){Qe(n,"Could not delete the folder")}}),Fy=new $e("folders").description("Manage Library folders").addCommand(Uy).addCommand(Ly).addCommand(qy).addCommand(jy).addCommand(Vy).addCommand(My),By=new $e("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:Do(n.folder),kind:t,targetId:e,teamId:n.teamId},yt("file")))}catch(r){Qe(r,"Could not file that item")}}),No=new $e("library").description("Library folders and filing").addCommand(Fy).addCommand(By);No.addHelpText("after",`
111
- ${nr.bold("Examples:")}
112
- ${nr.gray("# Browse the folder tree and file an artifact into a folder")}
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")}
113
127
  $ ${p.commands[0]} library folders list
114
128
  $ ${p.commands[0]} library file presentation <id> --folder <folder-id>
115
129
 
116
- ${nr.bold("See also:")}
117
- ${nr.gray("# A different thing: reusable video clips, not Library folders")}
130
+ ${br.bold("See also:")}
131
+ ${br.gray("# A different thing: reusable video clips, not Library folders")}
118
132
  $ ${p.commands[0]} video library --help
119
- `);import{Command as rn}from"commander";function T(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 nc=new rn("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)}}),Gy=new rn("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=T(this,e);try{l(await k("analyzeMediaAsset",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});nc.addCommand(Gy);var rc=new rn("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)}}),Wy=new rn("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=T(this,e);try{l(await k("importConnectorRecording",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}});rc.addCommand(Wy);var oc=new rn("media").description("Ingest and transcribe recordings you already own").addCommand(nc).addCommand(rc);import{Command as _o}from"commander";var Ky=new _o("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)}}),Jy=new _o("status").description("Read microsite generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await k("createMicrosite",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),ic=new _o("microsite").description("Generate a shareable multi-section web microsite from a brief").addCommand(Ky).addCommand(Jy);import{Command as qo}from"commander";import Uo from"ora";function Lo(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&&x(`Output URL: ${t.outputUrl}`),t.error&&a(`Error: ${t.error}`)}var zy=new qo("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"?Uo("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 ma({operation:"add-to-video",inputs:i,options:{musicVolume:e,voiceVolume:n}});if(!t.wait){o?.stop(),Lo(s,r);return}o&&(o.text=`Processing (ID: ${s.requestId})...`);let c=await de(()=>qr(s.requestId),120,3e3);if(o?.stop(),c.status==="failed"&&(a(c.error||"Audio mixing failed"),process.exit(d.GENERAL_ERROR)),Lo(c,r),t.output){if(!c.outputUrl)throw new Error("Audio mix completed without an output URL");let u=r==="human"?Uo("Downloading...").start():null;await te(c.outputUrl,t.output),u?.stop(),r==="human"&&x(`Saved to: ${t.output}`)}}catch(s){o?.stop(),a(s instanceof Error?s.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Hy=new qo("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"?Uo("Checking status...").start():null;try{let r=await qr(t);n?.stop(),Lo(r,e.format)}catch(r){n?.stop(),a(r instanceof Error?r.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),ac=new qo("mix").description("Audio mixing commands").addCommand(zy).addCommand(Hy);import{Command as Vo}from"commander";import nb from"ora";import{readFileSync as Xy}from"fs";var sc=500,dc=1e4,rr=100,cc=1e4,lc=1e3,uc=["duration_s","idempotency_key","narration","schema_version","video_description"],Yy=["end_s","id","start_s","text","words"],Qy=["end","id","start","text"],Zy=["description","end_s","id","start_s"];function pc(t){let e=fc(t);if(hc(e),on(e,uc,""),e.duration_s<3)throw new Error("Music request duration_s must be between 3 and 600");return e}function gc(t){let e=fc(t);hc(e),on(e,[...uc,"visual_event"],"");let n=e.visual_event;if(!or(n))throw new Error("SFX request visual_event is required");if(on(n,Zy,"visual_event"),!Le(n.description))throw new Error("SFX request visual_event.description is required");if(!Le(n.id)||!qe(n.start_s))throw new Error("SFX request visual_event requires id and start_s");if(n.end_s!==void 0&&(!qe(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 fc(t){try{let e=JSON.parse(Xy(t,"utf8"));if(!or(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 hc(t){if(t.schema_version!==1)throw new Error("Audio request schema_version must be 1");if(!Le(t.video_description))throw new Error("Audio request video_description is required");if(!qe(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>sc)throw new Error(`Audio request narration holds at most ${sc} lines`);if(t.narration.forEach(eb),t.idempotency_key!==void 0&&!Le(t.idempotency_key))throw new Error("Audio request idempotency_key must be a non-empty string")}function eb(t,e){let n=`narration.${e}`;if(!or(t))throw new Error(`Audio request ${n} must be an object`);if(on(t,Yy,n),!Le(t.id)||t.id.length>rr)throw new Error(`Audio request ${n}.id is required (1-${rr} characters)`);if(!Le(t.text)||t.text.trim().length>cc)throw new Error(`Audio request ${n}.text is required (1-${cc} characters)`);if(mc(t.start_s,`${n}.start_s`),mc(t.end_s,`${n}.end_s`),qe(t.start_s)&&qe(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>dc)throw new Error(`Audio request ${n}.words must be an array of at most ${dc} entries`);t.words.forEach((r,o)=>{tb(r,`${n}.words.${o}`)})}}function tb(t,e){if(!or(t))throw new Error(`Audio request ${e} must be an object`);if(on(t,Qy,e),!Le(t.text)||t.text.trim().length>lc)throw new Error(`Audio request ${e}.text is required (1-${lc} characters)`);if(!qe(t.start)||!qe(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&&(!Le(t.id)||t.id.length>rr))throw new Error(`Audio request ${e}.id must be 1-${rr} characters`)}function mc(t,e){if(t!==void 0&&!qe(t))throw new Error(`Audio request ${e} must be a non-negative number`)}function on(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 or(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function Le(t){return typeof t=="string"&&t.trim().length>0}function qe(t){return typeof t=="number"&&Number.isFinite(t)&&t>=0}function jo(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&&x(`Audio URL: ${t.audioUrl}`),t.error&&a(`Error: ${t.error}`)}var rb=new Vo("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=pc(t.request)}catch(i){a(i instanceof Error?i.message:String(i)),process.exit(d.INVALID_INPUT)}let n=t.format,r=n==="human"?nb("Generating music for video...").start():null,o;try{let i=await la(e);if(o=i.requestId,!t.wait){r?.stop(),jo(i,n);return}r&&(r.text=`Processing (ID: ${i.requestId})...`);let s=i.status==="completed"||i.status==="failed"?i:await de(()=>Lr(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"&&x(`Saved to: ${t.output}`),s.output=t.output}jo(s,n)}catch(i){r?.stop(),a(ue(i,o),n),process.exit(d.GENERAL_ERROR)}}),ob=new Vo("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{jo(await Lr(t),e.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),yc=new Vo("music").description("Video-aware music generation commands").addCommand(rb).addCommand(ob);import{Command as Mo}from"commander";function bc(t,e){return[...e,t]}var ib=new Mo("create").description("Create a standalone poll").argument("<question>","Poll question").option("--option <text>","Choice (repeat 2-10 times)",bc,[]).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)}}),ab=new Mo("edit").description("Edit a standalone poll").argument("<poll-id>","Poll UUID").option("--question <question>","New question").option("--option <text>","Replacement choice (repeat)",bc).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)}}),wc=new Mo("poll").description("Standalone poll commands").addCommand(ib).addCommand(ab);import{randomUUID as dr}from"crypto";import{readFile as jb}from"fs/promises";import j from"chalk";import{Command as z}from"commander";import{createHash as sb}from"crypto";function Te(t){let e=sb("sha256").update(JSON.stringify({command:t.command,payload:Fo(t.payload),workspaceId:t.workspaceId})).digest("hex");return`cli:${t.command.trim().toLowerCase().replace(/[^a-z0-9._:-]+/g,"-").replace(/^-+|-+$/g,"")||"command"}:${e}`}function Fo(t){return Array.isArray(t)?t.map(Fo):!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,Fo(n)]))}import{randomUUID as Go}from"crypto";import{readFile as db}from"fs/promises";import{Command as ir}from"commander";var vc=new ir("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=T(this,e);await ar("Draft edit failed",async()=>m("editPresentationVideoDraft",{edit:await cb(n.edit),projectId:t,teamId:n.teamId},n.idempotencyKey??Go()))}),Ic=new ir("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",Bo(1)).option("--limit <number>","Maximum versions",Bo(1,100)).option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=T(this,e);await ar("Version list failed",()=>m("listPresentationVideoVersions",{beforeVersion:n.beforeVersion,limit:n.limit,projectId:t,teamId:n.teamId}))}),kc=new ir("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",Bo(1)).option("--team-id <id>","Workspace ID override").option("--idempotency-key <key>","Stable retry key").action(async function(t,e,n){let r=T(this,n);await ar("Version restore failed",()=>m("restorePresentationVideoVersion",{projectId:t,teamId:r.teamId,versionNumber:e},r.idempotencyKey??Go()))}),xc=new ir("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=T(this,e);await ar("Slide refresh failed",()=>m("refreshPresentationVideoSlides",{projectId:t,teamId:n.teamId},n.idempotencyKey??Go()))});async function cb(t){let e=t.trim(),n=e.startsWith("{")?e:await db(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 Bo(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 ar(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}import{createHash as lb}from"crypto";import{Command as bt,InvalidArgumentError as mb}from"commander";var Cc=new bt("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=T(this,e);await wt("Draft list failed",()=>m("listPresentationVideoProjects",{presentationId:t,teamId:n.teamId}))}),Rc=new bt("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=T(this,e);await wt("Freshness read failed",()=>m("getPresentationVideoFreshness",{projectId:t,teamId:n.teamId}))}),Sc=new bt("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",Ac(1)).option("--team-id <id>","Workspace ID override").action(async function(t,e,n){let r=T(this,n);await wt("Version read failed",()=>m("getPresentationVideoVersion",{projectId:t,teamId:r.teamId,versionNumber:e}))}),Ec=new bt("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",Ac(1)).option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=T(this,e);await wt("Render history failed",()=>m("listPresentationVideoRenders",{limit:n.limit,projectId:t,teamId:n.teamId}))}),$c=new bt("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=T(this,n);await wt("Render read failed",()=>m("getPresentationVideoRender",{projectId:t,renderId:e,teamId:r.teamId}))}),Tc=new bt("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=T(this,n);await wt("Render cancellation failed",()=>m("cancelPresentationVideoRender",{projectId:t,renderId:e,teamId:r.teamId},r.idempotencyKey??ub(t,e)))});function Ac(t,e=Number.MAX_SAFE_INTEGER){return n=>{let r=Number(n);if(!Number.isInteger(r)||r<t||r>e)throw new mb(`Expected an integer between ${t} and ${e}.`);return r}}function ub(t,e){return`presentation-video-cancel:${lb("sha256").update(`${t}\0${e}`).digest("hex")}`}async function wt(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}import{randomUUID as pb}from"crypto";import{Command as gb}from"commander";var fb=["basic","standard","premium"],Pc=new gb("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("--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(t,e,n){let r=T(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&&!fb.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:t,renderTier:r.renderTier,slideId:e,teamId:r.teamId},hb(r.idempotencyKey)))}catch(o){a(o instanceof Error?o.message:"Scene presenter update failed"),process.exit(d.GENERAL_ERROR)}});function hb(t){return t||pb()}import{createHash as yb}from"crypto";import{Command as an}from"commander";var bb=new an("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(t,e){let n=T(this,e);await sr("Preview preparation failed",async()=>{let r=await Y(n.teamId),o=await m("preparePresentationVideoPreviews",{projectId:t,teamId:r},n.idempotencyKey??Dc("prepare",t,r));return n.wait===!1?o:Sa(o.runId,r)})}).addHelpText("after",`
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",`
134
+ Examples:
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",`
120
148
  What happens:
121
149
  Reuses the draft's checkpointed preview run and prepares only missing deck-slide images.
122
150
  Card and reusable-video scenes report not_required. This command is free and does not render MP4.
@@ -125,19 +153,36 @@ Recovery:
125
153
  $ ${p.commands[0]} presentation video previews status <run-id>
126
154
  $ ${p.commands[0]} presentation video previews inspect <project-id>
127
155
  $ ${p.commands[0]} presentation video previews retry <project-id> # only after failed/cancelled
128
- `),wb=new an("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(t,e){let n=T(this,e);await sr("Preview status read failed",()=>m("getPresentationVideoPreviews",{projectId:t,teamId:n.teamId}))}).addHelpText("after",`
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",`
129
157
  Output:
130
158
  summary.status is idle, preparing, ready, failed, or not_required.
131
159
  scenes[] reports ready, missing, or not_required plus stored horizontalUrl/verticalUrl.
132
160
  run contains the durable run ID, phase, progress, status, and typed public error.
133
- `),vb=new an("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(t,e){let n=T(this,e);await sr("Preview retry failed",async()=>{let r=await Y(n.teamId);return m("retryPresentationVideoPreviews",{projectId:t,teamId:r},n.idempotencyKey??Dc("retry",t,r))})}).addHelpText("after",`
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",`
134
162
  Rules:
135
163
  Only failed or cancelled preview runs can be retried. Active and completed runs are refused.
136
164
  Retry resumes unfinished scenes; it does not rebuild images already stored on the draft.
137
165
 
138
166
  Next:
139
167
  $ ${p.commands[0]} presentation video previews inspect <project-id>
140
- `),Ib=new an("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(t,e){let n=T(this,e);await sr("Preview run status failed",()=>k("preparePresentationVideoPreviews",t,n.teamId))}),Oc=new an("previews").description("Prepare, inspect, or retry the slide images used by presentation-to-MP4").addCommand(bb).addCommand(wb).addCommand(vb).addCommand(Ib);function Dc(t,e,n){return`presentation-video-previews:${t}:${yb("sha256").update(`${n}\0${e}`).digest("hex")}`}async function sr(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}import{Command as Wo}from"commander";var Nc=new Wo("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(t,e){let n=T(this,e);try{l(await m("getPresentationVideoProject",{projectId:t,teamId:n.teamId}))}catch(r){a(r instanceof Error?r.message:"Project read failed"),process.exit(d.GENERAL_ERROR)}}),kb=new Wo("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",xb).option("--query <text>","Filter clips by title").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=T(this,e);try{l(await m("listReusableVideoClips",{cursor:n.cursor,limit:n.limit,projectId:t,query:n.query,teamId:n.teamId}))}catch(r){a(r instanceof Error?r.message:"Clip list failed"),process.exit(d.GENERAL_ERROR)}}),_c=new Wo("library").description("Reusable generated clips and uploaded recordings").addCommand(kb);function xb(t){let e=Number(t);if(!Number.isInteger(e)||e<1||e>100)throw new Error("--limit must be an integer between 1 and 100.");return e}import{Command as Eb}from"commander";import{readFile as Cb}from"fs/promises";import{InvalidArgumentError as Uc}from"commander";async function Rb(t){let e=t.trim(),n=e.startsWith("{")?e:await Cb(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}async function Lc(t){let e=t.settings?await Rb(t.settings):{},n=[t.captionHeight,t.captionWidth,t.captionX,t.captionY].some(i=>i!==void 0),r=[t.captionBackgroundColor,t.captionFontFamily,t.captionFontSize,t.captionHighlightColor,t.captionTextColor].some(i=>i!==void 0),o=[t.presenterAnchor,t.presenterApplyToAll,t.presenterBackground,t.presenterBackgroundFit,t.presenterBackgroundHex,t.presenterBackgroundUrl,t.presenterBorderRadius,t.presenterFramingX,t.presenterFramingY,t.presenterFramingZoom,t.presenterHeight,t.presenterOffsetX,t.presenterOffsetY,t.presenterSize,t.presenterUseDefault,t.presenterVisible,t.presenterX,t.presenterY].some(i=>i!==void 0);if(n&&e.captionPlacement!==void 0)throw new Error("Pass caption placement either as typed flags or inside --settings, not both.");if(r&&e.captionStyle!==void 0)throw new Error("Pass caption style either as typed flags or inside --settings, not both.");if(o&&e.presenter!==void 0)throw new Error("Pass presenter layout either as typed flags or as settings.presenter, not both.");return Sb({captionBackgroundColor:t.captionBackgroundColor,captionFontFamily:t.captionFontFamily,captionFontSize:t.captionFontSize,captionHeight:t.captionHeight,captionHighlightColor:t.captionHighlightColor,captionTextColor:t.captionTextColor,captionWidth:t.captionWidth,captionX:t.captionX,captionY:t.captionY,presenterAnchor:t.presenterAnchor,presenterApplyToAll:t.presenterApplyToAll||void 0,presenterBackgroundFit:t.presenterBackgroundFit,presenterBackgroundHex:t.presenterBackgroundHex,presenterBackgroundKind:t.presenterBackground,presenterBackgroundUrl:t.presenterBackgroundUrl,presenterBorderRadius:t.presenterBorderRadius,presenterFramingX:t.presenterFramingX,presenterFramingY:t.presenterFramingY,presenterFramingZoom:t.presenterFramingZoom,presenterHeight:t.presenterHeight,presenterOffsetX:t.presenterOffsetX,presenterOffsetY:t.presenterOffsetY,presenterSize:t.presenterSize,presenterSlideId:t.presenterSlideId,presenterUseDefault:t.presenterUseDefault||void 0,presenterVisible:t.presenterVisible,presenterX:t.presenterX,presenterY:t.presenterY,settings:t.settings?e:void 0})}function H(t,e,n,r=!1){return o=>{let i=Number(o);if(!Number.isFinite(i)||i<e||i>n||r&&!Number.isInteger(i))throw new Uc(`${t} must be ${r?"an integer":"a number"} from ${e} to ${n}.`);return i}}function qc(t){return e=>{if(e==="true")return!0;if(e==="false")return!1;throw new Uc(`${t} must be true or false.`)}}function Sb(t){return Object.fromEntries(Object.entries(t).filter(e=>e[1]!==void 0))}var jc=new Eb("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",b("--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",b("--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",b("--presenter-background-fit",["cover","contain"])).option("--presenter-visible <true|false>","Show or hide the presenter on --presenter-slide-id",qc("--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(t,e){let n=T(this,e),r;try{r=await Lc(n)}catch(o){a(o instanceof Error?o.message:"Invalid settings patch"),process.exit(d.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(d.INVALID_INPUT)),!n.yes)return a("Pass --yes to confirm updating presentation video settings.");try{let o=await Y(n.teamId),i={projectId:t,...r,teamId:o};l(await m("updatePresentationVideoSettings",i,n.idempotencyKey??Te({command:"presentation video settings",payload:i,workspaceId:o})))}catch(o){a(o instanceof Error?o.message:"Settings update failed"),process.exit(d.GENERAL_ERROR)}}).addHelpText("after",`
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",`
169
+ A wrong-way clip is refused unless you declare the picture people-free with
170
+ --no-real-person. Layers already in the project are managed with
171
+ ${p.commands[0]} presentation video layer.
172
+
173
+ Examples:
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",`
178
+ A scene render produces the same frames the final video uses, so rendering the
179
+ whole video afterwards is not charged for the scenes it reuses. Editing a scene
180
+ invalidates its segment; render it again to see the change.
181
+
182
+ Examples:
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",`
141
186
  Caption geometry uses frame-relative values. x/y are the box center; width/height are its size.
142
187
  Omitted caption fields keep their saved values. Run presentation video inspect <project-id> to verify them.
143
188
  Presenter geometry also uses frame-relative values. Omit --presenter-slide-id to edit the default; pass it for one scene.
@@ -149,16 +194,16 @@ Examples:
149
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
150
195
  ${p.commands[0]} presentation video settings <project-id> --presenter-slide-id <slide-id> --presenter-apply-to-all --yes
151
196
  ${p.commands[0]} presentation video settings <project-id> --presenter-background color --presenter-background-hex '#14213d' --yes
152
- `);import{Command as sn,InvalidArgumentError as Db}from"commander";import{createHash as $b}from"crypto";import{existsSync as Tb,readFileSync as Ab}from"fs";import{Command as Vc,InvalidArgumentError as Mc}from"commander";function Pb(t){let e=Number(t);if(!Number.isFinite(e)||e<0||e>1)throw new Mc("--volume must be a number from 0 to 1.");return e}function Ob(t){let e=Number(t);if(!Number.isInteger(e)||e<1)throw new Mc("--file-size must be a positive whole number.");return e}async function Fc(t){let{idempotencyKey:e,teamId:n,...r}=t;return m("createPresentationVideoMusicUploadUrl",{...r,teamId:n},e)}var Bc=new Vc("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",Ob).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(t,e){let n=T(this,e);await y();try{let r=await Y(n.teamId),o={fileName:n.fileName,fileSize:n.fileSize,fileType:n.fileType,projectId:t};l(await Fc({...o,idempotencyKey:n.idempotencyKey??Te({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(d.GENERAL_ERROR)}}),Gc=new Vc("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",Pb,.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",`
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",`
153
198
  Postcondition: mode=upload, filename, and volume are read back from the saved project. This command never downloads an arbitrary URL.
154
- `).action(async function(t,e){let n=T(this,e);await y(),Tb(n.file)||(a(`File not found: ${n.file}`),process.exit(d.INVALID_INPUT));try{let r=await Y(n.teamId),o=qt(n.file),i=$b("sha256").update(Ab(n.file)).digest("hex"),s={contentSha256:i,...o,projectId:t,volume:n.volume},c=n.idempotencyKey??Te({command:"presentation video music upload",payload:s,workspaceId:r}),u=await Fc({...o,idempotencyKey:`${c}:upload`,projectId:t,teamId:r}),f=await jt(n.file,u),h=await m("updatePresentationVideoSettings",{projectId:u.projectId,settings:{music:{audioUrl:f.url,fileName:f.name,mode:"upload",volume:n.volume}},teamId:r},`${c}:settings`),I=(await m("getPresentationVideoProject",{projectId:u.projectId,teamId:r})).renderSettings.music;if(I.mode!=="upload"||I.uploadedFileName!==o.fileName||I.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:I,projectId:h.projectId,s3Key:u.s3Key,settings:h.settings.music})}catch(r){a(r instanceof Error?r.message:"Custom music upload failed"),process.exit(d.GENERAL_ERROR)}});function Nb(t){let e=Number(t);if(!Number.isInteger(e)||e<1||e>24)throw new Db("--limit must be an integer from 1 to 24.");return e}var _b=new sn("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",Nb).option("--token <token>","Opaque nextToken from the previous page").option("--team-id <id>","Workspace ID override").action(async function(t,e){let n=T(this,e);await Jo("Stock-music search failed",()=>m("searchPresentationVideoStockMusic",{limit:n.limit,query:t,teamId:n.teamId,token:n.token}))}).addHelpText("after",`
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",`
155
200
  Output:
156
201
  tracks[].previewUrl is for audition only. tracks[].selectionToken is opaque and short-lived.
157
202
  To save one result, pass its id, name, and selectionToken to stock select.
158
203
 
159
204
  Example:
160
205
  $ ${p.commands[0]} presentation video music stock search "calm ambient" --limit 8
161
- `),Ub=new sn("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(t,e){let n=T(this,e);if(n.mode!=="manual"&&n.mode!=="auto")return Ko("--mode must be manual or auto.");if(n.mode==="manual"&&(!n.selectionToken||!n.trackId||!n.trackName))return Ko("Manual mode requires --selection-token, --track-id, and --track-name from stock search.");if(n.mode==="auto"&&(n.selectionToken||n.trackId||n.trackName))return Ko("Auto mode derives the choice from the saved deck; omit manual track flags.");await Jo("Stock-music selection failed",async()=>{let r=await Y(n.teamId),o={mode:n.mode,projectId:t,selectionToken:n.selectionToken,teamId:r,trackId:n.trackId,trackName:n.trackName},i=await m("selectPresentationVideoStockMusic",o,n.idempotencyKey??Te({command:"presentation-video-stock-music-select",payload:o,workspaceId:r}));return n.wait===!1?i:Ra(i.runId,r)})}).addHelpText("after",`
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",`
162
207
  Postcondition:
163
208
  The completed run persists mode=stock, the durable audio URL, duration, track identity,
164
209
  and a new project draft version. It does not render an MP4.
@@ -168,92 +213,93 @@ Manual:
168
213
 
169
214
  Auto from saved slide titles and narration:
170
215
  $ ${p.commands[0]} presentation video music stock select <project-id> --mode auto
171
- `),Lb=new sn("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=T(this,e);await Jo("Stock-music status failed",()=>k("selectPresentationVideoStockMusic",t,n.teamId))}),Wc=new sn("music").description("Search and select music sources for an existing video project").addCommand(Gc).addCommand(Bc).addCommand(new sn("stock").description("Preview catalog tracks and save a manual or deck-aware automatic selection").addCommand(_b).addCommand(Ub).addCommand(Lb));async function Jo(t,e){try{l(await e())}catch(n){a(n instanceof Error?n.message:t),process.exit(d.GENERAL_ERROR)}}function Ko(t){a(t),process.exit(d.INVALID_INPUT)}import{readFile as qb}from"fs/promises";async function Kc(t){if(!t)return;let e=t.trim().startsWith("{")?t:await qb(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 Vb=new z("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 k("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)}}),Mb=new z("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));try{l(await m("deletePresentation",{approvalReceipt:e.approvalReceipt,presentationId:t,teamId:e.teamId},e.idempotencyKey??`cli:presentation:delete:${dr()}`))}catch(n){a(n instanceof Error?n.message:"Could not delete the presentation"),process.exit(d.GENERAL_ERROR)}}),Fb=new z("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 Ur(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)}}),Bb=new z("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 Qi(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)}}),Gb=new z("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=T(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)}}),Wb=new z("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 k("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)}}),Jc=new z("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){Jc.help();return}t.file.toLowerCase().endsWith(".pptx")||(a("PowerPoint import requires a .pptx file."),process.exit(d.INVALID_INPUT));try{let e=await be(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??dr());l(n)}catch(e){a(e instanceof Error?e.message:"Import failed"),process.exit(d.GENERAL_ERROR)}}).addCommand(Gb).addCommand(Wb),Kb=new z("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 k("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)}}),Jb=new z("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 k("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)}}),zb=new z("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=T(this,e);try{l(await k("createPresentationVideo",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Hb=new z("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=T(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??dr()))}catch(r){a(r instanceof Error?r.message:"Prepare failed"),process.exit(d.GENERAL_ERROR)}}),Xb=new z("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=T(this,e);try{l(await k("ensurePresentationVideoNarration",t,n.teamId))}catch(r){a(r instanceof Error?r.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Yb=new z("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=T(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??dr());if(n.wait===!1||r.runStatus==="completed"){l(r);return}l(r),await zo(r.runId,"presentation video narrate status",()=>kn(r.runId))}catch(r){a(r instanceof Error?r.message:"Narration failed"),process.exit(d.GENERAL_ERROR)}}).addCommand(Xb),Qb=new z("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 Zb(e.settings):void 0,teamId:e.teamId},e.idempotencyKey))}catch(n){let r=n instanceof Error?n.message:"Render failed";a(r);let o=ji({binary:p.commands[0],message:r,projectId:e.projectId});o&&$i(o),process.exit(d.GENERAL_ERROR)}}).addCommand(Hb).addCommand(Yb).addCommand(Nc).addCommand(vc).addCommand(Wc).addCommand(Cc).addCommand(Rc).addCommand(Pc).addCommand(Oc).addCommand(xc).addCommand(kc).addCommand(jc).addCommand(zb).addCommand($c).addCommand(Ec).addCommand(Tc).addCommand(Sc).addCommand(Ic);async function Zb(t){let e=t.trim(),n=e.startsWith("{")?e:await jb(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 ew(t,e){return[...e,t]}var tw=new z("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)",ew,[]).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 Y(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 Kc(e.slideInstructions)},o=await Hi(t,r,e.idempotencyKey??Te({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 zo(o.runId,"presentation speaker-notes-status",()=>kn(o.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),nw=new z("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("--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(t,e)=>{try{let n=await Xi(t,{instructions:e.instructions,slideId:e.slideId});if(e.format==="json"||!e.follow){l(n);return}w(`Narration run: ${n.runId}`),await zo(n.runId,"presentation video-narration-status",()=>kn(n.runId))}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});async function zo(t,e,n){let r=null;try{r=await ow(await n())}catch(o){let i=o instanceof Error&&o.message.trim()?o.message.trim():"the event stream ended unexpectedly";V(`Stopped following run ${t}: ${i}. The run is unaffected \u2014 check it with '${p.commands[0]} ${e} ${t}'.`);return}if(r)throw new Error(`Run ${t} ${r.status}: ${r.message} Inspect it with '${p.commands[0]} ${e} ${t}'.`)}function rw(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 ow(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(`
172
-
173
- `);r=c.pop()??"";for(let u of c){let f=u.split(`
174
- `).find(I=>I.startsWith("data:"))?.slice(5).trim();if(!f)continue;let h=JSON.parse(f);h.eventType?.startsWith("slide.")&&w(`${h.eventType}${h.payload?.slideId?` \xB7 ${h.payload.slideId}`:""}`);let v=rw(h);v==="completed"?o=null:v&&(o=v)}if(i)return o}}var Ho=new z("presentation").description("Create an MP4 video from a finished presentation, plus speaker notes, PowerPoint import, and run status").addCommand(Vb).addCommand(Sn).addCommand(Fb).addCommand(Bb).addCommand(Mb).addCommand(Jc).addCommand(tw).addCommand(Kb).addCommand(Qb).addCommand(nw).addCommand(Jb);Ho.addHelpText("after",`
175
- ${j.bold("Deck to MP4:")}
176
- $ ${p.commands[0]} presentation video prepare <slug> ${j.gray("# create/reuse the video project (free)")}
177
- $ ${p.commands[0]} presentation video narrate <project-id> --yes ${j.gray("# fill in missing narration")}
178
- $ ${p.commands[0]} presentation video inspect <project-id> ${j.gray("# review the scene timeline")}
179
- $ ${p.commands[0]} presentation video <slug> --yes ${j.gray("# start the MP4 render")}
180
- $ ${p.commands[0]} presentation video status <run-id> ${j.gray("# follow the render")}
181
-
182
- ${j.bold("Voice and avatar defaults:")}
183
- ${j.gray("# prepare picks the narration voice for you \u2014 the one this user last")}
184
- ${j.gray("# chose if it is still ready, otherwise the first ready voice \u2014 and")}
185
- ${j.gray("# reports it. Show which voice was selected and offer to change it")}
186
- ${j.gray("# instead of interviewing the user about voices. Every voice in")}
187
- ${j.gray("# avatar options carries a previewUrl audio sample they can hear.")}
188
- ${j.gray('# No avatar is chosen, on purpose: "slides with a voiceover" is the')}
189
- ${j.gray("# normal outcome, so presenter: null is finished, not misconfigured.")}
190
- ${j.gray("# Ask whether they want a presenter; do not assume either way.")}
191
- $ ${p.commands[0]} avatar options ${j.gray("# real voice and avatar ids + previews")}
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(`
217
+
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",`
220
+ ${V.bold("Deck to MP4:")}
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")}
226
+
227
+ ${V.bold("Voice and avatar defaults:")}
228
+ ${V.gray("# prepare picks the narration voice for you \u2014 the one this user last")}
229
+ ${V.gray("# chose if it is still ready, otherwise the first ready voice \u2014 and")}
230
+ ${V.gray("# reports it. Show which voice was selected and offer to change it")}
231
+ ${V.gray("# instead of interviewing the user about voices. Every voice in")}
232
+ ${V.gray("# avatar options carries a previewUrl audio sample they can hear.")}
233
+ ${V.gray('# No avatar is chosen, on purpose: "slides with a voiceover" is the')}
234
+ ${V.gray("# normal outcome, so presenter: null is finished, not misconfigured.")}
235
+ ${V.gray("# Ask whether they want a presenter; do not assume either way.")}
236
+ $ ${p.commands[0]} avatar options ${V.gray("# real voice and avatar ids + previews")}
192
237
  $ ${p.commands[0]} presentation video settings <project-id> --yes --settings '{"voiceId":"<id>"}'
193
238
  $ ${p.commands[0]} presentation video settings <project-id> --yes --settings '{"avatarId":"<id>"}'
194
239
 
195
- ${j.bold("Before rendering:")}
196
- ${j.gray("# Approve the content, then approve the spend \u2014 two questions. Read the")}
197
- ${j.gray("# narration back scene by scene from inspect (scenes[].narration.text)")}
198
- ${j.gray("# and get a yes on the script itself, plus the voice, the presenter (or")}
199
- ${j.gray("# none), music, format and captions, before the render. Reworking one")}
200
- ${j.gray("# scene is the cheap loop; the MP4 is not. --yes is your intent, not")}
201
- ${j.gray("# the user's consent.")}
202
- $ ${p.commands[0]} presentation video inspect <project-id> ${j.gray("# narration text + settings to show")}
240
+ ${V.bold("Before rendering:")}
241
+ ${V.gray("# Approve the content, then approve the spend \u2014 two questions. Read the")}
242
+ ${V.gray("# narration back scene by scene from inspect (scenes[].narration.text)")}
243
+ ${V.gray("# and get a yes on the script itself, plus the voice, the presenter (or")}
244
+ ${V.gray("# none), music, format and captions, before the render. Reworking one")}
245
+ ${V.gray("# scene is the cheap loop; the MP4 is not. --yes is your intent, not")}
246
+ ${V.gray("# the user's consent.")}
247
+ $ ${p.commands[0]} presentation video inspect <project-id> ${V.gray("# narration text + settings to show")}
203
248
  $ ${p.commands[0]} presentation video-narration <project-id> --slide-id <id> --instructions "shorter, warmer"
204
249
 
205
- ${j.bold("See also:")}
206
- ${j.gray("# Building a video from scratch instead of from a deck")}
250
+ ${V.bold("See also:")}
251
+ ${V.gray("# Building a video from scratch instead of from a deck")}
207
252
  $ ${p.commands[0]} video --help
208
- `);import{writeFile as iw}from"fs/promises";import dn from"chalk";import{Command as aw}from"commander";import sw from"ora";var Xo=new aw("scrape").description("Extract content from a URL").argument("<url>","URL to scrape").option("--team-id <id>","Workspace ID").option("-o, --output <path>","Save content to file").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{let n=e.format,r=n==="human"?sw("Scraping URL...").start():null;try{let o=await fa(t,e.teamId);r?.stop(),(!o.success||!o.data)&&(a(o.error||"Failed to scrape URL"),process.exit(d.GENERAL_ERROR));let i=o.data;if(e.output&&(await iw(e.output,i.content,"utf-8"),n==="human"&&x(`Content saved to: ${e.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&&V(i.warning),e.output||(console.log(),console.log("--- Content ---"),console.log(i.content))}catch(o){r?.stop(),a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}});Xo.addHelpText("after",`
209
- ${dn.bold("Examples:")}
210
- ${dn.gray("# Pull the readable content of a web page")}
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")}
211
256
  $ ${p.commands[0]} scrape https://example.com/post
212
257
 
213
- ${dn.bold("See also:")}
214
- ${dn.gray("# Local files and documents, not just URLs")}
258
+ ${Cn.bold("See also:")}
259
+ ${Cn.gray("# Local files and documents, not just URLs")}
215
260
  $ ${p.commands[0]} content extract ./paper.pdf
216
261
 
217
- ${dn.gray("# Spoken words out of audio or video")}
262
+ ${Cn.gray("# Spoken words out of audio or video")}
218
263
  $ ${p.commands[0]} transcript --help
219
- `);import Yo from"chalk";import{Command as cn}from"commander";function cr(t,e){e!=="quiet"&&l(t)}var dw=new cn("web").description("Search current public web sources").argument("<query>","Search query").option("--team-id <id>","Workspace ID").option("--max-results <count>","Maximum results","5").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await m("searchInternet",{maxResults:Number.parseInt(e.maxResults,10),query:t,teamId:e.teamId});cr(n,e.format)}catch(n){a(n instanceof Error?n.message:"Search failed"),process.exit(d.GENERAL_ERROR)}}),cw=new cn("news").description("Search recent news").argument("<topic>","News topic").option("--team-id <id>","Workspace ID").option("--timeframe <value>","Timeframe hint").option("--max-results <count>","Maximum results","6").option("-f, --format <format>","Output format: human, json, quiet",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await m("getNews",{maxResults:Number.parseInt(e.maxResults,10),teamId:e.teamId,timeframe:e.timeframe,topic:t});cr(n,e.format)}catch(n){a(n instanceof Error?n.message:"News search failed"),process.exit(d.GENERAL_ERROR)}});function zc(t){let e=t?.trim().toLowerCase();if(!(!e||e==="any"||e==="all"))return e==="web"||e==="stock"?[e]:void 0}var lw=new cn("images").description("Search images across the web and licensed stock").argument("<query>","Image search query").option("--team-id <id>","Workspace ID").option("--max-results <count>","Maximum results","10").option("--aspect <aspect>","Aspect: any, square, wide, tall","any").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)=>{try{let n=await m("searchImages",{aspect:e.aspect,maxResults:Number.parseInt(e.maxResults,10),query:t,sources:zc(e.source),teamId:e.teamId});cr(n,e.format)}catch(n){a(n instanceof Error?n.message:"Image search failed"),process.exit(d.GENERAL_ERROR)}}),mw=new cn("video").description("Search video across the web and licensed stock").argument("<query>","Video search query").option("--team-id <id>","Workspace ID").option("--max-results <count>","Maximum results","10").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",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{try{let n=await m("searchStockVideo",{license:e.license,maxResults:Number.parseInt(e.maxResults,10),orientation:e.orientation,query:t,sources:zc(e.source),teamId:e.teamId});cr(n,e.format)}catch(n){a(n instanceof Error?n.message:"Video search failed"),process.exit(d.GENERAL_ERROR)}}),Qo=new cn("search").description("Web, news, image, and stock-video search").addCommand(dw).addCommand(cw).addCommand(lw).addCommand(mw);Qo.addHelpText("after",`
220
- ${Yo.bold("Examples:")}
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:")}
221
266
  $ ${p.commands[0]} search web "state of AI video 2026"
222
267
  $ ${p.commands[0]} search news "vaccine approvals"
223
268
 
224
- ${Yo.bold("See also:")}
225
- ${Yo.gray("# `search images` and `search video` overlap with these")}
269
+ ${qi.bold("See also:")}
270
+ ${qi.gray("# `search images` and `search video` overlap with these")}
226
271
  $ ${p.commands[0]} image search --help
227
272
  $ ${p.commands[0]} video find --help
228
- `);import{Command as ei}from"commander";import uw from"ora";function Zo(t,e){if(e==="json"){l(t);return}if(e==="quiet"){console.log(t.audioUrl??t.requestId??t.id);return}w(`Request ID: ${t.requestId||t.id}`),w(`Status: ${t.status}`),t.duration&&w(`Duration: ${t.duration}s`),t.audioUrl&&x(`Audio URL: ${t.audioUrl}`),t.error&&a(`Error: ${t.error}`)}var pw=new ei("generate").description("Generate one SFX cue from a video's final facts and visual event").requiredOption("--request <path>","JSON file with video description, narration timings, and visual_event").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=gc(t.request)}catch(i){a(i instanceof Error?i.message:String(i)),process.exit(d.INVALID_INPUT)}let n=t.format,r=n==="human"?uw("Generating sound effect for video...").start():null,o;try{let i=await ha(e);if(o=i.requestId||i.id,!t.wait){r?.stop(),Zo(i,n);return}let s=i.requestId||i.id;r&&(r.text=`Processing (ID: ${s})...`);let c=i.status==="completed"||i.status==="failed"?i:await de(()=>jr(s),60,2e3);if(r?.stop(),c.status==="failed"&&(a(c.error||"Sound effects generation failed"),process.exit(d.GENERAL_ERROR)),t.output){if(!c.audioUrl)throw new Error("Sound effect completed without an audio URL");await te(c.audioUrl,t.output),n==="human"&&x(`Saved to: ${t.output}`)}Zo(c,n)}catch(i){r?.stop(),a(ue(i,o),n),process.exit(d.GENERAL_ERROR)}}),gw=new ei("status").description("Check status of a sound effects 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{Zo(await jr(t),e.format)}catch(n){a(n instanceof Error?n.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Hc=new ei("sfx").description("Video-aware sound effects generation commands").addCommand(pw).addCommand(gw);import{writeFile as fw}from"fs/promises";import{Command as hw}from"commander";import yw from"ora";var Xc=new hw("transcript").description("Fetch a YouTube video's transcript").argument("<url>","YouTube URL or 11-character video id").option("--team-id <id>","Workspace ID").option("--language <codes>","Comma-separated language priority list, e.g. 'en,de' or 'asr-en'").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",b("--format",["human","json","quiet"]),"human").action(async(t,e)=>{let n=e.format,r=n==="human"?yw("Fetching transcript...").start():null;try{let o=await ga(t,e.teamId,e.language);r?.stop();let i=e.timestamps?o.cues.map(s=>`[${s.timestamp}] ${s.text}`).join(`
229
- `):o.cues.map(s=>s.text).join(`
230
- `);if(e.output&&(await fw(e.output,i,"utf-8"),n==="human"&&x(`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&&V("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 bw,writeFile as Yc}from"fs/promises";import{dirname as ww}from"path";import{Command as lr}from"commander";import el from"ora";var Qc="en-US-Neural2-C",Zc="gemini",vw=new lr("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: ${Qc})`).option("-p, --provider <provider>",`Provider: gemini, elevenlabs, openai (default: ${Zc})`).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"?el("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||Qc,u=t.provider||Zc,f={};o&&(f.gemini={speakers:o}),t.instructions&&(f.openai={instructions:t.instructions});let h=await sa({text:t.text,options:{language:t.lang,provider:u,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 bw(ww(v),{recursive:!0}),await Yc(v,h.audioData);let I=v.replace(/\.[^.]+$/,".txt");if(await Yc(I,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}x(`Saved to: ${v}`),w(`Duration: ${h.duration.toFixed(2)}s`),w(`Provider: ${h.provider}`)}catch(s){n?.stop(),a(ue(s,i),e),process.exit(d.GENERAL_ERROR)}}),Iw=new lr("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"?el("Fetching voices...").start():null;try{let n=await ca(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)}}),kw=new lr("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 k("generateSpeech",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),tl=new lr("tts").description("Text-to-speech commands").addCommand(vw).addCommand(Iw).addCommand(kw);import{execSync as mr,spawnSync as qw}from"child_process";import{access as ni,readFile as jw,rm as ll}from"fs/promises";import{resolve as mn}from"path";import ne from"chalk";import{Command as ae}from"commander";import Vw from"ffmpeg-static";import ml from"ora";import{mkdir as xw}from"fs/promises";import{join as Cw}from"path";import{Command as ln}from"commander";import rl from"ora";var Rw=5e3,Sw=120,nl=5;function Ew(t,e){return[...e,t]}function $w(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 ol(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 Tw(t){if(t.mode&&!["speed","precision"].includes(t.mode))throw new Error("Lip-sync mode must be speed or precision");return{audioUrl:$w(t.audioUrl,"Audio URL"),...t.mode?{mode:t.mode}:{},sourceVideoId:ol(t.sourceVideoId)}}function Aw(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>nl)throw new Error(`Provide at most ${nl} 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:ol(t.sourceVideoId),targetLanguages:e}}function Pw(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 ti(t){return{requestId:t.runId,status:Pw(t),...t.entity?.url?{videoUrl:t.entity.url}:{},...t.output?{output:t.output}:{},...t.error?{error:se(t.error)}:{}}}function il(t){return{requestId:t.runId,status:"pending"}}async function al(t,e){return de(async()=>ti(await k(t,e)),Sw,Rw)}function vt(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&&x(`Video URL: ${t.videoUrl}`),t.error&&a(`Error: ${t.error}`)}function Ow(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 Dw(t){return`${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-|-$/g,"")||"translation"}.mp4`}function Nw(t,e){let n=Dw(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 _w(t,e){let n=Ow(t.output).filter(i=>i.status==="completed"&&!!i.videoUrl);if(n.length===0)throw new Error("Video translation completed without downloadable results");await xw(e,{recursive:!0});let r=[],o=new Set;for(let i of n){let s=Cw(e,Nw(i.language,o));await te(i.videoUrl,s),r.push({language:i.language,path:s})}return r}var Uw=new ln("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=T(this,e).format??"human";try{vt(ti(await k("lipsyncVideo",t)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),sl=new ln("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"?rl("Starting video lip-sync...").start():null,n;try{let r=await wa(Tw(t));if(n=r.runId,!t.wait){e?.stop(),vt(il(r),t.format);return}e&&(e.text="Waiting for video lip-sync...");let o=await al("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(),vt(o,t.format),t.format==="human"&&x(`Saved to: ${t.output}`)}catch(r){e?.stop(),a(ue(r,n),t.format),process.exit(d.GENERAL_ERROR)}}).addCommand(Uw),dl=new ln("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 va();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)}}),Lw=new ln("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=T(this,e).format??"human";try{vt(ti(await k("translateVideo",t)),r)}catch(o){a(o instanceof Error?o.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),cl=new ln("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)",Ew,[]).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"?rl("Starting video translation...").start():null,n;try{let r=await Ia(Aw(t));if(n=r.runId,!t.wait){e?.stop(),vt(il(r),t.format);return}e&&(e.text="Waiting for video translations...");let o=await al("translateVideo",r.runId);if(o.status==="failed")throw new Error(o.error??"Video translation failed");e&&(e.text="Downloading translated videos...");let i=await _w(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{vt(o,t.format);for(let s of i)x(`${s.language}: ${s.path}`)}}catch(r){e?.stop(),a(ue(r,n),t.format),process.exit(d.GENERAL_ERROR)}}).addCommand(Lw);async function Mw(){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 Fw(t){let e=t?.trim().toLowerCase();if(!(!e||e==="any"||e==="all"))return e==="web"||e==="stock"?[e]:void 0}var Bw=new ae("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"?ml("Finding videos...").start():null;try{let c=await pa({query:t,options:{maxResults:parseInt(n,10),orientation:r,license:o,sources:Fw(e.source)}});s?.stop();let u=c.data.results.flatMap(f=>f.results);if(i==="json"){l(c);return}if(i==="quiet"){u.forEach(f=>{console.log(f.embedUrl||f.previewUrl||f.thumbnailUrl)});return}if(u.length===0){w("No videos found");return}x(`Found ${u.length} videos for "${t}"`),console.log(),u.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)}}),Gw=new ae("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 ka({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 ul(t){let e=t==="-"?await Mw():await jw(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 pl(t,e={}){if(t)return t.length===1&&t[0]==="none"?[]:Promise.all(t.map(async n=>{let r;try{let I=JSON.parse(n);if(!I||typeof I!="object"||Array.isArray(I))throw new Error("Media binding must be a JSON object");r=I}catch(I){throw new Error(`Invalid --media binding. Pass one JSON object per binding, for example '{"handle":"actress-photo","path":"./actress.jpg","purpose":"identity"}'.`,{cause:I})}let o=ve(r.handle),i=ve(r.path),s=ve(r.fileUrl)??ve(r.url),c=ve(r.purpose),u=ve(r.videoRole),f=ve(r.analysisId)??ve(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 be(mn(i),{idempotencyKey:`${e.uploadIdempotencyKey}:media:${o}`}):{name:ve(r.name),size:Number(r.size),type:ve(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(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{...f?{analysisId:f}:{},fileUrl:h.url,handle:o,kind:v,mime:h.type,name:h.name,purpose:c,size:h.size,...u?{videoRole:u}:{}}}))}function ve(t){return typeof t=="string"&&t.length>0?t:void 0}var Ww=new ae("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 pl(t.media,{uploadIdempotencyKey:t.idempotencyKey}),storyboardMarkdown:await ul(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)}}),Kw=new ae("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 pl(e.media,{uploadIdempotencyKey:e.idempotencyKey}),storyboardId:t,storyboardMarkdown:await ul(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)}}),Jw=new ae("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)}}),zw=new ae("storyboard").description("Create, revise, and read Markdown video storyboards").addCommand(Ww).addCommand(Kw).addCommand(Jw),gl=new ae("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 be(mn(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 xa({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 Ca(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)}});gl.addHelpText("after",`
231
- ${ne.gray("# Prints an analysisId plus a ready storyboard media binding. Pass that")}
232
- ${ne.gray("# binding to video storyboard create/revise --media; generation reads the")}
233
- ${ne.gray("# analysis from the analysisId, never from local files.")}
234
- `);var Hw=new ae("status").description("Read a video-reference analysis run").argument("<run-id>","Analysis run UUID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{let n=await k("analyzeVideoReference",t,e.teamId);l(n);let r=Dr(n);if(r)throw new Error(r)}catch(n){a(n instanceof Error?n.message:"Status read failed"),process.exit(d.GENERAL_ERROR)}}),Xw=new ae("reference").description("Upload and inspect reusable video references").addCommand(gl).addCommand(Hw),Yw=new ae("status").description("Read video background status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{let n=await k("createVideo",t,e.teamId);l(n);let r=Dr(n);if(r)throw new Error(r)}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),Qw=new ae("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",b("--format",["human","json","quiet"]),"human").action(async t=>{let e=t.format,n=e==="human"?ml("Injecting thumbnail...").start():null;try{let r=mn(t.video),o=mn(t.thumbnail),i=t.output?mn(t.output):r.replace(/\.mp4$/,"-with-thumb.mp4");await ni(r),await ni(o);let s=Vw;if(s)try{await ni(s)}catch{s=null}if(!s)try{s=mr("which ffmpeg",{encoding:"utf8"}).trim()}catch{throw new Error("ffmpeg not found. Install ffmpeg or ffmpeg-static.")}let c=qw(s,["-i",r],{encoding:"utf8"});if(c.error)throw new Error(`Failed to probe video: ${c.error.message}`);let u=(c.stderr??"").match(/(\d{2,5})x(\d{2,5})/);if(!u)throw new Error("Could not detect video dimensions");let[,f,h]=u;n&&(n.text="Creating thumbnail frame...");let v="/tmp/cc-thumb-frame.mp4";mr(`${s} -y -loop 1 -i "${o}" -vf "scale=${f}:${h}:force_original_aspect_ratio=decrease,pad=${f}:${h}:(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 I="/tmp/cc-concat-video.mp4";if(mr(`${s} -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 "${I}"`,{stdio:"pipe"}),n&&(n.text="Adding file icon thumbnail..."),mr(`${s} -y -i "${I}" -i "${o}" -map 0 -map 1 -c copy -c:v:1 png -disposition:v:1 attached_pic "${i}"`,{stdio:"pipe"}),await ll(v,{force:!0}),await ll(I,{force:!0}),n?.stop(),e==="json"){l({success:!0,output:i});return}if(e==="quiet"){console.log(i);return}x(`Thumbnail injected: ${i}`)}catch(r){n?.stop(),a(r instanceof Error?r.message:"Unknown error"),process.exit(d.GENERAL_ERROR)}}),Zw=new ae("thumbnail").description("Thumbnail operations").addCommand(Qw),ur=new ae("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(Bw).addCommand(Zw).addCommand(sl).addCommand(dl).addCommand(cl).addCommand(_c);ur.addCommand(Gw).addCommand(zw).addCommand(Xw).addCommand(Yw);ur.addHelpText("after",`
235
- ${ne.bold("Examples:")}
236
- ${ne.gray("# Storyboard-first video from a brief")}
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")}
237
283
  $ ${p.commands[0]} video storyboard create --file brief.md --duration 60 --aspect 16:9 --idempotency-key launch-1
238
284
 
239
- ${ne.gray("# Find licensed stock footage")}
285
+ ${ie.gray("# Find licensed stock footage")}
240
286
  $ ${p.commands[0]} video find "city timelapse"
241
287
 
242
- ${ne.bold("Before generating:")}
243
- ${ne.gray("# Approve the content, then approve the spend \u2014 two questions. Paste the")}
244
- ${ne.gray("# storyboard text into your reply and get a yes on it BEFORE pinning a")}
245
- ${ne.gray("# revision; revising is free and append-only, a pinned revision is not.")}
246
- ${ne.gray("# The browser confirmation video create requires is about cost and")}
247
- ${ne.gray("# destination, not the user reading the script. --yes is neither.")}
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.")}
248
294
  $ ${p.commands[0]} video storyboard show <storyboard-id>
249
295
  $ ${p.commands[0]} video storyboard revise <storyboard-id> --base-revision <revision-id> --file brief-v2.md --idempotency-key launch-2
250
296
 
251
- ${ne.bold("See also:")}
252
- ${ne.gray("# Already have a deck? Render it to MP4 (narration, avatar, captions)")}
297
+ ${ie.bold("See also:")}
298
+ ${ie.gray("# Already have a deck? Render it to MP4 (narration, avatar, captions)")}
253
299
  $ ${p.commands[0]} presentation video <slug>
254
- `);import{Command as ri}from"commander";var ev=new ri("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("--yes","Approve generation").action(async(t,e)=>{if(!e.yes)return a("Pass --yes to approve visual-abstract generation");try{let n=Array.isArray(e.referenceUrl)?e.referenceUrl.slice(0,3).map((r,o)=>({label:`visual-reference-${o+1}`,url:r})):void 0;l(await m("createVisualAbstract",{approvalReceipt:"cli:--yes",aspectRatio:e.aspect,brandingId:e.brandingId,brief:t,outputPreset:e.preset,outputType:e.output,qualityTier:e.quality,referenceImages:n,teamId:e.teamId,title:e.title}))}catch(n){a(n instanceof Error?n.message:"Generation failed"),process.exit(d.GENERAL_ERROR)}}),tv=new ri("status").description("Read visual-abstract generation status").argument("<run-id>","Run ID").option("--team-id <id>","Workspace ID").action(async(t,e)=>{try{l(await k("createVisualAbstract",t,e.teamId))}catch(n){a(n instanceof Error?n.message:"Status failed"),process.exit(d.GENERAL_ERROR)}}),fl=new ri("visual-abstract").description("Generate a one-page visual abstract graphic (raster or vector) from a dense brief").addCommand(ev).addCommand(tv);var oi=[Gd,Qd,jd,tl,yc,ac,ec,ur,Xo,Xc,Hc,Ho,Qo,$o,tc,No,wc,Os,Ds,fl,ic,Cs,no,oc,Eo,Kd,zd,Ao];function hl(t){for(let e of oi)t.addCommand(e)}function yl(t,e,n){let r=e?`${e} ${t.name()}`:t.name();n.set(r,{arguments:t.registeredArguments.filter(o=>o.required).map(o=>`<${o.name()}>`),requiredOptions:t.options.filter(o=>o.mandatory).map(o=>o.long).filter(o=>!!o)});for(let o of t.commands)yl(o,r,n)}var pr;function nv(){if(!pr){pr=new Map;for(let t of oi)yl(t,"",pr)}return pr}function bl(t){let e=nv().get(t);return e?[...e.arguments,...e.requiredOptions.map(n=>`${n} \u2026`)].join(" "):""}var wl=["presentations","media","branding","knowledge","research","artifacts","agents"],ii={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"},rv="other";function ov(t){let e=t.category?.trim();return e&&e.length>0?e:rv}function vl(t){let e=wl.indexOf(t);return e===-1?wl.length:e}function un(t){let e=new Map;for(let n of t){let r=ov(n),o=e.get(r);o?o.push(n):e.set(r,[n])}return[...e.entries()].sort(([n],[r])=>vl(n)-vl(r)||n.localeCompare(r)).map(([n,r])=>({capabilities:[...r].sort((o,i)=>o.name.localeCompare(i.name)),category:n}))}function ai(t){return t.lifecycle?.mode==="background"}function si(t,e){let n=t.lifecycle?.status?.cliCommand?.trim();if(!(!ai(t)||!n))return`${e} ${n} <run-id>`}function iv(t){switch(t.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 gr(t){return t.replace(/\|/g,"\\|").replace(/\r?\n/g," ").trim()}function av(t,e){let n=si(t,e);return n?`run id \u2014 poll \`${n}\``:`immediate (${t.operation??"call"})`}function je(t,e){let n=["| Command | What it does | Takes | Returns | Cost | Scopes |","|---|---|---|---|---|---|"],r=t.map(o=>{let i=bl(o.name),s=o.scopes?.length?o.scopes.map(c=>`\`${c}\``).join(", "):"\u2014";return`| \`${e} ${gr(o.name)}\` | ${gr(o.description??"")} | ${i?`\`${gr(i)}\``:"\u2014"} | ${av(o,e)} | ${iv(o)} | ${s} |`});return[...n,...r].join(`
255
- `)}function re(t,e){if(t.source==="live")return`<!-- Generated from the live ${e.name} capability catalog (v${t.catalogVersion}, ${t.capabilities.length} capabilities) at install time. Re-run \`${e.cmd} skill install\` to refresh. -->`;let n=t.reason?` Reason: ${gr(t.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${t.catalogVersion}, ${t.capabilities.length} capabilities).${n} Run \`${e.cmd} login\` then \`${e.cmd} skill install --force\` to regenerate from the live catalog, and treat \`${e.cmd} capabilities\` as authoritative over this file. -->`}function Il(t){return t.map(e=>`- [${e}](#${e.toLowerCase().replace(/[^a-z0-9 -]/g,"").replace(/ /g,"-")})`).join(`
256
- `)}var sv=["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 dv(t){let e=new Map(t.map(n=>[n.name,n]));return sv.map(n=>e.get(n)).filter(n=>n!==void 0)}function It(t,e){let{cmd:n}=t,r=dv(e.capabilities),o=e.capabilities.find(s=>s.name==="presentation video"),i=o?si(o,n)??`${n} presentation video status <run-id>`:`${n} presentation video status <run-id>`;return`${re(e,t)}
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)}
257
303
 
258
304
  # Deck \u2192 MP4 (\`${n} presentation video\`)
259
305
 
@@ -488,11 +534,11 @@ not maintain a second copy.
488
534
 
489
535
  ## Every capability in this flow
490
536
 
491
- ${je(r,n)}
537
+ ${He(r,n)}
492
538
 
493
539
  If something you need is not in this table, do not conclude it is missing \u2014
494
540
  run \`${n} capabilities --search video\`.
495
- `}var cv=["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 di(t){let e=new Map(t.map(n=>[n.name,n]));return cv.map(n=>e.get(n)).filter(n=>n!==void 0)}function fr(t,e){let{cmd:n}=t,r=di(e.capabilities);return`${re(e,t)}
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)}
496
542
 
497
543
  # Video from scratch (\`${n} video\`)
498
544
 
@@ -662,63 +708,63 @@ ${n} video library list <project-id> # reusable clips and rec
662
708
 
663
709
  ## Every capability in this flow
664
710
 
665
- ${je(r,n)}
711
+ ${He(r,n)}
666
712
 
667
713
  If something you need is not in this table, do not conclude it is missing \u2014
668
714
  run \`${n} capabilities --search video\`.
669
- `}var lv=12,mv={media:"video.md",presentations:"deck-to-video.md"};function uv(t,e,n,r){let{cmd:o}=t,i=ii[n]??n,s=r.filter(ai),c=r.filter(h=>h.billing!==void 0&&h.billing!=="free"),u=mv[n],f=["Every capability",...s.length>0?["Background operations"]:[]];return`${re(e,t)}
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)}
670
716
 
671
717
  # ${n} \u2014 ${i}
672
718
 
673
- ${r.length} capabilit${r.length===1?"y":"ies"} in this category${c.length>0?`, ${c.length} of which ${c.length===1?"costs":"cost"} credits or ${c.length===1?"counts":"count"} against a plan quota`:", all free"}.${u?`
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?`
674
720
 
675
721
  Step-by-step flow: [${u}](${u}).`:""}
676
- ${r.length>lv?`
722
+ ${r.length>_x?`
677
723
  ## Contents
678
724
 
679
- ${Il(f)}
725
+ ${ru(g)}
680
726
  `:""}
681
727
  ## Every capability
682
728
 
683
- ${je(r,o)}
684
- ${s.length>0?`
729
+ ${He(r,o)}
730
+ ${c.length>0?`
685
731
  ## Background operations
686
732
 
687
733
  These return a run id immediately and keep working. Poll the status command
688
734
  until it reports done \u2014 do not assume success from the accept response.
689
735
 
690
- ${s.map(h=>`- \`${o} ${h.name}\` \u2192 \`${o} ${h.lifecycle?.status?.cliCommand??""} <run-id>\`${h.lifecycle?.status?.pollAfterSeconds?` (first poll after ~${h.lifecycle.status.pollAfterSeconds}s)`:""}`).join(`
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(`
691
737
  `)}
692
738
  `:""}
693
739
  Anything missing here? Run \`${o} capabilities --category ${n}\` \u2014 the
694
740
  catalog is authoritative and always current; this file is a snapshot of it.
695
- `}function kl(t,e,n={}){let r=[{content:It(t,e),name:"deck-to-video"},{content:fr(t,e),name:"video"}];for(let{capabilities:o,category:i}of un(e.capabilities)){let s=n[i];r.push({content:uv(t,e,i,o)+(s?`
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?`
696
742
  ---
697
743
 
698
- ${s}`:""),name:i})}return r}function xl(t){let e=[{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 un(t.capabilities))e.push({file:`${r}.md`,when:`${ii[r]??r} (${n.length} commands).`});return e}function pn(t){return[...new Set(t.flatMap(e=>[e.name,...e.lifecycle.status?.cliCommand?[e.lifecycle.status.cliCommand]:[]]))]}function oe(t,e,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#${e}`,case:e,run:`pnpm smoke -- run ${t} --url <non-production-deployment>`,claim:`${o} ${n}`}}function hr(t,e,n){return{level:"partial",boundary:"mocked-adapter-integration",kind:"integration",source:t,case:e,run:`pnpm exec vitest run ${t}`,claim:`In-memory adapter integration with mocked canonical operations; no real HTTP operation or fixture postcondition is reached. ${n}`}}function ci(t,e,n){return{level:"full",boundary:"real-cli-http-journey",kind:"smoke",source:`scripts/lib/deployment-smoke-catalog.ts#${e}`,case:e,run:`pnpm smoke:${t} -- --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 Cl="tests/integration/tool-surface/presentations.integration.test.ts",pv="tests/integration/tool-surface/branding.integration.test.ts";function Rl(t){switch(t){case"create":return[hr(Cl,"normalizes MCP and CLI starts into the same durable job input","MCP and CLI normalize the same generation input."),oe("presentation","presentation.create","A real deck is generated and persisted.","ui-e2e")];case"export":return[oe("presentation","presentation.export","Real PDF, PPTX, HTML, and PNG exports are validated.","ui-e2e")];case"presentation import":case"presentation import transform":return[oe("presentation-import","presentation.import-powerpoint","A PowerPoint is imported, reviewed, and reopened.","ui-e2e")];case"presentation speaker-notes":case"presentation speaker-notes-status":return[oe("presentation","presentation.speaker-notes","Persisted speaker notes are ready after reload.","ui-e2e")];default:return[]}}function gv(t){return["presentation video inspect","video library list"].includes(t)?[oe("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(t)?[oe("presentation-video-agent-edits","video.presentation.agent-edit-surfaces","Draft edits and restores persist through canonical agent operations.")]:t==="presentation video presenter"?[oe("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(t)?[hr(Cl,`generated MCP and CLI ${t}`,"The integration suite compares matching MCP and CLI adapter results.")]:t==="get"||t.startsWith("presentation speaker-notes")?Rl(t):[]}function fv(t){if(["branding list","branding profile","branding competitor list"].includes(t))return[oe("branding","branding.agent-read-surfaces","Brand reads resolve the same controlled brand across agent surfaces.")];if(t==="branding extract")return[oe("branding","branding.extraction-approval-refusal","Only the approval refusal and no-charge boundary is proven.")];if(t==="branding create")return[oe("branding","branding.create","Creation, idempotency, and plan-limit refusal reach the canonical operation.")];let e=[["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 e)if(t.startsWith(n))return[oe("branding",r,o)];return["branding star","branding default","branding delete"].some(n=>t.startsWith(n))?[oe("branding","branding.lifecycle-pointers","Star, default, and deletion pointers reach canonical operations.")]:t==="branding update"?[oe("branding","branding.record-fields","Rename and parent moves reach updateBrand.")]:t==="branding set"?[hr(pv,"runs the free brand write on both lanes without an approval receipt","MCP and CLI invoke the same free brand write in memory.")]:[]}function hv(t){return["agent roster list","agent roster get","agent visibility set"].includes(t)?[ci("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(t)?[ci("agent-management","agent.management-primitives","Owned-Agent reads, configuration CAS, schedule transitions, replay, conflicts, and database postconditions are verified.")]:[]}function yv(t,e){return t==="presentation"?Rl(e):t==="presentation-video"?gv(e):t==="agents"?hv(e):fv(e)}function li(t,e){return pn(e).map(n=>{let r=yv(t,n),o=r.length===0?"missing":r.some(i=>i.level==="full")?"full":"partial";return{command:n,evidence:r,level:o}})}function Sl(t){return t==="presentation video"||t.startsWith("presentation video ")||t.startsWith("presentation video-")}function mi(t,e){let n=new Set(e.capabilities.map(r=>r.name));return t.flow.filter(r=>n.has(r))}function bv(t,e){let n=new Set(e.capabilities.map(o=>o.name)),r=(o,i)=>n.has(o)?`- \`${t.cmd} ${o}\` \u2014 ${i}`:void 0;return`# Presentation workflow
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
699
745
 
700
746
  Use this flow for decks, not MP4 production or brand-library maintenance.
701
747
 
702
748
  1. Run \`../scripts/check-auth.sh\`, then \`../scripts/check-flow.sh\`.
703
- 2. Inspect exact flags with \`${t.cmd} <command> --help\`; never infer a flag from another surface.
749
+ 2. Inspect exact flags with \`${e.cmd} <command> --help\`; never infer a flag from another surface.
704
750
  3. Gather source material before generation and pass only user-provided or verified context.
705
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.
706
752
  5. Retain a background run id and poll the catalog-named status command.
707
- 6. Resolve the final deck with \`${t.cmd} get\`; export only when requested.
753
+ 6. Resolve the final deck with \`${e.cmd} get\`; export only when requested.
708
754
 
709
755
  ## Useful operations present in this catalog
710
756
 
711
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(`
712
758
  `)}
713
759
 
714
- For narration, scenes, presenters, captions, or MP4 output, load \`${t.name}-presentation-video\`.
715
- `}function wv(t,e){let n=mi(kt.branding,e).map(r=>`- \`${t.cmd} ${r}\``).join(`
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(`
716
762
  `);return`# Branding workflow
717
763
 
718
764
  Branding owns saved private and team brand profiles. It does not edit arbitrary deck HTML.
719
765
 
720
766
  1. Run \`../scripts/check-auth.sh\`, then discover the live surface with \`../scripts/discover-capabilities.sh\`.
721
- For least privilege, authenticate with \`${t.cmd} login --scopes brands:read,brands:write\`.
767
+ For least privilege, authenticate with \`${e.cmd} login --scopes brands:read,brands:write\`.
722
768
  2. Resolve the workspace or team explicitly when requested.
723
769
  3. List or inspect before mutating. Use the returned brand id; never guess from a name or URL.
724
770
  4. Select a brand during presentation creation. A later sync may propagate changed tokens only to decks already linked to that brand.
@@ -729,13 +775,13 @@ Branding owns saved private and team brand profiles. It does not edit arbitrary
729
775
  ${n||"No common anchors are present in this snapshot; run discovery before acting."}
730
776
 
731
777
  Read [commands.md](commands.md) for every available brand operation and its scopes.
732
- `}function vv(t,e){let n=mi(kt.agents,e).map(r=>`- \`${t.cmd} ${r}\``).join(`
778
+ `}function Jx(e,t){let n=na(jt.agents,t).map(r=>`- \`${e.cmd} ${r}\``).join(`
733
779
  `);return`# Agents workflow
734
780
 
735
781
  This skill owns scheduled Mindframes Agents. It is not a guide for software-development agents.
736
782
 
737
783
  1. Run \`../scripts/check-auth.sh\`, then discover the deployed Agents surface with \`../scripts/discover-capabilities.sh\`.
738
- Use \`${t.cmd} login --scopes agents:read,agents:write\` only when a visibility mutation is required.
784
+ Use \`${e.cmd} login --scopes agents:read,agents:write\` only when a visibility mutation is required.
739
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.
740
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.
741
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\`.
@@ -746,25 +792,25 @@ This skill owns scheduled Mindframes Agents. It is not a guide for software-deve
746
792
  ${n||"No common anchors are present in this snapshot; run discovery before acting."}
747
793
 
748
794
  Read [commands.md](commands.md) for current inputs, outputs, scopes, and exact CLI help.
749
- `}var Iv=[{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."]}],kv=[{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."]}],xv=[{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."]}],Cv=[{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."]}],kt={presentation:{type:"presentation",title:"Presentation",description:t=>`Use whenever the user wants to create, import, inspect, export, organize, share, delete, or edit a ${t} presentation, deck, slides, pitch deck, or PowerPoint. Do not use for turning an existing deck into an MP4 (use ${t}-presentation-video), video from scratch (use ${t}-video), or maintaining saved brands (use ${t}-branding).`,discoveryQuery:"presentation",select:t=>t.category==="presentations"&&!Sl(t.name),flow:["create","presentation status","get","export"],workflow:bv,evals:Iv},"presentation-video":{type:"presentation-video",title:"Presentation to MP4",description:t=>`Use whenever an existing ${t} 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 ${t}-video), ordinary slide editing (use ${t}-presentation), or brand maintenance (use ${t}-branding).`,discoveryQuery:"presentation video",select:t=>Sl(t.name)||t.name==="presentation speaker-notes"||t.name==="get"||t.name==="avatar options"||t.name==="video library list",flow:["presentation video prepare","presentation video inspect","presentation video settings","presentation video","presentation video status"],workflow:It,evals:kv},branding:{type:"branding",title:"Branding",description:t=>`Use whenever the user wants to discover, create, inspect, or maintain private or team ${t} 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:t=>t.category==="branding",flow:["branding list","branding profile","branding set","branding sync"],workflow:wv,evals:xv},agents:{type:"agents",title:"Agents",description:t=>`Use for scheduled ${t} 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:t=>t.category==="agents",flow:["agent list","agent roster list","agent roster get","agent visibility set"],workflow:vv,evals:Cv}};function yr(t,e){return e.capabilities.filter(kt[t].select).sort((n,r)=>n.name.localeCompare(r.name))}function Rv(t,e,n){let r=yr(n.type,e),o=new Set(r.map(s=>s.name)),i=pn(r).filter(s=>!o.has(s));return`${re(e,t)}
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)}
750
796
 
751
797
  # ${n.title} commands
752
798
 
753
- Generated from the capability catalog. It describes ${r.length} callable operations; run \`${t.cmd} capabilities --search "${n.discoveryQuery}"\` for the deployed surface.
799
+ Generated from the capability catalog. It describes ${r.length} callable operations; run \`${e.cmd} capabilities --search "${n.discoveryQuery}"\` for the deployed surface.
754
800
 
755
- ${je(r,t.cmd)}
801
+ ${He(r,e.cmd)}
756
802
  ${i.length?`## Recovery commands
757
803
 
758
- ${i.map(s=>`- \`${t.cmd} ${s}\``).join(`
804
+ ${i.map(c=>`- \`${e.cmd} ${c}\``).join(`
759
805
  `)}
760
806
  `:""}
761
- `}function Sv(t,e,n){let r=li(n.type,yr(n.type,e)),o=r.map(f=>{let h=f.evidence.length?f.evidence.map(I=>`**${I.kind}** ${I.source} \u2014 ${I.case}`).join("<br>"):"No non-unit evidence registered.",v=f.evidence.length?f.evidence.map(I=>I.claim).join(" "):"Do not claim integration or smoke coverage for this command.";return`| \`${t.cmd} ${f.command}\` | **${f.level.toUpperCase()}** | ${h} | ${v} |`}),i=[...new Set(r.flatMap(f=>f.evidence.map(h=>h.run)))],s=r.filter(f=>f.level==="full").length,c=r.filter(f=>f.level==="partial").length,u=r.length-s-c;return`${re(e,t)}
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)}
762
808
 
763
809
  # ${n.title} non-unit evidence
764
810
 
765
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.
766
812
 
767
- Summary: ${s} full, ${c} partial, ${u} missing.
813
+ Summary: ${c} full, ${d} partial, ${u} missing.
768
814
 
769
815
  | Command | Coverage | Executable evidence | Proven claim |
770
816
  |---|---|---|---|
@@ -779,9 +825,9 @@ Smoke runs require an approved non-production target and their catalog prerequis
779
825
  ${i.length?i.join(`
780
826
  `):"# No non-unit evidence registered."}
781
827
  \`\`\`
782
- `}function El(t){return`'${t.replace(/'/g,`'"'"'`)}'`}function Ev(t,e,n){let r=yr(n.type,e),o=pn(r),i=li(n.type,r),s=i.filter(f=>f.level==="missing").map(f=>f.command).join(`
783
- `),c=i.filter(f=>f.level==="partial").map(f=>f.command).join(`
784
- `),u=El(t.cmd);return[{path:"scripts/check-auth.sh",executable:!0,content:`#!/usr/bin/env sh
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
785
831
  set -eu
786
832
  CLI=${u}
787
833
  command -v "$CLI" >/dev/null 2>&1 || { echo "$CLI is not installed" >&2; exit 127; }
@@ -791,7 +837,7 @@ printf '%s\\n' "Authentication and feature catalog are ready."
791
837
  `},{path:"scripts/discover-capabilities.sh",executable:!0,content:`#!/usr/bin/env sh
792
838
  set -eu
793
839
  CLI=${u}
794
- QUERY=\${1:-${El(n.discoveryQuery)}}
840
+ QUERY=\${1:-${cu(n.discoveryQuery)}}
795
841
  "$CLI" capabilities --search "$QUERY" --format json
796
842
  `},{path:"scripts/verify-help.sh",executable:!0,content:`#!/usr/bin/env sh
797
843
  set -eu
@@ -813,18 +859,18 @@ while IFS= read -r REQUIRED; do
813
859
  [ -z "$REQUIRED" ] && continue
814
860
  printf '%s\\n' "$AVAILABLE" | grep -Fqx "$REQUIRED" || { echo "Missing required capability: $REQUIRED" >&2; exit 1; }
815
861
  done <<'COMMANDS'
816
- ${mi(n,e).join(`
862
+ ${na(n,t).join(`
817
863
  `)}
818
864
  COMMANDS
819
865
  printf '%s\\n' "${n.title} flow anchors are available."
820
866
  `},{path:"scripts/check-coverage.sh",executable:!0,content:`#!/usr/bin/env sh
821
867
  set -eu
822
868
  PARTIAL=$(cat <<'COMMANDS'
823
- ${c}
869
+ ${d}
824
870
  COMMANDS
825
871
  )
826
872
  MISSING=$(cat <<'COMMANDS'
827
- ${s}
873
+ ${c}
828
874
  COMMANDS
829
875
  )
830
876
  [ -z "$PARTIAL" ] || printf 'PARTIAL command evidence (not parity):\\n%s\\n' "$PARTIAL" >&2
@@ -834,14 +880,14 @@ if [ -n "$PARTIAL" ] || [ -n "$MISSING" ]; then
834
880
  exit 1
835
881
  fi
836
882
  printf '%s\\n' 'Every documented command has full real-CLI journey evidence.'
837
- `}]}function $v(t,e){return{path:"evals/evals.json",content:`${JSON.stringify({skill_name:t,evals:e.map(n=>({...n,files:[],expectations:[...n.expectations,"Consults references/coverage.md and never reports PARTIAL or MISSING as full command parity."]}))},null,2)}
838
- `}}function Ie(t,e,n){let r=kt[n],o=`${t.name}-${n}`,i=yr(n,e).length;return`---
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`---
839
885
  name: ${o}
840
886
  description: >-
841
- ${r.description(t.name)}
887
+ ${r.description(e.name)}
842
888
  ---
843
889
 
844
- ${re(e,t)}
890
+ ${ae(t,e)}
845
891
 
846
892
  # ${r.title}
847
893
 
@@ -853,7 +899,7 @@ Use this narrow workflow. Do not infer command names or reuse flags from UI, API
853
899
  2. Run \`scripts/check-flow.sh\` or \`scripts/discover-capabilities.sh [query]\`.
854
900
  3. Read [references/coverage.md](references/coverage.md); MISSING is not covered.
855
901
  4. Read [references/workflow.md](references/workflow.md).
856
- 5. Read [references/commands.md](references/commands.md) only for the needed operation, then run \`${t.cmd} <command> --help\`.
902
+ 5. Read [references/commands.md](references/commands.md) only for the needed operation, then run \`${e.cmd} <command> --help\`.
857
903
  6. Verify returned state; an accepted background run is not completion.
858
904
 
859
905
  ## Bundled resources
@@ -867,9 +913,9 @@ Use this narrow workflow. Do not infer command names or reuse flags from UI, API
867
913
  - \`scripts/check-flow.sh\` \u2014 verify minimum flow anchors exist.
868
914
  - \`scripts/check-coverage.sh\` \u2014 fail unless every documented command has full real-CLI evidence.
869
915
  - \`evals/evals.json\` \u2014 realistic trigger and workflow evaluations.
870
- `}function xt(t,e,n){let r=kt[n];return[{name:"commands",content:Rv(t,e,r)},{name:"coverage",content:Sv(t,e,r)},{name:"workflow",content:r.workflow(t,e)}]}function Ct(t,e,n){let r=kt[n];return[...Ev(t,e,r),$v(`${t.name}-${n}`,r.evals)]}var Tv=[{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:"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:"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"}],Av=["ai-connections","capabilities","config","delete","derive","export","footage","ideas","import","list","login","logout","runner","skill","templates","whoami"];function br(t,e=xn("rendered without a catalog fetch")){let{name:n,cmd:r,pkg:o}=t,i=new Map(e.capabilities.map(v=>[v.name,v])),s=Tv.filter(v=>i.has(v.capability)).map(v=>`| ${v.intent} | \`${r} ${v.capability}${v.suffix??""}\` | [${v.reference}](references/${v.reference}) |`).join(`
871
- `),u=un(e.capabilities).map(({capabilities:v,category:I})=>`${I} (${v.length})`).join(", "),f=xl(e).map(({file:v,when:I})=>`| [references/${v}](references/${v}) | ${I} |`).join(`
872
- `),h=[...new Set([...e.capabilities.map(v=>v.name.split(" ")[0]),...Av])].sort().map(v=>`\`${v}\``).join(", ");return`---
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`---
873
919
  name: ${n}
874
920
  description: >-
875
921
  Route any ${n} CLI task to the smallest installed domain skill. Trigger for
@@ -878,7 +924,7 @@ description: >-
878
924
  detailed workflows live in domain skills and catalog-generated references.
879
925
  ---
880
926
 
881
- ${re(e,t)}
927
+ ${ae(t,e)}
882
928
 
883
929
  # ${n} CLI router
884
930
 
@@ -897,11 +943,15 @@ and refresh feature-gated commands with \`${r} config refresh\`.
897
943
  \`${r} presentation video\` is deck\u2192MP4; \`${r} video\` is video from scratch.
898
944
  They share no state. There is no \`video export\` subcommand.
899
945
 
946
+ Something broke, a question, or a feature request \u2192 the \`support\` group:
947
+ \`report\` files it (never gated) and \`list\` follows what became of it. Run
948
+ \`${r} capabilities --category support\` for the exact flags.
949
+
900
950
  ## Task \u2192 command
901
951
 
902
952
  | The user asks for\u2026 | Start here | Catalog detail |
903
953
  |---|---|---|
904
- ${s}
954
+ ${c}
905
955
 
906
956
  ## Composing commands
907
957
 
@@ -923,21 +973,21 @@ ${u}.
923
973
 
924
974
  | File | Read it when |
925
975
  |---|---|
926
- ${f}
976
+ ${g}
927
977
 
928
978
  ## Every command group
929
979
 
930
980
  Run \`${r} <group> --help\` for any of these:
931
981
 
932
- ${h}
933
- `}function wr(t){let{name:e,cmd:n}=t;return`---
934
- name: ${e}-presentation-edit
982
+ ${w}
983
+ `}function Gr(e){let{name:t,cmd:n}=e;return`---
984
+ name: ${t}-presentation-edit
935
985
  description: >
936
986
  Use ONLY when editing an already-created presentation that has real slides:
937
987
  changing slide text, colors, fonts, images, charts, layout, or adding/removing slides.
938
988
  Triggers: "change", "edit", "update", "fix", "modify", "add a slide", "make it X".
939
989
  Do NOT load for creation requests \u2014 "create a presentation", "make slides",
940
- "build a deck", "3-slide pitch", "new presentation" \u2192 use ${e}-presentation.
990
+ "build a deck", "3-slide pitch", "new presentation" \u2192 use ${t}-presentation.
941
991
  ---
942
992
 
943
993
  # Presentation Editor \u2014 In-App Guide
@@ -1215,8 +1265,8 @@ Do NOT render or export the presentation \u2014 that's handled by the app.
1215
1265
  | Create brand-new presentation (5+ slides, new topic) | \`${n} create ...\` via CLI |
1216
1266
  | Redesign the whole deck | \`${n} create ...\` via CLI, then sync |
1217
1267
  | User provides a URL to base the presentation on | \`${n} scrape <url>\` \u2192 \`${n} create ...\` |
1218
- `}function vr(t,e){return Ie(t,e,"presentation")}var Pv=[{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 Ir(t,e){let{cmd:n,name:r,pkg:o}=t,i=new Set(e.capabilities.map(u=>u.name)),s=Pv.filter(u=>i.has(u.capability)).map((u,f)=>`${f+1}. \`${n} ${u.capability}\` \u2014 ${u.when}`).join(`
1219
- `),c=di(e.capabilities).length;return`---
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`---
1220
1270
  name: ${r}-video
1221
1271
  description: >-
1222
1272
  Use when a video must be built from scratch \u2014 a brief, a script, a storyboard,
@@ -1224,10 +1274,10 @@ description: >-
1224
1274
  involved. Trigger it even when the user never names the product: "make me a
1225
1275
  video about X", "turn this script into a video", "I need a 30s promo".
1226
1276
  For turning an EXISTING presentation into an MP4, use the ${r} skill's
1227
- deck\u2192MP4 flow instead. ${c} CLI capabilities, listed in references/video.md.
1277
+ deck\u2192MP4 flow instead. ${d} CLI capabilities, listed in references/video.md.
1228
1278
  ---
1229
1279
 
1230
- ${re(e,t)}
1280
+ ${ae(t,e)}
1231
1281
 
1232
1282
  # ${r} video
1233
1283
 
@@ -1241,7 +1291,7 @@ one wastes a paid render. There is no \`video export\` subcommand.
1241
1291
 
1242
1292
  ## The flow
1243
1293
 
1244
- ${s}
1294
+ ${c}
1245
1295
 
1246
1296
  Then poll \`${n} video status <run-id>\` until it reports done.
1247
1297
 
@@ -1281,17 +1331,17 @@ ${n} video <sub> --help
1281
1331
  \`\`\`
1282
1332
 
1283
1333
  The catalog is authoritative and always current; this file is a snapshot of it.
1284
- `}function $l(t,e){return[{content:fr(t,e),name:"video"},{content:It(t,e),name:"deck-to-video"}]}import{chmodSync as Ov,existsSync as gi,mkdirSync as ui,rmSync as Dv,writeFileSync as pi}from"fs";import{homedir as Pl}from"os";import{basename as Nv,dirname as _v,join as Ve,relative as Uv,resolve as gn}from"path";var Ze=[{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 Lv={sonnet:"claude-sonnet-4.6",haiku:"claude-haiku-4.5",opus:"claude-opus-4.6"},qv=["permissionMode","skills","subagentType"];function jv(t,e){if(e!=="copilot")return t;let n=t.match(/^---\n([\s\S]*?)\n---\n/);if(!n)return Tl(t);let r=n[1],o=t.slice((n.index??0)+n[0].length);r=r.replace(/^(model:\s*)(\S+)([ \t]*)$/m,(s,c,u,f)=>`${c}${Lv[u]??u}${f}`);for(let s of qv)r=r.replace(new RegExp(`^${s}:[^
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}:[^
1285
1335
  ]*
1286
- ?`,"m"),"");r=r.replace(/\n+$/,"");let i=Tl(o);return`---
1336
+ ?`,"m"),"");r=r.replace(/\n+$/,"");let i=mu(o);return`---
1287
1337
  ${r}
1288
1338
  ---
1289
- ${i}`}function Tl(t){return t.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 Ol(t,e){let n=gn(t),r=gn(t,e);if(Uv(n,r).startsWith("..")||gn(r)!==r.replace(/\.\./g,""))throw new Error(`Invalid path: "${e}" would escape base directory`);return r}function Al(t,e,n,r,o){let i=Ve(t,"SKILL.md");if(ui(t,{recursive:!0}),pi(i,jv(e,r),"utf-8"),n&&n.length>0){let s=Ve(t,"references");ui(s,{recursive:!0});for(let c of n){let u=Ve(s,`${c.name}.md`);pi(u,c.content,"utf-8")}}for(let s of o??[]){let c=Ol(t,s.path);ui(_v(c),{recursive:!0}),pi(c,s.content,"utf-8"),s.executable&&Ov(c,493)}}function kr(t,e,n={},r,o){let i={installed:[],skipped:[],errors:[]},s=n.local?process.cwd():Pl();if(n.dir){let c=Nv(gn(n.dir)),u=Ze.find(f=>f.dir===c)?.provider;try{let f=gn(n.dir),h=Ol(f,Ve("skills",t));Al(h,e,r,u,o),i.installed.push(n.dir)}catch(f){i.errors.push(`${n.dir}: ${f instanceof Error?f.message:String(f)}`)}}else for(let c of Ze){let u=Ve(s,c.dir),f=Ve(u,"skills",t),h=Ve(f,"SKILL.md");if(gi(u)){if(gi(h)&&!n.force){i.skipped.push(c.name);continue}try{Al(f,e,r,c.provider,o),i.installed.push(c.name)}catch(v){i.errors.push(`${c.name}: ${v instanceof Error?v.message:String(v)}`)}}}return i}function xr(t,e={}){let n={removed:[],errors:[]},r=e.local?process.cwd():Pl();for(let o of Ze){let i=Ve(r,o.dir,"skills",t);if(gi(i))try{Dv(i,{recursive:!0}),n.removed.push(o.name)}catch(s){n.errors.push(`${o.name}: ${s instanceof Error?s.message:String(s)}`)}}return n}function Dl(){return Ze.map(t=>t.name)}function Rt(t){let{name:e,cmd:n}=t;return`---
1290
- name: ${e}-tts
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
1291
1341
  description: Text-to-speech generation. Convert text to natural speech with multiple providers (Gemini, ElevenLabs, OpenAI) and voices. Use for voiceovers, narration, accessibility.
1292
1342
  ---
1293
1343
 
1294
- # ${e} TTS (Text-to-Speech)
1344
+ # ${t} TTS (Text-to-Speech)
1295
1345
 
1296
1346
  Convert text to natural speech with multiple providers and voices.
1297
1347
 
@@ -1486,12 +1536,12 @@ ${n} tts generate \\
1486
1536
  2. **Voice matching** - Match voice style to content: Puck for upbeat, Charon for serious
1487
1537
  3. **Speed adjustment** - Use 0.9-0.95 for narration, 1.0-1.1 for casual
1488
1538
  4. **Multiple voiceovers** - Run \`${n} tts generate\` once per line and poll each run with \`${n} tts status <run-id>\`
1489
- `}function St(t){let{name:e,cmd:n}=t;return`---
1490
- name: ${e}-music
1539
+ `}function Ft(e){let{name:t,cmd:n}=e;return`---
1540
+ name: ${t}-music
1491
1541
  description: Generate music that follows a video's narration and final timing. Gemini plans the provider prompt on the backend.
1492
1542
  ---
1493
1543
 
1494
- # ${e} Video Music
1544
+ # ${t} Video Music
1495
1545
 
1496
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.
1497
1547
 
@@ -1512,12 +1562,12 @@ ${n} music status <request-id>
1512
1562
  \`\`\`
1513
1563
 
1514
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.
1515
- `}function Et(t){let{name:e,cmd:n}=t;return`---
1516
- name: ${e}-sfx
1565
+ `}function Gt(e){let{name:t,cmd:n}=e;return`---
1566
+ name: ${t}-sfx
1517
1567
  description: Generate one sound effect aligned with a final visual event and narration. Gemini plans the provider prompt on the backend.
1518
1568
  ---
1519
1569
 
1520
- # ${e} Video Sound Effects
1570
+ # ${t} Video Sound Effects
1521
1571
 
1522
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.
1523
1573
 
@@ -1550,12 +1600,12 @@ ${n} sfx status <request-id>
1550
1600
  \`\`\`
1551
1601
 
1552
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.
1553
- `}function $t(t){let{name:e,cmd:n}=t;return`---
1554
- name: ${e}-mix
1603
+ `}function Kt(e){let{name:t,cmd:n}=e;return`---
1604
+ name: ${t}-mix
1555
1605
  description: Audio mixing for video production. Combine video with voiceover and background music. Supports volume control, fade effects, and multiple audio tracks.
1556
1606
  ---
1557
1607
 
1558
- # ${e} Audio Mixing
1608
+ # ${t} Audio Mixing
1559
1609
 
1560
1610
  Mix video with voiceover and background music.
1561
1611
 
@@ -1700,12 +1750,12 @@ ${n} mix status <request-id>
1700
1750
  2. **Music selection** - Choose music that doesn't compete with voice frequency.
1701
1751
  3. **Consistent levels** - Keep voice at 100%, adjust music only.
1702
1752
  4. **File sizes** - Use \`--no-wait\` for large files to avoid timeout.
1703
- `}function Tt(t){let{name:e,cmd:n}=t;return`---
1704
- name: ${e}-image
1705
- description: Image search across the web and licensed stock, plus AI image generation. Find licensed photos to publish, web images for specific real-world subjects, or generate a custom image. For videos, presentations, marketing.
1753
+ `}function Wt(e){let{name:t,cmd:n}=e;return`---
1754
+ name: ${t}-image
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.
1706
1756
  ---
1707
1757
 
1708
- # ${e} Image Commands
1758
+ # ${t} Image Commands
1709
1759
 
1710
1760
  Search images (web + licensed stock) and generate AI images.
1711
1761
 
@@ -1720,6 +1770,13 @@ ${n} image search -q "mountain landscape" --source stock
1720
1770
 
1721
1771
  # Generate AI image
1722
1772
  ${n} image generate -p "futuristic city at sunset" -o city.png --yes
1773
+
1774
+ # Generate an image that keeps a real person's face, from a local photo
1775
+ ${n} image generate \\
1776
+ -p "The person in the identity reference, seated at a workshop bench, warm window light, shallow depth of field" \\
1777
+ --reference-image identity=./photos/founder.jpg \\
1778
+ --provider google-ai --model gemini-3-pro-image \\
1779
+ -o founder-at-bench.png --yes
1723
1780
  \`\`\`
1724
1781
 
1725
1782
  ---
@@ -1755,7 +1812,10 @@ default queries both and tags every result with its \`source\`.
1755
1812
 
1756
1813
  ### \`image generate\`
1757
1814
 
1758
- Generate an AI image from a text prompt.
1815
+ Generate an AI image from a text prompt. Use \`--purpose\` to pass explicit intent:
1816
+ \`general\`, \`draft\`, \`infographic\`, \`brand-max\`, or \`vector\`.
1817
+ Omission uses the general route. A word such as \u201Cinfographic\u201D in the prompt does
1818
+ not classify the purpose; Services owns model selection for the supplied intent.
1759
1819
 
1760
1820
  \`\`\`bash
1761
1821
  ${n} image generate <prompt> [options]
@@ -1767,13 +1827,111 @@ ${n} image generate <prompt> [options]
1767
1827
  **Options:**
1768
1828
  | Option | Description | Default |
1769
1829
  |--------|-------------|---------|
1830
+ | \`--reference-image <label=path-or-url...>\` | Images the generation must follow. Repeatable and variadic. Each value is a **local file path** (uploaded for you and turned into a public URL) or an **already-public HTTP(S) URL**. | - |
1770
1831
  | \`-o, --output <path>\` | Output file path | - |
1771
- | \`--width <pixels>\` | Image width | host default |
1772
- | \`--height <pixels>\` | Image height | host default |
1832
+ | \`--width <pixels>\` | Requested image width \u2014 see the note below | host default |
1833
+ | \`--height <pixels>\` | Requested image height \u2014 see the note below | host default |
1834
+ | \`--idempotency-key <key>\` | Stable retry key for the run and its reference uploads | new UUID per run |
1773
1835
  | \`--no-wait\` | Return the request id without downloading; cannot be combined with \`--output\` | - |
1774
1836
  | \`--yes\` | Approve generation | required |
1775
1837
  | \`-f, --format <format>\` | Output: human, json, quiet | \`human\` |
1776
1838
 
1839
+ #### Reference images \u2014 how to lock an identity
1840
+
1841
+ \`--reference-image\` is how a generated image keeps a **real** face, product or
1842
+ logo instead of inventing a lookalike. Pass a photo of the person and say in the
1843
+ prompt that the subject is the identity reference.
1844
+
1845
+ \`\`\`bash
1846
+ ${n} image generate \\
1847
+ -p "The person in the identity reference, in a navy jacket, on a bright factory floor, editorial photography" \\
1848
+ --reference-image identity=./photos/founder.jpg \\
1849
+ -o founder-on-floor.png --yes
1850
+ \`\`\`
1851
+
1852
+ **Local file or URL \u2014 both work, and you never upload by hand.**
1853
+
1854
+ - A value that resolves to an existing file is uploaded through the CLI upload
1855
+ endpoint and becomes a public URL automatically. Its \`mediaType\` is derived
1856
+ from the file (a \`.jpg\` is sent as \`image/jpeg\`) and simply omitted when the
1857
+ type is not recognised \u2014 a \`.heic\` off a phone uploads normally and declares
1858
+ no type rather than a guessed one.
1859
+ - Anything else must be an \`http://\` or \`https://\` URL and is passed straight
1860
+ through.
1861
+ - A file positively identified as something other than an image (\`.pdf\`,
1862
+ \`.mp4\`, \u2026) is refused **before** the upload and before any credits are spent,
1863
+ with an error naming the media type it found.
1864
+ A missing path or a non-HTTP scheme is refused the same way. Nothing is ever
1865
+ silently dropped \u2014 a reference either reaches the model or the command fails.
1866
+
1867
+ **Labels.** Prefix a value with \`label=\` to say what the reference is for:
1868
+ \`identity=\`, \`style=\`, \`product=\`, \`logo=\`. The label reaches the generator,
1869
+ which weighs an \`identity\` reference differently from a mood board. It is
1870
+ optional. An existing file whose own name contains \`=\` is still read as a path,
1871
+ so \`--reference-image ./style=hero.png\` uploads that file rather than parsing a
1872
+ label.
1873
+
1874
+ **Repeat it, or pass several values at once.** Both forms work and order is
1875
+ preserved:
1876
+
1877
+ \`\`\`bash
1878
+ ${n} image generate -p "The founder holding the product, studio lighting" \\
1879
+ --reference-image identity=./photos/founder.jpg \\
1880
+ --reference-image product=./photos/device.png \\
1881
+ --reference-image logo=https://cdn.example.com/logo.png \\
1882
+ --provider google-ai --model gemini-3-pro-image \\
1883
+ -o hero.png --yes
1884
+ \`\`\`
1885
+
1886
+ There is no reference count limit in this command. If the routed provider has
1887
+ one, its rejection comes back as the error \u2014 the list is never quietly
1888
+ shortened.
1889
+
1890
+ **Fidelity is a property of the model, not of the reference.** Measured against
1891
+ production with the same photo:
1892
+
1893
+ | Routing | Result |
1894
+ |---|---|
1895
+ | Auto-routed (\`gemini-3.1-flash-lite-image\`) | A person who **resembles** the reference. Usually a disappointment when a specific likeness was the point. |
1896
+ | \`google-ai\` / \`gemini-3-pro-image\` | **Recognisably the same person** \u2014 earrings, hair parting, freckles, brow shape. |
1897
+
1898
+ \u26A0\uFE0F **\`--provider\` / \`--model\` are flag-gated, and the server drops them
1899
+ silently.** \`createImageOperation\` clears both unless the workspace holds the
1900
+ internal \`image-model-override\` flag (OFF by default, IP protection). On an
1901
+ ordinary workspace the pin below has **no effect**: the request is auto-routed,
1902
+ credits are spent, and the result is the lookalike rather than the person. The
1903
+ CLI warns whenever you pass either flag, because the drop itself is silent.
1904
+
1905
+ So, on a workspace that has the flag:
1906
+
1907
+ \`\`\`bash
1908
+ ${n} image generate \\
1909
+ -p "The person in the identity reference, in a navy jacket, on a bright factory floor, editorial photography" \\
1910
+ --reference-image identity=./photos/founder.jpg \\
1911
+ --provider google-ai --model gemini-3-pro-image \\
1912
+ -o founder-on-floor.png --yes
1913
+ \`\`\`
1914
+
1915
+ Without the flag, pass the reference anyway \u2014 it is still honoured, and it is
1916
+ still far better than describing the face in prose \u2014 but tell the user the
1917
+ likeness will be close rather than exact, and do not promise otherwise.
1918
+
1919
+ **Never distort a reference before you pass it.** A face cropped to a different
1920
+ aspect ratio is reproduced as that distorted face \u2014 a photo squeezed ~30% wider
1921
+ comes back as a wider person. The CLI uploads your file byte-for-byte and never
1922
+ resizes it; if you crop first, keep the aspect ratio.
1923
+
1924
+ **\`--width\` / \`--height\` do not change the output size on this path.**
1925
+ Measured: they and \`size\` are ignored. The auto-routed model returns 1024 on the
1926
+ long side. \`resolution\` (up to 2K \u2192 2048x1152 at 16:9) IS honoured by
1927
+ \`gemini-3-pro-image\`, but \`image generate\` has no flag for it today \u2014 use
1928
+ \`visual-abstract create\` when the canvas matters, and do not promise a user an
1929
+ exact pixel size from this command.
1930
+
1931
+ **\`--provider\` takes a provider, not a model name.** \`google-ai\` is a provider;
1932
+ \`gemini-3-pro-image\` is a model. A value like \`nano-banana-pro\` is neither and
1933
+ is rejected upstream with HTTP 400.
1934
+
1777
1935
  ---
1778
1936
 
1779
1937
  ## Search Tips
@@ -1818,6 +1976,14 @@ ${n} image search -q "minimal workspace desk laptop white"
1818
1976
  ### AI Image Generation
1819
1977
 
1820
1978
  \`\`\`bash
1979
+ # Identity locked from a local photo \u2014 the reference is uploaded for you
1980
+ ${n} image generate \\
1981
+ -p "The person in the identity reference, in a navy jacket, on a bright factory floor, editorial photography" \\
1982
+ --reference-image identity=./photos/founder.jpg \\
1983
+ --provider google-ai --model gemini-3-pro-image \\
1984
+ -o founder-on-floor.png \\
1985
+ --yes
1986
+
1821
1987
  # Basic generation
1822
1988
  ${n} image generate -p "futuristic city skyline at sunset" -o city.png --yes
1823
1989
 
@@ -1897,11 +2063,12 @@ different job with its own canonical operation: \`${n} visual-abstract create\`.
1897
2063
  Reach for it whenever the output has panels, headers, labels or a page
1898
2064
  structure \u2014 a storyboard sheet, a spec page, a comparison board, a one-pager.
1899
2065
 
1900
- It takes the things a layout needs and \`image generate\` has no field for:
2066
+ It takes the things a layout needs and \`image generate\` has no field for
2067
+ (references aside \u2014 \`image generate --reference-image\` covers those):
1901
2068
 
1902
2069
  | Option | Why it matters here |
1903
2070
  |---|---|
1904
- | \`--reference-url <url...>\` | Up to three visual references. **The only image route that accepts them** \u2014 this is how a product, a package or a face stays the same across a sheet. |
2071
+ | \`--reference-url <url...>\` | Up to three visual references, URLs only. (\`image generate --reference-image\` also takes references, and additionally accepts local file paths.) |
1905
2072
  | \`--preset <preset>\` | The page archetype, rather than describing one in prose. |
1906
2073
  | \`--aspect <ratio>\` | \`1:1\`, \`16:9\`, \`9:16\`, \`4:3\`, \`3:4\`. |
1907
2074
  | \`--branding-id <id>\` | Palette and type from a stored brand instead of hand-written hex. |
@@ -1951,12 +2118,11 @@ caption rows are part of the pixels. Bind one as a \`first-frame\` and the
1951
2118
  caption goes into the render with it. A sheet is for a person to approve; frames
1952
2119
  for video are generated separately, without any text on them.
1953
2120
 
1954
- **Through \`image generate\`, every panel is drawn independently.** That command
1955
- takes a prompt and nothing else \u2014 no field for a reference image \u2014 so the model
1956
- has no anchor for a face, a product or a package across panels beyond your
1957
- words, and the same subject drifts between them. When a specific likeness has to
1958
- hold, use \`visual-abstract create --reference-url\`, which is the one image
1959
- route that accepts references.
2121
+ **Anchor a recurring subject with a reference.** Words alone let a face, a
2122
+ product or a package drift between panels. Both image routes take references:
2123
+ \`image generate --reference-image identity=./face.jpg\` (local paths or URLs)
2124
+ and \`visual-abstract create --reference-url <url>\` (URLs, up to three). Pass
2125
+ the subject once as a reference and the likeness holds.
1960
2126
 
1961
2127
  Discuss the spec with the user before spending on it, for the same reason a
1962
2128
  storyboard is read before it is pinned: the layout, the copy and the concept are
@@ -1972,12 +2138,17 @@ things you wrote on their behalf.
1972
2138
  4. **JSON for automation** - Parse results programmatically
1973
2139
  5. **Simple generations** - one subject, one background: a sentence is enough.
1974
2140
  For anything carrying a layout, write a spec instead \u2014 see above.
1975
- `}function At(t){let{name:e,cmd:n}=t;return`---
1976
- name: ${e}-video-search
2141
+ 6. **A real person, product or logo** - pass it as
2142
+ \`--reference-image identity=./photo.jpg\` rather than describing it. An exact
2143
+ likeness additionally needs \`--provider google-ai --model gemini-3-pro-image\`
2144
+ **and** the \`image-model-override\` flag on the workspace; without the flag
2145
+ the server drops the pin and the likeness is close, not exact.
2146
+ `}function Jt(e){let{name:t,cmd:n}=e;return`---
2147
+ name: ${t}-video-search
1977
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.
1978
2149
  ---
1979
2150
 
1980
- # ${e} Video Search
2151
+ # ${t} Video Search
1981
2152
 
1982
2153
  Find video: licensed clips you can download, or web videos you can embed.
1983
2154
 
@@ -2169,12 +2340,12 @@ ${n} video find "city timelapse" --orientation landscape -n 10
2169
2340
  3. **Preview first** - Use preview URLs to check quality
2170
2341
  4. **License** - Verify license for commercial use
2171
2342
  5. **JSON export** - Save searches for batch processing
2172
- `}function Pt(t){let{name:e,cmd:n}=t;return`---
2173
- name: ${e}-scrape
2343
+ `}function zt(e){let{name:t,cmd:n}=e;return`---
2344
+ name: ${t}-scrape
2174
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.
2175
2346
  ---
2176
2347
 
2177
- # ${e} URL Scraping
2348
+ # ${t} URL Scraping
2178
2349
 
2179
2350
  Extract content from URLs for analysis and context.
2180
2351
 
@@ -2359,12 +2530,12 @@ ${n} scrape https://blog.example.com -f quiet | ${n} create "Blog Summary"
2359
2530
  3. **Use JSON** - For programmatic processing of results
2360
2531
  4. **Combine sources** - Scrape multiple URLs for comprehensive context
2361
2532
  5. **Token count** - Check token usage for large documents
2362
- `}function Cr(t){let{name:e,cmd:n}=t;return`---
2363
- name: ${e}-branding
2533
+ `}function Hr(e){let{name:t,cmd:n}=e;return`---
2534
+ name: ${t}-branding
2364
2535
  description: Brand profile management. Extract branding from websites, manage saved brands, apply consistent styling to presentations.
2365
2536
  ---
2366
2537
 
2367
- # ${e} Branding Management
2538
+ # ${t} Branding Management
2368
2539
 
2369
2540
  Manage brand profiles for consistent styling across presentations.
2370
2541
 
@@ -2469,12 +2640,12 @@ ${n} branding set-default abc123
2469
2640
  2. **If extraction fails** \u2014 Proceed without branding. Do not manually create brand assets.
2470
2641
  3. **Set default** \u2014 If you mostly work with one brand, set it as default.
2471
2642
  4. **Override** \u2014 Use \`--brand\` flag to override default for specific presentations.
2472
- `}function Ot(t){let{name:e,cmd:n}=t,r=e.toUpperCase().replace(/[^A-Z0-9]/g,"_");return`---
2473
- name: ${e}-config
2643
+ `}function Ht(e){let{name:t,cmd:n}=e,r=t.toUpperCase().replace(/[^A-Z0-9]/g,"_");return`---
2644
+ name: ${t}-config
2474
2645
  description: CLI configuration management. Set API keys, team IDs, custom API URLs. Verify authentication status.
2475
2646
  ---
2476
2647
 
2477
- # ${e} Configuration
2648
+ # ${t} Configuration
2478
2649
 
2479
2650
  Manage CLI settings and authentication.
2480
2651
 
@@ -2630,71 +2801,70 @@ ${n} config show --verify # Test API key
2630
2801
  \`\`\`bash
2631
2802
  ${n} config set team-id <correct-team-id>
2632
2803
  \`\`\`
2633
- `}var Vv=["main","video","presentation","presentation-video","presentation-edit","branding","agents"];function X(t,e){return t===void 0||t==="main"?Vv.some(n=>n===e):t===e}var Dt=["main","video","presentation","presentation-video","presentation-edit","tts","music","sfx","mix","image","video-search","scrape","branding","agents","config"],Rr=["standalone","studio"],Nl={cmd:p.commands[0],pkg:p.packageName,url:p.apiUrl,name:p.name},Nt=new Mv("skill").description(`Manage ${p.displayName} skills for AI coding assistants`).addHelpText("after",`
2634
- ${Z.bold("Skill Types:")}
2635
- ${Z.cyan("main")} Intent router and capability index
2636
- ${Z.cyan("presentation")} Create, import, inspect, and export decks
2637
- ${Z.cyan("presentation-video")} Turn an existing deck into an MP4
2638
- ${Z.cyan("branding")} Manage private and team brand profiles
2639
- ${Z.cyan("agents")} Manage scheduled Agents and team roster visibility
2640
- ${Z.cyan("video")} Build a video from scratch (no deck)
2641
- ${Z.cyan("presentation-edit")} Legacy Studio editing guide
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
2642
2813
 
2643
- ${Z.bold("Reference-only types:")} tts, music, sfx, mix, image, video-search, scrape, config
2814
+ ${ee.bold("Reference-only types:")} tts, music, sfx, mix, image, video-search, scrape, config
2644
2815
 
2645
- ${Z.bold("Examples:")}
2646
- $ ${p.commands[0]} skill install ${Z.gray("# core suite")}
2816
+ ${ee.bold("Examples:")}
2817
+ $ ${p.commands[0]} skill install ${ee.gray("# core suite")}
2647
2818
  $ ${p.commands[0]} skill install presentation-video
2648
2819
  $ ${p.commands[0]} skill install branding --dir ~/.claude
2649
2820
  $ ${p.commands[0]} skill install agents
2650
2821
  $ ${p.commands[0]} skill show presentation
2651
- `);Nt.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(t,e)=>{e.mode&&!Rr.includes(e.mode)&&(a(`Invalid mode: ${e.mode}. Must be one of: ${Rr.join(", ")}`),process.exit(1));let n={...Nl,mode:e.mode},r=[];t&&!Dt.includes(t)&&(a(`Invalid skill type: ${t}. Must be one of: ${Dt.join(", ")}`),process.exit(1));let o=await Vt();o.source==="snapshot"&&(V(`Live capability catalog unavailable (${o.reason??"unknown reason"}) \u2014 generating from the snapshot baked into this CLI.`),console.log(Z.gray(` Run \`${p.commands[0]} login\` then re-run with --force to regenerate from the live catalog.`)));let i=[...kl(n,o,{branding:Cr(n)}),{name:"tts",content:Rt(n)},{name:"music",content:St(n)},{name:"sfx",content:Et(n)},{name:"mix",content:$t(n)},{name:"image",content:Tt(n)},{name:"video-search",content:At(n)},{name:"scrape",content:Pt(n)},{name:"config",content:Ot(n)}];X(t,"main")&&r.push({name:p.name,content:br(n,o),references:i}),X(t,"video")&&r.push({content:Ir(n,o),name:`${p.name}-video`,references:$l(n,o)}),X(t,"presentation")&&r.push({name:`${p.name}-presentation`,content:vr(n,o),references:xt(n,o,"presentation"),files:Ct(n,o,"presentation")}),X(t,"presentation-video")&&r.push({name:`${p.name}-presentation-video`,content:Ie(n,o,"presentation-video"),references:xt(n,o,"presentation-video"),files:Ct(n,o,"presentation-video")}),X(t,"presentation-edit")&&r.push({name:`${p.name}-presentation-edit`,content:wr(n)}),X(t,"branding")&&r.push({name:`${p.name}-branding`,content:Ie(n,o,"branding"),references:xt(n,o,"branding"),files:Ct(n,o,"branding")}),X(t,"agents")&&r.push({name:`${p.name}-agents`,content:Ie(n,o,"agents"),references:xt(n,o,"agents"),files:Ct(n,o,"agents")}),X(t,"tts")&&r.push({name:`${p.name}-tts`,content:Rt(n)}),X(t,"music")&&r.push({name:`${p.name}-music`,content:St(n)}),X(t,"sfx")&&r.push({name:`${p.name}-sfx`,content:Et(n)}),X(t,"mix")&&r.push({name:`${p.name}-mix`,content:$t(n)}),X(t,"image")&&r.push({name:`${p.name}-image`,content:Tt(n)}),X(t,"video-search")&&r.push({name:`${p.name}-video-search`,content:At(n)}),X(t,"scrape")&&r.push({name:`${p.name}-scrape`,content:Pt(n)}),X(t,"config")&&r.push({name:`${p.name}-config`,content:Ot(n)}),console.log();for(let s of r){w(`Installing ${s.name}...`);let c=kr(s.name,s.content,{dir:e.dir,local:e.local,force:e.force},s.references,s.files);if(c.installed.length>0&&(x(`${s.name} installed successfully`),S(" Installed to",c.installed.join(", "))),c.skipped.length>0&&(w(` Skipped (already exists): ${c.skipped.join(", ")}`),console.log(Z.gray(" Use --force to overwrite"))),c.errors.length>0)for(let u of c.errors)a(` ${u}`);c.installed.length===0&&c.skipped.length===0&&c.errors.length===0&&(w(" No supported AI coding assistants detected"),console.log(Z.gray(` Supported editors: ${Dl().join(", ")}`)),console.log(Z.gray(" Use --dir <path> to install to a specific directory"))),console.log()}});Nt.command("show").description("Display skill content").argument("[type]","Skill type (default: main)").option("-m, --mode <mode>","Skill mode: standalone or studio","standalone").action(async(t="main",e)=>{e.mode&&!Rr.includes(e.mode)&&(a(`Invalid mode: ${e.mode}. Must be one of: ${Rr.join(", ")}`),process.exit(1));let n={...Nl,mode:e.mode},r=await Vt(),i={main:()=>br(n,r),video:()=>Ir(n,r),presentation:()=>vr(n,r),"presentation-video":()=>Ie(n,r,"presentation-video"),"presentation-edit":()=>wr(n),tts:()=>Rt(n),music:()=>St(n),sfx:()=>Et(n),mix:()=>$t(n),image:()=>Tt(n),"video-search":()=>At(n),scrape:()=>Pt(n),branding:()=>Ie(n,r,"branding"),agents:()=>Ie(n,r,"agents"),config:()=>Ot(n)}[t];i?console.log(i()):(a(`Invalid skill type: ${t}. Must be one of: ${Dt.join(", ")}`),process.exit(1))});Nt.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(t,e)=>{let n=[];t&&!Dt.includes(t)&&(a(`Invalid skill type: ${t}. Must be one of: ${Dt.join(", ")}`),process.exit(1)),(!t||t==="main")&&n.push(p.name),(!t||t==="video")&&n.push(`${p.name}-video`),(!t||t==="presentation")&&n.push(`${p.name}-presentation`),(!t||t==="presentation-video")&&n.push(`${p.name}-presentation-video`),(!t||t==="presentation-edit")&&n.push(`${p.name}-presentation-edit`),(!t||t==="tts")&&n.push(`${p.name}-tts`),(!t||t==="music")&&n.push(`${p.name}-music`),(!t||t==="sfx")&&n.push(`${p.name}-sfx`),(!t||t==="mix")&&n.push(`${p.name}-mix`),(!t||t==="image")&&n.push(`${p.name}-image`),(!t||t==="video-search")&&n.push(`${p.name}-video-search`),(!t||t==="scrape")&&n.push(`${p.name}-scrape`),(!t||t==="branding")&&n.push(`${p.name}-branding`),(!t||t==="agents")&&n.push(`${p.name}-agents`),(!t||t==="config")&&n.push(`${p.name}-config`),console.log();for(let r of n){let o=xr(r,{local:e.local});if(o.removed.length>0?(x(`${r} uninstalled`),S(" Removed from",o.removed.join(", "))):w(` ${r} not found`),o.errors.length>0)for(let i of o.errors)V(` Failed to remove: ${i}`)}console.log()});import{Command as Fv}from"commander";import fn from"chalk";var _l=new Fv("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)",b("--format",["table","json"]),"table").option("--limit <n>","Maximum templates to list","25").action(async(t,e)=>{await y();try{let n=Number.parseInt(e.limit??"25",10),{templates:r}=await na(t,Number.isFinite(n)?n:25);if(r.length===0){e.format==="json"?console.log(JSON.stringify([])):w("No templates found");return}if(e.format==="json"){console.log(JSON.stringify(r,null,2));return}for(let o of r){let i=[o.isDefault?fn.green("default"):null,o.category??null,o.recommendedModes?.length?`modes: ${o.recommendedModes.join("/")}`:null].filter(Boolean).join(" \xB7 ");console.log(`${fn.bold(o.name)} ${fn.gray(o.id)}${i?`
2652
- ${fn.gray(i)}`:""}`)}console.log(),console.log(fn.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{Command as Bv}from"commander";import fi from"chalk";var Ul=new Bv("whoami").description("Show current user and team information").option("-f, --format <format>","Output format (human, json)",b("--format",["human","json"]),"human").action(async t=>{await y();try{let e=await we();if(Mr(),t.format==="json"){console.log(JSON.stringify(e,null,2));return}me("User"),console.log(),S("Email",e.user.email),e.user.username&&S("Username",e.user.username),(e.user.firstName||e.user.lastName)&&S("Name",[e.user.firstName,e.user.lastName].filter(Boolean).join(" "));let n=e.authType==="apiKey"?"API Key":e.authType==="oauth"?"OAuth":"Session";if(S("Auth Type",n),e.currentTeam&&(console.log(),me("Current Team"),console.log(),S("ID",e.currentTeam.id),S("Name",e.currentTeam.name),S("Plan",e.currentTeam.planName),S("Role",e.currentTeam.isOwner?"Owner":"Member")),e.teams.length>1){console.log(),me("All Teams"),console.log();for(let r of e.teams){let o=r.isCurrent?fi.green(" (current)"):"";console.log(` ${fi.bold(r.name)}${o}`),console.log(fi.gray(` ID: ${r.id} | Plan: ${r.planName} | Role: ${r.role}`))}}console.log()}catch(e){a(e instanceof Error?e.message:String(e)),process.exit(e.exitCode??1)}});function Ll(t){return t[0]==="--"?t.slice(1):t}import hi from"chalk";function yi(t){t.configureOutput({outputError:(e,n)=>{n(hi.red(e));let r=/unknown option '(-{1,2}[^'\s=]+)/.exec(e);if(!r)return;let o=Wv(t,r[1]);o&&n(hi.yellow(`Did you mean '${o}'?
2653
- `)),n(hi.gray(`Run '${Gv(t)} --help' to see the accepted options.
2654
- `))}});for(let e of t.commands)yi(e)}function Gv(t){let e=[],n=t;for(;n;)e.unshift(n.name()),n=n.parent;return e.join(" ")}function Wv(t,e){let n,r=Number.POSITIVE_INFINITY;for(let i of t.options)if(!i.hidden)for(let s of[i.short,i.long]){if(!s)continue;let c=bi(e,s);c<r&&(r=c,n=i.flags)}let o=e.startsWith("--")?2:1;return n!==void 0&&r<=o?n:void 0}function bi(t,e){if(t===e)return 0;if(t.length===0)return e.length;if(e.length===0)return t.length;let n=Array.from({length:e.length+1},(r,o)=>o);for(let r=1;r<=t.length;r++){let o=[r];for(let i=1;i<=e.length;i++){let s=t[r-1]===e[i-1]?0:1;o[i]=Math.min(o[i-1]+1,n[i]+1,n[i-1]+s)}n=o}return n[e.length]}var Jv="0.3.23",W=new Kv,L=p.commands[0];W.name(L).description(`${p.displayName} CLI \u2014 presentations, videos, avatars, audio, branding, media and research`).version(Jv,"-v, --version","Show version number").option("--debug","Enable debug logging").option("--no-color","Disable colored output");W.addCommand(Va);hl(W);W.addCommand(Sn);W.addCommand(Za);W.addCommand(_l);W.addCommand(Ya);W.addCommand(Ja);W.addCommand(Ul);W.addCommand(os);W.addCommand(is);W.addCommand(Ka);W.addCommand(Nt);W.addCommand(Dn);var ql=Xa();ql.commands.length>0&&W.addCommand(ql);function zv(t){let e=t.toLowerCase(),n=e.length<=4?1:2,r,o=Number.POSITIVE_INFINITY;for(let i of W.commands)for(let s of[i.name(),...i.aliases()]){let c=bi(e,s.toLowerCase());c<o&&(o=c,r=i.name())}return r!==void 0&&o<=n?r:void 0}W.on("command:*",t=>{let e=String(t[0]);console.error(B.red(`Error: Unknown command '${e}'`)),console.error();let n=zv(e);n&&console.error(`Did you mean '${n}'?`),console.error(`Run '${L} --help' to see available commands.`),console.error(`Run '${L} capabilities' for the full list of callable capabilities.`),process.exit(1)});W.addHelpText("after",`
2655
- ${B.bold("Start here:")}
2656
- $ ${L} capabilities ${B.gray("# every capability + its exact command path")}
2657
- $ ${L} <group> --help ${B.gray("# drill into any command group above")}
2658
-
2659
- ${B.bold("Common tasks:")}
2660
- ${B.gray("Make a presentation")}
2661
- $ ${L} create "<topic>" --context "..."
2662
- ${B.gray("Turn a finished presentation into an MP4 (narration + avatar)")}
2663
- $ ${L} presentation video <slug>
2664
- ${B.gray("Export a presentation to HTML, PDF or PPTX")}
2665
- $ ${L} export <id-or-slug> -o deck.html
2666
- ${B.gray("Make a video from scratch (no deck)")}
2667
- $ ${L} video storyboard create ${B.gray("then")} $ ${L} video create
2668
- ${B.gray("Regenerate one slide's narration in a video draft")}
2669
- $ ${L} presentation video-narration <project-id>
2670
- ${B.gray("Generate speaker notes")}
2671
- $ ${L} presentation speaker-notes <presentation-id>
2672
- ${B.gray("Import a PowerPoint")}
2673
- $ ${L} presentation import
2674
- ${B.gray("Extract a brand identity from a URL")}
2675
- $ ${L} branding extract <url>
2676
- ${B.gray("Voiceover, music, sound effects")}
2677
- $ ${L} tts generate | ${L} music generate | ${L} sfx generate
2678
- ${B.gray("Find stock footage / images")}
2679
- $ ${L} video find | ${L} image search
2680
- ${B.gray("Read a web page or a YouTube transcript")}
2681
- $ ${L} scrape <url> | ${L} transcript <url>
2682
-
2683
- ${B.bold("Two different video pipelines:")}
2684
- '${L} presentation video ...' renders an EXISTING deck to MP4.
2685
- '${L} video ...' builds a video from a storyboard or brief with stock
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
2686
2856
  and generated footage \u2014 no deck involved.
2687
2857
 
2688
- ${B.bold("Authentication:")}
2689
- Run '${L} login' to authenticate (recommended).
2858
+ ${G.bold("Authentication:")}
2859
+ Run '${j} login' to authenticate (recommended).
2690
2860
  Or set CC_SLIDES_API_KEY environment variable for API key auth.
2691
2861
 
2692
- ${B.bold("Note:")}
2862
+ ${G.bold("Note:")}
2693
2863
  The command list above is not always complete: feature-flag-gated commands
2694
- (the '${L} derive' subcommands) appear only after '${L} login'
2695
- and '${L} config refresh' have cached your feature access. Run
2696
- '${L} capabilities' for the authoritative list.
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.
2697
2867
 
2698
- ${B.bold("More Info:")}
2699
- ${B.blue(p.docsUrl)}
2700
- `);yi(W);W.parse(Ll(process.argv.slice(2)),{from:"user"});
2868
+ ${G.bold("More Info:")}
2869
+ ${G.blue(p.docsUrl)}
2870
+ `);da(J);J.parse(bu(process.argv.slice(2)),{from:"user"});