agent-orcha 0.0.5 → 0.0.8

package/dist/lib/sandbox/cdp-client.js

@@ -0,0 +1,139 @@
+import WebSocket from 'ws';
+const DEFAULT_SEND_TIMEOUT = 20_000;
+export class CDPClient {
+    ws = null;
+    msgId = 0;
+    pending = new Map();
+    eventListeners = new Map();
+    async connect(cdpUrl) {
+        // Clean up any existing connection before reconnecting
+        if (this.ws) {
+            this.cleanup();
+        }
+        const httpUrl = cdpUrl.replace(/\/$/, '');
+        const res = await fetch(`${httpUrl}/json`);
+        if (!res.ok)
+            throw new Error(`CDP discovery failed: ${res.status}`);
+        const targets = await res.json();
+        const page = targets.find(t => t.type === 'page');
+        if (!page?.webSocketDebuggerUrl) {
+            throw new Error('No page target found');
+        }
+        // Rewrite the discovered WebSocket URL to match the CDP URL we connected to.
+        // When proxied (e.g. socat), Chromium reports its internal address which may not
+        // be reachable from the host. Replace host:port with the one from cdpUrl.
+        const cdpParsed = new URL(httpUrl);
+        const wsParsed = new URL(page.webSocketDebuggerUrl);
+        wsParsed.hostname = cdpParsed.hostname;
+        wsParsed.port = cdpParsed.port;
+        const wsUrl = wsParsed.toString();
+        await this.connectWs(wsUrl);
+    }
+    connectWs(url) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            const timeout = setTimeout(() => {
+                ws.close();
+                reject(new Error('CDP WebSocket connection timeout'));
+            }, 10_000);
+            ws.on('open', () => {
+                clearTimeout(timeout);
+                this.ws = ws;
+                resolve();
+            });
+            ws.on('message', (data) => {
+                const msg = JSON.parse(data.toString());
+                if ('id' in msg) {
+                    const handler = this.pending.get(msg.id);
+                    if (handler) {
+                        clearTimeout(handler.timer);
+                        this.pending.delete(msg.id);
+                        if (msg.error) {
+                            handler.reject(new Error(msg.error.message));
+                        }
+                        else {
+                            handler.resolve(msg.result);
+                        }
+                    }
+                }
+                else if ('method' in msg) {
+                    const listeners = this.eventListeners.get(msg.method);
+                    if (listeners) {
+                        for (const fn of listeners)
+                            fn(msg.params);
+                    }
+                }
+            });
+            ws.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+            ws.on('close', () => {
+                this.ws = null;
+                for (const [, handler] of this.pending) {
+                    clearTimeout(handler.timer);
+                    handler.reject(new Error('CDP connection closed'));
+                }
+                this.pending.clear();
+            });
+        });
+    }
+    async send(method, params, timeout = DEFAULT_SEND_TIMEOUT) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('CDP not connected');
+        }
+        const id = ++this.msgId;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`CDP send timeout: ${method} (${timeout}ms)`));
+            }, timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            this.ws.send(JSON.stringify({ id, method, params }));
+        });
+    }
+    on(event, handler) {
+        const listeners = this.eventListeners.get(event) ?? [];
+        listeners.push(handler);
+        this.eventListeners.set(event, listeners);
+        return () => {
+            const idx = listeners.indexOf(handler);
+            if (idx >= 0)
+                listeners.splice(idx, 1);
+        };
+    }
+    once(event) {
+        return new Promise(resolve => {
+            const listeners = this.eventListeners.get(event) ?? [];
+            const handler = (params) => {
+                const idx = listeners.indexOf(handler);
+                if (idx >= 0)
+                    listeners.splice(idx, 1);
+                resolve(params);
+            };
+            listeners.push(handler);
+            this.eventListeners.set(event, listeners);
+        });
+    }
+    get connected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    cleanup() {
+        if (this.ws) {
+            try {
+                this.ws.close();
+            }
+            catch { /* ignore */ }
+            this.ws = null;
+        }
+        for (const [, handler] of this.pending) {
+            clearTimeout(handler.timer);
+        }
+        this.pending.clear();
+    }
+    async close() {
+        this.cleanup();
+        this.eventListeners.clear();
+    }
+}
+//# sourceMappingURL=cdp-client.js.map

package/dist/lib/sandbox/cdp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-client.js","sourceRoot":"","sources":["../../../lib/sandbox/cdp-client.ts"],"names":[],"mappings":"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"}

package/dist/lib/sandbox/html-to-markdown.d.ts

@@ -1,2 +1,10 @@
-export declare function htmlToMarkdown(html: string): string;
+export interface HtmlToMarkdownOptions {
+    /** Keep nav, footer, header, aside elements (default: false). */
+    includeNavigation?: boolean;
+    /** Keep form elements like buttons, inputs, selects (default: false). */
+    includeInteractiveElements?: boolean;
+    /** Keep image markdown (default: false). */
+    includeImages?: boolean;
+}
+export declare function htmlToMarkdown(html: string, options?: HtmlToMarkdownOptions): string;
 //# sourceMappingURL=html-to-markdown.d.ts.map

package/dist/lib/sandbox/html-to-markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-to-markdown.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/html-to-markdown.ts"],"names":[],"mappings":"AAkDA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOnD"}
+{"version":3,"file":"html-to-markdown.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/html-to-markdown.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAoGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAUpF"}

package/dist/lib/sandbox/html-to-markdown.js

@@ -1,16 +1,25 @@
 import { JSDOM } from 'jsdom';
-const SKIP = new Set([
-    'SCRIPT', 'STYLE', 'NAV', 'FOOTER', 'HEADER', 'ASIDE', 'NOSCRIPT', 'SVG', 'IFRAME',
-]);
-function walk(node) {
+/** Strip <script> and <style> tags before DOM parsing to avoid jsdom vm crashes. */
+function stripScripts(html) {
+    return html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '');
+}
+const SKIP_ALWAYS = new Set(['SCRIPT', 'STYLE', 'NOSCRIPT', 'SVG', 'IFRAME', 'HEAD', 'META', 'LINK']);
+const SKIP_FULL_PAGE = new Set(['NAV', 'FOOTER', 'HEADER', 'ASIDE']);
+const INTERACTIVE_TAGS = new Set(['BUTTON', 'INPUT', 'SELECT', 'TEXTAREA', 'FORM']);
+function walk(node, skip, interactive, images) {
     if (node.nodeType === 3)
         return node.textContent ?? '';
     if (node.nodeType !== 1)
         return '';
     const el = node;
-    if (SKIP.has(el.tagName))
+    if (SKIP_ALWAYS.has(el.tagName))
+        return '';
+    if (skip.has(el.tagName))
+        return '';
+    if (!interactive && INTERACTIVE_TAGS.has(el.tagName))
         return '';
-    const kids = Array.from(el.childNodes).map(walk).join('');
+    const kids = Array.from(el.childNodes).map(c => walk(c, skip, interactive, images)).join('');
     const t = kids.trim();
     switch (el.tagName) {
         case 'H1': return `\n# ${t}\n`;
@@ -46,19 +55,67 @@ function walk(node) {
         case 'BLOCKQUOTE': return `\n> ${t.replace(/\n/g, '\n> ')}\n`;
         case 'HR': return '\n---\n';
         case 'IMG': {
+            if (!images)
+                return '';
             const alt = el.getAttribute('alt') ?? '';
             const src = el.getAttribute('src') ?? '';
             return src ? `![${alt}](${src})` : '';
         }
+        case 'INPUT': {
+            const type = el.getAttribute('type') ?? 'text';
+            const name = el.getAttribute('name') ?? '';
+            const value = el.getAttribute('value') ?? '';
+            const placeholder = el.getAttribute('placeholder') ?? '';
+            const parts = [`input:${type}`];
+            if (name)
+                parts.push(`name="${name}"`);
+            if (value)
+                parts.push(`value="${value}"`);
+            if (placeholder)
+                parts.push(`placeholder="${placeholder}"`);
+            return `[${parts.join(' ')}]`;
+        }
+        case 'BUTTON': return `[button: ${t}]`;
+        case 'SELECT': {
+            const name = el.getAttribute('name') ?? '';
+            const options = Array.from(el.querySelectorAll('option'))
+                .map(o => `${o.hasAttribute('selected') ? '(*)' : '( )'} ${(o.textContent ?? '').trim()}`)
+                .join(', ');
+            return `[select${name ? ` name="${name}"` : ''}: ${options}]`;
+        }
+        case 'TEXTAREA': {
+            const name = el.getAttribute('name') ?? '';
+            return `[textarea${name ? ` name="${name}"` : ''}: ${t}]`;
+        }
+        case 'FORM': {
+            const action = el.getAttribute('action') ?? '';
+            return `\n[form${action ? ` action="${action}"` : ''}]\n${kids}\n[/form]\n`;
+        }
+        case 'LABEL': {
+            const forAttr = el.getAttribute('for') ?? '';
+            return forAttr ? `[label for="${forAttr}": ${t}]` : t;
+        }
         default: return kids;
     }
 }
-export function htmlToMarkdown(html) {
-    const dom = new JSDOM(html);
+/** Collapse runs of 3+ whitespace-only lines and strip lines with only symbols/punctuation. */
+function cleanOutput(raw) {
+    return raw
+        .replace(/\n{3,}/g, '\n\n')
+        // Remove lines that are only icons/symbols (e.g. "*add_circle_outline*", "*settings*")
+        .replace(/^\s*\*[a-z_]+\*\s*$/gm, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+export function htmlToMarkdown(html, options) {
+    const dom = new JSDOM(stripScripts(html));
     const body = dom.window.document.body;
     if (!body)
         return '';
-    const raw = walk(body);
-    return raw.replace(/\n{3,}/g, '\n\n').trim();
+    const skip = options?.includeNavigation ? new Set() : SKIP_FULL_PAGE;
+    const interactive = options?.includeInteractiveElements ?? false;
+    const images = options?.includeImages ?? false;
+    const raw = walk(body, skip, interactive, images);
+    return cleanOutput(raw);
 }
 //# sourceMappingURL=html-to-markdown.js.map

package/dist/lib/sandbox/html-to-markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-to-markdown.js","sourceRoot":"","sources":["../../../lib/sandbox/html-to-markdown.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"html-to-markdown.js","sourceRoot":"","sources":["../../../lib/sandbox/html-to-markdown.ts"],"names":[],"mappings":"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"}

package/dist/lib/sandbox/index.d.ts

@@ -1,7 +1,13 @@
 export { VmExecutor } from './vm-executor.ts';
 export { createSandboxExecTool } from './sandbox-exec.ts';
 export { createSandboxWebFetchTool, createSandboxWebSearchTool } from './sandbox-web.ts';
+export { createSandboxShellTool } from './sandbox-shell.ts';
+export { createBrowserTools } from './sandbox-browser.ts';
+export { CDPClient } from './cdp-client.ts';
+export { PageReadiness } from './page-readiness.ts';
+export type { PageSnapshot } from './page-readiness.ts';
 export { htmlToMarkdown } from './html-to-markdown.ts';
+export { SandboxContainer } from './sandbox-container.ts';
 export { SandboxConfigSchema } from './types.ts';
 export type { SandboxConfig, ExecResult } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/sandbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/sandbox/index.js

@@ -1,6 +1,11 @@
 export { VmExecutor } from "./vm-executor.js";
 export { createSandboxExecTool } from "./sandbox-exec.js";
 export { createSandboxWebFetchTool, createSandboxWebSearchTool } from "./sandbox-web.js";
+export { createSandboxShellTool } from "./sandbox-shell.js";
+export { createBrowserTools } from "./sandbox-browser.js";
+export { CDPClient } from "./cdp-client.js";
+export { PageReadiness } from "./page-readiness.js";
 export { htmlToMarkdown } from "./html-to-markdown.js";
+export { SandboxContainer } from "./sandbox-container.js";
 export { SandboxConfigSchema } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/sandbox/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/sandbox/page-readiness.d.ts

@@ -0,0 +1,37 @@
+import type { CDPClient } from './cdp-client.ts';
+export interface PageSnapshot {
+    url: string;
+    title: string;
+    readyState: string;
+    inflightRequests: number;
+    elements: string;
+    headings: string[];
+    summary: string;
+    /** First ~2000 chars of visible page text (innerText). */
+    textExcerpt: string;
+}
+export declare class PageReadiness {
+    private cdp;
+    private unsubscribers;
+    private state;
+    /** Maps short refs (e1, e2...) → CSS selectors. Updated on each observe(). */
+    private refMap;
+    constructor(cdp: CDPClient);
+    attach(): Promise<void>;
+    detach(): void;
+    resetForNavigation(): void;
+    resetNetworkFlag(): void;
+    hadNetworkActivity(): boolean;
+    /**
+     * Wait for page readiness with progressive resolution:
+     * - Ideal: load + network idle + DOM stable → immediate
+     * - Good enough: load + DOM stable (lingering requests) → after 2s
+     * - Hard cap: READY_MAX_MS (8s) regardless
+     */
+    waitForReady(_timeout?: number): Promise<void>;
+    waitForSettle(quietMs: number): Promise<void>;
+    /** Resolve a ref (e.g. "e3") or CSS selector to a CSS selector. */
+    resolveRef(refOrSelector: string): string;
+    observe(): Promise<PageSnapshot>;
+}
+//# sourceMappingURL=page-readiness.d.ts.map

package/dist/lib/sandbox/page-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-readiness.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/page-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AAkFD,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAMX;IAEF,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAA6B;gBAE/B,GAAG,EAAE,SAAS;IAIpB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmE7B,MAAM,IAAI,IAAI;IAKd,kBAAkB,IAAI,IAAI;IAQ1B,gBAAgB,IAAI,IAAI;IAIxB,kBAAkB,IAAI,OAAO;IAI7B;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD9C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD,mEAAmE;IACnE,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAInC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CA8BvC"}

package/dist/lib/sandbox/page-readiness.js

@@ -0,0 +1,268 @@
+const SETTLE_MS = 300;
+const POLL_MS = 80;
+const SETTLE_MAX_MS = 2_000;
+/** Max time waitForReady will block — returns best-effort snapshot after this. */
+const READY_MAX_MS = 8_000;
+const MAX_ELEMENTS = 30;
+/**
+ * Injected JS that returns compact text lines + a ref→selector map.
+ * Output format per element: "- role \"text\" [ref=eN] attrs..."
+ * This is ~3-5x more token-efficient than JSON objects.
+ */
+const OBSERVE_SCRIPT = `(() => {
+  const h = [...document.querySelectorAll('h1,h2,h3')].slice(0,8)
+    .map(e=>e.textContent.trim().substring(0,60)).filter(Boolean);
+  const els = document.querySelectorAll(
+    'a[href],button,input,select,textarea,[role="button"],[role="link"],[role="tab"],[role="menuitem"]'
+  );
+  const lines=[], refs={};
+  let n=0;
+  for(const el of els){
+    if(n>=${MAX_ELEMENTS})break;
+    if(el.offsetParent===null&&el.tagName!=='INPUT'&&el.type!=='hidden')continue;
+    const r=el.getBoundingClientRect();
+    if(r.width===0&&r.height===0&&el.type!=='hidden')continue;
+    n++;
+    const ref='e'+n;
+    refs[ref]=bSel(el);
+    const tag=el.tagName.toLowerCase();
+    const role=el.getAttribute('role')||tag;
+    const txt=(el.textContent||'').trim().substring(0,40);
+    let line='- '+role;
+    if(txt)line+=' "'+txt+'"';
+    line+=' [ref='+ref+']';
+    if(el.type&&el.type!=='submit'&&el.type!=='button')line+=' type='+el.type;
+    if(el.name)line+=' name='+el.name;
+    if(el.placeholder)line+=' placeholder="'+el.placeholder+'"';
+    if(el.value!==undefined&&el.value!=='')line+=' value="'+el.value.substring(0,30)+'"';
+    if(el.disabled)line+=' disabled';
+    lines.push(line);
+  }
+  const bt=document.body?document.body.innerText:'';
+  const tl=bt.length;
+  const te=bt.substring(0,2000);
+  const fc=document.querySelectorAll('form').length;
+  const ic=document.querySelectorAll('img').length;
+  const sp=[];
+  if(fc)sp.push(fc+' form(s)');
+  if(ic)sp.push(ic+' image(s)');
+  sp.push(tl+' chars');
+  return JSON.stringify({
+    url:location.href,title:document.title,readyState:document.readyState,
+    headings:h,summary:sp.join(', '),textExcerpt:te,
+    elements:lines.join('\\n'),refs:refs
+  });
+  function bSel(el){
+    if(el.id)return'#'+CSS.escape(el.id);
+    if(el.name&&el.tagName){
+      const s=el.tagName.toLowerCase()+'[name="'+el.name+'"]';
+      if(document.querySelectorAll(s).length===1)return s;
+    }
+    const p=[];let c=el;
+    while(c&&c!==document.body){
+      const pr=c.parentElement;if(!pr)break;
+      const sb=[...pr.children].filter(x=>x.tagName===c.tagName);
+      p.unshift(sb.length===1?c.tagName.toLowerCase():c.tagName.toLowerCase()+':nth-of-type('+(sb.indexOf(c)+1)+')');
+      c=pr;
+    }
+    return p.join(' > ');
+  }
+})()`;
+export class PageReadiness {
+    cdp;
+    unsubscribers = [];
+    state = {
+        loadFired: false,
+        inflightRequests: 0,
+        lastDomChange: 0,
+        lastNetworkActivity: 0,
+        networkTriggered: false,
+    };
+    /** Maps short refs (e1, e2...) → CSS selectors. Updated on each observe(). */
+    refMap = new Map();
+    constructor(cdp) {
+        this.cdp = cdp;
+    }
+    async attach() {
+        await this.cdp.send('Page.enable');
+        await this.cdp.send('Network.enable');
+        await this.cdp.send('DOM.enable');
+        // Stealth: inject anti-detection patches before any page JS runs.
+        // Runs on every new document (navigations, iframes).
+        await this.cdp.send('Page.addScriptToEvaluateOnNewDocument', {
+            source: `
+        // Hide webdriver flag
+        Object.defineProperty(navigator, 'webdriver', { get: () => false });
+
+        // Normal Chrome plugins array (headless has length 0)
+        Object.defineProperty(navigator, 'plugins', {
+          get: () => [1, 2, 3, 4, 5],
+        });
+
+        // Normal languages
+        Object.defineProperty(navigator, 'languages', {
+          get: () => ['en-US', 'en'],
+        });
+
+        // Chrome runtime object (missing in automation mode)
+        if (!window.chrome) window.chrome = {};
+        if (!window.chrome.runtime) window.chrome.runtime = {};
+
+        // Spoof permissions query for notifications
+        const origQuery = window.Permissions?.prototype?.query;
+        if (origQuery) {
+          window.Permissions.prototype.query = function(params) {
+            if (params.name === 'notifications') {
+              return Promise.resolve({ state: 'denied', onchange: null });
+            }
+            return origQuery.call(this, params);
+          };
+        }
+      `,
+        });
+        this.unsubscribers.push(this.cdp.on('Page.loadEventFired', () => {
+            this.state.loadFired = true;
+        }), this.cdp.on('Network.requestWillBeSent', () => {
+            this.state.inflightRequests++;
+            this.state.lastNetworkActivity = Date.now();
+            this.state.networkTriggered = true;
+        }), this.cdp.on('Network.loadingFinished', () => {
+            this.state.inflightRequests = Math.max(0, this.state.inflightRequests - 1);
+            this.state.lastNetworkActivity = Date.now();
+        }), this.cdp.on('Network.loadingFailed', () => {
+            this.state.inflightRequests = Math.max(0, this.state.inflightRequests - 1);
+            this.state.lastNetworkActivity = Date.now();
+        }), this.cdp.on('DOM.documentUpdated', () => {
+            this.state.lastDomChange = Date.now();
+        }), 
+        // Auto-dismiss JS dialogs (alert/confirm/prompt) — they block all
+        // Runtime.evaluate calls and hang waitForReady / observe.
+        this.cdp.on('Page.javascriptDialogOpening', () => {
+            this.cdp.send('Page.handleJavaScriptDialog', { accept: true }).catch(() => { });
+        }));
+    }
+    detach() {
+        for (const unsub of this.unsubscribers)
+            unsub();
+        this.unsubscribers = [];
+    }
+    resetForNavigation() {
+        this.state.loadFired = false;
+        this.state.inflightRequests = 0;
+        this.state.lastDomChange = Date.now();
+        this.state.lastNetworkActivity = Date.now();
+        this.state.networkTriggered = false;
+    }
+    resetNetworkFlag() {
+        this.state.networkTriggered = false;
+    }
+    hadNetworkActivity() {
+        return this.state.networkTriggered;
+    }
+    /**
+     * Wait for page readiness with progressive resolution:
+     * - Ideal: load + network idle + DOM stable → immediate
+     * - Good enough: load + DOM stable (lingering requests) → after 2s
+     * - Hard cap: READY_MAX_MS (8s) regardless
+     */
+    async waitForReady(_timeout) {
+        const maxMs = Math.min(_timeout ?? READY_MAX_MS, READY_MAX_MS);
+        const start = Date.now();
+        await new Promise((resolve) => {
+            const check = async () => {
+                const now = Date.now();
+                const elapsed = now - start;
+                if (elapsed > maxMs) {
+                    resolve();
+                    return;
+                }
+                // Fallback: if loadFired event was missed, check readyState via DOM.
+                // Race with a timeout — Runtime.evaluate hangs if a JS dialog is open
+                // (auto-dismiss fires async, but the evaluate may already be queued).
+                if (!this.state.loadFired && elapsed > 500) {
+                    try {
+                        const rs = await Promise.race([
+                            this.cdp.send('Runtime.evaluate', {
+                                expression: 'document.readyState',
+                                returnByValue: true,
+                            }),
+                            new Promise((r) => setTimeout(() => r(null), 1_000)),
+                        ]);
+                        if (rs && rs.result?.value === 'complete') {
+                            this.state.loadFired = true;
+                        }
+                    }
+                    catch { /* ignore */ }
+                }
+                const networkIdle = this.state.inflightRequests === 0
+                    && (now - this.state.lastNetworkActivity) > SETTLE_MS;
+                const domStable = (now - this.state.lastDomChange) > SETTLE_MS;
+                // Ideal: everything settled
+                if (this.state.loadFired && networkIdle && domStable) {
+                    resolve();
+                    return;
+                }
+                // Good enough: load + DOM stable, but lingering requests (analytics, long-poll)
+                if (elapsed > 2_000 && this.state.loadFired && domStable) {
+                    resolve();
+                    return;
+                }
+                setTimeout(check, POLL_MS);
+            };
+            check();
+        });
+    }
+    async waitForSettle(quietMs) {
+        const start = Date.now();
+        await new Promise((resolve) => {
+            const check = () => {
+                const now = Date.now();
+                if (now - start > SETTLE_MAX_MS) {
+                    resolve();
+                    return;
+                }
+                const idle = this.state.inflightRequests === 0
+                    && (now - this.state.lastNetworkActivity) > quietMs
+                    && (now - this.state.lastDomChange) > quietMs;
+                if (idle) {
+                    resolve();
+                    return;
+                }
+                setTimeout(check, 50);
+            };
+            setTimeout(check, 50);
+        });
+    }
+    /** Resolve a ref (e.g. "e3") or CSS selector to a CSS selector. */
+    resolveRef(refOrSelector) {
+        return this.refMap.get(refOrSelector) ?? refOrSelector;
+    }
+    async observe() {
+        const result = await this.cdp.send('Runtime.evaluate', {
+            expression: OBSERVE_SCRIPT,
+            returnByValue: true,
+        });
+        const raw = result.result?.value;
+        const parsed = raw
+            ? JSON.parse(raw)
+            : { url: '', title: '', readyState: 'unknown', headings: [], summary: '', textExcerpt: '', elements: '', refs: {} };
+        // Update ref→selector map
+        this.refMap.clear();
+        if (parsed.refs) {
+            for (const [ref, sel] of Object.entries(parsed.refs)) {
+                this.refMap.set(ref, sel);
+            }
+        }
+        return {
+            url: parsed.url,
+            title: parsed.title,
+            readyState: parsed.readyState,
+            headings: parsed.headings,
+            summary: parsed.summary,
+            textExcerpt: parsed.textExcerpt ?? '',
+            elements: parsed.elements,
+            inflightRequests: this.state.inflightRequests,
+        };
+    }
+}
+//# sourceMappingURL=page-readiness.js.map