publishport-opencli 1.0.37 → 1.0.39
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cli-manifest.json +77 -0
- package/clis/_shared/watch.js +42 -4
- package/clis/xianyu/watch.js +1 -1
- package/dist/src/browser/captcha-drag.d.ts +92 -0
- package/dist/src/browser/captcha-drag.js +195 -0
- package/dist/src/cli.js +32 -24
- package/package.json +1 -1
- package/skills/opencli-browser/SKILL.md +22 -1
package/dist/src/cli.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import*as A from"node:fs";import*as fe from"node:os";import*as k from"node:path";import{fileURLToPath as io}from"node:url";import{Command as Oe,InvalidArgumentError as bt,Option as ao}from"commander";import co from"js-yaml";import{findPackageRoot,getBuiltEntryCandidates as lo}from"./package-paths.js";import{fullName as Fe,getRegistry as Re,strategyLabel as xt}from"./registry.js";import{serializeCommand as uo,formatArgSummary as mo}from"./serialization.js";import{render as Ee}from"./output.js";import{PKG_VERSION as $e}from"./version.js";import{printCompletionScript as po}from"./completion.js";import{loadExternalClis as Be,executeExternalCli as fo,installExternalCli as go,registerExternalCli as ho,isBinaryInstalled as Le,formatExternalCliLabel as St}from"./external.js";import{listOpenCliSkills as wo,readOpenCliSkill as yo}from"./skills.js";import{registerAllCommands as bo}from"./commanderAdapter.js";import{classifyAdapter as vt,formatRootAdapterHelpText as xo,installCommanderNamespaceStructuredHelp as ge,installStructuredHelp as So,leadingPositionalFromUsage as vo,rootHelpData as Ro}from"./help.js";import{EXIT_CODES as f,getErrorMessage as G,BrowserConnectError as Eo,CliError as ze,CommandExecutionError as ee,toEnvelope as Co}from"./errors.js";import{TargetError as Rt}from"./browser/target-errors.js";import{resolveTargetJs as _o,getTextResolvedJs as Oo,getValueResolvedJs as $o,getAttributesResolvedJs as No,selectResolvedJs as ko,isAutocompleteResolvedJs as Ao}from"./browser/target-resolver.js";import{wrapTopLevelAwait as To}from"./browser/utils.js";import{buildFindJs as Po,buildSemanticFindJs as Et,isFindError as Ct}from"./browser/find.js";import{inferShape as _t}from"./browser/shape.js";import{assignKeys as Ot}from"./browser/network-key.js";import{DEFAULT_TTL_MS as $t,findEntry as Io,loadNetworkCache as Jo,saveNetworkCache as jo}from"./browser/network-cache.js";import{NETWORK_INTERCEPTOR_JS as Ne}from"./browser/network-interceptor.js";import{parseFilter as Mo,shapeMatchesFilter as Uo}from"./browser/shape-filter.js";import{buildHtmlTreeJs as Do}from"./browser/html-tree.js";import{buildExtractHtmlJs as Go,runExtractFromHtml as Fo}from"./browser/extract.js";import{analyzeSite as Bo}from"./browser/analyze.js";import{registerAuthCommands as Lo}from"./commands/auth.js";import{daemonRestart as zo,daemonStatus as Wo,daemonStop as Ho,daemonWarm as Vo}from"./commands/daemon.js";import{log as Y}from"./logger.js";import{bindTab as qo,BrowserCommandError as Nt,sendCommand as Ko}from"./browser/daemon-client.js";import{fetchDaemonStatus as Xo}from"./browser/daemon-transport.js";import{aliasForContextId as kt,listManagedProfiles as We,loadProfileConfig as Zo,renameProfile as Yo,resolveProfile as At,resolveProfileContextId as Qo,setDefaultProfile as er}from"./browser/profile.js";import{createManagedProfile as tr,ensureManagedChrome as He,isManagedChromeRunning as or,removeManagedProfile as rr,stopManagedChrome as nr,resolveManagedOpts as Tt,updateManagedProfileConfig as sr}from"./browser/managed-chrome.js";import{testProxy as ir,parseProxyUrl as Ve}from"./browser/proxy-test.js";import{formatDaemonVersion as ar,isDaemonStale as cr}from"./browser/daemon-version.js";import{DEFAULT_BROWSER_CONNECT_TIMEOUT as qe}from"./browser/config.js";const Ke=io(import.meta.url),lr='Target tab/page identity returned by "browser open", "browser tab new", or "browser tab list"',Pt=1000;function ke(a,c){if(a===void 0||a===null||a==="")return null;const i=String(a).trim(),m=/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/.exec(i);if(!m)return{error:`--${c} must be a duration like 500ms, 30s, 2m, got "${i}"`};const v=Number.parseFloat(m[1]),g=m[2]??"ms";return Math.round(v*(g==="h"?3600000:g==="m"?60000:g==="s"?1000:1))}function Xe(a){return typeof a==="number"&&Number.isFinite(a)&&a>0?a:Date.now()}function he(a){if(typeof a!=="number"||!Number.isFinite(a)||a<=0)return;return new Date(a).toISOString()}function Ze(a,c,i=Date.now()){const m=c.sinceMs!=null?i-c.sinceMs:void 0,v=c.untilMs!=null?i-c.untilMs:void 0;return a.filter((g)=>{const T=g.timestamp??i;if(m!==void 0&&T<m)return!1;if(v!==void 0&&T>v)return!1;return!0})}export function selectFreshByTimestamp(a,c){const i=a.filter((v)=>Number(v.timestamp??0)>c),m=i.length>0?Math.max(c,...i.map((v)=>Number(v.timestamp??0)).filter(Number.isFinite)):c;return{fresh:i,lastSeenTs:m}}async function we(a){if(a.readNetworkCapture){const i=await a.readNetworkCapture();if(Array.isArray(i)&&i.length>0)return i.map((m)=>{const v=m.responsePreview??null;let g=null;if(v)try{g=JSON.parse(v)}catch{g=v}const T=typeof m.responseBodyFullSize==="number"?m.responseBodyFullSize:v?v.length:0,R=m.responseBodyTruncated===!0;return{url:m.url||"",method:m.method||"GET",status:m.responseStatus||0,size:T,ct:m.responseContentType||"",body:g,bodyFullSize:T,bodyTruncated:R,timestamp:Xe(m.timestamp),...m.channel?{channel:m.channel}:{},...m.direction?{direction:m.direction}:{},...m.eventName?{eventName:String(m.eventName)}:{},...m.eventId?{eventId:String(m.eventId)}:{}}})}const c=await a.evaluate("(function(){ var out = window.__opencli_net || []; window.__opencli_net = []; return JSON.stringify(out); })()");try{return JSON.parse(c).map((m)=>({...m,timestamp:Xe(m.timestamp)}))}catch{if(process.env.OPENCLI_VERBOSE)Y.warn(`[network] Failed to parse interceptor buffer: ${typeof c==="string"?c.slice(0,200):String(c)}`);return[]}}const It=4000;function dr(a){if(typeof a!=="string")return a??null;return a.length>It?`${a.slice(0,It)}…[truncated ${a.length} chars]`:a}function Jt(a){return a.filter((c)=>{if(c.channel==="websocket"||c.channel==="eventsource")return!0;const i=c.ct?.toLowerCase()??"";return(i.includes("json")||i.includes("xml")||i.includes("text/plain")||i.includes("javascript"))&&!/\.(js|css|png|jpg|gif|svg|woff|ico|map)(\?|$)/i.test(c.url)&&!/analytics|tracking|telemetry|beacon|pixel|gtag|fbevents/i.test(c.url)})}const ur={invalid_args:f.USAGE_ERROR,invalid_filter:f.USAGE_ERROR,invalid_max_body:f.USAGE_ERROR};function X(a,c,i={}){console.log(JSON.stringify({error:{code:a,message:c,...i}},null,2));process.exitCode=ur[a]??f.GENERIC_ERROR}const mr="Site sitemap available. For navigation context, use the opencli-browser-sitemap skill; treat browser state as truth if it disagrees.";function pr(a,c=Re()){let i;try{i=new URL(a).hostname.toLowerCase().replace(/^www\./,"")}catch{return[]}const m=new Map;for(const R of c.values()){if(!R.domain)continue;let N=R.domain.toLowerCase().trim();try{N=new URL(N.includes("://")?N:`https://${N}`).hostname.toLowerCase()}catch{N=N.split("/")[0]??N}N=N.replace(/^www\./,"");if(!N)continue;if(i===N||i.endsWith(`.${N}`))m.set(R.site,Math.max(m.get(R.site)??0,N.length))}const v=[...m.entries()].sort((R,N)=>N[1]-R[1]||R[0].localeCompare(N[0])).map(([R])=>R),g=i.split(".").filter(Boolean),T=g.length>=2?g[g.length-2]:g[0];return[...new Set([...v,...T?[T]:[]])]}function jt(a,c){return a.find((i)=>c(i))}function fr(a,c){const i=a.replace(/[^a-zA-Z0-9_-]+/g,"-");if(!i)return{};const m=k.join(c.homeDir,".ppcli","sites",i);return{local:jt([k.join(m,"sitemap"),k.join(m,"sitemap.md")],c.fileExists),global:jt([k.join(c.packageRoot,"sitemaps",i),k.join(c.packageRoot,"sitemaps",`${i}.md`)],c.fileExists)}}export function resolveSitemapAvailabilityForUrl(a,c={}){const i=c.homeDir??fe.homedir(),m=c.packageRoot??findPackageRoot(Ke),v=c.registry??Re(),g=c.fileExists??A.existsSync;for(const T of pr(a,v)){const R=fr(T,{homeDir:i,packageRoot:m,fileExists:g});if(!R.local&&!R.global)continue;const N=R.local&&R.global?"local+global":R.local?"local":"global";return{site:T,available:!0,source:N,hint:mr,paths:R}}return null}function Mt(a){const c=a.replace(/[^a-zA-Z0-9_-]+/g,"_");return k.join(Dt(),"browser-sitemap-hints",`${c}.json`)}function Ut(a){try{const c=JSON.parse(A.readFileSync(Mt(a),"utf-8"));if(c&&typeof c==="object"&&Array.isArray(c.seenSites))return{seenSites:c.seenSites.filter((i)=>typeof i==="string"),updatedAt:typeof c.updatedAt==="string"?c.updatedAt:new Date(0).toISOString()}}catch{}return{seenSites:[],updatedAt:new Date(0).toISOString()}}function gr(a,c){const i=Ut(a);if(!i.seenSites.includes(c))i.seenSites.push(c);const m=Mt(a);A.mkdirSync(k.dirname(m),{recursive:!0});A.writeFileSync(m,JSON.stringify({seenSites:i.seenSites,updatedAt:new Date().toISOString()}),"utf-8")}function hr(a,c,i){const m=resolveSitemapAvailabilityForUrl(a);if(!m)return null;if(!i.oncePerSession)return m;if(Ut(c).seenSites.includes(m.site))return null;gr(c,m.site);return m}export function checkSiteMemory(a){const c=k.join(fe.homedir(),".ppcli","sites",a),i=k.join(c,"endpoints.json"),m=k.join(c,"notes.md");let v=0,g=A.existsSync(i);if(g)try{const R=JSON.parse(A.readFileSync(i,"utf-8"));if(R&&typeof R==="object"&&!Array.isArray(R))v=Object.keys(R).length;else if(Array.isArray(R))v=R.length}catch{g=!1}const T=A.existsSync(m);return{ok:g&&v>0&&T,siteDir:c,endpoints:{present:g,count:v,path:i},notes:{present:T,path:m}}}export function printSiteMemoryReport(a,c){if(a.ok){console.log(` ✓ Memory: endpoints.json (${a.endpoints.count}), notes.md present at ${a.siteDir}`);return}const i=c?"✗":"⚠",m=[];if(!a.endpoints.present)m.push("endpoints.json");else if(a.endpoints.count===0)m.push("endpoints.json (empty)");if(!a.notes.present)m.push("notes.md");console.log(` ${i} Memory: missing ${m.join(", ")} under ${a.siteDir}`);console.log(" Write the endpoint you just verified + a 1-line session note so the next agent starts from minute 0, not minute 95.");if(!c)console.log(" (Re-run with --strict-memory to fail instead of warn.)")}export function normalizeVerifyRows(a){if(Array.isArray(a))return a.map((c)=>c&&typeof c==="object"?c:{value:c});if(a&&typeof a==="object"){const c=a;for(const i of["rows","items","data","results"])if(Array.isArray(c[i]))return c[i].map((m)=>m&&typeof m==="object"?m:{value:m});return[c]}return[]}export function renderVerifyPreview(a,c={}){const i=c.maxRows??10,m=c.maxCols??6,v=c.cellMax??40;if(a.length===0)return" (no rows)";const g=Array.from(new Set(a.flatMap((I)=>Object.keys(I)))),T=g.slice(0,m),R=a.slice(0,i),N=(I)=>{if(I===null||I===void 0)return"";return(typeof I==="object"?JSON.stringify(I):String(I)).replace(/\s+/g," ").slice(0,v)},te=T.map((I)=>Math.max(I.length,...R.map((K)=>N(K[I]).length))),Z=(I)=>I.map((K,x)=>K.padEnd(te[x])).join(" "),q=[];q.push(` ${Z(T)}`);q.push(` ${te.map((I)=>"-".repeat(I)).join(" ")}`);for(const I of R)q.push(` ${Z(T.map((K)=>N(I[K])))}`);if(a.length>i)q.push(` ... and ${a.length-i} more row(s)`);if(g.length>m)q.push(` (${g.length-m} more column(s) hidden)`);return q.join(`
|
|
2
|
-
`)}function
|
|
1
|
+
import*as A from"node:fs";import*as ge from"node:os";import*as k from"node:path";import{fileURLToPath as po}from"node:url";import{Command as Ne,InvalidArgumentError as Ct,Option as fo}from"commander";import go from"js-yaml";import{findPackageRoot,getBuiltEntryCandidates as ho}from"./package-paths.js";import{fullName as He,getRegistry as Ee,strategyLabel as Et}from"./registry.js";import{serializeCommand as wo,formatArgSummary as yo}from"./serialization.js";import{render as _e}from"./output.js";import{PKG_VERSION as ke}from"./version.js";import{printCompletionScript as bo}from"./completion.js";import{loadExternalClis as qe,executeExternalCli as xo,installExternalCli as So,registerExternalCli as vo,isBinaryInstalled as Ve,formatExternalCliLabel as _t}from"./external.js";import{listOpenCliSkills as Ro,readOpenCliSkill as Co}from"./skills.js";import{registerAllCommands as Eo}from"./commanderAdapter.js";import{classifyAdapter as Ot,formatRootAdapterHelpText as _o,installCommanderNamespaceStructuredHelp as he,installStructuredHelp as Oo,leadingPositionalFromUsage as $o,rootHelpData as No}from"./help.js";import{EXIT_CODES as f,getErrorMessage as U,BrowserConnectError as ko,CliError as Xe,CommandExecutionError as F,toEnvelope as Ao}from"./errors.js";import{TargetError as $t}from"./browser/target-errors.js";import{resolveTargetJs as To,getTextResolvedJs as Po,getValueResolvedJs as Io,getAttributesResolvedJs as Jo,selectResolvedJs as jo,isAutocompleteResolvedJs as Mo}from"./browser/target-resolver.js";import{wrapTopLevelAwait as Do}from"./browser/utils.js";import{buildFindJs as Uo,buildSemanticFindJs as Nt,isFindError as kt}from"./browser/find.js";import{inferShape as At}from"./browser/shape.js";import{assignKeys as Tt}from"./browser/network-key.js";import{DEFAULT_TTL_MS as Pt,findEntry as Go,loadNetworkCache as Fo,saveNetworkCache as Bo}from"./browser/network-cache.js";import{NETWORK_INTERCEPTOR_JS as Ae}from"./browser/network-interceptor.js";import{parseFilter as Lo,shapeMatchesFilter as zo}from"./browser/shape-filter.js";import{buildHtmlTreeJs as Wo}from"./browser/html-tree.js";import{buildExtractHtmlJs as Ho,runExtractFromHtml as qo}from"./browser/extract.js";import{analyzeSite as Vo}from"./browser/analyze.js";import{registerAuthCommands as Xo}from"./commands/auth.js";import{daemonRestart as Ko,daemonStatus as Zo,daemonStop as Yo,daemonWarm as Qo}from"./commands/daemon.js";import{log as Q}from"./logger.js";import{bindTab as er,BrowserCommandError as It,sendCommand as tr}from"./browser/daemon-client.js";import{fetchDaemonStatus as or}from"./browser/daemon-transport.js";import{aliasForContextId as Jt,listManagedProfiles as Ke,loadProfileConfig as rr,renameProfile as nr,resolveProfile as jt,resolveProfileContextId as ir,setDefaultProfile as sr}from"./browser/profile.js";import{createManagedProfile as ar,ensureManagedChrome as Ze,isManagedChromeRunning as cr,removeManagedProfile as lr,stopManagedChrome as dr,resolveManagedOpts as Mt,updateManagedProfileConfig as ur}from"./browser/managed-chrome.js";import{testProxy as mr,parseProxyUrl as Ye}from"./browser/proxy-test.js";import{formatDaemonVersion as pr,isDaemonStale as fr}from"./browser/daemon-version.js";import{DEFAULT_BROWSER_CONNECT_TIMEOUT as Qe}from"./browser/config.js";const et=po(import.meta.url),gr='Target tab/page identity returned by "browser open", "browser tab new", or "browser tab list"',Dt=1000;function Te(c,l){if(c===void 0||c===null||c==="")return null;const a=String(c).trim(),p=/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/.exec(a);if(!p)return{error:`--${l} must be a duration like 500ms, 30s, 2m, got "${a}"`};const v=Number.parseFloat(p[1]),h=p[2]??"ms";return Math.round(v*(h==="h"?3600000:h==="m"?60000:h==="s"?1000:1))}function tt(c){return typeof c==="number"&&Number.isFinite(c)&&c>0?c:Date.now()}function we(c){if(typeof c!=="number"||!Number.isFinite(c)||c<=0)return;return new Date(c).toISOString()}function ot(c,l,a=Date.now()){const p=l.sinceMs!=null?a-l.sinceMs:void 0,v=l.untilMs!=null?a-l.untilMs:void 0;return c.filter((h)=>{const T=h.timestamp??a;if(p!==void 0&&T<p)return!1;if(v!==void 0&&T>v)return!1;return!0})}export function selectFreshByTimestamp(c,l){const a=c.filter((v)=>Number(v.timestamp??0)>l),p=a.length>0?Math.max(l,...a.map((v)=>Number(v.timestamp??0)).filter(Number.isFinite)):l;return{fresh:a,lastSeenTs:p}}async function ye(c){if(c.readNetworkCapture){const a=await c.readNetworkCapture();if(Array.isArray(a)&&a.length>0)return a.map((p)=>{const v=p.responsePreview??null;let h=null;if(v)try{h=JSON.parse(v)}catch{h=v}const T=typeof p.responseBodyFullSize==="number"?p.responseBodyFullSize:v?v.length:0,E=p.responseBodyTruncated===!0;return{url:p.url||"",method:p.method||"GET",status:p.responseStatus||0,size:T,ct:p.responseContentType||"",body:h,bodyFullSize:T,bodyTruncated:E,timestamp:tt(p.timestamp),...p.channel?{channel:p.channel}:{},...p.direction?{direction:p.direction}:{},...p.eventName?{eventName:String(p.eventName)}:{},...p.eventId?{eventId:String(p.eventId)}:{}}})}const l=await c.evaluate("(function(){ var out = window.__opencli_net || []; window.__opencli_net = []; return JSON.stringify(out); })()");try{return JSON.parse(l).map((p)=>({...p,timestamp:tt(p.timestamp)}))}catch{if(process.env.OPENCLI_VERBOSE)Q.warn(`[network] Failed to parse interceptor buffer: ${typeof l==="string"?l.slice(0,200):String(l)}`);return[]}}const Ut=4000;function hr(c){if(typeof c!=="string")return c??null;return c.length>Ut?`${c.slice(0,Ut)}…[truncated ${c.length} chars]`:c}function Gt(c){return c.filter((l)=>{if(l.channel==="websocket"||l.channel==="eventsource")return!0;const a=l.ct?.toLowerCase()??"";return(a.includes("json")||a.includes("xml")||a.includes("text/plain")||a.includes("javascript"))&&!/\.(js|css|png|jpg|gif|svg|woff|ico|map)(\?|$)/i.test(l.url)&&!/analytics|tracking|telemetry|beacon|pixel|gtag|fbevents/i.test(l.url)})}const wr={invalid_args:f.USAGE_ERROR,invalid_filter:f.USAGE_ERROR,invalid_max_body:f.USAGE_ERROR};function Z(c,l,a={}){console.log(JSON.stringify({error:{code:c,message:l,...a}},null,2));process.exitCode=wr[c]??f.GENERIC_ERROR}const yr="Site sitemap available. For navigation context, use the opencli-browser-sitemap skill; treat browser state as truth if it disagrees.";function br(c,l=Ee()){let a;try{a=new URL(c).hostname.toLowerCase().replace(/^www\./,"")}catch{return[]}const p=new Map;for(const E of l.values()){if(!E.domain)continue;let N=E.domain.toLowerCase().trim();try{N=new URL(N.includes("://")?N:`https://${N}`).hostname.toLowerCase()}catch{N=N.split("/")[0]??N}N=N.replace(/^www\./,"");if(!N)continue;if(a===N||a.endsWith(`.${N}`))p.set(E.site,Math.max(p.get(E.site)??0,N.length))}const v=[...p.entries()].sort((E,N)=>N[1]-E[1]||E[0].localeCompare(N[0])).map(([E])=>E),h=a.split(".").filter(Boolean),T=h.length>=2?h[h.length-2]:h[0];return[...new Set([...v,...T?[T]:[]])]}function Ft(c,l){return c.find((a)=>l(a))}function xr(c,l){const a=c.replace(/[^a-zA-Z0-9_-]+/g,"-");if(!a)return{};const p=k.join(l.homeDir,".ppcli","sites",a);return{local:Ft([k.join(p,"sitemap"),k.join(p,"sitemap.md")],l.fileExists),global:Ft([k.join(l.packageRoot,"sitemaps",a),k.join(l.packageRoot,"sitemaps",`${a}.md`)],l.fileExists)}}export function resolveSitemapAvailabilityForUrl(c,l={}){const a=l.homeDir??ge.homedir(),p=l.packageRoot??findPackageRoot(et),v=l.registry??Ee(),h=l.fileExists??A.existsSync;for(const T of br(c,v)){const E=xr(T,{homeDir:a,packageRoot:p,fileExists:h});if(!E.local&&!E.global)continue;const N=E.local&&E.global?"local+global":E.local?"local":"global";return{site:T,available:!0,source:N,hint:yr,paths:E}}return null}function Bt(c){const l=c.replace(/[^a-zA-Z0-9_-]+/g,"_");return k.join(zt(),"browser-sitemap-hints",`${l}.json`)}function Lt(c){try{const l=JSON.parse(A.readFileSync(Bt(c),"utf-8"));if(l&&typeof l==="object"&&Array.isArray(l.seenSites))return{seenSites:l.seenSites.filter((a)=>typeof a==="string"),updatedAt:typeof l.updatedAt==="string"?l.updatedAt:new Date(0).toISOString()}}catch{}return{seenSites:[],updatedAt:new Date(0).toISOString()}}function Sr(c,l){const a=Lt(c);if(!a.seenSites.includes(l))a.seenSites.push(l);const p=Bt(c);A.mkdirSync(k.dirname(p),{recursive:!0});A.writeFileSync(p,JSON.stringify({seenSites:a.seenSites,updatedAt:new Date().toISOString()}),"utf-8")}function vr(c,l,a){const p=resolveSitemapAvailabilityForUrl(c);if(!p)return null;if(!a.oncePerSession)return p;if(Lt(l).seenSites.includes(p.site))return null;Sr(l,p.site);return p}export function checkSiteMemory(c){const l=k.join(ge.homedir(),".ppcli","sites",c),a=k.join(l,"endpoints.json"),p=k.join(l,"notes.md");let v=0,h=A.existsSync(a);if(h)try{const E=JSON.parse(A.readFileSync(a,"utf-8"));if(E&&typeof E==="object"&&!Array.isArray(E))v=Object.keys(E).length;else if(Array.isArray(E))v=E.length}catch{h=!1}const T=A.existsSync(p);return{ok:h&&v>0&&T,siteDir:l,endpoints:{present:h,count:v,path:a},notes:{present:T,path:p}}}export function printSiteMemoryReport(c,l){if(c.ok){console.log(` ✓ Memory: endpoints.json (${c.endpoints.count}), notes.md present at ${c.siteDir}`);return}const a=l?"✗":"⚠",p=[];if(!c.endpoints.present)p.push("endpoints.json");else if(c.endpoints.count===0)p.push("endpoints.json (empty)");if(!c.notes.present)p.push("notes.md");console.log(` ${a} Memory: missing ${p.join(", ")} under ${c.siteDir}`);console.log(" Write the endpoint you just verified + a 1-line session note so the next agent starts from minute 0, not minute 95.");if(!l)console.log(" (Re-run with --strict-memory to fail instead of warn.)")}export function normalizeVerifyRows(c){if(Array.isArray(c))return c.map((l)=>l&&typeof l==="object"?l:{value:l});if(c&&typeof c==="object"){const l=c;for(const a of["rows","items","data","results"])if(Array.isArray(l[a]))return l[a].map((p)=>p&&typeof p==="object"?p:{value:p});return[l]}return[]}export function renderVerifyPreview(c,l={}){const a=l.maxRows??10,p=l.maxCols??6,v=l.cellMax??40;if(c.length===0)return" (no rows)";const h=Array.from(new Set(c.flatMap((I)=>Object.keys(I)))),T=h.slice(0,p),E=c.slice(0,a),N=(I)=>{if(I===null||I===void 0)return"";return(typeof I==="object"?JSON.stringify(I):String(I)).replace(/\s+/g," ").slice(0,v)},te=T.map((I)=>Math.max(I.length,...E.map((K)=>N(K[I]).length))),Y=(I)=>I.map((K,x)=>K.padEnd(te[x])).join(" "),X=[];X.push(` ${Y(T)}`);X.push(` ${te.map((I)=>"-".repeat(I)).join(" ")}`);for(const I of E)X.push(` ${Y(T.map((K)=>N(I[K])))}`);if(c.length>a)X.push(` ... and ${c.length-a} more row(s)`);if(h.length>p)X.push(` (${h.length-p} more column(s) hidden)`);return X.join(`
|
|
2
|
+
`)}function zt(){return process.env.OPENCLI_CACHE_DIR||k.join(ge.homedir(),".ppcli","cache")}function Wt(c){const l=c.replace(/[^a-zA-Z0-9_-]+/g,"_");return k.join(zt(),"browser-state",`${l}.json`)}function Ht(c){try{const l=A.readFileSync(Wt(c),"utf-8"),a=JSON.parse(l);return a&&typeof a==="object"?a:null}catch{return null}}function be(c,l){const a=Wt(l);if(!c){A.rmSync(a,{force:!0});return}A.mkdirSync(k.dirname(a),{recursive:!0});A.writeFileSync(a,JSON.stringify({defaultPage:c,updatedAt:new Date().toISOString()}),"utf-8")}function Rr(c,l){return c.some((a)=>{return typeof a==="object"&&a!==null&&"page"in a&&typeof a.page==="string"&&a.page===l})}async function rt(c,l,a){const p=l.trim();if(!p)return;let v;try{v=await c.tabs()}catch(h){if(a.source==="saved"){be(void 0,a.scope);return}throw Error(`Target tab ${p} could not be validated in the current browser session. The Browser Bridge session may have restarted; re-run "ppcli browser tab list" and choose a current target.`,{cause:h})}if(Array.isArray(v)&&Rr(v,p))return p;if(a.source==="saved"){be(void 0,a.scope);return}throw Error(`Target tab ${p} is not part of the current browser session. The Browser Bridge session may have restarted; re-run "ppcli browser tab list" and choose a current target.`)}function Pe(c,l){return l?`${l}:${c}`:c}async function Cr(c,l){const a=Ht(l)?.defaultPage?.trim();if(!a)return;return rt(c,a,{scope:l,source:"saved"})}async function Er(c,l,a,p={}){if(p.adapter&&!/^site:[a-z0-9][a-z0-9_-]*$/.test(c))throw new F("--adapter requires the existing adapter session name: site:<site>, e.g. site:douyin");const v=p.adapter?"adapter":"browser",h=jt(p.profile);if(h.kind==="managed"){if(l)throw Error(`托管环境「${h.name}」是单窗口复用标签模型，不支持 --tab 定位。直接省略 --tab 即可。`);const K=p.windowMode??nt(void 0,"background"),{ensureManagedChrome:x}=await import("./browser/managed-chrome.js"),{CDPBridge:Oe}=await import("./browser/cdp.js"),{generateFingerprintJs:le}=await import("./browser/fingerprint.js"),xe=await x(h.name,h.entry,{windowMode:K}),oe=h.entry.fingerprint,ie=h.entry.proxy,Se=new Oe;return{page:await Se.connect({timeout:Qe,session:c,surface:v,...p.adapter?{siteSession:"persistent"}:{},cdpEndpoint:xe,contextId:h.name,windowMode:K,...oe?.enabled?{initScript:le(oe)}:{},...ie?.username?{proxyAuth:{username:ie.username,password:ie.password??""}}:{}}),close:()=>Se.close()}}const{BrowserBridge:T}=await import("./browser/index.js"),E=new T,N=process.env.OPENCLI_BROWSER_IDLE_TIMEOUT,te=N?parseInt(N,10):void 0,Y=await E.connect({timeout:Qe,session:c,surface:v,...p.adapter?{siteSession:"persistent"}:{},...a&&{contextId:a},...te&&te>0&&{idleTimeout:te},windowMode:p.windowMode??nt(void 0,"background")}),X=Pe(p.adapter?`adapter:${c}`:c,a),I=l?await rt(Y,l,{scope:X,source:"explicit"}):await Cr(Y,X);if(I){if(!Y.setActivePage)throw Error("This browser session does not support explicit tab targeting");Y.setActivePage(I)}return{page:Y,close:()=>E.close()}}function nt(c,l){const a=Ie(c,"window");if(a!==void 0&&a!==""){if(a==="foreground"||a==="background")return a;throw Error(`--window must be one of: foreground, background. Received: "${String(a)}"`)}const p=process.env.OPENCLI_WINDOW;if(p!==void 0&&p!==""){if(p==="foreground"||p==="background")return p;throw Error(`OPENCLI_WINDOW must be one of: foreground, background. Received: "${p}"`)}return l}function C(c){return c.option("--tab <targetId>",gr)}function _r(c){if(!c)return;const l=c.optsWithGlobals?c.optsWithGlobals():c.opts();return typeof l.tab==="string"&&l.tab.trim()?l.tab.trim():void 0}function Ie(c,l){let a=c;while(a){const p=a.opts();if(Object.prototype.hasOwnProperty.call(p,l)&&p[l]!==void 0)return p[l];a=a.parent}return}function qt(c){const l=Ie(c,"session");if(typeof l==="string"&&l.trim())return l.trim();throw Error("<session> is a required positional argument: ppcli browser <session> <command>")}function Vt(c){return ir(it(c))}function it(c){const l=Ie(c,"profile");return typeof l==="string"&&l.trim()?l.trim():void 0}function st(c){const l=c.session;if(typeof l==="string"&&l.trim())return l.trim();throw Error("Browser page is missing a session")}function Je(c){const l=c.contextId;return Pe(st(c),typeof l==="string"&&l.trim()?l.trim():void 0)}function Or(c){return typeof c==="string"?c:JSON.stringify(c,null,2)}function $r(c,l){const a=Or(c),p=a.match(/^interactive:\s*(\d+)\s*$/m);return{ok:!0,chars:a.length,bytes:Buffer.byteLength(a,"utf8"),lines:a?a.split(/\r?\n/).length:0,approx_tokens:Math.ceil(a.length/4),refs:(a.match(/(^|\n)\s*\[\d+\]/g)??[]).length,frame_sections:(a.match(/(^|\n)frame /g)??[]).length,...p?{interactive:Number(p[1])}:{},elapsed_ms:l}}async function Xt(c,l){const a=Date.now();try{const p=await c.snapshot({viewportExpand:2000,source:l});return $r(p,Date.now()-a)}catch(p){return{ok:!1,elapsed_ms:Date.now()-a,error:{...p instanceof Error&&"code"in p?{code:String(p.code)}:{},message:p instanceof Error?p.message:String(p)}}}}function Kt(c,l){if(typeof c==="string"&&c.trim())return c.trim();const a=l instanceof Ne?l.opts().tab:l?.tab;if(typeof a==="string"&&a.trim())return a.trim();return}function Zt(c,l,a){if(c===void 0)return a;const p=parseInt(c,10);if(Number.isNaN(p)||p<=0){console.error(`[cli] Invalid ${l}="${c}", using default ${a}`);return a}return p}function Yt(c,l){if(!/^\d+$/.test(c))throw new Ct(`--${l} must be a positive integer (got "${c}")`);const a=parseInt(c,10);if(a<=0)throw new Ct(`--${l} must be a positive integer (got "${c}")`);return a}function Nr(c){if(c.verbose)process.env.OPENCLI_VERBOSE="1"}function kr(c){return[...new Set(c.commands.map((l)=>l.name()))].sort((l,a)=>l.localeCompare(a)).join(", ")}function Ar(c){for(const l of c.commands){if(l.commands.length===0)continue;const a=kr(l);if(a)l.description(a)}}export function createProgram(c,l){const a=new Ne;a.name("ppcli").description("Make any website your CLI. Zero setup. AI-powered.").version(ke).option("--profile <name>","Chrome profile/context alias for Browser Bridge commands").enablePositionalOptions();a.command("list").description("List all available CLI commands").option("-f, --format <fmt>","Output format: table, json, yaml, md, csv","table").action((e)=>{const t=Ee(),o=[...new Set(t.values())].sort((m,g)=>He(m).localeCompare(He(g))),r=e.format,n=r==="json"||r==="yaml";if(r!=="table"){const m=n?o.map(wo):o.map((g)=>({command:He(g),site:g.site,name:g.name,aliases:g.aliases?.join(", ")??"",description:g.description,access:g.access,strategy:Et(g),browser:!!g.browser,args:yo(g.args)}));_e(m,{fmt:r,columns:["command","site","name","aliases","description","access","strategy","browser","args",...n?["columns","domain"]:[]],title:"ppcli/list",source:"ppcli list"});return}const i=new Map,s=new Map;for(const m of o){const g=Ot(m.domain)==="app"?i:s,b=g.get(m.site)??[];b.push(m);g.set(m.site,b)}const d=(m,g)=>{console.log(` ${m}`);for(const b of g){const R=Et(b),P=R==="public"?"[public]":`[${R}]`,G=b.aliases?.length?` (aliases: ${b.aliases.join(", ")})`:"";console.log(` ${b.name} ${P}${G}${b.description?` — ${b.description}`:""}`)}console.log()};console.log();console.log(" ppcli"+" — available commands");console.log();if(i.size>0){console.log(" App adapters");console.log();for(const[m,g]of i)d(m,g)}if(s.size>0){console.log(" Site adapters");console.log();for(const[m,g]of s)d(m,g)}const u=qe();if(u.length>0){console.log(" external CLIs");for(const m of u){const b=Ve(m.binary)?"[installed]":"[auto-install]";console.log(` ${_t(m)} ${b}${m.description?` — ${m.description}`:""}`)}console.log()}console.log(` ${o.length} built-in commands across ${i.size} apps + ${s.size} sites, ${u.length} external CLIs`);console.log()});a.command("validate").description("Validate CLI definitions").argument("[target]","site or site/name").action(async(e)=>{const{validateClisWithTarget:t,renderValidationReport:o}=await import("./validate.js");console.log(o(t([c,l],e)))});a.command("verify").description("Validate + smoke test").argument("[target]").option("--smoke","Run smoke tests",!1).action(async(e,t)=>{const{verifyClis:o,renderVerifyReport:r}=await import("./verify.js"),n=await o({builtinClis:c,userClis:l,target:e,smoke:t.smoke});console.log(r(n));process.exitCode=n.ok?f.SUCCESS:f.GENERIC_ERROR});const p=a.command("skills").description("Read bundled ppcli skills");p.command("list").description("List bundled ppcli-* skills").option("-f, --format <fmt>","Output format: table, json, yaml, md, csv","table").action((e)=>{const t=Ro();_e(t,{fmt:e.format,fmtExplicit:!!e.format,columns:["name","description","version","path"],title:"ppcli/skills/list",source:"ppcli skills list"})});p.command("read").description("Print an ppcli-* skill's SKILL.md or reference file").argument("<skill>","Skill name, or skill/path like opencli-browser/references/foo.md").argument("[path]","Path under the skill directory").option("--json","Output a JSON envelope instead of raw markdown",!1).action((e,t,o)=>{let r;try{r=Co(e,t??"")}catch(n){console.error(`Error: ${U(n)}`);if(n instanceof Xe&&n.hint)console.error(`Hint: ${n.hint}`);process.exitCode=n instanceof Xe?n.exitCode:f.GENERIC_ERROR;return}if(o.json){console.log(JSON.stringify(r,null,2));return}process.stdout.write(r.content);if(!r.content.endsWith(`
|
|
3
3
|
`))process.stdout.write(`
|
|
4
|
-
`)});const v=
|
|
4
|
+
`)});const v=Xo(a);a.command("convention-audit").description("Scan adapters for agent-native convention violations").argument("[target]","site or site/name").option("--site <site>","Limit audit to one site").option("-f, --format <fmt>","Output format: table, json, yaml","table").option("--strict","Exit non-zero when violations are found",!1).action(async(e,t)=>{const{runConventionAudit:o,renderConventionAuditText:r}=await import("./convention-audit.js"),n=o({projectRoot:findPackageRoot(et),target:e,site:t.site}),i=String(t.format??"table").toLowerCase();if(i==="json"||i==="yaml"||i==="yml")_e(n,{fmt:i});else console.log(r(n));if(t.strict&&!n.ok)process.exitCode=f.GENERIC_ERROR});const h=a.command("browser").addOption(new fo("--session <name>","Internal — set automatically from the <session> positional").hideHelp()).option("--window <mode>","Browser window mode: foreground or background").description("Browser control — navigate, click, type, extract, wait (no LLM needed)").usage("<session> <command> [options]").addHelpText("after",`
|
|
5
5
|
<session> is a required positional: pass the name of the browser session every subcommand should operate on. Reuse the same name across calls to keep the tab/state alive; pick a different name to isolate parallel browser work.
|
|
6
6
|
|
|
7
7
|
Examples:
|
|
@@ -11,8 +11,8 @@ Examples:
|
|
|
11
11
|
$ ppcli browser work state
|
|
12
12
|
$ ppcli browser work bind
|
|
13
13
|
$ ppcli browser work unbind
|
|
14
|
-
`),T=
|
|
15
|
-
`);console.log(typeof r==="string"?r:JSON.stringify(r,null,2))}));
|
|
14
|
+
`),T=h.description();async function E(e,t,o={}){const r=await e.evaluate(To(t,o));if(!r.ok)throw new $t({code:r.code,message:r.message,hint:r.hint,candidates:r.candidates,matches_n:r.matches_n});return{matches_n:r.matches_n,match_level:r.match_level}}function N(e){if(e===void 0||e===null||e==="")return null;const t=String(e);if(!/^\d+$/.test(t))return{error:`--nth must be a non-negative integer, got "${t}"`};return Number.parseInt(t,10)}function te(e){console.log(JSON.stringify({error:{code:e.code,message:e.message,hint:e.hint,...e.candidates&&{candidates:e.candidates},...e.matches_n!==void 0&&{matches_n:e.matches_n}}},null,2))}function Y(e){return e.toLowerCase().includes("javascript dialog")}function X(e){console.log(JSON.stringify({error:{code:"javascript_dialog_open",message:e,hint:"Handle the modal first: ppcli browser dialog accept (or dismiss). Use --text for prompt dialogs."}},null,2))}function I(e){if(!e.code)return;console.log(JSON.stringify({error:{code:e.code,message:e.message,...e.hint?{hint:e.hint}:{}}},null,2))}function K(e){Q.error(e.message);if(e.hint)Q.error(`Hint: ${e.hint}`)}function x(e){return async(...t)=>{let o=null;try{const r=t.at(-1)instanceof Ne?t.at(-1):void 0,n=_r(r),i=qt(r),s=Vt(r),d=nt(r,"background");o=await Er(i,n,s,{windowMode:d,profile:it(r),adapter:Ie(r,"adapter")===!0});await e(o.page,...t)}catch(r){if(r instanceof ko){Q.error(r.message);if(r.hint)Q.error(`Hint: ${r.hint}`)}else if(r instanceof It){if(Y(r.message))X(r.message);else I(r);K(r)}else if(r instanceof $t){te(r);Q.error(`[${r.code}] ${r.message}`);if(r.hint)Q.error(`Hint: ${r.hint}`)}else{const n=U(r);if(Y(n)){X(n);Q.error(n)}else if(n.includes("attach failed")||n.includes("chrome-extension://"))Q.error("Browser attach failed — another extension may be interfering. Try disabling 1Password.");else Q.error(n)}process.exitCode=f.GENERIC_ERROR}finally{await o?.close()}}}function Oe(e,t){return async(o,r)=>{const n=o instanceof Ne?o:r,i=qt(n),s=Vt(n);try{if(t?.managedGuardMessage&&jt(it(n)).kind==="managed")throw Error(t.managedGuardMessage);const{BrowserBridge:d}=await import("./browser/index.js");await new d().connect({timeout:Qe,session:i,surface:"browser",...s&&{contextId:s}});await e({session:i,contextId:s})}catch(d){if(d instanceof It){I(d);K(d)}else Q.error(d instanceof Error?d.message:String(d));process.exitCode=f.GENERIC_ERROR}}}h.command("bind").description("Bind the current Chrome tab/window to the browser session named by <session>").action(Oe(async({session:e,contextId:t})=>{const o=await er(e,{...t&&{contextId:t}});be(void 0,Pe(e,t));console.log(JSON.stringify({session:e,...o&&typeof o==="object"?o:{data:o}},null,2))},{managedGuardMessage:"托管环境不支持 bind：它是独立自动化窗口，直接用 browser open/eval 等命令即可。"}));h.command("unbind").description("Detach the bound browser session named by <session> without closing the user tab/window").action(Oe(async({session:e,contextId:t})=>{await tr("close-window",{session:e,surface:"browser",...t&&{contextId:t}});be(void 0,Pe(e,t));console.log(JSON.stringify({unbound:!0,session:e},null,2))},{managedGuardMessage:"托管环境不支持 unbind：它没有绑定到扩展的会话。"}));const le=h.command("tab").description("Tab management — list, create, and close tabs in the browser session");le.command("list").description("List tabs in the browser session with target IDs").action(x(async(e)=>{const t=await e.tabs();console.log(JSON.stringify(t,null,2))}));le.command("new").argument("[url]","Optional URL to open in the new tab").description("Create a new tab and print its target ID").action(x(async(e,t)=>{if(!e.newTab)throw Error("This browser session does not support creating tabs");const o=await e.newTab(t);console.log(JSON.stringify({page:o,url:t??null},null,2))}));C(le.command("select").argument("[targetId]",'Target tab/page identity returned by "browser open", "browser tab new", or "browser tab list"').description("Select a tab by target ID and make it the default browser tab")).action(x(async(e,t,o)=>{const r=Kt(t,o);if(!r)throw Error("Target tab required. Pass it as an argument or --tab <targetId>.");await e.selectTab(r);be(r,Je(e));console.log(JSON.stringify({selected:r},null,2))}));C(le.command("close").argument("[targetId]",'Target tab/page identity returned by "browser open", "browser tab new", or "browser tab list"').description("Close a tab by target ID")).action(x(async(e,t,o)=>{const r=Kt(t,o);if(!e.closeTab)throw Error("This browser session does not support closing tabs");if(!r)throw Error("Target tab required. Pass it as an argument or --tab <targetId>.");const n=await rt(e,r,{scope:Je(e),source:"explicit"});if(!n)throw Error(`Target tab ${r} is not part of the current browser session.`);await e.closeTab(n);const i=Je(e);if(Ht(i)?.defaultPage===n)be(void 0,i);console.log(JSON.stringify({closed:n},null,2))}));C(h.command("open").argument("<url>").description("Open URL in the browser session")).action(x(async(e,t,o)=>{const r=await e.startNetworkCapture?.()??!1;await e.goto(t);await e.wait(2);if(!r)try{await e.evaluate(Ae)}catch{}const n=await e.getCurrentUrl?.()??t,i=vr(n,Je(e),{oncePerSession:!0});console.log(JSON.stringify({url:n,...e.getActivePage?.()?{page:e.getActivePage?.()}:{},...i?{sitemap:i}:{}},null,2))}));C(h.command("back").description("Go back in browser history")).action(x(async(e,t)=>{await e.evaluate("history.back()");await e.wait(2);console.log("Navigated back")}));C(h.command("scroll").argument("<direction>","up or down").option("--amount <pixels>","Pixels to scroll","500")).description("Scroll page").action(x(async(e,t,o)=>{if(t!=="up"&&t!=="down"){console.error(`Invalid direction "${t}". Use "up" or "down".`);process.exitCode=f.USAGE_ERROR;return}await e.scroll(t,parseInt(o.amount,10));console.log(`Scrolled ${t}`)}));C(h.command("state").description("Page state: URL, title, interactive elements with [N] indices").option("--source <source>","Snapshot backend: dom (default) or ax prototype","dom").option("--compare-sources","Print DOM vs AX snapshot metrics for observation promotion decisions",!1)).action(x(async(e,t)=>{if(t.compareSources===!0){const[i,s]=await Promise.all([Xt(e,"dom"),Xt(e,"ax")]);console.log(JSON.stringify({url:await e.getCurrentUrl?.()??"",sources:{dom:i,ax:s}},null,2));return}const o=String(t.source??"dom").toLowerCase();if(o!=="dom"&&o!=="ax"){console.log(JSON.stringify({error:{code:"invalid_source",message:`--source must be "dom" or "ax", got "${t.source}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const r=await e.snapshot({viewportExpand:2000,source:o}),n=await e.getCurrentUrl?.()??"";console.log(`URL: ${n}
|
|
15
|
+
`);console.log(typeof r==="string"?r:JSON.stringify(r,null,2))}));C(h.command("frames").description("List cross-origin iframe targets in snapshot order")).action(x(async(e)=>{const t=await e.frames?.()??[];console.log(JSON.stringify(t,null,2))}));C(h.command("screenshot").argument("[path]","Save to file (base64 if omitted)")).option("--full-page","Capture the full scrollable page, not just the viewport",!1).option("--annotate","Overlay visible browser state ref labels on the screenshot",!1).option("--width <n>","Override viewport width in CSS pixels for this screenshot only",(e)=>Yt(e,"width")).option("--height <n>","Override viewport height in CSS pixels for this screenshot only (ignored with --full-page)",(e)=>Yt(e,"height")).option("--scroll-to <selector>","Scroll this element into view (centered) before capturing").description("Take screenshot").action(x(async(e,t,o)=>{if(o.scrollTo){const i=JSON.stringify(String(o.scrollTo));if(!await e.evaluate(`(() => { const el = document.querySelector(${i}); if (!el) return false; el.scrollIntoView({ block: 'center', inline: 'center' }); return true; })()`))throw new F(`--scroll-to 没匹配到元素: ${o.scrollTo}`);await e.wait(150)}const r={fullPage:o.fullPage===!0,annotate:o.annotate===!0,width:o.width,height:o.height},n=o.annotate===!0?(e.annotatedScreenshot??e.screenshot).bind(e):e.screenshot.bind(e);if(t){await n({...r,path:t});console.log(`Screenshot saved to: ${t}`)}else console.log(await n({...r,format:"png"}))}));const xe=['iframe[src*="/verifycenter/captcha/"]',".js-mocaptcha-img",".moclickcaptcha-img",".moclickcaptcha-draw",".geetest_item_img",".geetest_widget canvas",".captcha-image img",".captcha img",".captcha canvas",'img[src*="captcha" i]','img[class*="captcha" i]','canvas[class*="captcha" i]'],oe=6;function ie(e){const t=e&&e.trim()?[e.trim()]:xe;return`(() => {
|
|
16
16
|
var sels = ${JSON.stringify(t)};
|
|
17
17
|
var el = null, used = '';
|
|
18
18
|
for (var i = 0; i < sels.length; i++) {
|
|
@@ -48,7 +48,7 @@ Examples:
|
|
|
48
48
|
iframe: el.tagName === 'IFRAME',
|
|
49
49
|
scroll: { x: window.scrollX, y: window.scrollY },
|
|
50
50
|
};
|
|
51
|
-
})()`}function
|
|
51
|
+
})()`}function Se(e){const t=e&&e.trim()?[e.trim()]:xe;return`(() => {
|
|
52
52
|
var sels = ${JSON.stringify(t)};
|
|
53
53
|
var present = false;
|
|
54
54
|
for (var i = 0; i < sels.length; i++) {
|
|
@@ -71,7 +71,15 @@ Examples:
|
|
|
71
71
|
}
|
|
72
72
|
} catch (e) {}
|
|
73
73
|
return { captcha_present: present, status_text: status, url: (location.href || '').slice(0, 100) };
|
|
74
|
-
})()`}function
|
|
74
|
+
})()`}function $e(e,t){const o=Math.max(0,e.x-oe),r=Math.max(0,e.y-oe),n=Math.min(t.w,e.x+e.w+oe)-o,i=Math.min(t.h,e.y+e.h+oe)-r;if(n<=0||i<=0)throw new F("验证码区域不在可见视口内，请重新截图定位");return{x:o,y:r,w:n,h:i}}const je="__pp_captcha_grid";function Qt(e){const t=Math.min(e.w,e.h)>=240?50:Math.min(e.w,e.h)>=100?25:10,o=[],r=(i,s,d,u)=>`<text x="${i}" y="${s}" text-anchor="${u}" font-size="10" font-family="sans-serif" fill="#e00" stroke="#fff" stroke-width="2.5" paint-order="stroke">${d}</text>`;for(let i=t;i<e.w;i+=t)o.push(`<line x1="${i}" y1="0" x2="${i}" y2="${e.h}"/>`,r(i,10,i,"middle"));for(let i=t;i<e.h;i+=t)o.push(`<line x1="0" y1="${i}" x2="${e.w}" y2="${i}"/>`,r(2,i+3,i,"start"));const n=`<svg width="${e.w}" height="${e.h}" style="display:block"><g stroke="rgba(255,0,0,.35)" stroke-width="1">${o.join("")}</g></svg>`;return`(() => {
|
|
75
|
+
document.getElementById(${JSON.stringify(je)})?.remove();
|
|
76
|
+
const div = document.createElement('div');
|
|
77
|
+
div.id = ${JSON.stringify(je)};
|
|
78
|
+
div.style.cssText = ${JSON.stringify(`position:fixed;left:${e.x}px;top:${e.y}px;width:${e.w}px;height:${e.h}px;pointer-events:none;z-index:2147483647`)};
|
|
79
|
+
div.innerHTML = ${JSON.stringify(n)};
|
|
80
|
+
document.documentElement.appendChild(div);
|
|
81
|
+
return new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(() => r(true))));
|
|
82
|
+
})()`}async function Me(e,t){const o=await e.evaluate(ie(t));if(!o||!o.found||!o.rect)return null;return{crop:$e(o.rect,o.viewport),scroll:o.scroll??{x:0,y:0},viewport:o.viewport}}function re(e,t,o){const r=String(e??"").split(",").map((n)=>Number(n.trim()));if(r.length!==t||r.some((n)=>!Number.isFinite(n)||n<0))throw new F(`${o} 应为 ${t} 个逗号分隔的非负数（crop 网格刻度，CSS 像素）`);return r}async function De(e,t,o,r){await new Promise((s)=>setTimeout(s,900));let n={};try{n=await e.evaluate(Se(t))}catch(s){n={read_error:U(s)}}const i=o?String(o):void 0;if(i)await e.screenshot({path:i,format:"png"});console.log(JSON.stringify({ok:!0,...r,after:n,...i?{saved:i}:{}},null,2))}C(h.command("captcha").argument("[selector]","验证码图片元素 CSS 选择器（缺省自动探测常见点选验证码）")).option("--adapter","定位已有平台适配器会话；session 必须是 site:<site>，如 site:douyin").option("--save <path>","把全视口截图存到该路径（缺省存到临时 PNG 文件）").option("--scale <n>","验证码区域裁剪图的放大倍数（1..6，缺省 3；放大后认扭曲字更准）","3").option("--grid","在裁剪图上画坐标网格（刻度是裁剪图里的 CSS 像素），给 captcha-slide / captcha-rotate / captcha-drag 读位置用").description("抓取验证码：存整图 + 只含验证码的放大裁剪图 + 返回坐标与提示文字，供 AI 视觉识别后配合 captcha-click / captcha-slide / captcha-rotate / captcha-drag").action(x(async(e,t,o)=>{const r=await e.evaluate(ie(typeof t==="string"?t:void 0));if(!r||!r.found){console.log(JSON.stringify({error:{code:"captcha_not_found",message:'未探测到点选验证码图片。可显式传选择器，如 ppcli browser <s> captcha ".js-mocaptcha-img"',tried:xe}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=o?.save&&String(o.save)||k.join(ge.tmpdir(),`opencli-captcha-${Date.now()}.png`);await e.screenshot({format:"png",path:n});const i=r.rect,s=r.dpr||1,d=$e(i,r.viewport),u=Math.max(1,Math.min(6,Number(o?.scale??3)||3)),m=oe;let g=null;const b=e.cdp;if(typeof b==="function"){const R={x:d.x+(r.scroll?.x??0),y:d.y+(r.scroll?.y??0),width:d.w,height:d.h,scale:u};if(o?.grid)await e.evaluate(Qt(d));const P=await b.call(e,"Page.captureScreenshot",{format:"jpeg",quality:82,clip:R,captureBeyondViewport:!1}).finally(()=>o?.grid?e.evaluate(`document.getElementById(${JSON.stringify(je)})?.remove()`):void 0);if(P&&P.data){g=n.replace(/\.png$/i,"")+".crop.jpg";A.writeFileSync(g,Buffer.from(P.data,"base64"))}}console.log(JSON.stringify({ok:!0,selector:r.selector,iframe:r.iframe===!0,crop_rect_css:g?d:null,prompt:r.prompt||"",crop:g,crop_scale:g?u:null,crop_pad:g?m:null,saved:n,rect_css:i,rect_screenshot_px:{x:Math.round(i.x*s),y:Math.round(i.y*s),w:Math.round(i.w*s),h:Math.round(i.h*s)},dpr:s,natural:r.natural,viewport:r.viewport,...o?.grid?{grid_guide:"网格刻度是 crop 里的 CSS 像素（左上角 0,0），captcha-slide / captcha-rotate / captcha-drag 的坐标都按刻度读，并传同一个 --in 选择器。"}:{},guide:"① read_local_file 打开 crop（只含验证码、已放大）认清每个待点字与顺序（注意会混入不在 prompt 里的干扰字，只点 prompt 要求的）。"+"② 坐标直接读成「在 crop 这张图里的比例」(0..1，左上角为 0,0)——不用管 pad/rect，看到字在 crop 的哪就填哪。"+"③ 执行：ppcli browser <session> captcha-click"+(o.adapter?" --adapter":"")+" --crop --in '"+r.selector.replace(/'/g,"'\\''")+"'"+' "x1,y1 x2,y2 ..."（--crop 表示坐标是 crop 图比例；空格分隔，顺序即点击顺序）。'+"iframe 的提示与确认按钮请从截图读取；点完文字后可能仍需点确认。验证码仍在不代表可以重复点字；先截图检查。"},null,2))}));C(h.command("captcha-click").argument("<points>",'待点击坐标，空格分隔且顺序即点击顺序，如 "0.30,0.46 0.68,0.66"')).option("--adapter","定位已有平台适配器会话；session 必须是 site:<site>，如 site:douyin").option("--save <path>","点击后保存全视口截图，以核对点选标记、确认按钮及验证结果").option("--in <selector>","坐标映射基准元素（缺省自动探测验证码图片）").option("--crop","坐标按「captcha 裁剪图(crop)里的比例」解释(0..1，左上角为0,0)——AI 看哪张就按那张填，内部自动扣掉 pad。推荐").option("--px","坐标按「截图设备像素」解释（自动按 devicePixelRatio 换算成 CSS 像素）").option("--css","坐标按「CSS 视口像素」解释（直接点击，不做映射）").option("--delay <ms>","每次点击之间的间隔毫秒","250").description("按坐标依次点击（点选验证码用）：把 AI 从图上读到的位置一次性点上，点完回读验证码是否还在/是否跳转。默认坐标为相对基准元素的比例(0..1)，--crop 则为裁剪图比例").action(x(async(e,t,o)=>{const n=String(t??"").trim().split(/\s+/).filter(Boolean).map((y)=>{const S=y.split(",");if(S.length!==2||S.some((D)=>!D.trim()))return{x:NaN,y:NaN};return{x:Number(S[0]),y:Number(S[1])}});if(n.length===0||n.some((y)=>!Number.isFinite(y.x)||!Number.isFinite(y.y))){console.log(JSON.stringify({error:{code:"usage_error",message:'坐标格式应为 "x,y x,y ..."，如 "0.30,0.46 0.68,0.66"'}},null,2));process.exitCode=f.USAGE_ERROR;return}if([o?.css,o?.px,o?.crop].filter(Boolean).length>1)throw new F("--css / --px / --crop 不能同时使用");const i=o?.css?"css":o?.px?"px":o?.crop?"crop":"frac";if(n.some((y)=>y.x<0||y.y<0||(i==="frac"||i==="crop")&&(y.x>1||y.y>1)))throw new F("相对坐标必须在 0..1 内，绝对坐标必须非负；尚未点击");const s=Number(o?.delay??250);if(!Number.isFinite(s)||s<0||s>1e4)throw new F("--delay 必须在 0..10000 毫秒内");let d={x:0,y:0,w:0,h:0},u=1,m;if(i==="css"||i==="px"){const y=await e.evaluate("({w: innerWidth, h: innerHeight, dpr: devicePixelRatio})");m=y;u=y.dpr}else{const y=await e.evaluate(ie(typeof o?.in==="string"?o.in:void 0));if(!y||!y.found||!y.rect){console.log(JSON.stringify({error:{code:"captcha_not_found",message:"captcha-click 找不到基准元素，请用 --in <selector> 指定，或用 --css 传绝对坐标"}},null,2));process.exitCode=f.USAGE_ERROR;return}d=y.rect;u=y.dpr||1;m=y.viewport}const g=i==="crop"?$e(d,m):d,b=(y)=>{if(i==="css")return y;if(i==="px")return{x:y.x/u,y:y.y/u};if(i==="crop")return{x:g.x+y.x*g.w,y:g.y+y.y*g.h};return{x:d.x+y.x*d.w,y:d.y+y.y*d.h}},{cdp:R,nativeClick:P}=e,G=n.map(b).map((y)=>({x:Math.round(y.x),y:Math.round(y.y)}));if(G.some((y)=>y.x<0||y.y<0||y.x>=m.w||y.y>=m.h))throw new F("点击坐标超出视口；尚未点击，请重新截图定位");if(typeof R!=="function"&&typeof P!=="function")throw new F("当前浏览器不支持原生坐标点击");const _=(y)=>new Promise((S)=>setTimeout(S,y));async function M(y,S,D,B){if(typeof R==="function"){const ae=12+B%4;for(let q=1;q<=ae;q++){const H=q/ae,ce=H*H*(3-2*H),fe=Math.sin(H*Math.PI)*10*(B%2===0?1:-1),j=D.x+(y-D.x)*ce,V=D.y+(S-D.y)*ce+fe;await R.call(e,"Input.dispatchMouseEvent",{type:"mouseMoved",x:Math.round(j),y:Math.round(V)});await _(8+q%3*6)}await R.call(e,"Input.dispatchMouseEvent",{type:"mouseMoved",x:y,y:S});await _(40+B%3*25);await R.call(e,"Input.dispatchMouseEvent",{type:"mousePressed",x:y,y:S,button:"left",clickCount:1});await _(45+B%4*20);await R.call(e,"Input.dispatchMouseEvent",{type:"mouseReleased",x:y,y:S,button:"left",clickCount:1});return"cdp"}if(typeof P==="function"){await P.call(e,y,S);return"native"}throw new F("当前浏览器不支持原生坐标点击")}const J=[];let W="",ne={x:Math.round(d.x+d.w/2)||400,y:Math.round(d.y-40)||200};for(let y=0;y<G.length;y++){const S=G[y],D=Math.round(S.x),B=Math.round(S.y);W=await M(D,B,ne,y);ne={x:D,y:B};J.push({x:D,y:B});if(y<n.length-1&&s>0)await _(s)}await _(700);let w={};try{w=await e.evaluate(Se(typeof o?.in==="string"?o.in:void 0))}catch(y){w={read_error:U(y)}}const O=o.save?String(o.save):void 0;if(O)await e.screenshot({path:O,format:"png"});console.log(JSON.stringify({ok:!0,mode:i,method:W,clicked_n:J.length,points_css:J,after:w,...O?{saved:O}:{}},null,2))}));const Ue='与 captcha 相同的验证码元素选择器（缺省自动探测；抖音为 iframe[src*="/verifycenter/captcha/"]）';C(h.command("captcha-slide")).option("--adapter","定位已有平台适配器会话；session 必须是 site:<site>，如 site:douyin").option("--in <selector>",Ue).requiredOption("--handle <x,y>","滑块把手中心（crop 网格刻度）").requiredOption("--picture <x,y,w,h>","带拼图和缺口的那张图片的区域（crop 网格刻度）").option("--gap <px>","目测拼图大概要往右挪多远（可选，只用来缩小搜索范围）").option("--save <path>","松手后保存全视口截图").description("缺口拼图（「拖动滑块填充拼图」）：按住先拖一小段，自己量拖动比例、找缺口，拖到位纠偏后松手").action(x(async(e,t)=>{const o=typeof t?.in==="string"?t.in:void 0,[r,n]=re(t.handle,2,"--handle"),[i,s,d,u]=re(t.picture,4,"--picture");if(d<20||u<20)throw new F("--picture 太小：框的应是整张带缺口的图片");const m=t.gap===void 0?void 0:Number(t.gap);if(m!==void 0&&!Number.isFinite(m))throw new F("--gap 必须是数字");const g=await Me(e,o);if(!g)throw new F("找不到验证码元素：传与 captcha 相同的 --in <selector>");const{solveSlidePuzzle:b}=await import("./browser/captcha-drag.js"),R=await b(e,{x:g.crop.x+r,y:g.crop.y+n,clip:{x:g.crop.x+i+g.scroll.x,y:g.crop.y+s+g.scroll.y,width:d,height:u},hint:m});if(!R)throw new F("没认出拼图和缺口，已拖回原位未提交：重新 captcha --grid 看清 --picture 框的是不是整张图");await De(e,o,t.save,R)}));C(h.command("captcha-rotate")).option("--adapter","定位已有平台适配器会话；session 必须是 site:<site>，如 site:douyin").option("--in <selector>",Ue).requiredOption("--handle <x,y>","滑块把手中心（crop 网格刻度）").requiredOption("--track <px>","把手大概能往右拖多远（工具会自己量轨道，量不出才用它）").requiredOption("--center <x,y>","圆图圆心（crop 网格刻度）").requiredOption("--radius <px>","内圈那块圆图的半径（不含外圈）").option("--save <path>","松手后保存全视口截图").description("旋转拼图（中间圆图和外圈一起转，抖音 / 字节验证中心那种）：自己量内外圈差几度，拖到对齐、纠偏后松手").action(x(async(e,t)=>{const o=typeof t?.in==="string"?t.in:void 0,[r,n]=re(t.handle,2,"--handle"),[i,s]=re(t.center,2,"--center"),[d]=re(t.track,1,"--track"),[u]=re(t.radius,1,"--radius");if(u<15)throw new F("--radius 太小：量的是内圈圆图的半径");const m=await Me(e,o);if(!m)throw new F("找不到验证码元素：传与 captcha 相同的 --in <selector>");const g=u*1.5,{solveRotate:b}=await import("./browser/captcha-drag.js"),R=await b(e,{x:m.crop.x+r,y:m.crop.y+n,track:d,clip:{x:m.crop.x+i-g+m.scroll.x,y:m.crop.y+s-g+m.scroll.y,width:g*2,height:g*2},ring:{cx:g,cy:g,r:u},bar:{x:m.crop.x+m.scroll.x,y:m.crop.y+n+m.scroll.y,width:m.crop.w,handleX:r}});await De(e,o,t.save,R)}));C(h.command("captcha-drag")).option("--adapter","定位已有平台适配器会话；session 必须是 site:<site>，如 site:douyin").option("--in <selector>",Ue).requiredOption("--handle <x,y>","滑块把手中心（crop 网格刻度）").requiredOption("--dx <px>","往右拖多远（「拖到最右边」就给轨道剩余长度）").option("--save <path>","松手后保存全视口截图").description("按人手轨迹按住把手拖一段再松开：「请按住滑块拖到最右边」这类；拼图 / 旋转用 captcha-slide / captcha-rotate").action(x(async(e,t)=>{const o=typeof t?.in==="string"?t.in:void 0,[r,n]=re(t.handle,2,"--handle"),[i]=re(t.dx,1,"--dx"),s=await Me(e,o);if(!s)throw new F("找不到验证码元素：传与 captcha 相同的 --in <selector>");const{humanDrag:d}=await import("./browser/captcha-drag.js"),u=await d(e,s.crop.x+r,s.crop.y+n,i);await De(e,o,t.save,u)}));C(h.command("console")).option("--level <level>","Console level: all, error, warning, log, info, debug","all").option("--since <duration>","Only include messages from the last duration (for example: 30s, 2m)").option("--until <duration>","Only include messages older than the duration from now").option("--follow","Continuously print new console messages as JSON lines",!1).description("Read recent browser console messages").action(x(async(e,t)=>{const o=Te(t.since,"since"),r=Te(t.until,"until");if(o&&typeof o==="object"){console.log(JSON.stringify({error:{code:"invalid_since",message:o.error}},null,2));process.exitCode=f.USAGE_ERROR;return}if(r&&typeof r==="object"){console.log(JSON.stringify({error:{code:"invalid_until",message:r.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=(d)=>d.map((u)=>{if(u&&typeof u==="object"){const m=u;return{...m,timestamp:tt(m.timestamp)}}return{type:"log",text:String(u),timestamp:Date.now()}}),i=(d)=>ot(d,{sinceMs:o,untilMs:r}).filter((u)=>{if(t.level==="all")return!0;const m=String(u.type??u.level??"").toLowerCase();return t.level==="error"?m==="error"||m==="warning":m===String(t.level).toLowerCase()});if(t.follow){let d=0;while(!0){const u=i(n(await e.consoleMessages("all"))),m=selectFreshByTimestamp(u,d);for(const g of m.fresh)console.log(JSON.stringify({...g,timestamp:we(g.timestamp)}));d=m.lastSeenTs;await new Promise((g)=>setTimeout(g,Dt))}}const s=i(n(await e.consoleMessages(t.level)));console.log(JSON.stringify({session:st(e),captured_at:new Date().toISOString(),count:s.length,messages:s.map((d)=>({...d,timestamp:we(d.timestamp)}))},null,2))}));C(h.command("analyze").argument("<url>")).description("Classify site: anti-bot vendor, real-data API candidates, pattern (A/B/C/D), nearest adapter, next step").action(x(async(e,t)=>{const o=await e.startNetworkCapture?.()??!1;await e.goto(t);await e.wait(2);if(!o)try{await e.evaluate(Ae)}catch{}await ye(e);await e.wait(1);const n=(await ye(e)).map((R)=>({url:R.url,status:R.status,contentType:R.ct,bodyPreview:typeof R.body==="string"?R.body.slice(0,2000):R.body?JSON.stringify(R.body).slice(0,2000):null})),i=`(function(){
|
|
75
83
|
return {
|
|
76
84
|
cookieNames: (document.cookie || '').split(';').map(function(c){ return c.trim().split('=')[0]; }).filter(Boolean),
|
|
77
85
|
initialState: {
|
|
@@ -83,8 +91,8 @@ Examples:
|
|
|
83
91
|
title: document.title || '',
|
|
84
92
|
finalUrl: location.href,
|
|
85
93
|
};
|
|
86
|
-
})()`,l=await e.evaluate(s),d=(await e.getCookies({url:l.finalUrl||t}).catch(()=>[])).map((C)=>C.name).filter(Boolean),u=[...new Set([...l.cookieNames,...d])],p={requestedUrl:t,finalUrl:l.finalUrl,cookieNames:u,networkEntries:n,initialState:l.initialState,title:l.title},h=Bo(p,Re()),S=resolveSitemapAvailabilityForUrl(l.finalUrl||t);console.log(JSON.stringify({...h,...S?{sitemap:S}:{}},null,2))}));const L=(e)=>e.option("--role <role>","Semantic role (button, link, textbox, option, etc.)").option("--name <text>","Accessible name contains text (aria-label, label, title, placeholder, or visible text)").option("--label <text>","Associated label contains text").option("--text <text>","Visible text contains text").option("--testid <id>","data-testid / data-test / test-id contains id"),ot=(e,t)=>e.option(`--${t}-role <role>`,`${t} semantic role`).option(`--${t}-name <text>`,`${t} accessible name contains text`).option(`--${t}-label <text>`,`${t} associated label contains text`).option(`--${t}-text <text>`,`${t} visible text contains text`).option(`--${t}-testid <id>`,`${t} data-testid / data-test / test-id contains id`),xe=(e)=>{const t={};for(const o of["role","name","label","text","testid"]){const r=e[o];if(typeof r==="string"&&r.trim())t[o]=r.trim()}return Object.keys(t).length>0?t:null},rt=(e,t)=>{const o={},r={role:`${t}Role`,name:`${t}Name`,label:`${t}Label`,text:`${t}Text`,testid:`${t}Testid`};for(const n of["role","name","label","text","testid"]){const s=e[r[n]];if(typeof s==="string"&&s.trim())o[n]=s.trim()}return Object.keys(o).length>0?o:null},nt=async(e,t,o)=>{const r=await e.evaluate(Et({...t,limit:6}));if(Ct(r))return r;if(o==="write"&&r.matches_n!==1)return{error:{code:"semantic_ambiguous",message:`Semantic locator matched ${r.matches_n} elements; write actions require a unique target.`,hint:"Add --name/--label/--text/--testid or use browser find with a narrower locator.",matches_n:r.matches_n,entries:r.entries}};const n=r.entries[0];if(!n)return{error:{code:"semantic_not_found",message:"Semantic locator matched 0 elements",hint:"Try browser state, --source ax, or relax the semantic locator."}};const s=String(n.ref);if(o==="read")return{target:s,...r.matches_n>1?{total_matches:r.matches_n}:{}};return s},qt=async(e,t,o)=>{const r=xe(t);if(!r)return null;return nt(e,r,o)},Je=async(e,t,o,r)=>{const n=typeof t==="string"&&t.trim()?t.trim():"",s=!!xe(o);if(n&&s)return{error:{code:"usage_error",message:"Pass either <target> or semantic locator flags, not both."}};if(n)return n;const l=await qt(e,o,r);if(l)return l;return{error:{code:"usage_error",message:"Missing target. Pass a numeric ref/CSS selector, or semantic flags like --role button --name Submit."}}},le=(e)=>{console.log(JSON.stringify(e,null,2));process.exitCode=f.USAGE_ERROR},de=async(e,t,o)=>{const r=await Je(e,t,o,"write");if(typeof r==="string")return r;if("error"in r)le(r);return null},je=async(e,t,o,r,n)=>{const s=!!xe(r);if(s&&o!==void 0){le({error:{code:"usage_error",message:`When using semantic locator flags, pass only <${n}> as the positional argument.`}});return null}const l=s?t:o;if(l===void 0){le({error:{code:"usage_error",message:`Missing ${n}.`,hint:s?`With semantic locator flags, pass the ${n} as the only positional argument.`:`Pass both a target and ${n}.`}});return null}const d=await de(e,s?void 0:t,r);if(!d)return null;return{target:d,value:String(l)}},st=async(e,t,o,r,n)=>{const s=typeof t==="string"&&t.trim()?t.trim():"",l=rt(o,r);if(s&&l){le({error:{code:"usage_error",message:`Pass either <${n}> or --${r}-* semantic locator flags, not both.`}});return null}if(s)return s;if(l){const d=await nt(e,l,"write");if(typeof d==="string")return d;if("error"in d)le(d);return null}le({error:{code:"usage_error",message:`Missing ${n}. Pass a numeric ref/CSS selector, or --${r}-role/--${r}-name semantic flags.`}});return null};_(L(g.command("find")).option("--css <selector>","CSS selector; combine with --text to keep only matches whose text / aria-label / title / placeholder / value contains it").option("--visible","Keep only visible elements",!1).option("--limit <n>","Max entries returned","50").option("--text-max <n>","Max chars of trimmed text per entry","120").description("Find DOM elements by CSS or semantic locator — returns JSON {matches_n, visible_n, filtered_n?, entries[]}; visible entries are listed first")).action(x(async(e,t)=>{let o=xe(t),r;if(t.css&&o&&Object.keys(o).length===1&&typeof o.text==="string"){r=o.text;o=null}const n=t.visible===!0;if((!t.css||typeof t.css!=="string")&&!o){console.log(JSON.stringify({error:{code:"usage_error",message:"--css <selector> or a semantic locator flag is required",hint:'Examples: ppcli browser find --css ".btn.primary"; ppcli browser find --css button --visible --text 发布; ppcli browser find --role button --name Save'}},null,2));process.exitCode=f.USAGE_ERROR;return}if(t.css&&o){console.log(JSON.stringify({error:{code:"usage_error",message:"Pass either --css or semantic locator flags (--role/--name/--label/--testid), not both.",hint:"Only --text and --visible combine with --css."}},null,2));process.exitCode=f.USAGE_ERROR;return}const s=N(t.limit);if(s&&typeof s==="object"&&"error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error.replace("--nth","--limit")}},null,2));process.exitCode=f.USAGE_ERROR;return}const l=N(t.textMax);if(l&&typeof l==="object"&&"error"in l){console.log(JSON.stringify({error:{code:"usage_error",message:l.error.replace("--nth","--text-max")}},null,2));process.exitCode=f.USAGE_ERROR;return}const d=await e.evaluate(o?Et({...o,limit:s??void 0,textMax:l??void 0,visibleOnly:n,visibleFirst:!0}):Po(t.css,{limit:s??void 0,textMax:l??void 0,visibleOnly:n,visibleFirst:!0,textFilter:r}));if(Ct(d)){console.log(JSON.stringify(d,null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify(d,null,2))}));const ue=g.command("get").description("Get page properties");_(ue.command("title").description("Page title")).action(x(async(e)=>{console.log(await e.evaluate("document.title"))}));_(ue.command("url").description("Current page URL")).action(x(async(e)=>{console.log(await e.getCurrentUrl?.()??await e.evaluate("location.href"))}));const Me=async(e,t,o,r,n)=>{const s=await Je(e,t,o,"read");if(typeof s!=="string"&&"error"in s){console.log(JSON.stringify(s,null,2));process.exitCode=f.USAGE_ERROR;return}const l=typeof s==="string"?s:s.target,d=typeof s==="string"?void 0:s.total_matches,u=N(o.nth);if(u&&typeof u==="object"&&"error"in u){console.log(JSON.stringify({error:{code:"usage_error",message:u.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:p,match_level:h}=await R(e,l,{firstOnMulti:u===null,...typeof u==="number"?{nth:u}:{}}),S=await e.evaluate(r);let C;if(n==="attributes")try{C=S==null?{}:JSON.parse(String(S))}catch{C=S}else C=S??null;console.log(JSON.stringify({value:C,matches_n:p,match_level:h,...d&&d>1?{total_matches:d}:{}},null,2))};_(L(ue.command("text")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Element text content — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Me(e,t,o??{},Oo(),"text")));_(L(ue.command("value")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Input/textarea value — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Me(e,t,o??{},$o(),"value")));_(ue.command("html").option("--selector <css>","CSS selector scope (first match)").option("--as <format>",'Output format: "html" (default) or "json" for structured tree',"html").option("--max <n>","Max characters of raw HTML to return (0 = unlimited)","0").option("--depth <n>","(--as json) Max tree depth below root (0 = root only, 0 disables = unlimited via empty)","").option("--children-max <n>","(--as json) Max element children kept per node (empty = unlimited)","").option("--text-max <n>","(--as json) Max chars of direct text kept per node (empty = unlimited)","").description("Page HTML (or scoped); use --as json for a {tag, attrs, text, children} tree")).action(x(async(e,t)=>{const o=String(t.as||"html").toLowerCase();if(o!=="html"&&o!=="json"){console.log(JSON.stringify({error:{code:"invalid_format",message:`--as must be "html" or "json", got "${t.as}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const r=String(t.max??"0");if(!/^\d+$/.test(r)){console.log(JSON.stringify({error:{code:"invalid_max",message:`--max must be a non-negative integer, got "${t.max}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=Number.parseInt(r,10);if(o==="json"){const u=(E,M)=>{const J=M===void 0||M===null?"":String(M);if(J==="")return null;if(!/^\d+$/.test(J))return{error:`${E} must be a non-negative integer, got "${J}"`};return Number.parseInt(J,10)},p=u("--depth",t.depth),h=u("--children-max",t.childrenMax),S=u("--text-max",t.textMax);for(const E of[p,h,S])if(E&&typeof E==="object"&&"error"in E){console.log(JSON.stringify({error:{code:"invalid_budget",message:E.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const C=Do({selector:t.selector??null,depth:p,childrenMax:h,textMax:S}),P=await e.evaluate(C);if(P&&typeof P==="object"&&"invalidSelector"in P&&P.invalidSelector){console.log(JSON.stringify({error:{code:"invalid_selector",message:`Selector "${t.selector}" is not a valid CSS selector: ${P.reason}`}},null,2));process.exitCode=f.USAGE_ERROR;return}const D=P;if(!D||D.matched===0){console.log(JSON.stringify({error:{code:"selector_not_found",message:t.selector?`Selector "${t.selector}" matched 0 elements.`:"Page has no documentElement."}},null,2));process.exitCode=f.USAGE_ERROR;return}console.log(JSON.stringify(D,null,2));return}const s=t.selector?JSON.stringify(t.selector):"null",l=await e.evaluate(`(() => {
|
|
87
|
-
const s = ${
|
|
94
|
+
})()`,s=await e.evaluate(i),d=(await e.getCookies({url:s.finalUrl||t}).catch(()=>[])).map((R)=>R.name).filter(Boolean),u=[...new Set([...s.cookieNames,...d])],m={requestedUrl:t,finalUrl:s.finalUrl,cookieNames:u,networkEntries:n,initialState:s.initialState,title:s.title},g=Vo(m,Ee()),b=resolveSitemapAvailabilityForUrl(s.finalUrl||t);console.log(JSON.stringify({...g,...b?{sitemap:b}:{}},null,2))}));const z=(e)=>e.option("--role <role>","Semantic role (button, link, textbox, option, etc.)").option("--name <text>","Accessible name contains text (aria-label, label, title, placeholder, or visible text)").option("--label <text>","Associated label contains text").option("--text <text>","Visible text contains text").option("--testid <id>","data-testid / data-test / test-id contains id"),at=(e,t)=>e.option(`--${t}-role <role>`,`${t} semantic role`).option(`--${t}-name <text>`,`${t} accessible name contains text`).option(`--${t}-label <text>`,`${t} associated label contains text`).option(`--${t}-text <text>`,`${t} visible text contains text`).option(`--${t}-testid <id>`,`${t} data-testid / data-test / test-id contains id`),ve=(e)=>{const t={};for(const o of["role","name","label","text","testid"]){const r=e[o];if(typeof r==="string"&&r.trim())t[o]=r.trim()}return Object.keys(t).length>0?t:null},ct=(e,t)=>{const o={},r={role:`${t}Role`,name:`${t}Name`,label:`${t}Label`,text:`${t}Text`,testid:`${t}Testid`};for(const n of["role","name","label","text","testid"]){const i=e[r[n]];if(typeof i==="string"&&i.trim())o[n]=i.trim()}return Object.keys(o).length>0?o:null},lt=async(e,t,o)=>{const r=await e.evaluate(Nt({...t,limit:6}));if(kt(r))return r;if(o==="write"&&r.matches_n!==1)return{error:{code:"semantic_ambiguous",message:`Semantic locator matched ${r.matches_n} elements; write actions require a unique target.`,hint:"Add --name/--label/--text/--testid or use browser find with a narrower locator.",matches_n:r.matches_n,entries:r.entries}};const n=r.entries[0];if(!n)return{error:{code:"semantic_not_found",message:"Semantic locator matched 0 elements",hint:"Try browser state, --source ax, or relax the semantic locator."}};const i=String(n.ref);if(o==="read")return{target:i,...r.matches_n>1?{total_matches:r.matches_n}:{}};return i},eo=async(e,t,o)=>{const r=ve(t);if(!r)return null;return lt(e,r,o)},Ge=async(e,t,o,r)=>{const n=typeof t==="string"&&t.trim()?t.trim():"",i=!!ve(o);if(n&&i)return{error:{code:"usage_error",message:"Pass either <target> or semantic locator flags, not both."}};if(n)return n;const s=await eo(e,o,r);if(s)return s;return{error:{code:"usage_error",message:"Missing target. Pass a numeric ref/CSS selector, or semantic flags like --role button --name Submit."}}},de=(e)=>{console.log(JSON.stringify(e,null,2));process.exitCode=f.USAGE_ERROR},ue=async(e,t,o)=>{const r=await Ge(e,t,o,"write");if(typeof r==="string")return r;if("error"in r)de(r);return null},Fe=async(e,t,o,r,n)=>{const i=!!ve(r);if(i&&o!==void 0){de({error:{code:"usage_error",message:`When using semantic locator flags, pass only <${n}> as the positional argument.`}});return null}const s=i?t:o;if(s===void 0){de({error:{code:"usage_error",message:`Missing ${n}.`,hint:i?`With semantic locator flags, pass the ${n} as the only positional argument.`:`Pass both a target and ${n}.`}});return null}const d=await ue(e,i?void 0:t,r);if(!d)return null;return{target:d,value:String(s)}},dt=async(e,t,o,r,n)=>{const i=typeof t==="string"&&t.trim()?t.trim():"",s=ct(o,r);if(i&&s){de({error:{code:"usage_error",message:`Pass either <${n}> or --${r}-* semantic locator flags, not both.`}});return null}if(i)return i;if(s){const d=await lt(e,s,"write");if(typeof d==="string")return d;if("error"in d)de(d);return null}de({error:{code:"usage_error",message:`Missing ${n}. Pass a numeric ref/CSS selector, or --${r}-role/--${r}-name semantic flags.`}});return null};C(z(h.command("find")).option("--css <selector>","CSS selector; combine with --text to keep only matches whose text / aria-label / title / placeholder / value contains it").option("--visible","Keep only visible elements",!1).option("--limit <n>","Max entries returned","50").option("--text-max <n>","Max chars of trimmed text per entry","120").description("Find DOM elements by CSS or semantic locator — returns JSON {matches_n, visible_n, filtered_n?, entries[]}; visible entries are listed first")).action(x(async(e,t)=>{let o=ve(t),r;if(t.css&&o&&Object.keys(o).length===1&&typeof o.text==="string"){r=o.text;o=null}const n=t.visible===!0;if((!t.css||typeof t.css!=="string")&&!o){console.log(JSON.stringify({error:{code:"usage_error",message:"--css <selector> or a semantic locator flag is required",hint:'Examples: ppcli browser find --css ".btn.primary"; ppcli browser find --css button --visible --text 发布; ppcli browser find --role button --name Save'}},null,2));process.exitCode=f.USAGE_ERROR;return}if(t.css&&o){console.log(JSON.stringify({error:{code:"usage_error",message:"Pass either --css or semantic locator flags (--role/--name/--label/--testid), not both.",hint:"Only --text and --visible combine with --css."}},null,2));process.exitCode=f.USAGE_ERROR;return}const i=N(t.limit);if(i&&typeof i==="object"&&"error"in i){console.log(JSON.stringify({error:{code:"usage_error",message:i.error.replace("--nth","--limit")}},null,2));process.exitCode=f.USAGE_ERROR;return}const s=N(t.textMax);if(s&&typeof s==="object"&&"error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error.replace("--nth","--text-max")}},null,2));process.exitCode=f.USAGE_ERROR;return}const d=await e.evaluate(o?Nt({...o,limit:i??void 0,textMax:s??void 0,visibleOnly:n,visibleFirst:!0}):Uo(t.css,{limit:i??void 0,textMax:s??void 0,visibleOnly:n,visibleFirst:!0,textFilter:r}));if(kt(d)){console.log(JSON.stringify(d,null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify(d,null,2))}));const me=h.command("get").description("Get page properties");C(me.command("title").description("Page title")).action(x(async(e)=>{console.log(await e.evaluate("document.title"))}));C(me.command("url").description("Current page URL")).action(x(async(e)=>{console.log(await e.getCurrentUrl?.()??await e.evaluate("location.href"))}));const Be=async(e,t,o,r,n)=>{const i=await Ge(e,t,o,"read");if(typeof i!=="string"&&"error"in i){console.log(JSON.stringify(i,null,2));process.exitCode=f.USAGE_ERROR;return}const s=typeof i==="string"?i:i.target,d=typeof i==="string"?void 0:i.total_matches,u=N(o.nth);if(u&&typeof u==="object"&&"error"in u){console.log(JSON.stringify({error:{code:"usage_error",message:u.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:m,match_level:g}=await E(e,s,{firstOnMulti:u===null,...typeof u==="number"?{nth:u}:{}}),b=await e.evaluate(r);let R;if(n==="attributes")try{R=b==null?{}:JSON.parse(String(b))}catch{R=b}else R=b??null;console.log(JSON.stringify({value:R,matches_n:m,match_level:g,...d&&d>1?{total_matches:d}:{}},null,2))};C(z(me.command("text")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Element text content — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Be(e,t,o??{},Po(),"text")));C(z(me.command("value")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Input/textarea value — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Be(e,t,o??{},Io(),"value")));C(me.command("html").option("--selector <css>","CSS selector scope (first match)").option("--as <format>",'Output format: "html" (default) or "json" for structured tree',"html").option("--max <n>","Max characters of raw HTML to return (0 = unlimited)","0").option("--depth <n>","(--as json) Max tree depth below root (0 = root only, 0 disables = unlimited via empty)","").option("--children-max <n>","(--as json) Max element children kept per node (empty = unlimited)","").option("--text-max <n>","(--as json) Max chars of direct text kept per node (empty = unlimited)","").description("Page HTML (or scoped); use --as json for a {tag, attrs, text, children} tree")).action(x(async(e,t)=>{const o=String(t.as||"html").toLowerCase();if(o!=="html"&&o!=="json"){console.log(JSON.stringify({error:{code:"invalid_format",message:`--as must be "html" or "json", got "${t.as}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const r=String(t.max??"0");if(!/^\d+$/.test(r)){console.log(JSON.stringify({error:{code:"invalid_max",message:`--max must be a non-negative integer, got "${t.max}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=Number.parseInt(r,10);if(o==="json"){const u=(_,M)=>{const J=M===void 0||M===null?"":String(M);if(J==="")return null;if(!/^\d+$/.test(J))return{error:`${_} must be a non-negative integer, got "${J}"`};return Number.parseInt(J,10)},m=u("--depth",t.depth),g=u("--children-max",t.childrenMax),b=u("--text-max",t.textMax);for(const _ of[m,g,b])if(_&&typeof _==="object"&&"error"in _){console.log(JSON.stringify({error:{code:"invalid_budget",message:_.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const R=Wo({selector:t.selector??null,depth:m,childrenMax:g,textMax:b}),P=await e.evaluate(R);if(P&&typeof P==="object"&&"invalidSelector"in P&&P.invalidSelector){console.log(JSON.stringify({error:{code:"invalid_selector",message:`Selector "${t.selector}" is not a valid CSS selector: ${P.reason}`}},null,2));process.exitCode=f.USAGE_ERROR;return}const G=P;if(!G||G.matched===0){console.log(JSON.stringify({error:{code:"selector_not_found",message:t.selector?`Selector "${t.selector}" matched 0 elements.`:"Page has no documentElement."}},null,2));process.exitCode=f.USAGE_ERROR;return}console.log(JSON.stringify(G,null,2));return}const i=t.selector?JSON.stringify(t.selector):"null",s=await e.evaluate(`(() => {
|
|
95
|
+
const s = ${i};
|
|
88
96
|
if (s) {
|
|
89
97
|
try {
|
|
90
98
|
const el = document.querySelector(s);
|
|
@@ -94,8 +102,8 @@ Examples:
|
|
|
94
102
|
}
|
|
95
103
|
}
|
|
96
104
|
return { kind: 'ok', html: document.documentElement ? document.documentElement.outerHTML : null };
|
|
97
|
-
})()`);if(
|
|
98
|
-
${d.slice(0,n)}`);return}console.log(d)}));_(L(ue.command("attributes")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Element attributes — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Me(e,t,o??{},No(),"attributes")));function Q(e){const t=N(e);if(t&&typeof t==="object"&&"error"in t)return t;if(typeof t==="number")return{opts:{nth:t}};return{opts:{}}}function Kt(e){const t=Array.isArray(e)?e:[];if(t.length===0)return{error:{code:"usage_error",message:"At least one file path is required.",hint:'Example: ppcli browser upload "input[type=file]" ./receipt.pdf'}};const o=[];for(const r of t){const n=String(r),s=n==="~"||n.startsWith(`~${k.sep}`)?k.join(fe.homedir(),n.slice(2)):n,l=k.resolve(s);if(!A.existsSync(l))return{error:{code:"file_not_found",message:`File not found: ${l}`}};if(!A.statSync(l).isFile())return{error:{code:"not_a_file",message:`Not a regular file: ${l}`}};o.push(l)}return{files:o}}function Ue(e,t){const o=N(e);if(o&&typeof o==="object"&&"error"in o)return{error:o.error.replace("--nth",t)};if(typeof o==="number")return{opts:{nth:o}};return{opts:{}}}_(L(g.command("click")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Click element — JSON envelope {clicked, target, matches_n}")).action(x(async(e,t,o)=>{const r=await Je(e,t,o??{},"write");if(typeof r!=="string"){console.log(JSON.stringify(r,null,2));process.exitCode=f.USAGE_ERROR;return}const n=Q(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:s,match_level:l,click_method:d,hit:u,retargeted:p}=await e.click(r,n.opts);console.log(JSON.stringify({clicked:!0,target:r,matches_n:s,match_level:l,...d&&{click_method:d},...u&&{hit:u},...p&&{retargeted:p}},null,2))}));_(L(g.command("type")).argument("[targetOrText]","Numeric ref/CSS target, or text when using --role/--name/etc.").argument("[text]","Text to type").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Click element, then type text — JSON envelope {typed, text, target, matches_n, autocomplete}")).action(x(async(e,t,o,r)=>{const n=await je(e,t,o,r??{},"text");if(!n)return;const s=Q(r?.nth);if("error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error}},null,2));process.exitCode=f.USAGE_ERROR;return}await e.click(n.target,s.opts);await e.wait(0.3);const{matches_n:l,match_level:d}=await e.typeText(n.target,n.value,s.opts),u=await e.evaluate(Ao());if(u)await e.wait(0.4);console.log(JSON.stringify({typed:!0,text:n.value,target:n.target,matches_n:l,match_level:d,autocomplete:!!u},null,2))}));_(L(g.command("hover")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Move the mouse over an element — JSON envelope {hovered, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.hover!=="function")throw Error("browser hover is not supported by this browser backend");const r=await de(e,t,o??{});if(!r)return;const n=Q(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:s,match_level:l}=await e.hover(r,n.opts);console.log(JSON.stringify({hovered:!0,target:r,matches_n:s,match_level:l},null,2))}));_(L(g.command("focus")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Focus an element — JSON envelope {focused, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.focus!=="function")throw Error("browser focus is not supported by this browser backend");const r=await de(e,t,o??{});if(!r)return;const n=Q(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{focused:s,matches_n:l,match_level:d}=await e.focus(r,n.opts);console.log(JSON.stringify({focused:s,target:r,matches_n:l,match_level:d},null,2))}));_(L(g.command("dblclick")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Double-click element — JSON envelope {dblclicked, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.dblClick!=="function")throw Error("browser dblclick is not supported by this browser backend");const r=await de(e,t,o??{});if(!r)return;const n=Q(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:s,match_level:l}=await e.dblClick(r,n.opts);console.log(JSON.stringify({dblclicked:!0,target:r,matches_n:s,match_level:l},null,2))}));const it=async(e,t,o,r)=>{if(typeof e.setChecked!=="function")throw Error(`browser ${r?"check":"uncheck"} is not supported by this browser backend`);const n=await de(e,t,o);if(!n)return;const s=Q(o?.nth);if("error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const l=await e.setChecked(n,r,s.opts);console.log(JSON.stringify({checked:l.checked,changed:l.changed,target:n,matches_n:l.matches_n,match_level:l.match_level,...l.kind?{kind:l.kind}:{}},null,2))};_(L(g.command("check")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Ensure a checkbox/radio/aria-checked control is checked — JSON envelope {checked, changed, target, matches_n}")).action(x(async(e,t,o)=>{await it(e,t,o??{},!0)}));_(L(g.command("uncheck")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Ensure a checkbox/aria-checked control is unchecked — JSON envelope {checked, changed, target, matches_n}")).action(x(async(e,t,o)=>{await it(e,t,o??{},!1)}));_(L(g.command("upload")).argument("[targetOrFile]","Numeric ref/CSS target, or first file when using --role/--name/etc.").argument("[files...]","Local file path(s) to attach").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Attach local files to a file input — JSON envelope {uploaded, files, file_names, target, matches_n}")).action(x(async(e,t,o,r)=>{if(typeof e.uploadFiles!=="function")throw Error("browser upload is not supported by this browser backend");const n=!!xe(r??{}),l=await de(e,n?void 0:t,r??{});if(!l)return;const d=Q(r?.nth);if("error"in d){console.log(JSON.stringify({error:{code:"usage_error",message:d.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const u=n?[t,...Array.isArray(o)?o:[]].filter((S)=>S!==void 0):o,p=Kt(u);if("error"in p){console.log(JSON.stringify({error:p.error},null,2));process.exitCode=f.USAGE_ERROR;return}const h=await e.uploadFiles(l,p.files,d.opts);console.log(JSON.stringify(h,null,2))}));_(ot(ot(g.command("drag"),"from"),"to").argument("[source]","Numeric ref/CSS selector to drag from, or omit with --from-role/--from-name/etc.").argument("[target]","Numeric ref/CSS selector to drop onto, or omit with --to-role/--to-name/etc. or --dx/--dy").option("--from-nth <n>","When <source> is a multi-match CSS selector, pick the nth match (0-based)").option("--to-nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").option("--dx <px>","Drag by this many CSS pixels horizontally from the source centre instead of onto a target (negative = left)").option("--dy <px>","Drag by this many CSS pixels vertically from the source centre instead of onto a target (negative = up)").option("--steps <n>","Pointer-move samples between press and release (default: 2 for element drops, ~1 per 12px for --dx/--dy)").description("Drag one element onto another, or by a pixel offset with --dx/--dy (sliders) — JSON envelope {dragged, source, target | dx, dy, from, to}")).action(x(async(e,t,o,r)=>{if(typeof e.drag!=="function")throw Error("browser drag is not supported by this browser backend");const n=(E,M)=>{console.log(JSON.stringify({error:{code:"usage_error",message:E,...M?{hint:M}:{}}},null,2));process.exitCode=f.USAGE_ERROR},s=(E,M)=>{if(E===void 0||E===null||E==="")return null;const J=Number(String(E).trim().replace(/px$/i,""));if(!Number.isFinite(J))return{error:`${M} must be a number of CSS pixels, got "${String(E)}"`};return J},l=s(r?.dx,"--dx"),d=s(r?.dy,"--dy");for(const E of[l,d])if(E&&typeof E==="object")return n(E.error);let u;if(r?.steps!==void 0){u=Number(r.steps);if(!Number.isInteger(u)||u<1||u>200)return n(`--steps must be an integer between 1 and 200, got "${String(r.steps)}"`)}const p=l!==null||d!==null;if(p){if(typeof o==="string"&&o.length>0||rt(r??{},"to")!==null||r?.toNth!==void 0)return n("Pass either a drop target or --dx/--dy, not both.","Element drop: browser drag <source> <target>. Pixel drag: browser drag <source> --dx 180.");if((l??0)===0&&(d??0)===0)return n("--dx/--dy are both 0 — nothing to drag.");if(typeof e.dragBy!=="function")throw Error("browser drag --dx/--dy is not supported by this browser backend")}const h=await st(e,t,r??{},"from","source");if(!h)return;if(p){const E=Ue(r?.fromNth,"--from-nth");if("error"in E)return n(E.error);const M=await e.dragBy(h,{dx:l??0,dy:d??0},{from:E.opts,...u!==void 0?{steps:u}:{}});console.log(JSON.stringify(M,null,2));return}const S=await st(e,o,r??{},"to","target");if(!S)return;const C=Ue(r?.fromNth,"--from-nth");if("error"in C){console.log(JSON.stringify({error:{code:"usage_error",message:C.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const P=Ue(r?.toNth,"--to-nth");if("error"in P){console.log(JSON.stringify({error:{code:"usage_error",message:P.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const D=await e.drag(h,S,{from:C.opts,to:P.opts,...u!==void 0?{steps:u}:{}});console.log(JSON.stringify(D,null,2))}));_(L(g.command("fill")).argument("[targetOrText]","Numeric ref/CSS target, or text when using --role/--name/etc.").argument("[text]","Text to set exactly").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Set input/textarea/contenteditable text exactly and verify the value — JSON envelope {filled, verified, text, actual}")).action(x(async(e,t,o,r)=>{const n=await je(e,t,o,r??{},"text");if(!n)return;const s=Q(r?.nth);if("error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const l=await e.fillText(n.target,n.value,s.opts);if(!l.verified)process.exitCode=f.GENERIC_ERROR;console.log(JSON.stringify({filled:l.filled,verified:l.verified,target:n.target,text:n.value,actual:l.actual,length:l.length,matches_n:l.matches_n,match_level:l.match_level,...l.mode?{mode:l.mode}:{}},null,2))}));_(L(g.command("select")).argument("[targetOrOption]","Numeric ref/CSS target, or option text when using --role/--name/etc.").argument("[option]","Option text (or value) to select").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Select dropdown option — JSON envelope {selected, target, matches_n}")).action(x(async(e,t,o,r)=>{const n=await je(e,t,o,r??{},"option");if(!n)return;const s=Q(r?.nth);if("error"in s){console.log(JSON.stringify({error:{code:"usage_error",message:s.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:l,match_level:d}=await R(e,n.target,s.opts),u=await e.evaluate(ko(n.value));if(u?.error){console.log(JSON.stringify({error:{code:u.error==="Not a <select>"?"not_a_select":"option_not_found",message:u.error,...u.available&&{available:u.available},matches_n:l}},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify({selected:u?.selected??n.value,target:n.target,matches_n:l,match_level:d},null,2))}));_(g.command("keys").argument("<key>","Key to press (Enter, Escape, Tab, Control+a)")).description("Press keyboard key").action(x(async(e,t)=>{await e.pressKey(t);console.log(`Pressed: ${t}`)}));const at=g.command("dialog").description("Handle a blocking JavaScript alert/confirm/prompt dialog");_(at.command("accept").option("--text <text>","Prompt text to submit for prompt() dialogs").description("Accept the currently open JavaScript dialog")).action(x(async(e,t)=>{if(!e.handleJavaScriptDialog)throw Error("This browser session does not support JavaScript dialog handling");try{await e.handleJavaScriptDialog(!0,t?.text)}catch(o){if(G(o).toLowerCase().includes("no dialog")){console.log(JSON.stringify({error:{code:"no_javascript_dialog",message:"No JavaScript dialog is currently open."}},null,2));process.exitCode=f.USAGE_ERROR;return}throw o}console.log(JSON.stringify({handled:!0,action:"accept",...t?.text!==void 0&&{text:t.text}},null,2))}));_(at.command("dismiss").description("Dismiss the currently open JavaScript dialog")).action(x(async(e)=>{if(!e.handleJavaScriptDialog)throw Error("This browser session does not support JavaScript dialog handling");try{await e.handleJavaScriptDialog(!1)}catch(t){if(G(t).toLowerCase().includes("no dialog")){console.log(JSON.stringify({error:{code:"no_javascript_dialog",message:"No JavaScript dialog is currently open."}},null,2));process.exitCode=f.USAGE_ERROR;return}throw t}console.log(JSON.stringify({handled:!0,action:"dismiss"},null,2))}));_(g.command("wait")).argument("<type>","selector, text, time, xhr, or download").argument("[value]","CSS selector, text string, seconds, XHR URL regex, or download filename/URL pattern").option("--timeout <ms>","Timeout in milliseconds","10000").description('Wait for selector, text, time, matching XHR, or browser download (e.g. wait selector ".loaded", wait text "Success", wait time 3, wait xhr "/api/search", wait download receipt.pdf)').action(x(async(e,t,o,r)=>{const n=parseInt(r.timeout,10);if(t==="time"){const s=parseFloat(o??"2");await e.wait(s);console.log(`Waited ${s}s`)}else if(t==="selector"){if(!o){console.error("Missing CSS selector");process.exitCode=f.USAGE_ERROR;return}await e.wait({selector:o,timeout:n/1000});console.log(`Element "${o}" appeared`)}else if(t==="text"){if(!o){console.error("Missing text");process.exitCode=f.USAGE_ERROR;return}await e.wait({text:o,timeout:n/1000});console.log(`Text "${o}" appeared`)}else if(t==="xhr"){if(!o){console.error("Missing XHR URL regex");process.exitCode=f.USAGE_ERROR;return}let s;try{s=new RegExp(o)}catch(h){console.error(`Invalid regex "${o}": ${h instanceof Error?h.message:String(h)}`);process.exitCode=f.USAGE_ERROR;return}if(!(await e.startNetworkCapture?.()??!1))try{await e.evaluate(Ne)}catch{}await we(e);const d=Date.now()+n,u=400;let p=null;while(Date.now()<d&&!p){p=(await we(e)).find((S)=>s.test(S.url))??null;if(!p)await new Promise((S)=>setTimeout(S,u))}if(!p){console.log(JSON.stringify({error:{code:"xhr_not_seen",message:`No captured XHR matched /${o}/ within ${n}ms`,hint:"Check the pattern against `browser network` output; the endpoint may not have fired yet, or capture is disabled."}},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify({matched:{url:p.url,status:p.status,contentType:p.ct}},null,2))}else if(t==="download"){if(typeof e.waitForDownload!=="function"){console.log(JSON.stringify({error:{code:"download_wait_unavailable",message:"The active browser backend does not support download lifecycle waits.",hint:"Use the Browser Bridge extension version 1.0.8 or newer, then retry the command."}},null,2));process.exitCode=f.GENERIC_ERROR;return}const s=await e.waitForDownload(String(o??""),n);if(!s.downloaded){const l=s.state==="interrupted"&&s.id!==void 0?"download_failed":"download_not_seen";console.log(JSON.stringify({error:{code:l,message:s.error??`No download matched "${o??"*"}" within ${n}ms`,hint:"Check the pattern against the expected filename or URL; use a longer --timeout if the download starts slowly."},download:s},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify(s,null,2))}else{console.error(`Unknown wait type "${t}". Use: selector, text, time, xhr, or download`);process.exitCode=f.USAGE_ERROR}}));_(g.command("eval").argument("<js>","JavaScript code").option("--frame <index>",'Cross-origin iframe index from "browser frames"').description("Execute JS in page context, return result (top-level await is supported; the trailing expression is the result)")).action(x(async(e,t,o)=>{const r=To(t);let n;if(o.frame!==void 0){const s=Number.parseInt(o.frame,10);if(!Number.isInteger(s)||s<0){console.error(`Invalid frame index "${o.frame}". Use a 0-based index from "browser frames".`);process.exitCode=f.USAGE_ERROR;return}if(!e.evaluateInFrame)throw Error("This browser session does not support frame-targeted evaluation");n=await e.evaluateInFrame(r,s)}else n=await e.evaluate(r);if(typeof n==="string")console.log(n);else console.log(JSON.stringify(n,null,2))}));_(g.command("extract").option("--selector <css>","CSS selector scope; defaults to <main>/<article>/<body>").option("--chunk-size <chars>","Target chunk size in chars","20000").option("--start <char>","Start offset (use next_start_char from a previous extract)","0").description("Extract page content as markdown, paragraph-aware chunks for long pages")).action(x(async(e,t)=>{const o=String(t.chunkSize??"20000");if(!/^\d+$/.test(o)||Number.parseInt(o,10)<=0){console.log(JSON.stringify({error:{code:"invalid_chunk_size",message:`--chunk-size must be a positive integer, got "${t.chunkSize}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const r=String(t.start??"0");if(!/^\d+$/.test(r)){console.log(JSON.stringify({error:{code:"invalid_start",message:`--start must be a non-negative integer, got "${t.start}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=Number.parseInt(o,10),s=Number.parseInt(r,10),l=typeof t.selector==="string"&&t.selector.length>0?t.selector:null,d=Go(l),u=await e.evaluate(d);if(!u){console.log(JSON.stringify({error:{code:"extract_failed",message:"Page returned no root element."}},null,2));process.exitCode=f.USAGE_ERROR;return}if("invalidSelector"in u){console.log(JSON.stringify({error:{code:"invalid_selector",message:`Selector "${l}" is not a valid CSS selector: ${u.reason}`}},null,2));process.exitCode=f.USAGE_ERROR;return}if("notFound"in u){console.log(JSON.stringify({error:{code:"selector_not_found",message:l?`Selector "${l}" matched 0 elements.`:"Page has no body/main/article element."}},null,2));process.exitCode=f.USAGE_ERROR;return}const p=Fo({html:u.html,url:u.url,title:u.title,selector:l,start:s,chunkSize:n});console.log(JSON.stringify(p,null,2))}));_(g.command("network")).option("--detail <key>","Emit full body for the entry with this key").option("--all","Include static resources (js/css/images/telemetry)").option("--raw","Emit full bodies for every entry (skip shape preview)").option("--filter <fields>","Comma-separated field names; keep only entries whose body shape has ALL names as path segments").option("--since <duration>","Only include entries from the last duration (for example: 30s, 2m)").option("--until <duration>","Only include entries older than the duration from now").option("--follow","Continuously print new matching entries as JSON lines",!1).option("--failed","Only include failed HTTP requests (status 0 or >= 400)",!1).option("--max-body <chars>","With --detail: cap the emitted body at N chars (0 = unlimited, default)","0").option("--ttl <ms>","Cache TTL in ms for --detail lookups",String($t)).description("Capture network requests as shape previews; retrieve full bodies by key").action(x(async(e,t)=>{const o=Ht(t.ttl,"ttl",$t),r=tt(e),n=typeof t.detail==="string"&&t.detail.length>0,s=typeof t.filter==="string",l=ke(t.since,"since"),d=ke(t.until,"until");if(l&&typeof l==="object"){X("invalid_since",l.error);return}if(d&&typeof d==="object"){X("invalid_until",d.error);return}if(n&&s){X("invalid_args","--filter and --detail cannot be used together (one narrows a list, the other fetches a specific entry).");return}let u=null;if(s){const w=Mo(t.filter);if("reason"in w){X("invalid_filter",w.reason);return}u=w.fields}if(n&&t.follow){X("invalid_args","--follow cannot be used with --detail.");return}if(n){const w=Jo(r,{ttlMs:o});if(w.status==="missing"){X("cache_missing",`No cached capture. Run "browser network" first (in session "${r}").`);return}if(w.status==="expired"){X("cache_expired",`Cache is stale (age ${w.ageMs}ms > ttl ${o}ms). Re-run "browser network" to refresh.`);return}if(w.status==="corrupt"||!w.file){X("cache_corrupt",'Cache file is malformed; re-run "browser network" to regenerate.');return}const O=Io(w.file,t.detail);if(!O){X("key_not_found",`Key "${t.detail}" not in cache.`,{available_keys:w.file.entries.map((W)=>W.key)});return}const y=String(t.maxBody??"0");if(!/^\d+$/.test(y)){X("invalid_max_body",`--max-body must be a non-negative integer, got "${t.maxBody}"`);return}const b=Number.parseInt(y,10);let U=O.body,F=!1;if(b>0&&typeof O.body==="string"&&O.body.length>b){U=O.body.slice(0,b);F=!0}const se=O.body_truncated===!0,H={key:O.key,url:O.url,method:O.method,status:O.status,ct:O.ct,size:O.size,...typeof O.timestamp==="number"?{timestamp:he(O.timestamp)}:{},shape:_t(O.body),body:U};if(se||F){H.body_truncated=!0;H.body_full_size=O.body_full_size??O.size;H.body_truncation_reason=se?"capture-limit":"max-body"}console.log(JSON.stringify(H,null,2));return}if(t.follow){if(!await e.startNetworkCapture?.())try{await e.evaluate(Ne)}catch{}while(!0){const w=await we(e).catch((b)=>{X("capture_failed",`Could not read network capture: ${b.message}`);return[]});let O=t.all?w:Jt(w);O=Ze(O,{sinceMs:l,untilMs:d});if(t.failed)O=O.filter((b)=>b.status===0||b.status>=400);const y=Ot(O);for(const b of y){const U=b.channel==="websocket"||b.channel==="eventsource";console.log(JSON.stringify({key:b.key,timestamp:he(b.timestamp),method:b.method,status:b.status,url:b.url,ct:b.ct,size:b.size,...U?{channel:b.channel,direction:b.direction}:{},...b.eventName?{event_name:b.eventName}:{},...U?{body:dr(b.body)}:{},...b.bodyTruncated?{body_truncated:!0}:{}}))}await new Promise((b)=>setTimeout(b,Pt))}}let p;try{p=await we(e)}catch(w){X("capture_failed",`Could not read network capture: ${w.message}`);return}let h=t.all?p:Jt(p);h=Ze(h,{sinceMs:l,untilMs:d});if(t.failed)h=h.filter((w)=>w.status===0||w.status>=400);const S=p.length-h.length,P=Ot(h).map((w)=>({key:w.key,url:w.url,method:w.method,status:w.status,size:w.size,ct:w.ct,body:w.body,...typeof w.timestamp==="number"?{timestamp:w.timestamp}:{},...w.bodyTruncated?{body_truncated:!0}:{},...w.bodyTruncated&&typeof w.bodyFullSize==="number"?{body_full_size:w.bodyFullSize}:{}}));let D=null;try{jo(r,P)}catch(w){D=`Could not persist capture cache: ${w.message}. --detail lookups may miss this capture.`}const E=P.map((w)=>({entry:w,shape:_t(w.body)})),M=u?E.filter((w)=>Uo(w.shape,u)):E,J=u?E.length-M.length:0,z={session:r,captured_at:new Date().toISOString(),count:M.length,filtered_out:S};if(u){z.filter=u;z.filter_dropped=J}if(D)z.cache_warning=D;const re=M.filter((w)=>w.entry.body_truncated).length;if(re>0){z.body_truncated_count=re;z.body_truncated_hint="Some bodies exceeded the capture limit; their `shape` reflects only the captured prefix."}if(t.raw)z.entries=M.map((w)=>({...w.entry,...typeof w.entry.timestamp==="number"?{timestamp:he(w.entry.timestamp)}:{}}));else{z.entries=M.map((w)=>({key:w.entry.key,method:w.entry.method,...typeof w.entry.timestamp==="number"?{timestamp:he(w.entry.timestamp)}:{},status:w.entry.status,url:w.entry.url,ct:w.entry.ct,size:w.entry.size,shape:w.shape,...w.entry.body_truncated?{body_truncated:!0}:{}}));z.detail_hint='Run "browser network --detail <key>" for full body.'}console.log(JSON.stringify(z,null,2))}));g.command("init").argument("<name>","Adapter name in site/command format (e.g. hn/top)").description("Generate adapter scaffold in ~/.ppcli/clis/").action(async(e)=>{try{const t=e.split("/");if(t.length!==2||!t[0]||!t[1]){console.error("Name must be site/command format (e.g. hn/top)");process.exitCode=f.USAGE_ERROR;return}const[o,r]=t;if(!/^[a-zA-Z0-9_-]+$/.test(o)||!/^[a-zA-Z0-9_-]+$/.test(r)){console.error("Name parts must be alphanumeric/dash/underscore only");process.exitCode=f.USAGE_ERROR;return}const n=await import("node:os"),s=await import("node:fs"),l=await import("node:path"),d=l.join(n.homedir(),".ppcli","clis",o),u=l.join(d,`${r}.js`);if(s.existsSync(u)){console.log(`Adapter already exists: ${u}`);return}const h=`import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
105
|
+
})()`);if(s.kind==="invalid_selector"){console.log(JSON.stringify({error:{code:"invalid_selector",message:`Selector "${t.selector}" is not a valid CSS selector: ${s.reason}`}},null,2));process.exitCode=f.USAGE_ERROR;return}const d=s.html;if(d===null){if(t.selector){console.log(JSON.stringify({error:{code:"selector_not_found",message:`Selector "${t.selector}" matched 0 elements.`}},null,2));process.exitCode=f.USAGE_ERROR;return}console.log("(empty)");return}if(n>0&&d.length>n){console.log(`<!-- ppcli: truncated ${n} of ${d.length} chars; re-run without --max (or --max 0) for full -->
|
|
106
|
+
${d.slice(0,n)}`);return}console.log(d)}));C(z(me.command("attributes")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","Pick the nth match (0-based) when <target> is a multi-match CSS selector").description("Element attributes — JSON envelope {value, matches_n}")).action(x(async(e,t,o)=>Be(e,t,o??{},Jo(),"attributes")));function ee(e){const t=N(e);if(t&&typeof t==="object"&&"error"in t)return t;if(typeof t==="number")return{opts:{nth:t}};return{opts:{}}}function to(e){const t=Array.isArray(e)?e:[];if(t.length===0)return{error:{code:"usage_error",message:"At least one file path is required.",hint:'Example: ppcli browser upload "input[type=file]" ./receipt.pdf'}};const o=[];for(const r of t){const n=String(r),i=n==="~"||n.startsWith(`~${k.sep}`)?k.join(ge.homedir(),n.slice(2)):n,s=k.resolve(i);if(!A.existsSync(s))return{error:{code:"file_not_found",message:`File not found: ${s}`}};if(!A.statSync(s).isFile())return{error:{code:"not_a_file",message:`Not a regular file: ${s}`}};o.push(s)}return{files:o}}function Le(e,t){const o=N(e);if(o&&typeof o==="object"&&"error"in o)return{error:o.error.replace("--nth",t)};if(typeof o==="number")return{opts:{nth:o}};return{opts:{}}}C(z(h.command("click")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Click element — JSON envelope {clicked, target, matches_n}")).action(x(async(e,t,o)=>{const r=await Ge(e,t,o??{},"write");if(typeof r!=="string"){console.log(JSON.stringify(r,null,2));process.exitCode=f.USAGE_ERROR;return}const n=ee(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:i,match_level:s,click_method:d,hit:u,retargeted:m}=await e.click(r,n.opts);console.log(JSON.stringify({clicked:!0,target:r,matches_n:i,match_level:s,...d&&{click_method:d},...u&&{hit:u},...m&&{retargeted:m}},null,2))}));C(z(h.command("type")).argument("[targetOrText]","Numeric ref/CSS target, or text when using --role/--name/etc.").argument("[text]","Text to type").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Click element, then type text — JSON envelope {typed, text, target, matches_n, autocomplete}")).action(x(async(e,t,o,r)=>{const n=await Fe(e,t,o,r??{},"text");if(!n)return;const i=ee(r?.nth);if("error"in i){console.log(JSON.stringify({error:{code:"usage_error",message:i.error}},null,2));process.exitCode=f.USAGE_ERROR;return}await e.click(n.target,i.opts);await e.wait(0.3);const{matches_n:s,match_level:d}=await e.typeText(n.target,n.value,i.opts),u=await e.evaluate(Mo());if(u)await e.wait(0.4);console.log(JSON.stringify({typed:!0,text:n.value,target:n.target,matches_n:s,match_level:d,autocomplete:!!u},null,2))}));C(z(h.command("hover")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Move the mouse over an element — JSON envelope {hovered, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.hover!=="function")throw Error("browser hover is not supported by this browser backend");const r=await ue(e,t,o??{});if(!r)return;const n=ee(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:i,match_level:s}=await e.hover(r,n.opts);console.log(JSON.stringify({hovered:!0,target:r,matches_n:i,match_level:s},null,2))}));C(z(h.command("focus")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Focus an element — JSON envelope {focused, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.focus!=="function")throw Error("browser focus is not supported by this browser backend");const r=await ue(e,t,o??{});if(!r)return;const n=ee(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{focused:i,matches_n:s,match_level:d}=await e.focus(r,n.opts);console.log(JSON.stringify({focused:i,target:r,matches_n:s,match_level:d},null,2))}));C(z(h.command("dblclick")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Double-click element — JSON envelope {dblclicked, target, matches_n}")).action(x(async(e,t,o)=>{if(typeof e.dblClick!=="function")throw Error("browser dblclick is not supported by this browser backend");const r=await ue(e,t,o??{});if(!r)return;const n=ee(o?.nth);if("error"in n){console.log(JSON.stringify({error:{code:"usage_error",message:n.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:i,match_level:s}=await e.dblClick(r,n.opts);console.log(JSON.stringify({dblclicked:!0,target:r,matches_n:i,match_level:s},null,2))}));const ut=async(e,t,o,r)=>{if(typeof e.setChecked!=="function")throw Error(`browser ${r?"check":"uncheck"} is not supported by this browser backend`);const n=await ue(e,t,o);if(!n)return;const i=ee(o?.nth);if("error"in i){console.log(JSON.stringify({error:{code:"usage_error",message:i.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const s=await e.setChecked(n,r,i.opts);console.log(JSON.stringify({checked:s.checked,changed:s.changed,target:n,matches_n:s.matches_n,match_level:s.match_level,...s.kind?{kind:s.kind}:{}},null,2))};C(z(h.command("check")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Ensure a checkbox/radio/aria-checked control is checked — JSON envelope {checked, changed, target, matches_n}")).action(x(async(e,t,o)=>{await ut(e,t,o??{},!0)}));C(z(h.command("uncheck")).argument("[target]","Numeric ref (from browser state / find), CSS selector, or omit when using --role/--name/etc.").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Ensure a checkbox/aria-checked control is unchecked — JSON envelope {checked, changed, target, matches_n}")).action(x(async(e,t,o)=>{await ut(e,t,o??{},!1)}));C(z(h.command("upload")).argument("[targetOrFile]","Numeric ref/CSS target, or first file when using --role/--name/etc.").argument("[files...]","Local file path(s) to attach").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Attach local files to a file input — JSON envelope {uploaded, files, file_names, target, matches_n}")).action(x(async(e,t,o,r)=>{if(typeof e.uploadFiles!=="function")throw Error("browser upload is not supported by this browser backend");const n=!!ve(r??{}),s=await ue(e,n?void 0:t,r??{});if(!s)return;const d=ee(r?.nth);if("error"in d){console.log(JSON.stringify({error:{code:"usage_error",message:d.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const u=n?[t,...Array.isArray(o)?o:[]].filter((b)=>b!==void 0):o,m=to(u);if("error"in m){console.log(JSON.stringify({error:m.error},null,2));process.exitCode=f.USAGE_ERROR;return}const g=await e.uploadFiles(s,m.files,d.opts);console.log(JSON.stringify(g,null,2))}));C(at(at(h.command("drag"),"from"),"to").argument("[source]","Numeric ref/CSS selector to drag from, or omit with --from-role/--from-name/etc.").argument("[target]","Numeric ref/CSS selector to drop onto, or omit with --to-role/--to-name/etc. or --dx/--dy").option("--from-nth <n>","When <source> is a multi-match CSS selector, pick the nth match (0-based)").option("--to-nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").option("--dx <px>","Drag by this many CSS pixels horizontally from the source centre instead of onto a target (negative = left)").option("--dy <px>","Drag by this many CSS pixels vertically from the source centre instead of onto a target (negative = up)").option("--steps <n>","Pointer-move samples between press and release (default: 2 for element drops, ~1 per 12px for --dx/--dy)").description("Drag one element onto another, or by a pixel offset with --dx/--dy (sliders) — JSON envelope {dragged, source, target | dx, dy, from, to}")).action(x(async(e,t,o,r)=>{if(typeof e.drag!=="function")throw Error("browser drag is not supported by this browser backend");const n=(_,M)=>{console.log(JSON.stringify({error:{code:"usage_error",message:_,...M?{hint:M}:{}}},null,2));process.exitCode=f.USAGE_ERROR},i=(_,M)=>{if(_===void 0||_===null||_==="")return null;const J=Number(String(_).trim().replace(/px$/i,""));if(!Number.isFinite(J))return{error:`${M} must be a number of CSS pixels, got "${String(_)}"`};return J},s=i(r?.dx,"--dx"),d=i(r?.dy,"--dy");for(const _ of[s,d])if(_&&typeof _==="object")return n(_.error);let u;if(r?.steps!==void 0){u=Number(r.steps);if(!Number.isInteger(u)||u<1||u>200)return n(`--steps must be an integer between 1 and 200, got "${String(r.steps)}"`)}const m=s!==null||d!==null;if(m){if(typeof o==="string"&&o.length>0||ct(r??{},"to")!==null||r?.toNth!==void 0)return n("Pass either a drop target or --dx/--dy, not both.","Element drop: browser drag <source> <target>. Pixel drag: browser drag <source> --dx 180.");if((s??0)===0&&(d??0)===0)return n("--dx/--dy are both 0 — nothing to drag.");if(typeof e.dragBy!=="function")throw Error("browser drag --dx/--dy is not supported by this browser backend")}const g=await dt(e,t,r??{},"from","source");if(!g)return;if(m){const _=Le(r?.fromNth,"--from-nth");if("error"in _)return n(_.error);const M=await e.dragBy(g,{dx:s??0,dy:d??0},{from:_.opts,...u!==void 0?{steps:u}:{}});console.log(JSON.stringify(M,null,2));return}const b=await dt(e,o,r??{},"to","target");if(!b)return;const R=Le(r?.fromNth,"--from-nth");if("error"in R){console.log(JSON.stringify({error:{code:"usage_error",message:R.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const P=Le(r?.toNth,"--to-nth");if("error"in P){console.log(JSON.stringify({error:{code:"usage_error",message:P.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const G=await e.drag(g,b,{from:R.opts,to:P.opts,...u!==void 0?{steps:u}:{}});console.log(JSON.stringify(G,null,2))}));C(z(h.command("fill")).argument("[targetOrText]","Numeric ref/CSS target, or text when using --role/--name/etc.").argument("[text]","Text to set exactly").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Set input/textarea/contenteditable text exactly and verify the value — JSON envelope {filled, verified, text, actual}")).action(x(async(e,t,o,r)=>{const n=await Fe(e,t,o,r??{},"text");if(!n)return;const i=ee(r?.nth);if("error"in i){console.log(JSON.stringify({error:{code:"usage_error",message:i.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const s=await e.fillText(n.target,n.value,i.opts);if(!s.verified)process.exitCode=f.GENERIC_ERROR;console.log(JSON.stringify({filled:s.filled,verified:s.verified,target:n.target,text:n.value,actual:s.actual,length:s.length,matches_n:s.matches_n,match_level:s.match_level,...s.mode?{mode:s.mode}:{}},null,2))}));C(z(h.command("select")).argument("[targetOrOption]","Numeric ref/CSS target, or option text when using --role/--name/etc.").argument("[option]","Option text (or value) to select").option("--nth <n>","When <target> is a multi-match CSS selector, pick the nth match (0-based)").description("Select dropdown option — JSON envelope {selected, target, matches_n}")).action(x(async(e,t,o,r)=>{const n=await Fe(e,t,o,r??{},"option");if(!n)return;const i=ee(r?.nth);if("error"in i){console.log(JSON.stringify({error:{code:"usage_error",message:i.error}},null,2));process.exitCode=f.USAGE_ERROR;return}const{matches_n:s,match_level:d}=await E(e,n.target,i.opts),u=await e.evaluate(jo(n.value));if(u?.error){console.log(JSON.stringify({error:{code:u.error==="Not a <select>"?"not_a_select":"option_not_found",message:u.error,...u.available&&{available:u.available},matches_n:s}},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify({selected:u?.selected??n.value,target:n.target,matches_n:s,match_level:d},null,2))}));C(h.command("keys").argument("<key>","Key to press (Enter, Escape, Tab, Control+a)")).description("Press keyboard key").action(x(async(e,t)=>{await e.pressKey(t);console.log(`Pressed: ${t}`)}));const mt=h.command("dialog").description("Handle a blocking JavaScript alert/confirm/prompt dialog");C(mt.command("accept").option("--text <text>","Prompt text to submit for prompt() dialogs").description("Accept the currently open JavaScript dialog")).action(x(async(e,t)=>{if(!e.handleJavaScriptDialog)throw Error("This browser session does not support JavaScript dialog handling");try{await e.handleJavaScriptDialog(!0,t?.text)}catch(o){if(U(o).toLowerCase().includes("no dialog")){console.log(JSON.stringify({error:{code:"no_javascript_dialog",message:"No JavaScript dialog is currently open."}},null,2));process.exitCode=f.USAGE_ERROR;return}throw o}console.log(JSON.stringify({handled:!0,action:"accept",...t?.text!==void 0&&{text:t.text}},null,2))}));C(mt.command("dismiss").description("Dismiss the currently open JavaScript dialog")).action(x(async(e)=>{if(!e.handleJavaScriptDialog)throw Error("This browser session does not support JavaScript dialog handling");try{await e.handleJavaScriptDialog(!1)}catch(t){if(U(t).toLowerCase().includes("no dialog")){console.log(JSON.stringify({error:{code:"no_javascript_dialog",message:"No JavaScript dialog is currently open."}},null,2));process.exitCode=f.USAGE_ERROR;return}throw t}console.log(JSON.stringify({handled:!0,action:"dismiss"},null,2))}));C(h.command("wait")).argument("<type>","selector, text, time, xhr, or download").argument("[value]","CSS selector, text string, seconds, XHR URL regex, or download filename/URL pattern").option("--timeout <ms>","Timeout in milliseconds","10000").description('Wait for selector, text, time, matching XHR, or browser download (e.g. wait selector ".loaded", wait text "Success", wait time 3, wait xhr "/api/search", wait download receipt.pdf)').action(x(async(e,t,o,r)=>{const n=parseInt(r.timeout,10);if(t==="time"){const i=parseFloat(o??"2");await e.wait(i);console.log(`Waited ${i}s`)}else if(t==="selector"){if(!o){console.error("Missing CSS selector");process.exitCode=f.USAGE_ERROR;return}await e.wait({selector:o,timeout:n/1000});console.log(`Element "${o}" appeared`)}else if(t==="text"){if(!o){console.error("Missing text");process.exitCode=f.USAGE_ERROR;return}await e.wait({text:o,timeout:n/1000});console.log(`Text "${o}" appeared`)}else if(t==="xhr"){if(!o){console.error("Missing XHR URL regex");process.exitCode=f.USAGE_ERROR;return}let i;try{i=new RegExp(o)}catch(g){console.error(`Invalid regex "${o}": ${g instanceof Error?g.message:String(g)}`);process.exitCode=f.USAGE_ERROR;return}if(!(await e.startNetworkCapture?.()??!1))try{await e.evaluate(Ae)}catch{}await ye(e);const d=Date.now()+n,u=400;let m=null;while(Date.now()<d&&!m){m=(await ye(e)).find((b)=>i.test(b.url))??null;if(!m)await new Promise((b)=>setTimeout(b,u))}if(!m){console.log(JSON.stringify({error:{code:"xhr_not_seen",message:`No captured XHR matched /${o}/ within ${n}ms`,hint:"Check the pattern against `browser network` output; the endpoint may not have fired yet, or capture is disabled."}},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify({matched:{url:m.url,status:m.status,contentType:m.ct}},null,2))}else if(t==="download"){if(typeof e.waitForDownload!=="function"){console.log(JSON.stringify({error:{code:"download_wait_unavailable",message:"The active browser backend does not support download lifecycle waits.",hint:"Use the Browser Bridge extension version 1.0.8 or newer, then retry the command."}},null,2));process.exitCode=f.GENERIC_ERROR;return}const i=await e.waitForDownload(String(o??""),n);if(!i.downloaded){const s=i.state==="interrupted"&&i.id!==void 0?"download_failed":"download_not_seen";console.log(JSON.stringify({error:{code:s,message:i.error??`No download matched "${o??"*"}" within ${n}ms`,hint:"Check the pattern against the expected filename or URL; use a longer --timeout if the download starts slowly."},download:i},null,2));process.exitCode=f.GENERIC_ERROR;return}console.log(JSON.stringify(i,null,2))}else{console.error(`Unknown wait type "${t}". Use: selector, text, time, xhr, or download`);process.exitCode=f.USAGE_ERROR}}));C(h.command("eval").argument("<js>","JavaScript code").option("--frame <index>",'Cross-origin iframe index from "browser frames"').description("Execute JS in page context, return result (top-level await is supported; the trailing expression is the result)")).action(x(async(e,t,o)=>{const r=Do(t);let n;if(o.frame!==void 0){const i=Number.parseInt(o.frame,10);if(!Number.isInteger(i)||i<0){console.error(`Invalid frame index "${o.frame}". Use a 0-based index from "browser frames".`);process.exitCode=f.USAGE_ERROR;return}if(!e.evaluateInFrame)throw Error("This browser session does not support frame-targeted evaluation");n=await e.evaluateInFrame(r,i)}else n=await e.evaluate(r);if(typeof n==="string")console.log(n);else console.log(JSON.stringify(n,null,2))}));C(h.command("extract").option("--selector <css>","CSS selector scope; defaults to <main>/<article>/<body>").option("--chunk-size <chars>","Target chunk size in chars","20000").option("--start <char>","Start offset (use next_start_char from a previous extract)","0").description("Extract page content as markdown, paragraph-aware chunks for long pages")).action(x(async(e,t)=>{const o=String(t.chunkSize??"20000");if(!/^\d+$/.test(o)||Number.parseInt(o,10)<=0){console.log(JSON.stringify({error:{code:"invalid_chunk_size",message:`--chunk-size must be a positive integer, got "${t.chunkSize}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const r=String(t.start??"0");if(!/^\d+$/.test(r)){console.log(JSON.stringify({error:{code:"invalid_start",message:`--start must be a non-negative integer, got "${t.start}"`}},null,2));process.exitCode=f.USAGE_ERROR;return}const n=Number.parseInt(o,10),i=Number.parseInt(r,10),s=typeof t.selector==="string"&&t.selector.length>0?t.selector:null,d=Ho(s),u=await e.evaluate(d);if(!u){console.log(JSON.stringify({error:{code:"extract_failed",message:"Page returned no root element."}},null,2));process.exitCode=f.USAGE_ERROR;return}if("invalidSelector"in u){console.log(JSON.stringify({error:{code:"invalid_selector",message:`Selector "${s}" is not a valid CSS selector: ${u.reason}`}},null,2));process.exitCode=f.USAGE_ERROR;return}if("notFound"in u){console.log(JSON.stringify({error:{code:"selector_not_found",message:s?`Selector "${s}" matched 0 elements.`:"Page has no body/main/article element."}},null,2));process.exitCode=f.USAGE_ERROR;return}const m=qo({html:u.html,url:u.url,title:u.title,selector:s,start:i,chunkSize:n});console.log(JSON.stringify(m,null,2))}));C(h.command("network")).option("--detail <key>","Emit full body for the entry with this key").option("--all","Include static resources (js/css/images/telemetry)").option("--raw","Emit full bodies for every entry (skip shape preview)").option("--filter <fields>","Comma-separated field names; keep only entries whose body shape has ALL names as path segments").option("--since <duration>","Only include entries from the last duration (for example: 30s, 2m)").option("--until <duration>","Only include entries older than the duration from now").option("--follow","Continuously print new matching entries as JSON lines",!1).option("--failed","Only include failed HTTP requests (status 0 or >= 400)",!1).option("--max-body <chars>","With --detail: cap the emitted body at N chars (0 = unlimited, default)","0").option("--ttl <ms>","Cache TTL in ms for --detail lookups",String(Pt)).description("Capture network requests as shape previews; retrieve full bodies by key").action(x(async(e,t)=>{const o=Zt(t.ttl,"ttl",Pt),r=st(e),n=typeof t.detail==="string"&&t.detail.length>0,i=typeof t.filter==="string",s=Te(t.since,"since"),d=Te(t.until,"until");if(s&&typeof s==="object"){Z("invalid_since",s.error);return}if(d&&typeof d==="object"){Z("invalid_until",d.error);return}if(n&&i){Z("invalid_args","--filter and --detail cannot be used together (one narrows a list, the other fetches a specific entry).");return}let u=null;if(i){const w=Lo(t.filter);if("reason"in w){Z("invalid_filter",w.reason);return}u=w.fields}if(n&&t.follow){Z("invalid_args","--follow cannot be used with --detail.");return}if(n){const w=Fo(r,{ttlMs:o});if(w.status==="missing"){Z("cache_missing",`No cached capture. Run "browser network" first (in session "${r}").`);return}if(w.status==="expired"){Z("cache_expired",`Cache is stale (age ${w.ageMs}ms > ttl ${o}ms). Re-run "browser network" to refresh.`);return}if(w.status==="corrupt"||!w.file){Z("cache_corrupt",'Cache file is malformed; re-run "browser network" to regenerate.');return}const O=Go(w.file,t.detail);if(!O){Z("key_not_found",`Key "${t.detail}" not in cache.`,{available_keys:w.file.entries.map((H)=>H.key)});return}const y=String(t.maxBody??"0");if(!/^\d+$/.test(y)){Z("invalid_max_body",`--max-body must be a non-negative integer, got "${t.maxBody}"`);return}const S=Number.parseInt(y,10);let D=O.body,B=!1;if(S>0&&typeof O.body==="string"&&O.body.length>S){D=O.body.slice(0,S);B=!0}const ae=O.body_truncated===!0,q={key:O.key,url:O.url,method:O.method,status:O.status,ct:O.ct,size:O.size,...typeof O.timestamp==="number"?{timestamp:we(O.timestamp)}:{},shape:At(O.body),body:D};if(ae||B){q.body_truncated=!0;q.body_full_size=O.body_full_size??O.size;q.body_truncation_reason=ae?"capture-limit":"max-body"}console.log(JSON.stringify(q,null,2));return}if(t.follow){if(!await e.startNetworkCapture?.())try{await e.evaluate(Ae)}catch{}while(!0){const w=await ye(e).catch((S)=>{Z("capture_failed",`Could not read network capture: ${S.message}`);return[]});let O=t.all?w:Gt(w);O=ot(O,{sinceMs:s,untilMs:d});if(t.failed)O=O.filter((S)=>S.status===0||S.status>=400);const y=Tt(O);for(const S of y){const D=S.channel==="websocket"||S.channel==="eventsource";console.log(JSON.stringify({key:S.key,timestamp:we(S.timestamp),method:S.method,status:S.status,url:S.url,ct:S.ct,size:S.size,...D?{channel:S.channel,direction:S.direction}:{},...S.eventName?{event_name:S.eventName}:{},...D?{body:hr(S.body)}:{},...S.bodyTruncated?{body_truncated:!0}:{}}))}await new Promise((S)=>setTimeout(S,Dt))}}let m;try{m=await ye(e)}catch(w){Z("capture_failed",`Could not read network capture: ${w.message}`);return}let g=t.all?m:Gt(m);g=ot(g,{sinceMs:s,untilMs:d});if(t.failed)g=g.filter((w)=>w.status===0||w.status>=400);const b=m.length-g.length,P=Tt(g).map((w)=>({key:w.key,url:w.url,method:w.method,status:w.status,size:w.size,ct:w.ct,body:w.body,...typeof w.timestamp==="number"?{timestamp:w.timestamp}:{},...w.bodyTruncated?{body_truncated:!0}:{},...w.bodyTruncated&&typeof w.bodyFullSize==="number"?{body_full_size:w.bodyFullSize}:{}}));let G=null;try{Bo(r,P)}catch(w){G=`Could not persist capture cache: ${w.message}. --detail lookups may miss this capture.`}const _=P.map((w)=>({entry:w,shape:At(w.body)})),M=u?_.filter((w)=>zo(w.shape,u)):_,J=u?_.length-M.length:0,W={session:r,captured_at:new Date().toISOString(),count:M.length,filtered_out:b};if(u){W.filter=u;W.filter_dropped=J}if(G)W.cache_warning=G;const ne=M.filter((w)=>w.entry.body_truncated).length;if(ne>0){W.body_truncated_count=ne;W.body_truncated_hint="Some bodies exceeded the capture limit; their `shape` reflects only the captured prefix."}if(t.raw)W.entries=M.map((w)=>({...w.entry,...typeof w.entry.timestamp==="number"?{timestamp:we(w.entry.timestamp)}:{}}));else{W.entries=M.map((w)=>({key:w.entry.key,method:w.entry.method,...typeof w.entry.timestamp==="number"?{timestamp:we(w.entry.timestamp)}:{},status:w.entry.status,url:w.entry.url,ct:w.entry.ct,size:w.entry.size,shape:w.shape,...w.entry.body_truncated?{body_truncated:!0}:{}}));W.detail_hint='Run "browser network --detail <key>" for full body.'}console.log(JSON.stringify(W,null,2))}));h.command("init").argument("<name>","Adapter name in site/command format (e.g. hn/top)").description("Generate adapter scaffold in ~/.ppcli/clis/").action(async(e)=>{try{const t=e.split("/");if(t.length!==2||!t[0]||!t[1]){console.error("Name must be site/command format (e.g. hn/top)");process.exitCode=f.USAGE_ERROR;return}const[o,r]=t;if(!/^[a-zA-Z0-9_-]+$/.test(o)||!/^[a-zA-Z0-9_-]+$/.test(r)){console.error("Name parts must be alphanumeric/dash/underscore only");process.exitCode=f.USAGE_ERROR;return}const n=await import("node:os"),i=await import("node:fs"),s=await import("node:path"),d=s.join(n.homedir(),".ppcli","clis",o),u=s.join(d,`${r}.js`);if(i.existsSync(u)){console.log(`Adapter already exists: ${u}`);return}const g=`import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
99
107
|
|
|
100
108
|
cli({
|
|
101
109
|
site: '${o}',
|
|
@@ -117,18 +125,18 @@ cli({
|
|
|
117
125
|
return [];
|
|
118
126
|
},
|
|
119
127
|
});
|
|
120
|
-
`;
|
|
121
|
-
`);console.log(` Loading: ${
|
|
128
|
+
`;i.mkdirSync(d,{recursive:!0});i.writeFileSync(u,g,"utf-8");console.log(`Created: ${u}`);console.log("First time on this site? Run: ppcli browser analyze <url>");console.log(`Edit the file to implement your adapter, then run: ppcli browser verify ${e}`)}catch(t){console.error(`Error: ${t instanceof Error?t.message:String(t)}`);process.exitCode=f.GENERIC_ERROR}});h.command("verify").argument("<name>","Adapter name in site/command format (e.g. hn/top)").option("--write-fixture","Write a starter fixture to ~/.ppcli/sites/<site>/verify/<command>.json if none exists").option("--update-fixture","Overwrite an existing fixture with one derived from current output").option("--no-fixture","Ignore any fixture file for this run (no value-level validation)").option("--strict-memory","Fail (not just warn) when ~/.ppcli/sites/<site>/endpoints.json or notes.md is missing").option("--seed-args <value>","Seed args when no fixture exists; use JSON array/object for multiple args or flags").option("--trace <mode>","Trace capture for the adapter subprocess: off, on, retain-on-failure","off").description("Execute an adapter and validate output; uses fixture at ~/.ppcli/sites/<site>/verify/<cmd>.json when present").action(async(e,t={})=>{try{const o=e.split("/");if(o.length!==2){console.error("Name must be site/command format");process.exitCode=f.USAGE_ERROR;return}const[r,n]=o;if(!/^[a-zA-Z0-9_-]+$/.test(r)||!/^[a-zA-Z0-9_-]+$/.test(n)){console.error("Name parts must be alphanumeric/dash/underscore only");process.exitCode=f.USAGE_ERROR;return}const{execFileSync:i}=await import("node:child_process"),{loadFixture:s,writeFixture:d,deriveFixture:u,validateRows:m,validateRowShape:g,fixturePath:b,expandFixtureArgs:R,parseSeedArgs:P}=await import("./browser/verify-fixture.js"),G=k.join(l||k.join(ge.homedir(),".ppcli","clis"),r,`${n}.js`),_=A.existsSync(G)||!c?G:k.join(c,r,`${n}.js`);if(!A.existsSync(_)){console.error(`Adapter not found: ${_}`);console.error(`Run "ppcli browser init ${e}" to create it.`);process.exitCode=f.GENERIC_ERROR;return}console.log(`\uD83D\uDD0D Verifying ${e}...
|
|
129
|
+
`);console.log(` Loading: ${_}`);let J=t.fixture!==!1?s(r,n):null;const W=A.readFileSync(_,"utf-8"),ne=/['"]limit['"]/.test(W),w=P(t.seedArgs),O=J?.args??w,y=R(O);if(O===void 0&&y.length===0&&ne)y.push("--limit","3");const S=t.trace&&t.trace!=="off"?["--trace",t.trace]:[],D=[...y,...S].join(" "),B=resolveBrowserVerifyInvocation(),ae=[...B.args,r,n,...y,...S,"--format","json"];let q;try{q=i(B.binary,ae,{cwd:B.cwd,timeout:30000,encoding:"utf-8",env:process.env,stdio:["pipe","pipe","pipe"],...B.shell?{shell:!0}:{}})}catch(j){console.log(` Executing: ppcli ${r} ${n} ${D}
|
|
122
130
|
`);const V=j;if(V.stdout)console.log(String(V.stdout));if(V.stderr)console.error(String(V.stderr).slice(0,500));console.log(`
|
|
123
|
-
✗ Adapter failed. Fix the code and try again.`);process.exitCode=f.GENERIC_ERROR;return}console.log(` Executing: ppcli ${r} ${n} ${
|
|
124
|
-
`);let
|
|
125
|
-
→ ${
|
|
126
|
-
✗ Adapter output violates row shape conventions:`);for(const j of
|
|
131
|
+
✗ Adapter failed. Fix the code and try again.`);process.exitCode=f.GENERIC_ERROR;return}console.log(` Executing: ppcli ${r} ${n} ${D}
|
|
132
|
+
`);let H;try{H=normalizeVerifyRows(JSON.parse(q))}catch{console.log(q);console.log("\n ✗ Could not parse adapter output as JSON. Is `--format json` broken?");process.exitCode=f.GENERIC_ERROR;return}console.log(renderVerifyPreview(H));console.log(`
|
|
133
|
+
→ ${H.length} row${H.length===1?"":"s"}`);const ce=g(H);if(ce.length>0){console.log(`
|
|
134
|
+
✗ Adapter output violates row shape conventions:`);for(const j of ce.slice(0,20)){const V=j.rowIndex!==void 0?`row[${j.rowIndex}] `:"";console.log(` - [${j.rule}] ${V}${j.detail}`)}if(ce.length>20)console.log(` ... and ${ce.length-20} more failure(s)`);console.log(`
|
|
127
135
|
Keep rows agent-native: <=12 top-level keys, nesting depth <=1, and id-shaped fields at top level.`);process.exitCode=f.GENERIC_ERROR;return}if(t.writeFixture||t.updateFixture)if(J&&!t.updateFixture){console.log(`
|
|
128
|
-
Fixture already exists at ${
|
|
129
|
-
${J?"↻ Updated":"✎ Wrote"} fixture: ${
|
|
130
|
-
✓ Adapter runs. (No fixture at ${
|
|
131
|
-
✓ Adapter matches fixture (${
|
|
132
|
-
✗ Adapter output does not match fixture:`);for(const j of
|
|
133
|
-
`);for(const
|
|
134
|
-
Official baseline: ${s.length} sites in package`)}catch{console.log("No local adapter overrides. All sites use the official baseline.")}});Se.command("eject").description("Copy an official adapter to ~/.ppcli/clis/ for local editing").argument("<site>","Site name (e.g. twitter, bilibili)").action(async(e)=>{const t=await import("node:os"),o=k.join(t.homedir(),".ppcli","clis"),r=k.join(a,e),n=k.join(o,e);try{await A.promises.access(r)}catch{console.error(`Error: Site "${e}" not found in official adapters.`);process.exitCode=f.USAGE_ERROR;return}try{await A.promises.access(n);console.error(`Site "${e}" already exists in ~/.ppcli/clis/. Use "ppcli adapter reset ${e}" first to restore official version.`);process.exitCode=f.USAGE_ERROR;return}catch{}A.cpSync(r,n,{recursive:!0});console.log(`✅ Ejected "${e}" to ~/.ppcli/clis/${e}/`);console.log("You can now edit the adapter files. Changes take effect immediately.");console.log("Note: Official updates to this adapter will overwrite your changes.")});Se.command("reset").description("Remove local override and restore official adapter version").argument("[site]","Site name (e.g. twitter, bilibili)").option("--all","Reset all local overrides").action(async(e,t)=>{const o=await import("node:os"),r=k.join(o.homedir(),".ppcli","clis");if(t.all){try{const d=(await A.promises.readdir(r,{withFileTypes:!0})).filter((u)=>u.isDirectory());if(d.length===0){console.log("No local sites to reset.");return}for(const u of d)A.rmSync(k.join(r,u.name),{recursive:!0,force:!0});console.log(`✅ Reset ${d.length} site(s). All adapters now use official baseline.`)}catch{console.log("No local sites to reset.")}return}if(!e){console.error("Error: Please specify a site name or use --all.");process.exitCode=f.USAGE_ERROR;return}const n=k.join(r,e);try{await A.promises.access(n)}catch{console.error(`Site "${e}" has no local override.`);return}const s=A.existsSync(k.join(a,e));A.rmSync(n,{recursive:!0,force:!0});console.log(s?`✅ Reset "${e}". Now using official baseline.`:`✅ Removed custom site "${e}".`)});const B=i.command("profile").description("Manage Browser Bridge Chrome profiles"),Yt=B.description();B.command("list").description("List Chrome profiles: extension-connected and managed (dedicated Chrome instances)").option("-f, --format <fmt>","Output format: text, json","text").action(async(e)=>{const t=await Xo(),o=Zo(),r=t?.profiles??[],n=!!t&&!cr(t,$e)&&Array.isArray(t.profiles),s=await Promise.all(We().map(async({name:u,entry:p})=>({name:u,port:p.port,userDataDir:p.userDataDir,running:await or(p),isDefault:o.defaultContextId===u,createdAt:p.createdAt??"",label:p.label??"",proxy:p.proxy?{scheme:p.proxy.scheme,host:p.proxy.host,port:p.proxy.port,hasAuth:!!p.proxy.username,username:p.proxy.username??""}:null,fingerprint:p.fingerprint?.enabled?{enabled:!0,timezone:p.fingerprint.timezone??"",locale:p.fingerprint.locale??"",hardwareConcurrency:p.fingerprint.hardwareConcurrency??0,deviceMemory:p.fingerprint.deviceMemory??0,screen:p.fingerprint.screen??null,webglVendor:p.fingerprint.webglVendor??"",webglRenderer:p.fingerprint.webglRenderer??"",canvasNoise:p.fingerprint.canvasNoise===!0}:{enabled:!1},webrtc:p.webrtc!==!1,clean:p.clean!==!1})));if(e.format==="json"){const u=n?r.map((p)=>({contextId:p.contextId,alias:kt(o,p.contextId)??"",connected:!0,version:p.extensionVersion??"",isDefault:o.defaultContextId===p.contextId})):[];console.log(JSON.stringify({managed:s,extension:u,daemonRunning:!!t,daemonStale:!!t&&!n,defaultProfile:o.defaultContextId??""},null,2));return}if(s.length>0){console.log("Managed profiles (dedicated Chrome instances)");console.log();for(const u of s){const p=u.isDefault?" default":"";console.log(` ${u.name}${p} — ${u.running?`running on port ${u.port}`:"stopped"}`)}console.log()}if(!t){console.log("Daemon is not running. Run ppcli doctor after opening Chrome.");return}if(!n){console.log(`Daemon ${ar(t)} is stale for CLI v${$e}.`);console.log("Run: ppcli daemon restart");return}if(r.length===0){console.log("No Browser Bridge profiles connected.");console.log("Open a Chrome profile with the ppcli extension installed, then run ppcli profile list again.");return}const l=new Set(r.map((u)=>u.contextId));console.log("Connected Browser Bridge profiles");console.log();for(const u of r){const p=kt(o,u.contextId),h=o.defaultContextId===u.contextId?" default":"",S=p?` ${p}`:"",C=u.extensionVersion?` v${u.extensionVersion}`:" version unknown";console.log(` ${u.contextId}${S}${h} — connected${C}`)}if(s.some((u)=>u.running)){console.log();console.log("注意：托管 Chrome 也装了同一个扩展，上面的某个 contextId 可能就是它，");console.log(" 无法从这份列表分辨。写操作请显式带 --profile <名字>，不要依赖默认路由。")}const d=Object.entries(o.aliases).filter(([,u])=>!l.has(u));if(d.length>0||o.defaultContextId&&!l.has(o.defaultContextId)){console.log();console.log("Disconnected saved profiles:");const u=new Set;for(const[p,h]of d){u.add(h);console.log(` ${h} ${p} — not connected`)}if(o.defaultContextId&&!u.has(o.defaultContextId)&&!l.has(o.defaultContextId))console.log(` ${o.defaultContextId} — default, not connected`)}});const ct=(e)=>{if(e.config){const r=JSON.parse(e.config);if(typeof r.proxy==="string")r.proxy=Ve(r.proxy);return r}const t={};if(e.label)t.label=e.label;if(e.proxy)t.proxy=Ve(e.proxy);if(e.webrtc===!1)t.webrtc=!1;if(e.clean===!1)t.clean=!1;const o=e.fingerprint;if(o&&o!=="off")t.fingerprint={enabled:!0,spoof:o!=="lite",...e.fpTimezone?{timezone:e.fpTimezone}:{},...e.fpLocale?{locale:e.fpLocale}:{},...e.fpUa?{userAgent:e.fpUa}:{},...e.fpPlatform?{platform:e.fpPlatform}:{},...e.fpSeed?{seed:Number(e.fpSeed)}:{}};return t},lt=(e)=>e?{scheme:e.scheme,host:e.host,port:e.port,hasAuth:!!e.username,username:e.username??""}:null,dt=(e)=>e?.enabled?{enabled:!0,seed:e.seed,timezone:e.timezone??"",locale:e.locale??"",userAgent:e.userAgent??"",platform:e.platform??"",hardwareConcurrency:e.hardwareConcurrency??0,deviceMemory:e.deviceMemory??0,screen:e.screen??null,webglVendor:e.webglVendor??"",webglRenderer:e.webglRenderer??"",canvasNoise:e.canvasNoise===!0}:{enabled:!1},ut=(e)=>e.option("--label <text>","Display label / note for the environment").option("--proxy <url>","Per-env proxy: scheme://[user:pass@]host:port (scheme = http/https/socks5)").option("--fingerprint <mode>","Fingerprint mode: off | on (spoof soft signals) | lite (timezone/locale follow only)").option("--fp-timezone <iana>","Fingerprint timezone, e.g. America/New_York (must be set explicitly)").option("--fp-locale <locale>","Fingerprint locale, e.g. en-US (must be set explicitly)").option("--fp-ua <ua>","Override navigator.userAgent (use with care)").option("--fp-platform <p>","Override navigator.platform, e.g. Win32").option("--fp-seed <n>","Fixed fingerprint seed (for reproducible fingerprint)").option("--no-webrtc","Disable WebRTC leak protection (on by default)").option("--no-clean","Disable lean launch flags / telemetry suppression (on by default)").option("--config <json>","Full config as JSON: { label, proxy, fingerprint } — overrides granular flags");B.command("create").description("Create a managed profile: a dedicated Chrome instance with its own user data dir (for a second account)").argument("<name>","Profile name, e.g. work / brand2").option("--browser-path <path>","Explicit browser executable (defaults to auto-discovered Chrome)").option("--no-start","Create only; do not launch Chrome now").option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=ct(t),{opts:r}=await Tt({...o,browserPath:t.browserPath}),n=await tr(e,{...r,browserPath:t.browserPath});if(t.start!==!1)await He(e,n);if(t.format==="json"){console.log(JSON.stringify({ok:!0,name:e,port:n.port,userDataDir:n.userDataDir,label:n.label??"",proxy:lt(n.proxy),fingerprint:dt(n.fingerprint),webrtc:n.webrtc!==!1,clean:n.clean!==!1,started:t.start!==!1},null,2));return}console.log(`✅ 托管 profile "${e}" 已创建（端口 ${n.port}）`);console.log(` 数据目录：${n.userDataDir}`);if(n.proxy)console.log(` 代理：${n.proxy.scheme}://${n.proxy.host}:${n.proxy.port}`);if(n.fingerprint?.enabled)console.log(` 指纹：已开启${n.fingerprint.timezone?` 时区 ${n.fingerprint.timezone}`:""}${n.fingerprint.locale?` 语言 ${n.fingerprint.locale}`:""}`);if(t.start!==!1)console.log(` Chrome 已启动。用 ppcli <site> login --profile ${e} 在新窗口里登录账号。`)}catch(o){console.error(`Error: ${G(o)}`);process.exitCode=f.USAGE_ERROR}});ut(B.commands[B.commands.length-1]);B.command("start").description("Launch the dedicated Chrome instance of a managed profile").argument("<name>","Managed profile name").action(async(e)=>{try{const t=We().find((r)=>r.name===e.trim());if(!t)throw Error(`托管 profile "${e}" 不存在，先 ppcli profile create ${e}`);const o=await He(t.name,t.entry);console.log(`✅ profile "${e}" 运行中（${o}）`)}catch(t){console.error(`Error: ${G(t)}`);process.exitCode=f.USAGE_ERROR}});B.command("stop").description("Gracefully close the dedicated Chrome instance of a managed profile").argument("<name>","Managed profile name").action(async(e)=>{try{const t=We().find((r)=>r.name===e.trim());if(!t)throw Error(`托管 profile "${e}" 不存在`);const o=await nr(t.entry);console.log(o?`✅ profile "${e}" 已关闭`:`profile "${e}" 本来就没在运行`)}catch(t){console.error(`Error: ${G(t)}`);process.exitCode=f.USAGE_ERROR}});B.command("remove").description("Remove a managed profile (closes Chrome and deletes its login data)").argument("<name>","Managed profile name").option("--keep-data","Keep the user data dir on disk",!1).action(async(e,t)=>{try{await rr(e,{keepData:t.keepData===!0});console.log(`✅ 托管 profile "${e}" 已删除${t.keepData?"（保留数据目录）":"（含登录数据）"}`)}catch(o){console.error(`Error: ${G(o)}`);process.exitCode=f.USAGE_ERROR}});B.command("update").description("Reconfigure a managed profile (label / proxy / fingerprint); takes effect on next start").argument("<name>","Managed profile name").option("--clear-proxy","Remove the proxy from this environment").option("--restart","Relaunch the environment after updating",!1).option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=ct(t),{opts:r}=await Tt(o),n={};if(o.label!==void 0)n.label=o.label??null;if(t.clearProxy)n.proxy=null;else if(r.proxy)n.proxy=r.proxy;if(t.fingerprint==="off")n.fingerprint=null;else if(r.fingerprint)n.fingerprint=r.fingerprint;if(o.webrtc!==void 0)n.webrtc=o.webrtc;if(o.clean!==void 0)n.clean=o.clean;const{entry:s,wasRunning:l}=await sr(e,n);if(t.restart&&l)await He(e,s);if(t.format==="json"){console.log(JSON.stringify({ok:!0,name:e,label:s.label??"",proxy:lt(s.proxy),fingerprint:dt(s.fingerprint),webrtc:s.webrtc!==!1,clean:s.clean!==!1,wasRunning:l,restarted:!!(t.restart&&l)},null,2));return}console.log(`✅ 托管 profile "${e}" 配置已更新${l?"（已关闭，重启后生效）":""}`)}catch(o){console.error(`Error: ${G(o)}`);process.exitCode=f.USAGE_ERROR}});ut(B.commands[B.commands.length-1]);B.command("test-proxy").description("Test proxy connectivity and detect exit IP / country / timezone").argument("<url>","Proxy: scheme://[user:pass@]host:port (scheme = http/https/socks5)").option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=Ve(e),r=await ir(o);if(t.format==="json"){console.log(JSON.stringify(r,null,2));return}if(r.ok){console.log(`✅ 代理可用 — 出口 IP ${r.ip}`);console.log(` 位置：${r.country??"?"}${r.city?" / "+r.city:""}`);console.log(` 时区：${r.timezone??"?"} 语言：${r.locale??"?"}`)}else{console.log(`❌ 代理不可用：${r.error}`);process.exitCode=f.USAGE_ERROR}}catch(o){console.error(`Error: ${G(o)}`);process.exitCode=f.USAGE_ERROR}});B.command("rename").description("Assign a local alias to a connected Browser Bridge profile").argument("<contextId>","Profile contextId from ppcli profile list").argument("<alias>","Local alias, e.g. work or personal").action((e,t)=>{try{Yo(e,t);console.log(`Profile ${e} is now aliased as ${t}.`)}catch(o){console.error(`Error: ${G(o)}`);process.exitCode=f.USAGE_ERROR}});B.command("use").description("Set the default Browser Bridge profile for future commands").argument("<profile>","Profile alias or contextId").action((e)=>{try{const t=er(e);console.log(`Default Browser Bridge profile: ${t.defaultContextId??e}`)}catch(t){console.error(`Error: ${G(t)}`);process.exitCode=f.USAGE_ERROR}});const me=i.command("daemon").description("Manage the ppcli daemon"),Qt=me.description();me.command("status").description("Show daemon status").option("--json","Machine-readable status (includes bridgeReady)").action(async(e)=>{await Wo(e)});me.command("stop").description("Stop the daemon").action(async()=>{await Ho()});me.command("restart").description("Restart the daemon").action(async()=>{await zo()});me.command("warm").description("Pre-open the background automation window (keeps a tab alive for reuse)").option("--url <url>","http(s) info page to keep in the warm tab (falls back to about:blank)").action(async(e)=>{await Vo(e.url)});const ve=Be(),De=i.command("external").description("Manage external CLI passthrough commands");De.command("install").description("Install an external CLI").argument("<name>","Name of the external CLI").action((e)=>{const t=ve.find((o)=>o.name===e);if(!t){console.error(`External CLI '${e}' not found in registry.`);process.exitCode=f.USAGE_ERROR;return}go(t)});De.command("register").description("Register an external CLI").argument("<name>","Name of the CLI").option("--binary <bin>","Binary name if different from name").option("--install <cmd>","Auto-install command").option("--desc <text>","Description").action((e,t)=>{ho(e,{binary:t.binary,install:t.install,description:t.desc})});De.command("list").description("List registered external CLIs").option("-f, --format <fmt>","Output format: table, json, yaml, md, csv","table").action((e)=>{const t=Be().map((o)=>({name:o.name,package:o.package??"",binary:o.binary,installed:Le(o.binary),description:o.description??"",homepage:o.homepage??"",tags:o.tags?.join(", ")??""}));Ee(t,{fmt:e.format,columns:["name","package","binary","installed","description","homepage","tags"],title:"ppcli/external/list",source:"ppcli external list"})});function eo(e,t){const o=t??(()=>{const r=process.argv.indexOf(e);return process.argv.slice(r+1)})();try{fo(e,o,ve)}catch(r){if(r instanceof ze){process.stderr.write(co.dump(Co(r),{sortKeys:!1,lineWidth:120,noRefs:!0}));process.exitCode=r.exitCode}else{console.error(`Error: ${G(r)}`);process.exitCode=f.GENERIC_ERROR}}}for(const e of ve){if(i.commands.some((t)=>t.name()===e.name))continue;i.command(e.name).description(`(External) ${e.description||e.name}`).argument("[args...]").allowUnknownOption().passThroughOptions().helpOption(!1).action((t)=>eo(e.name,t))}const mt=i.command("antigravity").description("antigravity commands");mt.command("serve").description("Start Anthropic-compatible API proxy for Antigravity").option("--port <port>","Server port (default: 8082)","8082").option("--timeout <seconds>","Maximum time to wait for a reply (default: 120s)").action(async(e)=>{const{startServe:t}=await import("../../clis/antigravity/serve.js");await t({port:parseInt(e.port,10),timeout:e.timeout?Ht(e.timeout,"--timeout",120):void 0})});const pt=new Map;pt.set("antigravity",mt);const ft=bo(i,pt);Cr(i);const to=ve.map((e)=>e.name),oo=ve.map((e)=>({name:e.name,label:St(e)})),Ge=new Map;for(const[,e]of Re())if(!Ge.has(e.site))Ge.set(e.site,e.domain);const gt=[],ht=[];for(const e of ft)if(vt(Ge.get(e))==="app")gt.push(e);else ht.push(e);const wt={external:oo,apps:gt,sites:ht},ro=new Set([...to,...ft]);ge(g,{globalCommand:i,description:T});ge(v,{globalCommand:i,description:"Inspect website login status"});ge(me,{globalCommand:i,description:Qt});ge(ne,{globalCommand:i,description:Xt});ge(Se,{globalCommand:i,description:Zt});ge(B,{globalCommand:i,description:Yt});i.configureHelp({visibleCommands:(e)=>e.commands.filter((t)=>e!==i||!ro.has(t.name()))});const no=(e)=>{const t=[];let o=e.parent;while(o){const r=vo(o);t.unshift(r?`${o.name()} ${r}`:o.name());o=o.parent}return[...t,e.name(),e.usage()].filter(Boolean).join(" ").trim()};function yt(e){e.configureHelp({commandUsage:no});for(const t of e.commands)yt(t)}yt(g);So(i,()=>Ro(i,wt),()=>xo(wt));i.on("command:*",(e)=>{const t=e[0];console.error(`error: unknown command '${t}'`);if(Le(t))console.error(` Tip: '${t}' exists on your PATH. Use 'ppcli external register ${t}' to add it as an external CLI.`);i.outputHelp();process.exitCode=f.USAGE_ERROR});return i}export function runCli(a,c){createProgram(a,c).parse()}export{findPackageRoot};export function resolveBrowserVerifyInvocation(a={}){const c=a.platform??process.platform,i=a.fileExists??A.existsSync,m=a.readFile??((R)=>A.readFileSync(R,"utf-8")),v=a.projectRoot??findPackageRoot(Ke,i);for(const R of lo(v,m))if(i(R))return{binary:process.execPath,args:[R],cwd:v};const g=k.join(v,"src","main.ts");if(!i(g))throw Error(`Could not find ppcli entrypoint under ${v}. Expected built entry from package.json or src/main.ts.`);const T=k.join(v,"node_modules",".bin",c==="win32"?"tsx.cmd":"tsx");if(i(T))return{binary:T,args:[g],cwd:v,...c==="win32"?{shell:!0}:{}};return{binary:c==="win32"?"npx.cmd":"npx",args:["tsx",g],cwd:v,...c==="win32"?{shell:!0}:{}}}
|
|
136
|
+
Fixture already exists at ${b(r,n)}.`);console.log(" Use --update-fixture to overwrite.")}else{const V=u(H,O!==void 0?O:ne?{limit:3}:void 0),mo=d(r,n,V);console.log(`
|
|
137
|
+
${J?"↻ Updated":"✎ Wrote"} fixture: ${mo}`);console.log(" Review and hand-tune the derived expectations (add patterns / notEmpty, tighten rowCount).");J=V}if(!J){console.log(`
|
|
138
|
+
✓ Adapter runs. (No fixture at ${b(r,n)} — consider --write-fixture to seed one.)`);const j=checkSiteMemory(r);printSiteMemoryReport(j,t.strictMemory);if(!j.ok&&t.strictMemory)process.exitCode=f.GENERIC_ERROR;return}const fe=m(H,J);if(fe.length===0){console.log(`
|
|
139
|
+
✓ Adapter matches fixture (${b(r,n)}).`);const j=checkSiteMemory(r);printSiteMemoryReport(j,t.strictMemory);if(!j.ok&&t.strictMemory)process.exitCode=f.GENERIC_ERROR;return}console.log(`
|
|
140
|
+
✗ Adapter output does not match fixture:`);for(const j of fe.slice(0,20)){const V=j.rowIndex!==void 0?`row[${j.rowIndex}] `:"";console.log(` - [${j.rule}] ${V}${j.detail}`)}if(fe.length>20)console.log(` ... and ${fe.length-20} more failure(s)`);process.exitCode=f.GENERIC_ERROR}catch(o){console.error(`Error: ${o instanceof Error?o.message:String(o)}`);process.exitCode=f.GENERIC_ERROR}});h.command("close").description("Release the current browser session tab lease").action(x(async(e)=>{await e.closeWindow?.();console.log("Browser session tab lease released")}));a.command("doctor").description("Diagnose ppcli browser bridge connectivity").option("-v, --verbose","Debug output").action(async(e)=>{Nr(e);const{runBrowserDoctor:t,renderBrowserDoctorReport:o}=await import("./doctor.js"),r=await t({cliVersion:ke});console.log(o(r))});a.command("completion").description("Output shell completion script").argument("<shell>","Shell type: bash, zsh, or fish").action((e)=>{bo(e)});const se=a.command("plugin").description("Manage ppcli plugins"),oo=se.description();se.command("install").description("Install a plugin from a git repository").argument("<source>","Plugin source (e.g. github:user/repo)").action(async(e)=>{const{installPlugin:t}=await import("./plugin.js"),{discoverPlugins:o}=await import("./discovery.js");try{const r=t(e);await o();if(Array.isArray(r))if(r.length===0)console.log("No plugins were installed (all skipped or incompatible).");else console.log(`✅ Installed ${r.length} plugin(s) from monorepo: ${r.join(", ")}`);else console.log(`✅ Plugin "${r}" installed successfully. Commands are ready to use.`)}catch(r){console.error(`Error: ${U(r)}`);process.exitCode=f.GENERIC_ERROR}});se.command("uninstall").description("Uninstall a plugin").argument("<name>","Plugin name").action(async(e)=>{const{uninstallPlugin:t}=await import("./plugin.js");try{t(e);console.log(`✅ Plugin "${e}" uninstalled.`)}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.GENERIC_ERROR}});se.command("update").description("Update a plugin (or all plugins) to the latest version").argument("[name]","Plugin name (required unless --all is passed)").option("--all","Update all installed plugins").action(async(e,t)=>{if(!e&&!t.all){console.error("Error: Please specify a plugin name or use the --all flag.");process.exitCode=f.USAGE_ERROR;return}if(e&&t.all){console.error("Error: Cannot specify both a plugin name and --all.");process.exitCode=f.USAGE_ERROR;return}const{updatePlugin:o,updateAllPlugins:r}=await import("./plugin.js"),{discoverPlugins:n}=await import("./discovery.js");if(t.all){const i=r();if(i.length>0)await n();let s=!1;console.log(" Update Results:");for(const d of i){if(d.success){console.log(` ✓ ${d.name}`);continue}s=!0;console.log(` ✗ ${d.name} — ${String(d.error)}`)}if(i.length===0){console.log(" No plugins installed.");return}console.log();if(s){console.error("Completed with some errors.");process.exitCode=f.GENERIC_ERROR}else console.log("✅ All plugins updated successfully.");return}try{o(e);await n();console.log(`✅ Plugin "${e}" updated successfully.`)}catch(i){console.error(`Error: ${U(i)}`);process.exitCode=f.GENERIC_ERROR}});se.command("list").description("List installed plugins").option("-f, --format <fmt>","Output format: table, json","table").action(async(e)=>{const{listPlugins:t}=await import("./plugin.js"),o=t();if(o.length===0){console.log(" No plugins installed.");console.log(" Install one with: ppcli plugin install github:user/repo");return}if(e.format==="json"){_e(o,{fmt:"json",columns:["name","commands","source"],title:"ppcli/plugins",source:"ppcli plugin list"});return}console.log();console.log(" Installed plugins");console.log();const r=o.filter((i)=>!i.monorepoName),n=new Map;for(const i of o){if(!i.monorepoName)continue;const s=n.get(i.monorepoName)??[];s.push(i);n.set(i.monorepoName,s)}for(const i of r){const s=i.version?` @${i.version}`:"",d=i.description?` — ${i.description}`:"",u=i.commands.length>0?` (${i.commands.join(", ")})`:"",m=i.source?` ← ${i.source}`:"";console.log(` ${i.name}${s}${d}${u}${m}`)}for(const[i,s]of n){console.log();console.log(` \uD83D\uDCE6 ${i} (monorepo)`);for(const d of s){const u=d.version?` @${d.version}`:"",m=d.description?` — ${d.description}`:"",g=d.commands.length>0?` (${d.commands.join(", ")})`:"";console.log(` ${d.name}${u}${m}${g}`)}}console.log();console.log(` ${o.length} plugin(s) installed`);console.log()});se.command("create").description("Create a new plugin scaffold").argument("<name>","Plugin name (lowercase, hyphens allowed)").option("-d, --dir <path>","Output directory (default: ./<name>)").option("--description <text>","Plugin description").action(async(e,t)=>{const{createPluginScaffold:o}=await import("./plugin-scaffold.js");try{const r=o(e,{dir:t.dir,description:t.description});console.log(`✅ Plugin scaffold created at ${r.dir}`);console.log();console.log(" Files created:");for(const n of r.files)console.log(` ${n}`);console.log();console.log(" Next steps:");console.log(` cd ${r.dir}`);console.log(` ppcli plugin install file://${r.dir}`);console.log(` ppcli ${e} hello`)}catch(r){console.error(`Error: ${U(r)}`);process.exitCode=f.GENERIC_ERROR}});const Re=a.command("adapter").description("Manage CLI adapters"),ro=Re.description();Re.command("status").description("Show which sites have local overrides vs using official baseline").action(async()=>{const e=await import("node:os"),t=k.join(e.homedir(),".ppcli","clis"),o=c;try{const n=(await A.promises.readdir(t,{withFileTypes:!0})).filter((s)=>s.isDirectory()).map((s)=>s.name).sort();let i=[];try{i=(await A.promises.readdir(o,{withFileTypes:!0})).filter((d)=>d.isDirectory()).map((d)=>d.name).sort()}catch{}if(n.length===0){console.log("No local adapter overrides. All sites use the official baseline.");return}console.log(`Local overrides in ~/.ppcli/clis/ (${n.length} sites):
|
|
141
|
+
`);for(const s of n){const u=i.includes(s)?"override":"custom";console.log(` ${s} [${u}]`)}console.log(`
|
|
142
|
+
Official baseline: ${i.length} sites in package`)}catch{console.log("No local adapter overrides. All sites use the official baseline.")}});Re.command("eject").description("Copy an official adapter to ~/.ppcli/clis/ for local editing").argument("<site>","Site name (e.g. twitter, bilibili)").action(async(e)=>{const t=await import("node:os"),o=k.join(t.homedir(),".ppcli","clis"),r=k.join(c,e),n=k.join(o,e);try{await A.promises.access(r)}catch{console.error(`Error: Site "${e}" not found in official adapters.`);process.exitCode=f.USAGE_ERROR;return}try{await A.promises.access(n);console.error(`Site "${e}" already exists in ~/.ppcli/clis/. Use "ppcli adapter reset ${e}" first to restore official version.`);process.exitCode=f.USAGE_ERROR;return}catch{}A.cpSync(r,n,{recursive:!0});console.log(`✅ Ejected "${e}" to ~/.ppcli/clis/${e}/`);console.log("You can now edit the adapter files. Changes take effect immediately.");console.log("Note: Official updates to this adapter will overwrite your changes.")});Re.command("reset").description("Remove local override and restore official adapter version").argument("[site]","Site name (e.g. twitter, bilibili)").option("--all","Reset all local overrides").action(async(e,t)=>{const o=await import("node:os"),r=k.join(o.homedir(),".ppcli","clis");if(t.all){try{const d=(await A.promises.readdir(r,{withFileTypes:!0})).filter((u)=>u.isDirectory());if(d.length===0){console.log("No local sites to reset.");return}for(const u of d)A.rmSync(k.join(r,u.name),{recursive:!0,force:!0});console.log(`✅ Reset ${d.length} site(s). All adapters now use official baseline.`)}catch{console.log("No local sites to reset.")}return}if(!e){console.error("Error: Please specify a site name or use --all.");process.exitCode=f.USAGE_ERROR;return}const n=k.join(r,e);try{await A.promises.access(n)}catch{console.error(`Site "${e}" has no local override.`);return}const i=A.existsSync(k.join(c,e));A.rmSync(n,{recursive:!0,force:!0});console.log(i?`✅ Reset "${e}". Now using official baseline.`:`✅ Removed custom site "${e}".`)});const L=a.command("profile").description("Manage Browser Bridge Chrome profiles"),no=L.description();L.command("list").description("List Chrome profiles: extension-connected and managed (dedicated Chrome instances)").option("-f, --format <fmt>","Output format: text, json","text").action(async(e)=>{const t=await or(),o=rr(),r=t?.profiles??[],n=!!t&&!fr(t,ke)&&Array.isArray(t.profiles),i=await Promise.all(Ke().map(async({name:u,entry:m})=>({name:u,port:m.port,userDataDir:m.userDataDir,running:await cr(m),isDefault:o.defaultContextId===u,createdAt:m.createdAt??"",label:m.label??"",proxy:m.proxy?{scheme:m.proxy.scheme,host:m.proxy.host,port:m.proxy.port,hasAuth:!!m.proxy.username,username:m.proxy.username??""}:null,fingerprint:m.fingerprint?.enabled?{enabled:!0,timezone:m.fingerprint.timezone??"",locale:m.fingerprint.locale??"",hardwareConcurrency:m.fingerprint.hardwareConcurrency??0,deviceMemory:m.fingerprint.deviceMemory??0,screen:m.fingerprint.screen??null,webglVendor:m.fingerprint.webglVendor??"",webglRenderer:m.fingerprint.webglRenderer??"",canvasNoise:m.fingerprint.canvasNoise===!0}:{enabled:!1},webrtc:m.webrtc!==!1,clean:m.clean!==!1})));if(e.format==="json"){const u=n?r.map((m)=>({contextId:m.contextId,alias:Jt(o,m.contextId)??"",connected:!0,version:m.extensionVersion??"",isDefault:o.defaultContextId===m.contextId})):[];console.log(JSON.stringify({managed:i,extension:u,daemonRunning:!!t,daemonStale:!!t&&!n,defaultProfile:o.defaultContextId??""},null,2));return}if(i.length>0){console.log("Managed profiles (dedicated Chrome instances)");console.log();for(const u of i){const m=u.isDefault?" default":"";console.log(` ${u.name}${m} — ${u.running?`running on port ${u.port}`:"stopped"}`)}console.log()}if(!t){console.log("Daemon is not running. Run ppcli doctor after opening Chrome.");return}if(!n){console.log(`Daemon ${pr(t)} is stale for CLI v${ke}.`);console.log("Run: ppcli daemon restart");return}if(r.length===0){console.log("No Browser Bridge profiles connected.");console.log("Open a Chrome profile with the ppcli extension installed, then run ppcli profile list again.");return}const s=new Set(r.map((u)=>u.contextId));console.log("Connected Browser Bridge profiles");console.log();for(const u of r){const m=Jt(o,u.contextId),g=o.defaultContextId===u.contextId?" default":"",b=m?` ${m}`:"",R=u.extensionVersion?` v${u.extensionVersion}`:" version unknown";console.log(` ${u.contextId}${b}${g} — connected${R}`)}if(i.some((u)=>u.running)){console.log();console.log("注意：托管 Chrome 也装了同一个扩展，上面的某个 contextId 可能就是它，");console.log(" 无法从这份列表分辨。写操作请显式带 --profile <名字>，不要依赖默认路由。")}const d=Object.entries(o.aliases).filter(([,u])=>!s.has(u));if(d.length>0||o.defaultContextId&&!s.has(o.defaultContextId)){console.log();console.log("Disconnected saved profiles:");const u=new Set;for(const[m,g]of d){u.add(g);console.log(` ${g} ${m} — not connected`)}if(o.defaultContextId&&!u.has(o.defaultContextId)&&!s.has(o.defaultContextId))console.log(` ${o.defaultContextId} — default, not connected`)}});const pt=(e)=>{if(e.config){const r=JSON.parse(e.config);if(typeof r.proxy==="string")r.proxy=Ye(r.proxy);return r}const t={};if(e.label)t.label=e.label;if(e.proxy)t.proxy=Ye(e.proxy);if(e.webrtc===!1)t.webrtc=!1;if(e.clean===!1)t.clean=!1;const o=e.fingerprint;if(o&&o!=="off")t.fingerprint={enabled:!0,spoof:o!=="lite",...e.fpTimezone?{timezone:e.fpTimezone}:{},...e.fpLocale?{locale:e.fpLocale}:{},...e.fpUa?{userAgent:e.fpUa}:{},...e.fpPlatform?{platform:e.fpPlatform}:{},...e.fpSeed?{seed:Number(e.fpSeed)}:{}};return t},ft=(e)=>e?{scheme:e.scheme,host:e.host,port:e.port,hasAuth:!!e.username,username:e.username??""}:null,gt=(e)=>e?.enabled?{enabled:!0,seed:e.seed,timezone:e.timezone??"",locale:e.locale??"",userAgent:e.userAgent??"",platform:e.platform??"",hardwareConcurrency:e.hardwareConcurrency??0,deviceMemory:e.deviceMemory??0,screen:e.screen??null,webglVendor:e.webglVendor??"",webglRenderer:e.webglRenderer??"",canvasNoise:e.canvasNoise===!0}:{enabled:!1},ht=(e)=>e.option("--label <text>","Display label / note for the environment").option("--proxy <url>","Per-env proxy: scheme://[user:pass@]host:port (scheme = http/https/socks5)").option("--fingerprint <mode>","Fingerprint mode: off | on (spoof soft signals) | lite (timezone/locale follow only)").option("--fp-timezone <iana>","Fingerprint timezone, e.g. America/New_York (must be set explicitly)").option("--fp-locale <locale>","Fingerprint locale, e.g. en-US (must be set explicitly)").option("--fp-ua <ua>","Override navigator.userAgent (use with care)").option("--fp-platform <p>","Override navigator.platform, e.g. Win32").option("--fp-seed <n>","Fixed fingerprint seed (for reproducible fingerprint)").option("--no-webrtc","Disable WebRTC leak protection (on by default)").option("--no-clean","Disable lean launch flags / telemetry suppression (on by default)").option("--config <json>","Full config as JSON: { label, proxy, fingerprint } — overrides granular flags");L.command("create").description("Create a managed profile: a dedicated Chrome instance with its own user data dir (for a second account)").argument("<name>","Profile name, e.g. work / brand2").option("--browser-path <path>","Explicit browser executable (defaults to auto-discovered Chrome)").option("--no-start","Create only; do not launch Chrome now").option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=pt(t),{opts:r}=await Mt({...o,browserPath:t.browserPath}),n=await ar(e,{...r,browserPath:t.browserPath});if(t.start!==!1)await Ze(e,n);if(t.format==="json"){console.log(JSON.stringify({ok:!0,name:e,port:n.port,userDataDir:n.userDataDir,label:n.label??"",proxy:ft(n.proxy),fingerprint:gt(n.fingerprint),webrtc:n.webrtc!==!1,clean:n.clean!==!1,started:t.start!==!1},null,2));return}console.log(`✅ 托管 profile "${e}" 已创建（端口 ${n.port}）`);console.log(` 数据目录：${n.userDataDir}`);if(n.proxy)console.log(` 代理：${n.proxy.scheme}://${n.proxy.host}:${n.proxy.port}`);if(n.fingerprint?.enabled)console.log(` 指纹：已开启${n.fingerprint.timezone?` 时区 ${n.fingerprint.timezone}`:""}${n.fingerprint.locale?` 语言 ${n.fingerprint.locale}`:""}`);if(t.start!==!1)console.log(` Chrome 已启动。用 ppcli <site> login --profile ${e} 在新窗口里登录账号。`)}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.USAGE_ERROR}});ht(L.commands[L.commands.length-1]);L.command("start").description("Launch the dedicated Chrome instance of a managed profile").argument("<name>","Managed profile name").action(async(e)=>{try{const t=Ke().find((r)=>r.name===e.trim());if(!t)throw Error(`托管 profile "${e}" 不存在，先 ppcli profile create ${e}`);const o=await Ze(t.name,t.entry);console.log(`✅ profile "${e}" 运行中（${o}）`)}catch(t){console.error(`Error: ${U(t)}`);process.exitCode=f.USAGE_ERROR}});L.command("stop").description("Gracefully close the dedicated Chrome instance of a managed profile").argument("<name>","Managed profile name").action(async(e)=>{try{const t=Ke().find((r)=>r.name===e.trim());if(!t)throw Error(`托管 profile "${e}" 不存在`);const o=await dr(t.entry);console.log(o?`✅ profile "${e}" 已关闭`:`profile "${e}" 本来就没在运行`)}catch(t){console.error(`Error: ${U(t)}`);process.exitCode=f.USAGE_ERROR}});L.command("remove").description("Remove a managed profile (closes Chrome and deletes its login data)").argument("<name>","Managed profile name").option("--keep-data","Keep the user data dir on disk",!1).action(async(e,t)=>{try{await lr(e,{keepData:t.keepData===!0});console.log(`✅ 托管 profile "${e}" 已删除${t.keepData?"（保留数据目录）":"（含登录数据）"}`)}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.USAGE_ERROR}});L.command("update").description("Reconfigure a managed profile (label / proxy / fingerprint); takes effect on next start").argument("<name>","Managed profile name").option("--clear-proxy","Remove the proxy from this environment").option("--restart","Relaunch the environment after updating",!1).option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=pt(t),{opts:r}=await Mt(o),n={};if(o.label!==void 0)n.label=o.label??null;if(t.clearProxy)n.proxy=null;else if(r.proxy)n.proxy=r.proxy;if(t.fingerprint==="off")n.fingerprint=null;else if(r.fingerprint)n.fingerprint=r.fingerprint;if(o.webrtc!==void 0)n.webrtc=o.webrtc;if(o.clean!==void 0)n.clean=o.clean;const{entry:i,wasRunning:s}=await ur(e,n);if(t.restart&&s)await Ze(e,i);if(t.format==="json"){console.log(JSON.stringify({ok:!0,name:e,label:i.label??"",proxy:ft(i.proxy),fingerprint:gt(i.fingerprint),webrtc:i.webrtc!==!1,clean:i.clean!==!1,wasRunning:s,restarted:!!(t.restart&&s)},null,2));return}console.log(`✅ 托管 profile "${e}" 配置已更新${s?"（已关闭，重启后生效）":""}`)}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.USAGE_ERROR}});ht(L.commands[L.commands.length-1]);L.command("test-proxy").description("Test proxy connectivity and detect exit IP / country / timezone").argument("<url>","Proxy: scheme://[user:pass@]host:port (scheme = http/https/socks5)").option("-f, --format <fmt>","Output format: text, json","text").action(async(e,t)=>{try{const o=Ye(e),r=await mr(o);if(t.format==="json"){console.log(JSON.stringify(r,null,2));return}if(r.ok){console.log(`✅ 代理可用 — 出口 IP ${r.ip}`);console.log(` 位置：${r.country??"?"}${r.city?" / "+r.city:""}`);console.log(` 时区：${r.timezone??"?"} 语言：${r.locale??"?"}`)}else{console.log(`❌ 代理不可用：${r.error}`);process.exitCode=f.USAGE_ERROR}}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.USAGE_ERROR}});L.command("rename").description("Assign a local alias to a connected Browser Bridge profile").argument("<contextId>","Profile contextId from ppcli profile list").argument("<alias>","Local alias, e.g. work or personal").action((e,t)=>{try{nr(e,t);console.log(`Profile ${e} is now aliased as ${t}.`)}catch(o){console.error(`Error: ${U(o)}`);process.exitCode=f.USAGE_ERROR}});L.command("use").description("Set the default Browser Bridge profile for future commands").argument("<profile>","Profile alias or contextId").action((e)=>{try{const t=sr(e);console.log(`Default Browser Bridge profile: ${t.defaultContextId??e}`)}catch(t){console.error(`Error: ${U(t)}`);process.exitCode=f.USAGE_ERROR}});const pe=a.command("daemon").description("Manage the ppcli daemon"),io=pe.description();pe.command("status").description("Show daemon status").option("--json","Machine-readable status (includes bridgeReady)").action(async(e)=>{await Zo(e)});pe.command("stop").description("Stop the daemon").action(async()=>{await Yo()});pe.command("restart").description("Restart the daemon").action(async()=>{await Ko()});pe.command("warm").description("Pre-open the background automation window (keeps a tab alive for reuse)").option("--url <url>","http(s) info page to keep in the warm tab (falls back to about:blank)").action(async(e)=>{await Qo(e.url)});const Ce=qe(),ze=a.command("external").description("Manage external CLI passthrough commands");ze.command("install").description("Install an external CLI").argument("<name>","Name of the external CLI").action((e)=>{const t=Ce.find((o)=>o.name===e);if(!t){console.error(`External CLI '${e}' not found in registry.`);process.exitCode=f.USAGE_ERROR;return}So(t)});ze.command("register").description("Register an external CLI").argument("<name>","Name of the CLI").option("--binary <bin>","Binary name if different from name").option("--install <cmd>","Auto-install command").option("--desc <text>","Description").action((e,t)=>{vo(e,{binary:t.binary,install:t.install,description:t.desc})});ze.command("list").description("List registered external CLIs").option("-f, --format <fmt>","Output format: table, json, yaml, md, csv","table").action((e)=>{const t=qe().map((o)=>({name:o.name,package:o.package??"",binary:o.binary,installed:Ve(o.binary),description:o.description??"",homepage:o.homepage??"",tags:o.tags?.join(", ")??""}));_e(t,{fmt:e.format,columns:["name","package","binary","installed","description","homepage","tags"],title:"ppcli/external/list",source:"ppcli external list"})});function so(e,t){const o=t??(()=>{const r=process.argv.indexOf(e);return process.argv.slice(r+1)})();try{xo(e,o,Ce)}catch(r){if(r instanceof Xe){process.stderr.write(go.dump(Ao(r),{sortKeys:!1,lineWidth:120,noRefs:!0}));process.exitCode=r.exitCode}else{console.error(`Error: ${U(r)}`);process.exitCode=f.GENERIC_ERROR}}}for(const e of Ce){if(a.commands.some((t)=>t.name()===e.name))continue;a.command(e.name).description(`(External) ${e.description||e.name}`).argument("[args...]").allowUnknownOption().passThroughOptions().helpOption(!1).action((t)=>so(e.name,t))}const wt=a.command("antigravity").description("antigravity commands");wt.command("serve").description("Start Anthropic-compatible API proxy for Antigravity").option("--port <port>","Server port (default: 8082)","8082").option("--timeout <seconds>","Maximum time to wait for a reply (default: 120s)").action(async(e)=>{const{startServe:t}=await import("../../clis/antigravity/serve.js");await t({port:parseInt(e.port,10),timeout:e.timeout?Zt(e.timeout,"--timeout",120):void 0})});const yt=new Map;yt.set("antigravity",wt);const bt=Eo(a,yt);Ar(a);const ao=Ce.map((e)=>e.name),co=Ce.map((e)=>({name:e.name,label:_t(e)})),We=new Map;for(const[,e]of Ee())if(!We.has(e.site))We.set(e.site,e.domain);const xt=[],St=[];for(const e of bt)if(Ot(We.get(e))==="app")xt.push(e);else St.push(e);const vt={external:co,apps:xt,sites:St},lo=new Set([...ao,...bt]);he(h,{globalCommand:a,description:T});he(v,{globalCommand:a,description:"Inspect website login status"});he(pe,{globalCommand:a,description:io});he(se,{globalCommand:a,description:oo});he(Re,{globalCommand:a,description:ro});he(L,{globalCommand:a,description:no});a.configureHelp({visibleCommands:(e)=>e.commands.filter((t)=>e!==a||!lo.has(t.name()))});const uo=(e)=>{const t=[];let o=e.parent;while(o){const r=$o(o);t.unshift(r?`${o.name()} ${r}`:o.name());o=o.parent}return[...t,e.name(),e.usage()].filter(Boolean).join(" ").trim()};function Rt(e){e.configureHelp({commandUsage:uo});for(const t of e.commands)Rt(t)}Rt(h);Oo(a,()=>No(a,vt),()=>_o(vt));a.on("command:*",(e)=>{const t=e[0];console.error(`error: unknown command '${t}'`);if(Ve(t))console.error(` Tip: '${t}' exists on your PATH. Use 'ppcli external register ${t}' to add it as an external CLI.`);a.outputHelp();process.exitCode=f.USAGE_ERROR});return a}export function runCli(c,l){createProgram(c,l).parse()}export{findPackageRoot};export function resolveBrowserVerifyInvocation(c={}){const l=c.platform??process.platform,a=c.fileExists??A.existsSync,p=c.readFile??((E)=>A.readFileSync(E,"utf-8")),v=c.projectRoot??findPackageRoot(et,a);for(const E of ho(v,p))if(a(E))return{binary:process.execPath,args:[E],cwd:v};const h=k.join(v,"src","main.ts");if(!a(h))throw Error(`Could not find ppcli entrypoint under ${v}. Expected built entry from package.json or src/main.ts.`);const T=k.join(v,"node_modules",".bin",l==="win32"?"tsx.cmd":"tsx");if(a(T))return{binary:T,args:[h],cwd:v,...l==="win32"?{shell:!0}:{}};return{binary:l==="win32"?"npx.cmd":"npx",args:["tsx",h],cwd:v,...l==="win32"?{shell:!0}:{}}}
|