publishport-opencli 1.0.19 → 1.0.21

package/dist/src/download/index.js

@@ -1,7 +1,7 @@
-import{spawn as R}from"node:child_process";import*as W from"node:fs";import*as H from"node:path";import*as E from"node:os";import{Readable as v,Transform as U}from"node:stream";import{pipeline as y}from"node:stream/promises";import{URL as _}from"node:url";import{isBinaryInstalled as T}from"../external.js";import{getErrorMessage as L}from"../errors.js";import{fetchWithNodeNetwork as x}from"../node-network.js";import{log as g}from"../logger.js";export function checkYtdlp(){return T("yt-dlp")}const k=["youtube.com","youtu.be","bilibili.com","twitter.com","x.com","tiktok.com","vimeo.com","twitch.tv"];function F(K){let J;try{J=new _(K).hostname.toLowerCase()}catch{return!1}return k.some((Q)=>J===Q||J.endsWith(`.${Q}`))}const f=new Set([".jpg",".jpeg",".png",".gif",".webp",".svg",".ico",".bmp",".avif"]),P=new Set([".mp4",".webm",".avi",".mov",".mkv",".flv",".m3u8",".ts"]),m=new Set([".html",".htm",".json",".xml",".txt",".md",".markdown"]);export function detectContentType(K,J){if(J){if(J.startsWith("image/"))return"image";if(J.startsWith("video/"))return"video";if(J.startsWith("text/")||J.includes("json")||J.includes("xml"))return"document"}let Q="";try{Q=H.extname(new _(K).pathname).toLowerCase()}catch{return"binary"}if(f.has(Q))return"image";if(P.has(Q))return"video";if(F(K))return"video";if(m.has(Q))return"document";return"binary"}export function requiresYtdlp(K){return F(K)}export async function httpDownload(K,J,Q={},Z=0){const{cookies:$,headers:Y={},timeout:z=30000,onProgress:q,maxRedirects:w=10}=Q,A={"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",...Y};if($)A.Cookie=$;const D=`${J}.tmp`,M=async()=>{try{await W.promises.rm(D,{force:!0})}catch{}},C=new AbortController,X=setTimeout(()=>C.abort(),z);try{const B=await x(K,{headers:A,signal:C.signal,redirect:"manual"});clearTimeout(X);if(B.status>=300&&B.status<400){const V=B.headers.get("location");if(V){if(Z>=w)return{success:!1,size:0,error:`Too many redirects (> ${w})`};const b=resolveRedirectUrl(K,V),I=new _(K).hostname,S=new _(b).hostname,O=I===S?Q:{...Q,cookies:void 0,headers:u(Q.headers)};return httpDownload(b,J,O,Z+1)}}if(B.status!==200)return{success:!1,size:0,error:`HTTP ${B.status}`};if(!B.body)return{success:!1,size:0,error:"Empty response body"};const j=parseInt(B.headers.get("content-length")||"0",10);let G=0;const N=new U({transform(V,b,I){G+=V.length;if(q)q(G,j);I(null,V)}});try{await W.promises.mkdir(H.dirname(J),{recursive:!0});await y(v.fromWeb(B.body),N,W.createWriteStream(D));await W.promises.rename(D,J);return{success:!0,size:G}}catch(V){await M();return{success:!1,size:0,error:L(V)}}}catch(B){clearTimeout(X);await M();return{success:!1,size:0,error:B instanceof Error?B.message:String(B)}}}export function resolveRedirectUrl(K,J){return new _(J,K).toString()}function u(K){if(!K)return K;return Object.fromEntries(Object.entries(K).filter(([J])=>J.toLowerCase()!=="cookie"))}export function exportCookiesToNetscape(K,J){const Q=["# Netscape HTTP Cookie File","# https://curl.se/docs/http-cookies.html","# This is a generated file!  Do not edit.",""];for(const $ of K){const Y=$.domain.startsWith(".")?$.domain:`.${$.domain}`,z="TRUE",q=$.path||"/",w=$.secure?"TRUE":"FALSE",A=typeof $.expirationDate==="number"&&$.expirationDate>0?Math.floor($.expirationDate):Math.floor(Date.now()/1000)+31536000,D=$.name.replace(/[\t\n\r]/g,""),M=$.value.replace(/[\t\n\r]/g,"");Q.push(`${Y}	${z}	${q}	${w}	${A}	${D}	${M}`)}W.mkdirSync(H.dirname(J),{recursive:!0});let Z;try{Z=W.openSync(J,W.constants.O_WRONLY|W.constants.O_CREAT|W.constants.O_TRUNC,384);W.fchmodSync(Z,384);W.writeFileSync(Z,Q.join(`
-`),"utf8")}finally{if(Z!==void 0)W.closeSync(Z)}}export function formatCookieHeader(K){return K.map((J)=>`${J.name}=${J.value}`).join("; ")}export async function ytdlpDownload(K,J,Q={}){const{cookiesFile:Z,format:$="best",extraArgs:Y=[],onProgress:z}=Q;if(!checkYtdlp())return{success:!1,size:0,error:"yt-dlp not installed. Install with: pip install yt-dlp"};return new Promise((q)=>{const w=H.dirname(J);W.mkdirSync(w,{recursive:!0});const A=[K,"-o",J,"-f",$,"--no-playlist","--progress"];if(Z)if(W.existsSync(Z))A.push("--cookies",Z);else{g.warn(`[download] Cookies file not found: ${Z}, falling back to browser cookies`);A.push("--cookies-from-browser","chrome")}else A.push("--cookies-from-browser","chrome");A.push(...Y);const D=R("yt-dlp",A,{stdio:["ignore","pipe","pipe"]});let M=0,C="";D.stderr.on("data",(X)=>{const B=X.toString();C+=B;const j=B.match(/(\d+\.?\d*)%/);if(j&&z){const G=parseFloat(j[1]);if(G>M){M=G;z(G)}}});D.stdout.on("data",(X)=>{const j=X.toString().match(/(\d+\.?\d*)%/);if(j&&z){const G=parseFloat(j[1]);if(G>M){M=G;z(G)}}});D.on("close",(X)=>{if(X===0&&W.existsSync(J)){const B=W.statSync(J);q({success:!0,size:B.size})}else{const B=W.readdirSync(w).filter((j)=>j.startsWith(H.basename(J,H.extname(J))));if(B.length>0){const j=H.join(w,B[0]),G=W.statSync(j);q({success:!0,size:G.size})}else q({success:!1,size:0,error:C.slice(0,200)||`Exit code ${X}`})}});D.on("error",(X)=>{q({success:!1,size:0,error:X.message})})})}export async function saveDocument(K,J,Q="markdown",Z){try{const $=H.dirname(J);W.mkdirSync($,{recursive:!0});let Y;if(Q==="json")Y=JSON.stringify({...Z,content:K},null,2);else if(Q==="markdown")Y=(Z?`---
-${Object.entries(Z).map(([q,w])=>`${q}: ${JSON.stringify(w)}`).join(`
+import{spawn as T}from"node:child_process";import*as i from"node:fs";import*as g from"node:path";import*as N from"node:os";import{Readable as j,Transform as C}from"node:stream";import{pipeline as D}from"node:stream/promises";import{URL as S}from"node:url";import{isBinaryInstalled as F}from"../external.js";import{getErrorMessage as O}from"../errors.js";import{fetchWithNodeNetwork as I}from"../node-network.js";import{log as W}from"../logger.js";export function checkYtdlp(){return F("yt-dlp")}const M=["youtube.com","youtu.be","bilibili.com","twitter.com","x.com","tiktok.com","vimeo.com","twitch.tv"];function v(t){let e;try{e=new S(t).hostname.toLowerCase()}catch{return!1}return M.some((r)=>e===r||e.endsWith(`.${r}`))}const R=new Set([".jpg",".jpeg",".png",".gif",".webp",".svg",".ico",".bmp",".avif"]),A=new Set([".mp4",".webm",".avi",".mov",".mkv",".flv",".m3u8",".ts"]),L=new Set([".html",".htm",".json",".xml",".txt",".md",".markdown"]);export function detectContentType(t,e){if(e){if(e.startsWith("image/"))return"image";if(e.startsWith("video/"))return"video";if(e.startsWith("text/")||e.includes("json")||e.includes("xml"))return"document"}let r="";try{r=g.extname(new S(t).pathname).toLowerCase()}catch{return"binary"}if(R.has(r))return"image";if(A.has(r))return"video";if(v(t))return"video";if(L.has(r))return"document";return"binary"}export function requiresYtdlp(t){return v(t)}export async function httpDownload(t,e,r={},o=0){const{cookies:s,headers:c={},timeout:l=30000,onProgress:a,maxRedirects:p=10}=r,d={"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",...c};if(s)d.Cookie=s;const h=`${e}.tmp`,w=async()=>{try{await i.promises.rm(h,{force:!0})}catch{}},b=new AbortController,u=setTimeout(()=>b.abort(),l);try{const n=await I(t,{headers:d,signal:b.signal,redirect:"manual"});clearTimeout(u);if(n.status>=300&&n.status<400){const y=n.headers.get("location");if(y){if(o>=p)return{success:!1,size:0,error:`Too many redirects (> ${p})`};const x=resolveRedirectUrl(t,y),k=new S(t).hostname,_=new S(x).hostname,z=k===_?r:{...r,cookies:void 0,headers:U(r.headers)};return httpDownload(x,e,z,o+1)}}if(n.status!==200)return{success:!1,size:0,error:`HTTP ${n.status}`};if(!n.body)return{success:!1,size:0,error:"Empty response body"};const f=parseInt(n.headers.get("content-length")||"0",10);let m=0;const E=new C({transform(y,x,k){m+=y.length;if(a)a(m,f);k(null,y)}});try{await i.promises.mkdir(g.dirname(e),{recursive:!0});await D(j.fromWeb(n.body),E,i.createWriteStream(h));await i.promises.rename(h,e);return{success:!0,size:m}}catch(y){await w();return{success:!1,size:0,error:O(y)}}}catch(n){clearTimeout(u);await w();return{success:!1,size:0,error:n instanceof Error?n.message:String(n)}}}export function resolveRedirectUrl(t,e){return new S(e,t).toString()}function U(t){if(!t)return t;return Object.fromEntries(Object.entries(t).filter(([e])=>e.toLowerCase()!=="cookie"))}export function exportCookiesToNetscape(t,e){const r=["# Netscape HTTP Cookie File","# https://curl.se/docs/http-cookies.html","# This is a generated file!  Do not edit.",""];for(const s of t){const c=s.domain.startsWith(".")?s.domain:`.${s.domain}`,l="TRUE",a=s.path||"/",p=s.secure?"TRUE":"FALSE",d=typeof s.expirationDate==="number"&&s.expirationDate>0?Math.floor(s.expirationDate):Math.floor(Date.now()/1000)+31536000,h=s.name.replace(/[\t\n\r]/g,""),w=s.value.replace(/[\t\n\r]/g,"");r.push(`${c}	${l}	${a}	${p}	${d}	${h}	${w}`)}i.mkdirSync(g.dirname(e),{recursive:!0});let o;try{o=i.openSync(e,i.constants.O_WRONLY|i.constants.O_CREAT|i.constants.O_TRUNC,384);i.fchmodSync(o,384);i.writeFileSync(o,r.join(`
+`),"utf8")}finally{if(o!==void 0)i.closeSync(o)}}export function formatCookieHeader(t){return t.map((e)=>`${e.name}=${e.value}`).join("; ")}export async function ytdlpDownload(t,e,r={}){const{cookiesFile:o,format:s="best",extraArgs:c=[],onProgress:l}=r;if(!checkYtdlp())return{success:!1,size:0,error:"yt-dlp not installed. Install with: pip install yt-dlp"};return new Promise((a)=>{const p=g.dirname(e);i.mkdirSync(p,{recursive:!0});const d=[t,"-o",e,"-f",s,"--no-playlist","--progress"];if(o)if(i.existsSync(o))d.push("--cookies",o);else{W.warn(`[download] Cookies file not found: ${o}, falling back to browser cookies`);d.push("--cookies-from-browser","chrome")}else d.push("--cookies-from-browser","chrome");d.push(...c);const h=T("yt-dlp",d,{stdio:["ignore","pipe","pipe"]});let w=0,b="";h.stderr.on("data",(u)=>{const n=u.toString();b+=n;const f=n.match(/(\d+\.?\d*)%/);if(f&&l){const m=parseFloat(f[1]);if(m>w){w=m;l(m)}}});h.stdout.on("data",(u)=>{const f=u.toString().match(/(\d+\.?\d*)%/);if(f&&l){const m=parseFloat(f[1]);if(m>w){w=m;l(m)}}});h.on("close",(u)=>{if(u===0&&i.existsSync(e)){const n=i.statSync(e);a({success:!0,size:n.size})}else{const n=i.readdirSync(p).filter((f)=>f.startsWith(g.basename(e,g.extname(e))));if(n.length>0){const f=g.join(p,n[0]),m=i.statSync(f);a({success:!0,size:m.size})}else a({success:!1,size:0,error:b.slice(0,200)||`Exit code ${u}`})}});h.on("error",(u)=>{a({success:!1,size:0,error:u.message})})})}export async function saveDocument(t,e,r="markdown",o){try{const s=g.dirname(e);i.mkdirSync(s,{recursive:!0});let c;if(r==="json")c=JSON.stringify({...o,content:t},null,2);else if(r==="markdown")c=(o?`---
+${Object.entries(o).map(([a,p])=>`${a}: ${JSON.stringify(p)}`).join(`
 `)}
 ---
 
-`:"")+K;else Y=K;W.writeFileSync(J,Y,"utf-8");return{success:!0,size:Buffer.byteLength(Y,"utf-8")}}catch($){return{success:!1,size:0,error:L($)}}}export function sanitizeFilename(K,J=200){return K.replace(/[<>:"/\\|?*\x00-\x1f]/g,"_").replace(/\s+/g,"_").replace(/_+/g,"_").replace(/^_|_$/g,"").slice(0,J)}export function generateFilename(K,J,Q){try{const Z=new _(K),$=Z.pathname,Y=H.basename($);if(Y&&Y!=="/"&&Y.includes("."))return sanitizeFilename(Y);const z=Q||h(K),q=Z.hostname.replace(/^www\./,"");return sanitizeFilename(`${q}_${J+1}${z}`)}catch{const Z=Q||".bin";return`download_${J+1}${Z}`}}function h(K){switch(detectContentType(K)){case"image":return".jpg";case"video":return".mp4";case"document":return".md";default:return".bin"}}export function getTempDir(){return H.join(E.tmpdir(),"opencli-download")}
+`:"")+t;else c=t;i.writeFileSync(e,c,"utf-8");return{success:!0,size:Buffer.byteLength(c,"utf-8")}}catch(s){return{success:!1,size:0,error:O(s)}}}export function sanitizeFilename(t,e=200){return t.replace(/[<>:"/\\|?*\x00-\x1f]/g,"_").replace(/\s+/g,"_").replace(/_+/g,"_").replace(/^_|_$/g,"").slice(0,e)}export function generateFilename(t,e,r){try{const o=new S(t),s=o.pathname,c=g.basename(s);if(c&&c!=="/"&&c.includes("."))return sanitizeFilename(c);const l=r||H(t),a=o.hostname.replace(/^www\./,"");return sanitizeFilename(`${a}_${e+1}${l}`)}catch{const o=r||".bin";return`download_${e+1}${o}`}}function H(t){switch(detectContentType(t)){case"image":return".jpg";case"video":return".mp4";case"document":return".md";default:return".bin"}}export function getTempDir(){return g.join(N.tmpdir(),"opencli-download")}

package/dist/src/download/media-download.js

@@ -1 +1 @@
-import*as X from"node:fs";import*as L from"node:path";import{getErrorMessage as D}from"../errors.js";import{httpDownload as F,ytdlpDownload as b,checkYtdlp as B,getTempDir as x,exportCookiesToNetscape as h,sanitizeFilename as g}from"./index.js";import{DownloadProgressTracker as f,formatBytes as j}from"./progress.js";export async function downloadMedia(H,J){const{output:R,subdir:U,cookies:A,browserCookies:O,timeout:Z,filenamePrefix:E="download",ytdlpExtraArgs:C=[],verbose:T=!0}=J;if(!H||H.length===0)return[{index:0,type:"-",status:"failed",size:"No media found"}];const M=U?L.join(R,U):R;X.mkdirSync(M,{recursive:!0});const v=B();let Q;if(H.some((q)=>q.type==="video-tweet"||q.type==="video-ytdlp")&&O&&O.length>0){const q=x();X.mkdirSync(q,{recursive:!0});Q=L.join(q,`media_cookies_${Date.now()}.txt`);h(O,Q)}const W=new f(H.length,T),_=[];try{for(let q=0;q<H.length;q++){const I=H[q],S=I.type!=="image",w=S?"mp4":"jpg",V=k(I.filename,E,q+1,w),Y=L.join(M,V),K=W.onFileStart(V,q);try{let G;if((I.type==="video-tweet"||I.type==="video-ytdlp")&&v)G=await b(I.url,Y,{cookiesFile:Q,extraArgs:C,onProgress:(N)=>{if(K)K.update(N,100)}});else{const N=Z||(S?60000:30000);G=await F(I.url,Y,{cookies:A,timeout:N,onProgress:(P,z)=>{if(K)K.update(P,z)}})}if(K)K.complete(G.success,G.success?j(G.size):void 0);W.onFileComplete(G.success);_.push({index:q+1,type:I.type==="video-tweet"||I.type==="video-ytdlp"?"video":I.type,status:G.success?"success":"failed",size:G.success?j(G.size):G.error||"unknown error"})}catch(G){const $=D(G);if(K)K.fail($);W.onFileComplete(!1);_.push({index:q+1,type:I.type,status:"failed",size:$})}}}finally{W.finish();if(Q&&X.existsSync(Q))X.unlinkSync(Q)}return _}function k(H,J,R,U){const O=`${y(L.basename(L.win32.basename(J)))||"download"}_${R}.${U}`;if(!H)return O;const Z=L.basename(L.win32.basename(H));return y(Z)||O}function y(H){const J=g(H);return J&&J!=="."&&J!==".."?J:""}
+import*as u from"node:fs";import*as r from"node:path";import{getErrorMessage as N}from"../errors.js";import{httpDownload as T,ytdlpDownload as M,checkYtdlp as _,getTempDir as A,exportCookiesToNetscape as B,sanitizeFilename as E}from"./index.js";import{DownloadProgressTracker as V,formatBytes as z}from"./progress.js";export async function downloadMedia(s,n){const{output:d,subdir:l,cookies:w,browserCookies:a,timeout:f,filenamePrefix:h="download",ytdlpExtraArgs:D=[],verbose:F=!0}=n;if(!s||s.length===0)return[{index:0,type:"-",status:"failed",size:"No media found"}];const k=l?r.join(d,l):d;u.mkdirSync(k,{recursive:!0});const S=_();let c;if(s.some((e)=>e.type==="video-tweet"||e.type==="video-ytdlp")&&a&&a.length>0){const e=A();u.mkdirSync(e,{recursive:!0});c=r.join(e,`media_cookies_${Date.now()}.txt`);B(a,c)}const p=new V(s.length,F),m=[];try{for(let e=0;e<s.length;e++){const o=s[e],x=o.type!=="image",Y=x?"mp4":"jpg",v=q(o.filename,h,e+1,Y),b=r.join(k,v),i=p.onFileStart(v,e);try{let t;if((o.type==="video-tweet"||o.type==="video-ytdlp")&&S)t=await M(o.url,b,{cookiesFile:c,extraArgs:D,onProgress:(g)=>{if(i)i.update(g,100)}});else{const g=f||(x?60000:30000);t=await T(o.url,b,{cookies:w,timeout:g,onProgress:(j,C)=>{if(i)i.update(j,C)}})}if(i)i.complete(t.success,t.success?z(t.size):void 0);p.onFileComplete(t.success);m.push({index:e+1,type:o.type==="video-tweet"||o.type==="video-ytdlp"?"video":o.type,status:t.success?"success":"failed",size:t.success?z(t.size):t.error||"unknown error"})}catch(t){const y=N(t);if(i)i.fail(y);p.onFileComplete(!1);m.push({index:e+1,type:o.type,status:"failed",size:y})}}}finally{p.finish();if(c&&u.existsSync(c))u.unlinkSync(c)}return m}function q(s,n,d,l){const a=`${P(r.basename(r.win32.basename(n)))||"download"}_${d}.${l}`;if(!s)return a;const f=r.basename(r.win32.basename(s));return P(f)||a}function P(s){const n=E(s);return n&&n!=="."&&n!==".."?n:""}

package/dist/src/download/progress.js

@@ -1,5 +1,5 @@
-export function formatBytes(j){if(!Number.isFinite(j)||j<1)return"0 B";const q=1024,A=["B","KB","MB","GB","TB"],C=Math.min(A.length-1,Math.floor(Math.log(j)/Math.log(q)));return`${(j/Math.pow(q,C)).toFixed(1)} ${A[C]}`}export function formatDuration(j){if(j<1000)return`${j}ms`;const q=Math.floor(j/1000);if(q<60)return`${q}s`;const A=Math.floor(q/60);if(A<60){const E=q%60;return E>0?`${A}m ${E}s`:`${A}m`}const C=Math.floor(A/60),G=A%60;return G>0?`${C}h ${G}m`:`${C}h`}export function createProgressBar(j,q,A){const C=`[${q+1}/${A}]`,G=j.length>40?j.slice(0,37)+"...":j;return{update(E,F,H){const I=O(F>0?Math.round(E/F*100):0),J=Q(I),K=F>0?formatBytes(F):"",L=H?` ${H}`:"";process.stderr.write(`\r${C} ${G} ${J} ${I}% ${K}${L}`)},complete(E,F){const H=E?"✓":"✗",I=F?` ${F}`:"";process.stderr.write(`\r${C} ${H} ${G}${I}
-`)},fail(E){process.stderr.write(`\r${C} ✗ ${G} ${E}
-`)}}}function O(j){if(!Number.isFinite(j))return 0;return Math.max(0,Math.min(100,j))}function Q(j,q=20){const A=Math.round(j/100*q),C=q-A;return"█".repeat(A)+"░".repeat(C)}export class DownloadProgressTracker{completed=0;failed=0;skipped=0;total;startTime;verbose;constructor(j,q=!0){this.total=j;this.startTime=Date.now();this.verbose=q}onFileStart(j,q){if(!this.verbose)return null;return createProgressBar(j,q,this.total)}onFileComplete(j,q=!1){if(q)this.skipped++;else if(j)this.completed++;else this.failed++}getSummary(){const j=formatDuration(Date.now()-this.startTime),q=[];if(this.completed>0)q.push(`${this.completed} downloaded`);if(this.skipped>0)q.push(`${this.skipped} skipped`);if(this.failed>0)q.push(`${this.failed} failed`);return`${q.join(", ")} in ${j}`}finish(){if(this.verbose)process.stderr.write(`
+export function formatBytes(t){if(!Number.isFinite(t)||t<1)return"0 B";const e=1024,r=["B","KB","MB","GB","TB"],s=Math.min(r.length-1,Math.floor(Math.log(t)/Math.log(e)));return`${(t/Math.pow(e,s)).toFixed(1)} ${r[s]}`}export function formatDuration(t){if(t<1000)return`${t}ms`;const e=Math.floor(t/1000);if(e<60)return`${e}s`;const r=Math.floor(e/60);if(r<60){const o=e%60;return o>0?`${r}m ${o}s`:`${r}m`}const s=Math.floor(r/60),n=r%60;return n>0?`${s}h ${n}m`:`${s}h`}export function createProgressBar(t,e,r){const s=`[${e+1}/${r}]`,n=t.length>40?t.slice(0,37)+"...":t;return{update(o,i,a){const c=l(i>0?Math.round(o/i*100):0),h=d(c),p=i>0?formatBytes(i):"",u=a?` ${a}`:"";process.stderr.write(`\r${s} ${n} ${h} ${c}% ${p}${u}`)},complete(o,i){const a=o?"✓":"✗",c=i?` ${i}`:"";process.stderr.write(`\r${s} ${a} ${n}${c}
+`)},fail(o){process.stderr.write(`\r${s} ✗ ${n} ${o}
+`)}}}function l(t){if(!Number.isFinite(t))return 0;return Math.max(0,Math.min(100,t))}function d(t,e=20){const r=Math.round(t/100*e),s=e-r;return"█".repeat(r)+"░".repeat(s)}export class DownloadProgressTracker{completed=0;failed=0;skipped=0;total;startTime;verbose;constructor(t,e=!0){this.total=t;this.startTime=Date.now();this.verbose=e}onFileStart(t,e){if(!this.verbose)return null;return createProgressBar(t,e,this.total)}onFileComplete(t,e=!1){if(e)this.skipped++;else if(t)this.completed++;else this.failed++}getSummary(){const t=formatDuration(Date.now()-this.startTime),e=[];if(this.completed>0)e.push(`${this.completed} downloaded`);if(this.skipped>0)e.push(`${this.skipped} skipped`);if(this.failed>0)e.push(`${this.failed} failed`);return`${e.join(", ")} in ${t}`}finish(){if(this.verbose)process.stderr.write(`
 Download complete: ${this.getSummary()}
 `)}}

package/dist/src/electron-apps.js

@@ -1 +1 @@
-import*as B from"node:fs";import*as C from"node:path";import*as D from"node:os";import E from"js-yaml";export const builtinApps={cursor:{port:9226,processName:"Cursor",bundleId:"com.todesktop.runtime.Cursor",displayName:"Cursor"},codex:{port:9238,processName:"Codex",bundleId:"com.openai.codex",displayName:"Codex"},chatwise:{port:9228,processName:"ChatWise",bundleId:"com.chatwise.app",displayName:"ChatWise"},"discord-app":{port:9232,processName:"Discord",bundleId:"com.discord.app",displayName:"Discord"},"doubao-app":{port:9225,processName:"Doubao",bundleId:"com.volcengine.doubao",displayName:"Doubao"},antigravity:{port:9234,processName:"Antigravity",executableNames:["Electron","Antigravity"],bundleId:"dev.antigravity.app",displayName:"Antigravity"},"chatgpt-app":{port:9236,processName:"ChatGPT",bundleId:"com.openai.chat",displayName:"ChatGPT"},qoder:{port:9237,processName:"Qoder",executableNames:["Electron"],bundleId:"com.qoder.ide",displayName:"Qoder"},"trae-solo":{port:9235,processName:"TRAE SOLO",executableNames:["Electron","TRAE SOLO"],bundleId:"com.trae.solo.app",displayName:"Trae SOLO"},"trae-cn":{port:39240,processName:"Trae CN",executableNames:["Electron"],bundleId:"cn.trae.app",displayName:"Trae CN"}};export function loadApps(k){const q={...builtinApps};if(k){for(const[w,z]of Object.entries(k))if(!(w in q))q[w]=z}return q}let v=null;function x(){if(v)return v;let k;try{const q=C.join(D.homedir(),".ppcli","apps.yaml");if(B.existsSync(q)){const w=B.readFileSync(q,"utf-8");k=E.load(w)?.apps}}catch{}v=loadApps(k);return v}export function getElectronApp(k){return x()[k]}export function isElectronApp(k){return k in x()}export function getAllElectronApps(){return x()}export function _resetRegistry(){v=null}
+import*as s from"node:fs";import*as n from"node:path";import*as c from"node:os";import i from"js-yaml";export const builtinApps={cursor:{port:9226,processName:"Cursor",bundleId:"com.todesktop.runtime.Cursor",displayName:"Cursor"},codex:{port:9238,processName:"Codex",bundleId:"com.openai.codex",displayName:"Codex"},chatwise:{port:9228,processName:"ChatWise",bundleId:"com.chatwise.app",displayName:"ChatWise"},"discord-app":{port:9232,processName:"Discord",bundleId:"com.discord.app",displayName:"Discord"},"doubao-app":{port:9225,processName:"Doubao",bundleId:"com.volcengine.doubao",displayName:"Doubao"},antigravity:{port:9234,processName:"Antigravity",executableNames:["Electron","Antigravity"],bundleId:"dev.antigravity.app",displayName:"Antigravity"},"chatgpt-app":{port:9236,processName:"ChatGPT",bundleId:"com.openai.chat",displayName:"ChatGPT"},qoder:{port:9237,processName:"Qoder",executableNames:["Electron"],bundleId:"com.qoder.ide",displayName:"Qoder"},"trae-solo":{port:9235,processName:"TRAE SOLO",executableNames:["Electron","TRAE SOLO"],bundleId:"com.trae.solo.app",displayName:"Trae SOLO"},"trae-cn":{port:39240,processName:"Trae CN",executableNames:["Electron"],bundleId:"cn.trae.app",displayName:"Trae CN"}};export function loadApps(e){const o={...builtinApps};if(e){for(const[a,p]of Object.entries(e))if(!(a in o))o[a]=p}return o}let r=null;function t(){if(r)return r;let e;try{const o=n.join(c.homedir(),".ppcli","apps.yaml");if(s.existsSync(o)){const a=s.readFileSync(o,"utf-8");e=i.load(a)?.apps}}catch{}r=loadApps(e);return r}export function getElectronApp(e){return t()[e]}export function isElectronApp(e){return e in t()}export function getAllElectronApps(){return t()}export function _resetRegistry(){r=null}

package/dist/src/errors.js

@@ -1,2 +1,2 @@
-export const EXIT_CODES={SUCCESS:0,GENERIC_ERROR:1,USAGE_ERROR:2,EMPTY_RESULT:66,SERVICE_UNAVAIL:69,TEMPFAIL:75,NOPERM:77,CONFIG_ERROR:78,INTERRUPTED:130};export class CliError extends Error{code;hint;exitCode;constructor(j,q,F,G=EXIT_CODES.GENERIC_ERROR){super(q);this.name=new.target.name;this.code=j;this.hint=F;this.exitCode=G}}const J=Symbol.for("ppcli.traceReceipt");export function attachTraceReceipt(j,q){if(!j||typeof j!=="object"&&typeof j!=="function")return;try{Object.defineProperty(j,J,{value:q,enumerable:!1,configurable:!0})}catch{}}export function getTraceReceipt(j){if(!j||typeof j!=="object"&&typeof j!=="function")return;return j[J]}export class BrowserConnectError extends CliError{kind;constructor(j,q,F="unknown"){super("BROWSER_CONNECT",j,q,EXIT_CODES.SERVICE_UNAVAIL);this.kind=F}}export class CommandExecutionError extends CliError{constructor(j,q){super("COMMAND_EXEC",j,q,EXIT_CODES.GENERIC_ERROR)}}export class ConfigError extends CliError{constructor(j,q){super("CONFIG",j,q,EXIT_CODES.CONFIG_ERROR)}}export class AuthRequiredError extends CliError{domain;constructor(j,q){super("AUTH_REQUIRED",q??`Not logged in to ${j}`,`Please open Chrome or Chromium and log in to https://${j}`,EXIT_CODES.NOPERM);this.domain=j}}export class TimeoutError extends CliError{constructor(j,q,F){super("TIMEOUT",`${j} timed out after ${q}s`,F??"Try again, or increase timeout with --timeout <seconds> (or OPENCLI_BROWSER_COMMAND_TIMEOUT for the global default)",EXIT_CODES.TEMPFAIL)}}export class RateLimitError extends CliError{constructor(j,q,F){const G=N(q);super("RATE_LIMITED",`Rate limit exceeded for ${j}`,`Retry after ${G}. To change this limit, edit ${F}.`,EXIT_CODES.TEMPFAIL)}}export class ArgumentError extends CliError{constructor(j,q){super("ARGUMENT",j,q,EXIT_CODES.USAGE_ERROR)}}export class SessionBusyError extends CliError{constructor(j,q){super("SESSION_BUSY",j,q,EXIT_CODES.TEMPFAIL)}}export class EmptyResultError extends CliError{constructor(j,q){super("EMPTY_RESULT",`${j} returned no data`,q??"This usually means the target genuinely has no matching content — "+"an empty result is a valid answer, not a failure, and can be relied on (e.g. no comments found = this account has not commented there). Only suspect a broken adapter or expired login if you have other evidence that content should be there.",EXIT_CODES.EMPTY_RESULT)}}export function adapterLoadError(j,q){return new CliError("ADAPTER_LOAD",j,q,EXIT_CODES.SERVICE_UNAVAIL)}export function selectorError(j,q){return new CliError("SELECTOR",`Could not find element: ${j}`,q??"The page UI may have changed. Please report this issue.",EXIT_CODES.GENERIC_ERROR)}export class PluginError extends CliError{constructor(j,q){super("PLUGIN",j,q,EXIT_CODES.GENERIC_ERROR)}}function N(j){const q=Math.max(0,Math.ceil(j));if(q<1000)return`${q}ms`;const F=Math.ceil(q/1000);if(F<60)return`${F}s`;const G=Math.ceil(F/60);if(G<60)return`${G}m`;return`${Math.ceil(G/60)}h`}export class LoginWallError extends CliError{status;url;bodyPreview;constructor(j,q,F,G,H){super("LOGIN_WALL",j,H??"The server returned an HTML page instead of JSON — likely a login wall, rate limit, or WAF challenge. Try re-logging in via your browser, or wait a few minutes before retrying.",EXIT_CODES.NOPERM);this.status=q;this.url=F;this.bodyPreview=G}}export function getErrorMessage(j){return j instanceof Error?j.message:String(j)}function K(j,q=0){if(q>10)return"(cause chain truncated)";if(j instanceof Error){const F=[j.message];if(j.cause)F.push(`  caused by: ${K(j.cause,q+1)}`);return F.join(`
-`)}return String(j)}export function toEnvelope(j){const q=j instanceof Error&&j.cause?K(j.cause):void 0,F=getTraceReceipt(j),G=F?{traceId:F.traceId,dir:F.traceDir,summaryPath:F.summaryPath,receiptPath:F.receiptPath,status:F.status}:void 0;if(j instanceof CliError)return{ok:!1,error:{code:j.code,message:j.message,...j.hint?{help:j.hint}:{},exitCode:j.exitCode,...q?{cause:q}:{}},...G?{trace:G}:{}};return{ok:!1,error:{code:"UNKNOWN",message:getErrorMessage(j),exitCode:EXIT_CODES.GENERIC_ERROR,...q?{cause:q}:{}},...G?{trace:G}:{}}}
+export const EXIT_CODES={SUCCESS:0,GENERIC_ERROR:1,USAGE_ERROR:2,EMPTY_RESULT:66,SERVICE_UNAVAIL:69,TEMPFAIL:75,NOPERM:77,CONFIG_ERROR:78,INTERRUPTED:130};export class CliError extends Error{code;hint;exitCode;constructor(e,t,n,o=EXIT_CODES.GENERIC_ERROR){super(t);this.name=new.target.name;this.code=e;this.hint=n;this.exitCode=o}}const r=Symbol.for("ppcli.traceReceipt");export function attachTraceReceipt(e,t){if(!e||typeof e!=="object"&&typeof e!=="function")return;try{Object.defineProperty(e,r,{value:t,enumerable:!1,configurable:!0})}catch{}}export function getTraceReceipt(e){if(!e||typeof e!=="object"&&typeof e!=="function")return;return e[r]}export class BrowserConnectError extends CliError{kind;constructor(e,t,n="unknown"){super("BROWSER_CONNECT",e,t,EXIT_CODES.SERVICE_UNAVAIL);this.kind=n}}export class CommandExecutionError extends CliError{constructor(e,t){super("COMMAND_EXEC",e,t,EXIT_CODES.GENERIC_ERROR)}}export class ConfigError extends CliError{constructor(e,t){super("CONFIG",e,t,EXIT_CODES.CONFIG_ERROR)}}export class AuthRequiredError extends CliError{domain;constructor(e,t){super("AUTH_REQUIRED",t??`Not logged in to ${e}`,`Please open Chrome or Chromium and log in to https://${e}`,EXIT_CODES.NOPERM);this.domain=e}}export class TimeoutError extends CliError{constructor(e,t,n){super("TIMEOUT",`${e} timed out after ${t}s`,n??"Try again, or increase timeout with --timeout <seconds> (or OPENCLI_BROWSER_COMMAND_TIMEOUT for the global default)",EXIT_CODES.TEMPFAIL)}}export class RateLimitError extends CliError{constructor(e,t,n){const o=c(t);super("RATE_LIMITED",`Rate limit exceeded for ${e}`,`Retry after ${o}. To change this limit, edit ${n}.`,EXIT_CODES.TEMPFAIL)}}export class ArgumentError extends CliError{constructor(e,t){super("ARGUMENT",e,t,EXIT_CODES.USAGE_ERROR)}}export class SessionBusyError extends CliError{constructor(e,t){super("SESSION_BUSY",e,t,EXIT_CODES.TEMPFAIL)}}export class EmptyResultError extends CliError{constructor(e,t){super("EMPTY_RESULT",`${e} returned no data`,t??"This usually means the target genuinely has no matching content — "+"an empty result is a valid answer, not a failure, and can be relied on (e.g. no comments found = this account has not commented there). Only suspect a broken adapter or expired login if you have other evidence that content should be there.",EXIT_CODES.EMPTY_RESULT)}}export function adapterLoadError(e,t){return new CliError("ADAPTER_LOAD",e,t,EXIT_CODES.SERVICE_UNAVAIL)}export function selectorError(e,t){return new CliError("SELECTOR",`Could not find element: ${e}`,t??"The page UI may have changed. Please report this issue.",EXIT_CODES.GENERIC_ERROR)}export class PluginError extends CliError{constructor(e,t){super("PLUGIN",e,t,EXIT_CODES.GENERIC_ERROR)}}function c(e){const t=Math.max(0,Math.ceil(e));if(t<1000)return`${t}ms`;const n=Math.ceil(t/1000);if(n<60)return`${n}s`;const o=Math.ceil(n/60);if(o<60)return`${o}m`;return`${Math.ceil(o/60)}h`}export class LoginWallError extends CliError{status;url;bodyPreview;constructor(e,t,n,o,s){super("LOGIN_WALL",e,s??"The server returned an HTML page instead of JSON — likely a login wall, rate limit, or WAF challenge. Try re-logging in via your browser, or wait a few minutes before retrying.",EXIT_CODES.NOPERM);this.status=t;this.url=n;this.bodyPreview=o}}export function getErrorMessage(e){return e instanceof Error?e.message:String(e)}function a(e,t=0){if(t>10)return"(cause chain truncated)";if(e instanceof Error){const n=[e.message];if(e.cause)n.push(`  caused by: ${a(e.cause,t+1)}`);return n.join(`
+`)}return String(e)}export function toEnvelope(e){const t=e instanceof Error&&e.cause?a(e.cause):void 0,n=getTraceReceipt(e),o=n?{traceId:n.traceId,dir:n.traceDir,summaryPath:n.summaryPath,receiptPath:n.receiptPath,status:n.status}:void 0;if(e instanceof CliError)return{ok:!1,error:{code:e.code,message:e.message,...e.hint?{help:e.hint}:{},exitCode:e.exitCode,...t?{cause:t}:{}},...o?{trace:o}:{}};return{ok:!1,error:{code:"UNKNOWN",message:getErrorMessage(e),exitCode:EXIT_CODES.GENERIC_ERROR,...t?{cause:t}:{}},...o?{trace:o}:{}}}

package/dist/src/execution.js

@@ -1,2 +1,2 @@
-import{getRegistry as Yq,fullName as I}from"./registry.js";import{pathToFileURL as Zq}from"node:url";import*as $q from"node:crypto";import*as P from"node:fs";import*as c from"node:os";import*as i from"node:path";import{executePipeline as m}from"./pipeline/index.js";import{adapterLoadError as Jq,ArgumentError as K,CommandExecutionError as A,SessionBusyError as Gq,attachTraceReceipt as Vq,getErrorMessage as h}from"./errors.js";import{shouldUseBrowserSession as zq}from"./capabilityRouting.js";import{getBrowserFactory as Hq,browserSession as Lq,runWithTimeout as n,DEFAULT_BROWSER_COMMAND_TIMEOUT as Wq}from"./runtime.js";import{withBrowserSessionLockIf as Kq}from"./browser-session-lock.js";import{resolveProfile as Fq}from"./browser/profile.js";import{ensureManagedChrome as yq}from"./browser/managed-chrome.js";import{generateFingerprintJs as Bq}from"./browser/fingerprint.js";import{CDPBridge as Iq}from"./browser/index.js";import{clearDaemonRunContext as jq,generateRunId as _q,isUnknownOutcomeError as d,releaseSiteSessionLease as t,setDaemonCommandTimeoutSeconds as Oq,setDaemonRunContext as s}from"./browser/daemon-client.js";import{emitHook as S}from"./hooks.js";import{log as o}from"./logger.js";import{isElectronApp as Uq}from"./electron-apps.js";import{probeCDP as Cq,resolveElectronEndpoint as Rq}from"./launcher.js";import{ObservationSession as Aq,exportObservationSession as xq}from"./observation/index.js";import{resolveAdapterSourcePath as Nq}from"./adapter-source.js";const O=new Map,k=new Map,Tq=`${c.homedir()}/.ppcli/clis/`;function Mq(q){if(q===void 0||q===null||q===""||q==="off")return"off";if(q==="on"||q==="retain-on-failure")return q;throw new K(`--trace must be one of: off, on, retain-on-failure. Received: "${String(q)}"`)}export function coerceAndValidateArgs(q,Q){const X={...Q};for(const Y of q){const Z=X[Y.name];if(Y.required&&(Z===void 0||Z===null||Z===""))throw new K(`Argument "${Y.name}" is required.`,Y.help??`Provide a value for --${Y.name}`);if(Z!==void 0&&Z!==null){if(Y.type==="int"||Y.type==="number"){const H=Number(Z);if(Number.isNaN(H))throw new K(`Argument "${Y.name}" must be a valid number. Received: "${Z}"`);X[Y.name]=H}else if(Y.type==="boolean"||Y.type==="bool")if(typeof Z==="string"){const H=Z.toLowerCase();if(H==="true"||H==="1")X[Y.name]=!0;else if(H==="false"||H==="0")X[Y.name]=!1;else throw new K(`Argument "${Y.name}" must be a boolean (true/false). Received: "${Z}"`)}else X[Y.name]=Boolean(Z);const J=X[Y.name];if(Y.choices&&Y.choices.length>0){if(!Y.choices.map(String).includes(String(J)))throw new K(`Argument "${Y.name}" must be one of: ${Y.choices.join(", ")}. Received: "${J}"`)}}else if(Y.default!==void 0)X[Y.name]=Y.default}return X}async function E(q,Q,X,Y){const Z=q;if(Z._lazy&&Z._modulePath){const J=Z._modulePath;if(J.startsWith(Tq)&&O.has(J))try{const W=P.statSync(J),$=k.get(J);if($!==void 0&&W.mtimeMs!==$)O.delete(J)}catch{}if(!O.has(J)){const W=Zq(J).href,B=import(k.has(J)?`${W}?t=${Date.now()}`:W).then(()=>{try{k.set(J,P.statSync(J).mtimeMs)}catch{}},(F)=>{O.delete(J);throw Jq(`Failed to load adapter module ${J}: ${h(F)}`,"Check that the adapter file exists and has no syntax errors.")});O.set(J,B)}await O.get(J);const L=Yq().get(I(q));if(L?.func)return a(L,Q,X,Y);if(L?.pipeline)return m(Q,L.pipeline,{args:X,debug:Y})}if(q.func)return a(q,Q,X,Y);if(q.pipeline)return m(Q,q.pipeline,{args:X,debug:Y});throw new A(`Command ${I(q)} has no func or pipeline`,"This is likely a bug in the adapter definition. Please report this issue.")}function a(q,Q,X,Y){if(q.browser===!1)return q.func(X,Y);if(!Q)throw new A(`Command ${I(q)} requires a browser session but none was provided`);return q.func(Q,X,Y)}function Dq(q){if(q.navigateBefore===!1)return null;if(typeof q.navigateBefore==="string")return q.navigateBefore;return null}function Pq(q,Q){if(!q||!Q)return!1;try{const X=new URL(q).hostname;return X===Q||X.endsWith(`.${Q}`)}catch{return!1}}function hq(q,Q){if(!Q)return!1;try{const X=new URL(q),Y=X.hostname===Q||X.hostname.endsWith(`.${Q}`),Z=X.pathname===""||X.pathname==="/";return Y&&Z&&X.search===""&&X.hash===""}catch{return!1}}async function Sq(q,Q,X,Y){if(X!=="persistent"||!q.domain)return!0;if(!hq(Y,q.domain))return!0;const Z=await Q.getCurrentUrl?.().catch(()=>null);return!Pq(Z,q.domain)}export async function executeCommand(q,Q,X=!1,Y={}){let Z;try{Z=Y.prepared?Q:prepareCommandArgs(q,Q)}catch($){if($ instanceof K)throw $;throw new K(h($))}const J=uq(q,Z);Oq(J);const H=Mq(Y.trace),L={command:I(q),args:Z,startedAt:Date.now()};await S("onBeforeExecute",L);let W;try{if(zq(q)){const $=Uq(q.site),B=Fq(Y.profile),F=!$&&B.kind==="managed"?B:null;let R;const x=pq(q.defaultWindowMode??"background",Y.windowMode);let f,w;if(F){R=await yq(F.name,F.entry,{windowMode:x});const V=F.entry.fingerprint;if(V?.enabled)f=Bq(V);const G=F.entry.proxy;if(G?.username)w={username:G.username,password:G.password??""}}else if($){const V=process.env.OPENCLI_CDP_ENDPOINT;if(V){const G=Number(new URL(V).port);if(!await Cq(G))throw new A(`CDP not reachable at ${V}`,"Check that the app is running with --remote-debugging-port and the endpoint is correct.");R=V}else R=await Rq(q.site)}const Qq=F?Iq:Hq(q.site),p=!F&&B.kind==="extension"?B.contextId:void 0,Xq=q,U=bq(q,Y.siteSession),N=vq(q,U),u=wq(U,Y.keepTab),j=U==="persistent"&&q.access==="write"?{runId:_q(),session:N}:null;if(j)s({runId:j.runId,command:I(q),access:"write"});let l,g=!1,T=null;try{W=await Kq(x!=="foreground",()=>Lq(Qq,async(V)=>{const G=H==="off"?null:new Aq({scope:{contextId:p??F?.name,session:N,target:V.getActivePage?.(),site:q.site,command:I(q),adapterSourcePath:Nq(Xq)}});if(G){G.record({stream:"action",name:"command",phase:"start",data:{args:Z}});await V.startNetworkCapture?.().catch(()=>!1)}const y=Dq(q);if(y&&await Sq(q,V,U,y)){G?.record({stream:"action",name:"pre_navigate",phase:"start",data:{url:y}});try{await V.goto(y);G?.record({stream:"action",name:"pre_navigate",phase:"end",data:{url:y}})}catch(z){if(z instanceof Gq)throw z;G?.record({stream:"action",name:"pre_navigate",phase:"error",data:{url:y,error:z instanceof Error?z.message:String(z)}});const _=new A(`Pre-navigation to ${y} failed: ${z instanceof Error?z.message:z}`,"Check that the site is reachable and the browser extension is running.");_.cause=z;if(G&&(H==="on"||H==="retain-on-failure")){G.record({stream:"error",message:_.message,stack:_.stack,code:_.code,hint:_.hint});await b(G,V).catch(()=>{});v(G,"failure",_,Y.onTraceExport)}throw _}}const C=J!==null?J+r:Wq,M=E(q,V,Z,X);T=M;let D=!1;M.then(()=>{D=!0},()=>{D=!0});try{const z=await n(M,{timeout:C,label:I(q),hint:qq(q,J)});G?.record({stream:"action",name:"command",phase:"end"});if(G&&H==="on"){await b(G,V).catch(()=>{});v(G,"success",void 0,Y.onTraceExport)}if(!u)await V.closeWindow?.().catch(()=>{});return z}catch(z){if(!D)g=!0;if(G){G.record({stream:"action",name:"command",phase:"error",data:{error:z instanceof Error?z.message:String(z)}});G.record({stream:"error",message:z instanceof Error?z.message:String(z),stack:z instanceof Error?z.stack:void 0});if(H==="on"||H==="retain-on-failure"){await b(G,V).catch(()=>{});v(G,"failure",z,Y.onTraceExport)}}if(!u)await V.closeWindow?.().catch(()=>{});throw z}},{session:N,cdpEndpoint:R,contextId:p,windowMode:x,surface:"adapter",siteSession:U,initScript:f,proxyAuth:w}),F?.name)}catch(V){l=V;throw V}finally{if(j)if(g&&T){const{runId:V,session:G}=j,y=(C)=>{jq(V);if(!d(C))t({runId:V,session:G,surface:"adapter"})};T.then(()=>y(),(C)=>y(C))}else{s(null);if(!d(l))await t({runId:j.runId,session:j.session,surface:"adapter"})}}}else if(J!==null){const $=J+r;W=await n(E(q,null,Z,X),{timeout:$,label:I(q),hint:qq(q,J)})}else W=await E(q,null,Z,X)}catch($){L.error=$;L.finishedAt=Date.now();await S("onAfterExecute",L);throw $}L.finishedAt=Date.now();await S("onAfterExecute",L,W);return W}async function b(q,Q){const X=Q.getActivePage?.()??q.scope.target,[Y,Z,J,H,L]=await Promise.all([Q.getCurrentUrl?.().catch(()=>null)??Promise.resolve(null),Q.snapshot().catch(()=>{return}),Q.readNetworkCapture?.().catch(()=>[])??Promise.resolve([]),Q.consoleMessages("all").catch(()=>[]),Q.screenshot({format:"png"}).catch(()=>{return})]);if(Z!==void 0||Y!==void 0)q.record({stream:"state",url:Y,target:X,snapshot:Z,label:"final"});for(const W of Array.isArray(J)?J:[]){const $=W;q.record({stream:"network",url:String($.url??""),method:typeof $.method==="string"?$.method:void 0,status:typeof $.responseStatus==="number"?$.responseStatus:void 0,contentType:typeof $.responseContentType==="string"?$.responseContentType:void 0,size:typeof $.responseBodyFullSize==="number"?$.responseBodyFullSize:void 0,requestHeaders:$.requestHeaders,responseHeaders:$.responseHeaders,requestBody:$.requestBodyPreview,responseBody:$.responsePreview,ts:typeof $.timestamp==="number"?$.timestamp:void 0})}for(const W of Array.isArray(H)?H:[])if(W&&typeof W==="object"){const $=W;q.record({stream:"console",level:String($.type??$.level??"log"),text:String($.text??$.message??""),ts:typeof $.timestamp==="number"?$.timestamp:void 0})}else q.record({stream:"console",level:"log",text:String(W)});if(typeof L==="string"&&L)q.record({stream:"screenshot",format:"png",data:L,label:"final"})}function v(q,Q,X,Y){try{const Z=xq(q,{error:X,status:Q});if(Q==="failure"&&X!==void 0)Vq(X,Z.receipt);else process.stderr.write(`ppcli trace artifact: ${Z.dir}
-`);try{Y?.(Z)}catch(J){o.warn(`[trace] Trace export callback failed: ${J instanceof Error?J.message:String(J)}`)}return Z}catch(Z){o.warn(`[trace] Failed to export trace artifact: ${Z instanceof Error?Z.message:String(Z)}`);return}}export function resolveFileBackedArg(q,Q){const X=q.args.find((L)=>L.fromFile);if(!X)return;const Y=typeof X.fromFile==="string"?X.fromFile:"file",Z=X.positional?`<${X.name}>`:`--${X.name}`,J=Q[Y]==null?"":String(Q[Y]).trim(),H=Q[X.name]==null?"":String(Q[X.name]);if(J){if(H.trim())throw new K(`${Z} 和 --${Y} 只能二选一，不能同时给`);const L=i.resolve(J.startsWith("~/")?i.join(c.homedir(),J.slice(2)):J);let W;try{W=P.readFileSync(L,"utf-8")}catch(B){throw new K(`--${Y} 指向的文件读不到: ${L}（${h(B)}）`)}const $=W.trim();if(!$)throw new K(`--${Y} 指向的文件内容为空: ${L}`);Q[X.name]=$;return}if(!H.trim()&&X.requiredUnlessFile)throw new K(`缺少 ${X.name}：${Z} 或 --${Y} 给其一`)}export function prepareCommandArgs(q,Q){const X=coerceAndValidateArgs(q.args,Q);resolveFileBackedArg(q,X);q.validateArgs?.(X);return X}const r=30;function kq(q){if(q===void 0||q===null||q==="")return null;if(q==="ephemeral"||q==="persistent")return q;throw new K(`--site-session must be one of: ephemeral, persistent. Received: "${String(q)}"`)}function Eq(){const q=process.env.PUBLISHPORT_SITE_SESSION;if(q==="persistent"||q==="ephemeral")return q;return null}function bq(q,Q){return kq(Q)??Eq()??q.siteSession??"persistent"}function vq(q,Q){if(Q==="persistent")return`site:${q.site}`;return`site:${q.site}:${$q.randomUUID()}`}function fq(q,Q){if(Q===void 0||Q==="")return null;if(Q==="true")return!0;if(Q==="false")return!1;throw new K(`${q} must be one of: true, false. Received: "${String(Q)}"`)}function wq(q,Q){if(q==="persistent")return!0;return fq("--keep-tab",Q)??!1}function e(q,Q){if(Q===void 0||Q==="")return null;if(Q==="foreground"||Q==="background")return Q;throw new K(`${q} must be one of: foreground, background. Received: "${String(Q)}"`)}function pq(q="background",Q){return e("--window",Q)??e("OPENCLI_WINDOW",process.env.OPENCLI_WINDOW)??q}function qq(q,Q){const X=q.access==="write"?"⚠️ 这是写操作，超时不代表没写成功——请求可能已经到达平台。禁止直接重试："+"先用该平台的列表/统计命令（stats / lists / articles 等）按标题回查，确认没写进去再重发。 ":"";if(Q!==null)return`${X}Pass a higher --timeout value (currently ${Q}s)`;if(q.args.some((Y)=>Y.name==="timeout"))return`${X}Try again, or pass a higher --timeout <seconds>`;return X+"This command has no --timeout option. Retry once; if it keeps timing out, "+"the page or browser bridge is likely stuck — have the user reopen the PublishPort client. "+"The global default can be raised with OPENCLI_BROWSER_COMMAND_TIMEOUT."}function uq(q,Q){if(!q.args.some((Z)=>Z.name==="timeout"))return null;const X=Q.timeout;if(X===void 0||X===null||X==="")throw new K(`Argument "timeout" must be a positive integer. Received: "${String(X)}"`);const Y=Number(X);if(!Number.isInteger(Y)||Y<=0)throw new K(`Argument "timeout" must be a positive integer. Received: "${String(X)}"`);return Y}
+import{getRegistry as oe,fullName as g}from"./registry.js";import{pathToFileURL as ie}from"node:url";import*as se from"node:crypto";import*as N from"node:fs";import*as j from"node:os";import*as M from"node:path";import{executePipeline as V}from"./pipeline/index.js";import{adapterLoadError as ae,ArgumentError as d,CommandExecutionError as x,SessionBusyError as ce,attachTraceReceipt as ue,getErrorMessage as D}from"./errors.js";import{shouldUseBrowserSession as le}from"./capabilityRouting.js";import{getBrowserFactory as fe,browserSession as me,runWithTimeout as G,DEFAULT_BROWSER_COMMAND_TIMEOUT as de}from"./runtime.js";import{withBrowserSessionLockIf as pe}from"./browser-session-lock.js";import{resolveProfile as he}from"./browser/profile.js";import{ensureManagedChrome as we}from"./browser/managed-chrome.js";import{generateFingerprintJs as ge}from"./browser/fingerprint.js";import{CDPBridge as ye}from"./browser/index.js";import{clearDaemonRunContext as ve,generateRunId as Se,isUnknownOutcomeError as J,releaseSiteSessionLease as K,setDaemonCommandTimeoutSeconds as be,setDaemonRunContext as Q}from"./browser/daemon-client.js";import{emitHook as k}from"./hooks.js";import{setContentBaseDir as $e}from"./utils.js";import{log as X}from"./logger.js";import{isElectronApp as Ee}from"./electron-apps.js";import{probeCDP as Pe,resolveElectronEndpoint as xe}from"./launcher.js";import{ObservationSession as Ae,exportObservationSession as Ce}from"./observation/index.js";import{resolveAdapterSourcePath as Te}from"./adapter-source.js";const S=new Map,B=new Map,Re=`${j.homedir()}/.ppcli/clis/`;function Ie(e){if(e===void 0||e===null||e===""||e==="off")return"off";if(e==="on"||e==="retain-on-failure")return e;throw new d(`--trace must be one of: off, on, retain-on-failure. Received: "${String(e)}"`)}export function coerceAndValidateArgs(e,t){const r={...t};for(const n of e){const o=r[n.name];if(n.required&&(o===void 0||o===null||o===""))throw new d(`Argument "${n.name}" is required.`,n.help??`Provide a value for --${n.name}`);if(o!==void 0&&o!==null){if(n.type==="int"||n.type==="number"){const f=Number(o);if(Number.isNaN(f))throw new d(`Argument "${n.name}" must be a valid number. Received: "${o}"`);r[n.name]=f}else if(n.type==="boolean"||n.type==="bool")if(typeof o==="string"){const f=o.toLowerCase();if(f==="true"||f==="1")r[n.name]=!0;else if(f==="false"||f==="0")r[n.name]=!1;else throw new d(`Argument "${n.name}" must be a boolean (true/false). Received: "${o}"`)}else r[n.name]=Boolean(o);const s=r[n.name];if(n.choices&&n.choices.length>0){if(!n.choices.map(String).includes(String(s)))throw new d(`Argument "${n.name}" must be one of: ${n.choices.join(", ")}. Received: "${s}"`)}}else if(n.default!==void 0)r[n.name]=n.default}return r}async function U(e,t,r,n){const o=e;if(o._lazy&&o._modulePath){const s=o._modulePath;if(s.startsWith(Re)&&S.has(s))try{const m=N.statSync(s),i=B.get(s);if(i!==void 0&&m.mtimeMs!==i)S.delete(s)}catch{}if(!S.has(s)){const m=ie(s).href,w=import(B.has(s)?`${m}?t=${Date.now()}`:m).then(()=>{try{B.set(s,N.statSync(s).mtimeMs)}catch{}},(p)=>{S.delete(s);throw ae(`Failed to load adapter module ${s}: ${D(p)}`,"Check that the adapter file exists and has no syntax errors.")});S.set(s,w)}await S.get(s);const u=oe().get(g(e));if(u?.func)return Y(u,t,r,n);if(u?.pipeline)return V(t,u.pipeline,{args:r,debug:n})}if(e.func)return Y(e,t,r,n);if(e.pipeline)return V(t,e.pipeline,{args:r,debug:n});throw new x(`Command ${g(e)} has no func or pipeline`,"This is likely a bug in the adapter definition. Please report this issue.")}function Y(e,t,r,n){if(e.browser===!1)return e.func(r,n);if(!t)throw new x(`Command ${g(e)} requires a browser session but none was provided`);return e.func(t,r,n)}function Ne(e){if(e.navigateBefore===!1)return null;if(typeof e.navigateBefore==="string")return e.navigateBefore;return null}function Me(e,t){if(!e||!t)return!1;try{const r=new URL(e).hostname;return r===t||r.endsWith(`.${t}`)}catch{return!1}}function De(e,t){if(!t)return!1;try{const r=new URL(e),n=r.hostname===t||r.hostname.endsWith(`.${t}`),o=r.pathname===""||r.pathname==="/";return n&&o&&r.search===""&&r.hash===""}catch{return!1}}async function ke(e,t,r,n){if(r!=="persistent"||!e.domain)return!0;if(!De(n,e.domain))return!0;const o=await t.getCurrentUrl?.().catch(()=>null);return!Me(o,e.domain)}export async function executeCommand(e,t,r=!1,n={}){let o;try{o=n.prepared?t:prepareCommandArgs(e,t)}catch(i){if(i instanceof d)throw i;throw new d(D(i))}const s=qe(e,o);be(s);const f=Ie(n.trace),u={command:g(e),args:o,startedAt:Date.now()};await k("onBeforeExecute",u);let m;try{if(le(e)){const i=Ee(e.site),w=he(n.profile),p=!i&&w.kind==="managed"?w:null;let P;const A=Le(e.defaultWindowMode??"background",n.windowMode);let F,W;if(p){P=await we(p.name,p.entry,{windowMode:A});const c=p.entry.fingerprint;if(c?.enabled)F=ge(c);const a=p.entry.proxy;if(a?.username)W={username:a.username,password:a.password??""}}else if(i){const c=process.env.OPENCLI_CDP_ENDPOINT;if(c){const a=Number(new URL(c).port);if(!await Pe(a))throw new x(`CDP not reachable at ${c}`,"Check that the app is running with --remote-debugging-port and the endpoint is correct.");P=c}else P=await xe(e.site)}const re=p?ye:fe(e.site),L=!p&&w.kind==="extension"?w.contextId:void 0,ne=e,b=_e(e,n.siteSession),C=Oe(e,b),q=We(b,n.keepTab),y=b==="persistent"&&e.access==="write"?{runId:Se(),session:C}:null;if(y)Q({runId:y.runId,command:g(e),access:"write"});let z,H=!1,T=null;try{m=await pe(A!=="foreground",()=>me(re,async(c)=>{const a=f==="off"?null:new Ae({scope:{contextId:L??p?.name,session:C,target:c.getActivePage?.(),site:e.site,command:g(e),adapterSourcePath:Te(ne)}});if(a){a.record({stream:"action",name:"command",phase:"start",data:{args:o}});await c.startNetworkCapture?.().catch(()=>!1)}const h=Ne(e);if(h&&await ke(e,c,b,h)){a?.record({stream:"action",name:"pre_navigate",phase:"start",data:{url:h}});try{await c.goto(h);a?.record({stream:"action",name:"pre_navigate",phase:"end",data:{url:h}})}catch(l){if(l instanceof ce)throw l;a?.record({stream:"action",name:"pre_navigate",phase:"error",data:{url:h,error:l instanceof Error?l.message:String(l)}});const v=new x(`Pre-navigation to ${h} failed: ${l instanceof Error?l.message:l}`,"Check that the site is reachable and the browser extension is running.");v.cause=l;if(a&&(f==="on"||f==="retain-on-failure")){a.record({stream:"error",message:v.message,stack:v.stack,code:v.code,hint:v.hint});await _(a,c).catch(()=>{});O(a,"failure",v,n.onTraceExport)}throw v}}const E=s!==null?s+Z:de,R=U(e,c,o,r);T=R;let I=!1;R.then(()=>{I=!0},()=>{I=!0});try{const l=await G(R,{timeout:E,label:g(e),hint:te(e,s)});a?.record({stream:"action",name:"command",phase:"end"});if(a&&f==="on"){await _(a,c).catch(()=>{});O(a,"success",void 0,n.onTraceExport)}if(!q)await c.closeWindow?.().catch(()=>{});return l}catch(l){if(!I)H=!0;if(a){a.record({stream:"action",name:"command",phase:"error",data:{error:l instanceof Error?l.message:String(l)}});a.record({stream:"error",message:l instanceof Error?l.message:String(l),stack:l instanceof Error?l.stack:void 0});if(f==="on"||f==="retain-on-failure"){await _(a,c).catch(()=>{});O(a,"failure",l,n.onTraceExport)}}if(!q)await c.closeWindow?.().catch(()=>{});throw l}},{session:C,cdpEndpoint:P,contextId:L,windowMode:A,surface:"adapter",siteSession:b,initScript:F,proxyAuth:W}),p?.name)}catch(c){z=c;throw c}finally{if(y)if(H&&T){const{runId:c,session:a}=y,h=(E)=>{ve(c);if(!J(E))K({runId:c,session:a,surface:"adapter"})};T.then(()=>h(),(E)=>h(E))}else{Q(null);if(!J(z))await K({runId:y.runId,session:y.session,surface:"adapter"})}}}else if(s!==null){const i=s+Z;m=await G(U(e,null,o,r),{timeout:i,label:g(e),hint:te(e,s)})}else m=await U(e,null,o,r)}catch(i){u.error=i;u.finishedAt=Date.now();await k("onAfterExecute",u);throw i}u.finishedAt=Date.now();await k("onAfterExecute",u,m);return m}async function _(e,t){const r=t.getActivePage?.()??e.scope.target,[n,o,s,f,u]=await Promise.all([t.getCurrentUrl?.().catch(()=>null)??Promise.resolve(null),t.snapshot().catch(()=>{return}),t.readNetworkCapture?.().catch(()=>[])??Promise.resolve([]),t.consoleMessages("all").catch(()=>[]),t.screenshot({format:"png"}).catch(()=>{return})]);if(o!==void 0||n!==void 0)e.record({stream:"state",url:n,target:r,snapshot:o,label:"final"});for(const m of Array.isArray(s)?s:[]){const i=m;e.record({stream:"network",url:String(i.url??""),method:typeof i.method==="string"?i.method:void 0,status:typeof i.responseStatus==="number"?i.responseStatus:void 0,contentType:typeof i.responseContentType==="string"?i.responseContentType:void 0,size:typeof i.responseBodyFullSize==="number"?i.responseBodyFullSize:void 0,requestHeaders:i.requestHeaders,responseHeaders:i.responseHeaders,requestBody:i.requestBodyPreview,responseBody:i.responsePreview,ts:typeof i.timestamp==="number"?i.timestamp:void 0})}for(const m of Array.isArray(f)?f:[])if(m&&typeof m==="object"){const i=m;e.record({stream:"console",level:String(i.type??i.level??"log"),text:String(i.text??i.message??""),ts:typeof i.timestamp==="number"?i.timestamp:void 0})}else e.record({stream:"console",level:"log",text:String(m)});if(typeof u==="string"&&u)e.record({stream:"screenshot",format:"png",data:u,label:"final"})}function O(e,t,r,n){try{const o=Ce(e,{error:r,status:t});if(t==="failure"&&r!==void 0)ue(r,o.receipt);else process.stderr.write(`ppcli trace artifact: ${o.dir}
+`);try{n?.(o)}catch(s){X.warn(`[trace] Trace export callback failed: ${s instanceof Error?s.message:String(s)}`)}return o}catch(o){X.warn(`[trace] Failed to export trace artifact: ${o instanceof Error?o.message:String(o)}`);return}}export function resolveFileBackedArg(e,t){const r=e.args.find((u)=>u.fromFile);if(!r)return;const n=typeof r.fromFile==="string"?r.fromFile:"file",o=r.positional?`<${r.name}>`:`--${r.name}`,s=t[n]==null?"":String(t[n]).trim(),f=t[r.name]==null?"":String(t[r.name]);if(s){if(f.trim())throw new d(`${o} 和 --${n} 只能二选一，不能同时给`);const u=M.resolve(s.startsWith("~/")?M.join(j.homedir(),s.slice(2)):s);let m;try{m=N.readFileSync(u,"utf-8")}catch(w){throw new d(`--${n} 指向的文件读不到: ${u}（${D(w)}）`)}const i=m.trim();if(!i)throw new d(`--${n} 指向的文件内容为空: ${u}`);t[r.name]=i;$e(M.dirname(u));return}if(!f.trim()&&r.requiredUnlessFile)throw new d(`缺少 ${r.name}：${o} 或 --${n} 给其一`)}export function prepareCommandArgs(e,t){const r=coerceAndValidateArgs(e.args,t);resolveFileBackedArg(e,r);e.validateArgs?.(r);return r}const Z=30;function Be(e){if(e===void 0||e===null||e==="")return null;if(e==="ephemeral"||e==="persistent")return e;throw new d(`--site-session must be one of: ephemeral, persistent. Received: "${String(e)}"`)}function Ue(){const e=process.env.PUBLISHPORT_SITE_SESSION;if(e==="persistent"||e==="ephemeral")return e;return null}function _e(e,t){return Be(t)??Ue()??e.siteSession??"persistent"}function Oe(e,t){if(t==="persistent")return`site:${e.site}`;return`site:${e.site}:${se.randomUUID()}`}function Fe(e,t){if(t===void 0||t==="")return null;if(t==="true")return!0;if(t==="false")return!1;throw new d(`${e} must be one of: true, false. Received: "${String(t)}"`)}function We(e,t){if(e==="persistent")return!0;return Fe("--keep-tab",t)??!1}function ee(e,t){if(t===void 0||t==="")return null;if(t==="foreground"||t==="background")return t;throw new d(`${e} must be one of: foreground, background. Received: "${String(t)}"`)}function Le(e="background",t){return ee("--window",t)??ee("OPENCLI_WINDOW",process.env.OPENCLI_WINDOW)??e}function te(e,t){const r=e.access==="write"?"⚠️ 这是写操作，超时不代表没写成功——请求可能已经到达平台。禁止直接重试："+"先用该平台的列表/统计命令（stats / lists / articles 等）按标题回查，确认没写进去再重发。 ":"";if(t!==null)return`${r}Pass a higher --timeout value (currently ${t}s)`;if(e.args.some((n)=>n.name==="timeout"))return`${r}Try again, or pass a higher --timeout <seconds>`;return r+"This command has no --timeout option. Retry once; if it keeps timing out, "+"the page or browser bridge is likely stuck — have the user reopen the PublishPort client. "+"The global default can be raised with OPENCLI_BROWSER_COMMAND_TIMEOUT."}function qe(e,t){if(!e.args.some((o)=>o.name==="timeout"))return null;const r=t.timeout;if(r===void 0||r===null||r==="")throw new d(`Argument "timeout" must be a positive integer. Received: "${String(r)}"`);const n=Number(r);if(!Number.isInteger(n)||n<=0)throw new d(`Argument "timeout" must be a positive integer. Received: "${String(r)}"`);return n}

package/dist/src/external.js

@@ -1 +1 @@
-import*as V from"node:fs";import*as Z from"node:path";import*as Y from"node:os";import{fileURLToPath as F}from"node:url";import{spawnSync as M,execFileSync as L}from"node:child_process";import q from"js-yaml";import{log as N}from"./logger.js";import{EXIT_CODES as v,getErrorMessage as W}from"./errors.js";import{enforceRateLimit as O}from"./rate-limit.js";const X=Z.dirname(F(import.meta.url));function U(){const z=Y.homedir();return Z.join(z,".ppcli","external-clis.yaml")}let $=null;export function loadExternalClis(){if($)return $;const z=new Map,A=Z.resolve(X,"external-clis.yaml");try{if(V.existsSync(A)){const J=V.readFileSync(A,"utf8"),G=q.load(J)||[];for(const K of G)z.set(K.name,K)}}catch(J){N.warn(`Failed to parse built-in external-clis.yaml: ${W(J)}`)}const H=U();try{if(V.existsSync(H)){const J=V.readFileSync(H,"utf8"),G=q.load(J)||[];for(const K of G)z.set(K.name,K)}}catch(J){N.warn(`Failed to parse user external-clis.yaml: ${W(J)}`)}$=Array.from(z.values()).sort((J,G)=>J.name.localeCompare(G.name));return $}export function isBinaryInstalled(z){try{const A=Y.platform()==="win32";L(A?"where":"which",[z],{stdio:"ignore"});return!0}catch{return!1}}export function getInstallCmd(z){if(!z)return null;const A=Y.platform();if(A==="darwin"&&z.mac)return z.mac;if(A==="linux"&&z.linux)return z.linux;if(A==="win32"&&z.windows)return z.windows;if(z.default)return z.default;return null}export function formatExternalCliLabel(z){return z.package&&z.package!==z.name?`${z.name}(${z.package})`:z.name}export function parseCommand(z){if(/&&|\|\|?|;|[><`$#\n\r]|\$\(/.test(z))throw Error(`Install command contains unsafe shell operators and cannot be executed securely: "${z}". Please install the tool manually.`);const H=[],J=/(?:"([^"]*)")|(?:'([^']*)')|(\S+)/g;let G;while((G=J.exec(z))!==null)H.push(G[1]??G[2]??G[3]);if(H.length===0)throw Error("Install command is empty.");const[K,...Q]=H;return{binary:K,args:Q}}function R(z,A){const H=A instanceof Error?A.code:void 0;return Y.platform()==="win32"&&!Z.extname(z)&&H==="ENOENT"}function T(z){const{binary:A,args:H}=parseCommand(z);try{L(A,H,{stdio:"inherit"})}catch(J){if(R(A,J)){L(`${A}.cmd`,H,{stdio:"inherit"});return}throw J}}export function installExternalCli(z){if(!z.install){N.error(`No auto-install command configured for '${z.name}'.`);N.info(`Please install '${z.binary}' manually.`);return!1}const A=getInstallCmd(z.install);if(!A){N.error(`No install command for your platform (${Y.platform()}) for '${z.name}'.`);if(z.homepage)N.info(`See: ${z.homepage}`);return!1}N.info(`'${z.name}' is not installed. Auto-installing...`);N.verbose(`$ ${A}`);try{T(A);N.success(`Installed '${z.name}' successfully.`);return!0}catch(H){N.error(`Failed to install '${z.name}': ${W(H)}`);return!1}}export function executeExternalCli(z,A,H){const G=(H??loadExternalClis()).find((Q)=>Q.name===z);if(!G)throw Error(`External CLI '${z}' not found in registry.`);O(z);if(!isBinaryInstalled(G.binary)){if(!installExternalCli(G)){process.exitCode=v.SERVICE_UNAVAIL;return}}const K=k(G.binary,A);if(K.error){N.error(`Failed to execute '${G.binary}': ${K.error.message}`);process.exitCode=v.GENERIC_ERROR;return}if(K.status!==null)process.exitCode=K.status;else if(K.signal){const Q=K.signal;process.exitCode=Q==="SIGINT"?v.INTERRUPTED:Y.constants.signals[Q]?128+Y.constants.signals[Q]:v.GENERIC_ERROR}}function D(z){if(z!==""&&!/[\s"^&|<>%()]/.test(z))return z;return`"${z.replace(/"/g,'""')}"`}function k(z,A){const H=M(z,A,{stdio:"inherit"}),J=H.error?.code;if(Y.platform()==="win32"&&(J==="EINVAL"||J==="ENOENT")){const G=[z,...A].map(D).join(" ");return M(G,{stdio:"inherit",shell:!0})}return H}export function registerExternalCli(z,A){const H=U(),J=Z.dirname(H);if(!V.existsSync(J))V.mkdirSync(J,{recursive:!0});let G=[];if(V.existsSync(H))try{const B=V.readFileSync(H,"utf8");G=q.load(B)||[]}catch{}const K=G.findIndex((B)=>B.name===z),Q={name:z,binary:A?.binary||z};if(A?.description)Q.description=A.description;if(A?.install)Q.install={default:A.install};if(K>=0){G[K]={...G[K],...Q};N.success(`Updated '${z}' in user registry.`)}else{G.push(Q);N.success(`Registered '${z}' in user registry.`)}const j=q.dump(G,{indent:2,sortKeys:!0});V.writeFileSync(H,j,"utf8");$=null;N.verbose(H)}
+import*as l from"node:fs";import*as u from"node:path";import*as c from"node:os";import{fileURLToPath as g}from"node:url";import{spawnSync as x,execFileSync as h}from"node:child_process";import m from"js-yaml";import{log as i}from"./logger.js";import{EXIT_CODES as d,getErrorMessage as y}from"./errors.js";import{enforceRateLimit as I}from"./rate-limit.js";const S=u.dirname(g(import.meta.url));function w(){const e=c.homedir();return u.join(e,".ppcli","external-clis.yaml")}let f=null;export function loadExternalClis(){if(f)return f;const e=new Map,r=u.resolve(S,"external-clis.yaml");try{if(l.existsSync(r)){const s=l.readFileSync(r,"utf8"),t=m.load(s)||[];for(const o of t)e.set(o.name,o)}}catch(s){i.warn(`Failed to parse built-in external-clis.yaml: ${y(s)}`)}const n=w();try{if(l.existsSync(n)){const s=l.readFileSync(n,"utf8"),t=m.load(s)||[];for(const o of t)e.set(o.name,o)}}catch(s){i.warn(`Failed to parse user external-clis.yaml: ${y(s)}`)}f=Array.from(e.values()).sort((s,t)=>s.name.localeCompare(t.name));return f}export function isBinaryInstalled(e){try{const r=c.platform()==="win32";h(r?"where":"which",[e],{stdio:"ignore"});return!0}catch{return!1}}export function getInstallCmd(e){if(!e)return null;const r=c.platform();if(r==="darwin"&&e.mac)return e.mac;if(r==="linux"&&e.linux)return e.linux;if(r==="win32"&&e.windows)return e.windows;if(e.default)return e.default;return null}export function formatExternalCliLabel(e){return e.package&&e.package!==e.name?`${e.name}(${e.package})`:e.name}export function parseCommand(e){if(/&&|\|\|?|;|[><`$#\n\r]|\$\(/.test(e))throw Error(`Install command contains unsafe shell operators and cannot be executed securely: "${e}". Please install the tool manually.`);const n=[],s=/(?:"([^"]*)")|(?:'([^']*)')|(\S+)/g;let t;while((t=s.exec(e))!==null)n.push(t[1]??t[2]??t[3]);if(n.length===0)throw Error("Install command is empty.");const[o,...a]=n;return{binary:o,args:a}}function R(e,r){const n=r instanceof Error?r.code:void 0;return c.platform()==="win32"&&!u.extname(e)&&n==="ENOENT"}function C(e){const{binary:r,args:n}=parseCommand(e);try{h(r,n,{stdio:"inherit"})}catch(s){if(R(r,s)){h(`${r}.cmd`,n,{stdio:"inherit"});return}throw s}}export function installExternalCli(e){if(!e.install){i.error(`No auto-install command configured for '${e.name}'.`);i.info(`Please install '${e.binary}' manually.`);return!1}const r=getInstallCmd(e.install);if(!r){i.error(`No install command for your platform (${c.platform()}) for '${e.name}'.`);if(e.homepage)i.info(`See: ${e.homepage}`);return!1}i.info(`'${e.name}' is not installed. Auto-installing...`);i.verbose(`$ ${r}`);try{C(r);i.success(`Installed '${e.name}' successfully.`);return!0}catch(n){i.error(`Failed to install '${e.name}': ${y(n)}`);return!1}}export function executeExternalCli(e,r,n){const t=(n??loadExternalClis()).find((a)=>a.name===e);if(!t)throw Error(`External CLI '${e}' not found in registry.`);I(e);if(!isBinaryInstalled(t.binary)){if(!installExternalCli(t)){process.exitCode=d.SERVICE_UNAVAIL;return}}const o=N(t.binary,r);if(o.error){i.error(`Failed to execute '${t.binary}': ${o.error.message}`);process.exitCode=d.GENERIC_ERROR;return}if(o.status!==null)process.exitCode=o.status;else if(o.signal){const a=o.signal;process.exitCode=a==="SIGINT"?d.INTERRUPTED:c.constants.signals[a]?128+c.constants.signals[a]:d.GENERIC_ERROR}}function b(e){if(e!==""&&!/[\s"^&|<>%()]/.test(e))return e;return`"${e.replace(/"/g,'""')}"`}function N(e,r){const n=x(e,r,{stdio:"inherit"}),s=n.error?.code;if(c.platform()==="win32"&&(s==="EINVAL"||s==="ENOENT")){const t=[e,...r].map(b).join(" ");return x(t,{stdio:"inherit",shell:!0})}return n}export function registerExternalCli(e,r){const n=w(),s=u.dirname(n);if(!l.existsSync(s))l.mkdirSync(s,{recursive:!0});let t=[];if(l.existsSync(n))try{const p=l.readFileSync(n,"utf8");t=m.load(p)||[]}catch{}const o=t.findIndex((p)=>p.name===e),a={name:e,binary:r?.binary||e};if(r?.description)a.description=r.description;if(r?.install)a.install={default:r.install};if(o>=0){t[o]={...t[o],...a};i.success(`Updated '${e}' in user registry.`)}else{t.push(a);i.success(`Registered '${e}' in user registry.`)}const E=m.dump(t,{indent:2,sortKeys:!0});l.writeFileSync(n,E,"utf8");f=null;i.verbose(n)}

package/dist/src/help.js

@@ -1,8 +1,8 @@
-import w from"js-yaml";import{fullName as N}from"./registry.js";import{formatCommandExample as k}from"./serialization.js";const I=[{flags:"-f, --format <fmt>",name:"format",help:"Output format: table, plain, json, yaml, md, csv",default:"table",choices:["table","plain","json","yaml","md","csv"]},{flags:"--trace <mode>",name:"trace",help:"Trace capture: off, on, retain-on-failure",default:"off",choices:["off","on","retain-on-failure"]},{flags:"-v, --verbose",name:"verbose",help:"Debug output",default:!1},{flags:"-h, --help",name:"help",help:"display help for command"}],E=[{flags:"--window <mode>",name:"window",help:"Browser window mode: foreground or background",choices:["foreground","background"]},{flags:"--site-session <mode>",name:"site-session",help:"Adapter site session lifecycle: ephemeral or persistent",choices:["ephemeral","persistent"]},{flags:"--keep-tab <bool>",name:"keep-tab",help:"Keep the browser tab lease after the command finishes",choices:["true","false"]}];function _(j){const y=j?.toLowerCase();if(y==="yaml"||y==="yml")return"yaml";if(y==="json")return"json";return}export function getRequestedHelpFormat(j=process.argv){for(let y=0;y<j.length;y++){const G=j[y];if(G==="-f"||G==="--format")return _(j[y+1]);if(G.startsWith("--format="))return _(G.slice(9));if(G.startsWith("-f")&&G.length>2)return _(G.slice(2))}return}export function renderStructuredHelp(j,y){if(y==="json")return`${JSON.stringify(j,null,2)}
-`;return w.dump(j,{sortKeys:!1,lineWidth:120,noRefs:!0})}export function wrapCommaList(j,y={}){const G=Math.max(y.width??process.stdout.columns??100,40),K=y.indent??"  ",J=[...j].sort((Z,A)=>Z.localeCompare(A)),Q=[];let V=K;J.forEach((Z,A)=>{const D=`${Z}${A<J.length-1?",":""}`,q=V===K?"":" ";if(V.length+q.length+D.length>G&&V.trim()){Q.push(V);V=`${K}${D}`}else V+=`${q}${D}`});if(V.trim())Q.push(V);return Q.join(`
-`)}function h(j){if(j==="::1"||j==="[::1]")return!0;const y=j.split(".");if(y.length!==4)return!1;return y.every((G)=>/^\d+$/.test(G)&&Number(G)>=0&&Number(G)<=255)&&Number(y[0])===127}export function classifyAdapter(j){if(!j)return"site";if(h(j))return"app";return j.includes(".")?"site":"app"}function F(j,y){if(y.length===0)return[];return[`${j} (${y.length}):`,wrapCommaList(y),""]}export function formatRootAdapterHelpText(j){if(j.external.length+j.apps.length+j.sites.length===0)return"";const G=[""];G.push(...F("External CLIs",j.external.map((K)=>K.label)));G.push(...F("App adapters",j.apps));G.push(...F("Site adapters",j.sites));G.push("Run 'ppcli list' for full command details, or 'ppcli <site> --help' to inspect one site.");G.push("Agent tip: use 'ppcli <site> --help -f yaml' for all command args/options in one structured response.");G.push("");return G.join(`
-`)}function H(j){return{name:j.name,...j.type&&j.type!=="string"?{type:j.type}:{},...j.positional?{positional:!0}:{},...j.required?{required:!0}:{},...j.valueRequired?{valueRequired:!0}:{},...j.default!==void 0?{default:j.default}:{},...j.choices?.length?{choices:j.choices}:{},...j.help?{help:j.help}:{}}}function $(j){return{name:j.name,flags:j.flags,help:j.help,..."default"in j?{default:j.default}:{},..."choices"in j?{choices:j.choices}:{}}}function x(j){return{name:j.name(),...j.required?{required:!0}:{},...j.variadic?{variadic:!0}:{},...j.description?{help:j.description}:{},...j.defaultValue!==void 0?{default:j.defaultValue}:{},...j.argChoices?.length?{choices:[...j.argChoices]}:{}}}function f(j){if(j.hidden)return null;return{name:j.attributeName(),flags:j.flags,...j.description?{help:j.description}:{},...j.required?{takes_value:"required"}:{},...j.optional?{takes_value:"optional"}:{},...j.mandatory?{required:!0}:{},...j.defaultValue!==void 0?{default:j.defaultValue}:{},...j.argChoices?.length?{choices:[...j.argChoices]}:{},...j.negate?{negate:!0}:{}}}function W(j){return j.map(f).filter((y)=>y!==null)}export function leadingPositionalFromUsage(j){const y=j._usage;if(!y)return null;const G=y.match(/^\s*(<[^>]+>)/);return G?G[1]:null}function X(j){const y=[];let G=j;while(G){const K=G.name();if(K){y.push(K);const J=leadingPositionalFromUsage(G);if(J&&y.length>1)y.splice(y.length-1,0,J)}G=G.parent}return y.reverse()}function Y(j,y){const G=X(j);return X(y).slice(G.length).filter((J)=>!/^<.+>$/.test(J))}function z(j){if(j.commands.length===0)return[j];return j.commands.flatMap((y)=>z(y))}function b(j){return j.commands.flatMap((y)=>[y,...b(y)])}function O(j){return j.map((y)=>{const G=`${y.name()}${y.variadic?"...":""}`;return y.required?`<${G}>`:`[${G}]`}).join(" ")}function C(j,y={}){const G=X(j).join(" "),K=O(j.registeredArguments),Q=W(j.options).length>0||(y.namespaceRoot?W(y.namespaceRoot.options).length>0:!1)||(y.globalCommand?W(y.globalCommand.options).length>0:!1)?" [options]":"";return`${G}${K?` ${K}`:""}${Q}`}function L(j,y,G={}){return{name:Y(j,y).join(" "),command:X(y).join(" "),usage:C(y,{namespaceRoot:j,globalCommand:G.globalCommand}),description:y.description(),...y.aliases().length?{aliases:y.aliases()}:{},positionals:y.registeredArguments.map(x),command_options:W(y.options)}}export function commanderNamespaceHelpData(j,y={}){const G=z(j).filter((V)=>V!==j).sort((V,Z)=>Y(j,V).join(" ").localeCompare(Y(j,Z).join(" "))),K=X(j).join(" "),J=j._usage,Q=J?`${K} ${J}`:`${K} <command> [args] [options]`;return{namespace:j.name(),command:K,usage:Q,description:y.description??j.description(),command_count:G.length,commands:G.map((V)=>L(j,V,y)),namespace_options:W(j.options),...y.globalCommand?{global_options:W(y.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${K} --help -f yaml`}}}export function commanderCommandHelpData(j,y,G={}){return{namespace:j.name(),...L(j,y,G),namespace_options:W(j.options),...G.globalCommand?{global_options:W(G.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${X(y).join(" ")} --help -f yaml`}}}export function commanderGroupHelpData(j,y,G={}){const K=z(y).filter((J)=>J!==y).sort((J,Q)=>Y(j,J).join(" ").localeCompare(Y(j,Q).join(" ")));return{namespace:j.name(),group:Y(j,y).join(" "),command:X(y).join(" "),usage:`${X(y).join(" ")} <command> [args] [options]`,description:y.description(),command_count:K.length,commands:K.map((J)=>L(j,J,G)),namespace_options:W(j.options),...G.globalCommand?{global_options:W(G.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${X(y).join(" ")} --help -f yaml`}}}export function installCommanderNamespaceStructuredHelp(j,y={}){installStructuredHelp(j,()=>commanderNamespaceHelpData(j,y));for(const G of b(j))if(G.commands.length>0)installStructuredHelp(G,()=>commanderGroupHelpData(j,G,y));else installStructuredHelp(G,()=>commanderCommandHelpData(j,G,y))}function U(j){return j.args.filter((y)=>y.positional)}function M(j){return j.args.filter((y)=>!y.positional)}function v(j){return j.map((y)=>y.required?`<${y.name}>`:`[${y.name}]`).join(" ")}function R(j){if(j.required||j.valueRequired)return`--${j.name} <value>`;return`--${j.name} [value]`}export function formatCommandListTerm(j){const y=v(U(j)),G=M(j).length>0?" [options]":"";return`${j.name}${y?` ${y}`:""}${G}`}function T(j){const y=v(U(j));return`ppcli ${j.site} ${j.name}${y?` ${y}`:""} [options]`}function S(j){return{name:j.name,command:`ppcli ${j.site} ${j.name}`,usage:T(j),access:j.access,description:j.description,browser:!!j.browser,...j.domain?{domain:j.domain}:{},...j.aliases?.length?{aliases:j.aliases}:{},positionals:U(j).map(H),command_options:M(j).map(H),...j.browser?{browser_common_options:E.map($)}:{},example:k(j),...j.siteSession?{siteSession:j.siteSession}:{},...j.defaultFormat?{defaultFormat:j.defaultFormat}:{},...j.columns?.length?{columns:j.columns}:{}}}export function rootHelpData(j,y){const G=new Set([...y.external.map((Q)=>Q.name),...y.apps,...y.sites]),K=j.commands.filter((Q)=>!G.has(Q.name())).map((Q)=>({name:Q.name(),description:Q.description()})),J=(Q,V)=>Q.localeCompare(V);return{name:j.name(),description:j.description(),commands:K,external_clis:{count:y.external.length,clis:y.external.map((Q)=>Q.name).sort(J),display:y.external.map((Q)=>Q.label).sort(J)},app_adapters:{count:y.apps.length,apps:[...y.apps].sort(J)},site_adapters:{count:y.sites.length,sites:[...y.sites].sort(J)},next:["ppcli <site> --help -f yaml","ppcli list -f yaml","ppcli <site> <command> -f yaml"]}}export function siteHelpData(j,y){const G=[...new Map(y.map((K)=>[N(K),K])).values()].sort((K,J)=>K.name.localeCompare(J.name));return{site:j,command_count:G.length,commands:G.map((K)=>S(K)),common_options:I.map($),...G.some((K)=>K.browser)?{browser_common_options:E.map($)}:{},next:[`ppcli ${j} <command> --help -f yaml`,`ppcli ${j} <command> -f yaml`]}}export function commandHelpData(j){return{site:j.site,...S(j),common_options:I.map($),...j.browser?{browser_common_options:E.map($)}:{},output_formats:["table","plain","yaml","json","md","csv"]}}function B(j){if(j.length===0)return[];const y=Math.min(Math.max(...j.map(([G])=>G.length)),34);return j.map(([G,K])=>`  ${G.padEnd(y+2)}${K}`)}function P(j){const y=[];if(j.help)y.push(j.help);if(j.default!==void 0)y.push(`default: ${j.default}`);if(j.choices?.length)y.push(`choices: ${j.choices.join(", ")}`);return y.join("  ")}export function formatCommonOptionsHelpText(){const j=I.map((y)=>{const G=[y.help];if("default"in y)G.push(`default: ${y.default}`);if("choices"in y)G.push(`choices: ${y.choices.join(", ")}`);return[y.flags,G.join("  ")]});return["Common options:",...B(j)].join(`
-`)}export function formatBrowserCommonOptionsHelpText(){const j=E.map((y)=>{const G=[y.help];if("choices"in y)G.push(`choices: ${y.choices.join(", ")}`);return[y.flags,G.join("  ")]});return["Browser common options:",...B(j)].join(`
-`)}export function formatSiteHelpText(j,y){const G=[...new Map(y.map((J)=>[N(J),J])).values()].sort((J,Q)=>J.name.localeCompare(Q.name));return[`Usage: ppcli ${j} <command> [args] [options]`,"",wrapCommaList(G.map((J)=>J.name),{indent:""}),"","Commands:",...B(G.map((J)=>[formatCommandListTerm(J),formatSiteCommandDescription(J)])),"",formatCommonOptionsHelpText(),...G.some((J)=>J.browser)?["",formatBrowserCommonOptionsHelpText()]:[],"",`Agent tip: use 'ppcli ${j} --help -f yaml' to get all command args/options in one structured response.`,""].join(`
-`)}export function formatCommandHelpText(j){const y=[`Usage: ${T(j)}`,"",j.description,""],G=U(j).map((Q)=>[Q.name,P(Q)]);if(G.length)y.push("Arguments:",...B(G),"");const K=M(j).map((Q)=>[R(Q),P(Q)]);if(K.length)y.push("Command options:",...B(K),"");y.push(formatCommonOptionsHelpText(),"");if(j.browser)y.push(formatBrowserCommonOptionsHelpText(),"");const J=[];J.push(`Access: ${j.access}`);J.push(`Browser: ${j.browser?"yes":"no"}`);if(j.domain)J.push(`Domain: ${j.domain}`);if(j.defaultFormat)J.push(`Default format: ${j.defaultFormat}`);if(j.aliases?.length)J.push(`Aliases: ${j.aliases.join(", ")}`);y.push(J.join(" | "));y.push(`Example: ${k(j)}`);if(j.columns?.length)y.push(`Output columns: ${j.columns.join(", ")}`);y.push("Agent tip: use '--help -f yaml' for structured args/options.");y.push("");return y.join(`
-`)}export function installStructuredHelp(j,y,G){const K=j.helpInformation.bind(j);j.helpInformation=(J)=>{const Q=getRequestedHelpFormat();if(Q)return renderStructuredHelp(y(),Q);const V=typeof G==="function"?G():G??"";return K(J)+V}}export function formatSiteCommandDescription(j){return`${j.access==="write"?"[write]":"[read]"} ${j.description}`}
+import P from"js-yaml";import{fullName as v}from"./registry.js";import{formatCommandExample as O}from"./serialization.js";const b=[{flags:"-f, --format <fmt>",name:"format",help:"Output format: table, plain, json, yaml, md, csv",default:"table",choices:["table","plain","json","yaml","md","csv"]},{flags:"--trace <mode>",name:"trace",help:"Trace capture: off, on, retain-on-failure",default:"off",choices:["off","on","retain-on-failure"]},{flags:"-v, --verbose",name:"verbose",help:"Debug output",default:!1},{flags:"-h, --help",name:"help",help:"display help for command"}],f=[{flags:"--window <mode>",name:"window",help:"Browser window mode: foreground or background",choices:["foreground","background"]},{flags:"--site-session <mode>",name:"site-session",help:"Adapter site session lifecycle: ephemeral or persistent",choices:["ephemeral","persistent"]},{flags:"--keep-tab <bool>",name:"keep-tab",help:"Keep the browser tab lease after the command finishes",choices:["true","false"]}];function x(e){const n=e?.toLowerCase();if(n==="yaml"||n==="yml")return"yaml";if(n==="json")return"json";return}export function getRequestedHelpFormat(e=process.argv){for(let n=0;n<e.length;n++){const t=e[n];if(t==="-f"||t==="--format")return x(e[n+1]);if(t.startsWith("--format="))return x(t.slice(9));if(t.startsWith("-f")&&t.length>2)return x(t.slice(2))}return}export function renderStructuredHelp(e,n){if(n==="json")return`${JSON.stringify(e,null,2)}
+`;return P.dump(e,{sortKeys:!1,lineWidth:120,noRefs:!0})}export function wrapCommaList(e,n={}){const t=Math.max(n.width??process.stdout.columns??100,40),s=n.indent??"  ",o=[...e].sort((m,d)=>m.localeCompare(d)),a=[];let i=s;o.forEach((m,d)=>{const g=`${m}${d<o.length-1?",":""}`,_=i===s?"":" ";if(i.length+_.length+g.length>t&&i.trim()){a.push(i);i=`${s}${g}`}else i+=`${_}${g}`});if(i.trim())a.push(i);return a.join(`
+`)}function D(e){if(e==="::1"||e==="[::1]")return!0;const n=e.split(".");if(n.length!==4)return!1;return n.every((t)=>/^\d+$/.test(t)&&Number(t)>=0&&Number(t)<=255)&&Number(n[0])===127}export function classifyAdapter(e){if(!e)return"site";if(D(e))return"app";return e.includes(".")?"site":"app"}function C(e,n){if(n.length===0)return[];return[`${e} (${n.length}):`,wrapCommaList(n),""]}export function formatRootAdapterHelpText(e){if(e.external.length+e.apps.length+e.sites.length===0)return"";const t=[""];t.push(...C("External CLIs",e.external.map((s)=>s.label)));t.push(...C("App adapters",e.apps));t.push(...C("Site adapters",e.sites));t.push("Run 'ppcli list' for full command details, or 'ppcli <site> --help' to inspect one site.");t.push("Agent tip: use 'ppcli <site> --help -f yaml' for all command args/options in one structured response.");t.push("");return t.join(`
+`)}function H(e){return{name:e.name,...e.type&&e.type!=="string"?{type:e.type}:{},...e.positional?{positional:!0}:{},...e.required?{required:!0}:{},...e.valueRequired?{valueRequired:!0}:{},...e.default!==void 0?{default:e.default}:{},...e.choices?.length?{choices:e.choices}:{},...e.help?{help:e.help}:{}}}function p(e){return{name:e.name,flags:e.flags,help:e.help,..."default"in e?{default:e.default}:{},..."choices"in e?{choices:e.choices}:{}}}function M(e){return{name:e.name(),...e.required?{required:!0}:{},...e.variadic?{variadic:!0}:{},...e.description?{help:e.description}:{},...e.defaultValue!==void 0?{default:e.defaultValue}:{},...e.argChoices?.length?{choices:[...e.argChoices]}:{}}}function F(e){if(e.hidden)return null;return{name:e.attributeName(),flags:e.flags,...e.description?{help:e.description}:{},...e.required?{takes_value:"required"}:{},...e.optional?{takes_value:"optional"}:{},...e.mandatory?{required:!0}:{},...e.defaultValue!==void 0?{default:e.defaultValue}:{},...e.argChoices?.length?{choices:[...e.argChoices]}:{},...e.negate?{negate:!0}:{}}}function r(e){return e.map(F).filter((n)=>n!==null)}export function leadingPositionalFromUsage(e){const n=e._usage;if(!n)return null;const t=n.match(/^\s*(<[^>]+>)/);return t?t[1]:null}function l(e){const n=[];let t=e;while(t){const s=t.name();if(s){n.push(s);const o=leadingPositionalFromUsage(t);if(o&&n.length>1)n.splice(n.length-1,0,o)}t=t.parent}return n.reverse()}function u(e,n){const t=l(e);return l(n).slice(t.length).filter((o)=>!/^<.+>$/.test(o))}function j(e){if(e.commands.length===0)return[e];return e.commands.flatMap((n)=>j(n))}function q(e){return e.commands.flatMap((n)=>[n,...q(n)])}function k(e){return e.map((n)=>{const t=`${n.name()}${n.variadic?"...":""}`;return n.required?`<${t}>`:`[${t}]`}).join(" ")}function L(e,n={}){const t=l(e).join(" "),s=k(e.registeredArguments),a=r(e.options).length>0||(n.namespaceRoot?r(n.namespaceRoot.options).length>0:!1)||(n.globalCommand?r(n.globalCommand.options).length>0:!1)?" [options]":"";return`${t}${s?` ${s}`:""}${a}`}function w(e,n,t={}){return{name:u(e,n).join(" "),command:l(n).join(" "),usage:L(n,{namespaceRoot:e,globalCommand:t.globalCommand}),description:n.description(),...n.aliases().length?{aliases:n.aliases()}:{},positionals:n.registeredArguments.map(M),command_options:r(n.options)}}export function commanderNamespaceHelpData(e,n={}){const t=j(e).filter((i)=>i!==e).sort((i,m)=>u(e,i).join(" ").localeCompare(u(e,m).join(" "))),s=l(e).join(" "),o=e._usage,a=o?`${s} ${o}`:`${s} <command> [args] [options]`;return{namespace:e.name(),command:s,usage:a,description:n.description??e.description(),command_count:t.length,commands:t.map((i)=>w(e,i,n)),namespace_options:r(e.options),...n.globalCommand?{global_options:r(n.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${s} --help -f yaml`}}}export function commanderCommandHelpData(e,n,t={}){return{namespace:e.name(),...w(e,n,t),namespace_options:r(e.options),...t.globalCommand?{global_options:r(t.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${l(n).join(" ")} --help -f yaml`}}}export function commanderGroupHelpData(e,n,t={}){const s=j(n).filter((o)=>o!==n).sort((o,a)=>u(e,o).join(" ").localeCompare(u(e,a).join(" ")));return{namespace:e.name(),group:u(e,n).join(" "),command:l(n).join(" "),usage:`${l(n).join(" ")} <command> [args] [options]`,description:n.description(),command_count:s.length,commands:s.map((o)=>w(e,o,t)),namespace_options:r(e.options),...t.globalCommand?{global_options:r(t.globalCommand.options)}:{},structured_help:{formats:["yaml","json"],usage:`${l(n).join(" ")} --help -f yaml`}}}export function installCommanderNamespaceStructuredHelp(e,n={}){installStructuredHelp(e,()=>commanderNamespaceHelpData(e,n));for(const t of q(e))if(t.commands.length>0)installStructuredHelp(t,()=>commanderGroupHelpData(e,t,n));else installStructuredHelp(t,()=>commanderCommandHelpData(e,t,n))}function h(e){return e.args.filter((n)=>n.positional)}function y(e){return e.args.filter((n)=>!n.positional)}function A(e){return e.map((n)=>n.required?`<${n.name}>`:`[${n.name}]`).join(" ")}function E(e){if(e.required||e.valueRequired)return`--${e.name} <value>`;return`--${e.name} [value]`}export function formatCommandListTerm(e){const n=A(h(e)),t=y(e).length>0?" [options]":"";return`${e.name}${n?` ${n}`:""}${t}`}function T(e){const n=A(h(e));return`ppcli ${e.site} ${e.name}${n?` ${n}`:""} [options]`}function S(e){return{name:e.name,command:`ppcli ${e.site} ${e.name}`,usage:T(e),access:e.access,description:e.description,browser:!!e.browser,...e.domain?{domain:e.domain}:{},...e.aliases?.length?{aliases:e.aliases}:{},positionals:h(e).map(H),command_options:y(e).map(H),...e.browser?{browser_common_options:f.map(p)}:{},example:O(e),...e.siteSession?{siteSession:e.siteSession}:{},...e.defaultFormat?{defaultFormat:e.defaultFormat}:{},...e.columns?.length?{columns:e.columns}:{}}}export function rootHelpData(e,n){const t=new Set([...n.external.map((a)=>a.name),...n.apps,...n.sites]),s=e.commands.filter((a)=>!t.has(a.name())).map((a)=>({name:a.name(),description:a.description()})),o=(a,i)=>a.localeCompare(i);return{name:e.name(),description:e.description(),commands:s,external_clis:{count:n.external.length,clis:n.external.map((a)=>a.name).sort(o),display:n.external.map((a)=>a.label).sort(o)},app_adapters:{count:n.apps.length,apps:[...n.apps].sort(o)},site_adapters:{count:n.sites.length,sites:[...n.sites].sort(o)},next:["ppcli <site> --help -f yaml","ppcli list -f yaml","ppcli <site> <command> -f yaml"]}}export function siteHelpData(e,n){const t=[...new Map(n.map((s)=>[v(s),s])).values()].sort((s,o)=>s.name.localeCompare(o.name));return{site:e,command_count:t.length,commands:t.map((s)=>S(s)),common_options:b.map(p),...t.some((s)=>s.browser)?{browser_common_options:f.map(p)}:{},next:[`ppcli ${e} <command> --help -f yaml`,`ppcli ${e} <command> -f yaml`]}}export function commandHelpData(e){return{site:e.site,...S(e),common_options:b.map(p),...e.browser?{browser_common_options:f.map(p)}:{},output_formats:["table","plain","yaml","json","md","csv"]}}function c(e){if(e.length===0)return[];const n=Math.min(Math.max(...e.map(([t])=>t.length)),34);return e.map(([t,s])=>`  ${t.padEnd(n+2)}${s}`)}function N(e){const n=[];if(e.help)n.push(e.help);if(e.default!==void 0)n.push(`default: ${e.default}`);if(e.choices?.length)n.push(`choices: ${e.choices.join(", ")}`);return n.join("  ")}export function formatCommonOptionsHelpText(){const e=b.map((n)=>{const t=[n.help];if("default"in n)t.push(`default: ${n.default}`);if("choices"in n)t.push(`choices: ${n.choices.join(", ")}`);return[n.flags,t.join("  ")]});return["Common options:",...c(e)].join(`
+`)}export function formatBrowserCommonOptionsHelpText(){const e=f.map((n)=>{const t=[n.help];if("choices"in n)t.push(`choices: ${n.choices.join(", ")}`);return[n.flags,t.join("  ")]});return["Browser common options:",...c(e)].join(`
+`)}export function formatSiteHelpText(e,n){const t=[...new Map(n.map((o)=>[v(o),o])).values()].sort((o,a)=>o.name.localeCompare(a.name));return[`Usage: ppcli ${e} <command> [args] [options]`,"",wrapCommaList(t.map((o)=>o.name),{indent:""}),"","Commands:",...c(t.map((o)=>[formatCommandListTerm(o),formatSiteCommandDescription(o)])),"",formatCommonOptionsHelpText(),...t.some((o)=>o.browser)?["",formatBrowserCommonOptionsHelpText()]:[],"",`Agent tip: use 'ppcli ${e} --help -f yaml' to get all command args/options in one structured response.`,""].join(`
+`)}export function formatCommandHelpText(e){const n=[`Usage: ${T(e)}`,"",e.description,""],t=h(e).map((a)=>[a.name,N(a)]);if(t.length)n.push("Arguments:",...c(t),"");const s=y(e).map((a)=>[E(a),N(a)]);if(s.length)n.push("Command options:",...c(s),"");n.push(formatCommonOptionsHelpText(),"");if(e.browser)n.push(formatBrowserCommonOptionsHelpText(),"");const o=[];o.push(`Access: ${e.access}`);o.push(`Browser: ${e.browser?"yes":"no"}`);if(e.domain)o.push(`Domain: ${e.domain}`);if(e.defaultFormat)o.push(`Default format: ${e.defaultFormat}`);if(e.aliases?.length)o.push(`Aliases: ${e.aliases.join(", ")}`);n.push(o.join(" | "));n.push(`Example: ${O(e)}`);if(e.columns?.length)n.push(`Output columns: ${e.columns.join(", ")}`);n.push("Agent tip: use '--help -f yaml' for structured args/options.");n.push("");return n.join(`
+`)}export function installStructuredHelp(e,n,t){const s=e.helpInformation.bind(e);e.helpInformation=(o)=>{const a=getRequestedHelpFormat();if(a)return renderStructuredHelp(n(),a);const i=typeof t==="function"?t():t??"";return s(o)+i}}export function formatSiteCommandDescription(e){return`${e.access==="write"?"[write]":"[read]"} ${e.description}`}

package/dist/src/hooks.js

@@ -1 +1 @@
-import{log as D}from"./logger.js";const w=globalThis.__opencli_hooks__??=new Map;function B(b,q){const p=w.get(b)??[];if(p.includes(q))return;p.push(q);w.set(b,p)}export function onStartup(b){B("onStartup",b)}export function onBeforeExecute(b){B("onBeforeExecute",b)}export function onAfterExecute(b){B("onAfterExecute",b)}export async function emitHook(b,q,p){const z=w.get(b);if(!z||z.length===0)return;for(const C of z)try{await C(q,p)}catch(A){D.warn(`Hook ${b} handler failed: ${A instanceof Error?A.message:String(A)}`)}}export function clearAllHooks(){w.clear()}
+import{log as s}from"./logger.js";const n=globalThis.__opencli_hooks__??=new Map;function i(o,e){const t=n.get(o)??[];if(t.includes(e))return;t.push(e);n.set(o,t)}export function onStartup(o){i("onStartup",o)}export function onBeforeExecute(o){i("onBeforeExecute",o)}export function onAfterExecute(o){i("onAfterExecute",o)}export async function emitHook(o,e,t){const r=n.get(o);if(!r||r.length===0)return;for(const f of r)try{await f(e,t)}catch(c){s.warn(`Hook ${o} handler failed: ${c instanceof Error?c.message:String(c)}`)}}export function clearAllHooks(){n.clear()}

package/dist/src/interceptor.js

@@ -1,9 +1,9 @@
-const J=`
+const c=`
       function __defHidden(obj, key, val) {
         try {
           Object.defineProperty(obj, key, { value: val, writable: true, enumerable: false, configurable: true });
         } catch { obj[key] = val; }
-      }`,C=`
+      }`,i=`
       function __disguise(fn, name) {
         const nativeStr = 'function ' + name + '() { [native code] }';
         // Override toString on the instance AND patch Function.prototype.toString
@@ -25,17 +25,17 @@ const J=`
         _patchedFns.set(fn, nativeStr);
         try { Object.defineProperty(fn, 'name', { value: name, configurable: true }); } catch {}
         return fn;
-      }`;export function generateInterceptorJs(q,B={}){const j=B.arrayName??"__opencli_intercepted",z=B.patchGuard??"__opencli_interceptor_patched",A=`${z}_pattern`;return`
+      }`;export function generateInterceptorJs(t,o={}){const e=o.arrayName??"__opencli_intercepted",r=o.patchGuard??"__opencli_interceptor_patched",n=`${r}_pattern`;return`
     () => {
-      ${J}
-      ${C}
+      ${c}
+      ${i}
 
-      if (!window.${j}) __defHidden(window, '${j}', []);
-      if (!window.${j}_errors) __defHidden(window, '${j}_errors', []);
-      __defHidden(window, '${A}', ${q});
-      const __checkMatch = (url) => window.${A} && url.includes(window.${A});
+      if (!window.${e}) __defHidden(window, '${e}', []);
+      if (!window.${e}_errors) __defHidden(window, '${e}_errors', []);
+      __defHidden(window, '${n}', ${t});
+      const __checkMatch = (url) => window.${n} && url.includes(window.${n});
 
-      if (!window.${z}) {
+      if (!window.${r}) {
         // ── Patch fetch ──
         const __origFetch = window.fetch;
         window.fetch = __disguise(async function(...args) {
@@ -46,8 +46,8 @@ const J=`
             try {
               const clone = response.clone();
               const json = await clone.json();
-              window.${j}.push(json);
-            } catch(e) { window.${j}_errors.push({ url: reqUrl, error: String(e) }); }
+              window.${e}.push(json);
+            } catch(e) { window.${e}_errors.push({ url: reqUrl, error: String(e) }); }
           }
           return response;
         }, 'fetch');
@@ -64,28 +64,28 @@ const J=`
           if (__checkMatch(this.__iurl)) {
             this.addEventListener('load', function() {
               try {
-                window.${j}.push(JSON.parse(this.responseText));
-              } catch(e) { window.${j}_errors.push({ url: this.__iurl, error: String(e) }); }
+                window.${e}.push(JSON.parse(this.responseText));
+              } catch(e) { window.${e}_errors.push({ url: this.__iurl, error: String(e) }); }
             });
           }
           return __origSend.apply(this, arguments);
         }, 'send');
 
-        __defHidden(window, '${z}', true);
+        __defHidden(window, '${r}', true);
       }
     }
-  `}export function generateReadInterceptedJs(q="__opencli_intercepted"){return`
+  `}export function generateReadInterceptedJs(t="__opencli_intercepted"){return`
     () => {
-      const data = window.${q} || [];
-      window.${q} = [];
+      const data = window.${t} || [];
+      window.${t} = [];
       return data;
     }
-  `}export function generateTapInterceptorJs(q){return{setupVar:`
+  `}export function generateTapInterceptorJs(t){return{setupVar:`
       let captured = null;
       let captureResolve;
       const capturePromise = new Promise(r => { captureResolve = r; });
-      const capturePattern = ${q};
-      ${C}
+      const capturePattern = ${t};
+      ${i}
     `,capturedVar:"captured",promiseVar:"capturePromise",resolveVar:"captureResolve",fetchPatch:`
       const origFetch = window.fetch;
       window.fetch = __disguise(async function(...fetchArgs) {

package/dist/src/launcher.js

@@ -1,7 +1,7 @@
-import{execFileSync as G,spawn as w}from"node:child_process";import{request as D}from"node:http";import*as K from"node:path";import{getElectronApp as U}from"./electron-apps.js";import{confirmPrompt as q}from"./tui.js";import{CommandExecutionError as $}from"./errors.js";import{log as H}from"./logger.js";const F=500,V=15000,I=2000,R=3000;export function probeCDP(z,Q=I){return new Promise((J)=>{const W=D({hostname:"127.0.0.1",port:z,path:"/json",method:"GET",timeout:Q},(Y)=>{Y.resume();J(Y.statusCode!==void 0&&Y.statusCode>=200&&Y.statusCode<300)});W.on("error",()=>J(!1));W.on("timeout",()=>{W.destroy();J(!1)});W.end()})}export function detectProcess(z){if(process.platform==="win32")return!1;try{G("pgrep",["-x",z],{encoding:"utf-8",stdio:"pipe"});return!0}catch{return!1}}export async function killProcess(z){if(process.platform==="win32")return;try{G("pkill",["-x",z],{stdio:"pipe"})}catch{}const Q=Date.now()+R;while(Date.now()<Q){if(!detectProcess(z))return;await new Promise((J)=>setTimeout(J,200))}try{G("pkill",["-9","-x",z],{stdio:"pipe"})}catch{}}export function discoverAppPath(z){if(process.platform!=="darwin")return null;try{return G("osascript",["-e",`POSIX path of (path to application "${z}")`],{encoding:"utf-8",stdio:"pipe",timeout:5000}).trim().replace(/\/$/,"")}catch{return null}}function O(z,Q){return`${z}/Contents/MacOS/${Q}`}function T(z,Q){return z instanceof $&&z.message.startsWith(`Could not launch ${Q}: executable not found at `)}export function resolveExecutableCandidates(z,Q){const J=Q.executableNames?.length?Q.executableNames:[Q.processName];return[...new Set(J)].map((W)=>O(z,W))}export async function launchDetachedApp(z,Q,J,W){await new Promise((Y,X)=>{const Z=w(z,Q,{detached:!0,stdio:"ignore",...W?{env:{...process.env,...W}}:{}}),k=(B)=>{if(B.code==="ENOENT"){X(new $(`Could not launch ${J}: executable not found at ${z}`,`Install ${J}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`));return}X(new $(`Failed to launch ${J}`,B.message))};Z.once("error",k);Z.once("spawn",()=>{Z.off("error",k);Z.unref();Y()})})}export async function launchElectronApp(z,Q,J,W){const Y=resolveExecutableCandidates(z,Q);let X;for(const Z of Y){H.debug(`[launcher] Launching: ${Z} ${J.join(" ")}`);try{await launchDetachedApp(Z,J,W);return}catch(k){if(T(k,W)){X=k;continue}throw k}}if(Y.length>1)throw new $(`Could not launch ${W}: no compatible executable found in ${K.join(z,"Contents","MacOS")}`,`Tried: ${Y.map((Z)=>K.basename(Z)).join(", ")}. Install ${W}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`);throw X??new $(`Could not launch ${W}`,`Install ${W}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`)}export function electronLaunchArgs(z,Q=[]){return[`--remote-debugging-port=${z}`,"--remote-allow-origins=*",...Q]}function j(z,Q){return`Start ${z} manually with --remote-debugging-port=${Q} --remote-allow-origins=*, then either:`}async function y(z){const Q=Date.now()+V;while(Date.now()<Q){if(await probeCDP(z,1000))return;await new Promise((J)=>setTimeout(J,F))}throw new $(`App launched but CDP not available on port ${z} after ${V/1000}s`,"The app may be slow to start. Try running the command again.")}export async function resolveElectronEndpoint(z){const Q=U(z);if(!Q)throw new $(`No Electron app registered for site "${z}"`,"Register the app in ~/.ppcli/apps.yaml or check the site name.");const{port:J,processName:W,displayName:Y}=Q,X=Y??W,Z=`http://127.0.0.1:${J}`;H.debug(`[launcher] Probing CDP on port ${J}...`);if(await probeCDP(J)){H.debug(`[launcher] CDP already available on port ${J}`);return Z}if(process.platform!=="darwin")throw new $(`${X} is not reachable on CDP port ${J}.`,`Auto-launch is not yet supported on ${process.platform}.
-${j(X,J)}
-`+`  • Set OPENCLI_CDP_ENDPOINT=http://127.0.0.1:${J}
-`+`  • Or just re-run the command once ${X} is listening on port ${J}.`);if(detectProcess(W)){H.debug(`[launcher] ${X} is running but CDP not available`);if(!await q(`${X} is running but CDP is not enabled. Restart with debug port?`,!0))throw new $(`${X} needs to be restarted with CDP enabled.`,`Manually restart: kill the app and relaunch with --remote-debugging-port=${J} --remote-allow-origins=*`);process.stderr.write(`  Restarting ${X}...
-`);await killProcess(W)}const B=discoverAppPath(X);if(!B)throw new $(`Could not find ${X} on this machine.`,`Install ${X} or register a custom path in ~/.ppcli/apps.yaml`);const f=electronLaunchArgs(J,Q.extraArgs??[]);await launchElectronApp(B,Q,f,X);process.stderr.write(`  Waiting for ${X} on port ${J}...
-`);await y(J);process.stderr.write(`  Connected to ${X} on port ${J}.
-`);return Z}
+import{execFileSync as u,spawn as f}from"node:child_process";import{request as w}from"node:http";import*as m from"node:path";import{getElectronApp as g}from"./electron-apps.js";import{confirmPrompt as b}from"./tui.js";import{CommandExecutionError as s}from"./errors.js";import{log as l}from"./logger.js";const x=500,d=15000,y=2000,C=3000;export function probeCDP(t,n=y){return new Promise((e)=>{const o=w({hostname:"127.0.0.1",port:t,path:"/json",method:"GET",timeout:n},(a)=>{a.resume();e(a.statusCode!==void 0&&a.statusCode>=200&&a.statusCode<300)});o.on("error",()=>e(!1));o.on("timeout",()=>{o.destroy();e(!1)});o.end()})}export function detectProcess(t){if(process.platform==="win32")return!1;try{u("pgrep",["-x",t],{encoding:"utf-8",stdio:"pipe"});return!0}catch{return!1}}export async function killProcess(t){if(process.platform==="win32")return;try{u("pkill",["-x",t],{stdio:"pipe"})}catch{}const n=Date.now()+C;while(Date.now()<n){if(!detectProcess(t))return;await new Promise((e)=>setTimeout(e,200))}try{u("pkill",["-9","-x",t],{stdio:"pipe"})}catch{}}export function discoverAppPath(t){if(process.platform!=="darwin")return null;try{return u("osascript",["-e",`POSIX path of (path to application "${t}")`],{encoding:"utf-8",stdio:"pipe",timeout:5000}).trim().replace(/\/$/,"")}catch{return null}}function E(t,n){return`${t}/Contents/MacOS/${n}`}function P(t,n){return t instanceof s&&t.message.startsWith(`Could not launch ${n}: executable not found at `)}export function resolveExecutableCandidates(t,n){const e=n.executableNames?.length?n.executableNames:[n.processName];return[...new Set(e)].map((o)=>E(t,o))}export async function launchDetachedApp(t,n,e,o){await new Promise((a,r)=>{const i=f(t,n,{detached:!0,stdio:"ignore",...o?{env:{...process.env,...o}}:{}}),c=(p)=>{if(p.code==="ENOENT"){r(new s(`Could not launch ${e}: executable not found at ${t}`,`Install ${e}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`));return}r(new s(`Failed to launch ${e}`,p.message))};i.once("error",c);i.once("spawn",()=>{i.off("error",c);i.unref();a()})})}export async function launchElectronApp(t,n,e,o){const a=resolveExecutableCandidates(t,n);let r;for(const i of a){l.debug(`[launcher] Launching: ${i} ${e.join(" ")}`);try{await launchDetachedApp(i,e,o);return}catch(c){if(P(c,o)){r=c;continue}throw c}}if(a.length>1)throw new s(`Could not launch ${o}: no compatible executable found in ${m.join(t,"Contents","MacOS")}`,`Tried: ${a.map((i)=>m.basename(i)).join(", ")}. Install ${o}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`);throw r??new s(`Could not launch ${o}`,`Install ${o}, reinstall it, or register a custom app path in ~/.ppcli/apps.yaml`)}export function electronLaunchArgs(t,n=[]){return[`--remote-debugging-port=${t}`,"--remote-allow-origins=*",...n]}function D(t,n){return`Start ${t} manually with --remote-debugging-port=${n} --remote-allow-origins=*, then either:`}async function _(t){const n=Date.now()+d;while(Date.now()<n){if(await probeCDP(t,1000))return;await new Promise((e)=>setTimeout(e,x))}throw new s(`App launched but CDP not available on port ${t} after ${d/1000}s`,"The app may be slow to start. Try running the command again.")}export async function resolveElectronEndpoint(t){const n=g(t);if(!n)throw new s(`No Electron app registered for site "${t}"`,"Register the app in ~/.ppcli/apps.yaml or check the site name.");const{port:e,processName:o,displayName:a}=n,r=a??o,i=`http://127.0.0.1:${e}`;l.debug(`[launcher] Probing CDP on port ${e}...`);if(await probeCDP(e)){l.debug(`[launcher] CDP already available on port ${e}`);return i}if(process.platform!=="darwin")throw new s(`${r} is not reachable on CDP port ${e}.`,`Auto-launch is not yet supported on ${process.platform}.
+${D(r,e)}
+`+`  • Set OPENCLI_CDP_ENDPOINT=http://127.0.0.1:${e}
+`+`  • Or just re-run the command once ${r} is listening on port ${e}.`);if(detectProcess(o)){l.debug(`[launcher] ${r} is running but CDP not available`);if(!await b(`${r} is running but CDP is not enabled. Restart with debug port?`,!0))throw new s(`${r} needs to be restarted with CDP enabled.`,`Manually restart: kill the app and relaunch with --remote-debugging-port=${e} --remote-allow-origins=*`);process.stderr.write(`  Restarting ${r}...
+`);await killProcess(o)}const p=discoverAppPath(r);if(!p)throw new s(`Could not find ${r} on this machine.`,`Install ${r} or register a custom path in ~/.ppcli/apps.yaml`);const h=electronLaunchArgs(e,n.extraArgs??[]);await launchElectronApp(p,n,h,r);process.stderr.write(`  Waiting for ${r} on port ${e}...
+`);await _(e);process.stderr.write(`  Connected to ${r} on port ${e}.
+`);return i}

package/dist/src/logger.js

@@ -1,9 +1,9 @@
-function x(){return!!process.env.OPENCLI_VERBOSE}export const log={info(h){process.stderr.write(`ℹ  ${h}
-`)},status(h){process.stderr.write(`${h}
-`)},success(h){process.stderr.write(`${h}
-`)},warn(h){process.stderr.write(`⚠  ${h}
-`)},error(h){process.stderr.write(`✖  ${h}
-`)},verbose(h){if(x())process.stderr.write(`[verbose] ${h}
-`)},debug(h){this.verbose(h)},step(h,j,k,q=""){process.stderr.write(`  [${h}/${j}] ${k}${q}
-`)},stepResult(h){process.stderr.write(`       → ${h}
+function o(){return!!process.env.OPENCLI_VERBOSE}export const log={info(r){process.stderr.write(`ℹ  ${r}
+`)},status(r){process.stderr.write(`${r}
+`)},success(r){process.stderr.write(`${r}
+`)},warn(r){process.stderr.write(`⚠  ${r}
+`)},error(r){process.stderr.write(`✖  ${r}
+`)},verbose(r){if(o())process.stderr.write(`[verbose] ${r}
+`)},debug(r){this.verbose(r)},step(r,e,s,t=""){process.stderr.write(`  [${r}/${e}] ${s}${t}
+`)},stepResult(r){process.stderr.write(`       → ${r}
 `)}};