publishport-opencli 1.0.20 → 1.0.21

package/dist/src/browser/base-page.js

@@ -1,8 +1,8 @@
-import{generateSnapshotJs as N,getFormStateJs as E}from"./dom-snapshot.js";import{buildAxSnapshotFromTrees as F,findAxRefReplacement as w}from"./ax-snapshot.js";import{pressKeyJs as I,waitForTextJs as S,waitForCaptureJs as b,waitForSelectorJs as J,scrollJs as T,autoScrollJs as h,networkRequestsJs as R,waitForDomStableJs as g}from"./dom-helpers.js";import{resolveTargetJs as k,boundingRectResolvedJs as P,clickResolvedJs as x,typeResolvedJs as V,prepareNativeTypeResolvedJs as z,verifyFilledResolvedJs as U,scrollResolvedJs as y}from"./target-resolver.js";import{TargetError as q}from"./target-errors.js";import{CliError as M}from"../errors.js";import{formatSnapshot as v}from"../snapshotFormatter.js";import{installVisualRefOverlayJs as m,removeVisualRefOverlayJs as u}from"./visual-refs.js";async function Y(G,H,W={}){const Q=await G.evaluate(k(H,W));if(!Q.ok)throw new q({code:Q.code,message:Q.message,hint:Q.hint,candidates:Q.candidates,matches_n:Q.matches_n});return{matches_n:Q.matches_n,match_level:Q.match_level}}function A(G){const H=(G??"").replace(/\s+/g," ").trim().slice(0,300);return H?`Response preview: ${H}`:void 0}function f(G){const H=G.split("+").map((Z)=>Z.trim()).filter(Boolean);if(H.length<=1)return{key:G,modifiers:[]};const W=[];for(const Z of H.slice(0,-1)){const _=Z.toLowerCase();if(_==="ctrl"||_==="control")W.push("Ctrl");else if(_==="cmd"||_==="command"||_==="meta")W.push("Meta");else if(_==="option"||_==="alt")W.push("Alt");else if(_==="shift")W.push("Shift");else return{key:G,modifiers:[]}}const Q=H.at(-1);return Q?{key:Q,modifiers:W}:{key:G,modifiers:[]}}export class BasePage{_lastUrl=null;_prevSnapshotHashes=null;_cdpTargetMarkerSeq=0;_axRefs=new Map;async evaluateWithArgs(G,H){const W=Object.entries(H).map(([Q,Z])=>{if(!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(Q))throw Error(`evaluateWithArgs: invalid key "${Q}"`);return`const ${Q} = ${JSON.stringify(Z)};`}).join(`
+import{generateSnapshotJs as x,getFormStateJs as I}from"./dom-snapshot.js";import{buildAxSnapshotFromTrees as M,findAxRefReplacement as E}from"./ax-snapshot.js";import{pressKeyJs as C,waitForTextJs as A,waitForCaptureJs as T,waitForSelectorJs as R,scrollJs as S,autoScrollJs as N,networkRequestsJs as O,waitForDomStableJs as D}from"./dom-helpers.js";import{resolveTargetJs as F,boundingRectResolvedJs as w,clickResolvedJs as J,typeResolvedJs as m,prepareNativeTypeResolvedJs as y,verifyFilledResolvedJs as v,scrollResolvedJs as U}from"./target-resolver.js";import{TargetError as h}from"./target-errors.js";import{CliError as f}from"../errors.js";import{formatSnapshot as q}from"../snapshotFormatter.js";import{installVisualRefOverlayJs as P,removeVisualRefOverlayJs as B}from"./visual-refs.js";async function d(e,t,a={}){const r=await e.evaluate(F(t,a));if(!r.ok)throw new h({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 g(e){const t=(e??"").replace(/\s+/g," ").trim().slice(0,300);return t?`Response preview: ${t}`:void 0}function L(e){const t=e.split("+").map((n)=>n.trim()).filter(Boolean);if(t.length<=1)return{key:e,modifiers:[]};const a=[];for(const n of t.slice(0,-1)){const i=n.toLowerCase();if(i==="ctrl"||i==="control")a.push("Ctrl");else if(i==="cmd"||i==="command"||i==="meta")a.push("Meta");else if(i==="option"||i==="alt")a.push("Alt");else if(i==="shift")a.push("Shift");else return{key:e,modifiers:[]}}const r=t.at(-1);return r?{key:r,modifiers:a}:{key:e,modifiers:[]}}export class BasePage{_lastUrl=null;_prevSnapshotHashes=null;_cdpTargetMarkerSeq=0;_axRefs=new Map;async evaluateWithArgs(e,t){const a=Object.entries(t).map(([r,n])=>{if(!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(r))throw Error(`evaluateWithArgs: invalid key "${r}"`);return`const ${r} = ${JSON.stringify(n)};`}).join(`
 `);return this.evaluate(`{
-${W}
-${G}
-}`)}async fetchJson(G,H={}){const W={url:G,method:H.method??"GET",headers:H.headers??{},body:H.body,hasBody:H.body!==void 0,timeoutMs:H.timeoutMs??15000},Q=await this.evaluateWithArgs(`
+${a}
+${e}
+}`)}async fetchJson(e,t={}){const a={url:e,method:t.method??"GET",headers:t.headers??{},body:t.body,hasBody:t.body!==void 0,timeoutMs:t.timeoutMs??15000},r=await this.evaluateWithArgs(`
       (async () => {
         const ctrl = new AbortController();
         const timer = setTimeout(() => ctrl.abort(), request.timeoutMs);
@@ -44,12 +44,12 @@ ${G}
           clearTimeout(timer);
         }
       })()
-    `,{request:W}),Z=Q.url||G;if(Q.error)throw new M("FETCH_ERROR",`Browser fetch failed for ${Z}: ${Q.error}`,"Check that the page is reachable and the current browser profile has access.");if(!Q.ok)throw new M("FETCH_ERROR",`HTTP ${Q.status??0}${Q.statusText?` ${Q.statusText}`:""} from ${Z}`,A(Q.text));const _=Q.text??"";if(!_.trim())return null;try{return JSON.parse(_)}catch{const $=Q.contentType?` (${Q.contentType})`:"";throw new M("FETCH_ERROR",`Expected JSON from ${Z}${$}`,A(_))}}async annotatedScreenshot(G={}){await this.snapshot({source:"dom",viewportExpand:0});try{await this.evaluate(m());return await this.screenshot({...G,annotate:!1})}finally{await this.evaluate(u()).catch(()=>{})}}async click(G,H={}){const W=await this.tryClickAxRef(G);if(W)return W;const Q=await Y(this,G,H),Z=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),_=await this.evaluate(P({skipScroll:Z,forClick:!0})),$={hit:_?.hit,retargeted:_?.retargeted};if(_?.visible===!0&&(_.hit==="target"||_.hit==="ancestor")){if(await this.tryNativeClick(_.x,_.y))return{...Q,click_method:"cdp",...$}}const D=await this.evaluate(x({skipScroll:Z}));if(typeof D==="string"||D==null)return{...Q,click_method:"js",...$};if(D.status==="clicked")return{...Q,click_method:"js",...$};if(D.x!=null&&D.y!=null){if(await this.tryNativeClick(D.x,D.y))return{...Q,click_method:"cdp",...$}}throw Error(`Click failed: ${D.error??"JS click and CDP fallback both failed"}`)}async tryNativeClick(G,H){const W=this.nativeClick;if(typeof W!=="function")return!1;try{await W.call(this,G,H);return!0}catch{return!1}}async tryNativeMouseMove(G,H){const W=this.cdp;if(typeof W!=="function")return!1;try{await W.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:G,y:H});return!0}catch{return!1}}async tryNativeDoubleClick(G,H){const W=this.cdp;if(typeof W!=="function")return!1;try{await W.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:G,y:H});await W.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:G,y:H,button:"left",clickCount:1});await W.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:G,y:H,button:"left",clickCount:1});await W.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:G,y:H,button:"left",clickCount:2});await W.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:G,y:H,button:"left",clickCount:2});return!0}catch{return!1}}async tryNativeDrag(G,H){const W=this.cdp;if(typeof W!=="function")return!1;const Q=Math.round((G.x+H.x)/2),Z=Math.round((G.y+H.y)/2);try{await W.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:G.x,y:G.y});await W.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:G.x,y:G.y,button:"left",clickCount:1});await W.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:Q,y:Z,button:"left",buttons:1});await W.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:H.x,y:H.y,button:"left",buttons:1});await W.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:H.x,y:H.y,button:"left",clickCount:1});return!0}catch{return!1}}async tryClickAxRef(G){if(!/^\d+$/.test(G))return null;const H=this._axRefs.get(G);if(!H)return null;const W=this.nativeClick;if(typeof W!=="function")return null;const Q=await this.resolveAxRefPoint(H);if(!Q)return null;try{await W.call(this,Q.x,Q.y);return{matches_n:1,match_level:Q.matchLevel,click_method:"ax"}}catch{return null}}async resolveAxRefPoint(G){const H=this.cdp;if(typeof H!=="function")return null;if(G.backendNodeId!=null){const _=await this.axBoxCenter(G.backendNodeId,G.frame).catch(()=>null);if(_)return{..._,matchLevel:"exact"}}await H.call(this,"Accessibility.enable",C(G.frame));const W=await H.call(this,"Accessibility.getFullAXTree",j(G.frame)).catch(()=>null),Q=w(W,G);if(!Q?.backendNodeId)return null;this._axRefs.set(G.ref,Q);const Z=await this.axBoxCenter(Q.backendNodeId,Q.frame).catch(()=>null);return Z?{...Z,matchLevel:"reidentified"}:null}async axBoxCenter(G,H){const W=this.cdp;if(typeof W!=="function")return null;const Q=await W.call(this,"DOM.getBoxModel",{backendNodeId:G,...H?.sessionId?{frameId:H.frameId,sessionId:H.sessionId,...H.targetUrl?{targetUrl:H.targetUrl}:{}}:{}}),Z=Array.isArray(Q?.model?.content)&&Q.model.content.length>=8?Q.model.content:Array.isArray(Q?.model?.border)&&Q.model.border.length>=8?Q.model.border:null;if(!Z)return null;const _=Z.slice(0,8).map(($)=>typeof $==="number"?$:Number($));if(_.some(($)=>!Number.isFinite($)))return null;return{x:Math.round((_[0]+_[2]+_[4]+_[6])/4),y:Math.round((_[1]+_[3]+_[5]+_[7])/4)}}async tryNativeType(G){const H=this.nativeType;if(typeof H==="function")try{await H.call(this,G);return!0}catch{}const W=this.insertText;if(typeof W!=="function")return!1;try{await W.call(this,G);return!0}catch{return!1}}async tryNativeKeyPress(G,H){const W=this.nativeKeyPress;if(typeof W!=="function")return!1;try{await W.call(this,G,H);return!0}catch{return!1}}async isResolvedFocused(){try{return await this.evaluate(`
+    `,{request:a}),n=r.url||e;if(r.error)throw new f("FETCH_ERROR",`Browser fetch failed for ${n}: ${r.error}`,"Check that the page is reachable and the current browser profile has access.");if(!r.ok)throw new f("FETCH_ERROR",`HTTP ${r.status??0}${r.statusText?` ${r.statusText}`:""} from ${n}`,g(r.text));const i=r.text??"";if(!i.trim())return null;try{return JSON.parse(i)}catch{const s=r.contentType?` (${r.contentType})`:"";throw new f("FETCH_ERROR",`Expected JSON from ${n}${s}`,g(i))}}async annotatedScreenshot(e={}){await this.snapshot({source:"dom",viewportExpand:0});try{await this.evaluate(P());return await this.screenshot({...e,annotate:!1})}finally{await this.evaluate(B()).catch(()=>{})}}async click(e,t={}){const a=await this.tryClickAxRef(e);if(a)return a;const r=await d(this,e,t),n=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),i=await this.evaluate(w({skipScroll:n,forClick:!0})),s={hit:i?.hit,retargeted:i?.retargeted};if(i?.visible===!0&&(i.hit==="target"||i.hit==="ancestor")){if(await this.tryNativeClick(i.x,i.y))return{...r,click_method:"cdp",...s}}const l=await this.evaluate(J({skipScroll:n}));if(typeof l==="string"||l==null)return{...r,click_method:"js",...s};if(l.status==="clicked")return{...r,click_method:"js",...s};if(l.x!=null&&l.y!=null){if(await this.tryNativeClick(l.x,l.y))return{...r,click_method:"cdp",...s}}throw Error(`Click failed: ${l.error??"JS click and CDP fallback both failed"}`)}async tryNativeClick(e,t){const a=this.nativeClick;if(typeof a!=="function")return!1;try{await a.call(this,e,t);return!0}catch{return!1}}async tryNativeMouseMove(e,t){const a=this.cdp;if(typeof a!=="function")return!1;try{await a.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:e,y:t});return!0}catch{return!1}}async tryNativeDoubleClick(e,t){const a=this.cdp;if(typeof a!=="function")return!1;try{await a.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:e,y:t});await a.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:e,y:t,button:"left",clickCount:1});await a.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:e,y:t,button:"left",clickCount:1});await a.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:e,y:t,button:"left",clickCount:2});await a.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:e,y:t,button:"left",clickCount:2});return!0}catch{return!1}}async tryNativeDrag(e,t){const a=this.cdp;if(typeof a!=="function")return!1;const r=Math.round((e.x+t.x)/2),n=Math.round((e.y+t.y)/2);try{await a.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:e.x,y:e.y});await a.call(this,"Input.dispatchMouseEvent",{type:"mousePressed",x:e.x,y:e.y,button:"left",clickCount:1});await a.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:r,y:n,button:"left",buttons:1});await a.call(this,"Input.dispatchMouseEvent",{type:"mouseMoved",x:t.x,y:t.y,button:"left",buttons:1});await a.call(this,"Input.dispatchMouseEvent",{type:"mouseReleased",x:t.x,y:t.y,button:"left",clickCount:1});return!0}catch{return!1}}async tryClickAxRef(e){if(!/^\d+$/.test(e))return null;const t=this._axRefs.get(e);if(!t)return null;const a=this.nativeClick;if(typeof a!=="function")return null;const r=await this.resolveAxRefPoint(t);if(!r)return null;try{await a.call(this,r.x,r.y);return{matches_n:1,match_level:r.matchLevel,click_method:"ax"}}catch{return null}}async resolveAxRefPoint(e){const t=this.cdp;if(typeof t!=="function")return null;if(e.backendNodeId!=null){const i=await this.axBoxCenter(e.backendNodeId,e.frame).catch(()=>null);if(i)return{...i,matchLevel:"exact"}}await t.call(this,"Accessibility.enable",k(e.frame));const a=await t.call(this,"Accessibility.getFullAXTree",b(e.frame)).catch(()=>null),r=E(a,e);if(!r?.backendNodeId)return null;this._axRefs.set(e.ref,r);const n=await this.axBoxCenter(r.backendNodeId,r.frame).catch(()=>null);return n?{...n,matchLevel:"reidentified"}:null}async axBoxCenter(e,t){const a=this.cdp;if(typeof a!=="function")return null;const r=await a.call(this,"DOM.getBoxModel",{backendNodeId:e,...t?.sessionId?{frameId:t.frameId,sessionId:t.sessionId,...t.targetUrl?{targetUrl:t.targetUrl}:{}}:{}}),n=Array.isArray(r?.model?.content)&&r.model.content.length>=8?r.model.content:Array.isArray(r?.model?.border)&&r.model.border.length>=8?r.model.border:null;if(!n)return null;const i=n.slice(0,8).map((s)=>typeof s==="number"?s:Number(s));if(i.some((s)=>!Number.isFinite(s)))return null;return{x:Math.round((i[0]+i[2]+i[4]+i[6])/4),y:Math.round((i[1]+i[3]+i[5]+i[7])/4)}}async tryNativeType(e){const t=this.nativeType;if(typeof t==="function")try{await t.call(this,e);return!0}catch{}const a=this.insertText;if(typeof a!=="function")return!1;try{await a.call(this,e);return!0}catch{return!1}}async tryNativeKeyPress(e,t){const a=this.nativeKeyPress;if(typeof a!=="function")return!1;try{await a.call(this,e,t);return!0}catch{return!1}}async isResolvedFocused(){try{return await this.evaluate(`
         (() => {
           const el = window.__resolved;
           return !!el && (document.activeElement === el || (typeof el.matches === 'function' && el.matches(':focus')));
         })()
-      `)}catch{return!1}}async tryCdpOnResolvedElement(G){const H=this.cdp;if(typeof H!=="function")return!1;const W="data-opencli-cdp-target",Q=`${Date.now().toString(36)}-${++this._cdpTargetMarkerSeq}`,Z=`[${W}="${Q}"]`;let _=!1;try{_=(await this.evaluateWithArgs(`
+      `)}catch{return!1}}async tryCdpOnResolvedElement(e){const t=this.cdp;if(typeof t!=="function")return!1;const a="data-opencli-cdp-target",r=`${Date.now().toString(36)}-${++this._cdpTargetMarkerSeq}`,n=`[${a}="${r}"]`;let i=!1;try{i=(await this.evaluateWithArgs(`
         (() => {
           const el = window.__resolved;
           if (!el || el.nodeType !== 1 || typeof el.setAttribute !== 'function') {
@@ -58,17 +58,17 @@ ${G}
           el.setAttribute(markerAttr, markerValue);
           return { ok: true };
         })()
-      `,{markerAttr:W,markerValue:Q}))?.ok===!0;if(!_)return!1;await H.call(this,"DOM.enable",{}).catch(()=>{return});const B=(await H.call(this,"DOM.getDocument",{}))?.root?.nodeId;if(typeof B!=="number")return!1;const L=(await H.call(this,"DOM.querySelector",{nodeId:B,selector:Z}))?.nodeId;if(typeof L!=="number"||L<=0)return!1;await H.call(this,G,{nodeId:L});return!0}catch{return!1}finally{if(_)await this.evaluateWithArgs(`
+      `,{markerAttr:a,markerValue:r}))?.ok===!0;if(!i)return!1;await t.call(this,"DOM.enable",{}).catch(()=>{return});const o=(await t.call(this,"DOM.getDocument",{}))?.root?.nodeId;if(typeof o!=="number")return!1;const c=(await t.call(this,"DOM.querySelector",{nodeId:o,selector:n}))?.nodeId;if(typeof c!=="number"||c<=0)return!1;await t.call(this,e,{nodeId:c});return!0}catch{return!1}finally{if(i)await this.evaluateWithArgs(`
           (() => {
             for (const el of document.querySelectorAll(selector)) {
               el.removeAttribute(markerAttr);
             }
           })()
-        `,{selector:Z,markerAttr:W}).catch(()=>{return})}}async typeText(G,H,W={}){const Q=await Y(this,G,W);let Z=!1,_=!1,$=!1;if(typeof this.nativeType==="function"||typeof this.insertText==="function")try{_=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");$=await this.tryCdpOnResolvedElement("DOM.focus");Z=(await this.evaluate(z({skipScroll:_,skipFocus:$})))?.ok===!0&&await this.tryNativeType(H)}catch{}if(!Z)await this.evaluate(V(H));return Q}async hover(G,H={}){const W=await Y(this,G,H),Q=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),Z=await this.evaluate(P({skipScroll:Q}));if(Z?.visible===!0&&await this.tryNativeMouseMove(Z.x,Z.y))return W;await this.evaluate(`
+        `,{selector:n,markerAttr:a}).catch(()=>{return})}}async typeText(e,t,a={}){const r=await d(this,e,a);let n=!1,i=!1,s=!1;if(typeof this.nativeType==="function"||typeof this.insertText==="function")try{i=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");s=await this.tryCdpOnResolvedElement("DOM.focus");n=(await this.evaluate(y({skipScroll:i,skipFocus:s})))?.ok===!0&&await this.tryNativeType(t)}catch{}if(!n)await this.evaluate(m(t));return r}async hover(e,t={}){const a=await d(this,e,t),r=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),n=await this.evaluate(w({skipScroll:r}));if(n?.visible===!0&&await this.tryNativeMouseMove(n.x,n.y))return a;await this.evaluate(`
       (() => {
         const el = window.__resolved;
         if (!el) throw new Error('No resolved element');
-        if (${Q?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        if (${r?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
         const rect = el.getBoundingClientRect();
         const init = {
           bubbles: true,
@@ -82,18 +82,18 @@ ${G}
         el.dispatchEvent(new MouseEvent('mouseover', init));
         el.dispatchEvent(new MouseEvent('mousemove', init));
       })()
-    `);return W}async focus(G,H={}){const W=await Y(this,G,H);let Q=await this.tryCdpOnResolvedElement("DOM.focus")&&await this.isResolvedFocused();if(!Q)Q=await this.evaluate(`
+    `);return a}async focus(e,t={}){const a=await d(this,e,t);let r=await this.tryCdpOnResolvedElement("DOM.focus")&&await this.isResolvedFocused();if(!r)r=await this.evaluate(`
         (() => {
           const el = window.__resolved;
           if (!el || typeof el.focus !== 'function') return false;
           try { el.focus({ preventScroll: true }); } catch (_) { try { el.focus(); } catch (_) {} }
           return document.activeElement === el || (typeof el.matches === 'function' && el.matches(':focus'));
         })()
-      `);return{...W,focused:!!Q}}async dblClick(G,H={}){const W=await Y(this,G,H),Q=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),Z=await this.evaluate(P({skipScroll:Q}));if(Z?.visible===!0&&await this.tryNativeDoubleClick(Z.x,Z.y))return W;await this.evaluate(`
+      `);return{...a,focused:!!r}}async dblClick(e,t={}){const a=await d(this,e,t),r=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),n=await this.evaluate(w({skipScroll:r}));if(n?.visible===!0&&await this.tryNativeDoubleClick(n.x,n.y))return a;await this.evaluate(`
       (() => {
         const el = window.__resolved;
         if (!el) throw new Error('No resolved element');
-        if (${Q?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        if (${r?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
         const rect = el.getBoundingClientRect();
         const init = {
           bubbles: true,
@@ -106,7 +106,7 @@ ${G}
         };
         el.dispatchEvent(new MouseEvent('dblclick', init));
       })()
-    `);return W}async readCheckableState(){return await this.evaluate(`
+    `);return a}async readCheckableState(){return await this.evaluate(`
       (() => {
         const el = window.__resolved;
         if (!el || el.nodeType !== 1) return { ok: false, reason: 'not_checkable' };
@@ -132,7 +132,7 @@ ${G}
         }
         return { ok: false, reason: 'not_checkable', tag, role };
       })()
-    `)}async setChecked(G,H,W={}){const Q=await Y(this,G,W),Z=await this.readCheckableState();if(Z?.ok!==!0)throw new q({code:"not_checkable",message:`Target "${G}" is not a checkbox, radio, switch, or aria-checked control.`,hint:"Use `ppcli browser state` or `browser find` to pick an input[type=checkbox], input[type=radio], or role=checkbox/switch target."});if(Z.disabled)throw new q({code:"not_checkable",message:`Target "${G}" is disabled and cannot be ${H?"checked":"unchecked"}.`,hint:"Pick an enabled control, or inspect the form state before retrying."});if((Z.kind==="radio"||Z.kind==="menuitemradio")&&!H)throw new q({code:"not_checkable",message:`Target "${G}" is a radio button and cannot be unchecked directly.`,hint:"Select another radio option in the same group instead."});if(Z.checked===H)return{...Q,checked:H,changed:!1,...Z.kind?{kind:Z.kind}:{}};const _=await this.click(G,W),$=await this.readCheckableState();if($?.ok!==!0||$.checked!==H)throw new q({code:"not_checkable",message:`Target "${G}" did not become ${H?"checked":"unchecked"} after click.`,hint:"The control may be custom, disabled by app logic, or require a different target such as its visible label."});return{matches_n:_.matches_n,match_level:_.match_level,checked:H,changed:!0,...$.kind?{kind:$.kind}:{}}}async setFileInputBySelector(G,H){const W=this.setFileInput;if(typeof W==="function"){await W.call(this,G,H);return}const Q=this.cdp;if(typeof Q!=="function")throw Error("File upload requires setFileInput or CDP support from the active browser backend.");await Q.call(this,"DOM.enable",{}).catch(()=>{return});const _=(await Q.call(this,"DOM.getDocument",{}))?.root?.nodeId;if(typeof _!=="number")throw Error("DOM.getDocument returned no root node.");const D=(await Q.call(this,"DOM.querySelector",{nodeId:_,selector:H}))?.nodeId;if(typeof D!=="number"||D<=0)throw Error(`No element found matching selector: ${H}`);await Q.call(this,"DOM.setFileInputFiles",{files:G,nodeId:D})}async uploadFiles(G,H,W={}){if(!Array.isArray(H)||H.length===0)throw new q({code:"not_file_input",message:"No files were provided for upload.",hint:"Pass one or more local file paths after the target."});const Q=await Y(this,G,W),Z="data-opencli-upload-target",_=`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,$=`[${Z}="${_}"]`;let D=!1,B=null;try{B=await this.evaluateWithArgs(`
+    `)}async setChecked(e,t,a={}){const r=await d(this,e,a),n=await this.readCheckableState();if(n?.ok!==!0)throw new h({code:"not_checkable",message:`Target "${e}" is not a checkbox, radio, switch, or aria-checked control.`,hint:"Use `ppcli browser state` or `browser find` to pick an input[type=checkbox], input[type=radio], or role=checkbox/switch target."});if(n.disabled)throw new h({code:"not_checkable",message:`Target "${e}" is disabled and cannot be ${t?"checked":"unchecked"}.`,hint:"Pick an enabled control, or inspect the form state before retrying."});if((n.kind==="radio"||n.kind==="menuitemradio")&&!t)throw new h({code:"not_checkable",message:`Target "${e}" is a radio button and cannot be unchecked directly.`,hint:"Select another radio option in the same group instead."});if(n.checked===t)return{...r,checked:t,changed:!1,...n.kind?{kind:n.kind}:{}};const i=await this.click(e,a),s=await this.readCheckableState();if(s?.ok!==!0||s.checked!==t)throw new h({code:"not_checkable",message:`Target "${e}" did not become ${t?"checked":"unchecked"} after click.`,hint:"The control may be custom, disabled by app logic, or require a different target such as its visible label."});return{matches_n:i.matches_n,match_level:i.match_level,checked:t,changed:!0,...s.kind?{kind:s.kind}:{}}}async setFileInputBySelector(e,t){const a=this.setFileInput;if(typeof a==="function"){await a.call(this,e,t);return}const r=this.cdp;if(typeof r!=="function")throw Error("File upload requires setFileInput or CDP support from the active browser backend.");await r.call(this,"DOM.enable",{}).catch(()=>{return});const i=(await r.call(this,"DOM.getDocument",{}))?.root?.nodeId;if(typeof i!=="number")throw Error("DOM.getDocument returned no root node.");const l=(await r.call(this,"DOM.querySelector",{nodeId:i,selector:t}))?.nodeId;if(typeof l!=="number"||l<=0)throw Error(`No element found matching selector: ${t}`);await r.call(this,"DOM.setFileInputFiles",{files:e,nodeId:l})}async uploadFiles(e,t,a={}){if(!Array.isArray(t)||t.length===0)throw new h({code:"not_file_input",message:"No files were provided for upload.",hint:"Pass one or more local file paths after the target."});const r=await d(this,e,a),n="data-opencli-upload-target",i=`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,s=`[${n}="${i}"]`;let l=!1,o=null;try{o=await this.evaluateWithArgs(`
         (() => {
           const el = window.__resolved;
           if (!el || el.nodeType !== 1) return { ok: false, reason: 'not_file_input' };
@@ -146,7 +146,7 @@ ${G}
             accept: el.getAttribute('accept') || '',
           };
         })()
-      `,{markerAttr:Z,markerValue:_});D=B?.ok===!0;if(!D)throw new q({code:"not_file_input",message:`Target "${G}" is not an input[type=file].`,hint:'Use `ppcli browser find --css "input[type=file]"` or inspect `compound` output from browser state/find.'});if(H.length>1&&!B?.multiple)throw new q({code:"not_file_input",message:`Target "${G}" does not allow multiple files, but ${H.length} files were provided.`,hint:"Pass one file, or choose a file input with the multiple attribute."});await this.setFileInputBySelector(H,$);const X=await this.evaluate(`
+      `,{markerAttr:n,markerValue:i});l=o?.ok===!0;if(!l)throw new h({code:"not_file_input",message:`Target "${e}" is not an input[type=file].`,hint:'Use `ppcli browser find --css "input[type=file]"` or inspect `compound` output from browser state/find.'});if(t.length>1&&!o?.multiple)throw new h({code:"not_file_input",message:`Target "${e}" does not allow multiple files, but ${t.length} files were provided.`,hint:"Pass one file, or choose a file input with the multiple attribute."});await this.setFileInputBySelector(t,s);const u=await this.evaluate(`
         (() => {
           const el = window.__resolved;
           const names = [];
@@ -157,18 +157,18 @@ ${G}
           } catch (_) {}
           return names;
         })()
-      `),L=Array.isArray(X)?X.map((O)=>String(O)):[];return{...Q,uploaded:!0,files:L.length||H.length,file_names:L,target:G,multiple:!!B?.multiple,...B?.accept?{accept:B.accept}:{}}}finally{if(D)await this.evaluateWithArgs(`
+      `),c=Array.isArray(u)?u.map((p)=>String(p)):[];return{...r,uploaded:!0,files:c.length||t.length,file_names:c,target:e,multiple:!!o?.multiple,...o?.accept?{accept:o.accept}:{}}}finally{if(l)await this.evaluateWithArgs(`
           (() => {
             for (const el of document.querySelectorAll(selector)) {
               el.removeAttribute(markerAttr);
             }
           })()
-        `,{selector:$,markerAttr:Z}).catch(()=>{return})}}async drag(G,H,W={}){const Q=await Y(this,G,W.from??{}),Z=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");if((await this.evaluate(`
+        `,{selector:s,markerAttr:n}).catch(()=>{return})}}async drag(e,t,a={}){const r=await d(this,e,a.from??{}),n=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");if((await this.evaluate(`
       (() => {
         const el = window.__resolved;
         if (!el) throw new Error('No resolved drag source');
         window.__opencli_drag_source = el;
-        if (${Z?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        if (${n?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
         const rect = el.getBoundingClientRect();
         const w = Math.round(rect.width);
         const h = Math.round(rect.height);
@@ -177,13 +177,13 @@ ${G}
         const visible = w > 0 && h > 0 && x >= 0 && y >= 0 && x <= window.innerWidth && y <= window.innerHeight;
         return { x, y, w, h, visible };
       })()
-    `))?.visible!==!0)throw Error(`Drag source "${G}" has no visible bounding box.`);try{const $=await Y(this,H,W.to??{}),D=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),B=await this.evaluate(`
+    `))?.visible!==!0)throw Error(`Drag source "${e}" has no visible bounding box.`);try{const s=await d(this,t,a.to??{}),l=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),o=await this.evaluate(`
         (() => {
           const sourceEl = window.__opencli_drag_source;
           const targetEl = window.__resolved;
           if (!sourceEl) throw new Error('No resolved drag source');
           if (!targetEl) throw new Error('No resolved drag target');
-          if (${D?"false":"true"}) targetEl.scrollIntoView({ behavior: 'instant', block: 'center' });
+          if (${l?"false":"true"}) targetEl.scrollIntoView({ behavior: 'instant', block: 'center' });
           const measure = (el) => {
             const rect = el.getBoundingClientRect();
             const w = Math.round(rect.width);
@@ -195,16 +195,16 @@ ${G}
           };
           return { source: measure(sourceEl), target: measure(targetEl) };
         })()
-      `);if(B?.source?.visible!==!0)throw Error(`Drag source "${G}" is not visible at drag time.`);if(B?.target?.visible!==!0)throw Error(`Drag target "${H}" has no visible bounding box.`);if(!await this.tryNativeDrag({x:B.source.x,y:B.source.y},{x:B.target.x,y:B.target.y}))throw Error("Native drag requires CDP Input.dispatchMouseEvent support.");return{dragged:!0,source:G,target:H,source_matches_n:Q.matches_n,target_matches_n:$.matches_n,source_match_level:Q.match_level,target_match_level:$.match_level}}finally{await this.evaluate("delete window.__opencli_drag_source").catch(()=>{})}}async fillText(G,H,W={}){const Q=await Y(this,G,W);let Z=!1,_=!1;try{Z=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");_=await this.tryCdpOnResolvedElement("DOM.focus")}catch{}if((await this.evaluate(z({skipScroll:Z,skipFocus:_})))?.ok!==!0)throw new q({code:"not_editable",message:`Target "${G}" is not a fillable input, textarea, or contenteditable element.`,hint:"Use `ppcli browser state` to pick an editable target, or use `browser type` for keyboard-like interactions."});const D=await this.tryNativeType(H);if(!D)await this.evaluate(V(H));let B=await this.evaluate(U(H));if(D&&B?.ok!==!0){await this.evaluate(V(H));B=await this.evaluate(U(H))}const X=B&&"actual"in B?B.actual:"",L=B&&"mode"in B?B.mode:void 0;return{...Q,filled:!0,verified:B?.ok===!0,expected:H,actual:X,length:X.length,...L?{mode:L}:{}}}async pressKey(G){const H=f(G);if(!await this.tryNativeKeyPress(H.key,H.modifiers))await this.evaluate(I(H.key,H.modifiers))}async scrollTo(G,H={}){const W=await Y(this,G,H),Q=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),Z=await this.evaluate(y({skipScroll:Q}));if(Z&&typeof Z==="object")return{...Z,matches_n:W.matches_n,match_level:W.match_level};return{matches_n:W.matches_n,match_level:W.match_level}}async getFormState(){return await this.evaluate(E())}async scroll(G="down",H=500){await this.evaluate(T(G,H))}async autoScroll(G){const H=G?.times??3,W=G?.delayMs??2000;await this.evaluate(h(H,W))}async networkRequests(G=!1){const H=await this.evaluate(R(G));return Array.isArray(H)?H:[]}async consoleMessages(G="info"){return[]}async wait(G){if(typeof G==="number"){if(G>=1)try{const H=G*1000;await this.evaluate(g(H,Math.min(500,H)));return}catch{}await new Promise((H)=>setTimeout(H,G*1000));return}if(typeof G.time==="number"){await new Promise((H)=>setTimeout(H,G.time*1000));return}if(G.selector){const H=(G.timeout??10)*1000;await this.evaluate(J(G.selector,H));return}if(G.text){const H=(G.timeout??30)*1000;await this.evaluate(S(G.text,H))}}async snapshot(G={}){if(G.source==="ax"){const W=this.cdp;if(typeof W!=="function")throw new M("BROWSER_AX_UNAVAILABLE","AX snapshot requires CDP support from the active browser backend.","Use the default DOM state, or update/reload the Browser Bridge extension.");const Q=await this.collectAxSnapshotTrees(W),Z=F(Q,{maxDepth:G.maxDepth,interactiveOnly:G.interactive});this._axRefs=Z.refs;return Z.text}this._axRefs.clear();const H=N({viewportExpand:G.viewportExpand??2000,maxDepth:Math.max(1,Math.min(Number(G.maxDepth)||50,200)),interactiveOnly:G.interactive??!1,maxTextLength:G.maxTextLength??120,includeScrollInfo:!0,bboxDedup:!0,previousHashes:this._prevSnapshotHashes});try{const W=await this.evaluate(H);try{const Q=await this.evaluate("window.__opencli_prev_hashes");this._prevSnapshotHashes=typeof Q==="string"?Q:null}catch{}return W}catch(W){if(process.env.DEBUG_SNAPSHOT)process.stderr.write(`[snapshot] DOM snapshot failed, falling back to accessibility tree: ${W?.message?.slice(0,200)}
-`);return this._basicSnapshot(G)}}async collectAxSnapshotTrees(G){await G.call(this,"Accessibility.enable",{});const W=[{tree:await G.call(this,"Accessibility.getFullAXTree",{})}],Q=await G.call(this,"Page.getFrameTree",{}).catch(()=>null),Z=c(Q);for(const _ of Z){if(_.sessionId)await G.call(this,"Accessibility.enable",C(_)).catch(()=>null);const $=await G.call(this,"Accessibility.getFullAXTree",j(_)).catch(()=>null);if($)W.push({tree:$,frame:_})}return W}async getCurrentUrl(){if(this._lastUrl)return this._lastUrl;try{const G=await this.evaluate("window.location.href");if(typeof G==="string"&&G){this._lastUrl=G;return G}}catch{}return null}async installInterceptor(G){const{generateInterceptorJs:H}=await import("../interceptor.js");await this.evaluate(H(JSON.stringify(G),{arrayName:"__opencli_xhr",patchGuard:"__opencli_interceptor_patched"}))}async getInterceptedRequests(){const{generateReadInterceptedJs:G}=await import("../interceptor.js"),H=await this.evaluate(G("__opencli_xhr"));return Array.isArray(H)?H:[]}async waitForCapture(G=10){const H=G*1000;await this.evaluate(b(H))}async _basicSnapshot(G={}){const W=`
+      `);if(o?.source?.visible!==!0)throw Error(`Drag source "${e}" is not visible at drag time.`);if(o?.target?.visible!==!0)throw Error(`Drag target "${t}" has no visible bounding box.`);if(!await this.tryNativeDrag({x:o.source.x,y:o.source.y},{x:o.target.x,y:o.target.y}))throw Error("Native drag requires CDP Input.dispatchMouseEvent support.");return{dragged:!0,source:e,target:t,source_matches_n:r.matches_n,target_matches_n:s.matches_n,source_match_level:r.match_level,target_match_level:s.match_level}}finally{await this.evaluate("delete window.__opencli_drag_source").catch(()=>{})}}async fillText(e,t,a={}){const r=await d(this,e,a);let n=!1,i=!1;try{n=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded");i=await this.tryCdpOnResolvedElement("DOM.focus")}catch{}if((await this.evaluate(y({skipScroll:n,skipFocus:i})))?.ok!==!0)throw new h({code:"not_editable",message:`Target "${e}" is not a fillable input, textarea, or contenteditable element.`,hint:"Use `ppcli browser state` to pick an editable target, or use `browser type` for keyboard-like interactions."});const l=await this.tryNativeType(t);if(!l)await this.evaluate(m(t));let o=await this.evaluate(v(t));if(l&&o?.ok!==!0){await this.evaluate(m(t));o=await this.evaluate(v(t))}const u=o&&"actual"in o?o.actual:"",c=o&&"mode"in o?o.mode:void 0;return{...r,filled:!0,verified:o?.ok===!0,expected:t,actual:u,length:u.length,...c?{mode:c}:{}}}async pressKey(e){const t=L(e);if(!await this.tryNativeKeyPress(t.key,t.modifiers))await this.evaluate(C(t.key,t.modifiers))}async scrollTo(e,t={}){const a=await d(this,e,t),r=await this.tryCdpOnResolvedElement("DOM.scrollIntoViewIfNeeded"),n=await this.evaluate(U({skipScroll:r}));if(n&&typeof n==="object")return{...n,matches_n:a.matches_n,match_level:a.match_level};return{matches_n:a.matches_n,match_level:a.match_level}}async getFormState(){return await this.evaluate(I())}async scroll(e="down",t=500){await this.evaluate(S(e,t))}async autoScroll(e){const t=e?.times??3,a=e?.delayMs??2000;await this.evaluate(N(t,a))}async networkRequests(e=!1){const t=await this.evaluate(O(e));return Array.isArray(t)?t:[]}async consoleMessages(e="info"){return[]}async wait(e){if(typeof e==="number"){if(e>=1)try{const t=e*1000;await this.evaluate(D(t,Math.min(500,t)));return}catch{}await new Promise((t)=>setTimeout(t,e*1000));return}if(typeof e.time==="number"){await new Promise((t)=>setTimeout(t,e.time*1000));return}if(e.selector){const t=(e.timeout??10)*1000;await this.evaluate(R(e.selector,t));return}if(e.text){const t=(e.timeout??30)*1000;await this.evaluate(A(e.text,t))}}async snapshot(e={}){if(e.source==="ax"){const a=this.cdp;if(typeof a!=="function")throw new f("BROWSER_AX_UNAVAILABLE","AX snapshot requires CDP support from the active browser backend.","Use the default DOM state, or update/reload the Browser Bridge extension.");const r=await this.collectAxSnapshotTrees(a),n=M(r,{maxDepth:e.maxDepth,interactiveOnly:e.interactive});this._axRefs=n.refs;return n.text}this._axRefs.clear();const t=x({viewportExpand:e.viewportExpand??2000,maxDepth:Math.max(1,Math.min(Number(e.maxDepth)||50,200)),interactiveOnly:e.interactive??!1,maxTextLength:e.maxTextLength??120,includeScrollInfo:!0,bboxDedup:!0,previousHashes:this._prevSnapshotHashes});try{const a=await this.evaluate(t);try{const r=await this.evaluate("window.__opencli_prev_hashes");this._prevSnapshotHashes=typeof r==="string"?r:null}catch{}return a}catch(a){if(process.env.DEBUG_SNAPSHOT)process.stderr.write(`[snapshot] DOM snapshot failed, falling back to accessibility tree: ${a?.message?.slice(0,200)}
+`);return this._basicSnapshot(e)}}async collectAxSnapshotTrees(e){await e.call(this,"Accessibility.enable",{});const a=[{tree:await e.call(this,"Accessibility.getFullAXTree",{})}],r=await e.call(this,"Page.getFrameTree",{}).catch(()=>null),n=V(r);for(const i of n){if(i.sessionId)await e.call(this,"Accessibility.enable",k(i)).catch(()=>null);const s=await e.call(this,"Accessibility.getFullAXTree",b(i)).catch(()=>null);if(s)a.push({tree:s,frame:i})}return a}async getCurrentUrl(){if(this._lastUrl)return this._lastUrl;try{const e=await this.evaluate("window.location.href");if(typeof e==="string"&&e){this._lastUrl=e;return e}}catch{}return null}async installInterceptor(e){const{generateInterceptorJs:t}=await import("../interceptor.js");await this.evaluate(t(JSON.stringify(e),{arrayName:"__opencli_xhr",patchGuard:"__opencli_interceptor_patched"}))}async getInterceptedRequests(){const{generateReadInterceptedJs:e}=await import("../interceptor.js"),t=await this.evaluate(e("__opencli_xhr"));return Array.isArray(t)?t:[]}async waitForCapture(e=10){const t=e*1000;await this.evaluate(T(t))}async _basicSnapshot(e={}){const a=`
       (async () => {
         function buildTree(node, depth) {
-          if (depth > ${Math.max(1,Math.min(Number(G.maxDepth)||50,200))}) return '';
+          if (depth > ${Math.max(1,Math.min(Number(e.maxDepth)||50,200))}) return '';
           const role = node.getAttribute?.('role') || node.tagName?.toLowerCase() || 'generic';
           const name = node.getAttribute?.('aria-label') || node.getAttribute?.('alt') || node.textContent?.trim().slice(0, 80) || '';
           const isInteractive = ['a', 'button', 'input', 'select', 'textarea'].includes(node.tagName?.toLowerCase()) || node.getAttribute?.('tabindex') != null;
 
-          ${G.interactive?'if (!isInteractive && !node.children?.length) return "";':""}
+          ${e.interactive?'if (!isInteractive && !node.children?.length) return "";':""}
 
           let indent = '  '.repeat(depth);
           let line = indent + role;
@@ -222,4 +222,4 @@ ${G}
         }
         return buildTree(document.body, 0);
       })()
-    `,Q=await this.evaluate(W);if(G.raw)return Q;if(typeof Q==="string")return v(Q,G);return Q}}function j(G){return G?.frameId?{frameId:G.frameId,...G.sessionId?{sessionId:G.sessionId}:{},...G.targetUrl?{targetUrl:G.targetUrl}:{}}:{}}function C(G){return G?.frameId&&G.sessionId?{frameId:G.frameId,sessionId:G.sessionId,...G.targetUrl?{targetUrl:G.targetUrl}:{}}:{}}function c(G){const H=G?.frameTree,W=H?.frame?.url||H?.frame?.unreachableUrl||"",Q=K(W);if(!H||!Q)return[];const Z=[];function _($){for(const D of $?.childFrames??[]){const B=D.frame,X=B?.id,L=B?.url||B?.unreachableUrl||"",O=K(L);if(!X)continue;if(O===Q){Z.push({frameId:X,url:L});_(D)}else Z.push({frameId:X,url:L,targetUrl:L,sessionId:"target"})}}_(H);return Z}function K(G){try{return new URL(G).origin}catch{return null}}
+    `,r=await this.evaluate(a);if(e.raw)return r;if(typeof r==="string")return q(r,e);return r}}function b(e){return e?.frameId?{frameId:e.frameId,...e.sessionId?{sessionId:e.sessionId}:{},...e.targetUrl?{targetUrl:e.targetUrl}:{}}:{}}function k(e){return e?.frameId&&e.sessionId?{frameId:e.frameId,sessionId:e.sessionId,...e.targetUrl?{targetUrl:e.targetUrl}:{}}:{}}function V(e){const t=e?.frameTree,a=t?.frame?.url||t?.frame?.unreachableUrl||"",r=_(a);if(!t||!r)return[];const n=[];function i(s){for(const l of s?.childFrames??[]){const o=l.frame,u=o?.id,c=o?.url||o?.unreachableUrl||"",p=_(c);if(!u)continue;if(p===r){n.push({frameId:u,url:c});i(l)}else n.push({frameId:u,url:c,targetUrl:c,sessionId:"target"})}}i(t);return n}function _(e){try{return new URL(e).origin}catch{return null}}

package/dist/src/browser/bridge.js

@@ -1 +1 @@
-import{Page as F}from"./page.js";import{resolveProfileContextId as G}from"./profile.js";import{ensureBrowserBridgeReady as H}from"./daemon-lifecycle.js";const K=1e4;export class BrowserBridge{_state="idle";_page=null;_daemonProc=null;get state(){return this._state}async connect(b={}){if(this._state==="connected"&&this._page)return this._page;if(this._state==="connecting")throw Error("Already connecting");if(this._state==="closing")throw Error("Session is closing");if(this._state==="closed")throw Error("Session is closed");this._state="connecting";try{const q=b.contextId??G();await this._ensureDaemon(b.timeout,q);if(!b.session?.trim())throw Error("Browser session is required");this._page=new F(b.session.trim(),b.idleTimeout,q,b.windowMode,b.surface,b.siteSession);this._state="connected";return this._page}catch(q){this._state="idle";throw q}}async close(){if(this._state==="closed")return;this._state="closing";this._page=null;this._state="closed"}async _ensureDaemon(b,q){const z=await H({timeoutSeconds:b??Math.ceil(K/1000),contextId:q});this._daemonProc=z.spawnedProcess}}
+import{Page as i}from"./page.js";import{resolveProfileContextId as r}from"./profile.js";import{ensureBrowserBridgeReady as n}from"./daemon-lifecycle.js";const o=1e4;export class BrowserBridge{_state="idle";_page=null;_daemonProc=null;get state(){return this._state}async connect(e={}){if(this._state==="connected"&&this._page)return this._page;if(this._state==="connecting")throw Error("Already connecting");if(this._state==="closing")throw Error("Session is closing");if(this._state==="closed")throw Error("Session is closed");this._state="connecting";try{const t=e.contextId??r();await this._ensureDaemon(e.timeout,t);if(!e.session?.trim())throw Error("Browser session is required");this._page=new i(e.session.trim(),e.idleTimeout,t,e.windowMode,e.surface,e.siteSession);this._state="connected";return this._page}catch(t){this._state="idle";throw t}}async close(){if(this._state==="closed")return;this._state="closing";this._page=null;this._state="closed"}async _ensureDaemon(e,t){const s=await n({timeoutSeconds:e??Math.ceil(o/1000),contextId:t});this._daemonProc=s.spawnedProcess}}

package/dist/src/browser/cdp.js

@@ -1 +1 @@
-import{WebSocket as I}from"ws";import{request as W}from"node:http";import{request as F}from"node:https";import{buildEvaluateExpression as _}from"./utils.js";import{generateStealthJs as z}from"./stealth.js";import{waitForDomStableJs as S}from"./dom-helpers.js";import{isRecord as H,saveBase64ToFile as M}from"../utils.js";import{getAllElectronApps as w}from"../electron-apps.js";import{BasePage as E}from"./base-page.js";const R=30000;export const CDP_RESPONSE_BODY_CAPTURE_LIMIT=8388608;export class CDPBridge{_ws=null;_idCounter=0;_pending=new Map;_eventListeners=new Map;async connect(G){if(this._ws)throw Error("CDPBridge is already connected. Call close() before reconnecting.");const V=G?.cdpEndpoint??process.env.OPENCLI_CDP_ENDPOINT;if(!V)throw Error("CDP endpoint not provided (pass cdpEndpoint or set OPENCLI_CDP_ENDPOINT)");let Q=V;if(V.startsWith("http")){const K=await j(`${V.replace(/\/$/,"")}/json`),X=U(K);if(!X||!X.webSocketDebuggerUrl)throw Error("No inspectable targets found at CDP endpoint");Q=X.webSocketDebuggerUrl}return new Promise((K,X)=>{const Z=new I(Q),$=(G?.timeout??10)*1000,J=setTimeout(()=>{this._ws=null;Z.close();X(Error("CDP connect timeout"))},$);Z.on("open",async()=>{clearTimeout(J);this._ws=Z;try{await this.send("Page.enable");this.on("Page.javascriptDialogOpening",(Y)=>{if(Y?.type==="beforeunload")this.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})});await this.send("Page.addScriptToEvaluateOnNewDocument",{source:z()});if(G?.initScript)await this.send("Page.addScriptToEvaluateOnNewDocument",{source:G.initScript});if(G?.windowMode==="background")await this.send("Emulation.setFocusEmulationEnabled",{enabled:!0}).catch(()=>{});else if(G?.windowMode==="foreground")await this.send("Page.bringToFront").catch(()=>{});if(G?.proxyAuth){this.on("Fetch.requestPaused",(Y)=>{const A=Y;if(A.requestId)this.send("Fetch.continueRequest",{requestId:A.requestId}).catch(()=>{})});this.on("Fetch.authRequired",(Y)=>{const A=Y;if(!A.requestId)return;this.send("Fetch.continueWithAuth",{requestId:A.requestId,authChallengeResponse:{response:"ProvideCredentials",username:G.proxyAuth.username,password:G.proxyAuth.password}}).catch(()=>{})});await this.send("Fetch.enable",{handleAuthRequests:!0})}}catch(Y){Z.close();X(Y instanceof Error?Y:Error(String(Y)));return}const L=new O(this);if(G?.session)L.session=G.session;if(G?.contextId)L.contextId=G.contextId;K(L)});Z.on("error",(L)=>{clearTimeout(J);X(L)});Z.on("message",(L)=>{try{const Y=JSON.parse(L.toString());if(Y.id&&this._pending.has(Y.id)){const A=this._pending.get(Y.id);clearTimeout(A.timer);this._pending.delete(Y.id);if(Y.error)A.reject(Error(Y.error.message));else A.resolve(Y.result)}if(Y.method){const A=this._eventListeners.get(Y.method);if(A)for(const B of A)B(Y.params)}}catch(Y){if(process.env.OPENCLI_VERBOSE)console.error("[cdp] Failed to parse WebSocket message:",Y instanceof Error?Y.message:Y)}})})}async close(){if(this._ws){this._ws.close();this._ws=null}for(const G of this._pending.values()){clearTimeout(G.timer);G.reject(Error("CDP connection closed"))}this._pending.clear();this._eventListeners.clear()}async send(G,V={},Q=R){if(!this._ws||this._ws.readyState!==I.OPEN)throw Error("CDP connection is not open");const K=++this._idCounter;return new Promise((X,Z)=>{const $=setTimeout(()=>{this._pending.delete(K);const J=G.startsWith("Page.")?"（页面可能被 JS 弹窗挡住：试 `ppcli browser dialog accept`；托管 profile 可 `ppcli profile stop <name>` 关闭后重跑命令自动重启会话）":"";Z(Error(`CDP command '${G}' timed out after ${Q/1000}s${J}`))},Q);this._pending.set(K,{resolve:X,reject:Z,timer:$});this._ws.send(JSON.stringify({id:K,method:G,params:V}))})}on(G,V){let Q=this._eventListeners.get(G);if(!Q){Q=new Set;this._eventListeners.set(G,Q)}Q.add(V)}off(G,V){this._eventListeners.get(G)?.delete(V)}waitForEvent(G,V=15000){return new Promise((Q,K)=>{const X=setTimeout(()=>{this.off(G,Z);K(Error(`Timed out waiting for CDP event '${G}'`))},V),Z=($)=>{clearTimeout(X);this.off(G,Z);Q($)};this.on(G,Z)})}}class O extends E{bridge;session;contextId;_pageEnabled=!1;_networkCapturing=!1;_networkCapturePattern="";_networkEntries=[];_pendingRequests=new Map;_pendingBodyFetches=new Set;_consoleMessages=[];_consoleCapturing=!1;constructor(G){super();this.bridge=G}async goto(G,V){if(!this._pageEnabled){await this.bridge.send("Page.enable");this._pageEnabled=!0}const Q=this.bridge.waitForEvent("Page.loadEventFired",30000).catch(()=>{});await this.bridge.send("Page.navigate",{url:G});await Q;this._lastUrl=G;if(V?.waitUntil!=="none"){const K=V?.settleMs??1000;await this.evaluate(S(K,Math.min(500,K)))}}async evaluate(G,...V){const Q=_(G,V),K=await this.bridge.send("Runtime.evaluate",{expression:Q,returnByValue:!0,awaitPromise:!0});if(K.exceptionDetails)throw Error("Evaluate error: "+(K.exceptionDetails.exception?.description||"Unknown exception"));return K.result?.value}async getCookies(G={}){let V;try{const K=await this.bridge.send("Storage.getCookies");V=H(K)&&Array.isArray(K.cookies)?K.cookies:[]}catch{const K=await this.bridge.send("Network.getCookies",G.url?{urls:[G.url]}:{});V=H(K)&&Array.isArray(K.cookies)?K.cookies:[]}const Q=G.domain??(G.url?T(G.url):void 0);return Q?V.filter((K)=>N(K)&&C(K.domain,Q)):V.filter(N)}async screenshot(G={}){const V=G.fullPage===!0,Q=G.width&&G.width>0?Math.ceil(G.width):void 0,K=!V&&G.height&&G.height>0?Math.ceil(G.height):void 0,X=Q!==void 0||K!==void 0;if(X){if(Q!==void 0&&V)await this.bridge.send("Emulation.setDeviceMetricsOverride",{mobile:!1,width:Q,height:0,deviceScaleFactor:1});let Z=Q??0,$=K??0;if(V){const J=await this.bridge.send("Page.getLayoutMetrics"),L=H(J)?J:{},Y=H(L.cssContentSize)?L.cssContentSize:void 0,A=H(L.contentSize)?L.contentSize:void 0,B=Y??A;if(B&&typeof B.width==="number"&&typeof B.height==="number"){if(Z===0)Z=Math.ceil(B.width);$=Math.ceil(B.height)}}await this.bridge.send("Emulation.setDeviceMetricsOverride",{mobile:!1,width:Z,height:$,deviceScaleFactor:1})}try{const Z=await this.bridge.send("Page.captureScreenshot",{format:G.format??"png",quality:G.format==="jpeg"?G.quality??80:void 0,captureBeyondViewport:!X&&V}),$=H(Z)&&typeof Z.data==="string"?Z.data:"";if(G.path)await M($,G.path);return $}finally{if(X)await this.bridge.send("Emulation.clearDeviceMetricsOverride").catch(()=>{})}}async startNetworkCapture(G=""){this._networkCapturePattern=G;if(!this._networkCapturing){this._networkEntries=[];this._pendingRequests.clear();this._pendingBodyFetches.clear();await this.bridge.send("Network.enable");this.bridge.on("Network.requestWillBeSent",(V)=>{const Q=V;if(!this._networkCapturePattern||Q.request.url.includes(this._networkCapturePattern)){const K=this._networkEntries.push({url:Q.request.url,method:Q.request.method,timestamp:Date.now()})-1;this._pendingRequests.set(Q.requestId,K)}});this.bridge.on("Network.responseReceived",(V)=>{const Q=V,K=this._pendingRequests.get(Q.requestId);if(K!==void 0){this._networkEntries[K].responseStatus=Q.response.status;this._networkEntries[K].responseContentType=Q.response.mimeType||""}});this.bridge.on("Network.loadingFinished",(V)=>{const Q=V,K=this._pendingRequests.get(Q.requestId);if(K!==void 0){const X=this.bridge.send("Network.getResponseBody",{requestId:Q.requestId}).then((Z)=>{const $=Z;if(typeof $?.body==="string"){const J=$.body.length,L=J>CDP_RESPONSE_BODY_CAPTURE_LIMIT,Y=L?$.body.slice(0,CDP_RESPONSE_BODY_CAPTURE_LIMIT):$.body;this._networkEntries[K].responsePreview=$.base64Encoded?`base64:${Y}`:Y;this._networkEntries[K].responseBodyFullSize=J;this._networkEntries[K].responseBodyTruncated=L}}).catch((Z)=>{if(process.env.OPENCLI_VERBOSE)console.error(`[cdp] getResponseBody failed for ${Q.requestId}:`,Z instanceof Error?Z.message:Z)}).finally(()=>{this._pendingBodyFetches.delete(X)});this._pendingBodyFetches.add(X);this._pendingRequests.delete(Q.requestId)}});this._networkCapturing=!0}return!0}async readNetworkCapture(){if(this._pendingBodyFetches.size>0)await Promise.all([...this._pendingBodyFetches]);const G=[...this._networkEntries];this._networkEntries=[];return G}async consoleMessages(G="all"){if(!this._consoleCapturing){await this.bridge.send("Runtime.enable");this.bridge.on("Runtime.consoleAPICalled",(V)=>{const Q=V,K=(Q.args||[]).map((X)=>X.value!==void 0?String(X.value):X.description||"").join(" ");this._consoleMessages.push({type:Q.type,text:K,timestamp:Date.now()});if(this._consoleMessages.length>500)this._consoleMessages.shift()});this.bridge.on("Runtime.exceptionThrown",(V)=>{const Q=V,K=Q.exceptionDetails?.exception?.description||Q.exceptionDetails?.text||"Unknown exception";this._consoleMessages.push({type:"error",text:K,timestamp:Date.now()});if(this._consoleMessages.length>500)this._consoleMessages.shift()});this._consoleCapturing=!0}if(G==="all")return[...this._consoleMessages];if(G==="error")return this._consoleMessages.filter((V)=>V.type==="error"||V.type==="warning");return this._consoleMessages.filter((V)=>V.type===G)}async tabs(){return[]}async selectTab(G){}async cdp(G,V={}){return this.bridge.send(G,V)}async handleJavaScriptDialog(G,V){await this.cdp("Page.handleJavaScriptDialog",{accept:G,...V!==void 0&&{promptText:V}})}async nativeClick(G,V){await this.cdp("Input.dispatchMouseEvent",{type:"mouseMoved",x:G,y:V});await this.cdp("Input.dispatchMouseEvent",{type:"mousePressed",x:G,y:V,button:"left",clickCount:1});await this.cdp("Input.dispatchMouseEvent",{type:"mouseReleased",x:G,y:V,button:"left",clickCount:1})}async nativeType(G){await this.cdp("Input.insertText",{text:G})}async insertText(G){await this.nativeType(G)}async nativeKeyPress(G,V=[]){let Q=0;for(const K of V){if(K==="Alt")Q|=1;if(K==="Ctrl"||K==="Control")Q|=2;if(K==="Meta")Q|=4;if(K==="Shift")Q|=8}await this.cdp("Input.dispatchKeyEvent",{type:"keyDown",key:G,modifiers:Q});await this.cdp("Input.dispatchKeyEvent",{type:"keyUp",key:G,modifiers:Q})}}function T(G){try{return new URL(G).hostname}catch{return}}function N(G){return H(G)&&typeof G.name==="string"&&typeof G.value==="string"&&typeof G.domain==="string"}function C(G,V){const Q=G.replace(/^\./,"").toLowerCase(),K=V.replace(/^\./,"").toLowerCase();return K===Q||K.endsWith(`.${Q}`)}function U(G){const V=b(process.env.OPENCLI_CDP_TARGET);return G.map((K,X)=>({target:K,index:X,score:q(K,V)})).filter(({score:K})=>Number.isFinite(K)).sort((K,X)=>{if(X.score!==K.score)return X.score-K.score;return K.index-X.index})[0]?.target}function q(G,V){if(!G.webSocketDebuggerUrl)return Number.NEGATIVE_INFINITY;const Q=(G.type??"").toLowerCase(),K=(G.url??"").toLowerCase(),X=(G.title??"").toLowerCase(),Z=`${X} ${K}`;if(!Z.trim()&&!Q)return Number.NEGATIVE_INFINITY;if(Z.includes("devtools"))return Number.NEGATIVE_INFINITY;if(Q==="background_page"||Q==="service_worker")return Number.NEGATIVE_INFINITY;let $=0;if(V&&V.test(Z))$+=1000;if(Q==="app")$+=120;else if(Q==="webview")$+=100;else if(Q==="page")$+=80;else if(Q==="iframe")$+=20;if(K.startsWith("http://localhost")||K.startsWith("https://localhost"))$+=90;if(K.startsWith("file://"))$+=60;if(K.startsWith("http://127.0.0.1")||K.startsWith("https://127.0.0.1"))$+=50;if(K.startsWith("about:blank"))$-=120;if(K===""||K==="about:blank")$-=40;if(X&&X!=="devtools")$+=25;const J=Object.values(w()).map((L)=>(L.displayName??L.processName).toLowerCase());for(const L of J)if(X.includes(L)){$+=120;break}for(const L of J)if(K.includes(L)){$+=100;break}return $}function b(G){const V=G?.trim();if(!V)return;return new RegExp(D(V.toLowerCase()))}function D(G){return G.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}export const __test__={selectCDPTarget:U,scoreCDPTarget:q};function j(G){return new Promise((V,Q)=>{const K=new URL(G),X=(K.protocol==="https:"?F:W)(K,(Z)=>{const $=Z.statusCode??0;if($<200||$>=300){Z.resume();Q(Error(`Failed to fetch CDP targets: HTTP ${$}`));return}const J=[];Z.on("data",(L)=>J.push(Buffer.isBuffer(L)?L:Buffer.from(L)));Z.on("end",()=>{try{V(JSON.parse(Buffer.concat(J).toString("utf8")))}catch(L){Q(L instanceof Error?L:Error(String(L)))}})});X.on("error",Q);X.setTimeout(1e4,()=>X.destroy(Error("Timed out fetching CDP targets")));X.end()})}
+import{WebSocket as p}from"ws";import{request as _}from"node:http";import{request as y}from"node:https";import{buildEvaluateExpression as E}from"./utils.js";import{generateStealthJs as b}from"./stealth.js";import{waitForDomStableJs as C}from"./dom-helpers.js";import{isRecord as l,saveBase64ToFile as P}from"../utils.js";import{getAllElectronApps as k}from"../electron-apps.js";import{BasePage as v}from"./base-page.js";const I=30000;export const CDP_RESPONSE_BODY_CAPTURE_LIMIT=8388608;export class CDPBridge{_ws=null;_idCounter=0;_pending=new Map;_eventListeners=new Map;async connect(e){if(this._ws)throw Error("CDPBridge is already connected. Call close() before reconnecting.");const n=e?.cdpEndpoint??process.env.OPENCLI_CDP_ENDPOINT;if(!n)throw Error("CDP endpoint not provided (pass cdpEndpoint or set OPENCLI_CDP_ENDPOINT)");let s=n;if(n.startsWith("http")){const t=await q(`${n.replace(/\/$/,"")}/json`),i=g(t);if(!i||!i.webSocketDebuggerUrl)throw Error("No inspectable targets found at CDP endpoint");s=i.webSocketDebuggerUrl}return new Promise((t,i)=>{const r=new p(s),o=(e?.timeout??10)*1000,d=setTimeout(()=>{this._ws=null;r.close();i(Error("CDP connect timeout"))},o);r.on("open",async()=>{clearTimeout(d);this._ws=r;try{await this.send("Page.enable");this.on("Page.javascriptDialogOpening",(c)=>{if(c?.type==="beforeunload")this.send("Page.handleJavaScriptDialog",{accept:!0}).catch(()=>{})});await this.send("Page.addScriptToEvaluateOnNewDocument",{source:b()});if(e?.initScript)await this.send("Page.addScriptToEvaluateOnNewDocument",{source:e.initScript});if(e?.windowMode==="background")await this.send("Emulation.setFocusEmulationEnabled",{enabled:!0}).catch(()=>{});else if(e?.windowMode==="foreground")await this.send("Page.bringToFront").catch(()=>{});if(e?.proxyAuth){this.on("Fetch.requestPaused",(c)=>{const u=c;if(u.requestId)this.send("Fetch.continueRequest",{requestId:u.requestId}).catch(()=>{})});this.on("Fetch.authRequired",(c)=>{const u=c;if(!u.requestId)return;this.send("Fetch.continueWithAuth",{requestId:u.requestId,authChallengeResponse:{response:"ProvideCredentials",username:e.proxyAuth.username,password:e.proxyAuth.password}}).catch(()=>{})});await this.send("Fetch.enable",{handleAuthRequests:!0})}}catch(c){r.close();i(c instanceof Error?c:Error(String(c)));return}const a=new m(this);if(e?.session)a.session=e.session;if(e?.contextId)a.contextId=e.contextId;t(a)});r.on("error",(a)=>{clearTimeout(d);i(a)});r.on("message",(a)=>{try{const c=JSON.parse(a.toString());if(c.id&&this._pending.has(c.id)){const u=this._pending.get(c.id);clearTimeout(u.timer);this._pending.delete(c.id);if(c.error)u.reject(Error(c.error.message));else u.resolve(c.result)}if(c.method){const u=this._eventListeners.get(c.method);if(u)for(const h of u)h(c.params)}}catch(c){if(process.env.OPENCLI_VERBOSE)console.error("[cdp] Failed to parse WebSocket message:",c instanceof Error?c.message:c)}})})}async close(){if(this._ws){this._ws.close();this._ws=null}for(const e of this._pending.values()){clearTimeout(e.timer);e.reject(Error("CDP connection closed"))}this._pending.clear();this._eventListeners.clear()}async send(e,n={},s=I){if(!this._ws||this._ws.readyState!==p.OPEN)throw Error("CDP connection is not open");const t=++this._idCounter;return new Promise((i,r)=>{const o=setTimeout(()=>{this._pending.delete(t);const d=e.startsWith("Page.")?"（页面可能被 JS 弹窗挡住：试 `ppcli browser dialog accept`；托管 profile 可 `ppcli profile stop <name>` 关闭后重跑命令自动重启会话）":"";r(Error(`CDP command '${e}' timed out after ${s/1000}s${d}`))},s);this._pending.set(t,{resolve:i,reject:r,timer:o});this._ws.send(JSON.stringify({id:t,method:e,params:n}))})}on(e,n){let s=this._eventListeners.get(e);if(!s){s=new Set;this._eventListeners.set(e,s)}s.add(n)}off(e,n){this._eventListeners.get(e)?.delete(n)}waitForEvent(e,n=15000){return new Promise((s,t)=>{const i=setTimeout(()=>{this.off(e,r);t(Error(`Timed out waiting for CDP event '${e}'`))},n),r=(o)=>{clearTimeout(i);this.off(e,r);s(o)};this.on(e,r)})}}class m extends v{bridge;session;contextId;_pageEnabled=!1;_networkCapturing=!1;_networkCapturePattern="";_networkEntries=[];_pendingRequests=new Map;_pendingBodyFetches=new Set;_consoleMessages=[];_consoleCapturing=!1;constructor(e){super();this.bridge=e}async goto(e,n){if(!this._pageEnabled){await this.bridge.send("Page.enable");this._pageEnabled=!0}const s=this.bridge.waitForEvent("Page.loadEventFired",30000).catch(()=>{});await this.bridge.send("Page.navigate",{url:e});await s;this._lastUrl=e;if(n?.waitUntil!=="none"){const t=n?.settleMs??1000;await this.evaluate(C(t,Math.min(500,t)))}}async evaluate(e,...n){const s=E(e,n),t=await this.bridge.send("Runtime.evaluate",{expression:s,returnByValue:!0,awaitPromise:!0});if(t.exceptionDetails)throw Error("Evaluate error: "+(t.exceptionDetails.exception?.description||"Unknown exception"));return t.result?.value}async getCookies(e={}){let n;try{const t=await this.bridge.send("Storage.getCookies");n=l(t)&&Array.isArray(t.cookies)?t.cookies:[]}catch{const t=await this.bridge.send("Network.getCookies",e.url?{urls:[e.url]}:{});n=l(t)&&Array.isArray(t.cookies)?t.cookies:[]}const s=e.domain??(e.url?D(e.url):void 0);return s?n.filter((t)=>f(t)&&N(t.domain,s)):n.filter(f)}async screenshot(e={}){const n=e.fullPage===!0,s=e.width&&e.width>0?Math.ceil(e.width):void 0,t=!n&&e.height&&e.height>0?Math.ceil(e.height):void 0,i=s!==void 0||t!==void 0;if(i){if(s!==void 0&&n)await this.bridge.send("Emulation.setDeviceMetricsOverride",{mobile:!1,width:s,height:0,deviceScaleFactor:1});let r=s??0,o=t??0;if(n){const d=await this.bridge.send("Page.getLayoutMetrics"),a=l(d)?d:{},c=l(a.cssContentSize)?a.cssContentSize:void 0,u=l(a.contentSize)?a.contentSize:void 0,h=c??u;if(h&&typeof h.width==="number"&&typeof h.height==="number"){if(r===0)r=Math.ceil(h.width);o=Math.ceil(h.height)}}await this.bridge.send("Emulation.setDeviceMetricsOverride",{mobile:!1,width:r,height:o,deviceScaleFactor:1})}try{const r=await this.bridge.send("Page.captureScreenshot",{format:e.format??"png",quality:e.format==="jpeg"?e.quality??80:void 0,captureBeyondViewport:!i&&n}),o=l(r)&&typeof r.data==="string"?r.data:"";if(e.path)await P(o,e.path);return o}finally{if(i)await this.bridge.send("Emulation.clearDeviceMetricsOverride").catch(()=>{})}}async startNetworkCapture(e=""){this._networkCapturePattern=e;if(!this._networkCapturing){this._networkEntries=[];this._pendingRequests.clear();this._pendingBodyFetches.clear();await this.bridge.send("Network.enable");this.bridge.on("Network.requestWillBeSent",(n)=>{const s=n;if(!this._networkCapturePattern||s.request.url.includes(this._networkCapturePattern)){const t=this._networkEntries.push({url:s.request.url,method:s.request.method,timestamp:Date.now()})-1;this._pendingRequests.set(s.requestId,t)}});this.bridge.on("Network.responseReceived",(n)=>{const s=n,t=this._pendingRequests.get(s.requestId);if(t!==void 0){this._networkEntries[t].responseStatus=s.response.status;this._networkEntries[t].responseContentType=s.response.mimeType||""}});this.bridge.on("Network.loadingFinished",(n)=>{const s=n,t=this._pendingRequests.get(s.requestId);if(t!==void 0){const i=this.bridge.send("Network.getResponseBody",{requestId:s.requestId}).then((r)=>{const o=r;if(typeof o?.body==="string"){const d=o.body.length,a=d>CDP_RESPONSE_BODY_CAPTURE_LIMIT,c=a?o.body.slice(0,CDP_RESPONSE_BODY_CAPTURE_LIMIT):o.body;this._networkEntries[t].responsePreview=o.base64Encoded?`base64:${c}`:c;this._networkEntries[t].responseBodyFullSize=d;this._networkEntries[t].responseBodyTruncated=a}}).catch((r)=>{if(process.env.OPENCLI_VERBOSE)console.error(`[cdp] getResponseBody failed for ${s.requestId}:`,r instanceof Error?r.message:r)}).finally(()=>{this._pendingBodyFetches.delete(i)});this._pendingBodyFetches.add(i);this._pendingRequests.delete(s.requestId)}});this._networkCapturing=!0}return!0}async readNetworkCapture(){if(this._pendingBodyFetches.size>0)await Promise.all([...this._pendingBodyFetches]);const e=[...this._networkEntries];this._networkEntries=[];return e}async consoleMessages(e="all"){if(!this._consoleCapturing){await this.bridge.send("Runtime.enable");this.bridge.on("Runtime.consoleAPICalled",(n)=>{const s=n,t=(s.args||[]).map((i)=>i.value!==void 0?String(i.value):i.description||"").join(" ");this._consoleMessages.push({type:s.type,text:t,timestamp:Date.now()});if(this._consoleMessages.length>500)this._consoleMessages.shift()});this.bridge.on("Runtime.exceptionThrown",(n)=>{const s=n,t=s.exceptionDetails?.exception?.description||s.exceptionDetails?.text||"Unknown exception";this._consoleMessages.push({type:"error",text:t,timestamp:Date.now()});if(this._consoleMessages.length>500)this._consoleMessages.shift()});this._consoleCapturing=!0}if(e==="all")return[...this._consoleMessages];if(e==="error")return this._consoleMessages.filter((n)=>n.type==="error"||n.type==="warning");return this._consoleMessages.filter((n)=>n.type===e)}async tabs(){return[]}async selectTab(e){}async cdp(e,n={}){return this.bridge.send(e,n)}async handleJavaScriptDialog(e,n){await this.cdp("Page.handleJavaScriptDialog",{accept:e,...n!==void 0&&{promptText:n}})}async nativeClick(e,n){await this.cdp("Input.dispatchMouseEvent",{type:"mouseMoved",x:e,y:n});await this.cdp("Input.dispatchMouseEvent",{type:"mousePressed",x:e,y:n,button:"left",clickCount:1});await this.cdp("Input.dispatchMouseEvent",{type:"mouseReleased",x:e,y:n,button:"left",clickCount:1})}async nativeType(e){await this.cdp("Input.insertText",{text:e})}async insertText(e){await this.nativeType(e)}async nativeKeyPress(e,n=[]){let s=0;for(const t of n){if(t==="Alt")s|=1;if(t==="Ctrl"||t==="Control")s|=2;if(t==="Meta")s|=4;if(t==="Shift")s|=8}await this.cdp("Input.dispatchKeyEvent",{type:"keyDown",key:e,modifiers:s});await this.cdp("Input.dispatchKeyEvent",{type:"keyUp",key:e,modifiers:s})}}function D(e){try{return new URL(e).hostname}catch{return}}function f(e){return l(e)&&typeof e.name==="string"&&typeof e.value==="string"&&typeof e.domain==="string"}function N(e,n){const s=e.replace(/^\./,"").toLowerCase(),t=n.replace(/^\./,"").toLowerCase();return t===s||t.endsWith(`.${s}`)}function g(e){const n=S(process.env.OPENCLI_CDP_TARGET);return e.map((t,i)=>({target:t,index:i,score:w(t,n)})).filter(({score:t})=>Number.isFinite(t)).sort((t,i)=>{if(i.score!==t.score)return i.score-t.score;return t.index-i.index})[0]?.target}function w(e,n){if(!e.webSocketDebuggerUrl)return Number.NEGATIVE_INFINITY;const s=(e.type??"").toLowerCase(),t=(e.url??"").toLowerCase(),i=(e.title??"").toLowerCase(),r=`${i} ${t}`;if(!r.trim()&&!s)return Number.NEGATIVE_INFINITY;if(r.includes("devtools"))return Number.NEGATIVE_INFINITY;if(s==="background_page"||s==="service_worker")return Number.NEGATIVE_INFINITY;let o=0;if(n&&n.test(r))o+=1000;if(s==="app")o+=120;else if(s==="webview")o+=100;else if(s==="page")o+=80;else if(s==="iframe")o+=20;if(t.startsWith("http://localhost")||t.startsWith("https://localhost"))o+=90;if(t.startsWith("file://"))o+=60;if(t.startsWith("http://127.0.0.1")||t.startsWith("https://127.0.0.1"))o+=50;if(t.startsWith("about:blank"))o-=120;if(t===""||t==="about:blank")o-=40;if(i&&i!=="devtools")o+=25;const d=Object.values(k()).map((a)=>(a.displayName??a.processName).toLowerCase());for(const a of d)if(i.includes(a)){o+=120;break}for(const a of d)if(t.includes(a)){o+=100;break}return o}function S(e){const n=e?.trim();if(!n)return;return new RegExp(T(n.toLowerCase()))}function T(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}export const __test__={selectCDPTarget:g,scoreCDPTarget:w};function q(e){return new Promise((n,s)=>{const t=new URL(e),i=(t.protocol==="https:"?y:_)(t,(r)=>{const o=r.statusCode??0;if(o<200||o>=300){r.resume();s(Error(`Failed to fetch CDP targets: HTTP ${o}`));return}const d=[];r.on("data",(a)=>d.push(Buffer.isBuffer(a)?a:Buffer.from(a)));r.on("end",()=>{try{n(JSON.parse(Buffer.concat(d).toString("utf8")))}catch(a){s(a instanceof Error?a:Error(String(a)))}})});i.on("error",s);i.setTimeout(1e4,()=>i.destroy(Error("Timed out fetching CDP targets")));i.end()})}

package/dist/src/browser/daemon-client.js

@@ -1 +1 @@
-import{sleep as U}from"../utils.js";import{BrowserConnectError as p,SessionBusyError as x}from"../errors.js";import{COMMAND_RESULT_UNKNOWN_CODE as q,COMMAND_RESULT_UNKNOWN_HINT as P}from"../daemon-utils.js";import{classifyBrowserError as w}from"./errors.js";import{resolveProfileContextId as M}from"./profile.js";import{DEFAULT_BROWSER_CONNECT_TIMEOUT as T}from"./config.js";import{ensureBrowserBridgeReady as l}from"./daemon-lifecycle.js";import{isPreDispatchError as O}from"./bridge-readiness.js";import{fetchDaemonStatus,getDaemonHealth,requestDaemon as g,requestDaemonShutdown}from"./daemon-transport.js";let A=0;function f(){return`cmd_${process.pid}_${Date.now()}_${++A}`}export function generateRunId(){return`run_${process.pid}_${Date.now()}_${++A}`}let F=null;export function setDaemonRunContext(z){F=z}export function clearDaemonRunContext(z){if(F?.runId===z)F=null}export async function releaseSiteSessionLease(z){try{await g("/command",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({id:f(),action:"lease-release",runId:z.runId,session:z.session,surface:z.surface}),timeout:2000})}catch{}}const E=120,C=15000,_=1e4;let D=null;export function setDaemonCommandTimeoutSeconds(z){D=typeof z==="number"&&z>0?Math.ceil(z):null}function N(z){const Q=D??E;if(typeof z.timeoutMs==="number"&&z.timeoutMs>0)return Math.max(Q,Math.ceil((z.timeoutMs+C)/1000));return Q}const c="1.1.0";function i(z,Q){if(!z)return!1;const Y=z.replace(/^v/,"").split("-")[0].split(".").map(Number),$=Q.split(".").map(Number);if(Y.length<3||Y.some(Number.isNaN))return!1;for(let V=0;V<3;V++){const k=Y[V]-($[V]??0);if(k!==0)return k>0}return!0}const I=new Set(["command_result_unknown","command_lost","result_evicted"]);export function isUnknownOutcomeError(z){const Q=new Set;let Y=z;while(Y&&typeof Y==="object"&&!Q.has(Y)){Q.add(Y);const $=Y.code;if(typeof $==="string"&&I.has($))return!0;Y=Y.cause}return!1}const u=4,m=new Set(["ECONNREFUSED","UND_ERR_CONNECT_TIMEOUT","EHOSTUNREACH","ENETUNREACH","ENOTFOUND"]);function d(z){const Q=[z],Y=new Set;while(Q.length){const $=Q.pop();if(!$||typeof $!=="object"||Y.has($))continue;Y.add($);const{code:V,cause:k,errors:X}=$;if(typeof V==="string"&&m.has(V))return!0;if(k)Q.push(k);if(Array.isArray(X))Q.push(...X)}return!1}export class BrowserCommandError extends Error{code;hint;constructor(z,Q,Y){super(z);this.code=Q;this.hint=Y;this.name="BrowserCommandError"}}export{fetchDaemonStatus,getDaemonHealth,requestDaemonShutdown};async function R(z,Q){const Y=N(Q),$=Date.now()+Y*1000,V=process.env.OPENCLI_WINDOW,k=V==="foreground"||V==="background"?V:void 0,X=Q.contextId??M(),y=Q.windowMode??k,B=z==="navigate";let v=!1,j=f(),b=!1,L=!1,K=null;const H=async()=>{const J=Math.ceil(($-Date.now())/1000),h=await l({timeoutSeconds:Math.max(1,Math.min(T,J)),contextId:X,verbose:!1});K=i(h.health.status?.extensionVersion,c)};for(let J=1;J<=u;J++){if(J>1&&Date.now()>=$)throw new BrowserCommandError("Browser command deadline exhausted across transport retries.",q,P);const h=Math.max(1000,$-Date.now()),S={id:j,action:z,...Q,timeout:Y,deadlineAt:$,...X&&{contextId:X},...y&&{windowMode:y},...F&&{runId:F.runId,command:F.command,access:F.access}};try{const Z=await(await g("/command",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(S),timeout:h+_})).json();if(Z.ok)return Z;if(Z.errorCode==="session_busy")throw new x(Z.error??"The site session is busy.",Z.errorHint);if(Z.errorCode&&I.has(Z.errorCode)){if(B&&!v){v=!0;j=f();await H();continue}throw new BrowserCommandError(Z.error??"Browser command result is unknown",Z.errorCode,Z.errorHint)}if(O(Z.errorCode)&&!b){b=!0;await H();continue}if(Z.errorCode==="daemon_shutting_down"&&!b){b=!0;await H();if(K)continue;throw new BrowserCommandError(Z.error??"Daemon shut down mid-command; the command may have already been applied.",q,P)}const W=w(new BrowserCommandError(Z.error??"",Z.errorCode));if(W.kind==="extension-transient"&&!L){L=!0;j=f();await U(W.delayMs);continue}throw new BrowserCommandError(Z.error??"Daemon command failed",Z.errorCode,Z.errorHint)}catch(G){if(G instanceof BrowserCommandError||G instanceof p||G instanceof x)throw G;if(G instanceof Error&&G.name==="AbortError")throw new BrowserCommandError("Browser command timed out client-side; the page may still have applied it.",q,P);if(G instanceof TypeError){await H();if(K||d(G))continue;throw new BrowserCommandError("Connection to the daemon was lost mid-command; it may have already been applied.",q,P)}throw G}}throw new BrowserCommandError("sendCommand: max attempts exhausted","max_attempts_exhausted")}export async function sendCommand(z,Q={}){return(await R(z,Q)).data}export async function sendCommandFull(z,Q={}){const Y=await R(z,Q);return{data:Y.data,page:Y.page}}export async function bindTab(z,Q={}){return sendCommand("bind",{session:z,surface:"browser",...Q})}
+import{sleep as b}from"../utils.js";import{BrowserConnectError as g,SessionBusyError as C}from"../errors.js";import{COMMAND_RESULT_UNKNOWN_CODE as l,COMMAND_RESULT_UNKNOWN_HINT as h}from"../daemon-utils.js";import{classifyBrowserError as A}from"./errors.js";import{resolveProfileContextId as v}from"./profile.js";import{DEFAULT_BROWSER_CONNECT_TIMEOUT as P}from"./config.js";import{ensureBrowserBridgeReady as H}from"./daemon-lifecycle.js";import{isPreDispatchError as L}from"./bridge-readiness.js";import{fetchDaemonStatus,getDaemonHealth,requestDaemon as M,requestDaemonShutdown}from"./daemon-transport.js";let S=0;function p(){return`cmd_${process.pid}_${Date.now()}_${++S}`}export function generateRunId(){return`run_${process.pid}_${Date.now()}_${++S}`}let c=null;export function setDaemonRunContext(e){c=e}export function clearDaemonRunContext(e){if(c?.runId===e)c=null}export async function releaseSiteSessionLease(e){try{await M("/command",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({id:p(),action:"lease-release",runId:e.runId,session:e.session,surface:e.surface}),timeout:2000})}catch{}}const W=120,k=15000,F=1e4;let x=null;export function setDaemonCommandTimeoutSeconds(e){x=typeof e==="number"&&e>0?Math.ceil(e):null}function j(e){const t=x??W;if(typeof e.timeoutMs==="number"&&e.timeoutMs>0)return Math.max(t,Math.ceil((e.timeoutMs+k)/1000));return t}const J="1.1.0";function q(e,t){if(!e)return!1;const n=e.replace(/^v/,"").split("-")[0].split(".").map(Number),r=t.split(".").map(Number);if(n.length<3||n.some(Number.isNaN))return!1;for(let s=0;s<3;s++){const a=n[s]-(r[s]??0);if(a!==0)return a>0}return!0}const D=new Set(["command_result_unknown","command_lost","result_evicted"]);export function isUnknownOutcomeError(e){const t=new Set;let n=e;while(n&&typeof n==="object"&&!t.has(n)){t.add(n);const r=n.code;if(typeof r==="string"&&D.has(r))return!0;n=n.cause}return!1}const B=4,K=new Set(["ECONNREFUSED","UND_ERR_CONNECT_TIMEOUT","EHOSTUNREACH","ENETUNREACH","ENOTFOUND"]);function X(e){const t=[e],n=new Set;while(t.length){const r=t.pop();if(!r||typeof r!=="object"||n.has(r))continue;n.add(r);const{code:s,cause:a,errors:u}=r;if(typeof s==="string"&&K.has(s))return!0;if(a)t.push(a);if(Array.isArray(u))t.push(...u)}return!1}export class BrowserCommandError extends Error{code;hint;constructor(e,t,n){super(e);this.code=t;this.hint=n;this.name="BrowserCommandError"}}export{fetchDaemonStatus,getDaemonHealth,requestDaemonShutdown};async function R(e,t){const n=j(t),r=Date.now()+n*1000,s=process.env.OPENCLI_WINDOW,a=s==="foreground"||s==="background"?s:void 0,u=t.contextId??v(),T=t.windowMode??a,I=e==="navigate";let E=!1,w=p(),m=!1,O=!1,_=null;const f=async()=>{const d=Math.ceil((r-Date.now())/1000),N=await H({timeoutSeconds:Math.max(1,Math.min(P,d)),contextId:u,verbose:!1});_=q(N.health.status?.extensionVersion,J)};for(let d=1;d<=B;d++){if(d>1&&Date.now()>=r)throw new BrowserCommandError("Browser command deadline exhausted across transport retries.",l,h);const N=Math.max(1000,r-Date.now()),U={id:w,action:e,...t,timeout:n,deadlineAt:r,...u&&{contextId:u},...T&&{windowMode:T},...c&&{runId:c.runId,command:c.command,access:c.access}};try{const o=await(await M("/command",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(U),timeout:N+F})).json();if(o.ok)return o;if(o.errorCode==="session_busy")throw new C(o.error??"The site session is busy.",o.errorHint);if(o.errorCode&&D.has(o.errorCode)){if(I&&!E){E=!0;w=p();await f();continue}throw new BrowserCommandError(o.error??"Browser command result is unknown",o.errorCode,o.errorHint)}if(L(o.errorCode)&&!m){m=!0;await f();continue}if(o.errorCode==="daemon_shutting_down"&&!m){m=!0;await f();if(_)continue;throw new BrowserCommandError(o.error??"Daemon shut down mid-command; the command may have already been applied.",l,h)}const y=A(new BrowserCommandError(o.error??"",o.errorCode));if(y.kind==="extension-transient"&&!O){O=!0;w=p();await b(y.delayMs);continue}throw new BrowserCommandError(o.error??"Daemon command failed",o.errorCode,o.errorHint)}catch(i){if(i instanceof BrowserCommandError||i instanceof g||i instanceof C)throw i;if(i instanceof Error&&i.name==="AbortError")throw new BrowserCommandError("Browser command timed out client-side; the page may still have applied it.",l,h);if(i instanceof TypeError){await f();if(_||X(i))continue;throw new BrowserCommandError("Connection to the daemon was lost mid-command; it may have already been applied.",l,h)}throw i}}throw new BrowserCommandError("sendCommand: max attempts exhausted","max_attempts_exhausted")}export async function sendCommand(e,t={}){return(await R(e,t)).data}export async function sendCommandFull(e,t={}){const n=await R(e,t);return{data:n.data,page:n.page}}export async function bindTab(e,t={}){return sendCommand("bind",{session:e,surface:"browser",...t})}

package/dist/src/browser/daemon-lifecycle.js

@@ -1,9 +1,9 @@
-import{spawn as V}from"node:child_process";import{fileURLToPath as b}from"node:url";import*as x from"node:fs";import*as K from"node:path";import{DEFAULT_DAEMON_PORT}from"../constants.js";import{BrowserConnectError as J}from"../errors.js";import{PKG_VERSION as j}from"../version.js";import{waitForBridgeReady as F}from"./bridge-readiness.js";import{fetchDaemonStatus as B,getDaemonHealth as y,requestDaemonShutdown as C}from"./daemon-transport.js";export function resolveDaemonLaunchSpec(){const z=K.dirname(b(import.meta.url)),Q=K.resolve(z,".."),W=K.join(Q,"daemon.ts"),Z=K.join(Q,"daemon.js"),Y=x.existsSync(W),X=Y?W:Z,$=!!process.versions?.bun,U=Y&&!$;return{binary:process.execPath,args:U?["--import","tsx/esm",X]:[X],scriptPath:X}}export function spawnDaemonProcess(){const z=resolveDaemonLaunchSpec(),Q=V(z.binary,z.args,{detached:!0,stdio:"ignore",env:{...process.env}});Q.unref();return Q}export async function waitForDaemonStop(z){const Q=Date.now()+z;while(Date.now()<Q){await O(200);if((await y()).state==="stopped")return!0}return!1}export async function waitForDaemonStatus(z){const Q=Date.now()+z;while(Date.now()<Q){const W=await B({timeout:Math.min(1000,Math.max(100,Q-Date.now()))});if(W)return W;await O(200)}return null}export const daemonLifecycleHooks={requestDaemonShutdown:C,spawnDaemonProcess,waitForDaemonStop};export async function restartDaemon(z={}){const Q=await B();let W=Q===null;if(Q){W=await C()&&await waitForDaemonStop(z.stopTimeoutMs??3000);if(!W)return{previousStatus:Q,status:Q,stopped:!1,spawned:!1}}spawnDaemonProcess();const Z=await waitForDaemonStatus(z.startTimeoutMs??5000);return{previousStatus:Q,status:Z,stopped:W,spawned:!0}}export async function ensureBrowserBridgeReady(z={}){const W=(z.timeoutSeconds&&z.timeoutSeconds>0?z.timeoutSeconds:10)*1000,Z=z.verbose??!0,Y=z.contextId,X=await y({contextId:Y}),$=X.status?.daemonVersion,U=!!X.status&&(!$||$!==j);let q=!1,k=null;if(U){const N=$?`v${$} ≠ v${j}`:`pre-version daemon, CLI is v${j}`;if(Z&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY))process.stderr.write(`⚠️  Stale daemon detected (${N}). Restarting...
-`);let g=await daemonLifecycleHooks.requestDaemonShutdown()&&await daemonLifecycleHooks.waitForDaemonStop(3000);if(!g){const G=X.status?.pid;if(typeof G==="number"&&Number.isInteger(G)&&G>0){try{process.kill(G,"SIGKILL")}catch{}g=await daemonLifecycleHooks.waitForDaemonStop(2000)}}if(!g)throw new J("Stale daemon could not be replaced",`A stale daemon (${N}) is running but did not shut down (graceful + SIGKILL both failed).
-  Run manually: ppcli daemon stop`,"daemon-not-running");q=!0}if(!q&&X.state==="ready")return{health:X,spawnedProcess:k};if(!q&&X.state==="profile-required")throw M(X,Y);if(q||X.state==="stopped"){if(Z&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY))process.stderr.write(`⏳ Starting daemon...
-`);k=daemonLifecycleHooks.spawnDaemonProcess()}else if(Z&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY)){process.stderr.write(`⏳ Waiting for Chrome/Chromium extension to connect...
+import{spawn as y}from"node:child_process";import{fileURLToPath as g}from"node:url";import*as v from"node:fs";import*as d from"node:path";import{DEFAULT_DAEMON_PORT}from"../constants.js";import{BrowserConnectError as i}from"../errors.js";import{PKG_VERSION as w}from"../version.js";import{waitForBridgeReady as E}from"./bridge-readiness.js";import{fetchDaemonStatus as P,getDaemonHealth as h,requestDaemonShutdown as D}from"./daemon-transport.js";export function resolveDaemonLaunchSpec(){const e=d.dirname(g(import.meta.url)),t=d.resolve(e,".."),o=d.join(t,"daemon.ts"),s=d.join(t,"daemon.js"),r=v.existsSync(o),n=r?o:s,a=!!process.versions?.bun,p=r&&!a;return{binary:process.execPath,args:p?["--import","tsx/esm",n]:[n],scriptPath:n}}export function spawnDaemonProcess(){const e=resolveDaemonLaunchSpec(),t=y(e.binary,e.args,{detached:!0,stdio:"ignore",env:{...process.env}});t.unref();return t}export async function waitForDaemonStop(e){const t=Date.now()+e;while(Date.now()<t){await b(200);if((await h()).state==="stopped")return!0}return!1}export async function waitForDaemonStatus(e){const t=Date.now()+e;while(Date.now()<t){const o=await P({timeout:Math.min(1000,Math.max(100,t-Date.now()))});if(o)return o;await b(200)}return null}export const daemonLifecycleHooks={requestDaemonShutdown:D,spawnDaemonProcess,waitForDaemonStop};export async function restartDaemon(e={}){const t=await P();let o=t===null;if(t){o=await D()&&await waitForDaemonStop(e.stopTimeoutMs??3000);if(!o)return{previousStatus:t,status:t,stopped:!1,spawned:!1}}spawnDaemonProcess();const s=await waitForDaemonStatus(e.startTimeoutMs??5000);return{previousStatus:t,status:s,stopped:o,spawned:!0}}export async function ensureBrowserBridgeReady(e={}){const o=(e.timeoutSeconds&&e.timeoutSeconds>0?e.timeoutSeconds:10)*1000,s=e.verbose??!0,r=e.contextId,n=await h({contextId:r}),a=n.status?.daemonVersion,p=!!n.status&&(!a||a!==w);let c=!1,m=null;if(p){const S=a?`v${a} ≠ v${w}`:`pre-version daemon, CLI is v${w}`;if(s&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY))process.stderr.write(`⚠️  Stale daemon detected (${S}). Restarting...
+`);let f=await daemonLifecycleHooks.requestDaemonShutdown()&&await daemonLifecycleHooks.waitForDaemonStop(3000);if(!f){const u=n.status?.pid;if(typeof u==="number"&&Number.isInteger(u)&&u>0){try{process.kill(u,"SIGKILL")}catch{}f=await daemonLifecycleHooks.waitForDaemonStop(2000)}}if(!f)throw new i("Stale daemon could not be replaced",`A stale daemon (${S}) is running but did not shut down (graceful + SIGKILL both failed).
+  Run manually: ppcli daemon stop`,"daemon-not-running");c=!0}if(!c&&n.state==="ready")return{health:n,spawnedProcess:m};if(!c&&n.state==="profile-required")throw x(n,r);if(c||n.state==="stopped"){if(s&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY))process.stderr.write(`⏳ Starting daemon...
+`);m=daemonLifecycleHooks.spawnDaemonProcess()}else if(s&&(process.env.OPENCLI_VERBOSE||process.stderr.isTTY)){process.stderr.write(`⏳ Waiting for Chrome/Chromium extension to connect...
 `);process.stderr.write(`   Make sure Chrome or Chromium is open and the ppcli extension is enabled.
-`)}const A=await F(y,{timeoutMs:W,contextId:Y});if(A.state==="ready")return{health:A,spawnedProcess:k};throw M(A,Y)}function M(z,Q){if(z.state==="profile-required")return new J("Multiple Browser Bridge profiles are connected",`Select one with --profile <name>, OPENCLI_PROFILE=<name>, or ppcli profile use <name>.
-Run ppcli profile list to see connected profiles.`,"profile-required");if(z.state==="profile-disconnected"){const W=Q??z.status.contextId??"unknown";return new J(`浏览器环境 "${W}" 未连接`,`这台机器上名为 "${W}" 的浏览器环境当前没连上。请用户打开 PublishPort 客户端，`+"在「高级设置 → 环境」里确认该环境已启动；或改用其它环境（--profile <名字>），"+"不带 --profile 则用默认环境。这是设备侧环境问题，重试同一条命令不会好转，请先告知用户。","profile-disconnected")}if(z.state==="no-extension")return new J("浏览器桥未连接","这台机器上的 PublishPort 托管浏览器当前没在运行（或浏览器插件被禁用了）。"+"请用户打开 PublishPort 客户端，在平台列表里点一次「检测登录」，客户端会把托管浏览器拉起来；"+"若仍不行，重启一次 PublishPort 客户端。这是设备侧环境问题，重试同一条命令不会好转，请先告知用户。","extension-not-connected");return new J("Failed to start ppcli daemon",`Try running manually:
+`)}const l=await E(h,{timeoutMs:o,contextId:r});if(l.state==="ready")return{health:l,spawnedProcess:m};throw x(l,r)}function x(e,t){if(e.state==="profile-required")return new i("Multiple Browser Bridge profiles are connected",`Select one with --profile <name>, OPENCLI_PROFILE=<name>, or ppcli profile use <name>.
+Run ppcli profile list to see connected profiles.`,"profile-required");if(e.state==="profile-disconnected"){const o=t??e.status.contextId??"unknown";return new i(`浏览器环境 "${o}" 未连接`,`这台机器上名为 "${o}" 的浏览器环境当前没连上。请用户打开 PublishPort 客户端，`+"在「高级设置 → 环境」里确认该环境已启动；或改用其它环境（--profile <名字>），"+"不带 --profile 则用默认环境。这是设备侧环境问题，重试同一条命令不会好转，请先告知用户。","profile-disconnected")}if(e.state==="no-extension")return new i("浏览器桥未连接","这台机器上的 PublishPort 托管浏览器当前没在运行（或浏览器插件被禁用了）。"+"请用户打开 PublishPort 客户端，在平台列表里点一次「检测登录」，客户端会把托管浏览器拉起来；"+"若仍不行，重启一次 PublishPort 客户端。这是设备侧环境问题，重试同一条命令不会好转，请先告知用户。","extension-not-connected");return new i("Failed to start ppcli daemon",`Try running manually:
   node ${resolveDaemonLaunchSpec().scriptPath}
-Make sure port ${DEFAULT_DAEMON_PORT} is available.`,"daemon-not-running")}function O(z){return new Promise((Q)=>setTimeout(Q,z))}export{DEFAULT_DAEMON_PORT};
+Make sure port ${DEFAULT_DAEMON_PORT} is available.`,"daemon-not-running")}function b(e){return new Promise((t)=>setTimeout(t,e))}export{DEFAULT_DAEMON_PORT};