publishport-opencli 1.0.19 → 1.0.21

package/dist/src/browser/proxy-test.js

@@ -1,12 +1,12 @@
-import*as R from"node:net";const $="ip-api.com",A=80,I="/json/?fields=status,message,country,countryCode,region,city,timezone,query",F=12000,B={US:"en-US",GB:"en-GB",CA:"en-CA",AU:"en-AU",SG:"en-SG",HK:"zh-HK",TW:"zh-TW",CN:"zh-CN",MO:"zh-MO",JP:"ja-JP",KR:"ko-KR",DE:"de-DE",FR:"fr-FR",ES:"es-ES",IT:"it-IT",NL:"nl-NL",RU:"ru-RU",BR:"pt-BR",PT:"pt-PT",IN:"en-IN",ID:"id-ID",TH:"th-TH",VN:"vi-VN",MY:"ms-MY",PH:"en-PH",TR:"tr-TR",PL:"pl-PL",SE:"sv-SE",NO:"nb-NO",DK:"da-DK",FI:"fi-FI",UA:"uk-UA",MX:"es-MX",AR:"es-AR"};export function localeForCountry(z){if(!z)return;return B[z.toUpperCase()]??"en-US"}function L(z){const V=z.indexOf(`\r
+import*as h from"node:net";const i="ip-api.com",d=80,l="/json/?fields=status,message,country,countryCode,region,city,timezone,query",a=12000,T={US:"en-US",GB:"en-GB",CA:"en-CA",AU:"en-AU",SG:"en-SG",HK:"zh-HK",TW:"zh-TW",CN:"zh-CN",MO:"zh-MO",JP:"ja-JP",KR:"ko-KR",DE:"de-DE",FR:"fr-FR",ES:"es-ES",IT:"it-IT",NL:"nl-NL",RU:"ru-RU",BR:"pt-BR",PT:"pt-PT",IN:"en-IN",ID:"id-ID",TH:"th-TH",VN:"vi-VN",MY:"ms-MY",PH:"en-PH",TR:"tr-TR",PL:"pl-PL",SE:"sv-SE",NO:"nb-NO",DK:"da-DK",FI:"fi-FI",UA:"uk-UA",MX:"es-MX",AR:"es-AR"};export function localeForCountry(e){if(!e)return;return T[e.toUpperCase()]??"en-US"}function C(e){const s=e.indexOf(`\r
 \r
-`);return V>=0?z.slice(V+4):z}function U(z,V){return new Promise((D)=>{let W="";const J=(K)=>{try{z.destroy()}catch{}D(K)};z.setTimeout(F,()=>J({ok:!1,error:"代理请求超时"}));z.on("data",(K)=>{W+=K.toString("utf8")});z.on("end",()=>{try{const K=L(W),Q=K.indexOf("{"),X=K.lastIndexOf("}");if(Q<0||X<0)return J({ok:!1,error:"代理返回无法解析"});const Z=JSON.parse(K.slice(Q,X+1));if(Z.status!=="success")return J({ok:!1,error:Z.message||"出口探测失败"});J({ok:!0,ip:Z.query,country:Z.country,countryCode:Z.countryCode,city:Z.city,timezone:Z.timezone,locale:localeForCountry(Z.countryCode)})}catch(K){J({ok:!1,error:K instanceof Error?K.message:"解析失败"})}});z.on("error",(K)=>J({ok:!1,error:K.message}));z.write(V)})}function b(z){return new Promise((V)=>{const D=R.connect({host:z.host,port:z.port});D.setTimeout(F,()=>{try{D.destroy()}catch{}V({ok:!1,error:"连接代理超时"})});D.on("error",(W)=>V({ok:!1,error:`连接代理失败：${W.message}`}));D.on("connect",()=>{const W=z.username?`Proxy-Authorization: Basic ${Buffer.from(`${z.username}:${z.password??""}`).toString("base64")}\r
-`:"",J=`GET http://${$}${I} HTTP/1.1\r
-Host: ${$}\r
-${W}Connection: close\r
+`);return s>=0?e.slice(s+4):e}function p(e,s){return new Promise((t)=>{let c="";const r=(n)=>{try{e.destroy()}catch{}t(n)};e.setTimeout(a,()=>r({ok:!1,error:"代理请求超时"}));e.on("data",(n)=>{c+=n.toString("utf8")});e.on("end",()=>{try{const n=C(c),o=n.indexOf("{"),f=n.lastIndexOf("}");if(o<0||f<0)return r({ok:!1,error:"代理返回无法解析"});const u=JSON.parse(n.slice(o,f+1));if(u.status!=="success")return r({ok:!1,error:u.message||"出口探测失败"});r({ok:!0,ip:u.query,country:u.country,countryCode:u.countryCode,city:u.city,timezone:u.timezone,locale:localeForCountry(u.countryCode)})}catch(n){r({ok:!1,error:n instanceof Error?n.message:"解析失败"})}});e.on("error",(n)=>r({ok:!1,error:n.message}));e.write(s)})}function S(e){return new Promise((s)=>{const t=h.connect({host:e.host,port:e.port});t.setTimeout(a,()=>{try{t.destroy()}catch{}s({ok:!1,error:"连接代理超时"})});t.on("error",(c)=>s({ok:!1,error:`连接代理失败：${c.message}`}));t.on("connect",()=>{const c=e.username?`Proxy-Authorization: Basic ${Buffer.from(`${e.username}:${e.password??""}`).toString("base64")}\r
+`:"",r=`GET http://${i}${l} HTTP/1.1\r
+Host: ${i}\r
+${c}Connection: close\r
 \r
-`;U(D,J).then(V)})})}function q(z){return new Promise((V)=>{const D=R.connect({host:z.host,port:z.port});let W="greet";const J=(Q)=>{try{D.destroy()}catch{}V({ok:!1,error:Q})};D.setTimeout(F,()=>J("SOCKS5 代理超时"));D.on("error",(Q)=>J(`连接代理失败：${Q.message}`));D.on("connect",()=>{D.write(Buffer.from([5,2,0,2]))});const K=()=>{W="connect";const Q=Buffer.from($,"ascii"),X=Buffer.concat([Buffer.from([5,1,0,3,Q.length]),Q,Buffer.from([A>>8&255,A&255])]);D.write(X)};D.on("data",(Q)=>{if(W==="greet"){if(Q[0]!==5)return J("非 SOCKS5 代理");const X=Q[1];if(X===0)return K();if(X===2){if(!z.username)return J("代理要求账密但未提供");const Z=Buffer.from(z.username,"ascii"),Y=Buffer.from(z.password??"","ascii");W="auth";D.write(Buffer.concat([Buffer.from([1,Z.length]),Z,Buffer.from([Y.length]),Y]));return}return J("代理不支持所需认证方式")}if(W==="auth"){if(Q[1]!==0)return J("代理账密认证失败");return K()}if(W==="connect"){if(Q[1]!==0)return J(`SOCKS5 连接源站失败（code ${Q[1]}）`);D.removeAllListeners("data");const X=`GET ${I} HTTP/1.1\r
-Host: ${$}\r
+`;p(t,r).then(s)})})}function O(e){return new Promise((s)=>{const t=h.connect({host:e.host,port:e.port});let c="greet";const r=(o)=>{try{t.destroy()}catch{}s({ok:!1,error:o})};t.setTimeout(a,()=>r("SOCKS5 代理超时"));t.on("error",(o)=>r(`连接代理失败：${o.message}`));t.on("connect",()=>{t.write(Buffer.from([5,2,0,2]))});const n=()=>{c="connect";const o=Buffer.from(i,"ascii"),f=Buffer.concat([Buffer.from([5,1,0,3,o.length]),o,Buffer.from([d>>8&255,d&255])]);t.write(f)};t.on("data",(o)=>{if(c==="greet"){if(o[0]!==5)return r("非 SOCKS5 代理");const f=o[1];if(f===0)return n();if(f===2){if(!e.username)return r("代理要求账密但未提供");const u=Buffer.from(e.username,"ascii"),m=Buffer.from(e.password??"","ascii");c="auth";t.write(Buffer.concat([Buffer.from([1,u.length]),u,Buffer.from([m.length]),m]));return}return r("代理不支持所需认证方式")}if(c==="auth"){if(o[1]!==0)return r("代理账密认证失败");return n()}if(c==="connect"){if(o[1]!==0)return r(`SOCKS5 连接源站失败（code ${o[1]}）`);t.removeAllListeners("data");const f=`GET ${l} HTTP/1.1\r
+Host: ${i}\r
 Connection: close\r
 \r
-`;U(D,X).then(V)}})})}export function testProxy(z){if(z.scheme==="socks5")return q(z);return b(z)}export function parseProxyUrl(z){const V=z.trim(),D=/^(https?|socks5):\/\/(?:([^:@/]+)(?::([^@/]*))?@)?([^:/@]+):(\d+)\/?$/.exec(V);if(!D)throw Error("代理格式应为 scheme://[user:pass@]host:port（scheme = http/https/socks5）");const[,W,J,K,Q,X]=D;return{scheme:W,host:Q,port:Number(X),...J?{username:decodeURIComponent(J)}:{},...K?{password:decodeURIComponent(K)}:{}}}export function proxyServerFlag(z){return`${z.scheme==="socks5"?"socks5":z.scheme}://${z.host}:${z.port}`}
+`;p(t,f).then(s)}})})}export function testProxy(e){if(e.scheme==="socks5")return O(e);return S(e)}export function parseProxyUrl(e){const s=e.trim(),t=/^(https?|socks5):\/\/(?:([^:@/]+)(?::([^@/]*))?@)?([^:/@]+):(\d+)\/?$/.exec(s);if(!t)throw Error("代理格式应为 scheme://[user:pass@]host:port（scheme = http/https/socks5）");const[,c,r,n,o,f]=t;return{scheme:c,host:o,port:Number(f),...r?{username:decodeURIComponent(r)}:{},...n?{password:decodeURIComponent(n)}:{}}}export function proxyServerFlag(e){return`${e.scheme==="socks5"?"socks5":e.scheme}://${e.host}:${e.port}`}

package/dist/src/browser/shape-filter.js

@@ -1 +1 @@
-export function parseFilter(k){if(typeof k!=="string")return{reason:"--filter value must be a non-empty comma-separated field list"};const C=k.split(",").map((B)=>B.trim()).filter((B)=>B.length>0);if(C.length===0)return{reason:`--filter value must be a non-empty comma-separated field list (got "${k}")`};const z=new Set,E=[];for(const B of C)if(!z.has(B)){z.add(B);E.push(B)}return{fields:E}}export function extractSegments(k){if(!k||k==="$")return[];const C=[];let z=k.startsWith("$")?1:0;while(z<k.length){const E=k[z];if(E==="."){z++;continue}if(E==="["){const G=k.indexOf("]",z);if(G===-1)break;const F=k.slice(z+1,G);z=G+1;if(F.length>=2&&F.startsWith('"')&&F.endsWith('"'))try{C.push(JSON.parse(F))}catch{C.push(F.slice(1,-1))}continue}let B=z;while(B<k.length&&k[B]!=="."&&k[B]!=="[")B++;C.push(k.slice(z,B));z=B}return C}export function collectShapeSegments(k){const C=new Set;for(const z of Object.keys(k))for(const E of extractSegments(z))C.add(E);return C}export function shapeMatchesFilter(k,C){if(C.length===0)return!0;const z=collectShapeSegments(k);for(const E of C)if(!z.has(E))return!1;return!0}
+export function parseFilter(e){if(typeof e!=="string")return{reason:"--filter value must be a non-empty comma-separated field list"};const s=e.split(",").map((n)=>n.trim()).filter((n)=>n.length>0);if(s.length===0)return{reason:`--filter value must be a non-empty comma-separated field list (got "${e}")`};const t=new Set,r=[];for(const n of s)if(!t.has(n)){t.add(n);r.push(n)}return{fields:r}}export function extractSegments(e){if(!e||e==="$")return[];const s=[];let t=e.startsWith("$")?1:0;while(t<e.length){const r=e[t];if(r==="."){t++;continue}if(r==="["){const i=e.indexOf("]",t);if(i===-1)break;const o=e.slice(t+1,i);t=i+1;if(o.length>=2&&o.startsWith('"')&&o.endsWith('"'))try{s.push(JSON.parse(o))}catch{s.push(o.slice(1,-1))}continue}let n=t;while(n<e.length&&e[n]!=="."&&e[n]!=="[")n++;s.push(e.slice(t,n));t=n}return s}export function collectShapeSegments(e){const s=new Set;for(const t of Object.keys(e))for(const r of extractSegments(t))s.add(r);return s}export function shapeMatchesFilter(e,s){if(s.length===0)return!0;const t=collectShapeSegments(e);for(const r of s)if(!t.has(r))return!1;return!0}

package/dist/src/browser/shape.js

@@ -1 +1 @@
-const _="$";export function inferShape(J,K={}){const U=K.maxDepth??6,V=K.maxBytes??2048,Y=K.sampleStringLen??80,M={};let W=2,H=!1;const C=(A,q)=>{if(H)return!1;const F=JSON.stringify(A).length+JSON.stringify(q).length+2;if(W+F>V){M["(truncated)"]=`reached ${V}B budget`;H=!0;return!1}M[A]=q;W+=F;return!0},N=(A,q,F)=>{if(H)return;if(A===null){C(q,"null");return}const E=typeof A;if(E==="string"){const G=A;C(q,G.length>Y?`string(len=${G.length})`:"string");return}if(E==="number"||E==="boolean"){C(q,E);return}if(E==="undefined"||E==="function"||E==="symbol"||E==="bigint"){C(q,E);return}if(Array.isArray(A)){if(A.length===0){C(q,"array(0)");return}if(F>=U){C(q,`array(${A.length})`);return}if(!C(q,`array(${A.length})`))return;N(A[0],`${q}[0]`,F+1);return}const X=A,Q=Object.keys(X);if(Q.length===0){C(q,"object(empty)");return}if(F>=U){C(q,`object(keys=${Q.length})`);return}if(!C(q,"object"))return;for(const G of Q){if(H)return;const Z=$(G)?`${q}.${G}`:`${q}[${JSON.stringify(G)}]`;N(X[G],Z,F+1)}};N(J,_,0);return M}function $(J){return/^[A-Za-z_$][\w$]*$/.test(J)}
+const j="$";export function inferShape(f,l={}){const y=l.maxDepth??6,a=l.maxBytes??2048,S=l.sampleStringLen??80,c={};let b=2,u=!1;const n=(t,r)=>{if(u)return!1;const i=JSON.stringify(t).length+JSON.stringify(r).length+2;if(b+i>a){c["(truncated)"]=`reached ${a}B budget`;u=!0;return!1}c[t]=r;b+=i;return!0},g=(t,r,i)=>{if(u)return;if(t===null){n(r,"null");return}const e=typeof t;if(e==="string"){const s=t;n(r,s.length>S?`string(len=${s.length})`:"string");return}if(e==="number"||e==="boolean"){n(r,e);return}if(e==="undefined"||e==="function"||e==="symbol"||e==="bigint"){n(r,e);return}if(Array.isArray(t)){if(t.length===0){n(r,"array(0)");return}if(i>=y){n(r,`array(${t.length})`);return}if(!n(r,`array(${t.length})`))return;g(t[0],`${r}[0]`,i+1);return}const m=t,o=Object.keys(m);if(o.length===0){n(r,"object(empty)");return}if(i>=y){n(r,`object(keys=${o.length})`);return}if(!n(r,"object"))return;for(const s of o){if(u)return;const O=k(s)?`${r}.${s}`:`${r}[${JSON.stringify(s)}]`;g(m[s],O,i+1)}};g(f,j,0);return c}function k(f){return/^[A-Za-z_$][\w$]*$/.test(f)}

package/dist/src/browser/stealth.js

@@ -1,4 +1,4 @@
-let j;const k=`
+let e;const t=`
     (function () {
       try {
         var _ep = EventTarget.prototype;
@@ -35,7 +35,7 @@ let j;const k=`
         }
       } catch (e) {}
     })();
-`;export function generateBeforeUnloadGuardJs(){return k}export function generateStealthJs(){if(j!==void 0)return j;return j=`
+`;export function generateBeforeUnloadGuardJs(){return t}export function generateStealthJs(){if(e!==void 0)return e;return e=`
     (() => {
       // Guard: prevent double-injection across separate CDP evaluations.
       // We cannot use a closure variable (each eval is a fresh scope), and
@@ -384,7 +384,7 @@ let j;const k=`
       //     so no dialog can ever open. Injected on every navigation, covering
       //     post, reply, and reads uniformly; page.goto() also runs the same
       //     snippet before navigating away to cover the current document.
-      ${k}
+      ${t}
 
       return 'applied';
     })()

package/dist/src/browser/tabs.js

@@ -1,2 +1,2 @@
-export function extractTabEntries(q){if(Array.isArray(q))return q.map((j,p)=>({index:p,identity:[j?.id??"",j?.url??"",j?.title??"",j?.name??""].join("|")}));if(typeof q==="string")return q.split(`
-`).map((j)=>j.trim()).filter(Boolean).map((j)=>{const p=j.match(/^-\s+(\d+):\s*(.*)$/);if(p)return{index:parseInt(p[1],10),identity:p[2].trim()||`tab-${p[1]}`};const v=j.match(/Tab\s+(\d+)\s*(.*)$/);if(v)return{index:parseInt(v[1],10),identity:v[2].trim()||`tab-${v[1]}`};return null}).filter((j)=>j!==null);return[]}export function extractTabIdentities(q){return extractTabEntries(q).map((j)=>j.identity)}export function diffTabIndexes(q,j){if(q.length===0||j.length===0)return[];const p=new Map;for(const z of q)p.set(z,(p.get(z)??0)+1);const v=[];for(const z of j){const A=p.get(z.identity)??0;if(A>0){p.set(z.identity,A-1);continue}v.push(z.index)}return v.sort((z,A)=>A-z)}export function appendLimited(q,j,p){const v=q+j;if(v.length<=p)return v;return v.slice(-p)}
+export function extractTabEntries(e){if(Array.isArray(e))return e.map((t,n)=>({index:n,identity:[t?.id??"",t?.url??"",t?.title??"",t?.name??""].join("|")}));if(typeof e==="string")return e.split(`
+`).map((t)=>t.trim()).filter(Boolean).map((t)=>{const n=t.match(/^-\s+(\d+):\s*(.*)$/);if(n)return{index:parseInt(n[1],10),identity:n[2].trim()||`tab-${n[1]}`};const i=t.match(/Tab\s+(\d+)\s*(.*)$/);if(i)return{index:parseInt(i[1],10),identity:i[2].trim()||`tab-${i[1]}`};return null}).filter((t)=>t!==null);return[]}export function extractTabIdentities(e){return extractTabEntries(e).map((t)=>t.identity)}export function diffTabIndexes(e,t){if(e.length===0||t.length===0)return[];const n=new Map;for(const r of e)n.set(r,(n.get(r)??0)+1);const i=[];for(const r of t){const o=n.get(r.identity)??0;if(o>0){n.set(r.identity,o-1);continue}i.push(r.index)}return i.sort((r,o)=>o-r)}export function appendLimited(e,t,n){const i=e+t;if(i.length<=n)return i;return i.slice(-n)}

package/dist/src/browser/target-errors.js

@@ -1 +1 @@
-export class TargetError extends Error{code;hint;candidates;matches_n;constructor(b){super(b.message);this.name="TargetError";this.code=b.code;this.hint=b.hint;this.candidates=b.candidates;this.matches_n=b.matches_n}toJSON(){return{code:this.code,message:this.message,hint:this.hint,...this.candidates&&{candidates:this.candidates},...this.matches_n!==void 0&&{matches_n:this.matches_n}}}}
+export class TargetError extends Error{code;hint;candidates;matches_n;constructor(t){super(t.message);this.name="TargetError";this.code=t.code;this.hint=t.hint;this.candidates=t.candidates;this.matches_n=t.matches_n}toJSON(){return{code:this.code,message:this.message,hint:this.hint,...this.candidates&&{candidates:this.candidates},...this.matches_n!==void 0&&{matches_n:this.matches_n}}}}

package/dist/src/browser/target-resolver.js

@@ -1,8 +1,8 @@
-export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void 0?String(g.nth|0):"null",y=g.firstOnMulti===!0?"true":"false";return`
+export function resolveTargetJs(t,e={}){const r=JSON.stringify(t),n=e.nth!==void 0?String(e.nth|0):"null",o=e.firstOnMulti===!0?"true":"false";return`
     (() => {
-      const ref = ${q};
-      const nth = ${w};
-      const firstOnMulti = ${y};
+      const ref = ${r};
+      const nth = ${n};
+      const firstOnMulti = ${o};
       const identity = window.__opencli_ref_identity || {};
 
       // ── Classify input ──
@@ -215,13 +215,13 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
         return { ok: true, matches_n: matches.length, match_level: 'exact' };
       }
     })()
-  `}export function boundingRectResolvedJs(j={}){const g=j.skipScroll?"false":"true",q=j.forClick?"true":"false";return`
+  `}export function boundingRectResolvedJs(t={}){const e=t.skipScroll?"false":"true",r=t.forClick?"true":"false";return`
     (() => {
       const el = window.__resolved;
       if (!el) throw new Error('No resolved element');
-      if (${g}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+      if (${e}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
 
-      const FOR_CLICK = ${q};
+      const FOR_CLICK = ${r};
       // hover()/dblClick() want the plain element centre — the retarget + hit-test
       // below are click-only so those actions keep their original behaviour.
       if (!FOR_CLICK) {
@@ -322,11 +322,11 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
       }
       return { x, y, w, h, visible, hit, retargeted };
     })()
-  `}export function clickResolvedJs(j={}){return`
+  `}export function clickResolvedJs(t={}){return`
     (() => {
       const el = window.__resolved;
       if (!el) throw new Error('No resolved element');
-      if (${j.skipScroll?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+      if (${t.skipScroll?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
       const rect = el.getBoundingClientRect();
       const x = Math.round(rect.left + rect.width / 2);
       const y = Math.round(rect.top + rect.height / 2);
@@ -337,7 +337,7 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
         return { status: 'js_failed', x, y, w: Math.round(rect.width), h: Math.round(rect.height), error: e.message };
       }
     })()
-  `}export function typeResolvedJs(j){const g=JSON.stringify(j);return`
+  `}export function typeResolvedJs(t){const e=JSON.stringify(t);return`
     (() => {
       const el = window.__resolved;
       if (!el) throw new Error('No resolved element');
@@ -349,7 +349,7 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
         sel.removeAllRanges();
         sel.addRange(range);
         document.execCommand('delete', false);
-        document.execCommand('insertText', false, ${g});
+        document.execCommand('insertText', false, ${e});
         el.dispatchEvent(new Event('input', { bubbles: true }));
       } else {
         const proto = el instanceof HTMLTextAreaElement
@@ -357,16 +357,16 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
           : HTMLInputElement.prototype;
         const nativeSetter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
         if (nativeSetter) {
-          nativeSetter.call(el, ${g});
+          nativeSetter.call(el, ${e});
         } else {
-          el.value = ${g};
+          el.value = ${e};
         }
         el.dispatchEvent(new Event('input', { bubbles: true }));
         el.dispatchEvent(new Event('change', { bubbles: true }));
       }
       return 'typed';
     })()
-  `}export function prepareNativeTypeResolvedJs(j={}){const g=j.skipScroll?"false":"true",q=j.skipFocus?"false":"true";return`
+  `}export function prepareNativeTypeResolvedJs(t={}){const e=t.skipScroll?"false":"true",r=t.skipFocus?"false":"true";return`
     (() => {
       const original = window.__resolved;
       if (!original) throw new Error('No resolved element');
@@ -396,8 +396,8 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
       }
 
       window.__resolved = el;
-      if (${g}) el.scrollIntoView({ behavior: 'instant', block: 'center', inline: 'nearest' });
-      if (${q}) {
+      if (${e}) el.scrollIntoView({ behavior: 'instant', block: 'center', inline: 'nearest' });
+      if (${r}) {
         try {
           el.focus({ preventScroll: true });
         } catch (_) {
@@ -433,7 +433,7 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
         ? { ok: true, mode: isTextarea ? 'textarea' : 'input' }
         : { ok: false, reason: 'selection_unavailable', mode: isTextarea ? 'textarea' : 'input' };
     })()
-  `}export function verifyFilledResolvedJs(j){const g=JSON.stringify(j);return`
+  `}export function verifyFilledResolvedJs(t){const e=JSON.stringify(t);return`
     (() => {
       const el = window.__resolved;
       if (!el) return { ok: false, reason: 'no_resolved_element' };
@@ -460,18 +460,18 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
 
       const actual = mode === 'contenteditable' ? (el.innerText || '') : String(el.value || '');
       return {
-        ok: actual === ${g},
+        ok: actual === ${e},
         actual,
-        expected: ${g},
+        expected: ${e},
         length: actual.length,
         mode,
       };
     })()
-  `}export function scrollResolvedJs(j={}){return`
+  `}export function scrollResolvedJs(t={}){return`
     (() => {
       const el = window.__resolved;
       if (!el) throw new Error('No resolved element');
-      if (${j.skipScroll?"false":"true"}) el.scrollIntoView({ behavior: 'smooth', block: 'center', inline: 'nearest' });
+      if (${t.skipScroll?"false":"true"}) el.scrollIntoView({ behavior: 'smooth', block: 'center', inline: 'nearest' });
       return { scrolled: true, tag: el.tagName.toLowerCase(), text: (el.textContent || '').trim().slice(0, 80) };
     })()
   `}export function getTextResolvedJs(){return`
@@ -492,12 +492,12 @@ export function resolveTargetJs(j,g={}){const q=JSON.stringify(j),w=g.nth!==void
       if (!el) throw new Error('No resolved element');
       return JSON.stringify(Object.fromEntries([...el.attributes].map(a => [a.name, a.value])));
     })()
-  `}export function selectResolvedJs(j){const g=JSON.stringify(j);return`
+  `}export function selectResolvedJs(t){const e=JSON.stringify(t);return`
     (() => {
       const el = window.__resolved;
       if (!el) throw new Error('No resolved element');
       if (el.tagName !== 'SELECT') return { error: 'Not a <select>' };
-      const match = Array.from(el.options).find(o => o.text.trim() === ${g} || o.value === ${g});
+      const match = Array.from(el.options).find(o => o.text.trim() === ${e} || o.value === ${e});
       if (!match) return { error: 'Option not found', available: Array.from(el.options).map(o => o.text.trim()) };
       const setter = Object.getOwnPropertyDescriptor(HTMLSelectElement.prototype, 'value')?.set;
       if (setter) setter.call(el, match.value); else el.value = match.value;

package/dist/src/browser/trace.js

@@ -1,2 +1,2 @@
-import{appendFileSync as N}from"node:fs";import{log as O}from"../logger.js";const H=process.env.OPENCLI_BROWSER_TRACE_FILE?.trim(),B=!!H;let J=!1;function G(q){if(!B)return;try{N(H,JSON.stringify({t:Date.now(),...q})+`
-`)}catch(z){if(!J){J=!0;O.warn(`[trace] failed to write browser trace to ${H}: ${z instanceof Error?z.message:String(z)} (further trace errors suppressed)`)}}}function Q(q,z){if(q!=="navigate"||typeof z!=="string"||!z)return;try{const D=new URL(z);return D.origin+D.pathname}catch{return}}export function traceDispatch(q){if(!B)return;G({ev:"dispatch",id:typeof q.id==="string"?q.id:void 0,action:typeof q.action==="string"?q.action:"unknown",ctx:typeof q.contextId==="string"?q.contextId:void 0,session:typeof q.session==="string"?q.session:void 0,surface:typeof q.surface==="string"?q.surface:void 0,url:Q(q.action,q.url)})}export function traceResult(q,z,D,K,M){if(!B)return;G({ev:"result",id:q,ok:z,ms:D,errorCode:K,page:M})}export function traceTimeout(q,z,D){if(!B)return;G({ev:"timeout",id:q,ms:z,action:D})}export function traceExtConnect(q,z){if(!B)return;G({ev:"ext-connect",ctx:q,extVersion:z??void 0})}export function traceExtDisconnect(q){if(!B)return;G({ev:"ext-disconnect",ctx:q})}export function traceExtLog(q,z){if(!B)return;G({ev:"ext-log",level:q,msg:z})}
+import{appendFileSync as u}from"node:fs";import{log as a}from"../logger.js";const c=process.env.OPENCLI_BROWSER_TRACE_FILE?.trim(),n=!!c;let o=!1;function i(e){if(!n)return;try{u(c,JSON.stringify({t:Date.now(),...e})+`
+`)}catch(t){if(!o){o=!0;a.warn(`[trace] failed to write browser trace to ${c}: ${t instanceof Error?t.message:String(t)} (further trace errors suppressed)`)}}}function p(e,t){if(e!=="navigate"||typeof t!=="string"||!t)return;try{const r=new URL(t);return r.origin+r.pathname}catch{return}}export function traceDispatch(e){if(!n)return;i({ev:"dispatch",id:typeof e.id==="string"?e.id:void 0,action:typeof e.action==="string"?e.action:"unknown",ctx:typeof e.contextId==="string"?e.contextId:void 0,session:typeof e.session==="string"?e.session:void 0,surface:typeof e.surface==="string"?e.surface:void 0,url:p(e.action,e.url)})}export function traceResult(e,t,r,f,s){if(!n)return;i({ev:"result",id:e,ok:t,ms:r,errorCode:f,page:s})}export function traceTimeout(e,t,r){if(!n)return;i({ev:"timeout",id:e,ms:t,action:r})}export function traceExtConnect(e,t){if(!n)return;i({ev:"ext-connect",ctx:e,extVersion:t??void 0})}export function traceExtDisconnect(e){if(!n)return;i({ev:"ext-disconnect",ctx:e})}export function traceExtLog(e,t){if(!n)return;i({ev:"ext-log",level:e,msg:t})}

package/dist/src/browser/utils.js

@@ -1 +1 @@
-function G(q){return q instanceof Error?q.message:String(q)}export function serializeFunctionForEval(q,k=[]){const B=q.toString().trim();if(!(/^(async\s+)?function[\s(]/.test(B)||/^(async\s*)?(\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>/.test(B))||B.includes("[native code]"))throw Error("page.evaluate(fn) requires a serializable arrow/function expression");let C;try{C=JSON.stringify(k)}catch(D){throw Error(`page.evaluate arguments must be JSON-serializable: ${G(D)}`)}if(C===void 0)throw Error("page.evaluate arguments must be JSON-serializable");return`(${B})(...${C})`}export function wrapForEval(q){if(typeof q!=="string")return"undefined";const k=q.trim();if(!k)return"undefined";if(/^\([\s\S]*\)\s*\(.*\)\s*$/.test(k))return k;if(/^(async\s+)?(\([^)]*\)|[A-Za-z_]\w*)\s*=>/.test(k))return`(${k})()`;if(/^(async\s+)?function[\s(]/.test(k))return`(${k})()`;return k}export function buildEvaluateExpression(q,k=[]){if(typeof q==="function")return serializeFunctionForEval(q,k);if(k.length>0)throw Error("page.evaluate string input does not accept args; use page.evaluate(fn, ...args) instead");return wrapForEval(q)}
+function i(r){return r instanceof Error?r.message:String(r)}export function serializeFunctionForEval(r,e=[]){const t=r.toString().trim();if(!(/^(async\s+)?function[\s(]/.test(t)||/^(async\s*)?(\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>/.test(t))||t.includes("[native code]"))throw Error("page.evaluate(fn) requires a serializable arrow/function expression");let n;try{n=JSON.stringify(e)}catch(s){throw Error(`page.evaluate arguments must be JSON-serializable: ${i(s)}`)}if(n===void 0)throw Error("page.evaluate arguments must be JSON-serializable");return`(${t})(...${n})`}export function wrapForEval(r){if(typeof r!=="string")return"undefined";const e=r.trim();if(!e)return"undefined";if(/^\([\s\S]*\)\s*\(.*\)\s*$/.test(e))return e;if(/^(async\s+)?(\([^)]*\)|[A-Za-z_]\w*)\s*=>/.test(e))return`(${e})()`;if(/^(async\s+)?function[\s(]/.test(e))return`(${e})()`;return e}export function buildEvaluateExpression(r,e=[]){if(typeof r==="function")return serializeFunctionForEval(r,e);if(e.length>0)throw Error("page.evaluate string input does not accept args; use page.evaluate(fn, ...args) instead");return wrapForEval(r)}

package/dist/src/browser/verify-fixture.js

@@ -1,2 +1,2 @@
-import*as O from"node:fs";import*as b from"node:os";import*as M from"node:path";const I=12,K=1,S=[/^id$/i,/_id$/i,/Id$/,/^short_id$/i,/^bvid$/i,/^aid$/i,/^tid$/i,/^asin$/i,/^sku$/i,/^isbn$/i,/^doi$/i,/^slug$/i,/^hn_id$/i,/^username$/i,/^handle$/i,/^uri$/i];export function fixturePath(z,G){return M.join(b.homedir(),".ppcli","sites",z,"verify",`${G}.json`)}export function loadFixture(z,G){const q=fixturePath(z,G);if(!O.existsSync(q))return null;try{const B=O.readFileSync(q,"utf-8");return JSON.parse(B)}catch(B){throw Error(`Failed to parse fixture ${q}: ${B instanceof Error?B.message:String(B)}`)}}export function writeFixture(z,G,q){const B=fixturePath(z,G);O.mkdirSync(M.dirname(B),{recursive:!0});O.writeFileSync(B,`${JSON.stringify(q,null,2)}
-`,"utf-8");return B}export function deriveFixture(z,G){const q={};if(z.length===0){q.rowCount={min:0};return{...G?{args:G}:{},expect:q}}q.rowCount={min:1};const B=z[0],Z=Object.keys(B);q.columns=Z;const R={};for(const V of Z){const F=new Set;for(const H of z){const Q=H[V];F.add(j(Q))}R[V]=[...F].sort().join("|")}q.types=R;return{...G?{args:G}:{},expect:q}}export function validateRows(z,G){const q=[],B=G.expect;if(!B)return q;if(B.rowCount){const{min:Q,max:W}=B.rowCount;if(typeof Q==="number"&&z.length<Q)q.push({rule:"rowCount",detail:`got ${z.length} rows, expected at least ${Q}`});if(typeof W==="number"&&z.length>W)q.push({rule:"rowCount",detail:`got ${z.length} rows, expected at most ${W}`})}const Z=B.columns??[],R=B.types??{},V=B.patterns??{},F=B.notEmpty??[],H={};for(const[Q,W]of Object.entries(V))try{H[Q]=new RegExp(W)}catch(J){q.push({rule:"pattern",detail:`pattern for "${Q}" invalid: ${J instanceof Error?J.message:String(J)}`})}z.forEach((Q,W)=>{for(const J of Z)if(!(J in Q))q.push({rule:"column",detail:`missing column "${J}"`,rowIndex:W});for(const[J,$]of Object.entries(R)){if(!(J in Q))continue;const C=j(Q[J]);if(!A(C,$))q.push({rule:"type",detail:`"${J}" is ${C}, expected ${$}`,rowIndex:W})}for(const[J,$]of Object.entries(H)){if(!(J in Q))continue;const C=Q[J];if(C===null||C===void 0)continue;if(!$.test(String(C)))q.push({rule:"pattern",detail:`"${J}"=${JSON.stringify(String(C).slice(0,60))} does not match /${$.source}/`,rowIndex:W})}for(const J of F){const $=Q[J];if($===null||$===void 0||String($).trim()==="")q.push({rule:"notEmpty",detail:`"${J}" is empty`,rowIndex:W})}for(const[J,$]of Object.entries(B.mustNotContain??{})){if(!(J in Q))continue;const C=Q[J];if(C===null||C===void 0)continue;const N=String(C);for(const Y of $)if(N.includes(Y))q.push({rule:"mustNotContain",detail:`"${J}" contains forbidden substring ${JSON.stringify(Y)}`,rowIndex:W})}for(const J of B.mustBeTruthy??[]){if(!(J in Q))continue;if(!Q[J])q.push({rule:"mustBeTruthy",detail:`"${J}" is falsy (${JSON.stringify(Q[J])}) — likely silent fallback`,rowIndex:W})}});return q}export function validateRowShape(z,G={}){const q=[],B=G.maxTopLevelKeys??I,Z=G.maxNestedDepth??K;z.forEach((R,V)=>{const F=Object.keys(R);if(F.length>B)q.push({rule:"shapeKeyCount",detail:`row has ${F.length} top-level keys, expected at most ${B}`,rowIndex:V});for(const[H,Q]of Object.entries(R)){const W=U(Q);if(W>Z)q.push({rule:"shapeDepth",detail:`"${H}" nesting depth is ${W}, expected at most ${Z}`,rowIndex:V});for(const J of X(Q,H))q.push({rule:"shapeNestedId",detail:`id-shaped field "${J}" must be a top-level row key`,rowIndex:V})}});return q}export function expandFixtureArgs(z){if(!z)return[];if(Array.isArray(z))return z.map((q)=>String(q));const G=[];for(const[q,B]of Object.entries(z))G.push(`--${q}`,String(B));return G}export function parseSeedArgs(z){if(z===void 0)return;const G=z.trim();if(!G)return;try{const q=JSON.parse(G);if(Array.isArray(q))return q;if(q!==null&&typeof q==="object")return q;return[q]}catch{return[z]}}function j(z){if(z===null)return"null";if(Array.isArray(z))return"array";return typeof z}function U(z){if(z===null||z===void 0||typeof z!=="object")return 0;if(Array.isArray(z)){if(z.length===0)return 1;return 1+Math.max(...z.map(U))}const G=Object.values(z);if(G.length===0)return 1;return 1+Math.max(...G.map(U))}function X(z,G){if(z===null||z===void 0||typeof z!=="object")return[];const q=[];if(Array.isArray(z)){z.forEach((B,Z)=>{q.push(...X(B,`${G}[${Z}]`))});return q}for(const[B,Z]of Object.entries(z)){const R=`${G}.${B}`;if(L(B))q.push(R);q.push(...X(Z,R))}return q}function L(z){return S.some((G)=>G.test(z))}function A(z,G){const q=G.split("|").map((B)=>B.trim()).filter(Boolean);if(q.length===0)return!0;if(q.includes("any"))return!0;return q.includes(z)}
+import*as h from"node:fs";import*as E from"node:os";import*as g from"node:path";const A=12,j=1,O=[/^id$/i,/_id$/i,/Id$/,/^short_id$/i,/^bvid$/i,/^aid$/i,/^tid$/i,/^asin$/i,/^sku$/i,/^isbn$/i,/^doi$/i,/^slug$/i,/^hn_id$/i,/^username$/i,/^handle$/i,/^uri$/i];export function fixturePath(e,r){return g.join(E.homedir(),".ppcli","sites",e,"verify",`${r}.json`)}export function loadFixture(e,r){const t=fixturePath(e,r);if(!h.existsSync(t))return null;try{const n=h.readFileSync(t,"utf-8");return JSON.parse(n)}catch(n){throw Error(`Failed to parse fixture ${t}: ${n instanceof Error?n.message:String(n)}`)}}export function writeFixture(e,r,t){const n=fixturePath(e,r);h.mkdirSync(g.dirname(n),{recursive:!0});h.writeFileSync(n,`${JSON.stringify(t,null,2)}
+`,"utf-8");return n}export function deriveFixture(e,r){const t={};if(e.length===0){t.rowCount={min:0};return{...r?{args:r}:{},expect:t}}t.rowCount={min:1};const n=e[0],c=Object.keys(n);t.columns=c;const l={};for(const a of c){const d=new Set;for(const p of e){const i=p[a];d.add(S(i))}l[a]=[...d].sort().join("|")}t.types=l;return{...r?{args:r}:{},expect:t}}export function validateRows(e,r){const t=[],n=r.expect;if(!n)return t;if(n.rowCount){const{min:i,max:s}=n.rowCount;if(typeof i==="number"&&e.length<i)t.push({rule:"rowCount",detail:`got ${e.length} rows, expected at least ${i}`});if(typeof s==="number"&&e.length>s)t.push({rule:"rowCount",detail:`got ${e.length} rows, expected at most ${s}`})}const c=n.columns??[],l=n.types??{},a=n.patterns??{},d=n.notEmpty??[],p={};for(const[i,s]of Object.entries(a))try{p[i]=new RegExp(s)}catch(o){t.push({rule:"pattern",detail:`pattern for "${i}" invalid: ${o instanceof Error?o.message:String(o)}`})}e.forEach((i,s)=>{for(const o of c)if(!(o in i))t.push({rule:"column",detail:`missing column "${o}"`,rowIndex:s});for(const[o,u]of Object.entries(l)){if(!(o in i))continue;const f=S(i[o]);if(!k(f,u))t.push({rule:"type",detail:`"${o}" is ${f}, expected ${u}`,rowIndex:s})}for(const[o,u]of Object.entries(p)){if(!(o in i))continue;const f=i[o];if(f===null||f===void 0)continue;if(!u.test(String(f)))t.push({rule:"pattern",detail:`"${o}"=${JSON.stringify(String(f).slice(0,60))} does not match /${u.source}/`,rowIndex:s})}for(const o of d){const u=i[o];if(u===null||u===void 0||String(u).trim()==="")t.push({rule:"notEmpty",detail:`"${o}" is empty`,rowIndex:s})}for(const[o,u]of Object.entries(n.mustNotContain??{})){if(!(o in i))continue;const f=i[o];if(f===null||f===void 0)continue;const b=String(f);for(const x of u)if(b.includes(x))t.push({rule:"mustNotContain",detail:`"${o}" contains forbidden substring ${JSON.stringify(x)}`,rowIndex:s})}for(const o of n.mustBeTruthy??[]){if(!(o in i))continue;if(!i[o])t.push({rule:"mustBeTruthy",detail:`"${o}" is falsy (${JSON.stringify(i[o])}) — likely silent fallback`,rowIndex:s})}});return t}export function validateRowShape(e,r={}){const t=[],n=r.maxTopLevelKeys??A,c=r.maxNestedDepth??j;e.forEach((l,a)=>{const d=Object.keys(l);if(d.length>n)t.push({rule:"shapeKeyCount",detail:`row has ${d.length} top-level keys, expected at most ${n}`,rowIndex:a});for(const[p,i]of Object.entries(l)){const s=y(i);if(s>c)t.push({rule:"shapeDepth",detail:`"${p}" nesting depth is ${s}, expected at most ${c}`,rowIndex:a});for(const o of m(i,p))t.push({rule:"shapeNestedId",detail:`id-shaped field "${o}" must be a top-level row key`,rowIndex:a})}});return t}export function expandFixtureArgs(e){if(!e)return[];if(Array.isArray(e))return e.map((t)=>String(t));const r=[];for(const[t,n]of Object.entries(e))r.push(`--${t}`,String(n));return r}export function parseSeedArgs(e){if(e===void 0)return;const r=e.trim();if(!r)return;try{const t=JSON.parse(r);if(Array.isArray(t))return t;if(t!==null&&typeof t==="object")return t;return[t]}catch{return[e]}}function S(e){if(e===null)return"null";if(Array.isArray(e))return"array";return typeof e}function y(e){if(e===null||e===void 0||typeof e!=="object")return 0;if(Array.isArray(e)){if(e.length===0)return 1;return 1+Math.max(...e.map(y))}const r=Object.values(e);if(r.length===0)return 1;return 1+Math.max(...r.map(y))}function m(e,r){if(e===null||e===void 0||typeof e!=="object")return[];const t=[];if(Array.isArray(e)){e.forEach((n,c)=>{t.push(...m(n,`${r}[${c}]`))});return t}for(const[n,c]of Object.entries(e)){const l=`${r}.${n}`;if(I(n))t.push(l);t.push(...m(c,l))}return t}function I(e){return O.some((r)=>r.test(e))}function k(e,r){const t=r.split("|").map((n)=>n.trim()).filter(Boolean);if(t.length===0)return!0;if(t.includes("any"))return!0;return t.includes(e)}

package/dist/src/browser-session-lock.js

@@ -1 +1 @@
-import{openSync as q,closeSync as H,writeSync as b,readFileSync as j,unlinkSync as Y,statSync as v,mkdirSync as D,utimesSync as Q}from"node:fs";import{join as N}from"node:path";import{homedir as F}from"node:os";const V=N(F(),".ppcli"),Z=N(V,"browser-adapter-session.lock");function m(z){if(!z)return Z;const x=z.replace(/[^A-Za-z0-9_-]/g,"_");return N(V,`browser-adapter-session.${x}.lock`)}const W=180000,$=600000,u=60;function w(z){return new Promise((x)=>setTimeout(x,z))}function K(z){try{process.kill(z,0);return!0}catch(x){return x?.code==="EPERM"}}function U(z){try{const x=parseInt(j(z,"utf8").trim(),10);return Number.isFinite(x)?x:null}catch{return null}}function g(z){try{const x=q(z,"wx");try{b(x,String(process.pid))}finally{H(x)}return!0}catch(x){if(x?.code==="EEXIST")return!1;throw x}}function C(z){try{const x=U(z),G=Date.now()-v(z).mtimeMs;if(x!==null&&!K(x)||G>$)Y(z)}catch{}}export async function withBrowserSessionLock(z,x){try{D(V,{recursive:!0})}catch{}const G=m(x),B=Date.now()+W;while(!g(G)){C(G);if(g(G))break;if(Date.now()>=B)throw Error(`browser session lock busy: waited ${Math.round(W/1000)}s for another browser command to finish`);await w(u)}const J=setInterval(()=>{try{const X=new Date;Q(G,X,X)}catch{}},60000);if(typeof J.unref==="function")J.unref();try{return await z()}finally{clearInterval(J);try{Y(G)}catch{}}}export async function withBrowserSessionLockIf(z,x,G){return z?withBrowserSessionLock(x,G):x()}export const __lockInternals={LOCK_PATH:Z,ACQUIRE_TIMEOUT_MS:W,STALE_AFTER_MS:$};
+import{openSync as w,closeSync as p,writeSync as d,readFileSync as h,unlinkSync as a,statSync as m,mkdirSync as S,utimesSync as _}from"node:fs";import{join as o}from"node:path";import{homedir as k}from"node:os";const c=o(k(),".ppcli"),u=o(c,"browser-adapter-session.lock");function E(r){if(!r)return u;const t=r.replace(/[^A-Za-z0-9_-]/g,"_");return o(c,`browser-adapter-session.${t}.lock`)}const i=180000,l=600000,I=60;function L(r){return new Promise((t)=>setTimeout(t,r))}function b(r){try{process.kill(r,0);return!0}catch(t){return t?.code==="EPERM"}}function A(r){try{const t=parseInt(h(r,"utf8").trim(),10);return Number.isFinite(t)?t:null}catch{return null}}function f(r){try{const t=w(r,"wx");try{d(t,String(process.pid))}finally{p(t)}return!0}catch(t){if(t?.code==="EEXIST")return!1;throw t}}function M(r){try{const t=A(r),n=Date.now()-m(r).mtimeMs;if(t!==null&&!b(t)||n>l)a(r)}catch{}}export async function withBrowserSessionLock(r,t){try{S(c,{recursive:!0})}catch{}const n=E(t),y=Date.now()+i;while(!f(n)){M(n);if(f(n))break;if(Date.now()>=y)throw Error(`browser session lock busy: waited ${Math.round(i/1000)}s for another browser command to finish`);await L(I)}const e=setInterval(()=>{try{const s=new Date;_(n,s,s)}catch{}},60000);if(typeof e.unref==="function")e.unref();try{return await r()}finally{clearInterval(e);try{a(n)}catch{}}}export async function withBrowserSessionLockIf(r,t,n){return r?withBrowserSessionLock(t,n):t()}export const __lockInternals={LOCK_PATH:u,ACQUIRE_TIMEOUT_MS:i,STALE_AFTER_MS:l};

package/dist/src/build-manifest.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import*as V from"node:fs";import*as $ from"node:path";import{fileURLToPath as A,pathToFileURL as L}from"node:url";import{getErrorMessage as O}from"./errors.js";import{fullName as C,getRegistry as b}from"./registry.js";import{findPackageRoot as k,getCliManifestPath as E}from"./package-paths.js";import{isRecord as U}from"./utils.js";const j=k(A(import.meta.url)),w=$.join(j,"clis"),H=E(w),I=/\bcli\s*\(|\bregisterSiteAuthCommands\s*\(|\bregisterArticleLogin\s*\(|\bregisterTokenAuth\s*\(|\bmake[A-Z]\w*Command\s*\(/;export class ManifestImportError extends Error{filePath;cause;constructor(q,J){super(`failed to scan ${q}: ${O(J)}`);this.filePath=q;this.cause=J;this.name="ManifestImportError"}}function T(q){return q.map((J)=>({name:J.name,type:J.type??"str",default:J.default,required:!!J.required,valueRequired:!!J.valueRequired||void 0,positional:J.positional||void 0,help:J.help??"",choices:J.choices,fromFile:J.fromFile||void 0,requiredUnlessFile:J.requiredUnlessFile||void 0,generatedFileFor:J.generatedFileFor||void 0}))}function D(q,J){const W=$.basename(q,$.extname(q));return`${J}/${W}.js`}export function normalizeManifestPath(q){return q.replace(/\\/g,"/")}function M(q,J){return normalizeManifestPath($.relative(J,q))}function y(q,J){return U(q)&&typeof q.site==="string"&&q.site===J&&typeof q.name==="string"&&(q.access==="read"||q.access==="write")&&Array.isArray(q.args)}function R(q,J,W){return{site:q.site,name:q.name,aliases:q.aliases,description:q.description??"",access:q.access,example:q.example,domain:q.domain,strategy:(q.strategy??"public").toString().toLowerCase(),browser:q.browser??!0,args:T(q.args),columns:q.columns,defaultFormat:q.defaultFormat,type:"js",modulePath:J,sourceFile:W,navigateBefore:q.navigateBefore,siteSession:q.siteSession,defaultWindowMode:q.defaultWindowMode}}export async function loadManifestEntries(q,J,W=(G)=>import(G),X=w){let G;try{G=V.readFileSync(q,"utf-8")}catch(Q){throw new ManifestImportError(q,Q)}if(!I.test(G))return[];try{const Q=D(q,J),Y=b(),Z=new Map(Y.entries()),F=await W(L(q).href),z=Object.values(U(F)?F:{}).filter((B)=>y(B,J)),N=z.length>0?z:[...Y.entries()].filter(([B,S])=>{if(S.site!==J)return!1;const x=Z.get(B);return!x||x!==S}).map(([,B])=>B),K=M(q,X),_=new Set;return N.filter((B)=>{const S=C(B);if(_.has(S))return!1;_.add(S);return!0}).sort((B,S)=>B.name.localeCompare(S.name)).map((B)=>R(B,Q,K))}catch(Q){throw new ManifestImportError(q,Q)}}export async function scanClisDir(q,J=(W)=>import(W)){const W=new Map,X=[];if(!V.existsSync(q))return{entries:[],failures:X};for(const Q of V.readdirSync(q)){const Y=$.join(q,Q);if(!V.statSync(Y).isDirectory())continue;for(const Z of V.readdirSync(Y))if(Z.endsWith(".js")&&!Z.endsWith(".d.js")&&!Z.endsWith(".test.js")&&Z!=="index.js"){const F=$.join(Y,Z);try{const z=await loadManifestEntries(F,Q,J,q);for(const N of z){const K=`${N.site}/${N.name}`;W.set(K,N)}}catch(z){if(z instanceof ManifestImportError){X.push(z);continue}throw z}}}return{entries:[...W.values()].sort((Q,Y)=>Q.site.localeCompare(Y.site)||Q.name.localeCompare(Y.name)),failures:X}}export async function buildManifest(){return scanClisDir(w)}export function serializeManifest(q){return`${JSON.stringify(q,null,2)}
-`}export function findManifestMetadataIssues(q){const J=[];for(const W of q){if(!Array.isArray(W.args))continue;for(const X of W.args){if(!X.positional)continue;if((typeof X.help==="string"?X.help.trim():"")==="")J.push({site:W.site,command:W.name,arg:X.name,sourceFile:W.sourceFile,reason:"positional arg missing non-empty `help` text"})}}return J}export function diffRemovedEntries(q,J){const W=new Set(J.map((X)=>`${X.site}/${X.name}`));return q.map((X)=>`${X.site}/${X.name}`).filter((X)=>!W.has(X)).sort()}export function parseBuildManifestArgs(q){let J=0;for(const W of q){if(W==="--allow-removals"){J=Number.POSITIVE_INFINITY;continue}const X=W.match(/^--allow-removals=(\d+)$/);if(X){J=Number.parseInt(X[1],10);continue}}return{allowRemovals:J}}function v(q){try{if(!V.existsSync(q))return null;const J=V.readFileSync(q,"utf-8"),W=JSON.parse(J);return Array.isArray(W)?W:null}catch{return null}}async function p(){if(A(import.meta.url).includes(`${$.sep}dist${$.sep}`)){process.stderr.write(`❌ Refusing to run build-manifest from dist/.
-`+"   Stale compiled output silently drops adapters that import renamed/removed exports.\n   Run `npm run build-manifest` (or `tsx src/build-manifest.ts`) from the source tree instead.\n");process.exit(1)}const q=parseBuildManifestArgs(process.argv.slice(2)),{entries:J,failures:W}=await buildManifest();if(W.length>0){process.stderr.write(`❌ ${W.length} adapter(s) failed to load:
-`);for(const Q of W){const Y=$.relative(j,Q.filePath)||Q.filePath;process.stderr.write(`  - ${Y}: ${O(Q.cause)}
+import*as c from"node:fs";import*as a from"node:path";import{fileURLToPath as x,pathToFileURL as S}from"node:url";import{getErrorMessage as F}from"./errors.js";import{fullName as R,getRegistry as A}from"./registry.js";import{findPackageRoot as C,getCliManifestPath as j}from"./package-paths.js";import{isRecord as M}from"./utils.js";const y=C(x(import.meta.url)),w=a.join(y,"clis"),h=j(w),k=/\bcli\s*\(|\bregisterSiteAuthCommands\s*\(|\bregisterArticleLogin\s*\(|\bregisterTokenAuth\s*\(|\bmake[A-Z]\w*Command\s*\(/;export class ManifestImportError extends Error{filePath;cause;constructor(e,t){super(`failed to scan ${e}: ${F(t)}`);this.filePath=e;this.cause=t;this.name="ManifestImportError"}}function I(e){return e.map((t)=>({name:t.name,type:t.type??"str",default:t.default,required:!!t.required,valueRequired:!!t.valueRequired||void 0,positional:t.positional||void 0,help:t.help??"",choices:t.choices,fromFile:t.fromFile||void 0,requiredUnlessFile:t.requiredUnlessFile||void 0,generatedFileFor:t.generatedFileFor||void 0}))}function N(e,t){const r=a.basename(e,a.extname(e));return`${t}/${r}.js`}export function normalizeManifestPath(e){return e.replace(/\\/g,"/")}function O(e,t){return normalizeManifestPath(a.relative(t,e))}function T(e,t){return M(e)&&typeof e.site==="string"&&e.site===t&&typeof e.name==="string"&&(e.access==="read"||e.access==="write")&&Array.isArray(e.args)}function E(e,t,r){return{site:e.site,name:e.name,aliases:e.aliases,description:e.description??"",access:e.access,example:e.example,domain:e.domain,strategy:(e.strategy??"public").toString().toLowerCase(),browser:e.browser??!0,args:I(e.args),columns:e.columns,defaultFormat:e.defaultFormat,type:"js",modulePath:t,sourceFile:r,navigateBefore:e.navigateBefore,siteSession:e.siteSession,defaultWindowMode:e.defaultWindowMode}}export async function loadManifestEntries(e,t,r=(u)=>import(u),n=w){let u;try{u=c.readFileSync(e,"utf-8")}catch(s){throw new ManifestImportError(e,s)}if(!k.test(u))return[];try{const s=N(e,t),o=A(),i=new Map(o.entries()),d=await r(S(e).href),l=Object.values(M(d)?d:{}).filter((f)=>T(f,t)),p=l.length>0?l:[...o.entries()].filter(([f,m])=>{if(m.site!==t)return!1;const v=i.get(f);return!v||v!==m}).map(([,f])=>f),g=O(e,n),b=new Set;return p.filter((f)=>{const m=R(f);if(b.has(m))return!1;b.add(m);return!0}).sort((f,m)=>f.name.localeCompare(m.name)).map((f)=>E(f,s,g))}catch(s){throw new ManifestImportError(e,s)}}export async function scanClisDir(e,t=(r)=>import(r)){const r=new Map,n=[];if(!c.existsSync(e))return{entries:[],failures:n};for(const s of c.readdirSync(e)){const o=a.join(e,s);if(!c.statSync(o).isDirectory())continue;for(const i of c.readdirSync(o))if(i.endsWith(".js")&&!i.endsWith(".d.js")&&!i.endsWith(".test.js")&&i!=="index.js"){const d=a.join(o,i);try{const l=await loadManifestEntries(d,s,t,e);for(const p of l){const g=`${p.site}/${p.name}`;r.set(g,p)}}catch(l){if(l instanceof ManifestImportError){n.push(l);continue}throw l}}}return{entries:[...r.values()].sort((s,o)=>s.site.localeCompare(o.site)||s.name.localeCompare(o.name)),failures:n}}export async function buildManifest(){return scanClisDir(w)}export function serializeManifest(e){return`${JSON.stringify(e,null,2)}
+`}export function findManifestMetadataIssues(e){const t=[];for(const r of e){if(!Array.isArray(r.args))continue;for(const n of r.args){if(!n.positional)continue;if((typeof n.help==="string"?n.help.trim():"")==="")t.push({site:r.site,command:r.name,arg:n.name,sourceFile:r.sourceFile,reason:"positional arg missing non-empty `help` text"})}}return t}export function diffRemovedEntries(e,t){const r=new Set(t.map((n)=>`${n.site}/${n.name}`));return e.map((n)=>`${n.site}/${n.name}`).filter((n)=>!r.has(n)).sort()}export function parseBuildManifestArgs(e){let t=0;for(const r of e){if(r==="--allow-removals"){t=Number.POSITIVE_INFINITY;continue}const n=r.match(/^--allow-removals=(\d+)$/);if(n){t=Number.parseInt(n[1],10);continue}}return{allowRemovals:t}}function P(e){try{if(!c.existsSync(e))return null;const t=c.readFileSync(e,"utf-8"),r=JSON.parse(t);return Array.isArray(r)?r:null}catch{return null}}async function L(){if(x(import.meta.url).includes(`${a.sep}dist${a.sep}`)){process.stderr.write(`❌ Refusing to run build-manifest from dist/.
+`+"   Stale compiled output silently drops adapters that import renamed/removed exports.\n   Run `npm run build-manifest` (or `tsx src/build-manifest.ts`) from the source tree instead.\n");process.exit(1)}const e=parseBuildManifestArgs(process.argv.slice(2)),{entries:t,failures:r}=await buildManifest();if(r.length>0){process.stderr.write(`❌ ${r.length} adapter(s) failed to load:
+`);for(const s of r){const o=a.relative(y,s.filePath)||s.filePath;process.stderr.write(`  - ${o}: ${F(s.cause)}
 `)}process.stderr.write(`
 Manifest NOT written. Likely cause: stale dist/ or a broken adapter import.
 Always run via tsx (\`npm run build-manifest\`), not against compiled dist/.
-`);process.exit(1)}const X=findManifestMetadataIssues(J);if(X.length>0){process.stderr.write(`❌ ${X.length} positional arg(s) missing \`help\` text:
-`);for(const Q of X){const Y=Q.sourceFile?` (${Q.sourceFile})`:"";process.stderr.write(`  - ${Q.site}/${Q.command} positional "${Q.arg}"${Y}
-`)}process.stderr.write("\nEvery positional arg must declare a non-empty `help` string so\n`ppcli <site> <cmd> --help` shows callers what the parameter is for.\nAdd `help: '...'` to each arg above and re-run the build.\n");process.exit(1)}const G=v(H);if(G){const Q=diffRemovedEntries(G,J);if(Q.length>q.allowRemovals){process.stderr.write(`❌ ${Q.length} manifest entries would be removed; refusing to overwrite.
-`);const Y=Q.slice(0,20);for(const Z of Y)process.stderr.write(`  - ${Z}
-`);if(Q.length>Y.length)process.stderr.write(`  ... ${Q.length-Y.length} more
+`);process.exit(1)}const n=findManifestMetadataIssues(t);if(n.length>0){process.stderr.write(`❌ ${n.length} positional arg(s) missing \`help\` text:
+`);for(const s of n){const o=s.sourceFile?` (${s.sourceFile})`:"";process.stderr.write(`  - ${s.site}/${s.command} positional "${s.arg}"${o}
+`)}process.stderr.write("\nEvery positional arg must declare a non-empty `help` string so\n`ppcli <site> <cmd> --help` shows callers what the parameter is for.\nAdd `help: '...'` to each arg above and re-run the build.\n");process.exit(1)}const u=P(h);if(u){const s=diffRemovedEntries(u,t);if(s.length>e.allowRemovals){process.stderr.write(`❌ ${s.length} manifest entries would be removed; refusing to overwrite.
+`);const o=s.slice(0,20);for(const i of o)process.stderr.write(`  - ${i}
+`);if(s.length>o.length)process.stderr.write(`  ... ${s.length-o.length} more
 `);process.stderr.write(`
-If this removal is intentional, rerun with \`--allow-removals=${Q.length}\` (or \`--allow-removals\` to disable the check).
-`);process.exit(1)}}V.mkdirSync($.dirname(H),{recursive:!0});V.writeFileSync(H,serializeManifest(J));console.log(`✅ Manifest compiled: ${J.length} entries → ${H}`);if(process.platform!=="win32"){const Q=j,Y=$.resolve(Q,"package.json");try{const Z=JSON.parse(V.readFileSync(Y,"utf-8")),F=typeof Z.bin==="string"?{[Z.name??"cli"]:Z.bin}:Z.bin??{};for(const z of Object.values(F)){const N=$.resolve(Q,z);if(V.existsSync(N)){V.chmodSync(N,493);console.log(`✅ Restored executable permission: ${z}`)}}}catch{}}}const P=process.argv[1]?L($.resolve(process.argv[1])).href:null;if(P===import.meta.url)p();
+If this removal is intentional, rerun with \`--allow-removals=${s.length}\` (or \`--allow-removals\` to disable the check).
+`);process.exit(1)}}c.mkdirSync(a.dirname(h),{recursive:!0});c.writeFileSync(h,serializeManifest(t));console.log(`✅ Manifest compiled: ${t.length} entries → ${h}`);if(process.platform!=="win32"){const s=y,o=a.resolve(s,"package.json");try{const i=JSON.parse(c.readFileSync(o,"utf-8")),d=typeof i.bin==="string"?{[i.name??"cli"]:i.bin}:i.bin??{};for(const l of Object.values(d)){const p=a.resolve(s,l);if(c.existsSync(p)){c.chmodSync(p,493);console.log(`✅ Restored executable permission: ${l}`)}}}catch{}}}const U=process.argv[1]?S(a.resolve(process.argv[1])).href:null;if(U===import.meta.url)L();

package/dist/src/capabilityRouting.js

@@ -1 +1 @@
-import{getRegisteredStepNames as C}from"./pipeline/registry.js";export const BROWSER_ONLY_STEPS=new Set(["navigate","click","type","fill","wait","press","snapshot","evaluate","intercept","tap"]);export function _validateBrowserOnlyStepsAgainstRegistry(){const k=new Set(C()),z=[];for(const A of BROWSER_ONLY_STEPS)if(!k.has(A))z.push(A);return{extras:z}}function D(k){return k.some((z)=>{if(!z||typeof z!=="object")return!1;return Object.keys(z).some((A)=>BROWSER_ONLY_STEPS.has(A))})}export function shouldUseBrowserSession(k){if(!k.browser)return!1;if(k.func)return!0;if(!k.pipeline||k.pipeline.length===0)return!0;if(k.navigateBefore)return!0;return D(k.pipeline)}
+import{getRegisteredStepNames as n}from"./pipeline/registry.js";export const BROWSER_ONLY_STEPS=new Set(["navigate","click","type","fill","wait","press","snapshot","evaluate","intercept","tap"]);export function _validateBrowserOnlyStepsAgainstRegistry(){const e=new Set(n()),t=[];for(const r of BROWSER_ONLY_STEPS)if(!e.has(r))t.push(r);return{extras:t}}function s(e){return e.some((t)=>{if(!t||typeof t!=="object")return!1;return Object.keys(t).some((r)=>BROWSER_ONLY_STEPS.has(r))})}export function shouldUseBrowserSession(e){if(!e.browser)return!1;if(e.func)return!0;if(!e.pipeline||e.pipeline.length===0)return!0;if(e.navigateBefore)return!0;return s(e.pipeline)}

package/dist/src/cli-argv-preprocess.js

@@ -1 +1 @@
-const K=new Set(["analyze","back","bind","check","click","close","console","dblclick","dialog","drag","eval","extract","fill","find","focus","frames","get","help","hover","init","keys","network","open","screenshot","scroll","select","state","tab","type","unbind","uncheck","upload","verify","wait"]),W=new Set(["--profile"]);export function getBrowserSubcommandNames(){return K}export function rewriteBrowserArgv(X){const H=[...X];let z=0;while(z<H.length){const Z=H[z];if(!Z.startsWith("-"))break;if(Z.includes("=")){z+=1;continue}if(W.has(Z)&&z+1<H.length)z+=2;else z+=1}if(H[z]!=="browser")return H;const J=z+1,Q=H[J];if(Q===void 0)return H;if(Q==="--session"||Q==="--session="||Q.startsWith("--session="))throw new BrowserSessionArgvError("The `--session` flag is no longer a public option. Use the positional form: ppcli browser <session> <command>");if(Q.startsWith("-"))return H;if(K.has(Q))return H;H.splice(J,1,"--session",Q);q(H,J+2);return H}function q(X,H){const z=X.findIndex((J,Q)=>Q>=H&&K.has(J));if(z===-1)return;for(let J=z+1;J<X.length;J+=1){const Q=X[J];if(Q==="--")return;if(Q.startsWith("--window=")){const Z=X.splice(J,1);X.splice(z,0,...Z);return}if(Q==="--window"){const Z=X[J+1];if(Z===void 0||Z==="--")return;const h=X.splice(J,2);X.splice(z,0,...h);return}}}export class BrowserSessionArgvError extends Error{constructor(X){super(X);this.name="BrowserSessionArgvError"}}function F(X){const H=new Map([["-h","none"],["--help","none"],["-v","none"],["--verbose","none"],["-f","required"],["--format","required"],["--trace","required"]]);if(X.browser){H.set("--window","required");H.set("--site-session","required");H.set("--keep-tab","required")}for(const z of X.args??[]){if(z.positional)continue;H.set(`--${z.name}`,z.required||z.valueRequired?"required":"optional")}return H}function y(X,H,z){const J=X[H];if(!J||J==="--")return null;const Q=J.indexOf("="),Z=Q===-1?J:J.slice(0,Q),h=z.get(Z);if(!h&&Q===-1&&J.startsWith("-")&&!J.startsWith("--")&&J.length>2){const V=J.slice(0,2);if(z.get(V)==="required")return{values:[J],nextIndex:H+1}}if(!h)return null;if(Q!==-1||h==="none")return{values:[J],nextIndex:H+1};const G=X[H+1];if(h==="required")return G===void 0?{values:[J],nextIndex:H+1}:{values:[J,G],nextIndex:H+2};if(G!==void 0&&!G.startsWith("-"))return{values:[J,G],nextIndex:H+2};return{values:[J],nextIndex:H+1}}export function escapeLeadingDashPositional(X,H){const z=[...X],J=new Map;for(const Y of H){const T=Y.args?.find((b)=>b.positional);if(T?.required||T?.requiredUnlessFile)J.set(Y.site+"/"+Y.name,Y)}let Q=0;while(Q<z.length){const Y=z[Q];if(!Y.startsWith("-"))break;if(Y.includes("=")){Q+=1;continue}if(W.has(Y)&&Q+1<z.length)Q+=2;else Q+=1}const Z=z[Q],h=z[Q+1],G=Q+2;if(!Z||!h||G>=z.length)return z;const V=J.get(Z+"/"+h);if(!V)return z;const D=F(V),C=[];let $=G;while($<z.length){const Y=z[$];if(Y==="--")return z;const T=y(z,$,D);if(T){C.push(...T.values);$=T.nextIndex;continue}if(!Y.startsWith("-"))return z;if(Y.startsWith("--"))return z;break}if($>=z.length)return z;const U=z[$],L=[],P=[];$+=1;while($<z.length){const Y=y(z,$,D);if(Y){L.push(...Y.values);$=Y.nextIndex;continue}P.push(z[$]);$+=1}return[...z.slice(0,G),...C,...L,"--",U,...P]}
+const h=new Set(["analyze","back","bind","check","click","close","console","dblclick","dialog","drag","eval","extract","fill","find","focus","frames","get","help","hover","init","keys","network","open","screenshot","scroll","select","state","tab","type","unbind","uncheck","upload","verify","wait"]),x=new Set(["--profile"]);export function getBrowserSubcommandNames(){return h}export function rewriteBrowserArgv(o){const n=[...o];let e=0;while(e<n.length){const r=n[e];if(!r.startsWith("-"))break;if(r.includes("=")){e+=1;continue}if(x.has(r)&&e+1<n.length)e+=2;else e+=1}if(n[e]!=="browser")return n;const t=e+1,s=n[t];if(s===void 0)return n;if(s==="--session"||s==="--session="||s.startsWith("--session="))throw new BrowserSessionArgvError("The `--session` flag is no longer a public option. Use the positional form: ppcli browser <session> <command>");if(s.startsWith("-"))return n;if(h.has(s))return n;n.splice(t,1,"--session",s);q(n,t+2);return n}function q(o,n){const e=o.findIndex((t,s)=>s>=n&&h.has(t));if(e===-1)return;for(let t=e+1;t<o.length;t+=1){const s=o[t];if(s==="--")return;if(s.startsWith("--window=")){const r=o.splice(t,1);o.splice(e,0,...r);return}if(s==="--window"){const r=o[t+1];if(r===void 0||r==="--")return;const u=o.splice(t,2);o.splice(e,0,...u);return}}}export class BrowserSessionArgvError extends Error{constructor(o){super(o);this.name="BrowserSessionArgvError"}}function I(o){const n=new Map([["-h","none"],["--help","none"],["-v","none"],["--verbose","none"],["-f","required"],["--format","required"],["--trace","required"]]);if(o.browser){n.set("--window","required");n.set("--site-session","required");n.set("--keep-tab","required")}for(const e of o.args??[]){if(e.positional)continue;n.set(`--${e.name}`,e.required||e.valueRequired?"required":"optional")}return n}function g(o,n,e){const t=o[n];if(!t||t==="--")return null;const s=t.indexOf("="),r=s===-1?t:t.slice(0,s),u=e.get(r);if(!u&&s===-1&&t.startsWith("-")&&!t.startsWith("--")&&t.length>2){const f=t.slice(0,2);if(e.get(f)==="required")return{values:[t],nextIndex:n+1}}if(!u)return null;if(s!==-1||u==="none")return{values:[t],nextIndex:n+1};const l=o[n+1];if(u==="required")return l===void 0?{values:[t],nextIndex:n+1}:{values:[t,l],nextIndex:n+2};if(l!==void 0&&!l.startsWith("-"))return{values:[t,l],nextIndex:n+2};return{values:[t],nextIndex:n+1}}export function escapeLeadingDashPositional(o,n){const e=[...o],t=new Map;for(const i of n){const a=i.args?.find((b)=>b.positional);if(a?.required||a?.requiredUnlessFile)t.set(i.site+"/"+i.name,i)}let s=0;while(s<e.length){const i=e[s];if(!i.startsWith("-"))break;if(i.includes("=")){s+=1;continue}if(x.has(i)&&s+1<e.length)s+=2;else s+=1}const r=e[s],u=e[s+1],l=s+2;if(!r||!u||l>=e.length)return e;const f=t.get(r+"/"+u);if(!f)return e;const d=I(f),p=[];let c=l;while(c<e.length){const i=e[c];if(i==="--")return e;const a=g(e,c,d);if(a){p.push(...a.values);c=a.nextIndex;continue}if(!i.startsWith("-"))return e;if(i.startsWith("--"))return e;break}if(c>=e.length)return e;const k=e[c],w=[],m=[];c+=1;while(c<e.length){const i=g(e,c,d);if(i){w.push(...i.values);c=i.nextIndex;continue}m.push(e[c]);c+=1}return[...e.slice(0,l),...p,...w,"--",k,...m]}