publishport-opencli 1.0.0

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

@@ -0,0 +1,225 @@
+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(`
+`);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(`
+      (async () => {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), request.timeoutMs);
+        try {
+          const headers = { Accept: 'application/json', ...request.headers };
+          const init = {
+            method: request.method,
+            credentials: 'include',
+            headers,
+            signal: ctrl.signal,
+          };
+          if (request.hasBody) {
+            if (!Object.keys(headers).some((key) => key.toLowerCase() === 'content-type')) {
+              headers['Content-Type'] = 'application/json';
+            }
+            init.body = JSON.stringify(request.body);
+          }
+          const resp = await fetch(request.url, init);
+          const text = await resp.text();
+          return {
+            ok: resp.ok,
+            status: resp.status,
+            statusText: resp.statusText,
+            url: resp.url,
+            contentType: resp.headers.get('content-type') || '',
+            text,
+          };
+        } catch (error) {
+          return {
+            ok: false,
+            status: 0,
+            statusText: '',
+            url: request.url,
+            contentType: '',
+            text: '',
+            error: error instanceof Error ? error.message : String(error),
+          };
+        } finally {
+          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}));if(_?.visible===!0){if(await this.tryNativeClick(_.x,_.y))return Q}const $=await this.evaluate(x({skipScroll:Z}));if(typeof $==="string"||$==null)return Q;if($.status==="clicked")return Q;if($.x!=null&&$.y!=null){if(await this.tryNativeClick($.x,$.y))return Q}throw Error(`Click failed: ${$.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}}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(`
+        (() => {
+          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(`
+        (() => {
+          const el = window.__resolved;
+          if (!el || el.nodeType !== 1 || typeof el.setAttribute !== 'function') {
+            return { ok: false };
+          }
+          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(`
+          (() => {
+            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(`
+      (() => {
+        const el = window.__resolved;
+        if (!el) throw new Error('No resolved element');
+        if (${Q?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        const rect = el.getBoundingClientRect();
+        const init = {
+          bubbles: true,
+          cancelable: true,
+          view: window,
+          clientX: Math.round(rect.left + rect.width / 2),
+          clientY: Math.round(rect.top + rect.height / 2),
+        };
+        try { el.dispatchEvent(new PointerEvent('pointerover', init)); } catch (_) {}
+        try { el.dispatchEvent(new PointerEvent('pointermove', init)); } catch (_) {}
+        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(`
+        (() => {
+          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(`
+      (() => {
+        const el = window.__resolved;
+        if (!el) throw new Error('No resolved element');
+        if (${Q?"false":"true"}) el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        const rect = el.getBoundingClientRect();
+        const init = {
+          bubbles: true,
+          cancelable: true,
+          view: window,
+          clientX: Math.round(rect.left + rect.width / 2),
+          clientY: Math.round(rect.top + rect.height / 2),
+          button: 0,
+          detail: 2,
+        };
+        el.dispatchEvent(new MouseEvent('dblclick', init));
+      })()
+    `);return W}async readCheckableState(){return await this.evaluate(`
+      (() => {
+        const el = window.__resolved;
+        if (!el || el.nodeType !== 1) return { ok: false, reason: 'not_checkable' };
+        const tag = el.tagName.toLowerCase();
+        const role = (el.getAttribute('role') || '').toLowerCase();
+        const type = (el.getAttribute('type') || '').toLowerCase();
+        if (tag === 'input' && (type === 'checkbox' || type === 'radio')) {
+          return {
+            ok: true,
+            checked: !!el.checked,
+            disabled: !!el.disabled,
+            kind: type,
+          };
+        }
+        if (role === 'checkbox' || role === 'switch' || role === 'menuitemcheckbox' || role === 'radio' || role === 'menuitemradio') {
+          const aria = (el.getAttribute('aria-checked') || '').toLowerCase();
+          return {
+            ok: true,
+            checked: aria === 'true' || aria === 'mixed',
+            disabled: el.getAttribute('aria-disabled') === 'true' || el.hasAttribute('disabled'),
+            kind: role,
+          };
+        }
+        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 `opencli 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(`
+        (() => {
+          const el = window.__resolved;
+          if (!el || el.nodeType !== 1) return { ok: false, reason: 'not_file_input' };
+          const tag = el.tagName.toLowerCase();
+          const type = (el.getAttribute('type') || '').toLowerCase();
+          if (tag !== 'input' || type !== 'file') return { ok: false, reason: 'not_file_input', tag, type };
+          el.setAttribute(markerAttr, markerValue);
+          return {
+            ok: true,
+            multiple: !!el.multiple,
+            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 `opencli 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(`
+        (() => {
+          const el = window.__resolved;
+          const names = [];
+          try {
+            if (el && el.files) {
+              for (let i = 0; i < el.files.length; i++) names.push(el.files[i].name || '');
+            }
+          } 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(`
+          (() => {
+            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(`
+      (() => {
+        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' });
+        const rect = el.getBoundingClientRect();
+        const w = Math.round(rect.width);
+        const h = Math.round(rect.height);
+        const x = Math.round(rect.left + rect.width / 2);
+        const y = Math.round(rect.top + rect.height / 2);
+        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(`
+        (() => {
+          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' });
+          const measure = (el) => {
+            const rect = el.getBoundingClientRect();
+            const w = Math.round(rect.width);
+            const h = Math.round(rect.height);
+            const x = Math.round(rect.left + rect.width / 2);
+            const y = Math.round(rect.top + rect.height / 2);
+            const visible = w > 0 && h > 0 && x >= 0 && y >= 0 && x <= window.innerWidth && y <= window.innerHeight;
+            return { x, y, w, h, visible };
+          };
+          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 `opencli 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=`
+      (async () => {
+        function buildTree(node, depth) {
+          if (depth > ${Math.max(1,Math.min(Number(G.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 "";':""}
+
+          let indent = '  '.repeat(depth);
+          let line = indent + role;
+          if (name) line += ' "' + name.replace(/"/g, '\\\\\\"') + '"';
+          if (node.tagName?.toLowerCase() === 'a' && node.href) line += ' [' + node.href + ']';
+          if (node.tagName?.toLowerCase() === 'input') line += ' [' + (node.type || 'text') + ']';
+
+          let result = line + '\\n';
+          if (node.children) {
+            for (const child of node.children) {
+              result += buildTree(child, depth + 1);
+            }
+          }
+          return result;
+        }
+        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}}

package/dist/src/browser/base-page.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser/bridge-readiness.d.ts

@@ -0,0 +1,14 @@
+import type { DaemonHealth } from './daemon-transport.js';
+export type { DaemonHealth };
+export type HealthFetcher = (opts?: {
+    timeout?: number;
+    contextId?: string;
+}) => Promise<DaemonHealth>;
+export declare function waitForBridgeReady(fetchHealth: HealthFetcher, opts: {
+    timeoutMs: number;
+    contextId?: string;
+    intervalMs?: number;
+}): Promise<DaemonHealth>;
+export declare const PRE_DISPATCH_ERROR_CODES: Set<"extension_not_connected" | "profile_disconnected">;
+export type PreDispatchErrorCode = typeof PRE_DISPATCH_ERROR_CODES extends Set<infer T> ? T : never;
+export declare function isPreDispatchError(errorCode: string | undefined): boolean;

package/dist/src/browser/bridge-readiness.js

@@ -0,0 +1 @@
+const o=200;export async function waitForBridgeReady(e,n){const i=n.intervalMs??o;let t=await e({contextId:n.contextId});if(t.state==="ready")return t;const r=Date.now()+n.timeoutMs;while(Date.now()<r){await new Promise((a)=>setTimeout(a,i));t=await e({contextId:n.contextId});if(t.state==="ready")return t}return t}export const PRE_DISPATCH_ERROR_CODES=new Set(["extension_not_connected","profile_disconnected"]);export function isPreDispatchError(e){if(!e)return!1;return PRE_DISPATCH_ERROR_CODES.has(e)}

package/dist/src/browser/bridge-readiness.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser/bridge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Browser session manager — auto-spawns daemon and provides IPage.
+ */
+import type { IPage } from '../types.js';
+import type { IBrowserFactory } from '../runtime.js';
+export type BrowserBridgeState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
+/**
+ * Browser factory: manages daemon lifecycle and provides IPage instances.
+ */
+export declare class BrowserBridge implements IBrowserFactory {
+    private _state;
+    private _page;
+    private _daemonProc;
+    get state(): BrowserBridgeState;
+    connect(opts?: {
+        timeout?: number;
+        session?: string;
+        idleTimeout?: number;
+        contextId?: string;
+        windowMode?: 'foreground' | 'background';
+        surface?: 'browser' | 'adapter';
+        siteSession?: 'ephemeral' | 'persistent';
+    }): Promise<IPage>;
+    close(): Promise<void>;
+    private _ensureDaemon;
+}

package/dist/src/browser/bridge.js

@@ -0,0 +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}}

package/dist/src/browser/cdp-click-fixture.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser/cdp.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CDP client — implements IPage by connecting directly to a Chrome/Electron CDP WebSocket.
+ *
+ * Fixes applied:
+ * - send() now has a 30s timeout guard (P0 #4)
+ * - goto() waits for Page.loadEventFired instead of hardcoded 1s sleep (P1 #3)
+ * - Implemented scroll, autoScroll, screenshot, networkRequests (P1 #2)
+ * - Shared DOM helper methods extracted to reduce duplication with Page (P1 #5)
+ */
+import type { IPage } from '../types.js';
+import type { IBrowserFactory } from '../runtime.js';
+export interface CDPTarget {
+    type?: string;
+    url?: string;
+    title?: string;
+    webSocketDebuggerUrl?: string;
+}
+export declare const CDP_RESPONSE_BODY_CAPTURE_LIMIT: number;
+export declare class CDPBridge implements IBrowserFactory {
+    private _ws;
+    private _idCounter;
+    private _pending;
+    private _eventListeners;
+    connect(opts?: {
+        timeout?: number;
+        session?: string;
+        cdpEndpoint?: string;
+        contextId?: string;
+        idleTimeout?: number;
+        windowMode?: 'foreground' | 'background';
+        surface?: 'browser' | 'adapter';
+        siteSession?: 'ephemeral' | 'persistent';
+        initScript?: string;
+        proxyAuth?: {
+            username: string;
+            password: string;
+        };
+    }): Promise<IPage>;
+    close(): Promise<void>;
+    send(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    on(event: string, handler: (params: unknown) => void): void;
+    off(event: string, handler: (params: unknown) => void): void;
+    waitForEvent(event: string, timeoutMs?: number): Promise<unknown>;
+}
+declare function selectCDPTarget(targets: CDPTarget[]): CDPTarget | undefined;
+declare function scoreCDPTarget(target: CDPTarget, preferredPattern?: RegExp): number;
+export declare const __test__: {
+    selectCDPTarget: typeof selectCDPTarget;
+    scoreCDPTarget: typeof scoreCDPTarget;
+};
+export {};

package/dist/src/browser/cdp.js

@@ -0,0 +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",(L)=>{if(L?.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?.proxyAuth){this.on("Fetch.requestPaused",(L)=>{const Y=L;if(Y.requestId)this.send("Fetch.continueRequest",{requestId:Y.requestId}).catch(()=>{})});this.on("Fetch.authRequired",(L)=>{const Y=L;if(!Y.requestId)return;this.send("Fetch.continueWithAuth",{requestId:Y.requestId,authChallengeResponse:{response:"ProvideCredentials",username:G.proxyAuth.username,password:G.proxyAuth.password}}).catch(()=>{})});await this.send("Fetch.enable",{handleAuthRequests:!0})}}catch(L){Z.close();X(L instanceof Error?L:Error(String(L)));return}K(new O(this))});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 弹窗挡住：试 `opencli browser dialog accept`；托管 profile 可 `opencli 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;_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()})}

package/dist/src/browser/cdp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser/compound.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Compound-component expansion for high-agent-failure form controls.
+ *
+ * Agents burn turns on three recurring input categories because the raw
+ * attribute dump from `browser state` under-specifies them:
+ *
+ *   - date / time / datetime-local / month / week — agents type
+ *     free-form strings and the browser silently ignores mismatched formats.
+ *   - select — the snapshot caps visible options at ~6; agents don't know
+ *     the full option set, can't match by label, and waste turns clicking
+ *     to open the dropdown just to read options.
+ *   - file — the snapshot shows current filenames but not `accept` or
+ *     `multiple`; agents re-upload or pick unsupported MIME types.
+ *
+ * `compoundInfoOf(el)` returns a structured JSON summary agents can rely
+ * on. Included in `browser find --css` envelope so the agent gets the
+ * rich view without extra round-trips.
+ *
+ * Emitted as a JS source string (`COMPOUND_INFO_JS`) so it can be inlined
+ * into the generated evaluate scripts under find / snapshot / eval.
+ */
+export type DateLikeControl = 'date' | 'time' | 'datetime-local' | 'month' | 'week';
+export interface DateCompound {
+    control: DateLikeControl;
+    format: string;
+    current: string;
+    min?: string;
+    max?: string;
+}
+export interface SelectOption {
+    label: string;
+    value: string;
+    selected: boolean;
+    disabled?: boolean;
+}
+export interface SelectCompound {
+    control: 'select';
+    multiple: boolean;
+    current: string | string[];
+    options: SelectOption[];
+    options_total: number;
+}
+export interface FileCompound {
+    control: 'file';
+    multiple: boolean;
+    current: string[];
+    accept?: string;
+}
+export type CompoundInfo = DateCompound | SelectCompound | FileCompound;
+/** Max options included in a SelectCompound.options[]. Above this, `options_total` still reflects the true count. */
+export declare const COMPOUND_SELECT_OPTIONS_CAP = 50;
+/** Max characters per option label / file name. */
+export declare const COMPOUND_LABEL_CAP = 80;
+/**
+ * JavaScript source declaring `compoundInfoOf(el)`. Inlined into the JS
+ * emitted by `buildFindJs` (and any other evaluate script that needs the
+ * rich compound view). Returns a `CompoundInfo` object or `null`.
+ */
+export declare const COMPOUND_INFO_JS = "\nfunction compoundInfoOf(el) {\n  if (!el || !el.tagName) return null;\n  const tag = el.tagName;\n  const LABEL_CAP = 80;\n  const OPTS_CAP = 50;\n  if (tag === 'INPUT') {\n    const type = (el.getAttribute('type') || 'text').toLowerCase();\n    const FORMATS = {\n      'date': 'YYYY-MM-DD',\n      'time': 'HH:MM',\n      'datetime-local': 'YYYY-MM-DDTHH:MM',\n      'month': 'YYYY-MM',\n      'week': 'YYYY-W##',\n    };\n    if (FORMATS[type]) {\n      const info = {\n        control: type,\n        format: FORMATS[type],\n        current: (el.value == null ? '' : String(el.value)),\n      };\n      const min = el.getAttribute('min');\n      if (min) info.min = min;\n      const max = el.getAttribute('max');\n      if (max) info.max = max;\n      return info;\n    }\n    if (type === 'file') {\n      const info = {\n        control: 'file',\n        multiple: !!el.multiple,\n        current: [],\n      };\n      const accept = el.getAttribute('accept');\n      if (accept) info.accept = accept;\n      try {\n        if (el.files && el.files.length) {\n          for (let i = 0; i < el.files.length; i++) {\n            const name = (el.files[i].name || '').slice(0, LABEL_CAP);\n            info.current.push(name);\n          }\n        }\n      } catch (_) {}\n      return info;\n    }\n    return null;\n  }\n  if (tag === 'SELECT') {\n    const multiple = !!el.multiple;\n    const options = [];\n    const selectedLabels = [];\n    let total = 0;\n    try {\n      const opts = el.options || [];\n      total = opts.length;\n      // Walk ALL options so `current` reflects selections that sit beyond the\n      // serialization cap. Only the first OPTS_CAP entries get pushed into\n      // options[]; anything past the cap still contributes to selectedLabels\n      // so agents see the true current state of big dropdowns.\n      for (let i = 0; i < opts.length; i++) {\n        const o = opts[i];\n        const labelRaw = (o.label != null && o.label !== '') ? o.label : (o.text || '');\n        const label = String(labelRaw).trim().slice(0, LABEL_CAP);\n        if (i < OPTS_CAP) {\n          const entry = { label: label, value: o.value, selected: !!o.selected };\n          if (o.disabled) entry.disabled = true;\n          options.push(entry);\n        }\n        if (o.selected) selectedLabels.push(label);\n      }\n    } catch (_) {}\n    return {\n      control: 'select',\n      multiple: multiple,\n      current: multiple ? selectedLabels : (selectedLabels[0] || ''),\n      options: options,\n      options_total: total,\n    };\n  }\n  return null;\n}\n";

package/dist/src/browser/compound.js

@@ -0,0 +1,82 @@
+export const COMPOUND_SELECT_OPTIONS_CAP=50,COMPOUND_LABEL_CAP=80,COMPOUND_INFO_JS=`
+function compoundInfoOf(el) {
+  if (!el || !el.tagName) return null;
+  const tag = el.tagName;
+  const LABEL_CAP = ${COMPOUND_LABEL_CAP};
+  const OPTS_CAP = ${COMPOUND_SELECT_OPTIONS_CAP};
+  if (tag === 'INPUT') {
+    const type = (el.getAttribute('type') || 'text').toLowerCase();
+    const FORMATS = {
+      'date': 'YYYY-MM-DD',
+      'time': 'HH:MM',
+      'datetime-local': 'YYYY-MM-DDTHH:MM',
+      'month': 'YYYY-MM',
+      'week': 'YYYY-W##',
+    };
+    if (FORMATS[type]) {
+      const info = {
+        control: type,
+        format: FORMATS[type],
+        current: (el.value == null ? '' : String(el.value)),
+      };
+      const min = el.getAttribute('min');
+      if (min) info.min = min;
+      const max = el.getAttribute('max');
+      if (max) info.max = max;
+      return info;
+    }
+    if (type === 'file') {
+      const info = {
+        control: 'file',
+        multiple: !!el.multiple,
+        current: [],
+      };
+      const accept = el.getAttribute('accept');
+      if (accept) info.accept = accept;
+      try {
+        if (el.files && el.files.length) {
+          for (let i = 0; i < el.files.length; i++) {
+            const name = (el.files[i].name || '').slice(0, LABEL_CAP);
+            info.current.push(name);
+          }
+        }
+      } catch (_) {}
+      return info;
+    }
+    return null;
+  }
+  if (tag === 'SELECT') {
+    const multiple = !!el.multiple;
+    const options = [];
+    const selectedLabels = [];
+    let total = 0;
+    try {
+      const opts = el.options || [];
+      total = opts.length;
+      // Walk ALL options so \`current\` reflects selections that sit beyond the
+      // serialization cap. Only the first OPTS_CAP entries get pushed into
+      // options[]; anything past the cap still contributes to selectedLabels
+      // so agents see the true current state of big dropdowns.
+      for (let i = 0; i < opts.length; i++) {
+        const o = opts[i];
+        const labelRaw = (o.label != null && o.label !== '') ? o.label : (o.text || '');
+        const label = String(labelRaw).trim().slice(0, LABEL_CAP);
+        if (i < OPTS_CAP) {
+          const entry = { label: label, value: o.value, selected: !!o.selected };
+          if (o.disabled) entry.disabled = true;
+          options.push(entry);
+        }
+        if (o.selected) selectedLabels.push(label);
+      }
+    } catch (_) {}
+    return {
+      control: 'select',
+      multiple: multiple,
+      current: multiple ? selectedLabels : (selectedLabels[0] || ''),
+      options: options,
+      options_total: total,
+    };
+  }
+  return null;
+}
+`;

package/dist/src/browser/compound.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/browser/config.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_BROWSER_CONNECT_TIMEOUT: number;
+export declare const DEFAULT_BROWSER_COMMAND_TIMEOUT: number;

package/dist/src/browser/config.js

@@ -0,0 +1 @@
+import{log as O}from"../logger.js";function E(t,n){const r=process.env[t];if(r===void 0)return n;const e=parseInt(r,10);if(Number.isNaN(e)||e<=0){O.warn(`[runtime] Invalid ${t}="${r}", using default ${n}s`);return n}return e}export const DEFAULT_BROWSER_CONNECT_TIMEOUT=E("OPENCLI_BROWSER_CONNECT_TIMEOUT",45),DEFAULT_BROWSER_COMMAND_TIMEOUT=E("OPENCLI_BROWSER_COMMAND_TIMEOUT",60);

package/dist/src/browser/daemon-client.d.ts

@@ -0,0 +1,79 @@
+/**
+ * HTTP client for communicating with the opencli daemon.
+ *
+ * Provides a typed send() function that posts a Command and returns a Result.
+ */
+import { fetchDaemonStatus, getDaemonHealth, requestDaemonShutdown, type BrowserProfileStatus, type DaemonHealth, type DaemonStatus } from './daemon-transport.js';
+export interface DaemonCommand {
+    id: string;
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'set-file-input' | 'insert-text' | 'bind' | 'network-capture-start' | 'network-capture-read' | 'wait-download' | 'cdp' | 'frames';
+    /** Target page identity (targetId). Cross-layer contract with the extension. */
+    page?: string;
+    code?: string;
+    session?: string;
+    surface?: 'browser' | 'adapter';
+    /** Adapter site session lifecycle. Persistent site sessions do not idle-expire. */
+    siteSession?: 'ephemeral' | 'persistent';
+    url?: string;
+    op?: string;
+    index?: number;
+    domain?: string;
+    format?: 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+    /** Override viewport width in CSS pixels for screenshot (0 / undefined = use current) */
+    width?: number;
+    /** Override viewport height in CSS pixels for screenshot (0 / undefined = use current; ignored when fullPage) */
+    height?: number;
+    /** Local file paths for set-file-input action */
+    files?: string[];
+    /** CSS selector for file input element (set-file-input action) */
+    selector?: string;
+    /** Raw text payload for insert-text action */
+    text?: string;
+    /** URL substring filter pattern for network capture */
+    pattern?: string;
+    /** Download wait timeout in milliseconds */
+    timeoutMs?: number;
+    cdpMethod?: string;
+    cdpParams?: Record<string, unknown>;
+    /** Window foreground/background policy for owned Browser Bridge containers. */
+    windowMode?: 'foreground' | 'background';
+    /** Custom idle timeout in seconds for this session. Overrides the default. */
+    idleTimeout?: number;
+    /** Frame index for cross-frame operations (0-based, from 'frames' action) */
+    frameIndex?: number;
+    /** Browser profile/context to route the command to. */
+    contextId?: string;
+}
+export interface DaemonResult {
+    id: string;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+    errorCode?: string;
+    errorHint?: string;
+    /** Page identity (targetId) — present on page-scoped command responses */
+    page?: string;
+}
+export declare class BrowserCommandError extends Error {
+    readonly code?: string | undefined;
+    readonly hint?: string | undefined;
+    constructor(message: string, code?: string | undefined, hint?: string | undefined);
+}
+export { fetchDaemonStatus, getDaemonHealth, requestDaemonShutdown, type BrowserProfileStatus, type DaemonHealth, type DaemonStatus, };
+/**
+ * Send a command to the daemon and return the result data.
+ */
+export declare function sendCommand(action: DaemonCommand['action'], params?: Omit<DaemonCommand, 'id' | 'action'>): Promise<unknown>;
+/**
+ * Like sendCommand, but returns both data and page identity (targetId).
+ * Use this for page-scoped commands where the caller needs the page identity.
+ */
+export declare function sendCommandFull(action: DaemonCommand['action'], params?: Omit<DaemonCommand, 'id' | 'action'>): Promise<{
+    data: unknown;
+    page?: string;
+}>;
+export declare function bindTab(session: string, opts?: {
+    contextId?: string;
+}): Promise<unknown>;